rn-iso 0.2.0 → 0.3.0

package/README.md

@@ -47,7 +47,7 @@ All commands below take the same `npx rn-iso` prefix.
 | `status` | Show all projects' state |
 | `reserve [ios\|android]` | Lock a manually-started sim/emulator to the current project (no build) |
 | `unreserve [ios\|android]` | Drop the current project's lock without shutting the sim down |
-| `release [<shortcut>\|<path>] [--platform <p>] [--shutdown]` | Free a project's assignment; `--shutdown` also stops the sim |
+| `release [<port>\|<shortcut>\|<path>] [--platform <p>] [--shutdown]` | Free a project's assignment. Target can be a Metro port (`8083`), a shortcut (label or unique basename), or an absolute path. `--shutdown` also stops the sim. |
 
 ## How it works
 

package/bin/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { readFileSync } from 'node:fs';
 import { Command } from 'commander';
 import deviceCommand from '../src/commands/device.js';
 import iosCommand from '../src/commands/ios.js';
@@ -10,11 +11,13 @@ import releaseCommand from '../src/commands/release.js';
 import reserveCommand from '../src/commands/reserve.js';
 import unreserveCommand from '../src/commands/unreserve.js';
 
+const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+
 const program = new Command();
 program
   .name('rn-iso')
   .description('Isolated React Native dev environments per project/worktree')
