Crate plan_archive 

Deterministic plan-archive CLI shipped as part of the nils-cli workspace.

See the master design at agent-runtime-kit:docs/plans/2026-05-26-plan-archive-system/plan-archive-system-discussion-source.md for the surrounding contract. Sprint 1 of the Plan 1 plan (plan-archive-nils-cli) lands the three schema validators that the later migrate, refresh, and query subcommands build on.

Re-exports

pub use scrub::Match;

pub use scrub::PATTERN_SET;

pub use scrub::REDACTION_TOKEN;

pub use scrub::ScrubResult;

pub use scrub::pattern_ids;

pub use scrub::scrub_text;

pub use validate::hosts::HostsConfig;

pub use validate::hosts::HostsValidation;

pub use validate::hosts::HostsValidationData;

pub use validate::hosts::validate_hosts_yaml;

pub use validate::local::LocalConfig;

pub use validate::local::LocalValidation;

pub use validate::local::LocalValidationData;

pub use validate::local::validate_local_path;

pub use validate::local::validate_local_yaml;

pub use validate::metadata::MetadataConfig;

pub use validate::metadata::MetadataValidation;

pub use validate::metadata::MetadataValidationData;

pub use validate::metadata::validate_metadata_yaml;

Modules

catalog

Deterministic derived catalog for archived plans.

cli

plan-archive CLI dispatcher.

completion

Shell-completion generation backed by clap_complete.

discover

plan-archive discover — read-only archive-candidate scanner.

migrate

plan-archive migrate — dry-run and apply.

query

plan-archive query — read and aggregate _index/ snapshots and traverse archived-plan ↔ ref links.

refresh

plan-archive refresh — fetch provider payloads through forge-cli and append scrubbed, append-only snapshots to _index/.

scrub

Secret-scrub library v1.

search

plan-archive search <term> — hit-level full-text search across archived issue / PR / MR body and comment text.

source

Shared source-repo / archive / hosts resolution.

validate

Schema validators backing the plan-archive validate-* subcommands.

Functions

run

Entrypoint used by src/main.rs. Returns the process exit code.