@pellux/goodvibes-sdk 0.30.3 → 0.33.1

package/dist/platform/tools/shared/auto-heal.js

@@ -7,7 +7,8 @@
  *   3. ToolLLM: LLM-assisted fix with error context
  *
  * Design constraints:
- *   - Never throws — returns {healed: false, content: originalContent} on any failure
+ *   - Returns {healed: false, content: originalContent} with warnings whenever
+ *     repair cannot safely produce validated replacement content
  *   - Each stage checks if errors are resolved before proceeding to the next
  *   - Uses Bun.which() to detect available tools at runtime
  */
@@ -17,6 +18,10 @@ import { join, extname } from 'node:path';
 import { randomBytes } from 'node:crypto';
 import { logger } from '../../utils/logger.js';
 import { summarizeError } from '../../utils/error-display.js';
+function addWarning(warnings, message, error) {
+    const warning = error === undefined ? message : `${message}: ${summarizeError(error)}`;
+    warnings.push(warning);
+}
 /**
  * AutoHealer — attempts to fix content with validation errors via a staged pipeline.
  *
@@ -41,6 +46,7 @@ export class AutoHealer {
      * @returns            Heal result — healed=true means content was fixed.
      */
     async heal(filePath, content, errors) {
+        const warnings = [];
         try {
             // Config gate: only run when tools.autoHeal is enabled
             if (!this.configManager.get('tools.autoHeal')) {
@@ -51,20 +57,24 @@ export class AutoHealer {
             }
             const ext = extname(filePath) || '.txt';
             const tmpFile = join(tmpdir(), `auto-heal-${randomBytes(6).toString('hex')}${ext}`);
+            let result = { healed: false, content };
             try {
                 // Stage 1: Formatter
-                const formatterResult = await this._tryFormatter(tmpFile, content, errors);
+                const formatterResult = await this._tryFormatter(tmpFile, content, errors, warnings);
                 if (formatterResult.healed) {
-                    return formatterResult;
+                    result = formatterResult;
                 }
-                // Stage 2: Linter fix
-                const linterResult = await this._tryLinter(tmpFile, formatterResult.content, errors);
-                if (linterResult.healed) {
-                    return linterResult;
+                else {
+                    // Stage 2: Linter fix
+                    const linterResult = await this._tryLinter(tmpFile, formatterResult.content, errors, warnings);
+                    if (linterResult.healed) {
+                        result = linterResult;
+                    }
+                    else {
+                        // Stage 3: ToolLLM
+                        result = await this._tryLLM(filePath, linterResult.content, errors, warnings);
+                    }
                 }
-                // Stage 3: ToolLLM
-                const llmResult = await this._tryLLM(filePath, linterResult.content, errors);
-                return llmResult;
             }
             finally {
                 // Clean up temp file
@@ -73,20 +83,22 @@ export class AutoHealer {
                         unlinkSync(tmpFile);
                     }
                 }
-                catch {
-                    // Ignore cleanup errors
+                catch (cleanupErr) {
+                    addWarning(warnings, `Auto-heal cleanup failed for temporary file '${tmpFile}'`, cleanupErr);
                 }
             }
+            return warnings.length > 0 ? { ...result, warnings } : result;
         }
         catch (err) {
-            logger.debug('AutoHealer.heal: unexpected error (non-fatal)', { error: summarizeError(err) });
-            return { healed: false, content };
+            logger.warn('AutoHealer.heal: unexpected error', { error: summarizeError(err) });
+            addWarning(warnings, 'Auto-heal failed unexpectedly', err);
+            return { healed: false, content, warnings };
         }
     }
     /**
      * Stage 1: Try formatting with prettier or biome.
      */
-    async _tryFormatter(tmpFile, content, errors) {
+    async _tryFormatter(tmpFile, content, errors, warnings) {
         try {
             const prettier = Bun.which('prettier');
             const biome = Bun.which('biome');
@@ -108,6 +120,7 @@ export class AutoHealer {
             }
             if (proc.exitCode !== 0) {
                 logger.debug('AutoHealer: formatter exited non-zero, skipping stage 1');
+                addWarning(warnings, 'Auto-heal formatter exited non-zero; continuing to later repair stages');
                 return { healed: false, content };
             }
             const formatted = readFileSync(tmpFile, 'utf-8');
@@ -116,7 +129,7 @@ export class AutoHealer {
                 return { healed: false, content };
             }
             // Check if errors appear resolved (heuristic: no syntax errors after format)
-            const resolved = await this._errorsResolved(tmpFile, errors);
+            const resolved = await this._errorsResolved(tmpFile, errors, warnings);
             if (resolved) {
                 logger.debug('AutoHealer: errors resolved by formatter');
                 return { healed: true, content: formatted, method: 'formatter' };
@@ -125,14 +138,15 @@ export class AutoHealer {
             return { healed: false, content: formatted };
         }
         catch (err) {
-            logger.debug('AutoHealer: formatter stage failed (non-fatal)', { error: summarizeError(err) });
+            logger.warn('AutoHealer: formatter stage failed', { error: summarizeError(err) });
+            addWarning(warnings, 'Auto-heal formatter stage failed; continuing to later repair stages', err);
             return { healed: false, content };
         }
     }
     /**
      * Stage 2: Try linter fix with eslint.
      */
-    async _tryLinter(tmpFile, content, errors) {
+    async _tryLinter(tmpFile, content, errors, warnings) {
         try {
             const eslint = Bun.which('eslint');
             if (!eslint) {
@@ -150,7 +164,7 @@ export class AutoHealer {
             if (fixed === content) {
                 return { healed: false, content };
             }
-            const resolved = await this._errorsResolved(tmpFile, errors);
+            const resolved = await this._errorsResolved(tmpFile, errors, warnings);
             if (resolved) {
                 logger.debug('AutoHealer: errors resolved by linter');
                 return { healed: true, content: fixed, method: 'linter' };
@@ -158,14 +172,15 @@ export class AutoHealer {
             return { healed: false, content: fixed };
         }
         catch (err) {
-            logger.debug('AutoHealer: linter stage failed (non-fatal)', { error: summarizeError(err) });
+            logger.warn('AutoHealer: linter stage failed', { error: summarizeError(err) });
+            addWarning(warnings, 'Auto-heal linter stage failed; continuing to LLM repair', err);
             return { healed: false, content };
         }
     }
     /**
      * Stage 3: Try ToolLLM with error context.
      */
-    async _tryLLM(filePath, content, errors) {
+    async _tryLLM(filePath, content, errors, warnings) {
         try {
             const errorList = errors.map((e, i) => `${i + 1}. ${e}`).join('\n');
             const prompt = [
@@ -189,15 +204,17 @@ export class AutoHealer {
             });
             if (!response || response.trim() === '') {
                 logger.debug('AutoHealer: LLM returned empty response');
+                addWarning(warnings, 'Auto-heal LLM returned an empty response');
                 return { healed: false, content };
             }
             // Verify the LLM fix actually resolves errors
             const llmTmpFile = join(tmpdir(), `auto-heal-llm-${randomBytes(6).toString('hex')}${extname(filePath) || '.txt'}`);
             try {
                 writeFileSync(llmTmpFile, response, 'utf-8');
-                const resolved = await this._errorsResolved(llmTmpFile, errors);
+                const resolved = await this._errorsResolved(llmTmpFile, errors, warnings);
                 if (!resolved) {
                     logger.debug('AutoHealer: LLM response did not resolve errors');
+                    addWarning(warnings, 'Auto-heal LLM response did not resolve validation errors');
                     return { healed: false, content };
                 }
             }
@@ -206,15 +223,16 @@ export class AutoHealer {
                     if (existsSync(llmTmpFile))
                         unlinkSync(llmTmpFile);
                 }
-                catch {
-                    // Ignore cleanup errors
+                catch (cleanupErr) {
+                    addWarning(warnings, `Auto-heal cleanup failed for temporary LLM file '${llmTmpFile}'`, cleanupErr);
                 }
             }
             logger.debug('AutoHealer: errors resolved by LLM');
             return { healed: true, content: response, method: 'llm' };
         }
         catch (err) {
-            logger.debug('AutoHealer: LLM stage failed (non-fatal)', { error: summarizeError(err) });
+            logger.warn('AutoHealer: LLM stage failed', { error: summarizeError(err) });
+            addWarning(warnings, 'Auto-heal LLM stage failed', err);
             return { healed: false, content };
         }
     }
@@ -224,7 +242,7 @@ export class AutoHealer {
      * For JS/TS files: uses Bun's built-in transpiler to check for syntax errors.
      * For other files: assumes resolved if formatter/linter succeeded (conservative).
      */
-    async _errorsResolved(tmpFile, _errors) {
+    async _errorsResolved(tmpFile, _errors, warnings) {
         try {
             const ext = extname(tmpFile).toLowerCase();
             const isJsTs = ['.js', '.ts', '.jsx', '.tsx', '.mjs', '.cjs'].includes(ext);
@@ -244,9 +262,9 @@ export class AutoHealer {
                 return false;
             }
         }
-        catch {
-            // If we can't check, optimistically assume resolved
-            return true;
+        catch (err) {
+            addWarning(warnings, `Auto-heal could not verify repaired content in '${tmpFile}'`, err);
+            return false;
         }
     }
 }

package/dist/platform/tools/shared/overflow.d.ts

@@ -8,11 +8,11 @@ export declare const DEFAULT_MAX_CHARS = 50000;
  */
 export interface RetentionPolicyConfig {
     /** Maximum age of a spill entry in milliseconds. Default: 1 hour. */
-    maxAgeMs?: number;
+    maxAgeMs?: number | undefined;
     /** Maximum number of retained entries. Default: unlimited. */
-    maxCount?: number;
+    maxCount?: number | undefined;
     /** Maximum total size of retained entries in bytes. Default: unlimited. */
-    maxSizeBytes?: number;
+    maxSizeBytes?: number | undefined;
 }
 /**
  * SpillEntry — a single overflow/spill record as seen by the backend.
@@ -50,13 +50,13 @@ export interface SpillBackend {
 export interface OverflowResult {
     content: string;
     /** Typed ref: `file:path`, `ledger:key`, or `diagnostics:key`. */
-    overflowRef?: string;
+    overflowRef?: string | undefined;
     /** Backend type that stored the overflow content. */
-    spillBackend?: SpillBackendType;
+    spillBackend?: SpillBackendType | undefined;
 }
 export interface OverflowOptions {
-    maxChars?: number;
-    label?: string;
+    maxChars?: number | undefined;
+    label?: string | undefined;
 }
 /**
  * FileBackend — spills overflow content to `.goodvibes/.overflow/` on disk.
@@ -98,22 +98,22 @@ export declare class DiagnosticsBackend implements SpillBackend {
     list(): SpillEntry[];
 }
 /**
- * Create a spill backend by type. Defaults to `'file'`.
+ * Create a spill backend by type.
  */
 export declare function createSpillBackend(type?: SpillBackendType, baseDir?: string): SpillBackend;
 export interface OverflowHandlerConfig {
     /**
      * Which backend to use. Defaults to `'file'`.
      */
-    spillBackend?: SpillBackendType;
+    spillBackend?: SpillBackendType | undefined;
     /** Base directory for FileBackend. */
-    baseDir?: string;
+    baseDir?: string | undefined;
     /** Retention policy applied during cleanup(). */
-    retention?: RetentionPolicyConfig;
+    retention?: RetentionPolicyConfig | undefined;
     /** Inject a custom backend directly (takes precedence over spillBackend). */
-    backend?: SpillBackend;
+    backend?: SpillBackend | undefined;
     /** Feature flags gate alternate spill backends when supplied by SDK runtime services. */
-    featureFlags?: FeatureFlagReader;
+    featureFlags?: FeatureFlagReader | undefined;
 }
 /**
  * Handles large tool output by delegating overflow content to a pluggable

package/dist/platform/tools/shared/overflow.d.ts.map

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

package/dist/platform/tools/shared/overflow.js

@@ -56,7 +56,7 @@ export class FileBackend {
             };
         }
         catch (error) {
-            logger.debug('OverflowHandler: failed to write spill file', {
+            logger.warn('OverflowHandler: failed to write spill file', {
                 path: target,
                 error: summarizeError(error),
             });
@@ -71,7 +71,7 @@ export class FileBackend {
             return readFileSync(target, 'utf-8');
         }
         catch (error) {
-            logger.debug('OverflowHandler: failed to read spill file', {
+            logger.warn('OverflowHandler: failed to read spill file', {
                 path: target,
                 error: summarizeError(error),
             });
@@ -86,7 +86,7 @@ export class FileBackend {
             files = readdirSync(this.overflowDir);
         }
         catch (error) {
-            logger.debug('OverflowHandler: failed to read overflow directory during cleanup', {
+            logger.warn('OverflowHandler: failed to read overflow directory during cleanup', {
                 path: this.overflowDir,
                 error: summarizeError(error),
             });
@@ -100,7 +100,7 @@ export class FileBackend {
                 entries.push({ file, path: p, mtimeMs: s.mtimeMs, size: s.size });
             }
             catch (error) {
-                logger.debug('OverflowHandler: failed to stat spill file during cleanup', {
+                logger.warn('OverflowHandler: failed to stat spill file during cleanup', {
                     path: p,
                     error: summarizeError(error),
                 });
@@ -115,8 +115,11 @@ export class FileBackend {
         const rem = entries.filter((e) => !toDelete.has(e.path));
         if (cfg.maxCount !== Infinity && rem.length > cfg.maxCount) {
             const excess = rem.length - cfg.maxCount;
-            for (let i = 0; i < excess; i++)
-                toDelete.add(rem[i].path);
+            for (let i = 0; i < excess; i++) {
+                const r = rem[i];
+                if (r)
+                    toDelete.add(r.path);
+            }
         }
         const ac = entries.filter((e) => !toDelete.has(e.path));
         if (cfg.maxSizeBytes !== Infinity) {
@@ -133,7 +136,7 @@ export class FileBackend {
                 unlinkSync(p);
             }
             catch (error) {
-                logger.debug('OverflowHandler: failed to delete spill file', {
+                logger.warn('OverflowHandler: failed to delete spill file', {
                     path: p,
                     error: summarizeError(error),
                 });
@@ -147,7 +150,7 @@ export class FileBackend {
             files = readdirSync(this.overflowDir);
         }
         catch (error) {
-            logger.debug('OverflowHandler: failed to read overflow directory during list', {
+            logger.warn('OverflowHandler: failed to read overflow directory during list', {
                 path: this.overflowDir,
                 error: summarizeError(error),
             });
@@ -163,7 +166,7 @@ export class FileBackend {
                     content = readFileSync(p, 'utf-8');
                 }
                 catch (error) {
-                    logger.debug('OverflowHandler: failed to read spill file during list', {
+                    logger.warn('OverflowHandler: failed to read spill file during list', {
                         path: p,
                         error: summarizeError(error),
                     });
@@ -171,7 +174,7 @@ export class FileBackend {
                 result.push({ id: file, filename: file, content, sizeBytes: s.size, createdAt: s.mtimeMs, backendType: 'file' });
             }
             catch (error) {
-                logger.debug('OverflowHandler: failed to list spill file metadata', {
+                logger.warn('OverflowHandler: failed to list spill file metadata', {
                     path: p,
                     error: summarizeError(error),
                 });
@@ -211,8 +214,11 @@ export class LedgerBackend {
         const rem = sorted.filter((e) => !toDelete.has(e.id));
         if (cfg.maxCount !== Infinity && rem.length > cfg.maxCount) {
             const excess = rem.length - cfg.maxCount;
-            for (let i = 0; i < excess; i++)
-                toDelete.add(rem[i].id);
+            for (let i = 0; i < excess; i++) {
+                const r = rem[i];
+                if (r)
+                    toDelete.add(r.id);
+            }
         }
         const ac = sorted.filter((e) => !toDelete.has(e.id));
         if (cfg.maxSizeBytes !== Infinity) {
@@ -257,8 +263,11 @@ export class DiagnosticsBackend {
         const rem = sorted.filter((e) => !toDelete.has(e.id));
         if (cfg.maxCount !== Infinity && rem.length > cfg.maxCount) {
             const excess = rem.length - cfg.maxCount;
-            for (let i = 0; i < excess; i++)
-                toDelete.add(rem[i].id);
+            for (let i = 0; i < excess; i++) {
+                const r = rem[i];
+                if (r)
+                    toDelete.add(r.id);
+            }
         }
         const ac = sorted.filter((e) => !toDelete.has(e.id));
         if (cfg.maxSizeBytes !== Infinity) {
@@ -271,7 +280,8 @@ export class DiagnosticsBackend {
             }
         }
         for (let i = this.log.length - 1; i >= 0; i--) {
-            if (toDelete.has(this.log[i].id))
+            const logEntry = this.log[i];
+            if (logEntry && toDelete.has(logEntry.id))
                 this.log.splice(i, 1);
         }
     }
@@ -281,7 +291,7 @@ export class DiagnosticsBackend {
 }
 // ─── Backend Factory ─────────────────────────────────────────────────────────
 /**
- * Create a spill backend by type. Defaults to `'file'`.
+ * Create a spill backend by type.
  */
 export function createSpillBackend(type = 'file', baseDir) {
     switch (type) {
@@ -291,12 +301,8 @@ export function createSpillBackend(type = 'file', baseDir) {
             return new FileBackend(baseDir);
         case 'ledger': return new LedgerBackend();
         case 'diagnostics': return new DiagnosticsBackend();
-        default: {
-            logger.info(`[overflow] Unknown spill backend "${String(type)}", falling back to file`);
-            if (!baseDir)
-                throw new Error('File spill backend requires an explicit baseDir');
-            return new FileBackend(baseDir);
-        }
+        default:
+            throw new Error(`Unknown spill backend: ${String(type)}`);
     }
 }
 // ─── OverflowHandler ────────────────────────────────────────────────────────

package/dist/platform/tools/shared/process-manager.d.ts

@@ -19,13 +19,13 @@ export interface BackgroundProcess {
      * Null if the process completed normally or SIGKILL was never scheduled.
      */
     killDeadline: number | null;
-    completedAt?: number;
+    completedAt?: number | undefined;
 }
 export interface SpawnOptions {
     /** Abort the process if it hasn't completed within this many ms. Default: 60000. */
-    timeout_ms?: number;
+    timeout_ms?: number | undefined;
     /** Grace period (ms) between SIGTERM and SIGKILL after timeout. Default: 5000. */
-    sigterm_grace_ms?: number;
+    sigterm_grace_ms?: number | undefined;
 }
 export interface BgCommandResult {
     cmd: string;
@@ -33,8 +33,8 @@ export interface BgCommandResult {
     stdout: string;
     stderr: string;
     success: boolean;
-    process_id?: string;
-    pid?: number;
+    process_id?: string | undefined;
+    pid?: number | undefined;
 }
 export declare class ProcessManager {
     private _counter;

package/dist/platform/tools/shared/process-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/shared/process-manager.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAKrF;;;;;GAKG;AAIH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAQD,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,MAAM,CAAmD;IAIjE,OAAO,CAAC,KAAK;IAMb;;;;;;;;;;OAUG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACvC,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC;IA2G3B,iFAAiF;IACjF,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAKpD,kEAAkE;IAClE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAUrE;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAczB,yEAAyE;IACzE,IAAI,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAUvE;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAqDlD,OAAO,CAAC,uBAAuB;CAWhC"}
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/shared/process-manager.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAKrF;;;;;GAKG;AAIH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAQD,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAID,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,MAAM,CAAmD;IAIjE,OAAO,CAAC,KAAK;IAMb;;;;;;;;;;OAUG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACvC,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC;IA2G3B,iFAAiF;IACjF,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAKpD,kEAAkE;IAClE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAUrE;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAczB,yEAAyE;IACzE,IAAI,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAUvE;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAqDlD,OAAO,CAAC,uBAAuB;CAWhC"}

package/dist/platform/tools/shared/process-manager.js

@@ -47,7 +47,7 @@ export class ProcessManager {
         let proc;
         try {
             proc = Bun.spawn(['/bin/sh', '-c', cmd], {
-                cwd,
+                ...(cwd !== undefined ? { cwd } : {}),
                 env: mergedEnv,
                 stdout: 'pipe',
                 stderr: 'pipe',

package/dist/platform/tools/shared/schema-fingerprint.d.ts

@@ -13,7 +13,7 @@
  */
 import type { FeatureFlagManager } from '../../runtime/feature-flags/index.js';
 export interface SchemaFingerprintOptions {
-    readonly featureFlags?: Pick<FeatureFlagManager, 'isEnabled'> | null;
+    readonly featureFlags?: Pick<FeatureFlagManager, 'isEnabled'> | null | undefined;
 }
 /**
  * Checks the runtime feature flags explicitly supplied by the composition root.

package/dist/platform/tools/shared/schema-fingerprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-fingerprint.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/shared/schema-fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;CACtE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAE1F;AAID;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgDnD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAyBR;AAID;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}
+{"version":3,"file":"schema-fingerprint.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/shared/schema-fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAClF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAE1F;AAID;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgDnD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAyBR;AAID;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}

package/dist/platform/tools/shared/schema-fingerprint.js

@@ -124,7 +124,7 @@ export function computeSchemaFingerprintSync(result) {
         const hashArray = Array.from(new Uint8Array(hashBuffer));
         return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
     }
-    // Fallback: deterministic but non-cryptographic (test/non-Bun environments)
+    // Deterministic but non-cryptographic path for test/non-Bun environments.
     // Produces a stable string for the same key set.
     let h = 0x811c9dc5;
     for (let i = 0; i < canonical.length; i++) {

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

@@ -6,20 +6,20 @@ import { TelemetryDB } from '../../state/telemetry.js';
 import type { Tool } from '../../types/tools.js';
 export interface StateToolOptions {
     readonly memoryDir: string;
-    readonly hookDispatcher?: HookDispatcher;
-    readonly modeManager?: ModeManager;
-    readonly telemetryDB?: TelemetryDB;
+    readonly hookDispatcher?: HookDispatcher | undefined;
+    readonly modeManager?: ModeManager | undefined;
+    readonly telemetryDB?: TelemetryDB | undefined;
     /**
      * Current working directory at session start. Exposed as the well-known
      * read-only key `runtime.workingDir` via `mode=get`.
      * Updated dynamically via WorkspaceSwapManager on workspace swap.
      */
-    readonly workingDir?: string;
+    readonly workingDir?: string | undefined;
     /**
      * Daemon home directory (immutable after startup). Exposed as the well-known
      * read-only key `daemon.homeDir` via `mode=get`.
      */
-    readonly daemonHomeDir?: string;
+    readonly daemonHomeDir?: string | undefined;
     /**
      * Workspace swap manager. When provided, `set({values: {'runtime.workingDir': '/new/path'}})`
      * will trigger a real workspace swap via `requestSwap()` instead of returning an error.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/state/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AAkCjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE;QAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAClH;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAsFN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/state/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AA+BjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE;QAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;YAAE,EAAE,EAAE,OAAO,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAClH;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAsFN"}

package/dist/platform/tools/state/index.js

@@ -12,10 +12,7 @@ import { summarizeError } from '../../utils/error-display.js';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-/**
- * Reserved keys that KVState silently drops on set.
- * Duplicated here to filter them out of `keys_written` reporting.
- */
+/** Reserved keys that callers cannot set or clear through the state tool. */
 const RESERVED_KEYS = new Set(['id', 'started_at', '__proto__', 'constructor', 'prototype']);
 function summarizeEntries(entries) {
     return Object.entries(entries).map(([key, value]) => ({
@@ -106,7 +103,7 @@ export function createStateTool(kvState, projectIndex, options) {
         catch (err) {
             _telemetry.errors++;
             const message = summarizeError(err);
-            logger.debug('state tool: unexpected error', { error: message });
+            logger.error('state tool: unexpected error', { error: message });
             return { success: false, error: `Unexpected error: ${message}` };
         }
     }
@@ -462,9 +459,15 @@ async function runSet(input, kvState, _workingDir, _daemonHomeDir, swapManager)
             error: `Cannot write to read-only well-known key(s): ${readonlyAttempts.join(', ')}. These keys are immutable at runtime.`,
         };
     }
+    const reservedAttempts = Object.keys(values).filter((k) => RESERVED_KEYS.has(k));
+    if (reservedAttempts.length > 0) {
+        return {
+            success: false,
+            error: `Cannot write reserved state key(s): ${reservedAttempts.join(', ')}.`,
+        };
+    }
     await kvState.set(values);
-    // Only report keys that KVState actually persists (exclude reserved keys).
-    const written = Object.keys(values).filter((k) => !RESERVED_KEYS.has(k));
+    const written = Object.keys(values);
     return {
         success: true,
         output: JSON.stringify({
@@ -493,6 +496,13 @@ async function runClear(input, kvState) {
     if (keys.length === 0) {
         return { success: false, error: 'mode "clear" requires a non-empty "clearKeys" array' };
     }
+    const reservedAttempts = keys.filter((k) => RESERVED_KEYS.has(k));
+    if (reservedAttempts.length > 0) {
+        return {
+            success: false,
+            error: `Cannot clear reserved state key(s): ${reservedAttempts.join(', ')}.`,
+        };
+    }
     await kvState.clear(keys);
     return {
         success: true,