sqlew 3.5.3 → 3.6.0

package/dist/utils/activity-logging.js.map

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

package/dist/utils/batch.d.ts

@@ -41,7 +41,7 @@ export interface BatchResponse<T = any> {
  * );
  * ```
  */
-export declare function processBatch<TItem, TResult>(db: Database, items: TItem[], processor: (item: TItem, db: Database) => TResult, atomic?: boolean, maxItems?: number): BatchResponse<TResult>;
+export declare function processBatch<TItem, TResult>(db: Database, items: TItem[], processor: (item: TItem, db: Database) => TResult | Promise<TResult>, atomic?: boolean, maxItems?: number): Promise<BatchResponse<TResult>>;
 /**
  * Wrap a function with transaction handling
  * Converts an internal function (no transaction) to a public API (with transaction)
@@ -65,5 +65,5 @@ export declare function processBatch<TItem, TResult>(db: Database, items: TItem[
  * );
  * ```
  */
-export declare function withTransaction<TParams, TResult>(internalFn: (params: TParams, db: Database) => TResult, errorPrefix?: string): (params: TParams) => TResult;
+export declare function withTransaction<TParams, TResult>(internalFn: (params: TParams, db: Database) => TResult | Promise<TResult>, errorPrefix?: string): (params: TParams) => Promise<TResult>;
 //# sourceMappingURL=batch.d.ts.map

package/dist/utils/batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/utils/batch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EACzC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,KAAK,EAAE,EACd,SAAS,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,EACjD,MAAM,GAAE,OAAc,EACtB,QAAQ,GAAE,MAAW,GACpB,aAAa,CAAC,OAAO,CAAC,CAsFxB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAC9C,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,EACtD,WAAW,GAAE,MAA2B,GACvC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAgB9B"}
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/utils/batch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,OAAO,EAC/C,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,KAAK,EAAE,EACd,SAAS,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACpE,MAAM,GAAE,OAAc,EACtB,QAAQ,GAAE,MAAW,GACpB,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAsFjC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAC9C,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACzE,WAAW,GAAE,MAA2B,GACvC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAgBvC"}

package/dist/utils/batch.js

