@logicseek/hello-cc 0.1.4 → 0.1.6

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.
Files changed (90) hide show
  1. package/CHANGELOG.md +126 -0
  2. package/bin/hcc.mjs +2739 -6482
  3. package/docs/README.md +2 -0
  4. package/docs/README.zh-CN.md +3 -1
  5. package/docs/architecture-split-review.md +217 -0
  6. package/docs/architecture.md +385 -0
  7. package/docs/architecture.zh-CN.md +364 -0
  8. package/docs/commands.md +21 -9
  9. package/docs/commands.zh-CN.md +19 -9
  10. package/docs/layout-split-stack-audit.md +298 -0
  11. package/lib/automation.mjs +8 -0
  12. package/lib/cli-args.mjs +89 -0
  13. package/lib/cli-runtime.mjs +44 -0
  14. package/lib/coordination-state.mjs +218 -0
  15. package/lib/core/coordination/automation.mjs +222 -0
  16. package/lib/core/coordination/locks.mjs +46 -0
  17. package/lib/core/coordination/messages.mjs +116 -0
  18. package/lib/core/coordination/tasks.mjs +224 -0
  19. package/lib/core/coordination/teams.mjs +73 -0
  20. package/lib/core/coordination/timeline.mjs +187 -0
  21. package/lib/core/peers/bindings.mjs +83 -0
  22. package/lib/core/peers/format.mjs +13 -0
  23. package/lib/core/peers/identity.mjs +53 -0
  24. package/lib/core/peers/liveness.mjs +90 -0
  25. package/lib/core/peers/reconcile.mjs +238 -0
  26. package/lib/core/peers/session.mjs +14 -0
  27. package/lib/core/sessions/launch.mjs +89 -0
  28. package/lib/db/schema.mjs +324 -0
  29. package/lib/db/stores/peers.mjs +231 -0
  30. package/lib/db-schema.mjs +7 -0
  31. package/lib/errors.mjs +1 -0
  32. package/lib/format.mjs +39 -0
  33. package/lib/guidance.mjs +10 -2
  34. package/lib/handoff.mjs +26 -0
  35. package/lib/help.mjs +3 -0
  36. package/lib/integrations/hooks.mjs +171 -0
  37. package/lib/integrations/peers/identity.mjs +208 -0
  38. package/lib/integrations/peers/processes.mjs +151 -0
  39. package/lib/integrations/providers.mjs +282 -0
  40. package/lib/integrations/shims/script.mjs +384 -0
  41. package/lib/integrations/shims.mjs +106 -0
  42. package/lib/json-file.mjs +1 -0
  43. package/lib/locks.mjs +10 -0
  44. package/lib/messages.mjs +3 -0
  45. package/lib/package-meta.mjs +6 -24
  46. package/lib/peer-bindings.mjs +14 -0
  47. package/lib/peer-format.mjs +4 -0
  48. package/lib/peer-identity.mjs +15 -0
  49. package/lib/project-context.mjs +6 -0
  50. package/lib/project-registry.mjs +7 -0
  51. package/lib/provider-commands.mjs +13 -0
  52. package/lib/release/package-meta.mjs +31 -0
  53. package/lib/release/release-notes.mjs +40 -0
  54. package/lib/release-notes.mjs +6 -40
  55. package/lib/runtime/client.mjs +42 -0
  56. package/lib/runtime/paths.mjs +45 -0
  57. package/lib/runtime/project-context.mjs +32 -0
  58. package/lib/runtime/projects.mjs +76 -0
  59. package/lib/runtime/state.mjs +128 -0
  60. package/lib/runtime-client.mjs +3 -0
  61. package/lib/runtime-paths.mjs +11 -0
  62. package/lib/runtime-state.mjs +11 -0
  63. package/lib/session-launch.mjs +17 -0
  64. package/lib/setup.mjs +18 -765
  65. package/lib/shared/errors.mjs +7 -0
  66. package/lib/shared/json-file.mjs +14 -0
  67. package/lib/shell-path.mjs +69 -0
  68. package/lib/shim-script.mjs +1 -0
  69. package/lib/state-render.mjs +5 -0
  70. package/lib/task-cli.mjs +45 -0
  71. package/lib/task-liveness.mjs +8 -0
  72. package/lib/task-store.mjs +3 -0
  73. package/lib/team-planning.mjs +7 -0
  74. package/lib/terminal/tmux.mjs +372 -0
  75. package/lib/timeline.mjs +12 -0
  76. package/lib/tmux.mjs +18 -0
  77. package/lib/ui/help.mjs +419 -0
  78. package/lib/ui/state-render.mjs +61 -0
  79. package/lib/web/http.mjs +55 -0
  80. package/lib/web/peer-actions.mjs +270 -0
  81. package/lib/web/runtime.mjs +154 -0
  82. package/lib/web/ui-template.mjs +2055 -0
  83. package/lib/web-http.mjs +7 -0
  84. package/lib/web-peer-actions.mjs +3 -0
  85. package/lib/web-runtime.mjs +17 -0
  86. package/lib/web-ui-template.mjs +3 -0
  87. package/package.json +1 -1
  88. package/scripts/github-release.mjs +2 -2
  89. package/scripts/regression.mjs +2738 -22
  90. package/scripts/release-notes.mjs +2 -2
