javi-forge 0.1.0

package/templates/woodpecker/woodpecker-java.yml

@@ -0,0 +1,67 @@
+# ===========================================
+# Woodpecker CI for Java/Gradle Projects
+# ===========================================
+# Copy to: .woodpecker.yml
+#
+# MINIMAL CI - runs on push, pull requests, tags, and manual triggers.
+# Run full validation locally: ./.ci-local/ci-local.sh full
+#
+# Caching: Woodpecker does not have declarative cache.
+# Mount volumes on the server for .gradle/ and build/ to speed up builds.
+# ===========================================
+
+when:
+  - event: push
+    branch: main
+  - event: pull_request
+  - event: tag
+  - event: manual
+
+steps:
+  - name: lint
+    image: eclipse-temurin:21-jdk  # Change: 17, 21, 25
+    environment:
+      GRADLE_OPTS: "-Dorg.gradle.daemon=false -Dorg.gradle.caching=true"
+    commands:
+      - chmod +x gradlew
+      - ./gradlew spotlessCheck --no-daemon
+    failure: ignore
+
+  - name: build
+    image: eclipse-temurin:21-jdk  # Change: 17, 21, 25
+    environment:
+      GRADLE_OPTS: "-Dorg.gradle.daemon=false -Dorg.gradle.caching=true"
+    commands:
+      - chmod +x gradlew
+      - ./gradlew classes --no-daemon
+
+# ===========================================
+# DOCKER - Only on version tags
+# ===========================================
+# Uncomment to enable Docker builds on tags.
+# Requires woodpeckerci/plugin-docker-buildx.
+#
+#   - name: docker
+#     image: woodpeckerci/plugin-docker-buildx
+#     settings:
+#       repo: registry.example.com/my-app
+#       tag: ${CI_COMMIT_TAG}
+#       dockerfile: Dockerfile
+#     when:
+#       - event: tag
+
+# ===========================================
+# PUBLISH - Only on version tags
+# ===========================================
+#   - name: publish
+#     image: eclipse-temurin:21-jdk
+#     commands:
+#       - chmod +x gradlew
+#       - ./gradlew publish --no-daemon
+#     environment:
+#       MAVEN_USERNAME:
+#         from_secret: maven_username
+#       MAVEN_PASSWORD:
+#         from_secret: maven_password
+#     when:
+#       - event: tag

package/templates/woodpecker/woodpecker-node.yml

@@ -0,0 +1,47 @@
+# ===========================================
+# Woodpecker CI for Node.js Projects
+# ===========================================
+# Copy to: .woodpecker.yml
+#
+# MINIMAL CI - runs on push, pull requests, tags, and manual triggers.
+# Run full validation locally: ./.ci-local/ci-local.sh full
+#
+# Caching: Woodpecker does not have declarative cache.
+# Mount a volume for node_modules/ on the server to speed up builds.
+# ===========================================
+
+when:
+  - event: push
+    branch: main
+  - event: pull_request
+  - event: tag
+  - event: manual
+
+steps:
+  - name: lint
+    image: node:20-alpine  # Change: 18, 20, 22
+    commands:
+      - npm ci
+      - npm run lint
+    failure: ignore
+
+  - name: build
+    image: node:20-alpine  # Change: 18, 20, 22
+    commands:
+      - npm ci
+      - npm run build
+
+# ===========================================
+# DOCKER - Only on version tags
+# ===========================================
+# Uncomment to enable Docker builds on tags.
+# Requires woodpeckerci/plugin-docker-buildx.
+#
+#   - name: docker
+#     image: woodpeckerci/plugin-docker-buildx
+#     settings:
+#       repo: registry.example.com/my-app
+#       tag: ${CI_COMMIT_TAG}
+#       dockerfile: Dockerfile
+#     when:
+#       - event: tag

package/templates/woodpecker/woodpecker-python.yml

