murmur8 4.4.0 → 4.5.0

package/README.md

@@ -327,6 +327,24 @@ analyzes:               recommends:            calibrates:
 • Trends                • And feedback issues
 ```
 
+### Accessing Module Data
+
+Data is collected from both invocation methods and accessible via CLI commands:
+
+| Data | `/implement-feature` (skill) | `npx murmur8 murm` (CLI) | How to access |
+|------|------------------------------|--------------------------|---------------|
+| **Per-stage timing** (alex, cass, nigel, codey) | Recorded by orchestrating agent | Merged from worktree on successful merge | `npx murmur8 history` |
+| **Feedback ratings** (agent-to-agent) | Recorded by feedback micro-Tasks | Merged from worktree on successful merge | `npx murmur8 history`, `npx murmur8 insights --feedback` |
+| **Token cost per stage** | Recorded by orchestrating agent | Merged from worktree on successful merge | `npx murmur8 history --cost` |
+| **Batch summary** (total duration, feature outcomes) | N/A (single feature) | Recorded at batch completion | `npx murmur8 history` |
+| **Success/failure status** | Recorded per run | Recorded per feature + batch | `npx murmur8 history --stats` |
+| **Retry attempts & strategies** | Recorded on failure | Merged from worktree on successful merge | `npx murmur8 insights --failures` |
+| **Bottleneck analysis** | Derived from history | Derived from history | `npx murmur8 insights --bottlenecks` |
+| **Smart retry recommendations** | Used live during pipeline | Used live during pipeline | Automatic on failure |
+| **Diff preview** | Shown before commit | Shown per worktree before merge | Interactive during pipeline |
+
+**How worktree history merging works:** When `npx murmur8 murm` runs, each feature pipeline executes `/implement-feature` inside an isolated git worktree. The skill records per-stage data to `.claude/pipeline-history.json` within that worktree. After a successful merge, murmur8 reads this file and appends its entries to the main project's history before cleaning up the worktree. Failed/conflicted worktrees preserve their history for debugging.
+
 ## Directory Structure
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "murmur8",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "description": "Multi-agent workflow framework for automated feature development",
   "main": "src/index.js",
   "bin": {

package/src/murm.js

@@ -5,6 +5,7 @@ const { execSync, spawn } = require('child_process');
 const fs = require('fs');
 const readline = require('readline');
 const theme = require('./theme');
+const { recordHistory, readHistoryFile, writeHistoryFile } = require('./history');
 
 const CONFIG_FILE = '.claude/murm-config.json';
 const LOCK_FILE = '.claude/murm.lock';
@@ -19,6 +20,27 @@ const LEGACY_QUEUE_FILE = '.claude/parallel-queue.json';
 let runningProcesses = new Map();
 let isAborting = false;
 
+const HISTORY_FILE = '.claude/pipeline-history.json';
+
+function mergeWorktreeHistory(worktreePath) {
+  const worktreeHistoryPath = path.join(worktreePath, HISTORY_FILE);
+  if (!fs.existsSync(worktreeHistoryPath)) return [];
+
+  try {
+    const worktreeEntries = JSON.parse(fs.readFileSync(worktreeHistoryPath, 'utf8'));
+    if (!Array.isArray(worktreeEntries) || worktreeEntries.length === 0) return [];
+
+    const mainHistory = readHistoryFile();
+    if (mainHistory.error) return worktreeEntries;
+
+    mainHistory.push(...worktreeEntries);
+    writeHistoryFile(mainHistory);
+    return worktreeEntries;
+  } catch {
+    return [];
+  }
+}
+
 /**
  * Migrate a legacy file path to the new path.
  * If the old file exists and the new one doesn't, rename it.
@@ -1284,6 +1306,11 @@ async function runMurm(slugs, options = {}) {
         if (mergeResult.success) {
           feature.status = 'murm_complete';
           console.log(`[${timestamp}] ${result.slug}: ${theme.MESSAGES.mergedAndLanded} \u2713`);
+          // Merge per-stage history from worktree before cleanup
+          const merged = mergeWorktreeHistory(feature.worktreePath);
+          if (merged.length > 0) {
+            feature.historyMerged = true;
+          }
           removeWorktree(result.slug);
         } else if (mergeResult.conflict) {
           feature.status = 'merge_conflict';
@@ -1342,6 +1369,29 @@ async function runMurm(slugs, options = {}) {
       });
   }
 
+    // Record batch-level history
+    recordHistory({
+      slug: slugs.join('+'),
+      mode: 'murmuration',
+      status: summary.failed === 0 && summary.conflicts === 0 ? 'success' : 'partial',
+      startedAt: queue.startedAt,
+      completedAt: new Date().toISOString(),
+      totalDurationMs: Date.now() - new Date(queue.startedAt).getTime(),
+      baseBranch,
+      features: queue.features.map(f => ({
+        slug: f.slug,
+        status: f.status,
+        startedAt: f.startedAt,
+        completedAt: f.completedAt
+      })),
+      summary: {
+        total: slugs.length,
+        completed: summary.completed,
+        failed: summary.failed,
+        conflicts: summary.conflicts
+      }
+    });
+
     return { success: summary.failed === 0 && summary.conflicts === 0, summary };
   } finally {
     // Always release lock when done