@piagent/platform 1.2.2 → 1.2.4

package/docs/context-window-policy.md

@@ -4,7 +4,7 @@
 
 Không nhồi toàn bộ repo vào context. Agent phải load đúng lớp context theo task.
 
-Lần đầu gắn project vào platform, chạy `/onboard-project` sau login/model selection để tạo `.pi/project-context.md` và `.pi/context-index.json`. Các task sau dùng context index như bản đồ nhỏ để tìm đúng vùng cần đọc, rồi vẫn verify bằng files task-specific hiện tại.
+Lần đầu gắn project vào platform, chạy `/onboard run` sau login/model selection để tạo `.pi/project-context.md` và `.pi/context-index.json`. Các task sau dùng context index như bản đồ nhỏ để tìm đúng vùng cần đọc, rồi vẫn verify bằng files task-specific hiện tại.
 
 ## Context order
 
@@ -29,11 +29,11 @@ piagent_context_index_status
 Trước task lớn/risk cao trong Pi TUI:
 
 ```text
-/task-preflight
-/task-preflight compact
+/context preflight
+/context compact
 ```
 
-Nếu recommendation là `fresh-session`, dùng `/fresh-task`, `/fresh-scout`, hoặc `/fresh-be-to-fe` thay vì tiếp tục nhồi context vào session hiện tại.
+Nếu recommendation là `fresh-session`, dùng `/fresh task`, `/fresh scout`, hoặc `/fresh be-to-fe` thay vì tiếp tục nhồi context vào session hiện tại.
 
 ## Context manifest
 
@@ -71,12 +71,12 @@ Pi settings template dùng:
 - Nếu task là source-write, phải biết verify command trước khi sửa.
 - Không paste full mandatory-flow boilerplate vào task hằng ngày; platform prompts/tools đã chứa flow đó.
 - Nếu context vượt budget, tạo summary theo module thay vì nhồi full files.
-- Dùng `/context-index` hoặc `piagent_context_index_search` để tìm điểm vào repo, nhưng không dùng index thay thế việc đọc source thật.
-- Không raw-read hoặc raw-edit `.pi/context-index.json` trong task thường ngày. Runtime coi index là advisory state, sanitize khi đọc qua tool/command, và ghi qua `/onboard-project` hoặc `piagent_context_index_record`.
+- Dùng `/context search` hoặc `piagent_context_index_search` để tìm điểm vào repo, nhưng không dùng index thay thế việc đọc source thật.
+- Không raw-read hoặc raw-edit `.pi/context-index.json` trong task thường ngày. Runtime coi index là advisory state, sanitize khi đọc qua tool/command, và ghi qua `/onboard run` hoặc `piagent_context_index_record`.
 - File context vượt hard cap phải được summarize hoặc đọc targeted slices, không inject full.
 - Nếu input quá dài thật, lưu intake vào file project/local gitignored rồi reference file; không dán toàn bộ spec vào một turn.
 - Nếu input chứa local screenshot/image path, để input guard attach thành `[image1]` thay vì đọc ảnh như text context. Ảnh lớn hơn giới hạn chat nên dùng Pi `read` để resize.
-- Tool output dài chỉ nên hiện preview. Dùng `/piagent-logs` hoặc command targeted hơn để debug; không paste full test/build log vào chat/final.
+- Tool output dài chỉ nên hiện preview. Dùng `/logs` hoặc command targeted hơn để debug; không paste full test/build log vào chat/final.
 - Memory chỉ là hint. Phải verify bằng source hiện tại trước khi sửa code.
 - Context index cũng chỉ là hint. Nó có node/edge/citation để giảm scout lại, không phải security boundary hoặc source of truth.
 

package/docs/distribution-standard.md

@@ -14,9 +14,9 @@ Repo này phải chạy được cho nhiều project/domain khác nhau. Vì vậ
 
 | Use case | Package source |
 |---|---|
-| Team pinned release | `git:github.com/Vt-mmm/piagent@v1.2.2` |
+| Team pinned release | `git:github.com/Vt-mmm/piagent@v1.2.4` |
 | Personal/sandbox dev | `git:github.com/Vt-mmm/piagent` |
-| Registry distribution | `npm:@piagent/platform@1.2.2` |
+| Registry distribution | `npm:@piagent/platform@1.2.4` |
 | Enterprise npm (fork under another scope) | `npm:@your-scope/platform@x.y.z` |
 | Local platform dev | `/path/to/piagent` |
 
@@ -26,7 +26,7 @@ Latest tiện cho máy cá nhân muốn nhận cập nhật nhanh. Pin tag/commi
 
 | Channel | Command | Target | Policy |
 |---|---|---|---|
