murmur8 3.5.0 → 4.0.1

package/README.md

@@ -4,6 +4,26 @@ A multi-agent workflow framework for automated feature development. Like a murmu
 
 Four specialized AI agents collaborate in sequence to take features from specification to implementation, with built-in feedback loops and self-improvement capabilities.
 
+## Upgrading to v4.0
+
+v4.0 completes the murmuration theming by renaming all parallel internals. Existing users should be aware of the following breaking changes.
+
+### Breaking changes
+
+- **Source file renamed**: `src/parallel.js` → `src/murm.js` — update any direct `require()` / `import` references
+- **Exported functions renamed**: `runParallel` → `runMurm`, `abortParallel` → `abortMurm`, `rollbackParallel` → `rollbackMurm`, `readParallelConfig` → `readMurmConfig`, `writeParallelConfig` → `writeMurmConfig`, `getDefaultParallelConfig` → `getDefaultMurmConfig`, `validateParallelBatch` → `validateMurmBatch`
+- **Status strings renamed**: `parallel_queued` → `murm_queued`, `parallel_running` → `murm_running`, `parallel_failed` → `murm_failed`, `parallel_complete` → `murm_complete` — update any code that matches on these values
+- **On-disk paths renamed**: `.claude/parallel-config.json` → `.claude/murm-config.json`, `.claude/parallel-queue.json` → `.claude/murm-queue.json`, `.claude/parallel.lock` → `.claude/murm.lock`
+- **CLI command renamed**: `parallel-config` → `murm-config`
+
+### Automatic migration
+
+Legacy on-disk files (`.claude/parallel-config.json`, `.claude/parallel-queue.json`, `.claude/parallel.lock`) are **automatically migrated** to the new paths on first access. No manual action is needed for existing configs.
+
+### Backward-compatible aliases
+
+The CLI commands `parallel`, `murmuration`, and `parallel-config` continue to work as aliases for `murm` and `murm-config` respectively.
+
 ## Agents
 
 | Agent | Role |
@@ -83,16 +103,16 @@ This updates `.blueprint/agents/`, `.blueprint/templates/`, `.blueprint/ways_of_
 | `npx murmur8 insights --bottlenecks` | View bottleneck analysis |
 | `npx murmur8 insights --failures` | View failure pattern analysis |
 
-### Parallel Execution
+### Murmuration (Parallel Execution)
 
 | Command | Description |
 |---------|-------------|
-| `npx murmur8 parallel <slugs...>` | Run multiple features in parallel |
-| `npx murmur8 parallel <slugs...> --dry-run` | Preview execution plan |
-| `npx murmur8 parallel status` | Show status of running pipelines |
-| `npx murmur8 parallel cleanup` | Remove completed worktrees |
-| `npx murmur8 parallel-config` | View parallel configuration |
-| `npx murmur8 parallel-config set <key> <value>` | Modify parallel settings |
+| `npx murmur8 murm <slugs...>` | Run multiple features in parallel |
+| `npx murmur8 murm <slugs...> --dry-run` | Preview execution plan |
+| `npx murmur8 murm status` | Show status of running pipelines |
+| `npx murmur8 murm cleanup` | Remove completed worktrees |
+| `npx murmur8 murm-config` | View murmuration configuration |
+| `npx murmur8 murm-config set <key> <value>` | Modify murmuration settings |
 
 ### Configuration
 
@@ -106,8 +126,8 @@ This updates `.blueprint/agents/`, `.blueprint/templates/`, `.blueprint/ways_of_
 | `npx murmur8 retry-config reset` | Reset to defaults |
 | `npx murmur8 feedback-config` | View feedback thresholds |
 | `npx murmur8 feedback-config set <key> <value>` | Modify feedback settings |
-| `npx murmur8 parallel-config` | View parallel pipeline configuration |
-| `npx murmur8 parallel-config set <key> <value>` | Modify parallel settings |
+| `npx murmur8 murm-config` | View murmuration pipeline configuration |
+| `npx murmur8 murm-config set <key> <value>` | Modify murmuration settings |
 
 ## Usage
 
@@ -227,7 +247,7 @@ murmur8 includes these built-in modules for observability and self-improvement:
 | **handoff** | Structured summaries between agents for token efficiency |
 | **business-context** | Lazy loading of business context based on feature needs |
 | **tools** | Tool schemas and validation for Claude native features |
