ims-flow-dashboard 1.2.1 → 1.2.2

package/README.md

@@ -53,11 +53,14 @@ imsflow --open
 
 | 命令 | 说明 |
 |---|---|
-| `imsflow` | 生成 dashboard.html |
+| `imsflow` | 生成 dashboard.html（零配置时自动转服务模式） |
 | `imsflow --open` | 生成并打开浏览器 |
 | `imsflow serve` | 启动本地服务（默认端口 17771） |
 | `imsflow serve --port=17772` | 指定端口 |
 | `imsflow <过滤词>` | 按名称/路径模糊匹配工作区根 |
+| `imsflow --version` / `-v` | 查看版本（本地 + npm 最新比对） |
+| `imsflow --update` | 更新到 npm 最新版（源码模式给出 git pull 指引） |
+| `imsflow --uninstall` | 卸载命令（npm 模式 `npm uninstall -g`；源码模式清理 shell profile；`~/.imsflow` 配置保留） |
 | `imsflow --help` | 帮助 |
 
 ## 配置

package/bin/imsflow.mjs

@@ -2,21 +2,48 @@
 import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import * as path from 'node:path';
+import * as fs from 'node:fs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const scanScript = path.join(__dirname, '..', 'scan.mjs');
+const pkgRoot = path.join(__dirname, '..');
+const scanScript = path.join(pkgRoot, 'scan.mjs');
 const nodeExe = process.execPath;
 const args = process.argv.slice(2);
 
-if (args.includes('--help') || args.includes('-h')) {
-  console.log(`imsflow — IMS Flow 控制台
+// 本地版本（package.json 随包分发, 永远和代码同步）
+const VERSION = JSON.parse(fs.readFileSync(path.join(pkgRoot, 'package.json'), 'utf8')).version;
+
+// npm 全局安装 = 包体在 node_modules 里; 否则是源码 clone + install.mjs 的 profile 模式
+const isNpmInstall = __dirname.includes(`node_modules${path.sep}`);
+
+// Windows 下 npm 是 npm.cmd, 必须走 shell 解析
+const npm = (npmArgs, opts = {}) => {
+  const child = spawn('npm', npmArgs, { stdio: 'inherit', shell: true, ...opts });
+  child.on('exit', (code) => process.exit(code ?? 0));
+};
+
+// 查 npm 远程版本（离线/未发布时静默, 不影响本地版本显示）
+function remoteVersion() {
+  return new Promise((resolve) => {
+    const child = spawn('npm', ['view', 'ims-flow-dashboard', 'version'], { shell: true });
+    let out = '';
+    child.stdout.on('data', (c) => { out += c; });
+    child.on('error', () => resolve(null));
+    child.on('exit', () => resolve(out.trim() || null));
+    setTimeout(() => { try { child.kill(); } catch {} resolve(null); }, 8000); // 网络差时别卡住
+  });
+}
+
+const HELP = `imsflow — IMS Flow 控制台 (v${VERSION})
 
 用法:
   imsflow [serve] [过滤词] [--open] [--port=N]
+  imsflow --version | --update | --uninstall
   imsflow --help
 
 模式:
   快照模式 (默认)   生成单文件 dashboard.html，--open 自动打开浏览器
+                    零配置时自动转服务模式（页面「工作区」面板里添加扫描根）
   服务模式 (serve)  本地服务，页面内「重新扫描」按钮生效
                     imsflow serve [--port=17771]
 
@@ -25,13 +52,62 @@ if (args.includes('--help') || args.includes('-h')) {
   <过滤词>           按名称/路径模糊匹配工作区根
   --open            生成后自动打开浏览器
   --port=<N>        serve 模式端口（默认 17771）
+  --version, -v     显示版本（本地 + npm 最新）
+  --update          更新到 npm 最新版（${isNpmInstall ? 'npm 安装模式' : '当前为源码模式, 见提示'}）
+  --uninstall       卸载 imsflow 命令并清理
   --help, -h        显示本帮助
 
 配置:
   projects.json     注册要扫描的工作区根路径（参考 projects.example.json）
-`);
+                    也可在页面顶栏「工作区」面板里添加, 自动写入配置
+`;
+
+// ---------- 子命令分发 ----------
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(HELP);
+  process.exit(0);
+}
+
+if (args.includes('--version') || args.includes('-v') || args.includes('version')) {
+  console.log(`imsflow v${VERSION} (${isNpmInstall ? 'npm 全局安装' : '源码模式'})`);
+  const remote = await remoteVersion();
+  if (remote === null) {
+    console.log('npm registry 不可达, 无法比对最新版本');
+  } else if (remote === VERSION) {
+    console.log(`已是最新版本 (${remote})`);
+  } else {
+    console.log(`npm 最新版本: ${remote} → 可执行 imsflow --update 更新`);
+  }
+  process.exit(0);
+}
+
+if (args.includes('--update') || args.includes('update')) {
+  console.log(`当前版本: v${VERSION} (${isNpmInstall ? 'npm 全局安装' : '源码模式'})`);
+  if (!isNpmInstall) {
+    console.log('\n源码 clone 模式不走 npm, 更新方式:');
+    console.log('  git pull');
+    console.log('  node install.mjs        # 刷新 profile 里的命令指向');
+    process.exit(0);
+  }
+  console.log('\n正在更新 ims-flow-dashboard@latest ...\n');
+  npm(['install', '-g', 'ims-flow-dashboard@latest']);
+  // npm 退出码透传后不会走到这
+}
+
+if (args.includes('--uninstall') || args.includes('uninstall')) {
+  if (!isNpmInstall) {
+    // 源码模式: install.mjs 自己会清 profile 标记块
+    console.log('源码模式: 清理各 shell profile 中的 imsflow 命令...\n');
+    const child = spawn(nodeExe, [path.join(pkgRoot, 'install.mjs'), '--uninstall'], { stdio: 'inherit' });
+    child.on('exit', (code) => process.exit(code ?? 0));
+  } else {
+    console.log('npm 全局安装模式: 执行 npm uninstall -g ims-flow-dashboard ...\n');
+    console.log('（配置 ~/.imsflow/projects.json 会保留, 想彻底清理可手动删除该目录）\n');
+    npm(['uninstall', '-g', 'ims-flow-dashboard']);
+  }
   process.exit(0);
 }
 
+// ---------- 默认: 透传给 scan.mjs ----------
 const child = spawn(nodeExe, [scanScript, ...args], { stdio: 'inherit' });
 child.on('exit', (code) => process.exit(code ?? 0));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ims-flow-dashboard",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "IMS Flow 控制台 — 可视化 OpenSpec 变更生命周期、产物完整性与任务进度",
   "type": "module",
   "files": [