@treenity/core 1.0.48 → 3.0.1

package/dist/server/client.d.ts

@@ -0,0 +1,190 @@
+export declare function createClient(url: string, token?: string): import("@trpc/client").TRPCClient<import("@trpc/server").TRPCBuiltRouter<{
+    ctx: import("./trpc").TrpcContext;
+    meta: object;
+    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+    transformer: false;
+}, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+    get: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            path: string;
+            watch?: boolean | undefined;
+        };
+        output: import("..").NodeData | undefined;
+        meta: object;
+    }>;
+    getChildren: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            path: string;
+            limit?: number | undefined;
+            offset?: number | undefined;
+            depth?: number | undefined;
+            watch?: boolean | undefined;
+            watchNew?: boolean | undefined;
+        };
+        output: import("../tree").Page<import("..").NodeData>;
+        meta: object;
+    }>;
+    set: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            node: Record<string, unknown>;
+        };
+        output: void;
+        meta: object;
+    }>;
+    setComponent: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            path: string;
+            name: string;
+            data: Record<string, unknown>;
+            rev?: number | undefined;
+        };
+        output: void;
+        meta: object;
+    }>;
+    remove: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            path: string;
+        };
+        output: boolean;
+        meta: object;
+    }>;
+    execute: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            path: string;
+            action: string;
+            type?: string | undefined;
+            key?: string | undefined;
+            data?: unknown;
+            watch?: boolean | undefined;
+        };
+        output: unknown;
+        meta: object;
+    }>;
+    getTemplates: import("@trpc/server").TRPCQueryProcedure<{
+        input: void;
+        output: import("..").NodeData[];
+        meta: object;
+    }>;
+    applyTemplate: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            templatePath: string;
+            targetPath: string;
+        };
+        output: {
+            applied: string;
+            blocks: number;
+        };
+        meta: object;
+    }>;
+    deployPrefab: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            source: string;
+            target: string;
+            allowAbsolute?: boolean | undefined;
+            params?: any;
+        };
+        output: {
+            deployed: number;
+            skipped: number;
+        };
+        meta: object;
+    }>;
+    register: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            userId: string;
+            password: string;
+        };
+        output: {
+            token: string;
+            userId: string;
+        };
+        meta: object;
+    }>;
+    login: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            userId: string;
+            password: string;
+        };
+        output: {
+            token: string;
+            userId: string;
+        };
+        meta: object;
+    }>;
+    me: import("@trpc/server").TRPCQueryProcedure<{
+        input: void;
+        output: {
+            userId: string;
+        } | null;
+        meta: object;
+    }>;
+    getPerm: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            path: string;
+        };
+        output: number;
+        meta: object;
+    }>;
+    logout: import("@trpc/server").TRPCMutationProcedure<{
+        input: void;
+        output: {
+            ok: boolean;
+        };
+        meta: object;
+    }>;
+    agentConnect: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            path: string;
+            key: string;
+        };
+        output: {
+            status: "pending";
+            token?: undefined;
+            userId?: undefined;
+        } | {
+            status: "approved";
+            token: string;
+            userId: string;
+        };
+        meta: object;
+    }>;
+    unwatch: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            paths: string[];
+        };
+        output: void;
+        meta: object;
+    }>;
+    unwatchChildren: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            paths: string[];
+        };
+        output: void;
+        meta: object;
+    }>;
+    anonLogin: import("@trpc/server").TRPCMutationProcedure<{
+        input: void;
+        output: {
+            token: string;
+            userId: string;
+        };
+        meta: object;
+    }>;
+    streamAction: import("@trpc/server/unstable-core-do-not-import").LegacyObservableSubscriptionProcedure<{
+        input: {
+            path: string;
+            action: string;
+            type?: string | undefined;
+            key?: string | undefined;
+            data?: unknown;
+        };
+        output: unknown;
+        meta: object;
+    }>;
+    events: import("@trpc/server/unstable-core-do-not-import").LegacyObservableSubscriptionProcedure<{
+        input: void;
+        output: import("./sub").NodeEvent;
+        meta: object;
+    }>;
+}>>>;
+//# sourceMappingURL=client.d.ts.map

package/dist/server/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/server/client.ts"],"names":[],"mappings":"AAQA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAevD"}

package/dist/server/client.js

