@phamvuhoang/otto-core 0.1.0

package/dist/stage-exec.js

@@ -0,0 +1,35 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname, join, posix } from "node:path";
+import { renderTemplate } from "./render.js";
+import { DEFAULT_BACKOFF_MS, backoffFor, withRetries } from "./retry.js";
+import { runStage, stageLogPath } from "./runner.js";
+import { USE_COLOR, dim } from "./stream-render.js";
+/** Render a stage's template (inside the retry, so flaky shell tags retry) and run it. */
+export async function executeStage(opts) {
+    const { stage, vars, workspaceDir, packageDir, iteration, maxRetries, signal, } = opts;
+    const label = opts.logLabel ?? stage.name;
+    const spillRel = `spill-${process.pid}-${iteration}-${label}-${Date.now()}`;
+    const spillHostDir = join(workspaceDir, ".otto-tmp", spillRel);
+    const spillRefPath = posix.join(".otto-tmp", spillRel);
+    const stageLog = stageLogPath(workspaceDir, iteration, label);
+    mkdirSync(dirname(stageLog), { recursive: true });
+    return withRetries(() => {
+        const prompt = renderTemplate(join(packageDir, "templates", stage.template), vars, { cwd: workspaceDir, spillHostDir, spillRefPath });
+        return runStage(stage, prompt, workspaceDir, iteration, spillHostDir, stageLog, { signal });
+    }, {
+        max: maxRetries,
+        backoffMs: DEFAULT_BACKOFF_MS,
+        onAttempt: (attempt, err) => {
+            const wait = backoffFor(DEFAULT_BACKOFF_MS, attempt);
+            const marker = `[retry] attempt ${attempt} of ${maxRetries} after ${wait} ms`;
+            process.stderr.write(`${USE_COLOR ? dim(marker) : marker} ${dim("(" + err.message + ")")}\n`);
+            try {
+                appendFileSync(stageLog, marker + "\n");
+            }
+            catch {
+                // log file may be unwritable; never crash on the marker.
+            }
+        },
+    });
+}
+//# sourceMappingURL=stage-exec.js.map

package/dist/stage-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage-exec.js","sourceRoot":"","sources":["../src/stage-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAepD,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAyB;IAEzB,MAAM,EACJ,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,EACV,MAAM,GACP,GAAG,IAAI,CAAC;IACT,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC;IAC1C,MAAM,QAAQ,GAAG,SAAS,OAAO,CAAC,GAAG,IAAI,SAAS,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAC5E,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9D,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElD,OAAO,WAAW,CAChB,GAAG,EAAE;QACH,MAAM,MAAM,GAAG,cAAc,CAC3B,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,EAC7C,IAAI,EACJ,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAClD,CAAC;QACF,OAAO,QAAQ,CACb,KAAK,EACL,MAAM,EACN,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,EAAE,MAAM,EAAE,CACX,CAAC;IACJ,CAAC,EACD;QACE,GAAG,EAAE,UAAU;QACf,SAAS,EAAE,kBAAkB;QAC7B,SAAS,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;YAC1B,MAAM,IAAI,GAAG,UAAU,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,mBAAmB,OAAO,OAAO,UAAU,UAAU,IAAI,KAAK,CAAC;YAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,GAAI,GAAa,CAAC,OAAO,GAAG,GAAG,CAAC,IAAI,CACnF,CAAC;YACF,IAAI,CAAC;gBACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;YAC3D,CAAC;QACH,CAAC;KACF,CACF,CAAC;AACJ,CAAC"}

package/dist/stages.d.ts

@@ -0,0 +1,38 @@
+export type Stage = {
+    name: string;
+    template: string;
+    permissionMode?: string;
+};
+export declare const STAGES: {
+    implementer: {
+        name: string;
+        template: string;
+        permissionMode: string;
+    };
+    ghafkImplementer: {
+        name: string;
+        template: string;
+        permissionMode: string;
+    };
+    ghafkIssueImplementer: {
+        name: string;
+        template: string;
+        permissionMode: string;
+    };
+    verifier: {
+        name: string;
+        template: string;
+        permissionMode: string;
+    };
+    applyReviewImplementer: {
+        name: string;
+        template: string;
+        permissionMode: string;
+    };
+    reviewer: {
+        name: string;
+        template: string;
+        permissionMode: string;
+    };
+};
+//# sourceMappingURL=stages.d.ts.map