-| **parallel** | Parallel pipeline execution using git worktrees |
+| **murm** | Murmuration pipeline execution using git worktrees |
 | **stack** | Configurable tech stack detection and configuration |
 
 ### How They Work Together
@@ -290,8 +310,8 @@ your-project/
 │   ├── pipeline-history.json      # Execution history (gitignored)
 │   ├── retry-config.json          # Retry configuration (gitignored)
 │   ├── feedback-config.json       # Feedback thresholds (gitignored)
-│   ├── parallel-config.json       # Parallel execution config (gitignored)
-│   ├── parallel-queue.json        # Parallel pipeline state (gitignored)
+│   ├── murm-config.json            # Murmuration execution config (gitignored)
+│   ├── murm-queue.json             # Murmuration pipeline state (gitignored)
 │   ├── stack-config.json          # Tech stack configuration (gitignored)
 │   └── implement-queue.json       # Pipeline queue state (gitignored)
 └── test/
@@ -359,14 +379,14 @@ Version 2.7 introduces several optimizations to reduce token usage:
 
 **Total estimated savings: 10,000+ tokens per pipeline run** (more for technical features)
 
-## Parallel Execution with Git Worktrees
+## Murmuration
 
 Run multiple feature pipelines simultaneously using git worktrees for isolation. Each feature gets its own worktree and branch, allowing true parallel development without conflicts.
 
 ### How It Works
 
 ```
-murmur8 parallel user-auth dashboard notifications
+murmur8 murm <slug-a> <slug-b> <slug-c>
                     │
                     ▼
     ┌───────────────────────────────────────┐
@@ -384,19 +404,19 @@ murmur8 parallel user-auth dashboard notifications
     ┌───────────────────────────────────────┐
     │  Create Isolated Worktrees            │
     │                                       │
-    │  .claude/worktrees/feat-user-auth/    │
-    │       └─ branch: feature/user-auth    │
+    │  .claude/worktrees/feat-<slug-a>/     │
+    │       └─ branch: feature/<slug-a>     │
     │                                       │
-    │  .claude/worktrees/feat-dashboard/    │
-    │       └─ branch: feature/dashboard    │
+    │  .claude/worktrees/feat-<slug-b>/     │
+    │       └─ branch: feature/<slug-b>     │
     │                                       │
-    │  .claude/worktrees/feat-notifications/│
-    │       └─ branch: feature/notifications│
+    │  .claude/worktrees/feat-<slug-c>/     │
+    │       └─ branch: feature/<slug-c>     │
     └───────────────────────────────────────┘
                     │
                     ▼
     ┌───────────────────────────────────────┐
-    │  Spawn Parallel Pipelines             │
+    │  Spawn Pipelines                      │
     │  (max 3 concurrent by default)        │
     │                                       │
     │  Each runs: Alex → Nigel → Codey      │
@@ -416,22 +436,22 @@ murmur8 parallel user-auth dashboard notifications
 
 ```bash
 # Run 3 features in parallel (default concurrency)
-npx murmur8 parallel user-auth dashboard notifications
+npx murmur8 murm <slug-a> <slug-b> <slug-c>
 
 # Preview what would happen without executing
-npx murmur8 parallel user-auth dashboard --dry-run
+npx murmur8 murm <slug-a> <slug-b> --dry-run
 
 # Limit concurrent pipelines
-npx murmur8 parallel feat-a feat-b feat-c feat-d --max-concurrency=2
+npx murmur8 murm <slug-a> <slug-b> <slug-c> <slug-d> --max-concurrency=2
 
 # Check status of running pipelines
-npx murmur8 parallel status
+npx murmur8 murm status
 
 # Skip pre-flight feature validation
-npx murmur8 parallel user-auth dashboard --skip-preflight
+npx murmur8 murm <slug-a> <slug-b> --skip-preflight
 
 # Clean up completed/aborted worktrees
-npx murmur8 parallel cleanup
+npx murmur8 murm cleanup
 ```
 
 ### Pre-flight Batch Validation (v2.8)
@@ -439,7 +459,7 @@ npx murmur8 parallel cleanup
 Before parallel execution, the system validates the batch to prevent wasted resources:
 
 ```
-$ npx murmur8 parallel feat-a feat-b feat-c --dry-run
+$ npx murmur8 murm feat-a feat-b feat-c --dry-run
 
 Pre-flight Validation
 =====================
@@ -484,11 +504,11 @@ Suggested commands:
 
 ### Configuration
 