-  .version('0.1.0');
+  .version(pkg.version);
 
 deviceCommand(program);
 iosCommand(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rn-iso",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Isolated React Native dev environments per project/worktree",
   "type": "module",
   "bin": {

package/skill/SKILL.md

@@ -82,7 +82,7 @@ Reserve binds the sim to the current project the same way `ios` does, but skips
 - `npx rn-iso status` — show all projects, their assignments, and Metro state.
 - `npx rn-iso start` — start Metro detached on the project's assigned port WITHOUT building/installing. Useful to keep Metro alive across builds.
 - `npx rn-iso stop [<port>|<shortcut>|<path>]` — kill Metro. No arg = current project. Passing a port (e.g. `8083`) kills whatever is on it; a project shortcut (label or unique basename) or absolute path targets that project. Finds the process by port, so it works whether Metro was started by `npx rn-iso start` or by the build CLI.
-- `npx rn-iso release [<shortcut>|<path>] [--platform <p>] [--shutdown]` — free a project's sim assignment. Defaults to the current project. `--shutdown` also stops the sim/emulator.
+- `npx rn-iso release [<port>|<shortcut>|<path>] [--platform <p>] [--shutdown]` — free a project's sim assignment. Defaults to the current project. Target can also be a Metro port (`8083`) or a shortcut (label / unique basename). `--shutdown` also stops the sim/emulator.
 
 ### Project shortcuts (--label)
 

package/src/commands/release.js

@@ -1,21 +1,34 @@
 // src/commands/release.js
 import chalk from 'chalk';
+import prompts from 'prompts';
 import { resolveRegisteredProject } from '../project.js';
-import { getProject, clearDevice } from '../config.js';
+import { getProject, clearDevice, findProjectByMetroPort } from '../config.js';
+import { findPidListeningOnPort } from '../metro.js';
 import { shutdownIosSim } from '../sim/ios.js';
 import { shutdownAndroidEmulator } from '../sim/android.js';
 
 export default function releaseCommand(program) {
   program
     .command('release [target]')
-    .description('Free a project assignment. [target] is an absolute project path; defaults to the current project.')
+    .description('Free a project assignment. [target] is a Metro port (e.g. 8083), a project shortcut (label or unique basename), or an absolute path. Defaults to the current project.')
     .option('--platform <platform>', 'ios or android (default: both)')
     .option('--shutdown', 'Also shut down the simulator/emulator after releasing')
-    .action((target, opts) => {
-      const { found, error } = resolveRegisteredProject(target);
-      if (!found) {
-        console.error(chalk.red(error));
-        process.exit(1);
+    .action(async (target, opts) => {
+      let found;
+      if (target && /^\d+$/.test(target)) {
+        const port = parseInt(target, 10);
+        found = findProjectByMetroPort(port);
+        if (!found) {
+          await handleUnmatchedPort(port);
+          return;
+        }
+      } else {
+        const result = resolveRegisteredProject(target);
+        if (!result.found) {
+          console.error(chalk.red(result.error));
+          process.exit(1);
+        }
+        found = result.found;
       }
       const proj = getProject(found);
       if (!proj) {
@@ -43,3 +56,33 @@ export default function releaseCommand(program) {
       }
     });
 }
+
+async function handleUnmatchedPort(port) {
+  const pid = findPidListeningOnPort(port);
+  if (!pid) {
+    console.error(chalk.red(`No registered project has Metro port ${port}, and nothing is listening on that port.`));
+    process.exit(1);
+  }
+  console.log(chalk.dim(`No registered project has Metro port ${port}, but pid ${pid} is listening.`));
+  if (!process.stdin.isTTY) {
+    console.error(chalk.red('Refusing to kill an unrecognized process under non-TTY (no way to confirm).'));
+    process.exit(1);
+  }
+  const ok = await prompts({
+    type: 'confirm',
+    name: 'ok',
+    message: `Kill pid ${pid} on port ${port}?`,
+    initial: false,
+  });
+  if (!ok.ok) {
+    console.error(chalk.red('Cancelled.'));
+    process.exit(1);
+  }
+  try {
+    process.kill(pid, 'SIGTERM');
+    console.log(chalk.green(`Killed pid ${pid} on port ${port}.`));
+  } catch (e) {
+    console.error(chalk.red(`Could not kill pid ${pid}: ${e.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/status.js

@@ -3,7 +3,8 @@ import chalk from 'chalk';
 import { loadConfig } from '../config.js';
 import { isMetroRunning } from '../ports.js';
 import { isPidAlive } from '../metro.js';
-import { findProjectRoot } from '../project.js';
+import { findProjectRoot, projectShortcut } from '../project.js';
+import { listAllIosSims } from '../sim/ios.js';
 
 export default function statusCommand(program) {
   program
@@ -19,11 +20,20 @@ export default function statusCommand(program) {
 
       const cwdRoot = findProjectRoot(process.cwd());
 
+      // Build a UDID -> sim name map so we can show "iPhone 16 Pro (UDID)"
+      // rather than a raw UDID. Tolerate missing simctl (Linux dev box, etc.).
+      let iosNameByUdid = {};
+      try {
+        for (const sim of listAllIosSims()) iosNameByUdid[sim.udid] = sim.name;
+      } catch { /* no simctl available; we'll just print the udid */ }
+
       for (const [path, proj] of Object.entries(cfg?.projects || {})) {
         const isCurrent = path === cwdRoot;
-        const header = isCurrent ? chalk.bold.cyan(`* ${path}`) : path;
+        const shortcut = projectShortcut(path, proj);
+        const headerText = `${shortcut} ${chalk.dim(`(${path})`)}`;
+        const header = isCurrent ? chalk.bold.cyan(`* ${shortcut}`) + ' ' + chalk.dim(`(${path})`) : headerText;
         console.log('\n' + header);
-        console.log(chalk.dim(`  app: ${proj.bundleId} (${proj.isExpo ? 'expo' : 'bare'})`));
+        console.log(chalk.dim(`  app: ${proj.bundleId ?? '?'} (${proj.isExpo ? 'expo' : 'bare'})`));
 
         if (proj.metroPort) {
           const running = await isMetroRunning(proj.metroPort);
@@ -37,9 +47,14 @@ export default function statusCommand(program) {
         }
 
         const ios = proj.platforms?.ios;
-        if (ios) console.log(`  ios: ${chalk.cyan(ios.deviceUdid)}`);
+        if (ios) {
+          const name = iosNameByUdid[ios.deviceUdid] || chalk.dim('(unknown sim)');
+          console.log(`  ios: ${chalk.cyan(name)} ${chalk.dim(`(${ios.deviceUdid})`)}`);
+        }
         const android = proj.platforms?.android;
-        if (android) console.log(`  android: ${chalk.cyan(android.avdName)} on emulator-${android.consolePort}`);
+        if (android) {
+          console.log(`  android: ${chalk.cyan(android.avdName)} ${chalk.dim(`(emulator-${android.consolePort})`)}`);
+        }
       }
       console.log('');
     });

package/src/commands/stop.js

@@ -1,9 +1,8 @@
 // src/commands/stop.js
 import chalk from 'chalk';
 import { resolveRegisteredProject } from '../project.js';
-import { loadConfig, getProject, setMetro } from '../config.js';
-import { killMetroByPid } from '../metro.js';
-import { getExecutor } from '../exec.js';
+import { getProject, setMetro, findProjectByMetroPort } from '../config.js';
+import { killMetroByPid, findPidListeningOnPort } from '../metro.js';
 
 export default function stopCommand(program) {
   program
@@ -65,19 +64,10 @@ function killByPort(port) {
   console.log(chalk.green(`Killed pid ${pid} on port ${port}`));
 
   // If a project owned this port, clear its recorded pid so `status` reflects.
-  const cfg = loadConfig();
-  for (const [path, proj] of Object.entries(cfg?.projects || {})) {
-    if (proj.metroPort === port) {
-      setMetro(path, port, null);
-      console.log(chalk.dim(`Cleared metroPid for ${path}`));
-      break;
-    }
+  const owner = findProjectByMetroPort(port);
+  if (owner) {
+    setMetro(owner, port, null);
+    console.log(chalk.dim(`Cleared metroPid for ${owner}`));
   }
 }
 
-function findPidListeningOnPort(port) {
-  const out = getExecutor().runQuiet(`lsof -nP -iTCP:${port} -sTCP:LISTEN -t`);
-  if (!out) return null;
-  const pid = parseInt(out.split('\n')[0], 10);
-  return Number.isFinite(pid) ? pid : null;
-}

package/src/config.js

@@ -96,6 +96,14 @@ export function allMetroPorts() {
     .filter(p => typeof p === 'number');
 }
 
+export function findProjectByMetroPort(port) {
+  const cfg = loadConfig();
+  for (const [path, proj] of Object.entries(cfg?.projects || {})) {
+    if (proj.metroPort === port) return path;
+  }
+  return null;
+}
+
 export function allClaimedDevices() {
   const cfg = loadConfig();
   const result = {

package/src/metro.js

@@ -52,6 +52,13 @@ export function killMetroByPid(pid) {
   }
 }
 
+export function findPidListeningOnPort(port) {
+  const out = getExecutor().runQuiet(`lsof -nP -iTCP:${port} -sTCP:LISTEN -t`);
+  if (!out) return null;
+  const pid = parseInt(out.split('\n')[0], 10);
+  return Number.isFinite(pid) ? pid : null;
+}
+
 export function isPidAlive(pid) {
   if (!pid) return false;
   try {