@piagent/platform 1.12.0 → 1.13.0

package/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 This file records release-facing changes for Pi Agent Platform. Copy the relevant version block into GitHub Releases when publishing a tag.
 
+## v1.13.0 - 2026-10-06
+
+Piagent on Windows through WSL2, with company conversations in a bubblewrap sandbox; personal mode on Windows itself as a preview.
+
+After updating, each member imports the Piagent configuration again in Agent Watch (macOS: Studio → Apply for Piagent; Windows: Connect Piagent in WSL). The company launcher changed, so the earlier import no longer verifies, and the dashboard says so.
+
+### Features
+
+- Company conversations run on Linux, and so in WSL2 on Windows, with a bubblewrap sandbox that keeps the macOS promises:
+  - The project, its package cache and a private temporary folder are writable.
+  - The member's other folders are readable for reference, read-only; the home folder's hidden entries are not there at all.
+  - Credential files read as empty.
+  - A command without approval gets its own network namespace: it reaches only the servers it starts itself.
+  - A command's processes end with it.
+  - Windows programs cannot be started from inside.
+  - `piagent studio --doctor` checks each of these.
+- Agent Watch for Windows binds Piagent in WSL. Piagent keeps WSL's interop variables when it starts the Windows broker, and keeps the company store in `$XDG_DATA_HOME/agentwatch` (`~/.local/share/agentwatch`) on Linux.
+- On Windows itself (preview of personal mode; `piagent-update` does not run there yet):
+  - The dashboard's project picker is Windows' folder dialog; from WSL it is that dialog too, with the answer converted to a WSL path.
+  - Links open in the Windows browser from WSL.
+  - @ suggestions find `fd`/`fdfind` and git on PATH.
+- When the company runtime cannot start from WSL, the dashboard and `piagent studio` say what to do in Agent Watch for Windows instead of pointing at macOS Keychain.
+- [Windows](docs/en/windows.md) is the setup guide. A Windows workflow runs the guard, dashboard and path tests on Windows, and the Ubuntu job runs the Linux sandbox.
+
+### Fixes
+
+- On Windows the guard treated a path on another drive (`D:\x`) as a project path, and `~\` was not the home folder; `AppData` is closed to reference reads like `~/Library`.
+- On Windows a command ending in `2>/dev/null` counted as a write (Git Bash's `/dev/null` is the null device), so read-only commands needed approval.
+- On Windows the dashboard, `piagent` and the update job could not start their TypeScript loader (a `C:\…` path given to `--import` reads as a URL scheme).
+- On Windows saving a task's journal or state failed: a file was flushed through a read-only handle, and a folder was flushed, which Windows refuses.
+- On Windows a second dashboard start could not take over from an earlier release's Gateway (its control pipe was linked like a Unix socket), and `piagent` could not register a `C:\…` project with the dashboard.
+- On Windows the dashboard did not find a globally installed Pi: npm keeps it in `%APPDATA%\npm\node_modules` or beside `node.exe`.
+- On Windows an image path such as `C:\Users\me\shot.png` or `.\shots\a.png` in a message was not attached.
+## v1.12.1 - 2026-10-06
+
+### Fixes
+
+- A forked company conversation takes messages again. The fork was written where Pi keeps personal conversations, outside the member's company session folder, so the dashboard listed it but every message to it returned "The message was not sent". Forks made with 1.12.0 or earlier stay unreachable: fork the source conversation again after updating.
+
 ## v1.12.0 - 2026-10-06
 
 @ in the dashboard picks any file or folder on the Mac, and the agent reads folders outside the project for reference.

package/README.md

@@ -34,8 +34,8 @@ Because it runs from an installed package, the source it writes into `.pi/settin
 | Linux x64 + Bash | Verified in CI for this release. |
 | macOS Intel (`darwin/x64`) + Bash | Supported target, but run `piagent-doctor` and project smoke tests before wide rollout. |
 | Linux ARM64 + Bash | Supported target, but run `piagent-doctor` and project smoke tests before wide rollout. |
