@logicseek/hello-cc 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -16,6 +16,136 @@ the release description from the current changelog section. Use
 `npm run release:github` with `GH_TOKEN` or `GITHUB_TOKEN` only for local
 backfills.
 
+## 0.1.7
+
+### Summary
+
+hello-cc 0.1.7 publishes the post-0.1.6 Web and coordination hardening work
+alongside the README product screenshot. It keeps the 0.1.6 package surface and
+adds stricter peer identity behavior, audited Web peer actions, cleaner tmux
+test isolation, and clearer first-run documentation for the Web console.
+
+### Highlights
+
+- Enforced system-peer identity handling so internal coordination actions stay
+  attributable and do not accidentally inherit a user peer identity.
+- Audited Web peer action flows and expanded regression coverage around task,
+  message, lock, and tmux cleanup paths used by the browser console.
+- Cleaned tmux-focused regression tests so runtime cleanup and test isolation
+  stay stable across repeated local runs.
+- Added a sanitized Web console screenshot to both English and Chinese README
+  files, showing sessions, terminal output, project state, messages, peers,
+  tasks, and locks.
+- Documented that `hcc web` defaults to a LAN-facing `0.0.0.0` bind, requests
+  port `8787`, prints both `open:` and `local:` token URLs, and auto-tries later
+  ports when `--port` is not explicit.
+
+### Compatibility Notes
+
+- No breaking CLI command changes are intended in this release.
+- The Web access model remains token-in-URL based; use `--local` when the Web
+  console should bind only to `127.0.0.1`.
+- This release does not change the public package surface introduced in 0.1.6.
+
+### Validation
+
+The 0.1.7 release should be validated with:
+
+```bash
+git diff --check
+node --check bin/hcc.mjs
+find lib -name '*.mjs' -print0 | xargs -0 -n1 node --check
+node --check scripts/github-release.mjs
+node --check scripts/regression.mjs
+node --check scripts/release-notes.mjs
+npm run release:check
+npm run release:github:dry-run -- --version 0.1.7
+npm pack --dry-run --json
+npm publish --dry-run --registry=https://registry.npmjs.org/ --access public
+npm test
+```
+
+The expected full regression marker is:
+
+```text
+FULL_REGRESSION_OK
+```
+
+## 0.1.6
+
+### Summary
+
+hello-cc 0.1.6 publishes the current architecture-layout cleanup that followed
+0.1.5 and records the split-stack audit that reviewed it. The installed CLI
+behavior remains the public API, while internal helpers now live closer to their
+product boundaries under `core/`, `runtime/`, `web/`, `terminal/`,
+`integrations/`, `ui/`, `release/`, and `shared/`. This release keeps the
+current master history as the publish path; teams that want cleaner refactor
+history should use the documented rebuild-branch option instead.
+
+### Highlights
+
+- Added architecture guidance for the target module layout and documented the
+  package-surface policy: `hcc` and `hello-cc` are the supported public
+  interfaces; deep `lib/` imports are compatibility paths, not user workflows.
+- Added `docs/layout-split-stack-audit.md`, which classifies the local
+  `origin/master..HEAD` stack, calls out the early flat-helper extraction phase,
+  and records the package-surface and follow-up cleanup decisions before
+  publish.
+- Moved peer, task, lock, message, team, timeline, automation, and session
+  helpers into `core/`, `db/`, `runtime/`, `terminal/`, and `integrations/`
+  boundaries while keeping compatibility entrypoints for already-exposed paths.
+- Moved Web runtime, HTTP, UI template, and peer action helpers into `lib/web/`
+  while preserving existing Web console behavior.
+- Moved provider command helpers and Claude/Codex hook and shim setup helpers
+  into `lib/integrations/`, including shim script generation under
+  `lib/integrations/shims/`.
+- Moved JSON and CLI error helpers into `lib/shared/`, release metadata helpers
+  into `lib/release/`, and CLI-facing state/help rendering into `lib/ui/`.
+- Expanded regression guards so module moves verify both the new primary
+  boundary and the compatibility re-export identity.
+
+### Compatibility Notes
+
+- `@logicseek/hello-cc@0.1.5` was already published from git head `4969100`.
+  This release uses a new package version and does not republish `0.1.5`.
+- Top-level `lib/*.mjs` files that were already published in `0.1.5` remain
+  available for this release cycle to avoid breaking deep imports exposed by the
+  package's `files` list.
+- New top-level re-export-only helper paths introduced during the local layout
+  migration are treated as compatibility-only deep-import paths for this
+  release, not as target architecture. New code should prefer the
+  product-boundary modules documented in `docs/architecture.md`.
+- The audit records remaining cleanup items for later focused work, including
+  moving SQL-heavy task store operations out of pure core, removing core/runtime
+  reverse dependencies on top-level formatting or Web helpers, and continuing to
+  split `cmdWeb()` by subsystem instead of by incidental helper names.
+- No breaking CLI command changes are intended in this release.
+
+### Validation
+
+The 0.1.6 release should be validated with:
+
+```bash
+git diff --check
+node --check bin/hcc.mjs
+find lib -name '*.mjs' -print0 | xargs -0 -n1 node --check
+node --check scripts/github-release.mjs
+node --check scripts/regression.mjs
+node --check scripts/release-notes.mjs
+npm run release:check
+npm run release:github:dry-run -- --version 0.1.6
+npm pack --dry-run --json
+npm publish --dry-run --registry=https://registry.npmjs.org/ --access public
+npm test
+```
+
+The expected full regression marker is:
+
+```text
+FULL_REGRESSION_OK
+```
+
 ## 0.1.5
 
 ### Summary

