@cleocode/adapters 2026.10.2 → 2026.10.4

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;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"}

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"}

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

@@ -48,6 +48,30 @@ export declare const HEAVY_TOOL_WORDS: readonly string[];
  * home directory, whose provider configs are the user-global ones.
  */
 export type HeavyHookSyncResult = 'installed' | 'updated' | 'removed' | 'unchanged' | 'skipped';
+/**
+ * A config path cannot be created because something on the way to it exists
+ * but is not a directory (T13124: a stray empty `<project>/.codex` file made
+ * `mkdirSync` throw `EEXIST` and aborted the Codex install). Nothing is
+ * written; the delivery reports the provider as `blocked`.
+ */
+export declare class HeavyHookPathBlockedError extends Error {
+    /** The existing path that is not a directory. */
+    readonly path: string;
+    /**
+     * @param path - the existing non-directory path.
+     * @param target - the config file that would have lived under it.
+     */
+    constructor(path: string, target: string);
+}
+/**
+ * The nearest existing path at or above `dir` when it is NOT a directory, or
+ * `null` when the nearest existing one is a directory (so `mkdir -p dir`
+ * can succeed). Errors other than "does not exist" return `null` and are left
+ * to the write that follows.
+ *
+ * @param dir - the directory a config file needs.
+ */
+export declare function nonDirectoryAncestor(dir: string): string | null;
 /**
  * Whether `projectDir` is the user's home directory. There,
  * `<home>/.claude/settings.local.json`, `<home>/.codex/hooks.json` and
@@ -108,6 +132,8 @@ export declare function heavyCommandHookObject(provider: 'claude-code' | 'codex'
  * @param provider - `claude-code` or `codex`.
  */
 export declare function heavyCommandHookEntry(provider: 'claude-code' | 'codex'): Record<string, unknown>;
+/** Whether one hook object is CLEO's heavy-command hook. */
+export declare function isHeavyHookObject(hook: unknown): boolean;
 /**
  * Add, refresh or (mode `off`) remove CLEO's heavy-command hook in a JSON hook
  * config, through CAAMP's locked atomic writer. Only CLEO's own hook object is
@@ -119,28 +145,147 @@ export declare function heavyCommandHookEntry(provider: 'claude-code' | 'codex')
  * @returns what changed.
  */
 export declare function syncJsonHeavyCommandHook(configPath: string, provider: 'claude-code' | 'codex', mode: HeavyCommandHookMode): Promise<HeavyHookSyncResult>;
-/** First line of the `info/exclude` block CLEO adds (and alone may remove). */
+/** Claude Code's per-machine settings file, relative to the project. */
+export declare const CLAUDE_LOCAL_SETTINGS = ".claude/settings.local.json";
+/** First line of the `info/exclude` block CLEO adds for `settings.local.json` (and alone may remove). */
 export declare const LOCAL_SETTINGS_EXCLUDE_MARKER = "# cleo-hook: keep the per-machine heavy-command hook settings out of git (T12983)";
 /**
- * Keep `.claude/settings.local.json` out of git when nothing ignores it yet
- * (Claude Code ignores the file only when it creates it itself). Adds a marked
- * block naming this project's file to the repository's `info/exclude`, never
- * to a tracked `.gitignore`. Keyed on the exact path line, so a second CLEO
+ * First line of the `info/exclude` block CLEO adds for any other hook file it
+ * writes: Codex's `.codex/hooks.json` and the opencode plugin (T13124, gh#1805:
+ * an untracked plugin file widened `cleo verify`'s evidence scope).
+ */
+export declare const HOOK_FILE_EXCLUDE_MARKER = "# cleo-hook: keep a per-machine heavy-command hook file out of git (T13124)";
+/** Codex's project hook config, relative to the project. */
+export declare const CODEX_HOOKS_FILE = ".codex/hooks.json";
+/** The opencode plugin, relative to the project. */
+export declare const OPENCODE_PLUGIN_FILE = ".opencode/plugins/cleo-heavy-command.js";
+/**
+ * Keep a hook file CLEO wrote out of git when nothing ignores it yet: add a
+ * marked block naming this project's file to the repository's `info/exclude`,
+ * never to a tracked `.gitignore`. A file git already tracks is left alone (an
+ * exclude cannot untrack it). Keyed on the exact path line, so a second CLEO
  * project in a subdirectory of the same repository gets its own line.
  * Idempotent; does nothing outside a git work tree.
  *
  * @param projectDir - the project root.
+ * @param relPath - the file, relative to the project (forward slashes).
+ * @param marker - the block's first line.
+ * @returns whether a block was added.
+ */
+export declare function excludeHookFileFromGit(projectDir: string, relPath: string, marker?: string): boolean;
+/**
+ * Remove the block {@link excludeHookFileFromGit} added for this project's
+ * file, and only that: the exact path line and the CLEO marker right above it.
+ *
+ * @param projectDir - the project root.
+ * @param relPath - the file, relative to the project (forward slashes).
+ * @returns whether a block was removed.
+ */
+export declare function unexcludeHookFileFromGit(projectDir: string, relPath: string): boolean;
+/**
+ * Whether git sees a hook file as an untracked change: inside a work tree,
+ * not ignored and not tracked. Such a file shows up in `git status` and
+ * widens `cleo verify`'s evidence scope (gh#1805).
+ *
+ * @param projectDir - the project root.
+ * @param relPath - the file, relative to the project (forward slashes).
+ */
+export declare function hookFileVisibleToGit(projectDir: string, relPath: string): boolean;
+/**
+ * Keep `.claude/settings.local.json` out of git when nothing ignores it yet
+ * (Claude Code ignores the file only when it creates it itself). See
+ * {@link excludeHookFileFromGit}.
+ *
+ * @param projectDir - the project root.
  * @returns whether a block was added.
  */
 export declare function excludeLocalSettingsFromGit(projectDir: string): boolean;
 /**
  * Remove the block {@link excludeLocalSettingsFromGit} added for this
- * project, and only that: the exact path line and the marker right above it.
+ * project, and only that.
  *
  * @param projectDir - the project root.
  * @returns whether a block was removed.
  */
 export declare function unexcludeLocalSettingsFromGit(projectDir: string): boolean;
+/**
+ * A hook config CLEO will not add its per-machine hook to, because it is the
+ * project's own: Codex's `.codex/hooks.json` is committable, unlike Claude
+ * Code's `settings.local.json`. Writing there would put a per-machine hook
+ * into a team file, and excluding it would hide the team's file from git.
+ * Nothing is written; the delivery reports `needs-consent` with the entry to
+ * add by hand.
+ */
+export declare class HeavyHookSharedConfigError extends Error {
+    /** The project's own config file. */
+    readonly path: string;
+    /**
+     * @param path - the config file.
+     * @param why - what makes it the project's own.
+     */
+    constructor(path: string, why: string);
+}
+/**
+ * Why Codex's `.codex/hooks.json` in `projectDir` is the project's own config
+ * that CLEO must not write or hide, or `null` when CLEO may: the file is
+ * absent, or is one CLEO created and git does not track (review MED-3). An
+ * unreadable file is left to the sync, which refuses it.
+ *
+ * @param projectDir - the project root.
+ * @param checkGit - also ask git whether the file is tracked (one spawn);
+ *   `false` reads the file only (the session briefing).
+ */
+export declare function codexHooksSharedReason(projectDir: string, checkGit?: boolean): string | null;
+/**
+ * Whether the committed (`HEAD`) version of Codex's `.codex/hooks.json` holds
+ * CLEO's hook: the team adopted it, so mode `off` on one machine must not
+ * remove it from the tracked file (review MED-3b).
+ *
+ * @param projectDir - the project root.
+ */
+export declare function committedCodexHookHoldsCleo(projectDir: string): boolean;
+/**
+ * Mode `off` on a TRACKED `hooks.json` whose only change from `HEAD` is
+ * CLEO's hook: write `HEAD`'s exact bytes back, so the file returns to its
+ * committed state instead of being re-serialised with CLEO's formatting
+ * (review LOW-3). Returns whether it did.
+ *
+ * @param projectDir - the project root.
+ */
+export declare function restoreCommittedCodexHooks(projectDir: string): boolean;
+/**
+ * Whether CLEO's own marked `info/exclude` block names this project file
+ * (it hides the file from git).
+ *
+ * @param projectDir - the project root.
+ * @param relPath - the file, relative to the project (forward slashes).
+ */
+export declare function excludedByCleo(projectDir: string, relPath: string): boolean;
+/**
+ * The exact `PreToolUse` entry to add to Codex's `.codex/hooks.json` by hand,
+ * for a project whose own config CLEO does not write (`needs-consent`).
+ */
+export declare function codexHookSnippet(): string;
+/**
+ * Whether git tracks a project file and it has uncommitted changes.
+ *
+ * @param projectDir - the project root.
+ * @param relPath - the file, relative to the project (forward slashes).
+ */
+export declare function trackedFileModified(projectDir: string, relPath: string): boolean;
+/**
+ * Codex: sync the hook in `<project>/.codex/hooks.json` and keep that file out
+ * of git (T13124), as {@link syncClaudeCodeHeavyCommandHook} does for Claude
+ * Code's settings. A shared `hooks.json` (tracked, or holding hooks that are
+ * not CLEO's) is never written: {@link HeavyHookSharedConfigError}. Mode `off`
+ * still removes CLEO's own hook object from it.
+ *
+ * @param projectDir - the project root.
+ * @param mode - the resolved hook mode.
+ * @returns what changed in `hooks.json`.
+ * @throws {HeavyHookSharedConfigError} when `hooks.json` is shared.
+ */
+export declare function syncCodexHeavyCommandHook(projectDir: string, mode: HeavyCommandHookMode): Promise<HeavyHookSyncResult>;
 /**
  * Claude Code: sync the hook in `<project>/.claude/settings.local.json`, keep
  * that file out of git, and remove a hook an earlier build put in the shared
@@ -163,7 +308,8 @@ export declare function syncClaudeCodeHeavyCommandHook(projectDir: string, mode:
 export declare function opencodeHeavyCommandPluginSource(): string;
 /**
  * Write (or, mode `off`, delete) the opencode plugin in
- * `<projectDir>/.opencode/plugins/`. Rewritten only when its content changed.
+ * `<projectDir>/.opencode/plugins/`, and keep it out of git (T13124).
+ * Rewritten only when its content changed.
  *
  * @param projectDir - the project root.
  * @param mode - the resolved hook mode.

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAeH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,iFAAiF;AACjF,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,kDAAkD;AAClD,eAAO,MAAM,6BAA6B,0BAA0B,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EA+B5C,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAUhG;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,OAAO,CAEnF;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAOjC,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,GAAE,MAAgD,GACpD,MAAM,CAkBR;AAqDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,GAAG,MAAM,CAIjF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMjG;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhG;AA4DD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,aAAa,GAAG,OAAO,EACjC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CA4B9B;AAKD,+EAA+E;AAC/E,eAAO,MAAM,6BAA6B,sFAC2C,CAAC;AA6BtF;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAWvE;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CASzE;AAED;;;;;;;;GAQG;AACH,wBAAsB,8BAA8B,CAClD,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAc9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,IAAI,MAAM,CAmDzD;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,oBAAoB,GACzB,mBAAmB,CAarB"}
+{"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/package.json

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

package/src/heavy-command-hook.ts

@@ -0,0 +1,21 @@
+/**
+ * `@cleocode/adapters/heavy-command-hook`: project-level delivery of CLEO's
+ * heavy-command hook (T13124). A light entry point: `@cleocode/core` loads it
+ * at run time for `cleo init`, `cleo upgrade`, `cleo doctor` and the session
+ * briefing without pulling in every provider adapter.
+ *
+ * @packageDocumentation
+ * @task T13124
+ */
+
+export type { HeavyHookDetection } from './providers/shared/heavy-command-hook-delivery.js';
+export {
+  detectHeavyHookProvider,
+  HEAVY_HOOK_DELIVERY_PROVIDERS,
+  HEAVY_HOOK_FIX_COMMAND,
+  heavyHookDeliveryApi,
+  heavyHookTarget,
+  inspectProjectHeavyCommandHooks,
+  probeHeavyHookCli,
+  syncProjectHeavyCommandHooks,
+} from './providers/shared/heavy-command-hook-delivery.js';

