@hawkeyexl/manni 4.3.0 → 4.4.0

package/dist/cli-SRHFUZHA.js.map

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

package/dist/cli-URZQXL4K.js

@@ -0,0 +1,552 @@
+#!/usr/bin/env node
+import {
+  runAdd,
+  runRemove,
+  runUpdate
+} from "./chunk-5YXBLLAC.js";
+import {
+  runCheck
+} from "./chunk-LAKAWRV5.js";
+import {
+  findingMessage,
+  renderCheckGithub
+} from "./chunk-XSLV76YK.js";
+import {
+  renderCheckPretty,
+  renderRemovePretty,
+  renderUpdatePretty
+} from "./chunk-BUXDLRDT.js";
+import {
+  errorSite,
+  shortCommit,
+  shortLine,
+  shortPin,
+  shortSrc
+} from "./chunk-252LNOEG.js";
+import {
+  renderCheckJson,
+  renderRemoveJson,
+  renderUpdateJson
+} from "./chunk-PCE7QHXJ.js";
+import "./chunk-77AINBYM.js";
+import {
+  CiteError,
+  RULE_ID_PREFIX,
+  asCiteError,
+  isCiteRule,
+  spellSource
+} from "./chunk-G7NJSREW.js";
+import "./chunk-IKEWBMCN.js";
+import "./chunk-TU2WUBVZ.js";
+import "./chunk-H2DLH2JI.js";
+import {
+  terminalConfirm
+} from "./chunk-CYWHFSRT.js";
+import "./chunk-K3D6FPV6.js";
+import {
+  collect,
+  configOption,
+  explicitFalse,
+  readStdin,
+  reportConfig,
+  splitList
+} from "./chunk-V46OILVC.js";
+import {
+  splitPageArgument
+} from "./chunk-RLR4TKUZ.js";
+import {
+  COMMON_FORMAT_LIST,
+  OMITTED_WHEN_CLEAN,
+  REPORT_FORMATS,
+  REPORT_FORMAT_LIST,
+  isMachineFormat,
+  isReportFormat,
+  renderJunit,
+  renderSarif
+} from "./chunk-C6OH6CNF.js";
+import {
+  STDIN_TOKEN
+} from "./chunk-JVTNMVYU.js";
+import {
+  fail
+} from "./chunk-YEUYKR62.js";
+import {
+  shouldColor
+} from "./chunk-RNVYGWIC.js";
+import "./chunk-MNH7QO4Z.js";
+import {
+  notice
+} from "./chunk-Q35YIDBV.js";
+import {
+  package_default
+} from "./chunk-UZC7LDAQ.js";
+import "./chunk-OWBRDNRZ.js";
+import "./chunk-G3T47CFV.js";
+import "./chunk-2H7UOFLK.js";
+
+// src/cite/cli.ts
+import { Command, Option } from "commander";
+
+// src/cite/reporters/sarif.ts
+var INFORMATION_URI = "https://hawkeyexl.github.io/manni/cite/";
+var RULES_URI = "https://hawkeyexl.github.io/manni/cite/reference/citations/";
+var RULE_DESCRIPTIONS = {
+  "source-moved": "The cited source lines moved to one other place in the file.",
+  "source-moved-ambiguous": "The cited source lines now match at several places in the file.",
+  "source-changed": "The cited source lines changed since the citation pinned them.",
+  "source-never-true": "The pin never matched the source at the recorded commit.",
+  "source-missing": "The cited source file is not tracked under the root, or cannot be decrypted.",
+  "claim-moved": "The cited sentence moved to other lines of the page.",
+  "claim-moved-ambiguous": "The cited sentence now appears at several places on the page.",
+  "claim-reanchored": "The cited sentence's words are unchanged since the claim's baseline, and only its layout moved.",
+  "claim-changed": "The cited sentence was edited since the citation pinned it.",
+  "marker-orphan": "A marker names an id no citation has.",
+  "marker-invalid": "A marker is malformed, or the page has too many markers.",
+  "marker-repeated": "Two markers name the same citation id.",
+  "marker-misplaced": "A marker line sits inside the paragraph it anchors, and splits it.",
+  "anchor-invalid": "A citation's anchor cannot work.",
+  "entry-invalid": "A citation entry is malformed.",
+  "quote-drift": "A quoted block no longer reproduces its source."
+};
+var ENTRY_LABEL = /^(?:\(root\)|\/citations\/\d+) /;
+function withFindingMessages(run) {
+  return run.results.map((result) => {
+    const page = run.pages.find((p) => p.file === result.file);
+    if (page === void 0) return result;
+    const errors = result.errors.map((error) => {
+      const finding = page.findings.find(
+        (f) => f.rule === error.keyword && (f.index === void 0 ? "" : `/citations/${String(f.index)}`) === error.instancePath && f.message === error.message && (errorSite(f).line ?? null) === (error.line ?? null)
+      );
+      return finding === void 0 ? error : { ...error, message: findingMessage(finding) };
+    });
+    return { ...result, errors };
+  });
+}
+function describe(rule) {
+  const name = rule.id.slice(RULE_ID_PREFIX.length + 1);
+  if (!isCiteRule(name)) return rule;
+  return { id: rule.id, shortDescription: { text: RULE_DESCRIPTIONS[name] }, helpUri: `${RULES_URI}#${name}` };
+}
+function renderCheckSarif(run, opts = {}) {
+  const log = JSON.parse(
+    renderSarif(withFindingMessages(run), {
+      frame: run.frame,
+      ...opts.onNotice === void 0 ? {} : { onNotice: opts.onNotice }
+    })
+  );
+  for (const sarifRun of log.runs) {
+    sarifRun.tool.driver.informationUri = INFORMATION_URI;
+    sarifRun.tool.driver.rules = sarifRun.tool.driver.rules.map(describe);
+    for (const result of sarifRun.results) result.message.text = result.message.text.replace(ENTRY_LABEL, "");
+  }
+  return JSON.stringify(log, null, 2);
+}
+
+// src/cite/reporters/junit.ts
+var JUNIT_CLASSNAME = "manni.cite";
+var MESSAGE_LABEL = new RegExp(`message="${ENTRY_LABEL.source.replace(/^\^/, "")}`, "g");
+function renderCheckJunit(run) {
+  return renderJunit(withFindingMessages(run), { frame: run.frame, classname: JUNIT_CLASSNAME }).replace(
+    MESSAGE_LABEL,
+    'message="'
+  );
+}
+
+// src/cite/cli.ts
+var UPDATE_FORMATS = ["pretty", "json"];
+var REMOVE_FORMATS = UPDATE_FORMATS;
+function colorFor(command, isTTY, env) {
+  const noColor = colorOwner(command).opts().color === false;
+  return shouldColor({ noColor, isTTY, env });
+}
+function colorOwner(command) {
+  for (let c = command; c !== null; c = c.parent) {
+    if (c.options.some((o) => o.long === "--no-color")) return c;
+  }
+  return command;
+}
+function isUpdateFormat(value) {
+  return UPDATE_FORMATS.includes(value);
+}
+function isRemoveFormat(value) {
+  return REMOVE_FORMATS.includes(value);
+}
+function splitPageArgument2(arg) {
+  return asCiteError(() => splitPageArgument(arg));
+}
+function spellAt(lines, noun = "line") {
+  return lines.start === lines.end ? `${noun} ${String(lines.start)}` : `${noun}s ${String(lines.start)}-${String(lines.end)}`;
+}
+function addMessage(result) {
+  const { citation, claimLines } = result;
+  const claim = citation.claim;
+  const name = citation.id ?? (claim === void 0 ? "a bare pin" : "an entry");
+  const src = shortSrc(spellSource(citation.source));
+  const commit = citation.source["commit-sha"];
+  const quoted = result.sourceLine === void 0 ? "" : shortLine(result.sourceLine);
+  const line = quoted === "" ? "" : ` "${quoted}"`;
+  const pin = `${src}${line}, ${shortPin(citation.source.integrity)}, ${commit === void 0 ? "no commit" : shortCommit(commit)}`;
+  const where = result.manifest === void 0 ? "frontmatter" : `${result.manifest.file}:${String(result.manifest.line)}`;
+  const head = `${result.file}: added ${name} to ${where}`;
+  if (result.markerLine !== void 0) {
+    const at = claimLines === void 0 ? "" : `, claim pinned at ${spellAt(claimLines)}`;
+    const wrote = result.markerJoined === true ? "joined the marker at line" : "marker at line";
+    const marked = `${head}; ${wrote} ${String(result.markerLine)}${at}`;
+    if (claim === void 0) return marked;
+    if (citation.quote === true) return `${marked} (a block that reproduces ${src})`;
+    return `${marked} (${shortPin(claim.integrity)}; source ${pin})`;
+  }
+  if (claim === void 0 || claimLines === void 0) {
+    return `${head} (source ${pin})`;
+  }
+  if (citation.quote === true) {
+    return `${head} (claim ${spellAt(claimLines, "line")}, a block that reproduces ${src})`;
+  }
+  return `${head} (claim at ${spellAt(claimLines)}, ${shortPin(claim.integrity)}; source ${pin})`;
+}
+function buildProgram() {
+  const program = new Command();
+  program.name("cite").description(
+    "Track citations from doc claims to source lines and check them for drift."
+  ).version(package_default.version, "-V, --version").option("--no-color", "disable colored output").showHelpAfterError("(add --help for usage)").exitOverride();
+  program.command("check").description("Check every citation in the given pages against its source").argument(
+    "[paths...]",
+    "files, directories, or globs to check (use - for stdin)"
+  ).option(
+    "--collection <name>",
+    "configured collection to run over; repeatable",
+    collect,
+    []
+  ).option("--ext <list>", "comma-separated extensions for directory walks").option("--exclude <glob>", "glob to exclude; repeatable", collect, []).option("--as <format>", "force an input format for every input").option(
+    "-f, --format <format>",
+    `output: ${REPORT_FORMATS.join(" | ")}`,
+    "pretty"
+  ).option("-c, --config <path>", "path to a manni config file").option("--no-config", "ignore any discovered config file").option("-q, --quiet", "in pretty output, hide current citations and clean files").option("--allow-empty", "treat zero matched files as success").option("--no-gitignore", "check files .gitignore covers").addOption(
+    new Option(
+      "--baseline [path]",
+      "compare against a baseline; fail only on findings not in it"
+    )
+  ).addOption(
+    new Option(
+      "--write-baseline [path]",
+      "record current findings as the baseline, then exit 0"
+    )
+  ).option("--no-baseline", "ignore a baseline configured by `baseline:`").option("--no-check-sources", "page-side rules only; every source status is skipped").option(
+    "--root <dir>",
+    "directory src: paths resolve from (default: cite.root from config, else the git root, else the current directory)"
+  ).option("--show-diff", "in pretty output, print the diff and commit subjects for changed").option("--reveal", "in pretty output, print the decrypted path beside an encrypted source").addHelpText(
+    "after",
+    [
+      "",
+      "Examples:",
+      "  manni cite check docs/                          # walk a directory",
+      "  manni cite check --collection guides             # one configured collection",
+      '  manni cite check "docs/**/*.md" -f github        # CI annotations',
+      "  manni cite check --show-diff docs/limits.md      # see what changed",
+      "  manni cite check --baseline                      # fail only on new findings",
+      "  cat page.md | manni cite check - --as markdown"
+    ].join("\n")
+  ).action(async (paths, options, command) => {
+    try {
+      const format = options.format;
+      if (!isReportFormat(format)) {
+        throw new CiteError(
+          `Unknown --format "${format}". Use ${REPORT_FORMAT_LIST}.`
+        );
+      }
+      const exts = options.ext ? splitList(options.ext) : void 0;
+      const stdinContent = paths.includes(STDIN_TOKEN) ? await readStdin() : void 0;
+      const cwd = process.cwd();
+      const run = await runCheck({
+        inputs: paths,
+        collection: options.collection,
+        exts,
+        exclude: options.exclude,
+        as: options.as,
+        ...configOption(options.config),
+        onConfigLoaded: reportConfig(!isMachineFormat(format), cwd),
+        stdinContent,
+        // `undefined` rather than `false` when absent, so config still wins.
+        allowEmpty: options.allowEmpty ? true : void 0,
+        respectGitignore: explicitFalse(options.gitignore),
+        onNotice: notice,
+        baseline: options.baseline,
+        writeBaseline: options.writeBaseline,
+        checkSources: explicitFalse(options.checkSources),
+        // Only so the run can say git is not there to give diffs; the diffs
+        // themselves are the pretty reporter's.
+        showDiff: options.showDiff ? true : void 0,
+        root: options.root
+      });
+      let text;
+      switch (format) {
+        case "pretty":
+          text = renderCheckPretty(run, {
+            color: colorFor(command, process.stdout.isTTY),
+            quiet: Boolean(options.quiet),
+            showDiff: Boolean(options.showDiff),
+            reveal: Boolean(options.reveal)
+          });
+          break;
+        case "json":
+          text = renderCheckJson(run);
+          break;
+        case "github":
+          text = renderCheckGithub(run);
+          break;
+        case "sarif":
+          text = renderCheckSarif(run, { onNotice: notice });
+          break;
+        case "junit":
+          text = renderCheckJunit(run);
+          break;
+      }
+      if (text.length > 0 || !OMITTED_WHEN_CLEAN.has(format)) {
+        process.stdout.write(`${text}
+`);
+      }
+      process.exitCode = run.summary.failed > 0 ? 1 : 0;
+    } catch (err) {
+      fail(err);
+    }
+  });
+  program.command("add").description("Mint a citation for a source range and write it to a page").argument(
+    "<page>",
+    "the page to cite from, with the claim's lines: page:L or page:L1-L2 (use - for stdin, with --as)"
+  ).argument(
+    "<src>",
+    "path, path:L or path:L1-L2 relative to --root, or an encrypted ~source with the same line forms"
+  ).option("--id <id>", "kebab-case id, unique on the page; required with --marker").option("--marker", "write a cite <id> marker above the paragraph holding the page lines and pin the text it anchors").option("--quote", "the page lines are a fenced block that reproduces the source").option(
+    "--encrypt",
+    "write source.file encrypted, with an hmac-sha256- pin; with no key, offer to create one (an available key encrypts without the flag)"
+  ).option("--no-commit-sha", "do not record HEAD").option("--dry-run", "print the diff; write nothing").option("--as <format>", "force the page format").option("--root <dir>", "directory source paths resolve from (as check)").option("-c, --config <path>", "path to a manni config file").option("--no-config", "ignore any discovered config file").addHelpText(
+    "after",
+    [
+      "",
+      "Examples:",
+      "  manni cite add docs/limits.md:9 lib/limits.ts:2 --id fetch-timeout",
+      "  manni cite add docs/limits.md:30 lib/limits.ts:8-12 --id timeouts --marker",
+      "  manni cite add docs/limits.md:14-18 lib/limits.ts:1-3 --quote",
+      "  manni cite add docs/limits.md lib/limits.ts --dry-run",
+      "  cat page.md | manni cite add -:9 lib/limits.ts:2 --as markdown > out.md"
+    ].join("\n")
+  ).action(async (pageArgument, src, options) => {
+    try {
+      const { page, lines } = splitPageArgument2(pageArgument);
+      const usingStdin = page === STDIN_TOKEN;
+      const stdinContent = usingStdin ? await readStdin() : void 0;
+      const dryRun = Boolean(options.dryRun);
+      const cwd = process.cwd();
+      const result = await runAdd({
+        page,
+        pageLines: lines,
+        src,
+        id: options.id,
+        marker: options.marker ? true : void 0,
+        quote: options.quote ? true : void 0,
+        // `undefined` when absent, so the key decides: an available one
+        // encrypts without the flag.
+        encrypt: options.encrypt ? true : void 0,
+        commitSha: explicitFalse(options.commitSha),
+        dryRun,
+        as: options.as,
+        ...configOption(options.config),
+        // With `-` the page owns stdout; so does the diff under --dry-run.
+        onConfigLoaded: reportConfig(!usingStdin && !dryRun, cwd),
+        stdinContent,
+        root: options.root,
+        onNotice: notice,
+        // Only on a terminal: off one, a missing key is a refusal, not a
+        // question nobody can answer. With `-` stdin is the page, so no
+        // question is put either.
+        confirm: terminalConfirm()
+      });
+      const message = addMessage(result);
+      const diffs = [result.diff, result.manifest?.diff ?? ""].filter((d) => d.length > 0);
+      if (usingStdin) {
+        process.stdout.write(result.content);
+        if (dryRun) for (const diff of diffs) process.stderr.write(`${diff}
+`);
+        process.stderr.write(`${message}
+`);
+      } else if (dryRun) {
+        for (const diff of diffs) process.stdout.write(`${diff}
+`);
+        process.stderr.write(`${message}
+`);
+      } else {
+        process.stdout.write(`${message}
+`);
+      }
+      process.exitCode = 0;
+    } catch (err) {
+      fail(err);
+    }
+  });
+  program.command("update").description("Rewrite moved citations in place; with --accept, re-mint changed ones").argument(
+    "[paths...]",
+    "files, directories, or globs to update (use - for stdin)"
+  ).option(
+    "--collection <name>",
+    "configured collection to run over; repeatable",
+    collect,
+    []
+  ).option("--ext <list>", "comma-separated extensions for directory walks").option("--exclude <glob>", "glob to exclude; repeatable", collect, []).option("--as <format>", "force an input format for every input").option("-c, --config <path>", "path to a manni config file").option("--no-config", "ignore any discovered config file").option("--allow-empty", "treat zero matched files as success").option("--no-gitignore", "update files .gitignore covers").option("--no-check-sources", "refused: update needs the sources").option("--root <dir>", "directory src: paths resolve from (as check)").option("--accept", "re-mint changed and never-true entries at HEAD; prints old and new pins").option(
+    "--recommit",
+    "re-record commit-sha where the recorded commit does not contain the pinned lines, or is outside HEAD's history"
+  ).option("--only <id>", "limit to entries with this id; repeatable", collect, []).option("--dry-run", "print the diffs; write nothing").option(
+    "-f, --format <format>",
+    `output: ${UPDATE_FORMATS.join(" | ")}`,
+    "pretty"
+  ).addHelpText(
+    "after",
+    [
+      "",
+      "Examples:",
+      "  manni cite update docs/                          # rewrite moved entries",
+      "  manni cite update --accept --only fetch-timeout docs/limits.md",
+      "  manni cite update --dry-run docs/               # see the diffs first",
+      "  manni cite update --recommit docs/               # repair unsupported commit-sha"
+    ].join("\n")
+  ).action(async (paths, options, command) => {
+    try {
+      const format = options.format;
+      if (!isUpdateFormat(format)) {
+        throw new CiteError(
+          `Unknown --format "${format}". Use ${COMMON_FORMAT_LIST}.`
+        );
+      }
+      if (!options.checkSources) {
+        throw new CiteError(
+          "update needs the sources: drop --no-check-sources (or `checkSources: false`)."
+        );
+      }
+      const exts = options.ext ? splitList(options.ext) : void 0;
+      const usingStdin = paths.includes(STDIN_TOKEN);
+      const stdinContent = usingStdin ? await readStdin() : void 0;
+      const dryRun = Boolean(options.dryRun);
+      const pageToStdout = usingStdin && !dryRun;
+      const cwd = process.cwd();
+      const run = await runUpdate({
+        inputs: paths,
+        collection: options.collection,
+        exts,
+        exclude: options.exclude,
+        as: options.as,
+        ...configOption(options.config),
+        onConfigLoaded: reportConfig(format === "pretty" && !pageToStdout, cwd),
+        stdinContent,
+        allowEmpty: options.allowEmpty ? true : void 0,
+        respectGitignore: explicitFalse(options.gitignore),
+        onNotice: notice,
+        root: options.root,
+        accept: options.accept ? true : void 0,
+        recommit: options.recommit ? true : void 0,
+        only: options.only.length > 0 ? options.only : void 0,
+        dryRun
+      });
+      const text = format === "json" ? renderUpdateJson(run) : renderUpdatePretty(run, {
+        color: colorFor(command, process.stdout.isTTY),
+        // The diffs are the point of a dry run; a real run prints
+        // what it rewrote and leaves the file to say the rest.
+        showDiff: dryRun
+      });
+      const stdinPage = pageToStdout ? run.pages.find((page) => page.content !== void 0) : void 0;
+      if (stdinPage?.content !== void 0) {
+        process.stdout.write(stdinPage.content);
+        process.stderr.write(`${text}
+`);
+      } else {
+        process.stdout.write(`${text}
+`);
+      }
+      process.exitCode = run.exitCode;
+    } catch (err) {
+      fail(err);
+    }
+  });
+  program.command("remove").description("Remove the named citations from the given pages, markers and all").argument(
+    "[paths...]",
+    "files, directories, or globs to remove from (use - for stdin)"
+  ).option(
+    "--collection <name>",
+    "configured collection to run over; repeatable",
+    collect,
+    []
+  ).option("--ext <list>", "comma-separated extensions for directory walks").option("--exclude <glob>", "glob to exclude; repeatable", collect, []).option("--as <format>", "force an input format for every input").option("-c, --config <path>", "path to a manni config file").option("--no-config", "ignore any discovered config file").option("--allow-empty", "treat zero matched files as success").option("--no-gitignore", "remove from files .gitignore covers").option(
+    "--only <id>",
+    "the entry to remove, by id or by pointer (/citations/N); required, and repeatable",
+    collect,
+    []
+  ).option("--dry-run", "print the diffs and the report; write nothing").option(
+    "-f, --format <format>",
+    `output: ${REMOVE_FORMATS.join(" | ")}`,
+    "pretty"
+  ).addHelpText(
+    "after",
+    [
+      "",
+      "Examples:",
+      "  manni cite remove docs/limits.md --only fetch-timeout",
+      "  manni cite remove docs/ --only fetch-timeout --only retries --dry-run",
+      "  manni cite remove --collection site --only /citations/3 -f json"
+    ].join("\n")
+  ).action(async (paths, options, command) => {
+    try {
+      const format = options.format;
+      if (!isRemoveFormat(format)) {
+        throw new CiteError(
+          `Unknown --format "${format}". Use ${COMMON_FORMAT_LIST}.`
+        );
+      }
+      const exts = options.ext ? splitList(options.ext) : void 0;
+      const usingStdin = paths.includes(STDIN_TOKEN);
+      const stdinContent = usingStdin ? await readStdin() : void 0;
+      const dryRun = Boolean(options.dryRun);
+      const pageToStdout = usingStdin && !dryRun;
+      const cwd = process.cwd();
+      const run = await runRemove({
+        inputs: paths,
+        collection: options.collection,
+        exts,
+        exclude: options.exclude,
+        as: options.as,
+        ...configOption(options.config),
+        onConfigLoaded: reportConfig(format === "pretty" && !pageToStdout, cwd),
+        stdinContent,
+        allowEmpty: options.allowEmpty ? true : void 0,
+        respectGitignore: explicitFalse(options.gitignore),
+        onNotice: notice,
+        only: options.only,
+        dryRun
+      });
+      const text = format === "json" ? renderRemoveJson(run) : renderRemovePretty(run, {
+        color: colorFor(command, process.stdout.isTTY),
+        // The diffs are the point of a dry run; a real run prints
+        // what it removed and leaves the file to say the rest.
+        showDiff: dryRun,
+        dryRun
+      });
+      const stdinPage = pageToStdout ? run.pages.find((page) => page.content !== void 0) : void 0;
+      if (stdinPage?.content !== void 0) {
+        process.stdout.write(stdinPage.content);
+        process.stderr.write(`${text}
+`);
+      } else {
+        process.stdout.write(`${text}
+`);
+      }
+      process.exitCode = 0;
+    } catch (err) {
+      fail(err);
+    }
+  });
+  return program;
+}
+export {
+  addMessage,
+  buildProgram,
+  colorFor,
+  splitPageArgument2 as splitPageArgument
+};
+//# sourceMappingURL=cli-URZQXL4K.js.map