-| `stable` | `bash scripts/install-global.sh --stable` | Helper release tag resolved to commit SHA, currently `v1.2.2` | Install the Pi package matching the helper. |
+| `stable` | `bash scripts/install-global.sh --stable` | Helper release tag resolved to commit SHA, currently `v1.2.4` | Install the Pi package matching the helper. |
 | `exact` | `bash scripts/install-global.sh --version vX.Y.Z --resolve-tag` | Requested tag resolved to commit SHA | Pi-package-only rollout, rollback, and incident recovery. |
 | `dev` | `bash scripts/install-global.sh --dev` | Moving Git source | Personal/sandbox only; do not commit into project settings. |
 | `local` | `bash scripts/install-global.sh --local` | Current checkout path | Platform development only. |
@@ -53,7 +53,7 @@ Root `package.json` có `pi` manifest trỏ tới:
 Do đó team có thể:
 
 ```bash
-pi install git:github.com/Vt-mmm/piagent@v1.2.2
+pi install git:github.com/Vt-mmm/piagent@v1.2.4
 ```
 
 Không cần biết internal folder `packages/piagent-core`. Source không pin chỉ dành cho personal/sandbox như bảng channel ở trên.
@@ -65,12 +65,12 @@ Team nên install global package một lần:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.82.0
-npm install -g --ignore-scripts @piagent/platform@1.2.2
+npm install -g --ignore-scripts @piagent/platform@1.2.4
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
 
-`pi install git:github.com/Vt-mmm/piagent@v1.2.2` vẫn hợp lệ nếu chỉ cần cài Pi package. Lệnh đó không tự tạo các binary terminal `piagent-*`; muốn có helper global thì dùng `npm install -g --ignore-scripts @piagent/platform@1.2.2`.
+`pi install git:github.com/Vt-mmm/piagent@v1.2.4` vẫn hợp lệ nếu chỉ cần cài Pi package. Lệnh đó không tự tạo các binary terminal `piagent-*`; muốn có helper global thì dùng `npm install -g --ignore-scripts @piagent/platform@1.2.4`.
 
 Support matrix hiện tại: macOS Apple Silicon + Bash và Linux x64 + Bash đã được verify; macOS Intel + Bash và Linux ARM64 + Bash là supported target cần chạy smoke trước rollout; native Windows chưa phải target rollout team; WSL2 experimental. Chi tiết và version runtime nằm trong [release/install policy](release-install-policy.md).
 
@@ -81,7 +81,7 @@ cd /path/to/project
 pi
 ```
 
-Project profile được chọn trong Pi bằng `/onboard-project` hoặc `/profile`, không bắt buộc chạy bash init.
+Project profile được chọn trong Pi bằng `/onboard` hoặc `/profile`, không bắt buộc chạy bash init. `/onboard` là menu runtime; dùng `/onboard run` khi muốn model đọc project lần đầu và ghi snapshot.
 
 Sau setup, bước first-run trong Pi là:
 
@@ -90,12 +90,29 @@ Sau setup, bước first-run trong Pi là:
 <select provider/model>
 /mcp
 /subagents-doctor
-/onboard-project
+/onboard
+/onboard run
+/context index
+/memory
 ```
 
-`/onboard-project` ghi `.pi/project-context.md`; đây là snapshot context dùng chung cho các task sau.
+`/onboard run` ghi `.pi/project-context.md`; đây là snapshot context dùng chung cho các task sau.
 Nó cũng ghi `.pi/context-index.json`; đây là compact advisory map có citation để agent tìm đúng điểm vào repo mà không scout rộng lại.
 
+Command hằng ngày nên dạy theo namespace mới:
+
+```text
+/commands
+/workflow task <request>
+/workflow scout <read-only request>
+/name <task/session name>
+/fresh task <request>
+/context preflight
+/usage
+```
+
+Các alias cũ như `/task`, `/scout`, `/context index`, `/fresh-task` vẫn chạy để không gãy session cũ, nhưng không dùng làm đường onboard chính cho team mới.
+
 ## Optional preseed setup
 
 Nếu muốn commit sẵn `.pi/piagent-profile.json` vào repo hoặc bootstrap bằng CI:
@@ -103,7 +120,7 @@ Nếu muốn commit sẵn `.pi/piagent-profile.json` vào repo hoặc bootstrap
 ```bash
 bash scripts/setup.sh /path/to/project \
   --profile be-readonly-fe \
-  --package-source git:github.com/Vt-mmm/piagent@v1.2.2 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.2.4 \
   --mcp-preset core \
   --subagents-preset safe
 ```
@@ -172,13 +189,34 @@ Files không commit:
 
 [Release/install policy](release-install-policy.md) là checklist canonical duy nhất. Production docs chỉ được promote sau khi tag đã tồn tại và stable dry-run resolve đúng commit SHA.
 
