@su-record/vibe 2.7.18 → 2.7.20

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 (345) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +153 -153
  3. package/LICENSE +21 -21
  4. package/README.md +451 -449
  5. package/agents/architect-low.md +41 -41
  6. package/agents/architect-medium.md +59 -59
  7. package/agents/architect.md +80 -80
  8. package/agents/build-error-resolver.md +115 -115
  9. package/agents/compounder.md +261 -261
  10. package/agents/diagrammer.md +178 -178
  11. package/agents/docs/api-documenter.md +99 -99
  12. package/agents/docs/changelog-writer.md +93 -93
  13. package/agents/e2e-tester.md +294 -294
  14. package/agents/event/event-comms.md +78 -0
  15. package/agents/event/event-content.md +68 -0
  16. package/agents/event/event-image.md +95 -0
  17. package/agents/event/event-ops.md +84 -0
  18. package/agents/event/event-scheduler.md +69 -0
  19. package/agents/event/event-speaker.md +86 -0
  20. package/agents/explorer-low.md +42 -42
  21. package/agents/explorer-medium.md +59 -59
  22. package/agents/explorer.md +48 -48
  23. package/agents/implementer-low.md +43 -43
  24. package/agents/implementer-medium.md +52 -52
  25. package/agents/implementer.md +54 -54
  26. package/agents/junior-mentor.md +141 -141
  27. package/agents/planning/requirements-analyst.md +84 -84
  28. package/agents/planning/ux-advisor.md +83 -83
  29. package/agents/qa/acceptance-tester.md +86 -86
  30. package/agents/qa/edge-case-finder.md +93 -93
  31. package/agents/refactor-cleaner.md +143 -143
  32. package/agents/research/best-practices-agent.md +199 -199
  33. package/agents/research/codebase-patterns-agent.md +157 -157
  34. package/agents/research/framework-docs-agent.md +188 -188
  35. package/agents/research/security-advisory-agent.md +213 -213
  36. package/agents/review/architecture-reviewer.md +107 -107
  37. package/agents/review/complexity-reviewer.md +116 -116
  38. package/agents/review/data-integrity-reviewer.md +88 -88
  39. package/agents/review/git-history-reviewer.md +103 -103
  40. package/agents/review/performance-reviewer.md +86 -86
  41. package/agents/review/python-reviewer.md +150 -150
  42. package/agents/review/rails-reviewer.md +139 -139
  43. package/agents/review/react-reviewer.md +144 -144
  44. package/agents/review/security-reviewer.md +80 -80
  45. package/agents/review/simplicity-reviewer.md +140 -140
  46. package/agents/review/test-coverage-reviewer.md +116 -116
  47. package/agents/review/typescript-reviewer.md +127 -127
  48. package/agents/searcher.md +54 -54
  49. package/agents/simplifier.md +120 -120
  50. package/agents/tester.md +49 -49
  51. package/agents/ui/ui-a11y-auditor.md +93 -93
  52. package/agents/ui/ui-antipattern-detector.md +94 -94
  53. package/agents/ui/ui-dataviz-advisor.md +69 -69
  54. package/agents/ui/ui-design-system-gen.md +57 -57
  55. package/agents/ui/ui-industry-analyzer.md +49 -49
  56. package/agents/ui/ui-layout-architect.md +65 -65
  57. package/agents/ui/ui-stack-implementer.md +68 -68
  58. package/agents/ui/ux-compliance-reviewer.md +81 -81
  59. package/agents/ui-previewer.md +258 -258
  60. package/commands/vibe.analyze.md +379 -379
  61. package/commands/vibe.event.md +163 -0
  62. package/commands/vibe.review.md +607 -607
  63. package/commands/vibe.run.md +2217 -2124
  64. package/commands/vibe.spec.md +1195 -1195
  65. package/commands/vibe.spec.review.md +569 -569
  66. package/commands/vibe.trace.md +50 -0
  67. package/commands/vibe.utils.md +413 -413
  68. package/commands/vibe.verify.md +484 -484
  69. package/dist/__tests__/architecture.test.d.ts +2 -0
  70. package/dist/__tests__/architecture.test.d.ts.map +1 -0
  71. package/dist/__tests__/architecture.test.js +207 -0
  72. package/dist/__tests__/architecture.test.js.map +1 -0
  73. package/dist/cli/auth.js +3 -3
  74. package/dist/cli/auth.js.map +1 -1
  75. package/dist/cli/collaborator.js +52 -52
  76. package/dist/cli/commands/evolution.js +12 -12
  77. package/dist/cli/commands/info.d.ts.map +1 -1
  78. package/dist/cli/commands/info.js +45 -81
  79. package/dist/cli/commands/info.js.map +1 -1
  80. package/dist/cli/commands/init.js +5 -5
  81. package/dist/cli/commands/remove.js +14 -14
  82. package/dist/cli/commands/sentinel.js +27 -27
  83. package/dist/cli/commands/skills.js +5 -5
  84. package/dist/cli/commands/slack.js +10 -10
  85. package/dist/cli/commands/telegram.js +12 -12
  86. package/dist/cli/detect.d.ts.map +1 -1
  87. package/dist/cli/detect.js +55 -32
  88. package/dist/cli/detect.js.map +1 -1
  89. package/dist/cli/index.d.ts +1 -1
  90. package/dist/cli/index.d.ts.map +1 -1
  91. package/dist/cli/index.js +52 -52
  92. package/dist/cli/index.js.map +1 -1
  93. package/dist/cli/llm/claude-commands.js +16 -16
  94. package/dist/cli/llm/config.js +18 -18
  95. package/dist/cli/llm/gemini-commands.js +16 -16
  96. package/dist/cli/llm/gpt-commands.js +19 -19
  97. package/dist/cli/llm/help.js +21 -21
  98. package/dist/cli/postinstall/constants.d.ts.map +1 -1
  99. package/dist/cli/postinstall/constants.js +24 -0
  100. package/dist/cli/postinstall/constants.js.map +1 -1
  101. package/dist/cli/postinstall/cursor-agents.js +32 -32
  102. package/dist/cli/postinstall/cursor-rules.js +83 -83
  103. package/dist/cli/postinstall/cursor-skills.js +743 -743
  104. package/dist/cli/setup/Provisioner.js +42 -42
  105. package/dist/infra/lib/AutomationLevel.d.ts +48 -0
  106. package/dist/infra/lib/AutomationLevel.d.ts.map +1 -0
  107. package/dist/infra/lib/AutomationLevel.js +157 -0
  108. package/dist/infra/lib/AutomationLevel.js.map +1 -0
  109. package/dist/infra/lib/DecisionTracer.d.ts +81 -0
  110. package/dist/infra/lib/DecisionTracer.d.ts.map +1 -0
  111. package/dist/infra/lib/DecisionTracer.js +135 -0
  112. package/dist/infra/lib/DecisionTracer.js.map +1 -0
  113. package/dist/infra/lib/DeepInit.js +24 -24
  114. package/dist/infra/lib/InteractiveCheckpoint.d.ts +75 -0
  115. package/dist/infra/lib/InteractiveCheckpoint.d.ts.map +1 -0
  116. package/dist/infra/lib/InteractiveCheckpoint.js +179 -0
  117. package/dist/infra/lib/InteractiveCheckpoint.js.map +1 -0
  118. package/dist/infra/lib/IterationTracker.d.ts +44 -0
  119. package/dist/infra/lib/IterationTracker.d.ts.map +1 -1
  120. package/dist/infra/lib/IterationTracker.js +267 -12
  121. package/dist/infra/lib/IterationTracker.js.map +1 -1
  122. package/dist/infra/lib/LoopBreaker.d.ts +56 -0
  123. package/dist/infra/lib/LoopBreaker.d.ts.map +1 -0
  124. package/dist/infra/lib/LoopBreaker.js +109 -0
  125. package/dist/infra/lib/LoopBreaker.js.map +1 -0
  126. package/dist/infra/lib/PythonParser.js +108 -108
  127. package/dist/infra/lib/ReviewRace.js +96 -96
  128. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  129. package/dist/infra/lib/SkillQualityGate.js +9 -9
  130. package/dist/infra/lib/SkillRepository.js +159 -159
  131. package/dist/infra/lib/UltraQA.js +99 -99
  132. package/dist/infra/lib/VerificationLoop.d.ts +105 -0
  133. package/dist/infra/lib/VerificationLoop.d.ts.map +1 -0
  134. package/dist/infra/lib/VerificationLoop.js +189 -0
  135. package/dist/infra/lib/VerificationLoop.js.map +1 -0
  136. package/dist/infra/lib/__tests__/AutomationLevel.test.d.ts +2 -0
  137. package/dist/infra/lib/__tests__/AutomationLevel.test.d.ts.map +1 -0
  138. package/dist/infra/lib/__tests__/AutomationLevel.test.js +297 -0
  139. package/dist/infra/lib/__tests__/AutomationLevel.test.js.map +1 -0
  140. package/dist/infra/lib/__tests__/DecisionTracer.test.d.ts +2 -0
  141. package/dist/infra/lib/__tests__/DecisionTracer.test.d.ts.map +1 -0
  142. package/dist/infra/lib/__tests__/DecisionTracer.test.js +274 -0
  143. package/dist/infra/lib/__tests__/DecisionTracer.test.js.map +1 -0
  144. package/dist/infra/lib/__tests__/InteractiveCheckpoint.test.d.ts +2 -0
  145. package/dist/infra/lib/__tests__/InteractiveCheckpoint.test.d.ts.map +1 -0
  146. package/dist/infra/lib/__tests__/InteractiveCheckpoint.test.js +350 -0
  147. package/dist/infra/lib/__tests__/InteractiveCheckpoint.test.js.map +1 -0
  148. package/dist/infra/lib/__tests__/LoopBreaker.test.d.ts +2 -0
  149. package/dist/infra/lib/__tests__/LoopBreaker.test.d.ts.map +1 -0
  150. package/dist/infra/lib/__tests__/LoopBreaker.test.js +340 -0
  151. package/dist/infra/lib/__tests__/LoopBreaker.test.js.map +1 -0
  152. package/dist/infra/lib/__tests__/VerificationLoop.test.d.ts +2 -0
  153. package/dist/infra/lib/__tests__/VerificationLoop.test.d.ts.map +1 -0
  154. package/dist/infra/lib/__tests__/VerificationLoop.test.js +486 -0
  155. package/dist/infra/lib/__tests__/VerificationLoop.test.js.map +1 -0
  156. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  157. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  158. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  159. package/dist/infra/lib/autonomy/PolicyEngine.d.ts +3 -3
  160. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  161. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  162. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  163. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  164. package/dist/infra/lib/embedding/__tests__/EmbeddingProvider.test.js +4 -0
  165. package/dist/infra/lib/embedding/__tests__/EmbeddingProvider.test.js.map +1 -1
  166. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  167. package/dist/infra/lib/evolution/DeprecationDetector.d.ts +68 -0
  168. package/dist/infra/lib/evolution/DeprecationDetector.d.ts.map +1 -0
  169. package/dist/infra/lib/evolution/DeprecationDetector.js +207 -0
  170. package/dist/infra/lib/evolution/DeprecationDetector.js.map +1 -0
  171. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  172. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  173. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  174. package/dist/infra/lib/evolution/ParityTester.d.ts +74 -0
  175. package/dist/infra/lib/evolution/ParityTester.d.ts.map +1 -0
  176. package/dist/infra/lib/evolution/ParityTester.js +238 -0
  177. package/dist/infra/lib/evolution/ParityTester.js.map +1 -0
  178. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  179. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  180. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  181. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  182. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  183. package/dist/infra/lib/evolution/__tests__/deprecation.test.d.ts +2 -0
  184. package/dist/infra/lib/evolution/__tests__/deprecation.test.d.ts.map +1 -0
  185. package/dist/infra/lib/evolution/__tests__/deprecation.test.js +251 -0
  186. package/dist/infra/lib/evolution/__tests__/deprecation.test.js.map +1 -0
  187. package/dist/infra/lib/evolution/__tests__/parity.test.d.ts +2 -0
  188. package/dist/infra/lib/evolution/__tests__/parity.test.d.ts.map +1 -0
  189. package/dist/infra/lib/evolution/__tests__/parity.test.js +319 -0
  190. package/dist/infra/lib/evolution/__tests__/parity.test.js.map +1 -0
  191. package/dist/infra/lib/evolution/index.d.ts +4 -0
  192. package/dist/infra/lib/evolution/index.d.ts.map +1 -1
  193. package/dist/infra/lib/evolution/index.js +3 -0
  194. package/dist/infra/lib/evolution/index.js.map +1 -1
  195. package/dist/infra/lib/gemini/orchestration.js +5 -5
  196. package/dist/infra/lib/gpt/orchestration.js +4 -4
  197. package/dist/infra/lib/gpt/specializations.d.ts +1 -1
  198. package/dist/infra/lib/gpt/specializations.js +1 -1
  199. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  200. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  201. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  202. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  203. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  204. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  205. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  206. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  207. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts +6 -0
  208. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts.map +1 -1
  209. package/dist/infra/lib/telemetry/SkillTelemetry.js +11 -0
  210. package/dist/infra/lib/telemetry/SkillTelemetry.js.map +1 -1
  211. package/dist/infra/orchestrator/AgentManager.js +12 -12
  212. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  213. package/dist/infra/orchestrator/BackgroundManager.d.ts.map +1 -1
  214. package/dist/infra/orchestrator/BackgroundManager.js +2 -0
  215. package/dist/infra/orchestrator/BackgroundManager.js.map +1 -1
  216. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  217. package/dist/infra/orchestrator/PhasePipeline.js +1 -1
  218. package/dist/infra/orchestrator/PhasePipeline.js.map +1 -1
  219. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  220. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  221. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  222. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  223. package/dist/tools/index.d.ts +16 -19
  224. package/dist/tools/index.d.ts.map +1 -1
  225. package/dist/tools/index.js +15 -27
  226. package/dist/tools/index.js.map +1 -1
  227. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  228. package/dist/tools/memory/getMemoryGraph.js +12 -12
  229. package/dist/tools/memory/getSessionContext.js +9 -9
  230. package/dist/tools/memory/linkMemories.js +14 -14
  231. package/dist/tools/memory/listMemories.js +4 -4
  232. package/dist/tools/memory/recallMemory.js +4 -4
  233. package/dist/tools/memory/saveMemory.js +4 -4
  234. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  235. package/dist/tools/memory/startSession.js +1 -1
  236. package/dist/tools/memory/startSession.js.map +1 -1
  237. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  238. package/dist/tools/semantic/astGrep.test.js +6 -6
  239. package/dist/tools/spec/index.d.ts +0 -4
  240. package/dist/tools/spec/index.d.ts.map +1 -1
  241. package/dist/tools/spec/index.js +0 -4
  242. package/dist/tools/spec/index.js.map +1 -1
  243. package/dist/tools/spec/prdParser.test.js +171 -171
  244. package/dist/tools/spec/specGenerator.js +169 -169
  245. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  246. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  247. package/hooks/gemini-hooks.json +73 -73
  248. package/hooks/hooks.json +137 -137
  249. package/hooks/scripts/code-check.js +77 -77
  250. package/hooks/scripts/context-save.js +212 -212
  251. package/hooks/scripts/evolution-engine.js +69 -0
  252. package/hooks/scripts/hud-status.js +291 -291
  253. package/hooks/scripts/keyword-detector.js +214 -214
  254. package/hooks/scripts/llm-orchestrate.js +475 -475
  255. package/hooks/scripts/post-edit.js +32 -32
  256. package/hooks/scripts/pre-tool-guard.js +125 -125
  257. package/hooks/scripts/prompt-dispatcher.js +185 -185
  258. package/hooks/scripts/sentinel-guard.js +104 -104
  259. package/hooks/scripts/session-start.js +106 -106
  260. package/hooks/scripts/skill-injector.js +83 -0
  261. package/hooks/scripts/stop-notify.js +209 -209
  262. package/hooks/scripts/utils.js +100 -100
  263. package/languages/csharp-unity.md +515 -515
  264. package/languages/gdscript-godot.md +470 -470
  265. package/languages/ruby-rails.md +489 -489
  266. package/languages/typescript-angular.md +433 -433
  267. package/languages/typescript-astro.md +416 -416
  268. package/languages/typescript-electron.md +406 -406
  269. package/languages/typescript-nestjs.md +524 -524
  270. package/languages/typescript-svelte.md +407 -407
  271. package/languages/typescript-tauri.md +365 -365
  272. package/package.json +101 -123
  273. package/skills/agents-md/SKILL.md +120 -120
  274. package/skills/arch-guard/SKILL.md +180 -180
  275. package/skills/brand-assets/SKILL.md +146 -146
  276. package/skills/capability-loop/SKILL.md +167 -167
  277. package/skills/characterization-test/SKILL.md +206 -206
  278. package/skills/commerce-patterns/SKILL.md +63 -63
  279. package/skills/commit-push-pr/SKILL.md +75 -75
  280. package/skills/context7-usage/SKILL.md +105 -105
  281. package/skills/core-capabilities/SKILL.md +13 -13
  282. package/skills/e2e-commerce/SKILL.md +61 -61
  283. package/skills/event-comms/SKILL.md +161 -0
  284. package/skills/event-ops/SKILL.md +197 -0
  285. package/skills/event-planning/SKILL.md +131 -0
  286. package/skills/exec-plan/SKILL.md +147 -147
  287. package/skills/frontend-design/SKILL.md +12 -12
  288. package/skills/git-worktree/SKILL.md +72 -72
  289. package/skills/handoff/SKILL.md +109 -109
  290. package/skills/parallel-research/SKILL.md +87 -87
  291. package/skills/priority-todos/SKILL.md +63 -63
  292. package/skills/seo-checklist/SKILL.md +57 -57
  293. package/skills/techdebt/SKILL.md +122 -122
  294. package/skills/tool-fallback/SKILL.md +103 -103
  295. package/skills/typescript-advanced-types/SKILL.md +66 -66
  296. package/skills/ui-ux-pro-max/SKILL.md +221 -221
  297. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  298. package/skills/video-production/SKILL.md +51 -51
  299. package/vibe/config.json +29 -29
  300. package/vibe/constitution.md +227 -227
  301. package/vibe/rules/principles/communication-guide.md +98 -98
  302. package/vibe/rules/principles/development-philosophy.md +52 -52
  303. package/vibe/rules/principles/quick-start.md +102 -102
  304. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  305. package/vibe/rules/quality/checklist.md +276 -276
  306. package/vibe/rules/quality/performance.md +236 -236
  307. package/vibe/rules/quality/testing-strategy.md +440 -440
  308. package/vibe/rules/standards/anti-patterns.md +541 -541
  309. package/vibe/rules/standards/code-structure.md +291 -291
  310. package/vibe/rules/standards/complexity-metrics.md +313 -313
  311. package/vibe/rules/standards/git-workflow.md +237 -237
  312. package/vibe/rules/standards/naming-conventions.md +198 -198
  313. package/vibe/rules/standards/security.md +305 -305
  314. package/vibe/rules/writing/document-style.md +74 -74
  315. package/vibe/setup.sh +31 -31
  316. package/vibe/templates/constitution-template.md +252 -252
  317. package/vibe/templates/contract-backend-template.md +526 -526
  318. package/vibe/templates/contract-frontend-template.md +599 -599
  319. package/vibe/templates/feature-template.md +96 -96
  320. package/vibe/templates/spec-template.md +221 -221
  321. package/vibe/ui-ux-data/charts.csv +26 -26
  322. package/vibe/ui-ux-data/colors.csv +97 -97
  323. package/vibe/ui-ux-data/icons.csv +101 -101
  324. package/vibe/ui-ux-data/landing.csv +31 -31
  325. package/vibe/ui-ux-data/products.csv +96 -96
  326. package/vibe/ui-ux-data/react-performance.csv +45 -45
  327. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  328. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  329. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  330. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  331. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  332. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  333. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  334. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  335. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  336. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  337. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  338. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  339. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  340. package/vibe/ui-ux-data/styles.csv +68 -68
  341. package/vibe/ui-ux-data/typography.csv +57 -57
  342. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  343. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  344. package/vibe/ui-ux-data/version.json +31 -31
  345. package/vibe/ui-ux-data/web-interface.csv +31 -31
