@pellux/goodvibes-sdk 0.30.2 → 0.33.0

package/dist/platform/sessions/manager.js

@@ -15,12 +15,12 @@ export class SessionManager {
     sessionsDir;
     constructor(baseDir, options) {
         this.sessionsDir = options?.sessionsDir ?? resolveScopedDirectory(baseDir, options?.surfaceRoot, 'sessions');
-        // Clean up orphaned tmp files from a previous crash (C4 fix)
+        // Clean up orphaned tmp files from a crashed write.
         this._cleanupOrphanTempFiles();
     }
     /**
      * Remove any `.tmp-*` files left behind by a crashed write.
-     * Non-fatal: errors are logged and ignored.
+     * Cleanup errors are logged and startup continues.
      */
     _cleanupOrphanTempFiles() {
         if (!existsSync(this.sessionsDir))
@@ -33,23 +33,26 @@ export class SessionManager {
                         unlinkSync(join(this.sessionsDir, f));
                         logger.debug('SessionManager: removed orphan tmp file', { file: f });
                     }
-                    catch {
-                        // Non-fatal
+                    catch (err) {
+                        logger.warn('SessionManager: failed to remove orphan tmp file', {
+                            file: join(this.sessionsDir, f),
+                            error: summarizeError(err),
+                        });
                     }
                 }
             }
         }
         catch (err) {
-            // OBS-11: Non-fatal — dir not readable yet; log so ops can diagnose permission issues
-            logger.debug('[SessionManager] _cleanupOrphanTempFiles: directory read failed', {
+            // Directory may not be readable yet; log so ops can diagnose permission issues.
+            logger.warn('[SessionManager] _cleanupOrphanTempFiles: directory read failed', {
                 dir: this.sessionsDir,
-                error: String(err),
+                error: summarizeError(err),
             });
         }
     }
     /**
      * Atomically write content to filePath via a temp file + fsync + rename.
-     * Protects against partial writes on crash (C4 fix).
+     * Protects against partial writes on crash.
      */
     _atomicWrite(filePath, content) {
         const tmpPath = join(this.sessionsDir, `.tmp-${process.pid}-${Date.now()}`);
@@ -127,7 +130,7 @@ export class SessionManager {
                 record = JSON.parse(line);
             }
             catch {
-                // Non-fatal: malformed JSON line — skip and count it
+                // Malformed JSON line: skip and count it.
                 skipped++;
                 continue;
             }
@@ -144,7 +147,6 @@ export class SessionManager {
                 };
             }
             else if (record.type === 'message') {
-                // Skip messages marked as removed (F2 future feature)
                 if (record.removed === true)
                     continue;
                 // Strip the 'type' wrapper before returning raw message
@@ -159,7 +161,7 @@ export class SessionManager {
             }
         }
         if (skipped > 0)
-            logger.debug('Skipped malformed lines', { name, skipped });
+            logger.warn('Skipped malformed session log lines', { name, skipped });
         return { meta, messages, agentRecords };
     }
     /**
@@ -172,9 +174,12 @@ export class SessionManager {
         try {
             files = readdirSync(this.sessionsDir).filter(f => f.endsWith('.jsonl'));
         }
-        catch {
-            // Non-fatal: sessions directory unreadable (permissions, doesn't exist yet)
-            logger.debug('SessionManager: could not read sessions directory', { dir: this.sessionsDir });
+        catch (err) {
+            // Sessions directory unreadable: return an empty listing.
+            logger.warn('SessionManager: could not read sessions directory', {
+                dir: this.sessionsDir,
+                error: summarizeError(err),
+            });
             return [];
         }
         const sessions = [];
@@ -203,9 +208,12 @@ export class SessionManager {
                             };
                         }
                     }
-                    catch {
-                        // Non-fatal: malformed meta line — session listed with default title/model
-                        logger.debug('SessionManager: malformed meta line', { name });
+                    catch (err) {
+                        // Malformed meta line: list session with default title/model.
+                        logger.warn('SessionManager: malformed meta line', {
+                            name,
+                            error: summarizeError(err),
+                        });
                     }
                 }
                 // Count message lines: parse each line's type/removed fields only (no full content parse)
@@ -222,9 +230,12 @@ export class SessionManager {
                     }
                 }
             }
-            catch {
-                // Non-fatal: session file unreadable — skip it from the listing
-                logger.debug('SessionManager: unreadable session file', { name });
+            catch (err) {
+                // Session file unreadable: skip it from the listing.
+                logger.warn('SessionManager: unreadable session file', {
+                    name,
+                    error: summarizeError(err),
+                });
                 continue;
             }
             sessions.push({
@@ -273,9 +284,12 @@ export class SessionManager {
                     : undefined,
             };
         }
-        catch {
-            // Non-fatal: session file unreadable or missing meta — return null to caller
-            logger.debug('SessionManager: could not read session meta', { name: filePath });
+        catch (err) {
+            // Session file unreadable or missing meta: return null to caller.
+            logger.warn('SessionManager: could not read session meta', {
+                name: filePath,
+                error: summarizeError(err),
+            });
             return null;
         }
     }
@@ -302,8 +316,8 @@ export class SessionManager {
             lines[0] = JSON.stringify(record);
             this._atomicWrite(filePath, lines.join('\n'));
         }
-        catch {
-            throw new Error(`Failed to update session title: ${name}`);
+        catch (err) {
+            throw new Error(`Failed to update session title: ${name}: ${summarizeError(err)}`);
         }
     }
     /**
@@ -358,18 +372,24 @@ export class SessionManager {
                             }
                         }
                     }
-                    catch {
-                        // Non-fatal: malformed line in session during search — skip it
-                        logger.debug('SessionManager: malformed line during search', { name });
+                    catch (err) {
+                        // Malformed line in session during search: skip it.
+                        logger.warn('SessionManager: malformed line during search', {
+                            name,
+                            error: summarizeError(err),
+                        });
                     }
                 }
                 if (matchCount > 0) {
                     results.push({ session, matchCount, snippets });
                 }
             }
-            catch {
-                // Non-fatal: session unreadable during search — skip it
-                logger.debug('SessionManager: unreadable session during search', { name });
+            catch (err) {
+                // Session unreadable during search: skip it.
+                logger.warn('SessionManager: unreadable session during search', {
+                    name,
+                    error: summarizeError(err),
+                });
             }
         }
         // Sort by match count descending

package/dist/platform/sessions/orchestration/graph.d.ts

@@ -175,7 +175,7 @@ export declare class SessionTaskGraph {
     private _pathExists;
     /**
      * Resolve a set of ref keys to their corresponding CrossSessionTaskRef objects.
-     * Silently skips any keys that are no longer present in the map.
+     * Skips keys that are no longer present in the map.
      */
     private _refsForKeys;
 }