@@ -0,0 +1,22 @@
+// Treenity tRPC Client — Node.js
+// Creates tRPC client for tests and scripts (not browser).
+// Uses `eventsource` npm package for SSE subscriptions.
+import { createTRPCClient, httpBatchLink, httpSubscriptionLink, splitLink } from '@trpc/client';
+import { EventSource } from 'eventsource';
+export function createClient(url, token) {
+    const headers = token ? { Authorization: `Bearer ${token}` } : {};
+    return createTRPCClient({
+        links: [
+            splitLink({
+                condition: (op) => op.type === 'subscription',
+                true: httpSubscriptionLink({
+                    url,
+                    EventSource: EventSource,
+                    connectionParams: () => (token ? { token } : {}),
+                }),
+                false: httpBatchLink({ url, maxURLLength: 2048, headers: () => headers }),
+            }),
+        ],
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/server/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/server/client.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,2DAA2D;AAC3D,wDAAwD;AAExD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAc;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,OAAO,gBAAgB,CAAa;QAClC,KAAK,EAAE;YACL,SAAS,CAAC;gBACR,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,cAAc;gBAC7C,IAAI,EAAE,oBAAoB,CAAC;oBACzB,GAAG;oBACH,WAAW,EAAE,WAAkB;oBAC/B,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACjD,CAAC;gBACF,KAAK,EAAE,aAAa,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;aAC1E,CAAC;SACH;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/server/cookies.d.ts

@@ -0,0 +1,5 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export declare function parseCookies(req: IncomingMessage): Record<string, string>;
+export declare function setSessionCookie(res: ServerResponse, token: string): void;
+export declare function clearSessionCookie(res: ServerResponse): void;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/server/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/server/cookies.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,wBAAgB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUzE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIzE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAE5D"}

package/dist/server/cookies.js

@@ -0,0 +1,24 @@
+// Cookie helpers for HttpOnly session management
+export function parseCookies(req) {
+    const header = req.headers.cookie;
+    if (!header)
+        return {};
+    const out = {};
+    for (const pair of header.split(';')) {
+        const eq = pair.indexOf('=');
+        if (eq < 0)
+            continue;
+        out[pair.slice(0, eq).trim()] = pair.slice(eq + 1).trim();
+    }
+    return out;
+}
+export function setSessionCookie(res, token) {
+    const parts = [`session=${token}`, 'HttpOnly', 'SameSite=Lax', 'Path=/', 'Max-Age=86400'];
+    if (process.env.NODE_ENV === 'production')
+        parts.push('Secure');
+    res.setHeader('Set-Cookie', parts.join('; '));
+}
+export function clearSessionCookie(res) {
+    res.setHeader('Set-Cookie', 'session=; HttpOnly; SameSite=Lax; Path=/; Max-Age=0');
+}
+//# sourceMappingURL=cookies.js.map

package/dist/server/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../src/server/cookies.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAIjD,MAAM,UAAU,YAAY,CAAC,GAAoB;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,EAAE,GAAG,CAAC;YAAE,SAAS;QACrB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAmB,EAAE,KAAa;IACjE,MAAM,KAAK,GAAG,CAAC,WAAW,KAAK,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC1F,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChE,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAmB;IACpD,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,qDAAqD,CAAC,CAAC;AACrF,CAAC"}

package/dist/server/doc-index.d.ts

@@ -0,0 +1,38 @@
+import { create } from '@orama/orama';
+export type DocCategory = 'doc' | 'mod' | 'code' | 'memory' | 'config';
+declare const SCHEMA: {
+    readonly path: "string";
+    readonly section: "string";
+    readonly category: "enum";
+    readonly text: "string";
+    readonly mtime: "number";
+};
+type DocDB = ReturnType<typeof create<typeof SCHEMA>>;
+export type FileInfo = {
+    path: string;
+    category: DocCategory;
+    sections: number;
+    chars: number;
+};
+export declare function buildDocIndex(projectRoot: string, memoryDir?: string): DocDB;
+export declare function invalidateDocIndex(): void;
+export type DocSearchResult = {
+    path: string;
+    section: string;
+    category: string;
+    snippet: string;
+    score: number;
+};
+export declare function searchDocs(opts: {
+    projectRoot: string;
+    memoryDir?: string;
+    query: string;
+    category?: DocCategory;
+    pathPattern?: string;
+    maxResults?: number;
+    tolerance?: number;
+}): Promise<DocSearchResult[]>;
+export declare function listDocs(projectRoot: string, memoryDir?: string, category?: DocCategory): FileInfo[];
+export declare function readDoc(projectRoot: string, relPath: string, memoryDir?: string): string;
+export {};
+//# sourceMappingURL=doc-index.d.ts.map

package/dist/server/doc-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-index.d.ts","sourceRoot":"","sources":["../../src/server/doc-index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAA0B,MAAM,cAAc,CAAC;AAI9D,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAUvE,QAAA,MAAM,MAAM;;;;;;CAMF,CAAC;AAEX,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;AA4HtD,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAOhG,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAiC5E;AAED,wBAAgB,kBAAkB,SAIjC;AAID,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAiC7B;AAED,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,EAAE,CAIpG;AAED,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAOxF"}

package/dist/server/doc-index.js

@@ -0,0 +1,245 @@
+// Doc RAG — BM25 search over project docs, code, and AI memory
+// Indexes: docs/*.md, **/CLAUDE.md, memory/*.md, key source files (types.ts, service.ts, core)
+// Chunks markdown by ## headers. Code files indexed whole (truncated).
+// Used by: scripts/mcp-docs.ts (Claude Code MCP)
+import { create, insertMultiple, search } from '@orama/orama';
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { basename, extname, join, relative } from 'node:path';
+const SCHEMA = {
+    path: 'string',
+    section: 'string',
+    category: 'enum',
+    text: 'string',
+    mtime: 'number',
+};
+// ── File discovery ──
+const EXCLUDE = /node_modules|dist|dist-front|\.git[\/\\]|dont-read|\/old\/|\.DS_Store|bun\.lock/;
+function walkDir(dir, exts, extraExclude) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    function walk(d) {
+        for (const entry of readdirSync(d, { withFileTypes: true })) {
+            const full = join(d, entry.name);
+            if (EXCLUDE.test(full))
+                continue;
+            if (extraExclude?.test(full))
+                continue;
+            if (entry.isDirectory()) {
+                walk(full);
+                continue;
+            }
+            if (exts.has(extname(entry.name)))
+                results.push(full);
+        }
+    }
+    walk(dir);
+    return results;
+}
+function categorize(filePath, projectRoot, memoryDir) {
+    if (memoryDir && filePath.startsWith(memoryDir))
+        return 'memory';
+    const rel = relative(projectRoot, filePath);
+    if (basename(filePath) === 'CLAUDE.md')
+        return rel.startsWith('src/mods/') ? 'mod' : 'config';
+    if (rel.startsWith('docs/'))
+        return 'doc';
+    if (rel === 'package.json' || rel === 'tsconfig.json' || rel === 'CHANGELOG.md')
+        return 'config';
+    return 'code';
+}
+// ── Chunking ──
+function chunkMarkdown(text, filePath) {
+    const chunks = [];
+    const lines = text.split('\n');
+    let section = basename(filePath, '.md');
+    let buf = [];
+    for (const line of lines) {
+        const m = line.match(/^##\s+(.+)/);
+        if (m) {
+            if (buf.length)
+                chunks.push({ section, text: buf.join('\n').trim() });
+            section = m[1].trim();
+            buf = [line];
+        }
+        else {
+            buf.push(line);
+        }
+    }
+    if (buf.length)
+        chunks.push({ section, text: buf.join('\n').trim() });
+    if (chunks.length <= 1)
+        return [{ section: basename(filePath, '.md'), text: text.trim() }];
+    return chunks.filter(c => c.text.length > 20);
+}
+const MAX_CODE_CHUNK = 4000;
+function chunkFile(filePath) {
+    let text;
+    try {
+        text = readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    if (!text.trim())
+        return [];
+    if (extname(filePath) === '.md')
+        return chunkMarkdown(text, filePath);
+    const truncated = text.length > MAX_CODE_CHUNK
+        ? text.slice(0, MAX_CODE_CHUNK) + '\n...(truncated)'
+        : text;
+    return [{ section: basename(filePath), text: truncated }];
+}
+// ── Collect files ──
+function collectFiles(projectRoot, memoryDir) {
+    const files = new Set();
+    // docs/*.md
+    for (const f of walkDir(join(projectRoot, 'docs'), new Set(['.md'])))
+        files.add(f);
+    // All CLAUDE.md files
+    for (const f of walkDir(projectRoot, new Set(['.md']))) {
+        if (basename(f) === 'CLAUDE.md')
+            files.add(f);
+    }
+    // Memory
+    if (memoryDir) {
+        for (const f of walkDir(memoryDir, new Set(['.md'])))
+            files.add(f);
+    }
+    // Core layers: full source (engine/core/src/*)
+    for (const d of ['engine/core/src/core', 'engine/core/src/tree', 'engine/core/src/comp', 'engine/core/src/server', 'engine/core/src/schema', 'engine/core/src/client']) {
+        for (const f of walkDir(join(projectRoot, d), new Set(['.ts']), /\.test\.ts$/))
+            files.add(f);
+    }
+    // Mods: types.ts, service.ts, etc. — engine/core/src/mods, engine/mods/*, mods/*
+    const modKeyFiles = new Set(['types.ts', 'service.ts', 'client.ts', 'server.ts', 'mcp.ts', 'view.tsx']);
+    for (const modDir of ['engine/core/src/mods', 'engine/mods', 'mods']) {
+        for (const f of walkDir(join(projectRoot, modDir), new Set(['.ts']), /\.test\.ts$/)) {
+            if (modKeyFiles.has(basename(f)))
+                files.add(f);
+        }
+        for (const f of walkDir(join(projectRoot, modDir), new Set(['.tsx']), /\.test\.tsx$/)) {
+            files.add(f);
+        }
+    }
+    // Frontend key files (engine/packages/react/src/*)
+    for (const f of ['engine/packages/react/src/App.tsx', 'engine/packages/react/src/hooks.ts', 'engine/packages/react/src/cache.ts', 'engine/packages/react/src/trpc.ts']) {
+        const full = join(projectRoot, f);
+        if (existsSync(full))
+            files.add(full);
+    }
+    // Root config
+    for (const f of ['CLAUDE.md', 'CHANGELOG.md', 'package.json']) {
+        const full = join(projectRoot, f);
+        if (existsSync(full))
+            files.add(full);
+    }
+    return [...files];
+}
+let db = null;
+let fileList = [];
+let builtAt = 0;
+let lastRoot = '';
+export function buildDocIndex(projectRoot, memoryDir) {
+    if (db && lastRoot === projectRoot && Date.now() - builtAt < 60_000)
+        return db;
+    const files = collectFiles(projectRoot, memoryDir);
+    const allChunks = [];
+    fileList = [];
+    for (const file of files) {
+        const category = categorize(file, projectRoot, memoryDir);
+        let mtime;
+        try {
+            mtime = statSync(file).mtime.getTime();
+        }
+        catch {
+            continue;
+        }
+        const chunks = chunkFile(file);
+        const relPath = memoryDir && file.startsWith(memoryDir)
+            ? 'memory/' + relative(memoryDir, file)
+            : relative(projectRoot, file);
+        fileList.push({ path: relPath, category, sections: chunks.length, chars: chunks.reduce((s, c) => s + c.text.length, 0) });
+        for (const chunk of chunks) {
+            allChunks.push({ path: relPath, section: chunk.section, category, text: chunk.text, mtime });
+        }
+    }
+    const t0 = Date.now();
+    db = create({ schema: SCHEMA });
+    if (allChunks.length)
+        insertMultiple(db, allChunks);
+    builtAt = Date.now();
+    lastRoot = projectRoot;
+    console.log(`[doc-index] ${allChunks.length} chunks from ${files.length} files in ${Date.now() - t0}ms`);
+    return db;
+}
+export function invalidateDocIndex() {
+    db = null;
+    fileList = [];
+    builtAt = 0;
+}
+export async function searchDocs(opts) {
+    const { projectRoot, memoryDir, query, category, pathPattern, maxResults = 20, tolerance = 1 } = opts;
+    const index = buildDocIndex(projectRoot, memoryDir);
+    const where = {};
+    if (category)
+        where.category = { eq: category };
+    const results = await search(index, {
+        term: query,
+        properties: ['text', 'section', 'path'],
+        tolerance,
+        where: Object.keys(where).length ? where : undefined,
+        limit: maxResults * 2, // overfetch for post-filter
+    });
+    let hits = results.hits;
+    // Post-filter by path pattern
+    if (pathPattern) {
+        const re = new RegExp(pathPattern.replace(/\*/g, '.*').replace(/\?/g, '.'), 'i');
+        hits = hits.filter((h) => re.test(h.document.path));
+    }
+    return hits.slice(0, maxResults).map((h) => {
+        const doc = h.document;
+        return {
+            path: doc.path,
+            section: doc.section,
+            category: doc.category,
+            snippet: extractSnippet(doc.text, query, 500),
+            score: h.score,
+        };
+    });
+}
+export function listDocs(projectRoot, memoryDir, category) {
+    buildDocIndex(projectRoot, memoryDir);
+    if (category)
+        return fileList.filter(f => f.category === category);
+    return fileList;
+}
+export function readDoc(projectRoot, relPath, memoryDir) {
+    let full = join(projectRoot, relPath);
+    if (!existsSync(full) && memoryDir) {
+        full = join(memoryDir, relPath.replace(/^memory\//, ''));
+    }
+    if (!existsSync(full))
+        throw new Error(`File not found: ${relPath}`);
+    return readFileSync(full, 'utf-8');
+}
+// ── Snippet ──
+function extractSnippet(text, query, maxLen) {
+    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+    const textLower = text.toLowerCase();
+    let bestIdx = -1;
+    for (const term of terms) {
+        const idx = textLower.indexOf(term);
+        if (idx !== -1) {
+            bestIdx = idx;
+            break;
+        }
+    }
+    if (bestIdx !== -1) {
+        const start = Math.max(0, bestIdx - 120);
+        const end = Math.min(text.length, start + maxLen);
+        return (start > 0 ? '...' : '') + text.slice(start, end) + (end < text.length ? '...' : '');
+    }
+    return text.length > maxLen ? text.slice(0, maxLen) + '...' : text;
+}
+//# sourceMappingURL=doc-index.js.map

package/dist/server/doc-index.js.map

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

package/dist/server/errors.d.ts

@@ -0,0 +1,7 @@
+export type ErrorCode = 'NOT_FOUND' | 'BAD_REQUEST' | 'CONFLICT' | 'FORBIDDEN';
+export declare class OpError extends Error {
+    readonly code: ErrorCode;
+    readonly name = "OpError";
+    constructor(code: ErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/server/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/server/errors.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,CAAC;AAE/E,qBAAa,OAAQ,SAAQ,KAAK;aAEJ,IAAI,EAAE,SAAS;IAD3C,SAAkB,IAAI,aAAa;gBACP,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM;CAG7D"}

package/dist/server/errors.js

@@ -0,0 +1,11 @@
+// Domain errors for server operations.
+// Transport-agnostic: tRPC, HTTP, MCP each map these to their own format.
+export class OpError extends Error {
+    code;
+    name = 'OpError';
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/server/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/server/errors.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,0EAA0E;AAI1E,MAAM,OAAO,OAAQ,SAAQ,KAAK;IAEJ;IADV,IAAI,GAAG,SAAS,CAAC;IACnC,YAA4B,IAAe,EAAE,OAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QADW,SAAI,GAAJ,IAAI,CAAW;IAE3C,CAAC;CACF"}

package/dist/server/factory.d.ts

@@ -0,0 +1,29 @@
+import '#contexts/schema/index';
+import '#contexts/text/index';
+import '#schema/load';
+import './mount-adapters';
+import { type NodeData } from '#core';
+import { type Tree } from '#tree';
+import type { Server } from 'node:http';
+import { type Ensure } from './seed';
+import { type Pipeline } from './server';
+export type TreenityConfig = {
+    rootNode?: NodeData;
+    dataDir?: string;
+    modsDir?: string | false;
+    seed?: (store: Tree, ensure: Ensure) => Promise<void>;
+    autostart?: boolean;
+};
+export type ListenOpts = {
+    host?: string;
+    allowedOrigins?: string[];
+    staticDir?: string;
+};
+export type TreenityInstance = Pipeline & {
+    stop(): Promise<void>;
+};
+export type TreenityServer = TreenityInstance & {
+    listen(port?: number, opts?: ListenOpts): Promise<Server>;
+};
+export declare function treenity(config?: TreenityConfig): Promise<TreenityServer>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/server/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/server/factory.ts"],"names":[],"mappings":"AAGA,OAAO,wBAAwB,CAAC;AAChC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,cAAc,CAAC;AACtB,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAiB,KAAK,QAAQ,EAAW,MAAM,OAAO,CAAC;AAG9D,OAAO,EAAoB,KAAK,IAAI,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAoC,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE3E,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG;IACxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG;IAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D,CAAC;AAEF,wBAAsB,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAgF/E"}