@su-record/vibe 2.7.16 → 2.7.18

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 (249) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +153 -134
  3. package/LICENSE +21 -21
  4. package/README.md +449 -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/explorer-low.md +42 -42
  15. package/agents/explorer-medium.md +59 -59
  16. package/agents/explorer.md +48 -48
  17. package/agents/implementer-low.md +43 -43
  18. package/agents/implementer-medium.md +52 -52
  19. package/agents/implementer.md +54 -54
  20. package/agents/junior-mentor.md +141 -141
  21. package/agents/planning/requirements-analyst.md +84 -84
  22. package/agents/planning/ux-advisor.md +83 -83
  23. package/agents/qa/acceptance-tester.md +86 -86
  24. package/agents/qa/edge-case-finder.md +93 -93
  25. package/agents/refactor-cleaner.md +143 -143
  26. package/agents/research/best-practices-agent.md +199 -199
  27. package/agents/research/codebase-patterns-agent.md +157 -157
  28. package/agents/research/framework-docs-agent.md +188 -188
  29. package/agents/research/security-advisory-agent.md +213 -213
  30. package/agents/review/architecture-reviewer.md +107 -107
  31. package/agents/review/complexity-reviewer.md +116 -116
  32. package/agents/review/data-integrity-reviewer.md +88 -88
  33. package/agents/review/git-history-reviewer.md +103 -103
  34. package/agents/review/performance-reviewer.md +86 -86
  35. package/agents/review/python-reviewer.md +150 -150
  36. package/agents/review/rails-reviewer.md +139 -139
  37. package/agents/review/react-reviewer.md +144 -144
  38. package/agents/review/security-reviewer.md +80 -80
  39. package/agents/review/simplicity-reviewer.md +140 -140
  40. package/agents/review/test-coverage-reviewer.md +116 -116
  41. package/agents/review/typescript-reviewer.md +127 -127
  42. package/agents/searcher.md +54 -54
  43. package/agents/simplifier.md +120 -120
  44. package/agents/tester.md +49 -49
  45. package/agents/ui/ui-a11y-auditor.md +93 -93
  46. package/agents/ui/ui-antipattern-detector.md +94 -94
  47. package/agents/ui/ui-dataviz-advisor.md +69 -69
  48. package/agents/ui/ui-design-system-gen.md +57 -57
  49. package/agents/ui/ui-industry-analyzer.md +49 -49
  50. package/agents/ui/ui-layout-architect.md +65 -65
  51. package/agents/ui/ui-stack-implementer.md +68 -68
  52. package/agents/ui/ux-compliance-reviewer.md +81 -81
  53. package/agents/ui-previewer.md +258 -258
  54. package/commands/vibe.analyze.md +379 -379
  55. package/commands/vibe.review.md +607 -607
  56. package/commands/vibe.run.md +2124 -2124
  57. package/commands/vibe.spec.md +1195 -1195
  58. package/commands/vibe.spec.review.md +569 -569
  59. package/commands/vibe.utils.md +413 -413
  60. package/commands/vibe.verify.md +484 -484
  61. package/dist/cli/collaborator.js +52 -52
  62. package/dist/cli/commands/evolution.js +12 -12
  63. package/dist/cli/commands/info.js +51 -51
  64. package/dist/cli/commands/init.js +5 -5
  65. package/dist/cli/commands/remove.js +14 -14
  66. package/dist/cli/commands/sentinel.js +27 -27
  67. package/dist/cli/commands/skills.js +5 -5
  68. package/dist/cli/commands/slack.js +10 -10
  69. package/dist/cli/commands/telegram.js +12 -12
  70. package/dist/cli/commands/upgrade.d.ts +3 -3
  71. package/dist/cli/commands/upgrade.d.ts.map +1 -1
  72. package/dist/cli/commands/upgrade.js +24 -3
  73. package/dist/cli/commands/upgrade.js.map +1 -1
  74. package/dist/cli/detect.js +32 -32
  75. package/dist/cli/index.js +51 -51
  76. package/dist/cli/llm/claude-commands.js +16 -16
  77. package/dist/cli/llm/config.js +18 -18
  78. package/dist/cli/llm/gemini-commands.js +16 -16
  79. package/dist/cli/llm/gpt-commands.js +19 -19
  80. package/dist/cli/llm/help.js +21 -21
  81. package/dist/cli/postinstall/cursor-agents.js +32 -32
  82. package/dist/cli/postinstall/cursor-rules.js +83 -83
  83. package/dist/cli/postinstall/cursor-skills.js +743 -743
  84. package/dist/cli/setup/Provisioner.js +42 -42
  85. package/dist/infra/lib/DeepInit.js +24 -24
  86. package/dist/infra/lib/IterationTracker.js +11 -11
  87. package/dist/infra/lib/PythonParser.js +108 -108
  88. package/dist/infra/lib/ReviewRace.js +96 -96
  89. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  90. package/dist/infra/lib/SkillQualityGate.js +9 -9
  91. package/dist/infra/lib/SkillRepository.js +159 -159
  92. package/dist/infra/lib/UltraQA.js +99 -99
  93. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  94. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  95. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  96. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  97. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  98. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  99. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  100. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  101. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  102. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  103. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  104. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  105. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  106. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  107. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  108. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  109. package/dist/infra/lib/gemini/orchestration.js +5 -5
  110. package/dist/infra/lib/gpt/orchestration.js +4 -4
  111. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  112. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  113. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  114. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  115. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  116. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  117. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  118. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  119. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts +52 -0
  120. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts.map +1 -0
  121. package/dist/infra/lib/telemetry/SkillTelemetry.js +117 -0
  122. package/dist/infra/lib/telemetry/SkillTelemetry.js.map +1 -0
  123. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts +2 -0
  124. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts.map +1 -0
  125. package/dist/infra/lib/telemetry/SkillTelemetry.test.js +91 -0
  126. package/dist/infra/lib/telemetry/SkillTelemetry.test.js.map +1 -0
  127. package/dist/infra/orchestrator/AgentManager.js +12 -12
  128. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  129. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  130. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  131. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  132. package/dist/test-helpers/index.d.ts +36 -0
  133. package/dist/test-helpers/index.d.ts.map +1 -0
  134. package/dist/test-helpers/index.js +85 -0
  135. package/dist/test-helpers/index.js.map +1 -0
  136. package/dist/test-helpers/index.test.d.ts +2 -0
  137. package/dist/test-helpers/index.test.d.ts.map +1 -0
  138. package/dist/test-helpers/index.test.js +92 -0
  139. package/dist/test-helpers/index.test.js.map +1 -0
  140. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  141. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  142. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  143. package/dist/tools/memory/getMemoryGraph.js +12 -12
  144. package/dist/tools/memory/getSessionContext.js +9 -9
  145. package/dist/tools/memory/linkMemories.js +14 -14
  146. package/dist/tools/memory/listMemories.js +4 -4
  147. package/dist/tools/memory/recallMemory.js +4 -4
  148. package/dist/tools/memory/saveMemory.js +4 -4
  149. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  150. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  151. package/dist/tools/semantic/astGrep.test.js +6 -6
  152. package/dist/tools/spec/prdParser.test.js +171 -171
  153. package/dist/tools/spec/specGenerator.js +169 -169
  154. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  155. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  156. package/hooks/gemini-hooks.json +73 -73
  157. package/hooks/hooks.json +137 -137
  158. package/hooks/scripts/code-check.js +77 -77
  159. package/hooks/scripts/context-save.js +212 -212
  160. package/hooks/scripts/hud-status.js +291 -291
  161. package/hooks/scripts/keyword-detector.js +214 -214
  162. package/hooks/scripts/llm-orchestrate.js +475 -475
  163. package/hooks/scripts/post-edit.js +32 -32
  164. package/hooks/scripts/pre-tool-guard.js +125 -125
  165. package/hooks/scripts/prompt-dispatcher.js +185 -185
  166. package/hooks/scripts/sentinel-guard.js +104 -104
  167. package/hooks/scripts/session-start.js +106 -106
  168. package/hooks/scripts/stop-notify.js +209 -209
  169. package/hooks/scripts/utils.js +100 -100
  170. package/languages/csharp-unity.md +515 -515
  171. package/languages/gdscript-godot.md +470 -470
  172. package/languages/ruby-rails.md +489 -489
  173. package/languages/typescript-angular.md +433 -433
  174. package/languages/typescript-astro.md +416 -416
  175. package/languages/typescript-electron.md +406 -406
  176. package/languages/typescript-nestjs.md +524 -524
  177. package/languages/typescript-svelte.md +407 -407
  178. package/languages/typescript-tauri.md +365 -365
  179. package/package.json +123 -121
  180. package/skills/agents-md/SKILL.md +120 -120
  181. package/skills/arch-guard/SKILL.md +180 -180
  182. package/skills/brand-assets/SKILL.md +146 -146
  183. package/skills/capability-loop/SKILL.md +167 -167
  184. package/skills/characterization-test/SKILL.md +206 -206
  185. package/skills/commerce-patterns/SKILL.md +63 -63
  186. package/skills/commit-push-pr/SKILL.md +75 -75
  187. package/skills/context7-usage/SKILL.md +105 -105
  188. package/skills/core-capabilities/SKILL.md +13 -13
  189. package/skills/e2e-commerce/SKILL.md +61 -61
  190. package/skills/exec-plan/SKILL.md +147 -147
  191. package/skills/frontend-design/SKILL.md +12 -12
  192. package/skills/git-worktree/SKILL.md +72 -72
  193. package/skills/handoff/SKILL.md +109 -109
  194. package/skills/parallel-research/SKILL.md +87 -87
  195. package/skills/priority-todos/SKILL.md +63 -63
  196. package/skills/seo-checklist/SKILL.md +57 -57
  197. package/skills/techdebt/SKILL.md +122 -122
  198. package/skills/tool-fallback/SKILL.md +103 -103
  199. package/skills/typescript-advanced-types/SKILL.md +66 -66
  200. package/skills/ui-ux-pro-max/SKILL.md +221 -221
  201. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  202. package/skills/video-production/SKILL.md +51 -51
  203. package/vibe/config.json +29 -29
  204. package/vibe/constitution.md +227 -227
  205. package/vibe/rules/principles/communication-guide.md +98 -98
  206. package/vibe/rules/principles/development-philosophy.md +52 -52
  207. package/vibe/rules/principles/quick-start.md +102 -102
  208. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  209. package/vibe/rules/quality/checklist.md +276 -276
  210. package/vibe/rules/quality/performance.md +236 -236
  211. package/vibe/rules/quality/testing-strategy.md +440 -440
  212. package/vibe/rules/standards/anti-patterns.md +541 -541
  213. package/vibe/rules/standards/code-structure.md +291 -291
  214. package/vibe/rules/standards/complexity-metrics.md +313 -313
  215. package/vibe/rules/standards/git-workflow.md +237 -237
  216. package/vibe/rules/standards/naming-conventions.md +198 -198
  217. package/vibe/rules/standards/security.md +305 -305
  218. package/vibe/rules/writing/document-style.md +74 -74
  219. package/vibe/setup.sh +31 -31
  220. package/vibe/templates/constitution-template.md +252 -252
  221. package/vibe/templates/contract-backend-template.md +526 -526
  222. package/vibe/templates/contract-frontend-template.md +599 -599
  223. package/vibe/templates/feature-template.md +96 -96
  224. package/vibe/templates/spec-template.md +221 -221
  225. package/vibe/ui-ux-data/charts.csv +26 -26
  226. package/vibe/ui-ux-data/colors.csv +97 -97
  227. package/vibe/ui-ux-data/icons.csv +101 -101
  228. package/vibe/ui-ux-data/landing.csv +31 -31
  229. package/vibe/ui-ux-data/products.csv +96 -96
  230. package/vibe/ui-ux-data/react-performance.csv +45 -45
  231. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  232. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  233. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  234. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  235. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  236. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  237. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  238. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  239. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  240. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  241. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  242. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  243. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  244. package/vibe/ui-ux-data/styles.csv +68 -68
  245. package/vibe/ui-ux-data/typography.csv +57 -57
  246. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  247. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  248. package/vibe/ui-ux-data/version.json +31 -31
  249. package/vibe/ui-ux-data/web-interface.csv +31 -31
