crewly 1.20.20 → 1.20.22

package/dist/backend/backend/src/services/wiki/wiki-history.service.d.ts

@@ -0,0 +1,63 @@
+/**
+ * WikiHistoryService — per-page revision history (who changed what).
+ *
+ * Before a page is overwritten, superseded, accepted from a proposal, or
+ * deleted, its previous content is snapshotted to
+ * `<vault>/.wiki-history/<page path>/<ISO>.md` together with the author.
+ * That gives multi-writer vaults (several teachers, several agents) an
+ * audit trail without depending on the vault living in a git repository.
+ * Capped per page; oldest snapshots roll off.
+ *
+ * @module services/wiki/wiki-history.service
+ */
+/** One snapshot. */
+export interface WikiRevision {
+    at: string;
+    /** Who made the change that replaced this content. */
+    author: string;
+    /** `write` | `supersede` | `accept_proposal` | `delete` */
+    action: string;
+    bytes: number;
+    file: string;
+}
+/**
+ * Snapshots prior page content under `.wiki-history/`.
+ */
+export declare class WikiHistoryService {
+    private readonly now;
+    private static instance;
+    private readonly logger;
+    constructor(now?: () => Date);
+    static getInstance(): WikiHistoryService;
+    /** Test-only reset. */
+    static _resetForTesting(): void;
+    /**
+     * Snapshot the current content of a page before it changes. No-op when
+     * the page does not exist yet. Never throws.
+     *
+     * @param vaultPath - Vault root
+     * @param relativePath - Vault-relative page path
+     * @param author - Session/user making the change
+     * @param action - What is about to happen
+     * @returns The revision written, or null
+     */
+    snapshot(vaultPath: string, relativePath: string, author: string, action: string): Promise<WikiRevision | null>;
+    /**
+     * List revisions of a page, newest first.
+     *
+     * @param vaultPath - Vault root
+     * @param relativePath - Vault-relative page path
+     * @returns Revisions
+     */
+    list(vaultPath: string, relativePath: string): Promise<WikiRevision[]>;
+    /**
+     * Read one revision's content (meta line stripped).
+     *
+     * @param file - Absolute snapshot file (from {@link list})
+     * @returns Content
+     */
+    read(file: string): Promise<string>;
+    private historyDir;
+    private prune;
+}
+//# sourceMappingURL=wiki-history.service.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-history.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-history.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-history.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAIjB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAEZ,GAAG,GAAE,MAAM,IAAuB;IAI/D,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAKxC,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;;;;;;;OASG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAmBrH;;;;;;OAMG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA4B5E;;;;;OAKG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzC,OAAO,CAAC,UAAU;YAIJ,KAAK;CAKpB"}

package/dist/backend/backend/src/services/wiki/wiki-history.service.js

