cc-devflow 4.3.0 → 4.4.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 (575) hide show
  1. package/.claude/skills/cc-act/CHANGELOG.md +64 -0
  2. package/.claude/skills/cc-act/PLAYBOOK.md +212 -0
  3. package/.claude/skills/cc-act/SKILL.md +322 -0
  4. package/.claude/skills/cc-act/assets/PR_BRIEF_TEMPLATE.md +64 -0
  5. package/.claude/skills/cc-act/assets/RELEASE_NOTE_TEMPLATE.md +25 -0
  6. package/.claude/skills/cc-act/references/closure-contract.md +49 -0
  7. package/.claude/skills/cc-act/references/git-commit-guidelines.md +83 -0
  8. package/.claude/skills/cc-act/scripts/archive-requirement.sh +49 -0
  9. package/.claude/skills/cc-act/scripts/cc-act-common.sh +240 -0
  10. package/.claude/skills/cc-act/scripts/detect-ship-target.sh +82 -0
  11. package/.claude/skills/cc-act/scripts/generate-status-report.sh +83 -0
  12. package/.claude/skills/cc-act/scripts/render-pr-brief.sh +195 -0
  13. package/.claude/skills/cc-act/scripts/sync-act-docs.sh +315 -0
  14. package/.claude/skills/cc-act/scripts/verify-act-gate.sh +63 -0
  15. package/.claude/skills/cc-check/CHANGELOG.md +73 -0
  16. package/.claude/skills/cc-check/PLAYBOOK.md +153 -0
  17. package/.claude/skills/cc-check/SKILL.md +345 -0
  18. package/.claude/skills/cc-check/assets/REPORT_CARD_TEMPLATE.json +50 -0
  19. package/.claude/skills/cc-check/references/gate-contract.md +29 -0
  20. package/.claude/skills/cc-check/references/review-contract.md +45 -0
  21. package/.claude/skills/cc-check/scripts/render-report-card.js +229 -0
  22. package/.claude/skills/cc-check/scripts/run-quality-gates.sh +86 -0
  23. package/.claude/skills/cc-check/scripts/verify-gate.sh +57 -0
  24. package/.claude/skills/cc-do/CHANGELOG.md +49 -0
  25. package/.claude/skills/cc-do/PLAYBOOK.md +119 -0
  26. package/.claude/skills/cc-do/SKILL.md +216 -0
  27. package/.claude/skills/cc-do/references/execution-recovery.md +86 -0
  28. package/.claude/skills/cc-do/references/parallel-dispatch.md +80 -0
  29. package/.claude/skills/cc-do/scripts/build-task-context.sh +184 -0
  30. package/.claude/skills/cc-do/scripts/cc-do-common.sh +79 -0
  31. package/.claude/skills/cc-do/scripts/check-task-status.sh +92 -0
  32. package/.claude/skills/cc-do/scripts/detect-file-conflicts.sh +87 -0
  33. package/.claude/skills/cc-do/scripts/mark-task-complete.sh +119 -0
  34. package/.claude/skills/cc-do/scripts/record-review-decision.sh +89 -0
  35. package/.claude/skills/cc-do/scripts/recover-workflow.sh +84 -0
  36. package/.claude/skills/cc-do/scripts/run-problem-analysis.sh +70 -0
  37. package/.claude/skills/cc-do/scripts/select-ready-tasks.sh +135 -0
  38. package/.claude/skills/cc-do/scripts/verify-task-gates.sh +94 -0
  39. package/.claude/skills/cc-do/scripts/write-task-checkpoint.sh +102 -0
  40. package/.claude/skills/cc-investigate/CHANGELOG.md +26 -0
  41. package/.claude/skills/cc-investigate/PLAYBOOK.md +49 -0
  42. package/.claude/skills/cc-investigate/SKILL.md +221 -0
  43. package/.claude/skills/cc-investigate/assets/ANALYSIS_TEMPLATE.md +55 -0
  44. package/.claude/skills/cc-investigate/assets/TASKS_TEMPLATE.md +52 -0
  45. package/.claude/skills/cc-investigate/assets/TASK_MANIFEST_TEMPLATE.json +103 -0
  46. package/.claude/skills/cc-investigate/references/investigation-contract.md +28 -0
  47. package/.claude/skills/cc-investigate/scripts/bootstrap-analysis.sh +38 -0
  48. package/.claude/skills/cc-plan/CHANGELOG.md +99 -0
  49. package/.claude/skills/cc-plan/PLAYBOOK.md +106 -0
  50. package/.claude/skills/cc-plan/SKILL.md +325 -0
  51. package/.claude/skills/cc-plan/assets/DESIGN_TEMPLATE.md +155 -0
  52. package/.claude/skills/cc-plan/assets/TASKS_TEMPLATE.md +98 -0
  53. package/.claude/skills/cc-plan/assets/TASK_MANIFEST_TEMPLATE.json +108 -0
  54. package/.claude/skills/cc-plan/assets/TINY_DESIGN_TEMPLATE.md +79 -0
  55. package/.claude/skills/cc-plan/references/planning-contract.md +82 -0
  56. package/.claude/skills/cc-plan/scripts/bump-skill-version.sh +103 -0
  57. package/.claude/skills/cc-plan/scripts/parse-task-dependencies.js +75 -0
  58. package/.claude/skills/cc-plan/scripts/validate-scope.sh +78 -0
  59. package/.claude/skills/cc-roadmap/CHANGELOG.md +114 -0
  60. package/.claude/skills/cc-roadmap/PLAYBOOK.md +136 -0
  61. package/.claude/skills/cc-roadmap/SKILL.md +259 -0
  62. package/.claude/skills/cc-roadmap/assets/BACKLOG_TEMPLATE.md +45 -0
  63. package/.claude/skills/cc-roadmap/assets/ROADMAP_TEMPLATE.md +153 -0
  64. package/.claude/skills/cc-roadmap/assets/TRACKING_TEMPLATE.json +48 -0
  65. package/.claude/skills/cc-roadmap/references/roadmap-dialogue.md +37 -0
  66. package/.claude/skills/cc-roadmap/scripts/bump-skill-version.sh +103 -0
  67. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/markdown.js +604 -0
  68. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/query.js +63 -0
  69. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/schema.js +245 -0
  70. package/.claude/skills/cc-roadmap/scripts/lib/roadmap-tracking/store.js +139 -0
  71. package/.claude/skills/cc-roadmap/scripts/locate-roadmap-item.sh +109 -0
  72. package/.claude/skills/cc-roadmap/scripts/roadmap-tracking.js +153 -0
  73. package/.claude/skills/cc-roadmap/scripts/sync-roadmap-progress.sh +100 -0
  74. package/.claude/skills/cc-simplify/CHANGELOG.md +10 -0
  75. package/.claude/skills/cc-simplify/SKILL.md +55 -0
  76. package/.claude/skills/cc-spec-init/CHANGELOG.md +7 -0
  77. package/.claude/skills/cc-spec-init/PLAYBOOK.md +55 -0
  78. package/.claude/skills/cc-spec-init/SKILL.md +127 -0
  79. package/.claude/skills/cc-spec-init/assets/CAPABILITY_TEMPLATE.md +63 -0
  80. package/.claude/skills/cc-spec-init/assets/CHANGE_META_TEMPLATE.json +25 -0
  81. package/.claude/skills/cc-spec-init/assets/INDEX_TEMPLATE.md +34 -0
  82. package/.claude/skills/cc-spec-init/references/spec-contract.md +22 -0
  83. package/.claude/skills/cc-spec-init/scripts/bootstrap-specs.sh +31 -0
  84. package/.claude/skills/cc-spec-init/scripts/validate-spec-links.sh +45 -0
  85. package/CHANGELOG.md +61 -4
  86. package/README.md +120 -756
  87. package/README.zh-CN.md +119 -756
  88. package/bin/adapt.js +2 -6
  89. package/bin/cc-devflow-cli.js +72 -177
  90. package/config/distributable-skills.json +24 -0
  91. package/docs/CLAUDE.md +10 -6
  92. package/docs/commands/README.md +19 -46
  93. package/docs/commands/README.zh-CN.md +25 -48
  94. package/docs/examples/BY-ARTIFACT.md +7 -0
  95. package/docs/examples/README.md +38 -0
  96. package/docs/examples/START-HERE.md +149 -0
  97. package/docs/examples/example-bindings.json +38 -0
  98. package/docs/examples/full-design-blocked/BACKLOG.md +45 -0
  99. package/docs/examples/full-design-blocked/README.md +55 -0
  100. package/docs/examples/full-design-blocked/ROADMAP.md +53 -0
  101. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/design.md +154 -0
  102. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/task-manifest.json +146 -0
  103. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/planning/tasks.md +78 -0
  104. package/docs/examples/full-design-blocked/changes/REQ-002-bulk-invite-import/review/report-card.json +52 -0
  105. package/docs/examples/full-design-blocked/roadmap-tracking.json +50 -0
  106. package/docs/examples/local-handoff/BACKLOG.md +45 -0
  107. package/docs/examples/local-handoff/README.md +56 -0
  108. package/docs/examples/local-handoff/ROADMAP.md +45 -0
  109. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/resume-index.md +39 -0
  110. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/handoff/status.md +29 -0
  111. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/design.md +71 -0
  112. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/task-manifest.json +98 -0
  113. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/planning/tasks.md +59 -0
  114. package/docs/examples/local-handoff/changes/REQ-003-audit-log-export/review/report-card.json +44 -0
  115. package/docs/examples/local-handoff/roadmap-tracking.json +48 -0
  116. package/docs/examples/pdca-loop/BACKLOG.md +46 -0
  117. package/docs/examples/pdca-loop/README.md +58 -0
  118. package/docs/examples/pdca-loop/ROADMAP.md +133 -0
  119. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/pr-brief.md +72 -0
  120. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/handoff/status.md +29 -0
  121. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/design.md +72 -0
  122. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/task-manifest.json +201 -0
  123. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/planning/tasks.md +73 -0
  124. package/docs/examples/pdca-loop/changes/REQ-001-copy-invite-link/review/report-card.json +44 -0
  125. package/docs/examples/pdca-loop/roadmap-tracking.json +114 -0
  126. package/docs/examples/scripts/check-example-bindings.sh +116 -0
  127. package/docs/guides/getting-started.md +94 -129
  128. package/docs/guides/getting-started.zh-CN.md +103 -84
  129. package/docs/skill-runtime-migration.md +46 -0
  130. package/docs/v4.3.0-migration-guide.md +60 -225
  131. package/lib/compiler/CLAUDE.md +55 -84
  132. package/lib/compiler/__tests__/drift.test.js +1 -1
  133. package/lib/compiler/__tests__/errors.test.js +0 -1
  134. package/lib/compiler/__tests__/integration.test.js +49 -3
  135. package/lib/compiler/__tests__/manifest.test.js +0 -156
  136. package/lib/compiler/__tests__/parser.test.js +33 -104
  137. package/lib/compiler/__tests__/schemas.test.js +30 -34
  138. package/lib/compiler/__tests__/skills-registry.test.js +114 -0
  139. package/lib/compiler/__tests__/transformer.test.js +5 -9
  140. package/lib/compiler/emitters/antigravity-emitter.js +5 -213
  141. package/lib/compiler/emitters/base-emitter.js +3 -298
  142. package/lib/compiler/emitters/codex-emitter.js +4 -202
  143. package/lib/compiler/emitters/cursor-emitter.js +3 -287
  144. package/lib/compiler/emitters/qwen-emitter.js +4 -176
  145. package/lib/compiler/index.js +65 -345
  146. package/lib/compiler/manifest.js +6 -68
  147. package/lib/compiler/parser.js +31 -63
  148. package/lib/compiler/platforms.js +32 -277
  149. package/lib/compiler/resource-copier.js +176 -6
  150. package/lib/compiler/rules-emitters/__tests__/antigravity-rules-emitter.test.js +3 -3
  151. package/lib/compiler/rules-emitters/__tests__/cursor-rules-emitter.test.js +14 -4
  152. package/lib/compiler/rules-emitters/__tests__/qwen-rules-emitter.test.js +16 -7
  153. package/lib/compiler/rules-emitters/antigravity-rules-emitter.js +10 -15
  154. package/lib/compiler/rules-emitters/base-rules-emitter.js +5 -5
  155. package/lib/compiler/rules-emitters/cursor-rules-emitter.js +7 -12
  156. package/lib/compiler/rules-emitters/index.js +6 -3
  157. package/lib/compiler/rules-emitters/qwen-rules-emitter.js +7 -7
  158. package/lib/compiler/schemas.js +8 -4
  159. package/lib/compiler/skills-registry.js +213 -15
  160. package/lib/compiler/transformer.js +1 -1
  161. package/lib/skill-runtime/CLAUDE.md +19 -0
  162. package/lib/skill-runtime/__tests__/autopilot.test.js +210 -0
  163. package/lib/skill-runtime/__tests__/cli-bootstrap.integration.test.js +181 -0
  164. package/lib/skill-runtime/__tests__/delegation.test.js +97 -0
  165. package/lib/skill-runtime/__tests__/dispatch.test.js +267 -0
  166. package/lib/skill-runtime/__tests__/intent.test.js +219 -0
  167. package/lib/skill-runtime/__tests__/lifecycle.test.js +169 -0
  168. package/lib/skill-runtime/__tests__/paths.test.js +42 -0
  169. package/lib/skill-runtime/__tests__/planner.tdd.test.js +250 -0
  170. package/lib/skill-runtime/__tests__/prepare-pr.test.js +139 -0
  171. package/lib/skill-runtime/__tests__/query.test.js +284 -0
  172. package/lib/skill-runtime/__tests__/runtime.integration.test.js +279 -0
  173. package/lib/skill-runtime/__tests__/schemas.test.js +207 -0
  174. package/lib/skill-runtime/__tests__/team-state.test.js +51 -0
  175. package/lib/skill-runtime/__tests__/worker-run.test.js +253 -0
  176. package/lib/skill-runtime/__tests__/worker.test.js +56 -0
  177. package/lib/skill-runtime/artifacts.js +93 -0
  178. package/lib/skill-runtime/delegation.js +533 -0
  179. package/lib/skill-runtime/index.js +34 -0
  180. package/lib/skill-runtime/intent.js +333 -0
  181. package/lib/skill-runtime/lifecycle.js +294 -0
  182. package/lib/skill-runtime/operations/CLAUDE.md +19 -0
  183. package/lib/skill-runtime/operations/approve.js +66 -0
  184. package/lib/skill-runtime/operations/autopilot-core.js +337 -0
  185. package/lib/skill-runtime/operations/autopilot-execution.js +307 -0
  186. package/lib/skill-runtime/operations/autopilot-shared.js +48 -0
  187. package/lib/skill-runtime/operations/autopilot.js +163 -0
  188. package/lib/skill-runtime/operations/dispatch.js +454 -0
  189. package/lib/skill-runtime/operations/init.js +64 -0
  190. package/lib/{harness → skill-runtime}/operations/janitor.js +9 -6
  191. package/lib/skill-runtime/operations/plan.js +59 -0
  192. package/lib/skill-runtime/operations/prepare-pr.js +25 -0
  193. package/lib/skill-runtime/operations/release.js +96 -0
  194. package/lib/skill-runtime/operations/resume.js +143 -0
  195. package/lib/skill-runtime/operations/snapshot.js +45 -0
  196. package/lib/skill-runtime/operations/verify.js +170 -0
  197. package/lib/skill-runtime/operations/worker-run.js +529 -0
  198. package/lib/skill-runtime/operations/worker.js +33 -0
  199. package/lib/skill-runtime/paths.js +213 -0
  200. package/lib/skill-runtime/planner.js +519 -0
  201. package/lib/skill-runtime/query.js +157 -0
  202. package/lib/skill-runtime/review.js +557 -0
  203. package/lib/skill-runtime/schemas.js +400 -0
  204. package/lib/{harness → skill-runtime}/store.js +45 -30
  205. package/lib/skill-runtime/team-state.js +122 -0
  206. package/package.json +13 -11
  207. package/.claude/CLAUDE.md +0 -125
  208. package/.claude/agents/architecture-designer.md +0 -443
  209. package/.claude/agents/bug-analyzer.md +0 -381
  210. package/.claude/agents/checklist-agent.md +0 -175
  211. package/.claude/agents/clarify-analyst.md +0 -50
  212. package/.claude/agents/code-quality-reviewer.md +0 -205
  213. package/.claude/agents/code-reviewer.md +0 -71
  214. package/.claude/agents/codex-analyzer.md +0 -39
  215. package/.claude/agents/compatibility-checker.md +0 -579
  216. package/.claude/agents/consistency-checker.md +0 -532
  217. package/.claude/agents/dev-implementer.md +0 -195
  218. package/.claude/agents/flow-researcher.md +0 -132
  219. package/.claude/agents/impact-analyzer.md +0 -440
  220. package/.claude/agents/planner.md +0 -230
  221. package/.claude/agents/prd-writer.md +0 -320
  222. package/.claude/agents/project-guidelines-generator.md +0 -1329
  223. package/.claude/agents/qa-tester.md +0 -313
  224. package/.claude/agents/release-manager.md +0 -295
  225. package/.claude/agents/security-reviewer.md +0 -314
  226. package/.claude/agents/spec-reviewer.md +0 -221
  227. package/.claude/agents/style-guide-generator.md +0 -458
  228. package/.claude/agents/tech-architect.md +0 -516
  229. package/.claude/agents/ui-designer.md +0 -485
  230. package/.claude/commands/core/architecture.md +0 -459
  231. package/.claude/commands/core/guidelines.md +0 -511
  232. package/.claude/commands/core/roadmap.md +0 -468
  233. package/.claude/commands/core/style.md +0 -83
  234. package/.claude/commands/flow/CLAUDE.md +0 -24
  235. package/.claude/commands/flow/archive.md +0 -280
  236. package/.claude/commands/flow/constitution.md +0 -82
  237. package/.claude/commands/flow/context.md +0 -150
  238. package/.claude/commands/flow/delta.md +0 -245
  239. package/.claude/commands/flow/dev.md +0 -40
  240. package/.claude/commands/flow/fix.md +0 -217
  241. package/.claude/commands/flow/ideate.md +0 -214
  242. package/.claude/commands/flow/init.md +0 -38
  243. package/.claude/commands/flow/release.md +0 -36
  244. package/.claude/commands/flow/restart.md +0 -97
  245. package/.claude/commands/flow/spec.md +0 -36
  246. package/.claude/commands/flow/status.md +0 -64
  247. package/.claude/commands/flow/update.md +0 -111
  248. package/.claude/commands/flow/upgrade.md +0 -115
  249. package/.claude/commands/flow/verify.md +0 -37
  250. package/.claude/commands/flow/workspace.md +0 -155
  251. package/.claude/commands/util/cancel-ralph.md +0 -60
  252. package/.claude/commands/util/code-review.md +0 -58
  253. package/.claude/commands/util/git-commit.md +0 -422
  254. package/.claude/commands/util/problem-analyzer.md +0 -60
  255. package/.claude/config/quality-gates.yml +0 -305
  256. package/.claude/config/quality-rules.yml +0 -161
  257. package/.claude/docs/SPEC_KIT_CONSTITUTION_ANALYSIS.md +0 -426
  258. package/.claude/docs/design/consistency-conflict-detection-algorithms.md +0 -658
  259. package/.claude/docs/design/intent-driven-input-design.md +0 -380
  260. package/.claude/docs/design/prd-version-management-design.md +0 -437
  261. package/.claude/docs/examples/design-inspiration-pool.md +0 -59
  262. package/.claude/docs/examples/ui-prototype-constitution-checklist.md +0 -75
  263. package/.claude/docs/guides/INIT_TROUBLESHOOTING.md +0 -117
  264. package/.claude/docs/guides/NEW_TROUBLESHOOTING.md +0 -99
  265. package/.claude/docs/guides/ROADMAP_TROUBLESHOOTING.md +0 -188
  266. package/.claude/docs/guides/TASK_COMPLETION_MARKING.md +0 -338
  267. package/.claude/docs/guides/TEAM_MODE_GUIDE.md +0 -312
  268. package/.claude/docs/implementation-summary-v7.md +0 -449
  269. package/.claude/docs/spec-format-guide.md +0 -349
  270. package/.claude/docs/state-consolidation-design.md +0 -323
  271. package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +0 -332
  272. package/.claude/docs/templates/ATTEMPT_TEMPLATE.md +0 -156
  273. package/.claude/docs/templates/BACKLOG_TEMPLATE.md +0 -261
  274. package/.claude/docs/templates/BRAINSTORM_TEMPLATE.md +0 -148
  275. package/.claude/docs/templates/CHECKLIST_TEMPLATE.md +0 -52
  276. package/.claude/docs/templates/CLARIFICATION_REPORT_TEMPLATE.md +0 -206
  277. package/.claude/docs/templates/CODE_REVIEW_TEMPLATE.md +0 -71
  278. package/.claude/docs/templates/DELTA_SPEC_TEMPLATE.md +0 -91
  279. package/.claude/docs/templates/DESIGN_DECISIONS_TEMPLATE.md +0 -151
  280. package/.claude/docs/templates/DESIGN_TEMPLATE.md +0 -157
  281. package/.claude/docs/templates/ERROR_LOG_TEMPLATE.md +0 -80
  282. package/.claude/docs/templates/INIT_FLOW_TEMPLATE.md +0 -198
  283. package/.claude/docs/templates/INTENT_CLARIFICATION_TEMPLATE.md +0 -57
  284. package/.claude/docs/templates/JOURNAL_TEMPLATE.md +0 -75
  285. package/.claude/docs/templates/NEW_ORCHESTRATION_TEMPLATE.md +0 -76
  286. package/.claude/docs/templates/PROPOSAL_TEMPLATE.md +0 -91
  287. package/.claude/docs/templates/RESEARCH_TEMPLATE.md +0 -276
  288. package/.claude/docs/templates/REVIEW-HIGH.md +0 -57
  289. package/.claude/docs/templates/ROADMAP_DIALOGUE_TEMPLATE.md +0 -198
  290. package/.claude/docs/templates/ROADMAP_TEMPLATE.md +0 -310
  291. package/.claude/docs/templates/SPEC_TEMPLATE_DELTA.md +0 -139
  292. package/.claude/docs/templates/SPEC_TEMPLATE_PROJECT.md +0 -93
  293. package/.claude/docs/templates/STYLE_TEMPLATE.md +0 -479
  294. package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +0 -373
  295. package/.claude/docs/templates/_shared/CLAUDE.md +0 -36
  296. package/.claude/docs/templates/_shared/CONSTITUTION_CHECK.md +0 -125
  297. package/.claude/docs/templates/_shared/VALIDATION_CHECKLIST.md +0 -187
  298. package/.claude/docs/templates/_shared/YAML_FRONTMATTER.md +0 -164
  299. package/.claude/docs/templates/context/dev.jsonl.template +0 -6
  300. package/.claude/docs/templates/context/epic.jsonl.template +0 -5
  301. package/.claude/docs/templates/context/prd.jsonl.template +0 -4
  302. package/.claude/docs/templates/context/research.jsonl.template +0 -4
  303. package/.claude/docs/templates/context/review.jsonl.template +0 -5
  304. package/.claude/docs/templates/context/tech.jsonl.template +0 -5
  305. package/.claude/guides/agent-guides/agent-coordination-guide.md +0 -459
  306. package/.claude/guides/project-guidelines-system.md +0 -463
  307. package/.claude/guides/technical-guides/datetime-handling-guide.md +0 -563
  308. package/.claude/guides/technical-guides/git-github-guide.md +0 -642
  309. package/.claude/guides/technical-guides/test-execution-guide.md +0 -618
  310. package/.claude/guides/workflow-guides/bug-fix-orchestrator.md +0 -217
  311. package/.claude/guides/workflow-guides/flow-orchestrator.md +0 -48
  312. package/.claude/hooks/CLAUDE.md +0 -342
  313. package/.claude/hooks/checklist-gate.js +0 -397
  314. package/.claude/hooks/error-handling-reminder.sh +0 -12
  315. package/.claude/hooks/error-handling-reminder.ts +0 -459
  316. package/.claude/hooks/hooks.json +0 -15
  317. package/.claude/hooks/inject-agent-context.ts +0 -480
  318. package/.claude/hooks/inject-skill-context.ts +0 -359
  319. package/.claude/hooks/post-tool-use-tracker.sh +0 -280
  320. package/.claude/hooks/pre-tool-use-guardrail.sh +0 -36
  321. package/.claude/hooks/pre-tool-use-guardrail.ts +0 -342
  322. package/.claude/hooks/ralph-loop.ts +0 -931
  323. package/.claude/hooks/ralph-stop-hook.sh +0 -190
  324. package/.claude/hooks/skill-activation-prompt.sh +0 -36
  325. package/.claude/hooks/skill-activation-prompt.ts +0 -214
  326. package/.claude/hooks/state/skills-used-test-guard.json +0 -3
  327. package/.claude/hooks/task-completed-hook.ts +0 -593
  328. package/.claude/hooks/teammate-idle-hook.ts +0 -690
  329. package/.claude/hooks/types/team-types.d.ts +0 -238
  330. package/.claude/rules/devflow-conventions.md +0 -286
  331. package/.claude/rules/project-constitution.md +0 -1002
  332. package/.claude/rules/rationalization-library.md +0 -282
  333. package/.claude/schemas/constitution.schema.json +0 -43
  334. package/.claude/scripts/.claude/commands/flow/export-openspec.md +0 -221
  335. package/.claude/scripts/.claude/commands/flow/import-openspec.md +0 -171
  336. package/.claude/scripts/CLAUDE.md +0 -76
  337. package/.claude/scripts/__tests__/openspec.test.js +0 -212
  338. package/.claude/scripts/analyze-upgrade-impact.sh +0 -200
  339. package/.claude/scripts/archive-requirement.sh +0 -394
  340. package/.claude/scripts/calculate-checklist-completion.sh +0 -243
  341. package/.claude/scripts/calculate-quarter.sh +0 -206
  342. package/.claude/scripts/check-dependencies.sh +0 -409
  343. package/.claude/scripts/check-prerequisites.sh +0 -232
  344. package/.claude/scripts/check-task-status.sh +0 -288
  345. package/.claude/scripts/checklist-errors.sh +0 -131
  346. package/.claude/scripts/common.sh +0 -1102
  347. package/.claude/scripts/consolidate-research.sh +0 -182
  348. package/.claude/scripts/create-requirement.sh +0 -451
  349. package/.claude/scripts/delta-parser.ts +0 -637
  350. package/.claude/scripts/detect-file-conflicts.sh +0 -151
  351. package/.claude/scripts/export-contracts.sh +0 -117
  352. package/.claude/scripts/export-openspec.js +0 -222
  353. package/.claude/scripts/extract-data-model.sh +0 -78
  354. package/.claude/scripts/flow-context-add.sh +0 -134
  355. package/.claude/scripts/flow-context-init.sh +0 -133
  356. package/.claude/scripts/flow-context-validate.sh +0 -144
  357. package/.claude/scripts/flow-delta-apply.sh +0 -297
  358. package/.claude/scripts/flow-delta-archive.sh +0 -71
  359. package/.claude/scripts/flow-delta-create.sh +0 -202
  360. package/.claude/scripts/flow-delta-list.sh +0 -142
  361. package/.claude/scripts/flow-delta-status.sh +0 -235
  362. package/.claude/scripts/flow-quality-full.sh +0 -215
  363. package/.claude/scripts/flow-quality-quick.sh +0 -119
  364. package/.claude/scripts/flow-workspace-init.sh +0 -117
  365. package/.claude/scripts/flow-workspace-record.sh +0 -164
  366. package/.claude/scripts/generate-clarification-questions.sh +0 -377
  367. package/.claude/scripts/generate-clarification-report.sh +0 -463
  368. package/.claude/scripts/generate-quickstart.sh +0 -146
  369. package/.claude/scripts/generate-research-tasks.sh +0 -157
  370. package/.claude/scripts/generate-status-report.sh +0 -523
  371. package/.claude/scripts/generate-tech-analysis.sh +0 -46
  372. package/.claude/scripts/get-workflow-status.sh +0 -415
  373. package/.claude/scripts/import-openspec.js +0 -272
  374. package/.claude/scripts/locate-requirement-in-roadmap.sh +0 -233
  375. package/.claude/scripts/manage-constitution.sh +0 -602
  376. package/.claude/scripts/mark-task-complete.sh +0 -198
  377. package/.claude/scripts/parse-task-dependencies.js +0 -334
  378. package/.claude/scripts/populate-research-tasks.sh +0 -284
  379. package/.claude/scripts/record-quality-error.sh +0 -165
  380. package/.claude/scripts/recover-workflow.sh +0 -463
  381. package/.claude/scripts/run-clarify-scan.sh +0 -601
  382. package/.claude/scripts/run-high-review.sh +0 -62
  383. package/.claude/scripts/run-problem-analysis.sh +0 -68
  384. package/.claude/scripts/run-quality-gates.sh +0 -242
  385. package/.claude/scripts/setup-epic.sh +0 -173
  386. package/.claude/scripts/setup-ralph-loop.sh +0 -155
  387. package/.claude/scripts/sync-roadmap-progress.sh +0 -300
  388. package/.claude/scripts/sync-task-marks.sh +0 -199
  389. package/.claude/scripts/team-dev-init.sh +0 -319
  390. package/.claude/scripts/team-state-recovery.sh +0 -229
  391. package/.claude/scripts/test-clarify-scan.sh +0 -515
  392. package/.claude/scripts/update-agent-context.sh +0 -806
  393. package/.claude/scripts/validate-constitution.sh +0 -567
  394. package/.claude/scripts/validate-hooks.sh +0 -487
  395. package/.claude/scripts/validate-research.sh +0 -332
  396. package/.claude/scripts/validate-scope-boundary.sh +0 -493
  397. package/.claude/scripts/validate-scope.sh +0 -200
  398. package/.claude/scripts/verify-gate.sh +0 -269
  399. package/.claude/scripts/verify-setup.sh +0 -37
  400. package/.claude/scripts/workflow-status.ts +0 -433
  401. package/.claude/settings.json +0 -95
  402. package/.claude/skills/_reference-implementations/README.md +0 -96
  403. package/.claude/skills/_reference-implementations/backend-express-prisma/SKILL.md +0 -302
  404. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/architecture-overview.md +0 -451
  405. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/async-and-errors.md +0 -307
  406. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/complete-examples.md +0 -638
  407. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/configuration.md +0 -275
  408. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/database-patterns.md +0 -224
  409. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/middleware-guide.md +0 -213
  410. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/routing-and-controllers.md +0 -756
  411. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/sentry-and-monitoring.md +0 -336
  412. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/services-and-repositories.md +0 -789
  413. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/testing-guide.md +0 -235
  414. package/.claude/skills/_reference-implementations/backend-express-prisma/resources/validation-patterns.md +0 -754
  415. package/.claude/skills/_reference-implementations/frontend-react-mui/SKILL.md +0 -399
  416. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/common-patterns.md +0 -331
  417. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/complete-examples.md +0 -872
  418. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/component-patterns.md +0 -502
  419. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/data-fetching.md +0 -767
  420. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/file-organization.md +0 -502
  421. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/loading-and-error-states.md +0 -501
  422. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/performance.md +0 -406
  423. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/routing-guide.md +0 -364
  424. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/styling-guide.md +0 -428
  425. package/.claude/skills/_reference-implementations/frontend-react-mui/resources/typescript-standards.md +0 -418
  426. package/.claude/skills/attention-refresh/SKILL.md +0 -170
  427. package/.claude/skills/brainstorming/SKILL.md +0 -161
  428. package/.claude/skills/cc-devflow-orchestrator/SKILL.md +0 -169
  429. package/.claude/skills/constitution-guardian/SKILL.md +0 -306
  430. package/.claude/skills/constitution-quick-ref/SKILL.md +0 -374
  431. package/.claude/skills/debugging/SKILL.md +0 -221
  432. package/.claude/skills/file-standards/SKILL.md +0 -353
  433. package/.claude/skills/finishing-branch/SKILL.md +0 -189
  434. package/.claude/skills/flow-dev/CLAUDE.md +0 -16
  435. package/.claude/skills/flow-dev/SKILL.md +0 -94
  436. package/.claude/skills/flow-dev/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -71
  437. package/.claude/skills/flow-dev/context.jsonl +0 -4
  438. package/.claude/skills/flow-dev/dev-implementer.jsonl +0 -8
  439. package/.claude/skills/flow-dev/scripts/entry-gate.sh +0 -116
  440. package/.claude/skills/flow-dev/scripts/exit-gate.sh +0 -101
  441. package/.claude/skills/flow-dev/scripts/task-orchestrator.sh +0 -106
  442. package/.claude/skills/flow-fix/SKILL.md +0 -105
  443. package/.claude/skills/flow-fix/context.jsonl +0 -6
  444. package/.claude/skills/flow-fix/references/bug-analyzer.md +0 -381
  445. package/.claude/skills/flow-init/SKILL.md +0 -105
  446. package/.claude/skills/flow-init/assets/BRAINSTORM_TEMPLATE.md +0 -148
  447. package/.claude/skills/flow-init/assets/INIT_FLOW_TEMPLATE.md +0 -198
  448. package/.claude/skills/flow-init/assets/RESEARCH_TEMPLATE.md +0 -276
  449. package/.claude/skills/flow-init/context.jsonl +0 -5
  450. package/.claude/skills/flow-init/references/flow-researcher.md +0 -132
  451. package/.claude/skills/flow-init/scripts/check-prerequisites.sh +0 -240
  452. package/.claude/skills/flow-init/scripts/consolidate-research.sh +0 -182
  453. package/.claude/skills/flow-init/scripts/create-requirement.sh +0 -404
  454. package/.claude/skills/flow-init/scripts/generate-research-tasks.sh +0 -157
  455. package/.claude/skills/flow-init/scripts/populate-research-tasks.sh +0 -284
  456. package/.claude/skills/flow-init/scripts/validate-research.sh +0 -340
  457. package/.claude/skills/flow-quality/SKILL.md +0 -98
  458. package/.claude/skills/flow-quality/context.jsonl +0 -6
  459. package/.claude/skills/flow-quality/references/code-quality-reviewer.md +0 -205
  460. package/.claude/skills/flow-quality/references/qa-tester.md +0 -313
  461. package/.claude/skills/flow-quality/references/security-reviewer.md +0 -314
  462. package/.claude/skills/flow-quality/references/spec-reviewer.md +0 -221
  463. package/.claude/skills/flow-release/SKILL.md +0 -60
  464. package/.claude/skills/flow-release/context.jsonl +0 -5
  465. package/.claude/skills/flow-release/references/release-manager.md +0 -295
  466. package/.claude/skills/flow-spec/CLAUDE.md +0 -17
  467. package/.claude/skills/flow-spec/SKILL.md +0 -102
  468. package/.claude/skills/flow-spec/context.jsonl +0 -5
  469. package/.claude/skills/flow-spec/scripts/entry-gate.sh +0 -194
  470. package/.claude/skills/flow-spec/scripts/exit-gate.sh +0 -244
  471. package/.claude/skills/flow-spec/scripts/parallel-orchestrator.sh +0 -205
  472. package/.claude/skills/flow-spec/scripts/team-communication.sh +0 -353
  473. package/.claude/skills/flow-spec/scripts/team-init.sh +0 -195
  474. package/.claude/skills/flow-spec/scripts/test-team-mode.sh +0 -496
  475. package/.claude/skills/flow-spec/team-config.json +0 -165
  476. package/.claude/skills/flow-verify/CLAUDE.md +0 -10
  477. package/.claude/skills/flow-verify/SKILL.md +0 -53
  478. package/.claude/skills/flow-verify/context.jsonl +0 -5
  479. package/.claude/skills/fractal-docs/SKILL.md +0 -45
  480. package/.claude/skills/journey-checker/SKILL.md +0 -199
  481. package/.claude/skills/journey-checker/pressure-scenarios.md +0 -164
  482. package/.claude/skills/receiving-review/SKILL.md +0 -153
  483. package/.claude/skills/skill-creator/LICENSE.txt +0 -202
  484. package/.claude/skills/skill-creator/SKILL.md +0 -356
  485. package/.claude/skills/skill-creator/references/output-patterns.md +0 -82
  486. package/.claude/skills/skill-creator/references/workflows.md +0 -28
  487. package/.claude/skills/skill-creator/scripts/init_skill.py +0 -303
  488. package/.claude/skills/skill-creator/scripts/package_skill.py +0 -110
  489. package/.claude/skills/skill-creator/scripts/quick_validate.py +0 -95
  490. package/.claude/skills/skill-rules.json +0 -359
  491. package/.claude/skills/tdd/SKILL.md +0 -218
  492. package/.claude/skills/tdd-enforcer/SKILL.md +0 -192
  493. package/.claude/skills/utility/npm-release/CLAUDE.md +0 -55
  494. package/.claude/skills/utility/npm-release/SKILL.md +0 -379
  495. package/.claude/skills/utility/npm-release/references/version-decision-guide.md +0 -134
  496. package/.claude/skills/utility/npm-release/scripts/atomic-version-bump.sh +0 -95
  497. package/.claude/skills/utility/npm-release/scripts/validate-version-sync.sh +0 -82
  498. package/.claude/skills/utility/npm-release/scripts/version-decision-tree.sh +0 -44
  499. package/.claude/skills/verification/SKILL.md +0 -158
  500. package/.claude/skills/workflow.yaml +0 -219
  501. package/.claude/tests/README.md +0 -300
  502. package/.claude/tests/TODO.md +0 -69
  503. package/.claude/tests/__pycache__/test_analyze_upgrade_impact.cpython-311-pytest-7.2.2.pyc +0 -0
  504. package/.claude/tests/__pycache__/test_consolidate_research.cpython-311-pytest-7.2.2.pyc +0 -0
  505. package/.claude/tests/__pycache__/test_export_contracts.cpython-311-pytest-7.2.2.pyc +0 -0
  506. package/.claude/tests/__pycache__/test_extract_data_model.cpython-311-pytest-7.2.2.pyc +0 -0
  507. package/.claude/tests/__pycache__/test_generate_quickstart.cpython-311-pytest-7.2.2.pyc +0 -0
  508. package/.claude/tests/__pycache__/test_generate_research_tasks.cpython-311-pytest-7.2.2.pyc +0 -0
  509. package/.claude/tests/constitution/run_all_constitution_tests.sh +0 -111
  510. package/.claude/tests/constitution/test_agent_assignment.sh +0 -207
  511. package/.claude/tests/constitution/test_article_coverage.sh +0 -201
  512. package/.claude/tests/constitution/test_template_completeness.sh +0 -150
  513. package/.claude/tests/constitution/test_version_consistency.sh +0 -120
  514. package/.claude/tests/fixtures/spec_delta_full.md +0 -16
  515. package/.claude/tests/fixtures/tasks_progress_sample.md +0 -5
  516. package/.claude/tests/run-all-tests.sh +0 -229
  517. package/.claude/tests/scripts/run.sh +0 -30
  518. package/.claude/tests/scripts/test-framework.sh +0 -128
  519. package/.claude/tests/scripts/test_check_prerequisites.sh +0 -511
  520. package/.claude/tests/scripts/test_check_prerequisites.sh.bak +0 -504
  521. package/.claude/tests/scripts/test_check_prerequisites.sh.bak2 +0 -505
  522. package/.claude/tests/scripts/test_check_prerequisites.sh.bak3 +0 -506
  523. package/.claude/tests/scripts/test_check_prerequisites.sh.bak4 +0 -507
  524. package/.claude/tests/scripts/test_check_prerequisites.sh.bak5 +0 -508
  525. package/.claude/tests/scripts/test_check_task_status.sh +0 -499
  526. package/.claude/tests/scripts/test_common.sh +0 -244
  527. package/.claude/tests/scripts/test_generate_status_report.sh +0 -71
  528. package/.claude/tests/scripts/test_mark_task_complete.sh +0 -441
  529. package/.claude/tests/scripts/test_mark_task_complete.sh.backup +0 -410
  530. package/.claude/tests/scripts/test_recover_workflow.sh +0 -304
  531. package/.claude/tests/scripts/test_setup_epic.sh +0 -437
  532. package/.claude/tests/scripts/test_sync_task_marks.sh +0 -196
  533. package/.claude/tests/scripts/test_validate_constitution.sh +0 -74
  534. package/.claude/tests/scripts/test_validate_research.sh +0 -462
  535. package/.claude/tests/slugify.bats +0 -82
  536. package/.claude/tests/test-framework.sh +0 -732
  537. package/.claude/tests/test_analyze_upgrade_impact.py +0 -34
  538. package/.claude/tests/test_consolidate_research.py +0 -48
  539. package/.claude/tests/test_export_contracts.py +0 -43
  540. package/.claude/tests/test_extract_data_model.py +0 -33
  541. package/.claude/tests/test_generate_quickstart.py +0 -50
  542. package/.claude/tests/test_generate_research_tasks.py +0 -52
  543. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/affected-repos.txt +0 -1
  544. package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/edited-files.log +0 -2
  545. package/bin/harness.js +0 -22
  546. package/docs/commands/core-roadmap.md +0 -106
  547. package/docs/commands/core-roadmap.zh-CN.md +0 -102
  548. package/docs/commands/core-style.md +0 -53
  549. package/docs/commands/core-style.zh-CN.md +0 -53
  550. package/docs/commands/flow-init.md +0 -140
  551. package/docs/commands/flow-init.zh-CN.md +0 -169
  552. package/docs/commands/flow-new.md +0 -39
  553. package/docs/commands/flow-new.zh-CN.md +0 -39
  554. package/lib/compiler/__tests__/compile-regression.test.js +0 -103
  555. package/lib/compiler/__tests__/multi-module-emitters.test.js +0 -534
  556. package/lib/compiler/__tests__/resource-copier.test.js +0 -26
  557. package/lib/compiler/__tests__/skill-discovery.test.js +0 -72
  558. package/lib/compiler/context-expander.js +0 -179
  559. package/lib/compiler/rules-emitters/__tests__/codex-rules-emitter.test.js +0 -109
  560. package/lib/compiler/rules-emitters/codex-rules-emitter.js +0 -116
  561. package/lib/compiler/skill-discovery.js +0 -68
  562. package/lib/harness/CLAUDE.md +0 -22
  563. package/lib/harness/__tests__/planner.tdd.test.js +0 -125
  564. package/lib/harness/cli.js +0 -208
  565. package/lib/harness/index.js +0 -18
  566. package/lib/harness/operations/dispatch.js +0 -298
  567. package/lib/harness/operations/init.js +0 -48
  568. package/lib/harness/operations/pack.js +0 -100
  569. package/lib/harness/operations/plan.js +0 -83
  570. package/lib/harness/operations/release.js +0 -170
  571. package/lib/harness/operations/resume.js +0 -44
  572. package/lib/harness/operations/verify.js +0 -177
  573. package/lib/harness/planner.js +0 -272
  574. package/lib/harness/query.js +0 -126
  575. package/lib/harness/schemas.js +0 -129
