@defai.digital/ax-cli 3.5.4 → 3.6.1

package/dist/utils/paste-utils.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Paste handling utilities for detecting and managing large paste operations
+ * Implements smart paste detection, collapsing, and expansion
+ */
+/**
+ * Represents a pasted block of text
+ */
+export interface PastedBlock {
+    id: number;
+    content: string;
+    lineCount: number;
+    collapsed: boolean;
+    startPosition: number;
+    previewLines: string[];
+}
+/**
+ * Paste detection and management class
+ */
+export declare class PasteDetector {
+    private inputBuffer;
+    private readonly PASTE_DETECTION_WINDOW;
+    private readonly PASTE_THRESHOLD;
+    private accumulatedInput;
+    private lastInputTime;
+    /**
+     * Detect if input is part of a paste operation
+     * @param inputChar - Character(s) being input
+     * @returns true if paste detected
+     */
+    detectPaste(inputChar: string): boolean;
+    /**
+     * Accumulate input during paste operation
+     * @param inputChar - Character(s) being input
+     * @param timeout - Timeout to consider paste complete (ms)
+     * @returns accumulated paste content or null if still accumulating
+     */
+    accumulatePasteInput(inputChar: string, timeout?: number): string | null;
+    /**
+     * Get and clear accumulated input
+     */
+    getAccumulatedInput(): string;
+    /**
+     * Reset detector state
+     */
+    reset(): void;
+}
+/**
+ * Check if pasted content should be collapsed
+ * @param content - Pasted content
+ * @returns true if should collapse
+ */
+export declare function shouldCollapsePaste(content: string): boolean;
+/**
+ * Count lines in text (handles different line endings)
+ * @param text - Text to count lines in
+ * @returns number of lines
+ */
+export declare function countLines(text: string): number;
+/**
+ * Create a pasted block from content
+ * @param id - Unique block ID
+ * @param content - Pasted content
+ * @param startPosition - Position in input where inserted
+ * @returns PastedBlock object
+ */
+export declare function createPastedBlock(id: number, content: string, startPosition: number): PastedBlock;
+/**
+ * Generate placeholder text for collapsed paste
+ * @param block - Pasted block
+ * @returns placeholder string
+ */
+export declare function generatePlaceholder(block: PastedBlock): string;
+/**
+ * Extract placeholder ID from placeholder text
+ * @param placeholder - Placeholder text
+ * @returns block ID or null if not a placeholder
+ */
+export declare function extractPlaceholderId(placeholder: string): number | null;
+/**
+ * Find pasted block at cursor position
+ * @param input - Current input text
+ * @param cursorPosition - Cursor position
+ * @param pastedBlocks - Array of pasted blocks
+ * @returns PastedBlock if cursor is on one, null otherwise
+ */
+export declare function findBlockAtCursor(input: string, cursorPosition: number, pastedBlocks: PastedBlock[]): PastedBlock | null;
+/**
+ * Expand all placeholders in text
+ * @param text - Text with placeholders
+ * @param pastedBlocks - Array of pasted blocks
+ * @returns text with all placeholders expanded
+ */
+export declare function expandAllPlaceholders(text: string, pastedBlocks: PastedBlock[]): string;
+/**
+ * Validate paste settings
+ * @param settings - Paste settings to validate
+ * @returns true if valid
+ */
+export declare function validatePasteSettings(settings: any): boolean;

package/dist/utils/paste-utils.js

