@firenet-designs/fnd-cli 2.4.0 → 2.6.0

package/dist/lib/workspace.js

@@ -157,6 +157,29 @@ export const shQuote = (value) => `'${value.replaceAll("'", `'\\''`)}'`;
 const DEVTOOLS_MCP_NAME = 'chrome-devtools';
 /** MCP server name registered for the --rpc local-command tunnel. */
 const RPC_MCP_NAME = 'local-shell';
+/**
+ * The `claude` CLIs an MCP entry is registered with / removed from. `claude2` is
+ * an overflow instance some remotes run alongside `claude`; both need the same
+ * project-local MCP config so whichever the user opens sees the workspace tools.
+ * Each is guarded by its own `command -v` — a remote without a given CLI just
+ * skips it. Keep add and remove over the same list so cleanup is complete.
+ *
+ * These are emitted as LITERAL command words, never `for cli in …; do "$cli" …`.
+ * On some remotes `claude2` is a shell *alias* (defined in ~/.bashrc / ~/.zshrc),
+ * and aliases are only expanded when the command word is a literal read by the
+ * parser — an alias never expands from a variable like `"$cli"`. Alias support is
+ * also why the add/remove blocks run under an *interactive* login shell (see the
+ * `-lic` note below): rc files, where the alias lives, are sourced only for
+ * interactive shells.
+ */
+const CLAUDE_CLIS = ['claude', 'claude2'];
+/**
+ * Emit a guarded per-CLI block for each entry in {@link CLAUDE_CLIS}. `cli` is
+ * interpolated literally (not via a variable) so a shell-alias `claude2` still
+ * expands. `command -v` gates each one so a remote missing a CLI just skips it;
+ * `body(cli)` returns the lines to run inside the guard.
+ */
+const forEachClaudeCli = (body) => CLAUDE_CLIS.flatMap((cli) => [`if command -v ${cli} >/dev/null 2>&1; then`, ...body(cli).map((l) => `  ${l}`), 'fi']);
 /**
  * Bash lines (run on the REMOTE, from inside the workspace dir) that register the
  * chrome-devtools MCP with the `claude` CLI. Local scope keys off the current
@@ -164,22 +187,25 @@ const RPC_MCP_NAME = 'local-shell';
  * A prior entry is cleared first so a re-connect after a crashed session is
  * idempotent. Skips gracefully if the claude CLI is missing.
  *
- * The block runs inside a login shell (`$SHELL -lc`): the outer script arrives as
- * a non-login ssh command whose PATH lacks the node/nvm/volta/Homebrew dirs that
- * login profiles add, so a bare `command -v claude` misses an installed CLI. A
- * login shell reproduces the same PATH the interactive session below gets.
+ * The block runs inside an *interactive* login shell (`$SHELL -lic`). Login (`-l`)
+ * because the outer script arrives as a non-login ssh command whose PATH lacks the
+ * node/nvm/volta/Homebrew dirs that login profiles add, so a bare `command -v
+ * claude` would miss an installed CLI. Interactive (`-i`) because on some remotes
+ * `claude2` is a shell alias defined in ~/.bashrc / ~/.zshrc, and those rc files
+ * are sourced only for interactive shells — a plain `-lc` command shell never sees
+ * the alias. The `ssh -t` PTY is what lets `-i` run without job-control warnings.
  */
 const claudeDevtoolsAddScript = (remotePort, okMessage) => {
     const body = [
-        'if command -v claude >/dev/null 2>&1; then',
-        `  claude mcp remove ${DEVTOOLS_MCP_NAME} >/dev/null 2>&1 || true`,
-        `  claude mcp add ${DEVTOOLS_MCP_NAME} -- npx -y chrome-devtools-mcp@latest --browserUrl http://127.0.0.1:${remotePort}`,
-        `  echo ${shQuote(okMessage)}`,
-        'else',
-        '  echo "WARNING: claude CLI not found on the remote; skipped chrome-devtools MCP config." >&2',
-        'fi',
+        'configured=""',
+        ...forEachClaudeCli((cli) => [
+            `${cli} mcp remove ${DEVTOOLS_MCP_NAME} >/dev/null 2>&1 || true`,
+            `${cli} mcp add ${DEVTOOLS_MCP_NAME} -- npx -y chrome-devtools-mcp@latest --browserUrl http://127.0.0.1:${remotePort}`,
+            'configured=1',
+        ]),
+        `if [ -n "$configured" ]; then echo ${shQuote(okMessage)}; else echo "WARNING: claude CLI not found on the remote; skipped chrome-devtools MCP config." >&2; fi`,
     ].join('\n');
