@coldtea/pr-lens-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ohans Emmanuel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,117 @@
+# @coldtea/pr-lens-cli
+
+PR Lens on the command line. It reads a diff with your own model key, checks the result against the contract, and hands you the pull request comment.
+
+MIT © Ohans Emmanuel.
+
+```bash
+npx @coldtea/pr-lens-cli analyze --base origin/main
+```
+
+## Bring your own key
+
+The key is read from the environment, never from a flag: a flag lands in shell history and in the log of whatever CI runs it. The diff goes to the provider you name and nowhere else — there is no PR Lens service in this path.
+
+```bash
+export GEMINI_API_KEY=…
+pr-lens analyze --base origin/main --head HEAD
+```
+
+Three request shapes are implemented rather than a list of vendors:
+
+| `--provider` | Endpoint | Key |
+| --- | --- | --- |
+| `gemini` (default) | Google's own API | `GEMINI_API_KEY` |
+| `openai` | OpenAI's own API | `OPENAI_API_KEY` |
+| `openai-compatible` | anything else speaking `/chat/completions`, named by `--base-url` | `OPENAI_API_KEY` |
+
+DeepSeek, Anthropic's compatibility endpoint, OpenRouter, Ollama and llama.cpp are all reached by pointing `--base-url` at them, and a new vendor needs no release here. OpenAI is listed separately from the servers that copied it because the two have drifted: it renamed the output limit to `max_completion_tokens` and its newer models reject `max_tokens`, which is the only spelling the others know. There is no field both accept, so you say which endpoint you are talking to rather than the CLI guessing from a hostname.
+
+```bash
+pr-lens analyze --base origin/main \
+  --provider openai-compatible \
+  --base-url http://localhost:11434/v1 \
+  --model qwen3-coder \
+  --api-key-env OLLAMA_KEY
+```
+
+## The commands
+
+### `analyze`
+
+Diff in, graph document out.
+
+```bash
+pr-lens analyze --base origin/main --pr 42 -o pr-lens/graph.json
+```
+
+The base is the merge base of the two refs, not the tip of the base branch: a diff against the tip would blame this pull request for every change made on the base branch since it forked.
+
+The commit shas, the repository, the pull request number and the line counts are filled in from the repository itself, and anything the model writes there is discarded. A fact the model is free to restate is a fact that eventually disagrees with itself.
+
+The answer is parsed against the contract. If it fails, the validation errors — paths and all — go back to the model once, and only once: a model that cannot fix a named path in one round does not fix it in three. `--dry-run` reports what would be sent and sends nothing.
+
+### `render`
+
+```bash
+pr-lens render pr-lens/graph.json -o pr-lens/
+```
+
+Draws the document as self-contained light and dark SVGs — one pair per drill-down section per lens, or one pair per lens when the document has no sections — and writes two files beside them: `manifest.json`, which says what was drawn and under which file name, and `drawn.graph.json`, the document those pictures actually show.
+
+Both matter to what comes next. The manifest is where `comment` gets its file names, so neither command re-derives the other's. And `drawn.graph.json` exists because this is where corrections are applied: excluding a node can empty out a whole drill-down section, and the renderer then draws no picture for it. A comment composed from the document that went *in* would announce a section that came out of nothing.
+
+The SVGs carry no script and no external reference, and the same document renders to the same bytes every time. `--theme light` or `--theme dark` draws one half of the pair.
+
+### `comment`
+
+```bash
+pr-lens comment --graph pr-lens/drawn.graph.json --manifest pr-lens/manifest.json \
+  --asset-base-url https://raw.githubusercontent.com/owner/repo/pr-lens/42
+```
+
+Composes the markdown — the `<picture>` pairs that read in both GitHub themes, the headline chips, the nested `<details>` tree — and prints it. Each diagram links to itself: a comment column is about 830 pixels wide and a system with several lanes is several times that, so it arrives scaled to fit and one click gives a reader the size the labels were drawn at. The two files have to belong to each other: the manifest records the hash of the document it came from, and a mismatched pair is refused rather than composed into a comment describing diagrams nobody drew. It posts nothing; posting is the caller's business, and `--print-marker` gives that caller the hidden marker that identifies an existing comment to update.
+
+### `validate`
+
+```bash
+pr-lens validate pr-lens/graph.json .github/pr-lens.yml
+```
+
+Parses graph documents, patch documents, render manifests and configs, JSON or YAML, and reports every problem in each rather than only the first. A file with no `kind` field is read as a config, because a config is the only one of the four a person writes by hand.
+
+### `export`
+
+```bash
+pr-lens export pr-lens/graph.json -o .github/pr-lens.map.json
+```
+
+Turns a pull-request document into the map of the system once that pull request has merged: elements the change deletes are dropped — with the edges and flow steps that hung from them — the rest stops being annotated, and the result is stamped with the single commit it reflects.
+
+The map is a snapshot, not a source of truth. Nothing reads it back into the pipeline: a committed map that overrode inference would be hand-maintained rot with merge conflicts attached. Commit it so a repository has something to read, to diff, and to hand an agent.
+
+## Corrections
+
+A repository's `.github/pr-lens.yml` is picked up automatically by `render` and applied at draw time — renames, exclusions, lane pins, groupings. It is an overlay: inference never writes back into it, so a correction keeps holding as the code moves and the model renames things between runs, and the document on disk stays the record of what was inferred.
+
+```yaml
+schemaVersion: 0.1.0
+map:
+  rename:
+    - match: functions/src/broadcast/sendBroadcastBulk.ts
+      to: Broadcast sender
+  exclude:
+    - "**/*.test.ts"
+```
+
+A lane pin may name a lane the document never declared; the band is created and takes the id for its label. And `render` reports any correction that changed nothing about what it drew — a config that has drifted, usually because the file a selector named has moved, otherwise fails silently and forever.
+
+`--config` points elsewhere and `--no-config` ignores it, on both `render` and `analyze` — `analyze` reads only `lenses` from it, since which lenses to fill is a question for extraction and the rest is a question for drawing.
+
+## Failures
+
+Every failure carries a code, so a script can branch on it: `USAGE`, `UNREADABLE_FILE`, `UNKNOWN_DOCUMENT`, `INVALID_DOCUMENT`, `GIT_FAILED`, `EMPTY_DIFF`, `REPOSITORY_UNKNOWN`, `MISSING_API_KEY`, `PROVIDER_FAILED`, `MODEL_OUTPUT_INVALID`, `RENDER_FAILED`. Misuse exits 2, everything else exits 1.
+
+---
+
+Part of [PR Lens](https://prlens.dev) — review what actually matters.

package/dist/args.d.ts

@@ -0,0 +1,18 @@
+import { type ParseArgsConfig } from "node:util";
+type Options = NonNullable<ParseArgsConfig["options"]>;
+/**
+ * `parseArgs` throws a plain `TypeError` on an unknown flag or a missing
+ * value, which would surface as a stack trace. Every one of them is a usage
+ * mistake and reads as one.
+ */
+export declare const parseOptions: <Config extends Options>(args: readonly string[], options: Config) => {
+    values: Record<string, string | boolean | string[] | undefined>;
+    positionals: string[];
+};
+export declare const readString: (value: unknown, flag: string) => string | undefined;
+export declare const readBoolean: (value: unknown) => boolean;
+export declare const readInt: (value: unknown, flag: string, fallback: number) => number;
+export declare const readList: (value: unknown, flag: string) => string[] | undefined;
+export declare const expectOne: (positionals: readonly string[], what: string) => string;
+export {};
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5D,KAAK,OAAO,GAAG,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,SAAS,OAAO,QAC3C,SAAS,MAAM,EAAE,WACd,MAAM,KACd;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAO1F,CAAC;AAEF,eAAO,MAAM,UAAU,UAAW,OAAO,QAAQ,MAAM,KAAG,MAAM,GAAG,SAIlE,CAAC;AAEF,eAAO,MAAM,WAAW,UAAW,OAAO,KAAG,OAAyB,CAAC;AAEvE,eAAO,MAAM,OAAO,UAAW,OAAO,QAAQ,MAAM,YAAY,MAAM,KAAG,MAQxE,CAAC;AAEF,eAAO,MAAM,QAAQ,UAAW,OAAO,QAAQ,MAAM,KAAG,MAAM,EAAE,GAAG,SAIlE,CAAC;AAEF,eAAO,MAAM,SAAS,gBAAiB,SAAS,MAAM,EAAE,QAAQ,MAAM,KAAG,MAKxE,CAAC"}

package/dist/args.js

@@ -0,0 +1,49 @@
+import { parseArgs } from "node:util";
+import { usageError } from "./errors.js";
+/**
+ * `parseArgs` throws a plain `TypeError` on an unknown flag or a missing
+ * value, which would surface as a stack trace. Every one of them is a usage
+ * mistake and reads as one.
+ */
+export const parseOptions = (args, options) => {
+    try {
+        const parsed = parseArgs({ args: [...args], options, allowPositionals: true, strict: true });
+        return { values: parsed.values, positionals: parsed.positionals };
+    }
+    catch (error) {
+        throw usageError(error instanceof Error ? error.message : String(error));
+    }
+};
+export const readString = (value, flag) => {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string")
+        throw usageError(`--${flag} needs a value`);
+    return value;
+};
+export const readBoolean = (value) => value === true;
+export const readInt = (value, flag, fallback) => {
+    const text = readString(value, flag);
+    if (text === undefined)
+        return fallback;
+    const parsed = Number(text);
+    if (!Number.isInteger(parsed) || parsed <= 0)
+        throw usageError(`--${flag} needs a positive whole number, got ${JSON.stringify(text)}`);
+    return parsed;
+};
+export const readList = (value, flag) => {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value))
+        throw usageError(`--${flag} needs a value`);
+    return value.flatMap((entry) => (typeof entry === "string" ? entry.split(",") : []));
+};
+export const expectOne = (positionals, what) => {
+    const [first, ...rest] = positionals;
+    if (first === undefined)
+        throw usageError(`expected ${what}`);
+    if (rest.length > 0)
+        throw usageError(`expected ${what}, got ${positionals.length} arguments`);
+    return first;
+};
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAwB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,IAAuB,EACvB,OAAe,EAC6E,EAAE;IAC9F,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7F,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAE,IAAY,EAAsB,EAAE;IAC7E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,UAAU,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAW,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;AAEvE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,IAAY,EAAE,QAAgB,EAAU,EAAE;IAChF,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAExC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAC1C,MAAM,UAAU,CAAC,KAAK,IAAI,uCAAuC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3F,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAE,IAAY,EAAwB,EAAE;IAC7E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,UAAU,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACvF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,WAA8B,EAAE,IAAY,EAAU,EAAE;IAChF,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAC9D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,UAAU,CAAC,YAAY,IAAI,SAAS,WAAW,CAAC,MAAM,YAAY,CAAC,CAAC;IAC/F,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { run } from "./cli.js";
+import { processTerminal } from "./terminal.js";
+process.exitCode = await run(process.argv.slice(2), processTerminal, process.env).catch((error) => {
+    processTerminal.err(error instanceof Error ? (error.stack ?? error.message) : String(error));
+    return 1;
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CACrF,CAAC,KAAc,EAAE,EAAE;IACjB,eAAe,CAAC,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7F,OAAO,CAAC,CAAC;AACX,CAAC,CACF,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+import type { Terminal } from "./terminal.js";
+export declare const run: (argv: readonly string[], terminal: Terminal, env: Record<string, string | undefined>) => Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAkE9C,eAAO,MAAM,GAAG,SACR,SAAS,MAAM,EAAE,YACb,QAAQ,OACb,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KACtC,OAAO,CAAC,MAAM,CA0ChB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,97 @@
+import { assertNever } from "@coldtea/pr-lens-schema";
+import { analyzeCommand, USAGE as ANALYZE_USAGE } from "./commands/analyze.js";
+import { commentCommand, USAGE as COMMENT_USAGE } from "./commands/comment.js";
+import { exportCommand, USAGE as EXPORT_USAGE } from "./commands/export.js";
+import { renderCommand, USAGE as RENDER_USAGE } from "./commands/render.js";
+import { USAGE as VALIDATE_USAGE, validateCommand } from "./commands/validate.js";
+import { formatError, PrLensCliError } from "./errors.js";
+import { CLI_VERSION } from "./version.js";
+const COMMANDS = ["analyze", "render", "comment", "validate", "export"];
+const isCommand = (value) => COMMANDS.some((command) => command === value);
+const HELP = `pr-lens — review what actually matters
+
+  pr-lens analyze   --base <ref>            a diff, read by your own model, as a graph document
+  pr-lens render    <graph.json>            that document, as light and dark SVGs
+  pr-lens comment   --graph --manifest      the pull request comment, as markdown
+  pr-lens validate  <file...>               any PR Lens document, checked against the contract
+  pr-lens export    <graph.json>            the merged state, as a map worth committing
+
+  pr-lens <command> --help                  what a command takes
+  pr-lens --version
+
+Your model key is read from the environment and goes only to the provider you
+name. https://github.com/coldteadotai/pr-lens`;
+const usageFor = (command) => {
+    switch (command) {
+        case "analyze":
+            return ANALYZE_USAGE;
+        case "render":
+            return RENDER_USAGE;
+        case "comment":
+            return COMMENT_USAGE;
+        case "validate":
+            return VALIDATE_USAGE;
+        case "export":
+            return EXPORT_USAGE;
+        default:
+            return assertNever(command, "Unhandled command");
+    }
+};
+const dispatch = (command, args, terminal, env) => {
+    switch (command) {
+        case "analyze":
+            return analyzeCommand(args, terminal, env);
+        case "render":
+            return renderCommand(args, terminal);
+        case "comment":
+            return commentCommand(args, terminal);
+        case "validate":
+            return validateCommand(args, terminal);
+        case "export":
+            return exportCommand(args, terminal);
+        default:
+            return assertNever(command, "Unhandled command");
+    }
+};
+const EXIT_OK = 0;
+const EXIT_FAILED = 1;
+const EXIT_MISUSED = 2;
+export const run = async (argv, terminal, env) => {
+    const [name, ...args] = argv;
+    if (name === undefined) {
+        terminal.err(HELP);
+        return EXIT_MISUSED;
+    }
+    if (name === "--help" || name === "-h" || name === "help") {
+        terminal.out(HELP);
+        return EXIT_OK;
+    }
+    if (name === "--version" || name === "-v") {
+        terminal.out(CLI_VERSION);
+        return EXIT_OK;
+    }
+    if (!isCommand(name)) {
+        terminal.err(formatError(new PrLensCliError("USAGE", `unknown command ${JSON.stringify(name)}`)));
+        terminal.err(HELP);
+        return EXIT_MISUSED;
+    }
+    if (args.includes("--help") || args.includes("-h")) {
+        terminal.out(usageFor(name));
+        return EXIT_OK;
+    }
+    try {
+        await dispatch(name, args, terminal, env);
+        return EXIT_OK;
+    }
+    catch (error) {
+        if (!(error instanceof PrLensCliError))
+            throw error;
+        terminal.err(formatError(error));
+        if (error.code !== "USAGE")
+            return EXIT_FAILED;
+        terminal.err("");
+        terminal.err(usageFor(name));
+        return EXIT_MISUSED;
+    }
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/analyze.d.ts

@@ -0,0 +1,4 @@
+import type { Terminal } from "../terminal.js";
+export declare const USAGE: string;
+export declare const analyzeCommand: (args: readonly string[], terminal: Terminal, env: Record<string, string | undefined>) => Promise<void>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/commands/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO/C,eAAO,MAAM,KAAK,QAsB+D,CAAC;AAyBlF,eAAO,MAAM,cAAc,SACnB,SAAS,MAAM,EAAE,YACb,QAAQ,OACb,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KACtC,OAAO,CAAC,IAAI,CAyId,CAAC"}

package/dist/commands/analyze.js

@@ -0,0 +1,158 @@
+import { LENSES } from "@coldtea/pr-lens-schema";
+import { createRequire } from "node:module";
+import { parseOptions, readBoolean, readInt, readList, readString } from "../args.js";
+import { discoverConfig, loadConfig } from "../config-file.js";
+import { PrLensCliError, usageError } from "../errors.js";
+import { extractGraph } from "../extract.js";
+import { collectDiff, mergeBase, parseRepoSlug, remoteSlug, repositoryRoot, resolveCommit } from "../git.js";
+import { readTextFile, writeJsonFile } from "../io.js";
+import { buildExtractionPrompt, SYSTEM_PROMPT } from "../prompt.js";
+import { completeJson, isProviderId, PROVIDER_IDS, resolveProvider } from "../providers/index.js";
+import { CLI_VERSION, GENERATOR_NAME } from "../version.js";
+const DEFAULT_OUT = "pr-lens/graph.json";
+const DEFAULT_MAX_OUTPUT_TOKENS = 32_768;
+const DEFAULT_MAX_DIFF_BYTES = 400_000;
+export const USAGE = `pr-lens analyze --base <ref> [options]
+
+Reads the diff between two commits and asks your own model to describe it as a
+graph document. The key never leaves your machine: it is read from the
+environment, and the diff goes straight to the provider you name.
+
+  --base <ref>              what the change is measured against (required)
+  --head <ref>              the tip of the change (default HEAD)
+  --repo <dir>              repository to read (default .)
+  --provider <id>           ${PROVIDER_IDS.join(" | ")} (default gemini)
+  --model <name>            model to ask (required for openai-compatible)
+  --base-url <url>          provider endpoint, for a compatible or local server
+  --api-key-env <name>      environment variable holding the key
+  --lens <lens>             ${LENSES.join(", ")} (repeatable, default both)
+  --config <file>           read the lenses from this config (default the repository's)
+  --no-config               ignore the repository's config
+  --pr <number>             pull request number, recorded in provenance
+  --repo-slug <owner/name>  override the slug read from the git remote
+  --remote <name>           remote to read the slug from (default origin)
+  --max-diff-bytes <n>      truncate the diff sent to the model (default ${DEFAULT_MAX_DIFF_BYTES})
+  --max-output-tokens <n>   room for the answer (default ${DEFAULT_MAX_OUTPUT_TOKENS})
+  --dry-run                 report what would be sent, and send nothing
+  -o, --out <file>          where to write the document (default ${DEFAULT_OUT})`;
+const readLenses = (values) => {
+    const requested = readList(values.lens, "lens");
+    if (requested === undefined)
+        return undefined;
+    const unknown = requested.filter((lens) => !LENSES.some((known) => known === lens));
+    if (unknown.length > 0)
+        throw usageError(`unknown lens ${unknown.join(", ")}`, `known lenses: ${LENSES.join(", ")}`);
+    return LENSES.filter((lens) => requested.includes(lens));
+};
+const readProviderId = (values) => {
+    const id = readString(values.provider, "provider") ?? "gemini";
+    if (!isProviderId(id))
+        throw usageError(`unknown provider ${JSON.stringify(id)}`, `known providers: ${PROVIDER_IDS.join(", ")}`);
+    return id;
+};
+const graphJsonSchema = () => readTextFile(createRequire(import.meta.url).resolve("@coldtea/pr-lens-schema/json-schema/graph-doc.schema.json"));
+export const analyzeCommand = async (args, terminal, env) => {
+    const { values, positionals } = parseOptions(args, {
+        base: { type: "string" },
+        head: { type: "string" },
+        repo: { type: "string" },
+        provider: { type: "string" },
+        model: { type: "string" },
+        "base-url": { type: "string" },
+        "api-key-env": { type: "string" },
+        lens: { type: "string", multiple: true },
+        config: { type: "string" },
+        "no-config": { type: "boolean" },
+        pr: { type: "string" },
+        "repo-slug": { type: "string" },
+        remote: { type: "string" },
+        "max-diff-bytes": { type: "string" },
+        "max-output-tokens": { type: "string" },
+        "dry-run": { type: "boolean" },
+        out: { type: "string", short: "o" },
+    });
+    if (positionals.length > 0)
+        throw usageError(`analyze takes no positional arguments, got ${positionals.join(" ")}`);
+    const base = readString(values.base, "base");
+    if (base === undefined)
+        throw usageError("--base is required", "it names the commit the change is measured against, e.g. --base origin/main");
+    const repo = readString(values.repo, "repo") ?? process.cwd();
+    const head = readString(values.head, "head") ?? "HEAD";
+    const maxDiffBytes = readInt(values["max-diff-bytes"], "max-diff-bytes", DEFAULT_MAX_DIFF_BYTES);
+    const slugOption = readString(values["repo-slug"], "repo-slug");
+    const slug = slugOption === undefined
+        ? await remoteSlug(repo, readString(values.remote, "remote") ?? "origin")
+        : parseRepoSlug(slugOption);
+    if (slug === undefined)
+        throw new PrLensCliError("REPOSITORY_UNKNOWN", "cannot tell which repository this is", "pass --repo-slug owner/name, or add a git remote the CLI can read");
+    const configPath = readString(values.config, "config");
+    const configured = readBoolean(values["no-config"])
+        ? undefined
+        : configPath === undefined
+            ? await discoverConfig(await repositoryRoot(repo))
+            : await loadConfig(configPath);
+    const requestedLenses = readLenses(values);
+    const lenses = requestedLenses ?? configured?.config.lenses ?? [...LENSES];
+    const headCommit = await resolveCommit(repo, head);
+    const baseCommit = await resolveCommit(repo, base);
+    const comparedAgainst = await mergeBase(repo, baseCommit.sha, headCommit.sha);
+    const diff = await collectDiff(repo, comparedAgainst, headCommit.sha, maxDiffBytes);
+    if (diff.files.length === 0)
+        throw new PrLensCliError("EMPTY_DIFF", `${base} and ${head} have the same content`, "there is nothing to draw");
+    const promptContext = {
+        repo: { owner: slug.owner, name: slug.name },
+        base: { sha: comparedAgainst, ref: baseCommit.ref },
+        head: { sha: headCommit.sha, ref: headCommit.ref },
+        diff,
+        lenses,
+    };
+    const user = buildExtractionPrompt(promptContext, await graphJsonSchema());
+    const provider = readBoolean(values["dry-run"])
+        ? undefined
+        : resolveProvider({
+            id: readProviderId(values),
+            model: readString(values.model, "model"),
+            baseUrl: readString(values["base-url"], "base-url"),
+            apiKeyEnv: readString(values["api-key-env"], "api-key-env"),
+        }, env);
+    terminal.err(`${diff.files.length} files, +${diff.additions} -${diff.deletions}, ${Buffer.byteLength(diff.patch, "utf8")} bytes of diff${diff.truncatedAt === undefined ? "" : " (truncated)"}`);
+    terminal.err(`prompt: ${Buffer.byteLength(user, "utf8")} bytes`);
+    if (provider === undefined) {
+        terminal.out(`✓ dry run — nothing was sent, and nothing was written`);
+        return;
+    }
+    const pr = values.pr === undefined ? undefined : readInt(values.pr, "pr", 0);
+    const pullRequest = pr === undefined
+        ? undefined
+        : { number: pr, url: `https://${slug.host}/${slug.owner}/${slug.name}/pull/${pr}` };
+    const provenance = {
+        repo: slug,
+        base: { sha: comparedAgainst, ref: baseCommit.ref },
+        head: { sha: headCommit.sha, ref: headCommit.ref },
+        ...(pullRequest === undefined ? {} : { pullRequest }),
+        generator: { name: GENERATOR_NAME, version: CLI_VERSION, model: provider.model },
+    };
+    terminal.err(`asking ${provider.id} (${provider.model})…`);
+    const { document, attempts } = await extractGraph({
+        system: SYSTEM_PROMPT,
+        user,
+        maxOutputTokens: readInt(values["max-output-tokens"], "max-output-tokens", DEFAULT_MAX_OUTPUT_TOKENS),
+        known: {
+            provenance,
+            lenses,
+            stats: {
+                filesChanged: diff.files.length,
+                additions: diff.additions,
+                deletions: diff.deletions,
+            },
+            generatedAt: new Date().toISOString(),
+        },
+        onAttempt: (attempt) => {
+            if (attempt > 1)
+                terminal.err(`the document did not validate — asking for a correction`);
+        },
+    }, (request) => completeJson(provider, request));
+    const written = await writeJsonFile(readString(values.out, "out") ?? DEFAULT_OUT, document);
+    terminal.out(`✓ ${written} — ${document.nodes.length} nodes, ${document.edges.length} edges, ${document.flows.length} flows${attempts > 1 ? ` (${attempts} attempts)` : ""}`);
+};
+//# sourceMappingURL=analyze.js.map

package/dist/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"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"}

package/dist/commands/comment.d.ts

@@ -0,0 +1,4 @@
+import type { Terminal } from "../terminal.js";
+export declare const USAGE = "pr-lens comment --graph <graph.json> --manifest <manifest.json> [options]\n\nComposes the pull request comment: the diagrams as light/dark <picture> pairs,\nthe headline numbers, and the drill-down tree. It posts nothing \u2014 the markdown\ngoes to stdout, or to a file, for whatever does the posting.\n\n      --graph <file>          the document that was rendered \u2014 the one the render\n                              wrote beside the manifest, not the one it read\n      --manifest <file>       what the render produced (required)\n      --asset-base-url <url>  where the rendered SVGs are published, when the\n                              manifest records local paths\n      --config <file>         read 'branding' from a repository config\n      --no-branding           leave off the PR Lens footer\n      --print-marker          print the hidden marker that identifies the\n                              comment, and nothing else\n  -o, --out <file>            write the markdown here instead of stdout";
+export declare const commentCommand: (args: readonly string[], terminal: Terminal) => Promise<void>;
+//# sourceMappingURL=comment.d.ts.map

package/dist/commands/comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../src/commands/comment.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,eAAO,MAAM,KAAK,0/BAesD,CAAC;AAEzE,eAAO,MAAM,cAAc,SAAgB,SAAS,MAAM,EAAE,YAAY,QAAQ,KAAG,OAAO,CAAC,IAAI,CAkD9F,CAAC"}

package/dist/commands/comment.js

@@ -0,0 +1,63 @@
+import { graphContentHash } from "@coldtea/pr-lens-renderer";
+import { parseOptions, readBoolean, readString } from "../args.js";
+import { composeComment, COMMENT_MARKER } from "../comment.js";
+import { loadConfig } from "../config-file.js";
+import { readGraphDoc, readRenderManifest } from "../document.js";
+import { usageError } from "../errors.js";
+import { writeTextFile } from "../io.js";
+export const USAGE = `pr-lens comment --graph <graph.json> --manifest <manifest.json> [options]
+
+Composes the pull request comment: the diagrams as light/dark <picture> pairs,
+the headline numbers, and the drill-down tree. It posts nothing — the markdown
+goes to stdout, or to a file, for whatever does the posting.
+
+      --graph <file>          the document that was rendered — the one the render
+                              wrote beside the manifest, not the one it read
+      --manifest <file>       what the render produced (required)
+      --asset-base-url <url>  where the rendered SVGs are published, when the
+                              manifest records local paths
+      --config <file>         read 'branding' from a repository config
+      --no-branding           leave off the PR Lens footer
+      --print-marker          print the hidden marker that identifies the
+                              comment, and nothing else
+  -o, --out <file>            write the markdown here instead of stdout`;
+export const commentCommand = async (args, terminal) => {
+    const { values, positionals } = parseOptions(args, {
+        graph: { type: "string" },
+        manifest: { type: "string" },
+        "asset-base-url": { type: "string" },
+        config: { type: "string" },
+        "no-branding": { type: "boolean" },
+        "print-marker": { type: "boolean" },
+        out: { type: "string", short: "o" },
+    });
+    if (positionals.length > 0)
+        throw usageError(`comment takes no positional arguments, got ${positionals.join(" ")}`);
+    if (readBoolean(values["print-marker"])) {
+        terminal.out(COMMENT_MARKER);
+        return;
+    }
+    const graphPath = readString(values.graph, "graph");
+    const manifestPath = readString(values.manifest, "manifest");
+    if (graphPath === undefined || manifestPath === undefined)
+        throw usageError("--graph and --manifest are both required");
+    const configPath = readString(values.config, "config");
+    const configured = configPath === undefined ? undefined : await loadConfig(configPath);
+    const graph = await readGraphDoc(graphPath);
+    const manifest = await readRenderManifest(manifestPath);
+    if (graphContentHash(graph) !== manifest.graph.contentHash)
+        throw usageError(`${graphPath} is not the document ${manifestPath} describes`, "corrections change what the diagrams show, so a comment built from a different document would announce sections that were never drawn. Pass the drawn.graph.json the render wrote beside the manifest");
+    const body = composeComment({
+        graph,
+        manifest,
+        assetBaseUrl: readString(values["asset-base-url"], "asset-base-url"),
+        branding: readBoolean(values["no-branding"]) ? false : (configured?.config.branding ?? true),
+    });
+    const out = readString(values.out, "out");
+    if (out === undefined) {
+        terminal.out(body.trimEnd());
+        return;
+    }
+    terminal.err(`✓ ${await writeTextFile(out, body)}`);
+};
+//# sourceMappingURL=comment.js.map

package/dist/commands/comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.js","sourceRoot":"","sources":["../../src/commands/comment.ts"],"names":[],"mappings":"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"}

package/dist/commands/export.d.ts

@@ -0,0 +1,4 @@
+import type { Terminal } from "../terminal.js";
+export declare const USAGE = "pr-lens export <graph.json> [options]\n\nTurns a pull-request document into the stored map of the system once that pull\nrequest has merged: elements the change deletes are dropped, the rest stops\nbeing annotated, and the result is stamped with the single commit it reflects.\n\nThe map is a snapshot, not a source of truth \u2014 nothing reads it back into the\npipeline. Committing it gives a repository something to read, to diff, and to\nhand an agent.\n\n  -o, --out <file>   where to write it (default .github/pr-lens.map.json)\n      --id <id>      map id, so a patch can name it (default <owner>/<name>)\n      --sha <sha>    the commit it reflects, in full (default the document's head)";
+export declare const exportCommand: (args: readonly string[], terminal: Terminal) => Promise<void>;
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,eAAO,MAAM,KAAK,6rBAYiE,CAAC;AAEpF,eAAO,MAAM,aAAa,SAAgB,SAAS,MAAM,EAAE,YAAY,QAAQ,KAAG,OAAO,CAAC,IAAI,CAqC7F,CAAC"}