archforge-x 1.0.2 → 1.0.4

package/dist/generators/python/fastapi.js

@@ -0,0 +1,309 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FastAPIGenerator = void 0;
+const base_1 = require("../base");
+class FastAPIGenerator extends base_1.BaseGenerator {
+    getGeneratorName() {
+        return "FastAPI";
+    }
+    async generateProjectStructure(root, arch, options) {
+        this.generateCommonFiles(root, options);
+        this.generateAppStructure(root, options);
+    }
+    generateCommonFiles(root, options) {
+        const projectName = options.projectName || "fastapi-app";
+        this.writeFile(root, "requirements.txt", `
+fastapi>=0.100.0
+uvicorn>=0.23.0
+pydantic>=2.0.0
+python-dotenv>=1.0.0
+import-linter>=1.10.0
+structlog>=23.1.0
+asgi-correlation-id>=4.2.0
+${options.orm === 'sqlalchemy' ? 'sqlalchemy>=2.0.0' : ''}
+${options.orm === 'sqlalchemy' && options.database === 'postgresql' ? 'psycopg2-binary>=2.9.0' : ''}
+${options.orm === 'sqlalchemy' && options.database === 'mysql' ? 'mysqlclient>=2.2.0' : ''}
+        `.trim());
+        if (options.orm === 'sqlalchemy') {
+            this.generateSQLAlchemySetup(root, options);
+        }
+        this.writeFile(root, ".env", "PORT=8000\nENV=development");
+        this.writeFile(root, ".gitignore", "__pycache__/\n.env\nvenv/\n");
+        this.writeFile(root, "README.md", `# ${projectName}\n\nGenerated by ArchForge X`);
+        // .import-linter (Architecture Guardrails)
+        this.writeFile(root, ".import-linter", `
+[importlinter]
+root_package = app
+
+[importlinter:contract:1]
+name = API Layer Boundaries
+type = layers
+layers =
+    api
+    schemas
+    models
+containers = app
+        `.trim());
+    }
+    generateAppStructure(root, options) {
+        // Main entry point
+        this.writeFile(root, "main.py", `
+import uvicorn
+import structlog
+from fastapi import FastAPI, Request
+from asgi_correlation_id import CorrelationIdMiddleware
+from app.api.v1.endpoints import users
+
+# Configure Structlog
+structlog.configure(
+    processors=[
+        structlog.contextvars.merge_contextvars,
+        structlog.processors.add_log_level,
+        structlog.processors.TimeStamper(fmt="iso"),
+        structlog.processors.JSONRenderer()
+    ],
+    logger_factory=structlog.PrintLoggerFactory(),
+)
+
+logger = structlog.get_logger()
+
+app = FastAPI(title="FastAPI App")
+
+# Middleware
+app.add_middleware(CorrelationIdMiddleware)
+
+@app.middleware("http")
+async def log_requests(request: Request, call_next):
+    logger.info("Incoming request", method=request.method, url=str(request.url))
+    response = await call_next(request)
+    logger.info("Request completed", status_code=response.status_code)
+    return response
+
+app.include_router(users.router, prefix="/api/v1/users", tags=["users"])
+
+@app.get("/")
+def read_root():
+    return {"message": "Welcome to FastAPI generated by ArchForge X"}
+
+if __name__ == "__main__":
+    uvicorn.run("main:app", host="0.0.0.0", port=8000, reload=True)
+        `);
+        // App package
+        this.createDir(root, "app");
+        this.writeFile(root, "app/__init__.py", "");
+        // Models
+        this.writeFile(root, "app/models/__init__.py", "");
+        if (options.orm === 'sqlalchemy') {
+            this.writeFile(root, "app/models/user.py", `
+from sqlalchemy import Column, String
+from app.infrastructure.database import Base
+
+class User(Base):
+    __tablename__ = "users"
+
+    id = Column(String, primary_key=True, index=True)
+    name = Column(String)
+    email = Column(String, unique=True, index=True)
+        `);
+        }
+        else {
+            this.writeFile(root, "app/models/user.py", `
+from pydantic import BaseModel
+
+class User(BaseModel):
+    id: str
+    name: str
+    email: str
+        `);
+        }
+        // Schemas
+        this.writeFile(root, "app/schemas/__init__.py", "");
+        this.writeFile(root, "app/schemas/user.py", `
+from pydantic import BaseModel
+
+class UserCreate(BaseModel):
+    name: str
+    email: str
+
+class UserResponse(BaseModel):
+    id: str
+    name: str
+    email: str
+
+    class Config:
+        from_attributes = True
+        `);
+        // API
+        this.createDir(root, "app/api");
+        this.writeFile(root, "app/api/__init__.py", "");
+        this.createDir(root, "app/api/v1");
+        this.writeFile(root, "app/api/v1/__init__.py", "");
+        this.createDir(root, "app/api/v1/endpoints");
+        this.writeFile(root, "app/api/v1/endpoints/__init__.py", "");
+        if (options.orm === 'sqlalchemy') {
+            this.writeFile(root, "app/api/v1/endpoints/users.py", `
+from fastapi import APIRouter, HTTPException, Depends
+from sqlalchemy.orm import Session
+from app.schemas.user import UserCreate, UserResponse
+from app.models.user import User
+from app.infrastructure.database import get_db
+import uuid
+
+router = APIRouter()
+
+@router.post("/", response_model=UserResponse)
+def create_user(user_in: UserCreate, db: Session = Depends(get_db)):
+    user = User(id=str(uuid.uuid4()), name=user_in.name, email=user_in.email)
+    db.add(user)
+    db.commit()
+    db.refresh(user)
+    return user
+
+@router.get("/", response_model=list[UserResponse])
+def read_users(db: Session = Depends(get_db)):
+    return db.query(User).all()
+        `);
+        }
+        else {
+            this.writeFile(root, "app/api/v1/endpoints/users.py", `
+from fastapi import APIRouter, HTTPException
+from app.schemas.user import UserCreate, UserResponse
+from app.models.user import User
+import uuid
+
+router = APIRouter()
+
+users_db = []
+
+@router.post("/", response_model=UserResponse)
+def create_user(user_in: UserCreate):
+    user = User(id=str(uuid.uuid4()), name=user_in.name, email=user_in.email)
+    users_db.append(user)
+    return user
+
+@router.get("/", response_model=list[UserResponse])
+def read_users():
+    return users_db
+        `);
+        }
+    }
+    generateDocker(root, options) {
+        const dbService = options.database === "postgresql" ? `
+  db:
+    image: postgres:15-alpine
+    environment:
+      - POSTGRES_USER=user
+      - POSTGRES_PASSWORD=password
+      - POSTGRES_DB=appdb
+    ports:
+      - "5432:5432"
+        ` : options.database === "mysql" ? `
+  db:
+    image: mysql:8
+    environment:
+      - MYSQL_ROOT_PASSWORD=password
+      - MYSQL_DATABASE=appdb
+    ports:
+      - "3306:3306"
+        ` : "";
+        const dbUrl = options.database === "postgresql" ? "postgresql://user:password@db:5432/appdb" :
+            options.database === "mysql" ? "mysql://root:password@db:3306/appdb" :
+                "sqlite:///./dev.db";
+        this.writeFile(root, "Dockerfile", `
+FROM python:3.11-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+EXPOSE 8000
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
+        `);
+        this.writeFile(root, "docker-compose.yml", `
+version: '3.8'
+services:
+  app:
+    build: .
+    ports:
+      - "8000:8000"
+    environment:
+      - PORT=8000
+      - ENV=production
+      - DATABASE_URL=${dbUrl}
+    depends_on:
+      ${dbService ? "- db" : ""}
+    restart: always
+  ${dbService}
+        `);
+    }
+    generateCI(root, options) {
+        this.writeFile(root, ".github/workflows/ci.yml", `
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+        cache: 'pip'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        pip install pytest flake8
+    - name: Lint with flake8
+      run: |
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+    - name: Architecture Sync & Validation
+      run: |
+        pip install archforge-x # In a real scenario, this would be available
+        archforge sync
+        `);
+    }
+    generateSQLAlchemySetup(root, options) {
+        const dbUrl = options.database === "postgresql" ? "os.getenv('DATABASE_URL', 'postgresql://user:password@localhost:5432/appdb')" :
+            options.database === "mysql" ? "os.getenv('DATABASE_URL', 'mysql://root:password@localhost:3306/appdb')" :
+                "os.getenv('DATABASE_URL', 'sqlite:///./dev.db')";
+        this.writeFile(root, "app/infrastructure/database.py", `
+import os
+from sqlalchemy import create_all, create_engine
+from sqlalchemy.ext.declarative import declarative_base
+from sqlalchemy.orm import sessionmaker
+
+SQLALCHEMY_DATABASE_URL = ${dbUrl}
+
+engine = create_engine(
+    SQLALCHEMY_DATABASE_URL, 
+    connect_args={"check_same_thread": False} if "sqlite" in SQLALCHEMY_DATABASE_URL else {}
+)
+SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)
+
+Base = declarative_base()
+
+def get_db():
+    db = SessionLocal()
+    try:
+        yield db
+    finally:
+        db.close()
+        `);
+        // Update main.py to create tables
+        this.writeFile(root, "app/infrastructure/__init__.py", "");
+    }
+}
+exports.FastAPIGenerator = FastAPIGenerator;