@@ -71,45 +71,45 @@ function generateSplitSpec(prd, featureName, phases, options) {
71
71
  function buildSpecContent(prd, featureName, phases, options) {
72
72
  const { techStack = [], relatedCodePaths = [], designReference, additionalConstraints = [], additionalOutputs = [] } = options;
73
73
  const now = new Date().toISOString();
74
- let content = `---
75
- status: pending
76
- currentPhase: 0
77
- totalPhases: ${phases.length}
78
- createdAt: ${now}
79
- lastUpdated: ${now}
80
- ---
81
-
82
- # SPEC: ${featureName}
83
-
84
- ## Persona
85
- <role>
86
- Senior developer implementing ${featureName}.
87
- - Follow existing code patterns and conventions
88
- - Write testable, maintainable code
89
- - Consider security and performance implications
90
- </role>
91
-
92
- ## Context
93
- <context>
94
- ### Background
95
- ${prd.description || `Implementation of ${prd.title}`}
96
-
97
- ### Tech Stack
98
- ${techStack.length > 0 ? techStack.map(t => `- ${t}`).join('\n') : '- (To be determined based on project)'}
99
-
100
- ### Related Code
101
- ${relatedCodePaths.length > 0 ? relatedCodePaths.map(p => `- \`${p}\``).join('\n') : '- (Analyze existing codebase for patterns)'}
102
-
103
- ### Design Reference
104
- ${designReference || '- (None specified)'}
105
-
106
- ### Requirements Source
107
- - Parsed from PRD: ${prd.requirements.length} requirements
108
- - Format: ${prd.metadata.format}
109
- </context>
110
-
111
- ## Task
112
- <task>
74
+ let content = `---
75
+ status: pending
76
+ currentPhase: 0
77
+ totalPhases: ${phases.length}
78
+ createdAt: ${now}
79
+ lastUpdated: ${now}
80
+ ---
81
+
82
+ # SPEC: ${featureName}
83
+
84
+ ## Persona
85
+ <role>
86
+ Senior developer implementing ${featureName}.
87
+ - Follow existing code patterns and conventions
88
+ - Write testable, maintainable code
89
+ - Consider security and performance implications
90
+ </role>
91
+
92
+ ## Context
93
+ <context>
94
+ ### Background
95
+ ${prd.description || `Implementation of ${prd.title}`}
96
+
97
+ ### Tech Stack
98
+ ${techStack.length > 0 ? techStack.map(t => `- ${t}`).join('\n') : '- (To be determined based on project)'}
99
+
100
+ ### Related Code
101
+ ${relatedCodePaths.length > 0 ? relatedCodePaths.map(p => `- \`${p}\``).join('\n') : '- (Analyze existing codebase for patterns)'}
102
+
103
+ ### Design Reference
104
+ ${designReference || '- (None specified)'}
105
+
106
+ ### Requirements Source
107
+ - Parsed from PRD: ${prd.requirements.length} requirements
108
+ - Format: ${prd.metadata.format}
109
+ </context>
110
+
111
+ ## Task
112
+ <task>
113
113
  `;
114
114
  // Phase별 태스크 추가
115
115
  for (let i = 0; i < phases.length; i++) {
@@ -121,47 +121,47 @@ ${designReference || '- (None specified)'}
121
121
  }
122
122
  content += '\n';
123
123
  }
124
- content += `</task>
125
-
126
- ## Constraints
127
- <constraints>
128
- ### Must Follow
129
- - Follow existing code patterns (ES Module, async/await)
130
- - Maintain backward compatibility
131
- - TypeScript strict mode compliance
132
- - No \`any\` type → Use \`unknown\` + type guards
133
- - Functions ≤30 lines recommended, ≤50 lines max
134
- - Nesting ≤3 levels
135
-
136
- ### Error Handling
137
- - Proper try-catch with meaningful error messages
138
- - Loading state handling for async operations
139
- - User-friendly error messages
140
-
141
- ### Security
142
- - Input validation for all user inputs
143
- - Authentication/authorization checks where needed
144
- - No sensitive data in logs
145
- ${additionalConstraints.map(c => `\n- ${c}`).join('')}
146
- </constraints>
147
-
148
- ## Output Format
149
- <output_format>
150
- ### Files to Create
151
- ${generateFileList(phases, 'create')}
152
-
153
- ### Files to Modify
154
- ${generateFileList(phases, 'modify')}
155
-
156
- ### Verification Commands
157
- - \`npm run build\` (build success)
158
- - \`npm test\` (tests pass)
159
- - \`tsc --noEmit\` (type check)
160
- ${additionalOutputs.map(o => `- ${o}`).join('\n')}
161
- </output_format>
162
-
163
- ## Acceptance Criteria
164
- <acceptance>
124
+ content += `</task>
125
+
126
+ ## Constraints
127
+ <constraints>
128
+ ### Must Follow
129
+ - Follow existing code patterns (ES Module, async/await)
130
+ - Maintain backward compatibility
131
+ - TypeScript strict mode compliance
132
+ - No \`any\` type → Use \`unknown\` + type guards
133
+ - Functions ≤30 lines recommended, ≤50 lines max
134
+ - Nesting ≤3 levels
135
+
136
+ ### Error Handling
137
+ - Proper try-catch with meaningful error messages
138
+ - Loading state handling for async operations
139
+ - User-friendly error messages
140
+
141
+ ### Security
142
+ - Input validation for all user inputs
143
+ - Authentication/authorization checks where needed
144
+ - No sensitive data in logs
145
+ ${additionalConstraints.map(c => `\n- ${c}`).join('')}
146
+ </constraints>
147
+
148
+ ## Output Format
149
+ <output_format>
150
+ ### Files to Create
151
+ ${generateFileList(phases, 'create')}
152
+
153
+ ### Files to Modify
154
+ ${generateFileList(phases, 'modify')}
155
+
156
+ ### Verification Commands
157
+ - \`npm run build\` (build success)
158
+ - \`npm test\` (tests pass)
159
+ - \`tsc --noEmit\` (type check)
160
+ ${additionalOutputs.map(o => `- ${o}`).join('\n')}
161
+ </output_format>
162
+
163
+ ## Acceptance Criteria
164
+ <acceptance>
165
165
  `;
166
166
  // 요구사항별 AC 추가
167
167
  for (const req of prd.requirements) {
@@ -176,11 +176,11 @@ ${additionalOutputs.map(o => `- ${o}`).join('\n')}
176
176
  }
177
177
  content += '\n';
178
178
  }
179
- content += `### Build & Test
180
- - [ ] \`npm run build\` succeeds
181
- - [ ] All tests pass
182
- - [ ] No TypeScript errors
183
- </acceptance>
179
+ content += `### Build & Test
180
+ - [ ] \`npm run build\` succeeds
181
+ - [ ] All tests pass
182
+ - [ ] No TypeScript errors
183
+ </acceptance>
184
184
  `;
185
185
  return content;
186
186
  }
@@ -189,53 +189,53 @@ ${additionalOutputs.map(o => `- ${o}`).join('\n')}
189
189
  */
190
190
  function buildMasterSpecContent(prd, featureName, phases, options) {
191
191
  const now = new Date().toISOString();
192
- let content = `---
193
- status: pending
194
- currentPhase: 0
195
- totalPhases: ${phases.length}
196
- createdAt: ${now}
197
- lastUpdated: ${now}
198
- isMaster: true
199
- ---
200
-
201
- # SPEC: ${featureName} (Master)
202
-
203
- ## Overview
204
- - **Feature**: ${prd.title}
205
- - **Total Phases**: ${phases.length}
206
- - **Total Requirements**: ${prd.requirements.length}
207
- - **Format**: Split SPEC (large scope)
208
-
209
- ## Sub-SPECs
210
-
211
- | Order | SPEC File | Description | Status |
212
- |-------|-----------|-------------|--------|
192
+ let content = `---
193
+ status: pending
194
+ currentPhase: 0
195
+ totalPhases: ${phases.length}
196
+ createdAt: ${now}
197
+ lastUpdated: ${now}
198
+ isMaster: true
199
+ ---
200
+
201
+ # SPEC: ${featureName} (Master)
202
+
203
+ ## Overview
204
+ - **Feature**: ${prd.title}
205
+ - **Total Phases**: ${phases.length}
206
+ - **Total Requirements**: ${prd.requirements.length}
207
+ - **Format**: Split SPEC (large scope)
208
+
209
+ ## Sub-SPECs
210
+
211
+ | Order | SPEC File | Description | Status |
212
+ |-------|-----------|-------------|--------|
213
213
  `;
214
214
  for (let i = 0; i < phases.length; i++) {
215
215
  const phase = phases[i];
216
216
  const fileName = `phase-${i + 1}-${normalizeFileName(phase.name)}.md`;
217
217
  content += `| ${i + 1} | ${fileName} | ${phase.name} | ⬜ |\n`;
218
218
  }
219
- content += `
220
- ## Shared Context
221
-
222
- ### Tech Stack
223
- ${options.techStack?.map(t => `- ${t}`).join('\n') || '- (See project configuration)'}
224
-
225
- ### Constraints (Apply to All Phases)
226
- - Follow existing code patterns
227
- - TypeScript strict mode
228
- - No \`any\` type
229
- - Functions ≤50 lines max
230
- ${options.additionalConstraints?.map(c => `- ${c}`).join('\n') || ''}
231
-
232
- ## Execution Order
233
- \`\`\`
234
- ${phases.map((p, i) => `Phase ${i + 1}: ${p.name}`).join(' → ')}
235
- \`\`\`
236
-
237
- ## Dependencies
238
- ${generateDependencyList(phases)}
219
+ content += `
220
+ ## Shared Context
221
+
222
+ ### Tech Stack
223
+ ${options.techStack?.map(t => `- ${t}`).join('\n') || '- (See project configuration)'}
224
+
225
+ ### Constraints (Apply to All Phases)
226
+ - Follow existing code patterns
227
+ - TypeScript strict mode
228
+ - No \`any\` type
229
+ - Functions ≤50 lines max
230
+ ${options.additionalConstraints?.map(c => `- ${c}`).join('\n') || ''}
231
+
232
+ ## Execution Order
233
+ \`\`\`
234
+ ${phases.map((p, i) => `Phase ${i + 1}: ${p.name}`).join(' → ')}
235
+ \`\`\`
236
+
237
+ ## Dependencies
238
+ ${generateDependencyList(phases)}
239
239
  `;
240
240
  return content;
241
241
  }
@@ -244,54 +244,54 @@ ${generateDependencyList(phases)}
244
244
  */
245
245
  function buildPhaseSpecContent(prd, featureName, phase, phaseNumber, totalPhases, options) {
246
246
  const now = new Date().toISOString();
247
- let content = `---
248
- status: pending
249
- phase: ${phaseNumber}
250
- totalPhases: ${totalPhases}
251
- masterSpec: _index.md
252
- createdAt: ${now}
253
- lastUpdated: ${now}
254
- ---
255
-
256
- # SPEC: ${featureName} - Phase ${phaseNumber}: ${phase.name}
257
-
258
- ## Persona
259
- <role>
260
- Developer implementing Phase ${phaseNumber} of ${featureName}.
261
- - Focus on ${phase.name}
262
- - Follow project conventions
263
- - Write testable code
264
- </role>
265
-
266
- ## Context
267
- <context>
268
- ### Phase Goal
269
- ${getPhaseGoal(phase)}
270
-
271
- ### Requirements (${phase.requirements.length})
272
- ${phase.requirements.map(r => `- ${r.id}: ${truncateText(r.description, 50)}`).join('\n')}
273
-
274
- ### Dependencies
275
- ${phaseNumber > 1 ? `- Requires Phase ${phaseNumber - 1} completion` : '- No dependencies (first phase)'}
276
- </context>
277
-
278
- ## Task
279
- <task>
247
+ let content = `---
248
+ status: pending
249
+ phase: ${phaseNumber}
250
+ totalPhases: ${totalPhases}
251
+ masterSpec: _index.md
252
+ createdAt: ${now}
253
+ lastUpdated: ${now}
254
+ ---
255
+
256
+ # SPEC: ${featureName} - Phase ${phaseNumber}: ${phase.name}
257
+
258
+ ## Persona
259
+ <role>
260
+ Developer implementing Phase ${phaseNumber} of ${featureName}.
261
+ - Focus on ${phase.name}
262
+ - Follow project conventions
263
+ - Write testable code
264
+ </role>
265
+
266
+ ## Context
267
+ <context>
268
+ ### Phase Goal
269
+ ${getPhaseGoal(phase)}
270
+
271
+ ### Requirements (${phase.requirements.length})
272
+ ${phase.requirements.map(r => `- ${r.id}: ${truncateText(r.description, 50)}`).join('\n')}
273
+
274
+ ### Dependencies
275
+ ${phaseNumber > 1 ? `- Requires Phase ${phaseNumber - 1} completion` : '- No dependencies (first phase)'}
276
+ </context>
277
+
278
+ ## Task
279
+ <task>
280
280
  `;
281
281
  for (const task of phase.tasks) {
282
282
  content += `1. [ ] ${task}\n`;
283
283
  }
284
- content += `</task>
285
-
286
- ## Acceptance Criteria
287
- <acceptance>
284
+ content += `</task>
285
+
286
+ ## Acceptance Criteria
287
+ <acceptance>
288
288
  `;
289
289
  for (const req of phase.requirements) {
290
290
  content += `- [ ] ${req.id}: ${truncateText(req.description, 60)}\n`;
291
291
  }
292
- content += `- [ ] Phase ${phaseNumber} build succeeds
293
- - [ ] Phase ${phaseNumber} tests pass
294
- </acceptance>
292
+ content += `- [ ] Phase ${phaseNumber} build succeeds
293
+ - [ ] Phase ${phaseNumber} tests pass
294
+ </acceptance>
295
295
  `;
296
296
  return content;
297
297
  }
@@ -384,11 +384,11 @@ function getPhaseGoal(phase) {
384
384
  function generateFileList(phases, type) {
385
385
  // 실제로는 요구사항을 분석해서 추론해야 하지만, 기본 템플릿 제공
386
386
  if (type === 'create') {
387
- return `- (To be determined based on implementation)
388
- - \`src/[feature]/index.ts\`
387
+ return `- (To be determined based on implementation)
388
+ - \`src/[feature]/index.ts\`
389
389
  - \`src/[feature]/[feature].test.ts\``;
390
390
  }