-    return [`"\${SHELL:-bash}" -lc ${shQuote(body)}`];
+    return [`"\${SHELL:-bash}" -lic ${shQuote(body)}`];
 };
 /**
  * Bash lines (run on the REMOTE, from inside the workspace dir) that register the
@@ -190,15 +216,15 @@ const claudeDevtoolsAddScript = (remotePort, okMessage) => {
  */
 const claudeRpcAddScript = (remotePort, okMessage) => {
     const body = [
-        'if command -v claude >/dev/null 2>&1; then',
-        `  claude mcp remove ${RPC_MCP_NAME} >/dev/null 2>&1 || true`,
-        `  claude mcp add --transport http ${RPC_MCP_NAME} http://127.0.0.1:${remotePort}/mcp`,
-        `  echo ${shQuote(okMessage)}`,
-        'else',
-        '  echo "WARNING: claude CLI not found on the remote; skipped local-shell MCP config." >&2',
-        'fi',
+        'configured=""',
+        ...forEachClaudeCli((cli) => [
+            `${cli} mcp remove ${RPC_MCP_NAME} >/dev/null 2>&1 || true`,
+            `${cli} mcp add --transport http ${RPC_MCP_NAME} http://127.0.0.1:${remotePort}/mcp`,
+            'configured=1',
+        ]),
+        `if [ -n "$configured" ]; then echo ${shQuote(okMessage)}; else echo "WARNING: claude CLI not found on the remote; skipped local-shell MCP config." >&2; fi`,
     ].join('\n');
-    return [`"\${SHELL:-bash}" -lc ${shQuote(body)}`];
+    return [`"\${SHELL:-bash}" -lic ${shQuote(body)}`];
 };
 /**
  * Bash lines (run on the REMOTE, from inside the workspace dir) that remove an
@@ -208,12 +234,13 @@ const claudeRpcAddScript = (remotePort, okMessage) => {
  * `claudeDevtoolsAddScript`.
  */
 const claudeMcpRemoveScript = (name) => {
-    const body = [
-        'if command -v claude >/dev/null 2>&1; then',
-        `  claude mcp remove ${name}`,
-        'fi'
-    ].join('\n');
-    return [`"\${SHELL:-bash}" -lc ${shQuote(body)}`];
+    const body = forEachClaudeCli((cli) => [
+        // Tolerate failure: if the entry was never registered (or already gone) the
+        // remove exits non-zero — that's success for us, so never let it abort the
+        // rest of the teardown (dir deletion, the other CLI, …).
+        `${cli} mcp remove ${name} >/dev/null 2>&1 || true`,
+    ]).join('\n');
+    return [`"\${SHELL:-bash}" -lic ${shQuote(body)}`];
 };
 /**
  * The bash script the remote runs for the interactive session. Mutagen already
@@ -242,9 +269,17 @@ export const buildRemoteScript = (ctx) => {
         '"${SHELL:-bash}" -l',
     ].join('\n');
 };
-/** Run the remote-side teardown over a fresh ssh connection. */
+/**
+ * Run the remote-side teardown over a fresh ssh connection. Forces a remote PTY
+ * with `-tt`: the MCP-remove step runs under an *interactive* login shell
+ * (`$SHELL -lic`, so `claude2` aliases in rc files resolve — see
+ * `claudeMcpRemoveScript`), and an interactive bash without a PTY prints
+ * "cannot set terminal process group / no job control in this shell". `-tt`
+ * forces allocation even when this cleanup runs without a local TTY, mirroring
+ * the `-t` the interactive session ssh uses.
+ */
 export const runRemoteCleanup = (target, remoteDir, opts = {}) => new Promise((resolve, reject) => {
-    const child = spawn('ssh', [target, buildCleanupScript(remoteDir, opts)], { stdio: 'inherit' });
+    const child = spawn('ssh', ['-tt', target, buildCleanupScript(remoteDir, opts)], { stdio: 'inherit' });
     child.once('error', reject);
     child.once('close', (code) => resolve(code ?? 0));
 });
