@dreamor/atlas-cli 0.7.24 → 0.7.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamor/atlas-cli",
-  "version": "0.7.24",
+  "version": "0.7.26",
   "description": "Atlas CLI",
   "type": "module",
   "bin": {

package/README.github.md

@@ -1,230 +0,0 @@
-# Atlas CLI
-
-斑马云图（Banma Yuntu）人力基线管理 CLI 工具。
-
-```bash
-npm i -g @dreamor/atlas-cli
-```
-
-> 需要 Node.js 20+
-
----
-
-## 目录
-
-- [快速开始](#快速开始)
-- [命令结构](#命令结构)
-- [源码开发](#源码开发)
-- [发布流程](#发布流程)
-- [测试](#测试)
-- [架构](#架构)
-- [文档](#文档)
-
----
-
-## 快速开始
-
-```bash
-# SSO 登录
-atlas auth login
-
-# 搜索项目
-atlas find project 斑马
-
-# 绑定默认项目
-atlas link <project-name>
-
-# 查询基线
-atlas baseline month --project-id 2496
-
-# 查询实际工时
-atlas actual month --project-id 2496
-
-# 基线 vs 实际对比
-atlas compare --project-id 2496 --from 2026-01 --to 2026-06
-```
-
-### 沙盒环境（无 GUI 容器）
-
-Claude Code、悟空、AntCode WebIDE 等沙盒环境无法直接 `atlas auth login`，推荐：
-
-```bash
-# 先诊断环境
-atlas auth doctor
-
-# 方案 A：从宿主机导入登录态
-export ATLAS_COOKIES_B64='<宿主机 atlas auth export --base64 输出>'
-atlas auth refresh              # 补发 access_token
-
-# 方案 B：通过 daemon 代理
-export ATLAS_DAEMON_URL=http://host.docker.internal:8765
-export ATLAS_DAEMON_TOKEN=$(cat ~/.atlas/daemon.token)
-```
-
-详见 [docs/sandbox-login.md](docs/sandbox-login.md)。
-
-## 命令结构
-
-```
-atlas
-├── auth {login,status,refresh,export,import,doctor}
-├── find <kind> <query>          # project/department/manpower-type/role/area
-├── projects
-├── link / unlink
-├── baseline {month,summary,export}
-├── actual {show,month,summary,export}
-├── compare
-├── schema {commands,export}
-├── daemon
-├── exec --plan-file <path>
-├── update
-└── suggest <query>
-```
-
-### 全局选项
-
-- `--json` — JSON 信封输出（stdout）；日志走 stderr，不污染管道
-- `--quiet` — 静默模式
-- `--describe` — 输出参数 schema，不执行
-
-### 退出码
-
-| 码 | 含义 | agent 应对 |
-|----|------|-----------|
-| 0 | 成功 | 继续 |
-| 2 | 会话过期 | 先试 `atlas auth refresh` |
-| 3 | API 错误 | 不重试 |
-| 4 | 项目匹配歧义 | 用 `atlas find project` 让用户挑 |
-| 5 | 项目未找到 | 改关键词重试 1 次后报告 |
-| 6 | 限流 | 退避 10s 重试 ≤1 次 |
-| 7 | 网络错误 | 退避 5s 重试 ≤1 次 |
-| 8 | 升级异常 | 忽略 |
-| 64 | 配置/未实现 | 不重试 |
-| 65 | 输出超限 | 改用 `--out <file>` |
-
-### 数据单位
-
-- **基线**：`manpower` = 人月
-- **实际工时**：`mp` / `weeklyActuals[].manpower` = 人月
-- **compare**：`diff = 实际 - 基线`（人月，已自动统一单位，**不要二次换算**）
-- 月份格式 `YYYY-MM`，已修正 CST(UTC+8) 偏移
-
-## 源码开发
-
-### 技术栈
-
-TypeScript + Commander (CLI 框架) + Zod (输入验证) + undici (HTTP 客户端) + Playwright (SSO 登录)
-
-### 本地开发
-
-```bash
-git clone <repo>
-cd atlas-cli
-pnpm install
-
-# 构建
-npm run build
-
-# 类型检查
-npm run lint
-
-# 测试
-npm test
-
-# 验证 CLI
-npm run verify
-
-# 本地运行
-node atlas.js --help
-```
-
-## 测试
-
-| 类型 | 位置 | 测试数 | 说明 |
-|------|------|--------|------|
-| 单元测试 | `adapters/atlas/tests/` | 354（27 文件） | Vitest，覆盖率 80%+ |
-| E2E 真实 API | `scripts/run-e2e-real.mjs` | 41 | 需登录态（~/.atlas/cookies.json） |
-| E2E 沙盒登录 | `scripts/run-e2e-sandbox-login.mjs` | 12 | 验证 export/import/COOKIES_B64/daemon |
-
-### CI 流程
-
-- **CI**（`.github/workflows/ci.yml`）：push/PR 自动 lint → test → build → 源码泄漏检查
-- **Publish**（`.github/workflows/publish-npm.yml`）：tag `v*` 触发 OIDC Trusted Publisher → npmjs
-
-## 发布流程
-
-```bash
-# 更新版本号
-# package.json + adapters/atlas/util/version.ts
-
-# 本地验证
-npm run build
-npm test
-npm run lint
-npm run verify
-
-# 提交并打 tag
-git add -A && git commit -m "chore: bump X.Y.Z → X.Y.Z"
-git tag vX.Y.Z
-git push dist main && git push dist vX.Y.Z
-```
-
-> npm 包名 `@dreamor/atlas-cli`，仅 `dist/` 编译产物（零源码、零 sourcemap、零测试文件）。发布由 GitHub CI 自动完成，无需本地 `npm publish`。
-
-## 架构
-
-```
-adapters/atlas/
-├── cli.ts                    # Commander 入口
-├── commands/                 # 命令处理
-│   ├── auth.ts               # auth login/status/refresh/export/import/doctor
-│   ├── project/              # find, projects, link, unlink
-│   ├── baseline/             # month, summary, export
-│   ├── actual/               # show, month, summary, export
-│   ├── compare/              # 基线 vs 实际对比
-│   ├── schema.ts             # 命令树自省
-│   ├── exec.ts               # 批量命令执行
-│   ├── suggest.ts            # 自然语言→命令翻译
-│   └── update.ts             # 自动升级
-├── auth/                     # 鉴权
-│   ├── login.ts              # Playwright SSO + daemon 自动登录
-│   ├── session.ts            # cookies 读写 + ATLAS_COOKIES_B64 + daemon 客户端
-│   ├── portable.ts           # export/import/doctor 便携登录态打包
-│   └── refresh.ts            # 无头 token 刷新
-├── daemon/                   # 本地守护进程
-│   ├── index.ts              # HTTP server + token 鉴权 + IP 白名单
-│   └── ipmask.ts             # CIDR 位运算匹配
-├── http/                     # Banma API HTTP 客户端
-├── util/                     # 工具函数
-│   ├── environment.ts        # 沙盒环境识别（agent_code/容器/GUI/daemon）
-│   ├── output.ts             # JSON 信封、日志
-│   ├── errors.ts             # 错误类型 + 退出码
-│   └── ...
-└── tests/                    # 单元测试（27 文件）
-```
-
-## 环境变量
-
-| 变量 | 必需 | 说明 | 默认值 |
-|------|------|------|--------|
-| `BANMA_PROJECT_ID` | 是（或 `--project-id` / `atlas link`） | 默认项目 ID | — |
-| `ATLAS_HOME` | 否 | 数据目录根路径 | `~/.atlas` |
-| `ATLAS_COOKIES_B64` | 否 | 沙盒免命令登录：base64 bundle 内存导入 | — |
-| `ATLAS_DAEMON_URL` | 否 | 沙盒连宿主机 daemon URL | — |
-| `ATLAS_DAEMON_TOKEN` | 否 | daemon Bearer token | — |
-| `ATLAS_DAEMON_PORT` | 否 | 守护进程端口 | `8765` |
-| `ATLAS_AGENT_CODE` | 否 | 显式声明 agent 类型 | 自动识别 |
-| `ATLAS_SANDBOX` | 否 | 强制沙盒模式（禁用浏览器拉起） | — |
-| `ATLAS_OUTPUT` | 否 | 设为 `json` 启用 JSON 信封输出 | — |
-| `ATLAS_QUIET` | 否 | 抑制 stderr 日志 | — |
-| `ATLAS_DISABLE_UPDATE` | 否 | 禁用升级检查 | — |
-| `ATLAS_MAX_OUTPUT_BYTES` | 否 | 导出字节上限 | 无限制 |
-| `DEBUG` | 否 | 显示详细错误堆栈 | — |
-
-## 文档
-
-- [贡献指南](docs/CONTRIBUTING.md) — 开发环境、测试、PR 流程
-- [运维手册](docs/RUNBOOK.md) — 安装、发布、故障排查
-- [项目状态](docs/STATUS.md) — 当前版本、测试状态、已知问题
-- [沙盒登录](docs/sandbox-login.md) — 沙盒环境登录全攻略
-- [CLI 完整契约](.claude/skills/atlas/SKILL.md) — AI agent 调用契约