fragment-ts 1.0.0

package/dist/core/openai/openai-client.js

@@ -0,0 +1,93 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIClient = void 0;
+const injectable_decorator_1 = require("../decorators/injectable.decorator");
+const config_loader_1 = require("../config/config-loader");
+let OpenAIClient = class OpenAIClient {
+    constructor() {
+        this.baseURL = "https://api.openai.com/v1";
+        const config = config_loader_1.ConfigLoader.get();
+        this.apiKey = config.openai.apiKey;
+        this.model = config.openai.model;
+    }
+    async complete(prompt, options) {
+        const response = await fetch(`${this.baseURL}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: options?.model || this.model,
+                messages: [{ role: "user", content: prompt }],
+                max_tokens: options?.maxTokens || 1000,
+                temperature: options?.temperature || 0.7,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`OpenAI API error: ${response.statusText}`);
+        }
+        const data = (await response.json());
+        return data.choices[0].message.content;
+    }
+    async streamComplete(prompt, onChunk) {
+        const response = await fetch(`${this.baseURL}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.model,
+                messages: [{ role: "user", content: prompt }],
+                stream: true,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`OpenAI API error: ${response.statusText}`);
+        }
+        const reader = response.body?.getReader();
+        const decoder = new TextDecoder();
+        if (!reader) {
+            throw new Error("No response body");
+        }
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const chunk = decoder.decode(value);
+            const lines = chunk.split("\n").filter((line) => line.trim() !== "");
+            for (const line of lines) {
+                if (line.startsWith("data: ")) {
+                    const data = line.slice(6);
+                    if (data === "[DONE]")
+                        continue;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const content = parsed.choices[0]?.delta?.content;
+                        if (content) {
+                            onChunk(content);
+                        }
+                    }
+                    catch (e) {
+                        // Skip invalid JSON
+                    }
+                }
+            }
+        }
+    }
+};
+exports.OpenAIClient = OpenAIClient;
+exports.OpenAIClient = OpenAIClient = __decorate([
+    (0, injectable_decorator_1.Injectable)(),
+    __metadata("design:paramtypes", [])
+], OpenAIClient);

package/dist/database/data-source.d.ts

@@ -0,0 +1,4 @@
+import { DataSource } from 'typeorm';
+declare let AppDataSource: DataSource;
+export declare function initializeDataSource(): DataSource;
+export { AppDataSource };

package/dist/database/data-source.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppDataSource = void 0;
+exports.initializeDataSource = initializeDataSource;
+const typeorm_1 = require("typeorm");
+const config_loader_1 = require("../core/config/config-loader");
+const user_entity_1 = require("../entities/user.entity");
+const session_entity_1 = require("../entities/session.entity");
+let AppDataSource;
+function initializeDataSource() {
+    const config = config_loader_1.ConfigLoader.get();
+    exports.AppDataSource = AppDataSource = new typeorm_1.DataSource({
+        type: config.database.type,
+        host: config.database.host,
+        port: config.database.port,
+        username: config.database.username,
+        password: config.database.password,
+        database: config.database.database,
+        synchronize: config.database.synchronize,
+        logging: config.database.logging,
+        entities: [user_entity_1.User, session_entity_1.Session],
+        migrations: [],
+        subscribers: []
+    });
+    return AppDataSource;
+}

package/dist/entities/session.entity.d.ts

@@ -0,0 +1,9 @@
+import { User } from './user.entity';
+export declare class Session {
+    id: number;
+    token: string;
+    userId: number;
+    user: User;
+    expiresAt: Date;
+    createdAt: Date;
+}

package/dist/entities/session.entity.js

@@ -0,0 +1,45 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Session = void 0;
+const typeorm_1 = require("typeorm");
+const user_entity_1 = require("./user.entity");
+let Session = class Session {
+};
+exports.Session = Session;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)(),
+    __metadata("design:type", Number)
+], Session.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ unique: true, length: 255 }),
+    __metadata("design:type", String)
+], Session.prototype, "token", void 0);
+__decorate([
+    (0, typeorm_1.Column)(),
+    __metadata("design:type", Number)
+], Session.prototype, "userId", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => user_entity_1.User, (user) => user.sessions, { onDelete: 'CASCADE' }),
+    (0, typeorm_1.JoinColumn)({ name: 'userId' }),
+    __metadata("design:type", user_entity_1.User)
+], Session.prototype, "user", void 0);
+__decorate([
+    (0, typeorm_1.Column)(),
+    __metadata("design:type", Date)
+], Session.prototype, "expiresAt", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    __metadata("design:type", Date)
+], Session.prototype, "createdAt", void 0);
+exports.Session = Session = __decorate([
+    (0, typeorm_1.Entity)('sessions')
+], Session);

