@pellux/goodvibes-sdk 0.18.13 → 0.18.15

package/dist/_internal/platform/tools/shared/auto-heal.d.ts

@@ -0,0 +1,63 @@
+/**
+ * AutoHealer — three-stage pipeline to fix write/edit validation failures.
+ *
+ * Pipeline (opt-in via tools.autoHeal config):
+ *   1. Formatter: prettier --write or biome format
+ *   2. Linter fix: eslint --fix
+ *   3. ToolLLM: LLM-assisted fix with error context
+ *
+ * Design constraints:
+ *   - Never throws — returns {healed: false, content: originalContent} on any failure
+ *   - Each stage checks if errors are resolved before proceeding to the next
+ *   - Uses Bun.which() to detect available tools at runtime
+ */
+import type { ConfigManager } from '../../config/manager.js';
+import type { ToolLLM } from '../../config/tool-llm.js';
+/** Result of an auto-heal attempt. */
+export interface HealResult {
+    healed: boolean;
+    content: string;
+    method?: 'formatter' | 'linter' | 'llm';
+}
+/**
+ * AutoHealer — attempts to fix content with validation errors via a staged pipeline.
+ *
+ * Usage:
+ *   const healer = new AutoHealer();
+ *   const result = await healer.heal(filePath, content, errors);
+ *   if (result.healed) { // use result.content }
+ */
+export declare class AutoHealer {
+    private readonly configManager;
+    private readonly toolLLM;
+    constructor(configManager: Pick<ConfigManager, 'get'>, toolLLM: Pick<ToolLLM, 'chat'>);
+    /**
+     * Attempt to auto-heal content with validation errors.
+     *
+     * @param filePath     Original file path (used to determine extension/context).
+     * @param content      File content that failed validation.
+     * @param errors       Validation error messages from the failed write/edit.
+     * @returns            Heal result — healed=true means content was fixed.
+     */
+    heal(filePath: string, content: string, errors: string[]): Promise<HealResult>;
+    /**
+     * Stage 1: Try formatting with prettier or biome.
+     */
+    private _tryFormatter;
+    /**
+     * Stage 2: Try linter fix with eslint.
+     */
+    private _tryLinter;
+    /**
+     * Stage 3: Try ToolLLM with error context.
+     */
+    private _tryLLM;
+    /**
+     * Heuristic check: attempt to parse/validate a temp file to see if errors are resolved.
+     *
+     * 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).
+     */
+    private _errorsResolved;
+}
+//# sourceMappingURL=auto-heal.d.ts.map

package/dist/_internal/platform/tools/shared/auto-heal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-heal.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/shared/auto-heal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAIxD,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,EACzC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;IAGjD;;;;;;;OAOG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IA8CpF;;OAEG;YACW,aAAa;IAmD3B;;OAEG;YACW,UAAU;IAqCxB;;OAEG;YACW,OAAO;IAsDrB;;;;;OAKG;YACW,eAAe;CA0B9B"}

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

