@planu/cli 0.30.1 → 0.31.0

package/dist/engine/plugins/extensions/tool-extension.js

@@ -0,0 +1,80 @@
+// engine/plugins/extensions/tool-extension.ts — Tool registration (SPEC-085 AC-04)
+import { withPluginTimeout } from '../sandbox.js';
+/** Registry of plugin tools keyed by prefixed name */
+const pluginToolRegistry = new Map();
+/**
+ * Builds the prefixed tool name for a plugin tool.
+ */
+export function buildPluginToolName(pluginId, toolName) {
+    return `plugin:${pluginId}:${toolName}`;
+}
+/**
+ * Registers tools from a plugin. Each tool is prefixed with `plugin:{pluginId}:`.
+ * Returns the list of registered prefixed names.
+ */
+export function registerPluginTools(pluginId, tools, builtInTools) {
+    const registered = [];
+    for (const tool of tools) {
+        const prefixedName = buildPluginToolName(pluginId, tool.name);
+        if (builtInTools.has(tool.name)) {
+            throw new Error(`Plugin "${pluginId}" tool "${tool.name}" conflicts with built-in tool`);
+        }
+        if (pluginToolRegistry.has(prefixedName)) {
+            const existing = pluginToolRegistry.get(prefixedName);
+            if (existing && existing.pluginId !== pluginId) {
+                throw new Error(`Plugin "${pluginId}" tool "${tool.name}" conflicts with plugin "${existing.pluginId}"`);
+            }
+        }
+        pluginToolRegistry.set(prefixedName, { pluginId, definition: tool });
+        registered.push(prefixedName);
+    }
+    return registered;
+}
+/**
+ * Unregisters all tools belonging to a plugin.
+ */
+export function unregisterPluginTools(pluginId) {
+    const removed = [];
+    for (const [name, entry] of pluginToolRegistry) {
+        if (entry.pluginId === pluginId) {
+            pluginToolRegistry.delete(name);
+            removed.push(name);
+        }
+    }
+    return removed;
+}
+/**
+ * Invokes a plugin tool by its prefixed name, with timeout wrapping.
+ */
+export async function invokePluginTool(prefixedName, input, timeoutMs) {
+    const entry = pluginToolRegistry.get(prefixedName);
+    if (!entry) {
+        throw new Error(`Plugin tool "${prefixedName}" not found`);
+    }
+    return withPluginTimeout(entry.pluginId, `tool:${entry.definition.name}`, () => entry.definition.handler(input), timeoutMs);
+}
+/**
+ * Returns all registered plugin tools.
+ */
+export function getRegisteredPluginTools() {
+    return new Map(pluginToolRegistry);
+}
+/**
+ * Returns the count of tools registered for a specific plugin.
+ */
+export function getPluginToolCount(pluginId) {
+    let count = 0;
+    for (const entry of pluginToolRegistry.values()) {
+        if (entry.pluginId === pluginId) {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Clears all plugin tools (for testing).
+ */
+export function clearPluginToolRegistry() {
+    pluginToolRegistry.clear();
+}
+//# sourceMappingURL=tool-extension.js.map

package/dist/engine/plugins/extensions/tool-extension.js.map

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

package/dist/engine/plugins/extensions/worker-extension.d.ts

@@ -0,0 +1,24 @@
+import type { PluginWorkerDefinition } from '../../../types/index.js';
+/**
+ * Registers workers from a plugin.
+ * Cron workers start their interval immediately.
+ * Event and manual workers are registered for invocation.
+ */
+export declare function registerPluginWorkers(pluginId: string, workers: readonly PluginWorkerDefinition[]): string[];
+/**
+ * Unregisters all workers belonging to a plugin and cancels any active intervals.
+ */
+export declare function unregisterPluginWorkers(pluginId: string): string[];
+/**
+ * Invokes a manual worker by plugin ID and worker name.
+ */
+export declare function invokeManualWorker(pluginId: string, workerName: string): Promise<void>;
+/**
+ * Returns the count of workers registered for a specific plugin.
+ */
+export declare function getPluginWorkerCount(pluginId: string): number;
+/**
+ * Clears all workers and cancels intervals (for testing).
+ */
+export declare function clearWorkerRegistry(): void;
+//# sourceMappingURL=worker-extension.d.ts.map

package/dist/engine/plugins/extensions/worker-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-extension.d.ts","sourceRoot":"","sources":["../../../../src/engine/plugins/extensions/worker-extension.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAsB,MAAM,yBAAyB,CAAC;AAU1F;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,sBAAsB,EAAE,GACzC,MAAM,EAAE,CA6BV;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAclE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}

package/dist/engine/plugins/extensions/worker-extension.js

@@ -0,0 +1,88 @@
+// engine/plugins/extensions/worker-extension.ts — Worker registration (SPEC-085 AC-05)
+import { withPluginTimeout } from '../sandbox.js';
+/** Registry of plugin workers keyed by `{pluginId}:{workerName}` */
+const workerRegistry = new Map();
+function workerKey(pluginId, workerName) {
+    return `${pluginId}:${workerName}`;
+}
+/**
+ * Registers workers from a plugin.
+ * Cron workers start their interval immediately.
+ * Event and manual workers are registered for invocation.
+ */
+export function registerPluginWorkers(pluginId, workers) {
+    const registered = [];
+    for (const worker of workers) {
+        const key = workerKey(pluginId, worker.name);
+        if (workerRegistry.has(key)) {
+            throw new Error(`Worker "${worker.name}" already registered for plugin "${pluginId}"`);
+        }
+        const activeWorker = { pluginId, definition: worker };
+        // Start cron workers immediately
+        if (worker.trigger === 'cron' && worker.interval && worker.interval > 0) {
+            activeWorker.intervalHandle = setInterval(() => {
+                void withPluginTimeout(pluginId, `worker:${worker.name}`, worker.handler).catch((err) => {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(`[plugin:${pluginId}] Worker "${worker.name}" error: ${msg}`);
+                });
+            }, worker.interval);
+        }
+        workerRegistry.set(key, activeWorker);
+        registered.push(key);
+    }
+    return registered;
+}
+/**
+ * Unregisters all workers belonging to a plugin and cancels any active intervals.
+ */
+export function unregisterPluginWorkers(pluginId) {
+    const removed = [];
+    for (const [key, worker] of workerRegistry) {
+        if (worker.pluginId === pluginId) {
+            if (worker.intervalHandle) {
+                clearInterval(worker.intervalHandle);
+            }
+            workerRegistry.delete(key);
+            removed.push(key);
+        }
+    }
+    return removed;
+}
+/**
+ * Invokes a manual worker by plugin ID and worker name.
+ */
+export async function invokeManualWorker(pluginId, workerName) {
+    const key = workerKey(pluginId, workerName);
+    const worker = workerRegistry.get(key);
+    if (!worker) {
+        throw new Error(`Worker "${workerName}" not found for plugin "${pluginId}"`);
+    }
+    if (worker.definition.trigger !== 'manual') {
+        throw new Error(`Worker "${workerName}" is not a manual worker (trigger: ${worker.definition.trigger})`);
+    }
+    await withPluginTimeout(pluginId, `worker:${workerName}`, worker.definition.handler);
+}
+/**
+ * Returns the count of workers registered for a specific plugin.
+ */
+export function getPluginWorkerCount(pluginId) {
+    let count = 0;
+    for (const worker of workerRegistry.values()) {
+        if (worker.pluginId === pluginId) {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Clears all workers and cancels intervals (for testing).
+ */
+export function clearWorkerRegistry() {
+    for (const worker of workerRegistry.values()) {
+        if (worker.intervalHandle) {
+            clearInterval(worker.intervalHandle);
+        }
+    }
+    workerRegistry.clear();
+}
+//# sourceMappingURL=worker-extension.js.map

package/dist/engine/plugins/extensions/worker-extension.js.map

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

package/dist/engine/plugins/index.d.ts

@@ -0,0 +1,11 @@
+export { parseSemver, satisfiesRange, isPluginCompatible, getCompatiblePlugins, evaluateCondition, } from './compatibility.js';
+export { validateManifestStructure, validateToolConflicts, validateVersionCompatibility, validatePlugin, } from './validator.js';
+export { discoverPlugins, loadPluginModule, getPluginsDir } from './loader.js';
+export { installPlugin, activatePlugin, deactivatePlugin, uninstallPlugin, readPluginState, writePluginState, } from './lifecycle.js';
+export { createPluginContext, createPluginStorage, createPluginLogger, withPluginTimeout, } from './sandbox.js';
+export { generatePluginDocs } from './doc-generator.js';
+export { registerPluginTools, unregisterPluginTools, invokePluginTool, getRegisteredPluginTools, getPluginToolCount, buildPluginToolName, clearPluginToolRegistry, } from './extensions/tool-extension.js';
+export { registerPluginWorkers, unregisterPluginWorkers, invokeManualWorker, getPluginWorkerCount, clearWorkerRegistry, } from './extensions/worker-extension.js';
+export { registerPluginAnalyzers, unregisterPluginAnalyzers, runPluginAnalyzers, getPluginAnalyzerCount, clearAnalyzerRegistry, } from './extensions/analyzer-extension.js';
+export { registerPluginTemplates, unregisterPluginTemplates, getPluginTemplates, getPluginTemplateCount, clearTemplateRegistry, } from './extensions/template-extension.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/plugins/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,EAC5B,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC"}

package/dist/engine/plugins/index.js

@@ -0,0 +1,12 @@
+// engine/plugins/index.ts — Barrel re-export for plugin engine (SPEC-085)
+export { parseSemver, satisfiesRange, isPluginCompatible, getCompatiblePlugins, evaluateCondition, } from './compatibility.js';
+export { validateManifestStructure, validateToolConflicts, validateVersionCompatibility, validatePlugin, } from './validator.js';
+export { discoverPlugins, loadPluginModule, getPluginsDir } from './loader.js';
+export { installPlugin, activatePlugin, deactivatePlugin, uninstallPlugin, readPluginState, writePluginState, } from './lifecycle.js';
+export { createPluginContext, createPluginStorage, createPluginLogger, withPluginTimeout, } from './sandbox.js';
+export { generatePluginDocs } from './doc-generator.js';
+export { registerPluginTools, unregisterPluginTools, invokePluginTool, getRegisteredPluginTools, getPluginToolCount, buildPluginToolName, clearPluginToolRegistry, } from './extensions/tool-extension.js';
+export { registerPluginWorkers, unregisterPluginWorkers, invokeManualWorker, getPluginWorkerCount, clearWorkerRegistry, } from './extensions/worker-extension.js';
+export { registerPluginAnalyzers, unregisterPluginAnalyzers, runPluginAnalyzers, getPluginAnalyzerCount, clearAnalyzerRegistry, } from './extensions/analyzer-extension.js';
+export { registerPluginTemplates, unregisterPluginTemplates, getPluginTemplates, getPluginTemplateCount, clearTemplateRegistry, } from './extensions/template-extension.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/plugins/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,EACL,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,EAC5B,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oCAAoC,CAAC"}

package/dist/engine/plugins/lifecycle.d.ts

@@ -0,0 +1,26 @@
+import type { PluginRegistration, PluginStateFile } from '../../types/index.js';
+/**
+ * Reads plugin state from disk.
+ */
+export declare function readPluginState(dataDir: string): Promise<PluginStateFile>;
+/**
+ * Writes plugin state to disk.
+ */
+export declare function writePluginState(dataDir: string, state: PluginStateFile): Promise<void>;
+/**
+ * Installs a plugin by copying it to the plugins directory.
+ */
+export declare function installPlugin(sourcePath: string, projectPath: string, dataDir: string): Promise<PluginRegistration>;
+/**
+ * Activates a plugin: loads module, registers extensions, runs onActivate hook.
+ */
+export declare function activatePlugin(pluginId: string, projectPath: string, dataDir: string, builtInTools: ReadonlySet<string>): Promise<PluginRegistration>;
+/**
+ * Deactivates a plugin: unregisters extensions, runs onDeactivate hook.
+ */
+export declare function deactivatePlugin(pluginId: string, dataDir: string): Promise<PluginRegistration>;
+/**
+ * Uninstalls a plugin: deactivates if active, removes directory and state.
+ */
+export declare function uninstallPlugin(pluginId: string, projectPath: string, dataDir: string): Promise<void>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/engine/plugins/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/engine/plugins/lifecycle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAqB9F;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAO/E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7F;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CAwC7B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAqF7B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CA6B7B;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/engine/plugins/lifecycle.js

@@ -0,0 +1,208 @@
+// engine/plugins/lifecycle.ts — Plugin lifecycle management (SPEC-085 AC-03)
+import { cp, rm, readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getPluginsDir, loadPluginModule } from './loader.js';
+import { validateManifestStructure } from './validator.js';
+import { withPluginTimeout } from './sandbox.js';
+import { registerPluginTools, unregisterPluginTools } from './extensions/tool-extension.js';
+import { registerPluginWorkers, unregisterPluginWorkers } from './extensions/worker-extension.js';
+import { registerPluginAnalyzers, unregisterPluginAnalyzers, } from './extensions/analyzer-extension.js';
+import { registerPluginTemplates, unregisterPluginTemplates, } from './extensions/template-extension.js';
+const STATE_FILE = 'plugins-state.json';
+function stateFilePath(dataDir) {
+    return join(dataDir, 'global', STATE_FILE);
+}
+/**
+ * Reads plugin state from disk.
+ */
+export async function readPluginState(dataDir) {
+    try {
+        const raw = await readFile(stateFilePath(dataDir), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return { plugins: [], lastUpdated: new Date().toISOString() };
+    }
+}
+/**
+ * Writes plugin state to disk.
+ */
+export async function writePluginState(dataDir, state) {
+    const dir = join(dataDir, 'global');
+    await mkdir(dir, { recursive: true });
+    await writeFile(stateFilePath(dataDir), JSON.stringify(state, null, 2), 'utf8');
+}
+/**
+ * Installs a plugin by copying it to the plugins directory.
+ */
+export async function installPlugin(sourcePath, projectPath, dataDir) {
+    const pluginsDir = getPluginsDir(projectPath);
+    await mkdir(pluginsDir, { recursive: true });
+    // Read and validate manifest from source
+    const manifestRaw = await readFile(join(sourcePath, 'plugin.json'), 'utf8');
+    const manifest = JSON.parse(manifestRaw);
+    const validation = validateManifestStructure(manifest);
+    if (!validation.valid) {
+        throw new Error(`Invalid plugin manifest: ${validation.errors.join('; ')}`);
+    }
+    const typedManifest = manifest;
+    const targetDir = join(pluginsDir, typedManifest.id);
+    // Copy plugin to plugins directory
+    await cp(sourcePath, targetDir, { recursive: true });
+    const registration = {
+        manifest: manifest,
+        state: 'installed',
+        loadedAt: new Date().toISOString(),
+    };
+    // Persist state
+    const state = await readPluginState(dataDir);
+    const existing = state.plugins.findIndex((p) => p.manifest.id === typedManifest.id);
+    if (existing >= 0) {
+        state.plugins[existing] = registration;
+    }
+    else {
+        state.plugins.push(registration);
+    }
+    state.plugins = [...state.plugins]; // ensure fresh array
+    await writePluginState(dataDir, {
+        plugins: state.plugins,
+        lastUpdated: new Date().toISOString(),
+    });
+    return registration;
+}
+/**
+ * Activates a plugin: loads module, registers extensions, runs onActivate hook.
+ */
+export async function activatePlugin(pluginId, projectPath, dataDir, builtInTools) {
+    const state = await readPluginState(dataDir);
+    const regIndex = state.plugins.findIndex((p) => p.manifest.id === pluginId);
+    if (regIndex < 0) {
+        throw new Error(`Plugin "${pluginId}" is not installed`);
+    }
+    const reg = state.plugins[regIndex];
+    /* v8 ignore next 3 -- unreachable: findIndex already validated index */
+    if (!reg) {
+        throw new Error(`Plugin "${pluginId}" registration not found`);
+    }
+    if (reg.state === 'active') {
+        return reg;
+    }
+    let mod;
+    try {
+        mod = await loadPluginModule(projectPath, reg.manifest);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const errorReg = {
+            ...reg,
+            state: 'error',
+            error: message,
+        };
+        state.plugins[regIndex] = errorReg;
+        await writePluginState(dataDir, {
+            plugins: state.plugins,
+            lastUpdated: new Date().toISOString(),
+        });
+        return errorReg;
+    }
+    // Register extensions
+    try {
+        if (mod.tools) {
+            registerPluginTools(pluginId, mod.tools, builtInTools);
+        }
+        if (mod.workers) {
+            registerPluginWorkers(pluginId, mod.workers);
+        }
+        if (mod.analyzers) {
+            registerPluginAnalyzers(pluginId, mod.analyzers);
+        }
+        if (mod.templates) {
+            registerPluginTemplates(pluginId, mod.templates);
+        }
+        // Run onActivate hook
+        if (mod.hooks?.onActivate) {
+            await withPluginTimeout(pluginId, 'onActivate', mod.hooks.onActivate);
+        }
+    }
+    catch (err) {
+        // Rollback: unregister everything
+        unregisterPluginTools(pluginId);
+        unregisterPluginWorkers(pluginId);
+        unregisterPluginAnalyzers(pluginId);
+        unregisterPluginTemplates(pluginId);
+        const message = err instanceof Error ? err.message : String(err);
+        const errorReg = {
+            ...reg,
+            state: 'error',
+            error: message,
+        };
+        state.plugins[regIndex] = errorReg;
+        await writePluginState(dataDir, {
+            plugins: state.plugins,
+            lastUpdated: new Date().toISOString(),
+        });
+        return errorReg;
+    }
+    const activeReg = { ...reg, state: 'active' };
+    delete activeReg.error;
+    state.plugins[regIndex] = activeReg;
+    await writePluginState(dataDir, {
+        plugins: state.plugins,
+        lastUpdated: new Date().toISOString(),
+    });
+    return activeReg;
+}
+/**
+ * Deactivates a plugin: unregisters extensions, runs onDeactivate hook.
+ */
+export async function deactivatePlugin(pluginId, dataDir) {
+    const state = await readPluginState(dataDir);
+    const regIndex = state.plugins.findIndex((p) => p.manifest.id === pluginId);
+    if (regIndex < 0) {
+        throw new Error(`Plugin "${pluginId}" is not installed`);
+    }
+    const reg = state.plugins[regIndex];
+    /* v8 ignore next 3 -- unreachable: findIndex already validated index */
+    if (!reg) {
+        throw new Error(`Plugin "${pluginId}" registration not found`);
+    }
+    // Unregister all extensions
+    unregisterPluginTools(pluginId);
+    unregisterPluginWorkers(pluginId);
+    unregisterPluginAnalyzers(pluginId);
+    unregisterPluginTemplates(pluginId);
+    const inactiveReg = { ...reg, state: 'inactive' };
+    delete inactiveReg.error;
+    state.plugins[regIndex] = inactiveReg;
+    await writePluginState(dataDir, {
+        plugins: state.plugins,
+        lastUpdated: new Date().toISOString(),
+    });
+    return inactiveReg;
+}
+/**
+ * Uninstalls a plugin: deactivates if active, removes directory and state.
+ */
+export async function uninstallPlugin(pluginId, projectPath, dataDir) {
+    const state = await readPluginState(dataDir);
+    const regIndex = state.plugins.findIndex((p) => p.manifest.id === pluginId);
+    if (regIndex < 0) {
+        throw new Error(`Plugin "${pluginId}" is not installed`);
+    }
+    const reg = state.plugins[regIndex];
+    if (reg?.state === 'active') {
+        await deactivatePlugin(pluginId, dataDir);
+    }
+    // Remove plugin directory
+    const pluginsDir = getPluginsDir(projectPath);
+    const pluginDir = join(pluginsDir, pluginId);
+    await rm(pluginDir, { recursive: true, force: true });
+    // Remove from state
+    const updatedState = await readPluginState(dataDir);
+    updatedState.plugins = updatedState.plugins.filter((p) => p.manifest.id !== pluginId);
+    await writePluginState(dataDir, {
+        plugins: updatedState.plugins,
+        lastUpdated: new Date().toISOString(),
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/engine/plugins/lifecycle.js.map

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

package/dist/engine/plugins/loader.d.ts

@@ -0,0 +1,17 @@
+import type { PluginManifest, PluginRegistration, PluginModule } from '../../types/index.js';
+/**
+ * Returns the plugins directory path, honoring PLANU_PLUGINS_DIR env var.
+ */
+export declare function getPluginsDir(projectPath: string): string;
+/**
+ * Discovers plugins in the plugins directory.
+ * Reads plugin.json from each subdirectory and validates the manifest.
+ * Returns PluginRegistration[] with state 'installed' or 'error'.
+ */
+export declare function discoverPlugins(projectPath: string): Promise<PluginRegistration[]>;
+/**
+ * Dynamically imports a plugin's entry point module.
+ * Returns the module's exports or throws on failure.
+ */
+export declare function loadPluginModule(projectPath: string, manifest: PluginManifest): Promise<PluginModule>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/engine/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/engine/plugins/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAM7F;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyExF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,YAAY,CAAC,CAkBvB"}

package/dist/engine/plugins/loader.js

@@ -0,0 +1,113 @@
+// engine/plugins/loader.ts — Plugin discovery and loading (SPEC-085 AC-02)
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { validateManifestStructure } from './validator.js';
+const MANIFEST_FILENAME = 'plugin.json';
+const DEFAULT_PLUGINS_DIR = 'planu-plugins';
+/**
+ * Returns the plugins directory path, honoring PLANU_PLUGINS_DIR env var.
+ */
+export function getPluginsDir(projectPath) {
+    const envDir = process.env.PLANU_PLUGINS_DIR;
+    if (envDir) {
+        return resolve(envDir);
+    }
+    return join(projectPath, DEFAULT_PLUGINS_DIR);
+}
+/**
+ * Discovers plugins in the plugins directory.
+ * Reads plugin.json from each subdirectory and validates the manifest.
+ * Returns PluginRegistration[] with state 'installed' or 'error'.
+ */
+export async function discoverPlugins(projectPath) {
+    const pluginsDir = getPluginsDir(projectPath);
+    const registrations = [];
+    let entries;
+    try {
+        entries = await readdir(pluginsDir);
+    }
+    catch {
+        // Directory doesn't exist — no plugins
+        return [];
+    }
+    for (const entry of entries) {
+        const pluginDir = join(pluginsDir, entry);
+        try {
+            const stats = await stat(pluginDir);
+            if (!stats.isDirectory()) {
+                continue;
+            }
+            const manifestPath = join(pluginDir, MANIFEST_FILENAME);
+            const raw = await readFile(manifestPath, 'utf8');
+            const parsed = JSON.parse(raw);
+            const validation = validateManifestStructure(parsed);
+            if (!validation.valid) {
+                registrations.push({
+                    manifest: {
+                        id: entry,
+                        name: entry,
+                        version: '0.0.0',
+                        author: '',
+                        description: '',
+                        license: '',
+                        planuVersion: '*',
+                        entryPoint: '',
+                        permissions: [],
+                    },
+                    state: 'error',
+                    loadedAt: new Date().toISOString(),
+                    error: `Invalid manifest: ${validation.errors.join('; ')}`,
+                });
+                continue;
+            }
+            registrations.push({
+                manifest: parsed,
+                state: 'installed',
+                loadedAt: new Date().toISOString(),
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            registrations.push({
+                manifest: {
+                    id: entry,
+                    name: entry,
+                    version: '0.0.0',
+                    author: '',
+                    description: '',
+                    license: '',
+                    planuVersion: '*',
+                    entryPoint: '',
+                    permissions: [],
+                },
+                state: 'error',
+                loadedAt: new Date().toISOString(),
+                error: `Failed to load plugin: ${message}`,
+            });
+        }
+    }
+    return registrations;
+}
+/**
+ * Dynamically imports a plugin's entry point module.
+ * Returns the module's exports or throws on failure.
+ */
+export async function loadPluginModule(projectPath, manifest) {
+    const pluginsDir = getPluginsDir(projectPath);
+    const entryPath = join(pluginsDir, manifest.id, manifest.entryPoint);
+    // Validate entryPoint doesn't escape
+    const resolvedEntry = resolve(entryPath);
+    const resolvedPluginDir = resolve(join(pluginsDir, manifest.id));
+    if (!resolvedEntry.startsWith(resolvedPluginDir)) {
+        throw new Error(`Plugin "${manifest.id}" entryPoint escapes plugin directory`);
+    }
+    try {
+        const mod = (await import(resolvedEntry));
+        return mod;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to load plugin "${manifest.id}" module: ${message}`, { cause: err });
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/engine/plugins/loader.js.map

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