@hawkeyexl/manni 4.3.0 → 4.4.0

package/dist/cli-OFPZ5MAS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graph/cli.ts","../src/graph/reporters/index.ts","../src/graph/commands/init.ts"],"sourcesContent":["/**\n * The graph program. Named `graph` because that is where it is mounted\n * (`manni graph …`); `src/cli.ts` adds it to the umbrella and runs it.\n *\n * Grammar per proposals 0034 and 0051 §2: the domain owns verbs and has no\n * default subcommand, `-f` means the output format everywhere and is checked\n * against the verb's list, and a list reaches a flag by exactly one\n * separator. The plumbing is the family's: `fail()` from `src/shared/run.ts`,\n * `warn()` from `src/shared/warn.ts`, and `--no-color` from\n * `src/shared/color.ts`.\n */\nimport { Command } from \"commander\";\nimport pkg from \"../../package.json\" with { type: \"json\" };\nimport {\n  collect,\n  configOption,\n  readStdin,\n  splitList,\n} from \"../shared/cli-options.js\";\nimport { shouldColor } from \"../shared/color.js\";\nimport { fail } from \"../shared/run.js\";\nimport { warn } from \"../shared/warn.js\";\nimport { GraphError } from \"./types.js\";\nimport { LOCAL_FLAG_HELP } from \"../shared/providers.js\";\nimport { ALL_FILL_FIELDS, type FillField } from \"./core/config.js\";\nimport {\n  assertInputFormat,\n  DEFAULT_EXTENSIONS,\n  STDIN,\n} from \"./core/discover.js\";\nimport {\n  CHECK_FORMATS,\n  CHECK_FORMAT_LIST,\n  GRAPH_FORMATS,\n  GRAPH_FORMAT_LIST,\n  type CheckFormat,\n  type GraphFormat,\n} from \"./reporters/index.js\";\nimport { runBuild } from \"./commands/build.js\";\nimport { renderCheck, runCheck } from \"./commands/check.js\";\nimport {\n  EXPORT_TARGETS,\n  runExport,\n  type ExportFormat,\n} from \"./commands/export.js\";\nimport { renderQuery, runQuery } from \"./commands/query.js\";\nimport { renderFill, runFill } from \"./commands/fill.js\";\nimport { runInit } from \"./commands/init.js\";\nimport { renderEmbed, runEmbed } from \"./commands/embed.js\";\nimport {\n  renderSearch,\n  runSearch,\n  SEARCH_MODES,\n  type SearchMode,\n} from \"./commands/search.js\";\nimport { renderStats, runStats } from \"./commands/stats.js\";\nimport { renderTraverse, runTraverse } from \"./commands/traverse.js\";\n\n/**\n * Whether `command`'s output gets colour: this domain's `--no-color` and\n * `NO_COLOR` turn it off, and otherwise only a TTY turns it on\n * (`shouldColor`). `isTTY` is passed uncoerced: Node leaves it undefined off\n * a terminal, never false, and `shouldColor` reads a missing one as \"not a\n * terminal\".\n *\n * Exported because this is where the decision is testable — a spawned bin is\n * never a TTY. graph's reporters print no colour yet; when one does, it takes\n * the boolean from here rather than consulting the environment itself.\n */\nexport function colorFor(\n  command: Command,\n  isTTY: boolean | undefined,\n  env?: NodeJS.ProcessEnv,\n): boolean {\n  // commander maps --no-color to opts.color === false, on the command that\n  // declares it.\n  const noColor = colorOwner(command).opts().color === false;\n  return shouldColor({ noColor, isTTY, env });\n}\n\n/**\n * The nearest command, this one or an ancestor, that declares `--no-color`:\n * the `graph` program, wherever it is mounted. Not the root: under the umbrella\n * that is `manni`, which has no `--no-color` of its own.\n */\nfunction colorOwner(command: Command): Command {\n  for (let c: Command | null = command; c !== null; c = c.parent) {\n    if (c.options.some((o) => o.long === \"--no-color\")) return c;\n  }\n  return command;\n}\n\nexport function buildProgram(): Command {\nconst program = new Command();\n\nprogram\n  .name(\"graph\")\n  .description(\n    \"Deterministic knowledge graphs derived from documentation frontmatter and formatting.\",\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 still\n  // calling `process.exit(1)` — which reports a usage error as a finding.\n  .exitOverride();\n\n/**\n * Parse a numeric CLI option, refusing what the config schema refuses.\n *\n * `Number.parseFloat`/`parseInt` return NaN for `abc` and silently accept\n * out-of-range values, and NaN then disables whatever gate it feeds — a cost\n * cap that never fires, a confidence gate that writes everything, a `--top`\n * that asks for a negative number of rows. The documented precedence is\n * config → Ajv → CLI override, so the override has to be held to the same range.\n */\nfunction numericOption(\n  flag: string,\n  { min, max, integer }: { min: number; max?: number; integer?: boolean },\n) {\n  return (raw: string): number => {\n    const value = Number.parseFloat(raw);\n    if (!Number.isFinite(value)) {\n      throw new GraphError(`${flag} expects a number, got \"${raw}\".`);\n    }\n    if (integer && !Number.isInteger(value)) {\n      throw new GraphError(`${flag} expects a whole number, got ${value}.`);\n    }\n    if (value < min || (max !== undefined && value > max)) {\n      const range = max === undefined ? `>= ${min}` : `${min}..${max}`;\n      throw new GraphError(`${flag} must be ${range}, got ${value}.`);\n    }\n    return value;\n  };\n}\n\n/** A count: a whole number, at least `min` (1 unless the flag allows zero). */\nfunction countOption(flag: string, min = 1) {\n  return numericOption(flag, { min, integer: true });\n}\n\n/**\n * Hold a CLI override to the same list its config key is held to.\n *\n * `fill.provider` is Ajv-validated against the schema enum; the `--provider`\n * override was an arbitrary string cast straight to `ProviderName`, so the\n * documented config → Ajv → CLI precedence had a hole at the last step.\n */\nfunction enumOption<T extends string>(flag: string, allowed: readonly T[]) {\n  return (raw: string): T => {\n    if (!(allowed as readonly string[]).includes(raw)) {\n      throw new GraphError(\n        `${flag} must be one of ${allowed.join(\" | \")}, got \"${raw}\".`,\n      );\n    }\n    return raw as T;\n  };\n}\n\n/**\n * A flag whose value is one of a named set, refused in the family's words:\n * `Unknown --format \"xml\". Use pretty | json.` The check runs while the\n * options are parsed, so a typo costs a message rather than a graph load.\n */\nfunction choiceOption<T extends string>(flag: string, allowed: readonly T[]) {\n  return (raw: string): T => {\n    if (!(allowed as readonly string[]).includes(raw)) {\n      throw new GraphError(`Unknown ${flag} \"${raw}\". Use ${allowed.join(\" | \")}.`);\n    }\n    return raw as T;\n  };\n}\n\n/** `-f, --format`: every verb's list is `pretty | json` (0051 §2). */\nconst formatOption = choiceOption(\"--format\", GRAPH_FORMATS);\n\n/** `check`'s own, which adds `github` — the CI gate's annotation format. */\nconst checkFormatOption = choiceOption(\"--format\", CHECK_FORMATS);\n\n/**\n * `--fields <list>`: comma-separated and given once, never repeatable — one\n * separator per list (proposal 0034), and the spelling `meta fill --fields`\n * already uses. Each value is held to the same list `fill.fields` is.\n */\nconst fieldsOption = (raw: string): FillField[] =>\n  splitList(raw).map((value) => enumOption(\"--fields\", ALL_FILL_FIELDS)(value));\n\n/**\n * The document-set surface the verbs that read documents share (proposals\n * 0041 and 0051 §1): positional `[paths...]` with `-` for stdin,\n * `--collection` and `--exclude` (each one value per occurrence), `--as`,\n * `--ext` (comma-separated, given once), `--allow-empty`, and\n * `-c`/`--no-config`. Declared once so the verbs cannot drift apart on a name\n * or a description, and worded as `meta` and `lint` word them.\n */\nfunction documentInputs(command: Command, verb: string): Command {\n  return command\n    .argument(\n      \"[paths...]\",\n      `files, directories, or globs to ${verb} (use - for stdin)`,\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(\"--as <format>\", \"force an input format (markdown, mdx)\")\n    .option(\n      \"--ext <list>\",\n      \"comma-separated extensions for directory walks\",\n      DEFAULT_EXTENSIONS.join(\",\"),\n    )\n    .option(\"--allow-empty\", \"treat zero matched files as success\")\n    .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n    .option(\"--no-config\", \"Ignore any discovered config file\");\n}\n\n/** The input flags as commander hands them over. */\ninterface InputFlags {\n  as?: string;\n  ext: string;\n  allowEmpty?: boolean;\n}\n\n/**\n * The input flags for a core, and stdin when `paths` holds `-`. `--as` is\n * checked first, so `-` without it is refused before anything waits on stdin.\n */\nasync function inputOptions(\n  paths: string[],\n  opts: InputFlags,\n): Promise<{\n  as?: string;\n  ext: string[];\n  allowEmpty?: boolean;\n  stdinContent?: string;\n}> {\n  assertInputFormat(paths, opts.as);\n  return {\n    ...(opts.as === undefined ? {} : { as: opts.as }),\n    ext: splitList(opts.ext),\n    ...(opts.allowEmpty === true ? { allowEmpty: true } : {}),\n    ...(paths.includes(STDIN) ? { stdinContent: await readStdin() } : {}),\n  };\n}\n\n/**\n * `-c`/`--no-config` for a verb that reads a built graph rather than a\n * document set. They share one commander attribute, which `configOption`\n * splits.\n */\nfunction configInputs(command: Command): Command {\n  return command\n    .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n    .option(\"--no-config\", \"Ignore any discovered config file\");\n}\n\n/**\n * `opts` minus the one attribute `-c` and `--no-config` share. `documentOptions`\n * restates it as the two fields a core reads, and spreading the raw value over\n * them would put commander's `false` back where a path belongs.\n */\nfunction rest<T extends { config?: string | boolean }>(\n  opts: T,\n): Omit<T, \"config\"> {\n  const { config, ...others } = opts;\n  return others;\n}\n\n/** The shared options as the command cores take them. */\nfunction documentOptions(opts: {\n  collection?: string[];\n  exclude?: string[];\n  config?: string | boolean;\n}): {\n  config?: string;\n  noConfig?: boolean;\n  collection?: string[];\n  exclude?: string[];\n} {\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\nprogram\n  .command(\"init\")\n  .description(\"Add a starter `graph:` section to manni.config.yaml in the current directory\")\n  .action(async () => {\n    try {\n      console.log(`Created ${await runInit()}`);\n    } catch (e) {\n      fail(e);\n    }\n  });\n\ndocumentInputs(\n  program\n    .command(\"build\")\n    .description(\"Derive the knowledge graph and write deterministic Turtle\"),\n  \"build\",\n)\n  .option(\"-o, --out <path>\", \"Output .ttl path (default: config out)\")\n  .action(async (paths: string[], opts: InputFlags & {\n    config?: string | boolean;\n    collection?: string[];\n    exclude?: string[];\n    out?: string;\n  }) => {\n    try {\n      const result = await runBuild({\n        paths,\n        ...documentOptions(opts),\n        ...(await inputOptions(paths, opts)),\n        out: opts.out,\n      });\n      // Warnings go to stderr so stdout stays the machine-readable summary;\n      // a degraded build is still a successful one, so the exit code is 0.\n      for (const warning of result.warnings) warn(warning);\n      console.log(\n        `Wrote ${result.outPath} (${result.docs} docs, ${result.quads} triples)`,\n      );\n    } catch (e) {\n      fail(e);\n    }\n  });\n\nconfigInputs(\n  program\n    .command(\"check\")\n    .description(\n      \"Validate the built graph against the bundled SHACL shapes (errors exit 1)\",\n    ),\n)\n  .option(\"-g, --graph <path>\", \"Graph .ttl path (default: config out)\")\n  // One path per occurrence, never split on commas: a path may hold one.\n  .option(\n    \"--shapes <path>\",\n    \"Shapes .ttl file; repeatable (default: config check.shapes, then bundled)\",\n    collect,\n    [],\n  )\n  .option(\n    \"-f, --format <format>\",\n    `Output: ${CHECK_FORMAT_LIST}`,\n    checkFormatOption,\n    \"pretty\",\n  )\n  .action(\n    async (opts: {\n      config?: string | boolean;\n      graph?: string;\n      shapes: string[];\n      format: CheckFormat;\n    }) => {\n      try {\n        const report = await runCheck({ ...rest(opts), ...documentOptions(opts) });\n        console.log(renderCheck(report, opts.format));\n        process.exitCode = report.exitCode;\n      } catch (e) {\n        fail(e);\n      }\n    },\n  );\n\ndocumentInputs(\n  program\n    .command(\"fill\")\n    .description(\n      \"Propose `graph:` frontmatter fields with an LLM, gated by confidence, and write them back\",\n    ),\n  \"fill\",\n)\n  .option(\n    \"-f, --format <format>\",\n    `Output: ${GRAPH_FORMAT_LIST}`,\n    formatOption,\n    \"pretty\",\n  )\n  .option(\"--dry-run\", \"Report proposals without writing files\")\n  .option(\"--force\", \"Overwrite human-set graph fields\")\n  .option(\"--no-cache\", \"Bypass the proposal cache\")\n  .option(\"--no-validate-graph\", \"Skip the SHACL graph guardrail on proposals\")\n  .option(\"--sections\", \"Also propose per-section metadata\")\n  .option(\n    \"--max-turns <n>\",\n    \"Stop after this many inference calls (a cached page costs none)\",\n    countOption(\"--max-turns\"),\n  )\n  .option(\n    \"--confidence <n>\",\n    \"Minimum model confidence (0..1) to write a field (default: config, 0.7)\",\n    numericOption(\"--confidence\", { min: 0, max: 1 }),\n  )\n  .option(\n    // Comma-separated and given once: one separator per list (proposal 0034).\n    \"--fields <list>\",\n    `Fields to propose (comma-separated; default: config, then every field)`,\n    fieldsOption,\n  )\n  // The nameable providers, and `auto`. `mock` is the library's test double:\n  // accepted when asked for by name, never offered.\n  .option(\n    \"--provider <name>\",\n    \"Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp\",\n  )\n  .option(\"--model <model>\", \"Model override; needs a named provider, from here or config\")\n  .option(\"--local\", LOCAL_FLAG_HELP)\n  // Typed inline, as every other action in this file is. The option parsers\n  // above (`numericOption`, `choiceOption`, `fieldsOption`) have already thrown\n  // on anything malformed by the time this runs, so a cast per field would be\n  // safe — but it would also be the one command with the most options and the\n  // least help from the compiler.\n  .action(async (paths: string[], opts: InputFlags & {\n    config?: string | boolean;\n    collection?: string[];\n    exclude?: string[];\n    dryRun?: boolean;\n    force?: boolean;\n    cache?: boolean;\n    validateGraph?: boolean;\n    sections?: boolean;\n    maxTurns?: number;\n    confidence?: number;\n    fields?: FillField[];\n    provider?: string;\n    model?: string;\n    local?: boolean;\n    format: GraphFormat;\n  }) => {\n    try {\n      const report = await runFill({\n        paths,\n        ...documentOptions(opts),\n        ...(await inputOptions(paths, opts)),\n        dryRun: opts.dryRun,\n        force: opts.force,\n        noCache: opts.cache === false,\n        noValidateGraph: opts.validateGraph === false,\n        sections: opts.sections,\n        maxTurns: opts.maxTurns,\n        confidence: opts.confidence,\n        fields: opts.fields,\n        provider: opts.provider,\n        model: opts.model,\n        local: opts.local,\n      });\n      // Same channel discipline as build: warnings on stderr, so stdout stays\n      // the report, and a warning never changes the exit code.\n      for (const warning of report.warnings) warn(warning);\n      const rendered = renderFill(report, opts.format);\n      if (paths.includes(STDIN)) {\n        // With `-` the filled document owns stdout, as under `meta fill -`,\n        // and the report in either format is a diagnostic on stderr.\n        if (report.stdinDocument !== undefined) {\n          process.stdout.write(report.stdinDocument);\n        }\n        if (rendered.length > 0) process.stderr.write(`${rendered}\\n`);\n      } else {\n        console.log(rendered);\n      }\n      process.exitCode = report.exitCode;\n    } catch (e) {\n      fail(e);\n    }\n  });\n\nprogram\n  .command(\"query\")\n  .description(\n    \"Match triple patterns against the built graph (omit a term for wildcard)\",\n  )\n  // Long-only, and named for the triple position each one fills. `-o` is\n  // `--out` on every other graph verb and `-s` is meta's schema flag; a\n  // one-letter spelling that means two things in one family costs more than\n  // the letters it saves.\n  .option(\"--subject <term>\", \"Subject IRI or prefixed name\")\n  .option(\"--predicate <term>\", \"Predicate IRI or prefixed name\")\n  .option(\"--object <term>\", \"Object IRI, prefixed name, or literal value\")\n  .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n  .option(\"--no-config\", \"Ignore any discovered config file\")\n  .option(\"-g, --graph <path>\", \"Graph .ttl path (default: config out)\")\n  .option(\n    \"-f, --format <format>\",\n    `Output: ${GRAPH_FORMAT_LIST}`,\n    formatOption,\n    \"pretty\",\n  )\n  .action(\n    (opts: {\n      subject?: string;\n      predicate?: string;\n      object?: string;\n      config?: string | boolean;\n      graph?: string;\n      format: GraphFormat;\n    }) => {\n      try {\n        const { subject, predicate, object, ...others } = rest(opts);\n        const result = runQuery({\n          ...others,\n          ...documentOptions(opts),\n          ...(subject === undefined ? {} : { s: subject }),\n          ...(predicate === undefined ? {} : { p: predicate }),\n          ...(object === undefined ? {} : { o: object }),\n        });\n        console.log(renderQuery(result, opts.format));\n      } catch (e) {\n        fail(e);\n      }\n    },\n  );\n\nprogram\n  .command(\"stats\")\n  .description(\n    \"Summarize the built graph: counts, orphans, broken links, hubs, metadata coverage\",\n  )\n  .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n  .option(\"--no-config\", \"Ignore any discovered config file\")\n  .option(\"-g, --graph <path>\", \"Graph .ttl path (default: config out)\")\n  .option(\n    \"-f, --format <format>\",\n    `Output: ${GRAPH_FORMAT_LIST}`,\n    formatOption,\n    \"pretty\",\n  )\n  .option(\n    \"--check\",\n    \"Exit 1 when broken internal links exist or coverage is below threshold\",\n  )\n  .option(\n    \"--top <n>\",\n    \"How many most-connected docs to list\",\n    countOption(\"--top\"),\n  )\n  .option(\n    \"--coverage-threshold <pct>\",\n    \"Minimum metadata coverage % (all fields); overrides config for this run\",\n    // A percentage, so 0..100 rather than the 0..1 of a confidence. NaN here is\n    // worse than a wrong number: `pct < NaN` is false for every field, so the\n    // gate this flag exists to tighten would silently pass instead.\n    numericOption(\"--coverage-threshold\", { min: 0, max: 100 }),\n  )\n  .action(\n    (opts: {\n      config?: string | boolean;\n      graph?: string;\n      format: GraphFormat;\n      check?: boolean;\n      top?: number;\n      coverageThreshold?: number;\n    }) => {\n      try {\n        const report = runStats({ ...rest(opts), ...documentOptions(opts) });\n        console.log(renderStats(report, opts.format));\n        process.exitCode = report.exitCode;\n      } catch (e) {\n        fail(e);\n      }\n    },\n  );\n\nprogram\n  .command(\"search\")\n  .description(\"Rank graph nodes for a text query (needs `export search`)\")\n  .argument(\"<query>\", \"Text query\")\n  .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n  .option(\"--no-config\", \"Ignore any discovered config file\")\n  .option(\"-g, --graph <path>\", \"Graph .ttl path (default: config out)\")\n  .option(\n    \"-i, --index <dir>\",\n    \"Directory holding the indexes and manifest (default: beside the graph)\",\n  )\n  .option(\n    \"--lang <tag>\",\n    \"Which localization to search (required when the corpus has more than one)\",\n  )\n  .option(\"--limit <n>\", \"Maximum results (default 10)\", countOption(\"--limit\"))\n  .option(\n    \"--vectors <path>\",\n    \"Vector sidecar path (default: from the manifest)\",\n  )\n  .option(\n    \"--mode <mode>\",\n    `Which legs to run: ${SEARCH_MODES.join(\" | \")} (default: hybrid when vectors exist)`,\n    choiceOption(\"--mode\", SEARCH_MODES),\n  )\n  .option(\n    \"-f, --format <format>\",\n    `Output: ${GRAPH_FORMAT_LIST}`,\n    formatOption,\n    \"pretty\",\n  )\n  .action(\n    async (\n      query: string,\n      opts: {\n        config?: string | boolean;\n        graph?: string;\n        index?: string;\n        lang?: string;\n        limit?: number;\n        vectors?: string;\n        mode?: SearchMode;\n        format: GraphFormat;\n      },\n    ) => {\n      try {\n        const report = await runSearch({\n          ...rest(opts),\n          ...documentOptions(opts),\n          query,\n        });\n        console.log(renderSearch(report, opts.format));\n      } catch (e) {\n        fail(e);\n      }\n    },\n  );\n\nprogram\n  .command(\"traverse\")\n  .description(\n    \"Walk the graph from a node, honoring scope rules, with the full trace\",\n  )\n  .argument(\"<node>\", \"Starting node: a full IRI or a prefix:local CURIE\")\n  .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n  .option(\"--no-config\", \"Ignore any discovered config file\")\n  .option(\"-g, --graph <path>\", \"Graph .ttl path (default: config out)\")\n  .option(\n    \"-d, --depth <n>\",\n    \"Maximum hops from the node (default 1; 3 under --impact)\",\n    // Zero is allowed: it means the node itself, which is a real answer.\n    countOption(\"--depth\", 0),\n  )\n  // Comma-separated and given once: a CURIE holds no comma, so one separator\n  // is enough, and a second spelling would be a second thing to document.\n  .option(\n    \"--predicates <list>\",\n    \"Only follow these predicates (comma-separated)\",\n  )\n  .option(\"--reverse\", \"Follow inbound edges (who points at this node)\")\n  .option(\"--impact\", \"Transitive inbound reach: what a change here affects\")\n  .option(\n    \"--variant <variant>\",\n    \"Scope filter: product variant IRI, title, or slug\",\n  )\n  // Not `--subject`: on `query` that is a triple's subject, and one flag name\n  // means one thing across the domain.\n  .option(\"--software-subject <subject>\", \"Scope filter: software subject\")\n  .option(\"--lang <tag>\", \"Scope filter: BCP-47 language tag, matched in any case\")\n  .option(\"--limit <n>\", \"Stop after this many nodes\", countOption(\"--limit\"))\n  .option(\n    \"-f, --format <format>\",\n    `Output: ${GRAPH_FORMAT_LIST}`,\n    formatOption,\n    \"pretty\",\n  )\n  .action(\n    (\n      node: string,\n      opts: {\n        config?: string | boolean;\n        graph?: string;\n        depth?: number;\n        predicates?: string;\n        reverse?: boolean;\n        impact?: boolean;\n        variant?: string;\n        softwareSubject?: string;\n        lang?: string;\n        limit?: number;\n        format: GraphFormat;\n      },\n    ) => {\n      try {\n        const { softwareSubject, ...others } = rest(opts);\n        const report = runTraverse({\n          ...others,\n          ...documentOptions(opts),\n          ...(softwareSubject === undefined ? {} : { subject: softwareSubject }),\n          node,\n          predicates:\n            opts.predicates === undefined\n              ? undefined\n              : splitList(opts.predicates),\n        });\n        console.log(renderTraverse(report, opts.format));\n      } catch (e) {\n        fail(e);\n      }\n    },\n  );\n\nprogram\n  .command(\"embed\")\n  .description(\n    \"Compute local embeddings for the search index (needs @huggingface/transformers)\",\n  )\n  .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n  .option(\"--no-config\", \"Ignore any discovered config file\")\n  .option(\"-g, --graph <path>\", \"Graph .ttl path (default: config out)\")\n  .option(\n    \"-i, --index <dir>\",\n    \"Directory holding the indexes and manifest (default: beside the graph)\",\n  )\n  .option(\n    \"-o, --out <dir>\",\n    \"Directory for the sidecars (default: the index directory)\",\n  )\n  // Not `--model`: on `fill` that is the inference model, a different thing.\n  .option(\n    \"--embedding-model <id>\",\n    \"Embedding model id (any id; `mock` for offline runs)\",\n  )\n  .option(\"--dtype <dtype>\", \"Weight quantization (default q8)\")\n  .option(\"--no-cache\", \"Ignore the vector cache\")\n  .option(\n    \"-f, --format <format>\",\n    `Output: ${GRAPH_FORMAT_LIST}`,\n    formatOption,\n    \"pretty\",\n  )\n  .action(\n    async (opts: {\n      config?: string | boolean;\n      graph?: string;\n      index?: string;\n      out?: string;\n      embeddingModel?: string;\n      dtype?: string;\n      cache?: boolean;\n      format: GraphFormat;\n    }) => {\n      try {\n        const { embeddingModel, ...others } = rest(opts);\n        const report = await runEmbed({\n          ...others,\n          ...documentOptions(opts),\n          ...(embeddingModel === undefined ? {} : { model: embeddingModel }),\n          noCache: opts.cache === false,\n        });\n        console.log(renderEmbed(report, opts.format));\n      } catch (e) {\n        fail(e);\n      }\n    },\n  );\n\nprogram\n  .command(\"export\")\n  .description(\n    \"Reserialize the built graph into a consumer format (jsonld file, iirds package, or search index)\",\n  )\n  // The target is a positional, not `-f`: `-f` is the output format in every\n  // other verb of the family (0051 §2), and one flag cannot mean two things.\n  .argument(\"<target>\", `What to write: ${EXPORT_TARGETS.join(\" | \")}`)\n  .option(\"-c, --config <path>\", \"Path to manni.config.yaml\")\n  .option(\"--no-config\", \"Ignore any discovered config file\")\n  .option(\"-g, --graph <path>\", \"Graph .ttl path (default: config out)\")\n  .option(\n    \"-o, --out <path>\",\n    \"Output path (default: the graph path with the target's extension)\",\n  )\n  .action(\n    async (\n      target: string,\n      opts: { config?: string | boolean; graph?: string; out?: string },\n    ) => {\n      try {\n        if (!(EXPORT_TARGETS as readonly string[]).includes(target)) {\n          throw new GraphError(\n            `Unknown export target \"${target}\". Use ${EXPORT_TARGETS.join(\" | \")}.`,\n          );\n        }\n        const result = await runExport({\n          ...documentOptions(opts),\n          graph: opts.graph,\n          format: target as ExportFormat,\n          out: opts.out,\n        });\n        for (const warning of result.warnings) warn(warning);\n        console.log(\n          `Wrote ${result.nodes} node${result.nodes === 1 ? \"\" : \"s\"} to ${result.outPath}`,\n        );\n      } catch (e) {\n        fail(e);\n      }\n    },\n  );\n\nreturn program;\n}\n","/**\n * What `-f` accepts, per verb.\n *\n * Each verb's renderer lives beside its command core (`renderCheck`,\n * `renderStats`, …); what belongs here is the *list*, stated once so the\n * union, the guard, the help text and the refusal sentence cannot drift\n * apart. It is the same shape a11y and cite keep (`A11Y_FORMATS`,\n * `REPORT_FORMATS`), which is why the sentence a user reads is the family's.\n *\n * Every verb takes `pretty | json`. `check` also takes `github`, because it is\n * the CI gate: it is the one graph verb whose output changes what a reviewer sees\n * on a pull request (proposal 0051 §2). It names its own list here rather than\n * widening the shared one, so no other verb advertises a format it cannot\n * render.\n */\n\n/** The list every graph verb's `-f` accepts, in the order messages list them. */\nexport const GRAPH_FORMATS = [\"pretty\", \"json\"] as const;\nexport type GraphFormat = (typeof GRAPH_FORMATS)[number];\n\n/** `\"pretty | json\"`, for help text and the refusal sentence. */\nexport const GRAPH_FORMAT_LIST: string = GRAPH_FORMATS.join(\" | \");\n\n/** `check`'s list: the shared two plus the CI annotation format. */\nexport const CHECK_FORMATS = [...GRAPH_FORMATS, \"github\"] as const;\nexport type CheckFormat = (typeof CHECK_FORMATS)[number];\n\n/** `\"pretty | json | github\"`, for help text and the refusal sentence. */\nexport const CHECK_FORMAT_LIST: string = CHECK_FORMATS.join(\" | \");\n","/**\n * `manni graph init` — scaffold a starter `graph:` section in manni.config.yaml.\n *\n * The family file is shared with the other tools, so a file that already\n * exists is not overwritten: the section is appended to it, leaving the\n * siblings' keys and comments exactly as they were. A file that already has a\n * `graph:` key is refused.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { parse as parseYaml } from \"yaml\";\nimport { errorMessage } from \"../../shared/errors.js\";\nimport { writeTextAtomic } from \"../../shared/write-file.js\";\nimport { GraphError } from \"../types.js\";\nimport { CONFIG_SECTION, DEFAULT_CONFIG_FILENAME } from \"../core/config.js\";\n\nconst HEADER = `# manni.config.yaml — shared configuration for the manni family of tools.\n# Each tool reads its own top-level key; manni graph reads \"graph:\".\n`;\n\nconst STARTER = `# Base IRI for every minted node. Set this to a namespace you control;\n# without it, IRIs fall back to the urn:manni:graph: placeholder.\n# baseIri: https://example.com/graph/\n\n# There is no document set here. \\`manni graph build\\` and \\`manni graph fill\\` read the\n# paths you name, or the collections declared once for every tool at the TOP\n# level of this file, beside \\`graph:\\` rather than inside it:\n#\n#   collections:\n#     - name: site\n#       paths: [\"docs/**/*.md\"]\n#\n# Output of \\`manni graph build\\`.\nout: graph/graph.ttl\n\n# Map published-site routes back to source files so route-style links\n# (/docs/actions/find) become graph edges. A route may also carry the BCP-47\n# \\`language\\` labelling every document under its root; a page's own \\`lang\\`\n# frontmatter wins. Uncomment and adjust:\n# routes:\n#   - basePath: /docs\n#     root: docs\n#     extensions: [.md, .mdx, .markdown]\n#     indexFiles: [index, README]\n#   - basePath: /docs/de\n#     root: docs/de\n#     language: de\n\n# What to derive triples from. Remove entries to opt out.\nbuild:\n  derive: [frontmatter, sections, links, tags, images, code, provenance]\n\n# PROV-O settings. Git history is detected, not switched: per-file dates and\n# author agents, rename -> prov:wasRevisionOf, and the build activity's HEAD\n# committer date are derived wherever git can run over a repository, and a run\n# that cannot says so once and builds the rest. Deterministic per commit;\n# wall-clock time never enters the graph.\n# qualified: emit prov:qualifiedAttribution/qualifiedAssociation nodes\n#   with roles alongside the direct properties.\nprovenance:\n  qualified: true\n\n# Which fields a published graph may carry is read from x-manni-graph-output in\n# the schema set \\`manni meta validate\\` resolves for each page. Set that under\n# meta: (schemas, strict, register), not here. The default set keeps the\n# stewardship people fields (owner, stakeholders, reviewed-by) out.\n\n# SHACL shapes \\`manni graph check\\` validates the built graph against. Default:\n# the shapes contract bundled with manni (shapes/graph/shapes-1.0.0.ttl).\n# check:\n#   shapes: [\"./my-shapes.ttl\"]\n\n# Metadata coverage gate for \\`manni graph stats --check\\`. A number applies to\n# every measured field; a map gates named fields only. Unset gates nothing.\n# stats:\n#   coverageThreshold:\n#     title: 100\n#     description: 50\n\n# Which provider \\`manni graph fill\\` sends pages to. Unset, the family's\n# top-level providers: map decides, and then \\`auto\\`, which detects one: an\n# Anthropic key, then an OpenAI key, then the Claude CLI, then a local model.\n# Connection settings (apiKeyEnv, baseUrl, command) live in that map, declared\n# once for every manni tool. \\`--provider\\` wins over this, \\`--local\\` over both.\n# provider: anthropic          # auto | anthropic | openai | claude-cli | llama-cpp\n# model: claude-sonnet-4-5     # the provider's default when omitted\n\n# LLM settings for \\`manni graph fill\\` (SKOS frontmatter proposals).\nfill:\n  temperature: 0\n  # Stop after this many inference calls. One page is one turn, and a cached\n  # page spends none. Unset is unbounded.\n  # maxTurns: 50\n  cacheDir: .manni/graph/cache\n  # fill proposes every field; confidence (0..1 per field) gates what is\n  # written. Fields scored below the threshold are reported, not written.\n  confidenceThreshold: 0.7\n  # fields: defaults to every fillable field — uncomment to restrict.\n  # Record meta-provenance (model + /graph/ pointers + confidence) on filled docs.\n  writeProvenance: true\n  # Reject proposals that would violate the SHACL shapes contract\n  # (broader/narrower cycles, conflicting labels).\n  validateGraph: true\n  # Also propose per-section metadata. Off by default: it costs more output per\n  # call, and section metadata is explicit-only, so review it as carefully.\n  sections: false\n\n# Local embeddings for semantic search (\\`manni graph embed\\`). Needs the optional\n# peer: npm install @huggingface/transformers\n# embed:\n#   model: onnx-community/granite-embedding-small-english-r2-ONNX\n#   dtype: q8            # q8 keeps embedding reproducible across platforms\n#   out: graph              # directory for the per-language vector sidecars\n#   cacheDir: .manni/graph/embed-cache\n\n# Optional enrichment for \\`manni graph export iirds\\` (the iiRDS package).\n# Absent, a minimal valid package is still produced.\n# export:\n#   iirds:\n#     title: My Docs        # package title (default: \"manni graph export\")\n#     creator: Acme Corp     # Creator iirds:Party + vcard:Organization\n#     version: \"1.3\"         # iiRDS version literal: \"1.2\" | \"1.3\"\n`;\n\n/** The starter as a `graph:` section: every line nested one level. */\nfunction starterSection(): string {\n  const body = STARTER.split(\"\\n\")\n    .map((line) => (line === \"\" ? \"\" : `  ${line}`))\n    .join(\"\\n\");\n  return `${CONFIG_SECTION}:\\n${body}`;\n}\n\nexport async function runInit(cwd = process.cwd()): Promise<string> {\n  const path = resolve(cwd, DEFAULT_CONFIG_FILENAME);\n  if (!existsSync(path)) {\n    await writeTextAtomic(path, `${HEADER}${starterSection()}`);\n    return path;\n  }\n\n  // A family file is already here. Parse it to make sure a `graph:` key can be\n  // appended: the document must be a mapping (or empty) without one.\n  const text = readFileSync(path, \"utf8\");\n  let doc: unknown;\n  try {\n    doc = parseYaml(text);\n  } catch (e) {\n    throw new GraphError(\n      `Invalid YAML in ${DEFAULT_CONFIG_FILENAME}: ${errorMessage(e)}`,\n    );\n  }\n  if (doc != null && (typeof doc !== \"object\" || Array.isArray(doc))) {\n    throw new GraphError(\n      `${DEFAULT_CONFIG_FILENAME}: top level must be a mapping — not adding a \\`${CONFIG_SECTION}:\\` section to it.`,\n    );\n  }\n  if (doc != null && Object.hasOwn(doc, CONFIG_SECTION)) {\n    throw new GraphError(\n      `${DEFAULT_CONFIG_FILENAME} already has a \\`${CONFIG_SECTION}:\\` section — not overwriting.`,\n    );\n  }\n  // Append as text rather than re-serialising the document, so the siblings'\n  // keys and comments come out byte-for-byte as they went in.\n  const separator = text === \"\" || text.endsWith(\"\\n\") ? \"\" : \"\\n\";\n  const blank = text === \"\" ? \"\" : \"\\n\";\n  await writeTextAtomic(\n    path,\n    `${text}${separator}${blank}${starterSection()}`,\n  );\n  return path;\n}\n"],"mappings":"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","names":[]}

