@piagent/platform 1.2.10 → 1.2.12

package/docs/task-lifecycle-vietnamese.md

@@ -1,139 +1,143 @@
-# Vòng đời một task: research → plan → execute → verify → loop
+# Vong doi task trong Pi Agent Platform
 
-## Mục tiêu
+## Muc tieu
 
-Tài liệu này mô tả một task chạy qua platform từ đầu tới cuối, và nói thẳng harness hiện tại đỡ được khâu nào, chưa đỡ được khâu nào. Mọi nhận định đều dẫn tới dòng code cụ thể, để khi code đổi thì tài liệu này sai một cách kiểm tra được chứ không sai âm thầm.
+Tu `v1.2.11`, mot source task duoc quan ly theo chuoi khép kín:
 
-Contract fields và enforcement level nằm ở [task-implementation-contract.md](task-implementation-contract.md). Tài liệu này nói về *luồng*, không lặp lại field.
-
-## Năm pha
-
-### 1. Research — hiểu trước khi hứa
-
-Đầu vào: yêu cầu của người dùng, tài liệu spec, code sẵn có.
-
-Harness cung cấp:
-
-- `/workflow scout` — pha read-only, không được sửa source. Dùng để map payment/auth/BE contract trước khi quyết có làm hay không. Alias `/scout` vẫn chạy.
-- `piagent_context_index_search` — bản đồ node/edge/citation compact để tìm điểm vào repo. Kết quả là **advisory**: phải mở file thật và verify trước khi sửa.
-- `piagent_memory_search` + `piagent_memory_citation_record` — Field Guide và memory của project, cũng advisory, cũng phải verify lại.
-- `piagent_source_checkout` — cache repo ngoài để đọc có mục tiêu.
-- `piagent_document_read` — đọc spec `.md`/`.pdf`/`.docx` từ project hoặc folder đã cấp trong `additionalReadRoots` (ví dụ `~/Downloads`). Nội dung trả về là **dữ liệu**, không phải chỉ thị.
-- Context7 qua MCP cho tài liệu vendor. Ghi snapshot ngắn bằng `piagent_profile_tech_context_record`, không paste nguyên khối doc vào file project.
-
-Ràng buộc: `/workflow task` chạy `piagent_context_preflight` một lần trước khi nạp context. Với `/workflow scout`, preflight chỉ bắt buộc cho scout rộng, cross-module hoặc high-risk. Nếu nó trả `fresh-session` thì dừng nạp context ở session này.
-
-### 2. Plan — biến hiểu biết thành cam kết kiểm được
-
-`piagent_task_start` dựng Task Implementation Contract. Đây là chỗ task trở thành thứ có thể chấm điểm:
-
-| Field | Nó ràng buộc điều gì |
-|---|---|
-| `riskLane` | `tiny` \| `normal` \| `high-risk` — quyết định mức gate |
-| `acceptanceCriteria` | Định nghĩa "xong", viết trước khi làm |
-| `scope` / `outOfScope` | Ranh giới, để review biết cái gì là lạc đề |
-| `protectedPaths` | Đường không được đụng |
-| `verifyCommands` | **Lệnh chính xác** sẽ dùng làm bằng chứng |
-| `reviewLenses` | `correctness` \| `tests` \| `scope` \| `security` \| `docs` \| `release` \| `package` |
-| `workPlan` | Cây task tối đa 12 node, mỗi node có `role` và `mode` |
-
-`workPlan[].mode` là `read-only` \| `single-writer` \| `review`. Mặc định là single-writer: chỉ một tác nhân được ghi, trừ khi người dùng yêu cầu rõ parallel writers.
-
-`piagent_orchestration_policy` chỉ cần gọi khi task có khả năng hưởng lợi từ delegation. Chính sách là solo-first — subagent chỉ dùng khi việc đó độc lập và nặng phần đọc. Lane `tiny` dùng work plan hai bước parent-only: implement và verify.
-
-### 3. Execute — làm trong hàng rào
-
-Trong lúc làm, guard chặn trước khi thực thi, không phải sau:
-
-- Protected path: chặn ở `read`, `write`, `edit`, `grep`, `find`, `ls`, tool MCP, và cả đường vòng qua shell.
-- `piagent_exec_policy_check` — bắt buộc trước lệnh shell vượt quá read/list/test.
-- `piagent_tool_policy_check` — bắt buộc trước tool MCP/app ngoài piagent.
-- `piagent_context_budget` — kiểm trước khi nạp file lớn hoặc lạ.
-- `piagent_context_record` — ghi lại đọc file nào, vì lý do gì.
-
-### 4. Verify — chỗ mạnh nhất của harness
-
-Đây là phần được thiết kế kỹ nhất, và đáng để hiểu chính xác.
-
-Bằng chứng verify **không phải** thứ agent tự khai. Guard nghe `tool_result` của Pi và ghi vào sổ `.pi/piagent-state/observed-bash.jsonl` ([`piagent-guard.ts:1378`](../packages/piagent-core/extensions/piagent-guard.ts)). `piagent_verify_record` chỉ nhận bằng chứng khớp được với một quan sát thật, sau thời điểm task bắt đầu.
-
-`evaluateTaskGate` ([`piagent-guard.ts:3125`](../packages/piagent-core/extensions/piagent-guard.ts)) đòi ba điều kiện cộng dồn để một bằng chứng được tính là **pass**:
-
-```
-evidence.exitCode === 0
-&& evidence.observed === true            // đã quan sát được, không phải khai báo
-&& evidence.matchedProfileCommand === true  // khớp đúng verifyCommands của task
+```text
+session name -> task contract v2 -> scoped work plan -> observed changes
+-> exact verification -> immutable outcome -> retry evidence
 ```
 
-Thiếu bất kỳ điều nào thì bằng chứng vẫn được ghi, nhưng chỉ ở mức advisory và gate không tính. Cụ thể:
-
-- `observed !== true` → cảnh báo "Unobserved verify evidence is ignored by the passing verify gate."
-- `observed === true` nhưng lệnh không khớp `verifyCommands` → "advisory only".
-
-Nghĩa là `true`, `echo ok`, `npm test || true` không mua được chữ "done". Đó là chủ ý: một cổng có thể lách được thì tệ hơn không có cổng, vì nó vẫn hiện màu xanh.
-
-`piagent_task_gate_check` trả `pass` hoặc `fail` kèm danh sách `missing`. Gate fail thì outcome là `blocked`/`partial`, **không phải** `done`.
-
-### 5. Fail → loop lại
-
-Đây là chỗ đứt. Xem mục [Chỗ đứt, nói chính xác](#chỗ-đứt-nói-chính-xác).
-
-## Pi hiện tại xử lý tới đâu
+Runtime guard thi hanh chuoi nay. Prompt chi huong dan agent, khong phai lop
+enforcement chinh.
 
-| Pha | Trạng thái | Căn cứ |
-|---|---|---|
-| Research | **Đủ** | `/workflow scout`, context index, memory, Context7, source checkout |
-| Plan | **Đủ** | `piagent_task_start` + 19 field contract + `workPlan` |
-| Execute | **Đủ** | Chặn trước thực thi ở mọi đường: tool, MCP, shell |
-| Verify | **Mạnh** | Bằng chứng phải quan sát được và khớp lệnh, không tự khai được |
-| Fail → loop | **Nửa vời** | Phát hiện được, từ chối nhận done được, nhưng không mang được state qua lần sau |
+## Luong lam viec hang ngay
 
-### Chỗ đứt, nói chính xác
+1. Mo project bang Pi va dat ten session theo task noi bo.
+2. Neu quen dat luc mo, chay `/name <task/session name>` hoac `/setname`.
+3. Chay `/workflow task <yeu cau>` de implement, hoac `/workflow scout <yeu cau>`
+   de chi doc.
+4. Runtime tu tao Task Implementation Contract cho task nho, ro scope va gan voi
+   dung Pi session truoc model turn dau tien.
+5. Agent lam viec ngay bang read/edit/bash thuong va chay exact verifier runtime
+   cung cap. Chi task rong, high-risk hoac scope mo ho moi can goi
+   `piagent_task_start` mot lan. Runtime tu ghi context, changed files, verify,
+   trace va gate.
+6. Neu dong terminal, resume dung session cu bang `pi --continue`, `pi --resume`
+   hoac `pi --session <id-or-file>`. Task dang mo duoc map lai theo session id va
+   custom trace cua Pi; session name van dung cho Agent Watch/report.
 
-Harness **phát hiện** thất bại tốt:
+Mot Pi session chi thuoc mot task, ke ca sau khi task da completed/failed. Task
+moi hoac retry phai dung session moi. Quy tac nay ngan hai cong viec tron prompt,
+usage va changed-file evidence vao mot report.
 
-- `trace.outcome` có `failed`, `blocked`, `partial` bên cạnh `completed`.
-- `task.md` yêu cầu verify không chạy được thì dừng và báo blocker chính xác, không được gọi là done.
-- Gate trả `missing` liệt kê đúng thứ còn thiếu.
+## Nam pha
 
-Nhưng nó **không mang được gì sang lần thử sau**:
+### 1. Research
 
-1. **Contract không có bộ đếm lần thử.** Không có `attempt`, không có `previousAttempts`. Lần thử thứ hai bắt đầu như thể chưa từng có lần một.
-2. **`workPlan[].status` không có giá trị `failed`.** Enum chỉ là `pending` \| `in-progress` \| `done` \| `skipped` ([`schemas/task-contract.schema.json`](../schemas/task-contract.schema.json)). Một node đã thử và hỏng chỉ có thể ghi là `skipped` — mất nghĩa.
-3. **Không có chỗ ghi giả thuyết đã loại.** Verify fail vì lý do gì, đã thử cách nào, tại sao không được — không field nào giữ. Lần sau agent rất dễ thử lại đúng cách đã hỏng.
-4. **Không có trần số vòng.** Không có gì chặn loop vô hạn ngoài sự kiên nhẫn của người dùng.
+- `/workflow scout` tao luong read-only khi chua can sua source.
+- Pi Context Engine tim file/symbol/test bang FTS, import graph va Git signals.
+- Memory, Context7, source checkout va document reader la advisory evidence;
+  agent van phai doc file hien tai truoc khi sua.
+- Auto-context chi inject mot bounded pack cho moi prompt trong tung session.
+  Goi pack lai voi cung query se tra reuse marker, khong nhan doi payload/token.
 
-`/review-loop` có tồn tại và đúng là loop, nhưng nó đến từ add-on `pi-subagents` chứ không phải platform này, và nó lặp vòng review→fix, không phải vòng research→plan→execute→verify.
+### 2. Plan
 
-### Đề xuất để khép vòng
+Automatic intake hoac fallback `piagent_task_start` tao contract schema v2 gom:
 
-Thêm vào contract, không đổi thứ đang có:
-
-```jsonc
-{
-  "attempt": 2,                    // lần thử hiện tại
-  "maxAttempts": 3,                // trần, gate fail cứng khi vượt
-  "previousAttempts": [
-    {
-      "attempt": 1,
-      "failedAt": "verify",        // research | plan | execute | verify
-      "reason": "npm test — 3 test đỏ ở auth/session",
-      "ruledOut": "Không phải do token expiry; đã kiểm bằng fixture cố định giờ."
-    }
-  ]
-}
-```
-
-Và mở `workPlan[].status` thêm giá trị `failed`.
-
-Chi phí: một field mảng trong schema, một nhánh trong `evaluateTaskGate`, một bước trong `task.md`. Đổi lại, lần thử thứ hai đọc được lần thứ nhất đã loại trừ gì — đó là toàn bộ giá trị của việc loop thay vì làm lại.
-
-Đây là đề xuất, chưa implement. Cần chốt trước khi làm.
-
-## Liên quan
-
-- [task-implementation-contract.md](task-implementation-contract.md) — field và enforcement level
-- [workflow-recipes.md](workflow-recipes.md) — công thức cho từng loại việc
-- [runtime-policy-design.md](runtime-policy-design.md) — thiết kế lớp policy
-- [security-threat-model.md](security-threat-model.md) — giả định, vector, và rủi ro còn lại
-- [command-reference-vietnamese.md](command-reference-vietnamese.md) — giải thích từng lệnh
+| Nhom | Field chinh |
+|---|---|
+| Identity | `taskRunId`, `taskId`, `sessionId`, `sessionName`, `intakeMode` |
+| Retry | `attempt`, `maxAttempts`, `previousAttempts` |
+| Boundary | `changeMode`, `scope`, `outOfScope`, `protectedPaths` |
+| Quality | `acceptanceCriteria`, `verifyGroup`, `verifyCommands`, `reviewLenses` |
+| Execution | `workPlan`, `orchestration` |
+| Evidence | context, memory, baseline/observed/final file digests, verify, trace |
+
+Source task bat buoc nam trong Git working tree. Khong co Git thi runtime tu
+choi source-change vi khong the chung minh file nao da doi; read-only scout van
+hoat dong.
+
+Work plan toi da 12 step, dependency khong duoc thieu, tu tham chieu hoac tao
+cycle. Source task `tiny` tu dong hoan tat lifecycle; source task `normal` tu
+dong ghi objective evidence va giu mot explicit review step. Read-only task dung
+plan `scout`/`review`, khong con step `implement` mau thuan. Task high-risk/custom
+van giu checkpoint thu cong. Chi dung subagent cho scout, planning hoac review
+doc lap. Mot write set chi co mot owner.
+
+### 3. Execute
+
+Truoc khi co task contract, project da onboard chi cho inspection co gioi han;
+write/edit va shell command that su ghi file bi chan. Sau khi task bat dau:
+
+- direct tool va MCP write phai nam trong `scope`;
+- read-only task chan moi project/external mutation;
+- protected path, secret redaction, destructive command va external confirmation
+  van manh hon task gate;
+- tool result ghi nhan file da quan sat thay doi;
+- file da dirty truoc task chi tinh la thay doi cua task neu digest sau task khac
+  baseline;
+- rename ghi nhan ca source va destination.
+
+### 4. Verify va complete
+
+Moi lenh trong `task.verifyCommands` phai duoc Pi `bash` chay that sau thoi diem
+task bat dau. Hook `tool_result` tu ghi evidence khi command identity khop plan;
+tool `piagent_verify_record` chi con la recovery surface va van phai khop ledger
+`.pi/piagent-state/observed-bash.jsonl`.
+
+Gate completed yeu cau dong thoi:
+
+- context manifest theo policy;
+- moi verify command co observed result `exitCode=0` va exact match;
+- work plan khong con `pending`, `in-progress` hoac `failed`;
+- declared changed files khop final digest sau baseline; file da revert khong tinh;
+- khong co file ngoai `scope`;
+- final trace la `completed`.
+
+`true`, `echo ok`, `npm test || true` hoac command gan giong khong thay the lenh
+verify da chot. Hard completion hook tu project final state, check gate va ghi
+completed trace. Evidence verify chi hop le cho working-tree digest hien tai;
+sua tiep sau verify buoc phai chay lai. Neu automatic/assisted task dung som,
+runtime gui dung mot follow-up correction turn voi missing reasons that, sau do
+khong loop.
+
+Sau terminal outcome (`completed`, `blocked`, `partial`, `failed`), contract la
+immutable. Agent khong the chen them context/verify/change evidence de viet lai
+lich su.
+
+### 5. Fail va retry
+
+`workPlan[].status` co `failed`. Final failure ghi `failedAt`, `failureReason`,
+`ruledOut` va friction. Session moi dung cung `taskId` tao attempt tiep theo va
+mang theo toi da 10 attempt summaries.
+
+`maxAttempts` duoc khoa tu attempt dau (mac dinh 3, toi da 10). Sua tay attempt
+sau khong the nang tran. Completed task khong duoc mo lai bang cung `taskId`;
+cong viec moi phai co ID moi.
+
+## Migration va local state
+
+Session start va `piagent-update --project <path>` deu nhan biet contract v1.
+Migration:
+
+- preview truoc khi ghi;
+- tu choi toan bo neu co state unreadable/corrupt;
+- tao contract v2 roi archive v1, co the chay lai sau interruption;
+- chi map legacy task vao session resume khi custom Pi trace chung minh dung task;
+- khong yeu cau onboard lai project.
+
+State, telemetry va capture nam trong `.pi/piagent-state/`, mode owner-only. Moi
+writer dung chung local-state boundary, tu choi `.pi`/ancestor symlink thoat
+project. JSONL duoc rotate co lock lien process; capture gioi han 500 file,
+128 MiB va 30 ngay.
+
+## Lien quan
+
+- [Task Implementation Contract](task-implementation-contract.md)
+- [Runtime harness standard](runtime-harness-standard.md)
+- [Pi Context Engine](context-engine.md)
+- [Command reference](command-reference-vietnamese.md)
+- [Usage observability](usage-observability.md)

package/docs/team-onboarding.md

@@ -9,7 +9,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.82.0
-npm install -g --ignore-scripts @piagent/platform@1.2.10
+npm install -g --ignore-scripts @piagent/platform@1.2.12
 piagent-install --stable
 cd /path/to/project
 pi
@@ -43,7 +43,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.82.0
-npm install -g --ignore-scripts @piagent/platform@1.2.10
+npm install -g --ignore-scripts @piagent/platform@1.2.12
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -79,7 +79,12 @@ 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ũ nếu có rồi chạy doctor strict-share. `--check` chỉ báo version, không đụng gì.
+`--project` là bước phụ: tự migrate layout cũ, Task Contract 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;
+chạy `--project` để file trên disk được dọn bền vững. `--check` chỉ báo version,
+không đụng gì.
 
 Nếu npm global mặc định của máy bị khóa quyền ở `/usr/local`, updater tự chuyển sang `~/.pi/npm-global` cho user hiện tại và in dòng `PATH` cần thêm. Không chạy doctor bằng `sudo`.
 
@@ -360,9 +365,12 @@ 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
-bash /path/to/piagent/scripts/quality-benchmark.sh /path/to/project --init
+piagent-benchmark --dry-run
 ```
 
