sqlew 3.2.5 → 3.6.0

package/dist/utils/task-stale-detection.js

@@ -1,8 +1,12 @@
 /**
  * Auto-stale detection for Kanban Task Watcher
  * Automatically transitions abandoned tasks based on time thresholds
+ *
+ * CONVERTED: Using Knex.js with DatabaseAdapter (async/await)
  */
-import { getConfigBool, getConfigInt } from '../database.js';
+import { getConfigBool, getConfigInt, getAdapter } from '../database.js';
+import { calculateTaskArchiveCutoff } from './retention.js';
+import { detectVCS } from './vcs-adapter.js';
 /**
  * Task status IDs (matching schema)
  */
@@ -10,20 +14,33 @@ const TASK_STATUS = {
     TODO: 1,
     IN_PROGRESS: 2,
     WAITING_REVIEW: 3,
+    BLOCKED: 4,
+    DONE: 5,
+    ARCHIVED: 6,
 };
 /**
- * Configuration keys for task stale detection
+ * Configuration keys for task stale detection and review
  */
 const CONFIG_KEYS = {
     TASK_STALE_HOURS_IN_PROGRESS: 'task_stale_hours_in_progress',
     TASK_STALE_HOURS_WAITING_REVIEW: 'task_stale_hours_waiting_review',
     TASK_AUTO_STALE_ENABLED: 'task_auto_stale_enabled',
+    REVIEW_IDLE_MINUTES: 'review_idle_minutes',
+    REVIEW_REQUIRE_ALL_FILES_MODIFIED: 'review_require_all_files_modified',
+    REVIEW_REQUIRE_TESTS_PASS: 'review_require_tests_pass',
+    REVIEW_REQUIRE_COMPILE: 'review_require_compile',
+    GIT_AUTO_COMPLETE_ENABLED: 'git_auto_complete_enabled',
+    REQUIRE_ALL_FILES_COMMITTED: 'require_all_files_committed',
+    STALE_REVIEW_NOTIFICATION_HOURS: 'stale_review_notification_hours',
 };
 /**
  * Default configuration values
+ *
+ * STALE_HOURS_IN_PROGRESS: 18 hours (supports multi-day tasks and lunch breaks)
+ * STALE_HOURS_WAITING_REVIEW: 24 hours (1 day wait for review feedback)
  */
 const DEFAULTS = {
-    STALE_HOURS_IN_PROGRESS: 2,
+    STALE_HOURS_IN_PROGRESS: 18,
     STALE_HOURS_WAITING_REVIEW: 24,
     AUTO_STALE_ENABLED: true,
 };
