@planu/cli 1.3.0 → 1.5.0

package/dist/tools/docs-registry-handler.js

@@ -0,0 +1,73 @@
+import { checkRegistryHealth, discoverDocsUrl, } from '../engine/web-fetcher/registry-auto-discovery.js';
+import { loadDocsRegistry } from '../engine/web-fetcher/registry-loader.js';
+/** Flatten all docs-registry categories into a single { key: base-url } map. */
+async function flattenRegistryUrls() {
+    const registry = await loadDocsRegistry();
+    const result = new Map();
+    for (const [key, entry] of Object.entries(registry.frameworks)) {
+        result.set(key, entry.base);
+    }
+    for (const [key, entry] of Object.entries(registry.languages)) {
+        result.set(key, entry.base);
+    }
+    for (const [key, entry] of Object.entries(registry.services)) {
+        result.set(key, entry.base);
+    }
+    return result;
+}
+/** Handle validate_docs_registry tool call. */
+export async function handleValidateDocsRegistry(_input) {
+    const urlMap = await flattenRegistryUrls();
+    const entries = {};
+    for (const [key, base] of urlMap.entries()) {
+        entries[key] = { base };
+    }
+    const total = urlMap.size;
+    const health = await checkRegistryHealth(entries);
+    const lines = [
+        `Docs registry health check complete.`,
+        `Total entries: ${total}`,
+        `Healthy: ${health.healthy.length}`,
+        `Slow (>2s): ${health.slow.length}`,
+        `Broken: ${health.broken.length}`,
+    ];
+    if (health.broken.length > 0) {
+        lines.push(`\nBroken entries:\n${health.broken.map((b) => `  - ${b}`).join('\n')}`);
+    }
+    if (health.slow.length > 0) {
+        lines.push(`\nSlow entries:\n${health.slow.map((s) => `  - ${s}`).join('\n')}`);
+    }
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        total,
+        healthy: health.healthy.length,
+        broken: health.broken.map((key) => ({ key, url: urlMap.get(key) ?? '' })),
+        slowMs: health.slow.map((key) => ({ key, url: urlMap.get(key) ?? '' })),
+    };
+}
+/** Handle discover_docs_url tool call. */
+export async function handleDiscoverDocsUrl(input) {
+    const { tech } = input;
+    const entry = await discoverDocsUrl(tech);
+    if (!entry) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No docs URL found for "${tech}" in npm, PyPI, or crates.io registries.`,
+                },
+            ],
+        };
+    }
+    const verifiedLabel = entry.verified ? 'verified alive' : 'unverified';
+    const text = [
+        `Found docs for "${tech}" via ${entry.source} (${verifiedLabel}):`,
+        `  URL: ${entry.docsUrl}`,
+        `  Discovered at: ${entry.discoveredAt}`,
+    ].join('\n');
+    return {
+        content: [{ type: 'text', text }],
+        entry,
+    };
+}
+//# sourceMappingURL=docs-registry-handler.js.map

package/dist/tools/docs-registry-handler.js.map

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

package/dist/tools/dogfood-status-handler.d.ts

@@ -0,0 +1,3 @@
+import type { ToolResult, DogfoodStatusInput } from '../types/index.js';
+export declare function handleDogfoodStatus(input: DogfoodStatusInput): ToolResult;
+//# sourceMappingURL=dogfood-status-handler.d.ts.map

package/dist/tools/dogfood-status-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dogfood-status-handler.d.ts","sourceRoot":"","sources":["../../src/tools/dogfood-status-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAOxE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU,CA2BzE"}

package/dist/tools/dogfood-status-handler.js

@@ -0,0 +1,28 @@
+import { getRecentCommitMessages, detectToolUsageFromMessages, buildDogfoodReport, } from '../engine/dogfood-analyzer.js';
+export function handleDogfoodStatus(input) {
+    const sinceDays = input.since
+        ? Math.ceil((Date.now() - new Date(input.since).getTime()) / 86400000)
+        : 30;
+    const period = `Last ${String(sinceDays)} days`;
+    const messages = getRecentCommitMessages(input.projectPath, sinceDays);
+    const usedTools = detectToolUsageFromMessages(messages);
+    const report = buildDogfoodReport(usedTools, period, messages);
+    const lines = [
+        `## Planu Dogfood Status — ${report.period}`,
+        `**Score**: ${String(report.dogfoodScore)}/100`,
+        `**Tools used**: ${report.usedTools.join(', ') || 'none'}`,
+        `**Missing**: ${report.missingTools.join(', ') || 'none'}`,
+        '',
+        `### Metrics`,
+        `- Specs created: ${String(report.metrics.specCreated)}`,
+        `- Specs validated: ${String(report.metrics.specValidated)}`,
+        `- Specs challenged: ${String(report.metrics.specChallenged)}`,
+        `- Readiness checked: ${String(report.metrics.readinessChecked)}`,
+        `- Status updates: ${String(report.metrics.statusUpdated)}`,
+        '',
+        `### Recommendation`,
+        report.recommendation,
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+//# sourceMappingURL=dogfood-status-handler.js.map

package/dist/tools/dogfood-status-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dogfood-status-handler.js","sourceRoot":"","sources":["../../src/tools/dogfood-status-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK;QAC3B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC;QACtE,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,MAAM,GAAG,QAAQ,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC;IAChD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE/D,MAAM,KAAK,GAAG;QACZ,6BAA6B,MAAM,CAAC,MAAM,EAAE;QAC5C,cAAc,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM;QAC/C,mBAAmB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QAC1D,gBAAgB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QAC1D,EAAE;QACF,aAAa;QACb,oBAAoB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE;QACxD,sBAAsB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;QAC5D,uBAAuB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE;QAC9D,wBAAwB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE;QACjE,qBAAqB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;QAC3D,EAAE;QACF,oBAAoB;QACpB,MAAM,CAAC,cAAc;KACtB,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/tools/drift-watcher-handler.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult, WatchSpecDriftInput } from '../types/index.js';
+/**
+ * Handle the watch_spec_drift tool invocation.
+ * Routes to start/stop/status based on the action field.
+ */
+export declare function handleWatchSpecDrift(input: WatchSpecDriftInput): Promise<ToolResult>;
+//# sourceMappingURL=drift-watcher-handler.d.ts.map

