@grayhaven/nerve-cli 0.1.0 → 0.2.0

package/dist/index.js

@@ -18,6 +18,30 @@ import {
   assemblyInstructions,
   boardSvg,
   bomCsv,
+  bopCsv,
+  bopJson,
+  analysisCsv,
+  analysisJson,
+  analyzeHarness,
+  builtinAdapters,
+  buildRecordJson,
+  contractJson,
+  createBuildRecord,
+  createRedline,
+  createRelease,
+  formboardSheets,
+  releaseJson,
+  ReleaseBlockedError,
+  resolveRedline,
+  suggestPatch,
+  validateRedlineTarget,
+  exportConnectorContract,
+  findAdapter,
+  generateQuote,
+  importPinoutCsv,
+  quoteCsv,
+  quoteJson,
+  validateContract,
   buildPacket,
   canRelease,
   cutListCsv,
@@ -92,9 +116,17 @@ Usage:
   nerve init [dir]
   nerve compile  <file.harness.ts> [--out dir]
   nerve validate <file.harness.ts>
-  nerve render   <file.harness.ts> [--format svg] [--view schematic|board] [--out dir]
+  nerve render   <file.harness.ts> [--format svg] [--view schematic|board|formboard] [--paper letter|a4] [--out dir]
   nerve export   <file.harness.ts> [--target manufacturing-packet|wireviz] [--out dir]
   nerve import   <file.yml> [--id harness-id] [--out dir]   (WireViz YAML \u2192 HIR)
+  nerve quote    <file.harness.ts> [--out dir]   (requires costing in nerve.config.ts)
+  nerve analyze  <file.harness.ts> [--out dir]   (resistance, drop, bundle, weight \xA734)
+  nerve machine  <adapter-id> <file.harness.ts> [--out dir]   (shop-floor exports \xA731)
+  nerve contract <file.harness.ts> --connector <ref> [--against contract.json|pinout.csv] [--out dir]
+  nerve release  <file.harness.ts> --eco <id> --reason <text> --date <iso> [--against release.json] [--out dir]
+  nerve record   <file.harness.ts> --release <release.json> --serial <sn> --operator <name> --date <iso> --results <measurements.json> [--out dir]
+  nerve redline  add <file.harness.ts> --target <hir-ref> --type <type> --description <text> [--value v] [--release id] [--serial sn]
+  nerve redline  resolve <redlines.json> --id <id> --accept|--reject --reason <text> --date <iso>
   nerve diff     <revA> <revB> [--json]   (each: harness.json, .harness.ts, or revision dir)
   nerve inspect  <harness.json>`;
 var loadHirForDiff = async (path, io) => {
@@ -150,13 +182,22 @@ var run = async (argv, io = realIo) => {
         return 2;
       }
       const view = flags["view"] ?? "schematic";
-      if (view !== "schematic" && view !== "board") {
-        io.err(`Unsupported render view: ${view} (supported: schematic, board)`);
+      if (view !== "schematic" && view !== "board" && view !== "formboard") {
+        io.err(`Unsupported render view: ${view} (supported: schematic, board, formboard)`);
         return 2;
       }
       const result = await compileOrExit(file, io);
       if (typeof result === "number") return result;
       const outDir = resolve(flags["out"] ?? result.config.outputDir ?? "dist");
+      if (view === "formboard") {
+        const paper = flags["paper"] === "a4" ? "a4" : "letter";
+        const board = formboardSheets(result.hir, { paper });
+        for (const sheet of board.sheets) writeOut(outDir, sheet.name, sheet.svg, io);
+        io.out(
+          `formboard ${board.boardWidthMm}x${board.boardHeightMm} mm \u2192 ${board.rows}x${board.cols} ${paper} sheet(s) at 1:1. Print at 100% and verify the calibration ruler.`
+        );
+        return 0;
+      }
       if (view === "board") {
         writeOut(outDir, "board.svg", boardSvg(result.hir), io);
       } else {
@@ -192,7 +233,10 @@ var run = async (argv, io = realIo) => {
       }
       const outDir = resolve(flags["out"] ?? result.config.outputDir ?? "dist");
       const tolerance = result.config.defaultWireTolerance;
-      const options = tolerance !== void 0 ? { defaultWireTolerance: tolerance } : {};
+      const options = {
+        ...tolerance !== void 0 ? { defaultWireTolerance: tolerance } : {},
+        ...result.config.costing !== void 0 ? { costing: result.config.costing } : {}
+      };
       const plan = generateTestPlan(result.hir);
       writeOut(outDir, "harness.json", JSON.stringify(result.hir, null, 2) + "\n", io);
       writeOut(outDir, "schematic.svg", schematicSvg(result.hir), io);
@@ -200,9 +244,15 @@ var run = async (argv, io = realIo) => {
       writeOut(outDir, "bom.csv", bomCsv(result.hir), io);
       writeOut(outDir, "cut-list.csv", cutListCsv(result.hir, options), io);
       writeOut(outDir, "labels.csv", labelScheduleCsv(result.hir), io);
+      writeOut(outDir, "bop.csv", bopCsv(result.hir), io);
+      writeOut(outDir, "bop.json", bopJson(result.hir), io);
       writeOut(outDir, "tests.csv", testPlanCsv(plan), io);
       writeOut(outDir, "test-plan.json", testPlanJson(result.hir), io);
       writeOut(outDir, "assembly-instructions.txt", assemblyInstructions(result.hir), io);
+      if (result.config.costing !== void 0) {
+        writeOut(outDir, "quote.csv", quoteCsv(result.hir, result.config.costing), io);
+        writeOut(outDir, "quote.json", quoteJson(result.hir, result.config.costing), io);
+      }
       writeOut(outDir, "manufacturing-packet.pdf", await manufacturingPacketPdf(result.hir, options), io);
       writeOut(outDir, "manufacturing-packet.zip", (await buildPacket(result.hir, options)).zip, io);
       io.out(summarize(result.hir));
@@ -232,6 +282,233 @@ var run = async (argv, io = realIo) => {
       io.out(summarize(full));
       return hasErrors(diagnostics) ? 1 : 0;
     }
+    case "quote": {
+      const file = positional[0];
+      if (file === void 0) return usage(io);
+      const result = await compileOrExit(file, io);
+      if (typeof result === "number") return result;
+      const model = result.config.costing;
+      if (model === void 0) {
+        io.err("No costing model: add `costing: { laborRatePerHour, ... }` to nerve.config.ts (PRD \xA729).");
+        return 2;
+      }
+      const quote = generateQuote(result.hir, model);
+      const outDir = resolve(flags["out"] ?? result.config.outputDir ?? "dist");
+      writeOut(outDir, "quote.csv", quoteCsv(result.hir, model), io);
+      writeOut(outDir, "quote.json", quoteJson(result.hir, model), io);
+      io.out(
+        `${quote.harness.id} rev ${quote.harness.revision} \u2014 material ${quote.materialCost.toFixed(2)} + scrap ${quote.scrapCost.toFixed(2)} + labor ${quote.laborCost.toFixed(2)} = ${quote.totalCost.toFixed(2)} ${quote.currency} (${quote.perUnitCost.toFixed(2)}/unit @ ${(quote.assumptions.yield * 100).toFixed(0)}% yield)`
+      );
+      for (const mpn of quote.longLeadItems) io.out(`LONG-LEAD: ${mpn}`);
+      for (const mpn of quote.lifecycleRisks) io.out(`LIFECYCLE: ${mpn}`);
+      for (const item of quote.unpricedItems) io.out(`UNPRICED: ${item}`);
+      return 0;
+    }
+    case "analyze": {
+      const file = positional[0];
+      if (file === void 0) return usage(io);
+      const result = await compileOrExit(file, io);
+      if (typeof result === "number") return result;
+      const report = analyzeHarness(result.hir);
+      const outDir = resolve(flags["out"] ?? result.config.outputDir ?? "dist");
+      writeOut(outDir, "analysis.csv", analysisCsv(result.hir), io);
+      writeOut(outDir, "analysis.json", analysisJson(result.hir), io);
+      io.out(
+        `${report.harness.id} rev ${report.harness.revision} \u2014 ${report.totals.wireLengthM} m wire, ~${report.totals.estimatedWeightG} g, ${report.branches.map((b) => `${b.id}: \xD8${b.bundleDiameterMm}mm`).join(", ")}`
+      );
+      return 0;
+    }
+    case "machine": {
+      const [adapterId, file] = positional;
+      if (adapterId === void 0 || file === void 0) return usage(io);
+      const adapter = findAdapter(adapterId);
+      if (adapter === void 0) {
+        io.err(`Unknown adapter: ${adapterId}. Available: ${builtinAdapters.map((a) => a.id).join(", ")}`);
+        return 2;
+      }
+      const result = await compileOrExit(file, io);
+      if (typeof result === "number") return result;
+      const { files, diagnostics } = adapter.generate(result.hir);
+      printDiagnostics(diagnostics, io);
+      if (hasErrors(diagnostics)) return 1;
+      const outDir = resolve(flags["out"] ?? result.config.outputDir ?? "dist");
+      for (const [name, contents] of files) writeOut(outDir, name, contents, io);
+      return 0;
+    }
+    case "contract": {
+      const file = positional[0];
+      const connectorRef = flags["connector"];
+      if (file === void 0 || connectorRef === void 0) return usage(io);
+      const result = await compileOrExit(file, io);
+      if (typeof result === "number") return result;
+      const against = flags["against"];
+      if (against !== void 0) {
+        let contract2;
+        try {
+          const raw = readFileSync(resolve(against), "utf8");
+          contract2 = against.endsWith(".csv") ? importPinoutCsv(raw, { connector: connectorRef }) : JSON.parse(raw);
+        } catch (cause) {
+          io.err(`Failed to load contract ${against}: ${cause instanceof Error ? cause.message : String(cause)}`);
+          return 2;
+        }
+        const diagnostics = validateContract(result.hir, contract2);
+        printDiagnostics(diagnostics, io);
+        io.out(
+          diagnostics.length === 0 ? `Connector ${connectorRef} conforms to ${against}.` : `${diagnostics.length} contract issue(s) for ${connectorRef}.`
+        );
+        return hasErrors(diagnostics) ? 1 : 0;
+      }
+      const contract = exportConnectorContract(result.hir, connectorRef);
+      if (contract === void 0) {
+        io.err(`Connector ${connectorRef} not found in ${result.hir.harness.id}.`);
+        return 2;
+      }
+      const outDir = resolve(flags["out"] ?? result.config.outputDir ?? "dist");
+      writeOut(outDir, `contract-${connectorRef}.json`, contractJson(contract), io);
+      return 0;
+    }
+    case "release": {
+      const file = positional[0];
+      const eco = flags["eco"];
+      const reason = flags["reason"];
+      const date = flags["date"];
+      if (file === void 0 || eco === void 0 || reason === void 0 || date === void 0) return usage(io);
+      const result = await compileOrExit(file, io);
+      if (typeof result === "number") return result;
+      let previous;
+      if (flags["against"] !== void 0) {
+        try {
+          const prevRelease = JSON.parse(readFileSync(resolve(flags["against"]), "utf8"));
+          const prevDir = resolve(flags["against"], "..");
+          const prevHir = decodeHir(JSON.parse(readFileSync(join(prevDir, "harness.json"), "utf8")));
+          previous = { hir: prevHir, releaseId: prevRelease.releaseId };
+        } catch (cause) {
+          io.err(`Failed to load previous release: ${cause instanceof Error ? cause.message : String(cause)}`);
+          return 2;
+        }
+      }
+      try {
+        const release = createRelease(result.hir, {
+          eco: { id: eco, reason, ...flags["author"] !== void 0 ? { author: flags["author"] } : {} },
+          createdAt: date,
+          ...previous !== void 0 ? { previous } : {}
+        });
+        const outDir = resolve(flags["out"] ?? result.config.outputDir ?? "dist");
+        writeOut(outDir, "harness.json", JSON.stringify(result.hir, null, 2) + "\n", io);
+        writeOut(outDir, `release-${result.hir.harness.revision}.json`, releaseJson(release), io);
+        io.out(
+          `Release ${release.releaseId} (${eco}) \u2014 fingerprint ${release.hirFingerprint}` + (release.impact !== void 0 ? ` \u2014 impact: ${release.impact.riskScore} (${release.impact.risk}), ${release.impact.pinoutChanges} pinout / ${release.impact.wireChanges} wire change(s)` : "")
+        );
+        return 0;
+      } catch (cause) {
+        if (cause instanceof ReleaseBlockedError) {
+          io.err(cause.message);
+          return 1;
+        }
+        throw cause;
+      }
+    }
+    case "record": {
+      const file = positional[0];
+      const releasePath = flags["release"];
+      const serial = flags["serial"];
+      const operator = flags["operator"];
+      const date = flags["date"];
+      const resultsPath = flags["results"];
+      if (file === void 0 || releasePath === void 0 || serial === void 0 || operator === void 0 || date === void 0 || resultsPath === void 0) {
+        return usage(io);
+      }
+      const result = await compileOrExit(file, io);
+      if (typeof result === "number") return result;
+      let release, measurements;
+      try {
+        release = JSON.parse(readFileSync(resolve(releasePath), "utf8"));
+        measurements = JSON.parse(readFileSync(resolve(resultsPath), "utf8"));
+      } catch (cause) {
+        io.err(`Failed to load inputs: ${cause instanceof Error ? cause.message : String(cause)}`);
+        return 2;
+      }
+      const record = createBuildRecord(result.hir, release, measurements, {
+        serial,
+        operator,
+        buildDate: date,
+        ...flags["lot"] !== void 0 ? { lot: flags["lot"] } : {},
+        ...flags["workstation"] !== void 0 ? { workstation: flags["workstation"] } : {}
+      });
+      const outDir = resolve(flags["out"] ?? result.config.outputDir ?? "dist");
+      writeOut(outDir, `build-record-${serial}.json`, buildRecordJson(record), io);
+      io.out(
+        `${serial}: ${record.summary.pass} pass / ${record.summary.fail} fail / ${record.summary.notRun} not run \u2192 ${record.summary.status.toUpperCase()}`
+      );
+      return record.summary.status === "fail" ? 1 : 0;
+    }
+    case "redline": {
+      const sub = positional[0];
+      if (sub === "add") {
+        const file = positional[1];
+        const target = flags["target"];
+        const type = flags["type"];
+        const description = flags["description"];
+        if (file === void 0 || target === void 0 || type === void 0 || description === void 0) return usage(io);
+        const result = await compileOrExit(file, io);
+        if (typeof result === "number") return result;
+        const invalid = validateRedlineTarget(result.hir, target);
+        if (invalid !== void 0) {
+          printDiagnostics([invalid], io);
+          return 1;
+        }
+        const redlinesPath = resolve(flags["file"] ?? "redlines.json");
+        const existing = existsSync(redlinesPath) ? JSON.parse(readFileSync(redlinesPath, "utf8")) : [];
+        const redline = createRedline({
+          id: `RL-${String(existing.length + 1).padStart(3, "0")}`,
+          target,
+          type,
+          description,
+          ...flags["value"] !== void 0 ? { proposedValue: flags["value"] } : {},
+          release: flags["release"] ?? `${result.hir.harness.id}@${result.hir.harness.revision}`,
+          ...flags["serial"] !== void 0 ? { serial: flags["serial"] } : {},
+          ...flags["by"] !== void 0 ? { reportedBy: flags["by"] } : {}
+        });
+        writeFileSync(redlinesPath, JSON.stringify([...existing, redline], null, 2) + "\n");
+        io.out(`Recorded ${redline.id} against ${target} in ${redlinesPath}`);
+        return 0;
+      }
+      if (sub === "resolve") {
+        const redlinesPath = positional[1];
+        const id = flags["id"];
+        const reason = flags["reason"];
+        const date = flags["date"];
+        const accept = flags["accept"] === "true";
+        const reject = flags["reject"] === "true";
+        if (redlinesPath === void 0 || id === void 0 || reason === void 0 || date === void 0 || accept === reject) return usage(io);
+        const redlines = JSON.parse(readFileSync(resolve(redlinesPath), "utf8"));
+        const existing = redlines.find((r) => r.id === id);
+        const index = redlines.findIndex((r) => r.id === id);
+        if (existing === void 0) {
+          io.err(`Redline ${id} not found in ${redlinesPath}.`);
+          return 2;
+        }
+        const resolved = resolveRedline(existing, {
+          accept,
+          reason,
+          resolvedAt: date,
+          ...flags["by"] !== void 0 ? { by: flags["by"] } : {}
+        });
+        const updated = [...redlines];
+        updated[index] = resolved;
+        writeFileSync(resolve(redlinesPath), JSON.stringify(updated, null, 2) + "\n");
+        io.out(`${id} ${resolved.status}.`);
+        if (resolved.status === "accepted") {
+          const patch = suggestPatch(resolved);
+          if (patch !== void 0) {
+            io.out("Structured patch (apply via variant() or edit the source):");
+            io.out(JSON.stringify(patch, null, 2));
+          }
+        }
+        return 0;
+      }
+      return usage(io);
+    }
     case "diff": {
       const [pathA, pathB] = positional;
       if (pathA === void 0 || pathB === void 0) return usage(io);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grayhaven/nerve-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "Grayhaven Nerve CLI: compile, validate, render, and export harnesses locally and in CI.",
   "bin": {
@@ -15,16 +15,16 @@
   "dependencies": {
     "effect": "^3.16.0",
     "jiti": "^2.4.2",
-    "@grayhaven/nerve-exporters": "0.1.0",
-    "@grayhaven/nerve": "0.1.0",
-    "@grayhaven/nerve-wireviz": "0.1.0",
-    "@grayhaven/nerve-compiler": "0.1.0"
+    "@grayhaven/nerve": "0.2.0",
+    "@grayhaven/nerve-wireviz": "0.2.0",
+    "@grayhaven/nerve-exporters": "0.2.0",
+    "@grayhaven/nerve-compiler": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@grayhaven/nerve-connectors": "0.1.0"
+    "@grayhaven/nerve-connectors": "0.2.0"
   },
   "license": "Apache-2.0",
   "files": [