gnosys 4.0.0

package/dist/lib/rulesGen.js

@@ -0,0 +1,167 @@
+/**
+ * Gnosys Rules Generation — Phase 8b.
+ *
+ * Generates agent rules content from user preferences and project conventions.
+ * Output is injected into agent rules files (CLAUDE.md, .cursor/rules/gnosys.mdc)
+ * inside GNOSYS:START / GNOSYS:END blocks. User content outside these blocks
+ * is never touched.
+ *
+ * The generated block contains:
+ *   1. Base Gnosys tool instructions (always present)
+ *   2. User preferences (from scope='user' category='preferences')
+ *   3. Project conventions (from scope='project' for current projectId)
+ */
+import fs from "fs/promises";
+import path from "path";
+import { getAllPreferences } from "./preferences.js";
+// ─── Block markers ──────────────────────────────────────────────────────
+const MARKER_START_HTML = "<!-- GNOSYS:START -->";
+const MARKER_END_HTML = "<!-- GNOSYS:END -->";
+const MARKER_START_MDC = "<!-- GNOSYS:START -->";
+const MARKER_END_MDC = "<!-- GNOSYS:END -->";
+// ─── Base instructions ──────────────────────────────────────────────────
+function getBaseInstructions() {
+    return `## Gnosys Memory System
+
+This project uses **Gnosys** for persistent memory. Run \`gnosys init\` before any other Gnosys command.
+
+### Core workflow
+1. **Start of task**: Run \`gnosys_discover\` with keywords to find relevant memories
+2. **Read**: Use \`gnosys_read\` to load specific memories
+3. **Write**: Use \`gnosys_add\` for new knowledge, \`gnosys_update\` to modify existing
+4. **Reinforce**: Use \`gnosys_reinforce\` when a memory proves useful
+
+### Memory triggers — write automatically when:
+- A decision is made (library choice, architecture pattern, workflow convention)
+- A spec or requirement is provided
+- Significant findings emerge from implementation
+- Something works differently than expected`;
+}
+// ─── Content generation ─────────────────────────────────────────────────
+/**
+ * Generate the full GNOSYS block content from preferences and project conventions.
+ */
+export function generateRulesBlock(preferences, projectConventions, opts) {
+    const sections = [];
+    // 1. Base instructions (always present)
+    sections.push(getBaseInstructions());
+    // 2. User preferences
+    if (preferences.length > 0) {
+        const prefLines = preferences.map((p) => `- **${p.title}**: ${p.value}`);
+        sections.push(`### User preferences\n\n${prefLines.join("\n")}`);
+    }
+    // 3. Project conventions
+    if (projectConventions.length > 0) {
+        const convLines = projectConventions.map((m) => {
+            // Extract content body (strip "# Title\n\n" prefix)
+            const lines = m.content.split("\n");
+            const body = lines[0].startsWith("# ")
+                ? lines.slice(2).join("\n").trim()
+                : m.content.trim();
+            return `- **${m.title}**: ${body.split("\n")[0]}`;
+        });
+        sections.push(`### Project conventions\n\n${convLines.join("\n")}`);
+    }
+    return sections.join("\n\n");
+}
+/**
+ * Wrap content in GNOSYS markers.
+ */
+function wrapInMarkers(content) {
+    return `${MARKER_START_HTML}\n${content}\n${MARKER_END_HTML}`;
+}
+// ─── File injection ─────────────────────────────────────────────────────
+/**
+ * Inject generated rules into a file, preserving content outside GNOSYS blocks.
+ * Creates the file if it doesn't exist.
+ */
+export async function injectRules(filePath, generatedBlock) {
+    const wrapped = wrapInMarkers(generatedBlock);
+    let existing = null;
+    try {
+        existing = await fs.readFile(filePath, "utf-8");
+    }
+    catch {
+        // File doesn't exist — will create
+    }
+    if (existing === null) {
+        // Create new file with just the GNOSYS block
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, wrapped + "\n", "utf-8");
+        return { created: true };
+    }
+    // File exists — replace existing GNOSYS block or append
+    const startIdx = existing.indexOf(MARKER_START_HTML);
+    const endIdx = existing.indexOf(MARKER_END_HTML);
+    let newContent;
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        // Replace existing block
+        const before = existing.substring(0, startIdx);
+        const after = existing.substring(endIdx + MARKER_END_HTML.length);
+        newContent = before + wrapped + after;
+    }
+    else {
+        // No existing block — append at end
+        newContent = existing.trimEnd() + "\n\n" + wrapped + "\n";
+    }
+    await fs.writeFile(filePath, newContent, "utf-8");
+    return { created: false };
+}
+// ─── High-level sync ────────────────────────────────────────────────────
+/**
+ * Sync rules for a project: reads preferences + project conventions from
+ * central DB, generates the rules block, and injects into the agent rules file.
+ */
+export async function syncRules(centralDb, projectDir, agentRulesTarget, projectId) {
+    if (!agentRulesTarget)
+        return null;
+    const filePath = path.resolve(projectDir, agentRulesTarget);
+    // Gather preferences (user-scoped)
+    const preferences = getAllPreferences(centralDb);
+    // Gather project conventions (decisions + conventions for this project)
+    let projectConventions = [];
+    if (projectId) {
+        const projectMems = centralDb.getMemoriesByProject(projectId);
+        projectConventions = projectMems.filter((m) => (m.category === "decisions" || m.category === "conventions") &&
+            m.status === "active");
+    }
+    // Determine format from file extension
+    let format = "generic";
+    if (agentRulesTarget.endsWith(".md"))
+        format = "claude";
+    if (agentRulesTarget.endsWith(".mdc"))
+        format = "cursor";
+    // Generate and inject
+    const block = generateRulesBlock(preferences, projectConventions, { format });
+    const { created } = await injectRules(filePath, block);
+    return {
+        content: block,
+        created,
+        filePath,
+        prefCount: preferences.length,
+        conventionCount: projectConventions.length,
+    };
+}
+/**
+ * Remove the GNOSYS block from a rules file (cleanup).
+ */
+export async function removeRulesBlock(filePath) {
+    let content;
+    try {
+        content = await fs.readFile(filePath, "utf-8");
+    }
+    catch {
+        return false;
+    }
+    const startIdx = content.indexOf(MARKER_START_HTML);
+    const endIdx = content.indexOf(MARKER_END_HTML);
+    if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) {
+        return false;
+    }
+    const before = content.substring(0, startIdx);
+    const after = content.substring(endIdx + MARKER_END_HTML.length);
+    const newContent = (before + after).replace(/\n{3,}/g, "\n\n").trim() + "\n";
+    await fs.writeFile(filePath, newContent, "utf-8");
+    return true;
+}
+//# sourceMappingURL=rulesGen.js.map

