sqlew 4.3.1 → 5.0.0

package/dist/help-data/suggest.toml

@@ -0,0 +1,219 @@
+# Suggest Tool - Decision Intelligence System
+# Find related decisions and prevent duplicates
+
+[tool]
+name = "suggest"
+description = "Intelligent Decision/Constraint Suggestion System - Find related decisions by key pattern, tags, or full context. Prevents duplicates and ensures consistency with hybrid scoring."
+
+# =============================================================================
+# ACTIONS
+# =============================================================================
+
+[[actions]]
+name = "by_key"
+description = "Find similar decisions by key pattern matching"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"by_key\""
+
+  [[actions.params]]
+  name = "key"
+  type = "string"
+  required = true
+  description = "Decision key pattern to match"
+
+  [[actions.params]]
+  name = "target"
+  type = "string"
+  required = false
+  description = "Target type: decision or constraint"
+  default = "decision"
+
+  [[actions.params]]
+  name = "limit"
+  type = "number"
+  required = false
+  description = "Maximum suggestions to return"
+  default = "5"
+
+  [[actions.params]]
+  name = "min_score"
+  type = "number"
+  required = false
+  description = "Minimum relevance score (0-100)"
+  default = "30"
+
+  [[actions.examples]]
+  title = "Find similar by key"
+  code = '''
+{
+  "action": "by_key",
+  "key": "auth/jwt"
+}
+'''
+  explanation = "Find decisions with keys similar to 'auth/jwt'"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "by_tags"
+description = "Find decisions by tag overlap"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"by_tags\""
+
+  [[actions.params]]
+  name = "tags"
+  type = "string[]"
+  required = true
+  description = "Tags to search for"
+
+  [[actions.params]]
+  name = "target"
+  type = "string"
+  required = false
+  description = "Target type: decision or constraint"
+  default = "decision"
+
+  [[actions.params]]
+  name = "limit"
+  type = "number"
+  required = false
+  description = "Maximum suggestions to return"
+  default = "5"
+
+  [[actions.examples]]
+  title = "Find by tags"
+  code = '''
+{
+  "action": "by_tags",
+  "tags": ["security", "authentication"]
+}
+'''
+  explanation = "Find decisions that share the specified tags"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "by_context"
+description = "Hybrid scoring combining key, tags, layer, priority"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"by_context\""
+
+  [[actions.params]]
+  name = "key"
+  type = "string"
+  required = true
+  description = "Decision key pattern"
+
+  [[actions.params]]
+  name = "tags"
+  type = "string[]"
+  required = false
+  description = "Tags for matching"
+  default = "[]"
+
+  [[actions.params]]
+  name = "layer"
+  type = "string"
+  required = false
+  description = "Layer filter"
+
+  [[actions.params]]
+  name = "target"
+  type = "string"
+  required = false
+  description = "Target type: decision or constraint"
+  default = "decision"
+
+  [[actions.params]]
+  name = "limit"
+  type = "number"
+  required = false
+  description = "Maximum suggestions to return"
+  default = "5"
+
+  [[actions.params]]
+  name = "min_score"
+  type = "number"
+  required = false
+  description = "Minimum relevance score (0-100)"
+  default = "30"
+
+  [[actions.examples]]
+  title = "Full context search"
+  code = '''
+{
+  "action": "by_context",
+  "key": "auth/method",
+  "tags": ["security", "jwt"],
+  "layer": "infrastructure"
+}
+'''
+  explanation = "Find related decisions using hybrid scoring (key similarity + tag overlap + layer match)"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "check_duplicate"
+description = "Check if decision key already exists or is similar"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"check_duplicate\""
+
+  [[actions.params]]
+  name = "key"
+  type = "string"
+  required = true
+  description = "Proposed decision key"
+
+  [[actions.params]]
+  name = "target"
+  type = "string"
+  required = false
+  description = "Target type: decision or constraint"
+  default = "decision"
+
+  [[actions.examples]]
+  title = "Check for duplicate"
+  code = '''
+{
+  "action": "check_duplicate",
+  "key": "auth/session-timeout"
+}
+'''
+  explanation = "Before creating a new decision, check if a similar one already exists"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "help"
+description = "Get suggest tool documentation"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"help\""
+
+  [[actions.examples]]
+  title = "Get help"
+  code = '''
+{
+  "action": "help"
+}
+'''
+  explanation = "Display suggest tool documentation"

