@planu/cli 0.91.0 → 0.92.0

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-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;AAKzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuDnE"}

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

@@ -0,0 +1,46 @@
+// 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';
+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).describe('Project ID that owns the spec'),
+            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) => handleSuggestCriteria(args)));
+    // 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).describe('Project ID that owns the spec'),
+            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) => handleInjectCriteria(args)));
+}
+//# 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;AAE3F,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,CAAC,+BAA+B,CAAC;YACxE,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,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAC9E,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,CAAC,+BAA+B,CAAC;YACxE,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,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAC5E,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"}

package/dist/tools/register-estimation-accuracy-tools.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleRecordActual, handleEstimationAccuracyReport, handleCalibrateEstimates, } from './estimation-accuracy-handler.js';
+export function registerEstimationAccuracyTools(server) {
+    server.registerTool('record_actual', {
+        description: 'Record the actual hours spent on a completed spec to track estimation accuracy. ' +
+            'Use after marking a spec as done to close the feedback loop. ' +
+            'Data is stored per-project and used by estimation_accuracy_report and calibrate_estimates.',
+        inputSchema: {
+            projectId: z.string().min(1).optional().describe('Project ID (hash of project path).'),
+            projectPath: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('Absolute path to the project root (alternative to projectId).'),
+            specId: z.string().min(1).describe('Spec ID to record actuals for (e.g. "SPEC-287").'),
+            actualHours: z
+                .number()
+                .min(0)
+                .describe('Total hours actually spent implementing this spec (dev + review combined).'),
+            notes: z
+                .string()
+                .max(1000)
+                .optional()
+                .describe('Optional notes explaining the deviation (e.g. "scope crept", "faster than expected").'),
+        },
+        annotations: { readOnlyHint: false },
+    }, safeLicensed('record_actual', async (args) => handleRecordActual(args)));
+    server.registerTool('estimation_accuracy_report', {
+        description: 'Generate a historical estimation accuracy report for the project. ' +
+            'Shows per-spec deviation (estimated vs actual), aggregate stats, outliers, and trend over time. ' +
+            'Breakdown by scope (trivial/feature/cross-module/architectural) and spec type.',
+        inputSchema: {
+            projectId: z.string().min(1).optional().describe('Project ID.'),
+            projectPath: z.string().min(1).optional().describe('Absolute path to the project root.'),
+            scope: z
+                .enum(['trivial', 'feature', 'cross-module', 'architectural'])
+                .optional()
+                .describe('Filter report to a specific scope. Valid values: trivial | feature | cross-module | architectural'),
+            type: z
+                .enum(['feature', 'refactor', 'bugfix', 'infra', 'docs', 'project', 'agent', 'tech-debt'])
+                .optional()
+                .describe('Filter report to a specific spec type. Valid values: feature | refactor | bugfix | infra | docs | project | agent | tech-debt'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe('Maximum number of spec records to include (default: all records).'),
+        },
+        annotations: { readOnlyHint: true },
+    }, safeLicensed('estimation_accuracy_report', async (args) => handleEstimationAccuracyReport(args)));
+    server.registerTool('calibrate_estimates', {
+        description: 'Recalculate estimation calibration factors based on accumulated historical actuals. ' +
+            'When historical data shows systematic over/underestimation (>20% avg deviation), ' +
+            'saves multipliers that the estimate tool uses to adjust future estimates automatically. ' +
+            'Overwrites previous calibration. Requires at least minSamples records per dimension.',
+        inputSchema: {
+            projectId: z.string().min(1).optional().describe('Project ID.'),
+            projectPath: z.string().min(1).optional().describe('Absolute path to the project root.'),
+            minSamples: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe('Minimum number of actuals per scope/type before a calibration factor is applied (default: 3).'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    }, safeLicensed('calibrate_estimates', async (args) => handleCalibrateEstimates(args)));
+}
+//# sourceMappingURL=register-estimation-accuracy-tools.js.map

package/dist/tools/register-estimation-accuracy-tools.js.map

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

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

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

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

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

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

@@ -0,0 +1,63 @@
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleImportSpec, handleBulkImport } from './import-spec-handler.js';
+const ImportSourceEnum = z
+    .enum(['markdown', 'jira', 'linear', 'csv'])
+    .describe('Source format: markdown | jira | linear | csv');
+export function registerImportTools(server) {
+    // import_spec
+    server.registerTool('import_spec', {
+        description: 'Import a spec from an external source (Jira, Linear, Markdown, or CSV) into Planu. ' +
+            'Creates a new spec with the imported content. ' +
+            'Use bulk_import to import multiple specs at once.',
+        inputSchema: {
+            source: ImportSourceEnum,
+            filePath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Absolute path to the source file. Required if content is not provided.'),
+            content: z
+                .string()
+                .max(100_000)
+                .optional()
+                .describe('Inline content string. For jira/linear: JSON string of the issue. For markdown: markdown text. For csv: CSV text.'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .describe('Absolute path to the target project root'),
+            overwrite: z
+                .boolean()
+                .optional()
+                .describe('Overwrite an existing spec with the same title (default: false). When false, a warning is returned instead of creating a duplicate.'),
+        },
+    }, safeTracked('import_spec', async (args) => handleImportSpec(args)));
+    // bulk_import
+    server.registerTool('bulk_import', {
+        description: 'Bulk import multiple specs from a CSV file or a JSON array of Jira/Linear issues. ' +
+            'Each row in CSV or each item in the JSON array becomes one spec. ' +
+            'Returns a summary with total, succeeded, failed counts and per-spec results.',
+        inputSchema: {
+            source: ImportSourceEnum,
+            filePath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Absolute path to the source file (CSV or JSON array file).'),
+            content: z
+                .string()
+                .max(500_000)
+                .optional()
+                .describe('Inline content string. For csv: CSV with header row. For jira/linear: JSON array of issues.'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .describe('Absolute path to the target project root'),
+            overwrite: z
+                .boolean()
+                .optional()
+                .describe('Overwrite existing specs with same title (default: false).'),
+        },
+    }, safeTracked('bulk_import', async (args) => handleBulkImport(args)));
+}
+//# sourceMappingURL=register-import-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-import-tools.js","sourceRoot":"","sources":["../../src/tools/register-import-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,MAAM,gBAAgB,GAAG,CAAC;KACvB,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;KAC3C,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE7D,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,cAAc;IACd,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,qFAAqF;YACrF,gDAAgD;YAChD,mDAAmD;QACrD,WAAW,EAAE;YACX,MAAM,EAAE,gBAAgB;YACxB,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,wEAAwE,CAAC;YACrF,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,OAAO,CAAC;iBACZ,QAAQ,EAAE;iBACV,QAAQ,CACP,mHAAmH,CACpH;YACH,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,0CAA0C,CAAC;YACvD,SAAS,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,qIAAqI,CACtI;SACJ;KACF,EACD,WAAW,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CACnE,CAAC;IAEF,cAAc;IACd,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,oFAAoF;YACpF,mEAAmE;YACnE,8EAA8E;QAChF,WAAW,EAAE;YACX,MAAM,EAAE,gBAAgB;YACxB,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,4DAA4D,CAAC;YACzE,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,OAAO,CAAC;iBACZ,QAAQ,EAAE;iBACV,QAAQ,CACP,6FAA6F,CAC9F;YACH,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,0CAA0C,CAAC;YACvD,SAAS,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,4DAA4D,CAAC;SAC1E;KACF,EACD,WAAW,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CACnE,CAAC;AACJ,CAAC"}

package/dist/tools/register-outbound-webhook-tools.d.ts

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

package/dist/tools/register-outbound-webhook-tools.d.ts.map

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