-Full platform update phải đồng bộ Pi host, npm-global helper và Pi package:
+Full platform update phải đồng bộ Pi host, npm-global helper và Pi package cho cả máy:
+
+```bash
+piagent-update --version X.Y.Z
+```
+
+Máy chưa có helper dùng bootstrap all-in-one:
+
+```bash
+npm exec -y --package @piagent/platform@X.Y.Z -- piagent-update --version X.Y.Z --force
+```
+
+Máy bị khóa npm global ở `/usr/local` không cần `sudo`: updater sẽ dùng prefix user-local `~/.pi/npm-global` hoặc maintainer có thể truyền `--npm-prefix <path>`.
+
+Project migration/doctor là bước kiểm tra sau global update, chỉ chạy cho repo cần xác minh:
+
+```bash
+piagent-update --version X.Y.Z --project /path/to/project
+```
+
+Sequence thủ công tương đương:
 
 ```bash
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.82.0
 npm install -g --ignore-scripts @piagent/platform@X.Y.Z
 piagent-install --stable --dry-run
 piagent-install --stable
+piagent-migrate /path/to/project --apply --remove-old
 piagent-doctor /path/to/project --strict-share
 ```
 

package/docs/herdr-workflow.md

@@ -50,10 +50,11 @@ Lần đầu trong project, mở pane Pi rồi chạy:
 ```text
 /login
 <select provider/model>
-/onboard-project
+/onboard
+/onboard run
 ```
 
-Sau khi `.pi/project-context.md` đã được ghi, mới chạy `/task` cho implementation.
+Sau khi `.pi/project-context.md` đã được ghi, mới chạy `/workflow task` cho implementation.
 
 Pane đề xuất:
 

package/docs/memory-policy.md

@@ -110,10 +110,13 @@ Mode hiện tại:
 
 ```text
 /login
-/onboard-project
-/memory-policy
+/onboard
+/onboard run
+/memory
 ```
 
+`/memory-policy` vẫn là alias để xem cùng runtime status.
+
 ### Ghi nhớ explicit
 
 ```text
@@ -125,7 +128,7 @@ Agent nên gọi `piagent_memory_note` với category `preference`.
 ### Trước implementation
 
 1. `piagent_context`
-2. `piagent_context_index_status` hoặc `/context-index` để lấy điểm vào repo nếu đã onboard
+2. `piagent_context_index_status` hoặc `/context index` để lấy điểm vào repo nếu đã onboard
 3. `piagent_memory_status`
 4. `piagent_memory_search` nếu task có keyword liên quan
 5. đọc repo files hiện tại để verify

package/docs/operator-manual-vietnamese.md

@@ -18,12 +18,12 @@ Support matrix release hiện tại: macOS Apple Silicon + Bash và Linux x64 +
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.82.0
-npm install -g --ignore-scripts @piagent/platform@1.2.2
+npm install -g --ignore-scripts @piagent/platform@1.2.4
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
 
-Khi seed `.pi/settings.json` cho team/repo cần audit lặp lại, giữ package source dạng pinned tag như `git:github.com/Vt-mmm/piagent@v1.2.2`. Máy cá nhân có thể dùng `git:github.com/Vt-mmm/piagent` để theo latest.
+Khi seed `.pi/settings.json` cho team/repo cần audit lặp lại, giữ package source dạng pinned tag như `git:github.com/Vt-mmm/piagent@v1.2.4`. Máy cá nhân có thể dùng `git:github.com/Vt-mmm/piagent` để theo latest.
 
 Nếu đang ở source checkout của platform, dùng helper theo channel để preview trước khi đổi:
 
@@ -99,7 +99,7 @@ install package once
 
 ```bash
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.82.0
-npm install -g --ignore-scripts @piagent/platform@1.2.2
+npm install -g --ignore-scripts @piagent/platform@1.2.4
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -204,14 +204,15 @@ Gợi ý:
 Sau `/login` và `/model`, chạy:
 
 ```text
-/piagent-commands
+/commands
 /mcp
 /subagents-doctor
-/onboard-project
-/memory-policy
+/onboard
+/onboard run
+/memory
 ```
 
-`/onboard-project` sẽ:
+`/onboard` mở menu/status runtime. `/onboard run` sẽ:
 
 1. đọc repo theo context budget;
 2. detect profile phù hợp;
