@ken-jo/agent-connector 0.4.79 → 0.4.92

package/dist/{types-D6RWGXm1.d.ts → types-D0RqWxT8.d.ts}

@@ -23,23 +23,24 @@
  * exposes no writable MCP config to install into. The registry-completeness test
  * (tests/adapters/registry-completeness.test.ts) allowlists it for this reason.
  */
-type PlatformId = "claude-code" | "codex" | "cursor" | "vscode-copilot" | "jetbrains-copilot" | "copilot-cli" | "gemini-cli" | "opencode" | "mimo-code" | "kilo" | "kilo-cli" | "warp" | "hermes" | "nemoclaw" | "openclaw" | "zed" | "antigravity" | "antigravity-cli" | "kiro" | "qwen-code" | "kimi" | "pi" | "omp" | "droid" | "roo-code" | "cline" | "trae" | "amp" | "codebuff" | "mux" | "crush" | "goose" | "amazon-q" | "continue" | "windsurf" | "synthetic" | "unknown";
+type PlatformId = "claude-code" | "codebuddy" | "codex" | "cursor" | "vscode-copilot" | "jetbrains-copilot" | "copilot-cli" | "gemini-cli" | "opencode" | "mimo-code" | "kilo" | "kilo-cli" | "warp" | "hermes" | "nemoclaw" | "openclaw" | "zed" | "antigravity" | "antigravity-cli" | "kiro" | "qwen-code" | "kimi" | "pi" | "omp" | "droid" | "openhands" | "roo-code" | "cline" | "trae" | "amp" | "codebuff" | "mux" | "crush" | "goose" | "amazon-q" | "continue" | "windsurf" | "grok-cli" | "devin" | "open-interpreter" | "junie" | "mistral-vibe" | "synthetic" | "unknown";
 /**
  * Hook I/O paradigm — the deepest cross-platform divergence (report §4).
  * Canonical shipped sets (keep in sync with src/adapters/registry.ts — this
  * comment once drifted and seeded a docs-wide misclassification):
- *   - "json-stdio" (18): host pipes JSON to a command on stdin, reads
- *     JSON/exit-code back — Claude Code, Codex, Cursor, VS Code/JetBrains
- *     Copilot, Copilot CLI, Gemini CLI, Qwen, Kiro, Kimi, Crush, Goose, Hermes,
- *     Droid (Factory), Antigravity (+ the agy CLI), Continue, Amazon Q. One
- *     universal entrypoint binary handles all of them.
+ *   - "json-stdio" (19): host pipes JSON to a command on stdin, reads
+ *     JSON/exit-code back — Claude Code, CodeBuddy (Tencent, a Claude Code
+ *     fork), Codex, Cursor, VS Code/JetBrains Copilot, Copilot CLI, Gemini CLI,
+ *     Qwen, Kiro, Kimi, Crush, Goose, Hermes, Droid (Factory), Antigravity (+
+ *     the agy CLI), Continue, Amazon Q. One universal entrypoint binary handles
+ *     all of them.
  *   - "ts-plugin" (8): host loads a JS/TS module exporting lifecycle functions
  *     — OpenCode, MiMoCode (an OpenCode fork), Kilo CLI, Kilo, OMP, OpenClaw,
  *     NemoClaw (an OpenClaw wrapper/fork), Amp (.amp/plugins/*.ts). Framework
  *     generates the module.
- *   - "mcp-only" (9): no hook layer at all — Warp, Roo Code, Cline, Trae, Zed,
- *     Codebuff, Mux, Pi, Windsurf. Only the MCP server (or skills surface) is
- *     installed; hooks are reported unavailable.
+ *   - "mcp-only" (10): no hook layer at all — Warp, Roo Code, Cline, Trae, Zed,
+ *     Codebuff, Mux, Pi, Windsurf, Mistral Vibe. Only the MCP server (or skills
+ *     surface) is installed; hooks are reported unavailable.
  */
 type HookParadigm = "json-stdio" | "ts-plugin" | "mcp-only";
 /**
@@ -572,6 +573,7 @@ interface SkillDef {
     disableModelInvocation?: boolean;
     /** Extra files bundled beside SKILL.md, relative path → contents. */
     resources?: Record<string, string>;
+    /** Verbatim per-platform frontmatter additions (escape hatch). */
     extra?: Record<string, unknown>;
 }
 /** A named subagent (system-prompt + tool/model scoping). */
