@planu/cli 1.11.0 → 1.12.0

package/dist/tools/register-ears.js

@@ -0,0 +1,148 @@
+// tools/register-ears.ts — EARS criteria quality tools (SPEC-410)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { lintSpec, lintAllSpecs } from '../engine/ears/spec-linter.js';
+import { scoreCriterion } from '../engine/ears/criterion-scorer.js';
+import { generateRewrites } from '../engine/ears/rewriter.js';
+import { detectEarsPattern } from '../engine/ears/pattern-matcher.js';
+export function registerEarsTools(server) {
+    // -------------------------------------------------------------------------
+    // validate_criteria_quality — score AC quality for a spec or raw criteria
+    // -------------------------------------------------------------------------
+    server.registerTool('validate_criteria_quality', {
+        description: 'Score acceptance criteria quality using EARS (Easy Approach to Requirements Syntax). ' +
+            'Detects vague language, scores testability and specificity (0-10 each), ' +
+            'identifies the EARS pattern, and suggests rewrites for low-scoring criteria. ' +
+            'Provide either specId (reads from spec file) or criteria (raw text array). ' +
+            'Returns per-criterion scores, overall grade (A-F), and rewrite suggestions.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root where planu/ directory lives.'),
+            specId: z
+                .string()
+                .min(1)
+                .max(500)
+                .optional()
+                .describe('Spec ID to validate (e.g. SPEC-042). Reads criteria from the spec file.'),
+            criteria: z
+                .array(z.string().min(1).max(2000))
+                .optional()
+                .describe('Raw acceptance criteria text array to score. Used when specId is not provided.'),
+        },
+        annotations: { title: 'Validate Criteria Quality', readOnlyHint: true },
+    }, safeTracked('validate_criteria_quality', async (args) => {
+        const { projectPath, specId, criteria } = args;
+        if (specId !== undefined) {
+            const report = await lintSpec(specId, projectPath);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(report, null, 2) }],
+            };
+        }
+        if (criteria !== undefined && criteria.length > 0) {
+            const scored = criteria.map(scoreCriterion);
+            const overallScore = scored.length > 0
+                ? Math.round((scored.reduce((sum, c) => sum + c.overallScore, 0) / scored.length) * 10) / 10
+                : 0;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ criteria: scored, overallScore }, null, 2),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Provide either specId or criteria array.',
+                },
+            ],
+            isError: true,
+        };
+    }));
+    // -------------------------------------------------------------------------
+    // rewrite_criteria_ears — score a single criterion and get EARS rewrites
+    // -------------------------------------------------------------------------
+    server.registerTool('rewrite_criteria_ears', {
+        description: 'Score a single acceptance criterion and generate 2 EARS-format rewrite suggestions. ' +
+            'Returns current testability and specificity scores, detected vagueness flags, ' +
+            'EARS pattern classification, and concrete rewrite alternatives. ' +
+            'No LLM call — rewrites are template-driven for consistency and speed.',
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            criterion: z
+                .string()
+                .min(1)
+                .max(2000)
+                .describe('The acceptance criterion text to score and rewrite.'),
+        },
+        annotations: { title: 'Rewrite Criteria as EARS', readOnlyHint: true },
+    }, safeTracked('rewrite_criteria_ears', (args) => {
+        const { criterion } = args;
+        const scored = scoreCriterion(criterion);
+        const pattern = detectEarsPattern(criterion);
+        const rewrites = generateRewrites(criterion, pattern);
+        return Promise.resolve({
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ ...scored, rewrites }, null, 2),
+                },
+            ],
+        });
+    }));
+    // -------------------------------------------------------------------------
+    // ears_lint — lint all specs in the project and report worst criteria
+    // -------------------------------------------------------------------------
+    server.registerTool('ears_lint', {
+        description: 'Lint all specs in the project for EARS compliance and criteria quality. ' +
+            'Returns project-wide average score, letter grade, and top 10 worst criteria ranked by score. ' +
+            'Use minScore to filter and only report criteria below a threshold. ' +
+            'Helpful for identifying which specs need the most improvement.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root where planu/specs/ directory lives.'),
+            minScore: z
+                .number()
+                .min(0)
+                .max(10)
+                .optional()
+                .describe('Optional score threshold (0-10). Only report criteria with overallScore below this value. ' +
+                'Defaults to 10 (report all criteria regardless of score).'),
+        },
+        annotations: { title: 'EARS Lint All Specs', readOnlyHint: true },
+    }, safeTracked('ears_lint', async (args) => {
+        const { projectPath, minScore } = args;
+        const report = await lintAllSpecs(projectPath);
+        const threshold = minScore ?? 10;
+        const filteredWorst = report.topWorstCriteria.filter((c) => c.score < threshold);
+        const summary = {
+            projectPath: report.projectPath,
+            totalSpecs: report.totalSpecs,
+            averageScore: report.averageScore,
+            grade: report.averageScore >= 9
+                ? 'A'
+                : report.averageScore >= 7
+                    ? 'B'
+                    : report.averageScore >= 5
+                        ? 'C'
+                        : report.averageScore >= 3
+                            ? 'D'
+                            : 'F',
+            topWorstCriteria: filteredWorst,
+            generatedAt: report.generatedAt,
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }],
+        };
+    }));
+}
+//# sourceMappingURL=register-ears.js.map

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

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

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

