@kabran-tecnologia/kabran-config 1.10.0 → 1.12.0

package/src/core/config-loader.mjs

@@ -0,0 +1,154 @@
+/**
+ * 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.
+ *
+ * @module config-loader
+ */
+
+import {existsSync} from 'node:fs';
+import {readFile} from 'node:fs/promises';
+import {join} from 'node:path';
+import {pathToFileURL} from 'node:url';
+
+/**
+ * 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',
+  },
+};
+
+/**
+ * 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.
+ *
+ * Searches for configuration files in order:
+ * 1. kabran.config.mjs
+ * 2. kabran.config.js
+ * 3. kabran.config.json
+ *
+ * If no config file is found, returns DEFAULTS.
+ *
+ * @param {string} [cwd=process.cwd()] - Directory to search for config
+ * @returns {Promise<object>} Merged configuration
+ *
+ * @example
+ * const config = await loadConfig();
+ * console.log(config.readme.required); // ['Installation', 'Usage', 'License']
+ *
+ * @example
+ * // With custom config in kabran.config.mjs:
+ * // export default { readme: { required: ['Setup', 'API'] } }
+ * const config = await loadConfig('/path/to/project');
+ * console.log(config.readme.required); // ['Setup', 'API']
+ */
+export async function loadConfig(cwd = process.cwd()) {
+  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(DEFAULTS, projectConfig);
+      } catch (error) {
+        // Log warning but continue with defaults
+        console.warn(`Warning: Failed to load ${fileName}: ${error.message}`);
+      }
+    }
+  }
+
+  return DEFAULTS;
+}
+
+/**
+ * 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/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.

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # ==============================================================================
 # Kabran Traceability Core - Shared Functions
-# Part of @kabran-owner/kabran-config
+# Part of @kabran-tecnologia/kabran-config
 # Implements PROP-006: JSDoc Traceability Tags
 # ==============================================================================
 

package/src/scripts/traceability/validate-traceability.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 # ==============================================================================
 # Kabran Traceability Validator
-# Part of @kabran-owner/kabran-config
+# Part of @kabran-tecnologia/kabran-config
 # Implements PROP-006: JSDoc Traceability Tags
 #
 # Validates FORMAT of traceability tags (not presence).

package/src/telemetry/README.md

@@ -161,8 +161,8 @@ SERVICE_VERSION=1.0.0                # Service version (default: 1.0.0)
 ENVIRONMENT=production               # Environment name (default: from NODE_ENV)
 OTEL_NAMESPACE=kabran                # Service namespace (default: kabran)
 
-# OTLP Exporter
-OTEL_EXPORTER_OTLP_ENDPOINT=https://otel.kabran.com.br  # Collector endpoint
+# OTLP Exporter (REQUIRED)
+OTEL_EXPORTER_OTLP_ENDPOINT=https://your-otel-collector.example.com  # Your collector endpoint
 OTEL_EXPORTER_OTLP_TIMEOUT=10000     # Export timeout in ms (default: 10000)
 
 # Sampling
@@ -188,7 +188,7 @@ initTelemetry({
   // Optional (all have sensible defaults)
   serviceVersion: '1.0.0',
   environment: 'production',
-  endpoint: 'https://otel.kabran.com.br',
+  endpoint: process.env.OTEL_ENDPOINT, // Required - set via env var
   sampleRate: 0.1,
   enabled: true,
 
@@ -292,20 +292,20 @@ import {
 } from '@kabran-tecnologia/kabran-config/telemetry/shared'
 ```
 
-## Integration with Kosmos Observability
+## Integration with Observability Stack
 
-This package is designed to work with the Kosmos observability stack:
+This package is designed to work with standard observability stacks:
 
-- **Traces** → Grafana Tempo
+- **Traces** → Grafana Tempo, Jaeger, or any OTLP-compatible backend
 - **Logs** → Grafana Loki (via stdout/Promtail or direct export)
-- **Metrics** → Prometheus (planned, see [GAP-006])
+- **Metrics** → Prometheus (planned)
 
-Default endpoint: `https://otel.kabran.com.br`
+**Note:** You must configure `OTEL_ENDPOINT` to point to your OTLP collector.
 
 ### Viewing Traces
 
-1. Open Grafana at your Kosmos instance
-2. Go to Explore → Select Tempo
+1. Open your observability dashboard (e.g., Grafana)
+2. Go to Explore → Select your trace backend (Tempo, Jaeger, etc.)
 3. Search by service name or trace ID
 
 ## Best Practices
@@ -404,4 +404,4 @@ initTelemetry({
 
 - [OpenTelemetry JavaScript](https://opentelemetry.io/docs/languages/js/)
 - [W3C Trace Context](https://www.w3.org/TR/trace-context/)
-- [Kosmos Observability Stack](https://github.com/kabran-owner/kosmos/tree/main/services/observability)
+- [OpenTelemetry Collector](https://opentelemetry.io/docs/collector/)

package/src/telemetry/config/defaults.mjs

@@ -76,9 +76,10 @@ function parseIgnorePaths(value) {
 
 /**
  * Default OTLP endpoint
- * Override: OTEL_EXPORTER_OTLP_ENDPOINT or OTEL_ENDPOINT
+ * REQUIRED: Set via OTEL_EXPORTER_OTLP_ENDPOINT or OTEL_ENDPOINT
+ * No default is provided - users must configure their own collector endpoint
  */
-export const DEFAULT_ENDPOINT = 'https://otel.kabran.com.br'
+export const DEFAULT_ENDPOINT = null
 
 /**
  * Default OTLP traces path
@@ -107,12 +108,9 @@ export const DEFAULT_NAMESPACE = 'kabran'
 /**
  * Default CORS URLs for trace header propagation
  * Override: OTEL_PROPAGATE_TRACE_HEADER_CORS_URLS (comma-separated regex patterns)
+ * Only localhost is included by default - configure additional domains via env var
  */
-export const DEFAULT_CORS_URLS = [
-  /.*\.supabase\.co/,
-  /.*\.kabran\.com\.br/,
-  /localhost/,
-]
+export const DEFAULT_CORS_URLS = [/localhost/]
 
 /**
  * Default instrumentation options

package/src/telemetry/shared/types.d.ts

@@ -21,7 +21,7 @@ export interface TelemetryConfig {
   /** Deployment environment (default: from NODE_ENV or 'development') */
   environment?: string
 
-  /** OTLP endpoint URL (default: 'https://otel.kabran.com.br') */
+  /** OTLP endpoint URL (required - set via OTEL_ENDPOINT env var) */
   endpoint?: string
 
   /** Sampling rate 0.0-1.0 (default: 0.1) */