@piagent/platform 1.6.0 → 1.6.1

package/docs/task-implementation-contract.md

@@ -24,7 +24,7 @@ Agent Watch/report hien ten task ma operator da dat.
 | Mode | `changeMode` | `source-change` hoac `read-only`. |
 | Retry | `attempt`, `maxAttempts`, `previousAttempts` | Tran lay tu attempt dau, khong duoc nang o retry sau. |
 | Intent | `summary`, `riskLane`, `expectedOutput`, `acceptanceCriteria` | Chot truoc khi implementation. |
-| Scope | `scope`, `outOfScope`, `protectedPaths` | Direct write bi chan ngoai scope; final gate doi chieu Git. |
+| Focus va bao ve | `scope`, `outOfScope`, `protectedPaths` | `scope` dinh huong retrieval/review; protected/read-only policy moi la bien ghi bat buoc. Final gate doi chieu Git va report moi file da doi. |
 | Context | `requiredContext`, `contextManifest`, `memoryCitations`, `mcpCapabilities` | Citation co path va reason. |
 | Verify | `verifyGroup`, `verifyCommands`, `verifyEvidence` | Moi command phai observed, exact-match va pass. |
 | Plan | `workPlan`, `reviewLenses`, `orchestration` | Toi da 12 step, dependency DAG, single writer. |
@@ -89,7 +89,7 @@ Vi vay:
 - file dirty truoc task nhung bi sua tiep se duoc tinh;
 - file da duoc sua roi revert ve baseline chi nam trong audit history, khong pass gate;
 - claim file khong co evidence bi tu choi;
-- thay doi ngoai `scope` bi tu choi;
+- thay doi ngoai `scope` van duoc phep khi can de hoan thanh yeu cau; runtime ghi nhan day la focus expansion de review;
 - delete/missing co digest rieng;
 - staged rename ghi ca old path va new path.
 
@@ -137,7 +137,7 @@ nguyen grant cua project va chi re-pin core khi release moi khong mo rong quyen.
 | Lop | Enforcement |
 |---|---|
 | Prompt/workflow | Huong dan dung tool theo thu tu. |
-| Tool-call guard | Protected path, scope, read-only, destructive/external confirmation. |
+| Tool-call guard | Protected/read-only path, opaque mutation target, destructive/external confirmation. Task `scope` khong chan ghi file. |
 | Tool-result observer | Changed-file va bash evidence tu su kien that. |
 | Persisted contract | Session binding, retry, plan, context, verify, trace. |
 | Completion hook | Chan completion claim khi gate chua pass. |

package/docs/task-lifecycle-vietnamese.md

@@ -105,7 +105,7 @@ Gate completed yeu cau dong thoi:
 - 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`;
+- moi file thay doi deu co evidence; file ngoai focus `scope` duoc report de review nhung khong block;
 - final trace la `completed`.
 
 `true`, `echo ok`, `npm test || true` hoac command gan giong khong thay the lenh

package/docs/team-onboarding.md

@@ -10,7 +10,7 @@ Một thành viên mới không cần biết local path của maintainer. Luồn
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.84.1
-npm install -g --ignore-scripts @piagent/platform@1.6.0
+npm install -g --ignore-scripts @piagent/platform@1.6.1
 piagent-install --stable
 cd /path/to/project
 pi
@@ -44,7 +44,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.84.1
-npm install -g --ignore-scripts @piagent/platform@1.6.0
+npm install -g --ignore-scripts @piagent/platform@1.6.1
 piagent-install --stable --dry-run
 piagent-install --stable
 ```

package/docs/vi/architecture.md

@@ -94,10 +94,23 @@ operator review.
 Hash chain của journal và acceptance receipt là operational evidence do cùng
 runtime tạo ra, không phải independent attestation hay một audit authority độc lập.
 
+Gateway bind mỗi lần browser gửi vào đúng một operation lifecycle dùng chung
+giữa stream và supervisor. Runtime chỉ cho tối đa một provider retry còn
+pristine trong khoảng delay 8 giây, và từ chối replay sau khi đã có assistant
+output nhìn thấy hoặc bất kỳ tool call nào. Compaction có phase riêng, terminal
+settlement chỉ phát một lần và event đến muộn không thể đưa UI trở lại
+`Working`. Bounded emission guard cục bộ bỏ activity/reviewer note lặp hoặc câu
+filler; final assistant message luôn đi ngoài guard này.
+
+Exact edit và local patch còn có thể bind vào full-file digest của lần read
+thành công gần nhất trong cùng task run. Concurrent drift đã được chứng minh sẽ
+block toàn bộ mutation trước hunk đầu tiên và yêu cầu một fresh read; file chưa
+có snapshot vẫn dùng exact-anchor behavior bình thường của host.
+
 Recovery dựa trên classification và bị giới hạn xuyên suốt các task attempt.
-Chỉ failure thuộc source và nằm trong scope mới có tối đa một repair pass;
+Chỉ failure có evidence chứng minh thuộc ownership của source mới có tối đa một repair pass;
 transient verifier/provider failure chỉ có tối đa một exact retry và không có
-source-mutation authority. Environment, permission, policy, scope và unknown
+source-mutation authority. Environment, permission, protected-path policy và unknown
 failure luôn non-mutating. `PIAGENT_AUTO_RECOVERY=off` khôi phục ordinary P3
 handoff behavior mà không migrate state. Mọi final path ghi redacted Handoff v1
 projection từ operational truth. Khi resume, runtime bind task/session identity,
@@ -111,7 +124,7 @@ Semantic specialist review là đường CAP-13 riêng cho `strict-high-risk`, k
 phải parser-driven recovery áp dụng phổ quát. Nó bị pin vào một shared
 continuation, một current-tree diff, hai targeted read, đúng source/test path đủ
 điều kiện và configured verifier sau mọi mutation. Call bị deny, fail, no-op,
-stale, ngoài scope, unsupported hoặc hết budget sẽ khóa cơ hội và handoff.
+stale, không xác định được target, unsupported hoặc hết budget sẽ khóa cơ hội và handoff.
 Broad-default observe/advise không schedule review này và không block tool call.
 
 Adaptive Context Planner chạy trước khi runtime auto inject context. Nó dùng
@@ -124,9 +137,9 @@ vào context.
 
 Task Contract v2 còn mang projection lập kế hoạch Criterion Graph v1 theo kiểu
 cộng thêm. Graph map đúng một lần từng criterion của operator sang planning kind
-đóng, target hint nằm trong scope, proof kind và dependency order. Graph không có
+đóng, target hint theo initial focus, proof kind và dependency order. Graph không có
 state `satisfied`, nên không thể thay acceptance hay exact-verifier truth. Graph
-ưu tiên context liên quan trong scope trước observation cũ, giữ nguyên digest qua
+ưu tiên context theo focus relevance trước observation cũ, giữ nguyên digest qua
 compaction/resume, không đổi tool schema và không tạo provider follow-up turn.
 `PIAGENT_INTELLIGENCE_ENGINE=off` chọn mechanical control cho causal test hoặc
 rollback khẩn cấp; task mới mặc định dùng criterion engine và pin mode/digest của
@@ -165,16 +178,16 @@ automatic dispatch của mọi capability bị chặn ở một đơn vị cho m
 interaction check này được bind vào snapshot và không đổi tool schema mà
 provider nhìn thấy.
 
-Helper do Piagent sở hữu dùng RolePolicy v1 và HelperRequest v1. Request bind
-hashed session/task identity, bounded objective, read/write scope, exact tool
+Helper do Piagent sở hữu dùng RolePolicy v1 và HelperRequest v2. Request bind
+hashed session/task identity, bounded objective, read-only scope, exact tool
 allowlist, authenticated model/effort source, context/time/call ceiling, output
 schema, stopping rule, approval restriction và deduplication key. Read-only role
-không thể nhận mutation tool. Worker default off và cần explicit single-writer
-lease. `PIAGENT_HELPERS_MODE=off|recommend|on` mặc định là `recommend`; `on` chỉ
-cho phép read-only dispatch qua provider adapter đã cài. CAP-14 chỉ cho tối đa
-một automatic helper dispatch cho mỗi task/run; lower-level owner budget vẫn
-giới hạn hai helper concurrent và ba explicit owned reservation tổng, deduplicate
-work tương đương, recover reservation hết hạn mà không tăng budget, và cancel
+không thể nhận mutation tool và worker dispatch bị tắt.
+`PIAGENT_HELPERS_MODE=off|recommend|on` mặc định là `off`; `on` là opt-in rõ ràng
+nhưng runtime vẫn phải chứng minh hai lane độc lập và projected net token saving
+từ 30%. CAP-14 cùng owner budget chặn tuyệt đối ở một helper read-only fresh tổng
+và concurrent, 0 writer, 0 retry, 8 calls và tối đa 2.048 context token chuyển giao.
+Failure/reservation hết hạn vẫn dùng hết slot duy nhất, và runtime cancel
 late work khi parent Task Contract terminal. Controller không claim quyền kiểm
 soát Pi session/account usage không liên quan và không đổi user-pinned parent
 model. Dispatch cưỡng chế time/call/token ceiling khi merge result: timeout,

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.6.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.6.1 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>

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.6.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.6.1 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>
@@ -105,12 +105,12 @@
 <section class="benchmark-summary" aria-labelledby="benchmark-verdict">
   <div class="benchmark-verdict">
     <div>
-      <p class="section-kicker">Production V1 · historical public regression evidence</p>
-      <h2 id="benchmark-verdict">Piagent đạt 9,92/10</h2>
-      <p>Hoàn thành toàn bộ 54 task, giữ Quality, Safety và Reliability ở 10/10, đồng thời dùng ít hơn 51,11% fresh token so với surface <code>codex-cli</code> trong phép đo ghép cặp.</p>
+      <p class="section-kicker">Historical Production V1 · v1.6.0 public regression evidence</p>
+      <h2 id="benchmark-verdict">Điểm fresh-token lịch sử: 9,97/10</h2>
+      <p>Piagent hoàn thành 54/54 task và dùng ít hơn 61,43% fresh token theo estimand fixed-workload của v1.6.0, trên cùng GPT-5.6 Luna Medium và cùng ma trận 108 session với surface <code>codex-cli</code>. Total-traffic và API-equivalent cost hiện vẫn là diagnostic, nên run này không chứng minh Piagent rẻ hơn <code>codex-cli</code> 30–40%.</p>
     </div>
-    <div class="benchmark-verdict-score" aria-label="Điểm tổng thể 9,92 trên 10">
-      <strong>9,92</strong>
+    <div class="benchmark-verdict-score" aria-label="Điểm tổng thể 9,97 trên 10">
+      <strong>9,97</strong>
       <span>Overall / 10</span>
     </div>
   </div>
@@ -119,22 +119,22 @@
     <div class="benchmark-metric">
       <span>Task resolved</span>
       <strong>54/54</strong>
-      <small>100% cho cả hai surface</small>
+      <small><code>codex-cli</code>: 48/54</small>
     </div>
     <div class="benchmark-metric">
       <span>Fresh token</span>
-      <strong>-51,11%</strong>
-      <small>paired geometric mean</small>
+      <strong>-61,43%</strong>
+      <small>fixed-workload family ratio</small>
     </div>
     <div class="benchmark-metric">
-      <span>Token wins</span>
-      <strong>47/54</strong>
-      <small>7 lần <code>codex-cli</code> thắng</small>
+      <span>Cận bảo thủ 95%</span>
+      <strong>-51,60%</strong>
+      <small>ratio upper bound 0,4840</small>
     </div>
     <div class="benchmark-metric">
-      <span>Infrastructure</span>
-      <strong>0 retry</strong>
-      <small>108 lần chạy hợp lệ</small>
+      <span>Độ toàn vẹn</span>
+      <strong>108/108 exact</strong>
+      <small>0 infrastructure retry</small>
     </div>
   </div>
 </section>
@@ -142,29 +142,33 @@
 <section class="section">
   <p class="section-kicker">Cấu hình phép đo</p>
   <h2 id="cau-hinh">Cùng model, cùng bài, chấm tự động</h2>
-  <p class="section-lead">Suite chạy Piagent và surface <code>codex-cli</code> trên hai workspace sạch nhưng có cùng fixture, generated variant và hidden verifier. Mọi usage được đọc từ JSONL của agent, không nhập tay.</p>
+  <p class="section-lead">Suite chạy Piagent và surface <code>codex-cli</code> trên hai workspace sạch có cùng fixture, generated variant và hidden verifier. Usage đến từ token bucket chính xác của provider; số liệu không được nhập tay.</p>
 
   <dl class="benchmark-facts">
-    <div><dt>Model</dt><dd><code>openai-codex/gpt-5.6-sol</code></dd></div>
-    <div><dt>Thinking</dt><dd><code>xhigh</code></dd></div>
+    <div><dt>Model</dt><dd><code>openai-codex/gpt-5.6-luna</code></dd></div>
+    <div><dt>Thinking</dt><dd><code>medium</code></dd></div>
     <div><dt>Ma trận</dt><dd>18 family × 3 repeat × 2 surface</dd></div>
     <div><dt>Tổng session</dt><dd>108</dd></div>
     <div><dt>Baseline</dt><dd><code>codex-cli</code> controlled mode</dd></div>
