Holon #6 — Materialize inherited ADR foundations

[szmyty]

Closes #6

Summary

• Materialize Hygiene's approved architecture-decision policy as a reusable Holon foundation capability without copying organization-owned policy.
• Add a closed, versioned ADR blueprint plus a dependency-free validator and non-destructive review-pack renderer.
• Preserve repository-owned ADRs, generate deterministic indexes, and bound repository-specific extensions and exceptions.
• Document initialization, migration, ownership, upgrades, rollback, and consumer behavior for Relay and later adopters.

Files changed

• catalog/foundation.json, all example manifests, and the foundation manifest schema add the required architecture-decisions capability and immutable adr_policy pin.
• blueprints/architecture-decisions/ and schemas/architecture-decision-blueprint.v1.schema.json define the inherited contract, generated assets, repository-owned paths, and ADR template.
• tools/architecture_decision_blueprint.py validates and renders deterministic review packs without mutating target repositories.
• tests/test_architecture_decision_blueprint.py and tests/test_holon_contract.py cover canonical validation, rendering, preservation, ordering, conflicts, bounded customization, and required pins.
• docs/architecture-decision-blueprint.md, README.md, ARCHITECTURE.md, SYSTEM.md, and ROADMAP.md document the operating model and current roadmap evidence.
• .github/workflows/validate.yml adds the blueprint contract check to CI.

Validation

• python3 -m compileall -q tools tests — passed.
• python3 tools/architecture_decision_blueprint.py validate — passed; blueprint 1.0.0, one static source file.
• for manifest in examples/*.manifest.json; do python3 tools/holon_contract.py validate --manifest "${manifest}"; done — passed for all 9 example manifests.
• python3 -m unittest discover --start-directory tests --pattern "test_*.py" — passed, 135 tests.
• node --test tests/javascript/*.test.mjs — passed, 18 tests.
• python3 tools/holon_materialize.py continuity verify --target "." — passed; canonical checkpoint state verified.
• python3 tools/check_repository_continuity_dogfood.py --aether-source "../aether" — passed; valid status, exact root parity, deterministic create/no-op plans.
• python3 - <<'PY' ... JSON parse catalog/examples/schemas/blueprint ... PY — passed for every changed JSON document.
• git diff --check — passed.

References

• Hygiene #15
• Hygiene PR #48
• Approved organization policy revision f598ed659a43dd759d4ede41c27f9e5daf991aa7
• Relay #5
• Holon ADR backfill #56

Notes

• No new local ADR is included: this change implements the already accepted organization ADR-002 and policy ownership boundary; Holon's historical ADR extraction remains tracked by Backfill repository ADR history and enable continuous decision capture #56.
• The repository-requested maintain-repository-continuity skill was unavailable in this session. The committed canonical checkpoint was therefore kept unchanged and verified with both continuity checks instead of claiming an unsupported refresh.
• Package-installing clean-room fixtures were not rerun because this change is dependency-free and scoped to ADR/foundation contracts; the complete Python and JavaScript suites passed.
• This PR is intentionally left unmerged for review.

[devactivity-app]

Pull Request Summary by devActivity

Metrics

Achievements

• @szmyty
  Earned XP: 15⭐
  Check Your Progress