@su-record/vibe 2.6.14 → 2.6.16

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 (233) hide show
  1. package/CLAUDE.md +1 -394
  2. package/LICENSE +21 -21
  3. package/README.md +203 -497
  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 +1266 -1266
  42. package/commands/vibe.spec.md +1054 -1054
  43. package/commands/vibe.spec.review.md +319 -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.js +118 -118
  51. package/dist/cli/index.js.map +1 -1
  52. package/dist/cli/llm.js +144 -144
  53. package/dist/cli/mcp.d.ts +49 -0
  54. package/dist/cli/mcp.d.ts.map +1 -0
  55. package/dist/cli/mcp.js +169 -0
  56. package/dist/cli/mcp.js.map +1 -0
  57. package/dist/cli/postinstall.js +858 -858
  58. package/dist/cli/setup/ProjectSetup.d.ts +3 -3
  59. package/dist/cli/setup/ProjectSetup.d.ts.map +1 -1
  60. package/dist/cli/setup/ProjectSetup.js +76 -30
  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/PythonParser.js +108 -108
  65. package/dist/lib/ReviewRace.js +96 -96
  66. package/dist/lib/SkillFrontmatter.js +28 -28
  67. package/dist/lib/SkillQualityGate.js +9 -9
  68. package/dist/lib/SkillRepository.js +159 -159
  69. package/dist/lib/UltraQA.js +77 -77
  70. package/dist/lib/gemini-api.js +5 -5
  71. package/dist/lib/gemini-mcp.d.ts +10 -0
  72. package/dist/lib/gemini-mcp.d.ts.map +1 -0
  73. package/dist/lib/gemini-mcp.js +353 -0
  74. package/dist/lib/gemini-mcp.js.map +1 -0
  75. package/dist/lib/gpt-api.js +4 -4
  76. package/dist/lib/gpt-mcp.d.ts +10 -0
  77. package/dist/lib/gpt-mcp.d.ts.map +1 -0
  78. package/dist/lib/gpt-mcp.js +352 -0
  79. package/dist/lib/gpt-mcp.js.map +1 -0
  80. package/dist/lib/memory/KnowledgeGraph.js +4 -4
  81. package/dist/lib/memory/MemorySearch.js +20 -20
  82. package/dist/lib/memory/MemoryStorage.js +64 -64
  83. package/dist/orchestrator/AgentManager.js +12 -12
  84. package/dist/orchestrator/MultiLlmResearch.js +8 -8
  85. package/dist/orchestrator/SmartRouter.js +11 -11
  86. package/dist/orchestrator/parallelResearch.js +24 -24
  87. package/dist/tools/analytics/getUsageAnalytics.d.ts +10 -0
  88. package/dist/tools/analytics/getUsageAnalytics.d.ts.map +1 -0
  89. package/dist/tools/analytics/getUsageAnalytics.js +246 -0
  90. package/dist/tools/analytics/getUsageAnalytics.js.map +1 -0
  91. package/dist/tools/analytics/index.d.ts +5 -0
  92. package/dist/tools/analytics/index.d.ts.map +1 -0
  93. package/dist/tools/analytics/index.js +5 -0
  94. package/dist/tools/analytics/index.js.map +1 -0
  95. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  96. package/dist/tools/convention/getCodingGuide.d.ts +7 -0
  97. package/dist/tools/convention/getCodingGuide.d.ts.map +1 -0
  98. package/dist/tools/convention/getCodingGuide.js +69 -0
  99. package/dist/tools/convention/getCodingGuide.js.map +1 -0
  100. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  101. package/dist/tools/planning/analyzeRequirements.d.ts +9 -0
  102. package/dist/tools/planning/analyzeRequirements.d.ts.map +1 -0
  103. package/dist/tools/planning/analyzeRequirements.js +171 -0
  104. package/dist/tools/planning/analyzeRequirements.js.map +1 -0
  105. package/dist/tools/planning/createUserStories.d.ts +9 -0
  106. package/dist/tools/planning/createUserStories.d.ts.map +1 -0
  107. package/dist/tools/planning/createUserStories.js +124 -0
  108. package/dist/tools/planning/createUserStories.js.map +1 -0
  109. package/dist/tools/planning/featureRoadmap.d.ts +10 -0
  110. package/dist/tools/planning/featureRoadmap.d.ts.map +1 -0
  111. package/dist/tools/planning/featureRoadmap.js +207 -0
  112. package/dist/tools/planning/featureRoadmap.js.map +1 -0
  113. package/dist/tools/planning/generatePrd.d.ts +11 -0
  114. package/dist/tools/planning/generatePrd.d.ts.map +1 -0
  115. package/dist/tools/planning/generatePrd.js +161 -0
  116. package/dist/tools/planning/generatePrd.js.map +1 -0
  117. package/dist/tools/planning/index.d.ts +8 -0
  118. package/dist/tools/planning/index.d.ts.map +1 -0
  119. package/dist/tools/planning/index.js +8 -0
  120. package/dist/tools/planning/index.js.map +1 -0
  121. package/dist/tools/prompt/analyzePrompt.d.ts +7 -0
  122. package/dist/tools/prompt/analyzePrompt.d.ts.map +1 -0
  123. package/dist/tools/prompt/analyzePrompt.js +150 -0
  124. package/dist/tools/prompt/analyzePrompt.js.map +1 -0
  125. package/dist/tools/prompt/enhancePrompt.d.ts +8 -0
  126. package/dist/tools/prompt/enhancePrompt.d.ts.map +1 -0
  127. package/dist/tools/prompt/enhancePrompt.js +110 -0
  128. package/dist/tools/prompt/enhancePrompt.js.map +1 -0
  129. package/dist/tools/prompt/enhancePromptGemini.d.ts +8 -0
  130. package/dist/tools/prompt/enhancePromptGemini.d.ts.map +1 -0
  131. package/dist/tools/prompt/enhancePromptGemini.js +332 -0
  132. package/dist/tools/prompt/enhancePromptGemini.js.map +1 -0
  133. package/dist/tools/prompt/index.d.ts +7 -0
  134. package/dist/tools/prompt/index.d.ts.map +1 -0
  135. package/dist/tools/prompt/index.js +7 -0
  136. package/dist/tools/prompt/index.js.map +1 -0
  137. package/dist/tools/reasoning/applyReasoningFramework.d.ts +8 -0
  138. package/dist/tools/reasoning/applyReasoningFramework.d.ts.map +1 -0
  139. package/dist/tools/reasoning/applyReasoningFramework.js +266 -0
  140. package/dist/tools/reasoning/applyReasoningFramework.js.map +1 -0
  141. package/dist/tools/reasoning/index.d.ts +5 -0
  142. package/dist/tools/reasoning/index.d.ts.map +1 -0
  143. package/dist/tools/reasoning/index.js +5 -0
  144. package/dist/tools/reasoning/index.js.map +1 -0
  145. package/dist/tools/spec/prdParser.test.js +171 -171
  146. package/dist/tools/spec/specGenerator.js +169 -169
  147. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  148. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  149. package/dist/tools/thinking/analyzeProblem.d.ts +7 -0
  150. package/dist/tools/thinking/analyzeProblem.d.ts.map +1 -0
  151. package/dist/tools/thinking/analyzeProblem.js +55 -0
  152. package/dist/tools/thinking/analyzeProblem.js.map +1 -0
  153. package/dist/tools/thinking/breakDownProblem.d.ts +8 -0
  154. package/dist/tools/thinking/breakDownProblem.d.ts.map +1 -0
  155. package/dist/tools/thinking/breakDownProblem.js +145 -0
  156. package/dist/tools/thinking/breakDownProblem.js.map +1 -0
  157. package/dist/tools/thinking/createThinkingChain.d.ts +7 -0
  158. package/dist/tools/thinking/createThinkingChain.d.ts.map +1 -0
  159. package/dist/tools/thinking/createThinkingChain.js +44 -0
  160. package/dist/tools/thinking/createThinkingChain.js.map +1 -0
  161. package/dist/tools/thinking/formatAsPlan.d.ts +9 -0
  162. package/dist/tools/thinking/formatAsPlan.d.ts.map +1 -0
  163. package/dist/tools/thinking/formatAsPlan.js +78 -0
  164. package/dist/tools/thinking/formatAsPlan.js.map +1 -0
  165. package/dist/tools/thinking/index.d.ts +10 -0
  166. package/dist/tools/thinking/index.d.ts.map +1 -0
  167. package/dist/tools/thinking/index.js +10 -0
  168. package/dist/tools/thinking/index.js.map +1 -0
  169. package/dist/tools/thinking/stepByStepAnalysis.d.ts +8 -0
  170. package/dist/tools/thinking/stepByStepAnalysis.d.ts.map +1 -0
  171. package/dist/tools/thinking/stepByStepAnalysis.js +63 -0
  172. package/dist/tools/thinking/stepByStepAnalysis.js.map +1 -0
  173. package/dist/tools/thinking/thinkAloudProcess.d.ts +8 -0
  174. package/dist/tools/thinking/thinkAloudProcess.d.ts.map +1 -0
  175. package/dist/tools/thinking/thinkAloudProcess.js +80 -0
  176. package/dist/tools/thinking/thinkAloudProcess.js.map +1 -0
  177. package/hooks/hooks.json +222 -222
  178. package/hooks/scripts/code-check.js +22 -22
  179. package/hooks/scripts/code-review.js +22 -22
  180. package/hooks/scripts/complexity.js +22 -22
  181. package/hooks/scripts/compound.js +23 -23
  182. package/hooks/scripts/context-save.js +33 -33
  183. package/hooks/scripts/gemini-ui-gen.js +281 -281
  184. package/hooks/scripts/generate-brand-assets.js +474 -474
  185. package/hooks/scripts/hud-multiline.js +262 -262
  186. package/hooks/scripts/hud-status.js +291 -291
  187. package/hooks/scripts/keyword-detector.js +214 -214
  188. package/hooks/scripts/llm-orchestrate.js +171 -171
  189. package/hooks/scripts/post-edit.js +97 -97
  190. package/hooks/scripts/post-tool-verify.js +210 -210
  191. package/hooks/scripts/pre-tool-guard.js +125 -125
  192. package/hooks/scripts/recall.js +22 -22
  193. package/hooks/scripts/session-start.js +30 -30
  194. package/hooks/scripts/skill-injector.js +191 -191
  195. package/hooks/scripts/utils.js +97 -97
  196. package/languages/csharp-unity.md +515 -515
  197. package/languages/gdscript-godot.md +470 -470
  198. package/languages/ruby-rails.md +489 -489
  199. package/languages/typescript-angular.md +433 -433
  200. package/languages/typescript-astro.md +416 -416
  201. package/languages/typescript-electron.md +406 -406
  202. package/languages/typescript-nestjs.md +524 -524
  203. package/languages/typescript-svelte.md +407 -407
  204. package/languages/typescript-tauri.md +365 -365
  205. package/package.json +84 -84
  206. package/skills/brand-assets.md +141 -141
  207. package/skills/commerce-patterns.md +361 -361
  208. package/skills/context7-usage.md +102 -102
  209. package/skills/e2e-commerce.md +304 -304
  210. package/skills/frontend-design.md +92 -92
  211. package/skills/git-worktree.md +181 -181
  212. package/skills/parallel-research.md +77 -77
  213. package/skills/priority-todos.md +239 -239
  214. package/skills/seo-checklist.md +244 -244
  215. package/skills/tool-fallback.md +190 -190
  216. package/skills/vibe-capabilities.md +161 -161
  217. package/vibe/constitution.md +227 -227
  218. package/vibe/rules/core/communication-guide.md +98 -98
  219. package/vibe/rules/core/development-philosophy.md +52 -52
  220. package/vibe/rules/core/quick-start.md +102 -102
  221. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  222. package/vibe/rules/quality/checklist.md +276 -276
  223. package/vibe/rules/quality/testing-strategy.md +440 -440
  224. package/vibe/rules/standards/anti-patterns.md +541 -541
  225. package/vibe/rules/standards/code-structure.md +291 -291
  226. package/vibe/rules/standards/complexity-metrics.md +313 -313
  227. package/vibe/rules/standards/naming-conventions.md +198 -198
  228. package/vibe/setup.sh +31 -31
  229. package/vibe/templates/constitution-template.md +252 -252
  230. package/vibe/templates/contract-backend-template.md +526 -526
  231. package/vibe/templates/contract-frontend-template.md +599 -599
  232. package/vibe/templates/feature-template.md +96 -96
  233. package/vibe/templates/spec-template.md +221 -221