package/dist/generators/registry.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneratorRegistry = void 0;
+class GeneratorRegistry {
+    static register(key, generator) {
+        this.generators.set(key, generator);
+    }
+    static getGenerator(language, framework) {
+        // Try exact match first
+        const key = `${language}:${framework}`;
+        if (this.generators.has(key)) {
+            return this.generators.get(key);
+        }
+        // Fallback to language only if framework specific one not found (or if framework is generic)
+        if (this.generators.has(language)) {
+            return this.generators.get(language);
+        }
+        return undefined;
+    }
+    static listGenerators() {
+        return Array.from(this.generators.keys());
+    }
+}
+exports.GeneratorRegistry = GeneratorRegistry;
+GeneratorRegistry.generators = new Map();

package/dist/index.js

@@ -6,8 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const fs_1 = __importDefault(require("fs"));
-const init_1 = require("./cli/init");
 const interactive_1 = require("./cli/interactive");
+const sync_1 = require("./cli/commands/sync");
 const parser_1 = require("./core/architecture/parser");
 const generator_1 = require("./generators/generator");
 const dependency_1 = require("./analyzers/dependency");
@@ -26,10 +26,22 @@ const loadConfig = (configPath) => {
     return (0, parser_1.loadArchitecture)(configPath);
 };
 // --- COMMANDS ---
