create-agdf 0.9.3 → 0.9.6

package/README.md

@@ -21,7 +21,7 @@ Use a different target when Codex is not your agent surface:
 | Claude Code | `npx --yes @agdf/cli@latest claude` | The AGDF plugin for Claude Code. |
 | OpenCode, user-wide discovery | `npx --yes @agdf/cli@latest opencode` | The npm plugin and global native skills; repository governance remains opt-in. |
 | OpenCode, one repository | `npx --yes @agdf/cli@latest opencode-repo` | Repository instructions, native skills, permissions and control templates. |
-| GitHub Copilot | `npm create agdf@latest -- copilot` | Repository instructions, visible skills and control templates. |
+| GitHub Copilot | `npx --yes @agdf/cli@latest copilot` | Repository instructions, visible skills and control templates. |
 | Durable control state in an existing setup | `npx --yes @agdf/cli@latest init` | Live `.agdf/control/` state when the repository explicitly needs it. |
 
 For prerequisites, all surface-specific flows and operational boundaries, use the authoritative [installation guide](../INSTALL.md). Do not run `init` merely to ask a fresh question: an agent can first clarify the request and ask for `Approval: UR` when durable control state is needed.
@@ -39,6 +39,9 @@ npx --yes @agdf/cli@latest claude
 npx --yes @agdf/cli@latest opencode
 npx --yes @agdf/cli@latest opencode-status
 npx --yes @agdf/cli@latest opencode-repo
+npx --yes @agdf/cli@latest status --surface codex
+npx --yes @agdf/cli@latest disable --surface codex --scope repository
+npx --yes @agdf/cli@latest uninstall --surface codex --scope global
 npx --yes @agdf/cli@latest init
 npx --yes @agdf/cli@latest config --language en
 npx --yes @agdf/cli@latest doctor
@@ -62,6 +65,8 @@ npx --yes @agdf/cli@latest run-migrate [--run <run_id>]
 npx --yes @agdf/cli@latest run-render-legacy --run <run_id>
 ```
 
+### Advanced / Compatibility
+
 Backward-compatible scaffold usage:
 
 ```bash
