trinity-method-sdk 2.0.0

package/dist/templates/ci/ci.yml.template

@@ -0,0 +1,196 @@
+# {{PROJECT_NAME}} - Trinity Method CI/CD Pipeline
+# Trinity Method v{{TRINITY_VERSION}}
+# Framework: {{FRAMEWORK}}
+# Generated by: EIN (CI/CD Specialist)
+
+name: Trinity CI/CD Pipeline
+
+on:
+  push:
+    branches:
+      - main
+      - dev
+  pull_request:
+    branches:
+      - main
+      - dev
+
+jobs:
+  trinity-quality-gates:
+    name: Trinity BAS 6-Phase Quality Gates
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20.x]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Full history for better analysis
+
+      # Setup Node.js
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      # Install dependencies
+      - name: Install dependencies
+        run: npm ci
+
+      # =============================================
+      # BAS PHASE 1: Linting (with auto-fix)
+      # =============================================
+      - name: 'BAS Phase 1: Linting'
+        id: lint
+        run: |
+          echo "🔍 Running ESLint with auto-fix..."
+          npm run lint -- --fix || npm run lint:fix || npx eslint . --fix || true
+          echo "✅ Linting phase complete"
+
+      # =============================================
+      # BAS PHASE 2: Structure Validation
+      # =============================================
+      - name: 'BAS Phase 2: Structure Validation'
+        id: structure
+        run: |
+          echo "🔍 Validating project structure..."
+
+          # Check required directories exist
+          dirs=("src" "tests" "trinity" ".claude")
+          for dir in "${dirs[@]}"; do
+            if [ ! -d "$dir" ]; then
+              echo "❌ Required directory missing: $dir"
+              exit 1
+            fi
+          done
+
+          # Check package.json has required scripts
+          if ! grep -q '"test"' package.json; then
+            echo "❌ package.json missing 'test' script"
+            exit 1
+          fi
+
+          echo "✅ Structure validation complete"
+
+      # =============================================
+      # BAS PHASE 3: Build Validation
+      # =============================================
+      - name: 'BAS Phase 3: Build Validation'
+        id: build
+        run: |
+          echo "🔨 Building project..."
+          npm run build
+          echo "✅ Build validation complete"
+
+      # =============================================
+      # BAS PHASE 4: Testing (All Tests Pass)
+      # =============================================
+      - name: 'BAS Phase 4: Testing'
+        id: tests
+        run: |
+          echo "🧪 Running all tests..."
+          npm test
+          echo "✅ All tests passed"
+
+      # =============================================
+      # BAS PHASE 5: Coverage Check (≥80%)
+      # =============================================
+      - name: 'BAS Phase 5: Coverage Check'
+        id: coverage
+        run: |
+          echo "📊 Checking test coverage..."
+          npm test -- --coverage
+
+          # Check coverage threshold
+          echo "Validating coverage meets 80% threshold..."
+
+          # Extract coverage percentage (adjust based on your coverage tool)
+          # This example works with Jest coverage output
+          if [ -f "coverage/coverage-summary.json" ]; then
+            coverage=$(node -e "const c = require('./coverage/coverage-summary.json'); console.log(c.total.lines.pct);")
+            threshold=80
+
+            if (( $(echo "$coverage < $threshold" | bc -l) )); then
+              echo "❌ Coverage $coverage% is below threshold $threshold%"
+              exit 1
+            fi
+
+            echo "✅ Coverage $coverage% meets threshold $threshold%"
+          else
+            echo "⚠️  coverage-summary.json not found, skipping threshold check"
+          fi
+
+          echo "✅ Coverage validation complete"
+
+      # =============================================
+      # BAS PHASE 6: Best Practices Validation
+      # =============================================
+      - name: 'BAS Phase 6: Best Practices'
+        id: practices
+        run: |
+          echo "📋 Validating best practices..."
+
+          # Check for common issues
+          issues=0
+
+          # Check: No console.log in production code (allow in tests)
+          if grep -r "console\.log" src/ --exclude-dir=__tests__ 2>/dev/null | grep -v "//.*console\.log"; then
+            echo "⚠️  Found console.log in production code"
+            issues=$((issues+1))
+          fi
+
+          # Check: No TODO comments without issue references
+          if grep -r "TODO" src/ 2>/dev/null | grep -v "TODO(#" | grep -v "//.*TODO:.*#"; then
+            echo "⚠️  Found TODO without issue reference"
+            issues=$((issues+1))
+          fi
+
+          # Check: TypeScript strict mode enabled
+          if [ -f "tsconfig.json" ]; then
+            if ! grep -q '"strict": true' tsconfig.json; then
+              echo "⚠️  TypeScript strict mode not enabled"
+              issues=$((issues+1))
+            fi
+          fi
+
+          if [ $issues -gt 0 ]; then
+            echo "⚠️  Found $issues best practice issues (warnings only)"
+          fi
+
+          echo "✅ Best practices validation complete"
+
+      # =============================================
+      # Coverage Upload (Optional - Codecov)
+      # =============================================
+      - name: Upload coverage to Codecov
+        if: success()
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage/lcov.info
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false  # Don't fail CI if Codecov upload fails
+
+      # =============================================
+      # Trinity Quality Summary
+      # =============================================
+      - name: Trinity Quality Summary
+        if: always()
+        run: |
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo "   Trinity BAS 6-Phase Quality Gates"
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+          echo ""
+          echo "Phase 1: Linting            - ${{ steps.lint.outcome }}"
+          echo "Phase 2: Structure          - ${{ steps.structure.outcome }}"
+          echo "Phase 3: Build              - ${{ steps.build.outcome }}"
+          echo "Phase 4: Tests              - ${{ steps.tests.outcome }}"
+          echo "Phase 5: Coverage (≥80%)    - ${{ steps.coverage.outcome }}"
+          echo "Phase 6: Best Practices     - ${{ steps.practices.outcome }}"
+          echo ""
+          echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

