create-agdf 0.13.8 → 0.14.1

package/generated/submissions/openai/agdf/submission/openai/inventory.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.13.8",
-  "digest": "3ada0c5f03ca8fa3d40b54c6682b617e651baea5db6926d07131fa29ea9fcb3a",
+  "releaseVersion": "0.14.1",
+  "digest": "915aec01d7b4ba084bef25b8e772c70e27c31c89c5be111f549e793ec00395ad",
   "files": [
     {
       "path": ".codex-plugin/plugin.json",
-      "sha256": "133bc0840f1be89ea0c3eb0909a26f758104ce0834da31e91a8fdf648102e296"
+      "sha256": "235325cbcc2fff4e90d875df1e1fccb35c92e7c36cac2ded442983171376d7f8"
     },
     {
       "path": "assets/agdf-icon.svg",
@@ -29,7 +29,7 @@
     },
     {
       "path": "meta/agdf-plugin.definition.json",
-      "sha256": "d2b9b8f0134b9747be82f0fa1e9a99dd02a785aa8663514eb8bcc0648727fbf3"
+      "sha256": "6408fc6148f7c9579d5584924155402b98c2ffe68bd21c6048fb5b3169de671a"
     },
     {
       "path": "meta/agdf-runtime-contract.md",
@@ -157,23 +157,23 @@
     },
     {
       "path": "submission/openai/availability.md",
-      "sha256": "1f3dd7874e1e3243ebeee6688fe5fb61a56b11db4212d02791e882e5cc82ee51"
+      "sha256": "fffc251c0d221ca99e0ac26d7a999efa5f5d6b369f006af515840c2540696956"
     },
     {
       "path": "submission/openai/capability-matrix.json",
-      "sha256": "f2e0e6e056f734b06942f5357d3aceb0750107d4989ced101a8aecb302e2f262"
+      "sha256": "98c4efb49f8ec4adc253ba82617539b6a7cd60951cdc1fb0201537c64cb45f56"
     },
     {
       "path": "submission/openai/listing.json",
-      "sha256": "3fda29f5f5544d677f1cf26b7f566773f9e0c1ff0dfca689b0eeabf44d59ea9e"
+      "sha256": "61caa4b27640afcaf1741af96f5693fb1c70db5d9544bd7131a01d93d573441c"
     },
     {
       "path": "submission/openai/release-notes.md",
-      "sha256": "bfd777b576a5387866df286a80fdc8b42552da45742fbe4c73f9a928c0320ef9"
+      "sha256": "f05001114ea205666b6333ceaae2f0bd1df8d0c5ad462ec7dd922029640954f3"
     },
     {
       "path": "submission/openai/reviewer-cases.json",
-      "sha256": "df9946827c4102cd8eaedbfa4a6dd234098f85c82aa6d481c1634c7647362b2c"
+      "sha256": "f0a37d259eab3f2432ceb4a1f3d602f812f9b45bd063503679fa094de344046c"
     }
   ]
 }