@@ -16,7 +16,7 @@ export function registerEnterpriseComplianceTools(s) {
         const projectId = hashProjectPath(projectPath);
         return handleComplianceGapAnalysis(projectId, framework);
     });
-    s.registerTool('generate_compliance_report', {
+    s.registerTool('generate_compliance_evidence', {
         description: 'Generates a compliance evidence package for a framework — includes control matrix, change management evidence from audit trail, and gap analysis.',
         inputSchema: {
             projectPath: z.string().describe('Absolute path to the project root'),

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

@@ -1 +1 @@
-{"version":3,"file":"register-enterprise-compliance.js","sourceRoot":"","sources":["../../src/tools/register-enterprise-compliance.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAG7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,aAAa,GAAG,CAAC;KACpB,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;KAC5D,QAAQ,CAAC,sEAAsE,CAAC,CAAC;AAEpF,MAAM,UAAU,iCAAiC,CAAC,CAAY;IAC5D,CAAC,CAAC,YAAY,CACZ,yBAAyB,EACzB;QACE,WAAW,EACT,4KAA4K;QAC9K,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACrE,SAAS,EAAE,aAAa;SACzB;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE;QACnC,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC/C,OAAO,2BAA2B,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC,CACF,CAAC;IAEF,CAAC,CAAC,YAAY,CACZ,4BAA4B,EAC5B;QACE,WAAW,EACT,mJAAmJ;QACrJ,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACrE,SAAS,EAAE,aAAa;SACzB;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE;QACnC,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC/C,OAAO,iCAAiC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"register-enterprise-compliance.js","sourceRoot":"","sources":["../../src/tools/register-enterprise-compliance.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAG7D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,aAAa,GAAG,CAAC;KACpB,IAAI,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;KAC5D,QAAQ,CAAC,sEAAsE,CAAC,CAAC;AAEpF,MAAM,UAAU,iCAAiC,CAAC,CAAY;IAC5D,CAAC,CAAC,YAAY,CACZ,yBAAyB,EACzB;QACE,WAAW,EACT,4KAA4K;QAC9K,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACrE,SAAS,EAAE,aAAa;SACzB;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE;QACnC,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC/C,OAAO,2BAA2B,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC,CACF,CAAC;IAEF,CAAC,CAAC,YAAY,CACZ,8BAA8B,EAC9B;QACE,WAAW,EACT,mJAAmJ;QACrJ,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACrE,SAAS,EAAE,aAAa;SACzB;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE;QACnC,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC/C,OAAO,iCAAiC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/register-pull-sync.d.ts

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

package/dist/tools/register-pull-sync.d.ts.map

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

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

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handlePullFromNotion, handlePullFromAsana, handlePullFromMonday, handleSyncAllIntegrations, } from './pull-sync-handler.js';
+const projectPathSchema = z
+    .string()
+    .min(1)
+    .max(4096)
+    .describe('Absolute path to the project root where Planu stores its data.');
+const conflictStrategySchema = z
+    .enum(['spec-wins', 'external-wins', 'newest-wins', 'manual'])
+    .describe('Conflict resolution strategy when a field differs between Planu and the external PM tool. ' +
+    '"spec-wins" keeps the Planu value (default). ' +
+    '"external-wins" applies the external value to Planu. ' +
+    '"newest-wins" picks whichever side was updated most recently. ' +
+    '"manual" flags the conflict for human review without resolving it.')
+    .default('spec-wins');
+const createMissingSchema = z
+    .boolean()
+    .optional()
+    .describe('When true, creates new Planu specs for external items that have no matching spec. ' +
+    'Default: false.');
+export function registerPullSyncTools(server) {
+    server.registerTool('pull_from_notion', {
+        description: 'Pull updates from Notion into Planu. ' +
+            'Compares Notion page status against the last-synced state and applies changes according ' +
+            'to the conflict resolution strategy. ' +
+            'Run configure_notion and sync_to_notion first to establish the sync mapping.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            conflictStrategy: conflictStrategySchema,
+            createMissing: createMissingSchema,
+        },
+        annotations: { title: 'Pull from Notion' },
+    }, safeLicensed('pull_from_notion', (args) => handlePullFromNotion(args)));
+    server.registerTool('pull_from_asana', {
+        description: 'Pull updates from Asana into Planu. ' +
+            'Compares Asana task completion state against the last-synced state and applies changes ' +
+            'according to the conflict resolution strategy. ' +
+            'Run configure_asana and sync_to_asana first to establish the sync mapping.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            conflictStrategy: conflictStrategySchema,
+            createMissing: createMissingSchema,
+        },
+        annotations: { title: 'Pull from Asana' },
+    }, safeLicensed('pull_from_asana', (args) => handlePullFromAsana(args)));
+    server.registerTool('pull_from_monday', {
+        description: 'Pull updates from Monday.com into Planu. ' +
+            'Compares Monday.com item status against the last-synced state and applies changes ' +
+            'according to the conflict resolution strategy. ' +
+            'Run configure_monday and sync_to_monday first to establish the sync mapping.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            conflictStrategy: conflictStrategySchema,
+            createMissing: createMissingSchema,
+        },
+        annotations: { title: 'Pull from Monday.com' },
+    }, safeLicensed('pull_from_monday', (args) => handlePullFromMonday(args)));
+    server.registerTool('sync_all_integrations', {
+        description: 'Run pull sync for all configured PM integrations (Notion, Asana, Monday.com) in one call. ' +
+            'Idempotent — safe to run repeatedly. ' +
+            'Only syncs integrations that have been configured with their respective configure_* tools. ' +
+            'Returns a unified summary of updates pulled and conflicts resolved across all integrations.',
+        inputSchema: {
+            projectPath: projectPathSchema,
+            conflictStrategy: conflictStrategySchema,
+        },
+        annotations: { title: 'Sync All Integrations' },
+    }, safeLicensed('sync_all_integrations', (args) => handleSyncAllIntegrations(args)));
+}
+//# sourceMappingURL=register-pull-sync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-pull-sync.js","sourceRoot":"","sources":["../../src/tools/register-pull-sync.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,GAK1B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,iBAAiB,GAAG,CAAC;KACxB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,IAAI,CAAC;KACT,QAAQ,CAAC,gEAAgE,CAAC,CAAC;AAE9E,MAAM,sBAAsB,GAAG,CAAC;KAC7B,IAAI,CAAC,CAAC,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;KAC7D,QAAQ,CACP,4FAA4F;IAC1F,+CAA+C;IAC/C,uDAAuD;IACvD,gEAAgE;IAChE,oEAAoE,CACvE;KACA,OAAO,CAAC,WAAW,CAAC,CAAC;AAExB,MAAM,mBAAmB,GAAG,CAAC;KAC1B,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,QAAQ,CACP,oFAAoF;IAClF,iBAAiB,CACpB,CAAC;AAEJ,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,uCAAuC;YACvC,0FAA0F;YAC1F,uCAAuC;YACvC,8EAA8E;QAChF,WAAW,EAAE;YACX,WAAW,EAAE,iBAAiB;YAC9B,gBAAgB,EAAE,sBAAsB;YACxC,aAAa,EAAE,mBAAmB;SACnC;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE;KAC3C,EACD,YAAY,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAA2B,CAAC,CAAC,CAC9F,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,sCAAsC;YACtC,yFAAyF;YACzF,iDAAiD;YACjD,4EAA4E;QAC9E,WAAW,EAAE;YACX,WAAW,EAAE,iBAAiB;YAC9B,gBAAgB,EAAE,sBAAsB;YACxC,aAAa,EAAE,mBAAmB;SACnC;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE;KAC1C,EACD,YAAY,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAA0B,CAAC,CAAC,CAC3F,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,2CAA2C;YAC3C,oFAAoF;YACpF,iDAAiD;YACjD,8EAA8E;QAChF,WAAW,EAAE;YACX,WAAW,EAAE,iBAAiB;YAC9B,gBAAgB,EAAE,sBAAsB;YACxC,aAAa,EAAE,mBAAmB;SACnC;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE;KAC/C,EACD,YAAY,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAA2B,CAAC,CAAC,CAC9F,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,4FAA4F;YAC5F,uCAAuC;YACvC,6FAA6F;YAC7F,6FAA6F;QAC/F,WAAW,EAAE;YACX,WAAW,EAAE,iBAAiB;YAC9B,gBAAgB,EAAE,sBAAsB;SACzC;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE;KAChD,EACD,YAAY,CAAC,uBAAuB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC7C,yBAAyB,CAAC,IAAgC,CAAC,CAC5D,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register SPEC-405 tools on the MCP server.
+ * Call this from src/index.ts after all other tool registrations.
+ */
+export declare function registerSpec405Tools(server: McpServer): void;
+//# sourceMappingURL=register-spec405-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec405-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-spec405-tools.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+P5D"}

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

@@ -0,0 +1,194 @@
+// tools/register-spec405-tools.ts — SPEC-405
+// Registers four pro tools with real engine logic:
+//   1. check_api_compatibility_v2  — compare API surfaces of two specs
+//   2. critical_path_analyzer_v2   — DAG-based critical path with frontmatter deps
+//   3. similar_problems_finder_v2  — cross-project similarity search
+//   4. suggest_mcp_catalog         — recommend external MCP servers from catalog
+//
+// AUTO-TRIGGER NOTE (suggest_mcp_catalog):
+// This tool should be auto-triggered from create-spec.ts after a spec is
+// created, if the description contains any of the catalog keywords
+// (database, payment, github, email, slack, search, etc.).
+// Integration point: after `specStore.create(...)` resolves, call
+// `suggestMcpServers(args.description)` and append suggestions to the
+// response text when results.suggestions.length > 0.
+import { z } from 'zod';
+import { safeTracked, safeLicensed } from './safe-handler.js';
+import { formatSuccess, formatError, toolResult } from './response-helpers.js';
+import { checkApiCompatibility } from '../engine/api-compat/compatibility-checker.js';
+import { analyzeCriticalPath } from '../engine/critical-path/path-analyzer.js';
+import { findSimilarProblems } from '../engine/similar-problems/similarity-finder.js';
+import { suggestMcpServers } from '../engine/mcp-catalog/catalog-advisor.js';
+/**
+ * Register SPEC-405 tools on the MCP server.
+ * Call this from src/index.ts after all other tool registrations.
+ */
+export function registerSpec405Tools(server) {
+    // ---------------------------------------------------------------------------
+    // 1. check_api_compatibility_v2
+    // ---------------------------------------------------------------------------
+    server.registerTool('check_api_compatibility_v2', {
+        description: 'Compare the API surfaces of two specs by scanning their spec.md files for REST endpoints, GraphQL types, and events. Returns breaking changes, additive changes, and a compatibility score 0-100.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            specId1: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('First spec ID (e.g. SPEC-001). Will read planu/specs/SPEC-001-*/spec.md'),
+            specId2: z
+                .string()
+                .min(1)
+                .max(500)
+                .describe('Second spec ID (e.g. SPEC-002). Will read planu/specs/SPEC-002-*/spec.md'),
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root where planu/specs/ lives'),
+        },
+    }, safeLicensed('check_api_compatibility_v2', async (args) => {
+        const { specId1, specId2, projectPath } = args;
+        if (!projectPath.trim()) {
+            return toolResult(formatError('projectPath is required'), undefined, true);
+        }
+        if (!specId1.trim() || !specId2.trim()) {
+            return toolResult(formatError('specId1 and specId2 are required'), undefined, true);
+        }
+        const result = await checkApiCompatibility(specId1, specId2, projectPath);
+        const lines = [
+            `Compatibility: ${result.compatible ? 'COMPATIBLE' : 'BREAKING CHANGES DETECTED'}`,
+            `Score: ${String(result.score)}/100`,
+            `Breaking changes: ${String(result.breakingChanges.length)}`,
+            `Additive changes: ${String(result.additiveChanges.length)}`,
+        ];
+        if (result.breakingChanges.length > 0) {
+            lines.push('', 'Breaking:');
+            for (const c of result.breakingChanges) {
+                lines.push(`  - [${c.type}] ${c.item}`);
+            }
+        }
+        if (result.additiveChanges.length > 0) {
+            lines.push('', 'Additive:');
+            for (const c of result.additiveChanges) {
+                lines.push(`  - [${c.type}] ${c.item}`);
+            }
+        }
+        return toolResult(formatSuccess('API Compatibility Check', lines.join('\n')), result);
+    }));
+    // ---------------------------------------------------------------------------
+    // 2. critical_path_analyzer_v2
+    // ---------------------------------------------------------------------------
+    server.registerTool('critical_path_analyzer_v2', {
+        description: 'Analyze all specs in a project using frontmatter dependencies and estimatedHours to compute the true critical path, parallelizable specs, and scheduling bottlenecks.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root where planu/specs/ lives'),
+        },
+    }, safeLicensed('critical_path_analyzer_v2', async (args) => {
+        const { projectPath } = args;
+        if (!projectPath.trim()) {
+            return toolResult(formatError('projectPath is required'), undefined, true);
+        }
+        const result = await analyzeCriticalPath(projectPath);
+        const lines = [
+            `Total hours: ${result.totalHours.toFixed(1)}h`,
+            `Critical path (${String(result.criticalPath.length)} specs): ${result.criticalPath.join(' → ') || '(none)'}`,
+            `Parallelizable specs: ${String(result.parallelizableSpecs.length)}`,
+            `Bottlenecks: ${result.bottlenecks.join(', ') || '(none)'}`,
+        ];
+        return toolResult(formatSuccess('Critical Path Analysis', lines.join('\n')), result);
+    }));
+    // ---------------------------------------------------------------------------
+    // 3. similar_problems_finder_v2
+    // ---------------------------------------------------------------------------
+    server.registerTool('similar_problems_finder_v2', {
+        description: 'Find specs with similar problems across all registered projects using Jaccard similarity on titles and tags. Returns top 5 matches with similarity score and matching keywords.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root (used as the primary project)'),
+            description: z
+                .string()
+                .min(1)
+                .max(2000)
+                .describe('Free-text description of the problem to search for (e.g. "implement OAuth login with Google")'),
+            specId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Optional spec ID to use as additional context for similarity matching'),
+        },
+    }, safeTracked('similar_problems_finder_v2', async (args) => {
+        const { projectPath, description, specId } = args;
+        if (!projectPath.trim()) {
+            return toolResult(formatError('projectPath is required'), undefined, true);
+        }
+        if (!description.trim()) {
+            return toolResult(formatError('description is required'), undefined, true);
+        }
+        const result = await findSimilarProblems(description, projectPath, specId);
+        const lines = [
+            `Query: "${result.query}"`,
+            `Searched: ${String(result.totalSearched)} specs across all registered projects`,
+            `Found: ${String(result.results.length)} similar spec(s)`,
+            '',
+        ];
+        for (const r of result.results) {
+            lines.push(`  [${(r.similarityScore * 100).toFixed(0)}%] ${r.specId}: ${r.title}`, `    Project: ${r.projectPath}`, `    Matches: ${r.keyMatches.join(', ')}`);
+        }
+        if (result.results.length === 0) {
+            lines.push('  No similar specs found.');
+        }
+        return toolResult(formatSuccess('Similar Problems Finder', lines.join('\n')), result);
+    }));
+    // ---------------------------------------------------------------------------
+    // 4. suggest_mcp_catalog
+    // ---------------------------------------------------------------------------
+    server.registerTool('suggest_mcp_catalog', {
+        description: 'Suggest external MCP servers from a curated catalog based on your project description or tech stack. Returns top 5 matches with install commands and rationale.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            description: z
+                .string()
+                .min(1)
+                .max(2000)
+                .describe('Description of what you need (e.g. "send transactional emails and store user data in postgres")'),
+            stack: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Optional tech stack hint (e.g. "nextjs stripe supabase")'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Project path (unused for catalog lookup, kept for consistency)'),
+        },
+    }, safeTracked('suggest_mcp_catalog', (args) => {
+        const { description, stack } = args;
+        if (!description.trim()) {
+            return Promise.resolve(toolResult(formatError('description is required'), undefined, true));
+        }
+        const result = suggestMcpServers(description, stack);
+        if (result.suggestions.length === 0) {
+            return Promise.resolve(toolResult(formatSuccess('MCP Catalog Suggestions', 'No matching MCP servers found for your description. Try using more specific keywords (e.g. database, payment, email, github, slack).'), result));
+        }
+        const lines = [
+            `Found ${String(result.suggestions.length)} MCP server suggestion(s) for: "${result.query}"`,
+            '',
+        ];
+        for (const s of result.suggestions) {
+            lines.push(`**${s.name}** — ${s.description}`, `  Install: \`${s.installCommand}\``, `  Rationale: ${s.rationale}`, `  Use cases: ${s.useCases.join(', ')}`, '');
+        }
+        return Promise.resolve(toolResult(formatSuccess('MCP Catalog Suggestions', lines.join('\n')), result));
+    }));
+}
+//# sourceMappingURL=register-spec405-tools.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-verifier.d.ts","sourceRoot":"","sources":["../../src/tools/register-verifier.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0EzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6F7D"}

