@su-record/vibe 2.6.14 → 2.6.15

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