@piagent/platform 1.49.0 → 1.50.0

package/docs-site/releases.json

@@ -1,4 +1,101 @@
 [
+  {
+    "version": "1.50.0",
+    "date": "2026-11-01",
+    "status": "stable",
+    "title": {
+      "en": "A push is judged repository by repository and reviewed first",
+      "vi": "Push được xét theo từng repo và review trước"
+    },
+    "summary": {
+      "en": "From feedback on a real three-repository task: the company Harness knows what passed where, says it before a push, and reviews the code before it leaves.",
+      "vi": "Từ góp ý trên một task ba repo thật: Harness công ty biết phần nào đã pass ở đâu, ghi rõ trước khi push và review code trước khi code rời máy."
+    },
+    "requires": null,
+    "items": [
+      {
+        "kind": "improved",
+        "en": "A required review now runs before a push. A finding holds that push until it is fixed or rejected, so it no longer costs an extra release.",
+        "vi": "Review bắt buộc giờ chạy trước push. Ý kiến review giữ push lại tới khi được sửa hoặc bác bỏ, nên không còn tốn thêm một bản phát hành."
+      },
+      {
+        "kind": "improved",
+        "en": "Before a push the question says which repositories passed in full, which only in part, how many files changed and how long the last full run took.",
+        "vi": "Câu hỏi trước push ghi rõ repo nào đã pass toàn bộ, repo nào mới pass một phần, đổi bao nhiêu file và lần chạy toàn bộ gần nhất mất bao lâu."
+      },
+      {
+        "kind": "fixed",
+        "en": "A whole-suite pass counts per repository: a later small run no longer erases it, and a pass in one repository no longer clears a push of another.",
+        "vi": "Kết quả chạy toàn bộ tính theo từng repo: lần chạy nhỏ sau không xóa nó, và pass ở repo này không còn mở khóa push của repo khác."
+      },
+      {
+        "kind": "fixed",
+        "en": "An approval card nobody answered now says it expired instead of reading as a refusal. A push card waits up to 30 minutes instead of 5.",
+        "vi": "Thẻ duyệt không ai trả lời giờ báo là hết hạn, không còn giống bị từ chối. Thẻ push chờ tối đa 30 phút thay vì 5 phút."
+      },
+      {
+        "kind": "fixed",
+        "en": "Findings of a later review in the same turn reach the agent, and the status names any objection left without a decision by its id.",
+        "vi": "Ý kiến của lần review sau trong cùng lượt nay đến được agent, và dòng trạng thái ghi mã của ý kiến chưa có quyết định."
+      },
+      {
+        "kind": "fixed",
+        "en": "Test scope reads go test -p as parallelism, not a package, and a shell function or loop that picks its files as a part of the suite.",
+        "vi": "Phạm vi test hiểu go test -p là số package chạy song song, không phải tên package, và hiểu hàm shell hoặc vòng lặp tự chọn file là chạy một phần."
+      },
+      {
+        "kind": "improved",
+        "en": "The checks the Harness names are those of the repositories that changed. Bypass no longer sends a quick suite another way, and tests may write .env files in their own temporary folder.",
+        "vi": "Harness chỉ nêu check của repo có thay đổi. Bypass không còn bắt đi đường vòng với bộ test chạy nhanh, và test được ghi file .env trong thư mục tạm của chính nó."
+      }
+    ]
+  },
+  {
+    "version": "1.49.1",
+    "date": "2026-11-01",
+    "status": "stable",
+    "title": {
+      "en": "A running turn says what it waits for",
+      "vi": "Lượt chạy nói rõ đang chờ gì"
+    },
+    "summary": {
+      "en": "The status and Activity show what the main agent and each subagent are doing, answers before a review are marked, and Fast follows each model.",
+      "vi": "Trạng thái và Activity cho thấy main agent và từng subagent đang làm gì, câu trả lời trước review được đánh dấu, và Fast áp dụng theo từng model."
+    },
+    "requires": null,
+    "items": [
+      {
+        "kind": "fixed",
+        "en": "A long end-of-turn review no longer looks stuck: the status names the reviewer and how long it has run, with the step it is on.",
+        "vi": "Review cuối lượt chạy lâu không còn trông như bị treo: dòng trạng thái nói reviewer đang chạy, đã bao lâu và đang làm bước nào."
+      },
+      {
+        "kind": "improved",
+        "en": "Activity lists every call by agent: the main agent and each subagent, with tool, target and time, live and after the turn.",
+        "vi": "Activity liệt kê mọi lời gọi theo từng agent: main agent và mỗi subagent, gồm tool, đối tượng và giờ gọi, cả khi đang chạy lẫn sau khi xong."
+      },
+      {
+        "kind": "improved",
+        "en": "An answer written before the review is marked a draft and folded once a later one exists; the last one says it is the final result.",
+        "vi": "Câu trả lời viết trước review được đánh dấu bản nháp và thu gọn khi có câu mới hơn; câu cuối ghi rõ là kết quả cuối."
+      },
+      {
+        "kind": "improved",
+        "en": "You can write while a turn runs: Enter sends the message when it ends. A turn that fails or is stopped keeps the message for you.",
+        "vi": "Soạn được tin trong lúc lượt đang chạy: Enter sẽ gửi khi lượt xong. Lượt lỗi hoặc bị dừng thì tin vẫn được giữ để bạn quyết định."
+      },
+      {
+        "kind": "improved",
+        "en": "Fast follows each model, subagents too: a Claude main agent with Codex subagents runs them fast. Tokens run fast count 2.5 times toward the quota.",
+        "vi": "Fast áp dụng theo từng model, cả subagent: main agent Claude với subagent Codex thì subagent chạy Fast. Token chạy Fast tính vào quota gấp 2,5 lần."
+      },
+      {
+        "kind": "fixed",
+        "en": "A model that refuses Fast goes back to standard speed alone; the rest of the conversation keeps Fast.",
+        "vi": "Model từ chối Fast chỉ riêng nó về tốc độ thường; phần còn lại của cuộc trò chuyện vẫn giữ Fast."
+      }
+    ]
+  },
   {
     "version": "1.49.0",
     "date": "2026-10-31",

package/docs-site/runtime.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.49.0" title="v1.49.0 docs · VI"><span class="dot"></span>v1.49.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.50.0" title="v1.50.0 docs · VI"><span class="dot"></span>v1.50.0</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/scope.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.49.0" title="v1.49.0 docs · VI"><span class="dot"></span>v1.49.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.50.0" title="v1.50.0 docs · VI"><span class="dot"></span>v1.50.0</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/security.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.49.0" title="v1.49.0 docs · VI"><span class="dot"></span>v1.49.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.50.0" title="v1.50.0 docs · VI"><span class="dot"></span>v1.50.0</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/team.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.49.0" title="v1.49.0 docs · VI"><span class="dot"></span>v1.49.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.50.0" title="v1.50.0 docs · VI"><span class="dot"></span>v1.50.0</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/update.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.49.0" title="v1.49.0 docs · VI"><span class="dot"></span>v1.49.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.50.0" title="v1.50.0 docs · VI"><span class="dot"></span>v1.50.0</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>
@@ -153,9 +153,9 @@
   <h2 id="pin-cho-team">Pin một bản cho cả team</h2>
   <p>Khi rollout cho team, cài đúng bản Pi host và đúng bản platform, rồi chạy installer ở chế độ stable. Bước <code>--dry-run</code> in ra những gì sẽ đổi.</p>
   <div class="command-card">
-    <header><span>Cài pin theo bản</span><button class="clip-btn" data-clip="npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0&#10;npm install -g --ignore-scripts @piagent/platform@1.49.0&#10;piagent-install --stable --dry-run&#10;piagent-install --stable">Lấy lệnh</button></header>
+    <header><span>Cài pin theo bản</span><button class="clip-btn" data-clip="npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0&#10;npm install -g --ignore-scripts @piagent/platform@1.50.0&#10;piagent-install --stable --dry-run&#10;piagent-install --stable">Lấy lệnh</button></header>
     <pre><code>npm install -g --ignore-scripts @earendil-works/pi-coding-agent@1.3.0
-npm install -g --ignore-scripts @piagent/platform@1.49.0
+npm install -g --ignore-scripts @piagent/platform@1.50.0
 piagent-install --stable --dry-run
 piagent-install --stable</code></pre>
   </div>

package/docs-site/whats-new.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.49.0" title="v1.49.0 docs · VI"><span class="dot"></span>v1.49.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.50.0" title="v1.50.0 docs · VI"><span class="dot"></span>v1.50.0</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new" aria-current="page">Changelog</a>
@@ -108,7 +108,38 @@
 <div class="release-filter" role="toolbar" aria-label="Lọc theo loại thay đổi"><button type="button" data-filter-kind="all" aria-pressed="true">Tất cả</button><button type="button" data-filter-kind="new" aria-pressed="false">Mới</button><button type="button" data-filter-kind="improved" aria-pressed="false">Cải thiện</button><button type="button" data-filter-kind="fixed" aria-pressed="false">Sửa lỗi</button><button type="button" data-filter-kind="security" aria-pressed="false">Bảo mật</button></div>
 <section class="section releases" data-releases>
 <h2 id="latest" class="sr-only">Mới nhất</h2>
-<article class="release latest" id="v1-49-0" data-release>
+<article class="release latest" id="v1-50-0" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-50-0">v1.50.0</a><time class="release-date" datetime="2026-11-01">01/11/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-50-0-title">Push được xét theo từng repo và review trước</h3>
+    <p>Từ góp ý trên một task ba repo thật: Harness công ty biết phần nào đã pass ở đâu, ghi rõ trước khi push và review code trước khi code rời máy.</p>
+    <ul class="release-items">
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Review bắt buộc giờ chạy trước push. Ý kiến review giữ push lại tới khi được sửa hoặc bác bỏ, nên không còn tốn thêm một bản phát hành.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Câu hỏi trước push ghi rõ repo nào đã pass toàn bộ, repo nào mới pass một phần, đổi bao nhiêu file và lần chạy toàn bộ gần nhất mất bao lâu.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Harness chỉ nêu check của repo có thay đổi. Bypass không còn bắt đi đường vòng với bộ test chạy nhanh, và test được ghi file .env trong thư mục tạm của chính nó.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Kết quả chạy toàn bộ tính theo từng repo: lần chạy nhỏ sau không xóa nó, và pass ở repo này không còn mở khóa push của repo khác.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Thẻ duyệt không ai trả lời giờ báo là hết hạn, không còn giống bị từ chối. Thẻ push chờ tối đa 30 phút thay vì 5 phút.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Ý kiến của lần review sau trong cùng lượt nay đến được agent, và dòng trạng thái ghi mã của ý kiến chưa có quyết định.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Phạm vi test hiểu go test -p là số package chạy song song, không phải tên package, và hiểu hàm shell hoặc vòng lặp tự chọn file là chạy một phần.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-49-1" data-release>
+  <div class="release-meta"><a class="release-version" href="#v1-49-1">v1.49.1</a><time class="release-date" datetime="2026-11-01">01/11/2026</time></div>
+  <div class="release-body">
+    <h3 data-toc-skip id="v1-49-1-title">Lượt chạy nói rõ đang chờ gì</h3>
+    <p>Trạng thái và Activity cho thấy main agent và từng subagent đang làm gì, câu trả lời trước review được đánh dấu, và Fast áp dụng theo từng model.</p>
+    <ul class="release-items">
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Activity liệt kê mọi lời gọi theo từng agent: main agent và mỗi subagent, gồm tool, đối tượng và giờ gọi, cả khi đang chạy lẫn sau khi xong.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Câu trả lời viết trước review được đánh dấu bản nháp và thu gọn khi có câu mới hơn; câu cuối ghi rõ là kết quả cuối.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Soạn được tin trong lúc lượt đang chạy: Enter sẽ gửi khi lượt xong. Lượt lỗi hoặc bị dừng thì tin vẫn được giữ để bạn quyết định.</span></li>
+      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Fast áp dụng theo từng model, cả subagent: main agent Claude với subagent Codex thì subagent chạy Fast. Token chạy Fast tính vào quota gấp 2,5 lần.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Review cuối lượt chạy lâu không còn trông như bị treo: dòng trạng thái nói reviewer đang chạy, đã bao lâu và đang làm bước nào.</span></li>
+      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Model từ chối Fast chỉ riêng nó về tốc độ thường; phần còn lại của cuộc trò chuyện vẫn giữ Fast.</span></li>
+    </ul>
+  </div>
+</article>
+<article class="release" id="v1-49-0" data-release>
   <div class="release-meta"><a class="release-version" href="#v1-49-0">v1.49.0</a><time class="release-date" datetime="2026-10-31">31/10/2026</time></div>
   <div class="release-body">
     <h3 data-toc-skip id="v1-49-0-title">Bạn chọn chạy bao nhiêu test</h3>
@@ -395,36 +426,34 @@
     </ul>
   </div>
 </article>
-<article class="release" id="v1-43-6" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-43-6">v1.43.6</a><time class="release-date" datetime="2026-10-27">27/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-43-6-title">Xem thay đổi của agent ngay khi đang chạy</h3>
-    <p>Thay đổi và Review cập nhật theo lượt đang chạy, thấy sai thì dừng sớm được, và lượt còn chạy không còn trông như đã xong.</p>
-    <ul class="release-items">
-      <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Panel Workspace liệt kê file thay đổi và mở được Review khi agent đang chạy, tự làm mới vài giây một lần; Review cũng cập nhật theo.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Câu trả lời bị harness trả lại để chạy check được ghi là giữa chừng, và lượt vẫn hiện đang chạy kèm nút Dừng cho tới khi check xong.</span></li>
-    </ul>
-  </div>
-</article>
-<article class="release" id="v1-43-5" data-release>
-  <div class="release-meta"><a class="release-version" href="#v1-43-5">v1.43.5</a><time class="release-date" datetime="2026-10-27">27/10/2026</time></div>
-  <div class="release-body">
-    <h3 data-toc-skip id="v1-43-5-title">Xem trước ảnh và đính kèm file văn phòng</h3>
-    <p>Ảnh đã gửi hiện thành hình, bảng tính và slide đính kèm trực tiếp được, task chụp nhiều screenshot không còn dừng vì giới hạn dung lượng request của Studio.</p>
-    <ul class="release-items">
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Ảnh đính kèm và ảnh đã gửi hiện thành hình trong hội thoại, bấm để xem cỡ lớn; chip trong khung soạn có ảnh thu nhỏ.</span></li>
-      <li data-kind="new"><span class="kind kind-new">Mới</span><span>Đính kèm được .xlsx, .xlsm, .pptx, .odt, .ods, .odp, .rtf: bảng tính thành các dòng cách nhau bằng tab, slide theo thứ tự kèm ghi chú, không cần cài converter.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Task công ty chụp nhiều screenshot không còn lỗi request_too_large: mỗi request chỉ gửi lại ảnh mới nhất trong 2 MiB, ảnh cũ hơn thành một dòng ghi chú.</span></li>
-      <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Câu trả lời đang stream của lượt có dùng tool xuống đoạn theo từng message của model, không còn dính các câu thành một khối.</span></li>
-    </ul>
-  </div>
-</article>
 </section>
 <section class="section archive">
   <h2 id="archive">Các bản trước</h2>
   <p class="section-lead">Bản cũ hơn, gom theo tháng. Mở một tháng để xem từng thay đổi.</p>
   <details class="release-archive">
-    <summary><span>Tháng 10/2026</span><span class="archive-count">69</span></summary>
+    <summary><span>Tháng 10/2026</span><span class="archive-count">71</span></summary>
+    <div class="archive-row" id="v1-43-6">
+      <div class="archive-head"><a class="release-version" href="#v1-43-6">v1.43.6</a> <span class="release-date">27/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Xem thay đổi của agent ngay khi đang chạy</strong> — Thay đổi và Review cập nhật theo lượt đang chạy, thấy sai thì dừng sớm được, và lượt còn chạy không còn trông như đã xong.</p>
+        <ul class="release-items">
+        <li data-kind="improved"><span class="kind kind-improved">Cải thiện</span><span>Panel Workspace liệt kê file thay đổi và mở được Review khi agent đang chạy, tự làm mới vài giây một lần; Review cũng cập nhật theo.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Câu trả lời bị harness trả lại để chạy check được ghi là giữa chừng, và lượt vẫn hiện đang chạy kèm nút Dừng cho tới khi check xong.</span></li>
+        </ul>
+      </div>
+    </div>
+    <div class="archive-row" id="v1-43-5">
+      <div class="archive-head"><a class="release-version" href="#v1-43-5">v1.43.5</a> <span class="release-date">27/10/2026</span></div>
+      <div class="archive-body">
+        <p><strong>Xem trước ảnh và đính kèm file văn phòng</strong> — Ảnh đã gửi hiện thành hình, bảng tính và slide đính kèm trực tiếp được, task chụp nhiều screenshot không còn dừng vì giới hạn dung lượng request của Studio.</p>
+        <ul class="release-items">
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Ảnh đính kèm và ảnh đã gửi hiện thành hình trong hội thoại, bấm để xem cỡ lớn; chip trong khung soạn có ảnh thu nhỏ.</span></li>
+        <li data-kind="new"><span class="kind kind-new">Mới</span><span>Đính kèm được .xlsx, .xlsm, .pptx, .odt, .ods, .odp, .rtf: bảng tính thành các dòng cách nhau bằng tab, slide theo thứ tự kèm ghi chú, không cần cài converter.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Task công ty chụp nhiều screenshot không còn lỗi request_too_large: mỗi request chỉ gửi lại ảnh mới nhất trong 2 MiB, ảnh cũ hơn thành một dòng ghi chú.</span></li>
+        <li data-kind="fixed"><span class="kind kind-fixed">Sửa lỗi</span><span>Câu trả lời đang stream của lượt có dùng tool xuống đoạn theo từng message của model, không còn dính các câu thành một khối.</span></li>
+        </ul>
+      </div>
+    </div>
     <div class="archive-row" id="v1-43-4">
       <div class="archive-head"><a class="release-version" href="#v1-43-4">v1.43.4</a> <span class="release-date">26/10/2026</span></div>
       <div class="archive-body">

package/docs-site/windows.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.49.0" title="v1.49.0 docs · VI"><span class="dot"></span>v1.49.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.50.0" title="v1.50.0 docs · VI"><span class="dot"></span>v1.50.0</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/docs-site/workflows.html

@@ -37,7 +37,7 @@
         <span class="brand-mark"><img src="/assets/piagent-logo.svg" alt="" width="28" height="28" /></span>
         <span class="brand-name"><b>Piagent</b> <span>Platform</span></span>
       </a>
-      <a class="version-badge" href="/whats-new" data-docs-version="v1.49.0" title="v1.49.0 docs · VI"><span class="dot"></span>v1.49.0</a>
+      <a class="version-badge" href="/whats-new" data-docs-version="v1.50.0" title="v1.50.0 docs · VI"><span class="dot"></span>v1.50.0</a>
       <nav class="top-nav" aria-label="Tài liệu">
         <a href="/quickstart">Tài liệu</a>
         <a href="/whats-new">Changelog</a>

package/evals/private-holdout-v1/public-exposure.v2.json

@@ -256,8 +256,8 @@
     },
     {
       "path": "tests",
-      "fileCount": 647,
-      "sha256": "0ec8e3ca46f9a7ef8b44de7f1a31330f63a12e388205e4419530a8bed9cb82be"
+      "fileCount": 648,
+      "sha256": "35ef07c0ab53282fccd92472562e92fa1e505305c4a47f7c527391eecf1cafec"
     }
   ],
   "custodianComparisonRules": {

package/package.json

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

package/packages/piagent-core/managed/approval-refusal.mjs

@@ -0,0 +1,9 @@
+// Why an approval did not allow the action, in words the agent can act on: a card
+// nobody answered in time is not a refusal, and asking again is then the right move.
+export function approvalRefusal(decision) {
+  const receipt = decision?.receipt;
+  if (receipt?.state === 'expired') return Error('managed-operation-expired: the approval card ran out of time with no answer. Nobody refused it and no policy blocked it; the command did not run. Tell the member it is waiting for them, or send the same command again when they are back.');
+  if (receipt?.state === 'cancelled') return Error('managed-operation-cancelled: the approval was cancelled because the runtime restarted or stopped the task; nobody refused it and the command did not run.');
+  if (receipt?.decision === 'deny') return Error('managed-operation-denied: the member refused this exact command on the approval card; it did not run. Do not send it again unless they say so.');
+  return Error('managed-operation-denied: the command was not approved and did not run.');
+}

package/packages/piagent-core/managed/check-evidence.mjs

@@ -0,0 +1,134 @@
+import path from 'node:path';
+import { readPatchDigest } from './patch-snapshot.mjs';
+import { itemText, undecided } from './ledger.mjs';
+import { changeLane, lanePolicy, patchStats } from './risk-lanes.mjs';
+
+// What passed on which code, repository by repository: a folder can hold several,
+// a later small run must not erase a whole-suite pass, and a pass in one repository
+// says nothing about a push of another. Also what a push needs first: its review.
+
+const FAST_SUITE_MS = 60_000, MAX_PARTS = 20, PUSH_REVIEWS = 2;
+const repositoryNames = self => Object.keys(self.repositoryBases ?? {});
+const plain = word => word.replace(/^["']|["']$/g, '');
+
+// The repositories a command goes to, from its `cd` and `git -C`. `known` is false
+// when one is a variable: a loop or a function decides it, not the text.
+export function commandRepositories(self, command) {
+  const names = repositoryNames(self);
+  if (!names.length) return { repositories: ['.'], known: true };
+  const found = new Set(); let dir = self.cwd, known = true;
+  const visit = (word, stay) => {
+    const target = plain(word);
+    if (target.includes('$')) { known = false; return; }
+    const next = path.resolve(dir, target), first = path.relative(self.cwd, next).split(path.sep)[0];
+    if (names.includes(first)) found.add(first);
+    if (!stay) dir = next;
+  };
+  for (const match of String(command ?? '').matchAll(/(?:^|[\s;&|(])(cd|git\s+-C)\s+("[^"]*"|'[^']*'|[^\s;&|)]+)/g)) visit(match[2], match[1] !== 'cd');
+  return { repositories: [...found], known };
+}
+const changedRepositories = self => {
+  const names = repositoryNames(self);
+  return [...new Set([...(self.ownPaths ?? [])].map(file => String(file).split('/')[0]))].filter(name => names.includes(name));
+};
+// What a push sends: the repositories it names, else the ones this conversation changed.
+export function pushRepositories(self, command) {
+  const { repositories, known } = commandRepositories(self, command);
+  return known && repositories.length ? repositories : changedRepositories(self);
+}
+// The code of one repository: this conversation's files in it, compared with where it started.
+async function repositoryDigest(self, repository) {
+  if (repository === '.') return self.digest();
+  const scope = new Set([...(self.ownPaths ?? [])].filter(file => String(file).startsWith(`${repository}/`)));
+  try { return await (self.scopedDigest ?? (paths => readPatchDigest(self.boundary, paths, self.base, self.repositoryBases)))(scope); } catch { return null; }
+}
+// Reading a digest starts a sandboxed worker: one question reads each once.
+export function digestsOnce(self) {
+  const known = new Map();
+  return repository => { if (!known.has(repository)) known.set(repository, repositoryDigest(self, repository)); return known.get(repository); };
+}
+const entryOf = (run, repository) => { const passes = run.passes ??= new Map(); if (!passes.has(repository)) passes.set(repository, { suite: null, parts: [] }); return passes.get(repository); };
+
+// One test command ended. `part` names its test step, for how long that step takes.
+export async function recordCheck(run, self, command, scope, ok, part) {
+  if (!self || !scope) return;
+  const started = run.checkStarts?.get(command), took = started ? Date.now() - started : null;
+  run.checkStarts?.delete(command);
+  for (const repository of commandRepositories(self, command).repositories) {
+    const digest = await repositoryDigest(self, repository), entry = entryOf(run, repository);
+    if (scope === 'suite') {
+      entry.suite = ok ? { digest, command } : null;
+      if (ok) run.fullFor?.delete(repository);
+      if (ok && took !== null) (self.checkTimes ??= new Map()).set(`${repository}\u0000${part}`, took);
+    } else if (ok) entry.parts = [...entry.parts, { digest, command }].slice(-MAX_PARTS);
+  }
+}
+export function markCheckStart(run, command) { (run.checkStarts ??= new Map()).set(command, Date.now()); }
+
+// A whole suite this conversation has seen pass quickly is not worth a detour.
+export function knownFast(self, command, part) {
+  const times = self.checkTimes, { repositories } = commandRepositories(self, command);
+  return !!times && repositories.length > 0 && repositories.every(repository => times.get(`${repository}\u0000${part}`) < FAST_SUITE_MS);
+}
+
+// The repositories whose whole suite has not passed on their current code.
+export async function missingSuites(digestOf, run, repositories) {
+  const missing = [];
+  for (const repository of repositories) {
+    const digest = await digestOf(repository), pass = run.passes?.get(repository)?.suite;
+    if (!(pass && digest !== null && pass.digest === digest)) missing.push(repository);
+  }
+  return missing;
+}
+const minutes = ms => Math.max(1, Math.round(ms / 60_000));
+// The member decides from this: what ran, what did not, what changed, how long the rest takes.
+export async function pushQuestion(self, digestOf, run, repositories, missing) {
+  const name = repository => repository === '.' ? 'repo này' : repository;
+  const lines = [`Sắp push${repositories.length && repositories[0] !== '.' ? ` ${repositories.join(', ')}` : ' code'} nhưng toàn bộ test chưa pass trên code này.`];
+  const passed = repositories.filter(repository => !missing.includes(repository));
+  if (passed.length) lines.push(`Đã pass toàn bộ: ${passed.map(name).join(', ')}.`);
+  const partly = [], none = [];
+  for (const repository of missing) {
+    const digest = await digestOf(repository), count = (run.passes?.get(repository)?.parts ?? []).filter(p => digest !== null && p.digest === digest).length;
+    if (count) partly.push(`${name(repository)} (${count} lệnh)`); else none.push(name(repository));
+  }
+  if (partly.length) lines.push(`Mới pass một phần: ${partly.join(', ')}.`);
+  if (none.length) lines.push(`Chưa có test nào pass trên code hiện tại: ${none.join(', ')}.`);
+  const files = self.ownPaths?.size ?? 0;
+  if (files) lines.push(`Phiên này đổi ${files} file.`);
+  const took = [...(self.checkTimes ?? new Map())].filter(([key]) => missing.includes(key.split('\u0000')[0])).map(([, ms]) => ms);
+  if (took.length) lines.push(`Lần chạy toàn bộ gần nhất mất khoảng ${minutes(Math.max(...took))} phút.`);
+  return lines.join('\n');
+}
+
+// The checks worth naming: those of the repositories this conversation changed,
+// not of every repository that happens to sit in the folder.
+export function relevantChecks(self, commands) {
+  const changed = new Set([...(self.ownPaths ?? [])].map(file => String(file).split('/')[0]));
+  if (!changed.size) return commands;
+  const kept = commands.filter(command => { const dir = String(command).match(/^cd '([^']+)'/)?.[1]; return !dir || changed.has(dir.split('/')[0]); });
+  return kept.length ? kept : commands;
+}
+
+// Before a push under a required review: a finding is cheap now and costs a release
+// after. The patch the turn's end would review is the same, so it is reviewed once.
+export async function reviewBeforePush(self, digestOf, run, signal) {
+  if (!self.delegate || !self.patchDigest || run.reviewSettled) return;
+  const code = await digestOf('.');
+  if (run.startDigest === null || code === null || code === run.startDigest) return;
+  let policy = run.policy;
+  if (policy.lanes) { let stats = null; try { stats = patchStats(await self.patchSnapshot?.()); } catch { /* unreadable: standard */ } policy = lanePolicy(policy, changeLane(stats, run)); }
+  if (policy.review !== 'require') return;
+  let patch = null; try { patch = await self.patchDigest(); } catch { return; }
+  const fresh = !!self.review && !self.review.stale && self.review.patchDigest === patch;
+  if (!fresh) {
+    if ((run.pushReviews ?? 0) >= PUSH_REVIEWS) return;
+    run.pushReviews = (run.pushReviews ?? 0) + 1;
+    self.session?.sessionManager?.appendCustomEntry?.('agent-watch-review-start', {});
+    // A review that cannot run does not hold the push: the turn's status says so.
+    try { await self.delegate({ role: 'review', task: "Review the current patch against the member's request. The main agent is about to push it: report what must change before it leaves this machine." }, signal, { harness: true }); }
+    catch (error) { if (signal?.aborted) throw error; return; }
+  }
+  const pending = undecided(run).filter(item => item.source === 'review');
+  if (pending.length) throw Error(`managed-review-before-push: this command did not run. The review of the code you are pushing has ${pending.length} finding(s) with no decision:\n${pending.map(item => '- ' + itemText(item)).join('\n')}\nFix each, or reject it with resolve_objection (what you checked and why), then push again.`);
+}

package/packages/piagent-core/managed/check-questions.mjs

@@ -1,6 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import { memberQuestions } from './member-questions.mjs';
 import { effectivePermission } from './permission.mjs';
+import { digestsOnce, knownFast, markCheckStart, missingSuites, pushQuestion, pushRepositories, reviewBeforePush } from './check-evidence.mjs';
 
 // How much to test is the member's decision: a one-line fix should not cost a
 // thirty-minute suite. The harness asks at the end of a change, before a whole
@@ -15,19 +16,26 @@ const FILTERED = /(?:^|\s)(?:-k|-t|--grep|--testNamePattern|--test-name-pattern|
 const TEST_RUNNER = /\b(npm|pnpm|yarn|bun)\s+(run\s+)?test(:\S+)?(?=\s|$)|\bnode\s+--test\b|\b(vitest|jest|mocha|pytest|rspec|phpunit)\b|\bplaywright\s+test\b|\bpython3?\s+-m\s+(pytest|unittest)\b|\b(go|cargo|swift|dotnet|deno)\s+test\b|\bmake\s+test\b|\bxcodebuild\b.*\btest\b|\b(gradle|gradlew|mvn|mvnw)\b.*\b(test|verify)\b/;
 // Test commands start a command: `npm install -D vitest` or `rm jest.config.ts` only name one.
 const TEST_START = new RegExp(`^(?:${TEST_RUNNER.source})`);
-const LAUNCHER = /^(?:\w+=\S*\s+|time\s+|nohup\s+|timeout\s+\S+\s+|npx\s+(?:-\S+\s+)*|bunx\s+|pnpm\s+(?:exec|dlx)\s+|uv\s+run\s+|poetry\s+run\s+|yarn\s+(?=jest|vitest|mocha|playwright)|node_modules\/\.bin\/|\.\/)+/;
-const partsOf = bare => bare.split(/\s*(?:\|\|?|&&|;)\s*/).map(part => part.replace(/\s\d*>.*$/, '').trim());
+// A function body, a group or a loop body opens a part as well.
+const LAUNCHER = /^(?:[\w-]+\s*\(\)\s*\{?\s*|\{\s+|\(\s*|(?:do|then|else)\s+|\w+=\S*\s+|time\s+|nohup\s+|timeout\s+\S+\s+|npx\s+(?:-\S+\s+)*|bunx\s+|pnpm\s+(?:exec|dlx)\s+|uv\s+run\s+|poetry\s+run\s+|yarn\s+(?=jest|vitest|mocha|playwright)|node_modules\/\.bin\/|\.\/)+/;
+const partsOf = bare => bare.split(/\s*(?:\|\|?|&&|;)\s*/).map(part => part.replace(/\s\d*>.*$/, '').replace(/[\s)}]+$/, '').trim());
 const NOT_TESTS = /\b(lint|typecheck|type-check|tsc|eslint|biome|ruff|mypy|pyright|vet|clippy|format|build)\b/;
 const TARGET_FLAG = /^(-p|--package|-w|--workspace|--tests)$|^(-Dtest=|-only-testing:|--workspace=|--package=)/;
+// `go test -p 4` sets how many packages run at once; for cargo -p names a package.
+const GO_TEST = /^go\s+test\b/;
 const VALUE_FLAG = /^(-c|--config|--reporter|--project|--workers|--timeout|--rootDir|--root|-f|--file|-o|--output)$/;
 // A file or folder named on the command line; a flag's own value names none.
-const targetsPart = args => args.some((a, i) => {
+const targetsPart = (args, go = false) => args.some((a, i) => {
+  // A variable: a function's arguments, a loop's file, $(go list …). The caller chose them, so this is not the whole command.
+  if (a.startsWith('$')) return true;
+  if (go && a === '-p') return false;
   if (TARGET_FLAG.test(a)) return true;
+  if (go && args[i - 1] === '-p') return false;
   if (a.startsWith('-') || VALUE_FLAG.test(args[i - 1] ?? '') || a.includes('*') || a.endsWith('...')) return false;
   return a.includes('/') || /\.(test|spec)\.\w+$|_test\.\w+$|^test_\w+\.\w+$/.test(a);
 });
 // What a command runs, without the text it merely quotes (a commit message, an echo).
-const unquoted = text => text.replace(/"[^"]*"|'[^']*'/g, '""');
+const unquoted = text => text.replace(/"[^"]*"|'[^']*'/g, quoted => quoted.startsWith('"$') ? '$' : '""');
 export function checkScope(command, declared = []) {
   const text = String(command ?? '').replace(/\s+/g, ' ').trim();
   if (!text || /^(echo|printf|grep|rg|cat|sed|awk|head|tail|less|git|ls|find)\b/.test(text) || VERSION_ONLY.test(text) || /--collect-only/.test(text)) return null;
@@ -36,12 +44,17 @@ export function checkScope(command, declared = []) {
     const own = part.replace(LAUNCHER, ''), runner = own.match(TEST_START);
     if (!runner) continue;
     if (FILTERED.test(own)) return 'partial';
-    return !declared.includes(text) && targetsPart(own.slice(runner[0].length).split(' ').filter(Boolean)) ? 'partial' : 'suite';
+    return !declared.includes(text) && targetsPart(own.slice(runner[0].length).split(' ').filter(Boolean), GO_TEST.test(own)) ? 'partial' : 'suite';
   }
   // A script the repository declares: it cannot be narrowed from here.
   const named = declared.find(d => partsOf(bare).some(part => part.startsWith(unquoted(d))));
   return named && !NOT_TESTS.test(named) ? 'suite' : null;
 }
+// The test step of a command, without what surrounds it: the same step costs the same.
+export function suitePart(command) {
+  for (const part of partsOf(unquoted(String(command ?? '').replace(/\s+/g, ' ').trim()))) { const own = part.replace(LAUNCHER, ''); if (TEST_START.test(own)) return own; }
+  return String(command ?? '').trim();
+}
 // The member's own words asking for the whole suite: nothing to ask them then.
 const RUN_ALL = String.raw`(?:full|all(?:\s+the)?|whole(?:\s+the)?|entire(?:\s+the)?|the\s+(?:full|whole|entire))`;
 const FULL_WORDS = new RegExp([
@@ -94,18 +107,19 @@ export async function askCheckScope(self, { partPassed = false, signal } = {}) {
 
 const PARTIAL_REASON = 'managed-check-scope: the member chose to run only the tests that cover the change. Run one file, a filter or one package, not the whole suite. If this project has no way to run part of it, say so and repeat the command: the member is asked.';
 const BYPASS_REASON = 'managed-check-scope: run the tests that cover the change (one file, a filter, one package). A whole-suite run needs the member to ask for it, or their answer before a push. If this project has no way to run part of it, say so and repeat the command.';
-const PUSH_REASON = 'managed-check-scope: the member wants the whole suite before this push. Run it, fix what fails, then push.';
+const PUSH_REASON = missing => `managed-check-scope: the member wants the whole suite before this push${missing.length && missing[0] !== '.' ? ` (still needed in: ${missing.join(', ')})` : ''}. Run it, fix what fails, then push.`;
 const STOPPED_REASON = 'managed-check-scope: the member did not answer whether to push now. Do not push; say so and let them decide.';
 const WORDS_REASON = words => `managed-check-scope: this command did not run. The member answered about testing: "${String(words).slice(0, 500)}". Follow that.`;
 
 // Before a whole suite or a push: returns to let it run, throws to send the agent another way.
 export async function beforeCheckOrPush(self, command, ctx, signal) {
   const run = self.run;
-  if (!run || run.policy?.verify === 'off') return;
+  if (!run || (run.policy?.verify === 'off' && !isGitPush(command))) return;
   // Calls sent together wait for one answer: the next one sees it.
   const turn = (run.scopeQuestion ?? Promise.resolve()).then(() => holdOrLet(self, run, command, ctx, signal));
   run.scopeQuestion = turn.catch(() => {});
-  return turn;
+  await turn;
+  markCheckStart(run, command);
 }
 async function holdOrLet(self, run, command, ctx, signal) {
   const push = isGitPush(command);
@@ -113,18 +127,22 @@ async function holdOrLet(self, run, command, ctx, signal) {
   const surface = surfaceOf(self, ctx);
   if (!surface) return;
   if (push) {
-    const now = await self.digest();
-    if (run.suitePassedOn(now) || (run.pushAllowedOn !== undefined && run.pushAllowedOn === now)) return;
-    const picked = await ask(surface, 'Sắp push code nhưng toàn bộ test chưa pass trên code này. Làm gì?', [PUSH_FULL, PUSH_NOW], signal);
+    const digestOf = digestsOnce(self);
+    await reviewBeforePush(self, digestOf, run, signal);
+    if (run.policy?.verify === 'off') return;
+    const now = await digestOf('.'), repositories = pushRepositories(self, command), single = !repositories.length || repositories[0] === '.';
+    const missing = await missingSuites(digestOf, run, repositories.length ? repositories : ['.']);
+    if ((single ? run.suitePassedOn(now) : false) || !missing.length || (run.pushAllowedOn !== undefined && run.pushAllowedOn === now)) return;
+    const picked = await ask(surface, await pushQuestion(self, digestOf, run, repositories, missing), [PUSH_FULL, PUSH_NOW], signal);
     if (picked === PUSH_NOW) { run.pushAllowedOn = now; return; }
     if (picked?.other) throw Error(WORDS_REASON(picked.other));
     if (picked !== PUSH_FULL) throw Error(STOPPED_REASON);
-    run.scopeChoice = 'full';
-    throw Error(PUSH_REASON);
+    run.scopeChoice = 'full'; run.fullFor = new Set(missing);
+    throw Error(PUSH_REASON(missing));
   }
   // Sent another way once; the same command again means the part did not do: the member decides (Bypass: it runs).
   const held = run.scopeHeld ??= new Set(), again = held.has(command); held.add(command);
-  if (effectivePermission(self) === 'bypass') { if (again) return; throw Error(BYPASS_REASON); }
+  if (effectivePermission(self) === 'bypass') { if (again || knownFast(self, command, suitePart(command))) return; throw Error(BYPASS_REASON); }
   if (run.scopeChoice === 'partial' && !again) throw Error(PARTIAL_REASON);
   const picked = await ask(surface, `Agent muốn chạy toàn bộ test: ${String(command).slice(0, 160)}`, [PART, FULL], signal);
   if (picked === FULL) { run.scopeChoice = 'full'; return; }