@yanglaofish/fishtools 0.3.0 → 0.5.0

package/node_modules/acorn/dist/bin.js

@@ -0,0 +1,90 @@
+'use strict';
+
+var path = require('path');
+var fs = require('fs');
+var acorn = require('./acorn.js');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var acorn__namespace = /*#__PURE__*/_interopNamespaceDefault(acorn);
+
+var inputFilePaths = [], forceFileName = false, fileMode = false, silent = false, compact = false, tokenize = false;
+var options = {};
+
+function help(status) {
+  var print = (status === 0) ? console.log : console.error;
+  print("usage: " + path.basename(process.argv[1]) + " [--ecma3|--ecma5|--ecma6|--ecma7|--ecma8|--ecma9|...|--ecma2015|--ecma2016|--ecma2017|--ecma2018|...]");
+  print("        [--tokenize] [--locations] [--allow-hash-bang] [--allow-await-outside-function] [--compact] [--silent] [--module] [--help] [--] [<infile>...]");
+  process.exit(status);
+}
+
+for (var i = 2; i < process.argv.length; ++i) {
+  var arg = process.argv[i];
+  if (arg[0] !== "-" || arg === "-") { inputFilePaths.push(arg); }
+  else if (arg === "--") {
+    inputFilePaths.push.apply(inputFilePaths, process.argv.slice(i + 1));
+    forceFileName = true;
+    break
+  } else if (arg === "--locations") { options.locations = true; }
+  else if (arg === "--allow-hash-bang") { options.allowHashBang = true; }
+  else if (arg === "--allow-await-outside-function") { options.allowAwaitOutsideFunction = true; }
+  else if (arg === "--silent") { silent = true; }
+  else if (arg === "--compact") { compact = true; }
+  else if (arg === "--help") { help(0); }
+  else if (arg === "--tokenize") { tokenize = true; }
+  else if (arg === "--module") { options.sourceType = "module"; }
+  else {
+    var match = arg.match(/^--ecma(\d+)$/);
+    if (match)
+      { options.ecmaVersion = +match[1]; }
+    else
+      { help(1); }
+  }
+}
+
+function run(codeList) {
+  var result = [], fileIdx = 0;
+  try {
+    codeList.forEach(function (code, idx) {
+      fileIdx = idx;
+      if (!tokenize) {
+        result = acorn__namespace.parse(code, options);
+        options.program = result;
+      } else {
+        var tokenizer = acorn__namespace.tokenizer(code, options), token;
+        do {
+          token = tokenizer.getToken();
+          result.push(token);
+        } while (token.type !== acorn__namespace.tokTypes.eof)
+      }
+    });
+  } catch (e) {
+    console.error(fileMode ? e.message.replace(/\(\d+:\d+\)$/, function (m) { return m.slice(0, 1) + inputFilePaths[fileIdx] + " " + m.slice(1); }) : e.message);
+    process.exit(1);
+  }
+  if (!silent) { console.log(JSON.stringify(result, function (_, value) { return typeof value === "bigint" ? null : value; }, compact ? null : 2)); }
+}
+
+if (fileMode = inputFilePaths.length && (forceFileName || !inputFilePaths.includes("-") || inputFilePaths.length !== 1)) {
+  run(inputFilePaths.map(function (path) { return fs.readFileSync(path, "utf8"); }));
+} else {
+  var code = "";
+  process.stdin.resume();
+  process.stdin.on("data", function (chunk) { return code += chunk; });
+  process.stdin.on("end", function () { return run([code]); });
+}

