sqlew 3.9.1 → 4.0.1

package/dist/database/initialization/schema-version.js

@@ -0,0 +1,166 @@
+/**
+ * Schema Version Detection Module (v4.0)
+ *
+ * Detects the current database schema version based on table presence.
+ * Used by the query layer to determine which tables to use.
+ *
+ * Version Detection Logic:
+ * - v4.x: v4_projects table exists → use v4_ tables
+ * - v3.x: m_agents table exists but no v4_ tables → use m_/t_ tables
+ * - v2.x: Legacy tables without m_ prefix (unlikely to exist now)
+ *
+ * This module is critical for backward compatibility during the v3→v4 transition.
+ */
+import { debugLog } from '../../utils/debug-logger.js';
+// Singleton instance
+let cachedVersionInfo = null;
+/**
+ * Detect schema version by checking table existence
+ */
+export async function detectSchemaVersion(knex) {
+    // Return cached version if already detected in this session
+    if (cachedVersionInfo) {
+        return cachedVersionInfo;
+    }
+    debugLog('INFO', 'Detecting database schema version...');
+    // Check for v4 tables (primary indicator of v4.x schema)
+    const hasV4Projects = await knex.schema.hasTable('v4_projects');
+    const hasV4Decisions = await knex.schema.hasTable('v4_decisions');
+    const hasV4Tasks = await knex.schema.hasTable('v4_tasks');
+    // Check for v3 tables (primary indicator of v3.x schema)
+    const hasAgents = await knex.schema.hasTable('m_agents');
+    const hasV3Decisions = await knex.schema.hasTable('t_decisions');
+    const hasV3Tasks = await knex.schema.hasTable('t_tasks');
+    // Determine schema version
+    const hasV4Tables = hasV4Projects && hasV4Decisions && hasV4Tasks;
+    const hasV3Tables = hasAgents && hasV3Decisions && hasV3Tasks;
+    let version;
+    let majorVersion;
+    let minorVersion;
+    let tablePrefix;
+    let transactionPrefix;
+    if (hasV4Tables) {
+        // v4.x schema detected - use new tables
+        version = 'v4';
+        majorVersion = 4;
+        minorVersion = 0;
+        tablePrefix = 'v4_';
+        transactionPrefix = 'v4_';
+        debugLog('INFO', 'Schema version detected: v4.x (using v4_ tables)');
+    }
+    else if (hasV3Tables) {
+        // v3.x schema detected - use old tables
+        version = 'v3';
+        majorVersion = 3;
+        minorVersion = 0;
+        tablePrefix = 'm_';
+        transactionPrefix = 't_';
+        debugLog('INFO', 'Schema version detected: v3.x (using m_/t_ tables)');
+    }
+    else {
+        // Unknown schema - this shouldn't happen after migrations
+        version = 'unknown';
+        majorVersion = 0;
+        minorVersion = 0;
+        tablePrefix = '';
+        transactionPrefix = '';
+        debugLog('WARN', 'Unknown schema version detected - no expected tables found');
+    }
+    cachedVersionInfo = {
+        version,
+        majorVersion,
+        minorVersion,
+        hasV4Tables,
+        hasV3Tables,
+        tablePrefix,
+        transactionPrefix,
+        detectedAt: Date.now(),
+    };
+    return cachedVersionInfo;
+}
+/**
+ * Get cached schema version info (throws if not yet detected)
+ */
+export function getSchemaVersion() {
+    if (!cachedVersionInfo) {
+        throw new Error('Schema version not yet detected. Call detectSchemaVersion() first.');
+    }
+    return cachedVersionInfo;
+}
+/**
+ * Check if schema version has been detected
+ */
+export function isSchemaVersionDetected() {
+    return cachedVersionInfo !== null;
+}
+/**
+ * Clear cached schema version (for testing)
+ */
+export function clearSchemaVersionCache() {
+    cachedVersionInfo = null;
+}
+/**
+ * Check if using v4 schema
+ */
+export function isV4Schema() {
+    return cachedVersionInfo?.version === 'v4';
+}
+/**
+ * Check if using v3 schema
+ */
+export function isV3Schema() {
+    return cachedVersionInfo?.version === 'v3';
+}
+/**
+ * Get table name with correct prefix
+ *
+ * @param baseName - Base table name without prefix (e.g., 'agents', 'decisions')
+ * @param type - 'master' for reference tables, 'transaction' for data tables
+ * @returns Prefixed table name (e.g., 'v4_agents' or 'v4_agents')
+ */
+export function getTableName(baseName, type = 'transaction') {
+    if (!cachedVersionInfo) {
+        // Fallback to v3 naming if version not detected
+        return type === 'master' ? `m_${baseName}` : `t_${baseName}`;
+    }
+    if (cachedVersionInfo.version === 'v4') {
+        // v4 uses unified v4_ prefix for all tables
+        return `v4_${baseName}`;
+    }
+    // v3 uses m_ for master tables, t_ for transaction tables
+    return type === 'master' ? `m_${baseName}` : `t_${baseName}`;
+}
+/**
+ * Get table names for common tables
+ */
+export const TableNames = {
+    // Master tables (agents removed in v4.0)
+    projects: () => getTableName('projects', 'master'),
+    layers: () => getTableName('layers', 'master'),
+    tags: () => getTableName('tags', 'master'),
+    files: () => getTableName('files', 'master'),
+    contextKeys: () => getTableName('context_keys', 'master'),
+    constraintCategories: () => getTableName('constraint_categories', 'master'),
+    taskStatuses: () => getTableName('task_statuses', 'master'),
+    config: () => getTableName('config', 'master'),
+    // Transaction tables
+    decisions: () => getTableName('decisions', 'transaction'),
+    decisionHistory: () => getTableName('decision_history', 'transaction'),
+    decisionContext: () => getTableName('decision_context', 'transaction'),
+    decisionPolicies: () => getTableName('decision_policies', 'transaction'),
+    tasks: () => getTableName('tasks', 'transaction'),
+    taskDependencies: () => getTableName('task_dependencies', 'transaction'),
+    taskFileLinks: () => getTableName('task_file_links', 'transaction'),
+    taskDecisionLinks: () => getTableName('task_decision_links', 'transaction'),
+    fileChanges: () => getTableName('file_changes', 'transaction'),
+    constraints: () => getTableName('constraints', 'transaction'),
+    tagIndex: () => getTableName('tag_index', 'transaction'),
+    // Help system tables (v4 only has these with v4_ prefix)
+    helpTools: () => cachedVersionInfo?.version === 'v4' ? 'v4_help_tools' : 'v4_help_tools',
+    helpActions: () => cachedVersionInfo?.version === 'v4' ? 'v4_help_actions' : 'v4_help_actions',
+    helpActionParams: () => cachedVersionInfo?.version === 'v4' ? 'v4_help_action_params' : 'm_help_action_params',
+    helpActionExamples: () => cachedVersionInfo?.version === 'v4' ? 'v4_help_action_examples' : 'm_help_action_examples',
+    helpUseCases: () => cachedVersionInfo?.version === 'v4' ? 'v4_help_use_cases' : 'm_help_use_cases',
+    helpUseCaseCategories: () => cachedVersionInfo?.version === 'v4' ? 'v4_help_use_case_categories' : 'v4_help_use_case_categories',
+};
+//# sourceMappingURL=schema-version.js.map

