@adamancyzhang/claude-orchestrator 0.3.2 → 0.4.0

package/dist/templates/agents/worker-evaluate.md

@@ -0,0 +1,49 @@
+You just completed a task in the Plan → Build → Verify → Review → Accept responsibility chain. Evaluate your own output and decide the next action.
+
+## Task Context
+
+- **Link**: {{link}}
+- **Title**: {{task_title}}
+- **Description**: {{task_description}}
+- **Criteria**: {{task_criteria}}
+
+## Your Result
+
+Review your work at {{task_result_path}}.
+
+## Directory Memory Check
+
+Before evaluating, verify:
+1. Does `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/` contain the expected artifact for your link?
+   - plan → `blueprint.md`
+   - build → `traceability-map.md` + `evidence/`
+   - verify → `verification-map.md` + `evidence/`
+   - review → `review-judgment.md`
+   - accept → `acceptance-report.md`
+2. Has `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md` been updated?
+3. For verify/review/accept: did you successfully read upstream artifacts from `.claude-orchestrator/docs/`?
+
+## Decision Rules
+
+1. **Criteria fully met** AND output artifacts are in place → `activate_next`
+2. **Criteria partially met** OR artifacts missing from docs → `feedback` (describe what's missing)
+3. **Criteria not met** → `feedback` with clear explanation
+4. **Accept link passes** → `close_chain`
+
+For verify/review/accept: if upstream artifacts were missing from `.claude-orchestrator/docs/` → `feedback` specifying which artifacts and from which Worker.
+
+## Output
+
+Output exactly one JSON. Write to {{result_path}}.
+
+```json
+{
+  "decision": "activate_next" | "feedback" | "close_chain",
+  "reason": "<one-line explanation>",
+  "feedback": "<only if feedback: what to improve or which artifact is missing>",
+  "nextLink": "<build|verify|review|accept>",
+  "suggestedWorker": null
+}
+```
+
+Output ONLY the JSON. No explanation.

package/dist/templates/agents/worker-plan.md

@@ -0,0 +1,36 @@
+Your link in the responsibility chain is **Plan** — define the blueprint that Build, Verify, Review, and Accept will follow.
+
+## Step 0: Restore Directory Memory
+
+Read `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md` to restore session context (create the directory and seed it if new). Read your personal CLAUDE.md at `.claude-orchestrator/docs/{{name}}/CLAUDE.md`.
+
+## Task
+
+- **Title**: {{task_title}}
+- **Description**: {{task_description}}
+- **Criteria**: {{task_criteria}}
+- **Spec**: {{task_doc_path}}
+
+## Process
+
+Use the **task-planning** skill (read `.claude/skills/task-planning/SKILL.md`). Use **task-traceability** (`.claude/skills/task-traceability/SKILL.md`) as the foundational layer. Follow Trace → Execute → Map → Evidence → Record.
+
+## Outputs
+
+1. Write blueprint to **{{result_path}}** (for Leader evaluation)
+2. Write identical copy to **.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/blueprint.md** (for downstream Workers)
+
+Blueprint must be self-contained with architecture, interfaces, data flow, and concrete build steps with verifiable criteria.
+
+## Completion Report
+
+```
+Link: plan
+Status: completed
+Blueprint Summary: <one paragraph>
+Build Steps: <count> steps listed
+Self-Check: all passed | <items needing attention>
+Blueprint Path: .claude-orchestrator/docs/{{name}}/YYYY-MM-DD/blueprint.md
+```
+
+Update `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md` with completion status.

package/dist/templates/agents/worker-review.md

@@ -0,0 +1,42 @@
+Your link in the responsibility chain is **Review** — the quality gate. Judge whether the combined Plan + Build + Verify output aligns with the Planner's intent.
+
+## Step 0: Restore Directory Memory
+
+Read `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md` to restore session context (create the directory and seed it if new). Read your personal CLAUDE.md at `.claude-orchestrator/docs/{{name}}/CLAUDE.md`.
+
+## Task
+
+- **Title**: {{task_title}}
+- **Description**: {{task_description}}
+- **Criteria**: {{task_criteria}}
+- **Spec**: {{task_doc_path}}
+
+## Process
+
+Use the **task-review** skill (read `.claude/skills/task-review/SKILL.md`). Use **task-traceability** (`.claude/skills/task-traceability/SKILL.md`) as the foundational layer. Follow Trace → Execute → Map → Evidence → Record.
+
+**Trace — Read all three upstream artifacts (required)**:
+1. `.claude-orchestrator/docs/{planner_name}/YYYY-MM-DD/blueprint.md`
+2. `.claude-orchestrator/docs/{builder_name}/YYYY-MM-DD/traceability-map.md`
+3. `.claude-orchestrator/docs/{verifier_name}/YYYY-MM-DD/verification-map.md`
+Fallback: `{{task_doc_path}}`. If any is missing → cannot review, report to Leader.
+
+For each checklist item: ACCEPT (meets intent), CONCERN (specify which link addresses it), or REJECT (fundamentally fails).
+
+## Outputs
+
+1. Write review judgment to **{{result_path}}** (for Leader evaluation)
+2. Write identical copy to **.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/review-judgment.md** (for Accepter)
+
+## Completion Report
+
+```
+Link: review
+Status: completed
+Decision: PASS | FEEDBACK | REJECT
+Accepted: <count> | Concerns: <count> | Rejected: <count>
+Review Judgment: .claude-orchestrator/docs/{{name}}/YYYY-MM-DD/review-judgment.md
+Upstream Artifacts Read: <list all three paths>
+```
+
+Update `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md`.

package/dist/templates/agents/worker-verify.md

@@ -0,0 +1,44 @@
+Your link in the responsibility chain is **Verify** — independently check the Builder's output against the Planner's blueprint. This forms the responsibility chain closed loop.
+
+## Step 0: Restore Directory Memory
+
+Read `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md` to restore session context (create the directory and seed it if new). Read your personal CLAUDE.md at `.claude-orchestrator/docs/{{name}}/CLAUDE.md`.
+
+## Task
+
+- **Title**: {{task_title}}
+- **Description**: {{task_description}}
+- **Criteria**: {{task_criteria}}
+- **Spec**: {{task_doc_path}}
+
+## Process
+
+Use the **task-verification** skill (read `.claude/skills/task-verification/SKILL.md`). Use **task-traceability** (`.claude/skills/task-traceability/SKILL.md`) as the foundational layer. Follow Trace → Execute → Map → Evidence → Record.
+
+**Trace — Collect upstream artifacts (required)**:
+1. Planner blueprint: `.claude-orchestrator/docs/{planner_name}/YYYY-MM-DD/blueprint.md`
+2. Builder traceability map: `.claude-orchestrator/docs/{builder_name}/YYYY-MM-DD/traceability-map.md`
+Fallback: `{{task_doc_path}}`. If either is missing → BLOCKED, report to Leader.
+
+Cross-reference to build a verification checklist. Classify each item: PASS (meets criteria), GAP (no Builder output), FAILURE (output doesn't meet criteria), DEVIATION (Builder deviated with reason).
+
+## Outputs
+
+1. Write verification map to **{{result_path}}** (for Leader evaluation)
+2. Write identical copy to **.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/verification-map.md** (for Reviewer)
+3. Save evidence files to **.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/evidence/**
+
+## Completion Report
+
+```
+Link: verify
+Status: completed
+Verified: <count> | Passed: <count> | Gaps: <count> | Failures: <count>
+Recommendation: proceed | needs fixes (<specific fixes>)
+Upstream Artifacts:
+  - Blueprint: .claude-orchestrator/docs/{planner}/YYYY-MM-DD/blueprint.md
+  - Traceability: .claude-orchestrator/docs/{builder}/YYYY-MM-DD/traceability-map.md
+Verification Map: .claude-orchestrator/docs/{{name}}/YYYY-MM-DD/verification-map.md
+```
+
+Update `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/CLAUDE.md`.

package/dist/templates/claude-memory/personal-claude-accepter.md

@@ -0,0 +1,17 @@
+# {{name}} — Accepter
+
+You are the final gate. You validate against business acceptance criteria and make the Go/No-Go decision. Read `.claude/skills/task-acceptance/SKILL.md` for your detailed process.
+
+## Process
+
+1. **Read Full Chain** — All four upstream artifacts from `.claude-orchestrator/docs/`: Planner blueprint, Builder traceability map, Verifier verification map, Reviewer judgment. Fallback: `{{task_doc_path}}`. If any is missing → cannot accept, report to Leader.
+2. **Verify Against Acceptance Criteria** — For each criterion: does the deliverable exist? Are Verifier FAILUREs resolved? Are Reviewer CONCERNs addressed? Is evidence independently verifiable?
+3. **Decide** — **GO**: All criteria met, zero issues. **NO-GO**: Any criterion unmet. No conditional pass.
+4. **Sign** — Write acceptance report to `{{result_path}}` and `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/acceptance-report.md`. Update daily CLAUDE.md.
+
+## Prohibited
+
+- No conditional GO — zero issues is the only standard
+- No re-verifying or re-reviewing — your job is business acceptance
+- No accepting without all four upstream artifacts
+- No scattering documents outside `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/`

package/dist/templates/claude-memory/personal-claude-builder.md

@@ -0,0 +1,24 @@
+# {{name}} — Builder
+
+You produce verifiable results according to the Planner's blueprint. Read `.claude/skills/task-execution/SKILL.md` for your detailed process. Use `.claude/skills/task-traceability/SKILL.md` as the foundational traceability layer.
+
+## Process (Trace → Execute → Map → Evidence → Record)
+
+1. **Trace** — Read the Planner's blueprint from `.claude-orchestrator/docs/{planner_name}/YYYY-MM-DD/blueprint.md`. Fallback: `{{task_doc_path}}`. Extract every implementable requirement as a checklist.
+2. **Execute** — Implement each requirement. Follow the Plan's architecture. Document deviations with reasons.
+3. **Map** — Build a traceability map: Plan Requirement → Implementation → Status (done/deviation/n/a).
+4. **Evidence** — For each item: test results (paste actual output), verification steps, key decisions. Save to `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/evidence/`.
+5. **Record** — Write traceability map to `{{result_path}}` and `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/traceability-map.md`. Update daily CLAUDE.md. Git commit.
+
+## Output Standards
+
+- Every implementation must trace to a Plan requirement
+- Every completed item must have evidence (actual test output, not claims)
+- Deviations documented with reasons
+
+## Prohibited
+
+- No implementation without a traceable Plan requirement
+- No "code level already implemented" as evidence
+- No architectural decisions (Planner's domain)
+- No scattering documents outside `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/`

package/dist/templates/claude-memory/personal-claude-planner.md

@@ -0,0 +1,22 @@
+# {{name}} — Planner
+
+You define the blueprint that all downstream roles follow. Read `.claude/skills/task-planning/SKILL.md` for your detailed process. Use `.claude/skills/task-traceability/SKILL.md` as the foundational traceability layer.
+
+## Process (Trace → Execute → Map → Evidence → Record)
+
+1. **Trace** — Read the requirement. Extract goals, scope, constraints.
+2. **Design** — Produce a blueprint: architecture, interfaces, data flow, concrete build steps with verifiable completion criteria. The Builder must implement from this alone.
+3. **Map** — Link each build step to a requirement.
+4. **Self-Check** — Can a Builder start from this? Are criteria objectively checkable? No vague descriptions.
+5. **Record** — Write blueprint to `{{result_path}}` and `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/blueprint.md`. Update daily CLAUDE.md.
+
+## Output Standards
+
+- Every build step must have an objectively verifiable completion criterion (e.g., "curl -X POST /api/foo returns 201", not "works correctly")
+- Blueprint must be self-contained — no external dependencies for understanding
+
+## Prohibited
+
+- No vague acceptance criteria
+- No skipping Self-Check
+- No scattering documents outside `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/`

package/dist/templates/claude-memory/personal-claude-reviewer.md

@@ -0,0 +1,25 @@
+# {{name}} — Reviewer
+
+You are the quality gate. You judge Plan + Build + Verify against Planner intent. Read `.claude/skills/task-review/SKILL.md` for your detailed process. Use `.claude/skills/task-traceability/SKILL.md` as the foundational traceability layer.
+
+## Process (Trace → Execute → Map → Evidence → Record)
+
+1. **Trace** — Read all three upstream artifacts from `.claude-orchestrator/docs/`: Planner blueprint, Builder traceability map, Verifier verification map. Fallback: `{{task_doc_path}}`. If any is missing → cannot review, report to Leader.
+2. **Execute** — For each checklist item: ACCEPT, CONCERN (specify which link addresses it), or REJECT (fundamentally fails intent).
+3. **Map** — Plan Intent → Build Result → Verify Finding → Review Judgment → Rationale.
+4. **Evidence** — For CONCERN/REJECT: reference specific Plan requirement and Builder/Verifier finding.
+5. **Record** — Write judgment to `{{result_path}}` and `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/review-judgment.md`. Update daily CLAUDE.md.
+
+## Decision
+
+- **PASS** — Ready for Accept
+- **FEEDBACK** — Specific revisions needed (which link, what to fix)
+- **REJECT** — Fundamentally fails, restart required
+
+## Prohibited
+
+- No reviewing without all three upstream artifacts
+- No PASS with unresolved Verifier FAILUREs
+- No implementation decisions (Builder's domain)
+- No re-verification (trust but validate, don't redo)
+- No scattering documents outside `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/`

package/dist/templates/claude-memory/personal-claude-verifier.md

@@ -0,0 +1,24 @@
+# {{name}} — Verifier
+
+You independently check Builder output against Planner blueprint. Read `.claude/skills/task-verification/SKILL.md` for your detailed process. Use `.claude/skills/task-traceability/SKILL.md` as the foundational traceability layer.
+
+## Process (Trace → Execute → Map → Evidence → Record)
+
+1. **Trace** — Read Planner blueprint (`.claude-orchestrator/docs/{planner}/YYYY-MM-DD/blueprint.md`) and Builder traceability map (`.claude-orchestrator/docs/{builder}/YYYY-MM-DD/traceability-map.md`). Fallback: `{{task_doc_path}}`. If either is missing → BLOCKED, report to Leader.
+2. **Execute** — For each Plan requirement: does Builder output exist? Does it meet criteria? Identify GAPs, FAILUREs, EXTRAs, DEVIATIONs.
+3. **Map** — Plan Requirement → Builder Output → Verified → Status (PASS/GAP/FAILURE).
+4. **Evidence** — For each finding: what you checked, actual output, expected vs actual. Save to `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/evidence/`.
+5. **Record** — Write verification map to `{{result_path}}` and `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/verification-map.md`. Update daily CLAUDE.md.
+
+## Output Standards
+
+- Every Plan requirement accounted for (PASS, GAP, or FAILURE)
+- Every finding backed by evidence, not opinion
+- Clear recommendation: proceed or needs fixes
+
+## Prohibited
+
+- No verifying without reading both Plan and Build artifacts
+- No "code level already implemented" as verification — run the tests yourself
+- No architectural judgments (Reviewer's domain)
+- No scattering documents outside `.claude-orchestrator/docs/{{name}}/YYYY-MM-DD/`

package/dist/templates/claude-memory/team-claude.md

@@ -0,0 +1,61 @@
+# Multi-Agent Orchestration Workspace
+
+You are a Worker in a CLI-native multi-agent orchestration system. Work is coordinated through ZooKeeper-based message passing. The system follows the Plan → Build → Verify → Review → Accept responsibility chain.
+
+## Team Roles
+
+| Role | Responsibility | Skill |
+|------|---------------|-------|
+| **Planner** | Requirement analysis, blueprint design, task decomposition | `task-planning` |
+| **Builder** | Implementation per blueprint, code changes, testing | `task-execution` |
+| **Verifier** | Cross-check Builder output against Planner blueprint | `task-verification` |
+| **Reviewer** | Chain-level quality gate, design consistency review | `task-review` |
+| **Accepter** | Final sign-off against business acceptance criteria | `task-acceptance` |
+
+All roles use `task-traceability` as the foundational traceability layer: Trace → Execute → Map → Evidence → Record.
+
+## Documentation Directory
+
+All work artifacts go under `.claude-orchestrator/docs/{your_name}/YYYY-MM-DD/`. Do not scatter documents elsewhere.
+
+Each role's typical outputs:
+
+| Role | Artifact |
+|------|----------|
+| Planner | `blueprint.md` |
+| Builder | `traceability-map.md` + `evidence/` |
+| Verifier | `verification-map.md` + `evidence/` |
+| Reviewer | `review-judgment.md` |
+| Accepter | `acceptance-report.md` |
+
+## Daily Working Directory
+
+Your daily directory is `.claude-orchestrator/docs/{your_name}/YYYY-MM-DD/`. Each daily directory must contain a `CLAUDE.md` as directory memory.
+
+**Workflow:**
+- **Start:** Navigate to today's directory. Read `CLAUDE.md` if it exists to restore context. Otherwise, create the directory and seed a fresh `CLAUDE.md`.
+- **During:** After each sub-task, update `CLAUDE.md` with status.
+- **End:** Record what was accomplished, what remains, and any blockers.
+
+## Reading Upstream Artifacts
+
+When your link depends on previous work:
+
+| Your Link | Read From `.claude-orchestrator/docs/` |
+|-----------|--------------------------------------|
+| Build | `{planner_name}/YYYY-MM-DD/blueprint.md` |
+| Verify | `{planner}/.../blueprint.md` + `{builder}/.../traceability-map.md` |
+| Review | Planner + Builder + Verifier artifacts |
+| Accept | All four upstream artifacts |
+
+If an upstream artifact is missing, check `{{task_doc_path}}` as fallback. If still not found, report to Leader.
+
+## Your Personal CLAUDE.md
+
+Your role-specific rules are at `.claude-orchestrator/docs/{your_name}/CLAUDE.md`. Read it at the start of every session.
+
+## Git Rules
+
+- Commit after each completed task. One logical unit per commit.
+- Commit message ends with your own name signature.
+- Never amend published commits. Verify with `git status` before committing.

package/dist/utils/logger.d.ts

@@ -5,6 +5,7 @@ export declare class Logger {
     static isDebug(): boolean;
     constructor(tag: string);
     info(msg: string): void;
+    warn(msg: string): void;
     error(msg: string, err?: unknown): void;
     debug(msg: string): void;
 }

package/dist/utils/logger.js

@@ -9,6 +9,9 @@ export class Logger {
     info(msg) {
         console.log(`[${this.tag}] ${msg}`);
     }
+    warn(msg) {
+        console.warn(`[${this.tag}] ${msg}`);
+    }
     error(msg, err) {
         const extra = err instanceof Error ? `: ${err.message}` : err !== undefined ? `: ${err}` : "";
         console.error(`[${this.tag}] ${msg}${extra}`);

package/dist/utils/logger.js.map

@@ -1 +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"}
+{"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,IAAI,CAAC,GAAW;QACd,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;IACvC,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/child-runner.d.ts

@@ -0,0 +1,12 @@
+export interface ChildConfig {
+    worktreePath: string;
+    name: string;
+    role: string;
+    instanceId: string;
+    branch: string;
+    zkHosts: string;
+    debug: boolean;
+    cliCommand: string;
+    cacheDir: string;
+}
+export declare function startWorkerChild(config: ChildConfig): Promise<void>;

package/dist/worker/child-runner.js

@@ -0,0 +1,99 @@
+import * as path from "node:path";
+import { ZkClient } from "../zk/client.js";
+import { InstanceRegistry } from "../modules/registry.js";
+import { HookEngine } from "../hooks/engine.js";
+import { TemplateEngine } from "../executor/template.js";
+import { ClaudeRunner } from "../executor/runner.js";
+import { SelfEvaluator } from "./evaluator.js";
+import { WorkerWatcher } from "./watcher.js";
+import { CommitChecker } from "./commit-checker.js";
+import { Logger } from "../utils/logger.js";
+import { saveInstanceId } from "../config.js";
+export async function startWorkerChild(config) {
+    const logger = new Logger(`Worker-${config.name}`);
+    // 1. Switch to worktree directory
+    process.chdir(config.worktreePath);
+    logger.info(`Working in ${config.worktreePath}`);
+    // 2. Connect to ZK
+    const zk = new ZkClient(config.zkHosts);
+    await zk.connect();
+    // 3. Register instance (EPHEMERAL) with worktree metadata
+    const registry = new InstanceRegistry(zk);
+    const instance = await registry.register(config.name, config.role, config.instanceId);
+    // Update instance with worktree metadata
+    try {
+        await zk.updateInstance(instance.id, {
+            ...instance,
+            worktree_name: config.name,
+            worktree_path: config.worktreePath,
+            worktree_branch: config.branch,
+            pid: process.pid,
+        });
+    }
+    catch {
+        // Instance may have been deleted or session expired
+    }
+    saveInstanceId(instance.id);
+    // 4. Resolve leader instance ID for cache path
+    let leaderInstanceId = instance.id;
+    try {
+        const leaderData = await zk.getLeader();
+        if (leaderData?.instance_id) {
+            leaderInstanceId = leaderData.instance_id;
+        }
+    }
+    catch {
+        // Leader not running yet, use own instance id
+    }
+    // 5. Initialize modules
+    const agentsDir = path.join(config.worktreePath, ".claude-orchestrator", "agents");
+    const runner = new ClaudeRunner(config.cliCommand, config.cacheDir, leaderInstanceId, config.worktreePath);
+    const templateEngine = new TemplateEngine(agentsDir);
+    const evaluator = new SelfEvaluator(templateEngine, runner, config.name, config.role);
+    const commitChecker = new CommitChecker(config.worktreePath, runner);
+    const hooks = new HookEngine();
+    const watcher = new WorkerWatcher(zk, instance.id, leaderInstanceId, hooks, templateEngine, runner, evaluator, commitChecker, config.worktreePath, config.branch);
+    // 6. Start watch loop (non-blocking after initial setup)
+    watcher.start().catch((err) => {
+        logger.error("Watcher error", err);
+    });
+    // 7. Start parent alive check
+    const parentCheck = startParentAliveCheck(watcher, zk);
+    // 8. Block until SIGINT or parent death
+    await new Promise((resolve) => {
+        process.on("SIGINT", () => {
+            clearInterval(parentCheck);
+            watcher.stop();
+            resolve();
+        });
+        process.on("SIGTERM", () => {
+            clearInterval(parentCheck);
+            watcher.stop();
+            resolve();
+        });
+    });
+    // 9. Cleanup
+    try {
+        await registry.unregister(instance.id);
+    }
+    catch {
+        // Already gone
+    }
+    await zk.disconnect();
+    logger.info("Unregistered. Goodbye.");
+}
+function startParentAliveCheck(watcher, zk) {
+    const parentPid = process.ppid;
+    const timer = setInterval(() => {
+        try {
+            process.kill(parentPid, 0);
+        }
+        catch {
+            watcher.stop();
+            zk.disconnect();
+            process.exit(0);
+        }
+    }, 1000);
+    return timer;
+}
+//# sourceMappingURL=child-runner.js.map

package/dist/worker/child-runner.js.map

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

package/dist/worker/child.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/worker/child.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { startWorkerChild } from "./child-runner.js";
+const config = JSON.parse(process.argv[2]);
+startWorkerChild(config).catch((err) => {
+    console.error("Worker child fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=child.js.map

package/dist/worker/child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child.js","sourceRoot":"","sources":["../../src/worker/child.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAoB,MAAM,mBAAmB,CAAC;AAEvE,MAAM,MAAM,GAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACrC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/worker/commit-checker.d.ts

@@ -0,0 +1,20 @@
+import type { ClaudeRunner } from "../executor/runner.js";
+export interface CommitResult {
+    sha: string;
+    message: string;
+    changedFiles: string[];
+    untrackedFiles: string[];
+}
+export declare class CommitChecker {
+    private worktreePath;
+    private runner;
+    private logger;
+    constructor(worktreePath: string, runner: ClaudeRunner);
+    check(taskContext: {
+        link: string;
+        taskTitle: string;
+        taskDescription: string;
+    }): Promise<CommitResult | null>;
+    private parseStatus;
+    private generateCommitMessage;
+}

package/dist/worker/commit-checker.js

@@ -0,0 +1,87 @@
+import * as fs from "node:fs";
+import { execSync } from "node:child_process";
+import { Logger } from "../utils/logger.js";
+export class CommitChecker {
+    worktreePath;
+    runner;
+    logger = new Logger("CommitChecker");
+    constructor(worktreePath, runner) {
+        this.worktreePath = worktreePath;
+        this.runner = runner;
+    }
+    async check(taskContext) {
+        try {
+            const statusOutput = execSync("git status --porcelain", {
+                cwd: this.worktreePath,
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            if (!statusOutput.trim()) {
+                this.logger.info("No changes to commit");
+                return null;
+            }
+            const { changed, untracked } = this.parseStatus(statusOutput);
+            const commitMsg = await this.generateCommitMessage(changed, untracked, taskContext);
+            execSync("git add -A", { cwd: this.worktreePath, stdio: "pipe" });
+            execSync(`git commit -m "${commitMsg.replace(/"/g, '\\"')}"`, {
+                cwd: this.worktreePath,
+                stdio: "pipe",
+            });
+            const sha = execSync("git rev-parse HEAD", {
+                cwd: this.worktreePath,
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
+            }).trim();
+            this.logger.info(`Committed ${sha.slice(0, 7)}: ${commitMsg}`);
+            return { sha, message: commitMsg, changedFiles: changed, untrackedFiles: untracked };
+        }
+        catch (err) {
+            this.logger.error("Commit check failed", err);
+            return null;
+        }
+    }
+    parseStatus(statusOutput) {
+        const changed = [];
+        const untracked = [];
+        for (const line of statusOutput.trim().split("\n")) {
+            if (!line)
+                continue;
+            const status = line.slice(0, 2);
+            const file = line.slice(3);
+            if (status === "??") {
+                untracked.push(file);
+            }
+            else {
+                changed.push(`${status.trim()} ${file}`);
+            }
+        }
+        return { changed, untracked };
+    }
+    async generateCommitMessage(changed, untracked, ctx) {
+        const prompt = [
+            "## Commit Task",
+            "",
+            "Changed files:",
+            ...changed.map(f => `  ${f}`),
+            "",
+            "Untracked files:",
+            ...untracked.map(f => `  ${f}`),
+            "",
+            `Task: ${ctx.taskTitle} (${ctx.link})`,
+            "",
+            "Generate a concise git commit message (single line, under 72 chars).",
+            "Output ONLY the commit message.",
+        ].join("\n");
+        const uniqueKey = `commit-${Date.now().toString(36)}`;
+        const logPath = this.runner.logPath(uniqueKey);
+        await this.runner.run(prompt, logPath);
+        try {
+            const output = await fs.promises.readFile(logPath, "utf-8");
+            return output.trim().split("\n")[0].slice(0, 72);
+        }
+        catch {
+            return `chore: auto-commit ${ctx.link} task`;
+        }
+    }
+}
+//# sourceMappingURL=commit-checker.js.map

package/dist/worker/commit-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-checker.js","sourceRoot":"","sources":["../../src/worker/commit-checker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAU5C,MAAM,OAAO,aAAa;IAId;IACA;IAJF,MAAM,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,CAAC;IAE7C,YACU,YAAoB,EACpB,MAAoB;QADpB,iBAAY,GAAZ,YAAY,CAAQ;QACpB,WAAM,GAAN,MAAM,CAAc;IAC3B,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,WAIX;QACC,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,QAAQ,CAAC,wBAAwB,EAAE;gBACtD,GAAG,EAAE,IAAI,CAAC,YAAY;gBACtB,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;gBACzC,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAE9D,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;YAEpF,QAAQ,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAClE,QAAQ,CAAC,kBAAkB,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;gBAC5D,GAAG,EAAE,IAAI,CAAC,YAAY;gBACtB,KAAK,EAAE,MAAM;aACd,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,QAAQ,CAAC,oBAAoB,EAAE;gBACzC,GAAG,EAAE,IAAI,CAAC,YAAY;gBACtB,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC;YAC/D,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,YAAoB;QACtC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,IAAI;gBAAE,SAAS;YACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,OAAiB,EACjB,SAAmB,EACnB,GAAiE;QAEjE,MAAM,MAAM,GAAG;YACb,gBAAgB;YAChB,EAAE;YACF,gBAAgB;YAChB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,EAAE;YACF,kBAAkB;YAClB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,EAAE;YACF,SAAS,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,IAAI,GAAG;YACtC,EAAE;YACF,sEAAsE;YACtE,iCAAiC;SAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,SAAS,GAAG,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5D,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,sBAAsB,GAAG,CAAC,IAAI,OAAO,CAAC;QAC/C,CAAC;IACH,CAAC;CACF"}