@planu/cli 0.91.0 → 0.92.0

package/dist/tools/register-outbound-webhook-tools.js

@@ -0,0 +1,79 @@
+// tools/register-outbound-webhook-tools.ts — Registers outbound webhook tools (SPEC-281)
+import { z } from 'zod';
+import { safe } from './safe-handler.js';
+import { handleConfigureWebhook, handleOutboundWebhookStatus, handleRemoveWebhook, } from './outbound-webhook-handler.js';
+const SUPPORTED_EVENTS = [
+    'spec.created',
+    'spec.approved',
+    'spec.status_changed',
+    'spec.done',
+    'spec.drift_detected',
+    'feedback.submitted',
+    'validate.failed',
+];
+export function registerOutboundWebhookTools(server) {
+    // configure_webhook
+    server.registerTool('configure_webhook', {
+        description: 'Register an outbound webhook endpoint to receive Planu spec lifecycle events. ' +
+            'Payloads are signed with HMAC-SHA256 (X-Planu-Signature header) using the provided secret. ' +
+            'Retry logic: 3 attempts with exponential backoff (1s, 5s, 30s). ' +
+            'Events: spec.created | spec.approved | spec.status_changed | spec.done | ' +
+            'spec.drift_detected | feedback.submitted | validate.failed',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project directory'),
+            url: z.string().describe('HTTPS endpoint URL that will receive webhook POST requests'),
+            secret: z
+                .string()
+                .describe('Shared secret (min 8 chars) used to sign payloads with HMAC-SHA256. ' +
+                'Verify X-Planu-Signature on your endpoint.'),
+            events: z
+                .array(z.enum(SUPPORTED_EVENTS))
+                .optional()
+                .describe('Events to subscribe to. Valid values: ' +
+                SUPPORTED_EVENTS.join(', ') +
+                '. Leave empty to receive all events.'),
+            label: z
+                .string()
+                .optional()
+                .describe('Optional human-readable label to identify this webhook'),
+        },
+        annotations: {
+            title: 'Configure Outbound Webhook',
+            destructiveHint: true,
+            readOnlyHint: false,
+        },
+    }, safe((args) => handleConfigureWebhook(args)));
+    // outbound_webhook_status
+    server.registerTool('outbound_webhook_status', {
+        description: 'List all configured outbound webhooks and their delivery status. ' +
+            'Shows health (healthy/failing), last delivery result, and success rate. ' +
+            'Use webhookId to inspect a specific webhook in detail.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project directory'),
+            webhookId: z
+                .string()
+                .optional()
+                .describe('ID of a specific webhook to inspect (from configure_webhook output)'),
+        },
+        annotations: {
+            title: 'Outbound Webhook Status',
+            readOnlyHint: true,
+        },
+    }, safe((args) => handleOutboundWebhookStatus(args)));
+    // remove_webhook
+    server.registerTool('remove_webhook', {
+        description: 'Deactivate an outbound webhook so it no longer receives events.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project directory'),
+            webhookId: z
+                .string()
+                .describe('ID of the webhook to deactivate (from configure_webhook or outbound_webhook_status)'),
+        },
+        annotations: {
+            title: 'Remove Outbound Webhook',
+            destructiveHint: true,
+            readOnlyHint: false,
+        },
+    }, safe((args) => handleRemoveWebhook(args)));
+}
+//# sourceMappingURL=register-outbound-webhook-tools.js.map

