Skip to content

fix(catalog): separate live and legacy issue records (#111) - #149

Merged
mberrys merged 3 commits into
devfrom
cc/g00-legacy-reference-reconcile
Sep 30, 2026
Merged

mberrys merged 3 commits into
devfrom
cc/g00-legacy-reference-reconcile

Conversation

@mberrys

@mberrys mberrys commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

Refs #111. Repo-side half of G00-01; the issue-body and roadmap-page halves are under "Outside the repo".

Problem

The preflight overlay's github_issues records were numbered against the retired repository. Its numbers overlap this repository's sequence, so every record and most open backlog rows resolved to an unrelated issue (legacy #47 and #49 opened L06-01 and L06-03; legacy #12 opened L11). The generator checked record shape only, so nothing could catch it.

Changes

Outside the repo

Not in this PR

Three legacy links stay: docs/GOVERNED_EXECUTION.md (1) and docs/adr/adr-011-architecture-contracts-d1-d5.md (2). Both belong to the governed-execution subsystem, whose binding proof lanes (UnitTestsGovernedExecution, packaging builds) a documentation change cannot carry, and building needs approval. check-architecture.py failed on them, so I restored both files rather than claim evidence I don't have.

The retired repository is not reachable from studio-berry or mberrys, so links cannot be re-homed to an archive. Content is recoverable from the Notion Loop Issues and Sessions ledgers.

Verification

  • python scripts/generate-architecture-catalogs.py --check passes; --check --verify-github passes against live GitHub.
  • scripts/ci/test_preflight_check_catalog.py, test_preflight_corpus_coverage.py, test_correction_operation_catalog.py: 62 tests pass (10 new, 1 updated).
  • python scripts/agent/check-change.py --base origin/dev: pass (modules: documentation).
  • No C++ changed, so nothing was built or configured.

🤖 Generated with Claude Code


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

mberrys and others added 3 commits September 28, 2026 18:44
The preflight overlay's github_issues records were numbered against the
retired repository, whose numbers overlap this repository's sequence, so
every record and most backlog rows resolved to an unrelated issue.

- github_issues entries carry `repository`. Live records are `#<n>` in
  studio-berry/loop; frozen legacy snapshots are `legacy#<n>`.
- The generator refuses an open legacy record as a row's `closed_by`, and a
  bare `#<n>` in gap text no longer satisfies a `legacy#<n>` record.
- `--verify-github` reads live records back with gh and rejects a missing
  issue, a pull request, or a changed title, state, or milestone.
- Sixteen open backlog rows re-point to the reset issues filed for them.
- The 28 legacy issue and PR URLs under docs/ become `legacy #<n>` text;
  docs/LEGACY_ISSUE_PROVENANCE.md records the convention and re-pointing.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
… proof lanes

Rewriting one link in docs/GOVERNED_EXECUTION.md makes governed-execution a
touched subsystem, which requires build and packaging proof lanes that a
documentation change cannot carry. Restore the file and record the exception.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
docs/adr/adr-011-architecture-contracts-d1-d5.md is owned by the
governed-execution subsystem, like docs/GOVERNED_EXECUTION.md. Restore it and
correct the counts in the fragment and provenance doc.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@mberrys
mberrys merged commit e26d83a into dev Sep 30, 2026
15 checks passed
@mberrys
mberrys deleted the cc/g00-legacy-reference-reconcile branch September 30, 2026 15:38
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