package/dist/cli-SHSMSRQY.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import {
+  buildProgram,
+  parseQueryParams,
+  resolveGetInputs,
+  resolveQueryInputs
+} from "./chunk-KCGV52AM.js";
+import "./chunk-CYWHFSRT.js";
+import "./chunk-K3D6FPV6.js";
+import "./chunk-V46OILVC.js";
+import "./chunk-RLR4TKUZ.js";
+import "./chunk-C6OH6CNF.js";
+import "./chunk-JVTNMVYU.js";
+import "./chunk-YEUYKR62.js";
+import "./chunk-RNVYGWIC.js";
+import "./chunk-MNH7QO4Z.js";
+import "./chunk-Q35YIDBV.js";
+import "./chunk-UZC7LDAQ.js";
+import "./chunk-OWBRDNRZ.js";
+import "./chunk-G3T47CFV.js";
+import "./chunk-2H7UOFLK.js";
+export {
+  buildProgram,
+  parseQueryParams,
+  resolveGetInputs,
+  resolveQueryInputs
+};
+//# sourceMappingURL=cli-SHSMSRQY.js.map

package/dist/cli-SHSMSRQY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/cli-SRHFUZHA.js

@@ -0,0 +1,473 @@
+#!/usr/bin/env node
+import {
+  listReviews,
+  renderCalibration,
+  renderFill,
+  renderReviews,
+  runCalibrate,
+  runFill,
+  runGenerate,
+  runInit,
+  runPromote,
+  runReview,
+  seedGoldenCases
+} from "./chunk-77HX34KD.js";
+import {
+  renderList,
+  runList
+} from "./chunk-YTCZRLTU.js";
+import {
+  runRun
+} from "./chunk-PHF3D7ER.js";
+import "./chunk-NWZ2SLYL.js";
+import "./chunk-LJ2RDH3F.js";
+import {
+  allowExecutionMessage,
+  isExecutionGrant
+} from "./chunk-YNHZHSSM.js";
+import {
+  render
+} from "./chunk-NCPWXHDO.js";
+import {
+  REPORT_FORMATS,
+  SUMMARY_FORMATS,
+  parseFormat
+} from "./chunk-ZXRAE55H.js";
+import {
+  DocevalsError
+} from "./chunk-SE4JN5XN.js";
+import "./chunk-77AINBYM.js";
+import "./chunk-TU2WUBVZ.js";
+import "./chunk-H2DLH2JI.js";
+import {
+  terminalConfirm
+} from "./chunk-CYWHFSRT.js";
+import "./chunk-K3D6FPV6.js";
+import {
+  collect,
+  configOption
+} from "./chunk-V46OILVC.js";
+import "./chunk-RLR4TKUZ.js";
+import "./chunk-C6OH6CNF.js";
+import "./chunk-JVTNMVYU.js";
+import {
+  fail
+} from "./chunk-YEUYKR62.js";
+import {
+  colorFor,
+  palette
+} from "./chunk-RNVYGWIC.js";
+import "./chunk-MNH7QO4Z.js";
+import {
+  LOCAL_FLAG_HELP,
+  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/docevals/cli.ts
+import { Command } from "commander";
+function buildProgram() {
+  const program = new Command();
+  program.name("docevals").description(
+    "Deterministic and LLM-as-judge evals for documentation pages, driven by frontmatter."
+  ).version(package_default.version).option("--no-color", "disable colored output").showHelpAfterError("(add --help for usage)").exitOverride();
+  function collectGrant(value, previous) {
+    if (!isExecutionGrant(value)) {
+      fail(new DocevalsError(allowExecutionMessage(value)));
+    }
+    return [...previous, value];
+  }
+  function parseIntArg(name) {
+    return (value) => {
+      const n = Number.parseInt(value, 10);
+      if (Number.isNaN(n) || n < 1) {
+        fail(new DocevalsError(`${name} must be a positive integer, got "${value}"`));
+      }
+      return n;
+    };
+  }
+  function collectArg(value, previous) {
+    return [...previous, value];
+  }
+  function parseFloatArg(name) {
+    return (value) => {
+      const n = Number.parseFloat(value);
+      if (Number.isNaN(n) || n < 0) {
+        fail(new DocevalsError(`${name} must be a non-negative number, got "${value}"`));
+      }
+      return n;
+    };
+  }
+  function parseFormatArg(name, allowed) {
+    return (value) => {
+      try {
+        return parseFormat(value, allowed, name);
+      } catch (e) {
+        fail(e);
+      }
+    };
+  }
+  function documentInputs(command, verb) {
+    return command.argument(
+      "[paths...]",
+      `Files, directories, or globs to ${verb} (default: the configured collections)`
+    ).option(
+      "--collection <name>",
+      "Configured collection to read (repeatable)",
+      collect,
+      []
+    ).option("--exclude <glob>", "Glob to exclude (repeatable)", collect, []).option("-c, --config <path>", "Path to manni.config.yaml").option("--no-config", "Ignore any discovered config file");
+  }
+  function documentOptions(opts) {
+    const { configPath, noConfig } = configOption(opts.config);
+    return {
+      ...configPath === void 0 ? {} : { config: configPath },
+      ...noConfig === true ? { noConfig } : {},
+      ...opts.collection === void 0 ? {} : { collection: opts.collection },
+      ...opts.exclude === void 0 ? {} : { exclude: opts.exclude }
+    };
+  }
+  documentInputs(
+    program.command("list").description("Show the resolved eval plan per page without running anything"),
+    "list"
+  ).option(
+    "-f, --format <format>",
+    `Output format: ${SUMMARY_FORMATS.join(" | ")}`,
+    parseFormatArg("--format", SUMMARY_FORMATS),
+    "pretty"
+  ).option("--eval <name>", "Show only this eval (repeatable)", collectArg, []).option("--suite <name>", "Show only evals in this suite").action(
+    async (paths, opts, command) => {
+      try {
+        const run = await runList(paths, {
+          ...documentOptions(opts),
+          format: opts.format,
+          evalNames: opts.eval,
+          suite: opts.suite
+        });
+        console.log(
+          renderList(run, opts.format, {
+            color: colorFor(command, process.stdout.isTTY)
+          })
+        );
+        process.exitCode = run.exitCode;
+      } catch (e) {
+        fail(e);
+      }
+    }
+  );
+  documentInputs(
+    program.command("run").description("Run evals against documentation pages"),
+    "evaluate"
+  ).option(
+    "-f, --format <format>",
+    `Output format: ${REPORT_FORMATS.join(" | ")}`,
+    parseFormatArg("--format", REPORT_FORMATS),
+    "pretty"
+  ).option("--deterministic-only", "Run only command/tool graders, skip the AI judge").option("--ai-only", "Run only AI-judged evals, skip deterministic graders").option(
+    // `<kind>`, not `<kind...>`: a variadic option greedily eats the
+    // positional `[paths...]` that follow it, so `--allow-execution
+    // frontmatter-commands docs/**` would silently swallow the glob and run
+    // over the default file set instead. Repeat the flag to grant twice.
+    "--allow-execution <kind>",
+    "Run only these execution grants (repeatable): frontmatter-commands",
+    collectGrant,
+    []
+  ).option("--no-execution", "Clear every execution grant for this run").option("--no-generate", "Do not generate scripts for command evals missing a command").option("--no-cache", "Bypass the judge response cache").option("--fail-on-review", "Exit 1 when any eval lands in the human-review zone").option("--provider <name>", "Judge provider: auto (default) | anthropic | openai | claude-cli | llama-cpp").option("--model <model>", "Model override; needs a named provider, from here or config").option("--local", LOCAL_FLAG_HELP).option("--runs <n>", "Ensemble runs per eval", parseIntArg("--runs")).option(
+    "--chunk-chars <n>",
+    "Characters of page per judge call; longer pages are read in parts",
+    parseIntArg("--chunk-chars")
+  ).option(
+    "--eval <name>",
+    "Run only this eval (repeatable); suite targets are not evaluated on a filtered run",
+    collectArg,
+    []
+  ).option("--suite <name>", "Run only evals in this suite").option(
+    "--since <ref>",
+    "Evaluate only pages whose file or eval manifest changed between this git ref and HEAD"
+  ).option(
+    "--newer-than <duration>",
+    "Evaluate only pages whose file or eval manifest changed within this window, such as 30m, 24h, 7d or 2w; in CI, prefer --since"
+  ).option(
+    "--max-turns <n>",
+    "Stop after this many ensemble runs (a cached ensemble costs none)",
+    parseIntArg("--max-turns")
+  ).option(
+    "--baseline [path]",
+    "Fail only on findings a recorded baseline does not already hold"
+  ).option("--no-baseline", "Ignore the configured baseline for this run").option(
+    "--write-baseline [path]",
+    "Record this run's findings as the baseline; without a path, the configured one"
+  ).action(async (paths, opts, command) => {
+    try {
+      const report = await runRun(paths, {
+        ...documentOptions({
+          config: opts.config,
+          collection: opts.collection,
+          exclude: opts.exclude
+        }),
+        // parseFormatArg validated this at parse time; the cast only re-narrows
+        // from the `unknown` that the Record-typed options bag erases it to.
+        format: opts.format,
+        deterministicOnly: opts.deterministicOnly,
+        aiOnly: opts.aiOnly,
+        // Commander's default is `[]`, which is "no flag", not "run nothing":
+        // only a list someone typed narrows the run.
+        allowExecution: opts.allowExecution.length > 0 ? opts.allowExecution : void 0,
+        execution: opts.execution,
+        generate: opts.generate,
+        cache: opts.cache,
+        failOnReview: opts.failOnReview,
+        provider: opts.provider,
+        model: opts.model,
+        local: opts.local,
+        runs: opts.runs,
+        chunkChars: opts.chunkChars,
+        maxTurns: opts.maxTurns,
+        evalNames: opts.eval,
+        suite: opts.suite,
+        since: opts.since,
+        newerThan: opts.newerThan,
+        // commander collapses `--baseline` to true and `--no-baseline` to
+        // false on the same key; a string is an explicit path.
+        baseline: opts.baseline,
+        writeBaseline: opts.writeBaseline,
+        toolVersion: package_default.version
+      });
+      console.log(
+        render(report, opts.format, {
+          color: colorFor(command, process.stdout.isTTY)
+        })
+      );
+      process.exitCode = report.exitCode;
+    } catch (e) {
+      fail(e);
+    }
+  });
+  documentInputs(
+    program.command("generate").description(
+      "Generate check scripts for command evals with a plain-language assertion but no command"
+    ),
+    "read"
+  ).option("--provider <name>", "Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp").option("--model <model>", "Model override; needs a named provider, from here or config").option("--local", LOCAL_FLAG_HELP).action(
+    async (paths, opts, command) => {
+      try {
+        const pc = palette(colorFor(command, process.stdout.isTTY));
+        const result = await runGenerate(paths, {
+          ...documentOptions(opts),
+          provider: opts.provider,
+          model: opts.model,
+          local: opts.local
+        });
+        if (result.targets === 0) {
+          console.log("Nothing to generate \u2014 every command eval has a command.");
+          return;
+        }
+        console.log(
+          `Generated ${result.generatedPaths.length}/${result.targets} check script(s):`
+        );
+        for (const p of result.generatedPaths) console.log(`  ${p}`);
+        for (const r of result.refusals) console.log(pc.red(`  ${r.message}`));
+        if (result.generatedPaths.length < result.targets) {
+          process.exitCode = 1;
+        }
+      } catch (e) {
+        fail(e);
+      }
+    }
+  );
+  documentInputs(
+    program.command("fill").description(
+      "Propose frontmatter evals for pages with an LLM; writes proposals at or above the confidence threshold"
+    ),
+    "fill"
+  ).option(
+    "-f, --format <format>",
+    `Output format: ${SUMMARY_FORMATS.join(" | ")}`,
+    parseFormatArg("--format", SUMMARY_FORMATS),
+    "pretty"
+  ).option("--dry-run", "Report proposals without writing frontmatter").option(
+    "--confidence <n>",
+    "Minimum confidence to write (0-1, default: config fill.confidenceThreshold)",
+    parseFloatArg("--confidence")
+  ).option(
+    "--max-turns <n>",
+    "Stop after this many inference calls (a cached page costs none)",
+    parseIntArg("--max-turns")
+  ).option("--no-cache", "Bypass the fill proposal cache").option(
+    "--chunk-chars <n>",
+    "Characters of page per fill call; longer pages are proposed in parts",
+    parseIntArg("--chunk-chars")
+  ).option("--provider <name>", "Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp").option("--model <model>", "Model override; needs a named provider, from here or config").option("--local", LOCAL_FLAG_HELP).action(async (paths, opts, command) => {
+    try {
+      const confidence = opts.confidence;
+      if (confidence !== void 0 && confidence > 1) {
+        fail(new DocevalsError(`--confidence must be between 0 and 1, got ${confidence}`));
+      }
+      const report = await runFill(paths, {
+        ...documentOptions({
+          config: opts.config,
+          collection: opts.collection,
+          exclude: opts.exclude
+        }),
+        dryRun: opts.dryRun,
+        confidence,
+        maxTurns: opts.maxTurns,
+        noCache: opts.cache === false ? true : void 0,
+        provider: opts.provider,
+        model: opts.model,
+        local: opts.local,
+        // P1 (proposal 0047): offered only on a terminal, where there is
+        // someone to answer. Off one the evals go to the page and the W1
+        // line says so.
+        confirm: terminalConfirm(),
+        onNotice: notice,
+        onRelocated: (result) => {
+          const manifests = result.manifests.map((m) => m.file).join(", ");
+          notice(
+            `moved ${String(result.summary.moved)} value(s) into ${manifests}.`
+          );
+        }
+      });
+      console.log(
+        renderFill(report, opts.format, {
+          color: colorFor(command, process.stdout.isTTY)
+        })
+      );
+      process.exitCode = report.exitCode;
+    } catch (e) {
+      fail(e);
+    }
+  });
+  documentInputs(
+    program.command("promote").description(
+      "Find ai-graded evals expressible as deterministic checks; --write converts them"
+    ),
+    "read"
+  ).option("--write", "Apply promotions (write scripts and rewrite evals)").option("--provider <name>", "Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp").option("--model <model>", "Model override; needs a named provider, from here or config").option("--local", LOCAL_FLAG_HELP).action(
+    async (paths, opts, command) => {
+      try {
+        const pc = palette(colorFor(command, process.stdout.isTTY));
+        const proposals = await runPromote(paths, {
+          ...documentOptions(opts),
+          write: opts.write,
+          provider: opts.provider,
+          model: opts.model,
+          local: opts.local
+        });
+        if (proposals.length === 0) {
+          console.log("No ai-graded evals found.");
+          return;
+        }
+        for (const p of proposals) {
+          const tag = p.promotable ? p.applied ? pc.green("promoted") : pc.cyan("promotable") : pc.dim("keep-ai");
+          const script = p.scriptPath ? pc.dim(` -> ${p.scriptPath}`) : "";
+          console.log(`${tag} ${p.evalName} (${p.source}, ${p.file})${script}`);
+          console.log(pc.dim(`  ${p.rationale}`));
+          if (p.error !== void 0) console.log(pc.red(`  ${p.error}`));
+        }
+        if (!opts.write && proposals.some((p) => p.promotable)) {
+          console.log(pc.cyan("\nRe-run with --write to apply promotions."));
+        }
+      } catch (e) {
+        fail(e);
+      }
+    }
+  );
+  program.command("calibrate").description(
+    "Measure judge agreement against a human-verified golden set (.manni/docevals/golden/*.yaml)"
+  ).option("-c, --config <path>", "Path to manni.config.yaml").option("--golden <dir>", "Golden set directory", ".manni/docevals/golden").option(
+    "--seed",
+    "Write golden candidates from recorded reviews and exit; judges nothing, needs no provider"
+  ).option("--provider <name>", "Provider: auto (default) | anthropic | openai | claude-cli | llama-cpp").option("--model <model>", "Model override; needs a named provider, from here or config").option("--local", LOCAL_FLAG_HELP).option("--runs <n>", "Ensemble runs per case", parseIntArg("--runs")).option(
+    "--max-turns <n>",
+    "Stop after this many ensemble runs (a cached ensemble costs none)",
+    parseIntArg("--max-turns")
+  ).option("--no-cache", "Bypass the judge response cache").action(
+    async (opts, command) => {
+      try {
+        const color = colorFor(command, process.stdout.isTTY);
+        const pc = palette(color);
+        if (opts.seed) {
+          const seeded = seedGoldenCases({ golden: opts.golden });
+          if (seeded.total === 0) {
+            console.log(
+              "No recorded reviews to seed from \u2014 run `manni docevals review <file> <eval> <pass|fail>` first."
+            );
+            return;
+          }
+          const changed = seeded.added + seeded.updated;
+          console.log(
+            changed === 0 ? `No new reviews to seed \u2014 ${seeded.total} golden case(s) already in ${seeded.path}.` : `Wrote ${changed} golden candidate(s) to ${seeded.path} (${seeded.added} new, ${seeded.updated} updated; ${seeded.total} total).`
+          );
+          if (seeded.unreviewed > 0) {
+            console.log(
+              pc.yellow(
+                `${seeded.unreviewed} case(s) are \`reviewed: false\`. Read them and set \`reviewed: true\` \u2014 a golden set assembled without a human is not one.`
+              )
+            );
+          }
+          return;
+        }
+        const report = await runCalibrate({
+          config: opts.config,
+          golden: opts.golden,
+          provider: opts.provider,
+          model: opts.model,
+          local: opts.local,
+          runs: opts.runs,
+          maxTurns: opts.maxTurns,
+          noCache: opts.cache === false
+        });
+        console.log(renderCalibration(report, { color }));
+        process.exitCode = report.meetsThreshold && report.unjudged === 0 && report.balanced ? 0 : 1;
+      } catch (e) {
+        fail(e);
+      }
+    }
+  );
+  program.command("init").description("Create a starter manni.config.yaml in the current directory").action(() => {
+    try {
+      console.log(`Created ${runInit()}`);
+    } catch (e) {
+      fail(e);
+    }
+  });
+  program.command("review").description(
+    "Record a human verdict for an eval in the human-review zone (or list recorded reviews)"
+  ).argument("[file]", "Page path").argument("[eval]", "Eval name").argument("[verdict]", "pass | fail").option("--reviewer <name>", "Reviewer name recorded with the verdict").option("--note <text>", "Optional note").action(
+    (file, evalName, verdict, opts, command) => {
+      try {
+        if (!file) {
+          console.log(
+            renderReviews(listReviews(), {
+              color: colorFor(command, process.stdout.isTTY)
+            })
+          );
+          return;
+        }
+        if (!evalName || !verdict) {
+          throw new DocevalsError(
+            "Usage: manni docevals review <file> <eval> <pass|fail>"
+          );
+        }
+        const entry = runReview(file, evalName, verdict, opts);
+        console.log(
+          `Recorded ${entry.verdict} for ${entry.evalName} on ${entry.file}`
+        );
+      } catch (e) {
+        fail(e);
+      }
+    }
+  );
+  return program;
+}
+export {
+  buildProgram,
+  colorFor
+};
+//# sourceMappingURL=cli-SRHFUZHA.js.map