okstra 0.174.0 → 0.176.0

package/dist/commands/inspect/stage-map.mjs

@@ -0,0 +1,110 @@
+import { runPythonSnippet, emitJsonError } from "../../lib/python-helper.mjs";
+const USAGE = `okstra stage-map — dump a task's implementation-planning Stage Map + done stages
+
+Usage:
+  okstra stage-map <task-key>                  task-key is project-id:task-group:task-id
+  okstra stage-map <task-key> --cwd <dir>      Resolve PROJECT_ROOT from <dir>
+  okstra stage-map <task-key> --project <dir>  Use <dir> directly as PROJECT_ROOT
+
+Output: JSON { ok, taskKey, taskRoot, state, sourcePlanPath, stages:[…], doneStages:[int], planning:{…} }.
+Each stage row carries stage_number, title, depends_on, step_count and exit_contract_summary; a
+schema-v2 report adds that stage's sliceValue, acceptance and exitContract.
+planning carries the report's task-level rows — rollbackStrategy, validationChecklist,
+crossProjectDependencies, dependencyMigrationRisk, recommendedOption — so a consumer renders the
+plan instead of re-summarising the report body. Both are absent for a schema-v1 report.
+stages is [] when no implementation-planning Stage Map exists.
+`;
+function parseArgs(args) {
+    const opts = { cwd: process.cwd(), projectRoot: "", taskKey: "" };
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === undefined)
+            continue;
+        if (a === "--cwd") {
+            const value = args[++i];
+            opts.cwd = value ?? "";
+            if (!opts.cwd)
+                throw new Error("--cwd requires a path");
+        }
+        else if (a === "--project") {
+            const value = args[++i];
+            opts.projectRoot = value ?? "";
+            if (!opts.projectRoot)
+                throw new Error("--project requires a path");
+        }
+        else if (a === "--json") {
+            // JSON is always emitted; accept the flag for parity with sibling commands.
+        }
+        else if (a.startsWith("--")) {
+            throw new Error(`unknown argument '${a}'`);
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    if (positional.length !== 1) {
+        throw new Error("expected exactly one positional argument: <task-key>");
+    }
+    const taskKey = positional[0];
+    if (taskKey === undefined)
+        throw new Error("expected exactly one positional argument: <task-key>");
+    opts.taskKey = taskKey;
+    return opts;
+}
+const SCRIPT = `
+import json, sys
+from pathlib import Path
+from okstra_project import (
+    resolve_project_root, stage_map_read_side_snapshot, ResolverError, StateError,
+)
+
+explicit, cwd, task_key = sys.argv[1], sys.argv[2], sys.argv[3]
+
+try:
+    pr = resolve_project_root(explicit_root=explicit, cwd=cwd)
+except ResolverError as e:
+    print(json.dumps({"ok": False, "stage": "resolve", "reason": str(e)}))
+    sys.exit(2)
+
+try:
+    snapshot = stage_map_read_side_snapshot(Path(pr), task_key)
+except StateError as e:
+    print(json.dumps({
+        "ok": False,
+        "stage": getattr(e, "stage", None) or "stage_map",
+        "reason": str(e),
+    }))
+    sys.exit(1)
+
+print(json.dumps({"ok": True, **snapshot}, ensure_ascii=False, 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) {
+        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.projectRoot, opts.cwd, opts.taskKey],
+    });
+    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=stage-map.mjs.map

package/dist/commands/inspect/stage-map.mjs.map

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

package/dist/commands/inspect/task-list.d.mts

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

package/dist/commands/inspect/task-list.mjs

@@ -0,0 +1,103 @@
+import { runPythonSnippet, emitJsonError } from "../../lib/python-helper.mjs";
+const USAGE = `okstra task-list — list okstra tasks registered in this project
+
+Usage:
+  okstra task-list                            Resolve PROJECT_ROOT from cwd, list tasks
+  okstra task-list --cwd <dir>                Start resolution from <dir> instead of cwd
+  okstra task-list --project <dir>            Use <dir> directly as PROJECT_ROOT
+  okstra task-list --task-type <type>         Filter by taskType
+  okstra task-list --latest-run-status <s>    Filter by latestRunStatus
+  okstra task-list --task-group <group>       Filter by taskGroup
+  okstra task-list --limit <N>                Keep the first N (catalog is updatedAt desc)
+
+Output: JSON { ok, projectRoot, tasks: [...], latest: {...}|null }.
+Filters are AND-combined and all optional.
+
+Replaces the common pattern of loading okstra_project and calling
+list_project_tasks + read_latest_task from a python heredoc.
+`;
+function parseArgs(args) {
+    const opts = { cwd: process.cwd(), projectRoot: "", taskType: "", latestRunStatus: "", taskGroup: "", limit: "" };
+    const valued = {
+        "--cwd": "cwd", "--project": "projectRoot", "--task-type": "taskType",
+        "--latest-run-status": "latestRunStatus", "--task-group": "taskGroup", "--limit": "limit",
+    };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === undefined)
+            continue;
+        if (!isValuedFlag(a))
+            throw new Error(`unknown argument '${a}'`);
+        const key = valued[a];
+        if (!key)
+            throw new Error(`unknown argument '${a}'`);
+        const v = args[++i];
+        if (v === undefined || v === "")
+            throw new Error(`${a} requires a value`);
+        opts[key] = v;
+    }
+    return opts;
+}
+function isValuedFlag(value) {
+    return value === "--cwd" || value === "--project" || value === "--task-type" ||
+        value === "--latest-run-status" || value === "--task-group" || value === "--limit";
+}
+const SCRIPT = `
+import json, sys
+from pathlib import Path
+from okstra_project import (
+    list_project_tasks, read_latest_task,
+    resolve_project_root, ResolverError,
+)
+
+explicit = sys.argv[1]
+cwd = sys.argv[2]
+task_type = sys.argv[3] or None
+latest_run_status = sys.argv[4] or None
+task_group = sys.argv[5] or None
+limit = int(sys.argv[6]) if sys.argv[6] else None
+try:
+    pr = resolve_project_root(explicit_root=explicit, cwd=cwd)
+except ResolverError as e:
+    print(json.dumps({"ok": False, "stage": "resolve", "reason": str(e)}))
+    sys.exit(2)
+
+pr_path = Path(pr)
+print(json.dumps({
+    "ok": True,
+    "projectRoot": str(pr_path),
+    "tasks": list_project_tasks(
+        pr_path, task_type=task_type, latest_run_status=latest_run_status,
+        task_group=task_group, limit=limit),
+    "latest": read_latest_task(pr_path),
+}, default=str))
+`;
+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) {
+        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.projectRoot, opts.cwd, opts.taskType, opts.latestRunStatus, opts.taskGroup, opts.limit],
+    });
+    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=task-list.mjs.map

package/dist/commands/inspect/task-list.mjs.map

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

package/dist/commands/inspect/task-show.d.mts

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

package/dist/commands/inspect/task-show.mjs

@@ -0,0 +1,108 @@
+import { runPythonSnippet, emitJsonError } from "../../lib/python-helper.mjs";
+const USAGE = `okstra task-show — summarize a task's manifest and workflow state
+
+Usage:
+  okstra task-show <task-key>                  task-key is project-id:task-group:task-id
+  okstra task-show <task-key> --cwd <dir>      Resolve PROJECT_ROOT from <dir>
+  okstra task-show <task-key> --project <dir>  Use <dir> directly as PROJECT_ROOT
+
+Output: JSON with taskKey, taskType, taskRoot, brief path, workflow phases,
+artifacts, modelAssignments, latestRunPath. Replaces the
+\`cat task-manifest.json | python3 -c ...\` summarization pattern.
+`;
+function parseArgs(args) {
+    const opts = { cwd: process.cwd(), projectRoot: "", taskKey: "" };
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === undefined)
+            continue;
+        if (a === "--cwd") {
+            const value = args[++i];
+            opts.cwd = value ?? "";
+            if (!opts.cwd)
+                throw new Error("--cwd requires a path");
+        }
+        else if (a === "--project") {
+            const value = args[++i];
+            opts.projectRoot = value ?? "";
+            if (!opts.projectRoot)
+                throw new Error("--project requires a path");
+        }
+        else if (a.startsWith("--")) {
+            throw new Error(`unknown argument '${a}'`);
+        }
+        else {
+            positional.push(a);
+        }
+    }
+    if (positional.length !== 1) {
+        throw new Error("expected exactly one positional argument: <task-key>");
+    }
+    const taskKey = positional[0];
+    if (taskKey === undefined)
+        throw new Error("expected exactly one positional argument: <task-key>");
+    opts.taskKey = taskKey;
+    return opts;
+}
+const SCRIPT = `
+import json, sys
+from pathlib import Path
+from okstra_project import (
+    resolve_project_root, task_read_side_snapshot,
+    ResolverError, StateError,
+)
+
+explicit = sys.argv[1]
+cwd = sys.argv[2]
+task_key = sys.argv[3]
+
+try:
+    pr = resolve_project_root(explicit_root=explicit, cwd=cwd)
+except ResolverError as e:
+    print(json.dumps({"ok": False, "stage": "resolve", "reason": str(e)}))
+    sys.exit(2)
+
+pr_path = Path(pr)
+try:
+    snapshot = task_read_side_snapshot(pr_path, task_key)
+except StateError as e:
+    print(json.dumps({
+        "ok": False,
+        "stage": getattr(e, "stage", None) or "task_snapshot",
+        "reason": str(e),
+    }))
+    sys.exit(1)
+
+out = {"ok": True, **snapshot}
+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) {
+        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.projectRoot, opts.cwd, opts.taskKey],
+    });
+    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=task-show.mjs.map

package/dist/commands/inspect/task-show.mjs.map

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

package/dist/commands/inspect/time-report.d.mts

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

package/{src → dist}/commands/inspect/time-report.mjs

@@ -1,5 +1,4 @@
 import { runPythonModule } from "../../lib/python-helper.mjs";
-
 const USAGE = `okstra time-report — aggregate elapsed work time across a task's runs
 
 Usage:
