grimoire-framework 1.0.0

package/.grimoire/product/templates/gemini/settings.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "https://geminicli.com/schemas/settings.json",
+  "previewFeatures": true,
+  "folderTrust": {
+    "enabled": true
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "name": "grimoire-session-init",
+            "type": "command",
+            "command": "node .grimoire/hooks/gemini/session-start.js",
+            "timeout": 5000,
+            "enabled": false
+          }
+        ]
+      }
+    ],
+    "BeforeAgent": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "name": "grimoire-context-inject",
+            "type": "command",
+            "command": "node .grimoire/hooks/gemini/before-agent.js",
+            "timeout": 3000,
+            "enabled": false
+          }
+        ]
+      }
+    ],
+    "BeforeTool": [
+      {
+        "matcher": "write_file|replace|shell",
+        "hooks": [
+          {
+            "name": "grimoire-security-check",
+            "type": "command",
+            "command": "node .grimoire/hooks/gemini/before-tool.js",
+            "timeout": 2000,
+            "enabled": false
+          }
+        ]
+      }
+    ],
+    "AfterTool": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "name": "grimoire-audit-log",
+            "type": "command",
+            "command": "node .grimoire/hooks/gemini/after-tool.js",
+            "timeout": 2000,
+            "enabled": false
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "name": "grimoire-session-persist",
+            "type": "command",
+            "command": "node .grimoire/hooks/gemini/session-end.js",
+            "timeout": 5000,
+            "enabled": false
+          }
+        ]
+      }
+    ]
+  }
+}
+
+

package/.grimoire/product/templates/github-actions-cd.yml

