@deeeed/metamask-harness 0.3.7 → 0.3.9

package/src/mm-harness-cli.ts

@@ -7,11 +7,13 @@
 // teach; genuinely-unknown commands fall to commander's default.
 
 import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { Command } from 'commander';
 
+import { color } from './cli-color.ts';
 import { handleUpdate, maybeNudge } from './commands/update.ts';
 
 // …/src → its parent is the package root that holds scripts/.
@@ -57,6 +59,25 @@ Example:
   mm-harness actions --adapter mobile
   mm-harness actions --adapter extension --raw`,
   },
+  {
+    name: 'stop',
+    summary: 'Stop the dev server this checkout owns (mobile: port-scoped Metro) and close its log window.',
+    example: 'mm-harness stop',
+    helpText: `mm-harness stop [flags]
+
+  Stop the Metro dev server this checkout owns and close its tmux log-tail window.
+  Port-scoped: only the listener on the checkout's resolved port is signalled, so
+  concurrent slots are untouched. Nothing running = success (idempotent).
+  Extension/core: teaching error (their dev servers are slot-managed).
+
+  --port <port>                      Metro port (default: the checkout's slot context)
+  --target <path>                    Checkout path (default: cwd)
+  --json                             Machine-readable output
+
+Example:
+  mm-harness stop
+  mm-harness stop --port 8061`,
+  },
   {
     name: 'call',
     summary: 'Run one action in isolation as a one-node recipe through the real engine path (fuzzy short names; --arg k=v; same trace/evidence as run).',
@@ -345,7 +366,7 @@ const HELP_GROUPS: HelpGroup[] = [
   {
     title: 'DAILY LOOP',
     blurb: 'what a teammate runs many times a day (auto-ensures the overlay; --heal owns recovery)',
-    commands: ['launch', 'logs', 'debug', 'fixtures'],
+    commands: ['launch', 'stop', 'logs', 'debug', 'fixtures'],
   },
   {
     title: 'DISCOVER',
@@ -375,19 +396,51 @@ function commandMeta(name: string): { summary: string; example: string; planned:
   return { summary: '', example: '', planned: false };
 }
 
+// Slot context the orchestrator's prepare wrote into the checkout, when the
+// help is run from inside one. Presence-gated: no context, no line.
+function detectedSlotLine(out: (style: string, text: string) => string): string | null {
+  const ctxPath = path.join(
+    process.cwd(),
+    process.env.RECIPE_RUNTIME_DIR || 'temp/recipe/runtime',
+    'agentic-runtime.json',
+  );
+  try {
+    const ctx = JSON.parse(fs.readFileSync(ctxPath, 'utf8')) as Record<string, unknown>;
+    const parts: string[] = [];
+    if (ctx.slotId) parts.push(`slot ${out('ok', String(ctx.slotId))}`);
+    if (ctx.simulator) parts.push(`device ${out('ok', String(ctx.simulator))}`);
+    if (ctx.metroPort) parts.push(`metro :${out('ok', String(ctx.metroPort))}`);
+    if (ctx.gitBranch) parts.push(`branch ${out('info', String(ctx.gitBranch))}`);
+    if (parts.length === 0) return null;
+    return `${out('label', 'SLOT')} — this checkout is a prepared slot: ${parts.join(' · ')}`;
+  } catch {
+    return null;
+  }
+}
+
 function groupedHelp(): string {
+  const out = (style: string, text: string) => color(style, text, { stream: process.stdout });
   const lines: string[] = [];
-  lines.push('mm-harness — one front door for the MetaMask recipe loop: launch the app, prove behavior, manage the runtime overlay.');
+  lines.push(`${out('bold', 'mm-harness')} — one front door for the MetaMask recipe loop: launch the app, prove behavior, manage the runtime overlay.`);
   lines.push('Run it from inside a MetaMask checkout; the platform (mobile | extension | core) is auto-detected.');
-  lines.push('Grammar: mm-harness <command> [target] [flags]   (target is a positional: ios | android; flags add agent depth; --json is the agent contract)');
+  lines.push(`Grammar: ${out('cmd', 'mm-harness <command> [target] [flags]')}   (target is a positional: ios | android; flags add agent depth; --json is the agent contract)`);
+  if (process.env.MM_HARNESS_BIN) {
+    lines.push('');
+    lines.push(`${out('warn', 'DEV OVERRIDE ACTIVE')} — this run is served by MM_HARNESS_BIN=${out('path', process.env.MM_HARNESS_BIN)} (unset it to return to the installed/global bin).`);
+  }
+  const slotLine = detectedSlotLine(out);
+  if (slotLine) {
+    lines.push('');
+    lines.push(slotLine);
+  }
   for (const group of HELP_GROUPS) {
     lines.push('');
-    lines.push(`${group.title} — ${group.blurb}:`);
+    lines.push(`${out('label', group.title)} — ${group.blurb}:`);
     for (const name of group.commands) {
       const meta = commandMeta(name);
       const planned = meta.planned ? '   (planned)' : '';
-      lines.push(`  ${name.padEnd(10)} ${meta.summary}${planned}`);
-      lines.push(`               ${meta.example}`);
+      lines.push(`  ${out('cmd', name.padEnd(10))} ${meta.summary}${planned}`);
+      lines.push(`               ${out('comment', meta.example)}`);
     }
   }
   lines.push('');