package/dist/tools/drift-watcher-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-watcher-handler.d.ts","sourceRoot":"","sources":["../../src/tools/drift-watcher-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAKzE;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+D1F"}

package/dist/tools/drift-watcher-handler.js

@@ -0,0 +1,65 @@
+import { hashProjectPath } from '../storage/base-store.js';
+import { listSpecs } from '../storage/spec-store.js';
+import { startWatcher, stopWatcher, getWatcherState } from '../engine/drift-watcher/index.js';
+/**
+ * Handle the watch_spec_drift tool invocation.
+ * Routes to start/stop/status based on the action field.
+ */
+export async function handleWatchSpecDrift(input) {
+    const { projectPath, specId, action } = input;
+    if (action === 'status') {
+        const state = getWatcherState(specId);
+        if (!state) {
+            return {
+                content: [{ type: 'text', text: `No active watcher for spec ${specId}.` }],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(state, null, 2),
+                },
+            ],
+        };
+    }
+    if (action === 'stop') {
+        const stopped = stopWatcher(specId);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: stopped
+                        ? `Watcher stopped for spec ${specId}.`
+                        : `No active watcher found for spec ${specId}.`,
+                },
+            ],
+        };
+    }
+    // action === 'start'
+    const projectId = hashProjectPath(projectPath);
+    const specs = await listSpecs(projectId);
+    const spec = specs.find((s) => s.id === specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: `Spec ${specId} not found in project ${projectPath}.` }],
+        };
+    }
+    const specPath = spec.specPath;
+    const watchedPaths = [projectPath];
+    const state = startWatcher({
+        specId,
+        projectPath,
+        specPath,
+        watchedPaths,
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(state, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=drift-watcher-handler.js.map

package/dist/tools/drift-watcher-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-watcher-handler.js","sourceRoot":"","sources":["../../src/tools/drift-watcher-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAE9F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAA0B;IACnE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAE9C,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,MAAM,GAAG,EAAE,CAAC;aAC3E,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO;wBACX,CAAC,CAAC,4BAA4B,MAAM,GAAG;wBACvC,CAAC,CAAC,oCAAoC,MAAM,GAAG;iBAClD;aACF;SACF,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAEhD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,MAAM,yBAAyB,WAAW,GAAG,EAAE,CAAC;SACzF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,MAAM,YAAY,GAAG,CAAC,WAAW,CAAC,CAAC;IAEnC,MAAM,KAAK,GAAG,YAAY,CAAC;QACzB,MAAM;QACN,WAAW;QACX,QAAQ;QACR,YAAY;KACb,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;aACrC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/export-audit-trail-handler.d.ts

@@ -0,0 +1,9 @@
+import type { ToolResult } from '../types/index.js';
+import type { AuditTrailExportInput } from '../types/audit.js';
+/**
+ * Handle export_audit_trail tool invocation.
+ * Reads the global audit trail, applies filters, verifies chain integrity,
+ * and returns formatted output in the requested format.
+ */
+export declare function handleExportAuditTrail(input: AuditTrailExportInput): ToolResult;
+//# sourceMappingURL=export-audit-trail-handler.d.ts.map

package/dist/tools/export-audit-trail-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-audit-trail-handler.d.ts","sourceRoot":"","sources":["../../src/tools/export-audit-trail-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AA4E3B;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU,CAuC/E"}

package/dist/tools/export-audit-trail-handler.js

@@ -0,0 +1,103 @@
+// tools/export-audit-trail-handler.ts — Handler for export_audit_trail tool (SPEC-387)
+import { readEntries } from '../storage/audit-trail-store.js';
+import { verifyChain } from '../engine/audit-trail/hasher.js';
+import { formatSuccess, toolResult } from './response-helpers.js';
+// ---------------------------------------------------------------------------
+// Formatters
+// ---------------------------------------------------------------------------
+function formatJson(entries) {
+    return JSON.stringify(entries, null, 2);
+}
+function formatJsonLd(entries) {
+    const graph = entries.map((e) => ({
+        '@type': 'prov:Activity',
+        '@id': `urn:planu:audit:${e.id}`,
+        'prov:startedAtTime': e.timestamp,
+        'prov:endedAtTime': e.timestamp,
+        'planu:toolName': e.toolName,
+        'planu:inputSummary': e.inputSummary,
+        'planu:outputType': e.outputType,
+        'planu:durationMs': e.durationMs,
+        'planu:hash': e.hash,
+        'planu:prevHash': e.prevHash,
+        ...(e.specId !== undefined ? { 'planu:specId': e.specId } : {}),
+        ...(e.projectPath !== undefined ? { 'planu:projectPath': e.projectPath } : {}),
+    }));
+    const doc = {
+        '@context': {
+            prov: 'http://www.w3.org/ns/prov#',
+            planu: 'https://planu.dev/vocab#',
+        },
+        '@graph': graph,
+    };
+    return JSON.stringify(doc, null, 2);
+}
+function formatCsv(entries) {
+    const header = 'id,timestamp,toolName,outputType,durationMs,specId,projectPath,hash,prevHash,inputSummary';
+    const rows = entries.map((e) => {
+        const cols = [
+            e.id,
+            e.timestamp,
+            e.toolName,
+            e.outputType,
+            String(e.durationMs),
+            e.specId ?? '',
+            e.projectPath ?? '',
+            e.hash,
+            e.prevHash,
+            `"${e.inputSummary.replace(/"/g, '""')}"`,
+        ];
+        return cols.join(',');
+    });
+    return [header, ...rows].join('\n');
+}
+function renderFormat(format, entries) {
+    switch (format) {
+        case 'json':
+            return formatJson(entries);
+        case 'json-ld':
+            return formatJsonLd(entries);
+        case 'csv':
+            return formatCsv(entries);
+    }
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+/**
+ * Handle export_audit_trail tool invocation.
+ * Reads the global audit trail, applies filters, verifies chain integrity,
+ * and returns formatted output in the requested format.
+ */
+export function handleExportAuditTrail(input) {
+    const format = input.format ?? 'json';
+    const allEntries = readEntries({
+        fromDate: input.fromDate,
+        toDate: input.toDate,
+        specId: input.specId,
+        projectPath: input.projectPath,
+        limit: input.limit,
+    });
+    // Verify chain on the full unfiltered set for accurate integrity reporting
+    const fullEntries = readEntries();
+    const integrityValid = verifyChain(fullEntries);
+    const formatted = renderFormat(format, allEntries);
+    const exportedAt = new Date().toISOString();
+    const result = {
+        entries: allEntries,
+        totalCount: allEntries.length,
+        format,
+        exportedAt,
+        integrityValid,
+    };
+    const summary = [
+        `Audit Trail Export — SPEC-387 (EU AI Act Article 12)`,
+        `Entries: ${String(allEntries.length)} | Format: ${format}`,
+        `Chain integrity: ${integrityValid ? 'VALID' : 'BROKEN'}`,
+        `Exported at: ${exportedAt}`,
+        '',
+        formatted,
+    ].join('\n');
+    return toolResult(formatSuccess('Audit Trail Export', summary), result);
+}
+//# sourceMappingURL=export-audit-trail-handler.js.map

package/dist/tools/export-audit-trail-handler.js.map

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

package/dist/tools/mcp-gateway-handler.d.ts

@@ -0,0 +1,13 @@
+import type { ToolResult } from '../types/index.js';
+import type { DiscoverMcpGatewaysInput, FederationDiscoveryStatusInput } from '../types/mcp-gateway.js';
+/**
+ * Handle discover_mcp_gateways tool call.
+ * Runs a discovery pass and returns a summary of found gateways.
+ */
+export declare function handleDiscoverMcpGateways(input: DiscoverMcpGatewaysInput): Promise<ToolResult>;
+/**
+ * Handle federation_discovery_status tool call.
+ * Returns all known gateways from the registry with their current status.
+ */
+export declare function handleFederationDiscoveryStatus(input: FederationDiscoveryStatusInput): Promise<ToolResult>;
+//# sourceMappingURL=mcp-gateway-handler.d.ts.map

package/dist/tools/mcp-gateway-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-gateway-handler.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-gateway-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,wBAAwB,EACxB,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AAGjC;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,UAAU,CAAC,CA0BrB;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,UAAU,CAAC,CAiCrB"}

package/dist/tools/mcp-gateway-handler.js

@@ -0,0 +1,60 @@
+import { discoverGateways, getGatewayStatus } from '../engine/mcp-gateway/index.js';
+/**
+ * Handle discover_mcp_gateways tool call.
+ * Runs a discovery pass and returns a summary of found gateways.
+ */
+export async function handleDiscoverMcpGateways(input) {
+    const { urls = [], includeLocalhost = true } = input;
+    const found = await discoverGateways(urls, includeLocalhost);
+    if (found.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'No MCP gateways discovered. Make sure target servers expose /.well-known/mcp.',
+                },
+            ],
+        };
+    }
+    const lines = [`Discovered ${found.length} MCP gateway(s):`, ''];
+    for (const gw of found) {
+        const compat = gw.planuCompatible ? ' [Planu-compatible]' : '';
+        lines.push(`  ${gw.name} (${gw.url})${compat}`);
+        if (gw.tools.length > 0) {
+            lines.push(`    Tools: ${gw.tools.join(', ')}`);
+        }
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+/**
+ * Handle federation_discovery_status tool call.
+ * Returns all known gateways from the registry with their current status.
+ */
+export async function handleFederationDiscoveryStatus(input) {
+    // projectPath is required by the tool schema but the registry is global
+    void input.projectPath;
+    const { registry, active } = await getGatewayStatus();
+    const all = registry.gateways;
+    if (all.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'No gateways in registry. Run discover_mcp_gateways to start discovery.',
+                },
+            ],
+        };
+    }
+    const lines = [`Gateway registry: ${all.length} known, ${active.length} active`];
+    if (registry.lastDiscoveryAt) {
+        lines.push(`Last discovery: ${registry.lastDiscoveryAt}`);
+    }
+    lines.push('');
+    for (const gw of all) {
+        const compat = gw.planuCompatible ? ' [Planu]' : '';
+        lines.push(`  [${gw.status}] ${gw.name} (${gw.url})${compat}`);
+        lines.push(`    Last seen: ${gw.lastSeenAt}`);
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+//# sourceMappingURL=mcp-gateway-handler.js.map

package/dist/tools/mcp-gateway-handler.js.map

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

package/dist/tools/multi-repo-handler.d.ts

@@ -0,0 +1,15 @@
+import type { ToolResult } from '../types/index.js';
+import type { CoordinateRefactorInput, SyncRefactorStatusInput } from '../types/multi-repo.js';
+/**
+ * Initiate a multi-repo refactor session.
+ * 1. Loads the source spec to verify it exists.
+ * 2. Discovers all registered projects (excluding source).
+ * 3. Scans each project for symbol usage.
+ * 4. Persists a RefactorSession and returns summary.
+ */
+export declare function handleCoordinateRefactor(input: CoordinateRefactorInput): Promise<ToolResult>;
+/**
+ * Returns the current progress report for a refactor session.
+ */
+export declare function handleSyncRefactorStatus(input: SyncRefactorStatusInput): Promise<ToolResult>;
+//# sourceMappingURL=multi-repo-handler.d.ts.map

package/dist/tools/multi-repo-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-repo-handler.d.ts","sourceRoot":"","sources":["../../src/tools/multi-repo-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EAGxB,MAAM,wBAAwB,CAAC;AAehC;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAoDrB;AAMD;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAqBrB"}

package/dist/tools/multi-repo-handler.js

@@ -0,0 +1,86 @@
+// tools/multi-repo-handler.ts — SPEC-389: Handlers for multi-repo refactoring coordination
+import { randomUUID } from 'node:crypto';
+import { hashProjectPath } from '../storage/base-store.js';
+import { getSpec } from '../storage/spec-store.js';
+import { createSession, getSession } from '../storage/refactor-registry-store.js';
+import { scanProjectForSymbols, getRegisteredProjectPaths, buildStatusReport, } from '../engine/multi-repo/index.js';
+import { textResult, errText } from './response-helpers.js';
+// ---------------------------------------------------------------------------
+// coordinate_refactor
+// ---------------------------------------------------------------------------
+/**
+ * Initiate a multi-repo refactor session.
+ * 1. Loads the source spec to verify it exists.
+ * 2. Discovers all registered projects (excluding source).
+ * 3. Scans each project for symbol usage.
+ * 4. Persists a RefactorSession and returns summary.
+ */
+export async function handleCoordinateRefactor(input) {
+    const { projectPath, specId, affectedSymbols } = input;
+    if (affectedSymbols.length === 0) {
+        return errText('affectedSymbols must contain at least one symbol name.');
+    }
+    const projectId = hashProjectPath(projectPath);
+    const spec = await getSpec(projectId, specId);
+    if (!spec) {
+        return errText(`Spec "${specId}" not found in project "${projectPath}".`);
+    }
+    const consumerPaths = await getRegisteredProjectPaths(projectPath);
+    const consumerProjects = [];
+    for (const consumerPath of consumerPaths) {
+        const usageLocations = await scanProjectForSymbols(consumerPath, affectedSymbols);
+        if (usageLocations.length > 0) {
+            consumerProjects.push({
+                projectPath: consumerPath,
+                projectId: hashProjectPath(consumerPath),
+                usageLocations,
+                status: 'pending',
+            });
+        }
+    }
+    const session = {
+        id: randomUUID(),
+        sourceSpecId: specId,
+        sourceProjectPath: projectPath,
+        affectedSymbols,
+        consumerProjects,
+        startedAt: new Date().toISOString(),
+        status: 'scanning',
+    };
+    await createSession(session);
+    const lines = [
+        `Refactor session created: ${session.id}`,
+        `Source spec: ${specId}`,
+        `Affected symbols: ${affectedSymbols.join(', ')}`,
+        `Consumer projects with usages: ${consumerProjects.length}`,
+    ];
+    for (const cp of consumerProjects) {
+        lines.push(`  - ${cp.projectPath}: ${cp.usageLocations.length} file(s)`);
+    }
+    return textResult(lines.join('\n'));
+}
+// ---------------------------------------------------------------------------
+// sync_refactor_status
+// ---------------------------------------------------------------------------
+/**
+ * Returns the current progress report for a refactor session.
+ */
+export async function handleSyncRefactorStatus(input) {
+    const { refactorId } = input;
+    const session = await getSession(refactorId);
+    if (!session) {
+        return errText(`Refactor session "${refactorId}" not found.`);
+    }
+    const report = buildStatusReport(session);
+    const lines = [
+        `Refactor: ${report.refactorId}`,
+        `Source spec: ${report.sourceSpec}`,
+        `Total consumers: ${report.totalConsumers}`,
+        `Completed: ${report.completed}`,
+        `In progress: ${report.inProgress}`,
+        `Pending: ${report.pending}`,
+        `Overall progress: ${report.overallProgress}%`,
+    ];
+    return textResult(lines.join('\n'));
+}
+//# sourceMappingURL=multi-repo-handler.js.map

package/dist/tools/multi-repo-handler.js.map

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

package/dist/tools/register-audit-trail-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-audit-trail-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-audit-trail-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiBzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqF/D"}
+{"version":3,"file":"register-audit-trail-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-audit-trail-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoI/D"}

package/dist/tools/register-audit-trail-tools.js

@@ -2,6 +2,7 @@
 import { z } from 'zod';
 import { safeLicensed } from './safe-handler.js';
 import { handleAuditTrail, handleGenerateAttestation } from './audit-trail-handler.js';
+import { handleExportAuditTrail } from './export-audit-trail-handler.js';
 import { resolveProjectId, missingProjectIdError } from './resolve-project-id.js';
 const AUDIT_EVENT_TYPES = [
     'spec.created',
@@ -81,5 +82,42 @@ export function registerAuditTrailTools(server) {
         }
         return handleGenerateAttestation({ ...args, projectId: pid });
     }));
