@hawkeyexl/manni 4.3.1 → 4.4.0

package/dist/chunk-6OYEI2VV.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import {
+  bundledShapesPath,
+  compactIri,
+  loadGraph,
+  parseGraph,
+  validateGraph
+} from "./chunk-MYMBCTDE.js";
+import {
+  loadRunConfig
+} from "./chunk-M2JCK5F6.js";
+import {
+  escapeWorkflowCommandMessage,
+  escapeWorkflowCommandProperty
+} from "./chunk-MNH7QO4Z.js";
+
+// src/graph/commands/check.ts
+import { resolve } from "node:path";
+
+// src/graph/reporters/github.ts
+function renderCheckGithub(report) {
+  const lines = [];
+  for (const f of report.findings) {
+    const file = f.docs[0];
+    const where = file === void 0 ? "" : ` file=${escapeWorkflowCommandProperty(file)}`;
+    const message = escapeWorkflowCommandMessage(
+      `${f.message} (${compactIri(f.focusNode)})`
+    );
+    lines.push(`::${f.severity}${where}::${message}`);
+  }
+  return lines.join("\n");
+}
+
+// src/graph/commands/check.ts
+async function runCheck(opts = {}) {
+  const cwd = opts.cwd ?? process.cwd();
+  const config = loadRunConfig(
+    {
+      ...opts.config === void 0 ? {} : { configPath: opts.config },
+      ...opts.noConfig === void 0 ? {} : { noConfig: opts.noConfig }
+    },
+    cwd
+  );
+  const store = opts.turtle === void 0 ? loadGraph(resolve(cwd, opts.graph ?? config.out)) : parseGraph(opts.turtle, "the built graph");
+  const shapesInput = opts.shapes && opts.shapes.length > 0 ? opts.shapes : config.check.shapes;
+  const shapes = shapesInput.length > 0 ? shapesInput.map((p) => resolve(cwd, p)) : [bundledShapesPath(import.meta.url)];
+  const findings = await validateGraph(store, shapes);
+  const count = (severity) => findings.filter((f) => f.severity === severity).length;
+  const errors = count("error");
+  return {
+    findings,
+    errors,
+    warnings: count("warning"),
+    notices: count("notice"),
+    shapes,
+    // Only an `error` fails the run; a warning and a notice are reported and
+    // pass, as they were when they were called violations and warnings.
+    exitCode: errors > 0 ? 1 : 0
+  };
+}
+function plural(n, word) {
+  return `${String(n)} ${word}${n === 1 ? "" : "s"}`;
+}
+function renderCheck(report, format) {
+  if (format === "json") {
+    const { exitCode: _exitCode, ...rest } = report;
+    return JSON.stringify(rest, null, 2);
+  }
+  if (format === "github") return renderCheckGithub(report);
+  const lines = [];
+  for (const f of report.findings) {
+    const where = f.docs.length > 0 ? ` [${f.docs.join(", ")}]` : "";
+    lines.push(
+      `${f.severity}: ${compactIri(f.focusNode)}${f.path ? ` ${compactIri(f.path)}` : ""} \u2014 ${f.message}${where}`
+    );
+  }
+  if (report.findings.length > 0) lines.push("");
+  lines.push(
+    `${plural(report.errors, "error")}, ${plural(report.warnings, "warning")}, ${plural(report.notices, "notice")}`
+  );
+  return lines.join("\n");
+}
+
+export {
+  runCheck,
+  renderCheck
+};
+//# sourceMappingURL=chunk-6OYEI2VV.js.map

