@schemasentry/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Schema Sentry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,241 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import { readFile } from "fs/promises";
+import path from "path";
+import { stableStringify as stableStringify2 } from "@schemasentry/core";
+
+// src/report.ts
+import {
+  stableStringify,
+  validateSchema
+} from "@schemasentry/core";
+var buildReport = (manifest, data) => {
+  const manifestRoutes = manifest.routes ?? {};
+  const dataRoutes = data.routes ?? {};
+  const allRoutes = /* @__PURE__ */ new Set([
+    ...Object.keys(manifestRoutes),
+    ...Object.keys(dataRoutes)
+  ]);
+  const routes = Array.from(allRoutes).sort().map((route) => {
+    const expectedTypes = manifestRoutes[route] ?? [];
+    const nodes = dataRoutes[route] ?? [];
+    const foundTypes = nodes.map((node) => node["@type"]).filter((type) => typeof type === "string");
+    const validation = validateSchema(nodes);
+    const issues = [...validation.issues];
+    if (expectedTypes.length > 0) {
+      if (nodes.length === 0) {
+        issues.push({
+          path: `routes["${route}"]`,
+          message: "No schema blocks found for route",
+          severity: "error",
+          ruleId: "coverage.missing_route"
+        });
+      }
+      for (const expectedType of expectedTypes) {
+        if (!foundTypes.includes(expectedType)) {
+          issues.push({
+            path: `routes["${route}"].types`,
+            message: `Missing expected schema type '${expectedType}'`,
+            severity: "error",
+            ruleId: "coverage.missing_type"
+          });
+        }
+      }
+    }
+    if (!manifestRoutes[route] && nodes.length > 0) {
+      issues.push({
+        path: `routes["${route}"]`,
+        message: "Route has schema but is missing from manifest",
+        severity: "warn",
+        ruleId: "coverage.unlisted_route"
+      });
+    }
+    const errorCount = issues.filter((issue) => issue.severity === "error").length;
+    const warnCount = issues.filter((issue) => issue.severity === "warn").length;
+    const score = Math.max(0, validation.score - errorCount * 5 - warnCount * 2);
+    return {
+      route,
+      ok: errorCount === 0,
+      score,
+      issues,
+      expectedTypes,
+      foundTypes
+    };
+  });
+  const summaryErrors = routes.reduce(
+    (count, route) => count + route.issues.filter((i) => i.severity === "error").length,
+    0
+  );
+  const summaryWarnings = routes.reduce(
+    (count, route) => count + route.issues.filter((i) => i.severity === "warn").length,
+    0
+  );
+  const summaryScore = routes.length === 0 ? 0 : Math.round(
+    routes.reduce((total, route) => total + route.score, 0) / routes.length
+  );
+  return {
+    ok: summaryErrors === 0,
+    summary: {
+      routes: routes.length,
+      errors: summaryErrors,
+      warnings: summaryWarnings,
+      score: summaryScore
+    },
+    routes
+  };
+};
+
+// src/index.ts
+var program = new Command();
+program.name("schemasentry").description("Schema Sentry CLI").version("0.1.0");
+program.command("validate").description("Validate schema coverage and rules").option(
+  "-m, --manifest <path>",
+  "Path to manifest JSON",
+  "schema-sentry.manifest.json"
+).option(
+  "-d, --data <path>",
+  "Path to schema data JSON",
+  "schema-sentry.data.json"
+).action(async (options) => {
+  const manifestPath = path.resolve(process.cwd(), options.manifest);
+  const dataPath = path.resolve(process.cwd(), options.data);
+  let raw;
+  try {
+    raw = await readFile(manifestPath, "utf8");
+  } catch (error) {
+    console.error(
+      stableStringify2({
+        ok: false,
+        errors: [
+          {
+            code: "manifest.not_found",
+            message: `Manifest not found at ${manifestPath}`
+          }
+        ]
+      })
+    );
+    process.exit(1);
+    return;
+  }
+  let manifest;
+  try {
+    manifest = JSON.parse(raw);
+  } catch (error) {
+    console.error(
+      stableStringify2({
+        ok: false,
+        errors: [
+          {
+            code: "manifest.invalid_json",
+            message: "Manifest is not valid JSON"
+          }
+        ]
+      })
+    );
+    process.exit(1);
+    return;
+  }
+  if (!isManifest(manifest)) {
+    console.error(
+      stableStringify2({
+        ok: false,
+        errors: [
+          {
+            code: "manifest.invalid_shape",
+            message: "Manifest must contain a 'routes' object with string array values"
+          }
+        ]
+      })
+    );
+    process.exit(1);
+    return;
+  }
+  let dataRaw;
+  try {
+    dataRaw = await readFile(dataPath, "utf8");
+  } catch (error) {
+    console.error(
+      stableStringify2({
+        ok: false,
+        errors: [
+          {
+            code: "data.not_found",
+            message: `Schema data not found at ${dataPath}`
+          }
+        ]
+      })
+    );
+    process.exit(1);
+    return;
+  }
+  let data;
+  try {
+    data = JSON.parse(dataRaw);
+  } catch (error) {
+    console.error(
+      stableStringify2({
+        ok: false,
+        errors: [
+          {
+            code: "data.invalid_json",
+            message: "Schema data is not valid JSON"
+          }
+        ]
+      })
+    );
+    process.exit(1);
+    return;
+  }
+  if (!isSchemaData(data)) {
+    console.error(
+      stableStringify2({
+        ok: false,
+        errors: [
+          {
+            code: "data.invalid_shape",
+            message: "Schema data must contain a 'routes' object with array values"
+          }
+        ]
+      })
+    );
+    process.exit(1);
+    return;
+  }
+  const report = buildReport(manifest, data);
+  console.log(formatReportOutput(report));
+  process.exit(report.ok ? 0 : 1);
+});
+program.parse();
+var isManifest = (value) => {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const manifest = value;
+  if (!manifest.routes || typeof manifest.routes !== "object") {
+    return false;
+  }
+  for (const entry of Object.values(manifest.routes)) {
+    if (!Array.isArray(entry) || entry.some((item) => typeof item !== "string")) {
+      return false;
+    }
+  }
+  return true;
+};
+var isSchemaData = (value) => {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const data = value;
+  if (!data.routes || typeof data.routes !== "object") {
+    return false;
+  }
+  for (const entry of Object.values(data.routes)) {
+    if (!Array.isArray(entry)) {
+      return false;
+    }
+  }
+  return true;
+};
+var formatReportOutput = (report) => stableStringify2(report);

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@schemasentry/cli",
+  "version": "0.1.0",
+  "description": "CLI for Schema Sentry validation and reporting.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "schemasentry": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arindamdawn/schema-sentry.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/arindamdawn/schema-sentry#readme",
+  "bugs": {
+    "url": "https://github.com/arindamdawn/schema-sentry/issues"
+  },
+  "keywords": [
+    "schema",
+    "json-ld",
+    "structured-data",
+    "seo",
+    "cli",
+    "nextjs"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "@schemasentry/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean --tsconfig tsconfig.build.json",
+    "lint": "echo \"lint not configured\" && exit 0",
+    "test": "vitest run"
+  }
+}