sqlew 3.7.4 → 3.8.0

package/dist/config/knex/enhancements/20251109000000_fix_task_file_links_unique_constraint_v3_8_0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251109000000_fix_task_file_links_unique_constraint_v3_8_0.d.ts","sourceRoot":"","sources":["../../../../src/config/knex/enhancements/20251109000000_fix_task_file_links_unique_constraint_v3_8_0.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ClD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BpD"}

package/dist/config/knex/enhancements/20251109000000_fix_task_file_links_unique_constraint_v3_8_0.js

@@ -0,0 +1,88 @@
+/**
+ * Migration: Fix t_task_file_links UNIQUE constraint (v3.8.0)
+ *
+ * Problem: t_task_file_links missing UNIQUE constraint on (project_id, task_id, file_id)
+ * Code expects: ON CONFLICT (project_id, task_id, file_id) DO NOTHING
+ * Current state: Only has auto-increment PRIMARY KEY on id
+ *
+ * Root Cause: v3.7.0 migration added project_id column but didn't update PRIMARY KEY
+ * or add UNIQUE constraint. This causes "ON CONFLICT clause does not match any
+ * PRIMARY KEY or UNIQUE constraint" error when linking files to tasks.
+ *
+ * Solution: Add UNIQUE constraint on (project_id, task_id, file_id)
+ *
+ * Idempotency: Checks if constraint/index already exists before creating
+ */
+export async function up(knex) {
+    console.log('🔧 Adding UNIQUE constraint to t_task_file_links...');
+    // Check if project_id column exists (required for this constraint)
+    const hasProjectId = await knex.schema.hasColumn('t_task_file_links', 'project_id');
+    if (!hasProjectId) {
+        console.log('✓ t_task_file_links.project_id does not exist yet, skipping (will be created later)');
+        return;
+    }
+    const client = knex.client.config.client;
+    const isSQLite = client === 'better-sqlite3' || client === 'sqlite3';
+    const isMySQL = client === 'mysql' || client === 'mysql2';
+    // Try to create unique index - if it fails because it exists, that's fine
+    try {
+        if (isSQLite || isMySQL) {
+            // SQLite and MySQL: CREATE UNIQUE INDEX
+            await knex.raw(`
+        CREATE UNIQUE INDEX idx_task_file_links_unique
+        ON t_task_file_links (project_id, task_id, file_id)
+      `);
+        }
+        else {
+            // PostgreSQL: Use Knex schema builder
+            await knex.schema.alterTable('t_task_file_links', (table) => {
+                table.unique(['project_id', 'task_id', 'file_id'], { indexName: 'idx_task_file_links_unique' });
+            });
+        }
+        console.log('✅ Added UNIQUE constraint to t_task_file_links (project_id, task_id, file_id)');
+    }
+    catch (error) {
+        // Check if error is due to index already existing
+        if (error.message && (error.message.includes('already exists') ||
+            error.message.includes('Duplicate key name') ||
+            error.message.includes('duplicate key') ||
+            error.message.includes('relation') && error.message.includes('already exists'))) {
+            console.log('✓ UNIQUE constraint already exists on t_task_file_links, skipping');
+        }
+        else {
+            // Re-throw if it's a different error
+            throw error;
+        }
+    }
+}
+export async function down(knex) {
+    console.log('🔧 Removing UNIQUE constraint from t_task_file_links...');
+    const client = knex.client.config.client;
+    const isSQLite = client === 'better-sqlite3' || client === 'sqlite3';
+    const isMySQL = client === 'mysql' || client === 'mysql2';
+    try {
+        if (isSQLite) {
+            await knex.raw('DROP INDEX IF EXISTS idx_task_file_links_unique');
+        }
+        else if (isMySQL) {
+            await knex.raw('DROP INDEX idx_task_file_links_unique ON t_task_file_links');
+        }
+        else {
+            // PostgreSQL
+            await knex.schema.alterTable('t_task_file_links', (table) => {
+                table.dropUnique(['project_id', 'task_id', 'file_id'], 'idx_task_file_links_unique');
+            });
+        }
+        console.log('✅ Removed UNIQUE constraint from t_task_file_links');
+    }
+    catch (error) {
+        if (error.message && (error.message.includes('does not exist') ||
+            error.message.includes("Can't DROP"))) {
+            console.log('✓ UNIQUE constraint does not exist, nothing to remove');
+        }
+        else {
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=20251109000000_fix_task_file_links_unique_constraint_v3_8_0.js.map

package/dist/config/knex/enhancements/20251109000000_fix_task_file_links_unique_constraint_v3_8_0.js.map

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

package/dist/config/knex/enhancements/20251109000003_token_usage_cross_db_compat_v3_7_5.d.ts

@@ -0,0 +1,24 @@
+import type { Knex } from 'knex';
+/**
+ * Migration: Token Usage Table Cross-Database Compatibility v3.7.5
+ * Date: 2025-11-09
+ * Version: v3.7.5
+ *
+ * CONTEXT:
+ * The original token usage migration (20251105000000) has MySQL/PostgreSQL compatibility issues.
+ * MySQL doesn't support `DEFAULT UNIX_TIMESTAMP()` syntax without parentheses in DEFAULT clause.
+ *
+ * This migration creates t_help_token_usage for MySQL/PostgreSQL/MariaDB with corrected syntax.
+ *
+ * CHANGES:
+ * - Creates t_help_token_usage table for non-SQLite databases
+ * - Skips on SQLite (handled by 20251105000000)
+ * - Uses application-provided timestamps instead of database defaults (simpler, more portable)
+ *
+ * IDEMPOTENCY:
+ * - Checks if table exists (skip if already created)
+ * - Checks database type (skip if SQLite)
+ */
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20251109000003_token_usage_cross_db_compat_v3_7_5.d.ts.map

package/dist/config/knex/enhancements/20251109000003_token_usage_cross_db_compat_v3_7_5.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251109000003_token_usage_cross_db_compat_v3_7_5.d.ts","sourceRoot":"","sources":["../../../../src/config/knex/enhancements/20251109000003_token_usage_cross_db_compat_v3_7_5.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDlD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBpD"}

package/dist/config/knex/enhancements/20251109000003_token_usage_cross_db_compat_v3_7_5.js

@@ -0,0 +1,79 @@
+/**
+ * Migration: Token Usage Table Cross-Database Compatibility v3.7.5
+ * Date: 2025-11-09
+ * Version: v3.7.5
+ *
+ * CONTEXT:
+ * The original token usage migration (20251105000000) has MySQL/PostgreSQL compatibility issues.
+ * MySQL doesn't support `DEFAULT UNIX_TIMESTAMP()` syntax without parentheses in DEFAULT clause.
+ *
+ * This migration creates t_help_token_usage for MySQL/PostgreSQL/MariaDB with corrected syntax.
+ *
+ * CHANGES:
+ * - Creates t_help_token_usage table for non-SQLite databases
+ * - Skips on SQLite (handled by 20251105000000)
+ * - Uses application-provided timestamps instead of database defaults (simpler, more portable)
+ *
+ * IDEMPOTENCY:
+ * - Checks if table exists (skip if already created)
+ * - Checks database type (skip if SQLite)
+ */
+export async function up(knex) {
+    const client = knex.client.config.client;
+    const isSQLite = client === 'better-sqlite3' || client === 'sqlite3';
+    // Skip on SQLite (handled by 20251105000000)
+    if (isSQLite) {
+        console.log('✓ SQLite database detected, skipping (handled by 20251105000000)');
+        return;
+    }
+    // Check if table already exists
+    const hasTable = await knex.schema.hasTable('t_help_token_usage');
+    if (hasTable) {
+        console.log('✓ t_help_token_usage table already exists, skipping');
+        return;
+    }
+    console.log(`🔧 Creating t_help_token_usage table for ${client}...`);
+    await knex.schema.createTable('t_help_token_usage', (table) => {
+        table.increments('usage_id').primary();
+        // Use VARCHAR instead of TEXT for better MySQL compatibility
+        const isMySQL = client === 'mysql' || client === 'mysql2';
+        if (isMySQL) {
+            table.string('query_type', 100).notNullable();
+            table.string('tool_name', 100).nullable();
+            table.string('action_name', 100).nullable();
+        }
+        else {
+            // PostgreSQL supports TEXT in indexes
+            table.text('query_type').notNullable();
+            table.text('tool_name').nullable();
+            table.text('action_name').nullable();
+        }
+        table.integer('estimated_tokens').notNullable();
+        table.integer('actual_chars').notNullable();
+        // No DEFAULT value - application will provide timestamp
+        // This avoids cross-database compatibility issues with timestamp functions
+        table.integer('timestamp').notNullable();
+        // Indexes for common queries
+        table.index('query_type');
+        table.index(['tool_name', 'action_name']);
+        table.index('timestamp'); // Descending handled by query ORDER BY
+    });
+    console.log('✓ t_help_token_usage table created');
+}
+export async function down(knex) {
+    const client = knex.client.config.client;
+    const isSQLite = client === 'better-sqlite3' || client === 'sqlite3';
+    if (isSQLite) {
+        console.log('✓ SQLite database detected, skipping rollback');
+        return;
+    }
+    const hasTable = await knex.schema.hasTable('t_help_token_usage');
+    if (!hasTable) {
+        console.log('✓ t_help_token_usage table does not exist, skipping');
+        return;
+    }
+    console.log('Dropping t_help_token_usage table...');
+    await knex.schema.dropTable('t_help_token_usage');
+    console.log('✓ t_help_token_usage table dropped');
+}
+//# sourceMappingURL=20251109000003_token_usage_cross_db_compat_v3_7_5.js.map

package/dist/config/knex/enhancements/20251109000003_token_usage_cross_db_compat_v3_7_5.js.map

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

package/dist/config/knex/enhancements/20251109010000_tool_cleanup_v3_8_0.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Migration: Tool Cleanup for v3.8.0
+ *
+ * Updates the help system metadata to reflect the new tool structure:
+ *
+ * Removed Tools:
+ * - stats (help queries moved to dedicated tools)
+ * - message (deprecated in v3.6.5)
+ * - config (removed from public API)
+ *
+ * Added Tools:
+ * - help (query action documentation, parameters, workflows)
+ * - example (browse and search code examples)
+ * - use_case (browse complete workflow scenarios)
+ *
+ * Updated Actions:
+ * - task: batch_create → create_batch (naming consistency)
+ * - file: added sqlite_flush action
+ *
+ * Idempotency:
+ * - Checks if changes already applied before executing
+ * - Safe to run multiple times
+ */
+import type { Knex } from 'knex';
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20251109010000_tool_cleanup_v3_8_0.d.ts.map

package/dist/config/knex/enhancements/20251109010000_tool_cleanup_v3_8_0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251109010000_tool_cleanup_v3_8_0.d.ts","sourceRoot":"","sources":["../../../../src/config/knex/enhancements/20251109010000_tool_cleanup_v3_8_0.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAyMlD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAoKpD"}

package/dist/config/knex/enhancements/20251109010000_tool_cleanup_v3_8_0.js

@@ -0,0 +1,347 @@
+/**
+ * Migration: Tool Cleanup for v3.8.0
+ *
+ * Updates the help system metadata to reflect the new tool structure:
+ *
+ * Removed Tools:
+ * - stats (help queries moved to dedicated tools)
+ * - message (deprecated in v3.6.5)
+ * - config (removed from public API)
+ *
+ * Added Tools:
+ * - help (query action documentation, parameters, workflows)
+ * - example (browse and search code examples)
+ * - use_case (browse complete workflow scenarios)
+ *
+ * Updated Actions:
+ * - task: batch_create → create_batch (naming consistency)
+ * - file: added sqlite_flush action
+ *
+ * Idempotency:
+ * - Checks if changes already applied before executing
+ * - Safe to run multiple times
+ */
+export async function up(knex) {
+    console.log('🔧 Updating help system for v3.8.0 tool cleanup...');
+    // =========================================================================
+    // 1. Remove deprecated tools from m_help_tools
+    // =========================================================================
+    const toolsToRemove = ['stats', 'message', 'config'];
+    for (const toolName of toolsToRemove) {
+        const exists = await knex('m_help_tools')
+            .where('tool_name', toolName)
+            .first();
+        if (exists) {
+            await knex('m_help_tools').where('tool_name', toolName).del();
+            console.log(`  ✓ Removed ${toolName} tool`);
+        }
+        else {
+            console.log(`  ✓ ${toolName} tool already removed`);
+        }
+    }
+    // =========================================================================
+    // 2. Add new tools to m_help_tools
+    // =========================================================================
+    const newTools = [
+        {
+            tool_name: 'help',
+            description: 'Help System - Query action documentation, parameters, and workflow guidance. Returns only requested information (80-95% token reduction vs legacy help).',
+        },
+        {
+            tool_name: 'example',
+            description: 'Example System - Browse and search code examples for sqlew tools. Returns working code snippets with explanations (token-efficient).',
+        },
+        {
+            tool_name: 'use_case',
+            description: 'Use Case Catalog - Browse and search complete workflow scenarios. Returns end-to-end workflows with executable code examples and step-by-step guidance.',
+        },
+    ];
+    for (const tool of newTools) {
+        const exists = await knex('m_help_tools')
+            .where('tool_name', tool.tool_name)
+            .first();
+        if (!exists) {
+            await knex('m_help_tools').insert(tool);
+            console.log(`  ✓ Added ${tool.tool_name} tool`);
+        }
+        else {
+            console.log(`  ✓ ${tool.tool_name} tool already exists`);
+        }
+    }
+    // =========================================================================
+    // 3. Update file tool description (add sqlite_flush)
+    // =========================================================================
+    const fileToolExists = await knex('m_help_tools')
+        .where('tool_name', 'file')
+        .first();
+    if (fileToolExists) {
+        await knex('m_help_tools')
+            .where('tool_name', 'file')
+            .update({
+            description: 'File Change Tracking - Track file modifications and database operations (SQLite only). Supports file change recording, history retrieval, lock detection, and WAL flushing for persistence.',
+        });
+        console.log('  ✓ Updated file tool description');
+    }
+    else {
+        console.log('  ⚠ file tool not found, skipping description update');
+    }
+    // =========================================================================
+    // 4. Update task tool description (batch_create → create_batch)
+    // =========================================================================
+    const taskToolExists = await knex('m_help_tools')
+        .where('tool_name', 'task')
+        .first();
+    if (taskToolExists) {
+        await knex('m_help_tools')
+            .where('tool_name', 'task')
+            .update({
+            description: 'Task Management - Create, track, and manage tasks with kanban workflow, layers, and file tracking. Supports batch operations (create_batch), dependencies, file watching, and automatic stale detection.',
+        });
+        console.log('  ✓ Updated task tool description');
+    }
+    else {
+        console.log('  ⚠ task tool not found, skipping description update');
+    }
+    // =========================================================================
+    // 5. Rename task action: batch_create → create_batch in m_help_actions
+    // =========================================================================
+    const batchCreateAction = await knex('m_help_actions')
+        .where({ tool_name: 'task', action_name: 'batch_create' })
+        .first();
+    const createBatchAction = await knex('m_help_actions')
+        .where({ tool_name: 'task', action_name: 'create_batch' })
+        .first();
+    if (batchCreateAction && !createBatchAction) {
+        // Rename batch_create to create_batch
+        await knex('m_help_actions')
+            .where({ tool_name: 'task', action_name: 'batch_create' })
+            .update({ action_name: 'create_batch' });
+        console.log('  ✓ Renamed task.batch_create → task.create_batch');
+    }
+    else if (createBatchAction) {
+        console.log('  ✓ task.create_batch already exists');
+        // Clean up old batch_create if it still exists
+        if (batchCreateAction) {
+            await knex('m_help_actions')
+                .where({ tool_name: 'task', action_name: 'batch_create' })
+                .del();
+            console.log('  ✓ Removed duplicate task.batch_create');
+        }
+    }
+    else {
+        console.log('  ⚠ Neither task.batch_create nor task.create_batch found');
+    }
+    // =========================================================================
+    // 6. Add file.sqlite_flush action if missing
+    // =========================================================================
+    const sqliteFlushAction = await knex('m_help_actions')
+        .where({ tool_name: 'file', action_name: 'sqlite_flush' })
+        .first();
+    if (!sqliteFlushAction) {
+        await knex('m_help_actions').insert({
+            tool_name: 'file',
+            action_name: 'sqlite_flush',
+            description: 'Flush WAL (Write-Ahead Log) to database file for immediate persistence. SQLite-specific operation ensuring all pending writes are committed to disk. Returns flush status and checkpoint info.',
+        });
+        console.log('  ✓ Added file.sqlite_flush action');
+    }
+    else {
+        console.log('  ✓ file.sqlite_flush action already exists');
+    }
+    // =========================================================================
+    // 7. Update references in t_help_action_examples (batch_create → create_batch)
+    // =========================================================================
+    // Get action_id for the renamed action (if it exists)
+    const renamedAction = await knex('m_help_actions')
+        .where({ tool_name: 'task', action_name: 'create_batch' })
+        .first();
+    if (renamedAction) {
+        // Update example_code that mentions batch_create
+        const examplesWithBatchCreate = await knex('t_help_action_examples')
+            .where('example_code', 'like', '%batch_create%')
+            .orWhere('example_title', 'like', '%batch_create%')
+            .orWhere('explanation', 'like', '%batch_create%');
+        if (examplesWithBatchCreate.length > 0) {
+            for (const example of examplesWithBatchCreate) {
+                await knex('t_help_action_examples')
+                    .where('example_id', example.example_id)
+                    .update({
+                    example_code: example.example_code?.replace(/batch_create/g, 'create_batch'),
+                    example_title: example.example_title?.replace(/batch_create/g, 'create_batch'),
+                    explanation: example.explanation?.replace(/batch_create/g, 'create_batch'),
+                });
+            }
+            console.log(`  ✓ Updated ${examplesWithBatchCreate.length} examples (batch_create → create_batch)`);
+        }
+        else {
+            console.log('  ✓ No examples referencing batch_create found');
+        }
+    }
+    // =========================================================================
+    // 8. Update references in t_help_use_cases (batch_create → create_batch)
+    // =========================================================================
+    const useCasesWithBatchCreate = await knex('t_help_use_cases')
+        .where('description', 'like', '%batch_create%')
+        .orWhere('full_example', 'like', '%batch_create%')
+        .orWhere('action_sequence', 'like', '%batch_create%')
+        .orWhere('title', 'like', '%batch_create%');
+    if (useCasesWithBatchCreate.length > 0) {
+        for (const useCase of useCasesWithBatchCreate) {
+            await knex('t_help_use_cases')
+                .where('use_case_id', useCase.use_case_id)
+                .update({
+                title: useCase.title?.replace(/batch_create/g, 'create_batch'),
+                description: useCase.description?.replace(/batch_create/g, 'create_batch'),
+                full_example: useCase.full_example?.replace(/batch_create/g, 'create_batch'),
+                action_sequence: useCase.action_sequence?.replace(/batch_create/g, 'create_batch'),
+            });
+        }
+        console.log(`  ✓ Updated ${useCasesWithBatchCreate.length} use cases (batch_create → create_batch)`);
+    }
+    else {
+        console.log('  ✓ No use cases referencing batch_create found');
+    }
+    console.log('✅ Tool cleanup migration completed successfully');
+}
+export async function down(knex) {
+    console.log('🔧 Reverting v3.8.0 tool cleanup...');
+    // =========================================================================
+    // 1. Restore removed tools
+    // =========================================================================
+    const toolsToRestore = [
+        {
+            tool_name: 'stats',
+            description: 'Statistics & Utilities - View stats, activity logs, manage data cleanup, and access help system. Provides database statistics, layer summaries, activity history, and granular help queries with 60-70% token reduction.',
+        },
+        {
+            tool_name: 'message',
+            description: 'Agent Messaging - Send messages between agents with priority levels and read tracking. Enables asynchronous communication and coordination in multi-agent workflows with priority-based filtering.',
+        },
+        {
+            tool_name: 'config',
+            description: 'Configuration - Manage auto-deletion settings with weekend-aware retention. Control message and file history retention periods with support for skipping weekends in cleanup calculations.',
+        },
+    ];
+    for (const tool of toolsToRestore) {
+        const exists = await knex('m_help_tools')
+            .where('tool_name', tool.tool_name)
+            .first();
+        if (!exists) {
+            await knex('m_help_tools').insert(tool);
+            console.log(`  ✓ Restored ${tool.tool_name} tool`);
+        }
+        else {
+            console.log(`  ✓ ${tool.tool_name} tool already exists`);
+        }
+    }
+    // =========================================================================
+    // 2. Remove new tools
+    // =========================================================================
+    const toolsToRemove = ['help', 'example', 'use_case'];
+    for (const toolName of toolsToRemove) {
+        const exists = await knex('m_help_tools')
+            .where('tool_name', toolName)
+            .first();
+        if (exists) {
+            await knex('m_help_tools').where('tool_name', toolName).del();
+            console.log(`  ✓ Removed ${toolName} tool`);
+        }
+        else {
+            console.log(`  ✓ ${toolName} tool already removed`);
+        }
+    }
+    // =========================================================================
+    // 3. Restore original file tool description
+    // =========================================================================
+    const fileToolExists = await knex('m_help_tools')
+        .where('tool_name', 'file')
+        .first();
+    if (fileToolExists) {
+        await knex('m_help_tools')
+            .where('tool_name', 'file')
+            .update({
+            description: 'File Change Tracking - Track file changes with layer classification and lock detection. Maintain change history, prevent concurrent edit conflicts, and associate file modifications with architecture layers.',
+        });
+        console.log('  ✓ Restored file tool description');
+    }
+    // =========================================================================
+    // 4. Restore original task tool description
+    // =========================================================================
+    const taskToolExists = await knex('m_help_tools')
+        .where('tool_name', 'task')
+        .first();
+    if (taskToolExists) {
+        await knex('m_help_tools')
+            .where('tool_name', 'task')
+            .update({
+            description: 'Kanban Task Watcher - AI-optimized task management with auto-stale detection. Create, track, and coordinate development tasks with metadata, dependencies, and automatic file watching. Features status validation and flat hierarchy for AI simplicity.',
+        });
+        console.log('  ✓ Restored task tool description');
+    }
+    // =========================================================================
+    // 5. Rename task action: create_batch → batch_create
+    // =========================================================================
+    const createBatchAction = await knex('m_help_actions')
+        .where({ tool_name: 'task', action_name: 'create_batch' })
+        .first();
+    if (createBatchAction) {
+        await knex('m_help_actions')
+            .where({ tool_name: 'task', action_name: 'create_batch' })
+            .update({ action_name: 'batch_create' });
+        console.log('  ✓ Renamed task.create_batch → task.batch_create');
+    }
+    // =========================================================================
+    // 6. Remove file.sqlite_flush action
+    // =========================================================================
+    const sqliteFlushAction = await knex('m_help_actions')
+        .where({ tool_name: 'file', action_name: 'sqlite_flush' })
+        .first();
+    if (sqliteFlushAction) {
+        await knex('m_help_actions')
+            .where({ tool_name: 'file', action_name: 'sqlite_flush' })
+            .del();
+        console.log('  ✓ Removed file.sqlite_flush action');
+    }
+    // =========================================================================
+    // 7. Restore references in examples (create_batch → batch_create)
+    // =========================================================================
+    const examplesWithCreateBatch = await knex('t_help_action_examples')
+        .where('example_code', 'like', '%create_batch%')
+        .orWhere('example_title', 'like', '%create_batch%')
+        .orWhere('explanation', 'like', '%create_batch%');
+    if (examplesWithCreateBatch.length > 0) {
+        for (const example of examplesWithCreateBatch) {
+            await knex('t_help_action_examples')
+                .where('example_id', example.example_id)
+                .update({
+                example_code: example.example_code?.replace(/create_batch/g, 'batch_create'),
+                example_title: example.example_title?.replace(/create_batch/g, 'batch_create'),
+                explanation: example.explanation?.replace(/create_batch/g, 'batch_create'),
+            });
+        }
+        console.log(`  ✓ Restored ${examplesWithCreateBatch.length} examples (create_batch → batch_create)`);
+    }
+    // =========================================================================
+    // 8. Restore references in use cases (create_batch → batch_create)
+    // =========================================================================
+    const useCasesWithCreateBatch = await knex('t_help_use_cases')
+        .where('description', 'like', '%create_batch%')
+        .orWhere('full_example', 'like', '%create_batch%')
+        .orWhere('action_sequence', 'like', '%create_batch%')
+        .orWhere('title', 'like', '%create_batch%');
+    if (useCasesWithCreateBatch.length > 0) {
+        for (const useCase of useCasesWithCreateBatch) {
+            await knex('t_help_use_cases')
+                .where('use_case_id', useCase.use_case_id)
+                .update({
+                title: useCase.title?.replace(/create_batch/g, 'batch_create'),
+                description: useCase.description?.replace(/create_batch/g, 'batch_create'),
+                full_example: useCase.full_example?.replace(/create_batch/g, 'batch_create'),
+                action_sequence: useCase.action_sequence?.replace(/create_batch/g, 'batch_create'),
+            });
+        }
+        console.log(`  ✓ Restored ${useCasesWithCreateBatch.length} use cases (create_batch → batch_create)`);
+    }
+    console.log('✅ Tool cleanup revert completed successfully');
+}
+//# sourceMappingURL=20251109010000_tool_cleanup_v3_8_0.js.map

package/dist/config/knex/enhancements/20251109010000_tool_cleanup_v3_8_0.js.map

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

package/dist/config/knex/enhancements/20251109020000_fix_missing_help_actions_v3_8_0.d.ts

@@ -0,0 +1,30 @@
+import type { Knex } from 'knex';
+/**
+ * Migration: Fix Missing Help Actions (v3.8.0)
+ *
+ * CRITICAL BUG FIX: The help database (m_help_actions table) is severely out of sync
+ * with the actual tool implementations. This causes the help system to lie to users
+ * about what actions are available.
+ *
+ * Issue discovered: When trying to use decision.set_batch, it was rejected as
+ * "Action not found" by help system, but the action exists in code and works correctly.
+ *
+ * Root Cause: Original seed migration (20251025100000) did not seed all actions.
+ * Tool cleanup migration (20251109010000) updated some but not all missing actions.
+ *
+ * Missing Actions by Tool:
+ * - decision: 9 actions (quick_set, search_advanced, set_batch, has_updates,
+ *   set_from_template, create_template, list_templates, hard_delete, use_case)
+ * - task: 14 actions (update, get, list, move, link, archive, create_batch,
+ *   add_dependency, remove_dependency, get_dependencies, watch_files,
+ *   get_pruned_files, link_pruned_file, watcher, use_case)
+ * - constraint: 1 action (use_case)
+ * - file: 0 actions (all present after tool cleanup migration)
+ *
+ * This migration adds all missing actions with proper descriptions.
+ *
+ * Idempotency: Checks for existing actions before inserting.
+ */
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20251109020000_fix_missing_help_actions_v3_8_0.d.ts.map

package/dist/config/knex/enhancements/20251109020000_fix_missing_help_actions_v3_8_0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251109020000_fix_missing_help_actions_v3_8_0.d.ts","sourceRoot":"","sources":["../../../../src/config/knex/enhancements/20251109020000_fix_missing_help_actions_v3_8_0.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAyLlD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCpD"}