@@ -0,0 +1,252 @@
+/**
+ * AutoHealer — three-stage pipeline to fix write/edit validation failures.
+ *
+ * Pipeline (opt-in via tools.autoHeal config):
+ *   1. Formatter: prettier --write or biome format
+ *   2. Linter fix: eslint --fix
+ *   3. ToolLLM: LLM-assisted fix with error context
+ *
+ * Design constraints:
+ *   - Never throws — returns {healed: false, content: originalContent} on any failure
+ *   - Each stage checks if errors are resolved before proceeding to the next
+ *   - Uses Bun.which() to detect available tools at runtime
+ */
+import { writeFileSync, readFileSync, unlinkSync, existsSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, extname } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { logger } from '@pellux/goodvibes-sdk/platform/utils/logger';
+import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils/error-display';
+/**
+ * AutoHealer — attempts to fix content with validation errors via a staged pipeline.
+ *
+ * Usage:
+ *   const healer = new AutoHealer();
+ *   const result = await healer.heal(filePath, content, errors);
+ *   if (result.healed) { // use result.content }
+ */
+export class AutoHealer {
+    configManager;
+    toolLLM;
+    constructor(configManager, toolLLM) {
+        this.configManager = configManager;
+        this.toolLLM = toolLLM;
+    }
+    /**
+     * Attempt to auto-heal content with validation errors.
+     *
+     * @param filePath     Original file path (used to determine extension/context).
+     * @param content      File content that failed validation.
+     * @param errors       Validation error messages from the failed write/edit.
+     * @returns            Heal result — healed=true means content was fixed.
+     */
+    async heal(filePath, content, errors) {
+        try {
+            // Config gate: only run when tools.autoHeal is enabled
+            if (!this.configManager.get('tools.autoHeal')) {
+                return { healed: false, content };
+            }
+            if (!errors.length) {
+                return { healed: false, content };
+            }
+            const ext = extname(filePath) || '.txt';
+            const tmpFile = join(tmpdir(), `auto-heal-${randomBytes(6).toString('hex')}${ext}`);
+            try {
+                // Stage 1: Formatter
+                const formatterResult = await this._tryFormatter(tmpFile, content, errors);
+                if (formatterResult.healed) {
+                    return formatterResult;
+                }
+                // Stage 2: Linter fix
+                const linterResult = await this._tryLinter(tmpFile, formatterResult.content, errors);
+                if (linterResult.healed) {
+                    return linterResult;
+                }
+                // Stage 3: ToolLLM
+                const llmResult = await this._tryLLM(filePath, linterResult.content, errors);
+                return llmResult;
+            }
+            finally {
+                // Clean up temp file
+                try {
+                    if (existsSync(tmpFile)) {
+                        unlinkSync(tmpFile);
+                    }
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        }
+        catch (err) {
+            logger.debug('AutoHealer.heal: unexpected error (non-fatal)', { error: summarizeError(err) });
+            return { healed: false, content };
+        }
+    }
+    /**
+     * Stage 1: Try formatting with prettier or biome.
+     */
+    async _tryFormatter(tmpFile, content, errors) {
+        try {
+            const prettier = Bun.which('prettier');
+            const biome = Bun.which('biome');
+            if (!prettier && !biome) {
+                logger.debug('AutoHealer: no formatter found (prettier/biome), skipping stage 1');
+                return { healed: false, content };
+            }
+            // Write content to temp file
+            writeFileSync(tmpFile, content, 'utf-8');
+            let proc;
+            if (prettier) {
+                proc = Bun.spawnSync([prettier, '--write', '--log-level', 'silent', tmpFile]);
+            }
+            else {
+                // biome format --write
+                proc = Bun.spawnSync([biome, 'format', '--write', tmpFile], {
+                    stderr: 'pipe',
+                });
+            }
+            if (proc.exitCode !== 0) {
+                logger.debug('AutoHealer: formatter exited non-zero, skipping stage 1');
+                return { healed: false, content };
+            }
+            const formatted = readFileSync(tmpFile, 'utf-8');
+            if (formatted === content) {
+                // Formatter made no changes — errors not formatter-related
+                return { healed: false, content };
+            }
+            // Check if errors appear resolved (heuristic: no syntax errors after format)
+            const resolved = await this._errorsResolved(tmpFile, errors);
+            if (resolved) {
+                logger.debug('AutoHealer: errors resolved by formatter');
+                return { healed: true, content: formatted, method: 'formatter' };
+            }
+            // Formatter ran but errors remain — pass updated content to next stage
+            return { healed: false, content: formatted };
+        }
+        catch (err) {
+            logger.debug('AutoHealer: formatter stage failed (non-fatal)', { error: summarizeError(err) });
+            return { healed: false, content };
+        }
+    }
+    /**
+     * Stage 2: Try linter fix with eslint.
+     */
+    async _tryLinter(tmpFile, content, errors) {
+        try {
+            const eslint = Bun.which('eslint');
+            if (!eslint) {
+                logger.debug('AutoHealer: eslint not found, skipping stage 2');
+                return { healed: false, content };
+            }
+            // Write (possibly formatter-updated) content to temp file
+            writeFileSync(tmpFile, content, 'utf-8');
+            const proc = Bun.spawnSync([eslint, '--fix', tmpFile], {
+                stderr: 'pipe',
+                stdout: 'pipe',
+            });
+            // eslint --fix exits 1 on remaining errors, 0 on clean — both are acceptable
+            const fixed = readFileSync(tmpFile, 'utf-8');
+            if (fixed === content) {
+                return { healed: false, content };
+            }
+            const resolved = await this._errorsResolved(tmpFile, errors);
+            if (resolved) {
+                logger.debug('AutoHealer: errors resolved by linter');
+                return { healed: true, content: fixed, method: 'linter' };
+            }
+            return { healed: false, content: fixed };
+        }
+        catch (err) {
+            logger.debug('AutoHealer: linter stage failed (non-fatal)', { error: summarizeError(err) });
+            return { healed: false, content };
+        }
+    }
+    /**
+     * Stage 3: Try ToolLLM with error context.
+     */
+    async _tryLLM(filePath, content, errors) {
+        try {
+            const errorList = errors.map((e, i) => `${i + 1}. ${e}`).join('\n');
+            const prompt = [
+                `You are a code repair assistant. The following file has validation errors that need to be fixed.`,
+                ``,
+                `File: ${filePath}`,
+                ``,
+                `Errors:`,
+                errorList,
+                ``,
+                `Current content:`,
+                `\`\`\``,
+                content,
+                `\`\`\``,
+                ``,
+                `Return ONLY the corrected file content, no explanation, no markdown fences.`,
+            ].join('\n');
+            const response = await this.toolLLM.chat(prompt, {
+                maxTokens: 4096,
+                systemPrompt: 'You are a code repair tool. Output only the corrected file content with no additional text or markdown.',
+            });
+            if (!response || response.trim() === '') {
+                logger.debug('AutoHealer: LLM returned 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);
+                if (!resolved) {
+                    logger.debug('AutoHealer: LLM response did not resolve errors');
+                    return { healed: false, content };
+                }
+            }
+            finally {
+                try {
+                    if (existsSync(llmTmpFile))
+                        unlinkSync(llmTmpFile);
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+            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) });
+            return { healed: false, content };
+        }
+    }
+    /**
+     * Heuristic check: attempt to parse/validate a temp file to see if errors are resolved.
+     *
+     * 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) {
+        try {
+            const ext = extname(tmpFile).toLowerCase();
+            const isJsTs = ['.js', '.ts', '.jsx', '.tsx', '.mjs', '.cjs'].includes(ext);
+            if (!isJsTs) {
+                // For non-JS/TS: trust the formatter/linter exit code
+                return true;
+            }
+            // For JS/TS: attempt transpile with Bun to catch syntax errors
+            const content = readFileSync(tmpFile, 'utf-8');
+            const loader = (ext === '.mjs' || ext === '.cjs') ? 'js' : ext.slice(1);
+            const transpiler = new Bun.Transpiler({ loader });
+            try {
+                transpiler.transformSync(content);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }
+        catch {
+            // If we can't check, optimistically assume resolved
+            return true;
+        }
+    }
+}

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

@@ -0,0 +1,20 @@
+import { KVState } from '@pellux/goodvibes-sdk/platform/state/kv-state';
+import { ProjectIndex } from '@pellux/goodvibes-sdk/platform/state/project-index';
+import { ModeManager } from '@pellux/goodvibes-sdk/platform/state/mode-manager';
+import { HookDispatcher } from '../../hooks/dispatcher.js';
+import { TelemetryDB } from '@pellux/goodvibes-sdk/platform/state/telemetry';
+import type { Tool } from '@pellux/goodvibes-sdk/platform/types/tools';
+export interface StateToolOptions {
+    readonly memoryDir: string;
+    readonly hookDispatcher?: HookDispatcher;
+    readonly modeManager?: ModeManager;
+    readonly telemetryDB?: TelemetryDB;
+}
+/**
+ * Create the `state` tool bound to the given KVState and ProjectIndex.
+ *
+ * Returns a Tool object conforming to the Tool interface.
+ * Never throws from execute().
+ */
+export declare function createStateTool(kvState: KVState, projectIndex: ProjectIndex, options: StateToolOptions): Tool;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/tools/state/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,oDAAoD,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,mDAAmD,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAG7E,OAAO,KAAK,EAAE,IAAI,EAAkB,MAAM,4CAA4C,CAAC;AAiCvF,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;CACpC;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAmFN"}