package/dist/chunk-6OYEI2VV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graph/commands/check.ts","../src/graph/reporters/github.ts"],"sourcesContent":["/**\n * `manni graph check` — graph-level validation: run the published SHACL shapes\n * (plus the TS-side SKOS integrity checks) over the built graph and report\n * findings with the doc paths responsible. Errors exit 1; warnings and\n * notices are reported but pass.\n */\nimport { resolve } from \"node:path\";\nimport type { Severity } from \"../../shared/severity.js\";\nimport { loadRunConfig } from \"../core/config.js\";\nimport { loadGraph, compactIri, parseGraph } from \"../core/load.js\";\nimport { bundledShapesPath } from \"../core/pkg.js\";\nimport { validateGraph, type CheckFinding } from \"../core/shacl.js\";\nimport { renderCheckGithub } from \"../reporters/github.js\";\nimport type { CheckFormat } from \"../reporters/index.js\";\n\nexport interface CheckOptions {\n  config?: string;\n  /** `--no-config`: skip discovery and run on the built-in defaults. */\n  noConfig?: boolean;\n  /** Graph .ttl path (default: config `out`). */\n  graph?: string;\n  /** Shapes .ttl paths (default: config `check.shapes`, then bundled). */\n  shapes?: string[];\n  cwd?: string;\n  /**\n   * The graph as Turtle, in place of reading `graph`: what `buildGraph`\n   * returns, so `manni check` checks a build it never wrote.\n   */\n  turtle?: string;\n}\n\nexport interface CheckReport {\n  findings: CheckFinding[];\n  /** Counts on the family's scale, not SHACL's (proposal 0051 §2). */\n  errors: number;\n  warnings: number;\n  notices: number;\n  /** Shapes files used, as given (for reporting). */\n  shapes: string[];\n  exitCode: 0 | 1;\n}\n\nexport async function runCheck(opts: CheckOptions = {}): Promise<CheckReport> {\n  const cwd = opts.cwd ?? process.cwd();\n  const config = loadRunConfig(\n    {\n      ...(opts.config === undefined ? {} : { configPath: opts.config }),\n      ...(opts.noConfig === undefined ? {} : { noConfig: opts.noConfig }),\n    },\n    cwd,\n  );\n  const store =\n    opts.turtle === undefined\n      ? loadGraph(resolve(cwd, opts.graph ?? config.out))\n      : parseGraph(opts.turtle, \"the built graph\");\n\n  // CLI flag over config over the bundled contract — same precedence as\n  // every other knob.\n  const shapesInput =\n    opts.shapes && opts.shapes.length > 0 ? opts.shapes : config.check.shapes;\n  const shapes =\n    shapesInput.length > 0\n      ? shapesInput.map((p) => resolve(cwd, p))\n      : [bundledShapesPath(import.meta.url)];\n\n  const findings = await validateGraph(store, shapes);\n  const count = (severity: Severity): number =>\n    findings.filter((f) => f.severity === severity).length;\n  const errors = count(\"error\");\n\n  return {\n    findings,\n    errors,\n    warnings: count(\"warning\"),\n    notices: count(\"notice\"),\n    shapes,\n    // Only an `error` fails the run; a warning and a notice are reported and\n    // pass, as they were when they were called violations and warnings.\n    exitCode: errors > 0 ? 1 : 0,\n  };\n}\n\n/** `2 errors`, `1 warning`, `0 notices` — each count pluralized on its own. */\nfunction plural(n: number, word: string): string {\n  return `${String(n)} ${word}${n === 1 ? \"\" : \"s\"}`;\n}\n\nexport function renderCheck(report: CheckReport, format: CheckFormat): string {\n  if (format === \"json\") {\n    const { exitCode: _exitCode, ...rest } = report;\n    return JSON.stringify(rest, null, 2);\n  }\n  if (format === \"github\") return renderCheckGithub(report);\n  const lines: string[] = [];\n  for (const f of report.findings) {\n    const where = f.docs.length > 0 ? ` [${f.docs.join(\", \")}]` : \"\";\n    lines.push(\n      `${f.severity}: ${compactIri(f.focusNode)}${\n        f.path ? ` ${compactIri(f.path)}` : \"\"\n      } — ${f.message}${where}`,\n    );\n  }\n  if (report.findings.length > 0) lines.push(\"\");\n  lines.push(\n    `${plural(report.errors, \"error\")}, ${plural(report.warnings, \"warning\")}, ${plural(report.notices, \"notice\")}`,\n  );\n  return lines.join(\"\\n\");\n}\n","/**\n * `--format github`: one workflow-command annotation per `check` finding.\n *\n * `::error file=<first blamed doc>::<message> (<focus node>)`, with\n * `::warning` and `::notice` for the lower levels — the family scale is\n * GitHub's, so the level is the severity, exactly as a11y's and cite's\n * reporters have it.\n *\n * A SHACL finding carries no line number (stress test 5 of proposal 0051 says\n * why SARIF and JUnit are not here), and a finding about a shared node — a\n * concept, an agent, the scheme — may trace back to no document at all. Then\n * there is nothing to anchor to and the annotation goes out without `file=`,\n * which GitHub shows against the workflow run rather than dropping.\n *\n * Empty when the run is clean, so a clean CI step logs nothing.\n */\nimport {\n  escapeWorkflowCommandMessage,\n  escapeWorkflowCommandProperty,\n} from \"../../shared/github.js\";\nimport type { CheckReport } from \"../commands/check.js\";\nimport { compactIri } from \"../core/load.js\";\n\nexport function renderCheckGithub(report: CheckReport): string {\n  const lines: string[] = [];\n  for (const f of report.findings) {\n    // The first, not all of them: one annotation lands on one file, and the\n    // docs are sorted, so which one is stable across runs.\n    const file = f.docs[0];\n    const where =\n      file === undefined ? \"\" : ` file=${escapeWorkflowCommandProperty(file)}`;\n    const message = escapeWorkflowCommandMessage(\n      `${f.message} (${compactIri(f.focusNode)})`,\n    );\n    lines.push(`::${f.severity}${where}::${message}`);\n  }\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAMA,SAAS,eAAe;;;ACiBjB,SAAS,kBAAkB,QAA6B;AAC7D,QAAM,QAAkB,CAAC;AACzB,aAAW,KAAK,OAAO,UAAU;AAG/B,UAAM,OAAO,EAAE,KAAK,CAAC;AACrB,UAAM,QACJ,SAAS,SAAY,KAAK,SAAS,8BAA8B,IAAI,CAAC;AACxE,UAAM,UAAU;AAAA,MACd,GAAG,EAAE,OAAO,KAAK,WAAW,EAAE,SAAS,CAAC;AAAA,IAC1C;AACA,UAAM,KAAK,KAAK,EAAE,QAAQ,GAAG,KAAK,KAAK,OAAO,EAAE;AAAA,EAClD;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;;;ADKA,eAAsB,SAAS,OAAqB,CAAC,GAAyB;AAC5E,QAAM,MAAM,KAAK,OAAO,QAAQ,IAAI;AACpC,QAAM,SAAS;AAAA,IACb;AAAA,MACE,GAAI,KAAK,WAAW,SAAY,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO;AAAA,MAC/D,GAAI,KAAK,aAAa,SAAY,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS;AAAA,IACnE;AAAA,IACA;AAAA,EACF;AACA,QAAM,QACJ,KAAK,WAAW,SACZ,UAAU,QAAQ,KAAK,KAAK,SAAS,OAAO,GAAG,CAAC,IAChD,WAAW,KAAK,QAAQ,iBAAiB;AAI/C,QAAM,cACJ,KAAK,UAAU,KAAK,OAAO,SAAS,IAAI,KAAK,SAAS,OAAO,MAAM;AACrE,QAAM,SACJ,YAAY,SAAS,IACjB,YAAY,IAAI,CAAC,MAAM,QAAQ,KAAK,CAAC,CAAC,IACtC,CAAC,kBAAkB,YAAY,GAAG,CAAC;AAEzC,QAAM,WAAW,MAAM,cAAc,OAAO,MAAM;AAClD,QAAM,QAAQ,CAAC,aACb,SAAS,OAAO,CAAC,MAAM,EAAE,aAAa,QAAQ,EAAE;AAClD,QAAM,SAAS,MAAM,OAAO;AAE5B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,UAAU,MAAM,SAAS;AAAA,IACzB,SAAS,MAAM,QAAQ;AAAA,IACvB;AAAA;AAAA;AAAA,IAGA,UAAU,SAAS,IAAI,IAAI;AAAA,EAC7B;AACF;AAGA,SAAS,OAAO,GAAW,MAAsB;AAC/C,SAAO,GAAG,OAAO,CAAC,CAAC,IAAI,IAAI,GAAG,MAAM,IAAI,KAAK,GAAG;AAClD;AAEO,SAAS,YAAY,QAAqB,QAA6B;AAC5E,MAAI,WAAW,QAAQ;AACrB,UAAM,EAAE,UAAU,WAAW,GAAG,KAAK,IAAI;AACzC,WAAO,KAAK,UAAU,MAAM,MAAM,CAAC;AAAA,EACrC;AACA,MAAI,WAAW,SAAU,QAAO,kBAAkB,MAAM;AACxD,QAAM,QAAkB,CAAC;AACzB,aAAW,KAAK,OAAO,UAAU;AAC/B,UAAM,QAAQ,EAAE,KAAK,SAAS,IAAI,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,MAAM;AAC9D,UAAM;AAAA,MACJ,GAAG,EAAE,QAAQ,KAAK,WAAW,EAAE,SAAS,CAAC,GACvC,EAAE,OAAO,IAAI,WAAW,EAAE,IAAI,CAAC,KAAK,EACtC,WAAM,EAAE,OAAO,GAAG,KAAK;AAAA,IACzB;AAAA,EACF;AACA,MAAI,OAAO,SAAS,SAAS,EAAG,OAAM,KAAK,EAAE;AAC7C,QAAM;AAAA,IACJ,GAAG,OAAO,OAAO,QAAQ,OAAO,CAAC,KAAK,OAAO,OAAO,UAAU,SAAS,CAAC,KAAK,OAAO,OAAO,SAAS,QAAQ,CAAC;AAAA,EAC/G;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}

