@windagency/valora 2.0.1

package/dist/services/task-classifier.service.js

@@ -0,0 +1,211 @@
+/**
+ * Task Classifier Service
+ *
+ * Analyses task descriptions and classifies implementation requirements
+ * to determine the appropriate agent specialisation.
+ */
+import { getLogger } from '../output/logger.js';
+import { getDomainKeywordRegistry } from '../utils/domain-keyword-registry.js';
+export class TaskClassifierService {
+    keywordRegistry;
+    logger = getLogger();
+    constructor(keywordRegistry) {
+        this.keywordRegistry = keywordRegistry ?? getDomainKeywordRegistry();
+    }
+    /**
+     * Classify a task based on its description and context
+     */
+    classifyTask(taskContext) {
+        // Normalise potentially null inputs
+        const description = taskContext.description ?? '';
+        const affectedFiles = taskContext.affectedFiles ?? [];
+        const dependencies = taskContext.dependencies ?? [];
+        const normalisedContext = {
+            ...taskContext,
+            affectedFiles,
+            dependencies,
+            description
+        };
+        this.logger.debug('Classifying task', {
+            affectedFiles: affectedFiles.length,
+            complexity: taskContext.complexity,
+            description: description.substring(0, 100) + '...'
+        });
+        // Extract keywords and patterns from task description
+        const keywords = this.extractKeywords(description);
+        const patterns = this.identifyPatterns(keywords);
+        // Determine primary domain based on analysis
+        const { confidence, primaryDomain, reasons } = this.determinePrimaryDomain(patterns, normalisedContext);
+        // Calculate complexity if not provided
+        const complexity = taskContext.complexity ?? this.calculateComplexity(normalisedContext, patterns);
+        // Suggest appropriate agents based on domain
+        const suggestedAgents = this.getSuggestedAgents(primaryDomain, normalisedContext);
+        return {
+            complexity,
+            confidence,
+            primaryDomain,
+            reasons,
+            suggestedAgents
+        };
+    }
+    /**
+     * Extract keywords from task description
+     */
+    extractKeywords(description) {
+        const text = description.toLowerCase();
+        const allKeywords = this.keywordRegistry.getAllKeywords();
+        // Check each domain's keywords using functional pattern
+        const extracted = Object.values(allKeywords).flatMap((domainKeywords) => domainKeywords.filter((keyword) => text.includes(keyword)));
+        return [...new Set(extracted)]; // Remove duplicates
+    }
+    /**
+     * Identify patterns from extracted keywords
+     */
+    identifyPatterns(keywords) {
+        const patterns = new Map();
+        const allKeywords = this.keywordRegistry.getAllKeywords();
+        // Count matches for each domain using registry keywords
+        Object.entries(allKeywords).forEach(([domain, domainKeywords]) => {
+            const count = keywords.filter((keyword) => domainKeywords.includes(keyword)).length;
+            if (count > 0) {
+                patterns.set(domain, count);
+            }
+        });
+        return patterns;
+    }
+    /**
+     * Determine primary domain based on patterns and context
+     */
+    determinePrimaryDomain(patterns, taskContext) {
+        // If primary domain is explicitly provided, use it with high confidence
+        if (taskContext.primaryDomain) {
+            return {
+                confidence: 0.95,
+                primaryDomain: taskContext.primaryDomain,
+                reasons: [`Primary domain explicitly set to ${taskContext.primaryDomain}`]
+            };
+        }
+        const fileBasedDomains = this.detectDomainFromFiles(taskContext.affectedFiles);
+        // Combine pattern scores with file-based detection
+        const combinedScores = new Map();
+        // Add pattern-based scores using forEach
+        Array.from(patterns.entries()).forEach(([domain, count]) => {
+            const score = Math.min(count / 5, 1) * 0.6; // Max 60% from patterns
+            combinedScores.set(domain, {
+                reasons: [`Found ${count} domain-specific keywords`],
+                score
+            });
+        });
+        // Add file-based scores using forEach
+        Array.from(fileBasedDomains.entries()).forEach(([domain, fileScore]) => {
+            const existing = combinedScores.get(domain) ?? { reasons: [], score: 0 };
+            const newScore = existing.score + fileScore.score * 0.4; // Max 40% from files
+            combinedScores.set(domain, {
+                reasons: [...existing.reasons, ...fileScore.reasons],
+                score: Math.min(newScore, 1)
+            });
+        });
+        // Find domain with highest score using functional pattern
+        const best = Array.from(combinedScores.entries()).reduce((acc, [domain, data]) => (data.score > acc.score ? { domain, reasons: data.reasons, score: data.score } : acc), { domain: 'typescript-core', reasons: ['Default fallback'], score: 0 });
+        const { domain: bestDomain, reasons: bestReasons, score: bestScore } = best;
+        // Apply minimum confidence threshold
+        const confidence = Math.max(bestScore, 0.3);
+        return {
+            confidence,
+            primaryDomain: bestDomain,
+            reasons: bestReasons
+        };
+    }
+    /**
+     * Detect domain from affected files
+     */
+    detectDomainFromFiles(affectedFiles) {
+        const domainScores = new Map();
+        const filePatterns = {
+            infrastructure: {
+                patterns: ['.tf', '.yaml', '.yml', 'dockerfile', 'Dockerfile', '.sh', '.bash'],
+                weight: 1.0
+            },
+            security: {
+                patterns: ['security', 'auth', 'jwt', 'oauth', 'encryption', 'ssl', 'tls'],
+                weight: 0.8
+            },
+            'typescript-backend-general': {
+                patterns: ['.ts', '.js', 'api', 'server', 'backend', 'database', 'sql'],
+                weight: 0.7
+            },
+            'typescript-core': {
+                patterns: ['.ts', '.js', 'config', 'build', 'package.json', 'tsconfig.json'],
+                weight: 0.5
+            },
+            'typescript-frontend-general': {
+                patterns: ['.tsx', '.jsx', '.html', '.css', 'frontend', 'ui'],
+                weight: 0.6
+            },
+            'typescript-frontend-react': {
+                patterns: ['.tsx', '.jsx', 'react', 'component', 'hook', 'state'],
+                weight: 0.9
+            },
+            'ui-ux-designer': {
+                patterns: ['.fig', '.sketch', '.xd', 'design', 'mockup', 'wireframe'],
+                weight: 0.8
+            }
+        };
+        // Process file patterns using functional approach
+        affectedFiles.forEach((file) => {
+            const fileName = file.toLowerCase();
+            Object.entries(filePatterns).forEach(([domain, config]) => {
+                const matchedPattern = config.patterns.find((pattern) => fileName.includes(pattern));
+                if (matchedPattern) {
+                    const existing = domainScores.get(domain) ?? { reasons: [], score: 0 };
+                    domainScores.set(domain, {
+                        reasons: [...existing.reasons, `File ${file} matches ${domain} pattern`],
+                        score: Math.min(existing.score + config.weight, 1)
+                    });
+                }
+            });
+        });
+        return domainScores;
+    }
+    /**
+     * Calculate task complexity
+     */
+    calculateComplexity(taskContext, patterns) {
+        let complexityScore = 0;
+        // Factor in number of affected files
+        complexityScore += Math.min(taskContext.affectedFiles.length / 10, 1) * 0.3;
+        // Factor in number of domains involved
+        complexityScore += Math.min(patterns.size / 3, 1) * 0.3;
+        // Factor in description length (longer = more complex)
+        complexityScore += Math.min(taskContext.description.length / 1000, 1) * 0.2;
+        // Factor in dependencies count
+        complexityScore += Math.min(taskContext.dependencies.length / 5, 1) * 0.2;
+        if (complexityScore < 0.3)
+            return 'low';
+        if (complexityScore < 0.7)
+            return 'medium';
+        return 'high';
+    }
+    /**
+     * Get suggested agents for a domain
+     */
+    getSuggestedAgents(domain, taskContext) {
+        const agentMappings = {
+            infrastructure: ['platform-engineer'],
+            security: ['secops-engineer'],
+            'typescript-backend-general': ['software-engineer-typescript-backend'],
+            'typescript-core': ['software-engineer-typescript'],
+            'typescript-frontend-general': ['software-engineer-typescript-frontend'],
+            'typescript-frontend-react': ['software-engineer-typescript-frontend-react'],
+            'ui-ux-designer': ['ui-ux-designer']
+        };
+        // Add lead for high complexity or multi-domain tasks
+        const suggestedAgents = [...(agentMappings[domain] || ['software-engineer-typescript'])];
+        if (taskContext.complexity === 'high' ||
+            (taskContext.secondaryDomains && taskContext.secondaryDomains.length > 0)) {
+            suggestedAgents.unshift('lead'); // Lead first for complex tasks
+        }
+        return suggestedAgents;
+    }
+}
+//# sourceMappingURL=task-classifier.service.js.map

