@planu/cli 0.91.0 → 0.93.0

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

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

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

@@ -0,0 +1,62 @@
+// tools/register-confluence-tools.ts — Registers Confluence Sync tools on the MCP server (SPEC-294)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureConfluence, handleSyncToConfluence, handleConfluenceStatus, handleRemoveConfluence, } from './confluence-handler.js';
+export function registerConfluenceTools(server) {
+    server.registerTool('configure_confluence', {
+        description: '[Pro] Configure Confluence integration for a project. Stores the connection settings (base URL, space key, parent page, and API credentials) so that specs can be synced to Confluence pages.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            baseUrl: z
+                .string()
+                .describe('Base URL of the Confluence instance, e.g. https://mycompany.atlassian.net/wiki'),
+            spaceKey: z
+                .string()
+                .describe('Confluence space key where pages will be created, e.g. "ENG".'),
+            parentPageId: z
+                .string()
+                .describe('ID of the parent Confluence page under which spec pages will be nested.'),
+            apiToken: z
+                .string()
+                .describe('Atlassian API token for authentication (generate at id.atlassian.com).'),
+            email: z
+                .string()
+                .describe('Email address associated with the Atlassian account / API token.'),
+        },
+        annotations: { title: 'Configure Confluence', destructiveHint: false },
+    }, safeTracked('configure_confluence', async (args) => handleConfigureConfluence(args)));
+    server.registerTool('sync_to_confluence', {
+        description: '[Pro] Sync approved and done specs to Confluence pages. Creates new pages or updates existing ones. Optionally restrict to a single spec with specId.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            specId: z
+                .string()
+                .optional()
+                .describe('Optional SPEC-XXX ID to sync a single spec (e.g. SPEC-042). Omit to sync all approved/done specs.'),
+        },
+        annotations: { title: 'Sync to Confluence', destructiveHint: false },
+    }, safeTracked('sync_to_confluence', async (args) => handleSyncToConfluence(args)));
+    server.registerTool('confluence_status', {
+        description: 'Show the current Confluence integration status: connection config, number of synced pages, and recent sync history.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+        },
+        annotations: { title: 'Confluence Status', readOnlyHint: true },
+    }, safeTracked('confluence_status', async (args) => handleConfluenceStatus(args)));
+    server.registerTool('remove_confluence', {
+        description: '[Pro] Remove the Confluence configuration for a project. Synced page records and logs are preserved but no further syncs will be possible until reconfigured.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+        },
+        annotations: { title: 'Remove Confluence Config', destructiveHint: true },
+    }, safeTracked('remove_confluence', async (args) => handleRemoveConfluence(args)));
+}
+//# sourceMappingURL=register-confluence-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-confluence-tools.js","sourceRoot":"","sources":["../../src/tools/register-confluence-tools.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAGpG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAQjC,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,WAAW,EACT,+LAA+L;QACjM,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,CACP,gFAAgF,CACjF;YACH,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CAAC,+DAA+D,CAAC;YAC5E,YAAY,EAAE,CAAC;iBACZ,MAAM,EAAE;iBACR,QAAQ,CAAC,yEAAyE,CAAC;YACtF,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CAAC,wEAAwE,CAAC;YACrF,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CAAC,kEAAkE,CAAC;SAChF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,KAAK,EAAE;KACvE,EACD,WAAW,CAAC,sBAAsB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACjD,yBAAyB,CAAC,IAAgC,CAAC,CAC5D,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,WAAW,EACT,uJAAuJ;QACzJ,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,mGAAmG,CACpG;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,KAAK,EAAE;KACrE,EACD,WAAW,CAAC,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC/C,sBAAsB,CAAC,IAA6B,CAAC,CACtD,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,qHAAqH;QACvH,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;SAC/E;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,IAAI,EAAE;KAChE,EACD,WAAW,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC9C,sBAAsB,CAAC,IAA6B,CAAC,CACtD,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,+JAA+J;QACjK,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;SAC/E;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,eAAe,EAAE,IAAI,EAAE;KAC1E,EACD,WAAW,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC9C,sBAAsB,CAAC,IAA6B,CAAC,CACtD,CACF,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"register-coverage-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-coverage-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwB7D"}
+{"version":3,"file":"register-coverage-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-coverage-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqC7D"}

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

