@sienklogic/plan-build-run 2.0.2 → 2.1.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 (1231) hide show
  1. package/CHANGELOG.md +51 -49
  2. package/CLAUDE.md +48 -32
  3. package/LICENSE +2 -1
  4. package/README.md +771 -87
  5. package/agents/pbr-audit.md +266 -0
  6. package/agents/pbr-codebase-mapper.md +236 -0
  7. package/agents/pbr-debugger.md +312 -0
  8. package/agents/pbr-dev-sync.md +220 -0
  9. package/agents/pbr-executor.md +559 -0
  10. package/agents/pbr-general.md +191 -0
  11. package/agents/pbr-integration-checker.md +237 -0
  12. package/agents/pbr-nyquist-auditor.md +252 -0
  13. package/agents/pbr-plan-checker.md +312 -0
  14. package/agents/pbr-planner.md +495 -0
  15. package/agents/pbr-researcher.md +314 -0
  16. package/agents/pbr-roadmapper.md +346 -0
  17. package/agents/pbr-synthesizer.md +271 -0
  18. package/agents/pbr-verifier.md +495 -0
  19. package/bin/install.js +2752 -0
  20. package/commands/pbr/add-phase.md +75 -0
  21. package/commands/pbr/add-todo.md +8 -0
  22. package/commands/pbr/audit-milestone.md +8 -0
  23. package/commands/pbr/audit.md +5 -0
  24. package/commands/pbr/check-todos.md +8 -0
  25. package/commands/pbr/complete-milestone.md +8 -0
  26. package/commands/pbr/config.md +5 -0
  27. package/commands/pbr/continue.md +5 -0
  28. package/commands/pbr/dashboard.md +5 -0
  29. package/commands/pbr/debug.md +5 -0
  30. package/commands/pbr/discuss-phase.md +6 -0
  31. package/commands/pbr/do.md +5 -0
  32. package/commands/pbr/execute-phase.md +6 -0
  33. package/commands/pbr/explore.md +5 -0
  34. package/commands/pbr/health.md +5 -0
  35. package/commands/pbr/help.md +5 -0
  36. package/commands/pbr/import.md +5 -0
  37. package/commands/pbr/insert-phase.md +65 -0
  38. package/commands/pbr/join-discord.md +11 -0
  39. package/commands/pbr/list-phase-assumptions.md +69 -0
  40. package/commands/pbr/map-codebase.md +6 -0
  41. package/commands/pbr/new-milestone.md +8 -0
  42. package/commands/pbr/new-project.md +6 -0
  43. package/commands/pbr/note.md +5 -0
  44. package/commands/pbr/pause-work.md +5 -0
  45. package/commands/pbr/plan-milestone-gaps.md +7 -0
  46. package/commands/pbr/plan-phase.md +6 -0
  47. package/commands/pbr/progress.md +6 -0
  48. package/commands/pbr/quick.md +5 -0
  49. package/commands/pbr/reapply-patches.md +40 -0
  50. package/commands/pbr/remove-phase.md +66 -0
  51. package/commands/pbr/research-phase.md +59 -0
  52. package/commands/pbr/resume-work.md +5 -0
  53. package/commands/pbr/set-profile.md +6 -0
  54. package/commands/pbr/settings.md +5 -0
  55. package/commands/pbr/setup.md +5 -0
  56. package/commands/pbr/statusline.md +5 -0
  57. package/commands/pbr/test.md +5 -0
  58. package/commands/pbr/undo.md +5 -0
  59. package/commands/pbr/update.md +37 -0
  60. package/commands/pbr/verify-work.md +6 -0
  61. package/dashboard/bin/cli.cjs +85 -0
  62. package/dashboard/eslint.config.js +37 -0
  63. package/dashboard/index.html +20 -0
  64. package/dashboard/package.json +28 -23
  65. package/dashboard/server/index.js +134 -0
  66. package/dashboard/server/lib/frontmatter.js +92 -0
  67. package/dashboard/server/middleware/static.js +35 -0
  68. package/dashboard/server/package.json +16 -0
  69. package/dashboard/server/routes/agents.js +213 -0
  70. package/dashboard/server/routes/config.js +64 -0
  71. package/dashboard/server/routes/health.js +21 -0
  72. package/dashboard/server/routes/memory.js +107 -0
  73. package/dashboard/server/routes/planning.js +234 -0
  74. package/dashboard/server/routes/projects.js +36 -0
  75. package/dashboard/server/routes/requirements.js +40 -0
  76. package/dashboard/server/routes/roadmap.js +69 -0
  77. package/dashboard/server/routes/status.js +25 -0
  78. package/dashboard/server/routes/telemetry.js +171 -0
  79. package/dashboard/server/services/file-watcher.js +105 -0
  80. package/dashboard/server/services/planning-reader.js +679 -0
  81. package/dashboard/server/test/cli.test.js +34 -0
  82. package/dashboard/server/test/frontmatter.test.js +104 -0
  83. package/dashboard/server/test/isolation.test.js +32 -0
  84. package/dashboard/server/test/planning-reader.test.js +151 -0
  85. package/dashboard/server/test/routes.test.js +91 -0
  86. package/dashboard/server/test/ws.test.js +81 -0
  87. package/dashboard/server/ws.js +96 -0
  88. package/dashboard/src/App.jsx +147 -0
  89. package/dashboard/src/components/charts/BudgetBars.jsx +42 -0
  90. package/dashboard/src/components/charts/ContextRadar.jsx +34 -0
  91. package/dashboard/src/components/charts/PhaseDonut.jsx +66 -0
  92. package/dashboard/src/components/charts/SuccessTrend.jsx +45 -0
  93. package/dashboard/src/components/charts/TokenChart.jsx +55 -0
  94. package/dashboard/src/components/charts/index.js +5 -0
  95. package/dashboard/src/components/config/CfgSection.jsx +93 -0
  96. package/dashboard/src/components/layout/Header.jsx +89 -0
  97. package/dashboard/src/components/layout/ProjectSwitcher.jsx +160 -0
  98. package/dashboard/src/components/layout/Sidebar.jsx +161 -0
  99. package/dashboard/src/components/ui/AutoModeBanner.jsx +138 -0
  100. package/dashboard/src/components/ui/BackButton.jsx +27 -0
  101. package/dashboard/src/components/ui/Badge.jsx +27 -0
  102. package/dashboard/src/components/ui/Card.jsx +23 -0
  103. package/dashboard/src/components/ui/ChartTooltip.jsx +48 -0
  104. package/dashboard/src/components/ui/CheckpointBox.jsx +110 -0
  105. package/dashboard/src/components/ui/CodeBlock.jsx +27 -0
  106. package/dashboard/src/components/ui/ConfidenceBadge.jsx +20 -0
  107. package/dashboard/src/components/ui/ConfirmModal.jsx +161 -0
  108. package/dashboard/src/components/ui/ConnectionBanner.jsx +60 -0
  109. package/dashboard/src/components/ui/ErrorBoundary.jsx +106 -0
  110. package/dashboard/src/components/ui/ErrorBox.jsx +107 -0
  111. package/dashboard/src/components/ui/KeyValue.jsx +33 -0
  112. package/dashboard/src/components/ui/LoadingSkeleton.jsx +84 -0
  113. package/dashboard/src/components/ui/MetricCard.jsx +58 -0
  114. package/dashboard/src/components/ui/NextUpBlock.jsx +92 -0
  115. package/dashboard/src/components/ui/NumberInput.jsx +44 -0
  116. package/dashboard/src/components/ui/PBRBanner.jsx +47 -0
  117. package/dashboard/src/components/ui/PipelineView.jsx +130 -0
  118. package/dashboard/src/components/ui/ProgressBar.jsx +28 -0
  119. package/dashboard/src/components/ui/ProgressDisplay.jsx +47 -0
  120. package/dashboard/src/components/ui/QualityGateBadge.jsx +15 -0
  121. package/dashboard/src/components/ui/SectionTitle.jsx +35 -0
  122. package/dashboard/src/components/ui/SelectInput.jsx +45 -0
  123. package/dashboard/src/components/ui/StatusDot.jsx +51 -0
  124. package/dashboard/src/components/ui/StatusSymbol.jsx +49 -0
  125. package/dashboard/src/components/ui/TabBar.jsx +41 -0
  126. package/dashboard/src/components/ui/TextInput.jsx +42 -0
  127. package/dashboard/src/components/ui/Toast.jsx +117 -0
  128. package/dashboard/src/components/ui/Toggle.jsx +70 -0
  129. package/dashboard/src/components/ui/index.js +29 -0
  130. package/dashboard/src/hooks/useDocumentTitle.js +16 -0
  131. package/dashboard/src/hooks/useFetch.js +50 -0
  132. package/dashboard/src/hooks/useToast.jsx +43 -0
  133. package/dashboard/src/hooks/useWebSocket.js +103 -0
  134. package/dashboard/src/lib/api.js +112 -0
  135. package/dashboard/src/lib/configSchema.js +189 -0
  136. package/dashboard/src/lib/constants.js +16 -0
  137. package/dashboard/src/main.jsx +15 -0
  138. package/dashboard/src/pages/AgentsPage.jsx +191 -0
  139. package/dashboard/src/pages/ConfigPage.jsx +298 -0
  140. package/dashboard/src/pages/HooksPage.jsx +412 -0
  141. package/dashboard/src/pages/LiveFeed.jsx +274 -0
  142. package/dashboard/src/pages/MemoryPage.jsx +107 -0
  143. package/dashboard/src/pages/Overview.jsx +360 -0
  144. package/dashboard/src/pages/PhaseDetailView.jsx +216 -0
  145. package/dashboard/src/pages/PlanningPage.jsx +181 -0
  146. package/dashboard/src/pages/RoadmapPage.jsx +251 -0
  147. package/dashboard/src/pages/Telemetry.jsx +113 -0
  148. package/dashboard/src/pages/planning/DecisionsTab.jsx +153 -0
  149. package/dashboard/src/pages/planning/FilesTab.jsx +420 -0
  150. package/dashboard/src/pages/planning/MilestoneDetail.jsx +319 -0
  151. package/dashboard/src/pages/planning/MilestonesTab.jsx +151 -0
  152. package/dashboard/src/pages/planning/NotesTab.jsx +251 -0
  153. package/dashboard/src/pages/planning/PhasesTab.jsx +218 -0
  154. package/dashboard/src/pages/planning/QuickTab.jsx +50 -0
  155. package/dashboard/src/pages/planning/ResearchTab.jsx +103 -0
  156. package/dashboard/src/pages/planning/TodosTab.jsx +297 -0
  157. package/dashboard/src/theme/ThemeProvider.jsx +38 -0
  158. package/dashboard/src/theme/tokens.js +17 -0
  159. package/dashboard/tests/components/ConfirmModal.test.jsx +179 -0
  160. package/dashboard/tests/components/ConnectionBanner.test.jsx +37 -0
  161. package/dashboard/tests/components/ErrorBoundary.test.jsx +59 -0
  162. package/dashboard/tests/components/LoadingSkeleton.test.jsx +46 -0
  163. package/dashboard/tests/components/ToastContainer.test.jsx +47 -0
  164. package/dashboard/tests/components/Toggle.test.jsx +61 -0
  165. package/dashboard/tests/hooks/useFetch.test.jsx +77 -0
  166. package/dashboard/tests/hooks/useToast.test.jsx +78 -0
  167. package/dashboard/tests/hooks/useWebSocket.test.jsx +128 -0
  168. package/dashboard/tests/pages/ConfigPage.test.jsx +199 -0
  169. package/dashboard/tests/pages/PlanningPage.test.jsx +119 -0
  170. package/dashboard/tests/pages/planning/FilesTab.test.jsx +198 -0
  171. package/dashboard/tests/pages/planning/NotesTab.test.jsx +178 -0
  172. package/dashboard/tests/pages/planning/TodosTab.test.jsx +188 -0
  173. package/dashboard/tests/performance.test.jsx +46 -0
  174. package/dashboard/tests/routes/config.test.js +98 -0
  175. package/dashboard/tests/routes/health.test.js +40 -0
  176. package/dashboard/tests/routes/planning.test.js +112 -0
  177. package/dashboard/tests/routes/roadmap.test.js +91 -0
  178. package/dashboard/tests/routes/status.test.js +131 -0
  179. package/dashboard/tests/server/planning-reader.test.js +153 -0
  180. package/dashboard/tests/setup.js +7 -0
  181. package/dashboard/vite.config.js +41 -0
  182. package/hooks/dist/auto-continue.js +201 -0
  183. package/hooks/dist/block-skill-self-read.js +77 -0
  184. package/hooks/dist/branding-audit.js +232 -0
  185. package/hooks/dist/check-agent-state-write.js +63 -0
  186. package/hooks/dist/check-config-change.js +188 -0
  187. package/hooks/dist/check-dangerous-commands.js +184 -0
  188. package/hooks/dist/check-doc-sprawl.js +102 -0
  189. package/hooks/dist/check-phase-boundary.js +190 -0
  190. package/hooks/dist/check-plan-format.js +654 -0
  191. package/hooks/dist/check-roadmap-sync.js +491 -0
  192. package/hooks/dist/check-skill-workflow.js +353 -0
  193. package/hooks/dist/check-state-sync.js +612 -0
  194. package/hooks/dist/check-subagent-output.js +754 -0
  195. package/hooks/dist/check-summary-gate.js +198 -0
  196. package/hooks/dist/context-bridge.js +342 -0
  197. package/hooks/dist/context-budget-check.js +441 -0
  198. package/hooks/dist/enforce-pbr-workflow.js +277 -0
  199. package/hooks/dist/event-handler.js +217 -0
  200. package/hooks/dist/event-logger.js +92 -0
  201. package/hooks/dist/hook-logger.js +80 -0
  202. package/hooks/dist/hook-server-client.js +341 -0
  203. package/hooks/dist/hook-server.js +336 -0
  204. package/hooks/dist/hooks-schema.json +85 -0
  205. package/hooks/dist/hooks.json +288 -0
  206. package/hooks/dist/instructions-loaded.js +107 -0
  207. package/hooks/dist/intercept-plan-mode.js +48 -0
  208. package/hooks/dist/log-notification.js +87 -0
  209. package/hooks/dist/log-subagent.js +303 -0
  210. package/hooks/dist/log-tool-failure.js +140 -0
  211. package/hooks/dist/milestone-learnings.js +290 -0
  212. package/hooks/dist/post-bash-triage.js +151 -0
  213. package/hooks/dist/post-write-dispatch.js +227 -0
  214. package/hooks/dist/post-write-quality.js +207 -0
  215. package/hooks/dist/pre-bash-dispatch.js +137 -0
  216. package/hooks/dist/pre-write-dispatch.js +156 -0
  217. package/hooks/dist/progress-tracker.js +742 -0
  218. package/hooks/dist/prompt-routing.js +152 -0
  219. package/hooks/dist/run-hook.js +144 -0
  220. package/hooks/dist/session-cleanup.js +455 -0
  221. package/hooks/dist/session-tracker.js +78 -0
  222. package/hooks/dist/status-line.js +471 -0
  223. package/hooks/dist/suggest-compact.js +220 -0
  224. package/hooks/dist/sync-context-to-claude.js +100 -0
  225. package/hooks/dist/task-completed.js +167 -0
  226. package/hooks/dist/track-context-budget.js +317 -0
  227. package/hooks/dist/validate-commit.js +265 -0
  228. package/hooks/dist/validate-plugin-structure.js +193 -0
  229. package/hooks/dist/validate-skill-args.js +219 -0
  230. package/hooks/dist/validate-task.js +256 -0
  231. package/hooks/dist/worktree-create.js +144 -0
  232. package/hooks/dist/worktree-remove.js +147 -0
  233. package/package.json +53 -40
  234. package/plan-build-run/bin/config-schema.json +406 -0
  235. package/plan-build-run/bin/dashboard-launch.cjs +114 -0
  236. package/plan-build-run/bin/event-logger.cjs +92 -0
  237. package/plan-build-run/bin/lib/alternatives.cjs +198 -0
  238. package/plan-build-run/bin/lib/build.cjs +717 -0
  239. package/plan-build-run/bin/lib/circuit-state.cjs +133 -0
  240. package/plan-build-run/bin/lib/commands.cjs +482 -0
  241. package/plan-build-run/bin/lib/config.cjs +681 -0
  242. package/plan-build-run/bin/lib/context.cjs +216 -0
  243. package/plan-build-run/bin/lib/core.cjs +1548 -0
  244. package/plan-build-run/bin/lib/frontmatter.cjs +299 -0
  245. package/plan-build-run/bin/lib/gates/advisories.cjs +129 -0
  246. package/plan-build-run/bin/lib/gates/build-dependency.cjs +100 -0
  247. package/plan-build-run/bin/lib/gates/build-executor.cjs +79 -0
  248. package/plan-build-run/bin/lib/gates/doc-existence.cjs +46 -0
  249. package/plan-build-run/bin/lib/gates/helpers.cjs +74 -0
  250. package/plan-build-run/bin/lib/gates/milestone-complete.cjs +120 -0
  251. package/plan-build-run/bin/lib/gates/plan-executor.cjs +36 -0
  252. package/plan-build-run/bin/lib/gates/quick-executor.cjs +76 -0
  253. package/plan-build-run/bin/lib/gates/review-planner.cjs +61 -0
  254. package/plan-build-run/bin/lib/gates/review-verifier.cjs +69 -0
  255. package/plan-build-run/bin/lib/history.cjs +147 -0
  256. package/plan-build-run/bin/lib/init.cjs +304 -0
  257. package/plan-build-run/bin/lib/learnings.cjs +312 -0
  258. package/plan-build-run/bin/lib/local-llm/health.cjs +12 -0
  259. package/plan-build-run/bin/lib/local-llm/index.cjs +89 -0
  260. package/plan-build-run/bin/lib/local-llm/metrics.cjs +20 -0
  261. package/plan-build-run/bin/lib/local-llm/operations/classify-artifact.cjs +4 -0
  262. package/plan-build-run/bin/lib/local-llm/operations/classify-commit.cjs +4 -0
  263. package/plan-build-run/bin/lib/local-llm/operations/classify-error.cjs +4 -0
  264. package/plan-build-run/bin/lib/local-llm/operations/classify-file-intent.cjs +4 -0
  265. package/plan-build-run/bin/lib/local-llm/operations/triage-test-output.cjs +12 -0
  266. package/plan-build-run/bin/lib/local-llm/operations/validate-task.cjs +4 -0
  267. package/plan-build-run/bin/lib/migrate.cjs +248 -0
  268. package/plan-build-run/bin/lib/milestone.cjs +245 -0
  269. package/plan-build-run/bin/lib/phase.cjs +1021 -0
  270. package/plan-build-run/bin/lib/preview.cjs +174 -0
  271. package/plan-build-run/bin/lib/reference.cjs +234 -0
  272. package/plan-build-run/bin/lib/roadmap.cjs +909 -0
  273. package/plan-build-run/bin/lib/skill-section.cjs +98 -0
  274. package/plan-build-run/bin/lib/spot-check.cjs +116 -0
  275. package/plan-build-run/bin/lib/state.cjs +641 -0
  276. package/plan-build-run/bin/lib/step-verify.cjs +149 -0
  277. package/plan-build-run/bin/lib/template.cjs +222 -0
  278. package/plan-build-run/bin/lib/todo.cjs +300 -0
  279. package/plan-build-run/bin/lib/verify.cjs +820 -0
  280. package/plan-build-run/bin/pbr-tools.cjs +1287 -0
  281. package/plan-build-run/references/CLAUDE.md +7 -0
  282. package/plan-build-run/references/agent-contracts.md +324 -0
  283. package/plan-build-run/references/agent-teams.md +54 -0
  284. package/plan-build-run/references/behavioral-contexts.md +53 -0
  285. package/plan-build-run/references/checkpoints.md +776 -0
  286. package/plan-build-run/references/config-reference.md +363 -0
  287. package/plan-build-run/references/continuation-format.md +249 -0
  288. package/plan-build-run/references/debugging/CLAUDE.md +7 -0
  289. package/plan-build-run/references/decimal-phase-calculation.md +65 -0
  290. package/plan-build-run/references/git-integration.md +248 -0
  291. package/plan-build-run/references/git-planning-commit.md +38 -0
  292. package/plan-build-run/references/model-profile-resolution.md +34 -0
  293. package/plan-build-run/references/model-profiles.md +92 -0
  294. package/plan-build-run/references/model-selection.md +53 -0
  295. package/plan-build-run/references/phase-argument-parsing.md +61 -0
  296. package/plan-build-run/references/plan-authoring.md +246 -0
  297. package/plan-build-run/references/plan-format.md +351 -0
  298. package/plan-build-run/references/planning-config.md +200 -0
  299. package/plan-build-run/references/questioning.md +162 -0
  300. package/plan-build-run/references/reading-verification.md +93 -0
  301. package/plan-build-run/references/stub-patterns.md +160 -0
  302. package/plan-build-run/references/tdd.md +263 -0
  303. package/plan-build-run/references/ui-brand.md +187 -0
  304. package/plan-build-run/references/verification-overrides.md +38 -0
  305. package/plan-build-run/references/verification-patterns.md +612 -0
  306. package/plan-build-run/references/wave-execution.md +52 -0
  307. package/plan-build-run/skills/audit/SKILL.md +348 -0
  308. package/plan-build-run/skills/begin/SKILL.md +891 -0
  309. package/plan-build-run/skills/begin/templates/PROJECT.md.tmpl +33 -0
  310. package/plan-build-run/skills/begin/templates/REQUIREMENTS.md.tmpl +18 -0
  311. package/plan-build-run/skills/begin/templates/STATE.md.tmpl +48 -0
  312. package/plan-build-run/skills/begin/templates/config.json.tmpl +69 -0
  313. package/plan-build-run/skills/begin/templates/project-CONTEXT.md.tmpl +19 -0
  314. package/plan-build-run/skills/begin/templates/researcher-prompt.md.tmpl +47 -0
  315. package/plan-build-run/skills/begin/templates/roadmap-prompt.md.tmpl +49 -0
  316. package/plan-build-run/skills/begin/templates/synthesis-prompt.md.tmpl +44 -0
  317. package/plan-build-run/skills/build/SKILL.md +1007 -0
  318. package/plan-build-run/skills/build/templates/continuation-prompt.md.tmpl +26 -0
  319. package/plan-build-run/skills/build/templates/executor-prompt.md.tmpl +70 -0
  320. package/plan-build-run/skills/build/templates/inline-verifier-prompt.md.tmpl +33 -0
  321. package/plan-build-run/skills/config/SKILL.md +342 -0
  322. package/plan-build-run/skills/continue/SKILL.md +190 -0
  323. package/plan-build-run/skills/dashboard/SKILL.md +12 -0
  324. package/plan-build-run/skills/debug/SKILL.md +539 -0
  325. package/plan-build-run/skills/debug/templates/continuation-prompt.md.tmpl +27 -0
  326. package/plan-build-run/skills/debug/templates/initial-investigation-prompt.md.tmpl +34 -0
  327. package/plan-build-run/skills/discuss/SKILL.md +440 -0
  328. package/plan-build-run/skills/discuss/templates/CONTEXT.md.tmpl +61 -0
  329. package/plan-build-run/skills/discuss/templates/decision-categories.md +9 -0
  330. package/plan-build-run/skills/discuss/templates/project-CONTEXT.md.tmpl +19 -0
  331. package/plan-build-run/skills/do/SKILL.md +70 -0
  332. package/plan-build-run/skills/explore/SKILL.md +443 -0
  333. package/plan-build-run/skills/health/SKILL.md +332 -0
  334. package/plan-build-run/skills/health/templates/check-pattern.md.tmpl +30 -0
  335. package/plan-build-run/skills/health/templates/output-format.md.tmpl +63 -0
  336. package/plan-build-run/skills/help/SKILL.md +236 -0
  337. package/plan-build-run/skills/import/SKILL.md +816 -0
  338. package/plan-build-run/skills/milestone/SKILL.md +659 -0
  339. package/plan-build-run/skills/milestone/templates/audit-output.md.tmpl +76 -0
  340. package/plan-build-run/skills/milestone/templates/audit-report.md.tmpl +48 -0
  341. package/plan-build-run/skills/milestone/templates/complete-output.md.tmpl +32 -0
  342. package/plan-build-run/skills/milestone/templates/edge-cases.md +54 -0
  343. package/plan-build-run/skills/milestone/templates/gaps-output.md.tmpl +25 -0
  344. package/plan-build-run/skills/milestone/templates/integration-checker-prompt.md.tmpl +25 -0
  345. package/plan-build-run/skills/milestone/templates/new-output.md.tmpl +29 -0
  346. package/plan-build-run/skills/milestone/templates/stats-file.md.tmpl +30 -0
  347. package/plan-build-run/skills/note/SKILL.md +221 -0
  348. package/plan-build-run/skills/pause/SKILL.md +259 -0
  349. package/plan-build-run/skills/pause/templates/continue-here.md.tmpl +71 -0
  350. package/plan-build-run/skills/plan/SKILL.md +700 -0
  351. package/plan-build-run/skills/plan/decimal-phase-calc.md +98 -0
  352. package/plan-build-run/skills/plan/templates/checker-prompt.md.tmpl +21 -0
  353. package/plan-build-run/skills/plan/templates/completion-output.md.tmpl +27 -0
  354. package/plan-build-run/skills/plan/templates/gap-closure-prompt.md.tmpl +32 -0
  355. package/plan-build-run/skills/plan/templates/planner-prompt.md.tmpl +38 -0
  356. package/plan-build-run/skills/plan/templates/prompt-partials/phase-project-context.md.tmpl +21 -0
  357. package/plan-build-run/skills/plan/templates/researcher-prompt.md.tmpl +19 -0
  358. package/plan-build-run/skills/plan/templates/revision-prompt.md.tmpl +23 -0
  359. package/plan-build-run/skills/profile/SKILL.md +173 -0
  360. package/plan-build-run/skills/quick/SKILL.md +440 -0
  361. package/plan-build-run/skills/resume/SKILL.md +404 -0
  362. package/plan-build-run/skills/review/SKILL.md +711 -0
  363. package/plan-build-run/skills/review/templates/debugger-prompt.md.tmpl +60 -0
  364. package/plan-build-run/skills/review/templates/gap-planner-prompt.md.tmpl +40 -0
  365. package/plan-build-run/skills/review/templates/verifier-prompt.md.tmpl +115 -0
  366. package/plan-build-run/skills/scan/SKILL.md +326 -0
  367. package/plan-build-run/skills/scan/templates/mapper-prompt.md.tmpl +201 -0
  368. package/plan-build-run/skills/setup/SKILL.md +236 -0
  369. package/plan-build-run/skills/shared/commit-planning-docs.md +43 -0
  370. package/plan-build-run/skills/shared/config-loading.md +102 -0
  371. package/plan-build-run/skills/shared/context-budget.md +92 -0
  372. package/plan-build-run/skills/shared/context-loader-task.md +93 -0
  373. package/plan-build-run/skills/shared/digest-select.md +79 -0
  374. package/plan-build-run/skills/shared/domain-probes.md +125 -0
  375. package/plan-build-run/skills/shared/error-reporting.md +67 -0
  376. package/plan-build-run/skills/shared/gate-prompts.md +390 -0
  377. package/plan-build-run/skills/shared/phase-argument-parsing.md +45 -0
  378. package/plan-build-run/skills/shared/revision-loop.md +81 -0
  379. package/plan-build-run/skills/shared/state-update.md +153 -0
  380. package/plan-build-run/skills/shared/universal-anti-patterns.md +59 -0
  381. package/plan-build-run/skills/status/SKILL.md +485 -0
  382. package/plan-build-run/skills/statusline/SKILL.md +151 -0
  383. package/plan-build-run/skills/test/SKILL.md +212 -0
  384. package/plan-build-run/skills/todo/SKILL.md +301 -0
  385. package/plan-build-run/skills/undo/SKILL.md +216 -0
  386. package/plan-build-run/templates/CLAUDE.md +7 -0
  387. package/plan-build-run/templates/DEBUG.md +164 -0
  388. package/plan-build-run/templates/UAT.md +247 -0
  389. package/plan-build-run/templates/VALIDATION.md +76 -0
  390. package/plan-build-run/templates/codebase/architecture.md +255 -0
  391. package/plan-build-run/templates/codebase/concerns.md +310 -0
  392. package/plan-build-run/templates/codebase/conventions.md +307 -0
  393. package/plan-build-run/templates/codebase/integrations.md +280 -0
  394. package/plan-build-run/templates/codebase/stack.md +186 -0
  395. package/plan-build-run/templates/codebase/structure.md +285 -0
  396. package/plan-build-run/templates/codebase/testing.md +480 -0
  397. package/plan-build-run/templates/config.json +37 -0
  398. package/plan-build-run/templates/context.md +297 -0
  399. package/plan-build-run/templates/continue-here.md +78 -0
  400. package/plan-build-run/templates/crud-flow-verification.md +277 -0
  401. package/plan-build-run/templates/debug-subagent-prompt.md +91 -0
  402. package/plan-build-run/templates/deferred-items.md +19 -0
  403. package/plan-build-run/templates/discovery.md +146 -0
  404. package/plan-build-run/templates/milestone-archive.md +123 -0
  405. package/plan-build-run/templates/milestone.md +115 -0
  406. package/plan-build-run/templates/phase-prompt.md +569 -0
  407. package/plan-build-run/templates/planner-subagent-prompt.md +117 -0
  408. package/plan-build-run/templates/project.md +184 -0
  409. package/plan-build-run/templates/requirements.md +231 -0
  410. package/plan-build-run/templates/research-outputs/ARCHITECTURE.md.tmpl +86 -0
  411. package/plan-build-run/templates/research-outputs/FEATURES.md.tmpl +77 -0
  412. package/plan-build-run/templates/research-outputs/PITFALLS.md.tmpl +65 -0
  413. package/plan-build-run/templates/research-outputs/STACK.md.tmpl +80 -0
  414. package/plan-build-run/templates/research-project/ARCHITECTURE.md +204 -0
  415. package/plan-build-run/templates/research-project/FEATURES.md +147 -0
  416. package/plan-build-run/templates/research-project/PITFALLS.md +200 -0
  417. package/plan-build-run/templates/research-project/STACK.md +120 -0
  418. package/plan-build-run/templates/research-project/SUMMARY.md +170 -0
  419. package/plan-build-run/templates/research.md +552 -0
  420. package/plan-build-run/templates/retrospective.md +54 -0
  421. package/plan-build-run/templates/roadmap.md +202 -0
  422. package/plan-build-run/templates/seed.md +16 -0
  423. package/plan-build-run/templates/state.md +176 -0
  424. package/plan-build-run/templates/summary-complex.md +59 -0
  425. package/plan-build-run/templates/summary-minimal.md +41 -0
  426. package/plan-build-run/templates/summary-standard.md +48 -0
  427. package/plan-build-run/templates/summary.md +248 -0
  428. package/plan-build-run/templates/user-setup.md +311 -0
  429. package/plan-build-run/templates/verification-report.md +322 -0
  430. package/plan-build-run/workflows/add-phase.md +111 -0
  431. package/plan-build-run/workflows/add-todo.md +157 -0
  432. package/plan-build-run/workflows/audit-milestone.md +241 -0
  433. package/plan-build-run/workflows/check-todos.md +176 -0
  434. package/plan-build-run/workflows/complete-milestone.md +644 -0
  435. package/plan-build-run/workflows/diagnose-issues.md +219 -0
  436. package/plan-build-run/workflows/discovery-phase.md +289 -0
  437. package/plan-build-run/workflows/discuss-phase.md +429 -0
  438. package/plan-build-run/workflows/execute-phase.md +439 -0
  439. package/plan-build-run/workflows/execute-plan.md +437 -0
  440. package/plan-build-run/workflows/explore.md +150 -0
  441. package/plan-build-run/workflows/help.md +470 -0
  442. package/plan-build-run/workflows/insert-phase.md +129 -0
  443. package/plan-build-run/workflows/list-phase-assumptions.md +178 -0
  444. package/plan-build-run/workflows/map-codebase.md +327 -0
  445. package/plan-build-run/workflows/new-milestone.md +373 -0
  446. package/plan-build-run/workflows/new-project.md +1009 -0
  447. package/plan-build-run/workflows/note.md +90 -0
  448. package/plan-build-run/workflows/pause-work.md +122 -0
  449. package/plan-build-run/workflows/plan-milestone-gaps.md +256 -0
  450. package/plan-build-run/workflows/plan-phase.md +376 -0
  451. package/plan-build-run/workflows/progress.md +431 -0
  452. package/plan-build-run/workflows/quick.md +230 -0
  453. package/plan-build-run/workflows/remove-phase.md +154 -0
  454. package/plan-build-run/workflows/research-phase.md +74 -0
  455. package/plan-build-run/workflows/resume-project.md +306 -0
  456. package/plan-build-run/workflows/set-profile.md +80 -0
  457. package/plan-build-run/workflows/settings.md +145 -0
  458. package/plan-build-run/workflows/transition.md +539 -0
  459. package/plan-build-run/workflows/update.md +212 -0
  460. package/plan-build-run/workflows/verify-phase.md +226 -0
  461. package/plan-build-run/workflows/verify-work.md +465 -0
  462. package/plugins/codex-pbr/.codex/config.toml +101 -0
  463. package/plugins/codex-pbr/AGENTS.md +653 -0
  464. package/plugins/codex-pbr/README.md +116 -0
  465. package/plugins/codex-pbr/agents/audit.md +240 -0
  466. package/plugins/codex-pbr/agents/codebase-mapper.md +225 -0
  467. package/plugins/codex-pbr/agents/debugger.md +300 -0
  468. package/plugins/codex-pbr/agents/dev-sync.md +198 -0
  469. package/plugins/codex-pbr/agents/executor.md +549 -0
  470. package/plugins/codex-pbr/agents/general.md +151 -0
  471. package/plugins/codex-pbr/agents/integration-checker.md +230 -0
  472. package/plugins/codex-pbr/agents/nyquist-auditor.md +244 -0
  473. package/plugins/codex-pbr/agents/plan-checker.md +306 -0
  474. package/plugins/codex-pbr/agents/planner.md +464 -0
  475. package/plugins/codex-pbr/agents/researcher.md +304 -0
  476. package/plugins/codex-pbr/agents/roadmapper.md +339 -0
  477. package/plugins/codex-pbr/agents/synthesizer.md +267 -0
  478. package/plugins/codex-pbr/agents/verifier.md +488 -0
  479. package/plugins/codex-pbr/commands/add-phase.md +75 -0
  480. package/plugins/codex-pbr/commands/add-todo.md +8 -0
  481. package/plugins/codex-pbr/commands/audit-milestone.md +8 -0
  482. package/plugins/codex-pbr/commands/audit.md +5 -0
  483. package/plugins/codex-pbr/commands/check-todos.md +8 -0
  484. package/plugins/codex-pbr/commands/complete-milestone.md +8 -0
  485. package/plugins/codex-pbr/commands/config.md +5 -0
  486. package/plugins/codex-pbr/commands/continue.md +5 -0
  487. package/plugins/codex-pbr/commands/dashboard.md +5 -0
  488. package/plugins/codex-pbr/commands/debug.md +5 -0
  489. package/plugins/codex-pbr/commands/discuss-phase.md +6 -0
  490. package/plugins/codex-pbr/commands/do.md +5 -0
  491. package/plugins/codex-pbr/commands/execute-phase.md +6 -0
  492. package/plugins/codex-pbr/commands/explore.md +5 -0
  493. package/plugins/codex-pbr/commands/health.md +5 -0
  494. package/plugins/codex-pbr/commands/help.md +5 -0
  495. package/plugins/codex-pbr/commands/import.md +5 -0
  496. package/plugins/codex-pbr/commands/insert-phase.md +65 -0
  497. package/plugins/codex-pbr/commands/join-discord.md +11 -0
  498. package/plugins/codex-pbr/commands/list-phase-assumptions.md +69 -0
  499. package/plugins/codex-pbr/commands/map-codebase.md +6 -0
  500. package/plugins/codex-pbr/commands/new-milestone.md +8 -0
  501. package/plugins/codex-pbr/commands/new-project.md +6 -0
  502. package/plugins/codex-pbr/commands/note.md +5 -0
  503. package/plugins/codex-pbr/commands/pause-work.md +5 -0
  504. package/plugins/codex-pbr/commands/plan-milestone-gaps.md +7 -0
  505. package/plugins/codex-pbr/commands/plan-phase.md +6 -0
  506. package/plugins/codex-pbr/commands/progress.md +6 -0
  507. package/plugins/codex-pbr/commands/quick.md +5 -0
  508. package/plugins/codex-pbr/commands/reapply-patches.md +40 -0
  509. package/plugins/codex-pbr/commands/remove-phase.md +66 -0
  510. package/plugins/codex-pbr/commands/research-phase.md +59 -0
  511. package/plugins/codex-pbr/commands/resume-work.md +5 -0
  512. package/plugins/codex-pbr/commands/set-profile.md +6 -0
  513. package/plugins/codex-pbr/commands/settings.md +5 -0
  514. package/plugins/codex-pbr/commands/setup.md +5 -0
  515. package/plugins/codex-pbr/commands/statusline.md +5 -0
  516. package/plugins/codex-pbr/commands/test.md +5 -0
  517. package/plugins/codex-pbr/commands/undo.md +5 -0
  518. package/plugins/codex-pbr/commands/update.md +37 -0
  519. package/plugins/codex-pbr/commands/verify-work.md +6 -0
  520. package/plugins/codex-pbr/references/agent-contracts.md +324 -0
  521. package/plugins/codex-pbr/references/agent-teams.md +54 -0
  522. package/plugins/codex-pbr/references/common-bug-patterns.md +13 -0
  523. package/plugins/codex-pbr/references/config-reference.md +587 -0
  524. package/plugins/codex-pbr/references/continuation-format.md +212 -0
  525. package/plugins/codex-pbr/references/deviation-rules.md +112 -0
  526. package/plugins/codex-pbr/references/git-integration.md +284 -0
  527. package/plugins/codex-pbr/references/integration-patterns.md +117 -0
  528. package/plugins/codex-pbr/references/model-profiles.md +143 -0
  529. package/plugins/codex-pbr/references/model-selection.md +31 -0
  530. package/plugins/codex-pbr/references/pbr-tools-cli.md +400 -0
  531. package/plugins/codex-pbr/references/plan-authoring.md +246 -0
  532. package/plugins/codex-pbr/references/plan-format.md +351 -0
  533. package/plugins/codex-pbr/references/questioning.md +303 -0
  534. package/plugins/codex-pbr/references/reading-verification.md +127 -0
  535. package/plugins/codex-pbr/references/signal-files.md +41 -0
  536. package/plugins/codex-pbr/references/stub-patterns.md +160 -0
  537. package/plugins/codex-pbr/references/tmux-setup.md +286 -0
  538. package/plugins/codex-pbr/references/ui-formatting.md +449 -0
  539. package/plugins/codex-pbr/references/wave-execution.md +95 -0
  540. package/plugins/codex-pbr/skills/audit/SKILL.md +346 -0
  541. package/plugins/codex-pbr/skills/begin/SKILL.md +886 -0
  542. package/plugins/codex-pbr/skills/build/SKILL.md +992 -0
  543. package/plugins/codex-pbr/skills/config/SKILL.md +341 -0
  544. package/plugins/codex-pbr/skills/continue/SKILL.md +172 -0
  545. package/plugins/codex-pbr/skills/dashboard/SKILL.md +56 -0
  546. package/plugins/codex-pbr/skills/debug/SKILL.md +537 -0
  547. package/plugins/codex-pbr/skills/discuss/SKILL.md +438 -0
  548. package/plugins/codex-pbr/skills/do/SKILL.md +68 -0
  549. package/plugins/codex-pbr/skills/explore/SKILL.md +441 -0
  550. package/plugins/codex-pbr/skills/health/SKILL.md +330 -0
  551. package/plugins/codex-pbr/skills/help/SKILL.md +231 -0
  552. package/plugins/codex-pbr/skills/import/SKILL.md +814 -0
  553. package/plugins/codex-pbr/skills/milestone/SKILL.md +637 -0
  554. package/plugins/codex-pbr/skills/note/SKILL.md +219 -0
  555. package/plugins/codex-pbr/skills/pause/SKILL.md +258 -0
  556. package/plugins/codex-pbr/skills/plan/SKILL.md +689 -0
  557. package/plugins/codex-pbr/skills/profile/SKILL.md +171 -0
  558. package/plugins/codex-pbr/skills/quick/SKILL.md +437 -0
  559. package/plugins/codex-pbr/skills/resume/SKILL.md +403 -0
  560. package/plugins/codex-pbr/skills/review/SKILL.md +693 -0
  561. package/plugins/codex-pbr/skills/scan/SKILL.md +325 -0
  562. package/plugins/codex-pbr/skills/setup/SKILL.md +235 -0
  563. package/plugins/codex-pbr/skills/shared/commit-planning-docs.md +43 -0
  564. package/plugins/codex-pbr/skills/shared/config-loading.md +102 -0
  565. package/plugins/codex-pbr/skills/shared/context-budget.md +92 -0
  566. package/plugins/codex-pbr/skills/shared/context-loader-task.md +93 -0
  567. package/plugins/codex-pbr/skills/shared/digest-select.md +79 -0
  568. package/plugins/codex-pbr/skills/shared/domain-probes.md +125 -0
  569. package/plugins/codex-pbr/skills/shared/error-reporting.md +59 -0
  570. package/plugins/codex-pbr/skills/shared/gate-prompts.md +390 -0
  571. package/plugins/codex-pbr/skills/shared/phase-argument-parsing.md +45 -0
  572. package/plugins/codex-pbr/skills/shared/revision-loop.md +81 -0
  573. package/plugins/codex-pbr/skills/shared/state-update.md +153 -0
  574. package/plugins/codex-pbr/skills/shared/universal-anti-patterns.md +59 -0
  575. package/plugins/codex-pbr/skills/status/SKILL.md +484 -0
  576. package/plugins/codex-pbr/skills/statusline/SKILL.md +149 -0
  577. package/plugins/codex-pbr/skills/test/SKILL.md +210 -0
  578. package/plugins/codex-pbr/skills/todo/SKILL.md +281 -0
  579. package/plugins/codex-pbr/skills/undo/SKILL.md +214 -0
  580. package/plugins/codex-pbr/templates/CONTEXT.md.tmpl +52 -0
  581. package/plugins/codex-pbr/templates/INTEGRATION-REPORT.md.tmpl +167 -0
  582. package/plugins/codex-pbr/templates/PROJECT.md.tmpl +111 -0
  583. package/plugins/codex-pbr/templates/REQUIREMENTS.md.tmpl +96 -0
  584. package/plugins/codex-pbr/templates/ROADMAP.md.tmpl +105 -0
  585. package/plugins/codex-pbr/templates/SUMMARY-complex.md.tmpl +112 -0
  586. package/plugins/codex-pbr/templates/SUMMARY-minimal.md.tmpl +48 -0
  587. package/plugins/codex-pbr/templates/SUMMARY.md.tmpl +81 -0
  588. package/plugins/codex-pbr/templates/VERIFICATION-DETAIL.md.tmpl +119 -0
  589. package/plugins/codex-pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -0
  590. package/plugins/codex-pbr/templates/codebase/CONCERNS.md.tmpl +93 -0
  591. package/plugins/codex-pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -0
  592. package/plugins/codex-pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -0
  593. package/plugins/codex-pbr/templates/codebase/STACK.md.tmpl +78 -0
  594. package/plugins/codex-pbr/templates/codebase/STRUCTURE.md.tmpl +80 -0
  595. package/plugins/codex-pbr/templates/codebase/TESTING.md.tmpl +107 -0
  596. package/plugins/codex-pbr/templates/continue-here.md.tmpl +73 -0
  597. package/plugins/codex-pbr/templates/pr-body.md.tmpl +22 -0
  598. package/plugins/codex-pbr/templates/project-CONTEXT.md.tmpl +43 -0
  599. package/plugins/codex-pbr/templates/prompt-partials/phase-project-context.md.tmpl +37 -0
  600. package/plugins/codex-pbr/templates/research-outputs/ARCHITECTURE.md.tmpl +91 -0
  601. package/plugins/codex-pbr/templates/research-outputs/FEATURES.md.tmpl +64 -0
  602. package/plugins/codex-pbr/templates/research-outputs/PITFALLS.md.tmpl +50 -0
  603. package/plugins/codex-pbr/templates/research-outputs/STACK.md.tmpl +63 -0
  604. package/plugins/codex-pbr/templates/research-outputs/SUMMARY.md.tmpl +98 -0
  605. package/plugins/copilot-pbr/CHANGELOG.md +19 -0
  606. package/plugins/copilot-pbr/README.md +139 -0
  607. package/plugins/copilot-pbr/agents/audit.agent.md +240 -0
  608. package/plugins/copilot-pbr/agents/codebase-mapper.agent.md +225 -0
  609. package/plugins/copilot-pbr/agents/debugger.agent.md +300 -0
  610. package/plugins/copilot-pbr/agents/dev-sync.agent.md +198 -0
  611. package/plugins/copilot-pbr/agents/executor.agent.md +549 -0
  612. package/plugins/copilot-pbr/agents/general.agent.md +151 -0
  613. package/plugins/copilot-pbr/agents/integration-checker.agent.md +230 -0
  614. package/plugins/copilot-pbr/agents/nyquist-auditor.agent.md +244 -0
  615. package/plugins/copilot-pbr/agents/plan-checker.agent.md +306 -0
  616. package/plugins/copilot-pbr/agents/planner.agent.md +464 -0
  617. package/plugins/copilot-pbr/agents/researcher.agent.md +304 -0
  618. package/plugins/copilot-pbr/agents/roadmapper.agent.md +339 -0
  619. package/plugins/copilot-pbr/agents/synthesizer.agent.md +267 -0
  620. package/plugins/copilot-pbr/agents/verifier.agent.md +488 -0
  621. package/plugins/copilot-pbr/commands/add-phase.md +75 -0
  622. package/plugins/copilot-pbr/commands/add-todo.md +8 -0
  623. package/plugins/copilot-pbr/commands/audit-milestone.md +8 -0
  624. package/plugins/copilot-pbr/commands/audit.md +5 -0
  625. package/plugins/copilot-pbr/commands/check-todos.md +8 -0
  626. package/plugins/copilot-pbr/commands/complete-milestone.md +8 -0
  627. package/plugins/copilot-pbr/commands/config.md +5 -0
  628. package/plugins/copilot-pbr/commands/continue.md +5 -0
  629. package/plugins/copilot-pbr/commands/dashboard.md +5 -0
  630. package/plugins/copilot-pbr/commands/debug.md +5 -0
  631. package/plugins/copilot-pbr/commands/discuss-phase.md +6 -0
  632. package/plugins/copilot-pbr/commands/do.md +5 -0
  633. package/plugins/copilot-pbr/commands/execute-phase.md +6 -0
  634. package/plugins/copilot-pbr/commands/explore.md +5 -0
  635. package/plugins/copilot-pbr/commands/health.md +5 -0
  636. package/plugins/copilot-pbr/commands/help.md +5 -0
  637. package/plugins/copilot-pbr/commands/import.md +5 -0
  638. package/plugins/copilot-pbr/commands/insert-phase.md +65 -0
  639. package/plugins/copilot-pbr/commands/join-discord.md +11 -0
  640. package/plugins/copilot-pbr/commands/list-phase-assumptions.md +69 -0
  641. package/plugins/copilot-pbr/commands/map-codebase.md +6 -0
  642. package/plugins/copilot-pbr/commands/new-milestone.md +8 -0
  643. package/plugins/copilot-pbr/commands/new-project.md +6 -0
  644. package/plugins/copilot-pbr/commands/note.md +5 -0
  645. package/plugins/copilot-pbr/commands/pause-work.md +5 -0
  646. package/plugins/copilot-pbr/commands/plan-milestone-gaps.md +7 -0
  647. package/plugins/copilot-pbr/commands/plan-phase.md +6 -0
  648. package/plugins/copilot-pbr/commands/progress.md +6 -0
  649. package/plugins/copilot-pbr/commands/quick.md +5 -0
  650. package/plugins/copilot-pbr/commands/reapply-patches.md +40 -0
  651. package/plugins/copilot-pbr/commands/remove-phase.md +66 -0
  652. package/plugins/copilot-pbr/commands/research-phase.md +59 -0
  653. package/plugins/copilot-pbr/commands/resume-work.md +5 -0
  654. package/plugins/copilot-pbr/commands/set-profile.md +6 -0
  655. package/plugins/copilot-pbr/commands/settings.md +5 -0
  656. package/plugins/copilot-pbr/commands/setup.md +5 -0
  657. package/plugins/copilot-pbr/commands/statusline.md +5 -0
  658. package/plugins/copilot-pbr/commands/test.md +5 -0
  659. package/plugins/copilot-pbr/commands/undo.md +5 -0
  660. package/plugins/copilot-pbr/commands/update.md +37 -0
  661. package/plugins/copilot-pbr/commands/verify-work.md +6 -0
  662. package/plugins/copilot-pbr/hooks/hooks.json +309 -0
  663. package/plugins/copilot-pbr/plugin.json +30 -0
  664. package/plugins/copilot-pbr/references/agent-contracts.md +324 -0
  665. package/plugins/copilot-pbr/references/agent-teams.md +54 -0
  666. package/plugins/copilot-pbr/references/common-bug-patterns.md +13 -0
  667. package/plugins/copilot-pbr/references/config-reference.md +587 -0
  668. package/plugins/copilot-pbr/references/continuation-format.md +212 -0
  669. package/plugins/copilot-pbr/references/deviation-rules.md +112 -0
  670. package/plugins/copilot-pbr/references/git-integration.md +284 -0
  671. package/plugins/copilot-pbr/references/integration-patterns.md +117 -0
  672. package/plugins/copilot-pbr/references/model-profiles.md +143 -0
  673. package/plugins/copilot-pbr/references/model-selection.md +31 -0
  674. package/plugins/copilot-pbr/references/pbr-tools-cli.md +400 -0
  675. package/plugins/copilot-pbr/references/plan-authoring.md +246 -0
  676. package/plugins/copilot-pbr/references/plan-format.md +351 -0
  677. package/plugins/copilot-pbr/references/questioning.md +303 -0
  678. package/plugins/copilot-pbr/references/reading-verification.md +127 -0
  679. package/plugins/copilot-pbr/references/signal-files.md +41 -0
  680. package/plugins/copilot-pbr/references/stub-patterns.md +160 -0
  681. package/plugins/copilot-pbr/references/tmux-setup.md +286 -0
  682. package/plugins/copilot-pbr/references/ui-formatting.md +449 -0
  683. package/plugins/copilot-pbr/references/wave-execution.md +95 -0
  684. package/plugins/copilot-pbr/rules/pbr-workflow.mdc +48 -0
  685. package/plugins/copilot-pbr/setup.ps1 +93 -0
  686. package/plugins/copilot-pbr/setup.sh +93 -0
  687. package/plugins/copilot-pbr/skills/audit/SKILL.md +346 -0
  688. package/plugins/copilot-pbr/skills/begin/SKILL.md +886 -0
  689. package/plugins/copilot-pbr/skills/build/SKILL.md +992 -0
  690. package/plugins/copilot-pbr/skills/config/SKILL.md +341 -0
  691. package/plugins/copilot-pbr/skills/continue/SKILL.md +172 -0
  692. package/plugins/copilot-pbr/skills/dashboard/SKILL.md +56 -0
  693. package/plugins/copilot-pbr/skills/debug/SKILL.md +537 -0
  694. package/plugins/copilot-pbr/skills/discuss/SKILL.md +438 -0
  695. package/plugins/copilot-pbr/skills/do/SKILL.md +68 -0
  696. package/plugins/copilot-pbr/skills/explore/SKILL.md +441 -0
  697. package/plugins/copilot-pbr/skills/health/SKILL.md +330 -0
  698. package/plugins/copilot-pbr/skills/help/SKILL.md +231 -0
  699. package/plugins/copilot-pbr/skills/import/SKILL.md +814 -0
  700. package/plugins/copilot-pbr/skills/milestone/SKILL.md +637 -0
  701. package/plugins/copilot-pbr/skills/note/SKILL.md +219 -0
  702. package/plugins/copilot-pbr/skills/pause/SKILL.md +258 -0
  703. package/plugins/copilot-pbr/skills/plan/SKILL.md +689 -0
  704. package/plugins/copilot-pbr/skills/profile/SKILL.md +171 -0
  705. package/plugins/copilot-pbr/skills/quick/SKILL.md +437 -0
  706. package/plugins/copilot-pbr/skills/resume/SKILL.md +403 -0
  707. package/plugins/copilot-pbr/skills/review/SKILL.md +693 -0
  708. package/plugins/copilot-pbr/skills/scan/SKILL.md +325 -0
  709. package/plugins/copilot-pbr/skills/setup/SKILL.md +235 -0
  710. package/plugins/copilot-pbr/skills/shared/commit-planning-docs.md +43 -0
  711. package/plugins/copilot-pbr/skills/shared/config-loading.md +102 -0
  712. package/plugins/copilot-pbr/skills/shared/context-budget.md +92 -0
  713. package/plugins/copilot-pbr/skills/shared/context-loader-task.md +93 -0
  714. package/plugins/copilot-pbr/skills/shared/digest-select.md +79 -0
  715. package/plugins/copilot-pbr/skills/shared/domain-probes.md +125 -0
  716. package/plugins/copilot-pbr/skills/shared/error-reporting.md +59 -0
  717. package/plugins/copilot-pbr/skills/shared/gate-prompts.md +390 -0
  718. package/plugins/copilot-pbr/skills/shared/phase-argument-parsing.md +45 -0
  719. package/plugins/copilot-pbr/skills/shared/revision-loop.md +81 -0
  720. package/plugins/copilot-pbr/skills/shared/state-update.md +153 -0
  721. package/plugins/copilot-pbr/skills/shared/universal-anti-patterns.md +59 -0
  722. package/plugins/copilot-pbr/skills/status/SKILL.md +484 -0
  723. package/plugins/copilot-pbr/skills/statusline/SKILL.md +149 -0
  724. package/plugins/copilot-pbr/skills/test/SKILL.md +210 -0
  725. package/plugins/copilot-pbr/skills/todo/SKILL.md +281 -0
  726. package/plugins/copilot-pbr/skills/undo/SKILL.md +214 -0
  727. package/plugins/copilot-pbr/templates/CONTEXT.md.tmpl +52 -0
  728. package/plugins/copilot-pbr/templates/INTEGRATION-REPORT.md.tmpl +167 -0
  729. package/plugins/copilot-pbr/templates/PROJECT.md.tmpl +111 -0
  730. package/plugins/copilot-pbr/templates/REQUIREMENTS.md.tmpl +96 -0
  731. package/plugins/copilot-pbr/templates/ROADMAP.md.tmpl +105 -0
  732. package/plugins/copilot-pbr/templates/SUMMARY-complex.md.tmpl +112 -0
  733. package/plugins/copilot-pbr/templates/SUMMARY-minimal.md.tmpl +48 -0
  734. package/plugins/copilot-pbr/templates/SUMMARY.md.tmpl +81 -0
  735. package/plugins/copilot-pbr/templates/VERIFICATION-DETAIL.md.tmpl +119 -0
  736. package/plugins/copilot-pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -0
  737. package/plugins/copilot-pbr/templates/codebase/CONCERNS.md.tmpl +93 -0
  738. package/plugins/copilot-pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -0
  739. package/plugins/copilot-pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -0
  740. package/plugins/copilot-pbr/templates/codebase/STACK.md.tmpl +78 -0
  741. package/plugins/copilot-pbr/templates/codebase/STRUCTURE.md.tmpl +80 -0
  742. package/plugins/copilot-pbr/templates/codebase/TESTING.md.tmpl +107 -0
  743. package/plugins/copilot-pbr/templates/continue-here.md.tmpl +73 -0
  744. package/plugins/copilot-pbr/templates/pr-body.md.tmpl +22 -0
  745. package/plugins/copilot-pbr/templates/project-CONTEXT.md.tmpl +43 -0
  746. package/plugins/copilot-pbr/templates/prompt-partials/phase-project-context.md.tmpl +37 -0
  747. package/plugins/copilot-pbr/templates/research-outputs/ARCHITECTURE.md.tmpl +91 -0
  748. package/plugins/copilot-pbr/templates/research-outputs/FEATURES.md.tmpl +64 -0
  749. package/plugins/copilot-pbr/templates/research-outputs/PITFALLS.md.tmpl +50 -0
  750. package/plugins/copilot-pbr/templates/research-outputs/STACK.md.tmpl +63 -0
  751. package/plugins/copilot-pbr/templates/research-outputs/SUMMARY.md.tmpl +98 -0
  752. package/plugins/cursor-pbr/.cursor-plugin/plugin.json +14 -4
  753. package/plugins/cursor-pbr/CHANGELOG.md +15 -0
  754. package/plugins/cursor-pbr/README.md +143 -0
  755. package/plugins/cursor-pbr/agents/audit.md +242 -0
  756. package/plugins/cursor-pbr/agents/codebase-mapper.md +227 -0
  757. package/plugins/cursor-pbr/agents/debugger.md +302 -0
  758. package/plugins/cursor-pbr/agents/dev-sync.md +200 -0
  759. package/plugins/cursor-pbr/agents/executor.md +551 -0
  760. package/plugins/cursor-pbr/agents/general.md +153 -0
  761. package/plugins/cursor-pbr/agents/integration-checker.md +232 -0
  762. package/plugins/cursor-pbr/agents/nyquist-auditor.md +246 -0
  763. package/plugins/cursor-pbr/agents/plan-checker.md +308 -0
  764. package/plugins/cursor-pbr/agents/planner.md +466 -0
  765. package/plugins/cursor-pbr/agents/researcher.md +306 -0
  766. package/plugins/cursor-pbr/agents/roadmapper.md +341 -0
  767. package/plugins/cursor-pbr/agents/synthesizer.md +269 -0
  768. package/plugins/cursor-pbr/agents/verifier.md +490 -0
  769. package/plugins/cursor-pbr/assets/logo.svg +21 -0
  770. package/plugins/cursor-pbr/commands/add-phase.md +75 -0
  771. package/plugins/cursor-pbr/commands/add-todo.md +8 -0
  772. package/plugins/cursor-pbr/commands/audit-milestone.md +8 -0
  773. package/plugins/cursor-pbr/commands/audit.md +5 -0
  774. package/plugins/cursor-pbr/commands/check-todos.md +8 -0
  775. package/plugins/cursor-pbr/commands/complete-milestone.md +8 -0
  776. package/plugins/cursor-pbr/commands/config.md +5 -0
  777. package/plugins/cursor-pbr/commands/continue.md +5 -0
  778. package/plugins/cursor-pbr/commands/dashboard.md +5 -0
  779. package/plugins/cursor-pbr/commands/debug.md +5 -0
  780. package/plugins/cursor-pbr/commands/discuss-phase.md +6 -0
  781. package/plugins/cursor-pbr/commands/do.md +5 -0
  782. package/plugins/cursor-pbr/commands/execute-phase.md +6 -0
  783. package/plugins/cursor-pbr/commands/explore.md +5 -0
  784. package/plugins/cursor-pbr/commands/health.md +5 -0
  785. package/plugins/cursor-pbr/commands/help.md +5 -0
  786. package/plugins/cursor-pbr/commands/import.md +5 -0
  787. package/plugins/cursor-pbr/commands/insert-phase.md +65 -0
  788. package/plugins/cursor-pbr/commands/join-discord.md +11 -0
  789. package/plugins/cursor-pbr/commands/list-phase-assumptions.md +69 -0
  790. package/plugins/cursor-pbr/commands/map-codebase.md +6 -0
  791. package/plugins/cursor-pbr/commands/new-milestone.md +8 -0
  792. package/plugins/cursor-pbr/commands/new-project.md +6 -0
  793. package/plugins/cursor-pbr/commands/note.md +5 -0
  794. package/plugins/cursor-pbr/commands/pause-work.md +5 -0
  795. package/plugins/cursor-pbr/commands/plan-milestone-gaps.md +7 -0
  796. package/plugins/cursor-pbr/commands/plan-phase.md +6 -0
  797. package/plugins/cursor-pbr/commands/progress.md +6 -0
  798. package/plugins/cursor-pbr/commands/quick.md +5 -0
  799. package/plugins/cursor-pbr/commands/reapply-patches.md +40 -0
  800. package/plugins/cursor-pbr/commands/remove-phase.md +66 -0
  801. package/plugins/cursor-pbr/commands/research-phase.md +59 -0
  802. package/plugins/cursor-pbr/commands/resume-work.md +5 -0
  803. package/plugins/cursor-pbr/commands/set-profile.md +6 -0
  804. package/plugins/cursor-pbr/commands/settings.md +5 -0
  805. package/plugins/cursor-pbr/commands/setup.md +5 -0
  806. package/plugins/cursor-pbr/commands/statusline.md +5 -0
  807. package/plugins/cursor-pbr/commands/test.md +5 -0
  808. package/plugins/cursor-pbr/commands/undo.md +5 -0
  809. package/plugins/cursor-pbr/commands/update.md +37 -0
  810. package/plugins/cursor-pbr/commands/verify-work.md +6 -0
  811. package/plugins/cursor-pbr/hooks/hooks.json +258 -8
  812. package/plugins/cursor-pbr/references/agent-contracts.md +324 -0
  813. package/plugins/cursor-pbr/references/agent-teams.md +54 -0
  814. package/plugins/cursor-pbr/references/common-bug-patterns.md +13 -0
  815. package/plugins/cursor-pbr/references/config-reference.md +587 -0
  816. package/plugins/cursor-pbr/references/continuation-format.md +212 -0
  817. package/plugins/cursor-pbr/references/deviation-rules.md +112 -0
  818. package/plugins/cursor-pbr/references/git-integration.md +284 -0
  819. package/plugins/cursor-pbr/references/integration-patterns.md +117 -0
  820. package/plugins/cursor-pbr/references/model-profiles.md +143 -0
  821. package/plugins/cursor-pbr/references/model-selection.md +31 -0
  822. package/plugins/cursor-pbr/references/pbr-tools-cli.md +400 -0
  823. package/plugins/cursor-pbr/references/plan-authoring.md +246 -0
  824. package/plugins/cursor-pbr/references/plan-format.md +351 -0
  825. package/plugins/cursor-pbr/references/questioning.md +303 -0
  826. package/plugins/cursor-pbr/references/reading-verification.md +127 -0
  827. package/plugins/cursor-pbr/references/signal-files.md +41 -0
  828. package/plugins/cursor-pbr/references/stub-patterns.md +160 -0
  829. package/plugins/cursor-pbr/references/tmux-setup.md +286 -0
  830. package/plugins/cursor-pbr/references/ui-formatting.md +449 -0
  831. package/plugins/cursor-pbr/references/wave-execution.md +95 -0
  832. package/plugins/cursor-pbr/rules/pbr-workflow.mdc +48 -0
  833. package/plugins/cursor-pbr/setup.ps1 +78 -0
  834. package/plugins/cursor-pbr/setup.sh +83 -0
  835. package/plugins/cursor-pbr/skills/audit/SKILL.md +347 -0
  836. package/plugins/cursor-pbr/skills/begin/SKILL.md +886 -0
  837. package/plugins/cursor-pbr/skills/build/SKILL.md +993 -0
  838. package/plugins/cursor-pbr/skills/config/SKILL.md +341 -0
  839. package/plugins/cursor-pbr/skills/continue/SKILL.md +172 -0
  840. package/plugins/cursor-pbr/skills/dashboard/SKILL.md +57 -0
  841. package/plugins/cursor-pbr/skills/debug/SKILL.md +538 -0
  842. package/plugins/cursor-pbr/skills/discuss/SKILL.md +439 -0
  843. package/plugins/cursor-pbr/skills/do/SKILL.md +69 -0
  844. package/plugins/cursor-pbr/skills/explore/SKILL.md +442 -0
  845. package/plugins/cursor-pbr/skills/health/SKILL.md +331 -0
  846. package/plugins/cursor-pbr/skills/help/SKILL.md +231 -0
  847. package/plugins/cursor-pbr/skills/import/SKILL.md +815 -0
  848. package/plugins/cursor-pbr/skills/milestone/SKILL.md +638 -0
  849. package/plugins/cursor-pbr/skills/note/SKILL.md +220 -0
  850. package/plugins/cursor-pbr/skills/pause/SKILL.md +258 -0
  851. package/plugins/cursor-pbr/skills/plan/SKILL.md +690 -0
  852. package/plugins/cursor-pbr/skills/profile/SKILL.md +172 -0
  853. package/plugins/cursor-pbr/skills/quick/SKILL.md +437 -0
  854. package/plugins/cursor-pbr/skills/resume/SKILL.md +403 -0
  855. package/plugins/cursor-pbr/skills/review/SKILL.md +694 -0
  856. package/plugins/cursor-pbr/skills/scan/SKILL.md +325 -0
  857. package/plugins/cursor-pbr/skills/setup/SKILL.md +235 -0
  858. package/plugins/cursor-pbr/skills/shared/commit-planning-docs.md +43 -0
  859. package/plugins/cursor-pbr/skills/shared/config-loading.md +102 -0
  860. package/plugins/cursor-pbr/skills/shared/context-budget.md +92 -0
  861. package/plugins/cursor-pbr/skills/shared/context-loader-task.md +93 -0
  862. package/plugins/cursor-pbr/skills/shared/digest-select.md +79 -0
  863. package/plugins/cursor-pbr/skills/shared/domain-probes.md +125 -0
  864. package/plugins/cursor-pbr/skills/shared/error-reporting.md +59 -0
  865. package/plugins/cursor-pbr/skills/shared/gate-prompts.md +390 -0
  866. package/plugins/cursor-pbr/skills/shared/phase-argument-parsing.md +45 -0
  867. package/plugins/cursor-pbr/skills/shared/revision-loop.md +81 -0
  868. package/plugins/cursor-pbr/skills/shared/state-update.md +153 -0
  869. package/plugins/cursor-pbr/skills/shared/universal-anti-patterns.md +59 -0
  870. package/plugins/cursor-pbr/skills/status/SKILL.md +484 -0
  871. package/plugins/cursor-pbr/skills/statusline/SKILL.md +150 -0
  872. package/plugins/cursor-pbr/skills/test/SKILL.md +211 -0
  873. package/plugins/cursor-pbr/skills/todo/SKILL.md +282 -0
  874. package/plugins/cursor-pbr/skills/undo/SKILL.md +215 -0
  875. package/plugins/cursor-pbr/templates/CONTEXT.md.tmpl +52 -0
  876. package/plugins/cursor-pbr/templates/INTEGRATION-REPORT.md.tmpl +167 -0
  877. package/plugins/cursor-pbr/templates/PROJECT.md.tmpl +111 -0
  878. package/plugins/cursor-pbr/templates/REQUIREMENTS.md.tmpl +96 -0
  879. package/plugins/cursor-pbr/templates/ROADMAP.md.tmpl +105 -0
  880. package/plugins/cursor-pbr/templates/SUMMARY-complex.md.tmpl +112 -0
  881. package/plugins/cursor-pbr/templates/SUMMARY-minimal.md.tmpl +48 -0
  882. package/plugins/cursor-pbr/templates/SUMMARY.md.tmpl +81 -0
  883. package/plugins/cursor-pbr/templates/VERIFICATION-DETAIL.md.tmpl +119 -0
  884. package/plugins/cursor-pbr/templates/codebase/ARCHITECTURE.md.tmpl +98 -0
  885. package/plugins/cursor-pbr/templates/codebase/CONCERNS.md.tmpl +93 -0
  886. package/plugins/cursor-pbr/templates/codebase/CONVENTIONS.md.tmpl +104 -0
  887. package/plugins/cursor-pbr/templates/codebase/INTEGRATIONS.md.tmpl +78 -0
  888. package/plugins/cursor-pbr/templates/codebase/STACK.md.tmpl +78 -0
  889. package/plugins/cursor-pbr/templates/codebase/STRUCTURE.md.tmpl +80 -0
  890. package/plugins/cursor-pbr/templates/codebase/TESTING.md.tmpl +107 -0
  891. package/plugins/cursor-pbr/templates/continue-here.md.tmpl +73 -0
  892. package/plugins/cursor-pbr/templates/pr-body.md.tmpl +22 -0
  893. package/plugins/cursor-pbr/templates/project-CONTEXT.md.tmpl +43 -0
  894. package/plugins/cursor-pbr/templates/prompt-partials/phase-project-context.md.tmpl +37 -0
  895. package/plugins/cursor-pbr/templates/research-outputs/ARCHITECTURE.md.tmpl +91 -0
  896. package/plugins/cursor-pbr/templates/research-outputs/FEATURES.md.tmpl +64 -0
  897. package/plugins/cursor-pbr/templates/research-outputs/PITFALLS.md.tmpl +50 -0
  898. package/plugins/cursor-pbr/templates/research-outputs/STACK.md.tmpl +63 -0
  899. package/plugins/cursor-pbr/templates/research-outputs/SUMMARY.md.tmpl +98 -0
  900. package/plugins/pbr/.claude-plugin/plugin.json +7 -2
  901. package/plugins/pbr/UI-CONSISTENCY-GAPS.md +1 -1
  902. package/plugins/pbr/agents/audit.md +247 -0
  903. package/plugins/pbr/agents/codebase-mapper.md +155 -187
  904. package/plugins/pbr/agents/debugger.md +206 -160
  905. package/plugins/pbr/agents/dev-sync.md +206 -0
  906. package/plugins/pbr/agents/executor.md +390 -250
  907. package/plugins/pbr/agents/general.md +88 -93
  908. package/plugins/pbr/agents/integration-checker.md +163 -93
  909. package/plugins/pbr/agents/nyquist-auditor.md +252 -0
  910. package/plugins/pbr/agents/plan-checker.md +165 -148
  911. package/plugins/pbr/agents/planner.md +338 -197
  912. package/plugins/pbr/agents/researcher.md +221 -237
  913. package/plugins/pbr/agents/roadmapper.md +346 -0
  914. package/plugins/pbr/agents/synthesizer.md +190 -148
  915. package/plugins/pbr/agents/verifier.md +409 -321
  916. package/plugins/pbr/commands/add-phase.md +75 -0
  917. package/plugins/pbr/commands/add-todo.md +8 -0
  918. package/plugins/pbr/commands/audit-milestone.md +8 -0
  919. package/plugins/pbr/commands/audit.md +5 -0
  920. package/plugins/pbr/commands/check-todos.md +8 -0
  921. package/plugins/pbr/commands/complete-milestone.md +8 -0
  922. package/plugins/pbr/commands/config.md +2 -2
  923. package/plugins/pbr/commands/continue.md +1 -1
  924. package/plugins/pbr/commands/dashboard.md +5 -0
  925. package/plugins/pbr/commands/debug.md +1 -1
  926. package/plugins/pbr/commands/discuss-phase.md +6 -0
  927. package/plugins/pbr/commands/do.md +5 -0
  928. package/plugins/pbr/commands/execute-phase.md +6 -0
  929. package/plugins/pbr/commands/explore.md +1 -1
  930. package/plugins/pbr/commands/health.md +1 -1
  931. package/plugins/pbr/commands/help.md +1 -1
  932. package/plugins/pbr/commands/import.md +1 -1
  933. package/plugins/pbr/commands/insert-phase.md +65 -0
  934. package/plugins/pbr/commands/join-discord.md +11 -0
  935. package/plugins/pbr/commands/list-phase-assumptions.md +69 -0
  936. package/plugins/pbr/commands/map-codebase.md +6 -0
  937. package/plugins/pbr/commands/new-milestone.md +8 -0
  938. package/plugins/pbr/commands/new-project.md +6 -0
  939. package/plugins/pbr/commands/note.md +1 -1
  940. package/plugins/pbr/commands/pause-work.md +5 -0
  941. package/plugins/pbr/commands/plan-milestone-gaps.md +7 -0
  942. package/plugins/pbr/commands/plan-phase.md +6 -0
  943. package/plugins/pbr/commands/progress.md +6 -0
  944. package/plugins/pbr/commands/quick.md +1 -1
  945. package/plugins/pbr/commands/reapply-patches.md +40 -0
  946. package/plugins/pbr/commands/remove-phase.md +66 -0
  947. package/plugins/pbr/commands/research-phase.md +59 -0
  948. package/plugins/pbr/commands/resume-work.md +5 -0
  949. package/plugins/pbr/commands/set-profile.md +6 -0
  950. package/plugins/pbr/commands/settings.md +5 -0
  951. package/plugins/pbr/commands/setup.md +2 -2
  952. package/plugins/pbr/commands/statusline.md +5 -0
  953. package/plugins/pbr/commands/test.md +5 -0
  954. package/plugins/pbr/commands/undo.md +5 -0
  955. package/plugins/pbr/commands/update.md +37 -0
  956. package/plugins/pbr/commands/verify-work.md +6 -0
  957. package/plugins/pbr/dashboard/package-lock.json +6 -0
  958. package/plugins/pbr/hooks/hooks.json +111 -28
  959. package/plugins/pbr/references/agent-contracts.md +324 -0
  960. package/plugins/pbr/references/agent-teams.md +3 -3
  961. package/plugins/pbr/references/{checkpoints.md → archive/checkpoints.md} +32 -0
  962. package/plugins/pbr/references/archive/context-quality-tiers.md +45 -0
  963. package/plugins/pbr/references/{pbr-rules.md → archive/pbr-rules.md} +4 -3
  964. package/plugins/pbr/references/archive/verification-patterns.md +277 -0
  965. package/plugins/pbr/references/config-reference.md +179 -9
  966. package/plugins/pbr/references/git-integration.md +80 -22
  967. package/plugins/pbr/references/model-profiles.md +62 -7
  968. package/plugins/pbr/references/model-selection.md +1 -1
  969. package/plugins/pbr/references/pbr-tools-cli.md +400 -0
  970. package/plugins/pbr/references/plan-authoring.md +65 -0
  971. package/plugins/pbr/references/plan-format.md +72 -8
  972. package/plugins/pbr/references/questioning.md +138 -49
  973. package/plugins/pbr/references/reading-verification.md +3 -3
  974. package/plugins/pbr/references/signal-files.md +41 -0
  975. package/plugins/pbr/references/tmux-setup.md +286 -0
  976. package/plugins/pbr/references/ui-formatting.md +67 -79
  977. package/plugins/pbr/scripts/auto-continue.js +132 -9
  978. package/plugins/pbr/scripts/block-skill-self-read.js +77 -0
  979. package/plugins/pbr/scripts/branding-audit.js +231 -0
  980. package/plugins/pbr/scripts/check-agent-state-write.js +63 -0
  981. package/plugins/pbr/scripts/check-config-change.js +188 -0
  982. package/plugins/pbr/scripts/check-cross-plugin-sync.js +93 -0
  983. package/plugins/pbr/scripts/check-dangerous-commands.js +50 -2
  984. package/plugins/pbr/scripts/check-phase-boundary.js +3 -9
  985. package/plugins/pbr/scripts/check-plan-format.js +417 -33
  986. package/plugins/pbr/scripts/check-roadmap-sync.js +179 -10
  987. package/plugins/pbr/scripts/check-skill-workflow.js +110 -19
  988. package/plugins/pbr/scripts/check-state-sync.js +158 -22
  989. package/plugins/pbr/scripts/check-subagent-output.js +582 -15
  990. package/plugins/pbr/scripts/check-summary-gate.js +198 -0
  991. package/plugins/pbr/scripts/config-schema.json +157 -2
  992. package/plugins/pbr/scripts/context-bridge.js +342 -0
  993. package/plugins/pbr/scripts/context-budget-check.js +90 -10
  994. package/plugins/pbr/scripts/enforce-pbr-workflow.js +277 -0
  995. package/plugins/pbr/scripts/event-handler.js +73 -7
  996. package/plugins/pbr/scripts/event-logger.js +1 -1
  997. package/plugins/pbr/scripts/hook-server-client.js +258 -0
  998. package/plugins/pbr/scripts/hook-server.js +334 -0
  999. package/plugins/pbr/scripts/hooks-schema.json +5 -1
  1000. package/plugins/pbr/scripts/instructions-loaded.js +107 -0
  1001. package/plugins/pbr/scripts/intercept-plan-mode.js +47 -0
  1002. package/plugins/pbr/scripts/lib/alternatives.js +203 -0
  1003. package/plugins/pbr/scripts/lib/build.js +719 -0
  1004. package/plugins/pbr/scripts/lib/circuit-state.js +133 -0
  1005. package/plugins/pbr/scripts/lib/config.js +288 -0
  1006. package/plugins/pbr/scripts/lib/context.js +246 -0
  1007. package/plugins/pbr/scripts/lib/core.js +934 -0
  1008. package/plugins/pbr/scripts/lib/gates/advisories.js +129 -0
  1009. package/plugins/pbr/scripts/lib/gates/build-dependency.js +100 -0
  1010. package/plugins/pbr/scripts/lib/gates/build-executor.js +79 -0
  1011. package/plugins/pbr/scripts/lib/gates/doc-existence.js +46 -0
  1012. package/plugins/pbr/scripts/lib/gates/helpers.js +74 -0
  1013. package/plugins/pbr/scripts/lib/gates/milestone-complete.js +120 -0
  1014. package/plugins/pbr/scripts/lib/gates/plan-executor.js +36 -0
  1015. package/plugins/pbr/scripts/lib/gates/quick-executor.js +76 -0
  1016. package/plugins/pbr/scripts/lib/gates/review-planner.js +61 -0
  1017. package/plugins/pbr/scripts/lib/gates/review-verifier.js +69 -0
  1018. package/plugins/pbr/scripts/lib/history.js +150 -0
  1019. package/plugins/pbr/scripts/lib/init.js +302 -0
  1020. package/plugins/pbr/scripts/lib/learnings.js +312 -0
  1021. package/plugins/pbr/scripts/lib/migrate.js +169 -0
  1022. package/plugins/pbr/scripts/lib/phase.js +935 -0
  1023. package/plugins/pbr/scripts/lib/preview.js +174 -0
  1024. package/plugins/pbr/scripts/lib/reference.js +236 -0
  1025. package/plugins/pbr/scripts/lib/roadmap.js +784 -0
  1026. package/plugins/pbr/scripts/lib/skill-section.js +99 -0
  1027. package/plugins/pbr/scripts/lib/spot-check.js +118 -0
  1028. package/plugins/pbr/scripts/lib/state.js +534 -0
  1029. package/plugins/pbr/scripts/lib/step-verify.js +149 -0
  1030. package/plugins/pbr/scripts/lib/todo.js +300 -0
  1031. package/plugins/pbr/scripts/local-llm/client.js +237 -0
  1032. package/plugins/pbr/scripts/local-llm/health.js +220 -0
  1033. package/plugins/pbr/scripts/local-llm/metrics.js +340 -0
  1034. package/plugins/pbr/scripts/local-llm/operations/classify-artifact.js +76 -0
  1035. package/plugins/pbr/scripts/local-llm/operations/classify-commit.js +137 -0
  1036. package/plugins/pbr/scripts/local-llm/operations/classify-error.js +75 -0
  1037. package/plugins/pbr/scripts/local-llm/operations/classify-file-intent.js +171 -0
  1038. package/plugins/pbr/scripts/local-llm/operations/score-source.js +72 -0
  1039. package/plugins/pbr/scripts/local-llm/operations/summarize-context.js +62 -0
  1040. package/plugins/pbr/scripts/local-llm/operations/triage-test-output.js +72 -0
  1041. package/plugins/pbr/scripts/local-llm/operations/validate-task.js +59 -0
  1042. package/plugins/pbr/scripts/local-llm/router.js +101 -0
  1043. package/plugins/pbr/scripts/local-llm/shadow.js +60 -0
  1044. package/plugins/pbr/scripts/local-llm/threshold-tuner.js +118 -0
  1045. package/plugins/pbr/scripts/log-subagent.js +91 -14
  1046. package/plugins/pbr/scripts/log-tool-failure.js +39 -5
  1047. package/plugins/pbr/scripts/milestone-learnings.js +290 -0
  1048. package/plugins/pbr/scripts/package.json +1 -0
  1049. package/plugins/pbr/scripts/pbr-tools.js +1143 -1232
  1050. package/plugins/pbr/scripts/post-bash-triage.js +151 -0
  1051. package/plugins/pbr/scripts/post-write-dispatch.js +182 -26
  1052. package/plugins/pbr/scripts/post-write-quality.js +4 -4
  1053. package/plugins/pbr/scripts/pre-bash-dispatch.js +57 -3
  1054. package/plugins/pbr/scripts/pre-write-dispatch.js +80 -17
  1055. package/plugins/pbr/scripts/progress-tracker.js +428 -19
  1056. package/plugins/pbr/scripts/run-hook.js +49 -8
  1057. package/plugins/pbr/scripts/session-cleanup.js +100 -6
  1058. package/plugins/pbr/scripts/session-tracker.js +78 -0
  1059. package/plugins/pbr/scripts/status-line.js +180 -28
  1060. package/plugins/pbr/scripts/suggest-compact.js +109 -8
  1061. package/plugins/pbr/scripts/sync-context-to-claude.js +100 -0
  1062. package/plugins/pbr/scripts/task-completed.js +124 -2
  1063. package/plugins/pbr/scripts/test/config.test.js +126 -0
  1064. package/plugins/pbr/scripts/test/cross-platform.test.js +131 -0
  1065. package/plugins/pbr/scripts/test/fixtures/config.json +20 -0
  1066. package/plugins/pbr/scripts/test/fixtures/plan.md +54 -0
  1067. package/plugins/pbr/scripts/test/fixtures/project.md +30 -0
  1068. package/plugins/pbr/scripts/test/fixtures/roadmap.md +55 -0
  1069. package/plugins/pbr/scripts/test/fixtures/state.md +60 -0
  1070. package/plugins/pbr/scripts/test/fixtures/summary.md +35 -0
  1071. package/plugins/pbr/scripts/test/fixtures.test.js +184 -0
  1072. package/plugins/pbr/scripts/test/phase.test.js +142 -0
  1073. package/plugins/pbr/scripts/test/roadmap.test.js +96 -0
  1074. package/plugins/pbr/scripts/test/state.test.js +163 -0
  1075. package/plugins/pbr/scripts/track-context-budget.js +237 -84
  1076. package/plugins/pbr/scripts/validate-commit.js +77 -12
  1077. package/plugins/pbr/scripts/validate-skill-args.js +151 -0
  1078. package/plugins/pbr/scripts/validate-task.js +168 -18
  1079. package/plugins/pbr/scripts/worktree-create.js +144 -0
  1080. package/plugins/pbr/scripts/worktree-remove.js +147 -0
  1081. package/plugins/pbr/skills/audit/SKILL.md +348 -0
  1082. package/plugins/pbr/skills/begin/SKILL.md +412 -118
  1083. package/plugins/pbr/skills/begin/templates/STATE.md.tmpl +1 -2
  1084. package/plugins/pbr/skills/begin/templates/config.json.tmpl +8 -2
  1085. package/plugins/pbr/skills/begin/templates/researcher-prompt.md.tmpl +28 -0
  1086. package/plugins/pbr/skills/begin/templates/roadmap-prompt.md.tmpl +19 -0
  1087. package/plugins/pbr/skills/begin/templates/synthesis-prompt.md.tmpl +33 -5
  1088. package/plugins/pbr/skills/build/SKILL.md +503 -307
  1089. package/plugins/pbr/skills/build/templates/continuation-prompt.md.tmpl +26 -0
  1090. package/plugins/pbr/skills/build/templates/executor-prompt.md.tmpl +70 -0
  1091. package/plugins/pbr/skills/build/templates/inline-verifier-prompt.md.tmpl +33 -0
  1092. package/plugins/pbr/skills/config/SKILL.md +104 -18
  1093. package/plugins/pbr/skills/continue/SKILL.md +92 -22
  1094. package/plugins/pbr/skills/dashboard/SKILL.md +58 -0
  1095. package/plugins/pbr/skills/debug/SKILL.md +57 -33
  1096. package/plugins/pbr/skills/debug/templates/continuation-prompt.md.tmpl +12 -1
  1097. package/plugins/pbr/skills/debug/templates/initial-investigation-prompt.md.tmpl +12 -5
  1098. package/plugins/pbr/skills/discuss/SKILL.md +123 -30
  1099. package/plugins/pbr/skills/discuss/templates/CONTEXT.md.tmpl +1 -1
  1100. package/plugins/pbr/skills/do/SKILL.md +70 -0
  1101. package/plugins/pbr/skills/explore/SKILL.md +92 -24
  1102. package/plugins/pbr/skills/health/SKILL.md +143 -32
  1103. package/plugins/pbr/skills/help/SKILL.md +122 -45
  1104. package/plugins/pbr/skills/import/SKILL.md +341 -29
  1105. package/plugins/pbr/skills/milestone/SKILL.md +187 -252
  1106. package/plugins/pbr/skills/milestone/templates/audit-output.md.tmpl +76 -0
  1107. package/plugins/pbr/skills/milestone/templates/complete-output.md.tmpl +32 -0
  1108. package/plugins/pbr/skills/milestone/templates/edge-cases.md +54 -0
  1109. package/plugins/pbr/skills/milestone/templates/gaps-output.md.tmpl +25 -0
  1110. package/plugins/pbr/skills/milestone/templates/integration-checker-prompt.md.tmpl +25 -0
  1111. package/plugins/pbr/skills/milestone/templates/new-output.md.tmpl +29 -0
  1112. package/plugins/pbr/skills/note/SKILL.md +45 -55
  1113. package/plugins/pbr/skills/pause/SKILL.md +26 -16
  1114. package/plugins/pbr/skills/plan/SKILL.md +264 -258
  1115. package/plugins/pbr/skills/plan/templates/completion-output.md.tmpl +27 -0
  1116. package/plugins/pbr/skills/plan/templates/planner-prompt.md.tmpl +1 -1
  1117. package/plugins/pbr/skills/profile/SKILL.md +173 -0
  1118. package/plugins/pbr/skills/quick/SKILL.md +104 -20
  1119. package/plugins/pbr/skills/resume/SKILL.md +29 -27
  1120. package/plugins/pbr/skills/review/SKILL.md +172 -136
  1121. package/plugins/pbr/skills/scan/SKILL.md +41 -19
  1122. package/plugins/pbr/skills/scan/templates/mapper-prompt.md.tmpl +1 -1
  1123. package/plugins/pbr/skills/setup/SKILL.md +160 -177
  1124. package/plugins/pbr/skills/shared/commit-planning-docs.md +8 -0
  1125. package/plugins/pbr/skills/shared/context-budget.md +67 -2
  1126. package/plugins/pbr/skills/shared/context-loader-task.md +9 -2
  1127. package/plugins/pbr/skills/shared/digest-select.md +2 -2
  1128. package/plugins/pbr/skills/shared/domain-probes.md +1 -1
  1129. package/plugins/pbr/skills/shared/error-reporting.md +38 -58
  1130. package/plugins/pbr/skills/shared/gate-prompts.md +4 -2
  1131. package/plugins/pbr/skills/shared/phase-argument-parsing.md +6 -6
  1132. package/plugins/pbr/skills/shared/state-update.md +36 -44
  1133. package/plugins/pbr/skills/shared/universal-anti-patterns.md +36 -10
  1134. package/plugins/pbr/skills/status/SKILL.md +161 -43
  1135. package/plugins/pbr/skills/statusline/SKILL.md +151 -0
  1136. package/plugins/pbr/skills/test/SKILL.md +212 -0
  1137. package/plugins/pbr/skills/todo/SKILL.md +117 -32
  1138. package/plugins/pbr/skills/undo/SKILL.md +216 -0
  1139. package/plugins/pbr/templates/CONTEXT.md.tmpl +1 -1
  1140. package/plugins/pbr/templates/INTEGRATION-REPORT.md.tmpl +18 -2
  1141. package/plugins/pbr/templates/PROJECT.md.tmpl +111 -0
  1142. package/plugins/pbr/templates/REQUIREMENTS.md.tmpl +96 -0
  1143. package/plugins/pbr/templates/ROADMAP.md.tmpl +80 -15
  1144. package/plugins/pbr/templates/SUMMARY-complex.md.tmpl +112 -0
  1145. package/plugins/pbr/templates/SUMMARY-minimal.md.tmpl +48 -0
  1146. package/plugins/pbr/templates/VERIFICATION-DETAIL.md.tmpl +13 -10
  1147. package/plugins/pbr/templates/pr-body.md.tmpl +22 -0
  1148. package/plugins/pbr/templates/project-CONTEXT.md.tmpl +43 -0
  1149. package/plugins/pbr/templates/research-outputs/ARCHITECTURE.md.tmpl +91 -0
  1150. package/plugins/pbr/templates/research-outputs/FEATURES.md.tmpl +64 -0
  1151. package/plugins/pbr/templates/research-outputs/PITFALLS.md.tmpl +50 -0
  1152. package/plugins/pbr/templates/research-outputs/STACK.md.tmpl +63 -0
  1153. package/plugins/pbr/templates/research-outputs/SUMMARY.md.tmpl +98 -0
  1154. package/scripts/build-hooks.js +61 -0
  1155. package/scripts/generate-derivatives.js +581 -0
  1156. package/scripts/run-tests.cjs +29 -0
  1157. package/dashboard/bin/cli.js +0 -25
  1158. package/dashboard/public/css/layout.css +0 -406
  1159. package/dashboard/public/css/status-colors.css +0 -98
  1160. package/dashboard/public/js/htmx-title.js +0 -5
  1161. package/dashboard/public/js/sidebar-toggle.js +0 -20
  1162. package/dashboard/src/app.js +0 -78
  1163. package/dashboard/src/middleware/errorHandler.js +0 -52
  1164. package/dashboard/src/middleware/notFoundHandler.js +0 -9
  1165. package/dashboard/src/repositories/planning.repository.js +0 -128
  1166. package/dashboard/src/routes/events.routes.js +0 -40
  1167. package/dashboard/src/routes/index.routes.js +0 -31
  1168. package/dashboard/src/routes/pages.routes.js +0 -245
  1169. package/dashboard/src/server.js +0 -42
  1170. package/dashboard/src/services/dashboard.service.js +0 -222
  1171. package/dashboard/src/services/phase.service.js +0 -220
  1172. package/dashboard/src/services/project.service.js +0 -57
  1173. package/dashboard/src/services/roadmap.service.js +0 -171
  1174. package/dashboard/src/services/sse.service.js +0 -58
  1175. package/dashboard/src/services/todo.service.js +0 -254
  1176. package/dashboard/src/services/watcher.service.js +0 -48
  1177. package/dashboard/src/views/coming-soon.ejs +0 -11
  1178. package/dashboard/src/views/error.ejs +0 -13
  1179. package/dashboard/src/views/index.ejs +0 -5
  1180. package/dashboard/src/views/layout.ejs +0 -1
  1181. package/dashboard/src/views/partials/dashboard-content.ejs +0 -77
  1182. package/dashboard/src/views/partials/footer.ejs +0 -3
  1183. package/dashboard/src/views/partials/head.ejs +0 -21
  1184. package/dashboard/src/views/partials/header.ejs +0 -12
  1185. package/dashboard/src/views/partials/layout-bottom.ejs +0 -15
  1186. package/dashboard/src/views/partials/layout-top.ejs +0 -8
  1187. package/dashboard/src/views/partials/phase-content.ejs +0 -188
  1188. package/dashboard/src/views/partials/phase-doc-content.ejs +0 -38
  1189. package/dashboard/src/views/partials/phases-content.ejs +0 -117
  1190. package/dashboard/src/views/partials/roadmap-content.ejs +0 -142
  1191. package/dashboard/src/views/partials/sidebar.ejs +0 -38
  1192. package/dashboard/src/views/partials/todo-create-content.ejs +0 -53
  1193. package/dashboard/src/views/partials/todo-detail-content.ejs +0 -38
  1194. package/dashboard/src/views/partials/todos-content.ejs +0 -53
  1195. package/dashboard/src/views/phase-detail.ejs +0 -5
  1196. package/dashboard/src/views/phase-doc.ejs +0 -5
  1197. package/dashboard/src/views/phases.ejs +0 -5
  1198. package/dashboard/src/views/roadmap.ejs +0 -5
  1199. package/dashboard/src/views/todo-create.ejs +0 -5
  1200. package/dashboard/src/views/todo-detail.ejs +0 -5
  1201. package/dashboard/src/views/todos.ejs +0 -5
  1202. package/plugins/cursor-pbr/agents/.gitkeep +0 -0
  1203. package/plugins/cursor-pbr/references/.gitkeep +0 -0
  1204. package/plugins/cursor-pbr/rules/.gitkeep +0 -0
  1205. package/plugins/cursor-pbr/skills/.gitkeep +0 -0
  1206. package/plugins/cursor-pbr/templates/.gitkeep +0 -0
  1207. package/plugins/pbr/commands/begin.md +0 -5
  1208. package/plugins/pbr/commands/build.md +0 -5
  1209. package/plugins/pbr/commands/discuss.md +0 -5
  1210. package/plugins/pbr/commands/milestone.md +0 -5
  1211. package/plugins/pbr/commands/pause.md +0 -5
  1212. package/plugins/pbr/commands/plan.md +0 -5
  1213. package/plugins/pbr/commands/resume.md +0 -5
  1214. package/plugins/pbr/commands/review.md +0 -5
  1215. package/plugins/pbr/commands/scan.md +0 -5
  1216. package/plugins/pbr/commands/status.md +0 -5
  1217. package/plugins/pbr/commands/todo.md +0 -5
  1218. package/plugins/pbr/references/agent-interactions.md +0 -134
  1219. package/plugins/pbr/references/planning-config.md +0 -213
  1220. package/plugins/pbr/references/subagent-coordination.md +0 -119
  1221. package/plugins/pbr/references/verification-patterns.md +0 -198
  1222. package/plugins/pbr/skills/shared/progress-display.md +0 -53
  1223. package/plugins/pbr/skills/shared/state-loading.md +0 -62
  1224. package/plugins/pbr/templates/RESEARCH-SUMMARY.md.tmpl +0 -97
  1225. package/plugins/pbr/templates/research/ARCHITECTURE.md.tmpl +0 -124
  1226. package/plugins/pbr/templates/research/STACK.md.tmpl +0 -71
  1227. package/plugins/pbr/templates/research/SUMMARY.md.tmpl +0 -112
  1228. package/plugins/pbr/templates/research-outputs/phase-research.md.tmpl +0 -81
  1229. package/plugins/pbr/templates/research-outputs/project-research.md.tmpl +0 -99
  1230. package/plugins/pbr/templates/research-outputs/synthesis.md.tmpl +0 -36
  1231. /package/plugins/pbr/references/{agent-anti-patterns.md → archive/agent-anti-patterns.md} +0 -0
