@kabran-tecnologia/kabran-config 2.1.0 → 2.2.0

package/README.md

@@ -368,8 +368,9 @@ echo "npx lint-staged" > .husky/pre-commit
 # Add commit-msg hook
 echo "npx --no -- commitlint --edit \$1" > .husky/commit-msg
 
-# Add pre-push hook (optional)
-echo "npm run type-check && npm test" > .husky/pre-push
+# Add pre-push hook (optional - kept lightweight by design)
+# Full validation runs in CI. Uncomment type-check if desired:
+# echo "npm run type-check" > .husky/pre-push
 ```
 
 ---
@@ -476,21 +477,14 @@ node node_modules/@kabran-tecnologia/kabran-config/src/scripts/license-check.mjs
 }
 ```
 
-**Usage in CI/CD:**
+**Usage in CI (recommended):**
 
 ```yaml
-# .github/workflows/quality.yml
+# .github/workflows/ci.yml
 - name: License Check
   run: npm run license:check
 ```
 
-**Usage in Husky:**
-
-```bash
-# .husky/pre-push
-npm run license:check
-```
-
 **Blocked licenses:** GPL, AGPL, LGPL, EUPL (viral copyleft)
 **Exit code:** 1 if prohibited licenses found, 0 otherwise
 
@@ -607,14 +601,7 @@ node node_modules/@kabran-tecnologia/kabran-config/src/scripts/env-validator.mjs
 3. If env vars detected, validates `.env.example` exists
 4. Warns if vars in `.env.example` lack comments/documentation
 