package/dist/stages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stages.d.ts","sourceRoot":"","sources":["../src/stages.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAOF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB,CAAC"}

package/dist/stages.js

@@ -0,0 +1,38 @@
+// Every stage runs `claude --permission-mode bypassPermissions` so bash + edits
+// auto-approve for non-interactive AFK. Blast radius is bounded by the runner
+// (see resolveRunner in runner.ts): the default `sandbox` runner confines writes
+// to the workspace via the native OS sandbox; `OTTO_RUNNER=host` runs unsandboxed
+// (git-recoverable workspace only). See the spec under docs/superpowers/specs/.
+export const STAGES = {
+    implementer: {
+        name: "implementer",
+        template: "afk.md",
+        permissionMode: "bypassPermissions",
+    },
+    ghafkImplementer: {
+        name: "ghafk-implementer",
+        template: "ghafk.md",
+        permissionMode: "bypassPermissions",
+    },
+    ghafkIssueImplementer: {
+        name: "ghafk-issue-implementer",
+        template: "ghafk-issue.md",
+        permissionMode: "bypassPermissions",
+    },
+    verifier: {
+        name: "verifier",
+        template: "verify.md",
+        permissionMode: "bypassPermissions",
+    },
+    applyReviewImplementer: {
+        name: "apply-review-implementer",
+        template: "apply-review.md",
+        permissionMode: "bypassPermissions",
+    },
+    reviewer: {
+        name: "reviewer",
+        template: "review.md",
+        permissionMode: "bypassPermissions",
+    },
+};
+//# sourceMappingURL=stages.js.map

package/dist/stages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stages.js","sourceRoot":"","sources":["../src/stages.ts"],"names":[],"mappings":"AAMA,gFAAgF;AAChF,8EAA8E;AAC9E,iFAAiF;AACjF,kFAAkF;AAClF,gFAAgF;AAChF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,QAAQ;QAClB,cAAc,EAAE,mBAAmB;KACpB;IACjB,gBAAgB,EAAE;QAChB,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,UAAU;QACpB,cAAc,EAAE,mBAAmB;KACpB;IACjB,qBAAqB,EAAE;QACrB,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,gBAAgB;QAC1B,cAAc,EAAE,mBAAmB;KACpB;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,mBAAmB;KACpB;IACjB,sBAAsB,EAAE;QACtB,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE,iBAAiB;QAC3B,cAAc,EAAE,mBAAmB;KACpB;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,mBAAmB;KACpB;CAClB,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,25 @@
+export type RunStatus = "running" | "waiting-rate-limit" | "interrupted" | "complete";
+export type RunState = {
+    bin: string;
+    mode: string;
+    inputs: string;
+    iteration: number;
+    of: number;
+    status: RunStatus;
+    resetsAt?: number | null;
+    startedAt: string;
+    updatedAt: string;
+};
+/** Read .otto/state.json. Absent or malformed → null (never throws). */
+export declare function readState(workspaceDir: string): RunState | null;
+/** Write .otto/state.json (creates .otto/). */
+export declare function writeState(workspaceDir: string, s: RunState): void;
+/** Remove .otto/state.json; ignore if absent. */
+export declare function clearState(workspaceDir: string): void;
+/** Resume iff a prior unfinished run matches this invocation's identity. */
+export declare function matchesResume(prev: RunState | null, cur: {
+    bin: string;
+    mode: string;
+    inputs: string;
+}): boolean;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,oBAAoB,GACpB,aAAa,GACb,UAAU,CAAC;AAEf,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAIF,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQ/D;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAMlE;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,GAAG,IAAI,EACrB,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAQT"}

package/dist/state.js

