@namewta/speculo 0.6.0 → 0.6.1

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 (110) hide show
  1. package/README.md +7 -4
  2. package/dist/src/cli.js +2 -2
  3. package/dist/src/cli.js.map +1 -1
  4. package/dist/src/index.js +37 -1
  5. package/dist/src/index.js.map +1 -1
  6. package/dist/src/migrate.d.ts +14 -1
  7. package/dist/src/migrate.js +308 -11
  8. package/dist/src/migrate.js.map +1 -1
  9. package/package.json +3 -2
  10. package/template/canonical/canonical-specdev-engineering-cognitive-mentor.md +133 -141
  11. package/template/canonical/canonical-specdev-goal-plan.md +394 -377
  12. package/template/canonical/canonical-specdev-grill-with-docs.md +241 -178
  13. package/template/canonical/canonical-specdev-spec.md +132 -122
  14. package/template/canonical/canonical-specdev-tickets.md +176 -156
  15. package/template/canonical/canonical-specdev-wayfinder.md +106 -108
  16. package/template/commands/archive-and-consolidate.md +10 -8
  17. package/template/commands/handoff.md +2 -0
  18. package/template/commands/retro.md +3 -3
  19. package/template/commands/status.md +5 -4
  20. package/template/skills/archive-and-consolidate/SKILL.md +5 -9
  21. package/template/skills/archive-and-consolidate/assets/archive-plan-template.md +1 -1
  22. package/template/skills/archive-and-consolidate/references/archive-rules.md +4 -4
  23. package/template/skills/archive-and-consolidate/references/consolidation-rules.md +7 -8
  24. package/template/skills/archive-and-consolidate/references/knowledge-graduation.md +5 -2
  25. package/template/skills/github-npm-ops/SKILL.md +4 -2
  26. package/template/skills/github-npm-ops/references/issue-transport.md +26 -0
  27. package/template/skills/github-npm-ops/scripts/issue-transport.mjs +227 -0
  28. package/template/workflows/specdev/A-archive-and-consolidate/A-archive-and-consolidate.md +31 -145
  29. package/template/workflows/specdev/A-archive-and-consolidate/consolidation-interview.md +4 -6
  30. package/template/workflows/specdev/C-code-review/C-code-review.md +42 -0
  31. package/template/workflows/specdev/C-code-review/code-review-template.md +42 -0
  32. package/template/workflows/specdev/D-diagnose-bugs/D-diagnose-bugs.md +45 -48
  33. package/template/workflows/specdev/D-diagnose-bugs/diagnosis-template.md +44 -40
  34. package/template/workflows/specdev/D-diagnose-bugs/feedback-loop.md +41 -0
  35. package/template/workflows/specdev/D-diagnose-bugs/hypothesis-and-instrumentation.md +32 -0
  36. package/template/workflows/specdev/D-diagnose-bugs/scripts/hitl-loop.template.sh +26 -0
  37. package/template/workflows/specdev/E-engineering-cognitive-mentor/E-engineering-cognitive-mentor.md +3 -3
  38. package/template/workflows/specdev/E-engineering-cognitive-mentor/persistence-and-resume.md +5 -20
  39. package/template/workflows/specdev/G-grill-with-docs/G-grill-with-docs.md +17 -10
  40. package/template/workflows/specdev/G-grill-with-docs/adr-format.md +31 -17
  41. package/template/workflows/specdev/G-grill-with-docs/context-format.md +9 -29
  42. package/template/workflows/specdev/G-grill-with-docs/domain-modeling-rules.md +10 -5
  43. package/template/workflows/specdev/G-grill-with-docs/stakeholder-questionnaire.md +45 -0
  44. package/template/workflows/specdev/I-implement/I-implement.md +29 -14
  45. package/template/workflows/specdev/I-implement/delegated-evidence-template.md +11 -0
  46. package/template/workflows/specdev/I-implement/evidence-template.md +24 -10
  47. package/template/workflows/specdev/I-implement/execution-preflight.md +4 -4
  48. package/template/workflows/specdev/I-implement/merge-conflict-protocol.md +20 -0
  49. package/template/workflows/specdev/I-implement/tdd-mocking.md +19 -0
  50. package/template/workflows/specdev/I-implement/tdd-rules.md +14 -12
  51. package/template/workflows/specdev/I-implement/tdd-test-design.md +25 -0
  52. package/template/workflows/specdev/I-init-setup/I-init-setup.md +12 -9
  53. package/template/workflows/specdev/I-init-setup/config-template.json +1 -1
  54. package/template/workflows/specdev/I-init-setup/domain-layout-template.md +2 -2
  55. package/template/workflows/specdev/I-init-setup/status-template.json +2 -3
  56. package/template/workflows/specdev/I-init-setup/tracking-template.md +3 -0
  57. package/template/workflows/specdev/INDEX.md +64 -26
  58. package/template/workflows/specdev/P-goal-plan/P-goal-plan.md +48 -38
  59. package/template/workflows/specdev/P-goal-plan/completion-control.md +19 -53
  60. package/template/workflows/specdev/P-goal-plan/delegated-execution-template.md +33 -0
  61. package/template/workflows/specdev/P-goal-plan/delegated-execution.md +53 -0
  62. package/template/workflows/specdev/P-goal-plan/goal-plan-template.md +9 -40
  63. package/template/workflows/specdev/P-goal-plan/orchestration-protocol.md +16 -68
  64. package/template/workflows/specdev/P-goal-plan/planning-modes.md +20 -48
  65. package/template/workflows/specdev/P-prototype/P-prototype.md +46 -0
  66. package/template/workflows/specdev/P-prototype/logic-prototype.md +24 -0
  67. package/template/workflows/specdev/P-prototype/prototype-record-template.md +46 -0
  68. package/template/workflows/specdev/P-prototype/ui-prototype.md +21 -0
  69. package/template/workflows/specdev/R-review-architecture/R-review-architecture.md +1 -1
  70. package/template/workflows/specdev/S-spec/S-spec.md +2 -1
  71. package/template/workflows/specdev/T-tickets/T-tickets.md +3 -2
  72. package/template/workflows/specdev/T-tickets/ticket-readiness.md +1 -1
  73. package/template/workflows/specdev/T-tickets/ticket-template.md +1 -1
  74. package/template/workflows/specdev/T-tickets/tickets-map-template.md +1 -1
  75. package/template/workflows/specdev/T-triage/T-triage.md +65 -26
  76. package/template/workflows/specdev/T-triage/intake-protocol.md +32 -0
  77. package/template/workflows/specdev/T-triage/reconcile-protocol.md +34 -0
  78. package/template/workflows/specdev/T-triage/source-template.md +30 -0
  79. package/template/workflows/specdev/T-triage/triage-template.md +38 -24
  80. package/template/workflows/specdev/W-wayfinder/W-wayfinder.md +3 -1
  81. package/template/workflows/specdev/_state/status.json +2 -3
  82. package/template/workflows/specdev/common/README.md +9 -2
  83. package/template/workflows/specdev/common/rules/artifact-contract.md +20 -9
  84. package/template/workflows/specdev/common/rules/change-completion.md +33 -0
  85. package/template/workflows/specdev/common/rules/deviation-control.md +2 -2
  86. package/template/workflows/specdev/common/rules/evidence-and-verification.md +1 -1
  87. package/template/workflows/specdev/common/rules/path-ownership.md +3 -3
  88. package/template/workflows/specdev/common/schemas/change-status.schema.json +43 -0
  89. package/template/workflows/specdev/common/schemas/code-review.schema.json +22 -0
  90. package/template/workflows/specdev/common/schemas/diagnosis.schema.json +19 -0
  91. package/template/workflows/specdev/common/schemas/prototype-record.schema.json +24 -0
  92. package/template/workflows/specdev/common/schemas/source.schema.json +20 -0
  93. package/template/workflows/specdev/common/schemas/status.schema.json +20 -78
  94. package/template/workflows/specdev/common/schemas/triage.schema.json +21 -0
  95. package/template/workflows/specdev/common/skills/code-review/SKILL.md +49 -0
  96. package/template/workflows/specdev/common/skills/code-review/references/fowler-smells.md +18 -0
  97. package/template/workflows/specdev/common/skills/code-review/references/reviewer-contracts.md +13 -0
  98. package/template/workflows/specdev/common/skills/code-review/references/source-discovery.md +22 -0
  99. package/template/workflows/specdev/common/skills/dev-worktree/SKILL.md +12 -9
  100. package/template/workflows/specdev/common/skills/dev-worktree/references/create.md +18 -13
  101. package/template/workflows/specdev/common/skills/dev-worktree/references/finalize.md +8 -6
  102. package/template/workflows/specdev/common/skills/research/SKILL.md +38 -26
  103. package/template/workflows/specdev/common/skills/subagent-delivery/SKILL.md +3 -5
  104. package/template/workflows/specdev/common/tools/README.md +3 -0
  105. package/template/workflows/specdev/common/tools/validate-specdev.mjs +496 -30
  106. package/template/workflows/specdev/A-archive-and-consolidate/archive-checklist.md +0 -15
  107. package/template/workflows/specdev/A-archive-and-consolidate/knowledge-promotion-rules.md +0 -32
  108. package/template/workflows/specdev/I-implement/code-review-process.md +0 -17
  109. package/template/workflows/specdev/I-implement/tdd-examples.md +0 -14
  110. package/template/workflows/specdev/I-init-setup/status-labels-template.md +0 -55
