@cleocode/adapters 2026.10.18 → 2026.10.19

package/dist/project-hook-native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-hook-native.d.ts","sourceRoot":"","sources":["../src/project-hook-native.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,sCAAsC,CAAC;AAmCvF,+FAA+F;AAC/F,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,wBAAwB,CA+B1B;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,WAAW,EAAE,GACtB,uBAAuB,CA4CzB"}
+{"version":3,"file":"project-hook-native.d.ts","sourceRoot":"","sources":["../src/project-hook-native.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,sCAAsC,CAAC;AAmCvF,+FAA+F;AAC/F,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,wBAAwB,CA6C1B;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,EACjC,QAAQ,EAAE,WAAW,EAAE,GACtB,uBAAuB,CA4CzB"}

package/dist/project-hook-native.js

@@ -45,11 +45,19 @@ function normalizeNativeProjectHook(argv, body, cwd) {
     };
   const payload = JSON.parse(body || "{}");
   if (!object(payload)) throw new Error("HOOK_AGENT_INPUT_INVALID");
+  const sessionId = payload.session_id;
+  const nativeSession = typeof sessionId === "string" && sessionId.length > 0 && sessionId.length <= 256 && /^[a-z][a-z0-9-]{0,63}$/.test(provider) ? { sessionId, harness: provider } : void 0;
   return {
     cwd: typeof payload.cwd === "string" ? payload.cwd : cwd,
     provider,
     nativeEvent: typeof payload.hook_event_name === "string" ? payload.hook_event_name : event,
-    input: { schemaVersion: 1, source, event, toolInput: payload.tool_input ?? {} }
+    input: {
+      schemaVersion: 1,
+      source,
+      event,
+      toolInput: payload.tool_input ?? {},
+      ...nativeSession ? { nativeSession } : {}
+    }
   };
 }
 function renderNativeProjectHook(request, outcomes) {

package/dist/project-hook-native.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../src/project-hook-native.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["line"]
 }

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