-program.addCommand(init_1.initCommand);
+program
+    .command("init")
+    .description("Initialize a new project with interactive wizard (Recommended)")
+    .action(async () => {
+    await (0, interactive_1.interactiveCLI)();
+});
+program
+    .command("sync")
+    .description("Synchronize architecture with archforge.yaml and validate structure")
+    .action(async () => {
+    await (0, sync_1.syncCommand)();
+});
 program
     .command("generate")
-    .description("Scaffold a project based on architecture definition")
+    .alias("create")
+    .description("Scaffold a project or module based on architecture definition")
     .option("-c, --config <path>", "Path to yaml config", "archforge.yaml")
     .option("-m, --mode <mode>", "Generation mode: 'standard' or 'professional'", "professional")
     .action(async (options) => {
@@ -41,7 +53,9 @@ program
             language: arch.metadata.language,
             framework: arch.metadata.framework,
             modules: arch.metadata.modules,
-            projectName: arch.project.name
+            projectName: arch.project.name,
+            orm: arch.metadata.orm,
+            database: arch.metadata.database
         };
         await (0, generator_1.generateProject)(arch, genOptions);
     }
@@ -51,14 +65,15 @@ program
     }
 });
 program
-    .command("analyze")
-    .description("Static analysis of dependency graph against rules")
+    .command("validate")
+    .alias("check")
+    .description("Validate project structure and dependencies against rules")
     .option("-c, --config <path>", "Path to yaml config", "archforge.yaml")
     .option("--ignore-tests", "Exclude test files from analysis")
     .option("-o, --output <file>", "Export report to JSON/Markdown")
     .action((options) => {
     try {
-        console.log(chalk_1.default.cyan("🔍 Analyzing Dependencies..."));
+        console.log(chalk_1.default.cyan("🔍 Validating Architecture..."));
         const arch = loadConfig(options.config);
         const violations = (0, dependency_1.analyzeDependencies)(arch, {
             ignoreTests: options.ignoreTests,
@@ -69,13 +84,13 @@ program
             process.exit(1);
     }
     catch (err) {
-        console.error(chalk_1.default.red.bold("\n❌ Analysis Error:"), err.message);
+        console.error(chalk_1.default.red.bold("\n❌ Validation Error:"), err.message);
         process.exit(1);
     }
 });
 program
     .command("audit")
-    .description("Deep architectural audit with auto-fix suggestions")
+    .description("Perform a deep architectural audit with auto-fix suggestions")
     .option("-c, --config <path>", "Path to yaml config", "archforge.yaml")
     .option("-o, --output <file>", "Export audit results")
     .action((options) => {
@@ -91,8 +106,9 @@ program
     }
 });
 program
-    .command("visualize")
-    .description("Generate visual dependency graph (SVG)")
+    .command("graph")
+    .alias("visualize")
+    .description("Generate a visual dependency graph (SVG)")
     .option("-c, --config <path>", "Path to yaml config", "archforge.yaml")
     .option("-o, --output <file>", "Output file path", "architecture-graph.svg")
     .action(async (options) => {
@@ -106,10 +122,8 @@ program
         console.error(chalk_1.default.red.bold("\n❌ Visualization Error:"), err.message);
     }
 });