@@ -1,232 +0,0 @@
1
- #!/usr/bin/env bash
2
-
3
- # Consolidated prerequisite checking script for cc-devflow
4
- #
5
- # This script provides unified prerequisite checking for development workflow.
6
- # Based on spec-kit design principles with cc-devflow enhancements.
7
- #
8
- # Usage: ./check-prerequisites.sh [OPTIONS]
9
- #
10
- # OPTIONS:
11
- # --json Output in JSON format
12
- # --require-epic Require EPIC.md to exist (for task generation phase)
13
- # --require-tasks Require tasks/ to exist (for implementation phase)
14
- # --include-tasks Include tasks/ in AVAILABLE_DOCS list
15
- # --paths-only Only output path variables (no validation)
16
- # --help, -h Show help message
17
- #
18
- # OUTPUTS:
19
- # JSON mode: {"REQ_ID":"...", "REQ_DIR":"...", "AVAILABLE_DOCS":["..."]}
20
- # Text mode: REQ_ID:... \n REQ_DIR:... \n AVAILABLE_DOCS: \n ✓/✗ file.md
21
- # Paths only: REPO_ROOT: ... \n REQ_ID: ... \n REQ_DIR: ... etc.
22
-
23
- set -e
24
-
25
- # Parse command line arguments
26
- JSON_MODE=false
27
- REQUIRE_EPIC=false
28
- REQUIRE_TASKS=false
29
- INCLUDE_TASKS=false
30
- PATHS_ONLY=false
31
-
32
- for arg in "$@"; do
33
- case "$arg" in
34
- --json)
35
- JSON_MODE=true
36
- ;;
37
- --require-epic)
38
- REQUIRE_EPIC=true
39
- ;;
40
- --require-tasks)
41
- REQUIRE_TASKS=true
42
- ;;
43
- --include-tasks)
44
- INCLUDE_TASKS=true
45
- ;;
46
- --paths-only)
47
- PATHS_ONLY=true
48
- ;;
49
- --help|-h)
50
- cat << 'EOF'
51
- Usage: check-prerequisites.sh [OPTIONS]
52
-
53
- Consolidated prerequisite checking for cc-devflow workflow.
54
-
55
- OPTIONS:
56
- --json Output in JSON format
57
- --require-epic Require EPIC.md to exist (for task generation phase)
58
- --require-tasks Require tasks/ to exist (for implementation phase)
59
- --include-tasks Include tasks/ in AVAILABLE_DOCS list
60
- --paths-only Only output path variables (no prerequisite validation)
61
- --help, -h Show this help message
62
-
63
- EXAMPLES:
64
- # Check planning prerequisites (PRD.md required)
65
- ./check-prerequisites.sh --json
66
-
67
- # Check task generation prerequisites (PRD.md + EPIC.md required)
68
- ./check-prerequisites.sh --json --require-epic
69
-
70
- # Check implementation prerequisites (PRD.md + EPIC.md + tasks/ required)
71
- ./check-prerequisites.sh --json --require-epic --require-tasks --include-tasks
72
-
73
- # Get requirement paths only (no validation)
74
- ./check-prerequisites.sh --paths-only
75
-
76
- EOF
77
- exit 0
78
- ;;
79
- *)
80
- echo "ERROR: Unknown option '$arg'. Use --help for usage information." >&2
81
- exit 1
82
- ;;
83
- esac
84
- done
85
-
86
- # Source common functions
87
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
88
- source "$SCRIPT_DIR/common.sh"
89
-
90
- # Get requirement paths
91
- eval $(get_requirement_paths)
92
-
93
- # Validate requirement ID exists
94
- if [[ -z "$REQ_ID" ]]; then
95
- echo "ERROR: No requirement ID found" >&2
96
- echo "Please ensure you are on a feature branch (feature/REQ-XXX-title)" >&2
97
- echo "Or set DEVFLOW_REQ_ID environment variable" >&2
98
- exit 1
99
- fi
100
-
101
- # Validate requirement ID format
102
- validate_req_id "$REQ_ID" || exit 1
103
-
104
- # If paths-only mode, output paths and exit (support JSON + paths-only combined)
105
- if $PATHS_ONLY; then
106
- if $JSON_MODE; then
107
- # Minimal JSON paths payload (no validation performed)
108
- printf '{"%s":"%s","%s":"%s","%s":"%s","%s":"%s","%s":"%s","%s":"%s"}\n' \
109
- "REPO_ROOT" "$REPO_ROOT" \
110
- "REQ_ID" "$REQ_ID" \
111
- "REQ_TYPE" "$REQ_TYPE" \
112
- "REQ_DIR" "$REQ_DIR" \
113
- "PRD_FILE" "$PRD_FILE" \
114
- "EPIC_FILE" "$EPIC_FILE"
115
- else
116
- echo "REPO_ROOT: $REPO_ROOT"
117
- echo "REQ_ID: $REQ_ID"
118
- echo "REQ_TYPE: $REQ_TYPE"
119
- echo "REQ_DIR: $REQ_DIR"
120
- echo "PRD_FILE: $PRD_FILE"
121
- echo "EPIC_FILE: $EPIC_FILE"
122
- fi
123
- exit 0
124
- fi
125
-
126
- # Validate required directories and files
127
- if [[ ! -d "$REQ_DIR" ]]; then
128
- echo "ERROR: Requirement directory not found: $REQ_DIR" >&2
129
- echo "Run /flow:init first to create the requirement structure." >&2
130
- exit 1
131
- fi
132
-
133
- if [[ ! -f "$PRD_FILE" ]]; then
134
- echo "ERROR: PRD.md not found in $REQ_DIR" >&2
135
- echo "Run prd-writer agent first to create the PRD." >&2
136
- exit 1
137
- fi
138
-
139
- # Check for EPIC.md if required
140
- if $REQUIRE_EPIC && [[ ! -f "$EPIC_FILE" ]]; then
141
- echo "ERROR: EPIC.md not found in $REQ_DIR" >&2
142
- echo "Run planner agent first to create the Epic." >&2
143
- exit 1
144
- fi
145
-
146
- # Check for tasks/ or TASKS.md if required
147
- # Support both tasks/ directory (old format) and TASKS.md file (new format)
148
- if $REQUIRE_TASKS; then
149
- TASKS_FILE="$REQ_DIR/TASKS.md"
150
- if [[ ! -d "$TASKS_DIR" || -z "$(ls -A "$TASKS_DIR" 2>/dev/null)" ]] && [[ ! -f "$TASKS_FILE" ]]; then
151
- echo "ERROR: Neither tasks/ directory nor TASKS.md file found in $REQ_DIR" >&2
152
- echo "Run planner agent first to create the task breakdown." >&2
153
- exit 1
154
- fi
155
- fi
156
-
157
- # Build list of available documents
158
- docs=()
159
-
160
- # Check optional docs
161
- [[ -d "$RESEARCH_DIR" && -n "$(ls -A "$RESEARCH_DIR" 2>/dev/null)" ]] && docs+=("research/")
162
- [[ -f "$TEST_PLAN_FILE" ]] && docs+=("TEST_PLAN.md")
163
- [[ -f "$SECURITY_PLAN_FILE" ]] && docs+=("SECURITY_PLAN.md")
164
- [[ -f "$TEST_REPORT_FILE" ]] && docs+=("TEST_REPORT.md")
165
- [[ -f "$SECURITY_REPORT_FILE" ]] && docs+=("SECURITY_REPORT.md")
166
- [[ -f "$RELEASE_PLAN_FILE" ]] && docs+=("RELEASE_PLAN.md")
167
- [[ -f "$LOG_FILE" ]] && docs+=("EXECUTION_LOG.md")
168
-
169
- # Include tasks/ or TASKS.md if requested and it exists
170
- # Support both tasks/ directory (old format) and TASKS.md file (new format)
171
- if $INCLUDE_TASKS; then
172
- TASKS_FILE="$REQ_DIR/TASKS.md"
173
- if [[ -d "$TASKS_DIR" && -n "$(ls -A "$TASKS_DIR" 2>/dev/null)" ]]; then
174
- docs+=("tasks/")
175
- elif [[ -f "$TASKS_FILE" ]]; then
176
- docs+=("TASKS.md")
177
- fi
178
- fi
179
-
180
- # For BUG type, check BUG-specific files
181
- if [[ "$REQ_TYPE" == "bug" ]]; then
182
- [[ -f "$ANALYSIS_FILE" ]] && docs+=("ANALYSIS.md")
183
- [[ -f "$PLAN_FILE" ]] && docs+=("PLAN.md")
184
- fi
185
-
186
- # Output results
187
- if $JSON_MODE; then
188
- # Build JSON array of documents
189
- if [[ ${#docs[@]} -eq 0 ]]; then
190
- json_docs="[]"
191
- else
192
- json_docs=$(printf '"%s",' "${docs[@]}")
193
- json_docs="[${json_docs%,}]"
194
- fi
195
-
196
- printf '{"%s":"%s","%s":"%s","%s":"%s","%s":%s}\n' \
197
- "REQ_ID" "$REQ_ID" \
198
- "REQ_TYPE" "$REQ_TYPE" \
199
- "REQ_DIR" "$REQ_DIR" \
200
- "AVAILABLE_DOCS" "$json_docs"
201
- else
202
- # Text output
203
- echo "REQ_ID: $REQ_ID"
204
- echo "REQ_TYPE: $REQ_TYPE"
205
- echo "REQ_DIR: $REQ_DIR"
206
- echo "AVAILABLE_DOCS:"
207
-
208
- # Show status of each potential document
209
- check_dir "$RESEARCH_DIR" "research/"
210
- check_file "$TEST_PLAN_FILE" "TEST_PLAN.md"
211
- check_file "$SECURITY_PLAN_FILE" "SECURITY_PLAN.md"
212
- check_file "$TEST_REPORT_FILE" "TEST_REPORT.md"
213
- check_file "$SECURITY_REPORT_FILE" "SECURITY_REPORT.md"
214
- check_file "$RELEASE_PLAN_FILE" "RELEASE_PLAN.md"
215
- check_file "$LOG_FILE" "EXECUTION_LOG.md"
216
-
217
- if $INCLUDE_TASKS; then
218
- TASKS_FILE="$REQ_DIR/TASKS.md"
219
- # Check for tasks/ directory first, fallback to TASKS.md
220
- if [[ -d "$TASKS_DIR" && -n "$(ls -A "$TASKS_DIR" 2>/dev/null)" ]]; then
221
- check_dir "$TASKS_DIR" "tasks/"
222
- else
223
- check_file "$TASKS_FILE" "TASKS.md"
224
- fi
225
- fi
226
-
227
- # BUG-specific files
228
- if [[ "$REQ_TYPE" == "bug" ]]; then
229
- check_file "$ANALYSIS_FILE" "ANALYSIS.md"
230
- check_file "$PLAN_FILE" "PLAN.md"
231
- fi
232
- fi
@@ -1,288 +0,0 @@
1
- #!/usr/bin/env bash
2
-
3
- # Check task completion status in TASKS.md
4
- #
5
- # This script checks the status of tasks in TASKS.md and provides
6
- # progress information.
7
- #
8
- # Usage: ./check-task-status.sh [TASK_ID] [OPTIONS]
9
- #
10
- # ARGUMENTS:
11
- # TASK_ID Optional specific task ID to check (e.g., T001)
12
- #
13
- # OPTIONS:
14
- # --json Output in JSON format
15
- # --verbose Show detailed task information
16
- # --help, -h Show help message
17
- #
18
- # EXAMPLES:
19
- # ./check-task-status.sh # Show overall progress
20
- # ./check-task-status.sh T001 # Check specific task
21
- # ./check-task-status.sh --json # JSON output
22
- # ./check-task-status.sh --verbose # Detailed task list
23
-
24
- set -e
25
-
26
- # Parse command line arguments
27
- TASK_ID=""
28
- JSON_MODE=false
29
- VERBOSE=false
30
-
31
- count_matches() {
32
- local pattern="$1"
33
- local file="$2"
34
- local count
35
- count=$(grep -c "$pattern" "$file" 2>/dev/null || true)
36
- count=${count//[[:space:]]/}
37
- printf '%s' "${count:-0}"
38
- }
39
-
40
- count_phase_tasks() {
41
- local header="$1"
42
- local mode="$2"
43
- local file="$3"
44
- awk -v header="$header" -v mode="$mode" '
45
- $0 ~ header {in_section=1; next}
46
- in_section && /^## / {exit}
47
- in_section {
48
- if (mode == "all" && $0 ~ /^- \[/) {count++}
49
- if (mode == "complete" && $0 ~ /^- \[x\]/) {count++}
50
- }
51
- END {print count+0}
52
- ' "$file"
53
- }
54
-
55
- while [[ $# -gt 0 ]]; do
56
- case "$1" in
57
- --json)
58
- JSON_MODE=true
59
- shift
60
- ;;
61
- --verbose|-v)
62
- VERBOSE=true
63
- shift
64
- ;;
65
- --help|-h)
66
- cat << 'EOF'
67
- Usage: check-task-status.sh [TASK_ID] [OPTIONS]
68
-
69
- Check task completion status in TASKS.md.
70
-
71
- ARGUMENTS:
72
- TASK_ID Optional specific task ID to check (e.g., T001)
73
-
74
- OPTIONS:
75
- --json Output results in JSON format
76
- --verbose, -v Show detailed task information
77
- --help, -h Show this help message
78
-
79
- EXAMPLES:
80
- # Show overall progress
81
- ./check-task-status.sh
82
-
83
- # Check specific task status
84
- ./check-task-status.sh T001
85
-
86
- # JSON output for automation
87
- ./check-task-status.sh --json
88
-
89
- # Detailed task list
90
- ./check-task-status.sh --verbose
91
-
92
- OUTPUT:
93
- - Overall progress (completed vs remaining)
94
- - Phase breakdown
95
- - Next pending task
96
- - Specific task status (if TASK_ID provided)
97
-
98
- EOF
99
- exit 0
100
- ;;
101
- -*)
102
- echo "ERROR: Unknown option '$1'. Use --help for usage information." >&2
103
- exit 1
104
- ;;
105
- *)
106
- if [[ -z "$TASK_ID" ]]; then
107
- TASK_ID="$1"
108
- else
109
- echo "ERROR: Too many arguments. Use --help for usage information." >&2
110
- exit 1
111
- fi
112
- shift
113
- ;;
114
- esac
115
- done
116
-
117
- # Normalize task ID to uppercase if provided
118
- if [[ -n "$TASK_ID" ]]; then
119
- TASK_ID=$(echo "$TASK_ID" | tr '[:lower:]' '[:upper:]')
120
-
121
- # Validate task ID format
122
- if [[ ! "$TASK_ID" =~ ^T[0-9]+$ ]]; then
123
- echo "ERROR: Invalid task ID format: $TASK_ID" >&2
124
- echo "Expected format: T001, T002, T003..." >&2
125
- exit 1
126
- fi
127
- fi
128
-
129
- # Source common functions
130
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
131
- source "$SCRIPT_DIR/common.sh"
132
-
133
- # Get all paths
134
- eval $(get_requirement_paths)
135
-
136
- # Validate requirement ID exists
137
- if [[ -z "$REQ_ID" ]]; then
138
- echo "ERROR: No requirement ID found" >&2
139
- echo "Please ensure you are on a feature branch (feature/REQ-XXX-title)" >&2
140
- echo "Or set DEVFLOW_REQ_ID environment variable" >&2
141
- exit 1
142
- fi
143
-
144
- # Validate requirement directory exists
145
- if [[ ! -d "$REQ_DIR" ]]; then
146
- echo "ERROR: Requirement directory not found: $REQ_DIR" >&2
147
- exit 1
148
- fi
149
-
150
- # Check for TASKS.md file
151
- TASKS_FILE="$REQ_DIR/TASKS.md"
152
- if [[ ! -f "$TASKS_FILE" ]]; then
153
- echo "ERROR: TASKS.md not found at $TASKS_FILE" >&2
154
- echo "Run planner agent first to create tasks." >&2
155
- exit 1
156
- fi
157
-
158
- # Count tasks
159
- TOTAL_INCOMPLETE=$(count_matches "^\- \[ \]" "$TASKS_FILE")
160
- TOTAL_COMPLETE=$(count_matches "^\- \[x\]" "$TASKS_FILE")
161
- TOTAL_TASKS=$((TOTAL_INCOMPLETE + TOTAL_COMPLETE))
162
-
163
- # Calculate percentage
164
- if [[ $TOTAL_TASKS -gt 0 ]]; then
165
- PERCENTAGE=$((TOTAL_COMPLETE * 100 / TOTAL_TASKS))
166
- else
167
- PERCENTAGE=0
168
- fi
169
-
170
- # If specific task requested, check its status
171
- if [[ -n "$TASK_ID" ]]; then
172
- if grep -q "^\- \[x\] .*$TASK_ID" "$TASKS_FILE"; then
173
- STATUS="complete"
174
- TASK_LINE=$(grep "^\- \[x\] .*$TASK_ID" "$TASKS_FILE" | head -1)
175
- elif grep -q "^\- \[ \] .*$TASK_ID" "$TASKS_FILE"; then
176
- STATUS="pending"
177
- TASK_LINE=$(grep "^\- \[ \] .*$TASK_ID" "$TASKS_FILE" | head -1)
178
- else
179
- STATUS="not_found"
180
- TASK_LINE=""
181
- fi
182
-
183
- if $JSON_MODE; then
184
- printf '{"task_id":"%s","status":"%s","task_line":"%s"}\n' \
185
- "$TASK_ID" "$STATUS" "$TASK_LINE"
186
- else
187
- case "$STATUS" in
188
- complete)
189
- echo "✅ Task $TASK_ID is complete"
190
- echo " $TASK_LINE"
191
- ;;
192
- pending)
193
- echo "⏳ Task $TASK_ID is pending"
194
- echo " $TASK_LINE"
195
- ;;
196
- not_found)
197
- echo "❌ Task $TASK_ID not found"
198
- exit 1
199
- ;;
200
- esac
201
- fi
202
- exit 0
203
- fi
204
-
205
- # Find next pending task
206
- NEXT_TASK=$(grep "^\- \[ \]" "$TASKS_FILE" | head -1 || echo "")
207
- if [[ -n "$NEXT_TASK" ]]; then
208
- # Extract task ID from line (matches T001, T002, etc.)
209
- NEXT_TASK_ID=$(echo "$NEXT_TASK" | grep -o 'T[0-9]\+' | head -1)
210
- else
211
- NEXT_TASK_ID=""
212
- fi
213
-
214
- # Get phase breakdown - ensure all values are clean integers
215
- if grep -q "^## Phase 1:" "$TASKS_FILE" 2>/dev/null; then
216
- PHASE_1_TOTAL=$(count_phase_tasks "^## Phase 1:" "all" "$TASKS_FILE")
217
- PHASE_1_COMPLETE=$(count_phase_tasks "^## Phase 1:" "complete" "$TASKS_FILE")
218
- else
219
- PHASE_1_TOTAL=0
220
- PHASE_1_COMPLETE=0
221
- fi
222
-
223
- if grep -q "^## Phase 2:" "$TASKS_FILE" 2>/dev/null; then
224
- PHASE_2_TOTAL=$(count_phase_tasks "^## Phase 2:" "all" "$TASKS_FILE")
225
- PHASE_2_COMPLETE=$(count_phase_tasks "^## Phase 2:" "complete" "$TASKS_FILE")
226
- else
227
- PHASE_2_TOTAL=0
228
- PHASE_2_COMPLETE=0
229
- fi
230
-
231
- if grep -q "^## Phase 3:" "$TASKS_FILE" 2>/dev/null; then
232
- PHASE_3_TOTAL=$(count_phase_tasks "^## Phase 3:" "all" "$TASKS_FILE")
233
- PHASE_3_COMPLETE=$(count_phase_tasks "^## Phase 3:" "complete" "$TASKS_FILE")
234
- else
235
- PHASE_3_TOTAL=0
236
- PHASE_3_COMPLETE=0
237
- fi
238
-
239
- # Output results
240
- if $JSON_MODE; then
241
- # JSON output
242
- printf '{"req_id":"%s","total_tasks":%d,"completed":%d,"remaining":%d,"percentage":%d,"next_task_id":"%s","phases":{"phase_1":{"total":%d,"complete":%d},"phase_2":{"total":%d,"complete":%d},"phase_3":{"total":%d,"complete":%d}}}\n' \
243
- "$REQ_ID" "$TOTAL_TASKS" "$TOTAL_COMPLETE" "$TOTAL_INCOMPLETE" "$PERCENTAGE" "$NEXT_TASK_ID" \
244
- "$PHASE_1_TOTAL" "$PHASE_1_COMPLETE" \
245
- "$PHASE_2_TOTAL" "$PHASE_2_COMPLETE" \
246
- "$PHASE_3_TOTAL" "$PHASE_3_COMPLETE"
247
- else
248
- # Human-readable output
249
- echo "Task Status for $REQ_ID"
250
- echo "════════════════════════════════════════"
251
- echo ""
252
- echo "Overall Progress:"
253
- echo " ✅ Completed: $TOTAL_COMPLETE"
254
- echo " ⏳ Remaining: $TOTAL_INCOMPLETE"
255
- echo " 📊 Progress: $PERCENTAGE%"
256
- echo ""
257
-
258
- if [[ -n "$NEXT_TASK_ID" ]]; then
259
- echo "Next Task: $NEXT_TASK_ID"
260
- echo " $NEXT_TASK"
261
- echo ""
262
- else
263
- echo "🎉 All tasks complete!"
264
- echo ""
265
- fi
266
-
267
- # Phase breakdown
268
- if [[ $PHASE_1_TOTAL -gt 0 || $PHASE_2_TOTAL -gt 0 || $PHASE_3_TOTAL -gt 0 ]]; then
269
- echo "Phase Breakdown:"
270
- if [[ $PHASE_1_TOTAL -gt 0 ]]; then
271
- echo " Phase 1 (Setup): $PHASE_1_COMPLETE / $PHASE_1_TOTAL"
272
- fi
273
- if [[ $PHASE_2_TOTAL -gt 0 ]]; then
274
- echo " Phase 2 (Tests First): $PHASE_2_COMPLETE / $PHASE_2_TOTAL"
275
- fi
276
- if [[ $PHASE_3_TOTAL -gt 0 ]]; then
277
- echo " Phase 3 (Implementation): $PHASE_3_COMPLETE / $PHASE_3_TOTAL"
278
- fi
279
- echo ""
280
- fi
281
-
282
- # Verbose mode: show all tasks
283
- if $VERBOSE; then
284
- echo "All Tasks:"
285
- echo "────────────────────────────────────────"
286
- grep "^\- \[" "$TASKS_FILE"
287
- fi
288
- fi
@@ -1,131 +0,0 @@
1
- #!/usr/bin/env bash
2
- # ============================================================================
3
- # checklist-errors.sh
4
- # ============================================================================
5
- # Error codes and messages for checklist gate and related hooks
6
- #
7
- # Usage: source this file in scripts that need checklist error handling
8
- #
9
- # Reference: TECH_DESIGN.md Section 4.4, contracts/command-interface.md Section 4
10
- # ============================================================================
11
-
12
- # ============================================================================
13
- # Error Codes
14
- # ============================================================================
15
-
16
- # PRD.md not found in requirement directory
17
- export ERR_MISSING_PRD="MISSING_PRD"
18
-
19
- # Invalid checklist type specified
20
- export ERR_INVALID_TYPE="INVALID_TYPE"
21
-
22
- # No checklists found in directory
23
- export ERR_NO_CHECKLISTS="NO_CHECKLISTS"
24
-
25
- # Checklist item ID not found
26
- export ERR_ITEM_NOT_FOUND="ITEM_NOT_FOUND"
27
-
28
- # Checklist completion below gate threshold
29
- export ERR_GATE_FAILED="GATE_FAILED"
30
-
31
- # Skip reason required but not provided
32
- export ERR_SKIP_REASON_REQUIRED="SKIP_REASON_REQUIRED"
33
-
34
- # ============================================================================
35
- # Valid Checklist Types (R001 Decision)
36
- # ============================================================================
37
- export VALID_CHECKLIST_TYPES="ux,api,security,performance,data,general"
38
-
39
- # ============================================================================
40
- # Error Message Functions
41
- # ============================================================================
42
-
43
- # Print error message to stderr
44
- # Usage: print_error "ERROR_CODE" "additional message"
45
- print_checklist_error() {
46
- local code="$1"
47
- local extra="${2:-}"
48
-
49
- case "$code" in
50
- "$ERR_MISSING_PRD")
51
- echo "ERROR: $code" >&2
52
- echo "PRD.md not found in requirement directory." >&2
53
- echo "" >&2
54
- echo "Run /flow:spec first." >&2
55
- ;;
56
- "$ERR_INVALID_TYPE")
57
- echo "ERROR: $code" >&2
58
- echo "Invalid checklist type: $extra" >&2
59
- echo "" >&2
60
- echo "Valid types: $VALID_CHECKLIST_TYPES" >&2
61
- ;;
62
- "$ERR_NO_CHECKLISTS")
63
- echo "ERROR: $code" >&2
64
- echo "No checklists found in checklists/ directory." >&2
65
- echo "" >&2
66
- echo "Run /flow:verify --strict first." >&2
67
- ;;
68
- "$ERR_ITEM_NOT_FOUND")
69
- echo "WARNING: $code" >&2
70
- echo "Checklist item not found: $extra. Skipped." >&2
71
- ;;
72
- "$ERR_GATE_FAILED")
73
- echo "ERROR: $code" >&2
74
- echo "Checklist completion $extra" >&2
75
- echo "" >&2
76
- echo "Run /flow:verify --strict to review incomplete items." >&2
77
- echo "Or use --skip-gate --reason \"your reason\" to bypass." >&2
78
- ;;
79
- "$ERR_SKIP_REASON_REQUIRED")
80
- echo "ERROR: $code" >&2
81
- echo "--reason is required when using --skip-gate" >&2
82
- echo "" >&2
83
- echo "Usage: --skip-gate --reason \"your reason\"" >&2
84
- ;;
85
- *)
86
- echo "ERROR: Unknown error code: $code" >&2
87
- if [[ -n "$extra" ]]; then
88
- echo "$extra" >&2
89
- fi
90
- ;;
91
- esac
92
- }
93
-
94
- # Return JSON error object
95
- # Usage: json_error "ERROR_CODE" "message"
96
- json_checklist_error() {
97
- local code="$1"
98
- local message="$2"
99
- echo "{\"error\": \"$code\", \"message\": \"$message\"}"
100
- }
101
-
102
- # ============================================================================
103
- # Validation Functions
104
- # ============================================================================
105
-
106
- # Validate checklist type
107
- # Usage: validate_checklist_type "ux" && echo "valid"
108
- validate_checklist_type() {
109
- local type="$1"
110
- if [[ ",$VALID_CHECKLIST_TYPES," == *",$type,"* ]]; then
111
- return 0
112
- else
113
- return 1
114
- fi
115
- }
116
-
117
- # Validate checklist item ID format (CHK + 3 digits)
118
- # Usage: validate_item_id "CHK001" && echo "valid"
119
- validate_item_id() {
120
- local id="$1"
121
- if [[ "$id" =~ ^CHK[0-9]{3}$ ]]; then
122
- return 0
123
- else
124
- return 1
125
- fi
126
- }
127
-
128
- # ============================================================================
129
- # Gate Threshold Constants
130
- # ============================================================================
131
- export DEFAULT_GATE_THRESHOLD=80