package/dist/tools/register-outbound-webhook-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-outbound-webhook-tools.js","sourceRoot":"","sources":["../../src/tools/register-outbound-webhook-tools.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAGzF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,gBAAgB,GAAG;IACvB,cAAc;IACd,eAAe;IACf,qBAAqB;IACrB,WAAW;IACX,qBAAqB;IACrB,oBAAoB;IACpB,iBAAiB;CACT,CAAC;AAEX,MAAM,UAAU,4BAA4B,CAAC,MAAiB;IAC5D,oBAAoB;IACpB,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,gFAAgF;YAChF,6FAA6F;YAC7F,kEAAkE;YAClE,2EAA2E;YAC3E,4DAA4D;QAC9D,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YAC1E,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;YACtF,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CACP,sEAAsE;gBACpE,4CAA4C,CAC/C;YACH,MAAM,EAAE,CAAC;iBACN,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;iBAC/B,QAAQ,EAAE;iBACV,QAAQ,CACP,wCAAwC;gBACtC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3B,sCAAsC,CACzC;YACH,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;SACtE;QACD,WAAW,EAAE;YACX,KAAK,EAAE,4BAA4B;YACnC,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,KAAK;SACpB;KACF,EACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAC7C,CAAC;IAEF,0BAA0B;IAC1B,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,WAAW,EACT,mEAAmE;YACnE,0EAA0E;YAC1E,wDAAwD;QAC1D,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YAC1E,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,qEAAqE,CAAC;SACnF;QACD,WAAW,EAAE;YACX,KAAK,EAAE,yBAAyB;YAChC,YAAY,EAAE,IAAI;SACnB;KACF,EACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAClD,CAAC;IAEF,iBAAiB;IACjB,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YAC1E,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CACP,qFAAqF,CACtF;SACJ;QACD,WAAW,EAAE;YACX,KAAK,EAAE,yBAAyB;YAChC,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,KAAK;SACpB;KACF,EACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAC1C,CAAC;AACJ,CAAC"}

package/dist/tools/register-performance-analysis-tools.d.ts

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

package/dist/tools/register-performance-analysis-tools.d.ts.map

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

package/dist/tools/register-performance-analysis-tools.js

@@ -0,0 +1,24 @@
+// tools/register-performance-analysis-tools.ts — Registers analyze_performance_impact (SPEC-300)
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleAnalyzePerformanceImpact } from './performance-analysis-handler.js';
+export function registerPerformanceAnalysisTools(server) {
+    server.registerTool('analyze_performance_impact', {
+        description: 'Analyze a spec for performance risks before implementation. ' +
+            'Detects common anti-patterns such as N+1 queries, missing pagination, missing caching, ' +
+            'blocking operations, large data loads, and missing database indexes. ' +
+            'Returns a risk report with severity levels (high/medium/low) and recommendations.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            specId: z
+                .string()
+                .max(500)
+                .describe('Spec ID to analyze for performance risks (e.g. SPEC-042)'),
+            projectPath: z
+                .string()
+                .max(2000)
+                .describe('Absolute path to the project root (e.g. /home/user/my-app)'),
+        },
+    }, safeLicensed('analyze_performance_impact', async (args) => handleAnalyzePerformanceImpact(args)));
+}
+//# sourceMappingURL=register-performance-analysis-tools.js.map