@@ -0,0 +1,124 @@
+/**
+ * WikiHistoryService — per-page revision history (who changed what).
+ *
+ * Before a page is overwritten, superseded, accepted from a proposal, or
+ * deleted, its previous content is snapshotted to
+ * `<vault>/.wiki-history/<page path>/<ISO>.md` together with the author.
+ * That gives multi-writer vaults (several teachers, several agents) an
+ * audit trail without depending on the vault living in a git repository.
+ * Capped per page; oldest snapshots roll off.
+ *
+ * @module services/wiki/wiki-history.service
+ */
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { existsSync } from 'fs';
+import { LoggerService } from '../core/logger.service.js';
+import { WIKI_KB_CONSTANTS } from '../../constants.js';
+/**
+ * Snapshots prior page content under `.wiki-history/`.
+ */
+export class WikiHistoryService {
+    now;
+    static instance = null;
+    logger;
+    constructor(now = () => new Date()) {
+        this.now = now;
+        this.logger = LoggerService.getInstance().createComponentLogger('WikiHistory');
+    }
+    static getInstance() {
+        if (!this.instance)
+            this.instance = new WikiHistoryService();
+        return this.instance;
+    }
+    /** Test-only reset. */
+    static _resetForTesting() {
+        this.instance = null;
+    }
+    /**
+     * Snapshot the current content of a page before it changes. No-op when
+     * the page does not exist yet. Never throws.
+     *
+     * @param vaultPath - Vault root
+     * @param relativePath - Vault-relative page path
+     * @param author - Session/user making the change
+     * @param action - What is about to happen
+     * @returns The revision written, or null
+     */
+    async snapshot(vaultPath, relativePath, author, action) {
+        const abs = path.join(vaultPath, relativePath);
+        if (!existsSync(abs))
+            return null;
+        try {
+            const content = await fs.readFile(abs, 'utf8');
+            const dir = this.historyDir(vaultPath, relativePath);
+            await fs.mkdir(dir, { recursive: true });
+            const at = this.now().toISOString();
+            const file = path.join(dir, `${at.replace(/[:.]/g, '-')}.md`);
+            const meta = `<!-- crewly-wiki-history author=${JSON.stringify(author)} action=${action} at=${at} -->\n`;
+            await fs.writeFile(file, meta + content, 'utf8');
+            await this.prune(dir);
+            return { at, author, action, bytes: Buffer.byteLength(content, 'utf8'), file };
+        }
+        catch (err) {
+            this.logger.debug('history snapshot failed (non-fatal)', { relativePath, error: err instanceof Error ? err.message : String(err) });
+            return null;
+        }
+    }
+    /**
+     * List revisions of a page, newest first.
+     *
+     * @param vaultPath - Vault root
+     * @param relativePath - Vault-relative page path
+     * @returns Revisions
+     */
+    async list(vaultPath, relativePath) {
+        const dir = this.historyDir(vaultPath, relativePath);
+        let names;
+        try {
+            names = (await fs.readdir(dir)).filter((n) => n.endsWith('.md')).sort().reverse();
+        }
+        catch {
+            return [];
+        }
+        const out = [];
+        for (const name of names) {
+            const file = path.join(dir, name);
+            try {
+                const raw = await fs.readFile(file, 'utf8');
+                const m = raw.match(/^<!-- crewly-wiki-history author=(".*?") action=(\S+) at=(\S+) -->\n/);
+                out.push({
+                    at: m ? m[3] : '',
+                    author: m ? JSON.parse(m[1]) : 'unknown',
+                    action: m ? m[2] : 'unknown',
+                    bytes: Buffer.byteLength(raw, 'utf8') - (m ? m[0].length : 0),
+                    file,
+                });
+            }
+            catch {
+                /* skip */
+            }
+        }
+        return out;
+    }
+    /**
+     * Read one revision's content (meta line stripped).
+     *
+     * @param file - Absolute snapshot file (from {@link list})
+     * @returns Content
+     */
+    async read(file) {
+        const raw = await fs.readFile(file, 'utf8');
+        return raw.replace(/^<!-- crewly-wiki-history [^\n]* -->\n/, '');
+    }
+    historyDir(vaultPath, relativePath) {
+        return path.join(vaultPath, WIKI_KB_CONSTANTS.HISTORY_DIR, relativePath.replace(/\\/g, '/'));
+    }
+    async prune(dir) {
+        const names = (await fs.readdir(dir)).filter((n) => n.endsWith('.md')).sort();
+        const excess = names.length - WIKI_KB_CONSTANTS.HISTORY_MAX_REVISIONS;
+        for (let i = 0; i < excess; i++)
+            await fs.unlink(path.join(dir, names[i])).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=wiki-history.service.js.map

package/dist/backend/backend/src/services/wiki/wiki-history.service.js.map

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

package/dist/backend/backend/src/services/wiki/wiki-index.service.d.ts

@@ -0,0 +1,119 @@
+/**
+ * WikiIndexService — the one-line-per-page index that makes retrieval a
+ * two-step read: read the whole index → pick 3–5 pages → read them in
+ * full. No embeddings, no vector store; the index IS the retrieval.
+ *
+ * `llm-curated/index.md` is owned by the system: every page write updates
+ * its line, every delete removes it, and `rebuild()` regenerates it from
+ * the pages' frontmatter (also the migration path for vaults whose index
+ * nobody maintained). Pages are grouped by their top-level curated folder.
+ *
+ * @module services/wiki/wiki-index.service
+ */
+import { type WikiPageFrontmatter } from './wiki-page.js';
+/** One entry of the parsed index. */
+export interface WikiIndexEntry {
+    relativePath: string;
+    title: string;
+    summary: string;
+    supersededBy?: string;
+    /** Top-level folder under llm-curated (e.g. `decisions`), or `_root`. */
+    group: string;
+}
+/** Parsed index + raw text. */
+export interface WikiIndex {
+    entries: WikiIndexEntry[];
+    raw: string;
+    bytes: number;
+}
+/** Coverage report: pages the index does not know and vice versa. */
+export interface WikiIndexCoverage {
+    pages: number;
+    indexed: number;
+    missingFromIndex: string[];
+    indexedButMissing: string[];
+}
+/**
+ * Maintains `llm-curated/index.md` per vault.
+ */
+export declare class WikiIndexService {
+    private static instance;
+    private readonly logger;
+    /** Per-vault write serialisation (index edits are read-modify-write). */
+    private readonly locks;
+    constructor();
+    static getInstance(): WikiIndexService;
+    /** Test-only reset. */
+    static _resetForTesting(): void;
+    /**
+     * Absolute path of a vault's index file.
+     *
+     * @param vaultPath - Vault root
+     * @returns `<vault>/llm-curated/index.md`
+     */
+    indexPath(vaultPath: string): string;
+    /**
+     * Read and parse the index (empty when absent).
+     *
+     * @param vaultPath - Vault root
+     * @returns Parsed entries + raw text
+     */
+    read(vaultPath: string): Promise<WikiIndex>;
+    /**
+     * Insert or replace the line for one page.
+     *
+     * @param vaultPath - Vault root
+     * @param relativePath - Vault-relative page path
+     * @param fm - The page's frontmatter (title/summary/superseded_by are used)
+     */
+    upsert(vaultPath: string, relativePath: string, fm: Partial<WikiPageFrontmatter>): Promise<void>;
+    /**
+     * Remove a page's line (no-op when absent).
+     *
+     * @param vaultPath - Vault root
+     * @param relativePath - Vault-relative page path
+     */
+    remove(vaultPath: string, relativePath: string): Promise<void>;
+    /**
+     * Regenerate the whole index from the pages on disk. Pages without a
+     * `summary` still get a line (title only) so nothing is invisible, and
+     * they show up in {@link coverage} as work for the bookkeeping agent.
+     *
+     * @param vaultPath - Vault root
+     * @returns Number of entries written
+     */
+    rebuild(vaultPath: string): Promise<number>;
+    /**
+     * Compare the index against the pages on disk.
+     *
+     * @param vaultPath - Vault root
+     * @returns Coverage report
+     */
+    coverage(vaultPath: string): Promise<WikiIndexCoverage>;
+    /**
+     * The index text an agent should read first, cut to the folders most
+     * relevant to a query when the full index would not fit the budget.
+     *
+     * @param vaultPath - Vault root
+     * @param queryTokens - Lower-cased query terms (for folder selection when trimming)
+     * @param maxBytes - Budget (default {@link WIKI_KB_CONSTANTS.INDEX_MAX_BYTES})
+     * @returns Text plus whether it was trimmed
+     */
+    readForQuery(vaultPath: string, queryTokens: string[], maxBytes?: number): Promise<{
+        text: string;
+        truncated: boolean;
+        entries: number;
+    }>;
+    private write;
+    private withLock;
+}
+/**
+ * Parse index lines back into entries.
+ *
+ * @param raw - index.md text
+ * @returns Entries in file order
+ */
+export declare function parseIndex(raw: string): WikiIndexEntry[];
+/** Whether a vault has an index file at all. */
+export declare function hasIndex(vaultPath: string): boolean;
+//# sourceMappingURL=wiki-index.service.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-index.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-index.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-index.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGnF,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+BAA+B;AAC/B,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAKD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;;IAM1D,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAKtC,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIpC;;;;;OAKG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAUjD;;;;;;OAMG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtG;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASpE;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBjD;;;;;OAKG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAc7D;;;;;;;;OAQG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,QAAQ,SAAoC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;YAwB5J,KAAK;YAQL,QAAQ;CAavB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAexD;AAoCD,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/backend/backend/src/services/wiki/wiki-index.service.js

@@ -0,0 +1,263 @@
+/**
+ * WikiIndexService — the one-line-per-page index that makes retrieval a
+ * two-step read: read the whole index → pick 3–5 pages → read them in
+ * full. No embeddings, no vector store; the index IS the retrieval.
+ *
+ * `llm-curated/index.md` is owned by the system: every page write updates
+ * its line, every delete removes it, and `rebuild()` regenerates it from
+ * the pages' frontmatter (also the migration path for vaults whose index
+ * nobody maintained). Pages are grouped by their top-level curated folder.
+ *
+ * @module services/wiki/wiki-index.service
+ */
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { existsSync } from 'fs';
+import { LoggerService } from '../core/logger.service.js';
+import { WIKI_KB_CONSTANTS } from '../../constants.js';
+import { parsePage, indexLineFor } from './wiki-page.js';
+import { walkCuratedPages, isSeedFile } from './wiki-vault-walk.js';
+const HEADER = '# Index\n\nOne line per page — read this first, then open 3–5 pages. `⟶ superseded by` marks a page whose conclusion has been replaced.\n';
+const LINE_RE = /^- \[(.+?)\]\(([^)]+)\)(?: — (.*?))?(?: ⟶ superseded by (\S+))?$/;
+/**
+ * Maintains `llm-curated/index.md` per vault.
+ */
+export class WikiIndexService {
+    static instance = null;
+    logger;
+    /** Per-vault write serialisation (index edits are read-modify-write). */
+    locks = new Map();
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('WikiIndex');
+    }
+    static getInstance() {
+        if (!this.instance)
+            this.instance = new WikiIndexService();
+        return this.instance;
+    }
+    /** Test-only reset. */
+    static _resetForTesting() {
+        this.instance = null;
+    }
+    /**
+     * Absolute path of a vault's index file.
+     *
+     * @param vaultPath - Vault root
+     * @returns `<vault>/llm-curated/index.md`
+     */
+    indexPath(vaultPath) {
+        return path.join(vaultPath, 'llm-curated', WIKI_KB_CONSTANTS.INDEX_FILENAME);
+    }
+    /**
+     * Read and parse the index (empty when absent).
+     *
+     * @param vaultPath - Vault root
+     * @returns Parsed entries + raw text
+     */
+    async read(vaultPath) {
+        let raw = '';
+        try {
+            raw = await fs.readFile(this.indexPath(vaultPath), 'utf8');
+        }
+        catch {
+            return { entries: [], raw: '', bytes: 0 };
+        }
+        return { entries: parseIndex(raw), raw, bytes: Buffer.byteLength(raw, 'utf8') };
+    }
+    /**
+     * Insert or replace the line for one page.
+     *
+     * @param vaultPath - Vault root
+     * @param relativePath - Vault-relative page path
+     * @param fm - The page's frontmatter (title/summary/superseded_by are used)
+     */
+    async upsert(vaultPath, relativePath, fm) {
+        await this.withLock(vaultPath, async () => {
+            const index = await this.read(vaultPath);
+            const rel = relativePath.replace(/\\/g, '/');
+            const entries = index.entries.filter((e) => e.relativePath !== rel);
+            entries.push(entryFrom(rel, fm));
+            await this.write(vaultPath, entries);
+        });
+    }
+    /**
+     * Remove a page's line (no-op when absent).
+     *
+     * @param vaultPath - Vault root
+     * @param relativePath - Vault-relative page path
+     */
+    async remove(vaultPath, relativePath) {
+        await this.withLock(vaultPath, async () => {
+            const index = await this.read(vaultPath);
+            const rel = relativePath.replace(/\\/g, '/');
+            const entries = index.entries.filter((e) => e.relativePath !== rel);
+            if (entries.length !== index.entries.length)
+                await this.write(vaultPath, entries);
+        });
+    }
+    /**
+     * Regenerate the whole index from the pages on disk. Pages without a
+     * `summary` still get a line (title only) so nothing is invisible, and
+     * they show up in {@link coverage} as work for the bookkeeping agent.
+     *
+     * @param vaultPath - Vault root
+     * @returns Number of entries written
+     */
+    async rebuild(vaultPath) {
+        return this.withLock(vaultPath, async () => {
+            const entries = [];
+            for (const page of await walkCuratedPages(vaultPath)) {
+                if (isSeedFile(page.relativePath))
+                    continue;
+                let raw;
+                try {
+                    raw = await fs.readFile(page.absPath, 'utf8');
+                }
+                catch {
+                    continue;
+                }
+                const { frontmatter, body } = parsePage(raw);
+                const fm = { ...frontmatter };
+                if (!fm.title)
+                    fm.title = firstHeading(body) ?? path.basename(page.relativePath, '.md');
+                entries.push(entryFrom(page.relativePath, fm));
+            }
+            await this.write(vaultPath, entries);
+            this.logger.info('Wiki index rebuilt', { vaultPath, entries: entries.length });
+            return entries.length;
+        });
+    }
+    /**
+     * Compare the index against the pages on disk.
+     *
+     * @param vaultPath - Vault root
+     * @returns Coverage report
+     */
+    async coverage(vaultPath) {
+        const index = await this.read(vaultPath);
+        const indexed = new Set(index.entries.map((e) => e.relativePath));
+        const onDisk = new Set((await walkCuratedPages(vaultPath)).map((p) => p.relativePath).filter((p) => !isSeedFile(p)));
+        return {
+            pages: onDisk.size,
+            indexed: indexed.size,
+            missingFromIndex: [...onDisk].filter((p) => !indexed.has(p)).sort(),
+            indexedButMissing: [...indexed].filter((p) => !onDisk.has(p)).sort(),
+        };
+    }
+    /**
+     * The index text an agent should read first, cut to the folders most
+     * relevant to a query when the full index would not fit the budget.
+     *
+     * @param vaultPath - Vault root
+     * @param queryTokens - Lower-cased query terms (for folder selection when trimming)
+     * @param maxBytes - Budget (default {@link WIKI_KB_CONSTANTS.INDEX_MAX_BYTES})
+     * @returns Text plus whether it was trimmed
+     */
+    async readForQuery(vaultPath, queryTokens, maxBytes = WIKI_KB_CONSTANTS.INDEX_MAX_BYTES) {
+        const index = await this.read(vaultPath);
+        if (index.bytes <= maxBytes)
+            return { text: index.raw, truncated: false, entries: index.entries.length };
+        // Trim: keep groups whose lines mention a query term first, then fill.
+        const terms = new Set(queryTokens.map((t) => t.toLowerCase()).filter((t) => t.length > 1));
+        const score = (e) => {
+            const hay = `${e.title} ${e.summary} ${e.relativePath}`.toLowerCase();
+            let n = 0;
+            for (const t of terms)
+                if (hay.includes(t))
+                    n++;
+            return n;
+        };
+        const ranked = [...index.entries].sort((a, b) => score(b) - score(a) || a.relativePath.localeCompare(b.relativePath));
+        const kept = [];
+        let bytes = Buffer.byteLength(HEADER, 'utf8');
+        for (const e of ranked) {
+            const line = indexLineFor(e.relativePath, { title: e.title, summary: e.summary, superseded_by: e.supersededBy }) + '\n';
+            const b = Buffer.byteLength(line, 'utf8');
+            if (bytes + b > maxBytes)
+                break;
+            bytes += b;
+            kept.push(e);
+        }
+        return { text: render(kept) + `\n_(index trimmed to ${kept.length} of ${index.entries.length} entries for this query)_\n`, truncated: true, entries: kept.length };
+    }
+    async write(vaultPath, entries) {
+        const file = this.indexPath(vaultPath);
+        await fs.mkdir(path.dirname(file), { recursive: true });
+        const tmp = `${file}.tmp`;
+        await fs.writeFile(tmp, render(entries), 'utf8');
+        await fs.rename(tmp, file);
+    }
+    async withLock(vaultPath, fn) {
+        const prev = this.locks.get(vaultPath) ?? Promise.resolve();
+        let release;
+        const gate = new Promise((r) => { release = r; });
+        this.locks.set(vaultPath, prev.then(() => gate));
+        await prev;
+        try {
+            return await fn();
+        }
+        finally {
+            release();
+            if (this.locks.get(vaultPath) === gate)
+                this.locks.delete(vaultPath);
+        }
+    }
+}
+/**
+ * Parse index lines back into entries.
+ *
+ * @param raw - index.md text
+ * @returns Entries in file order
+ */
+export function parseIndex(raw) {
+    const entries = [];
+    for (const line of raw.split('\n')) {
+        const m = line.match(LINE_RE);
+        if (!m)
+            continue;
+        const relativePath = m[2];
+        entries.push({
+            relativePath,
+            title: m[1],
+            summary: m[3] ?? '',
+            ...(m[4] ? { supersededBy: m[4] } : {}),
+            group: groupOf(relativePath),
+        });
+    }
+    return entries;
+}
+function entryFrom(relativePath, fm) {
+    const line = indexLineFor(relativePath, fm);
+    const parsed = parseIndex(line)[0];
+    return parsed ?? { relativePath, title: relativePath, summary: '', group: groupOf(relativePath) };
+}
+function groupOf(relativePath) {
+    const parts = relativePath.replace(/^llm-curated\//, '').split('/');
+    return parts.length > 1 ? parts[0] : '_root';
+}
+function render(entries) {
+    const groups = new Map();
+    for (const e of entries) {
+        const g = groups.get(e.group) ?? [];
+        g.push(e);
+        groups.set(e.group, g);
+    }
+    const names = [...groups.keys()].sort((a, b) => (a === '_root' ? 1 : b === '_root' ? -1 : a.localeCompare(b)));
+    const out = [HEADER];
+    for (const name of names) {
+        out.push(`\n## ${name === '_root' ? 'Other' : name}\n`);
+        for (const e of groups.get(name).sort((a, b) => a.relativePath.localeCompare(b.relativePath))) {
+            out.push(indexLineFor(e.relativePath, { title: e.title, summary: e.summary, superseded_by: e.supersededBy }));
+        }
+    }
+    return out.join('\n') + '\n';
+}
+function firstHeading(body) {
+    const m = body.match(/^#\s+(.+)$/m);
+    return m ? m[1].trim() : null;
+}
+/** Whether a vault has an index file at all. */
+export function hasIndex(vaultPath) {
+    return existsSync(path.join(vaultPath, 'llm-curated', WIKI_KB_CONSTANTS.INDEX_FILENAME));
+}
+//# sourceMappingURL=wiki-index.service.js.map

package/dist/backend/backend/src/services/wiki/wiki-index.service.js.map

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