Struct FileProjectionAdapter 

pub struct FileProjectionAdapter { /* private fields */ }

File-backed ProjectionAdapter: materializes the projected value under root, at the target ProjectionPlacement::target_path resolves for key, and reads it back on Self::fetch. Self::new resolves through ProjectionPlacement::default (the pre-GH-#27 hardcoded <root>/workspace/tasks/<task_id>/ctx/<step-or-_ctx>.md layout, unchanged); Self::with_placement resolves through a caller-supplied resolver instead — see crate::core::projection_placement’s module doc for the “3 path” convergence this collapses.

Implementations

impl FileProjectionAdapter

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

Builds an adapter rooted at root (typically the resolved work_dir / project_root) using the byte-compat ProjectionPlacement::default resolver.

pub fn with_placement( root: impl Into<PathBuf>, placement: ProjectionPlacement, ) -> Self

Builds an adapter rooted at root, resolving materialize targets through the given placement instead of the byte-compat default — the constructor every one of the “3 path” call sites (crate::core::projection_placement’s module doc) uses once they hold a Blueprint-resolved ProjectionPlacement.

pub fn materialize_submission( &self, key: &ProjectionKey, value: &Value, attempt: u32, ok: bool, ) -> Result<ProjectionRef, ProjectionError>

Submit-path materialize (subtask-4 / ST2 rework — see the module doc’s “Submit-path projection” section). Unlike Self::project, value is not narrowed out of a larger ctx_data via ProjectionKey::resolve — it is the exact submitted content, so this writes it directly. Reuses Self::target_path (the same ProjectionPlacement-resolved target — byte-compat default <root>/workspace/tasks/<task_id>/ctx/<step>.md — as Self::project), so a later Self::fetch against the same key reads it back unchanged (fetch only parses the fenced ```json block, so the extra attempt / ok front-matter fields this writes are inert to it). A full replace, never append — re-submitting the same (task_id, producer_agent) overwrites (idempotent, latest wins — Subtask 4 Invariant 2 / Test 4).

key.step must be Some(producer_agent) — this is a submission slot, never “the whole ctx” (step: None still resolves to a valid path via ProjectionKey::step_slug’s "_ctx" fallback, but a caller addressing an actual submission should always name the producing agent).

Trait Implementations

impl ProjectionAdapter for FileProjectionAdapter

fn name(&self) -> &'static str

Stable adapter name ("file" / "mcp-query"), used in log lines and diagnostics.

fn project( &self, key: &ProjectionKey, ctx_data: &Value, ) -> Result<ProjectionRef, ProjectionError>

Projects the slice of ctx_data addressed by key and returns a locator a worker can later Self::fetch. ctx_data is the policy-filtered ctx data slice this projection is drawn from — the adapter never mutates it.

fn fetch(&self, key: &ProjectionKey) -> Result<Value, ProjectionError>

Pulls the value addressed by key directly, without going through a previously returned ProjectionRef locator.

fn pointer_line(&self, r: &ProjectionRef) -> String

Renders the 1-3 line pointer this adapter’s ProjectionRef contributes to the directive header. Must never embed the projected value itself (inline full-embed is the exact problem projection exists to avoid — see the module doc).