-program
-    .command("interactive", { isDefault: true })
-    .description("Interactive Wizard (Recommended)")
-    .action(async () => {
+// Set default command to init
+program.action(async () => {
     await (0, interactive_1.interactiveCLI)();
 });
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archforge-x",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Enterprise Architecture Engine for scaffolding, analyzing, and visualizing software architecture.",
   "main": "dist/index.js",
   "bin": {
@@ -39,6 +39,7 @@
   "homepage": "https://github.com/henabakos/archforge-x#readme",
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.0.3",
     "@types/prompts": "^2.4.9",
     "@types/viz.js": "^2.1.5",
@@ -48,6 +49,7 @@
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
     "fs-extra": "^11.3.3",
+    "js-yaml": "^4.1.1",
     "prompts": "^2.4.2",
     "typescript": "^5.9.3",
     "viz.js": "^2.1.2",

package/dist/cli/init.js

@@ -1,74 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initCommand = void 0;
-const commander_1 = require("commander");
-const fs_1 = __importDefault(require("fs"));
-const chalk_1 = __importDefault(require("chalk"));
-const path_1 = __importDefault(require("path"));
-exports.initCommand = new commander_1.Command("init")
-    .description("Initialize a new architecture configuration file (archforge.yaml)")
-    .action(() => {
-    const configPath = path_1.default.resolve(process.cwd(), "archforge.yaml");
-    // 1. Safety Check: Don't overwrite existing config
-    if (fs_1.default.existsSync(configPath)) {
-        console.log(chalk_1.default.yellow("⚠️  Configuration file 'archforge.yaml' already exists."));
-        console.log(chalk_1.default.gray(`   Path: ${configPath}`));
-        console.log(chalk_1.default.blue("   Run 'archforge analyze' or 'archforge generate' to use it."));
-        return;
-    }
-    const template = `
-version: "1.0"
-name: "Enterprise Architecture Config"
-project:
-  name: "my-awesome-project"
-  root: "."
-
-metadata:
-  type: "clean"        # Options: clean, ddd, hexagonal, layered
-  language: "ts"       # Options: ts, js, py, go
-  framework: "nestjs"  # Options: nestjs, express, django, flask, gin
-  version: "1.0.0"
-  modules:             # Optional modules to scaffold
-    - "auth"
-    - "docker"
-
-# Define your architecture layers and dependency rules here
-layers:
-  - name: "domain"
-    path: "src/domain"
-    description: "Core business logic and entities (Enterprise Rules)"
-    strict: true
-    forbiddenImports: ["infrastructure", "interface", "application"]
-
-  - name: "application"
-    path: "src/application"
-    description: "Use cases and application logic"
-    allowedImports: ["domain"]
-
-  - name: "infrastructure"
-    path: "src/infrastructure"
-    description: "External tools, databases, and third-party services"
-    allowedImports: ["domain", "application"]
-
-  - name: "interface"
-    path: "src/interface"
-    description: "Controllers, API endpoints, and Presenters"
-    allowedImports: ["application"]
-`.trim();
-    // 3. Write the file
-    try {
-        fs_1.default.writeFileSync(configPath, template, "utf-8");
-        console.log(chalk_1.default.green.bold("✅ Successfully initialized 'archforge.yaml'"));
-        console.log(chalk_1.default.white("   You can now customize the layers in the file."));
-        console.log(chalk_1.default.gray("\nNext steps:"));
-        console.log(chalk_1.default.cyan("   1. archforge generate"));
-        console.log(chalk_1.default.cyan("   2. archforge analyze"));
-    }
-    catch (err) {
-        console.error(chalk_1.default.red("❌ Failed to create configuration file:"), err.message);
-        process.exit(1);
-    }
-});