@agdf/cli 0.20.2 → 0.31.0

package/README.md

@@ -7,7 +7,7 @@ delivery: repository-local agent instructions, durable control files,
 machine-checkable gate decisions and consistent setup for Codex, Claude Code,
 GitHub Copilot and OpenCode.
 
-GitHub Copilot and OpenCode are **experimentally supported in 0.20.x**. Both have adapters and
+GitHub Copilot and OpenCode are **experimentally supported in 0.30.0**. Both have adapters and
 automated regression tests; native qualification is not currently claimed. Tests with simulated
 hosts do not establish behavior in an actual Copilot or OpenCode session. See the
 [host compatibility report](https://github.com/ArndtGold/ai-native-governance-delivery-framework/blob/main/docs/compatibility/HOST_COMPATIBILITY.md)
@@ -98,7 +98,7 @@ Claude Desktop UI support. See [MCP and UI by host](https://github.com/ArndtGold
 
 ### OpenCode
 
-**Experimental support in 0.20.x.**
+**Experimental support in 0.30.0.**
 
 ```bash
 npx --yes @agdf/cli@latest opencode
@@ -121,7 +121,7 @@ command from that repository, then load `agdf-global-gate-check` for an AGDF del
 
 ### GitHub Copilot
 
-**Experimental support in 0.20.x.**
+**Experimental support in 0.30.0.**
 
 ```bash
 npx --yes @agdf/cli@latest copilot
@@ -185,10 +185,10 @@ authoritative reusable format, not AGDF's internal project backlog.
 | `codex` | Install the AGDF plugin globally for Codex. |
 | `codex-repo` | Add a repository-local Codex marketplace and AGDF plugin copy. |
 | `claude` | Install the AGDF plugin globally for Claude Code. |
-| `opencode` | Experimental in 0.20.x: install the AGDF npm plugin and global native skills for OpenCode. |
+| `opencode` | Experimental in 0.30.0: install the AGDF npm plugin and global native skills for OpenCode. |
 | `opencode-status` | Report OpenCode global config, package loadability, session signals and repository surface presence. |
-| `opencode-repo` | Experimental in 0.20.x: add durable repository activation and control templates for the global OpenCode runtime. |
-| `copilot` | Experimental in 0.20.x: install the AGDF plugin globally through Copilot CLI and verify its skills. |
+| `opencode-repo` | Experimental in 0.30.0: add durable repository activation and control templates for the global OpenCode runtime. |
+| `copilot` | Experimental in 0.30.0: install the AGDF plugin globally through Copilot CLI and verify its skills. |
 | `init` | Create durable `.agdf/control` files when repository-owned control state is required. |
 | `config --language <tag>` | Persist a BCP 47 project language such as `de`, `en` or `fr-CA` without creating the full control scaffold. |
 | `doctor [--json]` | Check whether the durable control state is consistent and actionable. |
@@ -199,6 +199,12 @@ authoritative reusable format, not AGDF's internal project backlog.
 | `run-create --run <run_id>` | Create a canonical run-scoped `RUN_STATE.md`. |
 | `run-migrate [--run <run_id>]` | Explicitly migrate legacy run state into the canonical run-scoped layout. |
 | `run-render-legacy --run <run_id>` | Render the selected canonical run as a non-authoritative legacy projection. |
+| `run-update --run <run_id> --revision <revision_id>` | Record a deliberate edit of the run state or its artefacts as a new sealed revision. |
+| `run-step --run <run_id> --revision <revision_id> --step <step>` | Record one standard transition such as UR registration, Mode/Slice route, evidence or Code Review. |
+| `run-present --run <run_id> --gate <gate> --revision <revision_id>` | Prepare the exact approval presentation for the current gate. |
+| `run-approve --run <run_id> --gate <gate> --revision <revision_id> --presentation <id> --response "Approval: <gate>"` | Record a deliberate gate approval for the presented revision. |
+| `run-recovery --run <run_id> --action <inspect\|preview\|apply>` | Inspect, preview and apply recovery of a run whose seal no longer matches. |
+| `run-close --action <preview\|apply>` | End active runs as `superseded` or `abandoned`: preview first, then apply with the exact phrase `Close runs: <preview_id>`; closures are final. |
 
 Examples:
 
@@ -214,6 +220,8 @@ npx --yes @agdf/cli@latest gate-check --json
 npx --yes @agdf/cli@latest delivery-map --json
 npx --yes @agdf/cli@latest delivery-path-search --surface codex --json
 npx --yes @agdf/cli@latest delivery-path-search --surface codex --generate-candidates --json
+agdf run-close --action preview --run payment-limit-v1 --outcome superseded --reason "Replaced by the limit redesign" --successor-run payment-limit-v2
+agdf run-close --action apply --preview-id 3f2a9c1e --confirmation "Close runs: 3f2a9c1e"
 ```
 
 The CLI validators provide deterministic evidence for agents and automation.
@@ -237,7 +245,7 @@ evidence. It writes `DELIVERY_PATH_SEARCH.json` and
 ## Surface Notes
 
 See [Quick Start](#quick-start) for what each command installs and its global-vs-repository scope.
-Copilot and OpenCode remain experimental in 0.20.x. OpenCode loads global native skills from
+Copilot and OpenCode remain experimental in 0.30.0. OpenCode loads global native skills from
 `skills/agdf-global-*/` in its configuration directory; `.agdf/control/` owns durable repository
 state. Load `agdf-global-gate-check` through OpenCode's native `skill` tool for an AGDF delivery
 request. Copilot loads its `agdf-` skills from the installed plugin, not a generated repository

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agdf/cli",
-  "version": "0.20.2",
+  "version": "0.31.0",
   "description": "Primary AGDF CLI for repository-local AI governance, delivery controls and agent setup.",
   "type": "module",
   "engines": {
@@ -16,7 +16,7 @@
   },
   "scripts": {},
   "dependencies": {
-    "create-agdf": "0.20.2"
+    "create-agdf": "0.31.0"
   },
   "keywords": [
     "agdf",