@adamancyzhang/claude-orchestrator 0.3.1 → 0.3.2

package/dist/skills/claude-orchestrator/SKILL.md

@@ -22,51 +22,88 @@ Every CLI command talks directly to ZooKeeper. Instance discovery is via ephemer
 ## Setup
 
 ```bash
-pip install -e .
+npm install -g @adamancyzhang/claude-orchestrator
 docker-compose up -d   # start ZooKeeper
 ```
 
+Initialize environment:
+
+```bash
+# Leader (team coordinator):
+claude-orchestrator setup --leader --name Tom
+
+# Worker (the doers):
+claude-orchestrator setup --name Jerry --role builder
+```
+
+This creates:
+- `.claude-orchestrator/agents/` — message templates (7 templates for leader + 5 worker links)
+- `.claude/skills/` — 8 Claude Code skills (responsibility chain + infrastructure)
+- `.claude-orchestrator/config.json` — project config (name, role)
+- `~/.claude-orchestrator/config.json` — global config (ZK hosts, CLI command, cache dir)
+
 Verify:
 
 ```bash
-claude-orchestrator status
-# {"status": "healthy", "zookeeper": "connected", "instances_online": 0}
+claude-orchestrator config
+# Shows current configuration
 ```
 
 ## Global Options
 
 | Option | Env var | Default | Description |
 |--------|---------|---------|-------------|
-| `--zk-hosts` | `ZK_HOSTS` | `127.0.0.1:2181` | ZooKeeper connection string |
-| `--instance-id` | — | auto (from config) | Override stored instance ID |
+| `--zookeeper`, `-z` | `ZK_HOSTS` | `127.0.0.1:2181` | ZooKeeper connection string |
+| `--instance-id`, `-i` | — | auto (from config) | Override stored instance ID |
 
 ## Commands
 
+### Leader
+
+```bash
+claude-orchestrator leader --name Tom
+# Launches read-only TUI: team panel, task board, event log
+```
+
+Only one Leader at a time (ZK ephemeral node). The TUI shows who's online, what tasks are in each state, and a scrolling event log.
+
 ### Registration
 
-**Register** this instance:
+**Setup** — one-time initialization:
 
 ```bash
-claude-orchestrator register --name Jerry-Dev --role developer
-# {"id": "a1b2c3d4...", "name": "Jerry-Dev", "role": "developer", "status": "idle", ...}
+claude-orchestrator setup --leader --name Tom                    # Leader
+claude-orchestrator setup --name Jerry --role builder             # Worker
+claude-orchestrator setup --name Lucy --role verifier \
+  --cache-dir ~/shared/sessions --command "claude -p"             # Custom CLI
 ```
 
-The returned `id` is saved to `~/.claude-orchestrator/config.json`. Pass `--instance-id` on re-registration to reuse the same identity.
+Setup options:
 
-**Heartbeat** — keep registration alive, optionally declare current task:
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--leader` | false | Initialize as Leader environment |
+| `--name <name>` | — | Instance display name |
+| `--role <role>` | builder | Role: planner, builder, verifier, reviewer, accepter |
+| `--cache-dir <path>` | `~/.claude-orchestrator/sessions` | Shared cache directory |
+| `--command <cmd>` | `claude --dangerously-skip-permissions --permission-mode dontAsk` | Claude CLI command |
+| `--global` | false | Write only global config, skip project files |
+
+**Register** — join the swarm:
 
 ```bash
-claude-orchestrator heartbeat
-claude-orchestrator heartbeat --current-task "fix-login-bug"
+# Connect and listen for messages (reads name/role from .claude-orchestrator/config.json):
+claude-orchestrator register
+# Worker Watcher starts, listens for messages, processes via claude -p
+# Press Ctrl+C to stop and unregister
 ```
 
-ZK session timeout is 30s. Call heartbeat regularly (every 30-60s) while working.
+Registration creates an ephemeral ZK node. The instance auto-deregisters on disconnect (Ctrl+C or timeout). The Worker Watcher listens for messages on `/messages/{instance_id}` and processes them using the template that matches the message's `link` field.
 
-**List instances:**
+**Unregister:**
 
 ```bash
-claude-orchestrator list-instances
-# [{"id": "...", "name": "Jerry-Dev", "role": "developer", "status": "busy", ...}, ...]
+claude-orchestrator unregister
 ```
 
 ### Tasks
@@ -74,33 +111,66 @@ claude-orchestrator list-instances
 **Push a task** to the queue:
 
 ```bash
-claude-orchestrator push-task --title "Fix login bug" --description "..." --priority 0
-claude-orchestrator push-task --title "Review PR #42" --assignee <instance-id>
+claude-orchestrator push-task --title "Implement login endpoint" --priority 0
+claude-orchestrator push-task --title "Verify auth module" --link verify --priority 1
+claude-orchestrator push-task --title "Review PR #42" --link review --assignee <instance-id>
+claude-orchestrator push-task --title "Part 2" --chain-id chain-001 --depends-on task-0000000001
 ```
 
-Priority: `0` = HIGH, `1` = MEDIUM (default), `2` = LOW.
+Push options:
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--title <text>` | required | Task title |
+| `--description <text>` | "" | Task description |
+| `--priority <n>` | 1 | 0=HIGH, 1=MEDIUM, 2=LOW |
+| `--assignee <id>` | — | Target instance ID |
+| `--link <link>` | — | Responsibility chain link: plan, build, verify, review, accept |
+| `--chain-id <id>` | — | Group related tasks under one chain |
+| `--depends-on <ids>` | — | Comma-separated task IDs this task depends on |
+| `--blocked-by <ids>` | — | Comma-separated task IDs blocking this task |
 
 **Claim a task** — FIFO, higher priority first, assigned-to-you tasks jump the queue:
 
 ```bash
 claude-orchestrator claim-task
-# {"id": "task-0000000001", "title": "Fix login bug", ...}   ← claimed
-# {"status": "no_tasks", "message": "No pending tasks available."}  ← empty queue
+# → { "id": "task-0000000001", "title": "Implement login endpoint", "status": "claimed", ... }
+# → { "status": "no_tasks", "message": "No pending tasks available." }
 ```
 
 **Complete a task:**
 
 ```bash
-claude-orchestrator complete-task --task-id task-0000000001 --result "Fixed auth middleware, added tests"
+claude-orchestrator complete-task --task-id task-0000000001 --result "PR #42 — login endpoint with tests"
 ```
 
-**List tasks:**
+**Poll tasks:**
 
 ```bash
-claude-orchestrator list-tasks
-claude-orchestrator list-tasks --status pending
-claude-orchestrator list-tasks --status claimed
-claude-orchestrator list-tasks --status completed
+claude-orchestrator poll-task
+claude-orchestrator poll-task --status pending
+claude-orchestrator poll-task --status claimed
+claude-orchestrator poll-task --status completed
+claude-orchestrator poll-task --status blocked
+claude-orchestrator poll-task --status failed
+```
+
+**Task lifecycle commands:**
+
+```bash
+claude-orchestrator task-block --task-id task-0000000001 --reason "Waiting for API key"
+claude-orchestrator task-fail --task-id task-0000000001 --reason "Test environment unavailable"
+claude-orchestrator task-retry --task-id task-0000000001
+# → Re-queued with retry_count + 1 (max 3 retries)
+```
+
+Task state machine:
+
+```
+pending → claimed → in_progress → completed
+                            → blocked → pending (retry)
+                            → failed  → pending (retry, max 3)
+claimed → pending (Worker disconnect, Leader recovers orphan)
 ```
 
 ### Messages
@@ -108,7 +178,7 @@ claude-orchestrator list-tasks --status completed
 **Send a direct message:**
 
 ```bash
-claude-orchestrator send-message --to <instance-id> --content "Can you review my PR?"
+claude-orchestrator send-message --to-name Jerry --content "Can you review my PR?"
 ```
 
 **Broadcast to all:**