@@ -87,6 +92,8 @@ 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`
+- `--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`.
 
@@ -98,6 +105,9 @@ If no language is provided, `create-agdf` derives the preference from the local
 - `copilot` writes `AGENTS.md`, Copilot custom instructions under `.github/`, visible repository skills under `.github/skills/`, and AGDF control templates under `.agdf/control/`
 - `opencode` installs the AGDF npm plugin and nine native skills as a user-wide OpenCode surface
 - `opencode-status` reports OpenCode global config, package loadability, global native-skill completeness, session signals and repository surface presence
+- `status` reports installation, repository activation and delivery separately without mutating state
+- `disable` writes a supported repository-local opt-out while retaining global capability and durable control state
+- `uninstall` previews and, only with `--confirm`, applies a selected global removal through supported native/owned operations
 - `opencode-repo` writes `opencode.json`, `.opencode/AGDF.md`, prefixed native OpenCode skills under `.opencode/skills/`, explicit question/edit/bash/skill permissions, and AGDF control templates under `.agdf/control/`
 - `both` writes the Codex repository-local marketplace plus the Copilot-facing repository files
 - `config` writes or updates only `.agdf/control/config.json` for an already installed plugin or an existing repository

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

@@ -64,6 +64,11 @@ Use the Runtime Contract's Native Interaction Contract to classify every candida
 
 Prefer inspection over asking. Do not invoke a structured question for status reporting, facts available in the repository, routine read-only work or a gate that is not ready. Do not repeatedly prompt for the same non-ready gate.
 
+For a fresh request classified as read-only with no required run decision, emit the locale pack's
+`primary.readOnlyOrientationDescription` sentence once before the findings. This path creates no run, persists
+nothing, requests no approval and reuses the existing status projection. Do not repeat the sentence
+during the same request.
+
 For a ready `gate_approval`:
 
 1. Resolve exactly one selected run and evaluate the current gate.

package/generated/.github/skills/agdf-interaction-locales.json

@@ -109,6 +109,24 @@
         "notYetCreated": "not yet created"
       },
       "primary": {
+        "readOnlyOrientationDescription": "Read-only check — no new AGDF run and no approval required.",
+        "lifecycleResult": {
+          "title": "AGDF lifecycle result",
+          "statusTitle": "AGDF status",
+          "result": "Result",
+          "surface": "Surface",
+          "scope": "Installation scope",
+          "version": "AGDF version",
+          "verification": "Verification",
+          "restart": "Restart required",
+          "installation": "Installation",
+          "repository": "Repository",
+          "delivery": "Delivery",
+          "next": "Next action",
+          "yes": "yes",
+          "no": "no",
+          "unknown": "unknown"
+        },
         "status": {
           "open": "open",
           "blocked": "blocked",
@@ -278,6 +296,24 @@
         "notYetCreated": "noch nicht erstellt"
       },
       "primary": {
+        "readOnlyOrientationDescription": "Read-only Prüfung – kein neuer AGDF-Run und keine Freigabe erforderlich.",
+        "lifecycleResult": {
+          "title": "AGDF-Lifecycle-Ergebnis",
+          "statusTitle": "AGDF-Status",
+          "result": "Ergebnis",
+          "surface": "Oberfläche",
+          "scope": "Installationsscope",
+          "version": "AGDF-Version",
+          "verification": "Verifikation",
+          "restart": "Neustart erforderlich",
+          "installation": "Installation",
+          "repository": "Repository",
+          "delivery": "Delivery",
+          "next": "Nächste Aktion",
+          "yes": "ja",
+          "no": "nein",
+          "unknown": "unbekannt"
+        },
         "status": {
           "open": "offen",
           "blocked": "blockiert",

package/generated/.github/skills/contracts/interaction.md

@@ -274,6 +274,15 @@ Surface adapter rules:
 
 Native structured questions are for real decision points. Prefer repository inspection over clarification and do not show them for status reporting, discoverable facts, routine read-only work or repeated non-ready gate prompts.
 
+### Read-only request orientation
+
+For a newly classified read-only request that does not require a run decision, render the localized
+`primary.readOnlyOrientationDescription` sentence exactly once before the findings. This is a visible
+orientation, not durable state: do not create a run, write control files, request gate approval or
+repeat the sentence later in the same request. Existing-run status inspection remains read-only and
+uses the existing status projection; this branch must not create a second status-card or narration
+owner.
+
 Exact textual approvals remain canonical and fully supported on every surface. If native capability availability or safety is unknown, use the textual fallback. Host permission, plan approval, native question presentation, timeout/default behavior, hook output and agent messages never carry AGDF gate authority by themselves.
 
 ### Interaction Locale Contract
@@ -367,4 +376,3 @@ Missing input, timeout, cancellation and empty input are not decline. Only
 `approve` backed by the exact revalidated `Approval: <GateName>` value may
 advance a gate. Clarification, blocked, internal-step and status-only
 interactions must not display gate-approval controls.
-

package/generated/.opencode/agdf-interaction-locales.json

@@ -109,6 +109,24 @@
         "notYetCreated": "not yet created"
       },
       "primary": {
+        "readOnlyOrientationDescription": "Read-only check — no new AGDF run and no approval required.",
+        "lifecycleResult": {
+          "title": "AGDF lifecycle result",
+          "statusTitle": "AGDF status",
+          "result": "Result",
+          "surface": "Surface",
+          "scope": "Installation scope",
+          "version": "AGDF version",
+          "verification": "Verification",
+          "restart": "Restart required",
+          "installation": "Installation",
+          "repository": "Repository",
+          "delivery": "Delivery",
+          "next": "Next action",
+          "yes": "yes",
+          "no": "no",
+          "unknown": "unknown"
+        },
         "status": {
           "open": "open",
           "blocked": "blocked",
@@ -278,6 +296,24 @@
         "notYetCreated": "noch nicht erstellt"
       },
       "primary": {
+        "readOnlyOrientationDescription": "Read-only Prüfung – kein neuer AGDF-Run und keine Freigabe erforderlich.",
+        "lifecycleResult": {
+          "title": "AGDF-Lifecycle-Ergebnis",
+          "statusTitle": "AGDF-Status",
+          "result": "Ergebnis",
+          "surface": "Oberfläche",
+          "scope": "Installationsscope",
+          "version": "AGDF-Version",
+          "verification": "Verifikation",
+          "restart": "Neustart erforderlich",
+          "installation": "Installation",
+          "repository": "Repository",
+          "delivery": "Delivery",
+          "next": "Nächste Aktion",
+          "yes": "ja",
+          "no": "nein",
+          "unknown": "unbekannt"
+        },
         "status": {
           "open": "offen",
           "blocked": "blockiert",

package/generated/.opencode/contracts/interaction.md

@@ -274,6 +274,15 @@ Surface adapter rules:
 
 Native structured questions are for real decision points. Prefer repository inspection over clarification and do not show them for status reporting, discoverable facts, routine read-only work or repeated non-ready gate prompts.
 
+### Read-only request orientation
+
+For a newly classified read-only request that does not require a run decision, render the localized
+`primary.readOnlyOrientationDescription` sentence exactly once before the findings. This is a visible
+orientation, not durable state: do not create a run, write control files, request gate approval or
+repeat the sentence later in the same request. Existing-run status inspection remains read-only and
+uses the existing status projection; this branch must not create a second status-card or narration
+owner.
+
 Exact textual approvals remain canonical and fully supported on every surface. If native capability availability or safety is unknown, use the textual fallback. Host permission, plan approval, native question presentation, timeout/default behavior, hook output and agent messages never carry AGDF gate authority by themselves.
 
 ### Interaction Locale Contract
@@ -367,4 +376,3 @@ Missing input, timeout, cancellation and empty input are not decline. Only
 `approve` backed by the exact revalidated `Approval: <GateName>` value may
 advance a gate. Clarification, blocked, internal-step and status-only
 interactions must not display gate-approval controls.
-

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

@@ -64,6 +64,11 @@ Use the Runtime Contract's Native Interaction Contract to classify every candida
 
 Prefer inspection over asking. Do not invoke a structured question for status reporting, facts available in the repository, routine read-only work or a gate that is not ready. Do not repeatedly prompt for the same non-ready gate.
 
+For a fresh request classified as read-only with no required run decision, emit the locale pack's
+`primary.readOnlyOrientationDescription` sentence once before the findings. This path creates no run, persists
+nothing, requests no approval and reuses the existing status projection. Do not repeat the sentence
+during the same request.
+
 For a ready `gate_approval`:
 
 1. Resolve exactly one selected run and evaluate the current gate.

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

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

package/generated/plugins/agdf/meta/agdf-interaction-locales.json

@@ -109,6 +109,24 @@
         "notYetCreated": "not yet created"
       },
       "primary": {
+        "readOnlyOrientationDescription": "Read-only check — no new AGDF run and no approval required.",
+        "lifecycleResult": {
+          "title": "AGDF lifecycle result",
+          "statusTitle": "AGDF status",
+          "result": "Result",
+          "surface": "Surface",
+          "scope": "Installation scope",
+          "version": "AGDF version",
+          "verification": "Verification",
+          "restart": "Restart required",
+          "installation": "Installation",
+          "repository": "Repository",
+          "delivery": "Delivery",
+          "next": "Next action",
+          "yes": "yes",
+          "no": "no",
+          "unknown": "unknown"
+        },
         "status": {
           "open": "open",
           "blocked": "blocked",
@@ -278,6 +296,24 @@
         "notYetCreated": "noch nicht erstellt"
       },
       "primary": {
+        "readOnlyOrientationDescription": "Read-only Prüfung – kein neuer AGDF-Run und keine Freigabe erforderlich.",
+        "lifecycleResult": {
+          "title": "AGDF-Lifecycle-Ergebnis",
+          "statusTitle": "AGDF-Status",
+          "result": "Ergebnis",
+          "surface": "Oberfläche",
+          "scope": "Installationsscope",
+          "version": "AGDF-Version",
+          "verification": "Verifikation",
+          "restart": "Neustart erforderlich",
+          "installation": "Installation",
+          "repository": "Repository",
+          "delivery": "Delivery",
+          "next": "Nächste Aktion",
+          "yes": "ja",
+          "no": "nein",
+          "unknown": "unbekannt"
+        },
         "status": {
           "open": "offen",
           "blocked": "blockiert",

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

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

package/generated/plugins/agdf/meta/contracts/interaction.md

@@ -274,6 +274,15 @@ Surface adapter rules:
 
 Native structured questions are for real decision points. Prefer repository inspection over clarification and do not show them for status reporting, discoverable facts, routine read-only work or repeated non-ready gate prompts.
 
+### Read-only request orientation
+
+For a newly classified read-only request that does not require a run decision, render the localized
+`primary.readOnlyOrientationDescription` sentence exactly once before the findings. This is a visible
+orientation, not durable state: do not create a run, write control files, request gate approval or
+repeat the sentence later in the same request. Existing-run status inspection remains read-only and
+uses the existing status projection; this branch must not create a second status-card or narration
+owner.
+
 Exact textual approvals remain canonical and fully supported on every surface. If native capability availability or safety is unknown, use the textual fallback. Host permission, plan approval, native question presentation, timeout/default behavior, hook output and agent messages never carry AGDF gate authority by themselves.
 
 ### Interaction Locale Contract
@@ -367,4 +376,3 @@ Missing input, timeout, cancellation and empty input are not decline. Only
 `approve` backed by the exact revalidated `Approval: <GateName>` value may
 advance a gate. Clarification, blocked, internal-step and status-only
 interactions must not display gate-approval controls.
-

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

@@ -64,6 +64,11 @@ Use the Runtime Contract's Native Interaction Contract to classify every candida
 
 Prefer inspection over asking. Do not invoke a structured question for status reporting, facts available in the repository, routine read-only work or a gate that is not ready. Do not repeatedly prompt for the same non-ready gate.
 
+For a fresh request classified as read-only with no required run decision, emit the locale pack's
+`primary.readOnlyOrientationDescription` sentence once before the findings. This path creates no run, persists
+nothing, requests no approval and reuses the existing status projection. Do not repeat the sentence
+during the same request.
+
 For a ready `gate_approval`:
 
 1. Resolve exactly one selected run and evaluate the current gate.

package/lib/cli/application.js

@@ -28,6 +28,16 @@ import {
   installClaudeGlobalPlugin,
   installCodexGlobalPlugin,
 } from "../installers/plugin-installers.js";
+import {
+  applyLifecyclePlan,
+  planGlobalUninstall,
+  planRepositoryDisable,
+  verifyGlobalUninstall,
+  verifyRepositoryDisabled,
+} from "../lifecycle/operations.js";
+import { printGeneralStatus, printLifecycleResult } from "../lifecycle/presentation.js";
+import { createLifecycleResult, lifecycleFailure } from "../lifecycle/result.js";
+import { evaluateGeneralStatus } from "../lifecycle/status.js";
 import { agdfFragmentPath, generatedFilesForTarget, openCodeConfigFragmentPath } from "../scaffold/plan.js";
 import { printNextSteps } from "../scaffold/presentation.js";
 import { assertGeneratedWritePlan, removeOwnedLegacyOpenCodeAgents, writeGeneratedFile } from "../scaffold/write.js";
@@ -96,45 +106,186 @@ function createHandlers({ io, env, exec }) {
       printOpenCodeStatus(report, options.json, io);
       return report.status === "configured" ? 0 : 1;
     }],
-    ["codex", () => {
+    ["status", (options) => {
+      const report = evaluateGeneralStatus(options.dir, {
+        ...options,
+        configDir: env.OPENCODE_CONFIG_DIR || defaultOpenCodeConfigDir(),
+      }, { exec });
+      printGeneralStatus(report, { json: options.json, locale: options.language.chat_language, io });
+      return report.installation.status === "healthy" ? 0 : 1;
+    }],
+    ["disable", (options) => runDisable(options, { io, exec })],
+    ["uninstall", (options) => runUninstall(options, { io, env, exec })],
+    ["codex", (options) => {
       try {
-        installCodexGlobalPlugin(installerAdapters);
-        io.log("AGDF Codex plugin installed globally.");
-        io.log("Run npx --yes @agdf/cli@latest codex-repo in a repository when you want to test AGDF from repository-local plugin files.");
+        const installed = installCodexGlobalPlugin(installerAdapters);
+        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 });
         return 0;
       } catch (error) {
-        io.error(error.message);
+        printInstallFailure("codex", error, options, io);
         return 1;
       }
     }],
-    ["claude", () => {
+    ["claude", (options) => {
       try {
-        installClaudeGlobalPlugin(installerAdapters);
-        io.log("AGDF Claude Code plugin installed globally.");
+        const installed = installClaudeGlobalPlugin(installerAdapters);
+        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 });
         return 0;
       } catch (error) {
-        io.error(error.message);
+        printInstallFailure("claude", error, options, io);
         return 1;
       }
     }],
     ["opencode", (options) => {
       const configDir = options.dirExplicit ? options.dir : defaultOpenCodeConfigDir();
       try {
-        const result = installOpenCodeGlobalPlugin(configDir);
-        installOpenCodeGlobalSurface(configDir);
-        io.log(`AGDF OpenCode global plugin ${result.added ? "installed" : "already present"}: ${result.configPath}`);
-        const report = evaluateOpenCodeStatus(options.dir, configDir, result.transition);
-        printOpenCodeStatus(report, false, io);
-        io.log("Restart OpenCode so it loads the updated global plugin config.");
-        return 0;
+        const result = runLifecyclePhase("plugin_operation", () => installOpenCodeGlobalPlugin(configDir));
+        runLifecyclePhase("global_surface", () => installOpenCodeGlobalSurface(configDir));
+        const report = runLifecyclePhase("verification", () => evaluateOpenCodeStatus(options.dir, configDir, result.transition));
+        const verificationHealthy = report.status === "configured"
+          && report.package.version_status === "current"
+          && report.global_native_surface.complete;
+        printLifecycleResult(createLifecycleResult({
+          operation: result.transition.status === "updated" ? "update" : "install",
+          result: verificationHealthy ? "success" : "partial",
+          surface: "opencode",
+          scope: "global",
+          version: {
+            expected: report.package.expected_version,
+            installed: report.package.installed_version,
+            previous: result.transition.previous_version,
+            status: report.package.version_status === "current" ? "verified" : "unknown",
+            transition: result.transition.status,
+          },
+          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 });
+        return verificationHealthy ? 0 : 1;
       } catch (error) {
-        io.error(error.message);
+        printInstallFailure("opencode", error, options, io);
         return 1;
       }
     }],
   ]);
 }
 
+function runLifecyclePhase(phase, operation) {
+  try {
+    return operation();
+  } catch (error) {
+    if (!error.phase) error.phase = phase;
+    if (!error.evidence) error.evidence = {};
+    throw error;
+  }
+}
+
+function installResult(installed, { restartRequired, nextAction }) {
+  return createLifecycleResult({
+    operation: "install",
+    result: "success",
+    surface: installed.surface,
+    scope: "global",
+    version: { expected: installed.expectedVersion, installed: installed.installedVersion, status: installed.installedVersion ? "verified" : "unknown" },
+    verification: { status: installed.verificationStatus, evidence: installed.evidence },
+    restart: { required: restartRequired, reason: restartRequired ? "host_reload" : "none" },
+    next_action: { kind: restartRequired ? "restart" : "prompt", text: nextAction },
+  });
+}
+
+function printInstallFailure(surface, error, options, io) {
+  const report = lifecycleFailure({
+    operation: "install",
+    surface,
+    scope: "global",
+    phase: error.phase || "plugin_operation",
+    message: error.message,
+    evidence: [error.evidence ?? {}],
+    nextAction: `Resolve the ${error.phase || "plugin operation"} failure and rerun npx --yes @agdf/cli@latest ${surface}.`,
+  });
+  if (options.json) printLifecycleResult(report, { json: true, io });
+  else {
+    io.error(error.message);
+    printLifecycleResult(report, { locale: options.language.chat_language, io });
+  }
+}
+
+function runDisable(options, { io, exec }) {
+  try {
+    const plan = planRepositoryDisable(options.dir, options.surface);
+    const applied = applyLifecyclePlan(plan, exec ? { exec } : {});
+    const verified = applied.status === "success" ? verifyRepositoryDisabled(options.dir) : { status: "failed", evidence: [] };
+    const result = applied.status === "success" && verified.status !== "healthy" ? "failed" : applied.status;
+    const report = createLifecycleResult({
+      operation: "disable",
+      result,
+      surface: options.surface,
+      scope: "repository",
+      verification: { status: verified.status === "healthy" ? "healthy" : "degraded", evidence: [...applied.completed.map((item) => item.path || item.executable), ...verified.evidence] },
+      restart: { required: result === "success", reason: result === "success" ? "host_reload" : "none" },
+      next_action: result === "success"
+        ? { kind: "restart", text: "Restart the host in this repository; global AGDF availability and .agdf/control are retained." }
+        : { kind: "verify", text: "Inspect the reported repository configuration failure before retrying disable." },
+      changes: applied.completed,
+      retained: applied.retained,
+      failure: applied.error
+        ? { 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 });
+    return result === "success" ? 0 : 1;
+  } catch (error) {
+    io.error(error.message);
+    return 1;
+  }
+}
+
+function runUninstall(options, { io, env, exec }) {
+  try {
+    const configDir = env.OPENCODE_CONFIG_DIR || defaultOpenCodeConfigDir();
+    const plan = planGlobalUninstall(options.surface, { configDir });
+    if (!options.confirm) {
+      const preview = createLifecycleResult({
+        operation: "uninstall", result: "preview", surface: options.surface, scope: "global",
+        verification: { status: "unknown", evidence: ["non_mutating_preview"] },
+        restart: { required: false },
+        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 });
+      return 0;
+    }
+    const applied = applyLifecyclePlan(plan, exec ? { exec } : {});
+    const verified = applied.status === "success"
+      ? verifyGlobalUninstall(plan, options.dir, { configDir, exec })
+      : { status: "failed", evidence: [] };
+    const result = applied.status === "success" && verified.status !== "healthy" ? "failed" : applied.status;
+    const report = createLifecycleResult({
+      operation: "uninstall", result, surface: options.surface, scope: "global",
+      verification: { status: verified.status === "healthy" ? "healthy" : "degraded", evidence: [...applied.completed.map((item) => item.path || item.executable), ...verified.evidence] },
+      restart: { required: result === "success", reason: result === "success" ? "host_reload" : "none" },
+      next_action: result === "success"
+        ? { kind: "restart", text: "Restart the host; the uninstall postcondition has already been verified." }
+        : { kind: "verify", text: "Inspect the reported uninstall or verification failure before retrying." },
+      changes: applied.completed, retained: applied.retained,
+      failure: applied.error
+        ? { 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 });
+    return result === "success" ? 0 : 1;
+  } catch (error) {
+    io.error(error.message);
+    return 1;
+  }
+}
+
 function runScaffold(options, io) {
   const files = generatedFilesForTarget(options.target, options.dir, options.force, options.language);
   const wroteAgentsFragment = files.some((file) => file.path === agdfFragmentPath);

package/lib/cli/command-registry.js

@@ -13,9 +13,12 @@ export const commandRegistry = Object.freeze([
   command("codex", { preferred: [""], scaffold: [""] }),
   command("codex-repo", { preferred: [""], scaffold: [""] }),
   command("claude", { preferred: [""], scaffold: [""] }),
-  command("copilot", { scaffold: [""] }),
+  command("copilot", { preferred: [""], scaffold: [""] }),
   command("opencode", { preferred: [""], scaffold: [""] }),
   command("opencode-status", { preferred: [""], scaffold: [""] }),
+  command("status", { preferred: [" [--surface <surface>] [--run <run_id>] [--json]"] }),
+  command("disable", { preferred: [" --surface <surface> [--scope repository] [--dir <path>]"] }),
+  command("uninstall", { preferred: [" --surface <surface> --scope global [--confirm]"] }),
   command("opencode-repo", { preferred: [""], scaffold: [""] }),
   command("both", { scaffold: [""] }),
   command("init", { preferred: [""], scaffold: [""] }),
@@ -52,6 +55,16 @@ export function validateCommandOptions(options) {
   if (options.target === "run-render-legacy" && !options.runId) {
     throw new Error("run-render-legacy requires --run");
   }
+  if (["disable", "uninstall"].includes(options.target) && ["", "generic", undefined].includes(options.surface)) {
+    throw new Error(`${options.target} requires an explicit --surface`);
+  }
+  if (options.target === "disable" && options.scope && options.scope !== "repository") {
+    throw new Error("disable supports repository scope only");
+  }
+  if (options.target === "uninstall" && options.scope !== "global") {
+    throw new Error("uninstall requires explicit --scope global");
+  }
+  if (options.confirm && options.target !== "uninstall") throw new Error("--confirm is supported only by uninstall");
   return options;
 }
 
@@ -62,11 +75,13 @@ function usageLines(group, prefix) {
 }
 
 export function renderUsage() {
-  return `create-agdf
+  return `AGDF CLI
 
-Preferred AGDF CLI:
+Primary commands:
 ${usageLines("preferred", "npx --yes @agdf/cli@latest ")}
 
+Advanced / Compatibility
+
 Scaffold-compatible npm create usage:
 ${usageLines("scaffold", "npm create agdf@latest -- ")}
 
@@ -85,6 +100,9 @@ Options:
   --all-active   Evaluate every active run (doctor and delivery-map only)
   --surface <codex|claude|copilot|opencode|generic>
                  Declare the active Delivery Path Search surface
+  --scope <repository|global>
+                 Select the lifecycle mutation scope
+  --confirm      Apply a previously previewed global uninstall plan
   --fixture <path>
                  Use deterministic evaluator/candidate fixtures instead of a live evaluator
   --persist      Persist the redacted Delivery Path Search result under the current scope

package/lib/cli/parse-args.js

@@ -41,6 +41,8 @@ export function parseArgs(argv, dependencies = {}) {
   let generationCostUnits = 5;
   let runId;
   let allActive = false;
+  let scope;
+  let confirm = false;
 
   for (let i = 0; i < args.length; i += 1) {
     const arg = args[i];
@@ -52,6 +54,7 @@ export function parseArgs(argv, dependencies = {}) {
     if (arg === "--persist") { persist = true; continue; }
     if (arg === "--generate-candidates") { generateCandidates = true; continue; }
     if (arg === "--all-active") { allActive = true; continue; }
+    if (arg === "--confirm") { confirm = true; continue; }
 
     if (arg === "--run") {
       runId = requiredValue(args, i, arg);
@@ -59,13 +62,16 @@ export function parseArgs(argv, dependencies = {}) {
       continue;
     }
 
-    if (["--surface", "--fixture", "--model", "--generator-model", "--max-generated-candidates", "--generation-timeout-ms", "--generation-cost-units"].includes(arg)) {
+    if (["--surface", "--scope", "--fixture", "--model", "--generator-model", "--max-generated-candidates", "--generation-timeout-ms", "--generation-cost-units"].includes(arg)) {
       const next = requiredValue(args, i, arg);
       if (arg === "--surface") {
         if (!["codex", "claude", "copilot", "opencode", "generic"].includes(next)) {
           throw new CliUsageError("Unsupported surface. Use codex, claude, copilot, opencode or generic.");
         }
         surface = next;
+      } else if (arg === "--scope") {
+        if (!["repository", "global"].includes(next)) throw new CliUsageError("Unsupported scope. Use repository or global.");
+        scope = next;
       } else if (arg === "--fixture") fixture = next;
       else if (arg === "--model") model = next;
       else if (arg === "--generator-model") generatorModel = next;
@@ -133,6 +139,8 @@ export function parseArgs(argv, dependencies = {}) {
       generateCandidates,
       runId,
       allActive,
+      scope,
+      confirm,
       generatorModel,
       maxGeneratedCandidates,
       generationTimeoutMs,