@planu/cli 0.30.0 → 0.31.0

package/dist/engine/orchestrator/topologies.js

@@ -0,0 +1,89 @@
+// orchestrator/topologies.ts — Topology strategy implementations (SPEC-079 AC-02)
+// Each topology defines planExecution() returning a DAG of execution nodes.
+/**
+ * Plan execution graph for mesh topology.
+ * All agents work in parallel — no dependencies between tasks.
+ * Results are reconciled at the end.
+ */
+export function planMeshExecution(tasks, agents) {
+    const agentIds = new Set(agents.map((a) => a.agentId));
+    const nodes = tasks
+        .filter((t) => agentIds.has(t.agentId))
+        .map((t) => ({
+        taskId: t.taskId,
+        agentId: t.agentId,
+        dependencies: [],
+        phase: 0,
+    }));
+    return { nodes, phases: nodes.length > 0 ? 1 : 0, topology: 'mesh' };
+}
+/**
+ * Plan execution graph for hierarchical topology.
+ * First agent is coordinator (phase 0), remaining are workers (phase 1).
+ * Workers depend on the coordinator task completing first.
+ */
+export function planHierarchicalExecution(tasks, agents) {
+    if (tasks.length === 0 || agents.length === 0) {
+        return { nodes: [], phases: 0, topology: 'hierarchical' };
+    }
+    const coordinatorTask = tasks[0];
+    const workerTasks = tasks.slice(1);
+    const nodes = [];
+    if (coordinatorTask) {
+        nodes.push({
+            taskId: coordinatorTask.taskId,
+            agentId: coordinatorTask.agentId,
+            dependencies: [],
+            phase: 0,
+        });
+    }
+    const coordId = coordinatorTask?.taskId ?? '';
+    for (const t of workerTasks) {
+        nodes.push({
+            taskId: t.taskId,
+            agentId: t.agentId,
+            dependencies: [coordId],
+            phase: 1,
+        });
+    }
+    return { nodes, phases: workerTasks.length > 0 ? 2 : 1, topology: 'hierarchical' };
+}
+/**
+ * Plan execution graph for pipeline topology.
+ * Tasks execute sequentially — each depends on the previous one.
+ */
+export function planPipelineExecution(tasks, _agents) {
+    const nodes = tasks.map((t, i) => ({
+        taskId: t.taskId,
+        agentId: t.agentId,
+        dependencies: i > 0 ? [tasks[i - 1]?.taskId ?? ''] : [],
+        phase: i,
+    }));
+    return { nodes, phases: tasks.length, topology: 'pipeline' };
+}
+/**
+ * Plan execution graph for star topology.
+ * First agent is the hub (phase 0), all others are spokes (phase 1).
+ * Spokes run in parallel but each depends on the hub.
+ */
+export function planStarExecution(tasks, agents) {
+    // Star is structurally similar to hierarchical but semantically different.
+    // Hub coordinates, spokes report only to hub (not to each other).
+    return planHierarchicalExecution(tasks, agents);
+}
+/** Topology planner registry. */
+const TOPOLOGY_PLANNERS = {
+    mesh: planMeshExecution,
+    hierarchical: planHierarchicalExecution,
+    pipeline: planPipelineExecution,
+    star: planStarExecution,
+};
+/**
+ * Plan execution for the given topology type.
+ * Delegates to the appropriate topology strategy.
+ */
+export function planExecution(topology, tasks, agents) {
+    const planner = TOPOLOGY_PLANNERS[topology];
+    return planner(tasks, agents);
+}
+//# sourceMappingURL=topologies.js.map

