Files
Kill_LIFE/docs/REPO_STATE_HEADER_CONTRACT.md
L'électron rareandClaude Opus 4.6 066acde0cb docs: add feature maps, audits, research, plans lots 19-26
- Feature maps: agentic intelligence, digital factory, yiacad global/UI/UX/backend
- Audits: consolidation, refactor manifest, exhaustive refonte
- Research: OSS AI-native CAD, digital factory stack, mascarade observability
- Plans: lots 19-26 (mesh tri-repo, UI/UX refonte, yiacad global,
  intelligence agentique, mistral agents/studio, hypnoled, EDA AI tools,
  git EDA platform)
- Operator docs: machine registry, alignment, sync status, provider compat
- Mascarade/Kill_LIFE product contracts and OPS bridge
- PCB AI fab integration map, artifact WMS index
- References directory

Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
2026-03-24 00:20:32 +01:00

1.3 KiB

REPO_STATE Header Contract

Version: v1

Source of truth

The global response header MUST be derived only from each configured repository file:

  • docs/REPO_STATE.md

No free-form manual edits are allowed in generated outputs.

Required local files (Kill_LIFE)

  • tools/repo_state/collect.py
  • tools/repo_state/repo_refresh.sh
  • tools/repo_state/lint_header_contract.py
  • docs/REPO_STATE.md
  • docs/repo_state.json
  • tools/repo_state/repo_refresh.sh (targets default: Kill_LIFE)

Header format (mandatory)

[REPO-STATE UTC: <timestamp>]
Kill_LIFE                    | HEAD <sha> | pivots: <...> | gates: <...>
[/REPO-STATE]

Contract checks

repo_state_header_gate MUST fail if any of the following is true:

  • missing <!-- REPO_STATE:v1 --> marker in docs/REPO_STATE.md
  • missing required keys in docs/REPO_STATE.md or docs/repo_state.json
  • malformed header markers in artifacts/repo_state/header.latest.md
  • missing the repository line in the generated header

Commands

Generate local state:

python tools/repo_state/collect.py --repo-name Kill_LIFE

Generate global artifacts:

tools/repo_state/repo_refresh.sh

Header only:

tools/repo_state/repo_refresh.sh --header-only

JSON only:

tools/repo_state/repo_refresh.sh --json-only