package/dist/services/task-classifier.service.js.map

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

package/dist/session/archive-adapter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ZIP Archive Adapter Implementation
+ *
+ * Wraps 'archiver' and 'unzipper' libraries to provide a clean interface
+ * for archive operations, isolating the application from direct dependencies.
+ *
+ */
+import type { ArchiveAdapter, ArchiveEntry, ArchiveResult, CreateArchiveOptions } from './archive-adapter.interface.js';
+/**
+ * ZIP archive adapter using archiver/unzipper libraries
+ */
+export declare class ZipArchiveAdapter implements ArchiveAdapter {
+    /**
+     * Create a ZIP archive from entries
+     */
+    createArchive(outputPath: string, entries: ArchiveEntry[], options?: CreateArchiveOptions): Promise<ArchiveResult>;
+    /**
+     * Extract a ZIP archive to a directory
+     */
+    extractArchive(archivePath: string, targetDir: string): Promise<void>;
+}
+/**
+ * Create a new ZIP archive adapter instance
+ */
+export declare function createArchiveAdapter(): ArchiveAdapter;
+//# sourceMappingURL=archive-adapter.d.ts.map

package/dist/session/archive-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-adapter.d.ts","sourceRoot":"","sources":["../../src/session/archive-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAOrH;;GAEG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IACvD;;OAEG;IACG,aAAa,CAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,GAAE,oBAAyB,GAChC,OAAO,CAAC,aAAa,CAAC;IAsCzB;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAY3E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/session/archive-adapter.interface.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Archive Adapter Interface
+ *
+ * Abstracts archive operations (ZIP creation/extraction) to:
+ * - Enable easier testing with mock implementations
+ * - Allow library replacement without changing business logic
+ * - Isolate third-party library breaking changes
+ *
+ */
+/**
+ * Entry to add to an archive
+ */
+export interface ArchiveEntry {
+    /** Content as string or Buffer */
+    content: Buffer | string;
+    /** Name/path within the archive */
+    name: string;
+}
+/**
+ * Result of archive creation
+ */
+export interface ArchiveResult {
+    /** Path to the created archive */
+    outputPath: string;
+    /** Size of the archive in bytes */
+    size: number;
+}
+/**
+ * Options for archive creation
+ */
+export interface CreateArchiveOptions {
+    /** Compression level (0-9, where 9 is maximum compression) */
+    compressionLevel?: number;
+}
+/**
+ * Archive adapter interface for ZIP operations
+ *
+ * Wraps archive libraries (archiver, unzipper) to isolate the application
+ * from direct third-party library dependencies.
+ */
+export interface ArchiveAdapter {
+    /**
+     * Create a ZIP archive from entries
+     *
+     * @param outputPath - Path where the archive will be written
+     * @param entries - Array of entries to add to the archive
+     * @param options - Optional archive creation options
+     * @returns Archive result with path and size
+     */
+    createArchive(outputPath: string, entries: ArchiveEntry[], options?: CreateArchiveOptions): Promise<ArchiveResult>;
+    /**
+     * Extract a ZIP archive to a directory
+     *
+     * @param archivePath - Path to the archive file
+     * @param targetDir - Directory where contents will be extracted
+     */
+    extractArchive(archivePath: string, targetDir: string): Promise<void>;
+}
+//# sourceMappingURL=archive-adapter.interface.d.ts.map

