@aquex/cmos-mcp 1.0.0

package/dist/intelligence/project-registry.js

@@ -0,0 +1,484 @@
+"use strict";
+/**
+ * ProjectRegistry - Persistent registry for CMOS project paths
+ *
+ * Eliminates cross-project contamination by maintaining a registry of known
+ * CMOS projects. Used as fallback in resolveProjectRoot() when explicit
+ * path and env var are not available (e.g., Claude Desktop scenario).
+ *
+ * Registry persists to ~/.config/cmos-mcp/project-registry.json
+ *
+ * @module intelligence/project-registry
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectResolutionError = exports.ProjectRegistry = exports.CMOS_CONFIG_DIR_ENV = void 0;
+exports.resolveProjectRootEnhanced = resolveProjectRootEnhanced;
+exports.resolveProjectRootPath = resolveProjectRootPath;
+const fs_1 = require("fs");
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const fs_2 = require("../utils/fs");
+const cmos_detector_1 = require("./cmos-detector");
+/**
+ * Override the default `~/.config/cmos-mcp` config directory. When set (and
+ * no explicit `configDir` option is passed), the registry reads/writes here
+ * instead of the user's home-config path. Used by Jest globalSetup to keep
+ * test runs from polluting the real registry.
+ */
+exports.CMOS_CONFIG_DIR_ENV = 'CMOS_CONFIG_DIR';
+/**
+ * ProjectRegistry - Manages persistent registry of CMOS projects
+ *
+ * Usage:
+ * ```typescript
+ * const registry = await ProjectRegistry.create();
+ *
+ * // Register a project
+ * await registry.register('/path/to/project');
+ *
+ * // List all registered projects
+ * const projects = await registry.list();
+ *
+ * // Validate all projects
+ * const validations = await registry.validate();
+ *
+ * // Get default project
+ * const defaultProject = await registry.getDefault();
+ *
+ * // Set default project
+ * await registry.setDefault('/path/to/project');
+ * ```
+ */
+class ProjectRegistry {
+    constructor(options = {}) {
+        this.cache = null;
+        this.configDir =
+            options.configDir ??
+                process.env[exports.CMOS_CONFIG_DIR_ENV] ??
+                path_1.default.join(os_1.default.homedir(), '.config', 'cmos-mcp');
+        const registryFilename = options.registryFilename ?? 'project-registry.json';
+        this.registryPath = path_1.default.join(this.configDir, registryFilename);
+    }
+    /**
+     * Get singleton instance of ProjectRegistry
+     */
+    static getInstance(options) {
+        if (!ProjectRegistry.instance) {
+            ProjectRegistry.instance = new ProjectRegistry(options);
+        }
+        return ProjectRegistry.instance;
+    }
+    /**
+     * Reset singleton instance (for testing)
+     */
+    static resetInstance() {
+        ProjectRegistry.instance = undefined;
+    }
+    /**
+     * Create a new ProjectRegistry instance (async factory)
+     *
+     * Ensures config directory exists.
+     */
+    static async create(options) {
+        const registry = ProjectRegistry.getInstance(options);
+        await (0, fs_2.ensureDir)(registry.configDir);
+        return registry;
+    }
+    /**
+     * Get the registry file path
+     */
+    get path() {
+        return this.registryPath;
+    }
+    /**
+     * Register a project in the registry
+     *
+     * @param projectRoot - Absolute path to project root
+     * @param options - Optional registration options
+     * @returns Registration result
+     */
+    async register(projectRoot, options = {}) {
+        const resolvedPath = path_1.default.resolve(projectRoot);
+        // Verify the project has CMOS
+        const detector = cmos_detector_1.CmosDetector.getInstance();
+        const detection = await detector.detect(resolvedPath, { forceRefresh: true });
+        if (!detection.hasCmosDirectory || !detection.hasDatabase) {
+            return {
+                success: false,
+                message: `No CMOS database found at ${resolvedPath}. Ensure cmos/db/cmos.sqlite exists.`,
+            };
+        }
+        const registry = await this.loadRegistry();
+        const existing = registry.projects[resolvedPath];
+        const now = new Date().toISOString();
+        const project = {
+            projectRoot: resolvedPath,
+            name: options.name ?? existing?.name ?? path_1.default.basename(resolvedPath),
+            registeredAt: existing?.registeredAt ?? now,
+            lastAccessedAt: now,
+            metadata: options.metadata ?? existing?.metadata,
+        };
+        registry.projects[resolvedPath] = project;
+        registry.updatedAt = now;
+        if (options.setAsDefault) {
+            registry.defaultProject = resolvedPath;
+        }
+        await this.saveRegistry(registry);
+        return {
+            success: true,
+            project,
+            message: existing
+                ? `Updated project registration: ${project.name}`
+                : `Registered project: ${project.name}`,
+            wasAlreadyRegistered: !!existing,
+        };
+    }
+    /**
+     * Unregister a project from the registry
+     *
+     * @param projectRoot - Absolute path to project root
+     * @returns Unregistration result
+     */
+    async unregister(projectRoot) {
+        const resolvedPath = path_1.default.resolve(projectRoot);
+        const registry = await this.loadRegistry();
+        if (!registry.projects[resolvedPath]) {
+            return {
+                success: false,
+                message: `Project not found in registry: ${resolvedPath}`,
+            };
+        }
+        const wasDefault = registry.defaultProject === resolvedPath;
+        delete registry.projects[resolvedPath];
+        if (wasDefault) {
+            registry.defaultProject = undefined;
+        }
+        registry.updatedAt = new Date().toISOString();
+        await this.saveRegistry(registry);
+        return {
+            success: true,
+            message: `Unregistered project: ${resolvedPath}`,
+            wasDefault,
+        };
+    }
+    /**
+     * List all registered projects
+     *
+     * @returns Array of registered projects
+     */
+    async list() {
+        const registry = await this.loadRegistry();
+        return Object.values(registry.projects);
+    }
+    /**
+     * Get a specific project by path
+     *
+     * @param projectRoot - Absolute path to project root
+     * @returns The project if found, undefined otherwise
+     */
+    async getProject(projectRoot) {
+        const resolvedPath = path_1.default.resolve(projectRoot);
+        const registry = await this.loadRegistry();
+        return registry.projects[resolvedPath];
+    }
+    /**
+     * Get the default project
+     *
+     * @returns The default project if set, undefined otherwise
+     */
+    async getDefault() {
+        const registry = await this.loadRegistry();
+        if (!registry.defaultProject) {
+            return undefined;
+        }
+        return registry.projects[registry.defaultProject];
+    }
+    /**
+     * Set the default project
+     *
+     * @param projectRoot - Absolute path to project root (must be registered)
+     * @returns True if successful, false if project not registered
+     */
+    async setDefault(projectRoot) {
+        const resolvedPath = path_1.default.resolve(projectRoot);
+        const registry = await this.loadRegistry();
+        if (!registry.projects[resolvedPath]) {
+            return false;
+        }
+        registry.defaultProject = resolvedPath;
+        registry.updatedAt = new Date().toISOString();
+        await this.saveRegistry(registry);
+        return true;
+    }
+    /**
+     * Clear the default project
+     */
+    async clearDefault() {
+        const registry = await this.loadRegistry();
+        registry.defaultProject = undefined;
+        registry.updatedAt = new Date().toISOString();
+        await this.saveRegistry(registry);
+    }
+    /**
+     * Validate all registered projects
+     *
+     * Checks each project for:
+     * - Directory existence
+     * - CMOS database presence
+     *
+     * @returns Array of validation results
+     */
+    async validate() {
+        const registry = await this.loadRegistry();
+        const detector = cmos_detector_1.CmosDetector.getInstance();
+        const validations = [];
+        for (const project of Object.values(registry.projects)) {
+            const dirExists = await (0, fs_2.pathExists)(project.projectRoot);
+            if (!dirExists) {
+                validations.push({
+                    project,
+                    exists: false,
+                    hasCmosDatabase: false,
+                    status: 'missing',
+                    message: `Project directory does not exist: ${project.projectRoot}`,
+                });
+                continue;
+            }
+            const detection = await detector.detect(project.projectRoot, { forceRefresh: true });
+            if (!detection.hasCmosDirectory || !detection.hasDatabase) {
+                validations.push({
+                    project,
+                    exists: true,
+                    hasCmosDatabase: false,
+                    status: 'stale',
+                    message: `CMOS database no longer exists at: ${project.projectRoot}`,
+                });
+                continue;
+            }
+            validations.push({
+                project,
+                exists: true,
+                hasCmosDatabase: true,
+                status: 'active',
+                message: `Project is active: ${project.name ?? project.projectRoot}`,
+            });
+        }
+        return validations;
+    }
+    /**
+     * Remove stale and missing projects from registry
+     *
+     * @returns Number of projects removed
+     */
+    async prune() {
+        const validations = await this.validate();
+        const registry = await this.loadRegistry();
+        let removed = 0;
+        for (const validation of validations) {
+            if (validation.status !== 'active') {
+                delete registry.projects[validation.project.projectRoot];
+                if (registry.defaultProject === validation.project.projectRoot) {
+                    registry.defaultProject = undefined;
+                }
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            registry.updatedAt = new Date().toISOString();
+            await this.saveRegistry(registry);
+        }
+        return removed;
+    }
+    /**
+     * Update last accessed time for a project
+     *
+     * @param projectRoot - Absolute path to project root
+     */
+    async touch(projectRoot) {
+        const resolvedPath = path_1.default.resolve(projectRoot);
+        const registry = await this.loadRegistry();
+        if (registry.projects[resolvedPath]) {
+            registry.projects[resolvedPath].lastAccessedAt = new Date().toISOString();
+            registry.updatedAt = new Date().toISOString();
+            await this.saveRegistry(registry);
+        }
+    }
+    /**
+     * Clear the in-memory cache (for testing)
+     */
+    clearCache() {
+        this.cache = null;
+    }
+    /**
+     * Load registry from disk
+     */
+    async loadRegistry() {
+        if (this.cache) {
+            return this.cache;
+        }
+        try {
+            const exists = await (0, fs_2.pathExists)(this.registryPath);
+            if (!exists) {
+                this.cache = this.createEmptyRegistry();
+                return this.cache;
+            }
+            const content = await fs_1.promises.readFile(this.registryPath, 'utf-8');
+            const data = JSON.parse(content);
+            // Validate structure
+            if (!data.version || !data.projects) {
+                this.cache = this.createEmptyRegistry();
+                return this.cache;
+            }
+            this.cache = data;
+            return this.cache;
+        }
+        catch {
+            // If file is corrupted, start fresh
+            this.cache = this.createEmptyRegistry();
+            return this.cache;
+        }
+    }
+    /**
+     * Save registry to disk
+     */
+    async saveRegistry(registry) {
+        this.cache = registry;
+        await (0, fs_2.ensureDir)(this.configDir);
+        const content = JSON.stringify(registry, null, 2);
+        await (0, fs_2.writeFileAtomic)(this.registryPath, content, { mode: 0o600 });
+    }
+    /**
+     * Create empty registry structure
+     */
+    createEmptyRegistry() {
+        return {
+            version: 1,
+            projects: {},
+            updatedAt: new Date().toISOString(),
+        };
+    }
+}
+exports.ProjectRegistry = ProjectRegistry;
+/**
+ * Error thrown when project resolution fails
+ */
+class ProjectResolutionError extends Error {
+    constructor(message, suggestion) {
+        super(message);
+        this.suggestion = suggestion;
+        this.name = 'ProjectResolutionError';
+    }
+}
+exports.ProjectResolutionError = ProjectResolutionError;
+/**
+ * Resolve project root with a 4-step priority chain.
+ *
+ * Priority:
+ * 1. Explicit parameter
+ * 2. Auto-discover from cwd (detect cmos/db/cmos.sqlite)
+ * 3. Registry fallback (default project)
+ * 4. Error with actionable guidance
+ *
+ * @deprecated Use `resolveSenderContext` from `src/intelligence/sender-context.ts`
+ *   for any dispatcher or dashboard-bound call site. This function remains
+ *   available for direct `CmosDatabaseClient.create` fallbacks and for tests,
+ *   but should not be called from tool dispatchers. Sprint 53 m02 removed the
+ *   former Step 2 (`CMOS_PROJECT_ROOT` env var) because it was the structural
+ *   source of cross-project mis-attribution (Sprint 32 / 52 / 53 P0s).
+ *
+ * @param explicitRoot - Explicitly provided project root
+ * @param options - Resolution options
+ * @returns Resolution result with source and path
+ * @throws ProjectResolutionError if no project can be resolved
+ */
+async function resolveProjectRootEnhanced(explicitRoot, options = {}) {
+    const { autoRegister = true, silent = false } = options;
+    // Step 1: Explicit parameter
+    if (explicitRoot) {
+        const resolvedPath = path_1.default.resolve(explicitRoot);
+        return {
+            projectRoot: resolvedPath,
+            source: 'explicit',
+            message: `Using explicitly provided project root: ${resolvedPath}`,
+        };
+    }
+    // Step 2 (removed): CMOS_PROJECT_ROOT env-var fallback. See Sprint 53 m02
+    // rationale in the function docblock. The env var is still read at
+    // `src/index.ts:17` for .env bootstrap but is never consulted here.
+    // Step 3: Auto-discover from cwd
+    const cwd = process.cwd();
+    const detector = cmos_detector_1.CmosDetector.getInstance();
+    const detection = await detector.detect(cwd);
+    if (detection.hasCmosDirectory && detection.hasDatabase) {
+        const result = {
+            projectRoot: cwd,
+            source: 'auto-discover',
+            message: `Auto-discovered CMOS project at: ${cwd}`,
+        };
+        // Auto-register if enabled
+        if (autoRegister) {
+            try {
+                const registry = await ProjectRegistry.create();
+                const existing = await registry.getProject(cwd);
+                if (!existing) {
+                    await registry.register(cwd);
+                    result.autoRegistered = true;
+                    if (!silent) {
+                        console.error(`[CMOS] Auto-registered project: ${cwd}`);
+                    }
+                }
+                else {
+                    await registry.touch(cwd);
+                }
+            }
+            catch {
+                // Ignore registry errors during auto-discovery
+            }
+        }
+        return result;
+    }
+    // Step 4: Registry fallback
+    try {
+        const registry = await ProjectRegistry.create();
+        const defaultProject = await registry.getDefault();
+        if (defaultProject) {
+            // Verify the default project still has CMOS
+            const defaultDetection = await detector.detect(defaultProject.projectRoot, {
+                forceRefresh: true,
+            });
+            if (defaultDetection.hasCmosDirectory && defaultDetection.hasDatabase) {
+                await registry.touch(defaultProject.projectRoot);
+                return {
+                    projectRoot: defaultProject.projectRoot,
+                    source: 'registry',
+                    message: `Using default project from registry: ${defaultProject.name ?? defaultProject.projectRoot}`,
+                };
+            }
+        }
+    }
+    catch {
+        // Ignore registry errors
+    }
+    // Step 4: Error with actionable guidance
+    throw new ProjectResolutionError('No CMOS project found. Could not resolve project root.', `Options:
+  1. Run from a directory containing cmos/db/cmos.sqlite
+  2. Provide projectRoot parameter explicitly
+  3. Register a default project: cmos_project_register(path, setAsDefault=true)`);
+}
+/**
+ * Backward-compatible wrapper that returns just the path
+ *
+ * For existing code that expects a string return type.
+ *
+ * @param explicitRoot - Explicitly provided project root
+ * @returns Resolved project root path
+ * @throws ProjectResolutionError if no project can be resolved
+ */
+async function resolveProjectRootPath(explicitRoot) {
+    const result = await resolveProjectRootEnhanced(explicitRoot);
+    return result.projectRoot;
+}
+//# sourceMappingURL=project-registry.js.map

package/dist/intelligence/project-registry.js.map

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

package/dist/intelligence/rsip-loop.d.ts

@@ -0,0 +1,52 @@
+export type RSIPStopReason = 'disabled' | 'converged' | 'max_iterations' | 'error';
+export interface RSIPLoopOptions {
+    readonly enabled?: boolean;
+    readonly maxIterations?: number;
+    readonly minIterations?: number;
+    readonly convergenceThreshold?: number;
+    readonly stagnationLimit?: number;
+    readonly telemetrySource?: string;
+    readonly clock?: () => Date;
+}
+export interface RSIPIterationContext<TState> {
+    readonly iteration: number;
+    readonly state: TState | undefined;
+    readonly history: ReadonlyArray<RSIPIterationResult<TState>>;
+}
+export interface RSIPIterationResult<TState> {
+    readonly state: TState;
+    readonly improvementScore: number;
+    readonly summary?: string;
+    readonly telemetry?: Record<string, unknown>;
+    readonly converged?: boolean;
+}
+export interface RSIPLoopHandlers<TState> {
+    initialize?: () => Promise<TState> | TState;
+    iterate: (context: RSIPIterationContext<TState>) => Promise<RSIPIterationResult<TState>>;
+    finalize?: (summary: RSIPLoopSummary<TState>) => Promise<void> | void;
+}
+export interface RSIPLoopSummary<TState> {
+    readonly startedAt: string;
+    readonly completedAt: string;
+    readonly iterations: ReadonlyArray<RSIPIterationResult<TState>>;
+    readonly converged: boolean;
+    readonly reason: RSIPStopReason;
+    readonly finalState: TState | undefined;
+    readonly error?: Error;
+}
+interface NormalizedOptions {
+    enabled: boolean;
+    maxIterations: number;
+    minIterations: number;
+    convergenceThreshold: number;
+    stagnationLimit: number;
+    telemetrySource: string;
+    clock: () => Date;
+}
+declare function normalizeOptions(options?: RSIPLoopOptions): NormalizedOptions;
+export declare function runRSIPLoop<TState>(handlers: RSIPLoopHandlers<TState>, options?: RSIPLoopOptions): Promise<RSIPLoopSummary<TState>>;
+export declare const __test__: {
+    normalizeOptions: typeof normalizeOptions;
+};
+export {};
+//# sourceMappingURL=rsip-loop.d.ts.map

package/dist/intelligence/rsip-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rsip-loop.d.ts","sourceRoot":"","sources":["../../src/intelligence/rsip-loop.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB,CAAC,MAAM;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,mBAAmB,CAAC,MAAM;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB,CAAC,MAAM;IACtC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IACzF,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvE;AAED,MAAM,WAAW,eAAe,CAAC,MAAM;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAYD,iBAAS,gBAAgB,CAAC,OAAO,GAAE,eAAoB,GAAG,iBAAiB,CAgB1E;AAED,wBAAsB,WAAW,CAAC,MAAM,EACtC,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAClC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAqHlC;AAED,eAAO,MAAM,QAAQ;;CAEpB,CAAC"}