Skip to content

Regenerate architecture map and gate its freshness in CI#139

Merged
tieguy merged 1 commit into
mainfrom
claude/architecture-map-ci-check
Jul 10, 2026
Merged

Regenerate architecture map and gate its freshness in CI#139
tieguy merged 1 commit into
mainfrom
claude/architecture-map-ci-check

Conversation

@tieguy

@tieguy tieguy commented Jul 10, 2026

Copy link
Copy Markdown
Collaborator

Summary

The generated architecture map went stale on main within hours of the doc PRs landing — #129 added PRD-0016 between merges, and nothing runs the generator's --check yet. Two changes:

  • docs/platform/architecture.md regenerated (now 15 PRDs; picks up PRD-0016 and the post-merge status states).
  • A "Architecture map freshness" step added to the CI checks job, right after the layer check: ./scripts/generate-architecture-map.sh --check. The job already has cargo, and the check is a deterministic diff — any PR that adds a crate, ADR, or PRD without regenerating the map now fails with a one-line "run the script and commit" message.

Type

  • Bug fix
  • Feature
  • Refactor
  • Documentation
  • Build, CI, or release
  • Security-sensitive change

Validation Required

./scripts/generate-architecture-map.sh --check   # passes after regeneration
./scripts/check-links.sh                         # all internal links resolve

Risk

  • Touches auth/session/cookies/CSRF
  • Touches deployment/runtime configuration
  • Touches desktop packaging
  • Touches scoring or Wikimedia action behavior
  • Needs an ADR

Notes For Reviewers

One behavioral note: the freshness gate means doc-only PRs that touch ADRs/PRDs will need cargo metadata locally to regenerate the map (the generator's only cargo dependency — no build). That's the same requirement check-layering.sh already imposes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FWVy56w8xjBRQKwC94Har3


Generated by Claude Code

The map went stale on main within hours of landing (#129 added
PRD-0016 between merges) because nothing ran the generator's --check.
Adds it to the CI checks job next to the layer check, and regenerates
the page (now 15 PRDs).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FWVy56w8xjBRQKwC94Har3
@tieguy
tieguy requested a review from schiste as a code owner July 10, 2026 22:05
@tieguy
tieguy merged commit 238f419 into main Jul 10, 2026
4 checks passed
@tieguy
tieguy deleted the claude/architecture-map-ci-check branch July 10, 2026 22:07
tieguy pushed a commit that referenced this pull request Jul 12, 2026
Brings in the Wikidata entity read path (#119), the citation
repair/insertion browser surface (#109), the architecture map + CI
freshness gate (#118/#139), coordination fail-closed (#146), the
as-built ADRs 0020-0023, and the docs attic move.

Conflicts were the book-citation lane (this branch) and the bare-URL
repair lane (main) touching the same seams; resolved by union:

- BlockRef carries both book_sources (branch) and is_bare_url_ref
  (main); parsoid threads RefSources and the ref_bare map side by side.
- CitationFinding carries both book_scan and is_bare_url_ref.
- verify_page keeps the books pass; main's re-verify surface
  (select_reverify_use_site / apply_reverified_finding) now tallies
  through the five-argument tally_stats with book resolutions intact.
- STATUS.md keeps both progress bullets.

Regenerated docs/platform/architecture.md for the new citation modules
(openlibrary, search_inside, enrich, openlibrary_apply).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012u5MVp3vAN44KhsVg3vroY
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.

2 participants