Skip to content

docs+release: v0.4.0 doc sync + semver bump + tag prep (ARC-008)#7

Merged
WouterDeBot merged 13 commits into
mainfrom
docs/arc-008-doc-semver-tag-sync
May 26, 2026
Merged

docs+release: v0.4.0 doc sync + semver bump + tag prep (ARC-008)#7
WouterDeBot merged 13 commits into
mainfrom
docs/arc-008-doc-semver-tag-sync

Conversation

@WouterDeBot
Copy link
Copy Markdown
Owner

Summary

This PR synchronises all documentation with the v0.4.0 feature set (6-component CAH, config schema v2, bootstrap_signals), bumps the package version, and prepares local annotated git tags for operator push.

Changes

Release mechanics

  • pyproject.toml — version 0.3.10.4.0 (was lagging behind CHANGELOG)
  • src/agentrepocoach/__init__.pyVERSION constant 0.3.10.4.0
  • CHANGELOG.md — fix [Unreleased] link (v0.3.0...HEADv0.4.0...HEAD); add [0.4.0] and [0.3.1] reference links

README

  • README.md — update configuration example from v1 schema (old 5-weight, no schema_version) to v2 schema (schema_version = 2, 6 weights at 0.22/0.22/0.18/0.13/0.13/0.12); add [bootstrap_signals] config snippet; add v1→v2 migration note

Documentation — fixed stale content

  • docs/METHODOLOGY.md — "5 components" → 6; formula 25/25/20/15/15 → 22/22/18/13/13/12; add Component 6 (Bootstrap signals) section; update Configuration section for schema v2
  • docs/scoring.md — same formula/count fix; add Component 6 section; update JSON report example to schema_version 2 with 6 components
  • docs/getting-started.md — fix sample output (5 lines → 6 lines at new weights); add agentrepocoach . positional form; add --all-languages example
  • docs/faq.md — fix language table: TypeScript/Rust/Go were listed as "Stub", they are Full MVP since v0.2.0
  • docs/index.md — fix component table: 5→6 components, old 25%/25%/20%/15%/15% → 22%/22%/18%/13%/13%/12%
  • docs/architecture.md — fix "five component scores" → six; add bootstrap_signals.py to data flow diagram and module table
  • docs/cli-manifest.json — bump version 0.1.0→0.4.0; add --all-languages flag; add positional path argument; fix --language choices (alphabetical, complete set)
  • docs/codebase-map.md — fix five→six component references; add bootstrap_signals.py to components table; expand test file listing (was missing 7 test files)
  • MARKETPLACE-LISTING.md — fix 5→6 components with new weights; update action tag @v0.2.0@v1
  • AGENTS.md — add bootstrap_signals.py and config.py schema note to key entry points

Verified no changes needed

Test results

155 passed in 0.35s

Dogfood run

agentrepocoach --repo . --verbose
Total score: 95.32 / 100 (no schema errors, bootstrap_signals = 100/100)

Tag handoff for operator (do NOT push tags yourself)

Local annotated tags created on main — ready for git push origin v0.3.1 v0.4.0:

Tag Target commit Tag object SHA Message
v0.3.1 edc7b9e 026d025f7b48b105978e44e6ba956cc82daadfd9 v0.3.1 — hot-fix: --all-languages flag, corrected --language help text, positional path support
v0.4.0 f90aa71 71c4a21d75dc19ca9a51dc1eacf86a60d283a919 v0.4.0 — CI-Signal + README-quality bootstrap_signals component (6th); config schema v2; weight rebalance

