create-agdf 0.9.5 → 0.9.7

package/README.md

@@ -92,11 +92,16 @@ Optional flags:
 - `--dir <path>` write into a specific directory
 - `--force` overwrite existing generated files
 - `--language <tag>` or `--lang <tag>` persist a BCP 47 language tag such as `de`, `en` or `fr-CA`
+- `--verbose` show captured host installer output and generated-file details after the concise lifecycle card
 - `--scope <repository|global>` select an explicit lifecycle mutation scope
 - `--confirm` apply a global uninstall after reviewing the default non-mutating preview
 
 If no language is provided, `create-agdf` derives the preference from the local system locale (`LC_ALL`, `LC_MESSAGES`, `LANG`, `LANGUAGE` or the Node.js runtime locale) and falls back to `en`.
 
+Lifecycle cards and CLI-owned status labels are always English so they remain comparable across
+machines and coding agents. `--language` continues to control project chat and artefact language;
+it does not localize the CLI lifecycle card.
+
 ## Targets and existing AGENTS.md
 
 - `codex` installs the AGDF plugin globally for Codex

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

@@ -1,6 +1,6 @@
 {
   "name": "agdf",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "description": "Operating system for governed AI-assisted delivery.",
   "author": {
     "name": "Arndt Gold",

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

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "agdf",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "displayName": "AI Governance & Delivery Framework",
   "developerName": "Arndt Gold",
   "description": "Operating system for governed AI-assisted delivery.",

package/lib/cli/application.js

@@ -111,7 +111,7 @@ function createHandlers({ io, env, exec }) {
         ...options,
         configDir: env.OPENCODE_CONFIG_DIR || defaultOpenCodeConfigDir(),
       }, { exec });
-      printGeneralStatus(report, { json: options.json, locale: options.language.chat_language, io });
+      printGeneralStatus(report, { json: options.json, io });
       return report.installation.status === "healthy" ? 0 : 1;
     }],
     ["disable", (options) => runDisable(options, { io, exec })],
@@ -122,7 +122,8 @@ function createHandlers({ io, env, exec }) {
         printLifecycleResult(installResult(installed, {
           restartRequired: true,
           nextAction: "Restart Codex, then run npx --yes @agdf/cli@latest codex-repo in a repository where AGDF should be active.",
-        }), { json: options.json, locale: options.language.chat_language, io });
+        }), { json: options.json, io });
+        printVerboseHostOutput(installed, options, io);
         return 0;
       } catch (error) {
         printInstallFailure("codex", error, options, io);
@@ -135,7 +136,8 @@ function createHandlers({ io, env, exec }) {
         printLifecycleResult(installResult(installed, {
           restartRequired: true,
           nextAction: "Restart Claude Code, then verify the plugin in a new session.",
-        }), { json: options.json, locale: options.language.chat_language, io });
+        }), { json: options.json, io });
+        printVerboseHostOutput(installed, options, io);
         return 0;
       } catch (error) {
         printInstallFailure("claude", error, options, io);
@@ -166,7 +168,7 @@ function createHandlers({ io, env, exec }) {
           verification: { status: verificationHealthy ? "healthy" : "degraded", evidence: [report.global_config.path, report.global_native_surface.path] },
           restart: { required: true, reason: "host_reload" },
           next_action: { kind: "restart", text: "Restart OpenCode so it loads the updated global plugin config." },
-        }), { json: options.json, locale: options.language.chat_language, io });
+        }), { json: options.json, io });
         return verificationHealthy ? 0 : 1;
       } catch (error) {
         printInstallFailure("opencode", error, options, io);
@@ -194,11 +196,20 @@ function installResult(installed, { restartRequired, nextAction }) {
     scope: "global",
     version: { expected: installed.expectedVersion, installed: installed.installedVersion, status: installed.installedVersion ? "verified" : "unknown" },
     verification: { status: installed.verificationStatus, evidence: installed.evidence },
+    installation: { status: installed.verificationStatus },
+    activation: { status: restartRequired ? "pending_restart" : "active" },
+    delivery: { status: "not_evaluated" },
     restart: { required: restartRequired, reason: restartRequired ? "host_reload" : "none" },
     next_action: { kind: restartRequired ? "restart" : "prompt", text: nextAction },
   });
 }
 