package/src/index.ts

@@ -87,6 +87,18 @@ export {
   OpenCodeInstallProvider,
   OpenCodeSpawnProvider,
 } from './providers/opencode/index.js';
+// T13124 — project-level heavy-command hook delivery (also `@cleocode/adapters/heavy-command-hook`).
+export type { HeavyHookDetection } from './providers/shared/heavy-command-hook-delivery.js';
+export {
+  detectHeavyHookProvider,
+  HEAVY_HOOK_DELIVERY_PROVIDERS,
+  HEAVY_HOOK_FIX_COMMAND,
+  heavyHookDeliveryApi,
+  heavyHookTarget,
+  inspectProjectHeavyCommandHooks,
+  probeHeavyHookCli,
+  syncProjectHeavyCommandHooks,
+} from './providers/shared/heavy-command-hook-delivery.js';
 export type {
   HookTemplateProviderId,
   InstallHookTemplatesOptions,

package/src/providers/codex/install.ts

@@ -15,7 +15,7 @@
 import { join } from 'node:path';
 import { ensureProviderInstructionFile } from '@cleocode/caamp';
 import type { AdapterInstallProvider, InstallOptions, InstallResult } from '@cleocode/contracts';
-import { isUserHomeDir, syncJsonHeavyCommandHook } from '../shared/heavy-command-hook-install.js';
+import { isUserHomeDir, syncCodexHeavyCommandHook } from '../shared/heavy-command-hook-install.js';
 import { getCleoTemplatesTildePath } from '../shared/paths.js';
 
 /**
@@ -66,9 +66,8 @@ export class CodexInstallProvider implements AdapterInstallProvider {
       details.heavyCommandHook = 'skipped';
     } else if (options.heavyCommandHook !== undefined) {
       try {
-        details.heavyCommandHook = await syncJsonHeavyCommandHook(
-          join(projectDir, '.codex', 'hooks.json'),
-          'codex',
+        details.heavyCommandHook = await syncCodexHeavyCommandHook(
+          projectDir,
           options.heavyCommandHook,
         );
       } catch (err) {