sqlew 4.1.1 → 4.3.0

package/dist/database/migrations/v4/20251126000000_v4_bootstrap.js

@@ -484,18 +484,18 @@ export async function up(knex) {
     const existingLayers = await knex('v4_layers').count('* as count').first();
     if (!existingLayers || Number(existingLayers.count) === 0) {
         if (db.isPostgreSQL) {
-            await knex.raw(`
-        INSERT INTO v4_layers (id, name) VALUES
-          (1, 'presentation'), (2, 'business'), (3, 'data'), (4, 'infrastructure'),
-          (5, 'cross-cutting'), (6, 'documentation'), (7, 'planning'), (8, 'coordination'), (9, 'review')
-        ON CONFLICT (id) DO NOTHING
+            await knex.raw(`
+        INSERT INTO v4_layers (id, name) VALUES
+          (1, 'presentation'), (2, 'business'), (3, 'data'), (4, 'infrastructure'),
+          (5, 'cross-cutting'), (6, 'documentation'), (7, 'planning'), (8, 'coordination'), (9, 'review')
+        ON CONFLICT (id) DO NOTHING
       `);
         }
         else {
-            await knex.raw(`
-        INSERT ${insertIgnore} INTO v4_layers (id, name) VALUES
-          (1, 'presentation'), (2, 'business'), (3, 'data'), (4, 'infrastructure'),
-          (5, 'cross-cutting'), (6, 'documentation'), (7, 'planning'), (8, 'coordination'), (9, 'review')
+            await knex.raw(`
+        INSERT ${insertIgnore} INTO v4_layers (id, name) VALUES
+          (1, 'presentation'), (2, 'business'), (3, 'data'), (4, 'infrastructure'),
+          (5, 'cross-cutting'), (6, 'documentation'), (7, 'planning'), (8, 'coordination'), (9, 'review')
       `);
         }
         console.error('  ✓ Layers seeded (9)');
@@ -504,16 +504,16 @@ export async function up(knex) {
     const existingCategories = await knex('v4_constraint_categories').count('* as count').first();
     if (!existingCategories || Number(existingCategories.count) === 0) {
         if (db.isPostgreSQL) {
-            await knex.raw(`
-        INSERT INTO v4_constraint_categories (name) VALUES
-          ('architecture'), ('security'), ('performance'), ('compatibility'), ('maintainability')
-        ON CONFLICT (name) DO NOTHING
+            await knex.raw(`
+        INSERT INTO v4_constraint_categories (name) VALUES
+          ('architecture'), ('security'), ('performance'), ('compatibility'), ('maintainability')
+        ON CONFLICT (name) DO NOTHING
       `);
         }
         else {
-            await knex.raw(`
-        INSERT ${insertIgnore} INTO v4_constraint_categories (name) VALUES
-          ('architecture'), ('security'), ('performance'), ('compatibility'), ('maintainability')
+            await knex.raw(`
+        INSERT ${insertIgnore} INTO v4_constraint_categories (name) VALUES
+          ('architecture'), ('security'), ('performance'), ('compatibility'), ('maintainability')
       `);
         }
         console.error('  ✓ Constraint categories seeded (5)');
@@ -522,16 +522,16 @@ export async function up(knex) {
     const existingStatuses = await knex('v4_task_statuses').count('* as count').first();
     if (!existingStatuses || Number(existingStatuses.count) === 0) {
         if (db.isPostgreSQL) {
-            await knex.raw(`
-        INSERT INTO v4_task_statuses (id, name) VALUES
-          (1, 'todo'), (2, 'in_progress'), (3, 'waiting_review'), (4, 'blocked'), (5, 'done'), (6, 'archived'), (7, 'rejected')
-        ON CONFLICT (id) DO NOTHING
+            await knex.raw(`
+        INSERT INTO v4_task_statuses (id, name) VALUES
+          (1, 'todo'), (2, 'in_progress'), (3, 'waiting_review'), (4, 'blocked'), (5, 'done'), (6, 'archived'), (7, 'rejected')
+        ON CONFLICT (id) DO NOTHING
       `);
         }
         else {
-            await knex.raw(`
-        INSERT ${insertIgnore} INTO v4_task_statuses (id, name) VALUES
-          (1, 'todo'), (2, 'in_progress'), (3, 'waiting_review'), (4, 'blocked'), (5, 'done'), (6, 'archived'), (7, 'rejected')
+            await knex.raw(`
+        INSERT ${insertIgnore} INTO v4_task_statuses (id, name) VALUES
+          (1, 'todo'), (2, 'in_progress'), (3, 'waiting_review'), (4, 'blocked'), (5, 'done'), (6, 'archived'), (7, 'rejected')
       `);
         }
         console.error('  ✓ Task statuses seeded (7)');
@@ -554,18 +554,18 @@ export async function up(knex) {
     const existingTags = await knex('v4_tags').count('* as count').first();
     if (!existingTags || Number(existingTags.count) === 0) {
         if (db.isPostgreSQL) {
-            await knex.raw(`
-        INSERT INTO v4_tags (project_id, name) VALUES
-          (1, 'authentication'), (1, 'authorization'), (1, 'validation'), (1, 'error-handling'),
-          (1, 'logging'), (1, 'performance'), (1, 'security'), (1, 'testing')
-        ON CONFLICT (project_id, name) DO NOTHING
+            await knex.raw(`
+        INSERT INTO v4_tags (project_id, name) VALUES
+          (1, 'authentication'), (1, 'authorization'), (1, 'validation'), (1, 'error-handling'),
+          (1, 'logging'), (1, 'performance'), (1, 'security'), (1, 'testing')
+        ON CONFLICT (project_id, name) DO NOTHING
       `);
         }
         else {
-            await knex.raw(`
-        INSERT ${insertIgnore} INTO v4_tags (project_id, name) VALUES
-          (1, 'authentication'), (1, 'authorization'), (1, 'validation'), (1, 'error-handling'),
-          (1, 'logging'), (1, 'performance'), (1, 'security'), (1, 'testing')
+            await knex.raw(`
+        INSERT ${insertIgnore} INTO v4_tags (project_id, name) VALUES
+          (1, 'authentication'), (1, 'authorization'), (1, 'validation'), (1, 'error-handling'),
+          (1, 'logging'), (1, 'performance'), (1, 'security'), (1, 'testing')
       `);
         }
         console.error('  ✓ Common tags seeded (8)');

package/dist/database/migrations/v4/20251225000000_v4_seed_missing_help_data.d.ts

@@ -0,0 +1,14 @@
+/**
+ * v4 Seed Missing Help Data Migration
+ *
+ * Adds missing help system data:
+ * - v4_help_action_params for analytics, by_key, by_tags, check_duplicate
+ * - v4_help_action_examples (initial examples)
+ *
+ * This migration supplements the original seed migration with
+ * data that was missing in v4.1.1 clean installs.
+ */
+import type { Knex } from 'knex';
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20251225000000_v4_seed_missing_help_data.d.ts.map

package/dist/database/migrations/v4/20251225000000_v4_seed_missing_help_data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251225000000_v4_seed_missing_help_data.d.ts","sourceRoot":"","sources":["../../../../src/database/migrations/v4/20251225000000_v4_seed_missing_help_data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA4LlD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBpD"}

package/dist/database/migrations/v4/20251225000000_v4_seed_missing_help_data.js

@@ -0,0 +1,201 @@
+/**
+ * v4 Seed Missing Help Data Migration
+ *
+ * Adds missing help system data:
+ * - v4_help_action_params for analytics, by_key, by_tags, check_duplicate
+ * - v4_help_action_examples (initial examples)
+ *
+ * This migration supplements the original seed migration with
+ * data that was missing in v4.1.1 clean installs.
+ */
+export async function up(knex) {
+    console.error('🌱 Seeding missing help system data...');
+    // Get action IDs
+    const actions = await knex('v4_help_actions').select('id', 'tool_name', 'action_name');
+    const actionMap = actions.reduce((map, action) => {
+        map[`${action.tool_name}:${action.action_name}`] = action.id;
+        return map;
+    }, {});
+    // 1. Seed missing v4_help_action_params
+    const missingParams = [
+        // DECISION:ANALYTICS
+        { action_id: actionMap['decision:analytics'], param_name: 'action', param_type: 'string', required: 1, description: 'Must be "analytics"', default_value: null },
+        { action_id: actionMap['decision:analytics'], param_name: 'key_pattern', param_type: 'string', required: 1, description: 'SQL LIKE pattern for decision keys (e.g., "metric/%")', default_value: null },
+        { action_id: actionMap['decision:analytics'], param_name: 'aggregation', param_type: 'string', required: 1, description: 'Aggregation type: avg, sum, max, min, count', default_value: null },
+        { action_id: actionMap['decision:analytics'], param_name: 'layer', param_type: 'string', required: 0, description: 'Filter by layer', default_value: null },
+        { action_id: actionMap['decision:analytics'], param_name: 'time_series', param_type: 'object', required: 0, description: 'Time series options: { bucket, start_ts, end_ts }', default_value: null },
+        { action_id: actionMap['decision:analytics'], param_name: 'percentiles', param_type: 'number[]', required: 0, description: 'Percentiles to calculate (e.g., [50, 90, 95, 99])', default_value: null },
+        // SUGGEST:BY_KEY
+        { action_id: actionMap['suggest:by_key'], param_name: 'action', param_type: 'string', required: 1, description: 'Must be "by_key"', default_value: null },
+        { action_id: actionMap['suggest:by_key'], param_name: 'key', param_type: 'string', required: 1, description: 'Decision key pattern to search', default_value: null },
+        { action_id: actionMap['suggest:by_key'], param_name: 'limit', param_type: 'number', required: 0, description: 'Max suggestions', default_value: '5' },
+        { action_id: actionMap['suggest:by_key'], param_name: 'min_score', param_type: 'number', required: 0, description: 'Minimum relevance score', default_value: '30' },
+        // SUGGEST:BY_TAGS
+        { action_id: actionMap['suggest:by_tags'], param_name: 'action', param_type: 'string', required: 1, description: 'Must be "by_tags"', default_value: null },
+        { action_id: actionMap['suggest:by_tags'], param_name: 'tags', param_type: 'string[]', required: 1, description: 'Tags to search for', default_value: null },
+        { action_id: actionMap['suggest:by_tags'], param_name: 'layer', param_type: 'string', required: 0, description: 'Filter by layer', default_value: null },
+        { action_id: actionMap['suggest:by_tags'], param_name: 'limit', param_type: 'number', required: 0, description: 'Max suggestions', default_value: '5' },
+        { action_id: actionMap['suggest:by_tags'], param_name: 'min_score', param_type: 'number', required: 0, description: 'Minimum relevance score', default_value: '15' },
+        // SUGGEST:CHECK_DUPLICATE
+        { action_id: actionMap['suggest:check_duplicate'], param_name: 'action', param_type: 'string', required: 1, description: 'Must be "check_duplicate"', default_value: null },
+        { action_id: actionMap['suggest:check_duplicate'], param_name: 'key', param_type: 'string', required: 1, description: 'Decision key to check', default_value: null },
+        { action_id: actionMap['suggest:check_duplicate'], param_name: 'tags', param_type: 'string[]', required: 0, description: 'Tags for context matching', default_value: '[]' },
+        { action_id: actionMap['suggest:check_duplicate'], param_name: 'layer', param_type: 'string', required: 0, description: 'Layer for context matching', default_value: null },
+    ].filter(p => p.action_id);
+    if (missingParams.length > 0) {
+        // Check for existing params to avoid duplicates
+        for (const param of missingParams) {
+            const exists = await knex('v4_help_action_params')
+                .where({ action_id: param.action_id, param_name: param.param_name })
+                .first();
+            if (!exists) {
+                await knex('v4_help_action_params').insert(param);
+            }
+        }
+        console.error(`  ✓ Missing help action params seeded`);
+    }
+    // 2. Seed v4_help_action_examples
+    const existingExamples = await knex('v4_help_action_examples').count('* as count').first();
+    if (!existingExamples || Number(existingExamples.count) === 0) {
+        const examples = [
+            // DECISION:SET examples
+            {
+                action_id: actionMap['decision:set'],
+                title: 'Basic decision',
+                code: JSON.stringify({
+                    action: 'set',
+                    key: 'auth/method',
+                    value: 'JWT tokens with refresh',
+                    tags: ['security', 'auth'],
+                    layer: 'infrastructure'
+                }, null, 2),
+                explanation: 'Store a simple architectural decision with tags and layer'
+            },
+            {
+                action_id: actionMap['decision:set'],
+                title: 'Decision with context',
+                code: JSON.stringify({
+                    action: 'set',
+                    key: 'database/orm',
+                    value: 'Prisma',
+                    tags: ['database', 'orm'],
+                    layer: 'data',
+                    rationale: 'Type safety and migration support',
+                    alternatives: 'TypeORM, Knex, raw SQL',
+                    tradeoffs: 'Learning curve, but better DX'
+                }, null, 2),
+                explanation: 'Store a decision with full context (rationale, alternatives, tradeoffs)'
+            },
+            // DECISION:LIST examples
+            {
+                action_id: actionMap['decision:list'],
+                title: 'List all decisions',
+                code: JSON.stringify({
+                    action: 'list'
+                }, null, 2),
+                explanation: 'Get all active decisions'
+            },
+            {
+                action_id: actionMap['decision:list'],
+                title: 'Filter by layer',
+                code: JSON.stringify({
+                    action: 'list',
+                    layer: 'infrastructure',
+                    limit: 10
+                }, null, 2),
+                explanation: 'List decisions filtered by architecture layer'
+            },
+            // SUGGEST:BY_KEY examples
+            {
+                action_id: actionMap['suggest:by_key'],
+                title: 'Find similar by key',
+                code: JSON.stringify({
+                    action: 'by_key',
+                    key: 'auth'
+                }, null, 2),
+                explanation: 'Find decisions with keys similar to "auth" (e.g., auth/method, auth/provider)'
+            },
+            // SUGGEST:BY_TAGS examples
+            {
+                action_id: actionMap['suggest:by_tags'],
+                title: 'Find by tags',
+                code: JSON.stringify({
+                    action: 'by_tags',
+                    tags: ['security', 'auth']
+                }, null, 2),
+                explanation: 'Find decisions tagged with security or auth'
+            },
+            // DECISION:ANALYTICS examples
+            {
+                action_id: actionMap['decision:analytics'],
+                title: 'Count decisions',
+                code: JSON.stringify({
+                    action: 'analytics',
+                    key_pattern: '%',
+                    aggregation: 'count'
+                }, null, 2),
+                explanation: 'Count all decisions in the database'
+            },
+            {
+                action_id: actionMap['decision:analytics'],
+                title: 'Average metric value',
+                code: JSON.stringify({
+                    action: 'analytics',
+                    key_pattern: 'metric/api-latency/%',
+                    aggregation: 'avg',
+                    layer: 'infrastructure'
+                }, null, 2),
+                explanation: 'Calculate average of numeric decisions matching pattern'
+            },
+            // TASK:CREATE examples
+            {
+                action_id: actionMap['task:create'],
+                title: 'Create simple task',
+                code: JSON.stringify({
+                    action: 'create',
+                    title: 'Implement user authentication',
+                    priority: 3,
+                    layer: 'business'
+                }, null, 2),
+                explanation: 'Create a high-priority task in the business layer'
+            },
+            // CONSTRAINT:ADD examples
+            {
+                action_id: actionMap['constraint:add'],
+                title: 'Add architectural constraint',
+                code: JSON.stringify({
+                    action: 'add',
+                    constraint_text: 'All API endpoints must validate input',
+                    category: 'security',
+                    priority: 3,
+                    layer: 'infrastructure'
+                }, null, 2),
+                explanation: 'Add a security constraint to enforce input validation'
+            }
+        ].filter(e => e.action_id);
+        if (examples.length > 0) {
+            await knex('v4_help_action_examples').insert(examples);
+            console.error(`  ✓ Help action examples seeded (${examples.length})`);
+        }
+    }
+    else {
+        console.error('  ℹ Help action examples already exist, skipping');
+    }
+    console.error('🎉 Missing help system data seeded!');
+}
+export async function down(knex) {
+    // Remove examples added by this migration
+    await knex('v4_help_action_examples').del();
+    // Remove params added by this migration (analytics, by_key, by_tags, check_duplicate)
+    const actions = await knex('v4_help_actions')
+        .whereIn('action_name', ['analytics', 'by_key', 'by_tags', 'check_duplicate'])
+        .select('id');
+    const actionIds = actions.map(a => a.id);
+    if (actionIds.length > 0) {
+        await knex('v4_help_action_params')
+            .whereIn('action_id', actionIds)
+            .del();
+    }
+    console.error('🗑️ Missing help system data removed');
+}
+//# sourceMappingURL=20251225000000_v4_seed_missing_help_data.js.map

package/dist/database/migrations/v4/20251225000000_v4_seed_missing_help_data.js.map

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

package/dist/database/migrations/v4/20251225000001_v4_fix_help_params.d.ts

@@ -0,0 +1,12 @@
+/**
+ * v4 Fix Help Params Migration
+ *
+ * Fixes incorrect parameter descriptions in the help system:
+ * - constraint:add priority: "Priority: 1-4" → "Priority level: low, medium, high, critical"
+ *
+ * NOTE: file:record agent_name is not in DB (handled in code only)
+ */
+import type { Knex } from 'knex';
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20251225000001_v4_fix_help_params.d.ts.map

package/dist/database/migrations/v4/20251225000001_v4_fix_help_params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251225000001_v4_fix_help_params.d.ts","sourceRoot":"","sources":["../../../../src/database/migrations/v4/20251225000001_v4_fix_help_params.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgClD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpD"}

package/dist/database/migrations/v4/20251225000001_v4_fix_help_params.js

@@ -0,0 +1,61 @@
+/**
+ * v4 Fix Help Params Migration
+ *
+ * Fixes incorrect parameter descriptions in the help system:
+ * - constraint:add priority: "Priority: 1-4" → "Priority level: low, medium, high, critical"
+ *
+ * NOTE: file:record agent_name is not in DB (handled in code only)
+ */
+export async function up(knex) {
+    console.error('🔧 Fixing help parameter descriptions...');
+    // Get constraint:add action ID
+    const constraintAddAction = await knex('v4_help_actions')
+        .where({ tool_name: 'constraint', action_name: 'add' })
+        .select('id')
+        .first();
+    if (constraintAddAction) {
+        // Fix priority description: "Priority: 1-4" → "Priority level: low, medium, high, critical"
+        const updated = await knex('v4_help_action_params')
+            .where({
+            action_id: constraintAddAction.id,
+            param_name: 'priority'
+        })
+            .update({
+            param_type: 'string',
+            description: 'Priority level: low, medium, high, critical',
+            default_value: 'medium'
+        });
+        if (updated > 0) {
+            console.error('  ✓ Fixed constraint:add priority parameter');
+        }
+        else {
+            console.error('  ℹ constraint:add priority parameter not found (may not exist)');
+        }
+    }
+    else {
+        console.error('  ⚠ constraint:add action not found');
+    }
+    console.error('🎉 Help parameter descriptions fixed!');
+}
+export async function down(knex) {
+    // Get constraint:add action ID
+    const constraintAddAction = await knex('v4_help_actions')
+        .where({ tool_name: 'constraint', action_name: 'add' })
+        .select('id')
+        .first();
+    if (constraintAddAction) {
+        // Revert to original values
+        await knex('v4_help_action_params')
+            .where({
+            action_id: constraintAddAction.id,
+            param_name: 'priority'
+        })
+            .update({
+            param_type: 'number',
+            description: 'Priority: 1-4',
+            default_value: '2'
+        });
+    }
+    console.error('🗑️ Help parameter descriptions reverted');
+}
+//# sourceMappingURL=20251225000001_v4_fix_help_params.js.map

package/dist/database/migrations/v4/20251225000001_v4_fix_help_params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20251225000001_v4_fix_help_params.js","sourceRoot":"","sources":["../../../../src/database/migrations/v4/20251225000001_v4_fix_help_params.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,IAAU;IACjC,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAE1D,+BAA+B;IAC/B,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC;SACtD,KAAK,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;SACtD,MAAM,CAAC,IAAI,CAAC;SACZ,KAAK,EAAE,CAAC;IAEX,IAAI,mBAAmB,EAAE,CAAC;QACxB,4FAA4F;QAC5F,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC;aAChD,KAAK,CAAC;YACL,SAAS,EAAE,mBAAmB,CAAC,EAAE;YACjC,UAAU,EAAE,UAAU;SACvB,CAAC;aACD,MAAM,CAAC;YACN,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,6CAA6C;YAC1D,aAAa,EAAE,QAAQ;SACxB,CAAC,CAAC;QAEL,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAU;IACnC,+BAA+B;IAC/B,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC;SACtD,KAAK,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;SACtD,MAAM,CAAC,IAAI,CAAC;SACZ,KAAK,EAAE,CAAC;IAEX,IAAI,mBAAmB,EAAE,CAAC;QACxB,4BAA4B;QAC5B,MAAM,IAAI,CAAC,uBAAuB,CAAC;aAChC,KAAK,CAAC;YACL,SAAS,EAAE,mBAAmB,CAAC,EAAE;YACjC,UAAU,EAAE,UAAU;SACvB,CAAC;aACD,MAAM,CAAC;YACN,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,eAAe;YAC5B,aAAa,EAAE,GAAG;SACnB,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC5D,CAAC"}

package/dist/database/migrations/v4/20260102204000_v4_fix_decision_set_example.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Migration: Fix decision.set example that incorrectly shows rationale/alternatives/tradeoffs
+ *
+ * The original example in 20251225000000_v4_seed_missing_help_data.ts incorrectly shows
+ * rationale, alternatives, and tradeoffs as parameters for decision.set action.
+ * These are actually parameters for add_decision_context action.
+ *
+ * This migration updates the example to show the correct 2-step workflow.
+ *
+ * @since v4.2.1
+ */
+import type { Knex } from 'knex';
+export declare function up(knex: Knex): Promise<void>;
+export declare function down(knex: Knex): Promise<void>;
+//# sourceMappingURL=20260102204000_v4_fix_decision_set_example.d.ts.map

package/dist/database/migrations/v4/20260102204000_v4_fix_decision_set_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260102204000_v4_fix_decision_set_example.d.ts","sourceRoot":"","sources":["../../../../src/database/migrations/v4/20260102204000_v4_fix_decision_set_example.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,wBAAsB,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAuClD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BpD"}

package/dist/database/migrations/v4/20260102204000_v4_fix_decision_set_example.js

@@ -0,0 +1,74 @@
+/**
+ * Migration: Fix decision.set example that incorrectly shows rationale/alternatives/tradeoffs
+ *
+ * The original example in 20251225000000_v4_seed_missing_help_data.ts incorrectly shows
+ * rationale, alternatives, and tradeoffs as parameters for decision.set action.
+ * These are actually parameters for add_decision_context action.
+ *
+ * This migration updates the example to show the correct 2-step workflow.
+ *
+ * @since v4.2.1
+ */
+export async function up(knex) {
+    // Find the incorrect example
+    const example = await knex('v4_help_action_examples')
+        .where('title', 'Decision with context')
+        .whereRaw("code LIKE '%rationale%'")
+        .first();
+    if (!example) {
+        // Example not found or already fixed
+        return;
+    }
+    // Correct example: show 2-step workflow
+    const correctCode = JSON.stringify({
+        action: 'set',
+        key: 'database/orm',
+        value: 'Prisma',
+        tags: ['database', 'orm'],
+        layer: 'data'
+    }, null, 2);
+    const contextNote = `
+
+// To add context (rationale, alternatives, tradeoffs), use add_decision_context:
+${JSON.stringify({
+        action: 'add_decision_context',
+        key: 'database/orm',
+        rationale: 'Type safety and migration support',
+        alternatives: 'TypeORM, Knex, raw SQL',
+        tradeoffs: 'Learning curve, but better DX'
+    }, null, 2)}`;
+    await knex('v4_help_action_examples')
+        .where('id', example.id)
+        .update({
+        title: 'Decision with context (2-step)',
+        code: correctCode + contextNote,
+        explanation: 'First create decision with set, then add context with add_decision_context action'
+    });
+}
+export async function down(knex) {
+    // Revert to original (incorrect) example
+    const example = await knex('v4_help_action_examples')
+        .where('title', 'Decision with context (2-step)')
+        .first();
+    if (!example) {
+        return;
+    }
+    const originalCode = JSON.stringify({
+        action: 'set',
+        key: 'database/orm',
+        value: 'Prisma',
+        tags: ['database', 'orm'],
+        layer: 'data',
+        rationale: 'Type safety and migration support',
+        alternatives: 'TypeORM, Knex, raw SQL',
+        tradeoffs: 'Learning curve, but better DX'
+    }, null, 2);
+    await knex('v4_help_action_examples')
+        .where('id', example.id)
+        .update({
+        title: 'Decision with context',
+        code: originalCode,
+        explanation: 'Store a decision with full context (rationale, alternatives, tradeoffs)'
+    });
+}
+//# sourceMappingURL=20260102204000_v4_fix_decision_set_example.js.map

package/dist/database/migrations/v4/20260102204000_v4_fix_decision_set_example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260102204000_v4_fix_decision_set_example.js","sourceRoot":"","sources":["../../../../src/database/migrations/v4/20260102204000_v4_fix_decision_set_example.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,IAAU;IACjC,6BAA6B;IAC7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC;SAClD,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC;SACvC,QAAQ,CAAC,yBAAyB,CAAC;SACnC,KAAK,EAAE,CAAC;IAEX,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,qCAAqC;QACrC,OAAO;IACT,CAAC;IAED,wCAAwC;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC;QACzB,KAAK,EAAE,MAAM;KACd,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEZ,MAAM,WAAW,GAAG;;;EAGpB,IAAI,CAAC,SAAS,CAAC;QACb,MAAM,EAAE,sBAAsB;QAC9B,GAAG,EAAE,cAAc;QACnB,SAAS,EAAE,mCAAmC;QAC9C,YAAY,EAAE,wBAAwB;QACtC,SAAS,EAAE,+BAA+B;KAC3C,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IAEd,MAAM,IAAI,CAAC,yBAAyB,CAAC;SAClC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;SACvB,MAAM,CAAC;QACN,KAAK,EAAE,gCAAgC;QACvC,IAAI,EAAE,WAAW,GAAG,WAAW;QAC/B,WAAW,EAAE,mFAAmF;KACjG,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAU;IACnC,yCAAyC;IACzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC;SAClD,KAAK,CAAC,OAAO,EAAE,gCAAgC,CAAC;SAChD,KAAK,EAAE,CAAC;IAEX,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC;QAClC,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC;QACzB,KAAK,EAAE,MAAM;QACb,SAAS,EAAE,mCAAmC;QAC9C,YAAY,EAAE,wBAAwB;QACtC,SAAS,EAAE,+BAA+B;KAC3C,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEZ,MAAM,IAAI,CAAC,yBAAyB,CAAC;SAClC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;SACvB,MAAM,CAAC;QACN,KAAK,EAAE,uBAAuB;QAC9B,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,yEAAyE;KACvF,CAAC,CAAC;AACP,CAAC"}

package/dist/index.js

@@ -12,12 +12,16 @@
 // ============================================================================
 const rawArgs = process.argv.slice(2);
 const firstArg = rawArgs[0] || '';
-// Check if this is a CLI command
+// Check if this is a CLI command or flag
 const cliCommands = [
     'db:dump', 'db:export', 'db:import', 'query',
-    'suggest', 'track-plan', 'save', 'check-completion', 'mark-done', 'init'
+    'suggest', 'track-plan', 'save', 'check-completion', 'mark-done', 'init',
+    // New hook events (v4.2.0+)
+    'on-subagent-stop', 'on-stop', 'on-exit-plan',
 ];
-const isCliCommand = cliCommands.includes(firstArg);
+// CLI flags that should route to CLI (not MCP server)
+const cliFlags = ['--init', '--help', '--version'];
+const isCliCommand = cliCommands.includes(firstArg) || cliFlags.includes(firstArg);
 if (isCliCommand) {
     // Delegate to CLI module
     import('./cli.js').then(async (cli) => {
@@ -58,7 +62,7 @@ async function startMcpServer() {
     // Create MCP server
     const server = new Server({
         name: 'mcp-sqlew',
-        version: '4.0.4',
+        version: '4.2.0',
     }, {
         capabilities: {
             tools: {},

package/dist/index.js.map

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

package/dist/init-skills.d.ts

@@ -13,8 +13,13 @@ export declare function initializeSkills(projectRoot: string): void;
  */
 export declare function initializeClaudeMd(projectRoot: string): void;
 /**
- * Initialize all sqlew integrations (skills + CLAUDE.md + hooks)
+ * Initialize all sqlew integrations (skills + CLAUDE.md + hooks + gitignore)
  * Called during server startup
  */
 export declare function initializeSqlewIntegrations(projectRoot: string): void;
+/**
+ * Initialize .gitignore with sqlew auto-generated file entries
+ * Only adds entries if not already present
+ */
+export declare function initializeGitignore(projectRoot: string): void;
 //# sourceMappingURL=init-skills.d.ts.map

package/dist/init-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-skills.d.ts","sourceRoot":"","sources":["../src/init-skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAuC1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAoC5D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAcrE"}
+{"version":3,"file":"init-skills.d.ts","sourceRoot":"","sources":["../src/init-skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAuC1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAoC5D;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAiBrE;AAeD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAmC7D"}