open-coleslaw 0.3.2 → 0.5.0

package/README.md

@@ -2,7 +2,7 @@
 
 **Just type your prompt. Like coleslaw — it's already prepared, just scoop and eat.**
 
-Open Coleslaw is a multi-agent orchestrator plugin for Claude Code. It gives you an entire AI engineering team — architects, engineers, QA leads, product managers — that organizes itself, holds meetings, writes PRD-format minutes, and executes tasks.
+Open Coleslaw is a multi-agent orchestrator plugin for Claude Code. It gives you an entire AI engineering team — planner, architect, engineer, verifier, product manager, researcher — that organizes itself, runs real round-robin meetings, only ends a meeting when everyone actually agrees, and executes in MVP-sized cycles.
 
 Zero commands to memorize. Zero tools to call manually. Your AI team is already hired.
 
@@ -14,18 +14,21 @@ You type a prompt like *"Build me a balance game app"*. That's it.
 You: "Build me a balance game app"
 
   → Orchestrator dispatched (Agent tool)
-  → Convenes Architecture + Engineering + Product leaders
-  → Leaders hold a structured meeting
-  → PRD meeting minutes saved to docs/open-coleslaw/
-  → Plan Mode activated — you review the implementation plan
-  → You approve
-  → Implementer agents write the code
-  → Results reported
+  → Kickoff meeting: planner breaks it into ordered MVPs
+  → For each MVP:
+      → Design meeting: round-robin, consensus-based termination
+      → PRD meeting minutes saved to docs/open-coleslaw/
+      → Plan Mode activated — you review the implementation plan
+      → You approve
+      → Workers write the code in parallel
+      → Verifier runs tests/build
+      → Pass → next MVP ·  Fail → verify-retry meeting
+  → All MVPs done → final report
 ```
 
 You never call a tool. You never pick a department. You never manage an agent. The orchestrator handles everything — including entering **Plan Mode** so you can review the implementation plan in the native UI before any code is written.
 
-Meeting minutes are saved to `docs/open-coleslaw/` in your project, so you can always refer back to past decisions.
+Meeting minutes are saved to `docs/open-coleslaw/` in your project, so they persist even if you `/compact` or `/clear` your Claude Code context between MVPs.
 
 ## Installation
 
@@ -46,105 +49,123 @@ Start a new session and type anything:
 Design a REST API for a todo app
 ```
 
-You should see the orchestrator agent being dispatched and a meeting starting automatically.
+You should see the orchestrator agent being dispatched and a kickoff meeting starting automatically.
 
 ## The Pipeline
 
-Every request follows this flow. No exceptions.
+Every request follows this flow.
 
 ```
-Prompt → Orchestrator → Meeting → Minutes → Plan Mode → Approve → Implement
+Prompt
+  → Orchestrator
+  → Kickoff meeting (planner breaks request into MVPs)
+  → for each MVP:
+       Design meeting → consensus → Minutes → Plan Mode → Approve → Workers → Verify
+  → Final report
 ```
 
-1. **Orchestrator dispatched** — analyzes your request, selects departments
-2. **Meeting convened** — leaders discuss via Agent tool
-3. **PRD minutes saved** — to `docs/open-coleslaw/` in your project
-4. **Plan Mode activated** — implementation plan presented in native Plan Mode UI
-5. **You review and approve** — or request changes (chains a follow-up meeting)
-6. **Implementer agents dispatched** — write code following the approved plan
-7. **Results reported** — final output delivered to you
+Verification failure on an MVP doesn't abort the cycle — it opens a focused `verify-retry` meeting and re-plans the fix.
 
