@piagent/platform 1.7.1 → 1.9.0

package/architecture/layers.json

@@ -7,6 +7,12 @@
         "packages/piagent-core/extensions/piagent-guard.ts"
       ]
     },
+    {
+      "name": "managed",
+      "roots": [
+        "packages/piagent-core/managed"
+      ]
+    },
     {
       "name": "runtime",
       "roots": [
@@ -167,7 +173,8 @@
       "webui-shared",
       "runtime",
       "core",
-      "security"
+      "security",
+      "managed"
     ],
     "webui-ownership": [
       "webui-ownership"
@@ -195,7 +202,12 @@
       "webui-gateway",
       "webui-ownership",
       "webui-server",
-      "webui-shared"
+      "webui-shared",
+      "managed"
+    ],
+    "managed": [
+      "managed",
+      "runtime"
     ]
   },
   "lineBudgets": {
@@ -215,7 +227,8 @@
       "webui-ownership": 500,
       "webui-shared": 200,
       "webui-build": 500,
-      "entrypoints": 800
+      "entrypoints": 800,
+      "managed": 500
     },
     "files": {
       "packages/piagent-core/extensions/piagent-guard.ts": 5000,

package/catalog/capabilities.json

@@ -26,8 +26,8 @@
           "path": "evals/scenarios/capability-resolution.json"
         },
         {
-          "byteSize": 7199,
-          "digest": "sha256:661350c9d639c9f6094e5606a32587f50550ab498edabe779ec30202bd3d353f",
+          "byteSize": 7631,
+          "digest": "sha256:e50361eda8ca41dc75afdff2ff21498499147b494ad4ed7b444a4a29279ba884",
           "id": "base-policy",
           "kind": "policies",
           "path": "packages/piagent-core/policies/base-policy.json"
@@ -75,15 +75,22 @@
           "path": "packs/engineering-base/recipes/bounded-change.json"
         },
         {
-          "byteSize": 1832,
-          "digest": "sha256:a1c21e7d1c3ab12fff8516bbac2922526e35b37a6852eaa9f5a7d98a102b830e",
+          "byteSize": 1423,
+          "digest": "sha256:b6b61c4fdd895d86e908be65d0be5e08eb615c105e2e4cec71aae3c680ea2c14",
           "id": "piagent-ops",
           "kind": "skills",
           "path": "packages/piagent-core/skills/piagent-ops/SKILL.md"
         },
         {
-          "byteSize": 2223,
-          "digest": "sha256:18f865d816c5a5cee50bf3b2b407c23a2e67e1e92d929001a0f24c04d0c20e03",
+          "byteSize": 5044,
+          "digest": "sha256:d3f8071a94338d02647e28914050d25e12d06a883d5a4bf1ec1dced6576dec08",
+          "id": "test-audit",
+          "kind": "skills",
+          "path": "packages/piagent-core/skills/test-audit/SKILL.md"
+        },
+        {
+          "byteSize": 2146,
+          "digest": "sha256:81625648bbd1fc798a276b0d49131a68dec0f097fa6b73557a339376cd5502ca",
           "id": "piagent-planner",
           "kind": "subagents",
           "path": "packages/piagent-core/subagents/piagent-planner.md"
@@ -112,7 +119,7 @@
       ],
       "dependencies": [],
       "description": "Core engineering workflow, policy, verification, and task coordination capabilities.",
-      "digest": "sha256:b9671f0c2da79012b8638c98459d5bbe9e444fd39fdabe17f54477ec18cc9fdf",
+      "digest": "sha256:2ed297c1fc283b477c44d4fe4787d670a2dade2283b27e579702d7d7be891d5d",
       "license": "MIT",
       "lifecycle": "experimental",
       "name": "engineering-base",

package/catalog/claude-model-additions.json

@@ -0,0 +1,42 @@
+{
+  "piVersion": "0.87.1",
+  "reviewedOn": "2026-09-29",
+  "source": "https://platform.claude.com/docs/en/models/sonnet-5-5/overview",
+  "models": [
+    {
+      "id": "claude-sonnet-5-5",
+      "name": "Claude Sonnet 5.5",
+      "reasoning": true,
+      "input": [
+        "text",
+        "image"
+      ],
+      "cost": {
+        "input": 2,
+        "output": 10,
+        "cacheRead": 0.2,
+        "cacheWrite": 2.5
+      },
+      "contextWindow": 1000000,
+      "maxTokens": 128000,
+      "thinkingLevelMap": {
+        "off": null,
+        "minimal": null,
+        "low": "low",
+        "medium": "medium",
+        "high": "high",
+        "xhigh": "xhigh",
+        "max": "max"
+      },
+      "compat": {
+        "forceAdaptiveThinking": true,
+        "supportsTemperature": false,
+        "supportsStrictTools": true
+      },
+      "promptCache": {
+        "short": 300,
+        "long": 3600
+      }
+    }
+  ]
+}

