create-agdf 0.3.0 → 0.3.1

package/README.md

@@ -7,12 +7,12 @@ Bootstrap AGDF repository instructions and a machine-checkable control loop for
 Preferred long-term CLI shape:
 
 ```bash
-npx --yes agdf@latest codex
-npx --yes agdf@latest opencode
-npx --yes agdf@latest init
-npx --yes agdf@latest config --language en
-npx --yes agdf@latest doctor
-npx --yes agdf@latest gate-check --json
+npx --yes @agdf-runtime/cli@latest codex
+npx --yes @agdf-runtime/cli@latest opencode
+npx --yes @agdf-runtime/cli@latest init
+npx --yes @agdf-runtime/cli@latest config --language en
+npx --yes @agdf-runtime/cli@latest doctor
+npx --yes @agdf-runtime/cli@latest gate-check --json
 ```
 
 Backward-compatible scaffold usage:

package/bin/create-agdf.js

@@ -125,11 +125,11 @@ function printUsage() {
   console.log(`create-agdf
 
 Preferred AGDF CLI:
-  npx --yes agdf@latest codex
-  npx --yes agdf@latest opencode
-  npx --yes agdf@latest init
-  npx --yes agdf@latest doctor
-  npx --yes agdf@latest gate-check --json
+  npx --yes @agdf-runtime/cli@latest codex
+  npx --yes @agdf-runtime/cli@latest opencode
+  npx --yes @agdf-runtime/cli@latest init
+  npx --yes @agdf-runtime/cli@latest doctor
+  npx --yes @agdf-runtime/cli@latest gate-check --json
 
 Scaffold-compatible npm create usage:
   npm create agdf@latest -- codex
@@ -439,13 +439,13 @@ function printNextSteps(target, destination, files, wroteAgentsFragment, wroteOp
   }
   if (target === "init") {
     console.log("- Fill .agdf/control/AGDF_RUN.md with the current gate, evidence and next allowed action.");
-    console.log("- Run npx --yes agdf@latest doctor to check the control state before the next agent run.");
+    console.log("- Run npx --yes @agdf-runtime/cli@latest doctor to check the control state before the next agent run.");
     console.log("- Commit the live control files once they represent the repository's current delivery state.");
     return;
   }
   if (target === "config") {
     console.log("- Restart or start a new agent session so the AGDF SessionStart hook reads the updated project language config.");
-    console.log("- Run npx --yes agdf@latest doctor when this repository also uses durable AGDF control state.");
+    console.log("- Run npx --yes @agdf-runtime/cli@latest doctor when this repository also uses durable AGDF control state.");
     return;
   }
   if (wroteAgentsFragment) {
@@ -465,11 +465,11 @@ function printNextSteps(target, destination, files, wroteAgentsFragment, wroteOp
     console.log(`- OpenCode will install the ${pluginDefinition.opencode.npmPackage} npm plugin from opencode.json at startup.`);
     console.log("- Start OpenCode in this repository; it will load opencode.json, .opencode/AGDF.md and the AGDF subagents.");
     console.log("- Use @agdf-gate-check for new build/change intent or unclear approval before later artefacts or implementation.");
-    console.log("- Run npx --yes agdf@latest init when the repository needs live AGDF control files.");
+    console.log("- Run npx --yes @agdf-runtime/cli@latest init when the repository needs live AGDF control files.");
   }
   if (target === "copilot" || target === "both") {
     console.log("- In GitHub Copilot CLI, run /instructions after the AGENTS.md step is complete to confirm that AGDF instructions and the repository skills are visible.");
-    console.log("- Run npx --yes agdf@latest init when the repository needs live AGDF control files.");
+    console.log("- Run npx --yes @agdf-runtime/cli@latest init when the repository needs live AGDF control files.");
   }
   console.log("- Commit the generated files so the repository becomes the source of truth.");
 }
@@ -573,7 +573,7 @@ function evaluateDoctor(targetDir) {
         ? "Live control file is missing; only the template exists."
         : "Required live control file is missing.",
       relativePath,
-      "Run npx --yes agdf@latest init only when the repository should own durable AGDF control state or deterministic setup is explicitly needed.",
+      "Run npx --yes @agdf-runtime/cli@latest init only when the repository should own durable AGDF control state or deterministic setup is explicitly needed.",
     );
   }
 
@@ -1188,7 +1188,7 @@ function evaluateGateCheck(targetDir) {
     allowed = [
       "draft the minimal UR for the requested change in the response",
       "request exact approval: Approval: UR",
-      "run npx --yes agdf@latest init only when durable control state or deterministic setup is explicitly needed",
+      "run npx --yes @agdf-runtime/cli@latest init only when durable control state or deterministic setup is explicitly needed",
     ];
     forbidden = ["create PRD", "create SD", "create TP", "run Brownfield Analysis", "implement code", "claim QA or release readiness"];
     nextAllowedAction = "Draft the minimal UR for the request in the response, then ask for exact approval: Approval: UR. Do not write a full .agdf/control scaffold unless durable control state or deterministic setup is explicitly needed.";

package/generated/.agdf/control/README.md

@@ -49,21 +49,21 @@ Keep these files small and reviewable. They are control artefacts, not a second
 Create the live files with:
 
 ```bash
-npx --yes agdf@latest init
+npx --yes @agdf-runtime/cli@latest init
 ```
 
 If only the project language preference is missing or should change after plugin installation, write just the config file:
 
 ```bash
-npx --yes agdf@latest config --language en
+npx --yes @agdf-runtime/cli@latest config --language en
 ```
 
 Then check whether the live state is actionable:
 
 ```bash
-npx --yes agdf@latest doctor
-npx --yes agdf@latest doctor --json
-npx --yes agdf@latest gate-check --json
+npx --yes @agdf-runtime/cli@latest doctor
+npx --yes @agdf-runtime/cli@latest doctor --json
+npx --yes @agdf-runtime/cli@latest gate-check --json
 ```
 
 `doctor` does not replace agent judgment. It catches basic control failures: missing live files, missing current gate, missing next allowed action, empty evidence, empty backlog pointer, empty source-of-truth registry, duplicate active SoT rows and invalid quality contracts.

package/generated/.github/skills/agdf-gate-check/SKILL.md

@@ -41,10 +41,10 @@ Use `init` only when the user explicitly asks for durable AGDF control state, th
 Use the executable control path when a machine-readable check is requested, when the gate state is ambiguous, when CI or PR evidence is needed, or when a repository-local automation needs JSON output:
 
 ```bash
-npx --yes agdf@latest init
-npx --yes agdf@latest doctor --json
-npx --yes agdf@latest gate-check --json
-npx --yes agdf@latest delivery-map --json
+npx --yes @agdf-runtime/cli@latest init
+npx --yes @agdf-runtime/cli@latest doctor --json
+npx --yes @agdf-runtime/cli@latest gate-check --json
+npx --yes @agdf-runtime/cli@latest delivery-map --json
 ```
 
 `init` creates the control scaffold. `doctor` checks whether `.agdf/control/` is actionable. `agdf-gate-check` consumes that result and `AGDF_RUN.md` to report the operative process decision: `open | blocked`, current gate, blocking reason, missing approval, allowed outputs, forbidden outputs, next allowed action and evidence references.

package/generated/.opencode/agents/agdf-gate-check.md

@@ -46,10 +46,10 @@ Use `init` only when the user explicitly asks for durable AGDF control state, th
 Use the executable control path when a machine-readable check is requested, when the gate state is ambiguous, when CI or PR evidence is needed, or when a repository-local automation needs JSON output:
 
 ```bash
-npx --yes agdf@latest init
-npx --yes agdf@latest doctor --json
-npx --yes agdf@latest gate-check --json
-npx --yes agdf@latest delivery-map --json
+npx --yes @agdf-runtime/cli@latest init
+npx --yes @agdf-runtime/cli@latest doctor --json
+npx --yes @agdf-runtime/cli@latest gate-check --json
+npx --yes @agdf-runtime/cli@latest delivery-map --json
 ```
 
 `init` creates the control scaffold. `doctor` checks whether `.agdf/control/` is actionable. `agdf-gate-check` consumes that result and `AGDF_RUN.md` to report the operative process decision: `open | blocked`, current gate, blocking reason, missing approval, allowed outputs, forbidden outputs, next allowed action and evidence references.

package/generated/plugins/agdf/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agdf",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Codex-first workflow skills for gated, auditable AI-assisted software delivery.",
   "author": {
     "name": "AI-native Governance & Delivery Framework",

package/generated/plugins/agdf/control/README.md

@@ -49,21 +49,21 @@ Keep these files small and reviewable. They are control artefacts, not a second
 Create the live files with:
 
 ```bash
-npx --yes agdf@latest init
+npx --yes @agdf-runtime/cli@latest init
 ```
 
 If only the project language preference is missing or should change after plugin installation, write just the config file:
 
 ```bash
-npx --yes agdf@latest config --language en
+npx --yes @agdf-runtime/cli@latest config --language en
 ```
 
 Then check whether the live state is actionable:
 
 ```bash
-npx --yes agdf@latest doctor
-npx --yes agdf@latest doctor --json
-npx --yes agdf@latest gate-check --json
+npx --yes @agdf-runtime/cli@latest doctor
+npx --yes @agdf-runtime/cli@latest doctor --json
+npx --yes @agdf-runtime/cli@latest gate-check --json
 ```
 
 `doctor` does not replace agent judgment. It catches basic control failures: missing live files, missing current gate, missing next allowed action, empty evidence, empty backlog pointer, empty source-of-truth registry, duplicate active SoT rows and invalid quality contracts.

package/generated/plugins/agdf/hooks/session-start.sh

@@ -8,7 +8,7 @@ ROUTER="${META_DIR}/agdf-agent-router.md"
 CONSTITUTION="${META_DIR}/agdf-constitution.md"
 CONFIG_PATH="${PWD}/.agdf/control/config.json"
 
-CONFIG_HINT="Project config: .agdf/control/config.json not found. Use npx --yes agdf@latest config --language de|en to persist the project language."
+CONFIG_HINT="Project config: .agdf/control/config.json not found. Use npx --yes @agdf-runtime/cli@latest config --language de|en to persist the project language."
 if [[ -f "${CONFIG_PATH}" ]]; then
   CONFIG_HINT="$(CONFIG_PATH="${CONFIG_PATH}" node <<'NODE' 2>/dev/null || true
 const fs = require("node:fs");
@@ -20,7 +20,7 @@ try {
   const runtime = config.runtime_language || "en";
   console.log(`Project config: .agdf/control/config.json (artefacts=${artefacts}, chat=${chat}, runtime=${runtime}).`);
 } catch {
-  console.log("Project config: .agdf/control/config.json exists but is not valid JSON. Run npx --yes agdf@latest doctor.");
+  console.log("Project config: .agdf/control/config.json exists but is not valid JSON. Run npx --yes @agdf-runtime/cli@latest doctor.");
 }
 NODE
 )"

package/generated/plugins/agdf/meta/agdf-plugin.definition.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "agdf",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "displayName": "AI Governance & Delivery Framework",
   "developerName": "AI-native Governance & Delivery Framework",
   "description": "Codex-first workflow skills for gated, auditable AI-assisted software delivery.",

package/generated/plugins/agdf/skills/gate-check/SKILL.md

@@ -41,10 +41,10 @@ Use `init` only when the user explicitly asks for durable AGDF control state, th
 Use the executable control path when a machine-readable check is requested, when the gate state is ambiguous, when CI or PR evidence is needed, or when a repository-local automation needs JSON output:
 
 ```bash
-npx --yes agdf@latest init
-npx --yes agdf@latest doctor --json
-npx --yes agdf@latest gate-check --json
-npx --yes agdf@latest delivery-map --json
+npx --yes @agdf-runtime/cli@latest init
+npx --yes @agdf-runtime/cli@latest doctor --json
+npx --yes @agdf-runtime/cli@latest gate-check --json
+npx --yes @agdf-runtime/cli@latest delivery-map --json
 ```
 
 `init` creates the control scaffold. `doctor` checks whether `.agdf/control/` is actionable. `gate-check` consumes that result and `AGDF_RUN.md` to report the operative process decision: `open | blocked`, current gate, blocking reason, missing approval, allowed outputs, forbidden outputs, next allowed action and evidence references.

package/opencode-plugin.js

@@ -24,7 +24,7 @@ export const AGDFPlugin = async ({ directory, client }) => {
         "## AGDF Runtime Reminder",
         "Use `.opencode/AGDF.md`, `.opencode/agents/` and `.agdf/control/` as the AGDF source for this OpenCode session.",
         "For new build/change intent or unclear approval, route first to `agdf-gate-check` before later artefacts or implementation.",
-        "Use `npx --yes agdf@latest gate-check --json` only as deterministic proof, not as a replacement for AGDF judgement.",
+        "Use `npx --yes @agdf-runtime/cli@latest gate-check --json` only as deterministic proof, not as a replacement for AGDF judgement.",
       ].join("\n"));
     },
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agdf",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Bootstrap AGDF repository-local plugin files, Copilot/OpenCode instructions, skills, control files and machine-readable checks.",
   "type": "module",
   "files": [