@@ -587,6 +589,13 @@ interface SubagentDef {
     model?: string;
     /** Coarse permission knob → Cursor readonly, opencode/kilo permission map. */
     readonly?: boolean;
+    /**
+     * Verbatim per-platform subagent manifest additions (escape hatch).
+     *
+     * Markdown/frontmatter hosts merge these as frontmatter. Hosts whose subagent
+     * files are native config/manifests merge them only when that native format is
+     * itself an extensible subagent surface.
+     */
     extra?: Record<string, unknown>;
 }
 /**
@@ -1060,6 +1069,41 @@ interface InstallResult {
     dryRun: boolean;
     changes: ChangeRecord[];
     warnings: string[];
+    /**
+     * Render-only digest of the resolved connector (id/version/server/hooks/
+     * telemetry/surface counts), threaded in by the CLI command so the friendly
+     * renderer can print a connector header. OPTIONAL: the core install/uninstall
+     * functions never populate it (they don't shape presentation) — the CLI
+     * attaches it from the {@link ResolvedConnector} it already loaded. The
+     * `--json` machine contract does NOT include it; see cli/app
+     * buildConnectorSummary / renderInstallResult.
+     */
+    connector?: ConnectorSummary;
+}
+/**
+ * A minimal, presentation-only digest of a {@link ResolvedConnector} used by the
+ * CLI's friendly install/uninstall/upgrade output. Lives here (not in cli/) so
+ * {@link InstallResult} can reference it without a CLI→core import cycle; it is
+ * BUILT by cli/app buildConnectorSummary. Render-only: never part of any machine
+ * (JSON) contract.
+ */
+interface ConnectorSummary {
+    id: string;
+    version: string;
+    displayName?: string;
+    /** stdio command line / remote URL; absent ⇒ hooks-only connector. */
+    server?: {
+        transport: string;
+        command: string;
+    };
+    hookEvents: string[];
+    telemetryEnabled: boolean;
+    commands: number;
+    skills: number;
+    subagents: number;
+    memory: number;
+    hasStatusline: boolean;
+    actions: number;
 }
 interface DiagnosticResult {
     check: string;

package/dist/{uninstall-TWPUEJEC.js → uninstall-M76BHLTH.js}

@@ -5,49 +5,51 @@ import {
   resolveUninstallTargets,
   uninstallConnector,
   uninstallViaMarketplace
-} from "./chunk-VD4EG6SG.js";
-import "./chunk-UYZ53KWS.js";
+} from "./chunk-JO2IM2JL.js";
+import "./chunk-IBLYVAWH.js";
 import {
   marketplaceEvidence,
   readMarketplaceInstalls
-} from "./chunk-QKLJU4JX.js";
-import "./chunk-NBUEL74R.js";
+} from "./chunk-2Y2MZRLP.js";
+import "./chunk-UM5S7DKK.js";
+import "./chunk-JFXL4HYA.js";
+import "./chunk-OPXAP3AC.js";
 import {
+  buildConnectorSummary,
   fail,
+  maybePrintBanner,
   parseScope,
   parseTargets,
   print,
   renderInstallResult
-} from "./chunk-VKRGQLY4.js";
-import "./chunk-LN76OGNR.js";
-import "./chunk-S4E6QQEM.js";
+} from "./chunk-5Z36KVU2.js";
+import "./chunk-Z2MRSS2I.js";
+import "./chunk-FO5CEXXN.js";
 import "./chunk-KHO5WNTP.js";
 import {
   findConnectorConfig,
   loadConnectorFromPath
-} from "./chunk-7NXEHZAK.js";
-import "./chunk-PZHB5TVA.js";
-import "./chunk-X457NOFE.js";
-import "./chunk-56R2ER7K.js";
-import "./chunk-OPXAP3AC.js";
-import "./chunk-UM5S7DKK.js";
+} from "./chunk-JVO6NBTT.js";
+import "./chunk-AY3VFNOH.js";
+import "./chunk-KA55FISM.js";
+import "./chunk-NBYKLUF6.js";
 import "./chunk-H53QZQJI.js";
 import "./chunk-BEFVJ2OE.js";