-| Native Windows | Not a team-rollout target yet; terminal helpers and shell policy rely on Bash/POSIX semantics. |
-| WSL2 | Experimental and not release-gated yet. |
+| WSL2 (Windows) | The way to run Piagent on Windows: company mode with the bubblewrap sandbox and Agent Watch for Windows, and personal mode. The Linux sandbox is checked in CI. See [Windows](docs/en/windows.md). |
+| Native Windows | Preview of personal mode: the guard, path and dashboard tests run in CI on Windows; `piagent-update` does not run there yet. See [Windows](docs/en/windows.md). |
 
 Pinned step-by-step rollouts, updates, rollback, and the fast-moving `--dev` channel are in [Release and install policy](docs/release-install-policy.md).
 
@@ -346,7 +346,7 @@ This repository intentionally excludes:
 
 ## Maturity
 
-The current package version is read from package metadata and release tags. Personal machines may follow the unpinned package source when accepting ongoing updates; production/team quickstarts and committed project settings should pin an explicit tag such as `v1.12.0` or a reviewed commit.
+The current package version is read from package metadata and release tags. Personal machines may follow the unpinned package source when accepting ongoing updates; production/team quickstarts and committed project settings should pin an explicit tag such as `v1.13.0` or a reviewed commit.
 
 Ready for:
 

package/README.vi.md

@@ -34,6 +34,10 @@ Main có tối đa hai trợ lý chỉ đọc; không sinh nhánh con tiếp. Re
 
 Bản local này chưa phải bản phát hành có Developer ID. [Trạng thái nghiệm thu](docs/managed-local-acceptance.md) phân biệt test nội bộ, gọi provider thật và phần còn thiếu.
 
+## Windows
+
+Trên Windows, Piagent chạy trong WSL2 (Ubuntu): chế độ công ty với sandbox bubblewrap và Agent Watch cho Windows, và cả chế độ cá nhân. Chạy thẳng trên Windows mới là bản xem trước cho chế độ cá nhân. Cài đặt từng bước: [Windows](docs/vi/windows.md).
+
 ## Web search và vision
 
 Web research và đọc ảnh là hai capability tách biệt. Tích hợp `pi-web-access`