@@ -117,64 +187,58 @@ claude-orchestrator send-message --to <instance-id> --content "Can you review my
 claude-orchestrator send-message --broadcast --content "CI is down, don't push"
 ```
 
-**Poll messages:**
+**Request help** (broadcasts to all with help flag):
 
 ```bash
-claude-orchestrator poll-messages
-# [{"id": "msg-...", "type": "direct", "from_name": "Lucy-Test", "content": "...", "read": true}]
+claude-orchestrator send-message --request-help --broadcast --content "How do I test the auth flow?"
 ```
 
-**Request help** (broadcasts to all):
+**Poll messages:**
 
 ```bash
-claude-orchestrator request-help --question "How do I test the auth flow?" --context "stack trace..."
+claude-orchestrator poll-message
+# [{ "id": "msg-...", "type": "direct", "from_name": "Tom", "content": "...", "read": true }]
 ```
 
-### Shared Context
-
-**Set:**
+**Delete a message:**
 
 ```bash
-claude-orchestrator set-context --key ci_status --value "failing: auth tests"
+claude-orchestrator delete-message --message-id msg-0000000000
 ```
 
-**Get:**
+### Config
 
 ```bash
-claude-orchestrator get-context --key ci_status
-# {"key": "ci_status", "value": "failing: auth tests"}
+claude-orchestrator config
+# Shows global and project configuration
 ```
 
-### Status
+## Roles
 
-```bash
-claude-orchestrator status
-# {"status": "healthy", "zookeeper": "connected", "instances_online": 3}
-```
+| Role | Value | Typical behavior |
+|------|-------|-----------------|
+| Leader | `leader` | Runs TUI, monitors team, recovers orphaned tasks |
+| Planner | `planner` | Uses `task-planning` + `task-traceability` skills |
+| Builder | `builder` | Uses `task-execution` + `task-traceability` skills |
+| Verifier | `verifier` | Uses `task-verification` + `task-traceability` skills |
+| Reviewer | `reviewer` | Uses `task-review` + `task-traceability` skills |
+| Accepter | `accepter` | Uses `task-acceptance` + `task-traceability` skills |
 
 ## Workflow
 
 A typical agent session:
 
 ```bash
-# 1. Join the team
-claude-orchestrator register --name Jerry-Dev --role developer
-
-# 2. Check who's online
-claude-orchestrator list-instances
+# 1. Initialize (first time only)
+claude-orchestrator setup --name Jerry --role builder
 
