archforge-x 1.0.2 → 1.0.4

package/dist/generators/node/nextjs.js

@@ -0,0 +1,252 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NextJSGenerator = void 0;
+const base_1 = require("../base");
+class NextJSGenerator extends base_1.BaseGenerator {
+    getGeneratorName() {
+        return "Next.js";
+    }
+    async generateProjectStructure(root, arch, options) {
+        // Next.js is opinionated, so we'll stick to its standard structure but organized well.
+        // We can support "clean" by adding a separate folder for domain logic if requested.
+        this.generateCommonFiles(root, options);
+        this.generateSourceFiles(root, options);
+    }
+    generateCommonFiles(root, options) {
+        const projectName = options.projectName || "nextjs-app";
+        this.writeFile(root, "package.json", JSON.stringify({
+            name: projectName,
+            version: "0.1.0",
+            private: true,
+            scripts: {
+                "dev": "next dev",
+                "build": "next build",
+                "start": "next start",
+                "lint": "next lint"
+            },
+            dependencies: {
+                "react": "^18",
+                "react-dom": "^18",
+                "next": "14.0.0",
+                "pino": "^8.14.0",
+                "uuid": "^9.0.0"
+            },
+            devDependencies: {
+                "typescript": "^5",
+                "@types/node": "^20",
+                "@types/react": "^18",
+                "@types/react-dom": "^18",
+                "@types/uuid": "^9.0.2",
+                "eslint": "^8",
+                "eslint-config-next": "14.0.0",
+                "eslint-plugin-import": "^2.27.5",
+                "pino-pretty": "^10.0.0"
+            }
+        }, null, 2));
+        this.writeFile(root, "tsconfig.json", JSON.stringify({
+            compilerOptions: {
+                target: "es5",
+                lib: ["dom", "dom.iterable", "esnext"],
+                allowJs: true,
+                skipLibCheck: true,
+                strict: true,
+                noEmit: true,
+                esModuleInterop: true,
+                module: "esnext",
+                moduleResolution: "bundler",
+                resolveJsonModule: true,
+                isolatedModules: true,
+                jsx: "preserve",
+                incremental: true,
+                plugins: [{ name: "next" }],
+                paths: { "@/*": ["./src/*"] }
+            },
+            include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+            exclude: ["node_modules"]
+        }, null, 2));
+        // .eslintrc.json (Architecture Guardrails)
+        this.writeFile(root, ".eslintrc.json", JSON.stringify({
+            "extends": "next/core-web-vitals",
+            "plugins": ["import"],
+            "rules": {
+                "import/no-restricted-paths": ["error", {
+                        "zones": [
+                            {
+                                "target": "./src/components",
+                                "from": "./src/app",
+                                "message": "Components cannot import from App (Pages)"
+                            },
+                            {
+                                "target": "./src/lib",
+                                "from": "./src/components",
+                                "message": "Lib cannot import from Components"
+                            },
+                            {
+                                "target": "./src/lib",
+                                "from": "./src/app",
+                                "message": "Lib cannot import from App (Pages)"
+                            }
+                        ]
+                    }]
+            }
+        }, null, 2));
+        this.writeFile(root, "next.config.js", `/** @type {import('next').NextConfig} */
+const nextConfig = {}
+module.exports = nextConfig
+        `);
+        this.writeFile(root, ".gitignore", `node_modules/\n.next/\n.env\n`);
+        this.writeFile(root, "next-env.d.ts", `/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/basic-features/typescript for more information.
+        `);
+    }
+    generateSourceFiles(root, options) {
+        // App Router structure
+        this.writeFile(root, "src/app/layout.tsx", `
+import type { Metadata } from 'next'
+
+export const metadata: Metadata = {
+  title: 'Create Next App',
+  description: 'Generated by create next app',
+}
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+        `);
+        this.writeFile(root, "src/app/page.tsx", `
+export default function Home() {
+  return (
+    <main style={{ padding: '2rem', fontFamily: 'sans-serif' }}>
+      <h1>Welcome to Next.js</h1>
+      <p>Generated by ArchForge X</p>
+    </main>
+  )
+}
+        `);
+        // API Route example
+        this.writeFile(root, "src/app/api/hello/route.ts", `
+import { NextResponse } from 'next/server';
+import logger from '@/lib/logger';
+
+export async function GET() {
+  logger.info('Hello API called');
+  return NextResponse.json({ message: 'Hello from ArchForge X!' });
+}
+        `);
+        // Logger Utility
+        this.writeFile(root, "src/lib/logger.ts", `
+import pino from 'pino';
+
+const logger = pino({
+  level: process.env.LOG_LEVEL || 'info',
+  transport: process.env.NODE_ENV !== 'production' ? { target: 'pino-pretty' } : undefined,
+  base: {
+    env: process.env.NODE_ENV,
+  },
+});
+
+export default logger;
+        `);
+        // Middleware for Correlation ID
+        this.writeFile(root, "src/middleware.ts", `
+import { NextResponse } from 'next/server';
+import type { NextRequest } from 'next/server';
+import { v4 as uuidv4 } from 'uuid';
+
+export function middleware(request: NextRequest) {
+  const requestHeaders = new Headers(request.headers);
+  const correlationId = requestHeaders.get('x-correlation-id') || uuidv4();
+  requestHeaders.set('x-correlation-id', correlationId);
+
+  const response = NextResponse.next({
+    request: {
+      headers: requestHeaders,
+    },
+  });
+
+  response.headers.set('x-correlation-id', correlationId);
+  return response;
+}
+
+export const config = {
+  matcher: '/:path*',
+};
+        `);
+    }
+    generateDocker(root, options) {
+        this.writeFile(root, "Dockerfile", `
+FROM node:18-alpine AS base
+
+FROM base AS deps
+WORKDIR /app
+COPY package.json package-lock.json* ./
+RUN npm ci
+
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+RUN npm run build
+
+FROM base AS runner
+WORKDIR /app
+ENV NODE_ENV production
+COPY --from=builder /app/public ./public
+COPY --from=builder /app/.next/standalone ./
+COPY --from=builder /app/.next/static ./.next/static
+
+EXPOSE 3000
+ENV PORT 3000
+CMD ["node", "server.js"]
+        `);
+        this.writeFile(root, "docker-compose.yml", `
+version: '3.8'
+services:
+  app:
+    build: .
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=production
+    restart: always
+        `);
+    }
+    generateCI(root, options) {
+        this.writeFile(root, ".github/workflows/ci.yml", `
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: Use Node.js 18.x
+      uses: actions/setup-node@v3
+      with:
+        node-version: 18.x
+        cache: 'npm'
+    - run: npm ci
+    - run: npm run lint
+    - run: npm run build
+        `);
+    }
+}
+exports.NextJSGenerator = NextJSGenerator;

