@coldtea/pr-lens-cli 0.1.0

package/dist/providers/gemini.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { cutOff, postJson, unreadableResponse } from "./http.js";
+/**
+ * Reasoning parts come back in the same array as the answer and must not be
+ * concatenated into it.
+ */
+const Response = z.object({
+    candidates: z
+        .array(z.object({
+        content: z
+            .object({ parts: z.array(z.object({ text: z.string().optional(), thought: z.boolean().optional() })).optional() })
+            .optional(),
+        finishReason: z.string().optional(),
+    }))
+        .optional(),
+});
+export const geminiCompleteJson = async (provider, request) => {
+    const body = await postJson(`${provider.baseUrl}/models/${provider.model}:generateContent`, { "x-goog-api-key": provider.apiKey }, {
+        systemInstruction: { parts: [{ text: request.system }] },
+        contents: request.turns.map((turn) => ({ role: turn.role, parts: [{ text: turn.text }] })),
+        generationConfig: {
+            responseMimeType: "application/json",
+            temperature: 0,
+            maxOutputTokens: request.maxOutputTokens,
+        },
+    });
+    const parsed = Response.safeParse(body);
+    if (!parsed.success)
+        throw unreadableResponse("Gemini", "the response did not have the shape the API documents");
+    const candidate = parsed.data.candidates?.[0];
+    if (candidate === undefined)
+        throw unreadableResponse("Gemini", "the response carried no candidate — the prompt may have been blocked");
+    const text = (candidate.content?.parts ?? [])
+        .filter((part) => part.thought !== true)
+        .map((part) => part.text ?? "")
+        .join("");
+    if (text.trim() === "") {
+        if (candidate.finishReason === "MAX_TOKENS")
+            throw cutOff("Gemini");
+        throw unreadableResponse("Gemini", `finish reason: ${candidate.finishReason ?? "unknown"}`);
+    }
+    if (candidate.finishReason === "MAX_TOKENS")
+        throw cutOff("Gemini");
+    return text;
+};
+//# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGjE;;;GAGG;AACH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IACxB,UAAU,EAAE,CAAC;SACV,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;aACP,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;aACjH,QAAQ,EAAE;QACb,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACpC,CAAC,CACH;SACA,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,QAAkB,EAClB,OAAuB,EACN,EAAE;IACnB,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,GAAG,QAAQ,CAAC,OAAO,WAAW,QAAQ,CAAC,KAAK,kBAAkB,EAC9D,EAAE,gBAAgB,EAAE,QAAQ,CAAC,MAAM,EAAE,EACrC;QACE,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE;QACxD,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1F,gBAAgB,EAAE;YAChB,gBAAgB,EAAE,kBAAkB;YACpC,WAAW,EAAE,CAAC;YACd,eAAe,EAAE,OAAO,CAAC,eAAe;SACzC;KACF,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO;QACjB,MAAM,kBAAkB,CAAC,QAAQ,EAAE,uDAAuD,CAAC,CAAC;IAE9F,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,SAAS,KAAK,SAAS;QACzB,MAAM,kBAAkB,CAAC,QAAQ,EAAE,sEAAsE,CAAC,CAAC;IAE7G,MAAM,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;SAC1C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;SACvC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;SAC9B,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvB,IAAI,SAAS,CAAC,YAAY,KAAK,YAAY;YAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpE,MAAM,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,SAAS,CAAC,YAAY,IAAI,SAAS,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,SAAS,CAAC,YAAY,KAAK,YAAY;QAAE,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEpE,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/providers/http.d.ts

@@ -0,0 +1,5 @@
+import { PrLensCliError } from "../errors.js";
+export declare const postJson: (url: string, headers: Record<string, string>, body: unknown) => Promise<unknown>;
+export declare const cutOff: (provider: string) => PrLensCliError;
+export declare const unreadableResponse: (provider: string, detail: string) => PrLensCliError;
+//# sourceMappingURL=http.d.ts.map