-## The Agent Hierarchy
+When the whole cycle ends the orchestrator touches a marker file, and the `Stop` hook checks your context usage. If you're over ~30%, it suggests running `/compact` or `/clear` before the next task. Minutes on disk mean you lose nothing.
+
+## The Agent Cast
 
 ```
-        ┌─────────────────┐
-        │   Orchestrator   │  ← Your proxy (NOT a CEO)
-        │   (claude-opus)  │    Decides, but asks you
-        └────────┬────────┘    for important calls
-     ┌───────────┼───────────┐
-     ▼           ▼           ▼
-┌─────────┐ ┌─────────┐ ┌─────────┐
-│  Arch   │ │  Eng    │ │  QA     │  ← Leaders meet & discuss
-│ Leader  │ │ Leader  │ │ Leader  │    Discuss via Agent tool
-└────┬────┘ └────┬────┘ └────┬────┘
-     └───────────┼───────────┘
-                 ▼
-         ┌──────────────┐
-         │ Implementer  │  ← Writes code after plan approval
-         └──────────────┘
+         ┌─────────────────┐
+         │   Orchestrator   │  ← Your proxy
+         │  (claude-opus)   │
+         └────────┬────────┘
+                  │
+          (Kickoff → per-MVP loop)
+                  │
+    ┌─────────────┼─────────────────────────────┐
+    ▼             ▼             ▼               ▼
+┌─────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
+│ Planner │ │ Architect│ │ Engineer │ │ Verifier │   dynamically convened +
+│(chair)  │ │          │ │          │ │          │   product-manager / researcher
+└─────────┘ └──────────┘ └──────────┘ └──────────┘
+                  │
+           Plan Mode → User approves
+                  │
+    ┌─────────────┼─────────────┐
+    ▼             ▼             ▼
+┌────────┐  ┌────────┐  ┌────────┐
+│Worker 1│  │Worker 2│  │Worker N│     ← Parallel implementation
+└────────┘  └────────┘  └────────┘
+                  │
+            Verifier runs tests
+            /                \
+         Pass               Fail → verify-retry meeting
+          ↓
+     Next MVP (or done)
 ```
 
-**5 Departments**: Architecture, Engineering, QA, Product, Research
+**7 Specialists**: Planner, Architect, Engineer, Verifier, Product Manager, Researcher, plus Worker (parallelized).
+
+The **planner always attends** — they chair the meeting, run the round-robin, and drive consensus. Other specialists are convened dynamically based on the task.
+
+## Meetings That Actually End on Agreement
+
+Rounds are not fixed. After every round the planner asks each participant AGREE or DISAGREE. The meeting only proceeds to synthesis when everyone agrees. If round 10 passes without consensus, the planner escalates via `@mention` for you to decide.
 
-Each leader autonomously decides how many workers to hire based on task complexity.
+This is deliberately slower than a fixed-round meeting — but each MVP ends with a real decision, not a paper one.
 
 ## What's Inside
 
-### 16 MCP Tools (orchestrator calls these — you never do)
+### 15 MCP Tools (orchestrator calls these — you never do)
 
 | Tool | What It Does |
 |------|-------------|
-| `start-meeting` | Creates a meeting record, recommends departments |
-| `add-transcript` | Saves a leader's discussion input |
-| `generate-minutes` | Converts transcripts into PRD meeting minutes |
-| `get-meeting-status` | Checks meeting progress and agent states |
-| `get-minutes` | Retrieves PRD-format meeting minutes |
-| `compact-minutes` | Converts minutes into actionable tasks per department |
-| `execute-tasks` | Returns structured task list for implementer agents |
+| `start-meeting` | Creates a meeting record (kickoff / design / verify-retry) |
+| `add-transcript` | Saves a speaker's turn |
+| `generate-minutes` | Writes PRD minutes from transcripts |
+| `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 |
 | `get-task-report` | Shows execution results per department |
-| `get-agent-tree` | Displays the full agent hierarchy |
-| `respond-to-mention` | Handles decisions the agents need from you |
-| `get-mentions` | Lists pending @mention decision points |
-| `cancel-meeting` | Stops a meeting and cascades to all workers |
+| `get-agent-tree` | Displays the agent hierarchy (bookkeeping) |
+| `respond-to-mention` | Resolves a pending decision escalated by an agent |
+| `get-mentions` | Lists pending @mention decisions |
+| `cancel-meeting` | Stops a meeting and cascades to workers |
 | `list-meetings` | Shows meeting history |
 | `create-capability` | Self-extends the plugin with new hooks/skills |
-| `get-cost-summary` | Tracks spending per agent, meeting, department |
-| `chain-meeting` | Links meetings — output of one feeds into the next |
+| `get-cost-summary` | Tracks spend per agent/meeting/department |
+| `chain-meeting` | Links meetings — previous minutes feed the next |
 
-### 7 Agents (dispatched via Agent tool)
+### 8 Agents (dispatched via the Agent tool)
 
 | Agent | Role |
 |-------|------|
-| `orchestrator` | Your proxy — manages the full pipeline |
-| `arch-leader` | System design, API contracts, schemas |
-| `eng-leader` | Implementation feasibility, code quality |
-| `qa-leader` | Testing strategy, security, edge cases |
-| `pm-leader` | Requirements, user stories, prioritization |
-| `research-leader` | Codebase exploration, prior art |
-| `implementer` | Writes code after plan approval |
+| `orchestrator` | Your proxy — manages the kickoff + per-MVP cycles |
+| `planner` | Runs the meeting, chairs rounds, checks consensus, synthesises minutes |
+| `architect` | System design, API contracts, schemas |
+| `engineer` | Implementation feasibility, code quality |
+| `verifier` | Testing strategy at design time; tests/build at verify time |
+| `product-manager` | Requirements, user stories, prioritisation |
+| `researcher` | Codebase exploration, prior art, library comparison |
+| `worker` | Writes code (N workers in parallel) |
 
 ### 7 Skills
 
 | Skill | Purpose |
 |-------|---------|
-| `using-open-coleslaw` | Loaded at session start — ensures all requests go through the pipeline |
+| `using-open-coleslaw` | Injected at session start — ensures all requests go through the pipeline |
 | `meeting` | Dispatches the orchestrator for the meeting → plan → implement flow |
 | `status` | Shows active meetings, agents, pending mentions |
-| `dashboard` | Opens the real-time Neon Ops Center |
+| `dashboard` | Opens the real-time dashboard |
 | `mention` | Handles pending @mention decisions |
 | `agents` | Shows the agent hierarchy tree |
 | `minutes` | Browses past meeting minutes |
 
-### Real-Time Dashboard
+### Real-Time Meeting Dashboard
 
-A cyberpunk-themed "Neon Ops Center" at `http://localhost:35143`:
+A live meeting viewer at `http://localhost:35143`:
 
