gnosys 4.0.0

package/dist/lib/federated.js

@@ -0,0 +1,346 @@
+/**
+ * Gnosys Federated Search — Phase 8d
+ *
+ * Searches across all scopes (project → user → global) with tier boosting,
+ * multi-project ambiguity detection, implicit working set recency boost,
+ * and project briefing generation.
+ *
+ * Tier boosting order: project (1.5x) > user (1.0x) > global (0.7x)
+ * Recency boost: memories accessed/modified in the last 24h get a 1.3x boost
+ */
+import { findProjectIdentity } from "./projectIdentity.js";
+// ─── Boost Constants ────────────────────────────────────────────────────
+const SCOPE_BOOST = {
+    project: 1.5,
+    user: 1.0,
+    global: 0.7,
+};
+const RECENCY_BOOST = 1.3;
+const REINFORCEMENT_BOOST_PER = 0.05; // per reinforcement, capped at 0.25
+// ─── Federated Search ───────────────────────────────────────────────────
+/**
+ * Search across all scopes with tier boosting and recency awareness.
+ * Results from the current project rank highest, then user-scoped, then global.
+ */
+export function federatedSearch(db, query, opts = {}) {
+    const { limit = 20, projectId = null, includeGlobal = true, recencyWindowHours = 24, scopeFilter, } = opts;
+    // Run FTS5 search across ALL memories (no scope filter at query time)
+    const rawResults = db.searchFts(query, limit * 3);
+    if (rawResults.length === 0)
+        return [];
+    // Build a project name lookup
+    const projects = db.getAllProjects();
+    const projectMap = new Map();
+    for (const p of projects) {
+        projectMap.set(p.id, p.name);
+    }
+    const now = Date.now();
+    const recencyThreshold = now - recencyWindowHours * 60 * 60 * 1000;
+    // Score each result with tier boosting
+    const scored = [];
+    for (let i = 0; i < rawResults.length; i++) {
+        const r = rawResults[i];
+        const mem = db.getMemory(r.id);
+        if (!mem || mem.status !== "active")
+            continue;
+        const scope = (mem.scope || "project");
+        // Skip if scope filter is active and this scope isn't included
+        if (scopeFilter && scopeFilter.length > 0 && !scopeFilter.includes(scope))
+            continue;
+        // Skip global if not requested (legacy flag, scopeFilter takes precedence)
+        if (!scopeFilter && !includeGlobal && scope === "global")
+            continue;
+        // Base score: inverse of FTS rank position (higher = better)
+        let score = 1 / (60 + i + 1);
+        const boosts = [];
+        // 1. Scope boost
+        const scopeBoost = SCOPE_BOOST[scope];
+        // Extra boost if this memory belongs to the CURRENT project
+        if (scope === "project" && projectId && mem.project_id === projectId) {
+            score *= scopeBoost * 1.2; // 1.5 * 1.2 = 1.8x for current project
+            boosts.push("current-project");
+        }
+        else {
+            score *= scopeBoost;
+        }
+        boosts.push(`scope:${scope}`);
+        // 2. Recency boost
+        const modifiedMs = new Date(mem.modified).getTime();
+        if (modifiedMs > recencyThreshold) {
+            score *= RECENCY_BOOST;
+            boosts.push("recent");
+        }
+        // 3. Reinforcement boost (capped)
+        if (mem.reinforcement_count > 0) {
+            const rBoost = 1 + Math.min(mem.reinforcement_count * REINFORCEMENT_BOOST_PER, 0.25);
+            score *= rBoost;
+            boosts.push(`reinforced:${mem.reinforcement_count}`);
+        }
+        // 4. Confidence factor
+        score *= mem.confidence;
+        scored.push({
+            id: mem.id,
+            title: mem.title,
+            category: mem.category,
+            snippet: r.snippet,
+            score,
+            scope,
+            projectId: mem.project_id,
+            projectName: mem.project_id ? (projectMap.get(mem.project_id) || null) : null,
+            boosts,
+        });
+    }
+    // Sort by boosted score descending
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, limit);
+}
+/**
+ * Discover across all scopes — lightweight metadata search
+ * with the same tier boosting logic.
+ */
+export function federatedDiscover(db, query, opts = {}) {
+    const { limit = 20, projectId = null, includeGlobal = true, recencyWindowHours = 24, } = opts;
+    const rawResults = db.discoverFts(query, limit * 3);
+    if (rawResults.length === 0)
+        return [];
+    const projects = db.getAllProjects();
+    const projectMap = new Map();
+    for (const p of projects) {
+        projectMap.set(p.id, p.name);
+    }
+    const now = Date.now();
+    const recencyThreshold = now - recencyWindowHours * 60 * 60 * 1000;
+    const scopeFilter = opts.scopeFilter;
+    const scored = [];
+    for (let i = 0; i < rawResults.length; i++) {
+        const r = rawResults[i];
+        const mem = db.getMemory(r.id);
+        if (!mem || mem.status !== "active")
+            continue;
+        const scope = (mem.scope || "project");
+        if (scopeFilter && scopeFilter.length > 0 && !scopeFilter.includes(scope))
+            continue;
+        if (!scopeFilter && !includeGlobal && scope === "global")
+            continue;
+        let score = 1 / (60 + i + 1);
+        const boosts = [];
+        const scopeBoost = SCOPE_BOOST[scope];
+        if (scope === "project" && projectId && mem.project_id === projectId) {
+            score *= scopeBoost * 1.2;
+            boosts.push("current-project");
+        }
+        else {
+            score *= scopeBoost;
+        }
+        boosts.push(`scope:${scope}`);
+        const modifiedMs = new Date(mem.modified).getTime();
+        if (modifiedMs > recencyThreshold) {
+            score *= RECENCY_BOOST;
+            boosts.push("recent");
+        }
+        if (mem.reinforcement_count > 0) {
+            const rBoost = 1 + Math.min(mem.reinforcement_count * REINFORCEMENT_BOOST_PER, 0.25);
+            score *= rBoost;
+        }
+        score *= mem.confidence;
+        scored.push({
+            id: mem.id,
+            title: mem.title,
+            category: mem.category,
+            snippet: r.relevance,
+            score,
+            scope,
+            projectId: mem.project_id,
+            projectName: mem.project_id ? (projectMap.get(mem.project_id) || null) : null,
+            boosts,
+        });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, limit);
+}
+// ─── Multi-Project Ambiguity Detection ──────────────────────────────────
+/**
+ * Detect ambiguity when multiple projects match a query.
+ * Used by write operations — if the user doesn't specify a project and
+ * multiple projects have matching content, raise an ambiguity error
+ * listing all candidates.
+ */
+export function detectAmbiguity(db, query, opts) {
+    const threshold = opts?.threshold ?? 2;
+    // Search and group results by project
+    const results = db.searchFts(query, 50);
+    const projectHits = new Map();
+    for (const r of results) {
+        const mem = db.getMemory(r.id);
+        if (!mem || !mem.project_id)
+            continue;
+        projectHits.set(mem.project_id, (projectHits.get(mem.project_id) || 0) + 1);
+    }
+    // Only ambiguous if multiple projects have results
+    if (projectHits.size < threshold)
+        return null;
+    const projects = db.getAllProjects();
+    const projectMap = new Map();
+    for (const p of projects) {
+        projectMap.set(p.id, p);
+    }
+    const candidates = Array.from(projectHits.entries())
+        .map(([pid, count]) => {
+        const proj = projectMap.get(pid);
+        return {
+            projectId: pid,
+            projectName: proj?.name || "unknown",
+            workingDirectory: proj?.working_directory || "unknown",
+            memoryCount: count,
+        };
+    })
+        .sort((a, b) => b.memoryCount - a.memoryCount);
+    return {
+        type: "ambiguous_project",
+        message: `Query "${query}" matches memories in ${candidates.length} projects. Specify a project to narrow results.`,
+        candidates,
+    };
+}
+/**
+ * Auto-detect the current project from a working directory.
+ * Returns the projectId or null.
+ */
+export async function detectCurrentProject(db, workingDir) {
+    // Try to find project identity from directory
+    if (workingDir) {
+        const identity = await findProjectIdentity(workingDir);
+        if (identity)
+            return identity.identity.projectId;
+    }
+    // Try cwd
+    const identity = await findProjectIdentity(process.cwd());
+    if (identity)
+        return identity.identity.projectId;
+    return null;
+}
+// ─── Dream Mode Project Briefings ───────────────────────────────────────
+/**
+ * Generate a project briefing — a pre-computed summary of a project's
+ * memory state. Designed for "dream mode" pre-computation or on-demand
+ * project status checks.
+ */
+export function generateBriefing(db, projectId) {
+    const project = db.getProject(projectId);
+    if (!project)
+        return null;
+    const memories = db.getMemoriesByProject(projectId);
+    const allProjectMems = memories;
+    // Category breakdown
+    const categories = {};
+    for (const m of allProjectMems) {
+        categories[m.category] = (categories[m.category] || 0) + 1;
+    }
+    // Recent activity (last 7 days)
+    const weekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
+    const recentActivity = allProjectMems
+        .filter((m) => m.modified >= weekAgo)
+        .sort((a, b) => b.modified.localeCompare(a.modified))
+        .slice(0, 10)
+        .map((m) => ({ id: m.id, title: m.title, modified: m.modified }));
+    // Top tags (parse JSON tag arrays, count occurrences)
+    const tagCounts = new Map();
+    for (const m of allProjectMems) {
+        try {
+            const tags = JSON.parse(m.tags || "[]");
+            for (const tag of tags) {
+                tagCounts.set(tag, (tagCounts.get(tag) || 0) + 1);
+            }
+        }
+        catch {
+            // tags might be comma-separated or malformed
+            if (m.tags) {
+                for (const t of m.tags.split(",").map((s) => s.trim()).filter(Boolean)) {
+                    tagCounts.set(t, (tagCounts.get(t) || 0) + 1);
+                }
+            }
+        }
+    }
+    const topTags = Array.from(tagCounts.entries())
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 15)
+        .map(([tag, count]) => ({ tag, count }));
+    // Generate human-readable summary
+    const catList = Object.entries(categories)
+        .sort((a, b) => b[1] - a[1])
+        .map(([cat, count]) => `${cat} (${count})`)
+        .join(", ");
+    const summary = [
+        `Project "${project.name}" has ${allProjectMems.length} active memories across ${Object.keys(categories).length} categories: ${catList}.`,
+        recentActivity.length > 0
+            ? `${recentActivity.length} memories modified in the last 7 days.`
+            : "No recent activity.",
+        topTags.length > 0
+            ? `Top tags: ${topTags.slice(0, 5).map((t) => t.tag).join(", ")}.`
+            : "",
+    ].filter(Boolean).join(" ");
+    return {
+        projectId,
+        projectName: project.name,
+        workingDirectory: project.working_directory,
+        totalMemories: allProjectMems.length,
+        activeMemories: allProjectMems.filter((m) => m.status === "active").length,
+        categories,
+        recentActivity,
+        topTags,
+        summary,
+    };
+}
+/**
+ * Generate briefings for ALL registered projects.
+ * Used by dream mode to pre-compute briefings.
+ */
+export function generateAllBriefings(db) {
+    const projects = db.getAllProjects();
+    const briefings = [];
+    for (const project of projects) {
+        const briefing = generateBriefing(db, project.id);
+        if (briefing) {
+            briefings.push(briefing);
+        }
+    }
+    return briefings;
+}
+// ─── Implicit Working Set ───────────────────────────────────────────────
+/**
+ * Get the implicit working set — recently accessed/modified memories
+ * for the current project. These get boosted in federated search results.
+ */
+export function getWorkingSet(db, projectId, opts) {
+    const windowHours = opts?.windowHours ?? 24;
+    const limit = opts?.limit ?? 20;
+    const threshold = new Date(Date.now() - windowHours * 60 * 60 * 1000).toISOString();
+    const memories = db.getMemoriesByProject(projectId);
+    return memories
+        .filter((m) => m.modified >= threshold || (m.last_reinforced && m.last_reinforced >= threshold))
+        .sort((a, b) => b.modified.localeCompare(a.modified))
+        .slice(0, limit);
+}
+/**
+ * Format the working set as a concise context block for agent consumption.
+ */
+export function formatWorkingSet(memories) {
+    if (memories.length === 0)
+        return "No recent activity in working set.";
+    const lines = memories.map((m) => {
+        const age = getRelativeTime(m.modified);
+        return `- [${m.id}] ${m.title} (${m.category}, ${age})`;
+    });
+    return `Working set (${memories.length} recent memories):\n${lines.join("\n")}`;
+}
+// ─── Helpers ────────────────────────────────────────────────────────────
+function getRelativeTime(isoDate) {
+    const diffMs = Date.now() - new Date(isoDate).getTime();
+    const hours = Math.floor(diffMs / (1000 * 60 * 60));
+    if (hours < 1)
+        return "just now";
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+//# sourceMappingURL=federated.js.map

package/dist/lib/federated.js.map

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

package/dist/lib/graph.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Gnosys Graph — Persistent wikilink graph stored as .gnosys/graph.json.
+ * Fully regeneratable sidecar file. Parses all [[wikilinks]] from memories
+ * and builds a JSON graph with nodes, edges, and stats.
+ */
+import { GnosysResolver } from "./resolver.js";
+export interface GraphNode {
+    id: string;
+    title: string;
+    edges: number;
+    outgoing: number;
+    incoming: number;
+}
+export interface GraphEdge {
+    source: string;
+    target: string;
+    label: string;
+}
+export interface GraphJSON {
+    /** ISO timestamp of generation */
+    generated: string;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    stats: GraphStats;
+}
+export interface GraphStats {
+    totalNodes: number;
+    totalEdges: number;
+    orphanNodes: number;
+    orphanLinks: number;
+    mostConnected: {
+        id: string;
+        title: string;
+        edges: number;
+    } | null;
+    avgEdgesPerNode: number;
+}
+/**
+ * Build the wikilink graph from all stores and write to .gnosys/graph.json.
+ */
+export declare function reindexGraph(resolver: GnosysResolver, onLog?: (message: string) => void): Promise<GraphStats>;
+/**
+ * Load the persisted graph from .gnosys/graph.json.
+ */
+export declare function loadGraph(storePath: string): Promise<GraphJSON | null>;
+/**
+ * Format graph stats for display.
+ */
+export declare function formatGraphStats(stats: GraphStats): string;
+//# sourceMappingURL=graph.d.ts.map

package/dist/lib/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/lib/graph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAM/C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnE,eAAe,EAAE,MAAM,CAAC;CACzB;AAID;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,cAAc,EACxB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAChC,OAAO,CAAC,UAAU,CAAC,CA8BrB;AAgED;;GAEG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAQ5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAY1D"}

package/dist/lib/graph.js

@@ -0,0 +1,118 @@
+/**
+ * Gnosys Graph — Persistent wikilink graph stored as .gnosys/graph.json.
+ * Fully regeneratable sidecar file. Parses all [[wikilinks]] from memories
+ * and builds a JSON graph with nodes, edges, and stats.
+ */
+import fs from "fs/promises";
+import path from "path";
+import { buildLinkGraph } from "./wikilinks.js";
+// ─── Build & Persist ────────────────────────────────────────────────────
+/**
+ * Build the wikilink graph from all stores and write to .gnosys/graph.json.
+ */
+export async function reindexGraph(resolver, onLog) {
+    const stores = resolver.getStores();
+    if (stores.length === 0) {
+        throw new Error("No Gnosys stores found.");
+    }
+    // Collect all memories across stores
+    const allMemories = [];
+    for (const s of stores) {
+        const memories = await s.store.getAllMemories();
+        allMemories.push(...memories);
+    }
+    onLog?.(`Scanning ${allMemories.length} memories for [[wikilinks]]...`);
+    // Build the in-memory link graph using existing wikilinks module
+    const linkGraph = buildLinkGraph(allMemories);
+    // Convert to serializable format
+    const graphJSON = linkGraphToJSON(linkGraph);
+    onLog?.(`Found ${graphJSON.stats.totalEdges} edges across ${graphJSON.stats.totalNodes} nodes`);
+    // Write to the first store's path
+    const graphPath = path.join(stores[0].path, "graph.json");
+    await fs.writeFile(graphPath, JSON.stringify(graphJSON, null, 2) + "\n", "utf-8");
+    onLog?.(`Graph written to ${graphPath}`);
+    return graphJSON.stats;
+}
+/**
+ * Convert an in-memory LinkGraph to a serializable GraphJSON.
+ */
+function linkGraphToJSON(graph) {
+    const nodes = [];
+    const edges = [];
+    for (const [nodePath, node] of graph.nodes) {
+        nodes.push({
+            id: nodePath,
+            title: node.title,
+            edges: node.outgoing.length + node.incoming.length,
+            outgoing: node.outgoing.length,
+            incoming: node.incoming.length,
+        });
+        // Add edges (only from outgoing to avoid duplicates)
+        for (const link of node.outgoing) {
+            // Find the resolved target path
+            const targetNode = Array.from(graph.nodes.values()).find((n) => n.title.toLowerCase() === link.target.toLowerCase() ||
+                n.path === link.target ||
+                n.path === link.target + ".md" ||
+                n.path.split("/").pop()?.replace(/\.md$/, "") === link.target);
+            if (targetNode) {
+                edges.push({
+                    source: nodePath,
+                    target: targetNode.path,
+                    label: link.target,
+                });
+            }
+        }
+    }
+    // Sort nodes by edge count (most connected first)
+    nodes.sort((a, b) => b.edges - a.edges);
+    const orphanNodes = nodes.filter((n) => n.edges === 0).length;
+    const mostConnected = nodes.length > 0 && nodes[0].edges > 0
+        ? { id: nodes[0].id, title: nodes[0].title, edges: nodes[0].edges }
+        : null;
+    const avgEdgesPerNode = nodes.length > 0
+        ? edges.length * 2 / nodes.length // each edge touches 2 nodes
+        : 0;
+    return {
+        generated: new Date().toISOString(),
+        nodes,
+        edges,
+        stats: {
+            totalNodes: nodes.length,
+            totalEdges: edges.length,
+            orphanNodes,
+            orphanLinks: graph.orphanedLinks.length,
+            mostConnected,
+            avgEdgesPerNode: Math.round(avgEdgesPerNode * 100) / 100,
+        },
+    };
+}
+/**
+ * Load the persisted graph from .gnosys/graph.json.
+ */
+export async function loadGraph(storePath) {
+    try {
+        const graphPath = path.join(storePath, "graph.json");
+        const raw = await fs.readFile(graphPath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Format graph stats for display.
+ */
+export function formatGraphStats(stats) {
+    const lines = [];
+    lines.push(`Wikilink Graph:`);
+    lines.push(`  Nodes: ${stats.totalNodes}`);
+    lines.push(`  Edges: ${stats.totalEdges}`);
+    lines.push(`  Orphan nodes (no links): ${stats.orphanNodes}`);
+    lines.push(`  Orphan links (unresolved): ${stats.orphanLinks}`);
+    lines.push(`  Avg edges/node: ${stats.avgEdgesPerNode}`);
+    if (stats.mostConnected) {
+        lines.push(`  Most connected: ${stats.mostConnected.title} (${stats.mostConnected.edges} edges)`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=graph.js.map

package/dist/lib/graph.js.map

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

package/dist/lib/history.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Gnosys History — Git-backed version history for individual memories.
+ *
+ * Every memory write/update auto-commits to git. This module exposes
+ * that history: view what changed, when, and rollback to prior versions.
+ */
+export interface HistoryEntry {
+    commitHash: string;
+    date: string;
+    message: string;
+}
+export interface MemoryVersion {
+    commitHash: string;
+    date: string;
+    message: string;
+    content: string;
+}
+/**
+ * Get the commit history for a specific memory file.
+ */
+export declare function getFileHistory(storePath: string, relativePath: string, limit?: number): HistoryEntry[];
+/**
+ * Get the full file content at a specific commit.
+ */
+export declare function getFileAtCommit(storePath: string, relativePath: string, commitHash: string): string | null;
+/**
+ * Get a diff between two commits for a specific file.
+ */
+export declare function getFileDiff(storePath: string, relativePath: string, fromHash: string, toHash: string): string | null;
+/**
+ * Rollback a memory to its state at a specific commit.
+ * Creates a new commit with the reverted content (non-destructive).
+ */
+export declare function rollbackToCommit(storePath: string, relativePath: string, commitHash: string): boolean;
+/**
+ * Check if git is available and the store has history.
+ */
+export declare function hasGitHistory(storePath: string): boolean;
+//# sourceMappingURL=history.d.ts.map

package/dist/lib/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/lib/history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,MAAW,GACjB,YAAY,EAAE,CA2BhB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAaf;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAaf;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CA8BT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAUxD"}