package/node_modules/acorn/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "acorn",
+  "description": "ECMAScript parser",
+  "homepage": "https://github.com/acornjs/acorn",
+  "main": "dist/acorn.js",
+  "types": "dist/acorn.d.ts",
+  "module": "dist/acorn.mjs",
+  "exports": {
+    ".": [
+      {
+        "import": "./dist/acorn.mjs",
+        "require": "./dist/acorn.js",
+        "default": "./dist/acorn.js"
+      },
+      "./dist/acorn.js"
+    ],
+    "./package.json": "./package.json"
+  },
+  "version": "8.19.0",
+  "engines": {
+    "node": ">=0.4.0"
+  },
+  "maintainers": [
+    {
+      "name": "Marijn Haverbeke",
+      "email": "marijn@haverbeke.berlin",
+      "web": "https://marijnhaverbeke.nl"
+    },
+    {
+      "name": "Ingvar Stepanyan",
+      "email": "me@rreverser.com",
+      "web": "https://rreverser.com/"
+    },
+    {
+      "name": "Adrian Heine",
+      "web": "http://adrianheine.de"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/acornjs/acorn.git"
+  },
+  "license": "MIT",
+  "scripts": {
+    "prepare": "cd ..; npm run build:main"
+  },
+  "bin": {
+    "acorn": "bin/acorn"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yanglaofish/fishtools",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Fishtools 插件式工作流工作台",
   "type": "module",
   "license": "MIT",
@@ -27,67 +27,20 @@
     "manual"
   ],
   "dependencies": {
-    "@mytools/core": "0.1.0",
-    "@mariozechner/pi-tui": "0.50.0",
-    "@types/mime-types": "2.1.4",
-    "chalk": "5.6.2",
-    "get-east-asian-width": "1.7.0",
-    "marked": "15.0.12",
-    "mime-types": "3.0.2",
-    "mime-db": "1.54.0",
+    "@mytools/fst-cli": "0.1.0",
     "@mytools/sdk": "0.1.0",
     "ajv": "8.20.0",
     "fast-deep-equal": "3.1.3",
     "fast-uri": "3.1.8",
     "json-schema-traverse": "1.0.0",
     "require-from-string": "2.0.2",
-    "commander": "14.0.3",
-    "cordis": "3.18.1",
-    "@cordisjs/core": "3.18.1",
-    "cosmokit": "1.8.1",
-    "@cordisjs/loader": "0.13.1",
-    "dotenv": "16.6.1",
-    "js-yaml": "4.3.2",
-    "argparse": "2.0.1",
-    "@cordisjs/logger": "0.3.3",
-    "reggol": "1.7.1",
-    "object-inspect": "1.13.4",
-    "supports-color": "8.1.1",
-    "has-flag": "4.0.0",
-    "@cordisjs/schema": "0.1.1",
-    "schemastery": "3.18.0",
-    "@standard-schema/spec": "1.1.0",
-    "@cordisjs/timer": "0.3.2",
-    "cac": "6.7.14",
-    "kleur": "4.1.5",
-    "execa": "10.1.0",
-    "@sindresorhus/merge-streams": "4.0.0",
-    "figures": "6.1.0",
-    "is-unicode-supported": "2.1.0",
-    "get-stream": "9.0.1",
-    "@sec-ant/readable-stream": "0.4.1",
-    "is-stream": "4.0.1",
-    "human-signals": "8.0.1",
-    "is-plain-obj": "4.1.0",
-    "npm-run-path": "6.0.0",
-    "path-key": "4.0.0",
-    "unicorn-magic": "0.3.0",
-    "pretty-ms": "9.3.1",
-    "parse-ms": "4.0.0",
-    "signal-exit": "4.1.0",
-    "strip-final-newline": "4.0.0",
-    "which-command": "0.1.0",
-    "yoctocolors": "2.2.0",
-    "semver": "7.7.4",
-    "tree-kill": "1.2.2",
-    "which": "7.0.0",
-    "isexe": "4.0.0",
-    "yaml": "2.9.1",
+    "@mytools/core": "0.1.0",
     "@mytools/pack": "0.1.0",
     "@npmcli/arborist": "10.0.3",
     "@gar/promise-retry": "1.0.3",
     "@isaacs/string-locale-compare": "1.1.0",
     "@npmcli/fs": "6.0.0",
+    "semver": "7.7.4",
     "@npmcli/installed-package-contents": "5.0.0",
     "npm-bundled": "6.0.0",
     "npm-normalize-package-bin": "6.0.0",
@@ -96,6 +49,8 @@
     "@npmcli/package-json": "8.0.0",
     "@npmcli/git": "8.0.0",
     "@npmcli/promise-spawn": "10.0.0",
+    "which": "7.0.0",
+    "isexe": "4.0.0",
     "ini": "7.0.0",
     "lru-cache": "11.5.3",
     "npm-pick-manifest": "12.0.0",
@@ -182,6 +137,7 @@
     "cmd-shim": "9.0.2",
     "read-cmd-shim": "7.0.1",
     "write-file-atomic": "8.0.0",
+    "signal-exit": "4.1.0",
     "common-ancestor-path": "2.0.0",
     "diff": "8.0.4",
     "json-stringify-nice": "1.1.4",
@@ -196,6 +152,7 @@
     "archiver": "8.0.0",
     "async": "3.2.6",
     "buffer-crc32": "1.0.0",
+    "is-stream": "4.0.1",
     "lazystream": "1.0.1",
     "readable-stream": "2.3.8",
     "core-util-is": "1.0.3",
@@ -229,6 +186,57 @@
     "compress-commons": "7.0.1",
     "crc-32": "1.2.2",
     "crc32-stream": "7.0.1",
+    "yaml": "2.9.1",
+    "@mytools/fst-platform": "0.1.0",
+    "execa": "10.1.0",
+    "@sindresorhus/merge-streams": "4.0.0",
+    "figures": "6.1.0",
+    "is-unicode-supported": "2.1.0",
+    "get-stream": "9.0.1",
+    "@sec-ant/readable-stream": "0.4.1",
+    "human-signals": "8.0.1",
+    "is-plain-obj": "4.1.0",
+    "npm-run-path": "6.0.0",
+    "path-key": "4.0.0",
+    "unicorn-magic": "0.3.0",
+    "pretty-ms": "9.3.1",
+    "parse-ms": "4.0.0",
+    "strip-final-newline": "4.0.0",
+    "which-command": "0.1.0",
+    "yoctocolors": "2.2.0",
+    "tree-kill": "1.2.2",
+    "@mytools/fst-devtools": "0.1.0",
+    "@mytools/fst-plugin": "0.1.0",
+    "cordis": "3.18.1",
+    "@cordisjs/core": "3.18.1",
+    "cosmokit": "1.8.1",
+    "@cordisjs/loader": "0.13.1",
+    "dotenv": "16.6.1",
+    "js-yaml": "4.3.2",
+    "argparse": "2.0.1",
+    "@cordisjs/logger": "0.3.3",
+    "reggol": "1.7.1",
+    "object-inspect": "1.13.4",
+    "supports-color": "8.1.1",
+    "has-flag": "4.0.0",
+    "@cordisjs/schema": "0.1.1",
+    "schemastery": "3.18.0",
+    "@standard-schema/spec": "1.1.0",
+    "@cordisjs/timer": "0.3.2",
+    "cac": "6.7.14",
+    "kleur": "4.1.5",
+    "acorn": "8.19.0",
+    "@mytools/fst-logs": "0.1.0",
+    "@mytools/fst-workflow": "0.1.0",
+    "@mytools/fst-workspace": "0.1.0",
+    "@mariozechner/pi-tui": "0.50.0",
+    "@types/mime-types": "2.1.4",
+    "chalk": "5.6.2",
+    "get-east-asian-width": "1.7.0",
+    "marked": "15.0.12",
+    "mime-types": "3.0.2",
+    "mime-db": "1.54.0",
+    "commander": "14.0.3",
     "@mytools/environment": "0.1.0",
     "@mytools/examples": "0.1.0",
     "@mytools/web": "0.1.0",
@@ -289,67 +297,20 @@
     "vary": "1.1.2"
   },
   "bundleDependencies": [
-    "@mytools/core",
-    "@mariozechner/pi-tui",
-    "@types/mime-types",
-    "chalk",
-    "get-east-asian-width",
-    "marked",
-    "mime-types",
-    "mime-db",
+    "@mytools/fst-cli",
     "@mytools/sdk",
     "ajv",
     "fast-deep-equal",
     "fast-uri",
     "json-schema-traverse",
     "require-from-string",
-    "commander",
-    "cordis",
-    "@cordisjs/core",
-    "cosmokit",
-    "@cordisjs/loader",
-    "dotenv",
-    "js-yaml",
-    "argparse",
-    "@cordisjs/logger",
-    "reggol",
-    "object-inspect",
-    "supports-color",
-    "has-flag",
-    "@cordisjs/schema",
-    "schemastery",
-    "@standard-schema/spec",
-    "@cordisjs/timer",
-    "cac",
-    "kleur",
-    "execa",
-    "@sindresorhus/merge-streams",
-    "figures",
-    "is-unicode-supported",
-    "get-stream",
-    "@sec-ant/readable-stream",
-    "is-stream",
-    "human-signals",
-    "is-plain-obj",
-    "npm-run-path",
-    "path-key",
-    "unicorn-magic",
-    "pretty-ms",
-    "parse-ms",
-    "signal-exit",
-    "strip-final-newline",
-    "which-command",
-    "yoctocolors",
-    "semver",
-    "tree-kill",
-    "which",
-    "isexe",
-    "yaml",
+    "@mytools/core",
     "@mytools/pack",
     "@npmcli/arborist",
     "@gar/promise-retry",
     "@isaacs/string-locale-compare",
     "@npmcli/fs",
+    "semver",
     "@npmcli/installed-package-contents",
     "npm-bundled",
     "npm-normalize-package-bin",
@@ -358,6 +319,8 @@
     "@npmcli/package-json",
     "@npmcli/git",
     "@npmcli/promise-spawn",
+    "which",
+    "isexe",
     "ini",
     "lru-cache",
     "npm-pick-manifest",
@@ -444,6 +407,7 @@
     "cmd-shim",
     "read-cmd-shim",
     "write-file-atomic",
+    "signal-exit",
     "common-ancestor-path",
     "diff",
     "json-stringify-nice",
@@ -458,6 +422,7 @@
     "archiver",
     "async",
     "buffer-crc32",
+    "is-stream",
     "lazystream",
     "readable-stream",
     "core-util-is",
@@ -491,6 +456,57 @@
     "compress-commons",
     "crc-32",
     "crc32-stream",
+    "yaml",
+    "@mytools/fst-platform",
+    "execa",
+    "@sindresorhus/merge-streams",
+    "figures",
+    "is-unicode-supported",
+    "get-stream",
+    "@sec-ant/readable-stream",
+    "human-signals",
+    "is-plain-obj",
+    "npm-run-path",
+    "path-key",
+    "unicorn-magic",
+    "pretty-ms",
+    "parse-ms",
+    "strip-final-newline",
+    "which-command",
+    "yoctocolors",
+    "tree-kill",
+    "@mytools/fst-devtools",
+    "@mytools/fst-plugin",
+    "cordis",
+    "@cordisjs/core",
+    "cosmokit",
+    "@cordisjs/loader",
+    "dotenv",
+    "js-yaml",
+    "argparse",
+    "@cordisjs/logger",
+    "reggol",
+    "object-inspect",
+    "supports-color",
+    "has-flag",
+    "@cordisjs/schema",
+    "schemastery",
+    "@standard-schema/spec",
+    "@cordisjs/timer",
+    "cac",
+    "kleur",
+    "acorn",
+    "@mytools/fst-logs",
+    "@mytools/fst-workflow",
+    "@mytools/fst-workspace",
+    "@mariozechner/pi-tui",
+    "@types/mime-types",
+    "chalk",
+    "get-east-asian-width",
+    "marked",
+    "mime-types",
+    "mime-db",
+    "commander",
     "@mytools/environment",
     "@mytools/examples",
     "@mytools/web",

package/manual/packages/core/src/host.js

@@ -1,124 +0,0 @@
-import { Context } from 'cordis';
-import semver from 'semver';
-import { SDK_VERSION, FlowError } from '@mytools/sdk';
-import { validate, emptyObject } from './validation.js';
-import {validateDeclarations,validateCommands} from './contracts.js';
-import {resolveEnvironments} from './environments.js';
-import {createRuntime} from './runtime.js';
-import {pluginError} from './diagnostics.js';
-
-export async function createHost({ plugins = [], config = {}, services = {}, environmentOverrides={},runtimeEnabled=true } = {}) {
-  const ctx = new Context();
-  const actions = new Map();
-  const definitions = new Map();
-  const extensions = new Map();
-  const serviceNames = new Set();
-  const commandNames=new Set(),commands=new Map();
-  function bindContext(context){
-    const bound={...services,...context},execute=bound.runProcess;
-    // 面向用户的输出与诊断日志共用持久化通道，只区分默认可见性。
-    bound.print=(message,data)=>Promise.resolve(bound.log?.(message,data,{audience:'user'}));
-    if(typeof execute==='function')bound.runProcess=(file,args,options={})=>{
-      const signal=context.signal&&options.signal?AbortSignal.any([context.signal,options.signal]):context.signal??options.signal;
-      return execute(file,args,{...options,signal,onOutput:async({stream,message})=>{
-        await bound.log?.(message,undefined,{stream});
-        await options.onOutput?.({stream,message});
-      }});
-    };
-    return bound;
-  }
-  for (const entry of plugins) {
-    const plugin = entry.plugin ?? entry;
-    validateDeclarations(plugin);validateCommands(plugin,commandNames);
-    if (!plugin.id || definitions.has(plugin.id)) throw new FlowError(`插件标识缺失或重复：${plugin.id}`, {code:'VALIDATION'});
-    if (!semver.satisfies(SDK_VERSION, plugin.sdk ?? '^0.1.0')) throw new FlowError(`插件 ${plugin.id} 与 SDK ${SDK_VERSION} 不兼容`, {code:'VALIDATION'});
-    for(const [name,action] of Object.entries(plugin.actions??{})){
-      if(typeof action?.run!=='function')throw new FlowError(`动作 ${plugin.id}:${name} 缺少执行函数`);
-    }
-    for(const [name,extension] of Object.entries(plugin.services??{})){
-      if(serviceNames.has(name))throw new FlowError(`服务重复：${name}`);
-      if(typeof extension!=='function')throw new FlowError(`服务 ${name} 缺少执行函数`);
-      serviceNames.add(name);
-    }
-    definitions.set(plugin.id, {...plugin, root:entry.root});
-  }
-  const settingsById=new Map();
-  for (const plugin of definitions.values()) {
-    for (const [id, range] of Object.entries(plugin.dependencies ?? {})) {
-      if (!definitions.has(id) || !semver.satisfies(definitions.get(id).version,range)) throw new FlowError(`插件 ${plugin.id} 缺少兼容依赖 ${id}@${range}`,{code:'VALIDATION'});
-    }
-    const settings = validate(plugin.config, config[plugin.id] ?? {}, `${plugin.id} 配置`);
-    settingsById.set(plugin.id,settings);
-  }
-  const runtime=createRuntime(ctx,definitions,{enabled:runtimeEnabled});
-  try{
-  for (const plugin of definitions.values()) {
-    const settings=settingsById.get(plugin.id);
-    runtime.register(plugin,settings,scope=>{
-    for(const [name,command] of Object.entries(plugin.commands??{})){
-      const action=command.action?plugin.actions[command.action]:command;
-      commands.set(name,{...command,name,plugin:plugin.id,input:action.input,output:action.output,description:command.description??action.description??action.title??name,config:settings});
-      scope.on('dispose',()=>commands.delete(name));
-    }
-      for (const [name, action] of Object.entries(plugin.actions ?? {})) {
-        const id = `${plugin.id}:${name}`;
-        if (typeof action.run !== 'function') throw new FlowError(`动作 ${id} 缺少执行函数`);
-        actions.set(id, {...action, id, plugin:plugin.id, config:settings, root:plugin.root});
-        scope.on('dispose', () => actions.delete(id));
-      }
-      for (const [name, extension] of Object.entries(plugin.services ?? {})) {
-        if (extensions.has(name)) throw new FlowError(`服务重复：${name}`);
-        extensions.set(name, {run:extension,plugin:plugin.id});
-        scope.on('dispose',()=>extensions.delete(name));
-      }
-    });
-  }
-  await runtime.start();
-  }catch(error){
-    try{await runtime.close();}catch(cleanup){if(cleanup.message!==error.message)throw new AggregateError([error,cleanup],`${error.message}；${cleanup.message}`);}
-    throw error;
-  }
-  return {
-    definitions, actions,
-    hasRuntime:runtime.hasRuntime,
-    runtimeStatus:()=>runtime.status(),
-    commands(){return [...commands.values()].map(({run,config,...metadata})=>structuredClone(metadata));},
-    async invokeCommand(name,input,context={}){
-      runtime.assertOpen();
-      const command=commands.get(name);if(!command)throw new FlowError(`命令不存在：/${name}`);
-      if(command.action)return this.invoke(`${command.plugin}:${command.action}`,input,context);
-      if(!context.ui)throw new FlowError(`交互命令 /${name} 需要在 TUI 中调用`);
-      const plugin=definitions.get(command.plugin);
-      try{
-      const getService=runtime.bindServices(plugin.id);
-      context.signal?.throwIfAborted();
-      const result=await command.run(validate(command.input??emptyObject,input,`/${name} 输入`),{...bindContext(context),getService,config:command.config,resourceDir:plugin.root,environments:resolveEnvironments(plugin,undefined,environmentOverrides[plugin.id])});
-      context.signal?.throwIfAborted();
-      return validate(command.output,JSON.parse(JSON.stringify(result??{})),`/${name} 输出`);
-      }catch(cause){throw pluginError(cause,{plugin:plugin.id,command:`/${name}`});}
-    },
-    catalog() { return [...actions.values()].map(({run,config,root,...metadata})=>structuredClone(metadata)); },
-    async invoke(id, input, context = {}) {
-      runtime.assertOpen();
-      const action = actions.get(id);
-      if (!action) throw new FlowError(`动作不存在：${id}`, {code:'VALIDATION'});
-      try{
-      const getService=runtime.bindServices(action.plugin);
-      context.signal?.throwIfAborted();
-      const result = await action.run(validate(action.input ?? emptyObject,input,`${id} 输入`), {...bindContext(context),getService, config:action.config, resourceDir:action.root,environments:resolveEnvironments(definitions.get(action.plugin),action,environmentOverrides[action.plugin])});
-      context.signal?.throwIfAborted();
-      // 通过 JSON 边界验证返回值，避免函数、循环引用等进入工作流状态。
-      const encoded = JSON.stringify(result);
-      if (encoded === undefined) throw new FlowError(`${id} 输出必须可 JSON 序列化`);
-      return validate(action.output, JSON.parse(encoded),`${id} 输出`);
-      }catch(cause){throw pluginError(cause,{plugin:action.plugin,action:id});}
-    },
-    async service(name,options) {
-      runtime.assertOpen();
-      if (!extensions.has(name)) throw new FlowError(`未安装提供 ${name} 的插件`);
-      const extension=extensions.get(name);runtime.assertActive(extension.plugin);
-      return extension.run(services,options);
-    },
-    close:()=>runtime.close(),
-  };
-}

package/node_modules/@mytools/core/bin/fst.js

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-import { Command } from 'commander';
-import { readFile, access } from 'node:fs/promises';
-import path from 'node:path';
-import { createApplication } from '../src/application.js';
-import { verifyBundle } from '../src/bundle.js';
-import { resolveProject, initializeProject } from '../src/project.js';
-import {waitForCliRun,cliRunResult} from '../src/cli-run.js';
-import {VERSION} from '../src/version.js';
-import {listDocumentation,readDocumentation,findDocumentationRoot,exportDocumentation} from '../src/documentation.js';
-
-const program=new Command().name('fst').description('Fishtools · 插件式工作流工作台').version(VERSION);
-program.option('--maintenance','维护模式：不启动有状态服务插件');
-program.option('--project <directory>','项目目录（默认当前项目或用户工作区）').option('--workspace <directory>','便携包的可写工作区').option('--output <directory>','日志与结果目录').option('--config <file>','插件配置覆盖文件').option('--host <host>','Web 监听地址','127.0.0.1').option('--port <port>','Web 监听端口','8765');
-async function app(){const o=program.opts();return createApplication({projectDir:await resolveProject(o.project,o.workspace),outputDir:o.output,maintenance:!!o.maintenance,config:o.config?JSON.parse(await readFile(o.config,'utf8')):{}});}
-async function use(fn){const a=await app();try{return await fn(a);}finally{await a.close();}}
-program.command('init [directory]').description('创建项目，保留已有配置与工作流').action(async directory=>console.log(`Fishtools 项目：${await initializeProject(path.resolve(directory??process.cwd()))}`));
-program.command('docs [topic]').description('阅读或导出随安装提供的离线文档').option('--path','只打印文档路径').option('--export <directory>','导出完整资料到新目录').action(async(topic,options)=>{
-  if(options.export){if(topic||options.path)throw new Error('--export 不可与文档主题或 --path 同用');console.log(await exportDocumentation(options.export));return;}
-  if(topic){const document=await readDocumentation(topic);console.log(options.path?document.path:document.text);return;}
-  if(options.path){console.log(await findDocumentationRoot());return;}
-  console.log((await listDocumentation()).map(document=>`${document.id}\t${document.title}`).join('\n'));
-  console.log('\nfst docs <主题> 阅读正文；fst docs <主题> --path 查看路径；fst docs --export <新目录> 导出全部资料');
-});
-const workflow=program.command('workflow').description('查看和检查工作流');
-workflow.command('list').action(()=>use(async a=>console.log(JSON.stringify(await a.listWorkflows(),null,2))));
-workflow.command('check <id>').action(id=>use(async a=>{await a.checkWorkflow(id);console.log('工作流校验通过');}));
-program.command('run <id>').option('--input <file>','JSON 输入文件').action((id,o)=>use(async a=>{
-  const run=await a.startRun(id,o.input?JSON.parse(await readFile(o.input,'utf8')):{});
-  const result=cliRunResult(await waitForCliRun(a,run));console.log(JSON.stringify(result.value,null,2));
-  process.exitCode=result.exitCode;
-}));
-const plugin=program.command('plugin').description('管理插件');
-plugin.command('list').action(()=>use(a=>console.log(JSON.stringify(a.listPlugins(),null,2))));
-plugin.command('add <source>').action(source=>use(async a=>console.log(JSON.stringify(await a.installPlugin(source),null,2))));
-plugin.command('remove <name>').action(name=>use(async a=>console.log(JSON.stringify(await a.removePlugin(name),null,2))));
-const packOptions=command=>command.requiredOption('--target <target>','win32-x64 或 linux-x64-glibc').option('--out <directory>','导出目录','dist').option('--read-only','导出只读精简运行包').option('--environments <file>','环境来源覆盖 JSON').option('--plan','只查看打包资源计划');
-async function pack(a,entries,o,portable=false){
-  const options={entries,target:o.target,outDir:o.out,includeWeb:!!o.web,readOnly:!!o.readOnly,portable,environments:o.environments?JSON.parse(await readFile(o.environments,'utf8')):{}};
-  console.log(JSON.stringify(await (o.plan?a.packPlan(options):a.pack(options)),null,2));
-}
-packOptions(program.command('pack <entries...>')).option('--web','包含 Web 界面').action((entries,o)=>use(a=>pack(a,entries,o)));
-packOptions(program.command('portable').description('导出完整便携工具、当前全部流程和插件')).option('--no-web','不额外携带 Web').action(o=>use(a=>pack(a,[],o,true)));
-program.command('command [name]').description('列出插件命令或执行动作命令').option('--input <file>','JSON 输入').action((name,o)=>use(async a=>{
-  if(!name){console.log(JSON.stringify(a.listCommands(),null,2));return;}
-  const run=await a.startCommand(name,o.input?JSON.parse(await readFile(o.input,'utf8')):{});
-  const result=cliRunResult(await waitForCliRun(a,run));console.log(JSON.stringify(result.value,null,2));process.exitCode=result.exitCode;
-}));
-program.command('configure <plugin> <file>').description('从 JSON 保存插件配置').action((id,file)=>use(async a=>{await a.configurePlugin(id,JSON.parse(await readFile(file,'utf8')));console.log('插件配置已保存');}));
-async function web(o){
-  const a=await app();let server;
-  try{server=await a.startWeb({host:o.host,port:Number(o.port)});}catch(error){await a.close();throw error;}
-  console.log(`Fishtools：${server.url}`);
-  const stop=async()=>{await server.close();await a.close();};process.once('SIGINT',stop);process.once('SIGTERM',stop);
-}
-program.action(async()=>{
-  if(!process.stdin.isTTY||!process.stdout.isTTY){program.outputHelp();return;}
-  const {startTerminal}=await import('../src/terminal/session.js');
-  await use(a=>startTerminal(a,{webOptions:{host:program.opts().host,port:Number(program.opts().port)}}));
-});
-program.command('web').description('启动可选的 Fishtools Web 工作台').option('--host <host>','监听地址').option('--port <port>','监听端口').action(o=>web({...program.opts(),...o}));
-program.command('doctor').action(()=>use(async a=>{
-  let integrity;
-  const bundleRoot=a.project.baseBundle?.root??a.projectDir;
-  try{await access(path.join(bundleRoot,'manifest.json'));integrity=await verifyBundle(bundleRoot);}
-  catch(error){if(error.code!=='ENOENT')throw error;}
-  console.log(JSON.stringify({node:process.version,platform:process.platform,arch:process.arch,plugins:a.listPlugins(),integrity},null,2));
-  if(integrity&&!integrity.ok)process.exitCode=1;
-}));
-try {await program.parseAsync();}catch(error){console.error(error.message);process.exitCode=error.code==='CANCELLED'?130:2;}