cc-mirror 1.5.0 → 1.6.1

package/README.md

@@ -45,12 +45,12 @@ Claude Code has a hidden multi-agent capability. CC-MIRROR enables it.
 
 **What gets unlocked:**
 
-| Tool | Purpose |
-|------|---------|
+| Tool         | Purpose                                                  |
+| ------------ | -------------------------------------------------------- |
 | `TaskCreate` | Create tasks with subject, description, and dependencies |
-| `TaskGet` | Retrieve full task details by ID |
-| `TaskUpdate` | Update status, add comments, set blockers |
-| `TaskList` | List all tasks with summary info |
+| `TaskGet`    | Retrieve full task details by ID                         |
+| `TaskUpdate` | Update status, add comments, set blockers                |
+| `TaskList`   | List all tasks with summary info                         |
 
 Plus a **battle-tested orchestrator skill** — refined through millions of tokens of iteration — that teaches Claude how to effectively coordinate multiple agents working in parallel.
 
@@ -134,12 +134,12 @@ npx cc-mirror quick --provider mirror --name mclaude
 
 Want to use different models? CC-MIRROR supports multiple providers, all with team mode:
 
-| Provider | Models | Auth | Best For |
-|----------|--------|------|----------|
-| **Z.ai** | GLM-4.7, GLM-4.5-Air | API Key | Heavy coding with GLM reasoning |
-| **MiniMax** | MiniMax-M2.1 | API Key | Unified model experience |
-| **OpenRouter** | 100+ models | Auth Token | Model flexibility, pay-per-use |
-| **CCRouter** | Ollama, DeepSeek, etc. | Optional | Local-first development |
+| Provider       | Models                 | Auth       | Best For                        |
+| -------------- | ---------------------- | ---------- | ------------------------------- |
+| **Z.ai**       | GLM-4.7, GLM-4.5-Air   | API Key    | Heavy coding with GLM reasoning |
+| **MiniMax**    | MiniMax-M2.1           | API Key    | Unified model experience        |
+| **OpenRouter** | 100+ models            | Auth Token | Model flexibility, pay-per-use  |
+| **CCRouter**   | Ollama, DeepSeek, etc. | Optional   | Local-first development         |
 
 ```bash
 # Z.ai (GLM Coding Plan)
@@ -180,13 +180,13 @@ Claude becomes "The Conductor" — a warm, capable orchestrator who transforms a
 
 ### What It Provides
 
-| Aspect | What Claude Learns |
-|--------|-------------------|
-| **Task Graph** | Decompose work into tasks with dependencies |
-| **Parallel Execution** | Fan-out, pipeline, map-reduce patterns |
-| **Background Agents** | Spawn agents that work while you continue |
-| **Smart Prompting** | Context, scope, constraints, output expectations |
-| **Progress Updates** | Milestone celebrations, warm professional tone |
+| Aspect                 | What Claude Learns                               |
+| ---------------------- | ------------------------------------------------ |
+| **Task Graph**         | Decompose work into tasks with dependencies      |
+| **Parallel Execution** | Fan-out, pipeline, map-reduce patterns           |
+| **Background Agents**  | Spawn agents that work while you continue        |
+| **Smart Prompting**    | Context, scope, constraints, output expectations |
+| **Progress Updates**   | Milestone celebrations, warm professional tone   |
 
 ### Example Flow
 
@@ -228,10 +228,13 @@ Manage team tasks from the command line:
 
 ```bash
 npx cc-mirror tasks                    # List open tasks
+npx cc-mirror tasks --ready            # List ready tasks (open + not blocked)
+npx cc-mirror tasks --json             # JSON output for automation
 npx cc-mirror tasks show 18            # Show task details
 npx cc-mirror tasks create             # Create new task
 npx cc-mirror tasks update 5 --status resolved
 npx cc-mirror tasks graph              # Visualize dependencies
