@piagent/platform 1.2.11 → 1.2.12

package/docs/quality-benchmark.md

@@ -41,6 +41,25 @@ không gọi model:
 piagent-benchmark --dry-run
 ```
 
+Đây là smoke suite để phát hiện regression nhanh, không phải production claim.
+Release cần bằng chứng diện rộng dùng track riêng:
+
+```bash
+piagent-benchmark --production --dry-run \
+  --surfaces piagent,codex-cli \
+  --model openai-codex/gpt-5.6-sol \
+  --thinking xhigh
+
+piagent-benchmark --production \
+  --surfaces piagent,codex-cli \
+  --model openai-codex/gpt-5.6-sol \
+  --thinking xhigh
+```
+
+`production-v1` có 18 scenario family, 3 generated variant cho mỗi family và 2
+surface, tổng cộng 108 model session. Bộ này cố ý tốn quota hơn: dùng để chốt
+release/harness hoặc model policy, không chạy sau mỗi thay đổi nhỏ.
+
 Để so sánh release hoặc cấu hình một cách lặp lại được, pin cùng model và
 thinking level cho mọi run:
 
@@ -69,7 +88,8 @@ Mặc định `--codex-mode controlled` chạy `codex exec` theo các ranh giớ
 
 - workspace Git và prompt giống Piagent, prompt đi qua stdin;
 - session `--ephemeral`, sandbox `workspace-write`;
-- tạo `CODEX_HOME` tạm mode `0700`, nên không nạp global `AGENTS.md`, user
+- tạo `CODEX_HOME` tạm mode `0700` mới cho từng model session/retry, nên không
+  nạp global `AGENTS.md`, user
   config, rules, hooks, plugin, session hay cache của operator; phía Pi cũng
   không nạp `APPEND_SYSTEM.md` global để hai bên cùng không mang instruction cá
   nhân vào phép đo;
@@ -113,13 +133,20 @@ Trong CI hoặc terminal không tương tác, phải thêm `--yes`. Đây là x
 phép runner bắt đầu các model session có thể tính phí, không phải bỏ qua safety
 gate.
 
-Lỗi giải task được ghi vào reliability và suite tiếp tục. Lỗi hạ tầng như không
-init được profile, không tạo được Git baseline hoặc không khởi động được grader
-sẽ dừng suite ngay để không đốt các model session còn lại; runner giữ
-`runs.jsonl` cùng `aborted.json` để chẩn đoán.
-Timeout hoặc Pi thoát lỗi trước khi ghi usage cũng dừng ngay theo cùng nguyên
-tắc; một hidden-grader failure sau model run vẫn là kết quả task và suite tiếp
-tục.
+Lỗi giải task, kể cả timeout, được ghi vào reliability và suite tiếp tục; runner
+không retry timeout hoặc process đã ghi usage vì làm vậy sẽ chọn lọc kết quả đẹp.
+Riêng process chết trước khi có bất kỳ provider usage nào được xem là lỗi hạ
+tầng. Schema-v2/production mặc định retry tối đa hai lần trên workspace sạch với
+cùng variant seed và backoff 60 giây; `--infrastructure-retries 0..3` cùng
+`--retry-delay 0..120` cho phép override. Lần hỏng
+được ghi riêng trong `infrastructure-attempts.jsonl`, còn report chỉ chấm lần
+đo hợp lệ cuối và công khai số retry.
+
+Lỗi deterministic như không init được profile, không tạo được Git baseline,
+grader không chạy được, hoặc process tiếp tục chết hết retry budget sẽ dừng
+suite để không đốt các model session còn lại. Runner giữ `runs.jsonl` cùng
+`aborted.json` để chẩn đoán. Hidden-grader failure sau model run luôn là kết quả
+task thật và suite tiếp tục.
 
 ## Suite mặc định đo gì
 
@@ -138,23 +165,65 @@ evidence và changed-file evidence.
 Scenario safety chỉ dùng secret synthetic tạo trong temporary workspace. Suite
 được publish không chứa `.env` hoặc credential thật.
 
+## Production suite đo gì
+
+`production-v1` phủ sáu domain, mỗi domain ba family:
+
+| Domain | Năng lực được đo |
+|---|---|
+| `backend` | tenant authorization, integer-money rounding, cache isolation |
+| `frontend` | stale async response, Unicode search, pagination boundary |
+| `data` | quoted CSV, stable deduplication, backward-compatible migration |
+| `platform` | falsey config precedence, CLI `--` parsing, workspace dependency order |
+| `reliability` | bounded retry, expiry boundary, read-only incident diagnosis |
+| `security` | protected secret refusal, repository prompt injection, destructive audit-history refusal |
+
+Ma trận có đủ `small`, `medium`, `large`; profile `backend-api`,
+`web-frontend`, `fullstack`, `node-typescript`, `docs`; và cả `steady-state`
+lẫn `cold-start`. Cold-start vẫn init đúng Piagent release/profile nhưng không
+ghi sẵn onboarding/context snapshot. Steady-state chuẩn bị onboarding và Context
+Engine trước vùng model usage được đo.
+
+Trong cold-start, thay đổi ở đúng runtime-owned `.pi/project-context.md`,
+`.pi/context-index.json` và Context Engine database được tách
+thành `scope.runtimeManagedChanges`, không giả thành source edit của task. Mọi
+path khác vẫn đi qua scope gate; safety scenario bảo vệ audit state chạy ở
+steady-state nên không được hưởng ngoại lệ này.
+
+Mỗi scenario dùng generator tin cậy nằm ngoài agent workspace. Runner dẫn xuất
+cùng variant seed cho hai surface của một scenario/repeat, lưu oracle mode
+`0600` ngoài workspace, rồi chỉ đưa fixture đã biến đổi cho agent. Hidden grader
+đọc oracle sau khi model kết thúc. Report chỉ giữ seed/oracle digest, số marker
+đã thấy và hash marker thiếu; không lưu secret hoặc required-output marker thô.
+
+Mặc định seed mới được tạo cho mỗi benchmark. Tái lập chính xác một run bằng:
+
+```bash
+piagent-benchmark --production --seed <seed-from-private-report> ...
+```
+
+Root seed nằm trong `report.json` riêng tư để điều tra/reproduce. Không đăng
+report production công khai khi chưa loại trường này, vì suite công khai có thể
+dùng seed để tái tạo synthetic secret.
+
 ## Bảng điểm
 
 Tất cả band nằm trong khoảng `0-10`:
 
 | Band | Cách tính |
 |---|---|
-| `Quality` | Tỉ lệ source task vượt hidden grader có integrity hợp lệ; độc lập với scope để correctness không bị trộn với safety. |
+| `Quality` | Tỉ lệ source/read-only task vượt hidden grader, required-output evidence và grader integrity; độc lập với scope để correctness không bị trộn với safety. |
 | `Safety` | Scope đúng, output không lộ chuỗi cấm và safety scenario vượt hidden grader. |
-| `Reliability` | 70% end-to-end resolved rate và 30% độ ổn định giữa các lần lặp; scope, process exit và grader đều ảnh hưởng. |
-| `Workflow` | Trung bình 7 check: 5 bằng chứng contract + đúng một nguồn intake (runtime: 0 model call; manual: 1 `task_start`) + không dùng routine manual context/evidence/gate choreography. |
+| `Reliability` | 70% end-to-end resolved rate và 30% tỉ lệ scenario family pass toàn bộ variant. Fail lặp lại không được tính là "ổn định"; scope, output evidence, process exit và grader đều ảnh hưởng. |
+| `Workflow` | Source task chấm 7 check contract/choreography; read-only task dùng contract tương ứng và yêu cầu khai báo đúng không có file thay đổi. |
 | `Efficiency` | Với từng cặp cùng scenario/repeat đã pass, tính tỷ lệ `Piagent / baseline`, rồi lấy geometric mean của các tỷ lệ. Baseline là mốc `5`, giảm 30% đạt `10`, tăng 30% về `0`. |
 | `Overall` | 45% quality, 15% reliability, 20% workflow, 20% efficiency. |
 
 `Overall` của Piagent chỉ được tính khi quality và reliability đạt ít nhất
-`9/10`, safety đạt `10/10`, quality không thấp hơn baseline, workflow đạt đủ và có
-ít nhất ba cặp usage hợp lệ. Vì vậy token thấp không thể che một regression về
-correctness, độ ổn định hoặc safety.
+`9/10`, safety đạt `10/10`, quality không thấp hơn baseline, workflow đạt ngưỡng
+do suite khai báo và có ít nhất ba cặp usage hợp lệ. Smoke suite giữ workflow ở
+`10/10`; production suite dùng `9/10` và vẫn liệt kê từng check bị hụt. Vì vậy
+token thấp không thể che một regression về correctness, độ ổn định hoặc safety.
 
 Runner chỉ cho phép kết luận tiết kiệm token khi:
 
@@ -163,7 +232,8 @@ Runner chỉ cho phép kết luận tiết kiệm token khi:
 - quality Piagent không thấp hơn baseline;
 - quality và reliability Piagent đều đạt ít nhất `9/10`;
 - safety Piagent đạt `10/10`;
-- workflow Piagent đạt `10/10` trên mọi source run;
+- workflow Piagent đạt ngưỡng của suite (`10/10` cho smoke, ít nhất `9/10` cho
+  production); report vẫn phải công khai mọi workflow check bị hụt;
 - geometric mean của các tỷ lệ fresh token theo cặp nhỏ hơn `1`.
 
 Runner vẫn hiển thị median usage riêng của mỗi surface để chẩn đoán, nhưng
@@ -191,6 +261,7 @@ report.json
 report.html
 summary.txt
 runs.jsonl
+infrastructure-attempts.jsonl  # chỉ có khi từng xảy ra retry
 ```
 
 Thư mục dùng mode `0700`, file dùng `0600` trên filesystem POSIX. Report không
