diff --git a/CHANGELOG.md b/CHANGELOG.md index ed076e03..56cfee88 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,29 @@ All notable changes to this project will be documented in this file. --- +## [0.33.0] - 2026-02-17 + +### Added + +- New `policy-engine` module package with lazy-loaded `specfact policy` command group. +- `specfact policy validate` for deterministic policy evaluation with hard failures and dual output (`json`, `markdown`, or `both`). +- `specfact policy suggest` for confidence-scored, patch-ready suggestions with explicit no-auto-write behavior. +- Policy configuration loader for `.specfact/policy.yaml` supporting Scrum DoR/DoD fields, Kanban column entry/exit requirements, and SAFe PI readiness fields. +- Integration tests for policy commands in `tests/integration/commands/test_policy_engine_commands.py` with recorded TDD evidence. + +### Changed + +- Updated Agile/Scrum and DevOps adapter integration guides with policy engine command usage and workflow guidance. +- `specfact policy validate` and `specfact policy suggest` now apply `--limit` to backlog item group count when `--group-by-item` is enabled (instead of truncating sub-item findings/suggestions). +- Grouped-mode policy output now avoids duplicate top-level flat arrays and emits grouped payloads with summary metadata for cleaner consumption. +- Policy command docs and OpenSpec change artifacts were updated to document grouped-limit semantics and grouped output behavior. + +### Fixed + +- Resolved type-check errors in `policy_engine/main.py` by introducing typed grouped payload structures and explicit payload typing. + +--- + ## [0.32.1] - 2026-02-17 ### Added diff --git a/README.md b/README.md index 616f09a6..d24dcb5f 100644 --- a/README.md +++ b/README.md @@ -113,6 +113,18 @@ Most tools help **either** coders **or** agile teams. SpecFact does both: Recommended command entrypoints: - `specfact backlog ceremony standup ...` - `specfact backlog ceremony refinement ...` +- `specfact policy validate ...` +- `specfact policy suggest ...` + +What the Policy Engine does in practice: +- Turns team agreements (DoR, DoD, flow checks) into executable checks against your real backlog data. +- Shows exactly what is missing per item (for example missing acceptance criteria or definition of done). +- Generates patch-ready suggestions so teams can fix policy gaps quickly without guessing. + +Start with: +- `specfact policy init --template scrum` +- `specfact policy validate --group-by-item` +- `specfact policy suggest --group-by-item --limit 5` **Try it now** @@ -221,6 +233,7 @@ SpecFact complements your stack rather than replacing it. - **[Backlog Refinement](docs/guides/backlog-refinement.md)** - **[Backlog Dependency Analysis](docs/guides/backlog-dependency-analysis.md)** - **[Backlog Delta Commands](docs/guides/backlog-delta-commands.md)** +- **[Policy Engine Commands](docs/guides/policy-engine-commands.md)** - **[Project DevOps Flow](docs/guides/project-devops-flow.md)** - **[Sidecar Validation](docs/guides/sidecar-validation.md)** - **[OpenSpec Journey](docs/guides/openspec-journey.md)** diff --git a/docs/README.md b/docs/README.md index fdf2c754..d63c6682 100644 --- a/docs/README.md +++ b/docs/README.md @@ -22,6 +22,18 @@ Most tools help **either** coders **or** agile teams. SpecFact does both: Recommended command entrypoints: - `specfact backlog ceremony standup ...` - `specfact backlog ceremony refinement ...` +- `specfact policy validate ...` +- `specfact policy suggest ...` + +What the Policy Engine does in practice: +- Converts team working agreements (DoR, DoD, flow/PI readiness) into deterministic checks. +- Flags exact policy gaps per backlog item with actionable evidence pointers. +- Produces patch-ready suggestions so teams can remediate quickly. + +Start with: +- `specfact policy init --template scrum` +- `specfact policy validate --group-by-item` +- `specfact policy suggest --group-by-item --limit 5` **Try it now** @@ -109,6 +121,7 @@ For implementation details, see: - [Backlog Refinement](guides/backlog-refinement.md) - [Backlog Dependency Analysis](guides/backlog-dependency-analysis.md) - [Backlog Delta Commands](guides/backlog-delta-commands.md) +- [Policy Engine Commands](guides/policy-engine-commands.md) - [Project DevOps Flow](guides/project-devops-flow.md) - [DevOps Adapter Integration](guides/devops-adapter-integration.md) - [AI IDE Workflow](guides/ai-ide-workflow.md) diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html index 6446c6ce..03f5aa2f 100644 --- a/docs/_layouts/default.html +++ b/docs/_layouts/default.html @@ -141,6 +141,7 @@