@@ -0,0 +1,30 @@
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const STATE_REL = join(".otto", "state.json");
+/** Read .otto/state.json. Absent or malformed → null (never throws). */
+export function readState(workspaceDir) {
+    try {
+        return JSON.parse(readFileSync(join(workspaceDir, STATE_REL), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/** Write .otto/state.json (creates .otto/). */
+export function writeState(workspaceDir, s) {
+    mkdirSync(join(workspaceDir, ".otto"), { recursive: true });
+    writeFileSync(join(workspaceDir, STATE_REL), JSON.stringify(s, null, 2) + "\n");
+}
+/** Remove .otto/state.json; ignore if absent. */
+export function clearState(workspaceDir) {
+    rmSync(join(workspaceDir, STATE_REL), { force: true });
+}
+/** Resume iff a prior unfinished run matches this invocation's identity. */
+export function matchesResume(prev, cur) {
+    return (prev != null &&
+        prev.status !== "complete" &&
+        prev.bin === cur.bin &&
+        prev.mode === cur.mode &&
+        prev.inputs === cur.inputs);
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAoBjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAE9C,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,YAAoB;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CACf,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CACxC,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,UAAU,CAAC,YAAoB,EAAE,CAAW;IAC1D,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,aAAa,CACX,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EAC7B,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAClC,CAAC;AACJ,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAC3B,IAAqB,EACrB,GAAkD;IAElD,OAAO,CACL,IAAI,IAAI,IAAI;QACZ,IAAI,CAAC,MAAM,KAAK,UAAU;QAC1B,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG;QACpB,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI;QACtB,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,CAC3B,CAAC;AACJ,CAAC"}

package/dist/stream-render.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Terminal pretty-printer for the Claude CLI's NDJSON stream, plus the TTY-gated
+ * ANSI styling primitives. Extracted from runner.ts: this module has no runner
+ * dependency — `renderEvent` consumes an already-parsed stream event and writes
+ * assistant text to stdout and tool/diagnostic events to stderr.
+ */
+/** Controls ANSI codes on stderr (tool events, banners, subprocess output). */
+export declare const USE_COLOR: boolean;
+export declare const dim: (s: string) => string;
+export declare const bold: (s: string) => string;
+export declare const green: (s: string) => string;
+export declare const red: (s: string) => string;
+export declare const boldOut: (s: string) => string;
+export declare const greenOut: (s: string) => string;
+export declare const dimOut: (s: string) => string;
+export declare const SYM: {
+    bullet: string;
+    cont: string;
+    check: string;
+    cross: string;
+    rule: string;
+    ellip: string;
+};
+export declare const SYM_OUT: {
+    bullet: string;
+};
+type AssistantBlock = {
+    type: string;
+    text?: string;
+    name?: string;
+    input?: unknown;
+    id?: string;
+};
+type UserBlock = {
+    type: string;
+    content?: unknown;
+    is_error?: boolean;
+    tool_use_id?: string;
+};
+export type StreamJson = {
+    type: "assistant";
+    message?: {
+        content?: AssistantBlock[];
+    };
+} | {
+    type: "user";
+    message?: {
+        content?: UserBlock[];
+    };
+} | {
+    type: "system";
+    subtype?: string;
+    [k: string]: unknown;
+} | {
+    type: "result";
+    result?: string;
+    is_error?: boolean;
+} | {
+    type: string;
+    [k: string]: unknown;
+};
+export type ToolTrack = {
+    name: string;
+    startedAt: number;
+};
+export declare function renderEvent(ev: StreamJson, toolMap: Map<string, ToolTrack>): void;
+export {};
+//# sourceMappingURL=stream-render.d.ts.map

package/dist/stream-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-render.d.ts","sourceRoot":"","sources":["../src/stream-render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,+EAA+E;AAC/E,eAAO,MAAM,SAAS,SAAiD,CAAC;AAWxE,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,KAAG,MAAmB,CAAC;AACpD,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,KAAG,MAAmB,CAAC;AAErD,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,KAAG,MAAoB,CAAC;AACvD,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,KAAG,MAAoB,CAAC;AACrD,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG,MAAsB,CAAC;AAE3D,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,KAAG,MAAuB,CAAC;AAC7D,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,MAAsB,CAAC;AAE1D,eAAO,MAAM,GAAG;;;;;;;CASX,CAAC;AAEN,eAAO,MAAM,OAAO;;CAAuD,CAAC;AAE5E,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AACF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AACF,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;KAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAA;KAAE,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,wBAAgB,WAAW,CACzB,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAC9B,IAAI,CAqFN"}

package/dist/stream-render.js

@@ -0,0 +1,162 @@
+/**
+ * Terminal pretty-printer for the Claude CLI's NDJSON stream, plus the TTY-gated
+ * ANSI styling primitives. Extracted from runner.ts: this module has no runner
+ * dependency — `renderEvent` consumes an already-parsed stream event and writes
+ * assistant text to stdout and tool/diagnostic events to stderr.
+ */
+const TOOL_INPUT_PREVIEW = 200;
+const TOOL_RESULT_PREVIEW = 120;
+const TOOL_ERROR_PREVIEW = 400;
+/* ── TTY-gated styling ────────────────────────────────────────────────── */
+const NO_COLOR_ENV = process.env.NO_COLOR != null || process.env.TERM === "dumb";
+/** Controls ANSI codes on stderr (tool events, banners, subprocess output). */
+export const USE_COLOR = process.stderr.isTTY === true && !NO_COLOR_ENV;
+/** Controls ANSI codes on stdout (assistant text bullets, completion line).
+ *  Separate from USE_COLOR so `otto-ghafk 1 > out.txt` stays clean even
+ *  when stderr is still a TTY. */
+const USE_COLOR_STDOUT = process.stdout.isTTY === true && !NO_COLOR_ENV;
+const c = (code, s) => USE_COLOR ? `\x1b[${code}m${s}\x1b[0m` : s;
+const cOut = (code, s) => USE_COLOR_STDOUT ? `\x1b[${code}m${s}\x1b[0m` : s;
+export const dim = (s) => c("2", s);
+export const bold = (s) => c("1", s);
+const cyan = (s) => c("36", s);
+export const green = (s) => c("32", s);
+export const red = (s) => c("31", s);
+export const boldOut = (s) => cOut("1", s);
+const cyanOut = (s) => cOut("36", s);
+export const greenOut = (s) => cOut("32", s);
+export const dimOut = (s) => cOut("2", s);
+export const SYM = USE_COLOR
+    ? { bullet: "●", cont: "⎿", check: "✓", cross: "✗", rule: "━", ellip: "…" }
+    : {
+        bullet: "*",
+        cont: "  >",
+        check: "ok",
+        cross: "FAIL",
+        rule: "=",
+        ellip: "...",
+    };
+export const SYM_OUT = USE_COLOR_STDOUT ? { bullet: "●" } : { bullet: "*" };
+export function renderEvent(ev, toolMap) {
+    switch (ev.type) {
+        case "system": {
+            const sub = ev.subtype;
+            if (sub === "init") {
+                const model = ev.model ?? "?";
+                const cwd = ev.cwd ?? "?";
+                process.stderr.write(`${dim("───")} ${bold("init")} ${dim(`model=${model} cwd=${cwd}`)}\n`);
+            }
+            return;
+        }
+        case "assistant": {
+            const content = ev.message?.content ??
+                [];
+            for (const block of content) {
+                if (block.type === "text" && typeof block.text === "string") {
+                    const lines = block.text.split("\n");
+                    const formatted = lines
+                        .map((l, idx) => idx === 0 ? `${boldOut(cyanOut(SYM_OUT.bullet))} ${l}` : `  ${l}`)
+                        .join("\r\n");
+                    process.stdout.write(formatted + "\r\n\n");
+                }
+                else if (block.type === "thinking") {
+                    process.stderr.write(`${dim(SYM.bullet + " thinking" + SYM.ellip)}\n`);
+                }
+                else if (block.type === "tool_use") {
+                    const name = block.name ?? "?";
+                    const preview = previewInput(name, block.input);
+                    if (block.id) {
+                        toolMap.set(block.id, { name, startedAt: Date.now() });
+                    }
+                    process.stderr.write(`${cyan(SYM.bullet)} ${bold(name)} ${dim(preview)}\n`);
+                }
+            }
+            return;
+        }
+        case "user": {
+            const content = ev.message?.content ?? [];
+            for (const block of content) {
+                if (block.type !== "tool_result")
+                    continue;
+                const text = stringifyToolResult(block.content);
+                const tracked = block.tool_use_id
+                    ? toolMap.get(block.tool_use_id)
+                    : undefined;
+                const toolName = tracked?.name ?? "tool";
+                const elapsed = tracked ? ` (${Date.now() - tracked.startedAt}ms)` : "";
+                if (block.tool_use_id)
+                    toolMap.delete(block.tool_use_id);
+                if (block.is_error) {
+                    const snippet = text
+                        .replace(/\s+/g, " ")
+                        .trim()
+                        .slice(0, TOOL_ERROR_PREVIEW);
+                    process.stderr.write(`${dim(SYM.cont)} ${red(SYM.cross)} ${bold(toolName)}${red(" failed")}\n  ${red(snippet)}${text.length > snippet.length ? " " + SYM.ellip : ""}\n`);
+                }
+                else {
+                    const snippet = text
+                        .replace(/\s+/g, " ")
+                        .trim()
+                        .slice(0, TOOL_RESULT_PREVIEW);
+                    process.stderr.write(`${dim(SYM.cont)} ${green(SYM.check)} ${bold(toolName)}${dim(elapsed)} ${dim(snippet)}${text.length > snippet.length ? " " + SYM.ellip : ""}\n`);
+                }
+            }
+            return;
+        }
+        case "result": {
+            const isError = ev.is_error;
+            if (isError)
+                process.stderr.write(`${red(SYM.bullet + " result errored")}\n`);
+            return;
+        }
+        default:
+            return;
+    }
+}
+function previewInput(toolName, input) {
+    if (input == null || typeof input !== "object")
+        return "";
+    const obj = input;
+    // Pick the most informative field per tool.
+    const keyOrder = {
+        Bash: ["command"],
+        Edit: ["file_path"],
+        Write: ["file_path"],
+        Read: ["file_path"],
+        Glob: ["pattern", "path"],
+        Grep: ["pattern", "path"],
+        TodoWrite: [],
+    };
+    const keys = keyOrder[toolName] ?? Object.keys(obj).slice(0, 2);
+    const parts = [];
+    for (const k of keys) {
+        const v = obj[k];
+        if (v == null)
+            continue;
+        const s = typeof v === "string" ? v : JSON.stringify(v);
+        parts.push(`${k}=${truncate(s, TOOL_INPUT_PREVIEW)}`);
+    }
+    return parts.join(" ");
+}
+function stringifyToolResult(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((c) => {
+            if (typeof c === "string")
+                return c;
+            if (c && typeof c === "object" && "text" in c)
+                return String(c.text ?? "");
+            return JSON.stringify(c);
+        })
+            .join("\n");
+    }
+    return JSON.stringify(content ?? "");
+}
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return s.slice(0, max - 1) + SYM.ellip;
+}
+//# sourceMappingURL=stream-render.js.map

package/dist/stream-render.js.map

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

package/dist/watch.d.ts

@@ -0,0 +1,22 @@
+import type { Stage } from "./stages.js";
+/** Count open issues carrying `label`, via gh. Returns 0 on any failure (keep polling). */
+export declare function openIssueCount(label: string, cwd: string): number;
+export type RunWatchOptions = {
+    stages: [Stage, ...Stage[]];
+    iterations: number;
+    workspaceDir: string;
+    packageDir: string;
+    watchIntervalSec: number;
+    watchLabel: string;
+    budgetUsd?: number;
+    cooldownMs?: number;
+    maxRetries?: number;
+    reviewLenses?: string[];
+    notify?: boolean;
+    bin?: string;
+    cliVersion?: string;
+    /** Injectable for tests; defaults to openIssueCount. */
+    countIssues?: (label: string, cwd: string) => number;
+};
+export declare function runWatch(opts: RunWatchOptions): Promise<void>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../src/watch.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CA0BjE;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACtD,CAAC;AAEF,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFnE"}

package/dist/watch.js

@@ -0,0 +1,93 @@
+import { execFileSync } from "node:child_process";
+import { acquire } from "./keepalive.js";
+import { runLoop } from "./loop.js";
+import { notifyComplete, notifyError } from "./notify.js";
+import { sleep } from "./pacing.js";
+import { bold, dim, greenOut, boldOut, dimOut, SYM_OUT, USE_COLOR, } from "./stream-render.js";
+/** Count open issues carrying `label`, via gh. Returns 0 on any failure (keep polling). */
+export function openIssueCount(label, cwd) {
+    try {
+        // execFileSync (no shell) so `label` is passed as a literal argv entry — a
+        // value like `$(rm -rf ~)` can never be shell-evaluated. See SECURITY.md.
+        const out = execFileSync("gh", [
+            "issue",
+            "list",
+            "--state",
+            "open",
+            "--label",
+            label,
+            "--json",
+            "number",
+        ], { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+        const arr = JSON.parse(out);
+        return Array.isArray(arr) ? arr.length : 0;
+    }
+    catch {
+        process.stderr.write(`${dim(`gh issue poll failed (label ${label}) — treating as no work`)}\n`);
+        return 0;
+    }
+}
+export async function runWatch(opts) {
+    const { stages, iterations, workspaceDir, packageDir, watchIntervalSec, watchLabel, budgetUsd, cooldownMs, maxRetries, reviewLenses, notify = false, bin = "otto-ghafk", countIssues = openIssueCount, } = opts;
+    const releaser = acquire({ reason: `${bin} watch` });
+    let released = false;
+    const releaseOnce = () => {
+        if (!released) {
+            released = true;
+            releaser.release();
+        }
+    };
+    const daemonAbort = new AbortController();
+    const onSig = (code) => () => {
+        daemonAbort.abort();
+        if (notify)
+            notifyError(`watch stopped (signal)`);
+        releaseOnce();
+        process.exit(code);
+    };
+    const onSigint = onSig(130);
+    const onSigterm = onSig(143);
+    process.on("SIGINT", onSigint);
+    process.on("SIGTERM", onSigterm);
+    process.stderr.write(`${USE_COLOR ? dim("watching") + " " + bold(`label:${watchLabel} every ${watchIntervalSec}s`) : `watching label:${watchLabel} every ${watchIntervalSec}s`}\n`);
+    let cumulativeCost = 0;
+    try {
+        for (;;) {
+            if (budgetUsd != null && cumulativeCost >= budgetUsd) {
+                process.stdout.write(`${greenOut(SYM_OUT.bullet)} ${boldOut("watch budget reached")}${dimOut(` $${cumulativeCost.toFixed(2)} ≥ $${budgetUsd.toFixed(2)} — stopping`)}\n`);
+                if (notify)
+                    notifyComplete(0, false);
+                return;
+            }
+            const count = countIssues(watchLabel, workspaceDir);
+            if (count > 0) {
+                process.stderr.write(`${dim(`${count} open issue(s) labelled ${watchLabel} — running loop`)}\n`);
+                const remaining = budgetUsd != null ? budgetUsd - cumulativeCost : undefined;
+                const outcome = await runLoop({
+                    stages,
+                    inputs: "",
+                    iterations,
+                    workspaceDir,
+                    packageDir,
+                    budgetUsd: remaining,
+                    cooldownMs,
+                    maxRetries,
+                    reviewLenses,
+                    noKeepAlive: true,
+                    signal: daemonAbort.signal,
+                    bin,
+                    cliVersion: opts.cliVersion,
+                });
+                cumulativeCost += outcome.costUsd;
+                process.stderr.write(`${dim(`watch run done — cumulative $${cumulativeCost.toFixed(2)}`)}\n`);
+            }
+            await sleep(watchIntervalSec * 1000, daemonAbort.signal);
+        }
+    }
+    finally {
+        process.off("SIGINT", onSigint);
+        process.off("SIGTERM", onSigterm);
+        releaseOnce();
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@phamvuhoang/otto-core",
+  "version": "0.1.0",
+  "description": "Claude Code AFK orchestration: iteration loop, native-sandbox runner, template renderer.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Henry Pham <phamvuhoang@gmail.com>",
+  "homepage": "https://github.com/phamvuhoang/otto/tree/main/packages/core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phamvuhoang/otto.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/phamvuhoang/otto/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "ai-agent",
+    "afk",
+    "automation",
+    "code-review",
+    "orchestration"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./loop": {
+      "types": "./dist/loop.d.ts",
+      "import": "./dist/loop.js"
+    },
+    "./runner": {
+      "types": "./dist/runner.d.ts",
+      "import": "./dist/runner.js"
+    },
+    "./stages": {
+      "types": "./dist/stages.d.ts",
+      "import": "./dist/stages.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "node -e \"const fs=require('node:fs');fs.rmSync('dist',{recursive:true,force:true});fs.rmSync('tsconfig.tsbuildinfo',{force:true})\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "pnpm run clean && pnpm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.7"
+  }
+}