aiwf 0.3.17 → 0.3.18

package/templates/api-server/template/package.json

@@ -1,61 +0,0 @@
-{
-  "name": "{{projectName}}",
-  "version": "0.0.1",
-  "description": "AIWF 통합 Express API 서버",
-  "main": "dist/index.js",
-  "scripts": {
-    "dev": "nodemon",
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "lint": "eslint . --ext .ts",
-    "aiwf": "node .aiwf/scripts/cli.js",
-    "aiwf:status": "npm run aiwf status",
-    "aiwf:feature": "npm run aiwf feature",
-    "aiwf:api": "npm run aiwf api"
-  },
-  "keywords": [
-    "api",
-    "express",
-    "typescript",
-    "aiwf"
-  ],
-  "author": "",
-  "license": "MIT",
-  "dependencies": {
-    "express": "^4.18.2",
-    "cors": "^2.8.5",
-    "helmet": "^7.0.0",
-    "compression": "^1.7.4",
-    "dotenv": "^16.3.1",
-    "jsonwebtoken": "^9.0.1",
-    "bcryptjs": "^2.4.3",
-    "express-validator": "^7.0.1",
-    "swagger-jsdoc": "^6.2.8",
-    "swagger-ui-express": "^5.0.0",
-    "winston": "^3.9.0",
-    "express-rate-limit": "^6.8.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.17",
-    "@types/node": "^20.0.0",
-    "@types/cors": "^2.8.13",
-    "@types/compression": "^1.7.2",
-    "@types/jsonwebtoken": "^9.0.2",
-    "@types/bcryptjs": "^2.4.2",
-    "@types/swagger-jsdoc": "^6.0.1",
-    "@types/swagger-ui-express": "^4.1.3",
-    "@typescript-eslint/eslint-plugin": "^5.60.0",
-    "@typescript-eslint/parser": "^5.60.0",
-    "typescript": "^5.1.0",
-    "ts-node": "^10.9.0",
-    "nodemon": "^3.0.0",
-    "eslint": "^8.43.0",
-    "jest": "^29.5.0",
-    "@types/jest": "^29.5.0",
-    "ts-jest": "^29.1.0",
-    "supertest": "^6.3.0",
-    "@types/supertest": "^2.0.12"
-  }
-}

package/templates/api-server/template/src/app.ts

@@ -1,60 +0,0 @@
-import express, { Application } from 'express';
-import cors from 'cors';
-import helmet from 'helmet';
-import compression from 'compression';
-import rateLimit from 'express-rate-limit';
-import swaggerUi from 'swagger-ui-express';
-import { swaggerSpec } from '@config/swagger';
-import { errorHandler } from '@middleware/errorHandler';
-import { notFoundHandler } from '@middleware/notFoundHandler';
-import { requestLogger } from '@middleware/requestLogger';
-import { aiwfMiddleware } from '@middleware/aiwfMiddleware';
-import routes from '@routes/index';
-
-const app: Application = express();
-
-// Security middleware
-app.use(helmet());
-app.use(cors());
-
-// Rate limiting
-const limiter = rateLimit({
-  windowMs: parseInt(process.env.RATE_LIMIT_WINDOW_MS || '900000'),
-  max: parseInt(process.env.RATE_LIMIT_MAX_REQUESTS || '100'),
-  message: 'Too many requests from this IP, please try again later.',
-});
-app.use('/api', limiter);
-
-// Body parsing middleware
-app.use(express.json({ limit: '10mb' }));
-app.use(express.urlencoded({ extended: true, limit: '10mb' }));
-
-// Compression middleware
-app.use(compression());
-
-// Request logging
-app.use(requestLogger);
-
-// AIWF integration
-app.use(aiwfMiddleware);
-
-// API Documentation
-app.use('/docs', swaggerUi.serve, swaggerUi.setup(swaggerSpec));
-
-// Health check
-app.get('/health', (req, res) => {
-  res.status(200).json({
-    status: 'healthy',
-    timestamp: new Date().toISOString(),
-    uptime: process.uptime(),
-  });
-});
-
-// API routes
-app.use('/api', routes);
-
-// Error handlers
-app.use(notFoundHandler);
-app.use(errorHandler);
-
-export default app;

