npm - bigpowers - Versions diffs - 1.3.1 → 1.4.0 - Mend

bigpowers 1.3.1 → 1.4.0

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 (71) hide show

package/CHANGELOG.md +14 -0
package/SKILL-INDEX.md +9 -9
package/audit-code/SKILL.md +12 -0
package/build-epic/SKILL.md +7 -4
package/commit-message/SKILL.md +12 -0
package/compose-workflow/SKILL.md +2 -0
package/dashboard/bin/dashboard.js +93 -0
package/dashboard/package-lock.json +1035 -0
package/dashboard/package.json +18 -0
package/dashboard/src/data/gate-status.js +32 -0
package/dashboard/src/data/metrics.js +89 -0
package/dashboard/src/data/pipeline-map.js +32 -0
package/dashboard/src/data/reader.js +122 -0
package/dashboard/src/data/watcher.js +108 -0
package/dashboard/src/loaders/gate-status.js +32 -0
package/dashboard/src/loaders/metrics.js +89 -0
package/dashboard/src/loaders/pipeline-map.js +32 -0
package/dashboard/src/loaders/reader.js +122 -0
package/dashboard/src/loaders/watcher.js +108 -0
package/dashboard/src/tui/epic-queue.js +36 -0
package/dashboard/src/tui/filesystem.js +95 -0
package/dashboard/src/tui/index.js +161 -0
package/dashboard/src/tui/ledger.js +66 -0
package/dashboard/src/tui/metrics-bar.js +30 -0
package/dashboard/src/tui/pipeline.js +46 -0
package/dashboard/src/tui/state-yaml.js +49 -0
package/dashboard/src/web/client.html +477 -0
package/dashboard/src/web/server.js +112 -0
package/dashboard/test/fixtures/state.yaml +2 -0
package/deepen-architecture/SKILL.md +2 -0
package/define-language/SKILL.md +2 -0
package/define-success/SKILL.md +4 -0
package/delegate-task/SKILL.md +2 -0
package/design-interface/SKILL.md +2 -0
package/develop-tdd/SKILL.md +32 -0
package/dispatch-agents/SKILL.md +2 -0
package/edit-document/SKILL.md +6 -0
package/elaborate-spec/SKILL.md +2 -0
package/enforce-first/SKILL.md +2 -0
package/grill-me/SKILL.md +2 -0
package/guard-git/SKILL.md +2 -0
package/hook-commits/SKILL.md +2 -0
package/inspect-quality/SKILL.md +2 -0
package/kickoff-branch/SKILL.md +5 -0
package/map-codebase/SKILL.md +2 -0
package/model-domain/SKILL.md +4 -0
package/orchestrate-project/REFERENCE.md +1 -1
package/orchestrate-project/SKILL.md +3 -1
package/organize-workspace/SKILL.md +2 -0
package/package.json +4 -2
package/plan-refactor/SKILL.md +2 -0
package/plan-work/SKILL.md +44 -0
package/release-branch/SKILL.md +28 -0
package/respond-review/SKILL.md +2 -0
package/run-planning/SKILL.md +2 -0
package/scripts/sync-bugs-registry.sh +16 -10
package/scripts/sync-skills.sh +19 -0
package/search-skills/SKILL.md +2 -0
package/seed-conventions/SKILL.md +2 -0
package/session-state/SKILL.md +16 -0
package/setup-environment/SKILL.md +2 -0
package/simulate-agents/SKILL.md +2 -0
package/spike-prototype/SKILL.md +2 -0
package/stocktake-skills/SKILL.md +2 -0
package/survey-context/SKILL.md +23 -0
package/terse-mode/SKILL.md +2 -0
package/using-bigpowers/SKILL.md +4 -0
package/validate-fix/SKILL.md +2 -0
package/verify-work/SKILL.md +33 -0
package/visual-dashboard/SKILL.md +2 -0
package/wire-observability/SKILL.md +2 -0

package/dashboard/src/web/client.html ADDED Viewed