package/dist/chunk-77AINBYM.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+// src/shared/severity.ts
+var SEVERITIES = ["notice", "warning", "error"];
+var SEVERITY_LIST = SEVERITIES.join(" | ");
+function isSeverity(value) {
+  return SEVERITIES.includes(value);
+}
+function meetsSeverity(severity, min) {
+  return SEVERITIES.indexOf(severity) >= SEVERITIES.indexOf(min);
+}
+
+export {
+  SEVERITIES,
+  SEVERITY_LIST,
+  isSeverity,
+  meetsSeverity
+};
+//# sourceMappingURL=chunk-77AINBYM.js.map

package/dist/chunk-77AINBYM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/severity.ts"],"sourcesContent":["/**\n * The one severity scale every manni tool speaks. Least to most severe.\n *\n * Three values, chosen to match the sinks every tool writes to and the\n * linters that sit beside it. GitHub annotations are `error`, `warning` and\n * `notice`; so are ESLint's and Vale's levels, and pa11y's. A flag or config\n * key that two domains both have carries the same name and the same values,\n * and this is where the values for `severity` are defined once.\n *\n * A domain whose source speaks another scale maps onto this one and keeps\n * the source's value in a field of its own, so nothing is lost for lookup.\n * a11y is the first case: axe reports four impacts, the analyzer folds them\n * onto these three, and each finding still carries axe's word as `impact`.\n */\nexport const SEVERITIES = [\"notice\", \"warning\", \"error\"] as const;\nexport type Severity = (typeof SEVERITIES)[number];\n\n/** The list the way a usage message spells it: `notice | warning | error`. */\nexport const SEVERITY_LIST: string = SEVERITIES.join(\" | \");\n\nexport function isSeverity(value: string): value is Severity {\n  return (SEVERITIES as readonly string[]).includes(value);\n}\n\n/** `true` when `severity` is at or above `min`. */\nexport function meetsSeverity(severity: Severity, min: Severity): boolean {\n  return SEVERITIES.indexOf(severity) >= SEVERITIES.indexOf(min);\n}\n"],"mappings":";;;AAcO,IAAM,aAAa,CAAC,UAAU,WAAW,OAAO;AAIhD,IAAM,gBAAwB,WAAW,KAAK,KAAK;AAEnD,SAAS,WAAW,OAAkC;AAC3D,SAAQ,WAAiC,SAAS,KAAK;AACzD;AAGO,SAAS,cAAc,UAAoB,KAAwB;AACxE,SAAO,WAAW,QAAQ,QAAQ,KAAK,WAAW,QAAQ,GAAG;AAC/D;","names":[]}