package/dist/session/archive-adapter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-adapter.interface.d.ts","sourceRoot":"","sources":["../../src/session/archive-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,kCAAkC;IAClC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B;;;;;;;OAOG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEnH;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE"}

package/dist/session/archive-adapter.interface.js

@@ -0,0 +1,11 @@
+/**
+ * Archive Adapter Interface
+ *
+ * Abstracts archive operations (ZIP creation/extraction) to:
+ * - Enable easier testing with mock implementations
+ * - Allow library replacement without changing business logic
+ * - Isolate third-party library breaking changes
+ *
+ */
+export {};
+//# sourceMappingURL=archive-adapter.interface.js.map

package/dist/session/archive-adapter.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-adapter.interface.js","sourceRoot":"","sources":["../../src/session/archive-adapter.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/session/archive-adapter.js

@@ -0,0 +1,72 @@
+/**
+ * ZIP Archive Adapter Implementation
+ *
+ * Wraps 'archiver' and 'unzipper' libraries to provide a clean interface
+ * for archive operations, isolating the application from direct dependencies.
+ *
+ */
+import archiver from 'archiver';
+import * as fs from 'fs';
+import unzipper from 'unzipper';
+/**
+ * Default compression level for ZIP archives
+ */
+const DEFAULT_COMPRESSION_LEVEL = 9;
+/**
+ * ZIP archive adapter using archiver/unzipper libraries
+ */
+export class ZipArchiveAdapter {
+    /**
+     * Create a ZIP archive from entries
+     */
+    async createArchive(outputPath, entries, options = {}) {
+        const compressionLevel = options.compressionLevel ?? DEFAULT_COMPRESSION_LEVEL;
+        return new Promise((resolve, reject) => {
+            const output = fs.createWriteStream(outputPath);
+            const archive = archiver('zip', { zlib: { level: compressionLevel } });
+            // Handle archive errors
+            archive.on('error', (err) => {
+                reject(err);
+            });
+            // Handle stream close - archive is complete
+            output.on('close', () => {
+                resolve({
+                    outputPath,
+                    size: archive.pointer()
+                });
+            });
+            // Handle output stream errors
+            output.on('error', (err) => {
+                reject(err);
+            });
+            // Pipe archive to output file
+            archive.pipe(output);
+            // Add all entries to the archive
+            for (const entry of entries) {
+                archive.append(entry.content, { name: entry.name });
+            }
+            // Finalize the archive
+            void archive.finalize();
+        });
+    }
+    /**
+     * Extract a ZIP archive to a directory
+     */
+    async extractArchive(archivePath, targetDir) {
+        return new Promise((resolve, reject) => {
+            const readStream = fs.createReadStream(archivePath);
+            readStream
+                .pipe(unzipper.Extract({ path: targetDir }))
+                .on('close', () => resolve())
+                .on('error', reject);
+            readStream.on('error', reject);
+        });
+    }
+}
+/**
+ * Create a new ZIP archive adapter instance
+ */
+export function createArchiveAdapter() {
+    return new ZipArchiveAdapter();
+}
+//# sourceMappingURL=archive-adapter.js.map