package/generated/submissions/openai/agdf/submission/openai/listing.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.13.8",
+  "releaseVersion": "0.14.1",
   "submissionType": "skills",
   "identity": {
     "technicalId": "agdf",

package/generated/submissions/openai/agdf/submission/openai/readiness.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.13.8",
+  "releaseVersion": "0.14.1",
   "candidateState": "repository_ready",
   "submissionReady": false,
   "submissionBlockers": [
@@ -16,7 +16,7 @@
     },
     "bundle": {
       "state": "pass",
-      "detail": "43 inventoried files; inventory digest 3ada0c5f03ca8fa3d40b54c6682b617e651baea5db6926d07131fa29ea9fcb3a"
+      "detail": "43 inventoried files; inventory digest 915aec01d7b4ba084bef25b8e772c70e27c31c89c5be111f549e793ec00395ad"
     },
     "installed_host": {
       "state": "unverified",

package/generated/submissions/openai/agdf/submission/openai/readiness.md

@@ -1,6 +1,6 @@
 # AGDF Public Plugin Readiness
 
-- release: `0.13.8`
+- release: `0.14.1`
 - candidate_state: `repository_ready`
 - submission_ready: `false`
 
@@ -9,7 +9,7 @@
 | Class | State | Detail |
 |---|---|---|
 | repository | pass | canonical contract and deterministic source checks |
-| bundle | pass | 43 inventoried files; inventory digest 3ada0c5f03ca8fa3d40b54c6682b617e651baea5db6926d07131fa29ea9fcb3a |
+| bundle | pass | 43 inventoried files; inventory digest 915aec01d7b4ba084bef25b8e772c70e27c31c89c5be111f549e793ec00395ad |
 | installed_host | unverified | PPD-L02 and PPD-L03 not performed |
 | portal | unverified | unverified |
 | post_publication | unverified | not published |

package/generated/submissions/openai/agdf/submission/openai/release-notes.md

@@ -1,4 +1,4 @@
-# AGDF 0.13.8 — Initial OpenAI Public Plugin Candidate
+# AGDF 0.14.1 — Initial OpenAI Public Plugin Candidate
 
 This candidate packages the canonical AGDF workflow skills for public discovery in ChatGPT and
 Codex. It helps users assess delivery fit, preserve explicit human approvals, inspect existing-system

package/generated/submissions/openai/agdf/submission/openai/reviewer-cases.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.13.8",
+  "releaseVersion": "0.14.1",
   "cases": [
     {
       "id": "positive-proportional-fit",

package/lib/cli/application.js

@@ -17,6 +17,7 @@ import {
 } from "../installers/opencode.js";
 import {
   installClaudeGlobalPlugin,
+  installCopilotGlobalPlugin,
   installCodexGlobalPlugin,
 } from "../installers/plugin-installers.js";
 import {
@@ -30,7 +31,7 @@ import { printGeneralStatus, printLifecycleResult } from "../lifecycle/presentat
 import { createLifecycleResult, globalInstallRestartAction, lifecycleFailure } from "../lifecycle/result.js";
 import { prepareInstallConsent, persistInstallConsent, retainCurrentInstallConsent, runtimeCheckStatus, setRuntimeChecksManual } from "../runtime-check-consent/service.js";
 import { evaluateGeneralStatus } from "../lifecycle/status.js";
-import { agdfFragmentPath, generatedFilesForTarget } from "../scaffold/plan.js";
+import { generatedFilesForTarget } from "../scaffold/plan.js";
 import { printNextSteps } from "../scaffold/presentation.js";
 import { assertGeneratedWritePlan, writeGeneratedFile } from "../scaffold/write.js";
 import { renderUsage, resolveCommand, validateCommandOptions } from "./command-registry.js";
@@ -38,19 +39,19 @@ import { CliUsageError, parseArgs } from "./parse-args.js";
 import { pluginDefinition } from "./runtime-context.js";
 import { createValidationHandlers } from "./validation-handlers.js";
 
-function createHandlers({ io, env, exec, prepare, openCodePackageSource, askRuntimeCheckDecision, interactive }) {
+function createHandlers({ io, env, exec, packagedCopilotExec, prepare, openCodePackageSource, copilotSettingsPath, askRuntimeCheckDecision, interactive }) {
   const installerAdapters = {
     ...(exec ? { exec } : {}),
+    ...(packagedCopilotExec ? { packagedCopilotExec } : {}),
     ...(prepare ? { prepare } : {}),
+    ...(copilotSettingsPath ? { copilotSettingsPath } : {}),
     ...(env.AGDF_DATA_DIR ? { dataRoot: env.AGDF_DATA_DIR } : {}),
   };
   const scaffoldHandler = (options) => runScaffold(options, io);
   return new Map([
     ...createValidationHandlers(io),
     ["codex-repo", scaffoldHandler],
-    ["copilot", scaffoldHandler],
     ["opencode-repo", scaffoldHandler],
-    ["both", scaffoldHandler],
     ["init", scaffoldHandler],
     ["config", scaffoldHandler],
     ["run-create", (options) => {
@@ -141,6 +142,56 @@ function createHandlers({ io, env, exec, prepare, openCodePackageSource, askRunt
         return 1;
       }
     }],
+    ["copilot", async (options) => {
+      const surface = "copilot";
+      try {
+        const consent = await installConsentDecision(surface, options, { io, askRuntimeCheckDecision, interactive, dataRoot: installerAdapters.dataRoot });
+        if (consent.decision === "cancel") return printCancelledConsent(surface, options, io);
+        printInstallProgress(surface, options, io, interactive);
+        const installed = installCopilotGlobalPlugin({
+          ...installerAdapters,
+        });
+        const finalizedConsent = finalizeInstallConsent(consent, { surface, installed, dataRoot: installerAdapters.dataRoot });
+        if (installed.declarativeConfigured) {
+          printLifecycleResult(createLifecycleResult({
+            operation: "install", result: "partial", surface, scope: "global",
+            version: { expected: installed.expectedVersion, installed: null, status: "unknown" },
+            verification: { status: "configured_pending_restart", evidence: installed.evidence },
+            installation: { status: "configured_pending_restart" },
+            activation: { status: "pending_restart" },
+            runtime_checks: finalizedConsent.state,
+            restart: { required: true, reason: "host_reload" },
+            next_action: { kind: "restart", text: "Restart GitHub Copilot. Then verify AGDF in Plugins and the agdf- skills in a fresh session." },
+          }), { json: options.json, compact: !options.verbose, io });
+          return 0;
+        }
+        if (installed.manualHandoff) {
+          printLifecycleResult(createLifecycleResult({
+            operation: "install", result: "partial", surface, scope: "global",
+            version: { expected: installed.expectedVersion, installed: null, status: "unknown" },
+            verification: { status: "unavailable", evidence: installed.evidence },
+            installation: { status: "not_verified" },
+            activation: { status: "not_verified" },
+            runtime_checks: finalizedConsent.state,
+            restart: { required: false, reason: "none" },
+            next_action: { kind: "manual_install", text: `In GitHub Copilot, run /plugins install ${installed.pluginRoot}. Then run /restart and verify /plugins list and /skills list.` },
+            failure: { phase: "executable", message: "Copilot CLI was not available; no plugin installation was performed." },
+          }), { json: options.json, compact: !options.verbose, io });
+          return 1;
+        }
+        printLifecycleResult(installResult(installed, {
+          restartRequired: true,
+          nextAction: installNextAction(surface, finalizedConsent.state, globalInstallRestartAction(surface).text),
+          runtimeChecks: finalizedConsent.state,
+          consentFailure: finalizedConsent.failure,
+        }), { json: options.json, compact: !options.verbose, io });
+        printVerboseHostOutput(installed, options, io);
+        return installed.verificationStatus === "healthy" ? 0 : 1;
+      } catch (error) {
+        printInstallFailure(surface, error, options, io, "copilot");
+        return 1;
+      }
+    }],
     ["opencode", async (options) => {
       const configDir = options.dirExplicit ? options.dir : defaultOpenCodeConfigDir();
       try {
@@ -230,6 +281,9 @@ function installNextAction(surface, runtimeChecks, fallback) {
   if (surface === "codex" && runtimeChecks.requested === "enabled" && runtimeChecks.effective === "decision_required") {
     return "Restart Codex, then approve the AGDF session hook when Codex asks.";
   }
+  if (surface === "copilot" && runtimeChecks.requested === "enabled" && runtimeChecks.effective === "decision_required") {
+    return "Restart GitHub Copilot, then review the AGDF session hook when Copilot asks.";
+  }
   return fallback;
 }
 
@@ -313,6 +367,7 @@ function printInstallConsentDisclosure(disclosure, retained, io) {
 
 function installSurfaceLabel(surface) {
   if (surface === "claude") return "Claude Code";
+  if (surface === "copilot") return "GitHub Copilot";
   if (surface === "opencode") return "OpenCode";
   return "Codex";
 }
@@ -356,7 +411,7 @@ function printVerboseHostOutput(installed, options, io) {
   for (const output of installed.nativeOutput) io.log(output);
 }
 
-function printInstallFailure(surface, error, options, io) {
+function printInstallFailure(surface, error, options, io, command = surface) {
   const report = lifecycleFailure({
     operation: "install",
     surface,
@@ -364,7 +419,7 @@ function printInstallFailure(surface, error, options, io) {
     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}.`,
+    nextAction: `Resolve the ${error.phase || "plugin operation"} failure and rerun npx --yes @agdf/cli@latest ${command}.`,
   });
   if (options.json) printLifecycleResult(report, { json: true, io });
   else {
@@ -445,7 +500,6 @@ function runUninstall(options, { io, env, exec }) {
 
 function runScaffold(options, io) {
   const files = generatedFilesForTarget(options.target, options.dir, options.force, options.language);
-  const wroteAgentsFragment = files.some((file) => file.path === agdfFragmentPath);
   let removedOpenCodeAgents = [];
 
   try {
@@ -460,7 +514,7 @@ function runScaffold(options, io) {
     return 1;
   }
 
-  printNextSteps(options.target, options.dir, files, wroteAgentsFragment, removedOpenCodeAgents, { verbose: options.verbose, json: options.json, io });
+  printNextSteps(options.target, options.dir, files, removedOpenCodeAgents, { verbose: options.verbose, json: options.json, io });
   return 0;
 }
 
@@ -500,8 +554,10 @@ export async function runCli(argv = process.argv.slice(2), adapters = {}) {
     io,
     env,
     exec: adapters.exec,
+    packagedCopilotExec: adapters.packagedCopilotExec,
     prepare: adapters.prepare,
     openCodePackageSource: adapters.openCodePackageSource,
+    copilotSettingsPath: adapters.copilotSettingsPath,
     askRuntimeCheckDecision: adapters.askRuntimeCheckDecision ?? defaultAskRuntimeCheckDecision,
     interactive: adapters.interactive ?? (Boolean(process.stdin.isTTY) && Boolean(process.stdout.isTTY)),
   }).get(command.handler);

package/lib/cli/command-registry.js

@@ -13,15 +13,14 @@ export const commandRegistry = Object.freeze([
   command("codex", { preferred: [""], scaffold: [""] }),
   command("codex-repo", { preferred: [""], scaffold: [""] }),
   command("claude", { preferred: [""], scaffold: [""] }),
-  command("copilot", { preferred: [""], scaffold: [""] }),
+  command("copilot", { preferred: [""] }),
   command("opencode", { preferred: [""], scaffold: [""] }),
   command("opencode-status", { preferred: [""], scaffold: [""] }),
   command("status", { preferred: [" [--surface <surface>] [--run <run_id>] [--json]"] }),
-  command("runtime-checks", { preferred: [" <status|enable|manual> --surface <codex|claude|opencode> [--json]"] }),
+  command("runtime-checks", { preferred: [" <status|enable|manual> --surface <codex|claude|copilot|opencode> [--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: [""] }),
   command("config", { scaffold: [" --language de"] }),
   command("doctor", { local: [""], scaffold: [""], legacy: [" --json"] }),
@@ -66,11 +65,11 @@ export function validateCommandOptions(options) {
     throw new Error("uninstall requires explicit --scope global");
   }
   if (options.confirm && options.target !== "uninstall") throw new Error("--confirm is supported only by uninstall");
-  if (options.runtimeChecksDecision && !["codex", "claude", "opencode"].includes(options.target)) {
-    throw new Error("--runtime-checks is supported only by codex, claude and opencode installation commands");
+  if (options.runtimeChecksDecision && !["codex", "claude", "copilot", "opencode"].includes(options.target)) {
+    throw new Error("--runtime-checks is supported only by codex, claude, copilot and opencode installation commands");
   }
-  if (options.target === "runtime-checks" && !["codex", "claude", "opencode"].includes(options.surface)) {
-    throw new Error("runtime-checks requires --surface codex, claude or opencode");
+  if (options.target === "runtime-checks" && !["codex", "claude", "copilot", "opencode"].includes(options.surface)) {
+    throw new Error("runtime-checks requires --surface codex, claude, copilot or opencode");
   }
   if (options.approvalEnvelope && options.target !== "gate-check") throw new Error("--approval-envelope is supported only by gate-check");
   if (options.approvalEnvelope && (options.json || options.statusCard || options.allActive)) {

package/lib/installers/copilot-precedence.js

@@ -0,0 +1,34 @@
+function skillNames(values, field) {
+  if (!Array.isArray(values) || values.some((value) => typeof value !== "string" || !value.trim())) {
+    throw new Error(`AGDF_COPILOT_PRECEDENCE_INVALID: ${field}`);
+  }
+  const normalized = values.map((value) => value.trim());
+  if (new Set(normalized).size !== normalized.length) throw new Error(`AGDF_COPILOT_PRECEDENCE_DUPLICATE: ${field}`);
+  return new Set(normalized);
+}
+
+export function diagnoseCopilotSkillPrecedence({ declaredPluginSkills, projectSkills = [], personalSkills = [] } = {}) {
+  const plugin = skillNames(declaredPluginSkills, "declaredPluginSkills");
+  const project = skillNames(projectSkills, "projectSkills");
+  const personal = skillNames(personalSkills, "personalSkills");
+  const skills = [...plugin].sort().map((name) => {
+    const projectMatch = project.has(name);
+    const personalMatch = personal.has(name);
+    return Object.freeze({
+      name,
+      effective_source: projectMatch ? "project" : personalMatch ? "personal" : "plugin",
+      plugin_loaded: !projectMatch && !personalMatch,
+      collisions: Object.freeze([
+        ...(projectMatch ? ["project"] : []),
+        ...(personalMatch ? ["personal"] : []),
+      ]),
+      mutation: "none",
+    });
+  });
+  return Object.freeze({
+    schema_version: 1,
+    precedence: Object.freeze(["project", "personal", "plugin"]),
+    skills: Object.freeze(skills),
+    destructive_override: false,
+  });
+}

package/lib/installers/copilot-settings.js

@@ -0,0 +1,84 @@
+import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import process from "node:process";
+import { renameSyncWithRetry } from "../fs-swap.js";
+
+export function defaultCopilotSettingsPath({ env = process.env, home = homedir() } = {}) {
+  return join(resolve(env.COPILOT_HOME || join(home, ".copilot")), "settings.json");
+}
+
+export function readCopilotSettings(path = defaultCopilotSettingsPath()) {
+  if (!existsSync(path)) return { exists: false, settings: {} };
+  const stats = lstatSync(path);
+  if (!stats.isFile() || stats.isSymbolicLink()) throw new Error("AGDF_COPILOT_SETTINGS_UNOWNED_PATH");
+  try {
+    const settings = JSON.parse(readFileSync(path, "utf8"));
+    if (!settings || typeof settings !== "object" || Array.isArray(settings)) throw new Error("not an object");
+    if (settings.enabledPlugins !== undefined
+        && (!settings.enabledPlugins || typeof settings.enabledPlugins !== "object" || Array.isArray(settings.enabledPlugins))) {
+      throw new Error("enabledPlugins must be an object");
+    }
+    return { exists: true, settings };
+  } catch (error) {
+    throw new Error(`AGDF_COPILOT_SETTINGS_INVALID: ${error.message}`);
+  }
+}
+
+function atomicSettingsWrite(path, settings) {
+  mkdirSync(dirname(path), { recursive: true });
+  const temp = `${path}.agdf-tmp-${process.pid}`;
+  const backup = `${path}.agdf-backup-${process.pid}`;
+  const hadPrevious = existsSync(path);
+  const mode = hadPrevious ? lstatSync(path).mode & 0o777 : 0o600;
+  writeFileSync(temp, `${JSON.stringify(settings, null, 2)}\n`, { encoding: "utf8", flag: "wx", mode });
+  if (process.platform !== "win32") chmodSync(temp, mode);
+  try {
+    if (hadPrevious && process.platform === "win32") renameSyncWithRetry(path, backup);
+    renameSyncWithRetry(temp, path);
+    if (hadPrevious && process.platform === "win32") rmSync(backup, { force: true });
+  } catch (error) {
+    try { rmSync(temp, { force: true }); } catch {}
+    if (hadPrevious && process.platform === "win32" && existsSync(backup) && !existsSync(path)) renameSyncWithRetry(backup, path);
+    throw error;
+  }
+}
+
+export function configureCopilotDeclarativePlugin({ path = defaultCopilotSettingsPath(), pluginRoot }) {
+  if (typeof pluginRoot !== "string" || !pluginRoot.trim() || !isAbsolute(pluginRoot)) {
+    throw new Error("AGDF_COPILOT_PLUGIN_SPEC_INVALID");
+  }
+  const spec = resolve(pluginRoot);
+  if (!existsSync(spec) || !lstatSync(spec).isDirectory() || lstatSync(spec).isSymbolicLink()) {
+    throw new Error("AGDF_COPILOT_PLUGIN_SPEC_UNAVAILABLE");
+  }
+  const before = readCopilotSettings(path);
+  const next = structuredClone(before.settings);
+  next.enabledPlugins = { ...(next.enabledPlugins ?? {}), [spec]: true };
+  atomicSettingsWrite(path, next);
+  const verified = readCopilotSettings(path);
+  if (verified.settings.enabledPlugins?.[spec] !== true) throw new Error("AGDF_COPILOT_SETTINGS_VERIFICATION_FAILED");
+  return {
+    status: "configured_pending_restart",
+    reason: "host_activation_unverified",
+    path,
+    spec,
+    rollback() {
+      if (before.exists) atomicSettingsWrite(path, before.settings);
+      else rmSync(path, { force: true });
+    },
+  };
+}
+
+export function revokeCopilotDeclarativePlugin({ path = defaultCopilotSettingsPath(), pluginRoot }) {
+  const before = readCopilotSettings(path);
+  if (!before.exists) return { status: "not_configured", path };
+  const spec = resolve(pluginRoot);
+  const next = structuredClone(before.settings);
+  if (next.enabledPlugins && Object.hasOwn(next.enabledPlugins, spec)) {
+    delete next.enabledPlugins[spec];
+    if (Object.keys(next.enabledPlugins).length === 0) delete next.enabledPlugins;
+    atomicSettingsWrite(path, next);
+  }
+  return { status: "removed", path, spec };
+}

package/lib/installers/plugin-installers.js

@@ -1,7 +1,13 @@
 import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import process from "node:process";
 import { pluginDefinition } from "../cli/runtime-context.js";
+import { digestNormalizedPluginSource } from "../runtime/plugin-provenance.js";
 import { CODEX_REGISTRATION_REVISION, classifyMarketplaceList, inspectLocalMarketplaceProjection, isCodexLocalInstallVersion, prepareLocalMarketplace } from "./local-marketplace.js";
 
+export const COPILOT_CLI_NPM_PACKAGE = "@github/copilot@1.0.80";
+
 export function installCodexGlobalPlugin({ exec = execFileSync, prepare = prepareLocalMarketplace, dataRoot } = {}) {
   const expectedVersion = pluginDefinition.version;
   const nativeOutput = [];
@@ -93,6 +99,142 @@ export function installClaudeGlobalPlugin({ exec = execFileSync, prepare = prepa
   }
 }
 
+export function installCopilotGlobalPlugin({ exec = execFileSync, packagedCopilotExec = execFileSync, prepare = prepareLocalMarketplace, dataRoot, pluginRoot } = {}) {
+  const expectedVersion = pluginDefinition.version;
+  const transaction = pluginRoot ? null : prepare({ expectedVersion, ...(dataRoot ? { dataRoot } : {}) });
+  const effectivePluginRoot = pluginRoot ?? transaction?.pluginRoot;
+  if (!effectivePluginRoot) throw lifecycleAdapterError("package", "AGDF Copilot plugin root is required.");
+  let runtimeManifest;
+  try {
+    runtimeManifest = JSON.parse(readFileSync(join(effectivePluginRoot, "runtime", "runtime-manifest.json"), "utf8"));
+  } catch (error) {
+    transaction?.rollback();
+    throw lifecycleAdapterError("package", `AGDF Copilot runtime manifest is unavailable: ${error.message}`);
+  }
+  const sourceDigest = transaction?.sourceDigest || digestNormalizedPluginSource(effectivePluginRoot, expectedVersion);
+  let before = "";
+  let activeExec = exec;
+  const bootstrapEvidence = [];
+  try {
+    before = activeExec("copilot", ["plugin", "list"], captureOptions());
+  } catch (error) {
+    if (error?.code !== "ENOENT") {
+      transaction?.rollback();
+      throw lifecycleAdapterError("verification", commandErrorText(error), { executable: "copilot", args: ["plugin", "list"] });
+    }
+    const invocation = copilotNpmInvocation();
+    activeExec = (_executable, args, options) => packagedCopilotExec(invocation.executable, [...invocation.args, ...args], options);
+    try {
+      before = activeExec("copilot", ["plugin", "list"], captureOptions());
+      bootstrapEvidence.push("copilot_cli_not_found", `copilot_cli_npm_package:${COPILOT_CLI_NPM_PACKAGE}`);
+    } catch (bootstrapError) {
+      transaction?.commit();
+      return {
+        surface: "copilot", operation: "install", expectedVersion, installedVersion: null,
+        verificationStatus: "unavailable", manualHandoff: true,
+        evidence: ["copilot_cli_not_found", `copilot_cli_npm_bootstrap_failed:${commandErrorText(bootstrapError)}`, "durable_local_plugin_stage", `local_plugin_root:${effectivePluginRoot}`, `source_digest:${sourceDigest}`],
+        pluginRoot: effectivePluginRoot, runtimeDigest: runtimeManifest.digest, sourceDigest, nativeOutput: [],
+      };
+    }
+  }
+  const directInstalled = pluginListHasPlugin(before, "agdf");
+  const marketplaceInstalled = pluginListHasPlugin(before, "agdf@agdf");
+  let marketplaceAdded = false;
+  let directRemoved = false;
+  try {
+    const nativeOutput = [];
+    const marketplaceOutput = runPluginPhase(activeExec, "copilot", ["plugin", "marketplace", "list"], "marketplace", captureOptions());
+    const marketplace = classifyCopilotMarketplaceList(marketplaceOutput, transaction?.root ?? resolve(effectivePluginRoot, "..", ".."));
+    if (marketplace.state === "conflict") {
+      throw lifecycleAdapterError("marketplace", `Refusing to replace non-AGDF Copilot marketplace registration agdf (${marketplace.source || "unknown source"}).`);
+    }
+    if (marketplace.state === "absent") {
+      nativeOutput.push(runPluginPhase(activeExec, "copilot", ["plugin", "marketplace", "add", transaction?.root ?? resolve(effectivePluginRoot, "..", "..")], "marketplace", captureOptions()));
+      marketplaceAdded = true;
+    }
+    if (directInstalled) {
+      nativeOutput.push(runPluginPhase(activeExec, "copilot", ["plugin", "uninstall", "agdf"], "plugin_operation", captureOptions()));
+      directRemoved = true;
+    }
+    nativeOutput.push(runPluginPhase(activeExec, "copilot", ["plugin", "install", "agdf@agdf"], "plugin_operation", captureOptions()));
+    const after = runPluginPhase(activeExec, "copilot", ["plugin", "list"], "verification", captureOptions());
+    const installed = pluginListHasPlugin(after, "agdf@agdf");
+    const installedVersion = installed ? pluginVersionFromList(after, "agdf@agdf") : "";
+    if (!installed) throw lifecycleAdapterError("verification", "AGDF was not present in copilot plugin list after installation.");
+    if (installedVersion && installedVersion !== expectedVersion) {
+      throw lifecycleAdapterError("version", versionMismatchMessage("GitHub Copilot", "agdf", expectedVersion, installedVersion, "npx --yes @agdf/cli@latest copilot"));
+    }
+    transaction?.commit();
+    return {
+      surface: "copilot", operation: directInstalled || marketplaceInstalled ? "update" : "install", expectedVersion,
+      installedVersion: installedVersion || null, verificationStatus: installedVersion ? "healthy" : "degraded",
+      manualHandoff: false,
+      evidence: [...bootstrapEvidence, "durable_local_plugin_stage", "copilot plugin marketplace list", ...(marketplaceAdded ? ["copilot plugin marketplace add"] : ["marketplace:owned_local_current"]), ...(directRemoved ? ["direct_install_migrated"] : []), "copilot plugin install agdf@agdf", "copilot plugin list", `local_plugin_root:${effectivePluginRoot}`, `source_digest:${sourceDigest}`, ...(installedVersion ? [] : ["host_did_not_expose_version"])],
+      pluginRoot: effectivePluginRoot, runtimeDigest: runtimeManifest.digest, sourceDigest, nativeOutput: nativeOutput.filter(Boolean).map(String),
+    };
+  } catch (error) {
+    transaction?.rollback();
+    if (directRemoved) {
+      try {
+        activeExec("copilot", ["plugin", "install", effectivePluginRoot], captureOptions());
+      } catch (recoveryError) {
+        error.evidence = { ...(error.evidence ?? {}), direct_install_recovery: commandErrorText(recoveryError) };
+      }
+    }
+    if (marketplaceAdded) {
+      try {
+        activeExec("copilot", ["plugin", "marketplace", "remove", "agdf"], captureOptions());
+      } catch (recoveryError) {
+        error.evidence = { ...(error.evidence ?? {}), marketplace_recovery: commandErrorText(recoveryError) };
+      }
+    }
+    throw error;
+  }
+}
+
+export function classifyCopilotMarketplaceList(output, expectedRoot) {
+  const line = String(output || "").split(/\r?\n/).find((entry) => /^\s*[◆•]?\s*agdf\s+\(/.test(entry));
+  if (!line) return { state: "absent", source: "" };
+  const local = line.match(/\(Local:\s*(.+)\)\s*$/);
+  if (!local) return { state: "conflict", source: line.trim() };
+  return resolve(local[1]) === resolve(expectedRoot)
+    ? { state: "owned_local_current", source: local[1] }
+    : { state: "conflict", source: local[1] };
+}
+
+export function copilotNpmInvocation({ env = process.env, platform = process.platform, execPath = process.execPath } = {}) {
+  const args = ["exec", "--yes", `--package=${COPILOT_CLI_NPM_PACKAGE}`, "--", "copilot"];
+  if (env.npm_execpath) return { executable: execPath, args: [env.npm_execpath, ...args] };
+  return { executable: platform === "win32" ? "npm.cmd" : "npm", args };
+}
+
+export function setCopilotPluginEnabled({ enabled, exec = execFileSync } = {}) {
+  if (typeof enabled !== "boolean") throw lifecycleAdapterError("plugin_operation", "Copilot plugin enabled state must be boolean.");
+  const operation = enabled ? "enable" : "disable";
+  try {
+    const nativeOutput = runPluginPhase(exec, "copilot", ["plugin", operation, "agdf"], "plugin_operation", captureOptions());
+    const listOutput = runPluginPhase(exec, "copilot", ["plugin", "list"], "verification", captureOptions());
+    if (!pluginListHasPlugin(listOutput, "agdf") && !pluginListHasPlugin(listOutput, "agdf@agdf")) {
+      throw lifecycleAdapterError("verification", "AGDF was not present in copilot plugin list after the state change.");
+    }
+    return {
+      surface: "copilot",
+      requestedState: enabled ? "enabled" : "disabled",
+      status: "command_accepted_host_state_unverified",
+      evidence: [`copilot plugin ${operation} agdf`, "copilot plugin list", "fresh_session_required"],
+      nativeOutput: String(nativeOutput || ""),
+    };
+  } catch (error) {
+    if (/\bmanaged\b/i.test(commandErrorText(error))) {
+      return {
+        surface: "copilot", requestedState: enabled ? "enabled" : "disabled", status: "managed",
+        evidence: ["managed_policy_precedence", commandErrorText(error)], nativeOutput: "",
+      };
+    }
+    throw error;
+  }
+}
+
 function migrateMarketplace({ surface, exec, output, root, nativeOutput, migration, refreshOwnedLocal = false }) {
   const classification = classifyMarketplaceList(surface, output, root);
   Object.assign(migration, classification);
@@ -176,10 +318,10 @@ function captureOptions() {
 }
 
 export function inspectPluginSurface(surface, exec = execFileSync, options = {}) {
-  const executable = surface === "claude" ? "claude" : "codex";
-  const pluginId = "agdf@agdf";
+  const executable = surface === "claude" ? "claude" : surface === "copilot" ? "copilot" : "codex";
   try {
     const output = exec(executable, ["plugin", "list"], { encoding: "utf8", stdio: "pipe" });
+    const pluginId = surface === "copilot" && !pluginListHasPlugin(output, "agdf@agdf") ? "agdf" : "agdf@agdf";
     const installed = pluginListHasPlugin(output, pluginId);
     const version = installed ? pluginVersionFromList(output, pluginId) : "";
     let localDevelopmentVersion = false;
@@ -227,12 +369,13 @@ function commandErrorText(error) {
 }
 
 export function pluginListHasPlugin(output, pluginId) {
+  const escapedPluginId = pluginId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   return output
     .split(/\r?\n/)
-    .some((line) => line.includes(pluginId));
+    .some((line) => new RegExp(`(^|\\s)${escapedPluginId}(\\s|$)`).test(line));
 }
 
-const VERSION_PATTERN = "(\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?)";
+const VERSION_PATTERN = "v?(\\d+\\.\\d+\\.\\d+(?:[-+][0-9A-Za-z.-]+)?)";
 
 export function pluginVersionFromList(output, pluginId) {
   const escapedPluginId = pluginId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");

package/lib/lifecycle/operations.js

@@ -85,6 +85,9 @@ export function planGlobalUninstall(surface, { configDir } = {}) {
   if (surface === "claude") {
     return nativeUninstallPlan(surface, "claude", ["plugin", "uninstall", "agdf@agdf", "--scope", "user"]);
   }
+  if (surface === "copilot") {
+    return nativeUninstallPlan(surface, "copilot", ["plugin", "uninstall", "agdf"]);
+  }
   if (surface === "opencode") {
     if (!configDir) throw new Error("OpenCode uninstall requires its explicit config directory.");
     const configPath = join(configDir, "opencode.json");

package/lib/lifecycle/result.js

@@ -5,6 +5,7 @@ const SURFACES = new Set(["codex", "claude", "copilot", "opencode", "generic"]);
 const GLOBAL_INSTALL_RESTART_ACTIONS = Object.freeze({
   codex: "Restart Codex.",
   claude: "Restart Claude Code.",
+  copilot: "Restart GitHub Copilot.",
   opencode: "Restart OpenCode.",
 });