package/dist/templates/ci/generic-ci.yml

@@ -0,0 +1,115 @@
+# Generic CI/CD Template for Trinity Method
+#
+# This template can be adapted for various CI/CD platforms including:
+# - Jenkins, CircleCI, Travis CI, Bitbucket Pipelines, Azure Pipelines, etc.
+#
+# Adapt the syntax to your platform's requirements
+
+# ====================
+# Environment Setup
+# ====================
+environment:
+  node_version: '20.x'
+  ci: true
+
+# ====================
+# Dependencies
+# ====================
+install_dependencies:
+  command: npm ci
+  cache:
+    - node_modules/
+
+# ====================
+# Linting Stage
+# ====================
+lint:
+  stage: test
+  command: npm run lint
+  allow_failure: true
+  run_on:
+    - main
+    - dev
+    - develop
+    - pull_requests
+
+# ====================
+# Testing Stage
+# ====================
+test:
+  stage: test
+  matrix:
+    node_version: ['18.x', '20.x']
+  commands:
+    - npm test
+  artifacts:
+    - coverage/
+  run_on:
+    - main
+    - dev
+    - develop
+    - pull_requests
+
+test_with_coverage:
+  stage: test
+  node_version: '20.x'
+  commands:
+    - npm run test:coverage
+  artifacts:
+    - coverage/
+    - coverage/lcov.info
+  coverage_report: coverage/lcov.info
+  run_on:
+    - main
+    - dev
+    - develop
+
+# ====================
+# Build Stage
+# ====================
+build:
+  stage: build
+  depends_on:
+    - test
+  commands:
+    - npm run build || echo "No build script configured"
+  artifacts:
+    - dist/
+    - build/
+  run_on:
+    - main
+    - dev
+    - develop
+
+# ====================
+# Trinity Method Deployment Stage
+# ====================
+deploy_trinity:
+  stage: deploy
+  node_version: '20.x'
+  depends_on:
+    - test_with_coverage
+    - build
+  commands:
+    - npx trinity deploy --agent claude --ci-deploy --yes
+  artifacts:
+    - trinity/
+    - CLAUDE.md
+  run_on:
+    - main
+    - dev
+  when: on_success
+
+# ====================
+# Configuration Notes
+# ====================
+#
+# 1. Ensure your CI environment has Node.js installed
+# 2. Set CI=true environment variable for CI detection
+# 3. Configure artifact storage according to your platform
+# 4. Adjust branch names to match your repository's branching strategy
+# 5. Add platform-specific authentication if needed for deployment
+# 6. Consider adding notification steps for failures
+# 7. Customize caching strategy based on platform capabilities
+#
+# Trinity Method CLI Documentation: https://github.com/trinity-method/sdk