+function printVerboseHostOutput(installed, options, io) {
+  if (!options.verbose || options.json || !installed.nativeOutput?.length) return;
+  io.log("Host command output:");
+  for (const output of installed.nativeOutput) io.log(output);
+}
+
 function printInstallFailure(surface, error, options, io) {
   const report = lifecycleFailure({
     operation: "install",
@@ -212,7 +223,7 @@ function printInstallFailure(surface, error, options, io) {
   if (options.json) printLifecycleResult(report, { json: true, io });
   else {
     io.error(error.message);
-    printLifecycleResult(report, { locale: options.language.chat_language, io });
+    printLifecycleResult(report, { io });
   }
 }
 
@@ -238,7 +249,7 @@ function runDisable(options, { io, exec }) {
         ? { phase: "repository_configuration", message: applied.error.message }
         : result === "failed" ? { phase: "verification", message: "Repository disable postcondition was not observed." } : null,
     });
-    printLifecycleResult(report, { json: options.json, locale: options.language.chat_language, io });
+    printLifecycleResult(report, { json: options.json, io });
     return result === "success" ? 0 : 1;
   } catch (error) {
     io.error(error.message);
@@ -258,7 +269,7 @@ function runUninstall(options, { io, env, exec }) {
         next_action: { kind: "confirm", text: `Review this preview, then rerun with --surface ${options.surface} --scope global --confirm; ownership is revalidated before apply.` },
         changes: plan.mutations, retained: plan.retained,
       });
-      printLifecycleResult(preview, { json: options.json, locale: options.language.chat_language, io });
+      printLifecycleResult(preview, { json: options.json, io });
       return 0;
     }
     const applied = applyLifecyclePlan(plan, exec ? { exec } : {});
@@ -278,7 +289,7 @@ function runUninstall(options, { io, env, exec }) {
         ? { phase: "plugin_operation", message: applied.error.message }
         : result === "failed" ? { phase: "verification", message: "Global uninstall postcondition was not observed." } : null,
     });
-    printLifecycleResult(report, { json: options.json, locale: options.language.chat_language, io });
+    printLifecycleResult(report, { json: options.json, io });
     return result === "success" ? 0 : 1;
   } catch (error) {
     io.error(error.message);
@@ -303,7 +314,7 @@ function runScaffold(options, io) {
     return 1;
   }
 
-  printNextSteps(options.target, options.dir, files, wroteAgentsFragment, wroteOpenCodeConfigFragment, removedOpenCodeAgents, io);
+  printNextSteps(options.target, options.dir, files, wroteAgentsFragment, wroteOpenCodeConfigFragment, removedOpenCodeAgents, { verbose: options.verbose, json: options.json, io });
   return 0;
 }
 

package/lib/cli/command-registry.js

@@ -95,6 +95,7 @@ Options:
                  Set AGDF chat and artefact language. Defaults to detected system locale.
   --lang <tag>   Alias for --language
   --json         Print machine-readable command output as JSON
+  --verbose       Print captured host command output and generated-file details
   --status-card  Print compact gate-check status-card output for interactive use
   --run <run_id> Select one canonical run
   --all-active   Evaluate every active run (doctor and delivery-map only)

package/lib/cli/parse-args.js

