@logicseek/hello-cc 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -0,0 +1,164 @@
+# Changelog
+
+This project keeps one changelog file. Add one section per release, with the
+newest version first. Do not create a new changelog file for every release.
+
+Before publishing, run:
+
+```bash
+npm run release:check
+npm run release:notes
+npm run release:github:dry-run
+```
+
+Pushing a `v*` tag runs the GitHub Release workflow, which creates or updates
+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.3
+
+### Summary
+
+hello-cc 0.1.3 improves the Web console for day-to-day remote operation and
+hardens the release workflow. The Web UI now supports English/Chinese labels,
+resizable left and right sidebars, remote token defaults, and a cleaner
+resume/session experience. Release notes can now be published automatically from
+the changelog through GitHub Actions, so tag-based releases and manual backfills
+use the same checked release body.
+
+### Highlights
+
+- Added a Web language selector with English and Chinese labels for the main
+  project/session controls, action menu, state panel, detected-session view, and
+  status text.
+- Added full-height draggable left and right sidebar dividers while preserving
+  the compact collapse buttons and persisted sidebar widths.
+- Reapplied sidebar width clamps after collapse/expand transitions so restored
+  panels cannot squeeze the center terminal below its usable width.
+- Kept bare `hcc web` remote-friendly by default with a saved token, while
+  preserving `--local` and explicit token/no-token controls.
+- Added provider resume controls and resumable-session selection in the Web
+  start form so Claude/Codex resume flows are available from the browser.
+- Added `scripts/github-release.mjs` plus `release:github` and
+  `release:github:dry-run` npm scripts to create or update GitHub Releases from
+  `CHANGELOG.md`.
+- Added `.github/workflows/github-release.yml` so pushing `v*` tags publishes
+  the GitHub Release description with the repository `GITHUB_TOKEN`, and
+  `workflow_dispatch` can backfill older releases without a personal token.
+- Tightened generated coordination guidance so read-only reviews do not take
+  advisory locks and mutating work remains explicitly locked.
+- Expanded regression coverage for Web i18n, sidebar resizing, release notes,
+  GitHub Release automation, and generated coordination guidance.
+
+### Validation
+
+The 0.1.3 release should be validated with:
+
+```bash
+git diff --check
+node --check bin/hcc.mjs
+node --check scripts/regression.mjs
+node --check scripts/github-release.mjs
+node --check scripts/release-notes.mjs
+npm run release:check
+npm run release:github:dry-run -- --version 0.1.3
+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.2
+
+### Summary
+
+hello-cc 0.1.2 tightens the public release surface after the first scoped npm
+publish. It adds a first-class update command, makes uninstall discoverable in
+top-level help, and reorganizes the documentation so the npm package page and
+GitHub release notes have a clear, detailed description of what changed. It also
+adds explicit team task orchestration and makes schema migrations cover
+registered project databases.
+
+### Highlights
+
+- Added `hcc update`, which updates the global npm install by running
+  `npm install -g @logicseek/hello-cc@latest`.
+- Added `hcc update --tag`, `hcc update --registry`, and `hcc update --dry-run`
+  for controlled upgrades and release verification.
+- Made `hcc uninstall` visible in top-level `hcc --help`, matching the README
+  and command reference.
+- Kept uninstall behavior conservative: `hcc uninstall` removes hooks and
+  shims, while `hcc uninstall --purge --yes` is required to remove project data.
+- Split documentation into a short README, a user guide, command reference, and
+  documentation index in both English and Chinese.
+- Added `hcc team plan`, `hcc team start`, and `hcc team status` for explicit
+  parent-task splits into auditable child tasks.
+- Added task hierarchy metadata so team subtasks remain visible through the
+  normal task/state/timeline surfaces.
+- Extended schema migration startup so registered project databases are migrated
+  alongside the current project database when the CLI opens state.
+- Changed bare `hcc web` to listen on `0.0.0.0` with a saved URL token by
+  default. The token is generated on first use and reused across restarts; use
+  `--local` for loopback-only access or `--no-token` only in trusted local/test
+  environments.
+- Restored the Star History chart at the bottom of both README files.
+- Included README-linked package assets in the npm tarball so the package page
+  renders the project logo correctly.
+
+### Documentation
+
+- `README.md` and `README.zh-CN.md` now focus on product positioning, install
+  and maintenance commands, quick start, a basic workflow, and links to docs.
+- `docs/guide.md` and `docs/guide.zh-CN.md` describe practical usage and avoid
+  embedding the full command list.
+- `docs/commands.md` and `docs/commands.zh-CN.md` provide the compact command
+  reference.
+- `docs/README.md` and `docs/README.zh-CN.md` provide the documentation index.
+- English documentation links now point to English user docs, and Chinese
+  documentation links point to Chinese user docs.
+
+### Validation
+
+The 0.1.2 release should be validated with:
+
+```bash
+git diff --check
+node --check bin/hcc.mjs
+node --check scripts/regression.mjs
+node --check lib/setup.mjs
+node --check lib/discover.mjs
+npm pack --dry-run --json
+npm publish --dry-run --registry=https://registry.npmjs.org/ --access public
+npm test
+```
+
+The package dry run should include `CHANGELOG.md`, `assets/logo.svg`, and the
+English and Chinese command reference files.
+
+The expected full regression marker is:
+
+```text
+FULL_REGRESSION_OK
+```
+
+### Release Notes Source
+
+Use this changelog section as the source for the GitHub Release notes for
+`v0.1.2`. The npm package metadata keeps a short description, while the package
+README and this changelog provide the detailed release description.
+
+Publish or backfill the GitHub Release description with:
+
+```bash
+GH_TOKEN=... npm run release:github -- --version 0.1.2
+```
+
+After `.github/workflows/github-release.yml` is on the default branch, the same
+backfill can be run from GitHub Actions with `workflow_dispatch` and version
+`0.1.2`, without a personal token.

package/README.md

@@ -32,12 +32,14 @@ doing.
   so agents can answer from current project state.
 - **Conflict avoidance**: advisory locks and handoffs make multi-agent editing
   explicit.
+- **Explicit team splits**: `hcc team plan/start/status` turns one parallel
+  task into auditable child tasks without hidden auto-spawning.
 - **Resume-friendly identity**: resumed Claude/Codex sessions map back to
   stable peers when provider session ids are available.
 - **One console, many projects**: one local Web runtime can switch between
   registered project roots.
 
-## Install
+## Install And Manage
 
 Node.js 24 or newer is required.
 
@@ -48,7 +50,7 @@ npm install -g @logicseek/hello-cc
 Update an existing global install:
 
 ```bash
-npm install -g @logicseek/hello-cc@latest
+hcc update
 ```
 
 Or run it without a global install:
@@ -57,6 +59,18 @@ Or run it without a global install:
 npx @logicseek/hello-cc web
 ```
 
+Remove hooks and shims from this machine:
+
+```bash
+hcc uninstall
+```
+
+Remove the global npm package:
+
+```bash
+npm uninstall -g @logicseek/hello-cc
+```
+
 ## Quick Start
 
 Run this inside the project you want agents to share:
@@ -66,7 +80,8 @@ cd /path/to/project
 hcc web
 ```
 
-Then open the printed local URL. `hcc web` initializes the project bus, installs
+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.
 
@@ -110,12 +125,14 @@ generic session-isolation assumptions.
 
 ## Documentation
 
-- [User Guide](docs/guide.md): setup, Web console, commands, workflows, and
-  environment behavior.
+- [Documentation Index](docs/README.md): all user and implementation docs.
+- [User Guide](docs/guide.md): setup, Web console, workflows, coordination
+  semantics, and environment behavior.
+- [Command Reference](docs/commands.md): compact public command list.
+- [Changelog](CHANGELOG.md): release notes for published versions.
 - [Design Notes](docs/design.md): product boundaries and coordination model.
 - [Implementation Notes](docs/implementation.md): architecture and internal
   protocol.
-- [中文用户指南](docs/guide.zh-CN.md)
 
 ## Testing
 
@@ -129,3 +146,11 @@ temporary tmux sessions, and a temporary Web runtime to test the main flows.
 ## License
 
 [Apache-2.0](LICENSE)
+
+---
+
+<p align="center">
+  <a href="https://star-history.com/#Dullne/hello-cc&Date">
+    <img src="https://api.star-history.com/svg?repos=Dullne/hello-cc&type=Date" width="600" alt="Star History Chart">
+  </a>
+</p>

package/README.zh-CN.md

@@ -23,10 +23,12 @@
 - **Web 控制真实终端**：浏览器 attach 到和本地终端相同的 tmux pane，不是浏览器里另开的临时 shell。
 - **Claude/Codex 感知项目状态**：hooks 会在模型回答前注入实时 `hcc` 状态。
 - **减少编辑冲突**：通过 advisory lock 和 handoff 显式协调多 agent 修改。
+- **显式团队拆分**：`hcc team plan/start/status` 可以把一个并行任务拆成可审计
+  子任务，不会隐藏地自动启动进程。
 - **resume 友好的稳定身份**：当 provider 暴露 session id 时，恢复会话会映射回稳定 peer。
 - **一个控制台管理多个项目**：单个本地 Web runtime 可以在多个 project root 之间切换。
 
-## 安装
+## 安装和维护
 
 需要 Node.js 24 或更新版本。
 
@@ -37,7 +39,7 @@ npm install -g @logicseek/hello-cc
 更新已有的全局安装：
 
 ```bash