package/README.md

@@ -18,6 +18,14 @@ CLI sessions. It gives every terminal in one project a shared task board,
 mailbox, lock table, and browser console while keeping the real local terminal
 as the source of interaction.
 
+<p align="center">
+  <img src="assets/screenshots/web-console.png" width="900" alt="hello-cc Web console showing agent sessions, task state, locks, messages, and terminal output">
+</p>
+
+<p align="center">
+  <em>One local Web console for tmux-backed Claude Code, Codex, tasks, locks, messages, and handoffs.</em>
+</p>
+
 It is built for developers who run multiple AI coding agents in the same repo
 and need them to coordinate instead of guessing what the other sessions are
 doing.
@@ -81,9 +89,19 @@ hcc web
 ```
 
 Then open the printed URL. By default, `hcc web` listens on LAN interfaces and
-uses a saved URL token, generating one on first use. It initializes the project bus, installs
-Claude/Codex hooks and shims, starts or reuses the Web console, and returns the
-terminal to you.
+requests `0.0.0.0:8787`, using a saved URL token generated on first use. If
+port 8787 is already busy and you did not pass `--port`, it automatically tries
+the next available port. The command prints both the LAN login URL and the local
+loopback URL:
+
+```text
+open: http://<machine-ip>:8787/?token=<saved-token>&project=/path/to/project
+local: http://127.0.0.1:8787/?token=<saved-token>&project=/path/to/project
+```
+
+Use `--local` to bind only to `127.0.0.1`, or `--port N` to request a specific
+port. `hcc web` initializes the project bus, installs Claude/Codex hooks and
+shims, starts or reuses the Web console, and returns the terminal to you.
 
 After the first shim install, open a new terminal or reload your shell:
 

package/README.zh-CN.md

@@ -15,6 +15,14 @@
 
 `hello-cc` 是 Claude Code、Codex 和其他编程 CLI 会话的本地控制平面。它让同一个项目里的终端共享任务板、消息、锁、交接和浏览器控制台，同时保留真实本地终端作为主要交互入口。
 
+<p align="center">
+  <img src="assets/screenshots/web-console.png" width="900" alt="hello-cc Web 控制台，展示 agent 会话、任务状态、锁、消息和终端输出">
+</p>
+
+<p align="center">
+  <em>一个本地 Web 控制台，统一管理 tmux-backed Claude Code、Codex、任务、锁、消息和交接。</em>
+</p>
+
 它适合在同一个仓库里同时运行多个 AI 编程 agent 的场景：让它们知道彼此在做什么，而不是各自猜测。
 
 ## 特色
@@ -69,9 +77,19 @@ cd /path/to/project
 hcc web
 ```
 
-然后打开命令输出里的 URL。默认情况下，`hcc web` 会监听内网地址，并在 URL
-里附带固定 token；首次使用时自动生成并保存，之后默认复用。它会初始化项目总线，
-安装 Claude/Codex hooks 和 shims，启动或复用 Web 控制台，然后把终端还给你。
+然后打开命令输出里的 URL。默认情况下，`hcc web` 会监听内网地址，请求
+`0.0.0.0:8787`，并在 URL 里附带首次自动生成并保存的稳定 token。如果 8787
+端口已被占用，且你没有显式传 `--port`，它会自动尝试后续可用端口。启动时会同时
+打印内网登录地址和本机 loopback 地址：
+
+```text
+open: http://<machine-ip>:8787/?token=<saved-token>&project=/path/to/project
+local: http://127.0.0.1:8787/?token=<saved-token>&project=/path/to/project
+```
+
+使用 `--local` 可以只绑定 `127.0.0.1`，使用 `--port N` 可以指定请求端口。
+`hcc web` 会初始化项目总线，安装 Claude/Codex hooks 和 shims，启动或复用 Web
+控制台，然后把终端还给你。
 
 第一次安装 shim 后，打开新终端或重新加载 shell：