@hawkeyexl/manni 4.11.0 → 4.12.1

package/dist/{cli-VID7PJS3.js.map → cli-RKQX4TI3.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/docevals/cli.ts"],"sourcesContent":["/**\n * The docevals program. Named `docevals` because that is where it is mounted\n * (`manni docevals …`); `src/cli.ts` adds it to the umbrella and runs it.\n */\nimport { Command } from \"commander\";\nimport pkg from \"../../package.json\" with { type: \"json\" };\nimport { fail } from \"../shared/run.js\";\nimport { notice } from \"../shared/warn.js\";\nimport { terminalConfirm } from \"../shared/prompt.js\";\nimport { collect, configOption } from \"../shared/cli-options.js\";\nimport { LOCAL_FLAG_HELP } from \"../shared/providers.js\";\nimport type { DocumentInputOptions } from \"./core/discover.js\";\nimport { colorFor, palette } from \"../shared/color.js\";\nimport { DocevalsError } from \"./types.js\";\nimport { allowExecutionMessage, isExecutionGrant } from \"../shared/execution.js\";\nimport { runList, renderList } from \"./commands/list.js\";\nimport { runRun } from \"./commands/run.js\";\nimport { runGenerate } from \"./commands/generate.js\";\nimport { runFill, renderFill } from \"./commands/fill.js\";\nimport { runPromote } from \"./commands/promote.js\";\nimport { listReviews, renderReviews, runReview } from \"./commands/review.js\";\nimport {\n  runCalibrate,\n  renderCalibration,\n  seedGoldenCases,\n} from \"./commands/calibrate.js\";\nimport { runInit } from \"./commands/init.js\";\nimport {\n  render,\n  parseFormat,\n  REPORT_FORMATS,\n  SUMMARY_FORMATS,\n  type ReportFormat,\n  type SummaryFormat,\n} from \"./reporters/index.js\";\n\n/**\n * Whether `command`'s output gets colour: the family's rule, read off this\n * domain's `--no-color`. Exported for the tests that pin it.\n */\nexport { colorFor };\n\nexport function buildProgram(): Command {\n  const program = new Command();\n\n  program\n    .name(\"docevals\")\n    .description(\n      \"Deterministic and LLM-as-judge evals for documentation pages, driven by frontmatter.\",\n    )\n    .version(pkg.version)\n    .option(\"--no-color\", \"disable colored output\")\n    // A pointer, not the whole help screen: the message that precedes it\n    // already names the offending flag.\n    .showHelpAfterError(\"(add --help for usage)\")\n    // MUST come before the `.command()` calls below. `copyInheritedSettings`\n    // copies `_exitCallback` by value at subcommand-creation time, so an\n    // `exitOverride()` installed afterwards leaves every subcommand calling\n    // `process.exit(1)` on a parse error, which is a usage error owed exit 2.\n    .exitOverride();\n\n  /**\n   * Repeatable execution grant, validated on the way in.\n   *\n   * An unknown value is a usage error rather than a silent no-op (ADR 01007, the\n   * same rule `--format` follows): a mistyped grant that quietly granted nothing\n   * would skip every command eval and still exit 0, which reads as \"the corpus\n   * is clean\" rather than \"you misspelled a flag\".\n   */\n  function collectGrant(value: string, previous: string[]): string[] {\n    if (!isExecutionGrant(value)) {\n      fail(new DocevalsError(allowExecutionMessage(value)));\n    }\n    return [...previous, value];\n  }\n\n  function parseIntArg(name: string) {\n    return (value: string): number => {\n      const n = Number.parseInt(value, 10);\n      if (Number.isNaN(n) || n < 1) {\n        fail(new DocevalsError(`${name} must be a positive integer, got \"${value}\"`));\n      }\n      return n;\n    };\n  }\n\n  /**\n   * Repeatable single-value option, e.g. `--eval a --eval b`.\n   *\n   * NOT commander's variadic `<name...>`: a variadic consumes every following\n   * non-option token, so `run --eval fresh-enough docs/guide.md` parsed the glob\n   * as a second eval name and left `globs` empty — silently widening the run to\n   * the whole configured corpus, which is the opposite of what selection is for.\n   */\n  function collectArg(value: string, previous: string[]): string[] {\n    return [...previous, value];\n  }\n\n  function parseFloatArg(name: string) {\n    return (value: string): number => {\n      const n = Number.parseFloat(value);\n      if (Number.isNaN(n) || n < 0) {\n        fail(new DocevalsError(`${name} must be a non-negative number, got \"${value}\"`));\n      }\n      return n;\n    };\n  }\n\n  /**\n   * Commander argument parser for `-f/--format` (ADR 01007). Routes through\n   * `fail()` for the same reason the numeric parsers do: commander only special-\n   * cases InvalidArgumentError, so any other exception escapes `program.parse()`\n   * uncaught — a stack trace and exit 1, when a bad flag owes exit 2.\n   */\n  function parseFormatArg<T extends string>(name: string, allowed: readonly T[]) {\n    return (value: string): T => {\n      try {\n        return parseFormat(value, allowed, name);\n      } catch (e) {\n        fail(e);\n      }\n    };\n  }\n\n  /**\n   * The document-set surface every verb that reads pages shares (proposal\n   * 0041): positional `[paths...]`, `--collection` and `--exclude` (each one\n   * value per occurrence), and `-c`/`--no-config`. Declared once so the five\n   * verbs cannot drift apart on a name or a description.\n   */\n  function documentInputs(command: Command, verb: string): Command {\n    return command\n      .argument(\n        \"[paths...]\",\n        `Files, directories, or globs to ${verb} (default: the configured collections)`,\n      )\n      .option(\n        \"--collection <name>\",\n        \"Configured collection to read (repeatable)\",\n        collect,\n        [],\n      )\n      .option(\"--exclude <glob>\", \"Glob to exclude (repeatable)\", collect, [])\n      .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n      .option(\"--no-config\", \"Ignore any discovered config file\");\n  }\n\n  /** The shared options as the command cores take them. */\n  function documentOptions(opts: {\n    collection?: string[];\n    exclude?: string[];\n    config?: string | boolean;\n  }): DocumentInputOptions {\n    const { configPath, noConfig } = configOption(opts.config);\n    return {\n      ...(configPath === undefined ? {} : { config: configPath }),\n      ...(noConfig === true ? { noConfig } : {}),\n      ...(opts.collection === undefined ? {} : { collection: opts.collection }),\n      ...(opts.exclude === undefined ? {} : { exclude: opts.exclude }),\n    };\n  }\n\n  documentInputs(\n    program\n      .command(\"list\")\n      .description(\"Show the resolved eval plan per page without running anything\"),\n    \"list\",\n  )\n    .option(\n      \"-f, --format <format>\",\n      `Output format: ${SUMMARY_FORMATS.join(\" | \")}`,\n      parseFormatArg(\"--format\", SUMMARY_FORMATS),\n      \"pretty\" as SummaryFormat,\n    )\n    .option(\"--eval <name>\", \"Show only this eval (repeatable)\", collectArg, [])\n    .option(\"--suite <name>\", \"Show only evals in this suite\")\n    .action(\n      async (\n        paths: string[],\n        opts: {\n          config?: string | boolean;\n          collection?: string[];\n          exclude?: string[];\n          format: SummaryFormat;\n          eval?: string[];\n          suite?: string;\n        },\n        command: Command,\n      ) => {\n      try {\n        const run = await runList(paths, {\n          ...documentOptions(opts),\n          format: opts.format,\n          evalNames: opts.eval,\n          suite: opts.suite,\n        });\n        console.log(\n          renderList(run, opts.format, {\n            color: colorFor(command, process.stdout.isTTY),\n          }),\n        );\n        process.exitCode = run.exitCode;\n      } catch (e) {\n        fail(e);\n      }\n    });\n\n  documentInputs(\n    program.command(\"run\").description(\"Run evals against documentation pages\"),\n    \"evaluate\",\n  )\n    .option(\n      \"-f, --format <format>\",\n      `Output format: ${REPORT_FORMATS.join(\" | \")}`,\n      parseFormatArg(\"--format\", REPORT_FORMATS),\n      \"pretty\" as ReportFormat,\n    )\n    .option(\"--deterministic-only\", \"Run only command/tool graders, skip the AI judge\")\n    .option(\"--ai-only\", \"Run only AI-judged evals, skip deterministic graders\")\n    .option(\n      // `<kind>`, not `<kind...>`: a variadic option greedily eats the\n      // positional `[paths...]` that follow it, so `--allow-execution\n      // frontmatter-commands docs/**` would silently swallow the glob and run\n      // over the default file set instead. Repeat the flag to grant twice.\n      \"--allow-execution <kind>\",\n      \"Run only these execution grants (repeatable): frontmatter-commands\",\n      collectGrant,\n      [],\n    )\n    .option(\"--no-execution\", \"Clear every execution grant for this run\")\n    .option(\"--no-generate\", \"Do not generate scripts for command evals missing a command\")\n    .option(\"--no-cache\", \"Bypass the judge response cache\")\n    .option(\"--fail-on-review\", \"Exit 1 when any eval lands in the human-review zone\")\n    .option(\"--provider <name>\", \"Judge provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .option(\"--runs <n>\", \"Ensemble runs per eval\", parseIntArg(\"--runs\"))\n    .option(\n      \"--chunk-chars <n>\",\n      \"Characters of page per judge call; longer pages are read in parts\",\n      parseIntArg(\"--chunk-chars\"),\n    )\n    .option(\n      \"--eval <name>\",\n      \"Run only this eval (repeatable); suite targets are not evaluated on a filtered run\",\n      collectArg,\n      [],\n    )\n    .option(\"--suite <name>\", \"Run only evals in this suite\")\n    .option(\n      \"--since <ref>\",\n      \"Evaluate only pages whose file or eval manifest changed between this git ref and HEAD\",\n    )\n    .option(\n      \"--newer-than <duration>\",\n      \"Evaluate only pages whose file or eval manifest changed within this window, \" +\n        \"such as 30m, 24h, 7d or 2w; in CI, prefer --since\",\n    )\n    .option(\n      \"--max-turns <n>\",\n      \"Stop after this many ensemble runs (a cached ensemble costs none)\",\n      parseIntArg(\"--max-turns\"),\n    )\n    .option(\n      \"--baseline [path]\",\n      \"Fail only on findings a recorded baseline does not already hold\",\n    )\n    .option(\"--no-baseline\", \"Ignore the configured baseline for this run\")\n    .option(\n      \"--write-baseline [path]\",\n      \"Record this run's findings as the baseline; without a path, the configured one\",\n    )\n    .action(async (paths: string[], opts: Record<string, unknown>, command: Command) => {\n      try {\n        const report = await runRun(paths, {\n          ...documentOptions({\n            config: opts.config as string | boolean | undefined,\n            collection: opts.collection as string[] | undefined,\n            exclude: opts.exclude as string[] | undefined,\n          }),\n          // parseFormatArg validated this at parse time; the cast only re-narrows\n          // from the `unknown` that the Record-typed options bag erases it to.\n          format: opts.format as ReportFormat,\n          deterministicOnly: opts.deterministicOnly as boolean | undefined,\n          aiOnly: opts.aiOnly as boolean | undefined,\n          // Commander's default is `[]`, which is \"no flag\", not \"run nothing\":\n          // only a list someone typed narrows the run.\n          allowExecution:\n            (opts.allowExecution as string[]).length > 0\n              ? (opts.allowExecution as string[])\n              : undefined,\n          execution: opts.execution as boolean | undefined,\n          generate: opts.generate as boolean | undefined,\n          cache: opts.cache as boolean | undefined,\n          failOnReview: opts.failOnReview as boolean | undefined,\n          provider: opts.provider as string | undefined,\n          model: opts.model as string | undefined,\n          local: opts.local as boolean | undefined,\n          runs: opts.runs as number | undefined,\n          chunkChars: opts.chunkChars as number | undefined,\n          maxTurns: opts.maxTurns as number | undefined,\n          evalNames: opts.eval as string[] | undefined,\n          suite: opts.suite as string | undefined,\n          since: opts.since as string | undefined,\n          newerThan: opts.newerThan as string | undefined,\n          // commander collapses `--baseline` to true and `--no-baseline` to\n          // false on the same key; a string is an explicit path.\n          baseline: opts.baseline as string | boolean | undefined,\n          writeBaseline: opts.writeBaseline as string | boolean | undefined,\n          toolVersion: pkg.version,\n        });\n        console.log(\n          render(report, opts.format as ReportFormat, {\n            color: colorFor(command, process.stdout.isTTY),\n          }),\n        );\n        process.exitCode = report.exitCode;\n      } catch (e) {\n        fail(e);\n      }\n    });\n\n  documentInputs(\n    program\n      .command(\"generate\")\n      .description(\n        \"Generate check scripts for command evals with a plain-language assertion but no command\",\n      ),\n    \"read\",\n  )\n    .option(\"--provider <name>\", \"Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .action(\n      async (\n        paths: string[],\n        opts: {\n          config?: string | boolean;\n          collection?: string[];\n          exclude?: string[];\n          provider?: string;\n          model?: string;\n          local?: boolean;\n        },\n        command: Command,\n      ) => {\n        try {\n          const pc = palette(colorFor(command, process.stdout.isTTY));\n          const result = await runGenerate(paths, {\n            ...documentOptions(opts),\n            provider: opts.provider,\n            model: opts.model,\n            local: opts.local,\n          });\n          if (result.targets === 0) {\n            console.log(\"Nothing to generate — every command eval has a command.\");\n            return;\n          }\n          console.log(\n            `Generated ${result.generatedPaths.length}/${result.targets} check script(s):`,\n          );\n          for (const p of result.generatedPaths) console.log(`  ${p}`);\n          // Evals whose command reference had nowhere to go (proposal 0047).\n          for (const r of result.refusals) console.log(pc.red(`  ${r.message}`));\n          if (result.generatedPaths.length < result.targets) {\n            process.exitCode = 1;\n          }\n        } catch (e) {\n          fail(e);\n        }\n      },\n    );\n\n  documentInputs(\n    program\n      .command(\"fill\")\n      .description(\n        \"Propose frontmatter evals for pages with an LLM; writes proposals at or above the confidence threshold\",\n      ),\n    \"fill\",\n  )\n    .option(\n      \"-f, --format <format>\",\n      `Output format: ${SUMMARY_FORMATS.join(\" | \")}`,\n      parseFormatArg(\"--format\", SUMMARY_FORMATS),\n      \"pretty\" as SummaryFormat,\n    )\n    .option(\"--dry-run\", \"Report proposals without writing frontmatter\")\n    .option(\n      \"--confidence <n>\",\n      \"Minimum confidence to write (0-1, default: config fill.confidenceThreshold)\",\n      parseFloatArg(\"--confidence\"),\n    )\n    .option(\n      \"--max-turns <n>\",\n      \"Stop after this many inference calls (a cached page costs none)\",\n      parseIntArg(\"--max-turns\"),\n    )\n    .option(\"--no-cache\", \"Bypass the fill proposal cache\")\n    .option(\n      \"--chunk-chars <n>\",\n      \"Characters of page per fill call; longer pages are proposed in parts\",\n      parseIntArg(\"--chunk-chars\"),\n    )\n    .option(\"--provider <name>\", \"Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .action(async (paths: string[], opts: Record<string, unknown>, command: Command) => {\n      try {\n        const confidence = opts.confidence as number | undefined;\n        if (confidence !== undefined && confidence > 1) {\n          fail(new DocevalsError(`--confidence must be between 0 and 1, got ${confidence}`));\n        }\n        const report = await runFill(paths, {\n          ...documentOptions({\n            config: opts.config as string | boolean | undefined,\n            collection: opts.collection as string[] | undefined,\n            exclude: opts.exclude as string[] | undefined,\n          }),\n          dryRun: opts.dryRun as boolean | undefined,\n          confidence,\n          maxTurns: opts.maxTurns as number | undefined,\n          noCache: opts.cache === false ? true : undefined,\n          provider: opts.provider as string | undefined,\n          model: opts.model as string | undefined,\n          local: opts.local as boolean | undefined,\n          // P1 (proposal 0047): offered only on a terminal, where there is\n          // someone to answer. Off one the evals go to the page and the W1\n          // line says so.\n          confirm: terminalConfirm(),\n          onNotice: notice,\n          onRelocated: (result) => {\n            const manifests = result.manifests.map((m) => m.file).join(\", \");\n            notice(\n              `moved ${String(result.summary.moved)} value(s) into ${manifests}.`,\n            );\n          },\n        });\n        // As in `run`: parseFormatArg validated this at parse time, and the cast\n        // only re-narrows from the `unknown` the Record-typed options bag erases\n        // it to. renderFill guards itself regardless.\n        console.log(\n          renderFill(report, opts.format as SummaryFormat, {\n            color: colorFor(command, process.stdout.isTTY),\n          }),\n        );\n        process.exitCode = report.exitCode;\n      } catch (e) {\n        fail(e);\n      }\n    });\n\n  documentInputs(\n    program\n      .command(\"promote\")\n      .description(\n        \"Find ai-graded evals expressible as deterministic checks; --write converts them\",\n      ),\n    \"read\",\n  )\n    .option(\"--write\", \"Apply promotions (write scripts and rewrite evals)\")\n    .option(\"--provider <name>\", \"Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .action(\n      async (\n        paths: string[],\n        opts: {\n          config?: string | boolean;\n          collection?: string[];\n          exclude?: string[];\n          write?: boolean;\n          provider?: string;\n          model?: string;\n          local?: boolean;\n        },\n        command: Command,\n      ) => {\n        try {\n          const pc = palette(colorFor(command, process.stdout.isTTY));\n          const proposals = await runPromote(paths, {\n            ...documentOptions(opts),\n            write: opts.write,\n            provider: opts.provider,\n            model: opts.model,\n            local: opts.local,\n          });\n          if (proposals.length === 0) {\n            console.log(\"No ai-graded evals found.\");\n            return;\n          }\n          for (const p of proposals) {\n            const tag = p.promotable\n              ? p.applied\n                ? pc.green(\"promoted\")\n                : pc.cyan(\"promotable\")\n              : pc.dim(\"keep-ai\");\n            const script = p.scriptPath ? pc.dim(` -> ${p.scriptPath}`) : \"\";\n            console.log(`${tag} ${p.evalName} (${p.source}, ${p.file})${script}`);\n            console.log(pc.dim(`  ${p.rationale}`));\n            // Promotable, and nowhere to write it (proposal 0047).\n            if (p.error !== undefined) console.log(pc.red(`  ${p.error}`));\n          }\n          if (!opts.write && proposals.some((p) => p.promotable)) {\n            console.log(pc.cyan(\"\\nRe-run with --write to apply promotions.\"));\n          }\n        } catch (e) {\n          fail(e);\n        }\n      },\n    );\n\n  program\n    .command(\"calibrate\")\n    .description(\n      \"Measure judge agreement against a human-verified golden set (.manni/docevals/golden/*.yaml)\",\n    )\n    .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n    .option(\"--golden <dir>\", \"Golden set directory\", \".manni/docevals/golden\")\n    .option(\n      \"--seed\",\n      \"Write golden candidates from recorded reviews and exit; judges nothing, needs no provider\",\n    )\n    .option(\"--provider <name>\", \"Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .option(\"--runs <n>\", \"Ensemble runs per case\", parseIntArg(\"--runs\"))\n    .option(\n      \"--max-turns <n>\",\n      \"Stop after this many ensemble runs (a cached ensemble costs none)\",\n      parseIntArg(\"--max-turns\"),\n    )\n    .option(\"--no-cache\", \"Bypass the judge response cache\")\n    .action(\n      async (opts: {\n        config?: string;\n        golden?: string;\n        seed?: boolean;\n        provider?: string;\n        model?: string;\n        local?: boolean;\n        runs?: number;\n        maxTurns?: number;\n        cache?: boolean;\n      }, command: Command) => {\n        try {\n          const color = colorFor(command, process.stdout.isTTY);\n          const pc = palette(color);\n          if (opts.seed) {\n            // No `config`: reviews.yaml and the golden directory both resolve\n            // against the working directory, not the config's, so passing it\n            // would imply an influence it does not have.\n            const seeded = seedGoldenCases({ golden: opts.golden });\n            if (seeded.total === 0) {\n              console.log(\n                \"No recorded reviews to seed from — run `manni docevals review <file> <eval> <pass|fail>` first.\",\n              );\n              return;\n            }\n            // The lead number is what moved, not the file's size: `total`\n            // counts cases already confirmed and left alone, so leading with it\n            // read as \"wrote 8 candidates\" on a re-seed that wrote none.\n            const changed = seeded.added + seeded.updated;\n            console.log(\n              changed === 0\n                ? `No new reviews to seed — ${seeded.total} golden case(s) already in ${seeded.path}.`\n                : `Wrote ${changed} golden candidate(s) to ${seeded.path} ` +\n                  `(${seeded.added} new, ${seeded.updated} updated; ${seeded.total} total).`,\n            );\n            if (seeded.unreviewed > 0) {\n              console.log(\n                pc.yellow(\n                  `${seeded.unreviewed} case(s) are \\`reviewed: false\\`. Read them and set ` +\n                    \"`reviewed: true` — a golden set assembled without a human is not one.\",\n                ),\n              );\n            }\n            return;\n          }\n          const report = await runCalibrate({\n            config: opts.config,\n            golden: opts.golden,\n            provider: opts.provider,\n            model: opts.model,\n            local: opts.local,\n            runs: opts.runs,\n            maxTurns: opts.maxTurns,\n            noCache: opts.cache === false,\n          });\n          console.log(renderCalibration(report, { color }));\n          // Both conditions: the judge has to agree enough, AND the set has to\n          // have been measured. A stale golden file whose pages were renamed\n          // used to certify on whatever still resolved.\n          process.exitCode =\n            report.meetsThreshold &&\n            report.unjudged === 0 &&\n            report.balanced\n              ? 0\n              : 1;\n        } catch (e) {\n          fail(e);\n        }\n      },\n    );\n\n  program\n    .command(\"init\")\n    .description(\"Create a starter manni.config.yaml in the current directory\")\n    .action(() => {\n      try {\n        console.log(`Created ${runInit()}`);\n      } catch (e) {\n        fail(e);\n      }\n    });\n\n  program\n    .command(\"review\")\n    .description(\n      \"Record a human verdict for an eval in the human-review zone (or list recorded reviews)\",\n    )\n    .argument(\"[file]\", \"Page path\")\n    .argument(\"[eval]\", \"Eval name\")\n    .argument(\"[verdict]\", \"pass | fail\")\n    .option(\"--reviewer <name>\", \"Reviewer name recorded with the verdict\")\n    .option(\"--note <text>\", \"Optional note\")\n    .action(\n      (\n        file: string | undefined,\n        evalName: string | undefined,\n        verdict: string | undefined,\n        opts: { reviewer?: string; note?: string },\n        command: Command,\n      ) => {\n        try {\n          if (!file) {\n            console.log(\n              renderReviews(listReviews(), {\n                color: colorFor(command, process.stdout.isTTY),\n              }),\n            );\n            return;\n          }\n          if (!evalName || !verdict) {\n            throw new DocevalsError(\n              \"Usage: manni docevals review <file> <eval> <pass|fail>\",\n            );\n          }\n          const entry = runReview(file, evalName, verdict, opts);\n          console.log(\n            `Recorded ${entry.verdict} for ${entry.evalName} on ${entry.file}`,\n          );\n        } catch (e) {\n          fail(e);\n        }\n      },\n    );\n\n  return program;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/docevals/cli.ts"],"sourcesContent":["/**\n * The docevals program. Named `docevals` because that is where it is mounted\n * (`manni docevals …`); `src/cli.ts` adds it to the umbrella and runs it.\n */\nimport { Command } from \"commander\";\nimport pkg from \"../../package.json\" with { type: \"json\" };\nimport { fail } from \"../shared/run.js\";\nimport { notice } from \"../shared/warn.js\";\nimport { terminalConfirm } from \"../shared/prompt.js\";\nimport { collect, configOption } from \"../shared/cli-options.js\";\nimport { LOCAL_FLAG_HELP } from \"../shared/providers.js\";\nimport type { DocumentInputOptions } from \"./core/discover.js\";\nimport { colorFor, palette } from \"../shared/color.js\";\nimport { DocevalsError } from \"./types.js\";\nimport { allowExecutionMessage, isExecutionGrant } from \"../shared/execution.js\";\nimport { runList, renderList } from \"./commands/list.js\";\nimport { runRun } from \"./commands/run.js\";\nimport { runGenerate } from \"./commands/generate.js\";\nimport { runFill, renderFill } from \"./commands/fill.js\";\nimport { runPromote } from \"./commands/promote.js\";\nimport { listReviews, renderReviews, runReview } from \"./commands/review.js\";\nimport {\n  runCalibrate,\n  renderCalibration,\n  seedGoldenCases,\n} from \"./commands/calibrate.js\";\nimport { runInit } from \"./commands/init.js\";\nimport {\n  render,\n  parseFormat,\n  REPORT_FORMATS,\n  SUMMARY_FORMATS,\n  type ReportFormat,\n  type SummaryFormat,\n} from \"./reporters/index.js\";\n\n/**\n * Whether `command`'s output gets colour: the family's rule, read off this\n * domain's `--no-color`. Exported for the tests that pin it.\n */\nexport { colorFor };\n\nexport function buildProgram(): Command {\n  const program = new Command();\n\n  program\n    .name(\"docevals\")\n    .description(\n      \"Deterministic and LLM-as-judge evals for documentation pages, driven by frontmatter.\",\n    )\n    .version(pkg.version)\n    .option(\"--no-color\", \"disable colored output\")\n    // A pointer, not the whole help screen: the message that precedes it\n    // already names the offending flag.\n    .showHelpAfterError(\"(add --help for usage)\")\n    // MUST come before the `.command()` calls below. `copyInheritedSettings`\n    // copies `_exitCallback` by value at subcommand-creation time, so an\n    // `exitOverride()` installed afterwards leaves every subcommand calling\n    // `process.exit(1)` on a parse error, which is a usage error owed exit 2.\n    .exitOverride();\n\n  /**\n   * Repeatable execution grant, validated on the way in.\n   *\n   * An unknown value is a usage error rather than a silent no-op (ADR 01007, the\n   * same rule `--format` follows): a mistyped grant that quietly granted nothing\n   * would skip every command eval and still exit 0, which reads as \"the corpus\n   * is clean\" rather than \"you misspelled a flag\".\n   */\n  function collectGrant(value: string, previous: string[]): string[] {\n    if (!isExecutionGrant(value)) {\n      fail(new DocevalsError(allowExecutionMessage(value)));\n    }\n    return [...previous, value];\n  }\n\n  function parseIntArg(name: string) {\n    return (value: string): number => {\n      const n = Number.parseInt(value, 10);\n      if (Number.isNaN(n) || n < 1) {\n        fail(new DocevalsError(`${name} must be a positive integer, got \"${value}\"`));\n      }\n      return n;\n    };\n  }\n\n  /**\n   * Repeatable single-value option, e.g. `--eval a --eval b`.\n   *\n   * NOT commander's variadic `<name...>`: a variadic consumes every following\n   * non-option token, so `run --eval fresh-enough docs/guide.md` parsed the glob\n   * as a second eval name and left `globs` empty — silently widening the run to\n   * the whole configured corpus, which is the opposite of what selection is for.\n   */\n  function collectArg(value: string, previous: string[]): string[] {\n    return [...previous, value];\n  }\n\n  function parseFloatArg(name: string) {\n    return (value: string): number => {\n      const n = Number.parseFloat(value);\n      if (Number.isNaN(n) || n < 0) {\n        fail(new DocevalsError(`${name} must be a non-negative number, got \"${value}\"`));\n      }\n      return n;\n    };\n  }\n\n  /**\n   * Commander argument parser for `-f/--format` (ADR 01007). Routes through\n   * `fail()` for the same reason the numeric parsers do: commander only special-\n   * cases InvalidArgumentError, so any other exception escapes `program.parse()`\n   * uncaught — a stack trace and exit 1, when a bad flag owes exit 2.\n   */\n  function parseFormatArg<T extends string>(name: string, allowed: readonly T[]) {\n    return (value: string): T => {\n      try {\n        return parseFormat(value, allowed, name);\n      } catch (e) {\n        fail(e);\n      }\n    };\n  }\n\n  /**\n   * The document-set surface every verb that reads pages shares (proposal\n   * 0041): positional `[paths...]`, `--collection` and `--exclude` (each one\n   * value per occurrence), and `-c`/`--no-config`. Declared once so the five\n   * verbs cannot drift apart on a name or a description.\n   */\n  function documentInputs(command: Command, verb: string): Command {\n    return command\n      .argument(\n        \"[paths...]\",\n        `Files, directories, or globs to ${verb} (default: the configured collections)`,\n      )\n      .option(\n        \"--collection <name>\",\n        \"Configured collection to read (repeatable)\",\n        collect,\n        [],\n      )\n      .option(\"--exclude <glob>\", \"Glob to exclude (repeatable)\", collect, [])\n      .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n      .option(\"--no-config\", \"Ignore any discovered config file\");\n  }\n\n  /** The shared options as the command cores take them. */\n  function documentOptions(opts: {\n    collection?: string[];\n    exclude?: string[];\n    config?: string | boolean;\n  }): DocumentInputOptions {\n    const { configPath, noConfig } = configOption(opts.config);\n    return {\n      ...(configPath === undefined ? {} : { config: configPath }),\n      ...(noConfig === true ? { noConfig } : {}),\n      ...(opts.collection === undefined ? {} : { collection: opts.collection }),\n      ...(opts.exclude === undefined ? {} : { exclude: opts.exclude }),\n    };\n  }\n\n  documentInputs(\n    program\n      .command(\"list\")\n      .description(\"Show the resolved eval plan per page without running anything\"),\n    \"list\",\n  )\n    .option(\n      \"-f, --format <format>\",\n      `Output format: ${SUMMARY_FORMATS.join(\" | \")}`,\n      parseFormatArg(\"--format\", SUMMARY_FORMATS),\n      \"pretty\" as SummaryFormat,\n    )\n    .option(\"--eval <name>\", \"Show only this eval (repeatable)\", collectArg, [])\n    .option(\"--suite <name>\", \"Show only evals in this suite\")\n    .action(\n      async (\n        paths: string[],\n        opts: {\n          config?: string | boolean;\n          collection?: string[];\n          exclude?: string[];\n          format: SummaryFormat;\n          eval?: string[];\n          suite?: string;\n        },\n        command: Command,\n      ) => {\n      try {\n        const run = await runList(paths, {\n          ...documentOptions(opts),\n          format: opts.format,\n          evalNames: opts.eval,\n          suite: opts.suite,\n        });\n        console.log(\n          renderList(run, opts.format, {\n            color: colorFor(command, process.stdout.isTTY),\n          }),\n        );\n        process.exitCode = run.exitCode;\n      } catch (e) {\n        fail(e);\n      }\n    });\n\n  documentInputs(\n    program.command(\"run\").description(\"Run evals against documentation pages\"),\n    \"evaluate\",\n  )\n    .option(\n      \"-f, --format <format>\",\n      `Output format: ${REPORT_FORMATS.join(\" | \")}`,\n      parseFormatArg(\"--format\", REPORT_FORMATS),\n      \"pretty\" as ReportFormat,\n    )\n    .option(\"--deterministic-only\", \"Run only command/tool graders, skip the AI judge\")\n    .option(\"--ai-only\", \"Run only AI-judged evals, skip deterministic graders\")\n    .option(\n      // `<kind>`, not `<kind...>`: a variadic option greedily eats the\n      // positional `[paths...]` that follow it, so `--allow-execution\n      // frontmatter-commands docs/**` would silently swallow the glob and run\n      // over the default file set instead. Repeat the flag to grant twice.\n      \"--allow-execution <kind>\",\n      \"Run only these execution grants (repeatable): frontmatter-commands\",\n      collectGrant,\n      [],\n    )\n    .option(\"--no-execution\", \"Clear every execution grant for this run\")\n    .option(\"--no-generate\", \"Do not generate scripts for command evals missing a command\")\n    .option(\"--no-cache\", \"Bypass the judge response cache\")\n    .option(\"--fail-on-review\", \"Exit 1 when any eval lands in the human-review zone\")\n    .option(\"--provider <name>\", \"Judge provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .option(\"--runs <n>\", \"Ensemble runs per eval\", parseIntArg(\"--runs\"))\n    .option(\n      \"--chunk-chars <n>\",\n      \"Characters of page per judge call; longer pages are read in parts\",\n      parseIntArg(\"--chunk-chars\"),\n    )\n    .option(\n      \"--eval <name>\",\n      \"Run only this eval (repeatable); suite targets are not evaluated on a filtered run\",\n      collectArg,\n      [],\n    )\n    .option(\"--suite <name>\", \"Run only evals in this suite\")\n    .option(\n      \"--since <ref>\",\n      \"Evaluate only pages whose file or eval manifest changed between this git ref and HEAD\",\n    )\n    .option(\n      \"--newer-than <duration>\",\n      \"Evaluate only pages whose file or eval manifest changed within this window, \" +\n        \"such as 30m, 24h, 7d or 2w; in CI, prefer --since\",\n    )\n    .option(\n      \"--max-turns <n>\",\n      \"Stop after this many ensemble runs (a cached ensemble costs none)\",\n      parseIntArg(\"--max-turns\"),\n    )\n    .option(\n      \"--baseline [path]\",\n      \"Fail only on findings a recorded baseline does not already hold\",\n    )\n    .option(\"--no-baseline\", \"Ignore the configured baseline for this run\")\n    .option(\n      \"--write-baseline [path]\",\n      \"Record this run's findings as the baseline; without a path, the configured one\",\n    )\n    .action(async (paths: string[], opts: Record<string, unknown>, command: Command) => {\n      try {\n        const report = await runRun(paths, {\n          ...documentOptions({\n            config: opts.config as string | boolean | undefined,\n            collection: opts.collection as string[] | undefined,\n            exclude: opts.exclude as string[] | undefined,\n          }),\n          // parseFormatArg validated this at parse time; the cast only re-narrows\n          // from the `unknown` that the Record-typed options bag erases it to.\n          format: opts.format as ReportFormat,\n          deterministicOnly: opts.deterministicOnly as boolean | undefined,\n          aiOnly: opts.aiOnly as boolean | undefined,\n          // Commander's default is `[]`, which is \"no flag\", not \"run nothing\":\n          // only a list someone typed narrows the run.\n          allowExecution:\n            (opts.allowExecution as string[]).length > 0\n              ? (opts.allowExecution as string[])\n              : undefined,\n          execution: opts.execution as boolean | undefined,\n          generate: opts.generate as boolean | undefined,\n          cache: opts.cache as boolean | undefined,\n          failOnReview: opts.failOnReview as boolean | undefined,\n          provider: opts.provider as string | undefined,\n          model: opts.model as string | undefined,\n          local: opts.local as boolean | undefined,\n          runs: opts.runs as number | undefined,\n          chunkChars: opts.chunkChars as number | undefined,\n          maxTurns: opts.maxTurns as number | undefined,\n          evalNames: opts.eval as string[] | undefined,\n          suite: opts.suite as string | undefined,\n          since: opts.since as string | undefined,\n          newerThan: opts.newerThan as string | undefined,\n          // commander collapses `--baseline` to true and `--no-baseline` to\n          // false on the same key; a string is an explicit path.\n          baseline: opts.baseline as string | boolean | undefined,\n          writeBaseline: opts.writeBaseline as string | boolean | undefined,\n          toolVersion: pkg.version,\n        });\n        console.log(\n          render(report, opts.format as ReportFormat, {\n            color: colorFor(command, process.stdout.isTTY),\n          }),\n        );\n        process.exitCode = report.exitCode;\n      } catch (e) {\n        fail(e);\n      }\n    });\n\n  documentInputs(\n    program\n      .command(\"generate\")\n      .description(\n        \"Generate check scripts for command evals with a plain-language assertion but no command\",\n      ),\n    \"read\",\n  )\n    .option(\"--provider <name>\", \"Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .action(\n      async (\n        paths: string[],\n        opts: {\n          config?: string | boolean;\n          collection?: string[];\n          exclude?: string[];\n          provider?: string;\n          model?: string;\n          local?: boolean;\n        },\n        command: Command,\n      ) => {\n        try {\n          const pc = palette(colorFor(command, process.stdout.isTTY));\n          const result = await runGenerate(paths, {\n            ...documentOptions(opts),\n            provider: opts.provider,\n            model: opts.model,\n            local: opts.local,\n          });\n          if (result.targets === 0) {\n            console.log(\"Nothing to generate — every command eval has a command.\");\n            return;\n          }\n          console.log(\n            `Generated ${result.generatedPaths.length}/${result.targets} check script(s):`,\n          );\n          for (const p of result.generatedPaths) console.log(`  ${p}`);\n          // Evals whose command reference had nowhere to go (proposal 0047).\n          for (const r of result.refusals) console.log(pc.red(`  ${r.message}`));\n          if (result.generatedPaths.length < result.targets) {\n            process.exitCode = 1;\n          }\n        } catch (e) {\n          fail(e);\n        }\n      },\n    );\n\n  documentInputs(\n    program\n      .command(\"fill\")\n      .description(\n        \"Propose frontmatter evals for pages with an LLM; writes proposals at or above the confidence threshold\",\n      ),\n    \"fill\",\n  )\n    .option(\n      \"-f, --format <format>\",\n      `Output format: ${SUMMARY_FORMATS.join(\" | \")}`,\n      parseFormatArg(\"--format\", SUMMARY_FORMATS),\n      \"pretty\" as SummaryFormat,\n    )\n    .option(\"--dry-run\", \"Report proposals without writing frontmatter\")\n    .option(\n      \"--confidence <n>\",\n      \"Minimum confidence to write (0-1, default: config fill.confidenceThreshold)\",\n      parseFloatArg(\"--confidence\"),\n    )\n    .option(\n      \"--max-turns <n>\",\n      \"Stop after this many inference calls (a cached page costs none)\",\n      parseIntArg(\"--max-turns\"),\n    )\n    .option(\"--no-cache\", \"Bypass the fill proposal cache\")\n    .option(\n      \"--chunk-chars <n>\",\n      \"Characters of page per fill call; longer pages are proposed in parts\",\n      parseIntArg(\"--chunk-chars\"),\n    )\n    .option(\"--provider <name>\", \"Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .action(async (paths: string[], opts: Record<string, unknown>, command: Command) => {\n      try {\n        const confidence = opts.confidence as number | undefined;\n        if (confidence !== undefined && confidence > 1) {\n          fail(new DocevalsError(`--confidence must be between 0 and 1, got ${confidence}`));\n        }\n        const report = await runFill(paths, {\n          ...documentOptions({\n            config: opts.config as string | boolean | undefined,\n            collection: opts.collection as string[] | undefined,\n            exclude: opts.exclude as string[] | undefined,\n          }),\n          dryRun: opts.dryRun as boolean | undefined,\n          confidence,\n          maxTurns: opts.maxTurns as number | undefined,\n          noCache: opts.cache === false ? true : undefined,\n          provider: opts.provider as string | undefined,\n          model: opts.model as string | undefined,\n          local: opts.local as boolean | undefined,\n          // P1 (proposal 0047): offered only on a terminal, where there is\n          // someone to answer. Off one the evals go to the page and the W1\n          // line says so.\n          confirm: terminalConfirm(),\n          onNotice: notice,\n          onRelocated: (result) => {\n            const manifests = result.manifests.map((m) => m.file).join(\", \");\n            notice(\n              `moved ${String(result.summary.moved)} value(s) into ${manifests}.`,\n            );\n          },\n        });\n        // As in `run`: parseFormatArg validated this at parse time, and the cast\n        // only re-narrows from the `unknown` the Record-typed options bag erases\n        // it to. renderFill guards itself regardless.\n        console.log(\n          renderFill(report, opts.format as SummaryFormat, {\n            color: colorFor(command, process.stdout.isTTY),\n          }),\n        );\n        process.exitCode = report.exitCode;\n      } catch (e) {\n        fail(e);\n      }\n    });\n\n  documentInputs(\n    program\n      .command(\"promote\")\n      .description(\n        \"Find ai-graded evals expressible as deterministic checks; --write converts them\",\n      ),\n    \"read\",\n  )\n    .option(\"--write\", \"Apply promotions (write scripts and rewrite evals)\")\n    .option(\"--provider <name>\", \"Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .action(\n      async (\n        paths: string[],\n        opts: {\n          config?: string | boolean;\n          collection?: string[];\n          exclude?: string[];\n          write?: boolean;\n          provider?: string;\n          model?: string;\n          local?: boolean;\n        },\n        command: Command,\n      ) => {\n        try {\n          const pc = palette(colorFor(command, process.stdout.isTTY));\n          const proposals = await runPromote(paths, {\n            ...documentOptions(opts),\n            write: opts.write,\n            provider: opts.provider,\n            model: opts.model,\n            local: opts.local,\n          });\n          if (proposals.length === 0) {\n            console.log(\"No ai-graded evals found.\");\n            return;\n          }\n          for (const p of proposals) {\n            const tag = p.promotable\n              ? p.applied\n                ? pc.green(\"promoted\")\n                : pc.cyan(\"promotable\")\n              : pc.dim(\"keep-ai\");\n            const script = p.scriptPath ? pc.dim(` -> ${p.scriptPath}`) : \"\";\n            console.log(`${tag} ${p.evalName} (${p.source}, ${p.file})${script}`);\n            console.log(pc.dim(`  ${p.rationale}`));\n            // Promotable, and nowhere to write it (proposal 0047).\n            if (p.error !== undefined) console.log(pc.red(`  ${p.error}`));\n          }\n          if (!opts.write && proposals.some((p) => p.promotable)) {\n            console.log(pc.cyan(\"\\nRe-run with --write to apply promotions.\"));\n          }\n        } catch (e) {\n          fail(e);\n        }\n      },\n    );\n\n  program\n    .command(\"calibrate\")\n    .description(\n      \"Measure judge agreement against a human-verified golden set (.manni/docevals/golden/*.yaml)\",\n    )\n    .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n    .option(\"--golden <dir>\", \"Golden set directory\", \".manni/docevals/golden\")\n    .option(\n      \"--seed\",\n      \"Write golden candidates from recorded reviews and exit; judges nothing, needs no provider\",\n    )\n    .option(\"--provider <name>\", \"Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\")\n    .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n    .option(\"--local\", LOCAL_FLAG_HELP)\n    .option(\"--runs <n>\", \"Ensemble runs per case\", parseIntArg(\"--runs\"))\n    .option(\n      \"--max-turns <n>\",\n      \"Stop after this many ensemble runs (a cached ensemble costs none)\",\n      parseIntArg(\"--max-turns\"),\n    )\n    .option(\"--no-cache\", \"Bypass the judge response cache\")\n    .action(\n      async (opts: {\n        config?: string;\n        golden?: string;\n        seed?: boolean;\n        provider?: string;\n        model?: string;\n        local?: boolean;\n        runs?: number;\n        maxTurns?: number;\n        cache?: boolean;\n      }, command: Command) => {\n        try {\n          const color = colorFor(command, process.stdout.isTTY);\n          const pc = palette(color);\n          if (opts.seed) {\n            // No `config`: reviews.yaml and the golden directory both resolve\n            // against the working directory, not the config's, so passing it\n            // would imply an influence it does not have.\n            const seeded = seedGoldenCases({ golden: opts.golden });\n            if (seeded.total === 0) {\n              console.log(\n                \"No recorded reviews to seed from — run `manni docevals review <file> <eval> <pass|fail>` first.\",\n              );\n              return;\n            }\n            // The lead number is what moved, not the file's size: `total`\n            // counts cases already confirmed and left alone, so leading with it\n            // read as \"wrote 8 candidates\" on a re-seed that wrote none.\n            const changed = seeded.added + seeded.updated;\n            console.log(\n              changed === 0\n                ? `No new reviews to seed — ${seeded.total} golden case(s) already in ${seeded.path}.`\n                : `Wrote ${changed} golden candidate(s) to ${seeded.path} ` +\n                  `(${seeded.added} new, ${seeded.updated} updated; ${seeded.total} total).`,\n            );\n            if (seeded.unreviewed > 0) {\n              console.log(\n                pc.yellow(\n                  `${seeded.unreviewed} case(s) are \\`reviewed: false\\`. Read them and set ` +\n                    \"`reviewed: true` — a golden set assembled without a human is not one.\",\n                ),\n              );\n            }\n            return;\n          }\n          const report = await runCalibrate({\n            config: opts.config,\n            golden: opts.golden,\n            provider: opts.provider,\n            model: opts.model,\n            local: opts.local,\n            runs: opts.runs,\n            maxTurns: opts.maxTurns,\n            noCache: opts.cache === false,\n          });\n          console.log(renderCalibration(report, { color }));\n          // Both conditions: the judge has to agree enough, AND the set has to\n          // have been measured. A stale golden file whose pages were renamed\n          // used to certify on whatever still resolved.\n          process.exitCode =\n            report.meetsThreshold &&\n            report.unjudged === 0 &&\n            report.balanced\n              ? 0\n              : 1;\n        } catch (e) {\n          fail(e);\n        }\n      },\n    );\n\n  program\n    .command(\"init\")\n    .description(\"Create a starter manni.config.yaml in the current directory\")\n    .action(() => {\n      try {\n        console.log(`Created ${runInit()}`);\n      } catch (e) {\n        fail(e);\n      }\n    });\n\n  program\n    .command(\"review\")\n    .description(\n      \"Record a human verdict for an eval in the human-review zone (or list recorded reviews)\",\n    )\n    .argument(\"[file]\", \"Page path\")\n    .argument(\"[eval]\", \"Eval name\")\n    .argument(\"[verdict]\", \"pass | fail\")\n    .option(\"--reviewer <name>\", \"Reviewer name recorded with the verdict\")\n    .option(\"--note <text>\", \"Optional note\")\n    .action(\n      (\n        file: string | undefined,\n        evalName: string | undefined,\n        verdict: string | undefined,\n        opts: { reviewer?: string; note?: string },\n        command: Command,\n      ) => {\n        try {\n          if (!file) {\n            console.log(\n              renderReviews(listReviews(), {\n                color: colorFor(command, process.stdout.isTTY),\n              }),\n            );\n            return;\n          }\n          if (!evalName || !verdict) {\n            throw new DocevalsError(\n              \"Usage: manni docevals review <file> <eval> <pass|fail>\",\n            );\n          }\n          const entry = runReview(file, evalName, verdict, opts);\n          console.log(\n            `Recorded ${entry.verdict} for ${entry.evalName} on ${entry.file}`,\n          );\n        } catch (e) {\n          fail(e);\n        }\n      },\n    );\n\n  return program;\n}\n"],"mappings":"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","names":[]}