@@ -3,6 +3,7 @@
 import { z } from 'zod';
 import { safeLicensed } from './safe-handler.js';
 import { handleSpecCoverage } from './spec-coverage.js';
+import { resolveProjectId, missingProjectIdError } from './resolve-project-id.js';
 /**
  * Registers the spec_coverage tool (SPEC-068) on the MCP server.
  * Requires a paid plan — coverage analysis is a Pro feature.
@@ -13,7 +14,12 @@ export function registerCoverageTools(server) {
             'Performs static analysis across 10 ecosystems (TypeScript, Python, Go, Java, Rust, Swift, C#, PHP, Ruby, Kotlin). ' +
             'Returns a per-criterion breakdown with coverage grade (A/B/C/D) and identifies untested criteria as risk items.',
         inputSchema: {
-            projectId: z.string().max(500).describe('Project ID returned by init_project'),
+            projectId: z.string().max(500).optional().describe('Project ID hash. Prefer projectPath.'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Absolute path to project root. Derives projectId automatically.'),
             specId: z
                 .string()
                 .max(500)
@@ -23,6 +29,12 @@ export function registerCoverageTools(server) {
             title: 'Spec Test Coverage',
             readOnlyHint: true,
         },
-    }, safeLicensed('spec_coverage', async (args) => handleSpecCoverage(args)));
+    }, safeLicensed('spec_coverage', async (args) => {
+        const pid = resolveProjectId(args);
+        if (!pid) {
+            return missingProjectIdError;
+        }
+        return handleSpecCoverage({ ...args, projectId: pid });
+    }));
 }
 //# sourceMappingURL=register-coverage-tools.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"register-coverage-tools.js","sourceRoot":"","sources":["../../src/tools/register-coverage-tools.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,oCAAoC;AAGpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,gGAAgG;YAChG,oHAAoH;YACpH,iHAAiH;QACnH,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YAC9E,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CACP,sFAAsF,CACvF;SACJ;QACD,WAAW,EAAE;YACX,KAAK,EAAE,oBAAoB;YAC3B,YAAY,EAAE,IAAI;SACnB;KACF,EACD,YAAY,CAAC,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CACxE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"register-coverage-tools.js","sourceRoot":"","sources":["../../src/tools/register-coverage-tools.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,oCAAoC;AAGpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAElF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,gGAAgG;YAChG,oHAAoH;YACpH,iHAAiH;QACnH,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAC1F,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CACP,sFAAsF,CACvF;SACJ;QACD,WAAW,EAAE;YACX,KAAK,EAAE,oBAAoB;YAC3B,YAAY,EAAE,IAAI;SACnB;KACF,EACD,YAAY,CAAC,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAoD,CAAC,CAAC;QACnF,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,OAAO,kBAAkB,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,EAE/C,CAAC,CAAC;IACR,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/register-cross-repo-search-tools.d.ts

@@ -0,0 +1,10 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers four cross-repo search tools on the MCP server (SPEC-296).
+ *   - register_project_path   (free)
+ *   - unregister_project_path (free)
+ *   - list_registered_projects (free)
+ *   - search_all_projects      (pro)
+ */
+export declare function registerCrossRepoSearchTools(server: McpServer): void;
+//# sourceMappingURL=register-cross-repo-search-tools.d.ts.map

package/dist/tools/register-cross-repo-search-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-cross-repo-search-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-cross-repo-search-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgGpE"}

package/dist/tools/register-cross-repo-search-tools.js

