opencode-agent-skill 12.0.0-beta.0 → 13.0.0-beta.1

package/CHANGELOG.md

@@ -6,6 +6,54 @@ 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.1] - 2026-09-23
+
+### Fixed
+- Hardened V2 prompt aliases for ChatGPT-style pasted prompts: BOM/zero-width prefixes and whole-prompt markdown fences are normalized before alias detection.
+- Bounded the text sent to `ocskill task-policy` so very large pasted prompts no longer risk Windows command-line length failures; the full user prompt still goes to the model while only a bounded head/tail classification view goes through the CLI.
+- Routed skill classification from the actual user request instead of the expanded command template, reducing template-induced over-routing on long prompts.
+- Kept installer result shape stable with `promptAliases: []` on foreign-state refusal.
+
+### Regression coverage
+- Added fenced-paste, BOM, 70k-character policy-input and oversized multiline `/ues-run` regression tests.
+
+## [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

package/README.md

@@ -1,7 +1,7 @@
 # OpenCode Universal Engineering System (UES)
 
-> **V12 beta: 12.0.0-beta.0** — weak-model intelligence foundation với empirical routing, context-quality metrics, plan-scoped execution và repo-scale validation.
-> **Stable latest vẫn là V11: 11.0.0.** Dùng `npm install -g opencode-agent-skill@next` để thử V12 beta.
+> **V13 beta: 13.0.0-beta.1** — 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.1`; 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 baseline
+
+Baseline beta.0 đã được kiểm tra local trên Windows 10 với OpenCode V2.0.15; beta.1 phải chạy lại full gate trước khi publish:
+
+- `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
@@ -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:
 
@@ -716,6 +798,7 @@ UES chỉ quản lý resource có namespace/marker của chính nó và cố g
 - [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)
 
 ---
 
@@ -736,10 +819,26 @@ npm install -g opencode-agent-skill
 Phiên bản hiện tại:
 
 ```text
-12.0.0-beta.0
+13.0.0-beta.1
+```
+
+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.1 version --registry=https://registry.npmjs.org/
 ```
 
-V12 beta dùng npm dist-tag `next`; `latest` tiếp tục trỏ tới V11 stable cho đến khi các release gate V12 hoàn tất.
+Nếu version chưa tồn tại, prerelease được publish với dist-tag `next`.
 
 ---