package/templates/api-server/template/src/config/swagger.ts

@@ -1,38 +0,0 @@
-import swaggerJsdoc from 'swagger-jsdoc';
-import { version } from '../../package.json';
-
-const options: swaggerJsdoc.Options = {
-  definition: {
-    openapi: '3.0.0',
-    info: {
-      title: '{{projectName}} API',
-      version,
-      description: 'AIWF 통합 Express API 서버',
-      contact: {
-        name: 'API Support',
-        email: 'support@example.com',
-      },
-    },
-    servers: [
-      {
-        url: `http://localhost:${process.env.PORT || 3000}`,
-        description: 'Development server',
-      },
-    ],
-    components: {
-      securitySchemes: {
-        bearerAuth: {
-          type: 'http',
-          scheme: 'bearer',
-          bearerFormat: 'JWT',
-        },
-      },
-    },
-    security: [{
-      bearerAuth: [],
-    }],
-  },
-  apis: ['./src/routes/**/*.ts', './src/models/**/*.ts'],
-};
-
-export const swaggerSpec = swaggerJsdoc(options);

package/templates/api-server/template/src/controllers/aiwfController.ts

@@ -1,54 +0,0 @@
-import { Request, Response, NextFunction } from 'express';
-import fs from 'fs/promises';
-import path from 'path';
-
-export const aiwfController = {
-
-  getTokenUsage: async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      // 실제 구현에서는 토큰 사용량을 추적하는 로직 필요
-      const mockData = {
-        total: parseInt(process.env.AIWF_TOKEN_LIMIT || '100000'),
-        used: 45000,
-        remaining: 55000,
-        percentage: 45,
-        history: [
-          {
-            date: new Date().toISOString(),
-            tokens: 1500,
-            action: 'API endpoint creation',
-            endpoint: 'POST /api/v1/users',
-          },
-        ],
-      };
-
-      res.json({
-        success: true,
-        data: mockData,
-      });
-    } catch (error) {
-      next(error);
-    }
-  },
-
-  getContextStatus: async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const configPath = path.join(process.cwd(), '.aiwf', 'config.json');
-      const configData = await fs.readFile(configPath, 'utf-8');
-      const config = JSON.parse(configData);
-
-      res.json({
-        success: true,
-        data: {
-          compressionLevel: config.features.context_compression.level,
-          cacheEnabled: config.features.context_compression.cache_enabled,
-          tokenLimit: config.features.context_compression.token_limit,
-          activePersona: config.features.ai_persona.default,
-          availablePersonas: config.features.ai_persona.available,
-        },
-      });
-    } catch (error) {
-      next(error);
-    }
-  },
-};

package/templates/api-server/template/src/controllers/authController.ts

