create-agdf 0.3.0 → 0.3.2

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/cli@latest codex
+npx --yes @agdf/cli@latest opencode
+npx --yes @agdf/cli@latest init
+npx --yes @agdf/cli@latest config --language en
+npx --yes @agdf/cli@latest doctor
+npx --yes @agdf/cli@latest gate-check --json
 ```
 
 Backward-compatible scaffold usage:
@@ -151,8 +151,10 @@ The repository publishes this package from `create-agdf/` via the GitHub Actions
 
 The primary user-facing CLI package is published separately from `agdf/` and delegates to this package through the shared `create-agdf/cli` export.
 
-- Create or update the version in `create-agdf/package.json`
+- From the repository root, run `npm run set-version -- <version>`
+- The version script updates the coupled package, plugin and site versions and refuses versions already published as `create-agdf` or `@agdf/cli`
 - Push a matching git tag in the form `create-agdf-v<version>`
+- After `create-agdf` is published, push `agdf-cli-v<version>` for the primary CLI package
 - Ensure the repository secret `NPM_TOKEN` exists with publish rights for `create-agdf`
 
 ## Trademark Notice

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/cli@latest codex
+  npx --yes @agdf/cli@latest opencode
+  npx --yes @agdf/cli@latest init
+  npx --yes @agdf/cli@latest doctor
+  npx --yes @agdf/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/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/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/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/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/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/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/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/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/cli@latest doctor
+npx --yes @agdf/cli@latest doctor --json
+npx --yes @agdf/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/cli@latest init
+npx --yes @agdf/cli@latest doctor --json
+npx --yes @agdf/cli@latest gate-check --json
+npx --yes @agdf/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/cli@latest init
+npx --yes @agdf/cli@latest doctor --json
+npx --yes @agdf/cli@latest gate-check --json
+npx --yes @agdf/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.2",
   "description": "Codex-first workflow skills for gated, auditable AI-assisted software delivery.",
   "author": {
     "name": "AI-native Governance & Delivery Framework",
@@ -9,7 +9,13 @@
   "homepage": "https://agdf.iself.eu",
   "repository": "https://github.com/arndtgold/ai-native-governance-delivery-framework",
   "license": "Apache-2.0",
-  "keywords": ["agentic", "governance", "delivery", "ai-native", "brownfield"],
+  "keywords": [
+    "agentic",
+    "governance",
+    "delivery",
+    "ai-native",
+    "brownfield"
+  ],
   "skills": "./skills/",
   "hooks": "./hooks/hooks.json",
   "interface": {
@@ -18,7 +24,10 @@
     "longDescription": "AI Governance & Delivery Framework (AGDF) packages reusable Codex-first skills, control templates and machine-readable repository checks for gate decisions, Brownfield analysis, task-plan review, solution-integrity review, QA decisions, durable run state and auditable delivery closeout.",
     "developerName": "AI-native Governance & Delivery Framework",
     "category": "Productivity",
-    "capabilities": ["Read", "Write"],
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
     "websiteURL": "https://agdf.iself.eu",
     "composerIcon": "./assets/agdf-icon.svg",
     "logo": "./assets/agdf-logo.svg",

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/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/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/cli@latest doctor
+npx --yes @agdf/cli@latest doctor --json
+npx --yes @agdf/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/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");
@@ -19,8 +19,11 @@ try {
   const chat = config.chat_language || "unset";
   const runtime = config.runtime_language || "en";
   console.log(`Project config: .agdf/control/config.json (artefacts=${artefacts}, chat=${chat}, runtime=${runtime}).`);
+  if (artefacts !== "unset" || chat !== "unset") {
+    console.log(`Language policy: write durable AGDF artefacts in ${artefacts} and user-facing responses in ${chat} unless the user explicitly asks otherwise. Runtime rules stay ${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/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.2",
   "displayName": "AI Governance & Delivery Framework",
   "developerName": "AI-native Governance & Delivery Framework",
   "description": "Codex-first workflow skills for gated, auditable AI-assisted software delivery.",
@@ -11,7 +11,13 @@
   "homepage": "https://agdf.iself.eu",
   "repository": "https://github.com/arndtgold/ai-native-governance-delivery-framework",
   "license": "Apache-2.0",
-  "keywords": ["agentic", "governance", "delivery", "ai-native", "brownfield"],
+  "keywords": [
+    "agentic",
+    "governance",
+    "delivery",
+    "ai-native",
+    "brownfield"
+  ],
   "category": "Productivity",
   "brandColor": "#14B8A6",
   "author": {
@@ -24,7 +30,10 @@
     "agentRouter": "meta/agdf-agent-router.md",
     "composerIcon": "./assets/agdf-icon.svg",
     "logo": "./assets/agdf-logo.svg",
-    "capabilities": ["Read", "Write"],
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
     "defaultPrompt": [
       "Run an AGDF gate check for this request.",
       "Create an AGDF control scaffold for this repository.",

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/cli@latest init
+npx --yes @agdf/cli@latest doctor --json
+npx --yes @agdf/cli@latest gate-check --json
+npx --yes @agdf/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/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.2",
   "description": "Bootstrap AGDF repository-local plugin files, Copilot/OpenCode instructions, skills, control files and machine-readable checks.",
   "type": "module",
   "files": [