package/dist/database/initialization/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../../../src/database/initialization/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAqBvD,qBAAqB;AACrB,IAAI,iBAAiB,GAA6B,IAAI,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAU;IAClD,4DAA4D;IAC5D,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,QAAQ,CAAC,MAAM,EAAE,sCAAsC,CAAC,CAAC;IAEzD,yDAAyD;IACzD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAChE,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAE1D,yDAAyD;IACzD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEzD,2BAA2B;IAC3B,MAAM,WAAW,GAAG,aAAa,IAAI,cAAc,IAAI,UAAU,CAAC;IAClE,MAAM,WAAW,GAAG,SAAS,IAAI,cAAc,IAAI,UAAU,CAAC;IAE9D,IAAI,OAAsB,CAAC;IAC3B,IAAI,YAAoB,CAAC;IACzB,IAAI,YAAoB,CAAC;IACzB,IAAI,WAA8B,CAAC;IACnC,IAAI,iBAAoC,CAAC;IAEzC,IAAI,WAAW,EAAE,CAAC;QAChB,wCAAwC;QACxC,OAAO,GAAG,IAAI,CAAC;QACf,YAAY,GAAG,CAAC,CAAC;QACjB,YAAY,GAAG,CAAC,CAAC;QACjB,WAAW,GAAG,KAAK,CAAC;QACpB,iBAAiB,GAAG,KAAK,CAAC;QAE1B,QAAQ,CAAC,MAAM,EAAE,kDAAkD,CAAC,CAAC;IACvE,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,wCAAwC;QACxC,OAAO,GAAG,IAAI,CAAC;QACf,YAAY,GAAG,CAAC,CAAC;QACjB,YAAY,GAAG,CAAC,CAAC;QACjB,WAAW,GAAG,IAAI,CAAC;QACnB,iBAAiB,GAAG,IAAI,CAAC;QAEzB,QAAQ,CAAC,MAAM,EAAE,oDAAoD,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACN,0DAA0D;QAC1D,OAAO,GAAG,SAAS,CAAC;QACpB,YAAY,GAAG,CAAC,CAAC;QACjB,YAAY,GAAG,CAAC,CAAC;QACjB,WAAW,GAAG,EAAE,CAAC;QACjB,iBAAiB,GAAG,EAAE,CAAC;QAEvB,QAAQ,CAAC,MAAM,EAAE,4DAA4D,CAAC,CAAC;IACjF,CAAC;IAED,iBAAiB,GAAG;QAClB,OAAO;QACP,YAAY;QACZ,YAAY;QACZ,WAAW;QACX,WAAW;QACX,WAAW;QACX,iBAAiB;QACjB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;KACvB,CAAC;IAEF,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,iBAAiB,KAAK,IAAI,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,iBAAiB,GAAG,IAAI,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,iBAAiB,EAAE,OAAO,KAAK,IAAI,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,iBAAiB,EAAE,OAAO,KAAK,IAAI,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,OAAiC,aAAa;IAE9C,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,gDAAgD;QAChD,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;IAC/D,CAAC;IAED,IAAI,iBAAiB,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACvC,4CAA4C;QAC5C,OAAO,MAAM,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED,0DAA0D;IAC1D,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,yCAAyC;IACzC,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC;IAClD,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC9C,IAAI,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1C,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC5C,WAAW,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,QAAQ,CAAC;IACzD,oBAAoB,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,uBAAuB,EAAE,QAAQ,CAAC;IAC3E,YAAY,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,QAAQ,CAAC;IAC3D,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAE9C,qBAAqB;IACrB,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,aAAa,CAAC;IACzD,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,aAAa,CAAC;IACtE,eAAe,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,kBAAkB,EAAE,aAAa,CAAC;IACtE,gBAAgB,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,aAAa,CAAC;IACxE,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,aAAa,CAAC;IACjD,gBAAgB,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,mBAAmB,EAAE,aAAa,CAAC;IACxE,aAAa,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,iBAAiB,EAAE,aAAa,CAAC;IACnE,iBAAiB,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,qBAAqB,EAAE,aAAa,CAAC;IAC3E,WAAW,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,cAAc,EAAE,aAAa,CAAC;IAC9D,WAAW,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,aAAa,CAAC;IAC7D,QAAQ,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,aAAa,CAAC;IAExD,yDAAyD;IACzD,SAAS,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe;IACxF,WAAW,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB;IAC9F,gBAAgB,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,sBAAsB;IAC9G,kBAAkB,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,wBAAwB;IACpH,YAAY,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB;IAClG,qBAAqB,EAAE,GAAG,EAAE,CAAC,iBAAiB,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,6BAA6B;CACjI,CAAC"}

package/dist/database/migrations/v4/20251126000000_v4_bootstrap.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Migration: v4.0 Bootstrap (Schema + Indexes + Seed Data)
+ *
+ * Creates all v4_ prefixed tables, performance indexes, and seeds initial data.
+ * This is a complete replacement for the v3.x m_/t_ tables.
+ *
+ * Key Changes from v3.x:
+ * - All tables use v4_ prefix
+ * - Removed: m_agents (agent tracking no longer needed after messaging system removal)
+ * - Removed: t_agent_messages (unused messaging system)
+ * - Removed: t_activity_log (low usage)
+ * - Removed: t_decision_templates (merged into v4_decision_policies)
+ * - No Views (replaced by application-level queries)
+ * - No Triggers (replaced by application-level logic)
+ *
+ * Tables Created (33 total):
+ * - Master Tables (13): v4_files, v4_context_keys, v4_layers,
+ *   v4_tags, v4_scopes, v4_task_statuses, v4_projects,
+ *   v4_constraint_categories, v4_help_tools, v4_help_actions,
+ *   v4_help_use_case_cats, v4_tag_index, v4_builtin_policies
+ * - Transaction Tables (20): v4_decisions, v4_decisions_numeric,
+ *   v4_decision_history, v4_decision_tags, v4_decision_scopes,
+ *   v4_decision_context, v4_decision_policies, v4_decision_pruning_log,
+ *   v4_file_changes, v4_constraints, v4_constraint_tags,
+ *   v4_tasks, v4_task_details, v4_task_tags, v4_task_decision_links,
+ *   v4_task_constraint_links, v4_task_file_links, v4_task_dependencies,
+ *   v4_task_pruned_files, v4_help_action_params, v4_help_action_examples,
+ *   v4_help_use_cases, v4_help_action_sequences, v4_token_usage
+ *
+ * Indexes Created: 30 performance indexes
+ * Seed Data: layers, task_statuses, constraint_categories, default project, tags, config
+ */
+import type { Knex } from 'knex';
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20251126000000_v4_bootstrap.d.ts.map

package/dist/database/migrations/v4/20251126000000_v4_bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251126000000_v4_bootstrap.d.ts","sourceRoot":"","sources":["../../../../src/database/migrations/v4/20251126000000_v4_bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAkmBlD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpD"}