@piagent/platform 1.7.1 → 1.9.0

package/docs/team-onboarding.md

@@ -9,8 +9,8 @@ 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.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
 cd /path/to/project
 pi
@@ -18,15 +18,16 @@ 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.
-- Pi Coding Agent `0.86.1`.
+- Pi Coding Agent `0.87.1`.
 - Runtime rollout:
   - verified: macOS Apple Silicon + Bash, Linux x64 + Bash;
   - supported target cần smoke trước khi rollout rộng: macOS Intel + Bash, Linux ARM64 + Bash;
@@ -43,8 +44,8 @@ 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.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
 ```
@@ -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;
@@ -106,7 +107,7 @@ Version mới nhất được hỏi npm registry nhiều nhất một lần mỗ
 Sequence thủ công vẫn dùng được, và bắt buộc theo thứ tự này — `piagent-install` **fail** nếu Pi host lệch bản pin, nó không tự nâng host:
 
 ```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
@@ -118,7 +119,7 @@ Full rollback dùng cùng sequence với `vPREVIOUS`, nhưng exact Pi host phả
 Nếu team publish npm private:
 
 ```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
 pi install npm:@your-scope/platform@x.y.z
 ```
 
@@ -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.
 

package/docs/vi/architecture.md

@@ -37,6 +37,7 @@ Rule máy đọc nằm tại `architecture/layers.json`; chạy `npm run archite
 | Layer | Vị trí hiện tại | Ownership | Không được chứa |
 |---|---|---|---|
 | Composition | `packages/piagent-core/extensions/piagent-guard.ts` | Wiring, dependency construction, thứ tự registration | Feature algorithm, mutable state implementation, formatter lớn |
+| Managed harness | `packages/piagent-core/managed/` | Phiên công ty do Agent Watch nhập: grant Studio, tool worker trong sandbox, helper research/review, web search/fetch | OAuth cá nhân, extension cá nhân, quyết định chính sách của Studio |
 | Runtime adapters | `packages/piagent-core/runtime/` | Pi lifecycle hook, shared session state, command/tool registration, input routing | Policy decision dùng lại |
 | Core services | `packages/piagent-core/extensions/` trừ entrypoint | Policy, context, task lifecycle, state service | Pi command menu và UI text |
 | MCP integration | `packages/piagent-core/mcp/` | MCP config layer, readiness, approval, command action | Task và context policy |
@@ -73,7 +74,14 @@ Folder `extensions/` vẫn chứa một số service module do lịch sử. Tên
 
 ## Adaptive durable runtime
 
-Runtime hiện tại có sáu lớp state operational/derived:
+> Từ bản 1.9.0 (bỏ task contract ngày 2026-09-30), session không còn tạo task
+> contract, journal, trajectory hay recovery handoff, và guard không coi bản ghi
+> nào là đang hoạt động. Bốn lớp đầu trong bảng dưới mô tả bản ghi do các bản
+> trước tạo; chúng vẫn đọc được để xem lịch sử và kiểm tra. Lượt freeform vẫn giữ
+> các kiểm tra của guard về path, quyền, xác nhận, context budget và edit trên bản
+> đọc cũ.
+
+Runtime đã định nghĩa sáu lớp state operational/derived:
 
 | Layer | Source of truth | Derived state |
 |---|---|---|

package/docs/workflow-recipes.md

@@ -3,7 +3,7 @@
 
 ## Mục tiêu
 
-Các recipe này biến những bài toán lặp lại thành workflow có tên rõ, dùng được cho project khác mà không phụ thuộc một project nội bộ cụ thể.
+Các recipe này biến những bài toán lặp lại thành cách yêu cầu rõ ràng, dùng được cho project khác mà không phụ thuộc một project nội bộ cụ thể. Từ bản 1.9.0 không còn `/workflow` hay `/onboard`: mỗi recipe là một yêu cầu bằng lời thường.
 
 ## Recipe 1 — Platform improvement
 
@@ -12,11 +12,11 @@ Dùng khi muốn cải tiến setup, prompt, MCP, model scope, memory, runtime p
 Lệnh trong Pi:
 
 ```text
