@finch.app/minitools 0.1.5 → 0.1.6

package/README.md

@@ -1,41 +1,41 @@
 # @finch.app/minitools
 
-CLI shim for installing Finch extensions to the correct location.
+CLI shim for installing Finch mini tools to the correct location.
 
 ## Usage
 
 ```bash
 # Install from npm
-npx @finch.app/minitools add @scope/finch-extension-example
+npx @finch.app/minitools add @scope/finch-mini-tool-example
 
-# Install a local extension directory
-npx @finch.app/minitools add ./my-extension
+# Install a local mini tool directory
+npx @finch.app/minitools add ./my-tool
 
 # Install from a zip file (local or URL)
-npx @finch.app/minitools add ./my-extension.zip
+npx @finch.app/minitools add ./my-tool.zip
 npx @finch.app/minitools add https://github.com/user/repo/archive/refs/heads/main.zip
 
 # Install to the current project
-npx @finch.app/minitools add @finch/extension-mcp --cwd
+npx @finch.app/minitools add @finch.app/mcp-client --cwd
 
 # Install to a specific project path
-npx @finch.app/minitools add @finch/extension-mcp --cwd /path/to/project
+npx @finch.app/minitools add @finch.app/mcp-client --cwd /path/to/project
 
 # Install globally (~/.finch/extensions/)
-npx @finch.app/minitools add @finch/extension-mcp --global
+npx @finch.app/minitools add @finch.app/mcp-client --global
 
-# List installed extensions
+# List installed mini tools (id, version, enabled/disabled, name, path)
 npx @finch.app/minitools list
 npx @finch.app/minitools list --global
 
-# Remove an extension
-npx @finch.app/minitools remove mcp
+# Remove an mini tool
+npx @finch.app/minitools remove mcp-client
 
 # Show install paths
 npx @finch.app/minitools where
 
-# Validate an extension package
-npx @finch.app/minitools doctor ./my-extension
+# Validate an mini tool package
+npx @finch.app/minitools doctor ./my-tool
 ```
 
 ## Install locations
@@ -49,24 +49,24 @@ npx @finch.app/minitools doctor ./my-extension
 
 The default workspace path is read from `~/.finch/workspace.json#finchHomeDir`.
 
-## Extension package
+## Mini tool package
 
-A Finch extension is an npm-style package with `package.json#finch`:
+A Finch mini tool is an npm-style package with `package.json#finch`:
 
 ```json
 {
-  "name": "my-extension",
+  "name": "my-tool",
   "version": "1.0.0",
   "type": "module",
   "main": "dist/index.js",
   "finch": {
     "manifestVersion": 1,
-    "id": "my-extension",
-    "displayName": "My Extension",
+    "id": "my-tool",
+    "displayName": "My Tool",
     "main": "dist/index.js",
     "activationEvents": ["onStartup"]
   }
 }
 ```
 
-`add` installs the extension but does not enable or grant permissions. Open Finch → Toolcase → Extensions to review permissions and enable it.
+`add` installs the mini tool but does not enable or grant permissions. Open Finch → Toolcase → Tools to review permissions and enable it.

package/bin/minitools.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * @finch.app/extensions — install Finch extensions to the correct location.
+ * @finch.app/minitools — install Finch extensions to the correct location.
  *
  * Zero npm dependencies. npm sources are fetched with `npm install --ignore-scripts`
  * so third-party install scripts never run during CLI install.
@@ -15,6 +15,15 @@ import { spawnSync } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
 
 const LOCK_FILE = '.plugins-lock.json';
