@piagent/platform 1.8.0 → 1.9.1

package/docs/memory-policy.md

@@ -100,7 +100,6 @@ Mode hiện tại:
 | `piagent_memory_status` | Xem memory config/files/rules. |
 | `piagent_memory_note` | Ghi durable note khi user explicit ask. Có redaction cho token/key/connection-string phổ biến. |
 | `piagent_memory_search` | Keyword-search memory markdown. |
-| `piagent_memory_citation_record` | Ghi memory file đã ảnh hưởng task contract. |
 | `piagent_context_index_status` | Kiểm tra `.pi/context-index.json` có tồn tại/fresh/có citation không. |
 | `piagent_context_index_search` | Tìm node/edge/citation trong context index trước khi scout rộng. |
 | `piagent_context_index_record` | Ghi compact context graph sau onboarding hoặc approved handoff; không ghi transcript thô. |
@@ -111,11 +110,12 @@ Mode hiện tại:
 
 ```text
 /login
-/onboard
-/onboard run
+/profile setup
 /memory
 ```
 
+Rồi nhờ agent onboard project bằng lời thường (từ bản 1.9.0 không còn `/onboard`).
+
 `/memory-policy` vẫn là alias để xem cùng runtime status.
 
 ### Ghi nhớ explicit

package/docs/model-options.md

@@ -119,13 +119,13 @@ pi --thinking medium
 | `openai-codex/gpt-6-sol` | balanced coding | công việc hằng ngày; mặc định phiên mới ở `high` effort, tier medium ở `medium` |
 | `openai-codex/gpt-6-astra` | frontier | task rộng, mơ hồ, nhiều bước; tier ultra ở `xhigh` |
 | `openai-codex/gpt-5.3-codex-spark` | fast scout | hỏi nhanh, thao tác nhỏ, chi phí thấp |
-| `openai-codex/gpt-5.4-mini` | fast/cheap | scout nhẹ, docs, simple fix |
-| `openai-codex/gpt-5.4` | balanced | task bình thường |
 | `openai-codex/gpt-5.5` | balanced/hard | model thế hệ trước vẫn được hỗ trợ khi có trong authenticated catalog |
 | `openai-codex/gpt-5.6-luna` | legacy fallback low | dùng khi GPT-6 Luna chưa có trong authenticated catalog |
 | `openai-codex/gpt-5.6-terra` | legacy fallback medium | dùng khi GPT-6 Sol chưa có trong authenticated catalog |
 | `openai-codex/gpt-5.6-sol` | legacy fallback high/ultra | giữ phiên cũ và benchmark lịch sử; dùng khi GPT-6 Sol/Astra chưa có |
 
+`gpt-5.4` và `gpt-5.4-mini` không còn trong catalog Codex đã đăng nhập (kiểm tra ngày 2026-10-01) nên đã bỏ khỏi preset; settings cũ còn ghi chúng chỉ sinh cảnh báo `No models match pattern` khi mở Pi. `piagent-doctor` liệt kê những mẫu không còn khớp model nào Pi biết; `piagent-model-scope --prune` chỉ xoá đúng những mẫu đó và giữ nguyên phần còn lại (thêm `--dry-run` để xem trước). Mẫu của provider chỉ đang đăng xuất vẫn được giữ.
+
 Pi 0.87.1 khai báo cả ba GPT-6 model trên đường `openai-codex` và `openai`. Catalog Codex của Pi hiện khai báo cửa sổ context 272.000 token; tài liệu API công bố 1,05 triệu token. Hãy dùng giới hạn do host/provider của phiên thực tế cung cấp, không lấy giới hạn API để giả định cho đăng nhập Codex. Astra không hỗ trợ thinking `off`; Sol và Luna có hỗ trợ. Router chỉ chọn model/effort khớp đúng catalog đã đăng nhập, ghi `legacy-model-fallback` khi phải chọn 5.6, và vẫn giữ nguyên model người dùng pin rõ ràng.
 
 ### Họ model Claude (Anthropic)

package/docs/oauth-providers.md