package/dist/engine/orchestrator/topologies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topologies.js","sourceRoot":"","sources":["../../../src/engine/orchestrator/topologies.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,4EAA4E;AAU5E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA8B,EAC9B,MAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAA2B,KAAK;SACxC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,YAAY,EAAE,EAAE;QAChB,KAAK,EAAE,CAAC;KACT,CAAC,CAAC,CAAC;IAEN,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAA8B,EAC9B,MAA6B;IAE7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,MAAM,KAAK,GAA2B,EAAE,CAAC;IAEzC,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC;YACT,MAAM,EAAE,eAAe,CAAC,MAAM;YAC9B,OAAO,EAAE,eAAe,CAAC,OAAO;YAChC,YAAY,EAAE,EAAE;YAChB,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,EAAE,MAAM,IAAI,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC;YACT,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,YAAY,EAAE,CAAC,OAAO,CAAC;YACvB,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;AACrF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAA8B,EAC9B,OAA8B;IAE9B,MAAM,KAAK,GAA2B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QACvD,KAAK,EAAE,CAAC;KACT,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA8B,EAC9B,MAA6B;IAE7B,2EAA2E;IAC3E,kEAAkE;IAClE,OAAO,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED,iCAAiC;AACjC,MAAM,iBAAiB,GAGnB;IACF,IAAI,EAAE,iBAAiB;IACvB,YAAY,EAAE,yBAAyB;IACvC,QAAQ,EAAE,qBAAqB;IAC/B,IAAI,EAAE,iBAAiB;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA6B,EAC7B,KAA8B,EAC9B,MAA6B;IAE7B,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { PluginRegistration, ParsedSemver } from '../../types/index.js';
+/**
+ * Parses a semver string like "1.2.3" into numeric components.
+ * Returns null if invalid.
+ */
+export declare function parseSemver(version: string): ParsedSemver | null;
+/**
+ * Evaluates a single semver condition like ">=1.2.0", "^1.2.0", "~1.2.0", "<2.0.0".
+ */
+export declare function evaluateCondition(condition: string, current: ParsedSemver): boolean;
+/**
+ * Checks if a version satisfies a semver range string.
+ * Supports: ^, ~, >=, >, <=, <, exact match, space-separated AND, || for OR.
+ */
+export declare function satisfiesRange(version: string, range: string): boolean;
+/**
+ * Checks if a plugin is compatible with the given Planu version.
+ */
+export declare function isPluginCompatible(planuVersionRange: string, currentVersion: string): boolean;
+/**
+ * Filters plugin registrations to only those compatible with the given version.
+ */
+export declare function getCompatiblePlugins(plugins: readonly PluginRegistration[], currentVersion: string): PluginRegistration[];
+//# sourceMappingURL=compatibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../../src/engine/plugins/compatibility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE7E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAmBhE;AAyED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CA2BnF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAYtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,iBAAiB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAE7F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,cAAc,EAAE,MAAM,GACrB,kBAAkB,EAAE,CAEtB"}

package/dist/engine/plugins/compatibility.js