@@ -24,7 +24,7 @@ import { transaction } from '../database.js';
  * );
  * ```
  */
-export function processBatch(db, items, processor, atomic = true, maxItems = 50) {
+export async function processBatch(db, items, processor, atomic = true, maxItems = 50) {
     // Validate inputs
     if (!items || !Array.isArray(items)) {
         throw new Error('Items must be an array');
@@ -39,9 +39,9 @@ export function processBatch(db, items, processor, atomic = true, maxItems = 50)
     let processed = 0;
     let failed = 0;
     // Helper to process a single item
-    const processSingleItem = (item) => {
+    const processSingleItem = async (item) => {
         try {
-            const data = processor(item, db);
+            const data = await processor(item, db);
             results.push({
                 success: true,
                 data
@@ -64,9 +64,9 @@ export function processBatch(db, items, processor, atomic = true, maxItems = 50)
     try {
         if (atomic) {
             // Atomic mode: wrap in transaction, all succeed or all fail
-            return transaction(db, () => {
+            return await transaction(async () => {
                 for (const item of items) {
-                    processSingleItem(item);
+                    await processSingleItem(item);
                 }
                 return {
                     success: failed === 0,
@@ -79,7 +79,7 @@ export function processBatch(db, items, processor, atomic = true, maxItems = 50)
         else {
             // Non-atomic mode: process all, return individual results
             for (const item of items) {
-                processSingleItem(item);
+                await processSingleItem(item);
             }
             return {
                 success: failed === 0,
@@ -129,7 +129,7 @@ export function processBatch(db, items, processor, atomic = true, maxItems = 50)
  * ```
  */
 export function withTransaction(internalFn, errorPrefix = 'Operation failed') {
-    return (params) => {
+    return async (params) => {
         // Note: getDatabase() must be imported where this is used
         // We can't import it here to avoid circular dependencies
         const db = global.__database;
@@ -137,7 +137,7 @@ export function withTransaction(internalFn, errorPrefix = 'Operation failed') {
             throw new Error('Database not initialized');
         }
         try {
-            return transaction(db, () => internalFn(params, db));
+            return await transaction(async () => await internalFn(params, db));
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);

package/dist/utils/batch.js.map

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

package/dist/utils/cleanup.d.ts

@@ -1,56 +1,64 @@
 /**
  * Programmatic cleanup utilities for old messages and file changes
  * Replaces the automatic triggers with weekend-aware logic
+ *
+ * CONVERTED: Using Knex.js with DatabaseAdapter (async/await)
  */
-import { Database } from '../types.js';
+import { DatabaseAdapter } from '../adapters/index.js';
+import { Knex } from 'knex';
 /**
  * Perform automatic cleanup of old data
  * Deletes old messages, file changes, and activity logs based on m_config settings
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
+ * @param trx - Optional transaction
  * @returns Object with counts of deleted records
  */
-export declare function performAutoCleanup(db: Database): {
+export declare function performAutoCleanup(adapter: DatabaseAdapter, trx?: Knex.Transaction): Promise<{
     messagesDeleted: number;
     fileChangesDeleted: number;
     activityLogsDeleted: number;
-};
+}>;
 /**
  * Delete old messages before the cutoff timestamp
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @param cutoffTimestamp - Unix timestamp (seconds) for cutoff
+ * @param trx - Optional transaction
  * @returns Number of messages deleted
  */
-export declare function cleanupMessages(db: Database, cutoffTimestamp: number): number;
+export declare function cleanupMessages(adapter: DatabaseAdapter, cutoffTimestamp: number, trx?: Knex.Transaction): Promise<number>;
 /**
  * Delete old file changes before the cutoff timestamp
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @param cutoffTimestamp - Unix timestamp (seconds) for cutoff
+ * @param trx - Optional transaction
  * @returns Number of file changes deleted
  */
-export declare function cleanupFileChanges(db: Database, cutoffTimestamp: number): number;
+export declare function cleanupFileChanges(adapter: DatabaseAdapter, cutoffTimestamp: number, trx?: Knex.Transaction): Promise<number>;
 /**
  * Delete old activity logs before the cutoff timestamp
  * Activity logs use the same retention as messages (constraint #4)
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @param cutoffTimestamp - Unix timestamp (seconds) for cutoff
+ * @param trx - Optional transaction
  * @returns Number of activity logs deleted
  */
-export declare function cleanupActivityLogs(db: Database, cutoffTimestamp: number): number;
+export declare function cleanupActivityLogs(adapter: DatabaseAdapter, cutoffTimestamp: number, trx?: Knex.Transaction): Promise<number>;
 /**
  * Cleanup with custom retention periods (overrides config)
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @param messageHours - Message retention in hours (optional)
  * @param fileChangeDays - File change retention in days (optional)
+ * @param trx - Optional transaction
  * @returns Object with counts of deleted records
  */
-export declare function cleanupWithCustomRetention(db: Database, messageHours?: number, fileChangeDays?: number): {
+export declare function cleanupWithCustomRetention(adapter: DatabaseAdapter, messageHours?: number, fileChangeDays?: number, trx?: Knex.Transaction): Promise<{
     messagesDeleted: number;
     fileChangesDeleted: number;
     activityLogsDeleted: number;
-};
+}>;
 //# sourceMappingURL=cleanup.d.ts.map

package/dist/utils/cleanup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/utils/cleanup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAUrI;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAG7E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAGjF;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,QAAQ,EACZ,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAkBtF"}
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/utils/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,GACrB,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAAC,CAU/F;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,eAAe,EACxB,eAAe,EAAE,MAAM,EACvB,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,EACxB,eAAe,EAAE,MAAM,EACvB,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,eAAe,EACxB,eAAe,EAAE,MAAM,EACvB,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,eAAe,EACxB,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,EACvB,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,GACrB,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB/F"}

package/dist/utils/cleanup.js

@@ -1,79 +1,86 @@
 /**
  * Programmatic cleanup utilities for old messages and file changes
  * Replaces the automatic triggers with weekend-aware logic
+ *
+ * CONVERTED: Using Knex.js with DatabaseAdapter (async/await)
  */
 import { calculateMessageCutoff, calculateFileChangeCutoff } from './retention.js';
 /**
  * Perform automatic cleanup of old data
  * Deletes old messages, file changes, and activity logs based on m_config settings
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
+ * @param trx - Optional transaction
  * @returns Object with counts of deleted records
  */
-export function performAutoCleanup(db) {
-    const messageCutoff = calculateMessageCutoff(db);
-    const fileChangeCutoff = calculateFileChangeCutoff(db);
-    const messagesDeleted = cleanupMessages(db, messageCutoff);
-    const fileChangesDeleted = cleanupFileChanges(db, fileChangeCutoff);
+export async function performAutoCleanup(adapter, trx) {
+    const messageCutoff = await calculateMessageCutoff(adapter);
+    const fileChangeCutoff = await calculateFileChangeCutoff(adapter);
+    const messagesDeleted = await cleanupMessages(adapter, messageCutoff, trx);
+    const fileChangesDeleted = await cleanupFileChanges(adapter, fileChangeCutoff, trx);
     // Activity log uses same retention as messages (constraint #4)
-    const activityLogsDeleted = cleanupActivityLogs(db, messageCutoff);
+    const activityLogsDeleted = await cleanupActivityLogs(adapter, messageCutoff, trx);
     return { messagesDeleted, fileChangesDeleted, activityLogsDeleted };
 }
 /**
  * Delete old messages before the cutoff timestamp
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @param cutoffTimestamp - Unix timestamp (seconds) for cutoff
+ * @param trx - Optional transaction
  * @returns Number of messages deleted
  */
-export function cleanupMessages(db, cutoffTimestamp) {
-    const result = db.prepare('DELETE FROM t_agent_messages WHERE ts < ?').run(cutoffTimestamp);
-    return result.changes;
+export async function cleanupMessages(adapter, cutoffTimestamp, trx) {
+    const knex = trx || adapter.getKnex();
+    return await knex('t_agent_messages').where('ts', '<', cutoffTimestamp).delete();
 }
 /**
  * Delete old file changes before the cutoff timestamp
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @param cutoffTimestamp - Unix timestamp (seconds) for cutoff
+ * @param trx - Optional transaction
  * @returns Number of file changes deleted
  */
-export function cleanupFileChanges(db, cutoffTimestamp) {
-    const result = db.prepare('DELETE FROM t_file_changes WHERE ts < ?').run(cutoffTimestamp);
-    return result.changes;
+export async function cleanupFileChanges(adapter, cutoffTimestamp, trx) {
+    const knex = trx || adapter.getKnex();
+    return await knex('t_file_changes').where('ts', '<', cutoffTimestamp).delete();
 }
 /**
  * Delete old activity logs before the cutoff timestamp
  * Activity logs use the same retention as messages (constraint #4)
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @param cutoffTimestamp - Unix timestamp (seconds) for cutoff
+ * @param trx - Optional transaction
  * @returns Number of activity logs deleted
  */
-export function cleanupActivityLogs(db, cutoffTimestamp) {
-    const result = db.prepare('DELETE FROM t_activity_log WHERE ts < ?').run(cutoffTimestamp);
-    return result.changes;
+export async function cleanupActivityLogs(adapter, cutoffTimestamp, trx) {
+    const knex = trx || adapter.getKnex();
+    return await knex('t_activity_log').where('ts', '<', cutoffTimestamp).delete();
 }
 /**
  * Cleanup with custom retention periods (overrides config)
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @param messageHours - Message retention in hours (optional)
  * @param fileChangeDays - File change retention in days (optional)
+ * @param trx - Optional transaction
  * @returns Object with counts of deleted records
  */
-export function cleanupWithCustomRetention(db, messageHours, fileChangeDays) {
+export async function cleanupWithCustomRetention(adapter, messageHours, fileChangeDays, trx) {
     let messagesDeleted = 0;
     let fileChangesDeleted = 0;
     let activityLogsDeleted = 0;
     if (messageHours !== undefined) {
         const messageCutoff = Math.floor(Date.now() / 1000) - (messageHours * 3600);
-        messagesDeleted = cleanupMessages(db, messageCutoff);
+        messagesDeleted = await cleanupMessages(adapter, messageCutoff, trx);
         // Activity log uses same retention as messages (constraint #4)
-        activityLogsDeleted = cleanupActivityLogs(db, messageCutoff);
+        activityLogsDeleted = await cleanupActivityLogs(adapter, messageCutoff, trx);
     }
     if (fileChangeDays !== undefined) {
         const fileChangeCutoff = Math.floor(Date.now() / 1000) - (fileChangeDays * 86400);
-        fileChangesDeleted = cleanupFileChanges(db, fileChangeCutoff);
+        fileChangesDeleted = await cleanupFileChanges(adapter, fileChangeCutoff, trx);
     }
     return { messagesDeleted, fileChangesDeleted, activityLogsDeleted };
 }

package/dist/utils/cleanup.js.map

@@ -1 +1 @@
-{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/utils/cleanup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAY;IAC7C,MAAM,aAAa,GAAG,sBAAsB,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAEvD,MAAM,eAAe,GAAG,eAAe,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAC3D,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACpE,+DAA+D;IAC/D,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAEnE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,EAAY,EAAE,eAAuB;IACnE,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAY,EAAE,eAAuB;IACtE,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC1F,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAY,EAAE,eAAuB;IACvE,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,yCAAyC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC1F,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,EAAY,EACZ,YAAqB,EACrB,cAAuB;IAEvB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,IAAI,mBAAmB,GAAG,CAAC,CAAC;IAE5B,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;QAC5E,eAAe,GAAG,eAAe,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QACrD,+DAA+D;QAC/D,mBAAmB,GAAG,mBAAmB,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC;QAClF,kBAAkB,GAAG,kBAAkB,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;AACtE,CAAC"}
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../src/utils/cleanup.ts"],"names":[],"mappings":"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"}

package/dist/utils/debug-logger.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Debug Logger for MCP Shared Context Server
+ *
+ * Enables debug logging when specified via CLI arg, environment variable, or config file.
+ * Priority: CLI arg > Environment variable > Config file
+ *
+ * Usage:
+ *   node dist/index.js --debug-log=/path/to/debug.log
+ *   SQLEW_DEBUG=/path/to/debug.log node dist/index.js
+ *   OR set debug.log_path in .sqlew/config.toml
+ */
+/**
+ * Initialize debug logger
+ * @param debugLogPath - Log path (already resolved with priority: CLI > env > config)
+ */
+export declare function initDebugLogger(debugLogPath?: string): void;
+/**
+ * Write debug log entry
+ * @param level - Log level (INFO, WARN, ERROR, DEBUG)
+ * @param message - Log message
+ * @param data - Optional data to log
+ */
+export declare function debugLog(level: 'INFO' | 'WARN' | 'ERROR' | 'DEBUG', message: string, data?: any): void;
+/**
+ * Log MCP tool call
+ */
+export declare function debugLogToolCall(toolName: string, action: string, params: any): void;
+/**
+ * Log MCP tool response
+ */
+export declare function debugLogToolResponse(toolName: string, action: string, success: boolean, result?: any, error?: any): void;
+/**
+ * Log error with stack trace
+ */
+export declare function debugLogError(context: string, error: any): void;
+/**
+ * Close debug logger
+ */
+export declare function closeDebugLogger(): void;
+/**
+ * Check if debug logging is enabled
+ */
+export declare function isDebugEnabled(): boolean;
+//# sourceMappingURL=debug-logger.d.ts.map

package/dist/utils/debug-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-logger.d.ts","sourceRoot":"","sources":["../../src/utils/debug-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAmC3D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAoBtG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAEpF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI,CAMxH;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAK/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAQvC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC"}

package/dist/utils/debug-logger.js

@@ -0,0 +1,116 @@
+/**
+ * Debug Logger for MCP Shared Context Server
+ *
+ * Enables debug logging when specified via CLI arg, environment variable, or config file.
+ * Priority: CLI arg > Environment variable > Config file
+ *
+ * Usage:
+ *   node dist/index.js --debug-log=/path/to/debug.log
+ *   SQLEW_DEBUG=/path/to/debug.log node dist/index.js
+ *   OR set debug.log_path in .sqlew/config.toml
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+let debugEnabled = false;
+let debugStream = null;
+let currentLogPath = null;
+/**
+ * Initialize debug logger
+ * @param debugLogPath - Log path (already resolved with priority: CLI > env > config)
+ */
+export function initDebugLogger(debugLogPath) {
+    if (!debugLogPath) {
+        return;
+    }
+    currentLogPath = debugLogPath;
+    try {
+        // Ensure directory exists
+        const logDir = path.dirname(debugLogPath);
+        if (!fs.existsSync(logDir)) {
+            fs.mkdirSync(logDir, { recursive: true });
+        }
+        // Create write stream (append mode)
+        debugStream = fs.createWriteStream(debugLogPath, { flags: 'a' });
+        debugEnabled = true;
+        // Detect source (for logging purposes)
+        const cliArg = process.argv.find(arg => arg.startsWith('--debug-log'));
+        const envVar = process.env.SQLEW_DEBUG;
+        const source = cliArg ? 'CLI Argument' : envVar ? 'Environment Variable' : 'Config File';
+        const sourceDetail = cliArg ? '--debug-log' : envVar ? 'SQLEW_DEBUG' : 'debug.log_path';
+        debugLog('INFO', '='.repeat(80));
+        debugLog('INFO', `MCP Shared Context Server Debug Log Started`);
+        debugLog('INFO', `Timestamp: ${new Date().toISOString()}`);
+        debugLog('INFO', `Process ID: ${process.pid}`);
+        debugLog('INFO', `Debug Log Path: ${debugLogPath}`);
+        debugLog('INFO', `Source: ${source} (${sourceDetail})`);
+        debugLog('INFO', '='.repeat(80));
+    }
+    catch (error) {
+        console.error(`Failed to initialize debug logger: ${error}`);
+        debugEnabled = false;
+    }
+}
+/**
+ * Write debug log entry
+ * @param level - Log level (INFO, WARN, ERROR, DEBUG)
+ * @param message - Log message
+ * @param data - Optional data to log
+ */
+export function debugLog(level, message, data) {
+    if (!debugEnabled || !debugStream) {
+        return;
+    }
+    const timestamp = new Date().toISOString();
+    let logEntry = `[${timestamp}] [${level}] ${message}`;
+    try {
+        if (data !== undefined) {
+            const dataStr = typeof data === 'string'
+                ? data
+                : JSON.stringify(data);
+            logEntry += ` | Data: ${dataStr}`;
+        }
+        debugStream.write(logEntry + '\n');
+    }
+    catch (error) {
+        console.error(`Failed to write debug log: ${error}`);
+    }
+}
+/**
+ * Log MCP tool call
+ */
+export function debugLogToolCall(toolName, action, params) {
+    debugLog('DEBUG', `Tool Call: ${toolName}.${action}`, { params });
+}
+/**
+ * Log MCP tool response
+ */
+export function debugLogToolResponse(toolName, action, success, result, error) {
+    debugLog(success ? 'DEBUG' : 'ERROR', `Tool Response: ${toolName}.${action} ${success ? 'SUCCESS' : 'FAILED'}`, success ? result : error);
+}
+/**
+ * Log error with stack trace
+ */
+export function debugLogError(context, error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const stack = error instanceof Error ? error.stack : undefined;
+    debugLog('ERROR', `${context}: ${errorMessage}`, { stack });
+}
+/**
+ * Close debug logger
+ */
+export function closeDebugLogger() {
+    if (debugStream) {
+        debugLog('INFO', 'MCP Shared Context Server Debug Log Ended');
+        debugLog('INFO', '='.repeat(80));
+        debugStream.end();
+        debugStream = null;
+        debugEnabled = false;
+    }
+}
+/**
+ * Check if debug logging is enabled
+ */
+export function isDebugEnabled() {
+    return debugEnabled;
+}
+//# sourceMappingURL=debug-logger.js.map

package/dist/utils/debug-logger.js.map

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

package/dist/utils/help-tracking.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Help Action Usage Tracking
+ *
+ * Lightweight logging system to track help/example action invocations
+ * for understanding usage patterns and optimizing documentation.
+ *
+ * Data collected:
+ * - tool_name: Which MCP tool invoked help/example
+ * - action_name: "help" or "example"
+ * - timestamp: When the action was invoked
+ * - token_count: Estimated tokens in request + response
+ *
+ * Storage: Temporary log file in .sqlew/tmp/help-usage.log
+ * Format: JSON lines (one JSON object per line for easy parsing)
+ * Retention: Manual cleanup after 1-2 week analysis period
+ */
+/**
+ * Help action invocation record
+ */
+export interface HelpUsageRecord {
+    tool_name: string;
+    action_name: 'help' | 'example';
+    timestamp: string;
+    token_count: number;
+    context?: string;
+}
+/**
+ * Log a help action invocation
+ * Appends JSON line to log file for analysis
+ *
+ * @param record - Help usage record to log
+ */
+export declare function logHelpUsage(record: HelpUsageRecord): void;
+/**
+ * Estimate token count for help/example action
+ * Rough estimation based on response length
+ *
+ * @param toolName - Name of the MCP tool
+ * @param actionName - "help" or "example"
+ * @param responseLength - Length of response text
+ * @returns Estimated token count (request + response)
+ */
+export declare function estimateHelpTokens(toolName: string, actionName: 'help' | 'example', responseLength: number): number;
+/**
+ * Track help action and return the help content
+ * Convenience wrapper that logs and returns content
+ *
+ * @param toolName - Name of the MCP tool
+ * @param actionName - "help" or "example"
+ * @param content - Help content to return
+ * @param context - Optional context about what triggered help
+ * @returns The help content (pass-through)
+ */
+export declare function trackAndReturnHelp(toolName: string, actionName: 'help' | 'example', content: string, context?: string): string;
+//# sourceMappingURL=help-tracking.d.ts.map

package/dist/utils/help-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-tracking.d.ts","sourceRoot":"","sources":["../../src/utils/help-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkBD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAW1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,cAAc,EAAE,MAAM,GACrB,MAAM,CAQR;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAYR"}