@cs-object/cli 0.1.0 → 0.1.2

package/README.md

@@ -9,7 +9,7 @@ retain the unverified development paths.
 
 Follow [setup](../../docs/development.md#setup). In the workspace use
 `node packages/cso-cli/dist/cli.js`; an installed consumer uses `cso`.
-`PYTHON` selects the interpreter with the installed `cso-python` wheel.
+`PYTHON` selects the interpreter with the installed `cs-object` wheel.
 
 ```sh
 cso bindings examples/two-panel
@@ -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-7XCJ6AF3.js → chunk-74QLD4IY.js}

@@ -1,9 +1,9 @@
 import {
   parseStrictJson
-} from "./chunk-KYWIVB2V.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");
@@ -231,7 +231,7 @@ import { createRequire } from "module";
 import { createElement } from "react";
 import { renderToStaticMarkup } from "react-dom/server";
 import { PreparedFormulaSheet } from "@cs-object/react";
-function buildPreparedHtml(preparedDocument, reviewNotice) {
+function buildPreparedHtml(preparedDocument) {
   const css = readFileSync3(
     createRequire(import.meta.url).resolve("@cs-object/react/style.css"),
     "utf8"
@@ -239,27 +239,12 @@ function buildPreparedHtml(preparedDocument, reviewNotice) {
   const markup = renderToStaticMarkup(
     createElement(PreparedFormulaSheet, { document: preparedDocument })
   );
-  const notice = reviewNotice ? renderToStaticMarkup(
-    createElement(
-      "p",
-      {
-        "data-cso-review-notice": true,
-        style: {
-          fontSize: "10pt",
-          margin: "0 0 4mm",
-          padding: "2mm",
-          border: "1px solid #bbb"
-        }
-      },
-      reviewNotice
-    )
-  ) : "";
   return [
     '<!doctype html><html lang="en"><head><meta charset="utf-8">',
     renderToStaticMarkup(createElement("title", null, preparedDocument.title)),
     `<meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src data:; style-src 'unsafe-inline'; font-src data:">`,
     `<meta name="viewport" content="width=device-width, initial-scale=1"><style>${css}</style></head><body class="formula-sheet-printing cso-standalone-report">`,
-    `<div data-formula-sheet-print-root="true">${notice}${markup}</div></body></html>`
+    `<div data-formula-sheet-print-root="true">${markup}</div></body></html>`
   ].join("");
 }
 

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-KYWIVB2V.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.0";
+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-OYQDZWT7.js → chunk-PC7UAF4D.js}

@@ -133,7 +133,7 @@ Options:
   --help                 Show usage without executing Python or launching Chromium.
 
 Paths resolve from the caller's directory. Set PYTHON to the interpreter with the
