sqlew 3.7.3 → 3.8.0

package/dist/utils/batch-validation.example.js

@@ -0,0 +1,180 @@
+/**
+ * Batch Validation Usage Examples
+ * Demonstrates how to use batch validation utilities in batch operations
+ *
+ * This file is NOT imported by production code - it's documentation only
+ */
+import { validateBatch, formatBatchValidationError, validateRequiredField, validateEnum, validateType, validateRange, validateLength, validateLayerFileRequirement } from './batch-validation.js';
+// ============================================================================
+// Example 1: Task Batch Validation
+// ============================================================================
+/**
+ * Validate single task item for batch creation
+ * This validator would be called by validateBatch() for each task
+ */
+async function validateTaskItem(task, index, adapter, errors) {
+    const identifier = task.title || `Item ${index}`;
+    // Required fields
+    validateRequiredField(task.title, 'title', index, identifier, errors);
+    // String length
+    if (task.title) {
+        validateLength(task.title, 'title', 200, index, identifier, errors);
+    }
+    // Enums
+    if (task.status) {
+        validateEnum(task.status, 'status', ['todo', 'in_progress', 'waiting_review', 'blocked', 'done', 'archived'], index, identifier, errors);
+    }
+    if (task.layer) {
+        validateEnum(task.layer, 'layer', ['presentation', 'business', 'data', 'infrastructure', 'cross-cutting',
+            'documentation', 'planning', 'coordination', 'review'], index, identifier, errors);
+    }
+    // Range validation
+    if (task.priority !== undefined) {
+        validateRange(task.priority, 'priority', 1, 4, index, identifier, errors);
+    }
+    // Type validation
+    if (task.tags !== undefined) {
+        validateType(task.tags, 'tags', 'array', index, identifier, errors);
+    }
+    // Complex field validation: file_actions
+    if (task.file_actions !== undefined) {
+        validateType(task.file_actions, 'file_actions', 'array', index, identifier, errors);
+        if (Array.isArray(task.file_actions)) {
+            task.file_actions.forEach((fa, faIndex) => {
+                if (!fa.action) {
+                    errors.push({
+                        itemIndex: index,
+                        itemIdentifier: identifier,
+                        field: `file_actions[${faIndex}].action`,
+                        issue: 'Missing action field in file_actions',
+                        fix: 'Add action field: { action: "create"|"edit"|"delete", path: "..." }',
+                        current: fa
+                    });
+                }
+                else {
+                    validateEnum(fa.action, `file_actions[${faIndex}].action`, ['create', 'edit', 'delete'], index, identifier, errors);
+                }
+                if (!fa.path || typeof fa.path !== 'string') {
+                    errors.push({
+                        itemIndex: index,
+                        itemIdentifier: identifier,
+                        field: `file_actions[${faIndex}].path`,
+                        issue: 'Missing or invalid path field in file_actions',
+                        fix: 'Add path field as string: { action: "...", path: "src/file.ts" }',
+                        current: fa
+                    });
+                }
+            });
+        }
+    }
+    // Layer-specific validation (FILE_REQUIRED vs FILE_OPTIONAL)
+    validateLayerFileRequirement(task.layer, task.file_actions, index, identifier, errors);
+}
+/**
+ * Example batch operation with pre-validation
+ */
+async function batchCreateTasksExample(params, adapter) {
+    // Basic validation
+    if (!params.tasks || !Array.isArray(params.tasks)) {
+        throw new Error('Parameter "tasks" is required and must be an array');
+    }
+    if (params.tasks.length > 50) {
+        throw new Error('Parameter "tasks" must contain at most 50 items');
+    }
+    // ✅ PRE-VALIDATION: Check ALL items BEFORE transaction
+    const validationResult = await validateBatch(params.tasks, validateTaskItem, adapter);
+    // ✅ FAIL FAST: If any validation errors, throw formatted error
+    if (!validationResult.valid) {
+        throw new Error(formatBatchValidationError(validationResult));
+    }
+    // Validation passed - proceed with transaction
+    console.log('All items valid, proceeding with batch creation...');
+    // ... existing batch creation logic
+}
+// ============================================================================
+// Example 2: Decision Batch Validation
+// ============================================================================
+/**
+ * Validate single decision item for batch set
+ */
+async function validateDecisionItem(decision, index, adapter, errors) {
+    const identifier = decision.key || `Item ${index}`;
+    // Required fields
+    validateRequiredField(decision.key, 'key', index, identifier, errors);
+    validateRequiredField(decision.value, 'value', index, identifier, errors);
+    // Enums
+    if (decision.status) {
+        validateEnum(decision.status, 'status', ['active', 'deprecated', 'draft'], index, identifier, errors);
+    }
+    if (decision.layer) {
+        validateEnum(decision.layer, 'layer', ['presentation', 'business', 'data', 'infrastructure', 'cross-cutting',
+            'documentation', 'planning', 'coordination', 'review'], index, identifier, errors);
+    }
+    // Type validation
+    if (decision.tags !== undefined) {
+        validateType(decision.tags, 'tags', 'array', index, identifier, errors);
+    }
+}
+// ============================================================================
+// Example 3: File Change Batch Validation
+// ============================================================================
+/**
+ * Validate single file change item for batch record
+ */
+async function validateFileChangeItem(fileChange, index, adapter, errors) {
+    const identifier = fileChange.file_path || `Item ${index}`;
+    // Required fields
+    validateRequiredField(fileChange.file_path, 'file_path', index, identifier, errors);
+    // Enums
+    if (fileChange.change_type) {
+        validateEnum(fileChange.change_type, 'change_type', ['created', 'modified', 'deleted'], index, identifier, errors);
+    }
+    if (fileChange.layer) {
+        validateEnum(fileChange.layer, 'layer', ['presentation', 'business', 'data', 'infrastructure', 'cross-cutting',
+            'documentation', 'planning', 'coordination', 'review'], index, identifier, errors);
+    }
+}
+// ============================================================================
+// Example 4: Error Output Examples
+// ============================================================================
+/**
+ * Example error message for batch with multiple issues
+ *
+ * Input:
+ * {
+ *   tasks: [
+ *     { title: "Task 1", layer: "busines", priority: 5 },
+ *     { layer: "presentation" },  // Missing title and file_actions
+ *     { title: "Task 3", layer: "planning" }  // Valid
+ *   ]
+ * }
+ *
+ * Output:
+ * ```
+ * Batch validation failed. Found 4 validation error(s) in 2 item(s). 1 items are valid.
+ *
+ * Item 0 (Task 1):
+ *   ❌ layer: Invalid layer: "busines"
+ *      💡 Fix: Change to "business" (closest match)
+ *      Current: "busines"
+ *      Valid: presentation, business, data, infrastructure, cross-cutting, documentation, planning, coordination, review
+ *
+ *   ❌ priority: Field "priority" must be between 1 and 4
+ *      💡 Fix: Provide a number between 1 and 4
+ *      Current: 5
+ *
+ * Item 1 (Item 1):
+ *   ❌ title: Field "title" is required but missing or empty
+ *      💡 Fix: Provide a non-empty value for "title"
+ *      Current: undefined
+ *
+ *   ❌ file_actions: Layer "presentation" requires file_actions parameter
+ *      💡 Fix: Add file_actions: [{ action: "edit", path: "src/..." }] or use [] for planning tasks
+ *      Current: undefined
+ *      Valid: Add file_actions array, Change to FILE_OPTIONAL layer (planning/coordination/review)
+ *
+ * 💡 Result: 1 valid, 2 invalid
+ * 💡 Action: Fix the 2 invalid item(s) and retry batch operation
+ * ```
+ */
+//# sourceMappingURL=batch-validation.example.js.map