@@ -0,0 +1,6 @@
1
+ ---
2
+ description: "Validate built features through conversational UAT"
3
+ argument-hint: "[phase number]"
4
+ ---
5
+
6
+ This command is provided by the `pbr:review` skill.
@@ -0,0 +1,85 @@
1
+ #!/usr/bin/env node
2
+ 'use strict';
3
+
4
+ const path = require('path');
5
+ const fs = require('fs');
6
+
7
+ // --- Argument parsing ---
8
+
9
+ const args = process.argv.slice(2);
10
+
11
+ function getArg(name) {
12
+ const idx = args.indexOf(name);
13
+ if (idx === -1) return undefined;
14
+ return args[idx + 1];
15
+ }
16
+
17
+ function hasFlag(name) {
18
+ return args.includes(name);
19
+ }
20
+
21
+ if (hasFlag('--help') || hasFlag('-h')) {
22
+ console.log(`
23
+ Usage: pbr-dashboard --dir <project-path> [options]
24
+
25
+ Options:
26
+ --dir <path> Project directory (required)
27
+ --port <num> Port number (default: 3141, or set PBR_DASHBOARD_PORT env var)
28
+ --open Auto-open browser after start
29
+ --help, -h Show this help message
30
+ `);
31
+ process.exit(0);
32
+ }
33
+
34
+ // --- Resolve arguments ---
35
+
36
+ const dir = getArg('--dir');
37
+ if (!dir) {
38
+ console.error('PBR > Error: --dir <project-path> is required');
39
+ console.error('PBR > Run with --help for usage information');
40
+ process.exit(1);
41
+ }
42
+
43
+ const resolvedDir = path.resolve(dir);
44
+ const planningDir = path.join(resolvedDir, '.planning');
45
+ const portArg = getArg('--port');
46
+ const port = Number(portArg) || Number(process.env.PBR_DASHBOARD_PORT) || 3141;
47
+ const shouldOpen = hasFlag('--open');
48
+
49
+ // --- Validate directory ---
50
+
51
+ if (!fs.existsSync(resolvedDir)) {
52
+ console.error(`PBR > Error: Directory does not exist: ${resolvedDir}`);
53
+ process.exit(1);
54
+ }
55
+
56
+ if (!fs.existsSync(planningDir)) {
57
+ console.warn(`PBR > Warning: No .planning/ directory found in ${resolvedDir}`);
58
+ console.warn('PBR > Dashboard may show empty data');
59
+ }
60
+
61
+ // --- Start server ---
62
+
63
+ const { startServer } = require('../server/index');
64
+
65
+ startServer({ planningDir, port });
66
+
67
+ console.log(`PBR > Dashboard running at http://localhost:${port}`);
68
+
69
+ // --- Auto-open browser ---
70
+
71
+ if (shouldOpen) {
72
+ setTimeout(() => {
73
+ const { exec } = require('child_process');
74
+ const platform = process.platform;
75
+ const url = `http://localhost:${port}`;
76
+
77
+ if (platform === 'win32') {
78
+ exec(`start ${url}`);
79
+ } else if (platform === 'darwin') {
80
+ exec(`open ${url}`);
81
+ } else {
82
+ exec(`xdg-open ${url}`);
83
+ }
84
+ }, 500);
85
+ }
@@ -0,0 +1,37 @@
1
+ import js from '@eslint/js';
2
+ import react from 'eslint-plugin-react';
3
+ import reactHooks from 'eslint-plugin-react-hooks';
4
+ import globals from 'globals';
5
+
6
+ export default [
7
+ js.configs.recommended,
8
+ {
9
+ files: ['src/**/*.{js,jsx}'],
10
+ plugins: { react, 'react-hooks': reactHooks },
11
+ languageOptions: {
12
+ globals: { ...globals.browser },
13
+ parserOptions: { ecmaFeatures: { jsx: true } },
14
+ },
15
+ rules: {
16
+ ...react.configs.recommended.rules,
17
+ ...reactHooks.configs.recommended.rules,
18
+ 'react/react-in-jsx-scope': 'off',
19
+ 'react/prop-types': 'off',
20
+ 'no-unused-vars': ['error', { argsIgnorePattern: '^_', caughtErrorsIgnorePattern: '^_' }],
21
+ },
22
+ settings: { react: { version: 'detect' } },
23
+ },
24
+ {
25
+ files: ['server/**/*.js'],
26
+ languageOptions: {
27
+ globals: { ...globals.node },
28
+ sourceType: 'commonjs',
29
+ },
30
+ rules: {
31
+ 'no-unused-vars': ['error', { argsIgnorePattern: '^_', caughtErrorsIgnorePattern: '^_' }],
32
+ },
33
+ },
34
+ {
35
+ ignores: ['dist/', 'node_modules/'],
36
+ },
37
+ ];
@@ -0,0 +1,20 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <title>PBR Dashboard</title>
7
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
8
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
9
+ <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
10
+ <style>
11
+ *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
12
+ body { overflow: hidden; }
13
+ @keyframes pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.5; } }
14
+ </style>
15
+ </head>
16
+ <body>
17
+ <div id="root"></div>
18
+ <script type="module" src="/src/main.jsx"></script>
19
+ </body>
20
+ </html>
@@ -1,34 +1,39 @@
1
1
  {
2
- "name": "plan-build-run-dashboard",
3
- "version": "0.1.0",
4
- "description": "Web dashboard for viewing Plan-Build-Run project planning state",
2
+ "name": "pbr-dashboard",
3
+ "private": true,
4
+ "version": "0.0.1",
5
5
  "type": "module",
6
6
  "bin": {
7
- "pbr-dashboard": "./bin/cli.js"
7
+ "pbr-dashboard": "./bin/cli.cjs"
8
8
  },
9
9
  "scripts": {
10
- "start": "node bin/cli.js",
11
- "dev": "node --watch bin/cli.js",
12
- "test": "vitest run"
10
+ "dev": "vite",
11
+ "build": "vite build",
12
+ "preview": "vite preview",
13
+ "lint": "eslint src/ server/",
14
+ "test": "vitest run",
15
+ "test:watch": "vitest"
13
16
  },
14
- "keywords": [
15
- "plan-build-run",
16
- "dashboard",
17
- "planning"
18
- ],
19
- "license": "MIT",
20
17
  "dependencies": {
21
- "@rollup/rollup-win32-x64-msvc": "^4.57.1",
22
- "chokidar": "^5.0.0",
23
- "commander": "^12.1.0",
24
- "ejs": "^3.1.10",
25
- "express": "^5.1.0",
26
- "gray-matter": "^4.0.3",
27
- "helmet": "^8.1.0",
28
- "marked": "^17.0.1"
18
+ "@rollup/rollup-win32-x64-msvc": "^4.59.0",
19
+ "lucide-react": "^0.577.0",
20
+ "react": "^18.3.1",
21
+ "react-dom": "^18.3.1",
22
+ "recharts": "^3.8.0"
29
23
  },
30
24
  "devDependencies": {
31
- "memfs": "^4.56.10",
32
- "vitest": "^3.1.0"
25
+ "@eslint/js": "^9.39.4",
26
+ "@testing-library/dom": "^10.4.1",
27
+ "@testing-library/jest-dom": "^6.9.1",
28
+ "@testing-library/react": "^16.3.2",
29
+ "@testing-library/user-event": "^14.6.1",
30
+ "@vitejs/plugin-react": "^5.1.4",
31
+ "eslint": "^9.39.4",
32
+ "eslint-plugin-react": "^7.37.5",
33
+ "eslint-plugin-react-hooks": "^7.0.1",
34
+ "globals": "^17.4.0",
35
+ "jsdom": "^28.1.0",
36
+ "vite": "^7.3.1",
37
+ "vitest": "^4.0.18"
33
38
  }
34
39
  }
