Skip to content

docs(adr): adopt released truth for public documentation - #98

Merged
JimCollinson merged 52 commits into
mainfrom
adr/released-and-usable-truth
Aug 31, 2026
Merged

JimCollinson merged 52 commits into
mainfrom
adr/released-and-usable-truth

Conversation

@JimCollinson

@JimCollinson JimCollinson commented Aug 20, 2026

Copy link
Copy Markdown
Member

Purpose

This PR accepts ADR-0016: public developer documentation describes stable software the public can obtain, rather than unreleased default-branch code.

Accepted decision

  • Public documentation uses an explicit released baseline with exact provenance.
  • Multi-component claims identify compatible released components, shipped dependencies, and relevant deployed-network state.
  • Unreleased source may prepare future documentation but cannot support default public claims.
  • Known defects and unsupported tasks are represented honestly.
  • Pre-release documentation, if published, remains separate.
  • A separate developer skill is outside this ADR.
  • Implementation details and sequencing belong in a separately reviewed specification and plan.

Human acceptance and merge authorization

Jim Collinson accepted ADR-0016 after reviewing PR #98 on 2026-08-31 and explicitly authorized this PR to be merged after final mechanical gates were green. ADR-0016 is recorded as Accepted in this PR. This is the human decision; it is not autonomous AI acceptance.

Acceptance and merge do not authorize implementation or documentation remediation. That work requires a fresh release audit and a separately approved specification, plan, and slice.

Scope

This PR contains Accepted ADR-0016, the historical audit that motivated it, and GSD review evidence. It does not implement the policy, update rendered documentation, or decide skill ownership.

ADR-0016 is 497 words including metadata and headings. It partially supersedes only the public source-selection and provenance clauses in ADR-0003, ADR-0004, and ADR-0006.

Final-head evidence

  • Final head: 789b8c672792464ea380626f745807902e443d10.
  • ADR governance and all 20 governance tests pass locally.
  • Process-required ADR Governance run 33395136858, job 99497748384, passed substantively on clean synthetic PR merge ref ab8cc592d0fa4b85e6166f31926380330b911c40.
  • GitHub branch protection requires prose, sweep, and sweep-SHA-reachability. Runs 33395136772, 33395136754, and 33395136786 are green not applicable scope results; their main validations were skipped because this PR does not change files in their scopes.
  • Both GitBook statuses passed.
  • Acceptance-record code review passed with no findings; verification passed 7/7. Exact reports are committed in the branch.
  • Final adversarial rerun: READY-WITH-NITS, with no CRITICAL, HIGH, or MEDIUM findings.
  • Final Craft Review: PASS with no CONFORMANCE or SIMPLICITY findings.
  • Carried LOW/NIT: the acceptance verification report does not identify the verifier/tool. Mechanical evidence was independently reproduced; no further commit is warranted.
  • Clean-context remains explicitly waived by Jim for ADR-0016 only; no substitute review ran.

Merge gate

All acceptance and mechanical merge gates are satisfied. Jim authorized this PR to merge on 2026-08-31. Implementation remains unauthorized.

JimCollinson and others added 30 commits August 12, 2026 17:41
- Supersede released source-resolution and drift semantics\n- Add branch-local v0.11.2 audit evidence
- Disqualify incumbents that no longer meet released baseline requirements
- Relabel unverified Python and Rust source-install routes
- Define stable candidate eligibility, deterministic ordering, and symmetric requalification

- Bound supersession, skill parity, release identity, and validation invariants
- Define deterministic fallback and complete incumbent requalification triggers

- Pin authoritative installs and constrain mutable aliases
- Treat fetched skill pointers as untrusted factual input\n- Keep mutable aliases unsupported and non-authoritative
- Keep one coherent active release set with journey-local support statuses\n- Define complete-route baseline, deterministic fallback, and parity rules
- Replace detailed policy mechanics with the approved durable release baseline
- Keep implementation and developer-skill architecture out of the proposal
@JimCollinson
JimCollinson marked this pull request as ready for review August 29, 2026 09:28
- Correct audit refs and preserve local-only provenance honestly
- Reconcile PR, review, waiver, and CI state
- Remove remote compare calls to a local-only historical commit
- Record the HIGH review finding and pending re-review and CI
- Mark scope-gated CI jobs as non-substantive no-ops
- Anchor the clean-context waiver record to its dated commit
- Add final remediation review and verification reports

- Condition acceptance presentation on current-head checks
- Record stale draft language in the PR body

- Preserve live non-draft PR status
- Mark ADR-0016 Accepted after Jim's review of PR #98
- Record merge authorization and preserve the implementation gate
- Shorten the accepted-record AI note without changing acceptance metadata
- Record the verified 497-word full-file count
- Add branch-local acceptance review reports

- Record exact CI roles and remaining mechanical gates
@JimCollinson
JimCollinson merged commit 33c042d into main Aug 31, 2026
6 checks passed
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