@scotthamilton77/sidekick 0.1.8 → 0.1.10

package/dist/bin.js

@@ -1030,7 +1030,7 @@ var require_events = __commonJS({
   "../types/dist/events.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.HOOK_NAMES = void 0;
+    exports2.UI_EVENT_VISIBILITY = exports2.UI_EVENT_TYPES = exports2.HOOK_NAMES = void 0;
     exports2.isHookEvent = isHookEvent;
     exports2.isTranscriptEvent = isTranscriptEvent;
     exports2.isSessionStartEvent = isSessionStartEvent;
@@ -1092,6 +1092,92 @@ var require_events = __commonJS({
     function isTranscriptLoggingEvent(event) {
       return event.source === "transcript";
     }
+    exports2.UI_EVENT_TYPES = [
+      // Reminder events
+      "reminder:staged",
+      "reminder:unstaged",
+      "reminder:consumed",
+      "reminder:cleared",
+      "reminder:not-staged",
+      // Decision events
+      "decision:recorded",
+      // Session summary events
+      "session-summary:start",
+      "session-summary:finish",
+      // Session state change events
+      "session-title:changed",
+      "intent:changed",
+      // Snarky message events
+      "snarky-message:start",
+      "snarky-message:finish",
+      // Resume message events
+      "resume-message:start",
+      "resume-message:finish",
+      // Persona events
+      "persona:selected",
+      "persona:changed",
+      // Statusline events
+      "statusline:rendered",
+      // Hook lifecycle events
+      "hook:received",
+      "hook:completed",
+      // Daemon event processing
+      "event:received",
+      "event:processed",
+      // Daemon lifecycle events
+      "daemon:starting",
+      "daemon:started",
+      "ipc:started",
+      "config:watcher-started",
+      "session:eviction-started",
+      // Skipped operation events
+      "session-summary:skipped",
+      "resume-message:skipped",
+      // Error events
+      "statusline:error",
+      // Transcript events
+      "transcript:emitted",
+      "transcript:pre-compact",
+      // General error
+      "error:occurred"
+    ];
+    exports2.UI_EVENT_VISIBILITY = {
+      // Timeline events (user-visible state changes)
+      "reminder:staged": "timeline",
+      "reminder:unstaged": "timeline",
+      "reminder:consumed": "timeline",
+      "reminder:cleared": "timeline",
+      "reminder:not-staged": "log",
+      "decision:recorded": "timeline",
+      "session-summary:start": "timeline",
+      "session-summary:finish": "timeline",
+      "session-title:changed": "timeline",
+      "intent:changed": "timeline",
+      "snarky-message:start": "timeline",
+      "snarky-message:finish": "timeline",
+      "resume-message:start": "timeline",
+      "resume-message:finish": "timeline",
+      "persona:selected": "timeline",
+      "persona:changed": "timeline",
+      "statusline:rendered": "timeline",
+      // Both (timeline + log viewer)
+      "hook:received": "both",
+      "hook:completed": "both",
+      "statusline:error": "both",
+      "error:occurred": "both",
+      // Log-only (internal machinery)
+      "event:received": "log",
+      "event:processed": "log",
+      "daemon:starting": "log",
+      "daemon:started": "log",
+      "ipc:started": "log",
+      "config:watcher-started": "log",
+      "session:eviction-started": "log",
+      "session-summary:skipped": "log",
+      "resume-message:skipped": "log",
+      "transcript:emitted": "log",
+      "transcript:pre-compact": "log"
+    };
   }
 });
 
@@ -17228,6 +17314,7 @@ var require_state = __commonJS({
     exports2.createDefaultLLMMetrics = createDefaultLLMMetrics;
     var zod_1 = require_zod();
     var events_js_1 = require_events();
+    var staging_js_1 = require_staging();
     exports2.SessionSummaryStateSchema = zod_1.z.object({
       /** Session identifier */
       session_id: zod_1.z.string(),
@@ -17389,16 +17476,7 @@ var require_state = __commonJS({
       lastMatchedScope: zod_1.z.enum(["project", "package", "file"]).nullable().optional()
     });
     exports2.VerificationToolsStateSchema = zod_1.z.record(zod_1.z.string(), exports2.VerificationToolStatusSchema);
-    exports2.CachedReminderSchema = zod_1.z.object({
-      name: zod_1.z.string(),
-      blocking: zod_1.z.boolean(),
-      priority: zod_1.z.number(),
-      persistent: zod_1.z.boolean(),
-      throttle: zod_1.z.boolean().optional(),
-      userMessage: zod_1.z.string().optional(),
-      additionalContext: zod_1.z.string().optional(),
-      reason: zod_1.z.string().optional()
-    });
+    exports2.CachedReminderSchema = staging_js_1.StagedReminderSchema.omit({ stagedAt: true });
     exports2.ReminderThrottleEntrySchema = zod_1.z.object({
       /** Number of conversation messages since the reminder was last staged */
       messagesSinceLastStaging: zod_1.z.number().int().nonnegative(),
@@ -17979,6 +18057,24 @@ var require_setup_status = __commonJS({
   }
 });
 
+// ../types/dist/state.js
+var require_state2 = __commonJS({
+  "../types/dist/state.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.ProjectRegistryEntrySchema = void 0;
+    var zod_1 = require_zod();
+    exports2.ProjectRegistryEntrySchema = zod_1.z.object({
+      /** Absolute filesystem path to the project root */
+      path: zod_1.z.string(),
+      /** Human-readable project name (derived from directory name) */
+      displayName: zod_1.z.string(),
+      /** ISO 8601 timestamp of last daemon activity */
+      lastActive: zod_1.z.iso.datetime()
+    });
+  }
+});
+
 // ../types/dist/index.js
 var require_dist = __commonJS({
   "../types/dist/index.js"(exports2) {
@@ -18010,6 +18106,7 @@ var require_dist = __commonJS({
     __exportStar(require_tasks(), exports2);
     __exportStar(require_hook_input(), exports2);
     __exportStar(require_setup_status(), exports2);
+    __exportStar(require_state2(), exports2);
   }
 });
 
@@ -27755,9 +27852,13 @@ var require_config2 = __commonJS({
       state: v4_1.z.string(),
       assets: v4_1.z.string().optional()
     }).strict();
+    var ProjectsSchema = v4_1.z.object({
+      retentionDays: v4_1.z.number().min(1)
+    }).strict();
     var DaemonSchema = v4_1.z.object({
       idleTimeoutMs: v4_1.z.number().min(0),
-      shutdownTimeoutMs: v4_1.z.number().min(0)
+      shutdownTimeoutMs: v4_1.z.number().min(0),
+      projects: ProjectsSchema.default({ retentionDays: 30 })
     }).strict();
     var IpcSchema = v4_1.z.object({
       connectTimeoutMs: v4_1.z.number().min(0),
@@ -45661,7 +45762,7 @@ var require_structured_logging = __commonJS({
        */
       hookReceived(context, metadata) {
         return {
-          type: "HookReceived",
+          type: "hook:received",
           time: Date.now(),
           source: "cli",
           context: {
@@ -45671,7 +45772,9 @@ var require_structured_logging = __commonJS({
             hook: context.hook
           },
           payload: {
-            metadata
+            hook: context.hook,
+            cwd: metadata.cwd,
+            mode: metadata.mode
           }
         };
       },
@@ -45680,7 +45783,7 @@ var require_structured_logging = __commonJS({
        */
       hookCompleted(context, metadata, state) {
         return {
-          type: "HookCompleted",
+          type: "hook:completed",
           time: Date.now(),
           source: "cli",
           context: {
@@ -45690,8 +45793,10 @@ var require_structured_logging = __commonJS({
             hook: context.hook
           },
           payload: {
-            state,
-            metadata
+            hook: context.hook,
+            durationMs: metadata.durationMs,
+            reminderReturned: state?.reminderReturned,
+            responseType: state?.responseType
           }
         };
       },
@@ -45701,7 +45806,7 @@ var require_structured_logging = __commonJS({
        */
       eventReceived(context, metadata) {
         return {
-          type: "EventReceived",
+          type: "event:received",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -45712,7 +45817,9 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            metadata
+            eventKind: metadata.eventKind,
+            ...metadata.eventType !== void 0 && { eventType: metadata.eventType },
+            ...metadata.hook !== void 0 && { hook: metadata.hook }
           }
         };
       },
@@ -45722,7 +45829,7 @@ var require_structured_logging = __commonJS({
        */
       eventProcessed(context, state, metadata) {
         return {
-          type: "EventProcessed",
+          type: "event:processed",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -45733,17 +45840,19 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            state,
-            metadata
+            handlerId: state.handlerId,
+            success: state.success,
+            durationMs: metadata.durationMs,
+            error: metadata.error
           }
         };
       },
       /**
        * Create a ReminderStaged event (logged when Daemon stages a reminder file).
        */
-      reminderStaged(context, state, metadata) {
+      reminderStaged(context, state, _metadata) {
         return {
-          type: "ReminderStaged",
+          type: "reminder:staged",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -45754,8 +45863,14 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            state,
-            metadata
+            reminderName: state.reminderName,
+            hookName: state.hookName,
+            blocking: state.blocking,
+            priority: state.priority,
+            persistent: state.persistent,
+            ...state.reason !== void 0 && { reason: state.reason },
+            ...state.triggeredBy !== void 0 && { triggeredBy: state.triggeredBy },
+            ...state.thresholdState !== void 0 && { thresholdState: state.thresholdState }
           }
         };
       },
@@ -45765,14 +45880,15 @@ var require_structured_logging = __commonJS({
        */
       daemonStarting(metadata) {
         return {
-          type: "DaemonStarting",
+          type: "daemon:starting",
           time: Date.now(),
           source: "daemon",
           context: {
             sessionId: ""
           },
           payload: {
-            metadata
+            projectDir: metadata.projectDir,
+            pid: metadata.pid
           }
         };
       },
@@ -45781,14 +45897,14 @@ var require_structured_logging = __commonJS({
        */
       daemonStarted(metadata) {
         return {
-          type: "DaemonStarted",
+          type: "daemon:started",
           time: Date.now(),
           source: "daemon",
           context: {
             sessionId: ""
           },
           payload: {
-            metadata
+            startupDurationMs: metadata.startupDurationMs
           }
         };
       },
@@ -45797,14 +45913,14 @@ var require_structured_logging = __commonJS({
        */
       ipcServerStarted(metadata) {
         return {
-          type: "IpcServerStarted",
+          type: "ipc:started",
           time: Date.now(),
           source: "daemon",
           context: {
             sessionId: ""
           },
           payload: {
-            metadata
+            socketPath: metadata.socketPath
           }
         };
       },
@@ -45813,14 +45929,15 @@ var require_structured_logging = __commonJS({
        */
       configWatcherStarted(metadata) {
         return {
-          type: "ConfigWatcherStarted",
+          type: "config:watcher-started",
           time: Date.now(),
           source: "daemon",
           context: {
             sessionId: ""
           },
           payload: {
-            metadata
+            projectDir: metadata.projectDir,
+            watchedFiles: metadata.watchedFiles
           }
         };
       },
@@ -45829,14 +45946,14 @@ var require_structured_logging = __commonJS({
        */
       sessionEvictionStarted(metadata) {
         return {
-          type: "SessionEvictionStarted",
+          type: "session:eviction-started",
           time: Date.now(),
           source: "daemon",
           context: {
             sessionId: ""
           },
           payload: {
-            metadata
+            intervalMs: metadata.intervalMs
           }
         };
       },
@@ -45847,7 +45964,7 @@ var require_structured_logging = __commonJS({
        */
       statuslineRendered(context, state, metadata) {
         return {
-          type: "StatuslineRendered",
+          type: "statusline:rendered",
           time: Date.now(),
           source: "cli",
           context: {
@@ -45858,8 +45975,11 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            state,
-            metadata
+            displayMode: state.displayMode,
+            staleData: state.staleData,
+            model: metadata.model,
+            tokens: metadata.tokens,
+            durationMs: metadata.durationMs
           }
         };
       },
@@ -45869,7 +45989,7 @@ var require_structured_logging = __commonJS({
        */
       statuslineError(context, reason, metadata) {
         return {
-          type: "StatuslineError",
+          type: "statusline:error",
           time: Date.now(),
           source: "cli",
           context: {
@@ -45881,7 +46001,9 @@ var require_structured_logging = __commonJS({
           },
           payload: {
             reason,
-            metadata
+            file: metadata.file,
+            fallbackUsed: metadata.fallbackUsed,
+            error: metadata.error
           }
         };
       },
@@ -45892,7 +46014,7 @@ var require_structured_logging = __commonJS({
        */
       resumeGenerating(context, metadata) {
         return {
-          type: "ResumeGenerating",
+          type: "resume-message:start",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -45903,8 +46025,8 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            metadata,
-            reason: "pivot_detected"
+            title_confidence: metadata.title_confidence,
+            intent_confidence: metadata.intent_confidence
           }
         };
       },
@@ -45914,7 +46036,7 @@ var require_structured_logging = __commonJS({
        */
       resumeUpdated(context, state) {
         return {
-          type: "ResumeUpdated",
+          type: "resume-message:finish",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -45925,8 +46047,8 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            state,
-            reason: "generation_complete"
+            snarky_comment: state.snarky_comment,
+            timestamp: state.timestamp
           }
         };
       },
@@ -45936,7 +46058,7 @@ var require_structured_logging = __commonJS({
        */
       resumeSkipped(context, metadata, reason) {
         return {
-          type: "ResumeSkipped",
+          type: "resume-message:skipped",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -45947,11 +46069,50 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            metadata,
+            title_confidence: metadata.title_confidence,
+            intent_confidence: metadata.intent_confidence,
+            min_confidence: metadata.min_confidence,
             reason
           }
         };
       },
+      // --- Persona Events ---
+      /**
+       * Create a PersonaSelected event (logged when a persona is selected for a session).
+       */
+      personaSelected(context, payload) {
+        return {
+          type: "persona:selected",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload
+        };
+      },
+      /**
+       * Create a PersonaChanged event (logged when persona changes mid-session).
+       */
+      personaChanged(context, payload) {
+        return {
+          type: "persona:changed",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload
+        };
+      },
       // --- Transcript Events (logged to transcript-events.log) ---
       /**
        * Create a TranscriptEventEmitted event (logged when TranscriptService emits an event).
@@ -45959,7 +46120,7 @@ var require_structured_logging = __commonJS({
        */
       transcriptEventEmitted(context, state, metadata) {
         return {
-          type: "TranscriptEventEmitted",
+          type: "transcript:emitted",
           time: Date.now(),
           source: "transcript",
           context: {
@@ -45970,8 +46131,13 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            state,
-            metadata
+            eventType: state.eventType,
+            lineNumber: state.lineNumber,
+            uuid: state.uuid,
+            toolName: state.toolName,
+            transcriptPath: metadata.transcriptPath,
+            contentPreview: metadata.contentPreview,
+            metrics: metadata.metrics
           }
         };
       },
@@ -45981,7 +46147,7 @@ var require_structured_logging = __commonJS({
        */
       preCompactCaptured(context, state, metadata) {
         return {
-          type: "PreCompactCaptured",
+          type: "transcript:pre-compact",
           time: Date.now(),
           source: "transcript",
           context: {
@@ -45992,18 +46158,67 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            state,
-            metadata,
-            reason: "pre_compact_hook"
+            snapshotPath: state.snapshotPath,
+            lineCount: state.lineCount,
+            transcriptPath: metadata.transcriptPath,
+            metrics: metadata.metrics
+          }
+        };
+      },
+      // --- Error Events ---
+      /**
+       * Create a daemon ErrorOccurred event.
+       * @see packages/sidekick-daemon/src/daemon.ts — HookableLogger error hook calls this factory.
+       */
+      daemonErrorOccurred(context, state) {
+        return {
+          type: "error:occurred",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload: {
+            errorMessage: state.errorMessage,
+            errorStack: state.errorStack
+          }
+        };
+      },
+      /**
+       * Create a CLI ErrorOccurred event.
+       * Available for CLI error hook implementations.
+       */
+      cliErrorOccurred(context, state) {
+        return {
+          type: "error:occurred",
+          time: Date.now(),
+          source: "cli",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload: {
+            errorMessage: state.errorMessage,
+            errorStack: state.errorStack
           }
         };
       }
     };
     function logEvent(logger, event) {
-      logger.info(event.payload.reason ?? `${event.type}`, {
+      const payload = event.payload;
+      const meta = payload != null && typeof payload === "object" ? payload : {};
+      const reason = "reason" in meta ? String(meta.reason) : void 0;
+      logger.info(reason ?? `${event.type}`, {
         type: event.type,
         source: event.source,
-        ...event.payload
+        ...meta
       });
     }
     function setupGlobalErrorHandlers(logger) {
@@ -58040,7 +58255,7 @@ var require_staging_service = __commonJS({
        *
        * @throws Error if hookName or reminderName contain path traversal characters
        */
-      async stageReminder(sessionId, hookName, reminderName, data) {
+      async stageReminder(sessionId, hookName, reminderName, data, enrichment) {
         (0, staging_paths_js_1.validatePathSegment)(hookName, "hookName");
         (0, staging_paths_js_1.validatePathSegment)(reminderName, "reminderName");
         const hookDir = this.getHookDirPath(sessionId, hookName);
@@ -58069,7 +58284,8 @@ var require_staging_service = __commonJS({
           hookName,
           blocking: data.blocking,
           priority: data.priority,
-          persistent: data.persistent
+          persistent: data.persistent,
+          ...enrichment
         }, { stagingPath: reminderPath });
         (0, structured_logging_1.logEvent)(this.options.logger, event);
       }
@@ -58213,8 +58429,8 @@ var require_staging_service = __commonJS({
       // ============================================================================
       // StagingService Interface Implementation (delegates to core)
       // ============================================================================
-      async stageReminder(hookName, reminderName, data) {
-        return this.core.stageReminder(this.sessionId, hookName, reminderName, data);
+      async stageReminder(hookName, reminderName, data, enrichment) {
+        return this.core.stageReminder(this.sessionId, hookName, reminderName, data, enrichment);
       }
       async readReminder(hookName, reminderName) {
         return this.core.readReminder(this.sessionId, hookName, reminderName);
@@ -61136,7 +61352,7 @@ var require_log_metrics_descriptors = __commonJS({
 });
 
 // ../sidekick-core/dist/state/index.js
-var require_state2 = __commonJS({
+var require_state3 = __commonJS({
   "../sidekick-core/dist/state/index.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -61235,7 +61451,7 @@ var require_transcript_service = __commonJS({
     var node_readline_12 = require("node:readline");
     var node_path_1 = require("node:path");
     var structured_logging_js_1 = require_structured_logging();
-    var index_js_1 = require_state2();
+    var index_js_1 = require_state3();
     var EXCLUDED_BUILTIN_COMMANDS = /* @__PURE__ */ new Set([
       "/add-dir",
       "/agents",
@@ -63205,6 +63421,120 @@ var require_hookable_logger = __commonJS({
   }
 });
 
+// ../sidekick-core/dist/project-registry.js
+var require_project_registry = __commonJS({
+  "../sidekick-core/dist/project-registry.js"(exports2) {
+    "use strict";
+    var __importDefault2 = exports2 && exports2.__importDefault || function(mod) {
+      return mod && mod.__esModule ? mod : { "default": mod };
+    };
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.ProjectRegistryService = void 0;
+    exports2.encodeProjectDir = encodeProjectDir;
+    var node_fs_1 = require("node:fs");
+    var promises_12 = __importDefault2(require("node:fs/promises"));
+    var node_crypto_1 = require("node:crypto");
+    var node_path_1 = require("node:path");
+    var types_1 = require_dist();
+    function encodeProjectDir(absPath) {
+      return absPath.replace(/\//g, "-");
+    }
+    var REGISTRY_FILE = "registry.json";
+    var ProjectRegistryService = class {
+      registryRoot;
+      constructor(registryRoot) {
+        this.registryRoot = registryRoot;
+      }
+      /**
+       * Register or update a project in the registry.
+       * Creates the directory and writes registry.json with current timestamp.
+       */
+      async register(projectDir) {
+        const encoded = encodeProjectDir(projectDir);
+        const entryDir = (0, node_path_1.join)(this.registryRoot, encoded);
+        const entryFile = (0, node_path_1.join)(entryDir, REGISTRY_FILE);
+        await promises_12.default.mkdir(entryDir, { recursive: true });
+        const entry = {
+          path: projectDir,
+          displayName: (0, node_path_1.basename)(projectDir),
+          lastActive: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        const tmpPath = `${entryFile}.${(0, node_crypto_1.randomBytes)(6).toString("hex")}.tmp`;
+        try {
+          await promises_12.default.writeFile(tmpPath, JSON.stringify(entry, null, 2), "utf-8");
+          await promises_12.default.rename(tmpPath, entryFile);
+        } catch (err) {
+          await promises_12.default.unlink(tmpPath).catch(() => {
+          });
+          throw err;
+        }
+      }
+      /**
+       * List all valid registered projects.
+       * Skips entries with missing/invalid registry.json.
+       */
+      async list() {
+        if (!(0, node_fs_1.existsSync)(this.registryRoot)) {
+          return [];
+        }
+        const entries = [];
+        const dirents = await promises_12.default.readdir(this.registryRoot, { withFileTypes: true });
+        for (const dirent of dirents) {
+          if (!dirent.isDirectory())
+            continue;
+          const entryFile = (0, node_path_1.join)(this.registryRoot, dirent.name, REGISTRY_FILE);
+          try {
+            const raw = await promises_12.default.readFile(entryFile, "utf-8");
+            const parsed = types_1.ProjectRegistryEntrySchema.parse(JSON.parse(raw));
+            entries.push(parsed);
+          } catch {
+          }
+        }
+        return entries;
+      }
+      /**
+       * Prune stale registry entries.
+       * Removes entries where the project path no longer exists
+       * or lastActive is older than retentionDays.
+       */
+      async prune(options) {
+        if (!(0, node_fs_1.existsSync)(this.registryRoot)) {
+          return [];
+        }
+        const pruned = [];
+        const cutoff = Date.now() - options.retentionDays * 24 * 60 * 60 * 1e3;
+        const dirents = await promises_12.default.readdir(this.registryRoot, { withFileTypes: true });
+        for (const dirent of dirents) {
+          if (!dirent.isDirectory())
+            continue;
+          const entryDir = (0, node_path_1.join)(this.registryRoot, dirent.name);
+          const entryFile = (0, node_path_1.join)(entryDir, REGISTRY_FILE);
+          let entry;
+          try {
+            const raw = await promises_12.default.readFile(entryFile, "utf-8");
+            entry = types_1.ProjectRegistryEntrySchema.parse(JSON.parse(raw));
+          } catch {
+            await promises_12.default.rm(entryDir, { recursive: true, force: true });
+            continue;
+          }
+          let reason = null;
+          if (!(0, node_fs_1.existsSync)(entry.path)) {
+            reason = "path-missing";
+          } else if (new Date(entry.lastActive).getTime() < cutoff) {
+            reason = "age-exceeded";
+          }
+          if (reason) {
+            await promises_12.default.rm(entryDir, { recursive: true, force: true });
+            pruned.push({ path: entry.path, reason });
+          }
+        }
+        return pruned;
+      }
+    };
+    exports2.ProjectRegistryService = ProjectRegistryService;
+  }
+});
+
 // ../sidekick-core/dist/daemon-health.js
 var require_daemon_health = __commonJS({
   "../sidekick-core/dist/daemon-health.js"(exports2) {
@@ -63448,7 +63778,7 @@ var require_dist4 = __commonJS({
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.SIDEKICK_SECTION_START = exports2.detectGitignoreStatus = exports2.removeGitignoreSection = exports2.installGitignoreSection = exports2.validateOpenAIKey = exports2.validateOpenRouterKey = exports2.createSetupStatusService = exports2.SetupStatusService = exports2.DaemonClient = exports2.findZombieDaemons = exports2.killZombieDaemons = exports2.killAllDaemons = exports2.logEvent = exports2.LogEvents = exports2.DEFAULT_MAX_FILES = exports2.DEFAULT_ROTATE_SIZE_BYTES = exports2.getComponentLogLevel = exports2.setupGlobalErrorHandlers = exports2.createLoggerFacade = exports2.createLogManager = exports2.createConsoleLogger = exports2.getUserDaemonsDir = exports2.getUserPidPath = exports2.getTokenPath = exports2.getSocketPath = exports2.getProjectHash = exports2.getPidPath = exports2.getLockPath = exports2.IpcService = exports2.IpcServer = exports2.loadPersonaFile = exports2.getDefaultPersonasDir = exports2.discoverPersonas = exports2.createPersonaLoader = exports2.reconstructTranscriptPath = exports2.encodeProjectPath = exports2.isPreCompactEvent = exports2.isStopEvent = exports2.isPostToolUseEvent = exports2.isPreToolUseEvent = exports2.isUserPromptSubmitEvent = exports2.isSessionEndEvent = exports2.isSessionStartEvent = exports2.isTranscriptEvent = exports2.isHookEvent = exports2.MetricsPersistPayloadSchema = exports2.CleanupPayloadSchema = exports2.ResumeGenerationPayloadSchema = exports2.SessionSummaryPayloadSchema = exports2.TaskTypes = void 0;
-    exports2.loadUserProfile = exports2.parseGitStatusOutput = exports2.getGitFileStatus = exports2.isInSandbox = exports2.updateDaemonHealth = exports2.readDaemonHealth = exports2.DaemonGlobalLogMetricsDescriptor = exports2.CliLogMetricsDescriptor = exports2.DaemonLogMetricsDescriptor = exports2.CompactionHistoryDescriptor = exports2.TranscriptMetricsDescriptor = exports2.GlobalStateAccessor = exports2.SessionStateAccessor = exports2.globalState = exports2.sessionState = exports2.StateCorruptError = exports2.StateNotFoundError = exports2.StateService = exports2.createHookableLogger = exports2.InstrumentedProfileProviderFactory = exports2.InstrumentedLLMProvider = exports2.ServiceFactoryImpl = exports2.TranscriptServiceImpl = exports2.createDefaultTokenUsage = exports2.createDefaultMetrics = exports2.copyWithTimestampSync = exports2.renameWithTimestampSync = exports2.renameWithTimestamp = exports2.copyWithTimestamp = exports2.getTimestampedPath = exports2.extractToolResultPreview = exports2.extractToolCallPreview = exports2.extractTextFromContent = exports2.extractContentPreview = exports2.HandlerRegistryImpl = exports2.extractConsumedTimestamp = exports2.createConsumedFilePattern = exports2.CONSUMED_FILE_PATTERN = exports2.filterActiveReminderFiles = exports2.validatePathSegment = exports2.isValidPathSegment = exports2.getReminderPath = exports2.getHookDir = exports2.getStagingRoot = exports2.SessionScopedStagingService = exports2.StagingServiceCore = exports2.GITIGNORE_ENTRIES = exports2.SIDEKICK_SECTION_END = void 0;
+    exports2.loadUserProfile = exports2.parseGitStatusOutput = exports2.getGitFileStatus = exports2.isInSandbox = exports2.updateDaemonHealth = exports2.readDaemonHealth = exports2.ProjectRegistryService = exports2.encodeProjectDir = exports2.DaemonGlobalLogMetricsDescriptor = exports2.CliLogMetricsDescriptor = exports2.DaemonLogMetricsDescriptor = exports2.CompactionHistoryDescriptor = exports2.TranscriptMetricsDescriptor = exports2.GlobalStateAccessor = exports2.SessionStateAccessor = exports2.globalState = exports2.sessionState = exports2.StateCorruptError = exports2.StateNotFoundError = exports2.StateService = exports2.createHookableLogger = exports2.InstrumentedProfileProviderFactory = exports2.InstrumentedLLMProvider = exports2.ServiceFactoryImpl = exports2.TranscriptServiceImpl = exports2.createDefaultTokenUsage = exports2.createDefaultMetrics = exports2.copyWithTimestampSync = exports2.renameWithTimestampSync = exports2.renameWithTimestamp = exports2.copyWithTimestamp = exports2.getTimestampedPath = exports2.extractToolResultPreview = exports2.extractToolCallPreview = exports2.extractTextFromContent = exports2.extractContentPreview = exports2.HandlerRegistryImpl = exports2.extractConsumedTimestamp = exports2.createConsumedFilePattern = exports2.CONSUMED_FILE_PATTERN = exports2.filterActiveReminderFiles = exports2.validatePathSegment = exports2.isValidPathSegment = exports2.getReminderPath = exports2.getHookDir = exports2.getStagingRoot = exports2.SessionScopedStagingService = exports2.StagingServiceCore = exports2.GITIGNORE_ENTRIES = exports2.SIDEKICK_SECTION_END = void 0;
     var types_1 = require_dist();
     Object.defineProperty(exports2, "TaskTypes", { enumerable: true, get: function() {
       return types_1.TaskTypes;
@@ -63721,7 +64051,7 @@ var require_dist4 = __commonJS({
     Object.defineProperty(exports2, "createHookableLogger", { enumerable: true, get: function() {
       return hookable_logger_1.createHookableLogger;
     } });
-    var index_js_1 = require_state2();
+    var index_js_1 = require_state3();
     Object.defineProperty(exports2, "StateService", { enumerable: true, get: function() {
       return index_js_1.StateService;
     } });
@@ -63758,6 +64088,13 @@ var require_dist4 = __commonJS({
     Object.defineProperty(exports2, "DaemonGlobalLogMetricsDescriptor", { enumerable: true, get: function() {
       return index_js_1.DaemonGlobalLogMetricsDescriptor;
     } });
+    var project_registry_1 = require_project_registry();
+    Object.defineProperty(exports2, "encodeProjectDir", { enumerable: true, get: function() {
+      return project_registry_1.encodeProjectDir;
+    } });
+    Object.defineProperty(exports2, "ProjectRegistryService", { enumerable: true, get: function() {
+      return project_registry_1.ProjectRegistryService;
+    } });
     var daemon_health_1 = require_daemon_health();
     Object.defineProperty(exports2, "readDaemonHealth", { enumerable: true, get: function() {
       return daemon_health_1.readDaemonHealth;
@@ -70982,7 +71319,6 @@ var require_reminder_utils = __commonJS({
       blocking: zod_1.z.boolean(),
       priority: zod_1.z.number(),
       persistent: zod_1.z.boolean(),
-      throttle: zod_1.z.boolean().optional(),
       userMessage: zod_1.z.string().optional(),
       additionalContext: zod_1.z.string().optional(),
       reason: zod_1.z.string().optional()
@@ -71033,7 +71369,6 @@ var require_reminder_utils = __commonJS({
           blocking: def.blocking,
           priority: def.priority,
           persistent: def.persistent,
-          throttle: def.throttle,
           userMessage: def.userMessage ? interpolateTemplate(def.userMessage, context) : void 0,
           additionalContext: def.additionalContext ? interpolateTemplate(def.additionalContext, context) : void 0,
           reason: def.reason ? interpolateTemplate(def.reason, context) : void 0
@@ -71043,8 +71378,8 @@ var require_reminder_utils = __commonJS({
         return null;
       }
     }
-    async function stageReminder(ctx, hookName, reminder) {
-      await ctx.staging.stageReminder(hookName, reminder.name, reminder);
+    async function stageReminder(ctx, hookName, reminder, enrichment) {
+      await ctx.staging.stageReminder(hookName, reminder.name, reminder, enrichment);
       ctx.logger.debug("Staged reminder", { hookName, reminderName: reminder.name, priority: reminder.priority });
     }
     async function consumeReminder(ctx, hookName) {
@@ -71358,7 +71693,7 @@ var require_types2 = __commonJS({
 });
 
 // ../feature-reminders/dist/state.js
-var require_state3 = __commonJS({
+var require_state4 = __commonJS({
   "../feature-reminders/dist/state.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -71399,7 +71734,7 @@ var require_throttle_utils = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.registerThrottledReminder = registerThrottledReminder;
     exports2.resetThrottleCounters = resetThrottleCounters;
-    var state_js_1 = require_state3();
+    var state_js_1 = require_state4();
     async function registerThrottledReminder(ctx, sessionId, reminderId, targetHook, resolvedReminder) {
       const remindersState = (0, state_js_1.createRemindersState)(ctx.stateService);
       const result = await remindersState.reminderThrottle.read(sessionId);
@@ -71434,7 +71769,7 @@ var require_stage_default_user_prompt = __commonJS({
     var staging_handler_utils_js_1 = require_staging_handler_utils();
     var types_js_1 = require_types2();
     var reminder_utils_js_1 = require_reminder_utils();
-    var state_js_1 = require_state3();
+    var state_js_1 = require_state4();
     var throttle_utils_js_1 = require_throttle_utils();
     function registerStageDefaultUserPrompt(context) {
       (0, staging_handler_utils_js_1.createStagingHandler)(context, {
@@ -71590,16 +71925,128 @@ var require_stage_default_user_prompt = __commonJS({
   }
 });
 
+// ../feature-reminders/dist/events.js
+var require_events2 = __commonJS({
+  "../feature-reminders/dist/events.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.ReminderEvents = void 0;
+    exports2.ReminderEvents = {
+      /**
+       * Create a ReminderConsumed event (logged when CLI returns a staged reminder).
+       */
+      reminderConsumed(context, state, _metadata) {
+        return {
+          type: "reminder:consumed",
+          time: Date.now(),
+          source: "cli",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload: {
+            reminderName: state.reminderName,
+            reminderReturned: state.reminderReturned,
+            blocking: state.blocking,
+            priority: state.priority,
+            persistent: state.persistent,
+            ...state.classificationResult !== void 0 && {
+              classificationResult: state.classificationResult
+            }
+          }
+        };
+      },
+      // Note: reminderStaged stays in @sidekick/core (used by staging-service.ts, circular dep)
+      /**
+       * Create a ReminderUnstaged event (logged when a reminder is removed from staging).
+       */
+      reminderUnstaged(context, state) {
+        return {
+          type: "reminder:unstaged",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload: {
+            reminderName: state.reminderName,
+            hookName: state.hookName,
+            reason: state.reason,
+            ...state.triggeredBy !== void 0 && { triggeredBy: state.triggeredBy },
+            ...state.toolState !== void 0 && { toolState: state.toolState }
+          }
+        };
+      },
+      /**
+       * Create a RemindersCleared event (logged when staging directory is cleaned).
+       */
+      remindersCleared(context, state, reason) {
+        return {
+          type: "reminder:cleared",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload: {
+            clearedCount: state.clearedCount,
+            hookNames: state.hookNames,
+            reason
+          }
+        };
+      },
+      /**
+       * Create a ReminderNotStaged event (logged when daemon evaluates but decides not to stage).
+       */
+      reminderNotStaged(context, state) {
+        return {
+          type: "reminder:not-staged",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload: {
+            reminderName: state.reminderName,
+            hookName: state.hookName,
+            reason: state.reason,
+            ...state.threshold !== void 0 && { threshold: state.threshold },
+            ...state.currentValue !== void 0 && { currentValue: state.currentValue },
+            ...state.triggeredBy !== void 0 && { triggeredBy: state.triggeredBy }
+          }
+        };
+      }
+    };
+  }
+});
+
 // ../feature-reminders/dist/handlers/staging/stage-pause-and-reflect.js
 var require_stage_pause_and_reflect = __commonJS({
   "../feature-reminders/dist/handlers/staging/stage-pause-and-reflect.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.registerStagePauseAndReflect = registerStagePauseAndReflect;
+    var core_1 = require_dist4();
     var types_1 = require_dist();
+    var events_js_1 = require_events2();
     var staging_handler_utils_js_1 = require_staging_handler_utils();
     var types_js_1 = require_types2();
-    var state_js_1 = require_state3();
+    var state_js_1 = require_state4();
     function registerStagePauseAndReflect(context) {
       (0, staging_handler_utils_js_1.createStagingHandler)(context, {
         id: "reminders:stage-pause-and-reflect",
@@ -71610,15 +72057,17 @@ var require_stage_pause_and_reflect = __commonJS({
             return void 0;
           const metrics = event.metadata.metrics;
           const sessionId = event.context?.sessionId;
+          if (!sessionId) {
+            ctx.logger.warn("[stage-pause-and-reflect] No sessionId available, skipping");
+            return void 0;
+          }
           const featureConfig = context.config.getFeature("reminders");
           const config = { ...types_js_1.DEFAULT_REMINDERS_SETTINGS, ...featureConfig.settings };
           let prBaseline = null;
-          if (sessionId) {
-            const remindersState = (0, state_js_1.createRemindersState)(ctx.stateService);
-            const result = await remindersState.prBaseline.read(sessionId);
-            if (result.source !== "default") {
-              prBaseline = result.data;
-            }
+          const remindersState = (0, state_js_1.createRemindersState)(ctx.stateService);
+          const result = await remindersState.prBaseline.read(sessionId);
+          if (result.source !== "default") {
+            prBaseline = result.data;
           }
           let effectiveBaseline = 0;
           if (prBaseline && prBaseline.turnCount === metrics.turnCount) {
@@ -71630,12 +72079,28 @@ var require_stage_pause_and_reflect = __commonJS({
               effectiveBaseline = Math.max(effectiveBaseline, lastConsumed.stagedAt.toolsThisTurn);
             }
             const shouldReactivate = metrics.turnCount > lastConsumed.stagedAt.turnCount || metrics.toolsThisTurn >= effectiveBaseline + config.pause_and_reflect_threshold;
-            if (!shouldReactivate)
+            if (!shouldReactivate) {
+              (0, core_1.logEvent)(ctx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+                reminderName: "pause-and-reflect",
+                hookName: "PreToolUse",
+                reason: "same_turn",
+                triggeredBy: "tool_result"
+              }));
               return void 0;
+            }
           }
           const toolsSinceBaseline = metrics.toolsThisTurn - effectiveBaseline;
-          if (toolsSinceBaseline < config.pause_and_reflect_threshold)
+          if (toolsSinceBaseline < config.pause_and_reflect_threshold) {
+            (0, core_1.logEvent)(ctx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+              reminderName: "pause-and-reflect",
+              hookName: "PreToolUse",
+              reason: "below_threshold",
+              threshold: config.pause_and_reflect_threshold,
+              currentValue: toolsSinceBaseline,
+              triggeredBy: "tool_result"
+            }));
             return void 0;
+          }
           return {
             reminderId: types_js_1.ReminderIds.PAUSE_AND_REFLECT,
             targetHook: "PreToolUse",
@@ -73217,12 +73682,14 @@ var require_track_verification_tools = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.registerTrackVerificationTools = registerTrackVerificationTools;
     exports2.stageToolsForFiles = stageToolsForFiles;
+    var core_1 = require_dist4();
+    var events_js_1 = require_events2();
     var types_1 = require_dist();
     var picomatch_1 = __importDefault2(require_picomatch2());
     var tool_pattern_matcher_js_1 = require_tool_pattern_matcher();
     var reminder_utils_js_1 = require_reminder_utils();
     var types_js_1 = require_types2();
-    var state_js_1 = require_state3();
+    var state_js_1 = require_state4();
     var FILE_EDIT_TOOLS = ["Write", "Edit", "MultiEdit"];
     var TOOL_REMINDER_MAP = {
       build: types_js_1.ReminderIds.VC_BUILD,
@@ -73270,22 +73737,48 @@ var require_track_verification_tools = __commonJS({
         }
       });
     }
-    async function stageToolsForFiles(filePaths, daemonCtx, sessionId, verificationTools, toolsState, remindersState) {
+    async function stageToolsForFiles(filePaths, daemonCtx, sessionId, verificationTools, toolsState, remindersState, triggeredBy = "file_edit") {
       const existingReminders = await daemonCtx.staging.listReminders("Stop");
       const stagedNames = new Set(existingReminders.map((r) => r.name));
       let anyStaged = false;
+      const emittedNotStaged = /* @__PURE__ */ new Set();
       for (const filePath of filePaths) {
         for (const [toolName, toolConfig] of Object.entries(verificationTools)) {
-          if (!toolConfig.enabled)
-            continue;
           const reminderId = TOOL_REMINDER_MAP[toolName];
           if (!reminderId)
             continue;
-          if (!picomatch_1.default.isMatch(filePath, toolConfig.clearing_patterns))
+          if (!toolConfig.enabled) {
+            const emitKey = `${reminderId}:feature_disabled`;
+            if (!emittedNotStaged.has(emitKey)) {
+              emittedNotStaged.add(emitKey);
+              (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+                reminderName: reminderId,
+                hookName: "Stop",
+                reason: "feature_disabled",
+                triggeredBy
+              }));
+            }
             continue;
+          }
+          if (!picomatch_1.default.isMatch(filePath, toolConfig.clearing_patterns)) {
+            const emitKey = `${reminderId}:pattern_mismatch`;
+            if (!emittedNotStaged.has(emitKey)) {
+              emittedNotStaged.add(emitKey);
+              (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+                reminderName: reminderId,
+                hookName: "Stop",
+                reason: "pattern_mismatch",
+                triggeredBy
+              }));
+            }
+            continue;
+          }
           const current = toolsState[toolName];
           if (!current || current.status === "staged") {
-            const staged = await ensureToolReminderStaged(daemonCtx, reminderId, stagedNames);
+            const staged = await ensureToolReminderStaged(daemonCtx, reminderId, stagedNames, {
+              reason: current ? "re-staged" : "initial",
+              triggeredBy: "file_edit"
+            });
             if (staged) {
               if (!current) {
                 toolsState[toolName] = {
@@ -73301,7 +73794,11 @@ var require_track_verification_tools = __commonJS({
           } else {
             const newEdits = current.editsSinceVerified + 1;
             if (newEdits >= toolConfig.clearing_threshold) {
-              const staged = await ensureToolReminderStaged(daemonCtx, reminderId, stagedNames);
+              const staged = await ensureToolReminderStaged(daemonCtx, reminderId, stagedNames, {
+                reason: "threshold_reached",
+                triggeredBy: "file_edit",
+                thresholdState: { current: newEdits, threshold: toolConfig.clearing_threshold }
+              });
               if (staged) {
                 toolsState[toolName] = {
                   ...current,
@@ -73318,6 +73815,14 @@ var require_track_verification_tools = __commonJS({
                 status: "cooldown",
                 editsSinceVerified: newEdits
               };
+              (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+                reminderName: reminderId,
+                hookName: "Stop",
+                reason: "below_threshold",
+                threshold: toolConfig.clearing_threshold,
+                currentValue: newEdits,
+                triggeredBy
+              }));
             }
           }
         }
@@ -73363,6 +73868,16 @@ var require_track_verification_tools = __commonJS({
           lastMatchedScope: match.scope
         };
         await daemonCtx.staging.deleteReminder("Stop", reminderId);
+        (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderUnstaged({ sessionId }, {
+          reminderName: reminderId,
+          hookName: "Stop",
+          reason: "tool_verified",
+          triggeredBy: "verification_passed",
+          toolState: {
+            status: toolsState[toolName].status,
+            editsSinceVerified: toolsState[toolName].editsSinceVerified
+          }
+        }));
         anyUnstaged = true;
         daemonCtx.logger.debug("VC tool verified", {
           toolName,
@@ -73377,12 +73892,18 @@ var require_track_verification_tools = __commonJS({
         const hasPerToolReminders = remaining.some((r) => VC_TOOL_NAME_SET.has(r.name));
         if (!hasPerToolReminders) {
           await daemonCtx.staging.deleteReminder("Stop", types_js_1.ReminderIds.VERIFY_COMPLETION);
+          (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderUnstaged({ sessionId }, {
+            reminderName: types_js_1.ReminderIds.VERIFY_COMPLETION,
+            hookName: "Stop",
+            reason: "all_tools_verified",
+            triggeredBy: "verification_passed"
+          }));
           daemonCtx.logger.info("All VC tools verified, unstaged wrapper", { sessionId });
         }
         await remindersState.verificationTools.write(sessionId, toolsState);
       }
     }
-    async function ensureToolReminderStaged(daemonCtx, reminderId, stagedNames) {
+    async function ensureToolReminderStaged(daemonCtx, reminderId, stagedNames, enrichment) {
       if (stagedNames.has(reminderId))
         return true;
       const reminder = (0, reminder_utils_js_1.resolveReminder)(reminderId, {
@@ -73396,7 +73917,7 @@ var require_track_verification_tools = __commonJS({
       await (0, reminder_utils_js_1.stageReminder)(daemonCtx, "Stop", {
         ...reminder,
         stagedAt: { timestamp: Date.now(), turnCount: 0, toolsThisTurn: 0, toolCount: 0 }
-      });
+      }, enrichment);
       return true;
     }
   }
@@ -73412,11 +73933,12 @@ var require_stage_stop_bash_changes = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.registerStageBashChanges = registerStageBashChanges;
     var core_1 = require_dist4();
+    var events_js_1 = require_events2();
     var types_1 = require_dist();
     var picomatch_1 = __importDefault2(require_picomatch2());
     var track_verification_tools_js_1 = require_track_verification_tools();
     var types_js_1 = require_types2();
-    var state_js_1 = require_state3();
+    var state_js_1 = require_state4();
     var GIT_STATUS_TIMEOUT_MS = 200;
     var MAX_BASELINES = 50;
     function registerStageBashChanges(context) {
@@ -73481,6 +74003,12 @@ var require_stage_stop_bash_changes = __commonJS({
           if (lastConsumed?.stagedAt) {
             const shouldReactivate = metrics.turnCount > lastConsumed.stagedAt.turnCount;
             if (!shouldReactivate) {
+              (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+                reminderName: "verify-completion",
+                hookName: "Stop",
+                reason: "same_turn",
+                triggeredBy: "bash_command"
+              }));
               daemonCtx.logger.debug("Bash VC: skipped (already consumed this turn)", {
                 currentTurn: metrics.turnCount,
                 lastConsumedTurn: lastConsumed.stagedAt.turnCount
@@ -73496,12 +74024,25 @@ var require_stage_stop_bash_changes = __commonJS({
             currentCount: current.length,
             newFileCount: newFiles.length
           });
-          if (newFiles.length === 0)
+          if (newFiles.length === 0) {
+            (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+              reminderName: "verify-completion",
+              hookName: "Stop",
+              reason: "no_changes_detected",
+              triggeredBy: "bash_command"
+            }));
             return;
+          }
           const featureConfig = context.config.getFeature("reminders");
           const config = { ...types_js_1.DEFAULT_REMINDERS_SETTINGS, ...featureConfig.settings };
           const sourceMatches = newFiles.filter((f) => picomatch_1.default.isMatch(f, config.source_code_patterns));
           if (sourceMatches.length === 0) {
+            (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+              reminderName: "verify-completion",
+              hookName: "Stop",
+              reason: "pattern_mismatch",
+              triggeredBy: "bash_command"
+            }));
             daemonCtx.logger.debug("Bash VC: new files found but no source code matches", { newFiles });
             return;
           }
@@ -73515,7 +74056,7 @@ var require_stage_stop_bash_changes = __commonJS({
           const remindersState = (0, state_js_1.createRemindersState)(daemonCtx.stateService);
           const stateResult = await remindersState.verificationTools.read(sessionId);
           const toolsState = { ...stateResult.data };
-          await (0, track_verification_tools_js_1.stageToolsForFiles)(sourceMatches, daemonCtx, sessionId, verificationTools, toolsState, remindersState);
+          await (0, track_verification_tools_js_1.stageToolsForFiles)(sourceMatches, daemonCtx, sessionId, verificationTools, toolsState, remindersState, "bash_command");
         }
       });
     }
@@ -73528,10 +74069,12 @@ var require_unstage_verify_completion = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.registerUnstageVerifyCompletion = registerUnstageVerifyCompletion;
+    var core_1 = require_dist4();
+    var events_js_1 = require_events2();
     var types_1 = require_dist();
     var types_js_1 = require_types2();
     var reminder_utils_js_1 = require_reminder_utils();
-    var state_js_1 = require_state3();
+    var state_js_1 = require_state4();
     function registerUnstageVerifyCompletion(context) {
       if (!(0, types_1.isDaemonContext)(context))
         return;
@@ -73550,6 +74093,7 @@ var require_unstage_verify_completion = __commonJS({
           if (!sessionId) {
             daemonCtx.logger.warn("No sessionId in UserPromptSubmit event");
             await daemonCtx.staging.deleteReminder("Stop", types_js_1.ReminderIds.VERIFY_COMPLETION);
+            (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderUnstaged({ sessionId: "" }, { reminderName: types_js_1.ReminderIds.VERIFY_COMPLETION, hookName: "Stop", reason: "no_session_id" }));
             return;
           }
           const remindersState = (0, state_js_1.createRemindersState)(daemonCtx.stateService);
@@ -73625,13 +74169,26 @@ var require_unstage_verify_completion = __commonJS({
               await remindersState.vcUnverified.delete(sessionId);
             }
           } else {
+            (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+              reminderName: "verify-completion",
+              hookName: "Stop",
+              reason: "no_unverified_changes"
+            }));
             daemonCtx.logger.info("VC unstage: no unverified changes, clearing reminder", {
               sessionId,
               hadState: unverifiedState !== null
             });
           }
+          const eventContext = { sessionId };
+          const reason = unverifiedState?.hasUnverifiedChanges ? "cycle_limit_reached" : "no_unverified_changes";
           for (const vcId of types_js_1.ALL_VC_REMINDER_IDS) {
             await daemonCtx.staging.deleteReminder("Stop", vcId);
+            (0, core_1.logEvent)(daemonCtx.logger, events_js_1.ReminderEvents.reminderUnstaged(eventContext, {
+              reminderName: vcId,
+              hookName: "Stop",
+              reason,
+              triggeredBy: unverifiedState?.hasUnverifiedChanges ? "cycle_limit" : "no_unverified_changes"
+            }));
           }
           daemonCtx.logger.debug("VC unstage: deleted all VC reminders");
         }
@@ -73649,6 +74206,7 @@ var require_stage_persona_reminders = __commonJS({
     exports2.stagePersonaRemindersForSession = stagePersonaRemindersForSession;
     exports2.registerStagePersonaReminders = registerStagePersonaReminders;
     var core_1 = require_dist4();
+    var events_js_1 = require_events2();
     var types_1 = require_dist();
     var reminder_utils_js_1 = require_reminder_utils();
     var types_js_1 = require_types2();
@@ -73669,10 +74227,21 @@ var require_stage_persona_reminders = __commonJS({
     }
     var PERSONA_REMINDER_HOOKS = ["UserPromptSubmit", "SessionStart"];
     async function clearPersonaReminders(ctx, sessionId) {
+      const eventContext = { sessionId };
       for (const hook of PERSONA_REMINDER_HOOKS) {
         await ctx.staging.deleteReminder(hook, types_js_1.ReminderIds.REMEMBER_YOUR_PERSONA);
+        (0, core_1.logEvent)(ctx.logger, events_js_1.ReminderEvents.reminderUnstaged(eventContext, {
+          reminderName: types_js_1.ReminderIds.REMEMBER_YOUR_PERSONA,
+          hookName: hook,
+          reason: "persona_cleared"
+        }));
       }
       await ctx.staging.deleteReminder("UserPromptSubmit", types_js_1.ReminderIds.PERSONA_CHANGED);
+      (0, core_1.logEvent)(ctx.logger, events_js_1.ReminderEvents.reminderUnstaged(eventContext, {
+        reminderName: types_js_1.ReminderIds.PERSONA_CHANGED,
+        hookName: "UserPromptSubmit",
+        reason: "persona_cleared"
+      }));
       const lastStaged = await readLastStagedPersona(ctx, sessionId);
       if (lastStaged !== null) {
         await writeLastStagedPersona(ctx, sessionId, null);
@@ -73717,12 +74286,22 @@ var require_stage_persona_reminders = __commonJS({
     }
     async function stagePersonaRemindersForSession(ctx, sessionId, options) {
       if (!isPersonaInjectionEnabled(ctx)) {
+        (0, core_1.logEvent)(ctx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+          reminderName: "remember-your-persona",
+          hookName: "PreToolUse",
+          reason: "feature_disabled"
+        }));
         await clearPersonaReminders(ctx, sessionId);
         ctx.logger.debug("Persona injection disabled by config, cleaned up reminders", { sessionId });
         return;
       }
       const persona = await loadPersonaForSession(ctx, sessionId);
       if (!persona) {
+        (0, core_1.logEvent)(ctx.logger, events_js_1.ReminderEvents.reminderNotStaged({ sessionId }, {
+          reminderName: "remember-your-persona",
+          hookName: "PreToolUse",
+          reason: "no_persona"
+        }));
         await clearPersonaReminders(ctx, sessionId);
         ctx.logger.debug("Persona cleared or disabled, unstaged persona reminders", { sessionId });
         return;
@@ -73751,6 +74330,11 @@ var require_stage_persona_reminders = __commonJS({
         const isGenuineChange = lastStaged !== null && // null = never staged (initialization) → skip
         lastStaged.personaId !== persona.id;
         if (isGenuineChange) {
+          (0, core_1.logEvent)(ctx.logger, core_1.LogEvents.personaChanged({ sessionId }, {
+            personaFrom: lastStaged.personaId ?? "none",
+            personaTo: persona.id,
+            reason: "mid_session_change"
+          }));
           const changedReminder = (0, reminder_utils_js_1.resolveReminder)(types_js_1.ReminderIds.PERSONA_CHANGED, {
             context: templateContext,
             assets: ctx.assets
@@ -73808,6 +74392,7 @@ var require_stage_user_profile_reminders = __commonJS({
     exports2.stageUserProfileRemindersForSession = stageUserProfileRemindersForSession;
     exports2.registerStageUserProfileReminders = registerStageUserProfileReminders;
     var core_1 = require_dist4();
+    var events_js_1 = require_events2();
     var types_1 = require_dist();
     var reminder_utils_js_1 = require_reminder_utils();
     var types_js_1 = require_types2();
@@ -73815,8 +74400,14 @@ var require_stage_user_profile_reminders = __commonJS({
     async function stageUserProfileRemindersForSession(ctx, sessionId) {
       const profile = (0, core_1.loadUserProfile)({ logger: ctx.logger });
       if (!profile) {
+        const eventContext = { sessionId };
         for (const hook of USER_PROFILE_REMINDER_HOOKS) {
           await ctx.staging.deleteReminder(hook, types_js_1.ReminderIds.USER_PROFILE);
+          (0, core_1.logEvent)(ctx.logger, events_js_1.ReminderEvents.reminderUnstaged(eventContext, {
+            reminderName: types_js_1.ReminderIds.USER_PROFILE,
+            hookName: hook,
+            reason: "no_user_profile"
+          }));
         }
         return;
       }
@@ -73885,60 +74476,6 @@ var require_staging2 = __commonJS({
   }
 });
 
-// ../feature-reminders/dist/events.js
-var require_events2 = __commonJS({
-  "../feature-reminders/dist/events.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.ReminderEvents = void 0;
-    exports2.ReminderEvents = {
-      /**
-       * Create a ReminderConsumed event (logged when CLI returns a staged reminder).
-       */
-      reminderConsumed(context, state, metadata) {
-        return {
-          type: "ReminderConsumed",
-          time: Date.now(),
-          source: "cli",
-          context: {
-            sessionId: context.sessionId,
-            correlationId: context.correlationId,
-            traceId: context.traceId,
-            hook: context.hook,
-            taskId: context.taskId
-          },
-          payload: {
-            state,
-            metadata
-          }
-        };
-      },
-      // Note: reminderStaged stays in @sidekick/core (used by staging-service.ts, circular dep)
-      /**
-       * Create a RemindersCleared event (logged when staging directory is cleaned).
-       */
-      remindersCleared(context, state, reason) {
-        return {
-          type: "RemindersCleared",
-          time: Date.now(),
-          source: "daemon",
-          context: {
-            sessionId: context.sessionId,
-            correlationId: context.correlationId,
-            traceId: context.traceId,
-            hook: context.hook,
-            taskId: context.taskId
-          },
-          payload: {
-            state,
-            reason
-          }
-        };
-      }
-    };
-  }
-});
-
 // ../feature-reminders/dist/cli-staging-reader.js
 var require_cli_staging_reader = __commonJS({
   "../feature-reminders/dist/cli-staging-reader.js"(exports2) {
@@ -74064,7 +74601,19 @@ var require_consumption_handler_factory = __commonJS({
               reader.renameReminder(hook, reminder.name);
             }
           }
-          let response = buildResponse ? await buildResponse({ reminder: primary, reader, cliCtx, sessionId, event, supportsBlocking }) : buildDefaultResponse(primary, supportsBlocking);
+          let enrichment;
+          let response;
+          if (buildResponse) {
+            const result = await buildResponse({ reminder: primary, reader, cliCtx, sessionId, event, supportsBlocking });
+            if ("response" in result && typeof result.response === "object") {
+              response = result.response;
+              enrichment = result.enrichment;
+            } else {
+              response = result;
+            }
+          } else {
+            response = buildDefaultResponse(primary, supportsBlocking);
+          }
           const secondaryContexts = reminders.slice(1).map((r) => r.additionalContext).filter((ctx2) => !!ctx2);
           if (secondaryContexts.length > 0) {
             const existing = response.additionalContext;
@@ -74082,7 +74631,8 @@ var require_consumption_handler_factory = __commonJS({
             reminderReturned: true,
             blocking: response.blocking ?? false,
             priority: primary.priority,
-            persistent: primary.persistent
+            persistent: primary.persistent,
+            ...enrichment
           }));
           return { response };
         }
@@ -74184,6 +74734,13 @@ var require_inject_stop = __commonJS({
               shouldBlock: classification.shouldBlock,
               reasoning: classification.reasoning?.slice(0, 200)
             });
+            const classificationEnrichment = {
+              classificationResult: {
+                category: classification.category,
+                confidence: classification.confidence,
+                shouldBlock: classification.shouldBlock
+              }
+            };
             if (classification.shouldBlock) {
               cliCtx.logger.info("VC inject-stop: BLOCKING (claiming completion)", { sessionId });
               try {
@@ -74193,7 +74750,10 @@ var require_inject_stop = __commonJS({
                   error: String(clearErr)
                 });
               }
-              return (0, consumption_handler_factory_js_1.buildDefaultResponse)(reminder, supportsBlocking);
+              return {
+                response: (0, consumption_handler_factory_js_1.buildDefaultResponse)(reminder, supportsBlocking),
+                enrichment: classificationEnrichment
+              };
             } else {
               cliCtx.logger.info("VC inject-stop: NOT BLOCKING", {
                 sessionId,
@@ -74219,13 +74779,13 @@ var require_inject_stop = __commonJS({
                 });
               }
               if (classification.category === "ASKING_QUESTION" || classification.category === "ANSWERING_QUESTION") {
-                return {};
+                return { response: {}, enrichment: classificationEnrichment };
               } else {
                 const response = {};
                 if (classification.userMessage) {
                   response.userMessage = classification.userMessage;
                 }
-                return response;
+                return { response, enrichment: classificationEnrichment };
               }
             }
           } catch (err) {
@@ -74481,7 +75041,7 @@ var require_reminder_consumed = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.handleReminderConsumed = handleReminderConsumed;
-    var state_js_1 = require_state3();
+    var state_js_1 = require_state4();
     var types_js_1 = require_types2();
     async function handleReminderConsumed(params, ctx) {
       const { sessionId, reminderName, metrics } = params;
@@ -74506,7 +75066,7 @@ var require_vc_unverified = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.handleVCUnverifiedSet = handleVCUnverifiedSet;
     exports2.handleVCUnverifiedClear = handleVCUnverifiedClear;
-    var state_js_1 = require_state3();
+    var state_js_1 = require_state4();
     async function handleVCUnverifiedSet(params, ctx) {
       const { sessionId, classification, metrics } = params;
       const remindersState = (0, state_js_1.createRemindersState)(ctx.stateService);
@@ -74569,7 +75129,9 @@ var require_orchestrator = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.ReminderOrchestrator = void 0;
-    var state_js_1 = require_state3();
+    var core_1 = require_dist4();
+    var events_js_1 = require_events2();
+    var state_js_1 = require_state4();
     var types_js_1 = require_types2();
     var ReminderOrchestrator = class {
       deps;
@@ -74588,8 +75150,15 @@ var require_orchestrator = __commonJS({
         if (reminder.name === types_js_1.ReminderIds.PAUSE_AND_REFLECT) {
           try {
             const staging = this.deps.getStagingService(sessionId);
+            const eventContext = { sessionId };
             for (const vcId of types_js_1.ALL_VC_REMINDER_IDS) {
               await staging.deleteReminder("Stop", vcId);
+              (0, core_1.logEvent)(this.deps.logger, events_js_1.ReminderEvents.reminderUnstaged(eventContext, {
+                reminderName: vcId,
+                hookName: "Stop",
+                reason: "pause_and_reflect_cascade",
+                triggeredBy: "cascade_from_pause_and_reflect"
+              }));
             }
             this.deps.logger.debug("Unstaged all VC reminders after P&R staged", { sessionId });
           } catch (err) {
@@ -74625,6 +75194,12 @@ var require_orchestrator = __commonJS({
           try {
             const staging = this.deps.getStagingService(sessionId);
             await staging.deleteReminder("PreToolUse", types_js_1.ReminderIds.PAUSE_AND_REFLECT);
+            (0, core_1.logEvent)(this.deps.logger, events_js_1.ReminderEvents.reminderUnstaged({ sessionId }, {
+              reminderName: types_js_1.ReminderIds.PAUSE_AND_REFLECT,
+              hookName: "PreToolUse",
+              reason: "vc_consumed_cascade",
+              triggeredBy: "cascade_from_verify_completion"
+            }));
             this.deps.logger.debug("Unstaged P&R after VC consumed", { sessionId });
           } catch (err) {
             this.deps.logger.warn("Failed to unstage P&R after VC consumed", {
@@ -74750,7 +75325,7 @@ var require_dist5 = __commonJS({
     Object.defineProperty(exports2, "ReminderOrchestrator", { enumerable: true, get: function() {
       return orchestrator_js_1.ReminderOrchestrator;
     } });
-    var state_js_1 = require_state3();
+    var state_js_1 = require_state4();
     Object.defineProperty(exports2, "createRemindersState", { enumerable: true, get: function() {
       return state_js_1.createRemindersState;
     } });
@@ -75777,7 +76352,7 @@ var require_truncation = __commonJS({
 });
 
 // ../feature-session-summary/dist/state.js
-var require_state4 = __commonJS({
+var require_state5 = __commonJS({
   "../feature-session-summary/dist/state.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -75882,7 +76457,7 @@ var require_persona_selection = __commonJS({
     exports2.selectPersonaForSession = selectPersonaForSession;
     exports2.ensurePersonaForSession = ensurePersonaForSession;
     var core_1 = require_dist4();
-    var state_js_1 = require_state4();
+    var state_js_1 = require_state5();
     var types_js_1 = require_types4();
     function parsePersonaList(list) {
       if (!list || !list.trim()) {
@@ -75965,11 +76540,11 @@ var require_persona_selection = __commonJS({
           };
           const summaryState2 = (0, state_js_1.createSessionSummaryState)(ctx.stateService);
           await summaryState2.sessionPersona.write(sessionId, personaState2);
-          ctx.logger.info("Using pinned persona for session", {
-            sessionId,
+          (0, core_1.logEvent)(ctx.logger, core_1.LogEvents.personaSelected({ sessionId }, {
             personaId: pinned.id,
-            personaName: pinned.display_name
-          });
+            selectionMethod: "pinned",
+            poolSize: 1
+          }));
           return pinned.id;
         }
         ctx.logger.warn("Pinned persona not found, falling back to random selection", {
@@ -75979,13 +76554,18 @@ var require_persona_selection = __commonJS({
         });
       }
       const persistThroughClear = personaConfig.persistThroughClear ?? true;
-      ctx.logger.debug("Persona clear handoff check", {
+      ctx.logger.info("[persona-lifecycle] ClearHandoff: checking clear cache", {
+        sessionId,
         persistThroughClear,
         startType: options?.startType,
         hasClearCache: !!ctx.personaClearCache
       });
       if (persistThroughClear && options?.startType === "clear" && ctx.personaClearCache) {
         const cachedPersonaId = ctx.personaClearCache.consume();
+        ctx.logger.info("[persona-lifecycle] ClearHandoff: consumed cache", {
+          sessionId,
+          cachedPersonaId: cachedPersonaId ?? null
+        });
         if (cachedPersonaId) {
           const cachedPersona = allPersonas.get(cachedPersonaId);
           if (cachedPersona) {
@@ -75996,11 +76576,11 @@ var require_persona_selection = __commonJS({
             };
             const summaryState2 = (0, state_js_1.createSessionSummaryState)(ctx.stateService);
             await summaryState2.sessionPersona.write(sessionId, personaState2);
-            ctx.logger.info("Preserved persona through clear", {
-              sessionId,
+            (0, core_1.logEvent)(ctx.logger, core_1.LogEvents.personaSelected({ sessionId }, {
               personaId: cachedPersona.id,
-              personaName: cachedPersona.display_name
-            });
+              selectionMethod: "handoff",
+              poolSize: 1
+            }));
             return cachedPersona.id;
           } else {
             ctx.logger.warn("Cached persona from clear not found in available personas, falling back to selection", {
@@ -76038,12 +76618,11 @@ var require_persona_selection = __commonJS({
       };
       const summaryState = (0, state_js_1.createSessionSummaryState)(ctx.stateService);
       await summaryState.sessionPersona.write(sessionId, personaState);
-      ctx.logger.info("Selected persona for session", {
-        sessionId,
+      (0, core_1.logEvent)(ctx.logger, core_1.LogEvents.personaSelected({ sessionId }, {
         personaId: selected.id,
-        personaName: selected.display_name,
+        selectionMethod: "random",
         poolSize: eligiblePersonas.length
-      });
+      }));
       return selected.id;
     }
     async function ensurePersonaForSession(sessionId, ctx) {
@@ -76073,7 +76652,7 @@ var require_create_first_summary = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.createFirstSessionSummary = createFirstSessionSummary;
     var types_1 = require_dist();
-    var state_js_1 = require_state4();
+    var state_js_1 = require_state5();
     var persona_selection_js_1 = require_persona_selection();
     var types_js_1 = require_types4();
     async function createFirstSessionSummary(event, ctx) {
@@ -76106,15 +76685,12 @@ var require_events3 = __commonJS({
   "../feature-session-summary/dist/events.js"(exports2) {
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.SessionSummaryEvents = void 0;
+    exports2.DecisionEvents = exports2.SessionSummaryEvents = void 0;
     exports2.SessionSummaryEvents = {
-      /**
-       * Create a SummaryUpdated event (logged when session summary is recalculated).
-       * @see docs/design/FEATURE-SESSION-SUMMARY.md §3.4
-       */
-      summaryUpdated(context, state, metadata, reason) {
+      /** Emitted when summary generation begins. */
+      summaryStart(context, payload) {
         return {
-          type: "SummaryUpdated",
+          type: "session-summary:start",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -76124,11 +76700,87 @@ var require_events3 = __commonJS({
             hook: context.hook,
             taskId: context.taskId
           },
-          payload: {
-            state,
-            metadata,
-            reason
-          }
+          payload
+        };
+      },
+      /** Emitted when summary generation completes. */
+      summaryFinish(context, payload) {
+        return {
+          type: "session-summary:finish",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload
+        };
+      },
+      /** Emitted when session title changes. */
+      titleChanged(context, payload) {
+        return {
+          type: "session-title:changed",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload
+        };
+      },
+      /** Emitted when latest intent changes. */
+      intentChanged(context, payload) {
+        return {
+          type: "intent:changed",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload
+        };
+      },
+      /** Emitted when snarky message generation begins. */
+      snarkyMessageStart(context, payload) {
+        return {
+          type: "snarky-message:start",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload
+        };
+      },
+      /** Emitted when snarky message generation completes. */
+      snarkyMessageFinish(context, payload) {
+        return {
+          type: "snarky-message:finish",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload
         };
       },
       /**
@@ -76137,7 +76789,7 @@ var require_events3 = __commonJS({
        */
       summarySkipped(context, metadata) {
         return {
-          type: "SummarySkipped",
+          type: "session-summary:skipped",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -76148,12 +76800,31 @@ var require_events3 = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            metadata,
+            countdown: metadata.countdown,
+            countdown_threshold: metadata.countdown_threshold,
             reason: "countdown_active"
           }
         };
       }
     };
+    exports2.DecisionEvents = {
+      /** Emitted when an LLM decision is recorded. */
+      decisionRecorded(context, payload) {
+        return {
+          type: "decision:recorded",
+          time: Date.now(),
+          source: "daemon",
+          context: {
+            sessionId: context.sessionId,
+            correlationId: context.correlationId,
+            traceId: context.traceId,
+            hook: context.hook,
+            taskId: context.taskId
+          },
+          payload
+        };
+      }
+    };
   }
 });
 
@@ -76173,7 +76844,7 @@ var require_persona_utils = __commonJS({
     exports2.mergePersonaConfig = mergePersonaConfig;
     exports2.getEffectiveProfile = getEffectiveProfile;
     var core_1 = require_dist4();
-    var state_js_1 = require_state4();
+    var state_js_1 = require_state5();
     var types_js_1 = require_types4();
     var DEFAULT_PERSONA_SITUATION = "You are watching over the shoulder of a software developer as they work.";
     function buildUserProfileContext(profile) {
@@ -76315,7 +76986,7 @@ var require_update_summary = __commonJS({
     var events_js_1 = require_events3();
     var zod_1 = require_zod();
     var types_js_1 = require_types4();
-    var state_js_1 = require_state4();
+    var state_js_1 = require_state5();
     var persona_utils_js_1 = require_persona_utils();
     var persona_selection_js_1 = require_persona_selection();
     var PROMPT_FILE = "prompts/session-summary.prompt.txt";
@@ -76368,47 +77039,47 @@ var require_update_summary = __commonJS({
         await (0, persona_selection_js_1.ensurePersonaForSession)(sessionId, ctx);
         const metrics = ctx.transcript.getMetrics();
         if (metrics.turnCount === 0) {
-          ctx.logger.info("LLM call: session-summary analysis", {
-            sessionId,
+          (0, core_1.logEvent)(ctx.logger, events_js_1.DecisionEvents.decisionRecorded(event.context, {
             decision: "skipped",
-            reason: "BulkProcessingComplete with no user turns (turnCount=0)"
-          });
+            reason: "BulkProcessingComplete with no user turns (turnCount=0)",
+            detail: "session-summary analysis"
+          }));
           return;
         }
-        ctx.logger.info("LLM call: session-summary analysis", {
-          sessionId,
+        (0, core_1.logEvent)(ctx.logger, events_js_1.DecisionEvents.decisionRecorded(event.context, {
           decision: "calling",
-          reason: "BulkProcessingComplete - analyzing full transcript"
-        });
+          reason: "BulkProcessingComplete - analyzing full transcript",
+          detail: "session-summary analysis"
+        }));
         const countdown2 = await loadCountdownState(summaryState, sessionId);
         void performAnalysis(event, ctx, summaryState, countdown2, "user_prompt_forced");
         return;
       }
       const countdown = await loadCountdownState(summaryState, sessionId);
       if (isUserPrompt) {
-        ctx.logger.info("LLM call: session-summary analysis", {
-          sessionId,
+        (0, core_1.logEvent)(ctx.logger, events_js_1.DecisionEvents.decisionRecorded(event.context, {
           decision: "calling",
-          reason: "UserPrompt event forces immediate analysis"
-        });
+          reason: "UserPrompt event forces immediate analysis",
+          detail: "session-summary analysis"
+        }));
         void performAnalysis(event, ctx, summaryState, countdown, "user_prompt_forced");
         return;
       }
       if (countdown.countdown > 0) {
-        ctx.logger.info("LLM call: session-summary analysis", {
-          sessionId,
+        (0, core_1.logEvent)(ctx.logger, events_js_1.DecisionEvents.decisionRecorded(event.context, {
           decision: "skipped",
-          reason: `countdown not reached (${countdown.countdown} tool results remaining)`
-        });
+          reason: `countdown not reached (${countdown.countdown} tool results remaining)`,
+          detail: "session-summary analysis"
+        }));
         countdown.countdown--;
         await saveCountdownState(summaryState, sessionId, countdown);
         return;
       }
-      ctx.logger.info("LLM call: session-summary analysis", {
-        sessionId,
+      (0, core_1.logEvent)(ctx.logger, events_js_1.DecisionEvents.decisionRecorded(event.context, {
         decision: "calling",
-        reason: "countdown reached zero after ToolResult"
-      });
+        reason: "countdown reached zero after ToolResult",
+        detail: "session-summary analysis"
+      }));
       void performAnalysis(event, ctx, summaryState, countdown, "countdown_reached");
     }
     async function loadCountdownState(summaryState, sessionId) {
@@ -76442,6 +77113,10 @@ var require_update_summary = __commonJS({
       const { sessionId } = event.context;
       try {
         const startTime = Date.now();
+        (0, core_1.logEvent)(ctx.logger, events_js_1.SessionSummaryEvents.summaryStart(event.context, {
+          reason,
+          countdown: countdown.countdown
+        }));
         const featureConfig = ctx.config.getFeature("session-summary");
         const config = { ...types_js_1.DEFAULT_SESSION_SUMMARY_CONFIG, ...featureConfig.settings };
         const currentSummary = await loadCurrentSummary(summaryState, sessionId);
@@ -76545,19 +77220,28 @@ var require_update_summary = __commonJS({
         if (sideEffects.length > 0) {
           await Promise.all(sideEffects);
         }
-        (0, core_1.logEvent)(ctx.logger, events_js_1.SessionSummaryEvents.summaryUpdated(event.context, {
+        (0, core_1.logEvent)(ctx.logger, events_js_1.SessionSummaryEvents.summaryFinish(event.context, {
           session_title: updatedSummary.session_title,
           session_title_confidence: updatedSummary.session_title_confidence,
           latest_intent: updatedSummary.latest_intent,
-          latest_intent_confidence: updatedSummary.latest_intent_confidence
-        }, {
-          countdown_reset_to: newCountdown,
-          tokens_used: tokensUsed,
+          latest_intent_confidence: updatedSummary.latest_intent_confidence,
           processing_time_ms: updatedSummary.stats?.processing_time_ms ?? 0,
-          pivot_detected: updatedSummary.pivot_detected ?? false,
-          old_title: currentSummary?.session_title,
-          old_intent: currentSummary?.latest_intent
-        }, reason));
+          pivot_detected: updatedSummary.pivot_detected ?? false
+        }));
+        if (currentSummary && updatedSummary.session_title !== currentSummary.session_title) {
+          (0, core_1.logEvent)(ctx.logger, events_js_1.SessionSummaryEvents.titleChanged(event.context, {
+            previousValue: currentSummary.session_title,
+            newValue: updatedSummary.session_title,
+            confidence: updatedSummary.session_title_confidence
+          }));
+        }
+        if (currentSummary && updatedSummary.latest_intent !== currentSummary.latest_intent) {
+          (0, core_1.logEvent)(ctx.logger, events_js_1.SessionSummaryEvents.intentChanged(event.context, {
+            previousValue: currentSummary.latest_intent,
+            newValue: updatedSummary.latest_intent,
+            confidence: updatedSummary.latest_intent_confidence
+          }));
+        }
         ctx.logger.info("Updated session summary", {
           sessionId,
           reason,
@@ -76623,6 +77307,7 @@ var require_update_summary = __commonJS({
         return;
       }
       const provider = ctx.profileFactory.createForProfile(profileResult.profileId, llmConfig.fallbackProfile);
+      (0, core_1.logEvent)(ctx.logger, events_js_1.SessionSummaryEvents.snarkyMessageStart({ sessionId }, { sessionId }));
       try {
         const response = await provider.complete({
           messages: [{ role: "user", content: prompt }]
@@ -76633,6 +77318,7 @@ var require_update_summary = __commonJS({
           timestamp: (/* @__PURE__ */ new Date()).toISOString()
         };
         await summaryState.snarkyMessage.write(sessionId, snarkyState);
+        (0, core_1.logEvent)(ctx.logger, events_js_1.SessionSummaryEvents.snarkyMessageFinish({ sessionId }, { generatedMessage: snarkyMessage }));
         ctx.logger.debug("Generated snarky message", {
           sessionId,
           personaId: persona?.id ?? "none",
@@ -76741,8 +77427,10 @@ var require_on_demand_generation = __commonJS({
     exports2.generateSnarkyMessageOnDemand = generateSnarkyMessageOnDemand;
     exports2.generateResumeMessageOnDemand = generateResumeMessageOnDemand;
     var types_js_1 = require_types4();
-    var state_js_1 = require_state4();
+    var state_js_1 = require_state5();
     var core_1 = require_dist4();
+    var core_2 = require_dist4();
+    var events_js_1 = require_events3();
     var update_summary_js_1 = require_update_summary();
     var persona_utils_js_1 = require_persona_utils();
     var SNARKY_PROMPT_FILE = "prompts/snarky-message.prompt.txt";
@@ -76819,6 +77507,7 @@ var require_on_demand_generation = __commonJS({
         return { success: false, error: profileResult.errorMessage };
       }
       const provider = ctx.profileFactory.createForProfile(profileResult.profileId, llmConfig.fallbackProfile);
+      (0, core_2.logEvent)(ctx.logger, events_js_1.SessionSummaryEvents.snarkyMessageStart({ sessionId }, { sessionId }));
       try {
         const response = await provider.complete({
           messages: [{ role: "user", content: prompt }]
@@ -76829,6 +77518,7 @@ var require_on_demand_generation = __commonJS({
           timestamp: (/* @__PURE__ */ new Date()).toISOString()
         };
         await summaryState.snarkyMessage.write(sessionId, snarkyState);
+        (0, core_2.logEvent)(ctx.logger, events_js_1.SessionSummaryEvents.snarkyMessageFinish({ sessionId }, { generatedMessage: snarkyMessage }));
         ctx.logger.info("Generated snarky message on-demand", {
           sessionId,
           personaId: persona?.id ?? "none"
@@ -77035,7 +77725,7 @@ var require_dist6 = __commonJS({
       for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports3, p)) __createBinding(exports3, m, p);
     };
     Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.SessionSummaryEvents = exports2.manifest = void 0;
+    exports2.DecisionEvents = exports2.SessionSummaryEvents = exports2.manifest = void 0;
     exports2.register = register;
     var index_js_1 = require_handlers();
     exports2.manifest = {
@@ -77052,11 +77742,14 @@ var require_dist6 = __commonJS({
     exports2.default = feature;
     __exportStar(require_types4(), exports2);
     __exportStar(require_handlers(), exports2);
-    __exportStar(require_state4(), exports2);
+    __exportStar(require_state5(), exports2);
     var events_js_1 = require_events3();
     Object.defineProperty(exports2, "SessionSummaryEvents", { enumerable: true, get: function() {
       return events_js_1.SessionSummaryEvents;
     } });
+    Object.defineProperty(exports2, "DecisionEvents", { enumerable: true, get: function() {
+      return events_js_1.DecisionEvents;
+    } });
   }
 });
 
@@ -79135,6 +79828,20 @@ var require_persona2 = __commonJS({
       stdout.write(output + "\n");
       return { exitCode, output };
     }
+    function validatePersonaExists(personaId, opts) {
+      const personas = (0, core_1.discoverPersonas)({
+        defaultPersonasDir: (0, core_1.getDefaultPersonasDir)(),
+        projectRoot: opts.projectRoot,
+        logger: opts.logger
+      });
+      if (!personas.has(personaId)) {
+        const availableIds = Array.from(personas.keys()).join(", ");
+        const errorMsg = `Persona "${personaId}" not found. Available: ${availableIds}`;
+        opts.logger.error("Persona not found", { personaId, available: availableIds });
+        return { result: writeJsonResponse(opts.stdout, { success: false, error: errorMsg }, 1) };
+      }
+      return { personas };
+    }
     function handlePersonaList(projectRoot, logger, stdout, options) {
       const format3 = options.format ?? "json";
       const tableWidth = options.width ?? 100;
@@ -79191,17 +79898,10 @@ var require_persona2 = __commonJS({
         return { exitCode: 1, output: error };
       }
       logger.info("Setting persona", { personaId, sessionId });
-      const personas = (0, core_1.discoverPersonas)({
-        defaultPersonasDir: (0, core_1.getDefaultPersonasDir)(),
-        projectRoot,
-        logger
-      });
-      if (!personas.has(personaId)) {
-        const availableIds = Array.from(personas.keys()).join(", ");
-        const errorMsg = `Persona "${personaId}" not found. Available: ${availableIds}`;
-        logger.error("Persona not found", { personaId, available: availableIds });
-        return writeJsonResponse(stdout, { success: false, error: errorMsg }, 1);
-      }
+      const validation = validatePersonaExists(personaId, { projectRoot, logger, stdout });
+      if (validation.result)
+        return validation.result;
+      const personas = validation.personas;
       const stateService = new core_1.StateService(projectRoot, { cache: false, logger });
       const personaAccessor = new core_1.SessionStateAccessor(stateService, SessionPersonaDescriptor);
       try {
@@ -79213,10 +79913,16 @@ var require_persona2 = __commonJS({
           timestamp: (/* @__PURE__ */ new Date()).toISOString()
         };
         await personaAccessor.write(sessionId, newState);
+        const personaFilePath = stateService.sessionStatePath(sessionId, "session-persona.json");
         if (previousPersonaId) {
-          logger.info("Persona changed", { from: previousPersonaId, to: personaId });
+          logger.info("[persona-lifecycle] PersonaSet: persona changed", {
+            sessionId,
+            from: previousPersonaId,
+            to: personaId,
+            filePath: personaFilePath
+          });
         } else {
-          logger.info("Persona set", { personaId });
+          logger.info("[persona-lifecycle] PersonaSet: persona set", { sessionId, personaId, filePath: personaFilePath });
         }
         return writeJsonResponse(stdout, { success: true, personaId, previousPersonaId }, 0);
       } catch (err) {
@@ -79299,17 +80005,9 @@ var require_persona2 = __commonJS({
     function handlePersonaPin(personaId, projectRoot, logger, stdout, options) {
       const scope = options.scope ?? "project";
       logger.info("Pinning persona", { personaId, scope });
-      const personas = (0, core_1.discoverPersonas)({
-        defaultPersonasDir: (0, core_1.getDefaultPersonasDir)(),
-        projectRoot,
-        logger
-      });
-      if (!personas.has(personaId)) {
-        const availableIds = Array.from(personas.keys()).join(", ");
-        const errorMsg = `Persona "${personaId}" not found. Available: ${availableIds}`;
-        logger.error("Persona not found", { personaId, available: availableIds });
-        return writeJsonResponse(stdout, { success: false, error: errorMsg }, 1);
-      }
+      const validation = validatePersonaExists(personaId, { projectRoot, logger, stdout });
+      if (validation.result)
+        return validation.result;
       try {
         const result = (0, core_1.configSet)("features.session-summary.settings.personas.pinnedPersona", personaId, {
           scope,
@@ -79354,7 +80052,7 @@ var require_persona2 = __commonJS({
         return writeJsonResponse(stdout, { success: false, error: errorMsg }, 1);
       }
     }
-    function showPersonaHelp(stdout) {
+    function showPersonaHelp(stdout, exitCode = 0) {
       stdout.write(`Usage: sidekick persona <subcommand> [options]
 
 Subcommands:
@@ -79383,7 +80081,7 @@ Examples:
   sidekick persona clear --session-id=abc123
   sidekick persona test skippy --session-id=abc123 --type=snarky
 `);
-      return { exitCode: 0, output: "" };
+      return { exitCode, output: "" };
     }
     async function handlePersonaCommand(subcommand, args, projectRoot, logger, stdout, options) {
       const personaId = args[0];
@@ -79424,12 +80122,12 @@ Examples:
           return showPersonaHelp(stdout);
         case void 0:
           stdout.write("Error: persona command requires a subcommand\n\n");
-          return showPersonaHelp(stdout);
+          return showPersonaHelp(stdout, 1);
         default:
           stdout.write(`Error: Unknown persona subcommand: ${subcommand}
 
 `);
-          return showPersonaHelp(stdout);
+          return showPersonaHelp(stdout, 1);
       }
     }
   }
@@ -83041,7 +83739,7 @@ var require_cli = __commonJS({
     var promises_12 = require("node:fs/promises");
     var node_stream_1 = require("node:stream");
     var yargs_parser_1 = __importDefault2(require_build());
-    var VERSION = true ? "0.1.8" : "dev";
+    var VERSION = true ? "0.1.10" : "dev";
     var SANDBOX_ERROR_MESSAGE = `Error: Daemon commands cannot run in sandbox mode.
 
 Claude Code's sandbox blocks Unix socket operations required for daemon IPC.
@@ -83537,6 +84235,7 @@ Run 'sidekick --help' for available options.
       if (sessionId) {
         await persistCliLogMetrics(runtime.stateService, sessionId, runtime.getLogCounts(), runtime.logger);
       }
+      await runtime.logger.flush();
       return result;
     }
   }