okstra 0.174.0 → 0.176.0

package/dist/commands/execute/wizard.mjs

@@ -0,0 +1,191 @@
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { runPythonModule } from "../../lib/python-helper.mjs";
+import { resolvePaths } from "../../lib/paths.mjs";
+const USAGE = `okstra wizard — interactive okstra-run input collector
+
+Used by the okstra-run skill to drive the per-step prompt loop. Each
+subcommand round-trips a JSON state file held by the skill.
+
+Subcommands:
+  new-state-file  print a fresh absolute state-file path on stdout (no I/O on the file itself)
+  init            seed a fresh wizard state and emit the first prompt
+  step            submit an answer (or fetch the current prompt) and emit next
+  render-args     emit the final --flag/value map for 'okstra render-bundle'
+  confirmation    emit the multi-line confirmation echo block
+  outcome         emit render args, persistence actions, and confirmation text
+
+Usage:
+  okstra wizard new-state-file
+  okstra wizard init --state-file <path> --project-root <p> --project-id <id> --host-runtime <runtime> \\
+    --entry-mode current-session --available-function <semantic-name>
+  okstra wizard step --state-file <path> (--answer <value> | --no-submit)
+  okstra wizard render-args --state-file <path>
+  okstra wizard confirmation --state-file <path>
+  okstra wizard outcome --state-file <path>
+
+'init' auto-fills --workspace-root from 'okstra paths --field workspace',
+so callers do not pass it.
+
+All subcommands emit a single JSON object on stdout. On validation failure
+'step' returns {ok:false, error, current} so the skill can re-prompt.
+`;
+// Only the flags listed here are boolean; every other wizard flag takes a
+// value, so the token after it is always its value — even free-text answers
+// that begin with "--". A heuristic that rejects "--"-prefixed values would
+// make legitimate directive/base-ref answers unsubmittable. The inline
+// "--key=value" form lets callers pass any value (including empty)
+// unambiguously.
+const BOOLEAN_FLAGS = new Set(["no-submit"]);
+function stringFlag(flags, key) {
+    const value = flags[key];
+    return typeof value === "string" ? value : undefined;
+}
+function stringListFlag(flags, key) {
+    const value = flags[key];
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+export function parseFlags(args) {
+    const out = {};
+    const setFlag = (key, value) => {
+        if (key === "available-function") {
+            const current = out[key];
+            out[key] = Array.isArray(current) ? [...current, value] : [value];
+            return;
+        }
+        out[key] = value;
+    };
+    for (let i = 0; i < args.length; i += 1) {
+        const a = args[i];
+        if (a === undefined)
+            continue;
+        if (!a.startsWith("--")) {
+            throw new Error(`unexpected positional argument: ${a}`);
+        }
+        const eq = a.indexOf("=");
+        if (eq !== -1) {
+            setFlag(a.slice(2, eq), a.slice(eq + 1));
+            continue;
+        }
+        const key = a.slice(2);
+        if (BOOLEAN_FLAGS.has(key)) {
+            out[key] = true;
+            continue;
+        }
+        if (i + 1 >= args.length) {
+            throw new Error(`flag --${key} requires a value`);
+        }
+        const value = args[i + 1];
+        if (value === undefined)
+            throw new Error(`flag --${key} requires a value`);
+        setFlag(key, value);
+        i += 1;
+    }
+    return out;
+}
+export function buildPythonArgs(sub, flags, workspaceRoot = "") {
+    const stateFile = stringFlag(flags, "state-file");
+    if (!stateFile)
+        throw new Error("--state-file is required");
+    const pyArgs = [sub, "--state-file", stateFile];
+    if (sub === "init") {
+        pyArgs.push("--workspace-root", workspaceRoot);
+        const projectRoot = stringFlag(flags, "project-root");
+        const projectId = stringFlag(flags, "project-id");
+        if (!projectRoot || !projectId) {
+            throw new Error("init requires --project-root and --project-id");
+        }
+        pyArgs.push("--project-root", projectRoot);
+        pyArgs.push("--project-id", projectId);
+        const hostRuntime = stringFlag(flags, "host-runtime");
+        if (hostRuntime) {
+            pyArgs.push("--host-runtime", hostRuntime);
+        }
+        for (const value of stringListFlag(flags, "available-function")) {
+            pyArgs.push("--available-function", value);
+        }
+        pyArgs.push("--entry-mode", stringFlag(flags, "entry-mode") ?? "current-session");
+    }
+    else if (sub === "step") {
+        if (flags["no-submit"]) {
+            pyArgs.push("--no-submit");
+        }
+        const answer = stringFlag(flags, "answer");
+        if (answer !== undefined) {
+            pyArgs.push("--answer", answer);
+        }
+    }
+    return pyArgs;
+}
+export function orderedRenderArgv(renderArgs) {
+    const argv = [];
+    for (const [name, rawValue] of Object.entries(renderArgs)) {
+        const values = Array.isArray(rawValue) ? rawValue : [rawValue];
+        for (const value of values) {
+            if (typeof value !== "string") {
+                throw new TypeError(`wizard render arg --${name} must be a string`);
+            }
+            argv.push(`--${name}`, value);
+        }
+    }
+    return argv;
+}
+export async function run(args) {
+    if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(USAGE);
+        return args.length === 0 ? 2 : 0;
+    }
+    const sub = args[0];
+    const rest = args.slice(1);
+    if (sub === undefined)
+        return 2;
+    if (!["new-state-file", "init", "step", "render-args", "confirmation", "outcome"].includes(sub)) {
+        process.stderr.write(`error: unknown wizard subcommand '${sub}'\n\n${USAGE}`);
+        return 2;
+    }
+    if (sub === "new-state-file") {
+        if (rest.length > 0) {
+            process.stderr.write("error: new-state-file takes no arguments\n");
+            return 2;
+        }
+        const dir = mkdtempSync(join(tmpdir(), "okstra-wizard-"));
+        process.stdout.write(join(dir, "state.json") + "\n");
+        return 0;
+    }
+    let flags;
+    try {
+        flags = parseFlags(rest);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`error: ${message}\n\n${USAGE}`);
+        return 2;
+    }
+    if (!flags["state-file"]) {
+        process.stderr.write("error: --state-file is required\n");
+        return 2;
+    }
+    let workspaceRoot = "";
+    if (sub === "init") {
+        if (!flags["project-root"] || !flags["project-id"]) {
+            process.stderr.write("error: init requires --project-root and --project-id\n");
+            return 2;
+        }
+        const paths = await resolvePaths();
+        workspaceRoot = paths.workspace;
+    }
+    const pyArgs = buildPythonArgs(sub, flags, workspaceRoot);
+    const result = await runPythonModule({
+        module: "okstra_ctl.wizard",
+        args: pyArgs,
+        stdio: "capture",
+    });
+    if (result.code !== 0 && !result.stdout.trim()) {
+        process.stdout.write(JSON.stringify({ ok: false, stage: "python", reason: result.stderr.trim() || "no output" }, null, 2) + "\n");
+        return 1;
+    }
+    process.stdout.write(result.stdout);
+    return result.code === 0 ? 0 : result.code;
+}
+//# sourceMappingURL=wizard.mjs.map