-# 3. Work loop
-while true; do
-  claude-orchestrator poll-messages     # check for messages
-  task=$(claude-orchestrator claim-task)  # grab work
-  if [ "$task" = "no_tasks" ]; then break; fi
-  # ... execute the task ...
-  claude-orchestrator complete-task --task-id <id> --result "Done: ..."
-done
+# 2. Join the team — Worker Watcher auto-processes incoming messages via claude -p
+claude-orchestrator register
+# Press Ctrl+C to stop and unregister
 ```
 
 ## Error recovery
 
 - **ZooKeeper not connected**: check `docker-compose ps`, retry. ZK client auto-reconnects.
-- **"No instance_id found"**: register first, or pass `--instance-id`
-- **Registration expired**: ephemeral nodes cleaned up on disconnect. Re-register with same `--instance-id` to restore identity.
+- **"No instance_id found"**: run `setup` first, or check `.claude-orchestrator/config.json`
+- **Registration expired**: ephemeral nodes cleaned up on disconnect. Re-register to restore identity.

package/dist/templates/{leader-decompose.md → worker-decompose.md}

@@ -1,4 +1,4 @@
-You are a task decomposition specialist. Your job is to break down a requirement into a chain of tasks following the Plan → Build → Verify → Review → Accept responsibility chain.
+You are {{name}}, a task decomposition specialist. Your role is {{preset_role}}. Break down the requirement below into a chain of tasks following the Plan → Build → Verify → Review → Accept responsibility chain.
 
 ## Responsibility Chain
 
@@ -8,24 +8,20 @@ You are a task decomposition specialist. Your job is to break down a requirement
 4. **Review** — Quality gate. Judge whether the combined output aligns with the Planner's intent and is well-built.
 5. **Accept** — Final acceptance. Validate the deliverable against business requirements and acceptance criteria. Make the Go/No-Go decision.
 
-## Current Team
-
-{{team_status}}
-
 ## Requirement
 
-{{content}}
+{{task_description}}
 
 ## Instructions
 
 1. Analyze the requirement. Identify how many independent delivery chains are needed (usually one, but complex requirements may need multiple).
 2. For each chain, define five link tasks. Plan is optional — omit it (set to null) when the requirement is already clear enough to start building directly. Build, Verify, Review, and Accept are mandatory.
 3. For each task, specify clear completion criteria — what "done" means for that specific link.
-4. Assign a priority to each task: 0 (urgent, blocks critical path), 1 (high), 2 (normal), 3 (low).
+4. Assign a priority to each task: 0 (urgent), 1 (high), 2 (normal), 3 (low).
 
 ## Output Format
 
-Output exactly one JSON object per chain with fixed five slots:
+Output exactly one JSON object per chain. Write the result to {{result_path}}.
 
 ```json
 {
@@ -67,3 +63,5 @@ Output exactly one JSON object per chain with fixed five slots:
 ```
 
 If plan is not needed, set it to null. Output ONLY the JSON. No explanation.
+
+After completing the decomposition, include the full JSON as your completion report so the Leader can mechanically create the tasks.

package/dist/templates/worker-evaluate.md

@@ -0,0 +1,41 @@
+You are {{name}}, a self-evaluation specialist. Your role is {{preset_role}}. You just completed a task in the Plan → Build → Verify → Review → Accept responsibility chain. Evaluate your own output and decide the next action.
+
+## Your Task
+
+- **Link**: {{link}}
+- **Title**: {{task_title}}
+- **Description**: {{task_description}}
+- **Completion Criteria**: {{task_criteria}}
+
+## Your Result
+
+The result of your work is at {{task_result_path}}. Review it objectively.
+
+## Decision Rules
+
+1. **Evaluate your output against the completion criteria.**
+   - Criteria fully met → `activate_next` (proceed to next link in the chain)
+   - Criteria partially met → `feedback` (describe what's missing so you or another worker can fix it)
+   - Criteria not met at all → `feedback` with clear explanation of what went wrong
+
+2. **Check chain position.**
+   - If this was the Accept link and it passes → `close_chain`
+   - Otherwise → activate the next link
+
+## Output Format
+
+Output exactly one JSON decision. Write the result to {{result_path}}.
+
+```json
+{
+  "decision": "activate_next" | "feedback" | "close_chain",
+  "reason": "<one-line explanation of the evaluation>",
+  "feedback": "<only if feedback: specific guidance on what to improve>",
+  "nextLink": "<the next link to activate, e.g. build|verify|review|accept>",
+  "suggestedWorker": null
+}
+```
+
+Output ONLY the JSON. No explanation.
+
+After evaluating, include the full JSON decision as your completion report so the Leader can mechanically execute the decision.

package/dist/utils/exec.js

@@ -5,6 +5,8 @@ export async function execWithTee(command, message, logPath, cwd) {
     await fs.promises.mkdir(path.dirname(logPath), { recursive: true });
     const escapedMsg = message.replace(/'/g, "'\\''");
     const shellCmd = `exec ${command} -p '${escapedMsg}' | tee -a '${logPath}'`;
+    const msgPreview = message.length > 100 ? message.slice(0, 100) + "..." : message;
+    console.log(`\n[Exec] ${command} -p '${msgPreview}' | tee -a '${logPath}'`);
     return new Promise((resolve) => {
         const child = spawn("sh", ["-c", shellCmd], {
             cwd,

package/dist/utils/exec.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+export declare class Logger {
+    private tag;
+    private static debugEnabled;
+    static enableDebug(): void;
+    static isDebug(): boolean;
+    constructor(tag: string);
+    info(msg: string): void;
+    error(msg: string, err?: unknown): void;
+    debug(msg: string): void;
+}

package/dist/utils/logger.js

@@ -0,0 +1,22 @@
+export class Logger {
+    tag;
+    static debugEnabled = false;
+    static enableDebug() { Logger.debugEnabled = true; }
+    static isDebug() { return Logger.debugEnabled; }
+    constructor(tag) {
+        this.tag = tag;
+    }
+    info(msg) {
+        console.log(`[${this.tag}] ${msg}`);
+    }
+    error(msg, err) {
+        const extra = err instanceof Error ? `: ${err.message}` : err !== undefined ? `: ${err}` : "";
+        console.error(`[${this.tag}] ${msg}${extra}`);
+    }
+    debug(msg) {
+        if (Logger.debugEnabled) {
+            console.log(`[${this.tag}] [DEBUG] ${msg}`);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,MAAM;IAMG;IALZ,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC;IAEpC,MAAM,CAAC,WAAW,KAAW,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,OAAO,KAAc,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IAEzD,YAAoB,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAEnC,IAAI,CAAC,GAAW;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,GAAW,EAAE,GAAa;QAC9B,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,GAAW;QACf,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,aAAa,GAAG,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC"}

package/dist/worker/evaluator.d.ts

@@ -0,0 +1,13 @@
+import { TemplateEngine } from "../executor/template.js";
+import { ClaudeRunner } from "../executor/runner.js";
+declare const CHAIN_LINKS: string[];
+export declare class SelfEvaluator {
+    private templateEngine;
+    private runner;
+    private instanceName;
+    private instanceRole;
+    private logger;
+    constructor(templateEngine: TemplateEngine, runner: ClaudeRunner, instanceName: string, instanceRole: string);
+    evaluate(link: string, msgVars: Record<string, string>, taskResultPath: string, uniqueKey: string): Promise<string>;
+}
+export { CHAIN_LINKS };

package/dist/worker/evaluator.js

@@ -0,0 +1,112 @@
+import * as fs from "node:fs";
+import { Logger } from "../utils/logger.js";
+import { EvalDecisionSchema } from "../models/schemas.js";
+const CHAIN_LINKS = ["plan", "build", "verify", "review", "accept"];
+const MAX_RETRIES = 3;
+const NEXT_LINKS = {
+    plan: "build", build: "verify", verify: "review",
+    review: "accept", accept: null,
+};
+export class SelfEvaluator {
+    templateEngine;
+    runner;
+    instanceName;
+    instanceRole;
+    logger = new Logger("SelfEvaluator");
+    constructor(templateEngine, runner, instanceName, instanceRole) {
+        this.templateEngine = templateEngine;
+        this.runner = runner;
+        this.instanceName = instanceName;
+        this.instanceRole = instanceRole;
+    }
+    async evaluate(link, msgVars, taskResultPath, uniqueKey) {
+        let evalTemplate;
+        try {
+            evalTemplate = await this.templateEngine.loadFile("worker-evaluate.md");
+        }
+        catch {
+            evalTemplate = [
+                `You are {{name}}, a Worker with role {{preset_role}}.`,
+                `Evaluate your own output for the {{link}} task and decide the next step.`,
+                ``,
+                `## Task`,
+                `- **Title**: {{task_title}}`,
+                `- **Description**: {{task_description}}`,
+                `- **Criteria**: {{task_criteria}}`,
+                ``,
+                `## Your Result`,
+                `Read the result from {{task_result_path}}.`,
+                ``,
+                `## Output Format`,
+                `Write the evaluation result to {{result_path}}. Output exactly one JSON decision:`,
+                `\`\`\`json`,
+                `{"decision": "activate_next" | "feedback" | "close_chain", "reason": "...", "nextLink": "build|verify|review|accept"}`,
+                `\`\`\``,
+                `Output ONLY the JSON.`,
+            ].join("\n");
+        }
+        const baseVars = {
+            name: this.instanceName,
+            preset_role: this.instanceRole,
+            link,
+            task_result_path: taskResultPath,
+            work_dir: "",
+            time: new Date().toISOString(),
+            ...msgVars,
+        };
+        const formatHint = [
+            ``,
+            `## IMPORTANT: Format Correction`,
+            `Your previous output was invalid JSON or did not match the required schema.`,
+            `You MUST output ONLY valid JSON with exactly these fields:`,
+            `\`\`\`json`,
+            `{"decision": "activate_next"|"feedback"|"close_chain", "reason": "<string>", "nextLink": "<string>", "feedback": "<string>"}`,
+            `\`\`\``,
+            `No markdown fences, no extra text, no trailing commas. Pure JSON only.`,
+        ].join("\n");
+        for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+            const attemptKey = `${uniqueKey}-${attempt}`;
+            const evalResultPath = this.runner.evalResultPath(attemptKey);
+            const evalLogPath = this.runner.evalLogPath(attemptKey);
+            let prompt = this.templateEngine.render(evalTemplate, {
+                ...baseVars,
+                result_path: evalResultPath,
+            });
+            if (attempt > 0) {
+                prompt += formatHint;
+            }
+            this.logger.info(`Self-evaluation attempt ${attempt + 1}/${MAX_RETRIES}...`);
+            await this.runner.run(prompt, evalLogPath);
+            try {
+                const content = await fs.promises.readFile(evalResultPath, "utf-8");
+                if (!content.trim())
+                    continue;
+                const cleaned = content.trim()
+                    .replace(/```json\s*/g, "")
+                    .replace(/```\s*/g, "")
+                    .trim();
+                const parsed = JSON.parse(cleaned);
+                const validated = EvalDecisionSchema.parse(parsed);
+                return JSON.stringify(validated);
+            }
+            catch (err) {
+                this.logger.error(`Attempt ${attempt + 1} invalid`, err);
+            }
+        }
+        this.logger.error(`All ${MAX_RETRIES} evaluation attempts failed, using fallback`);
+        const nextLink = NEXT_LINKS[link];
+        if (nextLink) {
+            return JSON.stringify({
+                decision: "activate_next",
+                reason: `Auto-advance from ${link} (after ${MAX_RETRIES} eval failures)`,
+                nextLink,
+            });
+        }
+        return JSON.stringify({
+            decision: "close_chain",
+            reason: `Accept link completed (after ${MAX_RETRIES} eval failures)`,
+        });
+    }
+}
+export { CHAIN_LINKS };
+//# sourceMappingURL=evaluator.js.map

package/dist/worker/evaluator.js.map

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

package/dist/worker/watcher.d.ts

@@ -1,19 +1,25 @@
 import { ZkClient } from "../zk/client.js";
+import { HookEngine } from "../hooks/engine.js";
+import { TemplateEngine } from "../executor/template.js";
+import { ClaudeRunner } from "../executor/runner.js";
+import { SelfEvaluator } from "./evaluator.js";
 export declare class WorkerWatcher {
     private zk;
     private instanceId;
-    private workDir;
-    private command;
-    private cacheDir;
     private leaderInstanceId;
+    private hooks;
+    private templateEngine;
+    private runner;
+    private evaluator;
     private inFlight;
-    private templates;
     private instanceName;
     private instanceRole;
+    private logger;
     stopped: boolean;
-    constructor(zk: ZkClient, instanceId: string, workDir: string, command: string, cacheDir: string, leaderInstanceId: string);
+    constructor(zk: ZkClient, instanceId: string, leaderInstanceId: string, hooks: HookEngine, templateEngine: TemplateEngine, runner: ClaudeRunner, evaluator: SelfEvaluator);
     start(): Promise<void>;
     private watchLoop;
     private processMessage;
+    private sendCompletionReport;
     stop(): void;
 }