@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.
Files changed (2) hide show
  1. package/README.md +8 -122
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,132 +1,18 @@
1
- # va-cli
1
+ # @solarains/va-cli
2
2
 
3
- Bootstrap CLI for the new VAOne product.
3
+ VisionAlpha CLI.
4
4
 
5
- This project intentionally starts as a runnable but business-light CLI shell. It
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
- pnpm typecheck
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
- ## npm release packaging
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
- pnpm build:publish
103
- pnpm pack:publish
104
- pnpm verify:publish
14
+ vaone --help
15
+ vaone init
105
16
  ```
106
17
 
107
- Release flow:
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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@solarains/va-cli",
3
- "version": "0.1.1",
3
+ "version": "0.1.2",
4
4
  "description": "Bootstrap CLI for the VAOne product.",
5
5
  "bin": {
6
6
  "vaone": "dist/main.js"