@@ -16,7 +16,7 @@ Chọn provider theo danh sách Pi hiển thị. Sau đó kiểm tra:
 
 ```text
 /model
-/model-options
+/piagent-status
 ```
 
 Hoặc:

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.8.0
+npm install -g --ignore-scripts @piagent/platform@1.9.1
 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.8.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.9.1`. 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.8.0
+npm install -g --ignore-scripts @piagent/platform@1.9.1
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -205,21 +205,23 @@ Gợi ý:
 Sau `/login` và `/model`, chạy:
 
 ```text
-/commands
 /mcp
 /subagents-doctor
-/onboard
-/onboard run
+/profile setup
 /memory
 ```
 
-`/onboard` mở menu/status runtime. `/onboard run` sẽ:
+Từ bản 1.9.0 không còn `/onboard`. Nhờ agent onboard bằng lời thường:
+
+```text
+Đọc project này (chỉ đọc) và ghi lại project context.
+```
+
+Agent sẽ:
 
 1. đọc repo theo context budget;
-2. detect profile phù hợp;
-3. mở select-style profile/tech setup;
-4. hỏi user trước khi apply nếu workflow chạy qua tool write;
-5. ghi project profile, tech stack và context.
+2. đề xuất profile phù hợp (`/profile setup` để chọn profile/tech bằng select);
+3. ghi `.pi/project-context.md` và `.pi/context-index.json` bằng tool onboarding của Piagent.
 
 File chính được tạo/cập nhật:
 
@@ -235,7 +237,7 @@ File chính được tạo/cập nhật:
 .pi/memory/MEMORY.md
 ```
 
-Nếu `.pi/project-context.md` còn `Generated: not yet`, hoặc `/context index` báo index đang pending/stale, không nên chạy `/workflow task` implementation lớn. Chạy lại `/onboard run` trước.
+Nếu `.pi/project-context.md` còn `Generated: not yet`, hoặc `/context index` báo index đang pending/stale, nên nhờ agent onboard lại trước khi giao việc implement lớn.
 
 ### Đổi profile sau này
 
@@ -283,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.8.0 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.9.1 \
   --mcp-preset core \
   --subagents-preset safe
 ```
@@ -306,45 +308,41 @@ bash /path/to/piagent/scripts/configure-subagents.sh --preset safe
 
 ## 4. Daily task workflow
 
+Từ bản 1.9.0, mọi việc được yêu cầu bằng lời thường; không còn `/workflow`,
+`/task`, `/scout`, `/fresh` và không có task contract. Nói rõ ý định (chỉ đọc,
+chỉ lập kế hoạch, hay cho sửa) ngay trong câu yêu cầu.
+
 ### Requirement chưa rõ
 
 ```text
-/workflow discuss Cải tiến workflow onboarding cho team mới. Chưa implement, chỉ hỏi phần thiếu và đề xuất plan.
+Cải tiến onboarding cho team mới. Chưa implement, chỉ hỏi phần còn thiếu và đề xuất plan.
 ```
 
 ### Cần plan trước
 
 ```text
-/workflow plan Implement header sale menu hover stabilization. Include scope, files, verify commands, and risks.
+Lập plan cho header sale menu hover stabilization: scope, file, lệnh verify và rủi ro. Chưa sửa code.
 ```
 
 ### Task rõ, cho implement
 
 ```text
-/workflow task Implement header sale menu hover stabilization. Add component tests and run relevant verify.
+Implement header sale menu hover stabilization. Thêm component test và chạy verify liên quan.
 ```
 
 ### Scout/audit read-only
 
 ```text