@@ -0,0 +1,108 @@
+# ===========================================
+# Woodpecker CI for Python Projects
+# ===========================================
+# Copy to: .woodpecker.yml
+#
+# MINIMAL CI - runs on push, pull requests, tags, and manual triggers.
+# Run full validation locally: ./.ci-local/ci-local.sh full
+#
+# Uses pip by default. See commented alternatives for poetry/uv.
+#
+# Caching: Woodpecker does not have declarative cache.
+# Mount a volume for pip cache on the server to speed up builds.
+# ===========================================
+
+when:
+  - event: push
+    branch: main
+  - event: pull_request
+  - event: tag
+  - event: manual
+
+steps:
+  - name: lint
+    image: python:3.12-slim  # Change: 3.10, 3.11, 3.12, 3.13
+    commands:
+      - python -m pip install --upgrade pip
+      - pip install ruff mypy
+      - ruff check .
+      - mypy . --ignore-missing-imports
+    failure: ignore
+
+  - name: build
+    image: python:3.12-slim  # Change: 3.10, 3.11, 3.12, 3.13
+    commands:
+      - python -m pip install --upgrade pip
+      - pip install -r requirements.txt || true
+      - pip install -r requirements-dev.txt || true
+
+# ===========================================
+# Alternative: Poetry
+# ===========================================
+# Replace the build and lint steps above with:
+#
+#   - name: lint
+#     image: python:3.12-slim
+#     commands:
+#       - pip install poetry
+#       - poetry install
+#       - poetry run ruff check .
+#       - poetry run mypy . --ignore-missing-imports
+#     failure: ignore
+#
+#   - name: build
+#     image: python:3.12-slim
+#     commands:
+#       - pip install poetry
+#       - poetry install
+
+# ===========================================
+# Alternative: uv
+# ===========================================
+# Replace the build and lint steps above with:
+#
+#   - name: lint
+#     image: python:3.12-slim
+#     commands:
+#       - pip install uv
+#       - uv sync
+#       - uv run ruff check .
+#       - uv run mypy . --ignore-missing-imports
+#     failure: ignore
+#
+#   - name: build
+#     image: python:3.12-slim
+#     commands:
+#       - pip install uv
+#       - uv sync
+
+# ===========================================
+# DOCKER - Only on version tags
+# ===========================================
+# Uncomment to enable Docker builds on tags.
+# Requires woodpeckerci/plugin-docker-buildx.
+#
+#   - name: docker
+#     image: woodpeckerci/plugin-docker-buildx
+#     settings:
+#       repo: registry.example.com/my-app
+#       tag: ${CI_COMMIT_TAG}
+#       dockerfile: Dockerfile
+#     when:
+#       - event: tag
+
+# ===========================================
+# PUBLISH to PyPI - Only on version tags
+# ===========================================
+#   - name: publish
+#     image: python:3.12-slim
+#     commands:
+#       - pip install build twine
+#       - python -m build
+#       - twine upload dist/*
+#     environment:
+#       TWINE_USERNAME: __token__
+#       TWINE_PASSWORD:
+#         from_secret: pypi_token
+#     when:
+#       - event: tag

package/templates/woodpecker/woodpecker-rust.yml

@@ -0,0 +1,57 @@
+# ===========================================
+# Woodpecker CI for Rust Projects
+# ===========================================
+# Copy to: .woodpecker.yml
+#
+# MINIMAL CI - runs on push, pull requests, tags, and manual triggers.
+# Run full validation locally: ./.ci-local/ci-local.sh full
+#
+# Caching: Woodpecker does not have declarative cache.
+# Mount volumes for .cargo/ and target/ on the server to speed up builds.
+# ===========================================
+
+when:
+  - event: push
+    branch: main
+  - event: pull_request
+  - event: tag
+  - event: manual
+
+steps:
+  - name: lint
+    image: rust:1.83-slim
+    commands:
+      - rustup component add clippy rustfmt
+      - cargo fmt --all -- --check
+      - cargo clippy --all-targets -- -D warnings
+    failure: ignore
+
+  - name: build
+    image: rust:1.83-slim
+    commands:
+      - cargo build --release
+
+# ===========================================
+# DOCKER - Only on version tags
+# ===========================================
+# Uncomment to enable Docker builds on tags.
+# Requires woodpeckerci/plugin-docker-buildx.
+#
+#   - name: docker
+#     image: woodpeckerci/plugin-docker-buildx
+#     settings:
+#       repo: registry.example.com/my-app
+#       tag: ${CI_COMMIT_TAG}
+#       dockerfile: Dockerfile
+#     when:
+#       - event: tag
+
+# ===========================================
+# RELEASE - Only on version tags
+# ===========================================
+#   - name: release
+#     image: rust:1.83-slim
+#     commands:
+#       - echo "Uploading release artifacts..."
+#     when:
+#       - event: tag

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "jsx": "react",
+    "jsxFactory": "React.createElement",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    pool: 'forks',
+    testTimeout: 30_000,
+    coverage: {
+      provider: 'v8',
+      include: ['src/**/*.ts', 'src/**/*.tsx'],
+      exclude: ['src/index.tsx', 'src/ui/**', 'src/e2e/**'],
+      thresholds: { lines: 85, branches: 80 },
+    },
+  },
+})

package/workflows/reusable-build-go.yml

