@hawkeyexl/manni 4.11.0 → 4.12.0

package/dist/chunk-HQR2ZBHW.js.map

@@ -1 +0,0 @@
-{"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":[]}