@adamancyzhang/claude-orchestrator 0.3.3 → 0.4.1

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/templates/user-global-claude.md

@@ -0,0 +1,65 @@
+# CLAUDE.md
+
+Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
+
+**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.
+
+## 1. Think Before Coding
+
+**Don't assume. Don't hide confusion. Surface tradeoffs.**
+
+Before implementing:
+- State your assumptions explicitly. If uncertain, ask.
+- If multiple interpretations exist, present them - don't pick silently.
+- If a simpler approach exists, say so. Push back when warranted.
+- If something is unclear, stop. Name what's confusing. Ask.
+
+## 2. Simplicity First
+
+**Minimum code that solves the problem. Nothing speculative.**
+
+- No features beyond what was asked.
+- No abstractions for single-use code.
+- No "flexibility" or "configurability" that wasn't requested.
+- No error handling for impossible scenarios.
+- If you write 200 lines and it could be 50, rewrite it.
+
+Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
+
+## 3. Surgical Changes
+
+**Touch only what you must. Clean up only your own mess.**
+
+When editing existing code:
+- Don't "improve" adjacent code, comments, or formatting.
+- Don't refactor things that aren't broken.
+- Match existing style, even if you'd do it differently.
+- If you notice unrelated dead code, mention it - don't delete it.
+
+When your changes create orphans:
+- Remove imports/variables/functions that YOUR changes made unused.
+- Don't remove pre-existing dead code unless asked.
+
+The test: Every changed line should trace directly to the user's request.
+
+## 4. Goal-Driven Execution
+
+**Define success criteria. Loop until verified.**
+
+Transform tasks into verifiable goals:
+- "Add validation" → "Write tests for invalid inputs, then make them pass"
+- "Fix the bug" → "Write a test that reproduces it, then make it pass"
+- "Refactor X" → "Ensure tests pass before and after"
+
+For multi-step tasks, state a brief plan:
+```
+1. [Step] → verify: [check]
+2. [Step] → verify: [check]
+3. [Step] → verify: [check]
+```
+
+Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.
+
+---
+
+**These guidelines are working if:** fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes.

package/dist/utils/console-capture.d.ts

@@ -0,0 +1,2 @@
+export declare function captureConsoleToFile(logDir: string): void;
+export declare function restoreConsole(): void;

package/dist/utils/console-capture.js

@@ -0,0 +1,42 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+const originals = {
+    log: console.log.bind(console),
+    error: console.error.bind(console),
+    warn: console.warn.bind(console),
+    info: console.info.bind(console),
+    debug: console.debug.bind(console),
+};
+let captured = false;
+let stream = null;
+export function captureConsoleToFile(logDir) {
+    if (captured)
+        return;
+    fs.mkdirSync(logDir, { recursive: true });
+    const logPath = path.join(logDir, `leader-${Date.now()}.log`);
+    stream = fs.createWriteStream(logPath, { flags: "a" });
+    const write = (level, ...args) => {
+        const ts = new Date().toISOString();
+        const text = args.map(a => typeof a === "string" ? a : JSON.stringify(a)).join(" ");
+        stream?.write(`[${level}] ${ts} ${text}\n`);
+    };
+    console.log = (...args) => write("LOG", ...args);
+    console.error = (...args) => write("ERROR", ...args);
+    console.warn = (...args) => write("WARN", ...args);
+    console.info = (...args) => write("INFO", ...args);
+    console.debug = (...args) => write("DEBUG", ...args);
+    captured = true;
+}
+export function restoreConsole() {
+    if (!captured)
+        return;
+    console.log = originals.log;
+    console.error = originals.error;
+    console.warn = originals.warn;
+    console.info = originals.info;
+    console.debug = originals.debug;
+    stream?.end();
+    stream = null;
+    captured = false;
+}
+//# sourceMappingURL=console-capture.js.map

package/dist/utils/console-capture.js.map

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

package/dist/utils/exec.d.ts

