@firenet-designs/fnd-cli 2.3.3 → 2.6.0

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,69 +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 to also strip the matching chrome-devtools MCP entry from the remote (only do this if the dropped session used --devtools). 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 --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"
-        },
-        "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": {},
@@ -254,11 +336,21 @@
         "<%= config.bin %> <%= command.id %> --ssh user@203.0.113.4",
         "<%= config.bin %> <%= command.id %> --ssh user@host --source local",
         "<%= config.bin %> <%= command.id %> --ssh user@host --remote-base /home/fnd",
+        "<%= config.bin %> <%= command.id %> --ssh user@host --ignore-vcs",
         "<%= config.bin %> <%= command.id %> --ssh user@host --devtools 9222",
         "<%= config.bin %> <%= command.id %> --ssh user@host --devtools 9333:9222",
-        "<%= config.bin %> <%= command.id %> --ssh user@host --delete-remote-dir"
+        "<%= 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 --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",
@@ -272,6 +364,12 @@
           "multiple": false,
           "type": "option"
         },
+        "ignore-vcs": {
+          "description": "don't sync paths matched by the project's .gitignore files (node_modules, build output, …) so each side keeps its own platform-specific artifacts. Every .gitignore in the tree is honoured relative to its directory, like git does. The .git directory itself still syncs, so the remote stays a working repo.",
+          "name": "ignore-vcs",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "remote-base": {
           "description": "base dir on the remote; the workspace lands at <base>/<local-user>/<dir-name>",
           "name": "remote-base",
@@ -280,6 +378,13 @@
           "multiple": false,
           "type": "option"
         },
+        "rpc": {
+          "description": "expose a run_local_command MCP tool to Claude on the remote that executes commands back on THIS machine (the one running fnd workspace). Value is port=<port|remote:local>[,profile=<true|1|false|0>][,shell=<bash|batch|powershell|sh|zsh>] — port opens a reverse tunnel (ssh -R <remote>:localhost:<local>) to a command server started here; shell defaults to the shell fnd workspace was called from; profile (default true) controls whether the shell loads its startup files — with it on, POSIX shells run interactively (-i) so rc files like ~/.bashrc or ~/.zshrc are sourced and tools such as nvm work.",
+          "name": "rpc",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "source": {
           "description": "which side wins on conflict: \"remote\" = this server (where the workspace shell runs), \"local\" = the machine you ran fnd workspace from. Omit to flag conflicts instead of auto-resolving them.",
           "name": "source",
@@ -317,5 +422,5 @@
       ]
     }
   },
-  "version": "2.3.3"
+  "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.3.3",
+  "version": "2.6.0",
   "author": "Cole Denslow",
   "contributors": [
     "Justin Schellenberg"
@@ -11,12 +11,17 @@
   },
   "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",
-    "simple-git": "^3.32.2"
+    "sharp": "^0.34.5",
+    "simple-git": "^3.32.2",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@eslint/compat": "^1",
@@ -91,7 +96,7 @@
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "npm run lint",
     "prepack": "oclif manifest && oclif readme",
-    "version": "oclif readme && git add README.md",
+    "version": "oclif readme",
     "prerelease": "npm run build && npm run prepack",
     "release": "npm run build && npm run prepack && npm publish"
   },

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

@@ -1,13 +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>;
-        ssh: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    run(): Promise<void>;
-}

package/dist/commands/workspace/cleanup.js

@@ -1,75 +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 to also strip the matching chrome-devtools MCP entry from the remote (only do this if the dropped session used --devtools). 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 --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)',
-        }),
-        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 chrome-devtools 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['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,
-        });
-        if (code === 0) {
-            this.log(chalk.green('✓ Done.'));
-        }
-        else {
-            this.error(`Remote cleanup ssh session exited with code ${code}.`, { code: '1' });
-        }
-    }
-}