All notable changes to this repository will be documented in this file.
The format is based on Keep a Changelog, and this project follows SemVer for bundle versions.
- Documentation: authoritative
docs/reference/documentation-url-contract.mdfor core vs modules URL ownership;redirect_fromaliases for legacy/guides/<basename>/on pages whose canonical path is outside/guides/; sidebar link to the contract page. - Add expanded clean-code review coverage to
specfact-code-review, including naming, KISS, YAGNI, DRY, SOLID, and PR-checklist findings plus the bundledspecfact/clean-code-principlespolicy-pack payload.
- Refresh the canonical
specfact-code-reviewhouse-rules skill to a compact clean-code charter and bump the bundle metadata for the signed 0.45.1 release. - Document CI module verification:
pr-orchestratorPR checks runverify-modules-signaturewith--payload-from-filesystem --enforce-version-bumpand omit--require-signatureby default;--require-signatureis enforced when the target ismain(including pushes tomain).sign-modules.pyin approval workflows continues to use--payload-from-filesystem. Sign bundled manifests before merging release PRs or address post-merge verification failures by re-signing and bumping versions as required.
- Add
--scope changed|fulland repeatable repo-relative--pathfilters tospecfact code review runfor deterministic changed-only, full-repository, and subtree-limited review selection.
- Keep changed-only auto-discovery as the default, allow explicit test subtrees to opt matching tests back into scope, and extend the review-run docs plus cli-contract scenarios to cover the new targeting controls.
- Add the fully wired
specfact code review runcommand with JSON, score-only, fix, and git-diff default file discovery behavior. - Add clean and dirty review fixtures, end-to-end command tests, and
cli-contract scenario YAML files for the review
run,ledger, andrulescommand groups.
- Extend the code-review module docs with review-run usage, output, exit-code, and piping examples.
- Add a repo-local CLI contract schema validator and bump the signed
specfact-code-reviewbundle metadata for the new command integration.
- Add
specfact code review rules show|init|updateto manage a generatedskills/specfact-code-review/SKILL.mdhouse-rules skill from recent ledger history.
- Document the house-rules workflow, including the 35-line skill budget and the
optional
.cursor/rules/house_rules.mdcmirror updated from ledger data.
- Add a
specfact-code-reviewreward ledger with Supabase-first persistence, local JSON fallback, andledger update|status|resetcommands underspecfact code review.
- Document the new ledger workflow, including the review-report pipe and the offline fallback path used when Supabase is not configured.
- Add
contract_runnerand review orchestration helpers tospecfact-code-review, including icontract AST checks, CrossHair fast-pass handling, and a TDD gate for missing tests or low coverage.
- Extend the code-review bundle docs with contract/TDD gate behavior and bump the signed
specfact-code-reviewbundle metadata for the new runner set.
- Add
basedpyrightandpylintreview runners tospecfact-code-reviewfor governed type-safety and architecture findings.
- Document the new code-review tool runners and bump the
specfact-code-reviewbundle patch version for the signed module update.