-npm install -g @logicseek/hello-cc@latest
+hcc update
 ```
 
 也可以不全局安装，直接运行：
@@ -46,6 +48,18 @@ npm install -g @logicseek/hello-cc@latest
 npx @logicseek/hello-cc web
 ```
 
+移除本机 hooks 和 shims：
+
+```bash
+hcc uninstall
+```
+
+移除全局 npm 包：
+
+```bash
+npm uninstall -g @logicseek/hello-cc
+```
+
 ## 快速开始
 
 在需要多个 agent 共享状态的项目中运行：
@@ -55,7 +69,9 @@ cd /path/to/project
 hcc web
 ```
 
-然后打开命令输出里的本地 URL。`hcc web` 会初始化项目总线，安装 Claude/Codex hooks 和 shims，启动或复用 Web 控制台，然后把终端还给你。
+然后打开命令输出里的 URL。默认情况下，`hcc web` 会监听内网地址，并在 URL
+里附带固定 token；首次使用时自动生成并保存，之后默认复用。它会初始化项目总线，
+安装 Claude/Codex hooks 和 shims，启动或复用 Web 控制台，然后把终端还给你。
 
 第一次安装 shim 后，打开新终端或重新加载 shell：
 
@@ -95,10 +111,10 @@ hcc task done --id 1 --summary "Done"
 
 ## 文档
 
-- [用户指南](docs/guide.zh-CN.md)：安装、Web 控制台、常用命令、协作流程和环境变量行为。
-- [设计说明](docs/design.md)：产品边界和协作模型。
-- [实现说明](docs/implementation.md)：架构和内部协议。
-- [English User Guide](docs/guide.md)
+- [文档目录](docs/README.zh-CN.md)：全部用户文档和实现文档入口。
+- [用户指南](docs/guide.zh-CN.md)：安装、Web 控制台、协作流程、协作语义和环境变量行为。
+- [命令参考](docs/commands.zh-CN.md)：紧凑公共命令清单。
+- [更新日志](CHANGELOG.md)：已发布版本的 release notes。
 
 ## 测试
 
@@ -111,3 +127,11 @@ npm test
 ## License
 
 [Apache-2.0](LICENSE)
+
+---
+
+<p align="center">
+  <a href="https://star-history.com/#Dullne/hello-cc&Date">
+    <img src="https://api.star-history.com/svg?repos=Dullne/hello-cc&type=Date" width="600" alt="Star History Chart">
+  </a>
+</p>

package/assets/logo.svg

@@ -0,0 +1,84 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 240 240" width="240" height="240">
+  <defs>
+    <filter id="outerGlow" x="-10%" y="-10%" width="120%" height="120%">
+      <feGaussianBlur stdDeviation="4" result="blur"/>
+      <feMerge><feMergeNode in="blur"/><feMergeNode in="SourceGraphic"/></feMerge>
+    </filter>
+    <radialGradient id="bgGrad" cx="40%" cy="35%" r="70%">
+      <stop offset="0%" stop-color="#1a2028"/>
+      <stop offset="100%" stop-color="#0a0c0f"/>
+    </radialGradient>
+    <!-- Text gradient: white → teal, connects wordmark to mesh -->
+    <linearGradient id="textGrad" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0%" stop-color="#eef2f6"/>
+      <stop offset="100%" stop-color="#40c4aa"/>
+    </linearGradient>
+  </defs>
+
+  <!-- Badge -->
+  <circle cx="120" cy="120" r="114" fill="url(#bgGrad)" filter="url(#outerGlow)"/>
+  <circle cx="120" cy="120" r="113" fill="none" stroke="#303640" stroke-width="1.5"/>
+  <circle cx="120" cy="120" r="105" fill="none" stroke="#40c4aa" stroke-width="0.4" opacity="0.25"/>
+
+  <!--
+    Mesh pentagon — center (120, 108), circumradius R=65
+    Shifted down 8px from previous (was 100) for visual balance
+
+    Top:          (120,  43)
+    Upper-right:  (182,  88)
+    Lower-right:  (158, 161)
+    Lower-left:   ( 82, 161)
+    Upper-left:   ( 58,  88)
+  -->
+
+  <!-- Connections -->
+  <g stroke="#40c4aa" stroke-width="1.4" opacity="0.20" fill="none">
+    <line x1="120" y1="43"  x2="182" y2="88"/>
+    <line x1="120" y1="43"  x2="158" y2="161"/>
+    <line x1="120" y1="43"  x2="82"  y2="161"/>
+    <line x1="120" y1="43"  x2="58"  y2="88"/>
+    <line x1="182" y1="88"  x2="158" y2="161"/>
+    <line x1="182" y1="88"  x2="82"  y2="161"/>
+    <line x1="182" y1="88"  x2="58"  y2="88"/>
+    <line x1="158" y1="161" x2="82"  y2="161"/>
+    <line x1="158" y1="161" x2="58"  y2="88"/>
+    <line x1="82"  y1="161" x2="58"  y2="88"/>
+  </g>
+
+  <!-- Spoke lines from center hub -->
+  <g stroke="#40c4aa" stroke-width="0.8" opacity="0.12">
+    <line x1="120" y1="108" x2="120" y2="43"/>
+    <line x1="120" y1="108" x2="182" y2="88"/>
+    <line x1="120" y1="108" x2="158" y2="161"/>
+    <line x1="120" y1="108" x2="82"  y2="161"/>
+    <line x1="120" y1="108" x2="58"  y2="88"/>
+  </g>
+
+  <!-- Node halos — all equal (flat peer mesh, no hierarchy) -->
+  <circle cx="120" cy="43"  r="14" fill="none" stroke="#40c4aa" stroke-width="1" opacity="0.20"/>
+  <circle cx="182" cy="88"  r="14" fill="none" stroke="#40c4aa" stroke-width="1" opacity="0.20"/>
+  <circle cx="158" cy="161" r="14" fill="none" stroke="#40c4aa" stroke-width="1" opacity="0.20"/>
+  <circle cx="82"  cy="161" r="14" fill="none" stroke="#40c4aa" stroke-width="1" opacity="0.20"/>
+  <circle cx="58"  cy="88"  r="14" fill="none" stroke="#40c4aa" stroke-width="1" opacity="0.20"/>
+
+  <!-- All 5 nodes — same size, same style -->
+  <circle cx="120" cy="43"  r="10" fill="#40c4aa" opacity="0.85"/>
+  <circle cx="182" cy="88"  r="10" fill="#40c4aa" opacity="0.85"/>
+  <circle cx="158" cy="161" r="10" fill="#40c4aa" opacity="0.85"/>
+  <circle cx="82"  cy="161" r="10" fill="#40c4aa" opacity="0.85"/>
+  <circle cx="58"  cy="88"  r="10" fill="#40c4aa" opacity="0.85"/>
+
+  <!-- Center hub -->
+  <circle cx="120" cy="108" r="6" fill="#8ee8d8" opacity="1.0"/>
+
+  <!-- "hcc" wordmark -->
+  <text
+    x="120" y="210"
+    font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace"
+    font-size="30"
+    font-weight="700"
+    fill="url(#textGrad)"
+    text-anchor="middle"
+    letter-spacing="5"
+  >hcc</text>
+</svg>