package/docs/auto-delegation-policy.md

@@ -1,6 +1,8 @@
 # Solo-first orchestration policy
 <!-- language: vi; english-index: docs-site/content/en/workflows.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: parent model tự làm trọn task với đầy đủ năng lực. Helper không còn là phase mặc định để scout/plan/review; nó chỉ là một tối ưu token ngoại lệ. Piagent chỉ cho tối đa **một helper read-only, context fresh** khi runtime chứng minh có ít nhất hai lane độc lập và tổng token dự kiến sau handoff/merge giảm tối thiểu **30%**. Alias cũ như `/task` giữ cùng policy.
 
 Kiểm tra policy hiện tại trong Pi:

package/docs/command-reference-vietnamese.md

@@ -7,13 +7,17 @@ File này là bảng tra cứu command chính cho Pi Agent Platform. Mục tiêu
 
 ## Cách đọc command
 
-Có 5 loại cần phân biệt:
+Từ bản 1.9.0, công việc được yêu cầu bằng **lời thường**: không còn `/workflow`,
+`/task`, `/scout`, `/fresh`, `/onboard`, `/commands` hay `/model-options`, và
+session không tạo task contract. Slash command còn lại chỉ để xem trạng thái hoặc
+đổi thiết lập; không command nào mở lượt model.
+
+Có 4 loại cần phân biệt:
 
 | Loại | Gõ ở đâu | Ví dụ | Ý nghĩa |
 |---|---|---|---|
-| Runtime slash command | Bên trong Pi TUI | `/usage` | Extension chạy ngay, hiện kết quả/menu, **không gọi model follow-up**. |
-| Workflow launcher | Bên trong Pi TUI | `/workflow task <request>` | Runtime command mở menu hoặc gửi workflow prompt rõ ràng cho agent. |
-| Workflow alias | Bên trong Pi TUI | `/task <request>` | Alias cũ cho power user; vẫn cần agent turn. Team mới nên dùng `/workflow`. |
+| Yêu cầu thường | Bên trong Pi TUI hoặc WebUI | `Scout luồng thanh toán FE/BE, chỉ đọc, không sửa` | Agent làm việc trực tiếp; guard vẫn áp quyền và xác nhận. |
+| Runtime slash command | Bên trong Pi TUI | `/usage` | Extension chạy ngay, hiện kết quả/menu, **không gọi model**. |
 | Terminal command | Terminal đã có Bash | `piagent-mcp --preset core` | Cài, kiểm tra, hoặc cấu hình máy/project từ bên ngoài Pi. |
 | Pi native/hotkey | Bên trong Pi TUI | `/model`, `Ctrl+L` | Điều khiển native Pi như model/session/MCP. |
 
@@ -28,26 +32,24 @@ PiAgent không chiếm các command native đang dùng của Pi. Những command
 | `/login` | Đăng nhập provider/OAuth. |
 | `/model`, `Ctrl+L` | Chọn model/provider. |
 | `/name` | Đặt tên session; Piagent nhận rename event để map Agent Watch/report. |
+| `/new` | Mở session mới, ví dụ khi session hiện tại đã nặng. |
 | `/session` | Xem session id/name/token/cost/context hiện tại. |
 | `/resume` | Resume session cũ bằng UI/native flow. |
 | `/compact` | Nén context bằng Pi native compaction. |
 | `/mcp`, `/mcp-auth` | Kiểm tra/kết nối MCP live và OAuth. |
 
-Command ngắn của PiAgent dùng cho workflow và guard local:
+Command ngắn của PiAgent cho thiết lập và guard local:
 
 | PiAgent runtime | Vai trò |
 |---|---|
-| `/commands` | Menu/help command, không gọi model. |
-| `/workflow` | Launcher task/scout/plan/review/git/onboard. |
 | `/usage` | Usage live/history/preflight/compact/logs/efficiency. |
 | `/context` | Smart index/rebuild/search/pack/impact/efficiency/preflight/compact. |
 | `/permission` | Permission mode của session. |
 | `/fast` | Xem/bật/tắt OpenAI Codex Fast service tier cho session; không đổi model/thinking và không gọi model khi chạy command. |
 | `/profile` | Profile và tech stack. |
 | `/memory` | Project memory policy. |
