sqlew 3.6.9 → 3.7.0

package/dist/tests/migration-idempotency.test.js

@@ -0,0 +1,330 @@
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import knex from 'knex';
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * Migration Idempotency Tests
+ *
+ * Tests that all migrations can be safely run multiple times without errors.
+ * This validates idempotency checks in migration code and catches errors like:
+ * - "duplicate column name"
+ * - "table already exists"
+ * - "UNIQUE constraint failed"
+ * - "index already exists"
+ *
+ * Critical Scenarios:
+ * - Running same migration twice
+ * - Partial schema states (some objects exist, others don't)
+ * - knex_migrations table mismatch (schema exists but migration not recorded)
+ * - Migration recovery after error
+ */
+describe('Migration Idempotency Tests', () => {
+    let testDbPath;
+    let db;
+    before(async () => {
+        // Create temporary test database directory
+        const tmpDir = path.join(process.cwd(), '.tmp-test-idempotency');
+        await fs.mkdir(tmpDir, { recursive: true });
+        testDbPath = path.join(tmpDir, 'idempotency-test.db');
+    });
+    after(async () => {
+        // Cleanup
+        if (db) {
+            await db.destroy();
+        }
+        try {
+            await fs.unlink(testDbPath);
+        }
+        catch (error) {
+            // Ignore if file doesn't exist
+        }
+    });
+    /**
+     * Test: Bootstrap Migrations Idempotency
+     *
+     * Tests that all bootstrap migrations can be run twice without errors.
+     */
+    it('should allow running bootstrap migrations twice', async () => {
+        console.log('    🔄 Testing bootstrap migration idempotency...');
+        // Remove existing database
+        try {
+            await fs.unlink(testDbPath);
+        }
+        catch (error) {
+            // Ignore if doesn't exist
+        }
+        // Initialize database
+        db = knex({
+            client: 'better-sqlite3',
+            connection: {
+                filename: testDbPath,
+            },
+            useNullAsDefault: true,
+            migrations: {
+                directory: path.join(process.cwd(), 'dist/config/knex'),
+                loadExtensions: ['.js'],
+            },
+        });
+        const bootstrapMigrations = [
+            '20251025020452_create_master_tables',
+            '20251025021152_create_transaction_tables',
+            '20251025021351_create_indexes',
+            '20251025021416_seed_master_data',
+            '20251025070349_create_views',
+        ];
+        // Run migrations first time
+        for (const migrationName of bootstrapMigrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'bootstrap', `${migrationName}.js`);
+            const migration = await import(migrationPath);
+            await migration.up(db);
+            console.log(`      ✓ Applied ${migrationName} (1st run)`);
+        }
+        // Run migrations second time - should skip with idempotency checks
+        for (const migrationName of bootstrapMigrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'bootstrap', `${migrationName}.js`);
+            // Clear require cache to force re-import
+            const cacheBuster = `?t=${Date.now()}`;
+            const migration = await import(migrationPath + cacheBuster);
+            // Should not throw errors
+            await migration.up(db);
+            console.log(`      ✓ Re-ran ${migrationName} (2nd run - idempotent)`);
+        }
+        // Verify schema is intact
+        const tables = await db.raw(`SELECT name FROM sqlite_master WHERE type='table' ORDER BY name`);
+        const tableNames = tables.map((t) => t.name);
+        assert.ok(tableNames.includes('m_agents'), 'Should have m_agents table');
+        assert.ok(tableNames.includes('t_decisions'), 'Should have t_decisions table');
+        assert.ok(tableNames.includes('t_tasks'), 'Should have t_tasks table');
+        console.log(`    ✅ Bootstrap migrations are idempotent`);
+    });
+    /**
+     * Test: Enhancement Migrations Idempotency
+     *
+     * Tests that all enhancement migrations can be run twice without errors.
+     * This specifically catches the errors user encountered:
+     * - "duplicate column name: link_type"
+     * - "table m_help_tools already exists"
+     * - "UNIQUE constraint failed"
+     */
+    it('should allow running enhancement migrations twice', async () => {
+        console.log('    🔄 Testing enhancement migration idempotency...');
+        const enhancementMigrations = [
+            '20251025081221_add_link_type_to_task_decision_links',
+            '20251025082220_fix_task_dependencies_columns',
+            '20251025090000_create_help_system_tables',
+            '20251025090100_seed_help_categories_and_use_cases',
+            '20251025100000_seed_help_metadata',
+            '20251025100100_seed_remaining_use_cases',
+            '20251025120000_add_cascade_to_task_dependencies',
+            '20251027000000_add_agent_reuse_system',
+            '20251027010000_add_task_constraint_to_decision_context',
+            '20251027020000_update_agent_reusability',
+            '20251028000000_simplify_agent_system',
+            '20251031000000_drop_orphaned_message_view',
+        ];
+        // Run migrations first time
+        for (const migrationName of enhancementMigrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'enhancements', `${migrationName}.js`);
+            const migration = await import(migrationPath);
+            await migration.up(db);
+            console.log(`      ✓ Applied ${migrationName} (1st run)`);
+        }
+        // Run migrations second time - should skip with idempotency checks
+        for (const migrationName of enhancementMigrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'enhancements', `${migrationName}.js`);
+            // Clear require cache
+            const cacheBuster = `?t=${Date.now()}`;
+            const migration = await import(migrationPath + cacheBuster);
+            // Should not throw errors (this is where user's errors occurred)
+            await migration.up(db);
+            console.log(`      ✓ Re-ran ${migrationName} (2nd run - idempotent)`);
+        }
+        // Verify v3.6 schema
+        const tables = await db.raw(`SELECT name FROM sqlite_master WHERE type='table' ORDER BY name`);
+        const tableNames = tables.map((t) => t.name);
+        assert.ok(tableNames.includes('m_help_tools'), 'Should have help tables');
+        // Verify link_type column exists (user's "duplicate column name" error)
+        const hasLinkType = await db.schema.hasColumn('t_task_decision_links', 'link_type');
+        assert.ok(hasLinkType, 'Should have link_type column');
+        console.log(`    ✅ Enhancement migrations are idempotent`);
+    });
+    /**
+     * Test: Upgrade Migrations Idempotency
+     *
+     * Tests that all upgrade migrations can be run twice without errors.
+     * Note: v3.7.0 migrations were consolidated into a single migration.
+     */
+    it('should allow running upgrade migrations twice', async () => {
+        console.log('    🔄 Testing upgrade migration idempotency...');
+        const upgradeMigrations = [
+            '20251104000000_add_multi_project_v3_7_0',
+        ];
+        // Run migrations first time
+        for (const migrationName of upgradeMigrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'upgrades', `${migrationName}.js`);
+            const migration = await import(migrationPath);
+            await migration.up(db);
+            console.log(`      ✓ Applied ${migrationName} (1st run)`);
+        }
+        // Run migrations second time - should skip with idempotency checks
+        for (const migrationName of upgradeMigrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'upgrades', `${migrationName}.js`);
+            // Clear require cache
+            const cacheBuster = `?t=${Date.now()}`;
+            const migration = await import(migrationPath + cacheBuster);
+            // Should not throw errors
+            await migration.up(db);
+            console.log(`      ✓ Re-ran ${migrationName} (2nd run - idempotent)`);
+        }
+        // Verify v3.7 schema
+        const tables = await db.raw(`SELECT name FROM sqlite_master WHERE type='table' ORDER BY name`);
+        const tableNames = tables.map((t) => t.name);
+        assert.ok(tableNames.includes('m_projects'), 'Should have m_projects table');
+        // Verify project_id column exists
+        const hasProjectId = await db.schema.hasColumn('t_decisions', 'project_id');
+        assert.ok(hasProjectId, 'Should have project_id column in t_decisions');
+        console.log(`    ✅ Upgrade migrations are idempotent`);
+    });
+    /**
+     * Test: m_config Structure Validation
+     *
+     * Tests that m_config table has correct PRIMARY KEY structure after consolidated migration.
+     * Note: m_config enhancement logic was merged into the consolidated v3.7.0 migration.
+     */
+    it('should have correct m_config structure after consolidated migration', async () => {
+        console.log('    🔍 Validating m_config structure...');
+        // Verify m_config structure (user's "nullable PRIMARY KEY" error should be fixed)
+        const configSchema = await db.raw(`SELECT sql FROM sqlite_master WHERE type='table' AND name='m_config'`);
+        const configSql = configSchema[0]?.sql || '';
+        assert.ok(configSql.includes('primary key (`key`)'), 'm_config should have single-column PRIMARY KEY');
+        assert.ok(!configSql.includes('primary key (`key`, `project_id`)'), 'm_config should NOT have composite PRIMARY KEY');
+        // Verify project_id column exists and is nullable
+        const hasProjectId = await db.schema.hasColumn('m_config', 'project_id');
+        assert.ok(hasProjectId, 'm_config should have project_id column');
+        console.log(`    ✅ m_config structure is correct (single-column PRIMARY KEY, nullable project_id)`);
+    });
+    /**
+     * Test: Partial Schema State Recovery
+     *
+     * Simulates user's scenario: database has schema objects but knex_migrations
+     * table doesn't record all migrations. Tests that migrations can detect
+     * existing objects and skip gracefully.
+     */
+    it('should handle partial schema states (missing knex_migrations records)', async () => {
+        console.log('    🔄 Testing partial schema state recovery...');
+        // Simulate user's scenario: delete knex_migrations table
+        // (schema exists, but Knex thinks migrations weren't run)
+        await db.schema.dropTableIfExists('knex_migrations');
+        await db.schema.dropTableIfExists('knex_migrations_lock');
+        console.log(`      ⚠️  Simulated missing knex_migrations table`);
+        // Re-run all migrations - should skip existing objects
+        // Note: v3.7.0 migrations were consolidated into a single migration
+        const allMigrations = [
+            // Bootstrap
+            { folder: 'bootstrap', name: '20251025020452_create_master_tables' },
+            { folder: 'bootstrap', name: '20251025021152_create_transaction_tables' },
+            { folder: 'bootstrap', name: '20251025021351_create_indexes' },
+            { folder: 'bootstrap', name: '20251025021416_seed_master_data' },
+            { folder: 'bootstrap', name: '20251025070349_create_views' },
+            // Enhancements
+            { folder: 'enhancements', name: '20251025081221_add_link_type_to_task_decision_links' },
+            { folder: 'enhancements', name: '20251025082220_fix_task_dependencies_columns' },
+            { folder: 'enhancements', name: '20251025090000_create_help_system_tables' },
+            { folder: 'enhancements', name: '20251025090100_seed_help_categories_and_use_cases' },
+            { folder: 'enhancements', name: '20251025100000_seed_help_metadata' },
+            { folder: 'enhancements', name: '20251025120000_add_cascade_to_task_dependencies' },
+            { folder: 'enhancements', name: '20251027000000_add_agent_reuse_system' },
+            { folder: 'enhancements', name: '20251027020000_update_agent_reusability' },
+            { folder: 'enhancements', name: '20251028000000_simplify_agent_system' },
+            { folder: 'enhancements', name: '20251031000000_drop_orphaned_message_view' },
+            // Upgrades - v3.7.0 consolidated migration
+            { folder: 'upgrades', name: '20251104000000_add_multi_project_v3_7_0' },
+        ];
+        for (const { folder, name } of allMigrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', folder, `${name}.js`);
+            const cacheBuster = `?t=${Date.now()}`;
+            const migration = await import(migrationPath + cacheBuster);
+            // Should not throw errors - idempotency checks should skip existing objects
+            await migration.up(db);
+            console.log(`      ✓ Recovered ${name}`);
+        }
+        // Verify schema is still intact
+        const tables = await db.raw(`SELECT name FROM sqlite_master WHERE type='table' ORDER BY name`);
+        const tableNames = tables.map((t) => t.name);
+        assert.ok(tableNames.includes('m_projects'), 'Should still have m_projects');
+        assert.ok(tableNames.includes('m_help_tools'), 'Should still have help tables');
+        assert.ok(tableNames.includes('t_decisions'), 'Should still have t_decisions');
+        console.log(`    ✅ Partial schema state recovery successful`);
+    });
+    /**
+     * Test: Data Preservation During Re-runs
+     *
+     * Tests that data is not lost or duplicated when migrations run twice.
+     */
+    it('should preserve data when migrations run twice', async () => {
+        console.log('    📝 Testing data preservation during re-runs...');
+        // Insert test data
+        const now = Math.floor(Date.now() / 1000);
+        await db('m_context_keys').insert({
+            id: 888,
+            key: 'test-idempotency-key',
+        });
+        await db('t_decisions').insert({
+            key_id: 888,
+            project_id: 1,
+            value: 'test value should not duplicate',
+            ts: now,
+        });
+        // Count decisions before re-run
+        const countBefore = await db('t_decisions').where({ key_id: 888 }).count('* as count').first();
+        assert.strictEqual(countBefore?.count, 1, 'Should have 1 decision before re-run');
+        // Re-run a few migrations
+        const testMigrations = [
+            { folder: 'enhancements', name: '20251025090000_create_help_system_tables' },
+            { folder: 'enhancements', name: '20251025090100_seed_help_categories_and_use_cases' },
+        ];
+        for (const { folder, name } of testMigrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', folder, `${name}.js`);
+            const cacheBuster = `?t=${Date.now()}`;
+            const migration = await import(migrationPath + cacheBuster);
+            await migration.up(db);
+        }
+        // Verify data still exists and wasn't duplicated
+        const countAfter = await db('t_decisions').where({ key_id: 888 }).count('* as count').first();
+        assert.strictEqual(countAfter?.count, 1, 'Should still have 1 decision after re-run');
+        const decision = await db('t_decisions').where({ key_id: 888 }).first();
+        assert.strictEqual(decision?.value, 'test value should not duplicate', 'Data should be preserved');
+        console.log(`    ✅ Data preservation verified`);
+    });
+    /**
+     * Test: down() Migration Idempotency
+     *
+     * Tests that down() migrations can be run safely (for rollback scenarios).
+     */
+    it('should allow running down() migrations safely', async () => {
+        console.log('    🔄 Testing down() migration idempotency...');
+        // Test down() migrations that were fixed
+        const testDownMigrations = [
+            { folder: 'enhancements', name: '20251028000000_simplify_agent_system' },
+            { folder: 'enhancements', name: '20251031000000_drop_orphaned_message_view' },
+        ];
+        for (const { folder, name } of testDownMigrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', folder, `${name}.js`);
+            const migration = await import(migrationPath);
+            // Run down() first time
+            await migration.down(db);
+            console.log(`      ✓ Rolled back ${name} (1st run)`);
+            // Run down() second time - should skip existing objects
+            const cacheBuster = `?t=${Date.now()}`;
+            const migration2 = await import(migrationPath + cacheBuster);
+            await migration2.down(db);
+            console.log(`      ✓ Re-ran rollback ${name} (2nd run - idempotent)`);
+            // Run up() again to restore state
+            await migration.up(db);
+            console.log(`      ✓ Restored ${name}`);
+        }
+        console.log(`    ✅ down() migrations are idempotent`);
+    });
+});
+//# sourceMappingURL=migration-idempotency.test.js.map

