bigpowers 1.5.1 → 2.0.1

package/run-evals/SKILL.md

@@ -20,8 +20,8 @@ model: sonnet
 
 ## Artefact
 
-`specs/EVALS-<feature>.md` — see [REFERENCE.md](REFERENCE.md) for template.
+`specs/verifications/eNNsYY-eval-report.md` — see [REFERENCE.md](REFERENCE.md) for template. Eval reports are stored alongside verification evidence in `specs/verifications/`, keyed by story ID for traceability.
 
 ## Verify
 
-→ verify: `ls specs/EVALS-*.md 2>/dev/null | head -1 | grep -q EVALS && echo OK || echo MISSING`
+→ verify: `find specs/verifications -name "*-eval-report.md" | wc -l | awk '{if($1>0) print "OK: "$1" eval reports"; else print "MISSING"}'`

package/run-planning/SKILL.md

@@ -5,7 +5,7 @@ description: Advance discover-phase workflows and update specs/planning-status.y
 ---
 
 # Run Planning
-> **HARD GATE** — **HARD GATE** — Before running planning skills, confirm the epic shard exists and the active story is clear. Planning without a target is noise.
+> **HARD GATE** — **HARD GATE** — Before running planning skills, confirm the epic capsule exists and the active story is clear. Planning without a target is noise.
 
 
 Updates `specs/planning-status.yaml` as discover-phase skills complete.

package/scope-work/SKILL.md

@@ -1,22 +1,22 @@
 ---
 name: scope-work
-description: Define what is in and out of scope for the current effort and save as specs/requirements/SCOPE_LATEST.yaml. Use when user wants a PRD, scope definition, or before plan-release on a new initiative.
+description: Define what is in and out of scope for the current effort and save as specs/product/SCOPE_LATEST.yaml. Use when user wants a PRD, scope definition, or before plan-release on a new initiative.
 model: sonnet
 ---
 
 # Scope Work
 
-Turn the current conversation into a bounded PRD at `specs/requirements/SCOPE_LATEST.yaml`.
+Turn the current conversation into a bounded PRD at `specs/product/SCOPE_LATEST.yaml`.
 
 ## Process
 
 1. Read existing `specs/` artifacts (`release-plan.yaml`, `plans/TECH_STACK_LATEST.md`, `requirements/VISION_LATEST.yaml` if any).
 2. Interview (if needed): goal, users, in-scope, out-of-scope, constraints, success metrics.
-3. Write `specs/requirements/SCOPE_LATEST.yaml` with: `core_value`, `summary`, `in_scope[]`, `out_of_scope[]`, `constraints`, `success_criteria`, `references`.
+3. Write `specs/product/SCOPE_LATEST.yaml` with: `core_value`, `summary`, `in_scope[]`, `out_of_scope[]`, `constraints`, `success_criteria`, `references`.
 4. Run `research-first` if external dependencies are proposed.
 
 > **HARD GATE** — Every `in_scope` item must map to a future epic/story ID or explicit deferred note in `out_of_scope`.
 
 ## Verify
 
-→ verify: `test -f specs/requirements/SCOPE_LATEST.yaml && grep -c 'out_of_scope' specs/requirements/SCOPE_LATEST.yaml | awk '{if($1>0) print "OK"; else print "MISSING"}'`
+→ verify: `test -f specs/product/SCOPE_LATEST.yaml && grep -c 'out_of_scope' specs/product/SCOPE_LATEST.yaml | awk '{if($1>0) print "OK"; else print "MISSING"}'`

package/scripts/land-branch.sh

@@ -143,6 +143,34 @@ if git remote get-url origin >/dev/null 2>&1; then
   git push origin "$DEFAULT_BRANCH"
 fi
 