@@ -233,7 +234,7 @@ File chính được tạo/cập nhật:
 .pi/memory/MEMORY.md
 ```
 
-Nếu `.pi/project-context.md` còn `Generated: not yet`, hoặc `/context-index` báo index đang pending/stale, không nên chạy `/task` implementation lớn. Chạy lại `/onboard-project` trước.
+Nếu `.pi/project-context.md` còn `Generated: not yet`, hoặc `/context index` báo index đang pending/stale, không nên chạy `/workflow task` implementation lớn. Chạy lại `/onboard run` trước.
 
 ### Đổi profile sau này
 
@@ -281,7 +282,7 @@ Không phải daily default. Dùng khi muốn tạo sẵn `.pi` files cho projec
 bash /path/to/piagent/scripts/setup.sh /path/to/project \
   --project-only \
   --profile auto \
-  --package-source git:github.com/Vt-mmm/piagent@v1.2.2 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.2.4 \
   --mcp-preset core \
   --subagents-preset safe
 ```
@@ -307,37 +308,37 @@ bash /path/to/piagent/scripts/configure-subagents.sh --preset safe
 ### Requirement chưa rõ
 
 ```text
-/discuss Cải tiến workflow onboarding cho team mới. Chưa implement, chỉ hỏi phần thiếu và đề xuất plan.
+/workflow discuss Cải tiến workflow onboarding cho team mới. Chưa implement, chỉ hỏi phần thiếu và đề xuất plan.
 ```
 
 ### Cần plan trước
 
 ```text
-/plan Implement header sale menu hover stabilization. Include scope, files, verify commands, and risks.
+/workflow plan Implement header sale menu hover stabilization. Include scope, files, verify commands, and risks.
 ```
 
 ### Task rõ, cho implement
 
 ```text
-/task Implement header sale menu hover stabilization. Add component tests and run relevant verify.
+/workflow task Implement header sale menu hover stabilization. Add component tests and run relevant verify.
 ```
 
 ### Scout/audit read-only
 
 ```text
-/scout Scout payment FE mapping vs BE contract. Backend read-only. Do not edit source.
+/workflow scout Scout payment FE mapping vs BE contract. Backend read-only. Do not edit source.
 ```
 
-Use `/scout` cho payment/auth/data/contract mapping khi mục tiêu là chốt evidence trước, chưa sửa code.
+Use `/workflow scout` cho payment/auth/data/contract mapping khi mục tiêu là chốt evidence trước, chưa sửa code.
 
 ### Task mới khi session đã nặng
 
-Nếu `/piagent-usage` cho thấy context cao, hoặc Pi báo context overflow, dùng fresh workflow:
+Nếu `/usage` cho thấy context cao, hoặc Pi báo context overflow, dùng fresh workflow:
 
 ```text
-/fresh-scout Scout payment FE mapping vs BE contract. Backend read-only. Do not edit source.
-/fresh-task Implement <bounded task>.
-/fresh-be-to-fe Implement FE support for <BE contract>. Backend read-only.
+/fresh scout Scout payment FE mapping vs BE contract. Backend read-only. Do not edit source.
+/fresh task Implement <bounded task>.
+/fresh be-to-fe Implement FE support for <BE contract>. Backend read-only.
 ```
 
 Các command này tự mở session mới và replay prompt workflow ngắn. Anh không cần tự chạy `pi --name ...` rồi paste lại.
@@ -349,7 +350,7 @@ Input guard của platform cũng tự collapse prompt có full `Mandatory flow`
 Nếu Pi/chat box không tạo native image attachment mà chỉ hiện local path kiểu `/var/folders/.../Ảnh màn hình ...png`, cứ để nguyên path trong prompt:
 
 ```text
-/scout Scout UI issue from screenshot /var/folders/.../screenshot.png
+/workflow scout Scout UI issue from screenshot /var/folders/.../screenshot.png
 ```
 
 Piagent guard sẽ xử lý trước khi model nhận input:
@@ -367,19 +368,19 @@ Nếu ảnh quá lớn, lưu ảnh nhỏ hơn hoặc yêu cầu agent dùng Pi `
 
 ```text
 /profile be-readonly-fe
-/be-to-fe Implement frontend support from backend endpoint/spec <name>. Backend is read-only.
+/workflow be-to-fe Implement frontend support from backend endpoint/spec <name>. Backend is read-only.
 ```
 
 ### Cải tiến platform
 
 ```text
-/platform-improve Improve MCP setup docs and subagent command guidance for team usage.
+/workflow platform-improve Improve MCP setup docs and subagent command guidance for team usage.
 ```
 
 ### Review trước final
 
 ```text
-/review current diff
+/workflow review current diff
 ```
 
 ### Commit và pull request
@@ -387,11 +388,11 @@ Nếu ảnh quá lớn, lưu ảnh nhỏ hơn hoặc yêu cầu agent dùng Pi `
 Git trong Pi Agent là capability + guard, không có namespace `/git-*`. Khi muốn gom việc hiện tại:
 
 ```text
-/commit docs: update onboarding notes
-/pr Add guarded git workflow
+/workflow commit docs: update onboarding notes
+/workflow pr Add guarded git workflow
 ```
 