@@ -0,0 +1,82 @@
+// tools/register-cross-repo-search-tools.ts — SPEC-296: Register cross-repo search MCP tools.
+import { z } from 'zod';
+import { safe, safeLicensed } from './safe-handler.js';
+import { handleRegisterProjectPath, handleUnregisterProjectPath, handleListRegisteredProjects, handleSearchAllProjects, } from './cross-repo-search-handler.js';
+/**
+ * Registers four cross-repo search tools on the MCP server (SPEC-296).
+ *   - register_project_path   (free)
+ *   - unregister_project_path (free)
+ *   - list_registered_projects (free)
+ *   - search_all_projects      (pro)
+ */
+export function registerCrossRepoSearchTools(server) {
+    // register_project_path — free
+    server.registerTool('register_project_path', {
+        description: 'Register an additional project path so its specs are included in cross-repo ' +
+            'searches (search_all_projects). The path must be an absolute filesystem path ' +
+            'pointing to a Planu-initialized project root.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root to register'),
+        },
+        annotations: { title: 'Register Project Path' },
+    }, safe(async (args) => handleRegisterProjectPath(args)));
+    // unregister_project_path — free
+    server.registerTool('unregister_project_path', {
+        description: 'Remove a previously registered project path from the cross-repo registry. ' +
+            'Its specs will no longer appear in search_all_projects results.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .min(1)
+                .max(4096)
+                .describe('Absolute path to the project root to unregister'),
+        },
+        annotations: { title: 'Unregister Project Path', destructiveHint: true },
+    }, safe(async (args) => handleUnregisterProjectPath(args)));
+    // list_registered_projects — free
+    server.registerTool('list_registered_projects', {
+        description: 'List all project paths registered for cross-repo search, along with spec ' +
+            'counts and last-scan timestamps.',
+        inputSchema: {},
+        annotations: { title: 'List Registered Projects', readOnlyHint: true },
+    }, safe(async (args) => handleListRegisteredProjects(args)));
+    // search_all_projects — pro
+    server.registerTool('search_all_projects', {
+        description: 'Search specs across ALL registered project paths simultaneously. ' +
+            'Returns merged, relevance-scored results from every registered project. ' +
+            'Use register_project_path to add projects first.',
+        inputSchema: {
+            query: z
+                .string()
+                .max(10_000)
+                .optional()
+                .describe('Free-text search query matched against spec title and tags'),
+            status: z
+                .array(z.string())
+                .optional()
+                .describe('Filter by spec status values. Valid values: draft | review | approved | ' +
+                'implementing | done | cancelled'),
+            tags: z
+                .array(z.string())
+                .optional()
+                .describe('Filter by tags — specs must have at least one matching tag'),
+            type: z
+                .array(z.string())
+                .optional()
+                .describe('Filter by spec type. Valid values: feature | bugfix | refactor | chore | ' +
+                'spike | epic | task'),
+            limit: z
+                .number()
+                .min(1)
+                .max(500)
+                .default(50)
+                .describe('Maximum results to return across all projects (default 50)'),
+        },
+        annotations: { title: 'Search All Projects', readOnlyHint: true },
+    }, safeLicensed('search_all_projects', async (args) => handleSearchAllProjects(args)));
+}
+//# sourceMappingURL=register-cross-repo-search-tools.js.map

package/dist/tools/register-cross-repo-search-tools.js.map

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

package/dist/tools/register-desktop-notification-tools.d.ts

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

package/dist/tools/register-desktop-notification-tools.d.ts.map

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

package/dist/tools/register-desktop-notification-tools.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { safe } from './safe-handler.js';
+import { handleConfigureDesktopNotifications, handleDesktopNotificationStatus, handleTestNotification, } from './desktop-notification-handler.js';
+export function registerDesktopNotificationTools(server) {
+    // configure_desktop_notifications
+    server.registerTool('configure_desktop_notifications', {
+        description: 'Configure OS-level desktop notifications for spec status changes in this project. ' +
+            'When enabled, Planu fires a native notification (macOS, Linux, Windows) whenever a ' +
+            'watched spec transitions to a monitored status. ' +
+            'Filter by event type, specific spec IDs, or spec tags.',
+        inputSchema: {
+            projectPath: z.string().min(1).describe('Absolute path to the project root.'),
+            enabled: z.boolean().describe('Enable or disable desktop notifications.'),
+            events: z
+                .array(z
+                .enum(['status_change', 'done', 'blocked', 'approved'])
+                .describe('Event type. Valid values: status_change | done | blocked | approved'))
+                .optional()
+                .describe('Events to notify on. Valid values: status_change | done | blocked | approved. ' +
+                'Defaults to all events when omitted.'),
+            watchTags: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Only notify for specs with these tags. Empty = notify for all specs.'),
+            watchSpecIds: z
+                .array(z.string().min(1))
+                .optional()
+                .describe('Only notify for these specific spec IDs. Empty = notify for all specs.'),
+        },
+        annotations: { title: 'Configure Desktop Notifications', readOnlyHint: false },
+    }, safe((args) => handleConfigureDesktopNotifications(args)));
+    // desktop_notification_status
+    server.registerTool('desktop_notification_status', {
+        description: 'Show the current desktop notification configuration and the last 10 fired notifications ' +
+            'for this project.',
+        inputSchema: {
+            projectPath: z.string().min(1).describe('Absolute path to the project root.'),
+        },
+        annotations: { title: 'Desktop Notification Status', readOnlyHint: true },
+    }, safe((args) => handleDesktopNotificationStatus(args)));
+    // test_notification
+    server.registerTool('test_notification', {
+        description: 'Fire a test desktop notification to verify the OS notification system is working. ' +
+            'Logs the test to the notification history.',
+        inputSchema: {
+            projectPath: z.string().min(1).describe('Absolute path to the project root.'),
+            message: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Custom message for the test notification (optional).'),
+        },
+        annotations: { title: 'Test Notification', readOnlyHint: false },
+    }, safe((args) => handleTestNotification(args)));
+}
+//# sourceMappingURL=register-desktop-notification-tools.js.map

package/dist/tools/register-desktop-notification-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-desktop-notification-tools.js","sourceRoot":"","sources":["../../src/tools/register-desktop-notification-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EACL,mCAAmC,EACnC,+BAA+B,EAC/B,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAO3C,MAAM,UAAU,gCAAgC,CAAC,MAAiB;IAChE,kCAAkC;IAClC,MAAM,CAAC,YAAY,CACjB,iCAAiC,EACjC;QACE,WAAW,EACT,oFAAoF;YACpF,qFAAqF;YACrF,kDAAkD;YAClD,wDAAwD;QAC1D,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC7E,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YACzE,MAAM,EAAE,CAAC;iBACN,KAAK,CACJ,CAAC;iBACE,IAAI,CAAC,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;iBACtD,QAAQ,CAAC,qEAAqE,CAAC,CACnF;iBACA,QAAQ,EAAE;iBACV,QAAQ,CACP,gFAAgF;gBAC9E,sCAAsC,CACzC;YACH,SAAS,EAAE,CAAC;iBACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBACxB,QAAQ,EAAE;iBACV,QAAQ,CAAC,sEAAsE,CAAC;YACnF,YAAY,EAAE,CAAC;iBACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;iBACxB,QAAQ,EAAE;iBACV,QAAQ,CAAC,wEAAwE,CAAC;SACtF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,iCAAiC,EAAE,YAAY,EAAE,KAAK,EAAE;KAC/E,EACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mCAAmC,CAAC,IAA0C,CAAC,CAAC,CAChG,CAAC;IAEF,8BAA8B;IAC9B,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,WAAW,EACT,0FAA0F;YAC1F,mBAAmB;QACrB,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SAC9E;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,6BAA6B,EAAE,YAAY,EAAE,IAAI,EAAE;KAC1E,EACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,+BAA+B,CAAC,IAAsC,CAAC,CAAC,CACxF,CAAC;IAEF,oBAAoB;IACpB,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,oFAAoF;YACpF,4CAA4C;QAC9C,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC7E,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,sDAAsD,CAAC;SACpE;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,KAAK,EAAE;KACjE,EACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAA6B,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC"}

package/dist/tools/register-domain-criteria-tools.d.ts

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

package/dist/tools/register-domain-criteria-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-domain-criteria-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-domain-criteria-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiFnE"}

package/dist/tools/register-domain-criteria-tools.js

