weaver-work-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 weaver-work-cli contributors
+
+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,422 @@
+# weaver-work-cli
+
+面向泛微工作工具链的可扩展 TypeScript CLI 基础框架。
+
+核心框架保持业务无关；E10 共享能力通过 `src/internal/e10` 隔离提供。新增具体业务 CLI 时，优先放在 `src/shortcuts/<name>` 下，并复用 E10 鉴权、profile、HTTP client 和命令钩子。
+
+## 环境要求
+
+- Node.js >= 18
+- npm
+
+## 下载后快速运行
+
+从代码仓库获取项目：
+
+```bash
+git clone <git-repo-url> weaver-work-cli
+cd weaver-work-cli
+npm install
+npm run build
+node dist/index.js --help
+```
+
+开发阶段可以直接从源码运行：
+
+```bash
+npm run dev -- --help
+npm run dev -- commands list
+```
+
+构建后的本地验证：
+
+```bash
+npm run build
+node dist/index.js --version
+node dist/index.js commands list
+node dist/index.js doctor --e10
+```
+
+## 全局安装
+
+从当前源码目录安装到全局命令：
+
+```bash
+# 在克隆到本地的仓库根目录执行（将 <repo-root> 替换为实际路径）
+cd <repo-root>
+npm install
+npm run build
+npm link
+weaver-work-cli --help
+```
+
+打包后全局安装：
+
+```bash
+# 在克隆到本地的仓库根目录执行（将 <repo-root> 替换为实际路径）
+cd <repo-root>
+npm run build
+npm pack
+npm install -g ./weaver-work-cli-0.1.0.tgz
+weaver-work-cli --version
+```
+
+发布到 npm 或公司私有 registry 后，可以直接安装：
+
+```bash
+npm install -g weaver-work-cli
+weaver-work-cli setup invoice
+```
+
+推荐把 `weaver-work-cli` 作为唯一必须安装的运行时包。发票业务命令和随包
+Agent Skill 文档都包含在这个 npm 包中；普通 CLI 用户不需要再单独安装
+发票 zip 包。
+
+首次启用发票业务时：
+
+```bash
+weaver-work-cli setup invoice
+weaver-work-cli auth login --base-url "https://weapp.xxx.cn"
+weaver-work-cli invoice schema
+```
+
+如果要让 Codex/Agent 一键识别发票业务，把随包 Skill 安装到 Codex skills 目录：
+
+```bash
+weaver-work-cli setup invoice --install-skill
+# 或只安装 Skill
+weaver-work-cli skills install invoice
+```
+
+`skills install invoice` 会同时安装 `weaver-work-cli-shared` 和
+`weaver-work-cli-invoice`。默认目标目录是 `$CODEX_HOME/skills`，未设置
+`CODEX_HOME` 时使用 `~/.codex/skills`；需要自定义时可加
+`--target-dir <path>`。
+
+卸载全局命令：
+
+```bash
+npm unlink -g weaver-work-cli
+# 或
+npm uninstall -g weaver-work-cli
+```
+
+## 常用命令
+
+```bash
+weaver-work-cli --help
+weaver-work-cli --version
+weaver-work-cli commands list
+weaver-work-cli config list
+weaver-work-cli docs root
+weaver-work-cli docs copy
+weaver-work-cli doctor --e10
+weaver-work-cli setup invoice
+weaver-work-cli skills list
+weaver-work-cli skills read weaver-work-cli-invoice
+weaver-work-cli skills install invoice
+weaver-work-cli invoice schema
+weaver-work-cli --json invoice run invoice.list --input -
+```
+
+为了兼容 E10 使用习惯，`auth` 命令保留在顶层；同时也支持 `e10 auth` 命名空间：
+
+```bash
+weaver-work-cli auth status
+weaver-work-cli e10 auth status
+```
+
+## E10 鉴权方式
+
+方式一：浏览器 OAuth2.0 登录，推荐优先使用。
+
+```bash
+weaver-work-cli auth login --base-url "https://weapp.xxx.cn"
+```
+
+等价命令：
+
+```bash
+weaver-work-cli auth oidc --base-url "https://weapp.xxx.cn"
+```
+
+默认本地回调地址为 `http://127.0.0.1:19800/callback`。如果端口被占用：
+
+```bash
+weaver-work-cli auth login --base-url "https://weapp.xxx.cn" --port 19801
+```
+
+需要区分客户端来源时，可以指定 `agent_type`，默认值为 `weaver-work-cli`：
+
+```bash
+weaver-work-cli auth login --base-url "https://weapp.xxx.cn" --agent_type weaver-work-cli
+```
+
+方式二：手动写入浏览器中的 `ETEAMSID`。
+
+```bash
+weaver-work-cli auth set --eteamsid "PCACCOUNT_xxx" --base-url "https://weapp.xxx.cn"
+```
+
+如果 E10 环境需要区分 agent：
+
+```bash
+weaver-work-cli auth set --eteamsid "PCACCOUNT_xxx" --base-url "https://weapp.xxx.cn" --agent_type weaver-work-cli
+```
+
+查看登录状态：
+
+```bash
+weaver-work-cli auth status
+weaver-work-cli auth status --no-check
+weaver-work-cli --json auth status --no-check
+```
+
+查看当前用户：
+
+```bash
+weaver-work-cli auth whoami
+weaver-work-cli auth whoami --live
+weaver-work-cli auth whoami --json
+```
+
+清理当前 profile 的登录状态：
+
+```bash
+weaver-work-cli auth logout
+weaver-work-cli --profile <name> auth logout
+```
+
+`auth logout` 只删除本地 auth 文件，不删除 profile 配置和 keychain 密钥。
+
+导出 E10 登录态到当前 shell：
+
+```bash
+eval "$(weaver-work-cli auth export-weaver-env)"
+```
+
+导出的环境变量包括：
+
+- `WEAVER_BASE_URL`
+- `WEAVER_ETEAMSID`
+- `WEAVER_COOKIE`
+- `WEAVER_USER_AGENT`
+- `WEAVER_AGENT_TYPE`
+
+通过 `weaver-work-cli run` 执行外部命令时，CLI 会在前置钩子中自动注入上述 `WEAVER_*` 变量：
+
+```bash
+weaver-work-cli run node -e "console.log(process.env.WEAVER_BASE_URL || 'no e10 auth')"
+```
+
+## Profile 管理
+
+鉴权文件默认由 `weaver-work-cli` 独立管理：
+
+- 鉴权根目录：`~/.weaver-work-cli/e10`
+- Profile 目录：`~/.weaver-work-cli/e10/profiles/<profile>`
+- 当前激活 profile：`~/.weaver-work-cli/e10/profile`
+- Keychain service/account：`weaver-work-cli` / `auth-key`
+
+CLI 默认不读取、不迁移 `e10-login` / `e10-cli` 的 `~/.e10-cli` 登录态；
+打包给用户后，用户必须通过 `weaver-work-cli auth login` 或
+`weaver-work-cli auth set` 建立本插件自己的登录状态。确需复用外部 auth 文件时，
+可以显式使用 `--auth <path>` 或 `E10_AUTH_PATH`。
+
+常用 profile 命令：
+
+```bash
+weaver-work-cli auth profile list
+weaver-work-cli auth profile current
+weaver-work-cli auth profile use <name>
+weaver-work-cli --profile <name> auth status
+```
+
+支持的鉴权相关环境变量：
+
+- `E10_AUTH_PATH`：指定 auth 文件路径
+- `WEAVER_WORK_CLI_AUTH_ROOT`：覆盖 `weaver-work-cli` 的独立鉴权根目录
+- `E10_ACCOUNT` / `E10_PASSWORD`：session 过期且需要 RSA 自动重登时使用
+
+## 目录结构
+
+```text
+src/
+  index.ts                   CLI bin 入口。
+  cmd/                       Commander root、注册协议和顶层命令。
+    index.ts                 汇总内置 cmd。
+    root.ts                  程序创建、全局 flags 和版本信息。
+    register.ts              命令注册、hooks 注册和 action 包装。
+    action.ts                统一错误处理和命令生命周期。
+    config/                  通用本地配置命令。
+    docs/                    包内文档和模板复制命令。
+    doctor/                  环境检查命令。
+    commands/                已注册命令查看命令，兼容 module 别名。
+    run/                     带前置/后置钩子的外部命令执行器。
+    e10/                     E10 auth/profile 命令和 run-hook 环境注入。
+    skills/                  包内 Agent Skill 读取命令。
+  core/                      业务无关的上下文、钩子、配置、输出和错误处理。
+  internal/                  只供本包复用的实现细节。
+    e10/                     E10 session、auth 文件、API client。
+    skills/                  Skill 内容读取和路径保护。
+  shortcuts/                 面向人和 Agent 的高层业务命令。
+    index.ts                 汇总内置 shortcuts。
+    invoice/                 E10 业票通发票 shortcut、operation manifest 和业务执行器。
+      operations/            按业务执行逻辑拆分的 operation class。
+  services/                  可复用的非业务服务。
+docs/                        随包发布的 CLI 文档。
+skills/                      随包发布的 Agent Skills；入口 SKILL.md 做路由，细节放 references/。
+  weaver-work-cli-shared/    所有业务 Skill 共享的安装、认证、JSON 和写入规则。
+  weaver-work-cli-invoice/   业票通业务 Skill。
+skill-template/              新增或重写业务 Skill 时使用的模板来源，参考 lark-cli 的 skill-template。
+templates/                   后续 shortcut 脚手架模板。
+scripts/                     维护脚本。
+test/                        Node 内置测试运行器测试。
+```
+
+## 命令分层
+
+`weaver-work-cli` 采用与 `lark-cli` 接近的三层组织：
+
+- `cmd`：稳定的系统/平台命令，例如 `config`、`doctor`、`run`、`e10 auth`、`skills list/read`。
+- `shortcuts`：业务友好的高层命令，例如 `invoice list`、`invoice import prepare`；按 `src/shortcuts/<business-module>` 分模块维护，模块内每个业务 operation 用相对独立的 class 封装。
+- `skills`：Agent 可读的使用说明和引用文件；按 `skills/weaver-work-cli-<business-module>` 分模块维护。业务入口 `SKILL.md` 只放路由、前置要求和执行原则，具体 operation、工作流、错误处理放到 `references/*.md`；公共规则只放在 `weaver-work-cli-shared`。
+- `skill-template`：维护者新增业务 Skill 时的模板来源，作用类似飞书 CLI 的 `skill-template`。`master-skill-template.md` 用于未来聚合入口，`skill-template.md` 用于单业务 Skill，`business-info.json` 记录路由关键词，`domains/*.md` 记录当前业务域应拆出的 reference 与 Agent 调优重点。
+
+## 新增业务 Shortcut
+
+业务 shortcut 统一创建在 `src/shortcuts/<name>` 下，不和框架内置命令、E10 共享适配混放。
+配套 Agent Skill 统一创建在 `skills/weaver-work-cli-<name>`：
+
+```text
+skills/weaver-work-cli-<name>/
+  SKILL.md                  入口路由：共享 Skill、schema、reference 索引、禁用边界。
+  product.json              可选：业务 Skill 包元信息。
+  references/
+    <name>-agent-entry.md   CLI 入口、schema、stdin JSON、输出约定。
+    <name>-read.md          查询/详情类只读 operation。
+    <name>-write.md         prepare/apply 写入协议、确认和回查。
+```
+
+新增 Skill 时先参考 `skill-template/skill-template.md` 和 `skill-template/domains/<name>.md`。入口文件不要复制大段接口细节；让 Agent 按用户意图读取最小必要 reference。
+
+当前已内置 `invoice` shortcut，用于 E10 业票通发票管理。典型调用：
+
+```bash
+weaver-work-cli --json invoice list --input -
+weaver-work-cli --json invoice enterprise list --input -
+weaver-work-cli --json invoice get --fid <fid>
+weaver-work-cli --json invoice upload --file ./invoice.pdf
+weaver-work-cli --json invoice ocr preview --file ./invoice.pdf
+weaver-work-cli --json invoice validate preview --fid <fid> --scope personal
+weaver-work-cli --json invoice download --fid <fid> --file-id <fileId> --output ./invoice.pdf
+```
+
+写操作固定使用 `prepare -> apply`：
+
+```bash
+echo '{"file":"./invoice.pdf","validate":false,"syncToOa":false}' \
+  | weaver-work-cli --json invoice import prepare --input -
+
+echo '{"file":"./invoice.pdf","continuation":"<prepare返回值>","confirm":true}' \
+  | weaver-work-cli --json invoice import apply --input -
+```
+
+Agent 应优先调用 `weaver-work-cli --json invoice run <operation> --input -`，并读取 `weaver-work-cli invoice schema` 获取 operation 契约。共享、转让和标签接口因缺少稳定 ID 来源和写后回查契约，当前不暴露给 Agent。
+
+如需交付通用 Agent Skill 包：
+
+```bash
+npm run build:skill -- invoice
+# 或保留的 invoice 便捷命令
+npm run build:invoice-skill
+```
+
+输出文件默认在 `dist/weaver-work-cli-invoice-skill.zip`。该 zip 主要用于
+Codex/Agent 平台导入、离线分发或版本归档；日常推荐直接通过 npm 包内置内容
+执行 `weaver-work-cli skills install invoice`。zip 包包含
+`weaver-work-cli-invoice` 和共享的 `weaver-work-cli-shared`，要求用户本机已安装
+可用的 `weaver-work-cli`。
+如需打包全部 Skill：
+
+```bash
+npm run build:skill
+```
+
+示例：新增 `workflow` shortcut。
+
+```text
+src/shortcuts/workflow/
+  index.ts
+  operations/
+    list.ts
+```
+
+`src/shortcuts/workflow/index.ts`：
+
+```ts
+import { WorkflowListOperation } from './operations/list.js';
+import type { CliCommand } from '../../types.js';
+
+const listOperation = new WorkflowListOperation();
+
+export const workflowShortcut: CliCommand = {
+  name: 'workflow',
+  description: '流程业务命令',
+  category: 'shortcut',
+  register({ program, action }) {
+    const workflow = program.command('workflow').description('流程业务命令');
+
+    workflow.command('list')
+      .description('查询流程列表')
+      .action(action(async (ctx) => {
+        ctx.output.write(await listOperation.execute(ctx));
+      }));
+  },
+};
+```
+
+`src/shortcuts/workflow/operations/list.ts`：
+
+```ts
+import { requireE10Client } from '../../../internal/e10/context.js';
+import type { CliContext } from '../../../core/context.js';
+
+export class WorkflowListOperation {
+  async execute(ctx: CliContext): Promise<unknown> {
+    const client = await requireE10Client(ctx);
+    return client.post('/api/xxx/workflow/list', {});
+  }
+}
+```
+
+然后在 `src/shortcuts/index.ts` 中注册：
+
+```ts
+import { invoiceShortcut } from './invoice/index.js';
+import { workflowShortcut } from './workflow/index.js';
+import type { CliCommand } from '../types.js';
+
+export const builtinShortcuts: CliCommand[] = [
+  invoiceShortcut,
+  workflowShortcut,
+];
+```
+
+验证命令是否注册成功：
+
+```bash
+npm run build
+node dist/index.js commands list
+node dist/index.js workflow --help
+```
+
+如果业务 shortcut 不依赖 E10，只使用 `ctx.output`、`ctx.config`、`ctx.hooks` 等通用能力即可；如果依赖 E10，优先复用 `requireE10Client(ctx)` 或 `requireE10Session(ctx)`，不要在 shortcut 里重复实现登录态读取、cookie 拼接或 HTTP header 注入。
+
+## 发布前验证
+
+```bash
+npm run build
+npm test
+npm pack --dry-run
+```