@@ -287,7 +322,7 @@ export const hasMutagen = () => {
  * winner. When a `source` is given, it becomes the Mutagen alpha endpoint and
  * the mode switches to two-way-resolved (alpha always wins conflicts), so
  * `--source remote` puts the server first and `--source local` puts this
- * machine first. Labels let `workspace cleanup` find and terminate orphans.
+ * machine first. Labels let `workspace --cleanup` find and terminate orphans.
  * `ctx.ignores` (from --ignore-vcs) excludes gitignored paths from the sync so
  * each side keeps its own build artifacts and platform-specific binaries.
  */

package/oclif.manifest.json

@@ -1,5 +1,150 @@
 {
   "commands": {
+    "alt-text": {
+      "aliases": [
+        "caption"
+      ],
+      "args": {},
+      "description": "Generate alt text for a site's images with a local Ollama vision model and write it back.\n\nWalks the Webflow site asset library and (with --cms) the image fields of CMS collection items, describes every image that needs alt text, and PATCHes the description back. Images are fetched and described one at a time — a single local model gains nothing from concurrency, and Webflow rate-limits. Nothing leaves your network except the Webflow API calls.\n\nCMS writes go to STAGING, so publish the site in Webflow to make them live. Any required flag you omit is prompted for.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --webflow --api-key <key> --site-id <id> --ollama-host http://localhost:11434 --ollama-model qwen3-vl:8b",
+        "<%= config.bin %> <%= command.id %> --webflow --skip --limit 20",
+        "<%= config.bin %> <%= command.id %> --webflow --cms --select",
+        "<%= config.bin %> <%= command.id %> --webflow --cms --only products --only sku",
+        "<%= config.bin %> <%= command.id %> --webflow --output-stats ./alt-text-run.md",
+        "<%= config.bin %> <%= command.id %> --webflow --filter \"fileSize>=sizes.KB(100) && width>=100 && height>=100\"",
+        "<%= config.bin %> <%= command.id %> --webflow --filter \"type !== 'svg' && !url.includes('/icons/')\""
+      ],
+      "flags": {
+        "api-key": {
+          "dependsOn": [
+            "webflow"
+          ],
+          "description": "Webflow API token (site-scoped). Prompted for if omitted.",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cms": {
+          "dependsOn": [
+            "webflow"
+          ],
+          "description": "also add alt text to the images in CMS collection items. Off by default — only the site asset library is walked.",
+          "name": "cms",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "filter": {
+          "description": "a JavaScript expression deciding which images are worth describing, e.g. \"fileSize>=sizes.KB(100) && width>=100 && height>=100\". Available: fileSize (bytes), width, height (pixels), url, type (\"webp\", \"png\", \"jpeg\", \"svg\", …), and sizes.KB/MB/GB helpers. Images that fail it are skipped and reported separately. Evaluated after the download, since dimensions can't be known before it.",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "stop after this many images have been transcribed (counted across assets and CMS together)",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ollama-host": {
+          "description": "base URL of the Ollama server. Prompted for if omitted.",
+          "name": "ollama-host",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ollama-model": {
+          "description": "the model used to describe the images. Omit it to pick from the vision-capable models pulled on the host.",
+          "name": "ollama-model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "only": {
+          "dependsOn": [
+            "cms"
+          ],
+          "description": "only touch these CMS collections, matched case-insensitively against a collection's name or slug. Repeat the flag for more than one.",
+          "exclusive": [
+            "select"
+          ],
+          "name": "only",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "output-stats": {
+          "description": "also write the run stats to this file as Markdown: totals, a row per image (url, description, tokens, time, size), and the failures. Parent directories are created.",
+          "name": "output-stats",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "select": {
+          "dependsOn": [
+            "cms"
+          ],
+          "description": "fetch the CMS collections and pick which ones to process interactively",
+          "exclusive": [
+            "only"
+          ],
+          "name": "select",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "shopify": {
+          "description": "run against a Shopify store (not implemented yet)",
+          "exclusive": [
+            "webflow"
+          ],
+          "name": "shopify",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "site-id": {
+          "dependsOn": [
+            "webflow"
+          ],
+          "description": "Webflow site ID. Prompted for if omitted.",
+          "name": "site-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skip": {
+          "description": "leave images that already have alt text alone instead of overwriting them",
+          "name": "skip",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "webflow": {
+          "description": "run against a Webflow site",
+          "exclusive": [
+            "shopify"
+          ],
+          "name": "webflow",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "alt-text",
+      "pluginAlias": "@firenet-designs/fnd-cli",
+      "pluginName": "@firenet-designs/fnd-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "alt-text.js"
+      ]
+    },
     "backfill-project": {
       "aliases": [],
       "args": {
@@ -80,7 +225,7 @@
           "required": false
         }
       },
-      "description": "Scaffold a new client project: git on branch production, ignore files, Shopify theme pull, a Claude-generated CLAUDE.md, then a private GitHub repo under the FireNet-Designs org.\n\nRequires the claude CLI (npm install -g @anthropic-ai/claude-code) for the CLAUDE.md step.\n\nGitHub auth comes from YOUR environment — run `gh auth login` once, or export GH_TOKEN in your shell profile. This CLI never stores credentials. Override the org with FND_GH_ORG.",
+      "description": "Scaffold a new client project: git on branch production, ignore files, Shopify theme pull, a Claude-generated CLAUDE.md, then a private GitHub repo under the FireNet-Designs org with production and staging branches pushed.\n\nRequires the claude CLI (npm install -g @anthropic-ai/claude-code) for the CLAUDE.md step.\n\nGitHub auth comes from YOUR environment — run `gh auth login` once, or export GH_TOKEN in your shell profile. This CLI never stores credentials. Override the org with FND_GH_ORG.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> my-store",
@@ -183,76 +328,6 @@
         "token.js"
       ]
     },
-    "workspace:cleanup": {
-      "aliases": [],
-      "args": {},
-      "description": "Tear down a leftover workspace — use this if a `workspace` session dropped before it could clean up after itself.\n\nTerminates any Mutagen sync sessions this machine started for the directory. Pass --devtools or --rpc to also strip the matching MCP entries from the remote (only do this if the dropped session used those flags). With no --remote-dir, it targets the same path `workspace` would use for the current directory. The synced files themselves are left in place unless you pass --delete-remote-dir.",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --ssh user@host",
-        "<%= config.bin %> <%= command.id %> --ssh user@host --remote-dir /home/fnd/cole/fnd-cli",
-        "<%= config.bin %> <%= command.id %> --ssh user@host --devtools",
-        "<%= config.bin %> <%= command.id %> --ssh user@host --rpc",
-        "<%= config.bin %> <%= command.id %> --ssh user@host --delete-remote-dir"
-      ],
-      "flags": {
-        "delete-remote-dir": {
-          "description": "also delete the remote workspace directory (by default the synced files are left in place)",
-          "name": "delete-remote-dir",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "devtools": {
-          "description": "also strip the chrome-devtools MCP entry from the remote (only if the dropped session used --devtools)",
-          "name": "devtools",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "remote-base": {
-          "description": "base dir on the remote, used to derive the default remote directory path",
-          "name": "remote-base",
-          "default": "/home/fnd",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "remote-dir": {
-          "description": "exact remote directory to target (defaults to the current dir mapping)",
-          "name": "remote-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "rpc": {
-          "description": "also strip the local-shell MCP entry from the remote (only if the dropped session used --rpc)",
-          "name": "rpc",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "ssh": {
-          "description": "remote to connect to, as user@host",
-          "name": "ssh",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "workspace:cleanup",
-      "pluginAlias": "@firenet-designs/fnd-cli",
-      "pluginName": "@firenet-designs/fnd-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "workspace",
-        "cleanup.js"
-      ]
-    },
     "workspace": {
       "aliases": [],
       "args": {},
@@ -266,9 +341,16 @@
         "<%= config.bin %> <%= command.id %> --ssh user@host --devtools 9333:9222",
         "<%= config.bin %> <%= command.id %> --ssh user@host --rpc port=7777:7700",
         "<%= config.bin %> <%= command.id %> --ssh user@host --rpc port=7777:7700,profile=false,shell=zsh",
-        "<%= config.bin %> <%= command.id %> --ssh user@host --delete-remote-dir"
+        "<%= config.bin %> <%= command.id %> --ssh user@host --delete-remote-dir",
+        "<%= config.bin %> <%= command.id %> --ssh user@host --rpc 7700 --cleanup"
       ],
       "flags": {
+        "cleanup": {
+          "description": "tear down a leftover session instead of opening one — don't connect, just terminate this directory's Mutagen sync and (using whatever other flags are set) strip the remote --devtools/--rpc MCP entries and, with --delete-remote-dir, remove the remote dir. Re-run your original command with --cleanup appended after a session that dropped without cleaning up.",
+          "name": "cleanup",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "delete-remote-dir": {
           "description": "on exit, delete the remote workspace directory instead of leaving the synced copy in place",
           "name": "delete-remote-dir",
@@ -340,5 +422,5 @@
       ]
     }
   },
-  "version": "2.4.0"
+  "version": "2.6.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@firenet-designs/fnd-cli",
   "description": "A new CLI generated with oclif",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "author": "Cole Denslow",
   "contributors": [
     "Justin Schellenberg"
@@ -11,11 +11,15 @@
   },
   "bugs": "https://github.com/FireNet-Designs/fnd-cli/issues",
   "dependencies": {
+    "@inquirer/prompts": "^7.10.1",
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^5",
+    "@resvg/resvg-js": "^2.6.2",
     "chalk": "^5.6.2",
+    "ollama": "^0.6.3",
     "ora": "^9.3.0",
+    "sharp": "^0.34.5",
     "simple-git": "^3.32.2",
     "zod": "^4.4.3"
   },

package/dist/commands/workspace/cleanup.d.ts

@@ -1,14 +0,0 @@
-import { Command } from '@oclif/core';
-export default class WorkspaceCleanup extends Command {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        'delete-remote-dir': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        devtools: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'remote-base': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'remote-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        rpc: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        ssh: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/workspace/cleanup.js

@@ -1,84 +0,0 @@
-import { Command, Flags } from '@oclif/core';
-import chalk from 'chalk';
-import { basename } from 'node:path';
-import { buildContext, buildMutagenTerminateSelectorArgs, DEFAULT_MOUNT_BASE, hasMutagen, hasSshClient, parseSshTarget, runMutagen, runRemoteCleanup, slugify, } from '../../lib/workspace.js';
-export default class WorkspaceCleanup extends Command {
-    static description = 'Tear down a leftover workspace — use this if a `workspace` session dropped before it could clean up after itself.\n\nTerminates any Mutagen sync sessions this machine started for the directory. Pass --devtools or --rpc to also strip the matching MCP entries from the remote (only do this if the dropped session used those flags). With no --remote-dir, it targets the same path `workspace` would use for the current directory. The synced files themselves are left in place unless you pass --delete-remote-dir.';
-    static examples = [
-        '<%= config.bin %> <%= command.id %> --ssh user@host',
-        '<%= config.bin %> <%= command.id %> --ssh user@host --remote-dir /home/fnd/cole/fnd-cli',
-        '<%= config.bin %> <%= command.id %> --ssh user@host --devtools',
-        '<%= config.bin %> <%= command.id %> --ssh user@host --rpc',
-        '<%= config.bin %> <%= command.id %> --ssh user@host --delete-remote-dir',
-    ];
-    static flags = {
-        'delete-remote-dir': Flags.boolean({
-            default: false,
-            description: 'also delete the remote workspace directory (by default the synced files are left in place)',
-        }),
-        devtools: Flags.boolean({
-            default: false,
-            description: 'also strip the chrome-devtools MCP entry from the remote (only if the dropped session used --devtools)',
-        }),
-        'remote-base': Flags.string({
-            default: DEFAULT_MOUNT_BASE,
-            description: 'base dir on the remote, used to derive the default remote directory path',
-        }),
-        'remote-dir': Flags.string({
-            description: 'exact remote directory to target (defaults to the current dir mapping)',
-        }),
-        rpc: Flags.boolean({
-            default: false,
-            description: 'also strip the local-shell MCP entry from the remote (only if the dropped session used --rpc)',
-        }),
-        ssh: Flags.string({
-            description: 'remote to connect to, as user@host',
-            required: true,
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(WorkspaceCleanup);
-        if (!hasSshClient()) {
-            this.error('No `ssh` client found on PATH. Install OpenSSH client and try again.', { code: '1' });
-        }
-        const target = parseSshTarget(flags.ssh);
-        const target2 = `${target.user}@${target.host}`;
-        const remoteDir = flags['remote-dir'] ??
-            buildContext({ cwd: process.cwd(), remoteBase: flags['remote-base'] }).remoteDir;
-        const slug = slugify(basename(remoteDir));
-        this.log(chalk.bold('Cleaning up workspace'));
-        this.log(`  ${chalk.dim('remote:')}     ${target2}`);
-        this.log(`  ${chalk.dim('remote dir:')} ${remoteDir}`);
-        this.log('');
-        // Terminate any lingering sync sessions for this directory (a local Mutagen op).
-        if (hasMutagen()) {
-            this.log(chalk.dim('Terminating any leftover Mutagen sync sessions…'));
-            await runMutagen(buildMutagenTerminateSelectorArgs(slug)).catch(() => 1);
-        }
-        else {
-            this.log(chalk.yellow('Mutagen CLI not found on PATH — skipping sync termination.'));
-        }
-        // Strip any MCP config this workspace left on the remote (only when asked),
-        // and optionally delete the synced directory itself.
-        if (flags.devtools) {
-            this.log(chalk.dim('Removing any leftover chrome-devtools MCP config on the remote…'));
-        }
-        if (flags.rpc) {
-            this.log(chalk.dim('Removing any leftover local-shell MCP config on the remote…'));
-        }
-        if (flags['delete-remote-dir']) {
-            this.log(chalk.dim('Deleting the remote workspace directory…'));
-        }
-        const code = await runRemoteCleanup(target2, remoteDir, {
-            deleteRemoteDir: flags['delete-remote-dir'],
-            removeDevtoolsMcp: flags.devtools,
-            removeRpcMcp: flags.rpc,
-        });
-        if (code === 0) {
-            this.log(chalk.green('✓ Done.'));
-        }
-        else {
-            this.error(`Remote cleanup ssh session exited with code ${code}.`, { code: '1' });
-        }
-    }
-}