oh-my-codex 0.12.4 → 0.12.6

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, omxProjectMemoryPath } 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, '.omx-config.json'), join(codexHome(), '.omx-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 = [
+            `[OMX Wiki: ${pages.length} pages at .omx/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 = omxProjectMemoryPath(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"}

package/dist/wiki/query.js

@@ -0,0 +1,138 @@
+/**
+ * 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 { readAllPages, appendLog, } from './storage.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 function tokenize(text) {
+    const lower = text.toLowerCase();
+    const tokens = [];
+    // Latin/numeric tokens (including accented Latin: café, naïve, etc.)
+    const latinMatches = lower.match(/[a-z0-9\u00C0-\u024F]+/g);
+    if (latinMatches)
+        tokens.push(...latinMatches);
+    // CJK segments (Hiragana + Katakana + CJK Unified Ideographs + Hangul)
+    const cjkPattern = /[\u3040-\u309F\u30A0-\u30FF\u4E00-\u9FFF\uAC00-\uD7AF]+/g;
+    const cjkMatches = lower.match(cjkPattern);
+    if (cjkMatches) {
+        for (const segment of cjkMatches) {
+            for (let i = 0; i < segment.length; i++) {
+                tokens.push(segment[i]);
+            }
+            for (let i = 0; i < segment.length - 1; i++) {
+                tokens.push(segment.slice(i, i + 2));
+            }
+        }
+    }
+    // Fallback: other scripts (Cyrillic, Arabic, Thai, Devanagari, etc.)
+    // Remove already-matched Latin and CJK, then whitespace-split the remainder
+    // Filter out pure-punctuation tokens to avoid false-positive matches.
+    const remaining = lower
+        .replace(/[a-z0-9\u00C0-\u024F]+/g, ' ')
+        .replace(cjkPattern, ' ')
+        .split(/\s+/)
+        .filter(t => t.length > 0 && /\p{L}/u.test(t));
+    if (remaining.length > 0)
+        tokens.push(...remaining);
+    return tokens;
+}
+/**
+ * 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 function queryWiki(root, queryText, options = {}) {
+    const { tags: filterTags, category, limit = 20, logQuery = true } = options;
+    const pages = readAllPages(root);
+    const queryLower = queryText.toLowerCase();
+    const queryTerms = tokenize(queryText);
+    const matches = [];
+    for (const page of pages) {
+        // Category filter
+        if (category && page.frontmatter.category !== category)
+            continue;
+        let score = 0;
+        let snippet = '';
+        // Tag matching (weight: 3 per matching tag)
+        if (filterTags && filterTags.length > 0) {
+            const tagOverlap = filterTags.filter(t => page.frontmatter.tags.some(pt => pt.toLowerCase() === t.toLowerCase()));
+            score += tagOverlap.length * 3;
+        }
+        // Also match query terms against page tags
+        for (const term of queryTerms) {
+            if (page.frontmatter.tags.some(t => t.toLowerCase().includes(term))) {
+                score += 2;
+            }
+        }
+        // Title matching (weight: 5)
+        const titleLower = page.frontmatter.title.toLowerCase();
+        if (titleLower.includes(queryLower)) {
+            score += 5;
+        }
+        else {
+            for (const term of queryTerms) {
+                if (titleLower.includes(term))
+                    score += 2;
+            }
+        }
+        // Content matching (weight: 1 per unique term match)
+        const contentLower = page.content.toLowerCase();
+        for (const term of queryTerms) {
+            const idx = contentLower.indexOf(term);
+            if (idx !== -1) {
+                score += 1;
+                // Extract snippet around first match
+                if (!snippet) {
+                    const start = Math.max(0, idx - 40);
+                    const end = Math.min(contentLower.length, idx + term.length + 80);
+                    const raw = page.content.slice(start, end).replace(/\n+/g, ' ').trim();
+                    snippet = (start > 0 ? '...' : '') + raw + (end < contentLower.length ? '...' : '');
+                }
+            }
+        }
+        if (score > 0) {
+            if (!snippet) {
+                // Default snippet: first non-empty line
+                snippet = page.content.split('\n').find(l => l.trim().length > 0)?.trim() || '';
+                if (snippet.length > 120)
+                    snippet = snippet.slice(0, 117) + '...';
+            }
+            matches.push({ page, snippet, score });
+        }
+    }
+    // Sort by score descending
+    matches.sort((a, b) => b.score - a.score);
+    const limited = matches.slice(0, limit);
+    if (logQuery) {
+        appendLog(root, {
+            timestamp: new Date().toISOString(),
+            operation: 'query',
+            pagesAffected: limited.map(m => m.page.filename),
+            summary: `Query "${queryText}" → ${limited.length} results (of ${matches.length} total)`,
+        });
+    }
+    return limited;
+}
+//# sourceMappingURL=query.js.map

package/dist/wiki/query.js.map

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