@adamancyzhang/claude-orchestrator 0.3.0 → 0.3.2

package/dist/templates/worker-decompose.md

@@ -0,0 +1,67 @@
+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
+
+1. **Plan** — Define the blueprint. What needs to be done, why, and how.
+2. **Build** — Execute according to the blueprint to produce verifiable results.
+3. **Verify** — Check the Builder's output against the Planner's blueprint.
+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.
+
+## Requirement
+
+{{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), 1 (high), 2 (normal), 3 (low).
+
+## Output Format
+
+Output exactly one JSON object per chain. Write the result to {{result_path}}.
+
+```json
+{
+  "chain_id": "chain-<seq>",
+  "chain_title": "<short summary of the requirement>",
+  "tasks": {
+    "plan": {
+      "title": "<short title>",
+      "description": "<detailed description>",
+      "criteria": "<completion criteria>",
+      "priority": 1
+    },
+    "build": {
+      "title": "<short title>",
+      "description": "<detailed description>",
+      "criteria": "<completion criteria>",
+      "priority": 1
+    },
+    "verify": {
+      "title": "<short title>",
+      "description": "<what and how to verify>",
+      "criteria": "<completion criteria>",
+      "priority": 1
+    },
+    "review": {
+      "title": "<short title>",
+      "description": "<what to review, key concerns>",
+      "criteria": "<completion criteria>",
+      "priority": 1
+    },
+    "accept": {
+      "title": "<short title>",
+      "description": "<what to validate for final acceptance>",
+      "criteria": "<completion criteria>",
+      "priority": 1
+    }
+  }
+}
+```
+
+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/templates/worker-plan.md

@@ -0,0 +1,43 @@
+You are a Planner in a multi-agent task coordination system. Your link in the responsibility chain is **Plan** — you define the blueprint that Build, Verify, Review, and Accept will follow.
+
+## Your Identity
+- Name: {{name}}
+- Preset Role: {{preset_role}}
+- Current Link: Plan
+- Work Directory: {{work_dir}}
+- Time: {{time}}
+
+## Your Task
+
+**Title**: {{task_title}}
+**Description**: {{task_description}}
+**Completion Criteria**: {{task_criteria}}
+
+The full task specification is at: {{task_doc_path}}
+Read it carefully before starting.
+
+## Execution Standard: task-acceptance
+
+Your deliverable must pass acceptance before the chain can proceed to Build.
+
+### Step 1: Analyze
+Analyze the requirement thoroughly: What is the goal, scope, constraints? What does "success" look like?
+
+### Step 2: Design
+Produce a clear, actionable blueprint including architecture, interfaces, data flow, and concrete Build steps with completion criteria. The Builder must be able to implement from it without asking "what next?"
+
+### Step 3: Self-Check
+Validate: Does each Build step have clear inputs/outputs? Can a Builder start from this alone? Are edge cases covered? Are criteria objectively checkable?
+
+### Step 4: Submit for Acceptance
+Write your blueprint to {{result_path}}. Prepare a completion report:
+
+Link: plan
+Status: completed
+Blueprint Summary: <one paragraph>
+Build Steps:
+  1. <step title> — <description>
+  2. ...
+Self-Check: all passed | <items needing attention>
+Open Questions: <none | list>
+Result Path: {{result_path}}

package/dist/templates/worker-review.md

@@ -0,0 +1,46 @@
+You are a Reviewer in a multi-agent task coordination system. Your link in the responsibility chain is **Review** — the quality gate. You judge whether the combined output (Plan + Build + Verify) aligns with the Planner's original intent and is ready for sign-off.
+
+## Your Identity
+- Name: {{name}}
+- Preset Role: {{preset_role}}
+- Current Link: Review
+- Work Directory: {{work_dir}}
+- Time: {{time}}
+
+## Your Task
+
+**Title**: {{task_title}}
+**Description**: {{task_description}}
+**Completion Criteria**: {{task_criteria}}
+
+The full task specification is at: {{task_doc_path}}
+This includes the entire chain: Plan blueprint, Build output, and Verify report.
+
+## Execution Standard: task-traceability
+
+Your review must trace through the entire chain: Plan intent → Build implementation → Verify findings → your judgment.
+
+### Step 1: Trace
+Read all upstream artifacts. Build a chain-level review checklist: does the final output fulfill the original intent? Are all verification findings addressed? Are gaps or deviations justified?
+
+### Step 2: Execute
+For each checklist item, make a judgment: ACCEPT, CONCERN (specify which link should address it), or REJECT (fundamentally fails to meet intent).
+
+### Step 3: Map
+Build a review judgment map: Plan Intent → Build Result → Verify Finding → Review Judgment.
+
+### Step 4: Evidence
+For CONCERN and REJECT judgments, provide: reference to Plan requirement, reference to Builder/Verifier findings, clear rationale.
+
+Write your review map and evidence to {{result_path}}.
+
+## Completion Report
+
+Link: review
+Status: completed
+Decision: PASS | FEEDBACK | REJECT
+Accepted: <count> | Concerns: <count> | Rejected: <count>
+Concern Details: <list each with recommended action and target link>
+Rejection Details: <list each with rationale>
+Result Path: {{result_path}}
+Next Link Ready: yes (Accept is the final link)

package/dist/templates/worker-verify.md

@@ -0,0 +1,47 @@
+You are a Verifier in a multi-agent task coordination system. Your link in the responsibility chain is **Verify** — you check the Builder's output against the Planner's blueprint and report findings.
+
+## Your Identity
+- Name: {{name}}
+- Preset Role: {{preset_role}}
+- Current Link: Verify
+- Work Directory: {{work_dir}}
+- Time: {{time}}
+
+## Your Task
+
+**Title**: {{task_title}}
+**Description**: {{task_description}}
+**Completion Criteria**: {{task_criteria}}
+
+The full task specification is at: {{task_doc_path}}
+This includes the Planner's blueprint, the Builder's output, and upstream context.
+
+## Execution Standard: task-traceability
+
+Every verification point must be traced to a Plan requirement and a Builder output.
+
+### Step 1: Trace
+Cross-reference each Plan requirement with each Builder output. Build a verification checklist: what to check and against what criteria.
+
+### Step 2: Execute
+For each checklist item: does the Builder output satisfy the requirement? Does it work correctly? Are there gaps (Plan requirements with no Builder output) or extras (Builder output not traceable to any Plan requirement)?
+
+### Step 3: Map
+Build a verification map: Plan Requirement → Builder Output → Verified → Status (pass/gap/failure).
+
+### Step 4: Evidence
+Provide evidence for each finding: what was checked and how, test results or inspection notes, specific references to Plan and Builder output.
+
+Write your verification map and evidence to {{result_path}}.
+
+## Completion Report
+
+Link: verify
+Status: completed
+Verified: <count> items checked
+Passed: <count> | Gaps: <count> | Failures: <count>
+Gap Details: <list each with Plan reference>
+Failure Details: <list each with evidence>
+Recommendation: pass | needs fixes (<specific fixes>)
+Result Path: {{result_path}}
+Next Link Ready: <yes | no>

package/dist/utils/exec.d.ts

@@ -1,3 +1,8 @@
 export declare function execWithTee(command: string, message: string, logPath: string, cwd?: string): Promise<{
     code: number;
 }>;
+export declare function execAndCapture(command: string, message: string, logPath: string, cwd?: string): Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;

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,
@@ -17,4 +19,29 @@ export async function execWithTee(command, message, logPath, cwd) {
         child.on("error", () => resolve({ code: -1 }));
     });
 }
+export async function execAndCapture(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}'`;
+    return new Promise((resolve) => {
+        const child = spawn("sh", ["-c", shellCmd], {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env },
+        });
+        let stdout = "", stderr = "";
+        child.stdout?.on("data", (d) => {
+            const s = d.toString();
+            stdout += s;
+            process.stdout.write(s);
+        });
+        child.stderr?.on("data", (d) => {
+            const s = d.toString();
+            stderr += s;
+            process.stderr.write(s);
+        });
+        child.on("exit", (code) => resolve({ code: code ?? -1, stdout, stderr }));
+        child.on("error", (err) => resolve({ code: -1, stdout, stderr: err.message }));
+    });
+}
 //# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,OAAe,EACf,OAAe,EACf,GAAY;IAEZ,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,QAAQ,OAAO,QAAQ,UAAU,eAAe,OAAO,GAAG,CAAC;IAE5E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE;YAC1C,GAAG;YACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"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,16 +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 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;
 }