@paths.design/caws-cli 3.3.1 → 3.5.0

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

@@ -11,6 +11,37 @@ export function detectTypeScript(projectDir?: string): any;
  * @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

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

@@ -1 +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;AAED;;;;GAIG;AACH,uDAHW,MAAM,OAiBhB;AAED;;;;;GAKG;AACH,+EAFa,MAAM,EAAE,CAuBpB;AAED;;;GAGG;AACH,iEAoBC"}
+{"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/utils/typescript-detector.js

@@ -100,24 +100,257 @@ function detectTestFramework(projectDir = process.cwd(), packageJson = null) {
   };
 }
 
+/**
+ * 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
+ */
+function getNpmWorkspaces(projectDir) {
+  const packageJsonPath = path.join(projectDir, 'package.json');
+
+  if (!fs.existsSync(packageJsonPath)) {
+    return [];
+  }
+
+  try {
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+    const workspaces = packageJson.workspaces || [];
+
+    // Convert glob patterns to actual directories (simple implementation)
+    const workspaceDirs = [];
+    for (const ws of workspaces) {
+      // Handle simple patterns like "packages/*" or "iterations/*"
+      if (ws.includes('*')) {
+        const baseDir = ws.split('*')[0];
+        const fullBaseDir = path.join(projectDir, baseDir);
+
+        if (fs.existsSync(fullBaseDir)) {
+          const entries = fs.readdirSync(fullBaseDir, { withFileTypes: true });
+          for (const entry of entries) {
+            if (entry.isDirectory()) {
+              const wsPath = path.join(fullBaseDir, entry.name);
+              if (fs.existsSync(path.join(wsPath, 'package.json'))) {
+                workspaceDirs.push(wsPath);
+              }
+            }
+          }
+        }
+      } else {
+        // Direct path
+        const wsPath = path.join(projectDir, ws);
+        if (fs.existsSync(path.join(wsPath, 'package.json'))) {
+          workspaceDirs.push(wsPath);
+        }
+      }
+    }
+
+    return workspaceDirs;
+  } catch (error) {
+    return [];
+  }
+}
+
+/**
+ * Get workspace directories from pnpm-workspace.yaml
+ * @param {string} projectDir - Project directory path
+ * @returns {string[]} Array of workspace directories
+ */
+function getPnpmWorkspaces(projectDir) {
+  const pnpmFile = path.join(projectDir, 'pnpm-workspace.yaml');
+
+  if (!fs.existsSync(pnpmFile)) {
+    return [];
+  }
+
+  try {
+    const yaml = require('js-yaml');
+    const config = yaml.load(fs.readFileSync(pnpmFile, 'utf8'));
+    const workspacePatterns = config.packages || [];
+
+    // Convert glob patterns to actual directories
+    const workspaceDirs = [];
+    for (const pattern of workspacePatterns) {
+      if (pattern.includes('*')) {
+        const baseDir = pattern.split('*')[0];
+        const fullBaseDir = path.join(projectDir, baseDir);
+
+        if (fs.existsSync(fullBaseDir)) {
+          const entries = fs.readdirSync(fullBaseDir, { withFileTypes: true });
+          for (const entry of entries) {
+            if (entry.isDirectory()) {
+              const wsPath = path.join(fullBaseDir, entry.name);
+              if (fs.existsSync(path.join(wsPath, 'package.json'))) {
+                workspaceDirs.push(wsPath);
+              }
+            }
+          }
+        }
+      } else {
+        // Direct path
+        const wsPath = path.join(projectDir, pattern);
+        if (fs.existsSync(path.join(wsPath, 'package.json'))) {
+          workspaceDirs.push(wsPath);
+        }
+      }
+    }
+
+    return workspaceDirs;
+  } catch (error) {
+    return [];
+  }
+}
+
+/**
+ * Get workspace directories from lerna.json
+ * @param {string} projectDir - Project directory path
+ * @returns {string[]} Array of workspace directories
+ */
+function getLernaWorkspaces(projectDir) {
+  const lernaFile = path.join(projectDir, 'lerna.json');
+
+  if (!fs.existsSync(lernaFile)) {
+    return [];
+  }
+
+  try {
+    const config = JSON.parse(fs.readFileSync(lernaFile, 'utf8'));
+    const workspacePatterns = config.packages || ['packages/*'];
+
+    // Convert glob patterns to actual directories
+    const workspaceDirs = [];
+    for (const pattern of workspacePatterns) {
+      if (pattern.includes('*')) {
+        const baseDir = pattern.split('*')[0];
+        const fullBaseDir = path.join(projectDir, baseDir);
+
+        if (fs.existsSync(fullBaseDir)) {
+          const entries = fs.readdirSync(fullBaseDir, { withFileTypes: true });
+          for (const entry of entries) {
+            if (entry.isDirectory()) {
+              const wsPath = path.join(fullBaseDir, entry.name);
+              if (fs.existsSync(path.join(wsPath, 'package.json'))) {
+                workspaceDirs.push(wsPath);
+              }
+            }
+          }
+        }
+      } else {
+        // Direct path
+        const wsPath = path.join(projectDir, pattern);
+        if (fs.existsSync(path.join(wsPath, 'package.json'))) {
+          workspaceDirs.push(wsPath);
+        }
+      }
+    }
+
+    return workspaceDirs;
+  } catch (error) {
+    return [];
+  }
+}
+
+/**
+ * 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
+ */
+function checkHoistedDependency(depName, projectDir) {
+  const hoistedPath = path.join(projectDir, 'node_modules', depName, 'package.json');
+  return fs.existsSync(hoistedPath);
+}
+
+function getWorkspaceDirectories(projectDir = process.cwd()) {
+  const workspaceDirs = [
+    ...getNpmWorkspaces(projectDir),
+    ...getPnpmWorkspaces(projectDir),
+    ...getLernaWorkspaces(projectDir),
+  ];
+
+  // Remove duplicates
+  return [...new Set(workspaceDirs)];
+}
+
 /**
  * Check if TypeScript project needs test configuration
  * @param {string} projectDir - Project directory path
  * @returns {Object} Configuration status
  */
 function checkTypeScriptTestConfig(projectDir = process.cwd()) {
-  const tsDetection = detectTypeScript(projectDir);
-  const testDetection = detectTestFramework(projectDir, tsDetection.packageJson);
+  // First check root directory
+  const rootTsDetection = detectTypeScript(projectDir);
+  const rootTestDetection = detectTestFramework(projectDir, rootTsDetection.packageJson);
+
+  // Get workspace directories and check them too
+  const workspaceDirs = getWorkspaceDirectories(projectDir);
+  const workspaceResults = [];
+
+  for (const wsDir of workspaceDirs) {
+    const wsTsDetection = detectTypeScript(wsDir);
+    const wsTestDetection = detectTestFramework(wsDir, wsTsDetection.packageJson);
+
+    workspaceResults.push({
+      directory: path.relative(projectDir, wsDir),
+      tsDetection: wsTsDetection,
+      testDetection: wsTestDetection,
+    });
+  }
+
+  // Determine overall status - prefer workspace results if they exist
+  let primaryTsDetection = rootTsDetection;
+  let primaryTestDetection = rootTestDetection;
+  let primaryWorkspace = null;
+
+  // Find the workspace with the most complete TypeScript setup
+  for (const wsResult of workspaceResults) {
+    if (wsResult.tsDetection.isTypeScript) {
+      if (
+        !primaryTsDetection.isTypeScript ||
+        (wsResult.tsDetection.hasTsConfig && !primaryTsDetection.hasTsConfig) ||
+        (wsResult.testDetection.framework !== 'none' && primaryTestDetection.framework === 'none')
+      ) {
+        primaryTsDetection = wsResult.tsDetection;
+        primaryTestDetection = wsResult.testDetection;
+        primaryWorkspace = wsResult.directory;
+      }
+    }
+  }
+
+  // Check for ts-jest in workspaces and hoisted node_modules
+  let hasTsJestAnywhere = primaryTestDetection.hasTsJest;
+
+  // If not found in primary workspace, check all workspaces
+  if (!hasTsJestAnywhere) {
+    hasTsJestAnywhere = workspaceResults.some((ws) => ws.testDetection.hasTsJest);
+  }
+
+  // If still not found, check hoisted node_modules
+  if (!hasTsJestAnywhere) {
+    hasTsJestAnywhere = checkHoistedDependency('ts-jest', projectDir);
+  }
 
   const needsConfig =
-    tsDetection.isTypeScript && testDetection.framework === 'jest' && !testDetection.hasTsJest;
+    primaryTsDetection.isTypeScript &&
+    primaryTestDetection.framework === 'jest' &&
+    !hasTsJestAnywhere;
 
   return {
-    ...tsDetection,
-    testFramework: testDetection,
-    needsJestConfig: tsDetection.isTypeScript && !testDetection.isConfigured,
+    ...primaryTsDetection,
+    testFramework: primaryTestDetection,
+    needsJestConfig: primaryTsDetection.isTypeScript && !primaryTestDetection.isConfigured,
     needsTsJest: needsConfig,
-    recommendations: generateRecommendations(tsDetection, testDetection),
+    recommendations: generateRecommendations(primaryTsDetection, primaryTestDetection),
+    workspaceInfo: {
+      hasWorkspaces: workspaceDirs.length > 0,
+      workspaceCount: workspaceDirs.length,
+      primaryWorkspace,
+      allWorkspaces: workspaceResults.map((ws) => ws.directory),
+    },
   };
 }
 