@@ -1,185 +1,185 @@
1
- #!/usr/bin/env node
2
- /**
3
- * UserPromptSubmit 디스패처
4
- *
5
- * UserPromptSubmit은 matcher를 지원하지 않아 모든 hook이 매번 실행됨.
6
- * 이 디스패처가 stdin에서 prompt를 읽고, 패턴 매칭 후 해당 스크립트만 실행.
7
- *
8
- * 이점:
9
- * - 외부 LLM 호출(GPT/Gemini)이 패턴 매칭 없이 발동하지 않음
10
- * - context window에 불필요한 응답이 주입되지 않음
11
- * - 단일 프로세스에서 매칭 후 필요한 스크립트만 fork
12
- */
13
- import { execFile } from 'child_process';
14
- import { fileURLToPath } from 'url';
15
- import path from 'path';
16
-
17
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
18
-
19
- // stdin에서 prompt 읽기
20
- let inputData = '';
21
- for await (const chunk of process.stdin) {
22
- inputData += chunk;
23
- }
24
-
25
- let prompt = '';
26
- try {
27
- const parsed = JSON.parse(inputData);
28
- prompt = parsed.prompt || '';
29
- } catch {
30
- process.exit(0);
31
- }
32
-
33
- if (!prompt) process.exit(0);
34
-
35
- // 패턴 → 실행할 스크립트 매핑
36
- // 각 항목: { pattern, script, args, label }
37
- const DISPATCH_RULES = [
38
- // 항상 실행 (경량 스크립트)
39
- {
40
- pattern: null, // always
41
- script: 'keyword-detector.js',
42
- args: [prompt],
43
- label: 'keyword',
44
- },
45
-
46
- // 패턴 매칭이 필요한 스크립트
47
- {
48
- pattern: /ultrawork|ulw|울트라워크|ralph|ralplan/i,
49
- script: null, // keyword-detector가 이미 처리
50
- label: 'skip',
51
- },
52
- // echo 전용 (stdout으로 직접 출력)
53
- {
54
- pattern: /e2e.*테스트|e2e.*test|playwright|브라우저.*테스트|browser.*test/i,
55
- script: null,
56
- echo: '[E2E MODE] Use /vibe.utils --e2e for Playwright-based browser testing. Supports visual regression and video recording.',
57
- label: 'e2e-echo',
58
- },
59
-
60
- // 외부 LLM 호출 (GPT/Gemini) - 패턴 매칭 필수
61
- {
62
- pattern: /아키텍처.*(검토|리뷰|분석)|architecture.*(review|analyz)|설계.*검토|구조.*분석.*해/i,
63
- script: 'llm-orchestrate.js',
64
- args: ['gpt', 'orchestrate', 'You are a software architect. Analyze and review the architecture.'],
65
- label: 'gpt-architecture',
66
- },
67
- {
68
- pattern: /(UI|UX).*(리뷰|검토|피드백|개선)|사용자.*경험.*검토|디자인.*리뷰|design.*feedback/i,
69
- script: 'llm-orchestrate.js',
70
- args: ['gemini', 'orchestrate', 'You are a UI/UX expert. Analyze and provide feedback.'],
71
- label: 'gemini-uiux',
72
- },
73
- {
74
- pattern: /디버깅.*해|버그.*찾아|find.*bug|debug.*this.*code/i,
75
- script: 'llm-orchestrate.js',
76
- args: ['gpt', 'orchestrate', 'You are a debugging expert. Find bugs and suggest fixes.'],
77
- label: 'gpt-debug',
78
- },
79
- {
80
- pattern: /코드.*정적.*분석|코드.*분석.*해줘|analyze.*code.*quality/i,
81
- script: 'llm-orchestrate.js',
82
- args: ['gemini', 'orchestrate', 'You are a code analysis expert. Review and analyze the code.'],
83
- label: 'gemini-analysis',
84
- },
85
- {
86
- pattern: /코드.*리뷰|code.*review|PR.*리뷰|리뷰.*해줘.*코드/i,
87
- script: 'llm-orchestrate.js',
88
- args: ['gpt', 'orchestrate', 'You are a code review expert. Review the code for best practices, security, and performance.'],
89
- label: 'gpt-codereview',
90
- },
91
- {
92
- pattern: /추론.*해|reasoning|복잡.*분석|deep.*analysis/i,
93
- script: 'llm-orchestrate.js',
94
- args: ['gpt', 'orchestrate', 'You are a reasoning expert. Analyze the problem deeply and provide detailed reasoning.'],
95
- label: 'gpt-reasoning',
96
- },
97
-
98
- // 테스트용
99
- {
100
- pattern: /^test-gpt/i,
101
- script: 'llm-orchestrate.js',
102
- args: ['gpt', 'orchestrate', 'You are a helpful assistant. Answer the user\'s question clearly and concisely.'],
103
- label: 'test-gpt',
104
- },
105
- {
106
- pattern: /^test-gemini/i,
107
- script: 'llm-orchestrate.js',
108
- args: ['gemini', 'orchestrate', 'You are a helpful assistant. Answer the user\'s question clearly and concisely.'],
109
- label: 'test-gemini',
110
- },
111
- ];
112
-
113
- // 매칭된 스크립트 실행
114
- const execPromises = [];
115
-
116
- for (const rule of DISPATCH_RULES) {
117
- if (rule.label === 'skip') continue;
118
-
119
- // pattern이 null이면 항상 실행, 아니면 매칭 확인
120
- if (rule.pattern !== null && !rule.pattern.test(prompt)) continue;
121
-
122
- // echo 규칙: 직접 stdout 출력
123
- if (rule.echo) {
124
- process.stdout.write(rule.echo + '\n');
125
- continue;
126
- }
127
-
128
- if (!rule.script) continue;
129
-
130
- const scriptPath = path.join(__dirname, rule.script);
131
- const args = rule.args || [];
132
-
133
- execPromises.push(
134
- new Promise((resolve) => {
135
- execFile('node', [scriptPath, ...args], {
136
- timeout: 30000,
137
- env: { ...process.env },
138
- }, (error, stdout, stderr) => {
139
- if (stdout?.trim()) {
140
- process.stdout.write(stdout);
141
- }
142
- resolve();
143
- });
144
- })
145
- );
146
- }
147
-
148
- await Promise.all(execPromises);
149
-
150
- // Evolution: Gap detection — log unmatched prompts for skill gap analysis
151
- const matched = DISPATCH_RULES.some(r =>
152
- r.label !== 'skip' && r.label !== 'keyword' &&
153
- r.pattern !== null && r.pattern.test(prompt) &&
154
- (r.script || r.echo)
155
- );
156
-
157
- if (!matched) {
158
- setImmediate(async () => {
159
- try {
160
- const configPath = path.join(process.env.CLAUDE_PROJECT_DIR || '.', '.claude', 'vibe', 'config.json');
161
- let gapEnabled = true;
162
- try {
163
- const fs = await import('fs');
164
- if (fs.existsSync(configPath)) {
165
- const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
166
- gapEnabled = config.evolution?.gapDetection !== false && config.evolution?.enabled !== false;
167
- }
168
- } catch { /* ignore */ }
169
-
170
- if (gapEnabled) {
171
- const LIB_BASE = (await import('./utils.js')).getLibBaseUrl();
172
- const [memMod, gapMod] = await Promise.all([
173
- import(`${LIB_BASE}memory/MemoryStorage.js`),
174
- import(`${LIB_BASE}evolution/SkillGapDetector.js`),
175
- ]);
176
- const storage = new memMod.MemoryStorage(process.env.CLAUDE_PROJECT_DIR || '.');
177
- const detector = new gapMod.SkillGapDetector(storage);
178
- detector.logMiss(prompt.slice(0, 200));
179
- storage.close();
180
- }
181
- } catch (e) {
182
- process.stderr.write(`[Evolution] Gap log error: ${e.message}\n`);
183
- }
184
- });
185
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * UserPromptSubmit 디스패처
4
+ *
5
+ * UserPromptSubmit은 matcher를 지원하지 않아 모든 hook이 매번 실행됨.
6
+ * 이 디스패처가 stdin에서 prompt를 읽고, 패턴 매칭 후 해당 스크립트만 실행.
7
+ *
8
+ * 이점:
9
+ * - 외부 LLM 호출(GPT/Gemini)이 패턴 매칭 없이 발동하지 않음
10
+ * - context window에 불필요한 응답이 주입되지 않음
11
+ * - 단일 프로세스에서 매칭 후 필요한 스크립트만 fork
12
+ */
13
+ import { execFile } from 'child_process';
14
+ import { fileURLToPath } from 'url';
15
+ import path from 'path';
16
+
17
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
18
+
19
+ // stdin에서 prompt 읽기
20
+ let inputData = '';
21
+ for await (const chunk of process.stdin) {
22
+ inputData += chunk;
23
+ }
24
+
25
+ let prompt = '';
26
+ try {
27
+ const parsed = JSON.parse(inputData);
28
+ prompt = parsed.prompt || '';
29
+ } catch {
30
+ process.exit(0);
31
+ }
32
+
33
+ if (!prompt) process.exit(0);
34
+
35
+ // 패턴 → 실행할 스크립트 매핑
36
+ // 각 항목: { pattern, script, args, label }
37
+ const DISPATCH_RULES = [
38
+ // 항상 실행 (경량 스크립트)
39
+ {
40
+ pattern: null, // always
41
+ script: 'keyword-detector.js',
42
+ args: [prompt],
43
+ label: 'keyword',
44
+ },
45
+
46
+ // 패턴 매칭이 필요한 스크립트
47
+ {
48
+ pattern: /ultrawork|ulw|울트라워크|ralph|ralplan/i,
49
+ script: null, // keyword-detector가 이미 처리
50
+ label: 'skip',
51
+ },
52
+ // echo 전용 (stdout으로 직접 출력)
53
+ {
54
+ pattern: /e2e.*테스트|e2e.*test|playwright|브라우저.*테스트|browser.*test/i,
55
+ script: null,
56
+ echo: '[E2E MODE] Use /vibe.utils --e2e for Playwright-based browser testing. Supports visual regression and video recording.',
57
+ label: 'e2e-echo',
58
+ },
59
+
60
+ // 외부 LLM 호출 (GPT/Gemini) - 패턴 매칭 필수
61
+ {
62
+ pattern: /아키텍처.*(검토|리뷰|분석)|architecture.*(review|analyz)|설계.*검토|구조.*분석.*해/i,
63
+ script: 'llm-orchestrate.js',
64
+ args: ['gpt', 'orchestrate', 'You are a software architect. Analyze and review the architecture.'],
65
+ label: 'gpt-architecture',
66
+ },
67
+ {
68
+ pattern: /(UI|UX).*(리뷰|검토|피드백|개선)|사용자.*경험.*검토|디자인.*리뷰|design.*feedback/i,
69
+ script: 'llm-orchestrate.js',
70
+ args: ['gemini', 'orchestrate', 'You are a UI/UX expert. Analyze and provide feedback.'],
71
+ label: 'gemini-uiux',
72
+ },
73
+ {
74
+ pattern: /디버깅.*해|버그.*찾아|find.*bug|debug.*this.*code/i,
75
+ script: 'llm-orchestrate.js',
76
+ args: ['gpt', 'orchestrate', 'You are a debugging expert. Find bugs and suggest fixes.'],
77
+ label: 'gpt-debug',
78
+ },
79
+ {
80
+ pattern: /코드.*정적.*분석|코드.*분석.*해줘|analyze.*code.*quality/i,
81
+ script: 'llm-orchestrate.js',
82
+ args: ['gemini', 'orchestrate', 'You are a code analysis expert. Review and analyze the code.'],
83
+ label: 'gemini-analysis',
84
+ },
85
+ {
86
+ pattern: /코드.*리뷰|code.*review|PR.*리뷰|리뷰.*해줘.*코드/i,
87
+ script: 'llm-orchestrate.js',
88
+ args: ['gpt', 'orchestrate', 'You are a code review expert. Review the code for best practices, security, and performance.'],
89
+ label: 'gpt-codereview',
90
+ },
91
+ {
92
+ pattern: /추론.*해|reasoning|복잡.*분석|deep.*analysis/i,
93
+ script: 'llm-orchestrate.js',
94
+ args: ['gpt', 'orchestrate', 'You are a reasoning expert. Analyze the problem deeply and provide detailed reasoning.'],
95
+ label: 'gpt-reasoning',
96
+ },
97
+
98
+ // 테스트용
99
+ {
100
+ pattern: /^test-gpt/i,
101
+ script: 'llm-orchestrate.js',
102
+ args: ['gpt', 'orchestrate', 'You are a helpful assistant. Answer the user\'s question clearly and concisely.'],
103
+ label: 'test-gpt',
104
+ },
105
+ {
106
+ pattern: /^test-gemini/i,
107
+ script: 'llm-orchestrate.js',
108
+ args: ['gemini', 'orchestrate', 'You are a helpful assistant. Answer the user\'s question clearly and concisely.'],
109
+ label: 'test-gemini',
110
+ },
111
+ ];
112
+
113
+ // 매칭된 스크립트 실행
114
+ const execPromises = [];
115
+
116
+ for (const rule of DISPATCH_RULES) {
117
+ if (rule.label === 'skip') continue;
118
+
119
+ // pattern이 null이면 항상 실행, 아니면 매칭 확인
120
+ if (rule.pattern !== null && !rule.pattern.test(prompt)) continue;
121
+
122
+ // echo 규칙: 직접 stdout 출력
123
+ if (rule.echo) {
124
+ process.stdout.write(rule.echo + '\n');
125
+ continue;
126
+ }
127
+
128
+ if (!rule.script) continue;
129
+
130
+ const scriptPath = path.join(__dirname, rule.script);
131
+ const args = rule.args || [];
132
+
133
+ execPromises.push(
134
+ new Promise((resolve) => {
135
+ execFile('node', [scriptPath, ...args], {
136
+ timeout: 30000,
137
+ env: { ...process.env },
138
+ }, (error, stdout, stderr) => {
139
+ if (stdout?.trim()) {
140
+ process.stdout.write(stdout);
141
+ }
142
+ resolve();
143
+ });
144
+ })
145
+ );
146
+ }
147
+
148
+ await Promise.all(execPromises);
149
+
150
+ // Evolution: Gap detection — log unmatched prompts for skill gap analysis
151
+ const matched = DISPATCH_RULES.some(r =>
152
+ r.label !== 'skip' && r.label !== 'keyword' &&
153
+ r.pattern !== null && r.pattern.test(prompt) &&
154
+ (r.script || r.echo)
155
+ );
156
+
157
+ if (!matched) {
158
+ setImmediate(async () => {
159
+ try {
160
+ const configPath = path.join(process.env.CLAUDE_PROJECT_DIR || '.', '.claude', 'vibe', 'config.json');
161
+ let gapEnabled = true;
162
+ try {
163
+ const fs = await import('fs');
164
+ if (fs.existsSync(configPath)) {
165
+ const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
166
+ gapEnabled = config.evolution?.gapDetection !== false && config.evolution?.enabled !== false;
167
+ }
168
+ } catch { /* ignore */ }
169
+
170
+ if (gapEnabled) {
171
+ const LIB_BASE = (await import('./utils.js')).getLibBaseUrl();
172
+ const [memMod, gapMod] = await Promise.all([
173
+ import(`${LIB_BASE}memory/MemoryStorage.js`),
174
+ import(`${LIB_BASE}evolution/SkillGapDetector.js`),
175
+ ]);
176
+ const storage = new memMod.MemoryStorage(process.env.CLAUDE_PROJECT_DIR || '.');
177
+ const detector = new gapMod.SkillGapDetector(storage);
178
+ detector.logMiss(prompt.slice(0, 200));
179
+ storage.close();
180
+ }
181
+ } catch (e) {
182
+ process.stderr.write(`[Evolution] Gap log error: ${e.message}\n`);
183
+ }
184
+ });
185
+ }
@@ -1,104 +1,104 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Sentinel Guard — PreToolUse hook
4
- * Protects sentinel files and blocks dangerous operations.
5
- * Runs before pre-tool-guard.js.
6
- */
7
-
8
- const SENTINEL_PATH_PREFIX = 'src/infra/lib/autonomy/';
9
-
10
- const SENTINEL_PATH_RE = /^(\.\/|\.\\)?src[\\/]infra[\\/]lib[\\/]autonomy[\\/]/;
11
-
12
- const DANGEROUS_BASH_RE =
13
- /\b(rm\s+-rf|kill\s+-9|drop\s+table|truncate|shutdown|reboot|mkfs|dd\s+if=)\b/i;
14
-
15
- /**
16
- * Extract file path from tool input
17
- */
18
- function extractFilePath(toolName, input) {
19
- if (!input) return null;
20
- try {
21
- const parsed = typeof input === 'string' ? JSON.parse(input) : input;
22
- if (toolName === 'Write' || toolName === 'Edit' || toolName === 'Read') {
23
- return parsed.file_path || parsed.filePath || null;
24
- }
25
- } catch {
26
- // Not JSON, try as plain string
27
- return typeof input === 'string' ? input : null;
28
- }
29
- return null;
30
- }
31
-
32
- /**
33
- * Extract command from Bash tool input
34
- */
35
- function extractBashCommand(input) {
36
- if (!input) return null;
37
- try {
38
- const parsed = typeof input === 'string' ? JSON.parse(input) : input;
39
- return parsed.command || null;
40
- } catch {
41
- return typeof input === 'string' ? input : null;
42
- }
43
- }
44
-
45
- /**
46
- * Check if path targets sentinel files
47
- */
48
- function isSentinelPath(filePath) {
49
- if (!filePath) return false;
50
- const normalized = filePath.replace(/\\/g, '/').replace(/^\.\//, '');
51
- return normalized.startsWith(SENTINEL_PATH_PREFIX) || SENTINEL_PATH_RE.test(filePath);
52
- }
53
-
54
- /**
55
- * Main guard logic
56
- */
57
- function guard(toolName, toolInput) {
58
- // Write/Edit targeting sentinel files → block
59
- if (toolName === 'Write' || toolName === 'Edit') {
60
- const filePath = extractFilePath(toolName, toolInput);
61
- if (isSentinelPath(filePath)) {
62
- return {
63
- decision: 'block',
64
- reason: `Sentinel files are protected. Cannot modify: ${filePath}`,
65
- };
66
- }
67
- }
68
-
69
- // Bash targeting sentinel files or dangerous commands
70
- if (toolName === 'Bash') {
71
- const command = extractBashCommand(toolInput);
72
- if (command && isSentinelPath(command)) {
73
- return {
74
- decision: 'block',
75
- reason: `Sentinel files are protected. Dangerous command targeting sentinel path.`,
76
- };
77
- }
78
- if (command && DANGEROUS_BASH_RE.test(command)) {
79
- // Check if command targets sentinel files
80
- if (command.includes(SENTINEL_PATH_PREFIX) || command.includes('src/infra/lib/autonomy')) {
81
- return {
82
- decision: 'block',
83
- reason: `Dangerous command targeting sentinel path: ${command}`,
84
- };
85
- }
86
- }
87
- }
88
-
89
- // Allow — return undefined for normal flow
90
- return undefined;
91
- }
92
-
93
- // Main execution
94
- const toolName = process.argv[2] || '';
95
- const toolInput = process.argv[3] || process.env.TOOL_INPUT || '';
96
-
97
- const result = guard(toolName, toolInput);
98
-
99
- if (result) {
100
- console.log(JSON.stringify(result));
101
- process.exit(1);
102
- }
103
-
104
- process.exit(0);
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Sentinel Guard — PreToolUse hook
4
+ * Protects sentinel files and blocks dangerous operations.
5
+ * Runs before pre-tool-guard.js.
6
+ */
7
+
8
+ const SENTINEL_PATH_PREFIX = 'src/infra/lib/autonomy/';
9
+
10
+ const SENTINEL_PATH_RE = /^(\.\/|\.\\)?src[\\/]infra[\\/]lib[\\/]autonomy[\\/]/;
11
+
12
+ const DANGEROUS_BASH_RE =
13
+ /\b(rm\s+-rf|kill\s+-9|drop\s+table|truncate|shutdown|reboot|mkfs|dd\s+if=)\b/i;
14
+
15
+ /**
16
+ * Extract file path from tool input
17
+ */
18
+ function extractFilePath(toolName, input) {
19
+ if (!input) return null;
20
+ try {
21
+ const parsed = typeof input === 'string' ? JSON.parse(input) : input;
22
+ if (toolName === 'Write' || toolName === 'Edit' || toolName === 'Read') {
23
+ return parsed.file_path || parsed.filePath || null;
24
+ }
25
+ } catch {
26
+ // Not JSON, try as plain string
27
+ return typeof input === 'string' ? input : null;
28
+ }
29
+ return null;
30
+ }
31
+
32
+ /**
33
+ * Extract command from Bash tool input
34
+ */
35
+ function extractBashCommand(input) {
36
+ if (!input) return null;
37
+ try {
38
+ const parsed = typeof input === 'string' ? JSON.parse(input) : input;
39
+ return parsed.command || null;
40
+ } catch {
41
+ return typeof input === 'string' ? input : null;
42
+ }
43
+ }
44
+
45
+ /**
46
+ * Check if path targets sentinel files
47
+ */
48
+ function isSentinelPath(filePath) {
49
+ if (!filePath) return false;
50
+ const normalized = filePath.replace(/\\/g, '/').replace(/^\.\//, '');
51
+ return normalized.startsWith(SENTINEL_PATH_PREFIX) || SENTINEL_PATH_RE.test(filePath);
52
+ }
53
+
54
+ /**
55
+ * Main guard logic
56
+ */
57
+ function guard(toolName, toolInput) {
58
+ // Write/Edit targeting sentinel files → block
59
+ if (toolName === 'Write' || toolName === 'Edit') {
60
+ const filePath = extractFilePath(toolName, toolInput);
61
+ if (isSentinelPath(filePath)) {
62
+ return {
63
+ decision: 'block',
64
+ reason: `Sentinel files are protected. Cannot modify: ${filePath}`,
65
+ };
66
+ }
67
+ }
68
+
69
+ // Bash targeting sentinel files or dangerous commands
70
+ if (toolName === 'Bash') {
71
+ const command = extractBashCommand(toolInput);
72
+ if (command && isSentinelPath(command)) {
73
+ return {
74
+ decision: 'block',
75
+ reason: `Sentinel files are protected. Dangerous command targeting sentinel path.`,
76
+ };
77
+ }
78
+ if (command && DANGEROUS_BASH_RE.test(command)) {
79
+ // Check if command targets sentinel files
80
+ if (command.includes(SENTINEL_PATH_PREFIX) || command.includes('src/infra/lib/autonomy')) {
81
+ return {
82
+ decision: 'block',
83
+ reason: `Dangerous command targeting sentinel path: ${command}`,
84
+ };
85
+ }
86
+ }
87
+ }
88
+
89
+ // Allow — return undefined for normal flow
90
+ return undefined;
91
+ }
92
+
93
+ // Main execution
94
+ const toolName = process.argv[2] || '';
95
+ const toolInput = process.argv[3] || process.env.TOOL_INPUT || '';
96
+
97
+ const result = guard(toolName, toolInput);
98
+
99
+ if (result) {
100
+ console.log(JSON.stringify(result));
101
+ process.exit(1);
102
+ }
103
+
104
+ process.exit(0);