@sienklogic/plan-build-run 2.0.0 → 2.0.1

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 (225) hide show
  1. package/CHANGELOG.md +56 -56
  2. package/CLAUDE.md +149 -149
  3. package/LICENSE +21 -21
  4. package/README.md +247 -247
  5. package/dashboard/bin/cli.js +25 -25
  6. package/dashboard/package.json +34 -34
  7. package/dashboard/public/css/layout.css +406 -406
  8. package/dashboard/public/css/status-colors.css +98 -98
  9. package/dashboard/public/js/htmx-title.js +5 -5
  10. package/dashboard/public/js/sidebar-toggle.js +20 -20
  11. package/dashboard/src/app.js +78 -78
  12. package/dashboard/src/middleware/errorHandler.js +52 -52
  13. package/dashboard/src/middleware/notFoundHandler.js +9 -9
  14. package/dashboard/src/repositories/planning.repository.js +128 -128
  15. package/dashboard/src/routes/events.routes.js +40 -40
  16. package/dashboard/src/routes/index.routes.js +31 -31
  17. package/dashboard/src/routes/pages.routes.js +245 -195
  18. package/dashboard/src/server.js +42 -42
  19. package/dashboard/src/services/dashboard.service.js +222 -222
  20. package/dashboard/src/services/phase.service.js +220 -167
  21. package/dashboard/src/services/project.service.js +57 -57
  22. package/dashboard/src/services/roadmap.service.js +171 -171
  23. package/dashboard/src/services/sse.service.js +58 -58
  24. package/dashboard/src/services/todo.service.js +254 -254
  25. package/dashboard/src/services/watcher.service.js +48 -48
  26. package/dashboard/src/views/coming-soon.ejs +11 -11
  27. package/dashboard/src/views/error.ejs +13 -13
  28. package/dashboard/src/views/index.ejs +5 -5
  29. package/dashboard/src/views/layout.ejs +1 -1
  30. package/dashboard/src/views/partials/dashboard-content.ejs +77 -77
  31. package/dashboard/src/views/partials/footer.ejs +3 -3
  32. package/dashboard/src/views/partials/head.ejs +21 -21
  33. package/dashboard/src/views/partials/header.ejs +12 -12
  34. package/dashboard/src/views/partials/layout-bottom.ejs +15 -15
  35. package/dashboard/src/views/partials/layout-top.ejs +8 -8
  36. package/dashboard/src/views/partials/phase-content.ejs +188 -181
  37. package/dashboard/src/views/partials/phase-doc-content.ejs +38 -0
  38. package/dashboard/src/views/partials/phases-content.ejs +117 -117
  39. package/dashboard/src/views/partials/roadmap-content.ejs +142 -142
  40. package/dashboard/src/views/partials/sidebar.ejs +38 -38
  41. package/dashboard/src/views/partials/todo-create-content.ejs +53 -53
  42. package/dashboard/src/views/partials/todo-detail-content.ejs +38 -38
  43. package/dashboard/src/views/partials/todos-content.ejs +53 -53
  44. package/dashboard/src/views/phase-detail.ejs +5 -5
  45. package/dashboard/src/views/phase-doc.ejs +5 -0
  46. package/dashboard/src/views/phases.ejs +5 -5
  47. package/dashboard/src/views/roadmap.ejs +5 -5
  48. package/dashboard/src/views/todo-create.ejs +5 -5
  49. package/dashboard/src/views/todo-detail.ejs +5 -5
  50. package/dashboard/src/views/todos.ejs +5 -5
  51. package/package.json +57 -57
  52. package/plugins/pbr/.claude-plugin/plugin.json +13 -13
  53. package/plugins/pbr/UI-CONSISTENCY-GAPS.md +61 -61
  54. package/plugins/pbr/agents/codebase-mapper.md +279 -271
  55. package/plugins/pbr/agents/debugger.md +281 -281
  56. package/plugins/pbr/agents/executor.md +428 -407
  57. package/plugins/pbr/agents/general.md +164 -164
  58. package/plugins/pbr/agents/integration-checker.md +169 -141
  59. package/plugins/pbr/agents/plan-checker.md +296 -280
  60. package/plugins/pbr/agents/planner.md +358 -358
  61. package/plugins/pbr/agents/researcher.md +363 -363
  62. package/plugins/pbr/agents/synthesizer.md +230 -230
  63. package/plugins/pbr/agents/verifier.md +489 -454
  64. package/plugins/pbr/commands/begin.md +5 -5
  65. package/plugins/pbr/commands/build.md +5 -5
  66. package/plugins/pbr/commands/config.md +5 -5
  67. package/plugins/pbr/commands/continue.md +5 -5
  68. package/plugins/pbr/commands/debug.md +5 -5
  69. package/plugins/pbr/commands/discuss.md +5 -5
  70. package/plugins/pbr/commands/explore.md +5 -5
  71. package/plugins/pbr/commands/health.md +5 -5
  72. package/plugins/pbr/commands/help.md +5 -5
  73. package/plugins/pbr/commands/import.md +5 -5
  74. package/plugins/pbr/commands/milestone.md +5 -5
  75. package/plugins/pbr/commands/note.md +5 -5
  76. package/plugins/pbr/commands/pause.md +5 -5
  77. package/plugins/pbr/commands/plan.md +5 -5
  78. package/plugins/pbr/commands/quick.md +5 -5
  79. package/plugins/pbr/commands/resume.md +5 -5
  80. package/plugins/pbr/commands/review.md +5 -5
  81. package/plugins/pbr/commands/scan.md +5 -5
  82. package/plugins/pbr/commands/setup.md +5 -5
  83. package/plugins/pbr/commands/status.md +5 -5
  84. package/plugins/pbr/commands/todo.md +5 -5
  85. package/plugins/pbr/contexts/dev.md +27 -27
  86. package/plugins/pbr/contexts/research.md +28 -28
  87. package/plugins/pbr/contexts/review.md +36 -36
  88. package/plugins/pbr/hooks/hooks.json +183 -183
  89. package/plugins/pbr/references/agent-anti-patterns.md +24 -24
  90. package/plugins/pbr/references/agent-interactions.md +134 -134
  91. package/plugins/pbr/references/agent-teams.md +54 -54
  92. package/plugins/pbr/references/checkpoints.md +157 -157
  93. package/plugins/pbr/references/common-bug-patterns.md +13 -13
  94. package/plugins/pbr/references/config-reference.md +441 -0
  95. package/plugins/pbr/references/continuation-format.md +212 -212
  96. package/plugins/pbr/references/deviation-rules.md +112 -112
  97. package/plugins/pbr/references/git-integration.md +226 -226
  98. package/plugins/pbr/references/integration-patterns.md +117 -117
  99. package/plugins/pbr/references/model-profiles.md +99 -99
  100. package/plugins/pbr/references/model-selection.md +31 -31
  101. package/plugins/pbr/references/pbr-rules.md +193 -193
  102. package/plugins/pbr/references/plan-authoring.md +181 -181
  103. package/plugins/pbr/references/plan-format.md +287 -283
  104. package/plugins/pbr/references/planning-config.md +213 -213
  105. package/plugins/pbr/references/questioning.md +214 -214
  106. package/plugins/pbr/references/reading-verification.md +127 -127
  107. package/plugins/pbr/references/stub-patterns.md +160 -160
  108. package/plugins/pbr/references/subagent-coordination.md +119 -119
  109. package/plugins/pbr/references/ui-formatting.md +461 -399
  110. package/plugins/pbr/references/verification-patterns.md +198 -198
  111. package/plugins/pbr/references/wave-execution.md +95 -95
  112. package/plugins/pbr/scripts/auto-continue.js +80 -80
  113. package/plugins/pbr/scripts/check-dangerous-commands.js +136 -136
  114. package/plugins/pbr/scripts/check-doc-sprawl.js +102 -102
  115. package/plugins/pbr/scripts/check-phase-boundary.js +196 -196
  116. package/plugins/pbr/scripts/check-plan-format.js +270 -270
  117. package/plugins/pbr/scripts/check-roadmap-sync.js +322 -252
  118. package/plugins/pbr/scripts/check-skill-workflow.js +262 -262
  119. package/plugins/pbr/scripts/check-state-sync.js +476 -476
  120. package/plugins/pbr/scripts/check-subagent-output.js +144 -144
  121. package/plugins/pbr/scripts/config-schema.json +251 -251
  122. package/plugins/pbr/scripts/context-budget-check.js +287 -287
  123. package/plugins/pbr/scripts/event-handler.js +151 -151
  124. package/plugins/pbr/scripts/event-logger.js +92 -92
  125. package/plugins/pbr/scripts/hook-logger.js +80 -76
  126. package/plugins/pbr/scripts/hooks-schema.json +79 -79
  127. package/plugins/pbr/scripts/log-subagent.js +164 -152
  128. package/plugins/pbr/scripts/log-tool-failure.js +88 -88
  129. package/plugins/pbr/scripts/pbr-tools.js +1378 -1301
  130. package/plugins/pbr/scripts/post-write-dispatch.js +66 -66
  131. package/plugins/pbr/scripts/post-write-quality.js +207 -207
  132. package/plugins/pbr/scripts/pre-bash-dispatch.js +86 -56
  133. package/plugins/pbr/scripts/pre-write-dispatch.js +97 -62
  134. package/plugins/pbr/scripts/progress-tracker.js +281 -228
  135. package/plugins/pbr/scripts/run-hook.js +92 -0
  136. package/plugins/pbr/scripts/session-cleanup.js +254 -254
  137. package/plugins/pbr/scripts/status-line.js +288 -285
  138. package/plugins/pbr/scripts/suggest-compact.js +119 -119
  139. package/plugins/pbr/scripts/task-completed.js +45 -45
  140. package/plugins/pbr/scripts/track-context-budget.js +149 -119
  141. package/plugins/pbr/scripts/validate-commit.js +200 -200
  142. package/plugins/pbr/scripts/validate-plugin-structure.js +183 -172
  143. package/plugins/pbr/scripts/validate-task.js +106 -0
  144. package/plugins/pbr/skills/begin/SKILL.md +594 -545
  145. package/plugins/pbr/skills/begin/templates/PROJECT.md.tmpl +33 -33
  146. package/plugins/pbr/skills/begin/templates/REQUIREMENTS.md.tmpl +18 -18
  147. package/plugins/pbr/skills/begin/templates/STATE.md.tmpl +49 -49
  148. package/plugins/pbr/skills/begin/templates/config.json.tmpl +64 -63
  149. package/plugins/pbr/skills/begin/templates/researcher-prompt.md.tmpl +19 -19
  150. package/plugins/pbr/skills/begin/templates/roadmap-prompt.md.tmpl +30 -30
  151. package/plugins/pbr/skills/begin/templates/synthesis-prompt.md.tmpl +16 -16
  152. package/plugins/pbr/skills/build/SKILL.md +943 -962
  153. package/plugins/pbr/skills/config/SKILL.md +256 -241
  154. package/plugins/pbr/skills/continue/SKILL.md +164 -127
  155. package/plugins/pbr/skills/debug/SKILL.md +515 -489
  156. package/plugins/pbr/skills/debug/templates/continuation-prompt.md.tmpl +16 -16
  157. package/plugins/pbr/skills/debug/templates/initial-investigation-prompt.md.tmpl +27 -27
  158. package/plugins/pbr/skills/discuss/SKILL.md +347 -338
  159. package/plugins/pbr/skills/discuss/templates/CONTEXT.md.tmpl +61 -61
  160. package/plugins/pbr/skills/discuss/templates/decision-categories.md +9 -9
  161. package/plugins/pbr/skills/explore/SKILL.md +378 -362
  162. package/plugins/pbr/skills/health/SKILL.md +221 -186
  163. package/plugins/pbr/skills/health/templates/check-pattern.md.tmpl +30 -30
  164. package/plugins/pbr/skills/health/templates/output-format.md.tmpl +63 -63
  165. package/plugins/pbr/skills/help/SKILL.md +155 -140
  166. package/plugins/pbr/skills/import/SKILL.md +504 -490
  167. package/plugins/pbr/skills/milestone/SKILL.md +704 -673
  168. package/plugins/pbr/skills/milestone/templates/audit-report.md.tmpl +48 -48
  169. package/plugins/pbr/skills/milestone/templates/stats-file.md.tmpl +30 -30
  170. package/plugins/pbr/skills/note/SKILL.md +231 -212
  171. package/plugins/pbr/skills/pause/SKILL.md +249 -235
  172. package/plugins/pbr/skills/pause/templates/continue-here.md.tmpl +71 -71
  173. package/plugins/pbr/skills/plan/SKILL.md +685 -628
  174. package/plugins/pbr/skills/plan/decimal-phase-calc.md +98 -98
  175. package/plugins/pbr/skills/plan/templates/checker-prompt.md.tmpl +21 -21
  176. package/plugins/pbr/skills/plan/templates/gap-closure-prompt.md.tmpl +32 -32
  177. package/plugins/pbr/skills/plan/templates/planner-prompt.md.tmpl +38 -38
  178. package/plugins/pbr/skills/plan/templates/researcher-prompt.md.tmpl +19 -19
  179. package/plugins/pbr/skills/plan/templates/revision-prompt.md.tmpl +23 -23
  180. package/plugins/pbr/skills/quick/SKILL.md +354 -335
  181. package/plugins/pbr/skills/resume/SKILL.md +402 -388
  182. package/plugins/pbr/skills/review/SKILL.md +686 -652
  183. package/plugins/pbr/skills/review/templates/debugger-prompt.md.tmpl +60 -60
  184. package/plugins/pbr/skills/review/templates/gap-planner-prompt.md.tmpl +40 -40
  185. package/plugins/pbr/skills/review/templates/verifier-prompt.md.tmpl +115 -115
  186. package/plugins/pbr/skills/scan/SKILL.md +304 -269
  187. package/plugins/pbr/skills/scan/templates/mapper-prompt.md.tmpl +201 -201
  188. package/plugins/pbr/skills/setup/SKILL.md +253 -227
  189. package/plugins/pbr/skills/shared/commit-planning-docs.md +35 -35
  190. package/plugins/pbr/skills/shared/config-loading.md +102 -102
  191. package/plugins/pbr/skills/shared/context-budget.md +40 -40
  192. package/plugins/pbr/skills/shared/context-loader-task.md +86 -86
  193. package/plugins/pbr/skills/shared/digest-select.md +79 -79
  194. package/plugins/pbr/skills/shared/domain-probes.md +125 -125
  195. package/plugins/pbr/skills/shared/error-reporting.md +79 -79
  196. package/plugins/pbr/skills/shared/gate-prompts.md +388 -388
  197. package/plugins/pbr/skills/shared/phase-argument-parsing.md +45 -45
  198. package/plugins/pbr/skills/shared/progress-display.md +53 -53
  199. package/plugins/pbr/skills/shared/revision-loop.md +81 -81
  200. package/plugins/pbr/skills/shared/state-loading.md +62 -62
  201. package/plugins/pbr/skills/shared/state-update.md +161 -161
  202. package/plugins/pbr/skills/shared/universal-anti-patterns.md +33 -33
  203. package/plugins/pbr/skills/status/SKILL.md +367 -353
  204. package/plugins/pbr/skills/todo/SKILL.md +198 -181
  205. package/plugins/pbr/templates/CONTEXT.md.tmpl +52 -52
  206. package/plugins/pbr/templates/INTEGRATION-REPORT.md.tmpl +151 -151
  207. package/plugins/pbr/templates/RESEARCH-SUMMARY.md.tmpl +97 -97
  208. package/plugins/pbr/templates/ROADMAP.md.tmpl +40 -40
  209. package/plugins/pbr/templates/SUMMARY.md.tmpl +81 -81
  210. package/plugins/pbr/templates/VERIFICATION-DETAIL.md.tmpl +116 -116
  211. package/plugins/pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -98
  212. package/plugins/pbr/templates/codebase/CONCERNS.md.tmpl +93 -93
  213. package/plugins/pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -104
  214. package/plugins/pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -78
  215. package/plugins/pbr/templates/codebase/STACK.md.tmpl +78 -78
  216. package/plugins/pbr/templates/codebase/STRUCTURE.md.tmpl +80 -80
  217. package/plugins/pbr/templates/codebase/TESTING.md.tmpl +107 -107
  218. package/plugins/pbr/templates/continue-here.md.tmpl +73 -73
  219. package/plugins/pbr/templates/prompt-partials/phase-project-context.md.tmpl +37 -37
  220. package/plugins/pbr/templates/research/ARCHITECTURE.md.tmpl +124 -124
  221. package/plugins/pbr/templates/research/STACK.md.tmpl +71 -71
  222. package/plugins/pbr/templates/research/SUMMARY.md.tmpl +112 -112
  223. package/plugins/pbr/templates/research-outputs/phase-research.md.tmpl +81 -81
  224. package/plugins/pbr/templates/research-outputs/project-research.md.tmpl +99 -99
  225. package/plugins/pbr/templates/research-outputs/synthesis.md.tmpl +36 -36
