@sorane/cli 0.2.1 → 0.2.3

package/bin/sorane.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { register } from "tsx/esm/api";
+
+register();
+await import("../src/main.ts");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sorane/cli",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "OKF-native static site generator CLI",
   "type": "module",
   "license": "MIT",
@@ -22,10 +22,11 @@
     "c2pa"
   ],
   "files": [
+    "bin",
     "src"
   ],
   "bin": {
-    "sorane": "./src/main.ts"
+    "sorane": "./bin/sorane.mjs"
   },
   "engines": {
     "node": ">=23.6"
@@ -35,9 +36,10 @@
   },
   "prepublishOnly": "cd ../.. && npm run typecheck && npm test",
   "dependencies": {
-    "@sorane/core": "0.2.1",
+    "@sorane/core": "0.2.2",
     "@sorane/okf": "0.2.0",
     "@sorane/search": "0.2.1",
-    "js-yaml": "^4.1.0"
+    "js-yaml": "^4.1.0",
+    "tsx": "^4.19.0"
   }
 }

package/src/main.ts

@@ -37,7 +37,7 @@ async function main(): Promise<void> {
         "usage: sorane <build|validate|migrate|index|search|watch> [options]\n" +
           "  build     --cwd <dir> [--clean] [--watch] [--skip-c2pa]\n" +
           "  watch     --cwd <dir> [--clean]\n" +
-          "  validate  --cwd <dir>\n" +
+          "  validate  --cwd <dir> [--json]\n" +
           "  migrate   --cwd <dir> [--dry-run] [--bump-profile 0.2]\n" +
           "  index     --cwd <dir> [--force] [--hybrid] [--fts-only] [--out <path>] [--model <dir>] [--model-id <id>]\n" +
           "  search    <query> [--cwd <dir>] [--type article] [--tag <slug>] [--k 10] [--json] [--fts-only]\n",

package/src/validate.ts

@@ -1,58 +1,40 @@
-import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
-import { join, relative, resolve } from "node:path";
-import { validateDiagramAltWarnings, validateHeadingWarnings } from "@sorane/core";
-import { extract } from "@sorane/okf";
-import { validateSource } from "@sorane/okf";
+import { validateSiteContent } from "@sorane/core";
 import { loadSoraneConfig, parseCwdFlag } from "./config-load.ts";
 
-function walkMarkdown(root: string): string[] {
-  const out: string[] = [];
-  function visit(dir: string): void {
-    for (const name of readdirSync(dir).sort()) {
-      const abs = join(dir, name);
-      if (statSync(abs).isDirectory()) visit(abs);
-      else if (name.endsWith(".md")) out.push(abs);
+function parseValidateArgs(argv: string[]): { cwd: string; json: boolean } {
+  return {
+    cwd: parseCwdFlag(argv),
+    json: argv.includes("--json"),
+  };
+}
+
+function writeHumanReport(report: ReturnType<typeof validateSiteContent>): void {
+  for (const file of report.files) {
+    for (const f of file.findings) {
+      const label = f.severity === "error" ? "" : "warning: ";
+      process.stderr.write(`[sorane] ${file.file}: ${label}${f.message}\n`);
+    }
+  }
+  if (report.ok) {
+    process.stdout.write("[sorane] all concepts valid\n");
+    if (report.warning_count > 0) {
+      process.stderr.write(`[sorane] ${report.warning_count} warning(s)\n`);
     }
   }
-  visit(root);
-  return out;
 }
 
 export async function runValidateCmd(argv: string[]): Promise<void> {
-  const cwd = parseCwdFlag(argv);
+  const { cwd, json } = parseValidateArgs(argv);
   const config = loadSoraneConfig(cwd);
-  const contentDir = resolve(cwd, config.build.content_dir);
-  if (!existsSync(contentDir)) {
-    throw new Error(`content directory not found: ${contentDir}`);
-  }
+  const report = validateSiteContent(cwd, config);
 
-  let errors = 0;
-  for (const abs of walkMarkdown(contentDir)) {
-    const rel = relative(contentDir, abs);
-    const source = readFileSync(abs, "utf8");
-    const result = validateSource(rel, source);
-    for (const w of result.warnings) {
-      process.stderr.write(`[sorane] ${rel}: warning: ${w}\n`);
-    }
-    const { body } = extract(source);
-    if (body !== null) {
-      for (const w of validateDiagramAltWarnings(body, config.build.diagrams ?? {})) {
-        process.stderr.write(`[sorane] ${rel}: warning: ${w}\n`);
-      }
-      for (const w of validateHeadingWarnings(body)) {
-        process.stderr.write(`[sorane] ${rel}: warning: ${w}\n`);
-      }
-    }
-    if (!result.ok) {
-      for (const issue of result.issues) {
-        process.stderr.write(`[sorane] ${rel}: ${issue.message}\n`);
-      }
-      errors += result.issues.length;
-    }
+  if (json) {
+    process.stdout.write(JSON.stringify(report, null, 2) + "\n");
+  } else {
+    writeHumanReport(report);
   }
 
-  if (errors > 0) {
-    throw new Error(`${errors} validation error(s)`);
+  if (!report.ok) {
+    throw new Error(`${report.error_count} validation error(s)`);
   }
-  process.stdout.write("[sorane] all concepts valid\n");
 }