package/dist/commands/execute/wizard.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.mjs","sourceRoot":"","sources":["../../../src/commands/execute/wizard.mts"],"names":[],"mappings":"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"}

package/dist/commands/execute/worker-audit-check.d.mts

@@ -0,0 +1 @@
+export declare function run(args: readonly string[]): Promise<number>;

package/{src → dist}/commands/execute/worker-audit-check.mjs

@@ -1,5 +1,4 @@
 import { runPythonModule } from "../../lib/python-helper.mjs";
-
 const USAGE = `okstra worker-audit-check — check one run's worker audit sidecars
 
 Usage:
@@ -20,16 +19,16 @@ has a matching Evidence read row in that sidecar.
 Call it right after collecting a worker result. The same failure at Phase 7
 leaves only a retroactive edit — which breaks the audit chain — or a failed run.
 `;
-
 export async function run(args) {
-  if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(USAGE);
-    return args.length === 0 ? 2 : 0;
-  }
-  const result = await runPythonModule({
-    module: "okstra_ctl.worker_audit_check",
-    args,
-    stdio: "inherit-stdout",
-  });
-  return result.code;
+    if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(USAGE);
+        return args.length === 0 ? 2 : 0;
+    }
+    const result = await runPythonModule({
+        module: "okstra_ctl.worker_audit_check",
+        args,
+        stdio: "inherit-stdout",
+    });
+    return result.code;
 }
