open-coleslaw 0.6.5 → 0.6.7

package/README.md

@@ -7,7 +7,7 @@
 
 > **Type a prompt. Get a real multi-agent engineering team. No commands to learn.**
 
-Open Coleslaw is a multi-agent orchestrator plugin for [Claude Code](https://claude.com/claude-code). Every prompt runs through a **kickoff meeting → per-MVP design meeting → plan mode → parallel workers → verification** pipeline — with each speaker turn being a real `Agent` dispatch, not role-play.
+Open Coleslaw is a multi-agent orchestrator plugin for [Claude Code](https://claude.com/claude-code). Every prompt enters Claude Code's native **plan mode**, runs a **clarify → kickoff → per-MVP design meeting** cycle inside it, and surfaces the synthesised plan via `ExitPlanMode` — each speaker turn being a real `Agent` dispatch, not role-play.
 
 ![Open Coleslaw dashboard](docs/assets/dashboard.png)
 
@@ -36,9 +36,9 @@ That's it. Watch the meeting unfold at **http://localhost:35143**.
 
 | You type | The pipeline runs |
 |---|---|
-| `Build me a balance-game web app` | Kickoff → 3 MVPs → per-MVP design meeting → plan mode → workers → verified |
-| `Fix the flaky login test` | Kickoff (1 MVP) → design meeting w/ engineer + verifier → plan → fix → green |
-| `Should we migrate from Redux to Zustand?` | Design meeting w/ architect + engineer + researcher → minutes with recommendation |
+| `Build me a balance-game web app` | EnterPlanMode → planner asks 3-4 clarifying questions → MVP list → per-MVP design meeting → ExitPlanMode with plan → workers → verified |
+| `Fix the flaky login test` | EnterPlanMode → planner returns `READY` (no clarify) → 1-MVP design w/ engineer + verifier → ExitPlanMode → fix → green |
+| `Should we migrate from Redux to Zustand?` | EnterPlanMode → design meeting w/ architect + engineer + researcher → ExitPlanMode with a recommendation plan |
 
 You don't call a tool. You don't pick a department. You don't write prompt templates.
 The main Claude session **dispatches each specialist as a real subagent** and
@@ -131,7 +131,8 @@ Coleslaw is a side dish that's already made. You don't prepare it — you just e
 ### Key Decisions
 
 - **The orchestrator is your proxy, not a CEO.** You are the decision-maker. The orchestrator acts on your behalf but escalates important choices via `@mention`.
-- **Kickoff first.** Every non-trivial request starts by breaking itself into ordered MVPs.
+- **The meeting IS the plan.** Every planning cycle runs inside Claude Code's native plan mode. The `ExitPlanMode` approval is your checkpoint, not a separate step.
+- **Clarify first, then decompose.** Kickoff planner may ask up to 4 structured questions (via `AskUserQuestion`) before breaking the request into MVPs.
 - **Consensus, not round count.** A meeting ends when everyone actually agrees (or you're asked to break a tie).
 - **Minutes are the real artifact.** They survive `/compact` and `/clear` — your Claude Code context is disposable.
 - **TDD by default.** The engineer and verifier draft tests before workers start writing code.
@@ -156,13 +157,14 @@ See [`CLAUDE.md`](CLAUDE.md) and [`docs/smoke-tests.md`](docs/smoke-tests.md) be
 ---
 
 <details>
-<summary><strong>🛠 15 MCP tools</strong> (the pipeline calls these — you don't)</summary>
+<summary><strong>🛠 16 MCP tools</strong> (the pipeline calls these — you don't)</summary>
 
 | Tool | What it does |
 |------|-------------|
 | `start-meeting` | Creates a meeting record (kickoff / design / verify-retry) |
 | `add-transcript` | Saves a speaker's turn |
 | `generate-minutes` | Writes PRD minutes from transcripts |
+| `update-mvps` | Upserts the MVP list or patches one MVP's status; powers the dashboard sidebar |
 | `get-meeting-status` | Reads meeting progress |
 | `get-minutes` | Retrieves full / summary / tasks-only minutes |
 | `execute-tasks` | Returns the structured task list from minutes for worker dispatch |

package/dist/index.js

@@ -514,6 +514,73 @@ function getTasksFromMinutes(meetingId) {
 
 // src/storage/mvp-store.ts
 import { v4 as uuidv46 } from "uuid";
+function rowToMvp(row) {
+  return {
+    id: row.id,
+    kickoffMeetingId: row.kickoff_meeting_id,
+    title: row.title,
+    goal: row.goal,
+    status: row.status,
+    orderIndex: row.order_index,
+    designMeetingId: row.design_meeting_id,
+    createdAt: row.created_at,
+    completedAt: row.completed_at
+  };
+}
+function createMvp(input) {
+  const db = getDb();
+  const id = input.id ?? uuidv46();
+  const createdAt = Date.now();
+  const status = input.status ?? "pending";
+  db.prepare(
+    `INSERT INTO mvps (id, kickoff_meeting_id, title, goal, status, order_index, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`
+  ).run(id, input.kickoffMeetingId, input.title, input.goal, status, input.orderIndex, createdAt);
+  return {
+    id,
+    kickoffMeetingId: input.kickoffMeetingId,
+    title: input.title,
+    goal: input.goal,
+    status,
+    orderIndex: input.orderIndex,
+    designMeetingId: null,
+    createdAt,
+    completedAt: null
+  };
+}
+function getMvp(id) {
+  const db = getDb();
+  const row = db.prepare("SELECT * FROM mvps WHERE id = ?").get(id);
+  return row ? rowToMvp(row) : null;
+}
+function listMvpsByKickoff(kickoffMeetingId) {
+  const db = getDb();
+  const rows = db.prepare("SELECT * FROM mvps WHERE kickoff_meeting_id = ? ORDER BY order_index ASC").all(kickoffMeetingId);
+  return rows.map(rowToMvp);
+}
+function updateMvp(id, updates) {
+  const db = getDb();
+  const current = getMvp(id);
+  if (!current) return null;
+  const fields = [];
+  const values = [];
+  if (updates.status !== void 0) {
+    fields.push("status = ?");
+    values.push(updates.status);
+  }
+  if (updates.designMeetingId !== void 0) {
+    fields.push("design_meeting_id = ?");
+    values.push(updates.designMeetingId);
+  }
+  if (updates.completedAt !== void 0) {
+    fields.push("completed_at = ?");
+    values.push(updates.completedAt);
+  }
+  if (fields.length === 0) return current;
+  values.push(id);
+  db.prepare(`UPDATE mvps SET ${fields.join(", ")} WHERE id = ?`).run(...values);
+  return getMvp(id);
+}
 
 // src/types/agent.ts
 var DEPARTMENT_TOOLS = {
@@ -2883,6 +2950,102 @@ function extractSection(md, heading) {
   return out;
 }
 
+// src/tools/update-mvps.ts
+import { z as z15 } from "zod";
+var mvpInput = z15.object({
+  id: z15.string().min(1).describe('Stable MVP id (e.g., "mvp-1")'),
+  title: z15.string().min(1),
+  goal: z15.string(),
+  status: z15.enum(["pending", "in-progress", "done", "blocked"]),
+  orderIndex: z15.number().int().min(0)
+});
+var patchInput = z15.object({
+  id: z15.string().min(1),
+  status: z15.enum(["pending", "in-progress", "done", "blocked"]).optional()
+});
+var updateMvpsSchema = {
+  kickoffMeetingId: z15.string().optional().describe("The kickoff meeting id these MVPs belong to. Required when `mvps` is provided."),
+  mvps: z15.array(mvpInput).optional().describe(
+    "Full MVP list to upsert. Use after the kickoff decompose step. Replaces the entire per-kickoff list."
+  ),
+  patch: patchInput.optional().describe(
+    "Single-MVP patch. Use when an MVP transitions to in-progress (design meeting starts), done (verifier PASS), or blocked (verifier FAIL)."
+  )
+};
+function toSummary(r) {
+  return {
+    id: r.id,
+    title: r.title,
+    goal: r.goal,
+    status: r.status,
+    orderIndex: r.orderIndex
+  };
+}
+async function updateMvpsHandler({
+  kickoffMeetingId,
+  mvps,
+  patch
+}) {
+  try {
+    if (!mvps && !patch) {
+      throw new Error("Provide either `mvps` (full list) or `patch` (single update).");
+    }
+    let current = [];
+    if (mvps) {
+      if (!kickoffMeetingId) {
+        throw new Error("`kickoffMeetingId` is required when `mvps` is provided.");
+      }
+      for (const m of mvps) {
+        const existing = getMvp(m.id);
+        if (existing) {
+          updateMvp(m.id, { status: m.status });
+        } else {
+          createMvp({
+            id: m.id,
+            kickoffMeetingId,
+            title: m.title,
+            goal: m.goal,
+            status: m.status,
+            orderIndex: m.orderIndex
+          });
+        }
+      }
+      current = listMvpsByKickoff(kickoffMeetingId);
+    }
+    if (patch) {
+      const existing = getMvp(patch.id);
+      if (!existing) {
+        throw new Error(`MVP not found: ${patch.id}`);
+      }
+      const completedAt = patch.status === "done" ? Date.now() : void 0;
+      updateMvp(patch.id, {
+        status: patch.status,
+        ...completedAt !== void 0 ? { completedAt } : {}
+      });
+      current = listMvpsByKickoff(existing.kickoffMeetingId);
+    }
+    const summaries = current.map(toSummary);
+    eventBus.emitAgentEvent({ kind: "mvp_progress", mvps: summaries });
+    logger.info(
+      `update-mvps: emitted mvp_progress with ${summaries.length} MVP(s)`
+    );
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ mvps: summaries }, null, 2)
+        }
+      ]
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      content: [{ type: "text", text: JSON.stringify({ error: message }, null, 2) }],
+      isError: true
+    };
+  }
+}
+
 // src/server.ts
 function createServer() {
   const server = new McpServer({
@@ -2978,6 +3141,12 @@ function createServer() {
     generateMinutesSchema,
     generateMinutesHandler
   );
+  server.tool(
+    "update-mvps",
+    "Upsert the full per-kickoff MVP list (pass `mvps`) OR patch a single MVP status (pass `patch`). Emits `mvp_progress` so the dashboard sidebar stays in sync. Call after kickoff decompose, when each MVP design meeting starts, and when verifier PASS/FAIL finalises an MVP.",
+    updateMvpsSchema,
+    updateMvpsHandler
+  );
   return server;
 }