package/dist/tests/migration-idempotency.test.js.map

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

package/dist/tests/migration-upgrade-paths.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=migration-upgrade-paths.test.d.ts.map

package/dist/tests/migration-upgrade-paths.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-upgrade-paths.test.d.ts","sourceRoot":"","sources":["../../src/tests/migration-upgrade-paths.test.ts"],"names":[],"mappings":""}

package/dist/tests/migration-upgrade-paths.test.js

@@ -0,0 +1,248 @@
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import knex from 'knex';
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * Migration Upgrade Path Tests
+ *
+ * Tests incremental version upgrades to catch migration errors that only
+ * appear when upgrading from older versions (not fresh installations).
+ *
+ * Critical Scenarios:
+ * - v3.5 → v3.6 (help system tables added)
+ * - v3.6 → v3.7 (multi-project support added)
+ * - v3.5 → v3.7 (direct upgrade path)
+ * - Failed migration recovery (run again after error)
+ *
+ * These tests validate idempotency and catch errors like:
+ * - "duplicate column name"
+ * - "table already exists"
+ * - "UNIQUE constraint failed"
+ */
+describe('Migration Upgrade Path Tests', () => {
+    let testDbPath;
+    let db;
+    before(async () => {
+        // Create temporary test database directory
+        const tmpDir = path.join(process.cwd(), '.tmp-test-migrations');
+        await fs.mkdir(tmpDir, { recursive: true });
+        testDbPath = path.join(tmpDir, 'upgrade-test.db');
+    });
+    after(async () => {
+        // Cleanup
+        if (db) {
+            await db.destroy();
+        }
+        try {
+            await fs.unlink(testDbPath);
+        }
+        catch (error) {
+            // Ignore if file doesn't exist
+        }
+    });
+    /**
+     * Test: Fresh v3.5 Installation
+     *
+     * Creates a v3.5 schema to use as baseline for upgrade tests.
+     * Runs all migrations up to (but not including) v3.6.0 help system.
+     */
+    it('should create v3.5 schema from migrations', async () => {
+        console.log('    📦 Creating v3.5 baseline schema...');
+        // Remove existing database
+        try {
+            await fs.unlink(testDbPath);
+        }
+        catch (error) {
+            // Ignore if doesn't exist
+        }
+        // Initialize database
+        db = knex({
+            client: 'better-sqlite3',
+            connection: {
+                filename: testDbPath,
+            },
+            useNullAsDefault: true,
+            migrations: {
+                directory: path.join(process.cwd(), 'dist/config/knex'),
+                loadExtensions: ['.js'],
+            },
+        });
+        // Run migrations up to v3.5 (before help system and multi-project)
+        // List of migrations to run for v3.5:
+        const v3_5_migrations = [
+            // Bootstrap
+            '20251025020452_create_master_tables',
+            '20251025021152_create_transaction_tables',
+            '20251025021351_create_indexes',
+            '20251025021416_seed_master_data',
+            '20251025070349_create_views',
+            // Enhancements
+            '20251025081221_add_link_type_to_task_decision_links',
+            '20251025082220_fix_task_dependencies_columns',
+            '20251025120000_add_cascade_to_task_dependencies',
+        ];
+        // Run specific migrations by manually executing them
+        for (const migrationName of v3_5_migrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'enhancements', `${migrationName}.js`);
+            // Check if file exists in enhancements folder
+            try {
+                await fs.access(migrationPath);
+                const migration = await import(migrationPath);
+                await migration.up(db);
+                console.log(`      ✓ Applied ${migrationName}`);
+            }
+            catch (error) {
+                // Try bootstrap folder
+                const bootstrapPath = path.join(process.cwd(), 'dist/config/knex', 'bootstrap', `${migrationName}.js`);
+                try {
+                    await fs.access(bootstrapPath);
+                    const migration = await import(bootstrapPath);
+                    await migration.up(db);
+                    console.log(`      ✓ Applied ${migrationName}`);
+                }
+                catch (bootstrapError) {
+                    console.error(`      ❌ Failed to find migration: ${migrationName}`);
+                    throw bootstrapError;
+                }
+            }
+        }
+        // Verify v3.5 schema
+        const tables = await db.raw(`SELECT name FROM sqlite_master WHERE type='table' ORDER BY name`);
+        const tableNames = tables.map((t) => t.name);
+        assert.ok(tableNames.includes('m_agents'), 'Should have m_agents table');
+        assert.ok(tableNames.includes('t_decisions'), 'Should have t_decisions table');
+        assert.ok(tableNames.includes('t_tasks'), 'Should have t_tasks table');
+        assert.ok(!tableNames.includes('m_help_tools'), 'Should NOT have help tables in v3.5');
+        assert.ok(!tableNames.includes('m_projects'), 'Should NOT have m_projects in v3.5');
+        console.log(`    ✅ v3.5 baseline created (${tableNames.length} tables)`);
+    });
+    /**
+     * Test: v3.5 → v3.6 Upgrade
+     *
+     * Tests upgrade from v3.5 to v3.6 (help system added).
+     * This should catch errors like:
+     * - "table m_help_tools already exists"
+     * - "UNIQUE constraint failed on help metadata"
+     */
+    it('should upgrade from v3.5 to v3.6 without errors', async () => {
+        console.log('    🔄 Upgrading v3.5 → v3.6...');
+        // Apply v3.6 migrations (help system)
+        const v3_6_migrations = [
+            '20251025090000_create_help_system_tables',
+            '20251025090100_seed_help_categories_and_use_cases',
+            '20251025100000_seed_help_metadata',
+            '20251025100100_seed_remaining_use_cases',
+            '20251027000000_add_agent_reuse_system',
+            '20251027010000_add_task_constraint_to_decision_context',
+            '20251027020000_update_agent_reusability',
+            '20251028000000_simplify_agent_system',
+            '20251031000000_drop_orphaned_message_view',
+        ];
+        for (const migrationName of v3_6_migrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'enhancements', `${migrationName}.js`);
+            const migration = await import(migrationPath);
+            await migration.up(db);
+            console.log(`      ✓ Applied ${migrationName}`);
+        }
+        // Verify v3.6 schema
+        const tables = await db.raw(`SELECT name FROM sqlite_master WHERE type='table' ORDER BY name`);
+        const tableNames = tables.map((t) => t.name);
+        assert.ok(tableNames.includes('m_help_tools'), 'Should have m_help_tools after v3.6');
+        assert.ok(tableNames.includes('m_help_actions'), 'Should have m_help_actions after v3.6');
+        assert.ok(!tableNames.includes('t_agent_messages'), 'Should NOT have t_agent_messages (dropped in v3.6.5)');
+        // Check help metadata was seeded
+        const toolCount = await db('m_help_tools').count('* as count').first();
+        assert.ok(toolCount && Number(toolCount.count) > 0, 'Should have seeded help tools');
+        console.log(`    ✅ v3.6 upgrade successful (${tableNames.length} tables)`);
+    });
+    /**
+     * Test: v3.6 → v3.7 Upgrade
+     *
+     * Tests upgrade from v3.6 to v3.7 (multi-project support added).
+     * This should catch errors like:
+     * - "duplicate column name: project_id"
+     * - "All parts of PRIMARY KEY must be NOT NULL"
+     */
+    it('should upgrade from v3.6 to v3.7 without errors', async () => {
+        console.log('    🔄 Upgrading v3.6 → v3.7...');
+        // Apply v3.7 consolidated migration (multi-project support)
+        // Note: 4 separate migrations were consolidated into 1 for v3.7.0
+        const v3_7_migrations = [
+            '20251104000000_add_multi_project_v3_7_0',
+        ];
+        for (const migrationName of v3_7_migrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'upgrades', `${migrationName}.js`);
+            const migration = await import(migrationPath);
+            await migration.up(db);
+            console.log(`      ✓ Applied ${migrationName}`);
+        }
+        // Verify v3.7 schema
+        const tables = await db.raw(`SELECT name FROM sqlite_master WHERE type='table' ORDER BY name`);
+        const tableNames = tables.map((t) => t.name);
+        assert.ok(tableNames.includes('m_projects'), 'Should have m_projects after v3.7');
+        // Verify project_id was added to transaction tables
+        const hasProjectId = await db.schema.hasColumn('t_decisions', 'project_id');
+        assert.ok(hasProjectId, 'Should have project_id column in t_decisions');
+        // Verify m_config PRIMARY KEY structure (should be single-column, not composite)
+        const configSchema = await db.raw(`SELECT sql FROM sqlite_master WHERE type='table' AND name='m_config'`);
+        const configSql = configSchema[0]?.sql || '';
+        assert.ok(configSql.includes('primary key (`key`)'), 'm_config should have single-column PRIMARY KEY on key');
+        assert.ok(!configSql.includes('primary key (`key`, `project_id`)'), 'm_config should NOT have composite PRIMARY KEY');
+        console.log(`    ✅ v3.7 upgrade successful (${tableNames.length} tables)`);
+    });
+    /**
+     * Test: Migration Idempotency
+     *
+     * Tests that running migrations twice doesn't cause errors.
+     * This catches issues where migrations don't check for existing objects.
+     */
+    it('should allow running v3.7 migrations again (idempotency test)', async () => {
+        console.log('    🔄 Testing migration idempotency (re-running v3.7)...');
+        // Re-run v3.7 consolidated migration - should skip existing objects
+        const v3_7_migrations = [
+            '20251104000000_add_multi_project_v3_7_0',
+        ];
+        for (const migrationName of v3_7_migrations) {
+            const migrationPath = path.join(process.cwd(), 'dist/config/knex', 'upgrades', `${migrationName}.js`);
+            // Re-import to get fresh module (clear cache)
+            const cacheBuster = `?t=${Date.now()}`;
+            const migration = await import(migrationPath + cacheBuster);
+            await migration.up(db);
+            console.log(`      ✓ Re-ran ${migrationName} (should skip existing objects)`);
+        }
+        // Verify schema is still intact
+        const tables = await db.raw(`SELECT name FROM sqlite_master WHERE type='table' ORDER BY name`);
+        const tableNames = tables.map((t) => t.name);
+        assert.ok(tableNames.includes('m_projects'), 'Should still have m_projects');
+        assert.ok(tableNames.includes('m_help_tools'), 'Should still have help tables');
+        console.log(`    ✅ Idempotency test passed - no duplicate errors`);
+    });
+    /**
+     * Test: Seed Data and Upgrade
+     *
+     * Tests that seeded data is preserved during upgrades.
+     */
+    it('should preserve data during upgrades', async () => {
+        console.log('    📝 Testing data preservation during upgrades...');
+        // Insert test data
+        const now = Math.floor(Date.now() / 1000);
+        // Insert into v3.5 tables
+        await db('m_context_keys').insert({
+            id: 999,
+            key: 'test-upgrade-key',
+        });
+        await db('t_decisions').insert({
+            key_id: 999,
+            project_id: 1, // Default project from migration
+            value: 'test value preserved across upgrade',
+            ts: now,
+        });
+        // Verify data exists
+        const decision = await db('t_decisions').where({ key_id: 999 }).first();
+        assert.ok(decision, 'Test decision should exist');
+        assert.strictEqual(decision.value, 'test value preserved across upgrade');
+        console.log(`    ✅ Data preservation verified`);
+    });
+});
+//# sourceMappingURL=migration-upgrade-paths.test.js.map

package/dist/tests/migration-upgrade-paths.test.js.map

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

package/dist/tests/multi-project-migration.test.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Multi-Project Schema Migration Tests (v3.7.0)
+ *
+ * Tests comprehensive cross-database migration following user requirements:
+ * 1. Initialize SQLite, MySQL, MariaDB, PostgreSQL with migrations
+ * 2. Seed each database with multi-project test data
+ * 3. Export each database using sql-dump
+ * 4. Drop all schemas
+ * 5. Test whether dump SQL can be imported to all databases
+ *
+ * Uses DRY shared test utilities from test-helpers.ts
+ *
+ * NOTE: These tests require Docker containers (MySQL, MariaDB, PostgreSQL)
+ * Set SKIP_DOCKER_TESTS=true or CI=true to skip in CI environments
+ */
+export {};
+//# sourceMappingURL=multi-project-migration.test.d.ts.map

package/dist/tests/multi-project-migration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-project-migration.test.d.ts","sourceRoot":"","sources":["../../src/tests/multi-project-migration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}