+//# sourceMappingURL=worker-audit-check.mjs.map

package/dist/commands/execute/worker-audit-check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-audit-check.mjs","sourceRoot":"","sources":["../../../src/commands/execute/worker-audit-check.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;CAmBb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,MAAM,EAAE,+BAA+B;QACvC,IAAI;QACJ,KAAK,EAAE,gBAAgB;KACxB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/commands/execute/worker-dispatch.d.mts

@@ -0,0 +1,7 @@
+import type { CliArgs, RuntimePaths } from "../../lib/types.mjs";
+export declare const USAGE = "okstra worker-dispatch \u2014 dispatch verified CLI-backed workers\n\nUsage:\n  okstra worker-dispatch --project-root <dir> --run-manifest <path> \\\n    [--workers <cli-assigned-worker-ids>] [--dry-run] \\\n    [--idle-timeout-seconds <n>]\n\nThis command reads a prepared run manifest and dispatches only assignments\nwhose persisted runner is 'cli-wrapper'. It verifies each invocation contract\nbefore execution and uses the persisted provider, model, and registered CLI.\nNative-session assignments remain owned by the active host session.\n\nMissing worker prompt files are generated automatically from the immutable run snapshot.\nExisting prompt and metadata files are never overwritten.\nWhen report-writer completes, this command also runs the idempotent post-report\nsteps: token-usage substitution, render-views, spawn-followups, and validate-run.\n\n  --workspace-root and --okstra-bin are owned by this command.\n";
+export declare function buildWorkerDispatchArgs(args: CliArgs, paths: RuntimePaths): string[];
+export declare function runWorkerDispatch(args: CliArgs, { commandName }?: {
+    readonly commandName?: string;
+}): Promise<number>;
+export declare function run(args: readonly string[]): Promise<number>;

package/{src → dist}/commands/execute/worker-dispatch.mjs

@@ -1,6 +1,5 @@
 import { runPythonModule } from "../../lib/python-helper.mjs";
 import { resolvePaths } from "../../lib/paths.mjs";
-
 export const USAGE = `okstra worker-dispatch — dispatch verified CLI-backed workers
 
 Usage:
@@ -20,57 +19,46 @@ steps: token-usage substitution, render-views, spawn-followups, and validate-run
 
   --workspace-root and --okstra-bin are owned by this command.
 `;
-
 const OWNED_FLAGS = new Set(["--workspace-root", "--okstra-bin"]);
-
 function isOwnedFlag(arg) {
-  if (OWNED_FLAGS.has(arg)) return true;
-  return [...OWNED_FLAGS].some((flag) => arg.startsWith(`${flag}=`));
+    if (OWNED_FLAGS.has(arg))
+        return true;
+    return [...OWNED_FLAGS].some((flag) => arg.startsWith(`${flag}=`));
 }
-
 export function buildWorkerDispatchArgs(args, paths) {
-  return [
-    "--workspace-root", paths.workspace,
-    "--okstra-bin", paths.bin,
-    ...args,
-  ];
+    return [
+        "--workspace-root", paths.workspace,
+        "--okstra-bin", paths.bin,
+        ...args,
+    ];
 }
