@enderfga/claw-orchestrator 3.7.1 → 4.0.0

package/dist/src/ultraapp/diff-apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-apply.js","sourceRoot":"","sources":["../../../src/ultraapp/diff-apply.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAOlC,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,GAAW;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,SAAS,GAA4C,EAAE,CAAC;IAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,OAAO,KAAK,WAAW,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,KAAK,WAAW,CAAC;QACzC,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAEzC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACxB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAiB,CAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACpF,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAChE,SAAS;QACX,CAAC;QACD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC1E,CAAC"}

package/dist/src/ultraapp/docker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Thin wrapper around the docker CLI. Centralised so tests mock the
+ * spawnFn and the rest of ultraapp doesn't touch child_process directly.
+ */
+import { type ChildProcess } from 'node:child_process';
+type SpawnFn = (cmd: string, args: string[]) => ChildProcess;
+export interface BuildArgs {
+    tag: string;
+    cwd: string;
+    buildArgs?: Record<string, string>;
+    spawnFn?: SpawnFn;
+}
+export interface BuildResult {
+    ok: boolean;
+    imageId?: string;
+    error?: string;
+}
+export declare function dockerBuild(args: BuildArgs): Promise<BuildResult>;
+export interface RunArgs {
+    image: string;
+    name: string;
+    hostPort: number;
+    env: Record<string, string>;
+    volumes: Record<string, string>;
+    spawnFn?: SpawnFn;
+}
+export interface DockerRunResult {
+    ok: boolean;
+    containerName?: string;
+    error?: string;
+}
+export declare function dockerRun(args: RunArgs): Promise<DockerRunResult>;
+export declare function dockerStop(name: string, spawnFn?: SpawnFn): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function dockerRm(name: string, spawnFn?: SpawnFn): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function dockerStart(name: string, spawnFn?: SpawnFn): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function dockerRmi(tag: string, spawnFn?: SpawnFn): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export interface PsResult {
+    containers: Array<{
+        name: string;
+        state: string;
+        ports: string;
+    }>;
+}
+export declare function dockerPs(spawnFn?: SpawnFn): Promise<PsResult>;
+export {};

package/dist/src/ultraapp/docker.js

