fraim-framework 1.0.12 → 2.0.2

package/github/sync-on-pr-review.yml

@@ -1,66 +0,0 @@
-name: Sync Issue on PR Review
-on:
-  pull_request_review:
-    types: [submitted]
-
-permissions:
-  pull-requests: write
-  issues: write
-
-concurrency:
-  group: review-sync-${{ github.event.pull_request.number }}
-  cancel-in-progress: true
-
-jobs:
-  sync-on-review:
-    runs-on: ubuntu-latest
-    # no job-level `if` — we branch inside the script
-    env:
-      GH_TOKEN: ${{ secrets.PR_AUTOMATION_TOKEN || secrets.GITHUB_TOKEN }}
-      REPO: ${{ github.repository }}
-    steps:
-      - name: Derive review state, issue number, and branch
-        id: vars
-        shell: bash
-        run: |
-          set -euo pipefail
-          STATE="${{ github.event.review.state }}"
-          BR="${{ github.event.pull_request.head.ref }}"   # e.g., feature/26-slug
-          ISSUE="$(sed -nE 's#^feature/([0-9]+)-.*#\1#p' <<< "$BR" || true)"
-          echo "state=$STATE" >> $GITHUB_OUTPUT
-          echo "issue=$ISSUE" >> $GITHUB_OUTPUT
-          echo "branch=$BR" >> $GITHUB_OUTPUT
-          echo "Detected review state: $STATE; branch: $BR; issue: $ISSUE"
-
-      - name: Handle review states
-        if: steps.vars.outputs.issue != ''
-        shell: bash
-        env:
-          STATE:  ${{ steps.vars.outputs.state }}
-          ISSUE:  ${{ steps.vars.outputs.issue }}
-          PRNUM:  ${{ github.event.pull_request.number }}
-          REPO:   ${{ env.REPO }}
-        run: |
-          set -euo pipefail
-          case "$STATE" in
-            changes_requested)
-              # Flip to WIP
-              gh issue edit "$ISSUE" --repo "$REPO" \
-                --add-label "status:wip" --remove-label "status:needs-review" --remove-label "status:complete" || true
-              gh pr edit "$PRNUM" --repo "$REPO" \
-                --add-label "status:wip" --remove-label "status:needs-review" --remove-label "status:complete" || true
-              ;;
-            approved)
-              # Flip to Complete
-              gh issue edit "$ISSUE" --repo "$REPO" \
-                --add-label "status:complete" --remove-label "status:wip" --remove-label "status:needs-review" || true
-              gh pr edit "$PRNUM" --repo "$REPO" --add-label "status:complete" --remove-label "status:wip" --remove-label "status:needs-review" || true
-              ;;
-            commented)
-              # No-op; comments don’t change state
-              echo "Review was 'commented' — no state change."
-              ;;
-            *)
-              echo "Unknown review state: $STATE"
-              ;;
-          esac

package/scripts/__init__.py

@@ -1,10 +0,0 @@
-"""
-FRAIM Python Package
-Framework for Rigor-based AI Management
-Where humans become AI managers through rigorous methodology
-"""
-
-from .cli import main
-
-__version__ = "1.0.0"
-__all__ = ["main"]

package/scripts/cli.py

