@polishd/next 0.1.0

package/dist/ai/providers.js

@@ -0,0 +1,142 @@
+/** Sensible default model per provider, used when none is configured. */
+export const DEFAULT_MODEL = {
+    // Anthropic's most capable model; the owner can downgrade for cost.
+    anthropic: "claude-opus-4-8",
+    openai: "gpt-4o-mini",
+    "openai-compatible": "gpt-4o-mini",
+    google: "gemini-1.5-flash",
+};
+/**
+ * Default cap. Reasoning models (e.g. the Claude 4.x family) spend output
+ * tokens on internal thinking before the visible text, and those count against
+ * `max_tokens` — so the cap needs generous headroom beyond the paragraph we
+ * actually want. It's a worst-case ceiling, not expected spend: providers bill
+ * only tokens actually generated.
+ */
+const DEFAULT_MAX_OUTPUT_TOKENS = 2048;
+class ProviderError extends Error {
+}
+async function postJson(url, headers, body) {
+    let res;
+    try {
+        res = await fetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json", ...headers },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        throw new ProviderError(`network error contacting model provider: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const raw = await res.text();
+    if (!res.ok) {
+        // Surface the provider's message but trim it so a key never lands in a log.
+        const detail = raw.slice(0, 300).replace(/\s+/g, " ").trim();
+        throw new ProviderError(`provider returned ${res.status}: ${detail}`);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new ProviderError("provider returned a non-JSON response");
+    }
+}
+function num(v) {
+    return typeof v === "number" && Number.isFinite(v) ? v : undefined;
+}
+// ── Anthropic Messages API ───────────────────────────────────────────────────
+async function callAnthropic(s, system, user, maxTokens) {
+    const data = (await postJson("https://api.anthropic.com/v1/messages", { "x-api-key": s.apiKey, "anthropic-version": "2023-06-01" }, {
+        model: s.model || DEFAULT_MODEL.anthropic,
+        max_tokens: maxTokens,
+        system,
+        messages: [{ role: "user", content: user }],
+    }));
+    const text = (data.content ?? [])
+        .filter((b) => b.type === "text" && typeof b.text === "string")
+        .map((b) => b.text)
+        .join("")
+        .trim();
+    return {
+        text,
+        truncated: data.stop_reason === "max_tokens",
+        usage: {
+            inputTokens: num(data.usage?.input_tokens),
+            outputTokens: num(data.usage?.output_tokens),
+        },
+    };
+}
+// ── OpenAI (and OpenAI-compatible) Chat Completions ──────────────────────────
+async function callOpenAI(s, system, user, maxTokens) {
+    const base = (s.baseUrl?.replace(/\/$/, "") || "https://api.openai.com/v1");
+    const data = (await postJson(`${base}/chat/completions`, { authorization: `Bearer ${s.apiKey}` }, {
+        model: s.model || DEFAULT_MODEL.openai,
+        max_tokens: maxTokens,
+        messages: [
+            { role: "system", content: system },
+            { role: "user", content: user },
+        ],
+    }));
+    const text = (data.choices?.[0]?.message?.content ?? "").trim();
+    return {
+        text,
+        truncated: data.choices?.[0]?.finish_reason === "length",
+        usage: {
+            inputTokens: num(data.usage?.prompt_tokens),
+            outputTokens: num(data.usage?.completion_tokens),
+        },
+    };
+}
+// ── Google Gemini generateContent ────────────────────────────────────────────
+async function callGoogle(s, system, user, maxTokens) {
+    const model = s.model || DEFAULT_MODEL.google;
+    const data = (await postJson(`https://generativelanguage.googleapis.com/v1beta/models/${encodeURIComponent(model)}:generateContent?key=${encodeURIComponent(s.apiKey)}`, {}, {
+        systemInstruction: { parts: [{ text: system }] },
+        contents: [{ role: "user", parts: [{ text: user }] }],
+        generationConfig: { maxOutputTokens: maxTokens },
+    }));
+    const text = (data.candidates?.[0]?.content?.parts ?? [])
+        .map((p) => p.text ?? "")
+        .join("")
+        .trim();
+    return {
+        text,
+        truncated: data.candidates?.[0]?.finishReason === "MAX_TOKENS",
+        usage: {
+            inputTokens: num(data.usageMetadata?.promptTokenCount),
+            outputTokens: num(data.usageMetadata?.candidatesTokenCount),
+        },
+    };
+}
+function dispatch(settings, system, user, maxTokens) {
+    switch (settings.provider) {
+        case "anthropic":
+            return callAnthropic(settings, system, user, maxTokens);
+        case "openai":
+        case "openai-compatible":
+            return callOpenAI(settings, system, user, maxTokens);
+        case "google":
+            return callGoogle(settings, system, user, maxTokens);
+        default:
+            throw new ProviderError(`unknown provider: ${settings.provider}`);
+    }
+}
+/**
+ * Dispatch to the configured provider. Throws on transport / API errors with a
+ * message safe to surface (no key material), which the caller turns into a
+ * `provider-error` result.
+ *
+ * If the reply hits the output cap (reasoning models can burn most of it on
+ * thinking), retry once at double the cap — a clipped reply is 100% wasted
+ * spend, so one bigger attempt is the cheaper path. Still-truncated replies
+ * are returned flagged; callers must not cache them.
+ */
+export async function callModel(settings, system, user, opts = {}) {
+    const maxTokens = opts.maxTokens ?? DEFAULT_MAX_OUTPUT_TOKENS;
+    const reply = await dispatch(settings, system, user, maxTokens);
+    if (!reply.truncated)
+        return reply;
+    console.warn(`[polishd] model hit the ${maxTokens}-token output cap — retrying once at ${maxTokens * 2}`);
+    return dispatch(settings, system, user, maxTokens * 2);
+}
+//# sourceMappingURL=providers.js.map

package/dist/ai/providers.js.map

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

package/dist/ai/scan.d.ts

@@ -0,0 +1,38 @@
+export interface ScannedFile {
+    /** Path relative to the project root. */
+    path: string;
+    content: string;
+}
+export interface SourceScan {
+    /** False when no recognizable source tree exists on disk. */
+    available: boolean;
+    files: ScannedFile[];
+    /** PolishdMonitor / data-component identifiers found in the scanned source. */
+    identifiers: string[];
+    /** Hash of every candidate file's path+size — detects source drift cheaply. */
+    fingerprint: string;
+    /** True when the budget forced us to drop or clip files. */
+    truncated: boolean;
+}
+/**
+ * Collect the host app's source for the project profile.
+ *
+ * @param sourceDirs     Owner-configured comma-separated roots (optional).
+ * @param componentNames Identifiers seen in analytics — used to prioritize the
+ *                       files that explain them.
+ */
+export declare function collectSource(sourceDirs?: string, componentNames?: string[]): SourceScan;
+/**
+ * Locate the first source file containing any of the given needles (most
+ * specific — longest — first). Used to verify that a loss the model reported
+ * points at something that really exists in the codebase. Returns the path
+ * relative to the project root, or null (including when source isn't on disk).
+ */
+export declare function findInSource(needles: string[], sourceDirs?: string): string | null;
+/**
+ * Targeted read for summary-time gaps: return ONLY files that mention one of
+ * the given identifiers, under a much smaller budget. This is the "the agent
+ * only needs the codebase again when the profile doesn't cover something" path.
+ */
+export declare function collectTargeted(identifiers: string[], sourceDirs?: string): ScannedFile[];
+//# sourceMappingURL=scan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/ai/scan.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,SAAS,EAAE,OAAO,CAAC;CACpB;AA2GD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,UAAU,CAAC,EAAE,MAAM,EACnB,cAAc,GAAE,MAAM,EAAO,GAC5B,UAAU,CA2EZ;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBlF;AAKD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EAAE,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW,EAAE,CAuBf"}

package/dist/ai/scan.js

@@ -0,0 +1,274 @@
+/**
+ * Polishd — host-app source scanner (server only).
+ *
+ * Reads the consuming app's own source from disk (`process.cwd()`) so the
+ * one-time project profile can be generated from real code. This is the ONLY
+ * place the AI layer touches source files, and it runs only when the owner
+ * clicks "Scan" (or when a summary hits a component the profile doesn't cover,
+ * which triggers a tiny targeted read).
+ *
+ * Token thrift rules:
+ *   - Hard budgets: per-file char cap and a total scan budget, so a big app
+ *     can't produce a big prompt. Files are ranked (pages/layouts first, then
+ *     files matching known component names, then components dirs) and the
+ *     budget is spent in that order.
+ *   - Only app code: node_modules/.next/tests/etc. are never read.
+ *
+ * On hosts where source isn't on disk (e.g. a serverless bundle), the scan
+ * reports `available: false` and everything degrades gracefully — the profile
+ * generated at dev/CI time keeps serving from the database.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+const IGNORE_DIRS = new Set([
+    "node_modules",
+    ".next",
+    ".git",
+    "dist",
+    "build",
+    "out",
+    "coverage",
+    ".polishd",
+    ".vercel",
+    ".turbo",
+    "polishd-next", // never scan ourselves when developed in-repo
+]);
+const CODE_EXT = /\.(tsx|ts|jsx|js|mjs)$/;
+const SKIP_FILE = /(\.d\.ts$|\.test\.|\.spec\.|__tests__|\.stories\.)/;
+/** Roots tried in order when the owner hasn't configured `sourceDirs`. */
+const DEFAULT_ROOTS = ["src", "app", "components", "pages", "lib"];
+/** Root-level docs that anchor the model's understanding of the project. */
+const ROOT_DOCS = ["package.json", "README.md"];
+const PER_FILE_CHARS = 6_000;
+const TOTAL_BUDGET_CHARS = 90_000;
+const MAX_FILES = 60;
+const MAX_DEPTH = 7;
+/** Resolve the directories to walk, relative to the project root. */
+function resolveRoots(projectRoot, sourceDirs) {
+    const wanted = sourceDirs
+        ?.split(",")
+        .map((s) => s.trim().replace(/^\/+|\/+$/g, ""))
+        .filter(Boolean);
+    const candidates = wanted?.length ? wanted : DEFAULT_ROOTS;
+    const roots = candidates.filter((d) => {
+        const full = join(projectRoot, d);
+        try {
+            return existsSync(full) && statSync(full).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+    // With a `src/` layout everything lives inside it — don't double-walk.
+    if (!wanted?.length && roots.includes("src"))
+        return ["src"];
+    return roots;
+}
+/** Recursively list candidate code files under the roots. */
+function listFiles(projectRoot, roots) {
+    const found = [];
+    const walk = (dir, depth) => {
+        if (depth > MAX_DEPTH)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.name.startsWith("."))
+                continue;
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!IGNORE_DIRS.has(entry.name))
+                    walk(full, depth + 1);
+            }
+            else if (CODE_EXT.test(entry.name) && !SKIP_FILE.test(entry.name)) {
+                found.push(full);
+            }
+        }
+    };
+    for (const root of roots)
+        walk(join(projectRoot, root), 0);
+    return found;
+}
+/**
+ * Rank a file for the budget. Lower = read first. Pages and layouts define the
+ * site's structure; files matching component identifiers explain the things
+ * the analytics actually talk about.
+ */
+function priority(relPath, componentNames) {
+    const base = relPath.toLowerCase();
+    if (/(^|\/)(page|layout|route)\.(tsx|ts|jsx|js)$/.test(base))
+        return 0;
+    if (componentNames.some((n) => n && base.includes(n.toLowerCase())))
+        return 1;
+    if (base.includes("/components/") || base.startsWith("components/"))
+        return 2;
+    if (base.includes("/app/") || base.startsWith("app/"))
+        return 3;
+    return 4;
+}
+const MONITOR_NAME = /<PolishdMonitor[^>]*\sname\s*=\s*["']([^"']+)["']/g;
+const DATA_COMPONENT = /data-component\s*=\s*["']([^"']+)["']/g;
+function extractIdentifiers(content, into) {
+    for (const re of [MONITOR_NAME, DATA_COMPONENT]) {
+        re.lastIndex = 0;
+        let m;
+        while ((m = re.exec(content)) !== null)
+            into.add(m[1]);
+    }
+}
+/** Clip a file to the per-file cap, preferring its head (imports + exports). */
+function clipFile(content) {
+    const clean = content.replace(/\r\n/g, "\n");
+    if (clean.length <= PER_FILE_CHARS)
+        return { text: clean, clipped: false };
+    return { text: `${clean.slice(0, PER_FILE_CHARS)}\n/* …clipped by Polishd scan */`, clipped: true };
+}
+/**
+ * Collect the host app's source for the project profile.
+ *
+ * @param sourceDirs     Owner-configured comma-separated roots (optional).
+ * @param componentNames Identifiers seen in analytics — used to prioritize the
+ *                       files that explain them.
+ */
+export function collectSource(sourceDirs, componentNames = []) {
+    const projectRoot = process.cwd();
+    const roots = resolveRoots(projectRoot, sourceDirs);
+    const absPaths = listFiles(projectRoot, roots);
+    if (!absPaths.length) {
+        return { available: false, files: [], identifiers: [], fingerprint: "", truncated: false };
+    }
+    // Fingerprint every candidate (path+size) BEFORE budgeting, so any source
+    // change — even in a file we later drop — flips the fingerprint.
+    const hash = createHash("sha256");
+    const sized = absPaths
+        .map((abs) => {
+        const rel = relative(projectRoot, abs);
+        let size = 0;
+        try {
+            size = statSync(abs).size;
+        }
+        catch {
+            /* raced deletion — keep size 0 */
+        }
+        return { abs, rel, size };
+    })
+        .sort((a, b) => a.rel.localeCompare(b.rel));
+    for (const f of sized)
+        hash.update(`${f.rel}:${f.size}\n`);
+    const fingerprint = hash.digest("hex").slice(0, 16);
+    const ranked = sized.sort((a, b) => priority(a.rel, componentNames) - priority(b.rel, componentNames) ||
+        a.rel.localeCompare(b.rel));
+    const files = [];
+    const identifiers = new Set();
+    let spent = 0;
+    let truncated = false;
+    // Root docs first — cheap and high-signal for "what is this project".
+    for (const doc of ROOT_DOCS) {
+        const abs = join(projectRoot, doc);
+        if (!existsSync(abs))
+            continue;
+        try {
+            const { text, clipped } = clipFile(readFileSync(abs, "utf8"));
+            files.push({ path: doc, content: text });
+            spent += text.length;
+            truncated ||= clipped;
+        }
+        catch {
+            /* unreadable — skip */
+        }
+    }
+    for (const f of ranked) {
+        if (files.length >= MAX_FILES || spent >= TOTAL_BUDGET_CHARS) {
+            truncated = true;
+            break;
+        }
+        let raw;
+        try {
+            raw = readFileSync(f.abs, "utf8");
+        }
+        catch {
+            continue;
+        }
+        extractIdentifiers(raw, identifiers);
+        const { text, clipped } = clipFile(raw);
+        if (spent + text.length > TOTAL_BUDGET_CHARS) {
+            truncated = true;
+            continue; // a later, smaller file may still fit
+        }
+        files.push({ path: f.rel, content: text });
+        spent += text.length;
+        truncated ||= clipped;
+    }
+    return { available: true, files, identifiers: [...identifiers].sort(), fingerprint, truncated };
+}
+/**
+ * Locate the first source file containing any of the given needles (most
+ * specific — longest — first). Used to verify that a loss the model reported
+ * points at something that really exists in the codebase. Returns the path
+ * relative to the project root, or null (including when source isn't on disk).
+ */
+export function findInSource(needles, sourceDirs) {
+    const usable = needles.filter((n) => n.length >= 4);
+    if (!usable.length)
+        return null;
+    const projectRoot = process.cwd();
+    const roots = resolveRoots(projectRoot, sourceDirs);
+    const ordered = [...usable].sort((a, b) => b.length - a.length);
+    for (const needle of ordered) {
+        const lower = needle.toLowerCase();
+        for (const abs of listFiles(projectRoot, roots)) {
+            let raw;
+            try {
+                raw = readFileSync(abs, "utf8");
+            }
+            catch {
+                continue;
+            }
+            if (raw.toLowerCase().includes(lower))
+                return relative(projectRoot, abs);
+        }
+    }
+    return null;
+}
+/** Budget for the targeted gap-fill read at summary time — deliberately tiny. */
+const TARGETED_BUDGET_CHARS = 12_000;
+/**
+ * Targeted read for summary-time gaps: return ONLY files that mention one of
+ * the given identifiers, under a much smaller budget. This is the "the agent
+ * only needs the codebase again when the profile doesn't cover something" path.
+ */
+export function collectTargeted(identifiers, sourceDirs) {
+    if (!identifiers.length)
+        return [];
+    const projectRoot = process.cwd();
+    const roots = resolveRoots(projectRoot, sourceDirs);
+    const absPaths = listFiles(projectRoot, roots);
+    const out = [];
+    let spent = 0;
+    for (const abs of absPaths) {
+        if (spent >= TARGETED_BUDGET_CHARS)
+            break;
+        let raw;
+        try {
+            raw = readFileSync(abs, "utf8");
+        }
+        catch {
+            continue;
+        }
+        if (!identifiers.some((id) => raw.includes(id)))
+            continue;
+        const { text } = clipFile(raw);
+        if (spent + text.length > TARGETED_BUDGET_CHARS)
+            continue;
+        out.push({ path: relative(projectRoot, abs), content: text });
+        spent += text.length;
+    }
+    return out;
+}
+//# sourceMappingURL=scan.js.map

