@windagency/valora 2.0.1

package/dist/services/document-writer.service.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Document Writer Service
+ *
+ * Handles writing documents to the knowledge-base with
+ * validation, backup, and update capabilities.
+ */
+import type { DocumentCategory, DocumentDefinition, DocumentType, DocumentWriteResult } from '../types/document.types.js';
+import type { DocumentPathResolverService } from './document-path-resolver.service.js';
+export declare class DocumentWriterService {
+    private readonly logger;
+    private readonly pathResolver;
+    constructor(pathResolver: DocumentPathResolverService);
+    /**
+     * Write a document to the knowledge-base
+     */
+    write(document: DocumentDefinition): DocumentWriteResult;
+    /**
+     * Write to a custom path
+     */
+    writeToPath(content: string, customPath: string): DocumentWriteResult;
+    /**
+     * Ensure directory exists, create if needed
+     */
+    private ensureDirectory;
+    /**
+     * Create backup of existing document
+     */
+    private createBackup;
+    /**
+     * Get path resolver for external access
+     */
+    getPathResolver(): DocumentPathResolverService;
+    /**
+     * Check if document exists
+     */
+    exists(type: DocumentType, category: DocumentCategory): boolean;
+    /**
+     * Get existing document content
+     */
+    getExisting(type: DocumentType, category: DocumentCategory): null | string;
+}
+//# sourceMappingURL=document-writer.service.d.ts.map

package/dist/services/document-writer.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-writer.service.d.ts","sourceRoot":"","sources":["../../src/services/document-writer.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAQpH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAEpF,qBAAa,qBAAqB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;gBAE/C,YAAY,EAAE,2BAA2B;IAIrD;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,kBAAkB,GAAG,mBAAmB;IAgExD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB;IAwCrE;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAgBpB;;OAEG;IACH,eAAe,IAAI,2BAA2B;IAI9C;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO;IAI/D;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,MAAM;CAG1E"}

package/dist/services/document-writer.service.js