package/dist/help-data/use-cases/_categories.toml

@@ -0,0 +1,22 @@
+# Use Case Categories
+# Categorization of workflow scenarios
+
+[[categories]]
+id = 1
+name = "decision_tracking"
+description = "Use cases for recording, retrieving, and versioning architectural decisions, design choices, and shared context."
+
+[[categories]]
+id = 2
+name = "constraint_management"
+description = "Use cases for defining, enforcing, and tracking architectural constraints and requirements."
+
+[[categories]]
+id = 3
+name = "cross_tool_workflow"
+description = "Use cases demonstrating multi-step workflows spanning multiple tools for complex scenarios."
+
+[[categories]]
+id = 4
+name = "decision_intelligence"
+description = "Use cases for intelligent decision suggestions, duplicate detection, and policy-based automation."

package/dist/help-data/use-cases/constraint-basic.toml

@@ -0,0 +1,34 @@
+# Use Case: Define project constraints
+# Category: constraint_management
+# Complexity: basic
+
+[use_case]
+id = 3
+category = "constraint_management"
+title = "Define project constraints"
+complexity = "basic"
+description = "Add architectural constraints with priority levels. Constraints help enforce coding standards and architectural rules across the project."
+
+workflow = """
+1. Use constraint.add to add a new constraint with category and priority
+2. Use constraint.get to list and verify active constraints
+"""
+
+[[action_sequence]]
+order = 1
+tool = "constraint"
+action = "add"
+description = "Add the constraint"
+
+[[action_sequence]]
+order = 2
+tool = "constraint"
+action = "get"
+description = "Verify constraint was added"
+
+[full_example]
+scenario = "Add security constraints"
+steps = [
+  { step = 1, code = '{"action":"add","constraint_text":"All API endpoints must require authentication","category":"security","priority":4,"layer":"presentation"}', note = "Critical security constraint" },
+  { step = 2, code = '{"action":"get","category":"security"}', note = "List all security constraints" }
+]

package/dist/help-data/use-cases/cross-tool-workflow.toml

@@ -0,0 +1,50 @@
+# Use Case: Full feature implementation workflow
+# Category: cross_tool_workflow
+# Complexity: advanced
+
+[use_case]
+id = 4
+category = "cross_tool_workflow"
+title = "Full feature implementation workflow"
+complexity = "advanced"
+description = "Complete workflow from architectural decision to implementation. Demonstrates how decisions and constraints work together."
+
+workflow = """
+1. Use decision.set to record the architectural choice
+2. Use constraint.add to add implementation requirements
+3. Use decision.add_decision_context to document rationale
+4. Use suggest.by_context to find related decisions
+"""
+
+[[action_sequence]]
+order = 1
+tool = "decision"
+action = "set"
+description = "Record architectural decision"
+
+[[action_sequence]]
+order = 2
+tool = "constraint"
+action = "add"
+description = "Add implementation constraint"
+
+[[action_sequence]]
+order = 3
+tool = "decision"
+action = "add_decision_context"
+description = "Document rationale"
+
+[[action_sequence]]
+order = 4
+tool = "suggest"
+action = "by_context"
+description = "Find related decisions"
+
+[full_example]
+scenario = "Implement authentication feature"
+steps = [
+  { step = 1, code = '{"action":"set","key":"auth/method","value":"JWT with refresh tokens","layer":"infrastructure","tags":["security","auth"]}', note = "Architecture decision" },
+  { step = 2, code = '{"action":"add","constraint_text":"JWT tokens must expire within 15 minutes","category":"security","priority":4}', note = "Security constraint" },
+  { step = 3, code = '{"action":"add_decision_context","key":"auth/method","rationale":"JWT provides stateless auth suitable for microservices","alternatives":"Session-based, OAuth2 only"}', note = "Document reasoning" },
+  { step = 4, code = '{"action":"by_context","key":"auth/method","tags":["security"],"layer":"infrastructure"}', note = "Find related decisions" }
+]