package/dist/providers/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/providers/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAO9C,eAAO,MAAM,QAAQ,QACd,MAAM,WACF,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QACzB,OAAO,KACZ,OAAO,CAAC,OAAO,CAgCjB,CAAC;AAEF,eAAO,MAAM,MAAM,aAAc,MAAM,KAAG,cAKvC,CAAC;AAEJ,eAAO,MAAM,kBAAkB,aAAc,MAAM,UAAU,MAAM,KAAG,cACgB,CAAC"}

package/dist/providers/http.js

@@ -0,0 +1,26 @@
+import { PrLensCliError } from "../errors.js";
+/** Long enough for a reasoning model on a large diff, short enough to fail a stuck CI job. */
+const REQUEST_TIMEOUT_MS = 300_000;
+const MAX_ERROR_BODY_CHARS = 600;
+export const postJson = async (url, headers, body) => {
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { "content-type": "application/json", ...headers },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+    }).catch((error) => {
+        throw new PrLensCliError("PROVIDER_FAILED", `the request to ${url} did not complete`, error instanceof Error ? error.message : String(error));
+    });
+    const text = await response.text();
+    if (!response.ok)
+        throw new PrLensCliError("PROVIDER_FAILED", `${url} answered ${response.status} ${response.statusText}`, text.slice(0, MAX_ERROR_BODY_CHARS));
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new PrLensCliError("PROVIDER_FAILED", `${url} answered with something that is not JSON`, text.slice(0, MAX_ERROR_BODY_CHARS));
+    }
+};
+export const cutOff = (provider) => new PrLensCliError("PROVIDER_FAILED", `${provider} stopped before finishing the document`, "the answer hit the output token limit — raise --max-output-tokens, or narrow the diff with --base");
+export const unreadableResponse = (provider, detail) => new PrLensCliError("PROVIDER_FAILED", `${provider} returned no usable text`, detail);
+//# sourceMappingURL=http.js.map

package/dist/providers/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/providers/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,8FAA8F;AAC9F,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAC3B,GAAW,EACX,OAA+B,EAC/B,IAAa,EACK,EAAE;IACpB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE;QAC3D,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,kBAAkB,CAAC;KAChD,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC1B,MAAM,IAAI,cAAc,CACtB,iBAAiB,EACjB,kBAAkB,GAAG,mBAAmB,EACxC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnC,IAAI,CAAC,QAAQ,CAAC,EAAE;QACd,MAAM,IAAI,cAAc,CACtB,iBAAiB,EACjB,GAAG,GAAG,aAAa,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAC3D,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CACpC,CAAC;IAEJ,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CACtB,iBAAiB,EACjB,GAAG,GAAG,2CAA2C,EACjD,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CACpC,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,QAAgB,EAAkB,EAAE,CACzD,IAAI,cAAc,CAChB,iBAAiB,EACjB,GAAG,QAAQ,wCAAwC,EACnD,mGAAmG,CACpG,CAAC;AAEJ,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAAgB,EAAE,MAAc,EAAkB,EAAE,CACrF,IAAI,cAAc,CAAC,iBAAiB,EAAE,GAAG,QAAQ,0BAA0B,EAAE,MAAM,CAAC,CAAC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Three shapes rather than a list of vendors: Gemini's own API, OpenAI's own
+ * API, and the `/chat/completions` shape everyone else copied from it.
+ *
+ * OpenAI is separate 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 DeepSeek,
+ * Ollama and llama.cpp know. Everything else about the request is shared, and
+ * a new vendor still needs no code here — only a `--base-url`.
+ */
+export declare const PROVIDER_IDS: readonly ["gemini", "openai", "openai-compatible"];
+export type ProviderId = (typeof PROVIDER_IDS)[number];
+export declare const isProviderId: (value: string) => value is ProviderId;
+export type Provider = {
+    id: ProviderId;
+    model: string;
+    apiKey: string;
+    baseUrl: string;
+};
+export type Turn = {
+    role: "user" | "model";
+    text: string;
+};
+export type JsonCompletion = {
+    system: string;
+    turns: readonly Turn[];
+    maxOutputTokens: number;
+};
+type ProviderDefaults = {
+    apiKeyEnv: string;
+    baseUrl: string | undefined;
+    model: string | undefined;
+};
+export declare const providerDefaults: (id: ProviderId) => ProviderDefaults;
+export type ProviderOptions = {
+    id: ProviderId;
+    model: string | undefined;
+    baseUrl: string | undefined;
+    apiKeyEnv: string | undefined;
+};
+/**
+ * The key is read from the environment and never accepted as an argument: a
+ * flag would land in shell history and in a CI log line.
+ */
+export declare const resolveProvider: (options: ProviderOptions, env: Record<string, string | undefined>) => Provider;
+export declare const completeJson: (provider: Provider, request: JsonCompletion) => Promise<string>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,YAAI,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,CAAU,CAAC;AAC/E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,YAAY,UAAW,MAAM,KAAG,KAAK,IAAI,UACb,CAAC;AAE1C,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,OAAQ,UAAU,KAAG,gBAuBjD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,UAAU,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,YACjB,eAAe,OACnB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KACtC,QA6BF,CAAC;AAEF,eAAO,MAAM,YAAY,aAAc,QAAQ,WAAW,cAAc,KAAG,OAAO,CAAC,MAAM,CAWxF,CAAC"}

