@trieungoctam/speckit 0.1.0 → 0.2.2
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/README.md +16 -1
- package/dist/adapters/antigravity-adapter.js +5 -5
- package/dist/adapters/claude-code-adapter.js +8 -5
- package/dist/adapters/codex-adapter.js +5 -3
- package/dist/adapters/cursor-adapter.js +6 -3
- package/dist/adapters/opencode-adapter.js +1 -0
- package/dist/adapters/tool-checks.js +0 -1
- package/dist/cli.js +24 -2
- package/dist/commands/close.d.ts +6 -0
- package/dist/commands/close.js +34 -0
- package/dist/commands/context.d.ts +6 -0
- package/dist/commands/context.js +87 -0
- package/dist/commands/doctor.d.ts +1 -0
- package/dist/commands/doctor.js +29 -1
- package/dist/commands/init.d.ts +1 -0
- package/dist/commands/init.js +5 -3
- package/dist/commands/plan.js +19 -2
- package/dist/commands/quick.js +20 -2
- package/dist/commands/ready.d.ts +7 -0
- package/dist/commands/ready.js +20 -0
- package/dist/commands/run.js +19 -24
- package/dist/commands/start.d.ts +6 -0
- package/dist/commands/start.js +47 -0
- package/dist/commands/sync.js +2 -8
- package/dist/commands/triage.d.ts +6 -0
- package/dist/commands/triage.js +33 -0
- package/dist/core/readiness.d.ts +13 -0
- package/dist/core/readiness.js +120 -0
- package/dist/core/scaffold.d.ts +1 -0
- package/dist/core/scaffold.js +107 -2
- package/dist/core/story.d.ts +13 -0
- package/dist/core/story.js +67 -0
- package/docs/development-roadmap.md +8 -7
- package/docs/product-contract.md +5 -5
- package/docs/project-changelog.md +67 -1
- package/docs/release-checklist.md +2 -2
- package/docs/spec-enterprise-harness-plan.md +68 -0
- package/docs/spec-quality-gates.md +70 -0
- package/docs/system-architecture.md +1 -1
- package/package.json +1 -1
|
@@ -1,7 +1,72 @@
|
|
|
1
1
|
# Project Changelog
|
|
2
2
|
|
|
3
|
+
## 0.2.2 - 2026-05-10
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
|
|
7
|
+
- Added `speckit ready <story>` readiness gate.
|
|
8
|
+
- Added status frontmatter to generated stories, evidence files, and current context.
|
|
9
|
+
- Added `.speckit/context/subagent-handoff.md` generation from story context.
|
|
10
|
+
- Added anti-mistake checklist sections to story and context artifacts.
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- `speckit run <story>` now refuses blocked stories until readiness checks pass.
|
|
15
|
+
- Prompt contracts now require readiness status, fresh context, and subagent handoff.
|
|
16
|
+
|
|
17
|
+
### Quality
|
|
18
|
+
|
|
19
|
+
- Added readiness and blocked-run tests.
|
|
20
|
+
- Expanded prompt quality tests for readiness and subagent handoff.
|
|
21
|
+
- `npm test` passes with 26 tests.
|
|
22
|
+
|
|
23
|
+
## 0.2.1 - 2026-05-10
|
|
24
|
+
|
|
25
|
+
### Changed
|
|
26
|
+
|
|
27
|
+
- Strengthened generated prompts across Claude Code, Codex, Antigravity, OpenCode, Cursor, and the enterprise run prompt.
|
|
28
|
+
- Made prompt contracts explicitly require current context, acceptance criteria, session handoff, red-green-refactor evidence, and robot-safe graph commands.
|
|
29
|
+
|
|
30
|
+
### Quality
|
|
31
|
+
|
|
32
|
+
- Added prompt quality tests covering enterprise prompts, IDE adapter prompts, and tracked generated prompt files.
|
|
33
|
+
- `npm test` passes with 24 tests.
|
|
34
|
+
|
|
35
|
+
## 0.2.0 - 2026-05-10
|
|
36
|
+
|
|
37
|
+
### Added
|
|
38
|
+
|
|
39
|
+
- Added enterprise harness generation with `speckit init --enterprise`.
|
|
40
|
+
- Added deep harness verification with `speckit doctor --deep`.
|
|
41
|
+
- Added linked flow commands: `start`, `context`, `triage`, and `close`.
|
|
42
|
+
- Added quality gates for Speckit-only vocabulary, flow linkage, adapter parity, and robot-safe graph commands.
|
|
43
|
+
|
|
44
|
+
### Validation
|
|
45
|
+
|
|
46
|
+
- `npm run lint` passes.
|
|
47
|
+
- `npm test` passes with 21 tests.
|
|
48
|
+
- `npm pack --dry-run` passes.
|
|
49
|
+
- Full enterprise temp flow passes: `init --enterprise -> start -> quick -> context -> sync -> triage -> close -> doctor --deep`.
|
|
50
|
+
|
|
51
|
+
### Published
|
|
52
|
+
|
|
53
|
+
- Published `@trieungoctam/speckit@0.2.0` to npm with `latest` dist-tag.
|
|
54
|
+
|
|
3
55
|
## 2026-05-10
|
|
4
56
|
|
|
57
|
+
### Changed
|
|
58
|
+
|
|
59
|
+
- Migrated product vocabulary to Speckit-only workflow language.
|
|
60
|
+
- Added Spec Enterprise Harness planning and quality gates.
|
|
61
|
+
- Removed legacy workflow runtime checks from `speckit doctor`.
|
|
62
|
+
- Added enterprise flow commands for session start, story context, graph triage, and closure.
|
|
63
|
+
|
|
64
|
+
### Quality
|
|
65
|
+
|
|
66
|
+
- Added forbidden vocabulary regression test.
|
|
67
|
+
- Added Spec flow contract tests for TDD linkage, adapter parity, and robot-safe graph commands.
|
|
68
|
+
- Added end-to-end command tests for `start`, `context`, `triage`, and `close`.
|
|
69
|
+
|
|
5
70
|
### Added
|
|
6
71
|
|
|
7
72
|
- Created Speckit TypeScript CLI package.
|
|
@@ -9,6 +74,7 @@
|
|
|
9
74
|
- Added GitHub repository metadata for `trieungoctam/speckit`.
|
|
10
75
|
- Added GitHub Actions CI for lint, test, and package dry-run checks.
|
|
11
76
|
- Added `init`, `doctor`, `shape`, `quick`, `plan`, `next`, `sync`, `run`, and `review` commands.
|
|
77
|
+
- Added `init --enterprise`, `doctor --deep`, `start`, `context`, `triage`, and `close` commands.
|
|
12
78
|
- Added managed-file generation with overwrite protection.
|
|
13
79
|
- Added native adapter generation for Claude Code, Codex, Antigravity, OpenCode, and Cursor.
|
|
14
80
|
- Added Beads Viewer-safe `next` command using robot mode only.
|
|
@@ -21,7 +87,7 @@
|
|
|
21
87
|
- `bin/speckit init --ide all` works in a temporary directory.
|
|
22
88
|
- `npm run build` passes.
|
|
23
89
|
- `npm run lint` passes.
|
|
24
|
-
- `npm test` passes with
|
|
90
|
+
- `npm test` passes with 21 tests.
|
|
25
91
|
- `npm pack --dry-run` passes.
|
|
26
92
|
|
|
27
93
|
### Published
|
|
@@ -12,9 +12,9 @@ Before publishing Speckit:
|
|
|
12
12
|
- [x] Adapter output paths match `docs/adapters.md`.
|
|
13
13
|
- [x] Cursor output uses `.cursor/rules/*.mdc`, not `.cursorrules`.
|
|
14
14
|
- [x] `speckit next` only invokes `bv --robot-*`.
|
|
15
|
-
- [ ] License and attribution review is complete for
|
|
15
|
+
- [ ] License and attribution review is complete for Speckit, Speckit Method, and Beads Viewer inspiration.
|
|
16
16
|
- [x] README quickstart is accurate.
|
|
17
17
|
- [x] No secrets, local credentials, or generated private data are included.
|
|
18
18
|
- [x] Initial code pushed to `git@github.com:trieungoctam/speckit.git`.
|
|
19
|
-
- [
|
|
19
|
+
- [x] npm package published.
|
|
20
20
|
- [ ] GitHub trusted publishing configured for npm releases.
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
# Spec Enterprise Harness Plan
|
|
2
|
+
|
|
3
|
+
## Goal
|
|
4
|
+
|
|
5
|
+
Speckit Enterprise must behave like one coherent Spec system, not a bundle of unrelated prompts.
|
|
6
|
+
|
|
7
|
+
The product vocabulary is Spec-only. External tools may exist underneath, but generated prompts, docs, commands, sessions, context packs, and adapter outputs must speak Speckit terms.
|
|
8
|
+
|
|
9
|
+
## Operating Model
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
idea
|
|
13
|
+
-> spec start
|
|
14
|
+
-> spec shape
|
|
15
|
+
-> spec plan
|
|
16
|
+
-> spec context
|
|
17
|
+
-> graph triage
|
|
18
|
+
-> spec run
|
|
19
|
+
-> spec review
|
|
20
|
+
-> spec close
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## Harness Layers
|
|
24
|
+
|
|
25
|
+
| Layer | Responsibility | Required Output |
|
|
26
|
+
| --- | --- | --- |
|
|
27
|
+
| Spec Flow | Phase order and state transitions | `.speckit/flows/*.md` |
|
|
28
|
+
| Spec Prompt | Phase-specific instructions | `.speckit/prompts/**/*.md` |
|
|
29
|
+
| Spec Session | Durable continuity across agents | `.speckit/sessions/<id>/*` |
|
|
30
|
+
| Spec Context | Bounded task context | `.speckit/context/current.md` |
|
|
31
|
+
| Spec Tool | Phase-aware allowed/denied actions | `.speckit/tool-policy.yaml` |
|
|
32
|
+
| Spec Graph | Work queue and priority bridge | `.speckit/graph/*` |
|
|
33
|
+
| IDE Compiler | Native adapter generation | IDE-specific config files |
|
|
34
|
+
|
|
35
|
+
## Command Contract
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
speckit init --enterprise --ide all
|
|
39
|
+
speckit doctor --deep
|
|
40
|
+
speckit start "<idea>"
|
|
41
|
+
speckit shape "<idea>"
|
|
42
|
+
speckit plan "<feature>"
|
|
43
|
+
speckit context <story-or-bead>
|
|
44
|
+
speckit triage
|
|
45
|
+
speckit next
|
|
46
|
+
speckit run <story-or-bead>
|
|
47
|
+
speckit review
|
|
48
|
+
speckit close <story-or-bead>
|
|
49
|
+
speckit sync
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Quality Gates
|
|
53
|
+
|
|
54
|
+
- Forbidden legacy vocabulary must not appear in publishable source, docs, tests, prompts, or generated adapter templates.
|
|
55
|
+
- Every implementation story must link to acceptance criteria and TDD evidence.
|
|
56
|
+
- Every run must have a session handoff.
|
|
57
|
+
- Every graph task must trace back to a story or spec artifact.
|
|
58
|
+
- Every review must check AC coverage, TDD evidence, tool policy, and docs impact.
|
|
59
|
+
- All robot task graph commands must use non-interactive flags.
|
|
60
|
+
|
|
61
|
+
## Definition Of Enterprise Ready
|
|
62
|
+
|
|
63
|
+
- `speckit init --enterprise --ide all` creates a complete harness in a temp repo.
|
|
64
|
+
- `speckit doctor --deep --json` returns stable machine-readable status.
|
|
65
|
+
- `speckit start -> context -> run -> review -> close` preserves a single session id.
|
|
66
|
+
- `speckit sync -> triage -> next` preserves story-to-graph traceability.
|
|
67
|
+
- All IDE adapters compile from the same Spec policies.
|
|
68
|
+
- Tests enforce vocabulary, flow links, adapter parity, and robot-safe graph commands.
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Spec Quality Gates
|
|
2
|
+
|
|
3
|
+
## Vocabulary Gate
|
|
4
|
+
|
|
5
|
+
Publishable files must not contain legacy workflow brand names or command prefixes.
|
|
6
|
+
|
|
7
|
+
Allowed:
|
|
8
|
+
|
|
9
|
+
- `Speckit`
|
|
10
|
+
- `Spec`
|
|
11
|
+
- IDE names such as `Claude Code`
|
|
12
|
+
- external graph tool names such as `Beads` and `Beads Viewer`
|
|
13
|
+
|
|
14
|
+
Forbidden in publishable files:
|
|
15
|
+
|
|
16
|
+
- old workflow brand names
|
|
17
|
+
- old slash command prefixes
|
|
18
|
+
- old implementation command names
|
|
19
|
+
|
|
20
|
+
## Flow Link Gate
|
|
21
|
+
|
|
22
|
+
Every phase must link to the next durable artifact.
|
|
23
|
+
|
|
24
|
+
| Phase | Input | Output | Required Link |
|
|
25
|
+
| --- | --- | --- | --- |
|
|
26
|
+
| start | idea | session | session id |
|
|
27
|
+
| shape | session | spec brief | session -> spec |
|
|
28
|
+
| plan | spec brief | PRD / architecture / story | spec -> plan |
|
|
29
|
+
| context | story | context pack | story -> context |
|
|
30
|
+
| sync | story | graph task | story -> task id |
|
|
31
|
+
| run | task/story | TDD evidence | task -> evidence |
|
|
32
|
+
| review | diff + evidence | review checklist | evidence -> review |
|
|
33
|
+
| close | review | changelog / graph close | review -> close |
|
|
34
|
+
|
|
35
|
+
## Tool Gate
|
|
36
|
+
|
|
37
|
+
Tool permissions are phase-specific.
|
|
38
|
+
|
|
39
|
+
- Shape and plan may inspect files but should not edit implementation code.
|
|
40
|
+
- Run may edit code but must record TDD evidence.
|
|
41
|
+
- Review should inspect and test; it should not implement.
|
|
42
|
+
- Graph commands must never launch an interactive TUI.
|
|
43
|
+
|
|
44
|
+
## Adapter Parity Gate
|
|
45
|
+
|
|
46
|
+
All supported IDEs must receive the same Speckit policy:
|
|
47
|
+
|
|
48
|
+
- Spec policy
|
|
49
|
+
- TDD policy
|
|
50
|
+
- Enterprise safety policy
|
|
51
|
+
- Session/context instructions
|
|
52
|
+
- Graph command safety
|
|
53
|
+
|
|
54
|
+
## Release Gate
|
|
55
|
+
|
|
56
|
+
Before release:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
npm run lint
|
|
60
|
+
npm test
|
|
61
|
+
npm pack --dry-run
|
|
62
|
+
speckit doctor --json
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
For enterprise releases:
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
speckit init --enterprise --ide all
|
|
69
|
+
speckit doctor --deep --json
|
|
70
|
+
```
|
|
@@ -24,4 +24,4 @@ bin/speckit
|
|
|
24
24
|
user intent -> CLI command -> markdown/json artifact -> IDE adapter -> agent workflow
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
The CLI does not depend on
|
|
27
|
+
The CLI does not depend on external workflow runtimes. Beads and Beads Viewer are optional integrations discovered at runtime.
|