@mneme-ai/core 0.8.3 → 0.9.0

package/dist/indexer/indexer.js

@@ -1,5 +1,6 @@
 import { createHash } from "node:crypto";
 import { readCommits, readFileChanges } from "../git/log.js";
+import { redact, mergeHits } from "../util/redact.js";
 export class Indexer {
     opts;
     constructor(opts) {
@@ -34,6 +35,28 @@ export class Indexer {
             }
         }
         const chunks = buildChunks(commits);
+        // Redaction runs BEFORE embedding so secrets never reach a remote provider.
+        // Default ON; opt out only on trusted internal repos with no secret history.
+        let redactionHits = {};
+        if (this.opts.redact !== false) {
+            const ropts = typeof this.opts.redact === "object" ? this.opts.redact : {};
+            for (const chunk of chunks) {
+                const r = redact(chunk.text, ropts);
+                if (Object.keys(r.hits).length > 0) {
+                    chunk.text = r.text;
+                    redactionHits = mergeHits(redactionHits, r.hits);
+                }
+            }
+            const totalHits = Object.values(redactionHits).reduce((a, b) => a + b, 0);
+            if (totalHits > 0) {
+                report({
+                    phase: "writing",
+                    current: totalHits,
+                    total: chunks.length,
+                    message: `redacted ${totalHits} secret(s) across ${Object.keys(redactionHits).length} rule(s)`,
+                });
+            }
+        }
         if (this.opts.embedder) {
             const model = this.opts.embedder.name;
             const batchSize = this.opts.embedBatchSize ?? 32;
@@ -55,7 +78,11 @@ export class Indexer {
             this.opts.store.upsertChunks(chunks);
         }
         report({ phase: "done", current: chunks.length, total: chunks.length });
-        return { commits: commits.length, chunks: chunks.length };
+        return {
+            commits: commits.length,
+            chunks: chunks.length,
+            redactionHits,
+        };
     }
 }
 export function buildChunks(commits) {

package/dist/indexer/indexer.js.map

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

package/dist/insights/decisions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `decisions` — auto-extract architectural decisions (ADRs) from commit
+ * history. The classic "we should write ADRs" never works in practice;
+ * instead, extract them from the commit messages that *already exist*.
+ *
+ * The extractor is intentionally conservative — it triggers on a small set
+ * of high-precision patterns ("decided to", "switched from X to Y",
+ * "replaced X with Y", "deprecate X"). False positives are worse than
+ * false negatives here: an ADR list with garbage erodes trust faster than
+ * a thin one builds it.
+ */
+import type { Commit } from "../types.js";
+export interface ExtractedDecision {
+    /** Commit hash where the decision was recorded. */
+    commitHash: string;
+    shortHash: string;
+    date: string;
+    author: string;
+    /** A 1-line summary of the decision, drawn from the matched span. */
+    summary: string;
+    /** Optional rationale clause, when the message includes "because"/"so that". */
+    rationale?: string;
+    /** The pattern that fired — for transparency. */
+    kind: "decided-to" | "switched" | "replaced" | "deprecated" | "chose-over" | "instead-of" | "migrated" | "adopted" | "rejected";
+    /** Confidence score in [0, 1]; calibrated from pattern specificity. */
+    confidence: number;
+}
+/**
+ * Extract every decision in a single commit's text (subject + body + PR
+ * title + PR body). Returns 0..N decisions; one commit can record several.
+ */
+export declare function extractDecisions(commit: Commit): ExtractedDecision[];
+/**
+ * Render a list of decisions as a Markdown table. Useful for
+ * `mneme decisions --format markdown > docs/ADR.md`.
+ */
+export declare function renderDecisionsAsMarkdown(decisions: ExtractedDecision[]): string;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/insights/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/insights/decisions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,EACA,YAAY,GACZ,UAAU,GACV,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,SAAS,GACT,UAAU,CAAC;IACf,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;CACpB;AAyCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAyCpE;AA2BD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAgBhF"}

package/dist/insights/decisions.js

@@ -0,0 +1,125 @@
+/**
+ * `decisions` — auto-extract architectural decisions (ADRs) from commit
+ * history. The classic "we should write ADRs" never works in practice;
+ * instead, extract them from the commit messages that *already exist*.
+ *
+ * The extractor is intentionally conservative — it triggers on a small set
+ * of high-precision patterns ("decided to", "switched from X to Y",
+ * "replaced X with Y", "deprecate X"). False positives are worse than
+ * false negatives here: an ADR list with garbage erodes trust faster than
+ * a thin one builds it.
+ */
+/**
+ * Patterns ordered by specificity. The first matching pattern wins.
+ * Each match exposes the decision text via the `text` group.
+ */
+const PATTERNS = [
+    // Highest specificity: explicit "decided to ..."
+    { kind: "decided-to", re: /\b(?:we\s+)?decided\s+to\s+(?<text>[^.\n;]{8,200})/gi, confidence: 0.95 },
+    // Switched / migrated FROM A TO B
+    { kind: "switched", re: /\bswitch(?:ed)?\s+from\s+(?<from>[^.\n;]{2,80})\s+to\s+(?<text>[^.\n;]{2,120})/gi, confidence: 0.9 },
+    { kind: "migrated", re: /\bmigrat(?:e|ed)\s+from\s+(?<from>[^.\n;]{2,80})\s+to\s+(?<text>[^.\n;]{2,120})/gi, confidence: 0.9 },
+    // Replaced X with Y
+    { kind: "replaced", re: /\breplaced?\s+(?<from>[^.\n;]{2,80})\s+with\s+(?<text>[^.\n;]{2,120})/gi, confidence: 0.85 },
+    // Chose X over Y
+    { kind: "chose-over", re: /\bch(?:ose|ooses?)\s+(?<text>[^.\n;]{2,80})\s+over\s+(?<from>[^.\n;]{2,80})/gi, confidence: 0.85 },
+    // Use X instead of Y — text is lazy so it stops at "instead" instead of greedily eating it.
+    { kind: "instead-of", re: /\b(?:use|using|used)\s+(?<text>\S[^.\n;]*?)\s+instead\s+of\s+(?<from>[^.\n;]{2,80})/gi, confidence: 0.8 },
+    // Adopted X
+    { kind: "adopted", re: /\b(?:we\s+)?adopt(?:ed|ing)?\s+(?<text>[^.\n;]{4,120})/gi, confidence: 0.65 },
+    // Deprecated X / Deprecate X
+    { kind: "deprecated", re: /\bdeprecat(?:e|ed|ing)\s+(?<text>[^.\n;]{2,120})/gi, confidence: 0.75 },
+    // Rejected (the opposite — a decision NOT to do something)
+    { kind: "rejected", re: /\b(?:we\s+)?reject(?:ed|ing)?\s+(?<text>[^.\n;]{4,120})/gi, confidence: 0.6 },
+];
+const RATIONALE_RE = /\b(?:because|so\s+that|in\s+order\s+to|due\s+to)\s+(?<rationale>[^.\n;]{4,200})/i;
+/**
+ * Extract every decision in a single commit's text (subject + body + PR
+ * title + PR body). Returns 0..N decisions; one commit can record several.
+ */
+export function extractDecisions(commit) {
+    const fullText = [commit.subject, commit.body, commit.prTitle, commit.prBody]
+        .filter(Boolean)
+        .join("\n");
+    if (!fullText)
+        return [];
+    const found = [];
+    const seen = new Set(); // dedupe by summary text
+    for (const p of PATTERNS) {
+        // Re-create regex per call to reset lastIndex.
+        const re = new RegExp(p.re.source, p.re.flags);
+        let m;
+        while ((m = re.exec(fullText)) !== null) {
+            const text = (m.groups?.text ?? "").trim();
+            const from = (m.groups?.from ?? "").trim();
+            // Min 2 chars — code identifiers like "Go", "DB", "JS", "Map" are real.
+            if (!text || text.length < 2)
+                continue;
+            const summary = buildSummary(p.kind, text, from);
+            if (seen.has(summary.toLowerCase()))
+                continue;
+            seen.add(summary.toLowerCase());
+            // Look for a rationale within ~120 chars after the match.
+            const tail = fullText.slice(m.index, m.index + m[0].length + 200);
+            const ratMatch = RATIONALE_RE.exec(tail);
+            const rationale = ratMatch?.groups?.rationale?.trim();
+            found.push({
+                commitHash: commit.hash,
+                shortHash: commit.shortHash || commit.hash.slice(0, 7),
+                date: commit.authorDate.slice(0, 10),
+                author: commit.authorName,
+                summary,
+                rationale: rationale || undefined,
+                kind: p.kind,
+                confidence: p.confidence,
+            });
+        }
+    }
+    return found;
+}
+function buildSummary(kind, text, from) {
+    const t = text.replace(/\s+/g, " ").replace(/^[,:\s]+|[,:\s]+$/g, "");
+    const f = from.replace(/\s+/g, " ").replace(/^[,:\s]+|[,:\s]+$/g, "");
+    switch (kind) {
+        case "decided-to":
+            return `decided to ${t}`;
+        case "switched":
+            return `switched from ${f} to ${t}`;
+        case "migrated":
+            return `migrated from ${f} to ${t}`;
+        case "replaced":
+            return `replaced ${f} with ${t}`;
+        case "chose-over":
+            return `chose ${t} over ${f}`;
+        case "instead-of":
+            return `using ${t} instead of ${f}`;
+        case "adopted":
+            return `adopted ${t}`;
+        case "deprecated":
+            return `deprecated ${t}`;
+        case "rejected":
+            return `rejected ${t}`;
+    }
+}
+/**
+ * Render a list of decisions as a Markdown table. Useful for
+ * `mneme decisions --format markdown > docs/ADR.md`.
+ */
+export function renderDecisionsAsMarkdown(decisions) {
+    if (decisions.length === 0) {
+        return "# Architecture Decisions\n\n(no decisions extracted — try richer commit messages)\n";
+    }
+    const lines = [];
+    lines.push("# Architecture Decisions (auto-extracted)");
+    lines.push("");
+    lines.push("| Date | Author | Decision | Rationale | Source |");
+    lines.push("|---|---|---|---|---|");
+    for (const d of decisions) {
+        const decision = d.summary.replace(/\|/g, "\\|");
+        const rationale = (d.rationale ?? "").replace(/\|/g, "\\|");
+        lines.push(`| ${d.date} | ${d.author} | ${decision} | ${rationale} | \`${d.shortHash}\` |`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=decisions.js.map

package/dist/insights/decisions.js.map

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

package/dist/insights/decisions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decisions.test.d.ts.map

package/dist/insights/decisions.test.d.ts.map

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

package/dist/insights/decisions.test.js

@@ -0,0 +1,141 @@
+import { describe, it, expect } from "vitest";
+import { extractDecisions, renderDecisionsAsMarkdown } from "./decisions.js";
+const commit = (subject, body = "") => ({
+    hash: "abcdef1234567890abcdef1234567890abcdef12",
+    shortHash: "abcdef1",
+    authorName: "alice",
+    authorEmail: "alice@example.com",
+    authorDate: "2024-08-12T00:00:00Z",
+    committerDate: "2024-08-12T00:00:00Z",
+    subject,
+    body,
+    parents: [],
+    files: [],
+});
+describe("extractDecisions — high-precision patterns", () => {
+    it('catches "decided to X"', () => {
+        const out = extractDecisions(commit("refactor: decided to use Postgres for write-heavy paths"));
+        expect(out).toHaveLength(1);
+        expect(out[0].kind).toBe("decided-to");
+        expect(out[0].summary).toContain("Postgres");
+    });
+    it('catches "switched from X to Y" with rationale', () => {
+        const out = extractDecisions(commit("auth: switched from passport to custom middleware", "switched from passport to custom JWT because legal flagged session token storage"));
+        expect(out.length).toBeGreaterThan(0);
+        const switched = out.find((d) => d.kind === "switched");
+        expect(switched).toBeDefined();
+        expect(switched.summary).toContain("from passport to custom");
+        expect(switched.rationale).toContain("legal");
+    });
+    it('catches "replaced X with Y"', () => {
+        const out = extractDecisions(commit("replaced lodash with native methods"));
+        expect(out.find((d) => d.kind === "replaced")).toBeDefined();
+    });
+    it('catches "chose X over Y"', () => {
+        const out = extractDecisions(commit("chose pnpm over npm for monorepo workspaces"));
+        const d = out.find((d) => d.kind === "chose-over");
+        expect(d).toBeDefined();
+        expect(d.summary).toContain("pnpm over npm");
+    });
+    it('catches "use X instead of Y"', () => {
+        const out = extractDecisions(commit("perf: use Map instead of plain object for hot path"));
+        expect(out.find((d) => d.kind === "instead-of")).toBeDefined();
+    });
+    it('catches "deprecated X"', () => {
+        const out = extractDecisions(commit("deprecate the legacy /api/v1/auth endpoint"));
+        expect(out.find((d) => d.kind === "deprecated")).toBeDefined();
+    });
+    it('catches "migrated from X to Y"', () => {
+        const out = extractDecisions(commit("infra: migrated from Redis to Valkey for license"));
+        expect(out.find((d) => d.kind === "migrated")).toBeDefined();
+    });
+    it('catches "adopted X"', () => {
+        const out = extractDecisions(commit("ci: adopted GitHub Actions over Jenkins"));
+        expect(out.find((d) => d.kind === "adopted")).toBeDefined();
+    });
+});
+describe("extractDecisions — false positives stay low", () => {
+    it("does not fire on simple progress commits", () => {
+        expect(extractDecisions(commit("fix: typo in README"))).toEqual([]);
+        expect(extractDecisions(commit("wip: more tests"))).toEqual([]);
+        expect(extractDecisions(commit("update package-lock.json"))).toEqual([]);
+    });
+    it("does not fire when 'decided' appears without 'to'", () => {
+        expect(extractDecisions(commit("the team decided unanimously"))).toEqual([]);
+    });
+    it("does not fire on too-short text after the trigger", () => {
+        // "decided to X" — needs >= 8 chars after, so a 5-char tail is rejected.
+        expect(extractDecisions(commit("we decided to wait"))).toEqual([]);
+    });
+});
+describe("extractDecisions — rationale capture", () => {
+    it('captures "because ..." rationale', () => {
+        const out = extractDecisions(commit("auth: switched from passport to custom JWT because compliance flagged session token storage"));
+        expect(out[0].rationale).toContain("compliance");
+    });
+    it('captures "so that ..." rationale', () => {
+        const out = extractDecisions(commit("infra: switched from Redis to Valkey so that we keep BSD license compatibility"));
+        expect(out[0].rationale).toContain("BSD");
+    });
+    it("rationale is undefined when no marker present", () => {
+        const out = extractDecisions(commit("decided to drop synchronous fs.readFileSync calls"));
+        expect(out[0].rationale).toBeUndefined();
+    });
+});
+describe("extractDecisions — multi-decision and dedupe", () => {
+    it("returns multiple decisions when a commit records several", () => {
+        const out = extractDecisions(commit("perf: replaced lodash with native methods", "Also adopted Bun for tests because it is fast."));
+        expect(out.length).toBeGreaterThanOrEqual(2);
+        const kinds = out.map((d) => d.kind);
+        expect(kinds).toContain("replaced");
+        expect(kinds).toContain("adopted");
+    });
+    it("dedupes the same summary if the same line is matched by multiple patterns", () => {
+        // A potentially tricky case: "decided to switch from A to B" — both
+        // 'decided-to' and 'switched' could fire. Both are useful but on
+        // different summary text, so we keep both.
+        const out = extractDecisions(commit("decided to switch from passport to custom JWT"));
+        const summaries = out.map((d) => d.summary);
+        expect(new Set(summaries).size).toBe(summaries.length); // no exact duplicates
+    });
+});
+describe("renderDecisionsAsMarkdown", () => {
+    it("renders a markdown table with Date, Author, Decision, Rationale, Source", () => {
+        const out = renderDecisionsAsMarkdown([
+            {
+                commitHash: "abc1234",
+                shortHash: "abc1234",
+                date: "2024-08-12",
+                author: "alice",
+                summary: "switched from passport to custom JWT",
+                rationale: "compliance",
+                kind: "switched",
+                confidence: 0.9,
+            },
+        ]);
+        expect(out).toContain("| Date | Author | Decision | Rationale | Source |");
+        expect(out).toContain("alice");
+        expect(out).toContain("switched from passport to custom JWT");
+        expect(out).toContain("compliance");
+        expect(out).toContain("`abc1234`");
+    });
+    it("renders a friendly fallback when there are no decisions", () => {
+        const out = renderDecisionsAsMarkdown([]);
+        expect(out.toLowerCase()).toContain("no decisions extracted");
+    });
+    it("escapes pipe characters to keep the table valid", () => {
+        const out = renderDecisionsAsMarkdown([
+            {
+                commitHash: "x",
+                shortHash: "xxxxxxx",
+                date: "2024-01-01",
+                author: "bob",
+                summary: "decided to use a|b matching",
+                kind: "decided-to",
+                confidence: 0.95,
+            },
+        ]);
+        expect(out).toContain("a\\|b");
+    });
+});
+//# sourceMappingURL=decisions.test.js.map

package/dist/insights/decisions.test.js.map

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

package/dist/insights/dream.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `dream` — speculative ideas from your codebase patterns.
+ *
+ * The premise: every codebase has *latent shape*. Authentication, payments,
+ * logging, queue patterns repeat in similar idioms. Given the patterns you
+ * already use, an LLM can suggest features that would fit your codebase's
+ * style — citing the existing patterns it learned from.
+ *
+ * This is the most "AI from the future" command: instead of "what does X
+ * do?", it answers "what could you build next that fits your style?"
+ *
+ * Pure data extraction here (signal gathering); LLM call lives in the CLI.
+ */
+import type { MnemeStore } from "../store/sqlite.js";
+export interface RepoSignals {
+    totalCommits: number;
+    totalEntities: number;
+    /** Top 10 most common file-extension languages by entity count. */
+    languages: Array<{
+        name: string;
+        count: number;
+    }>;
+    /** Recent commit subjects — most recent first, capped at 30. */
+    recentSubjects: string[];
+    /** Modules (top-2 path segments) ranked by entity count. */
+    topModules: Array<{
+        name: string;
+        count: number;
+    }>;
+    /** Common entity-name suffixes ("Service", "Controller", "Adapter"). */
+    patternSuffixes: Array<{
+        suffix: string;
+        count: number;
+    }>;
+    /** Total incidents indexed (if any). */
+    totalIncidents: number;
+}
+export interface DreamIdea {
+    /** Short title, e.g. "MultiCurrencyAdapter" or "WebhookReplay". */
+    title: string;
+    /** 2-3 sentence pitch. */
+    pitch: string;
+    /** Existing patterns in the repo this idea would mirror. */
+    precedents: string[];
+    /** Effort hint: "small" | "medium" | "large". */
+    effort: "small" | "medium" | "large";
+    /** Risk hint based on what the idea touches. */
+    risk: "low" | "medium" | "high";
+}
+/**
+ * Gather signals from the indexed memory. Pure read-only — no LLM call.
+ * Designed to fit into one LLM prompt without truncation.
+ */
+export declare function gatherRepoSignals(store: MnemeStore): RepoSignals;
+/**
+ * Build the prompt for the dream LLM. Compact enough to fit a small Ollama
+ * model (llama3.2:3b) without truncation, but rich enough to ground the
+ * speculation in real signals.
+ */
+export declare function buildDreamPrompt(signals: RepoSignals, n: number): string;
+/**
+ * Parse LLM JSON output into typed DreamIdea[] with permissive validation.
+ * Returns [] on parse failure rather than throwing — dream is best-effort.
+ */
+export declare function parseDreamIdeas(raw: string): DreamIdea[];
+/**
+ * No-LLM fallback — generate ideas from heuristic patterns. Useful for
+ * deterministic mode and as a sanity-check baseline.
+ */
+export declare function heuristicDream(signals: RepoSignals, n: number): DreamIdea[];
+//# sourceMappingURL=dream.d.ts.map

package/dist/insights/dream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream.d.ts","sourceRoot":"","sources":["../../src/insights/dream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,gEAAgE;IAChE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,wEAAwE;IACxE,eAAe,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iDAAiD;IACjD,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,gDAAgD;IAChD,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAoEhE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BxE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAgCxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CA8D3E"}