@agdf/cli 0.4.0 → 0.4.2

package/README.md

@@ -27,6 +27,7 @@ Install the user-wide OpenCode hook:
 
 ```bash
 npx --yes @agdf/cli@latest opencode
+npx --yes @agdf/cli@latest opencode-status
 ```
 
 Install the AGDF CLI globally when `agdf` should be available as a regular
@@ -36,6 +37,7 @@ shell command on your machine:
 npm install -g @agdf/cli
 agdf init
 agdf doctor
+agdf gate-check --status-card
 agdf gate-check --json
 ```
 
@@ -49,7 +51,7 @@ Use it to:
 
 - install AGDF instructions and skills into a target repository
 - initialize durable `.agdf/control` state when a repository should own it
-- run deterministic validators such as `doctor` and `gate-check --json`
+- run compact interactive checks such as `gate-check --status-card` and deterministic validators such as `doctor` and `gate-check --json`
 - prepare Codex, GitHub Copilot and OpenCode surfaces from the same source of
   truth while keeping Claude Code installation explicitly separate
 
@@ -74,6 +76,7 @@ authoritative reusable format, not AGDF's internal project backlog.
 | `codex-repo` | Add a repository-local Codex marketplace and AGDF plugin copy. |
 | `claude` | Install the AGDF plugin globally for Claude Code. |
 | `opencode` | Install the AGDF npm plugin as a user-wide OpenCode hook. |
+| `opencode-status` | Report OpenCode global config, package loadability, session signals and repository surface presence. |
 | `opencode-repo` | Add OpenCode repository instructions, subagents, permissions and control templates. |
 | `copilot` | Add `AGENTS.md`, Copilot instructions, skills and control templates. |
 | `both` | Prepare the repository-file and plugin surfaces together. |
@@ -81,23 +84,38 @@ authoritative reusable format, not AGDF's internal project backlog.
 | `config --language de\|en` | Persist the project language without creating the full control scaffold. |
 | `doctor [--json]` | Check whether the durable control state is consistent and actionable. |
 | `gate-check [--json]` | Report the current gate, blockers and next permitted action. |
+| `gate-check --status-card` | Print compact interactive gate status without full JSON. |
 | `delivery-map [--json]` | Report artefact relationships, evidence, risks and Context Graph effects. |
+| `delivery-path-search --surface <name> [--json]` | Compare bounded high-impact delivery paths before implementation; advisory only. |
 
 Examples:
 
 ```bash
 npx --yes @agdf/cli@latest opencode
+npx --yes @agdf/cli@latest opencode-status --json
 npx --yes @agdf/cli@latest opencode-repo
 npx --yes @agdf/cli@latest config --language en
 npx --yes @agdf/cli@latest init
 npx --yes @agdf/cli@latest doctor
+npx --yes @agdf/cli@latest gate-check --status-card
 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
 ```
 
 The CLI validators provide deterministic evidence for agents and automation.
 They do not replace AGDF skill judgement or user approvals.
 
+Delivery Path Search requires live `.agdf/control/AGDF_RUN.md` state with explicit
+allowed and forbidden actions. Codex is the executable evaluator in this
+release. Claude Code, Copilot and OpenCode expose the shared skill and contract,
+but do not yet ship native executable evaluators.
+
+Use `--persist` only when the redacted decision should become durable scope
+evidence. It writes `DELIVERY_PATH_SEARCH.json` and
+`DELIVERY_PATH_SEARCH.md` under `.agdf/control/artefacts/<scope>/`. Then run
+`gate-check`; the recommendation never grants permission.
+
 ## Surface Notes
 
 - **Codex:** `codex` installs the AGDF plugin globally for Codex, while
@@ -105,7 +123,8 @@ They do not replace AGDF skill judgement or user approvals.
   repository.
 - **Claude Code:** `claude` installs the AGDF plugin globally for Claude Code.
 - **OpenCode:** `opencode` installs the user-wide npm plugin hook, while
-  `opencode-repo` writes the repository instructions, agents and permissions
+  `opencode-status` verifies global config, package loadability, session signals
+  and repository surface presence. `opencode-repo` writes the repository instructions, agents and permissions
   AGDF needs. Repository instructions, generated agents and control files remain
   the AGDF source of truth. The generated
   OpenCode agents are intentional `mode: subagent` workflow controls, not

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agdf/cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Primary AGDF CLI for repository-local AI governance, delivery controls and agent setup.",
   "type": "module",
   "files": [
@@ -15,7 +15,7 @@
     "smoke-test": "node ./scripts/smoke-test.js"
   },
   "dependencies": {
-    "create-agdf": "0.4.0"
+    "create-agdf": "0.4.2"
   },
   "keywords": [
     "agdf",