package/dist/lib/rulesGen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulesGen.js","sourceRoot":"","sources":["../../src/lib/rulesGen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAc,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,2EAA2E;AAE3E,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAClD,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAC9C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACjD,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAmB7C,2EAA2E;AAE3E,SAAS,mBAAmB;IAC1B,OAAO;;;;;;;;;;;;;;4CAcmC,CAAC;AAC7C,CAAC;AAED,2EAA2E;AAE3E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAyB,EACzB,kBAA8B,EAC9B,IAAmC;IAEnC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAErC,sBAAsB;IACtB,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACzE,QAAQ,CAAC,IAAI,CACX,2BAA2B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClD,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7C,oDAAoD;YACpD,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;gBACpC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;gBAClC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CACX,8BAA8B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrD,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO,GAAG,iBAAiB,KAAK,OAAO,KAAK,eAAe,EAAE,CAAC;AAChE,CAAC;AAED,2EAA2E;AAE3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAgB,EAChB,cAAsB;IAEtB,MAAM,OAAO,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAE9C,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IAED,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,6CAA6C;QAC7C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,wDAAwD;IACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAEjD,IAAI,UAAkB,CAAC;IACvB,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1D,yBAAyB;QACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QAClE,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,oCAAoC;QACpC,UAAU,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC5D,CAAC;IAED,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,2EAA2E;AAE3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAAmB,EACnB,UAAkB,EAClB,gBAA+B,EAC/B,SAAwB;IAExB,IAAI,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAE5D,mCAAmC;IACnC,MAAM,WAAW,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAEjD,wEAAwE;IACxE,IAAI,kBAAkB,GAAe,EAAE,CAAC;IACxC,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,WAAW,GAAG,SAAS,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC9D,kBAAkB,GAAG,WAAW,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,IAAI,CAAC,CAAC,QAAQ,KAAK,aAAa,CAAC;YAC5D,CAAC,CAAC,MAAM,KAAK,QAAQ,CACxB,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,IAAI,MAAM,GAAoB,SAAS,CAAC;IACxC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,GAAG,QAAQ,CAAC;IACxD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,GAAG,QAAQ,CAAC;IAEzD,sBAAsB;IACtB,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9E,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEvD,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO;QACP,QAAQ;QACR,SAAS,EAAE,WAAW,CAAC,MAAM;QAC7B,eAAe,EAAE,kBAAkB,CAAC,MAAM;KAC3C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAEhD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;IAE7E,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/search.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Gnosys Search — SQLite FTS5 keyword index for fast text search.
+ * FTS5-based search and discovery across all Gnosys stores.
+ */
+import { GnosysStore } from "./store.js";
+export interface SearchResult {
+    relative_path: string;
+    title: string;
+    snippet: string;
+    rank: number;
+}
+export interface DiscoverResult {
+    relative_path: string;
+    title: string;
+    relevance: string;
+    rank: number;
+}
+export declare class GnosysSearch {
+    private db;
+    private storePath;
+    private available;
+    constructor(storePath: string);
+    private initSchema;
+    /**
+     * Clear the entire search index.
+     */
+    clearIndex(): void;
+    /**
+     * Rebuild the entire search index from a single store.
+     * Clears all existing entries first.
+     */
+    reindex(store: GnosysStore): Promise<number>;
+    /**
+     * Add memories from a store to the index WITHOUT clearing existing entries.
+     * Used for multi-store indexing: clear once, then addStoreMemories for each store.
+     * Optional storeLabel prefix is prepended to relative_path for disambiguation.
+     */
+    addStoreMemories(store: GnosysStore, storeLabel?: string): Promise<number>;
+    /**
+     * Search memories by keyword query.
+     */
+    search(query: string, limit?: number): SearchResult[];
+    /**
+     * Discover memories by searching relevance keyword clouds.
+     * Returns lightweight metadata only — no file contents.
+     * This is the primary discovery mechanism replacing the static manifest.
+     */
+    discover(query: string, limit?: number): DiscoverResult[];
+    close(): void;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/lib/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EAAE,WAAW,EAAU,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,YAAY;IAEvB,OAAO,CAAC,EAAE,CAAa;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,EAAE,MAAM;IA4B7B,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlD;;;;OAIG;IACG,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmChF;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,YAAY,EAAE;IAqCzD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,cAAc,EAAE;IAqC7D,KAAK,IAAI,IAAI;CAGd"}

package/dist/lib/search.js

@@ -0,0 +1,190 @@
+/**
+ * Gnosys Search — SQLite FTS5 keyword index for fast text search.
+ * FTS5-based search and discovery across all Gnosys stores.
+ */
+// Dynamic import — gracefully handles missing native module (dlopen failures)
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let Database = null;
+try {
+    Database = (await import("better-sqlite3")).default;
+}
+catch {
+    // better-sqlite3 native module not available — search degrades gracefully
+}
+import path from "path";
+export class GnosysSearch {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    db = null;
+    storePath;
+    available = false;
+    constructor(storePath) {
+        this.storePath = storePath;
+        if (!Database) {
+            // Native module not available — search features disabled
+            return;
+        }
+        // Try file-based DB first, fall back to in-memory.
+        // We must verify writes actually work — some filesystems (e.g., mounted
+        // volumes in sandboxed environments) allow file creation but block the
+        // journal/WAL delete operations that SQLite requires.
+        try {
+            const dbPath = path.join(storePath, ".config", "search.db");
+            this.db = new Database(dbPath);
+            this.initSchema();
+            // Smoke-test: insert + delete to confirm journal ops work
+            this.db.exec("CREATE TABLE IF NOT EXISTS _write_test (v INTEGER); INSERT INTO _write_test VALUES (1); DELETE FROM _write_test; DROP TABLE _write_test;");
+            this.available = true;
+        }
+        catch {
+            // Fallback to in-memory (works everywhere, rebuilt on each start)
+            try {
+                this.db?.close();
+            }
+            catch { /* ignore */ }
+            this.db = new Database(":memory:");
+            this.initSchema();
+            this.available = true;
+        }
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
+        relative_path,
+        title,
+        category,
+        tags,
+        relevance,
+        content,
+        tokenize='porter unicode61'
+      );
+    `);
+    }
+    /**
+     * Clear the entire search index.
+     */
+    clearIndex() {
+        if (!this.db)
+            return;
+        this.db.exec("DELETE FROM memories_fts");
+    }
+    /**
+     * Rebuild the entire search index from a single store.
+     * Clears all existing entries first.
+     */
+    async reindex(store) {
+        this.clearIndex();
+        return this.addStoreMemories(store);
+    }
+    /**
+     * Add memories from a store to the index WITHOUT clearing existing entries.
+     * Used for multi-store indexing: clear once, then addStoreMemories for each store.
+     * Optional storeLabel prefix is prepended to relative_path for disambiguation.
+     */
+    async addStoreMemories(store, storeLabel) {
+        if (!this.db)
+            return 0;
+        const memories = await store.getAllMemories();
+        const insert = this.db.prepare("INSERT INTO memories_fts (relative_path, title, category, tags, relevance, content) VALUES (?, ?, ?, ?, ?, ?)");
+        const tx = this.db.transaction(() => {
+            for (const m of memories) {
+                const tags = Array.isArray(m.frontmatter.tags)
+                    ? m.frontmatter.tags.join(" ")
+                    : Object.values(m.frontmatter.tags).flat().join(" ");
+                const relevance = m.frontmatter.relevance || "";
+                const indexPath = storeLabel
+                    ? `${storeLabel}:${m.relativePath}`
+                    : m.relativePath;
+                insert.run(indexPath, m.frontmatter.title, m.frontmatter.category, tags, relevance, m.content);
+            }
+        });
+        tx();
+        return memories.length;
+    }
+    /**
+     * Search memories by keyword query.
+     */
+    search(query, limit = 20) {
+        if (!this.db)
+            return [];
+        // FTS5 query — escape special characters
+        const safeQuery = query.replace(/['"]/g, "").trim();
+        if (!safeQuery)
+            return [];
+        const stmt = this.db.prepare(`
+      SELECT
+        relative_path,
+        title,
+        snippet(memories_fts, 5, '>>>', '<<<', '...', 40) as snippet,
+        rank
+      FROM memories_fts
+      WHERE memories_fts MATCH ?
+      ORDER BY rank
+      LIMIT ?
+    `);
+        try {
+            return stmt.all(safeQuery, limit);
+        }
+        catch {
+            // If FTS5 query fails, fall back to simple LIKE search
+            const likeStmt = this.db.prepare(`
+        SELECT
+          relative_path,
+          title,
+          substr(content, 1, 200) as snippet,
+          0 as rank
+        FROM memories_fts
+        WHERE content LIKE ? OR title LIKE ? OR tags LIKE ?
+        LIMIT ?
+      `);
+            const pattern = `%${safeQuery}%`;
+            return likeStmt.all(pattern, pattern, pattern, limit);
+        }
+    }
+    /**
+     * Discover memories by searching relevance keyword clouds.
+     * Returns lightweight metadata only — no file contents.
+     * This is the primary discovery mechanism replacing the static manifest.
+     */
+    discover(query, limit = 20) {
+        if (!this.db)
+            return [];
+        const safeQuery = query.replace(/['"]/g, "").trim();
+        if (!safeQuery)
+            return [];
+        // Search primarily on relevance + title + tags (not content body)
+        // FTS5 column filter: {relevance title tags}
+        const stmt = this.db.prepare(`
+      SELECT
+        relative_path,
+        title,
+        relevance,
+        rank
+      FROM memories_fts
+      WHERE memories_fts MATCH ?
+      ORDER BY rank
+      LIMIT ?
+    `);
+        try {
+            // Try column-filtered search on relevance/title/tags first
+            const colQuery = `{relevance title tags} : ${safeQuery}`;
+            const results = stmt.all(colQuery, limit);
+            if (results.length > 0)
+                return results;
+            // Fall back to full-text search if column filter finds nothing
+            return stmt.all(safeQuery, limit);
+        }
+        catch {
+            // If FTS5 column filter syntax fails, fall back to full search
+            try {
+                return stmt.all(safeQuery, limit);
+            }
+            catch {
+                return [];
+            }
+        }
+    }
+    close() {
+        this.db?.close();
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/lib/search.js.map

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

package/dist/lib/staticSearch.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Gnosys Web — Zero-dependency runtime search module.
+ *
+ * Exported as `gnosys/web` subpath. Loads a pre-computed gnosys-index.json
+ * and provides search functions for serverless chatbot integrations.
+ *
+ * CRITICAL: This module must have ZERO dependencies beyond Node.js built-ins.
+ * No better-sqlite3, no gray-matter, no @anthropic-ai/sdk, nothing.
+ */
+export interface GnosysWebIndex {
+    version: number;
+    generated: string;
+    documentCount: number;
+    documents: DocumentManifest[];
+    invertedIndex: Record<string, IndexEntry[]>;
+}
+export interface DocumentManifest {
+    id: string;
+    path: string;
+    title: string;
+    category: string;
+    tags: string[];
+    relevance: string;
+    contentHash: string;
+    contentLength: number;
+    created: string | null;
+    status: string;
+}
+export interface IndexEntry {
+    docIndex: number;
+    score: number;
+}
+export interface SearchOptions {
+    limit?: number;
+    minScore?: number;
+    category?: string;
+    tags?: string[];
+    boostRecent?: boolean;
+}
+export interface SearchResult {
+    document: DocumentManifest;
+    score: number;
+    matchedTokens: string[];
+}
+/**
+ * Load a pre-computed Gnosys web index from a file path or raw JSON string.
+ * Caches the result for repeated calls with the same source.
+ */
+export declare function loadIndex(pathOrJson: string): GnosysWebIndex;
+/**
+ * Clear the cached index (useful for testing).
+ */
+export declare function clearIndexCache(): void;
+/**
+ * Search the pre-computed index and return ranked results.
+ */
+export declare function search(index: GnosysWebIndex, query: string, options?: SearchOptions): SearchResult[];
+/**
+ * Get a specific document's metadata by ID or path.
+ */
+export declare function getDocument(index: GnosysWebIndex, idOrPath: string): DocumentManifest | null;
+/**
+ * List all documents, optionally filtered by category, tags, or status.
+ */
+export declare function listDocuments(index: GnosysWebIndex, filter?: {
+    category?: string;
+    tags?: string[];
+    status?: string;
+}): DocumentManifest[];
+//# sourceMappingURL=staticSearch.d.ts.map

package/dist/lib/staticSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticSearch.d.ts","sourceRoot":"","sources":["../../src/lib/staticSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAmCD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAsC5D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAED;;GAEG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,YAAY,EAAE,CA6DhB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,GACf,gBAAgB,GAAG,IAAI,CAMzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,EACrB,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,gBAAgB,EAAE,CAUpB"}

package/dist/lib/staticSearch.js

@@ -0,0 +1,162 @@
+/**
+ * Gnosys Web — Zero-dependency runtime search module.
+ *
+ * Exported as `gnosys/web` subpath. Loads a pre-computed gnosys-index.json
+ * and provides search functions for serverless chatbot integrations.
+ *
+ * CRITICAL: This module must have ZERO dependencies beyond Node.js built-ins.
+ * No better-sqlite3, no gray-matter, no @anthropic-ai/sdk, nothing.
+ */
+import { readFileSync, existsSync } from "fs";
+// ─── Module-level cache ──────────────────────────────────────────────────
+let cachedIndex = null;
+let cachedSource = null;
+// ─── Stop words (same list used by webIndex.ts at build time) ────────────
+const STOP_WORDS = new Set([
+    "a", "an", "the", "and", "or", "but", "in", "on", "at", "to", "for",
+    "of", "with", "by", "from", "is", "it", "as", "be", "was", "are",
+    "been", "has", "had", "have", "do", "does", "did", "will", "would",
+    "could", "should", "may", "might", "shall", "can", "this", "that",
+    "these", "those", "not", "no", "nor", "so", "if", "then", "than",
+    "too", "very", "just", "about", "above", "after", "again", "all",
+    "also", "am", "any", "because", "before", "between", "both", "each",
+    "few", "he", "she", "her", "him", "his", "how", "its", "me", "more",
+    "most", "my", "new", "now", "only", "other", "our", "out", "own",
+    "re", "same", "some", "such", "up", "us", "we", "what", "when",
+    "where", "which", "who", "whom", "why", "you", "your",
+]);
+// ─── Tokenization ────────────────────────────────────────────────────────
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, " ")
+        .split(/\s+/)
+        .filter((t) => t.length >= 2 && !STOP_WORDS.has(t));
+}
+// ─── Public API ──────────────────────────────────────────────────────────
+/**
+ * Load a pre-computed Gnosys web index from a file path or raw JSON string.
+ * Caches the result for repeated calls with the same source.
+ */
+export function loadIndex(pathOrJson) {
+    if (cachedIndex && cachedSource === pathOrJson) {
+        return cachedIndex;
+    }
+    let raw;
+    if (pathOrJson.trimStart().startsWith("{")) {
+        raw = pathOrJson;
+    }
+    else {
+        if (!existsSync(pathOrJson)) {
+            throw new Error(`Gnosys web index not found: ${pathOrJson}`);
+        }
+        raw = readFileSync(pathOrJson, "utf-8");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error("Invalid JSON in Gnosys web index");
+    }
+    const index = parsed;
+    if (!index.version || typeof index.version !== "number") {
+        throw new Error("Invalid Gnosys web index: missing or invalid version field");
+    }
+    if (index.version > 1) {
+        throw new Error(`Gnosys web index version ${index.version} is not supported by this version of gnosys/web. ` +
+            `Please update the gnosys package.`);
+    }
+    cachedIndex = index;
+    cachedSource = pathOrJson;
+    return index;
+}
+/**
+ * Clear the cached index (useful for testing).
+ */
+export function clearIndexCache() {
+    cachedIndex = null;
+    cachedSource = null;
+}
+/**
+ * Search the pre-computed index and return ranked results.
+ */
+export function search(index, query, options = {}) {
+    const { limit = 6, minScore = 0.1, category, tags, boostRecent = false } = options;
+    const queryTokens = tokenize(query);
+    if (queryTokens.length === 0)
+        return [];
+    // Accumulate scores per document
+    const docScores = new Map();
+    for (const token of queryTokens) {
+        const entries = index.invertedIndex[token];
+        if (!entries)
+            continue;
+        for (const entry of entries) {
+            const existing = docScores.get(entry.docIndex);
+            if (existing) {
+                existing.score += entry.score;
+                if (!existing.matchedTokens.includes(token)) {
+                    existing.matchedTokens.push(token);
+                }
+            }
+            else {
+                docScores.set(entry.docIndex, {
+                    score: entry.score,
+                    matchedTokens: [token],
+                });
+            }
+        }
+    }
+    // Build results with filters
+    const results = [];
+    for (const [docIndex, { score, matchedTokens }] of docScores) {
+        const doc = index.documents[docIndex];
+        if (!doc)
+            continue;
+        // Apply filters
+        if (category && doc.category !== category)
+            continue;
+        if (tags && tags.length > 0 && !tags.some((t) => doc.tags.includes(t)))
+            continue;
+        let finalScore = score;
+        // Optional recency boost
+        if (boostRecent && doc.created) {
+            const ageMs = Date.now() - new Date(doc.created).getTime();
+            const ageDays = ageMs / (1000 * 60 * 60 * 24);
+            // Boost documents less than 30 days old, max 1.5x
+            if (ageDays < 30) {
+                finalScore *= 1 + 0.5 * (1 - ageDays / 30);
+            }
+        }
+        if (finalScore < minScore)
+            continue;
+        results.push({ document: doc, score: finalScore, matchedTokens });
+    }
+    // Sort by score descending
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, limit);
+}
+/**
+ * Get a specific document's metadata by ID or path.
+ */
+export function getDocument(index, idOrPath) {
+    return (index.documents.find((d) => d.id === idOrPath || d.path === idOrPath) ?? null);
+}
+/**
+ * List all documents, optionally filtered by category, tags, or status.
+ */
+export function listDocuments(index, filter) {
+    if (!filter)
+        return [...index.documents];
+    return index.documents.filter((d) => {
+        if (filter.category && d.category !== filter.category)
+            return false;
+        if (filter.tags && filter.tags.length > 0 && !filter.tags.some((t) => d.tags.includes(t)))
+            return false;
+        if (filter.status && d.status !== filter.status)
+            return false;
+        return true;
+    });
+}
+//# sourceMappingURL=staticSearch.js.map