@paths.design/caws-cli 7.0.0 → 7.0.2

package/dist/utils/quality-gates.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Get staged files from git
+ * @returns {string[]} Array of staged file paths
+ */
+export function getStagedFiles(): string[];
+/**
+ * Check for god objects in staged files
+ * @param {string[]} stagedFiles - Array of staged file paths
+ * @param {string} language - Language to check ('rust', 'typescript', etc.)
+ * @returns {Object} God object analysis results
+ */
+export function checkGodObjects(stagedFiles: string[], language?: string): any;
+/**
+ * Check for hidden TODOs in staged files
+ * @param {string[]} stagedFiles - Array of staged file paths
+ * @returns {Object} TODO analysis results
+ */
+export function checkHiddenTodos(stagedFiles: string[]): any;
+/**
+ * Check if a waiver applies to the given gate
+ * @param {string} gate - Gate name to check
+ * @returns {Object} Waiver check result
+ */
+export function checkWaiver(gate: string): any;
+/**
+ * Detect if project is in crisis response mode
+ * @returns {boolean} True if in crisis mode
+ */
+export function detectCrisisMode(): boolean;
+/**
+ * Run comprehensive quality gates on staged files
+ * @param {Object} options - Options for quality gates
+ * @returns {Object} Quality gate results
+ */
+export function runQualityGates(options?: any): any;
+export namespace CONFIG {
+    namespace godObjectThresholds {
+        let warning: number;
+        let critical: number;
+    }
+    let todoConfidenceThreshold: number;
+    let supportedExtensions: string[];
+    namespace crisisResponseThresholds {
+        export let godObjectCritical: number;
+        let todoConfidenceThreshold_1: number;
+        export { todoConfidenceThreshold_1 as todoConfidenceThreshold };
+    }
+}
+//# sourceMappingURL=quality-gates.d.ts.map

package/dist/utils/quality-gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gates.d.ts","sourceRoot":"","sources":["../../src/utils/quality-gates.js"],"names":[],"mappings":"AAyGA;;;GAGG;AACH,kCAFa,MAAM,EAAE,CAcpB;AAED;;;;;GAKG;AACH,6CAJW,MAAM,EAAE,aACR,MAAM,OAqDhB;AAED;;;;GAIG;AACH,8CAHW,MAAM,EAAE,OA2ClB;AApMD;;;;GAIG;AACH,kCAHW,MAAM,OAiChB;AAED;;;GAGG;AACH,oCAFa,OAAO,CAkCnB;AA6HD;;;;GAIG;AACH,oDAqHC"}

package/dist/utils/spec-resolver.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Resolve spec file path based on priority
+ * @param {Object} options - Resolution options
+ * @param {string} [options.specId] - Feature-specific spec ID (e.g., 'user-auth', 'FEAT-001')
+ * @param {string} [options.specFile] - Explicit file path override
+ * @param {boolean} [options.warnLegacy=true] - Warn when falling back to legacy spec
+ * @param {boolean} [options.interactive=false] - Use interactive spec selection for multiple specs
+ * @returns {Promise<{path: string, type: 'feature' | 'legacy', spec: Object}>}
+ */
+export function resolveSpec(options?: {
+    specId?: string;
+    specFile?: string;
+    warnLegacy?: boolean;
+    interactive?: boolean;
+}): Promise<{
+    path: string;
+    type: "feature" | "legacy";
+    spec: any;
+}>;
+/**
+ * List all available specs
+ * @returns {Promise<Array<{id: string, path: string, type: string}>>}
+ */
+export function listAvailableSpecs(): Promise<Array<{
+    id: string;
+    path: string;
+    type: string;
+}>>;
+/**
+ * Check if project is using multi-spec architecture
+ * @returns {Promise<{isMultiSpec: boolean, specCount: number, needsMigration: boolean}>}
+ */
+export function checkMultiSpecStatus(): Promise<{
+    isMultiSpec: boolean;
+    specCount: number;
+    needsMigration: boolean;
+}>;
+/**
+ * Check for scope conflicts between specs
+ * @param {string[]} specIds - Array of spec IDs to check
+ * @returns {Promise<Array<{spec1: string, spec2: string, conflicts: string[]}>>} Array of conflicts
+ */
+export function checkScopeConflicts(specIds: string[]): Promise<Array<{
+    spec1: string;
+    spec2: string;
+    conflicts: string[];
+}>>;
+/**
+ * Suggest migration from legacy to multi-spec
+ * @returns {Promise<void>}
+ */
+export function suggestMigration(): Promise<void>;
+/**
+ * Interactive spec selection using readline
+ * @param {string[]} specIds - Available spec IDs
+ * @returns {Promise<string>} Selected spec ID
+ */
+export function interactiveSpecSelection(specIds: string[]): Promise<string>;
+/**
+ * Load specs registry
+ * @returns {Promise<Object>} Registry data
+ */
+export function loadSpecsRegistry(): Promise<any>;
+export function suggestFeatureBreakdown(legacySpec: any): {
+    id: string;
+    title: any;
+    criteria: any;
+    scope: {
+        in: string[];
+        out: any[];
+    };
+}[];
+/**
+ * Check if two paths overlap (simplified implementation)
+ * @param {string} path1 - First path
+ * @param {string} path2 - Second path
+ * @returns {boolean} True if paths overlap
+ */
+export function pathsOverlap(path1: string, path2: string): boolean;
+/**
+ * Spec resolution priority:
+ * 1. .caws/specs/<spec-id>.yaml (feature-specific, multi-agent safe)
+ * 2. .caws/working-spec.yaml (legacy, single-agent only)
+ */
+export const SPECS_DIR: ".caws/specs";
+export const LEGACY_SPEC: ".caws/working-spec.yaml";
+export const SPECS_REGISTRY: ".caws/specs/registry.json";
+//# sourceMappingURL=spec-resolver.d.ts.map

