@webpresso/opencode-plugin 3.1.22 → 3.1.23

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@webpresso/opencode-plugin",
3
- "version": "3.1.22",
3
+ "version": "3.1.23",
4
4
  "private": false,
5
5
  "description": "OpenCode plugin adapter package for Webpresso agent-kit.",
6
6
  "homepage": "https://github.com/webpresso/agent-kit#readme",
@@ -16,9 +16,14 @@
16
16
  "files": [
17
17
  "index.js",
18
18
  "plugin-skill-ownership.json",
19
- "skills",
19
+ "skills/**/SKILL.md",
20
+ "skills/**/references/**",
21
+ "skills/**/LICENSE*",
20
22
  "LICENSE",
21
- "README.md"
23
+ "!README.md",
24
+ "!CHANGELOG.md",
25
+ "!**/*.test.js",
26
+ "!**/*.test.ts"
22
27
  ],
23
28
  "type": "module",
24
29
  "sideEffects": false,
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 1,
3
3
  "host": "opencode",
4
4
  "packageName": "@webpresso/opencode-plugin",
5
- "packageVersion": "3.1.22",
5
+ "packageVersion": "3.1.23",
6
6
  "runtimeDirs": [],
7
7
  "skills": {
8
8
  "ai-deslop": {
@@ -87,7 +87,7 @@
87
87
  "digest": "sha256:bed3684a850651534f315d355cdeae50d951c429817df0f105cccdb7f4e1561b"
88
88
  },
89
89
  "ultragoal": {
90
- "digest": "sha256:dc6d3b2bd48a494d7a5cd30ad9c6c9999989b9920ca06ccd1f86a7cfaff60d54"
90
+ "digest": "sha256:12bec22b2125593376f0899ad3bd7fac9e47362cc384fab15c2f43daa3a842f9"
91
91
  },
92
92
  "verify": {
93
93
  "digest": "sha256:9d9faa184b310d46d5a266ebe46bbf0819df526035dc10a6c13475097e3a284b"
@@ -7,7 +7,7 @@ scope: repo
7
7
  applies_to: [agents]
8
8
  related: [autopilot, plan-refine, verify]
9
9
  created: "2026-07-10"
10
- last_reviewed: "2026-07-10"
10
+ last_reviewed: "2026-07-20"
11
11
  name: ultragoal
12
12
  description: "Run durable multi-blueprint ultragoals through evidence-gated handoffs."
13
13
  argument-hint: "<new|status|handoff|run|cancel> [brief]"
@@ -19,9 +19,26 @@ Use `wp ultragoal` as the durable controller for work spanning one or more bluep
19
19
 
20
20
  ## Protocol
21
21
 
22
- 1. Create or resume the ultragoal in a managed blueprint owner worktree.
22
+ 1. Create or resume the ultragoal in a managed blueprint owner worktree (never main as controller).
23
23
  2. Read `wp ultragoal status`, execute only the current phase handoff, then call `wp ultragoal run` again.
24
24
  3. Complete blueprint tasks only through `wp_blueprint_task_verify` with passing evidence.
25
25
  4. Stop when the controller reports `complete`, `cancelled`, blocked guard exhaustion, or `WP_ULTRAGOAL_DISABLE=1`.
26
26
 
27
27
  The blueprint engine owns task status and approval gates. The ultragoal controller must never self-approve, directly mark a task done, bypass review provenance, or mutate the primary checkout. Keep every loop bounded and never increase timeouts.
28
+
29
+ ## Tooling-aligned evidence (QA / land)
30
+
31
+ - **QA phase** prefers **GitHub required checks** for the worktree PR (`gh pr view` + `gh pr checks --required`) when:
32
+ - PR is `OPEN` or `MERGED`
33
+ - required checks are green (same evaluator as land)
34
+ - PR head source snapshot matches the clean worktree HEAD snapshot
35
+ - If no PR-bound green CI is available, ultragoal falls back to local **`wp qa`** (`vp run qa`).
36
+ - Do **not** raise timeouts to paper over incomplete worktrees; open a PR early so CI can satisfy QA.
37
+ - Prefer `wp pr wait` / `gh run watch` while babysitting; do not invent multi-sleep poll loops.
38
+ - **Land** still requires a **MERGED** PR with green required checks bound to the projected source snapshot.
39
+
40
+ ## Snapshot / dirty worktree
41
+
42
+ - Ultragoal ledger appends to blueprint `reviews.md` / `review-events.jsonl` / `review-artifacts/**`.
43
+ - These paths under both `blueprints/**` and monorepo `webpresso/blueprints/**` are **evidence-only dirt** and must not fail `createCleanSourceSnapshot`.
44
+ - Dirty **source** paths (including `_overview.md` task status edits) still fail closed until committed.
package/README.md DELETED
@@ -1,14 +0,0 @@
1
- # @webpresso/opencode-plugin
2
-
3
- `@webpresso/opencode-plugin` is the OpenCode host adapter package for Agent
4
- Kit. It provides the native OpenCode npm plugin surface, registered through
5
- `opencode.json`, with the package module exports and metadata OpenCode expects.
6
- It also ships the same catalog-owned default `skills/` payload as the Claude
7
- and Codex adapter packages for host/package parity.
8
-
9
- The root `@webpresso/agent-kit` package is CLI/core only: it ships `wp`, MCP
10
- tools, audits, blueprints, session memory, docs, and catalog sources, but it
11
- does not ship this OpenCode payload from the root package. OpenCode delivery is
12
- native npm plugin registration only; there is no generated bridge, MCP bridge,
13
- or MCP injection payload in this package, and no `.opencode/skills` fallback is
14
- projected.