package/dist/help-data/use-cases/decision-intelligence-duplicate.toml

@@ -0,0 +1,35 @@
+# Use Case: Check for duplicate decisions
+# Category: decision_intelligence
+# Complexity: basic
+
+[use_case]
+id = 5
+category = "decision_intelligence"
+title = "Check for duplicate decisions"
+complexity = "basic"
+description = "Prevent duplicate decisions with the suggest tool. Always check before creating new decisions to maintain consistency."
+
+workflow = """
+1. Use suggest.check_duplicate with the proposed key
+2. Review suggestions - if similar exists, update it instead
+3. If no duplicates, create new decision with decision.set
+"""
+
+[[action_sequence]]
+order = 1
+tool = "suggest"
+action = "check_duplicate"
+description = "Check for existing similar decisions"
+
+[[action_sequence]]
+order = 2
+tool = "decision"
+action = "set"
+description = "Create new or update existing"
+
+[full_example]
+scenario = "Check before adding auth decision"
+steps = [
+  { step = 1, code = '{"action":"check_duplicate","key":"auth/session-timeout"}', note = "Check for duplicates" },
+  { step = 2, code = '{"action":"set","key":"auth/session-timeout","value":"30 minutes","layer":"infrastructure","tags":["security","session"]}', note = "Create if no duplicates" }
+]

package/dist/help-data/use-cases/decision-intelligence-related.toml

@@ -0,0 +1,35 @@
+# Use Case: Find related decisions
+# Category: decision_intelligence
+# Complexity: intermediate
+
+[use_case]
+id = 6
+category = "decision_intelligence"
+title = "Find related decisions"
+complexity = "intermediate"
+description = "Discover related decisions using context-aware search. Hybrid scoring combines key similarity, tag overlap, and layer matching."
+
+workflow = """
+1. Use suggest.by_context with key, tags, and layer
+2. Review suggestions with their relevance scores
+3. Optionally link related decisions via decision context
+"""
+
+[[action_sequence]]
+order = 1
+tool = "suggest"
+action = "by_context"
+description = "Search with full context"
+
+[[action_sequence]]
+order = 2
+tool = "decision"
+action = "get"
+description = "Review suggested decisions"
+
+[full_example]
+scenario = "Find auth-related decisions"
+steps = [
+  { step = 1, code = '{"action":"by_context","key":"auth/permissions","tags":["security","authorization"],"layer":"infrastructure"}', note = "Search with context" },
+  { step = 2, code = '{"action":"get","key":"auth/method","include_context":true}', note = "Review related decision" }
+]

package/dist/help-data/use-cases/decision-tracking-basic.toml

@@ -0,0 +1,42 @@
+# Use Case: Record an architecture decision
+# Category: decision_tracking
+# Complexity: basic
+
+[use_case]
+id = 1
+category = "decision_tracking"
+title = "Record an architecture decision"
+complexity = "basic"
+description = "Document an architectural choice with context. This is the fundamental workflow for recording decisions in the system."
+
+workflow = """
+1. Use decision.set to record the decision with key, value, layer, and tags
+2. Use decision.add_decision_context to add rationale and alternatives
+3. Use decision.get to verify the recorded decision
+"""
+
+[[action_sequence]]
+order = 1
+tool = "decision"
+action = "set"
+description = "Record the decision with metadata"
+
+[[action_sequence]]
+order = 2
+tool = "decision"
+action = "add_decision_context"
+description = "Add rationale explaining why this decision was made"
+
+[[action_sequence]]
+order = 3
+tool = "decision"
+action = "get"
+description = "Verify the decision was recorded correctly"
+
+[full_example]
+scenario = "Record a database engine decision"
+steps = [
+  { step = 1, code = '{"action":"set","key":"db/engine","value":"PostgreSQL 15","layer":"data","tags":["database","persistence"]}', note = "Record the decision" },
+  { step = 2, code = '{"action":"add_decision_context","key":"db/engine","rationale":"PostgreSQL provides strong ACID compliance and JSON support needed for our data model","alternatives":"MySQL, MongoDB, SQLite","tradeoffs":"Higher operational complexity than SQLite, but better scalability"}', note = "Add context" },
+  { step = 3, code = '{"action":"get","key":"db/engine","include_context":true}', note = "Verify with context" }
+]

