@tamyla/clodo-framework 4.6.1 → 4.6.3

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## [4.6.3](https://github.com/tamylaa/clodo-framework/compare/v4.6.2...v4.6.3) (2026-02-18)
+
+
+### Bug Fixes
+
+* **cli:** ensure doctor loads ValidationHandler at runtime and sync FRAMEWORK_VERSION ([3d86378](https://github.com/tamylaa/clodo-framework/commit/3d8637807c6fb618a4441f8d36bfef87c887a93a))
+* **cli:** lazy-load ValidationHandler in doctor command action ([99994ed](https://github.com/tamylaa/clodo-framework/commit/99994ed270babc49424aa3b37fc94943d4247ab3))
+* **cli:** runtime-load src-only handlers (ValidationHandler, ConfigSchemaValidator, SecretsManager) so commands register from both src and dist ([50c0120](https://github.com/tamylaa/clodo-framework/commit/50c012081f5582411de739f1053a568c01cf83fd))
+
+## [4.6.2](https://github.com/tamylaa/clodo-framework/compare/v4.6.1...v4.6.2) (2026-02-18)
+
+
+### Bug Fixes
+
+* **cli:** make Doctor command load ValidationHandler at runtime (works from src & dist); test: add regression test for doctor in dist CLI ([fd7437d](https://github.com/tamylaa/clodo-framework/commit/fd7437d1a3df227ff8a35089d90f2ef82d99714a))
+
 ## [4.6.1](https://github.com/tamylaa/clodo-framework/compare/v4.6.0...v4.6.1) (2026-02-18)
 
 

package/dist/cli/commands/config-schema.js

@@ -10,13 +10,23 @@
 
 import chalk from 'chalk';
 import { readFileSync } from 'fs';
-import { ConfigSchemaValidator } from '../../src/validation/ConfigSchemaValidator.js';
+
+// Load ConfigSchemaValidator lazily so this module can be imported both
+// from source (cli/) and from the compiled distribution (dist/cli/).
+async function loadConfigSchemaValidator() {
+  try {
+    return (await import('../../src/validation/ConfigSchemaValidator.js')).ConfigSchemaValidator;
+  } catch (err) {
+    return (await import('../../validation/ConfigSchemaValidator.js')).ConfigSchemaValidator;
+  }
+}
 export function registerConfigSchemaCommand(program) {
   const cmd = program.command('config-schema').description('Inspect and validate configuration file schemas');
 
   // ─── show ──────────────────────────────────────────────────────────────
-  cmd.command('show <type>').description('Show the schema definition for a config type (create, deploy, validate, update)').option('--json', 'Output as JSON').action((type, options) => {
-    const validator = new ConfigSchemaValidator();
+  cmd.command('show <type>').description('Show the schema definition for a config type (create, deploy, validate, update)').option('--json', 'Output as JSON').action(async (type, options) => {
+    const ValidatorClass = await loadConfigSchemaValidator();
+    const validator = new ValidatorClass();
     const definition = validator.getSchemaDefinition(type);
     if (!definition) {
       console.error(chalk.red(`Unknown config type: '${type}'`));
@@ -52,8 +62,9 @@ export function registerConfigSchemaCommand(program) {
   });
 
   // ─── validate ──────────────────────────────────────────────────────────
-  cmd.command('validate <file>').description('Validate a config file against its schema').option('--type <type>', 'Config type (auto-detected if not specified)').option('--strict', 'Exit with error code on validation failures').option('--json', 'Output as JSON').action((file, options) => {
-    const validator = new ConfigSchemaValidator();
+  cmd.command('validate <file>').description('Validate a config file against its schema').option('--type <type>', 'Config type (auto-detected if not specified)').option('--strict', 'Exit with error code on validation failures').option('--json', 'Output as JSON').action(async (file, options) => {
+    const ValidatorClass = await loadConfigSchemaValidator();
+    const validator = new ValidatorClass();
 
     // Determine command type
     let commandType = options.type;
@@ -119,8 +130,9 @@ export function registerConfigSchemaCommand(program) {
   });
 
   // ─── types ─────────────────────────────────────────────────────────────
-  cmd.command('types').description('List all available config types').option('--json', 'Output as JSON').action(options => {
-    const validator = new ConfigSchemaValidator();
+  cmd.command('types').description('List all available config types').option('--json', 'Output as JSON').action(async options => {
+    const ValidatorClass = await loadConfigSchemaValidator();
+    const validator = new ValidatorClass();
     const types = validator.getRegisteredTypes();
     if (options.json) {
       const details = {};

package/dist/cli/commands/create.js

@@ -8,7 +8,13 @@
 import chalk from 'chalk';
 import { Clodo, ConfigLoader } from '@tamyla/clodo-framework';
 import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
-import { ConfigSchemaValidator } from '../../src/validation/ConfigSchemaValidator.js';
+async function loadConfigSchemaValidator() {
+  try {
+    return (await import('../../src/validation/ConfigSchemaValidator.js')).ConfigSchemaValidator;
+  } catch (err) {
+    return (await import('../../validation/ConfigSchemaValidator.js')).ConfigSchemaValidator;
+  }
+}
 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('--middleware-strategy <strategy>', 'Middleware generation strategy: contract|legacy', 'contract').option('--force', 'Skip confirmation prompts').option('--validate', 'Validate service after creation');
 
@@ -27,7 +33,8 @@ export function registerCreateCommand(program) {
       if (options.configFile) {
         configFileData = configLoader.loadSafe(options.configFile, {});
         // Validate against create schema
-        const schemaValidator = new ConfigSchemaValidator({
+        const ValidatorClass = await loadConfigSchemaValidator();
+        const schemaValidator = new ValidatorClass({
           verbose: options.verbose
         });
         const validation = schemaValidator.validateConfig(configFileData, 'create');

package/dist/cli/commands/deploy.js

@@ -1,7 +1,13 @@
 import chalk from 'chalk';
 import { Clodo, ConfigLoader, InteractiveDeploymentCoordinator, OutputFormatter } from '@tamyla/clodo-framework';
 import { StandardOptions } from '../../lib/shared/utils/cli-options.js';
-import { ConfigSchemaValidator } from '../../src/validation/ConfigSchemaValidator.js';
+async function loadConfigSchemaValidator() {
+  try {
+    return (await import('../../src/validation/ConfigSchemaValidator.js')).ConfigSchemaValidator;
+  } catch (err) {
+    return (await import('../../validation/ConfigSchemaValidator.js')).ConfigSchemaValidator;
+  }
+}
 export function registerDeployCommand(program) {
   const command = program.command('deploy').description('Deploy a Clodo service with interactive configuration and validation')
   // Cloudflare-specific options
@@ -31,7 +37,8 @@ export function registerDeployCommand(program) {
       if (options.configFile) {
         configFileData = configLoader.loadSafe(options.configFile, {});
         // Validate against deploy schema
-        const schemaValidator = new ConfigSchemaValidator({
+        const ValidatorClass = await loadConfigSchemaValidator();
+        const schemaValidator = new ValidatorClass({
           verbose: options.verbose
         });
         const validation = schemaValidator.validateConfig(configFileData, 'deploy');

package/dist/cli/commands/doctor.js

@@ -3,12 +3,30 @@
  * Provides preflight diagnostic checks for Clodo services
  */
 
-import { ValidationHandler } from '../../src/service-management/handlers/ValidationHandler.js';
 import chalk from 'chalk';
+
+// ValidationHandler is loaded at runtime so the same command module works
+// both when running from source (imports from `src/...`) and from the
+// compiled distribution (imports from `dist/...`). We attempt the source
+// import first, then fall back to the dist path.
+async function loadValidationHandler() {
+  try {
+    return (await import('../../src/service-management/handlers/ValidationHandler.js')).ValidationHandler;
+  } catch (errSource) {
+    // running from dist/ (compiled package)
+    try {
+      return (await import('../../service-management/handlers/ValidationHandler.js')).ValidationHandler;
+    } catch (errDist) {
+      // last-resort: try explicit dist path (useful in some CI/dev layouts)
+      return (await import('../../dist/service-management/handlers/ValidationHandler.js')).ValidationHandler;
+    }
+  }
+}
 export function registerDoctorCommand(program) {
   program.command('doctor').description('Run preflight diagnostic checks for service health and deployment readiness').option('--json', 'Output results in JSON format for machine consumption').option('--fix', 'Attempt to automatically fix detected issues').option('--strict', 'Treat warnings as errors (non-zero exit code)').option('--service-path <path>', 'Path to service directory (defaults to current directory)').action(async options => {
     try {
-      const handler = new ValidationHandler({
+      const ValidationHandlerClass = await loadValidationHandler();
+      const handler = new ValidationHandlerClass({
         strict: options.strict
       });
       const results = await handler.runDoctor({

package/dist/cli/commands/secrets.js

@@ -8,8 +8,16 @@
  *   clodo-service secrets baseline   Show/update the secrets baseline
  */
 
-import { SecretsManager } from '../../src/security/SecretsManager.js';
 import chalk from 'chalk';
+
+// Lazy-load SecretsManager so this command module imports successfully from dist/
+async function loadSecretsManager() {
+  try {
+    return (await import('../../src/security/SecretsManager.js')).SecretsManager;
+  } catch (err) {
+    return (await import('../../security/SecretsManager.js')).SecretsManager;
+  }
+}
 export function registerSecretsCommand(program) {
   const secrets = program.command('secrets').description('Secret scanning and baseline management for leak prevention');
 
@@ -17,7 +25,8 @@ export function registerSecretsCommand(program) {
 
   secrets.command('scan').description('Scan for potential secrets in the service directory').option('--json', 'Output results in JSON format').option('--include-tests', 'Include test/example/placeholder values in results').option('--service-path <path>', 'Path to service directory (defaults to current directory)').option('--severity <level>', 'Minimum severity to report: critical, high, medium', 'medium').action(async options => {
     try {
-      const mgr = new SecretsManager({
+      const SecretsManagerClass = await loadSecretsManager();
+      const mgr = new SecretsManagerClass({
         includeTests: options.includeTests
       });
       const servicePath = options.servicePath || process.cwd();
@@ -50,7 +59,8 @@ export function registerSecretsCommand(program) {
 
   secrets.command('validate').description('Validate secrets against the baseline — fails if new secrets are found').option('--json', 'Output results in JSON format').option('--strict', 'Exit with non-zero code on any findings (even baselined)').option('--service-path <path>', 'Path to service directory (defaults to current directory)').action(async options => {
     try {
-      const mgr = new SecretsManager();
+      const SecretsManagerClass = await loadSecretsManager();
+      const mgr = new SecretsManagerClass();
       const servicePath = options.servicePath || process.cwd();
       const result = await mgr.validate(servicePath);
       if (options.json) {
@@ -77,7 +87,8 @@ export function registerSecretsCommand(program) {
 
   baseline.command('show').description('Display current baseline entries').option('--json', 'Output results in JSON format').option('--service-path <path>', 'Path to service directory (defaults to current directory)').action(async options => {
     try {
-      const mgr = new SecretsManager();
+      const SecretsManagerClass = await loadSecretsManager();
+      const mgr = new SecretsManagerClass();
       const servicePath = options.servicePath || process.cwd();
       const entries = await mgr.baselineShow(servicePath);
       if (options.json) {
@@ -95,7 +106,8 @@ export function registerSecretsCommand(program) {
 
   baseline.command('update').description('Update baseline with current scan findings').option('--json', 'Output results in JSON format').option('--add-all', 'Add all new findings to the baseline').option('--prune', 'Remove stale entries no longer detected').option('--reason <reason>', 'Reason for updating (audit trail)').option('--service-path <path>', 'Path to service directory (defaults to current directory)').action(async options => {
     try {
-      const mgr = new SecretsManager();
+      const SecretsManagerClass = await loadSecretsManager();
+      const mgr = new SecretsManagerClass();
       const servicePath = options.servicePath || process.cwd();
       const result = await mgr.baselineUpdate(servicePath, {
         addAll: options.addAll,
@@ -115,8 +127,9 @@ export function registerSecretsCommand(program) {
 
   // ─── secrets patterns ──────────────────────────────────────
 
-  secrets.command('patterns').description('List configured detection patterns and their severity').option('--json', 'Output results in JSON format').action(options => {
-    const mgr = new SecretsManager();
+  secrets.command('patterns').description('List configured detection patterns and their severity').option('--json', 'Output results in JSON format').action(async options => {
+    const SecretsManagerClass = await loadSecretsManager();
+    const mgr = new SecretsManagerClass();
     const patterns = mgr.getPatterns();
     if (options.json) {
       console.log(JSON.stringify(patterns, null, 2));

package/dist/index.js

@@ -77,7 +77,7 @@ export { classifyError, getRecoverySuggestions } from './lib/shared/error-handli
 export { FrameworkInfo } from './version/FrameworkInfo.js';
 export { TemplateRuntime } from './utils/TemplateRuntime.js';
 export { HealthChecker } from './monitoring/HealthChecker.js';
-export const FRAMEWORK_VERSION = '4.5.1';
+export const FRAMEWORK_VERSION = '4.6.1';
 export const FRAMEWORK_NAME = 'Clodo Framework';
 
 // ─── Compatibility Constants (for consistent wrangler.toml generation) ──

package/package.json

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

package/templates/edge-proxy/src/index.js

@@ -37,13 +37,13 @@ const middleware = composeMiddleware(
 const routeMap = {
   // Rewrite /api/* to upstream service
   '/api/': {
-    upstream: 'https://api.example.com',
+    upstream: 'https://upstream.local',
     stripPrefix: '/api',
     headers: { 'X-Forwarded-By': 'clodo-proxy' }
   },
   // Serve static assets from R2/another origin
   '/assets/': {
-    upstream: 'https://cdn.example.com',
+    upstream: 'https://cdn.local',
     stripPrefix: '',
     cache: { ttl: 86400 } // Cache for 24h
   }