package/dist/utils/spec-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/spec-resolver.js"],"names":[],"mappings":"AAwBA;;;;;;;;GAQG;AACH,sCANG;IAAyB,MAAM,GAAvB,MAAM;IACW,QAAQ,GAAzB,MAAM;IACY,UAAU,GAA5B,OAAO;IACW,WAAW,GAA7B,OAAO;CACf,GAAU,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAAC,IAAI,MAAQ;CAAC,CAAC,CAwK7E;AA6BD;;;GAGG;AACH,sCAFa,OAAO,CAAC,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC,CAAC,CAoDpE;AAgDD;;;GAGG;AACH,wCAFa,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAC,CAAC,CAavF;AAED;;;;GAIG;AACH,6CAHW,MAAM,EAAE,GACN,OAAO,CAAC,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAAC,CA2D/E;AA+DD;;;GAGG;AACH,oCAFa,OAAO,CAAC,IAAI,CAAC,CAczB;AA5MD;;;;GAIG;AACH,kDAHW,MAAM,EAAE,GACN,OAAO,CAAC,MAAM,CAAC,CAyC3B;AA/HD;;;GAGG;AACH,qCAFa,OAAO,KAAQ,CAuB3B;AAyQD;;;;;;;;IA+FC;AA/KD;;;;;GAKG;AACH,oCAJW,MAAM,SACN,MAAM,GACJ,OAAO,CAuDnB;AAvcD;;;;GAIG;AACH,wBAAkB,aAAa,CAAC;AAChC,0BAAoB,yBAAyB,CAAC;AAC9C,6BAAuB,2BAA2B,CAAC"}