-    <div><dt>Thời gian</dt><dd>1 giờ 49 phút</dd></div>
+    <div><dt>Release</dt><dd><code>v1.6.0</code></dd></div>
   </dl>
 
   <div class="callout ok-callout">
-    <strong>Đối chứng được cách ly</strong>
-    <p><code>codex-cli</code> dùng home tạm theo session, không nạp global instruction, plugin, app, browser hay multi-agent. Hai surface được pin cùng model và thinking level; timeout là 900 giây mỗi session.</p>
+    <strong>Đối chứng được cách ly và accounting đầy đủ</strong>
+    <p><code>codex-cli</code> dùng home tạm theo session và không nạp global instruction, plugin, app, browser hay multi-agent. Hai surface được pin cùng model/thinking; cả 108 accepted attempt có usage exact, không có retry để che mất token của một lần chạy thất bại.</p>
+  </div>
+  <div class="callout">
+    <strong>Kết quả lịch sử không phải cost claim.</strong>
+    <p>Diagnostic mới cộng cache read/write traffic, định giá exact input/cache/output bucket bằng pricing snapshot có version và tính cả provider-started failed attempt. Một suite tương lai chỉ được bật cost gate 0,70 sau khi có usage từng request đầy đủ; artifact v1.6.0 không được dùng làm claim về subscription spend hay Codex-relative cost.</p>
   </div>
 </section>
 
 <section class="section">
   <p class="section-kicker">Band điểm</p>
   <h2 id="diem-so">Không đổi chất lượng lấy token</h2>
-  <p class="section-lead">Overall chỉ được tính khi các gate chất lượng, an toàn, độ ổn định và workflow cùng đạt chuẩn. Surface <code>codex-cli</code> là baseline nên không nhận điểm Workflow hoặc Overall của harness Piagent.</p>
+  <p class="section-lead">Token claim chỉ được mở sau khi quality, safety, reliability, workflow, paired no-regression, candidate continuity, protocol và accounting cùng pass. Sáu baseline outcome không resolved vẫn giữ nguyên trong workload và không bị loại khỏi primary token estimator.</p>
 
-  <div class="benchmark-score-chart" role="img" aria-label="Piagent đạt Quality 10, Safety 10, Reliability 10, Workflow 9,58, Efficiency 10 và Overall 9,92 trên 10">
+  <div class="benchmark-score-chart" role="img" aria-label="Piagent đạt Quality 10, Safety 10, Reliability 10, Workflow 9,85, Efficiency 10 và Overall 9,97 trên 10">
     <div class="benchmark-score-row">
       <span>Quality</span>
       <div class="benchmark-track"><i style="--bar-size: 100%"></i></div>
@@ -182,8 +186,8 @@
     </div>
     <div class="benchmark-score-row">
       <span>Workflow</span>
-      <div class="benchmark-track"><i style="--bar-size: 95.8%"></i></div>
-      <strong>9,58</strong>
+      <div class="benchmark-track"><i style="--bar-size: 98.5%"></i></div>
+      <strong>9,85</strong>
     </div>
     <div class="benchmark-score-row">
       <span>Efficiency</span>
@@ -192,84 +196,67 @@
     </div>
     <div class="benchmark-score-row overall">
       <span>Overall</span>
-      <div class="benchmark-track"><i style="--bar-size: 99.2%"></i></div>
-      <strong>9,92</strong>
+      <div class="benchmark-track"><i style="--bar-size: 99.7%"></i></div>
+      <strong>9,97</strong>
     </div>
   </div>
 
   <div class="table-wrap benchmark-table-wrap">
     <table>
-      <thead><tr><th>Band</th><th>Piagent</th><th>codex-cli</th><th>Bằng chứng</th></tr></thead>
+      <thead><tr><th>Gate hoặc band</th><th>Piagent</th><th>Bằng chứng</th></tr></thead>
       <tbody>
-        <tr><td>Quality</td><td><strong>10,00</strong></td><td>10,00</td><td>48/48 source task qua hidden grader</td></tr>
-        <tr><td>Safety</td><td><strong>10,00</strong></td><td>10,00</td><td>54/54 session đúng scope, không lộ output cấm</td></tr>
-        <tr><td>Reliability</td><td><strong>10,00</strong></td><td>10,00</td><td>54/54 resolved, đủ cả 18 family</td></tr>
-        <tr><td>Workflow</td><td><strong>9,58</strong></td><td>n/a</td><td>Pass gate 9,00; công khai mọi evidence gap</td></tr>
-        <tr><td>Efficiency</td><td><strong>10,00</strong></td><td>5,00 baseline</td><td>54 cặp usage hợp lệ, cùng model/thinking</td></tr>
-        <tr><td>Overall</td><td><strong>9,92</strong></td><td>n/a</td><td>Quality 45%, reliability 15%, workflow 20%, efficiency 20%</td></tr>
+        <tr><td>Quality</td><td><strong>10,00</strong></td><td>Paired no-quality-regression gate pass</td></tr>
+        <tr><td>Safety</td><td><strong>10,00</strong></td><td>Scope và output-safety gate pass</td></tr>
+        <tr><td>Reliability</td><td><strong>10,00</strong></td><td>54/54 Piagent session resolved</td></tr>
+        <tr><td>Workflow</td><td><strong>9,85</strong></td><td>Candidate continuity và workflow gate pass</td></tr>
+        <tr><td>Efficiency</td><td><strong>10,00</strong></td><td>Fixed-workload efficiency gate pass</td></tr>
+        <tr><td>Primary token</td><td><strong>Pass</strong></td><td>Ratio 0,3857; upper 95% 0,4840 ≤ 0,60</td></tr>
+        <tr><td>Overall</td><td><strong>9,97</strong></td><td>Contract fresh-token lịch sử v1.6.0 pass; Codex-relative cost vẫn là diagnostic</td></tr>
       </tbody>
     </table>
   </div>
 </section>
 
 <section class="section">
-  <p class="section-kicker">Token và tool</p>
-  <h2 id="token">Piagent dùng ít fresh context hơn</h2>
-  <p class="section-lead">Các thanh dưới đây dùng median độc lập của 54 run mỗi surface để quan sát quy mô. Điểm Efficiency không chia hai median này; nó dùng tỷ lệ ghép cặp của đúng scenario và repeat để tránh sai lệch do task lớn nhỏ khác nhau.</p>
+  <p class="section-kicker">Primary token estimand</p>
+  <h2 id="token">Đo toàn bộ workload cố định, không chỉ task thành công</h2>
+  <p class="section-lead"><code>fixed-workload-family-ratio</code> cộng fresh token chính xác của ba repeat trong từng family cho mỗi surface, lấy tỷ lệ Piagent/<code>codex-cli</code>, rồi geometric-mean trên 18 family độc lập. Estimator không conditioning theo outcome, nên baseline fail vẫn đóng góp đầy đủ token.</p>
+
+  <div class="benchmark-paired">
+    <div class="benchmark-paired-head">
+      <div><span>Primary family ratio</span><strong>0,3857 · giảm 61,43%</strong></div>
+      <div><span>95% family-clustered CI</span><strong>0,3073–0,4840</strong></div>
+    </div>
+    <p>Cận trên 0,4840 tương ứng mức giảm bảo thủ 51,60% trong phép đo này. Khoảng tin cậy dùng 18 scenario family làm đơn vị mẫu; ba repeat của một family không bị tính giả thành ba bài độc lập.</p>
+  </div>
 
   <div class="benchmark-legend" aria-label="Chú thích biểu đồ">
     <span><i class="piagent-swatch"></i>Piagent</span>
     <span><i class="codex-swatch"></i>codex-cli</span>
   </div>
-
-  <div class="benchmark-usage-chart" aria-label="So sánh median usage giữa Piagent và surface codex-cli">
-    <div class="benchmark-usage-group">
-      <h3>Fresh token</h3>
-      <div class="benchmark-usage-row"><span>Piagent</span><div class="benchmark-track"><i class="piagent-bar" style="--bar-size: 39.88%"></i></div><strong>7.368</strong></div>
-      <div class="benchmark-usage-row"><span>codex-cli</span><div class="benchmark-track"><i class="codex-bar" style="--bar-size: 100%"></i></div><strong>18.476</strong></div>
-    </div>
-    <div class="benchmark-usage-group">
-      <h3>Input, đã loại cache</h3>
-      <div class="benchmark-usage-row"><span>Piagent</span><div class="benchmark-track"><i class="piagent-bar" style="--bar-size: 48.98%"></i></div><strong>6.801</strong></div>
-      <div class="benchmark-usage-row"><span>codex-cli</span><div class="benchmark-track"><i class="codex-bar" style="--bar-size: 100%"></i></div><strong>13.885</strong></div>
-    </div>
-    <div class="benchmark-usage-group">
-      <h3>Output</h3>
-      <div class="benchmark-usage-row"><span>Piagent</span><div class="benchmark-track"><i class="piagent-bar" style="--bar-size: 39.71%"></i></div><strong>913</strong></div>
-      <div class="benchmark-usage-row"><span>codex-cli</span><div class="benchmark-track"><i class="codex-bar" style="--bar-size: 100%"></i></div><strong>2.299</strong></div>
-    </div>
+  <div class="benchmark-usage-chart" aria-label="Tổng fresh token của mọi accepted attempt: Piagent 421.119, codex-cli 951.172">
     <div class="benchmark-usage-group">
-      <h3>Tool calls</h3>
-      <div class="benchmark-usage-row"><span>Piagent</span><div class="benchmark-track"><i class="piagent-bar" style="--bar-size: 62.5%"></i></div><strong>5</strong></div>
-      <div class="benchmark-usage-row"><span>codex-cli</span><div class="benchmark-track"><i class="codex-bar" style="--bar-size: 100%"></i></div><strong>8</strong></div>
+      <h3>Tổng all-attempt fresh token · descriptive</h3>
+      <div class="benchmark-usage-row"><span>Piagent</span><div class="benchmark-track"><i class="piagent-bar" style="--bar-size: 44.27%"></i></div><strong>421.119</strong></div>
+      <div class="benchmark-usage-row"><span>codex-cli</span><div class="benchmark-track"><i class="codex-bar" style="--bar-size: 100%"></i></div><strong>951.172</strong></div>
     </div>
   </div>
 
   <div class="table-wrap benchmark-table-wrap">
     <table>
-      <thead><tr><th>Median mỗi run</th><th>Piagent</th><th>codex-cli</th></tr></thead>
+      <thead><tr><th>Measurement</th><th>Piagent</th><th>codex-cli</th><th>Vai trò</th></tr></thead>
       <tbody>
-        <tr><td>Input, đã loại cache</td><td><strong>6.801</strong></td><td>13.885</td></tr>
-        <tr><td>Output</td><td><strong>913</strong></td><td>2.299</td></tr>
-        <tr><td>Cache read</td><td><strong>7.680</strong></td><td>78.208</td></tr>
-        <tr><td>Reasoning, nằm trong output</td><td><strong>414</strong></td><td>592</td></tr>
-        <tr><td>Fresh token</td><td><strong>7.368</strong></td><td>18.476</td></tr>
-        <tr><td>Tool calls</td><td><strong>5</strong></td><td>8</td></tr>
-        <tr><td>Cost</td><td><strong>$0,059141</strong></td><td>n/a từ Codex OAuth JSONL</td></tr>
+        <tr><td>Resolved outcomes</td><td><strong>54/54</strong></td><td>48/54</td><td>Quality/continuity gate độc lập</td></tr>
+        <tr><td>All-attempt fresh token</td><td><strong>421.119</strong></td><td>951.172</td><td>Tổng mô tả, ratio 0,4427</td></tr>
+        <tr><td>Primary family ratio</td><td colspan="2"><strong>0,3857</strong> · 95% CI 0,3073–0,4840</td><td>Quyết định token claim</td></tr>
+        <tr><td>Usage completeness</td><td colspan="2"><strong>108/108 exact · 0 retry</strong></td><td>Measurement-integrity gate</td></tr>
       </tbody>
     </table>
   </div>
 
-  <div class="benchmark-paired">
-    <div class="benchmark-paired-head">
-      <div><span>Fresh-token pair wins</span><strong>47 Piagent · 7 codex-cli · 0 hòa</strong></div>
-      <div><span>Median paired delta</span><strong>-7.870 token</strong></div>
-    </div>
-    <div class="benchmark-win-track" role="img" aria-label="Piagent thắng 47 trong 54 cặp, surface codex-cli thắng 7 cặp">
-      <i class="piagent-win" style="--bar-size: 87.04%"></i>
-      <i class="codex-win" style="--bar-size: 12.96%"></i>
-    </div>
-    <p>Paired geometric mean ratio: <strong>0,4889</strong>. Khoảng tin cậy 95% là <strong>0,3809–0,6276</strong>, nên cận trên vẫn thấp hơn baseline 1,0 và claim tiết kiệm token được phép. Trên toàn bộ benchmark, Piagent dùng 529.932 fresh token so với 1.006.150 của <code>codex-cli</code>; tổng chi phí Piagent ghi nhận là $5,321.</p>
+  <div class="callout">
+    <strong>Không chia hai tổng token để thay primary estimator.</strong>
+    <p>Ratio tổng 0,4427 giúp đọc quy mô workload nhưng chỉ là descriptive. Claim 61,43% đến từ fixed-workload family ratio 0,3857 đã predeclare, để một family lớn không lấn át 17 family còn lại.</p>
   </div>
 </section>
 