package/dist/ai/scan.js.map

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

package/dist/ai/settings.d.ts

@@ -0,0 +1,31 @@
+import type { PolishdAISettings, PolishdAISettingsPublic } from "./types";
+/**
+ * Effective settings = saved (dashboard) over env defaults. Returns the full
+ * settings (with key) for server use, plus whether the *provider config* came
+ * purely from env (so the UI can show it as a read-only default).
+ */
+export declare function resolveSettings(): Promise<{
+    settings: PolishdAISettings;
+    fromEnv: boolean;
+}>;
+/** Public (no-secret) settings for the dashboard. */
+export declare function getAISettingsPublic(): Promise<PolishdAISettingsPublic>;
+/** Fields the dashboard form can write. A blank apiKey leaves the saved one. */
+export interface SaveAISettingsInput {
+    provider?: string;
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    instructions?: string;
+    context?: string;
+    audience?: string;
+    ideology?: string;
+    sourceDirs?: string;
+    refreshCadence?: string;
+    githubRepo?: string;
+    githubToken?: string;
+    githubAutoIssues?: boolean;
+}
+/** Persist owner settings. Returns the refreshed public view. */
+export declare function saveAISettings(input: SaveAISettingsInput): Promise<PolishdAISettingsPublic>;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/ai/settings.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAEV,iBAAiB,EACjB,uBAAuB,EAExB,MAAM,SAAS,CAAC;AAoFjB;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAAE,QAAQ,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuBlG;AAED,qDAAqD;AACrD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAkB5E;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,iEAAiE;AACjE,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CA4BlC"}