@@ -175,7 +179,7 @@ Xem [bằng chứng benchmark](https://piagent.io.vn/benchmark) và
 
 Gate này chạy architecture check, test, typecheck, capability validation, runtime smoke và docs consistency trước khi release.
 
-Bản phát hành hiện tại là `v1.12.0`. Với team hoặc production, hãy pin tag này
+Bản phát hành hiện tại là `v1.13.0`. Với team hoặc production, hãy pin tag này
 hoặc một commit đã review thay vì dựa vào nguồn package không cố định.
 
 ## Security

package/docs/command-reference-vietnamese.md

@@ -473,8 +473,8 @@ Các lệnh này chạy ngoài Pi.
 | Command | Dùng khi nào |
 |---|---|
 | `npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1` | Cài Pi CLI tương thích với release hiện tại. |
-| `npm install -g --ignore-scripts @piagent/platform@1.12.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.12.0` | Cài pinned release khi cần reproducible team setup. |
+| `npm install -g --ignore-scripts @piagent/platform@1.13.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.13.0` | Cài pinned release khi cần reproducible team setup. |
 | `pi install git:github.com/Vt-mmm/piagent` | Cài latest package platform cho máy cá nhân/sandbox. |
 | `piagent-update --check` | Báo version hiện tại vs version sẽ lên cho cả ba thành phần; không cài gì. |
 | `piagent-update` | Full update global một lệnh cho cả máy: Pi host → npm-global helper → Pi package, đúng thứ tự release yêu cầu. |

package/docs/distribution-standard.md

@@ -15,9 +15,9 @@ Repo này phải chạy được cho nhiều project/domain khác nhau. Vì vậ
 
 | Use case | Package source |
 |---|---|
-| Team pinned release | `git:github.com/Vt-mmm/piagent@v1.12.0` |
+| Team pinned release | `git:github.com/Vt-mmm/piagent@v1.13.0` |
 | Personal/sandbox dev | `git:github.com/Vt-mmm/piagent` |
-| Registry distribution | `npm:@piagent/platform@1.12.0` |
+| Registry distribution | `npm:@piagent/platform@1.13.0` |
 | Enterprise npm (fork under another scope) | `npm:@your-scope/platform@x.y.z` |
 | Local platform dev | `/path/to/piagent` |
 
@@ -54,7 +54,7 @@ Root `package.json` có `pi` manifest trỏ tới:
 Do đó team có thể:
 
 ```bash
-pi install git:github.com/Vt-mmm/piagent@v1.12.0
+pi install git:github.com/Vt-mmm/piagent@v1.13.0
 ```
 
 Không cần biết internal folder `packages/piagent-core`. Source không pin chỉ dành cho personal/sandbox như bảng channel ở trên.
@@ -66,12 +66,12 @@ Team nên install global package một lần:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.12.0
+npm install -g --ignore-scripts @piagent/platform@1.13.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
 
-`pi install git:github.com/Vt-mmm/piagent@v1.12.0` vẫn hợp lệ nếu chỉ cần cài Pi package. Lệnh đó không tự tạo các binary terminal `piagent-*`; muốn có helper global thì dùng `npm install -g --ignore-scripts @piagent/platform@1.12.0`.
+`pi install git:github.com/Vt-mmm/piagent@v1.13.0` vẫn hợp lệ nếu chỉ cần cài Pi package. Lệnh đó không tự tạo các binary terminal `piagent-*`; muốn có helper global thì dùng `npm install -g --ignore-scripts @piagent/platform@1.13.0`.
 
 Support matrix hiện tại: macOS Apple Silicon + Bash và Linux x64 + Bash đã được verify; macOS Intel + Bash và Linux ARM64 + Bash là supported target cần chạy smoke trước rollout; native Windows chưa phải target rollout team; WSL2 experimental. Chi tiết và version runtime nằm trong [release/install policy](release-install-policy.md).
 
@@ -118,7 +118,7 @@ Nếu muốn commit sẵn `.pi/piagent-profile.json` vào repo hoặc bootstrap
 ```bash
 bash scripts/setup.sh /path/to/project \
   --profile be-readonly-fe \
-  --package-source git:github.com/Vt-mmm/piagent@v1.12.0 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.13.0 \
   --mcp-preset core \
   --subagents-preset safe
 ```

package/docs/en/README.md

@@ -6,6 +6,7 @@
 
 - [Architecture](architecture.md): dependency direction, code ownership, runtime flow, and state boundaries.
 - [Maintainer guide](maintainer-guide.md): where new code belongs, file budgets, split queue, and review checklist.
+- [Windows](windows.md): personal mode on Windows, company mode in WSL2 with the bubblewrap sandbox.
 - [Release and install policy](../release-install-policy.md)
 - [Quality benchmark](../quality-benchmark.md)
 - [Security threat model](../security-threat-model.md)

package/docs/en/windows.md

@@ -0,0 +1,66 @@
+# Piagent on Windows
+
+[Tiếng Việt](../vi/windows.md)
+
+On Windows, run Piagent in **WSL2** (Ubuntu), for company and personal conversations alike:
+
+| Mode | Where it runs | What it needs |
+|---|---|---|
+| Company (models through Agent Studio) | WSL2 | WSL2, bubblewrap, Agent Watch for Windows |
+| Personal (your own AI account) | WSL2 (recommended), or Windows itself as a preview | WSL2; for the preview, Node 24 and Git for Windows |
+
+Company mode needs an operating-system sandbox around every command the agent runs. On macOS that is Seatbelt; on Linux and WSL2 it is bubblewrap. Windows has no equivalent sandbox an agent can use yet, so company mode runs in WSL2.
+
+## Company mode in WSL2
+
+1. Install WSL2 with Ubuntu (PowerShell): `wsl --install -d Ubuntu`.
+2. In Ubuntu:
+
+   ```bash
+   sudo apt-get update && sudo apt-get install -y bubblewrap git ripgrep fd-find build-essential curl
+   curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash && . ~/.nvm/nvm.sh && nvm install 24
+   npm install -g --ignore-scripts @piagent/platform
+   piagent-update
+   piagent --help
+   ```
+
+   `piagent --help` runs once so Piagent records where it is installed, for Agent Watch.
+
+3. Install Agent Watch for Windows (PowerShell), paste the connection code your admin sent, choose **Kết nối** (Connect), then **Kết nối Piagent trong WSL** (Connect Piagent in WSL):
+
+   ```powershell
+   irm https://raw.githubusercontent.com/Vt-mmm/agentwatch/main/windows/install.ps1 | iex
+   ```
+
+   Full guide: [Agent Watch for Windows](https://github.com/Vt-mmm/agentwatch/blob/main/windows/README.md). After each Piagent update, choose **Kết nối Piagent trong WSL** again (Agent Watch does it when it starts).
+4. In Ubuntu: `piagent dashboard` (opens in the Windows browser) or `piagent studio --project ~/projects/shop`.
+
+Check the machine with `piagent studio --doctor`.
+
+### The sandbox on Linux and WSL2
+
+It keeps the macOS sandbox's promises, built from bubblewrap mounts:
+
+- The project is writable; the project's package cache is writable (`~/.cache/piagent/sandbox`); there is a private temporary folder.
+- Other folders in the home folder are readable for reference when you point to them, read-only; hidden entries of the home folder (`~/.ssh`, `~/.bashrc`, tool settings…) are not in the sandbox at all.
+- Credential files (`.env`, `.npmrc`, `credentials`, `auth.json`) read as empty.
+- A command without network approval runs in its own network namespace: it reaches only the servers it starts itself (no internet, no proxy, no service running on the machine). Start a test server and run the tests in the same command; a database already running on the machine needs `run_with_network`.
+- Processes a command leaves behind end with that command.
+- Windows programs cannot be started from inside the sandbox.
+
+Unlike macOS: Windows folders (`/mnt/c/...`) are not readable for reference from a project in WSL; a project on `/mnt/c` works but is slower than one on the WSL disk.
+
+## Personal mode in WSL2
+
+Steps 1–2 above, then `piagent dashboard` in Ubuntu. No Agent Watch is needed.
+
+## Preview: personal mode on Windows itself
+
+For members who already run Pi on Windows. Piagent's guard, the dashboard's folder picker and @ suggestions handle Windows paths: another drive (`D:\…`), `AppData` and hidden entries of the home folder are not project paths, and Git Bash runs the agent's shell commands. Not there yet: `piagent-update` (it runs npm, Pi and Bash the macOS/Linux way), so install and update by hand in PowerShell:
+
+```powershell
+npm install -g --ignore-scripts @piagent/platform
+piagent dashboard
+```
+
+The dashboard needs the Pi version Piagent pins; `piagent-update --dry-run` in WSL shows it.

package/docs/languages.json

@@ -21,8 +21,8 @@
       "en": "README.md",
       "vi": "README.vi.md",
       "consistentAt": {
-        "en": "06c7ff130d376cf5893863c1a6d66eacd85b2091",
-        "vi": "001044e3720af632da921cde15bd1c0325d87c43"
+        "en": "81ef3f7ab158b11c3fa609ca6d21e7e8805c252c",
+        "vi": "ccca04fcc658b641e478f3789b85f4ce5107c49f"
       }
     },
     {
@@ -30,8 +30,8 @@
       "en": "docs/en/README.md",
       "vi": "docs/vi/README.md",
       "consistentAt": {
-        "en": "659e68ecd362bbef6cbce5a4b3fa86d4bd52f2a4",
-        "vi": "d8686c9e11aa79faecae658d7275ca14c628de18"
+        "en": "1b0cad5ad3e47b6dff855ccfef73fec5af3abd2e",
+        "vi": "5ca35d1626e3b0b55071d95028d4d148f3beb127"
       }
     },
     {
@@ -51,6 +51,15 @@
         "en": "e04ab2a64da66c59fbc2f52b472db481815c6ea5",
         "vi": "8ce84e7221156cfa3882e29d50045be989d1ea7d"
       }
+    },
+    {
+      "topic": "windows",
+      "en": "docs/en/windows.md",
+      "vi": "docs/vi/windows.md",
+      "consistentAt": {
+        "en": "7e6fdf152b4767e33861c94f3af98c75c98850e8",
+        "vi": "23513b75db9854ab41c4f485b69121b1cdb31d0f"
+      }
     }
   ]
 }

