@piagent/platform 1.8.0 → 1.9.0

package/docs/workflow-recipes.md

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

package/docs-site/architecture.html

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

package/docs-site/assets/docs.css

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

package/docs-site/benchmark.html

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

package/docs-site/commands.html

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

package/docs-site/content/architecture.html

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

package/docs-site/content/benchmark.html

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

package/docs-site/content/commands.html

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

package/docs-site/content/ecosystem.html

@@ -0,0 +1,144 @@
+<section class="section">
+  <p class="section-kicker">Toàn cảnh</p>
+  <h2 id="toan-canh">Một dashboard, hai cách dùng model</h2>
+  <p class="section-lead">Piagent chạy trên máy từng thành viên. Ở chế độ cá nhân, nó dùng tài khoản model của chính bạn. Ở chế độ công ty, nó đi qua Agent Watch trên máy bạn và Agent Studio của công ty: công ty giữ key, chọn model và đặt quy trình kiểm tra cho cả team.</p>
+  <figure class="diagram">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1120 560" role="img" aria-labelledby="eco-title eco-desc" class="eco-diagram">
+  <title id="eco-title">Hệ sinh thái Piagent</title>
+  <desc id="eco-desc">Máy của thành viên chạy Piagent (Terminal và Dashboard) với guard kiểm tra mọi tool call. Chế độ cá nhân gọi thẳng model bằng tài khoản riêng. Chế độ công ty đi qua Agent Watch giữ key trong Keychain và Agent Studio của công ty, nơi chọn model và Harness cho từng lượt.</desc>
+  <defs>
+    <marker id="eco-arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0 0 L10 5 L0 10 z" fill="#8be9c8"/></marker>
+    <marker id="eco-arrow-lime" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse"><path d="M0 0 L10 5 L0 10 z" fill="#d8ff7a"/></marker>
+  </defs>
+  <style>
+    .eco-box { fill: #101114; stroke: #2c2f37; stroke-width: 1.5; }
+    .eco-zone { fill: rgba(255,255,255,0.015); stroke: #24262d; stroke-width: 1.2; stroke-dasharray: 6 6; }
+    .eco-h { fill: #f4f4ef; font: 600 17px "Be Vietnam Pro", system-ui, sans-serif; }
+    .eco-t { fill: #a4a6ad; font: 400 13.5px "Be Vietnam Pro", system-ui, sans-serif; }
+    .eco-k { fill: #71747d; font: 600 12px "Be Vietnam Pro", system-ui, sans-serif; letter-spacing: .12em; text-transform: uppercase; }
+    .eco-chip { fill: rgba(216,255,122,0.08); stroke: rgba(216,255,122,0.35); }
+    .eco-chip-t { fill: #d8ff7a; font: 600 12.5px "JetBrains Mono", ui-monospace, monospace; }
+    .eco-line { stroke: #8be9c8; stroke-width: 1.8; fill: none; }
+    .eco-line-lime { stroke: #d8ff7a; stroke-width: 1.8; fill: none; stroke-dasharray: 7 6; }
+    .eco-label { fill: #8be9c8; font: 500 12.5px "Be Vietnam Pro", system-ui, sans-serif; }
+    .eco-label-lime { fill: #d8ff7a; font: 500 12.5px "Be Vietnam Pro", system-ui, sans-serif; }
+  </style>
+  <rect class="eco-zone" x="16" y="16" width="420" height="528" rx="22"/>
+  <text class="eco-k" x="40" y="48">Máy của thành viên</text>
+  <rect class="eco-box" x="40" y="68" width="372" height="96" rx="16"/>
+  <text class="eco-h" x="62" y="102">Piagent · Terminal và Dashboard</text>
+  <text class="eco-t" x="62" y="128">Nói việc bằng lời thường; cùng một lịch sử</text>
+  <text class="eco-t" x="62" y="148">trong Terminal (pi) và trình duyệt.</text>
+  <rect class="eco-box" x="40" y="184" width="372" height="116" rx="16"/>
+  <text class="eco-h" x="62" y="218">Guard</text>
+  <text class="eco-t" x="62" y="244">Kiểm tra mọi tool call: file bảo vệ, profile</text>
+  <text class="eco-t" x="62" y="264">quyền, file quá lớn, sửa trên bản đã cũ;</text>
+  <text class="eco-t" x="62" y="284">push, publish, lệnh có mạng chờ bạn duyệt.</text>
+  <rect class="eco-box" x="40" y="320" width="372" height="96" rx="16"/>
+  <text class="eco-h" x="62" y="354">Sandbox của chế độ công ty</text>
+  <text class="eco-t" x="62" y="380">Lệnh chạy không mạng, không đọc Keychain,</text>
+  <text class="eco-t" x="62" y="400">.env hay SSH key; mạng chỉ mở theo lần duyệt.</text>
+  <rect class="eco-chip" x="40" y="440" width="176" height="34" rx="17"/>
+  <text class="eco-chip-t" x="58" y="462">piagent dashboard</text>
+  <rect class="eco-chip" x="226" y="440" width="186" height="34" rx="17"/>
+  <text class="eco-chip-t" x="244" y="462">piagent studio --web</text>
+  <rect class="eco-chip" x="40" y="486" width="76" height="34" rx="17"/>
+  <text class="eco-chip-t" x="64" y="508">pi</text>
+  <rect class="eco-chip" x="126" y="486" width="186" height="34" rx="17"/>
+  <text class="eco-chip-t" x="144" y="508">piagent-doctor</text>
+  <rect class="eco-box" x="500" y="68" width="250" height="96" rx="18"/>
+  <text class="eco-h" x="522" y="102">Model cá nhân</text>
+  <text class="eco-t" x="522" y="128">Đăng nhập bằng tài khoản</text>
+  <text class="eco-t" x="522" y="148">riêng: Codex, Claude, Copilot…</text>
+  <rect class="eco-box" x="500" y="184" width="250" height="232" rx="18"/>
+  <text class="eco-k" x="522" y="216">Ứng dụng macOS</text>
+  <text class="eco-h" x="522" y="244">Agent Watch</text>
+  <text class="eco-t" x="522" y="272">Giữ key công ty trong</text>
+  <text class="eco-t" x="522" y="292">Keychain; nhập cấu hình</text>
+  <text class="eco-t" x="522" y="312">cho Piagent; cấp quyền</text>
+  <text class="eco-t" x="522" y="332">ngắn hạn cho từng lượt.</text>
+  <text class="eco-t" x="522" y="364">Model không bao giờ thấy</text>
+  <text class="eco-t" x="522" y="384">key.</text>
+  <rect class="eco-zone" x="800" y="16" width="304" height="528" rx="22"/>
+  <text class="eco-k" x="824" y="48">Máy chủ công ty</text>
+  <rect class="eco-box" x="824" y="68" width="256" height="300" rx="18"/>
+  <text class="eco-h" x="846" y="102">Agent Studio</text>
+  <text class="eco-t" x="846" y="132">Thành viên, key, ngân sách</text>
+  <text class="eco-t" x="846" y="152">và usage theo ngày.</text>
+  <text class="eco-t" x="846" y="186">Harness của team:</text>
+  <text class="eco-label-lime" x="846" y="210">kế hoạch · check · review</text>
+  <text class="eco-t" x="846" y="244">Chọn model cho từng vai:</text>
+  <text class="eco-label-lime" x="846" y="268">main · research · review</text>
+  <text class="eco-t" x="846" y="302">Mỗi vai một model riêng,</text>
+  <text class="eco-t" x="846" y="322">thinking theo Harness.</text>
+  <rect class="eco-box" x="824" y="392" width="256" height="128" rx="18"/>
+  <text class="eco-h" x="846" y="426">Model của công ty</text>
+  <text class="eco-t" x="846" y="454">Claude, GPT, DeepSeek, Kimi,</text>
+  <text class="eco-t" x="846" y="474">GLM, Qwen… qua key công ty;</text>
+  <text class="eco-t" x="846" y="494">key chỉ nằm trên máy chủ.</text>
+  <path class="eco-line" d="M412 300 L 500 300" marker-end="url(#eco-arrow)"/>
+  <text class="eco-label" x="424" y="290">công ty</text>
+  <path class="eco-line" d="M750 300 C 790 300, 790 220, 824 220" marker-end="url(#eco-arrow)"/>
+  <text class="eco-label" x="748" y="348">lượt có hạn</text>
+  <path class="eco-line" d="M952 368 L952 392" marker-end="url(#eco-arrow)"/>
+  <path class="eco-line-lime" d="M412 116 L 500 116" marker-end="url(#eco-arrow-lime)"/>
+  <text class="eco-label-lime" x="420" y="106">cá nhân</text>
+</svg>
+    <figcaption class="diagram-hint">Vuốt ngang để xem hết sơ đồ.</figcaption>
+  </figure>
+</section>
+
+<section class="section">
+  <p class="section-kicker">Thành phần</p>
+  <h2 id="thanh-phan">Mỗi phần làm một việc</h2>
+  <div class="grid cols-2">
+    <article class="card">
+      <h3 id="piagent">Piagent</h3>
+      <p>Coding agent trong Terminal (<span class="inline-code">pi</span>) và trên trình duyệt (<span class="inline-code">piagent dashboard</span>). Hai nơi dùng chung lịch sử: bắt đầu ở Terminal, xem tiếp trên trình duyệt.</p>
+    </article>
+    <article class="card">
+      <h3 id="guard">Guard</h3>
+      <p>Kiểm tra từng tool call trước khi chạy: file bảo vệ như <span class="inline-code">.env</span>, profile quyền, file quá lớn, sửa trên bản đã cũ. Push, publish và lệnh có mạng chờ bạn duyệt đúng một lần.</p>
+    </article>
+    <article class="card">
+      <h3 id="agent-watch">Agent Watch</h3>
+      <p>Ứng dụng macOS giữ key công ty trong Keychain và nhập cấu hình cho Piagent. Mỗi lượt nhận quyền ngắn hạn; model và các lệnh không bao giờ đọc được key.</p>
+    </article>
+    <article class="card">
+      <h3 id="agent-studio">Agent Studio</h3>
+      <p>Máy chủ của công ty: thành viên, key, ngân sách, usage theo ngày và Harness của team. Studio chọn model cho từng vai (main, research, review) và mức suy luận.</p>
+    </article>
+  </div>
+</section>
+
+<section class="section">
+  <p class="section-kicker">Một lượt ở chế độ công ty</p>
+  <h2 id="mot-luot">Từ tin nhắn tới "Check đã qua · Review không có lỗi chặn"</h2>
+  <div class="steps">
+    <article class="step"><div><h3>Bạn nhắn việc cần làm</h3><p>Viết như nói với đồng nghiệp, chọn model <span class="inline-code">agent-watch-auto</span> trong nhóm Công ty.</p></div></article>
+    <article class="step"><div><h3>Studio cấp một lượt</h3><p>Agent Watch xin quyền ngắn hạn; Studio chọn model cho agent chính theo Harness của team.</p></div></article>
+    <article class="step"><div><h3>Agent làm trong sandbox</h3><p>Đọc, sửa và chạy lệnh trong project, không có mạng. Cần mạng thì xin bạn duyệt đúng một lệnh.</p></div></article>
+    <article class="step"><div><h3>Harness kiểm tra</h3><p>Chưa có check nào qua trên code cuối thì yêu cầu chạy; rồi một subagent review bản sửa. Lỗi chặn được gửi lại cho agent, tối đa số vòng team đặt.</p></div></article>
+    <article class="step"><div><h3>Kết quả ghi dưới câu trả lời</h3><p>Ví dụ "Check đã qua trên code cuối · Review không có lỗi chặn". Bạn có thể Dừng bất cứ lúc nào và Tiếp tục sau.</p></div></article>
+  </div>
+  <figure class="shot">
+    <img src="/assets/shots/company-review-running.jpg" alt="Đang review: thanh trên ghi Subagent 1/2, nút Dừng vẫn còn" loading="lazy" width="1600" height="1000">
+    <figcaption>Lúc review đang chạy: thanh trên ghi Subagent 1/2, cột Workspace ghi 1/2 đang chạy, nút Dừng vẫn hoạt động.</figcaption>
+  </figure>
+</section>
+
+<section class="section">
+  <p class="section-kicker">Chọn chế độ</p>
+  <h2 id="chon-che-do">Khi nào dùng cá nhân, khi nào dùng công ty</h2>
+  <div class="table-wrap"><table>
+    <thead><tr><th></th><th>Cá nhân</th><th>Công ty</th></tr></thead>
+    <tbody>
+      <tr><td>Model</td><td>Tài khoản bạn đăng nhập (Codex, Claude, Copilot…)</td><td>Model công ty chọn trong Studio, theo vai</td></tr>
+      <tr><td>Key</td><td>Do Pi quản lý trên máy bạn</td><td>Nằm trên máy chủ và trong Keychain, không vào project</td></tr>
+      <tr><td>Kiểm tra</td><td>Guard; bạn quyết định khi nào chạy test</td><td>Guard, sandbox, và Harness tự yêu cầu check, review</td></tr>
+      <tr><td>Mạng khi chạy lệnh</td><td>Như trên máy bạn; push và publish chờ duyệt</td><td>Tắt; mở cho đúng một lệnh khi bạn duyệt</td></tr>
+      <tr><td>Chi phí</td><td>Theo gói của bạn</td><td>Theo ngân sách công ty, xem usage trong Studio</td></tr>
+    </tbody>
+  </table></div>
+  <div class="callout ok-callout"><strong>Bắt đầu</strong><p>Cá nhân: cài theo <a href="/quickstart">Quickstart</a> rồi chạy <span class="inline-code">piagent dashboard</span>. Công ty: mở Agent Watch, tab Studio, kết nối key và nhập cấu hình cho Piagent; model <span class="inline-code">agent-watch-auto</span> sẽ có trong nhóm Công ty.</p></div>
+</section>

package/docs-site/content/en/architecture.html

@@ -21,7 +21,7 @@
   </div>
   <div class="grid cols-3">
     <article class="card"><h3>Context planner</h3><p><span class="inline-code">runtime/context/adaptive-planner.ts</span> chooses budget, retrieval lane, code inclusion, and a plan receipt from phase, context pressure, model capability, and thinking level.</p></article>
-    <article class="card"><h3>Task journal</h3><p><span class="inline-code">extensions/task-journal.js</span> records start, progress, mutation, verifier, and completion checkpoints. Resume trusts the task contract first; retention compaction preserves hash anchors.</p></article>
+    <article class="card"><h3>Earlier task history</h3><p><span class="inline-code">extensions/task-journal.js</span> still reads checkpoints of tasks created before 1.9.0 for review; new sessions no longer write tasks.</p></article>
     <article class="card"><h3>Repository memory</h3><p><span class="inline-code">extensions/repository-memory.js</span> stores only cited, expiring facts and rejects raw prompts, outputs, OAuth material, API keys, and secrets. Hints use only unused context-plan budget.</p></article>
     <article class="card"><h3>Model capability</h3><p><span class="inline-code">runtime/model/capabilities.ts</span> reads model family, context window, and thinking level as budget signals without switching providers or requiring API keys.</p></article>
     <article class="card"><h3>Verification intelligence</h3><p><span class="inline-code">extensions/verification-intelligence.js</span> classifies failures and chooses a targeted verifier from task scope; mixed frontend/backend scope uses the full source verifier.</p></article>