monty-autonomous-fullstack-dev-multillm 1.0.0

package/dist/utils/session-manager.js

@@ -0,0 +1,389 @@
+/**
+ * Session Manager (Features A1, A6)
+ * Handles session persistence, resumption, and file checkpointing
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+import { writeFileSync, readFileSync, existsSync, mkdirSync, copyFileSync, readdirSync, statSync, unlinkSync } from 'fs';
+import { join, dirname, relative } from 'path';
+import { createHash } from 'crypto';
+/**
+ * Generate unique session ID
+ */
+export function generateSessionId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `session-${timestamp}-${random}`;
+}
+/**
+ * Generate checkpoint ID
+ */
+export function generateCheckpointId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 6);
+    return `ckpt-${timestamp}-${random}`;
+}
+/**
+ * Create new session state
+ */
+export function createSessionState(parentSessionId = null) {
+    return {
+        session_id: generateSessionId(),
+        parent_session_id: parentSessionId,
+        created_at: new Date().toISOString(),
+        last_active: new Date().toISOString(),
+        status: 'active',
+        current_feature: null,
+        completed_features: [],
+        failed_features: [],
+        context_summary: '',
+        important_decisions: [],
+        tools_initialized: [],
+        mcp_servers_active: [],
+        checkpoints: [],
+        current_checkpoint: null,
+    };
+}
+/**
+ * Save session state
+ */
+export function saveSessionState(agentDir, state) {
+    const sessionPath = join(agentDir, 'session_state.json');
+    const sessionsDir = join(agentDir, 'sessions');
+    // Ensure sessions directory exists
+    if (!existsSync(sessionsDir)) {
+        mkdirSync(sessionsDir, { recursive: true });
+    }
+    // Update last active
+    state.last_active = new Date().toISOString();
+    // Save current state
+    writeFileSync(sessionPath, JSON.stringify(state, null, 2));
+    // Also save to sessions history
+    const historyPath = join(sessionsDir, `${state.session_id}.json`);
+    writeFileSync(historyPath, JSON.stringify(state, null, 2));
+}
+/**
+ * Load session state
+ */
+export function loadSessionState(agentDir) {
+    const sessionPath = join(agentDir, 'session_state.json');
+    if (!existsSync(sessionPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(sessionPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load specific session by ID
+ */
+export function loadSessionById(agentDir, sessionId) {
+    const sessionsDir = join(agentDir, 'sessions');
+    const sessionPath = join(sessionsDir, `${sessionId}.json`);
+    if (!existsSync(sessionPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(sessionPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fork session for A/B testing
+ */
+export function forkSession(agentDir, parentState) {
+    const newState = createSessionState(parentState.session_id);
+    // Copy relevant state from parent
+    newState.completed_features = [...parentState.completed_features];
+    newState.context_summary = parentState.context_summary;
+    newState.important_decisions = [...parentState.important_decisions];
+    newState.checkpoints = [...parentState.checkpoints];
+    newState.current_checkpoint = parentState.current_checkpoint;
+    // Mark parent as forked
+    parentState.status = 'forked';
+    saveSessionState(agentDir, parentState);
+    // Save new session
+    saveSessionState(agentDir, newState);
+    return newState;
+}
+/**
+ * List all sessions
+ */
+export function listSessions(agentDir) {
+    const sessionsDir = join(agentDir, 'sessions');
+    if (!existsSync(sessionsDir))
+        return [];
+    const sessions = [];
+    const files = readdirSync(sessionsDir).filter(f => f.endsWith('.json'));
+    for (const file of files) {
+        try {
+            const state = JSON.parse(readFileSync(join(sessionsDir, file), 'utf-8'));
+            sessions.push(state);
+        }
+        catch {
+            // Skip invalid files
+        }
+    }
+    // Sort by last active (newest first)
+    return sessions.sort((a, b) => new Date(b.last_active).getTime() - new Date(a.last_active).getTime());
+}
+/**
+ * Calculate file hash
+ */
+function calculateFileHash(filePath) {
+    if (!existsSync(filePath))
+        return '';
+    const content = readFileSync(filePath);
+    return createHash('sha256').update(content).digest('hex').substring(0, 16);
+}
+/**
+ * Create checkpoint
+ */
+export function createCheckpoint(agentDir, projectRoot, description, featureId = null) {
+    const checkpointsDir = join(agentDir, 'checkpoints');
+    const checkpointId = generateCheckpointId();
+    const checkpointDir = join(checkpointsDir, checkpointId);
+    // Create checkpoint directory
+    mkdirSync(checkpointDir, { recursive: true });
+    // Find tracked files (src, config files, etc.)
+    const trackedPatterns = [
+        'src/**/*.ts',
+        'src/**/*.tsx',
+        'src/**/*.js',
+        'src/**/*.jsx',
+        'package.json',
+        'tsconfig.json',
+        '.env',
+        '.env.local',
+    ];
+    const files = [];
+    // Simple file discovery (would use glob in production)
+    const srcDir = join(projectRoot, 'src');
+    if (existsSync(srcDir)) {
+        const srcFiles = findFilesRecursive(srcDir, ['.ts', '.tsx', '.js', '.jsx']);
+        for (const file of srcFiles) {
+            const relativePath = relative(projectRoot, file);
+            const hash = calculateFileHash(file);
+            const stats = statSync(file);
+            // Backup file
+            const backupPath = join(checkpointDir, relativePath);
+            const backupDir = dirname(backupPath);
+            if (!existsSync(backupDir)) {
+                mkdirSync(backupDir, { recursive: true });
+            }
+            copyFileSync(file, backupPath);
+            files.push({
+                path: relativePath,
+                hash,
+                size: stats.size,
+                backed_up: true,
+            });
+        }
+    }
+    // Backup config files
+    const configFiles = ['package.json', 'tsconfig.json'];
+    for (const configFile of configFiles) {
+        const filePath = join(projectRoot, configFile);
+        if (existsSync(filePath)) {
+            const hash = calculateFileHash(filePath);
+            const stats = statSync(filePath);
+            copyFileSync(filePath, join(checkpointDir, configFile));
+            files.push({
+                path: configFile,
+                hash,
+                size: stats.size,
+                backed_up: true,
+            });
+        }
+    }
+    const checkpoint = {
+        id: checkpointId,
+        created_at: new Date().toISOString(),
+        description,
+        feature_id: featureId,
+        files_snapshot: files,
+        can_restore: true,
+    };
+    // Save checkpoint metadata
+    writeFileSync(join(checkpointDir, 'checkpoint.json'), JSON.stringify(checkpoint, null, 2));
+    return checkpoint;
+}
+/**
+ * Restore checkpoint
+ */
+export function restoreCheckpoint(agentDir, projectRoot, checkpointId) {
+    const checkpointDir = join(agentDir, 'checkpoints', checkpointId);
+    const metadataPath = join(checkpointDir, 'checkpoint.json');
+    if (!existsSync(metadataPath)) {
+        console.error(`Checkpoint ${checkpointId} not found`);
+        return false;
+    }
+    try {
+        const checkpoint = JSON.parse(readFileSync(metadataPath, 'utf-8'));
+        if (!checkpoint.can_restore) {
+            console.error(`Checkpoint ${checkpointId} cannot be restored`);
+            return false;
+        }
+        // Restore each file
+        for (const file of checkpoint.files_snapshot) {
+            if (file.backed_up) {
+                const backupPath = join(checkpointDir, file.path);
+                const targetPath = join(projectRoot, file.path);
+                if (existsSync(backupPath)) {
+                    const targetDir = dirname(targetPath);
+                    if (!existsSync(targetDir)) {
+                        mkdirSync(targetDir, { recursive: true });
+                    }
+                    copyFileSync(backupPath, targetPath);
+                }
+            }
+        }
+        console.log(`Restored checkpoint: ${checkpoint.description}`);
+        return true;
+    }
+    catch (error) {
+        console.error(`Failed to restore checkpoint: ${error}`);
+        return false;
+    }
+}
+/**
+ * List checkpoints
+ */
+export function listCheckpoints(agentDir) {
+    const checkpointsDir = join(agentDir, 'checkpoints');
+    if (!existsSync(checkpointsDir))
+        return [];
+    const checkpoints = [];
+    const dirs = readdirSync(checkpointsDir);
+    for (const dir of dirs) {
+        const metadataPath = join(checkpointsDir, dir, 'checkpoint.json');
+        if (existsSync(metadataPath)) {
+            try {
+                checkpoints.push(JSON.parse(readFileSync(metadataPath, 'utf-8')));
+            }
+            catch {
+                // Skip invalid checkpoints
+            }
+        }
+    }
+    // Sort by creation time (newest first)
+    return checkpoints.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime());
+}
+/**
+ * Clean old checkpoints (keep last N)
+ */
+export function cleanOldCheckpoints(agentDir, keepCount = 10) {
+    const checkpoints = listCheckpoints(agentDir);
+    if (checkpoints.length <= keepCount)
+        return;
+    const toDelete = checkpoints.slice(keepCount);
+    const checkpointsDir = join(agentDir, 'checkpoints');
+    for (const checkpoint of toDelete) {
+        const checkpointDir = join(checkpointsDir, checkpoint.id);
+        if (existsSync(checkpointDir)) {
+            // Remove directory recursively
+            removeDirectoryRecursive(checkpointDir);
+        }
+    }
+}
+/**
+ * Helper: Find files recursively
+ */
+function findFilesRecursive(dir, extensions) {
+    const files = [];
+    if (!existsSync(dir))
+        return files;
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+        const fullPath = join(dir, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            // Skip node_modules and hidden directories
+            if (!entry.startsWith('.') && entry !== 'node_modules' && entry !== 'dist') {
+                files.push(...findFilesRecursive(fullPath, extensions));
+            }
+        }
+        else if (extensions.some(ext => entry.endsWith(ext))) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+/**
+ * Helper: Remove directory recursively
+ */
+function removeDirectoryRecursive(dir) {
+    if (!existsSync(dir))
+        return;
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+        const fullPath = join(dir, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            removeDirectoryRecursive(fullPath);
+        }
+        else {
+            unlinkSync(fullPath);
+        }
+    }
+    // Remove empty directory
+    try {
+        readdirSync(dir).length === 0 && unlinkSync(dir);
+    }
+    catch {
+        // Ignore errors
+    }
+}
+/**
+ * Get session resume options for SDK
+ */
+export function getResumeOptions(sessionState) {
+    return {
+        resume: sessionState.session_id,
+        context_summary: sessionState.context_summary,
+        completed_features: sessionState.completed_features,
+    };
+}
+/**
+ * Generate session summary for context preservation
+ */
+export function generateSessionSummary(state) {
+    const completedCount = state.completed_features.length;
+    const failedCount = state.failed_features.length;
+    let summary = `Session ${state.session_id}\n`;
+    summary += `Started: ${state.created_at}\n`;
+    summary += `Features completed: ${completedCount}\n`;
+    if (failedCount > 0) {
+        summary += `Features failed: ${failedCount}\n`;
+    }
+    if (state.current_feature) {
+        summary += `Currently working on: ${state.current_feature}\n`;
+    }
+    if (state.important_decisions.length > 0) {
+        summary += `\nKey decisions:\n`;
+        for (const decision of state.important_decisions) {
+            summary += `- ${decision}\n`;
+        }
+    }
+    return summary;
+}
+export default {
+    generateSessionId,
+    createSessionState,
+    saveSessionState,
+    loadSessionState,
+    loadSessionById,
+    forkSession,
+    listSessions,
+    createCheckpoint,
+    restoreCheckpoint,
+    listCheckpoints,
+    cleanOldCheckpoints,
+    getResumeOptions,
+    generateSessionSummary,
+};
+//# sourceMappingURL=session-manager.js.map

package/dist/utils/session-manager.js.map

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

package/dist/utils/skills-manager.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Skills Manager
+ * Implements skill loading and management for the Claude Agent SDK.
+ * Skills are specialized SKILL.md files that extend agent capabilities.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+/**
+ * Skill metadata parsed from SKILL.md frontmatter
+ */
+export interface SkillMetadata {
+    name: string;
+    description: string;
+    triggers?: string[];
+    category?: string;
+    version?: string;
+    author?: string;
+    priority?: number;
+}
+/**
+ * Loaded skill with content and metadata
+ */
+export interface LoadedSkill {
+    path: string;
+    relativePath: string;
+    name: string;
+    content: string;
+    metadata: SkillMetadata;
+    source: 'workspace' | 'user' | 'system' | 'marketplace';
+}
+/**
+ * Skill search paths
+ */
+export declare const SKILL_SEARCH_PATHS: string[];
+/**
+ * Parse YAML frontmatter from SKILL.md content
+ */
+export declare function parseSkillFrontmatter(content: string): SkillMetadata;
+/**
+ * Get skill content without frontmatter
+ */
+export declare function getSkillContent(content: string): string;
+/**
+ * Load a single skill from a path
+ */
+export declare function loadSkill(skillPath: string, baseDir: string, source: LoadedSkill['source']): LoadedSkill | null;
+/**
+ * Recursively find SKILL.md files in a directory
+ */
+export declare function findSkillFiles(directory: string): string[];
+/**
+ * Load all skills from search paths
+ */
+export declare function loadAllSkills(projectRoot?: string): LoadedSkill[];
+/**
+ * Find skills that match a query or context
+ */
+export declare function findMatchingSkills(skills: LoadedSkill[], query: string): LoadedSkill[];
+/**
+ * Format skills for inclusion in agent prompt
+ */
+export declare function formatSkillsForPrompt(skills: LoadedSkill[]): string;
+/**
+ * Get skills summary for status display
+ */
+export declare function getSkillsSummary(skills: LoadedSkill[]): string;
+/**
+ * Skills Manager class for stateful skill management
+ */
+export declare class SkillsManager {
+    private skills;
+    private projectRoot;
+    constructor(projectRoot?: string);
+    /**
+     * Load all available skills
+     */
+    load(): LoadedSkill[];
+    /**
+     * Get all loaded skills
+     */
+    getAll(): LoadedSkill[];
+    /**
+     * Find skills matching a query
+     */
+    find(query: string): LoadedSkill[];
+    /**
+     * Get skills formatted for prompt inclusion
+     */
+    formatForPrompt(): string;
+    /**
+     * Get summary for status display
+     */
+    getSummary(): string;
+    /**
+     * Get skill by name
+     */
+    getByName(name: string): LoadedSkill | undefined;
+    /**
+     * Get skills by category
+     */
+    getByCategory(category: string): LoadedSkill[];
+    /**
+     * Get skills by source
+     */
+    getBySource(source: LoadedSkill['source']): LoadedSkill[];
+}
+/**
+ * Create a skills manager instance
+ */
+export declare function createSkillsManager(projectRoot?: string): SkillsManager;
+export default SkillsManager;
+//# sourceMappingURL=skills-manager.d.ts.map

package/dist/utils/skills-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-manager.d.ts","sourceRoot":"","sources":["../../src/utils/skills-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;CACzD;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAU9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA6DpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,GAC5B,WAAW,GAAG,IAAI,CAsBpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CA+B1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAE,MAAsB,GAAG,WAAW,EAAE,CAuChF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,MAAM,GACZ,WAAW,EAAE,CA8Bf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CA4BnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAe9D;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,GAAE,MAAsB;IAI/C;;OAEG;IACH,IAAI,IAAI,WAAW,EAAE;IAKrB;;OAEG;IACH,MAAM,IAAI,WAAW,EAAE;IAIvB;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE;IAIlC;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAMhD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAM9C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,WAAW,EAAE;CAG1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,aAAa,CAEvE;AAED,eAAe,aAAa,CAAC"}