@scotthamilton77/sidekick 0.1.8 → 0.1.10

package/dist/daemon.js

@@ -54,7 +54,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;
@@ -116,6 +116,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"
+    };
   }
 });
 
@@ -16252,6 +16338,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(),
@@ -16413,16 +16500,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(),
@@ -17003,6 +17081,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) {
@@ -17034,6 +17130,7 @@ var require_dist = __commonJS({
     __exportStar(require_tasks(), exports2);
     __exportStar(require_hook_input(), exports2);
     __exportStar(require_setup_status(), exports2);
+    __exportStar(require_state2(), exports2);
   }
 });
 
@@ -26779,9 +26876,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),
@@ -44685,7 +44786,7 @@ var require_structured_logging = __commonJS({
        */
       hookReceived(context, metadata) {
         return {
-          type: "HookReceived",
+          type: "hook:received",
           time: Date.now(),
           source: "cli",
           context: {
@@ -44695,7 +44796,9 @@ var require_structured_logging = __commonJS({
             hook: context.hook
           },
           payload: {
-            metadata
+            hook: context.hook,
+            cwd: metadata.cwd,
+            mode: metadata.mode
           }
         };
       },
@@ -44704,7 +44807,7 @@ var require_structured_logging = __commonJS({
        */
       hookCompleted(context, metadata, state) {
         return {
-          type: "HookCompleted",
+          type: "hook:completed",
           time: Date.now(),
           source: "cli",
           context: {
@@ -44714,8 +44817,10 @@ var require_structured_logging = __commonJS({
             hook: context.hook
           },
           payload: {
-            state,
-            metadata
+            hook: context.hook,
+            durationMs: metadata.durationMs,
+            reminderReturned: state?.reminderReturned,
+            responseType: state?.responseType
           }
         };
       },
@@ -44725,7 +44830,7 @@ var require_structured_logging = __commonJS({
        */
       eventReceived(context, metadata) {
         return {
-          type: "EventReceived",
+          type: "event:received",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -44736,7 +44841,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 }
           }
         };
       },
@@ -44746,7 +44853,7 @@ var require_structured_logging = __commonJS({
        */
       eventProcessed(context, state, metadata) {
         return {
-          type: "EventProcessed",
+          type: "event:processed",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -44757,17 +44864,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: {
@@ -44778,8 +44887,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 }
           }
         };
       },
@@ -44789,14 +44904,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
           }
         };
       },
@@ -44805,14 +44921,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
           }
         };
       },
@@ -44821,14 +44937,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
           }
         };
       },
@@ -44837,14 +44953,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
           }
         };
       },
@@ -44853,14 +44970,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
           }
         };
       },