@@ -179,6 +412,11 @@ function displayTypeScriptDetection(detection) {
 module.exports = {
   detectTypeScript,
   detectTestFramework,
+  getWorkspaceDirectories,
+  getNpmWorkspaces,
+  getPnpmWorkspaces,
+  getLernaWorkspaces,
+  checkHoistedDependency,
   checkTypeScriptTestConfig,
   generateRecommendations,
   displayTypeScriptDetection,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paths.design/caws-cli",
-  "version": "3.3.1",
+  "version": "3.5.0",
   "description": "CAWS CLI - Coding Agent Workflow System command line tools",
   "main": "dist/index.js",
   "bin": {
@@ -68,6 +68,7 @@
     "@types/inquirer": "^8.2.6",
     "@types/js-yaml": "^4.0.0",
     "@types/node": "^20.0.0",
+    "esbuild": "0.25.10",
     "eslint": "^9.0.0",
     "jest": "30.1.3",
     "lint-staged": "15.5.2",

package/templates/agents.md

@@ -776,11 +776,11 @@ Real-time quality enforcement:
 ### Disabling Temporarily
 
 ```bash
-# If you need to bypass hooks temporarily
-# Cursor Settings → Hooks → Disable
+# If you need to bypass commit hooks temporarily
+git commit --no-verify  # Allowed for commits
 
-# Note: --no-verify is BANNED for git commits
-# Fix the issue instead of bypassing hooks
+# Note: --no-verify is BLOCKED for git push
+# Push operations must pass all quality gates
 ```
 
 ---
@@ -972,11 +972,12 @@ Only increase budget with human approval and strong justification.
 
 ### Q: What if lints fail but I think they're wrong?
 
-**A: Fix the lints.** Never use `--no-verify`. If the lint rule is incorrect:
+**A: Fix the lints.** You can use `git commit --no-verify` to commit temporarily, but you cannot push without fixing. If the lint rule is incorrect:
 
 1. Fix the code to satisfy the lint
 2. Or request human discussion of the lint rule
 3. Human can update lint config if appropriate
+4. Note: `git push --no-verify` is BLOCKED
 
 ### Q: Can I commit without updating provenance?
 

package/templates/apps/tools/caws/gates.ts

@@ -87,6 +87,16 @@ class GatesCLI {
         if (result.errors && result.errors.length > 0) {
           result.errors.forEach((error) => console.error(`  - ${error}`));
         }
+        if (result.details?.searched_paths) {
+          console.error(`  Searched paths: ${result.details.searched_paths.join(', ')}`);
+        }
+        if (result.details?.run_command) {
+          console.error(`  Run: ${result.details.run_command}`);
+        }
+        if (result.details?.waiver_available) {
+          console.error(`  💡 ${result.details.waiver_suggestion}`);
+          console.error(`     ${result.details.waiver_command}`);
+        }
         return false;
       }
     } catch (error) {
@@ -118,6 +128,18 @@ class GatesCLI {
         if (result.errors && result.errors.length > 0) {
           result.errors.forEach((error) => console.error(`  - ${error}`));
         }
+        if (result.details?.searched_paths) {
+          console.error(`  Searched paths: ${result.details.searched_paths.join(', ')}`);
+        }
+        if (result.details?.run_command) {
+          console.error(`  Run: ${result.details.run_command}`);
+        }
+        if (result.details?.waiver_available) {
+          console.error(`  💡 ${result.details.waiver_suggestion}`);
+          console.error(
+            `     caws waivers create --title="Mutation waiver" --reason=emergency_hotfix --gates=mutation`
+          );
+        }
         return false;
       }
     } catch (error) {
@@ -144,6 +166,18 @@ class GatesCLI {
         if (result.errors && result.errors.length > 0) {
           result.errors.forEach((error) => console.error(`  - ${error}`));
         }
+        if (result.details?.searched_paths) {
+          console.error(`  Searched paths: ${result.details.searched_paths.join(', ')}`);
+        }
+        if (result.details?.example_command) {
+          console.error(`  Example: ${result.details.example_command}`);
+        }
+        console.error(
+          `  💡 If contracts are not required for this tier, consider creating a waiver`
+        );
+        console.error(
+          `     caws waivers create --title="Contract waiver" --reason=experimental_feature --gates=contracts`
+        );
         return false;
       }
     } catch (error) {