gnosys 4.0.0

package/dist/lib/resolver.js

@@ -0,0 +1,372 @@
+/**
+ * Gnosys Store Resolver — Discovers and manages layered stores.
+ *
+ * Four layers, resolved in specificity order:
+ *   Project  (auto-discovered from cwd, writable, default write target)
+ *   Optional (GNOSYS_STORES, read-only)
+ *   Personal (GNOSYS_PERSONAL, writable, fallback write target)
+ *   Global   (GNOSYS_GLOBAL, writable only when explicitly targeted)
+ */
+import fs from "fs/promises";
+import path from "path";
+import { GnosysStore } from "./store.js";
+export class GnosysResolver {
+    stores = [];
+    /** MCP workspace roots (file:// URIs → local paths). Updated via roots/list. */
+    static mcpRoots = [];
+    /**
+     * Update the MCP roots list. Call this from the MCP server on init
+     * and on "notifications/roots/list_changed".
+     */
+    static setMcpRoots(roots) {
+        GnosysResolver.mcpRoots = roots
+            .map((r) => {
+            try {
+                // Convert file:// URI to local path
+                if (r.uri.startsWith("file://")) {
+                    return new URL(r.uri).pathname;
+                }
+                return r.uri;
+            }
+            catch {
+                return r.uri;
+            }
+        })
+            .filter(Boolean);
+    }
+    /**
+     * Get the current MCP roots as local paths.
+     */
+    static getMcpRoots() {
+        return [...GnosysResolver.mcpRoots];
+    }
+    /**
+     * Create a resolver scoped to a specific project root.
+     * Used for per-tool projectRoot parameter — each call gets its own
+     * resolver instance, so there's no shared mutable state.
+     */
+    static async resolveForProject(projectRoot) {
+        const resolver = new GnosysResolver();
+        const storePath = path.join(path.resolve(projectRoot), ".gnosys");
+        try {
+            const stat = await fs.stat(storePath);
+            if (stat.isDirectory()) {
+                const store = new GnosysStore(storePath);
+                await store.init();
+                resolver.stores.push({
+                    layer: "project",
+                    label: "project",
+                    store,
+                    writable: true,
+                    path: storePath,
+                });
+            }
+        }
+        catch {
+            // Store doesn't exist at projectRoot — fall through to empty resolver
+        }
+        return resolver;
+    }
+    /**
+     * Discover and initialize all store layers.
+     */
+    async resolve() {
+        this.stores = [];
+        // 1. Project store — check registered projects first, then MCP roots, then walk up from cwd.
+        //    Registered projects are saved in ~/.config/gnosys/projects.json by gnosys_init.
+        //    This is more reliable than cwd because MCP servers may be spawned
+        //    with cwd set to the user's home directory rather than the open project.
+        const projectPath = await this.findProjectStore();
+        if (projectPath) {
+            const store = new GnosysStore(projectPath);
+            await store.init();
+            this.stores.push({
+                layer: "project",
+                label: "project",
+                store,
+                writable: true,
+                path: projectPath,
+            });
+        }
+        // 2. Optional stores (GNOSYS_STORES — colon-separated)
+        const optionalPaths = process.env.GNOSYS_STORES;
+        if (optionalPaths) {
+            const paths = optionalPaths.split(":").filter(Boolean);
+            for (let i = 0; i < paths.length; i++) {
+                const p = path.resolve(paths[i]);
+                if (await this.isValidStore(p)) {
+                    const store = new GnosysStore(p);
+                    await store.init();
+                    const dirName = path.basename(path.dirname(p)) || path.basename(p);
+                    this.stores.push({
+                        layer: "optional",
+                        label: `optional:${dirName}`,
+                        store,
+                        writable: false,
+                        path: p,
+                    });
+                }
+            }
+        }
+        // 3. Personal store (GNOSYS_PERSONAL)
+        const personalPath = process.env.GNOSYS_PERSONAL;
+        if (personalPath) {
+            const p = path.resolve(personalPath);
+            const store = new GnosysStore(p);
+            await store.init();
+            this.stores.push({
+                layer: "personal",
+                label: "personal",
+                store,
+                writable: true,
+                path: p,
+            });
+        }
+        // 4. Global store (GNOSYS_GLOBAL)
+        //    Writable, but only when explicitly targeted — never auto-selected.
+        const globalPath = process.env.GNOSYS_GLOBAL;
+        if (globalPath) {
+            const p = path.resolve(globalPath);
+            if (await this.isValidStore(p)) {
+                const store = new GnosysStore(p);
+                await store.init();
+                this.stores.push({
+                    layer: "global",
+                    label: "global",
+                    store,
+                    writable: true,
+                    path: p,
+                });
+            }
+        }
+        return this.stores;
+    }
+    /**
+     * Get all stores in precedence order.
+     */
+    getStores() {
+        return this.stores;
+    }
+    /**
+     * Get all memories across all stores, tagged with their source.
+     */
+    async getAllMemories() {
+        const allMemories = [];
+        for (const resolved of this.stores) {
+            const memories = await resolved.store.getAllMemories();
+            for (const m of memories) {
+                allMemories.push({
+                    ...m,
+                    sourceLayer: resolved.layer,
+                    sourceLabel: resolved.label,
+                });
+            }
+        }
+        return allMemories;
+    }
+    /**
+     * Read a memory, searching stores in precedence order.
+     * Path format: "layer:category/filename.md" or just "category/filename.md" (searches all).
+     */
+    async readMemory(memPath) {
+        // Check if path includes a layer prefix
+        const layerMatch = memPath.match(/^(project|personal|global|optional(?::[^:]+)?):(.+)/);
+        if (layerMatch) {
+            const targetLabel = layerMatch[1];
+            const filePath = layerMatch[2];
+            const resolved = this.stores.find((s) => s.label === targetLabel || s.layer === targetLabel);
+            if (!resolved)
+                return null;
+            const memory = await resolved.store.readMemory(filePath);
+            if (!memory)
+                return null;
+            return { ...memory, sourceLayer: resolved.layer, sourceLabel: resolved.label };
+        }
+        // No layer prefix — search in precedence order
+        for (const resolved of this.stores) {
+            const memory = await resolved.store.readMemory(memPath);
+            if (memory) {
+                return { ...memory, sourceLayer: resolved.layer, sourceLabel: resolved.label };
+            }
+        }
+        return null;
+    }
+    /**
+     * Get the writable store for a given target layer.
+     *
+     * When no target is specified, auto-selects: project → personal.
+     * Global is writable but NEVER auto-selected — it must be explicitly
+     * requested (store: "global"). This prevents accidental writes to
+     * shared org knowledge.
+     * Optional stores are always read-only.
+     */
+    getWriteTarget(target) {
+        if (target) {
+            const store = this.stores.find((s) => s.layer === target && s.writable);
+            return store || null;
+        }
+        // Default: project first, then personal. Never global (requires explicit intent).
+        const project = this.stores.find((s) => s.layer === "project");
+        if (project?.writable)
+            return project;
+        const personal = this.stores.find((s) => s.layer === "personal");
+        if (personal?.writable)
+            return personal;
+        return null;
+    }
+    /**
+     * Get a summary of all active stores for logging.
+     */
+    getSummary() {
+        if (this.stores.length === 0) {
+            return "No stores found. Create a .gnosys/ directory or set GNOSYS_PERSONAL.";
+        }
+        return this.stores
+            .map((s) => `[${s.label}] ${s.path} (${s.writable ? "read-write" : "read-only"})`)
+            .join("\n");
+    }
+    /**
+     * Register a project directory in the persistent project registry.
+     * Called by gnosys_init after creating a new store.
+     */
+    async registerProject(projectDir) {
+        const configPath = this.getRegistryPath();
+        let projects = [];
+        try {
+            const raw = await fs.readFile(configPath, "utf-8");
+            projects = JSON.parse(raw);
+        }
+        catch {
+            // File doesn't exist yet — that's fine
+        }
+        const resolved = path.resolve(projectDir);
+        if (!projects.includes(resolved)) {
+            projects.push(resolved);
+            await fs.mkdir(path.dirname(configPath), { recursive: true });
+            await fs.writeFile(configPath, JSON.stringify(projects, null, 2), "utf-8");
+        }
+    }
+    /**
+     * Directly add a project store to the active stores list.
+     * Used after gnosys_init creates a store, to avoid re-resolving from cwd.
+     */
+    async addProjectStore(storePath) {
+        // Remove any existing project store first
+        this.stores = this.stores.filter((s) => s.layer !== "project");
+        const store = new GnosysStore(storePath);
+        await store.init();
+        this.stores.unshift({
+            layer: "project",
+            label: "project",
+            store,
+            writable: true,
+            path: storePath,
+        });
+    }
+    /**
+     * Find a project store. Priority order:
+     *   1. Registered projects (~/.config/gnosys/projects.json)
+     *   2. MCP workspace roots (from roots/list)
+     *   3. Walk up from cwd (legacy fallback)
+     */
+    async findProjectStore() {
+        // 1. Check registered projects first — most reliable when MCP server
+        //    cwd doesn't match the editor's open project.
+        const registered = await this.getRegisteredProjects();
+        for (const projectDir of registered) {
+            const candidate = path.join(projectDir, ".gnosys");
+            if (await this.isValidStore(candidate)) {
+                return candidate;
+            }
+        }
+        // 2. Check MCP roots — workspace folders the host tells us about.
+        for (const rootPath of GnosysResolver.mcpRoots) {
+            const candidate = path.join(rootPath, ".gnosys");
+            if (await this.isValidStore(candidate)) {
+                return candidate;
+            }
+        }
+        // 3. Fallback: walk up from cwd (works when cwd matches the project)
+        let dir = path.resolve(process.cwd());
+        const root = path.parse(dir).root;
+        while (dir !== root) {
+            const candidate = path.join(dir, ".gnosys");
+            if (await this.isValidStore(candidate)) {
+                return candidate;
+            }
+            dir = path.dirname(dir);
+        }
+        return null;
+    }
+    /**
+     * Read registered project directories from persistent config.
+     */
+    async getRegisteredProjects() {
+        try {
+            const raw = await fs.readFile(this.getRegistryPath(), "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Path to the persistent project registry file.
+     */
+    getRegistryPath() {
+        const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+        return path.join(home, ".config", "gnosys", "projects.json");
+    }
+    /**
+     * Detect all available stores from all sources (registered, MCP roots, cwd, env vars).
+     * Returns a flat list for debugging. Does NOT modify the active stores.
+     */
+    async detectAllStores() {
+        const results = [];
+        const activePaths = new Set(this.stores.map((s) => s.path));
+        // Registered projects
+        const registered = await this.getRegisteredProjects();
+        for (const dir of registered) {
+            const storePath = path.join(dir, ".gnosys");
+            const has = await this.isValidStore(storePath);
+            results.push({ source: "registered", path: dir, hasGnosys: has, isActive: activePaths.has(storePath) });
+        }
+        // MCP roots
+        for (const rootPath of GnosysResolver.mcpRoots) {
+            const storePath = path.join(rootPath, ".gnosys");
+            const has = await this.isValidStore(storePath);
+            // Skip if already listed as registered
+            if (!results.some((r) => r.path === rootPath)) {
+                results.push({ source: "mcp-root", path: rootPath, hasGnosys: has, isActive: activePaths.has(storePath) });
+            }
+        }
+        // CWD
+        const cwd = process.cwd();
+        if (!results.some((r) => r.path === cwd)) {
+            const cwdStore = path.join(cwd, ".gnosys");
+            const has = await this.isValidStore(cwdStore);
+            results.push({ source: "cwd", path: cwd, hasGnosys: has, isActive: activePaths.has(cwdStore) });
+        }
+        // Env vars
+        if (process.env.GNOSYS_PERSONAL) {
+            results.push({ source: "env:GNOSYS_PERSONAL", path: process.env.GNOSYS_PERSONAL, hasGnosys: true, isActive: activePaths.has(process.env.GNOSYS_PERSONAL) });
+        }
+        if (process.env.GNOSYS_GLOBAL) {
+            results.push({ source: "env:GNOSYS_GLOBAL", path: process.env.GNOSYS_GLOBAL, hasGnosys: true, isActive: activePaths.has(process.env.GNOSYS_GLOBAL) });
+        }
+        return results;
+    }
+    /**
+     * Check if a path looks like a valid Gnosys store.
+     */
+    async isValidStore(storePath) {
+        try {
+            const stat = await fs.stat(storePath);
+            return stat.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/lib/resolver.js.map

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

package/dist/lib/retry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Gnosys Retry Logic — Exponential backoff for LLM calls and transient failures.
+ */
+export interface RetryOptions {
+    /** Max number of retry attempts (default: 3) */
+    maxAttempts: number;
+    /** Base delay in ms (default: 1000) */
+    baseDelayMs: number;
+    /** Whether to use exponential backoff (default: true) */
+    exponential: boolean;
+    /** Optional callback on each retry */
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+    /** Predicate to decide if error is retryable (default: all errors) */
+    isRetryable?: (error: Error) => boolean;
+}
+/**
+ * Default retryable-error check: retries on rate limits, timeouts, and transient server errors.
+ */
+export declare function isTransientError(error: Error): boolean;
+/**
+ * Execute an async function with retry logic.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: Partial<RetryOptions>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/lib/retry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,sEAAsE;IACtE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CACzC;AAQD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAWtD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CA8BZ"}

package/dist/lib/retry.js

@@ -0,0 +1,60 @@
+/**
+ * Gnosys Retry Logic — Exponential backoff for LLM calls and transient failures.
+ */
+const DEFAULT_RETRY = {
+    maxAttempts: 3,
+    baseDelayMs: 1000,
+    exponential: true,
+};
+/**
+ * Default retryable-error check: retries on rate limits, timeouts, and transient server errors.
+ */
+export function isTransientError(error) {
+    const msg = error.message.toLowerCase();
+    // Rate limit (429)
+    if (msg.includes("429") || msg.includes("rate limit") || msg.includes("too many requests"))
+        return true;
+    // Timeouts
+    if (msg.includes("timeout") || msg.includes("timed out") || msg.includes("econnreset"))
+        return true;
+    // Server errors (5xx)
+    if (msg.includes("500") || msg.includes("502") || msg.includes("503") || msg.includes("overloaded"))
+        return true;
+    // Network errors
+    if (msg.includes("enotfound") || msg.includes("econnrefused") || msg.includes("fetch failed"))
+        return true;
+    return false;
+}
+/**
+ * Execute an async function with retry logic.
+ */
+export async function withRetry(fn, options) {
+    const opts = { ...DEFAULT_RETRY, ...options };
+    const isRetryable = opts.isRetryable || isTransientError;
+    let lastError;
+    for (let attempt = 1; attempt <= opts.maxAttempts + 1; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            // Don't retry on non-retryable errors or after last attempt
+            if (attempt > opts.maxAttempts || !isRetryable(lastError)) {
+                throw lastError;
+            }
+            // Calculate delay with exponential backoff + jitter
+            const expDelay = opts.exponential
+                ? opts.baseDelayMs * Math.pow(2, attempt - 1)
+                : opts.baseDelayMs;
+            const jitter = Math.random() * opts.baseDelayMs * 0.5;
+            const delayMs = Math.round(expDelay + jitter);
+            opts.onRetry?.(attempt, lastError, delayMs);
+            await sleep(delayMs);
+        }
+    }
+    throw lastError || new Error("Retry exhausted");
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/lib/retry.js.map

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

package/dist/lib/rulesGen.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 { GnosysDB, DbMemory } from "./db.js";
+import { Preference } from "./preferences.js";
+export interface RulesGenResult {
+    /** The full file content after injection */
+    content: string;
+    /** Whether the file was created (true) or updated (false) */
+    created: boolean;
+    /** The rules file path */
+    filePath: string;
+    /** Number of preferences injected */
+    prefCount: number;
+    /** Number of project conventions injected */
+    conventionCount: number;
+}
+export type RulesFileFormat = "claude" | "cursor" | "generic";
+/**
+ * Generate the full GNOSYS block content from preferences and project conventions.
+ */
+export declare function generateRulesBlock(preferences: Preference[], projectConventions: DbMemory[], opts?: {
+    format?: RulesFileFormat;
+}): string;
+/**
+ * Inject generated rules into a file, preserving content outside GNOSYS blocks.
+ * Creates the file if it doesn't exist.
+ */
+export declare function injectRules(filePath: string, generatedBlock: string): Promise<{
+    created: boolean;
+}>;
+/**
+ * Sync rules for a project: reads preferences + project conventions from
+ * central DB, generates the rules block, and injects into the agent rules file.
+ */
+export declare function syncRules(centralDb: GnosysDB, projectDir: string, agentRulesTarget: string | null, projectId: string | null): Promise<RulesGenResult | null>;
+/**
+ * Remove the GNOSYS block from a rules file (cleanup).
+ */
+export declare function removeRulesBlock(filePath: string): Promise<boolean>;
+//# sourceMappingURL=rulesGen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rulesGen.d.ts","sourceRoot":"","sources":["../../src/lib/rulesGen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AAWjE,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAwB9D;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,UAAU,EAAE,EACzB,kBAAkB,EAAE,QAAQ,EAAE,EAC9B,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,eAAe,CAAA;CAAE,GAClC,MAAM,CA8BR;AAWD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAkC/B;AAID;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,QAAQ,EACnB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmChC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBzE"}