@@ -1,15 +0,0 @@
1
- # 归档检查
2
-
3
- 本清单由 `<Path>{roots.workflows}/specdev/A-archive-and-consolidate/A-archive-and-consolidate.md</Path>` 使用。
4
-
5
- - [ ] `<Path>{roots.state}/specdev/changes/{change}/ticket/</Path>` 内计划 Ticket 均为 `done` 或有批准理由的 `cancelled`。
6
- - [ ] 每个 `done` Ticket 都有 `<Path>{roots.state}/specdev/changes/{change}/evidence/{ticket-id}.md</Path>`。
7
- - [ ] `<Path>{roots.state}/specdev/changes/{change}/spec.md</Path>` 的 AC/合同已覆盖,无未批准 deviation。
8
- - [ ] `<Path>{roots.state}/specdev/changes/{change}/goal-plan.md</Path>` 中适用 Gate 已关闭。
9
- - [ ] 项目级验证通过,或已有明确接受的既有/环境失败记录。
10
- - [ ] 迁移、兼容、监控、回滚和不可逆操作已完成或明确移交。
11
- - [ ] `<Path>{roots.state}/specdev/changes/{change}/tickets-map.md</Path>`、Ticket、Evidence 和状态一致。
12
- - [ ] 校验器无 error。
13
- - [ ] 永久知识候选均有来源、范围和实现证据。
14
- - [ ] 敏感值扫描通过。
15
- - [ ] 用户已授权归档及需要的移动、Git 或外部副作用。
@@ -1,32 +0,0 @@
1
- # 知识提升规则
2
-
3
- 本规则由 `<Path>{roots.workflows}/specdev/A-archive-and-consolidate/A-archive-and-consolidate.md</Path>` 使用,并遵循 `<Path>{roots.workflows}/specdev/common/rules/artifact-contract.md</Path>`。
4
-
5
- ## 资格
6
-
7
- 永久知识必须同时满足:
8
-
9
- - 当前代码或实际行为已有验证支持;
10
- - 超出单个 change 仍有用;
11
- - 有明确来源、适用范围和状态;
12
- - 不只是计划、假设、一次性操作记录或临时 workaround;
13
- - 与现有永久知识的关系已判断。
14
-
15
- ## 操作
16
-
17
- - **create**:没有等价条目;
18
- - **update**:同一决策或术语的非语义性补充;
19
- - **merge**:多个条目表达同一当前真相,保留全部来源;
20
- - **supersede**:新决策替代旧决策,建立双向引用;
21
- - **deprecate**:不再推荐但仍需历史或兼容说明;
22
- - **skip**:临时、局部、未经验证、已过期或不具长期价值。
23
-
24
- ## 目标
25
-
26
- - 架构决策:`<Path>{roots.state}/specdev/adr/</Path>`
27
- - 领域上下文:`<Path>{roots.state}/specdev/context/</Path>`
28
- - 研究结论:`<Path>{roots.state}/specdev/research/</Path>`
29
-
30
- ## 冲突
31
-
32
- 无法确定哪条代表当前真相时不提升。创建治理问题或新 change,并保留冲突来源。永久知识库必须反映当前状态,同时保存历史关系,而不是把冲突藏起来。
@@ -1,17 +0,0 @@
1
- # 双轴审查
2
-
3
- ## 标准轴
4
-
5
- 检查正确性、并发、资源释放、错误处理、安全、性能风险、模块深度、重复知识、测试真实性和可读性。评论必须指向具体行为风险,不做纯风格噪声。
6
-
7
- ## 契约轴
8
-
9
- 逐项核对:contract_ids、IN/REUSE/OUT、锁定决策、不变量、失败/兼容、writable_paths、验证矩阵、Deep 发布恢复和 Goal Gate。
10
-
11
- ## 结论
12
-
13
- - `APPROVE`:无阻塞问题;
14
- - `REQUEST_CHANGES`:列出阻塞问题、证据和应满足的结果;
15
- - `ESCALATE_DEVIATION`:修复需要改变上层契约。
16
-
17
- 审查者不得通过设计新功能扩大 Ticket。
@@ -1,14 +0,0 @@
1
- # TDD 示例原则
2
-
3
- ## 好
4
-
5
- - 通过 HTTP/CLI/公共函数验证输入、输出、状态和错误。
6
- - 固定时间、随机、网络等非确定性依赖于真实接缝。
7
- - 回归测试先复现 diagnosis 的触发机制。
8
-
9
- ## 坏
10
-
11
- - 断言私有辅助函数被调用。
12
- - 将生产代码逐行翻译成测试。
13
- - 全部依赖都 Mock,导致协议不兼容仍通过。
14
- - 只测 happy path,不覆盖 Ticket 明确的失败行为。
@@ -1,55 +0,0 @@
1
- # 状态标签映射
2
-
3
- 本文件把 SpecDev 的标准角色映射到外部 Issue/项目管理系统的具体标签。标准角色保持稳定;具体标签字符串可以按项目调整。
4
-
5
- ## 1. 标准角色
6
-
7
- | 标准角色 | 默认标签 | 使用条件 | 退出条件 |
8
- |---|---|---|---|
9
- | needs-triage | needs-triage | 外部请求尚未完成分类、影响和路由 | `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>` 已完成 |
10
- | needs-info | needs-info | 缺少必须由用户或外部系统提供的信息 | 决策或输入已写入权威工件 |
11
- | ready-for-agent | ready-for-agent | 当前工件满足 Ready 门禁,可由 Agent 自主继续 | Agent 领取、出现 blocker/deviation 或完成 |
12
- | ready-for-human | ready-for-human | 等待产品、架构、安全、发布或不可逆操作批准 | 指定批准人记录决定 |
13
- | wontfix | wontfix | 用户或 owner 明确决定不处理 | 通常为终态;恢复需新决定 |
14
-
15
- 标签是外部系统投影,不替代 `<Path>{roots.state}/specdev/status.json</Path>`、`<Path>{roots.state}/specdev/changes/{change}/.status.json</Path>` 或 Ticket frontmatter。
16
-
17
- ## 2. 推荐流转
18
-
19
- ```text
20
- needs-triage
21
- ├─→ needs-info ──→ needs-triage
22
- ├─→ ready-for-human ──→ ready-for-agent
23
- ├─→ ready-for-agent ──→ in-progress / review / completed
24
- └─→ wontfix
25
- ```
26
-
27
- 外部系统没有 `in-progress`、`review` 或 `completed` 标签时,可以不映射;SpecDev 内部状态仍由状态工件维护。
28
-
29
- ## 3. 内部状态投影
30
-
31
- | SpecDev 状态或条件 | 推荐标准角色 |
32
- |---|---|
33
- | 新摄入、尚未分诊 | needs-triage |
34
- | `blocked` 且缺少用户输入 | needs-info |
35
- | Ready Ticket 或获批 Direct Spec | ready-for-agent |
36
- | Deep Ticket 批准点、release deviation、不可逆操作 | ready-for-human |
37
- | 明确取消且不再处理 | wontfix |
38
-
39
- 不得仅因添加 `ready-for-agent` 标签就绕过 Spec、Ticket、Goal Plan 或验证门禁。
40
-
41
- ## 4. 自定义规则
42
-
43
- 1. 可以修改“默认标签”字符串,但不得改变五个标准角色的语义。
44
- 2. 一个具体标签不得同时映射到多个互斥角色。
45
- 3. 项目没有对应外部系统时,保留本文件作为语义字典,不强制创建标签。
46
- 4. 标签不存在时先报告,不自动创建、重命名或删除外部标签,除非用户授权。
47
- 5. 外部标签与内部状态冲突时,以 SpecDev 权威工件为准,修正投影并记录原因。
48
- 6. 自定义结果应记录来源、系统名称、更新时间和维护 owner。
49
-
50
- ## 5. 项目映射
51
-
52
- - **外部系统:** 无 / GitHub / GitLab / Jira / 其他
53
- - **映射更新时间:**
54
- - **维护 owner:**
55
- - **自定义映射:** 无 / ...