opencode-agent-skill 11.0.0 → 13.0.0-beta.0

package/CHANGELOG.md

@@ -6,6 +6,61 @@ The project follows Semantic Versioning.
 
 ## [Unreleased]
 
+### Fixed
+- Routed all 11 `/ues-*` commands through the stable V2 `session.prompt` path using router-managed prompt aliases, avoiding `UnsupportedContentType` failures from the native `session.command` transport while preserving the same command templates and V1 native-command behavior.
+- Prevented `/ues-run` from duplicating the full `$ARGUMENTS` payload inside its task-policy example, reducing long-prompt amplification.
+- Fixed OpenCode V2 local router loading on clean global configs by removing the unnecessary bare `@opencode/plugin` runtime import; `ues-router` now exports the plain `{ id, setup }` definition accepted by the V2 loader.
+- Prevented OpenCode V2 UES router subprocesses (`where`, `ocskill`, Node shim execution and Git probes) from flashing transient CMD windows on Windows by routing them through a hidden-window spawn wrapper.
+
+## [13.0.0-beta.0] - 2026-09-22
+
+### Added
+- Added native same-model parallel execution through `ues.dispatch_parallel` with bounded adaptive concurrency.
+- Added event-driven DAG scheduling so newly unblocked tasks can start without waiting for an entire wave barrier.
+- Added read/write resource leases, conservative unknown-scope serialization and shared-config writer serialization.
+- Added inherited-root worktree snapshots so downstream tasks see already integrated predecessor changes without committing the user's root branch.
+- Added transactional integration with sandbox rollback when receipt/completion fails after patch application.
+- Added fresh same-model verifier sessions and agent-verifier receipts tied to the active run and current workspace fingerprint.
+- Added global CLI help interception, structured `--json` errors, `work status .` workspace listing, UTF-8/UTF-16 auto-decoding, safe UTF-8 Git diff output and text normalization.
+
+### Regression coverage
+- Added V13 tests for CLI help parsing, structured errors, UTF-16 PowerShell-style diff decoding, event-driven same-model concurrency, resource conflict serialization and inherited-root rollback behavior.
+- Added verifier-runtime regression coverage against forged/user-supplied PASS markers and malformed verdict lines.
+- Added structured `verificationCommands` validation coverage for deterministic post-integration receipts.
+
+### Fixed
+- Fixed the V13 structured-verification regression test wiring so the current HEAD test suite can execute the new plan-schema assertions.
+- Fixed npm 11+ lifecycle-script blocking in release smoke expectations: a plain global install may require the documented `ocskill install` resource-sync fallback, and CI now verifies that fallback instead of falsely requiring postinstall execution.
+- Clarified OpenCode 1.x versus V2 capability boundaries and fenced canonical long-task state to `.ues-work/<slug>/`; legacy/manual `ues-work/` directories are no longer treated as official UES state.
+- Added `repo-graph --compact` and switched initial long-run evidence gathering to compact hotspot/count summaries to reduce large-repository context/tool-output overhead.
+- Made `ocskill install/status/doctor` surface the OpenCode 1.x versus V2 native-parallel boundary directly so users do not mistake V13 CLI availability for fresh-session parallel availability.
+- Hardened migration from V12/manual Windows artifacts by auto-decoding UTF-8/UTF-16 `PLAN.json`, `STATE.json`, `SPEC.md` and dependency reports across the CLI/task engine and V2 parallel router.
+- Added bounded `ocskill text-read` so OpenCode 1.x can recover known UTF text that its generic Read tool classifies as binary, without creating ad-hoc converted copies.
+- Extended packed-install smoke and regressions to cover the UTF recovery command, UTF durable state discovery and legacy artifact context packs.
+- Removed the stale clean-root-only restriction from native parallel dispatch. Existing dirty repository state is now treated as an inherited baseline, while isolated worktree delta integration, resource leases and rollback continue to protect user changes.
+- Fixed inherited untracked-file handling so a parallel worker may safely edit an unchanged pre-existing untracked file, while a user edit that races after sandbox creation is still detected and rejected as a conflict.
+- Aligned legacy smoke tests with V13 structured usage exit code 2 and typed verification evidence (`command-receipt-backed` / `independent-agent-receipt-backed`).
+- Fixed `work status` receipt coverage accounting for the typed V13 evidence strengths and made inherited-untracked worktree regressions line-ending neutral on Windows.
+
+
+## [12.0.0-beta.0] - 2026-09-22
+
+### Beta
+- Added empirical per-task-class model performance history and capability-preserving reranking with a minimum evidence threshold before reranking.
+- Added context quality receipts for required-file recall and irrelevant-context ratio.
+- Added hash-keyed plan snapshots with active-plan execution fencing.
+- Added bounded decision policy for reversible local rulings versus human-gated destructive/external actions.
+- Added deterministic repo-scale benchmark fixture generation and V12/repo-scale validation gates.
+- Hardened release consistency checks to derive eval counts and validate aggregate workflow structure.
+- Fixed missing empirical-history handling so models without benchmark history safely fall back to static capability routing.
+
+### Verified locally on Windows
+- 255 tests total: 253 passed, 0 failed, 2 platform-specific skips.
+- Syntax, catalog validation, docs consistency, routing, V11/V12/repo-scale/live/long/polyglot validation: PASS.
+- npm pack, packed-install smoke and plain one-command install/resource auto-sync smoke: PASS.
+- Published prerelease intent: npm dist-tag `next`; V11 remains `latest` until V12 stable release gates are satisfied.
+
+
 ## [11.0.0] - 2026-09-22
 
 ### Released

