@agdf/cli 0.3.5 → 0.4.1

package/README.md

@@ -13,21 +13,31 @@ GitHub Copilot and OpenCode.
 
 ## Quick Start
 
-Run commands inside the target Git repository:
+Prepare one repository:
 
 ```bash
 npx --yes @agdf/cli@latest codex
-npx --yes @agdf/cli@latest opencode
+npx --yes @agdf/cli@latest codex-repo
+npx --yes @agdf/cli@latest claude
+npx --yes @agdf/cli@latest opencode-repo
 npx --yes @agdf/cli@latest copilot
 ```
 
-Install globally when AGDF should be available as a regular command on your
-machine:
+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
+shell command on your machine:
 
 ```bash
 npm install -g @agdf/cli
 agdf init
 agdf doctor
+agdf gate-check --status-card
 agdf gate-check --json
 ```
 
@@ -41,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
 
@@ -62,22 +72,31 @@ authoritative reusable format, not AGDF's internal project backlog.
 
 | Command | Purpose |
 | --- | --- |
-| `codex` | Add a repository-local Codex marketplace and AGDF plugin copy. |
-| `opencode` | Add OpenCode instructions, agents, permissions and the npm plugin entry. |
+| `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` | 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. |
 | `init` | Create durable `.agdf/control` files when repository-owned control state is required. |
 | `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. |
 
 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
 ```
@@ -87,13 +106,18 @@ They do not replace AGDF skill judgement or user approvals.
 
 ## Surface Notes
 
-- **Codex:** `codex` prepares a repository-local marketplace. For a global
-  installation, use the Codex plugin marketplace commands documented on the
-  [AGDF website](https://agdf.iself.eu/#setup-codex).
-- **Claude Code:** install the AGDF plugin with the Claude Code CLI; this is not
-  an `@agdf/cli` bootstrap target.
-- **OpenCode:** `opencode` writes the npm plugin entry together with the
-  repository instructions, agents and permissions AGDF needs.
+- **Codex:** `codex` installs the AGDF plugin globally for Codex, while
+  `codex-repo` prepares a repository-local marketplace for testing AGDF in one
+  repository.
+- **Claude Code:** `claude` installs the AGDF plugin globally for Claude Code.
+- **OpenCode:** `opencode` installs the user-wide npm plugin hook, while
+  `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
+  `.opencode/skills/` entries or primary menu agents; use `@agdf-gate-check`
+  as the visible entry point for new build/change intent.
 - **GitHub Copilot:** `copilot` writes repository instructions and skills. If
   `AGENTS.md` already exists, AGDF preserves it and writes `AGENTS.agdf.md` for
   manual merging.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agdf/cli",
-  "version": "0.3.5",
+  "version": "0.4.1",
   "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.3.5"
+    "create-agdf": "0.4.1"
   },
   "keywords": [
     "agdf",