package/dist/generators/python/django.js

@@ -0,0 +1,327 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DjangoGenerator = void 0;
+const base_1 = require("../base");
+class DjangoGenerator extends base_1.BaseGenerator {
+    getGeneratorName() {
+        return "Django";
+    }
+    async generateProjectStructure(root, arch, options) {
+        // Django structure is complex to generate file-by-file without the CLI, 
+        // but we will generate a standard working structure.
+        const projectName = options.projectName || "django_project";
+        const appName = "core"; // Default app name
+        this.generateRequirements(root, options);
+        this.generateManagePy(root, projectName, options);
+        this.generateProjectConfig(root, projectName, options);
+        this.generateApp(root, appName);
+    }
+    generateRequirements(root, options) {
+        this.writeFile(root, "requirements.txt", `
+Django>=4.2.0
+djangorestframework>=3.14.0
+python-dotenv>=1.0.0
+import-linter>=1.10.0
+structlog>=23.1.0
+django-structlog>=5.1.0
+dj-database-url>=2.1.0
+${options.database === 'postgresql' ? 'psycopg2-binary>=2.9.0' : ''}
+${options.database === 'mysql' ? 'mysqlclient>=2.2.0' : ''}
+        `.trim());
+        // .import-linter (Architecture Guardrails)
+        this.writeFile(root, ".import-linter", `
+[importlinter]
+root_package = core
+
+[importlinter:contract:1]
+name = Django App Boundaries
+type = layers
+layers =
+    views
+    models
+containers = core
+        `.trim());
+    }
+    generateManagePy(root, projectName, options) {
+        this.writeFile(root, "manage.py", `
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault('DJANGO_SETTINGS_MODULE', '${projectName}.settings')
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+if __name__ == '__main__':
+    main()
+        `);
+    }
+    generateProjectConfig(root, projectName, options) {
+        const configDir = `${projectName}`; // Django project folder usually has same name as project
+        this.createDir(root, configDir);
+        this.writeFile(root, `${configDir}/__init__.py`, "");
+        this.writeFile(root, `${configDir}/settings.py`, `
+from pathlib import Path
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+SECRET_KEY = 'django-insecure-generated-key'
+DEBUG = True
+ALLOWED_HOSTS = []
+
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'rest_framework',
+    'core',
+]
+
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'django.contrib.messages.middleware.MessageMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+ROOT_URLCONF = '${projectName}.urls'
+
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [],
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                'django.template.context_processors.debug',
+                'django.template.context_processors.request',
+                'django.contrib.auth.context_processors.auth',
+                'django.contrib.messages.context_processors.messages',
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = '${projectName}.wsgi.application'
+
+import os
+import dj_database_url
+
+DATABASES = {
+    'default': dj_database_url.config(
+        default=os.getenv('DATABASE_URL', 'sqlite:///' + str(BASE_DIR / 'db.sqlite3'))
+    )
+}
+
+AUTH_PASSWORD_VALIDATORS = []
+LANGUAGE_CODE = 'en-us'
+TIME_ZONE = 'UTC'
+USE_I18N = True
+USE_TZ = True
+STATIC_URL = 'static/'
+DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
+
+# Logging Configuration
+import structlog
+
+LOGGING = {
+    "version": 1,
+    "disable_existing_loggers": False,
+    "formatters": {
+        "json_formatter": {
+            "()": structlog.stdlib.ProcessorFormatter,
+            "processor": structlog.processors.JSONRenderer(),
+        },
+    },
+    "handlers": {
+        "console": {
+            "class": "logging.StreamHandler",
+            "formatter": "json_formatter",
+        },
+    },
+    "root": {
+        "handlers": ["console"],
+        "level": "INFO",
+    },
+}
+
+structlog.configure(
+    processors=[
+        structlog.contextvars.merge_contextvars,
+        structlog.stdlib.filter_by_level,
+        structlog.processors.TimeStamper(fmt="iso"),
+        structlog.stdlib.add_logger_name,
+        structlog.stdlib.add_log_level,
+        structlog.stdlib.PositionalArgumentsFormatter(),
+        structlog.processors.StackInfoRenderer(),
+        structlog.processors.format_exc_info,
+        structlog.stdlib.ProcessorFormatter.wrap_for_formatter,
+    ],
+    logger_factory=structlog.stdlib.LoggerFactory(),
+    cache_logger_on_first_use=True,
+)
+
+MIDDLEWARE.insert(0, 'django_structlog.middlewares.RequestMiddleware')
+        `);
+        this.writeFile(root, `${configDir}/urls.py`, `
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('api/', include('core.urls')),
+]
+        `);
+        this.writeFile(root, `${configDir}/wsgi.py`, `
+import os
+from django.core.wsgi import get_wsgi_application
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', '${projectName}.settings')
+application = get_wsgi_application()
+        `);
+        this.writeFile(root, `${configDir}/asgi.py`, `
+import os
+from django.core.asgi import get_asgi_application
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', '${projectName}.settings')
+application = get_asgi_application()
+        `);
+    }
+    generateApp(root, appName) {
+        this.createDir(root, appName);
+        this.writeFile(root, `${appName}/__init__.py`, "");
+        this.writeFile(root, `${appName}/admin.py`, "from django.contrib import admin\n# Register your models here.");
+        this.writeFile(root, `${appName}/apps.py`, `
+from django.apps import AppConfig
+class CoreConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = '${appName}'
+        `);
+        this.writeFile(root, `${appName}/models.py`, "from django.db import models\n# Create your models here.");
+        this.writeFile(root, `${appName}/tests.py`, "from django.test import TestCase\n# Create your tests here.");
+        this.writeFile(root, `${appName}/views.py`, `
+from rest_framework.decorators import api_view
+from rest_framework.response import Response
+
+@api_view(['GET'])
+def hello_world(request):
+    return Response({"message": "Hello from Django generated by ArchForge X"})
+        `);
+        this.writeFile(root, `${appName}/urls.py`, `
+from django.urls import path
+from . import views
+
+urlpatterns = [
+    path('hello/', views.hello_world),
+]
+        `);
+    }
+    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" ? "postgres://user:password@db:5432/appdb" :
+            options.database === "mysql" ? "mysql://root:password@db:3306/appdb" :
+                "sqlite:///db.sqlite3";
+        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 ["python", "manage.py", "runserver", "0.0.0.0:8000"]
+        `);
+        this.writeFile(root, "docker-compose.yml", `
+version: '3.8'
+services:
+  app:
+    build: .
+    ports:
+      - "8000:8000"
+    environment:
+      - DEBUG=0
+      - SECRET_KEY=production-secret
+      - 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 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: |
+        # In a real scenario, archforge would be installed
+        echo "Running archforge sync..."
+    - name: Check Architecture Boundaries
+      run: |
+        lint-imports
+    - name: Run Tests
+      run: |
+        python manage.py test
+        `);
+    }
+}
+exports.DjangoGenerator = DjangoGenerator;