Struct EntryProvenance 

pub struct EntryProvenance {
    pub path: String,
    pub directory: String,
    pub source_class: String,
    pub section: Option<String>,
    pub bytes: u64,
}

Where the selected thing lives, as the index knows it. Nothing here is authored: every field is the index’s own crate::model::Provenance, carried rather than restated.

It is a copy of the index’s provenance and not a re-derivation of it, which is the property worth relying on: no path here was constructed by this module, so a path in an answer is a path the index discovered, and the two cannot disagree about where something lives.

bytes is the measured half of an entry’s cost — the estimate on top of it is tokens_for — so this is also where the budget’s arithmetic starts.

use majordomus_cli::devcontext::{tokens_for, EntryProvenance};
use serde_json::json;

let p: EntryProvenance = serde_json::from_value(json!({
    "path": ".ai/repo/adrs/0052-the-episode-is-the-boundary.md",
    "directory": ".ai/repo/adrs",
    "source_class": "adr",
    "section": "adrs",
    "bytes": 8_192,
})).unwrap();

// the size is what the cost is computed from, and the estimate says so of itself
assert_eq!(tokens_for(p.bytes), 2_048);

// a file under no manifest section — a root README, say — carries none rather than ""
let rootish: EntryProvenance = serde_json::from_value(json!({
    "path": "README.md",
    "directory": ".",
    "source_class": "readme",
    "bytes": 4_000,
})).unwrap();
assert!(rootish.section.is_none());
assert_eq!(rootish.directory, ".", "the root is `.`, not the empty string");

Fields

path: String

Repository-relative path, forward slashes.

directory: String

The directory it sits in.

source_class: String

The sources.yaml class that discovered it.

section: Option<String>

The manifest section it falls under, when it falls under one.

bytes: u64

Size of the file in bytes.

Trait Implementations

impl Clone for EntryProvenance

fn clone(&self) -> EntryProvenance

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EntryProvenance

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EntryProvenance

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for EntryProvenance

impl JsonSchema for EntryProvenance

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for EntryProvenance

fn eq(&self, other: &EntryProvenance) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for EntryProvenance

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EntryProvenance