@@ -44871,7 +44988,7 @@ var require_structured_logging = __commonJS({
        */
       statuslineRendered(context, state, metadata) {
         return {
-          type: "StatuslineRendered",
+          type: "statusline:rendered",
           time: Date.now(),
           source: "cli",
           context: {
@@ -44882,8 +44999,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
           }
         };
       },
@@ -44893,7 +45013,7 @@ var require_structured_logging = __commonJS({
        */
       statuslineError(context, reason, metadata) {
         return {
-          type: "StatuslineError",
+          type: "statusline:error",
           time: Date.now(),
           source: "cli",
           context: {
@@ -44905,7 +45025,9 @@ var require_structured_logging = __commonJS({
           },
           payload: {
             reason,
-            metadata
+            file: metadata.file,
+            fallbackUsed: metadata.fallbackUsed,
+            error: metadata.error
           }
         };
       },
@@ -44916,7 +45038,7 @@ var require_structured_logging = __commonJS({
        */
       resumeGenerating(context, metadata) {
         return {
-          type: "ResumeGenerating",
+          type: "resume-message:start",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -44927,8 +45049,8 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            metadata,
-            reason: "pivot_detected"
+            title_confidence: metadata.title_confidence,
+            intent_confidence: metadata.intent_confidence
           }
         };
       },
@@ -44938,7 +45060,7 @@ var require_structured_logging = __commonJS({
        */
       resumeUpdated(context, state) {
         return {
-          type: "ResumeUpdated",
+          type: "resume-message:finish",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -44949,8 +45071,8 @@ var require_structured_logging = __commonJS({
             taskId: context.taskId
           },
           payload: {
-            state,
-            reason: "generation_complete"
+            snarky_comment: state.snarky_comment,
+            timestamp: state.timestamp
           }
         };
       },
@@ -44960,7 +45082,7 @@ var require_structured_logging = __commonJS({
        */
       resumeSkipped(context, metadata, reason) {
         return {
-          type: "ResumeSkipped",
+          type: "resume-message:skipped",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -44971,11 +45093,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).
@@ -44983,7 +45144,7 @@ var require_structured_logging = __commonJS({
        */
       transcriptEventEmitted(context, state, metadata) {
         return {
-          type: "TranscriptEventEmitted",
+          type: "transcript:emitted",
           time: Date.now(),
           source: "transcript",
           context: {
@@ -44994,8 +45155,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
           }
         };
       },
@@ -45005,7 +45171,7 @@ var require_structured_logging = __commonJS({
        */
       preCompactCaptured(context, state, metadata) {
         return {
-          type: "PreCompactCaptured",
+          type: "transcript:pre-compact",
           time: Date.now(),
           source: "transcript",
           context: {
@@ -45016,18 +45182,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) {
@@ -57064,7 +57279,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);
@@ -57093,7 +57308,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);
       }
@@ -57237,8 +57453,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);
@@ -60160,7 +60376,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 });
@@ -60259,7 +60475,7 @@ var require_transcript_service = __commonJS({
     var node_readline_1 = 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",
@@ -62229,6 +62445,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 __importDefault = 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_1 = __importDefault(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(projectDir2) {
+        const encoded = encodeProjectDir(projectDir2);
+        const entryDir = (0, node_path_1.join)(this.registryRoot, encoded);
+        const entryFile = (0, node_path_1.join)(entryDir, REGISTRY_FILE);
+        await promises_1.default.mkdir(entryDir, { recursive: true });
+        const entry = {
+          path: projectDir2,
+          displayName: (0, node_path_1.basename)(projectDir2),
+          lastActive: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        const tmpPath = `${entryFile}.${(0, node_crypto_1.randomBytes)(6).toString("hex")}.tmp`;
+        try {
+          await promises_1.default.writeFile(tmpPath, JSON.stringify(entry, null, 2), "utf-8");
+          await promises_1.default.rename(tmpPath, entryFile);
+        } catch (err) {
+          await promises_1.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_1.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_1.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_1.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_1.default.readFile(entryFile, "utf-8");
+            entry = types_1.ProjectRegistryEntrySchema.parse(JSON.parse(raw));
+          } catch {
+            await promises_1.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_1.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) {
@@ -62472,7 +62802,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;
@@ -62745,7 +63075,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;
     } });
@@ -62782,6 +63112,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;
@@ -69829,7 +70166,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()
@@ -69880,7 +70216,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
@@ -69890,8 +70225,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) {
@@ -70205,7 +70540,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 });
@@ -70246,7 +70581,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);
@@ -70281,7 +70616,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, {
@@ -70437,16 +70772,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",
@@ -70457,15 +70904,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) {
@@ -70477,12 +70926,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",
@@ -72064,12 +72529,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 = __importDefault(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,
@@ -72117,22 +72584,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] = {
@@ -72148,7 +72641,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,
@@ -72165,6 +72662,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
+              }));
             }
           }
         }
@@ -72210,6 +72715,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,
@@ -72224,12 +72739,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, {
@@ -72243,7 +72764,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;
     }
   }
@@ -72259,11 +72780,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 = __importDefault(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) {
@@ -72328,6 +72850,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
@@ -72343,12 +72871,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;
           }
@@ -72362,7 +72903,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");
         }
       });
     }
@@ -72375,10 +72916,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;
@@ -72397,6 +72940,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);
@@ -72472,13 +73016,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");
         }
@@ -72496,6 +73053,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();
@@ -72516,10 +73074,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);
@@ -72564,12 +73133,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;
@@ -72598,6 +73177,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
@@ -72655,6 +73239,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();
@@ -72662,8 +73247,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;
       }
@@ -72732,60 +73323,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) {
@@ -72911,7 +73448,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;
@@ -72929,7 +73478,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 };
         }
