@phamvuhoang/otto-core 0.1.0

package/dist/cli-help.js

@@ -0,0 +1,365 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { DEFAULT_MAX_RETRIES } from "./retry.js";
+/** Parse a duration: bare integer = seconds; suffix s/m/h supported. Throws on invalid. */
+export function parseDurationMs(raw) {
+    const m = raw.trim().match(/^(\d+)(s|m|h)?$/);
+    if (!m) {
+        throw new Error(`--max-wait must be seconds or a duration like 90m / 6h, got: ${JSON.stringify(raw)}`);
+    }
+    const n = Number.parseInt(m[1], 10);
+    const unit = m[2] ?? "s";
+    const factor = unit === "h" ? 3600_000 : unit === "m" ? 60_000 : 1000;
+    return n * factor;
+}
+/**
+ * Normalize a user-supplied issue reference to a positive integer.
+ * Accepts: `42`, `#42`, `owner/repo#42`, and GitHub issue URLs
+ * (`https://github.com/owner/repo/issues/42[#anchor]`). A repo component is
+ * ignored — only the number is used (gh resolves the repo from the workspace).
+ * Throws on anything that is not a positive integer.
+ *
+ * SECURITY: the returned integer is the ONLY part of the ref that may reach a
+ * shell (via the OTTO_ISSUE env var read by a static template command). Never
+ * pass the raw ref to a shell. See render.ts security invariant.
+ */
+export function parseIssueRef(raw) {
+    const s = raw.trim();
+    let token = s;
+    const urlMatch = s.match(/\/issues\/(\d+)(?:[#?].*)?$/);
+    if (urlMatch) {
+        token = urlMatch[1];
+    }
+    else if (s.includes("#")) {
+        token = s.slice(s.lastIndexOf("#") + 1);
+    }
+    if (!/^[1-9]\d*$/.test(token)) {
+        throw new Error(`--issue must be a positive issue number, #N, owner/repo#N, or a GitHub issue URL, got: ${JSON.stringify(raw)}`);
+    }
+    const n = Number.parseInt(token, 10);
+    if (!Number.isSafeInteger(n)) {
+        throw new Error(`--issue number is too large, got: ${JSON.stringify(raw)}`);
+    }
+    return n;
+}
+export function parseFlags(argv) {
+    let help = false;
+    let version = false;
+    let printConfig = false;
+    let noKeepAlive = false;
+    let maxRetries;
+    let expectingMaxRetries = false;
+    let detach = false;
+    let log;
+    let expectingLog = false;
+    let notify = false;
+    let budget;
+    let expectingBudget = false;
+    let cooldownMs;
+    let expectingCooldown = false;
+    let reviewPanel = false;
+    let watch = false;
+    let watchIntervalSec;
+    let expectingWatchInterval = false;
+    let issue;
+    let expectingIssue = false;
+    let maxWaitMs;
+    let expectingMaxWait = false;
+    let fresh = false;
+    let verify = false;
+    let applyReview;
+    let expectingApplyReview = false;
+    let branch;
+    let expectingBranch = false;
+    let branchPrefix;
+    let expectingBranchPrefix = false;
+    const rest = [];
+    for (const a of argv) {
+        if (expectingMaxRetries) {
+            if (!/^\d+$/.test(a)) {
+                throw new Error(`--max-retries must be a non-negative integer, got: ${JSON.stringify(a)}`);
+            }
+            maxRetries = Number.parseInt(a, 10);
+            expectingMaxRetries = false;
+            continue;
+        }
+        if (expectingLog) {
+            log = a;
+            expectingLog = false;
+            continue;
+        }
+        if (expectingBudget) {
+            const n = Number(a);
+            if (!Number.isFinite(n) || n <= 0) {
+                throw new Error(`--budget must be a positive number, got: ${JSON.stringify(a)}`);
+            }
+            budget = n;
+            expectingBudget = false;
+            continue;
+        }
+        if (expectingCooldown) {
+            if (!/^\d+$/.test(a)) {
+                throw new Error(`--cooldown must be a non-negative integer (ms), got: ${JSON.stringify(a)}`);
+            }
+            cooldownMs = Number.parseInt(a, 10);
+            expectingCooldown = false;
+            continue;
+        }
+        if (expectingWatchInterval) {
+            if (!/^\d+$/.test(a) || Number.parseInt(a, 10) <= 0) {
+                throw new Error(`--watch-interval must be a positive integer (seconds), got: ${JSON.stringify(a)}`);
+            }
+            watchIntervalSec = Number.parseInt(a, 10);
+            expectingWatchInterval = false;
+            continue;
+        }
+        if (expectingIssue) {
+            issue = parseIssueRef(a);
+            expectingIssue = false;
+            continue;
+        }
+        if (expectingMaxWait) {
+            maxWaitMs = parseDurationMs(a);
+            expectingMaxWait = false;
+            continue;
+        }
+        if (expectingApplyReview) {
+            applyReview = a;
+            expectingApplyReview = false;
+            continue;
+        }
+        if (expectingBranch) {
+            if (a !== "current" && a !== "branch" && a !== "worktree") {
+                throw new Error(`--branch must be one of current|branch|worktree, got: ${JSON.stringify(a)}`);
+            }
+            branch = a;
+            expectingBranch = false;
+            continue;
+        }
+        if (expectingBranchPrefix) {
+            branchPrefix = a;
+            expectingBranchPrefix = false;
+            continue;
+        }
+        if (a === "-h" || a === "--help")
+            help = true;
+        else if (a === "-V" || a === "--version")
+            version = true;
+        else if (a === "--print-config")
+            printConfig = true;
+        else if (a === "--no-keep-alive")
+            noKeepAlive = true;
+        else if (a === "--max-retries")
+            expectingMaxRetries = true;
+        else if (a === "--detach")
+            detach = true;
+        else if (a === "--log")
+            expectingLog = true;
+        else if (a === "--notify")
+            notify = true;
+        else if (a === "--budget")
+            expectingBudget = true;
+        else if (a === "--cooldown")
+            expectingCooldown = true;
+        else if (a === "--review-panel")
+            reviewPanel = true;
+        else if (a === "--watch")
+            watch = true;
+        else if (a === "--watch-interval")
+            expectingWatchInterval = true;
+        else if (a === "--issue")
+            expectingIssue = true;
+        else if (a === "--max-wait")
+            expectingMaxWait = true;
+        else if (a === "--fresh")
+            fresh = true;
+        else if (a === "--verify")
+            verify = true;
+        else if (a === "--apply-review")
+            expectingApplyReview = true;
+        else if (a === "--branch")
+            expectingBranch = true;
+        else if (a === "--branch-prefix")
+            expectingBranchPrefix = true;
+        else
+            rest.push(a);
+    }
+    if (expectingMaxRetries) {
+        throw new Error("--max-retries requires a value");
+    }
+    if (expectingLog) {
+        throw new Error("--log requires a value");
+    }
+    if (expectingBudget) {
+        throw new Error("--budget requires a value");
+    }
+    if (expectingCooldown) {
+        throw new Error("--cooldown requires a value");
+    }
+    if (expectingWatchInterval) {
+        throw new Error("--watch-interval requires a value");
+    }
+    if (expectingIssue) {
+        throw new Error("--issue requires a value");
+    }
+    if (expectingMaxWait) {
+        throw new Error("--max-wait requires a value");
+    }
+    if (expectingApplyReview) {
+        throw new Error("--apply-review requires a value");
+    }
+    if (expectingBranch) {
+        throw new Error("--branch requires a value");
+    }
+    if (expectingBranchPrefix) {
+        throw new Error("--branch-prefix requires a value");
+    }
+    if (log !== undefined && !detach) {
+        throw new Error("--log is only meaningful with --detach");
+    }
+    return {
+        help,
+        version,
+        printConfig,
+        noKeepAlive,
+        maxRetries,
+        detach,
+        log,
+        notify,
+        budget,
+        cooldownMs,
+        reviewPanel,
+        watch,
+        watchIntervalSec,
+        issue,
+        maxWaitMs,
+        fresh,
+        verify,
+        applyReview,
+        branch,
+        branchPrefix,
+        rest,
+    };
+}
+/**
+ * Resolve the @phamvuhoang/otto-core version by reading the package.json that
+ * sits two levels up from the compiled cli-help.js (packages/core/dist/ →
+ * packages/core/package.json). Returns "?" if unreadable so version reporting
+ * never crashes the bin.
+ */
+export function readCoreVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkgPath = join(here, "..", "package.json");
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        return pkg.version ?? "?";
+    }
+    catch {
+        return "?";
+    }
+}
+export function printVersion(bin, cliVersion) {
+    const core = readCoreVersion();
+    const cli = cliVersion ?? "?";
+    process.stdout.write(`${bin} ${cli} (core ${core})\n`);
+}
+export function printHelp(bin, usage, description) {
+    process.stdout.write(`${bin} — ${description}
+
+Usage:
+  ${bin} ${usage}
+  ${bin} --help | -h
+  ${bin} --version | -V
+  ${bin} --print-config [args...]
+
+Flags:
+  -h, --help          show this help and exit
+  -V, --version       print bin + core version and exit
+  --print-config      resolve workspace / runner / sandbox config, print, and exit
+  --no-keep-alive     skip OS wake-lock acquisition (default: acquire system-sleep inhibitor for loop lifetime)
+  --max-retries <N>   per-stage retry budget on transient failure (default: 3; 0 disables retries)
+  --detach            fork the loop into a background process, print pid + log path, and exit (parent returns 0)
+  --log <path>        override the detached log path (default: <workspace>/.otto-tmp/logs/detached-<parent-pid>.log; requires --detach)
+  --notify            emit OS notification + terminal bell on loop completion or unrecoverable failure (default: off)
+  --budget <usd>      stop the loop when cumulative stage cost reaches this USD ceiling (default: off)
+  --cooldown <ms>     wait this many milliseconds between iterations; adaptive backoff doubles on throttle (default: 0)
+  --review-panel      replace the single reviewer stage with correctness/security/tests lens reviewers + one synth commit (default: off)
+  --branch <mode>     where Otto commits: current (default) | branch (new branch) | worktree (isolated checkout)
+  --branch-prefix <p> branch name prefix for branch/worktree modes (default: otto/)
+  --watch             poll for labelled GitHub issues and run the loop whenever work is found (ghafk-only; default: off)
+  --watch-interval <sec>  seconds between polls in watch mode (default: 300)
+  --issue <ref>       target a single GitHub issue (number, #N, owner/repo#N, or issue URL); loop exits when it is done (ghafk-only; default: off)
+  --max-wait <dur>    cap the wait when rate-limited before halting (e.g. 90m, 6h; default 6h)
+  --fresh             ignore any saved resume state and start from iteration 1
+  --verify            read-only: reconcile the plan against git, run the suites, write a report; make no commits (otto-afk)
+  --apply-review <doc>  fix the actionable findings of a code-review document; track follow-ups (otto-afk)
+
+Environment variables:
+  OTTO_WORKSPACE   host dir Claude runs against (default: cwd)
+  OTTO_RUNNER      "sandbox" (default) runs claude in the native OS sandbox with
+                    writes confined to the workspace; "host" runs claude unsandboxed
+                    (bare while-loop — only safe in a throwaway tree).
+  OTTO_SANDBOX_NET comma-separated domain allowlist for sandbox network egress.
+                    Unset = unrestricted (filesystem is the blast-radius control).
+  OTTO_MODEL       pin the claude model ("--model <value>" pass-through). Unset =
+                    claude CLI default. The claude CLI validates the value.
+  OTTO_RESULT_GRACE_MS  post-result grace timer ms (default 30000; 0 disables).
+  OTTO_REVIEW_LENSES   comma-separated lens list for --review-panel (default: correctness,security,tests).
+  OTTO_WATCH_LABEL     issue label to poll for in watch mode (default: "otto").
+  OTTO_MAX_WAIT        default rate-limit wait cap (seconds or 90m/6h; default 6h).
+  OTTO_BRANCH          default branch strategy (current|branch|worktree) when --branch is absent.
+  OTTO_BRANCH_PREFIX   default branch-name prefix (default: "otto/").
+`);
+}
+export function printConfig(bin, workspaceDir, packageDir, opts = {}) {
+    const { cliVersion, noKeepAlive = false, maxRetries = DEFAULT_MAX_RETRIES, detach = false, detachLogPath, notify = false, budget, cooldownMs, reviewLenses = [], watch = false, watchIntervalSec, issue, maxWaitMs, mode, branchStrategy, branchPrefix, } = opts;
+    const core = readCoreVersion();
+    const cli = cliVersion ?? "?";
+    const runner = process.env.OTTO_RUNNER?.trim() === "host" ? "host" : "sandbox";
+    const rawNet = process.env.OTTO_SANDBOX_NET?.trim();
+    const netStatus = runner === "host"
+        ? "n/a (host runner)"
+        : rawNet
+            ? `restricted to: ${rawNet}`
+            : "unrestricted (filesystem-only sandbox)";
+    const keepAliveStatus = noKeepAlive ? "off" : "on (system sleep only)";
+    const detachStatus = detach && detachLogPath ? `on (log: ${detachLogPath})` : "off";
+    const notifyStatus = notify ? "on" : "off";
+    const rawModel = process.env.OTTO_MODEL;
+    const modelStatus = rawModel && rawModel.trim() !== ""
+        ? `${rawModel.trim()} (OTTO_MODEL)`
+        : "claude CLI default (OTTO_MODEL unset)";
+    const budgetStatus = budget != null ? `$${budget.toFixed(2)}` : "off";
+    const cooldownStatus = cooldownMs ? `${cooldownMs}ms` : "off";
+    const reviewStatus = reviewLenses.length
+        ? `panel: ${reviewLenses.join(", ")}`
+        : "single reviewer";
+    const watchLabel = process.env.OTTO_WATCH_LABEL?.trim() || "otto";
+    const watchStatus = watch
+        ? `on (every ${watchIntervalSec ?? 300}s, label "${watchLabel}")`
+        : "off";
+    const issueStatus = issue != null ? `#${issue}` : "off";
+    const branchStatus = `${branchStrategy ?? "current"} (prefix "${branchPrefix ?? "otto/"}")`;
+    process.stdout.write(`[${bin}] resolved config
+  version               ${bin} ${cli} (core ${core})
+  mode                  ${mode ?? "afk"}
+  OTTO_WORKSPACE       ${workspaceDir}${process.env.OTTO_WORKSPACE ? "" : "  (default: cwd)"}
+  packageDir            ${packageDir}
+  OTTO_RUNNER          ${runner}${process.env.OTTO_RUNNER ? "" : "  (default)"}
+  sandbox network       ${netStatus}
+  model                 ${modelStatus}
+  keep-alive            ${keepAliveStatus}
+  max-retries           ${maxRetries}
+  detach                ${detachStatus}
+  notify                ${notifyStatus}
+  budget                ${budgetStatus}
+  cooldown              ${cooldownStatus}
+  max-wait              ${maxWaitMs != null ? `${Math.round(maxWaitMs / 60000)}m` : "6h (default)"}
+  review                ${reviewStatus}
+  branch                ${branchStatus}
+  watch                 ${watchStatus}
+  issue                 ${issueStatus}
+`);
+}
+//# sourceMappingURL=cli-help.js.map

package/dist/cli-help.js.map

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

package/dist/detach.d.ts

@@ -0,0 +1,36 @@
+import { type ChildProcess } from "node:child_process";
+export type DetachedChild = Pick<ChildProcess, "pid" | "unref">;
+export type DetachSpawner = (command: string, args: readonly string[], options: {
+    detached: boolean;
+    stdio: readonly ["ignore", number, number];
+    windowsHide: boolean;
+}) => DetachedChild;
+export type DetachOptions = {
+    /** Absolute path to the log file. stdout + stderr of the child are appended here. */
+    logPath: string;
+    /** The full original argv (from process.argv.slice(2)). --detach and --log are stripped before re-spawn. */
+    argv: string[];
+    /** Path to the bin script the child should run (typically process.argv[1]). */
+    binEntry: string;
+    execPath?: string;
+    spawnFn?: DetachSpawner;
+    openFd?: (path: string) => number;
+    ensureDir?: (path: string) => void;
+    stderr?: {
+        write: (s: string) => void;
+    };
+    exit?: (code?: number) => never;
+};
+/**
+ * Strip `--detach` and `--log <value>` from an argv array so the re-spawned
+ * child does not fork again and does not re-interpret the log target.
+ */
+export declare function stripDetachFlags(argv: readonly string[]): string[];
+/**
+ * Fork the current bin into the background, redirect its stdio to `logPath`,
+ * print `detached pid <pid>, log <path>` on stderr, and exit the parent with
+ * code 0. The re-spawned child receives the original argv minus --detach /
+ * --log so it cannot fork again.
+ */
+export declare function detachAndExit(opts: DetachOptions): never;
+//# sourceMappingURL=detach.d.ts.map

package/dist/detach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../src/detach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAI9D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC;AAEhE,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IACP,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,WAAW,EAAE,OAAO,CAAC;CACtB,KACE,aAAa,CAAC;AAEnB,MAAM,MAAM,aAAa,GAAG;IAC1B,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,4GAA4G;IAC5G,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,KAAK,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAYlE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,KAAK,CA8BxD"}

package/dist/detach.js

@@ -0,0 +1,52 @@
+import { spawn } from "node:child_process";
+import { mkdirSync, openSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * Strip `--detach` and `--log <value>` from an argv array so the re-spawned
+ * child does not fork again and does not re-interpret the log target.
+ */
+export function stripDetachFlags(argv) {
+    const out = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--detach")
+            continue;
+        if (a === "--log") {
+            i++; // also skip the value
+            continue;
+        }
+        out.push(a);
+    }
+    return out;
+}
+/**
+ * Fork the current bin into the background, redirect its stdio to `logPath`,
+ * print `detached pid <pid>, log <path>` on stderr, and exit the parent with
+ * code 0. The re-spawned child receives the original argv minus --detach /
+ * --log so it cannot fork again.
+ */
+export function detachAndExit(opts) {
+    const execPath = opts.execPath ?? process.execPath;
+    const spawnFn = opts.spawnFn ??
+        ((cmd, args, options) => spawn(cmd, args, {
+            detached: options.detached,
+            stdio: options.stdio,
+            windowsHide: options.windowsHide,
+        }));
+    const openFd = opts.openFd ?? ((p) => openSync(p, "a"));
+    const ensureDir = opts.ensureDir ?? ((p) => mkdirSync(p, { recursive: true }));
+    const stderr = opts.stderr ?? process.stderr;
+    const exit = opts.exit ?? ((code) => process.exit(code));
+    ensureDir(dirname(opts.logPath));
+    const logFd = openFd(opts.logPath);
+    const childArgv = stripDetachFlags(opts.argv);
+    const child = spawnFn(execPath, [opts.binEntry, ...childArgv], {
+        detached: true,
+        stdio: ["ignore", logFd, logFd],
+        windowsHide: true,
+    });
+    child.unref();
+    stderr.write(`detached pid ${child.pid}, log ${opts.logPath}\n`);
+    exit(0);
+}
+//# sourceMappingURL=detach.js.map

package/dist/detach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detach.js","sourceRoot":"","sources":["../src/detach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BpC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,UAAU;YAAE,SAAS;QAC/B,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YAClB,CAAC,EAAE,CAAC,CAAC,sBAAsB;YAC3B,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAmB;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,MAAM,OAAO,GACX,IAAI,CAAC,OAAO;QACZ,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CACtB,KAAK,CAAC,GAAG,EAAE,IAAgB,EAAE;YAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAmC;YAClD,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC,CAAC;IACR,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,SAAS,GACb,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEnC,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,EAAE;QAC7D,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAU;QACxC,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,CAAC,GAAG,SAAS,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACjE,IAAI,CAAC,CAAC,CAAC,CAAC;AACV,CAAC"}

package/dist/gh-main.d.ts

@@ -0,0 +1,5 @@
+export type RunGhAfkOptions = {
+    cliVersion?: string;
+};
+export declare function runGhAfk(argv: string[], opts?: RunGhAfkOptions): Promise<void>;
+//# sourceMappingURL=gh-main.d.ts.map

package/dist/gh-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh-main.d.ts","sourceRoot":"","sources":["../src/gh-main.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,eAAe,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/gh-main.js

@@ -0,0 +1,16 @@
+import { runBin } from "./run-bin.js";
+import { STAGES } from "./stages.js";
+export async function runGhAfk(argv, opts = {}) {
+    await runBin(argv, {
+        bin: "otto-ghafk",
+        usage: "<iterations>",
+        desc: "GitHub-issue-driven Claude Code AFK loop",
+        stages: [STAGES.ghafkImplementer, STAGES.reviewer],
+        takesInputArg: false,
+        cliVersion: opts.cliVersion,
+        supportsWatch: true,
+        issueStage: STAGES.ghafkIssueImplementer,
+        mode: "ghafk",
+    });
+}
+//# sourceMappingURL=gh-main.js.map

package/dist/gh-main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh-main.js","sourceRoot":"","sources":["../src/gh-main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAc,EACd,OAAwB,EAAE;IAE1B,MAAM,MAAM,CAAC,IAAI,EAAE;QACjB,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,cAAc;QACrB,IAAI,EAAE,0CAA0C;QAChD,MAAM,EAAE,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,QAAQ,CAAC;QAClD,aAAa,EAAE,KAAK;QACpB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,MAAM,CAAC,qBAAqB;QACxC,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/git.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Run git with literal args (no shell — args never interpolate runtime data).
+ * Returns trimmed stdout, or null on any non-zero exit / missing repo.
+ */
+export declare function git(args: string[], cwd: string): string | null;
+/** True if `cwd` is inside a git work tree. */
+export declare function isGitRepo(cwd: string): boolean;
+/** True if any TRACKED file has uncommitted changes (untracked files ignored). */
+export declare function hasUncommittedTrackedChanges(cwd: string): boolean;
+/** True if `relPath` is gitignored in `cwd`. */
+export declare function isPathIgnored(cwd: string, relPath: string): boolean;
+/** True if a local branch/ref named `name` already exists. */
+export declare function refExists(cwd: string, name: string): boolean;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU9D;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,kFAAkF;AAClF,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAUnE;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAW5D"}

package/dist/git.js

@@ -0,0 +1,50 @@
+import { execFileSync } from "node:child_process";
+/**
+ * Run git with literal args (no shell — args never interpolate runtime data).
+ * Returns trimmed stdout, or null on any non-zero exit / missing repo.
+ */
+export function git(args, cwd) {
+    try {
+        return execFileSync("git", args, {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** True if `cwd` is inside a git work tree. */
+export function isGitRepo(cwd) {
+    return git(["rev-parse", "--is-inside-work-tree"], cwd) === "true";
+}
+/** True if any TRACKED file has uncommitted changes (untracked files ignored). */
+export function hasUncommittedTrackedChanges(cwd) {
+    const s = git(["status", "--porcelain", "--untracked-files=no"], cwd);
+    return s != null && s !== "";
+}
+/** True if `relPath` is gitignored in `cwd`. */
+export function isPathIgnored(cwd, relPath) {
+    try {
+        execFileSync("git", ["check-ignore", "-q", relPath], {
+            cwd,
+            stdio: "ignore",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** True if a local branch/ref named `name` already exists. */
+export function refExists(cwd, name) {
+    try {
+        execFileSync("git", ["rev-parse", "--verify", "--quiet", `refs/heads/${name}`], { cwd, stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,IAAc,EAAE,GAAW;IAC7C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;YAC/B,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC;AACrE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,4BAA4B,CAAC,GAAW;IACtD,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,sBAAsB,CAAC,EAAE,GAAG,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,OAAe;IACxD,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,cAAc,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;YACnD,GAAG;YACH,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAY;IACjD,IAAI,CAAC;QACH,YAAY,CACV,KAAK,EACL,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,IAAI,EAAE,CAAC,EAC1D,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CACzB,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { runAfk } from "./main.js";
+export { runGhAfk } from "./gh-main.js";
+export { runLoop, type LoopOptions, type LoopOutcome } from "./loop.js";
+export { STAGES, type Stage } from "./stages.js";
+export { renderTemplate, type RenderOptions, type RenderVars, } from "./render.js";
+export { runStage, type StageResult } from "./runner.js";
+export { runWatch, type RunWatchOptions } from "./watch.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { runAfk } from "./main.js";
+export { runGhAfk } from "./gh-main.js";
+export { runLoop } from "./loop.js";
+export { STAGES } from "./stages.js";
+export { renderTemplate, } from "./render.js";
+export { runStage } from "./runner.js";
+export { runWatch } from "./watch.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,OAAO,EAAsC,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,MAAM,EAAc,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,cAAc,GAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAwB,MAAM,YAAY,CAAC"}

package/dist/keepalive.d.ts

@@ -0,0 +1,24 @@
+import { type ChildProcess } from "node:child_process";
+export type SpawnedChild = Pick<ChildProcess, "kill" | "on" | "pid">;
+export type Spawner = (command: string, args: readonly string[], options: {
+    detached?: boolean;
+    stdio?: "ignore";
+}) => SpawnedChild;
+export type AcquireOptions = {
+    reason?: string;
+    spawner?: Spawner;
+    platform?: NodeJS.Platform;
+    parentPid?: number;
+    wslHint?: () => boolean;
+    warn?: (msg: string) => void;
+};
+export type Releaser = {
+    release: () => void;
+};
+/**
+ * Acquire an OS wake-lock for the lifetime of the returned Releaser. Platform
+ * dispatch is per-OS; missing utilities degrade to a no-op (warning emitted
+ * once) so the loop never crashes on a stripped image.
+ */
+export declare function acquire(opts?: AcquireOptions): Releaser;
+//# sourceMappingURL=keepalive.d.ts.map

package/dist/keepalive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keepalive.d.ts","sourceRoot":"","sources":["../src/keepalive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG9D,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC;AAErE,MAAM,MAAM,OAAO,GAAG,CACpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,KAC9C,YAAY,CAAC;AAElB,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAqEF;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,GAAE,cAAmB,GAAG,QAAQ,CA2E3D"}