@webpresso/codex-plugin 3.1.22 → 3.1.24

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-kit",
-  "version": "3.1.22",
+  "version": "3.1.24",
   "description": "Webpresso agent-kit: blueprints, skills, hooks, and MCP server",
   "author": {
     "name": "Webpresso",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpresso/codex-plugin",
-  "version": "3.1.22",
+  "version": "3.1.24",
   "private": false,
   "description": "Codex plugin adapter for Webpresso agent-kit skills, hooks, and MCP runtime.",
   "homepage": "https://github.com/webpresso/agent-kit#readme",
@@ -17,11 +17,16 @@
     ".codex-plugin",
     "plugin-skill-ownership.json",
     ".mcp.json",
-    "skills",
+    "skills/**/SKILL.md",
+    "skills/**/references/**",
+    "skills/**/LICENSE*",
     "hooks",
     "bin/wp",
     "LICENSE",
-    "README.md"
+    "!README.md",
+    "!CHANGELOG.md",
+    "!**/*.test.js",
+    "!**/*.test.ts"
   ],
   "type": "module",
   "sideEffects": false,

package/plugin-skill-ownership.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "host": "codex",
   "packageName": "@webpresso/codex-plugin",
-  "packageVersion": "3.1.22",
+  "packageVersion": "3.1.24",
   "runtimeDirs": [".codex/skills", ".agents/skills"],
   "skills": {
     "ai-deslop": {
@@ -87,7 +87,7 @@
       "digest": "sha256:bed3684a850651534f315d355cdeae50d951c429817df0f105cccdb7f4e1561b"
     },
     "ultragoal": {
-      "digest": "sha256:dc6d3b2bd48a494d7a5cd30ad9c6c9999989b9920ca06ccd1f86a7cfaff60d54"
+      "digest": "sha256:12bec22b2125593376f0899ad3bd7fac9e47362cc384fab15c2f43daa3a842f9"
     },
     "verify": {
       "digest": "sha256:9d9faa184b310d46d5a266ebe46bbf0819df526035dc10a6c13475097e3a284b"

package/skills/ultragoal/SKILL.md

@@ -7,7 +7,7 @@ scope: repo
 applies_to: [agents]
 related: [autopilot, plan-refine, verify]
 created: "2026-07-10"
-last_reviewed: "2026-07-10"
+last_reviewed: "2026-07-20"
 name: ultragoal
 description: "Run durable multi-blueprint ultragoals through evidence-gated handoffs."
 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
 
 ## Protocol
 
-1. Create or resume the ultragoal in a managed blueprint owner worktree.
+1. Create or resume the ultragoal in a managed blueprint owner worktree (never main as controller).
 2. Read `wp ultragoal status`, execute only the current phase handoff, then call `wp ultragoal run` again.
 3. Complete blueprint tasks only through `wp_blueprint_task_verify` with passing evidence.
 4. Stop when the controller reports `complete`, `cancelled`, blocked guard exhaustion, or `WP_ULTRAGOAL_DISABLE=1`.
 
 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.
+
+## Tooling-aligned evidence (QA / land)
+
+- **QA phase** prefers **GitHub required checks** for the worktree PR (`gh pr view` + `gh pr checks --required`) when:
+  - PR is `OPEN` or `MERGED`
+  - required checks are green (same evaluator as land)
+  - PR head source snapshot matches the clean worktree HEAD snapshot
+- If no PR-bound green CI is available, ultragoal falls back to local **`wp qa`** (`vp run qa`).
+- Do **not** raise timeouts to paper over incomplete worktrees; open a PR early so CI can satisfy QA.
+- Prefer `wp pr wait` / `gh run watch` while babysitting; do not invent multi-sleep poll loops.
+- **Land** still requires a **MERGED** PR with green required checks bound to the projected source snapshot.
+
+## Snapshot / dirty worktree
+
+- Ultragoal ledger appends to blueprint `reviews.md` / `review-events.jsonl` / `review-artifacts/**`.
+- These paths under both `blueprints/**` and monorepo `webpresso/blueprints/**` are **evidence-only dirt** and must not fail `createCleanSourceSnapshot`.
+- Dirty **source** paths (including `_overview.md` task status edits) still fail closed until committed.

package/README.md

@@ -1,25 +0,0 @@
-# @webpresso/codex-plugin
-
-`@webpresso/codex-plugin` is the Codex CLI host adapter package for Agent Kit.
-It ships the Codex plugin manifest, packaged skills, hook metadata, a
-package-local MCP manifest, and a package-local `bin/wp` shim that forwards to
-an Agent Kit `wp` CLI resolved at runtime.
-
-This adapter does not declare `@webpresso/agent-kit` as a package dependency.
-Its package-local `bin/wp` shim resolves the CLI in this order:
-
-1. `WEBPRESSO_WP_BIN`, when set to an executable file.
-2. The source-checkout root `../../bin/wp`, for local adapter development.
-3. `@webpresso/agent-kit/bin/wp`, when an integrator installed the root package
-   alongside this adapter.
-4. `wp` on `PATH`.
-
-If none of those candidates is available, install or update the root package
-through `wp setup`, `wp update`, or your package manager, or set
-`WEBPRESSO_WP_BIN` to the desired executable. The shim preserves
-`WP_SKIP_UPDATE_CHECK=1` by default for host MCP invocations.
-
-The root `@webpresso/agent-kit` package is CLI/core only: it ships `wp`, MCP
-tools, audits, blueprints, session memory, docs, and catalog sources, but it
-does not ship this Codex payload from the root package. Use this adapter when
-you need the Codex-native plugin delivery surface.