@su-record/vibe 2.6.26 → 2.6.28

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 (287) hide show
  1. package/CLAUDE.md +202 -153
  2. package/LICENSE +21 -21
  3. package/README.md +267 -236
  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/docs/api-documenter.md +99 -99
  11. package/agents/docs/changelog-writer.md +93 -93
  12. package/agents/e2e-tester.md +266 -266
  13. package/agents/explorer-low.md +42 -42
  14. package/agents/explorer-medium.md +59 -59
  15. package/agents/explorer.md +48 -48
  16. package/agents/implementer-low.md +43 -43
  17. package/agents/implementer-medium.md +52 -52
  18. package/agents/implementer.md +54 -54
  19. package/agents/planning/requirements-analyst.md +84 -84
  20. package/agents/planning/ux-advisor.md +83 -83
  21. package/agents/qa/acceptance-tester.md +86 -86
  22. package/agents/qa/edge-case-finder.md +93 -93
  23. package/agents/refactor-cleaner.md +143 -143
  24. package/agents/research/best-practices-agent.md +199 -199
  25. package/agents/research/codebase-patterns-agent.md +157 -157
  26. package/agents/research/framework-docs-agent.md +188 -188
  27. package/agents/research/security-advisory-agent.md +213 -213
  28. package/agents/review/architecture-reviewer.md +107 -107
  29. package/agents/review/complexity-reviewer.md +116 -116
  30. package/agents/review/data-integrity-reviewer.md +88 -88
  31. package/agents/review/git-history-reviewer.md +103 -103
  32. package/agents/review/performance-reviewer.md +86 -86
  33. package/agents/review/python-reviewer.md +150 -150
  34. package/agents/review/rails-reviewer.md +139 -139
  35. package/agents/review/react-reviewer.md +144 -144
  36. package/agents/review/security-reviewer.md +80 -80
  37. package/agents/review/simplicity-reviewer.md +140 -140
  38. package/agents/review/test-coverage-reviewer.md +116 -116
  39. package/agents/review/typescript-reviewer.md +127 -127
  40. package/agents/searcher.md +54 -54
  41. package/agents/simplifier.md +120 -120
  42. package/agents/tester.md +49 -49
  43. package/agents/ui-previewer.md +268 -268
  44. package/commands/vibe.analyze.md +356 -356
  45. package/commands/vibe.reason.md +329 -329
  46. package/commands/vibe.review.md +423 -423
  47. package/commands/vibe.run.md +1313 -1313
  48. package/commands/vibe.spec.md +1054 -1054
  49. package/commands/vibe.spec.review.md +412 -412
  50. package/commands/vibe.trace.md +161 -161
  51. package/commands/vibe.utils.md +376 -376
  52. package/commands/vibe.verify.md +375 -375
  53. package/dist/cli/collaborator.js +52 -52
  54. package/dist/cli/detect.js +32 -32
  55. package/dist/cli/hud.js +20 -20
  56. package/dist/cli/index.js +112 -112
  57. package/dist/cli/llm.js +144 -144
  58. package/dist/cli/mcp.d.ts +49 -0
  59. package/dist/cli/mcp.d.ts.map +1 -0
  60. package/dist/cli/mcp.js +169 -0
  61. package/dist/cli/mcp.js.map +1 -0
  62. package/dist/cli/postinstall.d.ts.map +1 -1
  63. package/dist/cli/postinstall.js +886 -858
  64. package/dist/cli/postinstall.js.map +1 -1
  65. package/dist/cli/setup/GlobalInstaller.d.ts +6 -0
  66. package/dist/cli/setup/GlobalInstaller.d.ts.map +1 -1
  67. package/dist/cli/setup/GlobalInstaller.js +26 -0
  68. package/dist/cli/setup/GlobalInstaller.js.map +1 -1
  69. package/dist/lib/DeepInit.js +24 -24
  70. package/dist/lib/IterationTracker.js +11 -11
  71. package/dist/lib/MemoryManager.d.ts +30 -0
  72. package/dist/lib/MemoryManager.d.ts.map +1 -1
  73. package/dist/lib/MemoryManager.js +74 -0
  74. package/dist/lib/MemoryManager.js.map +1 -1
  75. package/dist/lib/PythonParser.js +108 -108
  76. package/dist/lib/ReviewRace.js +96 -96
  77. package/dist/lib/SkillFrontmatter.js +28 -28
  78. package/dist/lib/SkillQualityGate.js +9 -9
  79. package/dist/lib/SkillRepository.js +159 -159
  80. package/dist/lib/UltraQA.js +77 -77
  81. package/dist/lib/gemini-api.js +5 -5
  82. package/dist/lib/gemini-mcp.d.ts +10 -0
  83. package/dist/lib/gemini-mcp.d.ts.map +1 -0
  84. package/dist/lib/gemini-mcp.js +353 -0
  85. package/dist/lib/gemini-mcp.js.map +1 -0
  86. package/dist/lib/gpt-api.js +4 -4
  87. package/dist/lib/gpt-mcp.d.ts +10 -0
  88. package/dist/lib/gpt-mcp.d.ts.map +1 -0
  89. package/dist/lib/gpt-mcp.js +352 -0
  90. package/dist/lib/gpt-mcp.js.map +1 -0
  91. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  92. package/dist/lib/memory/MemorySearch.js +43 -43
  93. package/dist/lib/memory/MemoryStorage.js +130 -130
  94. package/dist/lib/memory/ObservationStore.js +28 -28
  95. package/dist/lib/memory/SessionRAGRetriever.d.ts +66 -0
  96. package/dist/lib/memory/SessionRAGRetriever.d.ts.map +1 -0
  97. package/dist/lib/memory/SessionRAGRetriever.js +196 -0
  98. package/dist/lib/memory/SessionRAGRetriever.js.map +1 -0
  99. package/dist/lib/memory/SessionRAGRetriever.test.d.ts +2 -0
  100. package/dist/lib/memory/SessionRAGRetriever.test.d.ts.map +1 -0
  101. package/dist/lib/memory/SessionRAGRetriever.test.js +180 -0
  102. package/dist/lib/memory/SessionRAGRetriever.test.js.map +1 -0
  103. package/dist/lib/memory/SessionRAGStore.d.ts +153 -0
  104. package/dist/lib/memory/SessionRAGStore.d.ts.map +1 -0
  105. package/dist/lib/memory/SessionRAGStore.js +673 -0
  106. package/dist/lib/memory/SessionRAGStore.js.map +1 -0
  107. package/dist/lib/memory/SessionRAGStore.test.d.ts +2 -0
  108. package/dist/lib/memory/SessionRAGStore.test.d.ts.map +1 -0
  109. package/dist/lib/memory/SessionRAGStore.test.js +326 -0
  110. package/dist/lib/memory/SessionRAGStore.test.js.map +1 -0
  111. package/dist/lib/memory/SessionSummarizer.js +9 -9
  112. package/dist/orchestrator/AgentManager.js +12 -12
  113. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  114. package/dist/orchestrator/SmartRouter.js +11 -11
  115. package/dist/orchestrator/SwarmOrchestrator.test.js +16 -16
  116. package/dist/orchestrator/parallelResearch.js +24 -24
  117. package/dist/tools/analytics/getUsageAnalytics.d.ts +10 -0
  118. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +1 -0
  119. package/dist/tools/analytics/getUsageAnalytics.js +246 -0
  120. package/dist/tools/analytics/getUsageAnalytics.js.map +1 -0
  121. package/dist/tools/analytics/index.d.ts +5 -0
  122. package/dist/tools/analytics/index.d.ts.map +1 -0
  123. package/dist/tools/analytics/index.js +5 -0
  124. package/dist/tools/analytics/index.js.map +1 -0
  125. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  126. package/dist/tools/convention/getCodingGuide.d.ts +7 -0
  127. package/dist/tools/convention/getCodingGuide.d.ts.map +1 -0
  128. package/dist/tools/convention/getCodingGuide.js +69 -0
  129. package/dist/tools/convention/getCodingGuide.js.map +1 -0
  130. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  131. package/dist/tools/index.d.ts +5 -0
  132. package/dist/tools/index.d.ts.map +1 -1
  133. package/dist/tools/index.js +4 -0
  134. package/dist/tools/index.js.map +1 -1
  135. package/dist/tools/memory/index.d.ts +3 -0
  136. package/dist/tools/memory/index.d.ts.map +1 -1
  137. package/dist/tools/memory/index.js +4 -0
  138. package/dist/tools/memory/index.js.map +1 -1
  139. package/dist/tools/memory/manageGoals.d.ts +11 -0
  140. package/dist/tools/memory/manageGoals.d.ts.map +1 -0
  141. package/dist/tools/memory/manageGoals.js +152 -0
  142. package/dist/tools/memory/manageGoals.js.map +1 -0
  143. package/dist/tools/memory/retrieveSessionContext.d.ts +9 -0
  144. package/dist/tools/memory/retrieveSessionContext.d.ts.map +1 -0
  145. package/dist/tools/memory/retrieveSessionContext.js +140 -0
  146. package/dist/tools/memory/retrieveSessionContext.js.map +1 -0
  147. package/dist/tools/memory/saveSessionItem.d.ts +26 -0
  148. package/dist/tools/memory/saveSessionItem.d.ts.map +1 -0
  149. package/dist/tools/memory/saveSessionItem.js +218 -0
  150. package/dist/tools/memory/saveSessionItem.js.map +1 -0
  151. package/dist/tools/memory/startSession.d.ts.map +1 -1
  152. package/dist/tools/memory/startSession.js +29 -0
  153. package/dist/tools/memory/startSession.js.map +1 -1
  154. package/dist/tools/planning/analyzeRequirements.d.ts +9 -0
  155. package/dist/tools/planning/analyzeRequirements.d.ts.map +1 -0
  156. package/dist/tools/planning/analyzeRequirements.js +171 -0
  157. package/dist/tools/planning/analyzeRequirements.js.map +1 -0
  158. package/dist/tools/planning/createUserStories.d.ts +9 -0
  159. package/dist/tools/planning/createUserStories.d.ts.map +1 -0
  160. package/dist/tools/planning/createUserStories.js +124 -0
  161. package/dist/tools/planning/createUserStories.js.map +1 -0
  162. package/dist/tools/planning/featureRoadmap.d.ts +10 -0
  163. package/dist/tools/planning/featureRoadmap.d.ts.map +1 -0
  164. package/dist/tools/planning/featureRoadmap.js +207 -0
  165. package/dist/tools/planning/featureRoadmap.js.map +1 -0
  166. package/dist/tools/planning/generatePrd.d.ts +11 -0
  167. package/dist/tools/planning/generatePrd.d.ts.map +1 -0
  168. package/dist/tools/planning/generatePrd.js +161 -0
  169. package/dist/tools/planning/generatePrd.js.map +1 -0
  170. package/dist/tools/planning/index.d.ts +8 -0
  171. package/dist/tools/planning/index.d.ts.map +1 -0
  172. package/dist/tools/planning/index.js +8 -0
  173. package/dist/tools/planning/index.js.map +1 -0
  174. package/dist/tools/prompt/analyzePrompt.d.ts +7 -0
  175. package/dist/tools/prompt/analyzePrompt.d.ts.map +1 -0
  176. package/dist/tools/prompt/analyzePrompt.js +150 -0
  177. package/dist/tools/prompt/analyzePrompt.js.map +1 -0
  178. package/dist/tools/prompt/enhancePrompt.d.ts +8 -0
  179. package/dist/tools/prompt/enhancePrompt.d.ts.map +1 -0
  180. package/dist/tools/prompt/enhancePrompt.js +110 -0
  181. package/dist/tools/prompt/enhancePrompt.js.map +1 -0
  182. package/dist/tools/prompt/enhancePromptGemini.d.ts +8 -0
  183. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +1 -0
  184. package/dist/tools/prompt/enhancePromptGemini.js +332 -0
  185. package/dist/tools/prompt/enhancePromptGemini.js.map +1 -0
  186. package/dist/tools/prompt/index.d.ts +7 -0
  187. package/dist/tools/prompt/index.d.ts.map +1 -0
  188. package/dist/tools/prompt/index.js +7 -0
  189. package/dist/tools/prompt/index.js.map +1 -0
  190. package/dist/tools/reasoning/applyReasoningFramework.d.ts +8 -0
  191. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +1 -0
  192. package/dist/tools/reasoning/applyReasoningFramework.js +266 -0
  193. package/dist/tools/reasoning/applyReasoningFramework.js.map +1 -0
  194. package/dist/tools/reasoning/index.d.ts +5 -0
  195. package/dist/tools/reasoning/index.d.ts.map +1 -0
  196. package/dist/tools/reasoning/index.js +5 -0
  197. package/dist/tools/reasoning/index.js.map +1 -0
  198. package/dist/tools/spec/prdParser.test.js +171 -171
  199. package/dist/tools/spec/specGenerator.js +169 -169
  200. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  201. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  202. package/dist/tools/thinking/analyzeProblem.d.ts +7 -0
  203. package/dist/tools/thinking/analyzeProblem.d.ts.map +1 -0
  204. package/dist/tools/thinking/analyzeProblem.js +55 -0
  205. package/dist/tools/thinking/analyzeProblem.js.map +1 -0
  206. package/dist/tools/thinking/breakDownProblem.d.ts +8 -0
  207. package/dist/tools/thinking/breakDownProblem.d.ts.map +1 -0
  208. package/dist/tools/thinking/breakDownProblem.js +145 -0
  209. package/dist/tools/thinking/breakDownProblem.js.map +1 -0
  210. package/dist/tools/thinking/createThinkingChain.d.ts +7 -0
  211. package/dist/tools/thinking/createThinkingChain.d.ts.map +1 -0
  212. package/dist/tools/thinking/createThinkingChain.js +44 -0
  213. package/dist/tools/thinking/createThinkingChain.js.map +1 -0
  214. package/dist/tools/thinking/formatAsPlan.d.ts +9 -0
  215. package/dist/tools/thinking/formatAsPlan.d.ts.map +1 -0
  216. package/dist/tools/thinking/formatAsPlan.js +78 -0
  217. package/dist/tools/thinking/formatAsPlan.js.map +1 -0
  218. package/dist/tools/thinking/index.d.ts +10 -0
  219. package/dist/tools/thinking/index.d.ts.map +1 -0
  220. package/dist/tools/thinking/index.js +10 -0
  221. package/dist/tools/thinking/index.js.map +1 -0
  222. package/dist/tools/thinking/stepByStepAnalysis.d.ts +8 -0
  223. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +1 -0
  224. package/dist/tools/thinking/stepByStepAnalysis.js +63 -0
  225. package/dist/tools/thinking/stepByStepAnalysis.js.map +1 -0
  226. package/dist/tools/thinking/thinkAloudProcess.d.ts +8 -0
  227. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +1 -0
  228. package/dist/tools/thinking/thinkAloudProcess.js +80 -0
  229. package/dist/tools/thinking/thinkAloudProcess.js.map +1 -0
  230. package/hooks/hooks.json +115 -115
  231. package/hooks/scripts/code-check.js +70 -70
  232. package/hooks/scripts/code-review.js +22 -22
  233. package/hooks/scripts/complexity.js +22 -22
  234. package/hooks/scripts/compound.js +23 -23
  235. package/hooks/scripts/context-save.js +53 -53
  236. package/hooks/scripts/gemini-ui-gen.js +281 -281
  237. package/hooks/scripts/generate-brand-assets.js +474 -474
  238. package/hooks/scripts/hud-multiline.js +262 -262
  239. package/hooks/scripts/hud-status.js +291 -291
  240. package/hooks/scripts/keyword-detector.js +214 -214
  241. package/hooks/scripts/llm-orchestrate.js +171 -171
  242. package/hooks/scripts/post-edit.js +97 -97
  243. package/hooks/scripts/post-tool-verify.js +210 -210
  244. package/hooks/scripts/pre-tool-guard.js +125 -125
  245. package/hooks/scripts/prompt-dispatcher.js +161 -161
  246. package/hooks/scripts/recall.js +22 -22
  247. package/hooks/scripts/session-start.js +30 -30
  248. package/hooks/scripts/skill-injector.js +191 -191
  249. package/hooks/scripts/utils.js +97 -97
  250. package/languages/csharp-unity.md +515 -515
  251. package/languages/gdscript-godot.md +470 -470
  252. package/languages/ruby-rails.md +489 -489
  253. package/languages/typescript-angular.md +433 -433
  254. package/languages/typescript-astro.md +416 -416
  255. package/languages/typescript-electron.md +406 -406
  256. package/languages/typescript-nestjs.md +524 -524
  257. package/languages/typescript-svelte.md +407 -407
  258. package/languages/typescript-tauri.md +365 -365
  259. package/package.json +84 -84
  260. package/skills/brand-assets.md +141 -141
  261. package/skills/commerce-patterns.md +361 -361
  262. package/skills/context7-usage.md +102 -102
  263. package/skills/e2e-commerce.md +304 -304
  264. package/skills/frontend-design.md +92 -92
  265. package/skills/git-worktree.md +181 -181
  266. package/skills/parallel-research.md +77 -77
  267. package/skills/priority-todos.md +239 -239
  268. package/skills/seo-checklist.md +244 -244
  269. package/skills/tool-fallback.md +190 -190
  270. package/skills/vibe-capabilities.md +161 -161
  271. package/vibe/constitution.md +227 -227
  272. package/vibe/rules/core/communication-guide.md +98 -98
  273. package/vibe/rules/core/development-philosophy.md +52 -52
  274. package/vibe/rules/core/quick-start.md +102 -102
  275. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  276. package/vibe/rules/quality/checklist.md +276 -276
  277. package/vibe/rules/quality/testing-strategy.md +440 -440
  278. package/vibe/rules/standards/anti-patterns.md +541 -541
  279. package/vibe/rules/standards/code-structure.md +291 -291
  280. package/vibe/rules/standards/complexity-metrics.md +313 -313
  281. package/vibe/rules/standards/naming-conventions.md +198 -198
  282. package/vibe/setup.sh +31 -31
  283. package/vibe/templates/constitution-template.md +252 -252
  284. package/vibe/templates/contract-backend-template.md +526 -526
  285. package/vibe/templates/contract-frontend-template.md +599 -599
  286. package/vibe/templates/feature-template.md +96 -96
  287. package/vibe/templates/spec-template.md +221 -221
@@ -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);