@piagent/platform 1.9.3 → 1.11.0

package/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 This file records release-facing changes for Pi Agent Platform. Copy the relevant version block into GitHub Releases when publishing a tag.
 
+## v1.11.0 - 2026-10-05
+
+The dashboard keeps Piagent and Pi up to date itself, and works like an editor:
+a status bar, a command palette and Settings that can be searched.
+
+### Dashboard
+
+- Updates: the dashboard checks the registry when it opens and every 6 hours (the Gateway asks npm in the background; a source checkout and the company runtime never do). A newer release shows in the status bar ("Cập nhật Piagent X") and as a dot on Settings. Settings → Cập nhật shows Piagent and Pi as installed and as offered, when it last checked, and "Kiểm tra ngay".
+- One click updates Pi and Piagent together with `piagent-update`, after a confirmation that lists the change. Pi only ever moves to the version the new Piagent pins; a newer Pi is shown as not yet compatible. The button is locked while a conversation runs, and the update runs apart from the dashboard: when done, the dashboard restarts on the new release and opens in a new tab. Its output goes to `~/.pi/piagent-update-job.log`; a failure or an interrupted run is reported for a day. A release that changed the company launcher asks to connect the company key again in Agent Watch.
+- Status bar (wide screens): Gateway state, running conversations, the release and its update, and the command palette.
+- Command palette (⌘K / Ctrl+K): new chat, updates, the Workspace panel, Source Changes, theme, language, refresh, every Settings section and every conversation by name; matching ignores case and Vietnamese accents. ⌘, / Ctrl+, opens Settings.
+- Settings: a search box that finds a setting by what it does, sections grouped (Chung, Agent, Công cụ, Thông tin), a Shortcuts section, a description under each appearance setting, and the release at the foot of the list.
+
+## v1.10.0 - 2026-10-05
+
+A helper may object to the brief the main agent gave it. The main agent
+decides and has to answer; the same disagreement a second time goes to the
+member.
+
+### Managed team harness
+
+- Every helper (scout, research, verify, review) reads the member's request verbatim, and the current plan, above the main agent's brief. A short follow-up such as "tiếp tục" brings the earlier message that states the task. Before, a helper saw only the brief, and a brief that dropped part of the request could not be seen to drift; the harness's own review after "tiếp tục" was told the request was "tiếp tục".
+- A helper ends its answer with `brief_issues` (wrong premise, conflicts with the request, ambiguous, out of scope), each with evidence. It objects only when acting on the brief as written would give a wrong or wasted answer; a guess the brief marks as a guess ("if any", "for example") is not an objection. The harness shows the objection in the conversation and adds a note to the main agent: answer it with a corrected brief, another approach, or a reason. An objection that no corrected brief followed is asked about once before the turn ends.
+- Objections to a brief the harness wrote itself (its review, its re-check) are not relayed: they only restate the member's request.
+- A second objection from the same helper for one message ends the exchange: the member decides, and the helper is refused (`managed-helper-disputed`) until the member's next message.
+- With a required review, an agent that answers a blocking finding instead of changing the code has its answer judged by the reviewer, who keeps or withdraws the finding. A kept finding goes to the member. A re-review after a fix also reads the answer that came with it.
+- With a required verify, a claim the verify helper marked failed goes back to the agent once, then the verify helper checks it again with the agent's answer. A claim outside the member's request that the result does not depend on is set aside as unverifiable; a claim that still fails goes to the member.
+- A turn whose disagreement went to the member ends as `disputed`, with or without a code change. Process report version 3 adds `objections`, `objections_answered` and `disputes`; a Studio or Agent Watch that does not list it receives version 2 with the outcome it had before.
+
+- The main agent asks the member when the request leaves a decision open (`ask_user`): 1–4 questions, each with 2–4 numbered options and "Other" in the member's own words. It waits for the answer, then goes on with it. In the Terminal each question is a selector; with no screen to ask on, the agent states the assumption it makes and goes on.
+- A question the member stopped before answering (or whose screen went away) tells the agent the decisions are still the member's: on "tiếp tục" it asks again instead of choosing for them. The tool also says not to add an "Other" option of its own.
+- A helper's receipt (its tokens, the patch it read) stays in the conversation for the member but is no longer part of the main agent's context, where it read as a message from the member ("you sent a line 'Review: … tokens'").
+- A check command that fails by returning an error result, rather than throwing, counts as a failed check (main agent, network commands and helper checks), so a required check never passes on a failing run.
+- A helper refused for its account's usage, resting, or whose account went away starts once more, and Studio gives it the next model of its role (a Harness "Model dự phòng").
+- A patch larger than one reviewer reads (120 KB) is reviewed in parts of whole files, one after another under the review grant, and the findings merge. A file too large to read, or a repository cloned inside the project, is named as not read instead of stopping the review.
+- Requests of one role running side by side share one grant renewal, so none voids another's token. The main agent's prompt cache key follows the conversation, not the turn.
+
+### Dashboard
+
+- A question from the main agent is a card above the conversation: numbered options with their meaning, "Khác" with a text field, "Để agent tự quyết" and "Gửi câu trả lời". Number keys choose, Enter sends; the turn shows "chờ bạn trả lời câu hỏi" while it waits. A company conversation's question is read and answered through the company Gateway; a card answered in another tab, or withdrawn, leaves within seconds. A waiting question keeps the turn alive past the 15-minute silence limit.
+- A tab whose browser session was replaced by a newer launch in the same browser (Agent Watch's WebUI button clicked again) no longer has every change refused: a refused change reads the browser's current session once and is sent again.
+- Objections, the reviewer judging an answer, failed claims and disagreements appear in the turn; the conversation row says "Cần bạn quyết". A step that asks nothing of the agent no longer hides its last answer behind "this turn has no answer".
+- Harness roles are named Subagent scout, research, verify and review, and process notes keep the usual English terms (check, fix, blocking, claim, plan).
+
 ## v1.9.3 - 2026-10-03
 
 Typing Vietnamese no longer sends or creates twice, and helpers read less of

package/README.md

@@ -346,7 +346,7 @@ This repository intentionally excludes:
 
 ## Maturity
 
-The current package version is read from package metadata and release tags. Personal machines may follow the unpinned package source when accepting ongoing updates; production/team quickstarts and committed project settings should pin an explicit tag such as `v1.9.3` or a reviewed commit.
+The current package version is read from package metadata and release tags. Personal machines may follow the unpinned package source when accepting ongoing updates; production/team quickstarts and committed project settings should pin an explicit tag such as `v1.11.0` or a reviewed commit.
 
 Ready for:
 

package/README.vi.md

@@ -175,7 +175,7 @@ Xem [bằng chứng benchmark](https://piagent.io.vn/benchmark) và
 
 Gate này chạy architecture check, test, typecheck, capability validation, runtime smoke và docs consistency trước khi release.
 
-Bản phát hành hiện tại là `v1.9.3`. Với team hoặc production, hãy pin tag này
+Bản phát hành hiện tại là `v1.11.0`. Với team hoặc production, hãy pin tag này
 hoặc một commit đã review thay vì dựa vào nguồn package không cố định.
 
 ## Security

package/docs/command-reference-vietnamese.md

@@ -473,8 +473,8 @@ Các lệnh này chạy ngoài Pi.
 | Command | Dùng khi nào |
 |---|---|
 | `npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1` | Cài Pi CLI tương thích với release hiện tại. |
-| `npm install -g --ignore-scripts @piagent/platform@1.9.3` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.9.3` | Cài pinned release khi cần reproducible team setup. |
+| `npm install -g --ignore-scripts @piagent/platform@1.11.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.11.0` | Cài pinned release khi cần reproducible team setup. |
 | `pi install git:github.com/Vt-mmm/piagent` | Cài latest package platform cho máy cá nhân/sandbox. |
 | `piagent-update --check` | Báo version hiện tại vs version sẽ lên cho cả ba thành phần; không cài gì. |
 | `piagent-update` | Full update global một lệnh cho cả máy: Pi host → npm-global helper → Pi package, đúng thứ tự release yêu cầu. |

package/docs/distribution-standard.md

@@ -15,9 +15,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.9.3` |
+| Team pinned release | `git:github.com/Vt-mmm/piagent@v1.11.0` |
 | Personal/sandbox dev | `git:github.com/Vt-mmm/piagent` |
-| Registry distribution | `npm:@piagent/platform@1.9.3` |
+| Registry distribution | `npm:@piagent/platform@1.11.0` |
 | Enterprise npm (fork under another scope) | `npm:@your-scope/platform@x.y.z` |
 | Local platform dev | `/path/to/piagent` |
 
@@ -54,7 +54,7 @@ Root `package.json` có `pi` manifest trỏ tới:
 Do đó team có thể:
 
 ```bash
-pi install git:github.com/Vt-mmm/piagent@v1.9.3
+pi install git:github.com/Vt-mmm/piagent@v1.11.0
 ```
 
 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.
@@ -66,12 +66,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.87.1
-npm install -g --ignore-scripts @piagent/platform@1.9.3
+npm install -g --ignore-scripts @piagent/platform@1.11.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
 
-`pi install git:github.com/Vt-mmm/piagent@v1.9.3` 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.9.3`.
+`pi install git:github.com/Vt-mmm/piagent@v1.11.0` 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.11.0`.
 
 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).
 
@@ -118,7 +118,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.9.3 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.11.0 \
   --mcp-preset core \
   --subagents-preset safe
 ```

package/docs/en/architecture.md

@@ -37,7 +37,7 @@ The machine-readable rule is `architecture/layers.json`; `npm run architecture:c
 | Layer | Current location | Owns | Must not own |
 |---|---|---|---|
 | Composition | `packages/piagent-core/extensions/piagent-guard.ts` | Wiring, dependency construction, registration order | Feature algorithms, mutable state implementations, large formatters |
-| Managed harness | `packages/piagent-core/managed/` | Company sessions imported by Agent Watch: Studio grants, sandboxed tool worker, research/review helpers, web search/fetch | Personal OAuth, personal extensions, Studio policy decisions |
+| Managed harness | `packages/piagent-core/managed/` | Company sessions imported by Agent Watch: Studio grants, sandboxed tool worker, scout/research/verify/review helpers and their objections to a brief, web search/fetch | Personal OAuth, personal extensions, Studio policy decisions |
 | Runtime adapters | `packages/piagent-core/runtime/` | Pi lifecycle hooks, shared session state, command/tool registration, input routing | Reusable policy decisions |
 | Core services | `packages/piagent-core/extensions/` except the entrypoint | Policy, context, task lifecycle, state services | Pi command menus and UI text |
 | MCP integration | `packages/piagent-core/mcp/` | MCP config layers, readiness, approval, command actions | Task and context policy |

package/docs/languages.json

@@ -21,8 +21,8 @@
       "en": "README.md",
       "vi": "README.vi.md",
       "consistentAt": {
-        "en": "fcf5b77a45f8a2d44e6f016f7f238418d5cd2e9e",
-        "vi": "ef230fb0d02c48d2f87e8204a29644e2900f6e4c"
+        "en": "524743fb71b0a1bcb7c7f65146cb574753823295",
+        "vi": "c52264098917ae33e9025d91fde3387448c58af7"
       }
     },
     {
@@ -39,8 +39,8 @@
       "en": "docs/en/architecture.md",
       "vi": "docs/vi/architecture.md",
       "consistentAt": {
-        "en": "a72c2c8d0e7fad9f4c07dc6eada800dcbd25ccc8",
-        "vi": "82fed394080eb406268135a1e7d981c11938d230"
+        "en": "932086b9d8bf0ccc370d898f945a347b0442e295",
+        "vi": "2023f60b40e2fd6025985e84967eec412b2636d8"
       }
     },
     {

package/docs/managed-local-acceptance.md

@@ -3,6 +3,41 @@
 
 This is the local implementation under test, not a published release. Studio owns team/key/model authority and usage; Watch imports the connection and brokers credentials; Piagent executes the selected main/research/review harness. Personal OAuth stays in a separate runtime.
 
+## 2026-10-03 — helpers object to a wrong brief; disagreements go to the member
+
+The owner approved the rule:
+- a helper may object to the main agent's brief, with evidence, but never decides;
+- the main agent decides and must answer;
+- the same disagreement a second time goes to the member.
+
+Branch `helper-objections`, installed locally as 1.9.3 with the change, together with Studio (process report v3) and a new Agent Watch build. Nothing committed or published.
+
+- **Live cases.** 16 runs through the real Studio, Agent Watch broker and models:
+  - Harness: all steps required, two fix rounds;
+  - roles: scout mimo-v2.6-flash, research deepseek-v4.1-flash, verify hy3, review claude-sonnet-5, main claude-sonnet-5-5.
+
+  Some cases plant a wrong brief where the main agent hands work to a helper, to see whether the real helper catches it. The planted brief is written into the main agent's own tool call too, so the main agent reads it as its own.
+- **Caught and answered.**
+  - A member's wrong function name passed on to the scout: `wrong_premise`. The agent turned to the real function.
+  - A brief that would change a signature the member asked to keep: `conflicts_with_request`. The agent kept the signature and said the scout was right.
+  - A brief that stayed wrong after a corrected brief: a second objection. The member was told, the helper was not asked again, and the run reported `disputed`.
+  - A failed verify claim went back to the agent. The agent fixed the cause, and the harness's re-check passed.
+  - A claim outside the request that the agent never made was set aside as unverifiable on re-check, with no dispute.
+  - A reviewer's false blocking finding (simulated) was answered without a code change. The reviewer read the answer and withdrew the finding.
+- **Precision.**
+  - A sound scout brief drew a `wrong_premise` objection over a hedged guess ("if any, e.g. tax, shipping"). The brief check now says a marked guess is not an objection; the rerun had none.
+  - Sound research briefs drew none.
+  - The real reviewer twice refused a planted "team rule" that conflicted with the member's request, so no wrong blocking finding was produced.
+- **Fixed during the run.**
+  - Objections to the harness's own briefs (its review, its verify re-check) only restated the member's request. One was counted as a second objection, which produced a false dispute. They are no longer relayed.
+  - The verify re-check now lets a claim outside the request be marked unverifiable.
+  - The timeline kept a turn's last answer as a step when a quiet note followed it, and showed "this turn has no answer". Objection, rejudge and dispute notes now leave the answer in place.
+- **"tiếp tục".** After a stopped turn and "tiếp tục", the harness review read the original request as "Earlier message". Before, it read only "tiếp tục".
+- **Report.**
+  - After the new Agent Watch was approved in Keychain, the broker advertised `process-v3`. Studio stored `version 3, outcome disputed, objections 2, objections_answered 1, disputes 1` for an unchanged run.
+  - Older brokers keep receiving version 2 with the outcome they had before.
+- **Cost.** 16 runs used about 230 live trial requests.
+
 ## 2026-10-02 — a message after Stop: the busy Gateway, and Gateways started beside it
 
 Before pushing 1.9.0 the owner asked for one more long fleet round to hunt the one open defect: a dashboard page that, after Stop, could not send ("no answer" three turns in a row, or a composer locked for minutes). Committed on `release/v1.9.0` with the release; nothing pushed or published.

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.87.1
-npm install -g --ignore-scripts @piagent/platform@1.9.3
+npm install -g --ignore-scripts @piagent/platform@1.11.0
 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.9.3`. 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.11.0`. 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.87.1
-npm install -g --ignore-scripts @piagent/platform@1.9.3
+npm install -g --ignore-scripts @piagent/platform@1.11.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -285,7 +285,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.9.3 \
+  --package-source git:github.com/Vt-mmm/piagent@v1.11.0 \
   --mcp-preset core \
   --subagents-preset safe
 ```
@@ -999,8 +999,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.9.3` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
-| `pi install git:github.com/Vt-mmm/piagent@v1.9.3` | Install pinned release cho reproducible team setup. |
+| `npm install -g --ignore-scripts @piagent/platform@1.11.0` | Cài terminal helper `piagent-*` từ release tag hiện tại. |
+| `pi install git:github.com/Vt-mmm/piagent@v1.11.0` | 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. |
@@ -1096,7 +1096,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.9.3
+npm install -g --ignore-scripts @piagent/platform@1.11.0
 command -v piagent-install
 ```
 

package/docs/publishing-for-teams.md

@@ -41,6 +41,8 @@ pi install /path/to/piagent
 
 ## Versioning
 
+- `1.11.0`: dashboard tự kiểm tra bản mới (khi mở và mỗi 6 giờ) và cập nhật Pi + Piagent bằng một nút, Pi luôn lên đúng bản Piagent yêu cầu, khoá khi đang có lượt chạy; thanh trạng thái kiểu IDE, bảng lệnh ⌘K/Ctrl+K, ⌘,/Ctrl+, mở Cài đặt; Cài đặt có ô tìm kiếm, nhóm mục và mục Phím tắt. Máy đang ở 1.10.0 cập nhật tay một lần; từ 1.11.0 bấm nút trong dashboard.
+- `1.10.0`: main agent hỏi lại khi yêu cầu còn để ngỏ một quyết định (thẻ câu hỏi có lựa chọn đánh số, "Khác" và "Để agent tự quyết"); subagent được phản biện brief, bất đồng lần hai thì member quyết (báo cáo quy trình v3 cần Studio và Agent Watch mới, bản cũ vẫn nhận v2); subagent tự chạy lại trên model dự phòng khi hết quota; patch lớn được review theo từng phần; tab dashboard cũ không còn bị từ chối khi dashboard được mở lần nữa trong cùng trình duyệt.
 - `1.9.3`: Enter khi gõ tiếng Việt (bộ gõ đang chốt chữ) không còn gửi tin hay tạo cuộc trò chuyện; bấm Enter hai lần chỉ tạo một cuộc trò chuyện và gửi một tin; subagent đọc tối đa 20.000 ký tự mỗi trang web (main giữ 100.000).
 - `1.9.2`: ở chế độ công ty có subagent nghiên cứu, việc trên web do subagent này làm (main agent không còn công cụ web); kết quả search ghi rõ engine (Tavily, Exa, Parallel); agent tự giới thiệu là Piagent; dashboard không còn giật lên đầu khi gửi tin nhắn; bộ đếm subagent theo số Harness bật.
 - `1.9.1`: subagent khảo sát và xác minh cho tài khoản công ty (chỉ khi Harness bật); tìm web qua search pool của Studio cho mọi vai; gửi `piagent/<version>` cho Studio. Sandbox công ty: đọc được `auth.json` nằm trong source (file dịch); giấu hẳn `.env*` (trừ file mẫu) để Vite/Vitest/Next vẫn chạy; ở thư mục không có git, lệnh chỉ đọc không còn bị tính là sửa code; E2E chạy qua `run_with_network`; bộ cài không gợi ý lệnh đã bỏ.

package/docs/release-install-policy.md

@@ -153,7 +153,7 @@ Use this flow when the team needs both terminal commands and the Pi package:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.9.3
+npm install -g --ignore-scripts @piagent/platform@1.11.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```
@@ -179,7 +179,7 @@ bash scripts/install-global.sh --stable
 Use this only when terminal commands are not needed:
 
 ```bash
-pi install git:github.com/Vt-mmm/piagent@v1.9.3
+pi install git:github.com/Vt-mmm/piagent@v1.11.0
 ```
 
 Direct `pi install` does not create `piagent-*` commands on `PATH`.

package/docs/team-onboarding.md

@@ -10,7 +10,7 @@ Một thành viên mới không cần biết local path của maintainer. Luồn
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.9.3
+npm install -g --ignore-scripts @piagent/platform@1.11.0
 piagent-install --stable
 cd /path/to/project
 pi
@@ -45,7 +45,7 @@ Mặc định team dùng stable helper:
 ```bash
 node --version  # >= 22.19.0
 npm install -g --ignore-scripts @earendil-works/pi-coding-agent@0.87.1
-npm install -g --ignore-scripts @piagent/platform@1.9.3
+npm install -g --ignore-scripts @piagent/platform@1.11.0
 piagent-install --stable --dry-run
 piagent-install --stable
 ```

package/docs/vi/architecture.md

@@ -37,7 +37,7 @@ Rule máy đọc nằm tại `architecture/layers.json`; chạy `npm run archite
 | Layer | Vị trí hiện tại | Ownership | Không được chứa |
 |---|---|---|---|
 | Composition | `packages/piagent-core/extensions/piagent-guard.ts` | Wiring, dependency construction, thứ tự registration | Feature algorithm, mutable state implementation, formatter lớn |
-| Managed harness | `packages/piagent-core/managed/` | Phiên công ty do Agent Watch nhập: grant Studio, tool worker trong sandbox, helper research/review, web search/fetch | OAuth cá nhân, extension cá nhân, quyết định chính sách của Studio |
+| Managed harness | `packages/piagent-core/managed/` | Phiên công ty do Agent Watch nhập: grant Studio, tool worker trong sandbox, helper scout/research/verify/review và phản biện brief của chúng, web search/fetch | OAuth cá nhân, extension cá nhân, quyết định chính sách của Studio |
 | Runtime adapters | `packages/piagent-core/runtime/` | Pi lifecycle hook, shared session state, command/tool registration, input routing | Policy decision dùng lại |
 | Core services | `packages/piagent-core/extensions/` trừ entrypoint | Policy, context, task lifecycle, state service | Pi command menu và UI text |
 | MCP integration | `packages/piagent-core/mcp/` | MCP config layer, readiness, approval, command action | Task và context policy |

package/docs-site/architecture.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/architecture" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/architecture" hreflang="en" lang="en">EN</a>

package/docs-site/benchmark.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/benchmark" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/benchmark" hreflang="en" lang="en">EN</a>

package/docs-site/commands.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/commands" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/commands" hreflang="en" lang="en">EN</a>

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

@@ -1,5 +1,5 @@
 <section class="hero">
-  <p class="eyebrow">Piagent 1.9.3</p>
+  <p class="eyebrow">Piagent 1.11.0</p>
   <h1>A coding agent for the whole team, checked at every step.</h1>
   <p>
     One dashboard for Terminal and the browser. Use models with your own account, or the company's models through Agent Watch and Agent Studio. The guard checks every tool call; in company mode the team's Harness asks for checks, has a subagent review the change and reports the outcome right under the answer.
@@ -13,7 +13,7 @@
   <div class="hero-actions">
     <a class="button primary" href="/en/quickstart">Get started</a>
     <a class="button" href="/en/ecosystem">Ecosystem</a>
-    <a class="button" href="/en/whats-new">What’s new in 1.9.3</a>
+    <a class="button" href="/en/whats-new">What’s new in 1.11.0</a>
     <a class="button" href="/en/commands">View commands</a>
   </div>
 </section>
@@ -89,9 +89,9 @@ piagent-setup</code></pre>
   <h2 id="where-to-start">Where to start</h2>
   <div class="card-grid">
     <a class="doc-card" href="/en/whats-new">
-      <span class="card-kicker">Release 1.9.3</span>
+      <span class="card-kicker">Release 1.11.0</span>
       <h3>What’s new</h3>
-      <p>Typing Vietnamese never sends by mistake and subagents read leaner pages; in 1.9.2: web work goes to the research subagent and the chat stays put.</p>
+      <p>One-click updates of Pi and Piagent, a ⌘K command palette and searchable Settings; in 1.10.0: the main agent asks when it is unsure and subagents may object to a brief.</p>
     </a>
     <a class="doc-card" href="/en/ecosystem">
       <span class="card-kicker">Get started</span>

package/docs-site/content/en/whats-new.html

@@ -1,3 +1,25 @@
+<section class="section">
+  <p class="section-kicker">v1.11.0 · 2026-10-05</p>
+  <h2 id="v1-11-0">One-click updates, and a dashboard that works like an editor</h2>
+  <p class="section-lead">The dashboard checks for new releases and updates Pi and Piagent together when you click. A status bar, a command palette and searchable Settings keep every action a keystroke away.</p>
+  <div class="grid cols-3">
+    <article class="card"><h3 id="one-click-update">One-click update</h3><p>The dashboard checks when it opens and every 6 hours. A new release shows as "Update Piagent" in the status bar; one click installs Pi and Piagent together and reopens the dashboard in a new tab. Pi always moves to the version Piagent is qualified on, and the button waits while a conversation runs.</p></article>
+    <article class="card"><h3 id="command-palette">Command palette</h3><p>⌘K or Ctrl+K reaches every action, every settings section and every conversation by name, with or without Vietnamese accents. ⌘, or Ctrl+, opens Settings.</p></article>
+    <article class="card"><h3 id="settings-search">Searchable Settings</h3><p>Search finds a setting by what it does; sections are grouped, with new Updates and Shortcuts sections. The status bar shows the Gateway, running conversations and the release.</p></article>
+  </div>
+</section>
+
+<section class="section">
+  <p class="section-kicker">v1.10.0 · 2026-10-05</p>
+  <h2 id="v1-10-0">The main agent asks when it is unsure, and subagents may object to a brief</h2>
+  <p class="section-lead">When a request leaves a decision open, the main agent asks you with a card of numbered choices instead of guessing. A subagent shows its evidence when a brief drifts from the request, and a second disagreement is yours to decide. Used-up quota or a very large patch no longer stops the work.</p>
+  <div class="grid cols-3">
+    <article class="card"><h3 id="ask-user">Questions with choices</h3><p>1–4 questions, each with 2–4 numbered choices, always "Other" in your own words and "Let the agent decide". Press a number to choose, Enter to send. Stop while it waits, and on "continue" the agent asks again instead of choosing for you.</p></article>
+    <article class="card"><h3 id="objections">Subagents object to a brief</h3><p>A subagent reads your request verbatim and the plan above its brief. When the brief is wrong or drifts from the request it shows its evidence, and the main agent has to answer. A second disagreement marks the conversation "needs your decision".</p></article>
+    <article class="card"><h3 id="fallback">Work goes on when quota runs out</h3><p>A subagent whose quota is used up, or whose account rests, starts again on the Harness fallback model. A patch over 120 KB is reviewed in parts and the findings merge.</p></article>
+  </div>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.9.3 · 2026-10-03</p>
   <h2 id="v1-9-3">Typing Vietnamese never sends by mistake, and subagents read leaner pages</h2>

package/docs-site/content/index.html

@@ -1,5 +1,5 @@
 <section class="hero">
-  <p class="eyebrow">Piagent 1.9.3</p>
+  <p class="eyebrow">Piagent 1.11.0</p>
   <h1>Coding agent cho cả team, kiểm tra từng bước.</h1>
   <p>
     Một dashboard cho Terminal và trình duyệt. Dùng model bằng tài khoản của bạn, hoặc model của công ty qua Agent Watch và Agent Studio. Guard kiểm tra từng tool call; ở chế độ công ty, Harness của team tự yêu cầu chạy check, cho subagent review và báo kết quả ngay dưới câu trả lời.
@@ -13,7 +13,7 @@
   <div class="hero-actions">
     <a class="button primary" href="/quickstart">Bắt đầu</a>
     <a class="button" href="/ecosystem">Hệ sinh thái</a>
-    <a class="button" href="/whats-new">Có gì mới trong 1.9.3</a>
+    <a class="button" href="/whats-new">Có gì mới trong 1.11.0</a>
     <a class="button" href="/commands">Xem command</a>
   </div>
 </section>
@@ -89,9 +89,9 @@ piagent-setup</code></pre>
   <h2 id="bat-dau-tu-dau">Bắt đầu từ đâu</h2>
   <div class="card-grid">
     <a class="doc-card" href="/whats-new">
-      <span class="card-kicker">Bản 1.9.3</span>
+      <span class="card-kicker">Bản 1.11.0</span>
       <h3>Có gì mới</h3>
-      <p>Gõ tiếng Việt không gửi nhầm, subagent đọc trang gọn hơn; ở 1.9.2: việc trên web do subagent nghiên cứu làm, khung chat không còn giật.</p>
+      <p>Cập nhật Pi và Piagent bằng một nút, bảng lệnh ⌘K và Cài đặt tìm được; ở 1.10.0: main agent hỏi lại khi chưa rõ, subagent được phản biện brief.</p>
     </a>
     <a class="doc-card" href="/ecosystem">
       <span class="card-kicker">Get started</span>

package/docs-site/content/whats-new.html

@@ -1,3 +1,25 @@
+<section class="section">
+  <p class="section-kicker">v1.11.0 · 2026-10-05</p>
+  <h2 id="v1-11-0">Cập nhật bằng một nút, và dashboard như một trình soạn code</h2>
+  <p class="section-lead">Dashboard tự kiểm tra bản mới và cập nhật Pi cùng Piagent khi bạn bấm. Thanh trạng thái, bảng lệnh và Cài đặt có ô tìm kiếm giúp mọi thao tác đều nằm trong tầm phím.</p>
+  <div class="grid cols-3">
+    <article class="card"><h3 id="one-click-update">Cập nhật một nút</h3><p>Dashboard kiểm tra khi mở và mỗi 6 giờ. Có bản mới thì thanh trạng thái báo "Cập nhật Piagent"; bấm là Pi và Piagent được cài cùng nhau rồi dashboard mở lại trong tab mới. Pi luôn lên đúng bản Piagent đã kiểm chứng, và nút bị khoá khi đang có lượt chạy.</p></article>
+    <article class="card"><h3 id="command-palette">Bảng lệnh</h3><p>⌘K hoặc Ctrl+K mở mọi thao tác, mọi mục cài đặt và mọi cuộc trò chuyện theo tên; gõ không dấu vẫn tìm được. ⌘, hoặc Ctrl+, mở Cài đặt.</p></article>
+    <article class="card"><h3 id="settings-search">Cài đặt tìm được</h3><p>Ô tìm kiếm tìm cài đặt theo việc nó làm, các mục được chia nhóm, có mục Cập nhật và Phím tắt. Thanh trạng thái dưới đáy cho biết Gateway, số lượt đang chạy và phiên bản.</p></article>
+  </div>
+</section>
+
+<section class="section">
+  <p class="section-kicker">v1.10.0 · 2026-10-05</p>
+  <h2 id="v1-10-0">Main agent hỏi lại khi chưa rõ, subagent được phản biện brief</h2>
+  <p class="section-lead">Khi yêu cầu còn để ngỏ một quyết định, main agent hỏi bạn bằng thẻ câu hỏi có lựa chọn đánh số thay vì đoán. Subagent được nêu bằng chứng khi brief lệch yêu cầu, và bất đồng lần hai thì bạn quyết. Hết quota hay patch quá lớn không còn làm dừng việc.</p>
+  <div class="grid cols-3">
+    <article class="card"><h3 id="ask-user">Hỏi lại bằng lựa chọn</h3><p>1–4 câu hỏi, mỗi câu 2–4 lựa chọn đánh số, luôn có "Khác" để tự nhập và "Để agent tự quyết". Bấm số để chọn, Enter để gửi. Bấm Dừng giữa chừng thì khi "tiếp tục", agent hỏi lại chứ không chọn thay bạn.</p></article>
+    <article class="card"><h3 id="objections">Subagent phản biện brief</h3><p>Subagent đọc nguyên văn yêu cầu và plan trước brief. Brief sai hoặc lệch yêu cầu thì subagent nêu bằng chứng và main agent phải trả lời. Bất đồng lần hai, hội thoại ghi "Cần bạn quyết".</p></article>
+    <article class="card"><h3 id="fallback">Chạy tiếp khi hết quota</h3><p>Subagent hết quota hoặc tài khoản đang nghỉ sẽ chạy lại trên model dự phòng của Harness. Patch trên 120 KB được review theo từng phần rồi gộp findings.</p></article>
+  </div>
+</section>
+
 <section class="section">
   <p class="section-kicker">v1.9.3 · 2026-10-03</p>
   <h2 id="v1-9-3">Gõ tiếng Việt không gửi nhầm, subagent đọc trang gọn hơn</h2>

package/docs-site/context-engine.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/context-engine" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/context-engine" hreflang="en" lang="en">EN</a>

package/docs-site/ecosystem.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · VI</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · VI</span>
         <nav class="language-switch" aria-label="Ngôn ngữ">
           <a class="language-option current" href="/ecosystem" hreflang="vi" lang="vi" aria-current="true">VI</a>
           <a class="language-option" href="/en/ecosystem" hreflang="en" lang="en">EN</a>

package/docs-site/en/architecture.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/architecture" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/architecture" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/benchmark.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/benchmark" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/benchmark" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/commands.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/commands" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/commands" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/context-engine.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/context-engine" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/context-engine" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/ecosystem.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/ecosystem" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/ecosystem" hreflang="en" lang="en" aria-current="true">EN</a>

package/docs-site/en/index.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/" hreflang="en" lang="en" aria-current="true">EN</a>
@@ -93,7 +93,7 @@
       <main>
         <div class="content-shell" data-article>
 <section class="hero">
-  <p class="eyebrow">Piagent 1.9.3</p>
+  <p class="eyebrow">Piagent 1.11.0</p>
   <h1>A coding agent for the whole team, checked at every step.</h1>
   <p>
     One dashboard for Terminal and the browser. Use models with your own account, or the company's models through Agent Watch and Agent Studio. The guard checks every tool call; in company mode the team's Harness asks for checks, has a subagent review the change and reports the outcome right under the answer.
@@ -107,7 +107,7 @@
   <div class="hero-actions">
     <a class="button primary" href="/en/quickstart">Get started</a>
     <a class="button" href="/en/ecosystem">Ecosystem</a>
-    <a class="button" href="/en/whats-new">What’s new in 1.9.3</a>
+    <a class="button" href="/en/whats-new">What’s new in 1.11.0</a>
     <a class="button" href="/en/commands">View commands</a>
   </div>
 </section>
@@ -183,9 +183,9 @@ piagent-setup</code></pre>
   <h2 id="where-to-start">Where to start</h2>
   <div class="card-grid">
     <a class="doc-card" href="/en/whats-new">
-      <span class="card-kicker">Release 1.9.3</span>
+      <span class="card-kicker">Release 1.11.0</span>
       <h3>What’s new</h3>
-      <p>Typing Vietnamese never sends by mistake and subagents read leaner pages; in 1.9.2: web work goes to the research subagent and the chat stays put.</p>
+      <p>One-click updates of Pi and Piagent, a ⌘K command palette and searchable Settings; in 1.10.0: the main agent asks when it is unsure and subagents may object to a brief.</p>
     </a>
     <a class="doc-card" href="/en/ecosystem">
       <span class="card-kicker">Get started</span>

package/docs-site/en/mcp-approval.html

@@ -30,7 +30,7 @@
         <span>Pi Agent Platform</span>
       </a>
       <div class="top-actions">
-        <span class="pill"><span class="pill-dot"></span>v1.9.3 docs · EN</span>
+        <span class="pill"><span class="pill-dot"></span>v1.11.0 docs · EN</span>
         <nav class="language-switch" aria-label="Language">
           <a class="language-option" href="/mcp-approval" hreflang="vi" lang="vi">VI</a>
           <a class="language-option current" href="/en/mcp-approval" hreflang="en" lang="en" aria-current="true">EN</a>