@@ -1,285 +1,288 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * Status line: Updates Claude Code status bar with phase progress and
5
- * context usage bar.
6
- *
7
- * Reads STATE.md for project position. Receives session JSON on stdin
8
- * from Claude Code (context_window, model, cost, etc.).
9
- *
10
- * Output: plain text with ANSI color codes to stdout.
11
- */
12
-
13
- const fs = require('fs');
14
- const path = require('path');
15
- const cp = require('child_process');
16
- const { logHook } = require('./hook-logger');
17
- const { configLoad } = require('./pbr-tools');
18
-
19
- // ANSI color codes
20
- const c = {
21
- reset: '\x1b[0m',
22
- bold: '\x1b[1m',
23
- dim: '\x1b[2m',
24
- cyan: '\x1b[36m',
25
- green: '\x1b[32m',
26
- yellow: '\x1b[33m',
27
- red: '\x1b[31m',
28
- blue: '\x1b[34m',
29
- magenta: '\x1b[35m',
30
- white: '\x1b[37m',
31
- boldCyan: '\x1b[1;36m',
32
- boldGreen: '\x1b[1;32m',
33
- boldYellow: '\x1b[1;33m',
34
- boldRed: '\x1b[1;31m',
35
- };
36
-
37
- // Default status_line config — works out of the box with zero config
38
- const DEFAULTS = {
39
- sections: ['phase', 'plan', 'status', 'git', 'context'],
40
- brand_text: '\u25C6 Plan-Build-Run',
41
- max_status_length: 50,
42
- context_bar: {
43
- width: 10,
44
- thresholds: { green: 70, yellow: 90 },
45
- chars: { filled: '\u2588', empty: '\u2591' }
46
- }
47
- };
48
-
49
- /**
50
- * Load status_line config from .planning/config.json, merged with defaults.
51
- * Returns DEFAULTS if no config exists or no status_line section is present.
52
- */
53
- function loadStatusLineConfig(planningDir) {
54
- const config = configLoad(planningDir);
55
- if (!config || !config.status_line) return DEFAULTS;
56
-
57
- const sl = config.status_line;
58
- return {
59
- sections: Array.isArray(sl.sections) ? sl.sections : DEFAULTS.sections,
60
- brand_text: typeof sl.brand_text === 'string' ? sl.brand_text : DEFAULTS.brand_text,
61
- max_status_length: typeof sl.max_status_length === 'number' ? sl.max_status_length : DEFAULTS.max_status_length,
62
- context_bar: {
63
- width: (sl.context_bar && typeof sl.context_bar.width === 'number') ? sl.context_bar.width : DEFAULTS.context_bar.width,
64
- thresholds: {
65
- green: (sl.context_bar && sl.context_bar.thresholds && typeof sl.context_bar.thresholds.green === 'number') ? sl.context_bar.thresholds.green : DEFAULTS.context_bar.thresholds.green,
66
- yellow: (sl.context_bar && sl.context_bar.thresholds && typeof sl.context_bar.thresholds.yellow === 'number') ? sl.context_bar.thresholds.yellow : DEFAULTS.context_bar.thresholds.yellow
67
- },
68
- chars: {
69
- filled: (sl.context_bar && sl.context_bar.chars && typeof sl.context_bar.chars.filled === 'string') ? sl.context_bar.chars.filled : DEFAULTS.context_bar.chars.filled,
70
- empty: (sl.context_bar && sl.context_bar.chars && typeof sl.context_bar.chars.empty === 'string') ? sl.context_bar.chars.empty : DEFAULTS.context_bar.chars.empty
71
- }
72
- }
73
- };
74
- }
75
-
76
- function readStdin() {
77
- try {
78
- const input = fs.readFileSync(0, 'utf8').trim();
79
- if (input) return JSON.parse(input);
80
- } catch (_e) {
81
- // stdin may be empty or not JSON — that's fine
82
- }
83
- return {};
84
- }
85
-
86
- function getContextPercent(stdinData) {
87
- // Claude Code statusLine sends context_window.used_percentage (0-100)
88
- if (stdinData.context_window && stdinData.context_window.used_percentage != null) {
89
- return Math.round(stdinData.context_window.used_percentage);
90
- }
91
- // Legacy field name
92
- if (stdinData.context_usage_fraction != null) {
93
- return Math.round(stdinData.context_usage_fraction * 100);
94
- }
95
- return null;
96
- }
97
-
98
- /**
99
- * Build a horizontal bar using Unicode block characters.
100
- * Width is in character cells. Color shifts green -> yellow -> red.
101
- *
102
- * @param {number} percent - Usage percentage (0-100)
103
- * @param {number} width - Bar width in characters
104
- * @param {object} [opts] - Optional config overrides
105
- * @param {object} [opts.thresholds] - { green: number, yellow: number }
106
- * @param {object} [opts.chars] - { filled: string, empty: string }
107
- */
108
- function buildContextBar(percent, width, opts) {
109
- if (width < 1) return '';
110
- const thresholds = (opts && opts.thresholds) || DEFAULTS.context_bar.thresholds;
111
- const chars = (opts && opts.chars) || DEFAULTS.context_bar.chars;
112
-
113
- const filled = Math.round((percent / 100) * width);
114
- const empty = width - filled;
115
-
116
- // Color based on usage threshold
117
- let barColor;
118
- if (percent >= thresholds.yellow) barColor = c.boldRed;
119
- else if (percent >= thresholds.green) barColor = c.boldYellow;
120
- else barColor = c.boldGreen;
121
-
122
- const filledStr = chars.filled.repeat(filled);
123
- const emptyStr = chars.empty.repeat(empty);
124
-
125
- return `${barColor}${filledStr}${c.dim}${emptyStr}${c.reset}`;
126
- }
127
-
128
- /**
129
- * Pick a color for the phase status keyword.
130
- */
131
- function statusColor(statusText) {
132
- const lower = statusText.toLowerCase();
133
- if (lower.includes('complete') || lower.includes('verified')) return c.green;
134
- if (lower.includes('progress') || lower.includes('building') || lower.includes('executing')) return c.yellow;
135
- if (lower.includes('planned') || lower.includes('ready')) return c.cyan;
136
- if (lower.includes('blocked') || lower.includes('failed')) return c.red;
137
- return c.white;
138
- }
139
-
140
- /**
141
- * Get current git branch and dirty status.
142
- * Returns null if not in a git repo or git is unavailable.
143
- */
144
- function getGitInfo() {
145
- try {
146
- const branch = cp.execSync('git branch --show-current', {
147
- timeout: 500, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe']
148
- }).trim();
149
- if (!branch) return null;
150
- const porcelain = cp.execSync('git status --porcelain', {
151
- timeout: 500, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe']
152
- }).trim();
153
- return { branch, dirty: porcelain.length > 0 };
154
- } catch (_e) {
155
- return null;
156
- }
157
- }
158
-
159
- /**
160
- * Format milliseconds into human-readable duration (e.g. "12m", "1h23m").
161
- */
162
- function formatDuration(ms) {
163
- const totalSeconds = Math.floor(ms / 1000);
164
- const hours = Math.floor(totalSeconds / 3600);
165
- const minutes = Math.floor((totalSeconds % 3600) / 60);
166
- if (hours > 0) return `${hours}h${minutes > 0 ? minutes + 'm' : ''}`;
167
- return `${minutes}m`;
168
- }
169
-
170
- function main() {
171
- const stdinData = readStdin();
172
- const cwd = process.cwd();
173
- const planningDir = path.join(cwd, '.planning');
174
- const stateFile = path.join(planningDir, 'STATE.md');
175
-
176
- if (!fs.existsSync(stateFile)) {
177
- process.exit(0);
178
- }
179
-
180
- try {
181
- const slConfig = loadStatusLineConfig(planningDir);
182
- const content = fs.readFileSync(stateFile, 'utf8');
183
- const ctxPercent = getContextPercent(stdinData);
184
- const status = buildStatusLine(content, ctxPercent, slConfig, stdinData);
185
-
186
- if (status) {
187
- process.stdout.write(status);
188
- logHook('status-line', 'StatusLine', 'updated', { ctxPercent });
189
- }
190
- } catch (_e) {
191
- logHook('status-line', 'StatusLine', 'error', { error: _e.message });
192
- }
193
-
194
- process.exit(0);
195
- }
196
-
197
- function buildStatusLine(content, ctxPercent, cfg, stdinData) {
198
- const config = cfg || DEFAULTS;
199
- const sections = config.sections || DEFAULTS.sections;
200
- const brandText = config.brand_text || DEFAULTS.brand_text;
201
- const maxLen = config.max_status_length || DEFAULTS.max_status_length;
202
- const barCfg = config.context_bar || DEFAULTS.context_bar;
203
- const sd = stdinData || {};
204
-
205
- const parts = [];
206
-
207
- // Phase section (always includes brand text)
208
- if (sections.includes('phase')) {
209
- const phaseMatch = content.match(/Phase:\s*(\d+)\s*of\s*(\d+)\s*(?:\(([^)]+)\))?/);
210
- if (phaseMatch) {
211
- parts.push(`${c.boldCyan}${brandText}${c.reset} ${c.bold}Phase ${phaseMatch[1]}/${phaseMatch[2]}${c.reset}`);
212
- if (phaseMatch[3]) {
213
- parts.push(`${c.magenta}${phaseMatch[3]}${c.reset}`);
214
- }
215
- } else {
216
- parts.push(`${c.boldCyan}${brandText}${c.reset}`);
217
- }
218
- }
219
-
220
- // Plan section
221
- if (sections.includes('plan')) {
222
- const planMatch = content.match(/Plan:\s*(\d+)\s*of\s*(\d+)/);
223
- if (planMatch) {
224
- const done = parseInt(planMatch[1], 10);
225
- const total = parseInt(planMatch[2], 10);
226
- const planColor = done === total ? c.green : c.white;
227
- parts.push(`${planColor}Plan ${done}/${total}${c.reset}`);
228
- }
229
- }
230
-
231
- // Status section
232
- if (sections.includes('status')) {
233
- const statusMatch = content.match(/Status:\s*(.+)/);
234
- if (statusMatch) {
235
- const text = statusMatch[1].trim();
236
- const short = text.length > maxLen ? text.slice(0, maxLen - 3) + '...' : text;
237
- parts.push(`${statusColor(text)}${short}${c.reset}`);
238
- }
239
- }
240
-
241
- // Git section — branch name + dirty indicator
242
- if (sections.includes('git')) {
243
- const gitInfo = getGitInfo();
244
- if (gitInfo) {
245
- const dirtyMark = gitInfo.dirty ? `${c.yellow}*${c.reset}` : '';
246
- parts.push(`${c.cyan}${gitInfo.branch}${c.reset}${dirtyMark}`);
247
- }
248
- }
249
-
250
- // Model section — current model display name from stdin
251
- if (sections.includes('model') && sd.model && sd.model.display_name) {
252
- parts.push(`${c.dim}${sd.model.display_name}${c.reset}`);
253
- }
254
-
255
- // Cost section — session cost from stdin
256
- if (sections.includes('cost') && sd.cost && sd.cost.total_cost_usd != null) {
257
- const cost = sd.cost.total_cost_usd;
258
- const costStr = `$${cost.toFixed(2)}`;
259
- let costColor = c.dim;
260
- if (cost > 5) costColor = c.red;
261
- else if (cost > 1) costColor = c.yellow;
262
- parts.push(`${costColor}${costStr}${c.reset}`);
263
- }
264
-
265
- // Duration section — session wall-clock time from stdin
266
- if (sections.includes('duration') && sd.cost && sd.cost.total_duration_ms != null) {
267
- parts.push(`${c.dim}${formatDuration(sd.cost.total_duration_ms)}${c.reset}`);
268
- }
269
-
270
- // Context bar section
271
- if (sections.includes('context') && ctxPercent != null) {
272
- const bar = buildContextBar(ctxPercent, barCfg.width || DEFAULTS.context_bar.width, {
273
- thresholds: barCfg.thresholds || DEFAULTS.context_bar.thresholds,
274
- chars: barCfg.chars || DEFAULTS.context_bar.chars
275
- });
276
- parts.push(`${bar} ${c.dim}${ctxPercent}%${c.reset}`);
277
- }
278
-
279
- if (parts.length === 0) return null;
280
-
281
- return parts.join(` ${c.dim}\u2502${c.reset} `);
282
- }
283
-
284
- if (require.main === module) { main(); }
285
- module.exports = { buildStatusLine, buildContextBar, getContextPercent, getGitInfo, formatDuration, loadStatusLineConfig, DEFAULTS };
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Status line: Updates Claude Code status bar with phase progress and
5
+ * context usage bar.
6
+ *
7
+ * Reads STATE.md for project position. Receives session JSON on stdin
8
+ * from Claude Code (context_window, model, cost, etc.).
9
+ *
10
+ * Output: plain text with ANSI color codes to stdout.
11
+ */
12
+
13
+ const fs = require('fs');
14
+ const path = require('path');
15
+ const cp = require('child_process');
16
+ const { logHook } = require('./hook-logger');
17
+ const { configLoad } = require('./pbr-tools');
18
+
19
+ // ANSI color codes
20
+ const c = {
21
+ reset: '\x1b[0m',
22
+ bold: '\x1b[1m',
23
+ dim: '\x1b[2m',
24
+ cyan: '\x1b[36m',
25
+ green: '\x1b[32m',
26
+ yellow: '\x1b[33m',
27
+ red: '\x1b[31m',
28
+ blue: '\x1b[34m',
29
+ magenta: '\x1b[35m',
30
+ white: '\x1b[37m',
31
+ boldCyan: '\x1b[1;36m',
32
+ boldGreen: '\x1b[1;32m',
33
+ boldYellow: '\x1b[1;33m',
34
+ boldRed: '\x1b[1;31m',
35
+ };
36
+
37
+ // Default status_line config — works out of the box with zero config
38
+ const DEFAULTS = {
39
+ sections: ['phase', 'plan', 'status', 'git', 'context'],
40
+ brand_text: '\u25C6 Plan-Build-Run',
41
+ max_status_length: 50,
42
+ context_bar: {
43
+ width: 10,
44
+ thresholds: { green: 70, yellow: 90 },
45
+ chars: { filled: '\u2588', empty: '\u2591' }
46
+ }
47
+ };
48
+
49
+ /**
50
+ * Load status_line config from .planning/config.json, merged with defaults.
51
+ * Returns DEFAULTS if no config exists or no status_line section is present.
52
+ */
53
+ function loadStatusLineConfig(planningDir) {
54
+ const config = configLoad(planningDir);
55
+ if (!config || !config.status_line) return DEFAULTS;
56
+
57
+ const sl = config.status_line;
58
+ return {
59
+ sections: Array.isArray(sl.sections) ? sl.sections : DEFAULTS.sections,
60
+ brand_text: typeof sl.brand_text === 'string' ? sl.brand_text : DEFAULTS.brand_text,
61
+ max_status_length: typeof sl.max_status_length === 'number' ? sl.max_status_length : DEFAULTS.max_status_length,
62
+ context_bar: {
63
+ width: (sl.context_bar && typeof sl.context_bar.width === 'number') ? sl.context_bar.width : DEFAULTS.context_bar.width,
64
+ thresholds: {
65
+ green: (sl.context_bar && sl.context_bar.thresholds && typeof sl.context_bar.thresholds.green === 'number') ? sl.context_bar.thresholds.green : DEFAULTS.context_bar.thresholds.green,
66
+ yellow: (sl.context_bar && sl.context_bar.thresholds && typeof sl.context_bar.thresholds.yellow === 'number') ? sl.context_bar.thresholds.yellow : DEFAULTS.context_bar.thresholds.yellow
67
+ },
68
+ chars: {
69
+ filled: (sl.context_bar && sl.context_bar.chars && typeof sl.context_bar.chars.filled === 'string') ? sl.context_bar.chars.filled : DEFAULTS.context_bar.chars.filled,
70
+ empty: (sl.context_bar && sl.context_bar.chars && typeof sl.context_bar.chars.empty === 'string') ? sl.context_bar.chars.empty : DEFAULTS.context_bar.chars.empty
71
+ }
72
+ }
73
+ };
74
+ }
75
+
76
+ function readStdin() {
77
+ try {
78
+ const input = fs.readFileSync(0, 'utf8').trim();
79
+ if (input) return JSON.parse(input);
80
+ } catch (_e) {
81
+ // stdin may be empty or not JSON — that's fine
82
+ }
83
+ return {};
84
+ }
85
+
86
+ function getContextPercent(stdinData) {
87
+ // Claude Code statusLine sends context_window.used_percentage (0-100)
88
+ if (stdinData.context_window && stdinData.context_window.used_percentage != null) {
89
+ return Math.round(stdinData.context_window.used_percentage);
90
+ }
91
+ // Legacy field name
92
+ if (stdinData.context_usage_fraction != null) {
93
+ return Math.round(stdinData.context_usage_fraction * 100);
94
+ }
95
+ return null;
96
+ }
97
+
98
+ /**
99
+ * Build a horizontal bar using Unicode block characters.
100
+ * Width is in character cells. Color shifts green -> yellow -> red.
101
+ *
102
+ * @param {number} percent - Usage percentage (0-100)
103
+ * @param {number} width - Bar width in characters
104
+ * @param {object} [opts] - Optional config overrides
105
+ * @param {object} [opts.thresholds] - { green: number, yellow: number }
106
+ * @param {object} [opts.chars] - { filled: string, empty: string }
107
+ */
108
+ function buildContextBar(percent, width, opts) {
109
+ if (width < 1) return '';
110
+ const thresholds = (opts && opts.thresholds) || DEFAULTS.context_bar.thresholds;
111
+ const chars = (opts && opts.chars) || DEFAULTS.context_bar.chars;
112
+
113
+ const filled = Math.round((percent / 100) * width);
114
+ const empty = width - filled;
115
+
116
+ // Color based on usage threshold
117
+ let barColor;
118
+ if (percent >= thresholds.yellow) barColor = c.boldRed;
119
+ else if (percent >= thresholds.green) barColor = c.boldYellow;
120
+ else barColor = c.boldGreen;
121
+
122
+ const filledStr = chars.filled.repeat(filled);
123
+ const emptyStr = chars.empty.repeat(empty);
124
+
125
+ return `${barColor}${filledStr}${c.dim}${emptyStr}${c.reset}`;
126
+ }
127
+
128
+ /**
129
+ * Pick a color for the phase status keyword.
130
+ */
131
+ function statusColor(statusText) {
132
+ const lower = statusText.toLowerCase();
133
+ if (lower.includes('complete') || lower.includes('verified')) return c.green;
134
+ if (lower.includes('needs_fixes') || lower.includes('partial')) return c.yellow;
135
+ if (lower.includes('progress') || lower.includes('building') || lower.includes('executing') || lower.includes('planning')) return c.yellow;
136
+ if (lower.includes('verifying')) return c.blue;
137
+ if (lower.includes('planned') || lower.includes('ready')) return c.cyan;
138
+ if (lower.includes('blocked') || lower.includes('failed')) return c.red;
139
+ if (lower.includes('pending')) return c.dim;
140
+ return c.white;
141
+ }
142
+
143
+ /**
144
+ * Get current git branch and dirty status.
145
+ * Returns null if not in a git repo or git is unavailable.
146
+ */
147
+ function getGitInfo() {
148
+ try {
149
+ const branch = cp.execSync('git branch --show-current', {
150
+ timeout: 500, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe']
151
+ }).trim();
152
+ if (!branch) return null;
153
+ const porcelain = cp.execSync('git status --porcelain', {
154
+ timeout: 500, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe']
155
+ }).trim();
156
+ return { branch, dirty: porcelain.length > 0 };
157
+ } catch (_e) {
158
+ return null;
159
+ }
160
+ }
161
+
162
+ /**
163
+ * Format milliseconds into human-readable duration (e.g. "12m", "1h23m").
164
+ */
165
+ function formatDuration(ms) {
166
+ const totalSeconds = Math.floor(ms / 1000);
167
+ const hours = Math.floor(totalSeconds / 3600);
168
+ const minutes = Math.floor((totalSeconds % 3600) / 60);
169
+ if (hours > 0) return `${hours}h${minutes > 0 ? minutes + 'm' : ''}`;
170
+ return `${minutes}m`;
171
+ }
172
+
173
+ function main() {
174
+ const stdinData = readStdin();
175
+ const cwd = process.cwd();
176
+ const planningDir = path.join(cwd, '.planning');
177
+ const stateFile = path.join(planningDir, 'STATE.md');
178
+
179
+ if (!fs.existsSync(stateFile)) {
180
+ process.exit(0);
181
+ }
182
+
183
+ try {
184
+ const slConfig = loadStatusLineConfig(planningDir);
185
+ const content = fs.readFileSync(stateFile, 'utf8');
186
+ const ctxPercent = getContextPercent(stdinData);
187
+ const status = buildStatusLine(content, ctxPercent, slConfig, stdinData);
188
+
189
+ if (status) {
190
+ process.stdout.write(status);
191
+ logHook('status-line', 'StatusLine', 'updated', { ctxPercent });
192
+ }
193
+ } catch (_e) {
194
+ logHook('status-line', 'StatusLine', 'error', { error: _e.message });
195
+ }
196
+
197
+ process.exit(0);
198
+ }
199
+
200
+ function buildStatusLine(content, ctxPercent, cfg, stdinData) {
201
+ const config = cfg || DEFAULTS;
202
+ const sections = config.sections || DEFAULTS.sections;
203
+ const brandText = config.brand_text || DEFAULTS.brand_text;
204
+ const maxLen = config.max_status_length || DEFAULTS.max_status_length;
205
+ const barCfg = config.context_bar || DEFAULTS.context_bar;
206
+ const sd = stdinData || {};
207
+
208
+ const parts = [];
209
+
210
+ // Phase section (always includes brand text)
211
+ if (sections.includes('phase')) {
212
+ const phaseMatch = content.match(/Phase:\s*(\d+)\s*of\s*(\d+)\s*(?:\(([^)]+)\))?/);
213
+ if (phaseMatch) {
214
+ parts.push(`${c.boldCyan}${brandText}${c.reset} ${c.bold}Phase ${phaseMatch[1]}/${phaseMatch[2]}${c.reset}`);
215
+ if (phaseMatch[3]) {
216
+ parts.push(`${c.magenta}${phaseMatch[3]}${c.reset}`);
217
+ }
218
+ } else {
219
+ parts.push(`${c.boldCyan}${brandText}${c.reset}`);
220
+ }
221
+ }
222
+
223
+ // Plan section
224
+ if (sections.includes('plan')) {
225
+ const planMatch = content.match(/Plan:\s*(\d+)\s*of\s*(\d+)/);
226
+ if (planMatch) {
227
+ const done = parseInt(planMatch[1], 10);
228
+ const total = parseInt(planMatch[2], 10);
229
+ const planColor = done === total ? c.green : c.white;
230
+ parts.push(`${planColor}Plan ${done}/${total}${c.reset}`);
231
+ }
232
+ }
233
+
234
+ // Status section
235
+ if (sections.includes('status')) {
236
+ const statusMatch = content.match(/Status:\s*(.+)/);
237
+ if (statusMatch) {
238
+ const text = statusMatch[1].trim();
239
+ const short = text.length > maxLen ? text.slice(0, maxLen - 3) + '...' : text;
240
+ parts.push(`${statusColor(text)}${short}${c.reset}`);
241
+ }
242
+ }
243
+
244
+ // Git section — branch name + dirty indicator
245
+ if (sections.includes('git')) {
246
+ const gitInfo = getGitInfo();
247
+ if (gitInfo) {
248
+ const dirtyMark = gitInfo.dirty ? `${c.yellow}*${c.reset}` : '';
249
+ parts.push(`${c.cyan}${gitInfo.branch}${c.reset}${dirtyMark}`);
250
+ }
251
+ }
252
+
253
+ // Model section — current model display name from stdin
254
+ if (sections.includes('model') && sd.model && sd.model.display_name) {
255
+ parts.push(`${c.dim}${sd.model.display_name}${c.reset}`);
256
+ }
257
+
258
+ // Cost section — session cost from stdin
259
+ if (sections.includes('cost') && sd.cost && sd.cost.total_cost_usd != null) {
260
+ const cost = sd.cost.total_cost_usd;
261
+ const costStr = `$${cost.toFixed(2)}`;
262
+ let costColor = c.dim;
263
+ if (cost > 5) costColor = c.red;
264
+ else if (cost > 1) costColor = c.yellow;
265
+ parts.push(`${costColor}${costStr}${c.reset}`);
266
+ }
267
+
268
+ // Duration section — session wall-clock time from stdin
269
+ if (sections.includes('duration') && sd.cost && sd.cost.total_duration_ms != null) {
270
+ parts.push(`${c.dim}${formatDuration(sd.cost.total_duration_ms)}${c.reset}`);
271
+ }
272
+
273
+ // Context bar section
274
+ if (sections.includes('context') && ctxPercent != null) {
275
+ const bar = buildContextBar(ctxPercent, barCfg.width || DEFAULTS.context_bar.width, {
276
+ thresholds: barCfg.thresholds || DEFAULTS.context_bar.thresholds,
277
+ chars: barCfg.chars || DEFAULTS.context_bar.chars
278
+ });
279
+ parts.push(`${bar} ${c.dim}${ctxPercent}%${c.reset}`);
280
+ }
281
+
282
+ if (parts.length === 0) return null;
283
+
284
+ return parts.join(` ${c.dim}\u2502${c.reset} `);
285
+ }
286
+
287
+ if (require.main === module) { main(); }
288
+ module.exports = { buildStatusLine, buildContextBar, getContextPercent, getGitInfo, formatDuration, loadStatusLineConfig, DEFAULTS };