-The parallel module is **CLI-agnostic** — configure it to work with different AI coding tools:
+The murmuration module is **CLI-agnostic** — configure it to work with different AI coding tools:
 
 ```bash
 # View current configuration
-npx murmur8 parallel-config
+npx murmur8 murm-config
 
 # Output:
 #   cli:            npx claude
@@ -496,7 +516,7 @@ npx murmur8 parallel-config
 #   skillFlags:     --no-commit
 #   worktreeDir:    .claude/worktrees
 #   maxConcurrency: 3
-#   queueFile:      .claude/parallel-queue.json
+#   queueFile:      .claude/murm-queue.json
 ```
 
 #### Configuration Options
@@ -511,31 +531,31 @@ npx murmur8 parallel-config
 | `maxFeatures` | `10` | Maximum features per batch |
 | `timeout` | `30` | Timeout per pipeline (minutes) |
 | `minDiskSpaceMB` | `500` | Minimum disk space warning threshold |
-| `queueFile` | `.claude/parallel-queue.json` | State persistence file |
+| `queueFile` | `.claude/murm-queue.json` | State persistence file |
 
 #### Examples for Different CLIs
 
 ```bash
 # Claude Code (default)
-npx murmur8 parallel-config set cli "npx claude"
-npx murmur8 parallel-config set skill "/implement-feature"
+npx murmur8 murm-config set cli "npx claude"
+npx murmur8 murm-config set skill "/implement-feature"
 
 # Cursor
-npx murmur8 parallel-config set cli "cursor"
-npx murmur8 parallel-config set skill "composer"
-npx murmur8 parallel-config set skillFlags ""
+npx murmur8 murm-config set cli "cursor"
+npx murmur8 murm-config set skill "composer"
+npx murmur8 murm-config set skillFlags ""
 
 # Aider
-npx murmur8 parallel-config set cli "aider"
-npx murmur8 parallel-config set skill "--message"
-npx murmur8 parallel-config set skillFlags "implement feature:"
+npx murmur8 murm-config set cli "aider"
+npx murmur8 murm-config set skill "--message"
+npx murmur8 murm-config set skillFlags "implement feature:"
 
 # Custom agent script
-npx murmur8 parallel-config set cli "./my-agent.sh"
-npx murmur8 parallel-config set skill "run"
+npx murmur8 murm-config set cli "./my-agent.sh"
+npx murmur8 murm-config set skill "run"
 
 # Reset to defaults
-npx murmur8 parallel-config reset
+npx murmur8 murm-config reset
 ```
 
 ### State Management
@@ -543,10 +563,10 @@ npx murmur8 parallel-config reset
 Each feature progresses through these states:
 
 ```
-parallel_queued → worktree_created → parallel_running → merge_pending → parallel_complete
-                                           │                  │
-                                           ▼                  ▼
-                                    parallel_failed    merge_conflict
+murm_queued → worktree_created → murm_running → merge_pending → murm_complete
+                                      │                  │
+                                      ▼                  ▼
+                               murm_failed        merge_conflict
 ```
 
 - **Successful features**: Merged to main, worktree cleaned up

package/SKILL.md