@@ -0,0 +1,239 @@
+/**
+ * Paste handling utilities for detecting and managing large paste operations
+ * Implements smart paste detection, collapsing, and expansion
+ */
+import { getSettingsManager } from "./settings-manager.js";
+/**
+ * Paste detection and management class
+ */
+export class PasteDetector {
+    inputBuffer = [];
+    PASTE_DETECTION_WINDOW = 100; // 100ms window
+    PASTE_THRESHOLD = 10; // 10+ chars = paste
+    accumulatedInput = "";
+    lastInputTime = 0;
+    /**
+     * Detect if input is part of a paste operation
+     * @param inputChar - Character(s) being input
+     * @returns true if paste detected
+     */
+    detectPaste(inputChar) {
+        const now = Date.now();
+        // Add to buffer
+        this.inputBuffer.push({ char: inputChar, timestamp: now });
+        // Clean old entries (older than detection window)
+        this.inputBuffer = this.inputBuffer.filter(entry => now - entry.timestamp < this.PASTE_DETECTION_WINDOW);
+        // Count total characters in window
+        const totalChars = this.inputBuffer.reduce((sum, entry) => sum + entry.char.length, 0);
+        return totalChars >= this.PASTE_THRESHOLD;
+    }
+    /**
+     * Accumulate input during paste operation
+     * @param inputChar - Character(s) being input
+     * @param timeout - Timeout to consider paste complete (ms)
+     * @returns accumulated paste content or null if still accumulating
+     */
+    accumulatePasteInput(inputChar, timeout = 50) {
+        const now = Date.now();
+        // If too much time passed, start new accumulation
+        if (now - this.lastInputTime > timeout && this.accumulatedInput) {
+            const result = this.accumulatedInput;
+            this.accumulatedInput = inputChar;
+            this.lastInputTime = now;
+            return result;
+        }
+        // Accumulate
+        this.accumulatedInput += inputChar;
+        this.lastInputTime = now;
+        return null;
+    }
+    /**
+     * Get and clear accumulated input
+     */
+    getAccumulatedInput() {
+        const result = this.accumulatedInput;
+        this.accumulatedInput = "";
+        this.lastInputTime = 0;
+        return result;
+    }
+    /**
+     * Reset detector state
+     */
+    reset() {
+        this.inputBuffer = [];
+        this.accumulatedInput = "";
+        this.lastInputTime = 0;
+    }
+}
+/**
+ * Check if pasted content should be collapsed
+ * @param content - Pasted content
+ * @returns true if should collapse
+ */
+export function shouldCollapsePaste(content) {
+    const settings = getSettingsManager();
+    const userSettings = settings.loadUserSettings();
+    // Check if auto-collapse is enabled (default: true)
+    const autoCollapse = userSettings.paste?.autoCollapse ?? true;
+    if (!autoCollapse) {
+        return false;
+    }
+    // Get collapse threshold (default: 20 lines)
+    const threshold = userSettings.paste?.collapseThreshold ?? 20;
+    // Count lines
+    const lineCount = countLines(content);
+    return lineCount >= threshold;
+}
+/**
+ * Count lines in text (handles different line endings)
+ * @param text - Text to count lines in
+ * @returns number of lines
+ */
+export function countLines(text) {
+    if (!text)
+        return 0;
+    // Normalize line endings to \n
+    const normalized = text.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+    // Count newlines + 1 (for last line without \n)
+    const newlineCount = (normalized.match(/\n/g) || []).length;
+    // If text ends with newline, don't count extra line
+    return text.endsWith('\n') || text.endsWith('\r\n') ? newlineCount : newlineCount + 1;
+}
+/**
+ * Create a pasted block from content
+ * @param id - Unique block ID
+ * @param content - Pasted content
+ * @param startPosition - Position in input where inserted
+ * @returns PastedBlock object
+ */
+export function createPastedBlock(id, content, startPosition) {
+    const settings = getSettingsManager();
+    const userSettings = settings.loadUserSettings();
+    const lineCount = countLines(content);
+    const previewLineCount = userSettings.paste?.previewLines ?? 2;
+    // Extract preview lines
+    const lines = content.split(/\r?\n/);
+    const previewLines = lines.slice(0, previewLineCount);
+    return {
+        id,
+        content,
+        lineCount,
+        collapsed: true,
+        startPosition,
+        previewLines,
+    };
+}
+/**
+ * Generate placeholder text for collapsed paste
+ * @param block - Pasted block
+ * @returns placeholder string
+ */
+export function generatePlaceholder(block) {
+    const settings = getSettingsManager();
+    const userSettings = settings.loadUserSettings();
+    const showLineCount = userSettings.paste?.showLineCount ?? true;
+    const showPreview = userSettings.paste?.showPreview ?? false;
+    let placeholder = `[Pasted text #${block.id}`;
+    if (showLineCount) {
+        placeholder += ` +${block.lineCount} lines`;
+    }
+    placeholder += `]`;
+    // Add preview if enabled
+    if (showPreview && block.previewLines.length > 0) {
+        const preview = block.previewLines
+            .map(line => line.slice(0, 60)) // Max 60 chars per line
+            .join('\n');
+        placeholder += `\n${preview}`;
+        if (block.lineCount > block.previewLines.length) {
+            placeholder += `\n... (${block.lineCount - block.previewLines.length} more lines)`;
+        }
+    }
+    return placeholder;
+}
+/**
+ * Extract placeholder ID from placeholder text
+ * @param placeholder - Placeholder text
+ * @returns block ID or null if not a placeholder
+ */
+export function extractPlaceholderId(placeholder) {
+    const match = placeholder.match(/\[Pasted text #(\d+)/);
+    return match ? parseInt(match[1], 10) : null;
+}
+/**
+ * Find pasted block at cursor position
+ * @param input - Current input text
+ * @param cursorPosition - Cursor position
+ * @param pastedBlocks - Array of pasted blocks
+ * @returns PastedBlock if cursor is on one, null otherwise
+ */
+export function findBlockAtCursor(input, cursorPosition, pastedBlocks) {
+    for (const block of pastedBlocks) {
+        // Check if block is collapsed (placeholder in input)
+        if (block.collapsed) {
+            const placeholder = generatePlaceholder(block);
+            const blockStart = input.indexOf(placeholder);
+            if (blockStart === -1)
+                continue;
+            const blockEnd = blockStart + placeholder.length;
+            if (cursorPosition >= blockStart && cursorPosition <= blockEnd) {
+                return block;
+            }
+        }
+        else {
+            // Block is expanded (full content in input)
+            const blockStart = input.indexOf(block.content);
+            if (blockStart === -1)
+                continue;
+            const blockEnd = blockStart + block.content.length;
+            if (cursorPosition >= blockStart && cursorPosition <= blockEnd) {
+                return block;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Expand all placeholders in text
+ * @param text - Text with placeholders
+ * @param pastedBlocks - Array of pasted blocks
+ * @returns text with all placeholders expanded
+ */
+export function expandAllPlaceholders(text, pastedBlocks) {
+    let result = text;
+    // Sort blocks by ID descending to replace from end to start
+    // This prevents position shifts during replacement
+    const sortedBlocks = [...pastedBlocks].sort((a, b) => b.id - a.id);
+    for (const block of sortedBlocks) {
+        const placeholder = generatePlaceholder(block);
+        result = result.replace(placeholder, block.content);
+    }
+    return result;
+}
+/**
+ * Validate paste settings
+ * @param settings - Paste settings to validate
+ * @returns true if valid
+ */
+export function validatePasteSettings(settings) {
+    if (!settings)
+        return true;
+    if (typeof settings.autoCollapse !== 'undefined' && typeof settings.autoCollapse !== 'boolean') {
+        return false;
+    }
+    if (typeof settings.collapseThreshold !== 'undefined') {
+        if (typeof settings.collapseThreshold !== 'number' ||
+            settings.collapseThreshold < 1 ||
+            settings.collapseThreshold > 100) {
+            return false;
+        }
+    }
+    if (typeof settings.previewLines !== 'undefined') {
+        if (typeof settings.previewLines !== 'number' ||
+            settings.previewLines < 0 ||
+            settings.previewLines > 10) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=paste-utils.js.map

package/dist/utils/paste-utils.js.map

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

package/dist/utils/path-security.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Path Security Utilities
+ *
+ * Provides comprehensive path validation to prevent path traversal,
+ * symlink attacks, and access to dangerous system directories (REQ-SEC-002).
+ *
+ * @module path-security
+ */
+/**
+ * Result of path validation
+ */
+export interface PathValidationResult {
+    success: boolean;
+    path?: string;
+    error?: string;
+}
+/**
+ * Options for path validation
+ */
+export interface PathValidationOptions {
+    allowSymlinks?: boolean;
+    allowedRoots?: string[];
+    checkExists?: boolean;
+}
+/**
+ * Get OS-specific dangerous paths that should never be accessed.
+ *
+ * @returns Array of dangerous path prefixes
+ */
+export declare function getDangerousPathsForOS(): string[];
+/**
+ * Get dangerous file patterns that should be blocked.
+ *
+ * @returns Array of dangerous file patterns (strings or regexes)
+ */
+export declare function getDangerousFilePatterns(): Array<string | RegExp>;
+/**
+ * Check if a path matches a dangerous file pattern.
+ *
+ * @param filePath - Path to check
+ * @returns True if file matches dangerous pattern
+ */
+export declare function isDangerousFile(filePath: string): boolean;
+/**
+ * Canonicalize a path by resolving symlinks and normalizing.
+ *
+ * @param filePath - Path to canonicalize
+ * @returns Canonicalized path or original if canonicalization fails
+ */
+export declare function canonicalizePath(filePath: string): Promise<string>;
+/**
+ * Check if a path contains symlinks in any component.
+ *
+ * @param filePath - Path to check
+ * @returns True if any component is a symlink
+ */
+export declare function containsSymlinks(filePath: string): Promise<boolean>;
+/**
+ * Validate a file path for security.
+ *
+ * Performs comprehensive checks:
+ * 1. Canonicalization (resolve symlinks)
+ * 2. Allowed root validation
+ * 3. Dangerous path blocking
+ * 4. Symlink detection
+ * 5. Dangerous file detection
+ *
+ * @param filePath - Path to validate
+ * @param options - Validation options
+ * @returns Validation result with success status and validated path
+ */
+export declare function validatePathSecure(filePath: string, options?: PathValidationOptions): Promise<PathValidationResult>;
+/**
+ * Synchronous version of validatePathSecure.
+ * Less secure (doesn't resolve symlinks), use async version when possible.
+ *
+ * @param filePath - Path to validate
+ * @param options - Validation options
+ * @returns Validation result
+ */
+export declare function validatePathSecureSync(filePath: string, options?: PathValidationOptions): PathValidationResult;
+/**
+ * Create a safe path joiner that validates the result.
+ *
+ * @param basePath - Base directory path
+ * @param relativePath - Relative path to join
+ * @param options - Validation options
+ * @returns Validated joined path or null if invalid
+ */
+export declare function safePathJoin(basePath: string, relativePath: string, options?: PathValidationOptions): Promise<string | null>;