package/dist/entities/user.entity.d.ts

@@ -0,0 +1,10 @@
+import { Session } from './session.entity';
+export declare class User {
+    id: number;
+    name: string;
+    email: string;
+    passwordHash: string;
+    sessions: Session[];
+    createdAt: Date;
+    updatedAt: Date;
+}

package/dist/entities/user.entity.js

@@ -0,0 +1,48 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.User = void 0;
+const typeorm_1 = require("typeorm");
+const session_entity_1 = require("./session.entity");
+let User = class User {
+};
+exports.User = User;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)(),
+    __metadata("design:type", Number)
+], User.prototype, "id", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 100 }),
+    __metadata("design:type", String)
+], User.prototype, "name", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ unique: true, length: 255 }),
+    __metadata("design:type", String)
+], User.prototype, "email", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ length: 255 }),
+    __metadata("design:type", String)
+], User.prototype, "passwordHash", void 0);
+__decorate([
+    (0, typeorm_1.OneToMany)(() => session_entity_1.Session, (session) => session.user),
+    __metadata("design:type", Array)
+], User.prototype, "sessions", void 0);
+__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    __metadata("design:type", Date)
+], User.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    __metadata("design:type", Date)
+], User.prototype, "updatedAt", void 0);
+exports.User = User = __decorate([
+    (0, typeorm_1.Entity)('users')
+], User);

package/dist/middlewares/logging.middleware.d.ts

@@ -0,0 +1,2 @@
+import { Request, Response, NextFunction } from 'express';
+export declare function loggingMiddleware(req: Request, res: Response, next: NextFunction): void;