@@ -189,6 +189,8 @@ historyEntry = {
 
 ## Step 6: Spawn Alex Agent
 
+**Announce:** `} Alex — creating feature spec`
+
 **History:** Record `stages.alex.startedAt` before spawning.
 
 **Runtime prompt:** `.blueprint/prompts/alex-runtime.md`
@@ -281,6 +283,8 @@ Then continue with your task.
 
 ## Step 7: Spawn Cass Agent
 
+**Announce:** ` } Cass — writing user stories`
+
 **History:** Record `stages.cass.startedAt` before spawning.
 
 **Runtime prompt:** `.blueprint/prompts/cass-runtime.md`
@@ -379,6 +383,8 @@ Then continue with your task.
 
 ## Step 8: Spawn Nigel Agent
 
+**Announce:** `  } Nigel — building tests`
+
 **History:** Record `stages.nigel.startedAt` before spawning.
 
 **Runtime prompt:** `.blueprint/prompts/nigel-runtime.md`
@@ -480,6 +486,8 @@ Then continue with your task.
 
 ## Step 9: Spawn Codey Agent (Plan)
 
+**Announce:** `   } Codey — drafting implementation plan`
+
 **History:** Record `stages.codeyPlan.startedAt` before spawning.
 
 **Runtime prompt:** `.blueprint/prompts/codey-plan-runtime.md`
@@ -536,6 +544,8 @@ For detailed guidance, see: .blueprint/agents/AGENT_DEVELOPER_CODEY.md
 
 ## Step 10: Spawn Codey Agent (Implement)
 
+**Announce:** `    } Codey — implementing feature`
+
 **History:** Record `stages.codeyImplement.startedAt` before spawning.
 
 **Runtime prompt:** `.blueprint/prompts/codey-implement-runtime.md`
@@ -631,7 +641,13 @@ historyEntry.commitHash = "{hash}";
 
 **Display summary:**
 ```
-## Completed
+} Alex — creating feature spec       ✓
+ } Cass — writing user stories       ✓
+  } Nigel — building tests           ✓
+   } Codey — drafting plan           ✓
+    } Codey — implementing feature   ✓
+
+## Landed
 - feature_{slug}
   - Stories: N
   - Tests: N (all passing)

package/bin/cli.js

@@ -22,18 +22,18 @@ const {
   formatStatus,
   getDefaultConfig,
   splitByLimit,
-  runParallel,
+  runMurm,
   loadQueue,
   cleanupWorktrees,
-  readParallelConfig,
-  writeParallelConfig,
-  getDefaultParallelConfig,
-  abortParallel,
+  readMurmConfig,
+  writeMurmConfig,
+  getDefaultMurmConfig,
+  abortMurm,
   getLockInfo,
   getDetailedStatus,
   formatDetailedStatus,
-  rollbackParallel
-} = require('../src/parallel');
+  rollbackMurm
+} = require('../src/murm');
 
 const args = process.argv.slice(2);
 const command = args[0];
@@ -170,30 +170,30 @@ const commands = {
     },
     description: 'View or modify project tech stack configuration'
   },
-  'parallel-config': {
+  'murm-config': {
     fn: () => {
       if (subArg === 'set') {
         const key = args[2];
         const value = args[3];
         if (!key || !value) {
-          console.error('Usage: parallel-config set <key> <value>');
+          console.error('Usage: murm-config set <key> <value>');
           console.error('Valid keys: cli, skill, skillFlags, worktreeDir, maxConcurrency, queueFile');
           process.exit(1);
         }
-        const config = readParallelConfig();
+        const config = readMurmConfig();
         if (key === 'maxConcurrency') {
           config[key] = parseInt(value, 10);
         } else {
           config[key] = value;
         }
-        writeParallelConfig(config);
+        writeMurmConfig(config);
         console.log(`Set ${key} = ${value}`);
       } else if (subArg === 'reset') {
-        writeParallelConfig(getDefaultParallelConfig());
-        console.log('Parallel configuration reset to defaults.');
+        writeMurmConfig(getDefaultMurmConfig());
+        console.log('Murmuration configuration reset to defaults.');
       } else {
-        const config = readParallelConfig();
-        console.log('Parallel Configuration\n');
+        const config = readMurmConfig();
+        console.log('Murmuration Configuration\n');
         console.log(`  cli:            ${config.cli}`);
         console.log(`  skill:          ${config.skill}`);
         console.log(`  skillFlags:     ${config.skillFlags}`);
@@ -203,10 +203,15 @@ const commands = {
         console.log(`  timeout:        ${config.timeout} min`);
         console.log(`  minDiskSpaceMB: ${config.minDiskSpaceMB}`);
         console.log(`  queueFile:      ${config.queueFile}`);
-        console.log('\nTo change: murmur8 parallel-config set <key> <value>');
+        console.log('\nTo change: murmur8 murm-config set <key> <value>');
+        console.log('Run pipelines: murmur8 murm <slug1> <slug2> ...');
       }
     },
-    description: 'View or modify parallel pipeline configuration'
+    description: 'View or modify murmuration pipeline configuration'
+  },
+  'parallel-config': {
+    fn: null, // alias — set below
+    description: 'View or modify murmuration pipeline configuration (alias for murm-config)'
   },
   parallel: {
     fn: async () => {
@@ -222,29 +227,29 @@ const commands = {
 
           if (!queue.features || queue.features.length === 0) {
             if (lock) {
-              console.log(`Parallel execution in progress (PID: ${lock.pid})`);
+              console.log(`Murmuration execution in progress (PID: ${lock.pid})`);
               console.log(`Started: ${lock.startedAt}`);
               console.log(`Features: ${lock.features.join(', ')}`);
             } else {
-              console.log('No parallel pipelines active.');
+              console.log('No murmuration pipelines active.');
             }
             return;
           }
 
-          console.log('Parallel Pipeline Status\n');
+          console.log('Murmuration Pipeline Status\n');
           console.log(formatStatus(queue.features));
           const summary = {
-            running: queue.features.filter(f => f.status === 'parallel_running').length,
-            pending: queue.features.filter(f => f.status === 'parallel_queued').length,
-            completed: queue.features.filter(f => f.status === 'parallel_complete').length,
-            failed: queue.features.filter(f => f.status === 'parallel_failed').length,
+            running: queue.features.filter(f => f.status === 'murm_running').length,
+            pending: queue.features.filter(f => f.status === 'murm_queued').length,
+            completed: queue.features.filter(f => f.status === 'murm_complete').length,
+            failed: queue.features.filter(f => f.status === 'murm_failed').length,
             conflicts: queue.features.filter(f => f.status === 'merge_conflict').length
           };
           console.log(`\nRunning: ${summary.running} | Pending: ${summary.pending} | Completed: ${summary.completed} | Failed: ${summary.failed} | Conflicts: ${summary.conflicts}`);
 
           // Show log paths for running/failed
           const withLogs = queue.features.filter(f =>
-            f.logPath && (f.status === 'parallel_running' || f.status === 'parallel_failed')
+            f.logPath && (f.status === 'murm_running' || f.status === 'murm_failed')
           );
           if (withLogs.length > 0) {
             console.log('\nLog files:');
@@ -256,17 +261,17 @@ const commands = {
       } else if (subArg === 'rollback') {
         const dryRunFlag = args.includes('--dry-run');
         const forceFlag = args.includes('--force');
-        await rollbackParallel({ dryRun: dryRunFlag, force: forceFlag });
+        await rollbackMurm({ dryRun: dryRunFlag, force: forceFlag });
       } else if (subArg === 'cleanup') {
         const cleaned = await cleanupWorktrees();
         console.log(`Cleaned ${cleaned} worktree(s).`);
       } else if (subArg === 'abort') {
         const cleanupFlag = args.includes('--cleanup');
-        await abortParallel({ cleanup: cleanupFlag });
+        await abortMurm({ cleanup: cleanupFlag });
       } else {
         const slugs = args.slice(1).filter(a => !a.startsWith('--') && !a.startsWith('-'));
         if (slugs.length === 0) {
-          console.error('Usage: murmur8 parallel <slug1> <slug2> ... [options]');
+          console.error('Usage: murmur8 murm <slug1> <slug2> ... [options]');
           console.error('\nOptions:');
           console.error('  --dry-run            Preview execution plan without running');
           console.error('  --yes, -y            Skip confirmation prompt');
@@ -275,9 +280,9 @@ const commands = {
           console.error('  --skip-preflight     Skip feature validation checks');
           console.error('  --max-concurrency=N  Set max parallel pipelines (default: 3)');
           console.error('\nSubcommands:');
-          console.error('  parallel status    Show status of all pipelines');
-          console.error('  parallel abort     Stop all running pipelines');
-          console.error('  parallel cleanup   Remove completed/aborted worktrees');
+          console.error('  murm status    Show status of all pipelines');
+          console.error('  murm abort     Stop all running pipelines');
+          console.error('  murm cleanup   Remove completed/aborted worktrees');
           process.exit(1);
         }
 
@@ -292,18 +297,31 @@ const commands = {
         if (maxFlag) {
           options.maxConcurrency = parseInt(maxFlag.split('=')[1], 10);
         }
-        const result = await runParallel(slugs, options);
+        const result = await runMurm(slugs, options);
         process.exit(result.success ? 0 : 1);
       }
     },
     description: 'Run multiple feature pipelines in parallel using git worktrees'
   },
+  murm: {
+    fn: null, // alias — set below
+    description: 'Run multiple feature pipelines in parallel (murmuration)'
+  },
+  murmuration: {
+    fn: null, // alias — set below
+    description: 'Run multiple feature pipelines in parallel (murmuration)'
+  },
   help: {
     fn: showHelp,
     description: 'Show this help message'
   }
 };
 
+// Wire aliases
+commands.murm.fn = commands.parallel.fn;
+commands.murmuration.fn = commands.parallel.fn;
+commands['parallel-config'].fn = commands['murm-config'].fn;
+
 function showHelp() {
   console.log(`
 murmur8 - Multi-agent workflow framework
@@ -335,23 +353,26 @@ Commands:
   stack-config          View current tech stack configuration
   stack-config set <key> <value>  Modify a config value (language, runtime, frameworks, etc.)
   stack-config reset    Reset tech stack configuration to defaults
-  parallel <slugs...>   Run multiple feature pipelines in parallel
-  parallel <slugs...> --dry-run  Show execution plan without running
-  parallel <slugs...> --yes      Skip confirmation prompt
-  parallel <slugs...> --verbose  Stream output to console
-  parallel <slugs...> --skip-preflight  Skip feature validation checks
-  parallel status       Show status of all parallel pipelines
-  parallel status --detailed  Show progress bars and stage info
-  parallel abort        Stop all running pipelines
-  parallel abort --cleanup  Stop all and remove worktrees
-  parallel rollback     Undo completed merges and cleanup failures
-  parallel rollback --dry-run  Preview what would be rolled back
-  parallel cleanup      Remove completed/aborted worktrees
-  parallel-config       View parallel pipeline configuration
-  parallel-config set <key> <value>  Modify config (cli, skill, skillFlags, etc.)
-  parallel-config reset Reset parallel configuration to defaults
+  murm <slugs...>       Run multiple feature pipelines in parallel (murmuration)
+  murm <slugs...> --dry-run  Show execution plan without running
+  murm <slugs...> --yes      Skip confirmation prompt
+  murm <slugs...> --verbose  Stream output to console
+  murm <slugs...> --skip-preflight  Skip feature validation checks
+  murm status           Show status of all parallel pipelines
+  murm status --detailed  Show progress bars and stage info
+  murm abort            Stop all running pipelines
+  murm abort --cleanup  Stop all and remove worktrees
+  murm rollback         Undo completed merges and cleanup failures
+  murm rollback --dry-run  Preview what would be rolled back
+  murm cleanup          Remove completed/aborted worktrees
+  murm-config           View murmuration pipeline configuration
+  murm-config set <key> <value>  Modify config (cli, skill, skillFlags, etc.)
+  murm-config reset     Reset murmuration configuration to defaults
   help                  Show this help message
 
+  Aliases: parallel, murmuration (same as murm)
+           parallel-config (same as murm-config)
+
 Examples:
   npx murmur8 init
   npx murmur8 update
@@ -360,7 +381,7 @@ Examples:
   npx murmur8 history
   npx murmur8 history --stats
   npx murmur8 insights --feedback
-  npx murmur8 feedback-config
+  npx murmur8 murm user-auth dashboard --dry-run
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "murmur8",
-  "version": "3.5.0",
+  "version": "4.0.1",
   "description": "Multi-agent workflow framework for automated feature development",
   "main": "src/index.js",
   "bin": {
@@ -20,7 +20,7 @@
   "author": "NewmanJustice",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/NewmanJustice/agent-workflow.git"
+    "url": "git+https://github.com/NewmanJustice/murmur8.git"
   },
   "license": "MIT",
   "engines": {

package/src/history.js

@@ -1,6 +1,7 @@
 const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
+const { colorize } = require('./theme');
 
 const HISTORY_FILE = '.claude/pipeline-history.json';
 
@@ -104,17 +105,6 @@ function formatDate(isoString) {
   return date.toISOString().replace('T', ' ').slice(0, 19);
 }
 
-function colorize(text, color, useColor) {
-  if (!useColor) return text;
-  const colors = {
-    green: '\x1b[32m',
-    red: '\x1b[31m',
-    yellow: '\x1b[33m',
-    reset: '\x1b[0m'
-  };
-  return `${colors[color] || ''}${text}${colors.reset}`;
-}
-
 function displayHistory(options = {}) {
   const showAll = options.all || false;
   const useColor = options.color !== false && process.stdout.isTTY;

package/src/index.js

@@ -82,6 +82,7 @@ const {
   displayStackConfig
 } = require('./stack');
 const tools = require('./tools');
+const theme = require('./theme');
 
 module.exports = {
   init,
@@ -146,6 +147,8 @@ module.exports = {
   displayStackConfig,
   // Tools module (model native features)
   tools,
+  // Theme module (murmuration visual theming)
+  theme,
   // Interactive mode exports
   parseInteractiveFlags,
   shouldEnterInteractiveMode,