+# Epic capsule archival (evolved bigpowers v4.0.0+)
+# Move completed epic capsules to archive when all stories are done
+echo "==> Checking for completed epic capsules to archive..."
+if [ -d specs/epics ] && [ -f specs/execution-status.yaml ]; then
+  for capsule in specs/epics/e[0-9]*-*/; do
+    [ -d "$capsule" ] || continue
+    capsule_name=$(basename "$capsule")
+    epic_id=$(echo "$capsule_name" | grep -o '^e[0-9]*' || true)
+    [ -n "$epic_id" ] || continue
+    # Check if all stories in this epic are done
+    ALL_DONE=true
+    if [ -f "$capsule/epic.yaml" ]; then
+      for story_id in $(grep -o 'e[0-9]*s[0-9]*' "$capsule/epic.yaml" 2>/dev/null || true); do
+        STATUS=$(grep "$story_id:" specs/execution-status.yaml 2>/dev/null | awk '{print $2}' || echo "todo")
+        if [ "$STATUS" != "done" ]; then
+          ALL_DONE=false
+          break
+        fi
+      done
+    fi
+    if [ "$ALL_DONE" = true ]; then
+      mkdir -p specs/epics/archive
+      echo "  Archiving completed epic: $capsule_name → specs/epics/archive/"
+      mv "$capsule" "specs/epics/archive/"
+    fi
+  done
+fi
+
 # Worktree cleanup
 WORKTREE_PATH="../$FEATURE_BRANCH"
 if git worktree list --porcelain 2>/dev/null | grep -q "^worktree $WORKTREE_PATH$"; then

package/seed-conventions/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: seed-conventions
 model: sonnet
-description: Generate CLAUDE.md and CONVENTIONS.md for a brand-new project through a brief interview, and create the specs/ directory. Entry point for greenfield projects. Use when starting a new project from scratch, when user asks to set up AI agent conventions, or when there is no CLAUDE.md yet.
+description: Generate CLAUDE.md and CONVENTIONS.md for a brand-new project through a brief interview, and create the specs/ directory with evolved bigpowers structure (product/, tech-architecture/, verifications/, epics/archive/). Entry point for greenfield projects. Use when starting a new project from scratch, when user asks to set up AI agent conventions, or when there is no CLAUDE.md yet.
 ---
 
 # Seed Conventions
@@ -75,7 +75,7 @@ Stack: [language, framework, runtime]
 ## Agent Rules
 - **Workflow Mandate:** You MUST use the bigpowers skills (e.g. `plan-work`, `develop-tdd`, `orchestrate-project`) to perform tasks. DO NOT write code directly in response to a user prompt like "build this feature".
 - Read specs/ before writing code.
-- All planning and specifications MUST be written to `specs/` (`requirements/SCOPE_LATEST.yaml`, `release-plan.yaml`, `epics/`) before any code is generated.
+- All planning and specifications MUST be written to `specs/` (`product/SCOPE_LATEST.yaml`, `release-plan.yaml`, `epics/`) before any code is generated.
 - Write the minimum code that solves the stated problem. Nothing extra.
 - Never refactor, rename, or reorganize code outside the task scope.
 - Run tests after every change. Show evidence before declaring done.
@@ -115,7 +115,7 @@ Stack: [language, framework, runtime]
 ## Agent Rules
 - **Workflow Mandate:** You MUST use the bigpowers skills (e.g. `plan-work`, `develop-tdd`, `orchestrate-project`) to perform tasks. DO NOT write code directly in response to a user prompt like "build this feature".
 - Read specs/ before writing code.
-- All planning and specifications MUST be written to `specs/` (`requirements/SCOPE_LATEST.yaml`, `release-plan.yaml`, `epics/`) before any code is generated.
+- All planning and specifications MUST be written to `specs/` (`product/SCOPE_LATEST.yaml`, `release-plan.yaml`, `epics/`) before any code is generated.
 - Write the minimum code that solves the stated problem. Nothing extra.
 - Never refactor, rename, or reorganize code outside the task scope.
 - Run tests after every change. Show evidence before declaring done.
