kontexta 4.3.1

package/bundle/standalone/node_modules/kxta-core/dist/db/index.js

@@ -0,0 +1,182 @@
+/**
+ * Database module for Kontexta
+ * Manages SQLite database connection, migrations, and singleton pattern
+ */
+import Database from "better-sqlite3";
+import { readFileSync, readdirSync, mkdirSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { getDbPath, ensureDataDir } from "../util/paths.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Locate the SQL migrations directory across deployment shapes:
+// - tsc build: dist/db/migrations (sibling of this file)
+// - Next.js standalone: src files traced to monorepo-relative paths under /app
+// - Next.js standalone with cwd in apps/web: walk up two levels
+function resolveMigrationsDir() {
+    const candidates = [
+        // Docker: WORKDIR=/app, migrations explicitly copied to /app/packages/core/src/db/migrations
+        join(process.cwd(), "packages", "core", "src", "db", "migrations"),
+        // tsc build: dist/db/migrations (sibling of this file's dist location)
+        join(__dirname, "migrations"),
+        // Next.js standalone: __dirname resolves relative to the traced module
+        join(__dirname, "..", "..", "src", "db", "migrations"),
+        // Fallback: dist copy
+        join(process.cwd(), "packages", "core", "dist", "db", "migrations"),
+        join(process.cwd(), "..", "..", "packages", "core", "src", "db", "migrations"),
+        join(process.cwd(), "..", "..", "packages", "core", "dist", "db", "migrations"),
+    ];
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    throw new Error(`migrations directory not found. Checked:\n- ${candidates.join("\n- ")}`);
+}
+let db = globalThis.__kontextaDb ?? null;
+/**
+ * Create and initialize the database
+ * @param dbPath - Path to the SQLite database file
+ * @returns Database instance
+ */
+export function createDatabase(dbPath) {
+    if (db) {
+        return db;
+    }
+    mkdirSync(dirname(dbPath), { recursive: true });
+    db = new Database(dbPath);
+    globalThis.__kontextaDb = db;
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    runMigrations();
+    if (!globalThis.__kontextaDbCloseRegistered) {
+        globalThis.__kontextaDbCloseRegistered = true;
+        const close = () => {
+            try {
+                closeDatabase();
+            }
+            catch { }
+        };
+        process.once("beforeExit", close);
+        // Real drain: stop accepting new work via setShuttingDown, await the
+        // in-flight tracker (bounded by SHUTDOWN_DRAIN_MS), then close. The
+        // previous setTimeout-only implementation never invoked the drain
+        // machinery, so in-flight ops were killed mid-flight regardless of
+        // how quickly they could have finished.
+        const SHUTDOWN_DRAIN_MS = Number(process.env.KONTEXTA_SHUTDOWN_DRAIN_MS ?? 1500);
+        const gracefulExit = (signal) => {
+            console.error(`[Database] ${signal} received, draining up to ${SHUTDOWN_DRAIN_MS}ms before close`);
+            gracefulShutdown(SHUTDOWN_DRAIN_MS).then((remaining) => {
+                if (remaining > 0) {
+                    console.error(`[Database] drain timed out with ${remaining} op(s) still in flight`);
+                }
+                process.exit(0);
+            }).catch((e) => {
+                console.error(`[Database] gracefulShutdown failed:`, e);
+                try {
+                    close();
+                }
+                catch { }
+                process.exit(1);
+            });
+        };
+        process.once("SIGINT", () => gracefulExit("SIGINT"));
+        process.once("SIGTERM", () => gracefulExit("SIGTERM"));
+    }
+    return db;
+}
+/**
+ * Get the existing database instance
+ * @returns Database instance
+ * @throws Error if database is not initialized
+ */
+export function getDatabase() {
+    if (!db) {
+        ensureDataDir();
+        return createDatabase(getDbPath());
+    }
+    return db;
+}
+/**
+ * Close the database connection
+ */
+export function closeDatabase() {
+    if (db) {
+        // Force checkpoint WAL so writes are visible to other connections/processes
+        // that open the same database file (critical for Docker MCP → Web UI sharing).
+        // better-sqlite3's db.pragma() expects the body WITHOUT the "PRAGMA"
+        // keyword. The previous duplicate-keyword form threw a syntax error
+        // that the catch silently swallowed, so the checkpoint never ran —
+        // defeating the "WAL visible to other connections" guarantee.
+        try {
+            db.pragma("wal_checkpoint(TRUNCATE)");
+        }
+        catch { }
+        db.close();
+        db = null;
+        globalThis.__kontextaDb = null;
+    }
+}
+/**
+ * Graceful shutdown: stop accepting new work, drain in-flight ops with a
+ * hard ceiling, then close the database. Returns the count of operations
+ * that were still in-flight when the timeout elapsed (0 = clean drain).
+ */
+export async function gracefulShutdown(timeoutMs = 10_000) {
+    const { setShuttingDown, awaitDrain } = await import("../util/safety.js");
+    setShuttingDown(true);
+    // Close file watchers FIRST so pending chokidar events stop firing before
+    // we tear down the DB. Otherwise the drained "in-flight" count goes back up
+    // mid-shutdown as new watcher events queue.
+    try {
+        const { closeAllFileWatchers } = await import("../watcher/index.js");
+        await closeAllFileWatchers();
+    }
+    catch { }
+    const remaining = await awaitDrain(timeoutMs);
+    closeDatabase();
+    return remaining;
+}
+/**
+ * Run all pending migrations
+ */
+export function runMigrations() {
+    if (!db) {
+        throw new Error("Database not initialized. Call createDatabase() first.");
+    }
+    // Create migrations table if not exists
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS _migrations (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      name TEXT NOT NULL UNIQUE,
+      executed_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    const migrationsDir = resolveMigrationsDir();
+    // Get all .sql files and sort them
+    const migrationFiles = readdirSync(migrationsDir)
+        .filter((file) => file.endsWith(".sql"))
+        .sort();
+    const getMigrationStmt = db.prepare("SELECT id FROM _migrations WHERE name = ?");
+    const insertMigrationStmt = db.prepare("INSERT INTO _migrations (name) VALUES (?)");
+    // Execute each migration in order
+    for (const file of migrationFiles) {
+        const isExecuted = getMigrationStmt.get(file);
+        if (!isExecuted) {
+            const migrationPath = join(migrationsDir, file);
+            const sql = readFileSync(migrationPath, "utf-8");
+            // We wrap the .sql in a JS-side transaction; an inner BEGIN/COMMIT
+            // would conflict with that and leave the migration partially applied
+            // with no _migrations row, causing a permanent re-run loop on boot.
+            if (/^\s*(BEGIN|COMMIT|ROLLBACK)\b/im.test(sql)) {
+                throw new Error(`Migration ${file} contains BEGIN/COMMIT/ROLLBACK; remove it (the migration runner already wraps in a transaction).`);
+            }
+            console.error(`[Database] Running migration: ${file}`);
+            // Execute the migration in a transaction
+            db.transaction(() => {
+                db.exec(sql);
+                insertMigrationStmt.run(file);
+            })();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/bundle/standalone/node_modules/kxta-core/dist/db/index.js.map

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

package/bundle/standalone/node_modules/kxta-core/dist/db/migrations/001-initial.sql

@@ -0,0 +1,72 @@
+-- Initial database schema for Kontexta
+
+-- Projects table
+CREATE TABLE IF NOT EXISTS projects (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  slug TEXT NOT NULL UNIQUE,
+  description TEXT,
+  path TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Files table
+CREATE TABLE IF NOT EXISTS files (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  path TEXT NOT NULL UNIQUE,
+  title TEXT NOT NULL,
+  project_id INTEGER,
+  storage_type TEXT NOT NULL CHECK(storage_type IN ('local', 'reference', 'backup')),
+  source_path TEXT,
+  content_hash TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (project_id) REFERENCES projects(id)
+);
+
+-- Tags table
+CREATE TABLE IF NOT EXISTS tags (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  color TEXT
+);
+
+-- File-Tag junction table
+CREATE TABLE IF NOT EXISTS file_tags (
+  file_id INTEGER NOT NULL,
+  tag_id INTEGER NOT NULL,
+  PRIMARY KEY (file_id, tag_id),
+  FOREIGN KEY (file_id) REFERENCES files(id) ON DELETE CASCADE,
+  FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE
+);
+
+-- Favorites table
+CREATE TABLE IF NOT EXISTS favorites (
+  file_id INTEGER PRIMARY KEY,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (file_id) REFERENCES files(id) ON DELETE CASCADE
+);
+
+-- Users table
+CREATE TABLE IF NOT EXISTS users (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL,
+  email TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Insert default user
+INSERT OR IGNORE INTO users (id, name, email)
+VALUES (1, 'Default User', NULL);
+
+-- FTS5 virtual table for full-text search
+CREATE VIRTUAL TABLE IF NOT EXISTS fts_index USING fts5(
+  title,
+  content,
+  tokenize='porter unicode61'
+);
+
+-- Indexes for performance
+CREATE INDEX IF NOT EXISTS idx_files_project ON files(project_id);
+CREATE INDEX IF NOT EXISTS idx_files_storage_type ON files(storage_type);
+CREATE INDEX IF NOT EXISTS idx_files_path ON files(path);

package/bundle/standalone/node_modules/kxta-core/dist/db/migrations/002-remote-git.sql

@@ -0,0 +1,2 @@
+-- Add remote_url to projects for collaboration
+ALTER TABLE projects ADD COLUMN remote_url TEXT;

package/bundle/standalone/node_modules/kxta-core/dist/db/migrations/003-source-path-index.sql

@@ -0,0 +1,2 @@
+-- Speeds up dedup lookup for clipped URLs (clipUrl looks up files by source_path).
+CREATE INDEX IF NOT EXISTS idx_files_source_path ON files(source_path);

package/bundle/standalone/node_modules/kxta-core/dist/db/migrations/004-journaling.sql

@@ -0,0 +1,44 @@
+-- Journaling & indexing — Phase 1 tables.
+-- See docs/superpowers/specs/2026-05-12-journaling-and-indexing-design.md §4.5
+
+CREATE TABLE IF NOT EXISTS journal_meta (
+  file_id        INTEGER PRIMARY KEY REFERENCES files(id) ON DELETE CASCADE,
+  project_id     INTEGER NOT NULL REFERENCES projects(id),
+  task_slug      TEXT NOT NULL,
+  status_latest  TEXT,
+  started_at     TEXT NOT NULL,
+  last_active_at TEXT NOT NULL,
+  touched_files  TEXT NOT NULL DEFAULT '[]',
+  raw_sources    TEXT NOT NULL DEFAULT '[]'
+);
+
+CREATE INDEX IF NOT EXISTS idx_journal_project_active
+  ON journal_meta(project_id, last_active_at DESC);
+CREATE INDEX IF NOT EXISTS idx_journal_project_status
+  ON journal_meta(project_id, status_latest);
+CREATE INDEX IF NOT EXISTS idx_journal_task_slug
+  ON journal_meta(project_id, task_slug);
+
+CREATE TABLE IF NOT EXISTS journal_touches (
+  file_id      INTEGER NOT NULL REFERENCES journal_meta(file_id) ON DELETE CASCADE,
+  touched_path TEXT NOT NULL,
+  PRIMARY KEY (file_id, touched_path)
+);
+CREATE INDEX IF NOT EXISTS idx_journal_touches_path ON journal_touches(touched_path);
+
+CREATE TABLE IF NOT EXISTS journal_git_refs (
+  file_id   INTEGER NOT NULL REFERENCES journal_meta(file_id) ON DELETE CASCADE,
+  ref_type  TEXT NOT NULL,
+  ref_value TEXT NOT NULL,
+  PRIMARY KEY (file_id, ref_type, ref_value)
+);
+CREATE INDEX IF NOT EXISTS idx_journal_git_value ON journal_git_refs(ref_type, ref_value);
+
+-- Per-project high-water mark for distillation. Single row per project_slug.
+-- Stored in DB (not just on disk) so SQL queries can report status without filesystem walk.
+CREATE TABLE IF NOT EXISTS journal_high_water (
+  project_slug      TEXT PRIMARY KEY,
+  last_event_ts     TEXT NOT NULL,
+  last_distilled_at TEXT NOT NULL,
+  events_processed  INTEGER NOT NULL DEFAULT 0
+);

package/bundle/standalone/node_modules/kxta-core/dist/db/migrations/005-auth.sql

@@ -0,0 +1,7 @@
+-- 005-auth.sql
+
+CREATE TABLE IF NOT EXISTS settings (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/bundle/standalone/node_modules/kxta-core/dist/db/migrations/006-journal-locks.sql

@@ -0,0 +1,11 @@
+-- 006-journal-locks.sql
+-- Cross-process advisory locks. Replaces the per-process file-based
+-- distill cooldown lock with a DB row that's atomic across processes via
+-- SQLite's WAL/transaction guarantees.
+
+CREATE TABLE IF NOT EXISTS journal_locks (
+  lock_key TEXT PRIMARY KEY,
+  token TEXT NOT NULL,
+  pid INTEGER NOT NULL,
+  acquired_at INTEGER NOT NULL  -- ms since epoch
+);

package/bundle/standalone/node_modules/kxta-core/dist/db/migrations/007-calendar.sql

@@ -0,0 +1,49 @@
+-- 007-calendar.sql
+-- Generic dependency-aware maintenance/downtime calendar.
+-- Entities are any named thing you schedule against (servers, vehicles,
+-- locations, equipment, rooms, etc.); links are directed dependency edges
+-- between them; events are one-off time windows on an entity. Conflict
+-- detection is computed on demand in application code — nothing about
+-- conflicts is persisted here.
+
+CREATE TABLE IF NOT EXISTS calendar_entities (
+  id         INTEGER PRIMARY KEY AUTOINCREMENT,
+  name       TEXT NOT NULL COLLATE NOCASE,
+  kind       TEXT,                -- freeform: 'server' | 'vehicle' | 'location' | ...
+  notes      TEXT,
+  timezone   TEXT,                -- optional IANA tz, display only
+  active     INTEGER NOT NULL DEFAULT 1,
+  created_at TEXT NOT NULL,       -- ISO 8601 UTC
+  updated_at TEXT NOT NULL        -- ISO 8601 UTC
+);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_calendar_entities_name
+  ON calendar_entities(name COLLATE NOCASE);
+
+CREATE TABLE IF NOT EXISTS calendar_links (
+  id             INTEGER PRIMARY KEY AUTOINCREMENT,
+  from_entity_id INTEGER NOT NULL REFERENCES calendar_entities(id) ON DELETE CASCADE,
+  to_entity_id   INTEGER NOT NULL REFERENCES calendar_entities(id) ON DELETE CASCADE,
+  label          TEXT,            -- freeform: 'feeds', 'depends on', ...
+  created_at     TEXT NOT NULL,   -- ISO 8601 UTC
+  UNIQUE (from_entity_id, to_entity_id),
+  CHECK (from_entity_id <> to_entity_id)
+);
+CREATE INDEX IF NOT EXISTS idx_calendar_links_to ON calendar_links(to_entity_id);
+
+CREATE TABLE IF NOT EXISTS calendar_events (
+  id                INTEGER PRIMARY KEY AUTOINCREMENT,
+  entity_id         INTEGER NOT NULL REFERENCES calendar_entities(id) ON DELETE CASCADE,
+  type              TEXT NOT NULL,       -- freeform: 'downtime' | 'maintenance' | 'delivery' | ...
+  title             TEXT NOT NULL,
+  notes             TEXT,
+  starts_at         TEXT NOT NULL,       -- ISO 8601 UTC
+  ends_at           TEXT NOT NULL,       -- ISO 8601 UTC, exclusive; > starts_at
+  original_timezone TEXT,                -- tz string the time was communicated in, display only
+  source            TEXT,                -- freeform provenance
+  created_at        TEXT NOT NULL,       -- ISO 8601 UTC
+  updated_at        TEXT NOT NULL,       -- ISO 8601 UTC
+  CHECK (ends_at > starts_at)
+);
+CREATE INDEX IF NOT EXISTS idx_calendar_events_entity_start ON calendar_events(entity_id, starts_at);
+CREATE INDEX IF NOT EXISTS idx_calendar_events_start ON calendar_events(starts_at);
+CREATE INDEX IF NOT EXISTS idx_calendar_events_end   ON calendar_events(ends_at);

package/bundle/standalone/node_modules/kxta-core/dist/files/index.d.ts

@@ -0,0 +1,84 @@
+import type { FileRecord, Destination, FileFilters } from "../types.js";
+/**
+ * List all folders in a project (recursively)
+ */
+export declare function listProjectFolders(projectPath: string): string[];
+/**
+ * List all folders in a project that contain at least one .md or .mmd file.
+ * Returns only non-empty folders (useful for publish UI).
+ */
+export declare function listProjectFoldersWithFiles(projectPath: string): string[];
+export interface CreateFileOptions {
+    title: string;
+    content: string;
+    destination: Destination;
+    projectId?: number;
+    folder?: string;
+    tags?: string[];
+    dataDir: string;
+    sourcePath?: string;
+    /** File extension to write. Defaults to "md". */
+    format?: "md" | "mmd";
+}
+export interface FileRecordWithContent extends FileRecord {
+    content: string;
+    git_warning?: string;
+}
+export interface ListFilesOptions {
+    dataDir: string;
+    filters?: FileFilters;
+}
+/**
+ * Compute SHA-256 hash of content
+ */
+export declare function computeHash(content: string): string;
+/**
+ * Convert name to slug (lowercase, alphanumeric with dashes)
+ */
+export declare function slugify(name: string): string;
+/**
+ * Create a new file
+ */
+export declare function createFile(opts: CreateFileOptions): Promise<FileRecordWithContent>;
+/**
+ * Read a file by ID
+ */
+export declare function readFile(id: number): FileRecordWithContent;
+/**
+ * Update file content
+ */
+export declare function updateFile(id: number, content: string, dataDir: string): Promise<FileRecordWithContent>;
+/**
+ * Delete a file. Always removes the DB row; only unlinks from disk when
+ * the file is inside `<dataDir>/knowledge/` (project files are never
+ * physically deleted — we only un-index).
+ *
+ * Now also commits the deletion to git so the deleted file doesn't get
+ * resurrected by a later `git pull` / restore / stash pop, which then
+ * triggers the watcher to re-index it with a fresh row id (making it look
+ * like delete silently came back).
+ */
+export declare function deleteFile(id: number, dataDir?: string): Promise<void>;
+/**
+ * Create a new folder in a project
+ */
+export declare function createFolder(projectPath: string, folderName: string): string;
+/**
+ * Delete a folder (recursive)
+ */
+export declare function deleteFolder(projectPath: string, folderName: string): void;
+/**
+ * List files with optional filters
+ */
+export declare function listFiles(opts: ListFilesOptions): FileRecord[];
+/**
+ * Move a file to a new path.
+ *
+ * `newPath` must resolve INSIDE the file's owning project (or under
+ * `knowledge/` for KB files). Without this guard a caller could move a file
+ * over arbitrary paths the server process can write — the MCP layer enforced
+ * this externally, but the core library API is shared with the web app and
+ * future tools that may forget.
+ */
+export declare function moveFile(id: number, newPath: string, dataDir?: string): FileRecord;
+//# sourceMappingURL=index.d.ts.map

package/bundle/standalone/node_modules/kxta-core/dist/files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/files/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAErF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAgChE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CA6CzE;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,MAAM,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;CACvB;AAED,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA6KxF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,CAc1D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAuE7G;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqD5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAI5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAG1E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,UAAU,EAAE,CA2E9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAuFlF"}