package/dist/session/archive-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-adapter.js","sourceRoot":"","sources":["../../src/session/archive-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,QAAQ,MAAM,UAAU,CAAC;AAIhC;;GAEG;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAC7B;;OAEG;IACH,KAAK,CAAC,aAAa,CAClB,UAAkB,EAClB,OAAuB,EACvB,UAAgC,EAAE;QAElC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,yBAAyB,CAAC;QAE/E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,MAAM,GAAG,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;YAEvE,wBAAwB;YACxB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;gBAClC,MAAM,CAAC,GAAG,CAAC,CAAC;YACb,CAAC,CAAC,CAAC;YAEH,4CAA4C;YAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvB,OAAO,CAAC;oBACP,UAAU;oBACV,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;iBACvB,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,8BAA8B;YAC9B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;gBACjC,MAAM,CAAC,GAAG,CAAC,CAAC;YACb,CAAC,CAAC,CAAC;YAEH,8BAA8B;YAC9B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErB,iCAAiC;YACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACrD,CAAC;YAED,uBAAuB;YACvB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,WAAmB,EAAE,SAAiB;QAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YAEpD,UAAU;iBACR,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;iBAC3C,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;iBAC5B,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAEtB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IACnC,OAAO,IAAI,iBAAiB,EAAE,CAAC;AAChC,CAAC"}

package/dist/session/cleanup-scheduler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Session cleanup scheduler service
+ * Runs session cleanup operations on a configurable schedule
+ */
+import { type BaseCleanupSchedule, BaseCleanupScheduler } from '../utils/base-cleanup-scheduler.js';
+import type { SessionCleanupResult, SessionRetentionManager } from './retention-manager.js';
+import type { SessionStore } from './store.js';
+export type SessionCleanupSchedule = BaseCleanupSchedule;
+export declare class SessionCleanupScheduler extends BaseCleanupScheduler<SessionCleanupSchedule, SessionCleanupResult> {
+    private retentionManager;
+    private sessionStore;
+    constructor(retentionManager: SessionRetentionManager, sessionStore: SessionStore, schedule: SessionCleanupSchedule);
+    /**
+     * Run cleanup on all sessions
+     */
+    protected runCleanup(): Promise<void>;
+    /**
+     * Run cleanup immediately (manual trigger)
+     */
+    runNow(): Promise<SessionCleanupResult>;
+}
+//# sourceMappingURL=cleanup-scheduler.d.ts.map

