fraim-framework 1.0.0

package/setup.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+
+/**
+ * FRAIM Setup Script
+ * Framework for Rigor-based AI Management
+ * 
+ * This script sets up the FRAIM framework in a GitHub repository,
+ * implementing the RIGOR methodology for coordinated AI agent development.
+ */
+
+const { program } = require('commander');
+const fs = require('fs');
+const path = require('path');
+
+// FRAIM branding
+const FRAIM_BANNER = `
+╔══════════════════════════════════════════════════════════════╗
+║  🚀 FRAIM Setup                                              ║
+║  Framework for Rigor-based AI Management                    ║
+║  Where humans become AI managers                            ║
+╚══════════════════════════════════════════════════════════════╝
+`;
+
+// FRAIM methodology labels
+const FRAIM_LABELS = [
+  // Phase Labels (RIGOR methodology)
+  { name: 'phase:design', color: 'C2E0C6', description: 'Design phase - RFC creation and review (RIGOR: Reviews)' },
+  { name: 'phase:impl', color: 'FEF2C0', description: 'Implementation phase - code development (RIGOR: Idempotency)' },
+  { name: 'phase:tests', color: 'D4C5F9', description: 'Testing phase - test creation and validation (RIGOR: Observability)' },
+  
+  // Status Labels  
+  { name: 'status:wip', color: 'FBCA04', description: 'Work in progress' },
+  { name: 'status:needs-review', color: 'EB6420', description: 'Ready for review' },
+  { name: 'status:complete', color: '0E8A16', description: 'Work completed' },
+  
+  // AI Agent Labels (AI Management)
+  { name: 'ai-agent:cursor', color: '1F77B4', description: 'Assigned to Cursor agent (IDE development)' },
+  { name: 'ai-agent:claude', color: 'FF7F0E', description: 'Assigned to Claude agent (Conversational AI)' },
+  { name: 'ai-agent:windsurf', color: '2CA02C', description: 'Assigned to Windsurf agent (Code understanding)' },
+  
+  // Priority Labels (optional)
+  { name: 'priority:critical', color: 'D93F0B', description: 'Critical priority' },
+  { name: 'priority:high', color: 'FBCA04', description: 'High priority' },
+  { name: 'priority:medium', color: '0E8A16', description: 'Medium priority' },
+  { name: 'priority:low', color: '0366D6', description: 'Low priority' }
+];
+
+// Main setup function
+async function setupFRAIM(options) {
+    console.log(FRAIM_BANNER);
+    console.log('🚀 Setting up FRAIM in your repository...\n');
+    
+    console.log('📋 This will create:');
+    console.log('  • GitHub labels for AI management');
+    console.log('  • Automated workflows');
+    console.log('  • AI agent configurations');
+    console.log('  • Documentation templates\n');
+    
+    if (options.dryRun) {
+        console.log('🔍 DRY RUN MODE - No changes will be made\n');
+    }
+    
+    console.log('🎯 Ready to become an AI manager?');
+    console.log('   Run: npx @fraim/framework init  # For full setup');
+    console.log('   Or: npx @fraim/framework wizard # For interactive setup');
+}
+
+// CLI setup
+program
+    .name('fraim-setup')
+    .description('Setup FRAIM framework in your repository')
+    .version('1.0.0')
+    .option('--repo <repository>', 'GitHub repository (owner/repo)')
+    .option('--config <file>', 'Configuration file path')
+    .option('--dry-run', 'Show what would be done without making changes')
+    .option('--labels-only', 'Only setup GitHub labels')
+    .option('--workflows-only', 'Only setup GitHub workflows')
+    .action(setupFRAIM);
+
+// Parse arguments
+program.parse();
+
+// If no arguments provided, show help
+if (process.argv.length === 2) {
+    program.help();
+}

package/test-config.json

@@ -0,0 +1,32 @@
+{
+  "repository": {
+    "owner": "mathursrus",
+    "name": "fraim-test",
+    "branch": "main"
+  },
+  "features": {
+    "labels": true,
+    "workflows": true,
+    "agentRules": ["cursor", "claude", "windsurf"],
+    "deployments": {
+      "enabled": false,
+      "environments": ["ppe", "production"]
+    }
+  },
+  "phases": {
+    "design": { "required_approvals": 1 },
+    "implementation": { "required_approvals": 1 },
+    "testing": { "auto_deploy_on_approval": false }
+  },
+  "customization": {
+    "additionalLabels": [
+      {
+        "name": "test-label",
+        "color": "FF0000",
+        "description": "Test label for validation"
+      }
+    ],
+    "workflowOverrides": {},
+    "agentRuleOverrides": {}
+  }
+}

package/workflows/setup-fraim.yml

