@jstn-sdk/rcs 0.1.0

package/dist/wiki/ingest.js

@@ -0,0 +1,115 @@
+/**
+ * Wiki Ingest
+ *
+ * Processes knowledge into wiki pages. A single ingest can create a new page
+ * or merge into an existing one (append strategy — never replaces content).
+ */
+import { WIKI_SCHEMA_VERSION, } from './types.js';
+import { withWikiLock, readPage, writePageUnsafe, updateIndexUnsafe, appendLogUnsafe, titleToSlug, } from './storage.js';
+/**
+ * Ingest knowledge into the wiki.
+ *
+ * If a page with the same slug exists, merges content (append strategy):
+ * - Frontmatter: union tags, append sources, update timestamp, keep higher confidence
+ * - Content: append new content as a timestamped section (never replace)
+ *
+ * @param root - Project root directory
+ * @param input - Knowledge to ingest
+ * @returns Result with created/updated page lists
+ */
+export function ingestKnowledge(root, input) {
+    const slug = titleToSlug(input.title);
+    const now = new Date().toISOString();
+    const result = { created: [], updated: [], totalAffected: 0 };
+    withWikiLock(root, () => {
+        const existing = readPage(root, slug);
+        if (existing) {
+            // Merge into existing page
+            const merged = mergePage(existing, input, now);
+            writePageUnsafe(root, merged);
+            result.updated.push(slug);
+        }
+        else {
+            // Create new page
+            const page = createPage(slug, input, now);
+            writePageUnsafe(root, page);
+            result.created.push(slug);
+        }
+        updateIndexUnsafe(root);
+        appendLogUnsafe(root, {
+            timestamp: now,
+            operation: 'ingest',
+            pagesAffected: [...result.created, ...result.updated],
+            summary: existing
+                ? `Updated "${input.title}" with new content`
+                : `Created new page "${input.title}"`,
+        });
+    });
+    result.totalAffected = result.created.length + result.updated.length;
+    return result;
+}
+/** Create a new wiki page from ingest input. */
+function createPage(slug, input, now) {
+    const frontmatter = {
+        title: input.title,
+        tags: [...new Set(input.tags)],
+        created: now,
+        updated: now,
+        sources: input.sources || [],
+        links: extractWikiLinks(input.content),
+        category: input.category,
+        confidence: input.confidence || 'medium',
+        schemaVersion: WIKI_SCHEMA_VERSION,
+    };
+    return {
+        filename: slug,
+        frontmatter,
+        content: `\n# ${input.title}\n\n${input.content}\n`,
+    };
+}
+/**
+ * Merge new content into an existing page (append strategy).
+ * - Tags: union of existing + new
+ * - Sources: append new sources
+ * - Confidence: keep higher level
+ * - Content: append as new timestamped section
+ */
+function mergePage(existing, input, now) {
+    const mergedTags = [...new Set([...existing.frontmatter.tags, ...input.tags])];
+    const mergedSources = [...new Set([...existing.frontmatter.sources, ...(input.sources || [])])];
+    const mergedLinks = [...new Set([
+            ...existing.frontmatter.links,
+            ...extractWikiLinks(input.content),
+        ])];
+    const confidenceRank = { high: 3, medium: 2, low: 1 };
+    const existingRank = confidenceRank[existing.frontmatter.confidence] || 2;
+    const newRank = confidenceRank[input.confidence || 'medium'] || 2;
+    const mergedConfidence = newRank >= existingRank
+        ? (input.confidence || 'medium')
+        : existing.frontmatter.confidence;
+    const appendedContent = existing.content.trimEnd() +
+        `\n\n---\n\n## Update (${now})\n\n${input.content}\n`;
+    return {
+        filename: existing.filename,
+        frontmatter: {
+            ...existing.frontmatter,
+            tags: mergedTags,
+            updated: now,
+            sources: mergedSources,
+            links: mergedLinks,
+            confidence: mergedConfidence,
+        },
+        content: appendedContent,
+    };
+}
+/** Extract [[wiki-link]] references from content. */
+function extractWikiLinks(content) {
+    const matches = content.match(/\[\[([^\]]+)\]\]/g);
+    if (!matches)
+        return [];
+    return [...new Set(matches.map(m => {
+            const name = m.slice(2, -2).trim();
+            return titleToSlug(name);
+        }))];
+}
+//# sourceMappingURL=ingest.js.map

package/dist/wiki/ingest.js.map

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

