@solarains/va-cli 0.1.1 → 0.1.2
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 +8 -122
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,132 +1,18 @@
|
|
|
1
|
-
# va-cli
|
|
1
|
+
# @solarains/va-cli
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
VisionAlpha CLI.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
defines the command tree, local config and state layout, token-storage
|
|
7
|
-
abstraction, diagnostics path, and placeholder commands that later child
|
|
8
|
-
changes will extend for browser auth, installation binding, and usage queries.
|
|
9
|
-
|
|
10
|
-
Parent architecture references:
|
|
11
|
-
|
|
12
|
-
- `openspec/changes/define-skills-mvp-architecture/proposal.md`
|
|
13
|
-
- `openspec/changes/define-skills-mvp-architecture/design.md`
|
|
14
|
-
- `openspec/changes/define-skills-mvp-architecture/specs/skills-system-architecture/spec.md`
|
|
15
|
-
- `openspec/changes/define-skills-mvp-architecture/master-task-list.md`
|
|
16
|
-
- `openspec/changes/bootstrap-va-cli/design.md`
|
|
17
|
-
- `openspec/changes/add-cli-browser-auth-flow/proposal.md`
|
|
18
|
-
- `openspec/changes/add-cli-browser-auth-flow/design.md`
|
|
19
|
-
|
|
20
|
-
Current command surface:
|
|
21
|
-
|
|
22
|
-
- `vaone init`
|
|
23
|
-
- `vaone auth login`
|
|
24
|
-
- `vaone auth logout`
|
|
25
|
-
- `vaone usage`
|
|
26
|
-
- `vaone doctor`
|
|
27
|
-
|
|
28
|
-
Current auth foundation:
|
|
29
|
-
|
|
30
|
-
- `vaone auth login` now generates PKCE verifier/challenge pairs for a public CLI client
|
|
31
|
-
- the CLI creates or resumes a durable installation identity with ed25519 key material
|
|
32
|
-
- primary completion uses a localhost loopback callback
|
|
33
|
-
- fallback completion prints the browser URL and terminal QR code, then polls the same auth session
|
|
34
|
-
- token persistence stores account id, installation id, session id, access token, and refresh token metadata
|
|
35
|
-
- refresh continuation signs `refreshToken + installationId + signedAt` with the local installation private key
|
|
36
|
-
- revoked installations and invalid installation-proof refresh attempts now resolve to explicit re-login guidance instead of generic refresh failure
|
|
37
|
-
|
|
38
|
-
Current source layout:
|
|
39
|
-
|
|
40
|
-
- `src/cli/` startup, command tree, help rendering
|
|
41
|
-
- `src/commands/` grouped command handlers
|
|
42
|
-
- `src/config/` runtime configuration and endpoint loading
|
|
43
|
-
- `src/features/init/` agent target detection, managed pack generation, init orchestration
|
|
44
|
-
- `src/state/` local path layout and file-backed storage adapters
|
|
45
|
-
- `src/shared/` logging and output helpers
|
|
46
|
-
|
|
47
|
-
## `vaone init`
|
|
48
|
-
|
|
49
|
-
`vaone init` is the supported onboarding path for agent-ready setup. It now:
|
|
50
|
-
|
|
51
|
-
- detects Codex, Claude Code, and OpenClaw install surfaces
|
|
52
|
-
- supports `project` and `user` scope installation
|
|
53
|
-
- installs thin VAOne-managed agent packs that call back into `vaone`
|
|
54
|
-
- chains into `vaone auth login` by default unless `--skip-login` is set
|
|
55
|
-
- runs CLI-native readiness checks before exit
|
|
56
|
-
|
|
57
|
-
Supported flags:
|
|
58
|
-
|
|
59
|
-
- `--agents codex,claude,openclaw`
|
|
60
|
-
- `--scope project|user`
|
|
61
|
-
- `--skip-login`
|
|
62
|
-
- `--force`
|
|
63
|
-
- `--yes`
|
|
64
|
-
|
|
65
|
-
Target-specific install behavior:
|
|
66
|
-
|
|
67
|
-
- Codex: installs `vaone/SKILL.md` under `.codex/skills` or `~/.codex/skills`
|
|
68
|
-
- Claude Code: installs managed files under `.claude/commands`, `.claude/agents`, and `.claude/VAONE.md`
|
|
69
|
-
- OpenClaw: installs `vaone/SKILL.md` under `skills` or `~/.openclaw/skills`
|
|
70
|
-
|
|
71
|
-
Current MVP limits:
|
|
72
|
-
|
|
73
|
-
- Claude Code support is limited to managed command and agent guide files; deeper adapter behavior can be expanded later
|
|
74
|
-
- OpenClaw marketplace plugin packaging is still deferred; this change only installs local skill assets
|
|
75
|
-
- Agents may need a full restart or a new session before they discover newly installed files
|
|
76
|
-
|
|
77
|
-
## Local development
|
|
78
|
-
|
|
79
|
-
```bash
|
|
80
|
-
pnpm install
|
|
81
|
-
pnpm cli -- --help
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
## Validation
|
|
5
|
+
## Install
|
|
85
6
|
|
|
86
7
|
```bash
|
|
87
|
-
|
|
88
|
-
pnpm lint
|
|
89
|
-
pnpm test
|
|
90
|
-
pnpm build
|
|
91
|
-
node dist/main.js --help
|
|
8
|
+
npm install -g @solarains/va-cli
|
|
92
9
|
```
|
|
93
10
|
|
|
94
|
-
##
|
|
95
|
-
|
|
96
|
-
`va-cli` now assembles a dedicated publish root under `dist/publish/` and
|
|
97
|
-
publishes from that directory instead of from the repository root.
|
|
98
|
-
|
|
99
|
-
Useful commands:
|
|
11
|
+
## Usage
|
|
100
12
|
|
|
101
13
|
```bash
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
pnpm verify:publish
|
|
14
|
+
vaone --help
|
|
15
|
+
vaone init
|
|
105
16
|
```
|
|
106
17
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
```bash
|
|
110
|
-
pnpm release:prepare
|
|
111
|
-
pnpm verify:publish
|
|
112
|
-
npm publish dist/publish --access public
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
`pnpm release:prepare` increments the patch version in the root
|
|
116
|
-
`package.json`, then rebuilds `dist/publish/` with the updated version.
|
|
117
|
-
|
|
118
|
-
Before the first real npm publish, add the intended license text at
|
|
119
|
-
`va-cli/LICENSE`. The packaging flow copies that file into `dist/publish/` when
|
|
120
|
-
present.
|
|
121
|
-
|
|
122
|
-
## Git Workflow
|
|
123
|
-
|
|
124
|
-
- 提交信息使用 Conventional Commits,建议以中文描述主要变更,例如 `feat(cli): 增加日报查询命令`
|
|
125
|
-
- 本仓库启用 Husky:
|
|
126
|
-
- `pre-commit` 会执行 `pnpm lint-staged` 和 `pnpm typecheck`
|
|
127
|
-
- `commit-msg` 会执行 `pnpm commitlint --edit`
|
|
128
|
-
- PR 需要填写摘要、背景、验证方式,以及配置 / 认证 / 本地状态影响
|
|
129
|
-
- CLI 相关 PR 请附关键命令示例输出
|
|
130
|
-
- 提交前最少通过:
|
|
131
|
-
- `pnpm lint`
|
|
132
|
-
- `pnpm typecheck`
|
|
18
|
+
Use `vaone ...` to access the CLI command surface.
|