-| `/onboard` | Project onboarding/status/setup. |
-| `/fresh` | Tạo session mới cho workflow. |
-| `/piagent-inspector` | Menu quan sát file diff, command, safety và context của task/session. |
+| `/piagent-status` | Profile, guard, runtime và trạng thái model đã xác thực. |
+| `/piagent-inspector` | Menu quan sát file diff, command, safety và context của session. |
 
 Riêng MCP governance vẫn giữ `/piagent-mcp` vì `/mcp` đã là command native của Pi.
 
@@ -65,100 +67,78 @@ Trong Pi:
 ```text
 /login
 /model
-/commands
-/onboard
+/profile
 /context index
 /context rebuild
 /memory
 ```
 
-Các lần sau:
-
-```bash
-cd /path/to/project
-pi
-```
-
-Trong Pi:
+Rồi nhờ agent onboard project bằng lời thường:
 
 ```text
-/workflow task Implement <task cụ thể>.
+Đọc project này (chỉ đọc) và ghi lại project context.
 ```
 
-Nếu chỉ scout/audit read-only:
+Agent đọc project và ghi `.pi/project-context.md` bằng tool onboarding của Piagent.
+
+Các lần sau chỉ cần nói việc cần làm:
 
 ```text
-/workflow scout Scout payment FE mapping vs BE. Do not edit source.
+Implement <task cụ thể>. Chạy test của project sau khi sửa.
 ```
 
-Nếu session đang nặng hoặc Pi báo context overflow, dùng fresh workflow. Ba lệnh dưới đây là ví dụ phổ biến; `/fresh help` liệt kê toàn bộ workflow canonical:
+Nếu chỉ scout/audit:
 
 ```text
-/fresh scout <read-only request>
-/fresh task <implementation request>
-/fresh be-to-fe <BE-readonly/FE request>
+Scout mapping payment FE với BE. Chỉ đọc, không sửa source.
 ```
 
-Nếu task còn mơ hồ:
+Nếu task còn mơ hồ, nói rõ là muốn bàn hoặc lập kế hoạch trước:
 
 ```text
-/workflow discuss <ý tưởng hoặc yêu cầu thô>
-/workflow plan <goal cần bóc tách>
+Chưa sửa gì cả. Hỏi lại những điểm chưa rõ rồi đề xuất kế hoạch cho <goal>.
 ```
 
+Nếu session đang nặng hoặc Pi báo context overflow, mở session mới bằng `/new`
+(hoặc `/compact`) rồi nói lại yêu cầu.
+
 ## Nguyên tắc command/UX
 
 Pi Agent dùng ít namespace nhưng mỗi namespace có subcommand/menu rõ:
 
-- `/workflow` là cửa chính cho task/scout/review/git/onboard workflow. Workflow cần agent turn là cố ý và được nói rõ.
+- Công việc (implement, scout, review, commit, PR) là yêu cầu thường; agent dùng tool bình thường và guard kiểm tra từng tool call.
 - `/usage` gom live usage, history/report hint, preflight, compact, logs, efficiency.
 - Pi native `/name` đặt tên session theo task; Piagent nhận rename event để Agent Watch/report map đúng việc.
-- `/fresh` mở session mới cho mọi workflow canonical khi phiên hiện tại đã nặng; chạy `/fresh help` để xem catalog hiện hành.
 - `/context` gom architecture map, code index, search, context pack, test impact, efficiency, preflight và semantic compact.
 - `/permission` gom permission status/read-only/workspace-write/full-access.
 - `/profile` là namespace duy nhất cho profile và tech stack.
-- `/commands` là runtime help/menu, không còn bắt agent đọc docs để giải thích.
 - `/piagent-inspector` là một namespace quan sát duy nhất; mở menu để tránh sinh thêm command rời.
 - Khi user cần chọn, ưu tiên select option. Khi UI select không khả dụng, trả exact command.
 - Hành động rủi ro như stage rộng, push, PR write, deploy, publish, thay đổi database hoặc external-provider write vẫn cần xác nhận người vận hành.
 
 ## Command chính cho team
 
-Các command này đến từ package `piagent-core`.
+Các command này đến từ package `piagent-core`; tất cả chạy ngay và không gọi model.
 
 | Command | Dùng khi nào | Kết quả mong đợi |
 |---|---|---|
