@cleocode/adapters 2026.10.4 → 2026.10.5

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;IAwC9D;;;;;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-install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heavy-command-hook-install.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/heavy-command-hook-install.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heavy-command-hook-install.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/heavy-command-hook-install.ts"],"names":[],"mappings":"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"}

package/dist/providers/shared/project-instruction-file.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A provider's PROJECT instruction file, skipped (not failed) at a project
+ * rooted at the home directory (T13227).
+ *
+ * Providers load CLAUDE.md / AGENTS.md / GEMINI.md from the working directory
+ * up through every ancestor, so a file at `$HOME` reaches every session under
+ * it: CAAMP refuses it with `HomeInstructionFileError`. An adapter's install
+ * reports that step as `skipped` and carries on with the rest, the way the
+ * heavy-command hook already skips the home directory (T12983).
+ *
+ * @task T13227
+ */
+import { type EnsureProviderInstructionFileOptions, type EnsureProviderInstructionFileResult } from '@cleocode/caamp';
+/**
+ * Ensure a provider's project instruction file, or `null` when the project is
+ * the home directory and the file was refused (nothing written).
+ *
+ * @param providerId - CAAMP provider id.
+ * @param projectDir - the project root.
+ * @param options - references, content, scope.
+ * @returns the CAAMP result, or `null` when skipped at `$HOME`.
+ *
+ * @example
+ * ```typescript
+ * const r = await ensureProjectInstructionFile('codex', projectDir, { scope: 'project' });
+ * if (r === null) details.instructionFile = 'skipped';
+ * ```
+ */
+export declare function ensureProjectInstructionFile(providerId: string, projectDir: string, options: EnsureProviderInstructionFileOptions): Promise<EnsureProviderInstructionFileResult | null>;
+//# sourceMappingURL=project-instruction-file.d.ts.map

package/dist/providers/shared/project-instruction-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-instruction-file.d.ts","sourceRoot":"","sources":["../../../src/providers/shared/project-instruction-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,oCAAoC,EACzC,KAAK,mCAAmC,EAGzC,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,mCAAmC,GAAG,IAAI,CAAC,CAOrD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/adapters",
-  "version": "2026.10.4",
+  "version": "2026.10.5",
   "description": "Unified provider adapters for CLEO (Claude Code, OpenCode, Cursor)",
   "type": "module",
   "main": "dist/index.js",
@@ -19,9 +19,9 @@
     "@ai-sdk/anthropic": "^3.0.69",
     "@ai-sdk/openai": "^2.0.53",
     "ai": "^6.0.168",
-    "@cleocode/caamp": "2026.10.4",
-    "@cleocode/paths": "2026.10.4",
-    "@cleocode/contracts": "2026.10.4"
+    "@cleocode/caamp": "2026.10.5",
+    "@cleocode/contracts": "2026.10.5",
+    "@cleocode/paths": "2026.10.5"
   },
   "license": "MIT",
   "engines": {
@@ -34,7 +34,7 @@
   "devDependencies": {
     "@types/node": "^24.3.0",
     "vitest": "^4.1.4",
-    "@cleocode/playbooks": "2026.10.4"
+    "@cleocode/playbooks": "2026.10.5"
   },
   "repository": {
     "type": "git",

package/src/__tests__/claude-code-adapter.test.ts

@@ -7,7 +7,7 @@
  * @task T5240
  */
 
-import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import {
@@ -108,11 +108,16 @@ describe('ClaudeCodeHookProvider — integration', () => {
   });
 
   it('tracks registration state', async () => {
-    expect(hooks.isRegistered()).toBe(false);
-    await hooks.registerNativeHooks('/tmp/test');
-    expect(hooks.isRegistered()).toBe(true);
-    await hooks.unregisterNativeHooks();
-    expect(hooks.isRegistered()).toBe(false);
+    const projectDir = mkdtempSync(join(tmpdir(), 'cleo-claude-hooks-'));
+    try {
+      expect(hooks.isRegistered()).toBe(false);
+      await hooks.registerNativeHooks(projectDir);
+      expect(hooks.isRegistered()).toBe(true);
+      await hooks.unregisterNativeHooks();
+      expect(hooks.isRegistered()).toBe(false);
+    } finally {
+      rmSync(projectDir, { recursive: true, force: true });
+    }
   });
 
   it('exposes event map for introspection', () => {

package/src/providers/claude-code/__tests__/hooks-install.test.ts

@@ -3,9 +3,10 @@
  *
  * Validates that:
  * - Shared `cleo-precompact-core.sh` and provider-specific
- *   `precompact-safestop.sh` are copied into `~/.claude/hooks/`.
- * - `~/.claude/settings.json` gains a `PreCompact` entry pointing at the
- *   installed shim, tagged with the `# cleo-hook` sentinel for clean uninstall.
+ *   `precompact-safestop.sh` are copied into the PROJECT's `.claude/hooks/`.
+ * - The project's `.claude/settings.local.json` gains a `PreCompact` entry
+ *   pointing at the installed shim, tagged with the `# cleo-hook` sentinel.
+ * - The user-global `$CLAUDE_HOME` is never written (T13227).
  * - Repeat invocations are idempotent (no duplicate settings entries).
  * - The source templates contain the universal CLEO CLI invocations so the
  *   bash contract remains DRY across providers.
@@ -14,6 +15,7 @@
  * impersonates `$HOME` via the `HOME` env var, so no user config is touched.
  *
  * @task T1013
+ * @task T13227
  * @epic T1000
  */
 
@@ -67,7 +69,7 @@ describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
     rmSync(projectDir, { recursive: true, force: true });
   });
 
-  it('installs both bash templates into $HOME/.claude/hooks/', async () => {
+  it('installs both bash templates into the project .claude/hooks/', async () => {
     const provider = new ClaudeCodeInstallProvider();
 
     const result = await provider.install({ projectDir });
@@ -79,20 +81,21 @@ describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
     } | null;
 
     expect(hookTemplates).not.toBeNull();
-    expect(hookTemplates?.templates.targetDir).toBe(join(fakeHome, '.claude', 'hooks'));
+    expect(hookTemplates?.templates.targetDir).toBe(join(projectDir, '.claude', 'hooks'));
+    expect(existsSync(join(fakeHome, '.claude'))).toBe(false);
     const installed = hookTemplates?.templates.installedFiles ?? [];
     expect(installed.some((p) => p.endsWith('cleo-precompact-core.sh'))).toBe(true);
     expect(installed.some((p) => p.endsWith('precompact-safestop.sh'))).toBe(true);
 
     // Installed shim sources the shared helper.
     const shim = readFileSync(
-      join(fakeHome, '.claude', 'hooks', 'precompact-safestop.sh'),
+      join(projectDir, '.claude', 'hooks', 'precompact-safestop.sh'),
       'utf-8',
     );
     expect(shim).toContain('cleo-precompact-core.sh');
     // Shared helper invokes the universal CLEO CLI.
     const core = readFileSync(
-      join(fakeHome, '.claude', 'hooks', 'cleo-precompact-core.sh'),
+      join(projectDir, '.claude', 'hooks', 'cleo-precompact-core.sh'),
       'utf-8',
     );
     expect(core).toContain('cleo memory precompact-flush');
@@ -100,11 +103,11 @@ describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
     expect(core).toMatch(/cleo_cmd.*safestop/);
   });
 
-  it('writes a PreCompact entry into $HOME/.claude/settings.json tagged # cleo-hook', async () => {
+  it('writes a PreCompact entry into the project settings.local.json tagged # cleo-hook', async () => {
     const provider = new ClaudeCodeInstallProvider();
     await provider.install({ projectDir });
 
-    const settingsPath = join(fakeHome, '.claude', 'settings.json');
+    const settingsPath = join(projectDir, '.claude', 'settings.local.json');
     const settings = JSON.parse(readFileSync(settingsPath, 'utf-8')) as {
       hooks?: Record<string, Array<{ hooks?: Array<{ command?: string; type?: string }> }>>;
     };
@@ -124,7 +127,7 @@ describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
     await provider.install({ projectDir });
     await provider.install({ projectDir });
 
-    const settingsPath = join(fakeHome, '.claude', 'settings.json');
+    const settingsPath = join(projectDir, '.claude', 'settings.local.json');
     const settings = JSON.parse(readFileSync(settingsPath, 'utf-8')) as {
       hooks?: { PreCompact?: unknown[] };
     };
@@ -134,12 +137,12 @@ describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
   // T12385 — a malformed settings.json used to be replaced with an object
   // holding only CLEO's entries (the parse error was caught and the writer
   // "started fresh"). It must now be reported and left byte-identical.
-  describe('T12385 — malformed settings.json is never rewritten', () => {
+  describe('T12385 — malformed settings file is never rewritten', () => {
     const malformed = '{\n  "permissions": { "allow": ["Bash(ls)"] },\n  "model": "opus",\n';
 
     it('install reports the parse error and leaves the file byte-identical', async () => {
-      const settingsPath = join(fakeHome, '.claude', 'settings.json');
-      mkdirSync(join(fakeHome, '.claude'), { recursive: true });
+      const settingsPath = join(projectDir, '.claude', 'settings.local.json');
+      mkdirSync(join(projectDir, '.claude'), { recursive: true });
       writeFileSync(settingsPath, malformed, 'utf-8');
 
       const result = await new ClaudeCodeInstallProvider().install({ projectDir });
@@ -153,8 +156,8 @@ describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
     });
 
     it('hook registration reports the parse error and leaves the file byte-identical', async () => {
-      const settingsPath = join(fakeHome, '.claude', 'settings.json');
-      mkdirSync(join(fakeHome, '.claude'), { recursive: true });
+      const settingsPath = join(projectDir, '.claude', 'settings.local.json');
+      mkdirSync(join(projectDir, '.claude'), { recursive: true });
       writeFileSync(settingsPath, malformed, 'utf-8');
       const stderr = vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
 
@@ -168,8 +171,8 @@ describe('ClaudeCodeInstallProvider — PreCompact hook templates', () => {
     });
 
     it('preserves unrelated user settings when it does write', async () => {
-      const settingsPath = join(fakeHome, '.claude', 'settings.json');
-      mkdirSync(join(fakeHome, '.claude'), { recursive: true });
+      const settingsPath = join(projectDir, '.claude', 'settings.local.json');
+      mkdirSync(join(projectDir, '.claude'), { recursive: true });
       writeFileSync(
         settingsPath,
         JSON.stringify({ model: 'opus', hooks: { Stop: [{ matcher: 'x', hooks: [] }] } }),