Sigil: Context Builder

For a plan-once execution-entry source, compile the native machine view with scripts/compile_native_context_projection.py. Validate the versioned closure and machine schema before producing any human-readable view. Do not translate snake_case planning fields directly into admission input, include lifecycle-owner scopes in executor writes, or infer selection/admission authority from successful compilation.

• identity: task/SWU id, source work-pack or task reference, run/session id when available;
• obligations: every parsed obligation with covered, resolved, or block status;
• selected sources: file paths, selectors, short excerpts, and obligation refs;
• architecture guidance and related feature context;
• constraints, non-goals, write scope, done criteria, and validation surface;
• gaps, blockers, contradictions, and explicit resolutions;
• authority precedence used to resolve conflicts;
• fallback exploration rule for the runtime;
• provenance: timestamp, source refs, and content hash or git SHA when available;
• output paths for the Markdown pack and JSON/index.

Strict coverage rule: a runtime handoff pack is runnable only when every obligation is covered by selected evidence or explicitly resolved as not applicable/deferred. Uncovered, contradictory, stale, unsafe, missing write-scope, or missing validation obligations return BLOCK.

Persistence rule: persisted handoff packs live under session/run evidence. They are audit artifacts for that execution, not reusable source-of-truth documents.

• include only selector-level evidence,
• map every selected item to at least one obligation,
• keep the noise ratio low,
• separate evidence from inference,
• report uncovered obligations,
• block runtime handoff packs unless all obligations are covered or explicitly resolved,
• avoid repository-wide context dumps,
• produce a compact artifact another agent can use immediately,
• emit Markdown plus JSON/index for runtime handoff packs,
• label persisted handoff packs as session evidence rather than canonical docs.

• copying whole files when a selector would suffice,
• including background material because it is interesting,
• running broad unbounded searches,
• omitting why each item was selected,
• hiding unresolved obligations,
• allowing a runtime handoff from incomplete, stale, contradictory, unsafe, or validation-missing context,
• persisting handoff packs beside canonical planning docs without labeling them session evidence,
• exceeding the selected mode budget without explanation.

## Context Pack Summary

- Task: <task-reference>
- Mode: lean | standard | deep
- Files selected: <count>
- Snippets selected: <count>
- Obligation coverage: <percent>
- Noise ratio: <value>
- Output markdown: <path or dry-run>
- Output index: <path or none>
- Handoff pack: <none | runtime>
- Session evidence path: <path | none | dry-run>
- Strict coverage: pass | block | n/a
- Blockers: <count>

### Included Context

- <path> - <why included> - <selectors> - <obligation refs>

### Excluded Candidates

- <path> - <why excluded>

### Next Actions

1. <action>