fraim-framework 2.0.36 → 2.0.38

package/examples/simple-webapp/example-test.ts

@@ -1,186 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * Example Test Case for FRAIM Framework
- * 
- * This demonstrates how to write test cases using the FRAIM testing framework
- * with proper tagging and structure.
- */
-
-import { BaseTestCase, runTests } from '../../test-utils';
-
-// Example test case interface extending BaseTestCase
-interface ExampleTestCase extends BaseTestCase {
-  description: string;
-  testFunction: () => Promise<boolean>;
-}
-
-// Example test cases with different tags
-const EXAMPLE_TEST_CASES: ExampleTestCase[] = [
-  {
-    name: 'test_basic_functionality',
-    tags: ['smoke', 'basic'],
-    description: 'Should verify basic application functionality works',
-    testFunction: async () => {
-      console.log('🧪 Testing basic functionality...');
-      
-      // Example: Test that a basic function works
-      const result = await basicFunction();
-      
-      if (result !== 'success') {
-        console.log(`❌ Expected 'success', got '${result}'`);
-        return false;
-      }
-      
-      console.log('✅ Basic functionality test passed');
-      return true;
-    }
-  },
-  {
-    name: 'test_user_authentication',
-    tags: ['smoke', 'auth'],
-    description: 'Should verify user authentication works correctly',
-    testFunction: async () => {
-      console.log('🧪 Testing user authentication...');
-      
-      // Example: Test authentication flow
-      const authResult = await authenticateUser('test@example.com', 'password123');
-      
-      if (!authResult.success) {
-        console.log(`❌ Authentication failed: ${authResult.error}`);
-        return false;
-      }
-      
-      console.log('✅ User authentication test passed');
-      return true;
-    }
-  },
-  {
-    name: 'test_api_integration',
-    tags: ['integration', 'api'],
-    description: 'Should verify API integration works correctly',
-    testFunction: async () => {
-      console.log('🧪 Testing API integration...');
-      
-      // Example: Test API call
-      const apiResult = await callExternalAPI('https://api.example.com/data');
-      
-      if (!apiResult || !apiResult.data) {
-        console.log('❌ API integration failed - no data returned');
-        return false;
-      }
-      
-      console.log('✅ API integration test passed');
-      return true;
-    }
-  },
-  {
-    name: 'test_database_operations',
-    tags: ['database', 'integration'],
-    description: 'Should verify database operations work correctly',
-    testFunction: async () => {
-      console.log('🧪 Testing database operations...');
-      
-      // Example: Test database operations
-      const dbResult = await performDatabaseOperation();
-      
-      if (!dbResult.success) {
-        console.log(`❌ Database operation failed: ${dbResult.error}`);
-        return false;
-      }
-      
-      console.log('✅ Database operations test passed');
-      return true;
-    }
-  },
-  {
-    name: 'test_performance_benchmark',
-    tags: ['performance', 'flaky'],
-    description: 'Should verify performance meets requirements (may be flaky)',
-    testFunction: async () => {
-      console.log('🧪 Testing performance benchmark...');
-      
-      const startTime = Date.now();
-      await performExpensiveOperation();
-      const endTime = Date.now();
-      
-      const duration = endTime - startTime;
-      const maxDuration = 1000; // 1 second
-      
-      if (duration > maxDuration) {
-        console.log(`❌ Performance test failed: ${duration}ms > ${maxDuration}ms`);
-        return false;
-      }
-      
-      console.log(`✅ Performance test passed: ${duration}ms`);
-      return true;
-    }
-  },
-  {
-    name: 'test_failing_scenario',
-    tags: ['failing', 'debug'],
-    description: 'This test is currently failing and needs debugging',
-    testFunction: async () => {
-      console.log('🧪 Testing failing scenario...');
-      
-      // This test is intentionally failing to demonstrate the failing tag
-      console.log('❌ This test is currently failing for demonstration');
-      return false;
-    }
-  }
-];
-
-// Mock functions for demonstration
-async function basicFunction(): Promise<string> {
-  // Simulate some work
-  await new Promise(resolve => setTimeout(resolve, 10));
-  return 'success';
-}
-
-async function authenticateUser(email: string, password: string): Promise<{success: boolean, error?: string}> {
-  // Simulate authentication
-  await new Promise(resolve => setTimeout(resolve, 50));
-  
-  if (email === 'test@example.com' && password === 'password123') {
-    return { success: true };
-  }
-  
-  return { success: false, error: 'Invalid credentials' };
-}
-
-async function callExternalAPI(url: string): Promise<{data?: any}> {
-  // Simulate API call
-  await new Promise(resolve => setTimeout(resolve, 100));
-  
-  return {
-    data: {
-      id: 1,
-      name: 'Test Data',
-      timestamp: new Date().toISOString()
-    }
-  };
-}
-
-async function performDatabaseOperation(): Promise<{success: boolean, error?: string}> {
-  // Simulate database operation
-  await new Promise(resolve => setTimeout(resolve, 75));
-  
-  return { success: true };
-}
-
-async function performExpensiveOperation(): Promise<void> {
-  // Simulate expensive operation
-  await new Promise(resolve => setTimeout(resolve, 500));
-}
-
-// Test runner function
-const runExampleTest = async (testCase: ExampleTestCase): Promise<boolean> => {
-  try {
-    return await testCase.testFunction();
-  } catch (error) {
-    console.log(`❌ Test ${testCase.name} threw an error: ${error}`);
-    return false;
-  }
-};
-
-await runTests(EXAMPLE_TEST_CASES, runExampleTest, 'Example Test Suite');