-/workflow scout Scout payment FE mapping vs BE contract. Backend read-only. Do not edit source.
+Scout payment FE mapping vs BE contract. Backend read-only. Không sửa source.
 ```
 
-Use `/workflow scout` cho payment/auth/data/contract mapping khi mục tiêu là chốt evidence trước, chưa sửa code.
+Dùng yêu cầu scout cho payment/auth/data/contract mapping khi mục tiêu là chốt evidence trước, chưa sửa code. Muốn chắc chắn không có lệnh ghi nào chạy, đổi session sang `/permission read-only`.
 
 ### Task mới khi session đã nặng
 
-Nếu `/usage` cho thấy context cao, hoặc Pi báo context overflow, dùng fresh workflow. Đây là ba ví dụ thường dùng; `/fresh help` liệt kê đầy đủ catalog canonical:
-
-```text
-/fresh scout Scout payment FE mapping vs BE contract. Backend read-only. Do not edit source.
-/fresh task Implement <bounded task>.
-/fresh be-to-fe Implement FE support for <BE contract>. Backend read-only.
-```
-
-Các command này tự mở session mới và replay prompt workflow ngắn. Anh không cần tự chạy `pi --name ...` rồi paste lại.
-
-Input guard của platform cũng tự collapse prompt có full `Mandatory flow` boilerplate. Quy tắc vận hành: user chỉ mô tả task; checklist nằm trong platform prompt/piagent tools.
+Nếu `/usage` cho thấy context cao, 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. Không cần paste checklist:
+guard tự áp policy cho từng tool call.
 
 ### Gửi ảnh/screenshot trong chat
 
@@ -361,7 +359,7 @@ lưu screenshot vào `~/Documents/team-screenshots` rồi thêm folder đó vào
 Sau đó để nguyên path trong prompt:
 
 ```text
-/workflow scout Scout UI issue from screenshot ~/Documents/team-screenshots/screenshot.png
+Scout lỗi UI trong ảnh ~/Documents/team-screenshots/screenshot.png. Chỉ đọc.
 ```
 
 Piagent guard sẽ xử lý trước khi model nhận input:
@@ -385,19 +383,19 @@ prompt.
 
 ```text
 /profile be-readonly-fe
-/workflow be-to-fe Implement frontend support from backend endpoint/spec <name>. Backend is read-only.
+Implement frontend support from backend endpoint/spec <name>. Backend is read-only.
 ```
 
 ### Cải tiến platform
 
 ```text
-/workflow platform-improve Improve MCP setup docs and subagent command guidance for team usage.
+Improve MCP setup docs and subagent command guidance for team usage.
 ```
 
 ### Review trước final
 
 ```text
-/workflow review current diff
+Review diff hiện tại: correctness, test còn thiếu, scope drift. Chỉ đọc.
 ```
 
 ### Commit và pull request
@@ -405,11 +403,11 @@ prompt.
 Git trong Pi Agent là capability + guard, không có namespace `/git-*`. Khi muốn gom việc hiện tại:
 
 ```text
