@stackmemoryai/stackmemory 0.1.0 → 0.2.1

package/dist/src/core/error-handler.js

@@ -0,0 +1,212 @@
+/**
+ * Comprehensive error handling for StackMemory CLI
+ */
+import { logger } from './logger.js';
+export var ErrorCode;
+(function (ErrorCode) {
+    // Authentication errors
+    ErrorCode["AUTH_FAILED"] = "AUTH_FAILED";
+    ErrorCode["TOKEN_EXPIRED"] = "TOKEN_EXPIRED";
+    ErrorCode["INVALID_CREDENTIALS"] = "INVALID_CREDENTIALS";
+    // File system errors
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    ErrorCode["DISK_FULL"] = "DISK_FULL";
+    // Git operation errors
+    ErrorCode["NOT_GIT_REPO"] = "NOT_GIT_REPO";
+    ErrorCode["GIT_COMMAND_FAILED"] = "GIT_COMMAND_FAILED";
+    ErrorCode["INVALID_BRANCH"] = "INVALID_BRANCH";
+    // Database errors
+    ErrorCode["DB_CONNECTION_FAILED"] = "DB_CONNECTION_FAILED";
+    ErrorCode["DB_QUERY_FAILED"] = "DB_QUERY_FAILED";
+    ErrorCode["DB_CORRUPTION"] = "DB_CORRUPTION";
+    // Network errors
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    ErrorCode["API_ERROR"] = "API_ERROR";
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    // Validation errors
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+    // General errors
+    ErrorCode["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+    ErrorCode["OPERATION_FAILED"] = "OPERATION_FAILED";
+    ErrorCode["CONFIGURATION_ERROR"] = "CONFIGURATION_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+export class StackMemoryError extends Error {
+    code;
+    context;
+    userMessage;
+    recoverable;
+    constructor(code, message, userMessage, context = {}, recoverable = false, cause) {
+        super(message);
+        this.name = 'StackMemoryError';
+        this.code = code;
+        this.context = context;
+        this.userMessage = userMessage || this.getDefaultUserMessage(code);
+        this.recoverable = recoverable;
+        if (cause && Error.captureStackTrace) {
+            Error.captureStackTrace(this, StackMemoryError);
+        }
+        // Log the error
+        logger.error(message, cause, {
+            code,
+            context,
+            recoverable,
+            userMessage: this.userMessage,
+        });
+    }
+    getDefaultUserMessage(code) {
+        switch (code) {
+            case ErrorCode.AUTH_FAILED:
+                return 'Authentication failed. Please check your credentials and try again.';
+            case ErrorCode.NOT_GIT_REPO:
+                return 'This command requires a git repository. Please run it from within a git repository.';
+            case ErrorCode.PERMISSION_DENIED:
+                return 'Permission denied. Please check file permissions or run with appropriate privileges.';
+            case ErrorCode.NETWORK_ERROR:
+                return 'Network error. Please check your internet connection and try again.';
+            case ErrorCode.INVALID_INPUT:
+                return 'Invalid input provided. Please check your command and try again.';
+            case ErrorCode.DB_CONNECTION_FAILED:
+                return 'Database connection failed. Please try again or contact support if the issue persists.';
+            case ErrorCode.GIT_COMMAND_FAILED:
+                return 'Git operation failed. Please ensure your repository is in a valid state.';
+            default:
+                return 'An unexpected error occurred. Please try again or contact support.';
+        }
+    }
+    static fromNodeError(nodeError, context = {}) {
+        const code = nodeError.code;
+        switch (code) {
+            case 'ENOENT':
+                return new StackMemoryError(ErrorCode.FILE_NOT_FOUND, `File or directory not found: ${nodeError.path}`, 'The requested file or directory was not found.', { ...context, path: nodeError.path }, false, nodeError);
+            case 'EACCES':
+            case 'EPERM':
+                return new StackMemoryError(ErrorCode.PERMISSION_DENIED, `Permission denied: ${nodeError.path}`, 'Permission denied. Please check file permissions.', { ...context, path: nodeError.path }, true, nodeError);
+            case 'ENOSPC':
+                return new StackMemoryError(ErrorCode.DISK_FULL, 'No space left on device', 'Insufficient disk space. Please free up space and try again.', context, true, nodeError);
+            case 'ETIMEDOUT':
+                return new StackMemoryError(ErrorCode.TIMEOUT, 'Operation timed out', 'The operation timed out. Please try again.', context, true, nodeError);
+            default:
+                return new StackMemoryError(ErrorCode.UNKNOWN_ERROR, nodeError.message, 'An unexpected system error occurred.', { ...context, nodeErrorCode: code }, false, nodeError);
+        }
+    }
+}
+export class ErrorHandler {
+    static retryMap = new Map();
+    static MAX_RETRIES = 3;
+    static handle(error, operation) {
+        if (error instanceof StackMemoryError) {
+            // Already a well-formed StackMemory error
+            console.error(`❌ ${error.userMessage}`);
+            if (error.recoverable) {
+                console.error('💡 This error may be recoverable. Please try again.');
+            }
+            process.exit(1);
+        }
+        if (error instanceof Error) {
+            // Convert Node.js error to StackMemoryError
+            let stackMemoryError;
+            if ('code' in error && typeof error.code === 'string') {
+                stackMemoryError = StackMemoryError.fromNodeError(error, { operation });
+            }
+            else {
+                stackMemoryError = new StackMemoryError(ErrorCode.OPERATION_FAILED, `Operation '${operation}' failed: ${error.message}`, `Operation failed: ${error.message}`, { operation }, false, error);
+            }
+            console.error(`❌ ${stackMemoryError.userMessage}`);
+            if (stackMemoryError.recoverable) {
+                console.error('💡 This error may be recoverable. Please try again.');
+            }
+            process.exit(1);
+        }
+        // Unknown error type
+        const unknownError = new StackMemoryError(ErrorCode.UNKNOWN_ERROR, `Unknown error in operation '${operation}': ${String(error)}`, 'An unexpected error occurred.', { operation, errorType: typeof error }, false);
+        console.error(`❌ ${unknownError.userMessage}`);
+        process.exit(1);
+    }
+    static async safeExecute(operation, operationName, fallback) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (fallback !== undefined) {
+                logger.warn(`Operation '${operationName}' failed, using fallback`, {
+                    error: String(error),
+                });
+                return fallback;
+            }
+            ErrorHandler.handle(error, operationName);
+        }
+    }
+    static async withRetry(operation, operationName, maxRetries = ErrorHandler.MAX_RETRIES) {
+        let lastError;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                const result = await operation();
+                // Clear retry count on success
+                ErrorHandler.retryMap.delete(operationName);
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                if (error instanceof StackMemoryError && !error.recoverable) {
+                    // Don't retry non-recoverable errors
+                    ErrorHandler.handle(error, operationName);
+                }
+                if (attempt === maxRetries) {
+                    break;
+                }
+                const delay = Math.min(1000 * Math.pow(2, attempt - 1), 5000); // Exponential backoff
+                logger.warn(`Attempt ${attempt}/${maxRetries} failed for '${operationName}', retrying in ${delay}ms`, {
+                    error: String(error),
+                });
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        ErrorHandler.handle(lastError, `${operationName} (after ${maxRetries} attempts)`);
+    }
+    static createCircuitBreaker(operation, operationName, threshold = 5) {
+        let failures = 0;
+        let lastFailure = 0;
+        const resetTimeout = 30000; // 30 seconds
+        return async () => {
+            const now = Date.now();
+            // Reset circuit breaker after timeout
+            if (now - lastFailure > resetTimeout) {
+                failures = 0;
+            }
+            // Circuit is open (too many failures)
+            if (failures >= threshold) {
+                throw new StackMemoryError(ErrorCode.OPERATION_FAILED, `Circuit breaker open for '${operationName}'`, `Operation temporarily unavailable. Please try again later.`, { operationName, failures, threshold }, true);
+            }
+            try {
+                const result = await operation();
+                failures = 0; // Reset on success
+                return result;
+            }
+            catch (error) {
+                failures++;
+                lastFailure = now;
+                throw error;
+            }
+        };
+    }
+}
+// Utility functions for common error scenarios
+export const validateInput = (value, name, validator) => {
+    if (!validator(value)) {
+        throw new StackMemoryError(ErrorCode.INVALID_INPUT, `Invalid ${name}: ${String(value)}`, `Please provide a valid ${name}.`, { name, value }, true);
+    }
+};
+export const validateEmail = (email) => {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    if (!emailRegex.test(email) || email.length > 254) {
+        throw new StackMemoryError(ErrorCode.INVALID_INPUT, `Invalid email format: ${email}`, 'Please provide a valid email address.', { email }, true);
+    }
+};
+export const validatePath = (filePath) => {
+    if (!filePath || filePath.includes('..') || filePath.includes('\0')) {
+        throw new StackMemoryError(ErrorCode.INVALID_INPUT, `Invalid path: ${filePath}`, 'Invalid file path provided.', { path: filePath }, true);
+    }
+};
+//# sourceMappingURL=error-handler.js.map