@@ -0,0 +1,477 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>BigPowers Dashboard</title>
+  <style>
+    * {
+      margin: 0;
+      padding: 0;
+      box-sizing: border-box;
+    }
+    body {
+      background: #0d1117;
+      color: #c9d1d9;
+      font-family: 'Monaco', 'Menlo', 'Ubuntu Mono', monospace;
+      font-size: 12px;
+      line-height: 1.6;
+      padding: 16px;
+    }
+    .container {
+      max-width: 1400px;
+      margin: 0 auto;
+    }
+    h1 {
+      font-size: 20px;
+      margin-bottom: 24px;
+      color: #58a6ff;
+      border-bottom: 2px solid #30363d;
+      padding-bottom: 8px;
+    }
+    .grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
+      gap: 16px;
+      margin-bottom: 16px;
+    }
+    .panel {
+      background: #161b22;
+      border: 1px solid #30363d;
+      border-radius: 6px;
+      padding: 16px;
+    }
+    .panel h2 {
+      font-size: 14px;
+      margin-bottom: 12px;
+      color: #79c0ff;
+      border-bottom: 1px solid #30363d;
+      padding-bottom: 8px;
+    }
+    .metric-row {
+      display: flex;
+      justify-content: space-between;
+      padding: 6px 0;
+      border-bottom: 1px solid #21262d;
+    }
+    .metric-row:last-child {
+      border-bottom: none;
+    }
+    .metric-label {
+      color: #8b949e;
+    }
+    .metric-value {
+      color: #79c0ff;
+      font-weight: bold;
+    }
+    .step-container {
+      display: flex;
+      gap: 8px;
+      flex-wrap: wrap;
+    }
+    .step {
+      flex: 1;
+      min-width: 80px;
+      padding: 8px;
+      background: #21262d;
+      border: 1px solid #30363d;
+      border-radius: 4px;
+      text-align: center;
+      font-size: 10px;
+      color: #8b949e;
+      transition: all 0.2s ease;
+    }
+    .step.active {
+      background: #238636;
+      border-color: #2ea043;
+      color: #aff5b4;
+      font-weight: bold;
+    }
+    .step-label {
+      display: block;
+      margin-bottom: 4px;
+      word-break: break-word;
+    }
+    .state-pairs {
+      display: flex;
+      flex-direction: column;
+      gap: 8px;
+    }
+    .state-pair {
+      display: flex;
+      flex-direction: column;
+    }
+    .state-key {
+      color: #8b949e;
+      font-size: 11px;
+    }
+    .state-value {
+      color: #79c0ff;
+      word-break: break-all;
+      margin-top: 2px;
+    }
+    .ledger-row {
+      padding: 6px 0;
+      border-bottom: 1px solid #21262d;
+      display: flex;
+      justify-content: space-between;
+    }
+    .ledger-row:last-child {
+      border-bottom: none;
+    }
+    .ledger-id {
+      color: #8b949e;
+      min-width: 60px;
+    }
+    .ledger-value {
+      color: #79c0ff;
+      font-weight: bold;
+    }
+    .ledger-meta {
+      color: #6e7681;
+      font-size: 10px;
+      margin-top: 2px;
+    }
+    .epic-item {
+      padding: 8px;
+      background: #21262d;
+      border-left: 3px solid #30363d;
+      margin-bottom: 6px;
+      border-radius: 2px;
+    }
+    .epic-title {
+      color: #79c0ff;
+      font-weight: bold;
+      margin-bottom: 4px;
+    }
+    .epic-stories {
+      margin-left: 8px;
+      color: #8b949e;
+      font-size: 11px;
+    }
+    .status-badge {
+      display: inline-block;
+      padding: 2px 6px;
+      background: #21262d;
+      border: 1px solid #30363d;
+      border-radius: 3px;
+      font-size: 10px;
+      color: #8b949e;
+      margin-right: 4px;
+      margin-bottom: 2px;
+    }
+    .status-active {
+      background: #238636;
+      border-color: #2ea043;
+      color: #aff5b4;
+    }
+    .status-complete {
+      background: #1a414b;
+      border-color: #238636;
+      color: #7ee787;
+    }
+    .empty {
+      color: #6e7681;
+      font-style: italic;
+    }
+    .connection-status {
+      position: fixed;
+      bottom: 16px;
+      right: 16px;
+      padding: 8px 12px;
+      background: #238636;
+      color: #aff5b4;
+      border-radius: 4px;
+      font-size: 11px;
+      border: 1px solid #2ea043;
+    }
+    .connection-status.disconnected {
+      background: #da3633;
+      border-color: #f85149;
+      color: #f5a8a8;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>BigPowers Dashboard</h1>
+    <div class="grid">
+      <!-- Pipeline Panel -->
+      <div class="panel">
+        <h2>Pipeline</h2>
+        <div class="step-container" id="pipeline"></div>
+      </div>
+      <!-- Metrics Panel -->
+      <div class="panel">
+        <h2>Metrics</h2>
+        <div id="metrics"></div>
+      </div>
+      <!-- State Panel -->
+      <div class="panel">
+        <h2>State</h2>
+        <div class="state-pairs" id="state"></div>
+      </div>
+      <!-- Epic Queue Panel -->
+      <div class="panel">
+        <h2>Epic Queue</h2>
+        <div id="epics"></div>
+      </div>
+      <!-- Cycle-Time Ledger Panel -->
+      <div class="panel">
+        <h2>Cycle-Time Ledger</h2>
+        <div id="ledger"></div>
+      </div>
+    </div>
+  </div>
+  <div class="connection-status" id="status">Live</div>
+  <script>
+    const PIPELINE_STEPS = [
+      'survey-context',
+      'plan-work',
+      'kickoff-branch',
+      'develop-tdd',
+      'verify-work',
+      'audit-code',
+      'commit-message',
+      'release-branch'
+    ];
+    let eventSource = null;
+    let pollInterval = null;
+    function render(data) {
+      if (!data) return;
+      renderPipeline(data);
+      renderMetrics(data);
+      renderState(data);
+      renderEpics(data);
+      renderLedger(data);
+    }
+    function renderPipeline(data) {
+      const container = document.getElementById('pipeline');
+      const activeFlow = data.state?.activeFlow;
+      const activeIndex = activeFlow ? PIPELINE_STEPS.indexOf(activeFlow) : -1;
+      container.innerHTML = PIPELINE_STEPS.map((step, idx) => {
+        const isActive = idx === activeIndex;
+        const className = isActive ? 'step active' : 'step';
+        return `<div class="${className}"><span class="step-label">${step}</span></div>`;
+      }).join('');
+    }
+    function renderMetrics(data) {
+      const container = document.getElementById('metrics');
+      const metrics = data.projectMetrics;
+      const velocity = data.currentVelocity;
+      const timestamp = data.timestamp;
+      let html = '';
+      if (metrics) {
+        html += `<div class="metric-row">
+          <span class="metric-label">Total BCPs</span>
+          <span class="metric-value">${metrics.totalBcps}</span>
+        </div>`;
+        html += `<div class="metric-row">
+          <span class="metric-label">Avg BCP/Hour</span>
+          <span class="metric-value">${metrics.avgBcpPerHour.toFixed(2)}</span>
+        </div>`;
+      }
+      if (velocity) {
+        html += `<div class="metric-row">
+          <span class="metric-label">Current Velocity</span>
+          <span class="metric-value">${velocity.avgBcpPerHour.toFixed(2)} BCP/h</span>
+        </div>`;
+      }
+      if (data.state?.release?.version) {
+        html += `<div class="metric-row">
+          <span class="metric-label">Version</span>
+          <span class="metric-value">${data.state.release.version}</span>
+        </div>`;
+      }
+      if (timestamp) {
+        html += `<div class="metric-row">
+          <span class="metric-label">Updated</span>
+          <span class="metric-value" style="font-size: 10px;">${new Date(timestamp).toLocaleTimeString()}</span>
+        </div>`;
+      }
+      container.innerHTML = html || '<p class="empty">No metrics available</p>';
+    }
+    function renderState(data) {
+      const container = document.getElementById('state');
+      const state = data.state || {};
+      const pairs = [
+        { key: 'Active Flow', value: state.activeFlow },
+        { key: 'Active Epic', value: state.activeEpic },
+        { key: 'Active Story', value: state.activeStory },
+        { key: 'Git Branch', value: state.gitBranch }
+      ];
+      container.innerHTML = pairs.map(pair => {
+        const val = pair.value || '(none)';
+        return `
+          <div class="state-pair">
+            <span class="state-key">${pair.key}</span>
+            <span class="state-value">${val}</span>
+          </div>
+        `;
+      }).join('');
+    }
+    function renderEpics(data) {
+      const container = document.getElementById('epics');
+      const epics = data.epics || [];
+      if (epics.length === 0) {
+        container.innerHTML = '<p class="empty">No epics available</p>';
+        return;
+      }
+      container.innerHTML = epics.map(epic => {
+        const stories = epic.stories || [];
+        const storyCount = stories.length;
+        return `
+          <div class="epic-item">
+            <div class="epic-title">${epic.id || 'Unknown'}</div>
+            <div style="color: #8b949e; font-size: 11px; margin-bottom: 4px;">${epic.title || 'Untitled'}</div>
+            <div class="epic-stories">${storyCount} stories</div>
+          </div>
+        `;
+      }).join('');
+    }
+    function renderLedger(data) {
+      const container = document.getElementById('ledger');
+      const cycleTimes = data.cycleTimes || [];
+      if (cycleTimes.length === 0) {
+        container.innerHTML = '<p class="empty">No cycle-time data available</p>';
+        return;
+      }
+      const recentRows = cycleTimes.slice(-8);
+      container.innerHTML = recentRows.map(row => {
+        const end = row.end ? new Date(row.end).toLocaleDateString() : '(active)';
+        return `
+          <div class="ledger-row">
+            <div class="ledger-id">${row.id}</div>
+            <div style="text-align: right;">
+              <div class="ledger-value">${row.bcps} BCP</div>
+              <div class="ledger-meta">${row.cycleMin}min | ${row.bcpPerHour.toFixed(2)}/h</div>
+            </div>
+          </div>
+        `;
+      }).join('');
+    }
+    function setConnectionStatus(connected) {
+      const status = document.getElementById('status');
+      if (connected) {
+        status.textContent = 'Live';
+        status.classList.remove('disconnected');
+      } else {
+        status.textContent = 'Polling...';
+        status.classList.add('disconnected');
+      }
+    }
+    function startEventSource() {
+      eventSource = new EventSource('/events');
+      setConnectionStatus(true);
+      eventSource.onmessage = (event) => {
+        try {
+          const data = JSON.parse(event.data);
+          render(data);
+        } catch (err) {
+          console.error('Failed to parse SSE data:', err);
+        }
+      };
+      eventSource.onerror = (err) => {
+        console.warn('SSE connection lost, falling back to polling');
+        eventSource.close();
+        setConnectionStatus(false);
+        startPolling();
+      };
+    }
+    function startPolling() {
+      if (pollInterval) return;
+      pollInterval = setInterval(() => {
+        fetch('/api/state')
+          .then(res => res.json())
+          .then(data => {
+            render(data);
+            setConnectionStatus(false);
+          })
+          .catch(err => console.error('Poll failed:', err));
+      }, 5000);
+    }
+    function stopPolling() {
+      if (pollInterval) {
+        clearInterval(pollInterval);
+        pollInterval = null;
+      }
+    }
+    // Initial load
+    window.addEventListener('load', () => {
+      fetch('/api/state')
+        .then(res => res.json())
+        .then(data => {
+          render(data);
+          startEventSource();
+        })
+        .catch(err => {
+          console.error('Initial load failed:', err);
+          startPolling();
+        });
+    });
+  </script>
+</body>
+</html>

package/dashboard/src/web/server.js ADDED Viewed

@@ -0,0 +1,112 @@
+const path = require('path');
+const { watch } = require('../loaders/watcher');
+const reader = require('../loaders/reader');
+const metrics = require('../loaders/metrics');
+let express;
+try {
+  express = require('express');
+} catch (err) {
+  express = null;
+}
+function createServer(projectRoot, port = 7742) {
+  const watcher = watch(projectRoot);
+  const clients = new Set();
+  let debounceTimer = null;
+  function buildSnapshot() {
+    const state = reader.readStateYaml(projectRoot);
+    const execStatus = reader.readExecutionStatus(projectRoot);
+    const epics = reader.readEpicShards(projectRoot);
+    const cycleTimes = reader.readCycleTimes(projectRoot);
+    const projectMetrics = metrics.computeProjectMetrics(cycleTimes);
+    const currentVelocity = metrics.computeCurrentVelocity(cycleTimes);
+    return {
+      state,
+      execStatus,
+      epics,
+      cycleTimes,
+      projectMetrics,
+      currentVelocity,
+      timestamp: new Date().toISOString()
+    };
+  }
+  function broadcastSnapshot() {
+    if (debounceTimer) {
+      clearTimeout(debounceTimer);
+    }
+    debounceTimer = setTimeout(() => {
+      const snapshot = buildSnapshot();
+      const message = `data: ${JSON.stringify(snapshot)}\n\n`;
+      for (const client of clients) {
+        client.write(message);
+      }
+    }, 300);
+  }
+  watcher.on('change', broadcastSnapshot);
+  if (!express) {
+    // Fallback: return a minimal server object that doesn't do much
+    return {
+      listen(portNum, cb) {
+        console.warn('Express not installed. Server will not start.');
+        if (cb) cb();
+        return {
+          close() {}
+        };
+      }
+    };
+  }
+  const app = express();
+  // GET / - serve client.html
+  app.get('/', (req, res) => {
+    const clientPath = path.join(__dirname, 'client.html');
+    res.sendFile(clientPath);
+  });
+  // GET /api/state - return current snapshot as JSON
+  app.get('/api/state', (req, res) => {
+    const snapshot = buildSnapshot();
+    res.json(snapshot);
+  });
+  // GET /events - Server-Sent Events endpoint
+  app.get('/events', (req, res) => {
+    res.writeHead(200, {
+      'Content-Type': 'text/event-stream',
+      'Cache-Control': 'no-cache',
+      'Connection': 'keep-alive'
+    });
+    // Send initial snapshot
+    const snapshot = buildSnapshot();
+    res.write(`data: ${JSON.stringify(snapshot)}\n\n`);
+    // Add client to set
+    clients.add(res);
+    // Clean up on disconnect
+    req.on('close', () => {
+      clients.delete(res);
+    });
+    res.on('error', () => {
+      clients.delete(res);
+    });
+  });
+  return {
+    listen(portNum = port, cb) {
+      return app.listen(portNum, cb);
+    }
+  };
+}
+module.exports = { createServer };

package/dashboard/test/fixtures/state.yaml ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ active_flow: execute
2	+ active_epic_id: null

package/deepen-architecture/SKILL.md CHANGED Viewed

@@ -8,6 +8,8 @@ description: Find deepening opportunities in a codebase, informed by the domain
 Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
+> **HARD GATE** — Deep modules must solve a forcing function, not just be "nice abstractions." If you cannot articulate why the abstraction exists, it is premature.
 ## Glossary
 Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).