-import "./chunk-VVFDU4IX.js";
-import "./chunk-HORHRHNG.js";
-import "./chunk-YYNXIUR2.js";
+import "./chunk-WFEHWTLM.js";
+import "./chunk-4NHXLXSD.js";
+import "./chunk-M2H7JURF.js";
 import {
   assertConnectorId
-} from "./chunk-IXOQDZWC.js";
+} from "./chunk-GZGLCCEE.js";
 
 // src/cli/commands/uninstall.ts
 import { parseArgs } from "util";
 async function resolveConnectorId(explicitId, connectorPath, projectDir) {
-  if (explicitId && explicitId.trim() !== "") return explicitId;
+  if (explicitId && explicitId.trim() !== "") return { id: explicitId };
   const configPath = connectorPath ?? findConnectorConfig(projectDir);
   if (!configPath) return null;
   const { connector } = await loadConnectorFromPath(configPath);
-  return connector.id;
+  return { id: connector.id, connector };
 }
 async function run(argv) {
   const { values } = parseArgs({
@@ -60,10 +62,13 @@ async function run(argv) {
       "connector-id": { type: "string" },
       project: { type: "string" },
       "dry-run": { type: "boolean", default: false },
-      purge: { type: "boolean", default: false }
+      purge: { type: "boolean", default: false },
+      // Decorative-banner suppressor (no effect on command output bytes).
+      quiet: { type: "boolean", default: false }
     },
     allowPositionals: false
   });
+  maybePrintBanner({ quiet: values.quiet });
   const method = parseUninstallMethod(values.method);
   if (method == null) {
     return fail(`invalid --method "${values.method}" (use auto|direct|marketplace)`);
@@ -71,16 +76,18 @@ async function run(argv) {
   const projectDir = values.project ?? process.cwd();
   const scope = parseScope(values.scope);
   if (scope == null) return fail(`invalid --scope "${values.scope}" (use user|project)`);
-  const connectorId = await resolveConnectorId(
+  const resolved = await resolveConnectorId(
     values["connector-id"],
     values.connector,
     projectDir
   );
-  if (!connectorId) {
+  if (!resolved) {
     return fail(
       "could not determine connector id. Pass --connector-id <id>, --connector <path>, or run inside a project with an agent-connector config."
     );
   }
+  const connectorId = resolved.id;
+  const summary = resolved.connector ? buildConnectorSummary(resolved.connector) : void 0;
   try {
     assertConnectorId(connectorId);
   } catch (err) {
@@ -97,19 +104,20 @@ async function run(argv) {
       ...targets ? { targets } : {}
     });
     if (values.purge) purgeFrameworkState(connectorId, dryRun, result);
+    result.connector = summary;
     print(renderInstallResult(result, "uninstall"));
     return result.changes.some((c) => c.action === "warn") ? 1 : 0;
   }
   let marketplaceTargets = [];
   let directTargets = [];
   if (method === "auto") {
-    const resolved = await resolveUninstallTargets(connectorId, targets, projectDir);
+    const resolvedTargets = await resolveUninstallTargets(connectorId, targets, projectDir);
     const recorded = targets ? [] : Object.keys(readMarketplaceInstalls(connectorId));
-    const candidates = [.../* @__PURE__ */ new Set([...resolved, ...recorded])];
+    const candidates = [.../* @__PURE__ */ new Set([...resolvedTargets, ...recorded])];
     marketplaceTargets = candidates.filter(
       (id) => marketplaceEvidence(connectorId, id) != null
     );
-    directTargets = resolved.filter((id) => !marketplaceTargets.includes(id));
+    directTargets = resolvedTargets.filter((id) => !marketplaceTargets.includes(id));
   }
   if (marketplaceTargets.length === 0) {
     const result = await uninstallConnector({
@@ -120,6 +128,7 @@ async function run(argv) {
       purge: values.purge,
       ...targets ? { targets } : {}
     });
+    result.connector = summary;
     print(renderInstallResult(result, "uninstall"));
     return result.changes.some((c) => c.action === "warn") ? 1 : 0;
   }
@@ -165,7 +174,8 @@ async function run(argv) {
     connectorId,
     dryRun,
     changes: results.flatMap((r) => r.changes),
-    warnings: results.flatMap((r) => r.warnings)
+    warnings: results.flatMap((r) => r.warnings),
+    connector: summary
   };
   print(renderInstallResult(merged, "uninstall"));
   return merged.changes.some((c) => c.action === "warn") ? 1 : 0;
@@ -173,4 +183,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=uninstall-TWPUEJEC.js.map
+//# sourceMappingURL=uninstall-M76BHLTH.js.map

package/dist/uninstall-M76BHLTH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/uninstall.ts"],"sourcesContent":["/**\n * cli/commands/uninstall — strip a connector's registrations, method-aware.\n *\n * The connector id is taken from --connector-id, or inferred from the local\n * connector config (--connector <path> / findConnectorConfig).\n *\n * --method auto (default) reverses WHATEVER is actually there, per target:\n * targets with marketplace evidence (the state record, or the host's own plugin\n * state) get the HOST plugin uninstall; everything else gets the existing\n * direct adapter strip. Install chooses a method (a user decision); uninstall\n * reverses what exists (a state decision) — and since the double-install guard\n * enforces exactly one method per (connector, host, scope), auto is\n * unambiguous. Explicit --method direct|marketplace forces one path for every\n * target. Config removal vs plugin uninstall is therefore method-resolved:\n * never both, never neither.\n *\n * --purge additionally removes the framework-state this connector left behind:\n * its DATA-dir connector record (connectorDir(id)), the empty marketplace\n * staging root, and, when no connectors remain, the shared home-bin launcher.\n * Without --purge those linger so the connector can be re-synced without\n * re-registering.\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport {\n  purgeFrameworkState,\n  resolveUninstallTargets,\n  uninstallConnector,\n} from \"../../core/installer.js\";\nimport {\n  marketplaceEvidence,\n  parseUninstallMethod,\n  uninstallViaMarketplace,\n} from \"../../core/marketplace.js\";\nimport { readMarketplaceInstalls } from \"../../core/marketplace-state.js\";\nimport { assertConnectorId } from \"../../core/ids.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport type {\n  ConnectorSummary,\n  InstallResult,\n  PlatformId,\n  ResolvedConnector,\n} from \"../../core/types.js\";\nimport {\n  buildConnectorSummary,\n  fail,\n  maybePrintBanner,\n  parseScope,\n  parseTargets,\n  print,\n  renderInstallResult,\n} from \"../app.js\";\n\n/**\n * Resolve the connector id from flags, then from a local config file. When the\n * id was inferred by LOADING a config, the resolved connector is returned too so\n * the caller can build a header summary; an explicit `--connector-id` yields no\n * connector (id-only uninstall), and the renderer degrades to an id-only header.\n */\nasync function resolveConnectorId(\n  explicitId: string | undefined,\n  connectorPath: string | undefined,\n  projectDir: string,\n): Promise<{ id: string; connector?: ResolvedConnector } | null> {\n  if (explicitId && explicitId.trim() !== \"\") return { id: explicitId };\n  const configPath = connectorPath ?? findConnectorConfig(projectDir);\n  if (!configPath) return null;\n  const { connector } = await loadConnectorFromPath(configPath);\n  return { id: connector.id, connector };\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      method: { type: \"string\", default: \"auto\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      \"connector-id\": { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      purge: { type: \"boolean\", default: false },\n      // Decorative-banner suppressor (no effect on command output bytes).\n      quiet: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  maybePrintBanner({ quiet: values.quiet });\n\n  const method = parseUninstallMethod(values.method);\n  if (method == null) {\n    return fail(`invalid --method \"${values.method}\" (use auto|direct|marketplace)`);\n  }\n\n  const projectDir = values.project ?? process.cwd();\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n\n  const resolved = await resolveConnectorId(\n    values[\"connector-id\"],\n    values.connector,\n    projectDir,\n  );\n  if (!resolved) {\n    return fail(\n      \"could not determine connector id. Pass --connector-id <id>, \" +\n        \"--connector <path>, or run inside a project with an agent-connector config.\",\n    );\n  }\n  const connectorId = resolved.id;\n  // Header summary when a connector config was actually loaded; id-only\n  // (--connector-id) uninstalls have no connector → the renderer degrades to an\n  // id-only header.\n  const summary: ConnectorSummary | undefined = resolved.connector\n    ? buildConnectorSummary(resolved.connector)\n    : undefined;\n\n  // Single choke-point: validate the id BEFORE any path is built or any delete\n  // runs. Every branch below (explicit --method marketplace, --method auto, and\n  // the direct strip) constructs record / staging-root paths from this id —\n  // including the explicit --targets marketplace path, which reaches\n  // driver.finishUninstall(id) → rmSync(join(stagingRoot, id)) without otherwise\n  // routing the raw id through connectorDir's validation. Failing loud here closes\n  // the `--connector-id ../../x` traversal window for ALL of them at once.\n  try {\n    assertConnectorId(connectorId);\n  } catch (err) {\n    return fail(err instanceof Error ? err.message : String(err));\n  }\n\n  const targets = parseTargets(values.targets);\n  const dryRun = values[\"dry-run\"];\n\n  // ── Explicit --method marketplace: every target goes to the marketplace path\n  // (targets default to the recorded installs); framework purge runs here since\n  // no direct pass follows.\n  if (method === \"marketplace\") {\n    const result = await uninstallViaMarketplace({\n      connectorId,\n      projectDir,\n      dryRun,\n      purge: values.purge,\n      ...(targets ? { targets } : {}),\n    });\n    if (values.purge) purgeFrameworkState(connectorId, dryRun, result);\n    result.connector = summary;\n    print(renderInstallResult(result, \"uninstall\"));\n    return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n  }\n\n  // ── --method auto: partition the resolved targets by marketplace evidence.\n  // (--method direct keeps every target on the adapter strip — today's path.)\n  let marketplaceTargets: PlatformId[] = [];\n  let directTargets: PlatformId[] = [];\n  if (method === \"auto\") {\n    const resolvedTargets = await resolveUninstallTargets(connectorId, targets, projectDir);\n    // With no explicit --targets, recorded marketplace platforms are unioned\n    // in: the state record IS the authority for what we installed, and host\n    // detection can miss a host whose probe-able config dir was relocated.\n    // An explicit --targets list is always respected as-is.\n    const recorded = targets\n      ? []\n      : (Object.keys(readMarketplaceInstalls(connectorId)) as PlatformId[]);\n    const candidates = [...new Set([...resolvedTargets, ...recorded])];\n    marketplaceTargets = candidates.filter(\n      (id) => marketplaceEvidence(connectorId, id) != null,\n    );\n    directTargets = resolvedTargets.filter((id) => !marketplaceTargets.includes(id));\n  }\n\n  // No marketplace evidence anywhere (or --method direct): exactly today's\n  // single-orchestration path, byte-for-byte — zero behavior change for users\n  // who never touched the marketplace method.\n  if (marketplaceTargets.length === 0) {\n    const result = await uninstallConnector({\n      connectorId,\n      scope,\n      projectDir,\n      dryRun,\n      purge: values.purge,\n      ...(targets ? { targets } : {}),\n    });\n    result.connector = summary;\n    print(renderInstallResult(result, \"uninstall\"));\n    return result.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n  }\n\n  const results: InstallResult[] = [\n    await uninstallViaMarketplace({\n      connectorId,\n      projectDir,\n      targets: marketplaceTargets,\n      dryRun,\n      purge: values.purge,\n    }),\n  ];\n\n  // The direct strip runs only for its partition (never both methods on one\n  // target). When every target was marketplace-routed, --purge still runs the\n  // framework purge (the marketplace records were just cleared, so it can\n  // proceed to the connector record + home-bin).\n  if (directTargets.length > 0) {\n    results.push(\n      await uninstallConnector({\n        connectorId,\n        scope,\n        projectDir,\n        dryRun,\n        purge: values.purge,\n        targets: directTargets,\n      }),\n    );\n  } else if (values.purge) {\n    const purgeResult: InstallResult = {\n      connectorId,\n      dryRun,\n      changes: [],\n      warnings: [],\n    };\n    if (dryRun) {\n      // On a real run the marketplace records are removed BEFORE this purge;\n      // calling purgeFrameworkState now would false-refuse on records that the\n      // marketplace pass only PLANNED to remove. Report the plan instead.\n      purgeResult.changes.push({\n        platform: connectorId as PlatformId,\n        action: \"remove\",\n        detail:\n          \"would purge framework state (connector record; home-bin when no connectors remain)\",\n      });\n    } else {\n      purgeFrameworkState(connectorId, dryRun, purgeResult);\n    }\n    results.push(purgeResult);\n  }\n\n  const merged: InstallResult = {\n    connectorId,\n    dryRun,\n    changes: results.flatMap((r) => r.changes),\n    warnings: results.flatMap((r) => r.warnings),\n    connector: summary,\n  };\n  print(renderInstallResult(merged, \"uninstall\"));\n  return merged.changes.some((c) => c.action === \"warn\") ? 1 : 0;\n}\n"],"mappings":"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","names":[]}

package/dist/{upgrade-EM6Y7QLH.js → upgrade-JLSCNAQA.js}

@@ -4,38 +4,40 @@ import {
   resolveCliEntry,
   syncConnector,
   upgradeViaMarketplace
-} from "./chunk-VD4EG6SG.js";
-import "./chunk-UYZ53KWS.js";
-import "./chunk-QKLJU4JX.js";
-import "./chunk-NBUEL74R.js";
+} from "./chunk-JO2IM2JL.js";
+import "./chunk-IBLYVAWH.js";
+import "./chunk-2Y2MZRLP.js";
+import "./chunk-UM5S7DKK.js";
+import "./chunk-JFXL4HYA.js";
+import "./chunk-OPXAP3AC.js";
 import {
+  buildConnectorSummary,
   fail,
+  maybePrintBanner,
   parseScope,
   parseTargets,
   print,
   renderInstallResult
-} from "./chunk-VKRGQLY4.js";
-import "./chunk-LN76OGNR.js";
-import "./chunk-S4E6QQEM.js";
+} from "./chunk-5Z36KVU2.js";
+import "./chunk-Z2MRSS2I.js";
+import "./chunk-FO5CEXXN.js";
 import "./chunk-KHO5WNTP.js";
 import {
   findConnectorConfig,
   loadConnectorFromPath
-} from "./chunk-7NXEHZAK.js";
-import "./chunk-PZHB5TVA.js";
-import "./chunk-X457NOFE.js";
-import "./chunk-56R2ER7K.js";
-import "./chunk-OPXAP3AC.js";
-import "./chunk-UM5S7DKK.js";
+} from "./chunk-JVO6NBTT.js";
+import "./chunk-AY3VFNOH.js";
+import "./chunk-KA55FISM.js";
+import "./chunk-NBYKLUF6.js";
 import "./chunk-H53QZQJI.js";
 import "./chunk-BEFVJ2OE.js";
-import "./chunk-VVFDU4IX.js";
-import "./chunk-HORHRHNG.js";
-import "./chunk-YYNXIUR2.js";
+import "./chunk-WFEHWTLM.js";
+import "./chunk-4NHXLXSD.js";
+import "./chunk-M2H7JURF.js";
 import {
   ensureHomeBin,
   homeBinPath
-} from "./chunk-IXOQDZWC.js";
+} from "./chunk-GZGLCCEE.js";
 
 // src/cli/commands/upgrade.ts
 import { parseArgs } from "util";
@@ -53,10 +55,13 @@ async function run(argv) {
       targets: { type: "string" },
       connector: { type: "string" },
       project: { type: "string" },
-      "dry-run": { type: "boolean", default: false }
+      "dry-run": { type: "boolean", default: false },
+      // Decorative-banner suppressor (no effect on command output bytes).
+      quiet: { type: "boolean", default: false }
     },
     allowPositionals: false
   });