-| `/commands` | Không nhớ command. | Mở menu/help theo topic, không gọi model. |
-| `/workflow` | Muốn chọn task/scout/review/git/onboard bằng menu. | Mở workflow picker. |
-| `/workflow task <request>` | Requirement đã rõ và cần implement. | Launch task workflow cho agent. |
-| `/workflow scout <request>` | Cần scout/audit read-only. | Launch scout workflow cho agent. |
-| `/workflow be-to-fe <request>` | BE read-only, FE implementation. | Launch BE→FE workflow. |
-| `/workflow discuss <idea>` | Task còn mơ hồ. | Launch clarify workflow, không sửa code. |
-| `/workflow plan <goal>` | Cần plan trước khi sửa. | Launch plan workflow. |
-| `/workflow review <target>` | Review diff/source. | Launch review workflow. |
-| `/workflow commit [message]` | Diff đã review và muốn commit local. | Launch guarded commit workflow. |
-| `/workflow pr [title]` | Branch đã commit và muốn chuẩn bị PR. | Launch guarded PR workflow. |
-| `/workflow onboard [focus]` | First-read onboarding cần agent đọc project. | Launch onboarding workflow để ghi `.pi/project-context.md` và context index. |
-| `/onboard` | First-run setup/status. | Mở menu onboarding: status, run, profile, setup. |
 | `/profile` | Xem/áp profile và chọn tech. | Chạy ngay, không gọi model. |
 | `/profile setup` | Chọn profile + tech bằng option. | Ghi profile/lock/tech manifest. |
 | `/usage` | Xem live usage hoặc report hint. | Menu live/history/preflight/compact/logs/efficiency. |
-| `/task-preflight` | Xem product preflight deterministic. | Intent/risk/scope/runtime/solver/phases/tools/helpers/backend/approval có schema/version. |
-| `/piagent-status` | Xem product live status deterministic. | Task/phase/checkpoint/resume/recovery/helper/terminal receipt từ persisted evidence. |
+| `/task-preflight` | Xem preflight deterministic cho một yêu cầu. | Context và shadow route có schema/version; không gọi model. |
+| `/piagent-status` | Xem trạng thái Piagent. | Profile, guard, runtime và model đã xác thực. |
 | `/piagent-inspector` | Muốn xem Piagent đang làm gì, sửa file nào, diff bao nhiêu dòng, command nào fail/block và context còn bao nhiêu. | Mở menu `summary/files/commands/security/context/toggle`; read-only, không gọi model. |
-| `/fresh <workflow> <request>` | Phiên hiện tại đã nặng hoặc muốn tách việc; nhận mọi workflow canonical. | Mở session mới có tên và replay workflow prompt gọn; `/fresh help` liệt kê lựa chọn. |
+| `/piagent-orchestration` | Xem chính sách helper/subagent. | Mode, giới hạn helper, review lens, Field Guide; không gọi model. |
 | `/context` | Xem index/search/pack/impact/efficiency/preflight/compact. | Menu context, không gọi model. |
 | `/permission` | Xem/đổi quyền runtime. | Menu status/read-only/workspace-write/full-access. |
 | `/fast status\|on\|off` | Xem/bật/tắt Fast service tier cho session OpenAI Codex. | Chạy ngay, 0 model token; giữ nguyên model/thinking. Session trống mặc định tắt, environment override hoặc state đã lưu khi resume có thể được ưu tiên. |
 | `/memory` hoặc `/memory-policy` | Xem memory policy. | Chạy ngay, không gọi model. |
-| `/model-options` | Xem hướng dẫn model/thinking. | Chạy ngay; chọn model vẫn dùng `/model` hoặc `Ctrl+L`. |
 | `/piagent-mcp` | Xem/quản trị MCP trong Pi. | Menu MCP, không gọi model. |
 
-`/piagent-inspector` không thêm bước bắt buộc vào workflow. Panel bốn dòng tự
-hiện sát phía trên footer native từ lúc mở session. Khi có Task Contract, panel
-dùng các file task đã quan sát; không có task thì dùng working-tree status. View `files` mới tính exact snapshot
-delta so với task baseline. Gõ command không kèm option để mở menu, hoặc dùng
-trực tiếp:
+`/piagent-inspector` không thêm bước bắt buộc nào. Panel bốn dòng tự hiện sát
+phía trên footer native từ lúc mở session và dùng working-tree status (bản ghi
+task cũ, nếu có, chỉ còn để xem lịch sử). Gõ command không kèm option để mở menu,
+hoặc dùng trực tiếp:
 
 Panel dùng màu theo mức độ: file cyan, test magenta, dòng thêm xanh lá, dòng
 xóa đỏ; command pass xanh lá, blocked vàng, failed và safety warning đỏ. Context