@@ -1,141 +0,0 @@
-#!/usr/bin/env python3
-"""
-FRAIM Python CLI
-Framework for Rigor-based AI Management
-Where humans become AI managers through rigorous methodology
-"""
-
-import sys
-import argparse
-
-def show_banner():
-    """Display FRAIM banner"""
-    banner = """
-╔══════════════════════════════════════════════════════════════╗
-║  🚀 FRAIM                                                  ║
-║  Framework for Rigor-based AI Management                    ║
-║  Where humans become AI managers                            ║
-╚══════════════════════════════════════════════════════════════╝
-"""
-    print(banner)
-
-def show_help():
-    """Display help information"""
-    show_banner()
-    print("🤖 Welcome to FRAIM!")
-    print("Where humans become AI managers through rigorous methodology\n")
-
-    print("🚀 Quick commands:")
-    print("  pip install fraim-framework")
-    print("  fraim init     # Setup current repository")
-    print("  fraim rigor    # Learn RIGOR methodology")
-    print("  fraim --help   # Full documentation\n")
-
-    print("🧠 The RIGOR Methodology:")
-    print("  R - Reviews: Structured feedback and approval processes")
-    print("  I - Idempotency: Safe, repeatable operations")
-    print("  G - GitOps: Git as the single source of truth")
-    print("  O - Observability: Complete visibility into AI activities")
-    print("  R - Rollback: Safe recovery from any state\n")
-
-    print("📚 Documentation: https://github.com/mathursrus/Ashley-Calendar-AI/tree/master/FRAIM")
-    print("🎯 Ready to become an AI manager? Run: fraim init")
-
-def show_rigor():
-    """Display RIGOR methodology information"""
-    show_banner()
-    print("🧠 The RIGOR Methodology for AI Management\n")
-
-    print("R - Reviews:")
-    print("  • Structured feedback and approval processes")
-    print("  • Code review workflows with AI agents")
-    print("  • Automated quality gates and checks")
-    print("  • Human oversight of AI decisions\n")
-
-    print("I - Idempotency:")
-    print("  • Safe, repeatable operations")
-    print("  • No side effects from multiple runs")
-    print("  • Consistent results every time")
-    print("  • Rollback-friendly changes\n")
-
-    print("G - GitOps:")
-    print("  • Git as the single source of truth")
-    print("  • Declarative infrastructure and workflows")
-    print("  • Automated deployments from Git changes")
-    print("  • Version-controlled AI agent configurations\n")
-
-    print("O - Observability:")
-    print("  • Complete visibility into AI activities")
-    print("  • Metrics, logs, and tracing")
-    print("  • Performance monitoring and alerting")
-    print("  • Audit trails for compliance\n")
-
-    print("R - Rollback:")
-    print("  • Safe recovery from any state")
-    print("  • Automated rollback mechanisms")
-    print("  • Point-in-time recovery")
-    print("  • Zero-downtime deployments\n")
-
-    print("🎯 This methodology transforms you from a developer into an AI manager!")
-
-def main():
-    """Main CLI entry point"""
-    parser = argparse.ArgumentParser(
-        description="FRAIM: Framework for Rigor-based AI Management",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Examples:
-  fraim init     # Setup FRAIM in current repository
-  fraim rigor    # Learn about RIGOR methodology
-  fraim --help   # Show this help message
-        """
-    )
-    
-    parser.add_argument(
-        "command",
-        nargs="?",
-        choices=["init", "rigor", "setup", "wizard"],
-        help="Command to execute"
-    )
-    
-    parser.add_argument(
-        "--version",
-        action="version",
-        version="FRAIM 1.0.0"
-    )
-    
-    args = parser.parse_args()
-    
-    if not args.command or args.command == "help":
-        show_help()
-        return
-    
-    if args.command == "rigor":
-        show_rigor()
-        return
-    
-    if args.command in ["init", "setup"]:
-        show_banner()
-        print("🚀 Setting up FRAIM in current repository...\n")
-        print("📋 This will:")
-        print("  • Create GitHub labels for AI management")
-        print("  • Set up automated workflows")
-        print("  • Configure AI agent rules")
-        print("  • Initialize documentation\n")
-        print("💡 Run: fraim init  # For full setup")
-        print("🔧 Or run: fraim wizard  # For interactive setup")
-        return
-    
-    if args.command == "wizard":
-        show_banner()
-        print("🔮 FRAIM Interactive Setup Wizard\n")
-        print("This wizard will guide you through:")
-        print("  1. Repository configuration")
-        print("  2. AI agent setup")
-        print("  3. Workflow customization")
-        print("  4. Team member onboarding\n")
-        print("💡 Run: fraim wizard  # To start the wizard")
-        return
-
-if __name__ == "__main__":
-    main()

package/test-config.json

@@ -1,32 +0,0 @@
-{
-  "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

@@ -1,147 +0,0 @@
-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