@tamyla/clodo-framework 3.2.2 → 3.2.4

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [3.2.4](https://github.com/tamylaa/clodo-framework/compare/v3.2.3...v3.2.4) (2025-12-06)
+
+
+### Bug Fixes
+
+* expose CLI utilities in public API to fix import issues ([5d995ab](https://github.com/tamylaa/clodo-framework/commit/5d995abb2f6cb718acc0a03beef75f1025204200))
+
+## [3.2.3](https://github.com/tamylaa/clodo-framework/compare/v3.2.2...v3.2.3) (2025-12-06)
+
+
+### Bug Fixes
+
+* clean up debug logging in fix-dist-imports.js ([374318e](https://github.com/tamylaa/clodo-framework/commit/374318efc9b73cf304306f3dd249eb88f8b06c98))
+* resolve all test suite failures for production readiness ([519df7c](https://github.com/tamylaa/clodo-framework/commit/519df7c755bd1a93bb5e9717c2aaf21bdf02e636))
+
 ## [3.2.2](https://github.com/tamylaa/clodo-framework/compare/v3.2.1...v3.2.2) (2025-12-05)
 
 

package/README.md

@@ -748,7 +748,7 @@ npx wrangler --version
 ### **2. Cloudflare Authentication**
 ```bash
 # Login to Cloudflare (first time only)
-npx wrangler auth login
+npx wrangler login
 
 # Or set API token directly (will be prompted automatically)
 # The system will securely store your token with encryption
@@ -1318,7 +1318,7 @@ node bin/deployment/enterprise-deploy.js list
 # Problem: No Cloudflare authentication
 # Solution: The system will automatically prompt for API token
 # Or manually set up wrangler auth:
-npx wrangler auth login
+npx wrangler login
 ```
 
 #### **"D1 database discovery requires additional permissions"**

package/dist/cli/commands/assess.js

@@ -5,9 +5,7 @@
 
 import chalk from 'chalk';
 import path from 'path';
-import { ServiceOrchestrator } from '@tamyla/clodo-framework';
-import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
-import { ServiceConfigManager } from '../../lib/shared/utils/service-config-manager.js';
+import { ServiceOrchestrator, StandardOptions, ServiceConfigManager } from '@tamyla/clodo-framework';
 export function registerAssessCommand(program) {
   const command = program.command('assess [service-path]').description('Run intelligent capability assessment (requires @tamyla/clodo-orchestration)').option('--export <file>', 'Export assessment results to JSON file').option('--domain <domain>', 'Domain name for assessment').option('--service-type <type>', 'Service type for assessment').option('--token <token>', 'Cloudflare API token').option('--show-config-sources', 'Display all configuration sources and merged result');
 

package/dist/cli/commands/create.js

@@ -6,9 +6,7 @@
  */
 
 import chalk from 'chalk';
-import { Clodo } from '@tamyla/clodo-framework';
-import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
-import { ConfigLoader } from '../../lib/shared/utils/config-loader.js';
+import { Clodo, StandardOptions, ConfigLoader } from '@tamyla/clodo-framework';
 export function registerCreateCommand(program) {
   const command = program.command('create').description('Create a new Clodo service with conversational setup').option('-n, --non-interactive', 'Run in non-interactive mode with all required parameters').option('--service-name <name>', 'Service name (required in non-interactive mode)').option('--service-type <type>', 'Service type: data-service, auth-service, content-service, api-gateway, generic', 'generic').option('--domain-name <domain>', 'Domain name (required in non-interactive mode)').option('--cloudflare-token <token>', 'Cloudflare API token (required in non-interactive mode)').option('--cloudflare-account-id <id>', 'Cloudflare account ID (required in non-interactive mode)').option('--cloudflare-zone-id <id>', 'Cloudflare zone ID (required in non-interactive mode)').option('--environment <env>', 'Target environment: development, staging, production', 'development').option('--output-path <path>', 'Output directory for generated service', '.').option('--template-path <path>', 'Path to service templates', './templates').option('--force', 'Skip confirmation prompts').option('--validate', 'Validate service after creation');
 

package/dist/cli/commands/deploy.js

@@ -1,17 +1,14 @@
 import chalk from 'chalk';
-import { Clodo } from '@tamyla/clodo-framework';
-import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
-import { ConfigLoader } from '../../lib/shared/utils/config-loader.js';
-import { InteractiveDeploymentCoordinator } from '../../lib/shared/deployment/workflows/interactive-deployment-coordinator.js';
+import { Clodo, StandardOptions, ConfigLoader, InteractiveDeploymentCoordinator, OutputFormatter } from '@tamyla/clodo-framework';
 export function registerDeployCommand(program) {
   const command = program.command('deploy').description('Deploy a Clodo service with interactive configuration and validation')
   // Cloudflare-specific options
-  .option('--token <token>', 'Cloudflare API token (or set CLOUDFLARE_API_TOKEN env var)').option('--account-id <id>', 'Cloudflare account ID (or set CLOUDFLARE_ACCOUNT_ID env var)').option('--zone-id <id>', 'Cloudflare zone ID (or set CLOUDFLARE_ZONE_ID env var)').option('--domain <domain>', 'Specific domain to deploy to').option('--environment <env>', 'Target environment (development, staging, production)', 'production').option('--development', 'Deploy to development environment (shorthand for --environment development)').option('--staging', 'Deploy to staging environment (shorthand for --environment staging)').option('--production', 'Deploy to production environment (shorthand for --environment production)').option('--dry-run', 'Simulate deployment without making changes').option('-y, --yes', 'Skip confirmation prompts (for CI/CD)').option('--service-path <path>', 'Path to service directory', '.').option('--check-prereqs', 'Check deployment prerequisites before starting').option('--check-auth', 'Check Wrangler authentication status').option('--check-network', 'Check network connectivity to Cloudflare');
+  .option('--token <token>', 'Cloudflare API token (or set CLOUDFLARE_API_TOKEN env var)').option('--account-id <id>', 'Cloudflare account ID (or set CLOUDFLARE_ACCOUNT_ID env var)').option('--zone-id <id>', 'Cloudflare zone ID (or set CLOUDFLARE_ZONE_ID env var)').option('--domain <domain>', 'Specific domain to deploy to').option('--service-name <name>', 'Service name for URL generation (e.g., data-service, auth-service)', 'data-service').option('--environment <env>', 'Target environment (development, staging, production)', 'production').option('--development', 'Deploy to development environment (shorthand for --environment development)').option('--staging', 'Deploy to staging environment (shorthand for --environment staging)').option('--production', 'Deploy to production environment (shorthand for --environment production)').option('--dry-run', 'Simulate deployment without making changes').option('-y, --yes', 'Skip confirmation prompts (for CI/CD)').option('--service-path <path>', 'Path to service directory', '.').option('--check-prereqs', 'Check deployment prerequisites before starting').option('--check-auth', 'Check Wrangler authentication status').option('--check-network', 'Check network connectivity to Cloudflare');
 
   // Add standard options (--verbose, --quiet, --json, --no-color, --config-file)
   StandardOptions.define(command).action(async options => {
     try {
-      const output = new (await import('../../lib/shared/utils/output-formatter.js')).OutputFormatter(options);
+      const output = new OutputFormatter(options);
       const configLoader = new ConfigLoader({
         verbose: options.verbose,
         quiet: options.quiet,
@@ -51,6 +48,7 @@ export function registerDeployCommand(program) {
           servicePath: mergedOptions.servicePath || '.',
           environment: mergedOptions.environment || 'production',
           domain: mergedOptions.domain,
+          serviceName: mergedOptions.serviceName,
           dryRun: mergedOptions.dryRun || false,
           credentials: {
             token: mergedOptions.token,
@@ -80,6 +78,7 @@ export function registerDeployCommand(program) {
           servicePath: mergedOptions.servicePath || '.',
           environment: mergedOptions.environment || 'production',
           domain: mergedOptions.domain,
+          serviceName: mergedOptions.serviceName,
           dryRun: mergedOptions.dryRun || false,
           credentials: {
             token: mergedOptions.token,
@@ -98,7 +97,7 @@ export function registerDeployCommand(program) {
         }
       }
     } catch (error) {
-      const output = new (await import('../../lib/shared/utils/output-formatter.js')).OutputFormatter(options || {});
+      const output = new OutputFormatter(options || {});
       output.error(`Deployment failed: ${error.message}`);
       process.exit(1);
     }

package/dist/cli/commands/diagnose.js

@@ -1,8 +1,6 @@
 import chalk from 'chalk';
 import path from 'path';
-import { ServiceOrchestrator } from '@tamyla/clodo-framework';
-import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
-import { ServiceConfigManager } from '../../lib/shared/utils/service-config-manager.js';
+import { ServiceOrchestrator, StandardOptions, ServiceConfigManager } from '@tamyla/clodo-framework';
 export function registerDiagnoseCommand(program) {
   const command = program.command('diagnose [service-path]').description('Diagnose and report issues with an existing service').option('--deep-scan', 'Perform deep analysis including dependencies and deployment readiness').option('--export-report <file>', 'Export diagnostic report to file').option('--fix-suggestions', 'Include suggested fixes for issues').option('--show-config-sources', 'Display all configuration sources and merged result');
 

package/dist/cli/commands/helpers/deployment-verification.js

@@ -3,7 +3,7 @@
  * Provides UI-specific deployment verification by delegating to shared infrastructure
  */
 
-import { verifyWorkerDeployment, healthCheckWithBackoff, checkHealth } from '../../../lib/shared/monitoring/health-checker.js';
+import { verifyWorkerDeployment, healthCheckWithBackoff, checkHealth } from '@tamyla/clodo-framework';
 import chalk from 'chalk';
 import readline from 'readline';
 

package/dist/cli/commands/helpers/error-recovery.js

@@ -3,7 +3,7 @@
  * Provides interactive error recovery by delegating to shared error classification
  */
 
-import { classifyError, getRecoverySuggestions } from '../../../lib/shared/error-handling/error-classifier.js';
+import { classifyError, getRecoverySuggestions } from '@tamyla/clodo-framework';
 import chalk from 'chalk';
 import readline from 'readline';
 

package/dist/cli/commands/update.js

@@ -4,9 +4,7 @@
 
 import chalk from 'chalk';
 import path from 'path';
-import { ServiceOrchestrator } from '@tamyla/clodo-framework';
-import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
-import { ServiceConfigManager } from '../../lib/shared/utils/service-config-manager.js';
+import { ServiceOrchestrator, StandardOptions, ServiceConfigManager } from '@tamyla/clodo-framework';
 export function registerUpdateCommand(program) {
   const command = program.command('update [service-path]').description('Update an existing service configuration').option('-i, --interactive', 'Run in interactive mode to select what to update').option('--domain-name <domain>', 'Update domain name').option('--cloudflare-token <token>', 'Update Cloudflare API token').option('--cloudflare-account-id <id>', 'Update Cloudflare account ID').option('--cloudflare-zone-id <id>', 'Update Cloudflare zone ID').option('--environment <env>', 'Update target environment: development, staging, production').option('--add-feature <feature>', 'Add a feature flag').option('--remove-feature <feature>', 'Remove a feature flag').option('--regenerate-configs', 'Regenerate all configuration files').option('--fix-errors', 'Attempt to fix common configuration errors').option('--preview', 'Show what would be changed without applying').option('--show-config-sources', 'Display all configuration sources and merged result').option('--force', 'Skip confirmation prompts');
 

package/dist/cli/commands/validate.js

@@ -1,6 +1,5 @@
 import chalk from 'chalk';
-import { Clodo } from '@tamyla/clodo-framework';
-import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
+import { Clodo, StandardOptions } from '@tamyla/clodo-framework';
 export function registerValidateCommand(program) {
   const command = program.command('validate <service-path>').description('Validate an existing service configuration').option('--export-report <file>', 'Export validation report to JSON file');
 

package/dist/config/validation-config.json

@@ -12,7 +12,7 @@
     },
     "cloudflare": {
       "whoami": "npx wrangler whoami",
-      "auth_login": "npx wrangler auth login",
+      "auth_login": "npx wrangler login",
       "deployments_list": "npx wrangler deployments list",
       "list_workers": "npx wrangler dev --help",
       "deploy": "npx wrangler deploy",

package/dist/deployment/index.js

@@ -8,4 +8,7 @@
 export { BaseDeploymentOrchestrator } from './orchestration/BaseDeploymentOrchestrator.js';
 export { SingleServiceOrchestrator } from './orchestration/SingleServiceOrchestrator.js';
 export { PortfolioOrchestrator } from './orchestration/PortfolioOrchestrator.js';
-export { UnifiedDeploymentOrchestrator } from './orchestration/UnifiedDeploymentOrchestrator.js';
+export { UnifiedDeploymentOrchestrator } from './orchestration/UnifiedDeploymentOrchestrator.js';
+
+// Rollback Management
+export { RollbackManager } from './rollback-manager.js';

package/dist/deployment/wrangler-deployer.js

@@ -487,7 +487,7 @@ export class WranglerDeployer {
           valid: false,
           error: 'Wrangler authentication failed',
           details: 'You need to login to Cloudflare',
-          suggestions: ['Run: wrangler auth login', 'Or set CLOUDFLARE_API_TOKEN environment variable']
+          suggestions: ['Run: wrangler login', 'Or set CLOUDFLARE_API_TOKEN environment variable']
         };
       }
 

package/dist/index.js

@@ -37,6 +37,15 @@ export { ServiceCreator } from './service-management/ServiceCreator.js';
 export { ServiceOrchestrator } from './service-management/ServiceOrchestrator.js';
 export { InputCollector } from './service-management/InputCollector.js';
 
+// CLI utilities (for framework CLI commands)
+export { StandardOptions } from '../lib/shared/utils/cli-options.js';
+export { ConfigLoader } from '../lib/shared/utils/config-loader.js';
+export { ServiceConfigManager } from '../lib/shared/utils/service-config-manager.js';
+export { InteractiveDeploymentCoordinator } from '../lib/shared/deployment/workflows/interactive-deployment-coordinator.js';
+export { OutputFormatter } from '../lib/shared/utils/output-formatter.js';
+export { verifyWorkerDeployment, healthCheckWithBackoff, checkHealth } from '../lib/shared/monitoring/health-checker.js';
+export { classifyError, getRecoverySuggestions } from '../lib/shared/error-handling/error-classifier.js';
+
 // Framework version info
 export const FRAMEWORK_VERSION = '1.0.0';
 export const FRAMEWORK_NAME = 'Clodo Framework';

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

@@ -3,7 +3,7 @@
  * Handles environment configuration, domain mapping, deployment mode selection, and cross-domain coordination
  */
 
-import { MultiDomainOrchestrator, CrossDomainCoordinator } from '../../shared/deployment/index.js';
+import { MultiDomainOrchestrator } from '../../shared/deployment/index.js';
 import { DomainDiscovery } from '../../shared/cloudflare/domain-discovery.js';
 import { askChoice, askUser, askYesNo, DeploymentInteractiveUtils } from '../../shared/utils/interactive-utils.js';
 export class EnvironmentManager {
@@ -43,12 +43,9 @@ export class EnvironmentManager {
 
     // Initialize cross-domain coordinator for portfolio mode
     if (this.config.deploymentMode === 'portfolio') {
-      this.coordinator = new CrossDomainCoordinator({
-        portfolioName: this.config.portfolioName || 'interactive-portfolio',
-        enableContinuousMonitoring: true,
-        crossDomainCoordination: this.config.secrets?.crossDomainSharing || false
-      });
-      console.log('   ✅ Cross-domain coordinator initialized');
+      // CrossDomainCoordinator is not available in current build
+      console.log('   ⚠️ Cross-domain coordinator not available in current build');
+      console.log('   ℹ️ Portfolio mode will use basic multi-domain coordination');
     }
 
     // Initialize domain discovery

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

@@ -120,8 +120,8 @@ export async function checkAuth() {
 }
 export async function authenticate() {
   try {
-    // Use wrangler auth login for initial authentication
-    await execAsync('npx wrangler auth login', {
+    // Use wrangler login for authentication (Wrangler 3.x+)
+    await execAsync('npx wrangler login', {
       stdio: 'inherit'
     });
 

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

@@ -58,7 +58,7 @@ export class CommandConfigManager {
       },
       cloudflareCommands: {
         whoami: 'npx wrangler whoami',
-        auth_login: 'npx wrangler auth login',
+        auth_login: 'npx wrangler login',
         deployments_list: 'npx wrangler deployments list',
         list_workers: 'npx wrangler dev --help',
         deploy: 'npx wrangler deploy',

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

@@ -5,7 +5,7 @@
 
 export { DeploymentValidator } from './validator.js';
 export { MultiDomainOrchestrator } from '@tamyla/clodo-framework/orchestration';
-export { CrossDomainCoordinator } from '@tamyla/clodo-framework/orchestration';
+// export { CrossDomainCoordinator } from '@tamyla/clodo-framework/orchestration'; // Not available in src/
 export { DeploymentAuditor } from './auditor.js';
 export { RollbackManager } from './rollback-manager.js';
 export { DeploymentCredentialCollector } from './credential-collector.js';

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

@@ -4,10 +4,10 @@
  */
 
 export { InteractiveDeploymentCoordinator } from './interactive-deployment-coordinator.js';
-export { InteractiveConfirmationWorkflow } from './interactive-confirmation.js';
+export { InteractiveConfirmation as InteractiveConfirmationWorkflow } from './interactive-confirmation.js';
 export { InteractiveDatabaseWorkflow } from './interactive-database-workflow.js';
 export { InteractiveDomainInfoGatherer } from './interactive-domain-info-gatherer.js';
 export { InteractiveSecretWorkflow } from './interactive-secret-workflow.js';
 export { InteractiveTestingWorkflow } from './interactive-testing-workflow.js';
 export { InteractiveValidationWorkflow } from './interactive-validation.js';
-export { DeploymentSummaryWorkflow } from './deployment-summary.js';
+export { DeploymentSummary as DeploymentSummaryWorkflow } from './deployment-summary.js';

package/dist/lib/shared/deployment/workflows/interactive-deployment-coordinator.js

@@ -18,7 +18,7 @@
 import { InteractiveDomainInfoGatherer } from './interactive-domain-info-gatherer.js';
 import { InteractiveDatabaseWorkflow } from './interactive-database-workflow.js';
 import { InteractiveSecretWorkflow } from './interactive-secret-workflow.js';
-import { InteractiveValidation } from './interactive-validation.js';
+import { InteractiveValidationWorkflow } from './interactive-validation.js';
 import { InteractiveConfirmation } from './interactive-confirmation.js';
 import { InteractiveTestingWorkflow } from './interactive-testing-workflow.js';
 import { Clodo } from '@tamyla/clodo-framework';
@@ -35,6 +35,7 @@ export class InteractiveDeploymentCoordinator {
    * @param {string} options.servicePath - Path to service directory
    * @param {string} options.environment - Target environment
    * @param {string} options.domain - Specific domain (optional)
+   * @param {string} options.serviceName - Service name for URL generation
    * @param {boolean} options.dryRun - Dry run mode
    * @param {Object} options.credentials - Cloudflare credentials
    * @param {boolean} options.checkPrereqs - Check prerequisites
@@ -72,7 +73,7 @@ export class InteractiveDeploymentCoordinator {
       secretWorkflow: new InteractiveSecretWorkflow({
         interactive: true
       }),
-      validation: new InteractiveValidation({
+      validation: new InteractiveValidationWorkflow({
         interactive: true
       }),
       confirmation: InteractiveConfirmation,
@@ -206,6 +207,7 @@ export class InteractiveDeploymentCoordinator {
       servicePath: this.deploymentState.config.servicePath,
       environment: this.deploymentState.config.environment,
       domain: this.deploymentState.config.domain,
+      serviceName: this.options.serviceName,
       dryRun: this.deploymentState.config.dryRun,
       credentials: this.deploymentState.config.credentials
     });

package/dist/lib/shared/deployment/workflows/interactive-validation.js

@@ -14,7 +14,7 @@ import { validatePrerequisites, checkAuth, authenticate, workerExists } from '..
  * Interactive Validation Workflow
  * Handles pre-deployment checks and comprehensive validation
  */
-export class InteractiveValidation {
+export class InteractiveValidationWorkflow {
   /**
    * @param {Object} options - Configuration options
    */

package/dist/lib/shared/utils/ErrorHandler.js

@@ -273,9 +273,9 @@ export class ErrorHandler {
       console.error('   - Verify service is running and responding');
     }
     if (errorMsg.includes('authentication')) {
-      suggestions.push('Re-authenticate with Cloudflare: wrangler auth login');
+      suggestions.push('Re-authenticate with Cloudflare: wrangler login');
       suggestions.push('Check API token validity');
-      console.error('   - Re-authenticate with Cloudflare: wrangler auth login');
+      console.error('   - Re-authenticate with Cloudflare: wrangler login');
       console.error('   - Check API token validity');
     }
     if (errorMsg.includes('timeout')) {
@@ -377,7 +377,7 @@ export class ErrorHandler {
       console.error('   - Verify Cloudflare API token has D1 permissions');
       console.error('   - Check if you have access to the specified database');
       console.error('   - Ensure you\'re authenticated to the correct account');
-      console.error('   - Re-authenticate: wrangler auth login');
+      console.error('   - Re-authenticate: wrangler login');
     } else if (errorMessage.includes('migration')) {
       console.error('\n🔄 D1 Migration Error:');
       console.error('   - Check migration files for syntax errors');
@@ -455,7 +455,7 @@ export class ErrorHandler {
       analysis.severity = 'high';
       analysis.autoFixable = false;
       analysis.canRecover = false;
-      analysis.suggestions = ['Re-authenticate with Cloudflare: wrangler auth login', 'Check API token permissions include D1 access', 'Verify correct Cloudflare account is selected'];
+      analysis.suggestions = ['Re-authenticate with Cloudflare: wrangler login', 'Check API token permissions include D1 access', 'Verify correct Cloudflare account is selected'];
     } else if (errorMessage.includes('migration')) {
       analysis.category = 'migration';
       analysis.severity = 'medium';
@@ -475,7 +475,7 @@ export class ErrorHandler {
     const guides = {
       database_not_found: ['1. List available databases: wrangler d1 list', '2. Check if database name in wrangler.toml matches an existing database', '3. If database doesn\'t exist, create it: wrangler d1 create <database-name>', '4. Copy the database ID from the creation output', '5. Update database_id in wrangler.toml [[d1_databases]] section', '6. Retry deployment: npm run deploy'],
       binding_configuration: ['1. Open wrangler.toml and locate [[d1_databases]] section', '2. Verify binding name matches what your code expects (usually "DB")', '3. Check database_name is correct (no typos)', '4. Verify database_id is a valid UUID format', '5. Test configuration: wrangler deploy --dry-run', '6. If issues persist, validate with: wrangler d1 info <database-name>'],
-      authentication: ['1. Log out of current session: wrangler logout', '2. Re-authenticate: wrangler auth login', '3. Verify correct account: wrangler whoami', '4. Check API token permissions if using token authentication', '5. Ensure token has D1:Edit permissions in Cloudflare dashboard', '6. Retry the operation after successful authentication'],
+      authentication: ['1. Log out of current session: wrangler logout', '2. Re-authenticate: wrangler login', '3. Verify correct account: wrangler whoami', '4. Check API token permissions if using token authentication', '5. Ensure token has D1:Edit permissions in Cloudflare dashboard', '6. Retry the operation after successful authentication'],
       migration: ['1. Check migration files in migrations/ directory', '2. Validate SQL syntax in migration files', '3. List current migration status: wrangler d1 migrations list <database>', '4. Apply pending migrations: wrangler d1 migrations apply <database>', '5. If errors occur, check migration file format and naming', '6. Consider rolling back problematic migrations if needed'],
       general: ['1. Check Cloudflare account has D1 enabled and available', '2. Update wrangler to latest version: npm install -g wrangler', '3. Verify wrangler.toml file exists and has correct format', '4. Test authentication: wrangler whoami', '5. List available D1 databases: wrangler d1 list', '6. Check Cloudflare Dashboard for any service issues']
     };
@@ -549,7 +549,7 @@ export class ErrorHandler {
       suggestions.push('Check network connectivity and firewall rules');
     }
     if (errorMessage.includes('auth') || errorMessage.includes('token')) {
-      suggestions.push('Re-authenticate with Cloudflare: wrangler auth login');
+      suggestions.push('Re-authenticate with Cloudflare: wrangler login');
       suggestions.push('Check API token validity and permissions');
     }
     if (errorMessage.includes('timeout')) {

package/dist/orchestration/multi-domain-orchestrator.js

@@ -35,7 +35,7 @@ export class MultiDomainOrchestrator {
     this.skipTests = options.skipTests || false;
     this.parallelDeployments = options.parallelDeployments || 3;
     this.servicePath = options.servicePath || process.cwd();
-    this.serviceName = options.serviceName || 'worker'; // Service name for custom domain
+    this.serviceName = options.serviceName || 'data-service'; // Service name for custom domain (e.g., 'data-service', 'auth-service')
 
     // Wrangler config path - allows using customer-specific wrangler.toml files
     // If not specified, wrangler uses the default wrangler.toml in servicePath
@@ -767,7 +767,8 @@ export class MultiDomainOrchestrator {
    * @param {Object} options - Simple deployment options
    * @param {string} options.servicePath - Path to service directory
    * @param {string} options.environment - Target environment
-   * @param {string} options.domain - Specific domain to deploy to
+   * @param {string} options.domain - Specific domain to deploy to (used as zone name and domain suffix)
+   * @param {string} options.serviceName - Service name for URL generation (e.g., 'data-service', 'auth-service')
    * @param {boolean} options.dryRun - Simulate deployment
    * @param {Object} options.credentials - Cloudflare credentials
    * @returns {Promise<Object>} Deployment result
@@ -777,6 +778,7 @@ export class MultiDomainOrchestrator {
       servicePath = '.',
       environment = 'production',
       domain,
+      serviceName,
       dryRun = false,
       credentials = {}
     } = options;
@@ -786,9 +788,13 @@ export class MultiDomainOrchestrator {
       environment,
       dryRun,
       servicePath,
+      serviceName,
+      // Pass through serviceName if provided
       cloudflareToken: credentials.token,
       cloudflareAccountId: credentials.accountId,
       cloudflareZoneId: credentials.zoneId,
+      cloudflareZoneName: domain,
+      // Use domain as zone name for customer config
       domains: domain ? [domain] : []
     });
     try {

package/dist/utils/deployment/index.js

@@ -5,4 +5,4 @@ export { ConfigurationCacheManager } from './config-cache.js';
 export { EnhancedSecretManager } from './secret-generator.js';
 export { UnifiedConfigManager, unifiedConfigManager } from '../config/unified-config-manager.js';
 export { askUser, askYesNo, askChoice, closePrompts } from '../interactive-prompts.js';
-export { DeploymentCredentialCollector } from '../../lib/shared/deployment/credential-collector.js';
+export { DeploymentCredentialCollector } from '../../../lib/shared/deployment/credential-collector.js';

package/dist/utils/framework-config.js

@@ -24,20 +24,31 @@ export class FrameworkConfig {
 
   /**
    * Find the configuration file in standard locations
+   * 
+   * For a packaged framework, we should only look within the framework's own directory
+   * to maintain self-containment. Users can explicitly pass config paths if needed.
    */
   findConfigFile() {
     let __filename, __dirname;
 
-    // Handle test environment where import.meta might be transformed
+    // Get the framework's directory (works in both source and packaged environments)
     try {
       __filename = fileURLToPath(import.meta.url);
       __dirname = dirname(__filename);
     } catch (error) {
-      // Fallback for test environment
+      // Fallback for environments where import.meta is not available
+      // This should not happen in modern Node.js environments
+      console.warn('⚠️  Unable to determine framework directory, using current directory');
       __dirname = process.cwd();
-      __filename = join(__dirname, 'src', 'utils', 'framework-config.js');
     }
-    const possiblePaths = ['./validation-config.json', '../validation-config.json', '../../validation-config.json', join(process.cwd(), 'validation-config.json'), join(__dirname, '..', '..', 'validation-config.json')];
+
+    // Only look for config files within the framework's package directory
+    // This ensures the framework is self-contained and doesn't depend on user project files
+    const frameworkRoot = join(__dirname, '..', '..');
+    const possiblePaths = [join(frameworkRoot, 'validation-config.json'), join(frameworkRoot, 'config', 'validation-config.json'),
+    // Allow explicit config path via environment variable (for advanced users)
+    process.env.CLODO_FRAMEWORK_CONFIG && join(process.cwd(), process.env.CLODO_FRAMEWORK_CONFIG)].filter(Boolean); // Remove falsy values
+
     for (const path of possiblePaths) {
       if (this.fileManager.exists(path)) {
         return path;
@@ -45,7 +56,7 @@ export class FrameworkConfig {
     }
 
     // Return null instead of throwing - will use default config
-    // Note: This is expected behavior - services don't need their own config
+    // This is expected behavior - services don't need their own config
     return null;
   }
 

package/dist/utils/index.js

@@ -29,6 +29,9 @@ export const createLogger = (prefix = 'ClodoFramework') => {
   };
 };
 
+// Validation utilities
+export * from './validation.js';
+
 // Health checking utilities
 export * from './health-checker.js';
 

package/dist/worker/integration.js

@@ -1,13 +1,13 @@
 import { getDomainFromEnv, createEnvironmentConfig } from '../config/domains.js';
 
-// Export COMMON_FEATURES constant (simplified from ConfigurationManager)
-export const COMMON_FEATURES = ['authentication', 'logging', 'caching', 'rate-limiting', 'monitoring'];
+// Import COMMON_FEATURES from ConfigurationManager
+import { COMMON_FEATURES } from '../../lib/shared/config/ConfigurationManager.js';
 
 // Simple feature manager interface (replaces ConfigurationManager dependency)
 export const configManager = {
   setDomain: () => {},
-  getEnabledFeatures: () => COMMON_FEATURES,
-  isFeatureEnabled: feature => COMMON_FEATURES.includes(feature)
+  getEnabledFeatures: () => Object.values(COMMON_FEATURES),
+  isFeatureEnabled: feature => Object.values(COMMON_FEATURES).includes(feature)
 };
 
 // Legacy featureManager compatibility interface
@@ -50,7 +50,7 @@ export const initializeService = (env, domainConfigs = {}) => {
     const serviceContext = {
       domain: domainConfig.name,
       environment,
-      features: featureManager.getEnabledFeatures(),
+      features: Object.keys(domainConfig.features || {}).filter(feature => domainConfig.features[feature] === true),
       config: envConfig,
       env,
       isProduction: environment === 'production',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tamyla/clodo-framework",
-  "version": "3.2.2",
+  "version": "3.2.4",
   "description": "Reusable framework for Clodo-style software architecture on Cloudflare Workers + D1",
   "type": "module",
   "sideEffects": [