@@ -175,44 +155,42 @@ nếu terminal cần output không màu.
 /piagent-inspector --json summary
 ```
 
-`files` tách source/test và hiển thị `+/-`. Nếu task sửa một file đã dirty trước
-khi task bắt đầu, scope được ghi `mixed-working-tree` thay vì nhận nhầm toàn bộ
-line diff là do task hiện tại. `commands` tách requested/executed/passed/failed/
-blocked. `security` chỉ hiện policy block, secret redaction và integrity warning
-đã quan sát. `context` dùng exact usage theo turn/session mà Pi cung cấp; token
-theo từng built-in tool call luôn ghi unavailable, không ước lượng.
+`files` tách source/test và hiển thị `+/-`. `commands` tách requested/executed/
+passed/failed/blocked. `security` chỉ hiện policy block, secret redaction và
+integrity warning đã quan sát. `context` dùng exact usage theo turn/session mà Pi
+cung cấp; token theo từng built-in tool call luôn ghi unavailable, không ước lượng.
 
-Alias cũ vẫn giữ để không phá thói quen:
+Alias còn giữ:
 
 | Alias | Command chính |
 |---|---|
-| `/task <request>` | `/workflow task <request>` |
-| `/scout <request>` | `/workflow scout <request>` |
-| `/be-to-fe <request>` | `/workflow be-to-fe <request>` |
-| `/commit [message]` | `/workflow commit [message]` |
-| `/pr [title]` | `/workflow pr [title]` |
 | `/setname <name>` | Pi native `/name <name>` |
-| `/fresh-task <request>` | `/fresh task <request>` |
-| `/fresh-scout <request>` | `/fresh scout <request>` |
-| `/fresh-be-to-fe <request>` | `/fresh be-to-fe <request>` |
 | `/context-index` | `/context index` |
-| `/task-preflight` | `/context preflight` |
 | `/permission-status`, `/read-only`, `/workspace-write`, `/full-access` | `/permission ...` |
 
-Git flow của Pi cố ý không dùng namespace `/git-*`. Daily flow là nói tự nhiên hoặc đi qua `/workflow`:
+Các command và alias đã bỏ từ bản 1.9.0: `/workflow`, `/task`, `/scout`,
+`/be-to-fe`, `/discuss`, `/plan`, `/review`, `/commit`, `/pr`, `/fresh`,
+`/fresh-task`, `/fresh-scout`, `/fresh-be-to-fe`, `/onboard`,
+`/onboard-project`, `/commands`, `/piagent-commands`, `/model-options`,
+`/profiles`, `/profile-tech`. Gõ chúng bây giờ sẽ được gửi như tin nhắn thường.
+
+Git flow của Pi cố ý không dùng namespace `/git-*`. Cứ nói tự nhiên:
 
 ```text