-**Usage in Husky:**
-
-```bash
-# .husky/pre-push
-npm run env:validate
-```
-
-**Usage in CI/CD:**
+**Usage in CI (recommended):**
 
 ```yaml
 # .github/workflows/security.yml

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kabran-tecnologia/kabran-config",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Shared quality configurations, enforcement scripts, and CI/CD tooling for Kabran projects",
   "author": "Kabran",
   "license": "MIT",

package/src/core/config-loader.mjs

@@ -5,8 +5,9 @@
  * Enables projects to customize validator behavior without modifying kabran-config.
  *
  * Features:
- * - Smart detection of tools (ESLint, TypeScript, Prettier, Vitest, Playwright)
+ * - Smart detection of tools (ESLint, TypeScript, Prettier, Vitest, Playwright, Turbo)
  * - Automatic Doppler integration for secrets injection in tests
+ * - Native support for Turbo monorepos (auto-detects turbo.json)
  * - Convention over configuration - works out of the box
  *
  * @module config-loader
@@ -45,6 +46,7 @@ const TOOL_CONFIGS = {
   prettier: ['prettier.config.mjs', 'prettier.config.js', '.prettierrc', '.prettierrc.json', '.prettierrc.js'],
   vitest: ['vitest.config.ts', 'vitest.config.mts', 'vitest.config.js', 'vitest.config.mjs'],
   playwright: ['playwright.config.ts', 'playwright.config.js'],
+  turbo: ['turbo.json'],
 };
 
 /**
@@ -59,10 +61,27 @@ function hasToolConfig(cwd, configFiles) {
 
 /**
  * Check if Doppler is configured for the current directory.
+ *
+ * Detection methods (in order of reliability):
+ * 1. DOPPLER_TOKEN environment variable is set
+ * 2. doppler.yaml exists in the project
+ * 3. doppler configure get token returns a value (CLI-level config)
+ *
  * @param {string} cwd - Working directory
- * @returns {boolean} True if Doppler token is configured
+ * @returns {boolean} True if Doppler is available
  */
 function hasDopplerConfigured(cwd) {
+  // Method 1: Environment variable (most common in CI/CD and scoped setups)
+  if (process.env.DOPPLER_TOKEN) {
+    return true;
+  }
+
+  // Method 2: doppler.yaml in project (common for project-level config)
+  if (existsSync(join(cwd, 'doppler.yaml'))) {
+    return true;
+  }
+
+  // Method 3: CLI-level configuration (doppler setup was run)
   try {
     const result = execSync('doppler configure get token', {
       cwd,
@@ -72,7 +91,18 @@ function hasDopplerConfigured(cwd) {
     });
     return result.trim().length > 0;
   } catch {
-    return false;
+    // Method 4: Try doppler secrets as last resort (validates full setup)
+    try {
+      execSync('doppler secrets --only-names', {
+        cwd,
+        stdio: 'pipe',
+        encoding: 'utf-8',
+        timeout: 10000,
+      });
+      return true;
+    } catch {
+      return false;
+    }
   }
 }
 
@@ -89,6 +119,15 @@ export function wrapWithDoppler(cmd, useDoppler) {
 /**
  * Detect available tools and generate smart defaults.
  * Only configures commands for tools that are actually set up in the project.
+ *
+ * Turbo monorepo support:
+ * - When turbo.json is detected, commands delegate to `turbo run` for:
+ *   - Lint: `turbo run lint`
+ *   - Types: `turbo run type-check`
+ *   - Tests: `turbo run test`
+ *   - Build: `turbo run build`
+ * - This ensures proper monorepo handling with caching and workspace orchestration.
+ *
  * @param {string} cwd - Working directory
  * @returns {object} Detected defaults for CLI commands
  */
@@ -98,10 +137,76 @@ export function detectToolDefaults(cwd) {
     test: {},
     build: {},
     ci: { steps: [] },
+    turbo: false,
   };
 
   const hasDoppler = hasDopplerConfigured(cwd);
+  const hasTurbo = hasToolConfig(cwd, TOOL_CONFIGS.turbo);
+
+  // Store turbo detection result for consumers
+  defaults.turbo = hasTurbo;
+
+  // Turbo monorepo mode: delegate to turbo run commands
+  if (hasTurbo) {
+    return detectTurboDefaults(defaults, hasDoppler);
+  }
+
+  // Standard single-package mode: use direct tool commands
+  return detectStandardDefaults(cwd, defaults, hasDoppler);
+}
 
+/**
+ * Generate defaults for Turbo monorepo projects.
+ * Uses `turbo run` commands for all operations.
+ * @param {object} defaults - Base defaults object
+ * @param {boolean} hasDoppler - Whether Doppler is configured
+ * @returns {object} Turbo-specific defaults
+ */
+function detectTurboDefaults(defaults, hasDoppler) {
+  // L1: Static Analysis via Turbo
+  defaults.check.lint = 'turbo run lint';
+  defaults.check.types = 'turbo run type-check';
+  defaults.check.format = 'turbo run format:check';
+
+  // L2: Unit Tests via Turbo (with Doppler support)
+  const testCmd = 'turbo run test';
+  defaults.test.unit = {
+    command: wrapWithDoppler(testCmd, hasDoppler),
+    doppler: hasDoppler,
+  };
+
+  // L3: Integration Tests via Turbo (with Doppler support)
+  const integrationCmd = 'turbo run test:integration';
+  defaults.test.integration = {
+    command: wrapWithDoppler(integrationCmd, hasDoppler),
+    doppler: hasDoppler,
+  };
+
+  // L4: E2E Tests via Turbo (with Doppler support)
+  const e2eCmd = 'turbo run test:e2e';
+  defaults.test.e2e = {
+    command: wrapWithDoppler(e2eCmd, hasDoppler),
+    doppler: hasDoppler,
+  };
+
+  // Build via Turbo
+  defaults.build.command = 'turbo run build';
+
+  // CI steps for Turbo projects
+  defaults.ci.steps = ['check', 'test:unit', 'build'];
+
+  return defaults;
+}
+
+/**
+ * Generate defaults for standard single-package projects.
+ * Uses direct tool commands (npx eslint, npx tsc, etc).
+ * @param {string} cwd - Working directory
+ * @param {object} defaults - Base defaults object
+ * @param {boolean} hasDoppler - Whether Doppler is configured
+ * @returns {object} Standard project defaults
+ */
+function detectStandardDefaults(cwd, defaults, hasDoppler) {
   // L1: Static Analysis
   if (hasToolConfig(cwd, TOOL_CONFIGS.eslint)) {
     defaults.check.lint = 'npx eslint .';

package/templates/.husky/pre-push

@@ -1,4 +1,5 @@
-npm run lint
-npm run type-check
-npm test
-npm run build
+# Pre-push hook - kept lightweight by design
+# Full validation (lint, tests, build) runs in CI asynchronously
+#
+# Uncomment below if you want local type-check before push:
+# npm run type-check