@c4a/context-cli 0.6.8 → 0.6.9

package/cli.js

@@ -17554,7 +17554,7 @@ async function recordAgentGraphEvaluation(input) {
     ...input.route === undefined ? {} : { routeId: input.route.id, node: input.route.node, reasonCode: input.route.reasonCode }
   };
   await appendEvent(input.projectRoot, "agent-graph.evaluated", {
-    graph: { provider: "c4a/context", graph: "workspace", entry: "continue" },
+    graph: { provider: "c4a/context", graph: "workspace", entry: "context" },
     current: current2,
     ...input.route === undefined ? {} : { selected_route: input.route },
     alternatives: input.alternatives
@@ -24130,7 +24130,7 @@ var require_lib = __commonJS((exports, module) => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync46, readFileSync as readFileSync10, realpathSync } from "node:fs";
+import { existsSync as existsSync47, readFileSync as readFileSync10, realpathSync } from "node:fs";
 import { dirname as dirname42, join as join71 } from "node:path";
 import { fileURLToPath as fileURLToPath10, pathToFileURL as pathToFileURL4 } from "node:url";
 
@@ -24162,7 +24162,7 @@ init_exitCode();
 // src/project/workflow/workflowTypes.ts
 var CONTEXT_WORKFLOW_PROVIDER_ID = "c4a/context";
 var CONTEXT_WORKFLOW_GRAPH_ID = "workspace";
-var CONTEXT_WORKFLOW_ENTRY = "continue";
+var CONTEXT_WORKFLOW_ENTRY = "context";
 var CONTEXT_WORKFLOW_AUTHORITIES = {
   evidenceMaintenance: "context.evidence-maintenance",
   repositoryRestore: "context.repository-restore",
@@ -24198,7 +24198,7 @@ function mergedWorkflowAuthorities(...values) {
 // src/project/workflow/workflowResource.ts
 import { join as join57 } from "node:path";
 
-// ../../node_modules/.bun/@c4a+agent-graph@0.2.5/node_modules/@c4a/agent-graph/dist/index.js
+// ../../node_modules/.bun/@c4a+agent-graph@0.2.6/node_modules/@c4a/agent-graph/dist/index.js
 import { createRequire as createRequire2 } from "node:module";
 import { createHash } from "node:crypto";
 import { mkdir, readFile, readdir, realpath, rename, stat, writeFile } from "node:fs/promises";
@@ -38749,6 +38749,15 @@ var graph_schema_default = {
         },
         inspectionAction: { $ref: "#/$defs/relativePath" },
         resolutionAction: { $ref: "#/$defs/relativePath" },
+        delegated: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            inspection: { enum: ["required", "skip"], default: "required" },
+            resolutionAction: { $ref: "#/$defs/relativePath" },
+            resources: { $ref: "#/$defs/resources" }
+          }
+        },
         terminalOutcome: { $ref: "#/$defs/outcome" },
         requiresFacts: { type: "array", items: { $ref: "#/$defs/factCheck" } },
         satisfiedBy: { type: "array", minItems: 1, items: { $ref: "#/$defs/factCheck" } },
@@ -38758,7 +38767,7 @@ var graph_schema_default = {
         {
           properties: { kind: { const: "action" } },
           required: ["action", "reasonCode"],
-          not: { anyOf: [{ required: ["graph"] }, { required: ["entry"] }, { required: ["gate"] }, { required: ["inspectionAction"] }, { required: ["resolutionAction"] }, { required: ["terminalOutcome"] }] }
+          not: { anyOf: [{ required: ["graph"] }, { required: ["entry"] }, { required: ["gate"] }, { required: ["inspectionAction"] }, { required: ["resolutionAction"] }, { required: ["delegated"] }, { required: ["terminalOutcome"] }] }
         },
         {
           properties: { kind: { const: "gate" } },
@@ -38768,12 +38777,12 @@ var graph_schema_default = {
         {
           properties: { kind: { const: "subgraph" } },
           required: ["graph", "entry"],
-          not: { anyOf: [{ required: ["action"] }, { required: ["gate"] }, { required: ["inspectionAction"] }, { required: ["resolutionAction"] }, { required: ["reasonCode"] }, { required: ["terminalOutcome"] }, { required: ["satisfiedBy"] }, { required: ["resources"] }] }
+          not: { anyOf: [{ required: ["action"] }, { required: ["gate"] }, { required: ["inspectionAction"] }, { required: ["resolutionAction"] }, { required: ["delegated"] }, { required: ["reasonCode"] }, { required: ["terminalOutcome"] }, { required: ["satisfiedBy"] }, { required: ["resources"] }] }
         },
         {
           properties: { kind: { const: "terminal" } },
           required: ["terminalOutcome"],
-          not: { anyOf: [{ required: ["action"] }, { required: ["graph"] }, { required: ["entry"] }, { required: ["gate"] }, { required: ["inspectionAction"] }, { required: ["resolutionAction"] }, { required: ["reasonCode"] }, { required: ["satisfiedBy"] }, { required: ["resources"] }] }
+          not: { anyOf: [{ required: ["action"] }, { required: ["graph"] }, { required: ["entry"] }, { required: ["gate"] }, { required: ["inspectionAction"] }, { required: ["resolutionAction"] }, { required: ["delegated"] }, { required: ["reasonCode"] }, { required: ["satisfiedBy"] }, { required: ["resources"] }] }
         }
       ]
     },
@@ -39854,6 +39863,20 @@ async function loadProvider(manifestPath) {
           throw new AgentGraphError("gate-inspection-effect-invalid", `Gate ${graphId}/${node.id} inspection Action ${inspection.definition.id} must use effect: read`);
         }
       }
+      if (node.kind === "gate" && node.delegated !== undefined) {
+        if (node.gate.delegatable !== true || node.gate.authority === undefined) {
+          throw new AgentGraphError("gate-delegated-policy-invalid", `Gate ${graphId}/${node.id} declares delegated execution without a delegatable authority`);
+        }
+        if (node.delegated.inspection === "skip" && node.inspectionAction === undefined) {
+          throw new AgentGraphError("gate-delegated-inspection-missing", `Gate ${graphId}/${node.id} skips delegated inspection but has no inspection Action`);
+        }
+        if (node.delegated.resolutionAction !== undefined) {
+          const delegatedResolution = await includeAction(node.delegated.resolutionAction, directFiles, "delegated gate resolution action referenced file");
+          if (delegatedResolution.definition.effect === "read") {
+            throw new AgentGraphError("gate-resolution-effect-invalid", `Gate ${graphId}/${node.id} delegated resolution Action ${delegatedResolution.definition.id} must use effect: write or external`);
+          }
+        }
+      }
       if (node.kind === "gate" && node.resolutionAction) {
         const resolution = await includeAction(node.resolutionAction, directFiles, "gate resolution action referenced file");
         if (resolution.definition.effect === "read") {
@@ -39861,9 +39884,12 @@ async function loadProvider(manifestPath) {
         }
       }
       const nodeResources = node.kind === "action" || node.kind === "gate" ? node.resources : undefined;
+      const delegatedResources = node.kind === "gate" ? node.delegated?.resources : undefined;
       for (const resourceReference of [
         ...nodeResources?.required ?? [],
-        ...nodeResources?.recommended ?? []
+        ...nodeResources?.recommended ?? [],
+        ...delegatedResources?.required ?? [],
+        ...delegatedResources?.recommended ?? []
       ]) {
         const resourcePath = resolveContainedPath(root, resourceReference, "resource reference");
         if (!resources.has(resourcePath)) {
@@ -40113,8 +40139,9 @@ async function locateCode(provider, code) {
   };
 }
 async function resourcesForCandidate(provider, candidate, revision) {
-  const requiredReferences = [...candidate.node.resources?.required ?? []];
-  const recommendedReferences = [...candidate.node.resources?.recommended ?? []];
+  const selectedResources = candidate.node.kind === "gate" && candidate.gateResolution === "session-authority" && candidate.node.delegated?.resources !== undefined ? candidate.node.delegated.resources : candidate.node.resources;
+  const requiredReferences = [...selectedResources?.required ?? []];
+  const recommendedReferences = [...selectedResources?.recommended ?? []];
   const action = candidate.node.kind === "action" ? referencedAction(provider, candidate.node.action) : undefined;
   const required = await Promise.all(requiredReferences.map((reference) => locateResource(provider, reference, revision)));
   const recommended = await Promise.all(recommendedReferences.map((reference) => locateResource(provider, reference, revision)));
@@ -40179,8 +40206,8 @@ async function resolveRoute(provider, graphId, entry2, routeId2, input = {}, exp
     recommended: annotateReadState(locatedResources.recommended, input.resourceReceipts)
   };
   const action = candidate.node.kind === "action" ? referencedAction(provider, candidate.node.action) : undefined;
-  const inspectionAction = candidate.node.kind === "gate" ? referencedAction(provider, candidate.node.inspectionAction) : undefined;
-  const resolutionAction = candidate.node.kind === "gate" ? referencedAction(provider, candidate.node.resolutionAction) : undefined;
+  const inspectionAction = candidate.node.kind === "gate" && !(candidate.gateResolution === "session-authority" && candidate.node.delegated?.inspection === "skip") ? referencedAction(provider, candidate.node.inspectionAction) : undefined;
+  const resolutionAction = candidate.node.kind === "gate" ? referencedAction(provider, candidate.gateResolution === "session-authority" && candidate.node.delegated?.resolutionAction !== undefined ? candidate.node.delegated.resolutionAction : candidate.node.resolutionAction) : undefined;
   const workspace = input.workspace ?? process.cwd();
   return {
     schema: "agent-graph.route.v1",
@@ -69148,6 +69175,7 @@ var RUNTIME_EVENT_STATE_SCHEMA = "context.runtime-event-state.v1";
 var RUNTIME_EVENT_STATE_FILE = "runtime-event-state.json";
 var RUNTIME_EVENT_SINK_DESCRIPTION_TIMEOUT_MS = 2000;
 var RUNTIME_EVENT_SINK_DESCRIPTION_MAX_BYTES = 16 * 1024;
+var RUNTIME_EVENTS_DISABLED_ENV = "CONTEXT_RUNTIME_EVENTS_DISABLED";
 var activeScope;
 function isRecord9(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -69256,7 +69284,7 @@ function readRuntimePackageMetadata() {
         if (isRecord9(parsed)) {
           return {
             contextVersion: typeof parsed.version === "string" ? parsed.version : "unknown",
-            sink: parseContextRuntimeEventSink(parsed.contextRuntimeEventSink)
+            sink: process.env[RUNTIME_EVENTS_DISABLED_ENV] === "1" ? null : parseContextRuntimeEventSink(parsed.contextRuntimeEventSink)
           };
         }
       }
@@ -87881,17 +87909,17 @@ function createContextWorkflowFacts(observation, authorities) {
       source_read_resolved: captureComplete || hasAuthority(authorities, CONTEXT_WORKFLOW_AUTHORITIES.sourceRead),
       extraction_scope_resolved: extractDeclarationsComplete,
       document_classification_resolved: documentsClassified,
-      structure_confirmation_resolved: structureConfirmed || hasAuthority(authorities, CONTEXT_WORKFLOW_AUTHORITIES.structureConfirmation),
-      knowledge_review_resolved: reviewGateIsClear || hasAuthority(authorities, CONTEXT_WORKFLOW_AUTHORITIES.knowledgeReview),
+      structure_confirmation_resolved: structureConfirmed,
+      knowledge_review_resolved: reviewGateIsClear,
       package_output_resolved: packagesDeclared || hasAuthority(authorities, CONTEXT_WORKFLOW_AUTHORITIES.packageOutput)
     },
     resume: {
       prose_declarations_complete: !captureComplete || !documentRoundStarted || activeRoundProseComplete,
       ...structureRefreshRequired ? { structure_refresh_required: true } : {},
-      structure_confirmation_resolved: !captureComplete || !documentRoundStarted || structureConfirmed || hasAuthority(authorities, CONTEXT_WORKFLOW_AUTHORITIES.structureConfirmation),
+      structure_confirmation_resolved: !captureComplete || !documentRoundStarted || structureConfirmed,
       structure_confirmed: !captureComplete || !documentRoundStarted || structureConfirmed,
       compile_complete: !captureComplete || !documentRoundStarted || compiled,
-      knowledge_review_resolved: !captureComplete || !documentRoundStarted || reviewGateIsClear || hasAuthority(authorities, CONTEXT_WORKFLOW_AUTHORITIES.knowledgeReview),
+      knowledge_review_resolved: !captureComplete || !documentRoundStarted || reviewGateIsClear,
       review_gate_clear: !captureComplete || !documentRoundStarted || reviewGateIsClear
     },
     sources: {
@@ -88927,11 +88955,12 @@ function withContentAddressedWorkflowResources(status, receipts) {
 
 // src/project/workflow/workflowStatusProjection.ts
 function pendingReview(observation, route) {
-  const decisionSource = route?.reason_code === "route.review.apply-managed" ? "managed-session" : route?.gate?.id === "knowledge-review" ? "user-review" : undefined;
+  const decisionSource = route?.gate?.id === "knowledge-review" ? route.gate.resolution === "session-authority" ? "managed-session" : "user-review" : route?.reason_code === "route.review.apply-managed" ? "managed-session" : undefined;
   if (decisionSource === undefined || observation.draftCandidates <= 0 || observation.draftCollections.length === 0) {
     return;
   }
   const collections = [...observation.draftCollections];
+  const managedCommand = decisionSource === "managed-session" ? route?.commands.find((item) => item.availability === "immediate" && item.effect === "write")?.command : undefined;
   if (collections.length === 1) {
     const collection = collections[0];
     return {
@@ -88939,7 +88968,7 @@ function pendingReview(observation, route) {
       collections,
       collection,
       count: observation.draftCandidates,
-      command: `context review html ${collection} --open`,
+      command: managedCommand ?? `context review html ${collection} --open`,
       decisionSource,
       ...observation.candidateSetDigest === undefined ? {} : { candidateSetDigest: observation.candidateSetDigest }
     };
@@ -88948,7 +88977,7 @@ function pendingReview(observation, route) {
     scope: "all",
     collections,
     count: observation.draftCandidates,
-    command: "context review html --all --open",
+    command: managedCommand ?? "context review html --all --open",
     decisionSource,
     ...observation.candidateSetDigest === undefined ? {} : { candidateSetDigest: observation.candidateSetDigest }
   };
@@ -106258,6 +106287,153 @@ init_cliFeedback();
 init_errors();
 init_workspace();
 init_exitCode();
+
+// src/project/entryCommand.ts
+init_workspace();
+import { existsSync as existsSync45 } from "node:fs";
+import { resolve as resolve30 } from "node:path";
+function shellQuote9(value) {
+  return /^[A-Za-z0-9._/=-]+$/u.test(value) ? value : `'${value.replaceAll("'", `'"'"'`)}'`;
+}
+function workflowCommand(input) {
+  const authorities = input.authorities ?? [];
+  if (input.managed === true) {
+    return [
+      "context run --managed --until blocked-or-complete --format json",
+      ...authorities.map((authority) => `--authority ${shellQuote9(authority)}`)
+    ].join(" ");
+  }
+  return [
+    "context status --format json",
+    ...authorities.map((authority) => `--authority ${shellQuote9(authority)}`)
+  ].join(" ");
+}
+function initCommand2(input, projectDir) {
+  const args = [
+    "context",
+    "init",
+    projectDir,
+    "--language",
+    input.language
+  ];
+  if (input.name !== undefined)
+    args.push("--name", input.name);
+  if (input.dev === true)
+    args.push("--dev");
+  if (input.debug === true)
+    args.push("--debug");
+  return args.map(shellQuote9).join(" ");
+}
+function readyResult(input, projectRoot, relocation) {
+  const command2 = workflowCommand(input);
+  return {
+    schema: "context.entry.v1",
+    state: relocation ? "workspace-relocation-required" : "workspace-ready",
+    cwd: resolve30(input.cwd),
+    workspace: {
+      root: projectRoot,
+      exists: true
+    },
+    next_action: {
+      kind: relocation ? "enter-workspace" : "evaluate-workflow",
+      command: relocation ? `cd ${shellQuote9(projectRoot)} && ${command2}` : command2,
+      effect: "read",
+      confirmation: "not-required"
+    }
+  };
+}
+function resolveContextEntry(input) {
+  const cwd = resolve30(input.cwd);
+  if (input.projectDir !== undefined) {
+    const target2 = resolveContextProjectInitTarget(cwd, input.projectDir);
+    if (existsSync45(target2) && isContextProjectRoot(target2)) {
+      return readyResult(input, target2, target2 !== cwd);
+    }
+    return {
+      schema: "context.entry.v1",
+      state: "workspace-initialization-required",
+      cwd,
+      workspace: {
+        root: target2,
+        exists: existsSync45(target2)
+      },
+      next_action: {
+        kind: "initialize-workspace",
+        command: initCommand2(input, input.projectDir),
+        effect: "write",
+        confirmation: "required-unless-explicitly-requested"
+      }
+    };
+  }
+  const found = findContextProjectRoot(cwd);
+  if (found !== null)
+    return readyResult(input, found.projectRoot, false);
+  const expectation = findContextWorkspaceExpectation(cwd);
+  if (expectation !== null) {
+    if (expectation.exists && isContextProjectRoot(expectation.workspaceRoot)) {
+      return readyResult(input, expectation.workspaceRoot, true);
+    }
+    return {
+      schema: "context.entry.v1",
+      state: "workspace-initialization-required",
+      cwd,
+      workspace: {
+        root: expectation.workspaceRoot,
+        exists: expectation.exists
+      },
+      next_action: {
+        kind: "initialize-workspace",
+        command: `cd ${shellQuote9(expectation.markerRoot)} && ${initCommand2(input, expectation.workspaceDir)}`,
+        effect: "write",
+        confirmation: "required-unless-explicitly-requested"
+      }
+    };
+  }
+  const target = resolveContextProjectInitTarget(cwd, undefined);
+  if (isContextProjectRoot(target)) {
+    return readyResult(input, target, true);
+  }
+  return {
+    schema: "context.entry.v1",
+    state: "workspace-initialization-required",
+    cwd,
+    workspace: {
+      root: target,
+      exists: existsSync45(target)
+    },
+    next_action: {
+      kind: "initialize-workspace",
+      command: initCommand2(input, "context"),
+      effect: "write",
+      confirmation: "required-unless-explicitly-requested"
+    }
+  };
+}
+function formatContextEntry(result) {
+  return `${JSON.stringify(result, null, 2)}
+`;
+}
+
+// src/registerProjectLifecycleCommands.ts
+function registerProjectEntryCommand(program2) {
+  program2.command("entry [project-dir]").description("Resolve the single Context agent entry for initialization or workflow evaluation").option("--name <name>", "display/package name override when initialization is required").option("--language <language>", "workspace and starter-template language: en | zh-CN", "en").option("--dev", "plan initialization with the locally linked @c4a/context SDK").option("--debug", "plan initialization with workspace-local tracing enabled").option("--managed", "use explicit current-conversation managed approval for workflow evaluation").addOption(new Option("--authority <authority>", "current-conversation scoped authority granted by the user; repeatable").argParser(collectWorkflowAuthorityOption).default([])).option("--format <format>", "output format: json", "json").action((projectDir, options) => {
+    if (options.format !== "json") {
+      throw new ContextError(ExitCode.UserError, "--format must be json", {
+        category: ErrorCategory.UserInputInvalid
+      });
+    }
+    process.stdout.write(formatContextEntry(resolveContextEntry({
+      cwd: process.cwd(),
+      ...projectDir === undefined ? {} : { projectDir },
+      ...typeof options.name === "string" ? { name: options.name } : {},
+      language: projectLanguage(options.language),
+      ...options.dev === true ? { dev: true } : {},
+      ...options.debug === true ? { debug: true } : {},
+      ...options.managed === true ? { managed: true } : {},
+      authorities: workflowAuthorities(options.authority)
+    })));
+  });
+}
 function registerProjectInitCommand(program2) {
   program2.command("init [project-dir]").description("Initialize a project-local context workspace").option("--name <name>", "display/package name override").option("--language <language>", "workspace and starter-template language: en | zh-CN").option("--dev", "initialize with the locally linked @c4a/context SDK").option("--debug", "enable workspace-local command and Agent Graph tracing").option("--allow-nonempty", "after explicit confirmation, preserve existing files and initialize inside a non-empty non-Context directory").action(async (projectDir, options) => {
     const targetRoot = resolveContextProjectInitTarget(process.cwd(), projectDir);
@@ -106385,29 +106561,29 @@ function registerProjectVerifyCommand(program2) {
 init_cliFeedback();
 init_errors();
 init_exitCode();
-import { existsSync as existsSync45 } from "node:fs";
+import { existsSync as existsSync46 } from "node:fs";
 import { cp, mkdir as mkdir32, readdir as readdir21, readFile as readFile55, rename as rename5, rm as rm19, writeFile as writeFile27 } from "node:fs/promises";
 import { execFile as execFile7 } from "node:child_process";
 import { homedir as homedir2 } from "node:os";
-import { dirname as dirname41, join as join70, resolve as resolve30 } from "node:path";
+import { dirname as dirname41, join as join70, resolve as resolve31 } from "node:path";
 import { fileURLToPath as fileURLToPath9 } from "node:url";
 import { promisify as promisify7 } from "node:util";
 var execFileAsync7 = promisify7(execFile7);
 var MARKETPLACE_NAME = "c4a";
-var PLUGIN_ID = "context@c4a";
-var PLUGIN_NAME = "context";
-var LEGACY_PLUGIN_NAMES = [];
+var PLUGIN_ID = "c4a@c4a";
+var PLUGIN_NAME = "c4a";
+var LEGACY_PLUGIN_NAMES = ["context"];
 var ORPHAN_MARKER2 = ".orphaned_at";
 var CLAUDE_PLUGIN_CACHE_ROOT_ENV2 = "C4A_CLAUDE_PLUGIN_CACHE_ROOT";
 var CLAUDE_PLUGIN_CACHE_HOME_ENV2 = "C4A_CLAUDE_PLUGIN_CACHE_HOME";
 var ANSI_DIM = "\x1B[2m";
 var ANSI_YELLOW = "\x1B[33m";
 var ANSI_RESET = "\x1B[0m";
-function shellQuote9(value) {
+function shellQuote10(value) {
   return `'${value.replace(/'/g, "'\\''")}'`;
 }
 function commandLine(command2, args) {
-  return [command2, ...args.map((arg) => shellQuote9(arg))].join(" ");
+  return [command2, ...args.map((arg) => shellQuote10(arg))].join(" ");
 }
 function dim(value) {
   return `${ANSI_DIM}${value}${ANSI_RESET}`;
@@ -106442,7 +106618,7 @@ function packageCandidateDirs() {
 function pluginRootCandidates() {
   const envRoot = process.env.C4A_CONTEXT_PLUGIN_ROOT?.trim();
   if (envRoot)
-    return [resolve30(envRoot)];
+    return [resolve31(envRoot)];
   const candidates = [];
   for (const dir of packageCandidateDirs()) {
     candidates.push(join70(dir, "plugins"));
@@ -106451,7 +106627,7 @@ function pluginRootCandidates() {
   return [...new Set(candidates)];
 }
 function isInstallablePluginRoot(root2) {
-  return existsSync45(join70(root2, ".claude-plugin", "marketplace.json")) && existsSync45(join70(root2, ".agents", "plugins", "marketplace.json")) && existsSync45(join70(root2, "claude", ".claude-plugin", "plugin.json")) && existsSync45(join70(root2, "codex", ".codex-plugin", "plugin.json"));
+  return existsSync46(join70(root2, ".claude-plugin", "marketplace.json")) && existsSync46(join70(root2, ".agents", "plugins", "marketplace.json")) && existsSync46(join70(root2, "claude", ".claude-plugin", "plugin.json")) && existsSync46(join70(root2, "codex", ".codex-plugin", "plugin.json"));
 }
 function resolveBundledPluginsRoot() {
   const candidates = pluginRootCandidates();
@@ -106488,13 +106664,13 @@ async function runExternalOptional(command2, args) {
 async function commandAvailable(command2) {
   return runExternalOptional("sh", ["-lc", `command -v ${command2} >/dev/null 2>&1`]);
 }
-async function claudePluginInstalled() {
+async function claudePluginInstalled(pluginId) {
   try {
     const { stdout } = await execFileAsync7("claude", ["plugin", "list", "--json"], {
       maxBuffer: 1024 * 1024
     });
     const parsed = JSON.parse(stdout);
-    return Array.isArray(parsed) && parsed.some((item) => item !== null && typeof item === "object" && ("id" in item) && item.id === PLUGIN_ID);
+    return Array.isArray(parsed) && parsed.some((item) => item !== null && typeof item === "object" && ("id" in item) && item.id === pluginId);
   } catch {
     return false;
   }
@@ -106539,7 +106715,7 @@ function isStaleMarketplaceBlock(header, block) {
   return text5.includes('source_type = "local"') || text5.includes("/c4a-plugins") || text5.includes("context4ai/context");
 }
 function isStalePluginBlock(header) {
-  return header === `plugins."context@context"` || header === "plugins.context";
+  return header === `plugins."context@context"` || header === `plugins."context@c4a"` || header === "plugins.context";
 }
 function pruneLegacyCodexConfigContent(content3) {
   const lines = content3.split(`
@@ -106592,7 +106768,7 @@ async function pruneLegacyCodexConfig(dryRun, steps) {
 }
 async function pruneCodexPluginCacheForName(pluginName, keepVersion, dryRun, steps) {
   const cacheRoot = join70(codexHome(), "plugins", "cache", MARKETPLACE_NAME, pluginName);
-  if (!existsSync45(cacheRoot))
+  if (!existsSync46(cacheRoot))
     return;
   const versions = (await readdir21(cacheRoot, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory() && entry.name !== keepVersion).map((entry) => entry.name).sort();
   if (versions.length === 0)
@@ -106620,7 +106796,7 @@ async function isEmptyDir2(dir) {
 }
 async function pruneClaudeOrphanContextCache(dryRun, steps) {
   const cacheRoot = claudePluginCacheRoot();
-  if (!existsSync45(cacheRoot))
+  if (!existsSync46(cacheRoot))
     return;
   const removed = [];
   const marketplaces = await readdir21(cacheRoot, { withFileTypes: true }).catch(() => []);
@@ -106628,14 +106804,14 @@ async function pruneClaudeOrphanContextCache(dryRun, steps) {
     if (!marketplace.isDirectory())
       continue;
     const pluginDir = join70(cacheRoot, marketplace.name, PLUGIN_NAME);
-    if (!existsSync45(pluginDir))
+    if (!existsSync46(pluginDir))
       continue;
     const versions = await readdir21(pluginDir, { withFileTypes: true }).catch(() => []);
     for (const version3 of versions) {
       if (!version3.isDirectory())
         continue;
       const versionDir = join70(pluginDir, version3.name);
-      if (!existsSync45(join70(versionDir, ORPHAN_MARKER2)))
+      if (!existsSync46(join70(versionDir, ORPHAN_MARKER2)))
         continue;
       removed.push(`${marketplace.name}/${PLUGIN_NAME}/${version3.name}`);
       if (!dryRun) {
@@ -106662,12 +106838,12 @@ async function pruneClaudeLegacyPluginCache(dryRun, steps) {
   if (LEGACY_PLUGIN_NAMES.length === 0)
     return;
   const cacheRoot = claudePluginCacheRoot();
-  if (!existsSync45(cacheRoot))
+  if (!existsSync46(cacheRoot))
     return;
   const removed = [];
   for (const pluginName of LEGACY_PLUGIN_NAMES) {
     const pluginDir = join70(cacheRoot, MARKETPLACE_NAME, pluginName);
-    if (!existsSync45(pluginDir))
+    if (!existsSync46(pluginDir))
       continue;
     removed.push(`${MARKETPLACE_NAME}/${pluginName}`);
     if (!dryRun) {
@@ -106794,7 +106970,7 @@ async function materializeCodexPluginCache(root2, version3, dryRun, steps) {
   const target = codexPluginCacheDir(version3);
   steps.push({
     agent: "codex",
-    command: `materialize Codex plugin cache: ${shellQuote9(source2)} -> ${shellQuote9(target)}`,
+    command: `materialize Codex plugin cache: ${shellQuote10(source2)} -> ${shellQuote10(target)}`,
     status: dryRun ? "planned" : "ran"
   });
   if (dryRun)
@@ -106804,7 +106980,7 @@ async function materializeCodexPluginCache(root2, version3, dryRun, steps) {
   const previous3 = `${target}.previous-${process.pid}-${Date.now()}`;
   await rm19(temporary, { recursive: true, force: true });
   await cp(source2, temporary, { recursive: true, force: true });
-  const hadPrevious = existsSync45(target);
+  const hadPrevious = existsSync46(target);
   try {
     if (hadPrevious)
       await rename5(target, previous3);
@@ -106813,7 +106989,7 @@ async function materializeCodexPluginCache(root2, version3, dryRun, steps) {
       await rm19(previous3, { recursive: true, force: true });
   } catch (error) {
     await rm19(temporary, { recursive: true, force: true });
-    if (hadPrevious && !existsSync45(target) && existsSync45(previous3))
+    if (hadPrevious && !existsSync46(target) && existsSync46(previous3))
       await rename5(previous3, target);
     throw error;
   }
@@ -106825,6 +107001,13 @@ async function installClaude(root2, dryRun, steps) {
   const installArgs = ["plugin", "install", PLUGIN_ID, "--scope", "user"];
   steps.push({ agent: "claude", command: commandLine("claude", addArgs), status: dryRun ? "planned" : "ran" });
   if (dryRun) {
+    for (const pluginName of LEGACY_PLUGIN_NAMES) {
+      steps.push({
+        agent: "claude",
+        command: commandLine("claude", ["plugin", "uninstall", `${pluginName}@${MARKETPLACE_NAME}`, "--scope", "user"]),
+        status: "planned"
+      });
+    }
     steps.push({ agent: "claude", command: commandLine("claude", installArgs), status: "planned" });
     return;
   }
@@ -106832,7 +107015,15 @@ async function installClaude(root2, dryRun, steps) {
   if (!added) {
     await runExternal("claude", ["plugin", "marketplace", "update", MARKETPLACE_NAME]);
   }
-  if (await claudePluginInstalled()) {
+  for (const pluginName of LEGACY_PLUGIN_NAMES) {
+    const legacyPluginId = `${pluginName}@${MARKETPLACE_NAME}`;
+    if (!await claudePluginInstalled(legacyPluginId))
+      continue;
+    const uninstallArgs = ["plugin", "uninstall", legacyPluginId, "--scope", "user"];
+    steps.push({ agent: "claude", command: commandLine("claude", uninstallArgs), status: "ran" });
+    await runExternal("claude", uninstallArgs);
+  }
+  if (await claudePluginInstalled(PLUGIN_ID)) {
     const uninstallArgs = ["plugin", "uninstall", PLUGIN_ID, "--scope", "user"];
     steps.push({ agent: "claude", command: commandLine("claude", uninstallArgs), status: "ran" });
     await runExternal("claude", uninstallArgs);
@@ -106848,12 +107039,12 @@ async function installCodex(root2, dryRun, steps) {
   steps.push({ agent: "codex", command: commandLine("codex", addArgs), status: dryRun ? "planned" : "ran" });
   steps.push({
     agent: "codex",
-    command: `ensure ${shellQuote9(join70(codexHome(), "config.toml"))} registers local marketplace ${shellQuote9(MARKETPLACE_NAME)}`,
+    command: `ensure ${shellQuote10(join70(codexHome(), "config.toml"))} registers local marketplace ${shellQuote10(MARKETPLACE_NAME)}`,
     status: dryRun ? "planned" : "ran"
   });
   steps.push({
     agent: "codex",
-    command: `ensure ${shellQuote9(join70(codexHome(), "config.toml"))} enables ${shellQuote9(PLUGIN_ID)}`,
+    command: `ensure ${shellQuote10(join70(codexHome(), "config.toml"))} enables ${shellQuote10(PLUGIN_ID)}`,
     status: dryRun ? "planned" : "ran"
   });
   if (dryRun) {
@@ -107034,6 +107225,7 @@ function registerPackageCommands(program2) {
 
 // src/cli.ts
 var TOP_LEVEL_COMMANDS = new Set([
+  "entry",
   "init",
   "plugin",
   "status",
@@ -107072,7 +107264,7 @@ function readPackageVersion() {
     let dir = dirname42(fileURLToPath10(import.meta.url));
     for (let i2 = 0;i2 < 8; i2++) {
       const pkg = join71(dir, "package.json");
-      if (existsSync46(pkg)) {
+      if (existsSync47(pkg)) {
         const parsed = JSON.parse(readFileSync10(pkg, "utf8"));
         return parsed.version ?? "unknown";
       }
@@ -107089,10 +107281,10 @@ function readQuickstartPath() {
     let dir = dirname42(fileURLToPath10(import.meta.url));
     for (let i2 = 0;i2 < 8; i2++) {
       const candidate = join71(dir, "docs", "quickstart.md");
-      if (existsSync46(candidate))
+      if (existsSync47(candidate))
         return candidate;
       const pkg = join71(dir, "package.json");
-      if (existsSync46(pkg))
+      if (existsSync47(pkg))
         return candidate;
       const parent = dirname42(dir);
       if (parent === dir)
@@ -107185,6 +107377,7 @@ function createCliProgram() {
   });
   const baseHelpInformation = program2.helpInformation.bind(program2);
   program2.helpInformation = () => `${headerHelpText()}${baseHelpInformation()}${quickstartHelpText()}`;
+  registerProjectEntryCommand(program2);
   registerProjectInitCommand(program2);
   registerPluginCommands(program2);
   registerDebugCommands(program2);