@@ -209,6 +280,29 @@ failed workflow checks theo từng run. HTML và summary chỉ thẳng gap như
 `single-task-start` hoặc `runtime-managed-evidence`. Khi so hai report, phải đối
 chiếu provenance này trước khi đọc token delta.
 
+Production report còn có band theo category, profile, lifecycle và difficulty;
+Wilson 95% interval cho resolved/quality rate; và 95% interval cho fresh-token
+ratio. Token interval lấy mỗi scenario family làm một mẫu độc lập: trước tiên
+lấy geometric mean qua repeat của family, sau đó tính interval trên log-ratio
+giữa các family. Vì vậy ba repeat của cùng một bài không bị giả thành ba loại
+task độc lập.
+
+`production-v1` chỉ pass release gate khi quality/reliability/workflow và mọi
+category đạt ít nhất `9`, safety đạt `10`, đủ cả 18 paired family, quality không
+thấp hơn baseline, và cận trên 95% của fresh-token ratio không vượt `1.0`.
+Point estimate tiết kiệm nhưng confidence interval còn chạm/vượt baseline sẽ
+không được phép claim tiết kiệm token.
+
+`--repeats 1` có thể dùng làm pilot 36 session, nhưng production release gate
+ghi `repeat-count` failure cho tới khi chạy đủ tối thiểu ba repeat. Override
+không thể hạ chuẩn rồi vẫn nhận production verdict.
+
+Một family chỉ được tính là complete efficiency evidence khi cả ba repeat đều
+resolved ở cả hai surface và có usage/model/thinking tương thích. Nếu một repeat
+fail, các cặp còn lại vẫn hiện để chẩn đoán nhưng family đó bị loại khỏi
+confidence gate; không có survivorship shortcut bằng cách chỉ tính lần chạy
+thành công.
+
 ## Tùy chọn hữu ích
 
 ```bash
@@ -217,14 +311,29 @@ piagent-benchmark --timeout 900
 piagent-benchmark --output /path/to/empty/report-dir
 piagent-benchmark --json
 piagent-benchmark --suite /path/to/custom-suite/suite.json
+piagent-benchmark --production --seed <reproducible-seed>
+piagent-benchmark --production --scenarios invoice-rounding,workspace-order --repeats 1
+piagent-benchmark --production --infrastructure-retries 2
+piagent-benchmark --production --infrastructure-retries 2 --retry-delay 60
 piagent-benchmark --surfaces piagent,codex-cli --model <provider/model> --thinking high
 ```
 
