kybernus 1.0.0

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "kybernus",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "The Ultimate Scaffolding CLI for Modern Developers",
+  "main": "dist/index.js",
+  "bin": {
+    "kybernus": "dist/index.js"
+  },
+  "scripts": {
+    "build": "rimraf dist && tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "validate:templates": "tsx scripts/validate-templates.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "scaffolding",
+    "boilerplate",
+    "generator",
+    "nextjs",
+    "java",
+    "spring-boot",
+    "nodejs",
+    "fastapi",
+    "nestjs",
+    "clean-architecture",
+    "hexagonal-architecture",
+    "devops",
+    "infrastructure"
+  ],
+  "author": "Vinit Revisan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vinitrevisan/kybernus"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "@google/genai": "^1.37.0",
+    "commander": "^14.0.2",
+    "conf": "^15.0.2",
+    "fs-extra": "^11.3.3",
+    "handlebars": "^4.7.8"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.0.9",
+    "rimraf": "^6.1.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  }
+}

package/templates/java-spring/free/mvc/.gitignore.hbs

@@ -0,0 +1,39 @@
+HELP.md
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/
+
+### Logs ###
+*.log
+
+### Environment ###
+.env

package/templates/java-spring/free/mvc/README.md.hbs

@@ -0,0 +1,116 @@
+# {{pascalCase projectName}}
+
+> Generated by [Kybernus CLI](https://kibernus.dev) 🚀
+
+REST API built with **Spring Boot 3.4**, **Java 21**, and **MVC architecture**.
+
+## 📋 Prerequisites
+
+- **Java** 21+
+- **Maven** 3.9+
+- **Docker** (optional, for database)
+
+## 🚀 Quick Start
+
+### 1. Start Database (Optional)
+
+```bash
+docker-compose up -d
+```
+
+This will start a PostgreSQL database on port `5432`.
+
+### 2. Run the Application
+
+```bash
+./mvnw spring-boot:run
+```
+
+Or with Maven:
+
+```bash
+mvn spring-boot:run
+```
+
+Server will start on **http://localhost:8080**
+
+## 📁 Project Structure
+
+```
+src/main/java/{{packagePath}}/
+├── {{pascalCase projectName}}Application.java  # Entry point
+├── controller/                                  # REST Controllers
+│   └── HealthController.java
+├── service/                                     # Business logic
+├── model/                                       # JPA Entities
+├── repository/                                  # Data access
+└── config/                                      # Configuration
+    ├── WebConfig.java
+    └── GlobalExceptionHandler.java
+```
+
+## 🏗️ Architecture
+
+This project follows the **MVC (Model-View-Controller)** architecture:
+
+- **Model**: JPA entities in `model/` package
+- **Controller**: REST endpoints in `controller/` package
+- **Service**: Business logic in `service/` package
+- **Repository**: Data access with Spring Data JPA
+
+## 🧪 API Endpoints
+
+### Health Check
+```http
+GET /api/health
+```
+
+**Response:**
+```json
+{
+  "status": "ok",
+  "message": "{{pascalCase projectName}} API is running",
+  "timestamp": "2026-01-15T22:00:00Z",
+  "uptime": 123
+}
+```
+
+### H2 Console (Development)
+```http
+GET /h2-console
+```
+
+## 🔧 Available Commands
+
+- `./mvnw spring-boot:run` - Run in development mode
+- `./mvnw clean package` - Build JAR
+- `./mvnw test` - Run tests
+- `java -jar target/*.jar` - Run production JAR
+
+## 🐳 Docker
+
+Start the PostgreSQL database:
+
+```bash
+docker-compose up -d
+```
+
+Stop the database:
+
+```bash
+docker-compose down
+```
+
+## 📝 Configuration
+
+Edit `src/main/resources/application.yml`:
+
+| Property | Description | Default |
+|----------|-------------|---------|
+| `server.port` | Server port | `8080` |
+| `spring.datasource.url` | Database URL | PostgreSQL |
+| `spring.jpa.hibernate.ddl-auto` | DDL mode | `update` |
+
+---
+
+**Built with ❤️ using Kybernus CLI** | {{currentYear}}

package/templates/java-spring/free/mvc/docker-compose.yml.hbs

@@ -0,0 +1,18 @@
+version: '3.8'
+
+services:
+  postgres:
+    image: postgres:15-alpine
+    container_name: {{projectNameKebabCase}}-db
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: {{projectNameSnakeCase}}
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    restart: unless-stopped
+
+volumes:
+  postgres_data:

package/templates/java-spring/free/mvc/pom.xml.hbs

@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
+         https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.4.1</version>
+        <relativePath/>
+    </parent>
+
+    <groupId>{{packageName}}</groupId>
+    <artifactId>{{projectNameKebabCase}}</artifactId>
+    <version>0.0.1-SNAPSHOT</version>
+    <name>{{projectNamePascalCase}}</name>
+    <description>Generated by Kibernus CLI</description>
+
+    <properties>
+        <java.version>21</java.version>
+    </properties>
+
+    <dependencies>
+        <!-- Spring Boot Starters -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-jpa</artifactId>
+        </dependency>
+
+        <!-- Database -->
+        <dependency>
+            <groupId>org.postgresql</groupId>
+            <artifactId>postgresql</artifactId>
+            <scope>runtime</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>runtime</scope>
+        </dependency>
+
+        <!-- Lombok -->
+        <dependency>
+            <groupId>org.projectlombok</groupId>
+            <artifactId>lombok</artifactId>
+            <optional>true</optional>
+        </dependency>
+
+        <!-- DevTools -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-devtools</artifactId>
+            <scope>runtime</scope>
+            <optional>true</optional>
+        </dependency>
+
+        <!-- Testing -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <configuration>
+                    <excludes>
+                        <exclude>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                        </exclude>
+                    </excludes>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

package/templates/java-spring/free/mvc/src/main/java/{{packagePath}}/config/GlobalExceptionHandler.java.hbs

@@ -0,0 +1,39 @@
+package {{packageName}}.config;
+
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.ExceptionHandler;
+import org.springframework.web.bind.annotation.RestControllerAdvice;
+
+import java.time.Instant;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Global exception handler for REST API
+ */
+@RestControllerAdvice
+public class GlobalExceptionHandler {
+
+    @ExceptionHandler(Exception.class)
+    public ResponseEntity<Map<String, Object>> handleException(Exception ex) {
+        Map<String, Object> error = new HashMap<>();
+        error.put("timestamp", Instant.now().toString());
+        error.put("status", HttpStatus.INTERNAL_SERVER_ERROR.value());
+        error.put("error", "Internal Server Error");
+        error.put("message", ex.getMessage());
+
+        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(error);
+    }
+
+    @ExceptionHandler(IllegalArgumentException.class)
+    public ResponseEntity<Map<String, Object>> handleBadRequest(IllegalArgumentException ex) {
+        Map<String, Object> error = new HashMap<>();
+        error.put("timestamp", Instant.now().toString());
+        error.put("status", HttpStatus.BAD_REQUEST.value());
+        error.put("error", "Bad Request");
+        error.put("message", ex.getMessage());
+
+        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(error);
+    }
+}

package/templates/java-spring/free/mvc/src/main/java/{{packagePath}}/config/WebConfig.java.hbs

@@ -0,0 +1,30 @@
+package {{packageName}}.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.cors.CorsConfiguration;
+import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
+import org.springframework.web.filter.CorsFilter;
+
+import java.util.Arrays;
+
+/**
+ * Web configuration for CORS and other settings
+ */
+@Configuration
+public class WebConfig {
+
+    @Bean
+    public CorsFilter corsFilter() {
+        CorsConfiguration config = new CorsConfiguration();
+        config.setAllowCredentials(true);
+        config.setAllowedOriginPatterns(Arrays.asList("*"));
+        config.setAllowedHeaders(Arrays.asList("*"));
+        config.setAllowedMethods(Arrays.asList("GET", "POST", "PUT", "DELETE", "OPTIONS"));
+
+        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
+        source.registerCorsConfiguration("/**", config);
+
+        return new CorsFilter(source);
+    }
+}

package/templates/java-spring/free/mvc/src/main/java/{{packagePath}}/controller/HealthController.java.hbs

@@ -0,0 +1,30 @@
+package {{packageName}}.controller;
+
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.Instant;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Health check controller
+ */
+@RestController
+@RequestMapping("/api")
+public class HealthController {
+
+    private final Instant startTime = Instant.now();
+
+    @GetMapping("/health")
+    public ResponseEntity<Map<String, Object>> health() {
+        Map<String, Object> response = new HashMap<>();
+        response.put("status", "ok");
+        response.put("message", "{{projectNamePascalCase}} API is running");
+        response.put("timestamp", Instant.now().toString());
+        response.put("uptime", java.time.Duration.between(startTime, Instant.now()).getSeconds());
+        return ResponseEntity.ok(response);
+    }
+}

package/templates/java-spring/free/mvc/src/main/java/{{packagePath}}/{{projectNamePascalCase}}Application.java.hbs

@@ -0,0 +1,13 @@
+package {{packageName}};
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class {{projectNamePascalCase}}Application {
+
+    public static void main(String[] args) {
+        SpringApplication.run({{projectNamePascalCase}}Application.class, args);
+    }
+
+}

package/templates/java-spring/free/mvc/src/main/resources/application.yml.hbs

@@ -0,0 +1,32 @@
+spring:
+  application:
+    name: {{projectNameKebabCase}}
+  
+  datasource:
+    url: jdbc:postgresql://localhost:5432/{{projectNameSnakeCase}}
+    username: postgres
+    password: postgres
+    driver-class-name: org.postgresql.Driver
+  
+  jpa:
+    hibernate:
+      ddl-auto: update
+    show-sql: true
+    properties:
+      hibernate:
+        format_sql: true
+        dialect: org.hibernate.dialect.PostgreSQLDialect
+
+  # H2 Console (for development)
+  h2:
+    console:
+      enabled: true
+      path: /h2-console
+
+server:
+  port: 8080
+
+logging:
+  level:
+    root: INFO
+    {{packageName}}: DEBUG

package/templates/java-spring/free/mvc/src/test/java/{{packagePath}}/{{projectNamePascalCase}}ApplicationTests.java.hbs

@@ -0,0 +1,13 @@
+package {{packageName}};
+
+import org.junit.jupiter.api.Test;
+import org.springframework.boot.test.context.SpringBootTest;
+
+@SpringBootTest
+class {{projectNamePascalCase}}ApplicationTests {
+
+    @Test
+    void contextLoads() {
+    }
+
+}

package/templates/java-spring/free/mvc/src/test/resources/application.yml.hbs

@@ -0,0 +1,10 @@
+spring:
+datasource:
+url: jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1
+driver-class-name: org.h2.Driver
+username: sa
+password: password
+jpa:
+database-platform: org.hibernate.dialect.H2Dialect
+hibernate:
+ddl-auto: create-drop

package/templates/java-spring/free/mvc/template.json

@@ -0,0 +1,14 @@
+{
+  "name": "Java Spring Boot MVC",
+  "tier": "free",
+  "stack": "java-spring",
+  "version": "1.0.0",
+  "description": "Spring Boot 4 REST API with Java 21 and MVC architecture",
+  "targetVersions": {
+    "java": "21",
+    "springBoot": "^4.0.0",
+    "maven": "^3.9.0"
+  },
+  "requiredConfig": ["projectName", "packageName"],
+  "optionalConfig": ["useAI", "buildTool"]
+}

package/templates/java-spring/pro/clean/.github/workflows/ci-cd.yml.hbs

@@ -0,0 +1,88 @@
+name: CI/CD Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+    pull_request:
+      branches: [main]
+
+      env:
+        NODE_VERSION: '20'
+        AWS_REGION: 'us-east-1'
+
+        jobs:
+          test:
+            runs-on: ubuntu-latest
+
+            steps:
+              - uses: actions/checkout@v4
+
+              - name: Setup Node.js
+              uses: actions/setup-node@v4
+              with:
+                node-version: $\{{ env.NODE_VERSION }}
+                cache: 'npm'
+
+                - name: Install dependencies
+                run: npm ci
+
+                - name: Run linter
+                run: npm run lint --if-present
+
+                - name: Run tests
+                run: npm test --if-present
+
+                - name: Build
+                run: npm run build
+
+                build-and-push:
+                  needs: test
+                  runs-on: ubuntu-latest
+                  if: github.ref == 'refs/heads/main'
+
+                  steps:
+                    - uses: actions/checkout@v4
+
+                    - name: Configure AWS credentials
+                    uses: aws-actions/configure-aws-credentials@v4
+                    with:
+                      aws-access-key-id: $\{{ secrets.AWS_ACCESS_KEY_ID }}
+                      aws-secret-access-key: $\{{ secrets.AWS_SECRET_ACCESS_KEY }}
+                      aws-region: $\{{ env.AWS_REGION }}
+
+                      - name: Login to Amazon ECR
+                      id: login-ecr
+                      uses: aws-actions/amazon-ecr-login@v2
+
+                      - name: Build, tag, and push image to Amazon ECR
+                      env:
+                        ECR_REGISTRY: $\{{ steps.login-ecr.outputs.registry }}
+                        ECR_REPOSITORY: {{projectNameKebabCase}}
+                        IMAGE_TAG: $\{{ github.sha }}
+                        run: |
+                        docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG .
+                        docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:latest .
+                        docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
+                        docker push $ECR_REGISTRY/$ECR_REPOSITORY:latest
+
+                        deploy:
+                          needs: build-and-push
+                          runs-on: ubuntu-latest
+                          if: github.ref == 'refs/heads/main'
+
+                          steps:
+                            - uses: actions/checkout@v4
+
+                            - name: Configure AWS credentials
+                            uses: aws-actions/configure-aws-credentials@v4
+                            with:
+                              aws-access-key-id: $\{{ secrets.AWS_ACCESS_KEY_ID }}
+                              aws-secret-access-key: $\{{ secrets.AWS_SECRET_ACCESS_KEY }}
+                              aws-region: $\{{ env.AWS_REGION }}
+
+                              - name: Deploy to ECS
+                              run: |
+                              aws ecs update-service \
+                              --cluster {{projectNameKebabCase}}-prod \
+                              --service {{projectNameKebabCase}}-api \
+                              --force-new-deployment

package/templates/java-spring/pro/clean/Dockerfile.hbs

@@ -0,0 +1,45 @@
+# Production Dockerfile for {{projectName}}
+
+# Build stage
+FROM node:20-alpine AS builder
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci --only=production
+
+# Copy source code
+COPY . .
+
+# Build TypeScript
+RUN npm run build
+
+# Production stage
+FROM node:20-alpine AS production
+
+WORKDIR /app
+
+# Create non-root user
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S nodejs -u 1001
+
+# Copy built application
+COPY --from=builder --chown=nodejs:nodejs /app/dist ./dist
+COPY --from=builder --chown=nodejs:nodejs /app/node_modules ./node_modules
+COPY --from=builder --chown=nodejs:nodejs /app/package.json ./
+
+# Switch to non-root user
+USER nodejs
+
+# Expose port
+EXPOSE 3000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
+
+# Start application
+CMD ["node", "dist/index.js"]