@piagent/platform 1.37.1 → 1.38.2

package/docs/research/ide-m0-spike.md

@@ -0,0 +1,101 @@
+# IDE M0: editor, terminal and sandbox probes
+
+Date: 2026-10-22. Baseline: `f598df18`, Node 22.23.3, macOS arm64.
+No production dependency, CSP or sandbox rule was changed by these probes.
+
+## Browser
+
+A real Chromium page served the exact CSP from `server/http-security.ts`.
+CodeMirror state 6.7.6/view 6.43.15 rendered a read-only document with
+`EditorView.cspNonce`. xterm 5.5.0 rendered output with its packaged CSS served
+from the same origin. Its `documentOverride` used a document proxy that adds
+our nonce only to newly created style elements, binding other document methods
+to their original receiver. No global DOM monkey patch is needed.
+
+Combined minified probe: 491,192 bytes (137,045 gzip); this includes both
+libraries, before splitting the production editor/terminal/language chunks.
+Chromium reported zero CSP violations and rendered both expected text strings.
+
+xterm 6.0.0 is unsuitable here: its shared scrollbar stylesheet uses the global
+document and bypasses `documentOverride`. Pin 5.5.0 with addon-fit 0.10.0;
+revalidate CSP before upgrading. All these packages use MIT licenses.
+
+## Personal PTY
+
+Upstream node-pty 1.1.0 contains macOS/Windows prebuilds but no Linux prebuild.
+Use `@lydell/node-pty` 1.2.0-beta.15 (MIT), an API-compatible distribution with
+platform packages for darwin arm64/x64 and linux arm64/x64. The beta pin requires
+explicit platform smoke checks before upgrades. Keep it optional so a native
+loading failure disables terminals without breaking the dashboard.
+
+An isolated npm global prefix installation succeeded on darwin-arm64. A shell
+reported `37 101` after resize, accepted Ctrl+C during sleep, then printed
+`INTERRUPT_OK` and exited zero. In Docker `node:22` linux/amd64, global install
+also succeeded and the PTY reported `37 101` and `LINUX_PTY_OK` without compiling.
+
+## Company sandbox
+
+macOS: a Node process launched *inside* the unchanged `managedSeatbelt` profile
+failed to allocate the PTY: `posix_openpt failed: Operation not permitted`.
+The fallback `/usr/bin/script` was also launched inside that profile with a real
+controlling terminal and failed: `openpty: Operation not permitted`.
+A pipe-only script probe is insufficient (it instead fails at `tcgetattr`);
+the controlling-terminal probe confirms the sandbox denial.
+
+Do not allocate a company PTY on the host as a workaround. The user's approved
+fallback is to omit M4 when neither approach works within the existing sandbox.
+macOS company terminals must therefore remain unavailable with a clear reason.
+
+Update (phase 1 follow-up): the company Gateway now creates the PTY on the
+host and starts only the shell under the unchanged offline Seatbelt profile plus
+`file-ioctl` on `/dev/ttys*` and read/write/ioctl on `/dev/tty`. Opening any other
+terminal stays denied; `tests/managed-terminal-boundary.test.mjs` checks this.
+Linux arm64: Docker Node 22 with the unchanged `bubblewrapArgs` created the
+PTY inside the sandbox, resized to 37x101, interrupted sleep and ran the next
+command successfully. M4 can support Linux while reporting macOS unavailable.
+Linux x64 under QEMU could install/load the prebuilt PTY but bubblewrap failed
+with `Creating new namespace failed: Invalid argument`; native x64 sandbox
+qualification remains unverified, rather than inferred from the arm64 result.
+
+## Reproduction and evidence
+
+Local evidence is outside the repository at
+`reports/piagent-ide-evidence/`: `m0-csp.log`, `m0-sandbox.log`,
+`m0-linux-global.log`, `m0-linux-sandbox.log`, plus probe sources under `m0/`.
+The Linux container is an isolated Colima VM; its engine privileges allow testing
+bubblewrap namespaces, not relaxing the application sandbox's mount/network rules.
+
+Baseline `npm test`: 6,499 tests, 6,150 pass, 34 fail, 315 skipped.
+The complete original failure inventory is in the required progress report;
+these are baseline observations, not evidence of milestone completion.
+
+## Kết quả tiếng Việt
+
+CodeMirror chạy với nonce; xterm 5.5.0 chạy với `documentOverride` gắn nonce
+cho thẻ style mới. Chromium không báo vi phạm CSP. Không dùng xterm 6.0.0 vì
+stylesheet scrollbar đi vòng qua API đó. Chunk thử nghiệm chung là 491.192 byte,
+gzip 137.045 byte; sản phẩm cần tải lười từng phần.
+
+Chọn thử nghiệm `@lydell/node-pty` 1.2.0-beta.15 (MIT, prebuild đa nền tảng),
+không chọn node-pty 1.1.0 vì bản đó thiếu prebuild Linux. Cài global trong prefix
+riêng trên macOS arm64 và Docker Node 22 linux/amd64 thành công. PTY personal
+resize được; trên macOS đã xác nhận Ctrl+C rồi chạy lệnh tiếp và thoát bình thường.
+
+Trong Seatbelt hiện tại, cả node-pty lẫn script(1) với terminal thật đều bị từ
+chối tạo PTY. Không đổi sandbox và không tạo PTY company trên host để lách.
+Theo ngoại lệ người dùng đã cho phép, terminal company macOS không khả dụng;
+các milestone editor, personal terminal và checkpoint vẫn tiếp tục.
+
+Cập nhật (sau phase 1): Gateway công ty tạo PTY trên host và chỉ chạy shell trong
+profile Seatbelt offline giữ nguyên, thêm `file-ioctl` trên `/dev/ttys*` và đọc/ghi/ioctl
+`/dev/tty`. Mở terminal khác vẫn bị chặn; `tests/managed-terminal-boundary.test.mjs` kiểm việc này.
+
+Linux arm64 đã qua probe PTY trong bubblewrap (resize, Ctrl+C, chạy lệnh tiếp).
+M4 có thể hỗ trợ Linux; macOS vẫn không khả dụng. Namespace trên x64 giả lập
+bị lỗi môi trường, cần kiểm lại trên Linux x64 native.
+
+The final Linux arm64 probe also proved project writes succeed, writes to
+`/outside` fail, curl to the internet fails, and a mounted credential file reads
+empty. The shell and bubblewrap exited zero after Ctrl+C and the next command.
+Linux arm64 cũng xác nhận ghi trong project được, ghi ngoài bị chặn, curl ra
+internet thất bại và credential đọc ra rỗng.

package/docs/team-onboarding.md

@@ -10,7 +10,7 @@ Một thành viên mới không cần biết local path của maintainer. Luồn
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.37.1
+npm install -g --ignore-scripts @piagent/platform@1.38.2
 piagent-install --stable
 cd /path/to/project
 pi
