@hivehub/rulebook 4.1.0 → 4.2.0

package/dist/core/workspace/legacy-migrator.js

@@ -0,0 +1,142 @@
+/**
+ * Legacy MCP Config Migrator
+ *
+ * Finds and migrates .mcp.json files that contain absolute --project-root
+ * paths. Converts them to simplified args that rely on the MCP server's
+ * built-in cwd walk-up discovery (`findRulebookConfig(process.cwd())`).
+ */
+import { isAbsolute } from 'path';
+import { fileExists, readFile, writeFile } from '../../utils/file-system.js';
+import { glob } from 'glob';
+/** The simplified args that replace any legacy --project-root variant. */
+const SIMPLIFIED_ARGS = ['-y', '@hivehub/rulebook@latest', 'mcp-server'];
+/**
+ * Find and migrate .mcp.json files that contain absolute --project-root paths.
+ * Converts to simplified args without --project-root (relies on cwd walk-up).
+ */
+export async function migrateLegacyMcpConfigs(searchRoot) {
+    const result = {
+        migratedFiles: [],
+        skippedFiles: [],
+        errors: [],
+    };
+    let files;
+    try {
+        files = await glob('**/.mcp.json', {
+            cwd: searchRoot,
+            absolute: true,
+            ignore: ['**/node_modules/**', '**/dist/**', '**/.git/**'],
+        });
+    }
+    catch (err) {
+        result.errors.push(`Failed to search for .mcp.json files: ${String(err)}`);
+        return result;
+    }
+    for (const filePath of files) {
+        try {
+            const hasLegacy = await hasLegacyAbsolutePaths(filePath);
+            if (!hasLegacy) {
+                result.skippedFiles.push(filePath);
+                continue;
+            }
+            const migrated = await migrateMcpJson(filePath);
+            if (migrated) {
+                result.migratedFiles.push(filePath);
+            }
+            else {
+                result.skippedFiles.push(filePath);
+            }
+        }
+        catch (err) {
+            result.errors.push(`${filePath}: ${String(err)}`);
+        }
+    }
+    return result;
+}
+/**
+ * Check if a .mcp.json file has legacy absolute --project-root args
+ * in any rulebook server entry.
+ */
+export async function hasLegacyAbsolutePaths(mcpJsonPath) {
+    if (!(await fileExists(mcpJsonPath))) {
+        return false;
+    }
+    let config;
+    try {
+        const raw = await readFile(mcpJsonPath);
+        config = JSON.parse(raw);
+    }
+    catch {
+        return false;
+    }
+    if (!config.mcpServers) {
+        return false;
+    }
+    for (const [key, entry] of Object.entries(config.mcpServers)) {
+        if (!isRulebookEntry(key))
+            continue;
+        if (!entry?.args)
+            continue;
+        const prIdx = entry.args.indexOf('--project-root');
+        if (prIdx === -1)
+            continue;
+        const value = entry.args[prIdx + 1];
+        if (value && isAbsolute(value)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Migrate a single .mcp.json: remove --project-root from rulebook entries.
+ * Creates a .mcp.json.bak backup before modifying.
+ * Returns true if the file was modified, false if no changes were needed.
+ */
+export async function migrateMcpJson(mcpJsonPath) {
+    if (!(await fileExists(mcpJsonPath))) {
+        return false;
+    }
+    let config;
+    try {
+        const raw = await readFile(mcpJsonPath);
+        config = JSON.parse(raw);
+    }
+    catch {
+        return false;
+    }
+    if (!config.mcpServers) {
+        return false;
+    }
+    let modified = false;
+    for (const [key, entry] of Object.entries(config.mcpServers)) {
+        if (!isRulebookEntry(key))
+            continue;
+        if (!entry?.args)
+            continue;
+        const prIdx = entry.args.indexOf('--project-root');
+        if (prIdx === -1)
+            continue;
+        const value = entry.args[prIdx + 1];
+        if (value && isAbsolute(value)) {
+            entry.args = SIMPLIFIED_ARGS;
+            modified = true;
+        }
+    }
+    if (!modified) {
+        return false;
+    }
+    // Create backup before writing
+    const backupPath = mcpJsonPath + '.bak';
+    const originalContent = await readFile(mcpJsonPath);
+    await writeFile(backupPath, originalContent);
+    await writeFile(mcpJsonPath, JSON.stringify(config, null, 2) + '\n');
+    return true;
+}
+/**
+ * Returns true if the mcpServers key looks like a rulebook entry
+ * (e.g. "rulebook", "rulebook-memory", "rulebook-tasks").
+ */
+function isRulebookEntry(key) {
+    return key === 'rulebook' || key.startsWith('rulebook-');
+}
+//# sourceMappingURL=legacy-migrator.js.map

package/dist/core/workspace/legacy-migrator.js.map

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

package/dist/core/workspace/project-worker.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ProjectWorker -- Encapsulates all per-project managers.
+ *
+ * Lazy-initialized: managers are created on first access.
+ * Tracks idle time for lifecycle management.
+ */
+import { TaskManager } from '../task-manager.js';
+import { ConfigManager } from '../config-manager.js';
+import { SkillsManager } from '../skills-manager.js';
+import type { RulebookConfig } from '../../types.js';
+export declare class ProjectWorker {
+    readonly projectId: string;
+    readonly projectRoot: string;
+    private taskManager;
+    private configManager;
+    private skillsManager;
+    private memoryManager;
+    private bgIndexer;
+    private _lastAccessedAt;
+    private _initialized;
+    private _rulebookConfig;
+    constructor(projectId: string, projectRoot: string);
+    /** Whether initialize() has completed successfully. */
+    get initialized(): boolean;
+    /** Timestamp of the last access to any getter or touch(). */
+    get lastAccessedAt(): number;
+    /** Update the last-accessed timestamp to now. */
+    touch(): void;
+    /** Returns true if the worker has been idle longer than `timeoutMs`. */
+    isIdle(timeoutMs: number): boolean;
+    /**
+     * Initialize all per-project managers.
+     * Idempotent -- subsequent calls are no-ops.
+     */
+    initialize(): Promise<void>;
+    /** Gracefully shut down all managers and release resources. */
+    shutdown(): Promise<void>;
+    /** Returns the TaskManager for this project. Throws if not initialized. */
+    getTaskManager(): TaskManager;
+    /** Returns the MemoryManager, or null if memory is disabled. */
+    getMemoryManager(): typeof this.memoryManager;
+    /** Returns the SkillsManager for this project. Throws if not initialized. */
+    getSkillsManager(): SkillsManager;
+    /** Returns the ConfigManager for this project. Throws if not initialized. */
+    getConfigManager(): ConfigManager;
+    /** Returns the loaded RulebookConfig, or null if not initialized. */
+    getRulebookConfig(): RulebookConfig | null;
+}
+//# sourceMappingURL=project-worker.d.ts.map

package/dist/core/workspace/project-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-worker.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/project-worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAA2B,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,qBAAa,aAAa;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,aAAa,CAEL;IAChB,OAAO,CAAC,SAAS,CAAiC;IAElD,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAA+B;gBAE1C,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKlD,uDAAuD;IACvD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,6DAA6D;IAC7D,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,iDAAiD;IACjD,KAAK,IAAI,IAAI;IAIb,wEAAwE;IACxE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBjC,+DAA+D;IACzD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,2EAA2E;IAC3E,cAAc,IAAI,WAAW;IAM7B,gEAAgE;IAChE,gBAAgB,IAAI,OAAO,IAAI,CAAC,aAAa;IAK7C,6EAA6E;IAC7E,gBAAgB,IAAI,aAAa;IAMjC,6EAA6E;IAC7E,gBAAgB,IAAI,aAAa;IAMjC,qEAAqE;IACrE,iBAAiB,IAAI,cAAc,GAAG,IAAI;CAG3C"}

package/dist/core/workspace/project-worker.js

@@ -0,0 +1,108 @@
+/**
+ * ProjectWorker -- Encapsulates all per-project managers.
+ *
+ * Lazy-initialized: managers are created on first access.
+ * Tracks idle time for lifecycle management.
+ */
+import { TaskManager } from '../task-manager.js';
+import { ConfigManager } from '../config-manager.js';
+import { SkillsManager, getDefaultTemplatesPath } from '../skills-manager.js';
+export class ProjectWorker {
+    projectId;
+    projectRoot;
+    taskManager = null;
+    configManager = null;
+    skillsManager = null;
+    memoryManager = null;
+    bgIndexer = null;
+    _lastAccessedAt = Date.now();
+    _initialized = false;
+    _rulebookConfig = null;
+    constructor(projectId, projectRoot) {
+        this.projectId = projectId;
+        this.projectRoot = projectRoot;
+    }
+    /** Whether initialize() has completed successfully. */
+    get initialized() {
+        return this._initialized;
+    }
+    /** Timestamp of the last access to any getter or touch(). */
+    get lastAccessedAt() {
+        return this._lastAccessedAt;
+    }
+    /** Update the last-accessed timestamp to now. */
+    touch() {
+        this._lastAccessedAt = Date.now();
+    }
+    /** Returns true if the worker has been idle longer than `timeoutMs`. */
+    isIdle(timeoutMs) {
+        return Date.now() - this._lastAccessedAt > timeoutMs;
+    }
+    /**
+     * Initialize all per-project managers.
+     * Idempotent -- subsequent calls are no-ops.
+     */
+    async initialize() {
+        if (this._initialized)
+            return;
+        this.configManager = new ConfigManager(this.projectRoot);
+        this._rulebookConfig = await this.configManager.loadConfig();
+        this.taskManager = new TaskManager(this.projectRoot, '.rulebook');
+        this.skillsManager = new SkillsManager(getDefaultTemplatesPath(), this.projectRoot);
+        // Lazy-load memory if enabled in project config
+        if (this._rulebookConfig.memory?.enabled) {
+            try {
+                const { createMemoryManager } = await import('../../memory/memory-manager.js');
+                this.memoryManager = createMemoryManager(this.projectRoot, this._rulebookConfig.memory);
+            }
+            catch {
+                // Memory init failures are non-fatal
+            }
+        }
+        this._initialized = true;
+        this.touch();
+    }
+    /** Gracefully shut down all managers and release resources. */
+    async shutdown() {
+        if (this.bgIndexer) {
+            this.bgIndexer.stop();
+            this.bgIndexer = null;
+        }
+        if (this.memoryManager) {
+            await this.memoryManager.close();
+            this.memoryManager = null;
+        }
+        this._initialized = false;
+    }
+    /** Returns the TaskManager for this project. Throws if not initialized. */
+    getTaskManager() {
+        this.touch();
+        if (!this.taskManager)
+            throw new Error(`Worker ${this.projectId} not initialized`);
+        return this.taskManager;
+    }
+    /** Returns the MemoryManager, or null if memory is disabled. */
+    getMemoryManager() {
+        this.touch();
+        return this.memoryManager;
+    }
+    /** Returns the SkillsManager for this project. Throws if not initialized. */
+    getSkillsManager() {
+        this.touch();
+        if (!this.skillsManager)
+            throw new Error(`Worker ${this.projectId} not initialized`);
+        return this.skillsManager;
+    }
+    /** Returns the ConfigManager for this project. Throws if not initialized. */
+    getConfigManager() {
+        this.touch();
+        if (!this.configManager)
+            throw new Error(`Worker ${this.projectId} not initialized`);
+        return this.configManager;
+    }
+    /** Returns the loaded RulebookConfig, or null if not initialized. */
+    getRulebookConfig() {
+        return this._rulebookConfig;
+    }
+}
+//# sourceMappingURL=project-worker.js.map

package/dist/core/workspace/project-worker.js.map

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

package/dist/core/workspace/workspace-manager.d.ts

@@ -0,0 +1,90 @@
+/**
+ * WorkspaceManager — Orchestrates multi-project workspace.
+ *
+ * Manages ProjectWorker lifecycle (spawn on-demand, kill idle),
+ * discovers workspace config from multiple sources, and provides
+ * cross-project operations (memory search, task listing).
+ */
+import { ProjectWorker } from './project-worker.js';
+import type { WorkspaceConfig, WorkspaceProject, WorkspaceStatus } from './workspace-types.js';
+export declare class WorkspaceManager {
+    private workers;
+    private config;
+    private workspaceRoot;
+    private idleCheckInterval;
+    constructor(config: WorkspaceConfig, workspaceRoot: string);
+    /** Start the idle-check timer. */
+    startIdleChecker(): void;
+    /** Stop the idle-check timer. */
+    stopIdleChecker(): void;
+    /**
+     * Get (or spawn) a worker for the given project.
+     * Initializes lazily on first access.
+     */
+    getWorker(projectId: string): Promise<ProjectWorker>;
+    /** Spawn and initialize a new worker for the given project. */
+    spawnWorker(projectId: string): Promise<ProjectWorker>;
+    /** Shut down workers that have been idle longer than the configured timeout. */
+    killIdleWorkers(): Promise<string[]>;
+    /** Gracefully shut down all workers and stop the idle checker. */
+    shutdownAll(): Promise<void>;
+    getConfig(): WorkspaceConfig;
+    getProjects(): WorkspaceProject[];
+    getDefaultProjectId(): string;
+    getActiveWorkerIds(): string[];
+    getWorkspaceRoot(): string;
+    /** Build a status snapshot of the entire workspace. */
+    getStatus(): Promise<WorkspaceStatus>;
+    /**
+     * Search memory across all active workers.
+     * Returns results tagged with project name.
+     */
+    searchMemoryAcrossProjects(query: string, options?: {
+        limit?: number;
+        type?: string;
+    }): Promise<Array<{
+        project: string;
+        results: unknown[];
+    }>>;
+    /**
+     * Discovery chain (priority order):
+     * 1. .rulebook-workspace.json
+     * 2. *.code-workspace (VSCode format)
+     * 3. Monorepo detection (pnpm/turbo/nx/lerna)
+     * Returns null if no workspace found.
+     */
+    static findWorkspaceConfig(startDir: string): WorkspaceConfig | null;
+    /** Find a *.code-workspace file in the given directory. */
+    private static findCodeWorkspaceFile;
+    /**
+     * Parse a VSCode .code-workspace file into WorkspaceConfig.
+     * Format: { "folders": [{ "path": "." }, { "path": "../frontend" }] }
+     */
+    static fromCodeWorkspace(filePath: string, workspaceRoot?: string): WorkspaceConfig | null;
+    /**
+     * Detect monorepo structure and build WorkspaceConfig.
+     * Checks: pnpm-workspace.yaml, turbo.json, nx.json, lerna.json
+     */
+    static fromMonorepo(dir: string): WorkspaceConfig | null;
+    /** Build config from monorepo by scanning packages/ and apps/ directories. */
+    private static buildMonorepoConfig;
+    /**
+     * Walk up from `startDir` to find a workspace root directory.
+     * Returns `{ config, root }` or null if no workspace found.
+     */
+    static findWorkspaceFromCwd(startDir: string): {
+        config: WorkspaceConfig;
+        root: string;
+    } | null;
+    /**
+     * Given a cwd, find the workspace and determine which project the cwd belongs to.
+     * Matches by checking if the cwd starts with the resolved project path.
+     * Returns `{ config, root, projectName }` or null.
+     */
+    static resolveProjectFromCwd(cwd: string): {
+        config: WorkspaceConfig;
+        root: string;
+        projectName: string;
+    } | null;
+}
+//# sourceMappingURL=workspace-manager.d.ts.map

package/dist/core/workspace/workspace-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manager.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/workspace-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAK/F,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAA+C;gBAE5D,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM;IAK1D,kCAAkC;IAClC,gBAAgB,IAAI,IAAI;IAUxB,iCAAiC;IACjC,eAAe,IAAI,IAAI;IASvB;;;OAGG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAS1D,+DAA+D;IACzD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkB5D,gFAAgF;IAC1E,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAc1C,kEAAkE;IAC5D,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAUlC,SAAS,IAAI,eAAe;IAI5B,WAAW,IAAI,gBAAgB,EAAE;IAIjC,mBAAmB,IAAI,MAAM;IAI7B,kBAAkB,IAAI,MAAM,EAAE;IAI9B,gBAAgB,IAAI,MAAM;IAI1B,uDAAuD;IACjD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAyC3C;;;OAGG;IACG,0BAA0B,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IAyB1D;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAuBpE,2DAA2D;IAC3D,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAUpC;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IA0B1F;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAyBxD,8EAA8E;IAC9E,OAAO,CAAC,MAAM,CAAC,mBAAmB;IA2ClC;;;OAGG;IACH,MAAM,CAAC,oBAAoB,CACzB,QAAQ,EAAE,MAAM,GACf;QAAE,MAAM,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgBnD;;;;OAIG;IACH,MAAM,CAAC,qBAAqB,CAC1B,GAAG,EAAE,MAAM,GACV;QAAE,MAAM,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAwBzE"}