|
| 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