@@ -1,291 +1,291 @@
1
- #!/usr/bin/env node
2
- /**
3
- * HUD Status Manager
4
- * 실시간 상태 시각화 (Claude Code statusline 연동)
5
- */
6
-
7
- import fs from 'fs';
8
- import path from 'path';
9
- import os from 'os';
10
-
11
- // 상태 저장 경로
12
- const STATE_DIR = path.join(os.homedir(), '.claude', '.vibe-hud');
13
- const STATE_FILE = path.join(STATE_DIR, 'state.json');
14
-
15
- // 기본 상태
16
- const DEFAULT_STATE = {
17
- mode: 'idle', // idle | ultrawork | spec | review
18
- feature: null,
19
- phase: { current: 0, total: 0, name: '' },
20
- agents: [], // 실행 중인 에이전트들
21
- context: { used: 0, total: 200000 }, // 컨텍스트 사용량
22
- lastUpdate: null,
23
- };
24
-
25
- // 상태 아이콘
26
- const MODE_ICONS = {
27
- idle: '💤',
28
- ultrawork: '🚀',
29
- spec: '📝',
30
- review: '🔍',
31
- implementing: '🔨',
32
- testing: '🧪',
33
- error: '❌',
34
- };
35
-
36
- // 건강 상태 색상 (ANSI)
37
- const HEALTH_COLORS = {
38
- good: '\x1b[32m', // 녹색
39
- warning: '\x1b[33m', // 노란색
40
- critical: '\x1b[31m', // 빨간색
41
- reset: '\x1b[0m',
42
- };
43
-
44
- /**
45
- * 상태 디렉토리 초기화
46
- */
47
- function ensureStateDir() {
48
- if (!fs.existsSync(STATE_DIR)) {
49
- fs.mkdirSync(STATE_DIR, { recursive: true });
50
- }
51
- }
52
-
53
- /**
54
- * 현재 상태 로드
55
- */
56
- function loadState() {
57
- try {
58
- if (fs.existsSync(STATE_FILE)) {
59
- return JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
60
- }
61
- } catch {
62
- // 무시
63
- }
64
- return { ...DEFAULT_STATE };
65
- }
66
-
67
- /**
68
- * 상태 저장
69
- */
70
- function saveState(state) {
71
- ensureStateDir();
72
- state.lastUpdate = new Date().toISOString();
73
- fs.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
74
- }
75
-
76
- /**
77
- * 상태 업데이트
78
- */
79
- function updateState(updates) {
80
- const state = loadState();
81
- Object.assign(state, updates);
82
- saveState(state);
83
- return state;
84
- }
85
-
86
- /**
87
- * 컨텍스트 건강 상태
88
- */
89
- function getContextHealth(used, total) {
90
- const percentage = (used / total) * 100;
91
- if (percentage >= 90) return 'critical';
92
- if (percentage >= 70) return 'warning';
93
- return 'good';
94
- }
95
-
96
- /**
97
- * 상태 라인 포맷 (minimal)
98
- */
99
- function formatMinimal(state) {
100
- const icon = MODE_ICONS[state.mode] || '💤';
101
- const phase = state.phase.total > 0
102
- ? `${state.phase.current}/${state.phase.total}`
103
- : '';
104
- return `${icon} ${state.mode}${phase ? ` [${phase}]` : ''}`;
105
- }
106
-
107
- /**
108
- * 상태 라인 포맷 (focused - default)
109
- */
110
- function formatFocused(state) {
111
- const icon = MODE_ICONS[state.mode] || '💤';
112
- const feature = state.feature ? `: ${state.feature}` : '';
113
- const phase = state.phase.total > 0
114
- ? ` [Phase ${state.phase.current}/${state.phase.total}]`
115
- : '';
116
-
117
- const contextPct = Math.round((state.context.used / state.context.total) * 100);
118
- const contextHealth = getContextHealth(state.context.used, state.context.total);
119
- const contextColor = HEALTH_COLORS[contextHealth];
120
-
121
- return `${icon} ${state.mode}${feature}${phase} | ${contextColor}CTX: ${contextPct}%${HEALTH_COLORS.reset}`;
122
- }
123
-
124
- /**
125
- * 상태 라인 포맷 (full)
126
- */
127
- function formatFull(state) {
128
- const lines = [];
129
- const icon = MODE_ICONS[state.mode] || '💤';
130
-
131
- lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
132
- lines.push(`${icon} VIBE HUD`);
133
- lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
134
-
135
- lines.push(`Mode: ${state.mode}`);
136
- if (state.feature) {
137
- lines.push(`Feature: ${state.feature}`);
138
- }
139
-
140
- if (state.phase.total > 0) {
141
- const progress = Math.round((state.phase.current / state.phase.total) * 100);
142
- const bar = createProgressBar(progress);
143
- lines.push(`Phase: ${state.phase.current}/${state.phase.total} ${state.phase.name}`);
144
- lines.push(` ${bar} ${progress}%`);
145
- }
146
-
147
- if (state.agents.length > 0) {
148
- lines.push(`Agents: ${state.agents.map(a => `${a.name}(${a.model})`).join(', ')}`);
149
- }
150
-
151
- const contextPct = Math.round((state.context.used / state.context.total) * 100);
152
- const contextHealth = getContextHealth(state.context.used, state.context.total);
153
- const contextColor = HEALTH_COLORS[contextHealth];
154
- lines.push(`Context: ${contextColor}${contextPct}%${HEALTH_COLORS.reset} (${state.context.used}/${state.context.total})`);
155
-
156
- lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
157
-
158
- return lines.join('\n');
159
- }
160
-
161
- /**
162
- * 프로그레스 바 생성
163
- */
164
- function createProgressBar(percentage, width = 20) {
165
- const filled = Math.round((percentage / 100) * width);
166
- const empty = width - filled;
167
- return `[${'█'.repeat(filled)}${'░'.repeat(empty)}]`;
168
- }
169
-
170
- /**
171
- * CLI 명령 처리
172
- */
173
- function handleCommand(args) {
174
- const command = args[0];
175
- const params = args.slice(1);
176
-
177
- switch (command) {
178
- case 'show':
179
- case 'status': {
180
- const format = params[0] || 'focused';
181
- const state = loadState();
182
- if (format === 'minimal') console.log(formatMinimal(state));
183
- else if (format === 'full') console.log(formatFull(state));
184
- else console.log(formatFocused(state));
185
- break;
186
- }
187
-
188
- case 'set': {
189
- const key = params[0];
190
- const value = params[1];
191
- if (key && value !== undefined) {
192
- const updates = {};
193
- // 중첩 키 처리 (예: phase.current)
194
- if (key.includes('.')) {
195
- const [parent, child] = key.split('.');
196
- const state = loadState();
197
- updates[parent] = { ...(state[parent] || {}), [child]: isNaN(value) ? value : Number(value) };
198
- } else {
199
- updates[key] = isNaN(value) ? value : Number(value);
200
- }
201
- updateState(updates);
202
- console.log(`✓ Updated ${key}`);
203
- }
204
- break;
205
- }
206
-
207
- case 'start': {
208
- const mode = params[0] || 'ultrawork';
209
- const feature = params[1] || null;
210
- updateState({
211
- mode,
212
- feature,
213
- phase: { current: 0, total: 0, name: '' },
214
- agents: [],
215
- });
216
- console.log(`🚀 Started ${mode}${feature ? `: ${feature}` : ''}`);
217
- break;
218
- }
219
-
220
- case 'phase': {
221
- const current = parseInt(params[0], 10) || 1;
222
- const total = parseInt(params[1], 10) || current;
223
- const name = params.slice(2).join(' ') || '';
224
- updateState({ phase: { current, total, name } });
225
- console.log(`📍 Phase ${current}/${total}${name ? `: ${name}` : ''}`);
226
- break;
227
- }
228
-
229
- case 'agent': {
230
- const action = params[0]; // add | remove | clear
231
- const state = loadState();
232
- if (action === 'add') {
233
- const name = params[1];
234
- const model = params[2] || 'sonnet';
235
- state.agents.push({ name, model, startTime: Date.now() });
236
- saveState(state);
237
- console.log(`🤖 Agent added: ${name} (${model})`);
238
- } else if (action === 'remove') {
239
- const name = params[1];
240
- state.agents = state.agents.filter(a => a.name !== name);
241
- saveState(state);
242
- console.log(`🤖 Agent removed: ${name}`);
243
- } else if (action === 'clear') {
244
- state.agents = [];
245
- saveState(state);
246
- console.log(`🤖 All agents cleared`);
247
- }
248
- break;
249
- }
250
-
251
- case 'context': {
252
- const used = parseInt(params[0], 10) || 0;
253
- const total = parseInt(params[1], 10) || 200000;
254
- updateState({ context: { used, total } });
255
- const pct = Math.round((used / total) * 100);
256
- console.log(`📊 Context: ${pct}%`);
257
- break;
258
- }
259
-
260
- case 'done':
261
- case 'reset': {
262
- saveState({ ...DEFAULT_STATE });
263
- console.log(`💤 HUD reset`);
264
- break;
265
- }
266
-
267
- default:
268
- console.log(`
269
- VIBE HUD - Real-time status visualization
270
-
271
- Commands:
272
- show [format] Show current status (minimal|focused|full)
273
- start [mode] [feature] Start tracking (ultrawork|spec|review)
274
- phase <current> <total> [name] Update phase progress
275
- agent add|remove|clear [name] [model] Manage agents
276
- context <used> [total] Update context usage
277
- set <key> <value> Set arbitrary state value
278
- done|reset Reset to idle state
279
-
280
- Examples:
281
- node hud-status.js show full
282
- node hud-status.js start ultrawork "login-feature"
283
- node hud-status.js phase 2 5 "Implementing core"
284
- node hud-status.js agent add "explore-1" haiku
285
- `);
286
- }
287
- }
288
-
289
- // 메인 실행
290
- const args = process.argv.slice(2);
291
- handleCommand(args);
1
+ #!/usr/bin/env node
2
+ /**
3
+ * HUD Status Manager
4
+ * 실시간 상태 시각화 (Claude Code statusline 연동)
5
+ */
6
+
7
+ import fs from 'fs';
8
+ import path from 'path';
9
+ import os from 'os';
10
+
11
+ // 상태 저장 경로
12
+ const STATE_DIR = path.join(os.homedir(), '.claude', '.vibe-hud');
13
+ const STATE_FILE = path.join(STATE_DIR, 'state.json');
14
+
15
+ // 기본 상태
16
+ const DEFAULT_STATE = {
17
+ mode: 'idle', // idle | ultrawork | spec | review
18
+ feature: null,
19
+ phase: { current: 0, total: 0, name: '' },
20
+ agents: [], // 실행 중인 에이전트들
21
+ context: { used: 0, total: 200000 }, // 컨텍스트 사용량
22
+ lastUpdate: null,
23
+ };
24
+
25
+ // 상태 아이콘
26
+ const MODE_ICONS = {
27
+ idle: '💤',
28
+ ultrawork: '🚀',
29
+ spec: '📝',
30
+ review: '🔍',
31
+ implementing: '🔨',
32
+ testing: '🧪',
33
+ error: '❌',
34
+ };
35
+
36
+ // 건강 상태 색상 (ANSI)
37
+ const HEALTH_COLORS = {
38
+ good: '\x1b[32m', // 녹색
39
+ warning: '\x1b[33m', // 노란색
40
+ critical: '\x1b[31m', // 빨간색
41
+ reset: '\x1b[0m',
42
+ };
43
+
44
+ /**
45
+ * 상태 디렉토리 초기화
46
+ */
47
+ function ensureStateDir() {
48
+ if (!fs.existsSync(STATE_DIR)) {
49
+ fs.mkdirSync(STATE_DIR, { recursive: true });
50
+ }
51
+ }
52
+
53
+ /**
54
+ * 현재 상태 로드
55
+ */
56
+ function loadState() {
57
+ try {
58
+ if (fs.existsSync(STATE_FILE)) {
59
+ return JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
60
+ }
61
+ } catch {
62
+ // 무시
63
+ }
64
+ return { ...DEFAULT_STATE };
65
+ }
66
+
67
+ /**
68
+ * 상태 저장
69
+ */
70
+ function saveState(state) {
71
+ ensureStateDir();
72
+ state.lastUpdate = new Date().toISOString();
73
+ fs.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2));
74
+ }
75
+
76
+ /**
77
+ * 상태 업데이트
78
+ */
79
+ function updateState(updates) {
80
+ const state = loadState();
81
+ Object.assign(state, updates);
82
+ saveState(state);
83
+ return state;
84
+ }
85
+
86
+ /**
87
+ * 컨텍스트 건강 상태
88
+ */
89
+ function getContextHealth(used, total) {
90
+ const percentage = (used / total) * 100;
91
+ if (percentage >= 90) return 'critical';
92
+ if (percentage >= 70) return 'warning';
93
+ return 'good';
94
+ }
95
+
96
+ /**
97
+ * 상태 라인 포맷 (minimal)
98
+ */
99
+ function formatMinimal(state) {
100
+ const icon = MODE_ICONS[state.mode] || '💤';
101
+ const phase = state.phase.total > 0
102
+ ? `${state.phase.current}/${state.phase.total}`
103
+ : '';
104
+ return `${icon} ${state.mode}${phase ? ` [${phase}]` : ''}`;
105
+ }
106
+
107
+ /**
108
+ * 상태 라인 포맷 (focused - default)
109
+ */
110
+ function formatFocused(state) {
111
+ const icon = MODE_ICONS[state.mode] || '💤';
112
+ const feature = state.feature ? `: ${state.feature}` : '';
113
+ const phase = state.phase.total > 0
114
+ ? ` [Phase ${state.phase.current}/${state.phase.total}]`
115
+ : '';
116
+
117
+ const contextPct = Math.round((state.context.used / state.context.total) * 100);
118
+ const contextHealth = getContextHealth(state.context.used, state.context.total);
119
+ const contextColor = HEALTH_COLORS[contextHealth];
120
+
121
+ return `${icon} ${state.mode}${feature}${phase} | ${contextColor}CTX: ${contextPct}%${HEALTH_COLORS.reset}`;
122
+ }
123
+
124
+ /**
125
+ * 상태 라인 포맷 (full)
126
+ */
127
+ function formatFull(state) {
128
+ const lines = [];
129
+ const icon = MODE_ICONS[state.mode] || '💤';
130
+
131
+ lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
132
+ lines.push(`${icon} VIBE HUD`);
133
+ lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
134
+
135
+ lines.push(`Mode: ${state.mode}`);
136
+ if (state.feature) {
137
+ lines.push(`Feature: ${state.feature}`);
138
+ }
139
+
140
+ if (state.phase.total > 0) {
141
+ const progress = Math.round((state.phase.current / state.phase.total) * 100);
142
+ const bar = createProgressBar(progress);
143
+ lines.push(`Phase: ${state.phase.current}/${state.phase.total} ${state.phase.name}`);
144
+ lines.push(` ${bar} ${progress}%`);
145
+ }
146
+
147
+ if (state.agents.length > 0) {
148
+ lines.push(`Agents: ${state.agents.map(a => `${a.name}(${a.model})`).join(', ')}`);
149
+ }
150
+
151
+ const contextPct = Math.round((state.context.used / state.context.total) * 100);
152
+ const contextHealth = getContextHealth(state.context.used, state.context.total);
153
+ const contextColor = HEALTH_COLORS[contextHealth];
154
+ lines.push(`Context: ${contextColor}${contextPct}%${HEALTH_COLORS.reset} (${state.context.used}/${state.context.total})`);
155
+
156
+ lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
157
+
158
+ return lines.join('\n');
159
+ }
160
+
161
+ /**
162
+ * 프로그레스 바 생성
163
+ */
164
+ function createProgressBar(percentage, width = 20) {
165
+ const filled = Math.round((percentage / 100) * width);
166
+ const empty = width - filled;
167
+ return `[${'█'.repeat(filled)}${'░'.repeat(empty)}]`;
168
+ }
169
+
170
+ /**
171
+ * CLI 명령 처리
172
+ */
173
+ function handleCommand(args) {
174
+ const command = args[0];
175
+ const params = args.slice(1);
176
+
177
+ switch (command) {
178
+ case 'show':
179
+ case 'status': {
180
+ const format = params[0] || 'focused';
181
+ const state = loadState();
182
+ if (format === 'minimal') console.log(formatMinimal(state));
183
+ else if (format === 'full') console.log(formatFull(state));
184
+ else console.log(formatFocused(state));
185
+ break;
186
+ }
187
+
188
+ case 'set': {
189
+ const key = params[0];
190
+ const value = params[1];
191
+ if (key && value !== undefined) {
192
+ const updates = {};
193
+ // 중첩 키 처리 (예: phase.current)
194
+ if (key.includes('.')) {
195
+ const [parent, child] = key.split('.');
196
+ const state = loadState();
197
+ updates[parent] = { ...(state[parent] || {}), [child]: isNaN(value) ? value : Number(value) };
198
+ } else {
199
+ updates[key] = isNaN(value) ? value : Number(value);
200
+ }
201
+ updateState(updates);
202
+ console.log(`✓ Updated ${key}`);
203
+ }
204
+ break;
205
+ }
206
+
207
+ case 'start': {
208
+ const mode = params[0] || 'ultrawork';
209
+ const feature = params[1] || null;
210
+ updateState({
211
+ mode,
212
+ feature,
213
+ phase: { current: 0, total: 0, name: '' },
214
+ agents: [],
215
+ });
216
+ console.log(`🚀 Started ${mode}${feature ? `: ${feature}` : ''}`);
217
+ break;
218
+ }
219
+
220
+ case 'phase': {
221
+ const current = parseInt(params[0], 10) || 1;
222
+ const total = parseInt(params[1], 10) || current;
223
+ const name = params.slice(2).join(' ') || '';
224
+ updateState({ phase: { current, total, name } });
225
+ console.log(`📍 Phase ${current}/${total}${name ? `: ${name}` : ''}`);
226
+ break;
227
+ }
228
+
229
+ case 'agent': {
230
+ const action = params[0]; // add | remove | clear
231
+ const state = loadState();
232
+ if (action === 'add') {
233
+ const name = params[1];
234
+ const model = params[2] || 'sonnet';
235
+ state.agents.push({ name, model, startTime: Date.now() });
236
+ saveState(state);
237
+ console.log(`🤖 Agent added: ${name} (${model})`);
238
+ } else if (action === 'remove') {
239
+ const name = params[1];
240
+ state.agents = state.agents.filter(a => a.name !== name);
241
+ saveState(state);
242
+ console.log(`🤖 Agent removed: ${name}`);
243
+ } else if (action === 'clear') {
244
+ state.agents = [];
245
+ saveState(state);
246
+ console.log(`🤖 All agents cleared`);
247
+ }
248
+ break;
249
+ }
250
+
251
+ case 'context': {
252
+ const used = parseInt(params[0], 10) || 0;
253
+ const total = parseInt(params[1], 10) || 200000;
254
+ updateState({ context: { used, total } });
255
+ const pct = Math.round((used / total) * 100);
256
+ console.log(`📊 Context: ${pct}%`);
257
+ break;
258
+ }
259
+
260
+ case 'done':
261
+ case 'reset': {
262
+ saveState({ ...DEFAULT_STATE });
263
+ console.log(`💤 HUD reset`);
264
+ break;
265
+ }
266
+
267
+ default:
268
+ console.log(`
269
+ VIBE HUD - Real-time status visualization
270
+
271
+ Commands:
272
+ show [format] Show current status (minimal|focused|full)
273
+ start [mode] [feature] Start tracking (ultrawork|spec|review)
274
+ phase <current> <total> [name] Update phase progress
275
+ agent add|remove|clear [name] [model] Manage agents
276
+ context <used> [total] Update context usage
277
+ set <key> <value> Set arbitrary state value
278
+ done|reset Reset to idle state
279
+
280
+ Examples:
281
+ node hud-status.js show full
282
+ node hud-status.js start ultrawork "login-feature"
283
+ node hud-status.js phase 2 5 "Implementing core"
284
+ node hud-status.js agent add "explore-1" haiku
285
+ `);
286
+ }
287
+ }
288
+
289
+ // 메인 실행
290
+ const args = process.argv.slice(2);
291
+ handleCommand(args);