-cso-python wheel installed. dev-render requires Playwright Chromium.
+cs-object wheel installed. dev-render requires Playwright Chromium.
 Development exit codes: 0 exported/rendered, 1 execution/render/write failed,
 2 invalid usage. verify/html/pdf --format json emit one public CommandReport.
 `;

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

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

package/dist/cli.js

@@ -3,15 +3,16 @@ import {
   UsageError,
   help,
   parseCliArgs
-} from "./chunk-OYQDZWT7.js";
+} from "./chunk-PC7UAF4D.js";
 import {
   initialReport,
   usageReport,
   verifyCommand
-} from "./chunk-KYWIVB2V.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";
@@ -111,7 +112,7 @@ Paths resolve against the caller directory. --help executes neither Python nor C
 `;
   return `Usage: cso ${command2} <file.cso.py> --function <name> [--input <name=number>] [--reference <file.json>]${command2 === "pdf" ? " --out <path.pdf>" : ""} [--format json]${command2 === "pdf" ? " [--no-evidence]" : ""}
 
-${command2 === "verify" ? "Execute once with installed cso-python and independently evaluate every documented result." : "Verify once, render the captured execution, and atomically replace the PDF. Evidence is retained unless --no-evidence is set."}
+${command2 === "verify" ? "Execute once with installed cs-object and independently evaluate every documented result." : "Verify once, render the captured execution, and atomically replace the PDF. Evidence is retained unless --no-evidence is set."}
 Repeat --input for distinct parameters. Duplicate, unknown and invalid inputs fail.
 --reference captures one explicit versioned reference file. Missing matches are not_applicable.
 --format json emits one public CommandReport, including on errors.
@@ -124,25 +125,20 @@ ${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.
 --check reports stale or missing files without writing. Calculations are not executed.
 Python-only equivalent: python -m cso_python bindings <directory> [--check]
-Set PYTHON to the interpreter with cso-python installed.
+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-BVY4Q6R6.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-BVY4Q6R6.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-AAIMIB2S.js");
+      const { htmlCommand } = await import("./html-H5XKL7IB.js");
       outcome = await htmlCommand(options);
     } else if (options.command === "pdf") {
-      const { pdfCommand } = await import("./pdf-WXWGZ6NC.js");
+      const { pdfCommand } = await import("./pdf-6NJX7NN3.js");
       outcome = await pdfCommand(options);
     } else {
       outcome = verifyCommand(options);

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

@@ -1,6 +1,6 @@
 import {
   UsageError
-} from "./chunk-OYQDZWT7.js";
+} from "./chunk-PC7UAF4D.js";
 import {
   LayoutInspectionError,
   buildPreparedHtml,
@@ -8,12 +8,14 @@ import {
   jsonBytes,
   renderPreparedPdf,
   sha256
-} from "./chunk-7XCJ6AF3.js";
+} from "./chunk-74QLD4IY.js";
 import {
   executeAndVerify,
   parseStrictJson
-} from "./chunk-KYWIVB2V.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,
@@ -219,9 +206,7 @@ function createDevRuntime(options, limits = defaults) {
         execution,
         assets: captureAssets(options.sourcePath, execution)
       });
-      const independent = verified.report.checks.independentReferenceAgreement.status;
-      const notice = `Source-to-document consistency passed. Independent numerical reference: ${independent === "passed" ? "passed" : "pending, no matching reference"}. Human visual inspection is pending. These checks do not establish engineering approval.`;
-      const html = Buffer.from(buildPreparedHtml(document, notice));
+      const html = Buffer.from(buildPreparedHtml(document));
       const bytes = html.length + jsonBytes(document).length + verified.capture.executionBytes.length + (verified.capture.referenceBytes?.length ?? 0) + jsonBytes(verified.capture.verification).length;
       prune(bytes, 1);
       const run = {
@@ -439,7 +424,7 @@ pdf.addEventListener('click', async event => {
 var devHelp = `Usage: cso dev <file.cso.py> --function <name> [--port <0-65535>] [--reference <file.json>]
 
 Serve a verified calculation on 127.0.0.1. Port 0 chooses an available port.
-PYTHON selects the installed cso-python interpreter. Source path and function are fixed at startup.
+PYTHON selects the installed cs-object interpreter. Source path and function are fixed at startup.
 `;
 function parseDevArgs(args) {
   const [source, ...rest] = args;

package/dist/development.js

@@ -1,13 +1,14 @@
 import {
   UsageError,
   parseCliArgs
-} from "./chunk-OYQDZWT7.js";
+} 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.0",
+  "version": "0.1.2",
   "license": "Apache-2.0",
   "type": "module",
   "description": "Installed calculation verification and development export/render commands.",
@@ -38,7 +38,7 @@
   "devDependencies": {
     "tsup": "^8.5.1",
     "typescript": "^5",
-    "vitest": "^5.0.1",
+    "vitest": "^5.0.2",
     "@types/node": "^26",
     "@types/react": "^19",
     "@types/react-dom": "^19",

package/dist/html-AAIMIB2S.js

@@ -1,9 +0,0 @@
-import {
-  documentCommand
-} from "./chunk-UCPKZ67Z.js";
-import "./chunk-7XCJ6AF3.js";
-import "./chunk-KYWIVB2V.js";
-import "./chunk-MOM6Q2VG.js";
-export {
-  documentCommand as htmlCommand
-};

package/dist/pdf-WXWGZ6NC.js

@@ -1,9 +0,0 @@
-import {
-  documentCommand
-} from "./chunk-UCPKZ67Z.js";
-import "./chunk-7XCJ6AF3.js";
-import "./chunk-KYWIVB2V.js";
-import "./chunk-MOM6Q2VG.js";
-export {
-  documentCommand as pdfCommand
-};