archforge-x 1.0.0 → 1.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archforge-x",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Enterprise Architecture Engine for scaffolding, analyzing, and visualizing software architecture.",
   "main": "dist/index.js",
   "bin": {
@@ -42,16 +42,16 @@
     "@types/node": "^25.0.3",
     "@types/prompts": "^2.4.9",
     "@types/viz.js": "^2.1.5",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "ts-node": "^10.9.2"
   },
   "dependencies": {
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
     "fs-extra": "^11.3.3",
     "prompts": "^2.4.2",
+    "typescript": "^5.9.3",
     "viz.js": "^2.1.2",
     "yaml": "^2.8.2",
     "zod": "^4.2.1"
   }
-}
+}

package/dist/generators/professional.js

@@ -1,509 +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.professionalGenerator = professionalGenerator;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-// --- HELPER FUNCTIONS ---
-const writeFile = (root, filePath, content) => {
-    const fullPath = path_1.default.join(root, filePath);
-    fs_1.default.mkdirSync(path_1.default.dirname(fullPath), { recursive: true });
-    fs_1.default.writeFileSync(fullPath, content.trim());
-};
-const getPackageJson = (name, fw, arch, modules) => {
-    const deps = {
-        "dotenv": "^16.0.3",
-    };
-    const devDeps = {
-        "typescript": "^5.0.0",
-        "@types/node": "^20.0.0",
-        "jest": "^29.5.0",
-        "ts-jest": "^29.1.0",
-        "@types/jest": "^29.5.0",
-        "eslint": "^8.0.0",
-        "prettier": "^3.0.0"
-    };
-    if (fw === "nestjs") {
-        Object.assign(deps, {
-            "@nestjs/common": "^10.0.0",
-            "@nestjs/core": "^10.0.0",
-            "@nestjs/platform-express": "^10.0.0",
-            "reflect-metadata": "^0.1.13",
-            "rxjs": "^7.8.0"
-        });
-        Object.assign(devDeps, {
-            "@nestjs/cli": "^10.0.0",
-            "@nestjs/schematics": "^10.0.0",
-            "@nestjs/testing": "^10.0.0"
-        });
-    }
-    else if (fw === "express") {
-        Object.assign(deps, { "express": "^4.18.2", "cors": "^2.8.5" });
-        Object.assign(devDeps, { "@types/express": "^4.17.17", "ts-node-dev": "^2.0.0" });
-    }
-    if (modules.includes("auth"))
-        deps["jsonwebtoken"] = "^9.0.0";
-    if (modules.includes("auth") && fw === "nestjs")
-        deps["@nestjs/jwt"] = "^10.0.0";
-    if (modules.includes("db"))
-        deps["typeorm"] = "^0.3.17"; // Defaulting to TypeORM for boilerplate
-    if (modules.includes("cache"))
-        deps["ioredis"] = "^5.3.0";
-    return JSON.stringify({
-        name,
-        version: "0.0.1",
-        scripts: {
-            "start:dev": fw === "nestjs" ? "nest start --watch" : "ts-node-dev src/main.ts",
-            "build": "tsc",
-            "test": "jest"
-        },
-        dependencies: deps,
-        devDependencies: devDeps
-    }, null, 2);
-};
-const getGoMod = (name, fw) => {
-    return `module ${name}
-
-go 1.21
-
-require (
-    ${fw === "gin" ? 'github.com/gin-gonic/gin v1.9.1' : ''}
-    github.com/joho/godotenv v1.5.1
-)`;
-};
-const getRequirementsTxt = (fw, modules) => {
-    const reqs = ["python-dotenv"];
-    if (fw === "django")
-        reqs.push("Django>=4.2");
-    if (fw === "flask")
-        reqs.push("Flask>=2.3");
-    if (modules.includes("db"))
-        reqs.push("psycopg2-binary", "sqlalchemy");
-    if (modules.includes("auth"))
-        reqs.push("PyJWT");
-    return reqs.join("\n");
-};
-// --- CONTENT GENERATORS (Architecture Specific) ---
-const generateTsCleanArch = (root, options) => {
-    // 1. Core / Domain (Enterprise Business Rules)
-    writeFile(root, "src/domain/entities/user.entity.ts", `
-export class User {
-    constructor(
-        public readonly id: string,
-        public readonly name: string,
-        public readonly email: string,
-        public readonly passwordHash: string
-    ) {}
-}
-    `);
-    writeFile(root, "src/domain/repositories/user.repository.interface.ts", `
-import { User } from "../entities/user.entity";
-
-export interface IUserRepository {
-    save(user: User): Promise<User>;
-    findByEmail(email: string): Promise<User | null>;
-    findById(id: string): Promise<User | null>;
-}
-    `);
-    // 2. Application (Application Business Rules / Use Cases)
-    writeFile(root, "src/application/use-cases/create-user.use-case.ts", `
-import { User } from "../../domain/entities/user.entity";
-import { IUserRepository } from "../../domain/repositories/user.repository.interface";
-
-export class CreateUserUseCase {
-    constructor(private userRepository: IUserRepository) {}
-
-    async execute(name: string, email: string, passwordHash: string): Promise<User> {
-        const existing = await this.userRepository.findByEmail(email);
-        if (existing) throw new Error("User already exists");
-
-        const user = new User(Date.now().toString(), name, email, passwordHash);
-        return await this.userRepository.save(user);
-    }
-}
-    `);
-    // 3. Interface Adapters (Controllers, Presenters)
-    if (options.framework === "express") {
-        writeFile(root, "src/interface-adapters/controllers/user.controller.ts", `
-import { Request, Response } from "express";
-import { CreateUserUseCase } from "../../application/use-cases/create-user.use-case";
-
-export class UserController {
-    constructor(private createUserUseCase: CreateUserUseCase) {}
-
-    async create(req: Request, res: Response) {
-        try {
-            const { name, email, password } = req.body;
-            const user = await this.createUserUseCase.execute(name, email, password);
-            res.status(201).json(user);
-        } catch (e: any) {
-            res.status(400).json({ error: e.message });
-        }
-    }
-}
-        `);
-    }
-    // 4. Infrastructure (Frameworks, Drivers)
-    writeFile(root, "src/infrastructure/repositories/in-memory-user.repository.ts", `
-import { User } from "../../domain/entities/user.entity";
-import { IUserRepository } from "../../domain/repositories/user.repository.interface";
-
-export class InMemoryUserRepository implements IUserRepository {
-    private users: User[] = [];
-    async save(user: User): Promise<User> {
-        this.users.push(user);
-        return user;
-    }
-    async findByEmail(email: string): Promise<User | null> {
-        return this.users.find(u => u.email === email) || null;
-    }
-    async findById(id: string): Promise<User | null> {
-        return this.users.find(u => u.id === id) || null;
-    }
-}
-    `);
-    // Main Entry
-    if (options.framework === "express") {
-        writeFile(root, "src/main.ts", `
-import express from "express";
-import { UserController } from "./interface-adapters/controllers/user.controller";
-import { CreateUserUseCase } from "./application/use-cases/create-user.use-case";
-import { InMemoryUserRepository } from "./infrastructure/repositories/in-memory-user.repository";
-
-const app = express();
-app.use(express.json());
-
-// Dependency Injection Composition Root
-const userRepo = new InMemoryUserRepository();
-const createUserUseCase = new CreateUserUseCase(userRepo);
-const userController = new UserController(createUserUseCase);
-
-app.post("/users", (req, res) => userController.create(req, res));
-
-app.listen(3000, () => console.log("🚀 Server running on PORT 3000 (Clean Architecture)"));
-        `);
-    }
-    else if (options.framework === "nestjs") {
-        // NestJS needs modules
-        writeFile(root, "src/app.module.ts", `
-import { Module } from '@nestjs/common';
-import { UserController } from './interface-adapters/controllers/user.controller';
-import { UserService } from './application/services/user.service'; // NestJS prefers Services over generic UseCases usually, but we stick to clean
-import { InMemoryUserRepository } from './infrastructure/repositories/in-memory-user.repository';
-
-@Module({
-  controllers: [UserController],
-  providers: [
-    { provide: 'IUserRepository', useClass: InMemoryUserRepository },
-    UserService
-  ],
-})
-export class AppModule {}
-        `);
-        writeFile(root, "src/main.ts", `
-import { NestFactory } from '@nestjs/core';
-import { AppModule } from './app.module';
-
-async function bootstrap() {
-  const app = await NestFactory.create(AppModule);
-  await app.listen(3000);
-  console.log("🚀 NestJS Server with Clean Architecture running on 3000");
-}
-bootstrap();
-        `);
-    }
-};
-const generateGoStandard = (root, options) => {
-    // Standard Go Layout (Internal/Pkg)
-    // Domain
-    writeFile(root, "internal/core/domain/user.go", `
-package domain
-
-type User struct {
-    ID    string \`json:"id"\`
-    Name  string \`json:"name"\`
-    Email string \`json:"email"\`
-}
-
-type UserRepository interface {
-    Save(user *User) error
-    GetByEmail(email string) (*User, error)
-}
-    `);
-    // Port/Service
-    writeFile(root, "internal/core/services/user_service.go", `
-package services
-import (
-    "errors"
-    "${options.projectName}/internal/core/domain"
-    "time"
-    "fmt"
-)
-
-type UserService struct {
-    repo domain.UserRepository
-}
-
-func NewUserService(repo domain.UserRepository) *UserService {
-    return &UserService{repo: repo}
-}
-
-func (s *UserService) Create(name, email string) (*domain.User, error) {
-    existing, _ := s.repo.GetByEmail(email)
-    if existing != nil {
-        return nil, errors.New("user already exists")
-    }
-    user := &domain.User{
-        ID: fmt.Sprintf("%d", time.Now().Unix()), 
-        Name: name, 
-        Email: email,
-    }
-    return user, s.repo.Save(user)
-}
-    `);
-    // Adapter
-    writeFile(root, "internal/adapters/repository/memory_repo.go", `
-package repository
-import "${options.projectName}/internal/core/domain"
-
-type MemoryRepo struct {
-    users []*domain.User
-}
-
-func NewMemoryRepo() *MemoryRepo {
-    return &MemoryRepo{users: []*domain.User{}}
-}
-
-func (m *MemoryRepo) Save(user *domain.User) error {
-    m.users = append(m.users, user)
-    return nil
-}
-
-func (m *MemoryRepo) GetByEmail(email string) (*domain.User, error) {
-    for _, u := range m.users {
-        if u.Email == email { return u, nil }
-    }
-    return nil, nil
-}
-    `);
-    // Main
-    if (options.framework === "gin") {
-        writeFile(root, "cmd/server/main.go", `
-package main
-import (
-    "github.com/gin-gonic/gin"
-    "${options.projectName}/internal/adapters/repository"
-    "${options.projectName}/internal/core/services"
-    "${options.projectName}/internal/core/domain"
-    "net/http"
-)
-
-func main() {
-    repo := repository.NewMemoryRepo()
-    svc := services.NewUserService(repo)
-
-    r := gin.Default()
-    r.POST("/users", func(c *gin.Context) {
-        var req domain.User
-        if err := c.ShouldBindJSON(&req); err != nil {
-            c.JSON(400, gin.H{"error": err.Error()})
-            return
-        }
-        user, err := svc.Create(req.Name, req.Email)
-        if err != nil {
-            c.JSON(400, gin.H{"error": err.Error()})
-            return
-        }
-        c.JSON(201, user)
-    })
-    r.Run(":8080")
-}
-        `);
-    }
-};
-const generatePythonStructure = (root, options) => {
-    // Python tends to be slightly flatter, but we can do Clean
-    const init = "";
-    if (options.framework === "django") {
-        writeFile(root, "manage.py", "# Django boilerplate management script");
-        writeFile(root, `${options.projectName}/settings.py`, "# Django Settings");
-        writeFile(root, `${options.projectName}/urls.py`, "# Main URLs");
-        // Use DDD-like apps
-        const appPath = "apps/users";
-        writeFile(root, `${appPath}/__init__.py`, init);
-        writeFile(root, `${appPath}/models.py`, `
-from django.db import models
-
-class User(models.Model):
-    name = models.CharField(max_length=255)
-    email = models.EmailField(unique=True)
-        `);
-        writeFile(root, `${appPath}/services.py`, `
-from .models import User
-
-class UserService:
-    @staticmethod
-    def create_user(name: str, email: str) -> User:
-        if User.objects.filter(email=email).exists():
-            raise ValueError("User exists")
-        return User.objects.create(name=name, email=email)
-        `);
-        writeFile(root, `${appPath}/views.py`, `
-from rest_framework.views import APIView
-from rest_framework.response import Response
-from .services import UserService
-
-class UserView(APIView):
-    def post(self, request):
-        try:
-            user = UserService.create_user(request.data['name'], request.data['email'])
-            return Response({"id": user.id, "email": user.email})
-        except Exception as e:
-            return Response({"error": str(e)}, status=400)
-        `);
-    }
-    else {
-        // Flask Hexagonal
-        writeFile(root, "app/__init__.py", init);
-        // Domain
-        writeFile(root, "app/core/domain/user.py", `
-from dataclasses import dataclass
-@dataclass
-class User:
-    id: str
-    name: str
-    email: str
-        `);
-        // Ports
-        writeFile(root, "app/core/ports/user_repository.py", `
-from abc import ABC, abstractmethod
-from ..domain.user import User
-
-class UserRepository(ABC):
-    @abstractmethod
-    def save(self, user: User): pass
-        `);
-        // Adapter
-        writeFile(root, "app/adapters/db/in_memory_repo.py", `
-from app.core.ports.user_repository import UserRepository
-class InMemoryUserRepo(UserRepository):
-    def __init__(self): self.users = []
-    def save(self, user): self.users.append(user)
-        `);
-        // Entry
-        writeFile(root, "run.py", `
-from flask import Flask, request, jsonify
-from app.adapters.db.in_memory_repo import InMemoryUserRepo
-from app.core.domain.user import User
-import uuid
-
-app = Flask(__name__)
-repo = InMemoryUserRepo()
-
-@app.route('/users', methods=['POST'])
-def create_user():
-    data = request.json
-    user = User(id=str(uuid.uuid4()), name=data['name'], email=data['email'])
-    repo.save(user)
-    return jsonify(user.__dict__), 201
-
-if __name__ == "__main__":
-    app.run(debug=True, port=5000)
-        `);
-    }
-};
-// --- MAIN GENERATOR FUNCTION ---
-async function professionalGenerator(_arch, options) {
-    const root = path_1.default.resolve(options.projectName);
-    // 1. Scaffold Directories
-    if (!fs_1.default.existsSync(root))
-        fs_1.default.mkdirSync(root);
-    console.log(chalk_1.default.green(`\n📂 Creating project infrastructure at ${root}...`));
-    // 2. Generate Configuration Files (The Backbone)
-    if (options.language === "ts" || options.language === "js") {
-        writeFile(root, "package.json", getPackageJson(options.projectName, options.framework, options.architecture, options.modules));
-        writeFile(root, "tsconfig.json", JSON.stringify({
-            compilerOptions: { target: "ES2020", module: "commonjs", outDir: "./dist", rootDir: "./src", strict: true, experimentalDecorators: true, emitDecoratorMetadata: true },
-            exclude: ["node_modules", "dist"]
-        }, null, 2));
-    }
-    else if (options.language === "go") {
-        writeFile(root, "go.mod", getGoMod(options.projectName, options.framework));
-    }
-    else if (options.language === "py") {
-        writeFile(root, "requirements.txt", getRequirementsTxt(options.framework, options.modules));
-    }
-    writeFile(root, ".env.example", "PORT=3000\nDB_HOST=localhost\nJWT_SECRET=supersecret");
-    writeFile(root, ".gitignore", "node_modules/\ndist/\n.env\n__pycache__/\n*.exe\nvendor/");
-    writeFile(root, "README.md", `# ${options.projectName}\nGenerated by ArchForge X\nArchitecture: ${options.architecture}`);
-    // 3. Generate Architecture Logic
-    console.log(chalk_1.default.blue("🏗️  Constructing Architecture layers..."));
-    if (options.language === "ts" || options.language === "js") {
-        generateTsCleanArch(root, options);
-    }
-    else if (options.language === "go") {
-        generateGoStandard(root, options);
-    }
-    else if (options.language === "py") {
-        generatePythonStructure(root, options);
-    }
-    // 4. Inject Optional Modules (Advanced Integration)
-    if (options.modules.includes("docker")) {
-        console.log(chalk_1.default.cyan("🐳 Containerizing application..."));
-        const dockerfileContent = options.language === "go"
-            ? `FROM golang:1.21-alpine\nWORKDIR /app\nCOPY . .\nRUN go build -o main cmd/server/main.go\nCMD ["./main"]`
-            : options.language === "py"
-                ? `FROM python:3.9-slim\nWORKDIR /app\nCOPY requirements.txt .\nRUN pip install -r requirements.txt\nCOPY . .\nCMD ["python", "run.py"]`
-                : `FROM node:18-alpine\nWORKDIR /app\nCOPY package*.json .\nRUN npm install\nCOPY . .\nRUN npm run build\nCMD ["npm", "start"]`;
-        writeFile(root, "Dockerfile", dockerfileContent);
-        writeFile(root, "docker-compose.yml", `
-version: '3.8'
-services:
-  app:
-    build: .
-    ports:
-      - "${options.language === 'py' ? '5000:5000' : '3000:3000'}"
-    env_file: .env
-${options.modules.includes("db") ? `  db:
-    image: postgres:15
-    environment:
-      POSTGRES_PASSWORD: root
-    ports:
-      - "5432:5432"` : ''}
-        `);
-    }
-    if (options.modules.includes("ci")) {
-        writeFile(root, ".github/workflows/ci.yml", `
-name: CI
-on: [push]
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-      - name: Test
-        run: echo "Running tests..."
-        `);
-    }
-    if (options.modules.includes("auth")) {
-        // Add a specialized Auth service file depending on lang
-        const authPath = options.language === "go" ? "internal/core/services/auth_service.go"
-            : options.language === "py" ? "app/core/services/auth.py"
-                : "src/application/services/auth.service.ts";
-        writeFile(root, authPath, `
-// JWT Authentication Service Boilerplate
-// TODO: Implement actual signing and validation logic here
-export class AuthService {
-    login(u: any) { return "jwt_token_example"; }
-}
-        `.replace("export class", options.language === "go" ? "package services\ntype AuthService struct{}" : "class"));
-    }
-    console.log(chalk_1.default.green.bold(`\n✅ Project ${options.projectName} successfully generated!`));
-    console.log(chalk_1.default.gray(`   Architecture: ${options.architecture.toUpperCase()}`));
-    console.log(chalk_1.default.gray(`   Language: ${options.language.toUpperCase()}`));
-    if (options.modules.length > 0)
-        console.log(chalk_1.default.gray(`   Modules: ${options.modules.join(", ")}`));
-}

package/dist/generators/templates/base.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateBaseFile = generateBaseFile;
-function generateBaseFile(layerName) {
-    return `/**
- * Base file for ${layerName} layer
- * Generated by ArchForge X
- */
-`;
-}

package/dist/sample-app/application/application.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.something = void 0;
-/**
- * Base file for application layer
- * Generated by ArchForge X
- */
-exports.something = "something";

package/dist/sample-app/domain/domain.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/sample-app/domain/domain.spec.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/sample-app/infrastructure/infrastructure.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.something = void 0;
-/**
- * Base file for infrastructure layer
- * Generated by ArchForge X
- */
-exports.something = "something";