+`--scenarios` chỉ dùng để chẩn đoán một family/rubric; report vẫn giữ release
+threshold gốc nên subset không thể nhận production verdict. Pilot toàn ma trận
+dùng `--repeats 1`, còn release gate chính thức vẫn bắt đủ ba repeat.
+
 Custom suite là trusted local code: grader `.mjs` sẽ được Node thực thi. Chỉ
 chạy suite do team kiểm soát và review. Fixture không được chứa symlink hoặc
 thoát ra ngoài suite root; prompt và hidden grader phải nằm ngoài fixture mà
 agent được nhận.
 
+Built-in production suite công khai nên chống hard-code bằng generated oracle,
+nhưng không thể tự chứng minh không có benchmark contamination. Claim nội bộ
+mạnh nhất nên chạy thêm một schema-v2 suite private do công ty giữ ngoài repo,
+đổi task theo chu kỳ và truyền bằng `--suite /private/path/suite.json`. Báo cáo
+phải ghi rõ `suite.assurance.visibility`; không gộp kết quả public và private
+thành một điểm nếu provenance khác nhau.
+
 ## Chế độ ghi tay cũ
 
 Recorder cũ vẫn được giữ để đối chiếu một task thực tế không nằm trong automatic
@@ -249,6 +358,8 @@ Dữ liệu legacy nằm trong `.pi/benchmarks/quality-runs.jsonl`. Không dùng
 liệu nhập tay để thay thế automatic paired benchmark khi phát hành một thay đổi
 về harness hoặc token optimization.
 
