aios-core 2.1.0

package/.aios-core/product/templates/github-actions-cd.yml

@@ -0,0 +1,212 @@
+# GitHub Actions CD Template
+# Purpose: Continuous Deployment workflow for staging and production
+# Generated by: AIOS-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/.aios-core/product/templates/github-actions-ci.yml

@@ -0,0 +1,172 @@
+# GitHub Actions CI Template
+# Purpose: Continuous Integration workflow for testing and validation
+# Generated by: AIOS-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/.aios-core/product/templates/github-pr-template.md

@@ -0,0 +1,67 @@
+# 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 AIOS-FullStack @github-devops agent

package/.aios-core/product/templates/gordon-mcp.yaml

@@ -0,0 +1,140 @@
+# Docker MCP Gordon Configuration Template
+# AIOS-FULLSTACK 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

package/.aios-core/product/templates/ide-rules/antigravity-rules.md

@@ -0,0 +1,115 @@
+# AIOS-FULLSTACK Development Rules for AntiGravity
+
+You are working with AIOS-FULLSTACK, an AI-Orchestrated System for Full Stack Development.
+
+## Core Development Rules
+
+### Agent Integration
+- Recognize AIOS agent activations: @dev, @qa, @architect, @pm, @po, @sm, @analyst
+- Agent commands use * prefix: *help, *create-story, *task, *exit
+- Follow agent-specific workflows and patterns
+
+### Story-Driven Development
+1. **Always work from a story file** in docs/stories/
+2. **Update story checkboxes** as you complete tasks: [ ] → [x]
+3. **Maintain the File List** section with all created/modified files
+4. **Follow acceptance criteria** exactly as written
+
+### Code Quality Standards
+- Write clean, maintainable code following project conventions
+- Include comprehensive error handling
+- Add unit tests for all new functionality
+- Follow existing patterns in the codebase
+
+### Testing Protocol
+- Run all tests before marking tasks complete
+- Ensure linting passes: `npm run lint`
+- Verify type checking: `npm run typecheck`
+- Add tests for new features
+
+## AIOS Framework Structure
+
+```
+aios-core/
+├── agents/       # Agent persona definitions
+├── tasks/        # Executable task workflows
+├── workflows/    # Multi-step workflows
+├── templates/    # Document templates
+└── checklists/   # Validation checklists
+
+docs/
+├── stories/      # Development stories
+├── prd/          # Sharded PRD sections
+└── architecture/ # Sharded architecture
+```
+
+## Development Workflow
+
+1. **Read the story** - Understand requirements fully
+2. **Implement sequentially** - Follow task order
+3. **Test thoroughly** - Validate each step
+4. **Update story** - Mark completed items
+5. **Document changes** - Update File List
+
+## Best Practices
+
+### When implementing:
+- Check existing patterns first
+- Reuse components and utilities
+- Follow naming conventions
+- Keep functions focused and small
+
+### When testing:
+- Write tests alongside implementation
+- Test edge cases
+- Verify error handling
+- Run full test suite
+
+### When documenting:
+- Update README for new features
+- Document API changes
+- Add inline comments for complex logic
+- Keep story File List current
+
+## Git & GitHub
+
+- Use conventional commits: `feat:`, `fix:`, `docs:`, etc.
+- Reference story ID in commits: `feat: implement IDE detection [Story 2.1]`
+- Ensure GitHub CLI is configured: `gh auth status`
+- Push regularly to avoid conflicts
+
+## Common Patterns
+
+### Error Handling
+```javascript
+try {
+  // Operation
+} catch (error) {
+  console.error(`Error in ${operation}:`, error);
+  throw new Error(`Failed to ${operation}: ${error.message}`);
+}
+```
+
+### File Operations
+```javascript
+const fs = require('fs-extra');
+const path = require('path');
+
+// Always use absolute paths
+const filePath = path.join(__dirname, 'relative/path');
+```
+
+### Async/Await
+```javascript
+async function operation() {
+  try {
+    const result = await asyncOperation();
+    return result;
+  } catch (error) {
+    // Handle error appropriately
+  }
+}
+```
+
+---
+*AIOS-FULLSTACK AntiGravity Configuration v1.0*