Skip to content

docs: generate ADR deferral index - #104

Merged
verlyn13 merged 1 commit into
mainfrom
feat/adr-deferral-index
Aug 31, 2026
Merged

docs: generate ADR deferral index#104
verlyn13 merged 1 commit into
mainfrom
feat/adr-deferral-index

Conversation

@verlyn13

Copy link
Copy Markdown
Member

Purpose

Accept ADR 0081 with its implementation under D-085's successor rule. Add a deterministic, derived, non-authoritative ADR-deferral index with exact source payloads and inclusive spans, fail-closed ambiguity review, explicit file-existence resolution, and a separate irregular-form review queue.

The generator deliberately ignores ADR frontmatter status as both an extraction predicate and an implementation-authorization signal. The proposed registry-to-charter pointer check is dropped; the existing self-governed authority-document carve-out remains unchanged.

Ring changed

  • Ontology/schema
  • Kernel
  • Adapter
  • Dashboard
  • Hook
  • Eval
  • Docs

Class J CI/documentation tooling is also added under scripts/ci/.

Boundary checks

  • No policy duplicated into adapter/hook
  • No universal shell execution added
  • No audit-write agent endpoint added
  • OperationShape remains upstream of CommandShape
  • Evidence includes provenance/freshness where applicable
  • Dashboard impact considered
  • Citation discipline — ADR 0081 §Decision authorizes this exact implementation: “Choose Option A. Add a dependency-free generator at scripts/ci/adr-deferral-index.js and track its output at docs/host-capability-substrate/adr-deferral-index.md.” The citation is inside the decision, not §Out of scope.
  • Precedence respected — no accepted ADR is relieved or overridden.
  • Charter text quoted verbatim or untouched — charter text is untouched.

Validation

just verify
# ✓ node-tools
# ✓ static-gates
# ✓ fixtures
# ✓ all quality gates passed

just adr-deferral-index-check also passes, including the embedded fixtures and byte-exact generated-file comparison.

Charter compliance

Complies with implementation charter v1.6.0. Ring: none (Class J docs/CI tooling). No cross-ring imports added.

Required Class-J hcs-architect review completed before commit. Three design-objection rounds and two implementation-objection rounds were folded; the final review and the post-review provenance-marker delta review each returned no blocking or non-blocking objections.

Agent use

  • Implementer: Codex main session (Class-J docs/CI implementation)
  • Reviewer: hcs-architect
  • Subagents: hcs-architect objections/reviews; bounded worker for generator implementation

@verlyn13
verlyn13 requested a review from a team as a code owner August 31, 2026 00:02
@verlyn13
verlyn13 merged commit 73593a9 into main Aug 31, 2026
1 check passed
@verlyn13
verlyn13 deleted the feat/adr-deferral-index branch August 31, 2026 01:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant