@logicseek/hello-cc 0.1.7 → 0.1.8

package/CHANGELOG.md

@@ -16,6 +16,55 @@ 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

package/README.md

@@ -49,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
@@ -67,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
@@ -103,11 +108,12 @@ 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:
+After the first shim install, open a new terminal or reload the rc file for
+your shell:
 
-```bash
-source ~/.bashrc
-```
+- bash: `source ~/.bashrc`
+- zsh: `source ~/.zshrc`
+- fish: `source ~/.config/fish/config.fish`
 
 Start normal agent sessions from the project:
 

package/README.zh-CN.md

@@ -38,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
@@ -56,7 +60,7 @@ hcc update
 npx @logicseek/hello-cc web
 ```
 
-移除本机 hooks 和 shims：
+移除本机 hooks、shims 和 shell PATH 配置：
 
 ```bash
 hcc uninstall
@@ -91,11 +95,11 @@ local: http://127.0.0.1:8787/?token=<saved-token>&project=/path/to/project
 `hcc web` 会初始化项目总线，安装 Claude/Codex hooks 和 shims，启动或复用 Web
 控制台，然后把终端还给你。
 
-第一次安装 shim 后，打开新终端或重新加载 shell：
+第一次安装 shim 后，打开新终端，或根据当前 shell 重新加载配置：
 
-```bash
-source ~/.bashrc
-```
+- bash: `source ~/.bashrc`
+- zsh: `source ~/.zshrc`
+- fish: `source ~/.config/fish/config.fish`
 
 在项目目录中正常启动 agent：