@planu/cli 1.11.0 → 1.13.0

package/dist/tools/pull-sync-handler.js

@@ -0,0 +1,161 @@
+import { pullFromNotion } from '../engine/sync/notion-puller.js';
+import { pullFromAsana } from '../engine/sync/asana-puller.js';
+import { pullFromMonday } from '../engine/sync/monday-puller.js';
+import { getNotionConfig } from '../storage/notion-config-store.js';
+import { getAsanaConfig } from '../storage/asana-config-store.js';
+import { getMondayConfig } from '../storage/monday-config-store.js';
+// ---------------------------------------------------------------------------
+// pull_from_notion
+// ---------------------------------------------------------------------------
+export async function handlePullFromNotion(input) {
+    const strategy = input.conflictStrategy ?? 'spec-wins';
+    try {
+        const result = await pullFromNotion(input.projectPath, strategy);
+        return { content: [{ type: 'text', text: formatPullResult(result) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: `pull_from_notion failed: ${message}` }],
+            isError: true,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// pull_from_asana
+// ---------------------------------------------------------------------------
+export async function handlePullFromAsana(input) {
+    const strategy = input.conflictStrategy ?? 'spec-wins';
+    try {
+        const result = await pullFromAsana(input.projectPath, strategy);
+        return { content: [{ type: 'text', text: formatPullResult(result) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: `pull_from_asana failed: ${message}` }],
+            isError: true,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// pull_from_monday
+// ---------------------------------------------------------------------------
+export async function handlePullFromMonday(input) {
+    const strategy = input.conflictStrategy ?? 'spec-wins';
+    try {
+        const result = await pullFromMonday(input.projectPath, strategy);
+        return { content: [{ type: 'text', text: formatPullResult(result) }] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: 'text', text: `pull_from_monday failed: ${message}` }],
+            isError: true,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// sync_all_integrations
+// ---------------------------------------------------------------------------
+export async function handleSyncAllIntegrations(input) {
+    const strategy = input.conflictStrategy ?? 'spec-wins';
+    const summary = {
+        totalPulled: 0,
+        totalConflicts: 0,
+        conflictsResolved: 0,
+    };
+    const [notionConfig, asanaConfig, mondayConfig] = await Promise.all([
+        getNotionConfig(input.projectPath),
+        getAsanaConfig(input.projectPath),
+        getMondayConfig(input.projectPath),
+    ]);
+    if (notionConfig !== null) {
+        try {
+            const result = await pullFromNotion(input.projectPath, strategy);
+            summary.notion = result;
+            summary.totalPulled += result.pulled.length;
+            summary.totalConflicts += result.conflicts.length;
+            summary.conflictsResolved += result.conflicts.filter((c) => c.resolution !== 'pending-manual').length;
+        }
+        catch {
+            // Non-fatal: continue with other integrations
+        }
+    }
+    if (asanaConfig !== null) {
+        try {
+            const result = await pullFromAsana(input.projectPath, strategy);
+            summary.asana = result;
+            summary.totalPulled += result.pulled.length;
+            summary.totalConflicts += result.conflicts.length;
+            summary.conflictsResolved += result.conflicts.filter((c) => c.resolution !== 'pending-manual').length;
+        }
+        catch {
+            // Non-fatal: continue with other integrations
+        }
+    }
+    if (mondayConfig !== null) {
+        try {
+            const result = await pullFromMonday(input.projectPath, strategy);
+            summary.monday = result;
+            summary.totalPulled += result.pulled.length;
+            summary.totalConflicts += result.conflicts.length;
+            summary.conflictsResolved += result.conflicts.filter((c) => c.resolution !== 'pending-manual').length;
+        }
+        catch {
+            // Non-fatal: continue with other integrations
+        }
+    }
+    return { content: [{ type: 'text', text: formatSyncAllResult(summary) }] };
+}
+// ---------------------------------------------------------------------------
+// Formatting helpers
+// ---------------------------------------------------------------------------
+function formatPullResult(result) {
+    const lines = [
+        `**${capitalize(result.integration)} Pull Sync** — ${result.executedAt.slice(0, 19)}`,
+        '',
+        `- Updates pulled: ${result.pulled.length}`,
+        `- Conflicts detected: ${result.conflicts.length}`,
+        `- New specs created: ${result.newSpecsCreated.length}`,
+    ];
+    if (result.pulled.length > 0) {
+        lines.push('', '**Applied Updates:**');
+        for (const u of result.pulled) {
+            lines.push(`- [${u.specId}] ${u.field}: \`${u.oldValue}\` → \`${u.newValue}\``);
+        }
+    }
+    if (result.conflicts.length > 0) {
+        lines.push('', '**Conflicts:**');
+        for (const c of result.conflicts) {
+            lines.push(`- [${c.specId}] ${c.field}: planu=\`${c.planuValue}\` vs external=\`${c.externalValue}\` → ${c.resolution}`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatSyncAllResult(result) {
+    const active = [
+        result.notion !== undefined ? 'Notion' : null,
+        result.asana !== undefined ? 'Asana' : null,
+        result.monday !== undefined ? 'Monday.com' : null,
+    ]
+        .filter(Boolean)
+        .join(', ');
+    const lines = [
+        '**Sync All Integrations**',
+        '',
+        `Integrations synced: ${active !== '' ? active : 'none configured'}`,
+        '',
+        `| Metric | Value |`,
+        `|--------|-------|`,
+        `| Total pulled | ${result.totalPulled} |`,
+        `| Total conflicts | ${result.totalConflicts} |`,
+        `| Conflicts resolved | ${result.conflictsResolved} |`,
+        `| Pending manual | ${result.totalConflicts - result.conflictsResolved} |`,
+    ];
+    return lines.join('\n');
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=pull-sync-handler.js.map

package/dist/tools/pull-sync-handler.js.map

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

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

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ROLE_CATALOG } from '../engine/agent-registry/role-catalog.js';
+export declare function registerAgentRegistryTools(server: McpServer): void;
+export { ROLE_CATALOG };
+//# sourceMappingURL=register-agent-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-agent-registry.d.ts","sourceRoot":"","sources":["../../src/tools/register-agent-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,OAAO,EAAc,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAgBpF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0TlE;AAGD,OAAO,EAAE,YAAY,EAAE,CAAC"}

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

@@ -0,0 +1,254 @@
+// register-agent-registry.ts — Persistent Agent Registry tools (SPEC-415)
+import { z } from 'zod';
+import { safeLicensed, safeTracked } from './safe-handler.js';
+import { registerAgent, stopAgent, restartAgent, unregisterAgent, getAgentHealth, listAllAgents, } from '../engine/agent-registry/lifecycle-manager.js';
+import { getRoleDef, ROLE_CATALOG } from '../engine/agent-registry/role-catalog.js';
+const ROLE_VALUES = [
+    'spec-guardian',
+    'pr-reviewer',
+    'metrics-analyst',
+    'criteria-auditor',
+    'changelog-keeper',
+    'dependency-watcher',
+];
+const ROLE_DESCRIBE = 'Agent role. Values: spec-guardian — monitors drift, pr-reviewer — reviews PRs, ' +
+    'metrics-analyst — weekly reports, criteria-auditor — validates EARS quality, ' +
+    'changelog-keeper — keeps CHANGELOG updated, dependency-watcher — alerts on vulnerabilities';
+export function registerAgentRegistryTools(server) {
+    // ---------------------------------------------------------------------------
+    // Tool 1: register_agent
+    // ---------------------------------------------------------------------------
+    server.registerTool('register_agent', {
+        description: 'Register a persistent AI agent with a predefined role for this project. ' +
+            'Agents survive across sessions and run automatically based on their trigger. ' +
+            'Re-registering an existing role updates its trigger and config while preserving run history.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            role: z.enum(ROLE_VALUES).describe(ROLE_DESCRIBE),
+            trigger: z.object({
+                type: z
+                    .enum(['cron', 'event', 'webhook', 'manual'])
+                    .describe('Trigger type. Values: cron — scheduled, event — autopilot event, ' +
+                    'webhook — external webhook, manual — on demand only'),
+                schedule: z
+                    .string()
+                    .max(100)
+                    .optional()
+                    .describe('Cron expression (for type=cron). Example: "0 9 * * 1" for Mondays at 9am'),
+                event: z
+                    .string()
+                    .max(500)
+                    .optional()
+                    .describe('Autopilot event name (for type=event). Example: "spec:done"'),
+                webhook: z
+                    .string()
+                    .max(500)
+                    .optional()
+                    .describe('Webhook pattern (for type=webhook). Example: "github:pull_request.opened"'),
+            }),
+            config: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Role-specific configuration. Uses role defaults if omitted.'),
+        },
+        annotations: { title: 'Register Persistent Agent' },
+    }, safeLicensed('register_agent', async (args) => {
+        const { projectPath, role, trigger, config } = args;
+        const roleDef = getRoleDef(role);
+        const mergedConfig = { ...(roleDef?.defaultConfig ?? {}), ...(config ?? {}) };
+        const agent = await registerAgent(projectPath, role, trigger, mergedConfig);
+        const lines = [
+            `Agent registered: ${role}`,
+            `Status: ${agent.status}`,
+            `Trigger: ${agent.trigger.type}` +
+                (agent.trigger.schedule !== undefined ? ` (${agent.trigger.schedule})` : '') +
+                (agent.trigger.event !== undefined ? ` (${agent.trigger.event})` : '') +
+                (agent.trigger.webhook !== undefined ? ` (${agent.trigger.webhook})` : ''),
+            `Registered at: ${agent.registeredAt}`,
+        ];
+        if (roleDef !== undefined) {
+            lines.push(`Required tools: ${roleDef.requiredTools.join(', ')}`);
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }));
+    // ---------------------------------------------------------------------------
+    // Tool 2: list_agents
+    // ---------------------------------------------------------------------------
+    server.registerTool('list_agents', {
+        description: 'List all registered persistent agents in this project. ' +
+            'Shows role, status, trigger type, run count, and last run time for each agent.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+        },
+        annotations: { title: 'List Registered Agents', readOnlyHint: true },
+    }, safeTracked('list_agents', async (args) => {
+        const { projectPath } = args;
+        const agents = await listAllAgents(projectPath);
+        if (agents.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No agents registered in this project.\nUse register_agent to add one.',
+                    },
+                ],
+            };
+        }
+        const lines = [`Registered agents (${agents.length}):`, ''];
+        for (const agent of agents) {
+            const roleDef = getRoleDef(agent.role);
+            lines.push(`[${agent.status.toUpperCase()}] ${agent.role}`);
+            if (roleDef !== undefined) {
+                lines.push(`  Description: ${roleDef.description}`);
+            }
+            lines.push(`  Trigger: ${agent.trigger.type}` +
+                (agent.trigger.schedule !== undefined ? ` (${agent.trigger.schedule})` : '') +
+                (agent.trigger.event !== undefined ? ` (${agent.trigger.event})` : '') +
+                (agent.trigger.webhook !== undefined ? ` (${agent.trigger.webhook})` : ''));
+            lines.push(`  Runs: ${agent.runCount} total, ${agent.successCount} successful`);
+            if (agent.lastRunAt !== undefined) {
+                lines.push(`  Last run: ${agent.lastRunAt}`);
+            }
+            lines.push('');
+        }
+        return { content: [{ type: 'text', text: lines.join('\n').trimEnd() }] };
+    }));
+    // ---------------------------------------------------------------------------
+    // Tool 3: stop_agent
+    // ---------------------------------------------------------------------------
+    server.registerTool('stop_agent', {
+        description: 'Pause a registered agent. The agent remains registered but will not run until restarted.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            role: z.enum(ROLE_VALUES).describe(ROLE_DESCRIBE),
+        },
+        annotations: { title: 'Stop Agent' },
+    }, safeLicensed('stop_agent', async (args) => {
+        const { projectPath, role } = args;
+        await stopAgent(projectPath, role);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Agent '${role}' paused. Use restart_agent to resume it.`,
+                },
+            ],
+        };
+    }));
+    // ---------------------------------------------------------------------------
+    // Tool 4: restart_agent
+    // ---------------------------------------------------------------------------
+    server.registerTool('restart_agent', {
+        description: 'Resume a paused agent or reset an agent in error state back to active.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            role: z.enum(ROLE_VALUES).describe(ROLE_DESCRIBE),
+        },
+        annotations: { title: 'Restart Agent' },
+    }, safeLicensed('restart_agent', async (args) => {
+        const { projectPath, role } = args;
+        const agent = await restartAgent(projectPath, role);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        `Agent '${role}' is now active.`,
+                        `Trigger: ${agent.trigger.type}` +
+                            (agent.trigger.schedule !== undefined ? ` (${agent.trigger.schedule})` : '') +
+                            (agent.trigger.event !== undefined ? ` (${agent.trigger.event})` : '') +
+                            (agent.trigger.webhook !== undefined ? ` (${agent.trigger.webhook})` : ''),
+                    ].join('\n'),
+                },
+            ],
+        };
+    }));
+    // ---------------------------------------------------------------------------
+    // Tool 5: agent_health
+    // ---------------------------------------------------------------------------
+    server.registerTool('agent_health', {
+        description: 'Get health metrics for a registered agent: status, success rate, average duration, and last error.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            role: z.enum(ROLE_VALUES).describe(ROLE_DESCRIBE),
+        },
+        annotations: { title: 'Agent Health', readOnlyHint: true },
+    }, safeTracked('agent_health', async (args) => {
+        const { projectPath, role } = args;
+        const health = await getAgentHealth(projectPath, role);
+        if (health.status === 'unregistered') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Agent '${role}' is not registered in this project.\nUse register_agent to add it.`,
+                    },
+                ],
+            };
+        }
+        const lines = [
+            `Health report: ${role}`,
+            `Status: ${health.status}`,
+            `Success rate: ${(health.successRate * 100).toFixed(1)}%`,
+        ];
+        if (health.avgDurationMs !== undefined) {
+            lines.push(`Avg duration: ${health.avgDurationMs.toFixed(0)}ms`);
+        }
+        if (health.lastRunAt !== undefined) {
+            lines.push(`Last run: ${health.lastRunAt}`);
+        }
+        if (health.lastError !== undefined) {
+            lines.push(`Last error: ${health.lastError}`);
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }));
+    // ---------------------------------------------------------------------------
+    // Tool 6: unregister_agent (bonus — needed for full lifecycle)
+    // ---------------------------------------------------------------------------
+    server.registerTool('unregister_agent', {
+        description: 'Permanently remove an agent from this project registry. All run history will be lost.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            role: z.enum(ROLE_VALUES).describe(ROLE_DESCRIBE),
+        },
+        annotations: { title: 'Unregister Agent', destructiveHint: true },
+    }, safeLicensed('unregister_agent', async (args) => {
+        const { projectPath, role } = args;
+        await unregisterAgent(projectPath, role);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Agent '${role}' has been unregistered and removed from the project registry.`,
+                },
+            ],
+        };
+    }));
+}
+// Re-export catalog for tests
+export { ROLE_CATALOG };
+//# sourceMappingURL=register-agent-registry.js.map

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

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

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

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

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

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

package/dist/tools/register-auto-remediation.js

@@ -0,0 +1,174 @@
+// tools/register-auto-remediation.ts — Auto-fix + remediation tools (SPEC-408)
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { hashProjectPath } from '../storage/base-store.js';
+import { autoFixHealth } from '../engine/health/auto-fixer.js';
+import { autoRemediateCompliance } from '../engine/compliance/auto-remediator.js';
+import { resolveDriftViolations } from '../engine/drift/violation-resolver.js';
+// ---------------------------------------------------------------------------
+// Tool 1: auto_fix_health
+// ---------------------------------------------------------------------------
+export function registerAutoRemediationTools(server) {
+    server.registerTool('auto_fix_health', {
+        description: 'Automatically fix deterministic health issues found by health_check_all. ' +
+            'Fixable: missing progress.md files. ' +
+            'Not fixable (reported as skipped): incomplete spec fields, missing tests, drift violations. ' +
+            'Use dryRun=true to preview what would be fixed without making changes.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe('When true, report what would be fixed without actually writing any files (default: false)'),
+        },
+        annotations: {
+            title: 'Auto Fix Health Issues',
+        },
+    }, safeLicensed('auto_fix_health', async (args) => {
+        const { projectPath, dryRun = false } = args;
+        const projectId = hashProjectPath(projectPath);
+        const result = await autoFixHealth(projectPath, projectId, dryRun);
+        const lines = [
+            dryRun ? '[DRY RUN] Auto-fix health report:' : 'Auto-fix health report:',
+            '',
+            `Fixed: ${result.fixedCount}`,
+            `Skipped (manual action required): ${result.skippedCount}`,
+            `Executed at: ${result.executedAt}`,
+        ];
+        if (result.fixes.length > 0) {
+            lines.push('', 'Fixes applied:');
+            for (const fix of result.fixes) {
+                lines.push(`  [${fix.success ? 'OK' : 'FAIL'}] ${fix.affectedItem}: ${fix.action}`);
+            }
+        }
+        if (result.skipped.length > 0) {
+            lines.push('', 'Skipped (requires manual action):');
+            for (const skip of result.skipped) {
+                lines.push(`  - ${skip.issue}: ${skip.reason}`);
+                for (const step of skip.manualSteps) {
+                    lines.push(`      → ${step}`);
+                }
+            }
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }));
+    // ---------------------------------------------------------------------------
+    // Tool 2: auto_remediate_compliance
+    // ---------------------------------------------------------------------------
+    server.registerTool('auto_remediate_compliance', {
+        description: 'For each compliance control gap, creates a stub spec so the team has a tracked work item. ' +
+            'Already-covered controls are reported. Partially-covered controls list manual actions needed. ' +
+            'Use dryRun=true to preview without creating any files.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            framework: z
+                .enum(['SOC2', 'GDPR', 'HIPAA', 'ISO27001'])
+                .describe('Compliance framework to remediate: SOC2=service org controls, GDPR=EU data privacy, HIPAA=US health data, ISO27001=security management'),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe('When true, report what would be created without writing any files (default: false)'),
+        },
+        annotations: {
+            title: 'Auto Remediate Compliance Gaps',
+        },
+    }, safeLicensed('auto_remediate_compliance', async (args) => {
+        const { projectPath, framework, dryRun = false, } = args;
+        const projectId = hashProjectPath(projectPath);
+        const result = await autoRemediateCompliance(projectPath, projectId, framework, dryRun);
+        const lines = [
+            dryRun
+                ? `[DRY RUN] Compliance remediation for ${result.framework}:`
+                : `Compliance remediation for ${result.framework}:`,
+            '',
+            `Specs created: ${result.createdSpecs.length}`,
+            `Controls already covered: ${result.alreadyCovered.length}`,
+            `Manual actions required: ${result.manualActionRequired.length}`,
+        ];
+        if (result.createdSpecs.length > 0) {
+            lines.push('', 'Specs created:');
+            for (const id of result.createdSpecs) {
+                lines.push(`  + ${id}`);
+            }
+        }
+        if (result.alreadyCovered.length > 0) {
+            lines.push('', 'Already covered controls:');
+            for (const ctrl of result.alreadyCovered) {
+                lines.push(`  ✓ ${ctrl}`);
+            }
+        }
+        if (result.manualActionRequired.length > 0) {
+            lines.push('', 'Manual actions required:');
+            for (const action of result.manualActionRequired) {
+                lines.push(`  - ${action.control}: ${action.description}`);
+                for (const step of action.steps) {
+                    lines.push(`      → ${step}`);
+                }
+            }
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }));
+    // ---------------------------------------------------------------------------
+    // Tool 3: resolve_drift_violations
+    // ---------------------------------------------------------------------------
+    server.registerTool('resolve_drift_violations', {
+        description: 'Resolves drift violations semi-automatically. ' +
+            'For done specs with diverged code: creates a follow-up spec to track the delta. ' +
+            'For in-progress specs ahead of the spec: records the resolution note. ' +
+            'For draft specs with code present: flags for manual review. ' +
+            'Use dryRun=true to preview without creating files.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            dryRun: z
+                .boolean()
+                .optional()
+                .describe('When true, report what would be resolved without writing any files (default: false)'),
+        },
+        annotations: {
+            title: 'Resolve Drift Violations',
+        },
+    }, safeLicensed('resolve_drift_violations', async (args) => {
+        const { projectPath, dryRun = false } = args;
+        const projectId = hashProjectPath(projectPath);
+        const result = await resolveDriftViolations(projectPath, projectId, dryRun);
+        const lines = [
+            dryRun ? '[DRY RUN] Drift violation resolution:' : 'Drift violation resolution:',
+            '',
+            `Violations resolved: ${result.resolved.length}`,
+            `Follow-up specs created: ${result.followUpSpecsCreated.length}`,
+            `Requiring manual review: ${result.manualReview.length}`,
+        ];
+        if (result.resolved.length > 0) {
+            lines.push('', 'Resolved:');
+            for (const r of result.resolved) {
+                lines.push(`  [${r.specId}] ${r.action}: ${r.description}`);
+            }
+        }
+        if (result.followUpSpecsCreated.length > 0) {
+            lines.push('', 'Follow-up specs created:');
+            for (const id of result.followUpSpecsCreated) {
+                lines.push(`  + ${id}`);
+            }
+        }
+        if (result.manualReview.length > 0) {
+            lines.push('', 'Requires manual review:');
+            for (const item of result.manualReview) {
+                lines.push(`  - ${item}`);
+            }
+        }
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }));
+}
+//# sourceMappingURL=register-auto-remediation.js.map

package/dist/tools/register-auto-remediation.js.map

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