@ken-jo/agent-connector 0.4.67 → 0.4.79

package/dist/copilot-cli-SMTX5F65.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/copilot-cli/index.ts"],"sourcesContent":["/**\n * adapters/copilot-cli — GitHub Copilot CLI platform adapter for agent-connector.\n *\n * GitHub Copilot CLI is a json-stdio host: the host pipes a JSON payload to a\n * hook command on stdin and reads JSON/exit-code back. Its reply shape is\n * Claude-compatible (`hookSpecificOutput` wrapper), but its hooks-file event\n * KEYS are NOT — the CLI's loader honors ONLY a fixed set of lowerCamelCase\n * keys and SILENTLY DROPS anything else (see EVENT_WIRE_KEY below), so a\n * PascalCase→camelCase rename table IS required when writing the config.\n *\n * Native config (user/global only — Copilot CLI has no project-scoped config):\n *   - MCP servers: ~/.copilot/mcp-config.json, root key \"mcpServers\". An stdio\n *     server is written with type \"local\" (the host also accepts \"stdio\") plus\n *     `tools: [\"*\"]`. Remote servers use type \"http\".\n *   - Hooks: a hooks file shaped `{ version: 1, hooks: { … } }` discovered from\n *     ~/.copilot/hooks/*.json. We write a single dedicated file,\n *     ~/.copilot/hooks/agent-connector.json, so we never disturb a user's own\n *     hook files and removal is a clean, scoped operation. Each event maps to an\n *     array of flat command entries `{ matcher?, hooks: [{ type:\"command\", command }] }`\n *     keyed by the CLI's lowerCamelCase wire name (EVENT_WIRE_KEY).\n *   - Reply: the installed CLI 1.0.63 reads the PreToolUse permission decision\n *     FLAT at the TOP LEVEL of the hook's stdout JSON — `{ permissionDecision\n *     (allow|deny|ask), permissionDecisionReason, modifiedArgs? }` — there is NO\n *     `hookSpecificOutput` wrapper in 1.0.63 (verified: the token appears zero\n *     times in app.js), and PreToolUse is the ONLY event whose reply the host\n *     reads. PreToolUse is fail-closed; exit 0 + the flat JSON refines the\n *     decision. The host has no additionalContext mechanism, so context\n *     injection is a no-op on this version. (PermissionRequest/SubagentStop keep\n *     their Claude-shaped envelopes for forward-compat; they are unread on 1.0.63.)\n *\n * Env handling: the host is not documented to support `${env:VAR}` interpolation\n * inside mcp-config.json, so env/header/url refs are resolved to literals at\n * install time via resolveEnvRefsDeep (the safe default for a no-native-interp\n * host, matching the Codex adapter's approach).\n *\n * Content surfaces (surfaces-design §4-5): Copilot CLI exposes skills and\n * subagents but NO prompt-file command surface, so commands inherit the\n * BaseAdapter skip/warn default (supportsCommands stays false).\n *   - skills: folder-per-skill `<dir>/skills/<name>/SKILL.md` (+ resource files).\n *     user scope → ~/.copilot/skills; project scope → <projectDir>/.github/skills.\n *   - subagents: user scope → ~/.copilot/agents/<name>.agent.md; project scope →\n *     <projectDir>/.github/agents/<name>.agent.md (md + frontmatter:\n *     name, description, tools, model).\n * The .github/ tree is shared with the vscode-copilot and jetbrains-copilot\n * connectors; we write identical, idempotent content and on uninstall remove\n * only the files this connector wrote.\n *\n * Grounded in docs/research/understand-report.md §2 (Platform Integration\n * Matrix, \"GitHub Copilot CLI\" row).\n */\n\nimport { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport type { Adapter, HookReply, InstallContext, MemoryTarget, NormalizedEvent } from \"../spi.js\";\nimport type {\n  ChangeRecord,\n  DetectedPlatform,\n  HealthCheck,\n  HookEventName,\n  HookParadigm,\n  HookResponse,\n  NotificationEvent,\n  PermissionRequestEvent,\n  PlatformCapabilities,\n  PlatformId,\n  PostToolUseEvent,\n  PostToolUseFailureEvent,\n  PostCompactEvent,\n  PreCompactEvent,\n  PreToolUseEvent,\n  ServerDef,\n  SessionEndEvent,\n  SessionStartEvent,\n  StopEvent,\n  SubagentStartEvent,\n  SubagentStopEvent,\n  Transport,\n  UserPromptSubmitEvent,\n} from \"../../core/types.js\";\nimport { resolveEnvRefsDeep } from \"../../core/interpolate.js\";\nimport {\n  buildHomeBinHookCommand,\n  buildWrappedStdio,\n  isHomeBinHookCommand,\n} from \"../../core/spawn.js\";\nimport { renderSkillMd, renderSubagentMd } from \"../claude-code/render.js\";\nimport { normalizeSessionSource } from \"../claude-code/wire.js\";\n\nconst HOST: PlatformId = \"copilot-cli\";\nconst MCP_ROOT_KEY = \"mcpServers\";\n\n/** Native hooks-file version Copilot CLI expects (`{ version: 1, hooks: {…} }`). */\nconst COPILOT_HOOKS_VERSION = 1;\n\n/**\n * EVENT→WIRE-KEY map for the hooks file. VERIFIED against the installed GitHub\n * Copilot CLI 1.0.63 bundle (app.js): the hook loader validates every\n * `config.hooks` key against a hardcoded Set of NINE lowerCamelCase event names —\n *   { sessionStart, sessionEnd, userPromptSubmitted, preToolUse, postToolUse,\n *     errorOccurred, agentStop, subagentStop, preCompact }\n * — and any key NOT in that Set is SILENTLY DROPPED (logged only at debug:\n * \"Ignoring unknown hook event(s)\"). The Zod hooks schema defines the same nine\n * camelCase keys and nothing else. So a PascalCase key like `PreToolUse` never\n * registers → the hook NEVER FIRES. We therefore key the file by the camelCase\n * WIRE name, NOT the PascalCase HookEventName.\n *\n * Two mappings are NOT a naive lowercase-first-letter: Claude's `Stop` is the\n * CLI's `agentStop`, and `UserPromptSubmit` is `userPromptSubmitted`. The rest\n * are first-letter-lowercased. (PascalCase aliases are documented for a newer\n * CLI that selects the snake_case payload dialect, but they are unknown to the\n * loader in 1.0.63 and dropped — camelCase is the only safe wire form here.)\n *\n * Only events Copilot CLI's loader actually accepts appear here. Events the\n * installed loader has no file-hook key for (Notification, PermissionRequest,\n * SubagentStart, PostToolUseFailure) are demoted on `capabilities` and warn-skip\n * at install — they are NOT in this map.\n */\nconst EVENT_WIRE_KEY: Partial<Record<HookEventName, string>> = {\n  SessionStart: \"sessionStart\",\n  SessionEnd: \"sessionEnd\",\n  UserPromptSubmit: \"userPromptSubmitted\",\n  PreToolUse: \"preToolUse\",\n  PostToolUse: \"postToolUse\",\n  PreCompact: \"preCompact\",\n  Stop: \"agentStop\",\n  SubagentStop: \"subagentStop\",\n};\n\n/**\n * CAPABILITY FILTER for installHooks — maps each canonical HookEventName to the\n * `capabilities` flag that gates it. The adapter's `capabilities` literal is the\n * single source of truth for what Copilot CLI's runtime actually fires; declared\n * events (connector.hookEvents is the connector-level set, NOT pre-filtered by\n * host) are screened through this map so an unsupported event — Copilot CLI has\n * NO post-compaction hook, so `postCompact` stays unset — is reported as a\n * graceful warn/skip instead of being written as a dead `hooks.PostCompact` the\n * host would never fire. Same shape as the goose adapter's EVENT_CAPABILITY.\n */\nconst EVENT_CAPABILITY: Record<HookEventName, keyof PlatformCapabilities> = {\n  SessionStart: \"sessionStart\",\n  SessionEnd: \"sessionEnd\",\n  UserPromptSubmit: \"userPromptSubmit\",\n  PreToolUse: \"preToolUse\",\n  PostToolUse: \"postToolUse\",\n  PreCompact: \"preCompact\",\n  Stop: \"stop\",\n  Notification: \"notification\",\n  PermissionRequest: \"permissionRequest\",\n  PostToolUseFailure: \"postToolUseFailure\",\n  SubagentStart: \"subagentStart\",\n  SubagentStop: \"subagentStop\",\n  // Copilot CLI has no post-compaction hook — postCompact stays unset on\n  // `capabilities`, so a declared PostCompact warn-skips at install.\n  PostCompact: \"postCompact\",\n};\n\n/**\n * A single Copilot CLI hook registration entry (Claude-shaped).\n *\n * `matcher` is OPTIONAL and, when present, MUST be non-empty. Copilot CLI's\n * hooks schema is `matcher: z.string().min(1).optional()` (live-verified on CLI\n * 1.0.63): an OMITTED matcher passes validation, but an EMPTY STRING fails it —\n * the loader logs \"Invalid hook configuration … matcher cannot be empty\" and\n * DISCARDS THE ENTIRE hook file, registering zero hooks. So we OMIT the key\n * entirely when there is no matcher and emit it only when non-empty; we must\n * never write `matcher: \"\"`.\n */\ninterface CopilotHookEntry {\n  matcher?: string;\n  hooks: Array<{ type: \"command\"; command: string }>;\n}\n\n/** The shape of the Copilot CLI hooks file we own. */\ninterface CopilotHooksFile {\n  version?: number;\n  hooks?: Record<string, CopilotHookEntry[]>;\n}\n\n/** Native MCP server entry shapes Copilot CLI accepts under `mcpServers`. */\ninterface CopilotLocalServer {\n  /** stdio transport is registered as type \"local\" (host also accepts \"stdio\"). */\n  type: \"local\";\n  command: string;\n  args?: string[];\n  env?: Record<string, string>;\n  cwd?: string;\n  tools: string[];\n}\ninterface CopilotHttpServer {\n  /** Remote transport: \"http\" (Streamable HTTP) or \"sse\" (legacy). */\n  type: \"http\" | \"sse\";\n  url: string;\n  headers?: Record<string, string>;\n  tools: string[];\n}\n\n/** Raw Copilot CLI hook stdin payload.\n *\n * The installed CLI 1.0.63 bundle (app.js) builds tool-event stdin in\n * lowerCamelCase via a single shared getter, NOT the Claude-style snake_case\n * this adapter once assumed:\n *   PreToolUse  → { sessionId, timestamp, cwd, toolName, toolArgs }\n *   PostToolUse → { sessionId, timestamp, cwd, toolName, toolArgs,\n *                   toolResult: { resultType, textResultForLlm } }\n * where `toolArgs` is a JSON-**string** (the writer does\n * `toolArgs: JSON.stringify(t.toolArgs, null, 2)`). The snake_case fields are\n * retained as a tolerant fallback so a future/alternate dialect still parses,\n * but camelCase is the live wire form on 1.0.63. */\ninterface CopilotWireInput {\n  connector?: unknown;\n  // session id: camelCase on the live wire; snake_case kept as a fallback.\n  sessionId?: string;\n  session_id?: string;\n  transcript_path?: string;\n  cwd?: string;\n  hook_event_name?: string;\n\n  // tool events — camelCase is the live 1.0.63 wire form; `toolArgs` is a\n  // JSON-STRING. snake_case retained as a tolerant fallback.\n  toolName?: string;\n  toolArgs?: unknown;\n  tool_name?: string;\n  tool_input?: Record<string, unknown>;\n  // PostToolUse: the live bundle ships the result under camelCase\n  // `toolResult.{resultType,textResultForLlm}`; the snake_case `tool_result`\n  // form is kept as a fallback. PostToolUse fires success-only.\n  toolResult?: { resultType?: string; textResultForLlm?: string };\n  tool_result?: { result_type?: string; text_result_for_llm?: string };\n\n  // SessionStart\n  source?: string;\n  // SessionEnd\n  reason?: string;\n  // UserPromptSubmit\n  prompt?: string;\n  // PreCompact\n  trigger?: string;\n  // Notification\n  message?: string;\n\n  // PostToolUseFailure — payload is {tool_name, tool_input, error} + base\n  // (hooks-reference.md:421-430). No tool_use_id/is_interrupt/duration_ms.\n  error?: string;\n\n  // SubagentStart / SubagentStop — VS Code dialect identity is `agent_name`\n  // (+ optional `agent_display_name`); there is no agent_id/agent_type\n  // (hooks-reference.md:467-476,497-507).\n  agent_name?: string;\n  agent_display_name?: string;\n}\n\nexport class CopilotCliAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"GitHub Copilot CLI\";\n  readonly paradigm: HookParadigm = \"json-stdio\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: AGENTS.md-first managed block (project <projectDir>/AGENTS.md\n    // via the base default; user scope → ~/.copilot/copilot-instructions.md below).\n    supportsMemory: true,\n    // Copilot CLI's file-hook loader (1.0.63) accepts exactly these of the\n    // canonical lifecycle events — every one is a member of its hardcoded\n    // camelCase validator Set (see EVENT_WIRE_KEY).\n    preToolUse: true,\n    postToolUse: true,\n    preCompact: true,\n    sessionStart: true,\n    sessionEnd: true,\n    userPromptSubmit: true, // → wire key userPromptSubmitted\n    stop: true, // → wire key agentStop\n    subagentStop: true,\n    // DEMOTED — NOT in the installed CLI 1.0.63 file-hook validator Set, so a\n    // hooks-file key for any of these is silently dropped and never fires:\n    //   notification, permissionRequest, subagentStart, postToolUseFailure.\n    // (The github/docs `main` hooks-reference describes them for a NEWER CLI;\n    // re-promote per-event once a verified bundle ships them in the Set — until\n    // then the fail-safe is false so installHooks warn-skips instead of writing\n    // a dead key.)\n    notification: false,\n    permissionRequest: false,\n    postToolUseFailure: false,\n    subagentStart: false,\n    // PreToolUse is fail-closed and can rewrite tool input (the host reads a\n    // flat top-level `modifiedArgs`); a PostToolUse hook cannot rewrite\n    // already-emitted tool output.\n    canModifyArgs: true,\n    canModifyOutput: false,\n    // DEMOTED to false (fail-safe): the installed CLI 1.0.63 bundle has NO\n    // additionalContext mechanism — the token appears zero times in app.js, so a\n    // context-injection reply (SessionStart/PreCompact/etc.) is a silent no-op.\n    // Claiming the capability would advertise an injection path the host never\n    // honors; re-promote once a verified bundle ships an additionalContext reader.\n    canInjectSessionContext: false,\n    // Copilot CLI's mcp-config.json `type` accepts stdio (written \"local\"),\n    // http (Streamable HTTP), and sse (legacy) — per GitHub's add-mcp-servers docs.\n    transports: [\"stdio\", \"http\", \"sse\"],\n    // Content surfaces: Copilot CLI exposes skills + subagents, but has no\n    // prompt-file command surface, so commands stay false (inherits BaseAdapter\n    // skip/warn).\n    supportsCommands: false,\n    supportsSkills: true,\n    supportsSubagents: true,\n    // Native passthrough: Copilot CLI has an `errorOccurred` lifecycle event (a\n    // member of the camelCase validator Set) with NO canonical HookEventName\n    // analog — below the >=3-host core bar (docs/research/host-specific-hook-events-design.md).\n    // A connector reaches it via platforms[\"copilot-cli\"].nativeHooks; installHooks\n    // files the event-name key VERBATIM (the author must supply the CLI's exact\n    // camelCase key, e.g. `errorOccurred` — the loader drops unknown keys) with\n    // the same home-bin command shape, and the generic uninstall reverses it.\n    supportsNativeHooks: true,\n  };\n\n  // ── Detection ────────────────────────────────────────────────────────────\n\n  detectInstalled(_projectDir: string): DetectedPlatform {\n    const userDir = join(homedir(), \".copilot\");\n    const mcpConfig = join(userDir, \"mcp-config.json\");\n    const hooksDir = join(userDir, \"hooks\");\n    const installed =\n      existsSync(userDir) || existsSync(mcpConfig) || existsSync(hooksDir);\n    return {\n      id: this.id,\n      name: this.name,\n      installed,\n      paradigm: this.paradigm,\n      capabilities: this.capabilities,\n      configPath: mcpConfig,\n      scope: \"user\",\n      reason: installed\n        ? `found GitHub Copilot CLI config under ${userDir}`\n        : `no GitHub Copilot CLI config at ${userDir}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Memory surface: user-scope global instructions file ─────────────────\n  // Project scope stays on the AGENTS.md base default (root AGENTS.md is the\n  // primary instructions file). User scope targets Copilot CLI's documented\n  // $HOME/.copilot/copilot-instructions.md — a markdown file shared with other\n  // writers, so the managed block (not whole-file ownership) applies as usual.\n  protected override memoryTargets(ctx: InstallContext): MemoryTarget[] {\n    if (this.memoryOverride(ctx)?.path || ctx.scope !== \"user\") {\n      return super.memoryTargets(ctx);\n    }\n    return [\n      {\n        path: join(homedir(), \".copilot\", \"copilot-instructions.md\"),\n        reason: \"copilot-cli global instructions (~/.copilot/copilot-instructions.md)\",\n      },\n    ];\n  }\n\n  // ── Native paths ─────────────────────────────────────────────────────────\n\n  /** Copilot CLI is user/global only — scope is ignored. */\n  getConfigDir(_ctx: InstallContext): string {\n    return join(homedir(), \".copilot\");\n  }\n\n  getServerConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"mcp-config.json\");\n  }\n\n  /**\n   * Copilot CLI discovers hooks from any `~/.copilot/hooks/*.json`. We write a\n   * single dedicated file so we never disturb the user's own hook files and\n   * uninstall is a clean, scoped operation.\n   */\n  getHookConfigPath(ctx: InstallContext): string {\n    return join(this.getConfigDir(ctx), \"hooks\", \"agent-connector.json\");\n  }\n\n  // ── MCP server install / uninstall ───────────────────────────────────────\n\n  installServer(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    const override = connector.platforms[HOST]?.server;\n    if (!connector.server || override === false) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          detail: connector.server\n            ? \"server registration disabled for copilot-cli\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    // Shallow-merge any per-platform server override into the base ServerDef.\n    const server: ServerDef =\n      override && typeof override === \"object\"\n        ? { ...connector.server, ...override }\n        : connector.server;\n\n    const serverPath = this.getServerConfigPath(ctx);\n    const entry = this.renderServerEntry(ctx, server);\n\n    return [\n      this.upsertServerInJson(serverPath, MCP_ROOT_KEY, connector.id, entry, ctx.dryRun),\n    ];\n  }\n\n  uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const serverPath = this.getServerConfigPath(ctx);\n    return [\n      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun),\n    ];\n  }\n\n  /** Render a normalized ServerDef into Copilot CLI's native mcpServers entry. */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): CopilotLocalServer | CopilotHttpServer {\n    const transport: Transport = server.transport;\n    const tools = this.renderTools(server);\n\n    if (transport === \"stdio\") {\n      let command = server.command ?? \"\";\n      let args = [...(server.args ?? [])];\n\n      // Transparent telemetry wrapping: route the real command through\n      // `<homeBin> serve --connector <id> -- <command> <args...>`.\n      ({ command, args } = buildWrappedStdio(ctx, server, this.id, command, args));\n\n      const entry: CopilotLocalServer = {\n        type: \"local\",\n        command: resolveEnvRefsDeep(command),\n        tools,\n      };\n      if (args.length > 0) entry.args = args.map((a) => resolveEnvRefsDeep(a));\n      const env = this.renderEnv(server.env);\n      if (env) entry.env = env;\n      if (server.cwd) entry.cwd = resolveEnvRefsDeep(server.cwd);\n      return entry;\n    }\n\n    // remote (Streamable http / legacy sse) — Copilot registers a URL keyed by\n    // its `type`. AC's canonical \"sse\" → \"sse\"; everything else → \"http\".\n    const entry: CopilotHttpServer = {\n      type: server.transport === \"sse\" ? \"sse\" : \"http\",\n      url: resolveEnvRefsDeep(server.url ?? \"\"),\n      tools,\n    };\n    const headers = this.renderEnv(server.headers);\n    if (headers) entry.headers = headers;\n    return entry;\n  }\n\n  /**\n   * Render env/header values. Copilot CLI is not documented to support native\n   * `${env:VAR}` interpolation in mcp-config.json, so refs resolve to literals\n   * at install time (the safe default for a no-native-interp host).\n   */\n  private renderEnv(\n    env: Record<string, string> | undefined,\n  ): Record<string, string> | undefined {\n    if (!env || Object.keys(env).length === 0) return undefined;\n    return resolveEnvRefsDeep({ ...env });\n  }\n\n  /** Render the tool allow-list. Copilot CLI expects `tools` on every entry; default [\"*\"]. */\n  private renderTools(server: ServerDef): string[] {\n    const include = server.tools?.include;\n    return include && include.length > 0 ? [...include] : [\"*\"];\n  }\n\n  // ── Hook install / uninstall ─────────────────────────────────────────────\n\n  installHooks(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    const override = connector.platforms[HOST];\n    const hooksDisabled = override?.hooks === false;\n    // `hooks: false` disables only the NORMALIZED events; nativeHooks is a\n    // sibling, copilot-cli-scoped declaration that installs regardless.\n    const normalizedEvents = hooksDisabled ? [] : connector.hookEvents;\n    const nativeHooks = override?.nativeHooks ?? {};\n    const nativeEvents = Object.keys(nativeHooks);\n\n    if (normalizedEvents.length === 0 && nativeEvents.length === 0) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          detail: hooksDisabled\n            ? \"hooks disabled for copilot-cli\"\n            : \"connector declares no hooks\",\n        },\n      ];\n    }\n\n    const hooksPath = this.getHookConfigPath(ctx);\n    const file = this.readJson<CopilotHooksFile>(hooksPath) ?? {};\n    const __skip = this.malformedHookRootSkip(hooksPath, (file as Record<string, unknown>).hooks);\n    if (__skip) return [__skip];\n    const hooks = (file.hooks ??= {});\n\n    const changes: ChangeRecord[] = [];\n    let mutated = false;\n\n    for (const event of normalizedEvents) {\n      // CAPABILITY FILTER: an event Copilot CLI's runtime does not deliver (e.g.\n      // PostCompact — postCompact unset on `capabilities`) must NOT be written as\n      // a dead hook the host never fires; report a graceful warn/skip instead.\n      if (this.capabilities[EVENT_CAPABILITY[event]] !== true) {\n        changes.push({\n          platform: this.id,\n          action: \"warn\",\n          path: hooksPath,\n          detail: `${event} unsupported on copilot-cli — skipped`,\n        });\n        continue;\n      }\n      // Key the hooks file by the CLI's camelCase WIRE name — a PascalCase key\n      // is silently dropped by the loader (see EVENT_WIRE_KEY). The home-bin\n      // command keeps the PascalCase `event` token: that is the AC-internal\n      // router event passed to parseEvent/formatReply, NOT a hooks-file key.\n      const copilotEvent = EVENT_WIRE_KEY[event];\n      if (copilotEvent === undefined) {\n        // Defensive: a capability-flagged event with no wire key would write a\n        // dead PascalCase key. Treat it like an unsupported event (warn-skip).\n        changes.push({\n          platform: this.id,\n          action: \"warn\",\n          path: hooksPath,\n          detail: `${event} unsupported on copilot-cli — skipped`,\n        });\n        continue;\n      }\n      const command = buildHomeBinHookCommand(ctx.homeBinPath, HOST, event, connector.id);\n      const matcher = connector.hooks[event]?.matcher;\n      // OMIT the matcher key when there is none — Copilot CLI rejects an empty\n      // string (matcher cannot be empty) and discards the whole hooks file.\n      const entry: CopilotHookEntry = {\n        ...(matcher ? { matcher } : {}),\n        hooks: [{ type: \"command\", command }],\n      };\n\n      const bucket = (hooks[copilotEvent] ??= []);\n      const existingIdx = bucket.findIndex((e) => this.entryHasOurCommand(e, ctx));\n\n      if (existingIdx >= 0) {\n        if (JSON.stringify(bucket[existingIdx]) === JSON.stringify(entry)) {\n          changes.push({\n            platform: this.id,\n            action: \"skip\",\n            path: hooksPath,\n            detail: `hooks.${copilotEvent} already registered`,\n          });\n          continue;\n        }\n        bucket[existingIdx] = entry;\n        changes.push({\n          platform: this.id,\n          action: \"update\",\n          path: hooksPath,\n          detail: `hooks.${copilotEvent}`,\n        });\n      } else {\n        bucket.push(entry);\n        changes.push({\n          platform: this.id,\n          action: \"create\",\n          path: hooksPath,\n          detail: `hooks.${copilotEvent}`,\n        });\n      }\n      mutated = true;\n    }\n\n    // NATIVE passthrough events: copilot-cli-native event-name keys (e.g.\n    // ErrorOccurred) filed VERBATIM into the hooks map — no EVENT_MAP, since they\n    // ARE Copilot events. The command keeps the native token; matched by EXACT\n    // command so a native key coinciding with a normalized one never clobbers it.\n    for (const nativeEvent of nativeEvents) {\n      const command = buildHomeBinHookCommand(ctx.homeBinPath, HOST, nativeEvent, connector.id);\n      const matcher = nativeHooks[nativeEvent]?.matcher;\n      // OMIT the matcher key when there is none (empty string fails validation).\n      const entry: CopilotHookEntry = {\n        ...(matcher ? { matcher } : {}),\n        hooks: [{ type: \"command\", command }],\n      };\n      const bucket = (hooks[nativeEvent] ??= []);\n      const existingIdx = bucket.findIndex((e) => e.hooks?.[0]?.command === command);\n      if (existingIdx >= 0) {\n        if (JSON.stringify(bucket[existingIdx]) === JSON.stringify(entry)) {\n          changes.push({\n            platform: this.id,\n            action: \"skip\",\n            path: hooksPath,\n            detail: `hooks.${nativeEvent} (native) already registered`,\n          });\n          continue;\n        }\n        bucket[existingIdx] = entry;\n        changes.push({\n          platform: this.id,\n          action: \"update\",\n          path: hooksPath,\n          detail: `hooks.${nativeEvent} (native)`,\n        });\n      } else {\n        bucket.push(entry);\n        changes.push({\n          platform: this.id,\n          action: \"create\",\n          path: hooksPath,\n          detail: `hooks.${nativeEvent} (native)`,\n        });\n      }\n      mutated = true;\n    }\n\n    if (mutated) {\n      file.version = COPILOT_HOOKS_VERSION;\n      this.writeJson(hooksPath, file, ctx.dryRun);\n    }\n    return changes;\n  }\n\n  uninstallHooks(ctx: InstallContext): ChangeRecord[] {\n    const hooksPath = this.getHookConfigPath(ctx);\n    const file = this.readJson<CopilotHooksFile>(hooksPath);\n    const hooks = file?.hooks;\n    if (!file || !hooks) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          path: hooksPath,\n          detail: \"no hooks section present\",\n        },\n      ];\n    }\n\n    const changes: ChangeRecord[] = [];\n    let mutated = false;\n\n    for (const copilotEvent of Object.keys(hooks)) {\n      const bucket = hooks[copilotEvent];\n      if (!Array.isArray(bucket)) continue;\n\n      // Strip our hook command from each entry; drop entries left empty so we\n      // never remove another connector's (or the user's own) hook commands.\n      const next: CopilotHookEntry[] = [];\n      let removed = 0;\n      for (const e of bucket) {\n        const innerBefore = e.hooks?.length ?? 0;\n        const inner = (e.hooks ?? []).filter((h) => !this.isOurCommand(h.command, ctx));\n        removed += innerBefore - inner.length;\n        // Preserve the entry's original matcher verbatim, but never synthesize an\n        // empty string — Copilot CLI rejects `matcher: \"\"` (whole file discarded).\n        if (inner.length > 0) next.push({ ...(e.matcher ? { matcher: e.matcher } : {}), hooks: inner });\n      }\n\n      if (removed > 0) {\n        if (next.length > 0) hooks[copilotEvent] = next;\n        else delete hooks[copilotEvent];\n        changes.push({\n          platform: this.id,\n          action: \"remove\",\n          path: hooksPath,\n          detail: `hooks.${copilotEvent} (${removed})`,\n        });\n        mutated = true;\n      }\n    }\n\n    if (mutated) {\n      // When our uninstall empties the hooks map, delete this connector's\n      // dedicated file rather than leaving an inert `{version:1,hooks:{}}` stub.\n      // The file is owned solely by AC (see getHookConfigPath), so removing it on\n      // full teardown is safe and keeps ~/.copilot/hooks clean.\n      if (Object.keys(hooks).length === 0) {\n        this.removeManagedFile(hooksPath, ctx.dryRun);\n      } else {\n        this.writeJson(hooksPath, file, ctx.dryRun);\n      }\n    }\n    if (changes.length === 0) {\n      changes.push({\n        platform: this.id,\n        action: \"skip\",\n        path: hooksPath,\n        detail: \"no matching hook entries\",\n      });\n    }\n    return changes;\n  }\n\n  private entryHasOurCommand(entry: CopilotHookEntry, ctx: InstallContext): boolean {\n    return (entry.hooks ?? []).some((h) => this.isOurCommand(h.command, ctx));\n  }\n\n  /** True when a hook command references our home binary AND this connector id\n   *  (anchored so a shared-prefix id can't collide — see isHomeBinHookCommand). */\n  private isOurCommand(command: string | undefined, ctx: InstallContext): boolean {\n    return isHomeBinHookCommand(command, ctx.homeBinPath, ctx.connector.id);\n  }\n\n  // ── Content surfaces: skills / subagents ─────────────────────────────────\n  // CONTENT-ONLY: pure native-file writers. No runtime dispatch, no home-bin\n  // pointer, no telemetry wrap. Each method is idempotent (byte-identical →\n  // skip) via BaseAdapter.writeContentFile and reversible via removeContentFile.\n  // Honors platforms[\"copilot-cli\"] per-surface false to skip. Commands are\n  // unsupported here — they inherit the BaseAdapter skip/warn default.\n  //\n  // Path scoping: user scope lives under ~/.copilot (getConfigDir); project\n  // scope lives under the shared <projectDir>/.github tree (the same files\n  // vscode-copilot / jetbrains-copilot would write). We write identical content\n  // and on uninstall remove only the files this connector wrote.\n\n  /** Root dir for content surfaces: ~/.copilot (user) or <projectDir>/.github (project). */\n  private contentDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".github\")\n      : this.getConfigDir(ctx);\n  }\n\n  private skillsDir(ctx: InstallContext): string {\n    return join(this.contentDir(ctx), \"skills\");\n  }\n  private agentsDir(ctx: InstallContext): string {\n    return join(this.contentDir(ctx), \"agents\");\n  }\n\n  /** Native skill dir: <contentDir>/skills/<name>. */\n  private skillDir(ctx: InstallContext, name: string): string {\n    return join(this.skillsDir(ctx), name);\n  }\n  /** Native subagent file path: <contentDir>/agents/<name>.agent.md. */\n  private subagentPath(ctx: InstallContext, name: string): string {\n    return join(this.agentsDir(ctx), `${name}.agent.md`);\n  }\n\n  // ── Skills ────────────────────────────────────────────────────────────────\n\n  override installSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.skills === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"skills disabled for copilot-cli\" }];\n    }\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      changes.push(\n        this.writeContentFile(join(dir, \"SKILL.md\"), renderSkillMd(skill), ctx.dryRun),\n      );\n      // Bundle any resource files beside SKILL.md (relative path → contents).\n      // Defense-in-depth: skip+warn on any key that escapes the skill dir\n      // (config-time validation already rejects these, but never trust input).\n      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) {\n          changes.push({\n            platform: this.id,\n            action: \"warn\",\n            detail: `skill resource \"${rel}\" escapes the skill dir; skipped`,\n          });\n          continue;\n        }\n        changes.push(this.writeContentFile(target, contents, ctx.dryRun));\n      }\n    }\n    return changes;\n  }\n\n  override uninstallSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      // Remove only the files we wrote (SKILL.md + declared resources), then the\n      // skill dir itself when we own its full contents.\n      changes.push(this.removeContentFile(join(dir, \"SKILL.md\"), ctx.dryRun));\n      for (const rel of Object.keys(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) continue; // never delete outside the skill dir\n        changes.push(this.removeContentFile(target, ctx.dryRun));\n      }\n      // Only remove the skill dir when WE own its full contents — never rm -rf a\n      // dir that still holds user-added / sibling-tool / shared files.\n      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));\n    }\n    return changes;\n  }\n\n  // ── Subagents ───────────────────────────────────────────────────────────────\n\n  override installSubagents(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.subagents === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"subagents disabled for copilot-cli\" }];\n    }\n    if (connector.subagents.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no subagents\" }];\n    }\n    return connector.subagents.map((agent) =>\n      this.writeContentFile(\n        this.subagentPath(ctx, agent.name),\n        renderSubagentMd(agent),\n        ctx.dryRun,\n      ),\n    );\n  }\n\n  override uninstallSubagents(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.subagents.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no subagents\" }];\n    }\n    return connector.subagents.map((agent) =>\n      this.removeContentFile(this.subagentPath(ctx, agent.name), ctx.dryRun),\n    );\n  }\n\n  // ── Diagnostics ──────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const mcpPath = this.getServerConfigPath(ctx);\n    const hooksPath = this.getHookConfigPath(ctx);\n    const connectorId = ctx.connector.id;\n    const homeBin = ctx.homeBinPath;\n    const hookEvents = ctx.connector.hookEvents;\n    const checks: HealthCheck[] = [\n      {\n        name: `${this.name}: mcp-config.json present`,\n        check: () =>\n          existsSync(mcpPath)\n            ? { status: \"OK\", detail: mcpPath }\n            : { status: \"FAIL\", detail: `not found: ${mcpPath}` },\n      },\n      {\n        name: `${this.name}: hook command registered`,\n        check: () => {\n          if (hookEvents.length === 0) {\n            return { status: \"OK\", detail: \"no hooks declared\" };\n          }\n          const file = this.readJson<CopilotHooksFile>(hooksPath);\n          if (!file) return { status: \"FAIL\", detail: `cannot read ${hooksPath}` };\n          const hooks = file.hooks ?? {};\n          const registered = Object.values(hooks).some((entries) =>\n            (entries ?? []).some((e) =>\n              (e.hooks ?? []).some((h) =>\n                isHomeBinHookCommand(h.command, homeBin, connectorId),\n              ),\n            ),\n          );\n          return registered\n            ? { status: \"OK\", detail: \"hook command present\" }\n            : { status: \"FAIL\", detail: `no hook for ${connectorId} in ${hooksPath}` };\n        },\n      },\n    ];\n\n    // Content-surface checks: only assert presence of the surfaces this\n    // connector declares (skip silently for surfaces it never asked for).\n    // Commands are unsupported on Copilot CLI, so no command check.\n    for (const skill of ctx.connector.skills) {\n      const p = join(this.skillDir(ctx, skill.name), \"SKILL.md\");\n      checks.push({\n        name: `${this.name}: skill ${skill.name} present`,\n        check: () =>\n          existsSync(p) ? { status: \"OK\", detail: p } : { status: \"FAIL\", detail: `not found: ${p}` },\n      });\n    }\n    for (const agent of ctx.connector.subagents) {\n      const p = this.subagentPath(ctx, agent.name);\n      checks.push({\n        name: `${this.name}: subagent ${agent.name} present`,\n        check: () =>\n          existsSync(p) ? { status: \"OK\", detail: p } : { status: \"FAIL\", detail: `not found: ${p}` },\n      });\n    }\n    return checks;\n  }\n\n  // ── Runtime: parse Copilot CLI stdin JSON → normalized event ─────────────\n\n  parseEvent(event: HookEventName, raw: unknown): NormalizedEvent {\n    const input = (raw ?? {}) as CopilotWireInput;\n    const connectorId = typeof input.connector === \"string\" ? input.connector : \"\";\n    const sessionId = extractSessionId(input);\n    const projectDir = typeof input.cwd === \"string\" ? input.cwd : undefined;\n\n    const base = {\n      hostPlatform: HOST,\n      connectorId,\n      sessionId,\n      raw,\n      ...(projectDir !== undefined ? { projectDir } : {}),\n    } as const;\n\n    switch (event) {\n      case \"PreToolUse\": {\n        // Live 1.0.63 wire: camelCase `toolName` + `toolArgs` (a JSON-STRING).\n        // snake_case `tool_name`/`tool_input` are tolerant fallbacks.\n        const ev: PreToolUseEvent = {\n          ...base,\n          toolName: toolNameOf(input),\n          toolInput: toolInputOf(input),\n        };\n        return ev;\n      }\n      case \"PostToolUse\": {\n        // PostToolUse fires success-only. The live 1.0.63 wire carries the\n        // result under camelCase `toolResult.textResultForLlm`; the snake_case\n        // `tool_result.text_result_for_llm` form is a tolerant fallback. Failures\n        // arrive via the separate PostToolUseFailure event, so isError is never\n        // set here.\n        const toolOutput =\n          input.toolResult?.textResultForLlm ?? input.tool_result?.text_result_for_llm;\n        const ev: PostToolUseEvent = {\n          ...base,\n          toolName: toolNameOf(input),\n          toolInput: toolInputOf(input),\n          ...(typeof toolOutput === \"string\" ? { toolOutput } : {}),\n        };\n        return ev;\n      }\n      case \"SessionStart\": {\n        const ev: SessionStartEvent = {\n          ...base,\n          source: normalizeSessionSource(input.source),\n        };\n        return ev;\n      }\n      case \"SessionEnd\": {\n        const ev: SessionEndEvent = {\n          ...base,\n          ...(typeof input.reason === \"string\" ? { reason: input.reason } : {}),\n        };\n        return ev;\n      }\n      case \"UserPromptSubmit\": {\n        const ev: UserPromptSubmitEvent = {\n          ...base,\n          prompt: typeof input.prompt === \"string\" ? input.prompt : \"\",\n        };\n        return ev;\n      }\n      case \"PreCompact\": {\n        const ev: PreCompactEvent = {\n          ...base,\n          ...(input.trigger === \"auto\" || input.trigger === \"manual\"\n            ? { trigger: input.trigger }\n            : {}),\n        };\n        return ev;\n      }\n      case \"PostCompact\": {\n        // Copilot CLI does not fire PostCompact natively (postCompact unset →\n        // warn-skip at install). Parsed defensively, mirroring PreCompact, so a\n        // manual/mis-routed dispatch normalizes instead of hitting the guard.\n        const ev: PostCompactEvent = {\n          ...base,\n          ...(input.trigger === \"auto\" || input.trigger === \"manual\"\n            ? { trigger: input.trigger }\n            : {}),\n        };\n        return ev;\n      }\n      case \"Stop\": {\n        // The host signals completion via stop_reason:\"end_turn\", not the\n        // stopHookActive loop-guard boolean, so nothing maps onto StopEvent\n        // beyond base (hooks-reference.md:449-457).\n        const ev: StopEvent = { ...base };\n        return ev;\n      }\n      case \"Notification\": {\n        const ev: NotificationEvent = {\n          ...base,\n          message: typeof input.message === \"string\" ? input.message : \"\",\n        };\n        return ev;\n      }\n      case \"PermissionRequest\": {\n        // permissionRequest uses the PreToolUse shape (tool_name + tool_input\n        // only); the host emits no permission_suggestions payload\n        // (hooks-reference.md:218,627-649).\n        const ev: PermissionRequestEvent = {\n          ...base,\n          toolName: toolNameOf(input),\n          toolInput: toolInputOf(input),\n        };\n        return ev;\n      }\n      case \"PostToolUseFailure\": {\n        // Host payload is the tool-event shape + `error`; it carries no\n        // tool_use_id / is_interrupt / duration_ms correlation fields. (Demoted\n        // on capabilities — below the live-fire bar — but parsed consistently\n        // with the live camelCase tool dialect.)\n        const ev: PostToolUseFailureEvent = {\n          ...base,\n          toolName: toolNameOf(input),\n          toolInput: toolInputOf(input),\n          error: typeof input.error === \"string\" ? input.error : \"\",\n        };\n        return ev;\n      }\n      case \"SubagentStart\": {\n        // The host's subagent identity field is `agent_name`; there is no\n        // agent_id or agent_type (agent_display_name is a human label, not a\n        // type), so agentType stays unset (hooks-reference.md:467-476).\n        const ev: SubagentStartEvent = {\n          ...base,\n          ...(typeof input.agent_name === \"string\" ? { agentId: input.agent_name } : {}),\n        };\n        return ev;\n      }\n      case \"SubagentStop\": {\n        // VS Code dialect: identity is `agent_name`, the subagent transcript is\n        // the BASE `transcript_path` (not agent_transcript_path), and there is\n        // no agent_type / last_assistant_message / stop_hook_active — the final\n        // response is reachable only via transcript_path, and completion is\n        // signalled by stop_reason (hooks-reference.md:497-507).\n        const ev: SubagentStopEvent = {\n          ...base,\n          ...(typeof input.agent_name === \"string\" ? { agentId: input.agent_name } : {}),\n          ...(typeof input.transcript_path === \"string\"\n            ? { agentTranscriptPath: input.transcript_path }\n            : {}),\n        };\n        return ev;\n      }\n      default: {\n        // Exhaustive guard — every HookEventName is handled above.\n        const _never: never = event;\n        throw new Error(`unsupported copilot-cli hook event: ${String(_never)}`);\n      }\n    }\n  }\n\n  // ── Runtime: normalized response → Copilot CLI native hook reply ─────────\n\n  formatReply(event: HookEventName, response: HookResponse): HookReply {\n    const hookEventName = event;\n    const decision = response.decision ?? \"allow\";\n\n    // PermissionRequest replies use the Claude-compatible nested\n    // decision{behavior} envelope and are the ONE event where an EXPLICIT\n    // \"allow\" is an ACTIVE grant (it suppresses the permission dialog) rather\n    // than passthrough:\n    //   allow            → decision{behavior:\"allow\"} (+updatedInput when set);\n    //                      the host still enforces its own deny rules.\n    //   modify           → an allow grant carrying updatedInput.\n    //   deny             → decision{behavior:\"deny\", message}.\n    //   ask/context/void → NO decision output: fall through to the native\n    //                      dialog (the dialog IS the ask).\n    if (event === \"PermissionRequest\") {\n      if (response.decision === \"deny\") {\n        return this.stdout({\n          hookSpecificOutput: {\n            hookEventName,\n            decision: {\n              behavior: \"deny\",\n              message: response.reason ?? \"Blocked by hook\",\n            },\n          },\n        });\n      }\n      if (\n        response.decision === \"allow\" ||\n        (response.decision === \"modify\" && response.updatedInput)\n      ) {\n        return this.stdout({\n          hookSpecificOutput: {\n            hookEventName,\n            decision: {\n              behavior: \"allow\",\n              ...(response.updatedInput\n                ? { updatedInput: response.updatedInput }\n                : {}),\n            },\n          },\n        });\n      }\n      return { exitCode: 0 };\n    }\n\n    // PostToolUseFailure (recovery guidance beside the error) and SubagentStart\n    // (context prepended to the SUBAGENT's conversation — creation is not\n    // blockable on Copilot CLI) are observe/context-only: \"context\" emits\n    // additionalContext, and a \"deny\" DEGRADES to the same shape carrying the\n    // reason. Everything else passes through.\n    if (event === \"PostToolUseFailure\" || event === \"SubagentStart\") {\n      const context =\n        decision === \"context\"\n          ? response.additionalContext\n          : decision === \"deny\"\n            ? response.reason ?? response.additionalContext\n            : undefined;\n      if (context) {\n        return this.stdout({\n          hookSpecificOutput: { hookEventName, additionalContext: context },\n        });\n      }\n      return { exitCode: 0 };\n    }\n\n    // PreToolUse — the ONLY event whose reply the installed CLI 1.0.63 actually\n    // reads, and it reads the permission decision FLAT at the TOP LEVEL of the\n    // hook's stdout JSON (VERIFIED in app.js):\n    //   a => ({ permissionDecision: a?.permissionDecision,\n    //           permissionDecisionReason: a?.permissionDecisionReason,\n    //           modifiedArgs: a?.modifiedArgs })\n    // There is NO `hookSpecificOutput` wrapper in 1.0.63 (the token appears zero\n    // times in the bundle), so a nested reply leaves `a.permissionDecision`\n    // undefined and the deny is SILENTLY IGNORED — the tool runs anyway. We\n    // therefore emit the flat keys the host honors:\n    //   deny   → { permissionDecision:\"deny\", permissionDecisionReason }\n    //            → host prints `Denied by preToolUse hook: <reason>`\n    //   ask    → { permissionDecision:\"ask\", permissionDecisionReason }\n    //   modify → { modifiedArgs } (the host accepts a string or an object and\n    //            stringifies an object itself; we pass updatedInput as-is)\n    //   context/additionalContext → NO-OP on 1.0.63 (the bundle has no\n    //            additionalContext mechanism), so it degrades to exit 0.\n    if (event === \"PreToolUse\") {\n      if (decision === \"deny\") {\n        return this.stdout({\n          permissionDecision: \"deny\",\n          permissionDecisionReason: response.reason ?? \"Blocked by hook\",\n        });\n      }\n      if (decision === \"ask\") {\n        return this.stdout({\n          permissionDecision: \"ask\",\n          permissionDecisionReason: response.reason ?? \"Confirmation required by hook\",\n        });\n      }\n      if (decision === \"modify\" && response.updatedInput) {\n        return this.stdout({ modifiedArgs: response.updatedInput });\n      }\n      // allow / context / void → pass through (no honored reply on 1.0.63).\n      return { exitCode: 0 };\n    }\n\n    // deny → block the action with a reason (exit 0; JSON carries the decision).\n    // SubagentStop is the Stop-semantics exception: like Claude, the block is\n    // the TOP-LEVEL {\"decision\":\"block\",\"reason\"} — it keeps the subagent\n    // running with `reason` as its next instruction (the host \"can block and\n    // force continuation\").\n    //\n    // NOTE: for every OTHER event, the installed CLI 1.0.63 attaches NO reply\n    // reader (the bundle's args getter is `a => {}`), so what we emit below is a\n    // no-op on this version; it is retained for forward-compatibility with a\n    // CLI that does consume these decisions.\n    if (decision === \"deny\") {\n      if (event === \"SubagentStop\") {\n        return this.stdout({\n          decision: \"block\",\n          reason: response.reason ?? \"Blocked by hook\",\n        });\n      }\n      return this.stdout({\n        hookSpecificOutput: {\n          hookEventName,\n          permissionDecision: \"deny\",\n          permissionDecisionReason: response.reason ?? \"Blocked by hook\",\n        },\n      });\n    }\n\n    // ask → prompt the user to confirm.\n    if (decision === \"ask\") {\n      return this.stdout({\n        hookSpecificOutput: {\n          hookEventName,\n          permissionDecision: \"ask\",\n          permissionDecisionReason: response.reason ?? \"Confirmation required by hook\",\n        },\n      });\n    }\n\n    // modify is a PreToolUse-only capability and is handled in the flat-reply\n    // PreToolUse branch above; for every other event it falls through to allow\n    // (output rewrite is unsupported on Copilot CLI).\n\n    // context → inject soft guidance (also the SessionStart context path).\n    if (decision === \"context\" && response.additionalContext) {\n      return this.stdout({\n        hookSpecificOutput: { hookEventName, additionalContext: response.additionalContext },\n      });\n    }\n\n    // allow / void / unsupported-degradation → pass through with exit 0.\n    return { exitCode: 0 };\n  }\n\n  private stdout(payload: unknown): HookReply {\n    return { exitCode: 0, stdout: JSON.stringify(payload) };\n  }\n}\n\n/**\n * Extract a stable session id from a Copilot CLI wire payload.\n * Priority mirrors the Claude wire protocol: transcript UUID > sessionId > \"\".\n * The live 1.0.63 wire sends `sessionId` (camelCase); `session_id` is kept as a\n * tolerant fallback.\n */\nfunction extractSessionId(input: CopilotWireInput): string {\n  if (typeof input.transcript_path === \"string\") {\n    const m = input.transcript_path.match(/([a-f0-9-]{36})\\.jsonl$/);\n    if (m && m[1]) return m[1];\n  }\n  if (typeof input.sessionId === \"string\" && input.sessionId !== \"\") {\n    return input.sessionId;\n  }\n  if (typeof input.session_id === \"string\" && input.session_id !== \"\") {\n    return input.session_id;\n  }\n  return \"\";\n}\n\n/**\n * Resolve the tool name from a tool-event payload — camelCase `toolName` (the\n * live 1.0.63 wire) with a snake_case `tool_name` fallback.\n */\nfunction toolNameOf(input: CopilotWireInput): string {\n  if (typeof input.toolName === \"string\") return input.toolName;\n  if (typeof input.tool_name === \"string\") return input.tool_name;\n  return \"\";\n}\n\n/**\n * Resolve the tool input object from a tool-event payload. The live 1.0.63 wire\n * sends `toolArgs` as a JSON-STRING (`JSON.stringify(t.toolArgs,null,2)`), so we\n * parse it into an object; an already-object `toolArgs` is accepted as-is, and\n * the snake_case `tool_input` (already an object) is the fallback.\n */\nfunction toolInputOf(input: CopilotWireInput): Record<string, unknown> {\n  const raw = input.toolArgs;\n  if (typeof raw === \"string\") {\n    try {\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n        return parsed as Record<string, unknown>;\n      }\n    } catch {\n      // Non-JSON string → fall through to the other shapes / empty object.\n    }\n  } else if (raw && typeof raw === \"object\" && !Array.isArray(raw)) {\n    return raw as Record<string, unknown>;\n  }\n  if (input.tool_input && typeof input.tool_input === \"object\") {\n    return input.tool_input;\n  }\n  return {};\n}\n\nexport const adapter = new CopilotCliAdapter();\nexport default adapter;\n"],"mappings":"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","names":["entry"]}

