@piagent/platform 1.8.0 → 1.9.1

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.1`: subagent khảo sát và xác minh cho tài khoản công ty (chỉ khi Harness bật); tìm web qua search pool của Studio cho mọi vai; gửi `piagent/<version>` cho Studio. Sandbox công ty: đọc được `auth.json` nằm trong source (file dịch); giấu hẳn `.env*` (trừ file mẫu) để Vite/Vitest/Next vẫn chạy; ở thư mục không có git, lệnh chỉ đọc không còn bị tính là sửa code; E2E chạy qua `run_with_network`; bộ cài không gợi ý lệnh đã bỏ.
+- `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`.
@@ -152,7 +154,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

@@ -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

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

package/docs/team-onboarding.md

@@ -10,7 +10,7 @@ Một thành viên mới không cần biết local path của maintainer. Luồn
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.8.0
+npm install -g --ignore-scripts @piagent/platform@1.9.1
 piagent-install --stable
 cd /path/to/project
 pi
@@ -18,11 +18,12 @@ pi
 <select provider/model>
 /mcp
 /subagents-doctor
-/onboard
-/onboard run
+/profile setup
 /memory
 ```
 
+Rồi nhờ agent: "Đọc project này (chỉ đọc) và ghi lại project context." (từ bản 1.9.0 không còn `/onboard`).
+
 ## Prerequisites
 
 - Node.js >=22.19.0.
@@ -44,7 +45,7 @@ Mặc định team dùng stable helper:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.8.0
+npm install -g --ignore-scripts @piagent/platform@1.9.1
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -80,7 +81,7 @@ Khi cần kiểm tra một project sau rollout, chạy riêng:
 piagent-update --version X.Y.Z --project /path/to/project
 ```
 
-`--project` là bước phụ: tự migrate layout cũ, Task Contract và managed block
+`--project` là bước phụ: tự migrate layout cũ, bản ghi task cũ và managed block
 trong `AGENTS.md` nếu có rồi chạy doctor strict-share. Text riêng của project
 ngoài managed block được giữ nguyên. Nếu chỉ update global, runtime mới vẫn thay
 checklist template cũ trong system prompt ở memory nên task dùng logic mới ngay;
@@ -171,10 +172,11 @@ Rồi chạy:
 ```text
 /mcp
 /subagents-doctor
-/onboard
-/onboard run
+/profile setup
 ```
 
+rồi nhờ agent trong chat: "Đọc project này (chỉ đọc) và ghi lại project context."
+
 Output chính:
 
 - `.pi/project-context.md`
@@ -201,7 +203,7 @@ Nếu project chưa có profile/tech stack, dùng select-style flow để tránh
 
 `fullstack` bắt chọn frontend, backend và database. Nếu native select chưa có trong Pi host, command trả card compact kèm lệnh deterministic `/profile tech apply ...`.
 
-Nếu `.pi/project-context.md` còn `Generated: not yet`, không nên chạy `/workflow task` implementation.
+Nếu `.pi/project-context.md` còn `Generated: not yet`, nên nhờ agent onboard trước khi giao việc implement.
 
 Memory mặc định là project-scoped và explicit-only. Chạy `/memory` để xem files/rules. `/memory-policy` vẫn là alias. Agent chỉ ghi durable memory khi user yêu cầu rõ ràng.
 
@@ -263,13 +265,13 @@ Project init tạo:
 
 Hai file memory ở trên là local/private mặc định theo `.pi/.gitignore`; chỉ commit nếu team opt-in sau review.
 
-Với luồng FE/BE tách repo nhưng để chung một folder làm việc, mở Pi tại folder cha và chọn `be-readonly-fe` cho chính folder cha đó. Ví dụ `Working/v-nexus-frontend/` và `Working/v-nexus-backend/` là hai Git repo riêng; `Working/.pi/piagent-profile.json` là profile của phiên Pi. Khi start task, scope ghi nên nằm trong FE repo:
+Với luồng FE/BE tách repo nhưng để chung một folder làm việc, mở Pi tại folder cha và chọn `be-readonly-fe` cho chính folder cha đó. Ví dụ `Working/v-nexus-frontend/` và `Working/v-nexus-backend/` là hai Git repo riêng; `Working/.pi/piagent-profile.json` là profile của phiên Pi. Nói rõ phạm vi ghi trong yêu cầu; profile `be-readonly-fe` chặn ghi vào BE:
 
 ```text
