create-agdf 0.13.8 → 0.14.2

package/lib/installers/local-marketplace.js

@@ -15,6 +15,7 @@ import {
   INSTALLATION_PROVENANCE_FILE,
   LEGACY_LOCAL_INSTALL_FILE,
   digestDirectory,
+  inspectCopilotPayloadInventory,
   digestNormalizedPluginSource,
   inspectInstallationProvenance,
   validateDistributionProfiles,
@@ -141,20 +142,39 @@ function claudeMarketplace(definition = pluginDefinition) {
   };
 }
 
+function copilotMarketplace(definition = pluginDefinition) {
+  return {
+    name: MARKETPLACE_ID,
+    owner: { name: definition.displayName, email: "" },
+    metadata: { description: definition.description, version: definition.version },
+    plugins: [{
+      name: definition.id,
+      description: definition.copilotDescription || definition.longDescription,
+      version: definition.version,
+      source: "./plugins/agdf",
+    }],
+  };
+}
+
 function validateBuiltPlugin(pluginRoot, expectedVersion, expectedCodexInstallVersion = expectedVersion, sourceDigest = "", {
   requireInstallationProvenance = false,
   allowLegacyProvenanceForMigration = false,
   allowPreProvenanceShape = false,
+  profileId = "runtime-plugin",
 } = {}) {
   const definition = readJson(join(pluginRoot, "meta", "agdf-plugin.definition.json"), "built plugin definition");
   const runtime = readJson(join(pluginRoot, "runtime", "runtime-manifest.json"), "built runtime manifest");
-  const codex = readJson(join(pluginRoot, ".codex-plugin", "plugin.json"), "built Codex plugin manifest");
-  const claude = readJson(join(pluginRoot, ".claude-plugin", "plugin.json"), "built Claude plugin manifest");
+  const copilotProfile = profileId === "copilot-runtime-plugin";
+  const codex = copilotProfile ? null : readJson(join(pluginRoot, ".codex-plugin", "plugin.json"), "built Codex plugin manifest");
+  const claude = copilotProfile ? null : readJson(join(pluginRoot, ".claude-plugin", "plugin.json"), "built Claude plugin manifest");
+  const copilot = copilotProfile ? readJson(join(pluginRoot, "plugin.json"), "built Copilot plugin manifest") : null;
   for (const required of [
-    join(pluginRoot, ".codex-plugin", "plugin.json"),
-    join(pluginRoot, ".claude-plugin", "plugin.json"),
+    ...(copilotProfile ? [join(pluginRoot, "plugin.json"), join(pluginRoot, ".agdf-payload-inventory.json")] : [
+      join(pluginRoot, ".codex-plugin", "plugin.json"),
+      join(pluginRoot, ".claude-plugin", "plugin.json"),
+      join(pluginRoot, "scripts", "check-runtime-integrity.mjs"),
+    ]),
     join(pluginRoot, "runtime", "agdf-local.js"),
-    join(pluginRoot, "scripts", "check-runtime-integrity.mjs"),
   ]) {
     if (!existsSync(required)) throw new Error(`Built plugin is incomplete: ${required}`);
   }
@@ -178,13 +198,20 @@ function validateBuiltPlugin(pluginRoot, expectedVersion, expectedCodexInstallVe
   if (profile.status !== "matched" && provenance?.status !== "legacy" && !isPreProvenanceShape) {
     throw new Error("Built plugin distribution profile contract is invalid.");
   }
-  if (codex.version !== expectedCodexInstallVersion) {
+  if (!copilotProfile && codex.version !== expectedCodexInstallVersion) {
     throw new Error(`Built Codex plugin version mismatch: expected ${expectedCodexInstallVersion}, observed ${codex.version}`);
   }
-  if (claude.version !== expectedVersion) {
+  if (!copilotProfile && claude.version !== expectedVersion) {
     throw new Error(`Built Claude plugin version mismatch: expected ${expectedVersion}, observed ${claude.version}`);
   }
-  if (expectedCodexInstallVersion !== expectedVersion) {
+  if (copilotProfile && copilot.version !== expectedVersion) {
+    throw new Error(`Built Copilot plugin version mismatch: expected ${expectedVersion}, observed ${copilot.version}`);
+  }
+  const copilotInventory = copilotProfile ? inspectCopilotPayloadInventory(pluginRoot, expectedVersion) : null;
+  if (copilotProfile && copilotInventory.status !== "matched") {
+    throw new Error(`Built Copilot plugin inventory is invalid: ${copilotInventory.reason}`);
+  }
+  if (!copilotProfile && expectedCodexInstallVersion !== expectedVersion) {
     if (!isCodexLocalInstallVersion(expectedVersion, expectedCodexInstallVersion, sourceDigest)) {
       throw new Error(`Invalid AGDF Codex local install version: ${expectedCodexInstallVersion}`);
     }
@@ -199,6 +226,8 @@ function validateBuiltPlugin(pluginRoot, expectedVersion, expectedCodexInstallVe
       runtimeManifest: runtime,
       pluginVersion: expectedCodexInstallVersion,
       allowLegacy: allowLegacyProvenanceForMigration,
+      profileId,
+      inventoryDigest: copilotInventory?.inventoryDigest ?? null,
     });
     if (provenance.status !== "matched"
         && !(allowLegacyProvenanceForMigration && provenance.status === "legacy")) {
@@ -208,11 +237,15 @@ function validateBuiltPlugin(pluginRoot, expectedVersion, expectedCodexInstallVe
   return definition;
 }
 
-function validateMarketplaceRoot(root, definition = pluginDefinition) {
-  const codex = readJson(join(root, ".agents", "plugins", "marketplace.json"), "Codex local marketplace manifest");
-  const claude = readJson(join(root, ".claude-plugin", "marketplace.json"), "Claude local marketplace manifest");
+function validateMarketplaceRoot(root, definition = pluginDefinition, { profileId = "runtime-plugin" } = {}) {
+  const copilotProfile = profileId === "copilot-runtime-plugin";
+  const codex = copilotProfile ? null : readJson(join(root, ".agents", "plugins", "marketplace.json"), "Codex local marketplace manifest");
+  const copilot = copilotProfile ? readJson(join(root, ".github", "plugin", "marketplace.json"), "Copilot local marketplace manifest") : null;
+  const claude = copilotProfile ? null : readJson(join(root, ".claude-plugin", "marketplace.json"), "Claude local marketplace manifest");
   const serializedCodex = JSON.stringify(codex);
-  const codexShape = serializedCodex === JSON.stringify(codexMarketplace(definition))
+  const codexShape = copilotProfile
+    ? "current"
+    : serializedCodex === JSON.stringify(codexMarketplace(definition))
     ? "current"
     : serializedCodex === JSON.stringify(legacyCodexMarketplace(definition))
       ? "legacy_full_product_label"
@@ -220,15 +253,19 @@ function validateMarketplaceRoot(root, definition = pluginDefinition) {
   if (codexShape === "invalid") {
     throw new Error(`Codex local marketplace manifest is not owned by ${MARKETPLACE_ID}: ${root}`);
   }
-  if (JSON.stringify(claude) !== JSON.stringify(claudeMarketplace(definition))) {
+  if (!copilotProfile && JSON.stringify(claude) !== JSON.stringify(claudeMarketplace(definition))) {
     throw new Error(`Claude local marketplace manifest is not owned by ${MARKETPLACE_ID}: ${root}`);
   }
+  if (copilotProfile && JSON.stringify(copilot) !== JSON.stringify(copilotMarketplace(definition))) {
+    throw new Error(`Copilot local marketplace manifest is not owned by ${MARKETPLACE_ID}: ${root}`);
+  }
   return Object.freeze({ codexShape });
 }
 
-function classifyExistingMarketplace(stableRoot, marker) {
+function classifyExistingMarketplace(stableRoot, marker, { profileId = "runtime-plugin" } = {}) {
   const existingPluginRoot = join(stableRoot, "plugins", MARKETPLACE_ID);
-  const existingCodexInstallVersion = marker.codex_install_version ?? marker.version;
+  const copilotProfile = profileId === "copilot-runtime-plugin";
+  const existingCodexInstallVersion = copilotProfile ? marker.version : marker.codex_install_version ?? marker.version;
   if (!isSemanticVersion(marker.version)
       || !/^[a-f0-9]{64}$/.test(marker.plugin_digest ?? "")) {
     throw new Error(`Refusing invalid AGDF marketplace ownership evidence: ${stableRoot}`);
@@ -238,7 +275,7 @@ function classifyExistingMarketplace(stableRoot, marker) {
     "built plugin definition",
   );
   const hasCurrentProvenance = existsSync(join(existingPluginRoot, INSTALLATION_PROVENANCE_FILE));
-  const hasLegacyProvenance = existsSync(join(existingPluginRoot, LEGACY_LOCAL_INSTALL_FILE));
+  const hasLegacyProvenance = !copilotProfile && existsSync(join(existingPluginRoot, LEGACY_LOCAL_INSTALL_FILE));
   const preProvenanceCandidate = !hasCurrentProvenance
     && !hasLegacyProvenance
     && !Object.hasOwn(definition, "distributionProfiles");
@@ -249,9 +286,9 @@ function classifyExistingMarketplace(stableRoot, marker) {
     marker.source_digest ?? "",
     preProvenanceCandidate
       ? { allowPreProvenanceShape: true }
-      : { requireInstallationProvenance: true, allowLegacyProvenanceForMigration: true },
+      : { requireInstallationProvenance: true, allowLegacyProvenanceForMigration: true, profileId },
   );
-  const marketplace = validateMarketplaceRoot(stableRoot, existingDefinition);
+  const marketplace = validateMarketplaceRoot(stableRoot, existingDefinition, { profileId });
   if (digestDirectory(existingPluginRoot) !== marker.plugin_digest) {
     throw new Error(`Refusing tampered AGDF marketplace root: ${stableRoot}`);
   }
@@ -287,25 +324,30 @@ function recoverInterruptedTransaction(stableRoot, stageRoot, backupRoot, failed
 
 export function prepareLocalMarketplace({
   dataRoot = defaultAgdfDataRoot(),
-  builtPluginRoot = join(generatedRoot, "plugins", "agdf"),
+  builtPluginRoot,
   expectedVersion = pluginDefinition.version,
   codexInstallVersion = expectedVersion,
   codexRegistrationRevision = null,
+  profileId = "runtime-plugin",
 } = {}) {
   dataRoot = resolve(dataRoot);
+  const copilotProfile = profileId === "copilot-runtime-plugin";
+  if (!builtPluginRoot) builtPluginRoot = copilotProfile
+    ? join(generatedRoot, "plugins", "copilot", "agdf")
+    : join(generatedRoot, "plugins", "agdf");
   builtPluginRoot = resolve(builtPluginRoot);
-  const stableRoot = join(dataRoot, "marketplaces", MARKETPLACE_ID);
+  const stableRoot = join(dataRoot, "marketplaces", copilotProfile ? "agdf-copilot" : MARKETPLACE_ID);
   const parent = dirname(stableRoot);
   const stageRoot = `${stableRoot}.stage`;
   const backupRoot = `${stableRoot}.backup`;
   const failedRoot = `${stableRoot}.failed`;
   if (!pathInside(dataRoot, stableRoot) || dirname(stableRoot) !== parent) throw new Error(`Unsafe AGDF marketplace root: ${stableRoot}`);
   const sourceDigest = digestPluginSource(builtPluginRoot, expectedVersion);
-  if (codexInstallVersion !== expectedVersion
+  if (!copilotProfile && codexInstallVersion !== expectedVersion
       && !isCodexLocalInstallVersion(expectedVersion, codexInstallVersion, sourceDigest)) {
     throw new Error(`Invalid AGDF Codex local install version: ${codexInstallVersion}`);
   }
-  const targetDefinition = validateBuiltPlugin(builtPluginRoot, expectedVersion);
+  const targetDefinition = validateBuiltPlugin(builtPluginRoot, expectedVersion, expectedVersion, "", { profileId });
   mkdirSync(parent, { recursive: true });
   recoverInterruptedTransaction(stableRoot, stageRoot, backupRoot, failedRoot);
 
@@ -313,6 +355,7 @@ export function prepareLocalMarketplace({
   if (existsSync(stableRoot)) {
     try {
       existing = ownership(stableRoot);
+      if ((existing.profile_id ?? "runtime-plugin") !== profileId) throw new Error(`AGDF marketplace profile mismatch: ${stableRoot}`);
     } catch (error) {
       throw invalidExistingMarketplace(error);
     }
@@ -325,7 +368,7 @@ export function prepareLocalMarketplace({
   if (existing) {
     let classified;
     try {
-      classified = classifyExistingMarketplace(stableRoot, existing);
+      classified = classifyExistingMarketplace(stableRoot, existing, { profileId });
     } catch (error) {
       throw invalidExistingMarketplace(error);
     }
@@ -338,6 +381,7 @@ export function prepareLocalMarketplace({
       schema_version: 1,
       owner: "create-agdf",
       marketplace_id: MARKETPLACE_ID,
+      profile_id: profileId,
       codex_registration_revision: targetCodexRegistrationRevision,
       version: expectedVersion,
       codex_install_version: codexInstallVersion,
@@ -348,8 +392,8 @@ export function prepareLocalMarketplace({
     });
     const stagedPluginRoot = join(stageRoot, "plugins", MARKETPLACE_ID);
     cpSync(builtPluginRoot, stagedPluginRoot, { recursive: true });
-    validateBuiltPlugin(stagedPluginRoot, expectedVersion);
-    if (codexInstallVersion !== expectedVersion) {
+    validateBuiltPlugin(stagedPluginRoot, expectedVersion, expectedVersion, "", { profileId });
+    if (!copilotProfile && codexInstallVersion !== expectedVersion) {
       const codexManifestPath = join(stagedPluginRoot, ".codex-plugin", "plugin.json");
       writeJson(codexManifestPath, { ...readJson(codexManifestPath, "built Codex plugin manifest"), version: codexInstallVersion });
     }
@@ -357,25 +401,31 @@ export function prepareLocalMarketplace({
     writeJson(join(stagedPluginRoot, INSTALLATION_PROVENANCE_FILE), {
       schema_version: 1,
       owner: "create-agdf",
-      profile_id: "runtime-plugin",
+      profile_id: profileId,
       marketplace_id: MARKETPLACE_ID,
       canonical_version: expectedVersion,
       codex_install_version: codexInstallVersion,
       source_digest: sourceDigest,
       runtime_digest: runtimeManifest.digest,
+      ...(copilotProfile ? { inventory_digest: inspectCopilotPayloadInventory(stagedPluginRoot, expectedVersion).inventoryDigest } : {}),
     });
     if (existsSync(join(stagedPluginRoot, LEGACY_LOCAL_INSTALL_FILE))) {
       rmSync(join(stagedPluginRoot, LEGACY_LOCAL_INSTALL_FILE));
     }
-    validateBuiltPlugin(stagedPluginRoot, expectedVersion, codexInstallVersion, sourceDigest, { requireInstallationProvenance: true });
-    writeJson(join(stageRoot, ".agents", "plugins", "marketplace.json"), codexMarketplace(targetDefinition));
-    writeJson(join(stageRoot, ".claude-plugin", "marketplace.json"), claudeMarketplace(targetDefinition));
-    validateMarketplaceRoot(stageRoot, targetDefinition);
+    validateBuiltPlugin(stagedPluginRoot, expectedVersion, copilotProfile ? expectedVersion : codexInstallVersion, sourceDigest, { requireInstallationProvenance: true, profileId });
+    if (copilotProfile) {
+      writeJson(join(stageRoot, ".github", "plugin", "marketplace.json"), copilotMarketplace(targetDefinition));
+    } else {
+      writeJson(join(stageRoot, ".agents", "plugins", "marketplace.json"), codexMarketplace(targetDefinition));
+      writeJson(join(stageRoot, ".claude-plugin", "marketplace.json"), claudeMarketplace(targetDefinition));
+    }
+    validateMarketplaceRoot(stageRoot, targetDefinition, { profileId });
     const pluginDigest = digestDirectory(stagedPluginRoot);
     const marker = {
       schema_version: 1,
       owner: "create-agdf",
       marketplace_id: MARKETPLACE_ID,
+      profile_id: profileId,
       codex_registration_revision: targetCodexRegistrationRevision,
       version: expectedVersion,
       codex_install_version: codexInstallVersion,
@@ -448,6 +498,10 @@ export function prepareLocalMarketplace({
   }
 }
 
+export function prepareCopilotMarketplace(options = {}) {
+  return prepareLocalMarketplace({ ...options, profileId: "copilot-runtime-plugin", codexInstallVersion: options.expectedVersion ?? pluginDefinition.version });
+}
+
 export function inspectLocalMarketplaceProjection({
   dataRoot = defaultAgdfDataRoot(),
   expectedVersion = pluginDefinition.version,
@@ -478,6 +532,34 @@ export function inspectLocalMarketplaceProjection({
   });
 }
 
+export function inspectOwnedSharedMarketplaceForCopilotMigration({
+  dataRoot = defaultAgdfDataRoot(),
+  expectedVersion = pluginDefinition.version,
+} = {}) {
+  const root = join(resolve(dataRoot), "marketplaces", MARKETPLACE_ID);
+  if (!existsSync(root)) return null;
+  const marker = ownership(root);
+  if ((marker.profile_id ?? "runtime-plugin") !== "runtime-plugin"
+      || marker.version !== expectedVersion
+      || !/^[a-f0-9]{64}$/.test(marker.plugin_digest ?? "")) {
+    throw new Error(`Refusing incompatible AGDF shared marketplace migration source: ${root}`);
+  }
+  const pluginRoot = join(root, "plugins", MARKETPLACE_ID);
+  const definition = readJson(join(pluginRoot, "meta", "agdf-plugin.definition.json"), "shared plugin definition");
+  const runtime = readJson(join(pluginRoot, "runtime", "runtime-manifest.json"), "shared runtime manifest");
+  const codex = readJson(join(pluginRoot, ".codex-plugin", "plugin.json"), "shared Codex manifest");
+  const claude = readJson(join(pluginRoot, ".claude-plugin", "plugin.json"), "shared Claude manifest");
+  if (definition.id !== MARKETPLACE_ID
+      || definition.version !== expectedVersion
+      || runtime.version !== expectedVersion
+      || claude.version !== expectedVersion
+      || (codex.version !== expectedVersion && !isCodexLocalInstallVersion(expectedVersion, codex.version))
+      || digestDirectory(pluginRoot) !== marker.plugin_digest) {
+    throw new Error(`Refusing stale or tampered AGDF shared marketplace migration source: ${root}`);
+  }
+  return Object.freeze({ root, pluginRoot, version: marker.version, digest: marker.plugin_digest });
+}
+
 function normalizedLegacySource(value) {
   if (typeof value !== "string") return "";
   return value.trim().toLowerCase()

package/lib/installers/plugin-installers.js

@@ -1,6 +1,12 @@
 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 { CODEX_REGISTRATION_REVISION, classifyMarketplaceList, inspectLocalMarketplaceProjection, isCodexLocalInstallVersion, prepareLocalMarketplace } from "./local-marketplace.js";
+import { digestNormalizedPluginSource } from "../runtime/plugin-provenance.js";
+import { CODEX_REGISTRATION_REVISION, classifyMarketplaceList, inspectLocalMarketplaceProjection, inspectOwnedSharedMarketplaceForCopilotMigration, isCodexLocalInstallVersion, prepareCopilotMarketplace, 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;
@@ -93,6 +99,178 @@ export function installClaudeGlobalPlugin({ exec = execFileSync, prepare = prepa
   }
 }
 
+export function installCopilotGlobalPlugin({ exec = execFileSync, packagedCopilotExec = execFileSync, prepare = prepareCopilotMarketplace, 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 legacySharedProjection = null;
+  if (transaction) {
+    try { legacySharedProjection = inspectOwnedSharedMarketplaceForCopilotMigration({ ...(dataRoot ? { dataRoot } : {}), expectedVersion }); } catch {}
+  }
+  let marketplaceAdded = false;
+  let legacyMarketplaceRemoved = false;
+  let marketplacePluginRemoved = 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, "..", ".."),
+      { ownedLegacyRoots: legacySharedProjection ? [legacySharedProjection.root] : [] },
+    );
+    if (marketplace.state === "conflict") {
+      throw lifecycleAdapterError("marketplace", `Refusing to replace non-AGDF Copilot marketplace registration agdf (${marketplace.source || "unknown source"}).`);
+    }
+    if (marketplace.state === "owned_legacy_shared") {
+      if (marketplaceInstalled) {
+        nativeOutput.push(runPluginPhase(activeExec, "copilot", ["plugin", "uninstall", "agdf@agdf"], "plugin_operation", captureOptions()));
+        marketplacePluginRemoved = true;
+      }
+      nativeOutput.push(runPluginPhase(activeExec, "copilot", ["plugin", "marketplace", "remove", "agdf"], "marketplace", captureOptions()));
+      legacyMarketplaceRemoved = true;
+    }
+    if (["absent", "owned_legacy_shared"].includes(marketplace.state)) {
+      nativeOutput.push(runPluginPhase(activeExec, "copilot", ["plugin", "marketplace", "add", transaction?.root ?? resolve(effectivePluginRoot, "..", "..")], "marketplace", captureOptions()));
+      marketplaceAdded = true;
+    }
+    if (marketplace.state === "owned_local_current" && marketplaceInstalled) {
+      nativeOutput.push(runPluginPhase(activeExec, "copilot", ["plugin", "uninstall", "agdf@agdf"], "plugin_operation", captureOptions()));
+      marketplacePluginRemoved = 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"]), ...(legacyMarketplaceRemoved ? ["shared_marketplace_registration_migrated"] : []), ...(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) };
+      }
+    }
+    if (legacyMarketplaceRemoved && legacySharedProjection) {
+      try {
+        activeExec("copilot", ["plugin", "marketplace", "add", legacySharedProjection.root], captureOptions());
+        if (marketplacePluginRemoved) activeExec("copilot", ["plugin", "install", "agdf@agdf"], captureOptions());
+      } catch (recoveryError) {
+        error.evidence = { ...(error.evidence ?? {}), legacy_marketplace_recovery: commandErrorText(recoveryError) };
+      }
+    } else if (marketplacePluginRemoved) {
+      try {
+        activeExec("copilot", ["plugin", "install", "agdf@agdf"], captureOptions());
+      } catch (recoveryError) {
+        error.evidence = { ...(error.evidence ?? {}), marketplace_plugin_recovery: commandErrorText(recoveryError) };
+      }
+    }
+    throw error;
+  }
+}
+
+export function classifyCopilotMarketplaceList(output, expectedRoot, { ownedLegacyRoots = [] } = {}) {
+  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() };
+  if (resolve(local[1]) === resolve(expectedRoot)) return { state: "owned_local_current", source: local[1] };
+  if (ownedLegacyRoots.some((root) => resolve(root) === resolve(local[1]))) return { state: "owned_legacy_shared", source: local[1] };
+  return { 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 +354,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 +405,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.",
 });
 

package/lib/lifecycle/status.js

@@ -63,7 +63,7 @@ function inspectInstallation(surface, targetDir, options, deps, exec) {
       evidence: [report.global_config.path],
     };
   }
-  if (["codex", "claude"].includes(surface)) return deps.inspectPluginSurface(surface, exec);
+  if (["codex", "claude", "copilot"].includes(surface)) return deps.inspectPluginSurface(surface, exec);
   return { status: "unknown", surface, version: null, evidence: [`unsupported_status_probe:${surface}`] };
 }
 
@@ -79,7 +79,7 @@ export function evaluateGeneralStatus(targetDir, options = {}, dependencies = {}
   if (surface) {
     installation = inspectInstallation(surface, targetDir, options, deps, dependencies.exec);
   } else {
-    const probes = ["codex", "claude", "opencode"].map((candidate) => inspectInstallation(candidate, targetDir, options, deps, dependencies.exec));
+    const probes = ["codex", "claude", "copilot", "opencode"].map((candidate) => inspectInstallation(candidate, targetDir, options, deps, dependencies.exec));
     const observed = probes.filter((probe) => ["healthy", "degraded"].includes(probe.status));
     if (observed.length === 1) {
       installation = observed[0];
@@ -96,7 +96,7 @@ export function evaluateGeneralStatus(targetDir, options = {}, dependencies = {}
   }
   const repository = repositoryStatus(targetDir, surface);
   const delivery = deliveryStatus(targetDir, { runId: options.runId }, deps);
-  const runtimeChecks = ["codex", "claude", "opencode"].includes(surface)
+  const runtimeChecks = ["codex", "claude", "copilot", "opencode"].includes(surface)
     ? runtimeCheckStatus(options.dataRoot, surface)
     : { requested: "unknown", effective: "unavailable", reason: "unsupported_host_capability" };
   const nextText = surface === "multiple"