package/dist/tools/register-performance-analysis-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-performance-analysis-tools.js","sourceRoot":"","sources":["../../src/tools/register-performance-analysis-tools.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAGjG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAEnF,MAAM,UAAU,gCAAgC,CAAC,MAAiB;IAChE,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,WAAW,EACT,8DAA8D;YAC9D,yFAAyF;YACzF,uEAAuE;YACvE,mFAAmF;QACrF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,0DAA0D,CAAC;YACvE,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,CAAC,IAAI,CAAC;iBACT,QAAQ,CAAC,4DAA4D,CAAC;SAC1E;KACF,EACD,YAAY,CAAC,4BAA4B,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACxD,8BAA8B,CAAC,IAAI,CAAC,CACrC,CACF,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,55 @@
+// tools/register-slack-tools.ts — Registers Slack integration tools on the MCP server (SPEC-292)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleConfigureSlack, handleSlackNotify, handleSlackStatus, handleRemoveSlack, } from './slack-handler.js';
+export function registerSlackTools(server) {
+    server.registerTool('configure_slack', {
+        description: 'Configure a Slack incoming webhook for this project. Once configured, spec status changes will automatically send rich Block Kit notifications to your Slack channel.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            webhookUrl: z
+                .url()
+                .describe('Slack incoming webhook URL (e.g. https://hooks.slack.com/services/T.../B.../...).'),
+            channel: z
+                .string()
+                .optional()
+                .describe('Optional channel override (e.g. #deployments). If omitted, uses the webhook default.'),
+        },
+        annotations: { title: 'Configure Slack', destructiveHint: false },
+    }, safeTracked('configure_slack', async (args) => handleConfigureSlack(args)));
+    server.registerTool('slack_notify', {
+        description: 'Send a manual Slack notification to the configured webhook. Optionally link the message to a specific spec.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+            message: z.string().min(1).describe('Notification message text to send to Slack.'),
+            specId: z
+                .string()
+                .optional()
+                .describe('Optional SPEC-XXX identifier to link this notification to a spec.'),
+        },
+        annotations: { title: 'Slack Notify', destructiveHint: false },
+    }, safeTracked('slack_notify', async (args) => handleSlackNotify(args)));
+    server.registerTool('slack_status', {
+        description: 'Show the current Slack configuration and the last 20 notification delivery records for this project.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+        },
+        annotations: { title: 'Slack Status', readOnlyHint: true },
+    }, safeTracked('slack_status', async (args) => handleSlackStatus(args)));
+    server.registerTool('remove_slack', {
+        description: 'Remove the Slack webhook configuration for this project. Notifications will stop immediately.',
+        inputSchema: {
+            projectPath: z
+                .string()
+                .describe('Absolute path to the project root (e.g. /home/user/my-project).'),
+        },
+        annotations: { title: 'Remove Slack', destructiveHint: true },
+    }, safeTracked('remove_slack', async (args) => handleRemoveSlack(args)));
+}
+//# sourceMappingURL=register-slack-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-slack-tools.js","sourceRoot":"","sources":["../../src/tools/register-slack-tools.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAGjG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,WAAW,EACT,uKAAuK;QACzK,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,UAAU,EAAE,CAAC;iBACV,GAAG,EAAE;iBACL,QAAQ,CACP,mFAAmF,CACpF;YACH,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,sFAAsF,CACvF;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,KAAK,EAAE;KAClE,EACD,WAAW,CAAC,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAC5C,oBAAoB,CAAC,IAA2B,CAAC,CAClD,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,6GAA6G;QAC/G,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;YAClF,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,mEAAmE,CAAC;SACjF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,KAAK,EAAE;KAC/D,EACD,WAAW,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAwB,CAAC,CAAC,CACzF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,sGAAsG;QACxG,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;SAC/E;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE;KAC3D,EACD,WAAW,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAwB,CAAC,CAAC,CACzF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,WAAW,EACT,+FAA+F;QACjG,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,iEAAiE,CAAC;SAC/E;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,IAAI,EAAE;KAC9D,EACD,WAAW,CAAC,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAwB,CAAC,CAAC,CACzF,CAAC;AACJ,CAAC"}

package/dist/tools/register-spec-export-tools.d.ts

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

package/dist/tools/register-spec-export-tools.d.ts.map

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

package/dist/tools/register-spec-export-tools.js

@@ -0,0 +1,67 @@
+// tools/register-spec-export-tools.ts — Registers export_specs_csv and export_specs_markdown — SPEC-298
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleExportSpecsCsv, handleExportSpecsMarkdown } from './spec-export-handler.js';
+const COLUMN_VALUES = [
+    'id',
+    'title',
+    'status',
+    'type',
+    'scope',
+    'difficulty',
+    'risk',
+    'target',
+    'tags',
+    'createdAt',
+    'updatedAt',
+    'devHours',
+    'totalCostUsd',
+    'estimatedModel',
+];
+const COLUMN_DESCRIBE = 'Columns to include. Valid values: id, title, status, type, scope, difficulty, risk, target, tags, createdAt, updatedAt, devHours, totalCostUsd, estimatedModel. Defaults to all columns.';
+const columnsSchema = z.array(z.enum(COLUMN_VALUES)).optional().describe(COLUMN_DESCRIBE);
+const statusSchema = z
+    .array(z.string())
+    .optional()
+    .describe('Filter by status. Valid values: draft, review, approved, implementing, done, cancelled.');
+const typeSchema = z
+    .array(z.string())
+    .optional()
+    .describe('Filter by spec type. Valid values: feature, refactor, bugfix, infra, docs, project, agent, tech-debt.');
+const tagsSchema = z
+    .array(z.string())
+    .optional()
+    .describe('Filter specs that have at least one of these tags.');
+const outputPathSchema = z
+    .string()
+    .optional()
+    .describe('Absolute path to write the output file. If omitted, the content is returned but not written.');
+export function registerSpecExportTools(server) {
+    // export_specs_csv — pro tier
+    server.registerTool('export_specs_csv', {
+        description: 'Export specs to CSV format for spreadsheet analysis. Supports filtering by status, type, or tags and custom column selection. Pro tier.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            columns: columnsSchema,
+            status: statusSchema,
+            type: typeSchema,
+            tags: tagsSchema,
+            outputPath: outputPathSchema,
+        },
+    }, safeTracked('export_specs_csv', async (args) => handleExportSpecsCsv(args)));
+    // export_specs_markdown — free tier
+    server.registerTool('export_specs_markdown', {
+        description: 'Export specs to a Markdown table for docs, reports, or PR descriptions. Supports filtering by status, type, or tags and custom column selection.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            columns: columnsSchema,
+            status: statusSchema,
+            type: typeSchema,
+            tags: tagsSchema,
+            outputPath: outputPathSchema,
+        },
+    }, safeTracked('export_specs_markdown', async (args) => handleExportSpecsMarkdown(args)));
+}
+//# sourceMappingURL=register-spec-export-tools.js.map

