@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.
Files changed (40) hide show
  1. package/README.md +16 -1
  2. package/dist/adapters/antigravity-adapter.js +5 -5
  3. package/dist/adapters/claude-code-adapter.js +8 -5
  4. package/dist/adapters/codex-adapter.js +5 -3
  5. package/dist/adapters/cursor-adapter.js +6 -3
  6. package/dist/adapters/opencode-adapter.js +1 -0
  7. package/dist/adapters/tool-checks.js +0 -1
  8. package/dist/cli.js +24 -2
  9. package/dist/commands/close.d.ts +6 -0
  10. package/dist/commands/close.js +34 -0
  11. package/dist/commands/context.d.ts +6 -0
  12. package/dist/commands/context.js +87 -0
  13. package/dist/commands/doctor.d.ts +1 -0
  14. package/dist/commands/doctor.js +29 -1
  15. package/dist/commands/init.d.ts +1 -0
  16. package/dist/commands/init.js +5 -3
  17. package/dist/commands/plan.js +19 -2
  18. package/dist/commands/quick.js +20 -2
  19. package/dist/commands/ready.d.ts +7 -0
  20. package/dist/commands/ready.js +20 -0
  21. package/dist/commands/run.js +19 -24
  22. package/dist/commands/start.d.ts +6 -0
  23. package/dist/commands/start.js +47 -0
  24. package/dist/commands/sync.js +2 -8
  25. package/dist/commands/triage.d.ts +6 -0
  26. package/dist/commands/triage.js +33 -0
  27. package/dist/core/readiness.d.ts +13 -0
  28. package/dist/core/readiness.js +120 -0
  29. package/dist/core/scaffold.d.ts +1 -0
  30. package/dist/core/scaffold.js +107 -2
  31. package/dist/core/story.d.ts +13 -0
  32. package/dist/core/story.js +67 -0
  33. package/docs/development-roadmap.md +8 -7
  34. package/docs/product-contract.md +5 -5
  35. package/docs/project-changelog.md +67 -1
  36. package/docs/release-checklist.md +2 -2
  37. package/docs/spec-enterprise-harness-plan.md +68 -0
  38. package/docs/spec-quality-gates.md +70 -0
  39. package/docs/system-architecture.md +1 -1
  40. 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 13 tests.
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 ClaudeKit, BMad Method, and Beads Viewer inspiration.
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
- - [ ] npm package published.
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 running ClaudeKit, BMad, or Beads code. External tools are optional integrations discovered at runtime.
27
+ The CLI does not depend on external workflow runtimes. Beads and Beads Viewer are optional integrations discovered at runtime.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@trieungoctam/speckit",
3
- "version": "0.1.0",
3
+ "version": "0.2.2",
4
4
  "description": "Enterprise Agile + TDD workflow compiler for agentic IDEs.",
5
5
  "type": "module",
6
6
  "files": [