@@ -1,8 +1,4 @@
-export declare function execWithTee(command: string, message: string, logPath: string, cwd?: string): Promise<{
+export declare function execWithStreaming(command: string, message: string, logPath: string, systemPrompt?: string, onChunk?: (line: string) => void, cwd?: string, quiet?: boolean): Promise<{
     code: number;
-}>;
-export declare function execAndCapture(command: string, message: string, logPath: string, cwd?: string): Promise<{
-    code: number;
-    stdout: string;
-    stderr: string;
+    sessionId?: string;
 }>;

package/dist/utils/exec.js

@@ -1,47 +1,66 @@
 import fs from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";
-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,
-            stdio: ["ignore", "pipe", "pipe"],
-            env: { ...process.env },
-        });
-        child.stdout?.on("data", (d) => process.stdout.write(d));
-        child.stderr?.on("data", (d) => process.stderr.write(d));
-        child.on("exit", (code) => resolve({ code: code ?? -1 }));
-        child.on("error", () => resolve({ code: -1 }));
-    });
+function extractSessionId(line) {
+    try {
+        const obj = JSON.parse(line);
+        return obj.session_id || null;
+    }
+    catch {
+        return null;
+    }
 }
-export async function execAndCapture(command, message, logPath, cwd) {
+function escapeShell(s) {
+    return s.replace(/'/g, "'\\''");
+}
+export async function execWithStreaming(command, message, logPath, systemPrompt, onChunk, cwd, quiet) {
     await fs.promises.mkdir(path.dirname(logPath), { recursive: true });
-    const escapedMsg = message.replace(/'/g, "'\\''");
-    const shellCmd = `exec ${command} -p '${escapedMsg}' | tee -a '${logPath}'`;
+    const escapedMsg = escapeShell(message);
+    let flags = `--output-format stream-json --verbose`;
+    if (systemPrompt) {
+        flags += ` --append-system-prompt '${escapeShell(systemPrompt)}'`;
+    }
+    const shellCmd = `exec ${command} ${flags} -p '${escapedMsg}' | tee -a '${escapeShell(logPath)}'`;
+    if (!quiet) {
+        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,
             stdio: ["ignore", "pipe", "pipe"],
             env: { ...process.env },
         });
-        let stdout = "", stderr = "";
+        let partial = "";
+        let sessionId;
         child.stdout?.on("data", (d) => {
-            const s = d.toString();
-            stdout += s;
-            process.stdout.write(s);
+            const text = d.toString();
+            if (!quiet)
+                process.stdout.write(text);
+            partial += text;
+            const lines = partial.split("\n");
+            partial = lines.pop() ?? "";
+            for (const line of lines) {
+                if (line.length > 0) {
+                    if (!sessionId)
+                        sessionId = extractSessionId(line) ?? undefined;
+                    onChunk?.(line);
+                }
+            }
         });
         child.stderr?.on("data", (d) => {
-            const s = d.toString();
-            stderr += s;
-            process.stderr.write(s);
+            if (!quiet)
+                process.stderr.write(d);
+        });
+        child.on("exit", (code) => {
+            if (partial.length > 0) {
+                if (!sessionId)
+                    sessionId = extractSessionId(partial) ?? undefined;
+                onChunk?.(partial);
+            }
+            resolve({ code: code ?? -1, sessionId });
         });
-        child.on("exit", (code) => resolve({ code: code ?? -1, stdout, stderr }));
-        child.on("error", (err) => resolve({ code: -1, stdout, stderr: err.message }));
+        child.on("error", () => resolve({ code: -1 }));
     });
 }
 //# 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":"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"}
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"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"}

package/dist/utils/json.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Extract a JSON object or array from markdown-fenced Claude output.
+ * Handles: ```json ... ```,  ``` ... ```, and inline JSON with surrounding text.
+ */
+export declare function extractJson(content: string): string;

package/dist/utils/json.js

@@ -0,0 +1,17 @@
+/**
+ * Extract a JSON object or array from markdown-fenced Claude output.
+ * Handles: ```json ... ```,  ``` ... ```, and inline JSON with surrounding text.
+ */
+export function extractJson(content) {
+    let cleaned = content.trim();
+    // Strip markdown code fences (anchored to start/end)
+    cleaned = cleaned.replace(/^```(?:json)?\s*\n?/i, "").replace(/\n?```\s*$/i, "");
+    // Try to extract the first JSON object or array
+    const match = cleaned.match(/\{[\s\S]*\}|\[[\s\S]*\]/);
+    if (match)
+        return match[0].trim();
+    // Fallback: global fence removal
+    cleaned = cleaned.replace(/```json\s*/g, "").replace(/```\s*/g, "").trim();
+    return cleaned;
+}
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,IAAI,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAE7B,qDAAqD;IACrD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAEjF,gDAAgD;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACvD,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAElC,iCAAiC;IACjC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3E,OAAO,OAAO,CAAC;AACjB,CAAC"}

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>;