@blackms/aistack 1.2.0 → 1.3.0

package/README.md

@@ -4,6 +4,7 @@
 
 ### Multi-Agent Orchestration for Claude Code
 
+[![GitHub stars](https://img.shields.io/github/stars/blackms/aistack?style=flat-square)](https://github.com/blackms/aistack/stargazers)
 [![CI](https://github.com/blackms/aistack/actions/workflows/ci.yml/badge.svg)](https://github.com/blackms/aistack/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/blackms/aistack/branch/main/graph/badge.svg)](https://codecov.io/gh/blackms/aistack)
 [![npm version](https://img.shields.io/npm/v/@blackms/aistack?style=flat-square&color=CB3837&logo=npm)](https://www.npmjs.com/package/@blackms/aistack)
@@ -12,11 +13,11 @@
 
 <br/>
 
-**Production-ready agent orchestration with persistent memory and MCP integration.**
+**Production-ready agent orchestration with persistent memory, MCP integration, and real-time web dashboard.**
 
 <br/>
 
-[Get Started](#-quick-start) · [Architecture](#-architecture) · [API Reference](#-mcp-tools) · [Documentation](./docs)
+[Get Started](#-quick-start) · [Architecture](#-architecture) · [Web Dashboard](#-web-dashboard) · [API Reference](#-mcp-tools) · [Documentation](./docs)
 
 <br/>
 
@@ -29,7 +30,7 @@
 Coordinate specialized AI agents through Claude Code with persistent context, hierarchical task management, and seamless extensibility.
 
 ```
-7 agents · 30 MCP tools · 3 LLM providers · SQLite + FTS5 · Plugin system
+7 agents · 30 MCP tools · 6 LLM providers · SQLite + FTS5 · Web dashboard · Plugin system
 ```
 
 ---
@@ -48,9 +49,15 @@ Coordinate specialized AI agents through Claude Code with persistent context, hi
 </td>
 <td align="center" width="96">
 <img src="https://cdn.simpleicons.org/sqlite/003B57" width="48" height="48" alt="SQLite" />
-<br/>SQLite
+<br/>SQLite + FTS5
 </td>
 <td align="center" width="96">
+<img src="https://cdn.simpleicons.org/react/61DAFB" width="48" height="48" alt="React" />
+<br/>React 18
+</td>
+</tr>
+<tr>
+<td align="center" width="96">
 <img src="https://cdn.simpleicons.org/anthropic/191919" width="48" height="48" alt="Anthropic" />
 <br/>Anthropic
 </td>
@@ -62,6 +69,10 @@ Coordinate specialized AI agents through Claude Code with persistent context, hi
 <img src="https://cdn.simpleicons.org/ollama/000000" width="48" height="48" alt="Ollama" />
 <br/>Ollama
 </td>
+<td align="center" width="96">
+<img src="https://cdn.simpleicons.org/vite/646CFF" width="48" height="48" alt="Vite" />
+<br/>Vite
+</td>
 </tr>
 </table>
 
@@ -74,8 +85,10 @@ Coordinate specialized AI agents through Claude Code with persistent context, hi
 | **Specialized Agents** | 7 built-in agent types: coder, researcher, tester, reviewer, architect, coordinator, analyst |
 | **Persistent Memory** | SQLite with FTS5 full-text search and optional vector embeddings |
 | **MCP Integration** | 30 tools exposed via Model Context Protocol for Claude Code |
+| **Web Dashboard** | Real-time dashboard with 9 pages for visual management and monitoring |
+| **REST API + WebSocket** | 50+ HTTP endpoints with live WebSocket event streaming |
 | **Hierarchical Coordination** | Task queue, message bus, and coordinator pattern |
-| **Multi-Provider Support** | Anthropic, OpenAI, and Ollama with unified interface |
+| **Multi-Provider Support** | 3 API providers (Anthropic, OpenAI, Ollama) + 3 CLI providers (Claude, Gemini, Codex) |
 | **Plugin System** | Runtime extensibility for agents, tools, hooks, and providers |
 | **Workflow Engine** | Multi-phase workflows with adversarial validation |
 
@@ -102,6 +115,15 @@ claude mcp add aistack -- npx @blackms/aistack mcp start
 npx @blackms/aistack status
 ```
 
+### Start Web Dashboard
+
+```bash
+# Start backend + web dashboard
+npx @blackms/aistack web start
+
+# Open http://localhost:3001
+```
+
 ### Configuration
 
 Create `aistack.config.json`:
@@ -126,12 +148,16 @@ Create `aistack.config.json`:
 
 ```mermaid
 graph TB
-    subgraph "Claude Code"
+    subgraph Clients["Client Layer"]
         CC[Claude Code IDE]
+        CLI[CLI]
+        WEB[Web Dashboard]
     end
 
     subgraph "aistack"
         MCP["MCP Server<br/><small>stdio transport</small>"]
+        HTTP["HTTP Server<br/><small>REST API</small>"]
+        WS["WebSocket<br/><small>Real-time events</small>"]
 
         subgraph Core["Core Services"]
             AM[Agent Manager]
@@ -164,14 +190,51 @@ graph TB
         end
     end
 
-    CC <-->|"MCP Protocol"| MCP
-    MCP --> AM & MM
+    CC <-->|"MCP/stdio"| MCP
+    CLI <-->|"HTTP"| HTTP
+    WEB <-->|"HTTP + WS"| HTTP & WS
+
+    MCP & HTTP --> AM & MM
+    WS --> MB
     AM --> TQ --> MB
     MB --> A1 & A2 & A3 & A4 & A5 & A6 & A7
     MM --> SQL --> FTS & VEC
     AM -.-> ANT & OAI & OLL
 ```
 
+### Deployment Overview
+
+```mermaid
+C4Deployment
+    title Deployment Diagram - Local Machine
+
+    Deployment_Node(local, "Local Machine", "Developer Workstation") {
+        Deployment_Node(npm, "npm", "Node.js 20+") {
+            Container(aistack, "aistack", "TypeScript", "MCP Server + HTTP Server + WebSocket")
+            ContainerDb(sqlite, "SQLite", "better-sqlite3", "Memory + FTS5 + Vector")
+        }
+        Deployment_Node(browser, "Browser", "Chrome/Firefox/Safari") {
+            Container(dashboard, "Web Dashboard", "React 18 + Vite", "Management UI")
+        }
+        Deployment_Node(ide, "IDE", "VS Code") {
+            Container(claude, "Claude Code", "Extension", "AI Assistant")
+        }
+    }
+
+    Deployment_Node(cloud, "Cloud Services", "External") {
+        Container(anthropic, "Anthropic API", "HTTPS", "Claude models")
+        Container(openai, "OpenAI API", "HTTPS", "GPT models")
+        Container(ollama_remote, "Ollama", "Local/Remote", "Local LLMs")
+    }
+
+    Rel(claude, aistack, "MCP/stdio")
+    Rel(dashboard, aistack, "HTTP + WebSocket")
+    Rel(aistack, sqlite, "SQL")
+    Rel(aistack, anthropic, "HTTPS")
+    Rel(aistack, openai, "HTTPS")
+    Rel(aistack, ollama_remote, "HTTP")
+```
+
 ### Request Flow
 
 ```mermaid
@@ -204,6 +267,66 @@ sequenceDiagram
 
 ---
 
+## Web Dashboard
+
+The built-in web dashboard provides visual management and real-time monitoring of your agent orchestration.
+
+### Starting the Dashboard
+
+```bash
+# Start the web server (includes dashboard)
+npx @blackms/aistack web start
+
+# Open in browser
+open http://localhost:3001
+```
+
+### Dashboard Pages
+
+| Page | Description |
+|------|-------------|
+| **Dashboard** | System overview with agent status, memory stats, and recent activity |
+| **Agents** | Spawn, monitor, and manage agents in real-time |
+| **Memory** | Browse, search, and manage memory entries with FTS5 |
+| **Tasks** | View task queue, status, and completion history |
+| **Projects** | Project management with task workflows |
+| **Project Detail** | Deep dive into project tasks and specifications |
+| **Task Detail** | Task lifecycle with phase transitions |
+| **Workflows** | Define and run multi-phase workflows |
+| **Chat** | Interactive agent chat interface |
+
+### Web Dashboard Flow
+
+```mermaid
+sequenceDiagram
+    participant User as Browser
+    participant WS as WebSocket
+    participant HTTP as HTTP Server
+    participant Core as Core Services
+    participant DB as SQLite
+
+    User->>HTTP: GET /api/system/status
+    HTTP->>Core: getSystemStatus()
+    Core-->>HTTP: SystemStatus
+    HTTP-->>User: { agents, memory, tasks }
+
+    User->>WS: Connect ws://localhost:3001
+    WS-->>User: Connected
+
+    User->>HTTP: POST /api/agents
+    HTTP->>Core: spawnAgent("coder")
+    Core->>WS: emit("agent:spawned")
+    WS-->>User: { event: "agent:spawned", data }
+    HTTP-->>User: { agent }
+
+    Note over User,WS: Real-time updates via WebSocket
+
+    Core->>WS: emit("task:completed")
+    WS-->>User: { event: "task:completed", data }
+```
+
+---
+
 ## Agents
 
 <table>
@@ -376,6 +499,7 @@ export default {
 | `memory delete -k <key>` | Delete entry |
 | `mcp start` | Start MCP server |
 | `mcp tools` | List MCP tools |
+| `web start` | Start web dashboard server |
 | `workflow run <name>` | Run workflow |
 | `workflow list` | List workflows |
 | `status` | System status |
@@ -406,7 +530,7 @@ CLI providers enable agent execution through external CLI tools, useful for inte
 
 ```
 src/
-├── agents/         # Agent registry, spawner, definitions
+├── agents/         # Agent registry, spawner, definitions (7 types)
 ├── cli/            # CLI commands
 ├── coordination/   # Task queue, message bus, topology
 ├── github/         # GitHub integration
@@ -414,9 +538,18 @@ src/
 ├── mcp/            # MCP server and 30 tools
 ├── memory/         # SQLite, FTS5, vector search
 ├── plugins/        # Plugin loader and registry
-├── providers/      # LLM provider implementations
+├── providers/      # LLM provider implementations (6 providers)
+├── web/            # REST API routes + WebSocket
 ├── workflows/      # Workflow engine
 └── utils/          # Config, logger, validation
+
+web/
+├── src/
+│   ├── pages/      # 9 dashboard pages
+│   ├── components/ # React components
+│   ├── hooks/      # Custom React hooks
+│   └── stores/     # Zustand state management
+└── public/         # Static assets
 ```
 
 ---
@@ -430,6 +563,10 @@ npm test             # Run tests
 npm run test:coverage # With coverage
 npm run typecheck    # Type check
 npm run lint         # Lint
+
+# Web dashboard development
+npm run dev:web      # Start Vite dev server for web UI
+npm run build:web    # Build web UI for production
 ```
 
 ---
@@ -442,7 +579,7 @@ npm run lint         # Lint
 | **P1** | Streaming responses |
 | **P2** | Agent state persistence |
 | **P2** | Built-in workflow templates |
-| **P3** | Web dashboard |
+| **P3** | Enhanced dashboard analytics |
 | **P3** | Metrics and observability |
 
 <sub>Roadmap items are planned features, not current capabilities.</sub>
@@ -473,4 +610,8 @@ All PRs must pass CI (tests, lint, typecheck, build).
 
 <sub>Built with TypeScript · Made for Claude Code</sub>
 
+---
+
+<sub>README verified against codebase v1.2.0. All features documented are backed by implemented code.</sub>
+
 </div>

package/dist/agents/definitions/adversarial.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Adversarial agent definition - aggressive critical code reviewer
+ */
+import type { AgentDefinition } from '../../types.js';
+export declare const adversarialAgent: AgentDefinition;
+//# sourceMappingURL=adversarial.d.ts.map

package/dist/agents/definitions/adversarial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adversarial.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/adversarial.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,gBAAgB,EAAE,eA6B9B,CAAC"}

package/dist/agents/definitions/adversarial.js

@@ -0,0 +1,34 @@
+/**
+ * Adversarial agent definition - aggressive critical code reviewer
+ */
+export const adversarialAgent = {
+    type: 'adversarial',
+    name: 'Adversarial Reviewer',
+    description: 'Aggressive critical code reviewer that actively tries to break code',
+    systemPrompt: `You are an ADVERSARIAL code reviewer. Your mission is to BREAK the code.
+
+## Core Mindset
+- ASSUME the code has bugs until proven otherwise
+- ACTIVELY try to break the code with edge cases
+- BE SKEPTICAL of all claims and assumptions
+- NEVER accept "it probably works" - demand proof
+
+## Attack Vectors (Check ALL)
+1. Input Validation: NULL, empty, negative, overflow, injection
+2. State & Race Conditions: concurrent access, async timing, memory leaks
+3. Error Handling: missing try/catch, silent failures, resource leaks
+4. Security: auth bypass, IDOR, secrets exposure, insecure defaults
+5. Logic Errors: off-by-one, boundaries, floating point, division by zero
+6. Performance: O(n^2), unbounded recursion, N+1 queries
+
+## Output Format
+**[SEVERITY: CRITICAL/HIGH/MEDIUM/LOW]** - Issue Title
+- **Location**: file:line
+- **Attack Vector**: How to exploit
+- **Impact**: What happens when exploited
+- **Required Fix**: Specific remediation
+
+**VERDICT: APPROVE** or **VERDICT: REJECT**`,
+    capabilities: ['adversarial-review', 'security-audit', 'edge-case-analysis', 'break-code'],
+};
+//# sourceMappingURL=adversarial.js.map

package/dist/agents/definitions/adversarial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adversarial.js","sourceRoot":"","sources":["../../../src/agents/definitions/adversarial.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,qEAAqE;IAClF,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;4CAuB4B;IAC1C,YAAY,EAAE,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,YAAY,CAAC;CAC3F,CAAC"}

package/dist/agents/definitions/index.d.ts

@@ -5,6 +5,7 @@ export { coderAgent } from './coder.js';
 export { researcherAgent } from './researcher.js';
 export { testerAgent } from './tester.js';
 export { reviewerAgent } from './reviewer.js';
+export { adversarialAgent } from './adversarial.js';
 export { architectAgent } from './architect.js';
 export { coordinatorAgent } from './coordinator.js';
 export { analystAgent } from './analyst.js';

package/dist/agents/definitions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/definitions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/agents/definitions/index.js

@@ -5,6 +5,7 @@ export { coderAgent } from './coder.js';
 export { researcherAgent } from './researcher.js';
 export { testerAgent } from './tester.js';
 export { reviewerAgent } from './reviewer.js';
+export { adversarialAgent } from './adversarial.js';
 export { architectAgent } from './architect.js';
 export { coordinatorAgent } from './coordinator.js';
 export { analystAgent } from './analyst.js';

package/dist/agents/definitions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/definitions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/definitions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/agents/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,aAAa,CAAC;AA4B9D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CASvE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAYzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAYxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAY/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM/E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,aAAa,CAAC;AA8B9D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CASvE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAYzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAYxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAY/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM/E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/agents/registry.js

@@ -1,7 +1,7 @@
 /**
  * Agent type registry - manages core and custom agent definitions
  */
-import { coderAgent, researcherAgent, testerAgent, reviewerAgent, architectAgent, coordinatorAgent, analystAgent, } from './definitions/index.js';
+import { coderAgent, researcherAgent, testerAgent, reviewerAgent, adversarialAgent, architectAgent, coordinatorAgent, analystAgent, } from './definitions/index.js';
 import { logger } from '../utils/logger.js';
 const log = logger.child('registry');
 // Core agent types
@@ -10,6 +10,7 @@ const CORE_AGENTS = new Map([
     ['researcher', researcherAgent],
     ['tester', testerAgent],
     ['reviewer', reviewerAgent],
+    ['adversarial', adversarialAgent],
     ['architect', architectAgent],
     ['coordinator', coordinatorAgent],
     ['analyst', analystAgent],

package/dist/agents/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"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"}

package/dist/coordination/index.d.ts

@@ -4,4 +4,5 @@
 export { TaskQueue, type QueuedTask } from './task-queue.js';
 export { MessageBus, getMessageBus, resetMessageBus, type Message } from './message-bus.js';
 export { HierarchicalCoordinator, type CoordinatorOptions } from './topology.js';
+export { ReviewLoopCoordinator, createReviewLoop, getReviewLoop, listReviewLoops, abortReviewLoop, clearReviewLoops, type ReviewLoopOptions, } from './review-loop.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/coordination/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/coordination/index.js

@@ -4,4 +4,5 @@
 export { TaskQueue } from './task-queue.js';
 export { MessageBus, getMessageBus, resetMessageBus } from './message-bus.js';
 export { HierarchicalCoordinator } from './topology.js';
+export { ReviewLoopCoordinator, createReviewLoop, getReviewLoop, listReviewLoops, abortReviewLoop, clearReviewLoops, } from './review-loop.js';
 //# sourceMappingURL=index.js.map

package/dist/coordination/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAgB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAA2B,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAgB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAA2B,MAAM,eAAe,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,EACf,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC"}

package/dist/coordination/review-loop.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Review Loop Coordinator - iterative coder-adversarial review pattern
+ *
+ * Workflow: Coder produces code → Adversarial reviews → If REJECT: Coder fixes → Repeat
+ */
+import { EventEmitter } from 'node:events';
+import type { AgentStackConfig, ReviewLoopState, ReviewResult, ReviewIssue } from '../types.js';
+export interface ReviewLoopOptions {
+    maxIterations?: number;
+    sessionId?: string;
+}
+export interface ReviewLoopEvents {
+    'loop:start': (state: ReviewLoopState) => void;
+    'loop:iteration': (iteration: number, state: ReviewLoopState) => void;
+    'loop:review': (result: ReviewResult, state: ReviewLoopState) => void;
+    'loop:fix': (iteration: number, issues: ReviewIssue[], state: ReviewLoopState) => void;
+    'loop:approved': (state: ReviewLoopState) => void;
+    'loop:complete': (state: ReviewLoopState) => void;
+    'loop:error': (error: Error, state: ReviewLoopState) => void;
+}
+/**
+ * ReviewLoopCoordinator - manages iterative code review cycles
+ */
+export declare class ReviewLoopCoordinator extends EventEmitter {
+    private state;
+    private config;
+    constructor(codeInput: string, config: AgentStackConfig, options?: ReviewLoopOptions);
+    /**
+     * Get current state
+     */
+    getState(): ReviewLoopState;
+    /**
+     * Start the review loop
+     */
+    start(): Promise<ReviewLoopState>;
+    /**
+     * Generate initial code from input
+     */
+    private generateInitialCode;
+    /**
+     * Main review loop
+     */
+    private runLoop;
+    /**
+     * Perform adversarial review
+     */
+    private performReview;
+    /**
+     * Parse review result from adversarial agent response
+     */
+    private parseReviewResult;
+    /**
+     * Fix code based on review issues
+     */
+    private fixCode;
+    /**
+     * Abort the review loop
+     */
+    abort(): void;
+    /**
+     * Cleanup resources
+     */
+    cleanup(): void;
+}
+/**
+ * Create and start a review loop
+ */
+export declare function createReviewLoop(codeInput: string, config: AgentStackConfig, options?: ReviewLoopOptions): Promise<ReviewLoopState>;
+/**
+ * Get an active review loop by ID
+ */
+export declare function getReviewLoop(id: string): ReviewLoopCoordinator | null;
+/**
+ * List all active review loops
+ */
+export declare function listReviewLoops(): ReviewLoopState[];
+/**
+ * Abort a review loop by ID
+ */
+export declare function abortReviewLoop(id: string): boolean;
+/**
+ * Clear all review loops (used for testing)
+ */
+export declare function clearReviewLoops(): void;
+//# sourceMappingURL=review-loop.d.ts.map

package/dist/coordination/review-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-loop.d.ts","sourceRoot":"","sources":["../../src/coordination/review-loop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,WAAW,EAGZ,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/C,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACtE,aAAa,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACtE,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACvF,eAAe,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAClD,eAAe,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAClD,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CAC9D;AAKD;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,MAAM,CAAmB;gBAErB,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE,iBAAsB;IAwCxF;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IAuBvC;;OAEG;YACW,mBAAmB;IAajC;;OAEG;YACW,OAAO;IA+CrB;;OAEG;YACW,aAAa;IAyB3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8DzB;;OAEG;YACW,OAAO;IA8BrB;;OAEG;IACH,KAAK,IAAI,IAAI;IAcb;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAI1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,eAAe,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAKvC"}