+  maybePrintBanner({ quiet: values.quiet });
   const channel = values.channel;
   if (channel !== "stable" && channel !== "latest") {
     return fail(`invalid --channel "${channel}" (use stable|latest)`);
@@ -88,6 +93,7 @@ async function run(argv) {
       ...targets ? { targets } : {}
     };
     const result = method === "marketplace" ? await upgradeViaMarketplace(opts) : await syncConnector(opts);
+    result.connector = buildConnectorSummary(connector);
     print(renderInstallResult(result, "upgrade"));
     if (result.changes.some((c) => c.action === "warn")) hadWarn = true;
     print("");
@@ -127,4 +133,4 @@ Refreshed home binary pointer: ${binPath}`);
 export {
   run
 };
-//# sourceMappingURL=upgrade-EM6Y7QLH.js.map
+//# sourceMappingURL=upgrade-JLSCNAQA.js.map

package/dist/upgrade-JLSCNAQA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/upgrade.ts"],"sourcesContent":["/**\n * cli/commands/upgrade — bring an agent-connector install current.\n *\n * `upgrade` (aliases: `update`, `sync`) consolidates the two former verbs into\n * ONE the way npm/brew pair `install` + `upgrade`, so there is a single verb to\n * learn for \"make everything current\". It:\n *\n *   1. re-renders the connector's config into every target host idempotently\n *      (identical entries report \"skip\"), exactly like the old `sync` — this is\n *      also the self-heal path: run `upgrade` to repair a drifted install; then\n *   2. refreshes the stable home-bin pointer and prints managed (never-silent)\n *      update guidance for the chosen channel, exactly like the old `update`.\n *\n * When no connector config is resolvable it still does step 2, so `upgrade`\n * works as a pure tool-refresh from anywhere. By design agent-connector NEVER\n * silently auto-updates (docs/ARCHITECTURE.md §3 R1).\n */\n\nimport { parseArgs } from \"node:util\";\n\nimport { resolveCliEntry, syncConnector } from \"../../core/installer.js\";\nimport { parseInstallMethod, upgradeViaMarketplace } from \"../../core/marketplace.js\";\nimport { findConnectorConfig, loadConnectorFromPath } from \"../../core/load-connector.js\";\nimport { ensureHomeBin, homeBinPath } from \"../../core/paths.js\";\nimport {\n  buildConnectorSummary,\n  fail,\n  maybePrintBanner,\n  parseScope,\n  parseTargets,\n  print,\n  renderInstallResult,\n} from \"../app.js\";\n\ntype Channel = \"stable\" | \"latest\";\n\n/** Heuristic: does the running CLI live under an npm-style node_modules tree? */\nfunction looksNpmManaged(): boolean {\n  const entry = resolveCliEntry().replace(/\\\\/g, \"/\");\n  return entry.includes(\"/node_modules/\");\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      channel: { type: \"string\", default: \"stable\" },\n      method: { type: \"string\", default: \"direct\" },\n      scope: { type: \"string\", default: \"user\" },\n      targets: { type: \"string\" },\n      connector: { type: \"string\" },\n      project: { type: \"string\" },\n      \"dry-run\": { type: \"boolean\", default: false },\n      // Decorative-banner suppressor (no effect on command output bytes).\n      quiet: { type: \"boolean\", default: false },\n    },\n    allowPositionals: false,\n  });\n\n  maybePrintBanner({ quiet: values.quiet });\n\n  const channel = values.channel;\n  if (channel !== \"stable\" && channel !== \"latest\") {\n    return fail(`invalid --channel \"${channel}\" (use stable|latest)`);\n  }\n  const ch: Channel = channel;\n\n  const method = parseInstallMethod(values.method);\n  if (method == null) {\n    return fail(`invalid --method \"${values.method}\" (use direct|marketplace)`);\n  }\n\n  const scope = parseScope(values.scope);\n  if (scope == null) return fail(`invalid --scope \"${values.scope}\" (use user|project)`);\n  if (method === \"marketplace\" && scope !== \"user\") {\n    return fail(\n      \"--method marketplace supports --scope user only (project-scope plugin installs are deferred)\",\n    );\n  }\n\n  let hadWarn = false;\n\n  // ── Step 1: bring the connector's deploys current (former `sync`):\n  //   direct      — idempotent re-render into every target host.\n  //   marketplace — re-stage the bundle + catalog in place, then drive the\n  //                 host's update verb (claude `plugin update`, with a recorded\n  //                 uninstall+install fallback); warns when connector.version is\n  //                 unchanged since the recorded install (Claude caches a\n  //                 versioned copy, so a same-version update silently no-ops).\n  const projectDir = values.project ?? process.cwd();\n  const configPath = values.connector ?? findConnectorConfig(projectDir);\n  if (configPath) {\n    const { connector, modulePath } = await loadConnectorFromPath(configPath);\n    const targets = parseTargets(values.targets);\n    const opts = {\n      connector,\n      modulePath,\n      scope,\n      projectDir,\n      dryRun: values[\"dry-run\"],\n      ...(targets ? { targets } : {}),\n    };\n    const result =\n      method === \"marketplace\"\n        ? await upgradeViaMarketplace(opts)\n        : await syncConnector(opts);\n    result.connector = buildConnectorSummary(connector);\n    print(renderInstallResult(result, \"upgrade\"));\n    if (result.changes.some((c) => c.action === \"warn\")) hadWarn = true;\n    print(\"\");\n  } else {\n    print(\"upgrade: no connector config found — refreshing the tool only.\");\n    print(\n      \"(pass --connector <path> or run inside a project to also re-render host config.)\\n\",\n    );\n  }\n\n  // ── Step 2: managed update guidance + home-bin pointer refresh (former `update`). ──\n  print(\"agent-connector uses managed (explicit) updates — never silent\");\n  print(\"auto-update — so one bad release can't break every project at once.\\n\");\n\n  const dist = ch === \"stable\" ? \"latest\" : \"next\";\n  if (looksNpmManaged()) {\n    print(`To update the ${ch} channel, run:`);\n    print(`  npm i -g @ken-jo/agent-connector@${dist}`);\n  } else {\n    print(\n      `This install does not look npm-managed. Update it the way you installed it,`,\n    );\n    print(`then re-run \\`agent-connector upgrade\\` to refresh the home pointer.`);\n    print(`(npm installs would use: npm i -g @ken-jo/agent-connector@${dist})`);\n  }\n\n  // Refresh the stable home-bin pointer so hosts keep execing a working CLI.\n  if (!values[\"dry-run\"]) {\n    try {\n      const binPath = ensureHomeBin(resolveCliEntry());\n      print(`\\nRefreshed home binary pointer: ${binPath}`);\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      print(`\\n[warn] could not refresh home binary at ${homeBinPath()}: ${message}`);\n      return 1;\n    }\n  }\n\n  return hadWarn ? 1 : 0;\n}\n"],"mappings":"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","names":[]}