+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`.
 
 ## Không commit

package/docs/usage-observability.md

@@ -131,6 +131,11 @@ Hoặc đổi tên phiên đang mở trong Pi:
 
 Alias ngắn `/setname ABC-123 Short task name` vẫn chạy. Nếu tắt nhầm terminal/app, vào lại project rồi dùng `pi --continue` cho phiên gần nhất, hoặc `pi --resume` để chọn theo session name/id. Trong Pi có thể gõ `/resume` để xem reminder ngắn.
 
+Task Contract v2 lưu cả `sessionId`, `sessionName`, `taskId` và `taskRunId`, nên
+Agent Watch/report có thể map usage vào đúng attempt kể cả session đã resume hoặc
+được đổi tên sau khi bắt đầu. Một session không được tái sử dụng cho task khác;
+retry dùng session mới và giữ liên kết qua cùng `taskId`.
+
 Mặc định history mode **bao gồm subagent session files** vì đó là usage thật của máy. Dùng `--no-subagents` khi chỉ muốn parent/main sessions.
 
 Format hỗ trợ:
@@ -169,18 +174,20 @@ Nếu user paste full mandatory-flow boilerplate, platform input guard sẽ coll
 
 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.
 
+Trace, observed-bash, telemetry và capture đều bounded và owner-only. Rotation
+không cần UI polling realtime, dùng lock liên process để nhiều Pi session/subagent
+không ghi đè nhau. Capture mặc định giữ tối đa 500 file, 128 MiB và 30 ngày.
+
 ## Khi nào ghi benchmark
 
 Sau một task cần so sánh workflow/model bằng số liệu:
 
 ```bash