@@ -27,6 +27,7 @@ export function parseArgs(argv, dependencies = {}) {
   let dir = ".";
   let force = false;
   let json = false;
+  let verbose = false;
   let statusCard = false;
   let language;
   let dirExplicit = false;
@@ -50,6 +51,7 @@ export function parseArgs(argv, dependencies = {}) {
     if (arg === "--help" || arg === "-h") return { kind: "help" };
     if (arg === "--force") { force = true; continue; }
     if (arg === "--json") { json = true; continue; }
+    if (arg === "--verbose") { verbose = true; continue; }
     if (arg === "--status-card") { statusCard = true; continue; }
     if (arg === "--persist") { persist = true; continue; }
     if (arg === "--generate-candidates") { generateCandidates = true; continue; }
@@ -129,6 +131,7 @@ export function parseArgs(argv, dependencies = {}) {
       dir: resolve(cwd, dir),
       force,
       json,
+      verbose,
       statusCard,
       dirExplicit,
       language: languagePreference(language),

package/lib/installers/plugin-installers.js

@@ -3,24 +3,26 @@ import { pluginDefinition } from "../cli/runtime-context.js";
 
 export function installCodexGlobalPlugin({ exec = execFileSync, io = console } = {}) {
   const expectedVersion = pluginDefinition.version;
-  runPluginPhase(exec, "codex", ["plugin", "marketplace", "add", "arndtgold/ai-native-governance-delivery-framework"], "marketplace", { stdio: "inherit" });
-  runPluginPhase(exec, "codex", ["plugin", "marketplace", "upgrade", "agdf"], "marketplace", { stdio: "inherit" });
-  runPluginPhase(exec, "codex", ["plugin", "add", "agdf", "--marketplace", "agdf"], "plugin_operation", { stdio: "inherit" });
+  const nativeOutput = [];
+  nativeOutput.push(runPluginPhase(exec, "codex", ["plugin", "marketplace", "add", "arndtgold/ai-native-governance-delivery-framework"], "marketplace", captureOptions()));
+  nativeOutput.push(runPluginPhase(exec, "codex", ["plugin", "marketplace", "upgrade", "agdf"], "marketplace", captureOptions()));
+  nativeOutput.push(runPluginPhase(exec, "codex", ["plugin", "add", "agdf", "--marketplace", "agdf"], "plugin_operation", captureOptions()));
   const listOutput = runPluginPhase(exec, "codex", ["plugin", "list"], "verification", { encoding: "utf8", stdio: "pipe" });
   const installedVersion = pluginVersionFromList(listOutput, "agdf@agdf");
   if (installedVersion !== expectedVersion) {
     throw lifecycleAdapterError("version", versionMismatchMessage("Codex", "agdf@agdf", expectedVersion, installedVersion, "codex plugin marketplace upgrade agdf && codex plugin add agdf --marketplace agdf"));
   }
-  return { surface: "codex", expectedVersion, installedVersion, verificationStatus: "healthy", evidence: ["codex plugin list"] };
+  return { surface: "codex", expectedVersion, installedVersion, verificationStatus: "healthy", evidence: ["codex plugin list"], nativeOutput: nativeOutput.filter(Boolean).map(String) };
 }
 
 export function installClaudeGlobalPlugin({ exec = execFileSync, io = console } = {}) {
   const expectedVersion = pluginDefinition.version;
-  runPluginPhase(exec, "claude", ["plugin", "marketplace", "add", "arndtgold/ai-native-governance-delivery-framework"], "marketplace", { stdio: "inherit" });
-  runPluginPhase(exec, "claude", ["plugin", "marketplace", "update", "agdf"], "marketplace", { stdio: "inherit" });
+  const nativeOutput = [];
+  nativeOutput.push(runPluginPhase(exec, "claude", ["plugin", "marketplace", "add", "arndtgold/ai-native-governance-delivery-framework"], "marketplace", captureOptions()));
+  nativeOutput.push(runPluginPhase(exec, "claude", ["plugin", "marketplace", "update", "agdf"], "marketplace", captureOptions()));
   const beforeList = runPluginPhase(exec, "claude", ["plugin", "list"], "verification", { encoding: "utf8", stdio: "pipe" });
   const alreadyInstalled = pluginListHasPlugin(beforeList, "agdf@agdf");
-  runPluginPhase(exec, "claude", ["plugin", alreadyInstalled ? "update" : "install", "agdf@agdf"], "plugin_operation", { stdio: "inherit" });
+  nativeOutput.push(runPluginPhase(exec, "claude", ["plugin", alreadyInstalled ? "update" : "install", "agdf@agdf"], "plugin_operation", captureOptions()));
   const afterList = runPluginPhase(exec, "claude", ["plugin", "list"], "verification", { encoding: "utf8", stdio: "pipe" });
   const installedVersion = pluginVersionFromList(afterList, "agdf@agdf");
   if (installedVersion && installedVersion !== expectedVersion) {
@@ -32,9 +34,14 @@ export function installClaudeGlobalPlugin({ exec = execFileSync, io = console }
     installedVersion,
     verificationStatus: installedVersion ? "healthy" : "degraded",
     evidence: ["claude plugin list", ...(installedVersion ? [] : ["host_did_not_expose_version"])],
+    nativeOutput: nativeOutput.filter(Boolean).map(String),
   };
 }
 
+function captureOptions() {
+  return { encoding: "utf8", stdio: "pipe" };
+}
+
 export function inspectPluginSurface(surface, exec = execFileSync) {
   const executable = surface === "claude" ? "claude" : "codex";
   const pluginId = "agdf@agdf";

package/lib/lifecycle/presentation.js

@@ -1,36 +1,45 @@
-import { interactionLocales } from "../cli/runtime-context.js";
+const surfaceLabels = Object.freeze({
+  codex: "Codex",
+  claude: "Claude Code",
+  copilot: "GitHub Copilot",
+  opencode: "OpenCode",
+  generic: "Generic coding agent",
+});
 
-function copy(locale) {
-  const language = String(locale ?? "").toLowerCase().split("-")[0];
-  return (interactionLocales.locales[language] ?? interactionLocales.locales[interactionLocales.fallbackLocale]).primary.lifecycleResult;
+function titleFor(report) {
+  if (report.result === "failed") return "AGDF installation failed";
+  if (report.result === "partial") return "AGDF installation partially completed";
+  if (report.operation === "repository_setup") return "AGDF repository setup complete";
+  return "AGDF installation complete";
 }
 
-export function lifecycleCardLines(report, locale = "en") {
-  const c = copy(locale);
+export function lifecycleCardLines(report) {
   const version = report.version.transition === "updated" && report.version.previous && report.version.installed
     ? `${report.version.previous} -> ${report.version.installed}`
-    : report.version.installed || (report.version.expected ? `${c.unknown}; expected ${report.version.expected}` : c.unknown);
+    : report.version.installed || (report.version.expected ? `unknown; expected ${report.version.expected}` : "unknown");
   const versionStatus = report.version.transition && report.version.transition !== "updated"
     ? `${report.version.status}; transition ${report.version.transition}`
     : report.version.status;
   return [
-    c.title,
-    `${c.result}: ${report.result}`,
-    `${c.surface}: ${report.surface}`,
-    `${c.scope}: ${report.scope}`,
-    `${c.version}: ${version} (${versionStatus})`,
-    `${c.verification}: ${report.verification.status}`,
-    `${c.restart}: ${report.restart.required ? c.yes : c.no}${report.restart.reason !== "none" ? ` (${report.restart.reason})` : ""}`,
-    `${c.next}: ${report.next_action.text}`,
+    titleFor(report),
+    `Surface: ${surfaceLabels[report.surface]}`,
+    `Version: ${version} (${versionStatus})`,
+    `Installation scope: ${report.scope}`,
+    `Installation: ${report.installation.status}`,
+    `Activation: ${report.activation.status}`,
+    `Repository delivery: ${report.delivery.status}`,
+    `Verification: ${report.verification.status}`,
+    `Restart required: ${report.restart.required ? "yes" : "no"}${report.restart.reason !== "none" ? ` (${report.restart.reason})` : ""}`,
+    `Next action: ${report.next_action.text}`,
   ];
 }
 
-export function printLifecycleResult(report, { json = false, locale = "en", io = console } = {}) {
+export function printLifecycleResult(report, { json = false, io = console } = {}) {
   if (json) {
     io.log(JSON.stringify(report, null, 2));
     return;
   }
-  for (const line of lifecycleCardLines(report, locale)) io.log(line);
+  for (const line of lifecycleCardLines(report)) io.log(line);
   if (report.failure) io.log(`Failure phase: ${report.failure.phase}: ${report.failure.message}`);
   if (report.retained.length) {
     io.log("Retained:");
@@ -38,15 +47,14 @@ export function printLifecycleResult(report, { json = false, locale = "en", io =
   }
 }
 
-export function printGeneralStatus(report, { json = false, locale = "en", io = console } = {}) {
+export function printGeneralStatus(report, { json = false, io = console } = {}) {
   if (json) {
     io.log(JSON.stringify(report, null, 2));
     return;
   }
-  const c = copy(locale);
-  io.log(c.statusTitle);
-  io.log(`${c.installation}: ${report.installation.status}${report.installation.version ? ` (${report.installation.version})` : ""}`);
-  io.log(`${c.repository}: ${report.repository.status}`);
-  io.log(`${c.delivery}: ${report.delivery.status}${report.delivery.current_gate ? ` (${report.delivery.current_gate})` : ""}`);
-  io.log(`${c.next}: ${report.next_action.text}`);
+  io.log("AGDF status");
+  io.log(`Installation: ${report.installation.status}${report.installation.version ? ` (${report.installation.version})` : ""}`);
+  io.log(`Repository: ${report.repository.status}`);
+  io.log(`Delivery: ${report.delivery.status}${report.delivery.current_gate ? ` (${report.delivery.current_gate})` : ""}`);
+  io.log(`Next action: ${report.next_action.text}`);
 }

package/lib/lifecycle/result.js

@@ -1,6 +1,7 @@
 const OPERATIONS = new Set(["install", "update", "status", "disable", "uninstall", "repository_setup"]);
 const RESULTS = new Set(["success", "partial", "failed", "preview"]);
 const SCOPES = new Set(["global", "repository"]);
+const SURFACES = new Set(["codex", "claude", "copilot", "opencode", "generic"]);
 
 function text(value) {
   return typeof value === "string" ? value.trim() : "";
@@ -24,6 +25,15 @@ export function createLifecycleResult(input = {}) {
       status: text(input.verification?.status) || "unknown",
       evidence: [...(input.verification?.evidence ?? [])].map(String),
     },
+    installation: {
+      status: text(input.installation?.status) || text(input.verification?.status) || "unknown",
+    },
+    activation: {
+      status: text(input.activation?.status) || (input.restart?.required ? "pending_restart" : "active"),
+    },
+    delivery: {
+      status: text(input.delivery?.status) || "not_evaluated",
+    },
     restart: {
       required: Boolean(input.restart?.required),
       reason: text(input.restart?.reason) || "none",
@@ -44,7 +54,7 @@ export function assertLifecycleResult(value) {
   if (value?.schema_version !== 1) throw new Error("Lifecycle result requires schema_version 1.");
   if (!OPERATIONS.has(value.operation)) throw new Error(`Unsupported lifecycle operation: ${value.operation || "missing"}.`);
   if (!RESULTS.has(value.result)) throw new Error(`Unsupported lifecycle result: ${value.result || "missing"}.`);
-  if (!value.surface) throw new Error("Lifecycle result requires a surface.");
+  if (!SURFACES.has(value.surface)) throw new Error(`Unsupported lifecycle surface: ${value.surface || "missing"}.`);
   if (!SCOPES.has(value.scope)) throw new Error(`Unsupported lifecycle scope: ${value.scope || "missing"}.`);
   if (!value.next_action || Array.isArray(value.next_action) || !text(value.next_action.text)) {
     throw new Error("Lifecycle result requires exactly one next action.");

package/lib/scaffold/presentation.js

@@ -7,14 +7,43 @@ import { agdfFragmentPath, openCodeConfigFragmentPath } from "./plan.js";
 
 const pluginInstallCommand = "npx --yes @agdf/cli@latest claude";
 
-export function printNextSteps(target, destination, files, wroteAgentsFragment, wroteOpenCodeConfigFragment, removedOpenCodeAgents = [], io = console) {
-  io.log("");
-  io.log(`AGDF bootstrap complete in ${destination}`);
-  io.log("");
-  io.log("Generated:");
-  for (const file of files) {
-    const action = file.action ? `${file.action}: ` : "";
-    io.log(`- ${action}${file.path}`);
+export function printNextSteps(target, destination, files, wroteAgentsFragment, wroteOpenCodeConfigFragment, removedOpenCodeAgents = [], { verbose = false, json = false, io = console } = {}) {
+  const repositorySurface = { "codex-repo": "codex", "opencode-repo": "opencode", copilot: "copilot" }[target];
+  const verified = files.every((file) => {
+    const path = join(destination, file.path);
+    return existsSync(path) && readFileSync(path, "utf8") === file.content;
+  });
+  if (repositorySurface) {
+    const nextAction = repositorySurface === "codex"
+      ? "Restart Codex, open /plugins, select This repository and install agdf; then start a new task with: Run an AGDF gate check for this request."
+      : repositorySurface === "opencode"
+        ? "Restart OpenCode in this repository so it loads the generated AGDF repository configuration."
+        : "Run /instructions in GitHub Copilot CLI to confirm that the generated AGDF repository instructions are visible.";
+    printLifecycleResult(createLifecycleResult({
+      operation: "repository_setup",
+      result: verified ? "success" : "partial",
+      surface: repositorySurface,
+      scope: "repository",
+      version: { expected: pluginDefinition.version, status: "expected" },
+      verification: { status: verified ? "healthy" : "degraded", evidence: files.map((file) => file.path) },
+      installation: { status: verified ? "healthy" : "degraded" },
+      activation: { status: "pending_restart" },
+      delivery: { status: "not_evaluated" },
+      restart: { required: true, reason: "host_reload_and_repository_plugin_activation" },
+      next_action: { kind: "host_action", text: nextAction },
+    }), { json, io });
+    if (!verbose || json) return;
+  }
+
+  if (verbose) {
+    io.log("");
+    io.log(`AGDF bootstrap complete in ${destination}`);
+    io.log("");
+    io.log("Generated:");
+    for (const file of files) {
+      const action = file.action ? `${file.action}: ` : "";
+      io.log(`- ${action}${file.path}`);
+    }
   }
 
   if (removedOpenCodeAgents.length > 0) {
@@ -30,26 +59,7 @@ export function printNextSteps(target, destination, files, wroteAgentsFragment,
     for (const preserved of preservedFiles) io.log(`- ${preserved}`);
   }
 
-  if (target === "codex-repo") {
-    const verified = files.every((file) => {
-      const path = join(destination, file.path);
-      return existsSync(path) && readFileSync(path, "utf8") === file.content;
-    });
-    printLifecycleResult(createLifecycleResult({
-      operation: "repository_setup",
-      result: verified ? "success" : "partial",
-      surface: "codex",
-      scope: "repository",
-      version: { expected: pluginDefinition.version, status: "expected" },
-      verification: { status: verified ? "healthy" : "degraded", evidence: files.map((file) => file.path) },
-      restart: { required: true, reason: "host_reload_and_repository_plugin_activation" },
-      next_action: {
-        kind: "host_action",
-        text: "Restart Codex, open /plugins, select This repository and install agdf; then start a new task with: Run an AGDF gate check for this request.",
-      },
-    }), { locale: JSON.parse(files.find((file) => file.path === join(".agdf", "control", "config.json"))?.content ?? "{}").chat_language, io });
-    return;
-  }
+  if (repositorySurface && !verbose) return;
 
   io.log("");
   io.log("Next steps:");

package/package.json

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