package/dist/help-data/use-cases/decision-tracking-versions.toml

@@ -0,0 +1,42 @@
+# Use Case: Track decision versions
+# Category: decision_tracking
+# Complexity: intermediate
+
+[use_case]
+id = 2
+category = "decision_tracking"
+title = "Track decision versions"
+complexity = "intermediate"
+description = "Update a decision and view its version history. Useful for understanding how decisions evolved over time."
+
+workflow = """
+1. Use decision.set to record the initial decision
+2. Use decision.set again with updated value (same key)
+3. Use decision.versions to see the complete version history
+"""
+
+[[action_sequence]]
+order = 1
+tool = "decision"
+action = "set"
+description = "Record initial decision"
+
+[[action_sequence]]
+order = 2
+tool = "decision"
+action = "set"
+description = "Update the decision with new value"
+
+[[action_sequence]]
+order = 3
+tool = "decision"
+action = "versions"
+description = "View version history"
+
+[full_example]
+scenario = "Track API version evolution"
+steps = [
+  { step = 1, code = '{"action":"set","key":"api/version","value":"v1.0","layer":"presentation"}', note = "Initial version" },
+  { step = 2, code = '{"action":"set","key":"api/version","value":"v2.0","layer":"presentation","version":"v2.0.0"}', note = "Update to v2" },
+  { step = 3, code = '{"action":"versions","key":"api/version"}', note = "View history" }
+]

package/dist/help-data/use_case.toml

@@ -0,0 +1,147 @@
+# Use Case Tool - Workflow Scenario Catalog
+# Browse and search complete workflow scenarios
+
+[tool]
+name = "use_case"
+description = "Use Case Catalog - Browse and search complete workflow scenarios. Returns end-to-end workflows with executable code examples."
+
+# =============================================================================
+# ACTIONS
+# =============================================================================
+
+[[actions]]
+name = "get"
+description = "Get complete use case workflow by ID"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"get\""
+
+  [[actions.params]]
+  name = "use_case_id"
+  type = "number"
+  required = true
+  description = "Use case ID to retrieve"
+
+  [[actions.examples]]
+  title = "Get use case"
+  code = '''
+{
+  "action": "get",
+  "use_case_id": 4
+}
+'''
+  explanation = "Get the complete workflow for use case #4"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "search"
+description = "Search use cases by keyword/category"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"search\""
+
+  [[actions.params]]
+  name = "keyword"
+  type = "string"
+  required = true
+  description = "Search keyword (searches title and description)"
+
+  [[actions.params]]
+  name = "category"
+  type = "string"
+  required = false
+  description = "Filter by category"
+
+  [[actions.params]]
+  name = "complexity"
+  type = "string"
+  required = false
+  description = "Filter by complexity: basic, intermediate, advanced"
+
+  [[actions.examples]]
+  title = "Search use cases"
+  code = '''
+{
+  "action": "search",
+  "keyword": "authentication",
+  "complexity": "intermediate"
+}
+'''
+  explanation = "Search for intermediate-level use cases about authentication"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "list_all"
+description = "List all use cases with filtering"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"list_all\""
+
+  [[actions.params]]
+  name = "category"
+  type = "string"
+  required = false
+  description = "Filter by category: decision_tracking, constraint_management, cross_tool_workflow, decision_intelligence"
+
+  [[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 use cases"
+  code = '''
+{
+  "action": "list_all",
+  "category": "decision_tracking",
+  "complexity": "basic"
+}
+'''
+  explanation = "List basic-level use cases in the decision_tracking category"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "help"
+description = "Get use case catalog documentation"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"help\""
+
+  [[actions.examples]]
+  title = "Get help"
+  code = '''
+{
+  "action": "help"
+}
+'''
+  explanation = "Display use case tool documentation"