aios-core 2.1.0

package/.aios-core/infrastructure/templates/github-workflows/pr-automation.yml.template

@@ -0,0 +1,330 @@
+# =============================================================================
+# AIOS PR Automation Template
+# =============================================================================
+# Template for user projects created with AIOS-FULLSTACK
+# Generated by: *setup-github task (Story 5.10)
+#
+# Features:
+#   - Required status checks (blocking)
+#   - Coverage report posted as PR comment
+#   - Quality gate summary comment
+#   - CodeRabbit integration status
+# =============================================================================
+
+name: PR Automation
+
+on:
+  pull_request:
+    branches:
+      - main
+      - develop
+    types: [opened, synchronize, reopened]
+
+permissions:
+  contents: read
+  pull-requests: write
+  checks: write
+
+env:
+  NODE_VERSION: '{{NODE_VERSION}}'
+
+jobs:
+  # ===========================================================================
+  # REQUIRED STATUS CHECKS (Blocking)
+  # ===========================================================================
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Checkout code
+        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 ESLint
+        run: {{LINT_COMMAND}}
+
+  typecheck:
+    name: TypeCheck
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Checkout code
+        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 TypeScript type checking
+        run: {{TYPECHECK_COMMAND}}
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    outputs:
+      coverage-summary: ${{ steps.coverage.outputs.summary }}
+    steps:
+      - name: Checkout code
+        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 tests with coverage
+        id: test-run
+        run: {{TEST_COMMAND}}
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage/lcov.info
+          flags: unittests
+          fail_ci_if_error: false
+
+      - name: Extract coverage summary
+        id: coverage
+        run: |
+          if [ -f coverage/coverage-summary.json ]; then
+            LINES=$(jq '.total.lines.pct' coverage/coverage-summary.json)
+            STATEMENTS=$(jq '.total.statements.pct' coverage/coverage-summary.json)
+            BRANCHES=$(jq '.total.branches.pct' coverage/coverage-summary.json)
+            FUNCTIONS=$(jq '.total.functions.pct' coverage/coverage-summary.json)
+            echo "summary=Lines: ${LINES}% | Statements: ${STATEMENTS}% | Branches: ${BRANCHES}% | Functions: ${FUNCTIONS}%" >> $GITHUB_OUTPUT
+          else
+            echo "summary=Coverage report not available" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Upload coverage artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage/
+          retention-days: 7
+
+  # ===========================================================================
+  # COVERAGE COMMENT
+  # ===========================================================================
+
+  coverage-comment:
+    name: Coverage Comment
+    runs-on: ubuntu-latest
+    needs: [test]
+    if: always() && needs.test.result != 'cancelled'
+    steps:
+      - name: Post coverage comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const coverageSummary = '${{ needs.test.outputs.coverage-summary }}' || 'Coverage data not available';
+
+            const body = `## 📊 Coverage Report
+
+            ${coverageSummary}
+
+            <details>
+            <summary>Coverage Details</summary>
+
+            | Metric | Coverage |
+            |--------|----------|
+            | Lines | See Codecov |
+            | Branches | See Codecov |
+            | Functions | See Codecov |
+            | Statements | See Codecov |
+
+            </details>
+
+            > 📈 Full coverage report available in [Codecov](https://codecov.io/gh/${{ github.repository }}/pull/${{ github.event.pull_request.number }})
+            `;
+
+            // Find existing comment
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+            });
+
+            const botComment = comments.find(comment =>
+              comment.user.type === 'Bot' &&
+              comment.body.includes('📊 Coverage Report')
+            );
+
+            if (botComment) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: botComment.id,
+                body: body
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body: body
+              });
+            }
+
+  # ===========================================================================
+  # QUALITY SUMMARY
+  # ===========================================================================
+
+  quality-summary:
+    name: Quality Summary
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test]
+    if: always()
+    steps:
+      - name: Generate quality summary
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const lintResult = '${{ needs.lint.result }}';
+            const typecheckResult = '${{ needs.typecheck.result }}';
+            const testResult = '${{ needs.test.result }}';
+
+            const getEmoji = (result) => {
+              switch(result) {
+                case 'success': return '✅';
+                case 'failure': return '❌';
+                case 'cancelled': return '⏹️';
+                case 'skipped': return '⏭️';
+                default: return '⏳';
+              }
+            };
+
+            const allPassed = lintResult === 'success' &&
+                              typecheckResult === 'success' &&
+                              testResult === 'success';
+
+            const overallStatus = allPassed ? '✅ All checks passed' : '❌ Some checks failed';
+
+            const body = `## 📋 Quality Gate Summary
+
+            **Overall Status:** ${overallStatus}
+
+            | Check | Status | Result |
+            |-------|--------|--------|
+            | Lint | ${getEmoji(lintResult)} | ${lintResult} |
+            | TypeCheck | ${getEmoji(typecheckResult)} | ${typecheckResult} |
+            | Tests | ${getEmoji(testResult)} | ${testResult} |
+
+            ### Required for Merge
+            - ${getEmoji(lintResult)} ESLint validation
+            - ${getEmoji(typecheckResult)} TypeScript type checking
+            - ${getEmoji(testResult)} Test suite passing
+
+            ### CodeRabbit Review
+            🐰 CodeRabbit will provide automated code review comments separately.
+            - **CRITICAL** issues must be resolved before merge
+            - **HIGH** issues should be addressed or documented
+
+            ---
+            *Generated by AIOS PR Automation*
+            `;
+
+            // Find existing comment
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+            });
+
+            const botComment = comments.find(comment =>
+              comment.user.type === 'Bot' &&
+              comment.body.includes('📋 Quality Gate Summary')
+            );
+
+            if (botComment) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: botComment.id,
+                body: body
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body: body
+              });
+            }
+
+      - name: Set final status
+        if: always()
+        run: |
+          LINT="${{ needs.lint.result }}"
+          TYPE="${{ needs.typecheck.result }}"
+          TEST="${{ needs.test.result }}"
+
+          echo "=== PR Quality Gate Summary ==="
+          echo "Lint: $LINT"
+          echo "TypeCheck: $TYPE"
+          echo "Tests: $TEST"
+
+          if [ "$LINT" != "success" ] || [ "$TYPE" != "success" ] || [ "$TEST" != "success" ]; then
+            echo "❌ Quality gate failed - merge will be blocked"
+            exit 1
+          fi
+
+          echo "✅ All quality gates passed - ready for review"
+
+  # ===========================================================================
+  # CODERABBIT STATUS CHECK
+  # ===========================================================================
+
+  coderabbit-check:
+    name: CodeRabbit Status
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test]
+    if: always()
+    steps:
+      - name: Check CodeRabbit configuration
+        run: |
+          echo "🐰 CodeRabbit Integration Status"
+          echo "================================"
+          echo ""
+          echo "CodeRabbit is configured via .coderabbit.yaml"
+          echo "Review will be posted as PR comments automatically"
+          echo ""
+          echo "Severity Handling:"
+          echo "  - CRITICAL: Must fix before merge"
+          echo "  - HIGH: Should address or document"
+          echo "  - MEDIUM/LOW: Optional"
+
+      - name: Checkout for config check
+        uses: actions/checkout@v4
+        with:
+          sparse-checkout: .coderabbit.yaml
+          sparse-checkout-cone-mode: false
+
+      - name: Validate config
+        run: |
+          if [ -f ".coderabbit.yaml" ]; then
+            echo "✅ CodeRabbit configuration found"
+          else
+            echo "⚠️ CodeRabbit configuration not found"
+            echo "Create .coderabbit.yaml to customize review behavior"
+          fi

