@su-record/vibe 2.7.17 → 2.7.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (245) hide show
  1. package/.env.example +37 -37
  2. package/CLAUDE.md +153 -134
  3. package/LICENSE +21 -21
  4. package/README.md +449 -449
  5. package/agents/architect-low.md +41 -41
  6. package/agents/architect-medium.md +59 -59
  7. package/agents/architect.md +80 -80
  8. package/agents/build-error-resolver.md +115 -115
  9. package/agents/compounder.md +261 -261
  10. package/agents/diagrammer.md +178 -178
  11. package/agents/docs/api-documenter.md +99 -99
  12. package/agents/docs/changelog-writer.md +93 -93
  13. package/agents/e2e-tester.md +294 -294
  14. package/agents/explorer-low.md +42 -42
  15. package/agents/explorer-medium.md +59 -59
  16. package/agents/explorer.md +48 -48
  17. package/agents/implementer-low.md +43 -43
  18. package/agents/implementer-medium.md +52 -52
  19. package/agents/implementer.md +54 -54
  20. package/agents/junior-mentor.md +141 -141
  21. package/agents/planning/requirements-analyst.md +84 -84
  22. package/agents/planning/ux-advisor.md +83 -83
  23. package/agents/qa/acceptance-tester.md +86 -86
  24. package/agents/qa/edge-case-finder.md +93 -93
  25. package/agents/refactor-cleaner.md +143 -143
  26. package/agents/research/best-practices-agent.md +199 -199
  27. package/agents/research/codebase-patterns-agent.md +157 -157
  28. package/agents/research/framework-docs-agent.md +188 -188
  29. package/agents/research/security-advisory-agent.md +213 -213
  30. package/agents/review/architecture-reviewer.md +107 -107
  31. package/agents/review/complexity-reviewer.md +116 -116
  32. package/agents/review/data-integrity-reviewer.md +88 -88
  33. package/agents/review/git-history-reviewer.md +103 -103
  34. package/agents/review/performance-reviewer.md +86 -86
  35. package/agents/review/python-reviewer.md +150 -150
  36. package/agents/review/rails-reviewer.md +139 -139
  37. package/agents/review/react-reviewer.md +144 -144
  38. package/agents/review/security-reviewer.md +80 -80
  39. package/agents/review/simplicity-reviewer.md +140 -140
  40. package/agents/review/test-coverage-reviewer.md +116 -116
  41. package/agents/review/typescript-reviewer.md +127 -127
  42. package/agents/searcher.md +54 -54
  43. package/agents/simplifier.md +120 -120
  44. package/agents/tester.md +49 -49
  45. package/agents/ui/ui-a11y-auditor.md +93 -93
  46. package/agents/ui/ui-antipattern-detector.md +94 -94
  47. package/agents/ui/ui-dataviz-advisor.md +69 -69
  48. package/agents/ui/ui-design-system-gen.md +57 -57
  49. package/agents/ui/ui-industry-analyzer.md +49 -49
  50. package/agents/ui/ui-layout-architect.md +65 -65
  51. package/agents/ui/ui-stack-implementer.md +68 -68
  52. package/agents/ui/ux-compliance-reviewer.md +81 -81
  53. package/agents/ui-previewer.md +258 -258
  54. package/commands/vibe.analyze.md +379 -379
  55. package/commands/vibe.review.md +607 -607
  56. package/commands/vibe.run.md +2124 -2124
  57. package/commands/vibe.spec.md +1195 -1195
  58. package/commands/vibe.spec.review.md +569 -569
  59. package/commands/vibe.utils.md +413 -413
  60. package/commands/vibe.verify.md +484 -484
  61. package/dist/cli/collaborator.js +52 -52
  62. package/dist/cli/commands/evolution.js +12 -12
  63. package/dist/cli/commands/info.js +51 -51
  64. package/dist/cli/commands/init.js +5 -5
  65. package/dist/cli/commands/remove.js +14 -14
  66. package/dist/cli/commands/sentinel.js +27 -27
  67. package/dist/cli/commands/skills.js +5 -5
  68. package/dist/cli/commands/slack.js +10 -10
  69. package/dist/cli/commands/telegram.js +12 -12
  70. package/dist/cli/detect.js +32 -32
  71. package/dist/cli/index.js +51 -51
  72. package/dist/cli/llm/claude-commands.js +16 -16
  73. package/dist/cli/llm/config.js +18 -18
  74. package/dist/cli/llm/gemini-commands.js +16 -16
  75. package/dist/cli/llm/gpt-commands.js +19 -19
  76. package/dist/cli/llm/help.js +21 -21
  77. package/dist/cli/postinstall/cursor-agents.js +32 -32
  78. package/dist/cli/postinstall/cursor-rules.js +83 -83
  79. package/dist/cli/postinstall/cursor-skills.js +743 -743
  80. package/dist/cli/setup/Provisioner.js +42 -42
  81. package/dist/infra/lib/DeepInit.js +24 -24
  82. package/dist/infra/lib/IterationTracker.js +11 -11
  83. package/dist/infra/lib/PythonParser.js +108 -108
  84. package/dist/infra/lib/ReviewRace.js +96 -96
  85. package/dist/infra/lib/SkillFrontmatter.js +28 -28
  86. package/dist/infra/lib/SkillQualityGate.js +9 -9
  87. package/dist/infra/lib/SkillRepository.js +159 -159
  88. package/dist/infra/lib/UltraQA.js +99 -99
  89. package/dist/infra/lib/autonomy/AuditStore.js +41 -41
  90. package/dist/infra/lib/autonomy/ConfirmationStore.js +30 -30
  91. package/dist/infra/lib/autonomy/EventOutbox.js +38 -38
  92. package/dist/infra/lib/autonomy/PolicyEngine.js +18 -18
  93. package/dist/infra/lib/autonomy/SecuritySentinel.js +1 -1
  94. package/dist/infra/lib/autonomy/SuggestionStore.js +33 -33
  95. package/dist/infra/lib/embedding/VectorStore.js +22 -22
  96. package/dist/infra/lib/evolution/AgentAnalyzer.js +10 -10
  97. package/dist/infra/lib/evolution/DescriptionOptimizer.js +21 -21
  98. package/dist/infra/lib/evolution/GenerationRegistry.js +36 -36
  99. package/dist/infra/lib/evolution/InsightStore.js +90 -90
  100. package/dist/infra/lib/evolution/RollbackManager.js +5 -5
  101. package/dist/infra/lib/evolution/SkillBenchmark.js +23 -23
  102. package/dist/infra/lib/evolution/SkillEvalRunner.js +50 -50
  103. package/dist/infra/lib/evolution/SkillGapDetector.js +10 -10
  104. package/dist/infra/lib/evolution/UsageTracker.js +28 -28
  105. package/dist/infra/lib/gemini/orchestration.js +5 -5
  106. package/dist/infra/lib/gpt/orchestration.js +4 -4
  107. package/dist/infra/lib/memory/KnowledgeGraph.js +4 -4
  108. package/dist/infra/lib/memory/MemorySearch.js +57 -57
  109. package/dist/infra/lib/memory/MemoryStorage.js +181 -181
  110. package/dist/infra/lib/memory/ObservationStore.js +28 -28
  111. package/dist/infra/lib/memory/ReflectionStore.js +30 -30
  112. package/dist/infra/lib/memory/SessionRAGRetriever.js +7 -7
  113. package/dist/infra/lib/memory/SessionRAGStore.js +225 -225
  114. package/dist/infra/lib/memory/SessionSummarizer.js +9 -9
  115. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts +52 -0
  116. package/dist/infra/lib/telemetry/SkillTelemetry.d.ts.map +1 -0
  117. package/dist/infra/lib/telemetry/SkillTelemetry.js +117 -0
  118. package/dist/infra/lib/telemetry/SkillTelemetry.js.map +1 -0
  119. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts +2 -0
  120. package/dist/infra/lib/telemetry/SkillTelemetry.test.d.ts.map +1 -0
  121. package/dist/infra/lib/telemetry/SkillTelemetry.test.js +91 -0
  122. package/dist/infra/lib/telemetry/SkillTelemetry.test.js.map +1 -0
  123. package/dist/infra/orchestrator/AgentManager.js +12 -12
  124. package/dist/infra/orchestrator/AgentRegistry.js +65 -65
  125. package/dist/infra/orchestrator/MultiLlmResearch.js +8 -8
  126. package/dist/infra/orchestrator/SwarmOrchestrator.test.js +16 -16
  127. package/dist/infra/orchestrator/parallelResearch.js +24 -24
  128. package/dist/test-helpers/index.d.ts +36 -0
  129. package/dist/test-helpers/index.d.ts.map +1 -0
  130. package/dist/test-helpers/index.js +85 -0
  131. package/dist/test-helpers/index.js.map +1 -0
  132. package/dist/test-helpers/index.test.d.ts +2 -0
  133. package/dist/test-helpers/index.test.d.ts.map +1 -0
  134. package/dist/test-helpers/index.test.js +92 -0
  135. package/dist/test-helpers/index.test.js.map +1 -0
  136. package/dist/tools/convention/analyzeComplexity.test.js +115 -115
  137. package/dist/tools/convention/validateCodeQuality.test.js +104 -104
  138. package/dist/tools/memory/createMemoryTimeline.js +10 -10
  139. package/dist/tools/memory/getMemoryGraph.js +12 -12
  140. package/dist/tools/memory/getSessionContext.js +9 -9
  141. package/dist/tools/memory/linkMemories.js +14 -14
  142. package/dist/tools/memory/listMemories.js +4 -4
  143. package/dist/tools/memory/recallMemory.js +4 -4
  144. package/dist/tools/memory/saveMemory.js +4 -4
  145. package/dist/tools/memory/searchMemoriesAdvanced.js +23 -23
  146. package/dist/tools/semantic/analyzeDependencyGraph.js +12 -12
  147. package/dist/tools/semantic/astGrep.test.js +6 -6
  148. package/dist/tools/spec/prdParser.test.js +171 -171
  149. package/dist/tools/spec/specGenerator.js +169 -169
  150. package/dist/tools/spec/traceabilityMatrix.js +64 -64
  151. package/dist/tools/spec/traceabilityMatrix.test.js +28 -28
  152. package/hooks/gemini-hooks.json +73 -73
  153. package/hooks/hooks.json +137 -137
  154. package/hooks/scripts/code-check.js +77 -77
  155. package/hooks/scripts/context-save.js +212 -212
  156. package/hooks/scripts/hud-status.js +291 -291
  157. package/hooks/scripts/keyword-detector.js +214 -214
  158. package/hooks/scripts/llm-orchestrate.js +475 -475
  159. package/hooks/scripts/post-edit.js +32 -32
  160. package/hooks/scripts/pre-tool-guard.js +125 -125
  161. package/hooks/scripts/prompt-dispatcher.js +185 -185
  162. package/hooks/scripts/sentinel-guard.js +104 -104
  163. package/hooks/scripts/session-start.js +106 -106
  164. package/hooks/scripts/stop-notify.js +209 -209
  165. package/hooks/scripts/utils.js +100 -100
  166. package/languages/csharp-unity.md +515 -515
  167. package/languages/gdscript-godot.md +470 -470
  168. package/languages/ruby-rails.md +489 -489
  169. package/languages/typescript-angular.md +433 -433
  170. package/languages/typescript-astro.md +416 -416
  171. package/languages/typescript-electron.md +406 -406
  172. package/languages/typescript-nestjs.md +524 -524
  173. package/languages/typescript-svelte.md +407 -407
  174. package/languages/typescript-tauri.md +365 -365
  175. package/package.json +123 -121
  176. package/skills/agents-md/SKILL.md +120 -120
  177. package/skills/arch-guard/SKILL.md +180 -180
  178. package/skills/brand-assets/SKILL.md +146 -146
  179. package/skills/capability-loop/SKILL.md +167 -167
  180. package/skills/characterization-test/SKILL.md +206 -206
  181. package/skills/commerce-patterns/SKILL.md +63 -63
  182. package/skills/commit-push-pr/SKILL.md +75 -75
  183. package/skills/context7-usage/SKILL.md +105 -105
  184. package/skills/core-capabilities/SKILL.md +13 -13
  185. package/skills/e2e-commerce/SKILL.md +61 -61
  186. package/skills/exec-plan/SKILL.md +147 -147
  187. package/skills/frontend-design/SKILL.md +12 -12
  188. package/skills/git-worktree/SKILL.md +72 -72
  189. package/skills/handoff/SKILL.md +109 -109
  190. package/skills/parallel-research/SKILL.md +87 -87
  191. package/skills/priority-todos/SKILL.md +63 -63
  192. package/skills/seo-checklist/SKILL.md +57 -57
  193. package/skills/techdebt/SKILL.md +122 -122
  194. package/skills/tool-fallback/SKILL.md +103 -103
  195. package/skills/typescript-advanced-types/SKILL.md +66 -66
  196. package/skills/ui-ux-pro-max/SKILL.md +221 -221
  197. package/skills/vercel-react-best-practices/SKILL.md +59 -59
  198. package/skills/video-production/SKILL.md +51 -51
  199. package/vibe/config.json +29 -29
  200. package/vibe/constitution.md +227 -227
  201. package/vibe/rules/principles/communication-guide.md +98 -98
  202. package/vibe/rules/principles/development-philosophy.md +52 -52
  203. package/vibe/rules/principles/quick-start.md +102 -102
  204. package/vibe/rules/quality/bdd-contract-testing.md +393 -393
  205. package/vibe/rules/quality/checklist.md +276 -276
  206. package/vibe/rules/quality/performance.md +236 -236
  207. package/vibe/rules/quality/testing-strategy.md +440 -440
  208. package/vibe/rules/standards/anti-patterns.md +541 -541
  209. package/vibe/rules/standards/code-structure.md +291 -291
  210. package/vibe/rules/standards/complexity-metrics.md +313 -313
  211. package/vibe/rules/standards/git-workflow.md +237 -237
  212. package/vibe/rules/standards/naming-conventions.md +198 -198
  213. package/vibe/rules/standards/security.md +305 -305
  214. package/vibe/rules/writing/document-style.md +74 -74
  215. package/vibe/setup.sh +31 -31
  216. package/vibe/templates/constitution-template.md +252 -252
  217. package/vibe/templates/contract-backend-template.md +526 -526
  218. package/vibe/templates/contract-frontend-template.md +599 -599
  219. package/vibe/templates/feature-template.md +96 -96
  220. package/vibe/templates/spec-template.md +221 -221
  221. package/vibe/ui-ux-data/charts.csv +26 -26
  222. package/vibe/ui-ux-data/colors.csv +97 -97
  223. package/vibe/ui-ux-data/icons.csv +101 -101
  224. package/vibe/ui-ux-data/landing.csv +31 -31
  225. package/vibe/ui-ux-data/products.csv +96 -96
  226. package/vibe/ui-ux-data/react-performance.csv +45 -45
  227. package/vibe/ui-ux-data/stacks/astro.csv +54 -54
  228. package/vibe/ui-ux-data/stacks/flutter.csv +53 -53
  229. package/vibe/ui-ux-data/stacks/html-tailwind.csv +56 -56
  230. package/vibe/ui-ux-data/stacks/jetpack-compose.csv +53 -53
  231. package/vibe/ui-ux-data/stacks/nextjs.csv +53 -53
  232. package/vibe/ui-ux-data/stacks/nuxt-ui.csv +51 -51
  233. package/vibe/ui-ux-data/stacks/nuxtjs.csv +59 -59
  234. package/vibe/ui-ux-data/stacks/react-native.csv +52 -52
  235. package/vibe/ui-ux-data/stacks/react.csv +54 -54
  236. package/vibe/ui-ux-data/stacks/shadcn.csv +61 -61
  237. package/vibe/ui-ux-data/stacks/svelte.csv +54 -54
  238. package/vibe/ui-ux-data/stacks/swiftui.csv +51 -51
  239. package/vibe/ui-ux-data/stacks/vue.csv +50 -50
  240. package/vibe/ui-ux-data/styles.csv +68 -68
  241. package/vibe/ui-ux-data/typography.csv +57 -57
  242. package/vibe/ui-ux-data/ui-reasoning.csv +101 -101
  243. package/vibe/ui-ux-data/ux-guidelines.csv +99 -99
  244. package/vibe/ui-ux-data/version.json +31 -31
  245. package/vibe/ui-ux-data/web-interface.csv +31 -31
@@ -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);