chore: publish from main

2026-08-13 12:49:49 +00:00 · 2026-08-05 05:18:23 +00:00
parent 3cfa6a707f
commit de02cfbad3
6 changed files with 857 additions and 0 deletions
@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import {
+  canonicalJson,
+  inspectMapContract,
+  receiptPayload,
+} from "./contract.mjs";
+
+function receiptFor(map) {
+  const sourceSnapshots = map.sources.map((source) => ({
+    id: source.id,
+    retrievedAt: source.retrievedAt,
+    excerptSha256: createHash("sha256").update(source.excerpt).digest("hex"),
+  }));
+  return createHash("sha256")
+    .update(canonicalJson(receiptPayload(map, sourceSnapshots)))
+    .digest("hex");
+}
+
+export function inspectOfflineMap(map) {
+  const result = inspectMapContract(map);
+  return {
+    ...result,
+    receipt: result.valid ? receiptFor(map) : null,
+  };
+}
+
+export async function validateMapFile(file) {
+  let map;
+  try {
+    const input = file instanceof URL ? file : resolve(file);
+    map = JSON.parse(await readFile(input, "utf8"));
+  } catch (error) {
+    return {
+      findings: [{
+        path: "$",
+        rule: "invalid-json",
+        message: `Could not parse JSON: ${error.message}`,
+      }],
+      metrics: { claims: 0, contradictions: 0, evidence: 0, sources: 0, unknowns: 0 },
+      receipt: null,
+      valid: false,
+    };
+  }
+  return inspectOfflineMap(map);
+}
+
+function plural(count, singular, pluralForm = `${singular}s`) {
+  return count === 1 ? singular : pluralForm;
+}
+
+function printHuman(result) {
+  if (!result.valid) {
+    console.error(`INVALID ${result.findings.length} ${plural(result.findings.length, "finding")}`);
+    for (const finding of result.findings) {
+      console.error(`  - ${finding.path} [${finding.rule}] ${finding.message}`);
+    }
+    return;
+  }
+  console.log(`VALID ${result.receipt}`);
+  console.log(
+    `  ✓ ${result.metrics.claims} ${plural(result.metrics.claims, "claim")} · ${result.metrics.evidence} evidence · ${result.metrics.sources} ${plural(result.metrics.sources, "source")}`,
+  );
+  console.log(
+    `  ↯ ${result.metrics.contradictions} ${plural(result.metrics.contradictions, "contradiction")} · ${result.metrics.unknowns} explicit ${plural(result.metrics.unknowns, "unknown")}`,
+  );
+}
+
+async function main(argv) {
+  if (argv.includes("--help") || argv.includes("-h")) {
+    console.log("Usage: node <skill-dir>/scripts/validate.mjs <map.doubt.json> [--json]");
+    return;
+  }
+  const file = argv.find((value) => !value.startsWith("-"));
+  if (!file) throw new Error("Pass a .doubt.json evidence map.");
+  const result = await validateMapFile(file);
+  if (argv.includes("--json")) console.log(JSON.stringify(result, null, 2));
+  else printHuman(result);
+  if (!result.valid) process.exitCode = 1;
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  main(process.argv.slice(2)).catch((error) => {
+    console.error(error.message);
+    process.exitCode = 1;
+  });
+}