+npx cc-mirror tasks graph --json       # Graph as JSON for programmatic use
 npx cc-mirror tasks clean --resolved   # Cleanup done tasks
 ```
 
@@ -306,24 +309,24 @@ minimax                           # Run MiniMax variant
 
 Each provider includes a custom color theme via [tweakcc](https://github.com/Piebald-AI/tweakcc):
 
-| Brand | Style |
-|-------|-------|
-| **mirror** | Silver/chrome with electric blue |
-| **zai** | Dark carbon with gold accents |
-| **minimax** | Coral/red/orange spectrum |
-| **openrouter** | Teal/cyan gradient |
-| **ccrouter** | Sky blue accents |
+| Brand          | Style                            |
+| -------------- | -------------------------------- |
+| **mirror**     | Silver/chrome with electric blue |
+| **zai**        | Dark carbon with gold accents    |
+| **minimax**    | Coral/red/orange spectrum        |
+| **openrouter** | Teal/cyan gradient               |
+| **ccrouter**   | Sky blue accents                 |
 
 ---
 
 ## Documentation
 
-| Document | Description |
-|----------|-------------|
-| [Team Mode](docs/features/team-mode.md) | Multi-agent collaboration deep dive |
-| [Mirror Claude](docs/features/mirror-claude.md) | Pure Claude Code with superpowers |
-| [Architecture](docs/architecture/overview.md) | How CC-MIRROR works under the hood |
-| [Full Documentation](docs/README.md) | Complete documentation index |
+| Document                                        | Description                         |
+| ----------------------------------------------- | ----------------------------------- |
+| [Team Mode](docs/features/team-mode.md)         | Multi-agent collaboration deep dive |
+| [Mirror Claude](docs/features/mirror-claude.md) | Pure Claude Code with superpowers   |
+| [Architecture](docs/architecture/overview.md)   | How CC-MIRROR works under the hood  |
+| [Full Documentation](docs/README.md)            | Complete documentation index        |
 
 ---
 

package/dist/cc-mirror.mjs

@@ -210,7 +210,7 @@ var DEFAULT_ROOT = path2.join(os.homedir(), ".cc-mirror");
 var DEFAULT_BIN_DIR = path2.join(os.homedir(), ".local", "bin");
 var TWEAKCC_VERSION = "3.2.2";
 var DEFAULT_NPM_PACKAGE = "@anthropic-ai/claude-code";
-var DEFAULT_NPM_VERSION = "2.0.76";
+var DEFAULT_NPM_VERSION = "2.1.1";
 
 // src/core/fs.ts
 import fs2 from "node:fs";
@@ -2672,8 +2672,8 @@ var configureTeamToolset = (configPath) => {
 };
 
 // src/core/variant-builder/steps/TeamModeStep.ts
-var TEAM_MODE_DISABLED = "function sU(){return!1}";
-var TEAM_MODE_ENABLED = "function sU(){return!0}";
+var TEAM_MODE_DISABLED = "function Uq(){return!1}";
+var TEAM_MODE_ENABLED = "function Uq(){return!0}";
 var TeamModeStep = class {
   name = "TeamMode";
   shouldEnableTeamMode(ctx) {
@@ -4124,8 +4124,8 @@ var InstallNpmUpdateStep = class {
 // src/core/variant-builder/update-steps/TeamModeUpdateStep.ts
 import fs13 from "node:fs";
 import path18 from "node:path";
-var TEAM_MODE_DISABLED2 = "function sU(){return!1}";
-var TEAM_MODE_ENABLED2 = "function sU(){return!0}";
+var TEAM_MODE_DISABLED2 = "function Uq(){return!1}";
+var TEAM_MODE_ENABLED2 = "function Uq(){return!0}";
 var TeamModeUpdateStep = class {
   name = "TeamMode";
   shouldEnableTeamMode(ctx) {
@@ -5297,6 +5297,13 @@ function filterTasks(tasks, filter, allTasks) {
       filtered = filtered.filter((t) => !isBlocking(t));
     }
   }
+  if (filter.ready !== void 0) {
+    if (filter.ready) {
+      filtered = filtered.filter((t) => t.status === "open" && !isBlocked(t, taskContext));
+    } else {
+      filtered = filtered.filter((t) => t.status === "resolved" || isBlocked(t, taskContext));
+    }
+  }
   if (filter.owner) {
     filtered = filtered.filter((t) => t.owner === filter.owner);
   }
@@ -5309,18 +5316,51 @@ function getTaskSummary(tasks) {
   const open = tasks.filter((t) => t.status === "open");
   const resolved = tasks.filter((t) => t.status === "resolved");
   const blocked = open.filter((t) => isBlocked(t, tasks));
+  const ready = open.filter((t) => !isBlocked(t, tasks));
   return {
     total: tasks.length,
     open: open.length,
     resolved: resolved.length,
+    ready: ready.length,
     blocked: blocked.length
   };
 }
+function getOpenBlockers(task, allTasks) {
+  if (task.blockedBy.length === 0) return [];
+  const taskMap = new Map(allTasks.map((t) => [t.id, t]));
+  return task.blockedBy.filter((id) => {
+    const blockingTask = taskMap.get(id);
+    return blockingTask && blockingTask.status === "open";
+  });
+}
 function sortTasksById(tasks) {
   return [...tasks].sort((a, b) => parseInt(a.id, 10) - parseInt(b.id, 10));
 }
 
 // src/cli/commands/tasks/output.ts
+function enrichTask(task, allTasks) {
+  const taskMap = new Map(allTasks.map((t) => [t.id, t]));
+  const blockedByWithStatus = task.blockedBy.map((id) => {
+    const blockingTask = taskMap.get(id);
+    return {
+      id,
+      status: blockingTask ? blockingTask.status : "unknown"
+    };
+  });
+  return {
+    id: task.id,
+    subject: task.subject,
+    description: task.description,
+    status: task.status,
+    owner: task.owner,
+    blocked: isBlocked(task, allTasks),
+    blockedBy: blockedByWithStatus,
+    openBlockers: getOpenBlockers(task, allTasks),
+    blocks: task.blocks,
+    references: task.references,
+    comments: task.comments
+  };
+}
 function truncate(text, maxLen) {
   if (text.length <= maxLen) return text;
   return text.slice(0, maxLen - 3) + "...";
@@ -5407,24 +5447,26 @@ function formatTaskDetail(task, location, allTasks) {
   }
   return lines.join("\n");
 }
-function formatTasksJson(tasks, location, summary) {
+function formatTasksJson(tasks, location, summary, allTasks) {
+  const enrichedTasks = tasks.map((t) => enrichTask(t, allTasks));
   return JSON.stringify(
     {
       variant: location.variant,
       team: location.team,
-      tasks,
+      tasks: enrichedTasks,
       summary
     },
     null,
     2
   );
 }
-function formatTaskJson(task, location) {
+function formatTaskJson(task, location, allTasks) {
+  const enrichedTask = enrichTask(task, allTasks);
   return JSON.stringify(
     {
       variant: location.variant,
       team: location.team,
-      task
+      task: enrichedTask
     },
     null,
     2
@@ -5433,10 +5475,10 @@ function formatTaskJson(task, location) {
 function formatMultiLocationJson(tasksByLocation) {
   return JSON.stringify(
     {
-      locations: tasksByLocation.map(({ location, tasks, summary }) => ({
+      locations: tasksByLocation.map(({ location, tasks, allTasks, summary }) => ({
         variant: location.variant,
         team: location.team,
-        tasks,
+        tasks: tasks.map((t) => enrichTask(t, allTasks)),
         summary
       }))
     },
@@ -5477,6 +5519,7 @@ function runTasksList(opts) {
         status: opts.status || "open",
         blocked: opts.blocked,
         blocking: opts.blocking,
+        ready: opts.ready,
         owner: opts.owner,
         limit: opts.limit
       },
@@ -5484,12 +5527,12 @@ function runTasksList(opts) {
     );
     const sortedTasks = sortTasksById(filteredTasks);
     const summary = getTaskSummary(allTasks);
-    return { location, tasks: sortedTasks, summary };
+    return { location, tasks: sortedTasks, allTasks, summary };
   });
   if (opts.json) {
     if (tasksByLocation.length === 1) {
-      const { location, tasks, summary } = tasksByLocation[0];
-      console.log(formatTasksJson(tasks, location, summary));
+      const { location, tasks, allTasks, summary } = tasksByLocation[0];
+      console.log(formatTasksJson(tasks, location, summary, allTasks));
     } else {
       console.log(formatMultiLocationJson(tasksByLocation));
     }
@@ -5520,7 +5563,7 @@ function runTasksShow(opts) {
     if (task) {
       const allTasks = loadAllTasks(location.tasksDir);
       if (opts.json) {
-        console.log(formatTaskJson(task, location));
+        console.log(formatTaskJson(task, location, allTasks));
       } else {
         console.log(formatTaskDetail(task, location, allTasks));
       }
@@ -5556,7 +5599,8 @@ function runTasksCreate(opts) {
     blockedBy: opts.blockedBy
   });
   if (opts.json) {
-    console.log(formatTaskJson(task, location));
+    const allTasks = loadAllTasks(location.tasksDir);
+    console.log(formatTaskJson(task, location, allTasks));
   } else {
     console.log(`Created task #${task.id}: ${task.subject}`);
     console.log(`Location: ${location.variant} / ${location.team}`);