package/README.md

@@ -1,7 +1,7 @@
 # OpenCode Universal Engineering System (UES)
 
-> **V11 stable: 11.0.0** — perception-aware adaptive execution engine với evidence-efficient context, capability routing và visual/browser verification.
-> UES là bộ công cụ hỗ trợ OpenCode xử lý dự án lớn, tác vụ dài và quy trình kỹ thuật cần kiểm chứng bằng bằng chứng thực tế.
+> **V13 beta: 13.0.0-beta.0** — parallel weak-model runtime với same-model worker pool, event-driven DAG, transactional worktree integration và hardened CLI/Windows runtime.
+> **Stable latest vẫn là V11: 11.0.0.** V13 được đóng gói dưới prerelease `13.0.0-beta.0`; npm prerelease dùng dist-tag `next`, còn `latest` tiếp tục giữ V11 cho đến khi V13 được promote stable.
 
 [![npm version](https://img.shields.io/npm/v/opencode-agent-skill.svg)](https://www.npmjs.com/package/opencode-agent-skill)
 [![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
@@ -22,6 +22,47 @@ Mục tiêu của UES là giúp quá trình làm việc với coding agent **ổ
 
 ---
 
+
+## V13 beta: Parallel Weak-Model Runtime
+
+V13 cho phép **một model duy nhất** chạy nhiều fresh child sessions song song. `ues.dispatch_parallel` chọn một shared model (hoặc giữ OpenCode default model), chạy các task độc lập theo event-driven DAG, dùng resource lease để tránh writer conflict, tạo worktree riêng cho writer, dùng fresh same-model `ues-verifier`, rồi tích hợp tuần tự. Nếu bước receipt/complete thất bại sau khi patch đã áp dụng, integration transaction tự rollback patch của task đó.
+
+```text
+approved PLAN
+    ↓
+event-driven DAG
+    ↓
+same model × N fresh sessions
+    ↓
+isolated worktrees + resource leases
+    ↓
+fresh same-model verifier
+    ↓
+transactional integration queue
+    ↓
+unlock dependencies immediately
+```
+
+CLI V13 cũng xử lý `--help` trước positional parsing, hỗ trợ `ocskill work status .`, structured errors với `--json`, đọc UTF-8/UTF-16 an toàn và cung cấp `ocskill diff . --out dirty.diff` để tránh PowerShell tạo diff UTF-16 bị OpenCode nhận nhầm là binary.
+
+Parallel resume không còn yêu cầu root phải sạch tuyệt đối. Nếu repository đã có dirty diff hợp lệ từ phiên trước, V13 chụp baseline đó vào worktree cô lập và chỉ tích hợp delta của task; thay đổi cũ được giữ nguyên. Root vẫn phải là Git repository và resource leases vẫn chặn các writer xung đột.
+
+> **Compatibility:** V13 CLI/durable-state/verification hardening vẫn dùng được trên OpenCode 1.x. Native `ues.dispatch_task` / `ues.dispatch_parallel` cần router plugin và fresh-session APIs của OpenCode V2; nếu capability không đủ, runtime fail closed thay vì giả vờ chạy song song.
+
+### V13 beta validation hiện tại
+
+Bản đóng gói hiện tại đã được kiểm tra local trên Windows 10 với OpenCode V2.0.15:
+
+- `npm run evals:v13`: **36/36 PASS**;
+- `npm test`: **298 tests**, **296 pass**, **0 fail**, **2 platform-specific skip**;
+- managed `ues-router` load thành công dưới `~/.config/opencode/plugins/ues-router`;
+- router không còn phụ thuộc runtime bare import `@opencode/plugin`, nên clean global OpenCode config vẫn load được;
+- các subprocess nội bộ của router (`where`, `ocskill`, Node shim và Git probes) dùng hidden-window spawn trên Windows để tránh cửa sổ CMD nháy liên tục;
+- npm 11+ vẫn có thể chặn lifecycle script theo `allowScripts`; `ocskill install` là resource-sync fallback chính thức.
+
+---
+
+
 ## Cài đặt
 
 Yêu cầu:
@@ -30,12 +71,26 @@ Yêu cầu:
 - npm;
 - OpenCode.
 
-Cài đặt toàn cục từ npm:
+Cài đặt stable hiện tại từ npm:
 
 ```cmd
 npm install -g opencode-agent-skill
 ```
 
+Cài V13 beta từ npm sau khi prerelease đã có trên registry:
+
+```cmd
+npm install -g opencode-agent-skill@next
+ocskill install
+```
+
+Nếu đang kiểm thử một commit mới hơn bản registry, cài trực tiếp từ checkout:
+
+```cmd
+npm install -g .
+ocskill install
+```
+
 Kiểm tra:
 
 ```cmd
@@ -44,13 +99,21 @@ ocskill status
 ocskill doctor
 ```
 
-Nếu npm không chạy lifecycle script trong lúc cài đặt, chạy thêm:
+Nếu npm không chạy lifecycle script trong lúc cài đặt (npm 11+ có thể cảnh báo `install-scripts ... not yet covered by allowScripts`), package CLI vẫn có thể đã được cài. Chạy resource sync rõ ràng:
 
 ```cmd
 ocskill install
 ```
 
-Sau khi cài hoặc cập nhật UES, nên mở một OpenCode session mới để các skill, command, subagent và plugin được nạp lại đầy đủ.
+Đây là fallback được CI smoke kiểm tra; không cần dùng `--force` chỉ để vượt cảnh báo lifecycle script.
+
+Sau khi cài hoặc cập nhật UES, hãy restart OpenCode service rồi mở một session mới để skill, command, subagent và plugin được nạp lại đầy đủ:
+
+```cmd
+opencode service restart
+```
+
+Trên OpenCode V2 có thể kiểm tra router bằng `/plugins`, sau đó gọi `ues.capabilities`. Native parallel chỉ nên dùng khi `freshDispatch` báo `true`.
 
 ---
 
@@ -72,7 +135,7 @@ Một số lệnh hữu ích:
 
 ```cmd
 ocskill inspect .
-ocskill repo-graph .
+ocskill repo-graph . --compact
 ocskill verification-plan .
 ocskill task-policy "refactor auth across the whole repository"
 ocskill dashboard . --serve
@@ -333,6 +396,24 @@ Child session không được tự động merge, push, publish hoặc deploy.
 
 ## Slash commands
 
+Trên OpenCode 1.x, UES tiếp tục cài các command Markdown native. Trên OpenCode V2, 11 lệnh `/ues-*` được cài dưới dạng **prompt aliases** của `ues-router`: UI gửi chúng qua đường `session.prompt` đang ổn định, router mới mở rộng template UES. Cách này tránh phụ thuộc vào `session.command` V2 khi endpoint custom-command trả lỗi transport/content-type. Cú pháp người dùng không đổi, cả hai dạng đều hợp lệ:
+
+```text
+/ues-run <yêu cầu>
+```
+
+hoặc:
+
+```text
+/ues-run
+
+<yêu cầu nhiều dòng>
+```
+
+Trên V2 các alias này có thể không xuất hiện trong autocomplete slash menu vì UES chủ động không đăng ký native custom-command để tránh đường `session.command` đang lỗi; vẫn có thể gõ trực tiếp `/ues-run`, `/ues-fix`, v.v.
+
+Sau khi nâng cấp từ bản V13 cũ, chạy `ocskill install`; installer sẽ xóa các native UES command file cũ do chính UES quản lý để OpenCode V2 không còn bắt chúng qua `session.command`.
+
 | Lệnh | Công dụng |
 |---|---|
 | `/ues-feature` | Triển khai feature theo workflow UES |
@@ -407,10 +488,11 @@ Model ID do người dùng cấu hình vẫn là nguồn quyết định cuối
 | Lệnh | Công dụng |
 |---|---|
 | `ocskill inspect [dir]` | Phát hiện stack, package manager, root và test command |
-| `ocskill repo-graph [dir]` | Lập import graph có giới hạn và tìm hotspot |
+| `ocskill repo-graph [dir] [--compact] [--max-files N]` | Lập import graph; dùng `--compact` để lấy hotspot/counts trước, tránh đổ toàn bộ edges trên repo lớn |
 | `ocskill impact <query> [dir]` | Tìm phạm vi ảnh hưởng theo symbol hoặc từ khóa |
 | `ocskill evidence [dir]` | Thu thập snapshot về repository, verification và Git |
 | `ocskill working-tree [dir]` | Kiểm tra branch, HEAD và working tree |
+| `ocskill text-read <file> [--start N] [--max N]` | Đọc bounded UTF-8/UTF-16 an toàn khi generic Read nhận nhầm text là binary |
 | `ocskill review-scope [base] [dir]` | Phân tích changed-file coverage và risk hint |
 | `ocskill verification-plan [dir]` | Đề xuất verification phù hợp với project |
 | `ocskill task-graph <PLAN.json>` | Kiểm tra DAG và tính safe waves |
@@ -420,7 +502,7 @@ Model ID do người dùng cấu hình vẫn là nguồn quyết định cuối
 Ví dụ:
 
 ```cmd
-ocskill repo-graph .
+ocskill repo-graph . --compact
 ocskill review-scope main .
 ocskill verification-plan .
 ocskill task-graph .ues-work/checkout/PLAN.json
@@ -431,7 +513,7 @@ ocskill work status checkout .
 
 ## Skills
 
-V11 development hiện có **48 skills**; V10 stable có 39. Router vẫn chỉ chọn tập skill phù hợp thay vì nạp toàn bộ catalog vào mỗi task. Router chỉ chọn các skill phù hợp thay vì nạp toàn bộ catalog vào mỗi task.
+V11 stable hiện có **48 skills**; V10 stable có 39. Router vẫn chỉ chọn tập skill phù hợp thay vì nạp toàn bộ catalog vào mỗi task.
 
 Một số process skill quan trọng:
 
@@ -476,7 +558,7 @@ Plugin cung cấp:
 - context guardrail;
 - permission safety gate;
 - read-only long-task helpers;
-- fresh-session executor runtime qua `ues.dispatch_task`.
+- fresh-session executor runtime qua `ues.dispatch_task` và same-model parallel runtime qua `ues.dispatch_parallel`.
 
 Điều khiển router:
 
@@ -592,10 +674,11 @@ Integration sẽ từ chối ghi đè lên file đang dirty ở root. Safe-wave
 
 ## Evaluation
 
-UES 9.0.0 hiện có:
+V11 hiện có:
 
-- **34 static skill-routing scenarios** phủ 39 skills;
-- **120 V2 router cases** với required routes và negative guards;
+- **43 static skill-routing scenarios** phủ 48 skills;
+- **129 V2 router cases** với required routes và negative guards;
+- **13 V11 contract tasks** across 6 categories;
 - **20 standard live tasks**;
 - **5 long-horizon tasks**;
 - **8 polyglot tasks** cho Python, Java, .NET, Next.js, React Native, SQL migration, monorepo và generated contract;
@@ -667,11 +750,13 @@ Pipeline hiện kiểm tra:
 ```text
 syntax
 → resource validation
+→ docs:check
 → static skill routing
 → V2 router matrix
 → standard hidden-grader integrity
 → long hidden-grader integrity
 → polyglot hidden-grader integrity
+→ V11 contract validation
 → Node tests
 → npm pack --dry-run
 → packed global-install smoke
@@ -712,6 +797,8 @@ UES chỉ quản lý resource có namespace/marker của chính nó và cố g
 - [V7 Intelligence Runtime](docs/V7-INTELLIGENCE-RUNTIME.md)
 - [V8 Intelligence & Reliability](docs/V8-INTELLIGENCE-RELIABILITY.md)
 - [V9 Speed & Intelligence](docs/V9-SPEED-INTELLIGENCE.md)
+- [V12 Weak-Model Intelligence (beta)](docs/V12-WEAK-MODEL-INTELLIGENCE.md)
+- [V13 Parallel Weak-Model Runtime (beta)](docs/V13-PARALLEL-WEAK-MODEL-RUNTIME.md)
 
 ---
 
@@ -732,9 +819,27 @@ npm install -g opencode-agent-skill
 Phiên bản hiện tại:
 
 ```text
-9.0.0
+13.0.0-beta.0
 ```
 
+V13 beta dùng npm dist-tag `next`; `latest` tiếp tục trỏ tới V11 stable cho đến khi các release gate V13 hoàn tất.
+
+Maintainer packaging gate:
+
+```cmd
+npm run ci
+npm pack --dry-run
+npm pack
+```
+
+Trước khi publish, kiểm tra version chưa tồn tại trên registry:
+
+```cmd
+npm view opencode-agent-skill@13.0.0-beta.0 version --registry=https://registry.npmjs.org/
+```
+
+Nếu version chưa tồn tại, prerelease được publish với dist-tag `next`.
+
 ---
 
 ## License