@piagent/platform 1.2.2 → 1.2.3

package/docs-site/security.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.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/team.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.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" />
@@ -97,7 +97,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/workflows.html

@@ -27,7 +27,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.2.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" />
@@ -95,7 +95,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">
@@ -105,37 +105,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/package.json

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

package/packages/piagent-core/README.md

@@ -5,7 +5,7 @@ Shared Pi package for reusable project workflows.
 ## Contents
 
 - `extensions/piagent-guard.ts`: runtime guard tools and policy hooks.
-- `prompts/*.md`: slash-command workflows.
+- `prompts/*.md`: workflow aliases that intentionally launch an agent turn.
 - `skills/piagent-ops/SKILL.md`: operating guidance for implementation tasks.
 - `skills/piagent-source-cache/`: local cache for user-provided external source repositories.
 - `subagents/*.md`: piagent roles for `pi-subagents`.
@@ -31,16 +31,19 @@ The wrapper can set `PIAGENT_PERMISSION_PROFILE` for one run:
 - `workspace-write`: normal guarded implementation mode.
 - `trusted-full-access`: trusted automation mode; protected paths, secret redaction, capability lock integrity, and destructive/external confirmations stay active.
 
-Inside Pi, slash commands can switch the current session without writing the project profile:
+Inside Pi, `/permission` can switch the current session without writing the project profile:
 
 ```text
-/permission-status
-/read-only
-/workspace-write
-/full-access
-/full-access Implement the requested trusted repo task.
+/permission
+/permission status
+/permission read-only
+/permission workspace-write
+/permission full-access
+/permission full-access Implement the requested trusted repo task.
 ```
 
+Legacy aliases still work: `/permission-status`, `/read-only`, `/workspace-write`, and `/full-access`.
+
 ## Runtime quality tools
 
 - `piagent_permission_status`
@@ -70,28 +73,25 @@ Inside Pi, slash commands can switch the current session without writing the pro
 - `piagent_verify_record` — records verify evidence only after matching an observed bash tool result after task start
 - `piagent_trace_record`
 
-## Prompt recipes
-
-- `/piagent-commands`: explain terminal, Pi, MCP, model, memory, and subagent commands in Vietnamese.
-- `/permission-status`, `/read-only`, `/workspace-write`, `/full-access`: inspect or switch the current session permission profile.
-- `/onboard-project`: first-run project context snapshot after login/model selection.
-- `/context-index`: inspect or search the compact project context index without a model follow-up.
+## Runtime commands and workflow recipes
+
+- `/commands`: runtime menu/help for terminal, Pi, MCP, model, memory, session, context, permission, and subagent commands.
+- `/workflow`: one launcher for task, scout, BE-to-FE, discuss, plan, review, commit, PR, platform-improve, and onboarding workflows.
+- `/usage`: runtime usage namespace for live snapshot, history hint, preflight, compact, and compact-log captures.
+- `/name`: set the current session name for Agent Watch/report mapping.
+- `/fresh`: open a fresh governed session for `task`, `scout`, or `be-to-fe`.
+- `/context`: runtime context namespace for context index status/search, task preflight, and compact.
+- `/permission`: runtime permission namespace for status/read-only/workspace-write/full-access.
+- `/onboard`: runtime onboarding namespace; `run` launches the first-read onboarding workflow.
+- `/context-index`: legacy alias for `/context index/search`.
 - `/profile`: show a short profile status, list options, apply a profile directly, or run select-style profile/tech setup without a model follow-up. Short aliases include `fe`, `be`, `full`, and `be-fe`.
 - `/profile tech`: show/select/apply the project tech stack for the active profile; fullstack setup selects frontend, backend, and database tech.
-- `/memory-policy`: inspect project memory policy and explicit remember workflow.
-- `/model-options`: explain model selector, scoped models, thinking levels, and benchmark discipline.
-- `/platform-improve`: improve package setup, runtime policy, docs, MCP, model, memory, or subagent workflows.
-- `/be-to-fe`: scout backend/spec read-only, then implement frontend only.
-- `/scout`: governed read-only scout/audit workflow.
-- `/task`: governed implementation lifecycle.
-- `/task-preflight`: check whether the active session should run, compact, or start fresh before large work.
-- `/piagent-logs`: show compact-log policy and recent oversized tool-output captures.
-- `/fresh-task`, `/fresh-scout`, `/fresh-be-to-fe`: start a fresh governed session and replay the compact workflow prompt.
-- `/commit`: create a guarded local commit from reviewed files only; no push.
-- `/pr`: prepare a pull request; push/PR creation still requires explicit operator confirmation.
-- `/plan`: bounded implementation plan.
-- `/discuss`: clarify a rough request before planning or editing.
-- `/review`: review source/diff with scope and verification checks.
+- `/memory` or `/memory-policy`: inspect project memory policy and explicit remember workflow.
+- `/model-options`: show model selector, scoped models, thinking levels, and benchmark discipline without a model follow-up.
+- `/logs`: short alias for `/usage logs`.
+- `/task-preflight`: legacy alias for `/context preflight`.
+- `/fresh-task`, `/fresh-scout`, `/fresh-be-to-fe`: legacy aliases for `/fresh ...`.
+- `/task`, `/scout`, `/be-to-fe`, `/platform-improve`, `/commit`, `/pr`, `/plan`, `/discuss`, `/review`: workflow aliases kept for power users; team docs should teach `/workflow ...` first.
 
 ## Subagents