-`/commit` inspect status/diff, stage đúng scope, verify phù hợp, rồi commit local; không push. `/pr` inspect branch/diff/commit rồi hỏi xác nhận trước khi `git push` hoặc tạo/cập nhật GitHub PR. Các lệnh stage rộng như `git add .`, `git add -A`, `git add --all`, `git add -- .`, `git add :/` cũng phải qua confirmation.
+`/workflow commit` inspect status/diff, stage đúng scope, verify phù hợp, rồi commit local; không push. `/workflow pr` inspect branch/diff/commit rồi hỏi xác nhận trước khi `git push` hoặc tạo/cập nhật GitHub PR. Alias `/commit` và `/pr` vẫn chạy cho power user. Các lệnh stage rộng như `git add .`, `git add -A`, `git add --all`, `git add -- .`, `git add :/` cũng phải qua confirmation.
 
 ## 5. Control flow của một task chuẩn
 
@@ -474,16 +475,16 @@ High-risk action phải human-gate:
 ### Trong Pi
 
 ```text
-/task-preflight
-/task-preflight compact
-/piagent-usage
-/piagent-logs
+/usage
+/context preflight
+/context compact
+/usage logs
 /session
 ```
 
-`/task-preflight` cho biết task tiếp theo nên chạy trực tiếp, compact trước, hay mở fresh session. `compact` dùng khi muốn Pi nén session có hướng dẫn giữ lại decisions/open blockers/verify command.
+`/context preflight` cho biết task tiếp theo nên chạy trực tiếp, compact trước, hay mở fresh session. `/context compact` dùng khi muốn Pi nén session có hướng dẫn giữ lại decisions/open blockers/verify command. Alias `/context preflight` và `/logs` vẫn chạy.
 
-`/piagent-usage` cho biết:
+`/usage` cho biết:
 
 - session file;
 - session id/name;
@@ -502,7 +503,7 @@ Piagent giữ nguyên output nhỏ. Khi `bash/grep/find/ls` hoặc tool result k
 - ghi capture local vào `.pi/piagent-state/tool-results/YYYY-MM-DD/*.log`;
 - ghi index `.pi/piagent-state/tool-results/index.jsonl` để Agent Watch/report đọc theo session/tool.
 
-Trong Pi, chạy `/piagent-logs` để xem policy compact và các capture mới nhất. Không paste full test/build log vào chat trừ khi user thật sự cần một đoạn cụ thể; dùng command targeted hoặc đọc capture/report ở ngoài Pi để debug sâu.
+Trong Pi, chạy `/logs` để xem policy compact và các capture mới nhất. Không paste full test/build log vào chat trừ khi user thật sự cần một đoạn cụ thể; dùng command targeted hoặc đọc capture/report ở ngoài Pi để debug sâu.
 
 ### Từ terminal khác
 
@@ -554,14 +555,14 @@ History mode đọc trực tiếp `~/.pi/agent/sessions/**/*.jsonl`. Mặc đị
 |---|---|
 | `< 50%` | Bình thường. |
 | `50-75%` | Tránh đọc file lớn không cần thiết. |
-| `> 75%` | Cân nhắc `/compact` trước task dài tiếp theo. |
+| `> 75%` | Cân nhắc `/context compact` trước task dài tiếp theo. |
 | Task chuyển từ implement sang deploy monitor | Nên tách session mới hoặc compact. |
 | Task đã xong nhưng CI cần follow lâu | Tách session monitor riêng để không kéo context cũ. |
 
 Trong Pi:
 
 ```text
-/compact
+/context compact
 ```
 
 Sau compact, agent phải đọc lại context quan trọng trước khi sửa tiếp.
@@ -632,17 +633,18 @@ pi --name "ABC-123 V-Nexus header menu fix"
 Nếu đã vào Pi rồi mới nhớ cần đổi tên, dùng command ngắn trong Pi:
 
 ```text
-/setname ABC-123 V-Nexus header menu fix
+/name ABC-123 V-Nexus header menu fix
 ```
 
 Trong Pi:
 
 ```text
 /session
-/piagent-usage
+/usage live
+/usage
 ```
 
-`/session` kiểm tra tên/id hiện tại. `/piagent-usage` in session id và session file. Ghi lại khi task dài hoặc có nhiều pane Herdr.
+`/session` kiểm tra tên/id hiện tại. `/usage live` và `/usage` in session id/name và session file. Ghi lại khi task dài hoặc có nhiều pane Herdr. Alias `/setname` vẫn chạy nếu muốn gõ thật ngắn.
 
 Nếu tắt terminal/app rồi mở lại:
 