-/workflow commit docs: update onboarding notes
-/workflow pr Add guarded git workflow
+Commit hai file docs vừa sửa với message "docs: update onboarding notes".
+Tạo draft PR cho branch này, title "Add guarded git notes".
 ```
 
-Alias `/commit` và `/pr` vẫn chạy. Commit workflow chỉ tạo local commit. PR workflow có thể cần `git push` và GitHub write action, nên guard vẫn bắt agent xác nhận rõ branch/title/scope trước khi đẩy hoặc tạo PR. Các lệnh stage rộng như `git add .`, `git add -A`, `git add --all`, `git add -- .`, `git add :/` cũng bị đưa qua confirmation để tránh gom nhầm file riêng tư hoặc unrelated diff.
+Commit chỉ tạo local commit. `git push` và thao tác ghi lên GitHub (tạo PR,
+comment…) luôn hỏi xác nhận trước. Các lệnh stage rộng như `git add .`,
+`git add -A`, `git add --all`, `git add -- .`, `git add :/` cũng bị đưa qua
+confirmation để tránh gom nhầm file riêng tư hoặc unrelated diff.
 
 ## Image/screenshot input
 
 | Tình huống | Cách dùng | Kết quả |
 |---|---|---|
-| Chat box trả ra local path ảnh | `/workflow scout Check screenshot ~/Documents/team-screenshots/screenshot.png` | Platform attach ảnh nếu file ở trong project hoặc folder đã cấp bằng `additionalReadRoots`, rồi rewrite path thành `[image1]`. |
+| Chat box trả ra local path ảnh | `Xem lỗi UI trong ảnh ~/Documents/team-screenshots/screenshot.png, chỉ đọc` | Platform attach ảnh nếu file ở trong project hoặc folder đã cấp bằng `additionalReadRoots`, rồi rewrite path thành `[image1]`. |
 | Nhiều ảnh trong cùng prompt | Dán tối đa 4 path ảnh | Prompt có `[image1]`, `[image2]`, ... |
 | Ảnh quá lớn | Dùng Pi `read` tool trên file ảnh hoặc resize ảnh trước | Tránh nhồi ảnh quá lớn vào chat input. |
 
@@ -250,7 +228,7 @@ Tech stack option theo profile:
 | `data` | Data + database optional | `data=dbt database=postgres` |
 | `docs` | Docs | `docs=mintlify` |
 
-Sau khi chọn tech, platform tạo `.pi/tech-stack.json` và các file `.pi/tech-context/<tech>.json`. `/onboard run` sẽ đưa các pointer này vào `.pi/context-index.json`. File context chỉ nên chứa tóm tắt ngắn/citation từ Context7, không lưu nguyên văn docs dài, token, session, hoặc secret.
+Sau khi chọn tech, platform tạo `.pi/tech-stack.json` và các file `.pi/tech-context/<tech>.json`. Khi agent onboard project (nhờ trong chat), tool onboarding đưa các pointer này vào `.pi/context-index.json`. File context chỉ nên chứa tóm tắt ngắn/citation từ Context7, không lưu nguyên văn docs dài, token, session, hoặc secret.
 
 ## Đọc tài liệu ngoài project
 
@@ -327,7 +305,7 @@ Các command này thuộc Pi core hoặc package Pi chính. Tên/availability c
 
 Các command này đến từ package `pi-subagents`. Tên hơi “package terminology”, nên bảng dưới dịch ra nghĩa thực tế.
 
-Quan trọng: Piagent mặc định parent-direct và helpers `off`. Các lệnh dưới đây phần lớn là capability upstream để inspect/debug. Piagent config chặn builtin, worker, parallel, nested và retry; operator chỉ có thể opt-in một helper read-only context fresh, và runtime vẫn yêu cầu hai lane độc lập cùng projected net saving từ 30%.
+Quan trọng: Piagent mặc định parent-direct và helpers `off`. Các lệnh dưới đây phần lớn là capability upstream để inspect/debug. Piagent config chặn builtin, worker, nested và retry; operator có thể opt-in tối đa hai helper read-only context fresh. Ước tính tiết kiệm token chỉ là telemetry, không còn là điều kiện cho phép (bounded-delegation-v2).
 
 | Command | Dịch nghĩa dễ hiểu | Dùng khi nào | Kết quả mong đợi |
 |---|---|---|---|
@@ -423,10 +401,10 @@ subagent({ action: "status", id: "<run-id>", view: "transcript", lines: 120 })
 Trong Piagent, helper chỉ được dispatch khi tất cả điều kiện sau đúng:
 
 - operator đã bật `PIAGENT_HELPERS_MODE=on`;
-- runtime chứng minh ít nhất hai lane độc lập;
-- helper không cần chờ output tiếp theo của parent;
-- handoff context fresh, không inherit history, tối đa 2.048 token;
-- projected tổng token sau cả handoff/merge tiết kiệm ít nhất 30%.
+- tổng số helper của phiên chưa quá 2, và chỉ chạy read-only;
+- handoff context fresh, không inherit history, tối đa 2.048 token.
+
+Ước tính tiết kiệm token vẫn được ghi để theo dõi nhưng không quyết định cho phép.
 
 Không nên spawn bừa khi:
 
@@ -441,16 +419,16 @@ Default của platform là an toàn:
 - `maxSubagentDepth: 1`: parent spawn child, child không fan-out tiếp.
 - `parallel.concurrency: 1`: compatibility ceiling, không chạy song song.
 - `asyncByDefault: false`: không tự chạy background nếu anh không yêu cầu.
-- Tổng 1 read-only helper, 0 worker, 0 retry.
+- Tối đa 2 read-only helper, 0 worker, 0 retry.
 
-Nếu anh không bật gì thêm, `/workflow task` chạy parent-direct và không tạo model turn phụ. Alias `/task` giữ cùng policy.
+Nếu anh không bật gì thêm, một yêu cầu thường chạy parent-direct và không tạo model turn phụ.
 
 ## Prompt mẫu cho bài toán thật
 
 ### Platform/package improvement
 
 ```text
