@su-record/vibe 2.6.17 → 2.6.19

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 (247) hide show
  1. package/CLAUDE.md +153 -681
  2. package/LICENSE +21 -21
  3. package/README.md +236 -239
  4. package/agents/architect-low.md +41 -41
  5. package/agents/architect-medium.md +59 -59
  6. package/agents/architect.md +80 -80
  7. package/agents/build-error-resolver.md +115 -115
  8. package/agents/compounder.md +261 -261
  9. package/agents/diagrammer.md +178 -178
  10. package/agents/e2e-tester.md +266 -266
  11. package/agents/explorer-low.md +42 -42
  12. package/agents/explorer-medium.md +59 -59
  13. package/agents/explorer.md +48 -48
  14. package/agents/implementer-low.md +43 -43
  15. package/agents/implementer-medium.md +52 -52
  16. package/agents/implementer.md +54 -54
  17. package/agents/refactor-cleaner.md +143 -143
  18. package/agents/research/best-practices-agent.md +199 -199
  19. package/agents/research/codebase-patterns-agent.md +157 -157
  20. package/agents/research/framework-docs-agent.md +188 -188
  21. package/agents/research/security-advisory-agent.md +213 -213
  22. package/agents/review/architecture-reviewer.md +107 -107
  23. package/agents/review/complexity-reviewer.md +116 -116
  24. package/agents/review/data-integrity-reviewer.md +88 -88
  25. package/agents/review/git-history-reviewer.md +103 -103
  26. package/agents/review/performance-reviewer.md +86 -86
  27. package/agents/review/python-reviewer.md +150 -150
  28. package/agents/review/rails-reviewer.md +139 -139
  29. package/agents/review/react-reviewer.md +144 -144
  30. package/agents/review/security-reviewer.md +80 -80
  31. package/agents/review/simplicity-reviewer.md +140 -140
  32. package/agents/review/test-coverage-reviewer.md +116 -116
  33. package/agents/review/typescript-reviewer.md +127 -127
  34. package/agents/searcher.md +54 -54
  35. package/agents/simplifier.md +120 -120
  36. package/agents/tester.md +49 -49
  37. package/agents/ui-previewer.md +268 -268
  38. package/commands/vibe.analyze.md +356 -356
  39. package/commands/vibe.reason.md +329 -329
  40. package/commands/vibe.review.md +412 -412
  41. package/commands/vibe.run.md +1303 -1266
  42. package/commands/vibe.spec.md +1054 -1054
  43. package/commands/vibe.spec.review.md +372 -319
  44. package/commands/vibe.trace.md +161 -161
  45. package/commands/vibe.utils.md +376 -376
  46. package/commands/vibe.verify.md +375 -375
  47. package/dist/cli/collaborator.js +52 -52
  48. package/dist/cli/detect.js +32 -32
  49. package/dist/cli/hud.js +20 -20
  50. package/dist/cli/index.d.ts.map +1 -1
  51. package/dist/cli/index.js +120 -118
  52. package/dist/cli/index.js.map +1 -1
  53. package/dist/cli/llm.js +144 -144
  54. package/dist/cli/postinstall.d.ts +1 -6
  55. package/dist/cli/postinstall.d.ts.map +1 -1
  56. package/dist/cli/postinstall.js +877 -859
  57. package/dist/cli/postinstall.js.map +1 -1
  58. package/dist/cli/setup/ProjectSetup.d.ts +2 -2
  59. package/dist/cli/setup/ProjectSetup.d.ts.map +1 -1
  60. package/dist/cli/setup/ProjectSetup.js +51 -17
  61. package/dist/cli/setup/ProjectSetup.js.map +1 -1
  62. package/dist/lib/DeepInit.js +24 -24
  63. package/dist/lib/IterationTracker.js +11 -11
  64. package/dist/lib/ProgressTracker.d.ts +5 -0
  65. package/dist/lib/ProgressTracker.d.ts.map +1 -1
  66. package/dist/lib/ProgressTracker.js +56 -0
  67. package/dist/lib/ProgressTracker.js.map +1 -1
  68. package/dist/lib/PythonParser.js +108 -108
  69. package/dist/lib/ReviewRace.js +96 -96
  70. package/dist/lib/SkillFrontmatter.js +28 -28
  71. package/dist/lib/SkillQualityGate.js +9 -9
  72. package/dist/lib/SkillRepository.js +159 -159
  73. package/dist/lib/UltraQA.js +77 -77
  74. package/dist/lib/gemini-api.js +5 -5
  75. package/dist/lib/gpt-api.js +4 -4
  76. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  77. package/dist/lib/memory/MemorySearch.js +20 -20
  78. package/dist/lib/memory/MemoryStorage.js +64 -64
  79. package/dist/orchestrator/AgentManager.js +12 -12
  80. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  81. package/dist/orchestrator/PhasePipeline.d.ts +2 -0
  82. package/dist/orchestrator/PhasePipeline.d.ts.map +1 -1
  83. package/dist/orchestrator/PhasePipeline.js +34 -0
  84. package/dist/orchestrator/PhasePipeline.js.map +1 -1
  85. package/dist/orchestrator/SmartRouter.js +11 -11
  86. package/dist/orchestrator/SwarmOrchestrator.test.js +16 -16
  87. package/dist/orchestrator/parallelResearch.js +24 -24
  88. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  89. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  90. package/dist/tools/spec/prdParser.test.js +171 -171
  91. package/dist/tools/spec/specGenerator.js +169 -169
  92. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  93. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  94. package/hooks/hooks.json +115 -222
  95. package/hooks/scripts/code-check.js +22 -22
  96. package/hooks/scripts/code-review.js +22 -22
  97. package/hooks/scripts/complexity.js +22 -22
  98. package/hooks/scripts/compound.js +23 -23
  99. package/hooks/scripts/context-save.js +33 -33
  100. package/hooks/scripts/gemini-ui-gen.js +281 -281
  101. package/hooks/scripts/generate-brand-assets.js +474 -474
  102. package/hooks/scripts/hud-multiline.js +262 -262
  103. package/hooks/scripts/hud-status.js +291 -291
  104. package/hooks/scripts/keyword-detector.js +214 -214
  105. package/hooks/scripts/llm-orchestrate.js +171 -171
  106. package/hooks/scripts/post-edit.js +97 -97
  107. package/hooks/scripts/post-tool-verify.js +210 -210
  108. package/hooks/scripts/pre-tool-guard.js +125 -125
  109. package/hooks/scripts/prompt-dispatcher.js +161 -0
  110. package/hooks/scripts/recall.js +22 -22
  111. package/hooks/scripts/session-start.js +30 -30
  112. package/hooks/scripts/skill-injector.js +191 -191
  113. package/hooks/scripts/utils.js +97 -97
  114. package/languages/csharp-unity.md +515 -515
  115. package/languages/gdscript-godot.md +470 -470
  116. package/languages/ruby-rails.md +489 -489
  117. package/languages/typescript-angular.md +433 -433
  118. package/languages/typescript-astro.md +416 -416
  119. package/languages/typescript-electron.md +406 -406
  120. package/languages/typescript-nestjs.md +524 -524
  121. package/languages/typescript-svelte.md +407 -407
  122. package/languages/typescript-tauri.md +365 -365
  123. package/package.json +84 -84
  124. package/skills/brand-assets.md +141 -141
  125. package/skills/commerce-patterns.md +361 -361
  126. package/skills/context7-usage.md +102 -102
  127. package/skills/e2e-commerce.md +304 -304
  128. package/skills/frontend-design.md +92 -92
  129. package/skills/git-worktree.md +181 -181
  130. package/skills/parallel-research.md +77 -77
  131. package/skills/priority-todos.md +239 -239
  132. package/skills/seo-checklist.md +244 -244
  133. package/skills/tool-fallback.md +190 -190
  134. package/skills/vibe-capabilities.md +161 -161
  135. package/vibe/constitution.md +227 -227
  136. package/vibe/rules/core/communication-guide.md +98 -98
  137. package/vibe/rules/core/development-philosophy.md +52 -52
  138. package/vibe/rules/core/quick-start.md +102 -102
  139. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  140. package/vibe/rules/quality/checklist.md +276 -276
  141. package/vibe/rules/quality/testing-strategy.md +440 -440
  142. package/vibe/rules/standards/anti-patterns.md +541 -541
  143. package/vibe/rules/standards/code-structure.md +291 -291
  144. package/vibe/rules/standards/complexity-metrics.md +313 -313
  145. package/vibe/rules/standards/naming-conventions.md +198 -198
  146. package/vibe/setup.sh +31 -31
  147. package/vibe/templates/constitution-template.md +252 -252
  148. package/vibe/templates/contract-backend-template.md +526 -526
  149. package/vibe/templates/contract-frontend-template.md +599 -599
  150. package/vibe/templates/feature-template.md +96 -96
  151. package/vibe/templates/spec-template.md +221 -221
  152. package/dist/cli/mcp.d.ts +0 -49
  153. package/dist/cli/mcp.d.ts.map +0 -1
  154. package/dist/cli/mcp.js +0 -169
  155. package/dist/cli/mcp.js.map +0 -1
  156. package/dist/lib/gemini-mcp.d.ts +0 -10
  157. package/dist/lib/gemini-mcp.d.ts.map +0 -1
  158. package/dist/lib/gemini-mcp.js +0 -353
  159. package/dist/lib/gemini-mcp.js.map +0 -1
  160. package/dist/lib/gpt-mcp.d.ts +0 -10
  161. package/dist/lib/gpt-mcp.d.ts.map +0 -1
  162. package/dist/lib/gpt-mcp.js +0 -352
  163. package/dist/lib/gpt-mcp.js.map +0 -1
  164. package/dist/tools/analytics/getUsageAnalytics.d.ts +0 -10
  165. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +0 -1
  166. package/dist/tools/analytics/getUsageAnalytics.js +0 -246
  167. package/dist/tools/analytics/getUsageAnalytics.js.map +0 -1
  168. package/dist/tools/analytics/index.d.ts +0 -5
  169. package/dist/tools/analytics/index.d.ts.map +0 -1
  170. package/dist/tools/analytics/index.js +0 -5
  171. package/dist/tools/analytics/index.js.map +0 -1
  172. package/dist/tools/convention/getCodingGuide.d.ts +0 -7
  173. package/dist/tools/convention/getCodingGuide.d.ts.map +0 -1
  174. package/dist/tools/convention/getCodingGuide.js +0 -69
  175. package/dist/tools/convention/getCodingGuide.js.map +0 -1
  176. package/dist/tools/planning/analyzeRequirements.d.ts +0 -9
  177. package/dist/tools/planning/analyzeRequirements.d.ts.map +0 -1
  178. package/dist/tools/planning/analyzeRequirements.js +0 -171
  179. package/dist/tools/planning/analyzeRequirements.js.map +0 -1
  180. package/dist/tools/planning/createUserStories.d.ts +0 -9
  181. package/dist/tools/planning/createUserStories.d.ts.map +0 -1
  182. package/dist/tools/planning/createUserStories.js +0 -124
  183. package/dist/tools/planning/createUserStories.js.map +0 -1
  184. package/dist/tools/planning/featureRoadmap.d.ts +0 -10
  185. package/dist/tools/planning/featureRoadmap.d.ts.map +0 -1
  186. package/dist/tools/planning/featureRoadmap.js +0 -207
  187. package/dist/tools/planning/featureRoadmap.js.map +0 -1
  188. package/dist/tools/planning/generatePrd.d.ts +0 -11
  189. package/dist/tools/planning/generatePrd.d.ts.map +0 -1
  190. package/dist/tools/planning/generatePrd.js +0 -161
  191. package/dist/tools/planning/generatePrd.js.map +0 -1
  192. package/dist/tools/planning/index.d.ts +0 -8
  193. package/dist/tools/planning/index.d.ts.map +0 -1
  194. package/dist/tools/planning/index.js +0 -8
  195. package/dist/tools/planning/index.js.map +0 -1
  196. package/dist/tools/prompt/analyzePrompt.d.ts +0 -7
  197. package/dist/tools/prompt/analyzePrompt.d.ts.map +0 -1
  198. package/dist/tools/prompt/analyzePrompt.js +0 -150
  199. package/dist/tools/prompt/analyzePrompt.js.map +0 -1
  200. package/dist/tools/prompt/enhancePrompt.d.ts +0 -8
  201. package/dist/tools/prompt/enhancePrompt.d.ts.map +0 -1
  202. package/dist/tools/prompt/enhancePrompt.js +0 -110
  203. package/dist/tools/prompt/enhancePrompt.js.map +0 -1
  204. package/dist/tools/prompt/enhancePromptGemini.d.ts +0 -8
  205. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +0 -1
  206. package/dist/tools/prompt/enhancePromptGemini.js +0 -332
  207. package/dist/tools/prompt/enhancePromptGemini.js.map +0 -1
  208. package/dist/tools/prompt/index.d.ts +0 -7
  209. package/dist/tools/prompt/index.d.ts.map +0 -1
  210. package/dist/tools/prompt/index.js +0 -7
  211. package/dist/tools/prompt/index.js.map +0 -1
  212. package/dist/tools/reasoning/applyReasoningFramework.d.ts +0 -8
  213. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +0 -1
  214. package/dist/tools/reasoning/applyReasoningFramework.js +0 -266
  215. package/dist/tools/reasoning/applyReasoningFramework.js.map +0 -1
  216. package/dist/tools/reasoning/index.d.ts +0 -5
  217. package/dist/tools/reasoning/index.d.ts.map +0 -1
  218. package/dist/tools/reasoning/index.js +0 -5
  219. package/dist/tools/reasoning/index.js.map +0 -1
  220. package/dist/tools/thinking/analyzeProblem.d.ts +0 -7
  221. package/dist/tools/thinking/analyzeProblem.d.ts.map +0 -1
  222. package/dist/tools/thinking/analyzeProblem.js +0 -55
  223. package/dist/tools/thinking/analyzeProblem.js.map +0 -1
  224. package/dist/tools/thinking/breakDownProblem.d.ts +0 -8
  225. package/dist/tools/thinking/breakDownProblem.d.ts.map +0 -1
  226. package/dist/tools/thinking/breakDownProblem.js +0 -145
  227. package/dist/tools/thinking/breakDownProblem.js.map +0 -1
  228. package/dist/tools/thinking/createThinkingChain.d.ts +0 -7
  229. package/dist/tools/thinking/createThinkingChain.d.ts.map +0 -1
  230. package/dist/tools/thinking/createThinkingChain.js +0 -44
  231. package/dist/tools/thinking/createThinkingChain.js.map +0 -1
  232. package/dist/tools/thinking/formatAsPlan.d.ts +0 -9
  233. package/dist/tools/thinking/formatAsPlan.d.ts.map +0 -1
  234. package/dist/tools/thinking/formatAsPlan.js +0 -78
  235. package/dist/tools/thinking/formatAsPlan.js.map +0 -1
  236. package/dist/tools/thinking/index.d.ts +0 -10
  237. package/dist/tools/thinking/index.d.ts.map +0 -1
  238. package/dist/tools/thinking/index.js +0 -10
  239. package/dist/tools/thinking/index.js.map +0 -1
  240. package/dist/tools/thinking/stepByStepAnalysis.d.ts +0 -8
  241. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +0 -1
  242. package/dist/tools/thinking/stepByStepAnalysis.js +0 -63
  243. package/dist/tools/thinking/stepByStepAnalysis.js.map +0 -1
  244. package/dist/tools/thinking/thinkAloudProcess.d.ts +0 -8
  245. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +0 -1
  246. package/dist/tools/thinking/thinkAloudProcess.js +0 -80
  247. package/dist/tools/thinking/thinkAloudProcess.js.map +0 -1
