sqlew 5.2.0 → 5.2.2

package/dist/help-data/constraint.toml

@@ -1,259 +1,265 @@
-# Constraint Tool - Architectural Rules
-# Define and manage project constraints with priorities
-
-[tool]
-name = "constraint"
-description = "Architectural Rules - Define and manage project constraints with priorities. Supports categories, layer associations, and tag filtering."
-
-# =============================================================================
-# ACTIONS
-# =============================================================================
-
-[[actions]]
-name = "add"
-description = "Add a new constraint with priority"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"add\""
-
-  [[actions.params]]
-  name = "constraint_text"
-  type = "string"
-  required = true
-  description = "Constraint rule text"
-
-  [[actions.params]]
-  name = "category"
-  type = "string"
-  required = true
-  description = "Constraint category: architecture, security, code-style, performance"
-
-  [[actions.params]]
-  name = "priority"
-  type = "string"
-  required = false
-  description = "Priority: low, medium, high, critical (or 1-4)"
-  default = "medium"
-
-  [[actions.params]]
-  name = "layer"
-  type = "string"
-  required = false
-  description = "Architecture layer this constraint applies to"
-
-  [[actions.params]]
-  name = "tags"
-  type = "string[]"
-  required = false
-  description = "Tags for categorization"
-  default = "[]"
-
-  [[actions.examples]]
-  title = "Add security constraint"
-  code = '''
-{
-  "action": "add",
-  "constraint_text": "All API endpoints must require authentication",
-  "category": "security",
-  "priority": "critical",
-  "layer": "presentation"
-}
-'''
-  explanation = "Add a critical security constraint for API endpoints"
-
-  [[actions.examples]]
-  title = "Add code style constraint"
-  code = '''
-{
-  "action": "add",
-  "constraint_text": "Use functional components with hooks instead of class components",
-  "category": "code-style",
-  "priority": "medium",
-  "tags": ["react", "frontend"]
-}
-'''
-  explanation = "Add a medium-priority coding style constraint"
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "get"
-description = "Retrieve constraints with filtering"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"get\""
-
-  [[actions.params]]
-  name = "category"
-  type = "string"
-  required = false
-  description = "Filter by category"
-
-  [[actions.params]]
-  name = "layer"
-  type = "string"
-  required = false
-  description = "Filter by layer"
-
-  [[actions.params]]
-  name = "priority"
-  type = "string"
-  required = false
-  description = "Filter by priority: low, medium, high, critical (or 1-4)"
-
-  [[actions.params]]
-  name = "active_only"
-  type = "boolean"
-  required = false
-  description = "Only return active constraints"
-  default = "true"
-
-  [[actions.examples]]
-  title = "Get all security constraints"
-  code = '''
-{
-  "action": "get",
-  "category": "security"
-}
-'''
-  explanation = "Retrieve all security-related constraints"
-
-  [[actions.examples]]
-  title = "Get critical constraints"
-  code = '''
-{
-  "action": "get",
-  "priority": "critical"
-}
-'''
-  explanation = "Retrieve all critical constraints"
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "deactivate"
-description = "Deactivate a constraint (soft delete)"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"deactivate\""
-
-  [[actions.params]]
-  name = "id"
-  type = "number | string"
-  required = true
-  description = "ID of the constraint (number for SQLite, UUID string for SaaS). constraint_id also accepted for backward compatibility"
-
-  [[actions.examples]]
-  title = "Deactivate constraint"
-  target_type = "sqlite"
-  code = '''
-{
-  "action": "deactivate",
-  "id": 5
-}
-'''
-  explanation = "Soft-delete a constraint by ID (SQLite uses numeric IDs)"
-
-  [[actions.examples]]
-  title = "Deactivate constraint"
-  target_type = "cloud"
-  code = '''
-{
-  "action": "deactivate",
-  "id": "fbb982cc-764f-4427-b34a-7e758e31c457"
-}
-'''
-  explanation = "Soft-delete a constraint by UUID (SaaS uses UUID strings)"
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "suggest_pending"
-description = "Get AI-suggested constraints based on codebase analysis"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"suggest_pending\""
-
-  [[actions.examples]]
-  title = "Get suggestions"
-  code = '''
-{
-  "action": "suggest_pending"
-}
-'''
-  explanation = "View AI-suggested constraints that haven't been reviewed yet"
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "help"
-description = "Get constraint tool documentation"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"help\""
-
-  [[actions.examples]]
-  title = "Get help"
-  code = '''
-{
-  "action": "help"
-}
-'''
-  explanation = "Display constraint tool documentation"
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "example"
-description = "Get constraint tool examples"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"example\""
-
-  [[actions.examples]]
-  title = "Get examples"
-  code = '''
-{
-  "action": "example"
-}
-'''
-  explanation = "Display constraint tool usage examples"
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "use_case"
-description = "Get constraint tool use cases"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"use_case\""
-
-  [[actions.examples]]
-  title = "Get use cases"
-  code = '''
-{
-  "action": "use_case"
-}
-'''
-  explanation = "Display constraint tool use case workflows"
+# Constraint Tool - Architectural Rules
+# Define and manage project constraints with priorities
+
+[tool]
+name = "constraint"
+description = "Architectural Rules - Define and manage project constraints with priorities. Supports categories, layer associations, and tag filtering."
+
+# =============================================================================
+# ACTIONS
+# =============================================================================
+
+[[actions]]
+name = "add"
+description = "Add a new constraint with priority"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"add\""
+
+  [[actions.params]]
+  name = "constraint_text"
+  type = "string"
+  required = true
+  description = "Constraint rule text"
+
+  [[actions.params]]
+  name = "category"
+  type = "string"
+  required = true
+  description = "Constraint category: architecture, security, code-style, performance"
+
+  [[actions.params]]
+  name = "priority"
+  type = "string"
+  required = false
+  description = "Priority: low, medium, high, critical (or 1-4)"
+  default = "medium"
+
+  [[actions.params]]
+  name = "layer"
+  type = "string"
+  required = false
+  description = "Architecture layer this constraint applies to"
+
+  [[actions.params]]
+  name = "tags"
+  type = "string[]"
+  required = false
+  description = "Tags for categorization"
+  default = "[]"
+
+  [[actions.params]]
+  name = "reason"
+  type = "string"
+  required = false
+  description = "Why this constraint exists (e.g. incident, compliance, team agreement)"
+
+  [[actions.examples]]
+  title = "Add security constraint"
+  code = '''
+{
+  "action": "add",
+  "constraint_text": "All API endpoints must require authentication",
+  "category": "security",
+  "priority": "critical",
+  "layer": "presentation"
+}
+'''
+  explanation = "Add a critical security constraint for API endpoints"
+
+  [[actions.examples]]
+  title = "Add code style constraint"
+  code = '''
+{
+  "action": "add",
+  "constraint_text": "Use functional components with hooks instead of class components",
+  "category": "code-style",
+  "priority": "medium",
+  "tags": ["react", "frontend"]
+}
+'''
+  explanation = "Add a medium-priority coding style constraint"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "get"
+description = "Retrieve constraints with filtering"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"get\""
+
+  [[actions.params]]
+  name = "category"
+  type = "string"
+  required = false
+  description = "Filter by category"
+
+  [[actions.params]]
+  name = "layer"
+  type = "string"
+  required = false
+  description = "Filter by layer"
+
+  [[actions.params]]
+  name = "priority"
+  type = "string"
+  required = false
+  description = "Filter by priority: low, medium, high, critical (or 1-4)"
+
+  [[actions.params]]
+  name = "active_only"
+  type = "boolean"
+  required = false
+  description = "Only return active constraints"
+  default = "true"
+
+  [[actions.examples]]
+  title = "Get all security constraints"
+  code = '''
+{
+  "action": "get",
+  "category": "security"
+}
+'''
+  explanation = "Retrieve all security-related constraints"
+
+  [[actions.examples]]
+  title = "Get critical constraints"
+  code = '''
+{
+  "action": "get",
+  "priority": "critical"
+}
+'''
+  explanation = "Retrieve all critical constraints"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "deactivate"
+description = "Deactivate a constraint (soft delete)"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"deactivate\""
+
+  [[actions.params]]
+  name = "id"
+  type = "number | string"
+  required = true
+  description = "ID of the constraint (number for SQLite, UUID string for SaaS). constraint_id also accepted for backward compatibility"
+
+  [[actions.examples]]
+  title = "Deactivate constraint"
+  target_type = "sqlite"
+  code = '''
+{
+  "action": "deactivate",
+  "id": 5
+}
+'''
+  explanation = "Soft-delete a constraint by ID (SQLite uses numeric IDs)"
+
+  [[actions.examples]]
+  title = "Deactivate constraint"
+  target_type = "cloud"
+  code = '''
+{
+  "action": "deactivate",
+  "id": "fbb982cc-764f-4427-b34a-7e758e31c457"
+}
+'''
+  explanation = "Soft-delete a constraint by UUID (SaaS uses UUID strings)"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "suggest_pending"
+description = "Get AI-suggested constraints based on codebase analysis"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"suggest_pending\""
+
+  [[actions.examples]]
+  title = "Get suggestions"
+  code = '''
+{
+  "action": "suggest_pending"
+}
+'''
+  explanation = "View AI-suggested constraints that haven't been reviewed yet"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "help"
+description = "Get constraint tool documentation"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"help\""
+
+  [[actions.examples]]
+  title = "Get help"
+  code = '''
+{
+  "action": "help"
+}
+'''
+  explanation = "Display constraint tool documentation"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "example"
+description = "Get constraint tool examples"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"example\""
+
+  [[actions.examples]]
+  title = "Get examples"
+  code = '''
+{
+  "action": "example"
+}
+'''
+  explanation = "Display constraint tool usage examples"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "use_case"
+description = "Get constraint tool use cases"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"use_case\""
+
+  [[actions.examples]]
+  title = "Get use cases"
+  code = '''
+{
+  "action": "use_case"
+}
+'''
+  explanation = "Display constraint tool use case workflows"