@jstn-sdk/rcs 0.1.0

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":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EACL,YAAY,EACZ,SAAS,GACV,MAAM,cAAc,CAAC;AAEtB;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,qEAAqE;IACrE,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5D,IAAI,YAAY;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;IAE/C,uEAAuE;IACvE,MAAM,UAAU,GAAG,0DAA0D,CAAC;IAC9E,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;YACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,4EAA4E;IAC5E,sEAAsE;IACtE,MAAM,SAAS,GAAG,KAAK;SACpB,OAAO,CAAC,yBAAyB,EAAE,GAAG,CAAC;SACvC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAEpD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,SAAiB,EACjB,UAA4B,EAAE;IAE9B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC5E,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEvC,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,kBAAkB;QAClB,IAAI,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,KAAK,QAAQ;YAAE,SAAS;QAEjE,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,OAAO,GAAG,EAAE,CAAC;QAEjB,4CAA4C;QAC5C,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACvC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CACvE,CAAC;YACF,KAAK,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACjC,CAAC;QAED,2CAA2C;QAC3C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACpE,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACxD,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,KAAK,IAAI,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,KAAK,IAAI,CAAC,CAAC;gBACX,qCAAqC;gBACrC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;oBACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;oBAClE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;oBACvE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,wCAAwC;gBACxC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAChF,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;oBAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;YACpE,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAExC,IAAI,QAAQ,EAAE,CAAC;QACb,SAAS,CAAC,IAAI,EAAE;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,OAAO;YAClB,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;YAChD,OAAO,EAAE,UAAU,SAAS,OAAO,OAAO,CAAC,MAAM,gBAAgB,OAAO,CAAC,MAAM,SAAS;SACzF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/wiki/storage.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Wiki Storage
+ *
+ * File I/O layer for the RCS 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,CAiBjD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/wiki/storage.js

