Struct InstructionsConfig 

pub struct InstructionsConfig {
    pub enabled: bool,
    pub byte_budget: usize,
    pub root_markers: Vec<String>,
    pub root_stop_pattern: Option<String>,
    pub extra_roots: Vec<PathBuf>,
    pub global_file: bool,
    pub extends_dirs: Vec<PathBuf>,
}

How project-instruction discovery behaves. All fields have defaults; a caller (the CLI today, a settings layer later) overrides them.

Fields

enabled: bool

Master switch (default true). --no-project-instructions sets it false.

byte_budget: usize

Byte budget for the assembled injected body (applied at render time, ADR-0023). Default 64 KiB; 0 means unbounded.

root_markers: Vec<String>

Directory markers whose presence marks a project root (default [".git"]).

root_stop_pattern: Option<String>

ADR-0023 root-detection rule 2 (activated by ADR-0024 §1.4 / Task 31 S2): a regex matched against each ancestor’s absolute path during the ascent — a match makes that directory the project root, exactly like a marker hit. The escape hatch for VCS-less trees (monorepo segments, /workspace/<p>). An invalid pattern degrades to no-pattern (the settings loader already warned about it).

extra_roots: Vec<PathBuf>

Seam (ADR-0023 implementation note): extra roots to also discover from. Honored by the walk, but no --add-dir CLI flag ships until the tool-jail-widening task.

global_file: bool

Read the global ~/.locode/AGENTS.md (lowest precedence). Default true.

extends_dirs: Vec<PathBuf>

Resolved extends dotfolders from settings (ADR-0024 §1.2 amendment). Each contributes its AGENTS.md below the global file, in list order, so the user’s own global file still wins and the repo chain wins over both (ADR-0023 amendment 2026-07-24).

This field is why load order is an invariant rather than a convention (ADR-0025 §6.1): the value comes from SettingsLoad::extends_dirs, so discovery cannot run before settings resolve.

Trait Implementations

impl Clone for InstructionsConfig

fn clone(&self) -> InstructionsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstructionsConfig

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

Formats the value using the given formatter.

impl Default for InstructionsConfig

fn default() -> Self

Returns the “default value” for a type.