package/dist/tools/register-spec-export-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-export-tools.js","sourceRoot":"","sources":["../../src/tools/register-spec-export-tools.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAGxG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE3F,MAAM,aAAa,GAAG;IACpB,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,YAAY;IACZ,MAAM;IACN,QAAQ;IACR,MAAM;IACN,WAAW;IACX,WAAW;IACX,UAAU;IACV,cAAc;IACd,gBAAgB;CACR,CAAC;AAEX,MAAM,eAAe,GACnB,0LAA0L,CAAC;AAE7L,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAE1F,MAAM,YAAY,GAAG,CAAC;KACnB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACjB,QAAQ,EAAE;KACV,QAAQ,CACP,yFAAyF,CAC1F,CAAC;AAEJ,MAAM,UAAU,GAAG,CAAC;KACjB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACjB,QAAQ,EAAE;KACV,QAAQ,CACP,uGAAuG,CACxG,CAAC;AAEJ,MAAM,UAAU,GAAG,CAAC;KACjB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACjB,QAAQ,EAAE;KACV,QAAQ,CAAC,oDAAoD,CAAC,CAAC;AAElE,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CACP,8FAA8F,CAC/F,CAAC;AAEJ,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,8BAA8B;IAC9B,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,yIAAyI;QAC3I,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACvF,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,gBAAgB;SAC7B;KACF,EACD,WAAW,CAAC,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAC5E,CAAC;IAEF,oCAAoC;IACpC,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EACT,kJAAkJ;QACpJ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACvF,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,gBAAgB;SAC7B;KACF,EACD,WAAW,CAAC,uBAAuB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CACtF,CAAC;AACJ,CAAC"}

package/dist/tools/register-spec-lock-tools.d.ts

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

package/dist/tools/register-spec-lock-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-lock-tools.d.ts","sourceRoot":"","sources":["../../src/tools/register-spec-lock-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+F7D"}

package/dist/tools/register-spec-lock-tools.js

