contract-driven-delivery 1.10.0 → 1.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +72 -0
- package/README.md +532 -135
- package/assets/CLAUDE.template.md +34 -0
- package/assets/CODEX.template.md +39 -0
- package/assets/agents/backend-engineer.md +15 -0
- package/assets/agents/change-classifier.md +57 -1
- package/assets/agents/ci-cd-gatekeeper.md +15 -0
- package/assets/agents/contract-reviewer.md +15 -0
- package/assets/agents/dependency-security-reviewer.md +2 -0
- package/assets/agents/e2e-resilience-engineer.md +15 -0
- package/assets/agents/frontend-engineer.md +15 -0
- package/assets/agents/monkey-test-engineer.md +15 -0
- package/assets/agents/qa-reviewer.md +15 -0
- package/assets/agents/repo-context-scanner.md +2 -0
- package/assets/agents/spec-architect.md +15 -0
- package/assets/agents/spec-drift-auditor.md +2 -0
- package/assets/agents/stress-soak-engineer.md +15 -0
- package/assets/agents/test-strategist.md +15 -0
- package/assets/agents/ui-ux-reviewer.md +2 -0
- package/assets/agents/visual-reviewer.md +2 -0
- package/assets/cdd/context-policy.json +25 -0
- package/assets/cdd/model-policy.json +5 -0
- package/assets/contracts/api/api-contract.md +3 -0
- package/assets/contracts/api/api-inventory.md +7 -0
- package/assets/contracts/api/error-format.md +7 -0
- package/assets/contracts/business/business-rules.md +3 -0
- package/assets/contracts/ci/ci-gate-contract.md +3 -0
- package/assets/contracts/css/css-contract.md +3 -0
- package/assets/contracts/css/design-tokens.md +7 -0
- package/assets/contracts/data/data-shape-contract.md +3 -0
- package/assets/contracts/env/env-contract.md +3 -0
- package/assets/hooks/pre-commit +1 -1
- package/assets/skills/cdd-close/SKILL.md +150 -0
- package/assets/skills/cdd-new/SKILL.md +94 -35
- package/assets/skills/cdd-resume/SKILL.md +114 -0
- package/assets/skills/contract-driven-delivery/templates/change-classification.md +9 -8
- package/assets/skills/contract-driven-delivery/templates/tasks.md +7 -0
- package/assets/specs-templates/change-classification.md +9 -8
- package/assets/specs-templates/context-manifest.md +49 -0
- package/assets/specs-templates/tasks.md +9 -0
- package/dist/cli/index.js +1846 -152
- package/docs/release-checklist.md +39 -0
- package/package.json +12 -6
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## [1.12.0] - 2026-04-29
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
- `cdd-kit doctor --json` for CI and machine-readable repository health checks.
|
|
7
|
+
- `cdd-kit upgrade --migrate-changes [--enable-context-governance]` to combine repo-level upgrade work with legacy change migration.
|
|
8
|
+
- `cdd-kit context request`, `cdd-kit context reject`, and `cdd-kit context list [--json]` for a fuller context expansion workflow.
|
|
9
|
+
|
|
10
|
+
### Changed
|
|
11
|
+
- Default contract templates now include deterministic `summary`, `owner`, and `surface` metadata so fresh repos do not start with avoidable `contracts-index` warnings.
|
|
12
|
+
- `cdd-kit context-scan` now excludes `contracts/CHANGELOG.md` from the contracts index.
|
|
13
|
+
- Shared provider inference is now reused by `update`, `doctor`, and `upgrade`.
|
|
14
|
+
- Migration messaging now refers to the current cdd-kit format instead of pinning docs to one release number.
|
|
15
|
+
|
|
16
|
+
### Docs
|
|
17
|
+
- README now includes production rollout guidance for old repos, with separate migration paths for completed specs and in-progress specs.
|
|
18
|
+
- Release checklist now covers `doctor --json`, `upgrade --migrate-changes`, and post-upgrade context governance decisions.
|
|
19
|
+
|
|
20
|
+
## [1.11.0] - 2026-04-28
|
|
21
|
+
|
|
22
|
+
### Added
|
|
23
|
+
- Context Governance v1 for new changes: `context-manifest.md`, `files-read` audit expectations, default forbidden paths, and legacy-vs-new gate behavior.
|
|
24
|
+
- Provider adapter scaffold for Claude Code and Codex: `init --provider claude|codex|both`, provider-aware `update`, and `.cdd/model-policy.json`.
|
|
25
|
+
- `cdd-kit context-scan`: deterministic `specs/context/project-map.md` and `specs/context/contracts-index.md` indexes for lower-token classification.
|
|
26
|
+
- `cdd-kit doctor`: repo health checks for missing config, provider guidance, stale context indexes, and contract summary gaps.
|
|
27
|
+
- `cdd-kit upgrade`: dry-run-first repo-level upgrade command that adds missing cdd-kit files without overwriting existing project guidance or contracts.
|
|
28
|
+
- `cdd-kit context approve <change-id> <request-id>`: approves pending expansion requests and records approved paths in the manifest.
|
|
29
|
+
- Atomic change dependencies with `cdd-kit new --depends-on` and gate blocking until upstream changes complete or archive.
|
|
30
|
+
- `/cdd-new`, `/cdd-resume`, and `/cdd-close` prompt hardening for manifest-scoped reads, hot/warm/cold data handling, and context index usage.
|
|
31
|
+
|
|
32
|
+
### Changed
|
|
33
|
+
- `cdd-kit migrate` can add legacy or context-governed manifests and opt old changes into `context-governance: v1`.
|
|
34
|
+
- README now describes provider-neutral usage, context governance, upgrade flow, and context expansion approval.
|
|
35
|
+
|
|
36
|
+
### Notes
|
|
37
|
+
- Context Governance audits and discourages unauthorized reads. It is not a runtime sandbox and still depends on agent-log evidence plus gate review.
|
|
38
|
+
|
|
39
|
+
## [1.10.0] - 2026-04-27
|
|
40
|
+
|
|
41
|
+
### Added
|
|
42
|
+
- `cdd-kit gate --strict`: pending `[ ]` tasks are errors in strict mode; pre-commit hook now uses `--strict` by default. Section-7 archive tasks (7.1, 7.2) are exempt.
|
|
43
|
+
- `cdd-kit gate`: artifact pointer validation in strict mode. Each path listed under `- artifacts:` in agent logs is verified to exist on disk.
|
|
44
|
+
- `cdd-kit gate`: tier-based agent-log requirements. Tier 0-1 changes must have `e2e-resilience-engineer`, `monkey-test-engineer`, and `stress-soak-engineer` logs; Tier 0-3 must have `contract-reviewer` and `qa-reviewer`.
|
|
45
|
+
- `cdd-kit gate`: differentiated minimum char counts per artifact (change-classification and test-plan >= 200, ci-gates >= 150, others >= 100).
|
|
46
|
+
- `cdd-kit gate`: scoped validate call to `--contracts --env --ci --versions`.
|
|
47
|
+
- `cdd-kit abandon <change-id> --reason <text>`: marks a change as abandoned in `tasks.md` and records it in `specs/archive/INDEX.md`.
|
|
48
|
+
- `cdd-kit archive <change-id>`: moves a completed change from `specs/changes/` to `specs/archive/<year>/`.
|
|
49
|
+
- `/cdd-close` skill synthesizes `archive.md` from `agent-log/` and `qa-report.md` before archiving, then invokes `contract-reviewer` for durable promotion diffs.
|
|
50
|
+
- `/cdd-resume` resumes an in-progress change across sessions by reading `tasks.md` and `agent-log/` to determine the next pending agent.
|
|
51
|
+
- `change-classifier` now outputs `## Inferred Acceptance Criteria` and `## Tasks Not Applicable`.
|
|
52
|
+
- All agents require `CURRENT_CHANGE_ID: <id>` in every prompt.
|
|
53
|
+
- `cdd-new` injects `CURRENT_CHANGE_ID` into every agent call, auto-marks N/A tasks with `[-]`, and passes acceptance criteria to `test-strategist`.
|
|
54
|
+
- `cdd-kit migrate <change-id> | --all [--dry-run]`: upgrades existing change directories from pre-v1.11 format. Adds YAML frontmatter plus `[x]/[-]/[ ]` legend to `tasks.md`; converts old `**Tier:** Tier N` to `## Tier\n- N`.
|
|
55
|
+
|
|
56
|
+
### Fixed
|
|
57
|
+
- Tier detection regex tightened to avoid matching unfilled classifier templates.
|
|
58
|
+
- Agent read-scope placeholder `<current-change-id>` replaced with runtime `CURRENT_CHANGE_ID` injection.
|
|
59
|
+
- `archive.md` removed from `/cdd-new` opt-in surface because it is synthesized at close time.
|
|
60
|
+
|
|
61
|
+
## [1.0.1] - 2026-04-20
|
|
62
|
+
|
|
63
|
+
### Fixed
|
|
64
|
+
- CLI binary renamed from `cdd` to `cdd-kit` for npm uniqueness.
|
|
65
|
+
- Corrected bin path format for npm 11.x compatibility.
|
|
66
|
+
|
|
67
|
+
## [1.0.0] - 2026-04-20
|
|
68
|
+
|
|
69
|
+
### Added
|
|
70
|
+
- Initial release of the contract-driven-delivery CLI (`cdd-kit`).
|
|
71
|
+
- Commands: `init`, `new`, `gate`, `validate`, `detect-stack`.
|
|
72
|
+
- Tier-based change classification, contract scaffolding, and agent-log validation.
|