package/define-language/SKILL.md CHANGED Viewed

@@ -8,6 +8,8 @@ description: Extract a DDD-style ubiquitous language glossary from the current c
 Extract and formalize domain terminology from the current conversation into a consistent glossary, saved to `specs/UBIQUITOUS_LANGUAGE.md`.
+> **HARD GATE** — Ubiquitous language is NOT optional. Every term in the domain that could be misunderstood must be glossed. Ambiguity = rework.
 ## Process
 1. **Scan the conversation** for domain-relevant nouns, verbs, and concepts

package/define-success/SKILL.md CHANGED Viewed

@@ -1,3 +1,5 @@
+ARCHIVED: content absorbed into plan-work
 ---
 name: define-success
 model: sonnet
@@ -8,6 +10,8 @@ description: Convert an imperative task statement into explicit "step → verify
 Transform "do X" into "step → verify: <cmd>" pairs. This is the pre-flight check before `plan-work` or `develop-tdd` — it makes success observable and removes ambiguity about when you're done.
+> **HARD GATE** — Success criteria must be testable and user-observable. "Code should be fast" is not testable. "Pageload latency < 2s" is testable.
 ## Why this matters
 "Implement user authentication" is not a plan. It has no checkpoints, no evidence requirement, and no way to know if you're done. The Karpathy principle: every step must be independently verifiable with a runnable command. If you can't verify it, you can't prove it works.

