@cs-object/cli 0.1.1 → 0.1.2

package/README.md

@@ -33,6 +33,38 @@ and 2 means invalid usage. Reports retain known source hashes, function, inputs,
 versions and diagnostics; successful HTML/PDF reports include output path and hash.
 Unknown provenance is not fabricated. See [report schemas](../../packages/cso-core/src/contracts/reports.ts).
 
+### PowerShell 5.1 and 7
+
+Complete [repository setup](../../docs/development.md#setup), then run these
+commands from its root. They use the local CLI wrapper and the installed wheel
+in `.venv`. A generated project's corresponding commands are in its `authoring.md`.
+
+<!-- docs:canonical-report:start -->
+```powershell
+$env:PYTHON = Join-Path $PWD '.venv\Scripts\python.exe'
+$cso = Join-Path $PWD 'packages\cso-cli\dist\cli.js'
+$source = Join-Path $PWD 'examples\two-panel\estimate.cso.py'
+$reference = Join-Path $PWD 'examples\two-panel\reference.json'
+& node.exe $cso bindings (Join-Path $PWD 'examples\two-panel')
+if ($LASTEXITCODE -ne 0) { throw 'Binding generation failed.' }
+& node.exe $cso verify $source --function estimate --input width=2 --reference $reference --format json
+if ($LASTEXITCODE -ne 0) { throw 'Calculation verification failed.' }
+New-Item -ItemType Directory -Force (Join-Path $PWD 'output') | Out-Null
+& node.exe $cso html $source --function estimate --input width=2 --reference $reference --out (Join-Path $PWD 'output\panels.html') --check-layout --format json
+if ($LASTEXITCODE -ne 0) { throw 'Checked HTML generation failed.' }
+& node.exe $cso pdf $source --function estimate --input width=2 --reference $reference --out (Join-Path $PWD 'output\panels.pdf') --format json
+if ($LASTEXITCODE -ne 0) { throw 'PDF generation failed.' }
+```
+<!-- docs:canonical-report:end -->
+
+Keep `PYTHON` as one executable path and invoke path variables with `&`.
+For a standalone install, point it at the environment containing `cs-object`.
+Use `--input name=value` to avoid shell-dependent JSON quoting.
+If you save stdout, select UTF-8 explicitly; the generated project's
+[reference recipe](../create-cs-object/template/references/README.md#bind-an-independent-case)
+shows a PowerShell 5.1/7 capture and BOM-free UTF-8/LF write. Do not use
+PowerShell 5.1 redirection to write source or JSON files.
+
 ## Numerical checks
 
 [verifyExecution](../../packages/cso-core/src/verification/verify.ts) checks inputs,

package/dist/{chunk-2IRNUHX6.js → chunk-74QLD4IY.js}

@@ -1,9 +1,9 @@
 import {
   parseStrictJson
-} from "./chunk-SCZCL6WF.js";
+} from "./chunk-O4PZOHKA.js";
 import {
   stringifyJson
-} from "./chunk-MOM6Q2VG.js";
+} from "./chunk-DIYNSURK.js";
 
 // src/evidence.ts
 import {
@@ -25,7 +25,7 @@ import {
 
 // src/assets.ts
 import { readFileSync, realpathSync, statSync } from "fs";
-import { dirname, isAbsolute, relative, resolve } from "path";
+import { dirname, isAbsolute, relative, resolve, sep } from "path";
 import { createHash } from "crypto";
 import {
   ResolvedAssetSchema
@@ -41,7 +41,7 @@ function captureAssets(sourcePath, execution) {
         resolve(root, dirname(asset.moduleId), asset.path)
       );
       const within = relative(root, path);
-      if (within === ".." || within.startsWith("../") || isAbsolute(within))
+      if (within === ".." || within.startsWith(`..${sep}`) || isAbsolute(within))
         throw new Error("Asset resolves outside the entry source directory");
       if (!statSync(path).isFile())
         throw new Error("Asset is not a regular file");

package/dist/{chunk-MOM6Q2VG.js → chunk-DIYNSURK.js}

@@ -39,6 +39,28 @@ function stringifyJson(value) {
   return encoded;
 }
 
+// src/python-process.ts
+import { spawnSync } from "child_process";
+function isolatedEnvironment() {
+  const environment = { ...process.env };
+  for (const key of ["PYTHONPATH", "PYTHONHOME", "NODE_PATH"])
+    Reflect.deleteProperty(environment, key);
+  return environment;
+}
+function runPythonProcess({
+  command,
+  args,
+  ...limits
+}) {
+  return spawnSync(
+    process.env.PYTHON ?? "python3",
+    ["-I", "-X", "utf8", "-m", "cso_python", command, ...args],
+    { env: isolatedEnvironment(), ...limits }
+  );
+}
+
 export {
-  stringifyJson
+  stringifyJson,
+  isolatedEnvironment,
+  runPythonProcess
 };

package/dist/{chunk-SCZCL6WF.js → chunk-O4PZOHKA.js}

@@ -1,12 +1,13 @@
 import {
+  runPythonProcess,
   stringifyJson
-} from "./chunk-MOM6Q2VG.js";
+} from "./chunk-DIYNSURK.js";
 
 // src/reports.ts
 import { CommandReportSchema } from "@cs-object/core";
 
 // package.json
-var version = "0.1.1";
+var version = "0.1.2";
 
 // src/reports.ts
 function initialReport(command) {
@@ -165,37 +166,25 @@ function captureReference(path, execution) {
 }
 
 // src/execution.ts
-import { spawnSync } from "child_process";
 import {
   ExecutionResponseSchema,
   contractIssuesToDiagnostics as contractIssuesToDiagnostics2
 } from "@cs-object/core";
 var message = (error) => error instanceof Error ? error.message : String(error);
 function runPythonExecution(options, timeoutMs) {
-  const environment = { ...process.env };
-  for (const key of ["PYTHONPATH", "PYTHONHOME", "NODE_PATH"]) {
-    Reflect.deleteProperty(environment, key);
-  }
-  const result = spawnSync(
-    process.env.PYTHON ?? "python3",
-    [
-      "-I",
-      "-m",
-      "cso_python",
-      "execute",
+  const result = runPythonProcess({
+    command: "execute",
+    args: [
       options.sourcePath,
       "--function",
       options.functionName,
       "--inputs-json",
       stringifyJson(options.inputs)
     ],
-    {
-      env: environment,
-      maxBuffer: 64 * 1024 * 1024,
-      timeout: timeoutMs,
-      killSignal: "SIGKILL"
-    }
-  );
+    maxBuffer: 64 * 1024 * 1024,
+    timeout: timeoutMs,
+    killSignal: "SIGKILL"
+  });
   if (result.stderr) {
     process.stderr.write(result.stderr);
   }

package/dist/{chunk-KZZ2NIR7.js → chunk-PXJXS4ZR.js}

@@ -8,10 +8,10 @@ import {
   renderPreparedPdf,
   retainSource,
   sha256
-} from "./chunk-2IRNUHX6.js";
+} from "./chunk-74QLD4IY.js";
 import {
   executeAndVerify
-} from "./chunk-SCZCL6WF.js";
+} from "./chunk-O4PZOHKA.js";
 
 // src/document.ts
 import { CommandReportSchema } from "@cs-object/core";

package/dist/cli.js

@@ -8,10 +8,11 @@ import {
   initialReport,
   usageReport,
   verifyCommand
-} from "./chunk-SCZCL6WF.js";
+} from "./chunk-O4PZOHKA.js";
 import {
+  runPythonProcess,
   stringifyJson
-} from "./chunk-MOM6Q2VG.js";
+} from "./chunk-DIYNSURK.js";
 
 // src/cli.ts
 import { CommandReportSchema } from "@cs-object/core";
@@ -124,7 +125,6 @@ ${command2 === "pdf" ? "PDF evidence is retained at <output>.evidence/<manifest-
 }
 
 // src/bindings.ts
-import { spawnSync } from "child_process";
 var bindingsHelp = `Usage: cso bindings <directory> [--check]
 
 Generate importable _cso_bindings modules and typed signatures from .cso.py files.
@@ -134,15 +134,11 @@ Set PYTHON to the interpreter with cs-object installed.
 Exit codes: 0 current/generated, 1 stale/source/write failure, 2 invalid usage.
 `;
 function bindingsCommand(args2) {
-  const environment = { ...process.env };
-  for (const key of ["PYTHONPATH", "PYTHONHOME", "NODE_PATH"]) {
-    Reflect.deleteProperty(environment, key);
-  }
-  const result = spawnSync(
-    process.env.PYTHON ?? "python3",
-    ["-I", "-m", "cso_python", "bindings", ...args2],
-    { env: environment, maxBuffer: 64 * 1024 * 1024 }
-  );
+  const result = runPythonProcess({
+    command: "bindings",
+    args: args2,
+    maxBuffer: 64 * 1024 * 1024
+  });
   if (result.stderr) process.stderr.write(result.stderr);
   if (result.error || result.signal) {
     process.stdout.write(
@@ -175,11 +171,11 @@ if (command === "--help" || command === void 0 || [
   "dev-render"
 ].includes(command) && args.includes("--help")) {
   process.stdout.write(
-    command === "verify" || command === "pdf" || command === "html" ? verifiedHelp(command) : command === "dev" ? (await import("./dev-server-PBQWZU63.js")).devHelp : command === "bindings" ? bindingsHelp : help
+    command === "verify" || command === "pdf" || command === "html" ? verifiedHelp(command) : command === "dev" ? (await import("./dev-server-IP2WWWK2.js")).devHelp : command === "bindings" ? bindingsHelp : help
   );
 } else if (command === "dev") {
   try {
-    const { devCommand } = await import("./dev-server-PBQWZU63.js");
+    const { devCommand } = await import("./dev-server-IP2WWWK2.js");
     await devCommand(args);
   } catch (error) {
     process.stderr.write(
@@ -195,10 +191,10 @@ if (command === "--help" || command === void 0 || [
   try {
     const options = parseVerifiedArgs(command, args);
     if (options.command === "html") {
-      const { htmlCommand } = await import("./html-WL2NAGRV.js");
+      const { htmlCommand } = await import("./html-H5XKL7IB.js");
       outcome = await htmlCommand(options);
     } else if (options.command === "pdf") {
-      const { pdfCommand } = await import("./pdf-AQCYVWRF.js");
+      const { pdfCommand } = await import("./pdf-6NJX7NN3.js");
       outcome = await pdfCommand(options);
     } else {
       outcome = verifyCommand(options);

package/dist/{dev-server-PBQWZU63.js → dev-server-IP2WWWK2.js}

@@ -8,12 +8,14 @@ import {
   jsonBytes,
   renderPreparedPdf,
   sha256
-} from "./chunk-2IRNUHX6.js";
+} from "./chunk-74QLD4IY.js";
 import {
   executeAndVerify,
   parseStrictJson
-} from "./chunk-SCZCL6WF.js";
-import "./chunk-MOM6Q2VG.js";
+} from "./chunk-O4PZOHKA.js";
+import {
+  runPythonProcess
+} from "./chunk-DIYNSURK.js";
 
 // src/dev-server.ts
 import {
@@ -34,7 +36,6 @@ var HttpError = class extends Error {
 };
 
 // src/dev-runtime.ts
-import { spawnSync } from "child_process";
 import { randomUUID } from "crypto";
 import {
   CalculationDefinitionResponseSchema
@@ -49,27 +50,13 @@ var defaults = {
   maximumAgeMs: 30 * 6e4
 };
 function describe(options) {
-  const env = { ...process.env };
-  for (const key of ["PYTHONPATH", "PYTHONHOME", "NODE_PATH"])
-    Reflect.deleteProperty(env, key);
-  const result = spawnSync(
-    process.env.PYTHON ?? "python3",
-    [
-      "-I",
-      "-m",
-      "cso_python",
-      "describe",
-      options.sourcePath,
-      "--function",
-      options.functionName
-    ],
-    {
-      env,
-      timeout: 3e4,
-      killSignal: "SIGKILL",
-      maxBuffer: 4 * 1024 * 1024
-    }
-  );
+  const result = runPythonProcess({
+    command: "describe",
+    args: [options.sourcePath, "--function", options.functionName],
+    timeout: 3e4,
+    killSignal: "SIGKILL",
+    maxBuffer: 4 * 1024 * 1024
+  });
   if (result.error || result.signal)
     throw new HttpError(
       422,

package/dist/development.js

@@ -3,11 +3,12 @@ import {
   parseCliArgs
 } from "./chunk-PC7UAF4D.js";
 import {
+  isolatedEnvironment,
+  runPythonProcess,
   stringifyJson
-} from "./chunk-MOM6Q2VG.js";
+} from "./chunk-DIYNSURK.js";
 
 // src/development.ts
-import { spawnSync } from "child_process";
 import {
   existsSync,
   mkdirSync,
@@ -31,13 +32,6 @@ var defaultCssPath = createRequire(import.meta.url).resolve(
   "@cs-object/react/style.css"
 );
 var escapeHtml = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
-function isolatedEnvironment() {
-  const environment = { ...process.env };
-  Reflect.deleteProperty(environment, "NODE_PATH");
-  Reflect.deleteProperty(environment, "PYTHONPATH");
-  Reflect.deleteProperty(environment, "PYTHONHOME");
-  return environment;
-}
 function writeAtomically(outPath, bytes) {
   mkdirSync(dirname(outPath), { recursive: true });
   const temporary = join(
@@ -56,37 +50,31 @@ var runPythonExporter = ({
   inputs,
   sourcePath
 }) => {
-  const result = spawnSync(
-    process.env.PYTHON ?? "python3",
-    [
-      "-I",
-      "-m",
-      "cso_python",
-      "export",
+  const result = runPythonProcess({
+    command: "export",
+    args: [
       sourcePath,
       "--function",
       functionName,
       "--inputs-json",
       stringifyJson(inputs)
     ],
-    {
-      encoding: "utf8",
-      env: isolatedEnvironment(),
-      maxBuffer: 32 * 1024 * 1024
-    }
-  );
+    maxBuffer: 32 * 1024 * 1024
+  });
   if (result.error) {
     throw result.error;
   }
   if (result.status !== 0) {
-    const message = result.stderr.trim() || "Python exporter failed";
+    const message = result.stderr.toString("utf8").trim() || "Python exporter failed";
     if (result.status === 2) throw new UsageError(message);
     throw new Error(message);
   }
   if (result.stderr) {
     process.stderr.write(result.stderr);
   }
-  return CalculationSourceObjectSchema.parse(JSON.parse(result.stdout));
+  return CalculationSourceObjectSchema.parse(
+    JSON.parse(result.stdout.toString("utf8"))
+  );
 };
 var renderFormulaSheetHtml = (sheet, { css, title }) => {
   const sheetMarkup = renderToStaticMarkup(

package/dist/html-H5XKL7IB.js

@@ -0,0 +1,9 @@
+import {
+  documentCommand
+} from "./chunk-PXJXS4ZR.js";
+import "./chunk-74QLD4IY.js";
+import "./chunk-O4PZOHKA.js";
+import "./chunk-DIYNSURK.js";
+export {
+  documentCommand as htmlCommand
+};

package/dist/pdf-6NJX7NN3.js

@@ -0,0 +1,9 @@
+import {
+  documentCommand
+} from "./chunk-PXJXS4ZR.js";
+import "./chunk-74QLD4IY.js";
+import "./chunk-O4PZOHKA.js";
+import "./chunk-DIYNSURK.js";
+export {
+  documentCommand as pdfCommand
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cs-object/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "license": "Apache-2.0",
   "type": "module",
   "description": "Installed calculation verification and development export/render commands.",

package/dist/html-WL2NAGRV.js

@@ -1,9 +0,0 @@
-import {
-  documentCommand
-} from "./chunk-KZZ2NIR7.js";
-import "./chunk-2IRNUHX6.js";
-import "./chunk-SCZCL6WF.js";
-import "./chunk-MOM6Q2VG.js";
-export {
-  documentCommand as htmlCommand
-};

package/dist/pdf-AQCYVWRF.js

@@ -1,9 +0,0 @@
-import {
-  documentCommand
-} from "./chunk-KZZ2NIR7.js";
-import "./chunk-2IRNUHX6.js";
-import "./chunk-SCZCL6WF.js";
-import "./chunk-MOM6Q2VG.js";
-export {
-  documentCommand as pdfCommand
-};