@planu/cli 1.1.1 → 1.2.0

package/dist/tools/notion-handler.js

@@ -0,0 +1,197 @@
+import { hashProjectPath } from '../storage/base-store.js';
+import { getNotionConfig, saveNotionConfig, removeNotionConfig, getNotionSyncMap, upsertNotionPage, getNotionSyncLog, appendNotionDelivery, } from '../storage/notion-config-store.js';
+import { createNotionPage, updateNotionPage, specToNotionSpec, DEFAULT_FIELD_MAPPING, } from '../engine/notion-sync.js';
+import { listSpecs, getSpec } from '../storage/spec-store.js';
+// ---------------------------------------------------------------------------
+// configure_notion
+// ---------------------------------------------------------------------------
+export async function handleConfigureNotion(input) {
+    const now = new Date().toISOString();
+    const existing = await getNotionConfig(input.projectPath);
+    const config = {
+        token: input.token,
+        databaseId: input.databaseId,
+        syncMode: input.syncMode,
+        fieldMapping: { ...DEFAULT_FIELD_MAPPING, ...(input.fieldMapping ?? {}) },
+        projectPath: input.projectPath,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+    };
+    await saveNotionConfig(input.projectPath, config);
+    const lines = [
+        'Notion integration configured.',
+        '',
+        '| Field | Value |',
+        '|-------|-------|',
+        `| Database ID | ${maskId(input.databaseId)} |`,
+        `| Sync Mode | ${input.syncMode} |`,
+        `| Updated | ${now} |`,
+        '',
+        'Run `sync_to_notion` to push specs to your Notion database.',
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// sync_to_notion
+// ---------------------------------------------------------------------------
+export async function handleSyncToNotion(input) {
+    const config = await getNotionConfig(input.projectPath);
+    if (config === null) {
+        return {
+            content: [{ type: 'text', text: 'Notion is not configured. Run `configure_notion` first.' }],
+            isError: true,
+        };
+    }
+    const projectId = hashProjectPath(input.projectPath);
+    let specsToSync;
+    if (input.specId !== undefined) {
+        const single = await getSpec(projectId, input.specId);
+        if (single === null) {
+            return {
+                content: [{ type: 'text', text: `Spec ${input.specId} not found.` }],
+                isError: true,
+            };
+        }
+        specsToSync = [single];
+    }
+    else {
+        const all = await listSpecs(projectId);
+        specsToSync = all.filter((s) => s.status === 'approved' || s.status === 'done' || s.status === 'implementing');
+    }
+    if (specsToSync.length === 0) {
+        return { content: [{ type: 'text', text: 'No specs to sync. Approve some specs first.' }] };
+    }
+    const syncMap = await getNotionSyncMap(input.projectPath);
+    const result = { created: 0, updated: 0, failed: 0, items: [] };
+    const errors = [];
+    for (const spec of specsToSync) {
+        const notionSpec = specToNotionSpec({
+            id: spec.id,
+            title: spec.title,
+            status: spec.status,
+            tags: spec.tags,
+        });
+        const existing = syncMap[spec.id];
+        try {
+            if (existing !== undefined) {
+                await updateNotionPage(config, existing.pageId, notionSpec);
+                result.updated++;
+                result.items.push({
+                    specId: spec.id,
+                    externalId: existing.pageId,
+                    externalUrl: existing.pageUrl,
+                    title: spec.title,
+                });
+                await upsertNotionPage(input.projectPath, {
+                    specId: spec.id,
+                    pageId: existing.pageId,
+                    pageUrl: existing.pageUrl,
+                    lastSyncedAt: new Date().toISOString(),
+                });
+            }
+            else {
+                const ref = await createNotionPage(config, notionSpec);
+                result.created++;
+                result.items.push(ref);
+                await upsertNotionPage(input.projectPath, {
+                    specId: spec.id,
+                    pageId: ref.externalId,
+                    pageUrl: ref.externalUrl,
+                    lastSyncedAt: new Date().toISOString(),
+                });
+            }
+        }
+        catch (err) {
+            result.failed++;
+            const msg = err instanceof Error ? err.message : String(err);
+            errors.push(`${spec.id}: ${msg}`);
+        }
+    }
+    await appendNotionDelivery(input.projectPath, {
+        syncedAt: new Date().toISOString(),
+        result,
+    });
+    if (errors.length > 0 && result.created === 0 && result.updated === 0) {
+        return {
+            content: [{ type: 'text', text: `Notion sync FAILED:\n${errors.join('\n')}` }],
+            isError: true,
+        };
+    }
+    const lines = [
+        `Notion sync complete: ${result.created} created, ${result.updated} updated, ${result.failed} failed.`,
+        '',
+    ];
+    for (const item of result.items) {
+        lines.push(`- [${item.specId}] ${item.title} → ${item.externalUrl}`);
+    }
+    if (errors.length > 0) {
+        lines.push('', 'Errors:', ...errors.map((e) => `- ${e}`));
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// notion_status
+// ---------------------------------------------------------------------------
+export async function handleNotionStatus(input) {
+    const config = await getNotionConfig(input.projectPath);
+    if (config === null) {
+        return {
+            content: [
+                { type: 'text', text: 'Notion is not configured. Run `configure_notion` to set it up.' },
+            ],
+        };
+    }
+    const [syncMap, log] = await Promise.all([
+        getNotionSyncMap(input.projectPath),
+        getNotionSyncLog(input.projectPath),
+    ]);
+    const lines = [
+        '**Notion Integration Status**',
+        '',
+        '| Field | Value |',
+        '|-------|-------|',
+        `| Database ID | ${maskId(config.databaseId)} |`,
+        `| Sync Mode | ${config.syncMode} |`,
+        `| Synced Pages | ${Object.keys(syncMap).length} |`,
+        `| Created | ${config.createdAt} |`,
+        `| Updated | ${config.updatedAt} |`,
+        '',
+        `**Recent Sync Log** (last ${log.length})`,
+        '',
+    ];
+    if (log.length === 0) {
+        lines.push('No syncs yet.');
+    }
+    else {
+        for (const entry of log.slice(-5)) {
+            const { created, updated, failed } = entry.result;
+            lines.push(`- ${entry.syncedAt.slice(0, 19)} | created: ${created}, updated: ${updated}, failed: ${failed}`);
+        }
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+// ---------------------------------------------------------------------------
+// remove_notion
+// ---------------------------------------------------------------------------
+export async function handleRemoveNotion(input) {
+    const config = await getNotionConfig(input.projectPath);
+    if (config === null) {
+        return {
+            content: [{ type: 'text', text: 'Notion is not configured — nothing to remove.' }],
+        };
+    }
+    await removeNotionConfig(input.projectPath);
+    return {
+        content: [{ type: 'text', text: 'Notion configuration removed. Sync mapping cleared.' }],
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function maskId(id) {
+    if (id.length <= 8) {
+        return '***';
+    }
+    return `${id.slice(0, 4)}...${id.slice(-4)}`;
+}
+//# sourceMappingURL=notion-handler.js.map

package/dist/tools/notion-handler.js.map

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

package/dist/tools/onboarding-handler.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult, StartOnboardingInput, GuidedTourInput, OnboardingChecklistInput, QuickStartInput, OnboardingProgressInput } from '../types/index.js';
+export declare function handleStartOnboarding(args: StartOnboardingInput): Promise<ToolResult>;
+export declare function handleGuidedTour(args: GuidedTourInput): Promise<ToolResult>;
+export declare function handleOnboardingChecklist(args: OnboardingChecklistInput): Promise<ToolResult>;
+export declare function handleQuickStart(args: QuickStartInput): Promise<ToolResult>;
+export declare function handleOnboardingProgress(args: OnboardingProgressInput): Promise<ToolResult>;
+//# sourceMappingURL=onboarding-handler.d.ts.map

package/dist/tools/onboarding-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-handler.d.ts","sourceRoot":"","sources":["../../src/tools/onboarding-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,wBAAwB,EACxB,eAAe,EACf,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAc3B,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiB3F;AAGD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAIjF;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAIrB;AAGD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAGjF;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoCjG"}

package/dist/tools/onboarding-handler.js

@@ -0,0 +1,59 @@
+// tools/onboarding-handler.ts — SPEC-360: Interactive Onboarding & Guided Tours
+import { hashProjectPath } from '../storage/base-store.js';
+import { getOnboardingConfig, saveOnboardingConfig } from '../storage/onboarding-store.js';
+import { buildRecommendations, formatRecommendationsMarkdown, getGuidedTour, formatTourMarkdown, buildOnboardingChecklist, formatChecklistMarkdown, getQuickStart, buildProgressSummary, } from '../engine/onboarding-engine.js';
+export async function handleStartOnboarding(args) {
+    const projectId = hashProjectPath(args.projectPath);
+    const config = {
+        role: args.role,
+        projectType: args.projectType,
+        teamSize: args.teamSize,
+        completedSteps: [],
+        startedAt: new Date().toISOString(),
+    };
+    await saveOnboardingConfig(projectId, config);
+    const recommendations = buildRecommendations(args.role, args.projectType, args.teamSize);
+    const markdown = formatRecommendationsMarkdown(config, recommendations);
+    return { content: [{ type: 'text', text: markdown }] };
+}
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleGuidedTour(args) {
+    const tour = getGuidedTour(args.area);
+    const markdown = formatTourMarkdown(tour);
+    return { content: [{ type: 'text', text: markdown }] };
+}
+export async function handleOnboardingChecklist(args) {
+    const checklist = await buildOnboardingChecklist(args.projectPath);
+    const markdown = formatChecklistMarkdown(checklist);
+    return { content: [{ type: 'text', text: markdown }] };
+}
+// eslint-disable-next-line @typescript-eslint/require-await -- sync logic, async signature required by safe() wrapper
+export async function handleQuickStart(args) {
+    const content = getQuickStart(args.template);
+    return { content: [{ type: 'text', text: content }] };
+}
+export async function handleOnboardingProgress(args) {
+    const projectId = hashProjectPath(args.projectPath);
+    const config = await getOnboardingConfig(projectId);
+    const summary = await buildProgressSummary(args.projectPath, config);
+    const lines = [
+        `# Onboarding Progress`,
+        ``,
+        `**Project:** ${args.projectPath}`,
+        `**Progress:** ${String(summary.percentComplete)}% complete`,
+        ``,
+        `## Setup Checklist`,
+        ``,
+        `${String(summary.checklist.completedCount)}/${String(summary.checklist.totalCount)} steps done`,
+        ``,
+    ];
+    if (config !== null) {
+        lines.push(`## Your Profile`, ``, `- Role: ${config.role}`, `- Project type: ${config.projectType}`, `- Team size: ${config.teamSize}`, `- Started: ${config.startedAt}`, ``);
+    }
+    lines.push(`## Next Steps`, ``);
+    for (const step of summary.nextSteps) {
+        lines.push(`- ${step}`);
+    }
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+//# sourceMappingURL=onboarding-handler.js.map

package/dist/tools/onboarding-handler.js.map

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

package/dist/tools/parallel-safety-handler.d.ts

@@ -0,0 +1,7 @@
+import type { CheckParallelSafetyInput, ToolResult } from '../types/index.js';
+/**
+ * Handle check_parallel_safety tool call.
+ * Returns worktree collision risk assessment and safe agent names.
+ */
+export declare function handleCheckParallelSafety(input: CheckParallelSafetyInput): ToolResult;
+//# sourceMappingURL=parallel-safety-handler.d.ts.map

package/dist/tools/parallel-safety-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-safety-handler.d.ts","sourceRoot":"","sources":["../../src/tools/parallel-safety-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAwB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpG;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB,GAAG,UAAU,CAyBrF"}

package/dist/tools/parallel-safety-handler.js

@@ -0,0 +1,29 @@
+import { checkParallelSafety } from '../engine/parallel-safety-engine.js';
+/**
+ * Handle check_parallel_safety tool call.
+ * Returns worktree collision risk assessment and safe agent names.
+ */
+export function handleCheckParallelSafety(input) {
+    const { projectPath, numAgents = 6 } = input;
+    const result = checkParallelSafety(process.cwd(), projectPath, numAgents);
+    const riskEmoji = {
+        safe: 'GREEN',
+        warning: 'YELLOW',
+        danger: 'RED',
+    };
+    const lines = [
+        `Parallel Safety Check`,
+        `=====================`,
+        `Risk Level: ${riskEmoji[result.riskLevel] ?? result.riskLevel} (${result.riskLevel.toUpperCase()})`,
+        `Inside Worktree: ${result.isInsideWorktree ? `yes (agent-${result.currentWorktreeId})` : 'no'}`,
+        `Active Worktrees: ${result.activeWorktreeIds.length > 0 ? result.activeWorktreeIds.map((id) => `agent-${id}`).join(', ') : 'none'}`,
+        ``,
+        `Safe Agent Names (${result.safeAgentNames.length} prepared):`,
+        ...result.safeAgentNames.map((n) => `  - ${n}`),
+        ``,
+        `Recommendations:`,
+        ...result.recommendations.map((r) => `  * ${r}`),
+    ];
+    return { content: [{ type: 'text', text: lines.join('\n') }] };
+}
+//# sourceMappingURL=parallel-safety-handler.js.map

package/dist/tools/parallel-safety-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-safety-handler.js","sourceRoot":"","sources":["../../src/tools/parallel-safety-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAA+B;IACvE,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAyB,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAEhG,MAAM,SAAS,GAA2B;QACxC,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,KAAK;KACd,CAAC;IAEF,MAAM,KAAK,GAAa;QACtB,uBAAuB;QACvB,uBAAuB;QACvB,eAAe,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG;QACpG,oBAAoB,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;QAChG,qBAAqB,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;QACpI,EAAE;QACF,qBAAqB,MAAM,CAAC,cAAc,CAAC,MAAM,aAAa;QAC9D,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,EAAE;QACF,kBAAkB;QAClB,GAAG,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACjD,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/register-asana-tools.d.ts

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

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

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

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

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureAsana, handleSyncToAsana, handleAsanaStatus, handleRemoveAsana, } from './asana-handler.js';
+const projectPathSchema = z
+    .string()
+    .min(1)
+    .max(4096)
+    .describe('Absolute path to the project root where Planu stores its data.');
+export function registerAsanaTools(server) {
+    server.registerTool('configure_asana', {
+        description: 'Configure Asana integration for a project. ' +
+            'Credentials are stored locally and used by sync_to_asana. ' +
+            'Requires a personal access token, workspace GID, and project GID. ' +
+            'Get your token at: https://app.asana.com/0/my-apps',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            token: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Asana personal access token. Generate at https://app.asana.com/0/my-apps'),
+            workspaceGid: z
+                .string()
+                .min(1)
+                .max(50)
+                .describe('Asana workspace GID (numeric string). Find it in workspace settings.'),
+            projectGid: z
+                .string()
+                .min(1)
+                .max(50)
+                .describe('Asana project GID (numeric string) where tasks will be created.'),
+            syncMode: z
+                .enum(['push', 'bidirectional'])
+                .describe('Sync direction. ' +
+                '"push" creates/updates tasks in Asana from Planu specs. ' +
+                '"bidirectional" also reads task state back (informational).'),
+            sectionMapping: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe('Optional mapping from Planu status to Asana section name. ' +
+                'Default: draft→Backlog, review→In Review, approved→Ready, ' +
+                'in-progress→In Progress, done→Completed.'),
+        },
+        annotations: { title: 'Configure Asana Integration' },
+    }, safeTracked('configure_asana', (args) => handleConfigureAsana(args)));
+    server.registerTool('sync_to_asana', {
+        description: 'Sync Planu specs to Asana as tasks. ' +
+            'By default syncs all approved, in-progress, and done specs. ' +
+            'Creates new tasks or updates existing ones. ' +
+            'Run configure_asana first.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            specId: z
+                .string()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe('Optional SPEC-XXX identifier to sync a single spec. Omit to sync all.'),
+        },
+        annotations: { title: 'Sync Specs to Asana' },
+    }, safeTracked('sync_to_asana', (args) => handleSyncToAsana(args)));
+    server.registerTool('asana_status', {
+        description: 'Show the current Asana integration status: configuration, synced task count, and recent sync history.',
+        inputSchema: { projectPath: projectPathSchema },
+        annotations: { title: 'Asana Integration Status', readOnlyHint: true },
+    }, safeTracked('asana_status', (args) => handleAsanaStatus(args)));
+    server.registerTool('remove_asana', {
+        description: 'Remove the Asana integration configuration and sync mapping for a project. ' +
+            'Run configure_asana to re-enable.',
+        inputSchema: { projectPath: projectPathSchema },
+        annotations: { title: 'Remove Asana Integration', destructiveHint: true },
+    }, safeTracked('remove_asana', (args) => handleRemoveAsana(args)));
+}
+//# sourceMappingURL=register-asana-tools.js.map

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

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

package/dist/tools/register-code-impact-tools.d.ts

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

package/dist/tools/register-code-impact-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-code-impact-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-code-impact-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmF/D"}

package/dist/tools/register-code-impact-tools.js

@@ -0,0 +1,58 @@
+// tools/register-code-impact-tools.ts — Registers Code Change → Spec Impact Analyzer tools (SPEC-366)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleAnalyzeCodeImpact, handleCodeChangeCompliance, handleSuggestSpecUpdate, handleGitDiffToSpecImpact, } from './code-impact-handler.js';
+export function registerCodeImpactTools(server) {
+    server.registerTool('analyze_code_impact', {
+        description: 'Analyze which specs are impacted by a code change. ' +
+            'Provide filePath, diffText, or both. ' +
+            'Returns related specs with relation type: direct-binding, filename-match, or semantic-match.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            filePath: z
+                .string()
+                .optional()
+                .describe('Path to the changed file (relative or absolute).'),
+            diffText: z
+                .string()
+                .optional()
+                .describe('Raw diff text (e.g. output of git diff). Used for semantic matching.'),
+        },
+        annotations: { title: 'Analyze Code Impact', readOnlyHint: true },
+    }, safeTracked('analyze_code_impact', (args) => handleAnalyzeCodeImpact(args)));
+    server.registerTool('code_change_compliance', {
+        description: 'Check whether a code change is justified by an approved spec. ' +
+            'Returns a compliance score (0-100%), justifying specs, and unjustified changes. ' +
+            'A change is justified if there is at least one related spec in approved/implementing/in-progress/done status.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            filePath: z
+                .string()
+                .optional()
+                .describe('Path to the changed file to check compliance for.'),
+            commitHash: z
+                .string()
+                .optional()
+                .describe('Git commit hash to analyze (uses git show internally).'),
+        },
+        annotations: { title: 'Code Change Compliance', readOnlyHint: true },
+    }, safeTracked('code_change_compliance', (args) => handleCodeChangeCompliance(args)));
+    server.registerTool('suggest_spec_update', {
+        description: 'Suggest which specs to update (or create) based on a changed file. ' +
+            'Returns a list of suggestions with type (update/create), spec ID, and reason.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            filePath: z.string().min(1).max(4096).describe('Path to the changed file.'),
+        },
+        annotations: { title: 'Suggest Spec Update', readOnlyHint: true },
+    }, safeTracked('suggest_spec_update', (args) => handleSuggestSpecUpdate(args)));
+    server.registerTool('git_diff_to_spec_impact', {
+        description: 'Run git diff HEAD on the project and analyze which specs are impacted. ' +
+            'Convenience alias that combines git diff + analyze_code_impact.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+        },
+        annotations: { title: 'Git Diff to Spec Impact', readOnlyHint: true },
+    }, safeTracked('git_diff_to_spec_impact', (args) => handleGitDiffToSpecImpact(args)));
+}
+//# sourceMappingURL=register-code-impact-tools.js.map

package/dist/tools/register-code-impact-tools.js.map

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

package/dist/tools/register-compliance-audit-tools.d.ts

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

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

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

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

@@ -0,0 +1,106 @@
+// tools/register-compliance-audit-tools.ts — SPEC-371: Register Compliance & Audit tools
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleGenerateComplianceReport, handleAuditLogExport, handleDataRetentionPolicy, handleComplianceGapAnalysis, } from './compliance-audit-handler.js';
+const STANDARD_DESCRIBE = 'Compliance standard. Valid values: soc2-type2 | iso27001 | gdpr | hipaa | custom';
+const FORMAT_DESCRIBE = 'Output format. Valid values: html | json';
+const EXPORT_FORMAT_DESCRIBE = 'Export format. Valid values: csv | json | json-ld';
+export function registerComplianceAuditTools(server) {
+    server.registerTool('generate_compliance_report', {
+        description: 'Generate a compliance report mapping Planu features to controls for a given standard ' +
+            '(SOC2 Type 2, ISO 27001, GDPR, HIPAA). ' +
+            'Returns HTML or JSON with control status (satisfied / partial / gap).',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            standard: z
+                .enum(['soc2-type2', 'iso27001', 'gdpr', 'hipaa', 'custom'])
+                .describe(STANDARD_DESCRIBE),
+            outputFormat: z.enum(['html', 'json']).optional().describe(FORMAT_DESCRIBE),
+        },
+        annotations: {
+            title: 'Generate Compliance Report',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('generate_compliance_report', (args) => Promise.resolve(handleGenerateComplianceReport(args))));
+    server.registerTool('audit_log_export', {
+        description: 'Export the project audit trail in CSV, JSON, or JSON-LD format. ' +
+            'Supports optional date range filtering. ' +
+            'Use for compliance reviews, security audits, or data archiving.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            format: z.enum(['csv', 'json', 'json-ld']).optional().describe(EXPORT_FORMAT_DESCRIBE),
+            dateRange: z
+                .object({
+                from: z.string().max(50).optional().describe('Start date ISO string (e.g. 2024-01-01)'),
+                to: z.string().max(50).optional().describe('End date ISO string (e.g. 2024-12-31)'),
+            })
+                .optional()
+                .describe('Optional date range filter for audit entries'),
+        },
+        annotations: {
+            title: 'Export Audit Log',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('audit_log_export', async (args) => handleAuditLogExport(args)));
+    server.registerTool('data_retention_policy', {
+        description: 'Configure the data retention policy for the project. ' +
+            'Specifies how long data should be retained and whether auto-deletion is enabled. ' +
+            'NOTE: Policy describes intent; auto-delete does not run automatically.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            retentionDays: z
+                .number()
+                .int()
+                .min(1)
+                .max(3650)
+                .describe('Number of days to retain data (e.g. 365 for one year)'),
+            autoDelete: z
+                .boolean()
+                .optional()
+                .describe('Whether data should be auto-deleted after retentionDays (default: false)'),
+            notifyBeforeDeleteDays: z
+                .number()
+                .int()
+                .min(0)
+                .max(365)
+                .optional()
+                .describe('Days before deletion to notify (default: 7)'),
+        },
+        annotations: {
+            title: 'Configure Data Retention Policy',
+            readOnlyHint: false,
+        },
+    }, safeLicensed('data_retention_policy', async (args) => handleDataRetentionPolicy(args)));
+    server.registerTool('compliance_gap_analysis', {
+        description: 'Analyze which controls of a compliance standard are NOT fully satisfied by Planu ' +
+            'and provide recommendations to close the gaps. ' +
+            'Returns gaps with severity (critical / high / medium / low).',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root directory'),
+            standard: z
+                .enum(['soc2-type2', 'iso27001', 'gdpr', 'hipaa', 'custom'])
+                .describe(STANDARD_DESCRIBE),
+        },
+        annotations: {
+            title: 'Compliance Gap Analysis',
+            readOnlyHint: true,
+        },
+    }, safeLicensed('compliance_gap_analysis', (args) => Promise.resolve(handleComplianceGapAnalysis(args))));
+}
+//# sourceMappingURL=register-compliance-audit-tools.js.map

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

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

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

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