@@ -0,0 +1,147 @@
+name: Setup FRAIM
+
+on:
+  workflow_dispatch:
+    inputs:
+      agents:
+        description: 'AI Agents to enable'
+        required: true
+        default: 'cursor,claude,windsurf'
+        type: choice
+        options:
+        - 'cursor,claude,windsurf'
+        - 'cursor,claude'
+        - 'cursor,windsurf'
+        - 'claude,windsurf'
+        - 'cursor'
+        - 'claude'
+        - 'windsurf'
+      enable_deployments:
+        description: 'Enable deployment workflows'
+        required: false
+        default: false
+        type: boolean
+      dry_run:
+        description: 'Dry run (preview changes only)'
+        required: false
+        default: true
+        type: boolean
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  setup-fraim:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install FRAIM
+        run: |
+          # Download and install FRAIM framework
+          curl -sSL https://github.com/mathursrus/Ashley-Calendar-AI/archive/master.tar.gz | tar -xz --strip-components=2 Ashley-Calendar-AI-master/FRAIM/
+          
+          # Create configuration
+          cat > fraim-config.json << EOF
+          {
+            "repository": {
+              "owner": "${{ github.repository_owner }}",
+              "name": "${{ github.event.repository.name }}",
+              "branch": "${{ github.event.repository.default_branch }}"
+            },
+            "features": {
+              "labels": true,
+              "workflows": true,
+              "agentRules": [${{ github.event.inputs.agents }}],
+              "deployments": {
+                "enabled": ${{ github.event.inputs.enable_deployments }}
+              }
+            }
+          }
+          EOF
+
+      - name: Run FRAIM Setup
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          REPO="${{ github.repository }}"
+          
+          if [ "${{ github.event.inputs.dry_run }}" = "true" ]; then
+            echo "🧪 Running in dry-run mode..."
+            node setup.js --repo "$REPO" --config fraim-config.json --dry-run --verbose
+          else
+            echo "🚀 Setting up FRAIM framework..."
+            node setup.js --repo "$REPO" --config fraim-config.json --verbose
+          fi
+
+      - name: Create Success Issue
+        if: github.event.inputs.dry_run == 'false'
+        uses: actions/github-script@v6
+        with:
+          script: |
+            github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: '🎉 FRAIM Setup Complete!',
+              body: `## FRAIM Successfully Installed! 🚀
+
+            Your repository is now equipped with the FRAIM framework for Rigor-based AI Management.
+
+            ### What's Been Set Up
+            - ✅ **GitHub Labels**: Phase, status, agent, and priority labels
+            - ✅ **Workflows**: Automated branch and PR management
+            - ✅ **Agent Configs**: ${{ github.event.inputs.agents }} agent configurations
+            - ✅ **Documentation**: Templates and guides
+
+            ### Next Steps
+            1. **Create an issue** for your first task
+            2. **Add phase label**: \`phase:design\`, \`phase:impl\`, or \`phase:tests\`
+            3. **Add agent label**: \`ai-agent:cursor\`, \`ai-agent:claude\`, or \`ai-agent:windsurf\`
+            4. **Watch the automation** create branches and PRs automatically!
+
+            ### Example Workflow
+            \`\`\`
+            1. Create issue: "Add user authentication feature"
+            2. Add labels: "phase:design" + "ai-agent:claude"
+            3. GitHub creates branch: feature/123-add-user-authentication-feature
+            4. Claude creates RFC and marks "status:needs-review"
+            5. After approval, change to "phase:impl" + "ai-agent:cursor"
+            6. Cursor implements the feature and tests
+            7. Code review and merge!
+            \`\`\`
+
+            ### Resources
+            - 📚 [FRAIM Documentation](https://github.com/mathursrus/Ashley-Calendar-AI/tree/master/FRAIM)
+            - 🤖 [Agent Coordination Guide](https://github.com/mathursrus/Ashley-Calendar-AI/tree/master/FRAIM/docs/guides)
+            - 🏗️ [Architecture Overview](https://github.com/mathursrus/Ashley-Calendar-AI/tree/master/FRAIM/docs/architecture)
+
+            **Welcome to the future of AI management!** 🤖✨`,
+              labels: ['phase:design', 'status:complete', 'documentation']
+            });
+
+      - name: Setup Summary
+        if: always()
+        run: |
+          echo "## 🎯 FRAIM Setup Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Repository**: ${{ github.repository }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Agents**: ${{ github.event.inputs.agents }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Deployments**: ${{ github.event.inputs.enable_deployments }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Dry Run**: ${{ github.event.inputs.dry_run }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          
+          if [ "${{ github.event.inputs.dry_run }}" = "true" ]; then
+            echo "✅ **Dry run completed successfully!**" >> $GITHUB_STEP_SUMMARY
+            echo "Re-run this workflow with 'Dry run' unchecked to apply changes." >> $GITHUB_STEP_SUMMARY
+          else
+            echo "🚀 **FRAIM setup completed!**" >> $GITHUB_STEP_SUMMARY
+            echo "Check the issues tab for your welcome issue with next steps." >> $GITHUB_STEP_SUMMARY
+          fi