Struct ProjectManifest 

pub struct ProjectManifest {
    pub required: Vec<SecretPath>,
    pub optional: Vec<SecretPath>,
    pub overrides: BTreeMap<SecretPath, OverrideEntry>,
    pub secrets: BTreeMap<SecretPath, IndexEntry>,
}

In-memory representation of .devboy/secrets.toml.

This loader does not merge with the global index — it is the raw view of what the project committed. The merge logic (precedence rules, E_OVERRIDE_FIELD_NOT_ALLOWED for non-allowed fields, E_SECRET_UNKNOWN_PATH for paths missing from both global and project-local) lands in epic phase P1.4 (#18).

Fields

required: Vec<SecretPath>

Paths the project requires to function. doctor returns non-zero if any are missing.

optional: Vec<SecretPath>

Paths the project can use but does not require.

overrides: BTreeMap<SecretPath, OverrideEntry>

Behavioural overrides keyed by path.

secrets: BTreeMap<SecretPath, IndexEntry>

Project-local entries — paths that do not appear in the global index and whose metadata lives in this manifest.

Implementations

impl ProjectManifest

pub fn new() -> Self

Build an empty manifest. Useful for tests and as the default when .devboy/secrets.toml is absent (the manifest is opt-in per ADR-020 §4).

pub fn load() -> Result<Self, ManifestError>

Load the manifest from <cwd>/.devboy/secrets.toml. Returns an empty manifest if the file does not exist.

pub fn load_from_project_root(root: &Path) -> Result<Self, ManifestError>

Load the manifest from <project_root>/.devboy/secrets.toml.

pub fn load_from(path: &Path) -> Result<Self, ManifestError>

Load the manifest from a specific file path. Returns an empty manifest if the file does not exist.

pub fn from_toml_str(body: &str) -> Result<Self, ManifestError>

Parse from a TOML string with no associated file path (used in tests and when the caller has bytes in memory).

pub fn is_empty(&self) -> bool

true when no required, optional, override, or project-local entry is declared. doctor treats this as “the project does not currently depend on any managed secret”.

pub fn referenced_paths(&self) -> impl Iterator<Item = (&SecretPath, PathRole)>

Iterate over every path mentioned by the manifest in any role (required, optional, override key, project-local secret key), each tagged with the role it appeared in. Useful for doctor and the merge logic.

Trait Implementations

impl Clone for ProjectManifest

fn clone(&self) -> ProjectManifest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProjectManifest

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

Formats the value using the given formatter.

impl Default for ProjectManifest

fn default() -> ProjectManifest

Returns the “default value” for a type.

impl Eq for ProjectManifest

impl PartialEq for ProjectManifest

fn eq(&self, other: &ProjectManifest) -> 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 StructuralPartialEq for ProjectManifest