@logicseek/hello-cc 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -16,6 +16,110 @@ 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.8
+
+### Summary
+
+hello-cc 0.1.8 is a targeted patch release for Claude/Codex shim
+self-repair. It fixes generated shims that could stay pinned to a removed
+provider binary after Claude or Codex was reinstalled.
+
+### Highlights
+
+- Fixed `hcc shim ensure` so it only reuses an existing `# Real binary:` path
+  when that binary still exists.
+- Preserved the existing fast path for valid generated shims while falling back
+  to the requested binary or rediscovering the provider from `PATH` when the
+  recorded path is stale.
+- Added regression coverage for the reinstall case where a generated shim
+  points at a deleted provider binary but a working provider is available on
+  `PATH`.
+
+### Compatibility Notes
+
+- No CLI command or package surface changes are intended in this release.
+- Existing generated shims will self-heal on the next `hcc shim ensure` or shim
+  launch when their recorded provider binary has disappeared.
+
+### Validation
+
+The 0.1.8 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.8
+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.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

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.
@@ -41,7 +49,12 @@ doing.
 
 ## Install And Manage
 
-Node.js 24 or newer is required.
+hello-cc supports Linux and macOS. Node.js 24 or newer is required, and
+browser-controllable terminals require `tmux`. Native Windows shells are not
+currently supported; use WSL for a Linux-like environment.
+
+Linux has richer process auto-discovery through `/proc`. On macOS, use
+hello-cc shims or `hcc peer start` for reliable tmux-managed terminal sessions.
 
 ```bash
 npm install -g @logicseek/hello-cc
@@ -59,7 +72,7 @@ Or run it without a global install:
 npx @logicseek/hello-cc web
 ```
 
-Remove hooks and shims from this machine:
+Remove hooks, shims, and the shell PATH entry from this machine:
 
 ```bash
 hcc uninstall
@@ -81,16 +94,27 @@ 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:
 
-After the first shim install, open a new terminal or reload your shell:
-
-```bash
-source ~/.bashrc
+```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 the rc file for
+your shell:
+
+- bash: `source ~/.bashrc`
+- zsh: `source ~/.zshrc`
+- fish: `source ~/.config/fish/config.fish`
+
 Start normal agent sessions from the project:
 
 ```bash

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 的场景：让它们知道彼此在做什么，而不是各自猜测。
 
 ## 特色
@@ -30,7 +38,11 @@
 
 ## 安装和维护
 
-需要 Node.js 24 或更新版本。
+hello-cc 支持 Linux 和 macOS。需要 Node.js 24 或更新版本；可被浏览器控制的
+终端需要 `tmux`。当前不支持原生 Windows shell；Windows 用户建议使用 WSL。
+
+Linux 可以通过 `/proc` 做更完整的进程自动发现。macOS 上建议通过 hello-cc
+shim 或 `hcc peer start` 启动会话，以获得可靠的 tmux 托管终端。
 
 ```bash
 npm install -g @logicseek/hello-cc
@@ -48,7 +60,7 @@ hcc update
 npx @logicseek/hello-cc web
 ```
 
-移除本机 hooks 和 shims：
+移除本机 hooks、shims 和 shell PATH 配置：
 
 ```bash
 hcc uninstall
@@ -69,16 +81,26 @@ 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 地址：
 
-第一次安装 shim 后，打开新终端或重新加载 shell：
-
-```bash
-source ~/.bashrc
+```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 重新加载配置：
+
+- bash: `source ~/.bashrc`
+- zsh: `source ~/.zshrc`
+- fish: `source ~/.config/fish/config.fish`
+
 在项目目录中正常启动 agent：
 
 ```bash