package/dist/platform/sessions/orchestration/graph.js

@@ -152,11 +152,11 @@ export class SessionTaskGraph {
         // Forward edge
         if (!this._deps.has(fromKey))
             this._deps.set(fromKey, new Set());
-        this._deps.get(fromKey).add(toKey);
+        this._deps.get(fromKey)?.add(toKey);
         // Reverse edge
         if (!this._rdeps.has(toKey))
             this._rdeps.set(toKey, new Set());
-        this._rdeps.get(toKey).add(fromKey);
+        this._rdeps.get(toKey)?.add(fromKey);
         const edge = {
             fromRef: { sessionId: from.sessionId, taskId: from.taskId },
             toRef: { sessionId: to.sessionId, taskId: to.taskId },
@@ -413,7 +413,7 @@ export class SessionTaskGraph {
     }
     /**
      * Resolve a set of ref keys to their corresponding CrossSessionTaskRef objects.
-     * Silently skips any keys that are no longer present in the map.
+     * Skips keys that are no longer present in the map.
      */
     _refsForKeys(keys) {
         const result = [];

package/dist/platform/sessions/orchestration/registry.d.ts

@@ -44,7 +44,7 @@ export declare class CrossSessionTaskRegistry {
         taskId: string;
     }, reason?: string): {
         ok: boolean;
-        error?: string;
+        error?: string | undefined;
     };
     /**
      * Update the status of a task ref.
@@ -93,7 +93,7 @@ export declare class CrossSessionTaskRegistry {
     }, fromSessionId: string, toSessionId: string, reason?: string): {
         ok: boolean;
         handoffId?: string;
-        error?: string;
+        error?: string | undefined;
     };
     /**
      * Acknowledge a handoff from the destination session.
@@ -132,12 +132,12 @@ export declare class CrossSessionTaskRegistry {
     dispose(): void;
     /**
      * Load the persisted graph from disk and hydrate the in-memory graph.
-     * Non-fatal: if the file is missing or malformed, the graph starts empty.
+     * If the file is missing or malformed, the graph starts empty.
      */
     private _load;
     /**
      * Flush the current graph snapshot to disk.
-     * Non-fatal: if the write fails, logs a debug message and continues.
+     * If the write fails, logs a warning and continues with the in-memory graph.
      */
     private _flush;
     /** Schedule a debounced async write (coalesces rapid successive mutations). */

package/dist/platform/sessions/orchestration/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/platform/sessions/orchestration/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAQ/E;;;;;;;;GAQG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA8C;IACjE,YAAY,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEzC;;OAEG;gBACgB,SAAS,EAAE,MAAM;IAiBpC;;;;;;;;OAQG;IACI,QAAQ,CACb,GAAG,EAAE,mBAAmB,EACxB,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EACjD,MAAM,CAAC,EAAE,MAAM,GACd;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAmBlC;;;;;;;OAOG;IACI,eAAe,CACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kBAAkB,GACzB,OAAO;IAMV;;OAEG;IACI,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIjF;;OAEG;IACI,UAAU,IAAI,mBAAmB,EAAE;IAI1C;;OAEG;IACI,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIjE;;OAEG;IACI,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIhF;;OAEG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAM9E;;;;;;;;;;;OAWG;IACI,eAAe,CACpB,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC9C,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IA8BtD;;;;;OAKG;IACI,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMrD;;OAEG;IACI,WAAW,IAAI,iBAAiB,EAAE;IAMzC;;;;;OAKG;IACI,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IAQ/D;;;OAGG;IACI,QAAQ,IAAI,wBAAwB;IAI3C;;;OAGG;IACI,KAAK,IAAI,IAAI;IAQpB;;;;;OAKG;IACI,OAAO,IAAI,IAAI;IAUtB;;;OAGG;IACH,OAAO,CAAC,KAAK;IA4Bb;;;OAGG;IACH,OAAO,CAAC,MAAM;IAId,+EAA+E;IAC/E,OAAO,CAAC,eAAe;IAoBvB,0EAA0E;IAC1E,OAAO,CAAC,UAAU;CAgBnB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/platform/sessions/orchestration/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAQ/E;;;;;;;;GAQG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA8C;IACjE,YAAY,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAEzC;;OAEG;gBACgB,SAAS,EAAE,MAAM;IAiBpC;;;;;;;;OAQG;IACI,QAAQ,CACb,GAAG,EAAE,mBAAmB,EACxB,SAAS,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EACjD,MAAM,CAAC,EAAE,MAAM,GACd;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;IAmB9C;;;;;;;OAOG;IACI,eAAe,CACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kBAAkB,GACzB,OAAO;IAMV;;OAEG;IACI,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIjF;;OAEG;IACI,UAAU,IAAI,mBAAmB,EAAE;IAI1C;;OAEG;IACI,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIjE;;OAEG;IACI,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAIhF;;OAEG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAM9E;;;;;;;;;;;OAWG;IACI,eAAe,CACpB,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC9C,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;IA8BlE;;;;;OAKG;IACI,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMrD;;OAEG;IACI,WAAW,IAAI,iBAAiB,EAAE;IAMzC;;;;;OAKG;IACI,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB;IAQ/D;;;OAGG;IACI,QAAQ,IAAI,wBAAwB;IAI3C;;;OAGG;IACI,KAAK,IAAI,IAAI;IAQpB;;;;;OAKG;IACI,OAAO,IAAI,IAAI;IAUtB;;;OAGG;IACH,OAAO,CAAC,KAAK;IA4Bb;;;OAGG;IACH,OAAO,CAAC,MAAM;IAId,+EAA+E;IAC/E,OAAO,CAAC,eAAe;IAoBvB,0EAA0E;IAC1E,OAAO,CAAC,UAAU;CAgBnB"}

package/dist/platform/sessions/orchestration/registry.js

@@ -221,7 +221,7 @@ export class CrossSessionTaskRegistry {
     // ── Private ───────────────────────────────────────────────────────────────────
     /**
      * Load the persisted graph from disk and hydrate the in-memory graph.
-     * Non-fatal: if the file is missing or malformed, the graph starts empty.
+     * If the file is missing or malformed, the graph starts empty.
      */
     _load() {
         if (!existsSync(this._graphPath))
@@ -242,8 +242,8 @@ export class CrossSessionTaskRegistry {
             });
         }
         catch (e) {
-            // Non-fatal: malformed or missing graph file — start with empty graph
-            logger.debug('CrossSessionTaskRegistry: could not load task graph', {
+            // Malformed or unreadable graph file: start with an empty in-memory graph and surface the persistence fault.
+            logger.warn('CrossSessionTaskRegistry: could not load task graph', {
                 path: this._graphPath,
                 error: summarizeError(e),
             });
@@ -251,7 +251,7 @@ export class CrossSessionTaskRegistry {
     }
     /**
      * Flush the current graph snapshot to disk.
-     * Non-fatal: if the write fails, logs a debug message and continues.
+     * If the write fails, logs a warning and continues with the in-memory graph.
      */
     _flush() {
         this._scheduledFlush();
@@ -289,8 +289,8 @@ export class CrossSessionTaskRegistry {
             writeFileSync(this._graphPath, JSON.stringify(snap, null, 2), 'utf-8');
         }
         catch (e) {
-            // Non-fatal: failed to persist graph — in-memory graph remains authoritative
-            logger.debug('CrossSessionTaskRegistry: failed to flush task graph', {
+            // Failed persistence leaves the in-memory graph authoritative.
+            logger.warn('CrossSessionTaskRegistry: failed to flush task graph', {
                 path: this._graphPath,
                 error: summarizeError(e),
             });

package/dist/platform/sessions/orchestration/types.d.ts

@@ -26,7 +26,7 @@ export interface CrossSessionTaskRef {
     /** Epoch ms of last status update. */
     updatedAt: number;
     /** Optional label applied at link time. */
-    label?: string;
+    label?: string | undefined;
 }
 /**
  * A directed dependency edge between two cross-session task refs.
@@ -42,7 +42,7 @@ export interface TaskDependencyEdge {
     /** Epoch ms when the dependency was established. */
     readonly linkedAt: number;
     /** Optional human-readable reason for the dependency. */
-    readonly reason?: string;
+    readonly reason?: string | undefined;
 }
 /**
  * Records a task handoff — when a task's continuation is transferred from
@@ -58,13 +58,13 @@ export interface TaskHandoffRecord {
     /** Session ID receiving the task (destination). */
     readonly toSessionId: string;
     /** Human-readable reason for the handoff. */
-    readonly reason?: string;
+    readonly reason?: string | undefined;
     /** Epoch ms when the handoff was initiated. */
     readonly initiatedAt: number;
     /** Whether the handoff completed (destination session acknowledged it). */
     acknowledged: boolean;
     /** Epoch ms when the destination acknowledged. */
-    acknowledgedAt?: number;
+    acknowledgedAt?: number | undefined;
 }
 /**
  * Defines the scope of a cross-session cancellation operation.
@@ -87,11 +87,11 @@ export interface CancellationRequest {
     /** Session ID of the task to cancel (required for task/subtree scope). */
     sessionId: string;
     /** Task ID to cancel (required for task/subtree scope; ignored for session scope). */
-    taskId?: string;
+    taskId?: string | undefined;
     /** Cancellation scope — defaults to 'task'. */
     scope: CancellationScope;
     /** Human-readable reason surfaced to the task owner. */
-    reason?: string;
+    reason?: string | undefined;
     /** Epoch ms when the cancellation was requested. */
     readonly requestedAt: number;
 }
@@ -108,7 +108,7 @@ export interface CancellationResult {
         reason: string;
     }>;
     /** Error message if the operation failed entirely. */
-    error?: string;
+    error?: string | undefined;
 }
 /**
  * A point-in-time snapshot of the full cross-session task graph.

package/dist/platform/sessions/orchestration/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/sessions/orchestration/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/sessions/orchestration/types.ts"],"names":[],"mappings":"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"}

package/dist/platform/state/file-cache.d.ts

@@ -5,7 +5,7 @@ export interface CacheEntry {
     /** SHA-256 hash of the file content at last read/update. */
     contentHash: string;
     /** Stored content (only in with_content mode). */
-    content?: string;
+    content?: string | undefined;
     lineCount: number;
     byteSize: number;
     firstReadAt: number;
@@ -21,7 +21,7 @@ export interface CacheEntry {
 export interface ConflictInfo {
     yourVersion: number;
     currentVersion: number;
-    diffSinceRead?: string;
+    diffSinceRead?: string | undefined;
 }
 export type CacheStatus = 'miss' | 'unchanged' | 'modified';
 /**
@@ -52,8 +52,8 @@ export declare class FileStateCache {
      */
     lookup(filePath: string): {
         status: CacheStatus;
-        entry?: CacheEntry;
-        diff?: string;
+        entry?: CacheEntry | undefined;
+        diff?: string | undefined;
     };
     /**
      * Record that a file was read or written by a tool/agent.

package/dist/platform/state/file-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../../src/platform/state/file-cache.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAW5D;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;gBAEV,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IASnF;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAiDpF;;;OAGG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI;IAmDP;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAW7E;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAcD;;OAEG;IACH,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,aAAa;CAYtB;AAaD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,MAAM,CAQ3G"}
+{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../../src/platform/state/file-cache.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAW5D;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;gBAEV,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IASnF;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;IAmD5G;;;OAGG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI;IAmDP;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAW7E;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAcD;;OAEG;IACH,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,aAAa;CAYtB;AAiBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,MAAM,CAQ3G"}

package/dist/platform/state/file-cache.js

@@ -1,5 +1,6 @@
 import { readFileSync } from 'fs';
 import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
 /**
  * FileStateCache — File state tracking with Optimistic Concurrency Control.
  *
@@ -42,9 +43,11 @@ export class FileStateCache {
             currentContent = readFileSync(filePath, 'utf-8');
             currentHash = this.hash(currentContent);
         }
-        catch {
-            // File no longer exists or unreadable
-            return { status: 'miss' };
+        catch (err) {
+            if (isMissingFileError(err)) {
+                return { status: 'miss' };
+            }
+            throw new Error(`FileStateCache failed to read cached file ${filePath}: ${summarizeError(err)}`);
         }
         node.accessAt = Date.now();
         if (currentHash === node.entry.contentHash) {
@@ -195,6 +198,9 @@ export class FileStateCache {
         }
     }
 }
+function isMissingFileError(err) {
+    return typeof err === 'object' && err !== null && 'code' in err && err.code === 'ENOENT';
+}
 // ---------------------------------------------------------------------------
 // Module-level helpers
 // ---------------------------------------------------------------------------
@@ -227,7 +233,7 @@ function computeHunks(oldLines, newLines, CONTEXT = 3) {
     let i = 0;
     while (i < edits.length) {
         // Find next non-context edit
-        while (i < edits.length && edits[i].type === 'context')
+        while (i < edits.length && edits[i]?.type === 'context')
             i++;
         if (i >= edits.length)
             break;
@@ -236,13 +242,13 @@ function computeHunks(oldLines, newLines, CONTEXT = 3) {
         let hunkEnd = i;
         // Extend to next gap
         while (hunkEnd < edits.length) {
-            if (edits[hunkEnd].type !== 'context') {
+            if (edits[hunkEnd]?.type !== 'context') {
                 hunkEnd++;
             }
             else {
                 // Check if there's another non-context within CONTEXT distance
                 let next = hunkEnd + 1;
-                while (next < edits.length && edits[next].type === 'context')
+                while (next < edits.length && edits[next]?.type === 'context')
                     next++;
                 if (next < edits.length && next - hunkEnd <= CONTEXT * 2) {
                     hunkEnd = next;
@@ -259,9 +265,9 @@ function computeHunks(oldLines, newLines, CONTEXT = 3) {
         let oldLine = 1;
         let newLine = 1;
         for (let j = 0; j < hunkStart; j++) {
-            if (edits[j].type !== 'added')
+            if (edits[j]?.type !== 'added')
                 oldLine++;
-            if (edits[j].type !== 'removed')
+            if (edits[j]?.type !== 'removed')
                 newLine++;
         }
         oldStart = oldLine;

package/dist/platform/state/file-undo.js

@@ -50,7 +50,7 @@ export class FileUndoManager {
             }
         }
         catch (err) {
-            logger.debug('file-undo: undo write failed', { path: op.path, error: summarizeError(err) });
+            logger.warn('file-undo: undo write failed', { path: op.path, error: summarizeError(err) });
             // Put it back on the stack so state is consistent
             this.undoStack.push(op);
             throw err;
@@ -77,7 +77,7 @@ export class FileUndoManager {
             logger.debug('file-undo: re-applied operation', { path: op.path });
         }
         catch (err) {
-            logger.debug('file-undo: redo write failed', { path: op.path, error: summarizeError(err) });
+            logger.warn('file-undo: redo write failed', { path: op.path, error: summarizeError(err) });
             this.redoStack.push(op);
             throw err;
         }

package/dist/platform/state/file-watcher.d.ts

@@ -21,7 +21,7 @@ export declare class FileWatcher {
     private watchers;
     /** Pending debounce timers keyed by absolute path */
     private debounceTimers;
-    /** watchFile listeners keyed by absolute path for reliable polling fallback */
+    /** watchFile listeners keyed by absolute path for reliable polling mode */
     private pollListeners;
     private watching;
     /** Debounce window in milliseconds */
@@ -44,7 +44,7 @@ export declare class FileWatcher {
     /**
      * Add a path to the watch list.
      * If already watching, opens a watcher immediately.
-     * Silently skips paths that do not exist.
+     * Missing paths remain registered and are opened if they appear later.
      */
     addPath(inputPath: string): void;
     /**

package/dist/platform/state/file-watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/platform/state/file-watcher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAsB7D;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,6CAA6C;IAC7C,OAAO,CAAC,YAAY,CAA0B;IAC9C,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAqC;IACrD,qDAAqD;IACrD,OAAO,CAAC,cAAc,CAAyD;IAC/E,+EAA+E;IAC/E,OAAO,CAAC,aAAa,CAA8D;IAEnF,OAAO,CAAC,QAAQ,CAAS;IAEzB,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAO;gBAGxC,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,EAChC,cAAc,CAAC,EAAE,cAAc;IAYjC;;;;OAIG;IACH,KAAK,IAAI,IAAI;IA+Bb;;OAEG;IACH,IAAI,IAAI,IAAI;IAwBZ,oEAAoE;IACpE,UAAU,IAAI,OAAO;IAQrB;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAchC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAuBnC,uDAAuD;IACvD,eAAe,IAAI,WAAW,CAAC,MAAM,CAAC;IAQtC,OAAO,CAAC,YAAY;IAmDpB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,aAAa;CAiCtB"}
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/platform/state/file-watcher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAsB7D;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,6CAA6C;IAC7C,OAAO,CAAC,YAAY,CAA0B;IAC9C,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAqC;IACrD,qDAAqD;IACrD,OAAO,CAAC,cAAc,CAAyD;IAC/E,2EAA2E;IAC3E,OAAO,CAAC,aAAa,CAA8D;IAEnF,OAAO,CAAC,QAAQ,CAAS;IAEzB,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAO;gBAGxC,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,EAChC,cAAc,CAAC,EAAE,cAAc;IAYjC;;;;OAIG;IACH,KAAK,IAAI,IAAI;IA+Bb;;OAEG;IACH,IAAI,IAAI,IAAI;IAwBZ,oEAAoE;IACpE,UAAU,IAAI,OAAO;IAQrB;;;;OAIG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAchC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAuBnC,uDAAuD;IACvD,eAAe,IAAI,WAAW,CAAC,MAAM,CAAC;IAItC,OAAO,CAAC,YAAY;IAqDpB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,aAAa;CAiCtB"}

package/dist/platform/state/file-watcher.js

@@ -38,7 +38,7 @@ export class FileWatcher {
     watchers = new Map();
     /** Pending debounce timers keyed by absolute path */
     debounceTimers = new Map();
-    /** watchFile listeners keyed by absolute path for reliable polling fallback */
+    /** watchFile listeners keyed by absolute path for reliable polling mode */
     pollListeners = new Map();
     watching = false;
     /** Debounce window in milliseconds */
@@ -74,7 +74,7 @@ export class FileWatcher {
         const MAX_WATCHERS = 500;
         for (const entry of this.projectIndex.getFiles()) {
             if (this.watchedPaths.size >= MAX_WATCHERS) {
-                logger.debug('FileWatcher: MAX_WATCHERS cap reached, skipping remaining files', { cap: MAX_WATCHERS });
+                logger.warn('FileWatcher: MAX_WATCHERS cap reached, skipping remaining files', { cap: MAX_WATCHERS });
                 break;
             }
             const absPath = entry.path.startsWith('/')
@@ -102,7 +102,7 @@ export class FileWatcher {
                 watcher.close();
             }
             catch (err) {
-                logger.debug('FileWatcher: watcher close error', { error: summarizeError(err) });
+                logger.warn('FileWatcher: watcher close failed', { error: summarizeError(err) });
             }
         }
         this.watchers.clear();
@@ -111,7 +111,7 @@ export class FileWatcher {
                 unwatchFile(absPath, listener);
             }
             catch (err) {
-                logger.debug('FileWatcher: unwatchFile error', { absPath, error: summarizeError(err) });
+                logger.warn('FileWatcher: unwatchFile failed', { absPath, error: summarizeError(err) });
             }
         }
         this.pollListeners.clear();
@@ -128,7 +128,7 @@ export class FileWatcher {
     /**
      * Add a path to the watch list.
      * If already watching, opens a watcher immediately.
-     * Silently skips paths that do not exist.
+     * Missing paths remain registered and are opened if they appear later.
      */
     addPath(inputPath) {
         const absPath = resolve(inputPath);
@@ -161,7 +161,7 @@ export class FileWatcher {
                 watcher.close();
             }
             catch (err) {
-                logger.debug('FileWatcher: watcher close error', { error: summarizeError(err) });
+                logger.warn('FileWatcher: watcher close failed', { absPath, error: summarizeError(err) });
             }
             this.watchers.delete(absPath);
         }
@@ -171,7 +171,7 @@ export class FileWatcher {
                 unwatchFile(absPath, pollListener);
             }
             catch (err) {
-                logger.debug('FileWatcher: unwatchFile error', { absPath, error: summarizeError(err) });
+                logger.warn('FileWatcher: unwatchFile failed', { absPath, error: summarizeError(err) });
             }
             this.pollListeners.delete(absPath);
         }
@@ -180,13 +180,11 @@ export class FileWatcher {
     getWatchedPaths() {
         return new Set(this.watchedPaths);
     }
-    // ---------------------------------------------------------------------------
-    // Internal
-    // ---------------------------------------------------------------------------
     _openWatcher(absPath) {
-        // Skip non-existent paths silently
-        if (!existsSync(absPath))
+        if (!existsSync(absPath)) {
+            logger.debug('FileWatcher: watch path does not exist yet', { path: absPath });
             return;
+        }
         // Already watching this path
         if (this.watchers.has(absPath))
             return;
@@ -196,7 +194,7 @@ export class FileWatcher {
                 isDir = statSync(absPath).isDirectory();
             }
             catch (error) {
-                logger.debug('FileWatcher: stat before watch failed', {
+                logger.warn('FileWatcher: stat before watch failed', {
                     path: absPath,
                     error: summarizeError(error),
                 });
@@ -209,7 +207,7 @@ export class FileWatcher {
                 this._scheduleChange(changedPath);
             });
             watcher.on('error', (err) => {
-                logger.debug('FileWatcher: watcher error', { absPath, error: summarizeError(err) });
+                logger.warn('FileWatcher: watcher error', { absPath, error: summarizeError(err) });
                 this.watchers.delete(absPath);
             });
             this.watchers.set(absPath, watcher);
@@ -224,7 +222,7 @@ export class FileWatcher {
             }
         }
         catch (err) {
-            logger.debug('FileWatcher: failed to open watcher', { absPath, error: summarizeError(err) });
+            logger.warn('FileWatcher: failed to open watcher', { absPath, error: summarizeError(err) });
         }
     }
     _scheduleChange(absPath) {
@@ -267,7 +265,7 @@ export class FileWatcher {
                 payload: { filePath: absPath },
             };
             this.hookDispatcher.fire(event).catch((err) => {
-                logger.debug('FileWatcher: hook fire error', { absPath, error: summarizeError(err) });
+                logger.warn('FileWatcher: hook fire failed', { absPath, error: summarizeError(err) });
             });
         }
     }

package/dist/platform/state/index.d.ts

@@ -22,6 +22,7 @@ export { buildIncidentMemoryAddOptions, buildMcpSecurityMemoryAddOptions, buildP
 export { MEMORY_VECTOR_DIMS, embedMemoryText, resolveMemoryVectorDbPath, SqliteVecMemoryIndex, } from './memory-vector-store.js';
 export type { MemoryVectorCandidate, MemoryVectorStats } from './memory-vector-store.js';
 export { DEFAULT_MEMORY_EMBEDDING_DIMS, HASHED_MEMORY_EMBEDDING_PROVIDER, MemoryEmbeddingProviderRegistry, normalizeMemoryEmbeddingVector, } from './memory-embeddings.js';
+export { createBuiltinMemoryEmbeddingProviders } from './memory-embedding-http.js';
 export type { MemoryEmbeddingDoctorReport, MemoryEmbeddingProvider, MemoryEmbeddingProviderState, MemoryEmbeddingProviderStatus, MemoryEmbeddingRequest, MemoryEmbeddingResult, MemoryEmbeddingUsage, } from './memory-embeddings.js';
 export type { KnowledgeInjection } from './knowledge-injection.js';
 export { selectKnowledgeForTask, buildKnowledgeInjectionPrompt } from './knowledge-injection.js';