package/dist/utils/batch-validation.example.js.map

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

package/dist/utils/batch-validation.js

@@ -0,0 +1,345 @@
+/**
+ * Batch Validation Utilities
+ * Pre-validates batch items BEFORE transaction to reduce failures by 70-85%
+ *
+ * Features:
+ * - Comprehensive validation (required fields, types, enums, ranges, FK references)
+ * - Reports ALL errors at once (not just first error)
+ * - AI-friendly error messages with actionable fix instructions
+ * - Reusable validators for all batch operations
+ *
+ * Usage:
+ *   const result = await validateBatch(items, validateTaskItem, adapter);
+ *   if (!result.valid) {
+ *     throw new Error(formatBatchValidationError(result));
+ *   }
+ */
+import { levenshteinDistance } from './levenshtein.js';
+import { FILE_REQUIRED_LAYERS } from '../constants.js';
+// ============================================================================
+// Core Field Validators (Reusable Building Blocks)
+// ============================================================================
+/**
+ * Validate required field exists and is non-empty
+ *
+ * @param value Field value to check
+ * @param fieldName Field name for error messages
+ * @param itemIndex Item index in batch
+ * @param itemIdentifier Item identifier (e.g., title, key)
+ * @param errors Error array to append to
+ */
+export function validateRequiredField(value, fieldName, itemIndex, itemIdentifier, errors) {
+    if (value === undefined || value === null || value === '') {
+        errors.push({
+            itemIndex,
+            itemIdentifier,
+            field: fieldName,
+            issue: `Field "${fieldName}" is required but missing or empty`,
+            fix: `Provide a non-empty value for "${fieldName}"`,
+            current: value
+        });
+    }
+}
+/**
+ * Find closest match for typo suggestions using Levenshtein distance
+ *
+ * @param value Provided value
+ * @param validOptions Valid enum values
+ * @returns Closest match or null if no good match
+ */
+function findClosestMatch(value, validOptions) {
+    let bestMatch = null;
+    let bestDistance = Infinity;
+    const lowerValue = String(value).toLowerCase();
+    for (const option of validOptions) {
+        const distance = levenshteinDistance(lowerValue, option.toLowerCase());
+        if (distance <= 2 && distance < bestDistance) {
+            bestDistance = distance;
+            bestMatch = option;
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Validate enum value (status, layer, priority, etc.)
+ * Suggests closest match using Levenshtein distance for typos
+ *
+ * @param value Value to validate
+ * @param fieldName Field name for error messages
+ * @param validOptions Valid enum values
+ * @param itemIndex Item index in batch
+ * @param itemIdentifier Item identifier
+ * @param errors Error array to append to
+ */
+export function validateEnum(value, fieldName, validOptions, itemIndex, itemIdentifier, errors) {
+    if (value === undefined)
+        return; // Optional field
+    const strValue = String(value);
+    if (!validOptions.includes(strValue)) {
+        // Suggest closest match using Levenshtein distance
+        const suggestion = findClosestMatch(strValue, validOptions);
+        errors.push({
+            itemIndex,
+            itemIdentifier,
+            field: fieldName,
+            issue: `Invalid ${fieldName}: "${value}"`,
+            fix: suggestion
+                ? `Change to "${suggestion}" (closest match)`
+                : `Use one of: ${validOptions.join(', ')}`,
+            current: value,
+            validOptions: [...validOptions]
+        });
+    }
+}
+/**
+ * Validate type (array, string, number, object)
+ *
+ * @param value Value to validate
+ * @param fieldName Field name for error messages
+ * @param expectedType Expected type
+ * @param itemIndex Item index in batch
+ * @param itemIdentifier Item identifier
+ * @param errors Error array to append to
+ */
+export function validateType(value, fieldName, expectedType, itemIndex, itemIdentifier, errors) {
+    if (value === undefined)
+        return; // Optional field
+    let isValid = false;
+    let actualType = typeof value;
+    switch (expectedType) {
+        case 'array':
+            isValid = Array.isArray(value);
+            actualType = Array.isArray(value) ? 'array' : actualType;
+            break;
+        case 'string':
+            isValid = typeof value === 'string';
+            break;
+        case 'number':
+            isValid = typeof value === 'number';
+            break;
+        case 'object':
+            isValid = typeof value === 'object' && value !== null && !Array.isArray(value);
+            break;
+    }
+    if (!isValid) {
+        errors.push({
+            itemIndex,
+            itemIdentifier,
+            field: fieldName,
+            issue: `Field "${fieldName}" must be ${expectedType}, got ${actualType}`,
+            fix: expectedType === 'array'
+                ? `Change to array format: ["item1", "item2"]`
+                : `Provide ${expectedType} value`,
+            current: value
+        });
+    }
+}
+/**
+ * Validate range (priority, numeric fields)
+ *
+ * @param value Value to validate
+ * @param fieldName Field name for error messages
+ * @param min Minimum value (inclusive)
+ * @param max Maximum value (inclusive)
+ * @param itemIndex Item index in batch
+ * @param itemIdentifier Item identifier
+ * @param errors Error array to append to
+ */
+export function validateRange(value, fieldName, min, max, itemIndex, itemIdentifier, errors) {
+    if (value === undefined)
+        return; // Optional field
+    const numValue = Number(value);
+    if (isNaN(numValue) || numValue < min || numValue > max) {
+        errors.push({
+            itemIndex,
+            itemIdentifier,
+            field: fieldName,
+            issue: `Field "${fieldName}" must be between ${min} and ${max}`,
+            fix: `Provide a number between ${min} and ${max}`,
+            current: value
+        });
+    }
+}
+/**
+ * Validate string length
+ *
+ * @param value Value to validate
+ * @param fieldName Field name for error messages
+ * @param maxLength Maximum length
+ * @param itemIndex Item index in batch
+ * @param itemIdentifier Item identifier
+ * @param errors Error array to append to
+ */
+export function validateLength(value, fieldName, maxLength, itemIndex, itemIdentifier, errors) {
+    if (value === undefined)
+        return; // Optional field
+    const strValue = String(value);
+    if (strValue.length > maxLength) {
+        errors.push({
+            itemIndex,
+            itemIdentifier,
+            field: fieldName,
+            issue: `Field "${fieldName}" exceeds maximum length of ${maxLength} characters`,
+            fix: `Shorten to ${maxLength} characters or less (currently ${strValue.length} chars)`,
+            current: value
+        });
+    }
+}
+/**
+ * Validate foreign key reference (layer, agent, tag, etc.)
+ * Requires database lookup for existence check
+ *
+ * @param value Value to validate
+ * @param fieldName Field name for error messages
+ * @param tableName Master table name (e.g., 'm_layers', 'm_agents')
+ * @param columnName Column name to check (usually 'name' or 'id')
+ * @param adapter Database adapter
+ * @param itemIndex Item index in batch
+ * @param itemIdentifier Item identifier
+ * @param errors Error array to append to
+ */
+export async function validateForeignKey(value, fieldName, tableName, columnName, adapter, itemIndex, itemIdentifier, errors) {
+    if (value === undefined)
+        return; // Optional field
+    const knex = adapter.getKnex();
+    const exists = await knex(tableName)
+        .where(columnName, value)
+        .first();
+    if (!exists) {
+        // For layers, provide valid options
+        if (tableName === 'm_layers') {
+            const validLayers = await knex('m_layers').select('name');
+            errors.push({
+                itemIndex,
+                itemIdentifier,
+                field: fieldName,
+                issue: `Invalid layer: "${value}" does not exist`,
+                fix: `Use one of: ${validLayers.map((l) => l.name).join(', ')}`,
+                current: value,
+                validOptions: validLayers.map((l) => l.name)
+            });
+        }
+        else {
+            errors.push({
+                itemIndex,
+                itemIdentifier,
+                field: fieldName,
+                issue: `Reference "${value}" not found in ${tableName}`,
+                fix: `Ensure "${value}" exists in ${tableName} before creating this item`,
+                current: value
+            });
+        }
+    }
+}
+/**
+ * Validate layer-specific constraints (FILE_REQUIRED vs FILE_OPTIONAL)
+ * FILE_REQUIRED layers must have file_actions parameter (or empty array)
+ *
+ * @param layer Layer name
+ * @param fileActions file_actions parameter value
+ * @param itemIndex Item index in batch
+ * @param itemIdentifier Item identifier
+ * @param errors Error array to append to
+ */
+export function validateLayerFileRequirement(layer, fileActions, itemIndex, itemIdentifier, errors) {
+    if (!layer)
+        return; // No layer specified, skip check
+    const fileRequiredLayers = FILE_REQUIRED_LAYERS;
+    if (fileRequiredLayers.includes(layer)) {
+        if (fileActions === undefined) {
+            errors.push({
+                itemIndex,
+                itemIdentifier,
+                field: 'file_actions',
+                issue: `Layer "${layer}" requires file_actions parameter`,
+                fix: `Add file_actions: [{ action: "edit", path: "src/..." }] or use [] for planning tasks`,
+                current: undefined,
+                validOptions: [
+                    'Add file_actions array',
+                    'Change to FILE_OPTIONAL layer (planning/coordination/review)'
+                ]
+            });
+        }
+    }
+}
+// ============================================================================
+// Batch Validation Orchestrator
+// ============================================================================
+/**
+ * Validate entire batch before transaction
+ * Returns structured result with ALL validation errors
+ *
+ * @param items Array of items to validate
+ * @param itemValidator Validator function for single item
+ * @param adapter Database adapter
+ * @returns Validation result with all errors
+ */
+export async function validateBatch(items, itemValidator, adapter) {
+    const errors = [];
+    // Validate all items (don't stop on first error)
+    for (let i = 0; i < items.length; i++) {
+        await itemValidator(items[i], i, adapter, errors);
+    }
+    // Calculate statistics
+    const invalidIndices = new Set(errors.map(e => e.itemIndex));
+    const invalidCount = invalidIndices.size;
+    const validCount = items.length - invalidCount;
+    // Generate summary
+    const summary = errors.length === 0
+        ? `All ${items.length} items are valid`
+        : `Found ${errors.length} validation error(s) in ${invalidCount} item(s). ${validCount} items are valid.`;
+    return {
+        valid: errors.length === 0,
+        errors,
+        validCount,
+        invalidCount,
+        summary
+    };
+}
+// ============================================================================
+// Error Message Formatting
+// ============================================================================
+/**
+ * Format batch validation errors for AI comprehension
+ * Returns human-readable message with actionable fix instructions
+ *
+ * @param result Batch validation result
+ * @returns Formatted error message
+ */
+export function formatBatchValidationError(result) {
+    if (result.valid) {
+        return result.summary;
+    }
+    // Group errors by item index
+    const errorsByItem = new Map();
+    for (const error of result.errors) {
+        if (!errorsByItem.has(error.itemIndex)) {
+            errorsByItem.set(error.itemIndex, []);
+        }
+        errorsByItem.get(error.itemIndex).push(error);
+    }
+    // Build formatted message
+    const lines = [];
+    lines.push(`Batch validation failed. ${result.summary}`);
+    lines.push('');
+    // List each invalid item with its errors
+    for (const [itemIndex, itemErrors] of errorsByItem.entries()) {
+        const identifier = itemErrors[0].itemIdentifier;
+        lines.push(`Item ${itemIndex} (${identifier}):`);
+        for (const error of itemErrors) {
+            lines.push(`  ❌ ${error.field}: ${error.issue}`);
+            lines.push(`     💡 Fix: ${error.fix}`);
+            if (error.current !== undefined) {
+                lines.push(`     Current: ${JSON.stringify(error.current)}`);
+            }
+            if (error.validOptions) {
+                lines.push(`     Valid: ${error.validOptions.join(', ')}`);
+            }
+            lines.push('');
+        }
+    }
+    lines.push(`💡 Result: ${result.validCount} valid, ${result.invalidCount} invalid`);
+    lines.push(`💡 Action: Fix the ${result.invalidCount} invalid item(s) and retry batch operation`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=batch-validation.js.map

package/dist/utils/batch-validation.js.map

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

package/dist/utils/exporter/export.d.ts

@@ -0,0 +1,100 @@
+/**
+ * JSON Export Utility - Data-only export for append-import
+ * Schema-less export format for merging data across sqlew databases
+ */
+import { Knex } from 'knex';
+export interface JsonExportOptions {
+    projectName?: string;
+}
+export interface JsonExport {
+    metadata: {
+        sqlew_version: string;
+        schema_version: number;
+        exported_at: string;
+        export_mode: 'single_project' | 'all_projects';
+        database_type: string;
+    };
+    version: string;
+    exported_at: string;
+    export_mode: 'single_project' | 'all_projects';
+    database_type: string;
+    project?: {
+        name: string;
+        display_name: string | null;
+        detection_source: string;
+        project_root_path: string | null;
+        created_ts: number;
+        last_active_ts: number;
+        metadata: string | null;
+    };
+    projects?: Array<{
+        name: string;
+        display_name: string | null;
+        detection_source: string;
+        project_root_path: string | null;
+        created_ts: number;
+        last_active_ts: number;
+        metadata: string | null;
+    }>;
+    master_tables: {
+        agents: Array<{
+            id: number;
+            name: string;
+            last_active_ts: number;
+        }>;
+        files: Array<{
+            id: number;
+            project_id: number;
+            path: string;
+        }>;
+        context_keys: Array<{
+            id: number;
+            key: string;
+        }>;
+        tags: Array<{
+            id: number;
+            project_id: number;
+            name: string;
+        }>;
+        scopes: Array<{
+            id: number;
+            project_id: number;
+            name: string;
+        }>;
+        constraint_categories: Array<{
+            id: number;
+            name: string;
+        }>;
+        layers: Array<{
+            id: number;
+            name: string;
+        }>;
+        task_statuses: Array<{
+            id: number;
+            name: string;
+        }>;
+    };
+    transaction_tables: {
+        decisions: any[];
+        decisions_numeric: any[];
+        decision_history: any[];
+        decision_tags: any[];
+        decision_scopes: any[];
+        decision_context: any[];
+        file_changes: any[];
+        constraints: any[];
+        constraint_tags: any[];
+        tasks: any[];
+        task_details: any[];
+        task_tags: any[];
+        task_file_links: any[];
+        task_decision_links: any[];
+        task_dependencies: any[];
+        activity_log: any[];
+    };
+}
+/**
+ * Generate JSON export from database
+ */
+export declare function generateJsonExport(knex: Knex, options?: JsonExportOptions): Promise<string>;
+//# sourceMappingURL=export.d.ts.map

package/dist/utils/exporter/export.d.ts.map

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