@@ -0,0 +1,69 @@
+// tools/register-domain-criteria-tools.ts — Registers suggest_criteria and inject_criteria (SPEC-290)
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleSuggestCriteria, handleInjectCriteria } from './domain-criteria-handler.js';
+import { resolveProjectId, missingProjectIdError } from './resolve-project-id.js';
+export function registerDomainCriteriaTools(server) {
+    // suggest_criteria — read-only, free tier
+    server.registerTool('suggest_criteria', {
+        description: 'Analyze a spec and suggest missing best-practice acceptance criteria based on the detected domain ' +
+            '(payments, authentication, file-upload, gdpr, etc.). ' +
+            'Returns suggested criteria grouped by domain and flags critical gaps that penalize readiness score.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectId: z.string().max(500).optional().describe('Project ID hash. Prefer projectPath.'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Absolute path to project root. Derives projectId automatically.'),
+            specId: z.string().max(500).describe('Spec ID to analyze (e.g. SPEC-042)'),
+            projectHash: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Optional project hash for loading project-level best-practices overrides from ' +
+                'data/projects/{hash}/config/domain-best-practices-overrides.json'),
+        },
+    }, safeLicensed('suggest_criteria', async (args) => {
+        const pid = resolveProjectId(args);
+        if (!pid) {
+            return missingProjectIdError;
+        }
+        return handleSuggestCriteria({ ...args, projectId: pid });
+    }));
+    // inject_criteria — destructive (modifies spec file), pro tier
+    server.registerTool('inject_criteria', {
+        description: 'Inject missing domain best-practice criteria directly into a spec\'s "## Acceptance Criteria" section. ' +
+            'Criteria are automatically detected from the spec domain. ' +
+            'Use criteriaIds to inject only specific criteria; omit to inject all missing critical criteria.',
+        annotations: { destructiveHint: true },
+        inputSchema: {
+            projectId: z.string().max(500).optional().describe('Project ID hash. Prefer projectPath.'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Absolute path to project root. Derives projectId automatically.'),
+            specId: z.string().max(500).describe('Spec ID to inject criteria into (e.g. SPEC-042)'),
+            criteriaIds: z
+                .array(z.string().max(200))
+                .optional()
+                .describe('Optional list of specific criteria IDs to inject ' +
+                '(e.g. ["payments-idempotency-key", "payments-transaction-log"]). ' +
+                'If omitted, all missing criteria for detected domains are injected.'),
+            projectHash: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Optional project hash for loading project-level best-practices overrides'),
+        },
+    }, safeLicensed('inject_criteria', async (args) => {
+        const pid = resolveProjectId(args);
+        if (!pid) {
+            return missingProjectIdError;
+        }
+        return handleInjectCriteria({ ...args, projectId: pid });
+    }));
+}
+//# sourceMappingURL=register-domain-criteria-tools.js.map

package/dist/tools/register-domain-criteria-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-domain-criteria-tools.js","sourceRoot":"","sources":["../../src/tools/register-domain-criteria-tools.ts"],"names":[],"mappings":"AAAA,sGAAsG;AAGtG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAElF,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,0CAA0C;IAC1C,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,oGAAoG;YACpG,uDAAuD;YACvD,qGAAqG;QACvG,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAC1F,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC1E,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,gFAAgF;gBAC9E,kEAAkE,CACrE;SACJ;KACF,EACD,YAAY,CAAC,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9C,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAoD,CAAC,CAAC;QACnF,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,OAAO,qBAAqB,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,EAElD,CAAC,CAAC;IACR,CAAC,CAAC,CACH,CAAC;IAEF,+DAA+D;IAC/D,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,yGAAyG;YACzG,4DAA4D;YAC5D,iGAAiG;QACnG,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;QACtC,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAC1F,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,iDAAiD,CAAC;YACvF,WAAW,EAAE,CAAC;iBACX,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;iBAC1B,QAAQ,EAAE;iBACV,QAAQ,CACP,mDAAmD;gBACjD,mEAAmE;gBACnE,qEAAqE,CACxE;YACH,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,0EAA0E,CAAC;SACxF;KACF,EACD,YAAY,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC7C,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAoD,CAAC,CAAC;QACnF,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,OAAO,oBAAoB,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,EAEjD,CAAC,CAAC;IACR,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"register-elicitation-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-elicitation-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuChE"}
+{"version":3,"file":"register-elicitation-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-elicitation-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgDhE"}

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