@@ -0,0 +1,155 @@
+/**
+ * Document Writer Service
+ *
+ * Handles writing documents to the knowledge-base with
+ * validation, backup, and update capabilities.
+ */
+import { copyFileSync, existsSync, mkdirSync, writeFileSync } from 'fs';
+import { getLogger } from '../output/logger.js';
+import { dirname } from 'path';
+import { formatErrorMessage } from '../utils/error-utils.js';
+import { validateNotForbiddenPath } from '../utils/input-validator.js';
+export class DocumentWriterService {
+    logger = getLogger();
+    pathResolver;
+    constructor(pathResolver) {
+        this.pathResolver = pathResolver;
+    }
+    /**
+     * Write a document to the knowledge-base
+     */
+    write(document) {
+        const { category, content, type } = document;
+        this.logger.info('Writing document', {
+            category,
+            type
+        });
+        try {
+            // Validate category for document type
+            if (!this.pathResolver.validateCategory(type, category)) {
+                return {
+                    error: `Category '${category}' is not valid for document type '${type}'`,
+                    isUpdate: false,
+                    path: '',
+                    success: false
+                };
+            }
+            // Resolve path
+            const path = this.pathResolver.resolvePath(type, category);
+            // Validate path is not in forbidden paths (.valora/ folder)
+            validateNotForbiddenPath(path, 'write to');
+            const isUpdate = this.pathResolver.exists(type, category);
+            // Ensure directory exists
+            this.ensureDirectory(dirname(path));
+            // Backup existing file if updating
+            if (isUpdate) {
+                this.createBackup(type, category);
+            }
+            // Write the document
+            writeFileSync(path, content, 'utf-8');
+            this.logger.info('Document written successfully', {
+                isUpdate,
+                path
+            });
+            return {
+                isUpdate,
+                path,
+                success: true
+            };
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            this.logger.error('Failed to write document', new Error(errorMessage), {
+                category,
+                type
+            });
+            return {
+                error: errorMessage,
+                isUpdate: false,
+                path: '',
+                success: false
+            };
+        }
+    }
+    /**
+     * Write to a custom path
+     */
+    writeToPath(content, customPath) {
+        this.logger.info('Writing document to custom path', { customPath });
+        try {
+            // Validate path is not in forbidden paths (.valora/ folder)
+            validateNotForbiddenPath(customPath, 'write to');
+            const isUpdate = existsSync(customPath);
+            // Ensure directory exists
+            this.ensureDirectory(dirname(customPath));
+            // Write the document
+            writeFileSync(customPath, content, 'utf-8');
+            this.logger.info('Document written successfully', {
+                isUpdate,
+                path: customPath
+            });
+            return {
+                isUpdate,
+                path: customPath,
+                success: true
+            };
+        }
+        catch (error) {
+            const errorMessage = formatErrorMessage(error);
+            this.logger.error('Failed to write document', new Error(errorMessage), {
+                customPath
+            });
+            return {
+                error: errorMessage,
+                isUpdate: false,
+                path: '',
+                success: false
+            };
+        }
+    }
+    /**
+     * Ensure directory exists, create if needed
+     */
+    ensureDirectory(dirPath) {
+        if (!existsSync(dirPath)) {
+            mkdirSync(dirPath, { recursive: true });
+        }
+    }
+    /**
+     * Create backup of existing document
+     */
+    createBackup(type, category) {
+        const originalPath = this.pathResolver.resolvePath(type, category);
+        const backupPath = this.pathResolver.getBackupPath(type, category);
+        try {
+            copyFileSync(originalPath, backupPath);
+            this.logger.debug('Created backup', { backupPath, originalPath });
+        }
+        catch (error) {
+            this.logger.warn('Failed to create backup', {
+                error,
+                originalPath
+            });
+            // Continue without backup
+        }
+    }
+    /**
+     * Get path resolver for external access
+     */
+    getPathResolver() {
+        return this.pathResolver;
+    }
+    /**
+     * Check if document exists
+     */
+    exists(type, category) {
+        return this.pathResolver.exists(type, category);
+    }
+    /**
+     * Get existing document content
+     */
+    getExisting(type, category) {
+        return this.pathResolver.getExisting(type, category);
+    }
+}
+//# sourceMappingURL=document-writer.service.js.map

package/dist/services/document-writer.service.js.map

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

package/dist/services/dynamic-agent-resolver.service.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Dynamic Agent Resolver Service
+ *
+ * Main orchestration service for intelligent agent selection.
+ * Coordinates task classification, context analysis, and capability matching
+ * to automatically select the most appropriate agent for a given task.
+ */
+import type { AgentScore, AgentSelection, CodebaseContext, TaskClassification, TaskContext } from '../types/agent.types.js';
+import type { AgentCapabilityMatcherService } from './agent-capability-matcher.service.js';
+import type { AgentCapabilityRegistryService } from './agent-capability-registry.service.js';
+import type { ContextAnalyzerService } from './context-analyzer.service.js';
+import type { TaskClassifierService } from './task-classifier.service.js';
+export declare class DynamicAgentResolverService {
+    private readonly capabilityMatcher;
+    private readonly contextAnalyzer;
+    private readonly HIGH_CONFIDENCE_THRESHOLD;
+    private readonly logger;
+    private readonly MIN_CONFIDENCE_THRESHOLD;
+    private readonly registryService;
+    private readonly taskClassifier;
+    constructor(taskClassifier: TaskClassifierService, contextAnalyzer: ContextAnalyzerService, capabilityMatcher: AgentCapabilityMatcherService, registryService: AgentCapabilityRegistryService);
+    /**
+     * Resolve the best agent for a given task context
+     */
+    resolveAgent(taskContext: TaskContext): Promise<AgentSelection>;
+    /**
+     * Select the optimal agent based on scoring results and business logic
+     */
+    private selectOptimalAgent;
+    /**
+     * Create a standard agent selection result
+     */
+    private createSelection;
+    /**
+     * Create a fallback selection when automatic resolution fails
+     */
+    private createFallbackSelection;
+    /**
+     * Determine the most appropriate fallback agent based on task context
+     */
+    private determineFallbackAgent;
+    /**
+     * Get detailed analysis for debugging or transparency
+     */
+    getDetailedAnalysis(taskContext: TaskContext): Promise<{
+        agentScores: AgentScore[];
+        codebaseContext: CodebaseContext;
+        selection: AgentSelection;
+        taskClassification: TaskClassification;
+    }>;
+    /**
+     * Validate that all required services are properly initialized
+     */
+    validateServices(): Promise<{
+        issues: string[];
+        stats: {
+            analyzerCacheSize: number;
+            classifierCacheSize: number;
+            registryAgents: number;
+            registryDomains: number;
+        };
+        valid: boolean;
+    }>;
+    /**
+     * Clear all caches (useful for development/testing)
+     */
+    clearCaches(): void;
+    /**
+     * Get performance and usage statistics
+     */
+    getStats(): {
+        cacheSizes: {
+            contextAnalyzer: number;
+        };
+        thresholds: {
+            highConfidence: number;
+            minConfidence: number;
+        };
+    };
+}
+//# sourceMappingURL=dynamic-agent-resolver.service.d.ts.map