package/dist/cmd/action.js

@@ -0,0 +1,35 @@
+import { ExitCode, isCliError, toErrorEnvelope } from '../core/errors.js';
+function commandFromArgs(args) {
+    const last = args[args.length - 1];
+    return last && typeof last === 'object' && 'name' in last && 'opts' in last ? last : undefined;
+}
+export function createAction(ctx) {
+    return (handler) => async (...args) => {
+        const commandCtx = ctx.forCommand(commandFromArgs(args));
+        try {
+            await commandCtx.hooks.beforeCommand(commandCtx);
+            const result = await handler(commandCtx, ...args);
+            await commandCtx.hooks.afterCommand(commandCtx, result);
+        }
+        catch (error) {
+            await commandCtx.hooks.onError(commandCtx, error);
+            if (commandCtx.getGlobalOptions().json) {
+                console.error(JSON.stringify({
+                    schemaVersion: 1,
+                    ok: false,
+                    error: toErrorEnvelope(error),
+                }, null, 2));
+                process.exitCode = isCliError(error) ? error.exitCode : ExitCode.GeneralError;
+                return;
+            }
+            if (isCliError(error)) {
+                commandCtx.logger.error(error.message);
+                process.exitCode = error.exitCode;
+                return;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            commandCtx.logger.error(message);
+            process.exitCode = ExitCode.GeneralError;
+        }
+    };
+}

package/dist/cmd/commands/index.js

@@ -0,0 +1,15 @@
+export const commandsCommand = {
+    name: 'commands',
+    description: 'Registered command discovery',
+    category: 'system',
+    register({ program, action }) {
+        const commands = program.command('commands')
+            .alias('module')
+            .description('Inspect registered commands');
+        commands.command('list')
+            .description('List registered commands')
+            .action(action((ctx) => {
+            ctx.output.write({ commands: ctx.commands, modules: ctx.modules });
+        }));
+    },
+};

package/dist/cmd/config/index.js

@@ -0,0 +1,64 @@
+import { CliError, ExitCode } from '../../core/errors.js';
+function parseValue(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value === 'null')
+        return null;
+    if (/^-?\d+(\.\d+)?$/.test(value))
+        return Number(value);
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+export const configCommand = {
+    name: 'config',
+    description: 'Generic local configuration commands',
+    category: 'system',
+    register({ program, action }) {
+        const config = program.command('config').description('Manage weaver-work-cli config');
+        config.command('path')
+            .description('Print the active config file path')
+            .action(action((ctx) => {
+            ctx.output.write({ path: ctx.config.path() }, { text: ctx.config.path() });
+        }));
+        config.command('list')
+            .description('Print all config values')
+            .action(action((ctx) => {
+            ctx.output.write(ctx.config.all());
+        }));
+        config.command('get')
+            .description('Print one config value')
+            .argument('<key>', 'config key')
+            .action(action((ctx, key) => {
+            if (typeof key !== 'string')
+                throw new CliError('key must be a string', ExitCode.UsageError);
+            ctx.output.write({ key, value: ctx.config.get(key) });
+        }));
+        config.command('set')
+            .description('Set one config value')
+            .argument('<key>', 'config key')
+            .argument('<value>', 'config value')
+            .action(action((ctx, key, value) => {
+            if (typeof key !== 'string' || typeof value !== 'string') {
+                throw new CliError('key and value must be strings', ExitCode.UsageError);
+            }
+            const parsed = parseValue(value);
+            ctx.config.set(key, parsed);
+            ctx.output.write({ key, value: parsed, path: ctx.config.path() }, { text: 'Saved ' + key });
+        }));
+        config.command('delete')
+            .description('Delete one config value')
+            .argument('<key>', 'config key')
+            .action(action((ctx, key) => {
+            if (typeof key !== 'string')
+                throw new CliError('key must be a string', ExitCode.UsageError);
+            const deleted = ctx.config.delete(key);
+            ctx.output.write({ key, deleted, path: ctx.config.path() }, { text: deleted ? 'Deleted ' + key : 'No value for ' + key });
+        }));
+    },
+};

package/dist/cmd/docs/index.js

@@ -0,0 +1,56 @@
+import { cpSync, existsSync, readdirSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { CliError } from '../../core/errors.js';
+const DOCS_DIR = fileURLToPath(new URL('../../../docs/', import.meta.url));
+const PKG_JSON_URL = new URL('../../../package.json', import.meta.url);
+function packageVersion() {
+    try {
+        return JSON.parse(readFileSync(PKG_JSON_URL, 'utf-8')).version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function countFiles(dir) {
+    let count = 0;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const entryPath = resolve(dir, entry.name);
+        count += entry.isDirectory() ? countFiles(entryPath) : 1;
+    }
+    return count;
+}
+function ensureDocs() {
+    if (!existsSync(DOCS_DIR)) {
+        throw new CliError('docs directory does not exist: ' + DOCS_DIR);
+    }
+}
+export const docsCommand = {
+    name: 'docs',
+    description: 'Packaged docs and template copy commands',
+    category: 'system',
+    register({ program, action }) {
+        const docs = program.command('docs').description('Read or copy packaged docs');
+        docs.command('root')
+            .description('Print packaged docs root path')
+            .action(action((ctx) => {
+            ensureDocs();
+            const root = DOCS_DIR.replace(/[\\/]+$/, '');
+            ctx.output.write({ root, version: packageVersion() }, { text: root + '\nversion: ' + packageVersion() });
+        }));
+        docs.command('copy')
+            .description('Copy packaged docs to <target>/weaver-work-cli-docs')
+            .argument('[target]', 'target directory', process.cwd())
+            .action(action((ctx, target) => {
+            ensureDocs();
+            const dest = resolve(String(target || process.cwd()), 'weaver-work-cli-docs');
+            const sourceRoot = DOCS_DIR.replace(/[\\/]+$/, '');
+            if (dest === sourceRoot || dest.startsWith(sourceRoot + '/') || dest.startsWith(sourceRoot + '\\')) {
+                throw new CliError('target directory is inside docs source: ' + dest);
+            }
+            cpSync(DOCS_DIR, dest, { recursive: true });
+            const files = countFiles(dest);
+            ctx.output.write({ files, dest, version: packageVersion() }, { text: 'Copied ' + files + ' files to ' + dest });
+        }));
+    },
+};

package/dist/cmd/doctor/index.js

@@ -0,0 +1,45 @@
+import { existsSync } from 'node:fs';
+import { findAuthFile } from '../../internal/e10/auth/session.js';
+function versionMajor(version) {
+    return Number(version.replace(/^v/, '').split('.')[0] || 0);
+}
+export const doctorCommand = {
+    name: 'doctor',
+    description: 'Environment diagnostics',
+    category: 'system',
+    register({ program, action }) {
+        program.command('doctor')
+            .description('Check local CLI environment')
+            .option('--e10', 'also check E10 auth file discovery')
+            .action(action((ctx, options) => {
+            const opts = options && typeof options === 'object' ? options : {};
+            const checks = [
+                {
+                    name: 'node',
+                    ok: versionMajor(process.version) >= 18,
+                    detail: process.version,
+                },
+                {
+                    name: 'package',
+                    ok: Boolean(ctx.packageInfo.version),
+                    detail: ctx.packageInfo.name + '@' + ctx.packageInfo.version,
+                },
+                {
+                    name: 'configPath',
+                    ok: true,
+                    detail: ctx.config.path(),
+                },
+            ];
+            if (opts.e10) {
+                const authFile = findAuthFile(ctx.cwd);
+                checks.push({
+                    name: 'e10AuthFile',
+                    ok: Boolean(authFile && existsSync(authFile)),
+                    detail: authFile || 'not found',
+                });
+            }
+            const ok = checks.every((check) => check.ok);
+            ctx.output.write({ ok, checks });
+        }));
+    },
+};

package/dist/cmd/e10/index.js

@@ -0,0 +1,25 @@
+import { registerE10AuthCommands } from '../../internal/e10/auth/commands.js';
+import { E10AuthSession, findAuthFile } from '../../internal/e10/auth/session.js';
+export const e10Command = {
+    name: 'e10',
+    description: 'E10 platform adapter: auth, profiles, and shared API client',
+    category: 'platform',
+    register({ program, ctx, action }) {
+        registerE10AuthCommands(program, action);
+        const e10 = program.command('e10').description('E10 platform commands');
+        registerE10AuthCommands(e10, action);
+        ctx.hooks.register({
+            beforeRun(runCtx) {
+                const authFile = findAuthFile(runCtx.cwd);
+                const session = authFile ? E10AuthSession.fromFile(authFile) : null;
+                if (!session)
+                    return;
+                runCtx.env.WEAVER_BASE_URL ||= session.getBaseUrl();
+                runCtx.env.WEAVER_ETEAMSID ||= session.eteamsId;
+                runCtx.env.WEAVER_COOKIE ||= session.cookieHeader();
+                runCtx.env.WEAVER_USER_AGENT ||= session.uaHeader();
+                runCtx.env.WEAVER_AGENT_TYPE ||= session.agentType;
+            },
+        });
+    },
+};