@piagent/platform 1.7.1 → 1.9.0

package/docs/piagent-core-improvement-plan.md

@@ -19,16 +19,14 @@ Không có cơ sở để kết luận toàn bộ lõi Piagent đã lỗi thời
 
 ## 2. Cơ sở nghiên cứu và giới hạn
 
-Đã đối chiếu 10 hệ coding agent: Pi, Codex, Claude Code, Cursor, Aider, mini-SWE-agent, OpenHands SDK, Gemini CLI, OpenCode và Cline. Tám repo công khai được ghim commit; đọc các đoạn triển khai liên quan trong 13 file nguồn và một changelog. Claude Code và Cursor được nghiên cứu qua bài kỹ thuật của tác giả, không coi đó là audit mã nguồn lõi. Bốn bài nghiên cứu được dùng ở mức abstract/phạm vi kết luận để kiểm tra giả định, không coi là tái lập thí nghiệm.
-
-Danh mục nguồn, mức đọc, SHA và đối chiếu với Piagent nằm trong [bản nghiên cứu](piagent-core-reasoning-research-2026-09-06.md) và [manifest nguồn](piagent-core-research-sources-2026-09-06.json). Các phần thiết kế bên dưới là tổng hợp đề xuất cho Piagent; kết quả của tác giả khác không phải bằng chứng Piagent sẽ đạt mức tiết kiệm tương tự.
+Đã đối chiếu Pi, tài liệu kỹ thuật của các nhà cung cấp model mà Piagent hỗ trợ và một số mẫu thiết kế coding agent phổ biến. Bốn bài nghiên cứu được dùng ở mức abstract/phạm vi kết luận để kiểm tra giả định, không coi là tái lập thí nghiệm. Các phần thiết kế bên dưới là tổng hợp đề xuất cho Piagent; kết quả công bố ở nơi khác không phải bằng chứng Piagent sẽ đạt mức tiết kiệm tương tự.
 
 Các nguồn thay đổi quyết định thiết kế rõ nhất:
 
 - Codex giải thích tác động của prefix/tool order lên cache và cách quản lý lịch sử. Piagent cần dùng telemetry ở payload thực tế cùng usage, thay vì suy từ độ dài prompt. [OpenAI, agent loop](https://openai.com/index/unrolling-the-codex-agent-loop/)
 - Anthropic ghi nhận thay đổi effort, mất reasoning khi resume và chỉ dẫn giảm verbosity có thể làm giảm chất lượng. Không mặc định hạ effort, cắt lịch sử hoặc ép trả lời ngắn để đạt chỉ tiêu token. [Postmortem 23/04/2026](https://www.anthropic.com/engineering/april-23-postmortem)
-- Cursor mô tả lấy context theo nhu cầu và đánh giá thêm bằng công việc thực tế. Piagent cần nguồn chi tiết có thể đọc lại và ghi nhận phần sửa phải làm lại sau bàn giao. [Dynamic context](https://cursor.com/blog/dynamic-context-discovery), [harness improvement](https://cursor.com/blog/continually-improving-agent-harness)
-- Aider cho thấy định dạng sửa code là một biến riêng; mini-SWE-agent cho thấy lõi đơn giản vẫn là đối chứng đáng xem xét. Không giả định thêm orchestration luôn tốt hơn. [Aider edit formats](https://aider.chat/docs/more/edit-formats.html), [mini-SWE-agent](https://mini-swe-agent.com/latest/)
+- Lấy context theo nhu cầu và đánh giá bằng công việc thực tế: Piagent cần nguồn chi tiết có thể đọc lại và ghi nhận phần sửa phải làm lại sau bàn giao.
+- Định dạng sửa code là một biến riêng, và một lõi đơn giản (chỉ shell, lịch sử tuyến tính) vẫn là đối chứng đáng xem xét. Không giả định thêm orchestration luôn tốt hơn.
 
 ## 3. Điểm xuất phát phải giữ nguyên
 

package/docs/piagent-core-plan-checkpoint-2026-09-06.json

@@ -28,8 +28,6 @@
     "stagedPaths": [],
     "onlyNewDocumentationFiles": [
       "piagent-core-improvement-plan.md",
-      "piagent-core-reasoning-research-2026-09-06.md",
-      "piagent-core-research-sources-2026-09-06.json",
       "piagent-core-plan-checkpoint-2026-09-06.json"
     ],
     "candidateIdentityNote": "New nonignored docs change whole-candidate selection. E14 source/test evidence remains historical and is not rebound by this checkpoint."
@@ -53,17 +51,8 @@
       "path": "docs/piagent-core-improvement-plan.md",
       "sha256": "b8bc53d19e753e40e9f7371248b49049933d0a9227585f6f182d8a32dc37a049",
       "bytes": 38504
-    },
-    {
-      "path": "docs/piagent-core-reasoning-research-2026-09-06.md",
-      "sha256": "bb1ce6a8544a8b72c7574226621515d257ec0e1bbd7f311d949edfe5039895d1",
-      "bytes": 26595
-    },
-    {
-      "path": "docs/piagent-core-research-sources-2026-09-06.json",
-      "sha256": "939bf4e91e916417bf9ee626a10caad39c4be8a42758436089afee3cd82a4654",
-      "bytes": 17191
     }
   ],
-  "nextActionAfterOfflineResume": "C0 preservation and hunk manifest, then C1 exact usage to task report wiring; no provider launch or full suite first."
+  "nextActionAfterOfflineResume": "C0 preservation and hunk manifest, then C1 exact usage to task report wiring; no provider launch or full suite first.",
+  "laterChange": "2026-10-02: the research record and source manifest that named other agent products were removed; the improvement plan was rewritten to name none, so its digest above is historical."
 }

package/docs/piagent-runtime-benchmark-execution-plan.md

@@ -1,6 +1,8 @@
 # Plan riêng: ổn định logic Piagent và hoàn tất benchmark 108 phiên
 <!-- language: vi; english-index: docs-site/content/en/benchmark.html -->
 
+> **Hồ sơ thiết kế trước bản 1.9.0.** Task contract, command workflow (`/workflow`, `/task`, `/fresh`, `/onboard`) và các tool task/trace/verify mô tả ở đây đã bỏ ngày 2026-09-30; session giờ là freeform và guard chỉ còn kiểm tra path, quyền, xác nhận, context budget và edit trên bản đọc cũ. Tài liệu được giữ để tra cứu lịch sử. Hành vi hiện tại: [README](../README.vi.md).
+
 > Plan ID: **PRB-108-2026-09-06** · Version: **1.16** · Ngày: **2026-09-06**
 >
 > Trạng thái: **IMPLEMENTING_A_V2_OFFLINE — Number N/R5/independent verification đã duyệt; chưa qualification/B/paid**.
@@ -224,7 +226,7 @@ Hai điểm quyết định là đề xuất quy trình, không phải hai appro
 - Không bật independent-verifier authority, cài verifier/image hoặc ký cấu hình thay operator.
 - Không giảm an toàn, tắt completion gate, xóa test đỏ hoặc đổi unsupported thành completed để đạt số phiên.
 - Không dùng 108 phiên trả phí làm integration test.
-- Không nâng dependency/model/provider, đổi sang Oh My Pi/OpenClaw/OpenClaude hoặc xây harness mới trong đợt này.
+- Không nâng dependency/model/provider, đổi sang một harness khác hoặc xây harness mới trong đợt này.
 - Không thêm private holdout, reviewer giả hoặc claim tổng quát. Waiver reviewer vẫn là waiver, `reviewed=false` phải giữ trung thực.
 - Không stash/reset/checkout/discard toàn bộ working tree, tạo worktree mới, push hoặc publish nếu chưa được yêu cầu cụ thể.
 - Workspace `/Users/vtamm/Documents/pi-company-platform` chỉ để đọc hướng dẫn; không triển khai ở đó.
@@ -233,14 +235,14 @@ Hai điểm quyết định là đề xuất quy trình, không phải hai appro
 
 Đã khảo sát ngày 06/09/2026; đây là đọc source/CI và release notes, chưa tự chạy toàn bộ test của các repo. Những cách làm sau là gợi ý thiết kế, không phải bằng chứng Piagent đã đạt.
 
-| Nguồn đã đọc | Áp dụng vào plan | Không sao chép |
+| Mẫu thiết kế | Áp dụng vào plan | Không sao chép |
 | --- | --- | --- |
-| [Oh My Pi release gate](https://github.com/can1357/oh-my-pi/blob/b2f25dbfe1e30197bae311cd8a0bccbc381f5c7b/.github/workflows/ci.yml#L476) | Chia nhóm kiểm thử, gom một release gate; đúng artifact và identity | Toàn bộ CI đa nền tảng, tính năng hoặc toolset mới |
-| [Oh My Pi session durability test](https://github.com/can1357/oh-my-pi/blob/b2f25dbfe1e30197bae311cd8a0bccbc381f5c7b/packages/coding-agent/test/session-manager-immediate-persist.test.ts#L86) | Kiểm tra trạng thái thực được lưu, không chỉ event ở bộ nhớ | Khẳng định ghi vào OS cache là bảo đảm chịu mọi mất điện |
-| [OpenClaw agent loop](https://github.com/openclaw/openclaw/blob/4b577944c8597c2d0c6406a1c214b412f68d0e8a/docs/concepts/agent-loop.md) | Owner terminal rõ; tách execution/persistence/delivery, wait timeout/run timeout, writer identity | Các fallback/retry làm thay đổi treatment 0 retry |
-| [OpenClaw testing](https://docs.openclaw.ai/help/testing) | Tách unit, integration, package, transport, live-provider; targeted trước full | Gọi mock là live proof hoặc coi phát hành thường xuyên là không có lỗi |
-| [OpenClaude loop-guard regressions](https://github.com/Gitlawb/openclaude/blob/0abfca30e5a2945678415f5328691584387720fb/src/query/toolFailureLoopGuard.test.ts#L140) | Phân biệt lỗi lặp, tiến bộ thật và user abort; test xuyên query loop | Thêm bộ đếm mới khi Piagent đã có budget và progress guard |
-| [OpenClaude release workflow](https://github.com/Gitlawb/openclaude/blob/0abfca30e5a2945678415f5328691584387720fb/.github/workflows/release.yml) | Test bản cài/đóng gói, không chỉ source tree | Publish hoặc cài global trong session này |
+| Release gate gom các nhóm kiểm thử | Chia nhóm kiểm thử, gom một release gate; đúng artifact và identity | Toàn bộ CI đa nền tảng, tính năng hoặc toolset mới |
+| Test độ bền phiên | Kiểm tra trạng thái thực được lưu, không chỉ event ở bộ nhớ | Khẳng định ghi vào OS cache là bảo đảm chịu mọi mất điện |
+| Vòng lặp agent có owner rõ | Owner terminal rõ; tách execution/persistence/delivery, wait timeout/run timeout, writer identity | Các fallback/retry làm thay đổi treatment 0 retry |
+| Phân tầng kiểm thử | Tách unit, integration, package, transport, live-provider; targeted trước full | Gọi mock là live proof hoặc coi phát hành thường xuyên là không có lỗi |
+| Chặn vòng lặp lỗi công cụ | Phân biệt lỗi lặp, tiến bộ thật và user abort; test xuyên query loop | Thêm bộ đếm mới khi Piagent đã có budget và progress guard |
+| Test bản đóng gói | Test bản cài/đóng gói, không chỉ source tree | Publish hoặc cài global trong session này |
 
 Không tiếp tục khảo sát hàng loạt harness khác trừ khi một failure cụ thể thiếu phương án và nguồn trên không giải quyết được.
 

package/docs/project-adapters.md

@@ -92,7 +92,7 @@ Quy tắc:
 - Mọi key project tự khai **thay thế nguyên key** của adapter, không merge từng phần tử. Khai `protectedPaths` nghĩa là project sở hữu list đó và không nhận thay đổi từ adapter nữa.
 - Không khai `extends` thì profile giữ nguyên hành vi cũ, self-contained.
 
-`scripts/init-project.sh` và `/onboard` ghi dạng `extends` khi profile đến từ built-in adapter. Update platform sau đó không cần chạm vào project nào.
+`scripts/init-project.sh` và `/profile` ghi dạng `extends` khi profile đến từ built-in adapter. Update platform sau đó không cần chạm vào project nào.
 
 ## Monorepo và workspace
 
@@ -137,7 +137,7 @@ Rule nằm ở `packages/piagent-core/extensions/project-shape.js`. Cả `piagen
 Default UX không bắt buộc chạy bash để set profile. Sau global install, vào project chạy:
 
 ```text
-/onboard
+/profile setup
 ```
 
 Nếu chưa có `.pi/piagent-profile.json`, onboarding nên dùng select-style setup: chọn profile trước, rồi chọn tech theo role. Native command là:
@@ -162,7 +162,7 @@ Kết quả ghi:
 
 Sau khi agent đọc Context7 cho tech tương ứng, chỉ record snapshot ngắn bằng `piagent_profile_tech_context_record`; không lưu nguyên văn docs dài.
 
-`/onboard run` cũng tạo `.pi/context-index.json`. Đây là advisory node/edge/citation map cho profile, tech, verify command, docs, risk và memory pointer; không dùng thay thế source hiện tại hoặc guard policy.
+Lượt onboard (nhờ agent trong chat) cũng tạo `.pi/context-index.json`. Đây là advisory node/edge/citation map cho profile, tech, verify command, docs, risk và memory pointer; không dùng thay thế source hiện tại hoặc guard policy.
 
 Đổi profile sau này:
 

package/docs/project-onboarding.md

@@ -3,7 +3,7 @@
 
 ## Mục tiêu
 
-Lần đầu gắn một project vào Pi Agent Platform, không nên nhảy thẳng vào `/workflow task`.
+Lần đầu gắn một project vào Pi Agent Platform, nên onboard trước khi giao việc implement lớn.
 
 Luồng chuẩn là:
 
@@ -12,11 +12,16 @@ cd /path/to/project
 pi
 /login
 <select provider/model>
-/onboard
-/onboard run
+/profile setup
+```
+
+rồi nhờ agent bằng lời thường (từ bản 1.9.0 không còn `/onboard`):
+
+```text
+Đọc project này (chỉ đọc) và ghi lại project context.
 ```
 
-`/onboard` mở menu/status runtime. Sau khi `/onboard run` chạy xong, project có file:
+Sau khi profile setup và lượt onboard xong, project có file:
 
 ```text
 .pi/piagent-profile.json
@@ -29,7 +34,7 @@ pi
 .pi/memory/MEMORY.md
 ```
 
-`/onboard run` là nơi profile và tech stack được chọn trong onboarding workflow. Ưu tiên select-style flow:
+Profile và tech stack được chọn bằng select-style flow:
 
 ```text
 /profile setup
@@ -42,7 +47,7 @@ Nếu Pi host chưa có native select, command trả card compact và lệnh det
 
 `.pi/context-index.json` là compact advisory index dạng node/edge/citation cho profile, tech stack, verify command, docs, risk, memory pointer và task handoff đã được duyệt. Nó giúp agent tìm đúng điểm vào repo nhanh hơn, nhưng không phải source of truth hoặc security boundary.
 
-Context index là Pi runtime state. Không đọc/ghi raw file này trong workflow thường ngày; dùng `/context`, `piagent_context_index_status`, `piagent_context_index_search`, `/onboard run` hoặc `piagent_context_index_record` để runtime có thể kiểm soát path và sanitize dữ liệu advisory trước khi đưa vào model.
+Context index là Pi runtime state. Không đọc/ghi raw file này trong workflow thường ngày; dùng `/context`, `piagent_context_index_status`, `piagent_context_index_search`, lượt onboard hoặc `piagent_context_index_record` để runtime có thể kiểm soát path và sanitize dữ liệu advisory trước khi đưa vào model.
 
 Memory markdown là local/private mặc định và bị ignore bởi `.pi/.gitignore`. Chỉ commit memory nếu team quyết định opt-in sau khi review/redact.
 
@@ -52,7 +57,7 @@ Memory markdown là local/private mặc định và bị ignore bởi `.pi/.giti
 
 Bash setup chỉ biết tạo template và detect marker. Nó không có model reasoning, không biết project purpose, module ownership, domain rule, hay risk boundary.
 
-`/onboard run` phải chạy sau login/model selection để chính model sẽ dùng cho task đọc qua project, chọn/gợi ý profile, và tạo snapshot.
+Lượt onboard nên chạy sau login/model selection để chính model sẽ dùng cho task đọc qua project, gợi ý profile, và tạo snapshot.
 
 ## Profile selection
 
@@ -116,13 +121,7 @@ Mục tiêu là hiểu cấu trúc và policy, không nhồi full repo vào cont
 
 ## Khi nào regenerate
 
-Chạy lại:
-
-```text
-/onboard run
-```
-
-khi có thay đổi lớn:
+Nhờ agent onboard lại ("Đọc lại project và cập nhật project context") khi có thay đổi lớn:
 
 - source layout đổi;
 - framework/runtime đổi;
@@ -130,8 +129,8 @@ khi có thay đổi lớn:
 - API/schema/migration/auth/provider policy đổi;
 - project ownership hoặc domain rule đổi.
 
-## Relationship với `/workflow task`
+## Quan hệ với việc hằng ngày
 
-`/workflow task` sẽ yêu cầu đọc `.pi/project-context.md`. Nếu file còn trạng thái `Generated: not yet`, agent phải dừng và yêu cầu chạy `/onboard run` trước.
+Agent đọc `.pi/project-context.md` như context advisory. Nếu file còn trạng thái `Generated: not yet`, nên nhờ agent onboard trước khi giao việc lớn.
 
 Đây là điểm khác với CLI thuần: context bootstrap trở thành một bước có artifact có thể review và tái dùng. `.pi/project-context.md` và `.pi/context-index.json` có thể commit cho team sau khi review; memory markdown thì private-by-default.

package/docs/publishing-for-teams.md

@@ -41,6 +41,8 @@ pi install /path/to/piagent
 
 ## Versioning
 
+- `1.9.0`: phiên freeform — bỏ task contract và các command workflow (`/workflow`, `/fresh`, `/onboard`…); khung main/research/review cho tài khoản công ty; redact credential Studio; sửa duyệt trên WebUI.
+- `1.8.0`: Pi 0.87.1, thêm GPT-6 Astra/Sol/Luna vào catalog, WebUI và tier routing opt-in. Không chạy lại 108 phiên hay claim hiệu suất GPT-6.
 - `1.7.1`: Pi 0.86.1, chờ trong phiên đang mở, sửa context/usage và phục hồi; kết quả chạy lại 14 phiên lỗi được giữ riêng, không claim một full108 mới hay tiết kiệm token tổng thể.
 - `1.7.0`: chỉ có annotated tag; macOS tag CI chạm giới hạn 40 phút hai lần nên npm và GitHub Release không được publish. Được thay bằng `1.7.1`.
 - `0.1.x`: local/internal pilot.
@@ -151,7 +153,7 @@ pi install /path/to/piagent
 2. Install the pinned terminal helper and matching Pi package.
 3. Login OAuth provider.
 4. Run `pi` in the target project.
-5. Run `/onboard`.
+5. Ask the agent to inspect the project read-only and record its project context.
 6. Choose/apply a profile inside Pi.
 
 Chi tiết: `docs/team-onboarding.md` và `docs/distribution-standard.md`.

package/docs/quality-benchmark.md

@@ -1,6 +1,8 @@
 # Quality benchmark guide
 <!-- language: vi; english-index: docs-site/content/en/benchmark.html -->
 
+> **Lưu ý bản 1.9.0.** Các suite và số liệu dưới đây được đo trên Piagent có task contract và command workflow (đến 1.8.x). Hai cơ chế này đã bỏ ngày 2026-09-30; journey/benchmark dựa vào bản ghi task là hồ sơ lịch sử cho tới khi được đo lại trên lượt freeform.
+
 ## Chạy và chấm tự động bằng một lệnh
 
 Từ terminal, chạy:

package/docs/quickstart-vietnamese.md

@@ -34,7 +34,7 @@ npm install -g @piagent/platform
 piagent-setup
 ```
 
-Chạy `piagent-setup` ngay trong thư mục project. Nó tự cài đúng Pi Coding Agent `0.86.1` mà release này pin, cài Pi package, khởi tạo `.pi/`, rồi chạy doctor. Nó cũng cài MCP baseline, subagents, và Herdr Pi integration nếu `herdr` đã có sẵn trên `PATH`; thêm `--no-mcp`, `--no-subagents`, `--no-herdr` nếu không cần, hoặc `--global-only` nếu chưa muốn đụng project nào.
+Chạy `piagent-setup` ngay trong thư mục project. Nó tự cài đúng Pi Coding Agent `0.87.1` mà release này pin, cài Pi package, khởi tạo `.pi/`, rồi chạy doctor. Nó cũng cài MCP baseline, subagents, và Herdr Pi integration nếu `herdr` đã có sẵn trên `PATH`; thêm `--no-mcp`, `--no-subagents`, `--no-herdr` nếu không cần, hoặc `--global-only` nếu chưa muốn đụng project nào.
 
 Nếu dùng [Herdr](https://herdr.dev/docs/install/) thì cài Herdr **trước** `piagent-setup`:
 
@@ -67,18 +67,22 @@ Sau khi login và chọn model intended cho project understanding:
 ```text
 /model          # hoặc Ctrl+L để chọn model bằng selector của Pi
 /scoped-models  # optional, chỉnh danh sách Ctrl+P cycle
-/commands
 /mcp            # kiểm tra MCP adapter/server
 /subagents-doctor  # health check subagent setup
-/onboard
-/onboard run
+/profile setup
 /context index
 /memory
 ```
 
+Rồi nhờ agent onboard bằng lời thường (từ bản 1.9.0 không còn `/onboard`):
+
+```text
+Đọc project này (chỉ đọc) và ghi lại project context.
+```
+
 `Ctrl+L` mở model selector, `Ctrl+P` đổi model trong scope, `Shift+Tab` đổi mức thinking. `piagent-setup` đã config sẵn `enabledModels`, MCP baseline preset `core`, và subagents preset `safe` — muốn xem hoặc đổi thì có [model-options.md](model-options.md), [mcp-and-tools.md](mcp-and-tools.md), [subagents-and-multiagent.md](subagents-and-multiagent.md).
 
-`/onboard` yêu cầu model đọc qua project theo phạm vi có kiểm soát, rồi ghi:
+Profile/tech (`/profile setup`) và lượt onboard này ghi:
 
 ```text
 .pi/piagent-profile.json
@@ -100,7 +104,7 @@ Nếu chưa có profile/tech stack, dùng select-style flow để tránh agent t
 
 `web-frontend` chọn FE + database optional; `backend-api` chọn BE + database optional; `fullstack` chọn frontend, backend và database. Nếu Pi host chưa có native select, command sẽ trả card ngắn và lệnh deterministic `/profile tech apply ...`.
 
-`.pi/project-context.md` là snapshot context cho task sau. `.pi/context-index.json` là bản đồ node/edge/citation compact để tìm đúng điểm vào repo; vẫn phải đọc source hiện tại trước khi sửa. Không đọc/ghi raw file index trong task thường ngày; dùng `/context`, `/onboard run` hoặc `piagent_context_index_record` để runtime sanitize dữ liệu advisory. Nếu snapshot còn `Generated: not yet` hoặc `/context index` báo pending/stale, agent phải dừng trước task lớn và yêu cầu chạy `/onboard run`.
+`.pi/project-context.md` là snapshot context cho task sau. `.pi/context-index.json` là bản đồ node/edge/citation compact để tìm đúng điểm vào repo; vẫn phải đọc source hiện tại trước khi sửa. Không đọc/ghi raw file index trong task thường ngày; dùng `/context`, lượt onboard hoặc `piagent_context_index_record` để runtime sanitize dữ liệu advisory. Nếu snapshot còn `Generated: not yet` hoặc `/context index` báo pending/stale, nên nhờ agent onboard lại trước task lớn.
 
 `/memory` kiểm tra chính sách memory của project. `/memory-policy` vẫn là alias. Mặc định memory là explicit-only: chỉ ghi khi user yêu cầu rõ “remember this”, không tự học transcript nền.
 
@@ -124,40 +128,35 @@ cd <project>
 pi --name "ABC-123 Short task name"
 ```
 
-Rồi mô tả việc cần làm bằng tiếng Việt hoặc tiếng Anh. Nếu quên đặt tên lúc mở Pi, gõ `/name ABC-123 Short task name` hoặc alias ngắn `/setname ABC-123 Short task name` trước khi làm tiếp; Agent Watch sẽ dùng tên session này trong report. Không cần paste checklist — input guard tự collapse boilerplate, và `/workflow task` tự cân nhắc gọi scout/planner/reviewer khi task đủ lớn.
+Rồi mô tả việc cần làm bằng tiếng Việt hoặc tiếng Anh. Nếu quên đặt tên lúc mở Pi, gõ `/name ABC-123 Short task name` hoặc alias ngắn `/setname ABC-123 Short task name` trước khi làm tiếp; Agent Watch sẽ dùng tên session này trong report. Không cần paste checklist hay gõ `/task`/`/workflow` (đã bỏ từ bản 1.9.0): guard tự áp policy cho từng tool call. Muốn chỉ đọc thì nói rõ "chỉ đọc, không sửa", hoặc đổi session sang `/permission read-only`.
 
-Mỗi Pi session chỉ dùng cho một task. Retry hoặc task mới mở session mới; resume
-thì quay lại đúng session cũ theo name/id. Source task yêu cầu project là Git
-working tree và profile có verify command thật. `/workflow scout` vẫn chạy ở
-read-only mode khi chỉ cần nghiên cứu và không sửa source.
+Nên mở session mới cho việc mới; resume thì quay lại đúng session cũ theo name/id.
 
 Muốn chạy nhiều agent song song thì gõ `herdr` thay vì `pi`, rồi mở mỗi pane một vai: implement, review read-only, verify, notes. Herdr chỉ điều phối terminal/session, không phải security boundary — gate vẫn nằm ở Pi extension và OAuth vẫn `/login` trong Pi. Chi tiết: [herdr-workflow.md](herdr-workflow.md).
 
 | Gõ | Khi nào |
 |---|---|
-| `/workflow` | Mở menu chọn task/scout/review/git/onboard. |
-| `/workflow discuss <ý tưởng>` | Requirement chưa rõ, muốn hỏi lại trước. |
-| `/workflow task <việc>` | Đã rõ, làm luôn. |
-| `/workflow scout <việc>` | Chỉ đọc, không sửa — map payment/auth/BE contract. |
-| `/workflow plan <mục tiêu>` | Muốn có plan trước khi đụng code. |
-| `/workflow review current diff` | Review việc vừa làm. |
+| `<việc cần làm>` | Đã rõ, làm luôn — nói bằng lời thường. |
+| `<việc> … chỉ đọc, không sửa` | Scout/audit, map payment/auth/BE contract. |
+| `Chưa sửa, lập plan cho <mục tiêu>` | Muốn có plan trước khi đụng code. |
+| `Review diff hiện tại` | Review việc vừa làm. |
 | `/name <task/session name>` | Đặt/đổi tên session để resume và report dễ đối chiếu. |
 | `/usage logs` | Xem các capture khi test/build output quá dài và Pi chỉ hiện preview. |
-| `/task-preflight` | Xem intent/risk/scope/model/route/approval trước task, không gọi model. |
-| `/piagent-status` | Xem phase/checkpoint/verifier/recovery/helper/receipt từ state đã quan sát. |
+| `/task-preflight <việc>` | Xem context và shadow route deterministic trước khi giao việc, không gọi model. |
+| `/piagent-status` | Xem profile, guard, runtime và model đã xác thực. |
 | `/usage efficiency` | Xem context efficiency và task metrics có nguồn; giá trị không đo được là `null`. |
-| `/workflow be-to-fe <việc>` | Backend read-only, làm FE. |
-| `/workflow commit <message>` | Commit local có kiểm soát, không push. |
-| `/workflow pr <title>` | Tạo PR, hỏi xác nhận trước khi push. |
-| `/fresh <workflow> <việc>` | Session đang nặng hoặc tràn context; nhận mọi workflow canonical, xem bằng `/fresh help`. |
+| `/profile be-readonly-fe` rồi nói việc | Backend read-only, làm FE. |
+| `Commit <các file> với message …` | Commit local; không push. |
+| `Tạo draft PR …` | Tạo PR; guard hỏi xác nhận trước khi push. |
+| `/new` | Session đang nặng hoặc tràn context: mở session mới rồi nói lại việc. |
 
-`/commands` liệt kê hết. Các alias cũ như `/task`, `/scout`, `/be-to-fe`, `/fresh-task`, `/context-index`, `/logs` vẫn chạy nhưng không còn là đường onboard chính. Giải thích từng lệnh: [command-reference-vietnamese.md](command-reference-vietnamese.md). Các workflow ép shape rõ (`/parallel-review`, `/review-loop`, `/parallel-research`, `/parallel-context-build`): [subagents-and-multiagent.md](subagents-and-multiagent.md). Runtime gate tools và cách agent tự dùng chúng: [operator-manual-vietnamese.md](operator-manual-vietnamese.md).
+Gõ `/` trong Pi để xem command hiện có. Alias `/context-index`, `/logs` vẫn chạy. Giải thích từng lệnh: [command-reference-vietnamese.md](command-reference-vietnamese.md). Các workflow ép shape rõ (`/parallel-review`, `/review-loop`, `/parallel-research`, `/parallel-context-build`): [subagents-and-multiagent.md](subagents-and-multiagent.md). Runtime gate tools và cách agent tự dùng chúng: [operator-manual-vietnamese.md](operator-manual-vietnamese.md).
 
 ## Việc user vẫn phải làm thủ công
 
 - Login OAuth lần đầu trong browser.
 - Chọn provider/model intended cho project.
-- Chạy `/onboard run` lần đầu để tạo `.pi/project-context.md` và `.pi/context-index.json`.
+- Nhờ agent onboard lần đầu để tạo `.pi/project-context.md` và `.pi/context-index.json`.
 - Chạy `/memory` nếu muốn kiểm tra hoặc dùng project memory.
 - Approve project trust nếu Pi hỏi. Sau khi hiểu rõ repo, có thể dùng `piagent-auto` hoặc Pi native `--approve` cho từng lần chạy.
 - Approve khi extension guard hỏi destructive/high-risk action.

package/docs/release-install-policy.md

@@ -7,6 +7,10 @@ Pi Agent Platform uses explicit release sources for team rollout. Personal machi
 
 This file is the canonical install, update, rollback, and release checklist. Other docs link here instead of maintaining a second release procedure.
 
+## v1.8.0 model-family boundary
+
+Pi 0.87.1 adds authenticated GPT-6 Astra, Sol and Luna choices. This release updates the SDK pin, new-session defaults and opt-in routing map, while keeping explicit model pins, prior task state and the frozen 5.6 benchmark evidence intact. Compatibility is checked without paid provider turns. The 108-session v1.7.1 result does not measure GPT-6 quality, latency or token use; a new comparative claim needs a separately approved, paired measurement.
+
 ## v1.7.1 release boundary
 
 The operator closed the paid benchmark cycle on 2026-09-22. This release uses
@@ -32,12 +36,12 @@ ordinary `release-defaults` treatment.
 
 ## Supported runtime matrix
 
-All supported environments require Node.js `>=22.19.0` and Pi Coding Agent `0.86.1`. The Pi host is installed as a Node CLI; Pi Agent Platform still defines its own release matrix because the terminal helpers and shell policy rely on Bash/POSIX behavior.
+All supported environments require Node.js `>=22.19.0` and Pi Coding Agent `0.87.1`. The Pi host is installed as a Node CLI; Pi Agent Platform still defines its own release matrix because the terminal helpers and shell policy rely on Bash/POSIX behavior.
 
-| Surface | Status for v1.7.1 | Rollout guidance |
+| Surface | Status for v1.8.0 | Rollout guidance |
 |---|---|---|
-| macOS Apple Silicon (`darwin/arm64`) + Bash | Verified for this release. | Safe default for team rollout after normal project smoke tests. |
-| Linux x64 + Bash | Verified in GitHub Actions. | Safe default for CI/server usage after normal project smoke tests. |
+| macOS Apple Silicon (`darwin/arm64`) + Bash | Local compatibility and browser checks passed; full PR/tag gate required. | Roll out after the v1.8.0 release gate passes. |
+| Linux x64 + Bash | Full GitHub Actions PR/tag gate required. | Roll out after the v1.8.0 release gate passes. |
 | macOS Intel (`darwin/x64`) + Bash | Supported target; not currently a dedicated release-gate runner. | Run `piagent-doctor` plus the target project's smoke/verify suite before broad rollout. |
 | Linux ARM64 + Bash | Supported target; not currently a dedicated release-gate runner. | Run `piagent-doctor` plus the target project's smoke/verify suite before broad rollout. |
 | Native Windows x64/ARM64 | Not supported for team rollout in this release. | Node is available on Windows, but platform helper scripts and shell parsing assume Bash/POSIX semantics. Use a verified macOS/Linux surface for release-critical work. |
@@ -129,7 +133,7 @@ These three components are versioned independently. A full install, update, or r
 
 | Channel | Source shape | Mutability | Use when |
 |---|---|---:|---|
-| `stable` | `git:github.com/Vt-mmm/piagent@<resolved-commit-sha>` from `v1.7.1` | Fixed after resolution | Default for team rollout. |
+| `stable` | `git:github.com/Vt-mmm/piagent@<resolved-commit-sha>` from `v1.8.0` | Fixed after resolution | Default for team rollout. |
 | `exact` | Tag, reviewed commit, or a tag resolved with `--resolve-tag` | Fixed when using a commit SHA | Pi-package-only roll forward, rollback, or reproduction. |
 | `dev` | `git:github.com/Vt-mmm/piagent` | Moving | Personal machine or sandbox only. |
 | `local` | `/path/to/piagent` | Local workspace | Platform development and dry-run validation. |
@@ -148,8 +152,8 @@ 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.86.1
-npm install -g --ignore-scripts @piagent/platform@1.7.1
+npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
+npm install -g --ignore-scripts @piagent/platform@1.9.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -157,8 +161,8 @@ piagent-install --stable
 The stable preview and apply output includes:
 
 ```text
-currentRelease: v1.7.1 (helper package version)
-tag: v1.7.1
+currentRelease: v1.8.0 (helper package version)
+tag: v1.8.0
 resolvedCommit: <40-char-sha>
 source: git:github.com/Vt-mmm/piagent@<40-char-sha>
 ```
@@ -175,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.7.1
+pi install git:github.com/Vt-mmm/piagent@v1.9.0
 ```
 
 Direct `pi install` does not create `piagent-*` commands on `PATH`.
@@ -240,7 +244,7 @@ Running it from a git checkout is refused rather than replacing that checkout's
 The same sequence by hand, which must keep this order because `piagent-install` fails against a host that does not match the version it pins and does not install one itself:
 
 ```bash
-npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.86.1
+npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
 npm install -g --ignore-scripts @piagent/platform@X.Y.Z
 piagent-install --stable --dry-run
 piagent-install --stable
@@ -471,4 +475,5 @@ Re-running the workflow from a branch instead skips publishing, because the publ
 - Do not publish local trust files, OAuth tokens, `auth.json`, sessions, caches, or `.env` files.
 - Review the resolved commit SHA before rollout; tag resolution improves reproducibility but is not signed package provenance by itself.
 - `npm audit --audit-level=high` covers this repository's helper dependency tree. `npm run audit:runtime` separately builds the exact optional Pi host and pinned add-on dependency tree and blocks unaccepted moderate, high, or critical findings so stale or permissive peer resolution cannot hide deployed runtime risk.
+- The only accepted runtime findings are listed in `scripts/runtime-advisory-exceptions.json`. Each entry is an owner decision for one advisory at one package path, with a reason and an end day at most 60 days after the decision. The same advisory elsewhere, any other advisory, and an expired entry still block, and the audit prints every accepted entry. For 1.9.0 (decided 2026-10-02, ends 2026-10-31) these are three denial-of-service advisories in `brace-expansion` 5.0.9, which every published Pi host pins through its npm-shrinkwrap. Remove them when a Pi host carries `brace-expansion` 5.0.12 or later.
 - Run doctor after install, update, or rollback so package source, project profile, protected paths, and share policy are checked together.

package/docs/research/harness-next-evidence-review.md

@@ -16,17 +16,17 @@ Numbers below are the authors' reported results under their own models, datasets
 
 | Source | Evidence or mechanism | What Piagent can transfer; limitation |
 | --- | --- | --- |
-| [SWE-agent, NeurIPS 2024, v3](https://arxiv.org/abs/2405.15793v3) | A purpose-built agent-computer interface; reported pass@1 of 12.5% on SWE-bench and 87.7% on HumanEvalFix. | Treat tool feedback and interface design as measurable interventions. Do not assume its 2024 interface or scores transfer to another model. |
-| [Agentless, 2024, v2](https://arxiv.org/abs/2407.01489v2) | Localization, repair, and validation as separate phases; reported 32.00% (96 fixes) on SWE-bench Lite at $0.70 per problem. | Keep control flow inspectable and compare against a simpler baseline. More orchestration is not inherently better. Different benchmark from SWE-agent's full SWE-bench result. |
+| [Agent–computer interface study, NeurIPS 2024, v3](https://arxiv.org/abs/2405.15793v3) | A purpose-built agent-computer interface; reported pass@1 of 12.5% on SWE-bench and 87.7% on HumanEvalFix. | Treat tool feedback and interface design as measurable interventions. Do not assume its 2024 interface or scores transfer to another model. |
+| [Phase-separated repair without an agent loop, 2024, v2](https://arxiv.org/abs/2407.01489v2) | Localization, repair, and validation as separate phases; reported 32.00% (96 fixes) on SWE-bench Lite at $0.70 per problem. | Keep control flow inspectable and compare against a simpler baseline. More orchestration is not inherently better. Different benchmark from the interface study's full SWE-bench result. |
 | [EvalPlus, 2023, v3](https://arxiv.org/abs/2305.01210v3) | Mutation- and LLM-generated test inputs; HumanEval+ expands tests 80-fold. Across 26 models, the paper reports pass@k reductions up to 19.3–28.9% and changed rankings. | Strengthen independent tests and measure false acceptance, not merely acceptance rate. More cases are useful only with a trustworthy oracle and relevant partitions. |
 | [CEGAR, Clarke et al., 2000](https://web.stanford.edu/class/cs357/cegar.pdf) | Distinguish real counterexamples from artifacts of an abstraction; refine the abstraction for spurious traces. | Preserve `unknown` and route verifier limitations away from blind source repair. The paper's guarantees concern its finite-state model/specification setting, not arbitrary JavaScript or finite random tests. |
 | [fast-check model-based testing](https://fast-check.dev/docs/advanced/model-based-testing/) | Generate stateful command sequences, compare with a simpler model, shrink failures, replay with seed/path. | Exercise verification/recovery histories and save minimal counterexamples. The reference model must not copy the implementation's logic. |
 | [Anthropic agent eval guidance, 2026-01-09](https://www.anthropic.com/engineering/demystifying-evals-for-ai-agents) | Separate transcript from final environment outcome, calibrate graders, validate tasks with reference solutions, distinguish pass@k from all-trial consistency. | Audit both false positives and false negatives; retain outcome and process metrics separately. This is engineering guidance, not a controlled estimate of Piagent improvement. |
 | [AgentLens, 2026, v3](https://arxiv.org/abs/2605.12925v3) | 2,614 trajectories, eight model backends, 60 SWE-bench Verified tasks; a 1,815-trajectory subset over 47 tasks. Among passing trajectories in that subset, 10.7% were classified as Lucky Passes. | Measure blind retries, regression cycles, and verification ordering in addition to final pass rate. This is a recent preprint; its labels are not proof that a specific Piagent run is bad. |
 | [Pi source README](https://github.com/earendil-works/pi/tree/main/packages/coding-agent) | Minimal extensible harness; default read/write/edit/bash tools, extension-based workflow customization. | Keep reusable enforcement in the extension while letting the model choose implementation structure. Minimalism does not replace project authorization or verification. |
-| [mini-SWE-agent](https://mini-swe-agent.com/latest/) | Bash-only actions, linear message history, independent subprocess execution. | Use an observable lean baseline and avoid hidden recovery state. Do not transplant unrestricted shell access into Piagent's protected-path policy. |
-| [OpenHands architecture](https://docs.openhands.dev/sdk/arch/overview), [SDK paper v2](https://arxiv.org/abs/2511.03690v2) | Separate SDK, tools, workspaces, and server; immutable/stateless components and portable execution. | Separate assessment from execution and UI projection; keep backend failures distinct from model failures. No numerical reduction is inferred from the abstract's qualitative production claim. |
-| [LangGraph persistence](https://docs.langchain.com/oss/javascript/langgraph/persistence) | Checkpoints and pending writes preserve completed steps; replay after a checkpoint can re-execute external calls. | Store verification receipts and resume only valid bound work. Replay is not automatically free or side-effect-free; preserve the single paid-attempt ledger. |
+| Lean bash-only agent baseline | Bash-only actions, linear message history, independent subprocess execution. | Use an observable lean baseline and avoid hidden recovery state. Do not transplant unrestricted shell access into Piagent's protected-path policy. |
+| [Agent SDK architecture paper, v2](https://arxiv.org/abs/2511.03690v2) | Separate SDK, tools, workspaces, and server; immutable/stateless components and portable execution. | Separate assessment from execution and UI projection; keep backend failures distinct from model failures. No numerical reduction is inferred from the abstract's qualitative production claim. |
+| Workflow-graph checkpointing | Checkpoints and pending writes preserve completed steps; replay after a checkpoint can re-execute external calls. | Store verification receipts and resume only valid bound work. Replay is not automatically free or side-effect-free; preserve the single paid-attempt ledger. |
 | [OpenAI evaluation guidance](https://developers.openai.com/api/docs/guides/evaluation-best-practices) | Task-specific evaluations, production failure datasets, automated scoring calibrated against human judgment. | Maintain a labelled grader audit set and separate quality, safety, and tool-selection checks. Do not add model judges as an uncalibrated completion authority. |
 
 [OpenAI's lean-prompt guidance](https://developers.openai.com/api/docs/guides/latest-model#favor-leaner-prompts) reports an internal sample with roughly 10–15% higher eval scores, 41–66% fewer total tokens, and 33–67% lower cost. The page does not establish an equivalent Piagent workload or a fresh-token saving. This is a hypothesis for a later isolated ablation, not a reason to change prompts during a frozen benchmark or advertise those numbers.
@@ -64,9 +64,9 @@ The accompanying architecture decision and evaluation protocol define how these
 
 ## Follow-up: stateful recovery and replay after admission integration
 
-Primary documentation was rechecked on 2026-08-30. The current [LangGraph checkpointer guide](https://docs.langchain.com/oss/javascript/langgraph/checkpointers) distinguishes full step checkpoints from completed per-node writes, and explicitly states that replay after a selected checkpoint re-executes later model/API calls. It also distinguishes exit-only, asynchronous, and synchronous durability. Piagent therefore cannot infer “exactly once” from the presence of a checkpoint: completed evidence reuse, pending-attempt reconciliation, and paid-attempt accounting need separate tests. The former durable-execution documentation URL now redirects to the persistence overview; the detailed checkpoint URL above is the relevant source for these claims.
+Primary documentation was rechecked on 2026-08-30. Current workflow-graph checkpointing documentation distinguishes full step checkpoints from completed per-node writes, and explicitly states that replay after a selected checkpoint re-executes later model/API calls. It also distinguishes exit-only, asynchronous, and synchronous durability. Piagent therefore cannot infer “exactly once” from the presence of a checkpoint: completed evidence reuse, pending-attempt reconciliation, and paid-attempt accounting need separate tests.
 
-The [fault-tolerance guide](https://docs.langchain.com/oss/javascript/langgraph/fault-tolerance) separates retry policy, per-attempt timeout, and exhausted-error handling. This supports keeping worker failure distinct from a source counterexample. It does not justify importing that library's default retry behavior or raising Piagent's existing ceilings. Our next recovery work must retain the actual executor/unsupported reason instead of collapsing every unavailable admission into a generic missing-proof diagnostic.
+The same documentation's fault-tolerance guidance separates retry policy, per-attempt timeout, and exhausted-error handling. This supports keeping worker failure distinct from a source counterexample. It does not justify importing that library's default retry behavior or raising Piagent's existing ceilings. Our next recovery work must retain the actual executor/unsupported reason instead of collapsing every unavailable admission into a generic missing-proof diagnostic.
 
 [fast-check's model-based guide](https://fast-check.dev/docs/advanced/model-based-testing/) compares command histories against a simplified model and warns against reproducing the implementation as the oracle. It provides shrinking plus seed/path/replay-path reproduction. The transferable test design is a small abstract authority/attempt model exercised by histories such as reserve → host death → reopen → reconcile → retry, not merely isolated method assertions. No fast-check dependency or general stateful adapter was installed by this checkpoint.
 

package/docs/runtime-harness-standard.md

@@ -1,6 +1,8 @@
 # Runtime harness standard
 <!-- language: vi; english-index: docs-site/content/en/runtime.html -->
 
+> **Hồ sơ thiết kế trước bản 1.9.0.** Task contract, command workflow (`/workflow`, `/task`, `/fresh`, `/onboard`) và các tool task/trace/verify mô tả ở đây đã bỏ ngày 2026-09-30; session giờ là freeform và guard chỉ còn kiểm tra path, quyền, xác nhận, context budget và edit trên bản đọc cũ. Tài liệu được giữ để tra cứu lịch sử. Hành vi hiện tại: [README](../README.vi.md).
+
 ## Mục tiêu
 
 Runtime harness là “máy vận hành task” dùng chung cho nhiều project:

package/docs/runtime-policy-design.md

@@ -1,6 +1,8 @@
 # Runtime policy design
 <!-- language: en -->
 
+> **Design record from before 1.9.0.** The task contract, workflow commands (`/workflow`, `/task`, `/fresh`, `/onboard`) and task/trace/verify tools described here were retired on 2026-09-30; sessions are freeform and the guard keeps its path, permission, confirmation, context-budget and stale-edit checks. Kept for reference. Current behavior: [README](../README.md).
+
 ## Mục tiêu
 
 Runtime policy là lớp kiểm soát cách agent đọc context, gọi tool, sửa source, chạy verify, và kết thúc task. Tài liệu này mô tả thiết kế trung lập của Pi Agent Platform, không phụ thuộc vào một project cụ thể.

package/docs/runtime-quality-baseline.md

@@ -1,6 +1,8 @@
 # Runtime quality baseline
 <!-- language: vi; english-index: docs-site/content/en/runtime.html -->
 
+> **Hồ sơ thiết kế trước bản 1.9.0.** Task contract, command workflow (`/workflow`, `/task`, `/fresh`, `/onboard`) và các tool task/trace/verify mô tả ở đây đã bỏ ngày 2026-09-30; session giờ là freeform và guard chỉ còn kiểm tra path, quyền, xác nhận, context budget và edit trên bản đọc cũ. Tài liệu được giữ để tra cứu lịch sử. Hành vi hiện tại: [README](../README.vi.md).
+
 ## Mục tiêu
 
 Runtime quality baseline định nghĩa bộ kiểm soát để Pi Agent Platform có thể chạy task một cách có kỷ luật cho solo, internal team, và public package.

package/docs/subagent-orchestration-capabilities.md

@@ -67,7 +67,7 @@ Core decisions:
 Daily implementation:
 
 ```text
-/workflow task Implement <task>.
+Implement <task>.
 ```
 
 The parent performs review, research, planning, implementation, and verification directly. A helper dispatch must expose its runtime estimate and fresh read-only contract; otherwise the telemetry outcome is `skip`.

package/docs/subagents-and-multiagent.md

@@ -1,7 +1,13 @@
 # Subagents và multi-agent workflow
 <!-- language: vi; english-index: docs-site/content/en/workflows.html -->
 
-## Kết luận
+## Bản harness local hiện tại
+
+Company runtime dùng hai vai trò nghiên cứu/review do Studio cấp, token theo lượt và tool worker cách ly. Main không phải chứng minh tiết kiệm 30% hoặc hai nhánh độc lập; reviewer có thể kiểm tra patch main vừa tạo. Member chỉ import trong Watch rồi dùng Auto. Cấu hình các package cá nhân bên dưới không cấp quyền chạy trong company runtime.
+
+Phần dưới mô tả tích hợp package cá nhân của bản 1.8.0 trước khi đơn giản hóa; những đoạn về workflow/task contract và ngưỡng 30% đã được thay thế trong bản local. Xem [bằng chứng local](managed-local-acceptance.md).
+
+## Tài liệu package cá nhân trước đây
 
 Pi core không có subagents built-in. Theo design của Pi, subagents là extension/package. Platform này dùng `pi-subagents` làm subagent runtime vì nó hỗ trợ:
 
@@ -149,11 +155,7 @@ Giải nghĩa nhanh:
 | `/parallel` | Chạy nhiều agent độc lập | Tốt cho read-only scout/review/test-gap analysis. |
 | `/chain` | Chạy tuần tự | Output agent trước làm input agent sau qua `{previous}`. |
 
-Nếu cần bản tổng hợp cho team mới:
-
-```text
-/commands subagents
-```
+Nếu cần bản tổng hợp cho team mới, xem [command reference](command-reference-vietnamese.md#command-subagent).
 
 ## Gọi subagent tự nhiên
 
@@ -169,10 +171,10 @@ Run a review loop on this change until reviewers stop finding fixes worth doing,
 Run parallel research: external docs, local code context, and practical tradeoffs.
 ```
 
-Với workflow platform, còn có thể chỉ gọi:
+Với workflow platform, còn có thể chỉ nói:
 
 ```text
-/workflow task Implement <task lớn>.
+Implement <task lớn>.
 ```
 
 Parent agent sẽ tự quyết định:

package/docs/task-implementation-contract.md

@@ -1,6 +1,8 @@
 # Task Implementation Contract v2
 <!-- language: en -->
 
+> **Design record from before 1.9.0.** The task contract, workflow commands (`/workflow`, `/task`, `/fresh`, `/onboard`) and task/trace/verify tools described here were retired on 2026-09-30; sessions are freeform and the guard keeps its path, permission, confirmation, context-budget and stale-edit checks. Kept for reference. Current behavior: [README](../README.md).
+
 ## Muc tieu
 
 Contract la state machine cuc bo giup Pi chung minh mot task da doc gi, duoc sua

package/docs/task-lifecycle-vietnamese.md

@@ -1,6 +1,8 @@
 # Vong doi task trong Pi Agent Platform
 <!-- language: vi; english-index: docs-site/content/en/runtime.html -->
 
+> **Hồ sơ thiết kế trước bản 1.9.0.** Task contract, command workflow (`/workflow`, `/task`, `/fresh`, `/onboard`) và các tool task/trace/verify mô tả ở đây đã bỏ ngày 2026-09-30; session giờ là freeform và guard chỉ còn kiểm tra path, quyền, xác nhận, context budget và edit trên bản đọc cũ. Tài liệu được giữ để tra cứu lịch sử. Hành vi hiện tại: [README](../README.vi.md).
+
 ## Muc tieu
 
 Tu `v1.2.11`, mot source task duoc quan ly theo chuoi khép kín: