@cleocode/adapters 2026.10.3 → 2026.10.5-rc.ci.672

package/dist/providers/claude-code/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,kCAAkC;IAClC,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA6B/B;IAEF,8DAA8D;IAC9D,KAAK,EAAE,sBAAsB,CAAC;IAC9B;;;;;;OAMG;IACH,KAAK,EAAE,oBAAoB,CAAC;IAC5B,+EAA+E;IAC/E,OAAO,EAAE,yBAAyB,CAAC;IACnC,mEAAmE;IACnE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,EAAE,gCAAgC,CAAC;IACjD,wDAAwD;IACxD,SAAS,EAAE,2BAA2B,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,EAAE,0BAA0B,CAAC;IAErC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAY5B;;;;;;;;OAQG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAuCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,kCAAkC;IAClC,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAE3B,+CAA+C;IAC/C,YAAY,EAAE,mBAAmB,CA6B/B;IAEF,8DAA8D;IAC9D,KAAK,EAAE,sBAAsB,CAAC;IAC9B;;;;;;OAMG;IACH,KAAK,EAAE,oBAAoB,CAAC;IAC5B,+EAA+E;IAC/E,OAAO,EAAE,yBAAyB,CAAC;IACnC,mEAAmE;IACnE,KAAK,EAAE,sBAAsB,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,EAAE,gCAAgC,CAAC;IACjD,wDAAwD;IACxD,SAAS,EAAE,2BAA2B,CAAC;IACvC,2EAA2E;IAC3E,QAAQ,EAAE,0BAA0B,CAAC;IAErC,oEAAoE;IACpE,OAAO,CAAC,UAAU,CAAuB;IACzC,kDAAkD;IAClD,OAAO,CAAC,WAAW,CAAS;;IAY5B;;;;;;;;OAQG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCnD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ9B;;;;;;;;;OASG;IACG,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAuCjD;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;CAG/B"}

package/dist/providers/claude-code/hooks.d.ts

@@ -16,11 +16,23 @@
  * @epic T134
  */
 import type { AdapterHookProvider } from '@cleocode/contracts';
+/** The `Stop` hook command: end the CLEO session when Claude Code stops. */
+export declare const NATIVE_STOP_HOOK_COMMAND = "cleo session end --quiet # cleo-hook";
+/** The `PostToolUse` (`Write|Edit`) hook command: a brain observation per file write. */
+export declare const NATIVE_OBSERVE_HOOK_COMMAND = "cleo observe \"File modified via $TOOL_NAME\" --title \"tool-use\" --quiet # cleo-hook";
+/**
+ * The `PostToolUse` (`Write|Edit`) NEXUS post-check: re-index changed files and
+ * flag regressions. `$TOOL_INPUT_file_path` is populated by Claude Code for
+ * Write/Edit events.
+ */
+export declare const NATIVE_NEXUS_HOOK_COMMAND = "cleo nexus analyze --incremental --json > /dev/null 2>&1 && cleo observe \"NEXUS re-indexed after $TOOL_NAME on $TOOL_INPUT_file_path\" --title \"nexus-post-check\" --quiet # cleo-hook";
 /**
  * Hook provider for Claude Code.
  *
- * Claude Code registers hooks via its global config at `~/.claude/settings.json`.
- * Supported handler types: command, http, prompt, agent.
+ * CLEO registers its Claude Code hooks in the project's per-machine
+ * `<project>/.claude/settings.local.json`, never in the user-global
+ * `~/.claude/settings.json` (T13227). Supported handler types: command, http,
+ * prompt, agent.
  *
  * Event mapping is based on `getProviderHookProfile('claude-code')` from
  * CAAMP 1.9.1. Async accessors (`getSupportedCanonicalEvents`,
@@ -60,45 +72,59 @@ export declare class ClaudeCodeHookProvider implements AdapterHookProvider {
     /**
      * Register native hooks for a project.
      *
-     * Writes CLEO hook entries to `~/.claude/settings.json` so that Claude Code's
-     * native event system calls cleo CLI commands when events fire. This bridges
-     * Claude Code's event loop to CLEO's internal hook dispatch.
+     * Writes CLEO hook entries to the project's per-machine
+     * `<project>/.claude/settings.local.json` so that Claude Code's native event
+     * system calls cleo CLI commands when events fire in this project. This
+     * bridges Claude Code's event loop to CLEO's internal hook dispatch.
+     * CLEO never writes the user-global `~/.claude/settings.json` (T13227): a
+     * project that is the home directory, or whose settings file resolves into
+     * the user-global Claude config, is refused and nothing is written. When
+     * git does not ignore `settings.local.json` yet, a marked `info/exclude`
+     * block keeps it out of git (the T12983 heavy-command rule).
      *
-     * Idempotent: skips writing if CLEO hooks already exist in settings.json.
+     * Idempotent: skips writing if the native hooks are already present.
      *
      * Hook entries registered:
      * - `Stop` → `cleo session end --quiet` (triggers LLM extraction, reflector, consolidation)
      * - `PostToolUse` (Write|Edit) → brain observation for file modifications
-     * - `SubagentStop` → brain observation for agent completion
+     *   and the NEXUS post-check
      *
-     * @param projectDir - Project directory for context-scoped hook commands
-     * @task T164 @task T555
+     * @param projectDir - Project whose Claude Code settings receive the hooks
+     * @task T164 @task T555 @task T13227
      */
     registerNativeHooks(projectDir: string): Promise<void>;
     /**
      * Unregister native hooks.
      *
-     * Removes CLEO hook entries from Claude Code's `settings.json` by filtering
-     * out entries containing the `# cleo-hook` marker. Same locking, atomicity
-     * and parse-error rules as {@link registerNativeHooks}.
+     * Removes the hook objects {@link registerNativeHooks} wrote from the
+     * project's `settings.local.json`, and nothing else: the heavy-command hook
+     * and the user's own hooks stay, and an entry or event is dropped only when
+     * left empty. Same locking, atomicity, parse-error and project-scope rules
+     * as {@link registerNativeHooks}.
      *
-     * @task T164 @task T555
+     * @task T164 @task T555 @task T13227
      */
     unregisterNativeHooks(): Promise<void>;
     /** The last settings.json failure, or `null` when the last update succeeded. */
     private settingsError;
     /**
-     * Why the last settings.json update did not happen, or `null`.
+     * Why the last settings update did not happen, or `null`.
      *
      * @remarks
      * Hook registration stays non-fatal for adapter initialisation, so a
-     * refused write (malformed settings.json, lock timeout) is surfaced here and
-     * on stderr instead of being swallowed (T12385).
+     * refused write (malformed settings file, lock timeout, a user-global
+     * target) is surfaced here and on stderr instead of being swallowed
+     * (T12385, T13227).
      *
      * @returns The failure message, or `null`
      */
     getSettingsError(): string | null;
-    /** Apply `mutate` to settings.json via CAAMP's locked, atomic JSON writer. */
+    /**
+     * Apply `mutate` to the project's `settings.local.json` via CAAMP's locked,
+     * atomic JSON writer.
+     *
+     * @returns whether the file was written.
+     */
     private updateSettings;
     /**
      * Check whether hooks have been registered via `registerNativeHooks`.

package/dist/providers/claude-code/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAqD/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD,+DAA+D;IAC/D,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;;;;;;;;;;;;;;OAgBG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC5D;;;;;;;;OAQG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5C,gFAAgF;IAChF,OAAO,CAAC,aAAa,CAAuB;IAE5C;;;;;;;;;OASG;IACH,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,8EAA8E;YAChE,cAAc;IAe5B;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW9D;;;;;;;;;;;;;;;;OAgBG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA4FpF"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,yCAAyC,CAAC;AAE/E,yFAAyF;AACzF,eAAO,MAAM,2BAA2B,2FAC8C,CAAC;AAEvF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,6LACkJ,CAAC;AA4GzL;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,kEAAkE;IAClE,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAItD,+DAA+D;IAC/D,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B5D;;;;;;;;;;OAUG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5C,gFAAgF;IAChF,OAAO,CAAC,aAAa,CAAuB;IAE5C;;;;;;;;;;OAUG;IACH,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC;;;;;OAKG;YACW,cAAc;IAmB5B;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACH,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAI/C;;;;;;;;;;OAUG;IACG,2BAA2B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStD;;;;;;;;;;OAUG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnD;;;;;;;;;;OAUG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW9D;;;;;;;;;;;;;;;;OAgBG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA4FpF"}

package/dist/providers/claude-code/install.d.ts

@@ -3,14 +3,22 @@
  *
  * Handles CLEO installation into Claude Code environments:
  * - Ensures CLAUDE.md has CLEO @-references
- * - Manages plugin registration in ~/.claude/settings.json
+ * - Manages plugin registration in the PROJECT's `.claude/settings.local.json`
+ * - Installs the PreCompact hook templates in the PROJECT's `.claude/hooks/`
  * - Installs the heavy-command `PreToolUse` hook in the PROJECT's
  *   `.claude/settings.local.json` (T12983)
  *
+ * Project-level only (T13227): CLEO never writes the user-global
+ * `~/.claude/settings.json` or `~/.claude/hooks/` (`CLAUDE_HOME`,
+ * `CLAUDE_SETTINGS`). A project that is the home directory, or whose
+ * `.claude/` resolves into the user-global Claude config, gets those steps
+ * reported as `skipped` and nothing is written there.
+ *
  * Migrated from src/core/install/claude-plugin.ts
  *
  * @task T5240
  * @task T12983
+ * @task T13227
  */
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
 /**
@@ -18,19 +26,24 @@ import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cle
  *
  * Manages CLEO's integration with Claude Code by:
  * 1. Ensuring CLAUDE.md contains @-references to CLEO instruction files
- * 2. Installing adapter-provided commands to .claude/commands/
- * 3. Registering the brain observation plugin in ~/.claude/settings.json
- * 4. Installing PreCompact hook templates
+ * 2. Installing adapter-provided commands to the project's .claude/commands/
+ * 3. Registering the brain observation plugin in the project's
+ *    `.claude/settings.local.json`
+ * 4. Installing PreCompact hook templates in the project's `.claude/hooks/`
+ *    and wiring them into the project's `.claude/settings.local.json`
  * 5. Installing the heavy-command `PreToolUse` hook in the project's
  *    `.claude/settings.local.json`, when `options.heavyCommandHook` is set
  *
  * @remarks
  * Installation is idempotent -- running install multiple times on the same
  * project produces the same result. The provider disables the legacy
- * `claude-mem\@thedotmack` plugin if present and enables the unified
- * `cleo\@cleocode` plugin instead.
+ * `claude-mem\@thedotmack` plugin for the project if present and enables the
+ * unified `cleo\@cleocode` plugin instead. Nothing is written to the
+ * user-global Claude config (T13227).
  */
 export declare class ClaudeCodeInstallProvider implements AdapterInstallProvider {
+    /** The project the last {@link install} ran for; {@link isInstalled} reads its settings. */
+    private projectDir;
     /**
      * Install CLEO into a Claude Code project.
      *
@@ -47,7 +60,9 @@ export declare class ClaudeCodeInstallProvider implements AdapterInstallProvider
     /**
      * Check whether CLEO is installed in the current environment.
      *
-     * Checks for plugin enabled in ~/.claude/settings.json.
+     * Checks for the plugin enabled in the project's
+     * `.claude/settings.local.json` — the project of the last {@link install},
+     * else the working directory (T13227).
      */
     isInstalled(): Promise<boolean>;
     /**
@@ -57,6 +72,8 @@ export declare class ClaudeCodeInstallProvider implements AdapterInstallProvider
      * and default references from the provider registry (T1919).
      *
      * @param projectDir - Project root directory
+     * @throws {@link UserGlobalClaudeConfigError} when the project root is inside
+     *   the user-global Claude config dir (T13227); nothing is written.
      */
     ensureInstructionReferences(projectDir: string): Promise<void>;
     /**
@@ -67,43 +84,54 @@ export declare class ClaudeCodeInstallProvider implements AdapterInstallProvider
      *
      * @param projectDir - Project root directory
      * @returns Array of installed command filenames
+     * @throws {@link UserGlobalClaudeConfigError} when the target is user-global
      */
     private installCommands;
     /**
-     * Register the CLEO brain plugin in ~/.claude/settings.json.
+     * Register the CLEO brain plugin in the project's
+     * `.claude/settings.local.json` (T13227: never the user-global settings).
      *
+     * @param projectDir - Project root directory
      * @returns Description of what was registered, or null if no change needed
+     * @throws {@link UserGlobalClaudeConfigError} when the target is user-global
      */
     private registerPlugin;
     /**
      * Install the CLEO PreCompact hook templates for Claude Code (T1013).
      *
-     * Writes two files to `~/.claude/hooks/`:
+     * Writes two files to the project's `.claude/hooks/`:
      * 1. `cleo-precompact-core.sh` — universal CLEO safestop helper (shared
      *    across all providers; sourced by the provider-specific shim).
      * 2. `precompact-safestop.sh` — Claude-Code-flavoured wrapper that invokes
      *    `cleo memory precompact-flush` and `cleo safestop`.
      *
-     * Also registers a `PreCompact` entry in `~/.claude/settings.json` so Claude
-     * Code runs the hook when auto-compact fires (at 95% context).
+     * Also registers a `PreCompact` entry in the project's
+     * `.claude/settings.local.json` so Claude Code runs the hook when
+     * auto-compact fires (at 95% context). Files git does not ignore yet are
+     * kept out of it with a marked `info/exclude` block. Nothing is written to
+     * the user-global Claude config (T13227).
      *
      * Idempotent: subsequent installs skip unchanged files and do not duplicate
-     * the settings.json hook entry.
+     * the settings hook entry.
      *
+     * @param projectDir - Project root directory
      * @returns Install summary (paths written + config change description), or
      *   `null` when no change was required.
+     * @throws {@link UserGlobalClaudeConfigError} when the target is user-global
      *
-     * @task T1013
+     * @task T1013 @task T13227
      */
     private installHookTemplates;
     /**
-     * Register the PreCompact hook command in `~/.claude/settings.json`.
+     * Register the PreCompact hook command in the project's
+     * `.claude/settings.local.json`.
      *
      * The Claude Code native event name for the canonical `PreCompact` event is
      * `PreCompact` (identity mapping — see `hook-mappings.json`). The entry is
      * tagged with `# cleo-hook` so the uninstall flow can identify and remove
      * our additions without touching user-authored hooks.
      *
+     * @param settingsPath - The project settings file (already scope-checked).
      * @param shimPath - Absolute path to the installed `precompact-safestop.sh`.
      * @returns `true` when a new hook entry was written, `false` when an
      *   equivalent entry was already present.

package/dist/providers/claude-code/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA6BjG;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA0E9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAkBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;OAIG;YACW,cAAc;IAwB5B;;;;;;;;;;;;;;;;;;;OAmBG;YACW,oBAAoB;IAgClC;;;;;;;;;;;;;OAaG;YACW,sBAAsB;CAmBrC"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAwCjG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,yBAA0B,YAAW,sBAAsB;IACtE,4FAA4F;IAC5F,OAAO,CAAC,UAAU,CAAuB;IAEzC;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA4F9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;;;OAMG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAwBrC;;;;;;;;;OASG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;;;;OAOG;YACW,cAAc;IA2B5B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;YACW,oBAAoB;IAoClC;;;;;;;;;;;;;;;OAeG;YACW,sBAAsB;CAmBrC"}

package/dist/providers/claude-code/paths.d.ts

@@ -47,5 +47,82 @@ export declare class ClaudeCodePathProvider implements AdapterPathProvider {
  * ```
  */
 export declare function claudeSettingsPath(): string;
+/**
+ * The adapter was asked to write somewhere that is, or lies inside, the
+ * user-global Claude Code config (T13227). CLEO never writes there — adding
+ * and removing entries alike — so nothing is written and the caller reports
+ * the step as skipped.
+ */
+export declare class UserGlobalClaudeConfigError extends Error {
+    /** The path that was refused. */
+    readonly path: string;
+    /**
+     * @param path - the refused target.
+     * @param why - which user-global location it hits.
+     */
+    constructor(path: string, why: string);
+}
+/**
+ * The project's per-machine Claude Code settings file,
+ * `<project>/.claude/settings.local.json` — the only settings file the
+ * adapter's hook and plugin writers touch (T13227, the T12983/T13124 rule:
+ * project-level only, never the user-global `~/.claude/settings.json`).
+ *
+ * @param projectDir - the project root.
+ * @returns the absolute settings path.
+ * @throws {@link UserGlobalClaudeConfigError} when it would be user-global.
+ *
+ * @example
+ * ```typescript
+ * const target = projectClaudeSettingsPath('/repo'); // /repo/.claude/settings.local.json
+ * ```
+ */
+export declare function projectClaudeSettingsPath(projectDir: string): string;
+/**
+ * The project's Claude Code hook-script dir, `<project>/.claude/hooks`, where
+ * the PreCompact templates are copied (T13227).
+ *
+ * @param projectDir - the project root.
+ * @returns the absolute hooks dir.
+ * @throws {@link UserGlobalClaudeConfigError} when it would be user-global.
+ *
+ * @example
+ * ```typescript
+ * const dir = projectClaudeHooksDir('/repo'); // /repo/.claude/hooks
+ * ```
+ */
+export declare function projectClaudeHooksDir(projectDir: string): string;
+/**
+ * Refuse a project whose `CLAUDE.md` would be user-global in effect (T13227
+ * review): a root inside the user-global Claude config dir (in any spelling),
+ * where it is Claude Code's user-global memory file `~/.claude/CLAUDE.md`, or
+ * the home directory itself — Claude Code loads `CLAUDE.md` from the working
+ * directory up through every ancestor, so `~/CLAUDE.md` reaches every session
+ * under `$HOME`.
+ *
+ * @param projectDir - the project root.
+ * @throws {@link UserGlobalClaudeConfigError} when the project root is the
+ *   home directory or inside the user-global Claude config dir.
+ *
+ * @example
+ * ```typescript
+ * assertProjectInstructionScope('/repo'); // ok
+ * ```
+ */
+export declare function assertProjectInstructionScope(projectDir: string): void;
+/**
+ * The project's Claude Code commands dir, `<project>/.claude/commands`, where
+ * the adapter's slash commands are copied (T13227).
+ *
+ * @param projectDir - the project root.
+ * @returns the absolute commands dir.
+ * @throws {@link UserGlobalClaudeConfigError} when it would be user-global.
+ *
+ * @example
+ * ```typescript
+ * const dir = projectClaudeCommandsDir('/repo'); // /repo/.claude/commands
+ * ```
+ */
+export declare function projectClaudeCommandsDir(projectDir: string): string;
 export { appendHookEntry, CLEO_HOOK_MARKER, hasCleoHook, hookMap, isCleoHookEntry, isPlainObject, removeCleoHookEntries, } from '../shared/hook-config.js';
 //# sourceMappingURL=paths.d.ts.map

package/dist/providers/claude-code/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,uDAAuD;IACvD,cAAc,IAAI,MAAM;IAIxB,4EAA4E;IAC5E,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,4EAA4E;IAC5E,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAInC,8EAA8E;IAC9E,eAAe,IAAI,MAAM,GAAG,IAAI;CAGjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,OAAO,EACP,eAAe,EACf,aAAa,EACb,qBAAqB,GACtB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/providers/claude-code/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,uDAAuD;IACvD,cAAc,IAAI,MAAM;IAIxB,4EAA4E;IAC5E,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,4EAA4E;IAC5E,kBAAkB,IAAI,MAAM,GAAG,IAAI;IAInC,8EAA8E;IAC9E,eAAe,IAAI,MAAM,GAAG,IAAI;CAGjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAoCD;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;gBACS,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAKtC;AA6BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEtE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,OAAO,EACP,eAAe,EACf,aAAa,EACb,qBAAqB,GACtB,MAAM,0BAA0B,CAAC"}

package/dist/providers/codex/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIjG;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAyC9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/codex/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKjG;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAqB,YAAW,sBAAsB;IACjE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAyC9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}

package/dist/providers/cursor/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAsBjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA2BrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE;;;;;;;;;;;;;;;OAeG;YACW,sBAAsB;IAcpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;;;;;;;;;;;;;;;OAiBG;YACW,oBAAoB;IA8BlC;;;;;;;;;;;;OAYG;YACW,sBAAsB;CA+BrC"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/cursor/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAwBjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAmD9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA2BrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpE;;;;;;;;;;;;;;;OAeG;YACW,sBAAsB;IAcpC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;;;;;;;;;;;;;;;OAiBG;YACW,oBAAoB;IA8BlC;;;;;;;;;;;;OAYG;YACW,sBAAsB;CA+BrC"}

package/dist/providers/gemini-cli/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGjG;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini-cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIjG;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}

package/dist/providers/kimi/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAuB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/kimi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,mBAAoB,YAAW,sBAAsB;IAChE;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB9D;;;;;OAKG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC;;;;;OAKG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBrC;;;;;;;OAOG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}

package/dist/providers/openai-sdk/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGjG;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAMrC;;;;OAIG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAOxB"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/openai-sdk/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIjG;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAyB,YAAW,sBAAsB;IACrE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAgC9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAMrC;;;;OAIG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE;;;;OAIG;IACH,OAAO,CAAC,eAAe;CAOxB"}

package/dist/providers/opencode/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWjG;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAiD9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,qBAAqB;CA0C9B"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/opencode/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYjG;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAkD9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAerC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,qBAAqB;CA0C9B"}

package/dist/providers/pi/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAWjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,YAAW,sBAAsB;IAC9D;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA0C9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA0BrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/providers/pi/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYjG;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,YAAW,sBAAsB;IAC9D;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA2C9D;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA0BrC;;;;;;OAMG;IACG,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMrE"}

package/dist/providers/shared/heavy-command-hook-delivery.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Deliver CLEO's heavy-command hook to every provider a project uses (T13124).
+ *
+ * `cleo init`, `cleo upgrade`, `cleo doctor` and the session briefing reach the
+ * per-provider installers in {@link ./heavy-command-hook-install.js} through
+ * this module. It used to go through `AdapterManager.discover()`, which looks for
+ * manifests at `<project>/packages/adapters/<dir>/manifest.json`, a path that
+ * exists in no project, cleocode included. So the hook was never installed
+ * anywhere, and the per-adapter try/catch hid every failure.
+ *
+ * Each provider is handled on its own: a provider that cannot take the hook
+ * (a stray `.codex` file, a malformed settings file) gets a `blocked` or
+ * `failed` outcome with the reason and the exact remedy, and the other
+ * providers still install. Nothing here throws.
+ *
+ * A provider counts as in use when the project has its config directory, its
+ * CLI is on `PATH`, its user config directory exists, or the hook config
+ * already exists. The home directory is only READ for that check. CLEO writes
+ * project-level configs only, never a user-global one.
+ *
+ * @task T13124
+ * @epic T13121
+ */
+import type { HeavyCommandHookMode, HeavyCommandHookProvider, HeavyHookCliProbe, HeavyHookDeliveryApi, HeavyHookDeliveryOptions, HeavyHookDeliveryOutcome, HeavyHookInspection } from '@cleocode/contracts';
+/** Every provider the delivery considers, in report order. */
+export declare const HEAVY_HOOK_DELIVERY_PROVIDERS: readonly HeavyCommandHookProvider[];
+/** The focused remedy: installs or refreshes only this hook. */
+export declare const HEAVY_HOOK_FIX_COMMAND = "cleo doctor heavy-command-hook --fix";
+type Env = Readonly<Record<string, string | undefined>>;
+/**
+ * The file a provider's project-level hook lives in (Kimi: its global config,
+ * named for the report only; CLEO never writes it).
+ *
+ * @param provider - the harness.
+ * @param projectDir - the project root.
+ * @param env - environment (for Kimi's home directory).
+ * @returns the absolute path.
+ */
+export declare function heavyHookTarget(provider: HeavyCommandHookProvider, projectDir: string, env?: Env): string;
+/** Whether a provider is in use, and the first signal that says so. */
+export interface HeavyHookDetection {
+    /** The provider is in use on this machine or in this project. */
+    readonly detected: boolean;
+    /** The signal found, or what was checked when nothing was. */
+    readonly why: string;
+}
+/**
+ * Whether `provider` is in use here, from cheap read-only signals: its
+ * project config directory, its CLI on `PATH`, its user config directory, or
+ * an existing hook config.
+ *
+ * @param provider - the harness.
+ * @param projectDir - the project root.
+ * @param env - environment (`PATH`, `HOME`, `CODEX_HOME`, `XDG_CONFIG_HOME`, …).
+ * @returns whether it is in use, and why.
+ */
+export declare function detectHeavyHookProvider(provider: HeavyCommandHookProvider, projectDir: string, env?: Env): HeavyHookDetection;
+/**
+ * Install, refresh or (mode `off`) remove CLEO's heavy-command hook for every
+ * provider in use in `projectDir`, each independently: one provider's failure
+ * never stops another. Mode `off` cleans every provider, in use or not. The
+ * home directory is skipped (its provider configs are the user-global ones).
+ *
+ * @param projectDir - the project root.
+ * @param mode - the resolved hook mode (`resources.heavyCommandHook`).
+ * @param options - environment and provider list (tests).
+ * @returns one outcome per provider, in {@link HEAVY_HOOK_DELIVERY_PROVIDERS} order.
+ */
+export declare function syncProjectHeavyCommandHooks(projectDir: string, mode: HeavyCommandHookMode, options?: HeavyHookDeliveryOptions): Promise<readonly HeavyHookDeliveryOutcome[]>;
+/**
+ * Read-only: the hook's state for every provider in `projectDir`. Never
+ * writes and never throws.
+ *
+ * @param projectDir - the project root.
+ * @param mode - the resolved hook mode (`resources.heavyCommandHook`).
+ * @param options - environment and provider list (tests).
+ * @returns one inspection per provider, in {@link HEAVY_HOOK_DELIVERY_PROVIDERS} order.
+ */
+export declare function inspectProjectHeavyCommandHooks(projectDir: string, mode: HeavyCommandHookMode, options?: HeavyHookDeliveryOptions): readonly HeavyHookInspection[];
+/**
+ * Whether the `cleo` on PATH, as the hook resolves it from `projectDir`, can
+ * answer the hook. A hook installed in front of an older CLEO (no `cleo hook`,
+ * so no `cleo run`) lets every command run ungoverned, so `cleo doctor` must
+ * say so. The check is the hook's own: its marker for this binary and
+ * directory, else one call to `cleo hook heavy-command` with an empty payload,
+ * where an older CLEO exits 127 with "Unknown command".
+ *
+ * @param projectDir - the project root (a version-manager shim may resolve a
+ *   different `cleo` per directory).
+ * @param options - environment (tests).
+ * @returns the CLI's state.
+ */
+export declare function probeHeavyHookCli(projectDir: string, options?: HeavyHookDeliveryOptions): HeavyHookCliProbe;
+/** The delivery surface `@cleocode/core` loads at run time. */
+export declare const heavyHookDeliveryApi: HeavyHookDeliveryApi;
+export {};
+//# sourceMappingURL=heavy-command-hook-delivery.d.ts.map

package/dist/providers/shared/heavy-command-hook-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heavy-command-hook-delivery.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/heavy-command-hook-delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AA0B7B,8DAA8D;AAC9D,eAAO,MAAM,6BAA6B,EAAE,SAAS,wBAAwB,EAK3E,CAAC;AAEH,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,yCAAyC,CAAC;AAE7E,KAAK,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAgBxD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,GAAiB,GACrB,MAAM,CAWR;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,GAAiB,GACrB,kBAAkB,CAgDpB;AAgED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,SAAS,wBAAwB,EAAE,CAAC,CAwB9C;AA2MD;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE,wBAA6B,GACrC,SAAS,mBAAmB,EAAE,CAchC;AAwCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAqCnB;AAED,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,EAAE,oBAIjC,CAAC"}