package/docs/operator-manual-vietnamese.md

@@ -19,12 +19,12 @@ Support matrix release hiện tại: macOS Apple Silicon + Bash và Linux x64 +
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.12.0
+npm install -g --ignore-scripts @piagent/platform@1.13.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
 
-Khi seed `.pi/settings.json` cho team/repo cần audit lặp lại, giữ package source dạng pinned tag như `git:github.com/Vt-mmm/piagent@v1.12.0`. Máy cá nhân có thể dùng `git:github.com/Vt-mmm/piagent` để theo latest.
+Khi seed `.pi/settings.json` cho team/repo cần audit lặp lại, giữ package source dạng pinned tag như `git:github.com/Vt-mmm/piagent@v1.13.0`. Máy cá nhân có thể dùng `git:github.com/Vt-mmm/piagent` để theo latest.
 
 Nếu đang ở source checkout của platform, dùng helper theo channel để preview trước khi đổi:
 
@@ -100,7 +100,7 @@ install package once
 
 ```bash
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.12.0
+npm install -g --ignore-scripts @piagent/platform@1.13.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -285,7 +285,7 @@ Không phải daily default. Dùng khi muốn tạo sẵn `.pi` files cho projec
 bash /path/to/piagent/scripts/setup.sh /path/to/project \
   --project-only \
   --profile auto \
-  --package-source git:github.com/Vt-mmm/piagent@v1.12.0 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.13.0 \
   --mcp-preset core \
   --subagents-preset safe
 ```