package/dist/templates/ci/github-actions.yml

@@ -0,0 +1,86 @@
+name: Trinity Method CI
+
+on:
+  push:
+    branches: [main, dev, develop]
+  pull_request:
+    branches: [main, dev, develop]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run linting
+        run: npm run lint
+        continue-on-error: true
+
+      - name: Run tests
+        run: npm test
+
+      - name: Run tests with coverage
+        run: npm run test:coverage
+        if: matrix.node-version == '20.x'
+
+      - name: Upload coverage reports
+        uses: codecov/codecov-action@v3
+        if: matrix.node-version == '20.x'
+        with:
+          files: ./coverage/lcov.info
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false
+
+      - name: Deploy Trinity Method structure
+        if: success() && matrix.node-version == '20.x'
+        run: npx trinity deploy --agent claude --ci-deploy --yes
+        env:
+          CI: true
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build project
+        run: npm run build
+        continue-on-error: true
+
+      - name: Archive build artifacts
+        uses: actions/upload-artifact@v3
+        if: success()
+        with:
+          name: build-artifacts
+          path: |
+            dist/
+            build/
+          retention-days: 7

package/dist/templates/ci/gitlab-ci.yml

@@ -0,0 +1,103 @@
+stages:
+  - test
+  - build
+  - deploy
+
+variables:
+  NODE_VERSION: '20'
+  CI: 'true'
+
+.node_template: &node_template
+  image: node:${NODE_VERSION}
+  cache:
+    key: ${CI_COMMIT_REF_SLUG}
+    paths:
+      - node_modules/
+      - .npm/
+  before_script:
+    - npm ci --cache .npm --prefer-offline
+
+test:lint:
+  <<: *node_template
+  stage: test
+  script:
+    - npm run lint || true
+  allow_failure: true
+  only:
+    - main
+    - dev
+    - develop
+    - merge_requests
+
+test:unit:
+  <<: *node_template
+  stage: test
+  parallel:
+    matrix:
+      - NODE_VERSION: ['18', '20']
+  script:
+    - npm test
+  coverage: '/All files[^|]*\|[^|]*\s+([\d\.]+)/'
+  artifacts:
+    when: always
+    reports:
+      junit: junit.xml
+      coverage_report:
+        coverage_format: cobertura
+        path: coverage/cobertura-coverage.xml
+  only:
+    - main
+    - dev
+    - develop
+    - merge_requests
+
+test:coverage:
+  <<: *node_template
+  stage: test
+  script:
+    - npm run test:coverage
+  coverage: '/All files[^|]*\|[^|]*\s+([\d\.]+)/'
+  artifacts:
+    paths:
+      - coverage/
+    expire_in: 30 days
+    reports:
+      coverage_report:
+        coverage_format: cobertura
+        path: coverage/cobertura-coverage.xml
+  only:
+    - main
+    - dev
+    - develop
+
+build:
+  <<: *node_template
+  stage: build
+  needs: ['test:unit']
+  script:
+    - npm run build || echo "No build script found"
+  artifacts:
+    paths:
+      - dist/
+      - build/
+    expire_in: 7 days
+  only:
+    - main
+    - dev
+    - develop
+
+deploy:trinity:
+  <<: *node_template
+  stage: deploy
+  needs: ['test:coverage', 'build']
+  script:
+    - npx trinity deploy --agent claude --ci-deploy --yes
+  artifacts:
+    paths:
+      - trinity/
+      - CLAUDE.md
+    expire_in: 30 days
+  only:
+    - main
+    - dev
+  when: on_success