Skip to content

chore: matrix sync + docker/score docs refresh#109

Merged
brettdavies merged 2 commits into
devfrom
chore/matrix-sync-and-docker-notes
May 21, 2026
Merged

chore: matrix sync + docker/score docs refresh#109
brettdavies merged 2 commits into
devfrom
chore/matrix-sync-and-docker-notes

Conversation

@brettdavies
Copy link
Copy Markdown
Owner

Summary

Bundle two small standalone changes that fell out of the v0.4.0 rescore + scoring-fairness session: stale docker/score docs pointing at a long-dead "build anc from local checkout" workflow, and a refresh of the vendored coverage-matrix.json picking up the CLI's new p3-version requirement split.

Changelog

Changed

  • Sync src/data/coverage-matrix.json from agentnative-cli; adds p3-must-version (MUST) and p3-should-version-short (SHOULD), both verified via the existing p3-version behavioral probe.

Documentation

  • Refresh docker/score/compose.yml header comment and scripts/SYNCS.md row 2 plus step 2 to describe the brew-install path the Dockerfile actually uses. Prior wording claimed build.sh built anc from a local CLI checkout, which stopped being true when the image switched to brew install brettdavies/tap/agentnative at build time.

Type of Change

  • feat: New feature (non-breaking change which adds functionality)
  • fix: Bug fix (non-breaking change which fixes an issue)
  • refactor: Code refactoring (no functional changes)
  • perf: Performance improvement
  • docs: Documentation update
  • test: Adding or updating tests
  • chore: Maintenance tasks (dependencies, config, etc.)
  • ci: CI/CD configuration changes
  • style: Code style/formatting changes
  • build: Build system changes
  • BREAKING CHANGE: Breaking API change (requires major version bump)

Related Issues/Stories

  • Story: n/a
  • Issue: n/a
  • Architecture: docs/plans/2026-05-21-001-feat-scorecard-fairness-taxonomy-plan.md (the fairness plan that surfaced both diffs as side effects; not gated on this PR)
  • Related PRs: n/a

Testing

  • Unit tests added/updated
  • Integration tests added/updated
  • Manual testing completed
  • All tests passing

Test Summary:

  • bun test green via pre-push hook
  • bun run build green via pre-push hook
  • wrangler deploy --dry-run green via pre-push hook
  • bash scripts/prose-check.sh 0 blocking
  • The matrix-sync delta is a literal copy of the CLI's working-tree coverage/matrix.json; the CLI's own CI enforces matrix integrity against its registry, the site trusts the synced bytes per scripts/SYNCS.md row 1.

Files Modified

Modified:

  • docker/score/compose.yml (header comment refresh)
  • scripts/SYNCS.md (row 2 + step 2 prose refresh)
  • src/data/coverage-matrix.json (vendored from agentnative-cli; adds p3-must-version + p3-should-version-short rows)

Created:

  • None.

Renamed:

  • None.

Deleted:

  • None.

Breaking Changes

  • No breaking changes

Deployment Notes

  • No special deployment steps required

Additional Context

This branch was originally scoped as feat/rescore-v0.4.0 for the v0.4.0 rescore PR; that work is now parked until the scoring algorithm change ships per the fairness plan. The docker docs-refresh and the matrix sync are the two independently-useful diffs that came out of the session, so they ride together on this rename.

Stale wording in compose.yml header and SYNCS.md row 2 / step 2 claimed
the wrapper script "builds anc from the local CLI checkout." That stopped
being true when the Dockerfile switched to `brew install
brettdavies/tap/agentnative` (Dockerfile §"The anc binary"). Both
README.md and build.sh already documented the brew path; only these two
sources still pointed at the obsolete local-cargo flow.

Behavior unchanged; this just syncs the prose to what the code already does
before the v0.4.0 rescore.
Adds two new requirement rows that the CLI surfaced via the
p3-version probe split:

  - p3-must-version           (MUST: --version prints non-empty + exits 0)
  - p3-should-version-short   (SHOULD: short alias -V/-v accompanies)

Both rows reference the same `p3-version` check_id, the first concrete
case of the multi-tier shared-probe pattern the fairness plan handles
under Decision 2c (one result per requirement row).

Synced via `bash scripts/sync-coverage-matrix.sh` from
~/dev/agentnative-cli/coverage/matrix.json. Per the cross-repo policy
in scripts/SYNCS.md row 1, the CLI's own CI enforces matrix integrity
against the registry; the site trusts the synced bytes.
@brettdavies brettdavies enabled auto-merge (squash) May 21, 2026 21:58
@brettdavies brettdavies merged commit 680a3a3 into dev May 21, 2026
2 checks passed
@brettdavies brettdavies deleted the chore/matrix-sync-and-docker-notes branch May 21, 2026 21:58
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