@@ -10,17 +9,16 @@ Output: JSON { ok, taskKey, byTaskType[], grandTotal, perWorker{}, perRunWallClo
 phaseTimelines[], unavailable[] }. All durations are raw milliseconds — the caller
 formats HH:MM:SS and renders tables. This is read-only; it never mutates task state.
 `;
-
 export async function run(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-
-  const result = await runPythonModule({
-    module: "okstra_ctl.time_report",
-    args,
-    stdio: "inherit-stdout",
-  });
-  return result.code;
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    const result = await runPythonModule({
+        module: "okstra_ctl.time_report",
+        args,
+        stdio: "inherit-stdout",
+    });
+    return result.code;
 }
+//# sourceMappingURL=time-report.mjs.map

package/dist/commands/inspect/time-report.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-report.mjs","sourceRoot":"","sources":["../../../src/commands/inspect/time-report.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;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,MAAM,EAAE,wBAAwB;QAChC,IAAI;QACJ,KAAK,EAAE,gBAAgB;KACxB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/commands/inspect/usage-report.d.mts

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

package/{src → dist}/commands/inspect/usage-report.mjs

@@ -1,5 +1,4 @@
 import { runPythonModule } from "../../lib/python-helper.mjs";
-
 const USAGE = `okstra usage-report — aggregate recent project usage by task type
 
 Usage:
@@ -9,17 +8,16 @@ Read-only. Prints JSON containing run coverage, raw and billable-equivalent
 tokens, known USD cost, CPU-sum time, and wall-clock time grouped by task type.
 The default window is the current project's last 30 days.
 `;
-
 export async function run(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-
-  const result = await runPythonModule({
-    module: "okstra_ctl.usage_report",
-    args,
-    stdio: "inherit-stdout",
-  });
-  return result.code;
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    const result = await runPythonModule({
+        module: "okstra_ctl.usage_report",
+        args,
+        stdio: "inherit-stdout",
+    });
+    return result.code;
 }
+//# sourceMappingURL=usage-report.mjs.map

package/dist/commands/inspect/usage-report.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-report.mjs","sourceRoot":"","sources":["../../../src/commands/inspect/usage-report.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,KAAK,GAAG;;;;;;;;CAQb,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;IAED,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/inspect/user-response.d.mts

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

package/{src → dist}/commands/inspect/user-response.mjs

@@ -1,5 +1,4 @@
 import { runPythonModule } from "../../lib/python-helper.mjs";
-
 const USAGE = `okstra user-response — 태스크의 열린 clarification 질문에 세션 내에서 답하고 sidecar 기록
 
 A thin shim over \`python3 -m okstra_ctl.user_response\`. JSON 출력.
@@ -12,15 +11,15 @@ Usage:
 
 Exit codes: 0 ok / 1 오류
 `;
