@dazitech/cli 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 搭子科技
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# @dazitech/cli
+
+搭子 v3 终端 CLI 的 **pnpm 可发布包**，与 `dazi-vscode` 扩展使用同一套 `bundled/clis` 产物。
+
+## 与 `dazi.ps1` 的关系
+
+| 方式 | 适用 |
+|------|------|
+| `.\scripts\dazi.ps1` | 仅拷贝 `dazi-work`、未装全局 CLI |
+| **`dazi` / `dazi-flow`（本包）** | 开发机全局短命令 |
+
+二者等价：`dazi flow …` ≈ `.\scripts\dazi.ps1 flow …`。
+
+## 研发：准备发布目录
+
+在 `dazi-vscode` 根目录：
+
+```powershell
+pnpm run bundle:clis
+pnpm run prepare:cli-dist
+```
+
+## 本地全局安装（无需 publish，推荐研发机）
+
+未登录 npm / 无 `@dazitech` 发布权限时，用 **link** 即可在本机得到 `dazi` 命令：
+
+```powershell
+cd dazi\dazi-vscode
+pnpm run link:cli
+```
+
+若提示 `ERR_PNPM_NO_GLOBAL_BIN_DIR`，先执行一次 **`pnpm setup`**，重开终端，再把 `PNPM_HOME` 加入 PATH。
+
+```powershell
+pnpm bin -g
+where.exe dazi
+dazi --version
+```
+
+**备选**（不依赖 link）：
+
+```powershell
+pnpm add -g "D:\path\to\dazi-vscode\packages\cli-dist"
+```
+
+更新 CLI 后重新执行 `pnpm run link:cli` 或 `pnpm add -g` 同上路径。
+
+## 发布到 registry（需登录）
+
+`pnpm run publish:cli` 默认指向 **https://registry.npmjs.org/**，须先登录且拥有 `@dazitech` 作用域发布权：
+
+**方式 A — 交互登录（需账号已开 2FA，且为 Authorization and writes）：**
+
+```powershell
+pnpm login
+pnpm run publish:cli
+```
+
+**方式 B — Granular Access Token + `.npmrc`（纯文本文件）：**
+
+```powershell
+cd packages\cli-dist
+copy .npmrc.example .npmrc
+# 用编辑器打开 .npmrc，把 YOUR_NPM_TOKEN_HERE 换成 npm_ 开头的 token
+cd ..\..
+pnpm run publish:cli
+```
+
+`.npmrc` 已加入 `.gitignore`，不要提交到 Git。也可放在用户目录 `%USERPROFILE%\.npmrc` 供本机所有项目使用。
+
+内网 registry：把 `registry=` 和 token 行改成你们私服地址。
+
+若仅内网使用、不上传 npmjs，可跳过 publish，只用上面的 `link:cli` 或 `dazi.ps1`。
+
+## 从 registry 安装（publish 成功后）
+
+```powershell
+# 全局
+pnpm add -g @dazitech/cli@3.0.0
+
+# 确认 PATH（pnpm 全局 bin）
+pnpm bin -g
+where.exe dazi
+
+dazi --version
+dazi auth whoami
+```
+
+在 `dazi-work` 根目录：
+
+```powershell
+dazi flow project status --dir "项目\flow_xxx\流程\MyFlow"
+```
+
+## 项目内安装（可选）
+
+在 `dazi-work/package.json` 中声明 `@dazitech/cli` 为 devDependency，使用 `pnpm exec dazi ...`。
+
+## 环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `DAZI_BUNDLED_DIR` | 默认：包内 `dist/clis` |
+| `DAZI_WORKSPACE_ROOT` | 默认：从 cwd 向上查找含 `scripts/dazi.ps1` 的目录 |

package/dist/bin/dazi-app.cjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict';
+process.env.DAZI_CLI_BIN = 'dazi-app';
+require('./run-cli-bin.cjs');

package/dist/bin/dazi-flow.cjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict';
+process.env.DAZI_CLI_BIN = 'dazi-flow';
+require('./run-cli-bin.cjs');

package/dist/bin/dazi-onto.cjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict';
+process.env.DAZI_CLI_BIN = 'dazi-onto';
+require('./run-cli-bin.cjs');

package/dist/bin/dazi.cjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict';
+process.env.DAZI_CLI_BIN = 'dazi';
+require('./run-cli-bin.cjs');

package/dist/bin/run-cli-bin.cjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * @dazitech/cli 统一启动器：设置 DAZI_BUNDLED_DIR / 工作区根，再 spawn 对应 bundled CLI。
+ */
+const path = require('path');
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+
+const CLI_NAME = process.env.DAZI_CLI_BIN;
+if (!CLI_NAME) {
+  console.error('[dazi] 内部错误：未设置 DAZI_CLI_BIN');
+  process.exit(1);
+}
+
+const PKG_ROOT = path.resolve(__dirname, '..');
+const CLI_DIR = path.join(PKG_ROOT, 'clis');
+const CLI_JS = path.join(CLI_DIR, `${CLI_NAME}.js`);
+
+if (!fs.existsSync(CLI_JS)) {
+  console.error(`[dazi] 找不到 CLI：${CLI_JS}`);
+  console.error('请重新安装 @dazitech/cli，或执行 pnpm run prepare:cli-dist 后发布。');
+  process.exit(2);
+}
+
+if (!process.env.DAZI_BUNDLED_DIR) {
+  process.env.DAZI_BUNDLED_DIR = CLI_DIR;
+}
+
+if (!process.env.DAZI_WORKSPACE_ROOT) {
+  const found = findDaziWorkRoot(process.cwd());
+  if (found) process.env.DAZI_WORKSPACE_ROOT = found;
+}
+
+const cwd =
+  process.env.DAZI_WORKSPACE_ROOT &&
+  fs.existsSync(process.env.DAZI_WORKSPACE_ROOT)
+    ? process.env.DAZI_WORKSPACE_ROOT
+    : process.cwd();
+
+const args = process.argv.slice(2);
+const result = spawnSync(process.execPath, [CLI_JS, ...args], {
+  stdio: 'inherit',
+  cwd,
+  env: process.env,
+});
+
+process.exit(result.status ?? 1);
+
+/** 向上查找 dazi-work 根（含 scripts/dazi.ps1 或 tools/dazi-clis） */
+function findDaziWorkRoot(start) {
+  let dir = path.resolve(start);
+  for (let i = 0; i < 16; i++) {
+    if (fs.existsSync(path.join(dir, 'scripts', 'dazi.ps1'))) return dir;
+    if (fs.existsSync(path.join(dir, 'tools', 'dazi-clis', 'dazi.js'))) return dir;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}