@piagent/platform 1.8.0 → 1.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +7 -0
- package/CHANGELOG.md +97 -1
- package/README.md +45 -70
- package/README.vi.md +34 -61
- package/architecture/layers.json +16 -3
- package/catalog/capabilities.json +14 -7
- package/catalog/claude-model-additions.json +42 -0
- package/docs/auto-delegation-policy.md +2 -0
- package/docs/command-reference-vietnamese.md +68 -90
- package/docs/context-window-policy.md +5 -5
- package/docs/distribution-standard.md +13 -16
- package/docs/en/architecture.md +9 -1
- package/docs/herdr-workflow.md +2 -3
- package/docs/languages.json +4 -4
- package/docs/managed-local-acceptance.md +403 -0
- package/docs/mcp-and-tools.md +5 -7
- package/docs/memory-policy.md +3 -3
- package/docs/model-options.md +2 -2
- package/docs/oauth-providers.md +1 -1
- package/docs/operator-manual-vietnamese.md +82 -127
- package/docs/package-architecture-notes.md +4 -4
- package/docs/piagent-core-improvement-plan.md +3 -5
- package/docs/piagent-core-plan-checkpoint-2026-09-06.json +2 -13
- package/docs/piagent-runtime-benchmark-execution-plan.md +10 -8
- package/docs/project-adapters.md +3 -3
- package/docs/project-onboarding.md +15 -16
- package/docs/publishing-for-teams.md +2 -1
- package/docs/quality-benchmark.md +2 -0
- package/docs/quickstart-vietnamese.md +23 -24
- package/docs/release-install-policy.md +3 -2
- package/docs/research/harness-next-evidence-review.md +7 -7
- package/docs/runtime-harness-standard.md +2 -0
- package/docs/runtime-policy-design.md +2 -0
- package/docs/runtime-quality-baseline.md +2 -0
- package/docs/subagent-orchestration-capabilities.md +1 -1
- package/docs/subagents-and-multiagent.md +10 -8
- package/docs/task-implementation-contract.md +2 -0
- package/docs/task-lifecycle-vietnamese.md +2 -0
- package/docs/team-onboarding.md +28 -59
- package/docs/usage-observability.md +2 -2
- package/docs/vi/architecture.md +9 -1
- package/docs/workflow-recipes.md +6 -10
- package/docs-site/architecture.html +4 -3
- package/docs-site/assets/docs.css +80 -0
- package/docs-site/benchmark.html +7 -1
- package/docs-site/commands.html +37 -23
- package/docs-site/content/architecture.html +2 -2
- package/docs-site/content/benchmark.html +5 -0
- package/docs-site/content/commands.html +35 -22
- package/docs-site/content/ecosystem.html +144 -0
- package/docs-site/content/en/architecture.html +1 -1
- package/docs-site/content/en/benchmark.html +5 -0
- package/docs-site/content/en/commands.html +30 -13
- package/docs-site/content/en/ecosystem.html +144 -0
- package/docs-site/content/en/index.html +24 -9
- package/docs-site/content/en/quickstart.html +10 -12
- package/docs-site/content/en/security.html +1 -1
- package/docs-site/content/en/team.html +2 -2
- package/docs-site/content/en/whats-new.html +77 -1
- package/docs-site/content/en/workflows.html +29 -31
- package/docs-site/content/index.html +24 -9
- package/docs-site/content/quickstart.html +10 -12
- package/docs-site/content/security.html +2 -2
- package/docs-site/content/team.html +2 -2
- package/docs-site/content/whats-new.html +77 -1
- package/docs-site/content/workflows.html +36 -38
- package/docs-site/context-engine.html +2 -1
- package/docs-site/ecosystem.html +283 -0
- package/docs-site/en/architecture.html +3 -2
- package/docs-site/en/benchmark.html +7 -1
- package/docs-site/en/commands.html +32 -14
- package/docs-site/en/context-engine.html +2 -1
- package/docs-site/en/ecosystem.html +283 -0
- package/docs-site/en/index.html +30 -14
- package/docs-site/en/mcp-approval.html +2 -1
- package/docs-site/en/mcp-auth.html +2 -1
- package/docs-site/en/mcp-servers.html +2 -1
- package/docs-site/en/mcp.html +2 -1
- package/docs-site/en/permissions.html +2 -1
- package/docs-site/en/profiles.html +2 -1
- package/docs-site/en/quickstart.html +17 -18
- package/docs-site/en/runtime.html +2 -1
- package/docs-site/en/scope.html +2 -1
- package/docs-site/en/security.html +6 -5
- package/docs-site/en/team.html +4 -3
- package/docs-site/en/whats-new.html +85 -8
- package/docs-site/en/workflows.html +34 -35
- package/docs-site/index.html +30 -14
- package/docs-site/mcp-approval.html +2 -1
- package/docs-site/mcp-auth.html +2 -1
- package/docs-site/mcp-servers.html +2 -1
- package/docs-site/mcp.html +2 -1
- package/docs-site/permissions.html +2 -1
- package/docs-site/profiles.html +2 -1
- package/docs-site/quickstart.html +17 -18
- package/docs-site/runtime.html +2 -1
- package/docs-site/scope.html +2 -1
- package/docs-site/security.html +7 -6
- package/docs-site/team.html +4 -3
- package/docs-site/whats-new.html +85 -8
- package/docs-site/workflows.html +41 -42
- package/evals/fs5-causal-arm.v1.json +2 -2
- package/evals/private-holdout-v1/CURRENT_BOUNDARY.md +17 -0
- package/evals/private-holdout-v1/public-exposure.v2.json +2 -2
- package/package.json +8 -7
- package/packages/piagent-core/README.md +15 -23
- package/packages/piagent-core/docs/context-efficiency-improvement-plan.md +2 -0
- package/packages/piagent-core/extensions/experiment-loop-policy.ts +75 -0
- package/packages/piagent-core/extensions/local-state-path.js +15 -0
- package/packages/piagent-core/extensions/piagent-guard.ts +108 -960
- package/packages/piagent-core/extensions/policy-core.js +2 -2
- package/packages/piagent-core/extensions/source-checkout-paths.ts +54 -0
- package/packages/piagent-core/managed/broker-client.mjs +49 -0
- package/packages/piagent-core/managed/capabilities.mjs +28 -0
- package/packages/piagent-core/managed/compaction.mjs +63 -0
- package/packages/piagent-core/managed/doctor.mjs +107 -0
- package/packages/piagent-core/managed/native-catalog.mjs +42 -0
- package/packages/piagent-core/managed/patch-snapshot.mjs +48 -0
- package/packages/piagent-core/managed/repository-operation.mjs +84 -0
- package/packages/piagent-core/managed/request-stream.mjs +129 -0
- package/packages/piagent-core/managed/resource-loader.mjs +42 -0
- package/packages/piagent-core/managed/review-snapshot-worker.mjs +27 -0
- package/packages/piagent-core/managed/sandbox-diagnostic.mjs +12 -0
- package/packages/piagent-core/managed/search-fallback.mjs +93 -0
- package/packages/piagent-core/managed/session.mjs +472 -0
- package/packages/piagent-core/managed/store.d.mts +3 -0
- package/packages/piagent-core/managed/store.mjs +64 -0
- package/packages/piagent-core/managed/tool-boundary.mjs +243 -0
- package/packages/piagent-core/managed/tool-worker.mjs +36 -0
- package/packages/piagent-core/managed/toolchain.mjs +120 -0
- package/packages/piagent-core/managed/web-fetch.mjs +105 -0
- package/packages/piagent-core/managed/web-search.mjs +96 -0
- package/packages/piagent-core/managed/workflow.mjs +299 -0
- package/packages/piagent-core/package.json +2 -5
- package/packages/piagent-core/policies/base-policy.json +80 -26
- package/packages/piagent-core/runtime/hooks/agent-start-hook.ts +3 -3
- package/packages/piagent-core/runtime/hooks/input-hook.ts +35 -196
- package/packages/piagent-core/runtime/hooks/session-start-hook.ts +2 -0
- package/packages/piagent-core/runtime/inspection/approval-broker.ts +9 -1
- package/packages/piagent-core/runtime/managed-failure.d.mts +10 -0
- package/packages/piagent-core/runtime/managed-failure.mjs +164 -0
- package/packages/piagent-core/runtime/orchestration/minimal-delegation-policy.ts +8 -29
- package/packages/piagent-core/runtime/orchestration/owned-work-budget.ts +1 -1
- package/packages/piagent-core/runtime/policy/block-remedy.ts +5 -3
- package/packages/piagent-core/runtime/registration/context-commands.ts +1 -1
- package/packages/piagent-core/runtime/registration/knowledge-tools.ts +7 -7
- package/packages/piagent-core/runtime/registration/policy-tools.ts +2 -2
- package/packages/piagent-core/runtime/registration/session-commands.ts +11 -26
- package/packages/piagent-core/runtime/registration/task-evidence-tools.ts +1 -1
- package/packages/piagent-core/runtime/session/system-prompt.ts +6 -7
- package/packages/piagent-core/runtime/workflows/webui-runtime-command.ts +6 -6
- package/packages/piagent-core/runtime/workflows/webui-workflow.ts +6 -11
- package/packages/piagent-core/security/sensitive-text.js +9 -0
- package/packages/piagent-core/skills/piagent-ops/SKILL.md +8 -10
- package/packages/piagent-core/skills/test-audit/SKILL.md +101 -0
- package/packages/piagent-core/subagents/piagent-planner.md +1 -1
- package/packages/piagent-webui/dist/client/assets/{MarkdownMessage-DMU7Xe_O.js → MarkdownMessage-Dd9wPk-v.js} +1 -1
- package/packages/piagent-webui/dist/client/assets/index-7I-50Q2U.js +228 -0
- package/packages/piagent-webui/dist/client/assets/{index-DVahUVWy.css → index-DgSmcnP8.css} +1 -1
- package/packages/piagent-webui/dist/client/index.html +2 -2
- package/packages/piagent-webui/extension/piagent-webui.ts +11 -11
- package/packages/piagent-webui/extension/session-stream-adapter.ts +3 -1
- package/packages/piagent-webui/extension/terminal-session-adapter.ts +6 -1
- package/packages/piagent-webui/gateway/company-relay.ts +308 -0
- package/packages/piagent-webui/gateway/control-socket.ts +39 -12
- package/packages/piagent-webui/gateway/gateway-service.ts +109 -28
- package/packages/piagent-webui/gateway/gateway-session-stream.ts +58 -2
- package/packages/piagent-webui/gateway/managed-gateway.mjs +41 -0
- package/packages/piagent-webui/gateway/managed-launch.ts +145 -0
- package/packages/piagent-webui/gateway/managed-projection.ts +20 -0
- package/packages/piagent-webui/gateway/pi-host.ts +22 -4
- package/packages/piagent-webui/gateway/runtime-session-controls.ts +5 -2
- package/packages/piagent-webui/gateway/session-approval-authority.ts +28 -0
- package/packages/piagent-webui/gateway/session-catalog.ts +11 -3
- package/packages/piagent-webui/gateway/session-command-controller.ts +8 -2
- package/packages/piagent-webui/gateway/session-file-facts.ts +25 -0
- package/packages/piagent-webui/gateway/session-inspection-registry.ts +40 -9
- package/packages/piagent-webui/gateway/session-list-cache.ts +68 -0
- package/packages/piagent-webui/gateway/session-runtime-ownership.ts +8 -1
- package/packages/piagent-webui/gateway/session-runtime-supervisor.ts +20 -27
- package/packages/piagent-webui/ownership/managed-terminal-lease.ts +27 -0
- package/packages/piagent-webui/ownership/profile-state.ts +2 -0
- package/packages/piagent-webui/ownership/session-lease-store.ts +22 -1
- package/packages/piagent-webui/server/approval-projection.ts +9 -0
- package/packages/piagent-webui/server/core-inspection-provider.ts +4 -9
- package/packages/piagent-webui/server/loopback-server.ts +37 -1
- package/packages/piagent-webui/server/message-stop-reason.ts +11 -0
- package/packages/piagent-webui/server/tool-call-summary.ts +185 -0
- package/packages/piagent-webui/server/transcript-projection.ts +86 -3
- package/packs/engineering-base/pack.json +4 -0
- package/schemas/piagent-webui/runtime-command-v1.schema.json +1 -2
- package/schemas/piagent-webui/session-catalog-v1.schema.json +8 -0
- package/schemas/piagent-webui/transcript-v1.schema.json +94 -1
- package/scripts/build-docs-site.mjs +23 -12
- package/scripts/check-public-wording.mjs +5 -6
- package/scripts/check-runtime-advisories.mjs +23 -6
- package/scripts/claude-model-additions.mjs +33 -0
- package/scripts/configure-model-scope.sh +30 -6
- package/scripts/configure-subagents.sh +1 -1
- package/scripts/explain-command.mjs +5 -6
- package/scripts/model-scope-prune.mjs +75 -0
- package/scripts/phase-tools-evaluation.mjs +9 -4
- package/scripts/piagent-cli.mjs +51 -2
- package/scripts/piagent-dashboard.mjs +27 -4
- package/scripts/piagent-installations.mjs +26 -0
- package/scripts/piagent-studio.mjs +155 -0
- package/scripts/runtime-advisory-exceptions.json +29 -0
- package/scripts/team-doctor.sh +20 -1
- package/scripts/typescript-loader.mjs +6 -0
- package/scripts/verify-local.sh +2 -2
- package/templates/global/settings.json +3 -1
- package/templates/project/.pi/project-context.md +3 -3
- package/templates/project/AGENTS.md +4 -5
- package/docs/piagent-core-reasoning-research-2026-09-06.md +0 -225
- package/docs/piagent-core-research-sources-2026-09-06.json +0 -416
- package/packages/piagent-webui/dist/client/assets/index-Cui9AAV_.js +0 -176
package/docs-site/whats-new.html
CHANGED
|
@@ -3,16 +3,16 @@
|
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="utf-8" />
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
6
|
-
<title>
|
|
7
|
-
<meta name="description" content="
|
|
6
|
+
<title>Bản 1.9.0: nói việc bằng lời, Harness của team kiểm tra · Pi Agent Platform Docs</title>
|
|
7
|
+
<meta name="description" content="Bỏ task contract và lệnh workflow. Chế độ công ty tự yêu cầu check và review; nút Dừng, lệnh có mạng theo lần duyệt và thẻ duyệt dễ đọc hơn." />
|
|
8
8
|
<meta name="theme-color" content="#050505" />
|
|
9
9
|
<link rel="canonical" href="https://piagent.io.vn/whats-new" />
|
|
10
10
|
<link rel="alternate" hreflang="vi" href="https://piagent.io.vn/whats-new" />
|
|
11
11
|
<link rel="alternate" hreflang="en" href="https://piagent.io.vn/en/whats-new" />
|
|
12
12
|
<link rel="alternate" hreflang="x-default" href="https://piagent.io.vn/whats-new" />
|
|
13
13
|
<link rel="icon" href="/favicon.svg" type="image/svg+xml" />
|
|
14
|
-
<meta property="og:title" content="
|
|
15
|
-
<meta property="og:description" content="
|
|
14
|
+
<meta property="og:title" content="Bản 1.9.0: nói việc bằng lời, Harness của team kiểm tra · Pi Agent Platform Docs" />
|
|
15
|
+
<meta property="og:description" content="Bỏ task contract và lệnh workflow. Chế độ công ty tự yêu cầu check và review; nút Dừng, lệnh có mạng theo lần duyệt và thẻ duyệt dễ đọc hơn." />
|
|
16
16
|
<meta property="og:url" content="https://piagent.io.vn/whats-new" />
|
|
17
17
|
<link rel="preconnect" href="https://fonts.googleapis.com" />
|
|
18
18
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
<span>Pi Agent Platform</span>
|
|
31
31
|
</a>
|
|
32
32
|
<div class="top-actions">
|
|
33
|
-
<span class="pill"><span class="pill-dot"></span>v1.
|
|
33
|
+
<span class="pill"><span class="pill-dot"></span>v1.9.0 docs · VI</span>
|
|
34
34
|
<nav class="language-switch" aria-label="Ngôn ngữ">
|
|
35
35
|
<a class="language-option current" href="/whats-new" hreflang="vi" lang="vi" aria-current="true">VI</a>
|
|
36
36
|
<a class="language-option" href="/en/whats-new" hreflang="en" lang="en">EN</a>
|
|
@@ -59,6 +59,7 @@
|
|
|
59
59
|
<div class="nav-group">
|
|
60
60
|
<p class="nav-title">Get started</p>
|
|
61
61
|
<a class="nav-link" href="/">Overview</a>
|
|
62
|
+
<a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
|
|
62
63
|
<a class="nav-link" href="/quickstart">Quickstart</a>
|
|
63
64
|
<a class="nav-link current" href="/whats-new" aria-current="page">Có gì mới</a>
|
|
64
65
|
<a class="nav-link" href="/scope">Phạm vi platform</a>
|
|
@@ -99,9 +100,85 @@
|
|
|
99
100
|
<span>Có gì mới</span>
|
|
100
101
|
</nav>
|
|
101
102
|
<div class="page-head">
|
|
102
|
-
<h1>
|
|
103
|
-
<p>
|
|
103
|
+
<h1>Bản 1.9.0: nói việc bằng lời, Harness của team kiểm tra</h1>
|
|
104
|
+
<p>Bỏ task contract và lệnh workflow. Chế độ công ty tự yêu cầu check và review; nút Dừng, lệnh có mạng theo lần duyệt và thẻ duyệt dễ đọc hơn.</p>
|
|
104
105
|
</div>
|
|
106
|
+
<section class="section">
|
|
107
|
+
<p class="section-kicker">v1.9.0 · 2026-10-02</p>
|
|
108
|
+
<h2 id="v1-9-0">Nói việc bằng lời, Harness của team lo phần kiểm tra</h2>
|
|
109
|
+
<p class="section-lead">Bỏ task contract và các lệnh workflow: bạn giao việc như nói với đồng nghiệp, guard vẫn kiểm tra từng tool call. Chế độ công ty chạy qua Agent Studio và Agent Watch; Harness tự yêu cầu chạy check, cho subagent review và gửi lỗi chặn lại cho agent sửa. Xem <a href="/ecosystem">Hệ sinh thái</a>.</p>
|
|
110
|
+
|
|
111
|
+
<div class="benchmark-metrics" aria-label="Số liệu kiểm chứng bản 1.9.0">
|
|
112
|
+
<div class="benchmark-metric"><span>Kịch bản chạy thật</span><strong>13/13</strong><small>9 cá nhân, 4 chế độ công ty, trên bản cài cuối</small></div>
|
|
113
|
+
<div class="benchmark-metric"><span>Test tự động</span><strong>5.800+</strong><small>unit, integration và security; 0 lỗi</small></div>
|
|
114
|
+
<div class="benchmark-metric"><span>Test trình duyệt</span><strong>27/27</strong><small>dashboard và WebUI trên Chromium</small></div>
|
|
115
|
+
<div class="benchmark-metric"><span>Guard gọn hơn</span><strong>−854 dòng</strong><small>code chỉ phục vụ task contract (4993 → 4139)</small></div>
|
|
116
|
+
</div>
|
|
117
|
+
|
|
118
|
+
<figure class="shot">
|
|
119
|
+
<img src="/assets/shots/company-run-done.jpg" alt="Một lượt ở chế độ công ty: agent sửa code và chạy test, kết quả Check đã qua và Review không có lỗi chặn ghi dưới câu trả lời" loading="lazy" width="1600" height="1000">
|
|
120
|
+
<figcaption>Một lượt ở chế độ công ty: agent sửa code và chạy test, một subagent review bản sửa, kết quả ghi ngay dưới câu trả lời.</figcaption>
|
|
121
|
+
</figure>
|
|
122
|
+
|
|
123
|
+
<div class="grid cols-3">
|
|
124
|
+
<article class="card"><h3 id="freeform">Giao việc bằng lời thường</h3><p>Không còn <span class="inline-code">/workflow</span>, <span class="inline-code">/fresh</span>, <span class="inline-code">/onboard</span> hay task contract. Guard vẫn chặn file bảo vệ, kiểm profile quyền, file quá lớn, sửa trên bản đã cũ, và hỏi bạn trước push hay publish.</p></article>
|
|
125
|
+
<article class="card"><h3 id="harness">Harness của team</h3><p>Studio quyết định mỗi lượt cần kế hoạch, check và review ở mức gợi ý hay bắt buộc. Review do một subagent riêng làm; lỗi chặn được gửi lại cho agent trong số vòng sửa team đặt.</p></article>
|
|
126
|
+
<article class="card"><h3 id="network">Mạng theo lần duyệt</h3><p>Lệnh ở chế độ công ty chạy không mạng. Khi cần cài package, agent xin chạy đúng một lệnh có mạng; thẻ duyệt ghi rõ câu lệnh và bạn cho phép một lần.</p></article>
|
|
127
|
+
<article class="card"><h3 id="stop">Dừng và tiếp tục</h3><p>Nút Dừng có hiệu lực suốt lượt, kể cả lúc review đang chạy. Lượt bị dừng ghi rõ là đã dừng, không báo lỗi model; bấm Tiếp tục để làm tiếp từ các bước đã giữ.</p></article>
|
|
128
|
+
<article class="card"><h3 id="reconnect">Kết nối lại chế độ công ty</h3><p>Nếu phần chạy của công ty đang tắt (máy vừa khởi động, vừa cập nhật), cuộc trò chuyện báo rõ và có nút Kết nối lại ngay tại chỗ.</p></article>
|
|
129
|
+
<article class="card"><h3 id="local-state">Không lẫn vào git</h3><p>Thư mục <span class="inline-code">.pi/piagent-state</span> tự có <span class="inline-code">.gitignore</span>; trạng thái chạy không còn hiện trong <span class="inline-code">git status</span> của project.</p></article>
|
|
130
|
+
<article class="card"><h3 id="queue">Xếp hàng khi công ty bận</h3><p>Khi mọi tài khoản model của công ty đang bận, yêu cầu tự chờ tới lượt (tối đa 20 phút) thay vì báo lỗi. Lượt đang chạy hiện bước “Chờ tài khoản công ty rảnh”; nút Dừng vẫn dùng được.</p></article>
|
|
131
|
+
<article class="card"><h3 id="many-conversations">Nhiều cuộc trò chuyện cùng lúc</h3><p>Tạo hay gửi trong một cuộc trò chuyện không còn bị từ chối chỉ vì cuộc khác vừa đổi. Hai thư mục trùng tên (hai bản clone) hiện thêm vị trí để chọn đúng.</p></article>
|
|
132
|
+
<article class="card"><h3 id="model-scope">Dọn model không còn</h3><p><span class="inline-code">piagent-doctor</span> chỉ ra model đã cấu hình mà Pi không còn biết; <span class="inline-code">piagent-model-scope --prune</span> chỉ xoá đúng các dòng đó.</p></article>
|
|
133
|
+
</div>
|
|
134
|
+
</section>
|
|
135
|
+
|
|
136
|
+
<section class="section">
|
|
137
|
+
<p class="section-kicker">Ảnh từ dashboard</p>
|
|
138
|
+
<h2 id="v1-9-0-anh">Những gì thành viên thấy khi làm việc</h2>
|
|
139
|
+
<div class="shot-grid">
|
|
140
|
+
<figure class="shot">
|
|
141
|
+
<img src="/assets/shots/network-approval.jpg" alt="Thẻ duyệt một lệnh có mạng, ghi đúng câu lệnh npm install sẽ chạy" loading="lazy" width="1600" height="1000">
|
|
142
|
+
<figcaption>Duyệt một lệnh có mạng: thẻ ghi đúng câu lệnh và điều xảy ra khi cho phép hay từ chối.</figcaption>
|
|
143
|
+
</figure>
|
|
144
|
+
<figure class="shot">
|
|
145
|
+
<img src="/assets/shots/new-chat-models.jpg" alt="Chọn model khi mở cuộc trò chuyện mới: nhóm Công ty và nhóm Cá nhân" loading="lazy" width="1600" height="1000">
|
|
146
|
+
<figcaption>Cuộc trò chuyện mới: chọn model của công ty hoặc model cá nhân trong cùng một dashboard.</figcaption>
|
|
147
|
+
</figure>
|
|
148
|
+
<figure class="shot">
|
|
149
|
+
<img src="/assets/shots/company-review-running.jpg" alt="Đang review: thanh trên ghi Subagent 1/2 và nút Dừng vẫn còn" loading="lazy" width="1600" height="1000">
|
|
150
|
+
<figcaption>Review đang chạy: thanh trên ghi Subagent 1/2, nút Dừng vẫn hoạt động.</figcaption>
|
|
151
|
+
</figure>
|
|
152
|
+
<figure class="shot">
|
|
153
|
+
<img src="/assets/shots/personal-edit-test.jpg" alt="Một lượt cá nhân sửa code, diff hiện ngay trong thẻ Sửa" loading="lazy" width="1600" height="1000">
|
|
154
|
+
<figcaption>Chế độ cá nhân: mỗi bước đọc, sửa, chạy lệnh là một thẻ; diff mở ngay tại chỗ.</figcaption>
|
|
155
|
+
</figure>
|
|
156
|
+
</div>
|
|
157
|
+
</section>
|
|
158
|
+
|
|
159
|
+
<section class="section">
|
|
160
|
+
<p class="section-kicker">Kiểm chứng</p>
|
|
161
|
+
<h2 id="v1-9-0-kiem-chung">Chạy thật như một thành viên</h2>
|
|
162
|
+
<p class="section-lead">Mỗi kịch bản do script điều khiển trình duyệt thật trên bản đã cài, gửi tin nhắn như người dùng rồi kiểm tra kết quả trên đĩa. Lỗi trải nghiệm tìm thấy được sửa kèm test rồi chạy lại.</p>
|
|
163
|
+
<div class="table-wrap"><table>
|
|
164
|
+
<thead><tr><th>Kịch bản</th><th>Kết quả</th></tr></thead>
|
|
165
|
+
<tbody>
|
|
166
|
+
<tr><td>Công ty · bỏ dấu tiếng Việt cho slug, thêm test</td><td>2 file đổi, test qua, "Check đã qua trên code cuối · Review không có lỗi chặn"</td></tr>
|
|
167
|
+
<tr><td>Công ty · bấm Dừng lúc review đang chạy</td><td>"Lượt bị dừng trước khi kiểm chứng xong", không báo lỗi</td></tr>
|
|
168
|
+
<tr><td>Công ty · cài package cần mạng</td><td>Thẻ duyệt ghi đúng lệnh; sau khi cho phép, package có trong <span class="inline-code">package.json</span></td></tr>
|
|
169
|
+
<tr><td>Công ty · nhắn thêm lúc lượt đang chạy</td><td>Tin được giữ, gửi khi lượt xong và được trả lời</td></tr>
|
|
170
|
+
<tr><td>Cá nhân · sửa code, chạy test, commit và push</td><td>Push chờ duyệt trên trình duyệt; dừng lệnh dài không để lại tiến trình</td></tr>
|
|
171
|
+
<tr><td>Cá nhân · đọc <span class="inline-code">.env</span></td><td>Bị chặn, không lộ giá trị; agent chỉ cách tự mở</td></tr>
|
|
172
|
+
</tbody>
|
|
173
|
+
</table></div>
|
|
174
|
+
<p>Kết quả benchmark và journey của các bản trước được đo khi còn task contract; chúng là số liệu lịch sử, bản 1.9.0 chưa đo lại.</p>
|
|
175
|
+
</section>
|
|
176
|
+
|
|
177
|
+
<div class="callout">
|
|
178
|
+
<strong>Các bản trước</strong>
|
|
179
|
+
<p>Phần dưới là ghi chú của các bản cũ, đúng với thời điểm phát hành. Từ bản 1.9.0, task contract, trajectory, completion receipt và các lệnh workflow nhắc tới bên dưới đã bỏ.</p>
|
|
180
|
+
</div>
|
|
181
|
+
|
|
105
182
|
<section class="section">
|
|
106
183
|
<p class="section-kicker">v1.8.0</p>
|
|
107
184
|
<h2 id="v1-8-0">Astra, Sol và Luna trong Piagent</h2>
|
|
@@ -172,7 +249,7 @@
|
|
|
172
249
|
<p class="section-kicker">Daily flow</p>
|
|
173
250
|
<h2 id="luong-su-dung">Luồng dùng hằng ngày không bị phá</h2>
|
|
174
251
|
<div class="steps">
|
|
175
|
-
<article class="step"><div><h3>Giao task như trước</h3><p>Dùng prompt tự nhiên
|
|
252
|
+
<article class="step"><div><h3>Giao task như trước</h3><p>Dùng prompt tự nhiên (từ bản 1.9.0 <span class="inline-code">/workflow</span> đã bỏ). Không cần gọi preflight thủ công.</p></div></article>
|
|
176
253
|
<article class="step"><div><h3>Runtime tự ghi nhận truth</h3><p>Task Contract, context, changed files, trajectory và checkpoint được cập nhật từ hook/tool result thay vì trí nhớ của model.</p></div></article>
|
|
177
254
|
<article class="step"><div><h3>Verify đúng working tree</h3><p>Chỉ exact command đã quan sát, exit thành công và khớp current-tree digest mới được tính là passing evidence.</p></div></article>
|
|
178
255
|
<article class="step"><div><h3>Recovery hoặc handoff có giới hạn</h3><p>Source repair và transient retry có ceiling. Trường hợp không an toàn chuyển sang handoff/operator thay vì tiếp tục đoán.</p></div></article>
|
package/docs-site/workflows.html
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
<meta charset="utf-8" />
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
6
6
|
<title>Workflow thay đổi thế nào sau update · Pi Agent Platform Docs</title>
|
|
7
|
-
<meta name="description" content="
|
|
7
|
+
<meta name="description" content="Từ bản 1.9.0 không còn launcher workflow: nói việc cần làm bằng lời thường. Các command xem thêm chỉ để quan sát và không bao giờ mở lượt model." />
|
|
8
8
|
<meta name="theme-color" content="#050505" />
|
|
9
9
|
<link rel="canonical" href="https://piagent.io.vn/workflows" />
|
|
10
10
|
<link rel="alternate" hreflang="vi" href="https://piagent.io.vn/workflows" />
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
<link rel="alternate" hreflang="x-default" href="https://piagent.io.vn/workflows" />
|
|
13
13
|
<link rel="icon" href="/favicon.svg" type="image/svg+xml" />
|
|
14
14
|
<meta property="og:title" content="Workflow thay đổi thế nào sau update · Pi Agent Platform Docs" />
|
|
15
|
-
<meta property="og:description" content="
|
|
15
|
+
<meta property="og:description" content="Từ bản 1.9.0 không còn launcher workflow: nói việc cần làm bằng lời thường. Các command xem thêm chỉ để quan sát và không bao giờ mở lượt model." />
|
|
16
16
|
<meta property="og:url" content="https://piagent.io.vn/workflows" />
|
|
17
17
|
<link rel="preconnect" href="https://fonts.googleapis.com" />
|
|
18
18
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
<span>Pi Agent Platform</span>
|
|
31
31
|
</a>
|
|
32
32
|
<div class="top-actions">
|
|
33
|
-
<span class="pill"><span class="pill-dot"></span>v1.
|
|
33
|
+
<span class="pill"><span class="pill-dot"></span>v1.9.0 docs · VI</span>
|
|
34
34
|
<nav class="language-switch" aria-label="Ngôn ngữ">
|
|
35
35
|
<a class="language-option current" href="/workflows" hreflang="vi" lang="vi" aria-current="true">VI</a>
|
|
36
36
|
<a class="language-option" href="/en/workflows" hreflang="en" lang="en">EN</a>
|
|
@@ -59,6 +59,7 @@
|
|
|
59
59
|
<div class="nav-group">
|
|
60
60
|
<p class="nav-title">Get started</p>
|
|
61
61
|
<a class="nav-link" href="/">Overview</a>
|
|
62
|
+
<a class="nav-link" href="/ecosystem">Hệ sinh thái</a>
|
|
62
63
|
<a class="nav-link" href="/quickstart">Quickstart</a>
|
|
63
64
|
<a class="nav-link" href="/whats-new">Có gì mới</a>
|
|
64
65
|
<a class="nav-link" href="/scope">Phạm vi platform</a>
|
|
@@ -100,25 +101,24 @@
|
|
|
100
101
|
</nav>
|
|
101
102
|
<div class="page-head">
|
|
102
103
|
<h1>Workflow thay đổi thế nào sau update</h1>
|
|
103
|
-
<p>
|
|
104
|
+
<p>Từ bản 1.9.0 không còn launcher workflow: nói việc cần làm bằng lời thường. Các command xem thêm chỉ để quan sát và không bao giờ mở lượt model.</p>
|
|
104
105
|
</div>
|
|
105
106
|
<section class="section">
|
|
106
107
|
<p class="section-kicker">Workflow impact</p>
|
|
107
108
|
<h2 id="ket-luan">Không có command bắt buộc mới trong daily flow</h2>
|
|
108
|
-
<p class="section-lead">
|
|
109
|
+
<p class="section-lead">Từ bản 1.9.0, giao việc chỉ cần một yêu cầu bằng lời thường. <span class="inline-code">/workflow</span>, <span class="inline-code">/task</span>, <span class="inline-code">/fresh</span> và <span class="inline-code">/onboard</span> đã bỏ cùng task contract: session không còn ghi contract, work plan, completion gate hay receipt. Guard vẫn kiểm tra từng tool call.</p>
|
|
109
110
|
<div class="callout ok-callout">
|
|
110
111
|
<strong>Kết luận ngắn</strong>
|
|
111
|
-
<p>
|
|
112
|
+
<p>Nói điều mình cần, kể cả agent có được sửa hay không ("chỉ đọc, không sửa", "lập plan trước", "implement rồi chạy test"). Các command xem thêm bên dưới là tùy chọn và không bao giờ mở lượt model.</p>
|
|
112
113
|
</div>
|
|
113
114
|
<div class="table-wrap">
|
|
114
115
|
<table>
|
|
115
|
-
<thead><tr><th>Thời điểm</th><th>Người dùng làm
|
|
116
|
+
<thead><tr><th>Thời điểm</th><th>Người dùng làm</th><th>Runtime làm</th><th>Command xem thêm, không bắt buộc</th></tr></thead>
|
|
116
117
|
<tbody>
|
|
117
|
-
<tr><td>Trước
|
|
118
|
-
<tr><td>Đang làm</td><td>
|
|
119
|
-
<tr><td>Verify và review</td><td>
|
|
120
|
-
<tr><td>
|
|
121
|
-
<tr><td>Sau task</td><td>Không có bước bắt buộc mới.</td><td>Giữ telemetry có nguồn, không tự suy diễn chất lượng.</td><td><span class="inline-code">/usage efficiency</span></td></tr>
|
|
118
|
+
<tr><td>Trước khi làm</td><td>Gửi yêu cầu bằng lời thường.</td><td>Đọc profile và project context.</td><td><span class="inline-code">/task-preflight [--json] <intent></span></td></tr>
|
|
119
|
+
<tr><td>Đang làm</td><td>Theo dõi hoặc trả lời câu hỏi xác nhận.</td><td>Kiểm tra từng tool call: protected path và read-only path, permission profile, context budget cho file lớn, edit trên bản đọc cũ, và xác nhận hành động destructive/external. Inspector tự cập nhật dưới footer.</td><td><span class="inline-code">/piagent-inspector</span> hoặc <span class="inline-code">/piagent-status</span></td></tr>
|
|
120
|
+
<tr><td>Verify và review</td><td>Nhờ chạy check của project, hoặc review diff hiện tại.</td><td>Chạy lệnh như mọi tool call khác.</td><td><span class="inline-code">/piagent-inspector commands</span></td></tr>
|
|
121
|
+
<tr><td>Sau khi làm</td><td>Không có bước bắt buộc.</td><td>Giữ telemetry có nguồn, không tự suy diễn chất lượng.</td><td><span class="inline-code">/usage efficiency</span></td></tr>
|
|
122
122
|
</tbody>
|
|
123
123
|
</table>
|
|
124
124
|
</div>
|
|
@@ -126,22 +126,22 @@
|
|
|
126
126
|
|
|
127
127
|
<section class="section">
|
|
128
128
|
<p class="section-kicker">Command semantics</p>
|
|
129
|
-
<h2 id="command-anh-huong-gi">Command
|
|
129
|
+
<h2 id="command-anh-huong-gi">Command xem thêm ảnh hưởng workflow đến đâu</h2>
|
|
130
130
|
<div class="table-wrap">
|
|
131
131
|
<table>
|
|
132
132
|
<thead><tr><th>Command</th><th>Đọc hoặc hiển thị</th><th>Không thực hiện</th></tr></thead>
|
|
133
133
|
<tbody>
|
|
134
|
-
<tr><td><span class="inline-code">/task-preflight</span></td><td>
|
|
135
|
-
<tr><td><span class="inline-code">/piagent-status</span></td><td>
|
|
136
|
-
<tr><td><span class="inline-code">/piagent-inspector</span></td><td>
|
|
137
|
-
<tr><td><span class="inline-code">/usage efficiency</span></td><td>Context telemetry
|
|
138
|
-
<tr><td><span class="inline-code">/piagent-orchestration</span></td><td>Mode, helper mode, giới hạn
|
|
134
|
+
<tr><td><span class="inline-code">/task-preflight</span></td><td>Context và shadow route deterministic cho một intent.</td><td>Không tạo gì, không gọi model và không cấp quyền implementation.</td></tr>
|
|
135
|
+
<tr><td><span class="inline-code">/piagent-status</span></td><td>Profile, guard, runtime và trạng thái model đã xác thực.</td><td>Không sửa file, không chạy lại verify và không retry.</td></tr>
|
|
136
|
+
<tr><td><span class="inline-code">/piagent-inspector</span></td><td>File đã đổi trên panel bốn dòng sát footer, tool hiện tại, command fail/block, safety warning và context budget. Không tham số sẽ mở menu.</td><td>Không sửa file, không chạy command và không ước lượng token theo từng built-in tool.</td></tr>
|
|
137
|
+
<tr><td><span class="inline-code">/usage efficiency</span></td><td>Context telemetry có nguồn; fact không đo được giữ <span class="inline-code">null</span> hoặc unavailable.</td><td>Không chấm chất lượng con người/model.</td></tr>
|
|
138
|
+
<tr><td><span class="inline-code">/piagent-orchestration</span></td><td>Mode, helper mode, giới hạn helper, review lenses, Field Guide và writer policy hiện hành.</td><td>Không đổi mode, không spawn helper và không bật parallel writer.</td></tr>
|
|
139
139
|
</tbody>
|
|
140
140
|
</table>
|
|
141
141
|
</div>
|
|
142
142
|
<div class="callout">
|
|
143
143
|
<strong>Chỉ opt-in mới đổi hành vi.</strong>
|
|
144
|
-
<p>Năm command trên là read-only. Hành vi chỉ đổi khi operator chủ động bật setting
|
|
144
|
+
<p>Năm command trên là read-only. Hành vi chỉ đổi khi operator chủ động bật setting như helper mode; parent routing, automatic worker và multi-writer vẫn không tự bật.</p>
|
|
145
145
|
</div>
|
|
146
146
|
</section>
|
|
147
147
|
|
|
@@ -150,14 +150,13 @@
|
|
|
150
150
|
<h2 id="luong-mau">Một luồng đầy đủ có thể dùng như sau</h2>
|
|
151
151
|
<div class="command-grid">
|
|
152
152
|
<article class="command-card">
|
|
153
|
-
<header><span>Inspect → implement → review
|
|
153
|
+
<header><span>Inspect → implement → review</span><button class="clip-btn" data-clip="/task-preflight --json Fix the failing checkout test Sửa test checkout đang fail rồi chạy test của project. /piagent-inspector Review diff hiện tại: correctness, test còn thiếu, scope drift. Chỉ đọc. /usage efficiency">Lấy lệnh</button></header>
|
|
154
154
|
<pre><code>/task-preflight --json Fix the failing checkout test
|
|
155
|
-
|
|
155
|
+
Sửa test checkout đang fail rồi chạy test của project.
|
|
156
156
|
/piagent-inspector
|
|
157
|
-
|
|
158
|
-
/piagent-status
|
|
157
|
+
Review diff hiện tại: correctness, test còn thiếu, scope drift. Chỉ đọc.
|
|
159
158
|
/usage efficiency</code></pre>
|
|
160
|
-
<p>Chỉ dòng
|
|
159
|
+
<p>Chỉ các dòng lời thường mới mở việc cho model. Preflight, inspector và efficiency là màn hình xem tùy chọn.</p>
|
|
161
160
|
</article>
|
|
162
161
|
</div>
|
|
163
162
|
</section>
|
|
@@ -165,47 +164,47 @@
|
|
|
165
164
|
<section class="section">
|
|
166
165
|
<div class="callout ok-callout">
|
|
167
166
|
<strong>Git trong Pi Agent</strong>
|
|
168
|
-
<p>Không có namespace <span class="inline-code">/git</span>
|
|
167
|
+
<p>Không có namespace <span class="inline-code">/git</span> và không có command workflow. Nhờ commit hoặc tạo PR bằng lời thường. <span class="inline-code">git push</span>, thao tác ghi lên GitHub và stage rộng như <span class="inline-code">git add -A</span> vẫn cần operator xác nhận.</p>
|
|
169
168
|
</div>
|
|
170
169
|
|
|
171
170
|
<div class="callout">
|
|
172
171
|
<strong>Parent-direct orchestration</strong>
|
|
173
|
-
<p>Dùng <span class="inline-code">/piagent-orchestration</span> để xem trần
|
|
172
|
+
<p>Dùng <span class="inline-code">/piagent-orchestration</span> để xem trần helper, lý do dispatch/skip, review lenses, Field Guide và writer policy. Helper mặc định off. Khi opt-in, parent được dùng tối đa hai helper read-only context fresh; ước tính tiết kiệm token chỉ là telemetry, không phải điều kiện. Worker và retry bị tắt.</p>
|
|
174
173
|
</div>
|
|
175
174
|
|
|
176
175
|
<div class="command-grid">
|
|
177
176
|
<article class="command-card">
|
|
178
|
-
<header><span>Implementation
|
|
179
|
-
<pre><code
|
|
177
|
+
<header><span>Implementation</span><button class="clip-btn" data-clip="Sửa test checkout đang fail rồi chạy test của project.">Lấy lệnh</button></header>
|
|
178
|
+
<pre><code>Sửa test checkout đang fail rồi chạy test của project.</code></pre>
|
|
180
179
|
</article>
|
|
181
180
|
<article class="command-card">
|
|
182
|
-
<header><span>Read-only scout</span><button class="clip-btn" data-clip="
|
|
183
|
-
<pre><code
|
|
181
|
+
<header><span>Read-only scout</span><button class="clip-btn" data-clip="Map luồng auth và các vùng rủi ro. Chỉ đọc, không sửa.">Lấy lệnh</button></header>
|
|
182
|
+
<pre><code>Map luồng auth và các vùng rủi ro. Chỉ đọc, không sửa.</code></pre>
|
|
184
183
|
</article>
|
|
185
184
|
<article class="command-card">
|
|
186
|
-
<header><span>Plan trước khi code</span><button class="clip-btn" data-clip="
|
|
187
|
-
<pre><code
|
|
185
|
+
<header><span>Plan trước khi code</span><button class="clip-btn" data-clip="Lập plan hỗ trợ multi-tenant billing. Chưa sửa code.">Lấy lệnh</button></header>
|
|
186
|
+
<pre><code>Lập plan hỗ trợ multi-tenant billing. Chưa sửa code.</code></pre>
|
|
188
187
|
</article>
|
|
189
188
|
<article class="command-card">
|
|
190
|
-
<header><span>Review diff</span><button class="clip-btn" data-clip="
|
|
191
|
-
<pre><code
|
|
189
|
+
<header><span>Review diff</span><button class="clip-btn" data-clip="Review diff hiện tại: correctness, test còn thiếu, scope drift. Chỉ đọc.">Lấy lệnh</button></header>
|
|
190
|
+
<pre><code>Review diff hiện tại: correctness, test còn thiếu, scope drift. Chỉ đọc.</code></pre>
|
|
192
191
|
</article>
|
|
193
192
|
<article class="command-card">
|
|
194
|
-
<header><span>Commit local
|
|
195
|
-
<pre><code
|
|
193
|
+
<header><span>Commit local</span><button class="clip-btn" data-clip="Commit hai file docs với message "docs: update onboarding notes". Không push.">Lấy lệnh</button></header>
|
|
194
|
+
<pre><code>Commit hai file docs với message "docs: update onboarding notes". Không push.</code></pre>
|
|
196
195
|
</article>
|
|
197
196
|
<article class="command-card">
|
|
198
|
-
<header><span>
|
|
199
|
-
<pre><code
|
|
197
|
+
<header><span>Pull request</span><button class="clip-btn" data-clip="Tạo draft PR cho branch này, title "Harden command docs".">Lấy lệnh</button></header>
|
|
198
|
+
<pre><code>Tạo draft PR cho branch này, title "Harden command docs".</code></pre>
|
|
200
199
|
</article>
|
|
201
200
|
<article class="command-card">
|
|
202
|
-
<header><span>Backend spec sang frontend</span><button class="clip-btn" data-clip="/profile be-readonly-fe

