okstra 0.50.0 → 0.51.0

package/src/_python-helper.mjs

@@ -1,12 +1,12 @@
 import { spawn } from "node:child_process";
-import { resolvePaths } from "./paths.mjs";
+import { buildPythonpath, resolvePaths } from "./paths.mjs";
 
 export async function runPythonSnippet({ script, args = [], extraEnv = {} }) {
   const paths = await resolvePaths();
   return new Promise((resolve) => {
     const child = spawn("python3", ["-c", script, ...args], {
       stdio: ["ignore", "pipe", "pipe"],
-      env: { ...process.env, PYTHONPATH: paths.pythonpath, ...extraEnv },
+      env: { ...process.env, PYTHONPATH: buildPythonpath(paths), ...extraEnv },
     });
     let stdout = "";
     let stderr = "";
@@ -22,7 +22,7 @@ export async function runPythonModule({ module, args = [], extraEnv = {}, stdio
   return new Promise((resolve) => {
     const child = spawn("python3", ["-m", module, ...args], {
       stdio: stdio === "capture" ? ["ignore", "pipe", "pipe"] : ["ignore", "inherit", "inherit"],
-      env: { ...process.env, PYTHONPATH: paths.pythonpath, ...extraEnv },
+      env: { ...process.env, PYTHONPATH: buildPythonpath(paths), ...extraEnv },
     });
     let stdout = "";
     let stderr = "";

package/src/context-cost.mjs

@@ -0,0 +1,27 @@
+import { runPythonModule } from "./_python-helper.mjs";
+
+const USAGE = `okstra context-cost — estimate context/read cost for a task bundle
+
+Usage:
+  okstra context-cost <task-root>
+  okstra context-cost <task-key> --project-root <dir>
+  okstra context-cost <task-key> --cwd <dir>
+
+Output: JSON with task file counts, current-run counts, lead Phase 1 read
+surface, analysis-worker initial read surface, and report-writer synthesis
+surface. This is read-only; it never mutates task artifacts.
+`;
+
+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.context_cost",
+    args,
+    stdio: "inherit-stdout",
+  });
+  return result.code ?? 0;
+}

package/src/install.mjs

@@ -22,6 +22,7 @@ const BIN_ENTRYPOINTS = [
   "okstra-codex-exec.sh",
   "okstra-gemini-exec.sh",
   "okstra-trace-cleanup.sh",
+  "okstra-team-reconcile.sh",
   "okstra-central.sh",
   "okstra-token-usage.py",
   "okstra-error-log.py",

package/src/uninstall.mjs

@@ -8,6 +8,7 @@ const BIN_ENTRYPOINTS = [
   "okstra-codex-exec.sh",
   "okstra-gemini-exec.sh",
   "okstra-trace-cleanup.sh",
+  "okstra-team-reconcile.sh",
   "okstra-central.sh",
   "okstra-token-usage.py",
   "okstra-error-log.py",