package/dist/utils/typescript-detector.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Detect if project is using TypeScript
+ * @param {string} projectDir - Project directory path
+ * @returns {Object} TypeScript detection result
+ */
+export function detectTypeScript(projectDir?: string): any;
+/**
+ * Detect testing framework in use
+ * @param {string} projectDir - Project directory path
+ * @param {Object} packageJson - Parsed package.json (optional)
+ * @returns {Object} Testing framework detection result
+ */
+export function detectTestFramework(projectDir?: string, packageJson?: any): any;
+export function getWorkspaceDirectories(projectDir?: string): string[];
+/**
+ * Get workspace directories from package.json
+ * @param {string} projectDir - Project directory path
+ * @returns {string[]} Array of workspace directories
+ */
+/**
+ * Get workspace directories from npm/yarn package.json workspaces
+ * @param {string} projectDir - Project directory path
+ * @returns {string[]} Array of workspace directories
+ */
+export function getNpmWorkspaces(projectDir: string): string[];
+/**
+ * Get workspace directories from pnpm-workspace.yaml
+ * @param {string} projectDir - Project directory path
+ * @returns {string[]} Array of workspace directories
+ */
+export function getPnpmWorkspaces(projectDir: string): string[];
+/**
+ * Get workspace directories from lerna.json
+ * @param {string} projectDir - Project directory path
+ * @returns {string[]} Array of workspace directories
+ */
+export function getLernaWorkspaces(projectDir: string): string[];
+/**
+ * Check if a dependency exists in hoisted node_modules
+ * @param {string} depName - Dependency name to check
+ * @param {string} projectDir - Project directory path
+ * @returns {boolean} True if dependency found in hoisted node_modules
+ */
+export function checkHoistedDependency(depName: string, projectDir: string): boolean;
+/**
+ * Check if TypeScript project needs test configuration
+ * @param {string} projectDir - Project directory path
+ * @returns {Object} Configuration status
+ */
+export function checkTypeScriptTestConfig(projectDir?: string): any;
+/**
+ * Generate configuration recommendations
+ * @param {Object} tsDetection - TypeScript detection result
+ * @param {Object} testDetection - Test framework detection result
+ * @returns {string[]} Array of recommendations
+ */
+export function generateRecommendations(tsDetection: any, testDetection: any): string[];
+/**
+ * Display TypeScript detection results
+ * @param {Object} detection - Detection result from checkTypeScriptTestConfig
+ */
+export function displayTypeScriptDetection(detection: any): void;
+//# sourceMappingURL=typescript-detector.d.ts.map

package/dist/utils/typescript-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-detector.d.ts","sourceRoot":"","sources":["../../src/utils/typescript-detector.js"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,8CAHW,MAAM,OAkChB;AAED;;;;;GAKG;AACH,iDAJW,MAAM,0BAkDhB;AAuKD,uEASC;AA9KD;;;;GAIG;AACH;;;;GAIG;AACH,6CAHW,MAAM,GACJ,MAAM,EAAE,CA6CpB;AAED;;;;GAIG;AACH,8CAHW,MAAM,GACJ,MAAM,EAAE,CA6CpB;AAED;;;;GAIG;AACH,+CAHW,MAAM,GACJ,MAAM,EAAE,CA4CpB;AAED;;;;;GAKG;AACH,gDAJW,MAAM,cACN,MAAM,GACJ,OAAO,CAKnB;AAaD;;;;GAIG;AACH,uDAHW,MAAM,OA0EhB;AAED;;;;;GAKG;AACH,+EAFa,MAAM,EAAE,CAuBpB;AAED;;;GAGG;AACH,iEAoBC"}

package/dist/validation/spec-validation.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Basic validation of working spec
+ * @param {Object} spec - Working spec object
+ * @param {Object} options - Validation options
+ * @returns {Object} Validation result
+ */
+export function validateWorkingSpec(spec: any, _options?: {}): any;
+/**
+ * Enhanced validation with suggestions and auto-fix
+ * @param {Object} spec - Working spec object
+ * @param {Object} options - Validation options
+ * @returns {Object} Enhanced validation result
+ */
+export function validateWorkingSpecWithSuggestions(spec: any, options?: any): any;
+/**
+ * Get suggestion for a missing field
+ * @param {string} field - Field name
+ * @param {Object} _spec - Spec object (for context)
+ * @returns {string} Suggestion text
+ */
+export function getFieldSuggestion(field: string, _spec: any): string;
+/**
+ * Check if a field can be auto-fixed
+ * @param {string} field - Field name
+ * @param {Object} _spec - Spec object (for context)
+ * @returns {boolean} Whether field can be auto-fixed
+ */
+export function canAutoFixField(field: string, _spec: any): boolean;
+/**
+ * Calculate compliance score based on errors and warnings
+ * Score ranges from 0 (many issues) to 1 (perfect)
+ * @param {Array} errors - Validation errors
+ * @param {Array} warnings - Validation warnings
+ * @returns {number} Compliance score (0-1)
+ */
+export function calculateComplianceScore(errors: any[], warnings: any[]): number;
+/**
+ * Get compliance grade from score
+ * @param {number} score - Compliance score (0-1)
+ * @returns {string} Grade (A, B, C, D, F)
+ */
+export function getComplianceGrade(score: number): string;
+//# sourceMappingURL=spec-validation.d.ts.map

