@paths.design/caws-cli 10.1.0 → 11.0.0

package/templates/.caws/schemas/policy.schema.json

@@ -1,112 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "required": [
-    "version",
-    "risk_tiers",
-    "edit_rules"
-  ],
-  "properties": {
-    "version": {
-      "type": "integer",
-      "enum": [
-        1
-      ],
-      "description": "Policy schema version"
-    },
-    "risk_tiers": {
-      "type": "object",
-      "patternProperties": {
-        "^[1-3]$": {
-          "type": "object",
-          "required": [
-            "max_files",
-            "max_loc"
-          ],
-          "properties": {
-            "max_files": {
-              "type": "integer",
-              "minimum": 1,
-              "description": "Maximum files allowed for this risk tier"
-            },
-            "max_loc": {
-              "type": "integer",
-              "minimum": 1,
-              "description": "Maximum lines of code allowed for this risk tier"
-            },
-            "description": {
-              "type": "string",
-              "description": "Human-readable description of the tier"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false,
-      "description": "Risk tier definitions with budget limits"
-    },
-    "edit_rules": {
-      "type": "object",
-      "required": [
-        "policy_and_code_same_pr",
-        "min_approvers_for_budget_raise"
-      ],
-      "properties": {
-        "policy_and_code_same_pr": {
-          "type": "boolean",
-          "description": "Whether policy and code changes can be in the same PR"
-        },
-        "min_approvers_for_budget_raise": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "Minimum approvers required for budget increases"
-        },
-        "require_signed_commits": {
-          "type": "boolean",
-          "description": "Whether signed commits are required for policy changes"
-        }
-      },
-      "additionalProperties": false,
-      "description": "Rules governing policy file edits"
-    },
-    "gates": {
-      "type": "object",
-      "patternProperties": {
-        "^.*$": {
-          "type": "object",
-          "required": [
-            "enabled"
-          ],
-          "properties": {
-            "enabled": {
-              "type": "boolean",
-              "description": "Whether this gate is active"
-            },
-            "mode": {
-              "type": "string",
-              "enum": [
-                "warn",
-                "block",
-                "skip"
-              ],
-              "description": "How the gate reports failures: warn, block, or skip entirely"
-            },
-            "description": {
-              "type": "string",
-              "description": "Human-readable description of the gate"
-            },
-            "thresholds": {
-              "type": "object",
-              "description": "Gate-specific thresholds (e.g. warning/critical limits)"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "additionalProperties": false,
-      "description": "Quality gate configurations"
-    }
-  },
-  "additionalProperties": false,
-  "title": "CAWS Policy"
-}

package/templates/.caws/schemas/scope.schema.json

@@ -1,52 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "CAWS Lite Scope Configuration",
-  "description": "Scope configuration for CAWS lite mode — guardrails without YAML specs. This schema governs the standalone .caws/scope.json file ONLY; inline scope: blocks inside working-spec.yaml or feature specs are governed by the working-spec schema's scope sub-schema and do NOT invoke this schema. See CAWSFIX-11.",
-  "type": "object",
-  "required": ["allowedDirectories"],
-  "properties": {
-    "version": {
-      "type": "integer",
-      "const": 1,
-      "description": "Schema version. Optional for back-compat with scope.json files that predate versioning; the runtime (src/config/lite-scope.js) defaults to 1 when missing. If present, must be exactly 1. CAWSFIX-11 lifted `version` from the required list because no code path enforces a version mismatch — only the schema did, producing spurious warnings for pre-versioning scope.json files."
-    },
-    "allowedDirectories": {
-      "type": "array",
-      "items": { "type": "string" },
-      "minItems": 1,
-      "description": "Directories the agent is allowed to modify (e.g., src/, tests/)"
-    },
-    "bannedPatterns": {
-      "type": "object",
-      "properties": {
-        "files": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Glob patterns for banned file names (e.g., *-enhanced.*, *-final.*)"
-        },
-        "directories": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Glob patterns for banned directory names (e.g., *venv*, .venv)"
-        },
-        "docs": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Glob patterns for banned doc file names (e.g., *-summary.md)"
-        }
-      },
-      "additionalProperties": false
-    },
-    "maxNewFilesPerCommit": {
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 100,
-      "description": "Maximum number of new files allowed per commit (prevents file sprawl)"
-    },
-    "designatedVenvPath": {
-      "type": "string",
-      "description": "The only allowed virtual environment path (e.g., .venv)"
-    }
-  },
-  "additionalProperties": false
-}

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

@@ -1,106 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "CAWS Waiver",
-  "description": "Individual waiver file created by caws waivers create",
-  "type": "object",
-  "required": ["id", "applies_to", "gates", "delta", "reason_code", "expires_at", "risk_owner", "approvers", "status"],
-  "properties": {
-    "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",
-        "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": "List of people who approved this waiver"
-    },
-    "status": {
-      "type": "string",
-      "enum": ["proposed", "active", "expired", "revoked"],
-      "description": "Current status of the waiver"
-    },
-    "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/templates/.caws/schemas/working-spec.schema.json

@@ -1,340 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "CAWS Working Spec",
-  "type": "object",
-  "required": [
-    "id",
-    "title",
-    "risk_tier",
-    "mode",
-    "blast_radius",
-    "operational_rollback_slo",
-    "scope",
-    "invariants",
-    "acceptance",
-    "non_functional",
-    "contracts"
-  ],
-  "not": {
-    "required": [
-      "change_budget"
-    ]
-  },
-  "properties": {
-    "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"
-      ]
-    },
-    "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."
-    },
-    "waiver_ids": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "pattern": "^WV-\\d{4}$"
-      },
-      "description": "IDs of active waivers applying to this spec"
-    },
-    "blast_radius": {
-      "type": "object",
-      "required": [
-        "modules",
-        "data_migration"
-      ],
-      "properties": {
-        "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')"
-    },
-    "scope": {
-      "type": "object",
-      "required": [
-        "in"
-      ],
-      "properties": {
-        "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,
-      "description": "Properties that must hold across the change (non-empty)"
-    },
-    "acceptance": {
-      "type": "array",
-      "minItems": 1,
-      "description": "Given/When/Then acceptance criteria (non-empty)",
-      "items": {
-        "type": "object",
-        "required": [
-          "id",
-          "given",
-          "when",
-          "then"
-        ],
-        "properties": {
-          "id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "given": {
-            "type": "string",
-            "minLength": 1
-          },
-          "when": {
-            "type": "string",
-            "minLength": 1
-          },
-          "then": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "additionalProperties": true
-      }
-    },
-    "non_functional": {
-      "type": "object",
-      "required": [
-        "a11y",
-        "perf",
-        "security"
-      ],
-      "properties": {
-        "a11y": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Accessibility requirements (may be empty array if not applicable)"
-        },
-        "perf": {
-          "type": "object",
-          "description": "Performance requirements (e.g. api_p95_ms, lcp_ms)"
-        },
-        "security": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Security requirements (may be empty array if not applicable)"
-        }
-      },
-      "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"
-        ],
-        "properties": {
-          "type": {
-            "type": "string",
-            "enum": [
-              "openapi",
-              "graphql",
-              "proto",
-              "pact",
-              "project_setup"
-            ]
-          },
-          "path": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string"
-          },
-          "version": {
-            "type": "string"
-          }
-        },
-        "additionalProperties": true
-      }
-    },
-    "observability": {
-      "type": "object"
-    },
-    "migrations": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "rollback": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "experimental_mode": {
-      "type": "object",
-      "required": [
-        "enabled",
-        "rationale",
-        "expires_at"
-      ],
-      "properties": {
-        "enabled": {
-          "type": "boolean"
-        },
-        "rationale": {
-          "type": "string"
-        },
-        "expires_at": {
-          "type": "string"
-        }
-      }
-    },
-    "timeboxed_hours": {
-      "type": "integer",
-      "minimum": 1
-    },
-    "human_override": {
-      "type": "object",
-      "required": [
-        "approved_by",
-        "reason"
-      ],
-      "properties": {
-        "approved_by": {
-          "type": "string"
-        },
-        "reason": {
-          "type": "string"
-        },
-        "waived_requirements": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          }
-        },
-        "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"
-        }
-      }
-    }
-  },
-  "additionalProperties": true
-}