@@ -999,8 +999,8 @@ Watchdog là optional adversarial reviewer ở cuối turn, không bật mặc
 
 | Command | Dùng để |
 |---|---|
-| `npm install -g --ignore-scripts @piagent/platform@1.12.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.12.0` | Install pinned release cho reproducible team setup. |
+| `npm install -g --ignore-scripts @piagent/platform@1.13.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.13.0` | Install pinned release cho reproducible team setup. |
 | `pi install git:github.com/Vt-mmm/piagent` | Install latest platform package cho máy cá nhân/sandbox. |
 | Cài exact Pi host của release, rồi `npm install -g --ignore-scripts @piagent/platform@X.Y.Z` và `piagent-install --stable` | Full update: đồng bộ host, terminal helper và Pi package. Mỗi release pin một Pi host chính xác; lấy đúng version của release đang cài trong [release/install policy](release-install-policy.md). |
 | Cài exact Pi host ghi trong release cũ, rồi helper `vPREVIOUS` và `piagent-install --stable` | Full rollback; đánh giá lại dependency findings của host cũ trước khi hạ version. |
@@ -1096,7 +1096,7 @@ Mở lại Pi session sau khi install.
 Cài lại terminal helper đúng release rồi kiểm tra `PATH`:
 
 ```bash
-npm install -g --ignore-scripts @piagent/platform@1.12.0
+npm install -g --ignore-scripts @piagent/platform@1.13.0
 command -v piagent-install
 ```
 

package/docs/publishing-for-teams.md

@@ -41,6 +41,8 @@ pi install /path/to/piagent
 
 ## Versioning
 
+- `1.13.0`: Piagent trên Windows qua WSL2 (sandbox bubblewrap, Agent Watch cho Windows); sau khi cập nhật, mỗi thành viên nhập lại cấu hình Piagent trong Agent Watch.
+- `1.12.1`: nhánh (fork) của cuộc trò chuyện công ty gửi được tin nhắn; nhánh tạo trước bản này cần tạo lại.
 - `1.12.0`: @ trong dashboard chọn file và folder ở bất kỳ đâu trên máy, agent đọc được folder ngoài project (chỉ đọc); khung chat giữ tin nhắn đang soạn khi chuyển cuộc trò chuyện; skill và command của `.claude`, `.codex`, `.agents` (project và máy) dùng được bằng `/`; sandbox công ty chạy được unit và integration test của các ngôn ngữ phổ biến (cache package theo project, server trên localhost, Xcode đã chọn, .NET).
 - `1.11.1`: cập nhật xong luôn chạy dashboard của bản mới: nút cập nhật trong dashboard khởi động lại dashboard đúng cách (bản 1.11.0 cài xong nhưng không tự khởi động lại), và `piagent dashboard` thay dashboard của bản cũ còn đang chạy sau `piagent-update`.
 - `1.11.0`: dashboard tự kiểm tra bản mới (khi mở và mỗi 6 giờ) và cập nhật Pi + Piagent bằng một nút, Pi luôn lên đúng bản Piagent yêu cầu, khoá khi đang có lượt chạy; thanh trạng thái kiểu IDE, bảng lệnh ⌘K/Ctrl+K, ⌘,/Ctrl+, mở Cài đặt; Cài đặt có ô tìm kiếm, nhóm mục và mục Phím tắt. Máy đang ở 1.10.0 cập nhật tay một lần; từ 1.11.0 bấm nút trong dashboard.

