@paths.design/caws-cli 10.0.1 → 10.1.0

package/dist/templates/.caws/schemas/waivers.schema.json

@@ -1,36 +1,106 @@
 {
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "CAWS Waiver",
   "description": "Individual waiver file created by caws waivers create",
   "type": "object",
-  "required": ["id", "title", "reason", "gates", "created_at", "expires_at", "approved_by", "status"],
+  "required": ["id", "applies_to", "gates", "delta", "reason_code", "expires_at", "risk_owner", "approvers", "status"],
   "properties": {
-    "id": { "type": "string", "pattern": "^WV-\\d{4}$" },
-    "title": { "type": "string", "minLength": 1 },
-    "reason": { "type": "string", "minLength": 10 },
-    "description": { "type": "string" },
+    "id": {
+      "type": "string",
+      "pattern": "^WV-\\d{4}$",
+      "description": "Waiver ID in format WV-XXXX"
+    },
+    "applies_to": {
+      "type": "string",
+      "description": "Spec ID or PR number this waiver applies to"
+    },
     "gates": {
       "type": "array",
-      "items": { "type": "string" },
+      "items": {
+        "type": "string",
+        "enum": ["budget_limit", "spec_completeness", "contract_compliance", "coverage_threshold", "mutation_threshold", "security_scan", "accessibility_check", "performance_budget", "scope_boundary"]
+      },
+      "minItems": 1,
+      "description": "Quality gates to waive"
+    },
+    "delta": {
+      "type": "object",
+      "description": "Additive budget deltas (only positive values allowed)",
+      "properties": {
+        "max_files": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Additional files allowed"
+        },
+        "max_loc": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Additional lines of code allowed"
+        }
+      },
+      "additionalProperties": false
+    },
+    "reason_code": {
+      "type": "string",
+      "enum": ["emergency_hotfix", "legacy_integration", "experimental_feature", "third_party_constraint", "performance_critical", "security_patch", "infrastructure_limitation", "architectural_refactor", "other"],
+      "description": "Controlled vocabulary for waiver reasons"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 50,
+      "maxLength": 1000,
+      "description": "Detailed explanation of why waiver is needed"
+    },
+    "mitigation": {
+      "type": "string",
+      "minLength": 50,
+      "description": "Plan to address the underlying issue"
+    },
+    "expires_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 datetime when waiver expires"
+    },
+    "risk_owner": {
+      "type": "string",
+      "description": "Person/entity responsible for managing this risk"
+    },
+    "approvers": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["handle"],
+        "properties": {
+          "handle": {
+            "type": "string",
+            "description": "GitHub handle or email of approver"
+          },
+          "approved_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When this approval was given"
+          }
+        },
+        "additionalProperties": false
+      },
       "minItems": 1,
-      "description": "Gate names this waiver applies to"
+      "description": "List of people who approved this waiver"
     },
-    "created_at": { "type": "string" },
-    "expires_at": { "type": "string" },
-    "approved_by": { "type": "string" },
-    "impact_level": { "type": "string" },
-    "mitigation_plan": { "type": "string" },
     "status": {
       "type": "string",
-      "enum": ["active", "expired", "revoked"],
-      "default": "active"
+      "enum": ["proposed", "active", "expired", "revoked"],
+      "description": "Current status of the waiver"
     },
-    "created_by_session": { "type": ["string", "null"] },
-    "compensating_control": { "type": "string" },
-    "ticket_url": { "type": "string", "format": "uri" },
-    "revoked_at": { "type": "string" },
-    "revoked_by": { "type": "string" },
-    "revocation_reason": { "type": "string" }
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "related_pr": { "type": "string" },
+        "related_issue": { "type": "string" },
+        "environment": { "type": "string", "enum": ["development", "staging", "production"] },
+        "urgency": { "type": "string", "enum": ["low", "normal", "high", "critical"] }
+      },
+      "additionalProperties": false
+    }
   },
   "additionalProperties": false
 }

package/dist/templates/.caws/schemas/working-spec.schema.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "CAWS Working Spec",
   "type": "object",
   "required": [
@@ -15,79 +15,178 @@
     "non_functional",
     "contracts"
   ],