@@ -0,0 +1,83 @@
+/**
+ * Thin wrapper around the docker CLI. Centralised so tests mock the
+ * spawnFn and the rest of ultraapp doesn't touch child_process directly.
+ */
+import { spawn as realSpawn } from 'node:child_process';
+async function run(args, spawnFn) {
+    return new Promise((resolve) => {
+        const child = spawnFn('docker', args);
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (d) => (stdout += d.toString()));
+        child.stderr?.on('data', (d) => (stderr += d.toString()));
+        child.on('close', (code) => {
+            resolve({ ok: code === 0, stdout, stderr, code: code ?? -1 });
+        });
+    });
+}
+export async function dockerBuild(args) {
+    const sp = args.spawnFn ?? realSpawn;
+    const cli = ['build', '-t', args.tag];
+    for (const [k, v] of Object.entries(args.buildArgs ?? {})) {
+        cli.push('--build-arg', `${k}=${v}`);
+    }
+    cli.push(args.cwd);
+    const r = await run(cli, sp);
+    if (!r.ok)
+        return { ok: false, error: r.stderr || `docker build exited ${r.code}` };
+    // Try several patterns. Modern buildx prints "writing image sha256:...";
+    // legacy docker prints "Successfully built <hash>".
+    const m = /Successfully built ([a-f0-9]+)/.exec(r.stdout) ??
+        /writing image sha256:([a-f0-9]+)/.exec(r.stdout) ??
+        /writing image sha256:([a-f0-9]+)/.exec(r.stderr);
+    return { ok: true, imageId: m?.[1] ?? 'unknown' };
+}
+export async function dockerRun(args) {
+    const sp = args.spawnFn ?? realSpawn;
+    const cli = ['run', '-d', '--name', args.name, '--restart', 'unless-stopped', '-p', `${args.hostPort}:3000`];
+    for (const [k, v] of Object.entries(args.env))
+        cli.push('-e', `${k}=${v}`);
+    for (const [host, container] of Object.entries(args.volumes))
+        cli.push('-v', `${host}:${container}`);
+    cli.push(args.image);
+    const r = await run(cli, sp);
+    if (!r.ok)
+        return { ok: false, error: r.stderr || `docker run exited ${r.code}` };
+    return { ok: true, containerName: r.stdout.trim() };
+}
+export async function dockerStop(name, spawnFn = realSpawn) {
+    const r = await run(['stop', name], spawnFn);
+    return r.ok ? { ok: true } : { ok: false, error: r.stderr };
+}
+export async function dockerRm(name, spawnFn = realSpawn) {
+    const r = await run(['rm', '-f', name], spawnFn);
+    return r.ok ? { ok: true } : { ok: false, error: r.stderr };
+}
+export async function dockerStart(name, spawnFn = realSpawn) {
+    const r = await run(['start', name], spawnFn);
+    return r.ok ? { ok: true } : { ok: false, error: r.stderr };
+}
+export async function dockerRmi(tag, spawnFn = realSpawn) {
+    const r = await run(['rmi', '-f', tag], spawnFn);
+    return r.ok ? { ok: true } : { ok: false, error: r.stderr };
+}
+export async function dockerPs(spawnFn = realSpawn) {
+    const r = await run(['ps', '-a', '--format', '{{json .}}'], spawnFn);
+    if (!r.ok)
+        return { containers: [] };
+    const containers = r.stdout
+        .split('\n')
+        .filter((l) => l.length > 0)
+        .map((l) => {
+        try {
+            const j = JSON.parse(l);
+            return { name: j.Names, state: j.State, ports: j.Ports };
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((x) => x !== null);
+    return { containers };
+}
+//# sourceMappingURL=docker.js.map

package/dist/src/ultraapp/docker.js.map

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

package/dist/src/ultraapp/feedback-classifier.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Done-mode feedback classifier — single Haiku call categorising user input
+ * into cosmetic / spec-delta / structural so the manager can route it.
+ *
+ * Safe-default fallback: if the LLM call fails or returns malformed output,
+ * we return spec-delta (cheaper to recover from than wrongly running the
+ * patcher on a structural change).
+ */
+import type { AppSpec } from './spec.js';
+export interface ClassifyArgs {
+    text: string;
+    currentSpec: AppSpec;
+    language: 'zh' | 'en';
+    llmCall: (prompt: string) => Promise<{
+        output: string;
+    }>;
+}
+export type FeedbackClass = 'cosmetic' | 'spec-delta' | 'structural';
+export interface ClassifyResult {
+    class: FeedbackClass;
+    reason: string;
+    proposedAction: string;
+}
+export declare function classifyFeedback(args: ClassifyArgs): Promise<ClassifyResult>;

package/dist/src/ultraapp/feedback-classifier.js

@@ -0,0 +1,85 @@
+/**
+ * Done-mode feedback classifier — single Haiku call categorising user input
+ * into cosmetic / spec-delta / structural so the manager can route it.
+ *
+ * Safe-default fallback: if the LLM call fails or returns malformed output,
+ * we return spec-delta (cheaper to recover from than wrongly running the
+ * patcher on a structural change).
+ */
+const SYSTEM = `
+You classify post-deploy user feedback for ultraapp into one of three buckets:
+
+  cosmetic   — visual/UI tweak; doesn't change AppSpec
+               (e.g., "button too dark", "logo too small", "use a serif font")
+  spec-delta — adds, removes, or changes a step / input / output / runtime field
+               (e.g., "also output a thumbnail", "input should accept audio")
+  structural — workflow doesn't fit the original AppSpec at all; better to
+               start a fresh ultraapp run
+               (e.g., "this isn't even the right pipeline", "I want a totally
+               different app")
+
+Return JSON in a fenced \`\`\`classification block:
+
+{
+  "class": "cosmetic" | "spec-delta" | "structural",
+  "reason": "<one sentence explanation>",
+  "proposedAction": "<one phrase: e.g., 'apply patch' / 'focused interview on outputs' / 'suggest new run'>"
+}
+
+Be conservative: when in doubt, prefer spec-delta over structural (cheaper to
+recover from). Prefer cosmetic over spec-delta only when you're confident the
+change is purely visual.
+`.trim();
+const FENCE_RE = /```classification\s*\n([\s\S]*?)\n```/;
+export async function classifyFeedback(args) {
+    const userPrompt = `Current AppSpec (JSON):
+
+\`\`\`json
+${JSON.stringify(args.currentSpec, null, 2)}
+\`\`\`
+
+User feedback (in ${args.language === 'zh' ? 'Chinese' : 'English'}):
+
+> ${args.text}
+
+Classify it.`;
+    let output;
+    try {
+        const r = await args.llmCall(`${SYSTEM}\n\n${userPrompt}`);
+        output = r.output;
+    }
+    catch (e) {
+        return {
+            class: 'spec-delta',
+            reason: `classifier error: ${e.message} (fallback)`,
+            proposedAction: 'focused interview',
+        };
+    }
+    const m = FENCE_RE.exec(output);
+    if (!m) {
+        return {
+            class: 'spec-delta',
+            reason: 'malformed classifier output (fallback to spec-delta)',
+            proposedAction: 'focused interview',
+        };
+    }
+    try {
+        const j = JSON.parse(m[1]);
+        if (j.class === 'cosmetic' || j.class === 'spec-delta' || j.class === 'structural') {
+            return {
+                class: j.class,
+                reason: j.reason ?? '',
+                proposedAction: j.proposedAction ?? '',
+            };
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return {
+        class: 'spec-delta',
+        reason: 'malformed classifier JSON (fallback)',
+        proposedAction: 'focused interview',
+    };
+}
+//# sourceMappingURL=feedback-classifier.js.map

package/dist/src/ultraapp/feedback-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-classifier.js","sourceRoot":"","sources":["../../../src/ultraapp/feedback-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBd,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,QAAQ,GAAG,uCAAuC,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAkB;IACvD,MAAM,UAAU,GAAG;;;EAGnB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;;;oBAGvB,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;;IAE9D,IAAI,CAAC,IAAI;;aAEA,CAAC;IAEZ,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,MAAM,OAAO,UAAU,EAAE,CAAC,CAAC;QAC3D,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACpB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,qBAAsB,CAAW,CAAC,OAAO,aAAa;YAC9D,cAAc,EAAE,mBAAmB;SACpC,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO;YACL,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,sDAAsD;YAC9D,cAAc,EAAE,mBAAmB;SACpC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAA4B,CAAC;QACtD,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU,IAAI,CAAC,CAAC,KAAK,KAAK,YAAY,IAAI,CAAC,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;YACnF,OAAO;gBACL,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;gBACtB,cAAc,EAAE,CAAC,CAAC,cAAc,IAAI,EAAE;aACvC,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IACD,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,MAAM,EAAE,sCAAsC;QAC9C,cAAc,EAAE,mBAAmB;KACpC,CAAC;AACJ,CAAC"}

package/dist/src/ultraapp/files.d.ts

@@ -0,0 +1,24 @@
+export interface PathValidationOptions {
+    allow: string[];
+    lstat?: (p: string) => {
+        isSymbolicLink: () => boolean;
+    };
+}
+export declare function validateLocalPath(p: string, opts: PathValidationOptions): void;
+export declare function defaultAllowedRoots(): string[];
+export declare function ingestUpload(examplesDir: string, filename: string, data: Buffer): Promise<string>;
+type RunResult = {
+    ok: boolean;
+    stdout: string;
+};
+type Runner = (cmd: string, args: string[]) => Promise<RunResult>;
+export interface ExtractMetaOptions {
+    runner?: Runner;
+}
+export interface FileMetadata {
+    fileType?: string;
+    ffprobe?: unknown;
+    sizeBytes?: number;
+}
+export declare function extractMetadata(p: string, opts?: ExtractMetaOptions): Promise<FileMetadata>;
+export {};

package/dist/src/ultraapp/files.js

@@ -0,0 +1,79 @@
+import * as fs from 'node:fs';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { spawn } from 'node:child_process';
+const MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
+export function validateLocalPath(p, opts) {
+    if (!path.isAbsolute(p))
+        throw new Error('path must be absolute');
+    if (p.includes('/.') || p.startsWith('.'))
+        throw new Error('dotfile/dotdir paths are not allowed');
+    const inside = opts.allow.some((root) => p === root || p.startsWith(root + path.sep) || p.startsWith(root + '/'));
+    if (!inside)
+        throw new Error(`path outside sandbox: ${opts.allow.join(', ')}`);
+    const lstat = opts.lstat ?? ((q) => fs.lstatSync(q));
+    let info;
+    try {
+        info = lstat(p);
+    }
+    catch {
+        return;
+    }
+    if (info.isSymbolicLink())
+        throw new Error('symlink paths are not allowed');
+}
+export function defaultAllowedRoots() {
+    const home = process.env.HOME ?? '';
+    const allow = [];
+    if (home)
+        allow.push(home);
+    allow.push('/tmp');
+    return allow;
+}
+export async function ingestUpload(examplesDir, filename, data) {
+    if (data.byteLength > MAX_UPLOAD_BYTES) {
+        throw new Error(`upload too large (${data.byteLength} bytes, max ${MAX_UPLOAD_BYTES})`);
+    }
+    await fsp.mkdir(examplesDir, { recursive: true });
+    const safe = filename.replace(/[^A-Za-z0-9._-]/g, '_').slice(0, 100);
+    const ref = path.join(examplesDir, `${crypto.randomUUID()}-${safe}`);
+    await fsp.writeFile(ref, data);
+    return ref;
+}
+const realRunner = (cmd, args) => new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'ignore'] });
+    let stdout = '';
+    child.stdout.on('data', (d) => {
+        stdout += d.toString();
+    });
+    child.on('close', (code) => resolve({ ok: code === 0, stdout }));
+    child.on('error', () => resolve({ ok: false, stdout: '' }));
+});
+export async function extractMetadata(p, opts = {}) {
+    const runner = opts.runner ?? realRunner;
+    const meta = {};
+    try {
+        const stat = await fsp.stat(p);
+        meta.sizeBytes = stat.size;
+    }
+    catch {
+        /* missing file — return empty */
+    }
+    const fileRes = await runner('file', [p]);
+    if (fileRes.ok) {
+        const m = fileRes.stdout.trim();
+        meta.fileType = m.includes(': ') ? m.slice(m.indexOf(': ') + 2) : m;
+    }
+    const ffRes = await runner('ffprobe', ['-v', 'quiet', '-print_format', 'json', '-show_format', '-show_streams', p]);
+    if (ffRes.ok && ffRes.stdout.trim().length > 0) {
+        try {
+            meta.ffprobe = JSON.parse(ffRes.stdout);
+        }
+        catch {
+            /* malformed → skip */
+        }
+    }
+    return meta;
+}
+//# sourceMappingURL=files.js.map

