@paths.design/caws-cli 10.2.0 → 11.1.0

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

@@ -1,80 +0,0 @@
-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:
-    - '{{SCOPE_ITEM_1}}'
-    - '{{SCOPE_ITEM_2}}'
-  out:
-    - '{{OUT_OF_SCOPE_ITEM_1}}'
-invariants:
-  - '{{BUSINESS_RULE_1}}'
-  - '{{BUSINESS_RULE_2}}'
-acceptance:
-  - id: A1
-    given: '{{GIVEN_CONDITION}}'
-    when: '{{WHEN_ACTION}}'
-    then: '{{THEN_OUTCOME}}'
-    status: pending # pending | in_progress | completed
-    # Optional: detailed progress tracking
-    # tests:
-    #   written: 0
-    #   passing: 0
-    # coverage: 0.0
-    # last_updated: '2025-10-09T14:30:00Z'
-  - id: A2
-    given: '{{GIVEN_CONDITION_2}}'
-    when: '{{WHEN_ACTION_2}}'
-    then: '{{THEN_OUTCOME_2}}'
-    status: pending # pending | in_progress | completed
-    # Optional: detailed progress tracking
-    # tests:
-    #   written: 0
-    #   passing: 0
-    # coverage: 0.0
-    # last_updated: '2025-10-09T14:30:00Z'
-non_functional:
-  a11y:
-    - '{{ACCESSIBILITY_REQUIREMENT}}'
-  perf:
-    api_p95_ms: {{PERF_BUDGET}}
-    lcp_ms: {{LCP_BUDGET}}
-  security:
-    - '{{SECURITY_REQUIREMENT}}'
-contracts:
-  - type: '{{CONTRACT_TYPE}}'
-    path: '{{CONTRACT_PATH}}'
-observability:
-  logs:
-    - '{{LOG_STATEMENT}}'
-  metrics:
-    - '{{METRIC_NAME}}'
-  traces:
-    - '{{TRACE_SPAN}}'
-migrations:
-  - '{{MIGRATION_DESCRIPTION}}'
-rollback:
-  - '{{ROLLBACK_STRATEGY}}'
-# Optional: Enable for experimental features with reduced requirements
-# experiment_mode: true
-# timeboxed_hours: 24
-
-# Optional: AI confidence assessment
-# ai_assessment:
-#   confidence_level: 8
-#   uncertainty_areas: ["complex business logic", "performance implications"]
-#   recommended_pairing: false
-
-# Optional: Human override for special cases (hotfixes, urgent changes)
-# human_override:
-#   approved_by: "senior-dev-username"
-#   reason: "Urgent production fix - bypassing mutation tests for immediate deployment"
-#   waived_requirements: ["mutation_testing", "manual_review"]
-#   expiry_date: "2025-10-01T00:00:00Z"

package/templates/.caws/tools/README.md

@@ -1,18 +0,0 @@
-# CAWS Tools
-
-This directory contains CAWS-specific tools that aren't available in the CLI.
-
-## scope-guard.js
-
-Checks whether a file is within scope of active working-spec and feature specs. Used by Cursor hooks for scope validation on file attachments.
-
-```bash
-# Check if a file is in scope
-node .caws/tools/scope-guard.js check src/index.js
-
-# Exit code 0 = in scope, 1 = out of scope
-```
-
-**Usage in Cursor Hooks:**
-
-The `.cursor/hooks/scope-guard.sh` hook automatically uses this tool to validate file attachments against working spec scope boundaries.

package/templates/.caws/tools/scope-guard.js

