@windagency/valora 2.0.1

package/dist/services/git-stash-protection.service.js

@@ -0,0 +1,190 @@
+/**
+ * Git Stash Protection Service
+ *
+ * Provides automatic stash/unstash functionality to protect uncommitted changes
+ * during command execution that may inadvertently modify git state.
+ */
+import { exec } from 'child_process';
+import { getLogger } from '../output/logger.js';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+const STASH_MESSAGE_PREFIX = 'ai-feedback-auto-stash';
+/**
+ * Service to protect git working tree changes during command execution
+ */
+export class GitStashProtectionService {
+    confirmFn;
+    logger = getLogger();
+    stashCreated = false;
+    stashName;
+    /**
+     * Create a new GitStashProtectionService
+     *
+     * @param confirmFn - Optional function to prompt user for confirmation.
+     *                    If not provided, interactive prompts will auto-confirm.
+     */
+    constructor(confirmFn) {
+        this.confirmFn = confirmFn;
+    }
+    /**
+     * Check if there are uncommitted changes in the working tree
+     */
+    async checkGitStatus() {
+        try {
+            const { stdout } = await execAsync('git status --porcelain', {
+                cwd: process.cwd()
+            });
+            const lines = stdout.trim().split('\n').filter(Boolean);
+            // Parse git status porcelain output
+            let hasStagedChanges = false;
+            let hasUnstagedChanges = false;
+            let hasUntrackedFiles = false;
+            for (const line of lines) {
+                const indexStatus = line[0];
+                const worktreeStatus = line[1];
+                // Staged changes (first column is not space or ?)
+                if (indexStatus && indexStatus !== ' ' && indexStatus !== '?') {
+                    hasStagedChanges = true;
+                }
+                // Unstaged changes (second column is not space)
+                if (worktreeStatus && worktreeStatus !== ' ') {
+                    hasUnstagedChanges = true;
+                }
+                // Untracked files
+                if (indexStatus === '?') {
+                    hasUntrackedFiles = true;
+                }
+            }
+            return {
+                hasStagedChanges,
+                hasUncommittedChanges: hasStagedChanges || hasUnstagedChanges,
+                hasUnstagedChanges,
+                hasUntrackedFiles
+            };
+        }
+        catch (error) {
+            this.logger.warn('Failed to check git status', { error: error.message });
+            return {
+                hasStagedChanges: false,
+                hasUncommittedChanges: false,
+                hasUnstagedChanges: false,
+                hasUntrackedFiles: false
+            };
+        }
+    }
+    /**
+     * Prompt user to stash changes before command execution
+     *
+     * @param interactive - Whether to prompt the user or auto-stash
+     * @returns Result indicating if stash was created
+     */
+    async promptAndStash(interactive = true) {
+        const status = await this.checkGitStatus();
+        if (!status.hasUncommittedChanges) {
+            this.logger.debug('No uncommitted changes, skipping stash');
+            return { stashCreated: false };
+        }
+        // Build status message
+        const changeTypes = [];
+        if (status.hasStagedChanges)
+            changeTypes.push('staged');
+        if (status.hasUnstagedChanges)
+            changeTypes.push('unstaged');
+        const changeDescription = changeTypes.join(' and ') + ' changes';
+        if (interactive && this.confirmFn) {
+            const message = `Uncommitted ${changeDescription} detected. Stash them to prevent accidental modification?`;
+            const shouldStash = await this.confirmFn(message);
+            if (!shouldStash) {
+                this.logger.info('User declined stash protection');
+                return { stashCreated: false };
+            }
+        }
+        return this.createStash();
+    }
+    /**
+     * Create a stash with a recognisable message
+     */
+    async createStash() {
+        try {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            this.stashName = `${STASH_MESSAGE_PREFIX}-${timestamp}`;
+            // Stash all changes including untracked files
+            await execAsync(`git stash push -u -m "${this.stashName}"`, {
+                cwd: process.cwd()
+            });
+            this.stashCreated = true;
+            this.logger.info(`Changes stashed: ${this.stashName}`);
+            return {
+                stashCreated: true,
+                stashName: this.stashName
+            };
+        }
+        catch (error) {
+            const err = error;
+            this.logger.error('Failed to create stash', err);
+            return {
+                error: err.message,
+                stashCreated: false
+            };
+        }
+    }
+    /**
+     * Restore stashed changes after command execution
+     */
+    async restoreStash() {
+        if (!this.stashCreated) {
+            this.logger.debug('No stash was created, skipping restore');
+            return { restored: false };
+        }
+        try {
+            // Pop the stash to restore changes
+            await execAsync('git stash pop', {
+                cwd: process.cwd()
+            });
+            this.stashCreated = false;
+            this.logger.info(`Changes restored from stash: ${this.stashName}`);
+            return { restored: true };
+        }
+        catch (error) {
+            const err = error;
+            this.logger.error('Failed to restore stash', err);
+            // Try to provide helpful guidance
+            if (err.message.includes('CONFLICT') || err.message.includes('conflict')) {
+                this.logger.warn('Stash restore had conflicts. Your changes are still in the stash. ' +
+                    'Run "git stash show" to see what was stashed and "git stash pop" to try again.');
+            }
+            return {
+                error: `Failed to restore stash: ${err.message}. ` +
+                    `Your changes are saved in stash "${this.stashName}". ` +
+                    'Run "git stash list" to see stashes and "git stash pop" to restore manually.',
+                restored: false
+            };
+        }
+    }
+    /**
+     * Check if a stash was created during this session
+     */
+    hasActiveStash() {
+        return this.stashCreated;
+    }
+    /**
+     * Get the name of the created stash
+     */
+    getStashName() {
+        return this.stashName;
+    }
+}
+// Singleton instance for use across the application
+let stashProtectionInstance;
+export function getGitStashProtection() {
+    stashProtectionInstance ??= new GitStashProtectionService();
+    return stashProtectionInstance;
+}
+/**
+ * Create a new instance with optional confirm function
+ * @param confirmFn - Function to prompt user for stash confirmation
+ */
+export function createGitStashProtection(confirmFn) {
+    return new GitStashProtectionService(confirmFn);
+}
+//# sourceMappingURL=git-stash-protection.service.js.map

