Struct PlanCtx 

pub struct PlanCtx {
    pub cwd: PathBuf,
    pub passthrough: Vec<String>,
    pub tags: Enrichment,
    pub ledger_home: Option<PathBuf>,
    pub spawn_start_ts: SystemTime,
}

Driver-side context handed to every adapter call. Mirrors the TS HarnessRunContext shape one-to-one (cwd, passthrough, tags, spawnStartTs) plus the Rust port’s typed ledger-home override.

tags is a BTreeMap<String, String> (re-exported from the SDK as Enrichment) so insertion order doesn’t matter for the on-disk stamp record — the pending-stamp serializer canonicalizes ordering.

Fields

cwd: PathBuf

Working directory the user invoked burn run from. Forwarded to the spawned harness so it picks up project-local config.

passthrough: Vec<String>

Argv tail after the subcommand boundary, e.g. burn run claude -- "explain this" ⇒ ["explain this"]. Adapters splice this into their generated argv via SpawnPlan::args.

tags: Enrichment

User-supplied enrichment that will be merged onto the resulting stamp. Keys are free-form (task, pr, …); the Wave 2 driver translates --tag k=v flags into entries here.

ledger_home: Option<PathBuf>

Optional ledger home selected by --ledger-path. Pending-stamp adapters use this for both manifest writes and ingest passes so read/write sidecars stay scoped to the same home without relying solely on process env mutation.

spawn_start_ts: SystemTime

Wall-clock timestamp captured by the driver immediately before before_spawn. Used by the pending-stamp manifest so the post-exit resolver can match against session-file mtimes.

Trait Implementations

impl Clone for PlanCtx

fn clone(&self) -> PlanCtx

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PlanCtx

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

Formats the value using the given formatter.