fraim-framework 1.0.9 → 1.0.10

package/github/phase-change.yml

@@ -0,0 +1,218 @@
+name: Phase Change Handler
+
+on:
+  issues:
+    types: [labeled]
+
+permissions:
+  issues: write
+  pull-requests: write
+  contents: write
+
+jobs:
+  handle-phase-change:
+    runs-on: ubuntu-latest
+    if: |
+      contains(github.event.label.name, 'phase:') ||
+      (github.event.action == 'unlabeled' && contains(github.event.label.name, 'phase:'))
+    
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - name: Setup Git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Auth GitHub CLI
+        run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
+
+      - name: Extract issue details
+        id: issue-details
+        run: |
+          ISSUE_NUMBER="${{ github.event.issue.number }}"
+          ISSUE_TITLE="${{ github.event.issue.title }}"
+          BRANCH_NAME="feature/${ISSUE_NUMBER}-$(echo "$ISSUE_TITLE" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-\|-$//g')"
+          
+          echo "issue_number=$ISSUE_NUMBER" >> $GITHUB_OUTPUT
+          echo "branch_name=$BRANCH_NAME" >> $GITHUB_OUTPUT
+          echo "issue_title=$ISSUE_TITLE" >> $GITHUB_OUTPUT
+
+      - name: Determine current phase
+        id: current-phase
+        run: |
+          LABELS='${{ toJson(github.event.issue.labels) }}'
+          CURRENT_PHASE=""
+          
+          # Extract current phase from labels
+          for label in $(echo "$LABELS" | jq -r '.[].name'); do
+            if [[ $label == phase:* ]]; then
+              CURRENT_PHASE=$label
+              break
+            fi
+          done
+          
+          echo "current_phase=$CURRENT_PHASE" >> $GITHUB_OUTPUT
+          echo "Current phase: $CURRENT_PHASE"
+
+      - name: Ensure branch exists and sync
+        run: |
+          BRANCH_NAME="${{ steps.issue-details.outputs.branch_name }}"
+          BASE="master"
+    
+          git fetch origin "$BASE"
+    
+          if git ls-remote --exit-code --heads origin "$BRANCH_NAME" >/dev/null 2>&1; then
+              echo "Branch $BRANCH_NAME exists, syncing..."
+              git fetch origin "$BRANCH_NAME"
+              git switch "$BRANCH_NAME"
+              git pull --rebase origin "$BRANCH_NAME"
+          else
+              echo "Branch $BRANCH_NAME does not exist, creating from $BASE..."
+              git switch -c "$BRANCH_NAME" "origin/$BASE"
+              git push -u origin "$BRANCH_NAME"
+          fi
+
+            # Design: add EMPTY commit to guarantee a diff
+      - name: phase:design → ensure empty commit (commit if missing)
+        if: steps.current-phase.outputs.current_phase == 'phase:design'
+        shell: bash
+        env:
+          ISSUE: ${{ github.event.issue.number }}
+        run: |
+          ISSUE_NUMBER="${{ steps.issue-details.outputs.issue_number }}"
+          ISSUE_TITLE="${{ steps.issue-details.outputs.issue_title }}"
+          BRANCH_NAME="${{ steps.issue-details.outputs.branch_name }}"
+          
+          # Create empty commit to guarantee branch has commits
+          git commit --allow-empty -m "Design phase initiated for Issue #$ISSUE_NUMBER: $ISSUE_TITLE"
+          git push origin "$BRANCH_NAME"
+          
+          # Create or update Design PR
+          PR_TITLE="[Design] RFC for Issue #$ISSUE_NUMBER: $ISSUE_TITLE"
+          PR_BODY="## Design RFC for Issue #$ISSUE_NUMBER
+
+          This PR contains the design RFC for: $ISSUE_TITLE
+
+          **Phase:** Design
+          **Issue:** #$ISSUE_NUMBER
+          **Branch:** \`$BRANCH_NAME\`
+
+          ### RFC Document
+          - 📋 [RFC Document]($RFC_FILE)
+
+          **Note:** This is a Design PR. Implementation will follow in a separate PR after design approval.
+
+          "
+
+          # Check if PR already exists
+          EXISTING_PR=$(gh pr list --head "$BRANCH_NAME" --json number --jq '.[0].number' 2>/dev/null || echo "")
+          
+          if [ -n "$EXISTING_PR" ]; then
+            echo "Updating existing PR #$EXISTING_PR"
+            gh pr edit "$EXISTING_PR" --title "$PR_TITLE" --body "$PR_BODY"
+            gh pr edit "$EXISTING_PR" --add-label "phase:design" --remove-label "phase:tests" --remove-label "phase:impl" 
+          else
+            echo "Creating new Design PR"
+            gh pr create --title "$PR_TITLE" --body "$PR_BODY" --base master --head "$BRANCH_NAME" --draft
+            # Add labels to the new PR
+            sleep 2  # Brief delay to ensure PR is created
+            NEW_PR=$(gh pr list --head "$BRANCH_NAME" --json number --jq '.[0].number')
+            gh pr edit "$NEW_PR" --add-label "phase:design" --remove-label "phase:tests" --remove-label "phase:impl" 
+          fi
+
+      - name: Handle test phase
+        if: steps.current-phase.outputs.current_phase == 'phase:tests'
+        run: |
+          ISSUE_NUMBER="${{ steps.issue-details.outputs.issue_number }}"
+          ISSUE_TITLE="${{ steps.issue-details.outputs.issue_title }}"
+          BRANCH_NAME="${{ steps.issue-details.outputs.branch_name }}"
+          
+          # Create or update Test Implementation PR
+          PR_TITLE="[Testing] Test Cases for Issue #$ISSUE_NUMBER: $ISSUE_TITLE"
+          PR_BODY="## Test cases for Issue #$ISSUE_NUMBER
+
+          This PR contains the test cases for: $ISSUE_TITLE
+
+          **Phase:** Tests
+          **Issue:** #$ISSUE_NUMBER
+          **Branch:** \`$BRANCH_NAME\`
+
+          ### Test Cases
+    
+
+          **Note:** This is a Test PR. Implementation will follow after test approval.
+
+          "
+
+          # Check if PR already exists
+          EXISTING_PR=$(gh pr list --head "$BRANCH_NAME" --json number --jq '.[0].number' 2>/dev/null || echo "")
+          
+          if [ -n "$EXISTING_PR" ]; then
+            echo "Updating existing PR #$EXISTING_PR"
+            gh pr edit "$EXISTING_PR" --title "$PR_TITLE" --body "$PR_BODY"
+            gh pr edit "$EXISTING_PR" --add-label "phase:tests" --remove-label "phase:design" --remove-label "phase:impl"
+          else
+            echo "Creating new Test Plan PR"
+            gh pr create --title "$PR_TITLE" --body "$PR_BODY" --base master --head "$BRANCH_NAME" --draft
+            # Add labels to the new PR
+            sleep 2  # Brief delay to ensure PR is created
+            NEW_PR=$(gh pr list --head "$BRANCH_NAME" --json number --jq '.[0].number')
+            gh pr edit "$NEW_PR" --add-label "phase:tests" --remove-label "phase:design" --remove-label "phase:impl"
+          fi
+
+      - name: Handle implementation phase
+        if: steps.current-phase.outputs.current_phase == 'phase:impl'
+        run: |
+          ISSUE_NUMBER="${{ steps.issue-details.outputs.issue_number }}"
+          ISSUE_TITLE="${{ steps.issue-details.outputs.issue_title }}"
+          BRANCH_NAME="${{ steps.issue-details.outputs.branch_name }}"
+          
+          # Create or update Implementation PR
+          PR_TITLE="[Implementation] Fixes for Issue #$ISSUE_NUMBER: $ISSUE_TITLE"
+          PR_BODY="## Fixes for Issue #$ISSUE_NUMBER
+
+          This PR contains the fixes for: $ISSUE_TITLE
+
+          **Phase:** Implementation
+          **Issue:** #$ISSUE_NUMBER
+          **Branch:** \`$BRANCH_NAME\`
+
+          ### Fixes
+          
+
+          Closes #$ISSUE_NUMBER
+
+          "
+
+          # Check if PR already exists
+          EXISTING_PR=$(gh pr list --head "$BRANCH_NAME" --json number --jq '.[0].number' 2>/dev/null || echo "")
+          
+          if [ -n "$EXISTING_PR" ]; then
+            echo "Updating existing PR #$EXISTING_PR"
+            gh pr edit "$EXISTING_PR" --title "$PR_TITLE" --body "$PR_BODY"
+            gh pr edit "$EXISTING_PR" --add-label "phase:impl" --remove-label "phase:design" --remove-label "phase:tests"
+          else
+            echo "Creating new Implementation PR"
+            gh pr create --title "$PR_TITLE" --body "$PR_BODY" --base master --head "$BRANCH_NAME" --draft
+            # Add labels to the new PR
+            sleep 2  # Brief delay to ensure PR is created
+            NEW_PR=$(gh pr list --head "$BRANCH_NAME" --json number --jq '.[0].number')
+            gh pr edit "$NEW_PR" --add-label "phase:impl" --remove-label "phase:design" --remove-label "phase:tests"
+          fi
+
+      - name: Normalize ISSUE and PR status to WIP (authoritative)
+        run: |
+          gh issue edit ${{ github.event.issue.number }} --add-label "status:wip" --remove-label "status:needs-review" --remove-label "status:complete" || true
+          
+          # Get the PR number for the current branch and normalize its status
+          BRANCH_NAME="${{ steps.issue-details.outputs.branch_name }}"
+          PR_NUMBER=$(gh pr list --head "$BRANCH_NAME" --json number --jq '.[0].number' 2>/dev/null || echo "")
+          
+          if [ -n "$PR_NUMBER" ]; then
+            gh pr edit "$PR_NUMBER" --add-label "status:wip" --remove-label "status:needs-review" --remove-label "status:complete" || true
+          fi

package/github/status-change.yml

@@ -0,0 +1,68 @@
+name: Status Change → Flip PR Draft/Ready
+
+on:
+  issues:
+    types: [labeled]
+
+permissions:
+  pull-requests: write
+  issues: read
+  contents: write
+
+# Serialize per ISSUE; last status wins
+concurrency:
+  group: status-change-${{ github.event.issue.number }}
+  cancel-in-progress: true
+
+jobs:
+  status-change:
+    if: startsWith(github.event.label.name, 'status:')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0
+
+      - name: Setup Git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Auth GitHub CLI
+        run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
+        
+      - name: Derive branch + find PR
+        id: pr
+        shell: bash
+        env:
+          ISSUE_NUMBER: ${{ github.event.issue.number }}
+          ISSUE_TITLE:  ${{ github.event.issue.title }}
+        run: |
+          set -euo pipefail
+          slug=$(echo "$ISSUE_TITLE" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g;s/^-+|-+$//g')
+          BR="feature/${ISSUE_NUMBER}-${slug}"
+          PR=$(gh pr list --state open --head "$BR" --json number --jq '.[0].number')
+          echo "pr=$PR" >> $GITHUB_OUTPUT
+          echo "label=${{ github.event.label.name }}" >> $GITHUB_OUTPUT
+
+      - name: Flip PR state (Draft/Ready) based on label
+        if: steps.pr.outputs.pr != ''
+        shell: bash
+        env:
+          PR:    ${{ steps.pr.outputs.pr }}
+          LABEL: ${{ steps.pr.outputs.label }}
+        run: |
+          set -euo pipefail
+          case "$LABEL" in
+            status:needs-review)
+              gh pr ready "$PR"
+              gh pr edit  "$PR" --add-label "status:needs-review" --remove-label "status:wip" --remove-label "status:complete" || true
+              ;;
+            status:wip)
+              gh pr edit "$PR" --add-label "status:wip" --remove-label "status:needs-review" --remove-label "status:complete" || true
+              ;;
+            *)
+              echo "No action for label: $LABEL" ;;
+          esac

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

@@ -0,0 +1,66 @@
+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/package.json

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

package/setup.js

@@ -285,98 +285,17 @@ function createLabelsConfigFile() {
 }
 
 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"
-`;
-
-    // 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);
+    // Get the directory where this script is located (FRAIM package directory)
+    const fraimDir = __dirname;
     
-    logSuccess('GitHub workflows created');
+    // Copy actual workflow files from FRAIM/github folder
+    const workflowsSrc = path.join(fraimDir, 'github');
+    if (fs.existsSync(workflowsSrc)) {
+        copyDirectory(workflowsSrc, '.github/workflows');
+        logSuccess('GitHub workflows copied from FRAIM/github folder');
+    } else {
+        logWarning(`github folder not found at ${workflowsSrc}, skipping workflow creation`);
+    }
 }
 
 function createAgentFolders() {