-/workflow commit docs: update onboarding notes
-/workflow pr Add guarded git workflow
+Commit các file docs vừa sửa với message "docs: update onboarding notes". Không push.
+Tạo draft PR cho branch này, title "Add guarded git notes".
 ```
 
-`/workflow commit` inspect status/diff, stage đúng scope, verify phù hợp, rồi commit local; không push. `/workflow pr` inspect branch/diff/commit rồi hỏi xác nhận trước khi `git push` hoặc tạo/cập nhật GitHub PR. Alias `/commit` và `/pr` vẫn chạy cho power user. Các lệnh stage rộng như `git add .`, `git add -A`, `git add --all`, `git add -- .`, `git add :/` cũng phải qua confirmation.
+Guard hỏi xác nhận trước khi `git push` hoặc tạo/cập nhật GitHub PR. Các lệnh stage rộng như `git add .`, `git add -A`, `git add --all`, `git add -- .`, `git add :/` cũng phải qua confirmation.
 
 ### Preflight, live status và receipt
 
@@ -429,14 +427,9 @@ Read-only/plan/review không bao giờ hiện implementation authorization. Dòn
 `host execution is not a sandbox` là boundary thật: Piagent policy giảm lỗi thao
 tác nhưng không cô lập code khỏi account của operator.
 
-`/piagent-status` đọc Task Contract, checkpoint, trajectory, verifier, recovery,
-helper và resume state đã lưu, không hỏi model nhớ lại. Khi terminal, JSON detail
-có completion receipt: outcome, acceptance, changed-tree identity, exact verify,
-review/helper/recovery, remaining risk và handoff. Receipt chỉ gọi là complete
-khi hard completion gate trên working tree hiện tại pass, trace terminal là
-`completed`, và mọi acceptance criterion đều satisfied. Thiếu gate evidence phải
-fail closed thay vì suy đoán từ state cũ; evidence cùng runtime không được
-gọi là independent audit. Tắt từng lớp bằng `PIAGENT_SOLVER_MODE=off`,
+`/piagent-status` đọc state đã lưu (profile, guard, runtime, model), không hỏi
+model nhớ lại. Từ bản 1.9.0 session không còn Task Contract, checkpoint hay
+completion receipt; bản ghi task của các bản trước chỉ còn để xem lịch sử. Tắt từng lớp bằng `PIAGENT_SOLVER_MODE=off`,
 `PIAGENT_PHASE_TOOLS=off`, `PIAGENT_AUTO_RECOVERY=off`, hoặc
 `PIAGENT_HELPERS_MODE=off`. Hai lớp semantic có kill switch độc lập:
 `PIAGENT_ACCEPTANCE_ASSURANCE=off` tắt assurance và semantic repair phụ thuộc,
@@ -447,12 +440,11 @@ giữ để có thể tạo attempt mới có provenance rõ ràng.
 `/piagent-inspector` là một namespace read-only, không sinh thêm command rời.
 Gõ không tham số để chọn `summary`, `files`, `commands`, `security`, `context`
 hoặc `toggle`. Panel bốn dòng tự hiện sát phía trên footer native từ lúc mở session:
-phase và việc hiện tại; task file/test, `+/-`, command pass/fail/block, safety và
+việc hiện tại; file/test đã đổi, `+/-`, command pass/fail/block, safety và
 context budget. Nó dùng extension-status API nên không thay footer native của
-Pi và không thêm bước bắt buộc vào workflow. Dòng status dùng file task đã quan
-sát để phản hồi nhanh; view `files` tính exact snapshot delta. Task đụng file dirty từ trước được
-đánh dấu mixed baseline; token theo từng built-in tool luôn unavailable vì Pi
-chỉ cung cấp usage exact theo response/turn.
+Pi và không thêm bước bắt buộc nào. Dòng status dùng working-tree status; token
+theo từng built-in tool luôn unavailable vì Pi chỉ cung cấp usage exact theo
+response/turn.
 
 Known unsupported/unpromoted surfaces của candidate hiện tại: parent routing
 đã có `off|shadow|recommend|auto`, nhưng extension `auto` fail-closed về
@@ -478,59 +470,42 @@ piagent-route --prompt-file /path/to/task.txt --execute --yes -- --approve
 Lệnh này dùng authenticated `pi --list-models`, không đọc credential store,
 không ghi raw task vào route sidecar, giữ hard pin, và từ chối task bị blocked.
 
-## 5. Control flow của một task chuẩn
+## 5. Control flow của một lượt sửa code
 
-Một source-changing task nên đi qua:
+Từ bản 1.9.0 một yêu cầu sửa code đi qua:
 
 ```text
