@phi-code-admin/phi-code 0.84.0 → 0.84.2

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## [0.84.2] - 2026-06-14
+
+### Fixed
+
+- **The `/mcp` command was missing until at least one server was configured.**
+  The bundled mcp extension returned early when `mcp.json` had no servers, so
+  `/mcp` never registered and there was no way to discover how to set MCP up. It
+  now always registers `/mcp` (plus `/mcp:start`, `/mcp:stop`, `/mcp:auth`); when
+  no servers are configured, `/mcp` prints guidance and an example `mcp.json`.
+  Servers are still only connected when one is actually configured.
+
+## [0.84.1] - 2026-06-14
+
+### Fixed
+
+- **`phi` failed to start with "Cannot find module 'zod'" after the bundled MCP
+  extension shipped.** The postinstall scaffolds a copy of the bundled extensions
+  under `~/.phi/agent/extensions/` and symlinks their runtime deps into that
+  folder's `node_modules`, but it only linked the sigma packages, not `zod` or
+  `@modelcontextprotocol/sdk` (both added with the mcp extension in 0.83.0). The
+  global copy of `mcp/` could therefore not resolve `zod`. The postinstall now
+  also links `zod` and `@modelcontextprotocol/sdk`. (typebox and phi-code*
+  resolve through the loader's module aliases, so they do not need linking.)
+
 ## [0.84.0] - 2026-06-14
 
 ### Added

package/extensions/phi/mcp/index.ts

@@ -69,10 +69,9 @@ export default async function (pi: ExtensionAPI): Promise<void> {
     return;
   }
 
-  if (Object.keys(config.mcpServers).length === 0) {
-    // No servers configured — silently exit. Users can create mcp.json later.
-    return;
-  }
+  // Even with zero configured servers we proceed so the bundled `/mcp` command
+  // is always available (discoverability); it then guides the user to create an
+  // mcp.json. Servers are still only connected when one is actually configured.
 
   // ── 2. Initialize bridge components ──────────────────────────────────────
   // Auth callbacks — opens browser and notifies user when OAuth is needed
@@ -172,6 +171,13 @@ export default async function (pi: ExtensionAPI): Promise<void> {
           .filter(Boolean)
           .join("\n");
         ctx.ui.notify(detail, "info");
+      } else if (manager.getAllServers().length === 0) {
+        // No servers configured yet: guide the user instead of showing nothing.
+        ctx.ui.notify(
+          'No MCP servers configured. Create ~/.phi/agent/mcp.json (global) or .phi/mcp.json (project) with an "mcpServers" block, e.g.:\n' +
+            '{ "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."], "lifecycle": "eager" } } }',
+          "info",
+        );
       } else {
         // Summary view: all servers
         ctx.ui.notify(manager.getStatusSummary(), "info");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@phi-code-admin/phi-code",
-	"version": "0.84.0",
+	"version": "0.84.2",
 	"description": "Coding agent CLI with persistent memory, sub-agents, intelligent routing, and orchestration",
 	"type": "module",
 	"piConfig": {

package/scripts/postinstall.cjs

@@ -48,16 +48,21 @@ for (const { src, dest, label } of copies) {
   }
 }
 
-// 2. Make sigma packages resolvable from ~/.phi/agent/extensions/
-// Create node_modules with symlinks to the actual packages
-const sigmaPackages = ["sigma-memory", "sigma-agents", "sigma-skills"];
+// 2. Make bundled-extension runtime deps resolvable from ~/.phi/agent/extensions/
+// Create node_modules with symlinks to the actual packages. Includes the sigma
+// packages plus the non-phi-internal deps the bundled extensions import directly
+// (zod + the MCP SDK for the mcp extension). typebox and phi-code* resolve via the
+// loader's module aliases, so they are not listed here. Any new bundled-extension
+// dependency that is not phi-internal and not typebox must be added to this list.
+const extensionDeps = ["sigma-memory", "sigma-agents", "sigma-skills", "zod", "@modelcontextprotocol/sdk"];
 const extensionsNodeModules = join(agentDir, "extensions", "node_modules");
 mkdirSync(extensionsNodeModules, { recursive: true });
 
-for (const pkg of sigmaPackages) {
+for (const pkg of extensionDeps) {
   const srcPkg = join(packageDir, "node_modules", pkg);
   const destLink = join(extensionsNodeModules, pkg);
-  
+  mkdirSync(dirname(destLink), { recursive: true });
+
   if (!existsSync(srcPkg)) {
     // Try parent node_modules (hoisted)
     let parent = dirname(packageDir);