@gurulu/cli 0.1.0 → 0.1.2

package/scripts/validate-gurulu-schemas.mjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+// Validates every example file in examples/gurulu/ against its matching
+// schema in schemas/gurulu/. Pure contract check for the W4.1 spike —
+// this script is NOT wired into the app runtime.
+
+import { readFileSync, readdirSync } from "node:fs";
+import { resolve, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import AjvModule from "ajv";
+
+const Ajv = AjvModule.default || AjvModule;
+
+const here = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(here, "..");
+const schemaDir = join(repoRoot, "schemas", "gurulu");
+const exampleDir = join(repoRoot, "examples", "gurulu");
+
+const ajv = new Ajv({ allErrors: true, strict: false });
+// ajv 6.x doesn't understand draft-07 $id registration for "format: uri" by default,
+// but it ships with basic formats. Keep validation permissive on unknown formats.
+if (typeof ajv.addFormat === "function") {
+  for (const f of ["hostname", "uri", "date-time"]) {
+    if (!ajv.getFormat || !ajv.getFormat(f)) {
+      try { ajv.addFormat(f, { validate: () => true }); } catch {}
+    }
+  }
+}
+
+const schemaFiles = readdirSync(schemaDir).filter((f) => f.endsWith(".schema.json"));
+
+let failures = 0;
+for (const schemaFile of schemaFiles.sort()) {
+  const base = schemaFile.replace(".schema.json", "");
+  const schemaPath = join(schemaDir, schemaFile);
+  const examplePath = join(exampleDir, `${base}.json`);
+
+  let schema, example;
+  try {
+    schema = JSON.parse(readFileSync(schemaPath, "utf8"));
+  } catch (e) {
+    console.error(`SCHEMA PARSE FAIL ${schemaFile}: ${e.message}`);
+    failures++;
+    continue;
+  }
+  try {
+    example = JSON.parse(readFileSync(examplePath, "utf8"));
+  } catch (e) {
+    console.error(`EXAMPLE MISSING/INVALID ${base}.json: ${e.message}`);
+    failures++;
+    continue;
+  }
+
+  let validate;
+  try {
+    validate = ajv.compile(schema);
+  } catch (e) {
+    console.error(`COMPILE FAIL ${schemaFile}: ${e.message}`);
+    failures++;
+    continue;
+  }
+
+  const ok = validate(example);
+  if (ok) {
+    console.log(`OK  ${base}`);
+  } else {
+    failures++;
+    console.error(`FAIL ${base}:`);
+    for (const err of validate.errors || []) {
+      console.error(`  - ${err.instancePath || "(root)"} ${err.message}`);
+    }
+  }
+}
+
+if (failures > 0) {
+  console.error(`\n${failures} validation failure(s).`);
+  process.exit(1);
+} else {
+  console.log(`\nAll ${schemaFiles.length} schema/example pairs valid.`);
+}