@pseolint/core 0.1.0 → 0.2.0

package/dist/ai/adapters/index.d.ts

@@ -0,0 +1,53 @@
+import type { LanguageModel } from "ai";
+import type { AiOptions } from "../../types.js";
+/**
+ * How the provider factory is constructed from the imported SDK package.
+ * - `cloud-apikey` — `factory({ apiKey })` then `provider(modelId)`.
+ * - `ollama`       — `factory({ baseURL })` then `provider(modelId)`.
+ */
+export type ProviderKind = "cloud-apikey" | "ollama";
+interface ProviderEntry {
+    /** npm package name to dynamically import at runtime. */
+    pkg: string;
+    /** Named export from the package, e.g. `createAnthropic`. */
+    factoryName: string;
+    /** Env var that holds the API key. Optional — Ollama has none. */
+    envVar?: string;
+    /** Default model id when the user does not specify one. */
+    defaultModel: string;
+    kind: ProviderKind;
+}
+/**
+ * Registry of supported AI SDK providers.
+ *
+ * To add a provider: drop a new entry here and publish the corresponding
+ * `@ai-sdk/*` package as an optional peer dep in core's `package.json`.
+ * Users install only the providers they use.
+ */
+declare const PROVIDER_REGISTRY: Record<string, ProviderEntry>;
+/** Known provider ids plus any user-supplied string (validated at runtime). */
+export type ProviderId = keyof typeof PROVIDER_REGISTRY | (string & {});
+export interface ResolvedModel {
+    model: LanguageModel;
+    providerId: string;
+    modelId: string;
+}
+/**
+ * Best-effort provider auto-detection.
+ *
+ * Resolution order:
+ *   1. First cloud provider (in `CLOUD_DETECT_ORDER`) with its env var set.
+ *   2. Ollama daemon responding at `<endpoint>/` → "ollama".
+ *   3. Otherwise `null`.
+ */
+export declare function detectProvider(endpoint?: string): Promise<string | null>;
+/**
+ * Resolve an AI SDK `LanguageModel` for the requested (or auto-detected) provider.
+ *
+ * Provider SDKs are loaded lazily via dynamic `import(specifier)` so unused
+ * providers don't need to be installed. If the chosen provider's package is
+ * missing, the error message includes an install hint.
+ */
+export declare function createLanguageModel(config: AiOptions): Promise<ResolvedModel>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;AAErD,UAAU,aAAa;IACrB,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED;;;;;;GAMG;AACH,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAwDpD,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAgBD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgB9E;AAaD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAsDnF"}

package/dist/ai/adapters/index.js

