@polishd/next 0.1.0

package/dist/ai/issues.js

@@ -0,0 +1,291 @@
+/**
+ * Polishd — loss → verified GitHub issue (server only).
+ *
+ * A loss in the summary is a claim made from analytics data. Before it becomes
+ * a bug in the tracker, this module makes it earn that status:
+ *
+ *   1. Pull the relevant source from the connected GitHub repo — the file the
+ *      citation was matched to, plus code-search hits for the evidence.
+ *   2. Ask the model for a technical verdict against that code: confirmed
+ *      (specific code explains the problem), rejected (the code proves the
+ *      report wrong), or inconclusive (not enough source to decide).
+ *   3. Rejected → no issue; the verdict's reasoning is surfaced to the owner.
+ *      Confirmed → an issue with a precise title, the technical analysis, and
+ *      suggested fixes. Inconclusive → the plain analytics-only issue, marked
+ *      as unverified, so a search hiccup never blocks a real report.
+ *
+ * Verdicts and filed issues are logged per evidence citation, so the same
+ * problem — refound by a regenerated summary or clicked twice — is neither
+ * re-investigated nor re-filed.
+ */
+import { getMeta, setMeta } from "../server/store";
+import { createGithubIssue, getGithubStatus, isGithubConnected, readGithubFile, searchGithubCode, } from "./github";
+import { loadProjectProfile } from "./profile";
+import { callModel } from "./providers";
+import { resolveSettings } from "./settings";
+// ── Issue log (dedupe) ───────────────────────────────────────────────────────
+const ISSUE_LOG_KEY = "github_issue_log";
+function issueKey(evidence) {
+    return evidence.trim().toLowerCase();
+}
+async function loadIssueLog() {
+    const raw = await getMeta(ISSUE_LOG_KEY);
+    if (!raw)
+        return {};
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+async function recordLog(key, entry) {
+    const log = await loadIssueLog();
+    log[key] = entry;
+    await setMeta(ISSUE_LOG_KEY, JSON.stringify(log));
+}
+// ── Investigation ────────────────────────────────────────────────────────────
+const MAX_FILES = 4;
+const MAX_CHARS_PER_FILE = 8_000;
+const INVESTIGATE_PROMPT = "You are a senior engineer verifying a suspected bug before it enters the " +
+    "issue tracker. A product-analytics tool watched real users interact with a " +
+    "website and flagged a suspected problem. You receive that suspicion, the " +
+    "analytics identifier cited as evidence (a page path, CSS selector, or " +
+    "component name), and source files from the site's repository.\n\n" +
+    "Decide whether the problem is technically real in this code. Respond with " +
+    "ONLY a JSON object (no markdown fences, no preamble):\n" +
+    '{ "verdict": "confirmed" | "rejected" | "inconclusive", "title": string, ' +
+    '"details": string, "fixes": string[], "reasoning": string }\n\n' +
+    "verdict: confirmed ONLY when you can point to specific code that explains " +
+    "or exhibits the problem. rejected ONLY when the code demonstrates the " +
+    "report cannot be right (the interaction is handled correctly, the behavior " +
+    "is clearly intentional). inconclusive when the source provided is not " +
+    "enough to decide either way.\n" +
+    "title: a short, specific bug title (under 80 characters) — becomes the " +
+    "GitHub issue title when confirmed.\n" +
+    "details: the technical root-cause analysis, citing the file paths and the " +
+    "relevant code. Written for the developer who will fix it.\n" +
+    "fixes: 1-3 concrete, code-level suggestions for fixing it.\n" +
+    "reasoning: one or two sentences on how you reached the verdict — shown to " +
+    "the site owner when the report is rejected or unverifiable.";
+/** Terms specific enough to search code for (same spirit as citationTokens). */
+function searchTerms(evidence) {
+    return [
+        ...new Set(evidence
+            .split(/[^\w-]+/)
+            .filter((t) => t.length >= 4 &&
+            !/^(button|input|click|clicks|page|pages|http|https|with|from|that|div|span)$/i.test(t))),
+    ].slice(0, 3);
+}
+/**
+ * Gather the source files that should contain the answer: the file the loss
+ * was already matched to, then code-search hits for the evidence.
+ */
+async function collectSource(loss) {
+    const paths = [];
+    if (loss.location)
+        paths.push(loss.location);
+    for (const p of await searchGithubCode(searchTerms(loss.evidence), MAX_FILES)) {
+        if (!paths.includes(p))
+            paths.push(p);
+    }
+    const out = [];
+    for (const path of paths.slice(0, MAX_FILES)) {
+        const content = await readGithubFile(path);
+        if (content)
+            out.push({ path, content: content.slice(0, MAX_CHARS_PER_FILE) });
+    }
+    return out;
+}
+/** Tolerant JSON extraction, same approach as the summary parser. */
+function parseInvestigation(text, files) {
+    let t = text.trim();
+    const fence = t.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (fence)
+        t = fence[1].trim();
+    const start = t.indexOf("{");
+    const end = t.lastIndexOf("}");
+    if (start >= 0 && end > start) {
+        try {
+            const obj = JSON.parse(t.slice(start, end + 1));
+            const verdict = obj.verdict === "confirmed" || obj.verdict === "rejected"
+                ? obj.verdict
+                : "inconclusive";
+            return {
+                verdict,
+                title: typeof obj.title === "string" ? obj.title.trim() || undefined : undefined,
+                details: typeof obj.details === "string" ? obj.details.trim() || undefined : undefined,
+                fixes: Array.isArray(obj.fixes)
+                    ? obj.fixes
+                        .filter((f) => typeof f === "string" && f.trim().length > 0)
+                        .slice(0, 3)
+                    : [],
+                reasoning: typeof obj.reasoning === "string" && obj.reasoning.trim()
+                    ? obj.reasoning.trim()
+                    : "The model returned no reasoning.",
+                files,
+            };
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    return {
+        verdict: "inconclusive",
+        fixes: [],
+        reasoning: "The model's verdict could not be parsed.",
+        files,
+    };
+}
+/**
+ * Verify one loss against the repository's source. Never throws — anything
+ * that prevents a real verdict (no source found, model unavailable) comes back
+ * as inconclusive so the caller can still file a plain, unverified report.
+ */
+async function investigateLoss(loss) {
+    const { settings } = await resolveSettings();
+    if (!settings.apiKey) {
+        return {
+            verdict: "inconclusive",
+            fixes: [],
+            reasoning: "No model is configured to verify against the source.",
+            files: [],
+        };
+    }
+    const files = await collectSource(loss);
+    if (files.length === 0) {
+        return {
+            verdict: "inconclusive",
+            fixes: [],
+            reasoning: "No source files mentioning the cited element were found in the repository.",
+            files: [],
+        };
+    }
+    const profile = await loadProjectProfile();
+    const sections = [
+        "SUSPECTED PROBLEM (from analytics):",
+        loss.issue,
+        "",
+        `EVIDENCE (identifier from the analytics data): ${loss.evidence}`,
+    ];
+    if (profile) {
+        sections.push("", `PROJECT PROFILE (what this site and its components are):\n${profile.text}`);
+    }
+    sections.push("", "SOURCE FILES (from the GitHub repository):", ...files.map((f) => `--- ${f.path} ---\n${f.content}`));
+    try {
+        const reply = await callModel(settings, INVESTIGATE_PROMPT, sections.join("\n"));
+        if (!reply.text)
+            throw new Error("empty response");
+        return parseInvestigation(reply.text, files.map((f) => f.path));
+    }
+    catch (err) {
+        return {
+            verdict: "inconclusive",
+            fixes: [],
+            reasoning: `Verification failed: ${err instanceof Error ? err.message : "model error"}.`,
+            files: files.map((f) => f.path),
+        };
+    }
+}
+// ── Filing ───────────────────────────────────────────────────────────────────
+/** Markdown body for a filed issue, sized to the verdict behind it. */
+function issueBody(loss, inv, fileUrl) {
+    const lines = [loss.issue, "", `**Evidence (from analytics):** \`${loss.evidence}\``];
+    if (inv.verdict === "confirmed") {
+        if (inv.details)
+            lines.push("", "## Technical analysis", inv.details);
+        if (inv.files.length) {
+            lines.push("", "**Verified against:**", ...inv.files.map((p) => `- [\`${p}\`](${fileUrl(p)})`));
+        }
+        if (inv.fixes.length) {
+            lines.push("", "## Suggested fixes", ...inv.fixes.map((f) => `- ${f}`));
+        }
+    }
+    else {
+        lines.push("", `> **Note:** source verification was inconclusive — ${inv.reasoning}`);
+        if (loss.location)
+            lines.push("", `**Possible source:** [\`${loss.location}\`](${fileUrl(loss.location)})`);
+    }
+    lines.push("", "---", inv.verdict === "confirmed"
+        ? "_Filed from the Polishd analytics dashboard — observed in real user-behavior data and confirmed against the source code._"
+        : "_Filed from the Polishd analytics dashboard — observed in real user-behavior data._");
+    return lines.join("\n");
+}
+/**
+ * File a bug from one loss — after verifying it against the source (see the
+ * module doc for the pipeline). Returns the issue on success, the stored issue
+ * when this evidence was already filed, or `not-a-bug` with the verdict's
+ * reasoning when the code disproves the report.
+ */
+export async function createIssueFromLoss(loss) {
+    if (!(await isGithubConnected())) {
+        return {
+            ok: false,
+            error: "not-connected",
+            message: "Connect a GitHub repository in the settings first.",
+        };
+    }
+    const key = issueKey(loss.evidence);
+    const existing = (await loadIssueLog())[key];
+    if (existing) {
+        if ("rejected" in existing) {
+            return { ok: false, error: "not-a-bug", message: existing.reason };
+        }
+        return { ok: true, ...existing };
+    }
+    const inv = await investigateLoss(loss);
+    if (inv.verdict === "rejected") {
+        await recordLog(key, { rejected: true, reason: inv.reasoning });
+        return { ok: false, error: "not-a-bug", message: inv.reasoning };
+    }
+    try {
+        const status = await getGithubStatus();
+        const fileUrl = (path) => status
+            ? `https://github.com/${status.repo}/blob/${status.defaultBranch}/${path}`
+            : path;
+        const issue = await createGithubIssue({
+            title: (inv.verdict === "confirmed" && inv.title) || loss.issue,
+            body: issueBody(loss, inv, fileUrl),
+            labels: ["bug"],
+        });
+        await recordLog(key, issue);
+        return { ok: true, url: issue.url, number: issue.number };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: "github-error",
+            message: err instanceof Error ? err.message : "Could not create the issue.",
+        };
+    }
+}
+/**
+ * Decorate a fresh summary's losses with their GitHub issues: attach the link
+ * for anything already filed and — when the owner enabled auto-filing — run
+ * the verify-and-file pipeline on the new ones. Losses whose report the code
+ * disproved are skipped (and remembered, so they aren't re-investigated).
+ * Never throws; a hiccup just leaves a loss undecorated, with the manual
+ * "file bug" button as the fallback.
+ */
+export async function attachGithubIssues(losses) {
+    if (losses.length === 0)
+        return losses;
+    const { settings } = await resolveSettings();
+    if (!(await isGithubConnected()))
+        return losses;
+    const out = [];
+    for (const loss of losses) {
+        // Re-read per loss: auto-filing above may have just written new entries.
+        let entry = (await loadIssueLog())[issueKey(loss.evidence)];
+        if (!entry && settings.githubAutoIssues) {
+            const res = await createIssueFromLoss(loss);
+            if (res.ok)
+                entry = { url: res.url, number: res.number };
+        }
+        out.push(entry && "url" in entry
+            ? { ...loss, issueUrl: entry.url, issueNumber: entry.number }
+            : loss);
+    }
+    return out;
+}
+//# sourceMappingURL=issues.js.map

package/dist/ai/issues.js.map

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

package/dist/ai/profile.d.ts

@@ -0,0 +1,26 @@
+import type { PolishdDashboardData } from "../server/queries";
+import type { PolishdProjectProfile, GenerateProfileResult } from "./types";
+/** The cached profile, or null. Read-only — never calls a model. */
+export declare function loadProjectProfile(): Promise<PolishdProjectProfile | null>;
+/** Component identifiers the analytics currently know about. */
+export declare function componentIdentifiers(data: PolishdDashboardData): string[];
+/**
+ * Identifiers the analytics talk about that the profile does NOT cover — the
+ * trigger for a targeted source read at summary time (and a "re-scan" hint in
+ * the UI). An identifier counts as covered if the scan saw it in source or the
+ * profile prose mentions it.
+ */
+export declare function coverageGaps(data: PolishdDashboardData, profile: PolishdProjectProfile | null): string[];
+/**
+ * Scan the codebase and (re)generate the project profile. Always calls the
+ * model — this is an explicit owner action, not something that runs on load.
+ */
+export declare function generateProjectProfile(data?: PolishdDashboardData): Promise<GenerateProfileResult>;
+/** What the dashboard needs on first paint. Reads only — no model, no scan. */
+export declare function loadProfileState(data: PolishdDashboardData): Promise<{
+    profile: PolishdProjectProfile | null;
+    gaps: string[];
+    /** Whether a scan could run here (source tree present on disk). */
+    sourceAvailable: boolean;
+}>;
+//# sourceMappingURL=profile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/ai/profile.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAK9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAI5E,oEAAoE;AACpE,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAQhF;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,qBAAqB,GAAG,IAAI,GACpC,MAAM,EAAE,CAOV;AAkBD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CA2EhC;AAED,+EAA+E;AAC/E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC;IAC1E,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACtC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mEAAmE;IACnE,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CAaD"}

package/dist/ai/profile.js

@@ -0,0 +1,160 @@
+/**
+ * Polishd — project profile (server only).
+ *
+ * The one-time setup step: scan the host app's source, ask the model to write
+ * a compact "what this project is" brief — purpose, page map, every interactive
+ * component and its identifier, plus the owner's stated audience and ideology —
+ * and cache it in the store.
+ *
+ * From then on, every summary reuses this profile as authoritative context.
+ * The codebase is only read again when (a) the owner explicitly re-scans, or
+ * (b) analytics mention a component the profile doesn't cover, in which case
+ * the summary does a tiny targeted read of just the files naming it.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { getMeta, setMeta } from "../server/store";
+import { callModel } from "./providers";
+import { collectSource } from "./scan";
+import { resolveSettings } from "./settings";
+const PROFILE_KEY = "project_profile";
+/** The cached profile, or null. Read-only — never calls a model. */
+export async function loadProjectProfile() {
+    const raw = await getMeta(PROFILE_KEY);
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Component identifiers the analytics currently know about. */
+export function componentIdentifiers(data) {
+    const ids = new Set();
+    for (const m of data.monitored)
+        ids.add(m.name);
+    for (const t of data.topUsed)
+        if (t.isComponent)
+            ids.add(t.label);
+    return [...ids].sort();
+}
+/**
+ * Identifiers the analytics talk about that the profile does NOT cover — the
+ * trigger for a targeted source read at summary time (and a "re-scan" hint in
+ * the UI). An identifier counts as covered if the scan saw it in source or the
+ * profile prose mentions it.
+ */
+export function coverageGaps(data, profile) {
+    if (!profile)
+        return [];
+    const covered = new Set(profile.coveredIdentifiers);
+    const prose = profile.text.toLowerCase();
+    return componentIdentifiers(data).filter((id) => !covered.has(id) && !prose.includes(id.toLowerCase()));
+}
+const PROFILE_SYSTEM_PROMPT = "You are onboarding as the resident product analyst for a website. You are " +
+    "given excerpts of its source code and, when available, the owner's notes on " +
+    "audience and product values. Write a compact project profile that will be " +
+    "your ONLY code context in future analyses, so make it self-sufficient: " +
+    "(1) what the site is and its purpose; (2) a map of its pages/routes and what " +
+    "each is for; (3) every interactive component and tracked element — name each " +
+    "identifier exactly as it appears (PolishdMonitor names, data-component values, " +
+    "notable buttons/links) and say what it does and where it lives; (4) who the " +
+    "site is for and what success looks like, if stated. Plain prose with short " +
+    "paragraphs; no markdown headings, no code blocks. Be dense — under 450 words.";
+// ~450 words of profile plus headroom for reasoning models' thinking tokens,
+// which count against the output cap.
+const PROFILE_MAX_TOKENS = 3000;
+/**
+ * Scan the codebase and (re)generate the project profile. Always calls the
+ * model — this is an explicit owner action, not something that runs on load.
+ */
+export async function generateProjectProfile(data) {
+    const { settings } = await resolveSettings();
+    if (!settings.apiKey) {
+        return { ok: false, error: "no-key", message: "No API key configured." };
+    }
+    const knownIds = data ? componentIdentifiers(data) : [];
+    const scan = collectSource(settings.sourceDirs, knownIds);
+    if (!scan.available) {
+        return {
+            ok: false,
+            error: "no-source",
+            message: "No source tree found on disk — run the scan where the app's source is available (local dev or CI).",
+        };
+    }
+    const parts = [];
+    if (settings.context)
+        parts.push(`OWNER'S DESCRIPTION: ${settings.context}`);
+    if (settings.audience)
+        parts.push(`TARGET AUDIENCE: ${settings.audience}`);
+    if (settings.ideology)
+        parts.push(`PRODUCT VALUES / IDEOLOGY: ${settings.ideology}`);
+    if (knownIds.length)
+        parts.push(`COMPONENT IDENTIFIERS SEEN IN ANALYTICS: ${knownIds.join(", ")}`);
+    parts.push("SOURCE FILES" + (scan.truncated ? " (large app — excerpts were clipped to budget)" : "") + ":");
+    for (const f of scan.files) {
+        parts.push(`--- ${f.path} ---\n${f.content}`);
+    }
+    let reply;
+    try {
+        reply = await callModel(settings, PROFILE_SYSTEM_PROMPT, parts.join("\n\n"), {
+            maxTokens: PROFILE_MAX_TOKENS,
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: "provider-error",
+            message: err instanceof Error ? err.message : "The model request failed.",
+        };
+    }
+    if (!reply.text) {
+        return {
+            ok: false,
+            error: "provider-error",
+            message: "The model returned an empty response.",
+        };
+    }
+    if (reply.truncated) {
+        // Even the retry hit the cap — a partial profile would silently degrade
+        // every future summary, so refuse to store it.
+        return {
+            ok: false,
+            error: "provider-error",
+            message: "The model's response was cut off at the output limit, twice. Try again or use a model that reasons less.",
+        };
+    }
+    const profile = {
+        text: reply.text,
+        provider: settings.provider,
+        model: settings.model,
+        generatedAt: Date.now(),
+        fingerprint: scan.fingerprint,
+        // Covered = names the scan found in source + names analytics knew at scan
+        // time (dynamic names — e.g. per-article slugs — never appear literally in
+        // source, so the analytics side is what keeps them from gapping forever).
+        coveredIdentifiers: [...new Set([...scan.identifiers, ...knownIds])].sort(),
+        sourceFiles: scan.files.length,
+        truncated: scan.truncated,
+    };
+    await setMeta(PROFILE_KEY, JSON.stringify(profile));
+    return { ok: true, profile };
+}
+/** What the dashboard needs on first paint. Reads only — no model, no scan. */
+export async function loadProfileState(data) {
+    const [profile, { settings }] = await Promise.all([
+        loadProjectProfile(),
+        resolveSettings(),
+    ]);
+    // Cheap availability probe — enough for the UI to enable/disable the button
+    // without walking the whole tree.
+    const configured = settings.sourceDirs?.split(",").map((s) => s.trim()).filter(Boolean);
+    const roots = configured?.length
+        ? configured
+        : ["src", "app", "components", "pages", "lib"];
+    const sourceAvailable = roots.some((r) => existsSync(join(process.cwd(), r)));
+    return { profile, gaps: coverageGaps(data, profile), sourceAvailable };
+}
+//# sourceMappingURL=profile.js.map

package/dist/ai/profile.js.map

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

package/dist/ai/providers.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Polishd — model providers (server only).
+ *
+ * A deliberately tiny, dependency-free abstraction over the chat endpoints of
+ * the common vendors. We use raw `fetch` rather than any vendor SDK so the
+ * package keeps its zero-runtime-dependency footprint and so the owner can
+ * point Polishd at whichever model they already pay for.
+ *
+ * Each call is a single non-streaming request: one system prompt, one user
+ * message, a small token cap. That's all a one-paragraph summary needs, and it
+ * keeps the owner's spend to the absolute minimum.
+ */
+import type { PolishdAIProvider, PolishdAISettings } from "./types";
+export interface ModelReply {
+    text: string;
+    /** True when the provider stopped at the output-token cap (clipped text). */
+    truncated: boolean;
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+/** Sensible default model per provider, used when none is configured. */
+export declare const DEFAULT_MODEL: Record<PolishdAIProvider, string>;
+export interface CallOptions {
+    /** Output token cap for this call. */
+    maxTokens?: number;
+}
+/**
+ * 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 declare function callModel(settings: PolishdAISettings, system: string, user: string, opts?: CallOptions): Promise<ModelReply>;
+//# sourceMappingURL=providers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/ai/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,yEAAyE;AACzE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAM3D,CAAC;AAWF,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsKD;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAQrB"}