package/dist/{usage-3HQDTXGY.js → usage-5I72HWCR.js}

@@ -3,7 +3,7 @@ import {
   formatHostLeaderboard,
   hostLeaderboard,
   scanUsage
-} from "./chunk-IRUYJD23.js";
+} from "./chunk-NLE2J5P4.js";
 import {
   aggregateBy,
   sumTokens
@@ -11,7 +11,7 @@ import {
 import {
   fail,
   print
-} from "./chunk-VKRGQLY4.js";
+} from "./chunk-5Z36KVU2.js";
 
 // src/cli/commands/usage.ts
 import { writeFileSync } from "fs";
@@ -321,4 +321,4 @@ export {
   parseSince,
   run
 };
-//# sourceMappingURL=usage-3HQDTXGY.js.map
+//# sourceMappingURL=usage-5I72HWCR.js.map

package/dist/{usage-event-DWIGKO7V.js → usage-event-HIX4ZI45.js}

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
 import {
   runUsageEvent
-} from "./chunk-LKAVD4HP.js";
+} from "./chunk-447JWFZO.js";
 import "./chunk-OP4KBXUO.js";
-import "./chunk-LN76OGNR.js";
-import "./chunk-S4E6QQEM.js";
-import "./chunk-ZXX5DVSE.js";
-import "./chunk-4FWETID5.js";
+import "./chunk-Z2MRSS2I.js";
+import "./chunk-FO5CEXXN.js";
+import "./chunk-FBCBHEGB.js";
 import "./chunk-KHO5WNTP.js";