@@ -1,128 +0,0 @@
-import { Request, Response, NextFunction } from 'express';
-import { validationResult } from 'express-validator';
-import bcrypt from 'bcryptjs';
-import jwt from 'jsonwebtoken';
-
-interface User {
-  id: string;
-  email: string;
-  password: string;
-  name: string;
-}
-
-// 임시 메모리 저장소 (실제로는 데이터베이스 사용)
-const users: User[] = [];
-
-export const authController = {
-  register: async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const errors = validationResult(req);
-      if (!errors.isEmpty()) {
-        return res.status(400).json({ 
-          success: false, 
-          errors: errors.array() 
-        });
-      }
-
-      const { email, password, name } = req.body;
-
-      // 중복 체크
-      const existingUser = users.find(u => u.email === email);
-      if (existingUser) {
-        return res.status(409).json({
-          success: false,
-          error: { message: 'Email already exists' }
-        });
-      }
-
-      // 비밀번호 해싱
-      const hashedPassword = await bcrypt.hash(
-        password, 
-        parseInt(process.env.BCRYPT_ROUNDS || '10')
-      );
-
-      // 사용자 생성
-      const newUser: User = {
-        id: Date.now().toString(),
-        email,
-        password: hashedPassword,
-        name,
-      };
-      users.push(newUser);
-
-      // JWT 토큰 생성
-      const token = jwt.sign(
-        { id: newUser.id, email: newUser.email },
-        process.env.JWT_SECRET || 'secret',
-        { expiresIn: process.env.JWT_EXPIRES_IN || '7d' }
-      );
-
-      res.status(201).json({
-        success: true,
-        data: {
-          user: {
-            id: newUser.id,
-            email: newUser.email,
-            name: newUser.name,
-          },
-          token,
-        },
-      });
-    } catch (error) {
-      next(error);
-    }
-  },
-
-  login: async (req: Request, res: Response, next: NextFunction) => {
-    try {
-      const errors = validationResult(req);
-      if (!errors.isEmpty()) {
-        return res.status(400).json({ 
-          success: false, 
-          errors: errors.array() 
-        });
-      }
-
-      const { email, password } = req.body;
-
-      // 사용자 찾기
-      const user = users.find(u => u.email === email);
-      if (!user) {
-        return res.status(401).json({
-          success: false,
-          error: { message: 'Invalid credentials' }
-        });
-      }
-
-      // 비밀번호 확인
-      const isPasswordValid = await bcrypt.compare(password, user.password);
-      if (!isPasswordValid) {
-        return res.status(401).json({
-          success: false,
-          error: { message: 'Invalid credentials' }
-        });
-      }
-
-      // JWT 토큰 생성
-      const token = jwt.sign(
-        { id: user.id, email: user.email },
-        process.env.JWT_SECRET || 'secret',
-        { expiresIn: process.env.JWT_EXPIRES_IN || '7d' }
-      );
-
-      res.json({
-        success: true,
-        data: {
-          user: {
-            id: user.id,
-            email: user.email,
-            name: user.name,
-          },
-          token,
-        },
-      });
-    } catch (error) {
-      next(error);
-    }
-  },
-};

package/templates/api-server/template/src/controllers/statusController.ts

@@ -1,28 +0,0 @@
-import { Request, Response } from 'express';
-import os from 'os';
-
-export const statusController = {
-  getStatus: (req: Request, res: Response) => {
-    res.json({
-      success: true,
-      data: {
-        service: '{{projectName}}',
-        version: process.env.npm_package_version || '0.0.1',
-        environment: process.env.NODE_ENV || 'development',
-        uptime: process.uptime(),
-        timestamp: new Date().toISOString(),
-        system: {
-          platform: os.platform(),
-          release: os.release(),
-          totalMemory: os.totalmem(),
-          freeMemory: os.freemem(),
-          cpus: os.cpus().length,
-        },
-        aiwf: {
-          enabled: process.env.AIWF_ENABLED === 'true',
-          compressionLevel: process.env.AIWF_COMPRESSION_LEVEL || 'balanced',
-        },
-      },
-    });
-  },
-};

package/templates/api-server/template/src/index.ts

@@ -1,28 +0,0 @@
-import 'dotenv/config';
-import app from './app';
-import logger from '@utils/logger';
-
-const PORT = process.env.PORT || 3000;
-const HOST = process.env.HOST || 'localhost';
-
-const server = app.listen(PORT, () => {
-  logger.info(`🚀 Server is running on http://${HOST}:${PORT}`);
-  logger.info(`📚 API Documentation available at http://${HOST}:${PORT}/docs`);
-  logger.info(`🤖 AIWF Integration enabled`);
-});
-
-// Graceful shutdown
-process.on('SIGTERM', () => {
-  logger.info('SIGTERM signal received: closing HTTP server');
-  server.close(() => {
-    logger.info('HTTP server closed');
-    process.exit(0);
-  });
-});
-
-process.on('unhandledRejection', (reason, promise) => {
-  logger.error('Unhandled Rejection at:', promise, 'reason:', reason);
-  // Application specific logging, throwing an error, or other logic here
-});
-
-export default server;