Operator escalation checklist (after CI greens)

  1. git push origin v0.3.1 v0.4.0 — push the two annotated tags
  2. gh release create v0.4.0 --title "v0.4.0 — Bootstrap signals (CI-Signal + README-quality)" --notes-from-tag — create GitHub release
  3. python -m build && twine upload dist/* — upload to PyPI (currently at v0.3.0)

🤖 Generated with Claude Code (Sonnet 4.6)

- pyproject.toml: version 0.3.1 → 0.4.0 (was lagging behind CHANGELOG)
- CHANGELOG.md: fix [Unreleased] link (v0.3.0→HEAD → v0.4.0→HEAD)
- CHANGELOG.md: add [0.4.0] and [0.3.1] reference links
v1 example (no schema_version, old weights 0.25/0.25/0.20/0.15/0.15)
would cause an 'Unsupported schema_version' error for v0.4.0 users.

- Add schema_version = 2
- Update weights to 0.22/0.22/0.18/0.13/0.13/0.12 (sum = 1.0)
- Add bootstrap_signals weight and optional [bootstrap_signals] section
- Add migration note linking to docs/configuration.md
- Fix section title: "Why these 5 components?" → 6 components
- Update composite formula to 22/22/18/13/13/12 weights
- Fix component headings from old pts (25/25/20/15/15) to new (22/22/18/13/13)
- Add Component 6 — Bootstrap signals (12 pts) with CI-Signal + README-quality sub-components
- Update "How weights were chosen" rationale to include bootstrap_signals
- Update Configuration section to reference schema_version = 2
- Fix "five components" → six
- Update composite formula to 22/22/18/13/13/12 weights
- Fix component section headings (25%/25%/20%/15%/15% → correct %)
- Add Component 6 — Bootstrap signals (12%) with CI-Signal + README-quality
- Update "Why these weights?" rationale to include bootstrap_signals
- Update JSON example to schema_version 2 with 6 components
…nguages

- Update sample output table to show 6 components with v0.4.0 weights
- Add positional path form (agentrepocoach .) to CLI examples
- Add --all-languages flag example
…Full MVP

These three adapters shipped in v0.2.0 but the FAQ still listed them as "Stub".
Update Jekyll landing page from 5-component/old-weights to 6-component/22/22/18/13/13/12.
…signals.py

Update architecture doc data flow diagram and module descriptions for v0.4.0
6th component (bootstrap_signals).
…x language choices

- version: 0.1.0 → 0.4.0
- Add positional `path` argument (shorthand for --repo)
- Add --all-languages flag
- Fix --language choices order (alphabetical: csharp|go|python|rust|typescript)
- Fix five→six component references in production package description
- Add bootstrap_signals.py to components table
- Expand test file listing to include all current test modules (was missing 7 files)
…g v0.2.0→v1

- Update long description from 5 to 6 components with v0.4.0 weights
- Add bootstrap_signals bullet
- Fix action quick-start tag from @v0.2.0 to @v1 (consistent with README)
…ma_version = 2

Update AGENTS.md for v0.4.0: six components, schema v2 requirement.
VERSION constant was hardcoded in __init__.py (separate from pyproject.toml).
Both must match for --version to report correctly.
@github-actions
Copy link
Copy Markdown

AgentRepoCoach -- Score Comparison

Total: 95.32 -> 95.32 (+0.00) =

Component Base PR Delta
navigability 100.00 100.00 +0.00 =
error_quality 80.00 80.00 +0.00 =
decision_queryability 100.00 100.00 +0.00 =
test_quality 97.82 97.82 +0.00 =
module_hygiene 100.00 100.00 +0.00 =
bootstrap_signals 100.00 100.00 +0.00 =

Top recommendations

  1. Generic exceptions dominate (error_quality) -- Reduce use of bare Exception/Error throws. Wrap them in domain types so agents can match on specific error categories.
  2. Test names lack structure (test_quality) -- Use descriptive test names that encode the scenario and expectation (e.g., test_doWork_negativeInput_returnsError). Agents use test names to understand intended behavior.

@WouterDeBot WouterDeBot merged commit d5ef38e into main May 26, 2026
6 checks passed
@WouterDeBot WouterDeBot deleted the docs/arc-008-doc-semver-tag-sync branch May 26, 2026 10:03
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