@loicngr/kobo 1.7.25 → 1.7.26

package/CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to Kōbō are documented here. The format is based on
 [Keep a Changelog](https://keepachangelog.com/). Each release is an `## <version>`
 section — the in-app "What's new" dialog reads this file.
 
+## 1.7.26
+
+- fix(claude-code-engine): migrate compaction reminder to SessionStart hook
+
 ## 1.7.25
 
 - feat(models): add Claude Opus 4.8 and make it the default

package/dist/server/services/agent/engines/claude-code/engine.js

@@ -3,7 +3,7 @@ import { nanoid } from 'nanoid';
 import { CLAUDE_CODE_CAPABILITIES } from './capabilities.js';
 import { createMapperState, mapSdkMessage, QUOTA_PATTERN, tryEmitQuota } from './event-mapper.js';
 import { buildClaudeOptions } from './options-builder.js';
-import { buildPreCompactCustomInstructions } from './precompact-hook.js';
+import { buildCompactionSessionStartOutput } from './precompact-hook.js';
 import { resolveClaudeBinaryPath } from './resolve-binary.js';
 /**
  * Grace window between the SDK's terminal `result` message and the generator
@@ -71,24 +71,20 @@ export function createClaudeCodeEngine() {
                     });
                 });
             };
-            // PreCompact's hookSpecificOutput is missing from the SDK type union
-            // (SyncHookJSONOutput omits it), but the runtime accepts
-            // `additionalContext` as custom compaction instructions. Cast through
-            // `unknown` to satisfy the strict union.
+            // Re-inject the workspace's task/criteria reminder after a compaction.
+            // The current Claude Code hook schema dropped PreCompact's
+            // hookSpecificOutput, so the old `{ hookEventName: 'PreCompact', … }`
+            // return is rejected at runtime with a ZodError. We use SessionStart
+            // instead — it fires with `source: 'compact'` after compaction and does
+            // support `additionalContext`. `buildCompactionSessionStartOutput` gates
+            // on the compact source so normal startup/resume/clear inject nothing.
             const hooks = {
-                PreCompact: [
+                SessionStart: [
                     {
                         hooks: [
-                            async () => {
-                                const reminder = buildPreCompactCustomInstructions(options.workspaceId);
-                                if (!reminder)
-                                    return {};
-                                return {
-                                    hookSpecificOutput: {
-                                        hookEventName: 'PreCompact',
-                                        additionalContext: reminder,
-                                    },
-                                };
+                            async (input) => {
+                                const source = input.source ?? '';
+                                return buildCompactionSessionStartOutput(options.workspaceId, source);
                             },
                         ],
                     },

package/dist/server/services/agent/engines/claude-code/precompact-hook.js

@@ -25,3 +25,25 @@ export function buildPreCompactCustomInstructions(workspaceId) {
     }
     return out;
 }
+/**
+ * Decide what a SessionStart hook should return so the post-compaction segment
+ * keeps the workspace's tasks and acceptance criteria in context.
+ *
+ * The reminder is injected ONLY when the session segment starts because of a
+ * compaction (`source === 'compact'`) — normal startup/resume/clear get
+ * nothing, matching the prior PreCompact-hook semantics.
+ *
+ * This replaces the old PreCompact `hookSpecificOutput` injection: the current
+ * Claude Code hook schema dropped `PreCompactHookSpecificOutput`, so emitting
+ * `{ hookEventName: 'PreCompact', additionalContext }` is rejected at runtime
+ * with a ZodError. `SessionStart` (which fires with `source: 'compact'` after
+ * compaction) does support `additionalContext` and is a valid output.
+ */
+export function buildCompactionSessionStartOutput(workspaceId, source) {
+    if (source !== 'compact')
+        return {};
+    const reminder = buildPreCompactCustomInstructions(workspaceId);
+    if (!reminder)
+        return {};
+    return { hookSpecificOutput: { hookEventName: 'SessionStart', additionalContext: reminder } };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loicngr/kobo",
-  "version": "1.7.25",
+  "version": "1.7.26",
   "description": "Kōbō — multi-workspace agent manager for Claude Code. Orchestrates isolated git worktrees with dev servers, Notion integration, and MCP tools.",
   "type": "module",
   "license": "GPL-3.0-or-later",