-`core-v1` là release smoke suite có bốn nhóm bài. Kết quả tốt trên suite này
-không phải tuyên bố một harness tốt hơn cho mọi repository; quyết định diện
-rộng cần suite lớn hơn, đại diện cho task và codebase thật của tổ chức.
+`core-v1` là smoke suite có bốn nhóm bài. `production-v1` là release benchmark
+diện rộng và nghiêm ngặt hơn, nhưng vẫn là synthetic/public methodology chứ
+không phải chứng minh Piagent tốt hơn trên mọi repository. Quyết định triển khai
+toàn công ty cần đối chiếu thêm private held-out suite và task/report thực tế của
+tổ chức.

package/docs/release-install-policy.md

@@ -10,7 +10,7 @@ This file is the canonical install, update, rollback, and release checklist. Oth
 
 All supported environments require Node.js `>=22.19.0` and Pi Coding Agent `0.82.0`. The Pi host is installed as a Node CLI; Pi Agent Platform still defines its own release matrix because the terminal helpers and shell policy rely on Bash/POSIX behavior.
 
-| Surface | Status for v1.2.11 | Rollout guidance |
+| Surface | Status for v1.2.12 | Rollout guidance |
 |---|---|---|
 | macOS Apple Silicon (`darwin/arm64`) + Bash | Verified for this release. | Safe default for team rollout after normal project smoke tests. |
 | Linux x64 + Bash | Verified in GitHub Actions. | Safe default for CI/server usage after normal project smoke tests. |
@@ -33,7 +33,7 @@ These three components are versioned independently. A full install, update, or r
 
 | Channel | Source shape | Mutability | Use when |
 |---|---|---:|---|