@@ -1,203 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * @fileoverview CAWS Scope Guard (file-level)
- * Checks whether a given file path is within scope of active specs.
- * Used by Cursor hooks for scope validation on file attachments.
- * @author @darianrosebrook
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Convert a glob pattern to a RegExp, handling **, *, ?, [abc], {a,b}
- */
-function globToRegex(pattern) {
-  let i = 0, re = '';
-  while (i < pattern.length) {
-    const c = pattern[i];
-    if (c === '*' && pattern[i + 1] === '*') {
-      re += '.*'; i += 2;
-      if (pattern[i] === '/') i++; // skip trailing slash after **
-    } else if (c === '*') {
-      re += '[^/]*'; i++;
-    } else if (c === '?') {
-      re += '[^/]'; i++;
-    } else if (c === '[') {
-      const end = pattern.indexOf(']', i);
-      if (end > i) { re += pattern.slice(i, end + 1); i = end + 1; }
-      else { re += '\\['; i++; }
-    } else if (c === '{') {
-      const end = pattern.indexOf('}', i);
-      if (end > i) {
-        const alts = pattern.slice(i + 1, end).split(',').map(a => a.trim());
-        re += '(?:' + alts.join('|') + ')'; i = end + 1;
-      } else { re += '\\{'; i++; }
-    } else if ('.+^$|()'.includes(c)) {
-      re += '\\' + c; i++;
-    } else {
-      re += c; i++;
-    }
-  }
-  return new RegExp(re);
-}
-
-const TERMINAL = new Set(['completed', 'closed', 'archived']);
-
-/**
- * Check if a file is within scope of active specs.
- * @param {string} filePath - Relative path from project root
- * @param {string} projectDir - Project root directory
- * @returns {{inScope: boolean, reason: string}}
- */
-function checkFileScope(filePath, projectDir) {
-  // Smart allowlist: root-level files, .caws/, .claude/ always pass
-  if (!filePath.includes('/') || filePath.startsWith('.caws/') || filePath.startsWith('.claude/')) {
-    return { inScope: true, reason: 'allowlisted path' };
-  }
-
-  const specFile = path.join(projectDir, '.caws/working-spec.yaml');
-  const specsDir = path.join(projectDir, '.caws/specs');
-
-  if (!fs.existsSync(specFile) && !fs.existsSync(specsDir)) {
-    return { inScope: true, reason: 'no specs found' };
-  }
-
-  // Load all active specs
-  let yaml;
-  try { yaml = require('js-yaml'); } catch (_) {
-    return { inScope: true, reason: 'js-yaml not available' };
-  }
-
-  // --- Authoritative spec detection ---
-  // If inside a worktree with a mutual spec binding, only check that spec.
-  let authoritativeSpec = null;
-  let mode = 'union';
-
-  const registryPath = path.join(projectDir, '.caws', 'worktrees.json');
-  const worktreesBase = path.join(projectDir, '.caws', 'worktrees');
-  const cwd = process.cwd();
-
-  if (cwd.startsWith(worktreesBase + path.sep)) {
-    const relative = path.relative(worktreesBase, cwd);
-    const worktreeName = relative.split(path.sep)[0];
-
-    if (worktreeName && fs.existsSync(registryPath)) {
-      try {
-        const reg = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
-        const entry = reg.worktrees && reg.worktrees[worktreeName];
-
-        if (entry && entry.specId) {
-          const specCandidates = [
-            path.join(specsDir, entry.specId + '.yaml'),
-            path.join(specsDir, entry.specId + '.yml'),
-          ];
-          for (const candidate of specCandidates) {
-            if (fs.existsSync(candidate)) {
-              try {
-                const s = yaml.load(fs.readFileSync(candidate, 'utf8'));
-                if (s && !TERMINAL.has(s.status) && s.worktree === worktreeName) {
-                  authoritativeSpec = { source: path.basename(candidate), spec: s };
-                  mode = 'authoritative';
-                }
-              } catch (_) {}
-              break;
-            }
-          }
-        }
-      } catch (_) {}
-    }
-  }
-
-  // --- Collect specs based on mode ---
-  const specs = [];
-
-  if (authoritativeSpec) {
-    specs.push(authoritativeSpec);
-  } else {
-    if (fs.existsSync(specFile)) {
-      try {
-        const s = yaml.load(fs.readFileSync(specFile, 'utf8'));
-        if (s && !TERMINAL.has(s.status)) {
-          specs.push({ source: 'working-spec', spec: s });
-        }
-      } catch (_) {}
-    }
-
-    if (fs.existsSync(specsDir)) {
-      for (const f of fs.readdirSync(specsDir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'))) {
-        try {
-          const s = yaml.load(fs.readFileSync(path.join(specsDir, f), 'utf8'));
-          if (s && !TERMINAL.has(s.status)) {
-            specs.push({ source: f, spec: s });
-          }
-        } catch (_) {}
-      }
-    }
-  }
-
-  if (specs.length === 0) {
-    return { inScope: true, reason: 'no active specs' };
-  }
-
-  // Check scope.out — any match blocks
-  for (const { source, spec } of specs) {
-    for (const pattern of (spec.scope?.out || [])) {
-      if (globToRegex(pattern).test(filePath)) {
-        const modeHint = mode === 'union'
-          ? '. No authoritative spec bound — checking all active specs. Fix: caws worktree bind <spec-id>'
-          : '';
-        return { inScope: false, reason: `out-of-scope in ${source} (pattern: ${pattern})${modeHint}` };
-      }
-    }
-  }
-
-  // scope.in — must match at least one
-  const allIn = specs.flatMap(({ spec }) => spec.scope?.in || []);
-  if (allIn.length > 0) {
-    const found = allIn.some(pattern => globToRegex(pattern).test(filePath));
-    if (!found) {
-      const modeHint = mode === 'union'
-        ? '. No authoritative spec bound — checking all active specs. Fix: caws worktree bind <spec-id>'
-        : '';
-      return { inScope: false, reason: `not in any active spec scope.in${modeHint}` };
-    }
-  }
-
-  return { inScope: true, reason: 'in scope' };
-}
-
-// CLI interface
-if (require.main === module) {
-  const command = process.argv[2];
-  const filePath = process.argv[3];
-
-  if (command === 'check' && filePath) {
-    // Resolve relative to cwd
-    const projectDir = process.cwd();
-    const rel = filePath.startsWith(projectDir)
-      ? filePath.slice(projectDir.length + 1)
-      : filePath;
-
-    const result = checkFileScope(rel, projectDir);
-    if (result.inScope) {
-      console.log(`in_scope: ${result.reason}`);
-      process.exit(0);
-    } else {
-      console.error(`out_of_scope: ${result.reason}`);
-      process.exit(1);
-    }
-  } else {
-    console.log('CAWS Scope Guard');
-    console.log('Usage:');
-    console.log('  node scope-guard.js check <file-path>');
-    console.log('');
-    console.log('Examples:');
-    console.log('  node scope-guard.js check src/index.js');
-    console.log('  node scope-guard.js check packages/cli/lib/main.ts');
-    process.exit(1);
-  }
-}
-
-module.exports = { checkFileScope, globToRegex };

package/templates/.caws/tools-allow.json

@@ -1,331 +0,0 @@
-[
-  "node",
-  "npm",
-  "yarn",
-  "pnpm",
-  "git",
-  "docker",
-  "kubectl",
-  "aws",
-  "azure",
-  "gcloud",
-  "terraform",
-  "ansible",
-  "curl",
-  "wget",
-  "grep",
-  "sed",
-  "awk",
-  "bash",
-  "sh",
-  "zsh",
-  "fish",
-  "python",
-  "python3",
-  "pip",
-  "pip3",
-  "virtualenv",
-  "conda",
-  "java",
-  "javac",
-  "gradle",
-  "maven",
-  "go",
-  "gofmt",
-  "rust",
-  "cargo",
-  "rustfmt",
-  "clippy",
-  "ruby",
-  "gem",
-  "bundle",
-  "rbenv",
-  "php",
-  "composer",
-  "dotnet",
-  "nuget",
-  "swift",
-  "xcodebuild",
-  "make",
-  "cmake",
-  "ninja",
-  "gcc",
-  "clang",
-  "ld",
-  "ar",
-  "strip",
-  "objdump",
-  "nm",
-  "readelf",
-  "file",
-  "hexdump",
-  "xxd",
-  "base64",
-  "openssl",
-  "ssh",
-  "scp",
-  "rsync",
-  "tar",
-  "gzip",
-  "bzip2",
-  "xz",
-  "zip",
-  "unzip",
-  "7z",
-  "jq",
-  "yq",
-  "xmlstarlet",
-  "html-xml-utils",
-  "pandoc",
-  "asciidoc",
-  "rst2html",
-  "markdown",
-  "remark",
-  "prettier",
-  "eslint",
-  "tslint",
-  "stylelint",
-  "htmlhint",
-  "csslint",
-  "jsonlint",
-  "yamllint",
-  "shellcheck",
-  "hadolint",
-  "dockerfile_lint",
-  "markdownlint",
-  "proselint",
-  "vale",
-  "alex",
-  "write-good",
-  "textlint",
-  "redpen",
-  "languagetool",
-  "grammarly",
-  "codespell",
-  "typos",
-  "aspell",
-  "hunspell",
-  "sort",
-  "uniq",
-  "cut",
-  "paste",
-  "join",
-  "split",
-  "tr",
-  "column",
-  "fold",
-  "fmt",
-  "pr",
-  "head",
-  "tail",
-  "wc",
-  "nl",
-  "od",
-  "strings",
-  "iconv",
-  "dos2unix",
-  "unix2dos",
-  "mac2unix",
-  "unix2mac",
-  "pbcopy",
-  "pbpaste",
-  "xclip",
-  "xsel",
-  "tmux",
-  "screen",
-  "vim",
-  "nvim",
-  "emacs",
-  "nano",
-  "micro",
-  "code",
-  "atom",
-  "sublime",
-  "vimr",
-  "macvim",
-  "gvim",
-  "vscode",
-  "intellij",
-  "pycharm",
-  "webstorm",
-  "phpstorm",
-  "rubymine",
-  "clion",
-  "goland",
-  "rider",
-  "datagrip",
-  "android-studio",
-  "xcode",
-  "eclipse",
-  "netbeans",
-  "idea",
-  "studio",
-  "vs",
-  "visualstudio",
-  "monodevelop",
-  "xamarin",
-  "rider",
-  "resharper",
-  "testcafe",
-  "cypress",
-  "playwright",
-  "puppeteer",
-  "selenium",
-  "webdriver",
-  "jest",
-  "mocha",
-  "jasmine",
-  "karma",
-  "vitest",
-  "testing-library",
-  "enzyme",
-  "react-testing-library",
-  "vue-test-utils",
-  "angular-testing-library",
-  "svelte-testing-library",
-  "lit-testing-library",
-  "ember-testing",
-  "backbone-testing",
-  "jquery-testing",
-  "dojo-testing",
-  "dojo",
-  "mootools",
-  "prototype",
-  "yui",
-  "extjs",
-  "sencha",
-  "backbone",
-  "marionette",
-  "chaplin",
-  "thorax",
-  "handlebars",
-  "mustache",
-  "underscore",
-  "lodash",
-  "ramda",
-  "functional",
-  "lazy",
-  "bluebird",
-  "q",
-  "deferred",
-  "async",
-  "await",
-  "generator",
-  "co",
-  "redux",
-  "mobx",
-  "flux",
-  "reflux",
-  "alt",
-  "flummox",
-  "delorean",
-  "cerebral",
-  "kea",
-  "zustand",
-  "jotai",
-  "recoil",
-  "valtio",
-  "effector",
-  "xstate",
-  "robot",
-  "easy-peasy",
-  "pullstate",
-  "akita",
-  "ngrx",
-  "ngxs",
-  "akita",
-  "elf",
-  "pinia",
-  "overmind",
-  "stately",
-  "context",
-  "useContext",
-  "useReducer",
-  "useState",
-  "useEffect",
-  "useMemo",
-  "useCallback",
-  "useRef",
-  "useImperativeHandle",
-  "useLayoutEffect",
-  "useDebugValue",
-  "useDeferredValue",
-  "useTransition",
-  "useId",
-  "useSyncExternalStore",
-  "createContext",
-  "createElement",
-  "cloneElement",
-  "isValidElement",
-  "ReactDOM",
-  "render",
-  "hydrate",
-  "createRoot",
-  "unmountComponentAtNode",
-  "findDOMNode",
-  "createPortal",
-  "unstable_batchedUpdates",
-  "flushSync",
-  "React",
-  "Component",
-  "PureComponent",
-  "memo",
-  "lazy",
-  "Suspense",
-  "ErrorBoundary",
-  "Profiler",
-  "StrictMode",
-  "Fragment",
-  "createRef",
-  "forwardRef",
-  "createContext",
-  "createElement",
-  "cloneElement",
-  "isValidElement",
-  "Children",
-  "map",
-  "forEach",
-  "count",
-  "only",
-  "toArray",
-  "ReactDOM",
-  "render",
-  "hydrate",
-  "createRoot",
-  "unmountComponentAtNode",
-  "findDOMNode",
-  "createPortal",
-  "unstable_batchedUpdates",
-  "flushSync",
-  "React",
-  "Component",
-  "PureComponent",
-  "memo",
-  "lazy",
-  "Suspense",
-  "ErrorBoundary",
-  "Profiler",
-  "StrictMode",
-  "Fragment",
-  "createRef",
-  "forwardRef",
-  "createContext",
-  "createElement",
-  "cloneElement",
-  "isValidElement",
-  "Children",
-  "map",
-  "forEach",
-  "count",
-  "only",
-  "toArray",
-  "ReactDOM",
-  "render",
-  "hydrate",
-  "createRoot",
-  "unmountComponentAtNode",
-  "findDOMNode",
-  "createPortal",
-  "unstable_batchedUpdates",
-  "flushSync"
-]

package/templates/.caws/waivers.yml

@@ -1,19 +0,0 @@
-waivers:
-  # Example waiver for urgent fixes
-  # - id: "HOTFIX-001"
-  #   description: "Urgent security fix - mutation testing waived"
-  #   gates: ["mutation", "coverage"]
-  #   reason: "urgent_fix"
-  #   approver: "senior-dev"
-  #   expires_at: "2025-10-07T10:00:00.000Z"
-  #   projects: ["FEAT-1234"]
-  #   max_trust_score: 79
-
-  # Example waiver for experimental features
-  # - id: "EXP-001"
-  #   description: "Experimental feature - relaxed testing"
-  #   gates: ["mutation", "contracts"]
-  #   reason: "experimental"
-  #   approver: "tech-lead"
-  #   expires_at: "2025-10-14T10:00:00.000Z"
-  #   max_trust_score: 75