package/docs/release-install-policy.md

@@ -153,7 +153,7 @@ Use this flow when the team needs both terminal commands and the Pi package:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.12.0
+npm install -g --ignore-scripts @piagent/platform@1.13.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -179,7 +179,7 @@ bash scripts/install-global.sh --stable
 Use this only when terminal commands are not needed:
 
 ```bash
-pi install git:github.com/Vt-mmm/piagent@v1.12.0
+pi install git:github.com/Vt-mmm/piagent@v1.13.0
 ```
 
 Direct `pi install` does not create `piagent-*` commands on `PATH`.

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@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.12.0
+npm install -g --ignore-scripts @piagent/platform@1.13.0
 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@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.12.0
+npm install -g --ignore-scripts @piagent/platform@1.13.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```

package/docs/vi/README.md

@@ -6,6 +6,7 @@
 
 - [Architecture](architecture.md): chiều dependency, ownership của code, luồng runtime và ranh giới state.
 - [Maintainer guide](maintainer-guide.md): code mới đặt ở đâu, file budget, thứ tự tách file và checklist review.
+- [Windows](windows.md): chế độ cá nhân thẳng trên Windows, chế độ công ty trong WSL2 với sandbox bubblewrap.
 - [Release và install policy](../release-install-policy.md)
 - [Quality benchmark](../quality-benchmark.md)
 - [Security threat model](../security-threat-model.md)

package/docs/vi/windows.md

@@ -0,0 +1,66 @@
+# Piagent trên Windows
+
+[English](../en/windows.md)
+
+Trên Windows, chạy Piagent trong **WSL2** (Ubuntu), cho cả cuộc trò chuyện công ty lẫn cá nhân:
+
+| Chế độ | Chạy ở đâu | Cần gì |
+|---|---|---|
+| Công ty (model qua Agent Studio) | WSL2 | WSL2, bubblewrap, Agent Watch cho Windows |
+| Cá nhân (tài khoản AI của bạn) | WSL2 (nên dùng), hoặc thẳng trên Windows ở dạng xem trước | WSL2; bản xem trước cần Node 24 và Git for Windows |
+
+Chế độ công ty cần sandbox của hệ điều hành cho mọi lệnh agent chạy. Trên macOS đó là Seatbelt; trên Linux và WSL2 là bubblewrap. Windows chưa có sandbox tương đương dùng được cho agent, nên chế độ công ty chạy trong WSL2.
+
+## Chế độ công ty trong WSL2
+
+1. Cài WSL2 với Ubuntu (PowerShell): `wsl --install -d Ubuntu`.
+2. Trong Ubuntu:
+
+   ```bash
+   sudo apt-get update && sudo apt-get install -y bubblewrap git ripgrep fd-find build-essential curl
+   curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash && . ~/.nvm/nvm.sh && nvm install 24
+   npm install -g --ignore-scripts @piagent/platform
+   piagent-update
+   piagent --help
+   ```
+
+   `piagent --help` chạy một lần để Piagent ghi lại vị trí cài đặt cho Agent Watch.
+
+3. Cài Agent Watch cho Windows (PowerShell), dán mã kết nối admin gửi, bấm **Kết nối**, rồi **Kết nối Piagent trong WSL**:
+
+   ```powershell
+   irm https://raw.githubusercontent.com/Vt-mmm/agentwatch/main/windows/install.ps1 | iex
+   ```
+
+   Hướng dẫn đầy đủ: [Agent Watch cho Windows](https://github.com/Vt-mmm/agentwatch/blob/main/windows/README.md). Sau mỗi lần cập nhật Piagent, bấm lại **Kết nối Piagent trong WSL** (Agent Watch tự làm khi mở).
+4. Trong Ubuntu: `piagent dashboard` (mở trong trình duyệt Windows) hoặc `piagent studio --project ~/projects/shop`.
+
+Kiểm tra máy: `piagent studio --doctor`.
+
+### Sandbox trên Linux và WSL2
+
+Cùng những gì sandbox macOS bảo đảm, dựng bằng mount của bubblewrap:
+
+- Project ghi được; cache package của project ghi được (`~/.cache/piagent/sandbox`); thư mục tạm riêng.
+- Folder khác trong home đọc được để tham chiếu khi bạn chỉ tới, chỉ đọc; mục ẩn trong home (`~/.ssh`, `~/.bashrc`, cấu hình tool…) không có trong sandbox.
+- File credential (`.env`, `.npmrc`, `credentials`, `auth.json`) đọc ra rỗng.
+- Lệnh chưa được duyệt mạng chạy trong network namespace riêng: chỉ tới được server do chính lệnh đó mở (không internet, không proxy, không dịch vụ đang chạy trên máy). Mở server test và chạy test trong cùng một lệnh; database đang chạy trên máy cần `run_with_network`.
+- Tiến trình một lệnh để lại kết thúc cùng lệnh đó.
+- Không gọi được chương trình Windows từ trong sandbox.
+
+Khác macOS: folder Windows (`/mnt/c/...`) chưa đọc được để tham chiếu từ một project trong WSL; project nằm trên `/mnt/c` vẫn dùng được nhưng chậm hơn trong ổ của WSL.
+
+## Chế độ cá nhân trong WSL2
+
+Làm bước 1–2 ở trên, rồi chạy `piagent dashboard` trong Ubuntu. Không cần Agent Watch.
+
+## Xem trước: chế độ cá nhân thẳng trên Windows
+
+Dành cho thành viên đã chạy Pi trên Windows. Guard của Piagent, hộp chọn folder và gợi ý @ của dashboard hiểu đường dẫn Windows: ổ đĩa khác (`D:\…`), `AppData` và mục ẩn trong home không phải đường dẫn của project, và Git Bash chạy lệnh shell của agent. Chưa có: `piagent-update` (nó chạy npm, Pi và Bash theo kiểu macOS/Linux), nên cài và cập nhật bằng tay trong PowerShell:
+
+```powershell
+npm install -g --ignore-scripts @piagent/platform
+piagent dashboard
+```
+
+Dashboard cần đúng bản Pi mà Piagent ghim; `piagent-update --dry-run` trong WSL cho biết bản đó.

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.12.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.13.0 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.12.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.13.0 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.12.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.13.0 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.12.0</p>
+  <p class="eyebrow">Piagent 1.13.0</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.12.0</a>
+    <a class="button" href="/en/whats-new">What’s new in 1.13.0</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.12.0</span>
+      <span class="card-kicker">Release 1.13.0</span>
       <h3>What’s new</h3>
-      <p>@ picks files and folders on the Mac, unsent messages are kept, skills and commands run from /, and company conversations run the tests of many languages.</p>
+      <p>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,22 @@
+<section class="section">
+  <p class="section-kicker">v1.13.0 · 2026-10-06</p>
+  <h2 id="v1-13-0">Piagent on Windows through WSL2</h2>
+  <p class="section-lead">Members on Windows run Piagent in WSL2 (Ubuntu), for company and personal conversations alike. Company conversations get a bubblewrap sandbox that keeps the macOS sandbox’s promises, and Agent Watch for Windows holds the company key. Setup: <a href="https://github.com/Vt-mmm/piagent/blob/main/docs/en/windows.md">Piagent on Windows</a>.</p>
+  <ul>
+    <li>The project, its package cache and a private temporary folder are writable; other home folders are read-only for reference; hidden home entries are not in the sandbox; credential files read as empty.</li>
+    <li>A command without network approval reaches only the servers it starts; processes it leaves behind end with it.</li>
+    <li>From WSL, the folder picker is Windows’ dialog and links open in the Windows browser.</li>
+    <li>Running on Windows itself is a preview of personal mode; <code>piagent-update</code> does not run there yet.</li>
+  </ul>
+  <p>After updating, each member imports the Piagent configuration again in Agent Watch (macOS: Studio → Apply for Piagent; Windows: Connect Piagent in WSL).</p>
+</section>
+
+<section class="section">
+  <p class="section-kicker">v1.12.1 · 2026-10-06</p>
+  <h2 id="v1-12-1">Forked company conversations take messages</h2>
+  <p class="section-lead">A fork of a company conversation, made to keep its context, now takes messages. Before, the fork was listed but every message to it said “The message was not sent”. Forks made with an earlier release need to be made again after updating.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.12.0 · 2026-10-06</p>
   <h2 id="v1-12-0">@ any folder, skills from /, and tests in the company sandbox</h2>

package/docs-site/content/index.html

@@ -1,5 +1,5 @@
 <section class="hero">
-  <p class="eyebrow">Piagent 1.12.0</p>
+  <p class="eyebrow">Piagent 1.13.0</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.12.0</a>
+    <a class="button" href="/whats-new">Có gì mới trong 1.13.0</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.12.0</span>
+      <span class="card-kicker">Bản 1.13.0</span>
       <h3>Có gì mới</h3>
-      <p>@ chọn file và folder trên máy, giữ tin nhắn đang soạn, skill và command dùng bằng /, sandbox công ty chạy được test của nhiều ngôn ngữ.</p>
+      <p>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,22 @@
+<section class="section">
+  <p class="section-kicker">v1.13.0 · 2026-10-06</p>
+  <h2 id="v1-13-0">Piagent trên Windows qua WSL2</h2>
+  <p class="section-lead">Thành viên dùng Windows chạy Piagent trong WSL2 (Ubuntu), cả cuộc trò chuyện công ty lẫn cá nhân. Cuộc trò chuyện công ty có sandbox bubblewrap giữ đúng những gì sandbox macOS bảo đảm, và Agent Watch cho Windows giữ key công ty. Hướng dẫn cài đặt: <a href="https://github.com/Vt-mmm/piagent/blob/main/docs/vi/windows.md">Piagent trên Windows</a>.</p>
+  <ul>
+    <li>Project, cache package của project và thư mục tạm riêng ghi được; folder khác trong home chỉ đọc để tham chiếu; mục ẩn trong home không có trong sandbox; file credential đọc ra rỗng.</li>
+    <li>Lệnh chưa được duyệt mạng chỉ tới được server do chính nó mở; tiến trình lệnh để lại kết thúc cùng lệnh.</li>
+    <li>Từ WSL, hộp chọn folder là hộp thoại của Windows và link mở trong trình duyệt Windows.</li>
+    <li>Chạy thẳng trên Windows là bản xem trước cho chế độ cá nhân; <code>piagent-update</code> chưa chạy ở đó.</li>
+  </ul>
+  <p>Sau khi cập nhật, mỗi thành viên nhập lại cấu hình Piagent trong Agent Watch (macOS: Studio → Áp dụng cho Piagent; Windows: Kết nối Piagent trong WSL).</p>
+</section>
+
+<section class="section">
+  <p class="section-kicker">v1.12.1 · 2026-10-06</p>
+  <h2 id="v1-12-1">Nhánh cuộc trò chuyện công ty gửi được tin nhắn</h2>
+  <p class="section-lead">Tạo nhánh (fork) một cuộc trò chuyện công ty để giữ context giờ gửi tin nhắn bình thường. Trước đây nhánh vẫn hiện trong danh sách nhưng mọi tin nhắn đều báo “Tin nhắn chưa được gửi”. Nhánh tạo bằng bản cũ cần tạo lại sau khi cập nhật.</p>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.12.0 · 2026-10-06</p>
   <h2 id="v1-12-0">@ tới mọi folder, skill dùng bằng /, và test chạy được trong sandbox công ty</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.12.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.13.0 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.12.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.13.0 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.12.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.13.0 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.12.0 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.13.0 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>