-- Live agent hierarchy with animated connections
-- Per-project tabs (multiple terminals → multiple tabs)
-- Meeting progress tracking
-- Task delegation and completion flow
-- @mention alerts
-- Duplicate project names get auto-numbered: `project`, `project (1)`
+- **Current meeting as a thread** — speakers post comments, consensus stances are shown inline
+- **MVP progress panel** — which MVPs are pending / in-progress / done
+- **User comment box** — type a note straight into the meeting from the browser; the orchestrator picks it up at the next round boundary (file-queue routed to `docs/open-coleslaw/.pending-comments.jsonl`)
+- **Terminal comments also work** — if you prompt Claude Code while a meeting is in progress, your prompt becomes a user turn in the thread
+- Per-project tabs (multiple terminals → multiple tabs); duplicate names auto-number: `project`, `project (1)`
 
 ### Self-Extending
 
@@ -154,10 +175,10 @@ Ask for a workflow that doesn't exist yet, and the orchestrator creates it — n
 
 | Tier | Model | Role |
 |------|-------|------|
-| Orchestrator | claude-opus-4-6 (1M) | Full-picture routing, delegation, judgment |
-| Leader | claude-sonnet-4-6 | Meetings, technical decisions |
-| Worker | claude-sonnet-4-6 | Code, implementation |
-| Research Worker | claude-haiku-4-5 | Quick lookups, exploration |
+| Orchestrator | claude-opus (1M context) | Full-picture routing, delegation, judgment |
+| Leader (specialists) | claude-sonnet | Meetings, technical decisions |
+| Worker | claude-sonnet | Code, implementation |
+| Research Worker | claude-haiku | Quick lookups, exploration |
 
 ## Philosophy
 
@@ -168,10 +189,10 @@ 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.
-- **Meeting first, always.** Even "simple" requests go through the pipeline. If it's truly simple, the meeting will be fast.
-- **MVP cycles.** Work happens in loops: meeting → develop → verify → (re-meet if needed).
-- **Rules survive context compaction.** The `using-open-coleslaw` skill is injected at every session start. The system never forgets how to behave.
-- **Agents check before they code.** Every agent analyzes the project's dependencies, existing code, and conventions before writing anything.
+- **Kickoff first.** Every non-trivial request starts by breaking itself into ordered MVPs.
+- **Consensus, not round count.** A meeting ends when everyone actually agrees (or you are asked to break a tie).
+- **Minutes are the real artifact.** They survive `/compact` and `/clear` — your Claude Code context is disposable.
+- **Agents check before they code.** Every specialist reads the project's state before proposing anything.
 
 ## Development
 
@@ -184,7 +205,7 @@ npm run build
 # Run with mock agents (no Claude CLI needed)
 COLESLAW_MOCK=1 node dist/index.js
 
-# Run tests (218 tests)
+# Run tests
 npm test
 
 # Type check

package/dist/{chunk-GFILTXTU.js → chunk-IQPO75GF.js}

