@tamyla/clodo-framework 3.1.27 → 3.2.1

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## [3.2.1](https://github.com/tamylaa/clodo-framework/compare/v3.2.0...v3.2.1) (2025-12-05)
+
+
+### Bug Fixes
+
+* enhance deploy command with prerequisite checking and organize project structure ([660c5ab](https://github.com/tamylaa/clodo-framework/commit/660c5ab82546ca1a80b42c1d4cbc6d3972cc6203))
+
+# [3.2.0](https://github.com/tamylaa/clodo-framework/compare/v3.1.27...v3.2.0) (2025-12-03)
+
+
+### Bug Fixes
+
+* add pre-publish import validation and remove non-existent exports ([a41fa7d](https://github.com/tamylaa/clodo-framework/commit/a41fa7df5c1ce05d34efe7e62e68d1c2fa8ea89c))
+* correct CLI import paths for npm distribution ([ba68e0a](https://github.com/tamylaa/clodo-framework/commit/ba68e0adfa4c3bf36584b8bd37310ef616f79722))
+* enable missing exports and remove lib-dependent modules from npm ([1645a58](https://github.com/tamylaa/clodo-framework/commit/1645a58d1e1f5d7126fd02766e9b4d006fa45be7))
+
+
+### Features
+
+* add comprehensive pre-publish and downstream install tests ([b1e8a25](https://github.com/tamylaa/clodo-framework/commit/b1e8a25b3acae840b66f728aa55dd5c24af0914f))
+* add proper CLI regression tests to downstream install test ([4cde4bc](https://github.com/tamylaa/clodo-framework/commit/4cde4bc08f0290f0432815b2c8cfa60247bc8dfd))
+
 ## [3.1.27](https://github.com/tamylaa/clodo-framework/compare/v3.1.26...v3.1.27) (2025-12-02)
 
 

package/dist/cli/clodo-simple.js

@@ -8,7 +8,7 @@
  */
 import { Command } from 'commander';
 import chalk from 'chalk';
-import { Clodo } from '../src/simple-api.js';
+import { Clodo } from '@tamyla/clodo-framework';
 
 // Create program instance
 const program = new Command();

package/dist/cli/commands/assess.js

@@ -5,7 +5,7 @@
 
 import chalk from 'chalk';
 import path from 'path';
-import { ServiceOrchestrator } from '../../src/service-management/ServiceOrchestrator.js';
+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';
 export function registerAssessCommand(program) {

package/dist/cli/commands/create.js

@@ -6,7 +6,7 @@
  */
 
 import chalk from 'chalk';
-import { Clodo } from '../../src/simple-api.js';
+import { Clodo } from '@tamyla/clodo-framework';
 import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
 import { ConfigLoader } from '../../lib/shared/utils/config-loader.js';
 export function registerCreateCommand(program) {

package/dist/cli/commands/deploy.js

@@ -1,11 +1,12 @@
 import chalk from 'chalk';
-import { Clodo } from '../../src/simple-api.js';
+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';
 export function registerDeployCommand(program) {
-  const command = program.command('deploy').description('Deploy a Clodo service with smart credential handling and domain selection')
+  const command = program.command('deploy').description('Deploy a Clodo service with interactive configuration and validation')
   // Cloudflare-specific options
-  .option('--token <token>', 'Cloudflare API token').option('--account-id <id>', 'Cloudflare account ID').option('--zone-id <id>', 'Cloudflare zone ID').option('--domain <domain>', 'Specific domain to deploy to (otherwise prompted if multiple exist)').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('--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');
 
   // Add standard options (--verbose, --quiet, --json, --no-color, --config-file)
   StandardOptions.define(command).action(async options => {
@@ -38,26 +39,63 @@ export function registerDeployCommand(program) {
       // Merge config file defaults with CLI options (CLI takes precedence)
       const mergedOptions = configLoader.merge(configFileData, options);
 
-      // Use simple API for deployment
-      const result = await Clodo.deploy({
-        servicePath: mergedOptions.servicePath || '.',
-        environment: mergedOptions.environment || 'production',
-        domain: mergedOptions.domain,
-        dryRun: mergedOptions.dryRun || false,
-        credentials: {
-          token: mergedOptions.token,
-          accountId: mergedOptions.accountId,
-          zoneId: mergedOptions.zoneId
-        }
-      });
-      if (result.success) {
-        output.success(result.message);
-        if (result.deployedDomains && result.deployedDomains.length > 0) {
-          output.info(`Deployed to domains: ${result.deployedDomains.join(', ')}`);
+      // Determine if interactive mode should be enabled
+      const interactive = !mergedOptions.nonInteractive && !mergedOptions.yes;
+      if (interactive) {
+        console.log(chalk.cyan('\n🚀 Interactive Clodo Service Deployment'));
+        console.log(chalk.gray('═'.repeat(60)));
+        console.log(chalk.white('Welcome to the interactive deployment wizard!\n'));
+
+        // Use the interactive deployment coordinator
+        const coordinator = new InteractiveDeploymentCoordinator({
+          servicePath: mergedOptions.servicePath || '.',
+          environment: mergedOptions.environment || 'production',
+          domain: mergedOptions.domain,
+          dryRun: mergedOptions.dryRun || false,
+          credentials: {
+            token: mergedOptions.token,
+            accountId: mergedOptions.accountId,
+            zoneId: mergedOptions.zoneId
+          },
+          checkPrereqs: mergedOptions.checkPrereqs,
+          checkAuth: mergedOptions.checkAuth,
+          checkNetwork: mergedOptions.checkNetwork,
+          verbose: mergedOptions.verbose,
+          quiet: mergedOptions.quiet,
+          json: mergedOptions.json
+        });
+        const result = await coordinator.runInteractiveDeployment();
+        if (result.success) {
+          output.success(result.message);
+          if (result.deployedDomains && result.deployedDomains.length > 0) {
+            output.info(`Deployed to domains: ${result.deployedDomains.join(', ')}`);
+          }
+        } else {
+          output.error('Interactive deployment failed');
+          process.exit(1);
         }
       } else {
-        output.error('Deployment failed');
-        process.exit(1);
+        // Use simple API for deployment (non-interactive/CI mode)
+        const result = await Clodo.deploy({
+          servicePath: mergedOptions.servicePath || '.',
+          environment: mergedOptions.environment || 'production',
+          domain: mergedOptions.domain,
+          dryRun: mergedOptions.dryRun || false,
+          credentials: {
+            token: mergedOptions.token,
+            accountId: mergedOptions.accountId,
+            zoneId: mergedOptions.zoneId
+          }
+        });
+        if (result.success) {
+          output.success(result.message);
+          if (result.deployedDomains && result.deployedDomains.length > 0) {
+            output.info(`Deployed to domains: ${result.deployedDomains.join(', ')}`);
+          }
+        } else {
+          output.error('Deployment failed');
+          process.exit(1);
+        }
       }
     } catch (error) {
       const output = new (await import('../../lib/shared/utils/output-formatter.js')).OutputFormatter(options || {});

package/dist/cli/commands/diagnose.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import path from 'path';
-import { ServiceOrchestrator } from '../../src/service-management/ServiceOrchestrator.js';
+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';
 export function registerDiagnoseCommand(program) {

package/dist/cli/commands/update.js

@@ -4,7 +4,7 @@
 
 import chalk from 'chalk';
 import path from 'path';
-import { ServiceOrchestrator } from '../../src/service-management/ServiceOrchestrator.js';
+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';
 export function registerUpdateCommand(program) {

package/dist/cli/commands/validate.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { Clodo } from '../../src/simple-api.js';
+import { Clodo } from '@tamyla/clodo-framework';
 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('--export-report <file>', 'Export validation report to JSON file');

package/dist/cli/security-cli.js

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

package/dist/config/.env.staging.example

@@ -0,0 +1,25 @@
+# Staging Environment Configuration
+# Copy this file to .env.staging and fill in your actual Cloudflare credentials
+# DO NOT commit this file to version control
+
+# Cloudflare API Credentials for Staging Environment
+CLOUDFLARE_API_TOKEN=your_staging_cloudflare_api_token_here
+CLOUDFLARE_ACCOUNT_ID=your_staging_cloudflare_account_id_here
+CLOUDFLARE_ZONE_ID=your_staging_cloudflare_zone_id_here
+
+# Staging Domain Configuration
+STAGING_DOMAIN=staging.example.com
+STAGING_ZONE_ID=${CLOUDFLARE_ZONE_ID}
+
+# Database Configuration (if different from development)
+STAGING_DATABASE_ID=your_staging_database_id_here
+STAGING_DATABASE_NAME=api2-com-staging-db
+
+# Monitoring and Alerting
+STAGING_METRICS_ENDPOINT=https://metrics-staging.example.com
+STAGING_ALERT_EMAIL=staging-alerts@example.com
+
+# Security Settings
+STAGING_WAF_ENABLED=true
+STAGING_RATE_LIMIT=500
+STAGING_CORS_ORIGINS=https://staging.example.com,https://app-staging.example.com

package/dist/deployment/index.js

@@ -1,11 +1,11 @@
 // Deployment Module
 // Core deployment components for the Clodo Framework
 
-export { WranglerDeployer } from './wrangler-deployer.js';
+// NOTE: WranglerDeployer has lib/ dependencies not available in npm distribution
+// export { WranglerDeployer } from './wrangler-deployer.js';
 
 // Orchestration Framework - Public API for downstream consumers
 export { BaseDeploymentOrchestrator } from './orchestration/BaseDeploymentOrchestrator.js';
 export { SingleServiceOrchestrator } from './orchestration/SingleServiceOrchestrator.js';
 export { PortfolioOrchestrator } from './orchestration/PortfolioOrchestrator.js';
-export { EnterpriseOrchestrator } from './orchestration/EnterpriseOrchestrator.js';
 export { UnifiedDeploymentOrchestrator } from './orchestration/UnifiedDeploymentOrchestrator.js';

package/dist/deployment/orchestration/BaseDeploymentOrchestrator.js

@@ -19,7 +19,7 @@
  * @abstract
  */
 
-import { ErrorHandler } from '../../shared/utils/ErrorHandler.js';
+import { ErrorHandler } from '../../../lib/shared/utils/ErrorHandler.js';
 
 /**
  * Phase state and execution order

package/dist/deployment/orchestration/UnifiedDeploymentOrchestrator.js

@@ -36,8 +36,7 @@
 import { BaseDeploymentOrchestrator } from './BaseDeploymentOrchestrator.js';
 import { SingleServiceOrchestrator } from './SingleServiceOrchestrator.js';
 import { PortfolioOrchestrator } from './PortfolioOrchestrator.js';
-import { EnterpriseOrchestrator } from './EnterpriseOrchestrator.js';
-import { ErrorHandler } from '../../shared/utils/ErrorHandler.js';
+import { ErrorHandler } from '../../../lib/shared/utils/ErrorHandler.js';
 
 /**
  * Capability descriptors - Defines what each capability provides
@@ -204,8 +203,7 @@ export class UnifiedDeploymentOrchestrator extends BaseDeploymentOrchestrator {
     // System adapters for backward compatibility
     this.systemAdapters = {
       single: SingleServiceOrchestrator,
-      portfolio: PortfolioOrchestrator,
-      enterprise: EnterpriseOrchestrator
+      portfolio: PortfolioOrchestrator
     };
 
     // Deployment context

package/dist/index.js

@@ -21,22 +21,21 @@ export * from './modules/ModuleManager.js';
 export * from './routing/EnhancedRouter.js';
 export * from './handlers/GenericRouteHandler.js';
 
-// Deployment components (build-time only)
-// NOTE: Temporarily disabled - has lib/ dependencies that don't exist in npm distribution
+// Deployment components
+export { DeploymentValidator } from './deployment/validator.js';
+export { DeploymentAuditor } from './deployment/auditor.js';
+// NOTE: WranglerDeployer has lib/ dependencies not available in npm distribution
 // export { WranglerDeployer } from './deployment/wrangler-deployer.js';
 
 // Security components
-// NOTE: Temporarily disabled - has lib/ dependencies
-// export * from './security/index.js';
+export { SecurityCLI } from './security/SecurityCLI.js';
+export { ConfigurationValidator } from './security/ConfigurationValidator.js';
+export { SecretGenerator } from './security/SecretGenerator.js';
 
-// Service management components (build-time only - has lib dependencies)
-// NOTE: Temporarily disabled - ServiceCreator imports from lib/
-// 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';
-// export { GenerationHandler } from './service-management/handlers/GenerationHandler.js';
-// export { ValidationHandler } from './service-management/handlers/ValidationHandler.js';
+// Service management components
+export { ServiceCreator } from './service-management/ServiceCreator.js';
+export { ServiceOrchestrator } from './service-management/ServiceOrchestrator.js';
+export { InputCollector } from './service-management/InputCollector.js';
 
 // Framework version info
 export const FRAMEWORK_VERSION = '1.0.0';

package/dist/lib/deployment/orchestration/BaseDeploymentOrchestrator.js

@@ -19,7 +19,7 @@
  * @abstract
  */
 
-import { ErrorHandler } from '../../shared/utils/ErrorHandler.js';
+import { ErrorHandler } from '../../../shared/utils/ErrorHandler.js';
 
 /**
  * Phase state and execution order

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

@@ -242,7 +242,7 @@ export async function listDatabases(options = {}) {
   if (apiToken && accountId) {
     const {
       CloudflareAPI
-    } = await import('../../../src/utils/cloudflare/api.js');
+    } = await import('@tamyla/clodo-framework/utils/cloudflare');
     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('../../../src/utils/cloudflare/api.js');
+    } = await import('@tamyla/clodo-framework/utils/cloudflare');
     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('../../../src/utils/cloudflare/api.js');
+    } = await import('@tamyla/clodo-framework/utils/cloudflare');
     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('../../../src/utils/cloudflare/api.js');
+    } = await import('@tamyla/clodo-framework/utils/cloudflare');
     const cf = new CloudflareAPI(apiToken);
     const db = await cf.getD1Database(accountId, databaseName);
     return db?.uuid || null;
@@ -430,33 +430,119 @@ export async function getDatabaseId(databaseName, options = {}) {
 }
 
 // Validate prerequisites
-export async function validatePrerequisites() {
+export async function validatePrerequisites(options = {}) {
+  const {
+    checkAuth = false,
+    checkNetwork = false,
+    verbose = false
+  } = options;
   const checks = [{
     name: 'Node.js',
-    command: 'node --version'
+    command: 'node --version',
+    required: true,
+    description: 'Required for running the framework and build processes',
+    minVersion: '18.0.0'
   }, {
     name: 'NPM',
-    command: 'npm --version'
+    command: 'npm --version',
+    required: true,
+    description: 'Required for package management and scripts',
+    minVersion: '8.0.0'
   }, {
     name: 'Wrangler',
-    command: 'npx wrangler --version'
+    command: 'npx wrangler --version',
+    required: true,
+    description: 'Cloudflare CLI for Workers and D1 database management',
+    minVersion: '3.0.0'
   }];
+
+  // Add optional checks
+  if (checkAuth) {
+    checks.push({
+      name: 'Wrangler Auth',
+      command: 'npx wrangler whoami',
+      required: false,
+      description: 'Cloudflare authentication (optional - can authenticate during deployment)',
+      async: true
+    });
+  }
+  if (checkNetwork) {
+    checks.push({
+      name: 'Network',
+      command: null,
+      required: false,
+      description: 'Internet connectivity to Cloudflare API',
+      async: true,
+      checkFunction: async () => {
+        try {
+          const response = await fetch('https://api.cloudflare.com/client/v4/user/tokens/verify', {
+            method: 'GET',
+            headers: {
+              'Authorization': 'Bearer test'
+            },
+            signal: AbortSignal.timeout(5000)
+          });
+          return {
+            status: 'ok',
+            version: 'Connected'
+          };
+        } catch (error) {
+          if (error.name === 'AbortError') {
+            return {
+              status: 'failed',
+              error: 'Connection timeout'
+            };
+          }
+          return {
+            status: 'ok',
+            version: 'Connected (API responded)'
+          };
+        }
+      }
+    });
+  }
   const results = [];
   for (const check of checks) {
     try {
-      const {
-        stdout: version
-      } = await execAsync(check.command, {
-        encoding: 'utf8'
-      });
+      let result;
+      if (check.async && check.checkFunction) {
+        result = await check.checkFunction();
+      } else if (check.command) {
+        const {
+          stdout: version
+        } = await execAsync(check.command, {
+          encoding: 'utf8',
+          timeout: 10000
+        });
+        result = {
+          status: 'ok',
+          version: version.trim()
+        };
+
+        // Version checking for critical components
+        if (check.minVersion && check.name === 'Node.js') {
+          const versionNum = version.trim().replace('v', '');
+          if (versionNum < check.minVersion) {
+            result = {
+              status: 'warning',
+              version: version.trim(),
+              warning: `Node.js ${check.minVersion}+ recommended, found ${versionNum}`
+            };
+          }
+        }
+      } else {
+        result = {
+          status: 'skipped',
+          version: 'N/A'
+        };
+      }
       results.push({
-        name: check.name,
-        status: 'ok',
-        version: version.trim()
+        ...check,
+        ...result
       });
     } catch (error) {
       results.push({
-        name: check.name,
+        ...check,
         status: 'failed',
         error: error.message
       });

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

@@ -11,7 +11,8 @@
 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 '../../../src/utils/cloudflare/api.js';
+import { CloudflareAPI } from '@tamyla/clodo-framework/utils/cloudflare';
+import { validatePrerequisites } from '../cloudflare/ops.js';
 export class DeploymentCredentialCollector {
   constructor(options = {}) {
     this.servicePath = options.servicePath || '.';
@@ -29,6 +30,10 @@ export class DeploymentCredentialCollector {
    * 4. Return complete credential set
    */
   async collectCredentials(options = {}) {
+    // First, check prerequisites
+    if (!this.quiet) {
+      await this.displayPrerequisites(options);
+    }
     const startCredentials = {
       token: options.token || process.env.CLOUDFLARE_API_TOKEN || null,
       accountId: options.accountId || process.env.CLOUDFLARE_ACCOUNT_ID || null,
@@ -36,6 +41,11 @@ export class DeploymentCredentialCollector {
       zoneName: null // Will be populated when fetching zone
     };
 
+    // Show credential status if not quiet
+    if (!this.quiet) {
+      this.displayCredentialStatus(startCredentials, options);
+    }
+
     // All credentials provided - quick path
     if (startCredentials.token && startCredentials.accountId && startCredentials.zoneId) {
       if (!this.quiet) {
@@ -247,5 +257,128 @@ export class DeploymentCredentialCollector {
   cleanup() {
     closePrompts();
   }
+
+  /**
+   * Display prerequisite check results
+   * @param {Object} options - Options for prerequisite checking
+   */
+  async displayPrerequisites(options = {}) {
+    console.log(chalk.cyan('\n🔧 Deployment Prerequisites\n'));
+    try {
+      const results = await validatePrerequisites({
+        checkAuth: options.checkAuth || false,
+        checkNetwork: options.checkNetwork || false,
+        verbose: !this.quiet
+      });
+      let allOk = true;
+      let hasWarnings = false;
+      results.forEach(result => {
+        const icon = result.status === 'ok' ? '✅' : result.status === 'warning' ? '⚠️' : result.status === 'failed' ? '❌' : '⏭️';
+        const color = result.status === 'ok' ? chalk.green : result.status === 'warning' ? chalk.yellow : result.status === 'failed' ? chalk.red : chalk.gray;
+        console.log(`${icon} ${color(result.name)}: ${result.version || 'N/A'}`);
+        if (result.description) {
+          console.log(`   ${chalk.gray(result.description)}`);
+        }
+        if (result.warning) {
+          console.log(`   ${chalk.yellow('⚠️  ' + result.warning)}`);
+          hasWarnings = true;
+        }
+        if (result.error) {
+          console.log(`   ${chalk.red('❌ ' + result.error)}`);
+          allOk = false;
+        }
+        if (result.status === 'failed' && result.required) {
+          console.log(`   ${chalk.red('💡 Required for deployment - please install/update ' + result.name.toLowerCase())}`);
+        }
+      });
+      console.log('');
+
+      // Summary
+      if (allOk && !hasWarnings) {
+        console.log(chalk.green('🎉 All prerequisites met - ready for deployment!\n'));
+      } else if (allOk && hasWarnings) {
+        console.log(chalk.yellow('⚠️  Prerequisites OK but with warnings - deployment may proceed\n'));
+      } else {
+        console.log(chalk.red('❌ Some required prerequisites are missing - please resolve before deploying\n'));
+      }
+    } catch (error) {
+      console.log(chalk.yellow(`⚠️  Could not check prerequisites: ${error.message}\n`));
+    }
+  }
+
+  /**
+   * Display credential status showing what's available vs missing
+   * @param {Object} credentials - Current credential state
+   * @param {Object} options - CLI options
+   */
+  displayCredentialStatus(credentials, options) {
+    console.log(chalk.cyan('\n🔍 Credential Status\n'));
+    const status = {
+      token: {
+        available: !!credentials.token,
+        source: this.getCredentialSource('token', credentials.token, options.token),
+        required: true
+      },
+      accountId: {
+        available: !!credentials.accountId,
+        source: this.getCredentialSource('accountId', credentials.accountId, options.accountId),
+        required: false
+      },
+      zoneId: {
+        available: !!credentials.zoneId,
+        source: this.getCredentialSource('zoneId', credentials.zoneId, options.zoneId),
+        required: false
+      }
+    };
+
+    // Display each credential
+    Object.entries(status).forEach(([key, info]) => {
+      const icon = info.available ? '✅' : '❌';
+      const color = info.available ? chalk.green : chalk.red;
+      const label = key === 'token' ? 'API Token' : key === 'accountId' ? 'Account ID' : 'Zone ID';
+      const envVar = key === 'token' ? 'CLOUDFLARE_API_TOKEN' : key === 'accountId' ? 'CLOUDFLARE_ACCOUNT_ID' : 'CLOUDFLARE_ZONE_ID';
+      console.log(`${icon} ${color(label)}: ${info.available ? info.source : 'Missing'}`);
+      if (!info.available) {
+        console.log(`   ${chalk.gray(`Set via --${key.replace('Id', '-id')} flag or ${envVar} environment variable`)}`);
+        console.log(`   ${chalk.gray('To set environment variable:')}`);
+        console.log(`   ${chalk.gray(`  Windows PowerShell: $env:${envVar}="your-value-here"`)}`);
+        console.log(`   ${chalk.gray(`  Windows CMD: set ${envVar}=your-value-here`)}`);
+        console.log(`   ${chalk.gray(`  Linux/macOS: export ${envVar}="your-value-here"`)}`);
+        console.log(`   ${chalk.gray(`  Or add to .env file: ${envVar}=your-value-here`)}`);
+        console.log('');
+      }
+    });
+    console.log('');
+
+    // Summary
+    const availableCount = Object.values(status).filter(s => s.available).length;
+    const totalCount = Object.keys(status).length;
+    if (availableCount === totalCount) {
+      console.log(chalk.green('🎉 All credentials available - ready for deployment!\n'));
+    } else if (availableCount >= 1) {
+      console.log(chalk.yellow(`⚠️  ${availableCount}/${totalCount} credentials available. Missing credentials will be fetched interactively.\n`));
+    } else {
+      console.log(chalk.red('❌ No credentials found. Interactive collection required.\n'));
+    }
+  }
+
+  /**
+   * Get the source of a credential (flag, env var, or none)
+   * @param {string} key - Credential key
+   * @param {*} value - Credential value
+   * @param {*} flagValue - CLI flag value
+   * @returns {string} Source description
+   */
+  getCredentialSource(key, value, flagValue) {
+    if (!value) return 'Not set';
+
+    // Check if it came from CLI flag
+    if (flagValue) return 'CLI flag';
+
+    // Check if it came from environment variable
+    const envVar = key === 'token' ? 'CLOUDFLARE_API_TOKEN' : key === 'accountId' ? 'CLOUDFLARE_ACCOUNT_ID' : 'CLOUDFLARE_ZONE_ID';
+    if (process.env[envVar]) return 'Environment variable';
+    return 'Unknown source';
+  }
 }
 export default DeploymentCredentialCollector;