sqlew 4.3.0 → 5.0.0

package/dist/help-data/example.toml

@@ -0,0 +1,177 @@
+# Example Tool - Code Example Browser
+# Browse and search code examples for sqlew tools
+
+[tool]
+name = "example"
+description = "Example System - Browse and search code examples for sqlew tools. Returns working code snippets with explanations (token-efficient)."
+
+# =============================================================================
+# ACTIONS
+# =============================================================================
+
+[[actions]]
+name = "get"
+description = "Get examples by tool, action, or topic"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"get\""
+
+  [[actions.params]]
+  name = "tool"
+  type = "string"
+  required = false
+  description = "Filter by tool name"
+
+  [[actions.params]]
+  name = "action_name"
+  type = "string"
+  required = false
+  description = "Filter by action name"
+
+  [[actions.params]]
+  name = "topic"
+  type = "string"
+  required = false
+  description = "Search by topic in title or explanation"
+
+  [[actions.examples]]
+  title = "Get examples for an action"
+  code = '''
+{
+  "action": "get",
+  "tool": "decision",
+  "action_name": "set"
+}
+'''
+  explanation = "Get all examples for decision.set action"
+
+  [[actions.examples]]
+  title = "Get examples by topic"
+  code = '''
+{
+  "action": "get",
+  "topic": "authentication"
+}
+'''
+  explanation = "Search for examples related to authentication"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "search"
+description = "Search examples by keyword"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"search\""
+
+  [[actions.params]]
+  name = "keyword"
+  type = "string"
+  required = true
+  description = "Keyword to search in title, explanation, and code"
+
+  [[actions.params]]
+  name = "tool"
+  type = "string"
+  required = false
+  description = "Filter by tool (optional)"
+
+  [[actions.params]]
+  name = "complexity"
+  type = "string"
+  required = false
+  description = "Filter by complexity: basic, intermediate, advanced"
+
+  [[actions.params]]
+  name = "limit"
+  type = "number"
+  required = false
+  description = "Maximum results"
+  default = "20"
+
+  [[actions.examples]]
+  title = "Search examples"
+  code = '''
+{
+  "action": "search",
+  "keyword": "batch",
+  "tool": "decision"
+}
+'''
+  explanation = "Search for examples containing 'batch' in the decision tool"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "list_all"
+description = "List all available examples with filtering"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"list_all\""
+
+  [[actions.params]]
+  name = "tool"
+  type = "string"
+  required = false
+  description = "Filter by tool"
+
+  [[actions.params]]
+  name = "complexity"
+  type = "string"
+  required = false
+  description = "Filter by complexity: basic, intermediate, advanced"
+
+  [[actions.params]]
+  name = "limit"
+  type = "number"
+  required = false
+  description = "Maximum results"
+  default = "20"
+
+  [[actions.params]]
+  name = "offset"
+  type = "number"
+  required = false
+  description = "Offset for pagination"
+  default = "0"
+
+  [[actions.examples]]
+  title = "List all examples"
+  code = '''
+{
+  "action": "list_all",
+  "tool": "decision",
+  "limit": 10
+}
+'''
+  explanation = "List first 10 examples for the decision tool"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "help"
+description = "Get example system documentation"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"help\""
+
+  [[actions.examples]]
+  title = "Get help"
+  code = '''
+{
+  "action": "help"
+}
+'''
+  explanation = "Display example tool documentation"

package/dist/help-data/help.toml