-/onboard
-/onboard run
-/workflow platform-improve Improve <target behavior> in <platform area>.
+Improve <target behavior> in <platform area>.
 ```
 
+Nếu project chưa onboard, nhờ agent "đọc project (chỉ đọc) và ghi lại project context" trước.
+
 Input tối thiểu:
 
 - source docs URL hoặc repo URL nếu task cần external context;
@@ -60,9 +60,7 @@ Setup project generic:
 Lệnh trong Pi:
 
 ```text
-/onboard
-/onboard run
-/workflow be-to-fe Implement FE from BE spec: <endpoint/spec/change>
+Implement FE from BE spec: <endpoint/spec/change>. Backend is read-only.
 ```
 
 Input tối thiểu:
@@ -115,8 +113,6 @@ Rule:
 Dùng khi muốn giảm scout lại giữa các session mà không bật auto memory.
 
 ```text
-/onboard
-/onboard run
 /context index
 /context search auth
 ```
@@ -126,4 +122,4 @@ Rule:
 1. Context index là advisory map, không phải source of truth.
 2. Node/edge phải ngắn và có citation tới file/doc/task đã verify.
 3. Không lưu raw transcript, secret, token, session, hoặc source excerpt dài.
-4. Nếu index stale so với profile/tech/onboarding snapshot, chạy lại `/onboard run` hoặc record lại bằng `piagent_context_index_record`.
+4. Nếu index stale so với profile/tech/onboarding snapshot, nhờ agent onboard lại hoặc record lại bằng `piagent_context_index_record`.

package/docs-site/architecture.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.7.1 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.9.0 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/architecture" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/architecture" hreflang="en" lang="en">EN</a>
@@ -59,6 +59,7 @@
           <div class="nav-group">
             <p class="nav-title">Get started</p>
             <a class="nav-link" href="/">Overview</a>
+            <a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
             <a class="nav-link" href="/quickstart">Quickstart</a>
             <a class="nav-link" href="/whats-new">Có gì mới</a>
             <a class="nav-link" href="/scope">Phạm vi platform</a>
@@ -147,8 +148,8 @@
       <p><span class="inline-code">runtime/context/adaptive-planner.ts</span> chọn budget, retrieval lane, code inclusion và plan receipt theo phase, context pressure, model capability và thinking level.</p>
     </article>
     <article class="card">
-      <h3>Task journal</h3>
-      <p><span class="inline-code">extensions/task-journal.js</span> ghi checkpoint cho start, progress, mutation, verifier và completion. Resume tin task contract trước; retention compaction giữ hash anchor.</p>
+      <h3>Lịch sử task cũ</h3>
+      <p><span class="inline-code">extensions/task-journal.js</span> vẫn đọc checkpoint của các task tạo trước bản 1.9.0 để xem lại; session mới không ghi task nữa.</p>
     </article>
     <article class="card">
       <h3>Repository memory</h3>

package/docs-site/assets/docs.css

@@ -1457,3 +1457,83 @@ h3[id] {
     display: none;
   }
 }
+
+/* Screenshots and diagrams. Screenshots are taken from the dashboard in dark
+   mode so they sit on the page without a bright frame. */
+.shot {
+  margin: 28px 0 0;
+  border: 1px solid var(--line);
+  border-radius: 18px;
+  overflow: hidden;
+  background: var(--panel);
+  box-shadow: var(--shadow);
+}
+
+.shot img {
+  display: block;
+  width: 100%;
+  height: auto;
+}
+
+.shot figcaption {
+  padding: 12px 18px 14px;
+  border-top: 1px solid var(--line-soft);
+  color: var(--muted);
+  font-size: 0.92rem;
+}
+
+.shot-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 20px;
+  margin-top: 24px;
+}
+
+.shot-grid .shot {
+  margin: 0;
+}
+
+.diagram {
+  margin: 24px 0 0;
+  padding: 18px;
+  border: 1px solid var(--line);
+  border-radius: var(--radius);
+  background: var(--bg-soft);
+  overflow-x: auto;
+}
+
+.diagram svg {
+  display: block;
+  width: 100%;
+  min-width: 720px;
+  height: auto;
+}
+
+.diagram-hint {
+  display: none;
+  margin-top: 8px;
+  color: var(--muted-2);
+  font-size: 0.85rem;
+}
+
+@media (max-width: 860px) {
+  .shot-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .diagram-hint {
+    display: block;
+  }
+
+  .diagram {
+    padding: 10px;
+  }
+}
+
+/* Long unbroken tokens (commit hashes, run ids) in running text wrap instead
+   of widening the page on a phone. */
+p code,
+li code,
+td code {
+  overflow-wrap: anywhere;
+}

package/docs-site/benchmark.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.7.1 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.9.0 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/benchmark" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/benchmark" hreflang="en" lang="en">EN</a>
@@ -59,6 +59,7 @@
           <div class="nav-group">
             <p class="nav-title">Get started</p>
             <a class="nav-link" href="/">Overview</a>
+            <a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
             <a class="nav-link" href="/quickstart">Quickstart</a>
             <a class="nav-link" href="/whats-new">Có gì mới</a>
             <a class="nav-link" href="/scope">Phạm vi platform</a>
@@ -102,6 +103,11 @@
               <h1>Bằng chứng chất lượng và hiệu suất</h1>
               <p>Production benchmark so sánh Piagent với surface codex-cli trên cùng model, cùng thinking level, 18 nhóm bài và 108 session được chấm tự động.</p>
             </div>
+<div class="callout">
+  <strong>Số liệu lịch sử</strong>
+  <p>Phép đo này chạy ở v1.6.0, khi session còn task contract và các lệnh workflow. Bản 1.9.0 làm việc theo lời thường và chưa đo lại; đừng dùng các con số dưới đây cho 1.9.0.</p>
+</div>
+
 <section class="benchmark-summary" aria-labelledby="benchmark-verdict">
   <div class="benchmark-verdict">
     <div>

package/docs-site/commands.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.7.1 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.9.0 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/commands" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/commands" hreflang="en" lang="en">EN</a>
@@ -59,6 +59,7 @@
           <div class="nav-group">
             <p class="nav-title">Get started</p>
             <a class="nav-link" href="/">Overview</a>
+            <a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
             <a class="nav-link" href="/quickstart">Quickstart</a>
             <a class="nav-link" href="/whats-new">Có gì mới</a>
             <a class="nav-link" href="/scope">Phạm vi platform</a>
@@ -110,7 +111,6 @@
       <div class="tag-list">
         <span class="tag">/login</span>
         <span class="tag">/model</span>
-        <span class="tag">/commands</span>
         <span class="tag">/piagent-status</span>
         <span class="tag">/piagent-inspector</span>
         <span class="tag">/piagent-orchestration</span>
@@ -119,10 +119,10 @@
         <span class="tag">/task-preflight</span>
         <span class="tag">/context preflight</span>
         <span class="tag">/name</span>
-        <span class="tag">/fresh</span>
+        <span class="tag">/new</span>
         <span class="tag">/session</span>
       </div>
-      <p>Dùng để setup session, chọn model, xem profile/usage/orchestration và quyết định có cần fresh session trước task lớn không.</p>
+      <p>Dùng để setup session, chọn model, xem profile/usage/orchestration và quyết định có cần mở session mới (<span class="inline-code">/new</span>) trước việc lớn không.</p>
     </article>
     <article class="card">
       <h3 id="project-profile">Project profile</h3>
@@ -139,35 +139,32 @@
       <p>Áp profile trực tiếp hoặc mở select option để chọn profile/tech stack. Output ngắn, không yêu cầu model giải thích dài.</p>
     </article>
     <article class="card">
-      <h3 id="implementation-workflow">Implementation workflow</h3>
+      <h3 id="implementation-workflow">Giao việc</h3>
       <div class="tag-list">
-        <span class="tag">/workflow</span>
-        <span class="tag">/workflow task</span>
-        <span class="tag">/workflow plan</span>
-        <span class="tag">/workflow review</span>
-        <span class="tag">/workflow scout</span>
-        <span class="tag">/workflow discuss</span>
+        <span class="tag">lời thường</span>
+        <span class="tag">chỉ đọc, không sửa</span>
+        <span class="tag">lập plan trước</span>
+        <span class="tag">review diff</span>
       </div>
-      <p>Gói sẵn read context, task contract, implementation, verify evidence và final handoff.</p>
+      <p>Từ bản 1.9.0 không còn <span class="inline-code">/workflow</span>, <span class="inline-code">/task</span> hay task contract: nói việc cần làm bằng lời thường; guard kiểm tra từng tool call.</p>
     </article>
     <article class="card">
       <h3 id="git-handoff">Git handoff</h3>
       <div class="tag-list">
-        <span class="tag">/workflow commit</span>
-        <span class="tag">/workflow pr</span>
+        <span class="tag">commit bằng lời thường</span>
+        <span class="tag">draft PR bằng lời thường</span>
         <span class="tag">git status</span>
         <span class="tag">git diff</span>
       </div>
-      <p>Không cần namespace <span class="inline-code">/git</span>. Commit/PR đi qua workflow guard; push và stage rộng như <span class="inline-code">git add -A</span> cần xác nhận.</p>
+      <p>Không cần namespace <span class="inline-code">/git</span>. Commit/PR là yêu cầu thường; push, ghi lên GitHub và stage rộng như <span class="inline-code">git add -A</span> cần xác nhận.</p>
     </article>
     <article class="card">
-      <h3 id="fresh-sessions">Fresh sessions</h3>
+      <h3 id="fresh-sessions">Session mới</h3>
       <div class="tag-list">
-        <span class="tag">/fresh task</span>
-        <span class="tag">/fresh scout</span>
-        <span class="tag">/fresh be-to-fe</span>
+        <span class="tag">/new</span>
+        <span class="tag">/compact</span>
       </div>
-      <p>Dùng khi context đã nặng hoặc cần một session sạch cho workflow mới.</p>
+      <p>Dùng khi context đã nặng hoặc cần một session sạch cho việc mới (<span class="inline-code">/fresh</span> đã bỏ từ bản 1.9.0).</p>
     </article>
     <article class="card">
       <h3 id="mcp">MCP</h3>
@@ -201,9 +198,9 @@
       <p>Xem intent, risk, scope, runtime, solver route, phase, tool/helper recommendation, backend, approval và blocker trước khi bắt đầu.</p>
     </article>
     <article class="command-card">
-      <header><span>Live task status</span><button class="clip-btn" data-clip="/piagent-status">Lấy lệnh</button></header>
+      <header><span>Trạng thái session</span><button class="clip-btn" data-clip="/piagent-status">Lấy lệnh</button></header>
       <pre><code>/piagent-status</code></pre>
-      <p>Đọc Task Contract, checkpoint, verifier, recovery, helper, resume state và terminal receipt. Receipt chỉ approved khi hard completion gate trên working tree hiện tại pass.</p>
+      <p>Profile, guard, runtime và model đang dùng của session. Không sửa file, không chạy lại check và không mở lượt model.</p>
     </article>
     <article class="command-card">
       <header><span>Activity, diff và context</span><button class="clip-btn" data-clip="/piagent-inspector">Lấy lệnh</button></header>
@@ -223,7 +220,24 @@
   </div>
   <div class="callout">
     <strong>Diff rõ nguồn, token không ước lượng.</strong>
-    <p>Footer status dùng file task đã quan sát để cập nhật nhanh; view <span class="inline-code">files</span> tính exact snapshot delta và đánh dấu <span class="inline-code">mixed-working-tree</span> nếu task đụng file đã dirty từ trước. Pi chỉ cung cấp model usage theo turn/session, nên token theo từng built-in tool luôn hiện unavailable.</p>
+    <p>Footer status dùng các file đã quan sát trong session để cập nhật nhanh; view <span class="inline-code">files</span> tính exact snapshot delta và đánh dấu <span class="inline-code">mixed-working-tree</span> nếu lượt làm việc đụng file đã dirty từ trước. Pi chỉ cung cấp model usage theo turn/session, nên token theo từng built-in tool luôn hiện unavailable.</p>
+  </div>
+</section>
+
+<section class="section">
+  <p class="section-kicker">Skill và package tùy chọn</p>
+  <h2 id="skill-va-package">Kiểm tra chất lượng test, chạy vòng thử nghiệm</h2>
+  <div class="command-grid">
+    <article class="command-card">
+      <header><span>Rà soát test</span><button class="clip-btn" data-clip="/skill:test-audit rà soát test của module thanh toán">Lấy lệnh</button></header>
+      <pre><code>/skill:test-audit rà soát test của module thanh toán</code></pre>
+      <p>Skill <span class="inline-code">test-audit</span> đi kèm Piagent: chặn test mới không bảo vệ hành vi nào, tìm test trùng, test bám vào cách cài đặt và code chỉ tồn tại để phục vụ test. Agent tự dùng khi viết hay sửa test; gõ lệnh trên để rà cả một vùng.</p>
+    </article>
+    <article class="command-card">
+      <header><span>Vòng thử nghiệm</span><button class="clip-btn" data-clip="git switch -c experiment/toc-do-test">Lấy lệnh</button></header>
+      <pre><code>git switch -c experiment/toc-do-test</code></pre>
+      <p>Nếu cài thêm package có vòng thử nghiệm tự động (<span class="inline-code">run_experiment</span>, <span class="inline-code">log_experiment</span>): guard kiểm lệnh thử như mọi lệnh shell, và chỉ cho vòng lặp chạy trên nhánh <span class="inline-code">experiment/</span> hoặc worktree riêng, bắt đầu khi không còn thay đổi chưa commit, vì mỗi lần bỏ một ý tưởng nó xóa mọi thay đổi chưa commit.</p>
+    </article>
   </div>
 </section>
             <nav class="pager" aria-label="Trang kế tiếp">

package/docs-site/content/architecture.html

@@ -43,8 +43,8 @@
       <p><span class="inline-code">runtime/context/adaptive-planner.ts</span> chọn budget, retrieval lane, code inclusion và plan receipt theo phase, context pressure, model capability và thinking level.</p>
     </article>
     <article class="card">
-      <h3>Task journal</h3>
-      <p><span class="inline-code">extensions/task-journal.js</span> ghi checkpoint cho start, progress, mutation, verifier và completion. Resume tin task contract trước; retention compaction giữ hash anchor.</p>
+      <h3>Lịch sử task cũ</h3>
+      <p><span class="inline-code">extensions/task-journal.js</span> vẫn đọc checkpoint của các task tạo trước bản 1.9.0 để xem lại; session mới không ghi task nữa.</p>
     </article>
     <article class="card">
       <h3>Repository memory</h3>

package/docs-site/content/benchmark.html

@@ -1,3 +1,8 @@
+<div class="callout">
+  <strong>Số liệu lịch sử</strong>
+  <p>Phép đo này chạy ở v1.6.0, khi session còn task contract và các lệnh workflow. Bản 1.9.0 làm việc theo lời thường và chưa đo lại; đừng dùng các con số dưới đây cho 1.9.0.</p>
+</div>
+
 <section class="benchmark-summary" aria-labelledby="benchmark-verdict">
   <div class="benchmark-verdict">
     <div>