@@ -0,0 +1,140 @@
+// engine/plugins/compatibility.ts — Semver range matching (SPEC-085 AC-13)
+/**
+ * Parses a semver string like "1.2.3" into numeric components.
+ * Returns null if invalid.
+ */
+export function parseSemver(version) {
+    const clean = version.replace(/^v/, '');
+    const parts = clean.split('.');
+    if (parts.length !== 3) {
+        return null;
+    }
+    const major = Number(parts[0]);
+    const minor = Number(parts[1]);
+    const patch = Number(parts[2]);
+    if (isNaN(major) || isNaN(minor) || isNaN(patch)) {
+        return null;
+    }
+    if (major < 0 || minor < 0 || patch < 0) {
+        return null;
+    }
+    return { major, minor, patch };
+}
+/**
+ * Compares two parsed versions.
+ * Returns -1 if a < b, 0 if a == b, 1 if a > b.
+ */
+function compareVersions(a, b) {
+    if (a.major !== b.major) {
+        return a.major < b.major ? -1 : 1;
+    }
+    if (a.minor !== b.minor) {
+        return a.minor < b.minor ? -1 : 1;
+    }
+    if (a.patch !== b.patch) {
+        return a.patch < b.patch ? -1 : 1;
+    }
+    return 0;
+}
+/** Parses the version from a prefixed condition and compares it. */
+function parseAndCompare(versionStr, current) {
+    const target = parseSemver(versionStr);
+    if (!target) {
+        return null;
+    }
+    return { target, cmp: compareVersions(current, target) };
+}
+/** Evaluates caret (^) condition: compatible with major version. */
+function evalCaret(versionStr, current) {
+    const result = parseAndCompare(versionStr, current);
+    if (!result) {
+        return false;
+    }
+    return current.major === result.target.major && result.cmp >= 0;
+}
+/** Evaluates tilde (~) condition: compatible with minor version. */
+function evalTilde(versionStr, current) {
+    const result = parseAndCompare(versionStr, current);
+    if (!result) {
+        return false;
+    }
+    return (current.major === result.target.major &&
+        current.minor === result.target.minor &&
+        result.cmp >= 0);
+}
+/** Evaluates a comparison operator condition. */
+function evalComparison(operator, versionStr, current) {
+    const result = parseAndCompare(versionStr, current);
+    if (!result) {
+        return false;
+    }
+    switch (operator) {
+        case '>=':
+            return result.cmp >= 0;
+        case '>':
+            return result.cmp > 0;
+        case '<=':
+            return result.cmp <= 0;
+        case '<':
+            return result.cmp < 0;
+        default:
+            return result.cmp === 0;
+    }
+}
+/**
+ * Evaluates a single semver condition like ">=1.2.0", "^1.2.0", "~1.2.0", "<2.0.0".
+ */
+export function evaluateCondition(condition, current) {
+    const trimmed = condition.trim();
+    if (!trimmed) {
+        return true;
+    }
+    if (trimmed.startsWith('^')) {
+        return evalCaret(trimmed.slice(1), current);
+    }
+    if (trimmed.startsWith('~')) {
+        return evalTilde(trimmed.slice(1), current);
+    }
+    if (trimmed.startsWith('>=')) {
+        return evalComparison('>=', trimmed.slice(2), current);
+    }
+    if (trimmed.startsWith('>')) {
+        return evalComparison('>', trimmed.slice(1), current);
+    }
+    if (trimmed.startsWith('<=')) {
+        return evalComparison('<=', trimmed.slice(2), current);
+    }
+    if (trimmed.startsWith('<')) {
+        return evalComparison('<', trimmed.slice(1), current);
+    }
+    const exactStr = trimmed.startsWith('=') ? trimmed.slice(1) : trimmed;
+    return evalComparison('=', exactStr, current);
+}
+/**
+ * Checks if a version satisfies a semver range string.
+ * Supports: ^, ~, >=, >, <=, <, exact match, space-separated AND, || for OR.
+ */
+export function satisfiesRange(version, range) {
+    const current = parseSemver(version);
+    if (!current) {
+        return false;
+    }
+    const orGroups = range.split('||').map((g) => g.trim());
+    return orGroups.some((group) => {
+        const conditions = group.split(/\s+/).filter(Boolean);
+        return conditions.every((cond) => evaluateCondition(cond, current));
+    });
+}
+/**
+ * Checks if a plugin is compatible with the given Planu version.
+ */
+export function isPluginCompatible(planuVersionRange, currentVersion) {
+    return satisfiesRange(currentVersion, planuVersionRange);
+}
+/**
+ * Filters plugin registrations to only those compatible with the given version.
+ */
+export function getCompatiblePlugins(plugins, currentVersion) {
+    return plugins.filter((p) => isPluginCompatible(p.manifest.planuVersion, currentVersion));
+}
+//# sourceMappingURL=compatibility.js.map

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

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

package/dist/engine/plugins/doc-generator.d.ts

@@ -0,0 +1,6 @@
+import type { PluginManifest, PluginModule } from '../../types/index.js';
+/**
+ * Generates Markdown documentation for a plugin based on its manifest and module.
+ */
+export declare function generatePluginDocs(manifest: PluginManifest, mod: PluginModule | undefined): string;
+//# sourceMappingURL=doc-generator.d.ts.map

package/dist/engine/plugins/doc-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/plugins/doc-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EAKb,MAAM,sBAAsB,CAAC;AAyE9B;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,YAAY,GAAG,SAAS,GAC5B,MAAM,CAqBR"}

package/dist/engine/plugins/doc-generator.js