package/dist/src/ultraapp/files.js.map

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

package/dist/src/ultraapp/fix-on-failure-session.d.ts

@@ -0,0 +1,23 @@
+export interface SessionManagerLike {
+    startSession(c: {
+        name?: string;
+        engine?: string;
+        model?: string;
+        cwd?: string;
+        systemPrompt?: string;
+        permissionMode?: string;
+    }): Promise<{
+        name: string;
+    }>;
+    sendMessage(name: string, msg: string): Promise<{
+        output: string;
+    }>;
+    stopSession(name: string): Promise<void>;
+}
+export interface FixerArgs {
+    worktreePath: string;
+    failingCommand: string;
+    tail: string;
+}
+export declare function spawnFixerSession(args: FixerArgs): Promise<void>;
+export declare function spawnFixerSessionWith(sm: SessionManagerLike, args: FixerArgs): Promise<void>;

package/dist/src/ultraapp/fix-on-failure-session.js

@@ -0,0 +1,48 @@
+import * as crypto from 'node:crypto';
+const SYSTEM = `
+You are a fix-on-failure agent for an ultraapp build. The user will give you
+the worktree path, a failing shell command, and the last 200 lines of its
+output. Your job: edit files to make the failing command succeed. Don't change
+application behaviour, only fix mechanical errors (types, imports, dockerfile
+syntax, missing files). When done, reply with the literal marker line:
+
+[FIX-ROUND-DONE]
+
+If the failure is genuinely caused by a behaviour problem you can't fix
+without changing semantics, reply with:
+
+[FIX-ROUND-GIVEUP] reason: <one sentence>
+
+Then [FIX-ROUND-DONE].
+`.trim();
+const COMPLETE_RE = /\[FIX-ROUND-DONE\]/;
+const MAX_ATTEMPTS = 5;
+export async function spawnFixerSession(args) {
+    const { SessionManager } = await import('../session-manager.js');
+    const sm = new SessionManager();
+    await spawnFixerSessionWith(sm, args);
+}
+export async function spawnFixerSessionWith(sm, args) {
+    const sessionName = `ua-fix-${crypto.randomBytes(4).toString('hex')}`;
+    await sm.startSession({
+        name: sessionName,
+        engine: 'claude',
+        model: 'claude-opus-4-7',
+        cwd: args.worktreePath,
+        systemPrompt: SYSTEM,
+        permissionMode: 'bypassPermissions',
+    });
+    try {
+        const prompt = `Failing command: \`${args.failingCommand}\`\n\nLast output:\n\n\`\`\`\n${args.tail}\n\`\`\`\n\nFix it. End with [FIX-ROUND-DONE].`;
+        let attempts = 0;
+        while (attempts++ < MAX_ATTEMPTS) {
+            const r = await sm.sendMessage(sessionName, attempts === 1 ? prompt : 'continue. when done, output [FIX-ROUND-DONE].');
+            if (COMPLETE_RE.test(r.output))
+                break;
+        }
+    }
+    finally {
+        await sm.stopSession(sessionName).catch(() => { });
+    }
+}
+//# sourceMappingURL=fix-on-failure-session.js.map