package/templates/.caws/schemas/worktrees.schema.json

@@ -1,38 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "title": "CAWS Worktree Registry",
-  "description": "Registry of git worktrees managed by CAWS for agent scope isolation",
-  "type": "object",
-  "required": ["version", "worktrees"],
-  "properties": {
-    "version": {
-      "type": "integer",
-      "const": 1
-    },
-    "worktrees": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "required": ["name", "path", "branch", "baseBranch", "createdAt", "status"],
-        "properties": {
-          "name": { "type": "string", "pattern": "^[a-zA-Z0-9_-]+$" },
-          "path": { "type": "string" },
-          "branch": { "type": "string" },
-          "baseBranch": { "type": "string" },
-          "scope": { "type": ["string", "null"] },
-          "specId": { "type": ["string", "null"] },
-          "owner": { "type": ["string", "null"], "description": "CLAUDE_SESSION_ID of the creating agent" },
-          "createdAt": { "type": "string", "format": "date-time" },
-          "destroyedAt": { "type": "string", "format": "date-time" },
-          "autoRegistered": { "type": "boolean" },
-          "status": {
-            "type": "string",
-            "enum": ["fresh", "active", "merged", "orphaned", "missing", "stale-merged", "destroyed"]
-          }
-        },
-        "additionalProperties": false
-      }
-    }
-  },
-  "additionalProperties": false
-}