@logicseek/hello-cc 0.1.2 → 0.1.4
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/CHANGELOG.md +145 -3
- package/README.md +4 -1
- package/README.zh-CN.md +5 -1
- package/bin/hcc.mjs +2701 -384
- package/docs/README.md +5 -3
- package/docs/README.zh-CN.md +5 -3
- package/docs/commands.md +38 -7
- package/docs/commands.zh-CN.md +31 -6
- package/docs/design.md +12 -4
- package/docs/guide.md +55 -10
- package/docs/guide.zh-CN.md +47 -9
- package/docs/implementation.md +21 -1
- package/lib/guidance.mjs +115 -0
- package/lib/package-meta.mjs +24 -0
- package/lib/release-notes.mjs +40 -0
- package/package.json +3 -1
- package/scripts/github-release.mjs +152 -0
- package/scripts/regression.mjs +965 -33
- package/scripts/release-notes.mjs +6 -38
package/CHANGELOG.md
CHANGED
|
@@ -8,10 +8,130 @@ Before publishing, run:
|
|
|
8
8
|
```bash
|
|
9
9
|
npm run release:check
|
|
10
10
|
npm run release:notes
|
|
11
|
+
npm run release:github:dry-run
|
|
11
12
|
```
|
|
12
13
|
|
|
13
|
-
|
|
14
|
-
the current
|
|
14
|
+
Pushing a `v*` tag runs the GitHub Release workflow, which creates or updates
|
|
15
|
+
the release description from the current changelog section. Use
|
|
16
|
+
`npm run release:github` with `GH_TOKEN` or `GITHUB_TOKEN` only for local
|
|
17
|
+
backfills.
|
|
18
|
+
|
|
19
|
+
## 0.1.4
|
|
20
|
+
|
|
21
|
+
### Summary
|
|
22
|
+
|
|
23
|
+
hello-cc 0.1.4 publishes the latest Web coordination fixes and a small internal
|
|
24
|
+
module split. The Web console now uses structured peer action APIs instead of
|
|
25
|
+
injecting routine action commands into the terminal, keeps Project State card
|
|
26
|
+
scroll positions stable through refreshes, and refreshes restored tmux panes
|
|
27
|
+
after browser input. Release and guidance helpers are now shared from `lib/`,
|
|
28
|
+
so CLI metadata, release-note parsing, GitHub release publishing, and generated
|
|
29
|
+
coordination guidance have one source of truth.
|
|
30
|
+
|
|
31
|
+
### Highlights
|
|
32
|
+
|
|
33
|
+
- Added `/api/peers/:peer/actions/:action` for Web status, state, inbox,
|
|
34
|
+
task-claim, heartbeat, and registration actions, with an action-result panel
|
|
35
|
+
in the browser UI.
|
|
36
|
+
- Kept explicit terminal command injection available only for the advanced
|
|
37
|
+
terminal status action, so normal Web toolbar actions no longer modify the
|
|
38
|
+
selected session's terminal input.
|
|
39
|
+
- Added collapsible Project State cards for automation, timeline, messages,
|
|
40
|
+
peers, tasks, and locks, with persisted collapsed state and restored per-card
|
|
41
|
+
scroll positions after polling refreshes.
|
|
42
|
+
- Refreshed tmux snapshots shortly after WebSocket input so restored tmux
|
|
43
|
+
sessions show typed input promptly without unsafe browser-side local echo.
|
|
44
|
+
- Disabled stale tmux `pipe-pane` writers before restoring FIFO streaming, so
|
|
45
|
+
restarted Web runtimes can attach to existing panes reliably.
|
|
46
|
+
- Moved package metadata, changelog release helpers, and generated coordination
|
|
47
|
+
guidance into reusable `lib/` modules used by the CLI and release scripts.
|
|
48
|
+
- Expanded regression coverage for Web peer actions, state-card behavior,
|
|
49
|
+
tmux input visibility, packaged helper modules, v-prefixed release-note
|
|
50
|
+
versions, and CLI/package version consistency.
|
|
51
|
+
|
|
52
|
+
### Validation
|
|
53
|
+
|
|
54
|
+
The 0.1.4 release should be validated with:
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
git diff --check
|
|
58
|
+
node --check bin/hcc.mjs
|
|
59
|
+
node --check lib/guidance.mjs
|
|
60
|
+
node --check lib/package-meta.mjs
|
|
61
|
+
node --check lib/release-notes.mjs
|
|
62
|
+
node --check scripts/github-release.mjs
|
|
63
|
+
node --check scripts/regression.mjs
|
|
64
|
+
node --check scripts/release-notes.mjs
|
|
65
|
+
npm run release:check
|
|
66
|
+
npm run release:github:dry-run -- --version 0.1.4
|
|
67
|
+
npm pack --dry-run --json
|
|
68
|
+
npm publish --dry-run --registry=https://registry.npmjs.org/ --access public
|
|
69
|
+
npm test
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
The expected full regression marker is:
|
|
73
|
+
|
|
74
|
+
```text
|
|
75
|
+
FULL_REGRESSION_OK
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## 0.1.3
|
|
79
|
+
|
|
80
|
+
### Summary
|
|
81
|
+
|
|
82
|
+
hello-cc 0.1.3 improves the Web console for day-to-day remote operation and
|
|
83
|
+
hardens the release workflow. The Web UI now supports English/Chinese labels,
|
|
84
|
+
resizable left and right sidebars, remote token defaults, and a cleaner
|
|
85
|
+
resume/session experience. Release notes can now be published automatically from
|
|
86
|
+
the changelog through GitHub Actions, so tag-based releases and manual backfills
|
|
87
|
+
use the same checked release body.
|
|
88
|
+
|
|
89
|
+
### Highlights
|
|
90
|
+
|
|
91
|
+
- Added a Web language selector with English and Chinese labels for the main
|
|
92
|
+
project/session controls, action menu, state panel, detected-session view, and
|
|
93
|
+
status text.
|
|
94
|
+
- Added full-height draggable left and right sidebar dividers while preserving
|
|
95
|
+
the compact collapse buttons and persisted sidebar widths.
|
|
96
|
+
- Reapplied sidebar width clamps after collapse/expand transitions so restored
|
|
97
|
+
panels cannot squeeze the center terminal below its usable width.
|
|
98
|
+
- Kept bare `hcc web` remote-friendly by default with a saved token, while
|
|
99
|
+
preserving `--local` and explicit token/no-token controls.
|
|
100
|
+
- Added provider resume controls and resumable-session selection in the Web
|
|
101
|
+
start form so Claude/Codex resume flows are available from the browser.
|
|
102
|
+
- Added `scripts/github-release.mjs` plus `release:github` and
|
|
103
|
+
`release:github:dry-run` npm scripts to create or update GitHub Releases from
|
|
104
|
+
`CHANGELOG.md`.
|
|
105
|
+
- Added `.github/workflows/github-release.yml` so pushing `v*` tags publishes
|
|
106
|
+
the GitHub Release description with the repository `GITHUB_TOKEN`, and
|
|
107
|
+
`workflow_dispatch` can backfill older releases without a personal token.
|
|
108
|
+
- Tightened generated coordination guidance so read-only reviews do not take
|
|
109
|
+
advisory locks and mutating work remains explicitly locked.
|
|
110
|
+
- Expanded regression coverage for Web i18n, sidebar resizing, release notes,
|
|
111
|
+
GitHub Release automation, and generated coordination guidance.
|
|
112
|
+
|
|
113
|
+
### Validation
|
|
114
|
+
|
|
115
|
+
The 0.1.3 release should be validated with:
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
git diff --check
|
|
119
|
+
node --check bin/hcc.mjs
|
|
120
|
+
node --check scripts/regression.mjs
|
|
121
|
+
node --check scripts/github-release.mjs
|
|
122
|
+
node --check scripts/release-notes.mjs
|
|
123
|
+
npm run release:check
|
|
124
|
+
npm run release:github:dry-run -- --version 0.1.3
|
|
125
|
+
npm pack --dry-run --json
|
|
126
|
+
npm publish --dry-run --registry=https://registry.npmjs.org/ --access public
|
|
127
|
+
npm test
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
The expected full regression marker is:
|
|
131
|
+
|
|
132
|
+
```text
|
|
133
|
+
FULL_REGRESSION_OK
|
|
134
|
+
```
|
|
15
135
|
|
|
16
136
|
## 0.1.2
|
|
17
137
|
|
|
@@ -20,7 +140,9 @@ the current `package.json` version.
|
|
|
20
140
|
hello-cc 0.1.2 tightens the public release surface after the first scoped npm
|
|
21
141
|
publish. It adds a first-class update command, makes uninstall discoverable in
|
|
22
142
|
top-level help, and reorganizes the documentation so the npm package page and
|
|
23
|
-
GitHub release notes have a clear, detailed description of what changed.
|
|
143
|
+
GitHub release notes have a clear, detailed description of what changed. It also
|
|
144
|
+
adds explicit team task orchestration and makes schema migrations cover
|
|
145
|
+
registered project databases.
|
|
24
146
|
|
|
25
147
|
### Highlights
|
|
26
148
|
|
|
@@ -34,6 +156,16 @@ GitHub release notes have a clear, detailed description of what changed.
|
|
|
34
156
|
shims, while `hcc uninstall --purge --yes` is required to remove project data.
|
|
35
157
|
- Split documentation into a short README, a user guide, command reference, and
|
|
36
158
|
documentation index in both English and Chinese.
|
|
159
|
+
- Added `hcc team plan`, `hcc team start`, and `hcc team status` for explicit
|
|
160
|
+
parent-task splits into auditable child tasks.
|
|
161
|
+
- Added task hierarchy metadata so team subtasks remain visible through the
|
|
162
|
+
normal task/state/timeline surfaces.
|
|
163
|
+
- Extended schema migration startup so registered project databases are migrated
|
|
164
|
+
alongside the current project database when the CLI opens state.
|
|
165
|
+
- Changed bare `hcc web` to listen on `0.0.0.0` with a saved URL token by
|
|
166
|
+
default. The token is generated on first use and reused across restarts; use
|
|
167
|
+
`--local` for loopback-only access or `--no-token` only in trusted local/test
|
|
168
|
+
environments.
|
|
37
169
|
- Restored the Star History chart at the bottom of both README files.
|
|
38
170
|
- Included README-linked package assets in the npm tarball so the package page
|
|
39
171
|
renders the project logo correctly.
|
|
@@ -79,3 +211,13 @@ FULL_REGRESSION_OK
|
|
|
79
211
|
Use this changelog section as the source for the GitHub Release notes for
|
|
80
212
|
`v0.1.2`. The npm package metadata keeps a short description, while the package
|
|
81
213
|
README and this changelog provide the detailed release description.
|
|
214
|
+
|
|
215
|
+
Publish or backfill the GitHub Release description with:
|
|
216
|
+
|
|
217
|
+
```bash
|
|
218
|
+
GH_TOKEN=... npm run release:github -- --version 0.1.2
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
After `.github/workflows/github-release.yml` is on the default branch, the same
|
|
222
|
+
backfill can be run from GitHub Actions with `workflow_dispatch` and version
|
|
223
|
+
`0.1.2`, without a personal token.
|
package/README.md
CHANGED
|
@@ -32,6 +32,8 @@ doing.
|
|
|
32
32
|
so agents can answer from current project state.
|
|
33
33
|
- **Conflict avoidance**: advisory locks and handoffs make multi-agent editing
|
|
34
34
|
explicit.
|
|
35
|
+
- **Explicit team splits**: `hcc team plan/start/status` turns one parallel
|
|
36
|
+
task into auditable child tasks without hidden auto-spawning.
|
|
35
37
|
- **Resume-friendly identity**: resumed Claude/Codex sessions map back to
|
|
36
38
|
stable peers when provider session ids are available.
|
|
37
39
|
- **One console, many projects**: one local Web runtime can switch between
|
|
@@ -78,7 +80,8 @@ cd /path/to/project
|
|
|
78
80
|
hcc web
|
|
79
81
|
```
|
|
80
82
|
|
|
81
|
-
Then open the printed
|
|
83
|
+
Then open the printed URL. By default, `hcc web` listens on LAN interfaces and
|
|
84
|
+
uses a saved URL token, generating one on first use. It initializes the project bus, installs
|
|
82
85
|
Claude/Codex hooks and shims, starts or reuses the Web console, and returns the
|
|
83
86
|
terminal to you.
|
|
84
87
|
|
package/README.zh-CN.md
CHANGED
|
@@ -23,6 +23,8 @@
|
|
|
23
23
|
- **Web 控制真实终端**:浏览器 attach 到和本地终端相同的 tmux pane,不是浏览器里另开的临时 shell。
|
|
24
24
|
- **Claude/Codex 感知项目状态**:hooks 会在模型回答前注入实时 `hcc` 状态。
|
|
25
25
|
- **减少编辑冲突**:通过 advisory lock 和 handoff 显式协调多 agent 修改。
|
|
26
|
+
- **显式团队拆分**:`hcc team plan/start/status` 可以把一个并行任务拆成可审计
|
|
27
|
+
子任务,不会隐藏地自动启动进程。
|
|
26
28
|
- **resume 友好的稳定身份**:当 provider 暴露 session id 时,恢复会话会映射回稳定 peer。
|
|
27
29
|
- **一个控制台管理多个项目**:单个本地 Web runtime 可以在多个 project root 之间切换。
|
|
28
30
|
|
|
@@ -67,7 +69,9 @@ cd /path/to/project
|
|
|
67
69
|
hcc web
|
|
68
70
|
```
|
|
69
71
|
|
|
70
|
-
|
|
72
|
+
然后打开命令输出里的 URL。默认情况下,`hcc web` 会监听内网地址,并在 URL
|
|
73
|
+
里附带固定 token;首次使用时自动生成并保存,之后默认复用。它会初始化项目总线,
|
|
74
|
+
安装 Claude/Codex hooks 和 shims,启动或复用 Web 控制台,然后把终端还给你。
|
|
71
75
|
|
|
72
76
|
第一次安装 shim 后,打开新终端或重新加载 shell:
|
|
73
77
|
|