package/dist/tools/register-verifier.js

@@ -0,0 +1,141 @@
+// tools/register-verifier.ts — Verifier Agent tools (SPEC-406)
+// AUTO-TRIGGER: verify_spec_compliance should be called automatically
+// when update_status(done) is invoked. Integration point in src/tools/update-status/index.ts
+// The coordinator will wire this after SPEC-406 is merged.
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { scoreCompliance } from '../engine/verifier/compliance-scorer.js';
+import { saveComplianceScore, getAllComplianceScores } from '../storage/compliance-score-store.js';
+import { hashProjectPath } from '../storage/base-store.js';
+// ---------------------------------------------------------------------------
+// Formatters
+// ---------------------------------------------------------------------------
+function formatScore(score) {
+    const levelEmoji = score.level === 'compliant' ? '✅' : score.level === 'partial' ? '⚠️' : '❌';
+    const lines = [
+        `## Compliance Report — ${score.specId}`,
+        '',
+        `**Score**: ${score.score}/100 ${levelEmoji} (${score.level})`,
+        `**Checked at**: ${score.checkedAt}`,
+        '',
+        `| Criteria | Count |`,
+        `|----------|-------|`,
+        `| Total    | ${score.totalCriteria} |`,
+        `| Verified | ${score.verifiedCriteria} |`,
+        `| Partial  | ${score.partialCriteria} |`,
+        `| Unverified | ${score.unverifiedCriteria} |`,
+    ];
+    if (score.criteriaDetails.length > 0) {
+        lines.push('', '### Criteria Details', '');
+        for (const detail of score.criteriaDetails) {
+            const icon = detail.status === 'verified' ? '✅' : detail.status === 'partial' ? '⚠️' : '❌';
+            lines.push(`${icon} **${detail.status.toUpperCase()}**: ${detail.criterion}`);
+            if (detail.evidence.length > 0) {
+                lines.push(`   Evidence: ${detail.evidence.slice(0, 3).join(', ')}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+function formatReport(report) {
+    const lines = [
+        `## Compliance Score Report`,
+        '',
+        `**Project**: ${report.projectPath}`,
+        `**Generated**: ${report.generatedAt}`,
+        `**Overall Average**: ${report.overallAverage.toFixed(1)}/100`,
+        '',
+        `| Status | Count |`,
+        `|--------|-------|`,
+        `| Total Specs | ${report.totalSpecs} |`,
+        `| Compliant (≥80) | ${report.compliantCount} |`,
+        `| Partial (60-79) | ${report.partialCount} |`,
+        `| Non-compliant (<60) | ${report.nonCompliantCount} |`,
+    ];
+    if (report.scores.length > 0) {
+        lines.push('', '### Per-Spec Scores', '');
+        lines.push('| Spec ID | Score | Level |');
+        lines.push('|---------|-------|-------|');
+        for (const s of report.scores) {
+            lines.push(`| ${s.specId} | ${s.score} | ${s.level} |`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+export function registerVerifierTools(server) {
+    // Tool 1: verify_spec_compliance
+    server.registerTool('verify_spec_compliance', {
+        description: 'Verifier Agent: checks whether implemented code matches an approved spec. ' +
+            'Reads acceptance criteria from spec.md, searches the codebase for evidence, ' +
+            'and computes a compliance score (0-100). ' +
+            'Score ≥80 = compliant, 60-79 = partial, <60 = non-compliant. ' +
+            'Results are persisted and retrievable via compliance_score_report.',
+        annotations: { readOnlyHint: false },
+        inputSchema: {
+            specId: z
+                .string()
+                .max(500)
+                .describe('Spec ID to verify (e.g. SPEC-042). Must match the directory name in planu/specs/.'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .describe('Absolute path to the project root containing planu/specs/ and source code.'),
+        },
+    }, safeLicensed('verify_spec_compliance', async (args) => {
+        const { specId, projectPath } = args;
+        const score = await scoreCompliance(specId, projectPath);
+        const projectId = hashProjectPath(projectPath);
+        await saveComplianceScore(projectId, score);
+        return {
+            content: [{ type: 'text', text: formatScore(score) }],
+        };
+    }));
+    // Tool 2: compliance_score_report
+    server.registerTool('compliance_score_report', {
+        description: 'Returns a project-wide compliance summary showing all previously computed spec compliance scores. ' +
+            'Run verify_spec_compliance for each spec first to populate the report. ' +
+            'Optionally filter by minimum score to surface only specs below a threshold.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().max(4096).describe('Absolute path to the project root.'),
+            minScore: z
+                .number()
+                .min(0)
+                .max(100)
+                .optional()
+                .describe('Only include specs with score below this value (e.g. 80 to show non-compliant only). Default: show all.'),
+        },
+    }, safeLicensed('compliance_score_report', async (args) => {
+        const { projectPath, minScore } = args;
+        const projectId = hashProjectPath(projectPath);
+        const allScores = await getAllComplianceScores(projectId);
+        let scores = Object.values(allScores);
+        if (minScore !== undefined) {
+            scores = scores.filter((s) => s.score < minScore);
+        }
+        // Sort by score ascending (worst first)
+        scores.sort((a, b) => a.score - b.score);
+        const totalSpecs = scores.length;
+        const compliantCount = scores.filter((s) => s.level === 'compliant').length;
+        const partialCount = scores.filter((s) => s.level === 'partial').length;
+        const nonCompliantCount = scores.filter((s) => s.level === 'non-compliant').length;
+        const overallAverage = totalSpecs > 0 ? scores.reduce((sum, s) => sum + s.score, 0) / totalSpecs : 0;
+        const report = {
+            projectPath,
+            overallAverage: Math.round(overallAverage * 10) / 10,
+            totalSpecs,
+            compliantCount,
+            partialCount,
+            nonCompliantCount,
+            scores,
+            generatedAt: new Date().toISOString(),
+        };
+        return {
+            content: [{ type: 'text', text: formatReport(report) }],
+        };
+    }));
+}
+//# sourceMappingURL=register-verifier.js.map