@planu/cli 1.11.0 → 1.12.0

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-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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"}

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

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

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

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

package/dist/tools/register-checkpoints.js

@@ -0,0 +1,134 @@
+// tools/register-checkpoints.ts — Registers approval checkpoint tools (SPEC-411)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureCheckpointPolicy } from './checkpoint/configure-policy-handler.js';
+import { handleRequireCheckpoint } from './checkpoint/require-checkpoint-handler.js';
+import { handleApproveCheckpoint } from './checkpoint/approve-checkpoint-handler.js';
+import { handleRejectCheckpoint } from './checkpoint/reject-checkpoint-handler.js';
+import { handleListPendingCheckpoints } from './checkpoint/list-checkpoints-handler.js';
+export function registerCheckpointTools(server) {
+    // -------------------------------------------------------------------------
+    // configure_checkpoint_policy — set up approval gates for transitions
+    // -------------------------------------------------------------------------
+    server.registerTool('configure_checkpoint_policy', {
+        description: 'Configure approval checkpoints that block spec status transitions until a designated role approves. ' +
+            'Apply a built-in preset (strict/balanced/relaxed) or define custom per-transition policies. ' +
+            'This implements the Judge gate in Planner→Worker→Judge governance.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            preset: z
+                .enum(['strict', 'balanced', 'relaxed'])
+                .optional()
+                .describe('Policy preset: strict=all transitions need approval (draft->review, review->approved, approved->implementing, implementing->done), ' +
+                'balanced=key transitions only (review->approved, implementing->done), ' +
+                'relaxed=only completion needs approval (implementing->done).'),
+            policies: z
+                .array(z.object({
+                transition: z
+                    .string()
+                    .min(1)
+                    .describe('Transition to gate, e.g. "review->approved". ' +
+                    'Valid statuses: draft, review, approved, implementing, done, discarded.'),
+                requiredRole: z
+                    .string()
+                    .min(1)
+                    .describe('Role that must approve: developer, tech_lead, qa, product_owner, admin.'),
+                description: z
+                    .string()
+                    .min(1)
+                    .describe('Human-readable explanation of why this checkpoint exists.'),
+                autoApproveAfterHours: z
+                    .number()
+                    .positive()
+                    .optional()
+                    .describe('Hours before the checkpoint auto-approves if no action is taken.'),
+            }))
+                .optional()
+                .describe('Custom policies (used when preset is not set). ' +
+                'Replaces all existing policies for the project.'),
+        },
+        annotations: { title: 'Configure Checkpoint Policy', destructiveHint: false },
+    }, safeTracked('configure_checkpoint_policy', (args) => handleConfigureCheckpointPolicy(args)));
+    // -------------------------------------------------------------------------
+    // require_checkpoint — manually create a pending checkpoint
+    // -------------------------------------------------------------------------
+    server.registerTool('require_checkpoint', {
+        description: 'Create a pending checkpoint that blocks a specific spec status transition. ' +
+            'Returns the checkpoint ID and instructions on who needs to approve it. ' +
+            'The checkpoint must be approved via approve_checkpoint before the transition can proceed.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            specId: z.string().min(1).max(500).describe('Spec ID to block, e.g. SPEC-042.'),
+            transition: z
+                .string()
+                .min(1)
+                .describe('Status transition to block, e.g. "review->approved". ' +
+                'Must match a configured policy.'),
+            requestedBy: z
+                .string()
+                .optional()
+                .describe('Identifier of who is requesting the checkpoint (defaults to "system").'),
+        },
+        annotations: { title: 'Require Checkpoint', destructiveHint: false },
+    }, safeTracked('require_checkpoint', (args) => handleRequireCheckpoint(args)));
+    // -------------------------------------------------------------------------
+    // approve_checkpoint — approve a pending checkpoint
+    // -------------------------------------------------------------------------
+    server.registerTool('approve_checkpoint', {
+        description: 'Approve a pending checkpoint, unblocking the associated spec status transition. ' +
+            'Returns confirmation and next steps for the spec.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            checkpointId: z
+                .string()
+                .min(1)
+                .describe('ID of the checkpoint to approve (returned by require_checkpoint).'),
+            approvedBy: z
+                .string()
+                .optional()
+                .describe('Identifier of the approver (defaults to "anonymous").'),
+        },
+        annotations: { title: 'Approve Checkpoint', destructiveHint: false },
+    }, safeTracked('approve_checkpoint', (args) => handleApproveCheckpoint(args)));
+    // -------------------------------------------------------------------------
+    // reject_checkpoint — reject a pending checkpoint
+    // -------------------------------------------------------------------------
+    server.registerTool('reject_checkpoint', {
+        description: 'Reject a pending checkpoint, blocking the associated spec status transition. ' +
+            'A rejection reason is required. The spec stays in its current status.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            checkpointId: z
+                .string()
+                .min(1)
+                .describe('ID of the checkpoint to reject (returned by require_checkpoint).'),
+            rejectedBy: z
+                .string()
+                .optional()
+                .describe('Identifier of the reviewer rejecting (defaults to "anonymous").'),
+            reason: z
+                .string()
+                .min(1)
+                .describe('Mandatory explanation of why the checkpoint was rejected.'),
+        },
+        annotations: { title: 'Reject Checkpoint', destructiveHint: false },
+    }, safeTracked('reject_checkpoint', (args) => handleRejectCheckpoint(args)));
+    // -------------------------------------------------------------------------
+    // list_pending_checkpoints — list checkpoints awaiting approval
+    // -------------------------------------------------------------------------
+    server.registerTool('list_pending_checkpoints', {
+        description: 'List all pending approval checkpoints for a project. ' +
+            'Optionally filter by required role to see only checkpoints relevant to you. ' +
+            'Returns spec ID, transition being blocked, required role, and requester.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            role: z
+                .string()
+                .optional()
+                .describe('Filter by required role: developer, tech_lead, qa, product_owner, admin. ' +
+                'Omit to list all pending checkpoints.'),
+        },
+        annotations: { title: 'List Pending Checkpoints', readOnlyHint: true },
+    }, safeTracked('list_pending_checkpoints', (args) => handleListPendingCheckpoints(args)));
+}
+//# sourceMappingURL=register-checkpoints.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-context-profile.d.ts","sourceRoot":"","sources":["../../src/tools/register-context-profile.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2BzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiHnE"}

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

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { setActiveProfile, getActiveProfile } from '../storage/context-profile-store.js';
+import { getProfile, getAllProfiles } from '../engine/context-profile/profile-catalog.js';
+const AVAILABLE_PHASES = ['brainstorm', 'plan', 'implement', 'review', 'release'];
+const projectPathField = z
+    .string()
+    .min(1)
+    .max(4096)
+    .describe('Absolute path to the project root directory.');
+const phaseField = z
+    .enum(['brainstorm', 'plan', 'implement', 'review', 'release'])
+    .describe('Work phase to activate: ' +
+    'brainstorm=explore ideas, ' +
+    'plan=design specs, ' +
+    'implement=build features, ' +
+    'review=validate quality, ' +
+    'release=publish');
+export function registerContextProfileTools(server) {
+    // -------------------------------------------------------------------------
+    // set_context_profile
+    // -------------------------------------------------------------------------
+    server.registerTool('set_context_profile', {
+        description: 'Activate a work-phase context profile that guides the LLM to use only the ' +
+            'relevant tools for the current phase (brainstorm/plan/implement/review/release). ' +
+            'Reduces token waste by surfacing only the ~10 most relevant tools per phase.',
+        inputSchema: {
+            projectPath: projectPathField,
+            phase: phaseField,
+        },
+        annotations: { readOnlyHint: false },
+    }, safeTracked('set_context_profile', async (args) => {
+        const { projectPath, phase } = args;
+        await setActiveProfile(projectPath, phase);
+        const profile = getProfile(phase);
+        const focusList = profile.focusTools.map((t) => `  • ${t}`).join('\n');
+        const tipsList = profile.tips.map((t) => `  - ${t}`).join('\n');
+        const text = `You are now in **${profile.name}**.\n\n` +
+            `${profile.description}\n\n` +
+            `**Focus tools (~${profile.estimatedTokensSaved}% token savings):**\n${focusList}\n\n` +
+            `**Tips:**\n${tipsList}`;
+        return { content: [{ type: 'text', text }] };
+    }));
+    // -------------------------------------------------------------------------
+    // get_context_profile
+    // -------------------------------------------------------------------------
+    server.registerTool('get_context_profile', {
+        description: 'Get the currently active context profile for a project, ' +
+            'including focus tools and phase-specific tips. ' +
+            'Returns a prompt when no profile is active.',
+        inputSchema: {
+            projectPath: projectPathField,
+        },
+        annotations: { readOnlyHint: true },
+    }, safeTracked('get_context_profile', async (args) => {
+        const { projectPath } = args;
+        const active = await getActiveProfile(projectPath);
+        if (!active) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No active context profile. Use set_context_profile to activate one.\n\n' +
+                            `Available phases: ${AVAILABLE_PHASES.join(', ')}`,
+                    },
+                ],
+            };
+        }
+        const profile = getProfile(active.phase);
+        const focusList = profile.focusTools.map((t) => `  • ${t}`).join('\n');
+        const avoidList = profile.avoidTools.map((t) => `  • ${t}`).join('\n');
+        const tipsList = profile.tips.map((t) => `  - ${t}`).join('\n');
+        const text = `**Active profile: ${profile.name}**\n` +
+            `Activated: ${active.activatedAt}\n\n` +
+            `${profile.description}\n\n` +
+            `**Focus tools:**\n${focusList}\n\n` +
+            `**Avoid tools:**\n${avoidList}\n\n` +
+            `**Tips:**\n${tipsList}\n\n` +
+            `Estimated token savings: ~${profile.estimatedTokensSaved}%`;
+        return { content: [{ type: 'text', text }] };
+    }));
+    // -------------------------------------------------------------------------
+    // list_context_profiles
+    // -------------------------------------------------------------------------
+    server.registerTool('list_context_profiles', {
+        description: 'List all 5 available context profiles (brainstorm/plan/implement/review/release) ' +
+            'with their focus tools and estimated token savings. ' +
+            'Use this to discover which profile is best for the current work.',
+        inputSchema: {
+            projectPath: projectPathField,
+        },
+        annotations: { readOnlyHint: true },
+    }, safeTracked('list_context_profiles', async (args) => {
+        const { projectPath } = args;
+        const active = await getActiveProfile(projectPath);
+        const profiles = getAllProfiles();
+        const lines = ['**Available context profiles:**\n'];
+        for (const p of profiles) {
+            const isActive = active?.phase === p.phase ? ' (ACTIVE)' : '';
+            lines.push(`### ${p.name}${isActive}`, `Phase: \`${p.phase}\``, p.description, `Focus: ${p.focusTools.slice(0, 5).join(', ')}${p.focusTools.length > 5 ? ` +${String(p.focusTools.length - 5)} more` : ''}`, `Token savings: ~${String(p.estimatedTokensSaved)}%`, '');
+        }
+        lines.push(`Use set_context_profile with phase=<phase> to activate one.`);
+        return { content: [{ type: 'text', text: lines.join('\n') }] };
+    }));
+}
+//# sourceMappingURL=register-context-profile.js.map

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

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

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

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

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

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