@@ -55,6 +55,20 @@ export interface HeavyHookDetection {
  * @returns whether it is in use, and why.
  */
 export declare function detectHeavyHookProvider(provider: HeavyCommandHookProvider, projectDir: string, env?: Env): HeavyHookDetection;
+/**
+ * Install only CLEO's Stop dispatcher (`cleo hook stop`, T13796) for one
+ * provider in the project, whatever the heavy-command mode, and nothing
+ * else (no `PreToolUse` hook). `cleo goal install --harness claude|codex`
+ * uses it so the dispatcher runs the CLEO Goal tick (T13820). Project-level
+ * only: a project that is the home directory, a target in the user-global
+ * Claude config, or a shared `.codex/hooks.json` is refused unwritten.
+ * Never throws.
+ *
+ * @param projectDir - the project root.
+ * @param provider - `claude-code` or `codex`.
+ * @returns the outcome for that provider.
+ */
+export declare function syncProjectStopDispatch(projectDir: string, provider: 'claude-code' | 'codex'): Promise<HeavyHookDeliveryOutcome>;
 /**
  * Install, refresh or (mode `off`) remove CLEO's heavy-command hook for every
  * provider in use in `projectDir`, each independently: one provider's failure

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

@@ -1 +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;AA2B7B,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;AAqFD;;;;;;;;;;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,CA6CnB;AAED,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,EAAE,oBAIjC,CAAC"}
+{"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;AA8B7B,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;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,aAAa,GAAG,OAAO,GAChC,OAAO,CAAC,wBAAwB,CAAC,CA6BnC;AA4DD;;;;;;;;;;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,CA6CnB;AAED,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,EAAE,oBAKjC,CAAC"}

package/package.json

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

package/src/__tests__/harness-interop.test.ts

@@ -133,10 +133,23 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
  * `@cleocode/core`. Loading the SQL directly keeps the test hermetic without
  * re-implementing the schema inline.
  */
-const MIGRATION_SQL = resolve(
-  __dirname,
-  '../../../core/migrations/drizzle-tasks/20260417220000_t889-playbook-tables/migration.sql',
-);
+const PROJECT_MIGRATIONS = resolve(__dirname, '../../../core/migrations/drizzle-cleo-project');
+
+/** The playbook twins the state layer writes, as a project store creates them (T12535). */
+function playbookTwinSql(): string {
+  const consolidation = readFileSync(
+    resolve(PROJECT_MIGRATIONS, '20260531000001_t11363-consolidation-cleo-project/migration.sql'),
+    'utf8',
+  );
+  const tables = ['tasks_playbook_runs', 'tasks_playbook_approvals'].map(
+    (t) => consolidation.match(new RegExp(`CREATE TABLE \`${t}\` \\([\\s\\S]*?\\n\\);`))?.[0] ?? '',
+  );
+  const uids = readFileSync(
+    resolve(PROJECT_MIGRATIONS, '20261016120000_t12535-playbook-row-uids/migration.sql'),
+    'utf8',
+  );
+  return [...tables, uids].join('\n--> statement-breakpoint\n');
+}
 
 /** Absolute path to the rcasd.cantbook starter playbook (T934). */
 const RCASD_CANTBOOK = resolve(__dirname, '../../../playbooks/starter/rcasd.cantbook');
@@ -263,7 +276,7 @@ describe('T937 — harness interop: playbook runtime across provider adapters',
   beforeEach(() => {
     db = new DatabaseSync(':memory:');
     db.exec('PRAGMA foreign_keys=ON');
-    applyMigration(db, readFileSync(MIGRATION_SQL, 'utf8'));
+    applyMigration(db, playbookTwinSql());
 
     anthropicCalls.length = 0;
     openaiCalls.length = 0;
@@ -393,7 +406,7 @@ describe('T937 — harness interop: playbook runtime across provider adapters',
       // Reset per-provider state so DB rows don't collide.
       const freshDb = new DatabaseSync(':memory:');
       freshDb.exec('PRAGMA foreign_keys=ON');
-      applyMigration(freshDb, readFileSync(MIGRATION_SQL, 'utf8'));
+      applyMigration(freshDb, playbookTwinSql());
 
       const result = await executePlaybook({
         db: freshDb,

package/src/project-hook-native.ts

@@ -69,11 +69,25 @@ export function normalizeNativeProjectHook(
     };
   const payload = JSON.parse(body || '{}') as HookJsonValue;
   if (!object(payload)) throw new Error('HOOK_AGENT_INPUT_INVALID');
+  const sessionId = payload.session_id;
+  const nativeSession =
+    typeof sessionId === 'string' &&
+    sessionId.length > 0 &&
+    sessionId.length <= 256 &&
+    /^[a-z][a-z0-9-]{0,63}$/.test(provider)
+      ? { sessionId, harness: provider }
+      : undefined;
   return {
     cwd: typeof payload.cwd === 'string' ? payload.cwd : cwd,
     provider,
     nativeEvent: typeof payload.hook_event_name === 'string' ? payload.hook_event_name : event,
-    input: { schemaVersion: 1, source, event, toolInput: payload.tool_input ?? {} },
+    input: {
+      schemaVersion: 1,
+      source,
+      event,
+      toolInput: payload.tool_input ?? {},
+      ...(nativeSession ? { nativeSession } : {}),
+    },
   };
 }
 

package/src/providers/shared/heavy-command-hook-delivery.ts

@@ -37,12 +37,15 @@ import type {
   HeavyHookInspection,
 } from '@cleocode/contracts';
 import { findOnPath } from '@cleocode/paths';
+import { projectClaudeSettingsPath } from '../claude-code/paths.js';
 import {
   CLAUDE_LOCAL_SETTINGS,
   CODEX_HOOKS_FILE,
   codexHookSnippet,
   codexHooksSharedReason,
   excludedByCleo,
+  excludeHookFileFromGit,
+  excludeLocalSettingsFromGit,
   HEAVY_COMMAND_HOOK_ID,
   HeavyHookPathBlockedError,
   HeavyHookSharedConfigError,
@@ -212,6 +215,53 @@ async function syncStopDispatch(
   }
 }
 
+/**
+ * Install only CLEO's Stop dispatcher (`cleo hook stop`, T13796) for one
+ * provider in the project, whatever the heavy-command mode, and nothing
+ * else (no `PreToolUse` hook). `cleo goal install --harness claude|codex`
+ * uses it so the dispatcher runs the CLEO Goal tick (T13820). Project-level
+ * only: a project that is the home directory, a target in the user-global
+ * Claude config, or a shared `.codex/hooks.json` is refused unwritten.
+ * Never throws.
+ *
+ * @param projectDir - the project root.
+ * @param provider - `claude-code` or `codex`.
+ * @returns the outcome for that provider.
+ */
+export async function syncProjectStopDispatch(
+  projectDir: string,
+  provider: 'claude-code' | 'codex',
+): Promise<HeavyHookDeliveryOutcome> {
+  let target = heavyHookTarget(provider, projectDir);
+  if (isUserHomeDir(projectDir)) {
+    return {
+      provider,
+      status: 'skipped',
+      target,
+      reason: 'the project is the home directory, whose .claude/ and .codex/ are user-global',
+      remedy: 'run it from a project directory',
+    };
+  }
+  try {
+    if (provider === 'claude-code') target = projectClaudeSettingsPath(projectDir);
+    else {
+      const shared = codexHooksSharedReason(projectDir);
+      if (shared !== null) throw new HeavyHookSharedConfigError(target, shared);
+    }
+    const status = await syncJsonStopDispatchHook(target, provider, true);
+    if (provider === 'claude-code') excludeLocalSettingsFromGit(projectDir);
+    else excludeHookFileFromGit(projectDir, CODEX_HOOKS_FILE);
+    return { provider, status, target };
+  } catch (err) {
+    return {
+      provider,
+      status: err instanceof HeavyHookSharedConfigError ? 'needs-consent' : 'failed',
+      target,
+      reason: errorText(err),
+    };
+  }
+}
+
 async function syncProvider(
   provider: HeavyCommandHookProvider,
   projectDir: string,
@@ -645,6 +695,7 @@ export function probeHeavyHookCli(
 /** The delivery surface `@cleocode/core` loads at run time. */
 export const heavyHookDeliveryApi: HeavyHookDeliveryApi = Object.freeze({
   syncProjectHeavyCommandHooks,
+  syncProjectStopDispatch,
   inspectProjectHeavyCommandHooks,
   probeHeavyHookCli,
 });