docs(decisions): deliver decisions-on-pr — roadmap Achieved and the Herald docs pointer [roadmap:decisions-on-pr]#352
Merged
Conversation
…ome [roadmap:decisions-on-pr] Implements rac/roadmaps/decisions-on-pr.md (epic #351), the top-ranked net-new adoption lever from adoption-opportunity-survey, under the pr-decision-surfacing design. The design's three Open Questions close as recorded: the action ships in rac-ci — the CI wrappers' extracted home — while the corpus record and docs pointer stay in rac-core; changed paths are computed action-side with no engine change (decisions-for is a covered command); noise is tuned by live-only scoping, dedupe, sorted output, an inline cap with a details expander, no comment when nothing governs, and update-in-place always. Claim check clean.
… rac-ci [roadmap:decisions-on-pr] Implements rac/roadmaps/decisions-on-pr.md (epic #351): the Herald capability merged as asdecided/ci#3 — the advisory governing-decisions comment on pull requests, thin client over rac decisions-for --json, facts never a merge gate. Records the delivered answers to the design's three Open Questions and the v1-tag note (the tag predates Herald; consumers reference @main until a tag that includes it is cut).
…admap:decisions-on-pr] The docs pointer for the delivered rac-ci capability: the one-block workflow wiring against itsthelore/rac-ci/herald/github, the comment contract (facts, live decisions only, deterministic bytes, empty-state updates, fork fallback), how a team gets governed via ## Applies To, and the advisory boundaries. Nav after Watchkeeper; changelog entry under Unreleased.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes out the
decisions-on-prroadmap in the corpus now that the implementation — the Herald capability — has shipped and merged in its canonical home, asdecided/ci#3. This PR is the rac-core side of that delivery: the roadmap graduates fromfuture/, flips to Achieved, and the docs site gains the "Decisions on PRs" page that tells adopters how to wire Herald up.Three commits, in lifecycle order:
docs(roadmap)— graduatedecisions-on-prout ofrac/roadmaps/future/with rac-ci recorded as the action's home.docs(roadmap)— mark it Achieved: Herald delivered (itsthelore/rac-ci/herald/github), with the design's three Open Questions closed as delivered — the action ships in rac-ci beside the other wrappers; changed paths are computed action-side with no engine change (decisions-foris already a covered command under the ADR-116 dispatcher); noise is tuned via live-only scoping, dedupe-by-id, sorted output, an inline cap with a details expander, and update-in-place always (including to the empty state).docs(decisions)— adddocs/decisions-on-pr.md(wiring block, comment anatomy,## Applies Toon-ramp, boundaries), register it in the mkdocs nav after Watchkeeper, and add the Unreleased changelog entry.Roadmap / ADR trace
rac/roadmaps/decisions-on-pr.md(epic Epic: decisions-on-pr — the advisory governing-decisions comment #351; implementation merged as feat(herald): add the Lore decisions-on-PR capability [roadmap:decisions-on-pr] ci#3).pr-decision-surfacing— the contract Herald was built to.Scope
Corpus and docs only — no engine change, no CLI change, no JSON-contract change (ADR-007 untouched). Files:
rac/roadmaps/decisions-on-pr.md,docs/decisions-on-pr.md,mkdocs.yml,CHANGELOG.md.Verification
rac validate rac/— 424/424 artifacts valid.rac relationships rac/ --validate— 0 issues.rac gate rac/— passed, no priority 1–2 findings.Notes
v1tag predates Herald, so the docs wiring block pinsuses: itsthelore/rac-ci/herald/github@mainand says to prefer a tag once one that includes Herald is cut — that tag cut is the recorded maintainer follow-up on Epic: decisions-on-pr — the advisory governing-decisions comment #351.