@kabran-tecnologia/kabran-config 1.10.0 → 2.0.0

package/src/core/config-loader.mjs

@@ -0,0 +1,305 @@
+/**
+ * Kabran Config Loader
+ *
+ * Loads project configuration from kabran.config.mjs/js/json with fallback to defaults.
+ * Enables projects to customize validator behavior without modifying kabran-config.
+ *
+ * Features:
+ * - Smart detection of tools (ESLint, TypeScript, Prettier, Vitest, Playwright)
+ * - Automatic Doppler integration for secrets injection in tests
+ * - Convention over configuration - works out of the box
+ *
+ * @module config-loader
+ */
+
+import {existsSync, readFileSync} from 'node:fs';
+import {readFile} from 'node:fs/promises';
+import {join} from 'node:path';
+import {pathToFileURL} from 'node:url';
+import {execSync} from 'node:child_process';
+
+/**
+ * Default configuration values.
+ * These match the current hardcoded values in validators to ensure backwards compatibility.
+ */
+export const DEFAULTS = {
+  readme: {
+    required: ['Installation', 'Usage', 'License'],
+    recommended: ['Development', 'Testing', 'Contributing'],
+  },
+  env: {
+    requireExample: true,
+    detectPatterns: ['process.env', 'import.meta.env', 'Deno.env', 'os.getenv', '$_ENV'],
+  },
+  quality: {
+    standardPath: 'docs/quality/001-quality-standard.md',
+  },
+};
+
+/**
+ * Config file patterns for each tool.
+ */
+const TOOL_CONFIGS = {
+  eslint: ['eslint.config.mjs', 'eslint.config.js', 'eslint.config.cjs', '.eslintrc.js', '.eslintrc.json', '.eslintrc.cjs'],
+  typescript: ['tsconfig.json'],
+  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'],
+};
+
+/**
+ * Check if any of the config files exist for a tool.
+ * @param {string} cwd - Working directory
+ * @param {string[]} configFiles - List of possible config file names
+ * @returns {boolean} True if any config file exists
+ */
+function hasToolConfig(cwd, configFiles) {
+  return configFiles.some(file => existsSync(join(cwd, file)));
+}
+
+/**
+ * Check if Doppler is configured for the current directory.
+ * @param {string} cwd - Working directory
+ * @returns {boolean} True if Doppler token is configured
+ */
+function hasDopplerConfigured(cwd) {
+  try {
+    const result = execSync('doppler configure get token', {
+      cwd,
+      stdio: 'pipe',
+      encoding: 'utf-8',
+      timeout: 5000,
+    });
+    return result.trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Wrap command with Doppler if configured.
+ * @param {string} cmd - Command to wrap
+ * @param {boolean} useDoppler - Whether to use Doppler
+ * @returns {string} Wrapped command
+ */
+export function wrapWithDoppler(cmd, useDoppler) {
+  return useDoppler ? `doppler run -- ${cmd}` : cmd;
+}
+
+/**
+ * Detect available tools and generate smart defaults.
+ * Only configures commands for tools that are actually set up in the project.
+ * @param {string} cwd - Working directory
+ * @returns {object} Detected defaults for CLI commands
+ */
+export function detectToolDefaults(cwd) {
+  const defaults = {
+    check: {},
+    test: {},
+    build: {},
+    ci: { steps: [] },
+  };
+
+  const hasDoppler = hasDopplerConfigured(cwd);
+
+  // L1: Static Analysis
+  if (hasToolConfig(cwd, TOOL_CONFIGS.eslint)) {
+    defaults.check.lint = 'npx eslint .';
+  }
+
+  if (hasToolConfig(cwd, TOOL_CONFIGS.typescript)) {
+    defaults.check.types = 'npx tsc --noEmit';
+  }
+
+  if (hasToolConfig(cwd, TOOL_CONFIGS.prettier)) {
+    defaults.check.format = 'npx prettier --check .';
+  }
+
+  // L2: Unit Tests (with Doppler support)
+  if (hasToolConfig(cwd, TOOL_CONFIGS.vitest)) {
+    const cmd = 'npx vitest run';
+    defaults.test.unit = {
+      command: wrapWithDoppler(cmd, hasDoppler),
+      doppler: hasDoppler,
+    };
+  }
+
+  // L3: Integration Tests (with Doppler support)
+  const integrationConfig = join(cwd, 'vitest.integration.config.ts');
+  if (existsSync(integrationConfig)) {
+    const cmd = 'npx vitest run --config vitest.integration.config.ts';
+    defaults.test.integration = {
+      command: wrapWithDoppler(cmd, hasDoppler),
+      doppler: hasDoppler,
+    };
+  }
+
+  // L4: E2E Tests (with Doppler support)
+  if (hasToolConfig(cwd, TOOL_CONFIGS.playwright)) {
+    const cmd = 'npx playwright test';
+    defaults.test.e2e = {
+      command: wrapWithDoppler(cmd, hasDoppler),
+      doppler: hasDoppler,
+    };
+  }
+
+  // Build - check if npm run build exists in package.json
+  const packageJsonPath = join(cwd, 'package.json');
+  if (existsSync(packageJsonPath)) {
+    try {
+      const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+      if (packageJson.scripts?.build) {
+        defaults.build.command = 'npm run build';
+      }
+    } catch {
+      // Ignore parse errors
+    }
+  }
+
+  // CI steps - add detected tools
+  if (Object.keys(defaults.check).length > 0) {
+    defaults.ci.steps.push('check');
+  }
+  if (defaults.test.unit) {
+    defaults.ci.steps.push('test:unit');
+  }
+  if (defaults.build.command) {
+    defaults.ci.steps.push('build');
+  }
+
+  return defaults;
+}
+
+/**
+ * Configuration file names to search for, in priority order.
+ */
+const CONFIG_FILES = ['kabran.config.mjs', 'kabran.config.js', 'kabran.config.json'];
+
+/**
+ * Deep merge two objects. Arrays are replaced, not merged.
+ * @param {object} target - Base object
+ * @param {object} source - Object to merge in
+ * @returns {object} Merged object
+ */
+function deepMerge(target, source) {
+  const result = {...target};
+
+  for (const key of Object.keys(source)) {
+    const sourceValue = source[key];
+    const targetValue = target[key];
+
+    if (sourceValue === null || sourceValue === undefined) {
+      continue;
+    }
+
+    if (
+      typeof sourceValue === 'object' &&
+      !Array.isArray(sourceValue) &&
+      typeof targetValue === 'object' &&
+      !Array.isArray(targetValue)
+    ) {
+      result[key] = deepMerge(targetValue, sourceValue);
+    } else {
+      result[key] = sourceValue;
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Load JSON configuration file.
+ * @param {string} configPath - Path to JSON config file
+ * @returns {Promise<object>} Parsed configuration
+ */
+async function loadJsonConfig(configPath) {
+  const content = await readFile(configPath, 'utf-8');
+  return JSON.parse(content);
+}
+
+/**
+ * Load JavaScript/ESM configuration file.
+ * @param {string} configPath - Path to JS/MJS config file
+ * @returns {Promise<object>} Parsed configuration
+ */
+async function loadJsConfig(configPath) {
+  const configUrl = pathToFileURL(configPath).href;
+  const module = await import(configUrl);
+  return module.default || module;
+}
+
+/**
+ * Load project configuration with fallback to defaults.
+ *
+ * Configuration priority (highest to lowest):
+ * 1. Project config (kabran.config.mjs/js/json)
+ * 2. Detected tool defaults (based on existing config files)
+ * 3. Static defaults (validators)
+ *
+ * Features:
+ * - Smart detection of ESLint, TypeScript, Prettier, Vitest, Playwright
+ * - Automatic Doppler integration for secrets in tests
+ * - Project-specific overrides take precedence
+ *
+ * @param {string} [cwd=process.cwd()] - Directory to search for config
+ * @returns {Promise<object>} Merged configuration
+ *
+ * @example
+ * // Zero-config: auto-detects tools in project
+ * const config = await loadConfig();
+ * // If project has vitest.config.ts, config.test.unit.command is set
+ *
+ * @example
+ * // With custom config in kabran.config.mjs (overrides detected defaults):
+ * // export default { test: { unit: { command: 'npm test' } } }
+ * const config = await loadConfig('/path/to/project');
+ */
+export async function loadConfig(cwd = process.cwd()) {
+  // 1. Start with static defaults (validators)
+  let config = {...DEFAULTS};
+
+  // 2. Merge detected tool defaults (CLI commands)
+  const toolDefaults = detectToolDefaults(cwd);
+  config = deepMerge(config, toolDefaults);
+
+  // 3. Merge project-specific configuration (highest priority)
+  for (const fileName of CONFIG_FILES) {
+    const configPath = join(cwd, fileName);
+
+    if (existsSync(configPath)) {
+      try {
+        let projectConfig;
+
+        if (fileName.endsWith('.json')) {
+          projectConfig = await loadJsonConfig(configPath);
+        } else {
+          projectConfig = await loadJsConfig(configPath);
+        }
+
+        return deepMerge(config, projectConfig);
+      } catch (error) {
+        // Log warning but continue with detected defaults
+        console.warn(`Warning: Failed to load ${fileName}: ${error.message}`);
+      }
+    }
+  }
+
+  return config;
+}
+
+/**
+ * Check if a config file exists in the given directory.
+ * @param {string} [cwd=process.cwd()] - Directory to check
+ * @returns {{exists: boolean, path?: string, name?: string}} Config file info
+ */
+export function findConfigFile(cwd = process.cwd()) {
+  for (const fileName of CONFIG_FILES) {
+    const configPath = join(cwd, fileName);
+
+    if (existsSync(configPath)) {
+      return {exists: true, path: configPath, name: fileName};
+    }
+  }
+
+  return {exists: false};
+}

package/src/schemas/ci-result.v2.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://kabran.dev/schemas/ci-result.v2.json",
+  "$id": "ci-result.v2.json",
   "title": "CI Result Schema v2",
   "description": "Unified schema for CI/CD results with quality metrics, timing, and observability data",
   "type": "object",

package/src/scripts/ci/ci-core.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # ==============================================================================
 # Kabran CI Core - Shared Functions
-# Part of @kabran-owner/kabran-config
+# Part of @kabran-tecnologia/kabran-config
 # ==============================================================================
 
 # Version

package/src/scripts/ci-result-history.mjs

@@ -51,7 +51,7 @@ export function extractHistoryEntry(result) {
 export function loadHistory(filePath) {
   if (!existsSync(filePath)) {
     return {
-      $schema: 'https://kabran.dev/schemas/ci-result-history.json',
+      $schema: 'ci-result-history.json',
       version: '1.0.0',
       meta: {
         created_at: new Date().toISOString(),
@@ -75,7 +75,7 @@ export function loadHistory(filePath) {
   } catch (error) {
     // If file is corrupted, start fresh
     return {
-      $schema: 'https://kabran.dev/schemas/ci-result-history.json',
+      $schema: 'ci-result-history.json',
       version: '1.0.0',
       meta: {
         created_at: new Date().toISOString(),

package/src/scripts/ci-result-utils.mjs

@@ -436,7 +436,7 @@ export function createMinimalResult({ projectName, passed = true }) {
   const now = new Date().toISOString()
 
   return {
-    $schema: 'https://kabran.dev/schemas/ci-result.v2.json',
+    $schema: 'ci-result.v2.json',
     version: '1.0.0',
     meta: {
       generated_at: now,

package/src/scripts/deploy/deploy-core.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # ==============================================================================
 # Kabran Deploy Core - Shared Functions
-# Part of @kabran-owner/kabran-config
+# Part of @kabran-tecnologia/kabran-config
 # ==============================================================================
 
 # ==============================================================================

package/src/scripts/env-validator.mjs

@@ -18,9 +18,13 @@ import {exec} from 'node:child_process';
 import {promisify} from 'node:util';
 import fs from 'node:fs';
 import path from 'node:path';
+import {loadConfig, DEFAULTS} from '../core/config-loader.mjs';
 
 const execAsync = promisify(exec);
 
+// Default patterns for backwards compatibility
+export const DEFAULT_DETECT_PATTERNS = DEFAULTS.env.detectPatterns;
+
 /**
  * Check if .env file is tracked in git (CRITICAL SECURITY ISSUE)
  * @param {string} [cwd] - Directory to check (defaults to process.cwd())
@@ -40,17 +44,10 @@ export async function checkEnvInGit(cwd = process.cwd()) {
 /**
  * Detect if project uses environment variables
  * @param {string} [cwd] - Directory to check (defaults to process.cwd())
+ * @param {string[]} [patterns] - Patterns to search for (defaults to config patterns)
  * @returns {Promise<{usesEnv: boolean, files: string[]}>}
  */
-export async function detectEnvUsage(cwd = process.cwd()) {
-  const patterns = [
-    'process.env',      // Node.js
-    'os.getenv',        // Python
-    'import.meta.env',  // Vite/ESM
-    'Deno.env',         // Deno
-    '$_ENV',            // PHP
-  ];
-
+export async function detectEnvUsage(cwd = process.cwd(), patterns = DEFAULT_DETECT_PATTERNS) {
   const extensions = ['js', 'ts', 'jsx', 'tsx', 'mjs', 'cjs', 'py', 'php'];
   const extensionPattern = extensions.join(',');
 
@@ -157,6 +154,9 @@ export async function validateEnv(cwd = process.cwd(), silent = false) {
   const errors = [];
   const warnings = [];
 
+  // Load project config
+  const config = await loadConfig(cwd);
+
   // CRITICAL: Check if .env is committed to git
   log('Checking for .env in git...');
   const envInGit = await checkEnvInGit(cwd);
@@ -171,7 +171,7 @@ export async function validateEnv(cwd = process.cwd(), silent = false) {
 
   // Detect if project uses environment variables
   log('Detecting environment variable usage...');
-  const {usesEnv, files} = await detectEnvUsage(cwd);
+  const {usesEnv, files} = await detectEnvUsage(cwd, config.env.detectPatterns);
 
   if (!usesEnv) {
     log('  No environment variable usage detected');
@@ -236,9 +236,10 @@ export async function validateEnv(cwd = process.cwd(), silent = false) {
  * @returns {Promise<Object>} Check result for ci-result.json
  */
 export async function getEnvCheckResult(cwd = process.cwd()) {
+  const config = await loadConfig(cwd);
   const envInGit = await checkEnvInGit(cwd);
   const envExample = checkEnvExampleExists(cwd);
-  const {usesEnv} = await detectEnvUsage(cwd);
+  const {usesEnv} = await detectEnvUsage(cwd, config.env.detectPatterns);
 
   let undocumented = [];
   if (envExample.exists) {

package/src/scripts/generate-ci-result.mjs

@@ -103,7 +103,7 @@ async function runValidators(projectRoot, options = {}) {
 
   if (!options.skipReadme) {
     try {
-      results.readme = getReadmeCheckResult(projectRoot)
+      results.readme = await getReadmeCheckResult(projectRoot)
     } catch (err) {
       results.readme = { status: 'fail', error: err.message }
     }
@@ -119,7 +119,7 @@ async function runValidators(projectRoot, options = {}) {
 
   if (!options.skipQualityStandard) {
     try {
-      results.quality_standard = getQualityStandardCheckResult(projectRoot)
+      results.quality_standard = await getQualityStandardCheckResult(projectRoot)
     } catch (err) {
       results.quality_standard = { status: 'fail', error: err.message }
     }
@@ -216,7 +216,7 @@ export function generateCiResult(input) {
 
   // Build result object
   const result = {
-    $schema: 'https://kabran.dev/schemas/ci-result.v2.json',
+    $schema: 'ci-result.v2.json',
     version: '1.0.0',
 
     meta,

package/src/scripts/quality-standard-validator.mjs

@@ -16,6 +16,10 @@
 
 import {existsSync, readFileSync} from 'node:fs';
 import {join} from 'node:path';
+import {loadConfig, DEFAULTS} from '../core/config-loader.mjs';
+
+// Default path for backwards compatibility
+export const DEFAULT_STANDARD_PATH = DEFAULTS.quality.standardPath;
 
 /**
  * Required sections that must be present in quality-standard.md
@@ -33,10 +37,11 @@ export const REQUIRED_FRONTMATTER = ['title', 'type', 'status'];
 /**
  * Find quality-standard.md file in the project
  * @param {string} cwd - Current working directory
+ * @param {string} [standardPath] - Path to quality standard file (relative to cwd)
  * @returns {{exists: boolean, path?: string} | null} File info or null
  */
-export function findQualityStandard(cwd = process.cwd()) {
-  const expectedPath = join(cwd, 'docs', 'quality', '001-quality-standard.md');
+export function findQualityStandard(cwd = process.cwd(), standardPath = DEFAULT_STANDARD_PATH) {
+  const expectedPath = join(cwd, standardPath);
 
   if (existsSync(expectedPath)) {
     return {
@@ -183,26 +188,30 @@ export function compareOverrides(documented, code) {
  * Validate quality-standard.md
  * @param {string} cwd - Current working directory
  * @param {boolean} silent - Suppress console output (for testing)
- * @returns {{valid: boolean, errors: string[], warnings: string[]}} Validation result
+ * @returns {Promise<{valid: boolean, errors: string[], warnings: string[]}>} Validation result
  */
-export function validate(cwd = process.cwd(), silent = false) {
+export async function validate(cwd = process.cwd(), silent = false) {
   const log = silent ? () => {} : console.log.bind(console);
   const error = silent ? () => {} : console.error.bind(console);
 
   const errors = [];
   const warnings = [];
 
+  // Load project config
+  const config = await loadConfig(cwd);
+  const standardPath = config.quality.standardPath;
+
   log('');
   log('Validating Quality Standard...');
   log('='.repeat(50));
 
   // 1. Check file exists
-  const fileInfo = findQualityStandard(cwd);
+  const fileInfo = findQualityStandard(cwd, standardPath);
 
   if (!fileInfo) {
-    errors.push('Missing required file: docs/quality/001-quality-standard.md');
+    errors.push(`Missing required file: ${standardPath}`);
     error('');
-    error('ERROR: Missing required file: docs/quality/001-quality-standard.md');
+    error(`ERROR: Missing required file: ${standardPath}`);
     error('');
     error('Run "npx kabran-setup" to create it, or create manually.');
     log('='.repeat(50));
@@ -210,7 +219,7 @@ export function validate(cwd = process.cwd(), silent = false) {
   }
 
   log('');
-  log('File: docs/quality/001-quality-standard.md');
+  log(`File: ${standardPath}`);
   log('  Status: Found');
 
   // 2. Read and parse content
@@ -317,10 +326,12 @@ export function validate(cwd = process.cwd(), silent = false) {
 /**
  * Get quality standard validation result in ci-result.json format
  * @param {string} [cwd] - Directory to validate (defaults to process.cwd())
- * @returns {Object} Check result for ci-result.json
+ * @returns {Promise<Object>} Check result for ci-result.json
  */
-export function getQualityStandardCheckResult(cwd = process.cwd()) {
-  const fileInfo = findQualityStandard(cwd);
+export async function getQualityStandardCheckResult(cwd = process.cwd()) {
+  const config = await loadConfig(cwd);
+  const standardPath = config.quality.standardPath;
+  const fileInfo = findQualityStandard(cwd, standardPath);
 
   if (!fileInfo) {
     return {
@@ -372,11 +383,11 @@ if (isMainModule) {
     const cwd = args.find(a => !a.startsWith('--')) || process.cwd();
 
     if (jsonOutput) {
-      const result = getQualityStandardCheckResult(cwd);
+      const result = await getQualityStandardCheckResult(cwd);
       console.log(JSON.stringify(result, null, 2));
       process.exit(result.status === 'fail' ? 1 : 0);
     } else {
-      const result = validate(cwd);
+      const result = await validate(cwd);
       process.exit(result.valid ? 0 : 1);
     }
   } catch (err) {

package/src/scripts/readme-validator.mjs

@@ -16,21 +16,27 @@
 
 import fs from 'node:fs';
 import path from 'node:path';
+import {loadConfig, DEFAULTS} from '../core/config-loader.mjs';
 
-// Required sections (blocking if missing)
+/**
+ * Build section patterns from config array.
+ * @param {string[]} sections - Section names
+ * @returns {Array<{pattern: RegExp, name: string}>}
+ */
+function buildSectionPatterns(sections) {
+  return sections.map(name => ({
+    pattern: new RegExp(`^##\\s+${name}`, 'mi'),
+    name,
+  }));
+}
+
+// Default sections for backwards compatibility (used when importing directly)
 export const REQUIRED_SECTIONS = [
   {pattern: /^#\s+.+/m, name: 'Project Title (# Heading)'},
-  {pattern: /^##\s+Installation/mi, name: 'Installation'},
-  {pattern: /^##\s+Usage/mi, name: 'Usage'},
-  {pattern: /^##\s+License/mi, name: 'License'},
+  ...buildSectionPatterns(DEFAULTS.readme.required),
 ];
 
-// Recommended sections (warnings only)
-export const RECOMMENDED_SECTIONS = [
-  {pattern: /^##\s+Development/mi, name: 'Development'},
-  {pattern: /^##\s+Contributing/mi, name: 'Contributing'},
-  {pattern: /^##\s+Testing/mi, name: 'Testing'},
-];
+export const RECOMMENDED_SECTIONS = buildSectionPatterns(DEFAULTS.readme.recommended);
 
 /**
  * Find README.md in directory
@@ -64,9 +70,9 @@ export function checkSection(content, section) {
  * Main validation function
  * @param {string} [cwd] - Directory to validate (defaults to process.cwd())
  * @param {boolean} [silent] - Suppress console output
- * @returns {{valid: boolean, errors: string[], warnings: string[]}}
+ * @returns {Promise<{valid: boolean, errors: string[], warnings: string[]}>}
  */
-export function validateReadme(cwd = process.cwd(), silent = false) {
+export async function validateReadme(cwd = process.cwd(), silent = false) {
   const log = silent ? () => {} : console.log.bind(console);
   const error = silent ? () => {} : console.error.bind(console);
 
@@ -75,6 +81,16 @@ export function validateReadme(cwd = process.cwd(), silent = false) {
   const errors = [];
   const warnings = [];
 
+  // Load project config
+  const config = await loadConfig(cwd);
+
+  // Build section patterns from config
+  const requiredSections = [
+    {pattern: /^#\s+.+/m, name: 'Project Title (# Heading)'},
+    ...buildSectionPatterns(config.readme.required),
+  ];
+  const recommendedSections = buildSectionPatterns(config.readme.recommended);
+
   // Check if README exists
   const readme = findReadme(cwd);
   if (!readme) {
@@ -90,7 +106,7 @@ export function validateReadme(cwd = process.cwd(), silent = false) {
 
   // Check required sections
   log('Checking required sections:');
-  for (const section of REQUIRED_SECTIONS) {
+  for (const section of requiredSections) {
     const exists = checkSection(content, section);
     if (exists) {
       log(`  OK ${section.name}`);
@@ -102,7 +118,7 @@ export function validateReadme(cwd = process.cwd(), silent = false) {
 
   // Check recommended sections
   log('\nChecking recommended sections:');
-  for (const section of RECOMMENDED_SECTIONS) {
+  for (const section of recommendedSections) {
     const exists = checkSection(content, section);
     if (exists) {
       log(`  OK ${section.name}`);
@@ -134,10 +150,10 @@ export function validateReadme(cwd = process.cwd(), silent = false) {
 /**
  * Get README validation result in ci-result.json format
  * @param {string} [cwd] - Directory to validate (defaults to process.cwd())
- * @returns {Object} Check result for ci-result.json
+ * @returns {Promise<Object>} Check result for ci-result.json
  */
-export function getReadmeCheckResult(cwd = process.cwd()) {
-  const result = validateReadme(cwd, true);
+export async function getReadmeCheckResult(cwd = process.cwd()) {
+  const result = await validateReadme(cwd, true);
 
   // Determine status
   let status = 'pass';
@@ -169,11 +185,11 @@ if (isMainModule) {
     const cwd = args.find(a => !a.startsWith('--')) || process.cwd();
 
     if (jsonOutput) {
-      const result = getReadmeCheckResult(cwd);
+      const result = await getReadmeCheckResult(cwd);
       console.log(JSON.stringify(result, null, 2));
       process.exit(result.status === 'fail' ? 1 : 0);
     } else {
-      const result = validateReadme(cwd);
+      const result = await validateReadme(cwd);
       process.exit(result.valid ? 0 : 1);
     }
   } catch (err) {

package/src/scripts/setup.mjs

@@ -427,6 +427,7 @@ export function setupConfigs(projectDir, templatesDir, options) {
   // Other configs (same for all types)
   const otherConfigs = [
     {name: 'prettier.config.mjs', src: 'prettier.config.mjs'},
+    {name: '.prettierignore', src: '.prettierignore'},
     {name: 'commitlint.config.mjs', src: 'commitlint.config.mjs'},
     {name: 'lint-staged.config.mjs', src: 'lint-staged.config.mjs'},
   ];

package/src/scripts/traceability/coverage-report.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # ==============================================================================
 # Kabran Traceability Coverage Report
-# Part of @kabran-owner/kabran-config
+# Part of @kabran-tecnologia/kabran-config
 # Implements PROP-006: JSDoc Traceability Tags
 #
 # Generates a report of spec coverage in the codebase.