-
 export async function runWorkerDispatch(args, { commandName = "worker-dispatch" } = {}) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(
-      commandName === "worker-dispatch"
-        ? USAGE
-        : USAGE.replaceAll("worker-dispatch", commandName),
-    );
-    return 0;
-  }
-  if (args.length === 0) {
-    process.stdout.write(
-      commandName === "worker-dispatch"
-        ? USAGE
-        : USAGE.replaceAll("worker-dispatch", commandName),
-    );
-    return 2;
-  }
-
-  const forbidden = args.find(isOwnedFlag);
-  if (forbidden) {
-    process.stderr.write(
-      `error: ${forbidden} is set by 'okstra ${commandName}' itself — remove it from your args\n`,
-    );
-    return 2;
-  }
-
-  const paths = await resolvePaths();
-  const result = await runPythonModule({
-    module: "okstra_ctl.worker_dispatch",
-    args: buildWorkerDispatchArgs(args, paths),
-    stdio: "inherit-stdout",
-  });
-  return result.code;
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(commandName === "worker-dispatch"
+            ? USAGE
+            : USAGE.replaceAll("worker-dispatch", commandName));
+        return 0;
+    }
+    if (args.length === 0) {
+        process.stdout.write(commandName === "worker-dispatch"
+            ? USAGE
+            : USAGE.replaceAll("worker-dispatch", commandName));
+        return 2;
+    }
+    const forbidden = args.find(isOwnedFlag);
+    if (forbidden) {
+        process.stderr.write(`error: ${forbidden} is set by 'okstra ${commandName}' itself — remove it from your args\n`);
+        return 2;
+    }
+    const paths = await resolvePaths();
+    const result = await runPythonModule({
+        module: "okstra_ctl.worker_dispatch",
+        args: buildWorkerDispatchArgs(args, paths),
+        stdio: "inherit-stdout",
+    });
+    return result.code;
 }
-
 export async function run(args) {
-  return runWorkerDispatch(args);
+    return runWorkerDispatch(args);
 }
+//# sourceMappingURL=worker-dispatch.mjs.map

package/dist/commands/execute/worker-dispatch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-dispatch.mjs","sourceRoot":"","sources":["../../../src/commands/execute/worker-dispatch.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;CAkBpB,CAAC;AAEF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC,CAAC;AAElE,SAAS,WAAW,CAAC,GAAW;IAC9B,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAa,EAAE,KAAmB;IACxE,OAAO;QACL,kBAAkB,EAAE,KAAK,CAAC,SAAS;QACnC,cAAc,EAAE,KAAK,CAAC,GAAG;QACzB,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAa,EACb,EAAE,WAAW,GAAG,iBAAiB,EAAE,GAAsC,EAAE;IAE3E,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,WAAW,KAAK,iBAAiB;YAC/B,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,iBAAiB,EAAE,WAAW,CAAC,CACrD,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,WAAW,KAAK,iBAAiB;YAC/B,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,iBAAiB,EAAE,WAAW,CAAC,CACrD,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,UAAU,SAAS,sBAAsB,WAAW,uCAAuC,CAC5F,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,YAAY,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,MAAM,EAAE,4BAA4B;QACpC,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,KAAK,CAAC;QAC1C,KAAK,EAAE,gBAAgB;KACxB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/commands/execute/worker-state.d.mts

@@ -0,0 +1 @@
+export declare function run(args: readonly string[]): Promise<number>;

package/{src → dist}/commands/execute/worker-state.mjs

@@ -1,5 +1,4 @@
 import { runPythonModule } from "../../lib/python-helper.mjs";
-
 const USAGE = `okstra worker-state — atomically transition persisted worker status
 
 Usage:
@@ -10,20 +9,20 @@ Usage:
 in-progress records startedAt and clears endedAt. completed, timeout, and error
 record endedAt. timeout, error, and not-run require --reason.
 `;
-
 export async function run(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-  if (args.length === 0) {
-    process.stdout.write(USAGE);
-    return 2;
-  }
-  const result = await runPythonModule({
-    module: "okstra_ctl.worker_state",
-    args,
-    stdio: "inherit-stdout",
-  });
-  return result.code;
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    if (args.length === 0) {
+        process.stdout.write(USAGE);
+        return 2;
+    }
+    const result = await runPythonModule({
+        module: "okstra_ctl.worker_state",
+        args,
+        stdio: "inherit-stdout",
+    });
+    return result.code;
 }