@@ -0,0 +1,111 @@
+# ===========================================
+# Reusable Workflow: Go Build
+# ===========================================
+# Minimal CI for Go projects.
+#
+# Usage:
+#   jobs:
+#     build:
+#       uses: JNZader/project-starter-framework/.github/workflows/reusable-build-go.yml@main
+#       with:
+#         go-version: '1.23'
+# ===========================================
+
+name: Go Build (Reusable)
+
+on:
+  workflow_call:
+    inputs:
+      go-version:
+        description: 'Go version'
+        required: false
+        default: '1.23'
+        type: string
+      run-tests:
+        description: 'Run tests'
+        required: false
+        default: true
+        type: boolean
+      run-lint:
+        description: 'Run golangci-lint'
+        required: false
+        default: true
+        type: boolean
+      working-directory:
+        description: 'Working directory'
+        required: false
+        default: '.'
+        type: string
+      build-flags:
+        description: 'Additional go build flags'
+        required: false
+        default: ''
+        type: string
+      lint-fail-on-error:
+        description: 'Fail the build if linting fails'
+        required: false
+        default: true
+        type: boolean
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+
+    defaults:
+      run:
+        working-directory: ${{ inputs.working-directory }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Validate inputs
+        env:
+          ARGS: ${{ inputs.build-flags }}
+        run: |
+          if echo "$ARGS" | grep -qE '[;|&$`(){}<>'"'"'"]'; then
+            echo "::error::Invalid characters in input arguments. Shell metacharacters are not allowed."
+            exit 1
+          fi
+
+      - name: Setup Go ${{ inputs.go-version }}
+        uses: actions/setup-go@v5
+        with:
+          go-version: ${{ inputs.go-version }}
+          cache-dependency-path: ${{ inputs.working-directory }}/go.sum
+
+      - name: Download dependencies
+        run: go mod download
+
+      - name: Verify dependencies
+        run: go mod verify
+
+      - name: Build
+        env:
+          BUILD_FLAGS: ${{ inputs.build-flags }}
+        run: go build -v $BUILD_FLAGS ./...
+
+      - name: Lint
+        if: inputs.run-lint
+        uses: golangci/golangci-lint-action@v6
+        with:
+          version: v1.62
+          working-directory: ${{ inputs.working-directory }}
+          args: --timeout=5m
+        continue-on-error: ${{ !inputs.lint-fail-on-error }}
+
+      - name: Test
+        if: inputs.run-tests
+        run: go test -v -race -coverprofile=coverage.out ./...
+
+      - name: Upload coverage
+        if: inputs.run-tests
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: ${{ inputs.working-directory }}/coverage.out
+          retention-days: 7

package/workflows/reusable-build-java.yml

@@ -0,0 +1,120 @@
+# ===========================================
+# Reusable Workflow: Java/Gradle Build
+# ===========================================
+# Minimal CI for Java projects - saves CI minutes.
+#
+# Usage in your project:
+#   jobs:
+#     build:
+#       uses: JNZader/project-starter-framework/.github/workflows/reusable-build-java.yml@main
+#       with:
+#         java-version: '21'
+# ===========================================
+
+name: Java Build (Reusable)
+
+on:
+  workflow_call:
+    inputs:
+      java-version:
+        description: 'Java version (17, 21, 25)'
+        required: false
+        default: '21'
+        type: string
+      gradle-tasks:
+        description: 'Gradle tasks to run'
+        required: false
+        default: 'classes'
+        type: string
+      run-tests:
+        description: 'Run tests (uses more minutes)'
+        required: false
+        default: true
+        type: boolean
+      run-spotless:
+        description: 'Run Spotless format check'
+        required: false
+        default: true
+        type: boolean
+      working-directory:
+        description: 'Working directory'
+        required: false
+        default: '.'
+        type: string
+      gradle-args:
+        description: 'Additional Gradle arguments'
+        required: false
+        default: ''
+        type: string
+      lint-fail-on-error:
+        description: 'Fail the build if linting fails'
+        required: false
+        default: true
+        type: boolean
+
+env:
+  GRADLE_OPTS: '-Dorg.gradle.daemon=false -Dorg.gradle.caching=true'
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+
+    defaults:
+      run:
+        working-directory: ${{ inputs.working-directory }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Validate inputs
+        env:
+          ARGS: ${{ inputs.gradle-args }}
+        run: |
+          if echo "$ARGS" | grep -qE '[;|&$`(){}<>'"'"'"]'; then
+            echo "::error::Invalid characters in input arguments. Shell metacharacters are not allowed."
+            exit 1
+          fi
+
+      - name: Setup Java ${{ inputs.java-version }}
+        uses: actions/setup-java@v4
+        with:
+          java-version: ${{ inputs.java-version }}
+          distribution: 'temurin'
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+        with:
+          cache-read-only: ${{ github.ref != 'refs/heads/main' && github.ref != 'refs/heads/develop' }}
+
+      - name: Grant execute permission
+        run: chmod +x gradlew
+
+      - name: Compile
+        env:
+          GRADLE_TASKS: ${{ inputs.gradle-tasks }}
+          GRADLE_ARGS: ${{ inputs.gradle-args }}
+        run: ./gradlew $GRADLE_TASKS --no-daemon $GRADLE_ARGS
+
+      - name: Spotless Check
+        if: inputs.run-spotless
+        continue-on-error: ${{ !inputs.lint-fail-on-error }}
+        run: ./gradlew spotlessCheck --no-daemon
+
+      - name: Test
+        if: inputs.run-tests
+        env:
+          GRADLE_ARGS: ${{ inputs.gradle-args }}
+        run: ./gradlew test --no-daemon $GRADLE_ARGS
+
+      - name: Upload test results
+        if: inputs.run-tests && always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: '**/build/reports/tests/'
+          retention-days: 7

package/workflows/reusable-build-node.yml

@@ -0,0 +1,145 @@
+# ===========================================
+# Reusable Workflow: Node.js Build
+# ===========================================
+# Minimal CI for Node.js/TypeScript projects.
+#
+# Usage:
+#   jobs:
+#     build:
+#       uses: JNZader/project-starter-framework/.github/workflows/reusable-build-node.yml@main
+#       with:
+#         node-version: '20'
+# ===========================================
+
+name: Node.js Build (Reusable)
+
+on:
+  workflow_call:
+    inputs:
+      node-version:
+        description: 'Node.js version'
+        required: false
+        default: '20'
+        type: string
+      package-manager:
+        description: 'Package manager (npm, yarn, pnpm)'
+        required: false
+        default: 'npm'
+        type: string
+      build-script:
+        description: 'Build script name'
+        required: false
+        default: 'build'
+        type: string
+      run-tests:
+        description: 'Run tests'
+        required: false
+        default: true
+        type: boolean
+      run-lint:
+        description: 'Run linting'
+        required: false
+        default: true
+        type: boolean
+      working-directory:
+        description: 'Working directory'
+        required: false
+        default: '.'
+        type: string
+      lint-fail-on-error:
+        description: 'Fail the build if linting fails'
+        required: false
+        default: true
+        type: boolean
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+
+    defaults:
+      run:
+        working-directory: ${{ inputs.working-directory }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        if: inputs.package-manager == 'pnpm'
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Setup Node.js ${{ inputs.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ inputs.node-version }}
+          cache: ${{ inputs.package-manager }}
+
+      - name: Install (npm)
+        if: inputs.package-manager == 'npm'
+        run: npm ci
+
+      - name: Install (yarn)
+        if: inputs.package-manager == 'yarn'
+        run: yarn install --frozen-lockfile
+
+      - name: Install (pnpm)
+        if: inputs.package-manager == 'pnpm'
+        run: pnpm install --frozen-lockfile
+
+      - name: Lint
+        if: inputs.run-lint
+        continue-on-error: ${{ !inputs.lint-fail-on-error }}
+        env:
+          PKG_MGR: ${{ inputs.package-manager }}
+        run: |
+          if [ "$PKG_MGR" = "pnpm" ]; then
+            pnpm run lint
+          elif [ "$PKG_MGR" = "yarn" ]; then
+            yarn lint
+          else
+            npm run lint
+          fi
+
+      - name: Build
+        env:
+          PKG_MGR: ${{ inputs.package-manager }}
+          BUILD_SCRIPT: ${{ inputs.build-script }}
+        run: |
+          if [ "$PKG_MGR" = "pnpm" ]; then
+            pnpm run "$BUILD_SCRIPT"
+          elif [ "$PKG_MGR" = "yarn" ]; then
+            yarn "$BUILD_SCRIPT"
+          else
+            npm run "$BUILD_SCRIPT"
+          fi
+
+      - name: Test
+        if: inputs.run-tests
+        env:
+          PKG_MGR: ${{ inputs.package-manager }}
+        run: |
+          if [ "$PKG_MGR" = "pnpm" ]; then
+            pnpm test
+          elif [ "$PKG_MGR" = "yarn" ]; then
+            yarn test
+          else
+            npm test
+          fi
+
+      - name: Upload test results
+        if: inputs.run-tests && always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results-node
+          path: |
+            coverage/
+            junit.xml
+            test-results/
+          retention-days: 7
+          if-no-files-found: ignore