package/dist/src/ultraapp/fix-on-failure-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-on-failure-session.js","sourceRoot":"","sources":["../../../src/ultraapp/fix-on-failure-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAqBtC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;CAed,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,WAAW,GAAG,oBAAoB,CAAC;AACzC,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAe;IACrD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,IAAI,cAAc,EAAE,CAAC;IAChC,MAAM,qBAAqB,CAAC,EAAmC,EAAE,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAAsB,EAAE,IAAe;IACjF,MAAM,WAAW,GAAG,UAAU,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IACtE,MAAM,EAAE,CAAC,YAAY,CAAC;QACpB,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,iBAAiB;QACxB,GAAG,EAAE,IAAI,CAAC,YAAY;QACtB,YAAY,EAAE,MAAM;QACpB,cAAc,EAAE,mBAAmB;KACpC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,sBAAsB,IAAI,CAAC,cAAc,iCAAiC,IAAI,CAAC,IAAI,gDAAgD,CAAC;QACnJ,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,OAAO,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,WAAW,CAC5B,WAAW,EACX,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,+CAA+C,CAC1E,CAAC;YACF,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;gBAAE,MAAM;QACxC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/src/ultraapp/fix-on-failure.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Purpose-built helper: run the standard verification pipeline in a worktree,
+ * spawn a Claude session to fix mechanical errors on red, retry up to N rounds.
+ *
+ * Not to be confused with src/autoloop/, which is a planner/coder/reviewer
+ * message-bus orchestrator for a different problem shape.
+ */
+export interface ShellResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+}
+export type ShellRunner = (cmd: string, args: string[], opts: {
+    cwd: string;
+}) => Promise<ShellResult>;
+export interface FixerArgs {
+    worktreePath: string;
+    failingCommand: string;
+    tail: string;
+}
+export type FixerSpawner = (args: FixerArgs) => Promise<void>;
+export interface FixOnFailureArgs {
+    worktreePath: string;
+    maxRounds: number;
+    shell?: ShellRunner;
+    spawnFixer?: FixerSpawner;
+    steps?: Array<{
+        cmd: string;
+        args: string[];
+        required?: boolean;
+    }>;
+}
+export interface FixOnFailureResult {
+    ok: boolean;
+    rounds: number;
+    lastError?: string;
+    failingCommand?: string;
+}
+export declare function runFixOnFailure(args: FixOnFailureArgs): Promise<FixOnFailureResult>;

