@tamyla/clodo-framework 2.0.0 → 2.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tamyla/clodo-framework",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Reusable framework for Clodo-style software architecture on Cloudflare Workers + D1",
   "type": "module",
   "sideEffects": [
@@ -56,11 +56,9 @@
     "bin/service-management",
     "bin/security",
     "docs/README.md",
-    "docs/FRAMEWORK-ARCHITECTURE-OVERVIEW.md",
-    "docs/INTEGRATION_GUIDE.md",
     "docs/overview.md",
     "docs/SECURITY.md",
-    "docs/deployment/deployment-guide.md",
+    "docs/api-reference.md",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"

package/docs/FRAMEWORK-ARCHITECTURE-OVERVIEW.md

@@ -1,206 +0,0 @@
-# CLODO Framework Architecture Overview
-
-## Framework Philosophy
-
-The CLODO Framework implements a sophisticated **component-based architecture** where reusable "Clodo bricks" can be snapped together to build complex enterprise applications. Each component handles one concern perfectly, enabling rapid development of autonomous, domain-specific services.
-
-## Core Architecture
-
-### Three-Layer Design
-
-#### 🎯 **Framework Core (Published Package)**
-The main library that downstream applications import and use:
-
-```javascript
-import {
-  GenericDataService,
-  SchemaManager,
-  CrossDomainCoordinator,
-  ConfigurationCacheManager
-} from '@tamyla/clodo-framework';
-```
-
-**Key Components:**
-- **Data Management**: GenericDataService, SchemaManager, DatabaseOrchestrator
-- **Request Handling**: EnhancedRouter, GenericRouteHandler
-- **Configuration**: Domain configs, feature flags, customer management
-- **Orchestration**: Cross-domain coordination, deployment automation
-- **Security**: Configuration validation, secret management
-
-#### 🛠️ **CLI Tools (Development Interface)**
-Command-line tools for development, administration, and deployment:
-
-```bash
-# Interactive deployment
-node bin/deployment/enterprise-deploy.js deploy --interactive
-
-# Database management
-node bin/database/enterprise-db-manager.js migrate api.example.com
-
-# Portfolio operations
-node bin/portfolio/portfolio-manager.js deploy
-```
-
-**Available Tools:**
-- **Deployment CLI**: Interactive and automated deployment workflows
-- **Database CLI**: Migration, backup, health monitoring, optimization
-- **Portfolio CLI**: Multi-domain portfolio management and analytics
-- **Service Management**: Automated service initialization and templates
-
-#### 🔧 **Shared Utilities (Internal Implementation)**
-Internal utilities that power the CLI tools and framework components.
-
-## Intelligent Execution Model
-
-### Smart Component Resolution
-
-The framework uses **intelligent dependency resolution** to automatically:
-- **Discover services** through domain-based configuration
-- **Cache frequently used data** (schemas, queries, configurations)
-- **Pool database connections** with automatic health monitoring
-- **Validate configurations** progressively (syntax → semantic → integration)
-
-### Auto-Discovery & Orchestration
-
-Services automatically find and coordinate with each other through:
-- **Cloudflare API integration** for domain discovery
-- **Configuration inheritance** (global → customer → domain → service)
-- **Dependency graph analysis** for safe deployment ordering
-- **Cross-domain coordination** with failure isolation
-
-## Usage Patterns
-
-### Library Usage (Programmatic)
-**Best for**: Building custom services, integrating with existing codebases
-
-```javascript
-// Direct component usage
-import { GenericDataService, SchemaManager } from '@tamyla/clodo-framework';
-
-const service = new GenericDataService(d1Client, 'users');
-const users = await service.findAll({ limit: 10 });
-```
-
-### CLI Usage (Command Line)
-**Best for**: Development workflows, administration, one-off operations
-
-```bash
-# Deploy a service
-node bin/deployment/enterprise-deploy.js deploy api.example.com
-
-# Manage database
-node bin/database/enterprise-db-manager.js health api.example.com
-```
-
-### Hybrid Approach
-Most teams use both: CLI tools for development/administration, library components for service implementation.
-
-## Key Features
-
-### 🔒 **Security by Default**
-- Automatic security validation on all deployments
-- Environment-specific security requirements
-- Cryptographic key generation and management
-- Prevention of insecure configurations reaching production
-
-### ⚡ **Performance Optimized**
-- Multi-layer caching (schemas, queries, configurations)
-- Connection pooling with health monitoring
-- Lazy component initialization
-- Query optimization and result caching
-
-### 🛡️ **Enterprise Reliable**
-- Circuit breaker patterns for external services
-- Exponential backoff for retries
-- Graceful degradation on failures
-- Comprehensive error recovery
-
-### 📊 **Observable**
-- Built-in performance monitoring
-- Deployment auditing and logging
-- Health checks and alerting
-- Comprehensive telemetry
-
-## Design Principles
-
-### 🎪 **Clodo Architecture**
-- **Single Responsibility**: Each component has one clear purpose
-- **Composability**: Components combine in any configuration
-- **Reusability**: Components work across different contexts
-- **Testability**: Isolated testing of individual components with modular testing capabilities
-- **Modular Testing**: Individual test modules (API, Auth, Database, Performance) for granular control
-- **Observability**: Every operation is logged and monitored
-
-### 🏗️ **Convention over Configuration**
-- Standard patterns reduce decision complexity
-- Sensible defaults with override capabilities
-- Consistent naming and structure
-- Predictable behavior across components
-
-### 🔧 **Modular Extensibility**
-- Service types can be added without core changes
-- Custom validators and adapters can be plugged in
-- Database backends can be swapped
-- Deployment strategies are configurable
-
-## Getting Started
-
-### For Service Developers
-1. **Install**: `npm install @tamyla/clodo-framework`
-2. **Import components** you need for your service
-3. **Configure** domains, features, and database connections
-4. **Deploy** using CLI tools or embed deployment logic
-
-### For Platform Administrators
-1. **Use CLI tools** for deployment and management
-2. **Monitor** services through built-in telemetry
-3. **Configure** multi-tenant environments
-4. **Scale** by adding more domains and services
-
-## Architecture Benefits
-
-### For Small Businesses
-- **Cost Effective**: Generic components = affordable custom software
-- **Fast Time-to-Market**: Configuration over custom development
-- **Scalable**: Start simple, add complexity as you grow
-- **Maintainable**: Framework handles infrastructure complexity
-
-### For Enterprise Teams
-- **Consistency**: Standardized patterns across services
-- **Reliability**: Battle-tested components with enterprise features
-- **Developer Productivity**: Focus on business logic, not infrastructure
-- **Operational Excellence**: Built-in monitoring, security, and automation
-
-## Integration Examples
-
-### Basic CRUD Service
-```javascript
-import { GenericDataService, SchemaManager } from '@tamyla/clodo-framework';
-
-export default {
-  async fetch(request, env) {
-    const service = new GenericDataService(env.DB, 'products');
-    const products = await service.findAll();
-    return Response.json(products);
-  }
-};
-```
-
-### Multi-Domain Orchestration
-```javascript
-import { CrossDomainCoordinator } from '@tamyla/clodo-framework';
-
-const coordinator = new CrossDomainCoordinator({
-  domains: ['api.example.com', 'auth.example.com'],
-  enableMonitoring: true
-});
-
-await coordinator.deployAll();
-```
-
-## Conclusion
-
-The CLODO Framework provides a sophisticated yet approachable way to build enterprise-grade applications. By combining reusable components with intelligent orchestration, it enables both rapid development and enterprise reliability. The dual interface (library + CLI) serves different user needs while maintaining architectural integrity.
-
-Whether you're building a simple CRUD service or a complex multi-domain enterprise application, the framework provides the components and intelligence to get you there efficiently and reliably.</content>
-<parameter name="filePath">c:\Users\Admin\Documents\coding\tamyla\clodo-framework\docs\FRAMEWORK-ARCHITECTURE-OVERVIEW.md