package/delegate-task/SKILL.md CHANGED Viewed

@@ -5,6 +5,8 @@ description: Delegate one complex task to a single subagent, review its work in
 ---
 # Delegate Task
+> **HARD GATE** — **HARD GATE** — Delegated work must have clear success criteria and verification commands. The delegate must be able to verify completion independently.
 Delegate a single complex task to a subagent with a two-stage review gate before accepting the result. Use when oversight of a single task matters more than speed.

package/design-interface/SKILL.md CHANGED Viewed

@@ -8,6 +8,8 @@ description: Generate multiple radically different interface designs for a modul
 Based on "Design It Twice" from "A Philosophy of Software Design": your first idea is unlikely to be the best. Generate multiple radically different designs, then compare.
+> **HARD GATE** — Multiple design options must be explored. Do NOT settle on first idea. Compare trade-offs (UX, complexity, extensibility, performance) before committing.
 ## Workflow
 ### 1. Gather Requirements

package/develop-tdd/SKILL.md CHANGED Viewed

@@ -145,6 +145,33 @@ Once the story is complete and all tests pass:
 2. Present the script to the user as a step-by-step guide.
 3. Wait for the user to confirm the behavioral correctness before moving to the next story or declaring the task done.
+## TDD phases
+### Red Phase
+Write a failing test first that confirms the behavior you want to implement:
+- Test describes the desired observable behavior through the public interface
+- Run the test to confirm it fails for the right reason (not a syntax error, not a typo)
+- Commit the failing test: `git commit -m "test(<scope>): <description>"`
+### Green Phase
+Write the minimum amount of code to make the test pass:
+- No extra logic, no anticipated future cases, no premature optimization
+- Focus only on making the current test pass
+- Commit the passing code: `git commit -m "feat(<scope>): <description>" or "fix(<scope>): <description>"`
+### Refactor Phase
+Improve the code structure, naming, and clarity without changing behavior:
+- Extract duplication, apply SOLID principles where natural, deepen modules
+- Run tests after each refactor step to ensure behavior is preserved
+- Commit refactoring: `git commit -m "refactor(<scope>): <description>"`
+- Apply the Boy Scout Rule: leave the code cleaner than you found it
 ## Checklist Per Cycle
 ```
@@ -159,3 +186,8 @@ Once the story is complete and all tests pass:
 [ ] Progress committed (Conventional Commits)
 [ ] verify: command passes
 ```
+## Handoff
+Gate: READY -> next: verify-work
+Writes: state.yaml handoff.next_skill = verify-work

package/dispatch-agents/SKILL.md CHANGED Viewed

@@ -5,6 +5,8 @@ description: Dispatch multiple subagents in parallel on independent tasks. No wa
 ---
 # Dispatch Agents
+> **HARD GATE** — **HARD GATE** — Agent work must be parallelizable and have explicit synchronization points. Do NOT dispatch work that has hidden dependencies between agents.
 Run multiple subagents in parallel on independent tasks. Use when tasks are genuinely decoupled — no agent needs the output of another to start.