package/dist/providers/index.js

@@ -0,0 +1,71 @@
+import { assertNever } from "@coldtea/pr-lens-schema";
+import { PrLensCliError } from "../errors.js";
+import { geminiCompleteJson } from "./gemini.js";
+import { openAiCompleteJson } from "./openai.js";
+/**
+ * Three shapes rather than a list of vendors: Gemini's own API, OpenAI's own
+ * API, and the `/chat/completions` shape everyone else copied from it.
+ *
+ * OpenAI is separate 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 DeepSeek,
+ * Ollama and llama.cpp know. Everything else about the request is shared, and
+ * a new vendor still needs no code here — only a `--base-url`.
+ */
+export const PROVIDER_IDS = ["gemini", "openai", "openai-compatible"];
+export const isProviderId = (value) => PROVIDER_IDS.some((id) => id === value);
+export const providerDefaults = (id) => {
+    switch (id) {
+        case "gemini":
+            return {
+                apiKeyEnv: "GEMINI_API_KEY",
+                baseUrl: "https://generativelanguage.googleapis.com/v1beta",
+                model: "gemini-3.7-flash",
+            };
+        case "openai":
+            return {
+                apiKeyEnv: "OPENAI_API_KEY",
+                baseUrl: "https://api.openai.com/v1",
+                model: undefined,
+            };
+        case "openai-compatible":
+            return {
+                apiKeyEnv: "OPENAI_API_KEY",
+                baseUrl: undefined,
+                model: undefined,
+            };
+        default:
+            return assertNever(id, "Unhandled provider");
+    }
+};
+/**
+ * The key is read from the environment and never accepted as an argument: a
+ * flag would land in shell history and in a CI log line.
+ */
+export const resolveProvider = (options, env) => {
+    const defaults = providerDefaults(options.id);
+    const apiKeyEnv = options.apiKeyEnv ?? defaults.apiKeyEnv;
+    const apiKey = env[apiKeyEnv];
+    if (apiKey === undefined || apiKey === "")
+        throw new PrLensCliError("MISSING_API_KEY", `${apiKeyEnv} is not set`, `export ${apiKeyEnv} with your own key, or point --api-key-env at the variable that holds it`);
+    const model = options.model ?? defaults.model;
+    if (model === undefined)
+        throw new PrLensCliError("USAGE", `--model is required for the ${options.id} provider`, "the endpoint decides which model names exist, so there is no default worth guessing");
+    const baseUrl = options.baseUrl ?? defaults.baseUrl;
+    if (baseUrl === undefined)
+        throw new PrLensCliError("USAGE", "--base-url is required for an openai-compatible provider", "it is the endpoint that is compatible: point it at DeepSeek, OpenRouter, Ollama or your own server. For OpenAI itself, use --provider openai");
+    return { id: options.id, model, apiKey, baseUrl: baseUrl.replace(/\/+$/, "") };
+};
+export const completeJson = (provider, request) => {
+    switch (provider.id) {
+        case "gemini":
+            return geminiCompleteJson(provider, request);
+        case "openai":
+            return openAiCompleteJson(provider, request, "max_completion_tokens");
+        case "openai-compatible":
+            return openAiCompleteJson(provider, request, "max_tokens");
+        default:
+            return assertNever(provider.id, "Unhandled provider");
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

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

package/dist/providers/openai.d.ts

@@ -0,0 +1,17 @@
+import type { JsonCompletion, Provider } from "./index.js";
+/**
+ * What an output limit is called on this endpoint.
+ *
+ * OpenAI renamed the field to `max_completion_tokens` and its newer models
+ * reject the old one; the servers that copied the API before that rename —
+ * DeepSeek, Ollama, llama.cpp and the rest — only know `max_tokens`. There is
+ * no spelling both accept, so the caller says which endpoint it is talking to
+ * rather than the request guessing from a hostname.
+ */
+export type TokenLimitField = "max_tokens" | "max_completion_tokens";
+/**
+ * The `/chat/completions` shape. The system prompt is the first message rather
+ * than a separate field.
+ */
+export declare const openAiCompleteJson: (provider: Provider, request: JsonCompletion, tokenLimitField: TokenLimitField) => Promise<string>;
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAa3D;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,uBAAuB,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,aACnB,QAAQ,WACT,cAAc,mBACN,eAAe,KAC/B,OAAO,CAAC,MAAM,CAiChB,CAAC"}

package/dist/providers/openai.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { cutOff, postJson, unreadableResponse } from "./http.js";
+const Response = z.object({
+    choices: z
+        .array(z.object({
+        message: z.object({ content: z.string().nullable().optional() }).optional(),
+        finish_reason: z.string().nullable().optional(),
+    }))
+        .optional(),
+});
+/**
+ * The `/chat/completions` shape. The system prompt is the first message rather
+ * than a separate field.
+ */
+export const openAiCompleteJson = async (provider, request, tokenLimitField) => {
+    const body = await postJson(`${provider.baseUrl}/chat/completions`, { authorization: `Bearer ${provider.apiKey}` }, {
+        model: provider.model,
+        temperature: 0,
+        [tokenLimitField]: request.maxOutputTokens,
+        response_format: { type: "json_object" },
+        messages: [
+            { role: "system", content: request.system },
+            ...request.turns.map((turn) => ({
+                role: turn.role === "model" ? "assistant" : "user",
+                content: turn.text,
+            })),
+        ],
+    });
+    const parsed = Response.safeParse(body);
+    if (!parsed.success)
+        throw unreadableResponse("the provider", "the response did not have the shape /chat/completions documents");
+    const choice = parsed.data.choices?.[0];
+    if (choice === undefined)
+        throw unreadableResponse("the provider", "the response carried no choice");
+    if (choice.finish_reason === "length")
+        throw cutOff("the provider");
+    const text = choice.message?.content ?? "";
+    if (text.trim() === "")
+        throw unreadableResponse("the provider", `finish reason: ${choice.finish_reason ?? "unknown"}`);
+    return text;
+};
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGjE,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IACxB,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC3E,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KAChD,CAAC,CACH;SACA,QAAQ,EAAE;CACd,CAAC,CAAC;AAaH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,QAAkB,EAClB,OAAuB,EACvB,eAAgC,EACf,EAAE;IACnB,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,GAAG,QAAQ,CAAC,OAAO,mBAAmB,EACtC,EAAE,aAAa,EAAE,UAAU,QAAQ,CAAC,MAAM,EAAE,EAAE,EAC9C;QACE,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,CAAC;QACd,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,eAAe;QAC1C,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;QACxC,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE;YAC3C,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;gBAClD,OAAO,EAAE,IAAI,CAAC,IAAI;aACnB,CAAC,CAAC;SACJ;KACF,CACF,CAAC;IAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO;QACjB,MAAM,kBAAkB,CAAC,cAAc,EAAE,iEAAiE,CAAC,CAAC;IAE9G,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,kBAAkB,CAAC,cAAc,EAAE,gCAAgC,CAAC,CAAC;IAErG,IAAI,MAAM,CAAC,aAAa,KAAK,QAAQ;QAAE,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;IAEpE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QACpB,MAAM,kBAAkB,CAAC,cAAc,EAAE,kBAAkB,MAAM,CAAC,aAAa,IAAI,SAAS,EAAE,CAAC,CAAC;IAElG,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/snapshot.d.ts

@@ -0,0 +1,15 @@
+import { type GraphDoc, type Parsed } from "@coldtea/pr-lens-schema";
+export type StoredMapOptions = {
+    id: string;
+    sha: string;
+    generatedAt: string;
+};
+/**
+ * The map a repository commits: the merged state of the system, identified,
+ * stamped with the one commit it reflects, and carrying no annotations.
+ *
+ * Change statistics are dropped rather than carried over. A line count
+ * describes a diff, and this document no longer describes one.
+ */
+export declare const toStoredMap: (graph: GraphDoc, options: StoredMapOptions) => Parsed<GraphDoc>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,QAAQ,EACb,KAAK,MAAM,EAEZ,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAqCF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,UAAW,QAAQ,WAAW,gBAAgB,KAAG,MAAM,CAAC,QAAQ,CAyCvF,CAAC"}

package/dist/snapshot.js

@@ -0,0 +1,77 @@
+import { applyPatch, formatIssues, graphSnapshotIssues, PrLensSchemaError, safeParseGraphDoc, } from "@coldtea/pr-lens-schema";
+const withoutRemovedMessages = (flow) => flow.messages.filter((message) => message.delta !== "removed");
+/**
+ * A pull-request document says what a change did; a stored map says what the
+ * system is once it has been done. So elements the change deletes go, and the
+ * rest stops being annotated.
+ *
+ * The deletions run through `applyPatch` rather than a filter, because
+ * removing a node also strands its edges, its flow steps, the drill-down views
+ * that pointed at it and the layout hints that named it — the contract already
+ * owns that cascade and there is no second version of it here.
+ */
+const deletionOps = (graph) => {
+    const flowOps = graph.flows.flatMap((flow) => {
+        const messages = withoutRemovedMessages(flow);
+        if (flow.delta === "removed" || messages.length === 0)
+            return [{ op: "remove_flow", id: flow.id }];
+        if (messages.length === flow.messages.length)
+            return [];
+        return [{ op: "update_flow", id: flow.id, patch: { messages } }];
+    });
+    return [
+        ...flowOps,
+        ...graph.edges
+            .filter((edge) => edge.delta === "removed")
+            .map((edge) => ({ op: "remove_edge", id: edge.id })),
+        ...graph.nodes
+            .filter((node) => node.delta === "removed")
+            .map((node) => ({ op: "remove_node", id: node.id })),
+        ...graph.lanes
+            .filter((lane) => lane.delta === "removed")
+            .map((lane) => ({ op: "remove_lane", id: lane.id })),
+    ];
+};
+/**
+ * The map a repository commits: the merged state of the system, identified,
+ * stamped with the one commit it reflects, and carrying no annotations.
+ *
+ * Change statistics are dropped rather than carried over. A line count
+ * describes a diff, and this document no longer describes one.
+ */
+export const toStoredMap = (graph, options) => {
+    const applied = applyPatch(graph, deletionOps(graph));
+    if (!applied.ok)
+        return applied;
+    const merged = applied.value;
+    const head = { ...merged.provenance.head, sha: options.sha };
+    const candidate = {
+        ...merged,
+        id: options.id,
+        generatedAt: options.generatedAt,
+        provenance: { ...merged.provenance, base: head, head },
+        stats: undefined,
+        lanes: merged.lanes.map(({ delta: _delta, ...lane }) => lane),
+        nodes: merged.nodes.map((node) => ({ ...node, delta: "unchanged" })),
+        edges: merged.edges.map((edge) => ({ ...edge, delta: "unchanged" })),
+        flows: merged.flows.map((flow) => ({
+            ...flow,
+            delta: "unchanged",
+            messages: withoutRemovedMessages(flow).map((message) => ({
+                ...message,
+                delta: "unchanged",
+            })),
+        })),
+    };
+    const parsed = safeParseGraphDoc(candidate);
+    if (!parsed.ok)
+        return parsed;
+    const issues = graphSnapshotIssues(parsed.value);
+    if (issues.length > 0)
+        return {
+            ok: false,
+            error: new PrLensSchemaError("NOT_A_SNAPSHOT", `the exported document is not a stored map:\n${formatIssues(issues)}`, issues),
+        };
+    return parsed;
+};
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

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

package/dist/terminal.d.ts

@@ -0,0 +1,6 @@
+export type Terminal = {
+    out: (line: string) => void;
+    err: (line: string) => void;
+};
+export declare const processTerminal: Terminal;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,QAG7B,CAAC"}

package/dist/terminal.js

@@ -0,0 +1,5 @@
+export const processTerminal = {
+    out: (line) => process.stdout.write(`${line}\n`),
+    err: (line) => process.stderr.write(`${line}\n`),
+};
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../src/terminal.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,eAAe,GAAa;IACvC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;IAChD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;CACjD,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+/** Recorded on every document this CLI produces, as the generator's version. */
+export declare const CLI_VERSION = "0.1.0";
+export declare const GENERATOR_NAME = "pr-lens-cli";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,eAAO,MAAM,cAAc,gBAAgB,CAAC"}

package/dist/version.js

@@ -0,0 +1,4 @@
+/** Recorded on every document this CLI produces, as the generator's version. */
+export const CLI_VERSION = "0.1.0";
+export const GENERATOR_NAME = "pr-lens-cli";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@coldtea/pr-lens-cli",
+  "version": "0.1.0",
+  "description": "The PR Lens command line: turn a pull request diff into a schema-valid graph with your own model key, render it, and compose the comment.",
+  "license": "MIT",
+  "author": "Ohans Emmanuel",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coldteadotai/pr-lens.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/coldteadotai/pr-lens/tree/main/packages/cli#readme",
+  "keywords": [
+    "pr-lens",
+    "code-review",
+    "architecture-diagram",
+    "data-flow",
+    "cli",
+    "byok"
+  ],
+  "type": "module",
+  "bin": {
+    "pr-lens": "./dist/bin.js"
+  },
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.11"
+  },
+  "dependencies": {
+    "yaml": "^2.8.1",
+    "zod": "^4.4.3",
+    "@coldtea/pr-lens-renderer": "^0.1.0",
+    "@coldtea/pr-lens-schema": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/args.ts

@@ -0,0 +1,52 @@
+import { parseArgs, type ParseArgsConfig } from "node:util";
+import { usageError } from "./errors.js";
+
+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 const parseOptions = <Config extends Options>(
+  args: readonly string[],
+  options: Config,
+): { values: Record<string, string | boolean | string[] | undefined>; positionals: string[] } => {
+  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: unknown, flag: string): string | undefined => {
+  if (value === undefined) return undefined;
+  if (typeof value !== "string") throw usageError(`--${flag} needs a value`);
+  return value;
+};
+
+export const readBoolean = (value: unknown): boolean => value === true;
+
+export const readInt = (value: unknown, flag: string, fallback: number): number => {
+  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: unknown, flag: string): string[] | undefined => {
+  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: readonly string[], what: string): string => {
+  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;
+};

package/src/bin.ts

@@ -0,0 +1,10 @@
+#!/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: unknown) => {
+    processTerminal.err(error instanceof Error ? (error.stack ?? error.message) : String(error));
+    return 1;
+  },
+);