-intake
-  -> session name + profile/context
-  -> session-bound task contract v2
-  -> runtime-observed context manifest
-  -> implementation
-  -> baseline-aware changed files
-  -> every exact verify command
-  -> current-tree verify evidence from tool_result
-  -> completion hook: trace + final gate
-  -> immutable outcome / retry handoff
+yêu cầu bằng lời thường
+  -> profile/context của project
+  -> agent đọc file đích và test gần nhất
+  -> sửa bằng read/edit/write/apply_patch/bash
+     (guard kiểm tra từng tool call: protected path, read-only path, quyền,
+      context budget, edit trên bản đọc cũ, xác nhận destructive/external)
+  -> chạy lệnh check của project
+  -> báo file đã đổi, kết quả verify, rủi ro còn lại
 ```
 
-Trong task nhỏ và rõ scope, runtime tạo contract trước model turn đầu tiên nên
-model không gọi management tool nào. Task rộng, high-risk hoặc scope mơ hồ mới
-fallback về một `piagent_task_start`. Các tool còn lại bên dưới là bề mặt
-operator/diagnostics/recovery, không phải checklist phải gọi mỗi task.
+Không còn task contract, scope khai báo, work plan, completion gate hay receipt.
+Trong khung công ty (`piagent studio`), các bước plan/check/review mỗi lượt do
+Harness của team trong Studio quy định; xem [nghiệm thu local](managed-local-acceptance.md).
 
-Các Piagent tools:
+Các Piagent tools còn lại là bề mặt operator/diagnostics, không phải checklist phải gọi mỗi lượt:
 
 | Tool | Vai trò |
 |---|---|
 | `piagent_context` | Đọc active profile, required context, verify commands, MCP/memory settings. |
 | `piagent_context_index_status/search/record` | Kiểm tra/tìm/ghi context index advisory có citation. |
-| `piagent_task_start` | Fallback intake cho task rộng/high-risk/mơ hồ; scope chỉ nhận project-relative path/glob. |
-| `piagent_task_progress` | Chuyển step trong work plan và ghi failure/ruled-out evidence. |
-| `piagent_context_record` | Recovery: bổ sung context manifest khi observer không đủ. |
 | `piagent_exec_policy_check` | Diagnostics: giải thích shell-policy verdict; runtime vẫn check mọi call. |
 | `piagent_context_budget` | Diagnostics: xem budget của file/context lớn. |
 | `piagent_tool_policy_check` | Diagnostics: xem capability verdict của tool/MCP. |
-| `piagent_verify_record` | Recovery: đối chiếu verify với bash result thật sau task start. |
-| `piagent_trace_record` | Recovery/high-risk: ghi outcome hoặc blocker thủ công. |
-| `piagent_task_gate_check` | Diagnostics/recovery: xem missing final proof. |
+| `piagent_document_read` | Đọc tài liệu ngoài project trong `additionalReadRoots` (chỉ đọc). |
+| `piagent_source_checkout` | Chuẩn bị repo ngoài để đọc (read-only cho session). |
+| `piagent_project_onboarding_record` | Ghi `.pi/project-context.md` sau khi agent đọc project. |
 | `piagent_usage_snapshot` | Snapshot session/model/context. |
 
-Done đúng nghĩa:
-
-- task contract v2 gắn đúng session hiện tại;
-- có context manifest;
-- mọi verify command đã chạy thật và khớp `task.verifyCommands`;
-- changed files khác baseline, có evidence và nằm trong scope;
-- work plan không còn step pending/in-progress/failed;
-- trace outcome rõ;
-- final gate pass hoặc ghi rõ blocked/partial.
-
-Source task yêu cầu Git working tree và meaningful verifier ngay từ lúc start.
-Một session chỉ dùng cho một task. Retry mở session mới với cùng `taskId`; runtime
-giữ previous attempt evidence và từ chối vượt `maxAttempts`. Contract đã terminal
-không thể sửa thêm context/verify/trace để viết lại lịch sử.
+Các tool `piagent_task_start`, `piagent_task_progress`, `piagent_context_record`,
+`piagent_verify_record`, `piagent_trace_record` và `piagent_task_gate_check` đã bỏ
+từ bản 1.9.0.
 
 ## 6. Guardrails cần hiểu
 
@@ -798,10 +773,9 @@ pi --continue
 
 Nếu `--continue` không đúng phiên cần làm, mở selector bằng `pi --resume`, chọn theo session name đã đặt. Khi resume đúng session cũ, tên session vẫn là tên đã set; nếu cần chỉnh lại cho khớp task nội bộ thì chạy `/name <new name>` ngay trước khi làm tiếp.
 
-Task Contract v2 map bằng `sessionId` và Pi custom trace, không dựa riêng vào tên.
-Đổi tên sau khi task bắt đầu sẽ cập nhật contract để Agent Watch/report dùng tên
-mới. Không fork/reuse một session terminal cho task khác; retry hoặc task mới mở
-session mới để usage/prompt/change evidence không bị trộn.
+Agent Watch/report map session bằng `sessionId` và Pi custom trace, không dựa
+riêng vào tên; đổi tên bằng `/name` sẽ được ghi nhận. Nên mở session mới cho việc
+mới để usage/prompt/change evidence không bị trộn.
 
 ### Khi nào nên resume, continue, fork
 
@@ -944,7 +918,7 @@ Default safe config:
 
 ### Auto-delegation
 
-Với `/workflow task`, `/workflow be-to-fe`, `/workflow platform-improve`, `/workflow plan`, `/workflow review`, parent agent tự suy luận và implement. Helper mặc định tắt. Khi operator bật rõ, runtime chỉ được dispatch một helper read-only, context fresh, nếu có ít nhất hai lane độc lập và projected net token saving từ 30% sau handoff/merge. Worker, retry, nested và parallel helper đều tắt. Alias cũ như `/task` giữ cùng policy.
+Với mọi yêu cầu (implement, plan, review…), parent agent tự suy luận và implement. Helper mặc định tắt. Khi operator bật rõ, runtime được dispatch tối đa hai helper read-only, context fresh (không inherit history, handoff tối đa 2.048 token). Ước tính tiết kiệm token chỉ là telemetry. Worker, retry và nested helper đều tắt.
 
 Kiểm tra nhanh policy:
 
@@ -957,9 +931,10 @@ Không cần tự gọi `/run` cho task bình thường. Chỉ dùng `/run` khi
 Helper chỉ đủ điều kiện khi đồng thời:
 
 - operator đã opt-in;
-- có ít nhất hai workstream độc lập và helper không phụ thuộc output tiếp theo của parent;
-- context chuyển giao fresh, tối đa 2.048 token và không inherit history;
-- tổng token parent + helper + handoff + merge được dự báo thấp hơn solo ít nhất 30%.
+- tổng số helper của phiên chưa quá 2 và helper chỉ đọc;
+- context chuyển giao fresh, tối đa 2.048 token và không inherit history.
+
+Dự báo tiết kiệm token vẫn được ghi để theo dõi nhưng không còn là điều kiện (bounded-delegation-v2).
 
 Không nên spawn khi:
 
@@ -1024,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.8.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.8.0` | Install pinned release cho reproducible team setup. |
+| `npm install -g --ignore-scripts @piagent/platform@1.9.1` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.9.1` | 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. |
@@ -1072,17 +1047,13 @@ Watchdog là optional adversarial reviewer ở cuối turn, không bật mặc
 | `/model` / `Ctrl+L` | Chọn model. |
 | `Ctrl+P` | Cycle scoped models. |
 | `Shift+Tab` | Cycle thinking level. |
-| `/commands` | Menu/help command runtime theo topic. |
-| `/piagent-inspector` | Menu read-only cho task diff/file test/line, command, safety và context; `toggle` ẩn/hiện panel bốn dòng trong session. |
-| `/workflow` | Menu task/scout/review/git/onboard workflow. |
+| `/piagent-inspector` | Menu read-only cho diff/file test/line, command, safety và context; `toggle` ẩn/hiện panel bốn dòng trong session. |
 | `/permission` | Menu permission status/read-only/workspace-write/full-access. |
 | `/permission status` | Xem permission profile hiện tại. |
 | `/permission read-only` | Chuyển session sang read-only. |
 | `/permission workspace-write` | Chuyển session sang write chuẩn. |
 | `/permission full-access` | Bật trusted full-access cho session hiện tại. |
 | `/permission full-access <task>` | Bật trusted full-access rồi gửi `<task>` cho agent làm tiếp. |
-| `/onboard` | Menu/status onboarding runtime. |
-| `/onboard run` | Onboard/read project lần đầu. |
 | `/context` | Menu context index/search/preflight/compact. |
 | `/context index` | Xem compact context index, không gọi model follow-up. |
 | `/context search <keyword>` | Tìm node/edge/citation trong context index. |
@@ -1100,25 +1071,13 @@ Watchdog là optional adversarial reviewer ở cuối turn, không bật mặc
 | `/usage` | Snapshot context/session. |
 | `/usage logs` | Xem capture output dài đã compact. |
 | `/name` | Đặt/đổi tên session theo task để report dễ map. |
-| `/fresh` | Mở session mới cho mọi workflow canonical khi phiên hiện tại nặng; xem lựa chọn bằng `/fresh help`. |
+| `/new` | Pi native: mở session mới khi phiên hiện tại nặng. |
 | `/name <name>` | Đổi tên session cho resume/report. |
 | `/session` | Pi native session stats/info. |
 | `/mcp` / `/mcp tools` | Check MCP. |
 | `/subagents-doctor` | Check subagent setup. |
 | `/subagents-fleet` | Follow child sessions. |
 | `/subagent-cost` | Check subagent token/cost. |
-| `/workflow discuss <request>` | Làm rõ, không sửa. |
-| `/workflow plan <goal>` | Lập plan. |
-| `/workflow scout <request>` | Scout/audit read-only. |
-| `/fresh scout <request>` | Tự mở session mới rồi chạy scout workflow. |
-| `/fresh task <request>` | Tự mở session mới rồi chạy task workflow. |
-| `/fresh be-to-fe <request>` | Tự mở session mới rồi chạy BE-to-FE workflow. |
-| `/workflow task <request>` | Implement task. |
-| `/workflow be-to-fe <request>` | BE read-only, FE implementation. |
-| `/workflow platform-improve <request>` | Cải tiến platform. |
-| `/workflow review [scope]` | Review diff/source. |
-| `/workflow commit [message/scope]` | Commit local qua workflow có guard. |
-| `/workflow pr [title/request]` | Chuẩn bị PR, hỏi trước khi push/GitHub write. |
 
 ## 12. Troubleshooting
 
@@ -1137,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.8.0
+npm install -g --ignore-scripts @piagent/platform@1.9.1
 command -v piagent-install
 ```
 
