@planu/cli 4.3.15 → 4.3.17

package/dist/index.js

@@ -33,8 +33,9 @@ if (firstArg && KNOWN_COMMANDS.includes(firstArg)) {
     process.exit(0);
 }
 // Minimal static imports — only what createMcpServer() needs at module load time.
-// Everything else is dynamically imported to keep the module evaluation fast and
-// let initialize respond before the heavy tool graph loads.
+// The official tool surface is registered in main() before transport connection
+// so the first MCP tools/list response is complete for hosts that ignore
+// notifications/tools/list_changed.
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { SERVER_INSTRUCTIONS } from './config/server-instructions.js';
 import { PLANU_VERSION } from './config/version.js';
@@ -44,13 +45,10 @@ function createMcpServer() {
         instructions: SERVER_INSTRUCTIONS,
         capabilities: { tools: {}, resources: {}, prompts: {} },
     }));
-    // Pre-initialize tool/resource/prompt request handlers BEFORE transport connects.
+    // Pre-initialize resource/prompt request handlers BEFORE transport connects.
     // McpServer calls registerCapabilities + sets up list/call handlers only on the
     // FIRST invocation of each surface. After this, later registrations only update
     // in-memory registries — safe to call even after transport connects.
-    s.registerTool('_planu_boot', { description: 'Planu is starting…', inputSchema: {} }, () => ({
-        content: [],
-    }));
     s.registerResource('_planu_boot', '_planu://boot', {}, () => ({ contents: [] }));
     s.registerPrompt('_planu_boot', { title: 'Planu Boot', description: 'Internal prompt handler bootstrap', argsSchema: {} }, () => ({
         messages: [],
@@ -59,13 +57,13 @@ function createMcpServer() {
 }
 // Primary server instance — created immediately at module load with minimal deps.
 const server = createMcpServer();
-// Loads all modules and registers tools after the MCP handshake has completed.
+// Loads post-handshake modules after the MCP handshake has completed.
 // Separated from main() to keep main() within the 80-line function budget.
-async function setupPostHandshake(handshakeGate) {
+async function setupPostHandshake(handshakeGate, officialToolNames) {
     // Wait for initialize + notifications/initialized before firing any notifications.
     await handshakeGate;
     const envKey = process.env.SDD_LICENSE_KEY;
-    const [{ bootstrapAutopilotHandlers }, { registerAgentSquadHandlers }, { startupSync }, { checkForUpdates }, { setConnectedClient }, { handleActivateLicense }, { GroupManager }, { setGroupManager }, { registerSddTools, OFFICIAL_SDD_TOOL_NAMES },] = await Promise.all([
+    const [{ bootstrapAutopilotHandlers }, { registerAgentSquadHandlers }, { startupSync }, { checkForUpdates }, { setConnectedClient }, { handleActivateLicense }, { GroupManager }, { setGroupManager },] = await Promise.all([
         import('./engine/autopilot/bootstrap.js'),
         import('./tools/register-agent-squad-tools.js'),
         import('./tools/sync-spec-state-handler.js'),
@@ -74,7 +72,6 @@ async function setupPostHandshake(handshakeGate) {
         import('./tools/activate-license.js'),
         import('./engine/tool-groups/group-manager.js'),
         import('./tools/tool-group-handler.js'),
-        import('./tools/register-sdd-tools.js'),
     ]);
     // SPEC-450: Wire autopilot trigger rules to the event bus
     bootstrapAutopilotHandlers();
@@ -121,9 +118,6 @@ async function setupPostHandshake(handshakeGate) {
             });
         }
     }
-    // Register the single official SDD MCP surface and UX surfaces.
-    registerSddTools(server);
-    getRegisteredTools().get('_planu_boot')?.disable();
     try {
         const { registerPlanuMcpResources, registerPlanuMcpPrompts } = await import('./hosts/claude-code/ux/index.js');
         registerPlanuMcpResources(server);
@@ -138,7 +132,7 @@ async function setupPostHandshake(handshakeGate) {
         server.sendToolListChanged();
     });
     await groupManager.init();
-    for (const toolName of OFFICIAL_SDD_TOOL_NAMES) {
+    for (const toolName of officialToolNames) {
         toolMap.get(toolName)?.enable();
     }
     setGroupManager(groupManager);
@@ -147,9 +141,14 @@ async function setupPostHandshake(handshakeGate) {
 }
 // Start server
 async function main() {
-    // Dynamic imports keep startup lean — evaluated only after the process is alive.
-    const { selectTransport } = await import('./transports/transport-factory.js');
-    // Gate all heavy loading until the MCP handshake completes (initialize +
+    // Register the official tools before connecting transport. Some hosts cache the
+    // first tools/list response and do not reliably consume list_changed updates.
+    const [{ selectTransport }, { registerSddTools, OFFICIAL_SDD_TOOL_NAMES }] = await Promise.all([
+        import('./transports/transport-factory.js'),
+        import('./tools/register-sdd-tools.js'),
+    ]);
+    registerSddTools(server);
+    // Gate non-tool startup work until the MCP handshake completes (initialize +
     // notifications/initialized). This guarantees the initialize response goes out
     // before any notifications/tools/list_changed events, which is required by the
     // MCP protocol. Without this gate module evaluation (synchronous, ~3-4 s) blocks
@@ -175,9 +174,8 @@ async function main() {
     await new Promise((res) => {
         setImmediate(res);
     });
-    // Fire-and-forget: setupPostHandshake awaits the gate then loads everything.
-    // Module loading starts NOW — after initialize is already handled above.
-    void setupPostHandshake(handshakeGate);
+    // Fire-and-forget: setupPostHandshake awaits the gate before optional startup work.
+    void setupPostHandshake(handshakeGate, OFFICIAL_SDD_TOOL_NAMES);
 }
 process.on('uncaughtException', (error) => {
     /* v8 ignore next 1 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "4.3.15",
+  "version": "4.3.17",
   "description": "Planu — MCP Server for Spec Driven Development with native Rust acceleration for hot paths. Cross-platform (Linux/macOS/Windows, x64/arm64, glibc/musl).",
   "type": "module",
   "main": "dist/index.js",
@@ -34,14 +34,14 @@
     "packageName": "@planu/core"
   },
   "optionalDependencies": {
-    "@planu/core-darwin-arm64": "4.3.15",
-    "@planu/core-darwin-x64": "4.3.15",
-    "@planu/core-linux-arm64-gnu": "4.3.15",
-    "@planu/core-linux-arm64-musl": "4.3.15",
-    "@planu/core-linux-x64-gnu": "4.3.15",
-    "@planu/core-linux-x64-musl": "4.3.15",
-    "@planu/core-win32-arm64-msvc": "4.3.15",
-    "@planu/core-win32-x64-msvc": "4.3.15"
+    "@planu/core-darwin-arm64": "4.3.17",
+    "@planu/core-darwin-x64": "4.3.17",
+    "@planu/core-linux-arm64-gnu": "4.3.17",
+    "@planu/core-linux-arm64-musl": "4.3.17",
+    "@planu/core-linux-x64-gnu": "4.3.17",
+    "@planu/core-linux-x64-musl": "4.3.17",
+    "@planu/core-win32-arm64-msvc": "4.3.17",
+    "@planu/core-win32-x64-msvc": "4.3.17"
   },
   "engines": {
     "node": ">=24.0.0"
@@ -170,7 +170,7 @@
     "@commitlint/cli": "^21.0.1",
     "@commitlint/config-conventional": "^21.0.1",
     "@eslint/js": "^10.0.1",
-    "@napi-rs/cli": "^3.6.2",
+    "@napi-rs/cli": "^3.7.0",
     "@secretlint/secretlint-rule-no-homedir": "^13.0.2",
     "@secretlint/secretlint-rule-preset-recommend": "^13.0.2",
     "@semantic-release/changelog": "^6.0.3",
@@ -205,6 +205,6 @@
     "typescript-eslint": "^8.60.0",
     "vite": "^8.0.14",
     "vitest": "^4.1.7",
-    "vue": "^3.5.34"
+    "vue": "^3.5.35"
   }
 }

package/planu-native.json

@@ -1,7 +1,7 @@
 {
   "name": "dev.planu.native",
   "displayName": "Planu Native Lightweight Surface",
-  "version": "4.3.15",
+  "version": "4.3.17",
   "packageName": "@planu/cli",
   "modes": {
     "lightweight": {

package/planu-plugin.json

@@ -2,7 +2,7 @@
   "name": "dev.planu.cli",
   "displayName": "Planu — Spec Driven Development",
   "description": "Manage software specs, estimations, and autonomous SDD workflows. Language-agnostic MCP server for Claude Code.",
-  "version": "4.3.15",
+  "version": "4.3.17",
   "icon": "assets/plugin/icon.svg",
   "command": ["npx", "@planu/cli@latest"],
   "packageName": "@planu/cli",