bigpowers 2.0.0 → 2.0.1

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [2.0.1](https://github.com/danielvm-git/bigpowers/compare/v2.0.0...v2.0.1) (2026-06-11)
+
+
+### Bug Fixes
+
+* **dashboard/tui:** render blessed tags and improve layout ([ca3a161](https://github.com/danielvm-git/bigpowers/commit/ca3a1617a341d05dacf3b571abf58cb6c0cfceeb))
+
 # [2.0.0](https://github.com/danielvm-git/bigpowers/compare/v1.5.1...v2.0.0) (2026-06-11)
 
 

package/CONVENTIONS.md

@@ -49,13 +49,29 @@ Every skill that produces written output writes to `specs/` at the project root.
 
 | Layer | File | Answers |
 |-------|------|---------|
-| Session | `specs/state.yaml` | Active flow, epic/bug, ship-epic step, git |
-| Release index | `specs/release-plan.yaml` | Target semver, WSJF epic list, pointers to `epics/` |
+| Session | `specs/state.yaml` | Active flow, epic/bug, ship-epic step, git, `handoff.next_skill`, `metrics.story_start` |
+| Release index | `specs/release-plan.yaml` | Target semver, WSJF epic list, BCP baseline per story |
 | Progress | `specs/execution-status.yaml` | Flat status keys (`e01`, `e01s01`) — sole SoT for story state |
+| Cycle-time ledger | `specs/metrics/cycle-times.yaml` | Per-story: BCPs, start, end, cycle minutes, BCP/hr **(v2.0.0)** |
 | Planning UI | `specs/planning-status.yaml` | Discover-phase workflow checklist (optional) |
 
 **Do not** put story status in `release-plan.yaml`. **Do not** duplicate the release plan inside `state.yaml`.
 
+### BCP accounting mandate (v2.0.0)
+
+Every task written by `plan-work` MUST be labeled `[BCP N]` where N is the estimated Build Commit Points for that task. The story total is summed and written to `state.yaml` as `epic_cycle.story_bcps`. The BCP baseline for each story MUST appear in `specs/release-plan.yaml` before implementation begins. `release-branch` automatically appends a row to `specs/metrics/cycle-times.yaml` with the final BCP/hr after the story lands.
+
+### Timestamp mandate (v2.0.0)
+
+- `survey-context` MUST write `metrics.story_start` (ISO 8601) to `specs/state.yaml` at the start of every story.
+- `release-branch` MUST write `metrics.story_end`, `metrics.cycle_minutes`, and `metrics.bcp_per_hour` to `specs/state.yaml` and append a row to `specs/metrics/cycle-times.yaml` when the story lands.
+
+Missing timestamps are a gate violation — do not advance past `release-branch` without them.
+
+### next_skill signaling mandate (v2.0.0)
+
+Every critical-path skill (survey-context, plan-work, kickoff-branch, develop-tdd, verify-work, audit-code, commit-message, release-branch) MUST write `handoff.next_skill` to `specs/state.yaml` as its last action. Agents MUST read `state.yaml` and follow `handoff.next_skill` before asking "what comes next?".
+
 ### Intent vs delivery vs execution
 
 | Question | File | Format |

package/README.md

@@ -8,7 +8,7 @@
 
 `bigpowers` provides a prescriptive, vertical-slice methodology for building software with AI agents (Claude Code, Gemini CLI, Cursor). It bridges the gap between raw LLM capabilities and professional engineering standards.
 
-Published on npm: [bigpowers@1.0.0](https://www.npmjs.com/package/bigpowers)
+Published on npm: [bigpowers@2.0.0](https://www.npmjs.com/package/bigpowers)
 
 ---
 
@@ -96,16 +96,39 @@ bigpowers
 
 ---
 
-## 🏗 The BMAD Lifecycle
+## 🏗 The v2.0.0 Lifecycle
 
-Every task in `bigpowers` follows a prescriptive lifecycle (see `SKILL-INDEX.md`):
+Every project follows the **orchestrate-project 6-phase model** (full SOP: [`docs/WORKFLOW-SOP-v2.md`](docs/WORKFLOW-SOP-v2.md)):
 
-1.  **Discover**: survey-context, research-first, elaborate-spec.
-2.  **Elaborate / Plan**: scope-work, plan-work, slice-tasks.
-3.  **Build**: develop-tdd, execute-plan.
-4.  **Verify**: verify-work, run-evals — prove it works before review.
-5.  **Review / Release**: audit-code, request-review, release-branch.
-6.  **Sustain**: stocktake-skills, evolve-skill (benchmark-gated).
+```
+ONE TIME    seed-conventions  (CLAUDE.md, .claude/, .gemini/, agents/, skill sync)
+              ↓
+ONCE/PROJECT orchestrate-project
+              │
+              ├─ Ph1 DISCOVER   survey-context, research-first, elaborate-spec
+              ├─ Ph2 ELABORATE  model-domain, grill-me, define-language, deepen-architecture
+              ├─ Ph3 PLAN       scope-work, slice-tasks, plan-work → release-plan.yaml (BCP baseline)
+              ├─ Ph4 BUILD      build-epic × N stories
+              │
+              │  Per story — 8-step build-epic cycle:
+              │   1. survey-context   ← stamps story_start in state.yaml
+              │   2. plan-work        ← [BCP N] tasks + verify: commands
+              │   3. kickoff-branch   ← worktree + feature branch
+              │   4. develop-tdd      ← RED → GREEN → REFACTOR
+              │   5. verify-work      ← UAT gate
+              │   6. audit-code       ← quality gate ≥ 94%
+              │   7. commit-message   ← Conventional Commits + semver
+              │   8. release-branch   ← land to main; writes story_end + cycle-times.yaml
+              │
+              ├─ Ph5 VERIFY     run-evals, verify-work (project-level)
+              └─ Ph6 RELEASE    semantic-release → v1.0.0 MVP tag
+```
+
+**Semver:** projects start at `0.0.0-β`; each `feat:` story → minor bump; developer declares MVP → `1.0.0`.
+
+**BCP accounting:** every task labeled `[BCP N]`; story total in `state.yaml`; BCP/hr logged to `specs/metrics/cycle-times.yaml`.
+
+**next_skill signaling:** each critical-path skill writes `handoff.next_skill` to `state.yaml`. Call `survey-context` after any interruption to resume exactly where you left off.
 
 ---
 
@@ -118,8 +141,9 @@ Every task in `bigpowers` follows a prescriptive lifecycle (see `SKILL-INDEX.md`
 | **Scope** | `specs/requirements/SCOPE_LATEST.yaml` | In-scope / out-of-scope and success criteria. |
 | **Vision** | `specs/requirements/VISION_LATEST.yaml` | North star and initiative success criteria. |
 | **Decisions** | `specs/adr/` | Architectural Decision Records (irreversible choices). |
-| **Roadmap** | `specs/release-plan.yaml` + `specs/epics/` | WSJF-prioritized epics and stories. |
-| **Current** | `specs/state.yaml` | Session flow, active epic, handoff. |
+| **Roadmap** | `specs/release-plan.yaml` + `specs/epics/` | WSJF-prioritized epics and stories with BCP baseline. |
+| **Current** | `specs/state.yaml` | Session flow, active epic, `handoff.next_skill`, timestamps. |
+| **Metrics** | `specs/metrics/cycle-times.yaml` | Per-story BCPs, cycle minutes, BCP/hr (v2.0.0). |
 | **Index** | `SKILL-INDEX.md` | Canonical list of all active skills. |
 | **Style** | `CONVENTIONS.md` | Coding, testing, and naming standards. |
 
@@ -128,8 +152,10 @@ Every task in `bigpowers` follows a prescriptive lifecycle (see `SKILL-INDEX.md`
 ## 📁 Project Structure
 
 - `scripts/`: Installation, syncing, and compliance tools.
-- `specs/`: The "Brain" of your project — all planning and decisions live here (YAML cockpit: `state.yaml`, `release-plan.yaml`, `epics/`, `requirements/`).
-- `specs/wiki/`: Deprecated Obsidian layer — use `visual-dashboard` HTTP cockpit instead of `maintain-wiki`.
+- `specs/`: YAML cockpit — `state.yaml`, `release-plan.yaml`, `epics/`, `execution-status.yaml`, `requirements/`.
+- `specs/metrics/`: Cycle-time ledger (`cycle-times.yaml`) — per-story BCPs, timestamps, BCP/hr (v2.0.0).
+- `dashboard/`: Live monitoring tool — TUI (`npm run dashboard`) and web (`npm run dashboard:web`, port 7742).
+- `docs/`: Guides including `WORKFLOW-SOP-v2.md` (full SDLC SOP) and `using-bigpowers.md`.
 - `docs/references/`: Theoretical foundations (Uncle Bob, Ousterhout, Karpathy, etc.).
 - `[skill-name]/`: Source files for each of the 61 skills.
 

package/RELEASE.md

@@ -48,12 +48,27 @@ npm view bigpowers
 # GitHub → Releases
 ```
 
+## Per-Project Semver Convention (v2.0.0)
+
+When using bigpowers to build a *project* (not the bigpowers package itself), the recommended semver lifecycle is:
+
+| Stage | Version | How |
+|-------|---------|-----|
+| Pre-delivery | `0.0.0-β` | Initial state after `seed-conventions` |
+| Each `feat:` story lands | `0.1.0`, `0.2.0`, … | `semantic-release` minor bump |
+| Developer declares MVP | `1.0.0` | Allow the `1.0.0` tag in release config |
+| Post-MVP features | `1.1.0`, `1.2.0`, … | Normal semver from Conventional Commits |
+
+> This keeps all pre-MVP work in the `0.x.x` range, making the `1.0.0` tag a meaningful project milestone rather than an arbitrary number.
+
+---
+
 ## Commit Message Format
 
 **Required for automatic releases:**
 
 ```
-feat(scope): description          # Minor version bump (1.0.0 → 1.1.0)
+feat(scope): description          # Minor version bump (0.1.0 → 0.2.0 or 1.0.0 → 1.1.0)
 fix(scope): description           # Patch version bump (1.0.0 → 1.0.1)
 docs: description                 # No version bump
 ```

package/SKILL-INDEX.md

@@ -2,7 +2,7 @@
 
 **Purpose:** One canonical reference for all bigpowers skills. Referenced by README.md, RELEASE-PLAN.md, and CONVENTIONS.md. Updated per-release.
 
-**Last updated:** 2026-06-11 (v3.1.0 — verified 61 active skills; 18 sub-op concepts absorbed as sub-sections into parent SKILL.md files; count confirmed accurate)
+**Last updated:** 2026-06-11 (v2.0.0 — verified 61 active skills; 18 sub-op concepts absorbed as sub-sections into parent SKILL.md files; count confirmed accurate)
 
 ---
 
@@ -84,7 +84,7 @@
 | 49 | Utility | `edit-document` | Edit documents in specs/ | specs/<name>.md | ✅ Active |
 | 50 | Utility | `session-state` | Track decisions in state.yaml; absorbs show-state, reset-state, compact-state, list-epics, check-gates | state.yaml | ✅ Active |
 | 51 | Utility | `migrate-spec` | Migrate foreign spec formats | specs/ | ✅ Active |
-| 52 | Utility | `visual-dashboard` | Browser dashboard | .bigpowers/dashboard/ | ✅ Active |
+| 52 | Utility | `visual-dashboard` | Browser dashboard (HTTP cockpit) | `npm run visual-dashboard` → GET /cockpit.html | ✅ Active |
 | 53 | Utility | `write-document` | BMAD technical documents | specs/<name>.md | ✅ Active |
 | 54 | Utility | `setup-environment` | Pre-install deps before work | (.env, packages) | ✅ Active |
 | 55 | Utility | `reset-baseline` | Restore clean known state | (clean tree) | ✅ Active |

package/dashboard/src/tui/epic-queue.js

@@ -11,6 +11,8 @@ function renderEpicQueue(box, epics, executionStatus) {
   }
 
   let lines = [];
+  lines.push('{bold}EPIC QUEUE{/bold}');
+  lines.push('');
   let totalBcps = 0;
 
   epics.forEach(epic => {

package/dashboard/src/tui/filesystem.js

@@ -15,7 +15,7 @@ function renderFilesystem(box, projectRoot) {
 
   const now = Date.now();
   const lines = [];
-  lines.push('{bold}{cyan}Filesystem{/cyan}{/bold}');
+  lines.push('{bold}FILE SYSTEM{/bold}');
 
   let fileCount = 0;
 

package/dashboard/src/tui/index.js

@@ -9,6 +9,9 @@ const { renderStateYaml } = require('./state-yaml');
 const { renderFilesystem } = require('./filesystem');
 const { renderLedger } = require('./ledger');
 
+// Blessed box defaults — tags must be enabled for markup to render
+const BOX_DEFAULTS = { tags: true };
+
 let blessed;
 try {
   blessed = require('blessed');
@@ -41,6 +44,7 @@ function start(projectRoot) {
       height: 10,
       content: '{center}Terminal must be at least 120x30{/center}\n{center}Please resize and try again{/center}',
       border: 'line',
+      tags: true,
       style: { border: { fg: 'yellow' } }
     });
     screen.render();
@@ -48,75 +52,92 @@ function start(projectRoot) {
   }
 
   // Create layout zones
-  const metricsBar = blessed.box({
+  const titleBar = blessed.box({
     parent: screen,
     top: 0,
     left: 0,
     width: '100%',
+    height: 1,
+    border: 'line',
+    tags: true,
+    style: { border: { fg: 'magenta' } }
+  });
+
+  const metricsBar = blessed.box({
+    parent: screen,
+    top: 1,
+    left: 0,
+    width: '100%',
     height: 3,
     border: 'line',
+    tags: true,
     style: { border: { fg: 'blue' } }
   });
 
   const pipeline = blessed.box({
     parent: screen,
-    top: 3,
+    top: 4,
     left: 0,
     width: '100%',
     height: 5,
     border: 'line',
+    tags: true,
     style: { border: { fg: 'cyan' } }
   });
 
   const epicQueue = blessed.box({
     parent: screen,
-    top: 8,
+    top: 9,
     left: 0,
     width: '33%',
-    height: screen.height - 20,
+    height: screen.height - 21,
     border: 'line',
     scrollable: true,
     mouse: true,
     keys: true,
+    tags: true,
     style: { border: { fg: 'green' } }
   });
 
   const actionLog = blessed.box({
     parent: screen,
-    top: 8,
+    top: 9,
     left: '33%',
     width: '33%',
-    height: screen.height - 20,
+    height: screen.height - 21,
     border: 'line',
     scrollable: true,
     mouse: true,
     keys: true,
+    tags: true,
     style: { border: { fg: 'yellow' } }
   });
 
   const fsPanel = blessed.box({
     parent: screen,
-    top: 8,
+    top: 9,
     left: '66%',
     width: '34%',
-    height: screen.height - 20,
+    height: screen.height - 21,
     border: 'line',
     scrollable: true,
     mouse: true,
     keys: true,
+    tags: true,
     style: { border: { fg: 'magenta' } }
   });
 
   const ledger = blessed.box({
     parent: screen,
-    top: screen.height - 12,
+    top: screen.height - 11,
     left: 0,
     width: '100%',
-    height: 12,
+    height: 11,
     border: 'line',
     scrollable: true,
     mouse: true,
     keys: true,
+    tags: true,
     style: { border: { fg: 'white' } }
   });
 
@@ -128,7 +149,12 @@ function start(projectRoot) {
     const cycleTimes = readCycleTimes(projectRoot);
     const metrics = computeProjectMetrics(cycleTimes);
 
-    renderMetricsBar(metricsBar, metrics, stateData);
+    // Render title bar
+    const epicTitle = stateData?.active_epic || '—';
+    const stepNum = stateData?.epicCycle?.current_step ? (stateData.epicCycle.completed_steps?.length || 0) + 1 : 0;
+    titleBar.setContent(`{bold}{magenta}bigpowers factory{/magenta}{/bold} — ${epicTitle} — step ${stepNum} / 8`);
+
+    renderMetricsBar(metricsBar, metrics, stateData, epics);
     renderPipeline(pipeline, stateData);
     renderEpicQueue(epicQueue, epics, executionStatus);
     renderStateYaml(actionLog, stateData);

package/dashboard/src/tui/metrics-bar.js

@@ -1,9 +1,26 @@
-function renderMetricsBar(box, projectMetrics, stateData) {
+function renderMetricsBar(box, projectMetrics, stateData, epics) {
   if (!box || typeof box.setContent !== 'function') {
     return;
   }
 
-  const totalBcps = projectMetrics?.totalBcps ?? '-';
+  // Count epics and stories
+  let epicCount = 0;
+  let storyCount = 0;
+  let targetBcps = 0;
+
+  if (epics && Array.isArray(epics)) {
+    epicCount = epics.length;
+    epics.forEach(epic => {
+      if (epic.stories && Array.isArray(epic.stories)) {
+        storyCount += epic.stories.length;
+        epic.stories.forEach(story => {
+          targetBcps += story.bcps || 0;
+        });
+      }
+    });
+  }
+
+  const deliveredBcps = projectMetrics?.totalBcps ?? '-';
   const totalMin = projectMetrics?.totalMin ?? '-';
   const avgBcpPerHour = projectMetrics?.avgBcpPerHour ?? '-';
   const version = stateData?.release?.target_version ?? '-';
@@ -22,7 +39,7 @@ function renderMetricsBar(box, projectMetrics, stateData) {
   const avgCycleTime = totalMin === '-' ? '-' : `${totalMin}m`;
   const bcpHrDisplay = typeof avgBcpPerHour === 'number' ? avgBcpPerHour.toFixed(2) : avgBcpPerHour;
 
-  const line = `BCPs: ${totalBcps} | Cycle: ${avgCycleTime} | {${bcpHrColor}}BCP/hr: ${bcpHrDisplay}{/${bcpHrColor}} | v${version}`;
+  const line = `epics: ${epicCount} | stories: ${storyCount} | BCPs: ${deliveredBcps}/${targetBcps} | cycle: ${avgCycleTime} | {${bcpHrColor}}BCP/hr: ${bcpHrDisplay}{/${bcpHrColor}} | v${version}`;
 
   box.setContent(line);
 }

package/dashboard/src/tui/pipeline.js

@@ -13,32 +13,28 @@ function renderPipeline(box, stateData) {
   const currentStep = stateData.epicCycle?.current_step || null;
   const completedSteps = stateData.epicCycle?.completed_steps || [];
 
-  // Build pipeline visualization
-  const lines = [];
-  lines.push('{bold}{cyan}Pipeline{/cyan}{/bold}');
-  lines.push('');
-
-  // Create step display
-  const stepDisplay = STEPS.map((step, index) => {
+  // Build horizontal pipeline strip
+  const steps = STEPS.map((step, index) => {
     const isCompleted = completedSteps.includes(step);
     const isCurrent = step === currentStep;
 
-    let display = `  ${index + 1}. ${step}`;
+    let display = `${index + 1} ${step}`;
 
     if (isCurrent) {
-      display = `{reverse}{bold}${display}{/bold}{/reverse}`;
+      display = `{reverse}${display}{/reverse}`;
     } else if (isCompleted) {
       display = `{green-fg}${display}{/green-fg}`;
     } else {
-      display = `{gray-fg}${display}{/gray-fg}`;
+      display = `{dim}${display}{/dim}`;
     }
 
     return display;
-  }).join('\n');
+  }).join(' {bold}›{/bold} ');
 
-  lines.push(stepDisplay);
+  const lines = [];
+  lines.push(`{bold}{cyan}Pipeline{/cyan}{/bold}  step ${STEPS.indexOf(currentStep) + 1} / ${STEPS.length}`);
   lines.push('');
-  lines.push(`{dim}Current: ${currentStep || '—'}{/dim}`);
+  lines.push(steps);
 
   box.setContent(lines.join('\n'));
 }

package/dashboard/src/tui/state-yaml.js

@@ -9,7 +9,7 @@ function renderStateYaml(box, stateData) {
   }
 
   const lines = [];
-  lines.push('{bold}{cyan}state.yaml{/cyan}{/bold}');
+  lines.push('{bold}CURRENT ACTION{/bold}');
   lines.push('');
 
   const pairs = [

package/orchestrate-project/REFERENCE.md

@@ -23,10 +23,14 @@ Detailed documentation for the `orchestrate-project` meta-skill.
 - **Gate**: Quality (request-review ≥94%) + slopcheck [SUS]/[SLOP].
 
 ### PHASE 4: BUILD
-- **Goal**: Execute the plan step-by-step using TDD and vertical slices.
-- **Deliverables**: Code; `execution-status.yaml` updated per story.
-- **Skills**: `kickoff-branch`, `develop-tdd`, `delegate-task`, `execute-plan`.
-- **Gate**: Integration tests PASS.
+- **Goal**: Execute the plan story-by-story using the 8-step `build-epic` cycle with TDD and vertical slices.
+- **Deliverables**: Code; `execution-status.yaml` updated per story; `specs/metrics/cycle-times.yaml` row per story.
+- **Skills**: `build-epic` (conductor) → per-story: `survey-context`, `plan-work`, `kickoff-branch`, `develop-tdd`, `verify-work`, `audit-code`, `commit-message`, `release-branch`.
+- **BCP tracking**: `plan-work` labels every task `[BCP N]`; total written to `state.yaml` as `epic_cycle.story_bcps`. BCP baseline must exist in `release-plan.yaml` before starting.
+- **Timestamps**: `survey-context` stamps `metrics.story_start`; `release-branch` stamps `metrics.story_end` and writes BCP/hr to `specs/metrics/cycle-times.yaml`.
+- **next_skill**: Each critical-path skill writes `handoff.next_skill` to `state.yaml`. Agents resume by reading `state.yaml` — no guessing.
+- **Dashboard**: `npm run dashboard` (TUI) or `npm run dashboard:web` (browser, port 7742) shows live pipeline, epic queue, BCP metrics, and cycle-time ledger.
+- **Gate**: Integration tests PASS; all 8 build-epic steps completed per story.
 
 ### PHASE 5: VERIFY
 - **Goal**: Validate success criteria and ensure production readiness.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigpowers",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "61 agent skills for spec-driven, test-first software development by solo developers",
   "main": "index.js",
   "scripts": {

package/seed-conventions/SKILL.md

@@ -203,7 +203,7 @@ touch specs/tech-architecture/design.md
 touch specs/tech-architecture/REFACTOR_LATEST.md
 touch specs/tech-architecture/IMPACT_LATEST.md
 touch specs/bugs/registry.yaml
-echo "# Specs\n\nAll planning documents for this project. Evolved bigpowers structure (v4.0.0+)." > specs/README.md
+echo "# Specs\n\nAll planning documents for this project. Evolved bigpowers structure (v2.0.0+)." > specs/README.md
 ```
 
 **Note:** `specs/state.yaml.lock` is NOT pre-created — it is acquired and released dynamically during writes to prevent concurrency conflicts.