-import "./chunk-7NXEHZAK.js";
-import "./chunk-PZHB5TVA.js";
-import "./chunk-X457NOFE.js";
-import "./chunk-56R2ER7K.js";
-import "./chunk-HORHRHNG.js";
-import "./chunk-YYNXIUR2.js";
-import "./chunk-IXOQDZWC.js";
+import "./chunk-IVAWP6HH.js";
+import "./chunk-JVO6NBTT.js";
+import "./chunk-AY3VFNOH.js";
+import "./chunk-KA55FISM.js";
+import "./chunk-NBYKLUF6.js";
+import "./chunk-4NHXLXSD.js";
+import "./chunk-M2H7JURF.js";
+import "./chunk-GZGLCCEE.js";
 
 // src/cli/commands/usage-event.ts
 import { parseArgs } from "util";
@@ -50,4 +50,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=usage-event-DWIGKO7V.js.map
+//# sourceMappingURL=usage-event-HIX4ZI45.js.map

package/dist/{vscode-copilot-LU5NC4ZS.js → vscode-copilot-LILHAPJI.js}

@@ -9,14 +9,14 @@ import {
   BaseAdapter,
   renderSkillMd,
   renderSubagentMd
-} from "./chunk-VVFDU4IX.js";
+} from "./chunk-WFEHWTLM.js";
 import {
   buildHomeBinHookCommand,
   buildWrappedStdio,
   isHomeBinHookCommand
-} from "./chunk-HORHRHNG.js";
-import "./chunk-YYNXIUR2.js";
-import "./chunk-IXOQDZWC.js";
+} from "./chunk-4NHXLXSD.js";
+import "./chunk-M2H7JURF.js";
+import "./chunk-GZGLCCEE.js";
 
 // src/adapters/vscode-copilot/index.ts
 import { existsSync } from "fs";