package/templates/api-server/template/src/middleware/aiwfMiddleware.ts

@@ -1,50 +0,0 @@
-import { Request, Response, NextFunction } from 'express';
-import fs from 'fs/promises';
-import path from 'path';
-
-interface AiwfRequest extends Request {
-  aiwf?: {
-    featureId?: string;
-    persona?: string;
-    tokenUsage?: number;
-  };
-}
-
-export const aiwfMiddleware = async (
-  req: AiwfRequest,
-  res: Response,
-  next: NextFunction
-) => {
-  // AIWF 헤더 체크
-  const featureId = req.headers['x-aiwf-feature-id'] as string;
-  const persona = req.headers['x-aiwf-persona'] as string;
-
-  req.aiwf = {
-    featureId,
-    persona: persona || 'backend-engineer',
-    tokenUsage: 0,
-  };
-
-  // Feature 추적
-  if (featureId && process.env.AIWF_ENABLED === 'true') {
-    try {
-      const ledgerPath = path.join(process.cwd(), '.aiwf', 'feature-ledger.json');
-      const ledgerData = await fs.readFile(ledgerPath, 'utf-8');
-      const ledger = JSON.parse(ledgerData);
-      
-      // API 엔드포인트 추적 로직
-      const endpoint = `${req.method} ${req.route?.path || req.path}`;
-      const feature = ledger.features.find((f: any) => f.id === featureId);
-      
-      if (feature && !feature.endpoints?.includes(endpoint)) {
-        feature.endpoints = feature.endpoints || [];
-        feature.endpoints.push(endpoint);
-        await fs.writeFile(ledgerPath, JSON.stringify(ledger, null, 2));
-      }
-    } catch (error) {
-      // 에러 무시 (AIWF 기능이 없어도 API는 동작해야 함)
-    }
-  }
-
-  next();
-};

package/templates/api-server/template/src/middleware/authMiddleware.ts

@@ -1,41 +0,0 @@
-import { Request, Response, NextFunction } from 'express';
-import jwt from 'jsonwebtoken';
-
-interface AuthRequest extends Request {
-  user?: {
-    id: string;
-    email: string;
-  };
-}
-
-export const authMiddleware = (
-  req: AuthRequest,
-  res: Response,
-  next: NextFunction
-) => {
-  const authHeader = req.headers.authorization;
-
-  if (!authHeader || !authHeader.startsWith('Bearer ')) {
-    return res.status(401).json({
-      success: false,
-      error: { message: 'No token provided' }
-    });
-  }
-
-  const token = authHeader.substring(7);
-
-  try {
-    const decoded = jwt.verify(
-      token,
-      process.env.JWT_SECRET || 'secret'
-    ) as { id: string; email: string };
-
-    req.user = decoded;
-    next();
-  } catch (error) {
-    return res.status(401).json({
-      success: false,
-      error: { message: 'Invalid token' }
-    });
-  }
-};

package/templates/api-server/template/src/middleware/errorHandler.ts

@@ -1,42 +0,0 @@
-import { Request, Response, NextFunction } from 'express';
-import logger from '@utils/logger';
-
-interface CustomError extends Error {
-  statusCode?: number;
-  status?: string;
-  isOperational?: boolean;
-}
-
-export const errorHandler = (
-  err: CustomError,
-  req: Request,
-  res: Response,
-  next: NextFunction
-) => {
-  let { statusCode = 500, message } = err;
-
-  logger.error({
-    error: err,
-    request: {
-      method: req.method,
-      url: req.url,
-      headers: req.headers,
-      body: req.body,
-    },
-  });
-
-  // Don't leak error details in production
-  if (process.env.NODE_ENV === 'production' && statusCode === 500) {
-    message = 'Internal Server Error';
-  }
-
-  res.status(statusCode).json({
-    success: false,
-    error: {
-      statusCode,
-      message,
-      ...(process.env.NODE_ENV === 'development' && { stack: err.stack }),
-    },
-    timestamp: new Date().toISOString(),
-  });
-};