package/CHANGELOG.md CHANGED
@@ -16,6 +16,132 @@ the release description from the current changelog section. Use
16
16
  `npm run release:github` with `GH_TOKEN` or `GITHUB_TOKEN` only for local
17
17
  backfills.
18
18
 
19
+ ## 0.1.6
20
+
21
+ ### Summary
22
+
23
+ hello-cc 0.1.6 publishes the current architecture-layout cleanup that followed
24
+ 0.1.5 and records the split-stack audit that reviewed it. The installed CLI
25
+ behavior remains the public API, while internal helpers now live closer to their
26
+ product boundaries under `core/`, `runtime/`, `web/`, `terminal/`,
27
+ `integrations/`, `ui/`, `release/`, and `shared/`. This release keeps the
28
+ current master history as the publish path; teams that want cleaner refactor
29
+ history should use the documented rebuild-branch option instead.
30
+
31
+ ### Highlights
32
+
33
+ - Added architecture guidance for the target module layout and documented the
34
+ package-surface policy: `hcc` and `hello-cc` are the supported public
35
+ interfaces; deep `lib/` imports are compatibility paths, not user workflows.
36
+ - Added `docs/layout-split-stack-audit.md`, which classifies the local
37
+ `origin/master..HEAD` stack, calls out the early flat-helper extraction phase,
38
+ and records the package-surface and follow-up cleanup decisions before
39
+ publish.
40
+ - Moved peer, task, lock, message, team, timeline, automation, and session
41
+ helpers into `core/`, `db/`, `runtime/`, `terminal/`, and `integrations/`
42
+ boundaries while keeping compatibility entrypoints for already-exposed paths.
43
+ - Moved Web runtime, HTTP, UI template, and peer action helpers into `lib/web/`
44
+ while preserving existing Web console behavior.
45
+ - Moved provider command helpers and Claude/Codex hook and shim setup helpers
46
+ into `lib/integrations/`, including shim script generation under
47
+ `lib/integrations/shims/`.
48
+ - Moved JSON and CLI error helpers into `lib/shared/`, release metadata helpers
49
+ into `lib/release/`, and CLI-facing state/help rendering into `lib/ui/`.
50
+ - Expanded regression guards so module moves verify both the new primary
51
+ boundary and the compatibility re-export identity.
52
+
53
+ ### Compatibility Notes
54
+
55
+ - `@logicseek/hello-cc@0.1.5` was already published from git head `4969100`.
56
+ This release uses a new package version and does not republish `0.1.5`.
57
+ - Top-level `lib/*.mjs` files that were already published in `0.1.5` remain
58
+ available for this release cycle to avoid breaking deep imports exposed by the
59
+ package's `files` list.
60
+ - New top-level re-export-only helper paths introduced during the local layout
61
+ migration are treated as compatibility-only deep-import paths for this
62
+ release, not as target architecture. New code should prefer the
63
+ product-boundary modules documented in `docs/architecture.md`.
64
+ - The audit records remaining cleanup items for later focused work, including
65
+ moving SQL-heavy task store operations out of pure core, removing core/runtime
66
+ reverse dependencies on top-level formatting or Web helpers, and continuing to
67
+ split `cmdWeb()` by subsystem instead of by incidental helper names.
68
+ - No breaking CLI command changes are intended in this release.
69
+
70
+ ### Validation
71
+
72
+ The 0.1.6 release should be validated with:
73
+
74
+ ```bash
75
+ git diff --check
76
+ node --check bin/hcc.mjs
77
+ find lib -name '*.mjs' -print0 | xargs -0 -n1 node --check
78
+ node --check scripts/github-release.mjs
79
+ node --check scripts/regression.mjs
80
+ node --check scripts/release-notes.mjs
81
+ npm run release:check
82
+ npm run release:github:dry-run -- --version 0.1.6
83
+ npm pack --dry-run --json
84
+ npm publish --dry-run --registry=https://registry.npmjs.org/ --access public
85
+ npm test
86
+ ```
87
+
88
+ The expected full regression marker is:
89
+
90
+ ```text
91
+ FULL_REGRESSION_OK
92
+ ```
93
+
94
+ ## 0.1.5
95
+
96
+ ### Summary
97
+
98
+ hello-cc 0.1.5 publishes the Web runtime split that landed after 0.1.4. The
99
+ CLI keeps the same user-facing Web behavior, while runtime URLs, request
100
+ parsing, HTTP response helpers, and the browser UI template now live in focused
101
+ `lib/` modules. This release also includes the latest coordination automation
102
+ improvements for stale task owners, batch task claims, and takeover-ready task
103
+ state.
104
+
105
+ ### Highlights
106
+
107
+ - Added batch task claiming and takeover policy support for blocked or stale
108
+ work, including owner liveness details in task/state output.
109
+ - Fixed detected-peer Web controls so active `working` or `idle` peers show the
110
+ correct stop action instead of being treated as restart-only peers.
111
+ - Kept stop-dialog labels tied into Web i18n so language changes update the
112
+ dialog controls consistently.
113
+ - Extracted Web runtime URL/token helpers into `lib/web-runtime.mjs`.
114
+ - Extracted the browser UI template into `lib/web-ui-template.mjs`.
115
+ - Extracted low-level Web HTTP helpers into `lib/web-http.mjs`.
116
+ - Expanded regression coverage for the new helper modules, packaged module
117
+ contents, Web display guards, and release/package checks.
118
+
119
+ ### Validation
120
+
121
+ The 0.1.5 release should be validated with:
122
+
123
+ ```bash
124
+ git diff --check
125
+ node --check bin/hcc.mjs
126
+ node --check lib/web-http.mjs
127
+ node --check lib/web-runtime.mjs
128
+ node --check lib/web-ui-template.mjs
129
+ node --check scripts/github-release.mjs
130
+ node --check scripts/regression.mjs
131
+ node --check scripts/release-notes.mjs
132
+ npm run release:check
133
+ npm run release:github:dry-run -- --version 0.1.5
134
+ npm pack --dry-run --json
135
+ npm publish --dry-run --registry=https://registry.npmjs.org/ --access public
136
+ npm test
137
+ ```
138
+
139
+ The expected full regression marker is:
140
+
141
+ ```text
142
+ FULL_REGRESSION_OK
143
+ ```
144
+
19
145
  ## 0.1.4
20
146
 
21
147
  ### Summary