@@ -0,0 +1,72 @@
+// tools/register-spec-lock-tools.ts — Registers spec locking tools (SPEC-301)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleLockSpec, handleUnlockSpec, handleListLocks, handleCheckSpecLock, } from './spec-lock-handler.js';
+export function registerSpecLockTools(server) {
+    // -------------------------------------------------------------------------
+    // lock_spec — acquire an exclusive lock on a spec
+    // -------------------------------------------------------------------------
+    server.registerTool('lock_spec', {
+        description: 'Acquire an exclusive lock on a spec to prevent concurrent edits by other agents or sessions. ' +
+            'If the spec is already locked by a different holder, returns an error. ' +
+            'Re-locking by the same holder refreshes the TTL.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            specId: z.string().describe('Spec ID to lock (e.g. SPEC-042).'),
+            lockHolder: z
+                .string()
+                .describe('Identifier of the agent or session acquiring the lock (e.g. "agent-123").'),
+            ttlMinutes: z
+                .number()
+                .int()
+                .optional()
+                .describe('Lock TTL in minutes. Clamped to [1, 480]. Default: 30.'),
+            reason: z
+                .string()
+                .optional()
+                .describe('Optional human-readable reason for acquiring the lock.'),
+        },
+        annotations: { title: 'Lock Spec', destructiveHint: false },
+    }, safeTracked('lock_spec', (args) => handleLockSpec(args)));
+    // -------------------------------------------------------------------------
+    // unlock_spec — release a lock on a spec
+    // -------------------------------------------------------------------------
+    server.registerTool('unlock_spec', {
+        description: 'Release an existing lock on a spec. ' +
+            'Fails if the lock is held by a different holder unless force=true is passed.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            specId: z.string().describe('Spec ID to unlock (e.g. SPEC-042).'),
+            lockHolder: z.string().describe('Identifier of the agent or session releasing the lock.'),
+            force: z
+                .boolean()
+                .optional()
+                .describe('If true, removes the lock even when held by a different lockHolder. Default: false.'),
+        },
+        annotations: { title: 'Unlock Spec', destructiveHint: true },
+    }, safeTracked('unlock_spec', (args) => handleUnlockSpec(args)));
+    // -------------------------------------------------------------------------
+    // list_locks — list all active locks in a project
+    // -------------------------------------------------------------------------
+    server.registerTool('list_locks', {
+        description: 'List all active (non-expired) locks for a project. ' +
+            'Returns the spec ID, lock holder, expiration time, and optional reason for each lock.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+        },
+        annotations: { title: 'List Active Locks', readOnlyHint: true },
+    }, safeTracked('list_locks', (args) => handleListLocks(args)));
+    // -------------------------------------------------------------------------
+    // check_spec_lock — check whether a specific spec is locked
+    // -------------------------------------------------------------------------
+    server.registerTool('check_spec_lock', {
+        description: 'Check whether a specific spec is currently locked. ' +
+            'Returns locked status, lock holder, expiration time, and reason if locked.',
+        inputSchema: {
+            projectPath: z.string().describe('Absolute path to the project root.'),
+            specId: z.string().describe('Spec ID to check (e.g. SPEC-042).'),
+        },
+        annotations: { title: 'Check Spec Lock', readOnlyHint: true },
+    }, safeTracked('check_spec_lock', (args) => handleCheckSpecLock(args)));
+}
+//# sourceMappingURL=register-spec-lock-tools.js.map

package/dist/tools/register-spec-lock-tools.js.map

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

package/dist/tools/register-spec-search-tools.d.ts

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

package/dist/tools/register-spec-search-tools.d.ts.map

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

package/dist/tools/register-spec-search-tools.js