+//# sourceMappingURL=worker-state.mjs.map

package/dist/commands/execute/worker-state.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-state.mjs","sourceRoot":"","sources":["../../../src/commands/execute/worker-state.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,KAAK,GAAG;;;;;;;;;CASb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,MAAM,EAAE,yBAAyB;QACjC,IAAI;QACJ,KAAK,EAAE,gBAAgB;KACxB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/commands/execute/worktree-lookup.d.mts

@@ -0,0 +1 @@
+export declare function run(args: readonly string[]): Promise<number>;

package/{src → dist}/commands/execute/worktree-lookup.mjs

@@ -1,5 +1,4 @@
 import { runPythonSnippet, emitJsonError } from "../../lib/python-helper.mjs";
-
 const USAGE = `okstra worktree-lookup — look up registered worktree for a task-key
 
 Usage:
@@ -14,17 +13,20 @@ the task-key has no active worktree.
 
 Replaces the okstra_ctl.worktree_registry.lookup() heredoc pattern.
 `;
-
 function parseArgs(args) {
-  const positional = args.filter((a) => !a.startsWith("--"));
-  const unknown = args.filter((a) => a.startsWith("--"));
-  if (unknown.length) throw new Error(`unknown argument '${unknown[0]}'`);
-  if (positional.length !== 3) {
-    throw new Error("expected exactly three positional arguments: <project-id> <task-group> <task-id>");
-  }
-  return { projectId: positional[0], taskGroup: positional[1], taskId: positional[2] };
+    const positional = args.filter((a) => !a.startsWith("--"));
+    const unknown = args.filter((a) => a.startsWith("--"));
+    if (unknown.length)
+        throw new Error(`unknown argument '${unknown[0]}'`);
+    if (positional.length !== 3) {
+        throw new Error("expected exactly three positional arguments: <project-id> <task-group> <task-id>");
+    }
+    const [projectId, taskGroup, taskId] = positional;
+    if (projectId === undefined || taskGroup === undefined || taskId === undefined) {
+        throw new Error("expected exactly three positional arguments: <project-id> <task-group> <task-id>");
+    }
+    return { projectId, taskGroup, taskId };
 }
-
 const SCRIPT = `
 import json, sys
 from dataclasses import asdict
@@ -59,33 +61,32 @@ else:
     }
     print(json.dumps(out, ensure_ascii=False, default=str, indent=2))
 `;