package/dist/session/cleanup-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-scheduler.d.ts","sourceRoot":"","sources":["../../src/session/cleanup-scheduler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAE9F,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAEzD,qBAAa,uBAAwB,SAAQ,oBAAoB,CAAC,sBAAsB,EAAE,oBAAoB,CAAC;IAC9G,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,YAAY,CAAe;gBAEvB,gBAAgB,EAAE,uBAAuB,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,sBAAsB;IAMnH;;OAEG;cACa,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgE3C;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAqB7C"}

package/dist/session/cleanup-scheduler.js

@@ -0,0 +1,96 @@
+/**
+ * Session cleanup scheduler service
+ * Runs session cleanup operations on a configurable schedule
+ */
+import { BaseCleanupScheduler } from '../utils/base-cleanup-scheduler.js';
+export class SessionCleanupScheduler extends BaseCleanupScheduler {
+    retentionManager;
+    sessionStore;
+    constructor(retentionManager, sessionStore, schedule) {
+        super(schedule, 'Session cleanup scheduler');
+        this.retentionManager = retentionManager;
+        this.sessionStore = sessionStore;
+    }
+    /**
+     * Run cleanup on all sessions
+     */
+    async runCleanup() {
+        if (!this.isRunning)
+            return;
+        const startTime = Date.now();
+        let totalDeleted = 0;
+        let totalCompressed = 0;
+        let totalErrors = 0;
+        this.logger.debug('Running scheduled session cleanup');
+        try {
+            const sessions = await this.sessionStore.listSessions();
+            const sessionDir = this.sessionStore.getSessionsDir();
+            const result = await this.retentionManager.cleanup(sessionDir, sessions);
+            totalDeleted += result.deletedSessions.length;
+            totalCompressed += result.compressedSessions.length;
+            totalErrors += result.errors.length;
+            // Show user notification when cleanup actually does something
+            const hasActions = result.deletedSessions.length > 0 || result.compressedSessions.length > 0;
+            if (result.errors.length > 0) {
+                this.logger.warn('Session cleanup completed with errors', {
+                    compressedCount: result.compressedSessions.length,
+                    deletedCount: result.deletedSessions.length,
+                    errorCount: result.errors.length,
+                    errors: result.errors
+                });
+            }
+            else if (hasActions) {
+                // Log at INFO level when cleanup actually modified sessions
+                this.logger.info('Automatic session cleanup completed', {
+                    compressedCount: result.compressedSessions.length,
+                    deletedCount: result.deletedSessions.length
+                });
+                this.logger.debug('Session cleanup details', {
+                    sizeAfterMB: (result.totalSizeAfter / (1024 * 1024)).toFixed(2),
+                    sizeBeforeMB: (result.totalSizeBefore / (1024 * 1024)).toFixed(2),
+                    sizeSavedMB: ((result.totalSizeBefore - result.totalSizeAfter) / (1024 * 1024)).toFixed(2)
+                });
+            }
+            else {
+                // No actions taken - log at debug level only
+                this.logger.debug('Session cleanup completed successfully - no sessions to clean');
+            }
+        }
+        catch (error) {
+            totalErrors++;
+            this.logger.error('Failed to run session cleanup', error instanceof Error ? error : undefined);
+        }
+        const duration = Date.now() - startTime;
+        // Log simple message at info level
+        this.logger.debug('Scheduled session cleanup cycle completed');
+        // Log detailed statistics only at debug level (requires log_level='debug' in config)
+        this.logger.debug('Session cleanup statistics', {
+            durationMs: duration,
+            totalCompressed,
+            totalDeleted,
+            totalErrors
+        });
+    }
+    /**
+     * Run cleanup immediately (manual trigger)
+     */
+    async runNow() {
+        this.logger.info('Running manual session cleanup');
+        try {
+            const sessions = await this.sessionStore.listSessions();
+            const sessionDir = this.sessionStore.getSessionsDir();
+            const result = await this.retentionManager.cleanup(sessionDir, sessions);
+            this.logger.info('Manual session cleanup completed');
+            this.logger.info('Manual cleanup details', {
+                compressedCount: result.compressedSessions.length,
+                deletedCount: result.deletedSessions.length
+            });
+            return result;
+        }
+        catch (error) {
+            this.logger.error('Manual session cleanup failed', error instanceof Error ? error : undefined);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=cleanup-scheduler.js.map

package/dist/session/cleanup-scheduler.js.map

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

package/dist/session/context.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Session context manager
+ */
+import type { OptimizationMetrics, QualityMetrics, Session, SessionCommand, SessionContext } from '../types/session.types.js';
+export declare class SessionContextManager {
+    private session;
+    constructor(session: Session);
+    /**
+     * Add a command to session history
+     */
+    addCommand(command: string, args: string[], flags: Record<string, boolean | string | undefined>, outputs: Record<string, unknown>, success: boolean, duration_ms: number, error?: string, tokens_used?: number, optimization_metrics?: OptimizationMetrics, quality_metrics?: QualityMetrics): void;
+    /**
+     * Set the currently running command
+     */
+    setCurrentCommand(command: string): void;
+    /**
+     * Clear the currently running command
+     */
+    clearCurrentCommand(): void;
+    /**
+     * Update session context
+     */
+    updateContext(key: string, value: unknown): void;
+    /**
+     * Get context value
+     */
+    getContext(key: string): unknown;
+    /**
+     * Get all context
+     */
+    getAllContext(): SessionContext;
+    /**
+     * Merge context
+     */
+    mergeContext(context: SessionContext): void;
+    /**
+     * Clear specific context key
+     */
+    clearContext(key: string): void;
+    /**
+     * Clear all context
+     */
+    clearAllContext(): void;
+    /**
+     * Get last command
+     */
+    getLastCommand(): null | SessionCommand;
+    /**
+     * Get command history
+     */
+    getCommandHistory(): SessionCommand[];
+    /**
+     * Get commands by name
+     */
+    getCommandsByName(commandName: string): SessionCommand[];
+    /**
+     * Get successful commands
+     */
+    getSuccessfulCommands(): SessionCommand[];
+    /**
+     * Get failed commands
+     */
+    getFailedCommands(): SessionCommand[];
+    /**
+     * Get session statistics
+     */
+    getStatistics(): {
+        average_duration_ms: number;
+        failed_commands: number;
+        successful_commands: number;
+        total_commands: number;
+        total_duration_ms: number;
+    };
+    /**
+     * Update session status
+     */
+    setStatus(status: 'active' | 'completed' | 'failed' | 'paused'): void;
+    /**
+     * Get session status
+     */
+    getStatus(): 'active' | 'completed' | 'failed' | 'paused';
+    /**
+     * Get session
+     */
+    getSession(): Session;
+    /**
+     * Check if context has key
+     */
+    hasContext(key: string): boolean;
+    /**
+     * Get context keys
+     */
+    getContextKeys(): string[];
+    /**
+     * Validate context has required keys
+     */
+    validateContext(requiredKeys: string[]): void;
+    /**
+     * Get filtered context containing only specified keys
+     * Useful for reducing token usage by only passing context that's actually referenced
+     */
+    getFilteredContext(keys: string[]): SessionContext;
+    /**
+     * Extract $CONTEXT_* variable references from a value (string, object, or array)
+     * Returns a set of context keys that are referenced
+     */
+    static extractContextReferences(value: unknown): Set<string>;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/session/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/session/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAIxH,qBAAa,qBAAqB;IACjC,OAAO,CAAC,OAAO,CAAU;gBAEb,OAAO,EAAE,OAAO;IAI5B;;OAEG;IACH,UAAU,CACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,EACnD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,OAAO,EAEhB,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,EAEd,WAAW,CAAC,EAAE,MAAM,EAEpB,oBAAoB,CAAC,EAAE,mBAAmB,EAE1C,eAAe,CAAC,EAAE,cAAc,GAC9B,IAAI;IAqBP;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKxC;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAuBhD;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAWhC;;OAEG;IACH,aAAa,IAAI,cAAc;IAI/B;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAI3C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,cAAc,IAAI,IAAI,GAAG,cAAc;IAOvC;;OAEG;IACH,iBAAiB,IAAI,cAAc,EAAE;IAIrC;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE;IAIxD;;OAEG;IACH,qBAAqB,IAAI,cAAc,EAAE;IAIzC;;OAEG;IACH,iBAAiB,IAAI,cAAc,EAAE;IAIrC;;OAEG;IACH,aAAa,IAAI;QAChB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;KAC1B;IAeD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI;IAIrE;;OAEG;IACH,SAAS,IAAI,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ;IAIzD;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;IAU7C;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc;IAwBlD;;;OAGG;IACH,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC;CAwB5D"}