okstra 0.28.0 → 0.29.0

package/src/render-views.mjs

@@ -0,0 +1,67 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolvePaths } from "./paths.mjs";
+
+const USAGE = `okstra render-views — render slim AI + self-contained HTML views of a final-report
+
+A thin spawn shim over \`scripts/okstra-render-report-views.py\` (installed
+at \`$HOME/.okstra/bin/okstra-render-report-views.py\`). Reads the final-
+report MD and writes two siblings:
+
+  <stem>.slim.md   — token-saving AI consumption copy
+  <stem>.html       — single-file self-contained human view with form
+                       controls on §5 clarification rows
+
+Usage:
+  okstra render-views <path-to-final-report.md>
+      [--task-key <key>] [--task-type <type>] [--seq <NNN>]
+      [--source-report <project-relative-path>]
+
+When the optional flags are omitted the script infers from the report
+path and its '- Task Type:' / '- Task Key:' lines.
+`;
+
+function resolveEntrypoint(paths) {
+  // Prefer the installed copy under ~/.okstra/bin (what production users
+  // see); fall back to the in-repo dev source when running from a
+  // checkout that hasn't been installed.
+  const installed = resolvePath(paths.home, "bin", "okstra-render-report-views.py");
+  if (existsSync(installed)) return installed;
+  const here = fileURLToPath(new URL("..", import.meta.url));
+  const dev = resolvePath(here, "scripts", "okstra-render-report-views.py");
+  if (existsSync(dev)) return dev;
+  return null;
+}
+
+export async function run(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    process.stdout.write(USAGE);
+    return 0;
+  }
+  if (args.length === 0) {
+    process.stderr.write("error: missing <path-to-final-report.md>\n");
+    process.stderr.write(USAGE);
+    return 2;
+  }
+  const paths = await resolvePaths();
+  const entry = resolveEntrypoint(paths);
+  if (!entry) {
+    process.stderr.write(
+      "error: okstra-render-report-views.py not found. " +
+      "Run `okstra install` to install the runtime.\n",
+    );
+    return 1;
+  }
+  return await new Promise((res) => {
+    const child = spawn("python3", [entry, ...args], {
+      stdio: ["ignore", "inherit", "inherit"],
+    });
+    child.on("error", (err) => {
+      process.stderr.write(`error: ${err.message}\n`);
+      res(1);
+    });
+    child.on("close", (code) => res(code ?? 0));
+  });
+}