-
 export async function run(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-  let opts;
-  try {
-    opts = parseArgs(args);
-  } catch (err) {
-    process.stderr.write(`error: ${err.message}\n\n${USAGE}`);
-    return 2;
-  }
-
-  const result = await runPythonSnippet({
-    script: SCRIPT,
-    args: [opts.projectId, opts.taskGroup, opts.taskId],
-  });
-
-  if (result.code !== 0 && !result.stdout.trim()) {
-    emitJsonError({
-      stage: "python",
-      reason: `python invocation failed: ${result.stderr.trim() || "no output"}`,
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    let opts;
+    try {
+        opts = parseArgs(args);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`error: ${message}\n\n${USAGE}`);
+        return 2;
+    }
+    const result = await runPythonSnippet({
+        script: SCRIPT,
+        args: [opts.projectId, opts.taskGroup, opts.taskId],
     });
-    return 1;
-  }
-
-  process.stdout.write(result.stdout);
-  return result.code === 0 ? 0 : result.code;
+    if (result.code !== 0 && !result.stdout.trim()) {
+        emitJsonError({
+            stage: "python",
+            reason: `python invocation failed: ${result.stderr.trim() || "no output"}`,
+        });
+        return 1;
+    }
+    process.stdout.write(result.stdout);
+    return result.code === 0 ? 0 : result.code;
 }
+//# sourceMappingURL=worktree-lookup.mjs.map

package/dist/commands/execute/worktree-lookup.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-lookup.mjs","sourceRoot":"","sources":["../../../src/commands/execute/worktree-lookup.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG9E,MAAM,KAAK,GAAG;;;;;;;;;;;;;CAab,CAAC;AAEF,SAAS,SAAS,CAAC,IAAa;IAK9B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;IACtG,CAAC;IACD,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC;IAClD,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCd,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;QACpC,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;KACpD,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/C,aAAa,CAAC;YACZ,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,6BAA6B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,WAAW,EAAE;SAC3E,CAAC,CAAC;QACH,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/dist/commands/execute/worktree-status.d.mts

@@ -0,0 +1 @@
+export declare function run(args: readonly string[]): Promise<number>;

package/{src → dist}/commands/execute/worktree-status.mjs

@@ -1,5 +1,4 @@
 import { runPythonSnippet, emitJsonError } from "../../lib/python-helper.mjs";
-
 const USAGE = `okstra worktree-status — clean-worktree check that ignores okstra's own scaffolding
 
 Usage:
@@ -23,27 +22,35 @@ Output: JSON { ok, path, clean, entries, excluded }. \`entries\` holds the
 \`git status --short\` rows that made it dirty; \`excluded\` lists the paths left
 out of the question.
 `;
-
 function parseArgs(args) {
-  const opts = { path: ".", checkClean: false };
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-    if (arg === "--check-clean") {
-      opts.checkClean = true;
-    } else if (arg === "--path") {
-      i += 1;
-      if (i >= args.length) throw new Error("--path requires a directory");
-      opts.path = args[i];
-    } else if (arg.startsWith("--path=")) {
-      opts.path = arg.slice("--path=".length);
-    } else {
-      throw new Error(`unknown argument '${arg}'`);
+    const opts = { path: ".", checkClean: false };
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        if (arg === "--check-clean") {
+            opts.checkClean = true;
+        }
+        else if (arg === "--path") {
+            i += 1;
+            if (i >= args.length)
+                throw new Error("--path requires a directory");
+            const path = args[i];
+            if (path === undefined)
+                throw new Error("--path requires a directory");
+            opts.path = path;
+        }
+        else if (arg.startsWith("--path=")) {
+            opts.path = arg.slice("--path=".length);
+        }
+        else {
+            throw new Error(`unknown argument '${arg}'`);
+        }
     }
-  }
-  if (!opts.path) throw new Error("--path requires a directory");
-  return opts;
+    if (!opts.path)
+        throw new Error("--path requires a directory");
+    return opts;
 }
-
 const SCRIPT = `
 import json, sys
 from pathlib import Path
@@ -77,33 +84,32 @@ print(json.dumps({
 }, ensure_ascii=False, indent=2))
 sys.exit(1 if (check_clean and entries) else 0)
 `;
-
 export async function run(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-  let opts;
-  try {
-    opts = parseArgs(args);
-  } catch (err) {
-    process.stderr.write(`error: ${err.message}\n\n${USAGE}`);
-    return 2;
-  }
-
-  const result = await runPythonSnippet({
-    script: SCRIPT,
-    args: [opts.path, opts.checkClean ? "1" : "0"],
-  });
-
-  if (result.code !== 0 && !result.stdout.trim()) {
-    emitJsonError({
-      stage: "python",
-      reason: `python invocation failed: ${result.stderr.trim() || "no output"}`,
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    let opts;
+    try {
+        opts = parseArgs(args);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`error: ${message}\n\n${USAGE}`);
+        return 2;
+    }
+    const result = await runPythonSnippet({
+        script: SCRIPT,
+        args: [opts.path, opts.checkClean ? "1" : "0"],
     });
-    return 1;
-  }
-
-  process.stdout.write(result.stdout);
-  return result.code;
+    if (result.code !== 0 && !result.stdout.trim()) {
+        emitJsonError({
+            stage: "python",
+            reason: `python invocation failed: ${result.stderr.trim() || "no output"}`,
+        });
+        return 1;
+    }
+    process.stdout.write(result.stdout);
+    return result.code;
 }
+//# sourceMappingURL=worktree-status.mjs.map

package/dist/commands/execute/worktree-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-status.mjs","sourceRoot":"","sources":["../../../src/commands/execute/worktree-status.mts"],"names":[],"mappings":"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"}