@@ -0,0 +1,322 @@
+/**
+ * Wiki Storage
+ *
+ * File I/O layer for the RCS wiki knowledge base.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, unlinkSync, writeFileSync, } from 'fs';
+import { dirname, join, resolve, sep } from 'path';
+import { rcsWikiDir } from '../utils/paths.js';
+import { WIKI_SCHEMA_VERSION, } from './types.js';
+const INDEX_FILE = 'index.md';
+const LOG_FILE = 'log.md';
+const ENVIRONMENT_FILE = 'environment.md';
+const RESERVED_FILES = new Set([INDEX_FILE, LOG_FILE, ENVIRONMENT_FILE]);
+function atomicWriteFileSync(path, content) {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmpPath = `${path}.${process.pid}.${Date.now()}.tmp`;
+    writeFileSync(tmpPath, content, 'utf8');
+    renameSync(tmpPath, path);
+}
+function lockPathFor(path) {
+    return `${path}.lock`;
+}
+function sleepSync(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function withFileLockSync(lockPath, fn, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    const retryDelayMs = options.retryDelayMs ?? 50;
+    const deadline = Date.now() + timeoutMs;
+    while (true) {
+        try {
+            mkdirSync(lockPath, { recursive: false });
+            break;
+        }
+        catch (error) {
+            const code = error.code;
+            if (code !== 'EEXIST')
+                throw error;
+            if (Date.now() >= deadline) {
+                throw new Error(`Timed out acquiring wiki lock at ${lockPath}`);
+            }
+            sleepSync(retryDelayMs);
+        }
+    }
+    try {
+        return fn();
+    }
+    finally {
+        rmSync(lockPath, { recursive: true, force: true });
+    }
+}
+export function getWikiDir(root) {
+    return rcsWikiDir(root);
+}
+export function ensureWikiDir(root) {
+    const wikiDir = getWikiDir(root);
+    mkdirSync(wikiDir, { recursive: true });
+    const rcsRoot = join(root, '.rcs');
+    mkdirSync(rcsRoot, { recursive: true });
+    const gitignorePath = join(rcsRoot, '.gitignore');
+    if (existsSync(gitignorePath)) {
+        const content = readFileSync(gitignorePath, 'utf8');
+        if (!content.includes('wiki/')) {
+            atomicWriteFileSync(gitignorePath, `${content.trimEnd()}\nwiki/\n`);
+        }
+    }
+    else {
+        atomicWriteFileSync(gitignorePath, 'wiki/\n');
+    }
+    return wikiDir;
+}
+export function withWikiLock(root, fn) {
+    const wikiDir = ensureWikiDir(root);
+    return withFileLockSync(lockPathFor(join(wikiDir, '.wiki-lock')), fn, {
+        timeoutMs: 5_000,
+        retryDelayMs: 50,
+    });
+}
+export function parseFrontmatter(raw) {
+    const normalized = raw.replace(/\r\n/g, '\n');
+    const match = normalized.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match)
+        return null;
+    const yamlBlock = match[1];
+    const content = match[2];
+    try {
+        const fm = parseSimpleYaml(yamlBlock);
+        return {
+            frontmatter: {
+                title: String(fm.title || ''),
+                tags: parseYamlArray(fm.tags),
+                created: String(fm.created || new Date().toISOString()),
+                updated: String(fm.updated || new Date().toISOString()),
+                sources: parseYamlArray(fm.sources),
+                links: parseYamlArray(fm.links),
+                category: (fm.category || 'reference'),
+                confidence: (fm.confidence || 'medium'),
+                schemaVersion: Number(fm.schemaVersion) || WIKI_SCHEMA_VERSION,
+            },
+            content,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function parseSimpleYaml(yaml) {
+    const result = {};
+    for (const line of yaml.split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        let value = line.slice(colonIdx + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value
+                .slice(1, -1)
+                .replace(/\\(\\|"|n|r)/g, (_, ch) => {
+                if (ch === 'n')
+                    return '\n';
+                if (ch === 'r')
+                    return '\r';
+                return ch;
+            });
+        }
+        if (key)
+            result[key] = value;
+    }
+    return result;
+}
+function parseYamlArray(value) {
+    if (!value)
+        return [];
+    const trimmed = value.trim();
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        return trimmed
+            .slice(1, -1)
+            .split(',')
+            .map((entry) => entry
+            .trim()
+            .replace(/^["']|["']$/g, '')
+            .replace(/\\(\\|"|n|r)/g, (_, ch) => {
+            if (ch === 'n')
+                return '\n';
+            if (ch === 'r')
+                return '\r';
+            return ch;
+        }))
+            .filter(Boolean);
+    }
+    return trimmed ? [trimmed] : [];
+}
+function escapeYaml(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r');
+}
+export function serializePage(page) {
+    const fm = page.frontmatter;
+    const yaml = [
+        `title: "${escapeYaml(fm.title)}"`,
+        `tags: [${fm.tags.map((tag) => `"${escapeYaml(tag)}"`).join(', ')}]`,
+        `created: ${fm.created}`,
+        `updated: ${fm.updated}`,
+        `sources: [${fm.sources.map((source) => `"${escapeYaml(source)}"`).join(', ')}]`,
+        `links: [${fm.links.map((link) => `"${escapeYaml(link)}"`).join(', ')}]`,
+        `category: ${fm.category}`,
+        `confidence: ${fm.confidence}`,
+        `schemaVersion: ${fm.schemaVersion}`,
+    ].join('\n');
+    return `---\n${yaml}\n---\n${page.content}`;
+}
+function safeWikiPath(wikiDir, filename) {
+    if (filename.includes('/') || filename.includes('\\') || filename.includes('..')) {
+        return null;
+    }
+    const filePath = join(wikiDir, filename);
+    const resolved = resolve(filePath);
+    const resolvedWikiDir = resolve(wikiDir);
+    if (resolved !== resolvedWikiDir && !resolved.startsWith(`${resolvedWikiDir}${sep}`)) {
+        return null;
+    }
+    return filePath;
+}
+export function readPage(root, filename) {
+    const wikiDir = getWikiDir(root);
+    const filePath = safeWikiPath(wikiDir, filename);
+    if (!filePath || !existsSync(filePath))
+        return null;
+    try {
+        const parsed = parseFrontmatter(readFileSync(filePath, 'utf8'));
+        if (!parsed)
+            return null;
+        return {
+            filename,
+            frontmatter: parsed.frontmatter,
+            content: parsed.content,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function listPages(root) {
+    const wikiDir = getWikiDir(root);
+    if (!existsSync(wikiDir))
+        return [];
+    return readdirSync(wikiDir)
+        .filter((entry) => entry.endsWith('.md') && !RESERVED_FILES.has(entry))
+        .sort();
+}
+export function readAllPages(root) {
+    return listPages(root)
+        .map((filename) => readPage(root, filename))
+        .filter((page) => page !== null);
+}
+export function readIndex(root) {
+    const indexPath = join(getWikiDir(root), INDEX_FILE);
+    return existsSync(indexPath) ? readFileSync(indexPath, 'utf8') : null;
+}
+export function readLog(root) {
+    const logPath = join(getWikiDir(root), LOG_FILE);
+    return existsSync(logPath) ? readFileSync(logPath, 'utf8') : null;
+}
+export function writePageUnsafe(root, page, options = {}) {
+    if (!options.allowReserved && RESERVED_FILES.has(page.filename)) {
+        throw new Error(`Cannot write to reserved wiki file: ${page.filename}`);
+    }
+    const wikiDir = ensureWikiDir(root);
+    const filePath = safeWikiPath(wikiDir, page.filename);
+    if (!filePath)
+        throw new Error(`Invalid wiki page filename: ${page.filename}`);
+    atomicWriteFileSync(filePath, serializePage(page));
+}
+export function deletePageUnsafe(root, filename) {
+    if (RESERVED_FILES.has(filename)) {
+        return false;
+    }
+    const wikiDir = getWikiDir(root);
+    const filePath = safeWikiPath(wikiDir, filename);
+    if (!filePath || !existsSync(filePath))
+        return false;
+    unlinkSync(filePath);
+    return true;
+}
+export function updateIndexUnsafe(root) {
+    const pages = readAllPages(root);
+    const byCategory = new Map();
+    for (const page of pages) {
+        const category = page.frontmatter.category;
+        if (!byCategory.has(category))
+            byCategory.set(category, []);
+        byCategory.get(category)?.push(page);
+    }
+    const lines = [
+        '# Wiki Index',
+        '',
+        `> ${pages.length} pages | Last updated: ${new Date().toISOString()}`,
+        '',
+    ];
+    for (const category of [...byCategory.keys()].sort()) {
+        lines.push(`## ${category}`);
+        lines.push('');
+        for (const page of byCategory.get(category) ?? []) {
+            const summaryLine = page.content.split('\n').find((line) => line.trim().length > 0)?.trim() || '';
+            const summary = summaryLine.length > 80 ? `${summaryLine.slice(0, 77)}...` : summaryLine;
+            lines.push(`- [${page.frontmatter.title}](${page.filename}) — ${summary}`);
+        }
+        lines.push('');
+    }
+    atomicWriteFileSync(join(ensureWikiDir(root), INDEX_FILE), lines.join('\n'));
+}
+export function appendLogUnsafe(root, entry) {
+    const wikiDir = ensureWikiDir(root);
+    const logPath = join(wikiDir, LOG_FILE);
+    const existing = existsSync(logPath) ? readFileSync(logPath, 'utf8') : '# Wiki Log\n\n';
+    const logLine = `## [${entry.timestamp}] ${entry.operation}\n`
+        + `- **Pages:** ${entry.pagesAffected.join(', ') || 'none'}\n`
+        + `- **Summary:** ${entry.summary}\n\n`;
+    atomicWriteFileSync(logPath, `${existing}${logLine}`);
+}
+export function writePage(root, page, options = {}) {
+    withWikiLock(root, () => {
+        writePageUnsafe(root, page, options);
+        updateIndexUnsafe(root);
+    });
+}
+export function deletePage(root, filename) {
+    return withWikiLock(root, () => {
+        const deleted = deletePageUnsafe(root, filename);
+        if (deleted)
+            updateIndexUnsafe(root);
+        return deleted;
+    });
+}
+export function appendLog(root, entry) {
+    withWikiLock(root, () => {
+        appendLogUnsafe(root, entry);
+    });
+}
+export function titleToSlug(title) {
+    const base = title
+        .toLowerCase()
+        .normalize('NFC')
+        .replace(/[^\p{L}\p{N}]+/gu, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 64);
+    if (!base) {
+        let hash = 0;
+        for (let index = 0; index < title.length; index += 1) {
+            hash = ((hash << 5) - hash + title.charCodeAt(index)) | 0;
+        }
+        return `page-${Math.abs(hash).toString(16).padStart(8, '0')}.md`;
+    }
+    return `${base}.md`;
+}
+export function normalizeWikiPageName(page) {
+    return page.endsWith('.md') ? page : `${page}.md`;
+}
+//# sourceMappingURL=storage.js.map

package/dist/wiki/storage.js.map

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

package/dist/wiki/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Wiki Types
+ *
+ * Type definitions for the RCS wiki knowledge layer.
+ */
+export declare const WIKI_SCHEMA_VERSION = 1;
+export type WikiCategory = 'architecture' | 'decision' | 'pattern' | 'debugging' | 'environment' | 'session-log' | 'reference' | 'convention';
+export interface WikiPageFrontmatter {
+    title: string;
+    tags: string[];
+    created: string;
+    updated: string;
+    sources: string[];
+    links: string[];
+    category: WikiCategory;
+    confidence: 'high' | 'medium' | 'low';
+    schemaVersion: number;
+}
+export interface WikiPage {
+    filename: string;
+    frontmatter: WikiPageFrontmatter;
+    content: string;
+}
+export interface WikiLogEntry {
+    timestamp: string;
+    operation: 'ingest' | 'query' | 'lint' | 'add' | 'delete' | 'session-start' | 'session-end';
+    pagesAffected: string[];
+    summary: string;
+}
+export interface WikiIngestInput {
+    title: string;
+    content: string;
+    tags: string[];
+    category: WikiCategory;
+    sources?: string[];
+    confidence?: 'high' | 'medium' | 'low';
+}
+export interface WikiIngestResult {
+    created: string[];
+    updated: string[];
+    totalAffected: number;
+}
+export interface WikiQueryOptions {
+    tags?: string[];
+    category?: WikiCategory;
+    limit?: number;
+    logQuery?: boolean;
+}
+export interface WikiQueryMatch {
+    page: WikiPage;
+    snippet: string;
+    score: number;
+}
+export type WikiLintSeverity = 'error' | 'warning' | 'info';
+export type WikiLintIssueType = 'orphan' | 'stale' | 'broken-ref' | 'low-confidence' | 'oversized' | 'structural-contradiction';
+export interface WikiLintIssue {
+    page: string;
+    severity: WikiLintSeverity;
+    type: WikiLintIssueType;
+    message: string;
+}
+export interface WikiLintReport {
+    issues: WikiLintIssue[];
+    stats: {
+        totalPages: number;
+        orphanCount: number;
+        staleCount: number;
+        brokenRefCount: number;
+        lowConfidenceCount: number;
+        oversizedCount: number;
+        contradictionCount: number;
+    };
+}
+export interface WikiConfig {
+    enabled: boolean;
+    autoCapture: boolean;
+    maxContextLines: number;
+    staleDays: number;
+    maxPageSize: number;
+    feedProjectMemoryOnStart: boolean;
+}
+export declare const DEFAULT_WIKI_CONFIG: WikiConfig;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/wiki/types.js

@@ -0,0 +1,15 @@
+/**
+ * Wiki Types
+ *
+ * Type definitions for the RCS wiki knowledge layer.
+ */
+export const WIKI_SCHEMA_VERSION = 1;
+export const DEFAULT_WIKI_CONFIG = {
+    enabled: true,
+    autoCapture: true,
+    maxContextLines: 30,
+    staleDays: 30,
+    maxPageSize: 10_240,
+    feedProjectMemoryOnStart: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/wiki/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/wiki/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAwGrC,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,EAAE;IACnB,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,MAAM;IACnB,wBAAwB,EAAE,KAAK;CAChC,CAAC"}