package/registry/github/workflows/ci.yml

@@ -1,51 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-      - 'master'
-  schedule:
-    - cron: '0 6 * * *' # 11 PM PST is 6 AM UTC
-      
-# Sets permissions of the GITHUB_TOKEN
-permissions:
-  contents: read
-  checks: write
-
-# Cancel in-progress runs on same branch
-concurrency:
-  group: ci-${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  build:
-    if: github.event_name == 'push'
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - run: npm install
-      - name: Build
-        run: npm run build
-      - name: Test Smoke CI
-        run: npm run test-smoke-ci
-
-  full-test:
-    runs-on: ubuntu-latest
-    if: github.event_name == 'schedule' && github.ref == 'refs/heads/master'
-    
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 20
-      - run: npm install
-      - name: Build
-        run: npm run build
-      - name: Test All CI
-        run: npm run test-all-ci
-        timeout-minutes: 30

package/registry/github/workflows/phase-change.yml

@@ -1,251 +0,0 @@
-name: Phase Change Handler
-
-# This workflow now assumes branches are created by prep-issue.sh
-# It only handles PR creation/updating and status management
-
-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: Verify branch exists (created by prep-issue.sh)
-        run: |
-          BRANCH_NAME="${{ steps.issue-details.outputs.branch_name }}"
-          
-          # Check if branch exists remotely
-          if git ls-remote --exit-code --heads origin "$BRANCH_NAME" >/dev/null 2>&1; then
-              echo "✓ Branch $BRANCH_NAME exists remotely"
-              git fetch origin "$BRANCH_NAME"
-          else
-              echo "⚠️  Branch $BRANCH_NAME does not exist remotely"
-              echo "   This should have been created by prep-issue.sh"
-              echo "   Please run prep-issue.sh before invoking agent workflows"
-              exit 1
-          fi
-
-      - name: Check if PR already exists
-        id: pr-check
-        run: |
-          BRANCH_NAME="${{ steps.issue-details.outputs.branch_name }}"
-          EXISTING_PR=$(gh pr list --head "$BRANCH_NAME" --json number --jq '.[0].number' 2>/dev/null || echo "")
-          echo "existing_pr=$EXISTING_PR" >> $GITHUB_OUTPUT
-          if [ -n "$EXISTING_PR" ]; then
-            echo "✓ PR #$EXISTING_PR already exists"
-          else
-            echo "ℹ️  No PR exists yet, will create one for phase: ${{ steps.current-phase.outputs.current_phase }}"
-          fi
-
-      - name: phase:spec → create/update PR for Specification phase
-        if: steps.current-phase.outputs.current_phase == 'phase:spec'
-        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 or update PR for Specification phase
-          PR_TITLE="[Specification] Feature Spec for Issue #$ISSUE_NUMBER: $ISSUE_TITLE"
-          PR_BODY="## Feature Specification for Issue #$ISSUE_NUMBER
-
-          This PR contains the feature specification for: $ISSUE_TITLE
-
-          **Phase:** Specification
-          **Issue:** #$ISSUE_NUMBER
-          **Branch:** \`$BRANCH_NAME\`
-
-          ### Specification Document
-          - 📋 [Feature Specification]($SPEC_FILE)
-
-          **Note:** This is a Specification PR. Design and Implementation will follow after specification approval.
-
-          "
-
-          EXISTING_PR="${{ steps.pr-check.outputs.existing_pr }}"
-          
-          if [ -n "$EXISTING_PR" ]; then
-            echo "Updating existing PR #$EXISTING_PR for Specification phase"
-            gh pr edit "$EXISTING_PR" --title "$PR_TITLE" --body "$PR_BODY"
-            gh pr edit "$EXISTING_PR" --add-label "phase:spec" --remove-label "phase:design" --remove-label "phase:tests" --remove-label "phase:impl" 
-          else
-            echo "Creating new PR for Specification phase"
-            gh pr create --title "$PR_TITLE" --body "$PR_BODY" --base master --head "$BRANCH_NAME" --draft
-            gh pr edit --add-label "phase:spec"
-          fi
-
-      - name: phase:design → create/update PR for Design phase
-        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 or update PR for Design phase
-          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.
-
-          "
-
-          EXISTING_PR="${{ steps.pr-check.outputs.existing_pr }}"
-          
-          if [ -n "$EXISTING_PR" ]; then
-            echo "Updating existing PR #$EXISTING_PR for Design phase"
-            gh pr edit "$EXISTING_PR" --title "$PR_TITLE" --body "$PR_BODY"
-            gh pr edit "$EXISTING_PR" --add-label "phase:design" --remove-label "phase:spec" --remove-label "phase:tests" --remove-label "phase:impl" 
-          else
-            echo "Creating new PR for Design phase"
-            gh pr create --title "$PR_TITLE" --body "$PR_BODY" --base master --head "$BRANCH_NAME" --draft
-            gh pr edit --add-label "phase:design"
-          fi
-
-      - name: phase:tests → create/update PR for 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 PR for Test phase
-          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.
-
-          "
-
-          EXISTING_PR="${{ steps.pr-check.outputs.existing_pr }}"
-          
-          if [ -n "$EXISTING_PR" ]; then
-            echo "Updating existing PR #$EXISTING_PR for Test phase"
-            gh pr edit "$EXISTING_PR" --title "$PR_TITLE" --body "$PR_BODY"
-            gh pr edit "$EXISTING_PR" --add-label "phase:tests" --remove-label "phase:spec" --remove-label "phase:design" --remove-label "phase:impl"
-          else
-            echo "Creating new PR for Test phase"
-            gh pr create --title "$PR_TITLE" --body "$PR_BODY" --base master --head "$BRANCH_NAME" --draft
-            gh pr edit --add-label "phase:tests"
-          fi
-
-      - name: phase:impl → create/update PR for 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 PR for Implementation phase
-          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
-
-          "
-
-          EXISTING_PR="${{ steps.pr-check.outputs.existing_pr }}"
-          
-          if [ -n "$EXISTING_PR" ]; then
-            echo "Updating existing PR #$EXISTING_PR for Implementation phase"
-            gh pr edit "$EXISTING_PR" --title "$PR_TITLE" --body "$PR_BODY"
-            gh pr edit "$EXISTING_PR" --add-label "phase:impl" --remove-label "phase:spec" --remove-label "phase:design" --remove-label "phase:tests"
-          else
-            echo "Creating new PR for Implementation phase"
-            gh pr create --title "$PR_TITLE" --body "$PR_BODY" --base master --head "$BRANCH_NAME" --draft
-            gh pr edit --add-label "phase:impl"
-          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
-          
-          # Use the PR number from the check step
-          EXISTING_PR="${{ steps.pr-check.outputs.existing_pr }}"
-          
-          if [ -n "$EXISTING_PR" ]; then
-            gh pr edit "$EXISTING_PR" --add-label "status:wip" --remove-label "status:needs-review" --remove-label "status:complete" || true
-          fi

package/registry/github/workflows/status-change.yml

@@ -1,68 +0,0 @@
-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/registry/github/workflows/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/registry/mcp-template.jsonc

@@ -1,29 +0,0 @@
-// This is a template file to set up MCP servers for dev purposes. Follow these steps
-// 1. Replace <your github pat> with your github personal access token
-// 2. Replace <your context7 api key> with your context7 api key
-// 3. Remove the comments from the file
-//
-// Depending on the coding agent you are using, do the following:
-// Windsurf: Copy this file to .codeium/windsurf/mcp.json (at the user's home directory)
-// Cursor: Copy this file to .cursor/mcp.json
-// Claude: Append the mcpServers object to .claude/settings.json
-
-{
-    "mcpServers": {
-      "git": {
-        "command": "npx",
-        "args": ["-y", "@cyanheads/git-mcp-server"]
-      },
-      "github": {
-        "url": "https://api.githubcopilot.com/mcp/",
-        "headers": {
-          "Authorization": "Bearer <your github pat>"
-        }
-      },
-      "playwright": {
-        "command": "npx",
-        "args": ["-y", "@playwright/mcp"]
-      }
-    }
-  }
-