@@ -0,0 +1,122 @@
+// tools/register-spec-search-tools.ts — Registers search_specs and search_suggestions (SPEC-295)
+import { z } from 'zod';
+import { safeTracked } from './safe-handler.js';
+import { handleSearchSpecs, handleSearchSuggestions } from './search-handler.js';
+const STATUS_VALUES = ['draft', 'review', 'approved', 'implementing', 'done', 'discarded'];
+const TYPE_VALUES = [
+    'feature',
+    'refactor',
+    'bugfix',
+    'infra',
+    'docs',
+    'project',
+    'agent',
+    'tech-debt',
+];
+const TARGET_VALUES = [
+    'frontend',
+    'backend',
+    'shared',
+    'fullstack',
+    'infrastructure',
+    'database',
+    'ios',
+    'android',
+];
+const RISK_VALUES = ['low', 'medium', 'high', 'critical'];
+const SORT_BY_VALUES = ['relevance', 'createdAt', 'updatedAt', 'difficulty'];
+const SORT_ORDER_VALUES = ['asc', 'desc'];
+const SUGGESTION_FIELD_VALUES = ['tags', 'type', 'status', 'id'];
+export function registerSpecSearchTools(server) {
+    // search_specs — SPEC-295
+    server.registerTool('search_specs', {
+        description: 'Search specs with fuzzy text matching, multi-field filters, sorting, and pagination. Supports filtering by status, type, target, tags, difficulty range, risk level, and date ranges.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            query: z
+                .string()
+                .max(200)
+                .optional()
+                .describe('Free-text fuzzy search query matched against spec id, title, and tags.'),
+            status: z
+                .array(z.enum(STATUS_VALUES))
+                .optional()
+                .describe('Filter by status (OR). Valid values: draft, review, approved, implementing, done, discarded.'),
+            tags: z
+                .array(z.string().max(100))
+                .optional()
+                .describe('Filter by tags (OR — spec must have at least one matching tag).'),
+            type: z
+                .array(z.enum(TYPE_VALUES))
+                .optional()
+                .describe('Filter by type (OR). Valid values: feature, refactor, bugfix, infra, docs, project, agent, tech-debt.'),
+            target: z
+                .array(z.enum(TARGET_VALUES))
+                .optional()
+                .describe('Filter by target (OR). Valid values: frontend, backend, shared, fullstack, infrastructure, database, ios, android.'),
+            difficulty: z
+                .object({
+                min: z.number().int().min(1).max(5).optional(),
+                max: z.number().int().min(1).max(5).optional(),
+            })
+                .optional()
+                .describe('Difficulty range filter (inclusive, 1-5).'),
+            risk: z
+                .array(z.enum(RISK_VALUES))
+                .optional()
+                .describe('Filter by risk level (OR). Valid values: low, medium, high, critical.'),
+            createdAfter: z
+                .string()
+                .optional()
+                .describe('ISO date string — only include specs created after this date.'),
+            createdBefore: z
+                .string()
+                .optional()
+                .describe('ISO date string — only include specs created before this date.'),
+            updatedAfter: z
+                .string()
+                .optional()
+                .describe('ISO date string — only include specs updated after this date.'),
+            updatedBefore: z
+                .string()
+                .optional()
+                .describe('ISO date string — only include specs updated before this date.'),
+            sortBy: z
+                .enum(SORT_BY_VALUES)
+                .optional()
+                .describe('Sort field. Valid values: relevance, createdAt, updatedAt, difficulty. Defaults to relevance when query is set, updatedAt otherwise.'),
+            sortOrder: z
+                .enum(SORT_ORDER_VALUES)
+                .optional()
+                .describe('Sort direction. Valid values: asc, desc.'),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .optional()
+                .describe('Maximum number of results to return (default: 20, max: 100).'),
+            offset: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe('Number of results to skip for pagination (default: 0).'),
+        },
+    }, safeTracked('search_specs', async (args) => handleSearchSpecs(args)));
+    // search_suggestions — SPEC-295
+    server.registerTool('search_suggestions', {
+        description: 'Get autocomplete suggestions for a partial query against a specific field (tags, type, status, or spec id). Useful for building dynamic filters.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectPath: z.string().min(1).max(4096).describe('Absolute path to the project root.'),
+            query: z.string().min(1).max(200).describe('Partial string to match against field values.'),
+            field: z
+                .enum(SUGGESTION_FIELD_VALUES)
+                .optional()
+                .describe('Field to search for suggestions. Valid values: tags, type, status, id. Defaults to tags.'),
+        },
+    }, safeTracked('search_suggestions', async (args) => handleSearchSuggestions(args)));
+}
+//# sourceMappingURL=register-spec-search-tools.js.map

package/dist/tools/register-spec-search-tools.js.map

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

package/dist/tools/register-spec-split-tools.d.ts

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

package/dist/tools/register-spec-split-tools.d.ts.map

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

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