+  "not": {
+    "required": [
+      "change_budget"
+    ]
+  },
   "properties": {
-    "id": { "type": "string", "pattern": "^[A-Z]{2,6}-\\d{3,4}$" },
-    "title": { "type": "string", "minLength": 10, "maxLength": 200 },
-    "type": { "type": "string", "enum": ["feature", "fix", "refactor", "chore", "docs"] },
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Z][A-Z0-9]*(-[A-Z0-9]+)*-\\d+$",
+      "description": "Unique identifier for the change. Format: uppercase/digit PREFIX segments separated by dashes, final segment is one+ digits (e.g. CAWSFIX-16, P03-TRUTH-001, ALG-001A-HARDEN-01). Matches SPEC_ID_PATTERN in spec-validation.js (CAWSFIX-21 alignment)."
+    },
+    "title": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 200,
+      "description": "Clear, descriptive title"
+    },
+    "type": {
+      "type": "string",
+      "enum": [
+        "feature",
+        "fix",
+        "refactor",
+        "chore",
+        "doc",
+        "docs"
+      ],
+      "description": "Type of work (informational; `mode` is the enforced gate input)"
+    },
     "status": {
       "type": "string",
-      "enum": ["draft", "active", "in_progress", "completed", "closed", "archived"]
+      "enum": [
+        "draft",
+        "active",
+        "in_progress",
+        "completed",
+        "closed",
+        "archived"
+      ]
+    },
+    "created_at": {
+      "type": "string"
+    },
+    "updated_at": {
+      "type": "string"
+    },
+    "worktree": {
+      "type": "string",
+      "description": "CAWS worktree name assigned to this spec"
+    },
+    "risk_tier": {
+      "type": [
+        "integer",
+        "string"
+      ],
+      "enum": [
+        1,
+        2,
+        3,
+        "1",
+        "2",
+        "3"
+      ],
+      "description": "Risk level (1=high, 2=medium, 3=low)"
+    },
+    "mode": {
+      "type": "string",
+      "enum": [
+        "feature",
+        "refactor",
+        "fix",
+        "doc",
+        "docs",
+        "chore",
+        "development"
+      ],
+      "description": "Mode of change. `development` is the default used by `caws specs create`; feature/refactor/fix/doc/chore are the classic modes the legacy validator accepted."
     },
-    "created_at": { "type": "string" },
-    "updated_at": { "type": "string" },
-    "risk_tier": { "type": ["integer", "string"], "enum": [1, 2, 3, "1", "2", "3"] },
-    "mode": { "type": "string", "enum": ["feature", "refactor", "fix", "doc", "docs", "chore", "development"] },
     "waiver_ids": {
       "type": "array",
-      "items": { "type": "string", "pattern": "^WV-\\d{4}$" },
+      "items": {
+        "type": "string",
+        "pattern": "^WV-\\d{4}$"
+      },
       "description": "IDs of active waivers applying to this spec"
     },
     "blast_radius": {
       "type": "object",
-      "required": ["modules"],
+      "required": [
+        "modules",
+        "data_migration"
+      ],
       "properties": {
-        "modules": { "type": "array", "items": { "type": "string" } },
-        "data_migration": { "type": "boolean" }
-      }
+        "modules": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of modules/paths the change touches"
+        },
+        "data_migration": {
+          "type": "boolean",
+          "description": "Whether the change requires a data migration"
+        }
+      },
+      "additionalProperties": true
+    },
+    "operational_rollback_slo": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Time target for operational rollback (e.g. '5m', '30m', '1h')"
     },
-    "operational_rollback_slo": { "type": "string" },
     "scope": {
       "type": "object",
-      "required": ["in", "out"],
+      "required": [
+        "in"
+      ],
       "properties": {
-        "in": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
-        "out": { "type": "array", "items": { "type": "string" } }
-      }
+        "in": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "description": "Files/paths allowed to be edited (non-empty)"
+        },
+        "out": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Files/paths explicitly excluded from edits"
+        }
+      },
+      "additionalProperties": true
     },
-    "invariants": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
-    "acceptance": {
+    "invariants": {
       "type": "array",
-      "minItems": 0,
       "items": {
-        "type": "object",
-        "required": ["id", "given", "when", "then"],
-        "properties": {
-          "id": { "type": "string", "pattern": "^A\\d+$" },
-          "given": { "type": "string" },
-          "when": { "type": "string" },
-          "then": { "type": "string" }
-        }
-      }
+        "type": "string"
+      },
+      "minItems": 1,
+      "description": "Properties that must hold across the change (non-empty)"
     },