package/.aios-core/infrastructure/templates/github-workflows/release.yml.template

@@ -0,0 +1,196 @@
+# =============================================================================
+# AIOS Release Automation Template
+# =============================================================================
+# Template for user projects created with AIOS-FULLSTACK
+# Generated by: *setup-github task (Story 5.10)
+#
+# Features:
+#   - Triggered on version tags (v*)
+#   - Automatic changelog generation
+#   - GitHub Release creation
+#   - Optional NPM publishing
+# =============================================================================
+
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Release tag (e.g., v1.0.0)'
+        required: true
+        default: 'v1.0.0'
+
+env:
+  NODE_VERSION: '{{NODE_VERSION}}'
+
+jobs:
+  # ===========================================================================
+  # VALIDATION - Ensure code quality before release
+  # ===========================================================================
+  validate:
+    name: Validate
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        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 lint
+        run: {{LINT_COMMAND}}
+
+      - name: Run typecheck
+        run: {{TYPECHECK_COMMAND}}
+
+      - name: Run tests
+        run: {{TEST_COMMAND}}
+
+      - name: Build
+        run: {{BUILD_COMMAND}}
+
+  # ===========================================================================
+  # CREATE RELEASE
+  # ===========================================================================
+  create-release:
+    name: Create Release
+    runs-on: ubuntu-latest
+    needs: validate
+    outputs:
+      release_id: ${{ steps.create_release.outputs.id }}
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Full history for changelog
+
+      - name: Extract version from tag
+        id: version
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            TAG="${{ github.event.inputs.tag }}"
+          else
+            TAG="${{ github.ref_name }}"
+          fi
+          VERSION=${TAG#v}
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "tag=$TAG" >> $GITHUB_OUTPUT
+
+      - name: Generate changelog
+        id: changelog
+        run: |
+          echo "## 📋 What's New in v${{ steps.version.outputs.version }}" > CHANGELOG.md
+          echo "" >> CHANGELOG.md
+
+          # Get commits since last tag
+          LAST_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          if [ -n "$LAST_TAG" ]; then
+            echo "### 🔄 Changes since $LAST_TAG:" >> CHANGELOG.md
+            echo "" >> CHANGELOG.md
+
+            # Group commits by type
+            echo "#### Features" >> CHANGELOG.md
+            git log --pretty=format:"* %s (%h)" $LAST_TAG..HEAD | grep -E "^\\* feat" >> CHANGELOG.md || echo "* No new features" >> CHANGELOG.md
+            echo "" >> CHANGELOG.md
+
+            echo "#### Bug Fixes" >> CHANGELOG.md
+            git log --pretty=format:"* %s (%h)" $LAST_TAG..HEAD | grep -E "^\\* fix" >> CHANGELOG.md || echo "* No bug fixes" >> CHANGELOG.md
+            echo "" >> CHANGELOG.md
+
+            echo "#### Other Changes" >> CHANGELOG.md
+            git log --pretty=format:"* %s (%h)" $LAST_TAG..HEAD | grep -vE "^\\* (feat|fix)" >> CHANGELOG.md || echo "* No other changes" >> CHANGELOG.md
+          else
+            echo "### 🎉 Initial Release" >> CHANGELOG.md
+            echo "" >> CHANGELOG.md
+            git log --pretty=format:"* %s (%h)" HEAD~10..HEAD >> CHANGELOG.md 2>/dev/null || echo "* Initial release" >> CHANGELOG.md
+          fi
+
+          echo "" >> CHANGELOG.md
+          echo "---" >> CHANGELOG.md
+          echo "*Released by AIOS Release Automation*" >> CHANGELOG.md
+
+      - name: Create Release
+        id: create_release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          # Create the release using GitHub CLI
+          gh release create "${{ steps.version.outputs.tag }}" \
+            --title "{{PROJECT_NAME}} ${{ steps.version.outputs.tag }}" \
+            --notes-file CHANGELOG.md \
+            --verify-tag || true
+
+          # Get release info for outputs
+          RELEASE_INFO=$(gh api repos/${{ github.repository }}/releases/tags/${{ steps.version.outputs.tag }})
+          echo "id=$(echo "$RELEASE_INFO" | jq -r '.id')" >> $GITHUB_OUTPUT
+
+  # ===========================================================================
+  # BUILD AND UPLOAD ASSETS
+  # ===========================================================================
+  build-and-upload:
+    name: Build Assets
+    needs: create-release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        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: Build
+        run: {{BUILD_COMMAND}}
+
+      - name: Create distribution archive
+        run: |
+          VERSION="${{ needs.create-release.outputs.version }}"
+          tar -czf {{PROJECT_NAME}}-${VERSION}.tar.gz \
+            --exclude=node_modules \
+            --exclude=.git \
+            --exclude='*.log' \
+            .
+
+      - name: Upload Release Asset
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="${{ needs.create-release.outputs.version }}"
+          gh release upload "${{ github.ref_name }}" \
+            "{{PROJECT_NAME}}-${VERSION}.tar.gz" \
+            --clobber
+
+  # ===========================================================================
+  # NOTIFY
+  # ===========================================================================
+  notify:
+    name: Notify
+    needs: [create-release, build-and-upload]
+    if: always()
+    runs-on: ubuntu-latest
+    steps:
+      - name: Notify completion
+        run: |
+          if [ "${{ needs.build-and-upload.result }}" = "success" ]; then
+            echo "🎉 Release ${{ github.ref_name }} created successfully!"
+            echo "🔗 Release URL: https://github.com/${{ github.repository }}/releases/tag/${{ github.ref_name }}"
+          else
+            echo "❌ Release process encountered issues"
+            exit 1
+          fi

package/.aios-core/infrastructure/templates/gitignore/gitignore-aios-base.tmpl

@@ -0,0 +1,63 @@
+# ========================================
+# AIOS Base Ignores
+# Generated by AIOS Documentation Integrity System
+# ========================================
+
+# AIOS Local Configuration
+.aios-core/local/
+.aios-core/*.local.yaml
+.aios-core/logs/
+.aios-core/cache/
+
+# Environment Files
+.env
+.env.local
+.env.*.local
+.env.development
+.env.test
+.env.production
+
+# IDE & Editor
+.vscode/settings.json
+.vscode/*.code-workspace
+.idea/
+*.sublime-workspace
+*.sublime-project
+
+# OS Files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+desktop.ini
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Temporary Files
+tmp/
+temp/
+*.tmp
+*.temp
+*.swp
+*.swo
+*~
+
+# Backup Files
+*.bak
+*.backup
+*.orig
+
+# Archives
+*.zip
+*.tar.gz
+*.rar

package/.aios-core/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl

@@ -0,0 +1,18 @@
+# ========================================
+# AIOS Integration Section
+# Added by AIOS Documentation Integrity System
+# Date: {{GENERATED_DATE}}
+# ========================================
+
+# AIOS Local Configuration
+.aios-core/local/
+.aios-core/*.local.yaml
+.aios-core/logs/
+.aios-core/cache/
+
+# AIOS Generated (optional - uncomment if needed)
+# .aios-core/generated/
+
+# ========================================
+# End of AIOS Integration Section
+# ========================================

package/.aios-core/infrastructure/templates/gitignore/gitignore-node.tmpl

@@ -0,0 +1,85 @@
+# ========================================
+# Node.js Ignores
+# Generated by AIOS Documentation Integrity System
+# ========================================
+
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Build Output
+dist/
+build/
+out/
+.next/
+.nuxt/
+.output/
+.cache/
+
+# TypeScript
+*.tsbuildinfo
+.tscache/
+
+# Testing
+coverage/
+.nyc_output/
+junit.xml
+test-results/
+
+# Package Managers
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+.yarn/
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# ESLint
+.eslintcache
+
+# Prettier
+.prettiercache
+
+# Parcel / Bundlers
+.parcel-cache/
+.turbo/
+.vercel/
+.netlify/
+
+# Serverless
+.serverless/
+
+# Next.js
+.next/
+out/
+
+# Nuxt.js
+.nuxt/
+dist/
+
+# Gatsby
+.cache/
+public/
+
+# VuePress
+.vuepress/dist/
+
+# Storybook
+storybook-static/
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# Debug
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*