@@ -1,210 +1,210 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Post-Tool Verify
4
- * 도구 실행 후 결과 검증 및 에러 복구 힌트 제공
5
- */
6
-
7
- import { VIBE_PATH, PROJECT_DIR } from './utils.js';
8
-
9
- // 에러 패턴 및 복구 힌트
10
- const ERROR_RECOVERY_HINTS = {
11
- // Edit 에러
12
- 'old_string not found': {
13
- hint: 'The text to replace was not found. Common causes:',
14
- suggestions: [
15
- 'File was modified since last read - re-read the file first',
16
- 'Whitespace mismatch (tabs vs spaces, trailing spaces)',
17
- 'Line endings differ (CRLF vs LF)',
18
- 'Text spans multiple lines - try smaller chunks',
19
- ],
20
- action: 'Read the file again to get the current content',
21
- },
22
- 'not unique': {
23
- hint: 'Multiple matches found for old_string.',
24
- suggestions: [
25
- 'Include more surrounding context to make it unique',
26
- 'Use replace_all: true if you want to replace all occurrences',
27
- 'Add line numbers or function names for context',
28
- ],
29
- action: 'Expand the old_string to include more unique context',
30
- },
31
-
32
- // Bash 에러
33
- 'command not found': {
34
- hint: 'Command is not installed or not in PATH.',
35
- suggestions: [
36
- 'Check if the package is installed',
37
- 'Try using the full path to the command',
38
- 'For npm packages, ensure node_modules/.bin is in PATH or use npx',
39
- ],
40
- action: 'Install the required package or use an alternative command',
41
- },
42
- 'permission denied': {
43
- hint: 'Insufficient permissions for this operation.',
44
- suggestions: [
45
- 'Check file/directory permissions',
46
- 'For sudo operations, ensure user has proper access',
47
- 'On Windows, run as Administrator if needed',
48
- ],
49
- action: 'Check and fix permissions, or use a different approach',
50
- },
51
- 'ENOENT': {
52
- hint: 'File or directory does not exist.',
53
- suggestions: [
54
- 'Verify the path is correct',
55
- 'Create parent directories first with mkdir -p',
56
- 'Check for typos in the path',
57
- ],
58
- action: 'Create the missing directories or fix the path',
59
- },
60
- 'EACCES': {
61
- hint: 'Access denied to file or directory.',
62
- suggestions: [
63
- 'Check file ownership and permissions',
64
- 'Ensure the directory is not read-only',
65
- ],
66
- action: 'Fix permissions or choose a different location',
67
- },
68
-
69
- // Git 에러
70
- 'merge conflict': {
71
- hint: 'Git merge conflict detected.',
72
- suggestions: [
73
- 'Review conflicting files',
74
- 'Choose which changes to keep',
75
- 'Use git mergetool for complex conflicts',
76
- ],
77
- action: 'Resolve conflicts in the marked files, then git add and commit',
78
- },
79
- 'detached HEAD': {
80
- hint: 'Git is in detached HEAD state.',
81
- suggestions: [
82
- 'Create a branch to save your work: git checkout -b new-branch',
83
- 'Return to a branch: git checkout main',
84
- ],
85
- action: 'Create a branch if you want to keep changes',
86
- },
87
- 'diverged': {
88
- hint: 'Local and remote branches have diverged.',
89
- suggestions: [
90
- 'Pull with rebase: git pull --rebase',
91
- 'Or merge: git pull',
92
- 'Review differences first: git log HEAD..origin/main',
93
- ],
94
- action: 'Decide whether to rebase or merge',
95
- },
96
-
97
- // TypeScript/Build 에러
98
- 'Cannot find module': {
99
- hint: 'Module import failed.',
100
- suggestions: [
101
- 'Run npm install to ensure dependencies are installed',
102
- 'Check if the module path is correct',
103
- 'For local modules, verify the file exists',
104
- 'Check tsconfig.json paths configuration',
105
- ],
106
- action: 'Install missing dependencies or fix the import path',
107
- },
108
- 'Type error': {
109
- hint: 'TypeScript type mismatch.',
110
- suggestions: [
111
- 'Check the expected type in the function/variable definition',
112
- 'Use type assertion if confident (value as Type)',
113
- 'Add proper type guards for union types',
114
- ],
115
- action: 'Fix the type mismatch or add proper type handling',
116
- },
117
- };
118
-
119
- // 성공 패턴 감지
120
- const SUCCESS_PATTERNS = [
121
- /✓|✅|success|passed|complete|done/i,
122
- /^0 errors?$/im,
123
- /all tests passed/i,
124
- /build succeeded/i,
125
- ];
126
-
127
- /**
128
- * 출력에서 에러 감지 및 힌트 생성
129
- */
130
- function analyzeOutput(toolName, output, exitCode) {
131
- const result = {
132
- hasError: exitCode !== 0,
133
- hints: [],
134
- suggestions: [],
135
- recoveryAction: null,
136
- };
137
-
138
- // 성공 패턴 확인
139
- if (SUCCESS_PATTERNS.some(p => p.test(output))) {
140
- result.hasError = false;
141
- return result;
142
- }
143
-
144
- // 에러 패턴 매칭
145
- for (const [pattern, recovery] of Object.entries(ERROR_RECOVERY_HINTS)) {
146
- if (output.toLowerCase().includes(pattern.toLowerCase())) {
147
- result.hints.push(recovery.hint);
148
- result.suggestions.push(...recovery.suggestions);
149
- if (!result.recoveryAction) {
150
- result.recoveryAction = recovery.action;
151
- }
152
- }
153
- }
154
-
155
- // 에러가 감지됐는데 힌트가 없으면 일반 힌트 제공
156
- if (result.hasError && result.hints.length === 0) {
157
- result.hints.push('An error occurred. Check the output for details.');
158
- result.suggestions.push(
159
- 'Review the full error message',
160
- 'Search for the error message online',
161
- 'Check if similar issues exist in the project',
162
- );
163
- }
164
-
165
- return result;
166
- }
167
-
168
- /**
169
- * 출력 포맷
170
- */
171
- function formatRecoveryHint(toolName, analysis) {
172
- if (!analysis.hasError || analysis.hints.length === 0) {
173
- return '';
174
- }
175
-
176
- const lines = [];
177
- lines.push(`💡 POST-TOOL HINT: ${toolName} encountered an issue`);
178
- lines.push('');
179
-
180
- for (const hint of analysis.hints) {
181
- lines.push(`📌 ${hint}`);
182
- }
183
-
184
- if (analysis.suggestions.length > 0) {
185
- lines.push('');
186
- lines.push('Possible solutions:');
187
- for (const suggestion of analysis.suggestions) {
188
- lines.push(` • ${suggestion}`);
189
- }
190
- }
191
-
192
- if (analysis.recoveryAction) {
193
- lines.push('');
194
- lines.push(`🔧 Recommended action: ${analysis.recoveryAction}`);
195
- }
196
-
197
- return lines.join('\n');
198
- }
199
-
200
- // 메인 실행
201
- const toolName = process.argv[2] || 'unknown';
202
- const exitCode = parseInt(process.argv[3] || '0', 10);
203
- const output = process.argv[4] || process.env.TOOL_OUTPUT || '';
204
-
205
- const analysis = analyzeOutput(toolName, output, exitCode);
206
- const hint = formatRecoveryHint(toolName, analysis);
207
-
208
- if (hint) {
209
- console.log(hint);
210
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Post-Tool Verify
4
+ * 도구 실행 후 결과 검증 및 에러 복구 힌트 제공
5
+ */
6
+
7
+ import { VIBE_PATH, PROJECT_DIR } from './utils.js';
8
+
9
+ // 에러 패턴 및 복구 힌트
10
+ const ERROR_RECOVERY_HINTS = {
11
+ // Edit 에러
12
+ 'old_string not found': {
13
+ hint: 'The text to replace was not found. Common causes:',
14
+ suggestions: [
15
+ 'File was modified since last read - re-read the file first',
16
+ 'Whitespace mismatch (tabs vs spaces, trailing spaces)',
17
+ 'Line endings differ (CRLF vs LF)',
18
+ 'Text spans multiple lines - try smaller chunks',
19
+ ],
20
+ action: 'Read the file again to get the current content',
21
+ },
22
+ 'not unique': {
23
+ hint: 'Multiple matches found for old_string.',
24
+ suggestions: [
25
+ 'Include more surrounding context to make it unique',
26
+ 'Use replace_all: true if you want to replace all occurrences',
27
+ 'Add line numbers or function names for context',
28
+ ],
29
+ action: 'Expand the old_string to include more unique context',
30
+ },
31
+
32
+ // Bash 에러
33
+ 'command not found': {
34
+ hint: 'Command is not installed or not in PATH.',
35
+ suggestions: [
36
+ 'Check if the package is installed',
37
+ 'Try using the full path to the command',
38
+ 'For npm packages, ensure node_modules/.bin is in PATH or use npx',
39
+ ],
40
+ action: 'Install the required package or use an alternative command',
41
+ },
42
+ 'permission denied': {
43
+ hint: 'Insufficient permissions for this operation.',
44
+ suggestions: [
45
+ 'Check file/directory permissions',
46
+ 'For sudo operations, ensure user has proper access',
47
+ 'On Windows, run as Administrator if needed',
48
+ ],
49
+ action: 'Check and fix permissions, or use a different approach',
50
+ },
51
+ 'ENOENT': {
52
+ hint: 'File or directory does not exist.',
53
+ suggestions: [
54
+ 'Verify the path is correct',
55
+ 'Create parent directories first with mkdir -p',
56
+ 'Check for typos in the path',
57
+ ],
58
+ action: 'Create the missing directories or fix the path',
59
+ },
60
+ 'EACCES': {
61
+ hint: 'Access denied to file or directory.',
62
+ suggestions: [
63
+ 'Check file ownership and permissions',
64
+ 'Ensure the directory is not read-only',
65
+ ],
66
+ action: 'Fix permissions or choose a different location',
67
+ },
68
+
69
+ // Git 에러
70
+ 'merge conflict': {
71
+ hint: 'Git merge conflict detected.',
72
+ suggestions: [
73
+ 'Review conflicting files',
74
+ 'Choose which changes to keep',
75
+ 'Use git mergetool for complex conflicts',
76
+ ],
77
+ action: 'Resolve conflicts in the marked files, then git add and commit',
78
+ },
79
+ 'detached HEAD': {
80
+ hint: 'Git is in detached HEAD state.',
81
+ suggestions: [
82
+ 'Create a branch to save your work: git checkout -b new-branch',
83
+ 'Return to a branch: git checkout main',
84
+ ],
85
+ action: 'Create a branch if you want to keep changes',
86
+ },
87
+ 'diverged': {
88
+ hint: 'Local and remote branches have diverged.',
89
+ suggestions: [
90
+ 'Pull with rebase: git pull --rebase',
91
+ 'Or merge: git pull',
92
+ 'Review differences first: git log HEAD..origin/main',
93
+ ],
94
+ action: 'Decide whether to rebase or merge',
95
+ },
96
+
97
+ // TypeScript/Build 에러
98
+ 'Cannot find module': {
99
+ hint: 'Module import failed.',
100
+ suggestions: [
101
+ 'Run npm install to ensure dependencies are installed',
102
+ 'Check if the module path is correct',
103
+ 'For local modules, verify the file exists',
104
+ 'Check tsconfig.json paths configuration',
105
+ ],
106
+ action: 'Install missing dependencies or fix the import path',
107
+ },
108
+ 'Type error': {
109
+ hint: 'TypeScript type mismatch.',
110
+ suggestions: [
111
+ 'Check the expected type in the function/variable definition',
112
+ 'Use type assertion if confident (value as Type)',
113
+ 'Add proper type guards for union types',
114
+ ],
115
+ action: 'Fix the type mismatch or add proper type handling',
116
+ },
117
+ };
118
+
119
+ // 성공 패턴 감지
120
+ const SUCCESS_PATTERNS = [
121
+ /✓|✅|success|passed|complete|done/i,
122
+ /^0 errors?$/im,
123
+ /all tests passed/i,
124
+ /build succeeded/i,
125
+ ];
126
+
127
+ /**
128
+ * 출력에서 에러 감지 및 힌트 생성
129
+ */
130
+ function analyzeOutput(toolName, output, exitCode) {
131
+ const result = {
132
+ hasError: exitCode !== 0,
133
+ hints: [],
134
+ suggestions: [],
135
+ recoveryAction: null,
136
+ };
137
+
138
+ // 성공 패턴 확인
139
+ if (SUCCESS_PATTERNS.some(p => p.test(output))) {
140
+ result.hasError = false;
141
+ return result;
142
+ }
143
+
144
+ // 에러 패턴 매칭
145
+ for (const [pattern, recovery] of Object.entries(ERROR_RECOVERY_HINTS)) {
146
+ if (output.toLowerCase().includes(pattern.toLowerCase())) {
147
+ result.hints.push(recovery.hint);
148
+ result.suggestions.push(...recovery.suggestions);
149
+ if (!result.recoveryAction) {
150
+ result.recoveryAction = recovery.action;
151
+ }
152
+ }
153
+ }
154
+
155
+ // 에러가 감지됐는데 힌트가 없으면 일반 힌트 제공
156
+ if (result.hasError && result.hints.length === 0) {
157
+ result.hints.push('An error occurred. Check the output for details.');
158
+ result.suggestions.push(
159
+ 'Review the full error message',
160
+ 'Search for the error message online',
161
+ 'Check if similar issues exist in the project',
162
+ );
163
+ }
164
+
165
+ return result;
166
+ }
167
+
168
+ /**
169
+ * 출력 포맷
170
+ */
171
+ function formatRecoveryHint(toolName, analysis) {
172
+ if (!analysis.hasError || analysis.hints.length === 0) {
173
+ return '';
174
+ }
175
+
176
+ const lines = [];
177
+ lines.push(`💡 POST-TOOL HINT: ${toolName} encountered an issue`);
178
+ lines.push('');
179
+
180
+ for (const hint of analysis.hints) {
181
+ lines.push(`📌 ${hint}`);
182
+ }
183
+
184
+ if (analysis.suggestions.length > 0) {
185
+ lines.push('');
186
+ lines.push('Possible solutions:');
187
+ for (const suggestion of analysis.suggestions) {
188
+ lines.push(` • ${suggestion}`);
189
+ }
190
+ }
191
+
192
+ if (analysis.recoveryAction) {
193
+ lines.push('');
194
+ lines.push(`🔧 Recommended action: ${analysis.recoveryAction}`);
195
+ }
196
+
197
+ return lines.join('\n');
198
+ }
199
+
200
+ // 메인 실행
201
+ const toolName = process.argv[2] || 'unknown';
202
+ const exitCode = parseInt(process.argv[3] || '0', 10);
203
+ const output = process.argv[4] || process.env.TOOL_OUTPUT || '';
204
+
205
+ const analysis = analyzeOutput(toolName, output, exitCode);
206
+ const hint = formatRecoveryHint(toolName, analysis);
207
+
208
+ if (hint) {
209
+ console.log(hint);
210
+ }
@@ -1,125 +1,125 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Pre-Tool Guard
4
- * 위험한 도구 사용 전 검증 및 경고
5
- */
6
-
7
- import { VIBE_PATH, PROJECT_DIR } from './utils.js';
8
-
9
- // 위험한 명령어 패턴
10
- const DANGEROUS_PATTERNS = {
11
- bash: [
12
- { pattern: /rm\s+-rf?\s+[\/~]/, severity: 'critical', message: 'Deleting root or home directory' },
13
- { pattern: /rm\s+-rf?\s+\*/, severity: 'high', message: 'Wildcard deletion detected' },
14
- { pattern: /git\s+push\s+.*--force/, severity: 'high', message: 'Force push detected' },
15
- { pattern: /git\s+reset\s+--hard/, severity: 'medium', message: 'Hard reset will discard changes' },
16
- { pattern: /drop\s+(table|database)/i, severity: 'critical', message: 'Database drop detected' },
17
- { pattern: /truncate\s+table/i, severity: 'high', message: 'Table truncate detected' },
18
- { pattern: /:(){ :|:& };:/, severity: 'critical', message: 'Fork bomb detected' },
19
- { pattern: /mkfs|fdisk|dd\s+if=/, severity: 'critical', message: 'Disk operation detected' },
20
- { pattern: /chmod\s+-R\s+777/, severity: 'medium', message: 'Insecure permission change' },
21
- { pattern: /curl.*\|\s*(ba)?sh/, severity: 'high', message: 'Piping curl to shell' },
22
- ],
23
- edit: [
24
- { pattern: /\.env|credentials|secret|password|api[_-]?key/i, severity: 'medium', message: 'Editing sensitive file' },
25
- { pattern: /package-lock\.json|yarn\.lock|pnpm-lock/, severity: 'low', message: 'Editing lock file directly' },
26
- ],
27
- write: [
28
- { pattern: /\.env|credentials|secret/i, severity: 'medium', message: 'Writing to sensitive file' },
29
- { pattern: /\/etc\/|\/usr\/|C:\\Windows/i, severity: 'critical', message: 'Writing to system directory' },
30
- ],
31
- };
32
-
33
- // 안전한 대안 제안
34
- const SAFE_ALTERNATIVES = {
35
- 'rm -rf': 'Use trash-cli (trash-put) or move to a backup directory first',
36
- 'git push --force': 'Use git push --force-with-lease instead',
37
- 'git reset --hard': 'Create a backup branch first: git branch backup-$(date +%s)',
38
- 'drop table': 'Consider soft delete or backup first',
39
- 'chmod 777': 'Use specific permissions (e.g., chmod 755 for directories)',
40
- };
41
-
42
- /**
43
- * 명령어 검증
44
- */
45
- function validateCommand(toolName, input) {
46
- const results = {
47
- allowed: true,
48
- severity: 'none',
49
- warnings: [],
50
- suggestions: [],
51
- };
52
-
53
- const patterns = DANGEROUS_PATTERNS[toolName.toLowerCase()] || [];
54
-
55
- for (const { pattern, severity, message } of patterns) {
56
- if (pattern.test(input)) {
57
- results.warnings.push(`[${severity.toUpperCase()}] ${message}`);
58
-
59
- // 심각도에 따른 처리
60
- if (severity === 'critical') {
61
- results.allowed = false;
62
- results.severity = 'critical';
63
- } else if (severity === 'high' && results.severity !== 'critical') {
64
- results.severity = 'high';
65
- } else if (results.severity === 'none') {
66
- results.severity = severity;
67
- }
68
-
69
- // 대안 제안
70
- for (const [dangerous, safe] of Object.entries(SAFE_ALTERNATIVES)) {
71
- if (input.includes(dangerous)) {
72
- results.suggestions.push(safe);
73
- }
74
- }
75
- }
76
- }
77
-
78
- return results;
79
- }
80
-
81
- /**
82
- * 출력 포맷
83
- */
84
- function formatOutput(toolName, validation) {
85
- const lines = [];
86
-
87
- if (validation.warnings.length === 0) {
88
- return ''; // 경고 없으면 출력 없음
89
- }
90
-
91
- lines.push(`⚠️ PRE-TOOL GUARD: ${toolName}`);
92
-
93
- for (const warning of validation.warnings) {
94
- lines.push(` ${warning}`);
95
- }
96
-
97
- if (validation.suggestions.length > 0) {
98
- lines.push('');
99
- lines.push('💡 Suggestions:');
100
- for (const suggestion of validation.suggestions) {
101
- lines.push(` - ${suggestion}`);
102
- }
103
- }
104
-
105
- if (!validation.allowed) {
106
- lines.push('');
107
- lines.push('🚫 BLOCKED: This operation is too dangerous. Please review and modify.');
108
- }
109
-
110
- return lines.join('\n');
111
- }
112
-
113
- // 메인 실행
114
- const toolName = process.argv[2] || 'Bash';
115
- const toolInput = process.argv[3] || process.env.TOOL_INPUT || '';
116
-
117
- const validation = validateCommand(toolName, toolInput);
118
- const output = formatOutput(toolName, validation);
119
-
120
- if (output) {
121
- console.log(output);
122
- }
123
-
124
- // Exit code: 0 = allowed, 1 = blocked
125
- process.exit(validation.allowed ? 0 : 1);
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Pre-Tool Guard
4
+ * 위험한 도구 사용 전 검증 및 경고
5
+ */
6
+
7
+ import { VIBE_PATH, PROJECT_DIR } from './utils.js';
8
+
9
+ // 위험한 명령어 패턴
10
+ const DANGEROUS_PATTERNS = {
11
+ bash: [
12
+ { pattern: /rm\s+-rf?\s+[\/~]/, severity: 'critical', message: 'Deleting root or home directory' },
13
+ { pattern: /rm\s+-rf?\s+\*/, severity: 'high', message: 'Wildcard deletion detected' },
14
+ { pattern: /git\s+push\s+.*--force/, severity: 'high', message: 'Force push detected' },
15
+ { pattern: /git\s+reset\s+--hard/, severity: 'medium', message: 'Hard reset will discard changes' },
16
+ { pattern: /drop\s+(table|database)/i, severity: 'critical', message: 'Database drop detected' },
17
+ { pattern: /truncate\s+table/i, severity: 'high', message: 'Table truncate detected' },
18
+ { pattern: /:(){ :|:& };:/, severity: 'critical', message: 'Fork bomb detected' },
19
+ { pattern: /mkfs|fdisk|dd\s+if=/, severity: 'critical', message: 'Disk operation detected' },
20
+ { pattern: /chmod\s+-R\s+777/, severity: 'medium', message: 'Insecure permission change' },
21
+ { pattern: /curl.*\|\s*(ba)?sh/, severity: 'high', message: 'Piping curl to shell' },
22
+ ],
23
+ edit: [
24
+ { pattern: /\.env|credentials|secret|password|api[_-]?key/i, severity: 'medium', message: 'Editing sensitive file' },
25
+ { pattern: /package-lock\.json|yarn\.lock|pnpm-lock/, severity: 'low', message: 'Editing lock file directly' },
26
+ ],
27
+ write: [
28
+ { pattern: /\.env|credentials|secret/i, severity: 'medium', message: 'Writing to sensitive file' },
29
+ { pattern: /\/etc\/|\/usr\/|C:\\Windows/i, severity: 'critical', message: 'Writing to system directory' },
30
+ ],
31
+ };
32
+
33
+ // 안전한 대안 제안
34
+ const SAFE_ALTERNATIVES = {
35
+ 'rm -rf': 'Use trash-cli (trash-put) or move to a backup directory first',
36
+ 'git push --force': 'Use git push --force-with-lease instead',
37
+ 'git reset --hard': 'Create a backup branch first: git branch backup-$(date +%s)',
38
+ 'drop table': 'Consider soft delete or backup first',
39
+ 'chmod 777': 'Use specific permissions (e.g., chmod 755 for directories)',
40
+ };
41
+
42
+ /**
43
+ * 명령어 검증
44
+ */
45
+ function validateCommand(toolName, input) {
46
+ const results = {
47
+ allowed: true,
48
+ severity: 'none',
49
+ warnings: [],
50
+ suggestions: [],
51
+ };
52
+
53
+ const patterns = DANGEROUS_PATTERNS[toolName.toLowerCase()] || [];
54
+
55
+ for (const { pattern, severity, message } of patterns) {
56
+ if (pattern.test(input)) {
57
+ results.warnings.push(`[${severity.toUpperCase()}] ${message}`);
58
+
59
+ // 심각도에 따른 처리
60
+ if (severity === 'critical') {
61
+ results.allowed = false;
62
+ results.severity = 'critical';
63
+ } else if (severity === 'high' && results.severity !== 'critical') {
64
+ results.severity = 'high';
65
+ } else if (results.severity === 'none') {
66
+ results.severity = severity;
67
+ }
68
+
69
+ // 대안 제안
70
+ for (const [dangerous, safe] of Object.entries(SAFE_ALTERNATIVES)) {
71
+ if (input.includes(dangerous)) {
72
+ results.suggestions.push(safe);
73
+ }
74
+ }
75
+ }
76
+ }
77
+
78
+ return results;
79
+ }
80
+
81
+ /**
82
+ * 출력 포맷
83
+ */
84
+ function formatOutput(toolName, validation) {
85
+ const lines = [];
86
+
87
+ if (validation.warnings.length === 0) {
88
+ return ''; // 경고 없으면 출력 없음
89
+ }
90
+
91
+ lines.push(`⚠️ PRE-TOOL GUARD: ${toolName}`);
92
+
93
+ for (const warning of validation.warnings) {
94
+ lines.push(` ${warning}`);
95
+ }
96
+
97
+ if (validation.suggestions.length > 0) {
98
+ lines.push('');
99
+ lines.push('💡 Suggestions:');
100
+ for (const suggestion of validation.suggestions) {
101
+ lines.push(` - ${suggestion}`);
102
+ }
103
+ }
104
+
105
+ if (!validation.allowed) {
106
+ lines.push('');
107
+ lines.push('🚫 BLOCKED: This operation is too dangerous. Please review and modify.');
108
+ }
109
+
110
+ return lines.join('\n');
111
+ }
112
+
113
+ // 메인 실행
114
+ const toolName = process.argv[2] || 'Bash';
115
+ const toolInput = process.argv[3] || process.env.TOOL_INPUT || '';
116
+
117
+ const validation = validateCommand(toolName, toolInput);
118
+ const output = formatOutput(toolName, validation);
119
+
120
+ if (output) {
121
+ console.log(output);
122
+ }
123
+
124
+ // Exit code: 0 = allowed, 1 = blocked
125
+ process.exit(validation.allowed ? 0 : 1);