package/dist/src/ultraapp/fix-on-failure.js

@@ -0,0 +1,69 @@
+/**
+ * Purpose-built helper: run the standard verification pipeline in a worktree,
+ * spawn a Claude session to fix mechanical errors on red, retry up to N rounds.
+ *
+ * Not to be confused with src/autoloop/, which is a planner/coder/reviewer
+ * message-bus orchestrator for a different problem shape.
+ */
+import { spawn } from 'node:child_process';
+const DEFAULT_STEPS = [
+    { cmd: 'npm', args: ['install'] },
+    { cmd: 'npm', args: ['run', 'build'] },
+    { cmd: 'npm', args: ['test'] },
+    { cmd: 'docker', args: ['build', '-t', 'ultraapp-fix:test', '.'] },
+];
+const TAIL_LINES = 200;
+export async function runFixOnFailure(args) {
+    const shell = args.shell ?? realShell;
+    const spawnFixer = args.spawnFixer ?? defaultSpawnFixer;
+    const steps = args.steps ?? DEFAULT_STEPS;
+    let rounds = 0;
+    while (true) {
+        const failure = await runPipelineOnce(shell, args.worktreePath, steps);
+        if (failure === null)
+            return { ok: true, rounds };
+        if (rounds >= args.maxRounds) {
+            return {
+                ok: false,
+                rounds,
+                lastError: failure.lastError,
+                failingCommand: failure.failingCommand,
+            };
+        }
+        rounds++;
+        await spawnFixer({
+            worktreePath: args.worktreePath,
+            failingCommand: failure.failingCommand,
+            tail: failure.tail,
+        });
+    }
+}
+async function runPipelineOnce(shell, cwd, steps) {
+    for (const step of steps) {
+        const r = await shell(step.cmd, step.args, { cwd });
+        if (!r.ok) {
+            const cmdline = `${step.cmd} ${step.args.join(' ')}`;
+            const tail = lastN(r.stderr || r.stdout, TAIL_LINES);
+            return { failingCommand: cmdline, lastError: tail.slice(0, 500), tail };
+        }
+    }
+    return null;
+}
+function lastN(s, n) {
+    const lines = s.split('\n');
+    return lines.slice(-n).join('\n');
+}
+const realShell = (cmd, args, opts) => new Promise((resolve) => {
+    const child = spawn(cmd, args, { cwd: opts.cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+    let stdout = '';
+    let stderr = '';
+    child.stdout.on('data', (d) => (stdout += d.toString()));
+    child.stderr.on('data', (d) => (stderr += d.toString()));
+    child.on('close', (code) => resolve({ ok: code === 0, stdout, stderr }));
+    child.on('error', (e) => resolve({ ok: false, stdout, stderr: stderr + e.message }));
+});
+const defaultSpawnFixer = async (args) => {
+    const { spawnFixerSession } = await import('./fix-on-failure-session.js');
+    await spawnFixerSession(args);
+};
+//# sourceMappingURL=fix-on-failure.js.map

package/dist/src/ultraapp/fix-on-failure.js.map

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

package/dist/src/ultraapp/host-strategy.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Host-spawn runtime strategy — runs the generated app as a regular Node
+ * process on the host, no Docker. The natural default for personal /
+ * internal-tool use; Docker is the opt-in mode for shared production
+ * hosts where isolation matters.
+ *
+ * Mirrors the docker.ts shape (`build / run / stop / start / rm`) so the
+ * deploy orchestrator and lifecycle helpers stay the same.
+ *
+ * State persistence:
+ *   ~/.claw-orchestrator/host-procs.json keyed by container-name (we keep
+ *   the term to match the rest of the API) → { pid, port, cwd, env, since }.
+ *   Survives orchestrator restarts: hostStart re-spawns from the saved
+ *   metadata, hostStop kills the recorded pid + child group.
+ */
+import type { BuildResult, DockerRunResult, PsResult } from './docker.js';
+export interface HostBuildArgs {
+    tag: string;
+    cwd: string;
+    buildArgs?: Record<string, string>;
+}
+/**
+ * Host build = `npm install` + `npm run build` (if a build script exists).
+ * No isolation; we mutate the worktree directly. The "tag" is metadata only
+ * — host-mode doesn't have container images.
+ */
+export declare function hostBuild(args: HostBuildArgs): Promise<BuildResult>;
+export interface HostRunArgs {
+    image: string;
+    name: string;
+    hostPort: number;
+    env: Record<string, string>;
+    volumes?: Record<string, string>;
+}
+/**
+ * Host run = spawn `npm start` (or `node server.js` fallback) detached, with
+ * PORT + caller env. Records pid in host-procs.json keyed by name.
+ */
+export declare function hostRun(args: HostRunArgs): Promise<DockerRunResult>;
+export declare function hostStop(name: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function hostStart(name: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function hostRm(name: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** Stub matching dockerRmi — host mode has no images, so this is a no-op. */
+export declare function hostRmi(_tag: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function hostPs(): Promise<PsResult>;