@planu/cli 0.15.2

package/dist/tools/reconcile-spec.js

@@ -0,0 +1,247 @@
+import { ti } from '../i18n/index.js';
+import { specStore, knowledgeStore } from '../storage/index.js';
+import { createVersion } from '../engine/spec-versioner.js';
+import { readFile, writeFile } from 'node:fs/promises';
+/**
+ * Auto-detect changes by comparing spec metadata with current state.
+ */
+async function autoDetectChanges(spec, _knowledge) {
+    const changes = [];
+    // Check if estimation was significantly off (only if actuals exist)
+    if (spec.actuals) {
+        const estimatedTotal = spec.estimation.devHours + spec.estimation.reviewHours;
+        const actualTotal = spec.actuals.devHours + spec.actuals.reviewHours;
+        const ratio = actualTotal / estimatedTotal;
+        if (ratio > 1.3 || ratio < 0.7) {
+            changes.push({
+                section: 'estimation',
+                originalValue: `${estimatedTotal}h estimated`,
+                newValue: `${actualTotal}h actual (${Math.round(ratio * 100)}% of estimate)`,
+                reason: ratio > 1.3
+                    ? 'Implementation took significantly longer than estimated'
+                    : 'Implementation was completed faster than estimated',
+                approved: true,
+            });
+        }
+        // Cost discrepancy
+        if (Math.abs(spec.estimation.totalCostUsd - spec.actuals.totalCostUsd) > 10) {
+            changes.push({
+                section: 'cost',
+                originalValue: `$${spec.estimation.totalCostUsd}`,
+                newValue: `$${spec.actuals.totalCostUsd}`,
+                reason: 'Actual cost differs from estimate',
+                approved: true,
+            });
+        }
+    }
+    // Check if status should be updated
+    if (spec.actuals && spec.status !== 'done') {
+        changes.push({
+            section: 'status',
+            originalValue: spec.status,
+            newValue: 'done',
+            reason: 'Actuals are recorded but status is not done',
+            approved: false,
+        });
+    }
+    // Detect if spec files have been manually modified
+    try {
+        const huContent = await readFile(spec.huPath, 'utf-8');
+        if (huContent.includes('MODIFIED') || huContent.includes('UPDATED')) {
+            changes.push({
+                section: 'hu-manual-edits',
+                originalValue: 'Original HU content',
+                newValue: 'Manual edits detected in HU.md',
+                reason: 'HU.md appears to have been manually modified after creation',
+                approved: true,
+            });
+        }
+    }
+    catch {
+        changes.push({
+            section: 'hu-file',
+            originalValue: spec.huPath,
+            newValue: 'File not found',
+            reason: 'HU.md file is missing or was moved',
+            approved: false,
+        });
+    }
+    try {
+        await readFile(spec.fichaTecnicaPath, 'utf-8');
+    }
+    catch {
+        changes.push({
+            section: 'ficha-file',
+            originalValue: spec.fichaTecnicaPath,
+            newValue: 'File not found',
+            reason: 'FICHA-TECNICA.md file is missing or was moved',
+            approved: false,
+        });
+    }
+    return changes;
+}
+/**
+ * Apply approved changes to the spec files.
+ */
+async function applyChangesToSpecFiles(spec, changes) {
+    const approvedChanges = changes.filter((c) => c.approved);
+    if (approvedChanges.length === 0) {
+        return;
+    }
+    // Update FICHA-TECNICA.md with a reconciliation section
+    try {
+        let fichaContent = await readFile(spec.fichaTecnicaPath, 'utf-8');
+        // Add reconciliation log
+        const reconcileSection = [
+            '',
+            '## Reconciliation Log',
+            '',
+            `> Reconciled at: ${new Date().toISOString()}`,
+            '',
+            '| Section | Original | Updated | Reason |',
+            '|---------|----------|---------|--------|',
+            ...approvedChanges.map((c) => `| ${c.section} | ${c.originalValue} | ${c.newValue} | ${c.reason} |`),
+            '',
+        ].join('\n');
+        // Check if there's already a reconciliation section
+        if (fichaContent.includes('## Reconciliation Log')) {
+            // Append to existing section
+            fichaContent = fichaContent.replace(/(## Reconciliation Log[\s\S]*?)(\n## |\n$|$)/, `$1\n${reconcileSection}\n$2`);
+        }
+        else {
+            // Add new section at the end
+            fichaContent += reconcileSection;
+        }
+        await writeFile(spec.fichaTecnicaPath, fichaContent, 'utf-8');
+    }
+    catch {
+        // File doesn't exist, skip
+    }
+    // Update post-implementation section if actuals are present
+    if (spec.actuals) {
+        try {
+            let fichaContent = await readFile(spec.fichaTecnicaPath, 'utf-8');
+            // Replace the post-implementation table values
+            fichaContent = fichaContent.replace(/(\| Dev Hours \| [^|]+ \|) — \|/, `$1 ${spec.actuals.devHours}h |`);
+            fichaContent = fichaContent.replace(/(\| Review Hours \| [^|]+ \|) — \|/, `$1 ${spec.actuals.reviewHours}h |`);
+            fichaContent = fichaContent.replace(/(\| API Cost \| [^|]+ \|) — \|/, `$1 $${spec.actuals.apiCostUsd} |`);
+            fichaContent = fichaContent.replace(/(\| Total Cost \| [^|]+ \|) — \|/, `$1 $${spec.actuals.totalCostUsd} |`);
+            await writeFile(spec.fichaTecnicaPath, fichaContent, 'utf-8');
+        }
+        catch {
+            // File doesn't exist, skip
+        }
+    }
+}
+/**
+ * Append a reconciliation note to PLAN.md when changes are applied.
+ */
+async function appendPlanReconcileNote(planPath, changes) {
+    try {
+        const existing = await readFile(planPath, 'utf-8');
+        const note = [
+            '',
+            '---',
+            '',
+            `## Reconciliation Note — ${new Date().toISOString()}`,
+            '',
+            `> ${changes.length} change(s) applied during reconciliation:`,
+            '',
+            ...changes.map((c) => `- **${c.section}**: ${c.reason}`),
+            '',
+        ].join('\n');
+        await writeFile(planPath, existing + note, 'utf-8');
+    }
+    catch {
+        // Non-fatal: if PLAN.md can't be updated, reconcile still succeeds
+    }
+}
+export async function handleReconcileSpec(params) {
+    const { specId, projectId, autoDetect = true, changes: manualChanges } = params;
+    try {
+        // Get the spec
+        const spec = await specStore.getSpec(projectId, specId);
+        if (!spec) {
+            return {
+                content: [{ type: 'text', text: ti('spec.notFound', { id: specId }) }],
+                isError: true,
+            };
+        }
+        // Load project knowledge
+        const knowledge = await knowledgeStore.getKnowledge(projectId);
+        // Collect all changes
+        const allChanges = [];
+        // Auto-detect changes
+        if (autoDetect) {
+            const autoChanges = await autoDetectChanges(spec, knowledge);
+            allChanges.push(...autoChanges);
+        }
+        // Add manual changes
+        if (manualChanges && manualChanges.length > 0) {
+            allChanges.push(...manualChanges);
+        }
+        // Apply approved changes to spec files
+        await applyChangesToSpecFiles(spec, allChanges);
+        // Update spec metadata if needed
+        const approvedChanges = allChanges.filter((c) => c.approved);
+        const hasStatusChange = approvedChanges.find((c) => c.section === 'status');
+        if (hasStatusChange) {
+            await specStore.updateSpec(projectId, specId, {
+                status: hasStatusChange.newValue,
+            });
+        }
+        // Update PLAN.md if spec has one and there were approved changes
+        if (spec.planPath && approvedChanges.length > 0) {
+            await appendPlanReconcileNote(spec.planPath, approvedChanges);
+        }
+        // Create a new SpecVersion if there were approved changes
+        let createdVersion = null;
+        if (approvedChanges.length > 0) {
+            const currentVersion = await specStore.getLatestVersion(projectId, specId);
+            const version = createVersion(specId, currentVersion, approvedChanges, `Reconcile: ${approvedChanges.length} change(s) applied`);
+            await specStore.saveVersion(projectId, specId, version);
+            createdVersion = version.version;
+        }
+        // Mark spec as reconciled by updating the timestamp
+        await specStore.updateSpec(projectId, specId, {
+            updatedAt: new Date().toISOString(),
+        });
+        const report = {
+            specId,
+            changes: allChanges,
+            specUpdated: approvedChanges.length > 0,
+            reason: approvedChanges.length > 0
+                ? `Applied ${approvedChanges.length} change(s) to spec`
+                : 'No changes to apply',
+            reconciledAt: new Date().toISOString(),
+        };
+        const result = {
+            ...report,
+            versionCreated: createdVersion,
+            summary: {
+                totalChanges: allChanges.length,
+                approvedChanges: approvedChanges.length,
+                pendingChanges: allChanges.filter((c) => !c.approved).length,
+                autoDetected: autoDetect
+                    ? allChanges.filter((c) => !manualChanges?.some((mc) => mc.section === c.section)).length
+                    : 0,
+                manual: manualChanges?.length ?? 0,
+            },
+            message: ti('tools.reconcile_spec.success', {
+                specId,
+                count: String(allChanges.length),
+            }),
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: ti('errors.internalError', { message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=reconcile-spec.js.map

package/dist/tools/reconcile-spec.js.map

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

package/dist/tools/register-agent-tools.d.ts

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

package/dist/tools/register-agent-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-agent-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-agent-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgG1D"}

package/dist/tools/register-agent-tools.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { handleOrchestrateAgents } from './orchestrate-agents.js';
+import { safeLicensed } from './safe-handler.js';
+export function registerAgentTools(server) {
+    server.registerTool('orchestrate_agents', {
+        description: 'Declare agent capabilities, route tasks to the best agent, generate structured handoff contexts, and detect file-ownership conflicts before parallel execution. Supports register-agent | list-agents | route-task | decompose-spec | handoff | conflict-check.',
+        inputSchema: {
+            action: z
+                .enum([
+                'register-agent',
+                'list-agents',
+                'route-task',
+                'decompose-spec',
+                'handoff',
+                'conflict-check',
+            ])
+                .describe('Action: register-agent (declare capability) | list-agents (list registered) | route-task (assign best agent) | decompose-spec (triad distribution) | handoff (structured context) | conflict-check (file overlap detection)'),
+            projectId: z
+                .string()
+                .optional()
+                .describe('Project ID for persistence — defaults to "global"'),
+            agentId: z.string().optional().describe('register-agent: unique identifier for the agent'),
+            role: z
+                .enum(['planner', 'implementer', 'reviewer', 'tester', 'researcher'])
+                .optional()
+                .describe('register-agent: primary role the agent fulfils'),
+            ecosystems: z
+                .array(z.string())
+                .optional()
+                .describe('register-agent: ecosystems the agent handles (e.g. ["typescript","python"])'),
+            filePatterns: z
+                .array(z.string())
+                .optional()
+                .describe('register-agent: glob patterns for files the agent owns'),
+            maxConcurrency: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('register-agent: max concurrent tasks (default: 1)'),
+            preferredModel: z
+                .enum(['haiku', 'sonnet', 'opus'])
+                .optional()
+                .describe('register-agent: preferred model tier (default: sonnet)'),
+            taskDescription: z
+                .string()
+                .optional()
+                .describe('route-task | decompose-spec: natural-language description of the task'),
+            specCriteria: z
+                .array(z.string())
+                .optional()
+                .describe('decompose-spec: acceptance criteria to distribute across agents'),
+            availableAgents: z
+                .array(z.string())
+                .optional()
+                .describe('decompose-spec: agent IDs available for assignment'),
+            sessionContext: z
+                .object({
+                fromAgent: z.string().describe('Agent ID handing off work'),
+                toAgent: z.string().describe('Agent ID receiving work'),
+                completedWork: z.array(z.string()).describe('Short descriptions of completed work'),
+                decisions: z
+                    .array(z.object({
+                    decision: z.string(),
+                    rationale: z.string(),
+                }))
+                    .describe('Architectural decisions made during the session'),
+                fileOwnershipMap: z
+                    .record(z.string(), z.string())
+                    .describe('Map of file path → agentId that last modified it'),
+                pendingWork: z
+                    .array(z.object({ task: z.string(), context: z.string() }))
+                    .describe('Unfinished tasks with context for the receiving agent'),
+            })
+                .optional()
+                .describe('handoff: session context object'),
+            agentPlans: z
+                .array(z.object({
+                agentId: z.string().describe('Agent ID submitting this plan'),
+                ownedFiles: z.array(z.string()).describe('Files the agent intends to modify'),
+            }))
+                .optional()
+                .describe('conflict-check: array of per-agent plans'),
+        },
+        annotations: { readOnlyHint: false },
+    }, safeLicensed('orchestrate_agents', async (args) => handleOrchestrateAgents(args)));
+}
+//# sourceMappingURL=register-agent-tools.js.map

package/dist/tools/register-agent-tools.js.map

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

package/dist/tools/register-context-tools.d.ts

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

package/dist/tools/register-context-tools.d.ts.map

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

package/dist/tools/register-context-tools.js

@@ -0,0 +1,84 @@
+// tools/register-context-tools.ts — Registers context ingestion tools (SPEC-036)
+// Tools: request_context, contribute_context
+import { z } from 'zod';
+import { handleRequestContext, handleContributeContext } from './contribute-context.js';
+import { safeLicensed } from './safe-handler.js';
+export function registerContextTools(server) {
+    // request_context
+    server.registerTool('request_context', {
+        description: 'Generate a prompt that asks the user for reference documentation (README, PRD, ' +
+            'architecture diagrams, wireframes, ADRs, etc.) so the agent can learn the project. ' +
+            'Sets a flag to avoid re-asking on subsequent calls. Use force=true to re-generate.',
+        inputSchema: {
+            projectId: z.string().describe('Project ID (hash of project path from init_project)'),
+            force: z
+                .boolean()
+                .optional()
+                .describe('Force re-generation even if already requested (default: false)'),
+        },
+    }, safeLicensed('request_context', async (args) => handleRequestContext(args)));
+    // contribute_context
+    server.registerTool('contribute_context', {
+        description: 'Persist structured knowledge that the agent extracted from user-provided documents. ' +
+            'Merges intelligently with auto-detected knowledge; reports conflicts for agent resolution. ' +
+            'Multiple calls accumulate — they do not overwrite each other.',
+        inputSchema: {
+            projectId: z.string().describe('Project ID (hash of project path from init_project)'),
+            context: z
+                .object({
+                entities: z
+                    .array(z.object({
+                    name: z.string().describe('Entity / model name'),
+                    fields: z.array(z.string()).describe('Field names'),
+                    relations: z.array(z.string()).optional().describe('Related entity names'),
+                }))
+                    .optional()
+                    .describe('Data entities / models extracted from the docs'),
+                apiContracts: z
+                    .array(z.object({
+                    type: z
+                        .enum(['rest', 'graphql', 'trpc', 'grpc', 'websocket'])
+                        .describe('Contract type'),
+                    endpoint: z.string().optional().describe('Base endpoint or path'),
+                    description: z.string().describe('What this API does'),
+                }))
+                    .optional()
+                    .describe('API contract descriptions'),
+                architectureNotes: z
+                    .string()
+                    .optional()
+                    .describe('Architecture decisions and patterns from the docs'),
+                techDecisions: z
+                    .array(z.string())
+                    .optional()
+                    .describe('Key technical decisions recorded in ADRs or equivalent'),
+                userFlows: z
+                    .array(z.string())
+                    .optional()
+                    .describe('User journey descriptions from wireframes or PRD'),
+                nonFunctionalRequirements: z
+                    .array(z.string())
+                    .optional()
+                    .describe('Performance, security, and scalability requirements'),
+                additionalContext: z
+                    .string()
+                    .max(10_000)
+                    .optional()
+                    .describe('Free-text additional context (max 10 000 chars)'),
+            })
+                .describe('Structured knowledge extracted from the user documents'),
+            source: z
+                .object({
+                documentName: z
+                    .string()
+                    .describe('Name or description of the source document (e.g. "README.md", "PRD v2")'),
+                contributedAt: z
+                    .string()
+                    .describe('ISO 8601 timestamp of when this contribution was made'),
+                contributedBy: z.string().describe('Agent identifier (e.g. "claude-code", "cursor")'),
+            })
+                .describe('Trace metadata for this contribution'),
+        },
+    }, safeLicensed('contribute_context', async (args) => handleContributeContext(args)));
+}
+//# sourceMappingURL=register-context-tools.js.map

package/dist/tools/register-context-tools.js.map

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

package/dist/tools/register-event-tools.d.ts

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

package/dist/tools/register-event-tools.d.ts.map

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

package/dist/tools/register-event-tools.js

@@ -0,0 +1,110 @@
+// tools/register-event-tools.ts — Registers Event-Driven Contracts tool (SPEC-031)
+import { z } from 'zod';
+import { handleEventContracts } from './event-contracts.js';
+import { safeLicensed } from './safe-handler.js';
+export function registerEventTools(server) {
+    // event_contracts — SPEC-031
+    server.registerTool('event_contracts', {
+        description: 'Manage event-driven architecture contracts: generate JSON Schema contracts for events, ' +
+            'validate payloads, evolve schemas with backward-compatibility classification, ' +
+            'and define Saga contracts for distributed transactions.',
+        inputSchema: {
+            subcommand: z
+                .enum(['generate-contract', 'validate-contract', 'evolve-contract', 'saga-spec'])
+                .describe('generate-contract: create a new event contract JSON Schema; ' +
+                'validate-contract: verify a payload against the active contract; ' +
+                'evolve-contract: classify a schema change and apply the new version; ' +
+                'saga-spec: define a Saga with compensation events per step'),
+            projectId: z.string().describe('Project ID (hash of project path)'),
+            generateContract: z
+                .object({
+                projectId: z.string().describe('Project ID'),
+                eventName: z.string().describe('Unique event name, e.g. "order.created"'),
+                producer: z.string().describe('Service or component that emits this event'),
+                consumers: z.array(z.string()).describe('Known consumer service names'),
+                payloadFields: z
+                    .array(z.object({
+                    name: z.string().describe('Field name'),
+                    type: z
+                        .string()
+                        .describe('JSON Schema type: string, number, boolean, object, array'),
+                    required: z.boolean().describe('Whether this field is required'),
+                    description: z.string().optional().describe('Field description'),
+                }))
+                    .describe('Payload field definitions'),
+                broker: z
+                    .enum(['kafka', 'rabbitmq', 'sqs-sns', 'nats', 'eventbridge', 'pubsub', 'unknown'])
+                    .optional()
+                    .describe('Message broker (auto-detected from project stack if omitted)'),
+                specId: z.string().optional().describe('SPEC-XXX that references this contract'),
+            })
+                .optional()
+                .describe('Input for generate-contract subcommand'),
+            validateContract: z
+                .object({
+                projectId: z.string().describe('Project ID'),
+                eventName: z.string().describe('Event name to validate against'),
+                payload: z.record(z.string(), z.unknown()).describe('Payload object to validate'),
+            })
+                .optional()
+                .describe('Input for validate-contract subcommand'),
+            evolveContract: z
+                .object({
+                projectId: z.string().describe('Project ID'),
+                eventName: z.string().describe('Event name to evolve'),
+                changeDescription: z.string().describe('Human-readable description of the change'),
+                addedFields: z.array(z.string()).optional().describe('New optional fields added'),
+                removedFields: z.array(z.string()).optional().describe('Fields removed (breaking)'),
+                changedFields: z
+                    .array(z.object({
+                    field: z.string(),
+                    from: z.string().describe('Previous type'),
+                    to: z.string().describe('New type'),
+                }))
+                    .optional()
+                    .describe('Fields whose type changed (breaking)'),
+                deprecatedFields: z
+                    .array(z.object({
+                    field: z.string(),
+                    reason: z.string(),
+                    sunsetVersion: z.string().describe('Version at which field will be removed'),
+                }))
+                    .optional()
+                    .describe('Fields marked deprecated'),
+            })
+                .optional()
+                .describe('Input for evolve-contract subcommand'),
+            sagaSpec: z
+                .object({
+                projectId: z.string().describe('Project ID'),
+                sagaId: z.string().describe('Unique Saga ID, e.g. "checkout-saga"'),
+                description: z.string().describe('What the Saga achieves'),
+                coordinationStyle: z
+                    .enum(['choreography', 'orchestration'])
+                    .describe('Coordination style'),
+                steps: z
+                    .array(z.object({
+                    id: z.string().describe('Unique step ID'),
+                    name: z.string().describe('Step name'),
+                    service: z.string().describe('Service executing this step'),
+                    successEvent: z.string().describe('Event emitted on step success'),
+                    failureEvent: z.string().describe('Event emitted on step failure'),
+                    compensationEvent: z
+                        .string()
+                        .describe('Event that compensates / undoes this step'),
+                    failureConditions: z.array(z.string()).describe('Conditions causing failure'),
+                    dependsOn: z.array(z.string()).describe('Step IDs that must complete first'),
+                }))
+                    .describe('Ordered Saga steps — each must have a compensationEvent'),
+                orchestratorService: z
+                    .string()
+                    .optional()
+                    .describe('Orchestrator service name (required if orchestration style)'),
+                specId: z.string().optional().describe('SPEC-XXX implementing this Saga'),
+            })
+                .optional()
+                .describe('Input for saga-spec subcommand'),
+        },
+    }, safeLicensed('event_contracts', async (args) => handleEventContracts(args)));
+}
+//# sourceMappingURL=register-event-tools.js.map

package/dist/tools/register-event-tools.js.map

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

package/dist/tools/register-facilitator-tools.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the `facilitate` tool and related facilitator tools (SPEC-037).
+ */
+export declare function registerFacilitatorTools(server: McpServer): void;
+//# sourceMappingURL=register-facilitator-tools.d.ts.map

package/dist/tools/register-facilitator-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-facilitator-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-facilitator-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqDhE"}