package/templates/api-server/template/src/middleware/notFoundHandler.ts

@@ -1,14 +0,0 @@
-import { Request, Response } from 'express';
-
-export const notFoundHandler = (req: Request, res: Response) => {
-  res.status(404).json({
-    success: false,
-    error: {
-      statusCode: 404,
-      message: 'Resource not found',
-      path: req.url,
-      method: req.method,
-    },
-    timestamp: new Date().toISOString(),
-  });
-};

package/templates/api-server/template/src/middleware/requestLogger.ts

@@ -1,20 +0,0 @@
-import { Request, Response, NextFunction } from 'express';
-import logger from '@utils/logger';
-
-export const requestLogger = (req: Request, res: Response, next: NextFunction) => {
-  const start = Date.now();
-
-  res.on('finish', () => {
-    const duration = Date.now() - start;
-    logger.info({
-      method: req.method,
-      url: req.url,
-      status: res.statusCode,
-      duration: `${duration}ms`,
-      ip: req.ip,
-      userAgent: req.get('user-agent'),
-    });
-  });
-
-  next();
-};

package/templates/api-server/template/src/routes/aiwf.ts

@@ -1,31 +0,0 @@
-import { Router } from 'express';
-import { aiwfController } from '@controllers/aiwfController';
-
-const router = Router();
-
-
-/**
- * @swagger
- * /api/aiwf/token-usage:
- *   get:
- *     summary: 토큰 사용량 조회
- *     tags: [AIWF]
- *     responses:
- *       200:
- *         description: 토큰 사용 현황
- */
-router.get('/token-usage', aiwfController.getTokenUsage);
-
-/**
- * @swagger
- * /api/aiwf/context:
- *   get:
- *     summary: Context 상태 조회
- *     tags: [AIWF]
- *     responses:
- *       200:
- *         description: Context 압축 상태
- */
-router.get('/context', aiwfController.getContextStatus);
-
-export default router;

package/templates/api-server/template/src/routes/index.ts

@@ -1,13 +0,0 @@
-import { Router } from 'express';
-import v1Routes from './v1';
-import aiwfRoutes from './aiwf';
-
-const router = Router();
-
-// API 버전 라우팅
-router.use('/v1', v1Routes);
-
-// AIWF 전용 라우트
-router.use('/aiwf', aiwfRoutes);
-
-export default router;

package/templates/api-server/template/src/routes/v1/index.ts

@@ -1,67 +0,0 @@
-import { Router } from 'express';
-import { statusController } from '@controllers/statusController';
-import { authController } from '@controllers/authController';
-import { authMiddleware } from '@middleware/authMiddleware';
-
-const router = Router();
-
-/**
- * @swagger
- * /api/v1/status:
- *   get:
- *     summary: API 상태 확인
- *     tags: [Status]
- *     responses:
- *       200:
- *         description: API 상태 정보
- */
-router.get('/status', statusController.getStatus);
-
-/**
- * @swagger
- * /api/v1/auth/register:
- *   post:
- *     summary: 사용자 등록
- *     tags: [Auth]
- *     requestBody:
- *       required: true
- *       content:
- *         application/json:
- *           schema:
- *             type: object
- *             properties:
- *               email:
- *                 type: string
- *               password:
- *                 type: string
- *               name:
- *                 type: string
- */
-router.post('/auth/register', authController.register);
-
-/**
- * @swagger
- * /api/v1/auth/login:
- *   post:
- *     summary: 사용자 로그인
- *     tags: [Auth]
- *     requestBody:
- *       required: true
- *       content:
- *         application/json:
- *           schema:
- *             type: object
- *             properties:
- *               email:
- *                 type: string
- *               password:
- *                 type: string
- */
-router.post('/auth/login', authController.login);
-
-// Protected routes example
-router.get('/protected', authMiddleware, (req, res) => {
-  res.json({ message: 'This is a protected route' });
-});
-
-export default router;