-/workflow platform-improve Improve onboarding, model scope, MCP setup, and verification docs for team usage. Keep workflows public, project-agnostic, and verifiable.
+Improve onboarding, model scope, MCP setup, and verification docs for team usage. Keep everything public, project-agnostic, and verifiable.
 ```
 
 Khi muốn tách rõ agents:
@@ -467,19 +445,19 @@ Use piagent-reviewer before final.
 
 ```text
 /profile be-readonly-fe
-/workflow be-to-fe Implement FE support for <endpoint/spec>. Scout backend read-only, map contract, then edit frontend only.
+Implement FE support for <endpoint/spec>. Scout backend read-only, map contract, then edit frontend only.
 ```
 
 Nếu muốn parallel read-only:
 
 ```text
-Keep the parent direct. If helper mode was explicitly enabled and the runtime proves at least 30% net saving, run one fresh read-only piagent-scout for the single highest-value independent lane.
+Keep the parent direct. If helper mode is enabled, run one fresh read-only piagent-scout for the highest-value independent lane.
 ```
 
 ### Review trước khi ship
 
 ```text
-/review current diff
+Review diff hiện tại: correctness, test còn thiếu, scope drift. Chỉ đọc, không sửa.
 ```
 
 Hoặc chia reviewer:
@@ -494,9 +472,9 @@ 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.86.1` | Cài Pi CLI tương thích với release hiện tại. |
-| `npm install -g --ignore-scripts @piagent/platform@1.7.1` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.7.1` | Cài pinned release khi cần reproducible team setup. |
+| `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.9.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.9.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/context-window-policy.md

@@ -5,7 +5,7 @@
 
 Không nhồi toàn bộ repo vào context. Agent phải load đúng lớp context theo task.
 
-Lần đầu gắn project vào platform, chạy `/onboard run` sau login/model selection để tạo `.pi/project-context.md`, `.pi/context-index.json` và local Context Engine index. Các task sau dùng index như bản đồ nhỏ để tìm đúng vùng cần đọc, rồi vẫn verify bằng files task-specific hiện tại.
+Lần đầu gắn project vào platform, nhờ agent onboard project (lời thường) sau login/model selection để tạo `.pi/project-context.md`, `.pi/context-index.json` và local Context Engine index. Các task sau dùng index như bản đồ nhỏ để tìm đúng vùng cần đọc, rồi vẫn verify bằng files task-specific hiện tại.
 
 ## Context order
 
@@ -38,9 +38,9 @@ Trước task lớn/risk cao trong Pi TUI:
 
 Với task/phase tiếp theo trong cùng phiên hiển thị, runtime tự tạo working set
 gọn trước mỗi provider call; người dùng không phải mở session mới chỉ để đổi từ
-scout sang plan, implement hay verify. `/fresh <workflow>` vẫn là đường phục hồi
-tường minh cho mọi workflow canonical khi preflight xác định input quá lớn hoặc
-working set không thể rút gọn an toàn; `/fresh help` liệt kê catalog hiện hành.
+scout sang plan, implement hay verify. Khi preflight xác định input quá lớn hoặc
+working set không thể rút gọn an toàn, mở session mới bằng `/new` của Pi
+(`/fresh` đã bỏ từ bản 1.9.0).
 
 ## Context manifest
 
@@ -113,7 +113,7 @@ working set, không phải giới hạn năng lực hay context window của mod
 - Dùng `/context search` hoặc `piagent_context_index_search` để tìm điểm vào repo, nhưng không dùng index thay thế việc đọc source thật.
 - Dùng `/context rebuild` sau structural changes; incremental refresh tái sử dụng file không đổi.
 - Context pack low-confidence chỉ được mở rộng bằng một bounded finder pass, không loop scout vô hạn.