@@ -45,7 +45,7 @@ Mặc định team dùng stable helper:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.37.1
+npm install -g --ignore-scripts @piagent/platform@1.38.2
 piagent-install --stable --dry-run
 piagent-install --stable
 ```

package/docs/vi/maintainer-guide.md

@@ -2,6 +2,14 @@
 
 [English](../en/maintainer-guide.md)
 
+## Chạy toàn bộ test
+
+`npm test` chạy tối đa hai file test đồng thời, giống `npm run verify`.
+Nhiều file integration dùng SDK, worker sandbox và trình duyệt thật; giới hạn số
+file cạnh tranh tránh làm cạn thời gian chờ hiện có. Giới hạn này không đổi danh
+sách test hoặc assertion. Đặt tùy chọn Node runner trước đường dẫn file; nối
+`--test-concurrency=2` sau `npm test --` không cấu hình được script này.
+
 ## Rule đặt code
 
 Trước khi thêm code, cần trả lời một câu hỏi về ownership:

package/docs/vi/workspace-editor.md

@@ -0,0 +1,217 @@
+# Đọc và sửa tệp dự án trong Session Hub
+
+[English](../en/workspace-editor.md)
+
+Mở một cuộc hội thoại trong `piagent dashboard`, rồi chọn **Tệp**. Trên màn hình
+rộng, thanh bên hiện cây dự án và editor nằm cạnh chat. Trên màn hình nhỏ, Tệp mở
+thành ngăn kéo. Chọn **Phiên** để quay lại danh sách hội thoại.
+
+Chọn tệp để mở một tab editor. Cmd/Ctrl+P tìm theo tên tệp. **Tìm kiếm** tìm văn
+bản nguyên dạng và mở kết quả tại dòng tương ứng. Liên kết tệp trên thẻ công cụ,
+thay đổi mã nguồn và đề cập `@path:line` cũng mở editor. Nút **Open in VS Code**
+vẫn có trong phần thay đổi mã nguồn.
+
+Cây tôn trọng quy tắc Git ignore và tải từng thư mục. Danh sách và tìm kiếm có
+giới hạn, kèm thông báo khi kết quả bị cắt. Khi không có ripgrep, tìm kiếm dùng
+index Context Engine đã có; không tự tạo index và có thể chỉ tìm được tệp đã lập
+chỉ mục. Giao diện báo khi không thể tìm kiếm.
+
+Tệp được bảo vệ hiện khóa và không mở được. Tệp nhị phân hoặc quá lớn hiện thông
+báo thay cho nội dung. Đường dẫn không an toàn và symlink bị từ chối. Yêu cầu
+company đi qua Gateway của công ty và đọc tệp trong sandbox hiện có của phiên.
+Ghi tệp cũng đi qua boundary này. Trình duyệt không nhận Studio grant.
+
+Bộ phân tích JavaScript, TypeScript, JSON, Markdown, Python, HTML và CSS chỉ tải
+khi cần; tệp khác vẫn đọc được dưới dạng văn bản thuần.
+
+Khi có quyền ghi, sửa văn bản rồi nhấn **Cmd/Ctrl+S** hoặc **Lưu**. Tab chưa lưu
+có dấu chấm. Đóng tab có thay đổi sẽ hỏi trước khi bỏ; ẩn Tệp hoặc chuyển hội
+thoại vẫn giữ bản sửa trong bộ nhớ trang. Rời trang sẽ cảnh báo bản sửa chưa lưu.
+Bản sửa không được khôi phục sau khi khởi động lại trình duyệt. **Tệp mới** nhận
+đường dẫn tương đối; thư mục chưa có sẽ được tạo khi lưu. Tệp mới có quyền thông
+thường theo umask. **Đổi tên** và **Xóa** áp dụng cho tệp đang mở không có thay đổi
+chưa lưu, và chỉ khi tệp vẫn đúng phiên bản đang hiện: tệp đã đổi trên đĩa, hoặc
+tên mới đã tồn tại, sẽ bị từ chối. Xóa hỏi trước; Git khôi phục được tệp đã commit.
+
+Lưu kiểm tra permission profile hiện tại, đường dẫn được bảo vệ/chỉ đọc và digest
+của tệp. Nếu tệp đã đổi, chọn **Tải lại**, **Xem khác biệt** hoặc **Ghi đè**.
+Ghi đè cần xác nhận và vẫn kiểm tra phiên bản đang hiện trong hộp thoại. Khi mất
+kết nối, bản sửa được giữ; lưu lại dùng cùng command để không ghi hai lần. Nếu
+kết quả chưa xác định, giao diện yêu cầu tải lại và kiểm tra trước.
+
+Giao diện báo khi agent đang chạy. Member lưu thành công sẽ làm mới Source Changes
+và đưa ghi chú tên các tệp đã sửa vào lượt agent tiếp theo. Agent đã đọc phiên bản
+cũ phải đọc lại trước khi edit/write. Company dùng chung hàng đợi đọc/ghi với agent
+trong sandbox hiện có. Quyền chỉ đọc tắt lưu; máy chủ kiểm tra lại quyền mỗi lần lưu.
+
+## Review thay đổi của agent
+
+Tệp đang mở hiện hunk đã xác minh của agent bằng dòng thêm, khối dòng đã xóa và dấu
+ở lề. Mỗi tab đang mở hiện số hunk còn lại. **Alt+ArrowDown/Up** chuyển giữa các hunk.
+**Giữ** bỏ hunk khỏi danh sách review mà không sửa tệp; lựa chọn còn sau khi đóng
+ngăn kéo và tải lại trang trên trình duyệt này (chỉ lưu đường dẫn, digest và mã
+hunk, không lưu code), nội dung mới cần review lại.
+
+**Hoàn tác** mở preview và cần xác nhận. Thao tác dùng luồng source revert có guard
+hiện có, giữ nguyên Git index. Nếu mất phản hồi, **Kiểm tra lại** hỏi kết quả cùng
+command. Không thể hoàn tác hunk trộn thay đổi member/agent, nội dung cũ, đường dẫn
+được bảo vệ hoặc thay đổi chưa hỗ trợ. Tệp untracked mới do agent tạo có thể review
+và Giữ; chưa hỗ trợ xóa tệp qua hoàn tác. Tệp có sẵn của member không bị coi toàn bộ
+là do agent tạo.
+
+Hoạt động của agent làm mới tệp đang mở chưa có bản sửa. Bản sửa chưa lưu được giữ
+và hiện lựa chọn xung đột như khi lưu. Dấu hunk ẩn khi đang sửa bản nháp.
+**Comment dòng hiện tại** hoặc **Cmd/Ctrl+Shift+M** mở LineReview. Dòng đã xóa có nút
+comment riêng, giữ đúng số dòng cũ và nội dung. **Đưa vào ô chat** nối comment vào
+bản nháp; gửi tin nhắn để yêu cầu agent xử lý.
+
+Việc xác định hunk cần write/edit/patch được quan sát chính xác trong phiên và diff
+hiện tại đầy đủ, chưa che nội dung. CRLF và thiếu newline cuối được so sánh chính
+xác. Sửa qua shell chưa được quan sát hoặc quan sát mất khi runtime khởi động lại
+không nhận dấu hunk agent. Company review và hoàn tác trong sandbox của phiên.
+
+## Terminal personal
+
+Chọn **Terminal** cạnh Tệp, rồi **+** để mở shell của member trong project của
+cuộc trò chuyện. Mỗi cuộc trò chuyện có tối đa bốn tab. Panel nằm dưới editor trên
+màn rộng và mở drawer bên dưới trên màn hẹp. Kéo thanh phân cách để đổi chiều cao,
+hoặc focus vào thanh và dùng phím mũi tên. Terminal theo theme hiện tại;
+Ctrl+C ngắt lệnh đang chạy ở foreground.
+
+Lệnh tự gõ chạy với quyền host của member, không hỏi duyệt như lệnh agent.
+Terminal personal không phải sandbox. Đóng terminal, release hoặc restart phiên,
+hay tắt Gateway sẽ dừng process group và mọi tiến trình khởi chạy từ terminal.
+Cây tiến trình của shell được theo dõi khi shell chạy, nên job chạy nền (`cmd &`
+rồi `exit`) cũng dừng theo terminal; tiến trình cần sống lâu hơn terminal nên được
+khởi chạy ở nơi khác.
+
+Lệnh in nhanh hơn trình duyệt vẽ kịp (`yes`, `cat` một file lớn) được giãn nhịp:
+terminal tạm dừng chương trình đang ghi trong lúc trang đuổi kịp, và phần output
+trang không theo kịp được thay bằng dấu `[… output skipped …]`. Cuộc trò chuyện
+dùng chung kết nối không bị gián đoạn.
+
+Ẩn panel hoặc reload trang giữ shell khi runtime Gateway vẫn còn sống. Mở lại
+phát lại tối đa 64 KB output đã giữ của mỗi tab. Bản phát lại và phần đính cho agent
+che secret nhận diện được; terminal trực tiếp hiển thị output gốc cho member.
+Restart Gateway xóa terminal và buffer. Nếu mất biên nhận lệnh, input tạm dừng:
+**Kiểm tra lại lệnh** hỏi về đúng lệnh cũ. Kiểm tra terminal trước khi chọn
+**Đã kiểm tra, tiếp tục**. Lệnh chờ còn trong bộ nhớ trang khi đổi panel, không còn
+sau khi reload trang.
+
+Gõ `@terminal` (terminal 1) hoặc `@terminal:2` trong composer, rồi bấm Gửi để đính
+output hiện tại đã che secret. Mention lặp chỉ đính một lần, tối đa bốn tab với
+tổng 64 KB output. Mention tới terminal chưa mở thì không đính gì và tin nhắn vẫn
+được gửi như đã viết. Output được trích
+như dữ liệu không đáng tin; chỉ gõ mention chưa gửi gì. Số tab tăng trong runtime
+và không dùng lại sau khi đóng.
+
+Module PTY native là tùy chọn và có thể không khả dụng. Panel báo lý do và
+`piagent-doctor --json` có `productReadiness.personalTerminal`; các phần dashboard
+khác vẫn dùng được. Doctor kiểm tra việc nạp module, không khẳng định đã thử mở
+shell; shell không khởi động được sẽ được báo khi mở terminal. Thao tác bị từ chối
+trước khi chạy gì (không có thư mục project, terminal đã thoát) được báo đúng như
+vậy thay vì "lệnh có thể đã chạy". Chưa hỗ trợ Windows native; dùng WSL.
+
+
+## Terminal company
+
+Cuộc trò chuyện company dùng cùng panel terminal qua Gateway công ty, kể cả khi
+mở từ dashboard personal. Shell chạy trong tool boundary của cuộc trò chuyện:
+bubblewrap trên Linux và WSL, Seatbelt trên macOS. Shell không có internet, package
+proxy hoặc Docker. Ghi được vào project, thư mục Git của nó, cache package của
+project và thư mục tạm riêng, giống lệnh offline của agent; profile read-only giữ
+project chỉ đọc. File credential bị che, đường dẫn được bảo vệ giữ giới hạn của boundary.
+Shell là Bash không nạp file khởi động hoặc cấu hình shell của member.
+
+Mỗi cuộc trò chuyện có tối đa bốn terminal. Đóng terminal, release cuộc trò chuyện
+hoặc tắt Gateway công ty sẽ dừng sandbox và mọi tiến trình con, kể cả tiến trình
+đã tách riêng. Ẩn panel và reload trình duyệt giữ terminal khi runtime company
+còn sống. Mất kết nối relay tạm tắt input và tự nối lại để đọc trạng thái, phát lại
+output; không tự gửi lại lệnh. Mention terminal được đính bên trong Gateway
+công ty; Studio grant cũng chỉ ở đó.
+
+Trên macOS, Seatbelt từ chối tạo PTY, nên Gateway công ty tạo PTY và chỉ khởi
+chạy shell trong profile Seatbelt offline của agent. Profile đó thêm hai quy tắc:
+lệnh điều khiển terminal trên thiết bị terminal, và `/dev/tty`. Shell chỉ chạm được
+terminal được giao cho nó; mở terminal khác vẫn bị chặn. Không bao giờ có shell
+company chạy trên host. Chưa hỗ trợ Windows native; dùng WSL.
+
+`piagent-doctor --json` có `productReadiness.companyTerminal`. Kết quả supported
+chỉ kiểm file runtime và điều kiện tiên quyết (`ptySpawnVerified: false`), không
+khẳng định máy này đã mở được PTY trong sandbox. Luồng đầy đủ Gateway, relay và
+trình duyệt đã được kiểm chứng trên Linux arm64 trong Docker và trên macOS arm64.
+Chưa kiểm chứng riêng Linux x64 native và WSL.
+
+## Khôi phục một lượt agent
+
+Trong project Git, lượt đã kết thúc và có đổi file sẽ có nút **Khôi phục về trước
+lượt này** trong Timeline. Mở để xem trước các file bị ảnh hưởng và số lượt, rồi
+chọn **Xác nhận khôi phục**. Hệ thống hoàn tác từ lượt mới nhất về lượt đã chọn,
+xóa file do các lượt đó tạo và trả nội dung file đã sửa về trước đó. HEAD, commit
+tạo trong lượt và vùng stage của member được giữ nguyên.
+
+Nếu member đã sửa lại file bị ảnh hưởng sau lượt đó, khôi phục dừng ở lượt đó và
+nêu tên file xung đột. Các lượt mới hơn an toàn có thể đã được khôi phục; kết quả
+cho biết số lượt. Agent đang chạy, preview đã thay đổi hoặc quyền ghi bị thu hồi
+thì cần xem trước lại. Đường dẫn protected và read-only vẫn giữ giới hạn.
+Project không dùng Git thì không có checkpoint.
+
+File member lưu từ editor sau khi một lượt bắt đầu được coi là của member: khôi
+phục lượt đó sẽ báo file này là xung đột thay vì đưa nó về bản cũ. File có trên đĩa
+nhưng nằm ngoài snapshot hiện tại (bị ignore sau lượt đó, hoặc file chưa track quá
+lớn để chụp) cũng bị từ chối như vậy. Nếu một lần khôi phục dừng giữa chừng, bản
+xem trước mới chỉ liệt kê phần còn lại: file đã trở về như trước được tính là xong,
+không phải xung đột. Từ chối trước khi đổi file nào được báo là từ chối, không phải
+không chắc. Thư mục do lượt đó tạo và bị khôi phục làm rỗng sẽ được xóa. Mọi lệnh
+shell không chứng minh được là chỉ đọc đều chụp checkpoint của lượt trước khi chạy. Sửa đổi gõ
+trong terminal không được theo dõi theo cách này; kiểm tra thay đổi sau lượt vẫn
+từ chối file bị sửa sau khi lượt kết thúc.
+
+Pi TUI personal cũng có `/undo` để hoàn tác lượt gần nhất mà không gọi model.
+Lịch sử personal giữ tối đa 64 checkpoint cho mỗi project và session trong file
+chỉ chủ sở hữu truy cập được ở `.pi/piagent-state/checkpoints`; cuộc trò chuyện
+không dùng trong 30 ngày sẽ mất checkpoint. Snapshot nằm trong một repository
+riêng bên trong thư mục Git (`.git/piagent/checkpoints.git`), dùng chung object
+của project nhưng có ref riêng: `git push --mirror` không bao giờ đẩy chúng lên,
+và garbage collection của project không xóa chúng. Snapshot gồm file đã track với
+mọi kích thước, bỏ qua file chưa track lớn hơn 100 MB và không gồm submodule;
+hoàn tác không bao giờ đụng vào phần snapshot bỏ qua. Khi không chụp được
+snapshot, agent vẫn sửa file bình thường; lượt đó không có checkpoint và các
+checkpoint trước bị bỏ, vì khôi phục vượt qua lượt đó sẽ tạo ra trạng thái chưa
+từng được ghi lại. Chỉ khi một runtime khác đang giữ lịch sử của cùng session
+thì lần sửa mới phải chờ. Nếu runtime personal dừng trước snapshot cuối
+lượt, phục hồi giữ nguyên các file đã sửa và chỉ bỏ metadata checkpoint chưa
+hoàn tất. Checkpoint của các lượt đã kết thúc vẫn kiểm tra xung đột với thay đổi
+của member. Thao tác checkpoint company chạy trong sandbox
+hiện có; lịch sử company tồn tại trong vòng đời runtime.
+
+Nếu trình duyệt mất phản hồi khôi phục, **Kiểm tra lại kết quả** gửi đúng khóa yêu
+cầu cũ. Yêu cầu đang chờ còn sau khi reload cùng tab; reload không tự gửi yêu cầu.
+Giữ tab đó đến khi biết kết quả. Nếu trình duyệt không lưu được yêu cầu đang chờ,
+hệ thống từ chối gửi lần khôi phục mới. Kết quả chưa xác nhận có thể đã đổi file:
+kiểm tra file trước khi tiếp tục. Kiểm tra cùng yêu cầu không tự chạy lại thao tác
+file có kết quả chưa rõ. Nếu chỉ một số file đã đổi hoặc lưu lịch sử thất bại,
+checkpoint còn giữ có thể báo xung đột; kiểm tra và xử lý file trước khi thử
+khôi phục với preview mới.
+
+
+## Thử trọn luồng làm việc
+
+Dùng project Git thử nghiệm đã có commit đầu tiên và lệnh test đang chạy thành công.
+Với personal, mở project trong `piagent dashboard`. Với company, chọn cuộc hội thoại
+company của project.
+
+1. Mở file tracked trong Tệp, sửa nhỏ và lưu bằng Cmd/Ctrl+S.
+2. Mở Terminal, chạy lệnh test của project và kiểm tra mã thoát.
+3. Giữ một file tracked khác đang mở. Nhờ agent đọc và sửa file bằng edit/write.
+   Sau lượt đó, kiểm tra dòng thêm và dòng xóa ngay trong editor.
+4. Chọn Giữ và kiểm tra nội dung file không đổi. Nhờ agent ở lượt thứ hai tạo một
+   file nhỏ mới. Tránh sửa qua shell khi kiểm tra việc xác định hunk agent.
+5. Ở lượt agent đầu tiên, chọn Khôi phục về trước lượt này. Kiểm tra preview liệt
+   kê cả hai lượt và hai file, rồi xác nhận.
+6. Kiểm tra file ban đầu đã được trả lại, file mới đã bị xóa và bản sửa đã lưu ở
+   bước 1 vẫn còn. HEAD và vùng stage giữ nguyên.
+
+Kịch bản soak `ide-editor-terminal` kiểm tra riêng việc lưu editor có guard và chạy
+test trong terminal qua giao thức WebUI. Self-check của oracle và test transport
+không tự chứng minh đã hoàn thành một lượt chạy với model thật.

package/docs-site/architecture.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.37.1 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.38.2 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/architecture" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/architecture" hreflang="en" lang="en">EN</a>

package/docs-site/benchmark.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.37.1 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.38.2 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/benchmark" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/benchmark" hreflang="en" lang="en">EN</a>

package/docs-site/commands.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.37.1 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.38.2 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/commands" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/commands" hreflang="en" lang="en">EN</a>

package/docs-site/content/en/index.html

@@ -1,5 +1,5 @@
 <section class="hero">
-  <p class="eyebrow">Piagent 1.37.1</p>
+  <p class="eyebrow">Piagent 1.38.2</p>
   <h1>A coding agent for the whole team, checked at every step.</h1>
   <p>
     One dashboard for Terminal and the browser. Use models with your own account, or the company's models through Agent Watch and Agent Studio. The guard checks every tool call; in company mode the team's Harness asks for checks, has a subagent review the change and reports the outcome right under the answer.
@@ -13,7 +13,7 @@
   <div class="hero-actions">
     <a class="button primary" href="/en/quickstart">Get started</a>
     <a class="button" href="/en/ecosystem">Ecosystem</a>
-    <a class="button" href="/en/whats-new">What’s new in 1.37.1</a>
+    <a class="button" href="/en/whats-new">What’s new in 1.38.2</a>
     <a class="button" href="/en/commands">View commands</a>
   </div>
 </section>
@@ -89,9 +89,9 @@ piagent-setup</code></pre>
   <h2 id="where-to-start">Where to start</h2>
   <div class="card-grid">
     <a class="doc-card" href="/en/whats-new">
-      <span class="card-kicker">Release 1.37.1</span>
+      <span class="card-kicker">Release 1.38.2</span>
       <h3>What’s new</h3>
-      <p>A run Studio did not confirm closed is no longer recorded closed, a helper whose close fails keeps its answer, and team-memory lessons name the right command; in 1.37.0: an answer cut mid-stream no longer stops a long task, and <code>piagent studio --rpc</code>; in 1.36.1: a moment when Agent Watch cannot reach Studio no longer stops a task; in 1.36.0: team memory learns from what went wrong: Studio rates what memory handed over, a repeated command failure becomes a lesson; in 1.35: long tasks go on when Studio is updated or the model has a passing error; in 1.34: helpers report how their work ended, Agent Watch tells you when you are needed; in 1.33.0: runs on Pi 1.3.0; in 1.32.1: Bypass is kept after a reload, and a tab in use no longer signs out after 8 hours; in 1.32.0: a failed or stopped answer ends at Studio too; in 1.31.1: <code>memory_ask</code> right after an update; in 1.31.0: Team memory follows the branch and the team's rules, with <code>memory_ask</code>; in 1.30.1: no model names in the company Terminal; running <code>piagent studio</code> in the home folder now says to open a project folder; in 1.30.0: large contexts reach Studio over slow links and the company Terminal reads like the dashboard; in 1.29.0: the company Terminal gets its own look and Stop no longer breaks the conversation; in 1.28.3: Agent Watch updating itself no longer interrupts the company Terminal; in 1.28.2: no more “binding changed” right after an update; in 1.28.1: the company Terminal and personal Pi stop stepping on each other (no duplicate Piagent, no old company config, company chats stay in piagent studio); in 1.28.0: team memory v2; in 1.27.1: team memory keeps working while the agent calls the model; in 1.27.0: team memory, company agents remember the team's decisions and rules in each repository; in 1.26.1: a conversation is renamed while its turn runs; in 1.26.0: the Terminal's / commands and shortcuts in the dashboard, /undo for the agent's last turn, dev servers that stay up across turns; in 1.25.0: when the machine lacks something the agent asks, and the approved command runs (run_on_host outside the sandbox, start_docker in the same conversation); in 1.24.0: choose Fast on the new chat page for company conversations, and the Fast switch turns amber while on; in 1.23.1: an agent's question waits at the end of the conversation, right above the composer, and reads more easily; in 1.23.0: a Fast switch for company conversations where the Harness allows it, failed tools reported to Studio (Logs → Tool lỗi), new conversations send their first message after a Harness change; in 1.22.1: the dashboard no longer keeps loading when a project is on a Windows drive seen from WSL (/mnt/d…) or the company runtime does not answer; in 1.22.0: attach any source or text file (.html, .css, .ts, .py, Dockerfile…); in 1.21.1: Bypass can be turned on while a turn runs and stays on after a reload; in 1.21.0: questions and approvals one card at a time (the main agent's first), a notification at the top right when another conversation finishes or waits for you, Studio logs each compaction; in 1.20.0: package installs in the company sandbox no longer ask (npm, PyPI, Go, Maven, Gradle… through a registry-only proxy); in 1.19.0: company tasks with a checklist are carried to the end, every turn says whether it finished, stopped midway or failed, Docker in the company sandbox, folders with several repositories; in 1.18.0: switch the Git branch from the dashboard, retries for passing failures, Claude Haiku 5.5; in 1.17.0: the dashboard shows each project's Git branch; in 1.16.3: an updated dashboard keeps checking for releases; in 1.16.2: the Terminal says what the dashboard says: update question, /bypass, failures and Harness notes in Vietnamese; in 1.16.1: new releases are announced in a dialog and checked every hour, dashboard tabs stay signed in; in 1.16.0: Bypass for company conversations, Harness changes never interrupt you; in 1.15.2: long conversations shrink again; in 1.15.1: Studio sees what each model call is for, conversations in one folder keep their changes apart; in 1.15.0: a refused subagent says why; in 1.14: updates keep the models you chose; in 1.13: conversations keep their place, the agent's notes are formatted, Piagent on Windows through WSL2: a bubblewrap sandbox for company conversations and Agent Watch for Windows; in 1.12: @ picks files and folders on the Mac, skills and commands run from /, and forked company conversations take messages.</p>
+      <p>A VS Code-style folder tree, colour themes (Dracula, Nord…), and an editor and terminal that stay in view; in 1.38.1: the dashboard becomes an editor: file edits, terminals, inline hunk review and turn restore; Bypass that asks nothing, in company conversations too when the Harness allows it; in 1.37.1: a run Studio did not confirm closed is no longer recorded closed, a helper whose close fails keeps its answer, and team-memory lessons name the right command; in 1.37.0: an answer cut mid-stream no longer stops a long task, and <code>piagent studio --rpc</code>; in 1.36.1: a moment when Agent Watch cannot reach Studio no longer stops a task; in 1.36.0: team memory learns from what went wrong: Studio rates what memory handed over, a repeated command failure becomes a lesson; in 1.35: long tasks go on when Studio is updated or the model has a passing error; in 1.34: helpers report how their work ended, Agent Watch tells you when you are needed; in 1.33.0: runs on Pi 1.3.0; in 1.32.1: Bypass is kept after a reload, and a tab in use no longer signs out after 8 hours; in 1.32.0: a failed or stopped answer ends at Studio too; in 1.31.1: <code>memory_ask</code> right after an update; in 1.31.0: Team memory follows the branch and the team's rules, with <code>memory_ask</code>; in 1.30.1: no model names in the company Terminal; running <code>piagent studio</code> in the home folder now says to open a project folder; in 1.30.0: large contexts reach Studio over slow links and the company Terminal reads like the dashboard; in 1.29.0: the company Terminal gets its own look and Stop no longer breaks the conversation; in 1.28.3: Agent Watch updating itself no longer interrupts the company Terminal; in 1.28.2: no more “binding changed” right after an update; in 1.28.1: the company Terminal and personal Pi stop stepping on each other (no duplicate Piagent, no old company config, company chats stay in piagent studio); in 1.28.0: team memory v2; in 1.27.1: team memory keeps working while the agent calls the model; in 1.27.0: team memory, company agents remember the team's decisions and rules in each repository; in 1.26.1: a conversation is renamed while its turn runs; in 1.26.0: the Terminal's / commands and shortcuts in the dashboard, /undo for the agent's last turn, dev servers that stay up across turns; in 1.25.0: when the machine lacks something the agent asks, and the approved command runs (run_on_host outside the sandbox, start_docker in the same conversation); in 1.24.0: choose Fast on the new chat page for company conversations, and the Fast switch turns amber while on; in 1.23.1: an agent's question waits at the end of the conversation, right above the composer, and reads more easily; in 1.23.0: a Fast switch for company conversations where the Harness allows it, failed tools reported to Studio (Logs → Tool lỗi), new conversations send their first message after a Harness change; in 1.22.1: the dashboard no longer keeps loading when a project is on a Windows drive seen from WSL (/mnt/d…) or the company runtime does not answer; in 1.22.0: attach any source or text file (.html, .css, .ts, .py, Dockerfile…); in 1.21.1: Bypass can be turned on while a turn runs and stays on after a reload; in 1.21.0: questions and approvals one card at a time (the main agent's first), a notification at the top right when another conversation finishes or waits for you, Studio logs each compaction; in 1.20.0: package installs in the company sandbox no longer ask (npm, PyPI, Go, Maven, Gradle… through a registry-only proxy); in 1.19.0: company tasks with a checklist are carried to the end, every turn says whether it finished, stopped midway or failed, Docker in the company sandbox, folders with several repositories; in 1.18.0: switch the Git branch from the dashboard, retries for passing failures, Claude Haiku 5.5; in 1.17.0: the dashboard shows each project's Git branch; in 1.16.3: an updated dashboard keeps checking for releases; in 1.16.2: the Terminal says what the dashboard says: update question, /bypass, failures and Harness notes in Vietnamese; in 1.16.1: new releases are announced in a dialog and checked every hour, dashboard tabs stay signed in; in 1.16.0: Bypass for company conversations, Harness changes never interrupt you; in 1.15.2: long conversations shrink again; in 1.15.1: Studio sees what each model call is for, conversations in one folder keep their changes apart; in 1.15.0: a refused subagent says why; in 1.14: updates keep the models you chose; in 1.13: conversations keep their place, the agent's notes are formatted, Piagent on Windows through WSL2: a bubblewrap sandbox for company conversations and Agent Watch for Windows; in 1.12: @ picks files and folders on the Mac, skills and commands run from /, and forked company conversations take messages.</p>
     </a>
     <a class="doc-card" href="/en/ecosystem">
       <span class="card-kicker">Get started</span>

package/docs-site/content/en/whats-new.html

@@ -1,3 +1,26 @@
+<section class="section">
+  <p class="section-kicker">v1.38.2 · 2026-10-23</p>
+  <h2 id="v1-38-2">A folder tree as in VS Code, and colour themes</h2>
+  <p class="section-lead">The Files panel is a folder tree: folders open in place and the open file is highlighted. Pick a colour theme in Settings → Appearance or the command palette (⌘K): Dracula, One Dark, Monokai, Nord, Tokyo Night, Catppuccin, Gruvbox, Solarized, GitHub; a theme colours the interface, the editor's syntax and the terminal. The editor and terminal stay in view while a long conversation scrolls, with a splitter for their width; on phones the Files/Terminal switches stay visible.</p>
+</section>
+
+<section class="section">
+  <p class="section-kicker">v1.38.1 · 2026-10-23</p>
+  <h2 id="v1-38-1">The dashboard becomes an editor, and Bypass asks nothing</h2>
+  <p class="section-lead">Open, edit, save, rename and delete files in the dashboard (Cmd/Ctrl+P, search, a conflict prompt when the file changed on disk); project terminals (company conversations too, inside the sandbox, now on macOS); review each hunk the agent changed inline with Keep and Revert; Timeline restores to before a turn, with personal and company checkpoints shared with <code>/undo</code>. Square, IDE-like edges, and closable file and terminal tabs. <strong>Bypass</strong> as in Codex: nothing is asked or blocked, output is still redacted and <code>/undo</code> still works. Company conversations get three levels, Ask first, Full access (the old Bypass) and Bypass, when the Harness allows it (Agent Studio 0.38.0, Agent Watch 0.15.14 / Windows 0.1.17); a Studio admin can turn it off.</p>
+</section>
+
+<section class="section">
+  <p class="section-kicker">Unreleased</p>
+  <h2 id="unreleased-workspace">Edit project files beside chat</h2>
+  <p class="section-lead">Session Hub now saves edits with Cmd/Ctrl+S, marks unsaved tabs and creates files. When a file changes on disk, reload, compare or confirm an overwrite. Current write permissions and protected paths are enforced in personal and company mode; company writes stay inside the existing sandbox. The agent must reread a stale file after member edits.</p>
+  <p>Review observed agent changes directly in the editor: Keep, preview-confirmed Revert, hunk counts and line comments to chat. Clean files reload after agent edits; unsaved drafts remain intact. Newly created agent files support review; deletion through hunk revert is not yet supported.</p>
+  <p>Personal conversations now offer terminal tabs below the editor, with resize, Ctrl+C and replay after reload. Send @terminal or @terminal:2 to attach bounded redacted output. Missing native PTY support is reported without disabling the dashboard; company shells never fall back to host execution.</p>
+  <p>Company conversations now offer terminals inside the Linux/WSL sandbox through their Gateway, with network blocked, credentials masked and child processes stopped when the conversation is released. Relay reconnects restore output without resending commands. macOS reports unavailable without opening a host shell. The full workflow is verified on Linux arm64; native Linux x64 and WSL still need independent verification.</p>
+  <p>Timeline checkpoints preview affected files before restoring one or several turns. Member-edit conflicts stop restoration; commits and staged changes stay intact. Personal conversations also support /undo. A lost browser response keeps the same request across reloads for an explicit result check.</p>
+  <p>Company inline review now retains exact agent hunks across internal diff refreshes.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.37.1 · 2026-10-22</p>
   <h2 id="v1-37-1">Closes Studio can trust</h2>

package/docs-site/content/index.html

@@ -1,5 +1,5 @@
 <section class="hero">
-  <p class="eyebrow">Piagent 1.37.1</p>
+  <p class="eyebrow">Piagent 1.38.2</p>
   <h1>Coding agent cho cả team, kiểm tra từng bước.</h1>
   <p>
     Một dashboard cho Terminal và trình duyệt. Dùng model bằng tài khoản của bạn, hoặc model của công ty qua Agent Watch và Agent Studio. Guard kiểm tra từng tool call; ở chế độ công ty, Harness của team tự yêu cầu chạy check, cho subagent review và báo kết quả ngay dưới câu trả lời.
@@ -13,7 +13,7 @@
   <div class="hero-actions">
     <a class="button primary" href="/quickstart">Bắt đầu</a>
     <a class="button" href="/ecosystem">Hệ sinh thái</a>
-    <a class="button" href="/whats-new">Có gì mới trong 1.37.1</a>
+    <a class="button" href="/whats-new">Có gì mới trong 1.38.2</a>
     <a class="button" href="/commands">Xem command</a>
   </div>
 </section>
@@ -89,9 +89,9 @@ piagent-setup</code></pre>
   <h2 id="bat-dau-tu-dau">Bắt đầu từ đâu</h2>
   <div class="card-grid">
     <a class="doc-card" href="/whats-new">
-      <span class="card-kicker">Bản 1.37.1</span>
+      <span class="card-kicker">Bản 1.38.2</span>
       <h3>Có gì mới</h3>
-      <p>Run Studio chưa xác nhận đóng không còn bị ghi là đã đóng, helper đóng lỗi vẫn giữ câu trả lời, bài học team memory ghi đúng lệnh; ở 1.37.0: câu trả lời bị cắt giữa chừng không còn làm dừng task dài, có <code>piagent studio --rpc</code>; ở 1.36.1: Agent Watch mất kết nối tới Studio trong chốc lát không còn làm dừng task; ở 1.36.0: team memory học từ chỗ làm sai: Studio chấm những gì memory đã đưa, lệnh lỗi lặp lại thành bài học; ở 1.35: task dài không dừng khi Studio cập nhật hay model báo lỗi tạm thời; ở 1.34: helper báo kết quả, Agent Watch báo khi cần bạn; ở 1.33.0: chạy trên Pi 1.3.0; ở 1.32.1: Bypass được giữ sau khi tải lại, tab đang dùng không còn bị đăng xuất sau 8 giờ; ở 1.32.0: lượt lỗi hoặc bấm Stop được dừng cả ở Studio; ở 1.31.1: <code>memory_ask</code> có ngay sau khi cập nhật; ở 1.31.0: Memory của team đi theo branch và luật của team, có <code>memory_ask</code>; ở 1.30.1: Terminal công ty không còn hiện tên model, mở <code>piagent studio</code> ở thư mục home báo rõ cần vào thư mục dự án; ở 1.30.0: context lớn đi qua mạng chậm, Terminal công ty gọn như dashboard; ở 1.29.0: Terminal công ty có giao diện riêng, dừng lượt không còn làm hỏng cuộc trò chuyện; ở 1.28.3: Agent Watch tự cập nhật không còn làm gián đoạn Terminal công ty; ở 1.28.2: không còn lỗi “binding changed” ngay sau khi cập nhật; ở 1.28.1: Terminal công ty và Pi cá nhân không còn giẫm chân nhau (không nạp Piagent hai lần, dọn cấu hình công ty cũ, cuộc trò chuyện công ty chỉ mở bằng piagent studio); ở 1.28.0: team memory v2; ở 1.27.1: team memory chạy ổn cả khi agent đang gọi model; ở 1.27.0: team memory, agent công ty nhớ quyết định và quy tắc của team trong từng repo; ở 1.26.1: đổi tên cuộc trò chuyện được cả khi lượt đang chạy; ở 1.26.0: lệnh / và phím tắt của Terminal ngay trên dashboard, /undo hoàn tác lượt trước của agent, dev server chạy qua nhiều lượt; ở 1.25.0: thiếu môi trường thì agent xin quyền và chạy được sau khi bạn duyệt (run_on_host ngoài sandbox, start_docker mở Docker ngay trong cuộc trò chuyện); ở 1.24.0: chọn Fast ngay trên trang tạo cuộc trò chuyện công ty, nút Fast đổi màu vàng khi đang bật; ở 1.23.1: câu hỏi của agent luôn nằm cuối cuộc trò chuyện, ngay trên ô nhập, và dễ đọc hơn; ở 1.23.0: nút Fast cho cuộc trò chuyện công ty khi Harness cho phép, tool lỗi được báo về Studio (Logs → Tool lỗi), cuộc trò chuyện mới gửi được tin nhắn đầu sau khi Harness đổi; ở 1.22.1: dashboard không còn quay mãi khi project nằm trên ổ Windows nhìn từ WSL (/mnt/d…) hoặc phiên công ty không trả lời; ở 1.22.0: đính kèm được mọi file code và văn bản (.html, .css, .ts, .py, Dockerfile…); ở 1.21.1: bật Bypass được cả khi lượt đang chạy và được giữ sau khi tải lại; ở 1.21.0: câu hỏi và yêu cầu duyệt hiện từng cái một (main agent trước), thông báo góc phải khi cuộc trò chuyện khác xong hay đang chờ bạn, Studio ghi lại mỗi lần compact; ở 1.20.0: cài package trong sandbox công ty không phải duyệt (npm, PyPI, Go, Maven, Gradle… qua proxy chỉ cho registry); ở 1.19.0: task công ty có checklist được làm đến hết, cuối mỗi lượt báo rõ xong, dừng giữa chừng hay lỗi, Docker trong sandbox công ty, folder chứa nhiều repo; ở 1.18.0: đổi nhánh Git trên dashboard, tự thử lại khi lỗi tạm thời, Claude Haiku 5.5; ở 1.17.0: dashboard hiện nhánh Git của project; ở 1.16.3: dashboard cập nhật xong vẫn tự kiểm tra bản mới; ở 1.16.2: Terminal nói giống dashboard: hỏi cập nhật, /bypass, lỗi và ghi chú Harness bằng tiếng Việt; ở 1.16.1: bản mới được báo bằng dialog và kiểm tra mỗi giờ, tab dashboard không còn mất đăng nhập; ở 1.16.0: Bypass cho cuộc trò chuyện công ty, đổi Harness không làm gián đoạn; ở 1.15.2: cuộc trò chuyện dài tự thu gọn trở lại; ở 1.15.1: Studio thấy mỗi call của model dùng để làm gì, nhiều cuộc trò chuyện trong một folder không nhận nhầm thay đổi của nhau; ở 1.15.0: subagent bị từ chối nói đúng lý do; ở 1.14: cập nhật giữ model bạn đã chọn; ở 1.13: cuộc trò chuyện giữ chỗ đang đọc, chữ của agent có định dạng, Piagent trên Windows qua WSL2: sandbox công ty bằng bubblewrap và Agent Watch cho Windows; ở 1.12: @ chọn file và folder trên máy, skill và command dùng bằng /, nhánh cuộc trò chuyện công ty gửi được tin nhắn.</p>
+      <p>Cây thư mục như VS Code, theme màu (Dracula, Nord…), editor và terminal đứng yên khi cuộn; ở 1.38.1: dashboard thành editor: sửa file, terminal, review hunk, khôi phục lượt; Bypass không hỏi gì, cả cuộc trò chuyện công ty khi Harness bật; ở 1.37.1: run Studio chưa xác nhận đóng không còn bị ghi là đã đóng, helper đóng lỗi vẫn giữ câu trả lời, bài học team memory ghi đúng lệnh; ở 1.37.0: câu trả lời bị cắt giữa chừng không còn làm dừng task dài, có <code>piagent studio --rpc</code>; ở 1.36.1: Agent Watch mất kết nối tới Studio trong chốc lát không còn làm dừng task; ở 1.36.0: team memory học từ chỗ làm sai: Studio chấm những gì memory đã đưa, lệnh lỗi lặp lại thành bài học; ở 1.35: task dài không dừng khi Studio cập nhật hay model báo lỗi tạm thời; ở 1.34: helper báo kết quả, Agent Watch báo khi cần bạn; ở 1.33.0: chạy trên Pi 1.3.0; ở 1.32.1: Bypass được giữ sau khi tải lại, tab đang dùng không còn bị đăng xuất sau 8 giờ; ở 1.32.0: lượt lỗi hoặc bấm Stop được dừng cả ở Studio; ở 1.31.1: <code>memory_ask</code> có ngay sau khi cập nhật; ở 1.31.0: Memory của team đi theo branch và luật của team, có <code>memory_ask</code>; ở 1.30.1: Terminal công ty không còn hiện tên model, mở <code>piagent studio</code> ở thư mục home báo rõ cần vào thư mục dự án; ở 1.30.0: context lớn đi qua mạng chậm, Terminal công ty gọn như dashboard; ở 1.29.0: Terminal công ty có giao diện riêng, dừng lượt không còn làm hỏng cuộc trò chuyện; ở 1.28.3: Agent Watch tự cập nhật không còn làm gián đoạn Terminal công ty; ở 1.28.2: không còn lỗi “binding changed” ngay sau khi cập nhật; ở 1.28.1: Terminal công ty và Pi cá nhân không còn giẫm chân nhau (không nạp Piagent hai lần, dọn cấu hình công ty cũ, cuộc trò chuyện công ty chỉ mở bằng piagent studio); ở 1.28.0: team memory v2; ở 1.27.1: team memory chạy ổn cả khi agent đang gọi model; ở 1.27.0: team memory, agent công ty nhớ quyết định và quy tắc của team trong từng repo; ở 1.26.1: đổi tên cuộc trò chuyện được cả khi lượt đang chạy; ở 1.26.0: lệnh / và phím tắt của Terminal ngay trên dashboard, /undo hoàn tác lượt trước của agent, dev server chạy qua nhiều lượt; ở 1.25.0: thiếu môi trường thì agent xin quyền và chạy được sau khi bạn duyệt (run_on_host ngoài sandbox, start_docker mở Docker ngay trong cuộc trò chuyện); ở 1.24.0: chọn Fast ngay trên trang tạo cuộc trò chuyện công ty, nút Fast đổi màu vàng khi đang bật; ở 1.23.1: câu hỏi của agent luôn nằm cuối cuộc trò chuyện, ngay trên ô nhập, và dễ đọc hơn; ở 1.23.0: nút Fast cho cuộc trò chuyện công ty khi Harness cho phép, tool lỗi được báo về Studio (Logs → Tool lỗi), cuộc trò chuyện mới gửi được tin nhắn đầu sau khi Harness đổi; ở 1.22.1: dashboard không còn quay mãi khi project nằm trên ổ Windows nhìn từ WSL (/mnt/d…) hoặc phiên công ty không trả lời; ở 1.22.0: đính kèm được mọi file code và văn bản (.html, .css, .ts, .py, Dockerfile…); ở 1.21.1: bật Bypass được cả khi lượt đang chạy và được giữ sau khi tải lại; ở 1.21.0: câu hỏi và yêu cầu duyệt hiện từng cái một (main agent trước), thông báo góc phải khi cuộc trò chuyện khác xong hay đang chờ bạn, Studio ghi lại mỗi lần compact; ở 1.20.0: cài package trong sandbox công ty không phải duyệt (npm, PyPI, Go, Maven, Gradle… qua proxy chỉ cho registry); ở 1.19.0: task công ty có checklist được làm đến hết, cuối mỗi lượt báo rõ xong, dừng giữa chừng hay lỗi, Docker trong sandbox công ty, folder chứa nhiều repo; ở 1.18.0: đổi nhánh Git trên dashboard, tự thử lại khi lỗi tạm thời, Claude Haiku 5.5; ở 1.17.0: dashboard hiện nhánh Git của project; ở 1.16.3: dashboard cập nhật xong vẫn tự kiểm tra bản mới; ở 1.16.2: Terminal nói giống dashboard: hỏi cập nhật, /bypass, lỗi và ghi chú Harness bằng tiếng Việt; ở 1.16.1: bản mới được báo bằng dialog và kiểm tra mỗi giờ, tab dashboard không còn mất đăng nhập; ở 1.16.0: Bypass cho cuộc trò chuyện công ty, đổi Harness không làm gián đoạn; ở 1.15.2: cuộc trò chuyện dài tự thu gọn trở lại; ở 1.15.1: Studio thấy mỗi call của model dùng để làm gì, nhiều cuộc trò chuyện trong một folder không nhận nhầm thay đổi của nhau; ở 1.15.0: subagent bị từ chối nói đúng lý do; ở 1.14: cập nhật giữ model bạn đã chọn; ở 1.13: cuộc trò chuyện giữ chỗ đang đọc, chữ của agent có định dạng, Piagent trên Windows qua WSL2: sandbox công ty bằng bubblewrap và Agent Watch cho Windows; ở 1.12: @ chọn file và folder trên máy, skill và command dùng bằng /, nhánh cuộc trò chuyện công ty gửi được tin nhắn.</p>
     </a>
     <a class="doc-card" href="/ecosystem">
       <span class="card-kicker">Get started</span>

package/docs-site/content/whats-new.html

@@ -1,3 +1,26 @@
+<section class="section">
+  <p class="section-kicker">v1.38.2 · 2026-10-23</p>
+  <h2 id="v1-38-2">Cây thư mục như VS Code, theme màu</h2>
+  <p class="section-lead">Khung Tệp là cây thư mục: thư mục mở ngay tại chỗ, file đang mở được tô sáng. Chọn theme màu trong Cài đặt → Giao diện hoặc bảng lệnh (⌘K): Dracula, One Dark, Monokai, Nord, Tokyo Night, Catppuccin, Gruvbox, Solarized, GitHub; theme đổi màu cả giao diện, cú pháp trong editor và terminal. Editor và terminal đứng yên khi hội thoại dài cuộn xuống, kéo thanh chia để đổi độ rộng; trên điện thoại nút Tệp/Terminal luôn hiện.</p>
+</section>
+
+<section class="section">
+  <p class="section-kicker">v1.38.1 · 2026-10-23</p>
+  <h2 id="v1-38-1">Dashboard thành editor, Bypass không hỏi gì</h2>
+  <p class="section-lead">Mở, sửa, lưu, đổi tên và xóa file ngay trên dashboard (Cmd/Ctrl+P, tìm kiếm, xung đột khi file đổi trên đĩa); terminal của project (cả cuộc trò chuyện công ty, chạy trong sandbox, có trên macOS); review từng hunk agent sửa ngay trong editor với Giữ và Hoàn tác; Timeline khôi phục về trước một lượt, cá nhân và công ty dùng chung checkpoint với <code>/undo</code>. Giao diện viền vuông như IDE, file và terminal có nút đóng. <strong>Bypass</strong> như Codex: không hỏi, không chặn gì, output vẫn che secret và <code>/undo</code> vẫn hoàn tác được. Cuộc trò chuyện công ty có ba mức Hỏi trước, Toàn quyền (Bypass cũ) và Bypass, khi Harness bật (Agent Studio 0.38.0, Agent Watch 0.15.14 / Windows 0.1.17); admin Studio tắt được.</p>
+</section>
+
+<section class="section">
+  <p class="section-kicker">Chưa phát hành</p>
+  <h2 id="unreleased-workspace">Sửa tệp dự án ngay cạnh chat</h2>
+  <p class="section-lead">Session Hub lưu chỉnh sửa bằng Cmd/Ctrl+S, đánh dấu tab chưa lưu và tạo tệp mới. Khi tệp trên đĩa đã đổi, bạn có thể tải lại, so sánh hoặc xác nhận ghi đè. Quyền ghi hiện tại và đường dẫn được bảo vệ được kiểm tra ở cả personal và company; company ghi trong sandbox hiện có. Agent phải đọc lại tệp cũ sau khi member sửa.</p>
+  <p>Review thay đổi đã quan sát của agent ngay trong editor: Giữ, Hoàn tác có preview và xác nhận, số hunk và comment theo dòng đưa vào chat. Tệp chưa có bản sửa tự tải lại sau khi agent sửa; bản sửa chưa lưu được giữ. Tệp mới do agent tạo hỗ trợ review; chưa hỗ trợ xóa tệp qua hoàn tác hunk.</p>
+  <p>Cuộc trò chuyện personal có tab terminal dưới editor, đổi kích thước, Ctrl+C và phát lại khi reload. Gửi @terminal hoặc @terminal:2 để đính output giới hạn dung lượng đã che secret. Thiếu PTY native được báo mà không tắt dashboard; shell company không bao giờ chuyển sang chạy trên host.</p>
+  <p>Cuộc trò chuyện company có terminal trong sandbox Linux/WSL qua Gateway công ty: chặn mạng, che credential và dừng tiến trình con khi release cuộc trò chuyện. Relay nối lại khôi phục output mà không gửi lại lệnh. macOS báo không khả dụng, không mở shell trên host. Luồng đầy đủ đã kiểm chứng trên Linux arm64; Linux x64 native và WSL còn cần kiểm chứng riêng.</p>
+  <p>Checkpoint trong Timeline cho xem trước file trước khi khôi phục một hoặc nhiều lượt. Xung đột với sửa đổi của member sẽ dừng khôi phục; commit và vùng stage được giữ nguyên. Cuộc trò chuyện personal cũng có /undo. Khi mất phản hồi trình duyệt, yêu cầu cũ còn qua reload để bạn chủ động kiểm tra kết quả.</p>
+  <p>Review inline company giữ được hunk chính xác của agent sau các lần làm mới diff nội bộ.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.37.1 · 2026-10-22</p>
   <h2 id="v1-37-1">Đóng run mà Studio tin được</h2>

package/docs-site/context-engine.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.37.1 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.38.2 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/context-engine" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/context-engine" hreflang="en" lang="en">EN</a>

package/docs-site/ecosystem.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.37.1 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.38.2 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/ecosystem" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/ecosystem" hreflang="en" lang="en">EN</a>

package/docs-site/en/architecture.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.37.1 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.38.2 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/architecture" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/architecture" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/benchmark.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.37.1 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.38.2 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/benchmark" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/benchmark" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/commands.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.37.1 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.38.2 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/commands" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/commands" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/context-engine.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.37.1 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.38.2 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/context-engine" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/context-engine" hreflang="en" lang="en" aria-current="true">EN</a>