-bash scripts/quality-benchmark.sh /path/to/project --record \
-  --scenario bounded-source-fix \
-  --surface pi \
-  --result pass \
-  --tokens <total-from-piagent-usage> \
-  --cost <cost-from-piagent-usage> \
-  --verify "<verify-command>"
+piagent-benchmark --dry-run
+piagent-benchmark --model <provider/model> --thinking high
 ```
 
-Không dùng ước lượng ký tự để claim tiết kiệm token. Dùng `/session`, RPC `get_session_stats`, hoặc `piagent-usage`.
+Automatic runner lấy exact usage từ session JSONL và so median trên các cặp cùng
+pass. Không dùng ước lượng ký tự để claim tiết kiệm token. Với một task ngoài
+suite, vẫn dùng `/session`, RPC `get_session_stats`, `piagent-usage`, hoặc legacy
+`piagent-benchmark <project> --record ...`.

package/docs-site/architecture.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/commands.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/content/runtime.html

@@ -25,6 +25,22 @@ piagent-install --version vX.Y.Z --resolve-tag</code></pre>
       <header><span>Doctor</span><button class="clip-btn" data-clip="piagent-doctor /path/to/project">Lấy lệnh</button></header>
       <pre><code>piagent-doctor /path/to/project</code></pre>
     </article>
+    <article class="command-card">
+      <header><span>Smoke benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --dry-run&#10;piagent-benchmark">Lấy lệnh</button></header>
+      <pre><code>piagent-benchmark --dry-run
+piagent-benchmark</code></pre>
+    </article>
+    <article class="command-card">
+      <header><span>Production benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --production --dry-run&#10;piagent-benchmark --production --surfaces piagent,codex-cli --model openai-codex/gpt-5.6-sol --thinking xhigh">Lấy lệnh</button></header>
+      <pre><code>piagent-benchmark --production --dry-run
+piagent-benchmark --production --surfaces piagent,codex-cli \
+  --model openai-codex/gpt-5.6-sol --thinking xhigh</code></pre>
+    </article>
+    <article class="command-card">
+      <header><span>Compare codex-cli</span><button class="clip-btn" data-clip="piagent-benchmark --surfaces piagent,codex-cli --model openai-codex/gpt-5.6-sol --thinking xhigh">Lấy lệnh</button></header>
+      <pre><code>piagent-benchmark --surfaces piagent,codex-cli \
+  --model openai-codex/gpt-5.6-sol --thinking xhigh</code></pre>
+    </article>
     <article class="command-card">
       <header><span>Trusted run</span><button class="clip-btn" data-clip="piagent-auto --full-access -p &quot;Run the trusted local benchmark suite.&quot;">Lấy lệnh</button></header>
       <pre><code>piagent-auto --read-only -p "Scout payment mapping. Do not edit source."

package/docs-site/context-engine.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/index.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/mcp-approval.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/mcp-auth.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/mcp-servers.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/mcp.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/permissions.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/profiles.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/quickstart.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/runtime.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
@@ -120,6 +120,22 @@ piagent-install --version vX.Y.Z --resolve-tag</code></pre>
       <header><span>Doctor</span><button class="clip-btn" data-clip="piagent-doctor /path/to/project">Lấy lệnh</button></header>
       <pre><code>piagent-doctor /path/to/project</code></pre>
     </article>
+    <article class="command-card">
+      <header><span>Smoke benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --dry-run&#10;piagent-benchmark">Lấy lệnh</button></header>
+      <pre><code>piagent-benchmark --dry-run
+piagent-benchmark</code></pre>
+    </article>
+    <article class="command-card">
+      <header><span>Production benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --production --dry-run&#10;piagent-benchmark --production --surfaces piagent,codex-cli --model openai-codex/gpt-5.6-sol --thinking xhigh">Lấy lệnh</button></header>
+      <pre><code>piagent-benchmark --production --dry-run
+piagent-benchmark --production --surfaces piagent,codex-cli \
+  --model openai-codex/gpt-5.6-sol --thinking xhigh</code></pre>
+    </article>
+    <article class="command-card">
+      <header><span>Compare codex-cli</span><button class="clip-btn" data-clip="piagent-benchmark --surfaces piagent,codex-cli --model openai-codex/gpt-5.6-sol --thinking xhigh">Lấy lệnh</button></header>
+      <pre><code>piagent-benchmark --surfaces piagent,codex-cli \
+  --model openai-codex/gpt-5.6-sol --thinking xhigh</code></pre>
+    </article>
     <article class="command-card">
       <header><span>Trusted run</span><button class="clip-btn" data-clip="piagent-auto --full-access -p &quot;Run the trusted local benchmark suite.&quot;">Lấy lệnh</button></header>
       <pre><code>piagent-auto --read-only -p "Scout payment mapping. Do not edit source."

package/docs-site/scope.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/security.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/team.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/docs-site/workflows.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.10 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.12 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />

package/evals/fixtures/task-contract.invalid.json

@@ -1,4 +1,10 @@
 {
+  "schemaVersion": 2,
+  "taskRunId": "task-0001-20260731120000-a1b2c3d4e5",
+  "changeMode": "source-change",
+  "attempt": 4,
+  "maxAttempts": 3,
+  "previousAttempts": [],
   "summary": "Replace with one-sentence task outcome.",
   "riskLane": "normal",
   "expectedOutput": "Replace with exact artifact or behavior expected.",
@@ -16,6 +22,7 @@
   "contextManifest": [],
   "memoryCitations": [],
   "mcpCapabilities": [],
+  "verifyGroup": "source",
   "verifyCommands": [
     "Replace with verify command."
   ],
@@ -65,9 +72,16 @@
       "watchdog": "Use a strong model only for final risk review, security, release, or high-impact changes."
     }
   },
+  "baselineChangedFiles": [],
+  "baselineFileDigests": {},
+  "observedChangedFiles": [],
+  "finalWorkingTreeFiles": [],
+  "finalFileDigests": {},
   "changedFiles": [],
   "verifyEvidence": [],
   "trace": {
     "outcome": "pending"
-  }
+  },
+  "createdAt": "2026-07-31T12:00:00.000Z",
+  "updatedAt": "2026-07-31T12:00:00.000Z"
 }