@@ -202,6 +202,15 @@ var VSCodeCopilotAdapter = class extends BaseAdapter {
     if (connector.hookEvents.length === 0) {
       return [{ platform: this.id, action: "skip", detail: "connector declares no hooks" }];
     }
+    if (ctx.scope === "user") {
+      return [
+        {
+          platform: this.id,
+          action: "warn",
+          detail: "VS Code Copilot hooks are workspace-scoped (.github/hooks); rerun with --scope project to install hooks."
+        }
+      ];
+    }
     const hooksPath = this.getHookConfigPath(ctx);
     const symlink = this.symlinkPathWarning(hooksPath);
     if (symlink) return [symlink];
@@ -507,6 +516,12 @@ var VSCodeCopilotAdapter = class extends BaseAdapter {
           if (hookEvents.length === 0) {
             return { status: "OK", detail: "no hooks declared" };
           }
+          if (ctx.scope === "user") {
+            return {
+              status: "OK",
+              detail: "hooks are workspace-scoped; install them with --scope project"
+            };
+          }
           const file = this.readJson(hooksPath);
           if (!file) return { status: "FAIL", detail: `not found: ${hooksPath}` };
           if (file.version !== VSCODE_HOOKS_VERSION) {
@@ -748,4 +763,4 @@ export {
   adapter,
   vscode_copilot_default as default
 };
-//# sourceMappingURL=vscode-copilot-LU5NC4ZS.js.map
+//# sourceMappingURL=vscode-copilot-LILHAPJI.js.map