@@ -0,0 +1,158 @@
+/**
+ * Registry of supported AI SDK providers.
+ *
+ * To add a provider: drop a new entry here and publish the corresponding
+ * `@ai-sdk/*` package as an optional peer dep in core's `package.json`.
+ * Users install only the providers they use.
+ */
+const PROVIDER_REGISTRY = {
+    anthropic: {
+        pkg: "@ai-sdk/anthropic",
+        factoryName: "createAnthropic",
+        envVar: "ANTHROPIC_API_KEY",
+        defaultModel: "claude-sonnet-4-6",
+        kind: "cloud-apikey",
+    },
+    openai: {
+        pkg: "@ai-sdk/openai",
+        factoryName: "createOpenAI",
+        envVar: "OPENAI_API_KEY",
+        defaultModel: "gpt-4o-mini",
+        kind: "cloud-apikey",
+    },
+    google: {
+        pkg: "@ai-sdk/google",
+        factoryName: "createGoogleGenerativeAI",
+        envVar: "GOOGLE_GENERATIVE_AI_API_KEY",
+        defaultModel: "gemini-2.5-flash",
+        kind: "cloud-apikey",
+    },
+    mistral: {
+        pkg: "@ai-sdk/mistral",
+        factoryName: "createMistral",
+        envVar: "MISTRAL_API_KEY",
+        defaultModel: "mistral-small-latest",
+        kind: "cloud-apikey",
+    },
+    groq: {
+        pkg: "@ai-sdk/groq",
+        factoryName: "createGroq",
+        envVar: "GROQ_API_KEY",
+        defaultModel: "llama-3.3-70b-versatile",
+        kind: "cloud-apikey",
+    },
+    xai: {
+        pkg: "@ai-sdk/xai",
+        factoryName: "createXai",
+        envVar: "XAI_API_KEY",
+        defaultModel: "grok-2",
+        kind: "cloud-apikey",
+    },
+    cohere: {
+        pkg: "@ai-sdk/cohere",
+        factoryName: "createCohere",
+        envVar: "COHERE_API_KEY",
+        defaultModel: "command-r-plus",
+        kind: "cloud-apikey",
+    },
+    ollama: {
+        pkg: "ollama-ai-provider-v2",
+        factoryName: "createOllama",
+        defaultModel: "llama3.1:8b",
+        kind: "ollama",
+    },
+};
+const OLLAMA_DETECT_TIMEOUT_MS = 500;
+const DEFAULT_OLLAMA_ENDPOINT = "http://localhost:11434";
+/** Cloud providers checked in priority order during auto-detection. */
+const CLOUD_DETECT_ORDER = [
+    "anthropic",
+    "openai",
+    "google",
+    "mistral",
+    "groq",
+    "xai",
+    "cohere",
+];
+/**
+ * Best-effort provider auto-detection.
+ *
+ * Resolution order:
+ *   1. First cloud provider (in `CLOUD_DETECT_ORDER`) with its env var set.
+ *   2. Ollama daemon responding at `<endpoint>/` → "ollama".
+ *   3. Otherwise `null`.
+ */
+export async function detectProvider(endpoint) {
+    for (const id of CLOUD_DETECT_ORDER) {
+        const entry = PROVIDER_REGISTRY[id];
+        if (entry?.envVar && process.env[entry.envVar])
+            return id;
+    }
+    const url = (endpoint ?? DEFAULT_OLLAMA_ENDPOINT).replace(/\/+$/, "") + "/";
+    try {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), OLLAMA_DETECT_TIMEOUT_MS);
+        const res = await fetch(url, { method: "HEAD", signal: ctrl.signal });
+        clearTimeout(timer);
+        if (res.status >= 200 && res.status < 500)
+            return "ollama";
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function supportedProviderList() {
+    return Object.keys(PROVIDER_REGISTRY).join(", ");
+}
+function envVarList() {
+    return CLOUD_DETECT_ORDER
+        .map((id) => PROVIDER_REGISTRY[id]?.envVar)
+        .filter((v) => Boolean(v))
+        .join(", ");
+}
+/**
+ * Resolve an AI SDK `LanguageModel` for the requested (or auto-detected) provider.
+ *
+ * Provider SDKs are loaded lazily via dynamic `import(specifier)` so unused
+ * providers don't need to be installed. If the chosen provider's package is
+ * missing, the error message includes an install hint.
+ */
+export async function createLanguageModel(config) {
+    const providerId = config.provider ?? (await detectProvider(config.endpoint));
+    if (!providerId) {
+        throw new Error(`No AI provider detected. Set an API key env var (${envVarList()}), run Ollama locally, or pass --ai-provider explicitly.`);
+    }
+    const entry = PROVIDER_REGISTRY[providerId];
+    if (!entry) {
+        throw new Error(`Unknown AI provider "${providerId}". Supported: ${supportedProviderList()}. To add a provider, submit a PR with an entry in PROVIDER_REGISTRY.`);
+    }
+    let pkgExports;
+    try {
+        // Variable specifier — prevents tsc from trying to resolve the module at build time.
+        const specifier = entry.pkg;
+        pkgExports = (await import(specifier));
+    }
+    catch (e) {
+        const original = e instanceof Error ? e.message : String(e);
+        throw new Error(`Provider "${providerId}" requires "${entry.pkg}". Install it with: npm install ${entry.pkg}\nOriginal: ${original}`);
+    }
+    const factory = pkgExports[entry.factoryName];
+    if (typeof factory !== "function") {
+        throw new Error(`Provider "${providerId}": package "${entry.pkg}" does not export "${entry.factoryName}"`);
+    }
+    const modelId = config.model ?? entry.defaultModel;
+    if (entry.kind === "ollama") {
+        const baseURL = (config.endpoint ?? DEFAULT_OLLAMA_ENDPOINT).replace(/\/+$/, "") + "/api";
+        const ollama = factory({ baseURL });
+        return { model: ollama(modelId), providerId, modelId };
+    }
+    // cloud-apikey
+    const apiKey = config.apiKey ?? (entry.envVar ? process.env[entry.envVar] : undefined);
+    if (!apiKey) {
+        throw new Error(`Provider "${providerId}" needs an API key. Set ${entry.envVar} or pass --ai-key / ai.apiKey.`);
+    }
+    const provider = factory({ apiKey });
+    return { model: provider(modelId), providerId, modelId };
+}
+//# sourceMappingURL=index.js.map