package/dist/services/dynamic-agent-resolver.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-agent-resolver.service.d.ts","sourceRoot":"","sources":["../../src/services/dynamic-agent-resolver.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKtH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qCAAqC,CAAC;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,qBAAa,2BAA2B;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgC;IAClE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IACzD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAQ;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAO;IAEhD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;IACjE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;gBAGtD,cAAc,EAAE,qBAAqB,EACrC,eAAe,EAAE,sBAAsB,EACvC,iBAAiB,EAAE,6BAA6B,EAChD,eAAe,EAAE,8BAA8B;IAQhD;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAoDrE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgD1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAiC/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiD9B;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;QAC5D,WAAW,EAAE,UAAU,EAAE,CAAC;QAC1B,eAAe,EAAE,eAAe,CAAC;QACjC,SAAS,EAAE,cAAc,CAAC;QAC1B,kBAAkB,EAAE,kBAAkB,CAAC;KACvC,CAAC;IAcF;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC;QACjC,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,KAAK,EAAE;YACN,iBAAiB,EAAE,MAAM,CAAC;YAC1B,mBAAmB,EAAE,MAAM,CAAC;YAC5B,cAAc,EAAE,MAAM,CAAC;YACvB,eAAe,EAAE,MAAM,CAAC;SACxB,CAAC;QACF,KAAK,EAAE,OAAO,CAAC;KACf,CAAC;IAwBF;;OAEG;IACH,WAAW,IAAI,IAAI;IAQnB;;OAEG;IACH,QAAQ,IAAI;QACX,UAAU,EAAE;YACX,eAAe,EAAE,MAAM,CAAC;SACxB,CAAC;QACF,UAAU,EAAE;YACX,cAAc,EAAE,MAAM,CAAC;YACvB,aAAa,EAAE,MAAM,CAAC;SACtB,CAAC;KACF;CAWD"}

package/dist/services/dynamic-agent-resolver.service.js

