oh-my-codex 0.12.5 → 0.12.6

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":"AAAA;;;;;;GAMG;AAEH,OAAO,EAKL,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,YAAY,EACZ,SAAS,GACV,MAAM,cAAc,CAAC;AAEtB;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAqB,mBAAmB;IAC7E,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1D,0BAA0B;IAC1B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YAC1C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACjE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,gBAAgB,GAAG,MAAM,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEhE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,2DAA2D;QAC3D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACtF,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,QAAQ;gBACnB,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,2BAA2B,IAAI,CAAC,WAAW,CAAC,KAAK,GAAG;aAC9D,CAAC,CAAC;QACL,CAAC;QAED,4CAA4C;QAC5C,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/D,IAAI,GAAG,GAAG,SAAS,GAAG,gBAAgB,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;YACxE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,QAAQ;gBACnB,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,oBAAoB,SAAS,OAAO;aACxE,CAAC,CAAC;QACL,CAAC;QAED,2DAA2D;QAC3D,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YAC1C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,IAAI,CAAC,QAAQ;oBACnB,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,mBAAmB,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,KAAK,GAAG;iBACrE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,QAAQ;gBACnB,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,uDAAuD;aAC3F,CAAC,CAAC;QACL,CAAC;QAED,qBAAqB;QACrB,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7D,IAAI,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,QAAQ;gBACnB,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ,MAAM,4CAA4C;aAC9F,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,8BAA8B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE9C,cAAc;IACd,MAAM,KAAK,GAAG;QACZ,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM;QAC3D,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM;QACzD,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,MAAM;QAClE,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,MAAM;QAC1E,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,MAAM;QACjE,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,0BAA0B,CAAC,CAAC,MAAM;KACrF,CAAC;IAEF,yBAAyB;IACzB,SAAS,CAAC,IAAI,EAAE;QACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,MAAM;QACjB,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,WAAW,YAAY,KAAK,CAAC,UAAU,WAAW,KAAK,CAAC,cAAc,YAAY,KAAK,CAAC,kBAAkB,kBAAkB;KAC9K,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,SAAS,8BAA8B,CAAC,KAAiB,EAAE,MAAuB;IAChF,mFAAmF;IACnF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACxD,UAAU,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAE/B,iDAAiD;QACjD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;QACtE,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9E,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ;gBACvB,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,0BAA0B;gBAChC,OAAO,EAAE,oDAAoD,MAAM,EAAE;aACtE,CAAC,CAAC;QACL,CAAC;QAED,uDAAuD;QACvD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuB,CAAC;QACxD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;gBACxC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;gBACrE,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,gBAAgB,EAAE,CAAC;YACjD,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ;oBACvB,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,0BAA0B;oBAChC,OAAO,EAAE,QAAQ,GAAG,iDAAiD,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAClG,CAAC,CAAC;gBACH,MAAM,CAAC,wCAAwC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

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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"}

package/dist/wiki/storage.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Wiki Storage
+ *
+ * File I/O layer for the OMX wiki knowledge base.
+ */
+import { type WikiLogEntry, type WikiPage, type WikiPageFrontmatter } from './types.js';
+export declare function getWikiDir(root: string): string;
+export declare function ensureWikiDir(root: string): string;
+export declare function withWikiLock<T>(root: string, fn: () => T): T;
+export declare function parseFrontmatter(raw: string): {
+    frontmatter: WikiPageFrontmatter;
+    content: string;
+} | null;
+export declare function serializePage(page: WikiPage): string;
+export declare function readPage(root: string, filename: string): WikiPage | null;
+export declare function listPages(root: string): string[];
+export declare function readAllPages(root: string): WikiPage[];
+export declare function readIndex(root: string): string | null;
+export declare function readLog(root: string): string | null;
+export declare function writePageUnsafe(root: string, page: WikiPage, options?: {
+    allowReserved?: boolean;
+}): void;
+export declare function deletePageUnsafe(root: string, filename: string): boolean;
+export declare function updateIndexUnsafe(root: string): void;
+export declare function appendLogUnsafe(root: string, entry: WikiLogEntry): void;
+export declare function writePage(root: string, page: WikiPage, options?: {
+    allowReserved?: boolean;
+}): void;
+export declare function deletePage(root: string, filename: string): boolean;
+export declare function appendLog(root: string, entry: WikiLogEntry): void;
+export declare function titleToSlug(title: string): string;
+export declare function normalizeWikiPageName(page: string): string;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/wiki/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EAEzB,MAAM,YAAY,CAAC;AAoDpB,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAelD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAM5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA2B1G;AAqDD,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAepD;AAeD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAgBxE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMhD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAIrD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,IAAI,CAQ7G;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CASxE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA6BpD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAQvE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,IAAI,CAKvG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMlE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAIjE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBjD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D"}