package/dist/ai/adapters/index.js.map

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

package/dist/ai/cache.d.ts

@@ -0,0 +1,11 @@
+import type { TriageResult } from "./types.js";
+interface KeyInput {
+    findingsHash: string;
+    model: string;
+    promptVersion: string;
+}
+export declare function triageCacheKey(input: KeyInput): string;
+export declare function readTriageCache(dir: string, key: string, ttlMs: number): Promise<TriageResult | null>;
+export declare function writeTriageCache(dir: string, key: string, result: TriageResult): Promise<void>;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/ai/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/ai/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,UAAU,QAAQ;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAOD,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAItD;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkB3G;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpG"}

package/dist/ai/cache.js

@@ -0,0 +1,40 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+export function triageCacheKey(input) {
+    return createHash("sha256")
+        .update(`${input.findingsHash}|${input.model}|${input.promptVersion}`)
+        .digest("hex");
+}
+export async function readTriageCache(dir, key, ttlMs) {
+    const path = join(dir, `${key}.json`);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let entry;
+    try {
+        entry = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof entry.cachedAt !== "string" || typeof entry.result !== "object")
+        return null;
+    const ageMs = Date.now() - new Date(entry.cachedAt).getTime();
+    if (Number.isNaN(ageMs) || ageMs > ttlMs)
+        return null;
+    return entry.result;
+}
+export async function writeTriageCache(dir, key, result) {
+    await mkdir(dir, { recursive: true });
+    const path = join(dir, `${key}.json`);
+    const tmp = `${path}.tmp`;
+    const entry = { cachedAt: new Date().toISOString(), result };
+    await writeFile(tmp, JSON.stringify(entry), "utf8");
+    await rename(tmp, path);
+}
+//# sourceMappingURL=cache.js.map

package/dist/ai/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/ai/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAcjC,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,GAAG,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;SACrE,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,GAAW,EAAE,KAAa;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;IACtC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAkB,CAAC;IACvB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACxF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9D,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,KAAK;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,GAAW,EAAE,MAAoB;IACnF,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC;IAC1B,MAAM,KAAK,GAAgB,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC;IAC1E,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/ai/cost.d.ts

@@ -0,0 +1,3 @@
+import type { TokenUsage } from "./types.js";
+export declare function estimateCostUsd(providerId: string, model: string, usage: TokenUsage): number | undefined;
+//# sourceMappingURL=cost.d.ts.map

package/dist/ai/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/ai/cost.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAsB7C,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAKxG"}

package/dist/ai/cost.js