-
 export async function run(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-  const { code } = await runPythonModule({
-    module: "okstra_ctl.user_response",
-    args,
-  });
-  return code ?? 1;
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    const { code } = await runPythonModule({
+        module: "okstra_ctl.user_response",
+        args,
+    });
+    return code ?? 1;
 }
+//# sourceMappingURL=user-response.mjs.map

package/dist/commands/inspect/user-response.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-response.mjs","sourceRoot":"","sources":["../../../src/commands/inspect/user-response.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,KAAK,GAAG;;;;;;;;;;;CAWb,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,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,eAAe,CAAC;QACrC,MAAM,EAAE,0BAA0B;QAClC,IAAI;KACL,CAAC,CAAC;IACH,OAAO,IAAI,IAAI,CAAC,CAAC;AACnB,CAAC"}

package/dist/commands/inspect/worker-liveness.d.mts

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

package/{src → dist}/commands/inspect/worker-liveness.mjs

@@ -1,5 +1,4 @@
 import { runPythonModule } from "../../lib/python-helper.mjs";
-
 const USAGE = `okstra worker-liveness — report whether pending workers are still alive
 
 Usage:
@@ -31,17 +30,16 @@ waitedSeconds } under --wait. Exit 1 when any worker is stalled or did not
 launch, so a caller can branch on the exit code. Read-only: it reports, it never
 kills or re-dispatches.
 `;
-
 export async function run(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-
-  const result = await runPythonModule({
-    module: "okstra_ctl.worker_liveness",
-    args,
-    stdio: "inherit-stdout",
-  });
-  return result.code;
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    const result = await runPythonModule({
+        module: "okstra_ctl.worker_liveness",
+        args,
+        stdio: "inherit-stdout",
+    });
+    return result.code;
 }
+//# sourceMappingURL=worker-liveness.mjs.map

package/dist/commands/inspect/worker-liveness.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-liveness.mjs","sourceRoot":"","sources":["../../../src/commands/inspect/worker-liveness.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Bb,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;IAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,MAAM,EAAE,4BAA4B;QACpC,IAAI;QACJ,KAAK,EAAE,gBAAgB;KACxB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/commands/lifecycle/check-project.d.mts

@@ -0,0 +1,21 @@
+interface CheckPayload {
+    readonly [key: string]: unknown;
+}
+interface SuccessfulCheckPayload extends CheckPayload {
+    readonly ok: true;
+    readonly projectRoot: string;
+    readonly projectJsonPath: string;
+    readonly projectId: string;
+}
+type CheckResult = {
+    readonly code: 0;
+    readonly payload: SuccessfulCheckPayload;
+} | {
+    readonly code: 1 | 2;
+    readonly payload: CheckPayload;
+};
+export declare function run(args: readonly string[]): Promise<number>;
+export declare function checkProject({ cwd }?: {
+    readonly cwd?: string;
+}): Promise<CheckResult>;
+export {};