@@ -5606,7 +5650,8 @@ function runTasksUpdate(opts) {
     }
     saveTask(location.tasksDir, task);
     if (opts.json) {
-      console.log(formatTaskJson(task, location));
+      const allTasks = loadAllTasks(location.tasksDir);
+      console.log(formatTaskJson(task, location, allTasks));
     } else {
       console.log(`Updated task #${task.id}: ${task.subject}`);
     }
@@ -5836,6 +5881,54 @@ function formatTaskGraph(tasks, variant, team) {
   lines.push(`Total: ${tasks.length} | Open: ${open.length} | Ready: ${ready.length} | Blocked: ${blocked.length}`);
   return lines.join("\n");
 }
+function formatTaskGraphJson(tasks, variant, team) {
+  const taskMap = new Map(tasks.map((t) => [t.id, t]));
+  const nodes = tasks.map((task) => ({
+    id: task.id,
+    subject: task.subject,
+    status: task.status,
+    blocked: isBlocked(task, tasks),
+    blockedBy: task.blockedBy.map((id) => ({
+      id,
+      status: taskMap.get(id)?.status ?? "unknown"
+    })),
+    openBlockers: getOpenBlockers(task, tasks),
+    blocks: task.blocks,
+    depth: calculateDepth(task, tasks, /* @__PURE__ */ new Set())
+  }));
+  const roots = tasks.filter((t) => t.blockedBy.length === 0).map((t) => t.id);
+  const leaves = tasks.filter((t) => t.blocks.length === 0).map((t) => t.id);
+  const orphans = tasks.filter((t) => t.blockedBy.length > 0 && t.blockedBy.some((id) => !taskMap.has(id))).map((t) => t.id);
+  const summary = getTaskSummary(tasks);
+  return JSON.stringify(
+    {
+      variant,
+      team,
+      nodes,
+      roots,
+      leaves,
+      orphans,
+      summary
+    },
+    null,
+    2
+  );
+}
+function calculateDepth(task, allTasks, visited) {
+  if (task.blockedBy.length === 0) return 0;
+  if (visited.has(task.id)) return 0;
+  visited.add(task.id);
+  const taskMap = new Map(allTasks.map((t) => [t.id, t]));
+  let maxDepth = 0;
+  for (const blockerId of task.blockedBy) {
+    const blocker = taskMap.get(blockerId);
+    if (blocker) {
+      const depth = calculateDepth(blocker, allTasks, new Set(visited));
+      maxDepth = Math.max(maxDepth, depth + 1);
+    }
+  }
+  return maxDepth;
+}
 function runTasksGraph(opts) {
   const context = resolveContext({
     rootDir: opts.rootDir,
@@ -5849,10 +5942,29 @@ function runTasksGraph(opts) {
   const location = context.locations[0];
   const tasks = loadAllTasks(location.tasksDir);
   if (tasks.length === 0) {
-    console.log(`No tasks found in ${location.variant} / ${location.team}`);
+    if (opts.json) {
+      console.log(
+        JSON.stringify(
+          {
+            variant: location.variant,
+            team: location.team,
+            nodes: [],
+            summary: { total: 0, open: 0, resolved: 0, ready: 0, blocked: 0 }
+          },
+          null,
+          2
+        )
+      );
+    } else {
+      console.log(`No tasks found in ${location.variant} / ${location.team}`);
+    }
     return;
   }
-  console.log(formatTaskGraph(tasks, location.variant, location.team));
+  if (opts.json) {
+    console.log(formatTaskGraphJson(tasks, location.variant, location.team));
+  } else {
+    console.log(formatTaskGraph(tasks, location.variant, location.team));
+  }
 }
 
 // src/cli/commands/tasks/archive.ts
@@ -5973,6 +6085,7 @@ LIST OPTIONS:
   --status <s>      Filter: open, resolved, all (default: open)
   --blocked         Show only blocked tasks
   --blocking        Show only tasks blocking others
+  --ready           Show only ready tasks (open + not blocked)
   --owner <id>      Filter by owner
   --limit <n>       Limit results (default: 50)
 
@@ -6112,7 +6225,7 @@ async function runTasksCommand({ opts }) {
       break;
     }
     case "graph": {
-      runTasksGraph({ rootDir, variant, team });
+      runTasksGraph({ rootDir, variant, team, json });
       break;
     }
     case "archive": {
@@ -6139,6 +6252,7 @@ async function runTasksCommand({ opts }) {
         status: opts.status || "open",
         blocked: opts.blocked !== void 0 ? Boolean(opts.blocked) : void 0,
         blocking: opts.blocking !== void 0 ? Boolean(opts.blocking) : void 0,
+        ready: opts.ready !== void 0 ? Boolean(opts.ready) : void 0,
         owner: opts.owner,
         limit: opts.limit !== void 0 ? Number(opts.limit) : 50,
         json

package/dist/skills/orchestration/references/tools.md

@@ -252,22 +252,22 @@ TaskOutput(task_id="abc123")
 
 ### Model Selection
 
-| Task Type                        | Model    | Why                                      |
-| -------------------------------- | -------- | ---------------------------------------- |
-| Fetch files, grep, find things   | `haiku`  | Errand runner - spawn many in parallel   |
-| Gather info for synthesis        | `haiku`  | No judgment needed, just retrieval       |
-| Well-structured implementation   | `sonnet` | Capable worker - needs clear direction   |
-| Research, reading docs           | `sonnet` | Can follow patterns and instructions     |
-| Security review                  | `opus`   | Critical thinking, trust its judgment    |
-| Architecture/design decisions    | `opus`   | Ambiguous, needs creative problem-solving|
-| Complex debugging                | `opus`   | Reasoning across systems                 |
+| Task Type                      | Model    | Why                                       |
+| ------------------------------ | -------- | ----------------------------------------- |
+| Fetch files, grep, find things | `haiku`  | Errand runner - spawn many in parallel    |
+| Gather info for synthesis      | `haiku`  | No judgment needed, just retrieval        |
+| Well-structured implementation | `sonnet` | Capable worker - needs clear direction    |
+| Research, reading docs         | `sonnet` | Can follow patterns and instructions      |
+| Security review                | `opus`   | Critical thinking, trust its judgment     |
+| Architecture/design decisions  | `opus`   | Ambiguous, needs creative problem-solving |
+| Complex debugging              | `opus`   | Reasoning across systems                  |
 
 ### Parallelism Strategy
 
-| Priority     | Approach                                           |
-| ------------ | -------------------------------------------------- |
-| **Speed**    | Swarm of haiku for gathering, parallel sonnet work |
-| **Cost**     | Haiku wherever possible, sonnet only when needed   |
+| Priority     | Approach                                             |
+| ------------ | ---------------------------------------------------- |
+| **Speed**    | Swarm of haiku for gathering, parallel sonnet work   |
+| **Cost**     | Haiku wherever possible, sonnet only when needed     |
 | **Balanced** | Haiku to gather, sonnet to implement, opus to decide |
 
 ---

package/dist/tui.mjs

@@ -1577,7 +1577,7 @@ var DEFAULT_ROOT = path.join(os2.homedir(), ".cc-mirror");
 var DEFAULT_BIN_DIR = path.join(os2.homedir(), ".local", "bin");
 var TWEAKCC_VERSION = "3.2.2";
 var DEFAULT_NPM_PACKAGE = "@anthropic-ai/claude-code";
-var DEFAULT_NPM_VERSION = "2.0.76";
+var DEFAULT_NPM_VERSION = "2.1.1";
 
 // src/core/fs.ts
 import fs from "node:fs";
@@ -2520,8 +2520,8 @@ var configureTeamToolset = (configPath) => {
 };
 
 // src/core/variant-builder/steps/TeamModeStep.ts
-var TEAM_MODE_DISABLED = "function sU(){return!1}";
-var TEAM_MODE_ENABLED = "function sU(){return!0}";
+var TEAM_MODE_DISABLED = "function Uq(){return!1}";
+var TEAM_MODE_ENABLED = "function Uq(){return!0}";
 var TeamModeStep = class {
   name = "TeamMode";
   shouldEnableTeamMode(ctx) {
@@ -3972,8 +3972,8 @@ var InstallNpmUpdateStep = class {
 // src/core/variant-builder/update-steps/TeamModeUpdateStep.ts
 import fs12 from "node:fs";
 import path17 from "node:path";
-var TEAM_MODE_DISABLED2 = "function sU(){return!1}";
-var TEAM_MODE_ENABLED2 = "function sU(){return!0}";
+var TEAM_MODE_DISABLED2 = "function Uq(){return!1}";
+var TEAM_MODE_ENABLED2 = "function Uq(){return!0}";
 var TeamModeUpdateStep = class {
   name = "TeamMode";
   shouldEnableTeamMode(ctx) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-mirror",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "type": "module",
   "description": "Claude Code, Unshackled — Pre-configured variants with multi-agent orchestration, custom providers, and battle-tested enhancements",
   "author": "Numman Ali",