package/dist/middlewares/logging.middleware.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loggingMiddleware = loggingMiddleware;
+const pino_1 = __importDefault(require("pino"));
+const logger = (0, pino_1.default)({
+    transport: {
+        target: 'pino-pretty',
+        options: {
+            colorize: true
+        }
+    }
+});
+function loggingMiddleware(req, res, next) {
+    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`
+        });
+    });
+    next();
+}

package/dist/repositories/session.repository.d.ts

@@ -0,0 +1,9 @@
+import { Session } from '../entities/session.entity';
+export declare class SessionRepository {
+    private repository;
+    constructor();
+    findByToken(token: string): Promise<Session | null>;
+    create(sessionData: Partial<Session>): Promise<Session>;
+    deleteByToken(token: string): Promise<boolean>;
+    deleteExpired(): Promise<void>;
+}

package/dist/repositories/session.repository.js

@@ -0,0 +1,50 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionRepository = void 0;
+const typeorm_1 = require("typeorm");
+const repository_decorator_1 = require("../core/decorators/repository.decorator");
+const session_entity_1 = require("../entities/session.entity");
+const data_source_1 = require("../database/data-source");
+let SessionRepository = class SessionRepository {
+    constructor() {
+        this.repository = data_source_1.AppDataSource.getRepository(session_entity_1.Session);
+    }
+    async findByToken(token) {
+        return await this.repository.findOne({
+            where: {
+                token,
+                expiresAt: (0, typeorm_1.MoreThan)(new Date())
+            },
+            relations: ['user']
+        });
+    }
+    async create(sessionData) {
+        const session = this.repository.create(sessionData);
+        return await this.repository.save(session);
+    }
+    async deleteByToken(token) {
+        const result = await this.repository.delete({ token });
+        return result.affected ? result.affected > 0 : false;
+    }
+    async deleteExpired() {
+        await this.repository
+            .createQueryBuilder()
+            .delete()
+            .where('expiresAt < :now', { now: new Date() })
+            .execute();
+    }
+};
+exports.SessionRepository = SessionRepository;
+exports.SessionRepository = SessionRepository = __decorate([
+    (0, repository_decorator_1.Repository)(),
+    __metadata("design:paramtypes", [])
+], SessionRepository);

package/dist/repositories/user.repository.d.ts

@@ -0,0 +1,10 @@
+import { User } from '../entities/user.entity';
+export declare class UserRepository {
+    private repository;
+    constructor();
+    findById(id: number): Promise<User | null>;
+    findByEmail(email: string): Promise<User | null>;
+    create(userData: Partial<User>): Promise<User>;
+    update(id: number, userData: Partial<User>): Promise<User | null>;
+    delete(id: number): Promise<boolean>;
+}

package/dist/repositories/user.repository.js

@@ -0,0 +1,43 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserRepository = void 0;
+const repository_decorator_1 = require("../core/decorators/repository.decorator");
+const user_entity_1 = require("../entities/user.entity");
+const data_source_1 = require("../database/data-source");
+let UserRepository = class UserRepository {
+    constructor() {
+        this.repository = data_source_1.AppDataSource.getRepository(user_entity_1.User);
+    }
+    async findById(id) {
+        return await this.repository.findOne({ where: { id } });
+    }
+    async findByEmail(email) {
+        return await this.repository.findOne({ where: { email } });
+    }
+    async create(userData) {
+        const user = this.repository.create(userData);
+        return await this.repository.save(user);
+    }
+    async update(id, userData) {
+        await this.repository.update(id, userData);
+        return await this.findById(id);
+    }
+    async delete(id) {
+        const result = await this.repository.delete(id);
+        return result.affected ? result.affected > 0 : false;
+    }
+};
+exports.UserRepository = UserRepository;
+exports.UserRepository = UserRepository = __decorate([
+    (0, repository_decorator_1.Repository)(),
+    __metadata("design:paramtypes", [])
+], UserRepository);

package/dist/server.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const app_1 = require("./app");
+const config_loader_1 = require("./core/config/config-loader");
+async function bootstrap() {
+    try {
+        const app = new app_1.FragmentApplication();
+        await app.initialize();
+        const config = config_loader_1.ConfigLoader.get();
+        const port = config.app.port;
+        app.getExpressApp().listen(port, () => {
+            console.log(`
+╔═══════════════════════════════════════════════════╗
+║                                                   ║
+║      🔷 FRAGMENT Framework Started               ║
+║                                                   ║
+║      Port: ${port}                                  ║
+║      Environment: ${config.app.env}                  ║
+║      Database: Connected                         ║
+║                                                   ║
+╚═══════════════════════════════════════════════════╝
+      `);
+        });
+    }
+    catch (error) {
+        console.error('❌ Failed to start application:', error);
+        process.exit(1);
+    }
+}
+bootstrap();

package/dist/services/health.service.d.ts

@@ -0,0 +1,13 @@
+import { OpenAIClient } from '../core/openai/openai-client';
+export declare class HealthService {
+    private openAIClient;
+    constructor(openAIClient: OpenAIClient);
+    getStatus(): Promise<{
+        status: string;
+        timestamp: string;
+        database: string;
+    }>;
+    generateHealthTip(): Promise<{
+        tip: string;
+    }>;
+}

package/dist/services/health.service.js

@@ -0,0 +1,44 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthService = void 0;
+const service_decorator_1 = require("../core/decorators/service.decorator");
+const autowire_decorator_1 = require("../core/decorators/autowire.decorator");
+const openai_client_1 = require("../core/openai/openai-client");
+let HealthService = class HealthService {
+    constructor(openAIClient) {
+        this.openAIClient = openAIClient;
+    }
+    async getStatus() {
+        return {
+            status: 'ok',
+            timestamp: new Date().toISOString(),
+            database: 'connected'
+        };
+    }
+    async generateHealthTip() {
+        const prompt = 'Give me a short health tip in one sentence.';
+        const tip = await this.openAIClient.complete(prompt, {
+            maxTokens: 50,
+            temperature: 0.9
+        });
+        return { tip };
+    }
+};
+exports.HealthService = HealthService;
+exports.HealthService = HealthService = __decorate([
+    (0, service_decorator_1.Service)(),
+    __param(0, (0, autowire_decorator_1.Autowire)()),
+    __metadata("design:paramtypes", [openai_client_1.OpenAIClient])
+], HealthService);

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "fragment-ts",
+  "version": "1.0.0",
+  "description": "TypeScript Backend Framework (v1.0.0)",
+  "main": "dist/server.js",
+  "bin": {
+    "fragment": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "dev": "ts-node-dev --respawn --transpile-only src/server.ts",
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "cli": "ts-node src/cli/index.ts"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "typeorm": "^0.3.17",
+    "pg": "^8.11.3",
+    "mysql2": "^3.6.0",
+    "sqlite3": "^5.1.6",
+    "dotenv": "^16.3.1",
+    "pino": "^8.15.0",
+    "pino-pretty": "^10.2.0",
+    "reflect-metadata": "^0.1.13",
+    "commander": "^11.0.0",
+    "inquirer": "^9.2.11",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "js-yaml": "^4.1.0",
+    "@anthropic-ai/sdk": "^0.9.0",
+    "openai": "^4.20.0",
+    "axios": "^1.6.0",
+    "bcrypt": "^5.1.1"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.17",
+    "@types/node": "^20.5.0",
+    "@types/inquirer": "^9.0.3",
+    "@types/js-yaml": "^4.0.5",
+    "@types/bcrypt": "^5.0.0",
+    "@types/jsonwebtoken": "^9.0.3",
+    "ts-node-dev": "^2.0.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.1.6"
+  }
+}

package/readme.md

@@ -0,0 +1,120 @@
+#### **Project Initialization**
+```bash
+frg init my-app              # Create new project with wizard
+frg init                     # Interactive mode
+```
+Features:
+- Database selection (PostgreSQL/MySQL/SQLite/MongoDB)
+- Optional OpenAI integration
+- Optional authentication system
+- Package manager choice (npm/yarn/pnpm)
+- Automatic dependency installation
+
+#### **Code Generation**
+```bash
+frg generate controller User      # Generate controller
+frg g c User                      # Short alias
+
+frg generate service User         # Generate service
+frg g s User                      # Short alias
+
+frg generate repository User      # Generate repository
+frg g r User                      # Short alias
+
+frg generate entity User          # Generate entity
+frg g e User                      # Short alias
+
+frg generate resource Product     # Generate everything at once!
+frg g res Product                 # Controller + Service + Repository + Entity
+```
+
+#### **Configuration Management**
+```bash
+frg config ai                # Configure OpenAI (interactive)
+frg config db                # Configure database (interactive)
+frg config show              # Display current configuration
+```
+
+#### **Development**
+```bash
+frg serve                    # Start dev server with hot-reload
+frg dev                      # Alias
+frg serve --port 8080        # Custom port
+frg serve --no-watch         # Disable auto-restart
+```
+
+#### **Production**
+```bash
+frg build                    # Build for production
+```
+
+#### **Database Migrations**
+```bash
+frg migrate run              # Run pending migrations
+frg migrate generate         # Create new migration
+frg migrate revert           # Revert last migration
+frg migrate show             # Migration status
+```
+
+### **🎨 CLI Features:**
+
+1. **Beautiful ASCII Art** - Fragment logo on startup
+2. **Color-Coded Output** - Success (green), errors (red), info (blue)
+3. **Progress Spinners** - Visual feedback for long operations
+4. **Interactive Prompts** - inquirer.js powered wizards
+5. **Validation** - Input validation with helpful messages
+6. **Smart Templates** - Auto-generates boilerplate code
+7. **Configuration Boxes** - Formatted output tables
+8. **Error Handling** - Graceful failures with helpful messages
+
+### **📦 Template System:**
+
+All generators use smart templates that:
+- Auto-inject dependencies via `@Autowire()`
+- Follow naming conventions
+- Include CRUD operations
+- Are fully typed with TypeScript
+- Follow Fragment patterns
+
+### **🚀 Example Workflow:**
+
+```bash
+# Initialize new project
+frg init my-blog-api
+  ✓ Select PostgreSQL
+  ✓ Enable OpenAI
+  ✓ Include auth system
+
+# Configure OpenAI
+frg config ai
+  ✓ Enter API key
+  ✓ Select model
+
+# Generate complete resource
+frg generate resource Post
+  ✓ Creates controller, service, repository, entity
+  ✓ Sets up routes at /api/posts
+
+# Start server
+frg serve
+  🔷 Fragment Framework Started
+  📍 Routes registered
+  ✓ Ready on port 3000
+```
+
+### **Project Structure:**
+```
+my-fragment-app/
+├── bin/frg.ts                    # CLI entry point
+├── src/
+│   ├── cli/                      # CLI commands & utils
+│   ├── core/                     # Framework core
+│   ├── controllers/              # HTTP controllers
+│   ├── services/                 # Business logic
+│   ├── repositories/             # Data access
+│   ├── entities/                 # TypeORM entities
+│   └── app.ts                    # FragmentApplication
+├── config/
+│   └── fragment.yaml             # Configuration
+└── package.json
+```