@planu/cli 0.91.0 → 0.92.0

package/dist/tools/spec-split-handler.js

@@ -0,0 +1,250 @@
+// tools/spec-split-handler.ts — Handlers for analyze_spec_size and split_spec (SPEC-289)
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { specStore } from '../storage/index.js';
+import { analyzeSpecSize, buildChildSpecs } from '../engine/spec-splitter.js';
+import { generateProgressContent } from '../engine/progress-writer.js';
+// ---------------------------------------------------------------------------
+// analyze_spec_size
+// ---------------------------------------------------------------------------
+export async function handleAnalyzeSpecSize(input) {
+    const { projectId, specId } = input;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: `Spec "${specId}" not found in project "${projectId}"` }],
+            isError: true,
+        };
+    }
+    // Read spec.md to extract real acceptance criteria
+    const specWithCriteria = await enrichSpecWithCriteria(spec);
+    const analysis = analyzeSpecSize(specWithCriteria);
+    const lines = [
+        `# Spec Size Analysis — ${specId}`,
+        '',
+        `**Spec**: ${spec.title}`,
+        `**Criteria count**: ${String(analysis.criteriaCount)}`,
+        `**Estimated hours**: ${String(analysis.estimatedHours)}h`,
+        '',
+    ];
+    if (analysis.shouldSplit) {
+        lines.push('## Split Recommended');
+        lines.push('');
+        lines.push('**Reasons:**');
+        for (const reason of analysis.reasons) {
+            lines.push(`- ${reason}`);
+        }
+        lines.push('');
+        if (analysis.ambiguousCriteria.length > 0) {
+            lines.push('## Ambiguous Criteria Detected');
+            lines.push('');
+            for (const ac of analysis.ambiguousCriteria) {
+                lines.push(`- ${ac}`);
+            }
+            lines.push('');
+        }
+        lines.push('## Suggested Splits');
+        lines.push('');
+        for (const [i, proposal] of analysis.suggestedSplits.entries()) {
+            lines.push(`### ${String(i + 1)}. ${proposal.title}`);
+            lines.push(proposal.description);
+            if (proposal.dependsOn.length > 0) {
+                lines.push(`**Depends on**: splits ${proposal.dependsOn.map((d) => String(d + 1)).join(', ')}`);
+            }
+            lines.push('');
+        }
+        lines.push('Run `split_spec` to execute the division.');
+    }
+    else {
+        lines.push('## No Split Needed');
+        lines.push('');
+        lines.push('This spec is appropriately sized and does not require splitting.');
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: lines.join('\n'),
+            },
+        ],
+        structuredContent: {
+            specId: analysis.specId,
+            specTitle: analysis.specTitle,
+            shouldSplit: analysis.shouldSplit,
+            reasons: analysis.reasons,
+            suggestedSplits: analysis.suggestedSplits,
+            criteriaCount: analysis.criteriaCount,
+            estimatedHours: analysis.estimatedHours,
+            ambiguousCriteria: analysis.ambiguousCriteria,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// split_spec
+// ---------------------------------------------------------------------------
+export async function handleSplitSpec(input) {
+    const { projectId, specId, proposedSplits } = input;
+    const spec = await specStore.getSpec(projectId, specId);
+    if (!spec) {
+        return {
+            content: [{ type: 'text', text: `Spec "${specId}" not found in project "${projectId}"` }],
+            isError: true,
+        };
+    }
+    // Resolve proposals: use provided or auto-generate
+    let proposals;
+    if (proposedSplits && proposedSplits.length > 0) {
+        proposals = proposedSplits;
+    }
+    else {
+        const specWithCriteria = await enrichSpecWithCriteria(spec);
+        const analysis = analyzeSpecSize(specWithCriteria);
+        proposals = analysis.suggestedSplits;
+    }
+    if (proposals.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `No split proposals available for spec "${specId}". Run analyze_spec_size first.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Load all existing specs to determine next available IDs
+    const allSpecs = await specStore.listSpecs(projectId);
+    const maxId = Math.max(0, ...allSpecs.map((s) => {
+        const match = /^SPEC-(\d+)$/.exec(s.id);
+        return match?.[1] ? parseInt(match[1], 10) : 0;
+    }));
+    const nextIdFn = (index) => {
+        const num = maxId + index + 1;
+        return `SPEC-${String(num).padStart(3, '0')}`;
+    };
+    // Build child specs
+    const childSpecs = buildChildSpecs(spec, proposals, nextIdFn);
+    const childIds = childSpecs.map((c) => c.id);
+    // Persist child specs and create their directories
+    for (const child of childSpecs) {
+        await mkdir(dirname(child.specPath), { recursive: true });
+        const content = buildChildSpecContent(child, spec);
+        await writeFile(child.specPath, content, 'utf-8');
+        await writeFile(child.technicalPath, buildChildTechnicalContent(child, spec), 'utf-8');
+        if (child.progressPath) {
+            await writeFile(child.progressPath, generateProgressContent(child), 'utf-8');
+        }
+        await specStore.createSpec(projectId, child);
+    }
+    // Mark original as superseded
+    await specStore.updateSpec(projectId, specId, {
+        status: 'superseded',
+        reviewNotes: [...(spec.reviewNotes ?? []), `Superseded by: ${childIds.join(', ')}`],
+    });
+    const lines = [
+        `# Split Complete — ${specId}`,
+        '',
+        `**Original spec** \`${specId}\` has been marked as \`superseded\`.`,
+        '',
+        `## Child Specs Created (${String(childSpecs.length)})`,
+        '',
+    ];
+    for (const child of childSpecs) {
+        lines.push(`- \`${child.id}\` — ${child.title}`);
+    }
+    lines.push('');
+    lines.push('Each child spec inherits tags and target from the original.');
+    lines.push('Implement child specs in dependency order.');
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        structuredContent: {
+            originalSpecId: specId,
+            supersededBy: childIds,
+            childSpecIds: childIds,
+            childTitles: childSpecs.map((c) => c.title),
+            message: `Spec ${specId} split into ${String(childSpecs.length)} child specs`,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Read spec.md and extract acceptance criteria lines as reviewNotes proxy */
+async function enrichSpecWithCriteria(spec) {
+    /* v8 ignore start -- filesystem reads tested via integration */
+    try {
+        const content = await readFile(spec.specPath, 'utf-8');
+        const criteria = extractAcFromContent(content);
+        return {
+            ...spec,
+            reviewNotes: criteria.length > 0 ? criteria : (spec.reviewNotes ?? []),
+        };
+    }
+    catch {
+        return spec;
+    }
+    /* v8 ignore stop */
+}
+/** Extract acceptance criteria from spec.md content */
+function extractAcFromContent(content) {
+    const acSection = /##\s+Acceptance Criteria\s*\n([\s\S]*?)(?=\n##\s|$)/i.exec(content);
+    if (!acSection?.[1]) {
+        return [];
+    }
+    return acSection[1]
+        .split('\n')
+        .map((line) => line.replace(/^[-*]\s*\[[ x]\]\s*/i, '').trim())
+        .filter((line) => line.length > 10);
+}
+/** Generate minimal spec.md content for a child spec */
+function buildChildSpecContent(child, original) {
+    const now = new Date().toISOString().split('T')[0] ?? '';
+    return [
+        '---',
+        `id: ${child.id}`,
+        `title: "${child.title}"`,
+        `type: ${child.type}`,
+        `scope: ${child.scope}`,
+        `target: ${child.target}`,
+        `status: draft`,
+        `difficulty: ${String(child.difficulty)}`,
+        `risk: ${child.risk}`,
+        `tags: [${child.tags.map((t) => JSON.stringify(t)).join(', ')}]`,
+        `created: ${now}`,
+        '---',
+        '',
+        `# ${child.id}: ${child.title}`,
+        '',
+        '## Description',
+        '',
+        child.reviewNotes?.[0] ?? `Split from ${original.id}: ${original.title}`,
+        '',
+        '## Acceptance Criteria',
+        '',
+        '- [ ] Implementation matches spec requirements',
+        '- [ ] Tests written and passing',
+        '',
+        '## Out of Scope',
+        '',
+        `- Criteria addressed by sibling specs split from ${original.id}`,
+        '',
+    ].join('\n');
+}
+/** Generate minimal technical.md content for a child spec */
+function buildChildTechnicalContent(child, original) {
+    return [
+        `# ${child.id}: ${child.title} — Technical`,
+        '',
+        `## Parent Spec`,
+        '',
+        `Split from \`${original.id}\`: ${original.title}`,
+        '',
+        '## Estimation',
+        '',
+        `| Dev Hours | ${String(child.estimation.devHours)}h |`,
+        `|-----------|--------|`,
+        `| Review Hours | ${String(child.estimation.reviewHours)}h |`,
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=spec-split-handler.js.map

package/dist/tools/spec-split-handler.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"status-handler.d.ts","sourceRoot":"","sources":["../../src/tools/status-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAIhB,MAAM,mBAAmB,CAAC;AA8I3B,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAgCjF"}
+{"version":3,"file":"status-handler.d.ts","sourceRoot":"","sources":["../../src/tools/status-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAIhB,MAAM,mBAAmB,CAAC;AAgM3B,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAkCjF"}

package/dist/tools/status-handler.js

@@ -4,6 +4,8 @@ import { execFile as execFileCb } from 'node:child_process';
 import { promisify } from 'node:util';
 import { join } from 'node:path';
 import { shouldSuggestBtw, buildBtwHint } from '../engine/context-advisor/btw-advisor.js';
+import { getPolicy, getRecords } from '../storage/approval-store.js';
+import { calculateSLAStatus } from '../engine/approval-workflow.js';
 const execFile = promisify(execFileCb);
 // ---------------------------------------------------------------------------
 // Git helpers
@@ -69,6 +71,33 @@ async function getStatusSpecSnapshot(projectId) {
         return { active: null, next: null, queueCount: 0 };
     }
 }
+async function getSLABreaches(projectId) {
+    try {
+        const policy = await getPolicy(projectId);
+        if (policy === null) {
+            return [];
+        }
+        const specs = await listSpecs(projectId);
+        const reviewSpecs = specs.filter((s) => s.status === 'review');
+        const breaches = [];
+        for (const spec of reviewSpecs) {
+            const records = await getRecords(projectId, spec.id);
+            void records;
+            const sla = calculateSLAStatus(spec.updatedAt, policy);
+            if (sla.slaBreached) {
+                breaches.push({
+                    specId: spec.id,
+                    slaBreachHours: sla.slaBreachHours,
+                    escalateTo: policy.escalateTo,
+                });
+            }
+        }
+        return breaches;
+    }
+    catch {
+        return [];
+    }
+}
 // ---------------------------------------------------------------------------
 // Suggestion logic
 // ---------------------------------------------------------------------------
@@ -85,7 +114,7 @@ function buildSuggestion(snapshot) {
 // Output builder
 // ---------------------------------------------------------------------------
 function buildOutput(params) {
-    const { snapshot, git, ci } = params;
+    const { snapshot, git, ci, slaBreaches } = params;
     const lines = ['Planu Status', '━━━━━━━━━━━━━━━'];
     if (snapshot.active !== null) {
         const title = snapshot.active.title.slice(0, 40);
@@ -108,6 +137,12 @@ function buildOutput(params) {
     if (ci !== null) {
         lines.push(`CI        ${ci}`);
     }
+    if (slaBreaches !== undefined && slaBreaches.length > 0) {
+        for (const b of slaBreaches) {
+            lines.push(`SLA BREACH  ${b.specId} exceeded by ${String(b.slaBreachHours)}h` +
+                (b.escalateTo !== undefined ? ` — escalate: ${b.escalateTo}` : ''));
+        }
+    }
     lines.push(`SUGGEST   ${buildSuggestion(snapshot)}`);
     return lines.join('\n');
 }
@@ -116,12 +151,13 @@ function buildOutput(params) {
 // ---------------------------------------------------------------------------
 export async function handlePlanStatus(args) {
     const projectId = args.projectId ?? hashProjectPath(args.projectPath);
-    const [snapshot, git, ci] = await Promise.all([
+    const [snapshot, git, ci, slaBreaches] = await Promise.all([
         getStatusSpecSnapshot(projectId),
         getGitState(args.projectPath),
         getCiState(args.projectPath),
+        getSLABreaches(projectId),
     ]);
-    const text = buildOutput({ snapshot, git, ci });
+    const text = buildOutput({ snapshot, git, ci, slaBreaches });
     // SPEC-256: Always show /btw hint as educational tip (no context percent available from MCP layer)
     const DEMO_CONTEXT_PERCENT = 65;
     const btwHint = shouldSuggestBtw(DEMO_CONTEXT_PERCENT)
@@ -137,6 +173,7 @@ export async function handlePlanStatus(args) {
             queueCount: snapshot.queueCount,
             git,
             ci,
+            slaBreaches: slaBreaches.length > 0 ? slaBreaches : undefined,
             ...(btwHint !== undefined ? { btw_hint: btwHint } : {}),
         },
     };

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

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

package/dist/tools/sync-ai-configs.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import type { ToolResult } from '../types/index.js';
+export declare const SyncAiConfigsSchema: {
+    readonly projectPath: z.ZodString;
+    readonly projectId: z.ZodOptional<z.ZodString>;
+    readonly force: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function handleSyncAiConfigs(input: {
+    projectPath: string;
+    projectId?: string;
+    force?: boolean;
+}): Promise<ToolResult>;
+export declare function registerSyncAiConfigsTool(server: McpServer): void;
+//# sourceMappingURL=sync-ai-configs.d.ts.map

package/dist/tools/sync-ai-configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-ai-configs.d.ts","sourceRoot":"","sources":["../../src/tools/sync-ai-configs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAUpD,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AA0DX,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,UAAU,CAAC,CActB;AAMD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAejE"}

package/dist/tools/sync-ai-configs.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { detectAiTools } from '../engine/ai-integration/detector.js';
+import { generateConfigsForDetectedTools } from '../engine/ai-integration/universal-config-generator.js';
+import { safeTracked } from './safe-handler.js';
+// ---------------------------------------------------------------------------
+// Zod schema
+// ---------------------------------------------------------------------------
+export const SyncAiConfigsSchema = {
+    projectPath: z.string().describe('Absolute path to the project root'),
+    projectId: z.string().optional().describe('Project ID for Planu context'),
+    force: z.boolean().optional().describe('Overwrite existing configs'),
+};
+// ---------------------------------------------------------------------------
+// Formatter
+// ---------------------------------------------------------------------------
+function formatSyncResults(results, projectPath) {
+    const lines = [];
+    lines.push('# AI Config Sync Results');
+    lines.push('');
+    lines.push(`**Project**: ${projectPath}`);
+    lines.push('');
+    const generated = results.filter((r) => !r.skipped && r.filesGenerated.length > 0);
+    const skipped = results.filter((r) => r.skipped);
+    const errored = results.filter((r) => !r.skipped && r.filesGenerated.length === 0 && r.reason);
+    if (generated.length > 0) {
+        lines.push('## Files Updated');
+        lines.push('');
+        for (const r of generated) {
+            for (const f of r.filesGenerated) {
+                lines.push(`- \`${f}\` (${r.tool})`);
+            }
+        }
+        lines.push('');
+    }
+    if (skipped.length > 0) {
+        lines.push('## Skipped');
+        lines.push('');
+        for (const r of skipped) {
+            lines.push(`- **${r.tool}**: ${r.reason ?? 'No generator'}`);
+        }
+        lines.push('');
+    }
+    if (errored.length > 0) {
+        lines.push('## Errors');
+        lines.push('');
+        for (const r of errored) {
+            lines.push(`- **${r.tool}**: ${r.reason ?? 'Unknown error'}`);
+        }
+        lines.push('');
+    }
+    if (generated.length === 0 && errored.length === 0) {
+        lines.push('No configs were updated (no supported tools detected or all skipped).');
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export function handleSyncAiConfigs(input) {
+    const scan = detectAiTools(input.projectPath);
+    const detectedNames = scan.tools.filter((t) => t.detected).map((t) => t.name);
+    const results = generateConfigsForDetectedTools({
+        projectPath: input.projectPath,
+        projectName: input.projectPath.split('/').pop() ?? 'project',
+        stack: [],
+        approvedSpecs: [],
+        detectedTools: detectedNames,
+    });
+    const text = formatSyncResults(results, input.projectPath);
+    return Promise.resolve({ content: [{ type: 'text', text }] });
+}
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+export function registerSyncAiConfigsTool(server) {
+    server.registerTool('sync_ai_configs', {
+        description: 'Detect installed AI coding tools and synchronize their configuration files with the Planu SDD workflow. Generates .cursorrules, .windsurfrules, .aider.conf.yml, etc. for detected tools.',
+        inputSchema: SyncAiConfigsSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            title: 'Sync AI Configs',
+        },
+    }, safeTracked('sync_ai_configs', async (args) => handleSyncAiConfigs(args)));
+}
+//# sourceMappingURL=sync-ai-configs.js.map

package/dist/tools/sync-ai-configs.js.map

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

package/dist/tools/team-analytics-handler.d.ts

@@ -0,0 +1,5 @@
+import type { ToolResult } from '../types/index.js';
+import type { TeamAnalyticsInput } from '../types/team-analytics.js';
+export declare function handleTeamAnalytics(args: TeamAnalyticsInput): Promise<ToolResult>;
+export declare function handleWorkloadDistribution(args: TeamAnalyticsInput): Promise<ToolResult>;
+//# sourceMappingURL=team-analytics-handler.d.ts.map

package/dist/tools/team-analytics-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-analytics-handler.d.ts","sourceRoot":"","sources":["../../src/tools/team-analytics-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAarE,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA0CvF;AAMD,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4C9F"}

package/dist/tools/team-analytics-handler.js

@@ -0,0 +1,67 @@
+// tools/team-analytics-handler.ts — Handlers for team_analytics and workload_distribution (SPEC-297)
+import { listSpecs } from '../storage/spec-store.js';
+import { hashProjectPath } from '../storage/base-store.js';
+import { computeTeamAnalytics, computeWorkloadDistribution, } from '../engine/team-analytics-calculator.js';
+import { formatSuccess, formatError, toolResult } from './response-helpers.js';
+// ---------------------------------------------------------------------------
+// team_analytics handler
+// ---------------------------------------------------------------------------
+export async function handleTeamAnalytics(args) {
+    if (!args.projectPath || args.projectPath.trim().length === 0) {
+        return toolResult(formatError('projectPath is required', 'Provide the absolute path to your project root.'), undefined, true);
+    }
+    const projectId = hashProjectPath(args.projectPath);
+    const weeks = Math.min(Math.max(args.weeks ?? 4, 1), 52);
+    const specs = await listSpecs(projectId);
+    const result = computeTeamAnalytics(specs, weeks);
+    const lines = [
+        `Team Analytics — ${args.projectPath}`,
+        `Period: last ${String(weeks)} weeks | Total specs: ${String(result.teamSummary.totalSpecs)}`,
+        `Avg velocity: ${result.teamSummary.avgVelocity.toFixed(1)} specs/week | Top contributor: ${result.teamSummary.topContributor}`,
+        '',
+        '**Per-member metrics:**',
+    ];
+    for (const m of result.members) {
+        lines.push(`  ${m.name}:`);
+        lines.push(`    Completed: ${String(m.specsCompleted)} | WIP: ${String(m.currentWip)}`);
+        lines.push(`    Avg lead time: ${m.avgLeadTimeDays.toFixed(1)} days | Completion rate: ${(m.completionRate * 100).toFixed(0)}%`);
+        lines.push(`    Estimated hours: ${m.totalEstimatedHours.toFixed(0)}h`);
+    }
+    if (result.members.length === 0) {
+        lines.push('  No specs found for this project.');
+    }
+    const body = lines.join('\n');
+    return toolResult(formatSuccess('Team Analytics', body), result);
+}
+// ---------------------------------------------------------------------------
+// workload_distribution handler
+// ---------------------------------------------------------------------------
+export async function handleWorkloadDistribution(args) {
+    if (!args.projectPath || args.projectPath.trim().length === 0) {
+        return toolResult(formatError('projectPath is required', 'Provide the absolute path to your project root.'), undefined, true);
+    }
+    const projectId = hashProjectPath(args.projectPath);
+    const specs = await listSpecs(projectId);
+    const result = computeWorkloadDistribution(specs);
+    const lines = [
+        `Workload Distribution — ${args.projectPath}`,
+        '',
+        '**Current workload per member:**',
+    ];
+    for (const m of result.members) {
+        lines.push(`  ${m.name}: WIP=${String(m.wip)} | Backlog=${String(m.backlog)} | Est. hours=${m.estimatedHours.toFixed(0)}h`);
+    }
+    if (result.members.length === 0) {
+        lines.push('  No specs found for this project.');
+    }
+    if (result.imbalanceWarnings.length > 0) {
+        lines.push('');
+        lines.push('**Imbalance warnings:**');
+        for (const w of result.imbalanceWarnings) {
+            lines.push(`  - ${w.message}`);
+        }
+    }
+    const body = lines.join('\n');
+    return toolResult(formatSuccess('Workload Distribution', body), result);
+}
+//# sourceMappingURL=team-analytics-handler.js.map

package/dist/tools/team-analytics-handler.js.map

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

package/dist/tools/test-reverse-engineer-handler.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ToolResult } from '../types/index.js';
+export declare const ReverseEngineerTestsInputSchema: z.ZodObject<{
+    testFilePath: z.ZodString;
+    projectPath: z.ZodOptional<z.ZodString>;
+    createSpec: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ReverseEngineerTestsInput = z.infer<typeof ReverseEngineerTestsInputSchema>;
+/**
+ * Handle the reverse_engineer_tests tool.
+ * Parses a test file and extracts acceptance criteria.
+ * Optionally creates a Planu spec from the generated ACs.
+ */
+export declare function handleReverseEngineerTests(params: ReverseEngineerTestsInput): Promise<ToolResult>;
+//# sourceMappingURL=test-reverse-engineer-handler.d.ts.map

package/dist/tools/test-reverse-engineer-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-reverse-engineer-handler.d.ts","sourceRoot":"","sources":["../../src/tools/test-reverse-engineer-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKpD,eAAO,MAAM,+BAA+B;;;;iBAc1C,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAiCxF;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,UAAU,CAAC,CAkDrB"}