-/workflow be-to-fe Scout BE changes read-only and create the FE remediation plan. Scope: v-nexus-frontend/plans/**, v-nexus-frontend/**. Backend repo is read-only.
+Scout BE changes read-only and create the FE remediation plan in v-nexus-frontend/plans/. Backend repo is read-only.
 ```
 
-Plan/report có thể ghi vào `v-nexus-frontend/plans/**` nếu muốn đi cùng FE repo, hoặc `Working/plans/**` nếu muốn lưu ở workspace cha. File ngoài repo con được theo dõi bằng bounded file-digest evidence, còn FE/BE repo con vẫn dùng Git evidence.
+Plan/report có thể ghi vào `v-nexus-frontend/plans/**` nếu muốn đi cùng FE repo, hoặc `Working/plans/**` nếu muốn lưu ở workspace cha.
 
 ## Bước 4 — run trong Herdr
 
@@ -295,92 +297,59 @@ piagent-auto --read-only -p "Scout module mapping. Do not edit source."
 
 Lệnh này wrap `pi --approve`; nó không bypass piagent guard.
 
-## Bước 5 — task workflow
+## Bước 5 — giao việc hằng ngày
+
+Từ bản 1.9.0, mọi việc được yêu cầu bằng lời thường; `/workflow`, `/task`,
+`/scout`, `/discuss`, `/fresh` đã bỏ và session không tạo task contract.
 
 Requirement chưa rõ:
 
 ```text
-/workflow discuss Tạo plan cho feature X. Chưa implement.
+Tạo plan cho feature X. Chưa implement, hỏi lại phần còn thiếu.
 ```
 
 Task rõ:
 
 ```text
-/workflow task Implement feature X. Follow project profile, protected paths, required context, exec policy, context budget, tool policy, verify, trace, and task gate.
+Implement feature X. Chạy test của project sau khi sửa.
 ```
 
 Scout/audit read-only:
 
 ```text
-/workflow scout Scout payment FE mapping vs BE contract. Backend read-only. Do not edit source.
-```
-
-Session nặng hoặc context overflow:
-
-```text
-/fresh scout <read-only scout>
-/fresh task <bounded task>
-/fresh be-to-fe <BE-readonly/FE request>
+Scout payment FE mapping vs BE contract. Backend read-only. Không sửa source.
 ```
 
-Không paste full mandatory flow hằng ngày. Platform prompts/tools đã chứa checklist; input guard sẽ tự collapse boilerplate nếu paste nhầm.
+Session nặng hoặc context overflow: mở session mới bằng `/new` rồi nói lại việc.
 
-Alias cũ `/discuss`, `/task`, `/scout`, `/fresh-*` vẫn chạy cho power user, nhưng tài liệu onboard team dùng `/workflow`, `/name`, `/fresh`, và `/usage` để dễ nhớ hơn.
+Không paste checklist hằng ngày. Guard áp protected path, quyền, context budget
+và xác nhận destructive/external cho từng tool call.
 
-Runtime gate tools:
+Runtime diagnostic tools (agent chỉ dùng khi cần giải thích một lần chặn):
 
 ```text
 piagent_exec_policy_check
 piagent_context_budget
 piagent_tool_policy_check
-piagent_task_gate_check
 ```
 
 Task cải tiến platform:
 
 ```text
-/workflow platform-improve Improve onboarding, model scope, MCP setup, and verification docs for team usage.
+Improve onboarding, model scope, MCP setup, and verification docs for team usage.
 ```
 
 Task BE spec lên FE:
 
 ```text
-/workflow be-to-fe Implement FE from BE contract <endpoint/spec>. Backend is read-only.
-```
-
-Project memory:
-
-```text
-/memory
-Remember: this repo uses pnpm, never npm.
-```
-
-External source repo:
-
-```text
-Use piagent_source_checkout for github.com/org/repo, inspect only relevant files, then summarize applicable patterns.
-```
-
-## Doctor
-
-Chạy trên platform:
-
-```bash
-bash scripts/verify-local.sh
-```
-
-Chạy trên project:
-
-```bash
-bash /path/to/piagent/scripts/profile-doctor.sh /path/to/project
-bash /path/to/piagent/scripts/team-doctor.sh /path/to/project --strict-share
-piagent-benchmark --dry-run
+/profile be-readonly-fe
+Implement FE from BE contract <endpoint/spec>. Backend is read-only.
 ```
 
 Maintainer chạy `piagent-benchmark` khi cần đo release/model bằng automatic paired
 suite. Lệnh dùng model quota và sẽ hỏi xác nhận trước khi bắt đầu.
 
-Nếu doctor cảnh báo `project onboarding snapshot is still pending`, mở Pi trong project và chạy `/onboard run`.
+Nếu doctor cảnh báo `project onboarding snapshot is still pending`, mở Pi trong project và nhờ agent onboard project.
 
 ## Không commit
 

package/docs/usage-observability.md

@@ -278,10 +278,10 @@ Xem `contextUsage.percent`:
 - `< 50%`: bình thường.
 - `50–70%`: bắt đầu tránh đọc file lớn không cần thiết.
 - `70–82%`: chạy `/context compact` trước task dài tiếp theo.
-- `> 82%`: dùng `/fresh <workflow>` cho work mới; `/fresh help` liệt kê mọi workflow canonical.
+- `> 82%`: mở session mới bằng `/new` cho work mới (`/fresh` đã bỏ từ bản 1.9.0).
 - Sau compaction, `contextUsage.tokens` có thể là `null` cho đến khi có assistant response mới.
 
-Nếu user paste full mandatory-flow boilerplate, platform input guard sẽ collapse về workflow command ngắn. Nếu prompt quá dài thật, platform có thể lưu intake vào `.pi/task-inbox/` local gitignored rồi replay bằng fresh workflow command.
+Từ bản 1.9.0 input hook là freeform: nội dung user dán vào được gửi nguyên văn, không còn collapse boilerplate hay lưu intake vào `.pi/task-inbox/`. Prompt quá dài thì nên tách việc hoặc mở session mới bằng `/new`.
 
 Tool output dài cũng bị compact theo cùng triết lý: chat giữ preview, audit/report giữ capture local. Nếu verify fail và preview chưa đủ, chạy lại command targeted hơn thay vì đổ full log vào session.