@piagent/platform 1.2.2 → 1.2.3

package/docs/workflow-recipes.md

@@ -11,8 +11,9 @@ Dùng khi muốn cải tiến setup, prompt, MCP, model scope, memory, runtime p
 Lệnh trong Pi:
 
 ```text
-/onboard-project
-/platform-improve Improve <target behavior> in <platform area>.
+/onboard
+/onboard run
+/workflow platform-improve Improve <target behavior> in <platform area>.
 ```
 
 Input tối thiểu:
@@ -58,8 +59,9 @@ Setup project generic:
 Lệnh trong Pi:
 
 ```text
-/onboard-project
-/be-to-fe Implement FE from BE spec: <endpoint/spec/change>
+/onboard
+/onboard run
+/workflow be-to-fe Implement FE from BE spec: <endpoint/spec/change>
 ```
 
 Input tối thiểu:
@@ -96,7 +98,7 @@ Không dùng `auto` để suy ra `be-readonly-fe`, vì BE read-only là policy d
 Dùng khi muốn Pi nhớ durable facts/decisions/preferences giữa các session mà không phải scout lại từ đầu.
 
 ```text
-/memory-policy
+/memory
 Remember: this repo uses pnpm, never npm.
 ```
 
@@ -112,9 +114,10 @@ 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-project
-/context-index
-/context-index search auth
+/onboard
+/onboard run
+/context index
+/context search auth
 ```
 
 Rule:
@@ -122,4 +125,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-project` hoặc record lại bằng `piagent_context_index_record`.
+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`.

package/docs-site/architecture.html

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

package/docs-site/commands.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.2 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.3 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
@@ -100,11 +100,14 @@
       <div class="tag-list">
         <span class="tag">/login</span>
         <span class="tag">/model</span>
-        <span class="tag">/piagent-commands</span>
+        <span class="tag">/commands</span>
         <span class="tag">/piagent-status</span>
         <span class="tag">/piagent-orchestration</span>
-        <span class="tag">/piagent-usage</span>
-        <span class="tag">/task-preflight</span>
+        <span class="tag">/usage</span>
+        <span class="tag">/context preflight</span>
+        <span class="tag">/name</span>
+        <span class="tag">/fresh</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>
     </article>
@@ -125,30 +128,31 @@
     <article class="card">
       <h3 id="implementation-workflow">Implementation workflow</h3>
       <div class="tag-list">
-        <span class="tag">/task</span>
-        <span class="tag">/plan</span>
-        <span class="tag">/review</span>
-        <span class="tag">/scout</span>
-        <span class="tag">/discuss</span>
+        <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>
       </div>
       <p>Gói sẵn read context, task contract, implementation, verify evidence và final handoff.</p>
     </article>
     <article class="card">
       <h3 id="git-handoff">Git handoff</h3>
       <div class="tag-list">
-        <span class="tag">/commit</span>
-        <span class="tag">/pr</span>
+        <span class="tag">/workflow commit</span>
+        <span class="tag">/workflow pr</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 shell 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 đ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>
     </article>
     <article class="card">
       <h3 id="fresh-sessions">Fresh sessions</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">/fresh task</span>
+        <span class="tag">/fresh scout</span>
+        <span class="tag">/fresh be-to-fe</span>
       </div>
       <p>Dùng khi context đã nặng hoặc cần một session sạch cho workflow mới.</p>
     </article>

package/docs-site/content/commands.html

@@ -6,11 +6,14 @@
       <div class="tag-list">
         <span class="tag">/login</span>
         <span class="tag">/model</span>
-        <span class="tag">/piagent-commands</span>
+        <span class="tag">/commands</span>
         <span class="tag">/piagent-status</span>
         <span class="tag">/piagent-orchestration</span>
-        <span class="tag">/piagent-usage</span>
-        <span class="tag">/task-preflight</span>
+        <span class="tag">/usage</span>
+        <span class="tag">/context preflight</span>
+        <span class="tag">/name</span>
+        <span class="tag">/fresh</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>
     </article>
@@ -31,30 +34,31 @@
     <article class="card">
       <h3 id="implementation-workflow">Implementation workflow</h3>
       <div class="tag-list">
-        <span class="tag">/task</span>
-        <span class="tag">/plan</span>
-        <span class="tag">/review</span>
-        <span class="tag">/scout</span>
-        <span class="tag">/discuss</span>
+        <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>
       </div>
       <p>Gói sẵn read context, task contract, implementation, verify evidence và final handoff.</p>
     </article>
     <article class="card">
       <h3 id="git-handoff">Git handoff</h3>
       <div class="tag-list">
-        <span class="tag">/commit</span>
-        <span class="tag">/pr</span>
+        <span class="tag">/workflow commit</span>
+        <span class="tag">/workflow pr</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 shell 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 đ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>
     </article>
     <article class="card">
       <h3 id="fresh-sessions">Fresh sessions</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">/fresh task</span>
+        <span class="tag">/fresh scout</span>
+        <span class="tag">/fresh be-to-fe</span>
       </div>
       <p>Dùng khi context đã nặng hoặc cần một session sạch cho workflow mới.</p>
     </article>

package/docs-site/content/permissions.html

@@ -15,19 +15,19 @@
           <td><span class="inline-code">read-only</span></td>
           <td>Scout, audit, mapping, review không chỉnh source.</td>
           <td>Cho read, grep, find, ls và piagent tools; chặn shell/write/unknown tools.</td>
-          <td><span class="inline-code">/read-only</span></td>
+          <td><span class="inline-code">/permission read-only</span></td>
         </tr>
         <tr>
           <td><span class="inline-code">workspace-write</span></td>
           <td>Implementation bình thường trong repo.</td>
           <td>Default guarded mode; giữ protected path, shell policy, capability và verify gate.</td>
-          <td><span class="inline-code">/workspace-write</span></td>
+          <td><span class="inline-code">/permission workspace-write</span></td>
         </tr>
         <tr>
           <td><span class="inline-code">trusted-full-access</span></td>
           <td>Automation trên repo đã tin và task đã rõ.</td>
           <td>Nới autonomy trong guard, nhưng vẫn giữ protected path, redaction, lock và confirmation.</td>
-          <td><span class="inline-code">/full-access</span></td>
+          <td><span class="inline-code">/permission full-access</span></td>
         </tr>
       </tbody>
     </table>
@@ -35,20 +35,20 @@
 
   <div class="command-grid">
     <article class="command-card">
-      <header><span>Xem permission</span><button class="clip-btn" data-clip="/permission-status">Lấy lệnh</button></header>
-      <pre><code>/permission-status</code></pre>
+      <header><span>Xem permission</span><button class="clip-btn" data-clip="/permission status">Lấy lệnh</button></header>
+      <pre><code>/permission status</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Read-only session</span><button class="clip-btn" data-clip="/read-only">Lấy lệnh</button></header>
-      <pre><code>/read-only</code></pre>
+      <header><span>Read-only session</span><button class="clip-btn" data-clip="/permission read-only">Lấy lệnh</button></header>
+      <pre><code>/permission read-only</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Workspace write</span><button class="clip-btn" data-clip="/workspace-write">Lấy lệnh</button></header>
-      <pre><code>/workspace-write</code></pre>
+      <header><span>Workspace write</span><button class="clip-btn" data-clip="/permission workspace-write">Lấy lệnh</button></header>
+      <pre><code>/permission workspace-write</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Full-access + task</span><button class="clip-btn" data-clip="/full-access Run the trusted local verification suite.">Lấy lệnh</button></header>
-      <pre><code>/full-access Run the trusted local verification suite.</code></pre>
+      <header><span>Full-access + task</span><button class="clip-btn" data-clip="/permission full-access Run the trusted local verification suite.">Lấy lệnh</button></header>
+      <pre><code>/permission full-access Run the trusted local verification suite.</code></pre>
     </article>
   </div>
 </section>

package/docs-site/content/quickstart.html

@@ -4,7 +4,7 @@
     <article class="step">
       <div>
         <h3 id="cai-hai-lenh">Cài — hai lệnh</h3>
-        <p>Cần Node.js 22.19.0 trở lên. Không cần cài Pi Coding Agent trước: <span class="inline-code">piagent-setup</span> tự cài đúng bản <span class="inline-code">0.82.0</span> mà release <span class="inline-code">v1.2.2</span> đang pin. Chạy nó ngay trong thư mục project — nó cài Pi package, khởi tạo <span class="inline-code">.pi/</span>, cài MCP baseline cùng subagents, rồi chạy doctor. Thêm <span class="inline-code">--no-mcp</span>, <span class="inline-code">--no-subagents</span>, <span class="inline-code">--no-herdr</span> hoặc <span class="inline-code">--global-only</span> để bỏ bớt.</p>
+        <p>Cần Node.js 22.19.0 trở lên. Không cần cài Pi Coding Agent trước: <span class="inline-code">piagent-setup</span> tự cài đúng bản <span class="inline-code">0.82.0</span> mà release <span class="inline-code">v1.2.3</span> đang pin. Chạy nó ngay trong thư mục project — nó cài Pi package, khởi tạo <span class="inline-code">.pi/</span>, cài MCP baseline cùng subagents, rồi chạy doctor. Thêm <span class="inline-code">--no-mcp</span>, <span class="inline-code">--no-subagents</span>, <span class="inline-code">--no-herdr</span> hoặc <span class="inline-code">--global-only</span> để bỏ bớt.</p>
         <div class="table-wrap compact-table">
           <table>
             <thead>
@@ -66,10 +66,11 @@ pi</code></pre>
     <article class="step">
       <div>
         <h3 id="onboard-context">Onboard context</h3>
-        <p>Chạy một lần ở repo mới để ghi context, verify matrix và protected areas vào <span class="inline-code">.pi/</span>.</p>
+        <p>Chạy một lần ở repo mới để ghi context, verify matrix và protected areas vào <span class="inline-code">.pi/</span>. <span class="inline-code">/onboard</span> mở menu/status; <span class="inline-code">run</span> mới launch workflow đọc project.</p>
         <div class="command-card">
-          <header><span>Onboard</span><button class="clip-btn" data-clip="/onboard-project">Lấy lệnh</button></header>
-          <pre><code>/onboard-project</code></pre>
+          <header><span>Onboard</span><button class="clip-btn" data-clip="/onboard&#10;/onboard run">Lấy lệnh</button></header>
+          <pre><code>/onboard
+/onboard run</code></pre>
         </div>
       </div>
     </article>
@@ -91,9 +92,9 @@ pi</code></pre>
         <h3 id="chon-permission">Chọn permission</h3>
         <p>Scout thì read-only, code bình thường thì workspace-write, automation tin cậy thì full-access có guard.</p>
         <div class="command-card">
-          <header><span>Permission</span><button class="clip-btn" data-clip="/workspace-write">Lấy lệnh</button></header>
-          <pre><code>/permission-status
-/workspace-write</code></pre>
+          <header><span>Permission</span><button class="clip-btn" data-clip="/permission status&#10;/permission workspace-write">Lấy lệnh</button></header>
+          <pre><code>/permission status
+/permission workspace-write</code></pre>
         </div>
       </div>
     </article>
@@ -103,10 +104,10 @@ pi</code></pre>
         <h3 id="chay-workflow">Chạy workflow</h3>
         <p>Dùng command đúng mục tiêu để agent không phải diễn giải quá dài. Task nào nặng context thì dùng fresh session.</p>
         <div class="command-card">
-          <header><span>Workflow</span><button class="clip-btn" data-clip="/task Implement the requested bounded change.">Lấy lệnh</button></header>
-          <pre><code>/task Implement the requested bounded change.
-/review
-/fresh-task Implement the requested bounded change.</code></pre>
+          <header><span>Workflow</span><button class="clip-btn" data-clip="/workflow task Implement the requested bounded change.&#10;/workflow review current diff&#10;/fresh task Implement the requested bounded change.">Lấy lệnh</button></header>
+          <pre><code>/workflow task Implement the requested bounded change.
+/workflow review current diff
+/fresh task Implement the requested bounded change.</code></pre>
         </div>
       </div>
     </article>

package/docs-site/content/team.html

@@ -3,7 +3,7 @@
   <div class="split">
     <article class="card">
       <h3 id="viec-nen-lam">Việc nên làm</h3>
-      <p>Chạy <span class="inline-code">/onboard-project</span>, áp <span class="inline-code">/profile auto</span>, dùng workflow command, verify thật và ghi blockers rõ ràng.</p>
+      <p>Chạy <span class="inline-code">/onboard run</span>, áp <span class="inline-code">/profile auto</span>, dùng <span class="inline-code">/workflow</span>, verify thật và ghi blockers rõ ràng.</p>
     </article>
     <article class="card">
       <h3 id="viec-nen-tranh">Việc nên tránh</h3>

package/docs-site/content/workflows.html

@@ -1,7 +1,7 @@
 <section class="section">
   <div class="callout ok-callout">
     <strong>Git trong Pi Agent</strong>
-    <p>Không có namespace <span class="inline-code">/git</span> riêng. Dùng <span class="inline-code">/commit</span> để commit local đã review, dùng <span class="inline-code">/pr</span> để chuẩn bị PR. Các hành động như <span class="inline-code">git push</span> hoặc stage rộng <span class="inline-code">git add -A</span> vẫn cần operator xác nhận.</p>
+    <p>Không có namespace <span class="inline-code">/git</span> riêng. Dùng <span class="inline-code">/workflow commit</span> để commit local đã review, dùng <span class="inline-code">/workflow pr</span> để chuẩn bị PR. Các hành động như <span class="inline-code">git push</span> hoặc stage rộng <span class="inline-code">git add -A</span> vẫn cần operator xác nhận.</p>
   </div>
 
   <div class="callout">
@@ -11,37 +11,37 @@
 
   <div class="command-grid">
     <article class="command-card">
-      <header><span>Implementation bounded</span><button class="clip-btn" data-clip="/task Fix the failing checkout test and verify.">Lấy lệnh</button></header>
-      <pre><code>/task Fix the failing checkout test and verify.</code></pre>
+      <header><span>Implementation bounded</span><button class="clip-btn" data-clip="/workflow task Fix the failing checkout test and verify.">Lấy lệnh</button></header>
+      <pre><code>/workflow task Fix the failing checkout test and verify.</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Read-only scout</span><button class="clip-btn" data-clip="/scout Map the auth flow and risk areas.">Lấy lệnh</button></header>
-      <pre><code>/scout Map the auth flow and risk areas.</code></pre>
+      <header><span>Read-only scout</span><button class="clip-btn" data-clip="/workflow scout Map the auth flow and risk areas.">Lấy lệnh</button></header>
+      <pre><code>/workflow scout Map the auth flow and risk areas.</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Plan trước khi code</span><button class="clip-btn" data-clip="/plan Add multi-tenant billing support.">Lấy lệnh</button></header>
-      <pre><code>/plan Add multi-tenant billing support.</code></pre>
+      <header><span>Plan trước khi code</span><button class="clip-btn" data-clip="/workflow plan Add multi-tenant billing support.">Lấy lệnh</button></header>
+      <pre><code>/workflow plan Add multi-tenant billing support.</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Review diff</span><button class="clip-btn" data-clip="/review">Lấy lệnh</button></header>
-      <pre><code>/review</code></pre>
+      <header><span>Review diff</span><button class="clip-btn" data-clip="/workflow review current diff">Lấy lệnh</button></header>
+      <pre><code>/workflow review current diff</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Commit local có guard</span><button class="clip-btn" data-clip="/commit &quot;feat: add guarded git workflow&quot;">Lấy lệnh</button></header>
-      <pre><code>/commit "feat: add guarded git workflow"</code></pre>
+      <header><span>Commit local có guard</span><button class="clip-btn" data-clip="/workflow commit &quot;feat: add guarded git workflow&quot;">Lấy lệnh</button></header>
+      <pre><code>/workflow commit "feat: add guarded git workflow"</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Chuẩn bị pull request</span><button class="clip-btn" data-clip="/pr &quot;Prepare PR for guarded git workflow&quot;">Lấy lệnh</button></header>
-      <pre><code>/pr "Prepare PR for guarded git workflow"</code></pre>
+      <header><span>Chuẩn bị pull request</span><button class="clip-btn" data-clip="/workflow pr &quot;Prepare PR for guarded git workflow&quot;">Lấy lệnh</button></header>
+      <pre><code>/workflow pr "Prepare PR for guarded git workflow"</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Backend spec sang frontend</span><button class="clip-btn" data-clip="/be-to-fe Implement frontend support for the new user status endpoint.">Lấy lệnh</button></header>
+      <header><span>Backend spec sang frontend</span><button class="clip-btn" data-clip="/profile be-readonly-fe&#10;/workflow be-to-fe Implement frontend support for the new user status endpoint.">Lấy lệnh</button></header>
       <pre><code>/profile be-readonly-fe
-/be-to-fe Implement frontend support for the new user status endpoint.</code></pre>
+/workflow be-to-fe Implement frontend support for the new user status endpoint.</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Cải thiện platform</span><button class="clip-btn" data-clip="/platform-improve Harden command docs and run verification.">Lấy lệnh</button></header>
-      <pre><code>/platform-improve Harden command docs and run verification.</code></pre>
+      <header><span>Cải thiện platform</span><button class="clip-btn" data-clip="/workflow platform-improve Harden command docs and run verification.">Lấy lệnh</button></header>
+      <pre><code>/workflow platform-improve Harden command docs and run verification.</code></pre>
     </article>
   </div>
 </section>

package/docs-site/index.html

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

package/docs-site/mcp-approval.html

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

package/docs-site/mcp-auth.html

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

package/docs-site/mcp-servers.html

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

package/docs-site/mcp.html

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

package/docs-site/permissions.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.2 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.3 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
@@ -109,19 +109,19 @@
           <td><span class="inline-code">read-only</span></td>
           <td>Scout, audit, mapping, review không chỉnh source.</td>
           <td>Cho read, grep, find, ls và piagent tools; chặn shell/write/unknown tools.</td>
-          <td><span class="inline-code">/read-only</span></td>
+          <td><span class="inline-code">/permission read-only</span></td>
         </tr>
         <tr>
           <td><span class="inline-code">workspace-write</span></td>
           <td>Implementation bình thường trong repo.</td>
           <td>Default guarded mode; giữ protected path, shell policy, capability và verify gate.</td>
-          <td><span class="inline-code">/workspace-write</span></td>
+          <td><span class="inline-code">/permission workspace-write</span></td>
         </tr>
         <tr>
           <td><span class="inline-code">trusted-full-access</span></td>
           <td>Automation trên repo đã tin và task đã rõ.</td>
           <td>Nới autonomy trong guard, nhưng vẫn giữ protected path, redaction, lock và confirmation.</td>
-          <td><span class="inline-code">/full-access</span></td>
+          <td><span class="inline-code">/permission full-access</span></td>
         </tr>
       </tbody>
     </table>
@@ -129,20 +129,20 @@
 
   <div class="command-grid">
     <article class="command-card">
-      <header><span>Xem permission</span><button class="clip-btn" data-clip="/permission-status">Lấy lệnh</button></header>
-      <pre><code>/permission-status</code></pre>
+      <header><span>Xem permission</span><button class="clip-btn" data-clip="/permission status">Lấy lệnh</button></header>
+      <pre><code>/permission status</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Read-only session</span><button class="clip-btn" data-clip="/read-only">Lấy lệnh</button></header>
-      <pre><code>/read-only</code></pre>
+      <header><span>Read-only session</span><button class="clip-btn" data-clip="/permission read-only">Lấy lệnh</button></header>
+      <pre><code>/permission read-only</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Workspace write</span><button class="clip-btn" data-clip="/workspace-write">Lấy lệnh</button></header>
-      <pre><code>/workspace-write</code></pre>
+      <header><span>Workspace write</span><button class="clip-btn" data-clip="/permission workspace-write">Lấy lệnh</button></header>
+      <pre><code>/permission workspace-write</code></pre>
     </article>
     <article class="command-card">
-      <header><span>Full-access + task</span><button class="clip-btn" data-clip="/full-access Run the trusted local verification suite.">Lấy lệnh</button></header>
-      <pre><code>/full-access Run the trusted local verification suite.</code></pre>
+      <header><span>Full-access + task</span><button class="clip-btn" data-clip="/permission full-access Run the trusted local verification suite.">Lấy lệnh</button></header>
+      <pre><code>/permission full-access Run the trusted local verification suite.</code></pre>
     </article>
   </div>
 </section>

package/docs-site/profiles.html

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

package/docs-site/quickstart.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.2 docs</span>
+        <span class="pill"><span class="pill-dot"></span>v1.2.3 docs</span>
         <a class="button social" href="https://github.com/Vt-mmm/piagent" target="_blank" rel="noopener noreferrer" aria-label="Mở GitHub repository">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
             <path d="M7 17 17 7M9 7h8v8" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" />
@@ -98,7 +98,7 @@
     <article class="step">
       <div>
         <h3 id="cai-hai-lenh">Cài — hai lệnh</h3>
-        <p>Cần Node.js 22.19.0 trở lên. Không cần cài Pi Coding Agent trước: <span class="inline-code">piagent-setup</span> tự cài đúng bản <span class="inline-code">0.82.0</span> mà release <span class="inline-code">v1.2.2</span> đang pin. Chạy nó ngay trong thư mục project — nó cài Pi package, khởi tạo <span class="inline-code">.pi/</span>, cài MCP baseline cùng subagents, rồi chạy doctor. Thêm <span class="inline-code">--no-mcp</span>, <span class="inline-code">--no-subagents</span>, <span class="inline-code">--no-herdr</span> hoặc <span class="inline-code">--global-only</span> để bỏ bớt.</p>
+        <p>Cần Node.js 22.19.0 trở lên. Không cần cài Pi Coding Agent trước: <span class="inline-code">piagent-setup</span> tự cài đúng bản <span class="inline-code">0.82.0</span> mà release <span class="inline-code">v1.2.3</span> đang pin. Chạy nó ngay trong thư mục project — nó cài Pi package, khởi tạo <span class="inline-code">.pi/</span>, cài MCP baseline cùng subagents, rồi chạy doctor. Thêm <span class="inline-code">--no-mcp</span>, <span class="inline-code">--no-subagents</span>, <span class="inline-code">--no-herdr</span> hoặc <span class="inline-code">--global-only</span> để bỏ bớt.</p>
         <div class="table-wrap compact-table">
           <table>
             <thead>
@@ -160,10 +160,11 @@ pi</code></pre>
     <article class="step">
       <div>
         <h3 id="onboard-context">Onboard context</h3>
-        <p>Chạy một lần ở repo mới để ghi context, verify matrix và protected areas vào <span class="inline-code">.pi/</span>.</p>
+        <p>Chạy một lần ở repo mới để ghi context, verify matrix và protected areas vào <span class="inline-code">.pi/</span>. <span class="inline-code">/onboard</span> mở menu/status; <span class="inline-code">run</span> mới launch workflow đọc project.</p>
         <div class="command-card">
-          <header><span>Onboard</span><button class="clip-btn" data-clip="/onboard-project">Lấy lệnh</button></header>
-          <pre><code>/onboard-project</code></pre>
+          <header><span>Onboard</span><button class="clip-btn" data-clip="/onboard&#10;/onboard run">Lấy lệnh</button></header>
+          <pre><code>/onboard
+/onboard run</code></pre>
         </div>
       </div>
     </article>
@@ -185,9 +186,9 @@ pi</code></pre>
         <h3 id="chon-permission">Chọn permission</h3>
         <p>Scout thì read-only, code bình thường thì workspace-write, automation tin cậy thì full-access có guard.</p>
         <div class="command-card">
-          <header><span>Permission</span><button class="clip-btn" data-clip="/workspace-write">Lấy lệnh</button></header>
-          <pre><code>/permission-status
-/workspace-write</code></pre>
+          <header><span>Permission</span><button class="clip-btn" data-clip="/permission status&#10;/permission workspace-write">Lấy lệnh</button></header>
+          <pre><code>/permission status
+/permission workspace-write</code></pre>
         </div>
       </div>
     </article>
@@ -197,10 +198,10 @@ pi</code></pre>
         <h3 id="chay-workflow">Chạy workflow</h3>
         <p>Dùng command đúng mục tiêu để agent không phải diễn giải quá dài. Task nào nặng context thì dùng fresh session.</p>
         <div class="command-card">
-          <header><span>Workflow</span><button class="clip-btn" data-clip="/task Implement the requested bounded change.">Lấy lệnh</button></header>
-          <pre><code>/task Implement the requested bounded change.
-/review
-/fresh-task Implement the requested bounded change.</code></pre>
+          <header><span>Workflow</span><button class="clip-btn" data-clip="/workflow task Implement the requested bounded change.&#10;/workflow review current diff&#10;/fresh task Implement the requested bounded change.">Lấy lệnh</button></header>
+          <pre><code>/workflow task Implement the requested bounded change.
+/workflow review current diff
+/fresh task Implement the requested bounded change.</code></pre>
         </div>
       </div>
     </article>

package/docs-site/runtime.html

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

package/docs-site/scope.html

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