@@ -73031,6 +73581,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 {
@@ -73040,7 +73597,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,
@@ -73066,13 +73626,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) {
@@ -73328,7 +73888,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;
@@ -73353,7 +73913,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);
@@ -73416,7 +73976,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;
@@ -73435,8 +73997,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) {
@@ -73472,6 +74041,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", {
@@ -73597,7 +74172,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;
     } });
@@ -73605,7 +74180,7 @@ var require_dist5 = __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 });
@@ -73710,7 +74285,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_types3();
     function parsePersonaList(list) {
       if (!list || !list.trim()) {
@@ -73793,11 +74368,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", {
@@ -73807,13 +74382,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) {
@@ -73824,11 +74404,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", {
@@ -73866,12 +74446,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) {
@@ -73901,7 +74480,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_types3();
     async function createFirstSessionSummary(event, ctx) {
@@ -73934,15 +74513,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: {
@@ -73952,11 +74528,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
         };
       },
       /**
@@ -73965,7 +74617,7 @@ var require_events3 = __commonJS({
        */
       summarySkipped(context, metadata) {
         return {
-          type: "SummarySkipped",
+          type: "session-summary:skipped",
           time: Date.now(),
           source: "daemon",
           context: {
@@ -73976,12 +74628,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
+        };
+      }
+    };
   }
 });
 
@@ -74001,7 +74672,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_types3();
     var DEFAULT_PERSONA_SITUATION = "You are watching over the shoulder of a software developer as they work.";
     function buildUserProfileContext(profile) {
@@ -74143,7 +74814,7 @@ var require_update_summary = __commonJS({
     var events_js_1 = require_events3();
     var zod_1 = require_zod();
     var types_js_1 = require_types3();
-    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";
@@ -74196,47 +74867,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) {
@@ -74270,6 +74941,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);
@@ -74373,19 +75048,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,
@@ -74451,6 +75135,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 }]
@@ -74461,6 +75146,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",
@@ -74569,8 +75255,10 @@ var require_on_demand_generation = __commonJS({
     exports2.generateSnarkyMessageOnDemand = generateSnarkyMessageOnDemand;
     exports2.generateResumeMessageOnDemand = generateResumeMessageOnDemand;
     var types_js_1 = require_types3();
-    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";
@@ -74647,6 +75335,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 }]
@@ -74657,6 +75346,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"
@@ -74863,7 +75553,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 = {
@@ -74880,11 +75570,14 @@ var require_dist6 = __commonJS({
     exports2.default = feature;
     __exportStar(require_types3(), 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;
+    } });
   }
 });
 
@@ -75166,7 +75859,11 @@ var require_session_persona_watcher = __commonJS({
         }
         const timer = setTimeout(() => {
           this.debounceTimers.delete(filePath);
-          this.logger.info("Session persona changed", { sessionId, eventType });
+          this.logger.info("[persona-lifecycle] PersonaWatcher: debounce fired, dispatching change event", {
+            sessionId,
+            eventType,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          });
           try {
             this.onChange({
               sessionId,
@@ -76366,7 +77063,7 @@ var require_daemon = __commonJS({
     var VERSION = require_package3().version;
     var IDLE_CHECK_INTERVAL_MS = 30 * 1e3;
     var HEARTBEAT_INTERVAL_MS = 5 * 1e3;
-    var Daemon = class {
+    var Daemon = class _Daemon {
       projectDir;
       configService;
       logger;
@@ -76404,6 +77101,8 @@ var require_daemon = __commonJS({
       idleCheckInterval = null;
       heartbeatInterval = null;
       evictionTimer = null;
+      registryHeartbeatInterval = null;
+      registryService;
       startTime = Date.now();
       /** Cache persona for handoff on clear. */
       cachePersonaForClear(personaId) {
@@ -76454,7 +77153,7 @@ var require_daemon = __commonJS({
         });
         this.logger = (0, core_1.createHookableLogger)(this.logManager.getLogger(), {
           levels: ["warn", "error", "fatal"],
-          hook: (level, _msg, meta) => {
+          hook: (level, msg, meta) => {
             const sessionId = meta?.context?.sessionId ?? meta?.sessionId;
             if (sessionId) {
               const counters = this.logCounters.get(sessionId);
@@ -76470,6 +77169,23 @@ var require_daemon = __commonJS({
               else
                 this.globalLogCounters.errors++;
             }
+            if (level === "error" || level === "fatal") {
+              const errorObj = meta?.error ?? meta?.err;
+              const errorMessage = errorObj?.message ?? msg;
+              const errorStack = errorObj?.stack;
+              const metaContext = meta?.context ?? {};
+              const event = core_1.LogEvents.daemonErrorOccurred({
+                sessionId: sessionId ?? "",
+                correlationId: metaContext.correlationId,
+                traceId: metaContext.traceId,
+                hook: metaContext.hook,
+                taskId: metaContext.taskId
+              }, {
+                errorMessage,
+                errorStack
+              });
+              (0, core_1.logEvent)(this.logManager.getLogger(), event);
+            }
           }
         });
         this.stateService = new core_1.StateService(projectDir2, {
@@ -76484,6 +77200,8 @@ var require_daemon = __commonJS({
           logger: this.logger,
           config: () => this.configService.getAll()
         });
+        const registryRoot = path_1.default.join((0, os_1.homedir)(), ".sidekick", "projects");
+        this.registryService = new core_1.ProjectRegistryService(registryRoot);
         this.stagingStateService = new core_1.StateService(projectDir2, {
           cache: false,
           logger: this.logger,
@@ -76532,6 +77250,7 @@ var require_daemon = __commonJS({
       async start() {
         try {
           this.logger.info("Daemon starting", { projectDir: this.projectDir, pid: process.pid });
+          (0, core_1.logEvent)(this.logger, core_1.LogEvents.daemonStarting({ projectDir: this.projectDir, pid: process.pid }));
           this.setupErrorHandlers();
           await this.writePid();
           await this.writeToken();
@@ -76543,12 +77262,22 @@ var require_daemon = __commonJS({
           }
           (0, task_handlers_js_1.registerStandardTaskHandlers)(this.taskEngine, this.stateService, this.projectDir, this.logger, this.configService.getAll(), this.assetResolver);
           await this.ipcServer.start();
+          (0, core_1.logEvent)(this.logger, core_1.LogEvents.ipcServerStarted({ socketPath: (0, core_1.getSocketPath)(this.projectDir) }));
           this.configWatcher.start();
+          const watchedFiles = [
+            this.stateService.rootDir(),
+            path_1.default.join((0, os_1.homedir)(), ".sidekick"),
+            ...this.configService.core.development.enabled ? [(0, core_1.getDefaultAssetsDir)()] : []
+          ];
+          (0, core_1.logEvent)(this.logger, core_1.LogEvents.configWatcherStarted({ projectDir: this.projectDir, watchedFiles }));
           this.personaWatcher.start();
           this.startIdleCheck();
           this.startHeartbeat();
           this.startEvictionTimer();
+          await this.registerProject();
+          this.startRegistryHeartbeat();
           this.logger.info("Daemon started successfully");
+          (0, core_1.logEvent)(this.logger, core_1.LogEvents.daemonStarted({ startupDurationMs: Date.now() - this.startTime }));
           await (0, core_1.updateDaemonHealth)(this.projectDir, "healthy", this.logger);
         } catch (err) {
           this.logger.fatal("Failed to start daemon", { error: err });
@@ -76561,6 +77290,7 @@ var require_daemon = __commonJS({
         this.stopIdleCheck();
         this.stopHeartbeat();
         this.stopEvictionTimer();
+        this.stopRegistryHeartbeat();
         this.configWatcher.stop();
         this.personaWatcher.stop();
         try {
@@ -76653,9 +77383,10 @@ var require_daemon = __commonJS({
        * On 'unlink' (persona cleared), skips regeneration since there's no persona to voice.
        */
       handlePersonaChange(event) {
-        this.logger.info("Session persona changed via file", {
+        this.logger.info("[persona-lifecycle] PersonaWatcher: file change received by daemon handler", {
           sessionId: event.sessionId,
-          eventType: event.eventType
+          eventType: event.eventType,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
         });
         const personaPath = this.stateService.sessionStatePath(event.sessionId, "session-persona.json");
         this.stateService.invalidateCache(personaPath);
@@ -76889,13 +77620,29 @@ var require_daemon = __commonJS({
         const sessionId = event.context?.sessionId;
         if (sessionId) {
           const payload = event.payload;
-          log.debug("handleSessionEnd entered", { sessionId, endReason: payload.endReason });
+          log.info("[persona-lifecycle] ClearHandoff: handleSessionEnd entered", {
+            sessionId,
+            endReason: payload.endReason
+          });
           if (payload.endReason === "clear") {
             try {
               const summaryState = (0, feature_session_summary_1.createSessionSummaryState)(this.stateService);
+              const personaPath = this.stateService.sessionStatePath(sessionId, "session-persona.json");
+              this.stateService.invalidateCache(personaPath);
+              log.info("[persona-lifecycle] ClearHandoff: invalidated StateService cache before persona read", {
+                sessionId,
+                personaPath
+              });
               const result = await summaryState.sessionPersona.read(sessionId);
+              log.info("[persona-lifecycle] ClearHandoff: read persona from disk", {
+                sessionId,
+                personaId: result.data?.persona_id ?? null
+              });
               if (result.data?.persona_id) {
-                log.debug("Caching persona for clear handoff", { personaId: result.data.persona_id });
+                log.info("[persona-lifecycle] ClearHandoff: caching persona for clear handoff", {
+                  sessionId,
+                  personaId: result.data.persona_id
+                });
                 this.cachePersonaForClear(result.data.persona_id);
               }
             } catch (err) {
@@ -76904,7 +77651,10 @@ var require_daemon = __commonJS({
               });
             }
           } else {
-            log.debug("SessionEnd reason is not clear, skipping persona cache", { endReason: payload.endReason });
+            log.info("[persona-lifecycle] ClearHandoff: SessionEnd reason is not clear, skipping persona cache", {
+              sessionId,
+              endReason: payload.endReason
+            });
           }
           const instrumentedProvider = this.instrumentedProviders.get(sessionId);
           if (instrumentedProvider) {
@@ -77493,6 +78243,7 @@ var require_daemon = __commonJS({
         }, EVICTION_INTERVAL_MS);
         this.evictionTimer.unref();
         this.logger.info("Session eviction timer started", { intervalMs: EVICTION_INTERVAL_MS });
+        (0, core_1.logEvent)(this.logger, core_1.LogEvents.sessionEvictionStarted({ intervalMs: EVICTION_INTERVAL_MS }));
       }
       stopEvictionTimer() {
         if (this.evictionTimer) {
@@ -77500,6 +78251,34 @@ var require_daemon = __commonJS({
           this.evictionTimer = null;
         }
       }
+      // --- Project Registry ---
+      static REGISTRY_HEARTBEAT_INTERVAL_MS = 60 * 60 * 1e3;
+      // 1 hour
+      async registerProject() {
+        try {
+          await this.registryService.register(this.projectDir);
+          this.logger.info("Project registered for UI discovery", { projectDir: this.projectDir });
+        } catch (err) {
+          this.logger.warn("Failed to register project", {
+            error: err instanceof Error ? err.message : String(err)
+          });
+        }
+      }
+      startRegistryHeartbeat() {
+        this.registryHeartbeatInterval = setInterval(() => {
+          void this.registerProject();
+        }, _Daemon.REGISTRY_HEARTBEAT_INTERVAL_MS);
+        this.registryHeartbeatInterval.unref();
+        this.logger.debug("Registry heartbeat started", {
+          intervalMs: _Daemon.REGISTRY_HEARTBEAT_INTERVAL_MS
+        });
+      }
+      stopRegistryHeartbeat() {
+        if (this.registryHeartbeatInterval) {
+          clearInterval(this.registryHeartbeatInterval);
+          this.registryHeartbeatInterval = null;
+        }
+      }
       /**
        * Write current daemon status to state file.
        * Per design/DAEMON.md §4.6: Includes timestamp, pid, uptime, memory, queue stats.