@@ -155,7 +155,7 @@ Stack: [language, framework, runtime]
 ## Agent Rules
 - **Workflow Mandate:** You MUST use the bigpowers skills (e.g. `plan-work`, `develop-tdd`, `orchestrate-project`) to perform tasks. DO NOT write code directly in response to a user prompt like "build this feature".
 - Read specs/ before writing code.
-- All planning and specifications MUST be written to `specs/` (`requirements/SCOPE_LATEST.yaml`, `release-plan.yaml`, `epics/`) before any code is generated.
+- All planning and specifications MUST be written to `specs/` (`product/SCOPE_LATEST.yaml`, `release-plan.yaml`, `epics/`) before any code is generated.
 - Write the minimum code that solves the stated problem. Nothing extra.
 - Never refactor, rename, or reorganize code outside the task scope.
 - Run tests after every change. Show evidence before declaring done.
@@ -177,14 +177,45 @@ Use the standard bigpowers CONVENTIONS.md template, filling in the project-speci
 
 ### `specs/` directory
 
+Create the evolved bigpowers directory structure:
+
 ```bash
-mkdir -p specs
-echo "# Specs\n\nAll planning documents for this project." > specs/README.md
+mkdir -p specs/product
+mkdir -p specs/product/snapshots
+mkdir -p specs/epics/archive
+mkdir -p specs/tech-architecture
+mkdir -p specs/adr
+mkdir -p specs/verifications
+mkdir -p specs/bugs
+
+# Create empty placeholder files
+touch specs/product/SCOPE_LATEST.yaml
+touch specs/product/VISION_LATEST.yaml
+touch specs/product/GLOSSARY_LATEST.yaml
+touch specs/release-plan.yaml
+touch specs/execution-status.yaml
+touch specs/planning-status.yaml
+touch specs/state.yaml
+touch specs/tech-architecture/tech-stack.md
+touch specs/tech-architecture/security.md
+touch specs/tech-architecture/test.md
+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 (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.
+
 ### Verify
 
 - [ ] CLAUDE.md exists and is populated
 - [ ] CONVENTIONS.md exists and includes specs/ output convention
 - [ ] specs/ directory exists
+- [ ] specs/product/ exists with SCOPE_LATEST.yaml, VISION_LATEST.yaml, GLOSSARY_LATEST.yaml
+- [ ] specs/tech-architecture/ exists with tech-stack.md, security.md, test.md, design.md
+- [ ] specs/verifications/ exists
+- [ ] specs/epics/archive/ exists
+- [ ] specs/bugs/registry.yaml exists
 - [ ] Confirm with user: "Does CLAUDE.md accurately describe your project?"

package/session-state/SKILL.md

@@ -12,7 +12,7 @@ Track the current state of implementation, including decisions made, pending tas
 
 ## Goal
 
-Maintain a single source of truth for the *current* session in `specs/state.yaml`. This complements long-term docs in `specs/plans/` and delivery detail in `specs/epics/` + `specs/release-plan.yaml`.
+Maintain a single source of truth for the *current* session in `specs/state.yaml`. This complements long-term docs in `specs/tech-architecture/` and delivery detail in `specs/epics/` + `specs/release-plan.yaml`.
 
 Legacy markdown (`specs/archive/STATE.md`, `RELEASE-PLAN.md`) is **not** SoT when YAML exists — use `specs/state.yaml` only.
 
@@ -45,7 +45,7 @@ handoff:
 
 If `specs/state.yaml` does not exist, or if starting a new major phase:
 
-- [ ] Read `specs/release-plan.yaml` and `specs/requirements/SCOPE_LATEST.yaml`.
+- [ ] Read `specs/release-plan.yaml` and `specs/product/SCOPE_LATEST.yaml`.
 - [ ] Get git metadata: `git branch --show-current` and `git rev-parse --short HEAD`.
 - [ ] Create `specs/state.yaml` with active flow, git, handoff, and epic cycle if in build.
 
@@ -68,6 +68,32 @@ Whenever a significant decision is made or a milestone is reached:
 
 → verify: `bash scripts/validate-specs-yaml.sh`
 
+## State Write-Lock Protocol
+
+> **HARD GATE** — Before any write to `specs/state.yaml` or `specs/execution-status.yaml`, acquire `specs/state.yaml.lock`. Release it immediately after the write. A stale lock (>60s) may be force-released.
+
+### Acquire
+
+1. Check if `specs/state.yaml.lock` exists.
+2. If it exists, read the agent ID and timestamp inside.
+3. If the lock is stale (>60s old), remove it and proceed.
+4. If the lock is fresh (<60s), wait 2s and retry (max 15 attempts = 30s).
+5. Write `agent_id: <name>\nacquired_at: <ISO-8601>` to `specs/state.yaml.lock`.
+
+### Release
+
+1. After the write to `state.yaml` or `execution-status.yaml` completes:
+2. `rm specs/state.yaml.lock`
+
+### Lock format (`specs/state.yaml.lock`)
+
+```yaml
+agent_id: session-state
+acquired_at: "2026-06-11T14:30:00Z"
+```
+
+
+
 ## Operations
 
 ### show-state (absorbed)
@@ -80,7 +106,12 @@ Clear ephemeral session state. Set `active_epic_id`, `active_story_id`, and `epi
 
 ### compact-state (absorbed)
 