package/dist/services/git-stash-protection.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-stash-protection.service.js","sourceRoot":"","sources":["../../src/services/git-stash-protection.service.ts"],"names":[],"mappings":"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"}

package/dist/services/idempotency-store.service.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Idempotency Store Service
+ *
+ * Provides idempotency key validation and result caching for tool execution.
+ * Ensures that duplicate tool calls with the same parameters return cached results
+ * instead of re-executing, preventing unintended side effects.
+ *
+ */
+import type { LLMToolCall } from '../types/llm.types.js';
+import { type IdempotencyCheckResult, type IdempotencyOptions, type IdempotencyResult, type IdempotencyStoreConfig } from '../types/idempotency.types.js';
+export declare class IdempotencyStoreService {
+    private cleanupTimer;
+    private readonly config;
+    private readonly lockerId;
+    private readonly lockManager;
+    private recordCount;
+    constructor(config?: Partial<IdempotencyStoreConfig>);
+    /**
+     * Generate an idempotency key from a tool call
+     * The key is a hash of the tool name and sorted arguments
+     */
+    generateKey(toolCall: LLMToolCall, sessionId?: string): string;
+    /**
+     * Generate a hash of the arguments for verification
+     */
+    private generateArgsHash;
+    /**
+     * Check if a tool call has a cached result
+     * Returns the cached result if found and not expired
+     */
+    check(toolCall: LLMToolCall, options?: IdempotencyOptions): Promise<IdempotencyCheckResult>;
+    /**
+     * Store a result for an idempotency key
+     */
+    store(toolCall: LLMToolCall, result: IdempotencyResult, options?: IdempotencyOptions): Promise<void>;
+    /**
+     * Delete an idempotency record
+     */
+    delete(key: string): void;
+    /**
+     * Invalidate all records for a specific tool
+     */
+    invalidateTool(toolName: string): number;
+    /**
+     * Invalidate all records for a session
+     */
+    invalidateSession(sessionId: string): Promise<number>;
+    /**
+     * Clean up expired records
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Clean up a single expired record
+     */
+    private cleanupExpiredRecord;
+    /**
+     * Update the record count from the store directory
+     */
+    private updateRecordCount;
+    /**
+     * Clear all idempotency records
+     */
+    clear(): number;
+    /**
+     * Get store statistics
+     */
+    getStats(): {
+        max_records: number;
+        record_count: number;
+        store_dir: string;
+    };
+    /**
+     * Stop the cleanup timer (for graceful shutdown)
+     */
+    stop(): void;
+    /**
+     * Ensure the store directory exists
+     */
+    private ensureStoreDirectory;
+    /**
+     * Start the periodic cleanup timer
+     */
+    private startCleanupTimer;
+    /**
+     * Get the file path for a record
+     */
+    private getRecordPath;
+    /**
+     * Sort an object's keys recursively for consistent hashing
+     */
+    private sortObject;
+}
+/**
+ * Get the global idempotency store instance
+ */
+export declare function getIdempotencyStore(config?: Partial<IdempotencyStoreConfig>): IdempotencyStoreService;
+/**
+ * Reset the singleton (for testing)
+ */
+export declare function resetIdempotencyStore(): void;
+//# sourceMappingURL=idempotency-store.service.d.ts.map

package/dist/services/idempotency-store.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency-store.service.d.ts","sourceRoot":"","sources":["../../src/services/idempotency-store.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMnD,OAAO,EACN,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EAEvB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAE3B,MAAM,yBAAyB,CAAC;AAiBjC,qBAAa,uBAAuB;IACnC,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,WAAW,CAAK;gBAEZ,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAMpD;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAY9D;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA4DjG;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD1G;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAiBzB;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAyBxC;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoC3D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA+BhC;;OAEG;YACW,oBAAoB;IAmBlC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,KAAK,IAAI,MAAM;IA4Bf;;OAEG;IACH,QAAQ,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAQ5E;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,UAAU;CAoBlB;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,uBAAuB,CAKrG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAK5C"}