@@ -32,61 +49,319 @@ const DEFAULTS = {
  *
  * Detection logic:
  * - Tasks in `in_progress` with `updated_ts` older than threshold → move to `waiting_review`
- * - Tasks in `waiting_review` with `updated_ts` older than threshold → move to `todo`
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @returns Count of transitioned tasks
  */
-export function detectAndTransitionStaleTasks(db) {
+export async function detectAndTransitionStaleTasks(adapter) {
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
     // 1. Check if auto-stale is enabled
-    const isEnabled = getConfigBool(db, CONFIG_KEYS.TASK_AUTO_STALE_ENABLED, DEFAULTS.AUTO_STALE_ENABLED);
+    const isEnabled = await getConfigBool(actualAdapter, CONFIG_KEYS.TASK_AUTO_STALE_ENABLED, DEFAULTS.AUTO_STALE_ENABLED);
     if (!isEnabled) {
         return 0;
     }
     // 2. Get threshold configs (in hours)
-    const inProgressThresholdHours = getConfigInt(db, CONFIG_KEYS.TASK_STALE_HOURS_IN_PROGRESS, DEFAULTS.STALE_HOURS_IN_PROGRESS);
-    const waitingReviewThresholdHours = getConfigInt(db, CONFIG_KEYS.TASK_STALE_HOURS_WAITING_REVIEW, DEFAULTS.STALE_HOURS_WAITING_REVIEW);
+    const inProgressThresholdHours = await getConfigInt(actualAdapter, CONFIG_KEYS.TASK_STALE_HOURS_IN_PROGRESS, DEFAULTS.STALE_HOURS_IN_PROGRESS);
+    const waitingReviewThresholdHours = await getConfigInt(actualAdapter, CONFIG_KEYS.TASK_STALE_HOURS_WAITING_REVIEW, DEFAULTS.STALE_HOURS_WAITING_REVIEW);
     // Convert hours to seconds for timestamp comparison
     const inProgressThresholdSeconds = inProgressThresholdHours * 3600;
     const waitingReviewThresholdSeconds = waitingReviewThresholdHours * 3600;
     let totalTransitioned = 0;
     // 3. Transition stale tasks in a transaction
-    const updateStmt = db.transaction(() => {
+    await actualAdapter.transaction(async (trx) => {
         // 3a. Find and transition in_progress tasks older than threshold to waiting_review
-        const inProgressTransitioned = db.prepare(`
-      UPDATE t_tasks
-      SET status_id = ?,
-          updated_ts = unixepoch()
-      WHERE status_id = ?
-        AND updated_ts < unixepoch() - ?
-    `).run(TASK_STATUS.WAITING_REVIEW, TASK_STATUS.IN_PROGRESS, inProgressThresholdSeconds);
-        totalTransitioned += inProgressTransitioned.changes;
-        // 3b. Find and transition waiting_review tasks older than threshold to todo
-        const waitingReviewTransitioned = db.prepare(`
-      UPDATE t_tasks
-      SET status_id = ?,
-          updated_ts = unixepoch()
-      WHERE status_id = ?
-        AND updated_ts < unixepoch() - ?
-    `).run(TASK_STATUS.TODO, TASK_STATUS.WAITING_REVIEW, waitingReviewThresholdSeconds);
-        totalTransitioned += waitingReviewTransitioned.changes;
+        const currentTs = Math.floor(Date.now() / 1000);
+        const cutoffTs = currentTs - inProgressThresholdSeconds;
+        const inProgressTransitioned = await trx('t_tasks')
+            .where('status_id', TASK_STATUS.IN_PROGRESS)
+            .where('updated_ts', '<', cutoffTs)
+            .update({
+            status_id: TASK_STATUS.WAITING_REVIEW,
+            updated_ts: currentTs
+        });
+        totalTransitioned += inProgressTransitioned;
     });
-    // Execute the transaction
-    updateStmt();
     // 4. Return count of transitioned tasks
     return totalTransitioned;
 }
 /**
  * Get current auto-stale configuration
  *
- * @param db - Database instance
+ * @param adapter - Database adapter instance
  * @returns Current configuration values
  */
-export function getStaleDetectionConfig(db) {
+export async function getStaleDetectionConfig(adapter) {
+    const actualAdapter = adapter ?? getAdapter();
     return {
-        enabled: getConfigBool(db, CONFIG_KEYS.TASK_AUTO_STALE_ENABLED, DEFAULTS.AUTO_STALE_ENABLED),
-        inProgressThresholdHours: getConfigInt(db, CONFIG_KEYS.TASK_STALE_HOURS_IN_PROGRESS, DEFAULTS.STALE_HOURS_IN_PROGRESS),
-        waitingReviewThresholdHours: getConfigInt(db, CONFIG_KEYS.TASK_STALE_HOURS_WAITING_REVIEW, DEFAULTS.STALE_HOURS_WAITING_REVIEW),
+        enabled: await getConfigBool(actualAdapter, CONFIG_KEYS.TASK_AUTO_STALE_ENABLED, DEFAULTS.AUTO_STALE_ENABLED),
+        inProgressThresholdHours: await getConfigInt(actualAdapter, CONFIG_KEYS.TASK_STALE_HOURS_IN_PROGRESS, DEFAULTS.STALE_HOURS_IN_PROGRESS),
+        waitingReviewThresholdHours: await getConfigInt(actualAdapter, CONFIG_KEYS.TASK_STALE_HOURS_WAITING_REVIEW, DEFAULTS.STALE_HOURS_WAITING_REVIEW),
     };
 }
+/**
+ * Auto-archive old done tasks
+ * Archives tasks in 'done' status older than configured threshold
+ * Uses weekend-aware retention logic (consistent with messages/files)
+ *
+ * Default: 48 hours (2 days)
+ * Weekend-aware: Task done Friday → archives Tuesday (skip Sat/Sun)
+ *
+ * @param adapter - Database adapter instance
+ * @returns Count of archived tasks
+ */
+export async function autoArchiveOldDoneTasks(adapter) {
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // Calculate cutoff timestamp using weekend-aware retention logic
+    const cutoffTimestamp = await calculateTaskArchiveCutoff(actualAdapter);
+    // Archive done tasks older than cutoff
+    const currentTs = Math.floor(Date.now() / 1000);
+    const archivedCount = await knex('t_tasks')
+        .where('status_id', TASK_STATUS.DONE)
+        .where('updated_ts', '<', cutoffTimestamp)
+        .update({
+        status_id: TASK_STATUS.ARCHIVED,
+        updated_ts: currentTs
+    });
+    return archivedCount;
+}
+/**
+ * Detect and complete tasks in waiting_review or in_progress when all watched files are committed
+ *
+ * VCS-aware auto-complete strategy (v3.4.0+):
+ * - Find all tasks in `waiting_review` or `in_progress` status with watched files
+ * - For each task, check if ALL watched files have been committed since task creation
+ * - Query VCS history to determine committed files
+ * - If all files committed → transition to `done` (VCS commit = implicit approval)
+ * - Supports multiple VCS: Git, Mercurial, SVN
+ * - Gracefully handle non-VCS repos (skip auto-complete)
+ *
+ * @param adapter - Database adapter instance
+ * @returns Count of auto-completed tasks
+ */
+export async function detectAndCompleteReviewedTasks(adapter) {
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // 1. Check if auto-complete is enabled
+    const isEnabled = await getConfigBool(actualAdapter, CONFIG_KEYS.GIT_AUTO_COMPLETE_ENABLED, true);
+    if (!isEnabled) {
+        return 0;
+    }
+    const requireAllFilesCommitted = await getConfigBool(actualAdapter, CONFIG_KEYS.REQUIRE_ALL_FILES_COMMITTED, true);
+    // 2. Find all waiting_review and in_progress tasks
+    const candidateTasks = await knex('t_tasks as t')
+        .join('m_task_statuses as s', 't.status_id', 's.id')
+        .whereIn('s.name', ['waiting_review', 'in_progress'])
+        .select('t.id', 't.created_ts', 's.name as status_name');
+    if (candidateTasks.length === 0) {
+        return 0;
+    }
+    let completed = 0;
+    const projectRoot = process.cwd();
+    // 3. Detect VCS type
+    const vcsAdapter = await detectVCS(projectRoot);
+    if (!vcsAdapter) {
+        // Not a VCS repository - skip VCS-aware completion
+        console.error('  ℹ Not a VCS repository (Git/Mercurial/SVN) - skipping VCS-aware auto-complete');
+        return 0;
+    }
+    console.error(`  ℹ VCS detected: ${vcsAdapter.getVCSType()}`);
+    // 4. For each candidate task, check if all watched files are committed
+    for (const task of candidateTasks) {
+        try {
+            // Get watched files for this task
+            const watchedFiles = await knex('t_task_file_links as tfl')
+                .join('m_files as f', 'tfl.file_id', 'f.id')
+                .where('tfl.task_id', task.id)
+                .select('f.path');
+            if (watchedFiles.length === 0) {
+                // No watched files - skip this task
+                continue;
+            }
+            const filePaths = watchedFiles.map(f => f.path);
+            // Query VCS history for commits since task creation
+            // Convert Unix timestamp to ISO 8601 format for VCS adapters
+            const sinceTimestamp = new Date(task.created_ts * 1000).toISOString();
+            let committedFiles;
+            try {
+                const committedFilesList = await vcsAdapter.getCommittedFilesSince(sinceTimestamp);
+                committedFiles = new Set(committedFilesList);
+            }
+            catch (error) {
+                // VCS query failed - skip this task
+                console.error(`  ⏸ Task #${task.id}: ${vcsAdapter.getVCSType()} query failed - ${error instanceof Error ? error.message : String(error)}`);
+                continue;
+            }
+            // Check if all watched files are committed
+            const uncommittedFiles = [];
+            for (const filePath of filePaths) {
+                if (!committedFiles.has(filePath)) {
+                    uncommittedFiles.push(filePath);
+                }
+            }
+            // Determine if task should auto-complete
+            const shouldComplete = requireAllFilesCommitted
+                ? uncommittedFiles.length === 0 // ALL files must be committed
+                : committedFiles.size > 0 && uncommittedFiles.length < filePaths.length; // At least SOME files committed
+            if (shouldComplete) {
+                // All watched files committed - transition to done
+                const currentTs = Math.floor(Date.now() / 1000);
+                await knex('t_tasks')
+                    .where({ id: task.id })
+                    .update({
+                    status_id: TASK_STATUS.DONE,
+                    updated_ts: currentTs
+                });
+                completed++;
+                console.error(`  ✓ Task #${task.id}: ${task.status_name} → done (all ${filePaths.length} watched files committed)`);
+            }
+            else if (uncommittedFiles.length > 0) {
+                console.error(`  ⏸ Task #${task.id}: ${uncommittedFiles.length} of ${filePaths.length} files not yet committed`);
+            }
+        }
+        catch (error) {
+            console.error(`  ✗ Error checking task #${task.id} for git commits:`, error);
+            continue;
+        }
+    }
+    return completed;
+}
+/**
+ * Detect and auto-complete tasks in waiting_review when all watched files are staged
+ * (v3.5.2 - Two-step Git-aware workflow: staging → done)
+ *
+ * Logic:
+ * - Find all tasks in waiting_review status
+ * - Check if ALL watched files are staged (git add)
+ * - If yes → transition to done
+ * - Respects git_auto_complete_on_stage config
+ *
+ * @param db - Database instance
+ * @returns Count of auto-completed tasks
+ */
+export async function detectAndCompleteOnStaging(adapter) {
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // TODO: Convert this function to use Knex.js
+    // For now, return 0 as this function is not used by tasks.ts
+    console.warn('detectAndCompleteOnStaging not yet fully converted to Knex.js');
+    return 0;
+}
+/**
+ * Detect and auto-archive tasks in done when all watched files are committed
+ * (v3.5.2 - Two-step Git-aware workflow: commit → archived)
+ *
+ * Logic:
+ * - Find all tasks in done status
+ * - Check if ALL watched files are committed (git commit)
+ * - If yes → transition to archived
+ * - Respects git_auto_archive_on_commit config
+ *
+ * @param db - Database instance
+ * @returns Count of auto-archived tasks
+ */
+export async function detectAndArchiveOnCommit(adapter) {
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // 1. Check if auto-archive on commit is enabled
+    const isEnabled = await getConfigBool(actualAdapter, 'git_auto_archive_on_commit', true);
+    if (!isEnabled) {
+        return 0;
+    }
+    const requireAllFilesCommitted = await getConfigBool(actualAdapter, 'require_all_files_committed_for_archive', true);
+    // 2. Find all done tasks
+    const candidateTasks = await knex('t_tasks as t')
+        .join('m_task_statuses as s', 't.status_id', 's.id')
+        .where('s.name', 'done')
+        .select('t.id', 't.created_ts');
+    if (candidateTasks.length === 0) {
+        return 0;
+    }
+    let archived = 0;
+    const projectRoot = process.cwd();
+    // 3. Detect VCS type
+    const vcsAdapter = await detectVCS(projectRoot);
+    if (!vcsAdapter) {
+        // Not a VCS repository - skip VCS-aware archiving
+        return 0;
+    }
+    // 4. For each candidate task, check if all watched files are committed
+    for (const task of candidateTasks) {
+        try {
+            // Get watched files for this task
+            const watchedFiles = await knex('t_task_file_links as tfl')
+                .join('m_files as f', 'tfl.file_id', 'f.id')
+                .where('tfl.task_id', task.id)
+                .select('f.path');
+            if (watchedFiles.length === 0) {
+                // No watched files - skip this task
+                continue;
+            }
+            const filePaths = watchedFiles.map(f => f.path);
+            // Query VCS history for commits since task creation
+            // Convert Unix timestamp to ISO 8601 format for VCS adapters
+            const sinceTimestamp = new Date(task.created_ts * 1000).toISOString();
+            let committedFiles;
+            try {
+                const committedFilesList = await vcsAdapter.getCommittedFilesSince(sinceTimestamp);
+                committedFiles = new Set(committedFilesList);
+            }
+            catch (error) {
+                // VCS query failed - skip this task
+                console.error(`  ⏸ Task #${task.id}: ${vcsAdapter.getVCSType()} commit query failed - ${error instanceof Error ? error.message : String(error)}`);
+                continue;
+            }
+            // Check if all watched files are committed
+            const uncommittedFiles = [];
+            for (const filePath of filePaths) {
+                if (!committedFiles.has(filePath)) {
+                    uncommittedFiles.push(filePath);
+                }
+            }
+            // Determine if task should auto-archive
+            const shouldArchive = requireAllFilesCommitted
+                ? uncommittedFiles.length === 0 // ALL files must be committed
+                : committedFiles.size > 0 && uncommittedFiles.length < filePaths.length; // At least SOME files committed
+            if (shouldArchive) {
+                // All watched files committed - transition to archived
+                const currentTs = Math.floor(Date.now() / 1000);
+                await knex('t_tasks')
+                    .where({ id: task.id })
+                    .update({
+                    status_id: TASK_STATUS.ARCHIVED,
+                    updated_ts: currentTs
+                });
+                archived++;
+                console.error(`  📦 Task #${task.id}: done → archived (all ${filePaths.length} watched files committed)`);
+            }
+        }
+        catch (error) {
+            console.error(`  ✗ Error checking task #${task.id} for commits:`, error);
+            continue;
+        }
+    }
+    return archived;
+}
+/**
+ * Detect and transition in_progress tasks to waiting_review based on quality gates
+ * Database-backed approach that survives restarts
+ *
+ * Quality gates:
+ * - Task has been idle (no updates) for configured time (default 3 minutes)
+ * - All watched files have been modified at least once
+ * - TypeScript compiles without errors (if .ts files)
+ * - Tests pass (if test files exist)
+ *
+ * @param db - Database instance
+ * @returns Count of transitioned tasks
+ */
+export async function detectAndTransitionToReview(adapter) {
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    // TODO: Convert this function to use Knex.js
+    // For now, return 0 as this function is not used by tasks.ts
+    console.warn('detectAndTransitionToReview not yet fully converted to Knex.js');
+    return 0;
+}
 //# sourceMappingURL=task-stale-detection.js.map

package/dist/utils/task-stale-detection.js.map

@@ -1 +1 @@
-{"version":3,"file":"task-stale-detection.js","sourceRoot":"","sources":["../../src/utils/task-stale-detection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,CAAC;IACP,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,CAAC;CACT,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,4BAA4B,EAAE,8BAA8B;IAC5D,+BAA+B,EAAE,iCAAiC;IAClE,uBAAuB,EAAE,yBAAyB;CAC1C,CAAC;AAEX;;GAEG;AACH,MAAM,QAAQ,GAAG;IACf,uBAAuB,EAAE,CAAC;IAC1B,0BAA0B,EAAE,EAAE;IAC9B,kBAAkB,EAAE,IAAI;CAChB,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAAY;IACxD,oCAAoC;IACpC,MAAM,SAAS,GAAG,aAAa,CAC7B,EAAE,EACF,WAAW,CAAC,uBAAuB,EACnC,QAAQ,CAAC,kBAAkB,CAC5B,CAAC;IAEF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,CAAC;IACX,CAAC;IAED,sCAAsC;IACtC,MAAM,wBAAwB,GAAG,YAAY,CAC3C,EAAE,EACF,WAAW,CAAC,4BAA4B,EACxC,QAAQ,CAAC,uBAAuB,CACjC,CAAC;IAEF,MAAM,2BAA2B,GAAG,YAAY,CAC9C,EAAE,EACF,WAAW,CAAC,+BAA+B,EAC3C,QAAQ,CAAC,0BAA0B,CACpC,CAAC;IAEF,oDAAoD;IACpD,MAAM,0BAA0B,GAAG,wBAAwB,GAAG,IAAI,CAAC;IACnE,MAAM,6BAA6B,GAAG,2BAA2B,GAAG,IAAI,CAAC;IAEzE,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAE1B,6CAA6C;IAC7C,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACrC,mFAAmF;QACnF,MAAM,sBAAsB,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;KAMzC,CAAC,CAAC,GAAG,CACJ,WAAW,CAAC,cAAc,EAC1B,WAAW,CAAC,WAAW,EACvB,0BAA0B,CAC3B,CAAC;QAEF,iBAAiB,IAAI,sBAAsB,CAAC,OAAO,CAAC;QAEpD,4EAA4E;QAC5E,MAAM,yBAAyB,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;KAM5C,CAAC,CAAC,GAAG,CACJ,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,cAAc,EAC1B,6BAA6B,CAC9B,CAAC;QAEF,iBAAiB,IAAI,yBAAyB,CAAC,OAAO,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,UAAU,EAAE,CAAC;IAEb,wCAAwC;IACxC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAY;IAKlD,OAAO;QACL,OAAO,EAAE,aAAa,CACpB,EAAE,EACF,WAAW,CAAC,uBAAuB,EACnC,QAAQ,CAAC,kBAAkB,CAC5B;QACD,wBAAwB,EAAE,YAAY,CACpC,EAAE,EACF,WAAW,CAAC,4BAA4B,EACxC,QAAQ,CAAC,uBAAuB,CACjC;QACD,2BAA2B,EAAE,YAAY,CACvC,EAAE,EACF,WAAW,CAAC,+BAA+B,EAC3C,QAAQ,CAAC,0BAA0B,CACpC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"task-stale-detection.js","sourceRoot":"","sources":["../../src/utils/task-stale-detection.ts"],"names":[],"mappings":"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"}

package/dist/utils/token-estimation.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Token Estimation Utility
+ *
+ * Provides token count estimation for help system responses.
+ * Uses a simple heuristic: ~4 characters per token (GPT-style tokenization)
+ *
+ * This is an approximation for measuring token efficiency gains.
+ * Actual token counts may vary based on tokenizer used.
+ */
+/**
+ * Estimate token count for a string or object
+ *
+ * @param data - String or object to estimate token count for
+ * @returns Estimated token count
+ */
+export declare function estimateTokens(data: string | object): number;
+/**
+ * Add token metadata to response object
+ *
+ * @param data - Response data
+ * @returns Response with token metadata
+ */
+export declare function addTokenMetadata<T extends object>(data: T): T & {
+    _token_info: {
+        estimated_tokens: number;
+        actual_chars: number;
+    };
+};
+/**
+ * Token ranges for different query types
+ */
+export declare const TOKEN_RANGES: {
+    readonly help_action: {
+        readonly min: 50;
+        readonly max: 100;
+        readonly legacy: 2000;
+    };
+    readonly help_params: {
+        readonly min: 30;
+        readonly max: 80;
+        readonly legacy: 1500;
+    };
+    readonly help_tool: {
+        readonly min: 100;
+        readonly max: 200;
+        readonly legacy: 5000;
+    };
+    readonly help_use_case: {
+        readonly min: 150;
+        readonly max: 200;
+        readonly legacy: 300;
+    };
+    readonly help_list_use_cases: {
+        readonly min: 100;
+        readonly max: 300;
+        readonly legacy: 500;
+    };
+    readonly help_next_actions: {
+        readonly min: 30;
+        readonly max: 50;
+        readonly legacy: 100;
+    };
+};
+/**
+ * Calculate token efficiency percentage
+ *
+ * @param current - Current token count
+ * @param legacy - Legacy token count
+ * @returns Efficiency gain percentage
+ */
+export declare function calculateEfficiencyGain(current: number, legacy: number): number;
+//# sourceMappingURL=token-estimation.d.ts.map

package/dist/utils/token-estimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimation.d.ts","sourceRoot":"","sources":["../../src/utils/token-estimation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAgB5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,WAAW,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAWnI;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOf,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG/E"}

package/dist/utils/token-estimation.js

@@ -0,0 +1,71 @@
+/**
+ * Token Estimation Utility
+ *
+ * Provides token count estimation for help system responses.
+ * Uses a simple heuristic: ~4 characters per token (GPT-style tokenization)
+ *
+ * This is an approximation for measuring token efficiency gains.
+ * Actual token counts may vary based on tokenizer used.
+ */
+/**
+ * Estimate token count for a string or object
+ *
+ * @param data - String or object to estimate token count for
+ * @returns Estimated token count
+ */
+export function estimateTokens(data) {
+    let text;
+    if (typeof data === 'string') {
+        text = data;
+    }
+    else {
+        // Convert object to JSON string
+        text = JSON.stringify(data);
+    }
+    // Simple heuristic: ~4 characters per token
+    // This is a conservative estimate for GPT-style tokenization
+    const charCount = text.length;
+    const tokenCount = Math.ceil(charCount / 4);
+    return tokenCount;
+}
+/**
+ * Add token metadata to response object
+ *
+ * @param data - Response data
+ * @returns Response with token metadata
+ */
+export function addTokenMetadata(data) {
+    const estimated_tokens = estimateTokens(data);
+    const actual_chars = JSON.stringify(data).length;
+    return {
+        ...data,
+        _token_info: {
+            estimated_tokens,
+            actual_chars
+        }
+    };
+}
+/**
+ * Token ranges for different query types
+ */
+export const TOKEN_RANGES = {
+    help_action: { min: 50, max: 100, legacy: 2000 },
+    help_params: { min: 30, max: 80, legacy: 1500 },
+    help_tool: { min: 100, max: 200, legacy: 5000 },
+    help_use_case: { min: 150, max: 200, legacy: 300 },
+    help_list_use_cases: { min: 100, max: 300, legacy: 500 },
+    help_next_actions: { min: 30, max: 50, legacy: 100 }
+};
+/**
+ * Calculate token efficiency percentage
+ *
+ * @param current - Current token count
+ * @param legacy - Legacy token count
+ * @returns Efficiency gain percentage
+ */
+export function calculateEfficiencyGain(current, legacy) {
+    if (legacy === 0)
+        return 0;
+    return Math.round((1 - current / legacy) * 100);
+}
+//# sourceMappingURL=token-estimation.js.map

package/dist/utils/token-estimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimation.js","sourceRoot":"","sources":["../../src/utils/token-estimation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAqB;IAClD,IAAI,IAAY,CAAC;IAEjB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,GAAG,IAAI,CAAC;IACd,CAAC;SAAM,CAAC;QACN,gCAAgC;QAChC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,4CAA4C;IAC5C,6DAA6D;IAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAE5C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAmB,IAAO;IACxD,MAAM,gBAAgB,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAEjD,OAAO;QACL,GAAG,IAAI;QACP,WAAW,EAAE;YACX,gBAAgB;YAChB,YAAY;SACb;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,WAAW,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAChD,WAAW,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;IAC/C,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAC/C,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IAClD,mBAAmB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IACxD,iBAAiB,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;CAC5C,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,MAAc;IACrE,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;AAClD,CAAC"}

package/dist/utils/token-logging.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Token Logging Utility
+ *
+ * Logs token usage to database for measuring help system efficiency.
+ */
+import { Database } from 'better-sqlite3';
+export interface TokenLogEntry {
+    query_type: string;
+    tool_name?: string;
+    action_name?: string;
+    estimated_tokens: number;
+    actual_chars: number;
+}
+/**
+ * Log token usage to database
+ *
+ * @param db - Database connection
+ * @param entry - Token log entry
+ */
+export declare function logTokenUsage(db: Database, entry: TokenLogEntry): void;
+/**
+ * Get token usage statistics for a query type
+ *
+ * @param db - Database connection
+ * @param query_type - Type of query
+ * @returns Statistics object
+ */
+export declare function getTokenStats(db: Database, query_type: string): {
+    total_queries: number;
+    avg_tokens: number;
+    min_tokens: number;
+    max_tokens: number;
+    total_tokens: number;
+} | null;
+/**
+ * Get all token usage statistics
+ *
+ * @param db - Database connection
+ * @returns Map of query type to statistics
+ */
+export declare function getAllTokenStats(db: Database): Map<string, {
+    total_queries: number;
+    avg_tokens: number;
+    min_tokens: number;
+    max_tokens: number;
+    total_tokens: number;
+}>;
+//# sourceMappingURL=token-logging.d.ts.map

package/dist/utils/token-logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-logging.d.ts","sourceRoot":"","sources":["../../src/utils/token-logging.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CA8BtE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CA0CP;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CA8CD"}