+    // export_audit_trail — SPEC-387 (EU AI Act Article 12)
+    server.registerTool('export_audit_trail', {
+        description: 'Export the EU AI Act Article 12 immutable audit trail for every Planu tool invocation. ' +
+            'Supports filtering by project, date range, or spec. Verifies SHA-256 chain integrity. ' +
+            'Formats: json (default), json-ld (W3C PROV-O), csv.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z
+                .string()
+                .max(4096)
+                .describe('Absolute path to project root. Used to filter entries for this project.'),
+            fromDate: z
+                .string()
+                .optional()
+                .describe('ISO-8601 start date (inclusive). Example: 2026-01-01T00:00:00Z'),
+            toDate: z
+                .string()
+                .optional()
+                .describe('ISO-8601 end date (inclusive). Example: 2026-12-31T23:59:59Z'),
+            specId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Filter entries by spec ID (e.g. SPEC-001).'),
+            format: z
+                .enum(['json', 'json-ld', 'csv'])
+                .optional()
+                .describe('Output format. Valid values: json (default), json-ld (W3C PROV-O), csv.'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(10000)
+                .optional()
+                .describe('Maximum number of entries to return.'),
+        },
+    }, safeLicensed('export_audit_trail', (args) => Promise.resolve(handleExportAuditTrail(args))));
 }
 //# sourceMappingURL=register-audit-trail-tools.js.map

package/dist/tools/register-audit-trail-tools.js.map

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

package/dist/tools/register-auto-promoter-tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAutoPromoterTools(server: McpServer): void;
+//# sourceMappingURL=register-auto-promoter-tools.d.ts.map

package/dist/tools/register-auto-promoter-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-auto-promoter-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-auto-promoter-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoDjE"}