Skip to content

docs(adr): correct the ADR-0018 inert-inputs claims in pointer form (#369) - #376

Merged
brenpike merged 5 commits into
mainfrom
docs/369-adr-0018-inert-inputs-correction
Sep 25, 2026
Merged

brenpike merged 5 commits into
mainfrom
docs/369-adr-0018-inert-inputs-correction

Conversation

@brenpike

Copy link
Copy Markdown
Owner

Summary

Corrects the superseded claims in ADR-0018's 2026-05-31 inert inputs-file navigator implementation note, without rewriting the original body.

  • Adds a scoped supersession note under the 2026-05-31 note heading. It points at plugin/governance/security-policy.md ("Inert Inputs-File Navigator Pattern") and at the new amendment.
  • Appends a 2026-09-25 amendment. It corrects four claims: the "Inert content" absolute (withdrawn as an over-claim), the retired singleton transport paths, the "All three pipeline navigators" count, and the spawn-brood transport exemption recorded in the 2026-06-01 amendment.
  • Item 5 states a standing rule: every path, version number, count, membership list and named mechanism in this ADR's notes and amendments is a dated snapshot, not authority. Readers take current values from the live source.

The corrections are in pointer form. Each item names the superseded claim and the live document that owns the subject, and restates no current value. Local review showed that every copied value became the next stale-literal finding, so the correction text now carries none. No line that exists on main is modified; the diff is insertions only.

Closes #369.

Validation

  • bash tools/validate.sh --changed: policy_check.sh --strict PASS, 0 new findings (docs/adr/* maps to the policy suite).
  • Local Codex review (4 iterations): fixed findings on the navigator enumeration, the inherited brood-manifest literals, and the live-value restatements. A final finding asked for section-level pointers into ADR-0021 and plugin/references/brood-ledger-model.md instead of whole-document pointers. It was accepted as a residual, because those section headings carry ordinals and a schema version literal, which would bring back the stale-literal class.

Versioning

Docs-only (docs/adr/**). No plugin runtime change, no version bump, no CHANGELOG entry.

Follow-ups

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e65b6605d7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/adr/0018-declarative-workflow-state-machine.md Outdated
@brenpike
brenpike merged commit b422937 into main Sep 25, 2026
1 check 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.

ADR-0018: inert-inputs pattern still claims field content is never a path or instruction

1 participant