@@ -651,7 +653,7 @@ cd /path/to/project
 pi --continue
 ```
 
-Nếu `--continue` không đúng phiên cần làm, mở selector bằng `pi --resume`, chọn theo session name đã đặt. Khi resume đúng session cũ, tên session vẫn là tên đã set; nếu cần chỉnh lại cho khớp task nội bộ thì chạy `/setname <new name>` ngay trước khi làm tiếp.
+Nếu `--continue` không đúng phiên cần làm, mở selector bằng `pi --resume`, chọn theo session name đã đặt. Khi resume đúng session cũ, tên session vẫn là tên đã set; nếu cần chỉnh lại cho khớp task nội bộ thì chạy `/name <new name>` ngay trước khi làm tiếp.
 
 ### Khi nào nên resume, continue, fork
 
@@ -659,9 +661,9 @@ Nếu `--continue` không đúng phiên cần làm, mở selector bằng `pi --r
 |---|---|
 | Tắt nhầm, muốn quay lại phiên gần nhất | `pi --continue` |
 | Không nhớ phiên nào | `pi --resume` |
-| Có session id/file từ `/piagent-usage` | `pi --session <id-or-file>` |
+| Có session id/file từ `/usage` | `pi --session <id-or-file>` |
 | Muốn thử hướng mới nhưng giữ history cũ | `pi --fork <id-or-file>` |
-| Muốn đổi tên phiên đang mở | `/setname <task/session name>` |
+| Muốn đổi tên phiên đang mở | `/name <task/session name>` |
 | Muốn session mới sạch sau task quá dài | `pi --name "<new task>"` |
 
 ## 9. MCP setup và cách dùng
@@ -792,7 +794,7 @@ Default safe config:
 
 ### Auto-delegation
 
-Với `/task`, `/be-to-fe`, `/platform-improve`, `/plan`, `/review`, parent agent dùng solo-first orchestration: lập task tree/review lenses trước, rồi chỉ spawn subagent khi có phần việc độc lập và đáng token.
+Với `/workflow task`, `/workflow be-to-fe`, `/workflow platform-improve`, `/workflow plan`, `/workflow review`, parent agent dùng solo-first orchestration: lập task tree/review lenses trước, rồi chỉ spawn subagent khi có phần việc độc lập và đáng token. Alias cũ như `/task` vẫn giữ cùng policy.
 
 Kiểm tra nhanh policy:
 
@@ -892,8 +894,8 @@ Watchdog là optional adversarial reviewer ở cuối turn, không bật mặc
 
 | Command | Dùng để |
 |---|---|
-| `npm install -g --ignore-scripts @piagent/platform@1.2.2` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.2.2` | Install pinned release cho reproducible team setup. |
+| `npm install -g --ignore-scripts @piagent/platform@1.2.4` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.2.4` | Install pinned release cho reproducible team setup. |
 | `pi install git:github.com/Vt-mmm/piagent` | Install latest platform package cho máy cá nhân/sandbox. |
 | Cài exact Pi host của release, rồi `npm install -g --ignore-scripts @piagent/platform@X.Y.Z` và `piagent-install --stable` | Full update: đồng bộ host, terminal helper và Pi package. Mỗi release pin một Pi host chính xác; lấy đúng version của release đang cài trong [release/install policy](release-install-policy.md). |
 | Cài exact Pi host ghi trong release cũ, rồi helper `vPREVIOUS` và `piagent-install --stable` | Full rollback; đánh giá lại dependency findings của host cũ trước khi hạ version. |
@@ -936,15 +938,19 @@ Watchdog là optional adversarial reviewer ở cuối turn, không bật mặc
 | `/model` / `Ctrl+L` | Chọn model. |
 | `Ctrl+P` | Cycle scoped models. |
 | `Shift+Tab` | Cycle thinking level. |
