@galaxy-stack/blackhole-cli 3.0.13 → 3.0.14

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 (69) hide show
  1. package/CHANGELOG.md +971 -0
  2. package/README.md +12 -11
  3. package/dist/harness/install-command.js +2 -2
  4. package/dist/harness/install-command.js.map +1 -1
  5. package/dist/harness/install.d.ts +1 -1
  6. package/dist/harness/install.js +1 -1
  7. package/dist/harness/locate.d.ts +9 -3
  8. package/dist/harness/locate.d.ts.map +1 -1
  9. package/dist/harness/locate.js +39 -7
  10. package/dist/harness/locate.js.map +1 -1
  11. package/dist/harness/node-runtime.d.ts +37 -3
  12. package/dist/harness/node-runtime.d.ts.map +1 -1
  13. package/dist/harness/node-runtime.js +60 -14
  14. package/dist/harness/node-runtime.js.map +1 -1
  15. package/dist/harness/process.d.ts +1 -1
  16. package/dist/harness/process.d.ts.map +1 -1
  17. package/dist/harness/process.js +14 -5
  18. package/dist/harness/process.js.map +1 -1
  19. package/dist/migrate.d.ts +20 -12
  20. package/dist/migrate.d.ts.map +1 -1
  21. package/dist/migrate.js +39 -67
  22. package/dist/migrate.js.map +1 -1
  23. package/dist/options.d.ts +1 -1
  24. package/dist/options.d.ts.map +1 -1
  25. package/dist/options.js +1 -1
  26. package/dist/web/command.d.ts +1 -1
  27. package/dist/web/command.js +3 -3
  28. package/dist/web/command.js.map +1 -1
  29. package/dist/web/doctor.js +5 -5
  30. package/dist/web/doctor.js.map +1 -1
  31. package/dist/web/options.js +2 -2
  32. package/dist/web/options.js.map +1 -1
  33. package/dist/web/web.d.ts +6 -4
  34. package/dist/web/web.d.ts.map +1 -1
  35. package/dist/web/web.js +10 -8
  36. package/dist/web/web.js.map +1 -1
  37. package/package.json +4 -6
  38. package/dist/web/dsh.d.ts +0 -51
  39. package/dist/web/dsh.d.ts.map +0 -1
  40. package/dist/web/dsh.js +0 -149
  41. package/dist/web/dsh.js.map +0 -1
  42. package/web/brand/app-icon-192.png +0 -0
  43. package/web/brand/app-icon-512.png +0 -0
  44. package/web/brand/client.template.js +0 -1259
  45. package/web/brand/dsh-locale-keys.json +0 -8659
  46. package/web/brand/favicon.png +0 -0
  47. package/web/brand/favicon.svg +0 -12
  48. package/web/brand/lib/app-icons.js +0 -3
  49. package/web/brand/lib/client.js +0 -5161
  50. package/web/brand/lib/favicon.js +0 -1
  51. package/web/brand/lib/index.d.ts +0 -3
  52. package/web/brand/lib/index.js +0 -1068
  53. package/web/brand/lib/journey-host.js +0 -288
  54. package/web/brand/lib/journey-run.d.ts +0 -70
  55. package/web/brand/lib/journey-run.js +0 -344
  56. package/web/brand/lib/journey-store.d.ts +0 -61
  57. package/web/brand/lib/journey-store.js +0 -183
  58. package/web/brand/lib/session-store.d.ts +0 -54
  59. package/web/brand/lib/session-store.js +0 -288
  60. package/web/brand/logo.png +0 -0
  61. package/web/brand/logo.svg +0 -20
  62. package/web/brand/package.json +0 -35
  63. package/web/brand/panel/journey-panel.js +0 -1037
  64. package/web/brand/vi-same-by-design.json +0 -112
  65. package/web/brand/vi.locales.json +0 -2867
  66. package/web/brand/zalo.jpg +0 -0
  67. package/web/patches/gbh-brand.patch.yml +0 -13
  68. package/web/patches/gbh-ui.patch.yml +0 -7
  69. package/web/patches/gbh-web.patch.yml +0 -124
package/CHANGELOG.md ADDED
@@ -0,0 +1,971 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [3.0.14] - 2026-11-19 22:45 +0700
9
+
10
+ Một lệnh `npm i -g` giờ mang **cả CLI lẫn harness**, theo đúng mô hình `@deepseek-ai/dsh`
11
+ (package nhỏ + dependency graph, không nhúng kernel vào tarball).
12
+
13
+ ### Added
14
+
15
+ - **`@galaxy-blackhole/blackhole-harness` là dependency của CLI** (`^0.1.4`). `npm i -g
16
+ @galaxy-stack/blackhole-cli` cài CLI + harness + kernel trong một lệnh; không cần chạy
17
+ `blackhole harness install` cho máy mới.
18
+ - **Bậc dò `dependency` trong `src/harness/locate.ts`** (sau `GBH_TAURI_ROOT`, trước slot
19
+ `~/.galaxy/harness`): resolve `@galaxy-blackhole/blackhole-harness/package.json`, kiểm
20
+ `apps/cli/src/main.ts`, và in nguồn `npm dependency @galaxy-blackhole/blackhole-harness` trong
21
+ `blackhole harness status` / `web --dry-run`.
22
+ - Test `the harness shipped as an npm dependency is preferred over a stale home install`.
23
+
24
+ ### Changed
25
+
26
+ - **`HARNESS_PACKAGE_SPEC` lên `^0.1.4`** — bản 0.1.4 có fix Windows 16/11: mọi link thư mục dùng
27
+ junction + đường dẫn tuyệt đối (`link-dir.ts`), sửa lỗi profile thiếu gói làm harness thoát trước
28
+ khi in URL.
29
+ - README nói đúng mô hình một lệnh; `blackhole harness install` còn lại cho sửa chữa/offline/`--dir`.
30
+
31
+ ### Fixed
32
+
33
+ - **Windows:** người dùng cài mới nhận 0.1.4 ngay từ dependency thay vì `harness install` kéo
34
+ nhầm 0.1.3 (bản 0.1.3 dùng `symlinkSync(..., "dir")` trong `mount.ts` — EPERM trên Windows,
35
+ profile thiếu `gbh-brand`/`gbh-typert-protocol`/`gbh-cordis-plugin-timer`).
36
+
37
+ ## [3.0.13] - 2026-11-16 09:18 +0700
38
+
39
+ Mục này gộp **13 bản 3.0.x** (3.0.1 → 3.0.13; changelog trước đó dừng ở 2.1.36 ngày 12/10/2026), cộng
40
+ lần dọn phát hành ngày 19/11/2026: CLI chuyển hẳn sang harness `blackhole-harness`, gỡ nốt DSH
41
+ in-process đã chết, và gói npm tự cài harness thay vì ship kèm.
42
+
43
+ | Bản | Thay đổi chính |
44
+ |---|---|
45
+ | 3.0.0 | TUI hội thoại 3 vùng trên harness; tên model thân thiện; palette `/` + skills; khối Tác vụ; nhãn tool tiếng Việt; home/migrate mới; `web` cổng cố định 55906; sửa 404 `changes.summary` |
46
+ | 3.0.1 | `web` + `chat` chạy launcher bằng **Node**, bỏ Bun khỏi đường boot; dò runtime và báo lỗi rõ ràng; sửa `import.meta.dir` cho Node; `web --dry-run` |
47
+ | 3.0.2 | Đợt sửa harness kèm release: persona `model_label`, workspace `Documents/galaxy`, đọc tệp nhị phân qua multipart, tắt cảnh báo build giả trong bản đóng gói |
48
+ | 3.0.3 | `blackhole harness install\|status\|remove`; bậc dò harness mới; `chat`/`web` tự phục hồi khi thiếu harness; hỗ trợ Windows |
49
+ | 3.0.4 | `harness install` trỏ repo công khai `galaxy-blackhole/blackhole-harness`; bậc dò vẫn nhận tên cũ |
50
+ | 3.0.5 | Đổi tên `blackhole-harness` đồng bộ trong `locate`/`install`/test (bậc dò nhận cả tên cũ) |
51
+ | 3.0.6 | `blackhole update` hỏi registry npm qua HTTPS trước, `npm view` chỉ là dự phòng |
52
+ | 3.0.7 | Hạ ngưỡng Node từ 26 xuống **22** (`--experimental-strip-types` có từ 22.6); đo harness boot trên Node 24 |
53
+ | 3.0.8 | Tìm npm đa nền tảng (`GBH_NPM` → PATH → `npm.cmd` → `node` + `npm-cli.js`); `harness install` kiểm tra thật `…/dsh/lib/bin.js`; `web`/`chat` preflight runtime trước khi spawn |
54
+ | 3.0.9 | `harness install` ưu tiên npm `@galaxy-blackhole/blackhole-harness`; `status` in nguồn npm và hỗ trợ kernel bị npm hoist lên `node_modules` |
55
+ | 3.0.10 | Ghim spec harness `^0.1.1` thay vì `latest` để không tự nhảy minor; `GBH_HARNESS_SPEC` vẫn ghi đè được |
56
+ | 3.0.11 | Windows nvm-windows: npm không có đuôi file → nâng thành `npm.cmd`/`npm-cli.js` trước khi spawn (hết `spawn …npm ENOENT`); 3 test khoá hành vi |
57
+ | 3.0.12 | Ghim harness npm `^0.1.2` — bản có ngưỡng Node 22.6, boot được trên Node 24 |
58
+ | 3.0.13 | Nâng spec harness `^0.1.3` (tối thiểu có fix junction Windows); dòng "đã tải …" in version harness đã cài |
59
+
60
+ ### Added
61
+
62
+ - **`src/harness/node-runtime.ts`: `nodeEntryArgs()` + ngưỡng thật của Node.** `MIN_NODE_MINOR = 6`
63
+ (Node đầu tiên có `--experimental-strip-types`), `TYPE_STRIP_FLAG`, và `needsTypeStripFlag()` cho
64
+ hai cửa sổ chưa mặc định strip-types (22.6–22.17, 23.0–23.5). `resolveNodeRuntime()` nay từ chối
65
+ Node 22.0–22.5 bằng câu nêu mức, cách cài và mọi binary đã thử — thay vì spawn rồi chết.
66
+ - **`CHANGELOG.md` được ship trong gói npm** (`files`), cùng bảng tóm tắt 13 bản 3.0.x ở trên.
67
+
68
+ ### Changed
69
+
70
+ - **`blackhole web` và `blackhole chat` truyền `--experimental-strip-types` khi Node cần**
71
+ (`web.ts` `planWeb`, `harness/process.ts` `spawnHarnessHost`). Máy nằm trong cửa sổ `engines`
72
+ (`>=22.13` nhưng `<22.18`) không còn chết ở entry `.ts` của harness.
73
+ - **`blackhole migrate` chạy launcher bằng Node, không cần Bun** (`src/migrate.ts`): dùng đúng bậc dò
74
+ `harness/locate.ts` (`GBH_TAURI_ROOT` → slot `harness install` → sibling → dev), chạy
75
+ `apps/cli/src/main.ts migrate` bằng Node đã phân giải, dự phòng `bh` trên PATH; bỏ tên cũ
76
+ `blackhole-tauri` khỏi nguồn/kế hoạch và bỏ hard-code đường dẫn dev.
77
+ - **JSDoc/help nói đúng ngưỡng Node 22.6** thay vì "Node 26" (`web/web.ts`, `web/doctor.ts`,
78
+ `web/options.ts`, `web/command.ts`, `harness/process.ts`, `harness/node-runtime.ts`); tên harness
79
+ trong thông điệp đổi sang `blackhole-harness`.
80
+
81
+ ### Removed
82
+
83
+ - **`@deepseek-ai/dsh` khỏi `optionalDependencies`** — nó kéo 304 gói `@deepseek-ai/*` vào
84
+ `package-lock.json` (44,6% entry) cho một resolver đã chết.
85
+ - **`src/web/dsh.ts` và `test/web-dsh.test.ts`** — resolver DSH in-process (181 dòng) không còn
86
+ đường dùng nào khác ngoài test của chính nó; `dist/web/dsh.js` cũng không còn sau `npm run build`.
87
+ - **`web/` khỏi `files`** — brand/patches của DSH không còn được đóng gói (vẫn giữ trong repo cho
88
+ `web-brand` test và build brand); tarball chỉ còn `dist/`, `README.md`, `LICENSE`, `CHANGELOG.md`,
89
+ `skills/`.
90
+
91
+ ## [2.1.9] - 2026-10-06 15:00 +0700
92
+
93
+ ### Fixed
94
+
95
+ - **Chạy E2E bằng `update_checkpoint` không còn chết ở bước 1.** Core 0.3.12 nhận cả hai dạng `steps` (object
96
+ như model gửi, và chuỗi `status: title` cũ), nên một run thật không bị từ chối tool rồi abort nữa. CLI ghim
97
+ core 0.3.12.
98
+ ## [2.1.10] - 2026-10-06 19:20 +0700
99
+
100
+ ### Changed
101
+
102
+ - **Thinking policy dùng chung với core** (core 0.3.13): CLI bỏ bản sao `src/thinking-policy.ts`, import từ
103
+ core — cùng một từ vựng mức suy luận cho CLI, web GUI và extension VSCode.
104
+ ## [2.1.11] - 2026-10-07 03:40 +0700
105
+
106
+ ### Changed
107
+
108
+ - Dùng **core 0.3.14**: snapshot workspace không còn ném `LIMIT_EXCEEDED` khi workspace lớn — tệp quá 8 MiB và
109
+ phần vượt ngân sách được băm bằng metadata và snapshot được đánh dấu `degraded`.
110
+ ## [2.1.12] - 2026-10-07 04:10 +0700
111
+
112
+ ### Fixed
113
+
114
+ - **`blackhole web` trên Windows không còn chết vì plugin thương hiệu**: `ensureBrandLink` dùng `symlinkSync(...,
115
+ "dir")` — tạo symlink trên Windows cần quyền admin/Developer Mode, thất bại, bị `catch` nuốt im lặng, nhưng
116
+ patch thương hiệu **vẫn** được nạp nên DSH báo `Cannot find package '@galaxy-stack/gbh-brand'` và cả cây plugin
117
+ không load. Nay: thử **junction** (không cần quyền), không được thì **copy** gói vào profile; nếu vẫn thất bại
118
+ thì **bỏ patch thương hiệu** và in cảnh báo — web vẫn khởi động bình thường.
119
+ - Nhờ vậy, khi chưa có API key thì trang web vẫn mở và hộp thoại nhập key vẫn hiện như thiết kế, thay vì crash
120
+ trước khi kịp phục vụ.## [2.1.13] - 2026-10-07 04:45 +0700
121
+
122
+ ### Fixed
123
+
124
+ - **`blackhole web` đọc key từ mọi kho, không chỉ env + store của DSH**: trước đây hàm phân giải chỉ kiểm
125
+ `GBH_GALAXY_API_KEY` và `<gbh-home>/.credentials.yaml`, nên key đã thêm trong **VS Code** (ghi vào
126
+ `~/.galaxy/credentials.yaml` và mirror trong `config.json`) **vẫn bị coi là chưa có** — web mở lên nhưng lượt
127
+ chạy báo `API key không hợp lệ`.
128
+ Nay thứ tự: env → `OLLAMA_API_KEY` → store chung `~/.galaxy/credentials.yaml` (theo provider đang dùng) →
129
+ mirror `agent[type=manual].apiKey` trong `~/.galaxy/config.json` → store của DSH; key tìm được **được export
130
+ `GBH_GALAXY_API_KEY` cho tiến trình web**, nên thêm key ở VS Code là `blackhole web` dùng được ngay.
131
+ Cảnh báo "No Galaxy API key yet" chỉ còn hiện khi **thật sự** không có key ở bất kỳ kho nào.## [2.1.14] - 2026-10-07 11:40 +0700
132
+
133
+ ### Fixed
134
+
135
+ - **Ô nhập API key trong `blackhole web` không còn bị khoá trên Windows**: bản 2.1.13 bơm
136
+ `GBH_GALAXY_API_KEY` vào môi trường của tiến trình web, mà DSH coi khoá từ môi trường là "do môi trường khởi
137
+ chạy cung cấp" nên **chỉ đọc** và vô hiệu ô nhập. Nay key phân giải được **ghi vào store chung**
138
+ (`~/.galaxy/credentials.yaml`) nên hộp thoại web sở hữu giá trị: hiển thị đúng, sửa được, thay được — giống
139
+ hệt trên macOS.
140
+
141
+ ### Changed
142
+
143
+ - **Bước 2: `config.json` không còn là nguồn credential thường trực.** Nếu key chỉ còn nằm trong mirror cũ,
144
+ launcher đọc nó **một lần rồi chuyển ngay** vào store chung (ref `GBH_<PROVIDER>_API_KEY`); từ lượt sau mọi
145
+ host đều đọc từ store chung. Từ đây `config.json` chỉ còn là tài liệu cấu hình (model, baseUrl, thinking).## [2.1.15] - 2026-10-07 12:10 +0700
146
+
147
+ ### Added
148
+
149
+ - **`blackhole doctor`** — một lệnh trả lời đúng câu hỏi hay gặp: key có đúng không, hay máy không tới được
150
+ Ollama. Nó phân giải key y như `blackhole web` (env → `OLLAMA_API_KEY` → store chung → mirror cũ → store
151
+ DSH), in key đã **che bớt** kèm nguồn, rồi lần lượt kiểm tra kết nối `GET /api/tags` và gọi thật
152
+ `POST /api/chat` bằng **model đang dùng**.
153
+ Mã thoát: `0` tốt · `1` không có key · `2` mạng bị chặn · `3` key bị từ chối · `4` phản hồi khác.## [2.1.16] - 2026-10-07 15:10 +0700
154
+
155
+ ### Changed
156
+
157
+ - Dùng **core 0.3.15**: stream model im lặng quá 180 giây sẽ **dừng lượt chạy kèm lỗi rõ ràng** thay vì treo vô
158
+ hạn — hết cảnh cả flow đứng im hàng giờ ở bước gọi model.## [2.1.17] - 2026-10-07 16:00 +0700
159
+
160
+ ### Changed
161
+
162
+ - **Bảng tên công cụ chuyển vào core 0.3.16**: `timeline.tsx` không còn giữ bản sao `TOOL_LABELS` nữa mà
163
+ re-export từ `@galaxy-stack/ai-coder-core/tools` — TUI và webview của extension đọc **cùng một bảng**,
164
+ thêm công cụ mới chỉ phải đặt tên một lần.## [2.1.18] - 2026-10-07 16:10 +0700
165
+
166
+ ### Changed
167
+
168
+ - Dùng **core 0.3.17** (nhãn công cụ không còn ngoặc rỗng).## [2.1.19] - 2026-10-07 18:40 +0700
169
+
170
+ ### Docs
171
+
172
+ - **README viết lại cho khớp thực tế**: tiêu đề là *Galaxy Blackhole CLI* (không còn *Galaxy Code*), có mục cài
173
+ đặt, và **danh sách lệnh đầy đủ** — thêm `doctor`, `config migrate|doctor|path`, `memory` (7 lệnh con),
174
+ `skills search|install|update|remove`, `mcp login|logout`, `update`, `logs`, `setup`, `sessions` và `--continue`.
175
+ - **Mục Credentials viết lại**: một tài liệu chung `~/.galaxy/credentials.yaml` (ref `GBH_<PROVIDER>_API_KEY`),
176
+ thứ tự phân giải 5 bước (env → `OLLAMA_API_KEY` → store chung → mirror `config.json` được tự động chuyển →
177
+ store của web), và **bảng mã thoát của `blackhole doctor`** (0/1/2/3/4).
178
+ - Phân biệt rõ **`blackhole doctor`** (phía model: key, endpoint, kết nối) với **`blackhole web doctor`** (phía
179
+ launcher: runtime DSH, patch, nguồn key) — trước đây README chỉ nhắc cái thứ hai.
180
+ - Sửa các con số sai: core `0.3.0` → thực tế, `latest` không còn kẹt ở `2.0.0-alpha.9`, `--thinking` ở mục
181
+ Provider thiếu `default|minimal|xhigh|max`, và **ngân sách lượt chạy là 24 phút (tương tác) / 30 phút** —
182
+ README cũ ghi 15 phút.## [2.1.20] - 2026-10-07 19:00 +0700
183
+
184
+ ### Docs
185
+
186
+ - **Bỏ hẳn tên nhà cung cấp khỏi README**: mục cài đặt ghi *"check the API key and the connection"*, mục cài đặt có
187
+ thêm **`blackhole web`**, bảng mã thoát nói *"the provider is unreachable"*, và mục Providers giải thích đúng mô
188
+ hình: mặc định là **`auto`** — Galaxy Blackhole tự chọn model `deepseek-v4.1-flash`, local hay cloud, người dùng
189
+ không phải chọn vendor. Bỏ luôn biến môi trường phụ khỏi thứ tự phân giải credential.
190
+
191
+ ### Changed
192
+
193
+ - Dùng **core 0.3.18** (câu báo lỗi khi stream im lặng nay trung tính).## [2.1.21] - 2026-10-07 19:40 +0700
194
+
195
+ ### Docs
196
+
197
+ - **README viết cho người dùng, không phải cho người phát triển**: bỏ các mục *End-to-end verification*, *Development*,
198
+ *Testing and migration* và *Input and activity feedback*; bỏ chi tiết nội bộ (patch, brand client, DSH, OIDC,
199
+ `npm run`, thứ tự phân giải credential 4 bước, ghi chú SQLite).
200
+ - Mục credential đổi thành **API key**: một chỗ duy nhất (`~/.galaxy/credentials.yaml`), nhập ở đâu cũng dùng được
201
+ ở đó, kèm bảng mã thoát của `blackhole doctor`.
202
+ - Mục web GUI gọn còn việc người dùng cần: mở cái gì, Journey là gì, và **thiếu key vẫn mở được trang**.## [2.1.22] - 2026-10-07 19:50 +0700
203
+
204
+ ### Docs
205
+
206
+ - Sửa dòng bị lơ lửng ở mục Install sau khi gọt ghi chú SQLite ở bản 2.1.21.## [2.1.23] - 2026-10-07 20:20 +0700
207
+
208
+ ### Fixed
209
+
210
+ - **Mục "Xoá phiên" không còn lọt vào menu Quyền hay popup Model trong `blackhole web`**: brand client ghi nhớ
211
+ hàng phiên được bấm và **không bao giờ xoá cờ đó**, nên sau khi chuyển phiên (bấm vào hàng, không phải nút ⋯)
212
+ thì **mọi** `[role=menu]` mở sau đó — menu quyền, popup chọn model — đều bị chèn thêm mục xoá phiên.
213
+ Nay: cờ chỉ được bật khi bấm **nút menu của chính hàng đó** (`aria-haspopup`/`aria-expanded`), **menu đầu tiên**
214
+ xuất hiện sau đó **tiêu thụ** cờ, và cờ **hết hạn sau 1,5 giây** — nên tính năng xoá phiên vẫn còn nguyên ở đúng
215
+ chỗ của nó (menu ⋯ của hàng phiên và nút thùng rác ở header), không cần ẩn.## [2.1.24] - 2026-10-09 14:20 +0700
216
+
217
+ ### Added
218
+
219
+ - **`--tools-mode native|ptc|both`** cho `chat`, `run` và `flow` (mặc định `native`), truyền thẳng vào request của
220
+ core. Ở `ptc`/`both` CLI sẽ báo `CODE_RUNTIME_MISSING` cho tới khi sandbox (P2) hoàn thành — cố ý, để không ai
221
+ tưởng tính năng đã chạy.## [2.1.25] - 2026-10-09 15:45 +0700
222
+
223
+ ### Added
224
+
225
+ - **Sandbox PTC được compose trong CLI**: `--tools-mode ptc` (hoặc `both`) giờ **chạy thật**. CLI dựng
226
+ `WorkerCodeRuntime` (mỗi chương trình một worker thread, heap cap, deadline, huỷ) và đưa cho cả executor lẫn
227
+ run controller, nên chốt chặn `CODE_RUNTIME_MISSING` ở core tự mở.
228
+ - Mọi call con trong chương trình đi qua đúng đường tool cũ, nên **duyệt, effect profile, cap, spill, trace** giữ
229
+ nguyên hành vi.## [2.1.26] - 2026-10-09 19:40 +0700
230
+
231
+ ### Added (P4 của `docs/design/tool-modes.md`)
232
+
233
+ - **Call con của chương trình hiện thành thẻ riêng, lồng dưới thẻ `run_code`**: `GalaxyApplication` nhận
234
+ `onCodeEvent`, executor chuyển tiếp `code/tool-start` / `code/tool-result`, và `RunTimeline.codeEvent` dựng đúng
235
+ những dòng transcript mà một call trực tiếp sẽ có — cùng nhãn, cùng trạng thái, chỉ **thụt một cấp** (`└`).
236
+ - Thẻ `run_code` in ra **chương trình đã chạy** (vài dòng đầu, màu mờ) trước phần kết quả, nên đọc transcript là
237
+ biết model đã viết gì chứ không chỉ biết nó trả về gì.
238
+
239
+ ### Notes
240
+
241
+ - Chương trình bị **đếm** là một lần gọi công cụ, còn các call bên trong là thẻ con — không bị gộp vào dòng tổng
242
+ kết *"N lần gọi công cụ"*, cũng không bị ẩn đi như DSH làm.## [2.1.27] - 2026-10-10 10:40 +0700
243
+
244
+ ### Changed (P5b của `docs/design/tool-modes.md` — giao diện hội thoại cho CLI)
245
+
246
+ - **Bước đã xong trong dải kế hoạch nay có gạch chữ**, đúng như sidebar: `☑` + gạch ngang tiêu đề. Dải kế hoạch
247
+ tính chiều cao theo số dòng và Ink đo bề rộng bằng `string-width` (bỏ qua ANSI), nên mã gạch không làm lệch
248
+ bố cục.
249
+ - Bước **đang làm** giữ màu nhấn (dòng bắt đầu bằng `◐` được tô), bước **chờ** để trơn — không thêm chữ trạng thái
250
+ nào, giống hệt cách sidebar thể hiện.
251
+
252
+ ### Notes
253
+
254
+ - Phần gom nhóm công cụ của CLI (`N lần gọi công cụ · Ctrl+O để xem`) vốn đã cùng kiểu với web GUI, nên đợt này chỉ
255
+ chỉnh phần kế hoạch cho khớp ngôn ngữ hình ảnh của sidebar.## [2.1.29] - 2026-10-10 15:20 +0700
256
+
257
+ ### Fixed
258
+
259
+ - **Câu chỉ báo đang chạy bị lệch quy ước.** Từ điển đã có sẵn `chat.message.turnProcess.deepDivingFor` =
260
+ *"Đang suy nghĩ trong {duration}"*, nhưng bản dịch 0.2.0 lại đặt `chat.chat.deepDivingFor` = *"Đang đào sâu
261
+ trong {duration} ···"* — cùng một ý, hai cách nói. Nay cả hai key đều là *"Đang suy nghĩ trong {duration}"*
262
+ (ví dụ: **Đang suy nghĩ trong 5s**).
263
+ - **Bỏ linh vật cá của DSH khỏi dòng trạng thái đang chạy.** DSH vẽ một con cá động cho chỉ báo này; các slot mà
264
+ nó mở (`sidebar.brand.mark`, `conversation.hero.brand.mark`) **không** bao gồm chỉ báo đó, nên brand của ta
265
+ chưa từng thay được nó. Nay brand tiêm một quy tắc `[class*="runningWhale"]{display:none}` — bám phần tên ổn
266
+ định vì hash class đổi theo từng bản DSH.
267
+
268
+ ### Notes
269
+
270
+ - Đây là lỗi do bản dịch 0.2.0 hôm nay, không phải hành vi cũ của sản phẩm: key có tham số thời gian là key mới,
271
+ và nó đã được dịch thiếu nhất quán.## [2.1.30] - 2026-10-10 16:05 +0700
272
+
273
+ ### Changed
274
+
275
+ - **Mở lại toàn bộ giao diện DSH**, chỉ giữ ẩn đúng một trang: **Account** (`ui-settings-account`). Hiện lại: bộ chọn
276
+ **Agent presets** (Standard · PTC · Minimal · Creator), **Plugins**, **Built-in plugins**, trang session/global
277
+ plugins, **Agent loop**, **Shell**, **Subagent**, **Session log** và **Web search**.
278
+ - Trang Account vẫn ẩn vì sản phẩm này chạy bằng **key** tới Galaxy cloud, không dùng tài khoản DSH — trang đó không
279
+ có gì để làm ở đây.
280
+
281
+ ### Notes
282
+
283
+ - Các plugin **vẫn được mount** như trước: đợt này chỉ bỏ phần ẩn giao diện, không đổi cách compose.## [2.1.31] - 2026-10-10 17:10 +0700
284
+
285
+ ### Fixed
286
+
287
+ - **Trang Preset không sửa được.** Overlay của ta ghim `agent-preset-registry` (`default: ptc`), nên config editor
288
+ của DSH từ chối lưu và hiện cảnh báo đỏ *"Configuration for … is overridden by a home patch or command-line
289
+ overlay"*. Nay patch **không** ghim preset nữa: trang dùng được, lựa chọn của bạn được giữ. Muốn ép một preset
290
+ cho một lần chạy thì dùng `--preset <id>`.
291
+ - **`--preset` trỏ vào row đã đổi tên.** Overlay dòng lệnh vẫn phát `agent-presets` (id thời 0.1.5) nên cờ không có
292
+ tác dụng; nay là `agent-preset-registry`.
293
+ - **19 chuỗi preset còn tiếng Anh** — *Mode details*, *How to use*, và toàn bộ nội dung hướng dẫn của bốn chế độ —
294
+ nay đã dịch. Nguyên nhân: script merge điền tiếng Anh vào chỗ trống, còn test cũ chỉ kiểm tra "không rỗng".
295
+
296
+ ### Changed
297
+
298
+ - Dòng *Phiên bản hiện tại* trong Cài đặt → Chung nay hiện **phiên bản blackhole** thay vì số của DSH.
299
+ - Ẩn nút **Xem** trên thẻ preset: nó mở đúng nội dung mà thẻ đã dẫn tới.## [2.1.32] - 2026-10-10 18:00 +0700
300
+
301
+ ### Changed
302
+
303
+ - **Dịch 249 chuỗi giao diện còn tiếng Anh** (lượt 1 và 2): Phím tắt (56→1), Trajectory (39→11), Open in app (42→33),
304
+ Subagent settings (35→1), Subagent (20→14), Deliverables (33→2), Job (24→0). Phần giữ nguyên là thứ **không nên**
305
+ dịch: đơn vị đo (ms, s, tok), tên ứng dụng (Cursor, VS Code, Zed…), ký hiệu (+n, −n), và tên sản phẩm (Subagent).
306
+
307
+ ### Fixed
308
+
309
+ - **Nút "Xem" trên thẻ preset vẫn hiện** sau bản 2.1.31: nó không phải phần tử `<button>` và inline style bị React ghi
310
+ đè khi render lại. Nay ẩn bằng quy tắc CSS theo `data-tip`/`aria-label` — thuộc tính do DSH đặt từ chính key đã
311
+ dịch, nên bền qua mọi lần render lại và cả khi đổi ngôn ngữ.## [2.1.33] - 2026-10-10 19:30 +0700
312
+
313
+ ### Changed
314
+
315
+ - **Dịch nốt 408 chuỗi** của những bề mặt trước đây được miễn trừ: Plugin (**189**), Settings → Account (**93**),
316
+ Voice input (**101**), Agent Team (**25**). Cộng với 249 chuỗi của 2.1.32, tổng lượt này là **657 chuỗi** trên
317
+ 34 namespace.
318
+ - **Schedule cũng đã dịch** (`schedule.catalog` 70, `schedule.manager` 187): danh sách nhắc hẹn, quy tắc lặp, biểu
319
+ thức cron, múi giờ, bản ghi gửi. **Không còn namespace nào được miễn trừ** — `NOT_COMPOSED` nay rỗng, nên mọi
320
+ namespace mà các bundle DSH ship đều được dịch, kể cả trang mà overlay đang ẩn (Account) hay bundle thử nghiệm
321
+ không mount (voice input, Agent Team, Schedule).
322
+
323
+ ### Added
324
+
325
+ - **Cổng chặn dịch sót.** `web/brand/dsh-locale-keys.json` nay lưu hash SHA-256 của bản tiếng Anh từng key, và một
326
+ test mới sẽ đỏ nếu bản dịch nào **trùng y nguyên tiếng Anh**. Danh sách miễn trừ nằm ở
327
+ `web/brand/vi-same-by-design.json` (110 mục, có ghi lý do trong test): đơn vị đo, tên ứng dụng, dấu phân cách,
328
+ tên giao thức, URL, và mã định danh — những thứ không nên dịch.
329
+
330
+ ### Notes
331
+
332
+ - Cổng này bắt được đúng lỗi của lượt trước: namespace `pluginManager` chưa từng có trong từ điển, nên các trang
333
+ Plugin hiện tiếng Anh. Một phép đo cũ đọc namespace rỗng thành "không có gì cần dịch" và tôi đã báo sai.## [2.1.34] - 2026-10-10 21:05 +0700
334
+
335
+ ### Changed
336
+
337
+ - **Ẩn các bề mặt plugin**: trang **Plugin** ở sidebar (`ui-plugin-manager`), mục **Plugin** trong Cài đặt
338
+ (`ui-settings-plugins`) và trang kiểm kê plugin (`ui-settings-plugin-inventory`). Sản phẩm này ship một bộ
339
+ plugin cố định, nên những trang đó không có gì để người dùng làm và mọi thứ chúng liệt kê đều là nội bộ.
340
+ Bộ chọn **Preset agent** vẫn giữ nguyên.
341
+ - Trang chi tiết plugin được dọn: ẩn huy hiệu phiên bản DSH, tên gói npm, và cả khối "Thành phần" — cùng hàng
342
+ "Mô-đun" đã ẩn từ trước (nay sửa luôn lỗi nằm ngoài vòng lặp của nó).
343
+
344
+ ### Added
345
+
346
+ - **Hai cổng cho brand web**: template và bundle phải **parse** được, và **factory của module phải chạy** được
347
+ (thực thi với stub React). Cổng thứ hai bắt đúng lớp lỗi từng làm GUI báo "Failed to load plugins".
348
+
349
+ ### Notes
350
+
351
+ - Bản này gộp cả đợt dịch của 2.1.33 (**933 chuỗi**, gồm cả Schedule) vì 2.1.33 chưa từng lên npm.
352
+
353
+ ## [2.1.35] - 2026-10-10 22:10 +0700
354
+
355
+ ### Fixed
356
+
357
+ - **`Mất {duration}8s` hiện trên dòng trạng thái.** Bản dịch của `chat.message.turnProcess.took` là *"Mất
358
+ {duration}"*, nhưng câu tiếng Anh chỉ là **tiền tố** *"Completed in "* — không có placeholder nào, DSH tự ghép
359
+ thời lượng vào sau. Thêm placeholder vào đó khiến nó hiện nguyên văn. Nay là *"Xong sau "*.
360
+
361
+ ### Added
362
+
363
+ - **Cổng kiểm placeholder hai chiều.** Trước đây inventory chỉ ghi placeholder cho những key mà bản tiếng Anh
364
+ **có** placeholder, nên một bản dịch **tự thêm** placeholder không bị phát hiện — đúng lỗi trên. Nay mọi key đều
365
+ được ghi (kể cả danh sách rỗng) và test so cả hai chiều. Quét lại toàn bộ 2527 key: sạch.
366
+
367
+
368
+ - **Tab "Tính năng" trong Cài đặt**: bật/tắt hai tính năng thử nghiệm của DSH (Agent Teams, Tác vụ tự động)
369
+ qua route `/api/galaxy/features`, ghi thẳng vào `dsh.profile.bundles` — đúng cơ chế DSH dùng cho trang
370
+ Plugin. Mặc định **tắt**, và công tắc bị vô hiệu hoá khi chưa đọc được trạng thái.
371
+ - **Hai chuỗi ở Cài đặt → Chung** (chúng viết thẳng trong bundle nên từ điển không với tới): nay là *"Tải log
372
+ phiên lên khi dùng API model chính thức"* và *"Giúp cải thiện model và sản phẩm Galaxy."*
373
+
374
+ ### Changed
375
+
376
+ - **Tab "Hành trình" được giữ lại**: nó vẫn đang phát triển, nên bản phát hành không mang theo một bề mặt chưa
377
+ xong. Mã giữ nguyên; đổi cờ `GBH_JOURNEY_ENABLED` thành `true` là nó trở lại.
378
+ - Bỏ trang Plugin khỏi sidebar và mục Plugin khỏi Cài đặt (từ 2.1.34).
379
+ ## [2.1.36] - 2026-10-12 18:08 +0700
380
+
381
+ ### Fixed
382
+
383
+ - **`blackhole web` không còn báo "Failed to load plugins"** (`web boot: 1 entry did not activate` /
384
+ `@galaxy-stack/gbh-brand: failed`). Nửa client của brand đăng ký một mục feedback ở session header và truyền
385
+ `GbhFeedbackAction` — cái tên **chưa từng được định nghĩa ở đâu trong repo**, vì feedback đã chuyển thành
386
+ section trong Cài đặt từ trước. Tham chiếu nằm trong callback của `ctx.slots.inject`, nên `ReferenceError`
387
+ chỉ nổ lúc slot được materialize, tức **bên trong lúc entry kích hoạt**: cả cây plugin bị đánh dấu hỏng dù
388
+ phần còn lại của bundle chạy tốt. Khối registration stale nay đã bị gỡ; feedback vẫn nằm ở section Cài đặt.
389
+ Xem [CHANGELOG.d fragment](CHANGELOG.d/2026-10-12-feedback-action-khong-ton-tai.md).
390
+ - Bản 2.1.35 phát hành thiếu hai dòng `disabled: true` mà HEAD đang có (`session-log-deepseek`,
391
+ `ui-settings-session-log`), nên slot đó được materialize ngay trong cửa sổ web boot và lỗi trên thành chí
392
+ mạng; ở patch của HEAD nó chỉ nằm im trong console. Bản này sửa gốc, độc lập với patch.
393
+
394
+ ### Added
395
+
396
+ - **Cổng chặn cho nửa client của brand**: `test/web-brand.test.ts` dựng `ctx` giả, materialize mọi slot rồi gọi
397
+ `apply()`, và mọi registration phải truyền một component thật — một cái tên thiếu không thể đi ra bản phát
398
+ hành lần nữa. Test đã được kiểm chứng **đỏ trên bundle cũ** với đúng `ReferenceError` kể trên. Xem
399
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-10-12-feedback-action-khong-ton-tai.md).
400
+ ## [2.1.8] - 2026-10-06 11:20 +0700
401
+
402
+ ### Changed
403
+
404
+ - **Reader MCP dùng chung với core** (`adapters/node/config/workspace-mcp`): CLI bỏ bản sao trong
405
+ `src/mcp-config.ts` để CLI và extension VSCode đọc `.vscode/mcp.json` bằng **cùng một đoạn code**, không
406
+ còn nguy cơ lệch nhau. Hành vi không đổi: chỉ server stdio, `--agent-config` > workspace > mặc định
407
+ Galaxy, và mặc định chỉ được thêm khi agent config không nói gì.
408
+
409
+ ## [2.1.7] - 2026-10-06 10:15 +0700
410
+
411
+ ### Added
412
+
413
+ - Đọc MCP server của dự án từ **`.vscode/mcp.json`** (chỉ server stdio), thứ tự ưu tiên
414
+ `--agent-config` > workspace > mặc định Galaxy; mặc định chỉ được thêm khi agent config không nói gì.
415
+ - [docs/CONFIG_PRECEDENCE_2026-10-06.md](docs/CONFIG_PRECEDENCE_2026-10-06.md): bảng thứ tự ưu tiên cấu
416
+ hình, và nguyên tắc `.galaxy/` trong repo chỉ là state. Xem
417
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-10-06-mcp-workspace-va-thu-tu-cau-hinh.md).
418
+
419
+ ## [2.1.6] - 2026-10-05 21:20 +0700
420
+
421
+ ### Fixed
422
+
423
+ - **2.1.5 phát hành thiếu nửa server của bản vá `web_search`**: file `web/brand/lib/index.js` không được
424
+ đưa vào commit (chỉ có test), nên bản 2.1.5 vẫn hỏng `web_search`. 2.1.6 mới thật sự chứa provider
425
+ `galaxy` + đường đọc `~/.galaxy/credentials.yaml`.
426
+ - Đưa nốt phần journey đang dở (libs + `.d.ts`) vào commit: bộ test journey đã được commit trước đó
427
+ nhưng thiếu phần thư viện đi kèm, khiến `npm run check` trên CI đỏ.
428
+
429
+ ## [2.1.5] - 2026-10-05 20:50 +0700
430
+
431
+ ### Fixed
432
+
433
+ - `web_search` trong blackhole web: provider tìm kiếm của Galaxy có id thật (`galaxy`) và đọc key từ
434
+ `~/.galaxy/credentials.yaml` — trước đây id là `"auto"` và chỉ đọc env nên mọi lần gọi đều lỗi.
435
+
436
+ ### Added
437
+
438
+ - `--continue`: nối lại phiên mới nhất của workspace hiện tại. Xem
439
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-10-05-web-search-va-continue.md).
440
+
441
+ ## [2.1.4] - 2026-10-05 18:20 +0700
442
+
443
+ ### Fixed
444
+
445
+ - Cổng API key first-run chỉ còn dành cho **route cloud của Galaxy**: chạy với Ollama local, gateway tự
446
+ host hay endpoint bất kỳ do bạn chỉ định giờ không còn bị chặn với exit code 3. Đây là nguyên nhân CI
447
+ của CLI đỏ liên tục từ 2026-10-02. Xem
448
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-10-05-cong-key-chi-cho-cloud.md).
449
+
450
+ ## [2.1.3] - 2026-10-05 12:10 +0700
451
+
452
+ ### Added
453
+
454
+ - Dải checklist kế hoạch **thường trú** trên transcript + lệnh `/plan` (bật chế độ chỉ-đọc, `/plan off`
455
+ để duyệt), chạy trên plan mode của core 0.3.8. Xem
456
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-10-05-plan-mode-cli.md).
457
+ - Thiết kế đầy đủ: [docs/PLAN_MODE_2026-10-05.md](docs/PLAN_MODE_2026-10-05.md).
458
+
459
+ ## [2.1.2] - 2026-10-05 11:10 +0700
460
+
461
+ ### Added
462
+
463
+ - `/compact` trong TUI: nén context của **lượt đang chạy** qua `compactNow` của core 0.3.7, notice báo
464
+ lại số mục bị nén và token trước/sau.
465
+ - Gõ `/compact` **lúc rảnh** giờ không còn là lệnh rỗng: cờ `compactOnStart` được ghi nhớ và lượt kế
466
+ tiếp sẽ nén **trước khi gọi model**, nên cả lượt đó đã trả giá bằng prompt gọn. Xem
467
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-10-05-compact-trong-tui.md).
468
+
469
+ ## [2.1.1] - 2026-10-04 16:45 +0700
470
+
471
+ Lần đầu chạy `blackhole` mà chưa có API key thì được hướng dẫn nhập, và **không chỗ nào lộ tên runtime**.
472
+
473
+ ### Added
474
+
475
+ - `blackhole setup`: màn hình đầu chỉ nói **Galaxy Blackhole** và hỏi API key (ô nhập ẩn ký tự). Đồng ý
476
+ khi ô trống thì báo lỗi tại chỗ; Huỷ (Esc) mở **"Chọn nhà cung cấp"** (Galaxy Blackhole khuyên dùng ·
477
+ máy chủ nội bộ · OpenAI-compatible). Key được kiểm tra bằng `GET /api/tags` trước khi lưu — 401/403 là
478
+ "không hợp lệ", lỗi mạng thì hỏi trước khi lưu dạng chưa xác minh. `--reset` để nhập lại, `--no-input`
479
+ để không bao giờ hỏi. Xem [CHANGELOG.d fragment](CHANGELOG.d/2026-10-04-hanh-trinh-setup-key-lan-dau.md).
480
+ - `blackhole chat|run|flow` tự gọi luồng setup khi chưa có key; script (không TTY) nhận gợi ý và **exit 3**
481
+ thay vì chạy tiếp rồi in lỗi 401 thô.
482
+
483
+ ### Fixed
484
+
485
+ - Lỗi provider được gắn brand: `Galaxy Blackhole: chat failed (401): Unauthorized` kèm gợi ý
486
+ `blackhole setup`, thay cho `Ollama chat failed (401)`.
487
+ - Header TUI không còn fallback về tên runtime; host lạ được gọi đúng là `OpenAI-compatible (<host>)`.
488
+ - `blackhole config doctor` phân biệt "chưa có key → chạy setup" với "mirror lệch → chạy migrate".
489
+ - `--research` và ghi chú mức suy luận không còn nhắc tên runtime.
490
+
491
+ ## [2.1.0] - 2026-10-04 14:52 +0700
492
+
493
+ `blackhole web` nay tự mang runtime DSH, và lần đầu chạy được trên Windows.
494
+
495
+ ### Added
496
+
497
+ - `@deepseek-ai/dsh` thành **optional dependency** ghim `0.1.5-rc.3`: cài CLI là có runtime, không
498
+ cần `npm i -g` riêng, và runtime được chạy bằng `node` (không qua shim shell). Xem
499
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-10-04-dsh-optional-dependency-va-windows-runtime.md).
500
+ - Thông điệp lỗi và `blackhole web doctor` nêu đúng lệnh cài, đúng bản ghim, và runtime nào đã trả lời.
501
+
502
+ ### Fixed
503
+
504
+ - **Windows**: shim `.cmd` không còn bị đưa thẳng cho `spawn` (Node chặn `.cmd`/`.bat` khi thiếu
505
+ shell) — shim được giải ngược về `lib/bin.js` và chạy bằng node, chỉ shim mồ côi mới bọc `cmd.exe`;
506
+ ghi chú `INFO: Could not find files…` của `where.exe` không còn rò ra terminal.
507
+ - Bậc dò `node_modules/.bin/dsh` trước đây trỏ sai gốc package (`src/` / `dist/`) nên không bao giờ khớp.
508
+ - Gỡ dòng gợi ý `/compact`–fork dưới banner lỗi lượt trong GUI web (vi + en): banner lỗi nay là toàn bộ
509
+ thông báo. Xem [CHANGELOG.d fragment](CHANGELOG.d/2026-10-02-web-turn-error-hint-removed.md).
510
+
511
+ ## [2.0.14] - 2026-10-02 09:55 +0700
512
+
513
+ Ships core **0.3.5** (a churning workspace log can no longer fail a run) and closes the skill ↔ MCP
514
+ contract gap the 2026-10-02 E2E rerun exposed.
515
+
516
+ ### Added
517
+
518
+ - Bundled skills declare the companion MCP version their documented call shapes need
519
+ (`requires: { orbit: ">=0.4.1" }`, `requires: { nebula: ">=1.1.0" }`), and the CLI warns when a
520
+ connected server is older. The warning list lands in `flow-report.json` as `environmentWarnings`.
521
+ See [CHANGELOG.d fragment](CHANGELOG.d/2026-10-02-hop-dong-version-skill-mcp-va-retry-mutation.md).
522
+ - `npm run skills:check` / `skills:sync` keeps the bundled `orbit-framework` skill byte-identical to
523
+ the canonical copy in `galaxy-orbit/orbit-mcp/skills/`.
524
+ - The first-party MCP servers resolve through Smithery by default (`@smithery/cli@4.11.1 mcp run`), because
525
+ that listing serves one versioned bundle carrying both the server and the skill it routes to.
526
+ `GBH_MCP_SOURCE=npm` restores the npm wiring.
527
+
528
+ ### Fixed
529
+
530
+ - A flow step killed by an unverifiable mutation (`outcome is unknown`, `Active file content hash
531
+ changed`) is retried instead of being remembered as a step failure — the shape of `s13` in the
532
+ 2026-10-02 gymflow run.
533
+
534
+ ## [2.0.13] - 2026-10-02 01:20 +0700
535
+
536
+ Gộp hai đợt: bản sửa skill/MCP sau audit E2E 2026-10-01 (chưa release) và đợt biến skill thành
537
+ router trên API surface máy sinh của `orbit-mcp` 0.3.0.
538
+
539
+ ### Changed
540
+
541
+ - **`skills/orbit-framework` viết lại thành rulebook + router (122 dòng)** — chỉ giữ luật không
542
+ suy ra được từ declaration, bảng định tuyến "cần gì → gọi tool/section nào", security baseline
543
+ và checklist kiểm chứng; template và recipe wiring chuyển về knowledge của MCP.
544
+ - **`skills/galaxy-ui` đồng bộ từ nguồn chuẩn `galaxy-design`** (91 dòng) với bảng định tuyến cho
545
+ 5 tool của `nebula-mcp` và ranh giới verification rõ ràng.
546
+
547
+ ### Fixed
548
+
549
+ - **Bỏ chỉ dẫn sai về một capability không tồn tại.** Hai skill viết "through the bounded session
550
+ capability"; profile thật không có tool đó, khiến agent bỏ **22 lượt `search_tools`** trong một
551
+ run 15 bước. Nay mô tả đúng cách chạy dev server bằng `run_command`.
552
+ - **Bỏ đoạn code lỗi type** `SecurityModule.forRoot({ helmet: true, csrf: true })` — `helmet`/`csrf`
553
+ nhận object hoặc `false`.
554
+ - **Sửa mô tả sai về request pipeline**: có **hai** interface `ExceptionFilter` (core dùng
555
+ `ExecutionContext`; common khai `ArgumentsHost` với `getArgs()`/`getArgByIndex()`), và
556
+ `ThrottlerGuard` nhận `ThrottlerContext`.
557
+ - **Bổ sung recipe throttling** (DI của `ThrottlerGuard`, base controller dùng chung, filter 429);
558
+ trước đó agent phải mở `node_modules/@galaxy-stack/orbit-throttler/**` 6 lượt/tệp để tự suy ra.
559
+
560
+ ### Added
561
+
562
+ - **Test chặn tái phát** trong `test/skills-cli.test.ts`: cấm "bounded session capability", cấm dạy
563
+ `helmet: true`/`csrf: true` (chỉ cho phép câu phủ định), cấm import
564
+ `Body`/`Param`/`HttpCode`/`UseGuards`/`NotFoundException` từ `orbit-core`, cấm coi dev server là
565
+ bước kiểm chứng.
566
+
567
+ ## [2.0.12] - 2026-10-01 02:03 +0700
568
+ ### Fixed
569
+
570
+ - Pin @galaxy-stack/ai-coder-core 0.3.4: a mutation whose evidence cannot be applied is now a retryable tool error, so a background install or build can no longer kill a step (measured: the NestJS control flow lost steps 2, 5 and 11 that way).
571
+
572
+ ## [2.0.11] - 2026-09-30 23:06 +0700
573
+
574
+ ## [2.0.10] - 2026-09-30 21:17 +0700
575
+
576
+ ## [2.0.9] - 2026-09-30 19:08 +0700
577
+ ### Fixed
578
+
579
+ - Republish after npm accepted 2.0.8's metadata but never served its tarball (install returned 404). No code changed; 2.0.9 is byte-for-byte the same release.
580
+
581
+ ## [2.0.8] - 2026-09-30 19:00 +0700
582
+
583
+ ## [2.0.7] - 2026-09-30 18:53 +0700
584
+
585
+ ## [2.0.6] - 2026-09-30 18:46 +0700
586
+
587
+ ## [2.0.5] - 2026-09-30 18:26 +0700
588
+
589
+ ## [2.0.4] - 2026-09-30 18:13 +0700
590
+ ### Fixed
591
+
592
+ - Pin @galaxy-stack/ai-coder-core 0.3.3: 2.0.3 shipped an import of the shared credential document before that module was published, so a fresh install crashed on start with ERR_MODULE_NOT_FOUND.
593
+
594
+ ## [2.0.3] - 2026-09-30 18:03 +0700
595
+
596
+ ## [2.0.2] - 2026-09-30 14:55 +0700
597
+
598
+ ## [2.0.1] - 2026-09-29 05:35 +07:00
599
+
600
+ ### Added
601
+
602
+ - Skill orbit-framework carries an API map compiled from the installed declarations
603
+ (orbit-core@0.2.3, orbit-common@0.1.15, orbit-database@0.1.10, orbit-security@0.1.10,
604
+ orbit-throttler@0.1.10): package exports, exception and parameter-decorator signatures,
605
+ transform options, database wiring (DatabaseModule.forFeature(entities, tableMap),
606
+ DrizzleRepository), security and throttling wiring, middleware/CORS/static contracts, and the
607
+ OrbitApplication surface — including the note that there is no useGlobalPipes/useGlobalGuards/
608
+ useGlobalFilters.
609
+ - The skill also records the three shipped READMEs that contradict their own types (orbit-security
610
+ csrf enabled/tokenKey/cookieName, orbit-throttler RedisThrottlerStorage and throttlers: [...]).
611
+ - The skill states which package versions the map was compiled from and keeps package.json as the
612
+ way to confirm the installed version, and it carries rate-limiting/throttling recipes
613
+ (rateLimit(...).createMiddleware(), the limiter methods, ThrottlerModule.forRoot({ ttl, limit })
614
+ with @UseGuards(ThrottlerGuard) and @Throttle/@SkipThrottle, the @Catch(ThrottlerException) 429
615
+ filter, and the ThrottlerStorage contract).
616
+ - blackhole flow --flow-until <step-id> bounds a re-run so a range can be repeated without walking
617
+ the whole tail of a flow.
618
+
619
+ ### Fixed
620
+
621
+ - A flow step killed by a transport error surfaced as a thrown error is now retried instead of
622
+ failing the whole flow, and a step that exhausts the host deadline is treated as retryable
623
+ infrastructure.
624
+ - Docs: docs/TEST_FAILURE_ANALYSIS.md records every end-to-end failure with its evidence, root
625
+ cause and fix, plus the release-verification numbers.
626
+
627
+ ## [2.0.0] - 2026-09-28 23:20 +07:00
628
+
629
+ First verified stable release: the 25-prompt end-to-end flow completes with this CLI and the
630
+ pinned @galaxy-stack/ai-coder-core@0.3.0. The failure journal behind the changes lives in
631
+ [docs/TEST_FAILURE_ANALYSIS.md](docs/TEST_FAILURE_ANALYSIS.md).
632
+
633
+ ### Added
634
+
635
+ - `/diff` opens the newest patch full screen through the assistant-ui `DiffView`
636
+ (line numbers, `+4 -4` stats, intra-line marks), paged with ↑/↓ and PgUp/PgDn.
637
+ The viewer is a single-child surface, which is where a variable-height DiffView
638
+ is safe; the inline transcript keeps the coloured-span rendering.
639
+ - Consecutive tool calls collapse into one line (`⚙ 4 lần gọi công cụ · ✔ 4 · Ctrl+O để xem`),
640
+ while a call that is still running stays expanded so the current activity is
641
+ always visible; `Ctrl+O` expands every call.
642
+ - Each finished turn prints one dim footer line with the brand, model, reasoning
643
+ effort, input tokens and wall time (`Galaxy Blackhole · Auto · Mức suy luận: Cao
644
+ · 12.4k tokens · 8.2s`).
645
+
646
+ ### Changed
647
+
648
+ - Transcript rendering reworked: each turn opens with a role gutter (`❯` user,
649
+ `⏺` assistant) and wrapped lines hang under it, thinking is a dim magenta
650
+ block behind a `│` bar, tool calls get a status glyph (`◐` running, `✔` ok,
651
+ `✖` error, `⊘` stopped) with a bounded result summary, unified diffs colour
652
+ added and removed lines, and a dim caret marks the streaming turn.
653
+ - Assistant prose is parsed markdown-lite: headings render bold, bullets become
654
+ `•`, inline code and links are styled, and fenced code stays dim behind a bar.
655
+ - The collapsed-thinking hint now names the real key (`Ctrl+L`) instead of the
656
+ old `Ctrl+T`, which now cycles the reasoning effort.
657
+
658
+ ### Added
659
+
660
+ - blackhole flow streams every event as it arrives (step-NN-<id>.ndjson), writes a compact
661
+ progress.log with bounded, secret-free tool arguments, and reports per-step gate rejections,
662
+ tool failures, tokens and the cumulative provider cache hit rate.
663
+ - scripts/e2e-report.mjs summarises a run and flags what a passing step can hide: a step that
664
+ never called its expected tool, component-library files written with no scaffold call, a
665
+ whole-project check run through the shell, long-running servers in a headless run, evidence
666
+ ordered after the last write, and duplicate calls inside one turn.
667
+ - blackhole flow --flow-from <step-id> resumes a flow in the same session, workspace and state,
668
+ and --flow-step-retries <n> retries a step that hit a transport outage or the host deadline
669
+ before calling it failed. The report is written even when the run dies and records fatal,
670
+ resumedFrom, skippedSteps and retriedSteps.
671
+ - --max-turns <n> and --run-minutes <n> expose the run budget and the host deadline, previously
672
+ fixed at 48 model turns and 15 minutes.
673
+ - An end-to-end verification section in the README documents the harness, the report script and
674
+ the failure journal.
675
+
676
+ ### Changed
677
+
678
+ - The bundled orbit-framework skill no longer teaches bun run dev as a verification step (a dev
679
+ server never exits, produces no evidence, and its probe files are unreviewed writes), documents
680
+ route prefixing and versioning for the installed framework, prefers edit_file with a unique
681
+ oldText, and the galaxy-ui skill gained the same no-dev-server verification rule next to
682
+ validate_project and nebula doctor.
683
+
684
+ ## [2.0.0-alpha.18] - 2026-09-27
685
+
686
+ ### Fixed
687
+
688
+ - Pin `@galaxy-stack/ai-coder-core@0.3.0-alpha.19`, which classifies build
689
+ output as generated state. Validation and diff-review no longer go stale when
690
+ a build regenerates `dist/`, so the completion gate no longer loops to
691
+ `maxTurns`. The core also reads per-project derived directories from
692
+ `.gitignore` and `.galaxy/workspace.json`.
693
+
694
+ ## [2.0.0-alpha.17] - 2026-09-27
695
+
696
+ ### Changed
697
+
698
+ - The TUI header shows `Galaxy Blackhole · Auto` for the Galaxy-managed route
699
+ (a manual config entry with a key) and no longer appends the resolved wire
700
+ model id. Other providers keep the resolved id until the user picks a model.
701
+
702
+ ## [2.0.0-alpha.16] - 2026-09-27
703
+
704
+ ### Added
705
+
706
+ - `@` file references in the composer: typing `@` lists workspace files (hidden
707
+ and ignored directories skipped, depth and count bounded), filtering as you
708
+ type, ↑/↓ to choose and Enter to insert the relative path.
709
+ - `/session` shows the session id, workspace, state directory, provider profile,
710
+ message count and log file. `/clear` hides the transcript view while the
711
+ session history stays on disk. `/quit` exits the TUI.
712
+
713
+ ### Fixed
714
+
715
+ - Escape returns to the idle screen instead of leaving a "Đã huỷ" badge behind,
716
+ and it no longer cancels a run while a picker is open: the picker closes first.
717
+
718
+ ## [2.0.0-alpha.15] - 2026-09-27
719
+
720
+ ### Added
721
+
722
+ - A `/` command menu in the composer: type `/` to list the commands (help, model,
723
+ effort, thinking, tools, skills), keep typing to filter, move with ↑/↓ and run
724
+ with Enter. `/help` opens a shortcuts panel.
725
+
726
+ ### Fixed
727
+
728
+ - `Ctrl+M` and `Ctrl+H` never fired. A terminal sends the same byte for `Ctrl+M`
729
+ and Enter, and for `Ctrl+H` and Backspace, so Ink reported them as return and
730
+ backspace. The model picker moved to `Ctrl+P` and the thinking-transcript
731
+ toggle to `Ctrl+L`.
732
+
733
+ ### Changed
734
+
735
+ - The hint under the composer is short again; the key list lives in `/help`.
736
+ - An open picker now reads "Bảng chọn đang mở · esc để đóng" instead of the
737
+ permission-prompt wording.
738
+
739
+ ## [2.0.0-alpha.14] - 2026-09-27
740
+
741
+ ### Changed
742
+
743
+ - The web GUI labels the injected-context producer readably: the harness plugin
744
+ id `@deepseek-ai/dsh-system-prompt` now renders as `System prompt`, so the row
745
+ reads "Chèn ngữ cảnh · System prompt". The brand client plugin rewrites any
746
+ `@deepseek-ai/dsh-*` producer label and re-applies it after React re-renders.
747
+
748
+ ## [2.0.0-alpha.13] - 2026-09-27
749
+
750
+ ### Changed
751
+
752
+ - Help and README copy no longer name the upstream harness: `blackhole web`
753
+ boots the Galaxy Blackhole web GUI, and `--no-brand` keeps the stock sidebar
754
+ brand. Only the technical `DSH` abbreviation and the `@deepseek-ai/dsh`
755
+ dependency name remain, because the runtime is still that package.
756
+
757
+ ## [2.0.0-alpha.12] - 2026-09-27
758
+
759
+ ### Added
760
+
761
+ - Thinking effort is resolved per model instead of a fixed list. The header now
762
+ reads `Galaxy Blackhole · Auto · Mức suy luận: …`; `Ctrl+T` cycles the effort,
763
+ `Ctrl+M` opens a model picker, `Ctrl+H` shows or hides the thinking transcript,
764
+ and `Ctrl+O` keeps toggling tool details.
765
+ - `Mặc định` (auto) sends no `think` field, so the model keeps its own default.
766
+ `--thinking` accepts `auto|default|off|on|minimal|low|medium|high|xhigh|max` and
767
+ is validated against the levels the resolved model actually offers.
768
+ - A probe that reports no thinking hides the control, a thinking-required model
769
+ drops `Tắt`, and an unverified model keeps the levels with a warning.
770
+ - Levels can be declared per model in `~/.galaxy/config.json` through
771
+ `reasoningEfforts`, the shape the web overlay already uses.
772
+ - The provider name follows the endpoint: `ollama.com` shows as Galaxy Blackhole,
773
+ a local runtime stays `Ollama (local)`, any other host is named explicitly.
774
+
775
+ ## [2.0.0-alpha.11] - 2026-09-27
776
+
777
+ ### Fixed
778
+
779
+ - `GalaxyApplication.close()` now awaits pending runtime-log writes through
780
+ `CliLogger.flush()`. Queued `appendFile` work could still be in flight when
781
+ close returned, which occasionally failed a teardown with
782
+ `ENOTEMPTY ... /state/logs` and could drop the last log lines on process exit.
783
+
784
+ ### Changed
785
+
786
+ - Test temp directories are removed with retries, so a slow runner cannot fail on
787
+ a transient `ENOTEMPTY`/`EBUSY` race.
788
+ - Dropped the `dist-tag` workflow: npm OIDC authorises `npm publish`, not
789
+ dist-tag mutations, so it always failed with E401. Promotion is documented in
790
+ the README instead.
791
+
792
+ ## [2.0.0-alpha.10] - 2026-09-27
793
+
794
+ ### Added
795
+
796
+ - `blackhole --version` / `blackhole -v` prints the CLI version and exits 0.
797
+ Previously `--version` was rejected as an unknown option.
798
+
799
+ ### Fixed
800
+
801
+ - A rejected option now stops with a single `Galaxy: <message>` line. The fatal
802
+ handler used to parse argv a second time to locate the runtime log, so every
803
+ bad option printed an extra Node.js stack trace. The state directory is now
804
+ resolved defensively, and the runtime log still records the fatal entry.
805
+
806
+ ### Changed
807
+
808
+ - Vietnamese permission copy for the web GUI: the Full access popup reads the
809
+ `conversation.access.*` keys, which were missing from the locale pack (and
810
+ four more keys in that namespace). The pack is now 959 keys.
811
+ - Documented dist-tag promotion. OIDC trusted publishing authorises `npm publish`
812
+ only, so promoting a version to `latest` stays a manual maintainer step.
813
+
814
+ ## [2.0.0-alpha.9] - 2026-09-27
815
+
816
+ ### Added
817
+
818
+ - `blackhole web`: boots the Galaxy Blackhole web GUI with the Galaxy
819
+ overlay under `web/` (patches + brand client package). It ships a Galaxy
820
+ brand, a Vietnamese locale, an API-key dialog backed by the DSH credential
821
+ store, and a reasoning-effort control at the composer; the key resolves from
822
+ `GBH_GALAXY_API_KEY` or `~/.galaxy/gbh/.credentials.yaml`. `blackhole chat`
823
+ is unchanged. See
824
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-09-27-web-command.md).
825
+
826
+ ## [2.0.0-alpha.8] - 2026-09-23 07:00 +07:00
827
+
828
+ ### Fixed
829
+
830
+ - `high-compaction` scenario test fixture corrected to match the SPEC: the
831
+ multi-line test (60 + 40 = 100 total quantity) now expects the platinum
832
+ discount rate (10%) as the SPEC dictates, not the gold rate (5%) the test
833
+ previously pinned. Reference implementation (sum → `tierFor(100)` →
834
+ platinum) passes all 8 tests. See
835
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-09-23-scenario-fixture-fix.md).
836
+
837
+ ## [2.0.0-alpha.7] - 2026-09-22 20:07 +07:00
838
+
839
+ ### Added
840
+
841
+ - Test-scale-up batch: a checked-in deterministic fixture now covers the
842
+ deadline-aware retry skip path end-to-end offline (`provider-retry-skip`:
843
+ tight deadline + 30s backoff + one retryable error → expect failed with
844
+ `PROVIDER_ERROR`, zero retries dispatched), and a new targeted live campaign
845
+ `high-compaction` (conservative token profile, large spec) pressures the
846
+ recovery turn at the 16-20 compaction level where the original
847
+ PRECONDITION/CONFLICT loop first appeared. The deterministic fixture parser
848
+ accepts `runtime.budget.modelRetryDelaysMs` and forwards it to the core run.
849
+ See [CHANGELOG.d fragment](CHANGELOG.d/2026-09-22-test-scale-up.md).
850
+
851
+ ## [2.0.0-alpha.6] - 2026-09-22 07:25 +07:00
852
+
853
+ ### Changed
854
+
855
+ - The four `advanced-resilience` live scenarios raise `maxModelRetries` 2 → 3
856
+ and set `modelRetryDelaysMs: [5000, 15000, 30000]` (the Gemini CLI backoff
857
+ band) so a busy ollama.com window gets real recovery time instead of 1s/3s
858
+ probes that burn the run budget. The scenario parser validates the new
859
+ budget field and `effectiveBudget` records the schedule. See
860
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-09-22-resilience-retry-budget.md).
861
+
862
+ ## [2.0.0-alpha.5] - 2026-09-22 01:07 +07:00
863
+
864
+ ### Added
865
+
866
+ - Ollama coding model now retries bounded transport failures (`ENOTFOUND`,
867
+ `ETIMEDOUT`, `ECONNRESET`, `ECONNREFUSED`, `EAI_AGAIN`) up to twice
868
+ (500 ms, 1 000 ms) before surfacing the provider error to the runtime, so a
869
+ transient DNS blip no longer kills an 11-26 minute live run.
870
+
871
+ ### Changed
872
+
873
+ - `edit_file` evaluates the content-hash precondition before searching for
874
+ `oldText`, so a stale hash consistently returns `PRECONDITION_FAILED`
875
+ including the file's current hash and how to use it in the next
876
+ `matches_sha256` precondition.
877
+ - Deterministic e2e fixtures were extended for the core recovery turn
878
+ (`stale-edit-loop` gains a fifth round; the inline hash-cycle scenario ends
879
+ with a stale `PRECONDITION_FAILED` edit before the pause). See
880
+ [CHANGELOG.d fragment](CHANGELOG.d/2026-09-22-transport-retry-precondition-order.md).
881
+
882
+ ## [2.0.0-alpha.4] - 2026-09-21 02:20 +07:00
883
+
884
+ ### Changed
885
+
886
+ - The durable-research task now states the search requirement explicitly
887
+ ("at least one search_web query") so the oracle requirement is visible in the
888
+ prompt instead of living only in the completion gate.
889
+
890
+ ## [2.0.0-alpha.3] - 2026-09-21 00:55 +07:00
891
+
892
+ ### Fixed
893
+
894
+ - Durable-research scenarios now pass research requirements into the core run
895
+ request, so the completion gate rejects search-only citations in-run with
896
+ actionable feedback instead of the supervisor oracle failing a run that
897
+ already reported `completed`. The resumed research observation seeds from the
898
+ checkpoint's persisted sources, so post-resume reports keep credit for
899
+ research completed before the crash.
900
+ - `write_file` precondition failures and `edit_file` CONFLICT failures now
901
+ state the recovery action: re-read the exact region (line endings, invisible
902
+ characters, and Unicode normalization are called out), and `must_not_exist`
903
+ reminders that it only fits the first creation.
904
+ - The smoke scenario constraint no longer traps retries into reusing a
905
+ `must_not_exist` precondition after the file exists.
906
+
907
+ ### Added
908
+
909
+ - The audit journal incident matcher maps structural failure families to
910
+ candidate incidents: INC-001 (markdown-suffixed citations), INC-004
911
+ (deadline exceeded), INC-008 (smoke precondition/write loops), INC-009
912
+ (patch target conflicts), in addition to the existing INC-003/007/010.
913
+ - `observeResearch` accepts checkpoint-seeded sources so resumed runs report
914
+ research evidence with a distinct
915
+ `current_process_with_checkpoint_seed` scope.
916
+
917
+ ### Known Trade-offs
918
+
919
+ - `live/recordings/01-write-and-validate.json` was patched in place (embedded
920
+ constraint text plus scenario fingerprint) because re-recording requires a
921
+ live run; re-record live at the next convenient session per TEST_RUNBOOK.
922
+
923
+ ## [2.0.0-alpha.2] - 2026-09-19 23:15 +07:00
924
+
925
+ ### Fixed
926
+
927
+ - Durable-research phases now arm the timer with the resolved timeout (default
928
+ 1,500,000 ms), rather than passing an undefined override that Node coerced to
929
+ approximately 1 ms.
930
+ - Explicitly listed generated/dependency directories use bounded metadata
931
+ fingerprinting. Directly read dependency files still use content hashes, and
932
+ authored workspace files retain the 512 MiB content budget.
933
+ - Ollama research schema failures include a payload SHA-256 and expected-field
934
+ type diagnostics without retaining provider payload values.
935
+
936
+ ### Added
937
+
938
+ - Live reports and the audit journal retain completion candidates, fetched /
939
+ search-only / unsupported source sets, failed tool arguments, and adapter
940
+ error messages for regression tracing.
941
+
942
+ ## [2.0.0-alpha.1] - 2026-09-19 12:15 +07:00
943
+
944
+ ### Added
945
+
946
+ - Advisory observation reminders, audit keep-going support, persistent test
947
+ journals, and the first alpha-tagged core integration.
948
+
949
+ ## [2.0.0-alpha.0] - 2026-09-18
950
+
951
+ ### Changed
952
+
953
+ - Project renamed from Galaxy Code to Galaxy Blackhole as part of the Galaxy
954
+ Stack organization plan (AI coding product line moves to the
955
+ [galaxy-blackhole](https://github.com/galaxy-blackhole) organization).
956
+ - npm package: `@galaxy-stack/blackhole-cli`; CLI command: `blackhole`.
957
+ - The legacy `galaxy-code` name remains recoverable via the
958
+ `legacy-v1-preserved` branch and is not published.
959
+
960
+ ### Added
961
+
962
+ - Workspace snapshot hardening, command containment, and Ollama chat stream
963
+ improvements (work in progress on the v2 line).
964
+ - Expanded test matrix: unit, integration, e2e campaigns, command conformance,
965
+ and GitHub lifecycle health scripts.
966
+
967
+ ## Historical
968
+
969
+ Development history before the Galaxy Blackhole rename lives in the git
970
+ history of this repository (`buikevin/galaxy-code` →
971
+ `galaxy-blackhole/galaxy-code`).