Struct StateDir 

pub struct StateDir { /* private fields */ }

Implementations

impl StateDir

pub fn default_root() -> Result<PathBuf, StateError>

pub fn at(root: impl Into<PathBuf>) -> Self

pub fn discover() -> Result<Self, StateError>

pub fn root(&self) -> &Path

pub fn runs(&self) -> PathBuf

pub fn repos(&self) -> PathBuf

pub fn project_repos(&self, project_id: &str) -> PathBuf

Project-scoped repos directory at <root>/projects/<project_id>/repos. Ingestion writes per-repo workspace subdirs under this path so two repos with the same name in different projects never collide.

pub fn findings(&self) -> PathBuf

pub fn logs(&self) -> PathBuf

pub fn cache(&self) -> PathBuf

pub fn bundles(&self) -> PathBuf

Per-finding repro bundle output directory (<state>/bundles). One tarball per finding is written here when the operator requests a repro bundle.

pub fn traces(&self) -> PathBuf

Per-AI-task trace artefact directory (<state>/traces). The exploration pass writes one <task_id>.jsonl per run under Self::traces_for_run and stamps the path on the matching agent_traces.conversation_jsonl_path row.

pub fn traces_for_run(&self, run_id: &str) -> PathBuf

Per-run trace directory at <state>/traces/<run_id>. Created on demand by the pass that writes into it; callers should std::fs::create_dir_all before opening files.

pub fn secrets(&self) -> PathBuf

Secrets directory at <state>/secrets, created with mode 0700 by Self::ensure. The env-builder reads <state>/secrets/test.env (and the optional test.env.allow sibling) from this path. Surfaced as a single canonical accessor so the wizard, doctor, and env-builder name the same location.

pub fn secrets_test_env_path(&self) -> PathBuf

Path of the env-builder test secrets file (<state>/secrets/test.env). Absent until the operator drops a file at this path; the env-builder fails closed when it is missing.

pub fn secrets_test_env_allow_path(&self) -> PathBuf

Path of the optional env-builder secrets allowlist (<state>/secrets/test.env.allow). Absent on a fresh install; the env-builder treats a missing file as an empty allowlist.

pub fn auth_token_path(&self) -> PathBuf

Bearer-token file consumed by the API auth middleware. Stored at <state>/auth_token with mode 0600. Absent before the daemon’s first launch.

pub fn ensure(&self) -> Result<(), StateError>

Create the root and every subdirectory if missing; idempotent. On Unix every directory created or already present is forced to mode 0700.

pub fn load_or_mint_auth_token(&self) -> Result<String, StateError>

Load the bearer token from auth_token, generating + persisting a fresh one if absent. The minted file is 0o600 so a second user on the box cannot read it. Callers that have already invoked Self::ensure do not need to repeat it.

Trait Implementations

impl Clone for StateDir

fn clone(&self) -> StateDir

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateDir

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

Formats the value using the given formatter.