@piagent/platform 1.5.5 → 1.6.1

package/docs/languages.json

@@ -21,8 +21,8 @@
       "en": "README.md",
       "vi": "README.vi.md",
       "consistentAt": {
-        "en": "1c890fe5b2a1f53f074b54f90d4610b5ed648242",
-        "vi": "6b7a18e5f6f18012a4d96a70b5e2815299629b05"
+        "en": "ec5765bc81848d3cd43806ef5a7003e8a23e3ad7",
+        "vi": "51d117e51003133b84540cb7ea732577f5a603d9"
       }
     },
     {
@@ -39,8 +39,8 @@
       "en": "docs/en/architecture.md",
       "vi": "docs/vi/architecture.md",
       "consistentAt": {
-        "en": "5bcb0aa311b360408ca73425744baee71e740a9b",
-        "vi": "b613cec25fa1737636121c11cb2c5aecb2e00375"
+        "en": "6a8a6f73bd6b0bde3fad00f0996426eaa101a8a9",
+        "vi": "580addecc766aa7317c3c49d9d740bc05f1bb43d"
       }
     },
     {

package/docs/model-options.md

@@ -54,7 +54,10 @@ Shift+Ctrl+P    # cycle ngược
 Shift+Tab       # cycle thinking level
 ```
 
-Global setup của repo sẽ seed `enabledModels` vào `~/.pi/agent/settings.json`, nên sau OAuth anh chọn/đổi model bằng option selector của Pi.
+Global setup của repo sẽ seed các preset đã kiểm chứng và một catch-all
+`openai-codex/*` vào `~/.pi/agent/settings.json`. Vì các preset đứng trước glob,
+chúng giữ thinking level khuyến nghị; model Codex mới trong authenticated catalog
+vẫn tự xuất hiện trong scope mà không cần chờ Piagent phát hành lại.
 
 ## Kiểm tra model hiện có
 
@@ -97,7 +100,7 @@ off, minimal, low, medium, high, xhigh, max
 Không phải model nào cũng hỗ trợ mọi level. Pi sẽ clamp theo capability của model. Cách chọn:
 
 ```bash
-pi --model openai-codex/gpt-5.5:high
+pi --model openai-codex/gpt-5.6-sol:high
 pi --model anthropic/claude-sonnet-5:xhigh
 pi --thinking medium
 ```
@@ -113,7 +116,7 @@ pi --thinking medium
 | `openai-codex/gpt-5.3-codex-spark` | fast scout | hỏi nhanh, thao tác nhỏ, chi phí thấp |
 | `openai-codex/gpt-5.4-mini` | fast/cheap | scout nhẹ, docs, simple fix |
 | `openai-codex/gpt-5.4` | balanced | task bình thường |
-| `openai-codex/gpt-5.5` | balanced/hard default | default mạnh cho implement |
+| `openai-codex/gpt-5.5` | balanced/hard | model thế hệ trước vẫn được hỗ trợ khi có trong authenticated catalog |
 | `openai-codex/gpt-5.6-luna` | cost-sensitive/high-volume | workload nhanh, nhiều lượt, ưu tiên latency và chi phí |
 | `openai-codex/gpt-5.6-terra` | balanced | công việc hằng ngày cần cân bằng capability, speed và cost |
 | `openai-codex/gpt-5.6-sol` | frontier/quality-first | task phức tạp, long-horizon hoặc cần chất lượng cao nhất |
@@ -143,7 +146,7 @@ available nào trong authenticated provider catalog.
 | Preset | Model OpenAI Codex | Model Claude (Anthropic) | Khi dùng |
 |---|---|---|---|
 | Fast scout | `openai-codex/gpt-5.4-mini:low` | `anthropic/claude-haiku-4-5:low` | đọc nhanh, hỏi đáp, grep/scout nhẹ |
-| Balanced implement | `openai-codex/gpt-5.5:medium` | `anthropic/claude-sonnet-5:medium` | task source bình thường |
+| Balanced implement | `openai-codex/gpt-5.6-terra:medium` | `anthropic/claude-sonnet-5:medium` | task source bình thường |
 | Cost-sensitive volume | `openai-codex/gpt-5.6-luna:medium` | `anthropic/claude-haiku-4-5:low` | workload nhanh, nhiều lượt; đo quality gate trước khi promote |
 | Balanced implement | `openai-codex/gpt-5.6-terra:high` hoặc `openai-codex/gpt-5.5:high` | `anthropic/claude-sonnet-5:high` | task source hằng ngày, cân bằng capability/cost |
 | Frontier/quality-first | `openai-codex/gpt-5.6-sol:high` | `anthropic/claude-opus-4-7:xhigh` hoặc `anthropic/claude-opus-4-8:xhigh` | architecture, long-horizon, high-risk review |
@@ -155,7 +158,7 @@ Tên model có thể đổi theo Pi model catalog. Khi không chắc, ưu tiên
 Global setup mặc định:
 
 ```bash
-piagent-model-scope --preset full --default-model openai-codex/gpt-5.5:high
+piagent-model-scope --preset full --default-model openai-codex/gpt-5.6-sol:high
 ```
 
 Scope này ghi vào settings:

package/docs/operator-manual-vietnamese.md

@@ -19,12 +19,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.84.1
-npm install -g --ignore-scripts @piagent/platform@1.5.5
+npm install -g --ignore-scripts @piagent/platform@1.6.1
 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.5.5`. 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.6.1`. 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:
 
@@ -100,7 +100,7 @@ install package once
 
 ```bash
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.84.1
-npm install -g --ignore-scripts @piagent/platform@1.5.5
+npm install -g --ignore-scripts @piagent/platform@1.6.1
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -283,7 +283,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.5.5 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.6.1 \
   --mcp-preset core \
   --subagents-preset safe
 ```
@@ -673,7 +673,8 @@ piagent-benchmark
 piagent-benchmark --production --dry-run
 ```
 
-Lệnh mặc định tự chạy 4 scenario trên Raw Pi và Piagent, mỗi bên 3 lần; token,
+Lệnh mặc định tự chạy 4 scenario trên Piagent và controlled `codex-cli` bằng
+Luna/medium, mỗi bên 3 lần; token,
 cost, model và thinking được đọc từ Pi session thay vì nhập tay. Runner chỉ cho
 phép kết luận tiết kiệm token khi safety đạt `10/10` và các gate quality,
 reliability, workflow của suite đều pass. Production yêu cầu các điểm tổng hợp
@@ -688,9 +689,10 @@ profile/lifecycle/difficulty và cận trên 95% của paired token ratio. Seed/
 động không đi vào agent workspace; root seed chỉ nằm trong private report để
 tái lập bằng `--seed`.
 
-Production runner mặc định retry tối đa hai lần, cách nhau 60 giây, chỉ khi process chết trước
-khi ghi usage. Timeout hoặc task đã tiêu token rồi fail vẫn là reliability failure thật,
-không được retry. Report hiện số retry và giữ chi tiết local trong
+Production/deep runner mặc định không retry và release gate yêu cầu đúng zero
+retry cùng zero unknown provider-attempt usage. Override retry chỉ dùng để chẩn
+đoán recovery và sẽ làm claim fail. Timeout hoặc task đã tiêu token rồi fail vẫn
+là reliability failure thật. Report hiện số retry và giữ chi tiết local trong
 `infrastructure-attempts.jsonl`. Dùng `--scenarios <id,id> --repeats 1` để debug
 rubric; subset không thể vượt production release gate.
 
@@ -922,13 +924,13 @@ Default safe config:
 
 - `toolDescriptionMode: compact`;
 - `asyncByDefault: false`;
-- `parallel.concurrency: 3`;
-- `parallel.maxTasks: 6`;
+- `parallel.concurrency: 1`;
+- `parallel.maxTasks: 1`;
 - `maxSubagentDepth: 1`;
-- `maxSubagentSpawnsPerSession: 32`;
+- `maxSubagentSpawnsPerSession: 1`;
 - scheduled runs off;
 - worktree base stable;
-- intercom bridge on.
+- wait/intercom bridge off; builtin và worker disabled.
 
 ### Piagent agents
 
@@ -936,13 +938,13 @@ Default safe config:
 |---|---|---|
 | `piagent-scout` | Map source/spec read-only. | No write. |
 | `piagent-planner` | Plan implementation + verify gates. | No write. |
-| `piagent-worker` | Implement approved bounded task. | Write in scope. |
+| `piagent-worker` | Compatibility metadata only; Piagent config disables it. | Không được dispatch. |
 | `piagent-reviewer` | Review diff/tests/scope. | Review-first. |
 | `piagent-oracle` | Risk/architecture challenge. | No write. |
 
 ### Auto-delegation
 
-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.
+Với `/workflow task`, `/workflow be-to-fe`, `/workflow platform-improve`, `/workflow plan`, `/workflow review`, parent agent tự suy luận và implement. Helper mặc định tắt. Khi operator bật rõ, runtime chỉ được dispatch một helper read-only, context fresh, nếu có ít nhất hai lane độc lập và projected net token saving từ 30% sau handoff/merge. Worker, retry, nested và parallel helper đều tắt. Alias cũ như `/task` giữ cùng policy.
 
 Kiểm tra nhanh policy:
 
@@ -952,13 +954,12 @@ Kiểm tra nhanh policy:
 
 Không cần tự gọi `/run` cho task bình thường. Chỉ dùng `/run` khi muốn ép rõ role hoặc debug.
 
-Parent nên spawn khi:
+Helper chỉ đủ điều kiện khi đồng thời:
 
-- cần scout codebase rộng;
-- cần map BE/spec read-only trước khi FE implement;
-- cần reviewer độc lập;
-- cần context builder cho task lớn;
-- cần oracle/risk challenge.
+- operator đã opt-in;
+- có ít nhất hai workstream độc lập và helper không phụ thuộc output tiếp theo của parent;
+- context chuyển giao fresh, tối đa 2.048 token và không inherit history;
+- tổng token parent + helper + handoff + merge được dự báo thấp hơn solo ít nhất 30%.
 
 Không nên spawn khi:
 
@@ -973,27 +974,15 @@ Không nên spawn khi:
 ```text
 /run piagent-scout "Map listing page state flow. Read-only."
 /run piagent-planner "Plan FE implementation from this backend contract."
-/run piagent-worker "Implement the approved plan. Do not touch backend."
 /run piagent-reviewer "Review current diff for correctness, tests, and scope drift."
 /run piagent-oracle "Challenge this architecture decision before implementation."
 ```
 
-Parallel read-only review:
-
-```text
-/parallel piagent-reviewer "Review correctness" -> piagent-reviewer "Review tests" -> piagent-reviewer "Review scope drift"
-```
-
-Chain:
-
-```text
-/chain piagent-scout "Scout target area" -> piagent-planner "Plan from {previous}" -> piagent-worker "Implement from {previous}" -> piagent-reviewer "Review implementation"
-```
+`/parallel`, `/chain` và writer role là capability upstream của package `pi-subagents`, nhưng Piagent config chủ động chặn các surface đó để tránh nhân context và token.
 
 Background:
 
 ```text
-/run piagent-scout "Map this module" --bg
 /subagents-fleet
 ```
 
@@ -1005,26 +994,19 @@ subagent({ action: "status", view: "fleet" })
 subagent({ action: "status", id: "<run-id>", view: "transcript" })
 subagent({ action: "steer", id: "<run-id>", message: "Focus only on tests." })
 subagent({ action: "stop", id: "<run-id>" })
-subagent({ action: "resume", id: "<run-id>", message: "Continue after this clarification." })
 ```
 
 Output file mode để giảm parent context:
 
 ```text
 /run scout[output=context.md,outputMode=file-only] "Map target area"
-/chain scout[output=context.md,as=context] "Scan" -> planner[reads=context.md] "Plan from {outputs.context}"
 ```
 
 ### Worktree isolation
 
-Chỉ bật writer parallel/worktree khi:
-
-- repo là Git repo;
-- worktree clean;
-- write sets không overlap;
-- parent review/merge outputs.
+Piagent không bật writer parallel/worktree; parent là writer duy nhất.
 
-Default solo/internal: một `piagent-worker`, parallel read-only reviewers/scouts.
+Default: parent là writer duy nhất; không worker, không parallel helper.
 
 ### Watchdog
 
@@ -1042,8 +1024,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.5.5` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.5.5` | Install pinned release cho reproducible team setup. |
+| `npm install -g --ignore-scripts @piagent/platform@1.6.1` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.6.1` | 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. |
@@ -1155,7 +1137,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.5.5
+npm install -g --ignore-scripts @piagent/platform@1.6.1
 command -v piagent-install
 ```
 

package/docs/project-adapters.md

@@ -66,8 +66,8 @@ Adapter mô tả project cho Pi core. Core không biết domain/project cụ th
 Path policy fields have distinct meanings:
 
 - `protectedPaths`: block read/write path-tool access and protect these paths from shell parsing when `shellProtectedPaths` is omitted.
-- `readOnlyPaths`: allow `read`/`grep`/`find`/`ls`, but block `write`/`edit` and shell access.
-- `shellProtectedPaths`: block shell access only. Do not rely on this field to block write/edit; `profile-doctor` and `team-doctor` warn when a path is present only here.
+- `readOnlyPaths`: allow `read`/`grep`/`find`/`ls`, but block `write`/`edit`/`apply_patch` and shell access.
+- `shellProtectedPaths`: block shell access only. Do not rely on this field to block `write`/`edit`/`apply_patch`; `profile-doctor` and `team-doctor` warn when a path is present only here.
 
 Glob trong các field này neo từ project root, nên `backend/**` chỉ khớp backend nằm ở root. Với monorepo, phải liệt kê đúng vị trí thật (`packages/api/**`, `services/*/**`). Không dùng `**/api/**`: nó khớp luôn `packages/web/src/api/` — thư mục HTTP client của frontend — và biến chính phần được phép sửa thành read-only.
 

package/docs/publishing-for-teams.md

@@ -98,6 +98,16 @@ pi install /path/to/piagent
   Inspector; projection Task Changes / Working Tree / Staged có bounded diff,
   provenance và enforce protected path; session lease bền, recovery khi restart
   hoặc owner cũ treo, doctor có repair tường minh.
+- `1.6.1`: patch ổn định runtime và chi phí — transcript chỉ hiện response khi
+  durable task đã terminal, Activity phân loại đúng retry/helper failure, review
+  repo ngoài chỉ nhận read grant session-scoped cho checkout chính xác, và direct
+  subagent bị khóa solo-first với một helper read-only có budget hữu hạn. Benchmark
+  thêm gate provider-free/Codex-relative nhưng không đưa ra claim chi phí mới.
+- `1.6.0`: context evidence khóa đúng turn/session/task run; WebUI có canonical
+  live state, watchdog và Stop an toàn qua reload/multi-tab; chat chỉ hiện kết
+  quả thành công còn retry/lỗi nằm trong Activity; deep-logic benchmark có bài
+  temporal billing nhiều package và accounting fail-closed. Release này không
+  đưa ra claim token mới vì production benchmark đã được operator dừng.
 - `1.5.5`: hotfix WebUI command execution — approval nhận đúng opaque tool-call
   ID, lệnh tìm kiếm không còn bị nhận nhầm thành migration, Stop hủy approval
   đang chờ, activity chỉ báo running sau khi command thật sự chạy, và restart