@@ -1,13 +1,19 @@
 import { z } from 'zod';
 import { safeLicensed } from './safe-handler.js';
 import { handleElicitRequirements } from './elicit-requirements-handler.js';
+import { resolveProjectId, missingProjectIdError } from './resolve-project-id.js';
 export function registerElicitationTools(server) {
     server.registerTool('elicit_requirements', {
         description: 'Interactively clarify requirements before creating a spec. ' +
             'First call returns structured questions for the user to answer. ' +
             'Second call (with answers + sessionId) returns a structured summary ready to pass to create_spec.',
         inputSchema: {
-            projectId: z.string().min(1).describe('Project ID where the spec will be created.'),
+            projectId: z.string().max(500).optional().describe('Project ID hash. Prefer projectPath.'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Absolute path to project root. Derives projectId automatically.'),
             title: z.string().min(3).max(200).describe('Feature title to clarify requirements for.'),
             description: z
                 .string()
@@ -28,6 +34,12 @@ export function registerElicitationTools(server) {
                 'Pass this on the follow-up call to continue the same elicitation session.'),
         },
         annotations: { title: 'Elicit Requirements', readOnlyHint: false },
-    }, safeLicensed('elicit_requirements', async (args) => handleElicitRequirements(args)));
+    }, safeLicensed('elicit_requirements', async (args) => {
+        const pid = resolveProjectId(args);
+        if (!pid) {
+            return missingProjectIdError;
+        }
+        return handleElicitRequirements({ ...args, projectId: pid });
+    }));
 }
 //# sourceMappingURL=register-elicitation-tools.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"register-elicitation-tools.js","sourceRoot":"","sources":["../../src/tools/register-elicitation-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,6DAA6D;YAC7D,kEAAkE;YAClE,mGAAmG;QACrG,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACnF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACxF,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,EAAE,CAAC;iBACP,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,+CAA+C,CAAC;YAC5D,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,+DAA+D;gBAC7D,iEAAiE,CACpE;YACH,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,8CAA8C;gBAC5C,2EAA2E,CAC9E;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,KAAK,EAAE;KACnE,EACD,YAAY,CAAC,qBAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACjD,wBAAwB,CAAC,IAA+B,CAAC,CAC1D,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"register-elicitation-tools.js","sourceRoot":"","sources":["../../src/tools/register-elicitation-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAElF,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,WAAW,EACT,6DAA6D;YAC7D,kEAAkE;YAClE,mGAAmG;QACrG,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAC1F,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACxF,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,EAAE,CAAC;iBACP,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,+CAA+C,CAAC;YAC5D,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,+DAA+D;gBAC7D,iEAAiE,CACpE;YACH,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,8CAA8C;gBAC5C,2EAA2E,CAC9E;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,KAAK,EAAE;KACnE,EACD,YAAY,CAAC,qBAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACjD,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAoD,CAAC,CAAC;QACnF,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QACD,OAAO,wBAAwB,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,EAA6B,CAAC,CAAC;IAC1F,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/tools/register-email-digest-tools.d.ts

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

package/dist/tools/register-email-digest-tools.d.ts.map

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

package/dist/tools/register-email-digest-tools.js

