chore(#75): release v0.3.0 — multi-project + C4 + migrations + site refresh#76
Conversation
…efresh Cuts the v0.3.0 changelog and updates site version refs. Themes (17 commits since v0.2.0): - **Multi-project comes alive** — per-project active-ticket markers (#41), /update skill for fork sync (#58), SessionStart drift banner (#63). - **C4 architecture diagrams** — Mermaid L1+L2 templates (#50), /handover seeds a stub L2 (#67). - **Migration gate** — require-migration-ticket.sh (#59), /migration skill, agdr-migration template, workflow gate 3a. - **Site refresh** — whole-framework positioning (#73). - **Hook robustness** — gh api merge bypass closed (#47), absolute-path exemptions (#56), Rex marker format enforcement (#62/#66), gh-pr-view fallback for HEAD resolution. Site index.html: all four v0.x references bumped (titlebar pill, hero pill, hero release link, footer line) — three were stale at v0.1 from the v0.2 release; consolidated all four to v0.3 here. Refs #75
atlas-apex
left a comment
There was a problem hiding this comment.
Code Review: PR #76
Commit: 3f4a6b48db02b68c8a3879a4de126e302003c0c0
Summary
Release-prep for v0.3.0: adds a 59-line changelog section and bumps four stale version refs in site/index.html (three were v0.1, one was v0.2.0). Pure docs, no code, no tests, no AgDR required.
Checklist Results
- Architecture & Design: N/A (docs-only)
- Code Quality: Pass
- Testing: N/A (docs-only)
- Security: Pass (no secrets, no code)
- Performance: N/A
- PR Description & Glossary: Pass — 4-term Glossary present (semver bump, drift banner, C4 model, migration gate)
- Technical Decisions (AgDR): N/A — release-prep is not an architectural decision. AgDR-0003 already covers the Mermaid C4 call from #50.
Fact-Checking Against Actual Main
Ran git log --no-merges --format='%h %s' v0.2.0..HEAD~1 and cross-checked every numbered claim:
| Claim | Verified |
|---|---|
| 17 commits since v0.2.0 (9 feat + 8 fix) | exact |
| Per-project active-ticket markers (#41) | 49f3e1a |
| /update skill (#58) | 0031f68 |
| SessionStart drift banner (#63) | e23c1ab + check-upstream-drift.sh exists |
| Mermaid C4 L1+L2 templates (#50) | 7c6dcd3 + templates/architecture/{c4-context,c4-container}.md exist |
| /handover C4 L2 stub (#67) | 988f449 |
| AgDR-0003 for Mermaid C4 | docs/agdr/AgDR-0003-mermaid-c4-for-diagrams.md exists |
Dogfood diagrams docs/architecture/apexstack-{context,container}.md |
both present |
Migration gate require-migration-ticket.sh (#59) |
dfdbedf + hook exists |
/migration skill + templates/agdr-migration.md |
both present |
| Workflow gate 3a added | row 3a in workflow-gates.md table, "Migration Gate (3a)" section below |
| Site refresh (#73) | a55896c |
gh api merge bypass closed (#47) |
1299b59 + _lib-extract-pr.sh exists |
| Absolute-path exemptions (#56) | 1e666a0 |
| Rex marker format enforcement (#62 → #66) | d0d1fb8 |
Merge gates via gh pr view (#55/#57) |
c8c93bb |
| Reject closed-issue refs | 5f067b5 |
| Structured ticket templates (/feature, /bug, /task) | 8305481 + all three skill dirs exist |
| Hooks resolve ops root from workspace | 3586278 |
| 32 skills (up from 27 in v0.2) | exact count of .claude/skills/*/ |
| 9 modular rules (unchanged) | exact |
| 4 site version refs all v0.3/v0.3.0 | lines 1100, 1121, 1128, 1602 |
No invented features. No fabricated PR numbers. No broken links detected.
Issues Found
None blocking.
Suggestions (non-blocking)
Hook count: 17 vs 18. The changelog says "17 hooks wired in .claude/settings.json (up from 15 in v0.2)". Counting .sh scripts actually referenced in settings.json:
- v0.2.0 tree: 15 hook scripts (plus
README.md) - v0.3.0 HEAD: 19
.shfiles — of which_lib-extract-pr.shis a shared library (not a hook), leaving 18 real hooks wired
New hooks since v0.2: check-upstream-drift.sh, require-migration-ticket.sh, and suggest-ticket-template.sh. That's 15 + 3 = 18, not 17. CLAUDE.md line 172 also says "17 shell scripts", so the changelog faithfully mirrors the existing undercount — this isn't a new error introduced by this PR, but it would be a good moment to fix both files together. If you agree it's worth correcting, bump both the changelog "Stats" line and CLAUDE.md line 172 from 17 → 18 before tagging.
(If you'd rather not block the release on a one-line fix, ship as-is and fix in a follow-up — the number is illustrative, not load-bearing.)
Verdict
APPROVED (with one optional tweak noted above)
Factually accurate, well-structured, glossary compliant, all referenced artefacts exist on disk. Safe to tag and release.
Reviewed by Rex (Code Reviewer Agent)
Reviewed commit: 3f4a6b48db02b68c8a3879a4de126e302003c0c0
… site refresh (me2resh#76) Cuts the v0.3.0 changelog and updates site version refs. Themes (17 commits since v0.2.0): - **Multi-project comes alive** — per-project active-ticket markers (me2resh#41), /update skill for fork sync (me2resh#58), SessionStart drift banner (me2resh#63). - **C4 architecture diagrams** — Mermaid L1+L2 templates (me2resh#50), /handover seeds a stub L2 (me2resh#67). - **Migration gate** — require-migration-ticket.sh (me2resh#59), /migration skill, agdr-migration template, workflow gate 3a. - **Site refresh** — whole-framework positioning (me2resh#73). - **Hook robustness** — gh api merge bypass closed (me2resh#47), absolute-path exemptions (me2resh#56), Rex marker format enforcement (me2resh#62/me2resh#66), gh-pr-view fallback for HEAD resolution. Site index.html: all four v0.x references bumped (titlebar pill, hero pill, hero release link, footer line) — three were stale at v0.1 from the v0.2 release; consolidated all four to v0.3 here. Refs me2resh#75 Co-authored-by: me2resh <ahmed.abdelaliem@gmail.com>
… site refresh (me2resh#76) Cuts the v0.3.0 changelog and updates site version refs. Themes (17 commits since v0.2.0): - **Multi-project comes alive** — per-project active-ticket markers (me2resh#41), /update skill for fork sync (me2resh#58), SessionStart drift banner (me2resh#63). - **C4 architecture diagrams** — Mermaid L1+L2 templates (me2resh#50), /handover seeds a stub L2 (me2resh#67). - **Migration gate** — require-migration-ticket.sh (me2resh#59), /migration skill, agdr-migration template, workflow gate 3a. - **Site refresh** — whole-framework positioning (me2resh#73). - **Hook robustness** — gh api merge bypass closed (me2resh#47), absolute-path exemptions (me2resh#56), Rex marker format enforcement (me2resh#62/me2resh#66), gh-pr-view fallback for HEAD resolution. Site index.html: all four v0.x references bumped (titlebar pill, hero pill, hero release link, footer line) — three were stale at v0.1 from the v0.2 release; consolidated all four to v0.3 here. Refs me2resh#75 Co-authored-by: me2resh <ahmed.abdelaliem@gmail.com>
Summary
Cuts the v0.3.0 changelog and updates
site/index.htmlversion refs (which were stale at v0.1 in three places). 17 commits since v0.2.0 — 9 features, 8 fixes, all PR-merged.Themes captured in CHANGELOG.md
/updateskill ([Feature] /update command to sync ApexStack fork from upstream #58), SessionStart drift banner ([Feature] SessionStart drift banner — show when fork is behind upstream #63)./handoverseeds a stub L2 ([Feature] /handover skill generates a stub C4 L2 container diagram #67).require-migration-ticket.sh([Feature] Ticket-first gate for database migrations + /migration skill + migration AgDR template #59),/migrationskill,agdr-migrationtemplate, workflow gate 3a.gh api .../mergebypass closed (fix: merge gate hooks don't catch gh api .../merge bypass #47), absolute-path exemptions ([Bug] require-active-ticket.sh fails when REPO_ROOT is a nested worktree — strips wrong prefix from FILE_PATH #56), Rex marker format enforcement ([Bug] code-reviewer agent writes malformed rex-approval marker (contains 'PR: N\nSHA: ...' instead of bare SHA) #62/fix(#62): tighten code-reviewer marker-writing to enforce bare SHA #66), gh-pr-view fallback for HEAD resolution.Plan after merge
Testing
grep -nE "v0\.[0-9]" site/index.htmlreturns four lines, all v0.3 / v0.3.0Closes #75
Glossary