-- Không raw-read hoặc raw-edit `.pi/context-index.json` trong task thường ngày. Runtime coi index là advisory state, sanitize khi đọc qua tool/command, và ghi qua `/onboard run` hoặc `piagent_context_index_record`.
+- Không raw-read hoặc raw-edit `.pi/context-index.json` trong task thường ngày. Runtime coi index là advisory state, sanitize khi đọc qua tool/command, và ghi qua lượt onboard hoặc `piagent_context_index_record`.
 - File context vượt hard cap phải được summarize hoặc đọc targeted slices, không inject full.
 - Nếu input quá dài thật, lưu intake vào file project/local gitignored rồi reference file; không dán toàn bộ spec vào một turn.
 - Nếu input chứa local screenshot/image path, để input guard attach thành `[image1]` thay vì đọc ảnh như text context. Ảnh lớn hơn giới hạn chat nên dùng Pi `read` để resize.

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.7.1` |
+| Team pinned release | `git:github.com/Vt-mmm/piagent@v1.9.0` |
 | Personal/sandbox dev | `git:github.com/Vt-mmm/piagent` |
-| Registry distribution | `npm:@piagent/platform@1.7.1` |
+| Registry distribution | `npm:@piagent/platform@1.9.0` |
 | Enterprise npm (fork under another scope) | `npm:@your-scope/platform@x.y.z` |
 | Local platform dev | `/path/to/piagent` |
 
@@ -27,7 +27,7 @@ Latest tiện cho máy cá nhân muốn nhận cập nhật nhanh. Pin tag/commi
 
 | Channel | Command | Target | Policy |
 |---|---|---|---|
-| `stable` | `bash scripts/install-global.sh --stable` | Helper release tag resolved to commit SHA, currently `v1.7.1` | Install the Pi package matching the helper. |
+| `stable` | `bash scripts/install-global.sh --stable` | Helper release tag resolved to commit SHA, currently `v1.8.0` | Install the Pi package matching the helper. |
 | `exact` | `bash scripts/install-global.sh --version vX.Y.Z --resolve-tag` | Requested tag resolved to commit SHA | Pi-package-only rollout, rollback, and incident recovery. |
 | `dev` | `bash scripts/install-global.sh --dev` | Moving Git source | Personal/sandbox only; do not commit into project settings. |
 | `local` | `bash scripts/install-global.sh --local` | Current checkout path | Platform development only. |
@@ -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.7.1
+pi install git:github.com/Vt-mmm/piagent@v1.9.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.
@@ -65,13 +65,13 @@ 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.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
 ```
 
-`pi install git:github.com/Vt-mmm/piagent@v1.7.1` 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.7.1`.
+`pi install git:github.com/Vt-mmm/piagent@v1.9.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.9.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).
 
@@ -82,7 +82,7 @@ cd /path/to/project
 pi
 ```
 
-Project profile được chọn trong Pi bằng `/onboard` hoặc `/profile`, không bắt buộc chạy bash init. `/onboard` là menu runtime; dùng `/onboard run` khi muốn model đọc project lần đầu và ghi snapshot.
+Project profile được chọn trong Pi bằng `/profile`, không bắt buộc chạy bash init. Muốn model đọc project lần đầu và ghi snapshot, nhờ agent bằng lời thường (từ bản 1.9.0 không còn `/onboard`).
 
 Sau setup, bước first-run trong Pi là:
 
@@ -91,28 +91,25 @@ Sau setup, bước first-run trong Pi là:
 <select provider/model>
 /mcp
 /subagents-doctor
-/onboard
-/onboard run
+/profile setup
 /context index
 /memory
 ```
 
-`/onboard run` ghi `.pi/project-context.md`; đây là snapshot context dùng chung cho các task sau.
+rồi nhờ agent: "Đọc project này (chỉ đọc) và ghi lại project context." Lượt onboard ghi `.pi/project-context.md`; đây là snapshot context dùng chung cho các task sau.
 Nó cũng ghi `.pi/context-index.json`; đây là compact advisory map có citation để agent tìm đúng điểm vào repo mà không scout rộng lại.
 
-Command hằng ngày nên dạy theo namespace mới:
+Hằng ngày, việc được yêu cầu bằng lời thường; các command cần dạy là thiết lập và màn hình chỉ đọc:
 
 ```text
-/commands
-/workflow task <request>
-/workflow scout <read-only request>
 /name <task/session name>
-/fresh task <request>
 /context preflight
 /usage
+/permission
+/piagent-inspector
 ```
 
-Các alias cũ như `/task`, `/scout`, `/context index`, `/fresh-task` vẫn chạy để không gãy session cũ, nhưng không dùng làm đường onboard chính cho team mới.
+`/workflow`, `/task`, `/scout`, `/fresh`, `/onboard` và `/commands` đã bỏ từ bản 1.9.0. Session nặng thì mở session mới bằng `/new` của Pi.
 
 ## Optional preseed setup
 
@@ -121,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.7.1 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.9.0 \
   --mcp-preset core \
   --subagents-preset safe
 ```
@@ -216,7 +213,7 @@ piagent-update --version X.Y.Z --project /path/to/project
 Sequence thủ công tương đương:
 
 ```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