@@ -0,0 +1,213 @@
+# GitHub Actions CD Template
+# Purpose: Continuous Deployment workflow for staging and production
+# Generated by: grimoire-FullStack @github-devops agent
+#
+# Usage: Copy to .github/workflows/cd.yml and customize
+
+name: CD
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Deployment environment'
+        required: true
+        default: 'staging'
+        type: choice
+        options:
+          - staging
+          - production
+
+env:
+  NODE_VERSION: '20.x'
+  # Configure your deployment targets
+  # VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+  # VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+
+jobs:
+  # ============================================================================
+  # DETERMINE ENVIRONMENT
+  # ============================================================================
+  setup:
+    name: Setup Deployment
+    runs-on: ubuntu-latest
+    outputs:
+      environment: ${{ steps.set-env.outputs.environment }}
+      version: ${{ steps.set-version.outputs.version }}
+    steps:
+      - name: Determine environment
+        id: set-env
+        run: |
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+            echo "environment=${{ github.event.inputs.environment }}" >> $GITHUB_OUTPUT
+          elif [[ "${{ github.ref }}" == refs/tags/v* ]]; then
+            echo "environment=production" >> $GITHUB_OUTPUT
+          else
+            echo "environment=staging" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Set version
+        id: set-version
+        run: |
+          if [[ "${{ github.ref }}" == refs/tags/v* ]]; then
+            echo "version=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+          else
+            echo "version=${{ github.sha }}" >> $GITHUB_OUTPUT
+          fi
+
+  # ============================================================================
+  # BUILD FOR DEPLOYMENT
+  # ============================================================================
+  build:
+    name: Build for ${{ needs.setup.outputs.environment }}
+    runs-on: ubuntu-latest
+    needs: setup
+    environment: ${{ needs.setup.outputs.environment }}
+    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 project
+        run: npm run build
+        env:
+          NODE_ENV: production
+          # Add environment-specific build vars
+          # NEXT_PUBLIC_API_URL: ${{ vars.API_URL }}
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-${{ needs.setup.outputs.environment }}
+          path: dist/
+          retention-days: 7
+
+  # ============================================================================
+  # DEPLOY TO STAGING
+  # ============================================================================
+  deploy-staging:
+    name: Deploy to Staging
+    runs-on: ubuntu-latest
+    needs: [setup, build]
+    if: needs.setup.outputs.environment == 'staging'
+    environment:
+      name: staging
+      url: ${{ steps.deploy.outputs.url }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: build-staging
+          path: dist/
+
+      # Vercel deployment example
+      # - name: Deploy to Vercel
+      #   id: deploy
+      #   uses: amondnet/vercel-action@v25
+      #   with:
+      #     vercel-token: ${{ secrets.VERCEL_TOKEN }}
+      #     vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
+      #     vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
+
+      - name: Deploy (placeholder)
+        id: deploy
+        run: |
+          echo "Deploying to staging..."
+          echo "url=https://staging.example.com" >> $GITHUB_OUTPUT
+          echo "::notice::Deployed to staging at https://staging.example.com"
+
+  # ============================================================================
+  # DEPLOY TO PRODUCTION
+  # ============================================================================
+  deploy-production:
+    name: Deploy to Production
+    runs-on: ubuntu-latest
+    needs: [setup, build]
+    if: needs.setup.outputs.environment == 'production'
+    environment:
+      name: production
+      url: ${{ steps.deploy.outputs.url }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: build-production
+          path: dist/
+
+      # Vercel production deployment
+      # - name: Deploy to Vercel Production
+      #   id: deploy
+      #   uses: amondnet/vercel-action@v25
+      #   with:
+      #     vercel-token: ${{ secrets.VERCEL_TOKEN }}
+      #     vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
+      #     vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
+      #     vercel-args: '--prod'
+
+      - name: Deploy (placeholder)
+        id: deploy
+        run: |
+          echo "Deploying to production..."
+          echo "url=https://example.com" >> $GITHUB_OUTPUT
+          echo "::notice::Deployed to production at https://example.com"
+
+  # ============================================================================
+  # DATABASE MIGRATIONS (Optional)
+  # ============================================================================
+  # migrations:
+  #   name: Run Database Migrations
+  #   runs-on: ubuntu-latest
+  #   needs: [setup, deploy-staging, deploy-production]
+  #   if: always() && (needs.deploy-staging.result == 'success' || needs.deploy-production.result == 'success')
+  #   environment: ${{ needs.setup.outputs.environment }}
+  #   steps:
+  #     - name: Checkout code
+  #       uses: actions/checkout@v4
+  #
+  #     - name: Run migrations
+  #       run: npm run db:migrate
+  #       env:
+  #         DATABASE_URL: ${{ secrets.DATABASE_URL }}
+
+  # ============================================================================
+  # POST-DEPLOYMENT VERIFICATION
+  # ============================================================================
+  verify:
+    name: Verify Deployment
+    runs-on: ubuntu-latest
+    needs: [setup, deploy-staging, deploy-production]
+    if: always() && (needs.deploy-staging.result == 'success' || needs.deploy-production.result == 'success')
+    steps:
+      - name: Health check
+        run: |
+          # Add your health check endpoint
+          # curl -f https://${{ needs.setup.outputs.environment }}.example.com/health
+          echo "Deployment verification passed"
+
+      - name: Notify on success
+        if: success()
+        run: |
+          echo "::notice::Successfully deployed to ${{ needs.setup.outputs.environment }}"
+
+      - name: Notify on failure
+        if: failure()
+        run: |
+          echo "::error::Deployment verification failed"
+

package/.grimoire/product/templates/github-actions-ci.yml

@@ -0,0 +1,173 @@
+# GitHub Actions CI Template
+# Purpose: Continuous Integration workflow for testing and validation
+# Generated by: grimoire-FullStack @github-devops agent
+#
+# Usage: Copy to .github/workflows/ci.yml and customize
+
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  NODE_VERSION: '20.x'
+  # Add other environment variables here
+  # DATABASE_URL: ${{ secrets.DATABASE_URL }}
+
+jobs:
+  # ============================================================================
+  # LINT & TYPE CHECK
+  # ============================================================================
+  lint:
+    name: Lint & Type Check
+    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 linting
+        run: npm run lint
+
+      - name: Run type check
+        run: npm run typecheck
+        continue-on-error: false
+
+  # ============================================================================
+  # UNIT TESTS
+  # ============================================================================
+  test:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+    needs: lint
+    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
+        run: npm test
+        env:
+          CI: true
+
+      - name: Upload coverage report
+        uses: codecov/codecov-action@v4
+        if: always()
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
+
+  # ============================================================================
+  # BUILD
+  # ============================================================================
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    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 project
+        run: npm run build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build
+          path: dist/
+          retention-days: 7
+
+  # ============================================================================
+  # SECURITY AUDIT
+  # ============================================================================
+  security:
+    name: Security Audit
+    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 security audit
+        run: npm audit --audit-level=high
+        continue-on-error: true
+
+  # ============================================================================
+  # INTEGRATION TESTS (Optional)
+  # ============================================================================
+  # integration:
+  #   name: Integration Tests
+  #   runs-on: ubuntu-latest
+  #   needs: build
+  #   services:
+  #     postgres:
+  #       image: postgres:15
+  #       env:
+  #         POSTGRES_PASSWORD: postgres
+  #         POSTGRES_DB: test
+  #       ports:
+  #         - 5432:5432
+  #       options: >-
+  #         --health-cmd pg_isready
+  #         --health-interval 10s
+  #         --health-timeout 5s
+  #         --health-retries 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 integration tests
+  #       run: npm run test:integration
+  #       env:
+  #         DATABASE_URL: postgresql://postgres:postgres@localhost:5432/test
+

package/.grimoire/product/templates/github-pr-template.md

@@ -0,0 +1,68 @@
+# Pull Request
+
+## Summary
+<!-- Brief description of changes (1-3 sentences) -->
+
+
+## Type of Change
+<!-- Mark the appropriate option with [x] -->
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+- [ ] Performance improvement
+- [ ] Test update
+
+## Related Issues
+<!-- Link to related issues/stories -->
+- Closes #
+- Related to #
+
+## Changes Made
+<!-- Describe your changes in detail -->
+-
+-
+-
+
+## Testing
+<!-- Describe testing performed -->
+### Test Plan
+- [ ] Unit tests added/updated
+- [ ] Integration tests added/updated
+- [ ] Manual testing performed
+
+### Test Results
+```
+# Paste test output here
+npm test
+```
+
+## Quality Checks
+<!-- Confirm quality gates passed -->
+- [ ] `npm run lint` passes
+- [ ] `npm test` passes
+- [ ] `npm run typecheck` passes (if TypeScript)
+- [ ] `npm run build` succeeds
+- [ ] CodeRabbit review completed (if available)
+
+## Screenshots
+<!-- If UI changes, add before/after screenshots -->
+
+## Checklist
+<!-- Confirm before requesting review -->
+- [ ] My code follows the project's style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] Any dependent changes have been merged and published
+
+## Reviewer Notes
+<!-- Any specific areas that need careful review -->
+
+
+---
+<!-- Do not edit below this line -->
+Generated by grimoire-FullStack @github-devops agent
+

package/.grimoire/product/templates/gordon-mcp.yaml

@@ -0,0 +1,141 @@
+# Docker MCP Gordon Configuration Template
+# Grimoire Framework
+# Version: 1.0.0
+#
+# Usage:
+#   This template is used by the *setup-mcp-docker task to generate
+#   project-specific Docker MCP configurations.
+#
+# Variables:
+#   {{PROJECT_ROOT}} - Project root path
+#   {{GITHUB_TOKEN_ENV}} - GitHub token environment variable name
+#   {{ENABLED_MCPS}} - List of enabled MCPs
+#   {{PRESET_NAME}} - Active preset name
+
+version: '3.8'
+
+services:
+  # ============================================
+  # CORE MCPs
+  # ============================================
+
+  # Filesystem Access
+  # Required for all workflows - read/write project files
+  fs:
+    image: mcp/filesystem
+    command:
+      - /workspace
+    volumes:
+      - {{PROJECT_ROOT}}:/workspace:rw
+    labels:
+      mcp.core: "true"
+      mcp.preset: "core,dev,research,full"
+      mcp.description: "File system access for project files"
+
+  # GitHub Operations
+  # Optional - requires GITHUB_TOKEN
+  github:
+    image: mcp/github
+    environment:
+      - GITHUB_TOKEN=${{GITHUB_TOKEN_ENV:-GITHUB_TOKEN}}
+    labels:
+      mcp.core: "true"
+      mcp.preset: "core,dev,full"
+      mcp.description: "GitHub API for repos, issues, PRs"
+      mcp.requires_auth: "true"
+
+  # HTTP Fetch
+  # Optional - for web requests and scraping
+  fetch:
+    image: mcp/fetch
+    labels:
+      mcp.core: "true"
+      mcp.preset: "core,research,full"
+      mcp.description: "HTTP requests and web scraping"
+
+  # ============================================
+  # OPTIONAL MCPs - Uncomment as needed
+  # ============================================
+
+  # PostgreSQL Database Access
+  # postgres:
+  #   image: mcp/postgres
+  #   environment:
+  #     - DATABASE_URL=${DATABASE_URL}
+  #   labels:
+  #     mcp.preset: "full,db"
+  #     mcp.description: "PostgreSQL database operations"
+  #     mcp.requires_auth: "true"
+
+  # SQLite Database Access
+  # sqlite:
+  #   image: mcp/sqlite
+  #   volumes:
+  #     - {{PROJECT_ROOT}}/data:/data:rw
+  #   labels:
+  #     mcp.preset: "full,db"
+  #     mcp.description: "SQLite database operations"
+
+  # Browser Automation (Puppeteer)
+  # puppeteer:
+  #   image: mcp/puppeteer
+  #   labels:
+  #     mcp.preset: "full,automation"
+  #     mcp.description: "Browser automation"
+
+  # Notion Integration
+  # notion:
+  #   image: mcp/notion
+  #   environment:
+  #     - NOTION_API_KEY=${NOTION_API_KEY}
+  #   labels:
+  #     mcp.preset: "full,productivity"
+  #     mcp.description: "Notion workspace integration"
+  #     mcp.requires_auth: "true"
+
+  # Slack Integration
+  # slack:
+  #   image: mcp/slack
+  #   environment:
+  #     - SLACK_BOT_TOKEN=${SLACK_BOT_TOKEN}
+  #   labels:
+  #     mcp.preset: "full,productivity"
+  #     mcp.description: "Slack messaging"
+  #     mcp.requires_auth: "true"
+
+# ============================================
+# NETWORK CONFIGURATION
+# ============================================
+
+networks:
+  default:
+    name: mcp-network-{{PRESET_NAME:-default}}
+    driver: bridge
+
+# ============================================
+# VOLUMES (Optional - for persistent data)
+# ============================================
+
+# volumes:
+#   mcp-data:
+#     driver: local
+
+# ============================================
+# TEMPLATE NOTES
+# ============================================
+#
+# This template supports variable substitution:
+#
+# 1. Environment variables: ${VAR_NAME} or ${VAR_NAME:-default}
+# 2. Template variables: {{VAR_NAME}} (replaced at generation time)
+#
+# To generate a configuration:
+#   *setup-mcp-docker --project /path/to/project
+#
+# To add MCPs dynamically:
+#   docker mcp server add <name>
+#   *add-mcp <name>
+#
+# To create custom presets:
+#   docker mcp preset create <name> --servers fs,github
+