fraim-framework 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim-framework",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "FRAIM: Framework for Rigor-based AI Management - Where humans become AI managers through rigorous methodology",
   "main": "index.js",
   "bin": {

package/setup.js

@@ -53,90 +53,14 @@ function writeFile(filePath, content) {
     logSuccess(`Created file: ${filePath}`);
 }
 
-function createGitHubLabels() {
-    const labels = [
-        { name: 'phase:design', color: '0e8a16', description: 'Design phase - RFC creation and review' },
-        { name: 'phase:impl', color: '1d76db', description: 'Implementation phase - coding and testing' },
-        { name: 'phase:tests', color: 'fef2c0', description: 'Testing phase - validation and QA' },
-        { name: 'status:wip', color: 'fbca04', description: 'Work in progress' },
-        { name: 'status:needs-review', color: 'd93f0b', description: 'Ready for review' },
-        { name: 'status:complete', color: '0e8a16', description: 'Completed and approved' },
-        { name: 'ai-agent:cursor', color: '5319e7', description: 'Assigned to Cursor AI agent' },
-        { name: 'ai-agent:claude', color: 'c2e0c6', description: 'Assigned to Claude AI agent' },
-        { name: 'ai-agent:windsurf', color: 'bfdadc', description: 'Assigned to Windsurf AI agent' }
-    ];
-
-    const labelsContent = JSON.stringify(labels, null, 2);
-    writeFile('.github/labels.json', labelsContent);
-    
-    logInfo('GitHub labels configuration created');
-    logInfo('You can import these labels using GitHub CLI or the web interface');
-}
-
-function createGitHubWorkflows() {
-    // Phase change workflow
-    const phaseChangeWorkflow = `name: Phase Change Automation
-
-on:
-  issues:
-    types: [labeled, unlabeled]
-
-jobs:
-  phase-change:
-    runs-on: ubuntu-latest
-    if: contains(github.event.issue.labels.*.name, 'phase:') || contains(github.event.label.name, 'phase:')
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      
-      - name: Phase Change Handler
-        run: |
-          echo "Phase change detected for issue #\${{ github.event.issue.number }}"
-          echo "New phase: \${{ github.event.label.name || 'phase removed' }}"
-      
-      - name: Update Issue Status
-        if: contains(github.event.label.name, 'phase:')
-        run: |
-          gh issue edit \${{ github.event.issue.number }} --add-label "status:wip"
-          echo "Status updated to WIP for new phase"
-`;
+function createAgentStructure() {
+    // Create the proper agent directory structure
+    ensureDirectory('agents/cursor/rules');
+    ensureDirectory('agents/claude/rules');
+    ensureDirectory('agents/windsurf/rules');
 
-    // Status change workflow
-    const statusChangeWorkflow = `name: Status Change Automation
-
-on:
-  issues:
-    types: [labeled, unlabeled]
-
-jobs:
-  status-change:
-    runs-on: ubuntu-latest
-    if: contains(github.event.issue.labels.*.name, 'status:') || contains(github.event.label.name, 'status:')
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-      
-      - name: Status Change Handler
-        run: |
-          echo "Status change detected for issue #\${{ github.event.issue.number }}"
-          echo "New status: \${{ github.event.label.name || 'status removed' }}"
-      
-      - name: Notify Team
-        if: contains(github.event.label.name, 'status:needs-review')
-        run: |
-          echo "Issue ready for review - notifying team"
-`;
-
-    writeFile('.github/workflows/phase-change.yml', phaseChangeWorkflow);
-    writeFile('.github/workflows/status-change.yml', statusChangeWorkflow);
-    
-    logSuccess('GitHub workflows created');
-}
-
-function createAgentConfigs() {
-    // Cursor rules - only create if it doesn't exist
-    if (!fs.existsSync('.cursorrules')) {
-        const cursorRules = `# FRAIM Cursor Rules
+    // Create .cursorrules that references modular rules
+    const cursorRules = `# FRAIM Cursor Rules
 
 ## Core Rules (Always Apply)
 - **ashley-architecture.mdc** - Follow the established architecture patterns
@@ -179,24 +103,15 @@ function createAgentConfigs() {
 - Enable observability through clear documentation
 `;
 
-        writeFile('.cursorrules', cursorRules);
-        logSuccess('Cursor rules created');
-    } else {
-        logInfo('Cursor rules already exist, skipping');
-    }
-
-    // Claude rules - only create if it doesn't exist
-    if (!fs.existsSync('CLAUDE.md')) {
-        const claudeRules = `# FRAIM Claude Rules
+    // Create .windsurfrules that references modular rules
+    const windsurfRules = `# FRAIM Windsurf Rules
 
-## Always-On Rules
+## Core Rules (Always Apply)
 - **ashley-architecture.mdc** - Follow the established architecture patterns
 - **continuous-learning.mdc** - Always review retrospectives and RFCs before starting work
-
-## Phase-Specific Rules (Manual Trigger Only)
-- **design.mdc** - Design phase rules
-- **implement.mdc** - Implementation phase rules
-- **test.mdc** - Testing phase rules
+- **local-development.mdc** - Work locally, coordinate remotely
+- **simplicity.mdc** - Keep it simple, don't over-engineer
+- **issue-resolution-process.mdc** - Follow the established issue resolution process
 
 ## Key Behavioral Requirements
 - Always verify actions taken
@@ -217,29 +132,30 @@ function createAgentConfigs() {
 - Use local Git for version control
 - Test locally before committing
 
-## FRAIM Integration
-- Follow the RIGOR methodology
-- Maintain isolation between agents
-- Use GitOps for coordination
-- Enable observability through clear documentation
-`;
+## Architecture and Optimization Principles
+- Follow established patterns
+- Optimize for performance and maintainability
+- Document architectural decisions
+- Consider scalability and security
 
-        writeFile('CLAUDE.md', claudeRules);
-        logSuccess('Claude rules created');
-    } else {
-        logInfo('Claude rules already exist, skipping');
-    }
+## Your Role in FRAIM
+- Provide technical expertise and optimization
+- Maintain code quality and standards
+- Ensure architectural consistency
+- Support other agents with technical guidance
+`;
 
-    // Windsurf rules - only create if it doesn't exist
-    if (!fs.existsSync('.windsurfrules')) {
-        const windsurfRules = `# FRAIM Windsurf Rules
+    // Create CLAUDE.md that references modular rules
+    const claudeRules = `# FRAIM Claude Rules
 
-## Core Rules (Always Apply)
+## Always-On Rules
 - **ashley-architecture.mdc** - Follow the established architecture patterns
 - **continuous-learning.mdc** - Always review retrospectives and RFCs before starting work
-- **local-development.mdc** - Work locally, coordinate remotely
-- **simplicity.mdc** - Keep it simple, don't over-engineer
-- **issue-resolution-process.mdc** - Follow the established issue resolution process
+
+## Phase-Specific Rules (Manual Trigger Only)
+- **design.mdc** - Design phase rules
+- **implement.mdc** - Implementation phase rules
+- **test.mdc** - Testing phase rules
 
 ## Key Behavioral Requirements
 - Always verify actions taken
@@ -260,24 +176,136 @@ function createAgentConfigs() {
 - Use local Git for version control
 - Test locally before committing
 
-## Architecture and Optimization Principles
-- Follow established patterns
-- Optimize for performance and maintainability
-- Document architectural decisions
-- Consider scalability and security
+## FRAIM Integration
+- Follow the RIGOR methodology
+- Maintain isolation between agents
+- Use GitOps for coordination
+- Enable observability through clear documentation
+`;
 
-## Your Role in FRAIM
-- Provide technical expertise and optimization
-- Maintain code quality and standards
-- Ensure architectural consistency
-- Support other agents with technical guidance
+    writeFile('.cursorrules', cursorRules);
+    writeFile('.windsurfrules', windsurfRules);
+    writeFile('CLAUDE.md', claudeRules);
+    
+    logSuccess('AI agent configuration files created');
+}
+
+function createGitHubWorkflows() {
+    // Phase change workflow
+    const phaseChangeWorkflow = `name: Phase Change Automation
+
+on:
+  issues:
+    types: [labeled, unlabeled]
+
+jobs:
+  phase-change:
+    runs-on: ubuntu-latest
+    if: contains(github.event.issue.labels.*.name, 'phase:') || contains(github.event.label.name, 'phase:')
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Phase Change Handler
+        run: |
+          echo "Phase change detected for issue #\${{ github.event.issue.number }}"
+          echo "New phase: \${{ github.event.label.name || 'phase removed' }}"
+      
+      - name: Update Issue Status
+        if: contains(github.event.label.name, 'phase:')
+        run: |
+          gh issue edit \${{ github.event.issue.number }} --add-label "status:wip"
+          echo "Status updated to WIP for new phase"
 `;
 
-        writeFile('.windsurfrules', windsurfRules);
-        logSuccess('Windsurf rules created');
-    } else {
-        logInfo('Windsurf rules already exist, skipping');
-    }
+    // Status change workflow
+    const statusChangeWorkflow = `name: Status Change Automation
+
+on:
+  issues:
+    types: [labeled, unlabeled]
+
+jobs:
+  status-change:
+    runs-on: ubuntu-latest
+    if: contains(github.event.issue.labels.*.name, 'status:') || contains(github.event.label.name, 'status:')
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Status Change Handler
+        run: |
+          echo "Status change detected for issue #\${{ github.event.issue.number }}"
+          echo "New status: \${{ github.event.label.name || 'status removed' }}"
+      
+      - name: Notify Team
+        if: contains(github.event.label.name, 'status:needs-review')
+        run: |
+          echo "Issue ready for review - notifying team"
+`;
+
+    // Sync on PR review workflow
+    const syncOnPRReviewWorkflow = `name: Sync on PR Review
+
+on:
+  pull_request_review:
+    types: [submitted, edited, dismissed]
+
+jobs:
+  sync-review:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Sync Review Status
+        env:
+          GITHUB_TOKEN: \${{ secrets.GITHUB_TOKEN }}
+        run: |
+          PR_NUMBER="\${{ github.event.pull_request.number }}"
+          REVIEW_STATE="\${{ github.event.review.state }}"
+          
+          echo "PR #\$PR_NUMBER review state: \$REVIEW_STATE"
+          
+          if [ "\$REVIEW_STATE" = "approved" ]; then
+            echo "PR approved - updating status"
+            gh pr edit \$PR_NUMBER --add-label "status:approved"
+          elif [ "\$REVIEW_STATE" = "changes_requested" ]; then
+            echo "Changes requested - updating status"
+            gh pr edit \$PR_NUMBER --add-label "status:changes-requested"
+          fi
+          
+          echo "Review sync complete"
+`;
+
+    writeFile('.github/workflows/phase-change.yml', phaseChangeWorkflow);
+    writeFile('.github/workflows/status-change.yml', statusChangeWorkflow);
+    writeFile('.github/workflows/sync-on-pr-review.yml', syncOnPRReviewWorkflow);
+    
+    logSuccess('GitHub workflows created');
+}
+
+function createGitHubLabels() {
+    const labels = [
+        { name: 'phase:design', color: '0e8a16', description: 'Design phase - RFC creation and review' },
+        { name: 'phase:impl', color: '1d76db', description: 'Implementation phase - coding and testing' },
+        { name: 'phase:tests', color: 'fef2c0', description: 'Testing phase - validation and QA' },
+        { name: 'status:wip', color: 'fbca04', description: 'Work in progress' },
+        { name: 'status:needs-review', color: 'd93f0b', description: 'Ready for review' },
+        { name: 'status:complete', color: '0e8a16', description: 'Completed and approved' },
+        { name: 'status:approved', color: '0e8a16', description: 'Approved and ready to merge' },
+        { name: 'status:changes-requested', color: 'd93f0b', description: 'Changes requested in review' },
+        { name: 'ai-agent:cursor', color: '5319e7', description: 'Assigned to Cursor AI agent' },
+        { name: 'ai-agent:claude', color: 'c2e0c6', description: 'Assigned to Claude AI agent' },
+        { name: 'ai-agent:windsurf', color: 'bfdadc', description: 'Assigned to Windsurf AI agent' }
+    ];
+
+    const labelsContent = JSON.stringify(labels, null, 2);
+    writeFile('.github/labels.json', labelsContent);
+    
+    logInfo('GitHub labels configuration created');
+    logInfo('You can import these labels using GitHub CLI or the web interface');
+    logInfo('Or use the GitHub web interface: Settings > Labels > Import labels');
 }
 
 function createFRAIMConfig() {
@@ -299,7 +327,8 @@ function createFRAIMConfig() {
         },
         workflows: [
             ".github/workflows/phase-change.yml",
-            ".github/workflows/status-change.yml"
+            ".github/workflows/status-change.yml",
+            ".github/workflows/sync-on-pr-review.yml"
         ]
     };
 
@@ -315,10 +344,10 @@ function runSetup() {
         // Create only essential directory structure
         ensureDirectory('.github/workflows');
 
-        // Create only essential components
-        createGitHubLabels();
+        // Create all components
+        createAgentStructure();
         createGitHubWorkflows();
-        createAgentConfigs();
+        createGitHubLabels();
         createFRAIMConfig();
 
         logHeader('🎉 Setup Complete!');