@smartmemory/compose 0.2.58-beta → 0.3.1-beta

package/README.md

@@ -43,7 +43,7 @@ compose plan "a tool that summarizes my team's standups"
 
 ## Quick install
 
-Prerequisites: Node.js 18+ and `stratum-mcp` on PATH (`pip install stratum-mcp`, requires Python 3.11+). Codex steps additionally need the OpenAI `codex` CLI. Full prereqs in [docs/install.md](docs/install.md).
+Prerequisites: Node.js 18+ and a [Stratum](https://github.com/smartmemory/stratum) checkout as a sibling directory (the TS engine runs from source; `compose init` detects its MCP entrypoint automatically — the python `stratum-mcp` PyPI package is retired). Codex steps additionally need the OpenAI `codex` CLI. Full prereqs in [docs/install.md](docs/install.md).
 
 The package is published to npm as `@smartmemory/compose`. Pick one install style:
 
@@ -51,7 +51,7 @@ The package is published to npm as `@smartmemory/compose`. Pick one install styl
 
 ```bash
 npm install -g @smartmemory/compose
-compose setup                # install bundled skills + register stratum-mcp (alias: compose sync)
+compose setup                # install bundled skills + register the Stratum MCP server (alias: compose sync)
 ```
 
 **Option B — git clone (for development):**

package/bin/compose.js

@@ -3,7 +3,7 @@
  * compose CLI
  *
  * compose init     — initialize Compose in the current project (project-local)
- * compose setup    — install global skill + register stratum-mcp (user-global)
+ * compose setup    — install global Compose skills
  * compose install  — run init + setup (backwards-compat alias)
  * compose start    — start the compose app (supervisor.js)
  * compose build    — headless feature lifecycle runner
@@ -21,6 +21,11 @@ import { resolvePort } from '../lib/resolve-port.js'
 import { resolveRoadmapPath, resolveFeaturesPath, resolveContextPathFromConfig, resolveFeaturesPathFromConfig, resolveRoadmapPathFromConfig } from '../lib/project-paths.js'
 import { installAgentDefs } from '../lib/install-agent-defs.js'
 import { validateAgentString } from '../lib/agent-string.js'
+import {
+  checkStratumWiring,
+  healStratumWiring,
+  resolveStratumMcpConnection,
+} from '../lib/stratum-engine.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const PACKAGE_ROOT = resolve(__dirname, '..')
@@ -137,7 +142,7 @@ if (!cmd || cmd === '--help' || cmd === '-h') {
   console.log('  gate list          List pending gates (--item <id>, --status pending|all|resolved)')
   console.log('  gate resolve <id>  Resolve a gate (--approve|--revise|--kill, --comment <text>)')
   console.log('  init      Initialize Compose in the current project')
-  console.log('  setup     Install/sync global skills + register stratum-mcp (alias: sync)')
+  console.log('  setup     Install/sync global Compose skills (alias: sync)')
   console.log('  sync      Re-sync global skills from this install (alias of setup)')
   console.log('  update    Pull latest compose, reinstall deps, refresh global skill')
   console.log('  doctor    Check external skill dependencies')
@@ -305,6 +310,17 @@ async function runDoctor(flags = []) {
   const verbose = flags.includes('--verbose') || flags.includes('-v')
   const refresh = flags.includes('--refresh-versions')
 
+  const wsId = getWorkspaceFlag(flags)
+  let cwd
+  try {
+    cwd = resolveWorkspace({ workspaceId: wsId }).root
+  } catch (err) {
+    if (err.code !== 'WorkspaceUnset') dieOnWorkspaceError(err)
+    cwd = process.cwd()
+  }
+  // Read-only: `compose doctor` reports stale wiring but never repairs it.
+  const stratumWiring = checkStratumWiring(cwd)
+
   const deps = loadDeps(PACKAGE_ROOT)
   if (!deps) {
     console.error('Error: .compose-deps.json missing or invalid at package root')
@@ -324,7 +340,7 @@ async function runDoctor(flags = []) {
     // so consumers like `JSON.parse(stdout)` work. (Previously two concatenated objects.)
     const report = buildDepReport(result)
     const binaries = buildBinaryReport(checkExternalBinaries(deps))
-    console.log(JSON.stringify({ ...report, binaries, version: versionInfo }, null, 2))
+    console.log(JSON.stringify({ ...report, binaries, version: versionInfo, stratumWiring }, null, 2))
     const allRequiredPresent = result.missing.every(d => d.optional)
     if (strict && !allRequiredPresent) process.exit(1)
     return
@@ -346,6 +362,14 @@ async function runDoctor(flags = []) {
 
   const allRequiredPresent = printDepReport(result, { json: false, verbose })
   printBinaryReport(checkExternalBinaries(deps))
+  console.log('Stratum wiring:')
+  if (stratumWiring.skipped) {
+    console.log(`  - skipped — ${stratumWiring.skipped}`)
+  } else if (stratumWiring.stale) {
+    console.log('  ⚠ stale — run `compose update` to repair it')
+  } else {
+    console.log('  ✓ ok')
+  }
   if (strict && !allRequiredPresent) process.exit(1)
 }
 
@@ -368,29 +392,17 @@ async function runInit(flags, cwdOverride) {
   const composeDir = join(cwd, '.compose')
   mkdirSync(composeDir, { recursive: true })
 
-  // 2. Detect / auto-install stratum
-  let hasStratum = !noStratum && spawnSync('which', ['stratum-mcp'], { encoding: 'utf-8' }).status === 0
-  if (!noStratum && !hasStratum) {
-    console.log('stratum-mcp not found — installing via pip...')
-    const pipResult = spawnSync('pip', ['install', 'stratum-mcp'], {
-      stdio: 'inherit',
-      encoding: 'utf-8',
-    })
-    if (pipResult.status === 0) {
-      // Verify the binary is now on PATH
-      hasStratum = spawnSync('which', ['stratum-mcp'], { encoding: 'utf-8' }).status === 0
-      if (hasStratum) {
-        console.log('stratum-mcp installed successfully')
-      } else {
-        console.warn('Warning: pip install stratum-mcp succeeded but stratum-mcp not found on PATH')
-        console.warn('  The binary may live in a pyenv version dir not on $PATH.')
-        console.warn('  Try: ln -sf "$(python -c \'import sys,os; print(os.path.join(sys.prefix, "bin", "stratum-mcp"))\')" ~/.local/bin/stratum-mcp')
-      }
-    } else {
-      console.warn('Warning: pip install stratum-mcp failed — Stratum will be disabled')
-      console.warn('  Install manually: pip install stratum-mcp  (requires Python >= 3.11)')
+  // 2. Resolve the TS runtime through the same installed-package -> sibling
+  // chain used by the runtime client.
+  let stratumConnection
+  if (!noStratum) {
+    try {
+      stratumConnection = resolveStratumMcpConnection(cwd)
+    } catch (error) {
+      console.warn(`Warning: ${error.message}`)
     }
   }
+  const hasStratum = Boolean(stratumConnection)
   const hasLifecycle = !noLifecycle
 
   // 3. Detect agents
@@ -519,32 +531,22 @@ async function runInit(flags, cwdOverride) {
   // T2-F5 retirement: remove legacy 'agents' entry. The file it points to is
   // now a retirement shim that exits non-zero with a migration message;
   // removing the entry prevents Claude Code from spawning the shim on session start.
-  // The agent_run capability lives on stratum-mcp as stratum_agent_run.
+  // The agent_run capability lives on the Stratum TS MCP server.
   if (mcpConfig.mcpServers.agents) {
     delete mcpConfig.mcpServers.agents
     console.log('Removed retired agents MCP server from .mcp.json (T2-F5). '
       + 'Use stratum_agent_run on the stratum MCP server instead.')
   }
-  if (hasStratum && !mcpConfig.mcpServers.stratum) {
-    // Use absolute path — miniconda/pip binaries may not be on Claude Code's PATH
-    const stratumPath = spawnSync('which', ['stratum-mcp'], { encoding: 'utf-8' }).stdout.trim()
+  if (hasStratum) {
     mcpConfig.mcpServers.stratum = {
-      command: stratumPath || 'stratum-mcp',
+      command: stratumConnection.command,
+      args: stratumConnection.args,
     }
-    console.log('Registered stratum-mcp in .mcp.json')
+    console.log('Registered the Stratum TS MCP server in .mcp.json')
   }
   writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2))
   console.log(`Registered compose-mcp in ${mcpPath}`)
 
-  // 6b. Run stratum-mcp install to register hooks + CLAUDE.md in this project
-  if (hasStratum) {
-    console.log('Running stratum-mcp install for hooks...')
-    const stratumResult = spawnSync('stratum-mcp', ['install'], { cwd, stdio: 'inherit' })
-    if (stratumResult.status !== 0) {
-      console.warn('Warning: stratum-mcp install failed (hooks may not be registered)')
-    }
-  }
-
   // 7. Scaffold ROADMAP.md from template if absent. COMP-PATHS-EXTERNAL:
   // honor a configured (possibly relocated) paths.roadmap instead of always
   // seeding <cwd>/ROADMAP.md. Byte-identical for the default.
@@ -590,7 +592,7 @@ async function runInit(flags, cwdOverride) {
 }
 
 // ---------------------------------------------------------------------------
-// compose setup — user-global setup
+// compose setup — user-global skill setup
 // ---------------------------------------------------------------------------
 
 function runSetup() {
@@ -603,18 +605,6 @@ function runSetup() {
   }
   syncSkills(agents)
 
-  // 2. Register stratum-mcp if available
-  const hasStratum = spawnSync('which', ['stratum-mcp'], { encoding: 'utf-8' }).status === 0
-  if (hasStratum) {
-    console.log('Registering stratum-mcp with Claude Code...')
-    const result = spawnSync('stratum-mcp', ['install'], { stdio: 'inherit' })
-    if (result.status !== 0) {
-      console.warn('Warning: stratum-mcp install failed (non-fatal)')
-    }
-  } else {
-    console.log('stratum-mcp not found — skipping global registration')
-    console.log('  Install later: pip install stratum && compose setup')
-  }
 }
 
 // ---------------------------------------------------------------------------
@@ -723,7 +713,7 @@ async function runUpdate(flags) {
     if (ni.status !== 0) { process.exit(ni.status || 1) }
   }
 
-  // Refresh global skill + stratum-mcp registration
+  // Refresh global skills.
   console.log('')
   console.log('Refreshing global skill installation...')
   runSetup()
@@ -737,6 +727,17 @@ async function runUpdate(flags) {
     // makes all of init's refresh — including its state-migration step — target
     // the right workspace (COMP-MIGRATE-ON-UPGRADE finding 6).
     await runInit([], cwd)
+
+    // State migrations have completed; now best-effort repair stale Stratum MCP
+    // wiring without making an otherwise successful update fail.
+    const wiring = healStratumWiring(cwd)
+    if (wiring.skipped) {
+      console.log(`Stratum wiring repair skipped: ${wiring.skipped}`)
+    } else if (wiring.healed) {
+      console.log('Healed Stratum MCP wiring in .mcp.json')
+    } else {
+      console.log('Stratum MCP wiring already current')
+    }
   }
 
   console.log('')
@@ -754,7 +755,7 @@ if (cmd === 'init') {
 
 if (cmd === 'setup' || cmd === 'sync') {
   // `sync` is an alias for `setup` — both mirror compose-owned skills into the
-  // agent skill dirs and register stratum-mcp. The name `sync` better signals
+  // agent skill dirs. The name `sync` better signals
   // the idempotent "reconcile local skills with this install" job (run it after
   // editing skills locally, when there's no new version to `update` to).
   runSetup()