package/dist/{crush-PP4HYZLT.js → crush-NYDBHIJE.js}

@@ -5,18 +5,18 @@ import {
 } from "./chunk-UM5S7DKK.js";
 import {
   resolveEnvRefsDeep
-} from "./chunk-DBQMX75U.js";
+} from "./chunk-BEFVJ2OE.js";
 import {
   BaseAdapter,
   renderSkillMd
-} from "./chunk-RHML2NOB.js";
+} from "./chunk-VVFDU4IX.js";
 import {
   buildHomeBinHookCommand,
   buildWrappedStdio,
   isHomeBinHookCommand
-} from "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+} from "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 
 // src/adapters/crush/index.ts
 import { existsSync, statSync } from "fs";
@@ -201,9 +201,9 @@ var CrushAdapter = class extends BaseAdapter {
       return [{ platform: this.id, action: "skip", detail: "hooks disabled for crush" }];
     }
     const events = this.effectiveHookEvents(ctx);
-    const dropped = this.warnSkipHookEvents(ctx);
+    const declined = this.declinedHookEvents(ctx);
     const path = this.getHookConfigPath(ctx);
-    if (events.length === 0 && dropped.length === 0) {
+    if (events.length === 0 && declined.length === 0) {
       return [{ platform: this.id, action: "skip", path, detail: "no hooks declared" }];
     }
     const cfg = this.readJson(path) ?? {};
@@ -212,10 +212,10 @@ var CrushAdapter = class extends BaseAdapter {
     const hooks = cfg.hooks ??= {};
     const changes = [];
     let mutated = false;
-    for (const event of dropped) {
+    for (const { event, action } of declined) {
       changes.push({
         platform: this.id,
-        action: "warn",
+        action,
         path,
         detail: `${event} has no Crush hook equivalent \u2014 skipped`
       });
@@ -292,10 +292,20 @@ var CrushAdapter = class extends BaseAdapter {
     if (ctx.connector.platforms[HOST]?.hooks === false) return [];
     return CRUSH_HOOK_EVENTS.filter((e) => ctx.connector.hookEvents.includes(e));
   }
-  /** Declared events Crush has no analog for — install reports a warn-skip. */
-  warnSkipHookEvents(ctx) {
+  /**
+   * Every declared event Crush has NO native equivalent for, tagged with the
+   * severity install reports it at — so a host that cannot fire an event is
+   * NEVER silent. The 4 newer E1 events ({@link WARN_SKIP_EVENTS}) keep `warn`
+   * (exit-1, the established convention); every other unsupported event (the
+   * legacy SessionStart / Stop / … that used to vanish) reports a visible
+   * `skip` (counted, but exit-0-preserving).
+   */
+  declinedHookEvents(ctx) {
     if (ctx.connector.platforms[HOST]?.hooks === false) return [];
-    return ctx.connector.hookEvents.filter((e) => WARN_SKIP_EVENTS.has(e));
+    return ctx.connector.hookEvents.filter((e) => !CRUSH_HOOK_EVENTS.includes(e)).map((event) => ({
+      event,
+      action: WARN_SKIP_EVENTS.has(event) ? "warn" : "skip"
+    }));
   }
   /**
    * Does this hook entry belong to this connector? Anchored on the home-bin +
@@ -485,4 +495,4 @@ export {
   adapter,
   crush_default as default
 };
-//# sourceMappingURL=crush-PP4HYZLT.js.map
+//# sourceMappingURL=crush-NYDBHIJE.js.map

package/dist/crush-NYDBHIJE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/crush/index.ts"],"sourcesContent":["/**\n * adapters/crush — Crush (Charm) platform adapter for agent-connector.\n *\n * Crush is a json-stdio host. A single JSON config file holds BOTH the MCP\n * server registrations and the hook registrations, and agent-connector MERGES\n * into it (never replaces it — unrelated keys are preserved verbatim):\n *   - User scope:    ~/.config/crush/crush.json\n *                    (Windows: %LOCALAPPDATA%\\crush\\crush.json)\n *   - Project scope: ./.crush.json  (preferred)  or  ./crush.json\n *\n * MCP servers live under the ROOT KEY \"mcp\" (NOT \"mcpServers\"). A stdio entry is\n *   { type:\"stdio\", command, args, env, timeout:120, disabled:false }.\n * Hooks live under the top-level \"hooks\" key. Crush supports PreToolUse ONLY;\n * the hook reads the host's JSON on stdin and writes a JSON object on stdout\n * carrying a `decision` field. A deny is `{ decision:\"deny\", reason }` on\n * stdout (exit 0); an allow is an empty stdout (exit 0). Crush cannot rewrite\n * tool args/output nor inject session context — every non-deny decision (and\n * every non-PreToolUse event) degrades to a silent allow.\n *\n * SECURITY NOTE: Crush expands `$(...)` command substitution in its config file\n * at load time. We therefore NEVER emit shell-substitution syntax into the\n * command/args/env we write — every value is a literal path/string built by the\n * spawn helpers (which quote, not interpolate). Connector ids are kebab-case and\n * the home-bin path is an absolute literal, so nothing we write can be coerced\n * into a `$(...)` substitution.\n */\n\nimport { existsSync, statSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nimport { BaseAdapter } from \"../base.js\";\nimport type { Adapter, HookReply, InstallContext, NormalizedEvent } from \"../spi.js\";\nimport type {\n  ChangeRecord,\n  DetectedPlatform,\n  HealthCheck,\n  HookEventName,\n  HookParadigm,\n  HookResponse,\n  PlatformCapabilities,\n  PlatformId,\n  PreToolUseEvent,\n  ServerDef,\n  Transport,\n} from \"../../core/types.js\";\nimport { resolveEnvRefsDeep } from \"../../core/interpolate.js\";\nimport { localAppData, xdgConfigHome } from \"../../core/host-paths.js\";\nimport {\n  buildHomeBinHookCommand,\n  buildWrappedStdio,\n  isHomeBinHookCommand,\n} from \"../../core/spawn.js\";\nimport { renderSkillMd } from \"../claude-code/render.js\";\n\nconst HOST: PlatformId = \"crush\";\n/** Crush registers MCP servers under \"mcp\" — NOT the \"mcpServers\" of Claude/Gemini. */\nconst MCP_ROOT_KEY = \"mcp\";\n/** Default per-server timeout (seconds) Crush expects on a stdio entry. */\nconst STDIO_TIMEOUT_SECONDS = 120;\n\n/**\n * Crush hook events agent-connector can register. Crush honors PreToolUse ONLY,\n * and only its deny decision is meaningful; every other normalized event has no\n * Crush equivalent and is skipped at install time.\n */\nconst CRUSH_HOOK_EVENTS = [\"PreToolUse\"] as const;\ntype CrushHookEventName = (typeof CRUSH_HOOK_EVENTS)[number];\n\n/**\n * Newer E1 canonical events with NO Crush analog (no permission-dialog,\n * tool-failure, or subagent lifecycle hook). Declared hooks for these warn-skip\n * (action `warn`, exit-1) — the established degradation convention. EVERY OTHER\n * unsupported event (the legacy SessionStart / Stop / … that previously vanished)\n * now reports a VISIBLE `skip` instead — see {@link CrushAdapter.declinedHookEvents}.\n * Nothing Crush cannot fire is ever silently dropped.\n */\nconst WARN_SKIP_EVENTS: ReadonlySet<HookEventName> = new Set([\n  \"PermissionRequest\",\n  \"PostToolUseFailure\",\n  \"SubagentStart\",\n  \"SubagentStop\",\n]);\n\n// ─────────────────────────────────────────────────────────────────────────\n// Native config shapes (only the parts we touch; rest preserved verbatim)\n// ─────────────────────────────────────────────────────────────────────────\n\n/** One hook registration entry as Crush stores it under top-level \"hooks\". */\ninterface CrushHookEntry {\n  matcher?: string;\n  command: string;\n  [key: string]: unknown;\n}\n\n/** Crush's crush.json shape — only the keys we read/merge. */\ninterface CrushConfigFile {\n  mcp?: Record<string, unknown>;\n  hooks?: Record<string, CrushHookEntry[]>;\n  [key: string]: unknown;\n}\n\n/** Native stdio MCP server entry under \"mcp\". */\ninterface CrushStdioServer {\n  type: \"stdio\";\n  command: string;\n  args: string[];\n  env?: Record<string, string>;\n  timeout: number;\n  disabled: boolean;\n}\n\n/** Native HTTP MCP server entry under \"mcp\". */\ninterface CrushHttpServer {\n  type: \"http\";\n  url: string;\n  headers?: Record<string, string>;\n  timeout: number;\n  disabled: boolean;\n}\n\n/** Raw Crush hook stdin payload (Claude-style: PascalCase event, snake_case fields). */\ninterface CrushHookInput {\n  tool_name?: string;\n  tool_input?: Record<string, unknown>;\n  session_id?: string;\n  cwd?: string;\n  hook_event_name?: string;\n  connector?: unknown;\n}\n\nexport class CrushAdapter extends BaseAdapter implements Adapter {\n  readonly id: PlatformId = HOST;\n  readonly name = \"Crush\";\n  readonly paradigm: HookParadigm = \"json-stdio\";\n\n  readonly capabilities: PlatformCapabilities = {\n    // Memory surface: AGENTS.md-first managed block via the BaseAdapter default\n    // (memoryTargets: project <projectDir>/AGENTS.md; user scope where documented).\n    supportsMemory: true,\n    // PreToolUse deny is the only hook decision Crush honors.\n    preToolUse: true,\n    postToolUse: false,\n    preCompact: false,\n    sessionStart: false,\n    sessionEnd: false,\n    userPromptSubmit: false,\n    stop: false,\n    notification: false,\n    // Newer events: Crush honors PreToolUse ONLY — no permission-dialog,\n    // tool-failure, or subagent lifecycle events exist, so permissionRequest /\n    // postToolUseFailure / subagentStart / subagentStop stay unset — install\n    // reports the standard skip-warn for them.\n    // Crush is deny-only: it cannot rewrite tool args/output nor inject context.\n    canModifyArgs: false,\n    canModifyOutput: false,\n    canInjectSessionContext: false,\n    transports: [\"stdio\", \"http\"],\n    // Content surface: Crush auto-discovers Agent-Skills dirs (dir-per-skill\n    // SKILL.md). Paths are HARD-CODED — no crush.json entry needed\n    // (charmbracelet/crush internal/config/load.go GlobalSkillsDirs +\n    // ProjectSkillsDir, fetched 2026-06-16):\n    //   project → <projectDir>/.crush/skills/<name>/SKILL.md (crush-native, in\n    //             projectSkillSubdirs; preferred over .agents/.claude/.cursor)\n    //   user    → ~/.config/crush/skills/<name>/SKILL.md (home.Config()/crush/\n    //             skills; XDG_CONFIG_HOME or ~/.config).\n    supportsSkills: true,\n  };\n\n  // ── Detection ────────────────────────────────────────────────────────────\n\n  detectInstalled(projectDir: string): DetectedPlatform {\n    const userDir = this.userConfigDir();\n    const userConfig = join(userDir, \"crush.json\");\n    const projectDot = join(projectDir, \".crush.json\");\n    const projectBare = join(projectDir, \"crush.json\");\n    const userInstalled = existsSync(userDir) || existsSync(userConfig);\n    const projInstalled = existsSync(projectDot) || existsSync(projectBare);\n    const installed = userInstalled || projInstalled;\n    // Report the scope/path that actually matched so a project-only install is\n    // not misreported as a (non-existent) user install.\n    const scope = projInstalled && !userInstalled ? \"project\" : \"user\";\n    const projectPath = existsSync(projectBare) && !existsSync(projectDot) ? projectBare : projectDot;\n    const configPath = scope === \"project\" ? projectPath : userConfig;\n    return {\n      id: this.id,\n      name: this.name,\n      installed,\n      paradigm: this.paradigm,\n      capabilities: this.capabilities,\n      configPath,\n      scope,\n      reason: installed\n        ? scope === \"project\"\n          ? `found project Crush config at ${configPath}`\n          : `found Crush config under ${userDir}`\n        : `no Crush config at ${userConfig}`,\n      confidence: installed ? \"high\" : \"low\",\n    };\n  }\n\n  // ── Native paths ─────────────────────────────────────────────────────────\n\n  getConfigDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\" ? ctx.projectDir : this.userConfigDir();\n  }\n\n  /** MCP servers and hooks share ONE crush.json file. */\n  getServerConfigPath(ctx: InstallContext): string {\n    if (ctx.scope === \"project\") {\n      // Prefer ./.crush.json, but MERGE into an existing ./crush.json if that is\n      // the file already present (so we don't fork the user's config in two).\n      const dot = join(ctx.projectDir, \".crush.json\");\n      const bare = join(ctx.projectDir, \"crush.json\");\n      if (existsSync(bare) && !existsSync(dot)) return bare;\n      return dot;\n    }\n    return join(this.userConfigDir(), \"crush.json\");\n  }\n\n  /** Hooks live in the SAME crush.json under the top-level \"hooks\" key. */\n  getHookConfigPath(ctx: InstallContext): string {\n    return this.getServerConfigPath(ctx);\n  }\n\n  /**\n   * Crush's user config dir, mirroring its own `home.Config()` resolution\n   * (charmbracelet/crush internal/home/home.go: `cmp.Or(XDG_CONFIG_HOME, ~/.config)`):\n   *   - Windows: %LOCALAPPDATA%\\crush  (Local; falls back to AppData/Local)\n   *   - macOS / Linux: $XDG_CONFIG_HOME/crush or ~/.config/crush\n   * (crush honors $XDG_CONFIG_HOME on Linux/macOS; the `xdgConfigHome()` helper\n   * is byte-identical to ~/.config when XDG is unset.)\n   */\n  private userConfigDir(): string {\n    if (process.platform === \"win32\") {\n      return join(localAppData(), \"crush\");\n    }\n    return join(xdgConfigHome(), \"crush\");\n  }\n\n  // ── MCP server install / uninstall (crush.json → mcp.<id>) ───────────────\n\n  installServer(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    const override = connector.platforms[HOST]?.server;\n    if (!connector.server || override === false) {\n      return [\n        {\n          platform: this.id,\n          action: \"skip\",\n          detail: connector.server\n            ? \"server registration disabled for crush\"\n            : \"connector declares no MCP server\",\n        },\n      ];\n    }\n\n    // Shallow-merge any per-platform server override into the base ServerDef.\n    const server: ServerDef =\n      override && typeof override === \"object\"\n        ? { ...connector.server, ...override }\n        : connector.server;\n\n    const serverPath = this.getServerConfigPath(ctx);\n    const entry = this.renderServerEntry(ctx, server);\n\n    return [\n      this.upsertServerInJson(serverPath, MCP_ROOT_KEY, connector.id, entry, ctx.dryRun),\n    ];\n  }\n\n  uninstallServer(ctx: InstallContext): ChangeRecord[] {\n    const serverPath = this.getServerConfigPath(ctx);\n    return [\n      this.removeServerFromJson(serverPath, MCP_ROOT_KEY, ctx.connector.id, ctx.dryRun),\n    ];\n  }\n\n  /**\n   * Render a normalized ServerDef into Crush's native \"mcp\" entry. Crush has no\n   * documented native `${env:VAR}` interpolation — and it expands `$(...)` at\n   * load time — so refs are resolved to LITERALS at install time (the safe\n   * posture for a host without native interpolation, matching Codex/Kimi).\n   */\n  private renderServerEntry(\n    ctx: InstallContext,\n    server: ServerDef,\n  ): CrushStdioServer | CrushHttpServer {\n    const transport: Transport = server.transport;\n    const disabled = server.enabled === false;\n\n    if (transport === \"stdio\") {\n      let command = server.command ?? \"\";\n      let args = [...(server.args ?? [])];\n\n      // Transparent telemetry wrapping: route the real command through\n      // `<homeBin> serve --connector <id> -- <command> <args...>`.\n      ({ command, args } = buildWrappedStdio(ctx, server, this.id, command, args));\n\n      // Resolve to literals — never emit `$(...)` Crush would expand at load.\n      command = resolveEnvRefsDeep(command);\n      args = resolveEnvRefsDeep(args);\n\n      const entry: CrushStdioServer = {\n        type: \"stdio\",\n        command,\n        args,\n        timeout: STDIO_TIMEOUT_SECONDS,\n        disabled,\n      };\n      const env = this.renderEnv(server.env);\n      if (env) entry.env = env;\n      return entry;\n    }\n\n    // http (and any other remote transport we surface) — Crush registers a URL.\n    const entry: CrushHttpServer = {\n      type: \"http\",\n      url: resolveEnvRefsDeep(server.url ?? \"\"),\n      timeout: STDIO_TIMEOUT_SECONDS,\n      disabled,\n    };\n    const headers = this.renderEnv(server.headers);\n    if (headers) entry.headers = headers;\n    return entry;\n  }\n\n  /** Resolve env/header values to literals (no native interpolation on Crush). */\n  private renderEnv(\n    env: Record<string, string> | undefined,\n  ): Record<string, string> | undefined {\n    if (!env || Object.keys(env).length === 0) return undefined;\n    const out: Record<string, string> = {};\n    for (const [k, v] of Object.entries(resolveEnvRefsDeep({ ...env }))) {\n      out[k] = String(v);\n    }\n    return out;\n  }\n\n  // ── Hook install / uninstall (crush.json → hooks.PreToolUse[]) ───────────\n\n  installHooks(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.hooks === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"hooks disabled for crush\" }];\n    }\n\n    const events = this.effectiveHookEvents(ctx);\n    const declined = this.declinedHookEvents(ctx);\n    const path = this.getHookConfigPath(ctx);\n\n    if (events.length === 0 && declined.length === 0) {\n      return [{ platform: this.id, action: \"skip\", path, detail: \"no hooks declared\" }];\n    }\n\n    const cfg = this.readJson<CrushConfigFile>(path) ?? {};\n    const __skip = this.malformedHookRootSkip(path, (cfg as Record<string, unknown>).hooks);\n    if (__skip) return [__skip];\n    const hooks = (cfg.hooks ??= {});\n\n    const changes: ChangeRecord[] = [];\n    let mutated = false;\n\n    // EVERY declared event Crush cannot fire is reported, never silently dropped.\n    // The 4 newer E1 events keep the established `warn` (exit-1); the legacy\n    // events (SessionStart, Stop, …) — silently dropped before this fix — surface\n    // as a VISIBLE `skip` so the install exit code is unchanged for them.\n    for (const { event, action } of declined) {\n      changes.push({\n        platform: this.id,\n        action,\n        path,\n        detail: `${event} has no Crush hook equivalent — skipped`,\n      });\n    }\n\n    for (const event of events) {\n      const command = buildHomeBinHookCommand(ctx.homeBinPath, HOST, event, connector.id);\n      const matcher = connector.hooks[event]?.matcher ?? \"\";\n      const entry: CrushHookEntry = { matcher, command };\n\n      const bucket = (hooks[event] ??= []);\n      const existingIdx = bucket.findIndex((e) => this.isOurHook(e, ctx));\n\n      if (existingIdx >= 0) {\n        if (JSON.stringify(bucket[existingIdx]) === JSON.stringify(entry)) {\n          changes.push({\n            platform: this.id,\n            action: \"skip\",\n            path,\n            detail: `hooks.${event} already registered`,\n          });\n          continue;\n        }\n        bucket[existingIdx] = entry;\n        changes.push({ platform: this.id, action: \"update\", path, detail: `hooks.${event}` });\n      } else {\n        bucket.push(entry);\n        changes.push({ platform: this.id, action: \"create\", path, detail: `hooks.${event}` });\n      }\n      mutated = true;\n    }\n\n    if (mutated) this.writeJson(path, cfg, ctx.dryRun);\n    return changes;\n  }\n\n  uninstallHooks(ctx: InstallContext): ChangeRecord[] {\n    const path = this.getHookConfigPath(ctx);\n    const cfg = this.readJson<CrushConfigFile>(path);\n    const hooks = cfg?.hooks;\n    if (!cfg || !hooks) {\n      return [\n        { platform: this.id, action: \"skip\", path, detail: \"no hooks section present\" },\n      ];\n    }\n\n    const changes: ChangeRecord[] = [];\n    let mutated = false;\n\n    for (const event of Object.keys(hooks)) {\n      const bucket = hooks[event];\n      if (!Array.isArray(bucket)) continue;\n\n      // Keep every entry that is NOT ours (anchored match) so a shared-prefix\n      // connector id — or the user's own hook — is never stripped.\n      const kept = bucket.filter((e) => !this.isOurHook(e, ctx));\n      const removed = bucket.length - kept.length;\n      if (removed > 0) {\n        if (kept.length > 0) hooks[event] = kept;\n        else delete hooks[event];\n        changes.push({\n          platform: this.id,\n          action: \"remove\",\n          path,\n          detail: `hooks.${event} (${removed})`,\n        });\n        mutated = true;\n      }\n    }\n\n    if (mutated) this.writeJson(path, cfg, ctx.dryRun);\n    if (changes.length === 0) {\n      changes.push({\n        platform: this.id,\n        action: \"skip\",\n        path,\n        detail: \"no matching hook entries\",\n      });\n    }\n    return changes;\n  }\n\n  // ── Internal helpers ─────────────────────────────────────────────────────\n\n  /** Which canonical hook events to register for Crush, honoring overrides. */\n  private effectiveHookEvents(ctx: InstallContext): CrushHookEventName[] {\n    if (ctx.connector.platforms[HOST]?.hooks === false) return [];\n    return CRUSH_HOOK_EVENTS.filter((e) => ctx.connector.hookEvents.includes(e));\n  }\n\n  /**\n   * Every declared event Crush has NO native equivalent for, tagged with the\n   * severity install reports it at — so a host that cannot fire an event is\n   * NEVER silent. The 4 newer E1 events ({@link WARN_SKIP_EVENTS}) keep `warn`\n   * (exit-1, the established convention); every other unsupported event (the\n   * legacy SessionStart / Stop / … that used to vanish) reports a visible\n   * `skip` (counted, but exit-0-preserving).\n   */\n  private declinedHookEvents(\n    ctx: InstallContext,\n  ): { event: HookEventName; action: \"warn\" | \"skip\" }[] {\n    if (ctx.connector.platforms[HOST]?.hooks === false) return [];\n    return ctx.connector.hookEvents\n      .filter((e) => !(CRUSH_HOOK_EVENTS as readonly string[]).includes(e))\n      .map((event) => ({\n        event,\n        action: WARN_SKIP_EVENTS.has(event) ? (\"warn\" as const) : (\"skip\" as const),\n      }));\n  }\n\n  /**\n   * Does this hook entry belong to this connector? Anchored on the home-bin +\n   * connector-id token (isHomeBinHookCommand) so uninstalling a shared-prefix\n   * connector id never strips a sibling's hook.\n   */\n  private isOurHook(entry: CrushHookEntry | undefined, ctx: InstallContext): boolean {\n    if (!entry || typeof entry !== \"object\") return false;\n    return isHomeBinHookCommand(entry.command, ctx.homeBinPath, ctx.connector.id);\n  }\n\n  // ── Content surface: skills (dir-per-skill SKILL.md) ─────────────────────\n  // CONTENT-ONLY: pure native-file writers, mirroring goose/openclaw. No\n  // runtime dispatch, no home-bin pointer, no telemetry wrap. Each write is\n  // idempotent (byte-identical → skip) via writeContentFile and reversible via\n  // removeContentFile + removeDirIfEmpty (never rm -rf a shared dir). Honors\n  // platforms[\"crush\"].skills === false. No crush.json entry is written — Crush\n  // auto-discovers these hard-coded dirs (load.go GlobalSkillsDirs/ProjectSkillsDir).\n  //\n  // Native locations (Agent-Skills spec — dir-per-skill SKILL.md + resources):\n  //   project → <projectDir>/.crush/skills/<name>/SKILL.md\n  //   user    → ~/.config/crush/skills/<name>/SKILL.md\n\n  /** The skills ROOT dir for ctx.scope (parent of every per-skill dir). */\n  private skillsDir(ctx: InstallContext): string {\n    return ctx.scope === \"project\"\n      ? join(ctx.projectDir, \".crush\", \"skills\")\n      : join(this.userConfigDir(), \"skills\");\n  }\n\n  /** Per-skill directory: <skillsDir>/<name>. */\n  private skillDir(ctx: InstallContext, name: string): string {\n    return join(this.skillsDir(ctx), name);\n  }\n\n  override installSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.platforms[HOST]?.skills === false) {\n      return [{ platform: this.id, action: \"skip\", detail: \"skills disabled for crush\" }];\n    }\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      // Guard a skills path occupied by a regular FILE (would throw ENOTDIR on\n      // mkdir): skip-warn rather than crash (the cline `.clinerules`-is-a-file\n      // precedent). The per-skill dir or any parent up to the scope root counts.\n      const blockingFile = firstFileOnPath(this.skillsDir(ctx), dir);\n      if (blockingFile !== null) {\n        changes.push({\n          platform: this.id,\n          action: \"warn\",\n          path: blockingFile,\n          detail: `${blockingFile} is a file, not a directory; skill \"${skill.name}\" skipped`,\n        });\n        continue;\n      }\n      changes.push(\n        this.writeContentFile(join(dir, \"SKILL.md\"), renderSkillMd(skill), ctx.dryRun),\n      );\n      // Bundle any resource files beside SKILL.md (relative path → contents).\n      // Defense-in-depth: skip+warn on any key that escapes the skill dir\n      // (config-time validation already rejects these, but never trust input).\n      for (const [rel, contents] of Object.entries(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) {\n          changes.push({\n            platform: this.id,\n            action: \"warn\",\n            detail: `skill resource \"${rel}\" escapes the skill dir; skipped`,\n          });\n          continue;\n        }\n        changes.push(this.writeContentFile(target, contents, ctx.dryRun));\n      }\n    }\n    return changes;\n  }\n\n  override uninstallSkills(ctx: InstallContext): ChangeRecord[] {\n    const { connector } = ctx;\n    if (connector.skills.length === 0) {\n      return [{ platform: this.id, action: \"skip\", detail: \"connector declares no skills\" }];\n    }\n    const changes: ChangeRecord[] = [];\n    for (const skill of connector.skills) {\n      const dir = this.skillDir(ctx, skill.name);\n      // Remove only the files we wrote (SKILL.md + declared resources), then the\n      // skill dir itself when we own its full contents.\n      changes.push(this.removeContentFile(join(dir, \"SKILL.md\"), ctx.dryRun));\n      for (const rel of Object.keys(skill.resources ?? {})) {\n        const target = this.resolveWithin(dir, rel);\n        if (target === null) continue; // never delete outside the skill dir\n        changes.push(this.removeContentFile(target, ctx.dryRun));\n      }\n      // Only remove the skill dir when WE own its full contents — never rm -rf a\n      // dir that still holds user-added / sibling-tool / shared files.\n      changes.push(this.removeDirIfEmpty(dir, ctx.dryRun));\n    }\n    return changes;\n  }\n\n  // ── Diagnostics ──────────────────────────────────────────────────────────\n\n  override getHealthChecks(ctx: InstallContext): readonly HealthCheck[] {\n    const configPath = this.getServerConfigPath(ctx);\n    const connectorId = ctx.connector.id;\n    const homeBin = ctx.homeBinPath;\n    const hookEvents = this.effectiveHookEvents(ctx);\n    return [\n      {\n        name: `${this.name}: crush.json present`,\n        check: () =>\n          existsSync(configPath)\n            ? { status: \"OK\", detail: configPath }\n            : { status: \"FAIL\", detail: `not found: ${configPath}` },\n      },\n      {\n        name: `${this.name}: mcp.${connectorId} registered`,\n        check: () => {\n          if (!ctx.connector.server) return { status: \"OK\", detail: \"no MCP server declared\" };\n          const cfg = this.readJson<CrushConfigFile>(configPath);\n          const bucket = cfg?.[MCP_ROOT_KEY];\n          const present =\n            typeof bucket === \"object\" && bucket !== null && connectorId in bucket;\n          return present\n            ? { status: \"OK\", detail: `mcp.${connectorId}` }\n            : { status: \"FAIL\", detail: `mcp.${connectorId} not found in ${configPath}` };\n        },\n      },\n      {\n        name: `${this.name}: hook command registered`,\n        check: () => {\n          if (hookEvents.length === 0) {\n            return { status: \"OK\", detail: \"no hooks declared\" };\n          }\n          const cfg = this.readJson<CrushConfigFile>(configPath);\n          if (!cfg) return { status: \"FAIL\", detail: `cannot read ${configPath}` };\n          const hooks = cfg.hooks ?? {};\n          const registered = Object.values(hooks).some((entries) =>\n            (entries ?? []).some((e) => isHomeBinHookCommand(e?.command, homeBin, connectorId)),\n          );\n          return registered\n            ? { status: \"OK\", detail: \"hook command present\" }\n            : { status: \"FAIL\", detail: `no hook for ${connectorId} in ${configPath}` };\n        },\n      },\n    ];\n  }\n\n  // ── Runtime: parse Crush stdin JSON → normalized event ───────────────────\n\n  parseEvent(event: HookEventName, raw: unknown): NormalizedEvent {\n    const input = (raw ?? {}) as CrushHookInput;\n    const connectorId = typeof input.connector === \"string\" ? input.connector : \"\";\n    const sessionId = typeof input.session_id === \"string\" ? input.session_id : \"\";\n    const projectDir = typeof input.cwd === \"string\" ? input.cwd : undefined;\n\n    const base = {\n      hostPlatform: HOST,\n      connectorId,\n      sessionId,\n      raw,\n      ...(projectDir !== undefined ? { projectDir } : {}),\n    } as const;\n\n    if (event === \"PreToolUse\") {\n      const ev: PreToolUseEvent = {\n        ...base,\n        toolName: input.tool_name ?? \"\",\n        toolInput: input.tool_input ?? {},\n      };\n      return ev;\n    }\n\n    // Crush only ever delivers PreToolUse. Surface anything else loudly rather\n    // than silently mis-parsing a payload the host cannot actually produce.\n    throw new Error(`unsupported crush hook event: ${String(event)}`);\n  }\n\n  // ── Runtime: normalized response → Crush native hook reply ───────────────\n\n  formatReply(event: HookEventName, response: HookResponse): HookReply {\n    const decision = response.decision ?? \"allow\";\n\n    // deny → Crush blocks the pending tool call via a stdout JSON object with a\n    // `decision:\"deny\"` (+ reason). Only PreToolUse is honored; every other\n    // event/decision degrades to a silent allow.\n    if (decision === \"deny\" && event === \"PreToolUse\") {\n      return this.stdout({\n        decision: \"deny\",\n        reason: response.reason ?? \"Blocked by hook\",\n      });\n    }\n\n    // allow / modify / context / ask / unsupported → pass through (exit 0, empty\n    // stdout). Crush cannot rewrite args/output or inject context, so those are\n    // dropped fail-open here (the deny path above is the only fail-safe lever).\n    return { exitCode: 0 };\n  }\n\n  private stdout(payload: unknown): HookReply {\n    return { exitCode: 0, stdout: JSON.stringify(payload) };\n  }\n}\n\n/**\n * Walk every path segment from `root` down to (and including) `leaf` and return\n * the FIRST one that exists as a regular file (which would make a mkdir for the\n * skill dir throw ENOTDIR), else null. Used to skip-warn instead of crashing\n * when a user has a `.crush/skills` file where we need a directory.\n */\nfunction firstFileOnPath(root: string, leaf: string): string | null {\n  const segments: string[] = [];\n  let cur = leaf;\n  while (cur.length >= root.length) {\n    segments.unshift(cur);\n    if (cur === root) break;\n    const parent = dirname(cur);\n    if (parent === cur) break;\n    cur = parent;\n  }\n  for (const p of segments) {\n    if (!existsSync(p)) return null; // nothing planted from here down\n    try {\n      if (statSync(p).isFile()) return p;\n    } catch {\n      return null;\n    }\n  }\n  return null;\n}\n\nexport const adapter = new CrushAdapter();\nexport default adapter;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,SAAS,YAAY,gBAAgB;AACrC,SAAS,SAAS,YAAY;AA0B9B,IAAM,OAAmB;AAEzB,IAAM,eAAe;AAErB,IAAM,wBAAwB;AAO9B,IAAM,oBAAoB,CAAC,YAAY;AAWvC,IAAM,mBAA+C,oBAAI,IAAI;AAAA,EAC3D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAiDM,IAAM,eAAN,cAA2B,YAA+B;AAAA,EACtD,KAAiB;AAAA,EACjB,OAAO;AAAA,EACP,WAAyB;AAAA,EAEzB,eAAqC;AAAA;AAAA;AAAA,IAG5C,gBAAgB;AAAA;AAAA,IAEhB,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,kBAAkB;AAAA,IAClB,MAAM;AAAA,IACN,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMd,eAAe;AAAA,IACf,iBAAiB;AAAA,IACjB,yBAAyB;AAAA,IACzB,YAAY,CAAC,SAAS,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAS5B,gBAAgB;AAAA,EAClB;AAAA;AAAA,EAIA,gBAAgB,YAAsC;AACpD,UAAM,UAAU,KAAK,cAAc;AACnC,UAAM,aAAa,KAAK,SAAS,YAAY;AAC7C,UAAM,aAAa,KAAK,YAAY,aAAa;AACjD,UAAM,cAAc,KAAK,YAAY,YAAY;AACjD,UAAM,gBAAgB,WAAW,OAAO,KAAK,WAAW,UAAU;AAClE,UAAM,gBAAgB,WAAW,UAAU,KAAK,WAAW,WAAW;AACtE,UAAM,YAAY,iBAAiB;AAGnC,UAAM,QAAQ,iBAAiB,CAAC,gBAAgB,YAAY;AAC5D,UAAM,cAAc,WAAW,WAAW,KAAK,CAAC,WAAW,UAAU,IAAI,cAAc;AACvF,UAAM,aAAa,UAAU,YAAY,cAAc;AACvD,WAAO;AAAA,MACL,IAAI,KAAK;AAAA,MACT,MAAM,KAAK;AAAA,MACX;AAAA,MACA,UAAU,KAAK;AAAA,MACf,cAAc,KAAK;AAAA,MACnB;AAAA,MACA;AAAA,MACA,QAAQ,YACJ,UAAU,YACR,iCAAiC,UAAU,KAC3C,4BAA4B,OAAO,KACrC,sBAAsB,UAAU;AAAA,MACpC,YAAY,YAAY,SAAS;AAAA,IACnC;AAAA,EACF;AAAA;AAAA,EAIA,aAAa,KAA6B;AACxC,WAAO,IAAI,UAAU,YAAY,IAAI,aAAa,KAAK,cAAc;AAAA,EACvE;AAAA;AAAA,EAGA,oBAAoB,KAA6B;AAC/C,QAAI,IAAI,UAAU,WAAW;AAG3B,YAAM,MAAM,KAAK,IAAI,YAAY,aAAa;AAC9C,YAAM,OAAO,KAAK,IAAI,YAAY,YAAY;AAC9C,UAAI,WAAW,IAAI,KAAK,CAAC,WAAW,GAAG,EAAG,QAAO;AACjD,aAAO;AAAA,IACT;AACA,WAAO,KAAK,KAAK,cAAc,GAAG,YAAY;AAAA,EAChD;AAAA;AAAA,EAGA,kBAAkB,KAA6B;AAC7C,WAAO,KAAK,oBAAoB,GAAG;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,gBAAwB;AAC9B,QAAI,QAAQ,aAAa,SAAS;AAChC,aAAO,KAAK,aAAa,GAAG,OAAO;AAAA,IACrC;AACA,WAAO,KAAK,cAAc,GAAG,OAAO;AAAA,EACtC;AAAA;AAAA,EAIA,cAAc,KAAqC;AACjD,UAAM,EAAE,UAAU,IAAI;AACtB,UAAM,WAAW,UAAU,UAAU,IAAI,GAAG;AAC5C,QAAI,CAAC,UAAU,UAAU,aAAa,OAAO;AAC3C,aAAO;AAAA,QACL;AAAA,UACE,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,QAAQ,UAAU,SACd,2CACA;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAGA,UAAM,SACJ,YAAY,OAAO,aAAa,WAC5B,EAAE,GAAG,UAAU,QAAQ,GAAG,SAAS,IACnC,UAAU;AAEhB,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,UAAM,QAAQ,KAAK,kBAAkB,KAAK,MAAM;AAEhD,WAAO;AAAA,MACL,KAAK,mBAAmB,YAAY,cAAc,UAAU,IAAI,OAAO,IAAI,MAAM;AAAA,IACnF;AAAA,EACF;AAAA,EAEA,gBAAgB,KAAqC;AACnD,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,WAAO;AAAA,MACL,KAAK,qBAAqB,YAAY,cAAc,IAAI,UAAU,IAAI,IAAI,MAAM;AAAA,IAClF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,kBACN,KACA,QACoC;AACpC,UAAM,YAAuB,OAAO;AACpC,UAAM,WAAW,OAAO,YAAY;AAEpC,QAAI,cAAc,SAAS;AACzB,UAAI,UAAU,OAAO,WAAW;AAChC,UAAI,OAAO,CAAC,GAAI,OAAO,QAAQ,CAAC,CAAE;AAIlC,OAAC,EAAE,SAAS,KAAK,IAAI,kBAAkB,KAAK,QAAQ,KAAK,IAAI,SAAS,IAAI;AAG1E,gBAAU,mBAAmB,OAAO;AACpC,aAAO,mBAAmB,IAAI;AAE9B,YAAMA,SAA0B;AAAA,QAC9B,MAAM;AAAA,QACN;AAAA,QACA;AAAA,QACA,SAAS;AAAA,QACT;AAAA,MACF;AACA,YAAM,MAAM,KAAK,UAAU,OAAO,GAAG;AACrC,UAAI,IAAK,CAAAA,OAAM,MAAM;AACrB,aAAOA;AAAA,IACT;AAGA,UAAM,QAAyB;AAAA,MAC7B,MAAM;AAAA,MACN,KAAK,mBAAmB,OAAO,OAAO,EAAE;AAAA,MACxC,SAAS;AAAA,MACT;AAAA,IACF;AACA,UAAM,UAAU,KAAK,UAAU,OAAO,OAAO;AAC7C,QAAI,QAAS,OAAM,UAAU;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA,EAGQ,UACN,KACoC;AACpC,QAAI,CAAC,OAAO,OAAO,KAAK,GAAG,EAAE,WAAW,EAAG,QAAO;AAClD,UAAM,MAA8B,CAAC;AACrC,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,mBAAmB,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG;AACnE,UAAI,CAAC,IAAI,OAAO,CAAC;AAAA,IACnB;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAIA,aAAa,KAAqC;AAChD,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,UAAU,IAAI,GAAG,UAAU,OAAO;AAC9C,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,2BAA2B,CAAC;AAAA,IACnF;AAEA,UAAM,SAAS,KAAK,oBAAoB,GAAG;AAC3C,UAAM,WAAW,KAAK,mBAAmB,GAAG;AAC5C,UAAM,OAAO,KAAK,kBAAkB,GAAG;AAEvC,QAAI,OAAO,WAAW,KAAK,SAAS,WAAW,GAAG;AAChD,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,MAAM,QAAQ,oBAAoB,CAAC;AAAA,IAClF;AAEA,UAAM,MAAM,KAAK,SAA0B,IAAI,KAAK,CAAC;AACrD,UAAM,SAAS,KAAK,sBAAsB,MAAO,IAAgC,KAAK;AACtF,QAAI,OAAQ,QAAO,CAAC,MAAM;AAC1B,UAAM,QAAS,IAAI,UAAU,CAAC;AAE9B,UAAM,UAA0B,CAAC;AACjC,QAAI,UAAU;AAMd,eAAW,EAAE,OAAO,OAAO,KAAK,UAAU;AACxC,cAAQ,KAAK;AAAA,QACX,UAAU,KAAK;AAAA,QACf;AAAA,QACA;AAAA,QACA,QAAQ,GAAG,KAAK;AAAA,MAClB,CAAC;AAAA,IACH;AAEA,eAAW,SAAS,QAAQ;AAC1B,YAAM,UAAU,wBAAwB,IAAI,aAAa,MAAM,OAAO,UAAU,EAAE;AAClF,YAAM,UAAU,UAAU,MAAM,KAAK,GAAG,WAAW;AACnD,YAAM,QAAwB,EAAE,SAAS,QAAQ;AAEjD,YAAM,SAAU,MAAM,KAAK,MAAM,CAAC;AAClC,YAAM,cAAc,OAAO,UAAU,CAAC,MAAM,KAAK,UAAU,GAAG,GAAG,CAAC;AAElE,UAAI,eAAe,GAAG;AACpB,YAAI,KAAK,UAAU,OAAO,WAAW,CAAC,MAAM,KAAK,UAAU,KAAK,GAAG;AACjE,kBAAQ,KAAK;AAAA,YACX,UAAU,KAAK;AAAA,YACf,QAAQ;AAAA,YACR;AAAA,YACA,QAAQ,SAAS,KAAK;AAAA,UACxB,CAAC;AACD;AAAA,QACF;AACA,eAAO,WAAW,IAAI;AACtB,gBAAQ,KAAK,EAAE,UAAU,KAAK,IAAI,QAAQ,UAAU,MAAM,QAAQ,SAAS,KAAK,GAAG,CAAC;AAAA,MACtF,OAAO;AACL,eAAO,KAAK,KAAK;AACjB,gBAAQ,KAAK,EAAE,UAAU,KAAK,IAAI,QAAQ,UAAU,MAAM,QAAQ,SAAS,KAAK,GAAG,CAAC;AAAA,MACtF;AACA,gBAAU;AAAA,IACZ;AAEA,QAAI,QAAS,MAAK,UAAU,MAAM,KAAK,IAAI,MAAM;AACjD,WAAO;AAAA,EACT;AAAA,EAEA,eAAe,KAAqC;AAClD,UAAM,OAAO,KAAK,kBAAkB,GAAG;AACvC,UAAM,MAAM,KAAK,SAA0B,IAAI;AAC/C,UAAM,QAAQ,KAAK;AACnB,QAAI,CAAC,OAAO,CAAC,OAAO;AAClB,aAAO;AAAA,QACL,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,MAAM,QAAQ,2BAA2B;AAAA,MAChF;AAAA,IACF;AAEA,UAAM,UAA0B,CAAC;AACjC,QAAI,UAAU;AAEd,eAAW,SAAS,OAAO,KAAK,KAAK,GAAG;AACtC,YAAM,SAAS,MAAM,KAAK;AAC1B,UAAI,CAAC,MAAM,QAAQ,MAAM,EAAG;AAI5B,YAAM,OAAO,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,UAAU,GAAG,GAAG,CAAC;AACzD,YAAM,UAAU,OAAO,SAAS,KAAK;AACrC,UAAI,UAAU,GAAG;AACf,YAAI,KAAK,SAAS,EAAG,OAAM,KAAK,IAAI;AAAA,YAC/B,QAAO,MAAM,KAAK;AACvB,gBAAQ,KAAK;AAAA,UACX,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR;AAAA,UACA,QAAQ,SAAS,KAAK,KAAK,OAAO;AAAA,QACpC,CAAC;AACD,kBAAU;AAAA,MACZ;AAAA,IACF;AAEA,QAAI,QAAS,MAAK,UAAU,MAAM,KAAK,IAAI,MAAM;AACjD,QAAI,QAAQ,WAAW,GAAG;AACxB,cAAQ,KAAK;AAAA,QACX,UAAU,KAAK;AAAA,QACf,QAAQ;AAAA,QACR;AAAA,QACA,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA,EAKQ,oBAAoB,KAA2C;AACrE,QAAI,IAAI,UAAU,UAAU,IAAI,GAAG,UAAU,MAAO,QAAO,CAAC;AAC5D,WAAO,kBAAkB,OAAO,CAAC,MAAM,IAAI,UAAU,WAAW,SAAS,CAAC,CAAC;AAAA,EAC7E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,mBACN,KACqD;AACrD,QAAI,IAAI,UAAU,UAAU,IAAI,GAAG,UAAU,MAAO,QAAO,CAAC;AAC5D,WAAO,IAAI,UAAU,WAClB,OAAO,CAAC,MAAM,CAAE,kBAAwC,SAAS,CAAC,CAAC,EACnE,IAAI,CAAC,WAAW;AAAA,MACf;AAAA,MACA,QAAQ,iBAAiB,IAAI,KAAK,IAAK,SAAoB;AAAA,IAC7D,EAAE;AAAA,EACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,UAAU,OAAmC,KAA8B;AACjF,QAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,WAAO,qBAAqB,MAAM,SAAS,IAAI,aAAa,IAAI,UAAU,EAAE;AAAA,EAC9E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeQ,UAAU,KAA6B;AAC7C,WAAO,IAAI,UAAU,YACjB,KAAK,IAAI,YAAY,UAAU,QAAQ,IACvC,KAAK,KAAK,cAAc,GAAG,QAAQ;AAAA,EACzC;AAAA;AAAA,EAGQ,SAAS,KAAqB,MAAsB;AAC1D,WAAO,KAAK,KAAK,UAAU,GAAG,GAAG,IAAI;AAAA,EACvC;AAAA,EAES,cAAc,KAAqC;AAC1D,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,UAAU,IAAI,GAAG,WAAW,OAAO;AAC/C,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,4BAA4B,CAAC;AAAA,IACpF;AACA,QAAI,UAAU,OAAO,WAAW,GAAG;AACjC,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,+BAA+B,CAAC;AAAA,IACvF;AACA,UAAM,UAA0B,CAAC;AACjC,eAAW,SAAS,UAAU,QAAQ;AACpC,YAAM,MAAM,KAAK,SAAS,KAAK,MAAM,IAAI;AAIzC,YAAM,eAAe,gBAAgB,KAAK,UAAU,GAAG,GAAG,GAAG;AAC7D,UAAI,iBAAiB,MAAM;AACzB,gBAAQ,KAAK;AAAA,UACX,UAAU,KAAK;AAAA,UACf,QAAQ;AAAA,UACR,MAAM;AAAA,UACN,QAAQ,GAAG,YAAY,uCAAuC,MAAM,IAAI;AAAA,QAC1E,CAAC;AACD;AAAA,MACF;AACA,cAAQ;AAAA,QACN,KAAK,iBAAiB,KAAK,KAAK,UAAU,GAAG,cAAc,KAAK,GAAG,IAAI,MAAM;AAAA,MAC/E;AAIA,iBAAW,CAAC,KAAK,QAAQ,KAAK,OAAO,QAAQ,MAAM,aAAa,CAAC,CAAC,GAAG;AACnE,cAAM,SAAS,KAAK,cAAc,KAAK,GAAG;AAC1C,YAAI,WAAW,MAAM;AACnB,kBAAQ,KAAK;AAAA,YACX,UAAU,KAAK;AAAA,YACf,QAAQ;AAAA,YACR,QAAQ,mBAAmB,GAAG;AAAA,UAChC,CAAC;AACD;AAAA,QACF;AACA,gBAAQ,KAAK,KAAK,iBAAiB,QAAQ,UAAU,IAAI,MAAM,CAAC;AAAA,MAClE;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAES,gBAAgB,KAAqC;AAC5D,UAAM,EAAE,UAAU,IAAI;AACtB,QAAI,UAAU,OAAO,WAAW,GAAG;AACjC,aAAO,CAAC,EAAE,UAAU,KAAK,IAAI,QAAQ,QAAQ,QAAQ,+BAA+B,CAAC;AAAA,IACvF;AACA,UAAM,UAA0B,CAAC;AACjC,eAAW,SAAS,UAAU,QAAQ;AACpC,YAAM,MAAM,KAAK,SAAS,KAAK,MAAM,IAAI;AAGzC,cAAQ,KAAK,KAAK,kBAAkB,KAAK,KAAK,UAAU,GAAG,IAAI,MAAM,CAAC;AACtE,iBAAW,OAAO,OAAO,KAAK,MAAM,aAAa,CAAC,CAAC,GAAG;AACpD,cAAM,SAAS,KAAK,cAAc,KAAK,GAAG;AAC1C,YAAI,WAAW,KAAM;AACrB,gBAAQ,KAAK,KAAK,kBAAkB,QAAQ,IAAI,MAAM,CAAC;AAAA,MACzD;AAGA,cAAQ,KAAK,KAAK,iBAAiB,KAAK,IAAI,MAAM,CAAC;AAAA,IACrD;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAIS,gBAAgB,KAA6C;AACpE,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,UAAM,cAAc,IAAI,UAAU;AAClC,UAAM,UAAU,IAAI;AACpB,UAAM,aAAa,KAAK,oBAAoB,GAAG;AAC/C,WAAO;AAAA,MACL;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MACL,WAAW,UAAU,IACjB,EAAE,QAAQ,MAAM,QAAQ,WAAW,IACnC,EAAE,QAAQ,QAAQ,QAAQ,cAAc,UAAU,GAAG;AAAA,MAC7D;AAAA,MACA;AAAA,QACE,MAAM,GAAG,KAAK,IAAI,SAAS,WAAW;AAAA,QACtC,OAAO,MAAM;AACX,cAAI,CAAC,IAAI,UAAU,OAAQ,QAAO,EAAE,QAAQ,MAAM,QAAQ,yBAAyB;AACnF,gBAAM,MAAM,KAAK,SAA0B,UAAU;AACrD,gBAAM,SAAS,MAAM,YAAY;AACjC,gBAAM,UACJ,OAAO,WAAW,YAAY,WAAW,QAAQ,eAAe;AAClE,iBAAO,UACH,EAAE,QAAQ,MAAM,QAAQ,OAAO,WAAW,GAAG,IAC7C,EAAE,QAAQ,QAAQ,QAAQ,OAAO,WAAW,iBAAiB,UAAU,GAAG;AAAA,QAChF;AAAA,MACF;AAAA,MACA;AAAA,QACE,MAAM,GAAG,KAAK,IAAI;AAAA,QAClB,OAAO,MAAM;AACX,cAAI,WAAW,WAAW,GAAG;AAC3B,mBAAO,EAAE,QAAQ,MAAM,QAAQ,oBAAoB;AAAA,UACrD;AACA,gBAAM,MAAM,KAAK,SAA0B,UAAU;AACrD,cAAI,CAAC,IAAK,QAAO,EAAE,QAAQ,QAAQ,QAAQ,eAAe,UAAU,GAAG;AACvE,gBAAM,QAAQ,IAAI,SAAS,CAAC;AAC5B,gBAAM,aAAa,OAAO,OAAO,KAAK,EAAE;AAAA,YAAK,CAAC,aAC3C,WAAW,CAAC,GAAG,KAAK,CAAC,MAAM,qBAAqB,GAAG,SAAS,SAAS,WAAW,CAAC;AAAA,UACpF;AACA,iBAAO,aACH,EAAE,QAAQ,MAAM,QAAQ,uBAAuB,IAC/C,EAAE,QAAQ,QAAQ,QAAQ,eAAe,WAAW,OAAO,UAAU,GAAG;AAAA,QAC9E;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA,EAIA,WAAW,OAAsB,KAA+B;AAC9D,UAAM,QAAS,OAAO,CAAC;AACvB,UAAM,cAAc,OAAO,MAAM,cAAc,WAAW,MAAM,YAAY;AAC5E,UAAM,YAAY,OAAO,MAAM,eAAe,WAAW,MAAM,aAAa;AAC5E,UAAM,aAAa,OAAO,MAAM,QAAQ,WAAW,MAAM,MAAM;AAE/D,UAAM,OAAO;AAAA,MACX,cAAc;AAAA,MACd;AAAA,MACA;AAAA,MACA;AAAA,MACA,GAAI,eAAe,SAAY,EAAE,WAAW,IAAI,CAAC;AAAA,IACnD;AAEA,QAAI,UAAU,cAAc;AAC1B,YAAM,KAAsB;AAAA,QAC1B,GAAG;AAAA,QACH,UAAU,MAAM,aAAa;AAAA,QAC7B,WAAW,MAAM,cAAc,CAAC;AAAA,MAClC;AACA,aAAO;AAAA,IACT;AAIA,UAAM,IAAI,MAAM,iCAAiC,OAAO,KAAK,CAAC,EAAE;AAAA,EAClE;AAAA;AAAA,EAIA,YAAY,OAAsB,UAAmC;AACnE,UAAM,WAAW,SAAS,YAAY;AAKtC,QAAI,aAAa,UAAU,UAAU,cAAc;AACjD,aAAO,KAAK,OAAO;AAAA,QACjB,UAAU;AAAA,QACV,QAAQ,SAAS,UAAU;AAAA,MAC7B,CAAC;AAAA,IACH;AAKA,WAAO,EAAE,UAAU,EAAE;AAAA,EACvB;AAAA,EAEQ,OAAO,SAA6B;AAC1C,WAAO,EAAE,UAAU,GAAG,QAAQ,KAAK,UAAU,OAAO,EAAE;AAAA,EACxD;AACF;AAQA,SAAS,gBAAgB,MAAc,MAA6B;AAClE,QAAM,WAAqB,CAAC;AAC5B,MAAI,MAAM;AACV,SAAO,IAAI,UAAU,KAAK,QAAQ;AAChC,aAAS,QAAQ,GAAG;AACpB,QAAI,QAAQ,KAAM;AAClB,UAAM,SAAS,QAAQ,GAAG;AAC1B,QAAI,WAAW,IAAK;AACpB,UAAM;AAAA,EACR;AACA,aAAW,KAAK,UAAU;AACxB,QAAI,CAAC,WAAW,CAAC,EAAG,QAAO;AAC3B,QAAI;AACF,UAAI,SAAS,CAAC,EAAE,OAAO,EAAG,QAAO;AAAA,IACnC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEO,IAAM,UAAU,IAAI,aAAa;AACxC,IAAO,gBAAQ;","names":["entry"]}

package/dist/{cursor-XMXOZKAP.js → cursor-AOELDNZU.js}

@@ -5,13 +5,13 @@ import {
   CursorAdapter,
   adapter,
   cursor_default
-} from "./chunk-ZSMGHEB5.js";
+} from "./chunk-NBUEL74R.js";
 import "./chunk-H53QZQJI.js";
-import "./chunk-DBQMX75U.js";
-import "./chunk-RHML2NOB.js";
-import "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
-import "./chunk-2HCJV6UO.js";
+import "./chunk-BEFVJ2OE.js";
+import "./chunk-VVFDU4IX.js";
+import "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
+import "./chunk-IXOQDZWC.js";
 export {
   CURSOR_EVENT_MAP,
   CURSOR_HOOKS_VERSION,
@@ -19,4 +19,4 @@ export {
   adapter,
   cursor_default as default
 };
-//# sourceMappingURL=cursor-XMXOZKAP.js.map
+//# sourceMappingURL=cursor-AOELDNZU.js.map

package/dist/{detect-IZOWP5AA.js → detect-ALAKE54S.js}

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import {
   print
-} from "./chunk-NXR4HM5N.js";
+} from "./chunk-VKRGQLY4.js";
 import {
   detectInstalledPlatforms
-} from "./chunk-GCRRX4MO.js";
-import "./chunk-LS65GL2P.js";
+} from "./chunk-S4E6QQEM.js";
+import "./chunk-X457NOFE.js";
 
 // src/cli/commands/detect.ts
 import { parseArgs } from "util";
@@ -71,4 +71,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=detect-IZOWP5AA.js.map
+//# sourceMappingURL=detect-ALAKE54S.js.map

package/dist/{doctor-5IVUQ2YH.js → doctor-UNF7FCF4.js}

@@ -2,18 +2,18 @@
 import {
   marketplaceDoctorChecks,
   syncConnector
-} from "./chunk-IZ4XQ23W.js";
-import "./chunk-ZEFUDBTY.js";
+} from "./chunk-VD4EG6SG.js";
+import "./chunk-UYZ53KWS.js";
 import {
   readMarketplaceInstalls
-} from "./chunk-AXAHW2KU.js";
-import "./chunk-ZSMGHEB5.js";
+} from "./chunk-QKLJU4JX.js";
+import "./chunk-NBUEL74R.js";
 import {
   fail,
   parseScope,
   parseTargets,
   print
-} from "./chunk-NXR4HM5N.js";
+} from "./chunk-VKRGQLY4.js";
 import {
   LineBuffer,
   idKey,
@@ -21,36 +21,42 @@ import {
 } from "./chunk-OP4KBXUO.js";
 import {
   spawnChild
-} from "./chunk-7QRUZAUG.js";
+} from "./chunk-LN76OGNR.js";
 import {
   detectInstalledPlatforms
-} from "./chunk-GCRRX4MO.js";
+} from "./chunk-S4E6QQEM.js";
+import {
+  explainHooks
+} from "./chunk-YJP3KGLM.js";
+import "./chunk-ZXX5DVSE.js";
+import "./chunk-4FWETID5.js";
 import "./chunk-KHO5WNTP.js";
