chore: capture reconcile design as ADR-010 and remove working specs#127
Merged
Conversation
Captures the durable decisions from the 2026-07-08 reconcile/upgrade discoverability design before its working spec is removed: the audit.py --reconcile JSON entrypoint as the only seam between the Python engine and shell surfaces, the confirm-each + dry-run safety model with an unbypassable SYSTEM_TOOL_SAFELIST, the pin/lock override warning on upgrade-managed/upgrade-all, and advisory-only discoverability hints. Also indexes ADR-009 in docs/adr/README.md, which was missing from the index table. Signed-off-by: Sebastian Mendel <sebastian.mendel@netresearch.de>
The 2026-07-08 reconcile/upgrade discoverability design is captured in ADR-010; the 2026-07-22 blesh/bash-completion design's durable content already lives in scripts/AGENTS.md (completion framework schema and invariants), catalog/COVERAGE.md (sweep results and exclusion rationale), root AGENTS.md (make targets), catalog/blesh.json, and scripts/install_blesh.sh header comments. Both files remain recoverable from git history. Signed-off-by: Sebastian Mendel <sebastian.mendel@netresearch.de>
Contributor
Dependency Review✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.Scanned FilesNone |
|
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
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
The
/pr-finishspec-cleanup guard flagged two intermediate planning artifacts committed onmain(docs/superpowers/specs/). Per the cleanup policy — convert durable decisions to an ADR, then remove the raw files — in two commits:1.
docs(adr): ADR-010 — Reconcile Engine as Single Source of Truth (capture)audit.py --reconcile [--all] [--apply] [--yes]JSON entrypoint as the only seam betweencli_audit/reconcile.pyand shell surfaces; the confirm-each + dry-run safety model (FORCE=1/--yesbypass prompts, neverSYSTEM_TOOL_SAFELIST); the pin/lock override warning onupgrade-managed/upgrade-all; advisory-only discoverability hints.docs/adr/README.mdindex (ADR-009 was missing from it).2.
chore: remove both spec files (recoverable from git history)scripts/AGENTS.md(framework schema + invariants),catalog/COVERAGE.md(sweep results + exclusion rationale), rootAGENTS.md(make targets),catalog/blesh.json, andscripts/install_blesh.shheader comments; no ADR warranted.Nothing in tests, workflows, or other docs references
docs/superpowers/(grepped).Verification
Out of scope (noted for follow-up)
Doc drift found during analysis:
bleshis absent from the tool lists incatalog/CATALOG_SUMMARY.mdand the top list incatalog/COVERAGE.md;cli_audit/AGENTS.mdstill says "79 JSON files in catalog/" (now 100); ADR-009 still lacks the status note that aggressive reconcile is user-reachable.