@@ -0,0 +1,79 @@
+// engine/plugins/doc-generator.ts — Plugin documentation generator (SPEC-085 AC-14)
+function generateMetadataSection(manifest) {
+    return [
+        `# ${manifest.name}`,
+        '',
+        `> ${manifest.description}`,
+        '',
+        '## Metadata',
+        '',
+        `- **ID**: ${manifest.id}`,
+        `- **Version**: ${manifest.version}`,
+        `- **Author**: ${manifest.author}`,
+        `- **License**: ${manifest.license}`,
+        `- **Planu Version**: ${manifest.planuVersion}`,
+        `- **Permissions**: ${manifest.permissions.join(', ') || 'none'}`,
+        '',
+    ];
+}
+function generateToolsSection(tools) {
+    const lines = ['## Tools', ''];
+    for (const tool of tools) {
+        lines.push(`### ${tool.name}`, '', tool.description, '');
+        if (Object.keys(tool.inputSchema).length > 0) {
+            lines.push('**Input Schema:**', '```json', JSON.stringify(tool.inputSchema, null, 2), '```', '');
+        }
+    }
+    return lines;
+}
+function generateWorkersSection(workers) {
+    const lines = ['## Workers', ''];
+    for (const worker of workers) {
+        lines.push(`### ${worker.name}`, '', `- **Trigger**: ${worker.trigger}`);
+        if (worker.interval) {
+            lines.push(`- **Interval**: ${String(worker.interval)}ms`);
+        }
+        if (worker.eventName) {
+            lines.push(`- **Event**: ${worker.eventName}`);
+        }
+        lines.push('');
+    }
+    return lines;
+}
+function generateAnalyzersSection(analyzers) {
+    const lines = ['## Analyzers', ''];
+    for (const analyzer of analyzers) {
+        lines.push(`### ${analyzer.name}`, '', `- **File Patterns**: ${analyzer.filePatterns.join(', ')}`, '');
+    }
+    return lines;
+}
+function generateTemplatesSection(templates) {
+    const lines = ['## Templates', ''];
+    for (const template of templates) {
+        lines.push(`### ${template.name}`, '', `- **Domain**: ${template.domain}`, '');
+    }
+    return lines;
+}
+/**
+ * Generates Markdown documentation for a plugin based on its manifest and module.
+ */
+export function generatePluginDocs(manifest, mod) {
+    const lines = [...generateMetadataSection(manifest)];
+    if (mod?.tools && mod.tools.length > 0) {
+        lines.push(...generateToolsSection(mod.tools));
+    }
+    if (mod?.workers && mod.workers.length > 0) {
+        lines.push(...generateWorkersSection(mod.workers));
+    }
+    if (mod?.analyzers && mod.analyzers.length > 0) {
+        lines.push(...generateAnalyzersSection(mod.analyzers));
+    }
+    if (mod?.templates && mod.templates.length > 0) {
+        lines.push(...generateTemplatesSection(mod.templates));
+    }
+    if (manifest.i18n && Object.keys(manifest.i18n).length > 0) {
+        lines.push('## Supported Languages', '', Object.keys(manifest.i18n).join(', '), '');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=doc-generator.js.map

package/dist/engine/plugins/doc-generator.js.map

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

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

@@ -0,0 +1,26 @@
+import type { PluginAnalyzerDefinition, PluginAnalysisResult } from '../../../types/index.js';
+/**
+ * Registers analyzers from a plugin.
+ */
+export declare function registerPluginAnalyzers(pluginId: string, analyzers: readonly PluginAnalyzerDefinition[]): string[];
+/**
+ * Unregisters all analyzers belonging to a plugin.
+ */
+export declare function unregisterPluginAnalyzers(pluginId: string): string[];
+/**
+ * Runs all registered plugin analyzers against the given files.
+ * Results are tagged with [plugin:{pluginId}].
+ */
+export declare function runPluginAnalyzers(files: readonly string[]): Promise<{
+    pluginId: string;
+    results: PluginAnalysisResult[];
+}[]>;
+/**
+ * Returns the count of analyzers registered for a specific plugin.
+ */
+export declare function getPluginAnalyzerCount(pluginId: string): number;
+/**
+ * Clears all analyzer registrations (for testing).
+ */
+export declare function clearAnalyzerRegistry(): void;
+//# sourceMappingURL=analyzer-extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer-extension.d.ts","sourceRoot":"","sources":["../../../../src/engine/plugins/extensions/analyzer-extension.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EAErB,MAAM,yBAAyB,CAAC;AAUjC;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,wBAAwB,EAAE,GAC7C,MAAM,EAAE,CAeV;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAWpE;AAiBD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,oBAAoB,EAAE,CAAA;CAAE,EAAE,CAAC,CAoClE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

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

@@ -0,0 +1,100 @@
+// engine/plugins/extensions/analyzer-extension.ts — Analyzer registration (SPEC-085 AC-06)
+import { withPluginTimeout } from '../sandbox.js';
+/** Registry of plugin analyzers keyed by `{pluginId}:{analyzerName}` */
+const analyzerRegistry = new Map();
+function analyzerKey(pluginId, analyzerName) {
+    return `${pluginId}:${analyzerName}`;
+}
+/**
+ * Registers analyzers from a plugin.
+ */
+export function registerPluginAnalyzers(pluginId, analyzers) {
+    const registered = [];
+    for (const analyzer of analyzers) {
+        const key = analyzerKey(pluginId, analyzer.name);
+        if (analyzerRegistry.has(key)) {
+            throw new Error(`Analyzer "${analyzer.name}" already registered for plugin "${pluginId}"`);
+        }
+        analyzerRegistry.set(key, { pluginId, definition: analyzer });
+        registered.push(key);
+    }
+    return registered;
+}
+/**
+ * Unregisters all analyzers belonging to a plugin.
+ */
+export function unregisterPluginAnalyzers(pluginId) {
+    const removed = [];
+    for (const [key, entry] of analyzerRegistry) {
+        if (entry.pluginId === pluginId) {
+            analyzerRegistry.delete(key);
+            removed.push(key);
+        }
+    }
+    return removed;
+}
+/**
+ * Simple glob matching: supports * and ** wildcards.
+ * `**` matches any number of path segments (including zero).
+ * `*` matches anything except `/`.
+ */
+function matchGlob(pattern, filePath) {
+    const regexStr = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*\*\//g, '(?:.*/)?')
+        .replace(/\*\*/g, '.*')
+        .replace(/\*/g, '[^/]*');
+    const regex = new RegExp(`^${regexStr}$`);
+    return regex.test(filePath);
+}
+/**
+ * Runs all registered plugin analyzers against the given files.
+ * Results are tagged with [plugin:{pluginId}].
+ */
+export async function runPluginAnalyzers(files) {
+    const output = [];
+    for (const [, entry] of analyzerRegistry) {
+        const matchingFiles = files.filter((f) => entry.definition.filePatterns.some((pattern) => matchGlob(pattern, f)));
+        if (matchingFiles.length === 0) {
+            continue;
+        }
+        try {
+            const results = await withPluginTimeout(entry.pluginId, `analyzer:${entry.definition.name}`, () => entry.definition.analyze([...matchingFiles]));
+            output.push({ pluginId: entry.pluginId, results });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            output.push({
+                pluginId: entry.pluginId,
+                results: [
+                    {
+                        file: '',
+                        severity: 'error',
+                        message: `Analyzer error: ${msg}`,
+                        rule: `plugin:${entry.pluginId}:${entry.definition.name}`,
+                    },
+                ],
+            });
+        }
+    }
+    return output;
+}
+/**
+ * Returns the count of analyzers registered for a specific plugin.
+ */
+export function getPluginAnalyzerCount(pluginId) {
+    let count = 0;
+    for (const entry of analyzerRegistry.values()) {
+        if (entry.pluginId === pluginId) {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Clears all analyzer registrations (for testing).
+ */
+export function clearAnalyzerRegistry() {
+    analyzerRegistry.clear();
+}
+//# sourceMappingURL=analyzer-extension.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { PluginTemplateDefinition } from '../../../types/index.js';
+/**
+ * Registers templates from a plugin.
+ */
+export declare function registerPluginTemplates(pluginId: string, templates: readonly PluginTemplateDefinition[]): string[];
+/**
+ * Unregisters all templates belonging to a plugin.
+ */
+export declare function unregisterPluginTemplates(pluginId: string): string[];
+/**
+ * Returns all registered plugin templates, optionally filtered by domain.
+ */
+export declare function getPluginTemplates(domain?: string): {
+    pluginId: string;
+    template: PluginTemplateDefinition;
+}[];
+/**
+ * Returns the count of templates registered for a specific plugin.
+ */
+export declare function getPluginTemplateCount(pluginId: string): number;
+/**
+ * Clears all template registrations (for testing).
+ */
+export declare function clearTemplateRegistry(): void;
+//# sourceMappingURL=template-extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template-extension.d.ts","sourceRoot":"","sources":["../../../../src/engine/plugins/extensions/template-extension.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAA4B,MAAM,yBAAyB,CAAC;AASlG;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,wBAAwB,EAAE,GAC7C,MAAM,EAAE,CAeV;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAWpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,EAAE,CAU5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

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

@@ -0,0 +1,65 @@
+// engine/plugins/extensions/template-extension.ts — Template registration (SPEC-085 AC-07)
+/** Registry of plugin templates keyed by `{pluginId}:{templateName}` */
+const templateRegistry = new Map();
+function templateKey(pluginId, templateName) {
+    return `${pluginId}:${templateName}`;
+}
+/**
+ * Registers templates from a plugin.
+ */
+export function registerPluginTemplates(pluginId, templates) {
+    const registered = [];
+    for (const template of templates) {
+        const key = templateKey(pluginId, template.name);
+        if (templateRegistry.has(key)) {
+            throw new Error(`Template "${template.name}" already registered for plugin "${pluginId}"`);
+        }
+        templateRegistry.set(key, { pluginId, definition: template });
+        registered.push(key);
+    }
+    return registered;
+}
+/**
+ * Unregisters all templates belonging to a plugin.
+ */
+export function unregisterPluginTemplates(pluginId) {
+    const removed = [];
+    for (const [key, entry] of templateRegistry) {
+        if (entry.pluginId === pluginId) {
+            templateRegistry.delete(key);
+            removed.push(key);
+        }
+    }
+    return removed;
+}
+/**
+ * Returns all registered plugin templates, optionally filtered by domain.
+ */
+export function getPluginTemplates(domain) {
+    const results = [];
+    for (const entry of templateRegistry.values()) {
+        if (!domain || entry.definition.domain === domain) {
+            results.push({ pluginId: entry.pluginId, template: entry.definition });
+        }
+    }
+    return results;
+}
+/**
+ * Returns the count of templates registered for a specific plugin.
+ */
+export function getPluginTemplateCount(pluginId) {
+    let count = 0;
+    for (const entry of templateRegistry.values()) {
+        if (entry.pluginId === pluginId) {
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Clears all template registrations (for testing).
+ */
+export function clearTemplateRegistry() {
+    templateRegistry.clear();
+}
+//# sourceMappingURL=template-extension.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template-extension.js","sourceRoot":"","sources":["../../../../src/engine/plugins/extensions/template-extension.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAI3F,wEAAwE;AACxE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAoC,CAAC;AAErE,SAAS,WAAW,CAAC,QAAgB,EAAE,YAAoB;IACzD,OAAO,GAAG,QAAQ,IAAI,YAAY,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,SAA8C;IAE9C,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEjD,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,IAAI,oCAAoC,QAAQ,GAAG,CAAC,CAAC;QAC7F,CAAC;QAED,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9D,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,gBAAgB,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAe;IAEf,MAAM,OAAO,GAA+D,EAAE,CAAC;IAE/E,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9C,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChC,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,gBAAgB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC"}

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

@@ -0,0 +1,34 @@
+import type { PluginToolDefinition } from '../../../types/index.js';
+/**
+ * Builds the prefixed tool name for a plugin tool.
+ */
+export declare function buildPluginToolName(pluginId: string, toolName: string): string;
+/**
+ * Registers tools from a plugin. Each tool is prefixed with `plugin:{pluginId}:`.
+ * Returns the list of registered prefixed names.
+ */
+export declare function registerPluginTools(pluginId: string, tools: readonly PluginToolDefinition[], builtInTools: ReadonlySet<string>): string[];
+/**
+ * Unregisters all tools belonging to a plugin.
+ */
+export declare function unregisterPluginTools(pluginId: string): string[];
+/**
+ * Invokes a plugin tool by its prefixed name, with timeout wrapping.
+ */
+export declare function invokePluginTool(prefixedName: string, input: unknown, timeoutMs?: number): Promise<unknown>;
+/**
+ * Returns all registered plugin tools.
+ */
+export declare function getRegisteredPluginTools(): Map<string, {
+    pluginId: string;
+    definition: PluginToolDefinition;
+}>;
+/**
+ * Returns the count of tools registered for a specific plugin.
+ */
+export declare function getPluginToolCount(pluginId: string): number;
+/**
+ * Clears all plugin tools (for testing).
+ */
+export declare function clearPluginToolRegistry(): void;
+//# sourceMappingURL=tool-extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-extension.d.ts","sourceRoot":"","sources":["../../../../src/engine/plugins/extensions/tool-extension.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AASpE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,oBAAoB,EAAE,EACtC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,MAAM,EAAE,CAwBV;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAWhE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,OAAO,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,GAAG,CAC7C,MAAM,EACN;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,oBAAoB,CAAA;CAAE,CACvD,CAEA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}