murmur8 4.3.2 → 4.3.4

package/.blueprint/features/BACKLOG.md

@@ -0,0 +1,91 @@
+# Feature Backlog
+
+## Definitions
+
+| Priority | Meaning |
+|----------|---------|
+| P0 | Critical — blocker |
+| P1 | High — do soon |
+| P2 | Medium — planned |
+| P3 | Low — future |
+
+| Effort | Meaning |
+|--------|---------|
+| S | Small — <1 hour |
+| M | Medium — 1-3 hours |
+| L | Large — 3-8 hours |
+| XL | Extra Large — 1+ days |
+
+| Status | Meaning |
+|--------|---------|
+| ⏳ | Ready to implement |
+| 🚧 | In progress |
+| ❓ | Needs clarification |
+
+---
+
+## Backlog
+
+| Status | P | E | Slug | Description |
+|--------|---|---|------|-------------|
+| ❓ | P1 | M | murm-subagent | Use Task tool sub-agents instead of spawning CLI processes |
+| ⏳ | P2 | M | agent-timeouts | Configurable timeouts per agent stage |
+| ⏳ | P2 | M | rollback | Revert a feature's commits |
+| ⏳ | P2 | M | agent-overrides | Per-project agent customization |
+| ⏳ | P2 | M | resume-from-stage | Resume pipeline from specific stage |
+| ⏳ | P3 | M | dry-run-mode | Validate inputs without running agents |
+| ⏳ | P3 | M | feature-dependencies | Define execution order for related features |
+| ⏳ | P3 | L | webhook-notifications | Slack/email on completion |
+| ⏳ | P3 | XL | mcp-integration | Expose murmur8 as MCP tools |
+| ⏳ | P3 | XL | mcp-repos-server | Cross-repo context for distributed monoliths |
+| ⏳ | P3 | S | cli-doctor | Diagnose CLI setup issues |
+| ⏳ | P3 | M | cross-cli-insights | Track which CLI used per run |
+| ⏳ | P3 | S | skill-lint | Validate skill YAML frontmatter |
+| ⏳ | P3 | M | aider-adapter | Support for Aider CLI |
+| ⏳ | P3 | M | cursor-adapter | Support for Cursor Composer |
+| ⏳ | P3 | L | docey-agent | Fifth agent to update docs after implementation |
+| ⏳ | P3 | M | backlog-tooling | CLI commands for backlog management |
+| ⏳ | P3 | L | skill-modularize | Split SKILL.md into composable sections |
+
+---
+
+## Details
+
+### murm-subagent
+
+Murmuration currently spawns separate CLI processes. This doesn't work inside an existing Claude Code session. Should use Task tool sub-agents instead for parallel features.
+
+### agent-timeouts
+
+Configurable timeout per stage (default: 5 min). Support `--timeout=10m` flag. Graceful termination with status recording.
+
+### rollback
+
+`murmur8 rollback <feature-slug>` to revert commits. Uses git history to find commits by feature. Supports `--dry-run`.
+
+### agent-overrides
+
+Per-project agent customization via `.blueprint/agents/overrides/AGENT_*.md`. Override content appended to base specs.
+
+### resume-from-stage
+
+More granular than queue-based resume. `--resume-from=nigel` to skip earlier stages. Validates artifacts exist first.
+
+### docey-agent
+
+Fifth agent to update README/CLAUDE.md after Codey implements. Identifies user-facing changes and updates docs automatically.
+
+### mcp-repos-server
+
+MCP server for cross-repository context in distributed architectures. See FEATURE_IDEAS.md for full specification.
+
+### backlog-tooling
+
+CLI commands: `npx murmur8 backlog`, `backlog add`, `backlog next`, `backlog murm P1`.
+
+---
+
+## Notes
+
+- Items removed automatically when pipeline completes successfully
+- Run with: `/implement-feature "slug"` or `npx murmur8 murm slug-a slug-b`

package/package.json

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

package/src/init.js

@@ -81,6 +81,12 @@ function createCopilotSymlink() {
   }
 }
 
+// Framework directories to copy (these are part of the murmur8 framework)
+const FRAMEWORK_DIRS = ['agents', 'prompts', 'templates', 'ways_of_working'];
+
+// User content directories to create empty (these are for the target project's own content)
+const USER_CONTENT_DIRS = ['features', 'system_specification'];
+
 async function init() {
   const blueprintSrc = path.join(PACKAGE_ROOT, '.blueprint');
   const blueprintDest = path.join(TARGET_DIR, '.blueprint');
@@ -97,7 +103,13 @@ async function init() {
       console.log('Aborted. Use "murmur8 update" to update existing installation.');
       return;
     }
-    fs.rmSync(blueprintDest, { recursive: true });
+    // Only remove framework directories, preserve user content
+    for (const dir of FRAMEWORK_DIRS) {
+      const dirPath = path.join(blueprintDest, dir);
+      if (fs.existsSync(dirPath)) {
+        fs.rmSync(dirPath, { recursive: true });
+      }
+    }
   }
 
   // Copy skill to .claude/commands/ (master location)
@@ -117,9 +129,25 @@ async function init() {
     createCopilotSymlink();
   }
 
-  // Copy .blueprint directory
+  // Copy framework directories only (not user content directories)
   console.log('Copying .blueprint directory...');
-  copyDir(blueprintSrc, blueprintDest);
+  fs.mkdirSync(blueprintDest, { recursive: true });
+  for (const dir of FRAMEWORK_DIRS) {
+    const src = path.join(blueprintSrc, dir);
+    const dest = path.join(blueprintDest, dir);
+    if (fs.existsSync(src)) {
+      copyDir(src, dest);
+    }
+  }
+
+  // Create empty user content directories with .gitkeep
+  for (const dir of USER_CONTENT_DIRS) {
+    const dest = path.join(blueprintDest, dir);
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+      fs.writeFileSync(path.join(dest, '.gitkeep'), '');
+    }
+  }
   console.log('Copied .blueprint directory');
 
   // Copy .business_context directory

package/src/update.js

@@ -15,6 +15,7 @@ const USER_CONTENT_DIRS = [
 // Directories/files that should be updated
 const UPDATABLE = [
   'agents',
+  'prompts',
   'templates',
   'ways_of_working'
 ];
@@ -42,6 +43,13 @@ async function update() {
   const skillSrc = path.join(PACKAGE_ROOT, 'SKILL.md');
   const skillDest = path.join(TARGET_DIR, 'SKILL.md');
 
+  // Check if running in the package source directory (dev mode)
+  if (PACKAGE_ROOT === TARGET_DIR) {
+    console.log('Cannot run update in the murmur8 source directory.');
+    console.log('This command is for updating projects that use murmur8.');
+    process.exit(1);
+  }
+
   // Check if .blueprint exists
   if (!fs.existsSync(blueprintDest)) {
     console.log('.blueprint directory not found. Run "agent-workflow init" first.');
@@ -84,6 +92,7 @@ Update complete!
 
 Updated:
   - .blueprint/agents/
+  - .blueprint/prompts/
   - .blueprint/templates/
   - .blueprint/ways_of_working/
   - SKILL.md