@indigoai-us/cq 0.0.1

package/dist/knowledge-tree/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Knowledge Tree type definitions.
+ */
+/** Frontmatter metadata stored in YAML at the top of each .md file. */
+export interface KnowledgeFrontmatter {
+    title: string;
+    tags: string[];
+    source?: string;
+    created: string;
+    updated: string;
+}
+/** A fully-parsed knowledge entry (frontmatter + body content). */
+export interface KnowledgeEntry {
+    category: string;
+    slug: string;
+    title: string;
+    tags: string[];
+    source?: string;
+    created: string;
+    updated: string;
+    content: string;
+}
+/** Input for creating/updating an entry. */
+export interface WriteEntryInput {
+    category: string;
+    slug?: string;
+    title: string;
+    content: string;
+    tags?: string[];
+    source?: string;
+}
+/** Summary of a category directory. */
+export interface CategoryInfo {
+    name: string;
+    entryCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/knowledge-tree/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/knowledge-tree/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/knowledge-tree/types.js

@@ -0,0 +1,5 @@
+/**
+ * Knowledge Tree type definitions.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/knowledge-tree/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/knowledge-tree/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/metadata/__tests__/metadata.test.d.ts

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

package/dist/metadata/__tests__/metadata.test.d.ts.map

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

package/dist/metadata/__tests__/metadata.test.js

@@ -0,0 +1,196 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { initMetadataDb, closeDb, getDb, indexEntry, removeFromIndex, getMetadata, getStaleEntries, } from "../index.js";
+function makeEntry(overrides = {}) {
+    return {
+        category: "science",
+        slug: "quantum-basics",
+        title: "Quantum Computing Basics",
+        tags: ["quantum"],
+        created: "2025-01-01T00:00:00.000Z",
+        updated: "2025-06-01T00:00:00.000Z",
+        content: "Qubits are the fundamental unit of quantum computing.",
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    initMetadataDb(":memory:");
+});
+afterEach(() => {
+    closeDb();
+});
+// ---------------------------------------------------------------------------
+// initMetadataDb
+// ---------------------------------------------------------------------------
+describe("initMetadataDb", () => {
+    it("creates database with WAL journaling on disk", () => {
+        // WAL mode only applies to on-disk databases, not :memory:
+        closeDb();
+        const tmpDir = mkdtempSync(join(tmpdir(), "cq-meta-"));
+        const dbPath = join(tmpDir, "test.db");
+        initMetadataDb(dbPath);
+        const db = getDb();
+        const result = db.pragma("journal_mode");
+        expect(result[0].journal_mode).toBe("wal");
+        closeDb();
+        rmSync(tmpDir, { recursive: true, force: true });
+        // Re-init :memory: for remaining tests
+        initMetadataDb(":memory:");
+    });
+    it("is idempotent — can be called twice on the same path", () => {
+        // beforeEach already called once; calling again should not throw
+        closeDb();
+        initMetadataDb(":memory:");
+        initMetadataDb(":memory:");
+    });
+});
+// ---------------------------------------------------------------------------
+// indexEntry
+// ---------------------------------------------------------------------------
+describe("indexEntry", () => {
+    it("inserts a new metadata row", () => {
+        const entry = makeEntry();
+        indexEntry(entry);
+        const meta = getMetadata("science", "quantum-basics");
+        expect(meta).toBeDefined();
+        expect(meta.title).toBe("Quantum Computing Basics");
+        expect(meta.category).toBe("science");
+        expect(meta.slug).toBe("quantum-basics");
+        expect(meta.confidence).toBe(1.0);
+        expect(meta.erosion_rate).toBe(0.0);
+    });
+    it("estimates token count from content (~4 chars per token)", () => {
+        const content = "A".repeat(100); // 100 chars → 25 tokens
+        indexEntry(makeEntry({ content }));
+        const meta = getMetadata("science", "quantum-basics");
+        expect(meta.token_count).toBe(25);
+    });
+    it("counts sources — 1 if source present, 0 otherwise", () => {
+        indexEntry(makeEntry({ source: "https://example.com" }));
+        expect(getMetadata("science", "quantum-basics").source_count).toBe(1);
+        // Overwrite without source
+        indexEntry(makeEntry({ source: undefined }));
+        expect(getMetadata("science", "quantum-basics").source_count).toBe(0);
+    });
+    it("upserts on conflict — updates existing row", () => {
+        indexEntry(makeEntry());
+        indexEntry(makeEntry({ title: "Quantum Updated" }));
+        const meta = getMetadata("science", "quantum-basics");
+        expect(meta.title).toBe("Quantum Updated");
+    });
+    it("preserves created_at from the entry on upsert", () => {
+        indexEntry(makeEntry());
+        const first = getMetadata("science", "quantum-basics");
+        indexEntry(makeEntry({ title: "Updated" }));
+        const second = getMetadata("science", "quantum-basics");
+        // created_at comes from entry.created, not current time
+        expect(second.created_at).toBe(first.created_at);
+    });
+    it("sets updated_at and last_verified_at to current time", () => {
+        const before = new Date().toISOString();
+        indexEntry(makeEntry());
+        const after = new Date().toISOString();
+        const meta = getMetadata("science", "quantum-basics");
+        expect(meta.updated_at >= before).toBe(true);
+        expect(meta.updated_at <= after).toBe(true);
+        expect(meta.last_verified_at >= before).toBe(true);
+        expect(meta.last_verified_at <= after).toBe(true);
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => indexEntry(makeEntry())).toThrow("Metadata DB not initialised");
+    });
+});
+// ---------------------------------------------------------------------------
+// removeFromIndex
+// ---------------------------------------------------------------------------
+describe("removeFromIndex", () => {
+    it("removes an existing metadata row", () => {
+        indexEntry(makeEntry());
+        expect(getMetadata("science", "quantum-basics")).toBeDefined();
+        removeFromIndex("science", "quantum-basics");
+        expect(getMetadata("science", "quantum-basics")).toBeUndefined();
+    });
+    it("is a no-op for non-existent entries", () => {
+        // Should not throw
+        removeFromIndex("nonexistent", "nope");
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => removeFromIndex("a", "b")).toThrow("Metadata DB not initialised");
+    });
+});
+// ---------------------------------------------------------------------------
+// getMetadata
+// ---------------------------------------------------------------------------
+describe("getMetadata", () => {
+    it("returns undefined for non-existent entry", () => {
+        expect(getMetadata("missing", "nothing")).toBeUndefined();
+    });
+    it("returns the full metadata row", () => {
+        indexEntry(makeEntry());
+        const meta = getMetadata("science", "quantum-basics");
+        expect(meta.slug).toBe("quantum-basics");
+        expect(meta.category).toBe("science");
+        expect(meta.title).toBe("Quantum Computing Basics");
+        expect(typeof meta.confidence).toBe("number");
+        expect(typeof meta.created_at).toBe("string");
+        expect(typeof meta.updated_at).toBe("string");
+        expect(typeof meta.last_verified_at).toBe("string");
+        expect(typeof meta.erosion_rate).toBe("number");
+        expect(typeof meta.token_count).toBe("number");
+        expect(typeof meta.source_count).toBe("number");
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => getMetadata("a", "b")).toThrow("Metadata DB not initialised");
+    });
+});
+// ---------------------------------------------------------------------------
+// getStaleEntries
+// ---------------------------------------------------------------------------
+describe("getStaleEntries", () => {
+    it("returns entries at or below confidence threshold", () => {
+        // Index three entries
+        indexEntry(makeEntry({ category: "a", slug: "high" }));
+        indexEntry(makeEntry({ category: "a", slug: "low" }));
+        indexEntry(makeEntry({ category: "b", slug: "medium" }));
+        // Manually lower confidence for testing
+        const db = getDb();
+        db.prepare("UPDATE knowledge_meta SET confidence = 0.3 WHERE slug = 'low'").run();
+        db.prepare("UPDATE knowledge_meta SET confidence = 0.5 WHERE slug = 'medium'").run();
+        const stale = getStaleEntries(0.5);
+        expect(stale).toHaveLength(2);
+        expect(stale[0].slug).toBe("low"); // lowest first
+        expect(stale[1].slug).toBe("medium");
+    });
+    it("returns empty array when no entries are stale", () => {
+        indexEntry(makeEntry());
+        const stale = getStaleEntries(0.5);
+        expect(stale).toHaveLength(0);
+    });
+    it("returns all entries when threshold is 1.0", () => {
+        indexEntry(makeEntry({ category: "a", slug: "one" }));
+        indexEntry(makeEntry({ category: "b", slug: "two" }));
+        const stale = getStaleEntries(1.0);
+        expect(stale).toHaveLength(2);
+    });
+    it("results are ordered by confidence ascending", () => {
+        indexEntry(makeEntry({ category: "a", slug: "x" }));
+        indexEntry(makeEntry({ category: "a", slug: "y" }));
+        indexEntry(makeEntry({ category: "a", slug: "z" }));
+        const db = getDb();
+        db.prepare("UPDATE knowledge_meta SET confidence = 0.1 WHERE slug = 'z'").run();
+        db.prepare("UPDATE knowledge_meta SET confidence = 0.5 WHERE slug = 'y'").run();
+        db.prepare("UPDATE knowledge_meta SET confidence = 0.3 WHERE slug = 'x'").run();
+        const stale = getStaleEntries(1.0);
+        expect(stale.map((e) => e.slug)).toEqual(["z", "x", "y"]);
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => getStaleEntries(0.5)).toThrow("Metadata DB not initialised");
+    });
+});
+//# sourceMappingURL=metadata.test.js.map

package/dist/metadata/__tests__/metadata.test.js.map

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

package/dist/metadata/__tests__/search.test.d.ts

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

package/dist/metadata/__tests__/search.test.d.ts.map

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

package/dist/metadata/__tests__/search.test.js

@@ -0,0 +1,227 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { initMetadataDb, closeDb, getDb, indexEntry, removeFromIndex, } from "../index.js";
+import { search, rebuildIndex } from "../search.js";
+function makeEntry(overrides = {}) {
+    return {
+        category: "science",
+        slug: "quantum-basics",
+        title: "Quantum Computing Basics",
+        tags: ["quantum", "computing"],
+        created: "2025-01-01T00:00:00.000Z",
+        updated: "2025-06-01T00:00:00.000Z",
+        content: "Qubits are the fundamental unit of quantum computing.",
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    initMetadataDb(":memory:");
+});
+afterEach(() => {
+    closeDb();
+});
+// ---------------------------------------------------------------------------
+// FTS5 table creation
+// ---------------------------------------------------------------------------
+describe("FTS5 table", () => {
+    it("is created by initMetadataDb", () => {
+        const db = getDb();
+        const tables = db
+            .prepare("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'knowledge_fts'")
+            .all();
+        expect(tables).toHaveLength(1);
+        expect(tables[0].name).toBe("knowledge_fts");
+    });
+});
+// ---------------------------------------------------------------------------
+// indexEntry → FTS sync
+// ---------------------------------------------------------------------------
+describe("indexEntry FTS sync", () => {
+    it("writes to knowledge_fts when indexing an entry", () => {
+        indexEntry(makeEntry());
+        const results = search("quantum");
+        expect(results).toHaveLength(1);
+        expect(results[0].category).toBe("science");
+        expect(results[0].slug).toBe("quantum-basics");
+        expect(results[0].title).toBe("Quantum Computing Basics");
+    });
+    it("updates FTS on re-index (upsert)", () => {
+        indexEntry(makeEntry());
+        indexEntry(makeEntry({
+            title: "Updated Title",
+            content: "Classical bits versus qubits.",
+        }));
+        // Should still be one result, not duplicated
+        const results = search("qubits");
+        expect(results).toHaveLength(1);
+        expect(results[0].title).toBe("Updated Title");
+    });
+    it("stores tags as JSON in FTS", () => {
+        indexEntry(makeEntry({ tags: ["physics", "computing"] }));
+        // Tags are searchable
+        const results = search("physics");
+        expect(results).toHaveLength(1);
+    });
+});
+// ---------------------------------------------------------------------------
+// removeFromIndex → FTS sync
+// ---------------------------------------------------------------------------
+describe("removeFromIndex FTS sync", () => {
+    it("removes from knowledge_fts when removing from index", () => {
+        indexEntry(makeEntry());
+        expect(search("quantum")).toHaveLength(1);
+        removeFromIndex("science", "quantum-basics");
+        expect(search("quantum")).toHaveLength(0);
+    });
+    it("is a no-op for non-existent FTS entries", () => {
+        // Should not throw
+        removeFromIndex("nonexistent", "nope");
+    });
+});
+// ---------------------------------------------------------------------------
+// search
+// ---------------------------------------------------------------------------
+describe("search", () => {
+    it("returns results ranked by BM25 relevance", () => {
+        // Entry with "quantum" in title AND content should rank higher
+        indexEntry(makeEntry({
+            category: "science",
+            slug: "quantum-deep",
+            title: "Quantum Quantum Quantum",
+            content: "Quantum mechanics is about quantum states and quantum entanglement.",
+            tags: ["quantum"],
+        }));
+        // Entry with "quantum" only once in content
+        indexEntry(makeEntry({
+            category: "misc",
+            slug: "general-physics",
+            title: "General Physics",
+            content: "Physics covers many areas including quantum mechanics.",
+            tags: ["physics"],
+        }));
+        const results = search("quantum");
+        expect(results).toHaveLength(2);
+        // The entry with more quantum mentions should rank first (lower BM25 = better)
+        expect(results[0].slug).toBe("quantum-deep");
+        expect(results[1].slug).toBe("general-physics");
+    });
+    it("returns snippet with markers", () => {
+        indexEntry(makeEntry({
+            content: "The quantum computer uses qubits to perform calculations at incredible speed.",
+        }));
+        const results = search("qubits");
+        expect(results).toHaveLength(1);
+        expect(results[0].snippet).toContain("<mark>");
+        expect(results[0].snippet).toContain("</mark>");
+    });
+    it("respects the limit parameter", () => {
+        for (let i = 0; i < 5; i++) {
+            indexEntry(makeEntry({
+                category: "cat",
+                slug: `entry-${i}`,
+                content: `Quantum computing entry number ${i}`,
+            }));
+        }
+        const results = search("quantum", 3);
+        expect(results).toHaveLength(3);
+    });
+    it("defaults limit to 10", () => {
+        for (let i = 0; i < 15; i++) {
+            indexEntry(makeEntry({
+                category: "cat",
+                slug: `entry-${i}`,
+                content: `Quantum computing entry number ${i}`,
+            }));
+        }
+        const results = search("quantum");
+        expect(results).toHaveLength(10);
+    });
+    it("returns empty array for no matches", () => {
+        indexEntry(makeEntry());
+        const results = search("nonexistent");
+        expect(results).toHaveLength(0);
+    });
+    it("includes rank as a number", () => {
+        indexEntry(makeEntry());
+        const results = search("quantum");
+        expect(results).toHaveLength(1);
+        expect(typeof results[0].rank).toBe("number");
+    });
+    it("supports FTS5 prefix queries", () => {
+        indexEntry(makeEntry({ content: "Computational chemistry is fascinating." }));
+        const results = search("comput*");
+        expect(results).toHaveLength(1);
+    });
+    it("supports FTS5 phrase queries", () => {
+        indexEntry(makeEntry({
+            category: "tech",
+            slug: "qc-intro",
+            title: "Introduction",
+            tags: [],
+            content: "Quantum computing is the future of technology.",
+        }));
+        indexEntry(makeEntry({
+            category: "other",
+            slug: "unrelated",
+            title: "Classical Algorithms",
+            tags: ["math"],
+            content: "The power of classical algorithms is immense.",
+        }));
+        const results = search('"quantum computing"');
+        expect(results).toHaveLength(1);
+        expect(results[0].slug).toBe("qc-intro");
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => search("test")).toThrow("Metadata DB not initialised");
+    });
+});
+// ---------------------------------------------------------------------------
+// rebuildIndex
+// ---------------------------------------------------------------------------
+describe("rebuildIndex", () => {
+    it("rebuilds FTS from a list of entries", () => {
+        const entries = [
+            makeEntry({ category: "a", slug: "one", content: "Alpha content" }),
+            makeEntry({ category: "b", slug: "two", content: "Beta content" }),
+            makeEntry({ category: "c", slug: "three", content: "Gamma content" }),
+        ];
+        rebuildIndex(entries);
+        expect(search("alpha")).toHaveLength(1);
+        expect(search("beta")).toHaveLength(1);
+        expect(search("gamma")).toHaveLength(1);
+        expect(search("content")).toHaveLength(3);
+    });
+    it("clears previous FTS data before rebuilding", () => {
+        // Index an entry normally
+        indexEntry(makeEntry({
+            category: "old",
+            slug: "stale",
+            content: "This is old stale content.",
+        }));
+        expect(search("stale")).toHaveLength(1);
+        // Rebuild with different entries — old data should be gone
+        rebuildIndex([
+            makeEntry({ category: "new", slug: "fresh", content: "Fresh new data." }),
+        ]);
+        expect(search("stale")).toHaveLength(0);
+        expect(search("fresh")).toHaveLength(1);
+    });
+    it("handles empty entries array", () => {
+        indexEntry(makeEntry());
+        expect(search("quantum")).toHaveLength(1);
+        rebuildIndex([]);
+        expect(search("quantum")).toHaveLength(0);
+    });
+    it("preserves tags in rebuilt index", () => {
+        rebuildIndex([
+            makeEntry({ tags: ["deeplearning", "ai"] }),
+        ]);
+        const results = search("deeplearning");
+        expect(results).toHaveLength(1);
+    });
+    it("throws if db not initialised", () => {
+        closeDb();
+        expect(() => rebuildIndex([])).toThrow("Metadata DB not initialised");
+    });
+});
+//# sourceMappingURL=search.test.js.map

package/dist/metadata/__tests__/search.test.js.map

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

package/dist/metadata/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Metadata Store — SQLite-backed metadata tracking for knowledge entries.
+ *
+ * Tracks confidence scores, token counts, erosion rates, and timestamps
+ * alongside the knowledge tree.
+ */
+import Database from "better-sqlite3";
+import type { KnowledgeMetadata } from "./types.js";
+import type { KnowledgeEntry } from "../knowledge-tree/types.js";
+export type { KnowledgeMetadata } from "./types.js";
+/** Initialise (or open) the metadata SQLite database with WAL journaling. */
+export declare function initMetadataDb(dbPath: string): Database.Database;
+/** Close the database connection. */
+export declare function closeDb(): void;
+/** Return the current database instance (mainly for testing). */
+export declare function getDb(): Database.Database | null;
+/**
+ * Index (upsert) a KnowledgeEntry into the metadata store.
+ *
+ * Sets confidence to 1.0 and resets last_verified_at on every write.
+ */
+export declare function indexEntry(entry: KnowledgeEntry): void;
+/** Remove metadata for a specific entry. */
+export declare function removeFromIndex(category: string, slug: string): void;
+/** Retrieve metadata for a specific entry, or undefined if not found. */
+export declare function getMetadata(category: string, slug: string): KnowledgeMetadata | undefined;
+/** Return all entries with confidence at or below the given threshold. */
+export declare function getStaleEntries(threshold: number): KnowledgeMetadata[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metadata/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAQpD,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAMhE;AAED,qCAAqC;AACrC,wBAAgB,OAAO,IAAI,IAAI,CAK9B;AAED,iEAAiE;AACjE,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAEhD;AAoBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CA6CtD;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAUpE;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,iBAAiB,GAAG,SAAS,CAQ/B;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAOtE"}