@@ -0,0 +1,134 @@
1
+ 'use strict';
2
+
3
+ const express = require('express');
4
+ const cors = require('cors');
5
+ const path = require('path');
6
+ const healthRouter = require('./routes/health');
7
+ const { PlanningReader } = require('./services/planning-reader');
8
+ const createStatusRouter = require('./routes/status');
9
+ const createProjectsRouter = require('./routes/projects');
10
+ const createPlanningRouter = require('./routes/planning');
11
+ const createConfigRouter = require('./routes/config');
12
+ const createTelemetryRouter = require('./routes/telemetry');
13
+ const createAgentsRouter = require('./routes/agents');
14
+ const createMemoryRouter = require('./routes/memory');
15
+ const createRoadmapRouter = require('./routes/roadmap');
16
+ const createRequirementsRouter = require('./routes/requirements');
17
+ const { setupStatic } = require('./middleware/static');
18
+ const { setupWebSocket } = require('./ws');
19
+ const { FileWatcher } = require('./services/file-watcher');
20
+
21
+ /**
22
+ * Create an Express app with the given options.
23
+ * Pure factory — no side effects (does not listen).
24
+ *
25
+ * @param {object} [options]
26
+ * @param {string} [options.planningDir] - Path to .planning/ directory
27
+ * @param {string} [options.distDir] - Path to built frontend assets
28
+ * @param {number} [options.port] - Port to listen on
29
+ * @returns {{ app: Express, options: object }}
30
+ */
31
+ function createApp(options = {}) {
32
+ const resolved = {
33
+ planningDir: options.planningDir || path.join(process.cwd(), '.planning'),
34
+ distDir: options.distDir || path.join(__dirname, '..', 'dist'),
35
+ port: options.port != null ? options.port : (Number(process.env.PBR_DASHBOARD_PORT) || (() => {
36
+ throw new Error('Port is required: pass via options.port or PBR_DASHBOARD_PORT env var');
37
+ })()),
38
+ };
39
+
40
+ const app = express();
41
+
42
+ // Core middleware
43
+ app.use(cors());
44
+ app.use(express.json());
45
+
46
+ // Store resolved options on app for downstream middleware
47
+ app.locals.options = resolved;
48
+
49
+ // Create shared services
50
+ const planningReader = new PlanningReader(resolved.planningDir);
51
+
52
+ // API routes — health first for fast health checks
53
+ app.use('/api/health', healthRouter);
54
+ app.use('/api/status', createStatusRouter(planningReader));
55
+ app.use('/api/projects', createProjectsRouter(planningReader));
56
+ app.use('/api/planning', createPlanningRouter(planningReader));
57
+ app.use('/api/config', createConfigRouter(planningReader));
58
+ app.use('/api/telemetry', createTelemetryRouter({ planningDir: resolved.planningDir }));
59
+ const agentsRouter = createAgentsRouter({ planningDir: resolved.planningDir });
60
+ app.use('/api/agents', agentsRouter);
61
+ // Alias /api/hooks and /api/errors to agents sub-routes for HooksPage
62
+ app.use('/api/hooks', (req, res, next) => { req.url = '/hooks' + req.url; agentsRouter(req, res, next); });
63
+ app.use('/api/errors', (req, res, next) => { req.url = '/errors' + req.url; agentsRouter(req, res, next); });
64
+ app.use('/api/memory', createMemoryRouter({ planningDir: resolved.planningDir, planningReader }));
65
+ app.use('/api/roadmap', createRoadmapRouter(planningReader));
66
+ app.use('/api/requirements', createRequirementsRouter(planningReader));
67
+
68
+ // 404 handler for unmatched /api/* routes
69
+ app.all(/^\/api\//, (_req, res) => {
70
+ res.status(404).json({ error: 'Not found' });
71
+ });
72
+
73
+ // Static file serving and SPA fallback
74
+ setupStatic(app, resolved.distDir);
75
+
76
+ return { app, options: resolved };
77
+ }
78
+
79
+ /**
80
+ * Start the server, binding to the configured port.
81
+ *
82
+ * @param {object} [options] - Same options as createApp
83
+ * @returns {import('http').Server}
84
+ */
85
+ function startServer(options = {}) {
86
+ const { app, options: resolved } = createApp(options);
87
+ const server = app.listen(resolved.port, () => {
88
+ console.log(`PBR Dashboard server listening on port ${resolved.port}`);
89
+ });
90
+
91
+ // File watcher for real-time updates
92
+ const fileWatcher = new FileWatcher(resolved.planningDir);
93
+
94
+ // Attach WebSocket server to HTTP server
95
+ const { wss } = setupWebSocket(server, fileWatcher);
96
+
97
+ // Start watching for file changes
98
+ fileWatcher.start().then(() => {
99
+ console.log(`File watcher started on ${resolved.planningDir}`);
100
+ }).catch((err) => {
101
+ console.error('Failed to start file watcher:', err.message);
102
+ });
103
+
104
+ // Graceful shutdown
105
+ const shutdown = () => {
106
+ console.log('Shutting down...');
107
+ fileWatcher.stop().catch(() => {});
108
+ wss.close();
109
+ server.close();
110
+ };
111
+
112
+ process.on('SIGTERM', shutdown);
113
+ process.on('SIGINT', shutdown);
114
+
115
+ return server;
116
+ }
117
+
118
+ // Direct execution
119
+ if (require.main === module || process.argv[1] === __filename) {
120
+ // Parse --dir and --port from command line args
121
+ const args = process.argv.slice(2);
122
+ const dirIdx = args.indexOf('--dir');
123
+ const portIdx = args.indexOf('--port');
124
+ const opts = {};
125
+ if (dirIdx !== -1 && args[dirIdx + 1]) {
126
+ opts.planningDir = path.join(path.resolve(args[dirIdx + 1]), '.planning');
127
+ }
128
+ if (portIdx !== -1 && args[portIdx + 1]) {
129
+ opts.port = Number(args[portIdx + 1]);
130
+ }
131
+ startServer(opts);
132
+ }
133
+
134
+ module.exports = { createApp, startServer };
@@ -0,0 +1,92 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * Parse YAML-like frontmatter from a markdown string.
5
+ * Splits on `---` delimiters and extracts key: value pairs.
6
+ * Handles quoted strings, numbers, booleans, inline arrays,
7
+ * and one level of nested YAML indentation (2-space indent).
8
+ *
9
+ * @param {string} content - Raw file content
10
+ * @returns {{ frontmatter: object, body: string }}
11
+ */
12
+ function parseFrontmatter(content) {
13
+ const normalized = content.replace(/\r\n/g, '\n');
14
+ const match = normalized.match(/^---\n([\s\S]*?)\n---/);
15
+ if (!match) return { frontmatter: {}, body: normalized };
16
+
17
+ const raw = match[1];
18
+ const body = normalized.slice(match[0].length).trim();
19
+ const frontmatter = {};
20
+ const lines = raw.split('\n');
21
+
22
+ let currentParent = null;
23
+
24
+ for (let i = 0; i < lines.length; i++) {
25
+ const line = lines[i];
26
+
27
+ // Check for nested key (2-space indented under a parent)
28
+ if (currentParent && /^ {2}\w/.test(line)) {
29
+ const kv = line.match(/^\s+(\w[\w_-]*)\s*:\s*(.+)$/);
30
+ if (kv) {
31
+ if (typeof frontmatter[currentParent] !== 'object' || frontmatter[currentParent] === null) {
32
+ frontmatter[currentParent] = {};
33
+ }
34
+ frontmatter[currentParent][kv[1]] = parseValue(kv[2].trim());
35
+ }
36
+ continue;
37
+ }
38
+
39
+ // Top-level key
40
+ currentParent = null;
41
+ const kv = line.match(/^(\w[\w_-]*)\s*:\s*(.+)$/);
42
+ if (kv) {
43
+ frontmatter[kv[1]] = parseValue(kv[2].trim());
44
+ continue;
45
+ }
46
+
47
+ // Parent key with no inline value (e.g., "progress:")
48
+ const parentMatch = line.match(/^(\w[\w_-]*)\s*:\s*$/);
49
+ if (parentMatch) {
50
+ currentParent = parentMatch[1];
51
+ // Initialize as empty object; will be populated by nested lines
52
+ frontmatter[currentParent] = {};
53
+ continue;
54
+ }
55
+ }
56
+
57
+ return { frontmatter, body };
58
+ }
59
+
60
+ /**
61
+ * Parse a single YAML value string into its JS equivalent.
62
+ * @param {string} val - Raw value string
63
+ * @returns {string|number|boolean|string[]}
64
+ */
65
+ function parseValue(val) {
66
+ // Strip surrounding quotes
67
+ if ((val.startsWith('"') && val.endsWith('"')) ||
68
+ (val.startsWith("'") && val.endsWith("'"))) {
69
+ return val.slice(1, -1);
70
+ }
71
+ // Inline array: [a, b, c]
72
+ if (val.startsWith('[') && val.endsWith(']')) {
73
+ return val.slice(1, -1).split(',').map(s => {
74
+ s = s.trim();
75
+ if ((s.startsWith('"') && s.endsWith('"')) ||
76
+ (s.startsWith("'") && s.endsWith("'"))) {
77
+ s = s.slice(1, -1);
78
+ }
79
+ return s;
80
+ }).filter(s => s.length > 0);
81
+ }
82
+ // Boolean
83
+ if (val === 'true') return true;
84
+ if (val === 'false') return false;
85
+ // Number
86
+ if (/^\d+$/.test(val)) return parseInt(val, 10);
87
+ if (/^\d+\.\d+$/.test(val)) return parseFloat(val);
88
+
89
+ return val;
90
+ }
91
+
92
+ module.exports = { parseFrontmatter };
@@ -0,0 +1,35 @@
1
+ 'use strict';
2
+
3
+ const fs = require('fs');
4
+ const path = require('path');
5
+ const express = require('express');
6
+
7
+ /**
8
+ * Set up static file serving and SPA fallback.
9
+ *
10
+ * If distDir does not exist, static serving is skipped entirely
11
+ * (server still works for API routes without a frontend build).
12
+ *
13
+ * @param {import('express').Express} app
14
+ * @param {string} distDir - Path to built frontend assets
15
+ */
16
+ function setupStatic(app, distDir) {
17
+ if (!fs.existsSync(distDir)) {
18
+ return;
19
+ }
20
+
21
+ // Serve static files from distDir
22
+ app.use(express.static(distDir));
23
+
24
+ // SPA fallback: serve index.html for GET requests not matching /api/*
25
+ app.get(/^\/(?!api\/).*/, (req, res) => {
26
+ const indexPath = path.join(distDir, 'index.html');
27
+ if (fs.existsSync(indexPath)) {
28
+ res.sendFile(indexPath);
29
+ } else {
30
+ res.status(404).json({ error: 'Not found' });
31
+ }
32
+ });
33
+ }
34
+
35
+ module.exports = { setupStatic };
@@ -0,0 +1,16 @@
1
+ {
2
+ "name": "pbr-dashboard-server",
3
+ "version": "1.0.0",
4
+ "description": "Express server for PBR Dashboard v4",
5
+ "main": "index.js",
6
+ "scripts": {
7
+ "start": "node index.js",
8
+ "dev": "node --watch index.js"
9
+ },
10
+ "dependencies": {
11
+ "express": "^5.1.0",
12
+ "cors": "^2.8.5",
13
+ "ws": "^8.18.0",
14
+ "chokidar": "^4.0.0"
15
+ }
16
+ }