@@ -0,0 +1,22 @@
+/**
+ * Best-effort pricing table. Missing entries return `undefined` — callers
+ * must treat unknown cost as "not estimable" rather than zero. Ollama and
+ * other local providers intentionally return undefined.
+ */
+const PRICING = {
+    "anthropic:claude-sonnet-4-6": { inputPerM: 3.0, outputPerM: 15.0 },
+    "anthropic:claude-opus-4-7": { inputPerM: 15.0, outputPerM: 75.0 },
+    "anthropic:claude-haiku-4-5-20251001": { inputPerM: 0.8, outputPerM: 4.0 },
+    "openai:gpt-4o": { inputPerM: 2.5, outputPerM: 10.0 },
+    "openai:gpt-4o-mini": { inputPerM: 0.15, outputPerM: 0.6 },
+    "google:gemini-2.5-pro": { inputPerM: 1.25, outputPerM: 10.0 },
+    "google:gemini-2.5-flash": { inputPerM: 0.3, outputPerM: 2.5 },
+};
+export function estimateCostUsd(providerId, model, usage) {
+    const key = `${providerId}:${model}`;
+    const pricing = PRICING[key];
+    if (!pricing)
+        return undefined;
+    return (usage.input / 1_000_000) * pricing.inputPerM + (usage.output / 1_000_000) * pricing.outputPerM;
+}
+//# sourceMappingURL=cost.js.map

package/dist/ai/cost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.js","sourceRoot":"","sources":["../../src/ai/cost.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,OAAO,GAAiC;IAC5C,6BAA6B,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;IACnE,2BAA2B,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IAClE,qCAAqC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;IAC1E,eAAe,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE;IACrD,oBAAoB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE;IAC1D,uBAAuB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IAC9D,yBAAyB,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE;CAC/D,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,KAAa,EAAE,KAAiB;IAClF,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,KAAK,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;AACzG,CAAC"}

package/dist/ai/feedback-prompt.d.ts

@@ -0,0 +1,22 @@
+export type FeedbackRating = "helpful" | "unhelpful" | "skipped";
+export interface PromptOptions {
+    /** Maximum time to wait for user input in milliseconds. Default: 15000. */
+    timeoutMs?: number;
+    /** Input stream (defaults to process.stdin). Must be a TTY. */
+    input?: NodeJS.ReadableStream;
+    /** Output stream (defaults to process.stderr). Must be a TTY. */
+    output?: NodeJS.WritableStream;
+}
+/**
+ * Prompts the user once for triage feedback (y/n/skip).
+ *
+ * Returns "skipped" immediately on non-TTY or if either stream is not a TTY.
+ * Waits up to timeoutMs for input; if no input is received, returns "skipped".
+ *
+ * Accepted responses (case-insensitive):
+ *   - helpful:   "y", "yes", "helpful"
+ *   - unhelpful: "n", "no", "unhelpful"
+ *   - anything else (including empty) returns "skipped".
+ */
+export declare function promptTriageFeedback(opts?: PromptOptions): Promise<FeedbackRating>;
+//# sourceMappingURL=feedback-prompt.d.ts.map

package/dist/ai/feedback-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-prompt.d.ts","sourceRoot":"","sources":["../../src/ai/feedback-prompt.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,cAAc,CAAC,CAuBzB"}

package/dist/ai/feedback-prompt.js

