claude-tempo 0.1.1 → 0.1.3

package/README.md

@@ -142,6 +142,7 @@ The `claude-tempo` CLI handles setup, session management, and diagnostics.
 | Command | Description |
 |---------|-------------|
 | `up [ensemble]` | First-time setup: start Temporal, configure MCP, launch conductor |
+| `down` | Stop Temporal, terminate sessions, remove MCP config |
 | `server` | Start the Temporal dev server and register search attributes |
 | `conduct [ensemble]` | Start a conductor session (one per ensemble) |
 | `start [ensemble]` | Start a player session |
@@ -154,7 +155,7 @@ The `claude-tempo` CLI handles setup, session management, and diagnostics.
 
 ```
 --temporal-address <addr>   Temporal server address (default: localhost:7233)
--n, --name <name>           Set the session window name (start/conduct/up)
+-n, --name <name>           Set the player name for the session (start/conduct/up)
 --skip-preflight            Skip preflight checks (start/conduct)
 --background, -d            Run Temporal in background (server only)
 --dir <path>                Target directory for init (default: cwd)
@@ -211,14 +212,14 @@ claude-tempo server -d              # shorthand
 {
   "mcpServers": {
     "claude-tempo": {
-      "command": "claude-tempo-server",
-      "args": []
+      "command": "npx",
+      "args": ["claude-tempo-server"]
     }
   }
 }
 ```
 
-No source code or absolute paths needed — `claude-tempo-server` is installed on PATH via the npm package.
+Uses `npx` to resolve the server binary, so it works regardless of PATH configuration.
 
 ### `status` — ensemble overview
 
@@ -330,13 +331,13 @@ The `recruit` tool and CLI automatically detect and open sessions in your termin
 | Terminal.app | `.command` file | — | — |
 | gnome-terminal | — | `--` flag | — |
 | konsole / xterm | — | `-e` flag | — |
-| cmd.exe / PowerShell | — | — | `shell:true` |
+| cmd.exe / PowerShell | — | — | `start` command |
 
 All macOS terminals use approaches that preserve the user's full shell environment (fish, zsh, bash) including node version managers (fnm, nvm).
 
 ### Session naming
 
-Sessions start with a random 8-character hex ID. Use `set_name` to give a session a human-readable name:
+Sessions start with a random 8-character hex ID. You can set a name at launch with `-n` or use `set_name` inside a session:
 
 - Names are stored as Temporal search attributes (`ClaudeTempoPlayerId`) and updated in-place — no workflow restart needed
 - Other players use the name to send messages via `cue` and discover sessions via `ensemble`
@@ -353,6 +354,7 @@ Sessions start with a random 8-character hex ID. Use `set_name` to give a sessio
 | `CLAUDE_TEMPO_TASK_QUEUE` | `claude-tempo` | Task queue name |
 | `CLAUDE_TEMPO_ENSEMBLE` | `default` | Ensemble name (isolates groups of players) |
 | `CLAUDE_TEMPO_CONDUCTOR` | `false` | Set to `true` to enable conductor mode |
+| `CLAUDE_TEMPO_PLAYER_NAME` | *(random hex)* | Set a player name on startup (used by `-n` flag) |
 
 ## Development
 

package/dist/cli/commands.js

@@ -47,6 +47,7 @@ const child_process_1 = require("child_process");
 const os_1 = require("os");
 const client_1 = require("@temporalio/client");
 const spawn_1 = require("../spawn");
+const config_1 = require("../config");
 const preflight_1 = require("./preflight");
 const out = __importStar(require("./output"));
 /** Package root is two levels up from dist/cli/ */
@@ -67,6 +68,23 @@ async function start(opts) {
         }
     }
     const role = opts.conductor ? 'conductor' : 'player';