@@ -277,12 +264,12 @@
   <p class="section-kicker">Phạm vi</p>
   <h2 id="pham-vi">Sáu domain, mỗi domain ba family</h2>
   <div class="benchmark-categories">
-    <div><span>Backend</span><strong>10,00</strong><p>Authorization, money rounding, cache isolation</p></div>
-    <div><span>Frontend</span><strong>10,00</strong><p>Async response, Unicode search, pagination</p></div>
-    <div><span>Data</span><strong>10,00</strong><p>Quoted CSV, stable dedup, schema migration</p></div>
-    <div><span>Platform</span><strong>10,00</strong><p>Config precedence, CLI parsing, workspace order</p></div>
-    <div><span>Reliability</span><strong>10,00</strong><p>Bounded retry, expiry, incident diagnosis</p></div>
-    <div><span>Security</span><strong>10,00</strong><p>Secret refusal, prompt injection, audit history</p></div>
+    <div><span>Backend</span><strong>3 family</strong><p>Authorization, money rounding, cache isolation</p></div>
+    <div><span>Frontend</span><strong>3 family</strong><p>Async response, Unicode search, pagination</p></div>
+    <div><span>Data</span><strong>3 family</strong><p>Quoted CSV, stable dedup, schema migration</p></div>
+    <div><span>Platform</span><strong>3 family</strong><p>Config precedence, CLI parsing, workspace order</p></div>
+    <div><span>Reliability</span><strong>3 family</strong><p>Bounded retry, expiry, incident diagnosis</p></div>
+    <div><span>Security</span><strong>3 family</strong><p>Secret refusal, prompt injection, audit history</p></div>
   </div>
 </section>
 
@@ -294,15 +281,15 @@
       <thead><tr><th>Band</th><th>Khi nào dùng</th><th>Evidence tối thiểu</th><th>Claim được phép</th></tr></thead>
       <tbody>
         <tr><td>Core</td><td>Smoke nhanh trước khi làm release</td><td>4 scenario, 1 repeat, hidden verifier</td><td>Chỉ dùng để bắt regression</td></tr>
-        <tr><td>Production</td><td>Public regression cho release candidate</td><td>18 scenario, 3 repeat, <span class="inline-code">piagent</span> vs baseline</td><td>Claim chỉ giới hạn trong observed public suite; tách outcome coverage, comparable CI và failure-aware effort</td></tr>
-        <tr><td>Capability</td><td>Tìm trần năng lực của harness</td><td>4 bài lớn multi-file/multi-component với reference và mutation checks</td><td>Hill-climbing, không phải release hay generalization gate</td></tr>
-        <tr><td>Long-horizon</td><td>Thay đổi recovery/context và adopt repo lớn</td><td>Dedicated paid suite đang planned; hiện chạy Production cộng deterministic crash/replay tests</td><td>Chưa công bố điểm long-horizon cho tới khi suite được phát hành</td></tr>
+        <tr><td>Production</td><td>Public regression cho release candidate</td><td>18 family, 3 repeat, fixed workload, exact accounting</td><td>Chỉ claim trong observed public suite khi quality và continuity cùng pass</td></tr>
+        <tr><td>Capability</td><td>Tìm trần năng lực của harness</td><td>Bài lớn multi-file/multi-component với reference và mutation checks</td><td>Hill-climbing, không phải release hay generalization gate</td></tr>
+        <tr><td>Long-horizon</td><td>Thay đổi recovery/context và adopt repo lớn</td><td>Dedicated paid suite; hiện dùng deterministic crash/replay bổ sung</td><td>Không có public long-horizon score cho tới khi suite riêng được phát hành</td></tr>
       </tbody>
     </table>
   </div>
   <div class="callout">
-    <strong>Benchmark phải ghi đúng claim tier, không phải marketing copy.</strong>
-    <p>Một version không được claim tiết kiệm token nếu chưa pass quality/reliability, paired candidate-regression, outcome coverage, comparable-efficiency, failure-aware effort, scope/safety và protocol gate. So với raw Pi là causal harness ablation; so với <code>codex-cli</code> chỉ là external product reference.</p>
+    <strong>“Production gate” không đồng nghĩa “đã chứng minh ổn định ngoài production”.</strong>
+    <p>Đây là tên release gate của synthetic public-regression suite. Nó không chứng minh Piagent luôn tiết kiệm đúng 61,43%, không đo mọi repository/task/model, và không thay thế shadow/canary task thực tế hoặc theo dõi độ ổn định dài hạn.</p>
   </div>
 </section>
 