@@ -0,0 +1,39 @@
+import readline from "node:readline";
+/**
+ * Prompts the user once for triage feedback (y/n/skip).
+ *
+ * Returns "skipped" immediately on non-TTY or if either stream is not a TTY.
+ * Waits up to timeoutMs for input; if no input is received, returns "skipped".
+ *
+ * Accepted responses (case-insensitive):
+ *   - helpful:   "y", "yes", "helpful"
+ *   - unhelpful: "n", "no", "unhelpful"
+ *   - anything else (including empty) returns "skipped".
+ */
+export async function promptTriageFeedback(opts = {}) {
+    const input = opts.input ?? process.stdin;
+    const output = opts.output ?? process.stderr;
+    const inIsTty = input.isTTY === true;
+    const outIsTty = output.isTTY === true;
+    if (!inIsTty || !outIsTty)
+        return "skipped";
+    const timeoutMs = opts.timeoutMs ?? 15000;
+    const rl = readline.createInterface({ input, output, terminal: true });
+    output.write("\nWas this triage helpful? [y/n/skip] ");
+    try {
+        const answer = await Promise.race([
+            new Promise((resolve) => rl.once("line", resolve)),
+            new Promise((resolve) => setTimeout(() => resolve(""), timeoutMs)),
+        ]);
+        const t = answer.trim().toLowerCase();
+        if (t === "y" || t === "yes" || t === "helpful")
+            return "helpful";
+        if (t === "n" || t === "no" || t === "unhelpful")
+            return "unhelpful";
+        return "skipped";
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=feedback-prompt.js.map

package/dist/ai/feedback-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-prompt.js","sourceRoot":"","sources":["../../src/ai/feedback-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAarC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAsB,EAAE;IAExB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,MAAM,OAAO,GAAI,KAAwC,CAAC,KAAK,KAAK,IAAI,CAAC;IACzE,MAAM,QAAQ,GAAI,MAAyC,CAAC,KAAK,KAAK,IAAI,CAAC;IAC3E,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAE5C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC1C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAEvD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAS;YACxC,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC1D,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;SAC3E,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAClE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,WAAW;YAAE,OAAO,WAAW,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/ai/prompt.d.ts

@@ -0,0 +1,10 @@
+import type { RuleResult } from "../types.js";
+export declare const PROMPT_VERSION = "1.0.0";
+export declare const MAX_FINDINGS_IN_PROMPT = 200;
+export interface PromptRequest {
+    system: string;
+    user: string;
+}
+export declare function assignFindingId(f: RuleResult): string;
+export declare function buildPromptRequest(findings: RuleResult[], pageCount: number): PromptRequest;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/ai/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/ai/prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAe1C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAMrD;AAmBD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CA8B3F"}

package/dist/ai/prompt.js

@@ -0,0 +1,51 @@
+import { createHash } from "node:crypto";
+export const PROMPT_VERSION = "1.0.0";
+export const MAX_FINDINGS_IN_PROMPT = 200;
+const SEVERITY_ORDER = { info: 0, warning: 1, error: 2, critical: 3 };
+const SYSTEM_PROMPT = `You are an SEO audit triage assistant. Given a list of pSEO linter findings, identify 1-5 underlying ROOT CAUSES driving the findings. Group findings by shared underlying problem, not by rule ID. Rank causes by likely SEO impact (highest first).
+
+Rules:
+- Emit rootCauses FIRST, then narrative — do not reverse this order.
+- Keep each rootCause label <= 80 chars and phrase it as a problem statement.
+- Keep each rationale to 1-2 sentences (about 30-40 words max).
+- fixOrder starts at 1 for the highest-priority root cause.
+- Use only finding ids that appear in the input for relatedFindingIds.
+- narrative is a SHORT 1-2 sentence overall summary (about 30 words max).
+- Be concise. This is a structured report, not prose.`;
+export function assignFindingId(f) {
+    const hash = createHash("sha256")
+        .update((f.pageUrl ?? "") + "|" + f.message)
+        .digest("hex")
+        .slice(0, 8);
+    return `${f.ruleId}:${hash}`;
+}
+export function buildPromptRequest(findings, pageCount) {
+    const total = findings.length;
+    const sorted = [...findings].sort((a, b) => SEVERITY_ORDER[b.severity] - SEVERITY_ORDER[a.severity]);
+    const truncated = total > MAX_FINDINGS_IN_PROMPT;
+    const projected = sorted.slice(0, MAX_FINDINGS_IN_PROMPT).map((f) => ({
+        id: assignFindingId(f),
+        ruleId: f.ruleId,
+        severity: f.severity,
+        message: f.message,
+        pageUrl: f.pageUrl,
+        group: f.group,
+    }));
+    const payload = {
+        totalFindings: total,
+        pageCount,
+        truncated,
+        findings: projected,
+    };
+    if (truncated) {
+        const counts = {};
+        for (const f of findings)
+            counts[f.ruleId] = (counts[f.ruleId] ?? 0) + 1;
+        payload.findingCountByRule = counts;
+    }
+    return {
+        system: SYSTEM_PROMPT,
+        user: JSON.stringify(payload),
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/ai/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/ai/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,MAAM,cAAc,GAA6B,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAEhG,MAAM,aAAa,GAAG;;;;;;;;;sDASgC,CAAC;AAOvD,MAAM,UAAU,eAAe,CAAC,CAAa;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;SAC3C,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,OAAO,GAAG,CAAC,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;AAC/B,CAAC;AAmBD,MAAM,UAAU,kBAAkB,CAAC,QAAsB,EAAE,SAAiB;IAC1E,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrG,MAAM,SAAS,GAAG,KAAK,GAAG,sBAAsB,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC;QACvF,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;QACtB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,KAAK,EAAE,CAAC,CAAC,KAAK;KACf,CAAC,CAAC,CAAC;IAEJ,MAAM,OAAO,GAAkB;QAC7B,aAAa,EAAE,KAAK;QACpB,SAAS;QACT,SAAS;QACT,QAAQ,EAAE,SAAS;KACpB,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,QAAQ;YAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACzE,OAAO,CAAC,kBAAkB,GAAG,MAAM,CAAC;IACtC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/ai/triage.d.ts

@@ -0,0 +1,22 @@
+import { type LanguageModel } from "ai";
+import type { RuleResult } from "../types.js";
+import type { TriageResult } from "./types.js";
+export interface TriageOptions {
+    enabled: boolean;
+    model: LanguageModel;
+    providerId: string;
+    modelId: string;
+    maxInputTokens?: number;
+    maxOutputTokens?: number;
+    cache?: {
+        dir: string;
+        ttlMs: number;
+    } | false;
+    signal?: AbortSignal;
+}
+export interface TriageOutcome {
+    result?: TriageResult;
+    skipReason?: string;
+}
+export declare function triageFindings(findings: RuleResult[], pageCount: number, options: TriageOptions): Promise<TriageOutcome>;
+//# sourceMappingURL=triage.d.ts.map

package/dist/ai/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/ai/triage.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA2B/C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAeD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,UAAU,EAAE,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CA+FxB"}

package/dist/ai/triage.js

@@ -0,0 +1,123 @@
+import { createHash } from "node:crypto";
+import { generateObject } from "ai";
+import { z } from "zod";
+import { PROMPT_VERSION, MAX_FINDINGS_IN_PROMPT, assignFindingId, buildPromptRequest, } from "./prompt.js";
+import { readTriageCache, writeTriageCache, triageCacheKey } from "./cache.js";
+import { estimateCostUsd } from "./cost.js";
+const SEVERITIES = ["info", "warning", "error", "critical"];
+const rootCauseSchema = z.object({
+    label: z.string().min(1).max(80).describe("Short problem statement, <= 80 chars."),
+    findingsCount: z.number().int().nonnegative().describe("How many of the input findings this root cause covers."),
+    affectedRuleIds: z.array(z.string()).describe("Rule IDs (e.g. spam/near-duplicate) whose findings share this root cause."),
+    severity: z.enum(SEVERITIES).describe("Overall severity of this root cause: info | warning | error | critical."),
+    fixOrder: z.number().int().min(1).describe("1-indexed order to fix this in. 1 = highest priority."),
+    rationale: z.string().min(1).describe("1-2 sentences: why this matters and how to fix it."),
+    relatedFindingIds: z.array(z.string()).describe("IDs (from the input `findings[].id`) of findings attributed to this root cause. Use only IDs that appear in the input."),
+});
+const triagePayloadSchema = z.object({
+    rootCauses: z.array(rootCauseSchema).min(1).max(5).describe("1 to 5 root causes, ranked by SEO impact (highest first)."),
+    narrative: z.string().min(1).describe("2-3 sentence overall summary of the audit state."),
+});
+const DEFAULT_MAX_INPUT_TOKENS = 60_000;
+const DEFAULT_MAX_OUTPUT_TOKENS = 4_000;
+function hashFindings(findings) {
+    const ids = findings.map(assignFindingId).sort();
+    return createHash("sha256").update(ids.join("|")).digest("hex");
+}
+/** Rough token estimate: ~4 chars per token. Used only for the pre-flight cap. */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+export async function triageFindings(findings, pageCount, options) {
+    if (options.signal?.aborted) {
+        return { skipReason: "aborted before triage started" };
+    }
+    const req = buildPromptRequest(findings, pageCount);
+    const truncatedInput = findings.length > MAX_FINDINGS_IN_PROMPT;
+    const maxInputTokens = options.maxInputTokens ?? DEFAULT_MAX_INPUT_TOKENS;
+    const estimate = estimateTokens(req.system + req.user);
+    if (estimate > maxInputTokens) {
+        return { skipReason: `pre-flight token estimate ${estimate} exceeds cap ${maxInputTokens}` };
+    }
+    const validIds = new Set();
+    for (const f of findings)
+        validIds.add(assignFindingId(f));
+    const cacheKey = triageCacheKey({
+        findingsHash: hashFindings(findings),
+        model: options.modelId,
+        promptVersion: PROMPT_VERSION,
+    });
+    if (options.cache) {
+        try {
+            const cached = await readTriageCache(options.cache.dir, cacheKey, options.cache.ttlMs);
+            if (cached) {
+                return { result: { ...cached, cacheHit: true } };
+            }
+        }
+        catch {
+            // cache read errors are non-fatal — fall through to fresh call
+        }
+    }
+    let generated;
+    try {
+        generated = await generateObject({
+            model: options.model,
+            system: req.system,
+            prompt: req.user,
+            schema: triagePayloadSchema,
+            maxOutputTokens: options.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS,
+            abortSignal: options.signal,
+        });
+    }
+    catch (e) {
+        const err = e;
+        if (err?.name === "AbortError" || (err?.message && /abort/i.test(err.message))) {
+            return { skipReason: "aborted during LLM call" };
+        }
+        let detail = err?.message ?? String(e);
+        if (err && typeof err === "object" && "text" in err && typeof err.text === "string") {
+            detail += ` | raw=${err.text.slice(0, 400)}`;
+        }
+        if (err?.cause) {
+            try {
+                detail += ` | cause=${JSON.stringify(err.cause).slice(0, 400)}`;
+            }
+            catch { /* ignore */ }
+        }
+        return { skipReason: `LLM call failed: ${detail}` };
+    }
+    // Validate relatedFindingIds reference known findings (semantic check
+    // beyond the structural schema enforcement performed by generateObject).
+    for (const [i, c] of generated.object.rootCauses.entries()) {
+        for (const id of c.relatedFindingIds) {
+            if (!validIds.has(id)) {
+                return { skipReason: `LLM returned unknown finding id at rootCauses[${i}]: ${id}` };
+            }
+        }
+    }
+    const usage = {
+        input: generated.usage.inputTokens ?? 0,
+        output: generated.usage.outputTokens ?? 0,
+    };
+    const result = {
+        rootCauses: generated.object.rootCauses,
+        narrative: generated.object.narrative,
+        modelUsed: options.modelId,
+        providerId: options.providerId,
+        tokenUsage: usage,
+        estimatedCostUsd: estimateCostUsd(options.providerId, options.modelId, usage),
+        cacheHit: false,
+        promptVersion: PROMPT_VERSION,
+        truncatedInput,
+    };
+    if (options.cache) {
+        try {
+            await writeTriageCache(options.cache.dir, cacheKey, result);
+        }
+        catch {
+            // cache write errors are non-fatal
+        }
+    }
+    return { result };
+}
+//# sourceMappingURL=triage.js.map

package/dist/ai/triage.js.map

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