+import "./chunk-AMK2K6XZ.js";
 import {
   findConnectorConfig,
   listRegisteredConnectors,
   loadConnectorFromPath,
   readRegisteredMeta
-} from "./chunk-RQCBBLTA.js";
+} from "./chunk-7NXEHZAK.js";
 import {
   MCP_PROTOCOL_VERSION
-} from "./chunk-UVBAH263.js";
+} from "./chunk-PZHB5TVA.js";
 import {
   REGISTERED_PLATFORM_IDS,
   loadAdapter
-} from "./chunk-LS65GL2P.js";
-import "./chunk-7CZKXXBD.js";
+} from "./chunk-X457NOFE.js";
+import "./chunk-56R2ER7K.js";
 import "./chunk-OPXAP3AC.js";
 import "./chunk-UM5S7DKK.js";
 import "./chunk-H53QZQJI.js";
-import "./chunk-DBQMX75U.js";
-import "./chunk-RHML2NOB.js";
-import "./chunk-TO57WYBB.js";
-import "./chunk-ALVXORZM.js";
+import "./chunk-BEFVJ2OE.js";
+import "./chunk-VVFDU4IX.js";
+import "./chunk-HORHRHNG.js";
+import "./chunk-YYNXIUR2.js";
 import {
   dataRoot,
   homeBinPath
-} from "./chunk-2HCJV6UO.js";
+} from "./chunk-IXOQDZWC.js";
 
 // src/cli/commands/doctor.ts
 import { parseArgs } from "util";