package/dist/src/core/error-handler.js.map

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

package/dist/src/core/frame-manager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * StackMemory Frame Manager - Call Stack Implementation
+ * Manages nested frames representing the call stack of work
+ */
+import Database from 'better-sqlite3';
+export type FrameType = 'task' | 'subtask' | 'tool_scope' | 'review' | 'write' | 'debug';
+export type FrameState = 'active' | 'closed';
+export interface Frame {
+    frame_id: string;
+    run_id: string;
+    project_id: string;
+    parent_frame_id?: string;
+    depth: number;
+    type: FrameType;
+    name: string;
+    state: FrameState;
+    inputs: Record<string, any>;
+    outputs: Record<string, any>;
+    digest_text?: string;
+    digest_json: Record<string, any>;
+    created_at: number;
+    closed_at?: number;
+}
+export interface FrameContext {
+    frameId: string;
+    header: {
+        goal: string;
+        constraints?: string[];
+        definitions?: Record<string, string>;
+    };
+    anchors: Anchor[];
+    recentEvents: Event[];
+    activeArtifacts: string[];
+}
+export interface Anchor {
+    anchor_id: string;
+    frame_id: string;
+    type: 'FACT' | 'DECISION' | 'CONSTRAINT' | 'INTERFACE_CONTRACT' | 'TODO' | 'RISK';
+    text: string;
+    priority: number;
+    metadata: Record<string, any>;
+}
+export interface Event {
+    event_id: string;
+    frame_id: string;
+    run_id: string;
+    seq: number;
+    event_type: 'user_message' | 'assistant_message' | 'tool_call' | 'tool_result' | 'decision' | 'constraint' | 'artifact' | 'observation';
+    payload: Record<string, any>;
+    ts: number;
+}
+export declare class FrameManager {
+    private db;
+    private currentRunId;
+    private projectId;
+    private activeStack;
+    constructor(db: Database.Database, projectId: string, runId?: string);
+    private initializeSchema;
+    private loadActiveStack;
+    private buildStackOrder;
+    /**
+     * Create a new frame and push to stack
+     */
+    createFrame(options: {
+        type: FrameType;
+        name: string;
+        inputs?: Record<string, any>;
+        parentFrameId?: string;
+    }): string;
+    /**
+     * Close the current frame and generate digest
+     */
+    closeFrame(frameId?: string, outputs?: Record<string, any>): void;
+    private closeChildFrames;
+    /**
+     * Generate digest for a frame
+     */
+    private generateDigest;
+    private generateDigestText;
+    /**
+     * Add event to current frame
+     */
+    addEvent(eventType: Event['event_type'], payload: Record<string, any>, frameId?: string): string;
+    /**
+     * Add anchor to frame
+     */
+    addAnchor(type: Anchor['type'], text: string, priority?: number, metadata?: Record<string, any>, frameId?: string): string;
+    /**
+     * Get hot stack context for current active frames
+     */
+    getHotStackContext(maxEvents?: number): FrameContext[];
+    /**
+     * Get active frame path (root to current)
+     */
+    getActiveFramePath(): Frame[];
+    getCurrentFrameId(): string | undefined;
+    getStackDepth(): number;
+    private getFrameDepth;
+    getFrame(frameId: string): Frame | undefined;
+    getFrameEvents(frameId: string, limit?: number): Event[];
+    private getFrameAnchors;
+    private getNextEventSequence;
+    private extractConstraints;
+    private getActiveArtifacts;
+}
+//# sourceMappingURL=frame-manager.d.ts.map

package/dist/src/core/frame-manager.d.ts.map

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