@hawkeyexl/manni 4.10.0 → 4.12.0

package/dist/cli.js

@@ -1,21 +1,27 @@
 #!/usr/bin/env node
+import {
+  registerTermLabelSource
+} from "./chunk-DSWKBZWW.js";
 import {
   runIfMain
 } from "./chunk-YEUYKR62.js";
 import {
   package_default
-} from "./chunk-2BV4FBC7.js";
+} from "./chunk-DHGB4JBG.js";
 import "./chunk-OWBRDNRZ.js";
 import "./chunk-G3T47CFV.js";
 import "./chunk-2H7UOFLK.js";
 
 // src/cli.ts
 import { Command } from "commander";
+registerTermLabelSource(
+  async (request) => (await import("./labels-SJNSOPBI.js")).termLabels(request)
+);
 var DOMAINS = [
   {
     names: ["meta"],
     load: async () => [
-      (await import("./cli-HO62TOM2.js")).buildProgram().name("meta").description(
+      (await import("./cli-BOMA2FMP.js")).buildProgram().name("meta").description(
         "Validate, read, query and fill document metadata against JSON Schema"
       )
     ]
@@ -23,7 +29,7 @@ var DOMAINS = [
   {
     names: ["a11y"],
     load: async () => [
-      (await import("./cli-UETKXHJN.js")).buildProgram().name("a11y").description(
+      (await import("./cli-OJKFXQOM.js")).buildProgram().name("a11y").description(
         "Crawl a site and check every page for accessibility violations with axe-core"
       )
     ]
@@ -31,7 +37,7 @@ var DOMAINS = [
   {
     names: ["cite"],
     load: async () => [
-      (await import("./cli-V2DI3K2R.js")).buildProgram().name("cite").description(
+      (await import("./cli-6R4W3HAH.js")).buildProgram().name("cite").description(
         "Track citations from doc claims to source lines and check them for drift"
       )
     ]
@@ -39,7 +45,7 @@ var DOMAINS = [
   {
     names: ["lint"],
     load: async () => [
-      (await import("./cli-BIIUKPTE.js")).buildProgram().name("lint").description(
+      (await import("./cli-4CR7QIOK.js")).buildProgram().name("lint").description(
         "Validate document structure against doctype templates, routed by a page's type"
       )
     ]
@@ -47,7 +53,7 @@ var DOMAINS = [
   {
     names: ["docevals"],
     load: async () => [
-      (await import("./cli-P2X7PNY6.js")).buildProgram().name("docevals").description(
+      (await import("./cli-GBF76EXT.js")).buildProgram().name("docevals").description(
         "Deterministic and LLM-as-judge evals for documentation pages, driven by frontmatter"
       )
     ]
@@ -55,13 +61,19 @@ var DOMAINS = [
   {
     names: ["term"],
     load: async () => [
-      (await import("./term-ASM4LVYC.js")).buildProgram().name("term").description("Check, lint and render a docset's terms and the references into them")
+      (await import("./term-D2N7UN4P.js")).buildProgram().name("term").description("Check, lint and render a docset's terms and the references into them")
+    ]
+  },
+  {
+    names: ["test"],
+    load: async () => [
+      (await import("./cli-XXTNPPKB.js")).buildProgram().name("test").description("Run the docs' procedure tests with Doc Detective and report in the family contract")
     ]
   },
   {
     names: ["graph"],
     load: async () => [
-      (await import("./cli-TELPAMJO.js")).buildProgram().name("graph").description(
+      (await import("./cli-PTKFFNOW.js")).buildProgram().name("graph").description(
         "Deterministic knowledge graphs derived from documentation frontmatter and formatting"
       )
     ]
@@ -69,7 +81,7 @@ var DOMAINS = [
   {
     names: ["tracevals"],
     load: async () => [
-      (await import("./cli-SGVFZOAW.js")).buildProgram().name("tracevals").description(
+      (await import("./cli-UW2K5Z5J.js")).buildProgram().name("tracevals").description(
         "Deterministic and LLM-as-judge adherence evals for AI agent session traces"
       )
     ]
@@ -78,14 +90,14 @@ var DOMAINS = [
   {
     names: ["key"],
     load: async () => [
-      (await import("./cli-4YYC6LCY.js")).buildProgram().name("key").description("Set and rotate the family key that encrypted values are encrypted with.")
+      (await import("./cli-MQYCF3SR.js")).buildProgram().name("key").description("Set and rotate the family key that encrypted values are encrypted with.")
     ]
   },
   // The docs site, a family resource with verbs like `key` (proposal 0082).
   {
     names: ["site"],
     load: async () => [
-      (await import("./cli-LWST5FQH.js")).buildProgram().name("site").description("Start, build and preview the docs site")
+      (await import("./cli-PHZAO4LZ.js")).buildProgram().name("site").description("Start, build and preview the docs site")
     ]
   },
   // The two family verbs (proposal 0078), and the only verbs the umbrella
@@ -93,7 +105,7 @@ var DOMAINS = [
   {
     names: ["check", "status"],
     load: async () => {
-      const { buildCheck, buildStatus } = await import("./cli-EH3I4IUX.js");
+      const { buildCheck, buildStatus } = await import("./cli-EDQPQOCE.js");
       return [buildCheck(), buildStatus()];
     }
   }

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["/**\n * The `manni` CLI: one bin, one subcommand per tool in the family.\n *\n * Each tool builds its own commander program and is mounted here under its\n * name, so `manni meta validate …` is the metadata tool's `validate` with\n * nothing in between. The umbrella owns only what is common to all of them:\n * the name, the version, and the exit-code contract in `runProgram`.\n *\n * Tools land here one at a time, on their own branches; until one merges its\n * subcommand does not exist.\n *\n * Every domain is imported on demand. A domain's module graph is its whole\n * dependency tree (Playwright, axe, Asciidoctor, the RDF stack, ajv), and a\n * hook runs `manni check` after every edit, so the bin mounts only the domain\n * argv names. `--version` mounts none. Anything else (`--help`, a bare\n * `manni`, a typo) mounts them all, so help and \"unknown command\" read as\n * they always did.\n */\nimport { Command } from \"commander\";\nimport pkg from \"../package.json\" with { type: \"json\" };\nimport { runIfMain } from \"./shared/run.js\";\n\ninterface Domain {\n  /** The command names the loader mounts, known before it is loaded. */\n  names: readonly string[];\n  load: () => Promise<Command[]>;\n}\n\n// In the order `manni --help` lists them.\nconst DOMAINS: readonly Domain[] = [\n  {\n    names: [\"meta\"],\n    load: async () => [\n      (await import(\"./meta/cli.js\"))\n        .buildProgram()\n        .name(\"meta\")\n        .description(\n          \"Validate, read, query and fill document metadata against JSON Schema\",\n        ),\n    ],\n  },\n  {\n    names: [\"a11y\"],\n    load: async () => [\n      (await import(\"./a11y/cli.js\"))\n        .buildProgram()\n        .name(\"a11y\")\n        .description(\n          \"Crawl a site and check every page for accessibility violations with axe-core\",\n        ),\n    ],\n  },\n  {\n    names: [\"cite\"],\n    load: async () => [\n      (await import(\"./cite/cli.js\"))\n        .buildProgram()\n        .name(\"cite\")\n        .description(\n          \"Track citations from doc claims to source lines and check them for drift\",\n        ),\n    ],\n  },\n  {\n    names: [\"lint\"],\n    load: async () => [\n      (await import(\"./lint/cli.js\"))\n        .buildProgram()\n        .name(\"lint\")\n        .description(\n          \"Validate document structure against doctype templates, routed by a page's type\",\n        ),\n    ],\n  },\n  {\n    names: [\"docevals\"],\n    load: async () => [\n      (await import(\"./docevals/cli.js\"))\n        .buildProgram()\n        .name(\"docevals\")\n        .description(\n          \"Deterministic and LLM-as-judge evals for documentation pages, driven by frontmatter\",\n        ),\n    ],\n  },\n  {\n    names: [\"term\"],\n    load: async () => [\n      (await import(\"./term/index.js\"))\n        .buildProgram()\n        .name(\"term\")\n        .description(\"Check, lint and render a docset's terms and the references into them\"),\n    ],\n  },\n  {\n    names: [\"graph\"],\n    load: async () => [\n      (await import(\"./graph/cli.js\"))\n        .buildProgram()\n        .name(\"graph\")\n        .description(\n          \"Deterministic knowledge graphs derived from documentation frontmatter and formatting\",\n        ),\n    ],\n  },\n  {\n    names: [\"tracevals\"],\n    load: async () => [\n      (await import(\"./tracevals/cli.js\"))\n        .buildProgram()\n        .name(\"tracevals\")\n        .description(\n          \"Deterministic and LLM-as-judge adherence evals for AI agent session traces\",\n        ),\n    ],\n  },\n  // Not a tool but a family resource with verbs (proposal 0045).\n  {\n    names: [\"key\"],\n    load: async () => [\n      (await import(\"./key/cli.js\"))\n        .buildProgram()\n        .name(\"key\")\n        .description(\"Set and rotate the family key that encrypted values are encrypted with.\"),\n    ],\n  },\n  // The docs site, a family resource with verbs like `key` (proposal 0082).\n  {\n    names: [\"site\"],\n    load: async () => [\n      (await import(\"./site/cli.js\"))\n        .buildProgram()\n        .name(\"site\")\n        .description(\"Start, build and preview the docs site\"),\n    ],\n  },\n  // The two family verbs (proposal 0078), and the only verbs the umbrella\n  // carries: each runs other domains' command cores and owns no checks.\n  {\n    names: [\"check\", \"status\"],\n    load: async () => {\n      const { buildCheck, buildStatus } = await import(\"./family/cli.js\");\n      return [buildCheck(), buildStatus()];\n    },\n  },\n];\n\nconst VERSION_FLAGS = new Set([\"-V\", \"--version\"]);\n\n/**\n * The domains a run with these arguments (argv after the script) dispatches\n * to. The umbrella's only options are `--version` and `--help`, so the first\n * argument is one of them or the command commander will look up.\n */\nfunction domainsFor(args: readonly string[]): readonly Domain[] {\n  const first = args[0];\n  if (first === undefined) return DOMAINS;\n  if (VERSION_FLAGS.has(first)) return [];\n  const named = DOMAINS.find((d) => d.names.includes(first));\n  return named === undefined ? DOMAINS : [named];\n}\n\nasync function mount(domains: readonly Domain[]): Promise<Command> {\n  const mounted = (await Promise.all(domains.map((d) => d.load()))).flat();\n  const metaCommands = new Set(\n    mounted.find((c) => c.name() === \"meta\")?.commands.map((c) => c.name()),\n  );\n\n  const program = new Command();\n  program\n    .name(\"manni\")\n    .description(\"Tools for documentation that is meant to be checked.\")\n    .version(pkg.version, \"-V, --version\")\n    // A pointer, not the whole help screen. Commander appends this after every\n    // usage error, and the message that precedes it already names the problem.\n    .showHelpAfterError(\"(add --help for usage)\")\n    // MUST come before `addCommand`, which copies the exit callback into the\n    // mounted program by value. See the same note in ./meta/cli.ts.\n    .exitOverride()\n    .configureOutput({\n      outputError: (str, write) => {\n        write(str);\n        // `manni validate …` is the most likely thing a docmeta user types\n        // first. Commander's \"unknown command\" is correct and unhelpful; say\n        // where the command went.\n        const m = /unknown command '([^']+)'/.exec(str);\n        const name = m?.[1];\n        if (name !== undefined && metaCommands.has(name)) {\n          write(\n            `(\\`${name}\\` is a metadata command: try \\`manni meta ${name}\\`)\\n`,\n          );\n        }\n      },\n    });\n\n  for (const command of mounted) program.addCommand(command);\n  return program;\n}\n\n/** The whole command tree, every domain mounted. */\nexport function buildProgram(): Promise<Command> {\n  return mount(DOMAINS);\n}\n\n/** The tree a run with these arguments needs: the one domain they name, or all of them. */\nexport function buildProgramFor(args: readonly string[]): Promise<Command> {\n  return mount(domainsFor(args));\n}\n\nrunIfMain(import.meta.url, () => buildProgramFor(process.argv.slice(2)));\n"],"mappings":";;;;;;;;;;;;AAkBA,SAAS,eAAe;AAWxB,IAAM,UAA6B;AAAA,EACjC;AAAA,IACE,OAAO,CAAC,MAAM;AAAA,IACd,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,mBAAe,GAC1B,aAAa,EACb,KAAK,MAAM,EACX;AAAA,QACC;AAAA,MACF;AAAA,IACJ;AAAA,EACF;AAAA,EACA;AAAA,IACE,OAAO,CAAC,MAAM;AAAA,IACd,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,mBAAe,GAC1B,aAAa,EACb,KAAK,MAAM,EACX;AAAA,QACC;AAAA,MACF;AAAA,IACJ;AAAA,EACF;AAAA,EACA;AAAA,IACE,OAAO,CAAC,MAAM;AAAA,IACd,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,mBAAe,GAC1B,aAAa,EACb,KAAK,MAAM,EACX;AAAA,QACC;AAAA,MACF;AAAA,IACJ;AAAA,EACF;AAAA,EACA;AAAA,IACE,OAAO,CAAC,MAAM;AAAA,IACd,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,mBAAe,GAC1B,aAAa,EACb,KAAK,MAAM,EACX;AAAA,QACC;AAAA,MACF;AAAA,IACJ;AAAA,EACF;AAAA,EACA;AAAA,IACE,OAAO,CAAC,UAAU;AAAA,IAClB,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,mBAAmB,GAC9B,aAAa,EACb,KAAK,UAAU,EACf;AAAA,QACC;AAAA,MACF;AAAA,IACJ;AAAA,EACF;AAAA,EACA;AAAA,IACE,OAAO,CAAC,MAAM;AAAA,IACd,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,oBAAiB,GAC5B,aAAa,EACb,KAAK,MAAM,EACX,YAAY,sEAAsE;AAAA,IACvF;AAAA,EACF;AAAA,EACA;AAAA,IACE,OAAO,CAAC,OAAO;AAAA,IACf,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,mBAAgB,GAC3B,aAAa,EACb,KAAK,OAAO,EACZ;AAAA,QACC;AAAA,MACF;AAAA,IACJ;AAAA,EACF;AAAA,EACA;AAAA,IACE,OAAO,CAAC,WAAW;AAAA,IACnB,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,mBAAoB,GAC/B,aAAa,EACb,KAAK,WAAW,EAChB;AAAA,QACC;AAAA,MACF;AAAA,IACJ;AAAA,EACF;AAAA;AAAA,EAEA;AAAA,IACE,OAAO,CAAC,KAAK;AAAA,IACb,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,mBAAc,GACzB,aAAa,EACb,KAAK,KAAK,EACV,YAAY,yEAAyE;AAAA,IAC1F;AAAA,EACF;AAAA;AAAA,EAEA;AAAA,IACE,OAAO,CAAC,MAAM;AAAA,IACd,MAAM,YAAY;AAAA,OACf,MAAM,OAAO,mBAAe,GAC1B,aAAa,EACb,KAAK,MAAM,EACX,YAAY,wCAAwC;AAAA,IACzD;AAAA,EACF;AAAA;AAAA;AAAA,EAGA;AAAA,IACE,OAAO,CAAC,SAAS,QAAQ;AAAA,IACzB,MAAM,YAAY;AAChB,YAAM,EAAE,YAAY,YAAY,IAAI,MAAM,OAAO,mBAAiB;AAClE,aAAO,CAAC,WAAW,GAAG,YAAY,CAAC;AAAA,IACrC;AAAA,EACF;AACF;AAEA,IAAM,gBAAgB,oBAAI,IAAI,CAAC,MAAM,WAAW,CAAC;AAOjD,SAAS,WAAW,MAA4C;AAC9D,QAAM,QAAQ,KAAK,CAAC;AACpB,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,cAAc,IAAI,KAAK,EAAG,QAAO,CAAC;AACtC,QAAM,QAAQ,QAAQ,KAAK,CAAC,MAAM,EAAE,MAAM,SAAS,KAAK,CAAC;AACzD,SAAO,UAAU,SAAY,UAAU,CAAC,KAAK;AAC/C;AAEA,eAAe,MAAM,SAA8C;AACjE,QAAM,WAAW,MAAM,QAAQ,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,KAAK;AACvE,QAAM,eAAe,IAAI;AAAA,IACvB,QAAQ,KAAK,CAAC,MAAM,EAAE,KAAK,MAAM,MAAM,GAAG,SAAS,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;AAAA,EACxE;AAEA,QAAM,UAAU,IAAI,QAAQ;AAC5B,UACG,KAAK,OAAO,EACZ,YAAY,sDAAsD,EAClE,QAAQ,gBAAI,SAAS,eAAe,EAGpC,mBAAmB,wBAAwB,EAG3C,aAAa,EACb,gBAAgB;AAAA,IACf,aAAa,CAAC,KAAK,UAAU;AAC3B,YAAM,GAAG;AAIT,YAAM,IAAI,4BAA4B,KAAK,GAAG;AAC9C,YAAM,OAAO,IAAI,CAAC;AAClB,UAAI,SAAS,UAAa,aAAa,IAAI,IAAI,GAAG;AAChD;AAAA,UACE,MAAM,IAAI,8CAA8C,IAAI;AAAA;AAAA,QAC9D;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AAEH,aAAW,WAAW,QAAS,SAAQ,WAAW,OAAO;AACzD,SAAO;AACT;AAGO,SAAS,eAAiC;AAC/C,SAAO,MAAM,OAAO;AACtB;AAGO,SAAS,gBAAgB,MAA2C;AACzE,SAAO,MAAM,WAAW,IAAI,CAAC;AAC/B;AAEA,UAAU,YAAY,KAAK,MAAM,gBAAgB,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC;","names":[]}
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["/**\n * The `manni` CLI: one bin, one subcommand per tool in the family.\n *\n * Each tool builds its own commander program and is mounted here under its\n * name, so `manni meta validate …` is the metadata tool's `validate` with\n * nothing in between. The umbrella owns only what is common to all of them:\n * the name, the version, and the exit-code contract in `runProgram`.\n *\n * Tools land here one at a time, on their own branches; until one merges its\n * subcommand does not exist.\n *\n * Every domain is imported on demand. A domain's module graph is its whole\n * dependency tree (Playwright, axe, Asciidoctor, the RDF stack, ajv), and a\n * hook runs `manni check` after every edit, so the bin mounts only the domain\n * argv names. `--version` mounts none. Anything else (`--help`, a bare\n * `manni`, a typo) mounts them all, so help and \"unknown command\" read as\n * they always did.\n */\nimport { Command } from \"commander\";\nimport pkg from \"../package.json\" with { type: \"json\" };\nimport { runIfMain } from \"./shared/run.js\";\nimport { registerTermLabelSource } from \"./shared/term-labels.js\";\n\n// `meta fill` offers the termbase's labels, but `manni meta fill` mounts only\n// the meta domain. So the umbrella registers the source, and the source loads\n// the term domain only when `fill` asks it for labels.\nregisterTermLabelSource(async (request) =>\n  (await import(\"./term/commands/labels.js\")).termLabels(request),\n);\n\ninterface Domain {\n  /** The command names the loader mounts, known before it is loaded. */\n  names: readonly string[];\n  load: () => Promise<Command[]>;\n}\n\n// In the order `manni --help` lists them.\nconst DOMAINS: readonly Domain[] = [\n  {\n    names: [\"meta\"],\n    load: async () => [\n      (await import(\"./meta/cli.js\"))\n        .buildProgram()\n        .name(\"meta\")\n        .description(\n          \"Validate, read, query and fill document metadata against JSON Schema\",\n        ),\n    ],\n  },\n  {\n    names: [\"a11y\"],\n    load: async () => [\n      (await import(\"./a11y/cli.js\"))\n        .buildProgram()\n        .name(\"a11y\")\n        .description(\n          \"Crawl a site and check every page for accessibility violations with axe-core\",\n        ),\n    ],\n  },\n  {\n    names: [\"cite\"],\n    load: async () => [\n      (await import(\"./cite/cli.js\"))\n        .buildProgram()\n        .name(\"cite\")\n        .description(\n          \"Track citations from doc claims to source lines and check them for drift\",\n        ),\n    ],\n  },\n  {\n    names: [\"lint\"],\n    load: async () => [\n      (await import(\"./lint/cli.js\"))\n        .buildProgram()\n        .name(\"lint\")\n        .description(\n          \"Validate document structure against doctype templates, routed by a page's type\",\n        ),\n    ],\n  },\n  {\n    names: [\"docevals\"],\n    load: async () => [\n      (await import(\"./docevals/cli.js\"))\n        .buildProgram()\n        .name(\"docevals\")\n        .description(\n          \"Deterministic and LLM-as-judge evals for documentation pages, driven by frontmatter\",\n        ),\n    ],\n  },\n  {\n    names: [\"term\"],\n    load: async () => [\n      (await import(\"./term/index.js\"))\n        .buildProgram()\n        .name(\"term\")\n        .description(\"Check, lint and render a docset's terms and the references into them\"),\n    ],\n  },\n  {\n    names: [\"test\"],\n    load: async () => [\n      (await import(\"./test/cli.js\"))\n        .buildProgram()\n        .name(\"test\")\n        .description(\"Run the docs' procedure tests with Doc Detective and report in the family contract\"),\n    ],\n  },\n  {\n    names: [\"graph\"],\n    load: async () => [\n      (await import(\"./graph/cli.js\"))\n        .buildProgram()\n        .name(\"graph\")\n        .description(\n          \"Deterministic knowledge graphs derived from documentation frontmatter and formatting\",\n        ),\n    ],\n  },\n  {\n    names: [\"tracevals\"],\n    load: async () => [\n      (await import(\"./tracevals/cli.js\"))\n        .buildProgram()\n        .name(\"tracevals\")\n        .description(\n          \"Deterministic and LLM-as-judge adherence evals for AI agent session traces\",\n        ),\n    ],\n  },\n  // Not a tool but a family resource with verbs (proposal 0045).\n  {\n    names: [\"key\"],\n    load: async () => [\n      (await import(\"./key/cli.js\"))\n        .buildProgram()\n        .name(\"key\")\n        .description(\"Set and rotate the family key that encrypted values are encrypted with.\"),\n    ],\n  },\n  // The docs site, a family resource with verbs like `key` (proposal 0082).\n  {\n    names: [\"site\"],\n    load: async () => [\n      (await import(\"./site/cli.js\"))\n        .buildProgram()\n        .name(\"site\")\n        .description(\"Start, build and preview the docs site\"),\n    ],\n  },\n  // The two family verbs (proposal 0078), and the only verbs the umbrella\n  // carries: each runs other domains' command cores and owns no checks.\n  {\n    names: [\"check\", \"status\"],\n    load: async () => {\n      const { buildCheck, buildStatus } = await import(\"./family/cli.js\");\n      return [buildCheck(), buildStatus()];\n    },\n  },\n];\n\nconst VERSION_FLAGS = new Set([\"-V\", \"--version\"]);\n\n/**\n * The domains a run with these arguments (argv after the script) dispatches\n * to. The umbrella's only options are `--version` and `--help`, so the first\n * argument is one of them or the command commander will look up.\n */\nfunction domainsFor(args: readonly string[]): readonly Domain[] {\n  const first = args[0];\n  if (first === undefined) return DOMAINS;\n  if (VERSION_FLAGS.has(first)) return [];\n  const named = DOMAINS.find((d) => d.names.includes(first));\n  return named === undefined ? DOMAINS : [named];\n}\n\nasync function mount(domains: readonly Domain[]): Promise<Command> {\n  const mounted = (await Promise.all(domains.map((d) => d.load()))).flat();\n  const metaCommands = new Set(\n    mounted.find((c) => c.name() === \"meta\")?.commands.map((c) => c.name()),\n  );\n\n  const program = new Command();\n  program\n    .name(\"manni\")\n    .description(\"Tools for documentation that is meant to be checked.\")\n    .version(pkg.version, \"-V, --version\")\n    // A pointer, not the whole help screen. Commander appends this after every\n    // usage error, and the message that precedes it already names the problem.\n    .showHelpAfterError(\"(add --help for usage)\")\n    // MUST come before `addCommand`, which copies the exit callback into the\n    // mounted program by value. See the same note in ./meta/cli.ts.\n    .exitOverride()\n    .configureOutput({\n      outputError: (str, write) => {\n        write(str);\n        // `manni validate …` is the most likely thing a docmeta user types\n        // first. Commander's \"unknown command\" is correct and unhelpful; say\n        // where the command went.\n        const m = /unknown command '([^']+)'/.exec(str);\n        const name = m?.[1];\n        if (name !== undefined && metaCommands.has(name)) {\n          write(\n            `(\\`${name}\\` is a metadata command: try \\`manni meta ${name}\\`)\\n`,\n          );\n        }\n      },\n    });\n\n  for (const command of mounted) program.addCommand(command);\n  return program;\n}\n\n/** The whole command tree, every domain mounted. */\nexport function buildProgram(): Promise<Command> {\n  return mount(DOMAINS);\n}\n\n/** The tree a run with these arguments needs: the one domain they name, or all of them. */\nexport function buildProgramFor(args: readonly string[]): Promise<Command> {\n  return mount(domainsFor(args));\n}\n\nrunIfMain(import.meta.url, () => buildProgramFor(process.argv.slice(2)));\n"],"mappings":"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","names":[]}

package/dist/{config-TYXYQK3I.js → config-JJW75SBX.js}

@@ -5,14 +5,14 @@ import {
   discoverConfig,
   loadConfig,
   parseConfig
-} from "./chunk-GCKHSBEN.js";
+} from "./chunk-OKMTUAWO.js";
 import "./chunk-CU57HT2E.js";
-import "./chunk-NGTVREIH.js";
+import "./chunk-U6IHLEWT.js";
 import "./chunk-UKZNLVJW.js";
 import "./chunk-YNHZHSSM.js";
-import "./chunk-6M5VJOC2.js";
+import "./chunk-OTJOBZJ5.js";
 import "./chunk-HX44GB4Z.js";
-import "./chunk-QCHVR4ZM.js";
+import "./chunk-VM7VAFJW.js";
 import "./chunk-OWBRDNRZ.js";
 import "./chunk-G3T47CFV.js";
 import "./chunk-2H7UOFLK.js";
@@ -23,4 +23,4 @@ export {
   loadConfig,
   parseConfig
 };
-//# sourceMappingURL=config-TYXYQK3I.js.map
+//# sourceMappingURL=config-JJW75SBX.js.map

package/dist/docmeta.js

@@ -1,20 +1,23 @@
 #!/usr/bin/env node
 import {
   buildProgram
-} from "./chunk-6LR73NMO.js";
-import "./chunk-2W34HX2U.js";
-import "./chunk-KBG463UK.js";
-import "./chunk-QBVP3SQP.js";
-import "./chunk-G7XD4QH5.js";
+} from "./chunk-DLU5FCFT.js";
+import "./chunk-PS257NIU.js";
+import "./chunk-2OZF2VUB.js";
+import "./chunk-SGR7ZAVE.js";
+import "./chunk-QEAGL4V5.js";
+import "./chunk-SMHAYK6I.js";
+import "./chunk-DSWKBZWW.js";
+import "./chunk-RGLFV4KO.js";
+import "./chunk-MNH7QO4Z.js";
+import "./chunk-RNVYGWIC.js";
 import {
   runIfMain
 } from "./chunk-YEUYKR62.js";
-import "./chunk-RNVYGWIC.js";
-import "./chunk-MNH7QO4Z.js";
-import "./chunk-6M5VJOC2.js";
+import "./chunk-OTJOBZJ5.js";
 import "./chunk-HX44GB4Z.js";
-import "./chunk-QCHVR4ZM.js";
-import "./chunk-2BV4FBC7.js";
+import "./chunk-VM7VAFJW.js";
+import "./chunk-DHGB4JBG.js";
 import "./chunk-OWBRDNRZ.js";
 import "./chunk-G3T47CFV.js";
 import "./chunk-2H7UOFLK.js";

package/dist/docmeta.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/docmeta.ts"],"sourcesContent":["/**\n * The `docmeta` bin: the metadata tool under the name it had before it became\n * `manni meta`. Same program, same options, same exit codes, so a script or\n * workflow written against `docmeta …` keeps working. Only the usage line and\n * the stderr prefix say `docmeta`.\n */\nimport { buildProgram } from \"./meta/cli.js\";\nimport { runIfMain } from \"./shared/run.js\";\n\nrunIfMain(import.meta.url, () => buildProgram().name(\"docmeta\"));\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AASA,UAAU,YAAY,KAAK,MAAM,aAAa,EAAE,KAAK,SAAS,CAAC;","names":[]}
+{"version":3,"sources":["../src/docmeta.ts"],"sourcesContent":["/**\n * The `docmeta` bin: the metadata tool under the name it had before it became\n * `manni meta`. Same program, same options, same exit codes, so a script or\n * workflow written against `docmeta …` keeps working. Only the usage line and\n * the stderr prefix say `docmeta`.\n */\nimport { buildProgram } from \"./meta/cli.js\";\nimport { runIfMain } from \"./shared/run.js\";\n\nrunIfMain(import.meta.url, () => buildProgram().name(\"docmeta\"));\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AASA,UAAU,YAAY,KAAK,MAAM,aAAa,EAAE,KAAK,SAAS,CAAC;","names":[]}

package/dist/github-6VQKSB67.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import {
+  NAMES_ITS_SUBJECT,
+  findingMessage,
+  renderCheckGithub
+} from "./chunk-GQ3KRY3B.js";
+import "./chunk-OHUDZRLK.js";
+import "./chunk-AYVKN3PG.js";
+import "./chunk-24AJK2RG.js";
+import "./chunk-IKEWBMCN.js";
+import "./chunk-YUTVAMWW.js";
+import "./chunk-JSSM7VVV.js";
+import "./chunk-PS257NIU.js";
+import "./chunk-2OZF2VUB.js";
+import "./chunk-SGR7ZAVE.js";
+import "./chunk-QEAGL4V5.js";
+import "./chunk-SMHAYK6I.js";
+import "./chunk-DSWKBZWW.js";
+import "./chunk-RGLFV4KO.js";
+import "./chunk-MNH7QO4Z.js";
+import "./chunk-RNVYGWIC.js";
+import "./chunk-YEUYKR62.js";
+import "./chunk-OTJOBZJ5.js";
+import "./chunk-HX44GB4Z.js";
+import "./chunk-VM7VAFJW.js";
+import "./chunk-DHGB4JBG.js";
+import "./chunk-OWBRDNRZ.js";
+import "./chunk-G3T47CFV.js";
+import "./chunk-2H7UOFLK.js";
+export {
+  NAMES_ITS_SUBJECT,
+  findingMessage,
+  renderCheckGithub
+};
+//# sourceMappingURL=github-6VQKSB67.js.map

package/dist/github-RBSEM7ZK.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import {
+  renderFindingsGithub
+} from "./chunk-QNDDPXFR.js";
+import "./chunk-FKAZUZQU.js";
+import "./chunk-IKEWBMCN.js";
+import "./chunk-YUTVAMWW.js";
+import "./chunk-JSSM7VVV.js";
+import "./chunk-PS257NIU.js";
+import "./chunk-2OZF2VUB.js";
+import "./chunk-SGR7ZAVE.js";
+import "./chunk-QEAGL4V5.js";
+import "./chunk-SMHAYK6I.js";
+import "./chunk-DSWKBZWW.js";
+import "./chunk-RGLFV4KO.js";
+import "./chunk-77AINBYM.js";
+import "./chunk-MNH7QO4Z.js";
+import "./chunk-RNVYGWIC.js";
+import "./chunk-YEUYKR62.js";
+import "./chunk-OTJOBZJ5.js";
+import "./chunk-HX44GB4Z.js";
+import "./chunk-VM7VAFJW.js";
+import "./chunk-DHGB4JBG.js";
+import "./chunk-OWBRDNRZ.js";
+import "./chunk-G3T47CFV.js";
+import "./chunk-2H7UOFLK.js";
+export {
+  renderFindingsGithub
+};
+//# sourceMappingURL=github-RBSEM7ZK.js.map

package/dist/graph/runtime.d.ts

@@ -11,6 +11,8 @@ type Term = {
     kind: "literal";
     value: string;
     datatype?: string;
+    /** A language tag, for a literal that carries one. Never set with `datatype`. */
+    language?: string;
 };
 interface Quad {
     s: string;
@@ -41,6 +43,7 @@ type Value = {
     kind: "literal";
     value: string;
     datatype?: string;
+    language?: string;
 };
 interface GraphNode {
     id: string;
@@ -448,7 +451,7 @@ interface RdfQuad {
 }
 declare function namedNode(value: string): RdfTerm;
 declare function defaultGraph(): RdfTerm;
-declare function literal(value: string, datatype?: string): RdfTerm;
+declare function literal(value: string, datatype?: string, language?: string): RdfTerm;
 /**
  * The whole index as RDF/JS quads, in the index's deterministic order. Feed to
  * any RDF/JS store (`new Store(rdfjsQuads(graph))`) to run SPARQL.

package/dist/graph/runtime.js

@@ -32,7 +32,9 @@ function compareValues(a, b) {
   if (v !== 0) return v;
   const da = a.kind === "literal" ? a.datatype ?? "" : "";
   const db = b.kind === "literal" ? b.datatype ?? "" : "";
-  return byCodeUnit(da, db);
+  const la = a.kind === "literal" ? a.language ?? "" : "";
+  const lb = b.kind === "literal" ? b.language ?? "" : "";
+  return byCodeUnit(da, db) || byCodeUnit(la, lb);
 }
 var GraphIndex = class _GraphIndex {
   nodes = /* @__PURE__ */ new Map();
@@ -67,7 +69,7 @@ var GraphIndex = class _GraphIndex {
     const index = new _GraphIndex({ ...context });
     for (const q of quads) {
       const o = q.o;
-      const value = o.kind === "iri" ? { kind: "iri", value: o.value } : o.datatype && o.datatype !== XSD_STRING ? { kind: "literal", value: o.value, datatype: o.datatype } : { kind: "literal", value: o.value };
+      const value = o.kind === "iri" ? { kind: "iri", value: o.value } : o.language ? { kind: "literal", value: o.value, language: o.language } : o.datatype && o.datatype !== XSD_STRING ? { kind: "literal", value: o.value, datatype: o.datatype } : { kind: "literal", value: o.value };
       index.addTriple(q.s, q.p, value);
     }
     index.finalize();
@@ -124,6 +126,9 @@ var GraphIndex = class _GraphIndex {
       if (o["@value"] !== void 0) {
         const raw = o["@value"];
         const lexical = typeof raw === "string" ? raw : JSON.stringify(raw);
+        if (typeof o["@language"] === "string") {
+          return { kind: "literal", value: lexical, language: o["@language"] };
+        }
         const dt = typeof o["@type"] === "string" ? this.expand(o["@type"]) : void 0;
         return dt && dt !== XSD_STRING ? { kind: "literal", value: lexical, datatype: dt } : { kind: "literal", value: lexical };
       }
@@ -709,6 +714,11 @@ function sectionOwnText(markdown, title, level, occurrence = 0) {
 }
 function slice(markdown, title, level, occurrence, ownTextOnly) {
   const lines = markdown.split(/\r?\n/);
+  const span = locate(lines, title, level, occurrence, ownTextOnly);
+  if (span === void 0) return void 0;
+  return lines.slice(span.start, span.end).join("\n").trimEnd();
+}
+function locate(lines, title, level, occurrence, ownTextOnly) {
   const headings = sourceHeadings(lines);
   const wanted = headingKey(title);
   let remaining = occurrence;
@@ -726,8 +736,7 @@ function slice(markdown, title, level, occurrence, ownTextOnly) {
   const match = headings[found];
   if (match === void 0) return void 0;
   const next = headings.slice(found + 1).find((h) => ownTextOnly || h.level <= match.level);
-  const end = next?.start ?? lines.length;
-  return lines.slice(match.start, end).join("\n").trimEnd();
+  return { start: match.start, end: next?.start ?? lines.length };
 }
 function createFetchResolver(graph, options = {}) {
   const doFetch = options.fetch ?? ((url) => globalThis.fetch(url));
@@ -860,6 +869,7 @@ async function assemble(resolver, nodes, options = {}) {
 
 // src/graph/runtime/rdfjs.ts
 var XSD_STRING2 = "http://www.w3.org/2001/XMLSchema#string";
+var RDF_LANG_STRING = "http://www.w3.org/1999/02/22-rdf-syntax-ns#langString";
 function namedNode(value) {
   return {
     termType: "NamedNode",
@@ -878,20 +888,21 @@ function defaultGraph() {
     }
   };
 }
-function literal(value, datatype) {
-  const dt = namedNode(datatype ?? XSD_STRING2);
+function literal(value, datatype, language) {
+  const lang = language ?? "";
+  const dt = namedNode(lang ? RDF_LANG_STRING : datatype ?? XSD_STRING2);
   return {
     termType: "Literal",
     value,
-    language: "",
+    language: lang,
     datatype: dt,
     equals(other) {
-      return !!other && other.termType === "Literal" && other.value === value && !!other.datatype && other.datatype.value === dt.value;
+      return !!other && other.termType === "Literal" && other.value === value && (other.language ?? "") === lang && !!other.datatype && other.datatype.value === dt.value;
     }
   };
 }
 function toTerm(v) {
-  return v.kind === "iri" ? namedNode(v.value) : literal(v.value, v.datatype);
+  return v.kind === "iri" ? namedNode(v.value) : literal(v.value, v.datatype, v.language);
 }
 function makeQuad(s, p, o) {
   const subject = namedNode(s);