Skip to content

Commit 386e5d5

Browse files
committed
docs: add CONTEXT_ANCHOR as authoritative project state snapshot
1 parent cf97018 commit 386e5d5

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

docs/CONTEXT_ANCHOR.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# ShieldCraft Engine — Context Anchor
2+
3+
## What This Project Is
4+
5+
- ShieldCraft Engine is a deterministic software manufacturing engine that validates canonical product specifications and produces auditable, reproducible build artifacts for review and CI.
6+
7+
## What Is Complete
8+
9+
- Canonical DSL and schema: `spec/se_dsl_v1.spec.json` and `spec/schemas/se_dsl_v1.schema.json`.
10+
- Determinism tooling and checks: `scripts/canonical_full_run.py`, `scripts/canonicalize_spec.py`, and related tests (e.g., `tests/ci/test_canonical_full_run_regression.py`, `tests/spec/test_canonical_json.py`).
11+
- Self-host dry-run and artifact emission tooling, including deterministic preview and manifest emission (see `src/shieldcraft/engine.py` and self-host scripts).
12+
- Governance artifacts and audits: governance docs and audit script (`docs/governance/*`, `scripts/audit_docs.py`, `artifacts/governance/doc_classification_report.json`).
13+
- Persona subsystem (opt-in) with non-interference rules and tests (`docs/persona/*`, persona code under `src/shieldcraft/persona`, and persona tests under `tests/persona/`).
14+
- Test Attachment Contract (TAC) implemented as an opt-in enforcement (environment flag `SHIELDCRAFT_ENFORCE_TEST_ATTACHMENT`) and related validators/tests present.
15+
- Generated verification tests exist under `tests/generated/verification_spine/` and test-generation scripts under `scripts/`.
16+
17+
## What Is In Progress
18+
19+
- Phase 14 remediation: self-hosting validation failures are triaged and remediation work is started (`docs/governance/progress.md` shows `self-hosting-remediation: STARTED`).
20+
- Consolidation of verification and governance documentation (e.g., `docs/governance/VERIFICATION_SPINE.md` added/expanded).
21+
- Integrating determinism regression checks into CI (regression test added at `tests/ci/test_canonical_full_run_regression.py`).
22+
- Implementation PRs for approved RFCs are being prepared (spec changes are approved; implementation work is tracked in `docs/governance/progress.md`).
23+
24+
## What Is Explicitly Not Done
25+
26+
- A formal progress/state file schema is not defined (`docs/governance/progress.md` lists this as an open gap).
27+
- Remaining implementation of approved RFCs is pending review and PRs (the spec-level RFCs are approved; code/tests implementing them remain gated to PRs).
28+
- Phase 14 self-hosting validation is not completed; failures remain and remediation is ongoing.
29+
30+
## Current Focus
31+
32+
- Current active phase: Verification / Testing Spine. This phase exists to ensure engine outputs meet structural, semantic, and determinism guarantees by running deterministic previews, emitting canonical digests, and producing audit-ready artifacts for CI and external validation (see `docs/governance/VERIFICATION_SPINE.md` and `docs/governance/progress.md`).
33+
34+
## How This File Is Used
35+
36+
- This file is an authoritative, short snapshot of repository state for use in conversation resets and onboarding. Update it only when factual repository state changes and record changes in `docs/governance/decision_log.md` and via `scripts/audit_docs.py`.

0 commit comments

Comments
 (0)