+    // Check if a conductor workflow already exists for this ensemble
+    if (opts.conductor) {
+        try {
+            const connection = await client_1.Connection.connect({ address: opts.temporalAddress });
+            const client = new client_1.Client({ connection });
+            const conductorWfId = (0, config_1.conductorWorkflowId)(opts.ensemble);
+            const handle = client.workflow.getHandle(conductorWfId);
+            const desc = await handle.describe();
+            if (desc.status.name === 'RUNNING') {
+                out.warn(`A conductor workflow already exists for ensemble "${opts.ensemble}". Reconnecting...`);
+            }
+            await connection.close();
+        }
+        catch {
+            // No existing conductor — proceed normally
+        }
+    }
     out.log(`Starting ${out.bold(role)} in ensemble ${out.cyan(opts.ensemble)}`);
     const claudeArgs = [
         '--dangerously-skip-permissions',
@@ -81,6 +99,9 @@ async function start(opts) {
     if (opts.conductor) {
         envVars.CLAUDE_TEMPO_CONDUCTOR = 'true';
     }
+    if (opts.name) {
+        envVars.CLAUDE_TEMPO_PLAYER_NAME = opts.name;
+    }
     const { pid } = (0, spawn_1.spawnInTerminal)(claudeArgs, workDir, envVars);
     out.success(`Launched ${role} session${opts.name ? ` "${opts.name}"` : ''} (pid ${pid ?? 'unknown'})`);
     out.log(`  Ensemble: ${opts.ensemble}`);
@@ -171,8 +192,8 @@ async function status(opts) {
 async function init(opts) {
     const mcpPath = (0, path_1.join)(opts.dir, '.mcp.json');
     const entry = {
-        command: 'claude-tempo-server',
-        args: [],
+        command: 'npx',
+        args: ['claude-tempo-server'],
     };
     if ((0, fs_1.existsSync)(mcpPath)) {
         try {

package/dist/server.js

@@ -89,7 +89,7 @@ async function main() {
     }
     const config = (0, config_1.getConfig)();
     const isConductor = process.env.CLAUDE_TEMPO_CONDUCTOR === 'true';
-    let playerId = isConductor ? 'conductor' : crypto.randomBytes(4).toString('hex');
+    let playerId = isConductor ? 'conductor' : (process.env.CLAUDE_TEMPO_PLAYER_NAME || crypto.randomBytes(4).toString('hex'));
     const getPlayerId = () => playerId;
     const setPlayerId = (id) => { playerId = id; };
     const workDir = process.cwd();

package/dist/spawn.js

@@ -174,11 +174,12 @@ function spawnInTerminal(claudeArgs, workDir, envVars) {
         return { pid: child.pid };
     }
     if (process.platform === 'win32') {
-        const child = (0, child_process_1.spawn)(claudeBin, claudeArgs, {
+        // Use 'start' to open a visible terminal window, and pass the full
+        // command as a single string to avoid DEP0190 deprecation warning
+        const child = (0, child_process_1.spawn)('cmd.exe', ['/c', 'start', '""', claudeBin, ...claudeArgs], {
             cwd: workDir,
             detached: true,
             stdio: 'ignore',
-            shell: true,
             env: { ...process.env, ...envVars },
         });
         child.unref();

package/package.json

@@ -1,9 +1,28 @@
 {
   "name": "claude-tempo",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "MCP server for multi-session Claude Code coordination via Temporal",
   "type": "commonjs",
   "main": "dist/server.js",
+  "exports": {
+    ".": "./dist/server.js",
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./spawn": {
+      "types": "./dist/spawn.d.ts",
+      "default": "./dist/spawn.js"
+    },
+    "./signals": {
+      "types": "./dist/workflows/signals.d.ts",
+      "default": "./dist/workflows/signals.js"
+    }
+  },
   "bin": {
     "claude-tempo": "dist/cli.js",
     "claude-tempo-server": "dist/server.js"
@@ -26,8 +45,17 @@
     "ts-node": "^10.9.0",
     "typescript": "^5.5.0"
   },
+  "typesVersions": {
+    "*": {
+      "types": ["dist/types.d.ts"],
+      "config": ["dist/config.d.ts"],
+      "spawn": ["dist/spawn.d.ts"],
+      "signals": ["dist/workflows/signals.d.ts"]
+    }
+  },
   "files": [
     "dist",
+    "workflow-bundle.js",
     "CLAUDE.md",
     "README.md"
   ],