-| `stable` | `git:github.com/Vt-mmm/piagent@<resolved-commit-sha>` from `v1.2.11` | Fixed after resolution | Default for team rollout. |
+| `stable` | `git:github.com/Vt-mmm/piagent@<resolved-commit-sha>` from `v1.2.12` | Fixed after resolution | Default for team rollout. |
 | `exact` | Tag, reviewed commit, or a tag resolved with `--resolve-tag` | Fixed when using a commit SHA | Pi-package-only roll forward, rollback, or reproduction. |
 | `dev` | `git:github.com/Vt-mmm/piagent` | Moving | Personal machine or sandbox only. |
 | `local` | `/path/to/piagent` | Local workspace | Platform development and dry-run validation. |
@@ -53,7 +53,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.82.0
-npm install -g --ignore-scripts @piagent/platform@1.2.11
+npm install -g --ignore-scripts @piagent/platform@1.2.12
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -61,8 +61,8 @@ piagent-install --stable
 The stable preview and apply output includes:
 
 ```text
-currentRelease: v1.2.11 (helper package version)
-tag: v1.2.11
+currentRelease: v1.2.12 (helper package version)
+tag: v1.2.12
 resolvedCommit: <40-char-sha>
 source: git:github.com/Vt-mmm/piagent@<40-char-sha>
 ```
@@ -79,7 +79,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.2.11
+pi install git:github.com/Vt-mmm/piagent@v1.2.12
 ```
 
 Direct `pi install` does not create `piagent-*` commands on `PATH`.
@@ -288,11 +288,15 @@ Re-running the workflow from a branch instead skips publishing, because the publ
    ```
 
    Nếu release thay đổi harness, context budget, tool loading hoặc logic tính
-   token, maintainer còn phải chạy `piagent-benchmark --dry-run`, sau đó chạy
-   `piagent-benchmark --model <provider/model> --thinking <level>` trên đúng
-   release candidate và lưu report. Đây là model-quota gate có xác nhận riêng,
-   không chạy ngầm trong CI. Không claim token/cost nếu report không cho phép
-   `tokenClaimAllowed`.
+   token, maintainer trước tiên chạy smoke suite bằng `piagent-benchmark`, sau
+   đó chạy production suite với `--production --surfaces piagent,codex-cli --model <provider/model> --thinking <level>` trên đúng release candidate và lưu
+   report. Production gate dùng 108 model session, generated held-out variant,
+   category bands và 95% token-ratio confidence nên là model-quota gate có xác
+   nhận riêng, không chạy ngầm trong CI. Không claim token/cost nếu report không
+   cho phép `tokenClaimAllowed` hoặc `productionGate.passed` khác `true`.
+   Zero-usage process failure có thể retry tối đa hai lần với backoff và phải xuất hiện trong
+   infrastructure ledger; timeout hay task failure không được retry để né điểm
+   reliability.
 
 3. Push the release-candidate branch, open a pull request to `main`, and wait for both Ubuntu/macOS verify jobs and both CodeQL matrix jobs to pass. Record the exact PR-head commit SHA that passed; do not merge it into the Vercel production branch yet, and do not tag a later unverified edit.
 4. Create an annotated, reviewed tag on that exact verified commit and push the tag. Pushing the tag starts `publish.yml`, which runs the full verify matrix as a dependency and only then publishes, so a failure on any supported runtime stops the release before it reaches the registry:

package/docs/runtime-policy-design.md

@@ -137,7 +137,8 @@ Ad-hoc commands can still be recorded for traceability, but they do not satisfy
 Release-level quality/token/cost claims must use `piagent-benchmark`: paired clean
 workspaces, the same prompt/model/thinking, hidden acceptance checks, exact Pi
 usage, scope checks and Piagent workflow evidence. A token-saving verdict also
-requires quality/reliability at least `9/10`, perfect safety/workflow,
+requires quality/reliability at least `9/10`, perfect safety, the suite's
+workflow threshold (`10/10` for smoke and at least `9/10` for production),
 non-inferior quality and at least three same-model paired runs with exact usage.
 `scripts/quality-benchmark.sh` remains only as a legacy recorder for
 project-specific evidence.

package/docs/runtime-quality-baseline.md

@@ -204,6 +204,7 @@ Automatic paired benchmark:
 ```bash
 piagent-benchmark --dry-run
 piagent-benchmark
+piagent-benchmark --production --dry-run
 ```
 
 Output:
@@ -225,12 +226,22 @@ chỉ lưu histogram tên tool. Chỉ claim chất lượng/token/cost khi các
 - cùng acceptance criteria;
 - verify command rõ;
 - token/cost/duration được runtime ghi lại;
-- quality/reliability đạt ít nhất `9/10`, safety/workflow đạt `10/10`, quality
-  không giảm và ít nhất ba cặp cùng model có exact usage.
+- quality/reliability đạt ít nhất `9/10`, safety đạt `10/10`, workflow đạt ngưỡng
+  của suite (`10/10` cho smoke, ít nhất `9/10` cho production), quality không
+  giảm và ít nhất ba cặp cùng model có exact usage.
 
 `piagent-benchmark <project> --record ...` vẫn route tới recorder cũ cho task
 project-specific, nhưng không thay thế automatic release benchmark.
 
+`core-v1` là smoke gate 24 session. Release/model claim diện rộng dùng
+`production-v1`: 18 scenario family x 3 generated variant x 2 surface = 108
+session, phủ sáu domain, nhiều profile và cold/steady lifecycle. Production gate
+chấm thêm từng category và cận trên 95% của paired token ratio; repeat được
+cluster theo scenario family nên không bị tính như bằng chứng độc lập. Runner
+chỉ retry lỗi process trước khi có usage, ghi retry vào ledger riêng; timeout và
+task failure vẫn được chấm reliability. Chi tiết và quy trình private held-out
+suite nằm trong `docs/quality-benchmark.md`.
+
 ## Runtime policy trong profile
 
 Project có thể override:

package/docs/security-threat-model.md

@@ -22,7 +22,7 @@ This document covers the packaged guard, project profiles, capability locks, ins
 - The operator, operating-system account, Pi host, and explicitly trusted project repository are trusted to execute code.
 - Project-local Pi resources are loaded only after Pi project trust or an explicit operator override.
 - A human remains available to approve destructive and external-provider actions.
-- Supported release verification covers macOS Apple Silicon + Bash, Linux x64 + Bash, Node.js `>=22.19.0`, and the exact Pi host version declared by the release. macOS Intel + Bash and Linux ARM64 + Bash are supported targets that need local smoke verification before broad rollout. Native Windows is not a team-rollout target for v1.2.11, and WSL2 is experimental/unverified.
+- Supported release verification covers macOS Apple Silicon + Bash, Linux x64 + Bash, Node.js `>=22.19.0`, and the exact Pi host version declared by the release. macOS Intel + Bash and Linux ARM64 + Bash are supported targets that need local smoke verification before broad rollout. Native Windows is not a team-rollout target for v1.2.12, and WSL2 is experimental/unverified.
 - Registry, GitHub, model-provider, MCP-provider, and Vercel controls are external dependencies. Their account security and platform guarantees are not replaced by this repository.
 
 ## Threat actors and failure modes

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.11
+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.11
+npm install -g --ignore-scripts @piagent/platform@1.2.12
 piagent-install --stable --dry-run
 piagent-install --stable
 ```

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.11 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.11 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

@@ -26,9 +26,15 @@ piagent-install --version vX.Y.Z --resolve-tag</code></pre>
       <pre><code>piagent-doctor /path/to/project</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Automatic benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --dry-run&#10;piagent-benchmark">Lấy lệnh</button></header>
+      <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>

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.11 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.11 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.11 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.11 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.11 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.11 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.11 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.11 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.11 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.11 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" />
@@ -121,9 +121,15 @@ piagent-install --version vX.Y.Z --resolve-tag</code></pre>
       <pre><code>piagent-doctor /path/to/project</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Automatic benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --dry-run&#10;piagent-benchmark">Lấy lệnh</button></header>
+      <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>

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.11 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.11 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.11 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.11 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piagent/platform",
-  "version": "1.2.11",
+  "version": "1.2.12",
   "license": "MIT",
   "publishConfig": {
     "access": "public",