-    "acceptance_criteria": {
+    "acceptance": {
       "type": "array",
-      "minItems": 0,
+      "minItems": 1,
+      "description": "Given/When/Then acceptance criteria (non-empty)",
       "items": {
         "type": "object",
-        "required": ["id"],
+        "required": [
+          "id",
+          "given",
+          "when",
+          "then"
+        ],
         "properties": {
-          "id": { "type": "string" },
-          "description": { "type": "string" },
-          "completed": { "type": "boolean" },
-          "test": { "type": "string" },
-          "test_command": { "type": "string" },
-          "test_nodeids": {
-            "type": "array",
-            "items": { "type": "string" }
+          "id": {
+            "type": "string",
+            "minLength": 1
           },
-          "evidence": {
-            "oneOf": [
-              { "type": "string" },
-              {
-                "type": "array",
-                "items": { "type": "string" }
-              }
-            ]
+          "given": {
+            "type": "string",
+            "minLength": 1
+          },
+          "when": {
+            "type": "string",
+            "minLength": 1
+          },
+          "then": {
+            "type": "string",
+            "minLength": 1
           }
         },
         "additionalProperties": true
@@ -95,82 +194,147 @@
     },
     "non_functional": {
       "type": "object",
+      "required": [
+        "a11y",
+        "perf",
+        "security"
+      ],
       "properties": {
-        "a11y": { "type": "array", "items": { "type": "string" } },
+        "a11y": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Accessibility requirements (may be empty array if not applicable)"
+        },
         "perf": {
           "type": "object",
-          "properties": {
-            "api_p95_ms": { "type": "integer", "minimum": 1 },
-            "lcp_ms": { "type": "integer", "minimum": 1 }
-          },
-          "additionalProperties": false
+          "description": "Performance requirements (e.g. api_p95_ms, lcp_ms)"
         },
-        "security": { "type": "array", "items": { "type": "string" } }
+        "security": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Security requirements (may be empty array if not applicable)"
+        }
       },
-      "additionalProperties": false
+      "additionalProperties": true
     },
     "contracts": {
       "type": "array",
+      "description": "API contracts. Empty array is permitted; CAWSFIX-06 will warn (not fail) when mode=feature with empty contracts.",
       "items": {
         "type": "object",
-        "required": ["type", "path"],
+        "required": [
+          "type",
+          "path"
+        ],
         "properties": {
-          "type": { "type": "string", "enum": ["openapi", "graphql", "proto", "pact", "project_setup"] },
-          "path": { "type": "string" },
-          "description": { "type": "string" },
-          "version": { "type": "string" }
-        }
+          "type": {
+            "type": "string",
+            "enum": [
+              "openapi",
+              "graphql",
+              "proto",
+              "pact",
+              "project_setup"
+            ]
+          },
+          "path": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": true
       }
     },
     "observability": {
-      "type": "object",
-      "properties": {
-        "logs": { "type": "array", "items": { "type": "string" } },
-        "metrics": { "type": "array", "items": { "type": "string" } },
-        "traces": { "type": "array", "items": { "type": "string" } }
+      "type": "object"
+    },
+    "migrations": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "rollback": {
+      "type": "array",
+      "items": {
+        "type": "string"
       }
     },
-    "migrations": { "type": "array", "items": { "type": "string" } },
-    "rollback": { "type": "array", "items": { "type": "string" } },
     "experimental_mode": {
       "type": "object",
-      "description": "Enables experimental mode with reduced requirements",
-      "required": ["enabled", "rationale", "expires_at"],
+      "required": [
+        "enabled",
+        "rationale",
+        "expires_at"
+      ],
       "properties": {
-        "enabled": { "type": "boolean" },
-        "rationale": { "type": "string" },
-        "expires_at": { "type": "string" }
+        "enabled": {
+          "type": "boolean"
+        },
+        "rationale": {
+          "type": "string"
+        },
+        "expires_at": {
+          "type": "string"
+        }
       }
     },
     "timeboxed_hours": {
       "type": "integer",
-      "minimum": 1,
-      "description": "Time limit for experimental features in hours"
+      "minimum": 1
     },
     "human_override": {
       "type": "object",
+      "required": [
+        "approved_by",
+        "reason"
+      ],
       "properties": {
-        "approved_by": { "type": "string" },
-        "reason": { "type": "string" },
+        "approved_by": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        },
         "waived_requirements": {
           "type": "array",
           "items": {
-            "type": "string",
-            "enum": ["mutation_testing", "contract_tests", "coverage", "manual_review"]
+            "type": "string"
           }
         },
-        "expiry_date": { "type": "string", "format": "date-time" }
-      },
-      "required": ["approved_by", "reason"]
+        "expiry_date": {
+          "type": "string"
+        }
+      }
     },
     "ai_assessment": {
       "type": "object",
       "properties": {
-        "confidence_level": { "type": "integer", "minimum": 1, "maximum": 10 },
-        "uncertainty_areas": { "type": "array", "items": { "type": "string" } },
-        "recommended_pairing": { "type": "boolean" }
+        "confidence_level": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10
+        },
+        "uncertainty_areas": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "recommended_pairing": {
+          "type": "boolean"
+        }
       }
     }
   },
-  "additionalProperties": false
+  "additionalProperties": true
 }

package/dist/templates/.caws/templates/working-spec.template.yml

@@ -1,9 +1,12 @@
 id: '{{FEATURE_ID}}'
 title: '{{FEATURE_TITLE}}'
+# Recommended when the spec belongs to a CAWS worktree:
+# worktree: '{{WORKTREE_NAME}}'
 risk_tier: {{TIER}}
 mode: feature
 blast_radius:
   modules: []
+  data_migration: false
 operational_rollback_slo: "30m"
 scope:
   in:
@@ -75,4 +78,3 @@ rollback:
 #   reason: "Urgent production fix - bypassing mutation tests for immediate deployment"
 #   waived_requirements: ["mutation_testing", "manual_review"]
 #   expiry_date: "2025-10-01T00:00:00Z"
-