package/dist/wiki/lifecycle.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Wiki lifecycle integration.
+ */
+export declare function onSessionStart(data: {
+    cwd?: string;
+}): {
+    additionalContext?: string;
+};
+export declare function onSessionEnd(data: {
+    cwd?: string;
+    session_id?: string;
+}): {
+    continue: boolean;
+};
+export declare function onPreCompact(data: {
+    cwd?: string;
+}): {
+    additionalContext?: string;
+};
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/wiki/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/wiki/lifecycle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoCH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CAqCrF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAsD/F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CAsBnF"}

package/dist/wiki/lifecycle.js

@@ -0,0 +1,212 @@
+/**
+ * Wiki lifecycle integration.
+ */
+import { existsSync, readFileSync, statSync } from 'fs';
+import { join } from 'path';
+import { codexHome, rcsProjectMemoryPath } from '../utils/paths.js';
+import { appendLogUnsafe, getWikiDir, listPages, readAllPages, readIndex, readPage, updateIndexUnsafe, withWikiLock, writePageUnsafe, } from './storage.js';
+import { DEFAULT_WIKI_CONFIG, WIKI_SCHEMA_VERSION } from './types.js';
+function loadWikiConfig(root) {
+    const candidates = [join(root, '.rcs-config.json'), join(codexHome(), '.rcs-config.json')];
+    for (const path of candidates) {
+        try {
+            if (!existsSync(path))
+                continue;
+            const parsed = JSON.parse(readFileSync(path, 'utf8'));
+            if (parsed?.wiki && typeof parsed.wiki === 'object') {
+                return { ...DEFAULT_WIKI_CONFIG, ...parsed.wiki };
+            }
+        }
+        catch {
+            // ignore malformed config and continue to defaults
+        }
+    }
+    return DEFAULT_WIKI_CONFIG;
+}
+export function onSessionStart(data) {
+    try {
+        const root = data.cwd || process.cwd();
+        const config = loadWikiConfig(root);
+        if (!config.enabled)
+            return {};
+        const wikiDir = getWikiDir(root);
+        if (!existsSync(wikiDir))
+            return {};
+        const pages = listPages(root);
+        if (pages.length === 0)
+            return {};
+        if (!readIndex(root)) {
+            withWikiLock(root, () => {
+                updateIndexUnsafe(root);
+            });
+        }
+        if (config.feedProjectMemoryOnStart) {
+            feedProjectMemory(root);
+        }
+        const index = readIndex(root);
+        if (!index)
+            return {};
+        const summary = [
+            `[RCS Wiki: ${pages.length} pages at .rcs/wiki/]`,
+            '',
+            'Use wiki_query to search, wiki_list to browse, wiki_read to inspect pages.',
+            '',
+            ...index.split('\n').slice(0, config.maxContextLines),
+        ].join('\n');
+        return { additionalContext: summary };
+    }
+    catch {
+        return {};
+    }
+}
+export function onSessionEnd(data) {
+    const startedAt = Date.now();
+    const timeoutMs = 3_000;
+    try {
+        const root = data.cwd || process.cwd();
+        const config = loadWikiConfig(root);
+        if (!config.enabled || !config.autoCapture) {
+            return { continue: true };
+        }
+        const wikiDir = getWikiDir(root);
+        if (!existsSync(wikiDir)) {
+            return { continue: true };
+        }
+        const sessionId = data.session_id || `session-${Date.now()}`;
+        const now = new Date().toISOString();
+        const dateSlug = now.split('T')[0];
+        const filename = `session-log-${dateSlug}-${sessionId.slice(-8)}.md`;
+        withWikiLock(root, () => {
+            if (Date.now() - startedAt > timeoutMs)
+                return;
+            writePageUnsafe(root, {
+                filename,
+                frontmatter: {
+                    title: `Session Log ${dateSlug}`,
+                    tags: ['session-log', 'auto-captured'],
+                    created: now,
+                    updated: now,
+                    sources: [sessionId],
+                    links: [],
+                    category: 'session-log',
+                    confidence: 'medium',
+                    schemaVersion: WIKI_SCHEMA_VERSION,
+                },
+                content: `\n# Session Log ${dateSlug}\n\nAuto-captured session metadata.\nSession ID: ${sessionId}\n\nReview and promote significant findings to curated wiki pages via \`wiki_ingest\`.\n`,
+            });
+            appendLogUnsafe(root, {
+                timestamp: now,
+                operation: 'session-end',
+                pagesAffected: [filename],
+                summary: `Auto-captured session log for ${sessionId}`,
+            });
+            updateIndexUnsafe(root);
+        });
+    }
+    catch {
+        // best effort only
+    }
+    return { continue: true };
+}
+export function onPreCompact(data) {
+    try {
+        const root = data.cwd || process.cwd();
+        const config = loadWikiConfig(root);
+        if (!config.enabled)
+            return {};
+        const pages = listPages(root);
+        if (pages.length === 0)
+            return {};
+        const allPages = readAllPages(root);
+        const categories = [...new Set(allPages.map((page) => page.frontmatter.category))];
+        const latestUpdate = allPages
+            .map((page) => page.frontmatter.updated)
+            .sort()
+            .reverse()[0] || 'unknown';
+        return {
+            additionalContext: `[Wiki: ${pages.length} pages | categories: ${categories.join(', ')} | last updated: ${latestUpdate}]`,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+function feedProjectMemory(root) {
+    try {
+        const projectMemoryPath = rcsProjectMemoryPath(root);
+        if (!existsSync(projectMemoryPath))
+            return;
+        const parsed = JSON.parse(readFileSync(projectMemoryPath, 'utf8'));
+        const existing = readPage(root, 'environment.md');
+        const memoryMtime = statSync(projectMemoryPath).mtimeMs;
+        const existingUpdated = existing ? new Date(existing.frontmatter.updated).getTime() : 0;
+        if (existing && existingUpdated >= memoryMtime) {
+            return;
+        }
+        const sections = ['\n# Project Environment\n'];
+        const stringFields = [
+            ['Tech Stack', parsed.techStack],
+            ['Build', parsed.build],
+            ['Conventions', parsed.conventions],
+            ['Structure', parsed.structure],
+        ];
+        for (const [label, value] of stringFields) {
+            if (typeof value === 'string' && value.trim() !== '') {
+                sections.push(`## ${label}`);
+                sections.push(value.trim());
+                sections.push('');
+            }
+        }
+        if (Array.isArray(parsed.notes) && parsed.notes.length > 0) {
+            sections.push('## Notes');
+            for (const note of parsed.notes.slice(0, 20)) {
+                const content = typeof note.content === 'string'
+                    ? note.content.trim()
+                    : '';
+                if (content)
+                    sections.push(`- ${content}`);
+            }
+            sections.push('');
+        }
+        if (Array.isArray(parsed.directives) && parsed.directives.length > 0) {
+            sections.push('## Directives');
+            for (const directive of parsed.directives.slice(0, 20)) {
+                const content = typeof directive.directive === 'string'
+                    ? directive.directive.trim()
+                    : '';
+                if (content)
+                    sections.push(`- ${content}`);
+            }
+            sections.push('');
+        }
+        const now = new Date().toISOString();
+        withWikiLock(root, () => {
+            writePageUnsafe(root, {
+                filename: 'environment.md',
+                frontmatter: {
+                    title: 'Project Environment',
+                    tags: ['environment', 'auto-detected'],
+                    created: existing?.frontmatter.created || now,
+                    updated: now,
+                    sources: ['project-memory-auto-detect'],
+                    links: [],
+                    category: 'environment',
+                    confidence: 'high',
+                    schemaVersion: WIKI_SCHEMA_VERSION,
+                },
+                content: sections.join('\n'),
+            }, { allowReserved: true });
+            updateIndexUnsafe(root);
+            appendLogUnsafe(root, {
+                timestamp: now,
+                operation: 'session-start',
+                pagesAffected: ['environment.md'],
+                summary: 'Synced project memory into managed environment page',
+            });
+        });
+    }
+    catch {
+        // best effort only
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/wiki/lifecycle.js.map

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

package/dist/wiki/lint.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Wiki Lint
+ *
+ * Health checks for the wiki knowledge base.
+ * Detects orphan pages, stale content, broken cross-references,
+ * oversized pages, and structural contradictions.
+ */
+import { type WikiLintReport, type WikiConfig } from './types.js';
+/**
+ * Run health checks on the wiki.
+ *
+ * Checks performed:
+ * 1. Orphan pages — no incoming [[links]] from other pages
+ * 2. Stale pages — not updated in `staleDays` days
+ * 3. Broken cross-references — [[links]] to non-existent pages
+ * 4. Low confidence — pages marked as `confidence: low`
+ * 5. Oversized — content exceeds `maxPageSize` bytes
+ * 6. Structural contradictions — same topic with conflicting confidence/category
+ *
+ * @param root - Project root directory
+ * @param config - Wiki configuration (uses defaults if not provided)
+ * @returns Lint report with issues and stats
+ */
+export declare function lintWiki(root: string, config?: WikiConfig): WikiLintReport;
+//# sourceMappingURL=lint.d.ts.map

package/dist/wiki/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/wiki/lint.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,cAAc,EAGnB,KAAK,UAAU,EAEhB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,UAAgC,GAAG,cAAc,CAkG/F"}

package/dist/wiki/lint.js

@@ -0,0 +1,166 @@
+/**
+ * Wiki Lint
+ *
+ * Health checks for the wiki knowledge base.
+ * Detects orphan pages, stale content, broken cross-references,
+ * oversized pages, and structural contradictions.
+ */
+import { DEFAULT_WIKI_CONFIG, } from './types.js';
+import { readAllPages, appendLog, } from './storage.js';
+/**
+ * Run health checks on the wiki.
+ *
+ * Checks performed:
+ * 1. Orphan pages — no incoming [[links]] from other pages
+ * 2. Stale pages — not updated in `staleDays` days
+ * 3. Broken cross-references — [[links]] to non-existent pages
+ * 4. Low confidence — pages marked as `confidence: low`
+ * 5. Oversized — content exceeds `maxPageSize` bytes
+ * 6. Structural contradictions — same topic with conflicting confidence/category
+ *
+ * @param root - Project root directory
+ * @param config - Wiki configuration (uses defaults if not provided)
+ * @returns Lint report with issues and stats
+ */
+export function lintWiki(root, config = DEFAULT_WIKI_CONFIG) {
+    const pages = readAllPages(root);
+    const issues = [];
+    const pageFilenames = new Set(pages.map(p => p.filename));
+    // Build incoming link map
+    const incomingLinks = new Map();
+    for (const page of pages) {
+        for (const link of page.frontmatter.links) {
+            if (!incomingLinks.has(link))
+                incomingLinks.set(link, new Set());
+            incomingLinks.get(link).add(page.filename);
+        }
+    }
+    const now = Date.now();
+    const staleThresholdMs = config.staleDays * 24 * 60 * 60 * 1000;
+    for (const page of pages) {
+        // 1. Orphan detection — no incoming links from other pages
+        if (!incomingLinks.has(page.filename) || incomingLinks.get(page.filename).size === 0) {
+            issues.push({
+                page: page.filename,
+                severity: 'info',
+                type: 'orphan',
+                message: `No other pages link to "${page.frontmatter.title}"`,
+            });
+        }
+        // 2. Stale detection — not updated recently
+        const updatedAt = new Date(page.frontmatter.updated).getTime();
+        if (now - updatedAt > staleThresholdMs) {
+            const daysSince = Math.floor((now - updatedAt) / (24 * 60 * 60 * 1000));
+            issues.push({
+                page: page.filename,
+                severity: 'warning',
+                type: 'stale',
+                message: `"${page.frontmatter.title}" not updated in ${daysSince} days`,
+            });
+        }
+        // 3. Broken cross-references — links to non-existent pages
+        for (const link of page.frontmatter.links) {
+            if (!pageFilenames.has(link)) {
+                issues.push({
+                    page: page.filename,
+                    severity: 'error',
+                    type: 'broken-ref',
+                    message: `Broken link to "${link}" from "${page.frontmatter.title}"`,
+                });
+            }
+        }
+        // 4. Low confidence
+        if (page.frontmatter.confidence === 'low') {
+            issues.push({
+                page: page.filename,
+                severity: 'info',
+                type: 'low-confidence',
+                message: `"${page.frontmatter.title}" has low confidence — consider verifying or removing`,
+            });
+        }
+        // 5. Oversized pages
+        const contentSize = Buffer.byteLength(page.content, 'utf-8');
+        if (contentSize > config.maxPageSize) {
+            const sizeKB = (contentSize / 1024).toFixed(1);
+            issues.push({
+                page: page.filename,
+                severity: 'warning',
+                type: 'oversized',
+                message: `"${page.frontmatter.title}" is ${sizeKB}KB — consider splitting into smaller pages`,
+            });
+        }
+    }
+    // 6. Structural contradictions — same slug prefix with conflicting metadata
+    detectStructuralContradictions(pages, issues);
+    // Build stats
+    const stats = {
+        totalPages: pages.length,
+        orphanCount: issues.filter(i => i.type === 'orphan').length,
+        staleCount: issues.filter(i => i.type === 'stale').length,
+        brokenRefCount: issues.filter(i => i.type === 'broken-ref').length,
+        lowConfidenceCount: issues.filter(i => i.type === 'low-confidence').length,
+        oversizedCount: issues.filter(i => i.type === 'oversized').length,
+        contradictionCount: issues.filter(i => i.type === 'structural-contradiction').length,
+    };
+    // Log the lint operation
+    appendLog(root, {
+        timestamp: new Date().toISOString(),
+        operation: 'lint',
+        pagesAffected: [...new Set(issues.map(i => i.page))],
+        summary: `Lint: ${issues.length} issues (${stats.orphanCount} orphan, ${stats.staleCount} stale, ${stats.brokenRefCount} broken, ${stats.contradictionCount} contradictions)`,
+    });
+    return { issues, stats };
+}
+/**
+ * Detect structural contradictions:
+ * - Pages with overlapping tags but different categories
+ * - Pages with same slug prefix but different confidence levels
+ *
+ * NOTE: Semantic contradiction detection requires LLM integration (v2).
+ */
+function detectStructuralContradictions(pages, issues) {
+    // Group by slug prefix (first segment before first hyphen-separated word boundary)
+    const slugGroups = new Map();
+    for (const page of pages) {
+        const prefix = page.filename.split('-').slice(0, 2).join('-');
+        if (!slugGroups.has(prefix))
+            slugGroups.set(prefix, []);
+        slugGroups.get(prefix).push(page);
+    }
+    for (const [_prefix, group] of slugGroups) {
+        if (group.length < 2)
+            continue;
+        // Check for conflicting confidence on same topic
+        const confidences = new Set(group.map(p => p.frontmatter.confidence));
+        if (confidences.size > 1 && confidences.has('high') && confidences.has('low')) {
+            const titles = group.map(p => `"${p.frontmatter.title}"`).join(', ');
+            issues.push({
+                page: group[0].filename,
+                severity: 'warning',
+                type: 'structural-contradiction',
+                message: `Conflicting confidence levels for related pages: ${titles}`,
+            });
+        }
+        // Check for overlapping tags with different categories
+        const tagCategoryPairs = new Map();
+        for (const page of group) {
+            for (const tag of page.frontmatter.tags) {
+                if (!tagCategoryPairs.has(tag))
+                    tagCategoryPairs.set(tag, new Set());
+                tagCategoryPairs.get(tag).add(page.frontmatter.category);
+            }
+        }
+        for (const [tag, categories] of tagCategoryPairs) {
+            if (categories.size > 1) {
+                issues.push({
+                    page: group[0].filename,
+                    severity: 'info',
+                    type: 'structural-contradiction',
+                    message: `Tag "${tag}" appears in pages with different categories: ${[...categories].join(', ')}`,
+                });
+                break; // One contradiction per group is enough
+            }
+        }
+    }
+}
+//# sourceMappingURL=lint.js.map

package/dist/wiki/lint.js.map

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

package/dist/wiki/query.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Wiki Query
+ *
+ * Keyword + tag search across all wiki pages.
+ * Returns matching pages with relevance snippets.
+ *
+ * NO vector embeddings — search is keyword-based only (hard constraint).
+ * The LLM caller synthesizes answers from returned matches.
+ */
+import { type WikiQueryOptions, type WikiQueryMatch } from './types.js';
+/**
+ * Tokenize text for search, with CJK bi-gram support.
+ *
+ * Latin/numeric words: split on whitespace.
+ * CJK characters (Han, Hangul, Kana): bi-grams (2-char sliding window)
+ * plus individual characters for single-char query support.
+ * Other scripts (Cyrillic, Arabic, Thai, etc.): whitespace split (fallback).
+ */
+export declare function tokenize(text: string): string[];
+/**
+ * Search wiki pages by keyword and/or tags.
+ *
+ * Matching strategy:
+ * 1. Tag match: pages whose tags intersect with query tags (highest weight)
+ * 2. Title match: pages whose title contains the query text
+ * 3. Content match: pages whose content contains the query text
+ *
+ * Results are scored and sorted by relevance (descending).
+ *
+ * @param root - Project root directory
+ * @param queryText - Search text (matched against title + content)
+ * @param options - Optional filters (tags, category, limit)
+ * @returns Matching pages with snippets, sorted by relevance
+ */
+export declare function queryWiki(root: string, queryText: string, options?: WikiQueryOptions): WikiQueryMatch[];
+//# sourceMappingURL=query.d.ts.map

package/dist/wiki/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/wiki/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAMpB;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiC/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,gBAAqB,GAC7B,cAAc,EAAE,CAiFlB"}