@@ -0,0 +1,246 @@
+# Help Tool - Documentation Query System
+# Query action documentation, parameters, and workflow guidance
+
+[tool]
+name = "help"
+description = "Help System - Query action documentation, parameters, and workflow guidance. Returns only requested information (80-95% token reduction vs legacy help)."
+
+# =============================================================================
+# ACTIONS
+# =============================================================================
+
+[[actions]]
+name = "query_action"
+description = "Get documentation for a specific action"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"query_action\""
+
+  [[actions.params]]
+  name = "tool"
+  type = "string"
+  required = true
+  description = "Tool name (decision, constraint, suggest, help, example, use_case)"
+
+  [[actions.params]]
+  name = "target_action"
+  type = "string"
+  required = true
+  description = "Action name to query"
+
+  [[actions.examples]]
+  title = "Query action docs"
+  code = '''
+{
+  "action": "query_action",
+  "tool": "decision",
+  "target_action": "set"
+}
+'''
+  explanation = "Get full documentation for decision.set including parameters and examples"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "query_params"
+description = "Get parameter list for an action (quick reference)"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"query_params\""
+
+  [[actions.params]]
+  name = "tool"
+  type = "string"
+  required = true
+  description = "Tool name"
+
+  [[actions.params]]
+  name = "target_action"
+  type = "string"
+  required = true
+  description = "Action name to query"
+
+  [[actions.examples]]
+  title = "Query params only"
+  code = '''
+{
+  "action": "query_params",
+  "tool": "decision",
+  "target_action": "set"
+}
+'''
+  explanation = "Get just the parameter list for decision.set (minimal tokens)"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "query_tool"
+description = "Get tool overview and all actions"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"query_tool\""
+
+  [[actions.params]]
+  name = "tool"
+  type = "string"
+  required = true
+  description = "Tool name to query"
+
+  [[actions.examples]]
+  title = "Query tool overview"
+  code = '''
+{
+  "action": "query_tool",
+  "tool": "decision"
+}
+'''
+  explanation = "Get overview of decision tool with list of all available actions"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "workflow_hints"
+description = "Get common next actions after current action"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"workflow_hints\""
+
+  [[actions.params]]
+  name = "tool"
+  type = "string"
+  required = true
+  description = "Current tool name"
+
+  [[actions.params]]
+  name = "current_action"
+  type = "string"
+  required = true
+  description = "Current action name"
+
+  [[actions.examples]]
+  title = "Get workflow hints"
+  code = '''
+{
+  "action": "workflow_hints",
+  "tool": "decision",
+  "current_action": "set"
+}
+'''
+  explanation = "After decision.set, what actions typically follow?"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "batch_guide"
+description = "Get guidance for batch operations"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"batch_guide\""
+
+  [[actions.params]]
+  name = "operation"
+  type = "string"
+  required = true
+  description = "Batch operation name in format \"tool.action\" (e.g., \"decision.set_batch\")"
+
+  [[actions.examples]]
+  title = "Get batch guide"
+  code = '''
+{
+  "action": "batch_guide",
+  "operation": "decision.set_batch"
+}
+'''
+  explanation = "Get guidance for using decision.set_batch"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "error_recovery"
+description = "Analyze errors and suggest fixes"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"error_recovery\""
+
+  [[actions.params]]
+  name = "error_message"
+  type = "string"
+  required = true
+  description = "Error message to analyze"
+
+  [[actions.params]]
+  name = "tool"
+  type = "string"
+  required = false
+  description = "Tool that produced the error (optional, helps narrow suggestions)"
+
+  [[actions.examples]]
+  title = "Analyze error"
+  code = '''
+{
+  "action": "error_recovery",
+  "error_message": "Decision key 'auth/method' already exists",
+  "tool": "decision"
+}
+'''
+  explanation = "Get suggestions for fixing the error"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "help"
+description = "Get help system documentation"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"help\""
+
+  [[actions.examples]]
+  title = "Get help"
+  code = '''
+{
+  "action": "help"
+}
+'''
+  explanation = "Display help tool documentation"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "example"
+description = "Get help system examples"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"example\""
+
+  [[actions.examples]]
+  title = "Get examples"
+  code = '''
+{
+  "action": "example"
+}
+'''
+  explanation = "Display help tool usage examples"

package/dist/help-data/queue.toml

@@ -0,0 +1,134 @@
+# Queue Tool - Hook Queue Management
+# Manage pending items in .sqlew/queue/pending.json
+
+[tool]
+name = "queue"
+description = "Hook queue management - list, clear, remove pending items from .sqlew/queue/pending.json. Safe operations with lock mechanism to prevent race conditions with QueueWatcher."
+
+# =============================================================================
+# ACTIONS
+# =============================================================================
+
+[[actions]]
+name = "list"
+description = "List all pending items in the queue"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"list\""
+
+  [[actions.examples]]
+  title = "List queue items"
+  code = '''
+{
+  "action": "list"
+}
+'''
+  explanation = "Show all pending decisions/constraints in the queue with their index, type, and metadata"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "clear"
+description = "Clear all items from the queue"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"clear\""
+
+  [[actions.examples]]
+  title = "Clear all queue items"
+  code = '''
+{
+  "action": "clear"
+}
+'''
+  explanation = "Remove all pending items from the queue at once"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "remove"
+description = "Remove a specific item from the queue by index"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"remove\""
+
+  [[actions.params]]
+  name = "index"
+  type = "number"
+  required = true
+  description = "0-based index of the item to remove (use 'list' first to see indices)"
+
+  [[actions.examples]]
+  title = "Remove item at index 0"
+  code = '''
+{
+  "action": "remove",
+  "index": 0
+}
+'''
+  explanation = "Remove the first item from the queue. Use 'list' first to see available indices."
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "help"
+description = "Get queue tool documentation"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"help\""
+
+  [[actions.examples]]
+  title = "Get help"
+  code = '''
+{
+  "action": "help"
+}
+'''
+  explanation = "Display queue tool documentation"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "example"
+description = "Get queue tool usage examples"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"example\""
+
+  [[actions.examples]]
+  title = "Get examples"
+  code = '''
+{
+  "action": "example"
+}
+'''
+  explanation = "Display queue tool usage examples"
+
+# =============================================================================
+# USE CASES
+# =============================================================================
+
+[[use_cases]]
+title = "Handle stuck items due to High Similarity"
+description = "Items may remain in queue if they have 60%+ similarity to existing decisions"
+steps = [
+  "1. Use `queue list` to see stuck items",
+  "2. Check existing decisions with `/sqlew search for <topic>`",
+  "3. If truly duplicate: Use `queue remove` with the item index",
+  "4. If different intent: Update the key to be more specific and retry"
+]