@tamyla/clodo-framework 3.1.23 → 3.1.25

package/dist/cli/commands/validate.js

@@ -1,49 +1,39 @@
-/**
- * Validate Command - Validate an existing service configuration
- */
-
 import chalk from 'chalk';
-import { ServiceOrchestrator } from '../service-management/ServiceOrchestrator.js';
-import { StandardOptions } from '../lib/shared/utils/cli-options.js';
-import { ConfigLoader } from '../lib/shared/utils/config-loader.js';
+import { Clodo } from '../../src/simple-api.js';
+import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
 export function registerValidateCommand(program) {
-  const command = program.command('validate <service-path>').description('Validate an existing service configuration').option('--deep-scan', 'Run comprehensive validation checks').option('--export-report <file>', 'Export validation report to JSON file');
+  const command = program.command('validate <service-path>').description('Validate an existing service configuration').option('--export-report <file>', 'Export validation report to JSON file');
 
   // Add standard options (--verbose, --quiet, --json, --no-color, --config-file)
   StandardOptions.define(command).action(async (servicePath, options) => {
     try {
-      const output = new (await import('../lib/shared/utils/output-formatter.js')).OutputFormatter(options);
-      const configLoader = new ConfigLoader({
-        verbose: options.verbose,
-        quiet: options.quiet,
-        json: options.json
-      });
+      const output = new (await import('../../lib/shared/utils/output-formatter.js')).OutputFormatter(options);
 
-      // Load config from file if specified
-      let configFileData = {};
-      if (options.configFile) {
-        configFileData = configLoader.loadSafe(options.configFile, {});
-        if (options.verbose && !options.quiet) {
-          output.info(`Loaded configuration from: ${options.configFile}`);
-        }
-      }
-
-      // Merge config file defaults with CLI options (CLI takes precedence)
-      const mergedOptions = configLoader.merge(configFileData, options);
-      const orchestrator = new ServiceOrchestrator();
-      const result = await orchestrator.validateService(servicePath, {
-        deepScan: mergedOptions.deepScan,
-        exportReport: mergedOptions.exportReport
+      // Use simple API for validation
+      const result = await Clodo.validate({
+        servicePath: servicePath || '.',
+        exportReport: options.exportReport
       });
-      if (result.valid) {
-        output.success('Service configuration is valid');
+      if (result.success) {
+        output.success(result.message);
+        if (result.issues && result.issues.length > 0) {
+          output.warning(`Found ${result.issues.length} issues:`);
+          result.issues.forEach(issue => {
+            output.info(`  - ${issue}`);
+          });
+        }
       } else {
-        output.error('Service configuration has issues:');
-        output.list(result.issues || []);
+        output.error(result.message);
+        if (result.issues && result.issues.length > 0) {
+          output.info('Issues found:');
+          result.issues.forEach(issue => {
+            output.info(`  - ${issue}`);
+          });
+        }
         process.exit(1);
       }
     } catch (error) {
-      const output = new (await import('../lib/shared/utils/output-formatter.js')).OutputFormatter(options || {});
+      const output = new (await import('../../lib/shared/utils/output-formatter.js')).OutputFormatter(options || {});
       output.error(`Validation failed: ${error.message}`);
       process.exit(1);
     }

package/dist/cli/security-cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { SecurityCLI } from '../security/SecurityCLI.js';
+import { SecurityCLI } from '../src/security/SecurityCLI.js';
 const command = process.argv[2];
 const args = process.argv.slice(3);
 async function main() {

package/dist/deployment/wrangler-deployer.js

@@ -2,7 +2,7 @@ import { spawn } from 'child_process';
 import { execSync } from 'child_process';
 import fs from 'fs';
 import path from 'path';
-import { WranglerD1Manager } from '../lib/database/wrangler-d1-manager.js';
+import { WranglerD1Manager } from '../../lib/database/wrangler-d1-manager.js';
 
 /**
  * WranglerDeployer - Executes actual Cloudflare Workers deployments using wrangler CLI

package/dist/index.js

@@ -6,10 +6,13 @@ export * from './worker/index.js';
 export * from './utils/index.js';
 export * from './orchestration/index.js';
 
+// Simple API - Recommended for most users
+export { default as Clodo, createService, deploy, validate, initialize, getInfo } from './simple-api.js';
+
 // Core framework classes and utilities
 export { FeatureFlagManager } from './config/features.js';
 export { createDomainConfigSchema, validateDomainConfig, createDefaultDomainConfig } from './utils/domain-config.js';
-export { initializeService, createFeatureGuard } from './worker/integration.js';
+export { initializeService } from './worker/integration.js';
 
 // Core data and schema components
 export * from './services/GenericDataService.js';
@@ -25,7 +28,7 @@ export { WranglerDeployer } from './deployment/wrangler-deployer.js';
 export * from './security/index.js';
 
 // Service management components
-export { ServiceCreator, createService } from './service-management/ServiceCreator.js';
+export { ServiceCreator } from './service-management/ServiceCreator.js';
 export { ServiceOrchestrator } from './service-management/ServiceOrchestrator.js';
 export { InputHandler } from './service-management/handlers/InputHandler.js';
 export { ConfirmationHandler } from './service-management/handlers/ConfirmationHandler.js';

package/dist/lib/deployment/modules/DeploymentOrchestrator.js

@@ -6,8 +6,8 @@
 
 import { readFileSync, writeFileSync } from 'fs';
 import { deploySecret, runMigrations, checkHealth } from '../../shared/cloudflare/ops.js';
-import { WranglerDeployer } from '../deployment/wrangler-deployer.js';
-import { DeploymentDatabaseManager } from '../database/deployment-db-manager.js';
+import { WranglerDeployer } from '../../deployment/wrangler-deployer.js';
+import { DeploymentDatabaseManager } from '../../database/deployment-db-manager.js';
 import { DeploymentConfiguration } from './DeploymentConfiguration.js';
 
 /**

package/dist/lib/deployment/modules/EnvironmentManager.js

@@ -3,8 +3,8 @@
  * Handles environment configuration, domain mapping, deployment mode selection, and cross-domain coordination
  */
 
-import { MultiDomainOrchestrator } from '../../orchestration/multi-domain-orchestrator.js';
-import { CrossDomainCoordinator } from '../../orchestration/cross-domain-coordinator.js';
+import { MultiDomainOrchestrator } from '../../../src/orchestration/multi-domain-orchestrator.js';
+import { CrossDomainCoordinator } from '../../../src/orchestration/cross-domain-coordinator.js';
 import { DomainDiscovery } from '../../shared/cloudflare/domain-discovery.js';
 import { askChoice, askUser, askYesNo, DeploymentInteractiveUtils } from '../../shared/utils/interactive-utils.js';
 export class EnvironmentManager {

package/dist/lib/shared/cloudflare/domain-manager.js

@@ -15,7 +15,7 @@ import { promisify } from 'util';
 import { exec } from 'child_process';
 import { askChoice, askYesNo } from '../utils/interactive-prompts.js';
 import { DomainDiscovery } from './domain-discovery.js';
-import { MultiDomainOrchestrator } from '../../orchestration/multi-domain-orchestrator.js';
+import { MultiDomainOrchestrator } from '../../../src/orchestration/multi-domain-orchestrator.js';
 import { getCommandConfig } from '../config/command-config-manager.js';
 import { CloudflareTokenManager } from '../security/api-token-manager.js';
 const execAsync = promisify(exec);

package/dist/lib/shared/cloudflare/ops.js

@@ -242,7 +242,7 @@ export async function listDatabases(options = {}) {
   if (apiToken && accountId) {
     const {
       CloudflareAPI
-    } = await import('../../utils/cloudflare/api.js');
+    } = await import('../../../src/utils/cloudflare/api.js');
     const cf = new CloudflareAPI(apiToken);
     return await cf.listD1Databases(accountId);
   }
@@ -267,7 +267,7 @@ export async function databaseExists(databaseName, options = {}) {
   if (apiToken && accountId) {
     const {
       CloudflareAPI
-    } = await import('../../utils/cloudflare/api.js');
+    } = await import('../../../src/utils/cloudflare/api.js');
     const cf = new CloudflareAPI(apiToken);
     return await cf.d1DatabaseExists(accountId, databaseName);
   }
@@ -290,7 +290,7 @@ export async function createDatabase(name, options = {}) {
   if (apiToken && accountId) {
     const {
       CloudflareAPI
-    } = await import('../../utils/cloudflare/api.js');
+    } = await import('../../../src/utils/cloudflare/api.js');
     const cf = new CloudflareAPI(apiToken);
     const result = await cf.createD1Database(accountId, name);
     return result.uuid; // Return UUID to match CLI behavior
@@ -405,7 +405,7 @@ export async function getDatabaseId(databaseName, options = {}) {
   if (apiToken && accountId) {
     const {
       CloudflareAPI
-    } = await import('../../utils/cloudflare/api.js');
+    } = await import('../../../src/utils/cloudflare/api.js');
     const cf = new CloudflareAPI(apiToken);
     const db = await cf.getD1Database(accountId, databaseName);
     return db?.uuid || null;

package/dist/lib/shared/config/command-config-manager.js

@@ -14,7 +14,7 @@ import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Navigate up to framework root, then to config directory
-const FRAMEWORK_CONFIG_PATH = join(__dirname, '../../config/validation-config.json');
+const FRAMEWORK_CONFIG_PATH = join(__dirname, '../../../config/validation-config.json');
 export class CommandConfigManager {
   constructor(configPath = null) {
     this.configPath = configPath || join(process.cwd(), 'validation-config.json');

package/dist/lib/shared/config/index.js

@@ -7,7 +7,7 @@
 export { ConfigCache } from './cache.js';
 export { ConfigManager } from './manager.js';
 export { CommandConfigManager } from './command-config-manager.js';
-export { CustomerConfigurationManager } from '../../config/customers.js';
+export { CustomerConfigurationManager } from '../../../config/customers.js';
 
 // Phase 3.2 consolidated configuration management
 export { ConfigurationManager, configManager, isFeatureEnabled, getEnabledFeatures, withFeature, FEATURES, COMMON_FEATURES } from './ConfigurationManager.js';

package/dist/lib/shared/config/manifest-loader.js

@@ -276,13 +276,13 @@ export class ManifestLoader {
    */
   static printManifestInfo(manifest) {
     console.log(chalk.cyan('\n📋 Service Configuration:\n'));
-    console.log(chalk.white(`Service Name: ${chalk.bold(manifest.serviceName)}`));
-    console.log(chalk.white(`Service Type: ${chalk.bold(manifest.serviceType)}`));
+    console.log(chalk.white(`Service Name: ${chalk.bold(manifest.service?.name || manifest.serviceName || 'unknown')}`));
+    console.log(chalk.white(`Service Type: ${chalk.bold(manifest.service?.type || manifest.serviceType || 'unknown')}`));
     console.log(chalk.white(`Source: ${chalk.gray(manifest._source)}`));
     if (manifest._legacyNote) {
       console.log(chalk.yellow(`\nℹ️  ${manifest._legacyNote}`));
     }
-    if (manifest.deployment.domains) {
+    if (manifest.deployment && manifest.deployment.domains) {
       console.log(chalk.white(`\nDomains:`));
       manifest.deployment.domains.forEach(domain => {
         console.log(chalk.gray(`  - ${domain.name} (${domain.environment})`));

package/dist/lib/shared/deployment/credential-collector.js

@@ -11,7 +11,7 @@
 import chalk from 'chalk';
 import { askUser, askPassword, askChoice, closePrompts } from '../utils/interactive-prompts.js';
 import { ApiTokenManager } from '../security/api-token-manager.js';
-import { CloudflareAPI } from '../../utils/cloudflare/api.js';
+import { CloudflareAPI } from '../../../src/utils/cloudflare/api.js';
 export class DeploymentCredentialCollector {
   constructor(options = {}) {
     this.servicePath = options.servicePath || '.';

package/dist/lib/shared/deployment/index.js

@@ -4,7 +4,7 @@
  */
 
 export { DeploymentValidator } from './validator.js';
-export { MultiDomainOrchestrator } from '../orchestration/multi-domain-orchestrator.js';
-export { CrossDomainCoordinator } from '../orchestration/cross-domain-coordinator.js';
+export { MultiDomainOrchestrator } from '../../orchestration/multi-domain-orchestrator.js';
+export { CrossDomainCoordinator } from '../../orchestration/cross-domain-coordinator.js';
 export { DeploymentAuditor } from './auditor.js';
 export { RollbackManager } from './rollback-manager.js';

package/dist/lib/shared/deployment/rollback-manager.js

@@ -4,4 +4,4 @@
  * Re-exports the RollbackManager for deployment operations
  */
 
-export { RollbackManager } from '../../deployment/rollback-manager.js';
+export { RollbackManager } from '../../../src/deployment/rollback-manager.js';

package/dist/lib/shared/deployment/utilities/d1-error-recovery.js

@@ -42,7 +42,7 @@ export class D1ErrorRecoveryManager {
         // Import WranglerDeployer for D1 error handling
         const {
           WranglerDeployer
-        } = await import('../../deployment/wrangler-deployer.js');
+        } = await import('../../../src/deployment/wrangler-deployer.js');
         deployer = new WranglerDeployer({
           cwd: config.cwd || process.cwd(),
           environment: config.environment

package/dist/lib/shared/deployment/validator.js

@@ -18,7 +18,7 @@ import { getCommandConfig } from '../config/command-config-manager.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Navigate up to framework root, then to config directory
-const FRAMEWORK_CONFIG_PATH = join(__dirname, '../../config/validation-config.json');
+const FRAMEWORK_CONFIG_PATH = join(__dirname, '../../../config/validation-config.json');
 const execAsync = promisify(exec);
 
 /**

package/dist/lib/shared/deployment/workflows/interactive-database-workflow.js

@@ -7,7 +7,7 @@
  * @module interactive-database-workflow
  */
 
-import { askUser, askYesNo, askChoice } from '../utils/interactive-prompts.js';
+import { askUser, askYesNo, askChoice } from '../../utils/interactive-prompts.js';
 import { databaseExists, createDatabase, deleteDatabase } from '../../cloudflare/ops.js';
 import { exec } from 'child_process';
 import { promisify } from 'util';

package/dist/lib/shared/monitoring/health-checker.js

@@ -14,7 +14,7 @@ const execAsync = promisify(exec);
 // Load framework configuration
 const {
   frameworkConfig
-} = await import('../../utils/framework-config.js');
+} = await import('../../../src/utils/framework-config.js');
 const timing = frameworkConfig.getTiming();
 function makeHttpRequest(url, method = 'GET', timeout = 5000) {
   return new Promise((resolve, reject) => {
@@ -546,7 +546,7 @@ export async function verifyWorkerDeployment(workerName, credentials, options =
       }
       const {
         CloudflareAPI
-      } = await import('../../utils/cloudflare/api.js');
+      } = await import('../../../src/utils/cloudflare/api.js');
       const cfApi = new CloudflareAPI(credentials.token);
 
       // List all workers to find ours

package/dist/lib/shared/routing/domain-router.js

@@ -14,7 +14,7 @@
 
 import { existsSync, readFileSync } from 'fs';
 import { resolve } from 'path';
-import { MultiDomainOrchestrator } from '../../orchestration/multi-domain-orchestrator.js';
+import { MultiDomainOrchestrator } from '../../../src/orchestration/multi-domain-orchestrator.js';
 export class DomainRouter {
   constructor(options = {}) {
     this.configPath = options.configPath || './config/domains.json';

package/dist/lib/shared/utils/config-loader.js

@@ -114,8 +114,9 @@ export class ConfigLoader {
   }
 
   /**
-   * Merge configuration file defaults with CLI options
+   * Deep merge configuration file defaults with CLI options
    * CLI options take precedence over config file defaults
+   * Handles nested objects properly (deep merge)
    * @param {Object} configFile - Configuration loaded from file
    * @param {Object} cliOptions - Options from command line
    * @returns {Object} Merged configuration with CLI options taking precedence
@@ -128,22 +129,57 @@ export class ConfigLoader {
       return configFile || {};
     }
 
-    // Create merged result: start with config file, override with CLI options
-    const merged = {
-      ...configFile
-    };
-    for (const [key, value] of Object.entries(cliOptions)) {
-      // Only override with CLI option if it's explicitly provided (not undefined, null, or empty string)
-      if (value !== undefined && value !== null && value !== '') {
-        merged[key] = value;
-      }
-    }
+    // Start with deep copy of config file
+    const merged = this.deepClone(configFile);
+
+    // Deep merge CLI options on top
+    this.deepMergeInto(merged, cliOptions);
     if (this.verbose && !this.quiet) {
       console.log('📋 Configuration merged: CLI options override file defaults');
     }
     return merged;
   }
 
+  /**
+   * Deep clone an object
+   */
+  deepClone(obj) {
+    if (obj === null || typeof obj !== 'object') return obj;
+    if (obj instanceof Date) return new Date(obj.getTime());
+    if (obj instanceof Array) return obj.map(item => this.deepClone(item));
+    if (typeof obj === 'object') {
+      const cloned = {};
+      for (const key in obj) {
+        if (obj.hasOwnProperty(key)) {
+          cloned[key] = this.deepClone(obj[key]);
+        }
+      }
+      return cloned;
+    }
+  }
+
+  /**
+   * Deep merge source into target (modifies target)
+   */
+  deepMergeInto(target, source) {
+    if (!source || typeof source !== 'object') return;
+    for (const [key, value] of Object.entries(source)) {
+      // Only override if value is explicitly provided (not undefined, null, or empty string)
+      if (value !== undefined && value !== null && value !== '') {
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+          // Deep merge nested objects
+          if (!target[key] || typeof target[key] !== 'object' || Array.isArray(target[key])) {
+            target[key] = {};
+          }
+          this.deepMergeInto(target[key], value);
+        } else {
+          // Override with source value (including arrays and primitives)
+          target[key] = value;
+        }
+      }
+    }
+  }
+
   /**
    * Substitute environment variables in configuration values
    * Format: ${ENV_VAR_NAME} in strings will be replaced with environment variable values

package/dist/lib/shared/utils/service-config-manager.js

@@ -0,0 +1,227 @@
+/**
+ * Service Config Manager
+ * Centralized, reusable configuration loading for CLI commands
+ *
+ * Features:
+ * - Standardized config file discovery across all commands
+ * - Proper error handling with user-friendly messages
+ * - Deep merging of nested configuration objects
+ * - Config validation against schemas
+ * - Debugging support with --show-config-sources
+ * - Environment variable substitution
+ */
+
+import { existsSync } from 'fs';
+import path from 'path';
+import { ConfigLoader } from './config-loader.js';
+export class ServiceConfigManager {
+  constructor(options = {}) {
+    this.configLoader = new ConfigLoader(options);
+    this.verbose = options.verbose || false;
+    this.quiet = options.quiet || false;
+    this.json = options.json || false;
+    this.showSources = options.showSources || false;
+  }
+
+  /**
+   * Load and merge configuration for a service command
+   * @param {string} servicePath - Path to the service directory
+   * @param {Object} cliOptions - CLI options from commander
+   * @param {Object} commandDefaults - Default options for this command
+   * @returns {Object} Merged configuration
+   */
+  async loadServiceConfig(servicePath, cliOptions = {}, commandDefaults = {}) {
+    const sources = [];
+
+    // 1. Load framework defaults (always available)
+    const frameworkConfig = this.loadFrameworkDefaults();
+    sources.push({
+      name: 'Framework Defaults',
+      path: 'config/validation-config.json',
+      config: frameworkConfig,
+      priority: 4
+    });
+
+    // 2. Load service-specific config (highest priority for customization)
+    const serviceConfig = await this.loadServiceConfigFile(servicePath);
+    if (serviceConfig) {
+      sources.push({
+        name: 'Service Config',
+        path: path.join(servicePath, 'validation-config.json'),
+        config: serviceConfig,
+        priority: 1
+      });
+    }
+
+    // 3. Load current directory config (for deploy command compatibility)
+    const cwdConfig = this.loadCwdConfigFile();
+    if (cwdConfig) {
+      sources.push({
+        name: 'Current Directory Config',
+        path: path.join(process.cwd(), 'validation-config.json'),
+        config: cwdConfig,
+        priority: 2
+      });
+    }
+
+    // 4. Load explicitly specified config file
+    let explicitConfig = {};
+    if (cliOptions.configFile) {
+      explicitConfig = this.configLoader.loadSafe(cliOptions.configFile, {});
+      if (Object.keys(explicitConfig).length > 0) {
+        sources.push({
+          name: 'Explicit Config File',
+          path: cliOptions.configFile,
+          config: explicitConfig,
+          priority: 0 // Highest priority
+        });
+      }
+    }
+
+    // Sort sources by priority (lower number = higher priority)
+    sources.sort((a, b) => a.priority - b.priority);
+
+    // Show config sources if requested
+    if (this.showSources) {
+      this.displayConfigSources(sources);
+    }
+
+    // Deep merge all configurations
+    let mergedConfig = {
+      ...commandDefaults
+    };
+    for (const source of sources) {
+      mergedConfig = this.deepMerge(mergedConfig, source.config);
+    }
+
+    // CLI options override everything (except when showing sources)
+    if (!this.showSources) {
+      mergedConfig = this.deepMerge(mergedConfig, cliOptions);
+    }
+
+    // Substitute environment variables
+    mergedConfig = this.configLoader.substituteEnvironmentVariables(mergedConfig);
+    return mergedConfig;
+  }
+
+  /**
+   * Load framework default configuration
+   */
+  loadFrameworkDefaults() {
+    try {
+      const frameworkConfigPath = path.join(process.cwd(), 'config', 'validation-config.json');
+      return this.configLoader.loadSafe(frameworkConfigPath, {});
+    } catch (error) {
+      // Framework config is optional, return empty object
+      return {};
+    }
+  }
+
+  /**
+   * Load service-specific configuration file
+   */
+  async loadServiceConfigFile(servicePath) {
+    if (!servicePath) return null;
+    const configPath = path.join(servicePath, 'validation-config.json');
+    try {
+      if (!existsSync(configPath)) {
+        return null; // File doesn't exist, which is fine
+      }
+      const config = this.configLoader.load(configPath);
+      if (this.verbose && !this.quiet) {
+        console.log(`✅ Loaded service config: ${configPath}`);
+      }
+      return config;
+    } catch (error) {
+      // This is an actual error (file exists but can't be loaded)
+      if (!this.quiet) {
+        console.warn(`⚠️  Failed to load service config from ${configPath}: ${error.message}`);
+        console.warn(`   Using framework defaults instead.`);
+      }
+      return null;
+    }
+  }
+
+  /**
+   * Load configuration from current working directory
+   */
+  loadCwdConfigFile() {
+    const configPath = path.join(process.cwd(), 'validation-config.json');
+    try {
+      if (!existsSync(configPath)) {
+        return null;
+      }
+      const config = this.configLoader.load(configPath);
+      if (this.verbose && !this.quiet) {
+        console.log(`✅ Loaded current directory config: ${configPath}`);
+      }
+      return config;
+    } catch (error) {
+      if (!this.quiet) {
+        console.warn(`⚠️  Failed to load current directory config from ${configPath}: ${error.message}`);
+        console.warn(`   Using framework defaults instead.`);
+      }
+      return null;
+    }
+  }
+
+  /**
+   * Deep merge two configuration objects
+   */
+  deepMerge(target, source) {
+    if (!source || typeof source !== 'object') return target;
+    if (!target || typeof target !== 'object') return source;
+    const result = {
+      ...target
+    };
+    for (const [key, value] of Object.entries(source)) {
+      if (value && typeof value === 'object' && !Array.isArray(value)) {
+        // Deep merge nested objects
+        result[key] = this.deepMerge(result[key] || {}, value);
+      } else {
+        // Override with source value (including arrays and primitives)
+        result[key] = value;
+      }
+    }
+    return result;
+  }
+
+  /**
+   * Display configuration sources for debugging
+   */
+  displayConfigSources(sources) {
+    console.log('\n📋 Configuration Sources (in merge order):');
+    for (const source of sources) {
+      const status = Object.keys(source.config).length > 0 ? '✅ Loaded' : '❌ Empty';
+      console.log(`  ${status} ${source.name}: ${source.path}`);
+    }
+    console.log('\n📋 Final merged configuration:');
+    console.log(JSON.stringify(this.deepMerge({}, ...sources.map(s => s.config)), null, 2));
+    console.log('');
+  }
+
+  /**
+   * Validate service path exists and is accessible
+   */
+  async validateServicePath(servicePath, orchestrator) {
+    if (!servicePath) {
+      // Try auto-detection
+      servicePath = await orchestrator.detectServicePath();
+      if (!servicePath) {
+        const error = new Error('No service path provided and could not auto-detect service directory');
+        error.suggestions = ['Ensure you are in a service directory or specify --service-path', 'Service directories must contain: package.json, src/config/domains.js, wrangler.toml', 'Try: cd /path/to/your/service && clodo-service <command>'];
+        throw error;
+      }
+    }
+
+    // Validate the path exists and is accessible
+    try {
+      await orchestrator.isServiceDirectory(servicePath);
+    } catch (error) {
+      const validationError = new Error(`Invalid service path: ${servicePath}`);
+      validationError.suggestions = ['Ensure the directory exists and is accessible', 'Service directories must contain: package.json, src/config/domains.js, wrangler.toml', `Check permissions for: ${servicePath}`];
+      throw validationError;
+    }
+    return servicePath;
+  }
+}

package/dist/lib/shared/validation/ValidationRegistry.js

@@ -8,7 +8,7 @@
 /**
  * Import validators from src/utils (source of truth)
  */
-import { validateServiceName, validateDomainName, validateCloudflareToken, validateCloudflareId, validateServiceType, validateEnvironment } from '../../utils/validation.js';
+import { validateServiceName, validateDomainName, validateCloudflareToken, validateCloudflareId, validateServiceType, validateEnvironment } from '../../../src/utils/validation.js';
 
 /**
  * Validation Registry - Single source of truth for all validators

package/dist/orchestration/cross-domain-coordinator.js

@@ -19,13 +19,13 @@
 
 import { access } from 'fs/promises';
 import { MultiDomainOrchestrator } from './multi-domain-orchestrator.js';
-import { DeploymentValidator } from '../lib/shared/deployment/validator.js';
-import { RollbackManager } from '../lib/shared/deployment/rollback-manager.js';
-import { DomainDiscovery } from '../lib/shared/cloudflare/domain-discovery.js';
+import { DeploymentValidator } from '../../lib/shared/deployment/validator.js';
+import { RollbackManager } from '../../lib/shared/deployment/rollback-manager.js';
+import { DomainDiscovery } from '../../lib/shared/cloudflare/domain-discovery.js';
 import { DatabaseOrchestrator } from '../database/database-orchestrator.js';
 import { EnhancedSecretManager } from '../utils/deployment/secret-generator.js';
-import { ProductionTester } from '../lib/shared/production-tester/index.js';
-import { DeploymentAuditor } from '../lib/shared/deployment/auditor.js';
+import { ProductionTester } from '../../lib/shared/production-tester/index.js';
+import { DeploymentAuditor } from '../../lib/shared/deployment/auditor.js';
 import { ConfigurationCacheManager } from '../utils/deployment/config-cache.js';
 export class CrossDomainCoordinator {
   constructor(options = {}) {