@@ -1222,21 +1181,17 @@ pi --session <session-id>
 pi --session /absolute/path/to/session.jsonl
 ```
 
-### Verify evidence không được nhận
-
-Nguyên nhân thường gặp:
+### Lệnh/tool bị chặn
 
-- agent ghi `piagent_verify_record` nhưng chưa chạy bash verify thật;
-- command string không exact-match `task.verifyCommands`;
-- verify chạy trước `task.createdAt`;
-- verify chạy ở cwd khác;
-- subagent chạy nhưng parent chưa thấy persisted ledger đúng cwd.
+Guard luôn ghi lý do khi chặn. Nguyên nhân thường gặp:
 
-Fix:
+- đụng protected path (`.env`, `auth.json`, `.pi/piagent-state/**`…) hoặc read-only path của profile;
+- permission `read-only` (chặn ghi và shell) — đổi bằng `/permission`;
+- file quá lớn so với context budget;
+- file đã đổi từ lần đọc trước (`previously observed source snapshot is stale`) — đọc lại file một lần rồi sửa;
+- lệnh destructive/external cần xác nhận mà người vận hành chưa đồng ý.
 
-```text
-Run the exact verify command from task.verifyCommands in the project cwd, then record verify evidence again.
-```
+Xem chi tiết bằng `/piagent-inspector security`, hoặc giải thích một lệnh shell trước khi chạy bằng `piagent-explain "<lệnh>"` từ terminal.
 
 ## 13. Không commit
 

package/docs/package-architecture-notes.md

@@ -92,13 +92,13 @@ Manifest data never executes code. Invalid paths, symbolic links, dependency cyc
 
 | Capability | Implementation |
 |---|---|
-| Project onboarding | `/onboard run` + `piagent_project_onboarding_record` |
+| Project onboarding | plain request + `piagent_project_onboarding_record` |
 | Project context index | `/context` + `piagent_context_index_*` |
 | Profile switching | `/profile` + `piagent_profile_options` / `piagent_profile_apply` |
 | Explicit memory | `/memory` + `piagent_memory_*` |
-| Task lifecycle | `/workflow task` + task/context/verify/trace tools |
-| Platform workflow | `/workflow platform-improve` |
-| Backend-readonly to frontend | `/workflow be-to-fe` |
+| Task lifecycle | retired in 1.9.0; turns are freeform |
+| Platform workflow | plain request |
+| Backend-readonly to frontend | `/profile be-readonly-fe` + plain request |
 | Source cache | `piagent-source-cache` + `piagent_source_checkout` |
 | Subagent roles | `piagent-scout`, `piagent-planner`, `piagent-worker`, `piagent-reviewer`, `piagent-oracle` |
 | Quality benchmark | `scripts/benchmark-runner.mjs` + `benchmark/benchmark-core.js`; legacy recorder: `scripts/quality-benchmark.sh` |

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.