-| `/piagent-commands` | Xem command help theo ngữ cảnh. |
-| `/permission-status` | Xem permission profile hiện tại. |
-| `/read-only` | Chuyển session sang read-only. |
-| `/workspace-write` | Chuyển session sang write chuẩn. |
-| `/full-access` | Bật trusted full-access cho session hiện tại. |
-| `/full-access <task>` | Bật trusted full-access rồi gửi `<task>` cho agent làm tiếp. |
-| `/onboard-project` | Onboard/read project lần đầu. |
-| `/context-index` | Xem compact context index, không gọi model follow-up. |
-| `/context-index search <keyword>` | Tìm node/edge/citation trong context index. |
+| `/commands` | Menu/help command runtime theo topic. |
+| `/workflow` | Menu task/scout/review/git/onboard workflow. |
+| `/permission` | Menu permission status/read-only/workspace-write/full-access. |
+| `/permission status` | Xem permission profile hiện tại. |
+| `/permission read-only` | Chuyển session sang read-only. |
+| `/permission workspace-write` | Chuyển session sang write chuẩn. |
+| `/permission full-access` | Bật trusted full-access cho session hiện tại. |
+| `/permission full-access <task>` | Bật trusted full-access rồi gửi `<task>` cho agent làm tiếp. |
+| `/onboard` | Menu/status onboarding runtime. |
+| `/onboard run` | Onboard/read project lần đầu. |
+| `/context` | Menu context index/search/preflight/compact. |
+| `/context index` | Xem compact context index, không gọi model follow-up. |
+| `/context search <keyword>` | Tìm node/edge/citation trong context index. |
 | `/profile` | Xem profile ngắn, không gọi model follow-up. |
 | `/profile list` | Xem profile có sẵn dạng compact. |
 | `/profile <profile>` | Áp profile ngay và cập nhật lock. |
@@ -953,28 +959,31 @@ Watchdog là optional adversarial reviewer ở cuối turn, không bật mặc
 | `/profile tech` | Xem tech stack và Context7 status hiện tại. |
 | `/profile tech setup [profile]` | Chọn tech theo role; fullstack chọn FE/BE/DB. |
 | `/profile tech apply ...` | Apply profile/tech bằng một lệnh deterministic. |
-| `/memory-policy` | Xem memory policy. |
-| `/task-preflight` | Check context trước task lớn/risk cao. |
-| `/task-preflight compact` | Compact session có hướng dẫn. |
-| `/piagent-usage` | Snapshot context/session. |
+| `/memory` | Xem memory policy. |
+| `/context preflight` | Check context trước task lớn/risk cao. |
+| `/context compact` | Compact session có hướng dẫn. |
+| `/usage` | Snapshot context/session. |
+| `/usage logs` | Xem capture output dài đã compact. |
+| `/name` | Đặt/đổi tên session theo task để report dễ map. |
+| `/fresh` | Mở session mới cho task/scout/be-to-fe khi phiên hiện tại nặng. |
+| `/name <name>` | Đổi tên session cho resume/report. |
 | `/session` | Pi native session stats/info. |
-| `/compact` | Nén context. |
 | `/mcp` / `/mcp tools` | Check MCP. |
 | `/subagents-doctor` | Check subagent setup. |
 | `/subagents-fleet` | Follow child sessions. |
 | `/subagent-cost` | Check subagent token/cost. |
-| `/discuss` | Làm rõ, không sửa. |
-| `/plan` | Lập plan. |
-| `/scout` | Scout/audit read-only. |
-| `/fresh-scout` | Tự mở session mới rồi chạy `/scout`. |
-| `/fresh-task` | Tự mở session mới rồi chạy `/task`. |
-| `/fresh-be-to-fe` | Tự mở session mới rồi chạy `/be-to-fe`. |
-| `/task` | Implement task. |
-| `/be-to-fe` | BE read-only, FE implementation. |
-| `/platform-improve` | Cải tiến platform. |
-| `/review` | Review diff/source. |
-| `/commit [message/scope]` | Commit local qua workflow có guard. |
-| `/pr [title/request]` | Chuẩn bị PR, hỏi trước khi push/GitHub write. |
+| `/workflow discuss <request>` | Làm rõ, không sửa. |
+| `/workflow plan <goal>` | Lập plan. |
+| `/workflow scout <request>` | Scout/audit read-only. |
+| `/fresh scout <request>` | Tự mở session mới rồi chạy scout workflow. |
+| `/fresh task <request>` | Tự mở session mới rồi chạy task workflow. |
+| `/fresh be-to-fe <request>` | Tự mở session mới rồi chạy BE-to-FE workflow. |
+| `/workflow task <request>` | Implement task. |
+| `/workflow be-to-fe <request>` | BE read-only, FE implementation. |
+| `/workflow platform-improve <request>` | Cải tiến platform. |
+| `/workflow review [scope]` | Review diff/source. |
+| `/workflow commit [message/scope]` | Commit local qua workflow có guard. |
+| `/workflow pr [title/request]` | Chuẩn bị PR, hỏi trước khi push/GitHub write. |
 
 ## 12. Troubleshooting
 
@@ -993,7 +1002,7 @@ Mở lại Pi session sau khi install.
 Cài lại terminal helper đúng release rồi kiểm tra `PATH`:
 
 ```bash
-npm install -g --ignore-scripts @piagent/platform@1.2.2
+npm install -g --ignore-scripts @piagent/platform@1.2.4
 command -v piagent-install
 ```
 