@@ -0,0 +1,267 @@
+/**
+ * Dynamic Agent Resolver Service
+ *
+ * Main orchestration service for intelligent agent selection.
+ * Coordinates task classification, context analysis, and capability matching
+ * to automatically select the most appropriate agent for a given task.
+ */
+import { getLogger } from '../output/logger.js';
+import { formatErrorMessage } from '../utils/error-utils.js';
+export class DynamicAgentResolverService {
+    capabilityMatcher;
+    contextAnalyzer;
+    HIGH_CONFIDENCE_THRESHOLD = 0.75;
+    logger = getLogger();
+    MIN_CONFIDENCE_THRESHOLD = 0.3;
+    registryService;
+    taskClassifier;
+    constructor(taskClassifier, contextAnalyzer, capabilityMatcher, registryService) {
+        this.taskClassifier = taskClassifier;
+        this.contextAnalyzer = contextAnalyzer;
+        this.capabilityMatcher = capabilityMatcher;
+        this.registryService = registryService;
+    }
+    /**
+     * Resolve the best agent for a given task context
+     */
+    async resolveAgent(taskContext) {
+        this.logger.info('Starting dynamic agent resolution', {
+            affectedFiles: taskContext.affectedFiles?.length ?? 0,
+            complexity: taskContext.complexity,
+            description: taskContext.description ? taskContext.description.substring(0, 50) + '...' : 'No description'
+        });
+        try {
+            // Ensure registry is initialized
+            await this.registryService.initialize();
+            // Step 1: Classify the task
+            const taskClassification = this.taskClassifier.classifyTask(taskContext);
+            this.logger.debug('Task classification complete', {
+                confidence: taskClassification.confidence,
+                primaryDomain: taskClassification.primaryDomain,
+                suggestedAgents: taskClassification.suggestedAgents.length
+            });
+            // Step 2: Analyze codebase context
+            const codebaseContext = await this.contextAnalyzer.analyzeTaskContext(taskContext);
+            this.logger.debug('Context analysis complete', {
+                fileTypes: codebaseContext.affectedFileTypes.length,
+                importPatterns: codebaseContext.importPatterns.length,
+                technologyStack: codebaseContext.technologyStack.length
+            });
+            // Step 3: Score agents based on classification and context
+            const agentScores = this.capabilityMatcher.scoreAgents(taskClassification, codebaseContext);
+            // Step 4: Select optimal agent with fallback logic
+            const selection = this.selectOptimalAgent(agentScores, taskContext);
+            this.logger.info('Agent resolution complete', {
+                alternatives: selection.alternatives.length,
+                confidence: selection.confidence,
+                fallbackAgent: selection.fallbackAgent,
+                selectedAgent: selection.selectedAgent
+            });
+            return selection;
+        }
+        catch (error) {
+            this.logger.error('Agent resolution failed', error);
+            this.logger.debug('Failed task context', {
+                taskDescription: taskContext.description ? taskContext.description.substring(0, 100) : 'No description'
+            });
+            // Return safe fallback selection
+            return this.createFallbackSelection(taskContext);
+        }
+    }
+    /**
+     * Select the optimal agent based on scoring results and business logic
+     */
+    selectOptimalAgent(agentScores, taskContext) {
+        if (agentScores.length === 0) {
+            this.logger.warn('No agent scores available, using fallback');
+            const fallbackSelection = this.createFallbackSelection(taskContext);
+            fallbackSelection.reasons.push('No agent scores available');
+            return fallbackSelection;
+        }
+        const topAgent = agentScores[0];
+        if (!topAgent) {
+            throw new Error('No agents available for task');
+        }
+        // Check confidence thresholds
+        if (topAgent.score >= this.HIGH_CONFIDENCE_THRESHOLD) {
+            // High confidence - use top agent directly
+            return this.createSelection(topAgent, agentScores.slice(1, 4), taskContext);
+        }
+        if (topAgent.score >= this.MIN_CONFIDENCE_THRESHOLD) {
+            // Medium confidence - check if we have a clear winner
+            const secondBest = agentScores[1];
+            const confidenceGap = topAgent.score - (secondBest?.score ?? 0);
+            if (confidenceGap >= 0.2) {
+                // Clear winner
+                return this.createSelection(topAgent, agentScores.slice(1, 4), taskContext);
+            }
+            else {
+                // Close contest - consider escalation or fallback
+                this.logger.warn('Close agent scoring contest, considering escalation', {
+                    gap: confidenceGap,
+                    secondScore: secondBest?.score,
+                    topScore: topAgent.score
+                });
+            }
+        }
+        // Low confidence - use fallback logic
+        this.logger.warn('Low confidence in agent selection, using fallback', {
+            threshold: this.MIN_CONFIDENCE_THRESHOLD,
+            topScore: topAgent.score
+        });
+        const fallbackSelection = this.createFallbackSelection(taskContext, topAgent);
+        fallbackSelection.reasons.push('Low confidence in agent selection');
+        return fallbackSelection;
+    }
+    /**
+     * Create a standard agent selection result
+     */
+    createSelection(bestAgent, alternatives, taskContext) {
+        const alternativeResults = alternatives.map((alt) => ({
+            agent: alt.role,
+            reasons: alt.reasons,
+            score: alt.score
+        }));
+        return {
+            alternatives: alternativeResults,
+            confidence: bestAgent.score,
+            fallback: false,
+            fallbackAgent: this.determineFallbackAgent(taskContext),
+            reasons: bestAgent.reasons,
+            selectedAgent: bestAgent.role
+        };
+    }
+    /**
+     * Create a fallback selection when automatic resolution fails
+     */
+    createFallbackSelection(taskContext, preferredAgent) {
+        // Determine fallback based on task context
+        const fallbackAgent = this.determineFallbackAgent(taskContext);
+        // If we have a preferred agent, include it as the selection but mark low confidence
+        if (preferredAgent) {
+            return {
+                alternatives: [],
+                confidence: Math.min(preferredAgent.score, 0.4),
+                fallback: true,
+                fallbackAgent,
+                // Cap at 0.4 for fallbacks
+                reasons: [...preferredAgent.reasons, 'Low confidence - using as fallback selection'],
+                selectedAgent: preferredAgent.role
+            };
+        }
+        // Pure fallback selection
+        return {
+            alternatives: [],
+            confidence: 0.1,
+            fallback: true,
+            fallbackAgent,
+            // Very low confidence for pure fallbacks
+            reasons: [
+                'Automatic agent selection failed',
+                `Using fallback agent: ${fallbackAgent}`,
+                'Consider providing explicit agent parameter for better results'
+            ],
+            selectedAgent: fallbackAgent
+        };
+    }
+    /**
+     * Determine the most appropriate fallback agent based on task context
+     */
+    determineFallbackAgent(taskContext) {
+        // Simple heuristic-based fallback selection
+        const affectedFiles = taskContext.affectedFiles ?? [];
+        const hasFrontendFiles = affectedFiles.some((file) => file.includes('frontend') ||
+            file.includes('ui') ||
+            file.includes('component') ||
+            file.endsWith('.tsx') ||
+            file.endsWith('.jsx'));
+        const hasBackendFiles = affectedFiles.some((file) => file.includes('backend') ||
+            file.includes('api') ||
+            file.includes('server') ||
+            file.includes('database') ||
+            (file.endsWith('.ts') && !file.endsWith('.tsx')));
+        const hasInfrastructureFiles = affectedFiles.some((file) => file.includes('infrastructure') ||
+            file.includes('terraform') ||
+            file.includes('docker') ||
+            file.includes('kubernetes') ||
+            file.endsWith('.tf') ||
+            file.endsWith('.yaml') ||
+            file.endsWith('.yml'));
+        // Priority order for fallbacks
+        if (hasInfrastructureFiles) {
+            return 'platform-engineer';
+        }
+        if (hasFrontendFiles) {
+            return 'software-engineer-typescript-frontend-react';
+        }
+        if (hasBackendFiles) {
+            return 'software-engineer-typescript-backend';
+        }
+        // Default fallback
+        return 'software-engineer-typescript';
+    }
+    /**
+     * Get detailed analysis for debugging or transparency
+     */
+    async getDetailedAnalysis(taskContext) {
+        const taskClassification = this.taskClassifier.classifyTask(taskContext);
+        const codebaseContext = await this.contextAnalyzer.analyzeTaskContext(taskContext);
+        const agentScores = this.capabilityMatcher.scoreAgents(taskClassification, codebaseContext);
+        const selection = await this.resolveAgent(taskContext);
+        return {
+            agentScores,
+            codebaseContext,
+            selection,
+            taskClassification
+        };
+    }
+    /**
+     * Validate that all required services are properly initialized
+     */
+    async validateServices() {
+        const issues = [];
+        try {
+            await this.registryService.initialize();
+        }
+        catch (error) {
+            issues.push(`Registry initialization failed: ${error.message}`);
+        }
+        const registryStats = this.registryService.getStats();
+        return {
+            issues,
+            stats: {
+                // Would need to expose from TaskClassifierService
+                analyzerCacheSize: this.contextAnalyzer.getCacheSize(),
+                classifierCacheSize: 0,
+                registryAgents: registryStats.totalAgents,
+                registryDomains: registryStats.totalDomains
+            },
+            valid: issues.length === 0
+        };
+    }
+    /**
+     * Clear all caches (useful for development/testing)
+     */
+    clearCaches() {
+        this.contextAnalyzer.clearCache();
+        this.registryService.reload().catch((error) => {
+            this.logger.warn('Failed to reload registry during cache clear', { error: formatErrorMessage(error) });
+        });
+        this.logger.debug('All dynamic agent resolver caches cleared');
+    }
+    /**
+     * Get performance and usage statistics
+     */
+    getStats() {
+        return {
+            cacheSizes: {
+                contextAnalyzer: this.contextAnalyzer.getCacheSize()
+            },
+            thresholds: {
+                highConfidence: this.HIGH_CONFIDENCE_THRESHOLD,
+                minConfidence: this.MIN_CONFIDENCE_THRESHOLD
+            }
+        };
+    }
+}
+//# sourceMappingURL=dynamic-agent-resolver.service.js.map