@@ -0,0 +1,51 @@
+// tools/register-spec-split-tools.ts — Registers analyze_spec_size and split_spec (SPEC-289)
+import { z } from 'zod';
+import { safeLicensed } from './safe-handler.js';
+import { handleAnalyzeSpecSize, handleSplitSpec } from './spec-split-handler.js';
+export function registerSpecSplitTools(server) {
+    // analyze_spec_size — read-only, free tier
+    server.registerTool('analyze_spec_size', {
+        description: 'Analyze a spec to determine if it is too large or complex and should be split into ' +
+            'smaller, more atomic specs. ' +
+            'Checks three criteria: >15 acceptance criteria, estimation >40h, or >3 subsystem signals. ' +
+            'Also detects ambiguous criteria with vague language (e.g. "should handle", "properly"). ' +
+            'Returns a SpecSizeAnalysis with shouldSplit flag, reasons, and suggestedSplits.',
+        annotations: { readOnlyHint: true },
+        inputSchema: {
+            projectId: z
+                .string()
+                .max(500)
+                .describe('Project ID that owns the spec (from init_project or list_specs)'),
+            specId: z.string().max(500).describe('Spec ID to analyze (e.g. SPEC-042)'),
+        },
+    }, safeLicensed('analyze_spec_size', async (args) => handleAnalyzeSpecSize(args)));
+    // split_spec — destructive (creates new specs and modifies original), pro tier
+    server.registerTool('split_spec', {
+        description: 'Execute the division of a large spec into smaller child specs. ' +
+            'Creates N new child specs with fresh IDs, marks the original as superseded, ' +
+            'and distributes acceptance criteria according to the proposals. ' +
+            'Child specs inherit tags, target, type and risk from the original. ' +
+            'Use analyze_spec_size first to get the suggested splits, then optionally customize ' +
+            'proposedSplits before calling this tool. ' +
+            'DESTRUCTIVE: modifies the original spec status to "superseded".',
+        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 split (e.g. SPEC-042)'),
+            proposedSplits: z
+                .array(z.object({
+                title: z.string().max(200).describe('Title for the child spec'),
+                description: z.string().max(1000).describe('Description of this child spec scope'),
+                criteriaIndices: z
+                    .array(z.number().int().min(0))
+                    .describe('Zero-based indices of acceptance criteria from the original spec to assign to this child'),
+                dependsOn: z
+                    .array(z.number().int().min(0))
+                    .describe('Zero-based indices of other proposedSplits that this child depends on'),
+            }))
+                .optional()
+                .describe('Custom split proposals. If omitted, uses auto-generated proposals from analyze_spec_size.'),
+        },
+    }, safeLicensed('split_spec', async (args) => handleSplitSpec(args)));
+}
+//# sourceMappingURL=register-spec-split-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-spec-split-tools.js","sourceRoot":"","sources":["../../src/tools/register-spec-split-tools.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAG7F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEjF,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,2CAA2C;IAC3C,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,WAAW,EACT,qFAAqF;YACrF,8BAA8B;YAC9B,4FAA4F;YAC5F,0FAA0F;YAC1F,iFAAiF;QACnF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,WAAW,EAAE;YACX,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,iEAAiE,CAAC;YAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SAC3E;KACF,EACD,YAAY,CAAC,mBAAmB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAC/E,CAAC;IAEF,+EAA+E;IAC/E,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,WAAW,EACT,iEAAiE;YACjE,8EAA8E;YAC9E,kEAAkE;YAClE,qEAAqE;YACrE,qFAAqF;YACrF,2CAA2C;YAC3C,iEAAiE;QACnE,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,kCAAkC,CAAC;YACxE,cAAc,EAAE,CAAC;iBACd,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;gBAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;gBAClF,eAAe,EAAE,CAAC;qBACf,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;qBAC9B,QAAQ,CACP,0FAA0F,CAC3F;gBACH,SAAS,EAAE,CAAC;qBACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;qBAC9B,QAAQ,CAAC,uEAAuE,CAAC;aACrF,CAAC,CACH;iBACA,QAAQ,EAAE;iBACV,QAAQ,CACP,2FAA2F,CAC5F;SACJ;KACF,EACD,YAAY,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAClE,CAAC;AACJ,CAAC"}

package/dist/tools/register-spec-tools/core-spec-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-spec-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/register-spec-tools/core-spec-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0BzE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiR7D"}
+{"version":3,"file":"core-spec-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/register-spec-tools/core-spec-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0BzE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmS7D"}

package/dist/tools/register-spec-tools/core-spec-tools.js

@@ -135,7 +135,16 @@ export function registerCoreSpecTools(server) {
     server.registerTool('list_specs', {
         description: t('tools.list_specs.description'),
         inputSchema: {
-            projectId: z.string().max(500).describe('Project ID'),
+            projectId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Project ID (hash). Prefer projectPath if unknown.'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Absolute path to the project root. Used to derive projectId automatically.'),
             status: SpecStatusEnum.optional().describe('Filter by spec status'),
             type: SpecTypeEnum.optional().describe('Filter by spec type'),
             detail: z
@@ -150,7 +159,16 @@ export function registerCoreSpecTools(server) {
         description: t('tools.update_status.description'),
         inputSchema: {
             specId: z.string().max(500).describe('Spec ID to update'),
-            projectId: z.string().max(500).describe('Project ID'),
+            projectId: z
+                .string()
+                .max(500)
+                .optional()
+                .describe('Project ID (hash). Prefer projectPath if unknown.'),
+            projectPath: z
+                .string()
+                .max(4096)
+                .optional()
+                .describe('Absolute path to the project root. Used to derive projectId automatically.'),
             status: SpecStatusEnum.describe('New status'),
             actuals: z
                 .object({