391
- return `- (Analyze existing codebase)
391
+ return `- (Analyze existing codebase)
392
392
  - Relevant existing files`;
393
393
  }
394
394
  /**
@@ -116,74 +116,74 @@ export function formatMatrixAsMarkdown(matrix) {
116
116
  * 매트릭스를 HTML로 출력
117
117
  */
118
118
  export function formatMatrixAsHtml(matrix) {
119
- let html = `<!DOCTYPE html>
120
- <html>
121
- <head>
122
- <title>RTM: ${matrix.featureName}</title>
123
- <style>
124
- body { font-family: -apple-system, BlinkMacSystemFont, sans-serif; margin: 2rem; }
125
- table { border-collapse: collapse; width: 100%; }
126
- th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
127
- th { background: #f5f5f5; }
128
- .full { background: #d4edda; }
129
- .partial { background: #fff3cd; }
130
- .none { background: #f8d7da; }
131
- .summary { display: grid; grid-template-columns: repeat(4, 1fr); gap: 1rem; margin: 1rem 0; }
132
- .summary-card { padding: 1rem; border-radius: 8px; background: #f5f5f5; }
133
- .coverage-bar { height: 20px; background: #e0e0e0; border-radius: 4px; overflow: hidden; }
134
- .coverage-fill { height: 100%; background: #4caf50; }
135
- </style>
136
- </head>
137
- <body>
138
- <h1>RTM: ${matrix.featureName}</h1>
139
- <p>Generated: ${matrix.generatedAt}</p>
140
-
141
- <div class="summary">
142
- <div class="summary-card">
143
- <strong>Requirements</strong><br>${matrix.summary.totalRequirements}
144
- </div>
145
- <div class="summary-card">
146
- <strong>Feature Coverage</strong><br>${matrix.summary.featureCovered}/${matrix.summary.totalRequirements}
147
- </div>
148
- <div class="summary-card">
149
- <strong>Test Coverage</strong><br>${matrix.summary.testCovered}/${matrix.summary.totalRequirements}
150
- </div>
151
- <div class="summary-card">
152
- <strong>Overall</strong><br>
153
- <div class="coverage-bar">
154
- <div class="coverage-fill" style="width: ${matrix.summary.coveragePercent}%"></div>
155
- </div>
156
- ${matrix.summary.coveragePercent}%
157
- </div>
158
- </div>
159
-
160
- <table>
161
- <thead>
162
- <tr>
163
- <th>Requirement</th>
164
- <th>Description</th>
165
- <th>SPEC</th>
166
- <th>Feature</th>
167
- <th>Test</th>
168
- <th>Coverage</th>
169
- </tr>
170
- </thead>
171
- <tbody>
119
+ let html = `<!DOCTYPE html>
120
+ <html>
121
+ <head>
122
+ <title>RTM: ${matrix.featureName}</title>
123
+ <style>
124
+ body { font-family: -apple-system, BlinkMacSystemFont, sans-serif; margin: 2rem; }
125
+ table { border-collapse: collapse; width: 100%; }
126
+ th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
127
+ th { background: #f5f5f5; }
128
+ .full { background: #d4edda; }
129
+ .partial { background: #fff3cd; }
130
+ .none { background: #f8d7da; }
131
+ .summary { display: grid; grid-template-columns: repeat(4, 1fr); gap: 1rem; margin: 1rem 0; }
132
+ .summary-card { padding: 1rem; border-radius: 8px; background: #f5f5f5; }
133
+ .coverage-bar { height: 20px; background: #e0e0e0; border-radius: 4px; overflow: hidden; }
134
+ .coverage-fill { height: 100%; background: #4caf50; }
135
+ </style>
136
+ </head>
137
+ <body>
138
+ <h1>RTM: ${matrix.featureName}</h1>
139
+ <p>Generated: ${matrix.generatedAt}</p>
140
+
141
+ <div class="summary">
142
+ <div class="summary-card">
143
+ <strong>Requirements</strong><br>${matrix.summary.totalRequirements}
144
+ </div>
145
+ <div class="summary-card">
146
+ <strong>Feature Coverage</strong><br>${matrix.summary.featureCovered}/${matrix.summary.totalRequirements}
147
+ </div>
148
+ <div class="summary-card">
149
+ <strong>Test Coverage</strong><br>${matrix.summary.testCovered}/${matrix.summary.totalRequirements}
150
+ </div>
151
+ <div class="summary-card">
152
+ <strong>Overall</strong><br>
153
+ <div class="coverage-bar">
154
+ <div class="coverage-fill" style="width: ${matrix.summary.coveragePercent}%"></div>
155
+ </div>
156
+ ${matrix.summary.coveragePercent}%
157
+ </div>
158
+ </div>
159
+
160
+ <table>
161
+ <thead>
162
+ <tr>
163
+ <th>Requirement</th>
164
+ <th>Description</th>
165
+ <th>SPEC</th>
166
+ <th>Feature</th>
167
+ <th>Test</th>
168
+ <th>Coverage</th>
169
+ </tr>
170
+ </thead>
171
+ <tbody>
172
172
  `;
173
173
  for (const item of matrix.items) {
174
- html += ` <tr class="${item.coverage}">
175
- <td>${item.requirementId}</td>
176
- <td>${escapeHtml(truncate(item.requirementDesc, 50))}</td>
177
- <td>${item.specSection ? '✅' : '❌'}</td>
178
- <td>${item.featureScenario ? '✅' : '❌'}</td>
179
- <td>${item.testName ? '✅' : '❌'}</td>
180
- <td>${getCoverageIcon(item.coverage)}</td>
181
- </tr>
174
+ html += ` <tr class="${item.coverage}">
175
+ <td>${item.requirementId}</td>
176
+ <td>${escapeHtml(truncate(item.requirementDesc, 50))}</td>
177
+ <td>${item.specSection ? '✅' : '❌'}</td>
178
+ <td>${item.featureScenario ? '✅' : '❌'}</td>
179
+ <td>${item.testName ? '✅' : '❌'}</td>
180
+ <td>${getCoverageIcon(item.coverage)}</td>
181
+ </tr>
182
182
  `;
183
183
  }
184
- html += ` </tbody>
185
- </table>
186
- </body>
184
+ html += ` </tbody>
185
+ </table>
186
+ </body>
187
187
  </html>`;
188
188
  return html;
189
189
  }
@@ -8,37 +8,37 @@ import { generateTraceabilityMatrix, formatMatrixAsMarkdown, formatMatrixAsHtml,
8
8
  vi.mock('fs', () => ({
9
9
  readFileSync: vi.fn((path) => {
10
10
  if (path.includes('test-feature.md')) {
11
- return `# SPEC: test-feature
12
-
13
- ## Task
14
-
15
- ### Phase 1: Setup
16
-
17
- 1. [ ] REQ-test-001: Setup authentication
18
- 2. [ ] REQ-test-002: Create login form
19
- 3. [ ] REQ-test-003: Implement validation
11
+ return `# SPEC: test-feature
12
+
13
+ ## Task
14
+
15
+ ### Phase 1: Setup
16
+
17
+ 1. [ ] REQ-test-001: Setup authentication
18
+ 2. [ ] REQ-test-002: Create login form
19
+ 3. [ ] REQ-test-003: Implement validation
20
20
  `;
21
21
  }
22
22
  if (path.includes('test-feature.feature')) {
23
- return `# Feature: test-feature
24
-
25
- ## Scenarios
26
-
27
- ### Scenario 1: User can login
28
- \`\`\`gherkin
29
- Given user is on login page
30
- When user enters valid credentials
31
- Then user is logged in
32
- \`\`\`
33
- **Verification**: REQ-test-001
34
-
35
- ### Scenario 2: Validation errors
36
- \`\`\`gherkin
37
- Given user is on login page
38
- When user enters invalid email
39
- Then error message is shown
40
- \`\`\`
41
- **Verification**: REQ-test-003
23
+ return `# Feature: test-feature
24
+
25
+ ## Scenarios
26
+
27
+ ### Scenario 1: User can login
28
+ \`\`\`gherkin
29
+ Given user is on login page
30
+ When user enters valid credentials
31
+ Then user is logged in
32
+ \`\`\`
33
+ **Verification**: REQ-test-001
34
+
35
+ ### Scenario 2: Validation errors
36
+ \`\`\`gherkin
37
+ Given user is on login page
38
+ When user enters invalid email
39
+ Then error message is shown
40
+ \`\`\`
41
+ **Verification**: REQ-test-003
42
42
  `;
43
43
  }
44
44
  throw new Error(`File not found: ${path}`);