package/dist/{cli-VUKMWSSF.js → cli-WNEI5L7P.js}

@@ -10,15 +10,15 @@ import {
   findConfigFileSync,
   readConfigFileSync,
   searchPath
-} from "./chunk-QLWC7MKD.js";
+} from "./chunk-OTJOBZJ5.js";
 import {
   notice,
   warn
 } from "./chunk-HX44GB4Z.js";
-import "./chunk-QCHVR4ZM.js";
+import "./chunk-VM7VAFJW.js";
 import {
   package_default
-} from "./chunk-2MJ62AYQ.js";
+} from "./chunk-7MCQHTQ5.js";
 import "./chunk-OWBRDNRZ.js";
 import {
   ToolError,
@@ -836,4 +836,4 @@ function buildProgram() {
 export {
   buildProgram
 };
-//# sourceMappingURL=cli-VUKMWSSF.js.map
+//# sourceMappingURL=cli-WNEI5L7P.js.map

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-2MJ62AYQ.js";
+} from "./chunk-7MCQHTQ5.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-XSTJJMSG.js")).termLabels(request)
+);
 var DOMAINS = [
   {
     names: ["meta"],
     load: async () => [
-      (await import("./cli-I62SRH3R.js")).buildProgram().name("meta").description(
+      (await import("./cli-NGL63E53.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-ONTC5PKT.js")).buildProgram().name("a11y").description(
+      (await import("./cli-FX53PBQ3.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-6KZTHWGP.js")).buildProgram().name("cite").description(
+      (await import("./cli-IQNJLKSN.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-4MF37HAQ.js")).buildProgram().name("lint").description(
+      (await import("./cli-KOMXVPXX.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-VID7PJS3.js")).buildProgram().name("docevals").description(
+      (await import("./cli-RKQX4TI3.js")).buildProgram().name("docevals").description(
         "Deterministic and LLM-as-judge evals for documentation pages, driven by frontmatter"
       )
     ]
@@ -55,19 +61,19 @@ var DOMAINS = [
   {
     names: ["term"],
     load: async () => [
-      (await import("./term-CQAGNG3Q.js")).buildProgram().name("term").description("Check, lint and render a docset's terms and the references into them")
+      (await import("./term-PLJEYJQV.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-JJMOVIKS.js")).buildProgram().name("test").description("Run the docs' procedure tests with Doc Detective and report in the family contract")
+      (await import("./cli-BS43EVCD.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-RORDPAPE.js")).buildProgram().name("graph").description(
+      (await import("./cli-CMR4FYF6.js")).buildProgram().name("graph").description(
         "Deterministic knowledge graphs derived from documentation frontmatter and formatting"
       )
     ]
@@ -75,7 +81,7 @@ var DOMAINS = [
   {
     names: ["tracevals"],
     load: async () => [
-      (await import("./cli-O4ABTN4Z.js")).buildProgram().name("tracevals").description(
+      (await import("./cli-236TGVJG.js")).buildProgram().name("tracevals").description(
         "Deterministic and LLM-as-judge adherence evals for AI agent session traces"
       )
     ]
@@ -84,14 +90,14 @@ var DOMAINS = [
   {
     names: ["key"],
     load: async () => [
-      (await import("./cli-3BTCK4AB.js")).buildProgram().name("key").description("Set and rotate the family key that encrypted values are encrypted with.")
+      (await import("./cli-3FAPJBEY.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-VUKMWSSF.js")).buildProgram().name("site").description("Start, build and preview the docs site")
+      (await import("./cli-WNEI5L7P.js")).buildProgram().name("site").description("Start, build and preview the docs site")
     ]
   },
   // The two family verbs (proposal 0078), and the only verbs the umbrella
@@ -99,7 +105,7 @@ var DOMAINS = [
   {
     names: ["check", "status"],
     load: async () => {
-      const { buildCheck, buildStatus } = await import("./cli-DRMZBZLB.js");
+      const { buildCheck, buildStatus } = await import("./cli-QPGS2MR5.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: [\"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":[]}
+{"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-XDA42RJL.js → config-JJW75SBX.js}

@@ -5,14 +5,14 @@ import {
   discoverConfig,
   loadConfig,
   parseConfig
-} from "./chunk-FBMZJEB3.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-QLWC7MKD.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-XDA42RJL.js.map
+//# sourceMappingURL=config-JJW75SBX.js.map

package/dist/docmeta.js

@@ -1,22 +1,23 @@
 #!/usr/bin/env node
 import {
   buildProgram
-} from "./chunk-Y6DOMTQD.js";
-import "./chunk-6HWBRZIN.js";
-import "./chunk-M42DZCOU.js";
-import "./chunk-PCQ7ELJH.js";
-import "./chunk-GV56WGL2.js";
-import "./chunk-D4N2V43Z.js";
-import "./chunk-VSEBFHAY.js";
+} from "./chunk-NCF5NQV5.js";
+import "./chunk-VQYGLU4C.js";
+import "./chunk-7FCLXEAQ.js";
+import "./chunk-CEI2J42X.js";
+import "./chunk-L2TD7DZB.js";
+import "./chunk-WO4JYWZK.js";
+import "./chunk-DSWKBZWW.js";
+import "./chunk-KFKL4VTL.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-QLWC7MKD.js";
+import "./chunk-OTJOBZJ5.js";
 import "./chunk-HX44GB4Z.js";
-import "./chunk-QCHVR4ZM.js";
-import "./chunk-2MJ62AYQ.js";
+import "./chunk-VM7VAFJW.js";
+import "./chunk-7MCQHTQ5.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-4UR67MEN.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import {
+  NAMES_ITS_SUBJECT,
+  findingMessage,
+  renderCheckGithub
+} from "./chunk-CXWTNT2O.js";
+import "./chunk-PXNCRGUL.js";
+import "./chunk-L3RLGGRK.js";
+import "./chunk-ZIRBFXDW.js";
+import "./chunk-IKEWBMCN.js";
+import "./chunk-YUTVAMWW.js";
+import "./chunk-DAQTRAP5.js";
+import "./chunk-VQYGLU4C.js";
+import "./chunk-7FCLXEAQ.js";
+import "./chunk-CEI2J42X.js";
+import "./chunk-L2TD7DZB.js";
+import "./chunk-WO4JYWZK.js";
+import "./chunk-DSWKBZWW.js";
+import "./chunk-KFKL4VTL.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-7MCQHTQ5.js";
+import "./chunk-OWBRDNRZ.js";
+import "./chunk-G3T47CFV.js";
+import "./chunk-2H7UOFLK.js";
+export {
+  NAMES_ITS_SUBJECT,
+  findingMessage,
+  renderCheckGithub
+};
+//# sourceMappingURL=github-4UR67MEN.js.map

package/dist/github-UPGKMVVF.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import {
+  renderFindingsGithub
+} from "./chunk-SAU2WQFC.js";
+import "./chunk-6TVH4FI7.js";
+import "./chunk-IKEWBMCN.js";
+import "./chunk-YUTVAMWW.js";
+import "./chunk-DAQTRAP5.js";
+import "./chunk-VQYGLU4C.js";
+import "./chunk-7FCLXEAQ.js";
+import "./chunk-CEI2J42X.js";
+import "./chunk-L2TD7DZB.js";
+import "./chunk-WO4JYWZK.js";
+import "./chunk-DSWKBZWW.js";
+import "./chunk-KFKL4VTL.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-7MCQHTQ5.js";
+import "./chunk-OWBRDNRZ.js";
+import "./chunk-G3T47CFV.js";
+import "./chunk-2H7UOFLK.js";
+export {
+  renderFindingsGithub
+};
+//# sourceMappingURL=github-UPGKMVVF.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);