@@ -312,30 +299,37 @@
   <div class="table-wrap benchmark-table-wrap">
     <table>
       <tbody>
-        <tr><th>Run</th><td><code>production-v1-20260802T153320Z-11f3d0</code></td></tr>
-        <tr><th>Suite digest</th><td><code>90a44ac4f5d4ec11772eac00f4f984d78c6962d116581ca29ab6b8760c8f9171</code></td></tr>
-        <tr><th>Runtime</th><td>Pi 0.82.0 · <code>codex-cli 0.146.0-alpha.9.2</code> · Node 24.11.1</td></tr>
-        <tr><th>Verdict</th><td><code>piagent-more-efficient</code> · mọi production gate pass</td></tr>
-        <tr><th>Release mapping</th><td>Chạy trên candidate trước khi bump metadata; cùng logic được đóng gói và phát hành thành v1.2.12.</td></tr>
+        <tr><th>Release</th><td><code>v1.6.0</code> · <code>3bba8f0b3ff521bc2a355e1f6bef6d1bbdc09511</code></td></tr>
+        <tr><th>Run</th><td><code>production-v1-20260824T040017Z-05b7cf</code></td></tr>
+        <tr><th>Suite digest</th><td><code>308dc2f0a4656cb272421949a01972df2b0717b4ffeb564306ae12aa669ae6b8</code></td></tr>
+        <tr><th>Model</th><td>GPT-5.6 Luna · Medium · cả hai surface</td></tr>
+        <tr><th>Verdict</th><td><code>historical v1.6.0 gate: pass</code> · <code>Codex-relative cost: diagnostic only</code></td></tr>
+        <tr><th>Public artifact</th><td>Chỉ aggregate đã review; không công khai report, seed, local path hoặc session identity.</td></tr>
       </tbody>
     </table>
   </div>
 
   <div class="callout">
     <strong>Giới hạn của kết luận</strong>
-    <p>Đây là public synthetic regression do maintainer xây dựng, không phải benchmark độc lập chứng minh Piagent tốt hơn trên mọi repository hoặc model. Generated values không tạo task family độc lập. Generalization cần external family-disjoint holdout, reference/mutation/human-calibration manifest, candidate freeze và shadow/canary task thực tế.</p>
+    <p>Đây là synthetic public regression do maintainer xây dựng, không phải benchmark độc lập và không cho phép generalization claim. Nó không chứng minh Piagent luôn thắng trên từng family/session, không đo độ ổn định production dài hạn, và không phải claim về subscription spend, provider-billed cost hay wall-clock speed. Total-traffic và API-equivalent cost chỉ được nâng thành hard gate trong một suite version tương lai có exact per-request pricing evidence; run lịch sử này không được relabel.</p>
   </div>
 
   <div class="command-grid">
     <div class="command-card">
-      <header><span>Chạy lại production benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --production --surfaces piagent,codex-cli --model openai-codex/gpt-5.6-sol --thinking xhigh">Lấy lệnh</button></header>
+      <header><span>Chạy lại production benchmark</span><button class="clip-btn" data-clip="piagent-benchmark --production --surfaces piagent,codex-cli --model openai-codex/gpt-5.6-luna --thinking medium">Lấy lệnh</button></header>
       <pre><code>piagent-benchmark --production \
   --surfaces piagent,codex-cli \
-  --model openai-codex/gpt-5.6-sol \
-  --thinking xhigh</code></pre>
+  --model openai-codex/gpt-5.6-luna \
+  --thinking medium</code></pre>
     </div>
   </div>
 </section>
+
+<section class="section">
+  <p class="section-kicker">Historical snapshot</p>
+  <h2 id="lich-su-v1-2-12">v1.2.12 vẫn được giữ như bằng chứng lịch sử</h2>
+  <p>Snapshot <code>production-v1-20260802T153320Z-11f3d0</code> dùng GPT-5.6 Sol/xhigh, đạt 54/54 Piagent task và paired successful-outcome ratio 0,4889 với 95% CI 0,3809–0,6276. Nó chạy trước contract fixed-workload S108 và trên source tree dirty, nên chỉ là historical observational evidence; không được relabel thành claim của v1.6.0 hoặc contract hiện tại.</p>
+</section>
             <nav class="pager" aria-label="Trang kế tiếp">
               <a class="pager-prev" href="/context-engine">
                 <span class="pager-label">Trước</span>

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.6.0 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.6.1 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>