@@ -232,7 +238,11 @@ var STATUS_GLYPH = {
   fail: "[FAIL]"
 };
 async function resolveDoctorConnectors(connectorPath, projectDir) {
-  const configPath = connectorPath ?? findConnectorConfig(projectDir);
+  if (connectorPath !== void 0) {
+    const { connector, modulePath } = await loadConnectorFromPath(connectorPath);
+    return [{ connector, modulePath }];
+  }
+  const configPath = findConnectorConfig(projectDir);
   if (configPath) {
     try {
       const { connector, modulePath } = await loadConnectorFromPath(configPath);
@@ -342,6 +352,68 @@ async function collectDiagnostics(entries, ids, scope, projectDir) {
   }
   return { byPlatform, tagged, anyFail };
 }
+var VERDICT_GLYPH = {
+  honored: "[honored]",
+  degraded: "[degraded]",
+  dropped: "[dropped]"
+};
+function explainHostsFor(connector, explicit) {
+  if (explicit && explicit.length > 0) {
+    return explicit.filter((id) => REGISTERED_PLATFORM_IDS.has(id));
+  }
+  if (connector.targets !== "auto") {
+    return connector.targets.filter(
+      (id) => REGISTERED_PLATFORM_IDS.has(id)
+    );
+  }
+  return [...REGISTERED_PLATFORM_IDS].sort();
+}
+function explainConnectorFails(rows, scoped) {
+  if (!scoped) return false;
+  return rows.some((row) => row.verdict === "degraded");
+}
+async function runExplain(entries, explicit, json) {
+  const report = [];
+  for (const { connector } of entries) {
+    const scoped = explicit != null && explicit.length > 0 || connector.targets !== "auto";
+    if (connector.hookEvents.length === 0) {
+      report.push({ connector: connector.id, rows: [], scoped });
+      continue;
+    }
+    const hosts = explainHostsFor(connector, explicit);
+    const rows = await explainHooks(connector, hosts);
+    report.push({ connector: connector.id, rows, scoped });
+  }
+  const anyFail = report.some((r) => explainConnectorFails(r.rows, r.scoped));
+  if (json) {
+    print(JSON.stringify(report.map(({ connector, rows }) => ({ connector, rows })), null, 2));
+    return anyFail ? 1 : 0;
+  }
+  for (const { connector, rows } of report) {
+    print(`${connector} \u2014 per-event hook honor:`);
+    if (rows.length === 0) {
+      print("  (connector declares no hooks)");
+      print("");
+      continue;
+    }
+    for (const row of rows) {
+      print(`  ${VERDICT_GLYPH[row.verdict]} ${row.host} / ${row.event} \u2014 ${row.reason}`);
+    }
+    print("");
+  }
+  if (anyFail) {
+    print(
+      "doctor --explain: a declared hook event is DEGRADED on an explicitly-targeted host (the host fires it but silently won't honor the reply)."
+    );
+  } else if (report.some((r) => r.rows.some((row) => row.verdict !== "honored"))) {
+    print(
+      "doctor --explain: some hosts drop or degrade declared events (expected for mcp-only / fleet-wide gaps) \u2014 informational, exit 0."
+    );
+  } else {
+    print("doctor --explain: every declared hook event is honored on its target hosts.");
+  }
+  return anyFail ? 1 : 0;
+}
 async function run(argv) {
   const { values } = parseArgs({
     args: argv,
@@ -353,6 +425,7 @@ async function run(argv) {
       json: { type: "boolean", default: false },
       probe: { type: "boolean", default: false },
       heal: { type: "boolean", default: false },
+      explain: { type: "boolean", default: false },
       "dry-run": { type: "boolean", default: false }
     },
     allowPositionals: false
@@ -360,8 +433,17 @@ 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 entries = await resolveDoctorConnectors(values.connector, projectDir);
+  const resolved = await resolveDoctorConnectors(values.connector, projectDir).catch(
+    (err) => ({
+      error: `cannot load connector "${values.connector}": ${err instanceof Error ? err.message : String(err)}`
+    })
+  );
+  if ("error" in resolved) return fail(resolved.error);
+  const entries = resolved;
   const connectors = entries.map((e) => e.connector);
+  if (values.explain) {
+    return runExplain(entries, parseTargets(values.targets), values.json ?? false);
+  }
   const explicit = parseTargets(values.targets);
   let ids;
   if (explicit && explicit.length > 0) {
@@ -541,4 +623,4 @@ async function run(argv) {
 export {
   run
 };
-//# sourceMappingURL=doctor-5IVUQ2YH.js.map
+//# sourceMappingURL=doctor-UNF7FCF4.js.map