@@ -86,6 +86,17 @@ var MIGRATIONS = [
     event_type TEXT NOT NULL,
     payload TEXT NOT NULL,
     created_at INTEGER NOT NULL
+  )`,
+  `CREATE TABLE IF NOT EXISTS mvps (
+    id TEXT PRIMARY KEY,
+    kickoff_meeting_id TEXT NOT NULL,
+    title TEXT NOT NULL,
+    goal TEXT NOT NULL,
+    status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending', 'in-progress', 'done', 'blocked')),
+    order_index INTEGER NOT NULL,
+    design_meeting_id TEXT,
+    created_at INTEGER NOT NULL,
+    completed_at INTEGER
   )`
 ];
 function applyMigrations(database) {
@@ -132,4 +143,4 @@ export {
   getDb,
   closeDb
 };
-//# sourceMappingURL=chunk-GFILTXTU.js.map
+//# sourceMappingURL=chunk-IQPO75GF.js.map

package/dist/chunk-IQPO75GF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/db.ts"],"sourcesContent":["import Database from 'better-sqlite3';\nimport type { Database as DatabaseType } from 'better-sqlite3';\nimport { mkdirSync, existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { homedir } from 'node:os';\n\nconst DB_DIR = join(homedir(), '.open-coleslaw');\nconst DB_PATH = join(DB_DIR, 'data.db');\n\nlet db: DatabaseType | null = null;\n\nconst MIGRATIONS: string[] = [\n  `CREATE TABLE IF NOT EXISTS agents (\n    id TEXT PRIMARY KEY,\n    tier TEXT NOT NULL CHECK(tier IN ('orchestrator', 'leader', 'worker')),\n    role TEXT NOT NULL,\n    department TEXT NOT NULL,\n    parent_id TEXT,\n    meeting_id TEXT,\n    status TEXT NOT NULL DEFAULT 'idle',\n    current_task TEXT,\n    session_id TEXT,\n    spawned_at INTEGER NOT NULL,\n    completed_at INTEGER,\n    cost_usd REAL DEFAULT 0\n  )`,\n\n  `CREATE TABLE IF NOT EXISTS meetings (\n    id TEXT PRIMARY KEY,\n    topic TEXT NOT NULL,\n    agenda TEXT NOT NULL,\n    participant_ids TEXT NOT NULL,\n    status TEXT NOT NULL DEFAULT 'pending',\n    phase TEXT NOT NULL DEFAULT 'orchestrator-phase',\n    started_at INTEGER,\n    completed_at INTEGER,\n    initiated_by TEXT NOT NULL\n  )`,\n\n  `CREATE TABLE IF NOT EXISTS transcript_entries (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    meeting_id TEXT NOT NULL,\n    speaker_id TEXT NOT NULL,\n    speaker_role TEXT NOT NULL,\n    agenda_item_index INTEGER,\n    round_number INTEGER,\n    content TEXT NOT NULL,\n    token_count INTEGER DEFAULT 0,\n    created_at INTEGER NOT NULL\n  )`,\n\n  `CREATE TABLE IF NOT EXISTS minutes (\n    id TEXT PRIMARY KEY,\n    meeting_id TEXT NOT NULL UNIQUE,\n    format TEXT NOT NULL DEFAULT 'prd',\n    content TEXT NOT NULL,\n    action_items TEXT NOT NULL DEFAULT '[]',\n    created_at INTEGER NOT NULL\n  )`,\n\n  `CREATE TABLE IF NOT EXISTS workers (\n    id TEXT PRIMARY KEY,\n    leader_id TEXT NOT NULL,\n    meeting_id TEXT NOT NULL,\n    task_description TEXT NOT NULL,\n    task_type TEXT,\n    status TEXT NOT NULL DEFAULT 'pending',\n    input_context TEXT,\n    output_result TEXT,\n    error_message TEXT,\n    dependencies TEXT NOT NULL DEFAULT '[]',\n    spawned_at INTEGER NOT NULL,\n    completed_at INTEGER,\n    cost_usd REAL DEFAULT 0\n  )`,\n\n  `CREATE TABLE IF NOT EXISTS mentions (\n    id TEXT PRIMARY KEY,\n    meeting_id TEXT NOT NULL,\n    agenda_item TEXT,\n    summary TEXT NOT NULL,\n    options TEXT NOT NULL DEFAULT '[]',\n    urgency TEXT NOT NULL DEFAULT 'advisory',\n    status TEXT NOT NULL DEFAULT 'pending',\n    user_decision TEXT,\n    user_reasoning TEXT,\n    created_at INTEGER NOT NULL,\n    resolved_at INTEGER\n  )`,\n\n  `CREATE TABLE IF NOT EXISTS events (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    event_type TEXT NOT NULL,\n    payload TEXT NOT NULL,\n    created_at INTEGER NOT NULL\n  )`,\n\n  `CREATE TABLE IF NOT EXISTS mvps (\n    id TEXT PRIMARY KEY,\n    kickoff_meeting_id TEXT NOT NULL,\n    title TEXT NOT NULL,\n    goal TEXT NOT NULL,\n    status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending', 'in-progress', 'done', 'blocked')),\n    order_index INTEGER NOT NULL,\n    design_meeting_id TEXT,\n    created_at INTEGER NOT NULL,\n    completed_at INTEGER\n  )`,\n];\n\nfunction applyMigrations(database: DatabaseType): void {\n  database.exec(`\n    CREATE TABLE IF NOT EXISTS _migrations (\n      id INTEGER PRIMARY KEY,\n      applied_at INTEGER NOT NULL\n    )\n  `);\n\n  const applied = new Set(\n    database\n      .prepare('SELECT id FROM _migrations')\n      .all()\n      .map((row) => (row as { id: number }).id)\n  );\n\n  const applyMigration = database.transaction(() => {\n    for (let i = 0; i < MIGRATIONS.length; i++) {\n      if (!applied.has(i)) {\n        database.exec(MIGRATIONS[i]);\n        database\n          .prepare('INSERT INTO _migrations (id, applied_at) VALUES (?, ?)')\n          .run(i, Date.now());\n      }\n    }\n  });\n\n  applyMigration();\n}\n\nexport function getDb(): DatabaseType {\n  if (db) {\n    return db;\n  }\n\n  if (!existsSync(DB_DIR)) {\n    mkdirSync(DB_DIR, { recursive: true });\n  }\n\n  db = new Database(DB_PATH);\n  db.pragma('journal_mode = WAL');\n  db.pragma('foreign_keys = ON');\n\n  applyMigrations(db);\n\n  return db;\n}\n\nexport function closeDb(): void {\n  if (db) {\n    db.close();\n    db = null;\n  }\n}\n"],"mappings":";;;AAAA,OAAO,cAAc;AAErB,SAAS,WAAW,kBAAkB;AACtC,SAAS,YAAY;AACrB,SAAS,eAAe;AAExB,IAAM,SAAS,KAAK,QAAQ,GAAG,gBAAgB;AAC/C,IAAM,UAAU,KAAK,QAAQ,SAAS;AAEtC,IAAI,KAA0B;AAE9B,IAAM,aAAuB;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWF;AAEA,SAAS,gBAAgB,UAA8B;AACrD,WAAS,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA,GAKb;AAED,QAAM,UAAU,IAAI;AAAA,IAClB,SACG,QAAQ,4BAA4B,EACpC,IAAI,EACJ,IAAI,CAAC,QAAS,IAAuB,EAAE;AAAA,EAC5C;AAEA,QAAM,iBAAiB,SAAS,YAAY,MAAM;AAChD,aAAS,IAAI,GAAG,IAAI,WAAW,QAAQ,KAAK;AAC1C,UAAI,CAAC,QAAQ,IAAI,CAAC,GAAG;AACnB,iBAAS,KAAK,WAAW,CAAC,CAAC;AAC3B,iBACG,QAAQ,wDAAwD,EAChE,IAAI,GAAG,KAAK,IAAI,CAAC;AAAA,MACtB;AAAA,IACF;AAAA,EACF,CAAC;AAED,iBAAe;AACjB;AAEO,SAAS,QAAsB;AACpC,MAAI,IAAI;AACN,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,WAAW,MAAM,GAAG;AACvB,cAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;AAAA,EACvC;AAEA,OAAK,IAAI,SAAS,OAAO;AACzB,KAAG,OAAO,oBAAoB;AAC9B,KAAG,OAAO,mBAAmB;AAE7B,kBAAgB,EAAE;AAElB,SAAO;AACT;AAEO,SAAS,UAAgB;AAC9B,MAAI,IAAI;AACN,OAAG,MAAM;AACT,SAAK;AAAA,EACP;AACF;","names":[]}

package/dist/{db-S2POLBQM.js → db-62WVGYCE.js}

@@ -2,9 +2,9 @@
 import {
   closeDb,
   getDb
-} from "./chunk-GFILTXTU.js";
+} from "./chunk-IQPO75GF.js";
 export {
   closeDb,
   getDb
 };
-//# sourceMappingURL=db-S2POLBQM.js.map
+//# sourceMappingURL=db-62WVGYCE.js.map