sqlew 4.3.1 → 5.0.0

package/dist/tools/example/actions/search.js

@@ -1,52 +1,38 @@
 /**
  * Example Tool - search Action
  * Search examples by keyword
+ *
+ * TOML-based implementation (v5.0+)
+ * Loads from src/help-data/*.toml instead of database
+ *
+ * v5.0.1: Environment-aware example filtering (sqlite/cloud/all)
  */
-import { getAdapter } from '../../../database.js';
+import { getHelpLoader } from '../../../help-loader.js';
+import { shouldShowExample } from '../../../utils/example-filter.js';
 /**
  * Search examples by keyword with optional filters
- * Returns truncated preview of matching examples
+ * Uses HelpSystemLoader (TOML-based)
+ * Filters results by current environment
  */
-export async function searchExamples(params, adapter) {
-    const actualAdapter = adapter ?? getAdapter();
-    const db = actualAdapter.getKnex();
-    try {
-        let query = db('v4_help_action_examples')
-            .join('v4_help_actions', 'v4_help_action_examples.action_id', 'v4_help_actions.id')
-            .where(function () {
-            this.where('v4_help_action_examples.title', 'like', `%${params.keyword}%`)
-                .orWhere('v4_help_action_examples.explanation', 'like', `%${params.keyword}%`)
-                .orWhere('v4_help_action_examples.code', 'like', `%${params.keyword}%`);
-        });
-        // Apply optional filters
-        if (params.tool) {
-            query = query.where('v4_help_actions.tool_name', params.tool);
-        }
-        if (params.action_name) {
-            query = query.where('v4_help_actions.action_name', params.action_name);
-        }
-        const examples = await query
-            .select('v4_help_action_examples.id as example_id', 'v4_help_action_examples.title', 'v4_help_actions.tool_name as tool', 'v4_help_actions.action_name as action', 'v4_help_action_examples.code')
-            .limit(20); // Limit to 20 results
-        if (examples.length === 0) {
-            return {
-                total: 0,
-                examples: []
-            };
-        }
-        return {
-            total: examples.length,
-            examples: examples.map(ex => ({
-                example_id: ex.example_id,
-                title: ex.title,
-                tool: ex.tool,
-                action: ex.action,
-                preview: ex.code.substring(0, 100) + (ex.code.length > 100 ? '...' : '')
-            }))
-        };
-    }
-    catch (error) {
-        return { error: `Failed to search examples: ${error.message}` };
-    }
+export async function searchExamples(params) {
+    const loader = await getHelpLoader();
+    const results = loader.searchExamples(params.keyword, {
+        tool: params.tool,
+        limit: 40 // Fetch more to account for filtering
+    });
+    // Filter by environment (sqlite/cloud)
+    const filtered = results.filter(r => shouldShowExample(r.example.target_type));
+    // Apply original limit after filtering
+    const limited = filtered.slice(0, 20);
+    return {
+        total: limited.length,
+        examples: limited.map((r, index) => ({
+            example_id: index + 1,
+            title: r.example.title,
+            tool: r.tool,
+            action: r.action,
+            preview: r.example.code.substring(0, 100) + (r.example.code.length > 100 ? '...' : '')
+        }))
+    };
 }
 //# sourceMappingURL=search.js.map

package/dist/tools/example/actions/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../../src/tools/example/actions/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA2B,EAC3B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;IAEnC,IAAI,CAAC;QACH,IAAI,KAAK,GAAG,EAAE,CAAC,yBAAyB,CAAC;aACtC,IAAI,CAAC,iBAAiB,EAAE,mCAAmC,EAAE,oBAAoB,CAAC;aAClF,KAAK,CAAC;YACL,IAAI,CAAC,KAAK,CAAC,+BAA+B,EAAE,MAAM,EAAE,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC;iBACvE,OAAO,CAAC,qCAAqC,EAAE,MAAM,EAAE,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC;iBAC7E,OAAO,CAAC,8BAA8B,EAAE,MAAM,EAAE,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEL,yBAAyB;QACzB,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,2BAA2B,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,6BAA6B,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK;aACzB,MAAM,CACL,0CAA0C,EAC1C,+BAA+B,EAC/B,mCAAmC,EACnC,uCAAuC,EACvC,8BAA8B,CAC/B;aACA,KAAK,CAAC,EAAE,CAAC,CAAC,CAAE,sBAAsB;QAErC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,KAAK,EAAE,CAAC;gBACR,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC5B,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;aACzE,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,8BAA+B,KAAe,CAAC,OAAO,EAAE,EAAE,CAAC;IAC7E,CAAC;AACH,CAAC"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../../src/tools/example/actions/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAGrE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA2B;IAE3B,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;IAErC,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE;QACpD,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,EAAE,CAAE,sCAAsC;KAClD,CAAC,CAAC;IAEH,uCAAuC;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAE/E,uCAAuC;IACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEtC,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACnC,UAAU,EAAE,KAAK,GAAG,CAAC;YACrB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK;YACtB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;SACvF,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/tools/help/actions/batch-guide.js

@@ -20,11 +20,11 @@ export async function batchGuide(params, adapter) {
         }
         const [tool, action] = parts;
         // Query for batch-specific examples
-        const examples = await db('v4_help_action_examples')
-            .join('v4_help_actions', 'v4_help_action_examples.action_id', 'v4_help_actions.action_id')
-            .where('v4_help_actions.tool_name', tool)
-            .where('v4_help_actions.action_name', action)
-            .select('v4_help_action_examples.example_title as title', 'v4_help_action_examples.example_code as code', 'v4_help_action_examples.explanation');
+        const examples = await db('t_help_action_examples')
+            .join('m_help_actions', 't_help_action_examples.action_id', 'm_help_actions.action_id')
+            .where('m_help_actions.tool_name', tool)
+            .where('m_help_actions.action_name', action)
+            .select('t_help_action_examples.example_title as title', 't_help_action_examples.example_code as code', 't_help_action_examples.explanation');
         if (examples.length === 0) {
             return {
                 error: `No examples found for operation "${params.operation}". Check tool and action names.`

package/dist/tools/help/actions/batch-guide.js.map

@@ -1 +1 @@
-{"version":3,"file":"batch-guide.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/batch-guide.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAA4B,EAC5B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;IAEnC,IAAI,CAAC;QACH,+EAA+E;QAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,KAAK,EAAE,uEAAuE;aAC/E,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;QAE7B,oCAAoC;QACpC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,yBAAyB,CAAC;aACjD,IAAI,CAAC,iBAAiB,EAAE,mCAAmC,EAAE,2BAA2B,CAAC;aACzF,KAAK,CAAC,2BAA2B,EAAE,IAAI,CAAC;aACxC,KAAK,CAAC,6BAA6B,EAAE,MAAM,CAAC;aAC5C,MAAM,CACL,gDAAgD,EAChD,8CAA8C,EAC9C,qCAAqC,CACtC,CAAC;QAEJ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,KAAK,EAAE,oCAAoC,MAAM,CAAC,SAAS,iCAAiC;aAC7F,CAAC;QACJ,CAAC;QAED,8CAA8C;QAC9C,MAAM,aAAa,GAAG;YACpB,sDAAsD;YACtD,8DAA8D;YAC9D,sEAAsE;YACtE,oDAAoD;YACpD,yDAAyD;SAC1D,CAAC;QAEF,MAAM,YAAY,GAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,CAAC;YAC7D,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,WAAW,EAAE,EAAE,CAAC,WAAW;SAC5B,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,6BAA6B,IAAI,IAAI,MAAM,EAAE;YAC1D,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE;YAC/B,cAAc,EAAE,aAAa;YAC7B,QAAQ,EAAE,YAAY;SACvB,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,EAAE,KAAK,EAAE,gCAAgC,OAAO,EAAE,EAAE,CAAC;IAC9D,CAAC;AACH,CAAC"}
+{"version":3,"file":"batch-guide.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/batch-guide.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAA4B,EAC5B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;IAEnC,IAAI,CAAC;QACH,+EAA+E;QAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,KAAK,EAAE,uEAAuE;aAC/E,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;QAE7B,oCAAoC;QACpC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,wBAAwB,CAAC;aAChD,IAAI,CAAC,gBAAgB,EAAE,kCAAkC,EAAE,0BAA0B,CAAC;aACtF,KAAK,CAAC,0BAA0B,EAAE,IAAI,CAAC;aACvC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC;aAC3C,MAAM,CACL,+CAA+C,EAC/C,6CAA6C,EAC7C,oCAAoC,CACrC,CAAC;QAEJ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,KAAK,EAAE,oCAAoC,MAAM,CAAC,SAAS,iCAAiC;aAC7F,CAAC;QACJ,CAAC;QAED,8CAA8C;QAC9C,MAAM,aAAa,GAAG;YACpB,sDAAsD;YACtD,8DAA8D;YAC9D,sEAAsE;YACtE,oDAAoD;YACpD,yDAAyD;SAC1D,CAAC;QAEF,MAAM,YAAY,GAAkB,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,CAAC;YAC7D,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,WAAW,EAAE,EAAE,CAAC,WAAW;SAC5B,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,6BAA6B,IAAI,IAAI,MAAM,EAAE;YAC1D,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE;YAC/B,cAAc,EAAE,aAAa;YAC7B,QAAQ,EAAE,YAAY;SACvB,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,EAAE,KAAK,EAAE,gCAAgC,OAAO,EAAE,EAAE,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/tools/help/actions/query-action.d.ts

@@ -1,14 +1,18 @@
 /**
  * Help Tool - query_action Action
  * Get action documentation with parameters and examples
+ *
+ * TOML-based implementation (v5.0+)
+ * Loads from src/help-data/*.toml instead of database
+ *
+ * v5.0.1: Environment-aware example filtering (sqlite/cloud/all)
  */
-import { DatabaseAdapter } from '../../../adapters/index.js';
 import { HelpQueryActionParams, HelpActionResult } from '../types.js';
 /**
  * Query single action with parameters and examples
- * Reuses existing queryHelpAction from help-queries.ts
+ * Uses HelpSystemLoader (TOML-based)
  */
-export declare function queryAction(params: HelpQueryActionParams, adapter?: DatabaseAdapter): Promise<HelpActionResult | {
+export declare function queryAction(params: HelpQueryActionParams): Promise<HelpActionResult | {
     error: string;
     available_actions?: string[];
 }>;

package/dist/tools/help/actions/query-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-action.d.ts","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAG7E"}
+{"version":3,"file":"query-action.d.ts","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-action.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA+B7E"}

package/dist/tools/help/actions/query-action.js

@@ -1,15 +1,44 @@
 /**
  * Help Tool - query_action Action
  * Get action documentation with parameters and examples
+ *
+ * TOML-based implementation (v5.0+)
+ * Loads from src/help-data/*.toml instead of database
+ *
+ * v5.0.1: Environment-aware example filtering (sqlite/cloud/all)
  */
-import { getAdapter } from '../../../database.js';
-import { queryHelpAction } from '../../help-queries.js';
+import { getHelpLoader } from '../../../help-loader.js';
+import { filterExamplesByEnvironment } from '../../../utils/example-filter.js';
 /**
  * Query single action with parameters and examples
- * Reuses existing queryHelpAction from help-queries.ts
+ * Uses HelpSystemLoader (TOML-based)
  */
-export async function queryAction(params, adapter) {
-    const actualAdapter = adapter ?? getAdapter();
-    return await queryHelpAction(actualAdapter, params.tool, params.target_action);
+export async function queryAction(params) {
+    const loader = await getHelpLoader();
+    // Check if tool exists
+    const tool = loader.getTool(params.tool);
+    if (!tool) {
+        return {
+            error: `Tool "${params.tool}" not found`,
+            available_actions: loader.getToolNames()
+        };
+    }
+    // Get action
+    const action = loader.getAction(params.tool, params.target_action);
+    if (!action) {
+        return {
+            error: `Action "${params.target_action}" not found for tool "${params.tool}"`,
+            available_actions: loader.getActionNames(params.tool)
+        };
+    }
+    // Filter examples by current environment (sqlite/cloud)
+    const filteredExamples = filterExamplesByEnvironment(action.examples);
+    return {
+        tool: params.tool,
+        action: action.name,
+        description: action.description,
+        parameters: action.params,
+        examples: filteredExamples
+    };
 }
 //# sourceMappingURL=query-action.js.map

package/dist/tools/help/actions/query-action.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-action.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA6B,EAC7B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,OAAO,MAAM,eAAe,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;AACjF,CAAC"}
+{"version":3,"file":"query-action.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-action.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAG/E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;IAErC,uBAAuB;IACvB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,KAAK,EAAE,SAAS,MAAM,CAAC,IAAI,aAAa;YACxC,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE;SACzC,CAAC;IACJ,CAAC;IAED,aAAa;IACb,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,KAAK,EAAE,WAAW,MAAM,CAAC,aAAa,yBAAyB,MAAM,CAAC,IAAI,GAAG;YAC7E,iBAAiB,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC;SACtD,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEtE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,MAAM;QACzB,QAAQ,EAAE,gBAAgB;KAC3B,CAAC;AACJ,CAAC"}

package/dist/tools/help/actions/query-params.d.ts

@@ -1,14 +1,16 @@
 /**
  * Help Tool - query_params Action
  * Get parameter list only (quick reference)
+ *
+ * TOML-based implementation (v5.0+)
+ * Loads from src/help-data/*.toml instead of database
  */
-import { DatabaseAdapter } from '../../../adapters/index.js';
 import { HelpQueryParamsParams, HelpParamsResult } from '../types.js';
 /**
  * Query parameter list only for quick reference
- * Reuses existing queryHelpParams from help-queries.ts
+ * Uses HelpSystemLoader (TOML-based)
  */
-export declare function queryParams(params: HelpQueryParamsParams, adapter?: DatabaseAdapter): Promise<HelpParamsResult | {
+export declare function queryParams(params: HelpQueryParamsParams): Promise<HelpParamsResult | {
     error: string;
     available_actions?: string[];
 }>;

package/dist/tools/help/actions/query-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-params.d.ts","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-params.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,qBAAqB,EAC7B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAG7E"}
+{"version":3,"file":"query-params.d.ts","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-params.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0B7E"}

package/dist/tools/help/actions/query-params.js

@@ -1,15 +1,37 @@
 /**
  * Help Tool - query_params Action
  * Get parameter list only (quick reference)
+ *
+ * TOML-based implementation (v5.0+)
+ * Loads from src/help-data/*.toml instead of database
  */
-import { getAdapter } from '../../../database.js';
-import { queryHelpParams } from '../../help-queries.js';
+import { getHelpLoader } from '../../../help-loader.js';
 /**
  * Query parameter list only for quick reference
- * Reuses existing queryHelpParams from help-queries.ts
+ * Uses HelpSystemLoader (TOML-based)
  */
-export async function queryParams(params, adapter) {
-    const actualAdapter = adapter ?? getAdapter();
-    return await queryHelpParams(actualAdapter, params.tool, params.target_action);
+export async function queryParams(params) {
+    const loader = await getHelpLoader();
+    // Check if tool exists
+    const tool = loader.getTool(params.tool);
+    if (!tool) {
+        return {
+            error: `Tool "${params.tool}" not found`,
+            available_actions: loader.getToolNames()
+        };
+    }
+    // Get action
+    const action = loader.getAction(params.tool, params.target_action);
+    if (!action) {
+        return {
+            error: `Action "${params.target_action}" not found for tool "${params.tool}"`,
+            available_actions: loader.getActionNames(params.tool)
+        };
+    }
+    return {
+        tool: params.tool,
+        action: action.name,
+        parameters: action.params
+    };
 }
 //# sourceMappingURL=query-params.js.map

package/dist/tools/help/actions/query-params.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-params.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-params.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA6B,EAC7B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,OAAO,MAAM,eAAe,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;AACjF,CAAC"}
+{"version":3,"file":"query-params.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-params.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAA6B;IAE7B,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;IAErC,uBAAuB;IACvB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,KAAK,EAAE,SAAS,MAAM,CAAC,IAAI,aAAa;YACxC,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE;SACzC,CAAC;IACJ,CAAC;IAED,aAAa;IACb,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,KAAK,EAAE,WAAW,MAAM,CAAC,aAAa,yBAAyB,MAAM,CAAC,IAAI,GAAG;YAC7E,iBAAiB,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC;SACtD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM;KAC1B,CAAC;AACJ,CAAC"}

package/dist/tools/help/actions/query-tool.d.ts

@@ -1,14 +1,16 @@
 /**
  * Help Tool - query_tool Action
  * Get tool overview and all actions
+ *
+ * TOML-based implementation (v5.0+)
+ * Loads from src/help-data/*.toml instead of database
  */
-import { DatabaseAdapter } from '../../../adapters/index.js';
 import { HelpQueryToolParams, HelpToolResult } from '../types.js';
 /**
  * Query tool overview and all actions
- * Reuses existing queryHelpTool from help-queries.ts
+ * Uses HelpSystemLoader (TOML-based)
  */
-export declare function queryTool(params: HelpQueryToolParams, adapter?: DatabaseAdapter): Promise<HelpToolResult | {
+export declare function queryTool(params: HelpQueryToolParams): Promise<HelpToolResult | {
     error: string;
     available_tools?: string[];
 }>;

package/dist/tools/help/actions/query-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAGzE"}
+{"version":3,"file":"query-tool.d.ts","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElE;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoBzE"}

package/dist/tools/help/actions/query-tool.js

@@ -1,15 +1,32 @@
 /**
  * Help Tool - query_tool Action
  * Get tool overview and all actions
+ *
+ * TOML-based implementation (v5.0+)
+ * Loads from src/help-data/*.toml instead of database
  */
-import { getAdapter } from '../../../database.js';
-import { queryHelpTool } from '../../help-queries.js';
+import { getHelpLoader } from '../../../help-loader.js';
 /**
  * Query tool overview and all actions
- * Reuses existing queryHelpTool from help-queries.ts
+ * Uses HelpSystemLoader (TOML-based)
  */
-export async function queryTool(params, adapter) {
-    const actualAdapter = adapter ?? getAdapter();
-    return await queryHelpTool(actualAdapter, params.tool);
+export async function queryTool(params) {
+    const loader = await getHelpLoader();
+    // Get tool
+    const tool = loader.getTool(params.tool);
+    if (!tool) {
+        return {
+            error: `Tool "${params.tool}" not found`,
+            available_tools: loader.getToolNames()
+        };
+    }
+    return {
+        tool: tool.name,
+        description: tool.description,
+        actions: tool.actions.map(a => ({
+            name: a.name,
+            description: a.description
+        }))
+    };
 }
 //# sourceMappingURL=query-tool.js.map

package/dist/tools/help/actions/query-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-tool.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAA2B,EAC3B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,OAAO,MAAM,aAAa,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"query-tool.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/query-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAA2B;IAE3B,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;IAErC,WAAW;IACX,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,KAAK,EAAE,SAAS,MAAM,CAAC,IAAI,aAAa;YACxC,eAAe,EAAE,MAAM,CAAC,YAAY,EAAE;SACvC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/tools/help/actions/workflow-hints.d.ts

@@ -1,14 +1,16 @@
 /**
  * Help Tool - workflow_hints Action
  * Get common next actions after current action
+ *
+ * TOML-based implementation (v5.0+)
+ * Loads from src/help-data/*.toml instead of database
  */
-import { DatabaseAdapter } from '../../../adapters/index.js';
 import { HelpWorkflowHintsParams, HelpNextActionsResult } from '../types.js';
 /**
  * Get workflow hints (common next actions)
- * Reuses existing queryHelpNextActions from help-queries.ts
+ * Uses HelpSystemLoader (TOML-based)
  */
-export declare function workflowHints(params: HelpWorkflowHintsParams, adapter?: DatabaseAdapter): Promise<HelpNextActionsResult | {
+export declare function workflowHints(params: HelpWorkflowHintsParams): Promise<HelpNextActionsResult | {
     error: string;
 }>;
 //# sourceMappingURL=workflow-hints.d.ts.map

package/dist/tools/help/actions/workflow-hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-hints.d.ts","sourceRoot":"","sources":["../../../../src/tools/help/actions/workflow-hints.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG7D,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE7E;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,qBAAqB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAGpD"}
+{"version":3,"file":"workflow-hints.d.ts","sourceRoot":"","sources":["../../../../src/tools/help/actions/workflow-hints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE7E;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,qBAAqB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBpD"}

package/dist/tools/help/actions/workflow-hints.js

@@ -1,15 +1,30 @@
 /**
  * Help Tool - workflow_hints Action
  * Get common next actions after current action
+ *
+ * TOML-based implementation (v5.0+)
+ * Loads from src/help-data/*.toml instead of database
  */
-import { getAdapter } from '../../../database.js';
-import { queryHelpNextActions } from '../../help-queries.js';
+import { getHelpLoader } from '../../../help-loader.js';
 /**
  * Get workflow hints (common next actions)
- * Reuses existing queryHelpNextActions from help-queries.ts
+ * Uses HelpSystemLoader (TOML-based)
  */
-export async function workflowHints(params, adapter) {
-    const actualAdapter = adapter ?? getAdapter();
-    return queryHelpNextActions(actualAdapter, params.tool, params.current_action);
+export async function workflowHints(params) {
+    const loader = await getHelpLoader();
+    // Verify tool and action exist
+    const action = loader.getAction(params.tool, params.current_action);
+    if (!action) {
+        return {
+            error: `Action "${params.tool}.${params.current_action}" not found in help system`
+        };
+    }
+    // Get next actions from use case sequences
+    const nextActions = loader.getNextActions(params.tool, params.current_action);
+    return {
+        tool: params.tool,
+        action: params.current_action,
+        next_actions: nextActions
+    };
 }
 //# sourceMappingURL=workflow-hints.js.map

package/dist/tools/help/actions/workflow-hints.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-hints.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/workflow-hints.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAG7D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA+B,EAC/B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,OAAO,oBAAoB,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;AACjF,CAAC"}
+{"version":3,"file":"workflow-hints.js","sourceRoot":"","sources":["../../../../src/tools/help/actions/workflow-hints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA+B;IAE/B,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;IAErC,+BAA+B;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,KAAK,EAAE,WAAW,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,cAAc,4BAA4B;SACnF,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAE9E,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,cAAc;QAC7B,YAAY,EAAE,WAAW;KAC1B,CAAC;AACJ,CAAC"}

package/dist/tools/queue/actions/clear.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Queue clear action
+ *
+ * Clears items from the hook queue (pending, failed, or both)
+ *
+ * @since v5.0.0
+ */
+import type { ClearQueueParams, ClearQueueResponse } from '../types.js';
+/**
+ * Clear items from the queue
+ *
+ * Uses lock mechanism to prevent race conditions with QueueWatcher
+ *
+ * @param projectPath - Project root path
+ * @param params - Optional params including target ('pending', 'failed', or 'all')
+ * @returns Clear result with count of cleared items
+ */
+export declare function clearQueue(projectPath: string, params?: ClearQueueParams): ClearQueueResponse;
+//# sourceMappingURL=clear.d.ts.map

package/dist/tools/queue/actions/clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/actions/clear.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,kBAAkB,CAiE7F"}

package/dist/tools/queue/actions/clear.js

@@ -0,0 +1,79 @@
+/**
+ * Queue clear action
+ *
+ * Clears items from the hook queue (pending, failed, or both)
+ *
+ * @since v5.0.0
+ */
+import { readQueue, writeQueue, readFailedQueue, clearFailedQueue, tryAcquireLock, releaseLock, } from '../../../utils/hook-queue.js';
+/**
+ * Clear items from the queue
+ *
+ * Uses lock mechanism to prevent race conditions with QueueWatcher
+ *
+ * @param projectPath - Project root path
+ * @param params - Optional params including target ('pending', 'failed', or 'all')
+ * @returns Clear result with count of cleared items
+ */
+export function clearQueue(projectPath, params) {
+    const target = params?.target ?? 'pending';
+    // Acquire lock to prevent race conditions (only needed for pending queue)
+    if (target !== 'failed' && !tryAcquireLock(projectPath)) {
+        return {
+            success: false,
+            cleared: 0,
+            message: 'Cannot clear queue: another process is currently processing the queue. Please try again.',
+        };
+    }
+    try {
+        let clearedPending = 0;
+        let clearedFailed = 0;
+        // Clear pending queue
+        if (target === 'pending' || target === 'all') {
+            const queue = readQueue(projectPath);
+            clearedPending = queue.items.length;
+            if (clearedPending > 0) {
+                writeQueue(projectPath, { items: [] }, 'queueTool_clear');
+            }
+        }
+        // Clear failed queue
+        if (target === 'failed' || target === 'all') {
+            const failedQueue = readFailedQueue(projectPath);
+            clearedFailed = failedQueue.items.length;
+            if (clearedFailed > 0) {
+                clearFailedQueue(projectPath);
+            }
+        }
+        const totalCleared = clearedPending + clearedFailed;
+        if (totalCleared === 0) {
+            return {
+                success: true,
+                cleared: 0,
+                message: target === 'all'
+                    ? 'Both queues are already empty.'
+                    : `${target === 'pending' ? 'Pending' : 'Failed'} queue is already empty.`,
+            };
+        }
+        let message;
+        if (target === 'all') {
+            message = `Successfully cleared ${clearedPending} pending and ${clearedFailed} failed item(s).`;
+        }
+        else if (target === 'failed') {
+            message = `Successfully cleared ${clearedFailed} item(s) from the failed queue.`;
+        }
+        else {
+            message = `Successfully cleared ${clearedPending} item(s) from the pending queue.`;
+        }
+        return {
+            success: true,
+            cleared: totalCleared,
+            message,
+        };
+    }
+    finally {
+        if (target !== 'failed') {
+            releaseLock(projectPath);
+        }
+    }
+}
+//# sourceMappingURL=clear.js.map

package/dist/tools/queue/actions/clear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear.js","sourceRoot":"","sources":["../../../../src/tools/queue/actions/clear.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAGtC;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB,EAAE,MAAyB;IACvE,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,SAAS,CAAC;IAE3C,0EAA0E;IAC1E,IAAI,MAAM,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QACxD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,0FAA0F;SACpG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,sBAAsB;QACtB,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;YACrC,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;YACpC,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;gBACvB,UAAU,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC5C,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;YACjD,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC;YACzC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;gBACtB,gBAAgB,CAAC,WAAW,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,cAAc,GAAG,aAAa,CAAC;QAEpD,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,MAAM,KAAK,KAAK;oBACvB,CAAC,CAAC,gCAAgC;oBAClC,CAAC,CAAC,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,0BAA0B;aAC7E,CAAC;QACJ,CAAC;QAED,IAAI,OAAe,CAAC;QACpB,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,GAAG,wBAAwB,cAAc,gBAAgB,aAAa,kBAAkB,CAAC;QAClG,CAAC;aAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,GAAG,wBAAwB,aAAa,iCAAiC,CAAC;QACnF,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,wBAAwB,cAAc,kCAAkC,CAAC;QACrF,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,YAAY;YACrB,OAAO;SACR,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,WAAW,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tools/queue/actions/list.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Queue list action
+ *
+ * Lists all pending items in the hook queue (both pending and failed)
+ *
+ * @since v5.0.0
+ */
+import type { ListQueueParams, ListQueueResponse } from '../types.js';
+/**
+ * List all items in the queue (pending and failed)
+ *
+ * @param projectPath - Project root path
+ * @returns Queue items with metadata
+ */
+export declare function listQueue(projectPath: string, _params?: ListQueueParams): ListQueueResponse;
+//# sourceMappingURL=list.d.ts.map

package/dist/tools/queue/actions/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/actions/list.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAuF3F"}