gnosys-mcp 0.1.0

package/dist/lib/search.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 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;
+    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;AAIH,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;IACvB,OAAO,CAAC,EAAE,CAAqB;IAC/B,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,EAAE,MAAM;IAsB7B,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;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;IAkChF;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,YAAY,EAAE;IAoCzD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,cAAc,EAAE;IAoC7D,KAAK,IAAI,IAAI;CAGd"}

package/dist/lib/search.js

@@ -0,0 +1,166 @@
+/**
+ * Gnosys Search — SQLite FTS5 keyword index for fast text search.
+ * FTS5-based search and discovery across all Gnosys stores.
+ */
+import Database from "better-sqlite3";
+import path from "path";
+export class GnosysSearch {
+    db;
+    storePath;
+    constructor(storePath) {
+        this.storePath = storePath;
+        // 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, ".gnosys", "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;");
+        }
+        catch {
+            // Fallback to in-memory (works everywhere, rebuilt on each start)
+            try {
+                this.db?.close();
+            }
+            catch { /* ignore */ }
+            this.db = new Database(":memory:");
+            this.initSchema();
+        }
+    }
+    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() {
+        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) {
+        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) {
+        // 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) {
+        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/store.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Gnosys Store — Core module for reading/writing atomic memory files.
+ * The filesystem is the source of truth. All memories are markdown files
+ * with YAML frontmatter organized in category directories.
+ */
+export interface MemoryFrontmatter {
+    id: string;
+    title: string;
+    category: string;
+    tags: Record<string, string[]> | string[];
+    relevance: string;
+    author: "human" | "ai" | "human+ai";
+    authority: "declared" | "observed" | "imported" | "inferred";
+    confidence: number;
+    created: string;
+    modified: string;
+    last_reviewed?: string | null;
+    status: "active" | "archived" | "superseded";
+    supersedes?: string | null;
+    superseded_by?: string | null;
+    [key: string]: unknown;
+}
+export interface Memory {
+    frontmatter: MemoryFrontmatter;
+    content: string;
+    filePath: string;
+    relativePath: string;
+}
+export declare class GnosysStore {
+    private storePath;
+    private gitEnabled;
+    constructor(storePath: string);
+    init(): Promise<void>;
+    /**
+     * Read all memory files from the store.
+     */
+    getAllMemories(): Promise<Memory[]>;
+    /**
+     * Read a single memory by relative path.
+     */
+    readMemory(relativePath: string): Promise<Memory | null>;
+    /**
+     * Write a new memory to the store.
+     */
+    writeMemory(category: string, filename: string, frontmatter: MemoryFrontmatter, content: string): Promise<string>;
+    /**
+     * Update an existing memory.
+     */
+    updateMemory(relativePath: string, updates: Partial<MemoryFrontmatter>, newContent?: string): Promise<Memory | null>;
+    /**
+     * List all categories (directories) in the store.
+     */
+    getCategories(): Promise<string[]>;
+    /**
+     * Generate a unique ID for a new memory.
+     */
+    generateId(category: string): Promise<string>;
+    /**
+     * Get the store path.
+     */
+    getStorePath(): string;
+    /**
+     * Auto-commit changes to git (silent, never user-facing).
+     */
+    private autoCommit;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/lib/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,UAAU,CAAC;IACpC,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAU;gBAEhB,SAAS,EAAE,MAAM;IAKvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB3B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBzC;;OAEG;IACG,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmB9D;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC;IAgBlB;;OAEG;IACG,YAAY,CAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACnC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyBzB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAaxC;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAenD;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;YACW,UAAU;CAYzB"}

package/dist/lib/store.js

@@ -0,0 +1,168 @@
+/**
+ * Gnosys Store — Core module for reading/writing atomic memory files.
+ * The filesystem is the source of truth. All memories are markdown files
+ * with YAML frontmatter organized in category directories.
+ */
+import fs from "fs/promises";
+import path from "path";
+import matter from "gray-matter";
+import { glob } from "glob";
+import { execSync } from "child_process";
+export class GnosysStore {
+    storePath;
+    gitEnabled;
+    constructor(storePath) {
+        this.storePath = path.resolve(storePath);
+        this.gitEnabled = false;
+    }
+    async init() {
+        // Ensure store directory exists
+        await fs.mkdir(this.storePath, { recursive: true });
+        await fs.mkdir(path.join(this.storePath, ".gnosys"), { recursive: true });
+        // Init git if not already
+        try {
+            const gitDir = path.join(this.storePath, ".git");
+            const stat = await fs.stat(gitDir).catch(() => null);
+            if (!stat) {
+                execSync("git init", { cwd: this.storePath, stdio: "pipe" });
+            }
+            this.gitEnabled = true;
+        }
+        catch {
+            this.gitEnabled = false;
+        }
+    }
+    /**
+     * Read all memory files from the store.
+     */
+    async getAllMemories() {
+        const files = await glob("**/*.md", {
+            cwd: this.storePath,
+            ignore: ["MANIFEST.md", "CHANGELOG.md", ".gnosys/**", "node_modules/**"],
+        });
+        const memories = [];
+        for (const file of files) {
+            try {
+                const memory = await this.readMemory(file);
+                if (memory)
+                    memories.push(memory);
+            }
+            catch {
+                // Skip files that can't be parsed
+            }
+        }
+        return memories;
+    }
+    /**
+     * Read a single memory by relative path.
+     */
+    async readMemory(relativePath) {
+        const fullPath = path.join(this.storePath, relativePath);
+        try {
+            const raw = await fs.readFile(fullPath, "utf-8");
+            const parsed = matter(raw);
+            if (!parsed.data.id)
+                return null; // Not a valid memory file
+            return {
+                frontmatter: parsed.data,
+                content: parsed.content.trim(),
+                filePath: fullPath,
+                relativePath,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Write a new memory to the store.
+     */
+    async writeMemory(category, filename, frontmatter, content) {
+        const dir = path.join(this.storePath, category);
+        await fs.mkdir(dir, { recursive: true });
+        const filePath = path.join(dir, filename);
+        const relativePath = path.join(category, filename);
+        const fileContent = matter.stringify(content, frontmatter);
+        await fs.writeFile(filePath, fileContent, "utf-8");
+        // Auto git commit
+        await this.autoCommit(`Add memory: ${frontmatter.title}`);
+        return relativePath;
+    }
+    /**
+     * Update an existing memory.
+     */
+    async updateMemory(relativePath, updates, newContent) {
+        const existing = await this.readMemory(relativePath);
+        if (!existing)
+            return null;
+        const updatedFrontmatter = {
+            ...existing.frontmatter,
+            ...updates,
+            modified: new Date().toISOString().split("T")[0],
+        };
+        const updatedContent = newContent ?? existing.content;
+        const fullPath = path.join(this.storePath, relativePath);
+        const fileContent = matter.stringify(updatedContent, updatedFrontmatter);
+        await fs.writeFile(fullPath, fileContent, "utf-8");
+        await this.autoCommit(`Update memory: ${updatedFrontmatter.title}`);
+        return {
+            frontmatter: updatedFrontmatter,
+            content: updatedContent,
+            filePath: fullPath,
+            relativePath,
+        };
+    }
+    /**
+     * List all categories (directories) in the store.
+     */
+    async getCategories() {
+        const entries = await fs.readdir(this.storePath, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory() &&
+            !e.name.startsWith(".") &&
+            e.name !== "node_modules")
+            .map((e) => e.name)
+            .sort();
+    }
+    /**
+     * Generate a unique ID for a new memory.
+     */
+    async generateId(category) {
+        const prefix = category.substring(0, 4);
+        const memories = await this.getAllMemories();
+        const existingIds = memories
+            .map((m) => m.frontmatter.id)
+            .filter((id) => id.startsWith(prefix));
+        let maxNum = 0;
+        for (const id of existingIds) {
+            const match = id.match(/(\d+)$/);
+            if (match)
+                maxNum = Math.max(maxNum, parseInt(match[1]));
+        }
+        return `${prefix}-${String(maxNum + 1).padStart(3, "0")}`;
+    }
+    /**
+     * Get the store path.
+     */
+    getStorePath() {
+        return this.storePath;
+    }
+    /**
+     * Auto-commit changes to git (silent, never user-facing).
+     */
+    async autoCommit(message) {
+        if (!this.gitEnabled)
+            return;
+        try {
+            execSync("git add -A", { cwd: this.storePath, stdio: "pipe" });
+            execSync(`git commit -m "${message}" --allow-empty-message`, {
+                cwd: this.storePath,
+                stdio: "pipe",
+            });
+        }
+        catch {
+            // Git commit can fail if nothing changed — that's fine
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/lib/store.js.map

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

package/dist/lib/tags.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Gnosys Tag Registry — Categorized controlled vocabulary for tags.
+ * Stored in .gnosys/tags.yml. The ingestion LLM must use existing tags
+ * but can propose new ones for approval.
+ */
+export interface TagRegistry {
+    domain: string[];
+    type: string[];
+    concern: string[];
+    status_tag: string[];
+    [category: string]: string[];
+}
+export declare class GnosysTagRegistry {
+    private registryPath;
+    private registry;
+    constructor(storePath: string);
+    load(): Promise<TagRegistry>;
+    save(): Promise<void>;
+    getRegistry(): TagRegistry;
+    getAllTags(): string[];
+    getTagsByCategory(category: string): string[];
+    hasTag(tag: string): boolean;
+    findTagCategory(tag: string): string | null;
+    addTag(category: string, tag: string): Promise<boolean>;
+}
+//# sourceMappingURL=tags.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/lib/tags.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC9B;AAmDD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAc;gBAElB,SAAS,EAAE,MAAM;IAKvB,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAW5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,WAAW,IAAI,WAAW;IAI1B,UAAU,IAAI,MAAM,EAAE;IAItB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAI7C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOrC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS9D"}

package/dist/lib/tags.js

@@ -0,0 +1,109 @@
+/**
+ * Gnosys Tag Registry — Categorized controlled vocabulary for tags.
+ * Stored in .gnosys/tags.yml. The ingestion LLM must use existing tags
+ * but can propose new ones for approval.
+ */
+import fs from "fs/promises";
+import path from "path";
+const DEFAULT_REGISTRY = {
+    domain: [
+        "auth",
+        "database",
+        "frontend",
+        "backend",
+        "deployment",
+        "api",
+        "cli",
+        "mcp",
+        "wiki",
+        "obsidian",
+        "architecture",
+        "retrieval",
+        "search",
+        "ingestion",
+        "memory",
+        "lensing",
+        "decay",
+        "reinforcement",
+        "contradiction",
+        "tags",
+        "git",
+        "typescript",
+        "tooling",
+        "roadmap",
+        "scope",
+    ],
+    type: [
+        "decision",
+        "convention",
+        "architecture",
+        "concept",
+        "requirement",
+        "landscape",
+        "open-question",
+    ],
+    concern: [
+        "security",
+        "performance",
+        "scalability",
+        "dx",
+        "adoption",
+        "community",
+        "portability",
+    ],
+    status_tag: ["core", "experimental", "deprecated", "phased"],
+};
+export class GnosysTagRegistry {
+    registryPath;
+    registry;
+    constructor(storePath) {
+        this.registryPath = path.join(storePath, ".gnosys", "tags.json");
+        this.registry = { ...DEFAULT_REGISTRY };
+    }
+    async load() {
+        try {
+            const raw = await fs.readFile(this.registryPath, "utf-8");
+            this.registry = JSON.parse(raw);
+        }
+        catch {
+            // File doesn't exist yet — use defaults and create it
+            await this.save();
+        }
+        return this.registry;
+    }
+    async save() {
+        const dir = path.dirname(this.registryPath);
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(this.registryPath, JSON.stringify(this.registry, null, 2), "utf-8");
+    }
+    getRegistry() {
+        return this.registry;
+    }
+    getAllTags() {
+        return [...new Set(Object.values(this.registry).flat())].sort();
+    }
+    getTagsByCategory(category) {
+        return this.registry[category] || [];
+    }
+    hasTag(tag) {
+        return Object.values(this.registry).some((tags) => tags.includes(tag));
+    }
+    findTagCategory(tag) {
+        for (const [category, tags] of Object.entries(this.registry)) {
+            if (tags.includes(tag))
+                return category;
+        }
+        return null;
+    }
+    async addTag(category, tag) {
+        if (!this.registry[category]) {
+            this.registry[category] = [];
+        }
+        if (this.registry[category].includes(tag))
+            return false;
+        this.registry[category].push(tag);
+        await this.save();
+        return true;
+    }
+}
+//# sourceMappingURL=tags.js.map

package/dist/lib/tags.js.map

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

package/dist/lib/timeline.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Gnosys Timeline — Temporal views and statistics for memory stores.
+ *
+ * Group memories by time period to see knowledge evolution.
+ * Compute summary statistics across the store.
+ */
+import { Memory } from "./store.js";
+export type TimePeriod = "day" | "week" | "month" | "year";
+export interface TimelineEntry {
+    period: string;
+    created: number;
+    modified: number;
+    titles: string[];
+}
+export interface MemoryStats {
+    totalCount: number;
+    byCategory: Record<string, number>;
+    byStatus: Record<string, number>;
+    byAuthor: Record<string, number>;
+    byAuthority: Record<string, number>;
+    averageConfidence: number;
+    oldestCreated: string | null;
+    newestCreated: string | null;
+    lastModified: string | null;
+}
+/**
+ * Group memories by time period based on their created/modified dates.
+ */
+export declare function groupByPeriod(memories: Memory[], period: TimePeriod): TimelineEntry[];
+/**
+ * Compute summary statistics across all memories.
+ */
+export declare function computeStats(memories: Memory[]): MemoryStats;
+//# sourceMappingURL=timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../src/lib/timeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,EAAE,CAkCrF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,WAAW,CAmC5D"}