@smartmemory/compose 0.2.33-beta → 0.2.34-beta

package/bin/compose.js

@@ -16,6 +16,7 @@ import { spawn, spawnSync } from 'child_process'
 import { fileURLToPath } from 'url'
 import { findProjectRoot } from '../server/find-root.js'
 import { resolveWorkspace, getWorkspaceFlag } from '../lib/resolve-workspace.js'
+import { resolvePort } from '../lib/resolve-port.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const PACKAGE_ROOT = resolve(__dirname, '..')
@@ -2772,8 +2773,10 @@ if (cmd === 'build') {
     process.exit(1)
   }
 
-  // Resolve compose server URL (default http://localhost:3000)
-  const baseUrl = process.env.COMPOSE_URL || 'http://localhost:3000'
+  // Resolve compose server URL. Default must match the API server port
+  // (resolvePort: COMPOSE_PORT > PORT > 4001) — a stale :3000 here made every
+  // `compose loops` call fail with ECONNREFUSED in a default install.
+  const baseUrl = process.env.COMPOSE_URL || `http://127.0.0.1:${resolvePort()}`
 
   // COMP-WORKSPACE-HTTP T7: resolve workspace tolerantly so we can attach
   // X-Compose-Workspace-Id to the HTTP calls below. Loops CLI did not previously

package/lib/resolve-port.js

@@ -1,7 +1,13 @@
 /**
  * Canonical port resolution for the Compose server.
- * Single source of truth: COMPOSE_PORT > PORT > 3001.
+ * Single source of truth: COMPOSE_PORT > PORT > 4001.
+ *
+ * The default MUST match server/index.js (`PORT || 4001`) and the supervisor,
+ * which start the API server on 4001. A stale 3001 default here silently sent
+ * every CLI probe / MCP lifecycle call / agent-hook to a dead port while the
+ * real server was alive on 4001 — gates fell back to readline, completions and
+ * loops failed with ECONNREFUSED.
  */
 export function resolvePort() {
-  return Number(process.env.COMPOSE_PORT) || Number(process.env.PORT) || 3001;
+  return Number(process.env.COMPOSE_PORT) || Number(process.env.PORT) || 4001;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartmemory/compose",
-  "version": "0.2.33-beta",
+  "version": "0.2.34-beta",
   "description": "Structured AI dev pipeline — goal-to-product orchestration with gates, iteration loops, and feature lifecycle management.",
   "author": "SmartMemory",
   "license": "MIT",

package/server/agent-hooks.js

@@ -2,14 +2,16 @@
  * SDK hook callbacks for the Agent Server.
  *
  * These are in-process JavaScript functions passed to query() — not shell
- * scripts. They POST structured events to the api-server (port 3001), which
+ * scripts. They POST structured events to the api-server (port 4001), which
  * feeds SessionManager and VisionServer, preserving all Phase 3 monitoring.
  *
  * Single source of truth for TOOL_CATEGORIES (previously duplicated in
  * Terminal.jsx and vision-server.js).
  */
 
-const API_SERVER = `http://127.0.0.1:${process.env.PORT || 3001}`;
+import { resolvePort } from '../lib/resolve-port.js';
+
+const API_SERVER = `http://127.0.0.1:${resolvePort()}`;
 
 /** Semantic category for each Claude Code tool */
 export const TOOL_CATEGORIES = {

package/server/agent-server.js

@@ -6,7 +6,7 @@
  * User input arrives via POST — SSE is the right transport for a unidirectional
  * async iterator.
  *
- * Process isolation: this server only talks to api-server (3001) via SDK hooks.
+ * Process isolation: this server only talks to api-server (4001) via SDK hooks.
  * SessionManager and VisionServer require zero changes.
  */
 

package/server/compose-mcp-tools.js

@@ -114,6 +114,7 @@ export function assertTerminalStatusAuthorized(args, toolName, capsOverride) {
 }
 import { resolveWorkspace } from '../lib/resolve-workspace.js';
 import { discoverWorkspaces } from '../lib/discover-workspaces.js';
+import { resolvePort } from '../lib/resolve-port.js';
 
 export function getVisionFile() { return path.join(getDataDir(), 'vision-state.json'); }
 export function getSessionsFile() { return path.join(getDataDir(), 'sessions.json'); }
@@ -549,7 +550,7 @@ export async function toolBindSession({ featureCode, profile } = {}) {
 // ---------------------------------------------------------------------------
 
 function _getComposeApi() {
-  return `http://127.0.0.1:${process.env.COMPOSE_PORT || process.env.PORT || 3001}`;
+  return `http://127.0.0.1:${resolvePort()}`;
 }
 
 async function _postLifecycle(itemId, action, body) {
@@ -592,7 +593,7 @@ async function _postGate(gateId, action, body) {
  * COMP-WORKSPACE-HTTP T5.
  */
 async function _httpRequest(method, urlPath, body = null) {
-  const port = process.env.COMPOSE_PORT || process.env.PORT || 3001;
+  const port = resolvePort();
   const headers = { 'Content-Type': 'application/json' };
   if (_binding?.id) headers['X-Compose-Workspace-Id'] = _binding.id;
   let payload = null;

package/server/supervisor.js

@@ -1,9 +1,9 @@
 /**
  * Process supervisor for Compose.
  * Manages three independent processes:
- *   1. API server (port 3001) — Express + file-watcher + vision
- *   2. Agent server (port 3002) — SDK streaming, structured messages (Tier 1, immortal)
- *   3. Vite dev server (port 5173) — Frontend HMR
+ *   1. API server (port 4001) — Express + file-watcher + vision
+ *   2. Agent server (port 4002) — SDK streaming, structured messages (Tier 1, immortal)
+ *   3. Vite dev server (port 5195) — Frontend HMR
  *
  * Each process gets independent restart with exponential backoff.
  * If a process keeps crashing for > 1 minute, the supervisor gives up on it.