package/dist/validation/spec-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-validation.d.ts","sourceRoot":"","sources":["../../src/validation/spec-validation.js"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,mEA8HC;AAED;;;;;GAKG;AACH,kFAyWC;AAoCD;;;;;GAKG;AACH,0CAJW,MAAM,eAEJ,MAAM,CAkBlB;AAED;;;;;GAKG;AACH,uCAJW,MAAM,eAEJ,OAAO,CAKnB;AAnED;;;;;;GAMG;AACH,0EAFa,MAAM,CAclB;AAED;;;;GAIG;AACH,0CAHW,MAAM,GACJ,MAAM,CAQlB"}

package/dist/validation/spec-validation.js

@@ -325,11 +325,35 @@ function validateWorkingSpecWithSuggestions(spec, options = {}) {
     // Tier-specific validations
     if (spec.risk_tier === 1 || spec.risk_tier === 2) {
       if (!spec.contracts || spec.contracts.length === 0) {
+        const isChoreMode = spec.mode === 'chore';
+        const suggestion = isChoreMode
+          ? 'For infrastructure/setup work, add a minimal project_setup contract or create a waiver'
+          : 'Add API contracts (OpenAPI, GraphQL, etc.) or change mode to "chore" for maintenance work';
+        
         errors.push({
           instancePath: '/contracts',
-          message: 'Contracts required for Tier 1 and 2 changes',
-          suggestion: 'Specify API contracts (OpenAPI, GraphQL, etc.)',
+          message: `Contracts required for Tier ${spec.risk_tier} changes`,
+          suggestion: suggestion,
           canAutoFix: false,
+          example: isChoreMode
+            ? {
+                contracts: [
+                  {
+                    type: 'project_setup',
+                    path: '.caws/working-spec.yaml',
+                    description: 'Project-level CAWS configuration. Feature-specific contracts will be added as features are developed.',
+                  },
+                ],
+              }
+            : {
+                contracts: [
+                  {
+                    type: 'openapi',
+                    path: 'docs/api/feature.yaml',
+                    version: '1.0.0',
+                  },
+                ],
+              },
         });
       }
     }

package/dist/waivers-manager.d.ts

@@ -0,0 +1,167 @@
+export = WaiversManager;
+/**
+ * Waiver Manager Class
+ * Handles waiver creation, validation, expiration, and audit logging
+ */
+declare class WaiversManager {
+    constructor(options?: {});
+    projectRoot: any;
+    waiversDir: string;
+    waiversFile: string;
+    auditLogFile: string;
+    /**
+     * Waiver Schema Definition
+     */
+    getWaiverSchema(): {
+        type: string;
+        required: string[];
+        properties: {
+            id: {
+                type: string;
+                pattern: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+            reason: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            description: {
+                type: string;
+                minLength: number;
+                maxLength: number;
+                description: string;
+            };
+            gates: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                minItems: number;
+                description: string;
+            };
+            risk_assessment: {
+                type: string;
+                properties: {
+                    impact_level: {
+                        type: string;
+                        enum: string[];
+                    };
+                    mitigation_plan: {
+                        type: string;
+                        minLength: number;
+                    };
+                    review_required: {
+                        type: string;
+                    };
+                };
+                required: string[];
+            };
+            expires_at: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            approved_by: {
+                type: string;
+                description: string;
+            };
+            created_at: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            metadata: {
+                type: string;
+                properties: {
+                    related_pr: {
+                        type: string;
+                    };
+                    related_issue: {
+                        type: string;
+                    };
+                    environment: {
+                        type: string;
+                        enum: string[];
+                    };
+                    urgency: {
+                        type: string;
+                        enum: string[];
+                    };
+                };
+            };
+        };
+    };
+    /**
+     * Create a new waiver
+     */
+    createWaiver(waiverData: any): Promise<{
+        id: string;
+        title: any;
+        reason: any;
+        description: any;
+        gates: any;
+        risk_assessment: any;
+        expires_at: any;
+        approved_by: any;
+        created_at: string;
+        metadata: any;
+    }>;
+    /**
+     * Check if waiver applies to specific gates
+     */
+    checkWaiverCoverage(gatesToCheck: any, context?: {}): Promise<{
+        coveredGates: any[];
+        waiverDetails: {
+            gate: any;
+            waiver_id: any;
+            reason: any;
+            expires_at: any;
+            approved_by: any;
+        }[];
+        allCovered: boolean;
+    }>;
+    /**
+     * Get all active waivers
+     */
+    getActiveWaivers(): Promise<any[]>;
+    /**
+     * Revoke a waiver
+     */
+    revokeWaiver(waiverId: any, reason?: string): Promise<any>;
+    /**
+     * Extend waiver expiration
+     */
+    extendWaiver(waiverId: any, newExpiryDate: any, approvedBy: any): Promise<any>;
+    /**
+     * Get waiver statistics and health metrics
+     */
+    getWaiverStats(): Promise<{
+        total_active: number;
+        by_reason: {};
+        by_risk_level: {};
+        expiring_soon: any[];
+        high_risk: any[];
+        total_gates_waived: number;
+        average_lifespan_days: number;
+    }>;
+    generateWaiverId(): Promise<string>;
+    validateWaiver(waiver: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    checkWaiverConflicts(newWaiver: any): Promise<string[]>;
+    waiverAppliesToContext(waiver: any, context: any): boolean;
+    loadActiveWaivers(): Promise<any[]>;
+    saveActiveWaivers(waivers: any): Promise<void>;
+    auditLog(action: any, waiverId: any, details: any): Promise<void>;
+    flagForReview(waiver: any): Promise<void>;
+}
+//# sourceMappingURL=waivers-manager.d.ts.map

package/dist/waivers-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waivers-manager.d.ts","sourceRoot":"","sources":["../src/waivers-manager.js"],"names":[],"mappings":";AAaA;;;GAGG;AACH;IACE,0BAUC;IATC,iBAAuD;IACvD,mBAAiE;IACjE,oBAAoE;IACpE,qBAAkE;IAQpE;;OAEG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAiGC;IAED;;OAEG;IACH;;;;;;;;;;;OA4DC;IAED;;OAEG;IACH;;;;;;;;;;OA+BC;IAED;;OAEG;IACH,mCAgBC;IAED;;OAEG;IACH,2DAeC;IAED;;OAEG;IACH,+EAuBC;IAED;;OAEG;IACH;;;;;;;;OA2DC;IAID,oCAUC;IAED;;;MAkDC;IAED,wDAkBC;IAED,2DAUC;IAED,oCAyCC;IAED,+CAuBC;IAED,kEAaC;IAED,0CA2CC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paths.design/caws-cli",
-  "version": "7.0.0",
+  "version": "7.0.2",
   "description": "CAWS CLI - Coding Agent Workflow System command line tools",
   "main": "dist/index.js",
   "bin": {

package/templates/COMMIT_CONVENTIONS.md

@@ -0,0 +1,86 @@
+# Commit Message Conventions
+
+This repository uses [Conventional Commits](https://conventionalcommits.org/) for automated versioning and changelog generation.
+
+## Format
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+## Types
+
+- **feat**: A new feature
+- **fix**: A bug fix
+- **docs**: Documentation only changes
+- **style**: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
+- **refactor**: A code change that neither fixes a bug nor adds a feature
+- **perf**: A code change that improves performance
+- **test**: Adding missing tests or correcting existing tests
+- **build**: Changes that affect the build system or external dependencies
+- **ci**: Changes to our CI configuration files and scripts
+- **chore**: Other changes that don't modify src or test files
+
+## Examples
+
+### Feature
+```
+feat: add user authentication system
+```
+
+### Bug Fix
+```
+fix: resolve memory leak in data processing
+```
+
+### Documentation
+```
+docs: update API documentation for new endpoints
+```
+
+### Refactoring
+```
+refactor: extract user validation logic into separate module
+```
+
+### Breaking Change
+```
+feat!: change API response format for user data
+
+BREAKING CHANGE: The user object now returns additional fields and the format has changed
+```
+
+## Scope
+
+The scope should be the name of the package or module affected by the change:
+
+```
+feat(auth): add OAuth2 authentication
+fix(api): resolve endpoint timeout issue
+docs(cli): update installation instructions
+```
+
+## Automated Publishing
+
+Commits following these conventions will automatically:
+
+1. **Trigger releases** when pushed to `main`
+2. **Generate changelogs** based on commit messages
+3. **Bump versions** according to semantic versioning:
+   - `fix:` → patch release (1.0.0 → 1.0.1)
+   - `feat:` → minor release (1.0.0 → 1.1.0)
+   - `feat!:` → major release (1.0.0 → 2.0.0)
+
+## CI/CD Integration
+
+The automated release process includes:
+- ✅ Linting and testing
+- ✅ Package building
+- ✅ NPM publishing with OIDC authentication
+- ✅ Changelog generation
+- ✅ Git tag creation
+- ✅ Release notes generation