-Archive verbose decisions before a context transition. Move all entries from `handoff.open_decisions` to `specs/adr/` as individual ADR files, then reset `handoff.open_decisions` to an empty list.
+Archive verbose decisions before a context transition. Move all entries from `handoff.open_decisions` to their appropriate location:
+
+- **System-wide decisions** → `specs/adr/NNNN-slug.md` (global Architectural Decision Records)
+- **Epic-scoped decisions** → `specs/epics/<active_epic_id>-<slug>/adr/NNNN-slug.md` (epic-local ADRs, archived with epic)
+
+After archiving, reset `handoff.open_decisions` to an empty list.
 
 ## File Format: specs/state.yaml
 

package/slice-tasks/SKILL.md

@@ -6,17 +6,17 @@ model: sonnet
 
 # Slice Tasks
 
-Produce **epic shard stories** in `specs/epics/eNN-*.yaml` — vertical slices, each independently deliverable and testable. Legacy `specs/epics/ (see slice-tasks)` is deprecated; use epics + `execution-status.yaml`.
+Produce **epic capsule story tasks** in `specs/epics/eNN-slug/` — vertical slices, each independently deliverable and testable. Output: decoupled `eNNsYY-tasks.yaml` files with runnable verify commands. Legacy `specs/epics/ (see slice-tasks)` is deprecated; use capsule dirs + `execution-status.yaml`.
 
 ## Process
 
-1. Read `specs/requirements/SCOPE_LATEST.yaml` and/or `specs/release-plan.yaml`.
+1. Read `specs/product/SCOPE_LATEST.yaml` and/or `specs/release-plan.yaml`.
 2. Cut **tracer-bullet slices** (thin end-to-end paths first, then depth).
