@dreamor/atlas-cli 0.7.23 → 0.7.25
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -59
- package/atlas.cjs +226 -0
- package/package.json +7 -9
- package/atlas.js +0 -5
- package/dist/adapters/atlas/auth/browser.js +0 -37
- package/dist/adapters/atlas/auth/index.js +0 -4
- package/dist/adapters/atlas/auth/login.js +0 -187
- package/dist/adapters/atlas/auth/portable.js +0 -193
- package/dist/adapters/atlas/auth/refresh.js +0 -138
- package/dist/adapters/atlas/auth/session.js +0 -167
- package/dist/adapters/atlas/cli.js +0 -561
- package/dist/adapters/atlas/commands/_output_schema.js +0 -379
- package/dist/adapters/atlas/commands/actual/_logic.js +0 -116
- package/dist/adapters/atlas/commands/actual/index.js +0 -138
- package/dist/adapters/atlas/commands/auth.js +0 -1
- package/dist/adapters/atlas/commands/baseline/index.js +0 -137
- package/dist/adapters/atlas/commands/compare/_logic.js +0 -39
- package/dist/adapters/atlas/commands/compare/index.js +0 -89
- package/dist/adapters/atlas/commands/exec.js +0 -81
- package/dist/adapters/atlas/commands/project/index.js +0 -218
- package/dist/adapters/atlas/commands/schema.js +0 -25
- package/dist/adapters/atlas/commands/suggest.js +0 -83
- package/dist/adapters/atlas/commands/update.js +0 -104
- package/dist/adapters/atlas/daemon/index.js +0 -145
- package/dist/adapters/atlas/dict/index.js +0 -41
- package/dist/adapters/atlas/http/client.js +0 -200
- package/dist/adapters/atlas/http/index.js +0 -1
- package/dist/adapters/atlas/schema/actual.js +0 -16
- package/dist/adapters/atlas/schema/baseline.js +0 -34
- package/dist/adapters/atlas/schema/department.js +0 -11
- package/dist/adapters/atlas/schema/index.js +0 -4
- package/dist/adapters/atlas/schema/project.js +0 -13
- package/dist/adapters/atlas/util/cidr.js +0 -114
- package/dist/adapters/atlas/util/constants.js +0 -4
- package/dist/adapters/atlas/util/env.js +0 -56
- package/dist/adapters/atlas/util/environment.js +0 -152
- package/dist/adapters/atlas/util/errors.js +0 -49
- package/dist/adapters/atlas/util/helpers.js +0 -17
- package/dist/adapters/atlas/util/months.js +0 -65
- package/dist/adapters/atlas/util/output-limit.js +0 -21
- package/dist/adapters/atlas/util/output.js +0 -70
- package/dist/adapters/atlas/util/paths.js +0 -40
- package/dist/adapters/atlas/util/portable-store.js +0 -153
- package/dist/adapters/atlas/util/secure-fs.js +0 -41
- package/dist/adapters/atlas/util/time.js +0 -17
- package/dist/adapters/atlas/util/version.js +0 -1
package/README.md
CHANGED
|
@@ -4,62 +4,4 @@
|
|
|
4
4
|
npm i -g @dreamor/atlas-cli
|
|
5
5
|
```
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
## For Agents
|
|
12
|
-
|
|
13
|
-
本 CLI 设计为 AI agent 可自省调用的接口工具。以下是 agent 需要知道的契约。
|
|
14
|
-
|
|
15
|
-
### 1. JSON 模式
|
|
16
|
-
|
|
17
|
-
所有命令支持 `--json` 或环境变量 `ATLAS_OUTPUT=json`：
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
ATLAS_OUTPUT=json atlas auth status
|
|
21
|
-
atlas baseline month --month 2026-06 --json
|
|
22
|
-
```
|
|
23
|
-
|
|
24
|
-
stdout 始终是统一 JSON 信封；进度日志走 stderr，不污染管道。
|
|
25
|
-
|
|
26
|
-
### 2. 发现入口
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
# 命令树 + 每个命令的参数 schema + 输出 schema
|
|
30
|
-
atlas schema commands --describe
|
|
31
|
-
|
|
32
|
-
# 单命令自省
|
|
33
|
-
atlas <cmd> --describe
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
### 3. 鉴权
|
|
37
|
-
|
|
38
|
-
- `atlas auth status` 返回 `data.loggedIn: boolean`
|
|
39
|
-
- `atlas auth refresh` — 无头模式静默刷新 access_token（依赖 SSO_REFRESH_TOKEN）；session 过期时 agent 先试此命令
|
|
40
|
-
- agent **不能自动执行** `atlas auth login`（弹浏览器做 SSO，非终端环境报 exit 64）
|
|
41
|
-
|
|
42
|
-
### 4. 退出码速查
|
|
43
|
-
|
|
44
|
-
| 码 | 含义 | agent 应对 |
|
|
45
|
-
|----|------|-----------|
|
|
46
|
-
| 0 | 成功 | 继续 |
|
|
47
|
-
| 2 | 会话过期 | 先试 `atlas auth refresh`，失败再让用户手动 login |
|
|
48
|
-
| 3 | API 错误 | 不重试 |
|
|
49
|
-
| 4 | 项目匹配歧义 | 用 `atlas find project` 让用户挑 |
|
|
50
|
-
| 5 | 项目未找到 | 改关键词重试 1 次后报告 |
|
|
51
|
-
| 6 | 限流 | 退避 10s 重试 ≤1 次 |
|
|
52
|
-
| 7 | 网络错误 | 退避 5s 重试 ≤1 次 |
|
|
53
|
-
| 8 | 升级异常 | 忽略 |
|
|
54
|
-
| 64 | 配置/未实现 | 不重试 |
|
|
55
|
-
| 65 | 输出超限 | 改用 `--out <file>` |
|
|
56
|
-
|
|
57
|
-
### 5. Skill 入口
|
|
58
|
-
|
|
59
|
-
完整 agent 行为契约见 [.claude/skills/atlas/SKILL.md](.claude/skills/atlas/SKILL.md)
|
|
60
|
-
|
|
61
|
-
### 6. 数据单位
|
|
62
|
-
|
|
63
|
-
- 所有 `manpower` 字段 = **人月**（不要二次换算）
|
|
64
|
-
- `atlas compare`：`diff = 实际 - 基线`（人月），**不要再除 22**
|
|
65
|
-
- 月份格式 `YYYY-MM`，已修正 CST 偏移
|
|
7
|
+
Node 20+
|