@@ -1053,7 +1062,7 @@ bash /path/to/piagent/scripts/configure-subagents.sh --preset safe
 ### Context quá cao
 
 ```text
-/piagent-usage
+/usage
 /session
 ```
 
@@ -1071,7 +1080,7 @@ pi --name "Deploy monitor"
 
 ### Resume không đúng session
 
-Lấy session id/file từ `/piagent-usage`, rồi:
+Lấy session id/file từ `/usage`, rồi:
 
 ```bash
 pi --session <session-id>

package/docs/package-architecture-notes.md

@@ -80,13 +80,13 @@ Manifest data never executes code. Invalid paths, symbolic links, dependency cyc
 
 | Capability | Implementation |
 |---|---|
-| Project onboarding | `/onboard-project` + `piagent_project_onboarding_record` |
-| Project context index | `/context-index` + `piagent_context_index_*` |
+| Project onboarding | `/onboard run` + `piagent_project_onboarding_record` |
+| Project context index | `/context` + `piagent_context_index_*` |
 | Profile switching | `/profile` + `piagent_profile_options` / `piagent_profile_apply` |
-| Explicit memory | `/memory-policy` + `piagent_memory_*` |
-| Task lifecycle | `/task` + task/context/verify/trace tools |
-| Platform workflow | `/platform-improve` |
-| Backend-readonly to frontend | `/be-to-fe` |
+| Explicit memory | `/memory` + `piagent_memory_*` |
+| Task lifecycle | `/workflow task` + task/context/verify/trace tools |
+| Platform workflow | `/workflow platform-improve` |
+| Backend-readonly to frontend | `/workflow be-to-fe` |
 | Source cache | `piagent-source-cache` + `piagent_source_checkout` |
 | Subagent roles | `piagent-scout`, `piagent-planner`, `piagent-worker`, `piagent-reviewer`, `piagent-oracle` |
 | Quality benchmark | `scripts/quality-benchmark.sh` |

package/docs/project-adapters.md

@@ -91,7 +91,7 @@ Quy tắc:
 - Mọi key project tự khai **thay thế nguyên key** của adapter, không merge từng phần tử. Khai `protectedPaths` nghĩa là project sở hữu list đó và không nhận thay đổi từ adapter nữa.
 - Không khai `extends` thì profile giữ nguyên hành vi cũ, self-contained.
 
-`scripts/init-project.sh` và `/onboard-project` ghi dạng `extends` khi profile đến từ built-in adapter. Update platform sau đó không cần chạm vào project nào.
+`scripts/init-project.sh` và `/onboard` ghi dạng `extends` khi profile đến từ built-in adapter. Update platform sau đó không cần chạm vào project nào.
 
 ## Monorepo và workspace
 
@@ -133,7 +133,7 @@ Rule nằm ở `packages/piagent-core/extensions/project-shape.js`. Cả `piagen
 Default UX không bắt buộc chạy bash để set profile. Sau global install, vào project chạy:
 
 ```text
-/onboard-project
+/onboard
 ```
 
 Nếu chưa có `.pi/piagent-profile.json`, onboarding nên dùng select-style setup: chọn profile trước, rồi chọn tech theo role. Native command là:
@@ -158,7 +158,7 @@ Kết quả ghi:
 
 Sau khi agent đọc Context7 cho tech tương ứng, chỉ record snapshot ngắn bằng `piagent_profile_tech_context_record`; không lưu nguyên văn docs dài.
 
-`/onboard-project` cũng tạo `.pi/context-index.json`. Đây là advisory node/edge/citation map cho profile, tech, verify command, docs, risk và memory pointer; không dùng thay thế source hiện tại hoặc guard policy.
+`/onboard run` cũng tạo `.pi/context-index.json`. Đây là advisory node/edge/citation map cho profile, tech, verify command, docs, risk và memory pointer; không dùng thay thế source hiện tại hoặc guard policy.
 
 Đổi profile sau này:
 
@@ -185,7 +185,7 @@ Sau khi agent đọc Context7 cho tech tương ứng, chỉ record snapshot ng
 
 Auto detect là bootstrap convenience, không phải policy cuối cùng. Sau init, `.pi/piagent-profile.json` là source of truth của project.
 
-Mọi built-in adapter đều đưa `.pi/project-context.md` vào `requiredContext`. File này được tạo dạng placeholder khi init project, rồi được model thay bằng snapshot thật sau `/onboard-project`.
+Mọi built-in adapter đều đưa `.pi/project-context.md` vào `requiredContext`. File này được tạo dạng placeholder khi init project, rồi được model thay bằng snapshot thật sau `/onboard run`.
 
 ## Khi nào cần custom profile