@@ -0,0 +1,109 @@
+// tools/register-email-digest-tools.ts — Registers Email Digest tools on the MCP server (SPEC-293)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureEmailDigest, handleGenerateDigest, handleSendDigest, handleEmailDigestStatus, } from './email-digest-handler.js';
+export function registerEmailDigestTools(server) {
+    // -------------------------------------------------------------------------
+    // configure_email_digest (pro)
+    // -------------------------------------------------------------------------
+    server.registerTool('configure_email_digest', {
+        description: 'Configure email digest delivery for a project. ' +
+            'Supports three providers: sendgrid (transactional email via API key), ' +
+            'smtp (not yet implemented — use file or sendgrid), ' +
+            'and file (saves HTML to data/projects/{hash}/digests/). ' +
+            'Set frequency to daily or weekly to indicate intended schedule.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            provider: z
+                .enum(['sendgrid', 'smtp', 'file'])
+                .describe("Delivery provider. Valid values: 'sendgrid' (requires apiKey), " +
+                "'smtp' (not implemented — use file or sendgrid), " +
+                "'file' (saves HTML to disk, no email sent)."),
+            frequency: z
+                .enum(['daily', 'weekly'])
+                .describe("How often digests should be sent. Valid values: 'daily' | 'weekly'. " +
+                'This is stored as metadata — actual scheduling is handled externally.'),
+            recipients: z
+                .array(z.string())
+                .describe('List of recipient email addresses. Required for sendgrid/smtp providers.'),
+            credentials: z
+                .object({
+                apiKey: z.string().optional().describe('SendGrid API key (provider=sendgrid).'),
+                smtpHost: z.string().optional().describe('SMTP host (provider=smtp).'),
+                smtpPort: z.number().int().optional().describe('SMTP port (provider=smtp).'),
+                smtpUser: z.string().optional().describe('SMTP username (provider=smtp).'),
+                smtpPass: z.string().optional().describe('SMTP password (provider=smtp).'),
+                fromEmail: z
+                    .string()
+                    .optional()
+                    .describe('Sender email address. Defaults to digest@planu.dev.'),
+                fromName: z
+                    .string()
+                    .optional()
+                    .describe('Sender display name. Defaults to "Planu Digest".'),
+            })
+                .optional()
+                .describe('Provider credentials. Only the fields relevant to the chosen provider are used.'),
+        },
+        annotations: { title: 'Configure Email Digest', destructiveHint: false },
+    }, safeTracked('configure_email_digest', async (args) => handleConfigureEmailDigest(args)));
+    // -------------------------------------------------------------------------
+    // generate_digest (free)
+    // -------------------------------------------------------------------------
+    server.registerTool('generate_digest', {
+        description: 'Generate a digest of spec activity for a given period without sending it. ' +
+            'Returns the full digest content (stats, spec lists, HTML, plain text) so you can ' +
+            'preview the output before sending, or use the content in custom workflows.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            days: z
+                .number()
+                .int()
+                .min(1)
+                .max(365)
+                .optional()
+                .describe('Number of days to look back when classifying specs as "completed in period". ' +
+                'Defaults to 7 (one week).'),
+        },
+        annotations: { title: 'Generate Digest', readOnlyHint: true },
+    }, safeTracked('generate_digest', async (args) => handleGenerateDigest(args)));
+    // -------------------------------------------------------------------------
+    // send_digest (pro)
+    // -------------------------------------------------------------------------
+    server.registerTool('send_digest', {
+        description: 'Generate a digest and dispatch it using the configured provider. ' +
+            'Requires configure_email_digest to have been called first. ' +
+            'Records the delivery attempt in the delivery log.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            days: z
+                .number()
+                .int()
+                .min(1)
+                .max(365)
+                .optional()
+                .describe('Number of days to look back when classifying specs as "completed in period". ' +
+                'Defaults to 7 (one week).'),
+        },
+        annotations: { title: 'Send Digest', destructiveHint: false },
+    }, safeTracked('send_digest', async (args) => handleSendDigest(args)));
+    // -------------------------------------------------------------------------
+    // email_digest_status (free)
+    // -------------------------------------------------------------------------
+    server.registerTool('email_digest_status', {
+        description: 'Show the current email digest configuration and the last 10 delivery records for a project.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+        },
+        annotations: { title: 'Email Digest Status', readOnlyHint: true },
+    }, safeTracked('email_digest_status', async (args) => handleEmailDigestStatus(args)));
+}
+//# sourceMappingURL=register-email-digest-tools.js.map

package/dist/tools/register-email-digest-tools.js.map

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

package/dist/tools/register-estimation-accuracy-tools.d.ts

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

package/dist/tools/register-estimation-accuracy-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-estimation-accuracy-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-estimation-accuracy-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+FvE"}