+const LEGACY_NPM_PACKAGE_RENAMES = new Map([
+  ['@finch.app/mcp-bridge', '@finch.app/mcp-client'],
+]);
+
+function normalizeInstallSource(source) {
+  if (source?.type !== 'npm' || typeof source.package !== 'string') return source;
+  const nextPackage = LEGACY_NPM_PACKAGE_RENAMES.get(source.package);
+  return nextPackage ? { ...source, package: nextPackage } : source;
+}
 
 function finchRuntimeHome() {
   return process.env.FINCH_RUNTIME_HOME ?? join(homedir(), '.finch');
@@ -331,8 +340,10 @@ function cmdList(opts) {
     console.log(`No extensions installed in ${dir}`);
     return;
   }
+  const pluginState = normalizePluginState(readJson(pluginsStatePath(), {}));
   for (const p of plugins) {
-    console.log(`${p.info.id}\t${p.info.version}\t${p.info.displayName}\t${p.path}`);
+    const status = pluginState[p.info.id]?.enabled ? 'enabled' : 'disabled';
+    console.log(`${p.info.id}\t${p.info.version}\t${status}\t${p.info.displayName}\t${p.path}`);
   }
 }
 
@@ -451,8 +462,9 @@ function cmdDoctor(src = '.') {
   const pkg = readPackageJson(abs);
   const manifest = pkg?.finch ?? {};
   // Surface recommended manifest metadata that's missing (non-fatal).
-  const recommended = ['name', 'description', 'extensionType'];
+  const recommended = ['name', 'description'];
   const missing = recommended.filter((k) => manifest[k] == null);
+  if (manifest.miniToolType == null && manifest.extensionType == null) missing.push('miniToolType');
   if (missing.length) console.log(`  hint: manifest 建议补充字段: ${missing.join(', ')}`);
   if (manifest.permissions) {
     const p = manifest.permissions;
@@ -477,7 +489,7 @@ async function cmdUpdate(id, opts) {
   const dir = targetDir(opts);
   const target = join(dir, id);
   if (!existsSync(target)) throw new Error(`extension not found: ${id}`);
-  let source = readLock(dir)[id];
+  let source = normalizeInstallSource(readLock(dir)[id]);
   if (!source) {
     // No install record — this happens for bundled first-party extensions that
     // were deployed by copying (e.g. the MCP bridge), not via `add`. Fall back to
@@ -486,7 +498,7 @@ async function cmdUpdate(id, opts) {
     const pkg = readPackageJson(target);
     const pkgName = typeof pkg?.name === 'string' ? pkg.name.trim() : '';
     if (pkgName) {
-      source = { type: 'npm', package: pkgName };
+      source = normalizeInstallSource({ type: 'npm', package: pkgName });
     } else {
       throw new Error(`no install record for "${id}"; reinstall it with \`add\` to enable updates.`);
     }
@@ -554,7 +566,7 @@ function parseArgs(argv) {
 }
 
 function help() {
-  console.log(`npx @finch.app/extensions\n\nUsage:\n  add <npm-package|local-path|url.zip> [--global]\n  update <id> [--global]\n  list [--global]\n  remove <id> [--global]\n  enable <id>\n  disable <id>\n  where\n  doctor [path]\n\nInstall locations:\n  default     workspace.json#finchHomeDir/.finch/extensions/  (personal — default)\n  --global   ~/.finch/extensions/                              (global)\n\nThere is no project/--cwd scope — extensions only install to personal or global.\n`);
+  console.log(`npx @finch.app/minitools\n\nUsage:\n  add <npm-package|local-path|url.zip> [--global]\n  update <id> [--global]\n  list [--global]\n  remove <id> [--global]\n  enable <id>\n  disable <id>\n  where\n  doctor [path]\n\nInstall locations:\n  default     workspace.json#finchHomeDir/.finch/extensions/  (personal — default)\n  --global   ~/.finch/extensions/                              (global)\n\nThere is no project/--cwd scope — extensions only install to personal or global.\n`);
 }
 
 (async () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@finch.app/minitools",
-  "version": "0.1.5",
-  "description": "CLI shim for installing Finch extensions to the correct location.",
+  "version": "0.1.6",
+  "description": "CLI shim for installing Finch mini tools to the correct location.",
   "type": "module",
   "bin": {
     "finch-minitools": "bin/minitools.mjs"