|
|
201
|
+
<header><span>Backend spec sang frontend</span><button class="clip-btn" data-clip="/profile be-readonly-fe Implement frontend support cho endpoint user status mới. Backend chỉ đọc.">Lấy lệnh</button></header>
|
|
203
202
|
<pre><code>/profile be-readonly-fe
|
|
204
|
-
|
|
203
|
+
Implement frontend support cho endpoint user status mới. Backend chỉ đọc.</code></pre>
|
|
205
204
|
</article>
|
|
206
205
|
<article class="command-card">
|
|
207
|
-
<header><span>
|
|
208
|
-
<pre><code
|
|
206
|
+
<header><span>Onboard project</span><button class="clip-btn" data-clip="Đọc project này (chỉ đọc) và ghi lại project context.">Lấy lệnh</button></header>
|
|
207
|
+
<pre><code>Đọc project này (chỉ đọc) và ghi lại project context.</code></pre>
|
|
209
208
|
</article>
|
|
210
209
|
</div>
|
|
211
210
|
</section>
|
|
@@ -33,11 +33,11 @@
|
|
|
33
33
|
},
|
|
34
34
|
{
|
|
35
35
|
"path": "scripts/phase-tools-evaluation.mjs",
|
|
36
|
-
"sha256": "
|
|
36
|
+
"sha256": "73c6e1d840abbcdd9f16dda08b028b8e92634b5c6db266bd64eb9161e14d1480"
|
|
37
37
|
},
|
|
38
38
|
{
|
|
39
39
|
"path": "tests/phase-tools-evaluation.test.mjs",
|
|
40
|
-
"sha256": "
|
|
40
|
+
"sha256": "39997fa171876cbeed2641cb2ff569530809296582cbdddcdbfe36e1cd95f673"
|
|
41
41
|
},
|
|
42
42
|
{
|
|
43
43
|
"path": "evals/fs5-pilot-protocol.v1.json",
|
|
@@ -51,3 +51,20 @@ assurance receipt and independent custody attestation may cross that boundary.
|
|
|
51
51
|
`ready: true` still grants no provider execution, generalization or release
|
|
52
52
|
claim. Independent custody and the remaining exact-candidate release gates
|
|
53
53
|
remain separate requirements.
|
|
54
|
+
|
|
55
|
+
## Owner decision for 1.9.0 (2026-10-01)
|
|
56
|
+
|
|
57
|
+
1.9.0 is released for internal use and makes no private-holdout,
|
|
58
|
+
generalization or benchmark-superiority claim. No custody receipt is
|
|
59
|
+
required for it, and none is issued: its release evidence is the public
|
|
60
|
+
offline gate (`scripts/verify-local.sh --offline`), the live scenario runs
|
|
61
|
+
recorded in `docs/managed-local-acceptance.md`, and team use.
|
|
62
|
+
|
|
63
|
+
The inventory is regenerated with `--write` after the 1.9.0 source changes.
|
|
64
|
+
That keeps `--check` current; it is not custody evidence, and the earlier
|
|
65
|
+
receipts stay historical.
|
|
66
|
+
|
|
67
|
+
A later release that claims a result on private holdout tasks needs the full
|
|
68
|
+
process above: an independent custodian (not a Piagent author), a frozen
|
|
69
|
+
exact candidate, the v2 exposure file and a new custody receipt. The owner
|
|
70
|
+
cannot self-attest it.
|
|
@@ -256,8 +256,8 @@
|
|
|
256
256
|
},
|
|
257
257
|
{
|
|
258
258
|
"path": "tests",
|
|
259
|
-
"fileCount":
|
|
260
|
-
"sha256": "
|
|
259
|
+
"fileCount": 508,
|
|
260
|
+
"sha256": "00d23ae7bb904883ba1a6140f2fe1f639a4718c0fc22e5da2c46db3208a04656"
|
|
261
261
|
}
|
|
262
262
|
],
|
|
263
263
|
"custodianComparisonRules": {
|
package/package.json
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@piagent/platform",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public",
|
|
7
7
|
"provenance": true
|
|
8
8
|
},
|
|
9
9
|
"type": "module",
|
|
10
|
-
"description": "Guardrails for AI coding agents
|
|
10
|
+
"description": "Guardrails and managed team harness for AI coding agents, with isolated tools, scoped approvals, and a local dashboard.",
|
|
11
11
|
"homepage": "https://piagent.io.vn",
|
|
12
12
|
"repository": {
|
|
13
13
|
"type": "git",
|
|
@@ -50,6 +50,7 @@
|
|
|
50
50
|
"!docs/decisions/",
|
|
51
51
|
"!docs/readiness-assessment.md",
|
|
52
52
|
"docs-site/",
|
|
53
|
+
"!docs-site/assets/shots/",
|
|
53
54
|
"evals/",
|
|
54
55
|
"packs/",
|
|
55
56
|
"packages/piagent-core/",
|
|
@@ -98,9 +99,6 @@
|
|
|
98
99
|
"skills": [
|
|
99
100
|
"packages/piagent-core/skills"
|
|
100
101
|
],
|
|
101
|
-
"prompts": [
|
|
102
|
-
"packages/piagent-core/prompts"
|
|
103
|
-
],
|
|
104
102
|
"subagents": {
|
|
105
103
|
"agents": [
|
|
106
104
|
"packages/piagent-core/subagents"
|
|
@@ -115,7 +113,10 @@
|
|
|
115
113
|
"packages/piagent-core/extensions/acceptance-executor/package-lock.json",
|
|
116
114
|
"scripts/benchmark-runner-core.mjs",
|
|
117
115
|
"scripts/register-typescript-loader.mjs",
|
|
118
|
-
"scripts/typescript-loader.mjs"
|
|
116
|
+
"scripts/typescript-loader.mjs",
|
|
117
|
+
"scripts/piagent-studio.mjs",
|
|
118
|
+
"packages/piagent-core/managed/tool-worker.mjs",
|
|
119
|
+
"packages/piagent-core/managed/review-snapshot-worker.mjs"
|
|
119
120
|
]
|
|
120
121
|
},
|
|
121
122
|
"peerDependencies": {
|
|
@@ -152,7 +153,7 @@
|
|
|
152
153
|
],
|
|
153
154
|
"scripts": {
|
|
154
155
|
"verify": "bash scripts/verify-local.sh",
|
|
155
|
-
"test": "PIAGENT_NO_UPDATE_CHECK=1 node --test tests/*.test.mjs",
|
|
156
|
+
"test": "PIAGENT_NO_UPDATE_CHECK=1 node --test --test-force-exit tests/*.test.mjs",
|
|
156
157
|
"test:webui:e2e": "playwright test --config playwright.webui.config.mjs",
|
|
157
158
|
"test:policy": "node --test tests/policy-core.test.mjs",
|
|
158
159
|
"test:golden": "node --test tests/golden-enforcement.test.mjs",
|
|
@@ -7,8 +7,8 @@ Shared Pi package for reusable project workflows.
|
|
|
7
7
|
- `extensions/piagent-guard.ts`: Pi extension composition root and registration order.
|
|
8
8
|
- `runtime/`: Pi-facing session, usage, log-compaction, and workflow input adapters. New command/tool/hook modules belong here.
|
|
9
9
|
- `extensions/*.js|ts`: legacy-location core services for policy, context, task lifecycle, state, and document intake; only `piagent-guard.ts` is loaded as an extension.
|
|
10
|
-
- `prompts/*.md`: workflow
|
|
11
|
-
- `skills/piagent-ops/SKILL.md`: operator-invoked reference for
|
|
10
|
+
- `prompts/*.md`: historical workflow prompt templates; Pi no longer loads them (retired in 1.9.0).
|
|
11
|
+
- `skills/piagent-ops/SKILL.md`: operator-invoked reference for permission, risk, and blocked-call controls; ordinary work does not load it.
|
|
12
12
|
- `skills/piagent-source-cache/`: local cache for user-provided external source repositories.
|
|
13
13
|
- `subagents/*.md`: piagent roles for `pi-subagents`.
|
|
14
14
|
- `benchmark/benchmark-core.js`: deterministic suite validation, evidence scoring, and paired usage comparison for `piagent-benchmark`; `benchmark-report.js` renders the human/HTML reports.
|
|
@@ -76,13 +76,11 @@ Legacy aliases still work: `/permission-status`, `/read-only`, `/workspace-write
|
|
|
76
76
|
- `piagent_exec_policy_check`
|
|
77
77
|
- `piagent_context_budget`
|
|
78
78
|
- `piagent_tool_policy_check`
|
|
79
|
-
- `piagent_task_gate_check`
|
|
80
79
|
- `piagent_usage_snapshot`
|
|
81
80
|
- `piagent_context_preflight`
|
|
82
81
|
- `piagent_memory_status`
|
|
83
82
|
- `piagent_memory_note`
|
|
84
83
|
- `piagent_memory_search`
|
|
85
|
-
- `piagent_memory_citation_record`
|
|
86
84
|
- `piagent_context_index_status`
|
|
87
85
|
- `piagent_context_index_record`
|
|
88
86
|
- `piagent_context_index_search`
|
|
@@ -92,40 +90,34 @@ Legacy aliases still work: `/permission-status`, `/read-only`, `/workspace-write
|
|
|
92
90
|
- `piagent_profile_tech_apply`
|
|
93
91
|
- `piagent_profile_tech_context_record`
|
|
94
92
|
- `piagent_project_onboarding_record`
|
|
95
|
-
- `piagent_task_start`
|
|
96
|
-
- `piagent_task_progress`
|
|
97
93
|
- `piagent_source_checkout`
|
|
98
94
|
- `piagent_document_read` — reads `.md`/`.txt`/`.csv`/`.json`/`.yaml`/`.pdf`/`.docx` from the project or a granted `additionalReadRoots` directory; read-only, and `protectedPaths` still wins
|
|
99
|
-
- `
|
|
100
|
-
- `piagent_verify_record` — records verify evidence only after matching an observed bash tool result after task start
|
|
101
|
-
- `piagent_trace_record`
|
|
95
|
+
- `piagent_wait`
|
|
102
96
|
|
|
103
|
-
These tools are registered capabilities, not a per-task call sequence.
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
`
|
|
107
|
-
|
|
108
|
-
|
|
97
|
+
These tools are registered capabilities, not a per-task call sequence. Since
|
|
98
|
+
1.9.0 a turn is freeform: no task contract is created and the task, trace,
|
|
99
|
+
verify, gate and memory-citation tools (`piagent_task_start`, `piagent_task_progress`,
|
|
100
|
+
`piagent_task_gate_check`, `piagent_context_record`, `piagent_verify_record`,
|
|
101
|
+
`piagent_trace_record`, `piagent_memory_citation_record`) are no longer published. Diagnostic groups load only
|
|
102
|
+
when requested.
|
|
109
103
|
|
|
110
|
-
## Runtime commands
|
|
104
|
+
## Runtime commands
|
|
105
|
+
|
|
106
|
+
Work is requested in plain language. The commands below run without a model turn.
|
|
111
107
|
|
|
112
|
-
- `/commands`: runtime menu/help for terminal, Pi, MCP, model, memory, session, context, permission, and subagent commands.
|
|
113
|
-
- `/workflow`: one launcher for task, scout, BE-to-FE, discuss, plan, review, commit, PR, platform-improve, and onboarding workflows.
|
|
114
108
|
- `/usage`: runtime usage namespace for live snapshot, history hint, preflight, compact, compact-log captures, and context efficiency.
|
|
115
109
|
- Pi native `/name`: set the current session name for Agent Watch/report mapping; Piagent observes the native rename event and keeps `/setname` as a compatibility alias.
|
|
116
|
-
- `/fresh`: open a fresh governed session for any canonical `/workflow` option; `/fresh help` lists the current catalog.
|
|
117
110
|
- `/context`: runtime context namespace for index/rebuild/search/pack/test-impact/efficiency, task preflight, and semantic compact.
|
|
118
111
|
- `/permission`: runtime permission namespace for status/read-only/workspace-write/full-access.
|
|
119
|
-
- `/onboard`: runtime onboarding namespace; `run` launches the first-read onboarding workflow.
|
|
120
112
|
- `/context-index`: legacy alias for `/context index/search`.
|
|
121
113
|
- `/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`.
|
|
122
114
|
- `/profile tech`: show/select/apply the project tech stack for the active profile; fullstack setup selects frontend, backend, and database tech.
|
|
123
115
|
- `/memory` or `/memory-policy`: inspect project memory policy and explicit remember workflow.
|
|
124
|
-
- `/model-options`: show model selector, scoped models, thinking levels, and benchmark discipline without a model follow-up.
|
|
125
116
|
- `/logs`: short alias for `/usage logs`.
|
|
126
117
|
- `/task-preflight`: legacy alias for `/context preflight`.
|
|
127
|
-
- `/
|
|
128
|
-
|
|
118
|
+
- `/piagent-status`, `/piagent-inspector`, `/piagent-orchestration`, `/piagent-mcp`, `/fast`: status, session inspector, helper policy, MCP governance and Codex Fast tier.
|
|
119
|
+
|
|
120
|
+
Retired in 1.9.0: `/workflow`, `/fresh` (and `/fresh-*`), `/onboard`, `/commands`, `/model-options` and the prompt-template aliases (`/task`, `/scout`, `/be-to-fe`, `/platform-improve`, `/commit`, `/pr`, `/plan`, `/discuss`, `/review`). Project onboarding is a plain request; the agent records it with `piagent_project_onboarding_record`.
|
|
129
121
|
|
|
130
122
|
## Subagents
|
|
131
123
|
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# Context Efficiency Improvement Plan
|
|
2
2
|
|
|
3
|
+
> **Design record from before 1.9.0.** The task contract, workflow commands (`/workflow`, `/task`, `/fresh`, `/onboard`) and task/trace/verify tools described here were retired on 2026-09-30; sessions are freeform and the guard keeps its path, permission, confirmation, context-budget and stale-edit checks. Kept for reference. Current behavior: [README](../../../README.md).
|
|
4
|
+
|
|
3
5
|
## Status
|
|
4
6
|
|
|
5
7
|
- **Scope:** `packages/piagent-core`
|