package/dist/services/dynamic-agent-resolver.service.js.map

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

package/dist/services/git-stash-protection.service.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Git Stash Protection Service
+ *
+ * Provides automatic stash/unstash functionality to protect uncommitted changes
+ * during command execution that may inadvertently modify git state.
+ */
+export interface GitStatus {
+    hasStagedChanges: boolean;
+    hasUncommittedChanges: boolean;
+    hasUnstagedChanges: boolean;
+    hasUntrackedFiles: boolean;
+}
+export interface StashProtectionResult {
+    error?: string;
+    stashCreated: boolean;
+    stashName?: string;
+}
+export interface UnstashResult {
+    error?: string;
+    restored: boolean;
+}
+/**
+ * Function type for confirming stash creation with the user
+ * Returns true if user confirms, false otherwise
+ */
+export type ConfirmStashFn = (message: string) => Promise<boolean>;
+/**
+ * Service to protect git working tree changes during command execution
+ */
+export declare class GitStashProtectionService {
+    private readonly confirmFn?;
+    private readonly logger;
+    private stashCreated;
+    private stashName;
+    /**
+     * Create a new GitStashProtectionService
+     *
+     * @param confirmFn - Optional function to prompt user for confirmation.
+     *                    If not provided, interactive prompts will auto-confirm.
+     */
+    constructor(confirmFn?: ConfirmStashFn);
+    /**
+     * Check if there are uncommitted changes in the working tree
+     */
+    checkGitStatus(): Promise<GitStatus>;
+    /**
+     * 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
+     */
+    promptAndStash(interactive?: boolean): Promise<StashProtectionResult>;
+    /**
+     * Create a stash with a recognisable message
+     */
+    createStash(): Promise<StashProtectionResult>;
+    /**
+     * Restore stashed changes after command execution
+     */
+    restoreStash(): Promise<UnstashResult>;
+    /**
+     * Check if a stash was created during this session
+     */
+    hasActiveStash(): boolean;
+    /**
+     * Get the name of the created stash
+     */
+    getStashName(): string | undefined;
+}
+export declare function getGitStashProtection(): GitStashProtectionService;
+/**
+ * Create a new instance with optional confirm function
+ * @param confirmFn - Function to prompt user for stash confirmation
+ */
+export declare function createGitStashProtection(confirmFn?: ConfirmStashFn): GitStashProtectionService;
+//# sourceMappingURL=git-stash-protection.service.d.ts.map

package/dist/services/git-stash-protection.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-stash-protection.service.d.ts","sourceRoot":"","sources":["../../src/services/git-stash-protection.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,SAAS;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAInE;;GAEG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAqB;IAEtC;;;;;OAKG;gBACS,SAAS,CAAC,EAAE,cAAc;IAItC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,SAAS,CAAC;IAkD1C;;;;;OAKG;IACG,cAAc,CAAC,WAAW,GAAE,OAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA2BjF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,qBAAqB,CAAC;IA2BnD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC;IAsC5C;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;CAGlC;AAKD,wBAAgB,qBAAqB,IAAI,yBAAyB,CAGjE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,yBAAyB,CAE9F"}