-3. Each story: `id` (e.g. `e03s01`), `title`, optional `depends-on` in task desc, `tasks[]` with `desc` + `verify`.
+3. Each story: writes `eNNsYY-tasks.yaml` with `story_id`, `title`, `status`, `bcps`, `tasks[]` (each with `id`, `description`, `verify`, `status`). Story spec `.md` files are written by `plan-work` and follow [countable-story-format.md](file:///Users/danielvm/Developer/bigpowers/countable-story-format.md).
 4. Order by WSJF in `release-plan.yaml` epic list.
 
 > **HARD GATE** — No horizontal-only slices ("add all models") without a vertical path that proves integration.
 
 ## Verify
 
-→ verify: `grep -c 'id: e' specs/epics/*.yaml | awk '{if($1>0) print "OK"; else print "MISSING"}'`
+→ verify: `find specs/epics -name "*-tasks.yaml" | wc -l | awk '{if($1>0) print "OK: "$1" task files"; else print "MISSING"}'`

package/survey-context/SKILL.md

@@ -67,7 +67,7 @@ Based on what you've found, identify which PMBOK phase this project is currently
 | **Design** | SCOPE exists but no `release-plan.yaml` |
 | **Plan** | `release-plan.yaml` exists; on `main`/`master` branch |
 | **Initiate** | On a feature branch; no code changes yet |
-| **Execute** | `state.yaml` `active_flow: build_epic`; epic shard in progress |
+| **Execute** | `state.yaml` `active_flow: build_epic`; epic capsule in progress |
 | **Verify** | Implementation done; run `verify-work` or `run-evals` |
 | **Bug** | `state.yaml` `active_flow: fix_bug` or open `specs/bugs/BUG-*.md` |
 | **Review** | All code written; no PR yet |
@@ -116,7 +116,7 @@ At story start, write `metrics.story_start` with the current ISO 8601 timestamp
 
 ### list-epics (absorbed)
 
-Loop through all `specs/epics/*.yaml` files and print a summary of story counts per epic. Useful for understanding overall project scope and epic distribution.
+Loop through all `specs/epics/*/epic.yaml` files and print a summary of story counts per epic. Useful for understanding overall project scope and epic distribution.
 
 ### check-gates (absorbed)
 

package/trace-requirement/SKILL.md

@@ -1,20 +1,20 @@
 ---
 name: trace-requirement
 model: haiku
-description: Link story IDs from specs/release-plan.yaml + epic shards to the implementing code and tests. Produces specs/TRACEABILITY.md. Use when you want to verify coverage of a release plan, audit which stories are implemented, or find "dark" stories with no code.
+description: Link story IDs from specs/release-plan.yaml + epic capsule directories to the implementing code and tests. Produces specs/TRACEABILITY.md. Use when you want to verify coverage of a release plan, audit which stories are implemented, or find "dark" stories with no code.
 ---
 
 # Trace Requirement
 
-Build a traceability matrix from `specs/release-plan.yaml + epic shards` to implementing code and tests. Surfaces gaps in both directions: stories with no code, and code with no story.
+Build a traceability matrix from `specs/release-plan.yaml + epic capsule directories` to implementing code and tests. Surfaces gaps in both directions: stories with no code, and code with no story.
 
 ## Pre-flight
 
-> **HARD GATE** — `specs/release-plan.yaml + epic shards` must exist. If it doesn't, run `plan-release` first.
+> **HARD GATE** — `specs/release-plan.yaml + epic capsule directories` must exist. If it doesn't, run `plan-release` first.
 
-→ verify: `[ -f specs/release-plan.yaml + epic shards ] && echo "ready" || echo "BLOCKED: run plan-release first"`
+→ verify: `[ -f specs/release-plan.yaml + epic capsule directories ] && echo "ready" || echo "BLOCKED: run plan-release first"`
 
-Read `specs/release-plan.yaml + epic shards` fully before proceeding.
+Read `specs/release-plan.yaml + epic capsule directories` fully before proceeding.
 
 ## Process
 
@@ -22,7 +22,7 @@ Read `specs/release-plan.yaml + epic shards` fully before proceeding.
 
 From release-plan.yaml, collect all story IDs (e.g. `1.1`, `1.2`, `2.1`).
 
-→ verify: `grep -o "Story [0-9]\+\.[0-9]\+" specs/release-plan.yaml + epic shards | sort -u`
+→ verify: `grep -o "Story [0-9]\+\.[0-9]\+" specs/release-plan.yaml + epic capsule directories | sort -u`
 
 ### 2. Search for story tags in code
 

package/verify-work/SKILL.md

@@ -21,7 +21,7 @@ Review answers "is the code good?"; Verify answers "does the built thing do what
 
 0. **Branch check** — must not be `main`/`master`.
 
-1. Read active story tasks and any **Verification Script** notes in `specs/epics/{active}.yaml` or story `.md` under `specs/epics/eNN/stories/`.
+1. Read active story tasks from `specs/epics/<capsule>/eNNsYY-tasks.yaml` and story spec from `specs/epics/<capsule>/eNNsYY-<slug>.md` (countable-story-format, Gherkin in §17).
 2. **Cold-start smoke** (if app): stop server, clear caches, boot from scratch.
 3. Mechanical gates: build → typecheck → lint → tests (from `CLAUDE.md`).
 4. **Step-by-step UAT** — one user-observable action at a time.
@@ -55,9 +55,42 @@ After UAT, identify and close any gaps between promised behavior and actual beha
 - Pass: user confirms per step.
 - Fail: capture expected vs actual; do not mark done in `execution-status.yaml`.
 
+## Persist verification evidence
+
+After UAT passes, write structured evidence to `specs/verifications/eNNsYY-verify.yaml`:
+
+```yaml
+story_id: e01s01
+verified_at: "2026-06-11T14:30:00Z"
+verifier: verify-work
+phases:
+  smoke:
+    passed: true
+  build:
+    passed: true
+    command: "npm run build"
+  typecheck:
+    passed: true
+  lint:
+    passed: true
+  tests:
+    passed: true
+    coverage: "94.2%"
+  manual:
+    steps:
+      - step: "Open /login"
+        expected: "Login form renders"
+        actual: "Login form rendered correctly"
+        passed: true
+  gaps:
+    closed: true
+```
+
+> **HARD GATE** — Verification evidence MUST be persisted before marking the story done. No evidence = not verified.
+
 ## Verify
 
-→ verify: `grep -c 'verify:' specs/epics/*.yaml | awk '{if($1>0) print "OK"; else print "MISSING"}'`
+→ verify: `test -f specs/verifications/<story_id>-verify.yaml && echo "Evidence persisted"`
 
 See [REFERENCE.md](REFERENCE.md) for cold-start and gaps template.
 

package/write-document/SKILL.md

@@ -25,7 +25,7 @@ Create high-signal technical documentation that serves as an expert collaborator
 
 Choose the correct BMAD-BigPowers artifact:
 - **Decision Record (ADR)**: For "Why" decisions (saved to `specs/adr/`).
-- **Context Map**: For system-wide architectural mapping (`specs/plans/TECH_STACK_LATEST.md`).
+- **Context Map**: For system-wide architectural mapping (`specs/tech-architecture/tech-stack.md`).
 - **Technical Guide**: For "How-to" with verification (saved to `<module>/REFERENCE.md`).
 - **Behavioral Feature**: Gherkin-style compliance specs (saved to `specs/audit/features/`).
 - **Project README**: Project-facing documentation (saved to `README.md` at project root).

package/dashboard/src/data/gate-status.js

@@ -1,32 +0,0 @@
-const COLOR_MAP = {
-  ready: 'green',
-  blocked: 'red',
-  in_progress: 'yellow',
-  done: 'green',
-  pending: 'dim',
-  active: 'cyan'
-};
-
-const ICON_MAP = {
-  ready: '●',
-  blocked: '✕',
-  in_progress: '◐',
-  done: '✓',
-  pending: '○',
-  active: '◐'
-};
-
-function gateColor(gateStatus) {
-  return COLOR_MAP[gateStatus] || 'dim';
-}
-
-function gateIcon(gateStatus) {
-  return ICON_MAP[gateStatus] || '-';
-}
-
-module.exports = {
-  gateColor,
-  gateIcon,
-  COLOR_MAP,
-  ICON_MAP
-};

package/dashboard/src/data/metrics.js

@@ -1,89 +0,0 @@
-/**
- * computeEpicMetrics(cycleTimes)
- * Groups cycle times by epic prefix (e.g. e01 from e01s01)
- * Returns Map of epicId to { avgCycleMin, totalBcps, avgBcpPerHour }
- */
-function computeEpicMetrics(cycleTimes) {
-  if (!cycleTimes || cycleTimes.length === 0) {
-    return new Map();
-  }
-
-  const epicMap = new Map();
-  for (const story of cycleTimes) {
-    // Extract epic prefix: e01s01 -> e01
-    const epicId = story.id ? story.id.replace(/s\d+$/, '') : null;
-    if (!epicId) continue;
-
-    if (!epicMap.has(epicId)) {
-      epicMap.set(epicId, { stories: [] });
-    }
-    epicMap.get(epicId).stories.push(story);
-  }
-
-  const result = new Map();
-  for (const [epicId, data] of epicMap) {
-    const stories = data.stories;
-    const totalBcps = stories.reduce((sum, s) => sum + (s.bcps || 0), 0);
-    const totalMin = stories.reduce((sum, s) => sum + (s.cycleMin || 0), 0);
-    const avgCycleMin = stories.length > 0 ? totalMin / stories.length : 0;
-    const avgBcpPerHour = totalMin > 0 ? (totalBcps * 60) / totalMin : 0;
-
-    result.set(epicId, {
-      avgCycleMin,
-      totalBcps,
-      avgBcpPerHour
-    });
-  }
-
-  return result;
-}
-
-/**
- * computeProjectMetrics(cycleTimes)
- * Returns { totalBcps, totalMin, avgBcpPerHour } or null if no data
- */
-function computeProjectMetrics(cycleTimes) {
-  if (!cycleTimes || cycleTimes.length === 0) {
-    return null;
-  }
-
-  const totalBcps = cycleTimes.reduce((sum, s) => sum + (s.bcps || 0), 0);
-  const totalMin = cycleTimes.reduce((sum, s) => sum + (s.cycleMin || 0), 0);
-  const avgBcpPerHour = totalMin > 0 ? (totalBcps * 60) / totalMin : 0;
-
-  return {
-    totalBcps,
-    totalMin,
-    avgBcpPerHour
-  };
-}
-
-/**
- * computeCurrentVelocity(cycleTimes, windowStories=3)
- * Rolling average of last N stories
- * Returns { avgBcpPerHour, avgCycleMin } or null if no data
- */
-function computeCurrentVelocity(cycleTimes, windowStories = 3) {
-  if (!cycleTimes || cycleTimes.length === 0) {
-    return null;
-  }
-
-  const window = Math.min(windowStories, cycleTimes.length);
-  const recentStories = cycleTimes.slice(-window);
-
-  const totalBcps = recentStories.reduce((sum, s) => sum + (s.bcps || 0), 0);
-  const totalMin = recentStories.reduce((sum, s) => sum + (s.cycleMin || 0), 0);
-  const avgCycleMin = recentStories.length > 0 ? totalMin / recentStories.length : 0;
-  const avgBcpPerHour = totalMin > 0 ? (totalBcps * 60) / totalMin : 0;
-
-  return {
-    avgBcpPerHour,
-    avgCycleMin
-  };
-}
-
-module.exports = {
-  computeEpicMetrics,
-  computeProjectMetrics,
-  computeCurrentVelocity
-};

package/dashboard/src/data/pipeline-map.js

@@ -1,32 +0,0 @@
-const STEPS = [
-  'survey-context',
-  'plan-work',
-  'kickoff-branch',
-  'develop-tdd',
-  'verify-work',
-  'audit-code',
-  'commit-message',
-  'release-branch'
-];
-
-function stepIndex(currentStep) {
-  return STEPS.indexOf(currentStep);
-}
-
-function stepLabel(index) {
-  if (index < 0 || index >= STEPS.length) {
-    return '-';
-  }
-  return STEPS[index];
-}
-
-function allSteps() {
-  return [...STEPS];
-}
-
-module.exports = {
-  stepIndex,
-  stepLabel,
-  allSteps,
-  STEPS
-};

package/dashboard/src/data/reader.js

@@ -1,122 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-
-/**
- * readStateYaml(projectRoot)
- * Reads specs/state.yaml and returns an object with mapped fields
- * Returns null if file doesn't exist
- */
-function readStateYaml(projectRoot) {
-  try {
-    const filePath = path.join(projectRoot, 'specs', 'state.yaml');
-    if (!fs.existsSync(filePath)) {
-      return null;
-    }
-    const content = fs.readFileSync(filePath, 'utf8');
-    const data = yaml.load(content);
-    return {
-      activeFlow: data.active_flow || null,
-      activeEpic: data.active_epic_id || null,
-      activeStory: data.active_story_id || null,
-      epicCycle: data.epic_cycle || {},
-      gitBranch: data.git?.branch || null,
-      metrics: data.metrics || null,
-      release: data.release || {},
-      handoff: data.handoff || {}
-    };
-  } catch (err) {
-    return null;
-  }
-}
-
-/**
- * readExecutionStatus(projectRoot)
- * Reads specs/execution-status.yaml and returns { epics: Map }
- * Map keys are story/epic IDs, values are status strings
- * Returns null if file doesn't exist
- */
-function readExecutionStatus(projectRoot) {
-  try {
-    const filePath = path.join(projectRoot, 'specs', 'execution-status.yaml');
-    if (!fs.existsSync(filePath)) {
-      return null;
-    }
-    const content = fs.readFileSync(filePath, 'utf8');
-    const data = yaml.load(content);
-    const statusMap = new Map();
-    const devStatus = data.development_status || {};
-    for (const [key, value] of Object.entries(devStatus)) {
-      statusMap.set(key, value);
-    }
-    return { epics: statusMap };
-  } catch (err) {
-    return null;
-  }
-}
-
-/**
- * readEpicShards(projectRoot)
- * Reads all files in specs/epics/*.yaml
- * Returns array of { id, title, stories } objects or null
- */
-function readEpicShards(projectRoot) {
-  try {
-    const epicsDir = path.join(projectRoot, 'specs', 'epics');
-    if (!fs.existsSync(epicsDir)) {
-      return null;
-    }
-    const files = fs.readdirSync(epicsDir)
-      .filter(f => f.endsWith('.yaml'))
-      .sort();
-
-    const epics = [];
-    for (const file of files) {
-      const filePath = path.join(epicsDir, file);
-      const content = fs.readFileSync(filePath, 'utf8');
-      const data = yaml.load(content);
-      epics.push({
-        id: data.id || null,
-        title: data.title || null,
-        stories: data.stories || []
-      });
-    }
-    return epics.length > 0 ? epics : null;
-  } catch (err) {
-    return null;
-  }
-}
-
-/**
- * readCycleTimes(projectRoot)
- * Reads specs/metrics/cycle-times.yaml stories array
- * Returns array of { id, bcps, start, end, cycleMin, bcpPerHour } or null
- */
-function readCycleTimes(projectRoot) {
-  try {
-    const filePath = path.join(projectRoot, 'specs', 'metrics', 'cycle-times.yaml');
-    if (!fs.existsSync(filePath)) {
-      return null;
-    }
-    const content = fs.readFileSync(filePath, 'utf8');
-    const data = yaml.load(content);
-    const stories = data.stories || [];
-    return stories.map(s => ({
-      id: s.id || null,
-      bcps: s.bcps || 0,
-      start: s.start || null,
-      end: s.end || null,
-      cycleMin: s.cycle_min || 0,
-      bcpPerHour: s.bcp_per_hour || 0
-    }));
-  } catch (err) {
-    return null;
-  }
-}
-
-module.exports = {
-  readStateYaml,
-  readExecutionStatus,
-  readEpicShards,
-  readCycleTimes
-};