fraim-framework 2.0.36 → 2.0.37

package/registry/stubs/workflows/reviewer/review-implementation-vs-feature-spec.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: review-implementation-vs-feature-spec
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("review-implementation-vs-feature-spec")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+To systematically verify that the implementation solves the customer problem and delivers the user experience described in the feature spec, ensuring functional completeness and user value.

package/registry/stubs/workflows/startup-credits/aws-activate-application.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: aws-activate-application
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("aws-activate-application")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+No intent defined.

package/registry/stubs/workflows/startup-credits/google-cloud-application.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: google-cloud-application
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("google-cloud-application")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+No intent defined.

package/registry/stubs/workflows/startup-credits/microsoft-azure-application.md

@@ -0,0 +1,11 @@
+# FRAIM Workflow: microsoft-azure-application
+
+> [!IMPORTANT]
+> This is a **FRAIM-managed workflow stub**. 
+> To load the full context (rules, templates, and execution steps), ask your AI agent to:
+> `@fraim get_fraim_workflow("microsoft-azure-application")`
+>
+> DO NOT EXECUTE.
+
+## Intent
+No intent defined.

package/.github/workflows/ci.yml

@@ -1,65 +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
-    services:
-      mongodb:
-        image: mongo:latest
-        ports:
-          - 27017:27017
-    
-    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
-        env:
-          MONGODB_URI: mongodb://localhost:27017/fraim_test
-        run: npm run test-smoke-ci
-
-  full-test:
-    runs-on: ubuntu-latest
-    if: github.event_name == 'schedule' && github.ref == 'refs/heads/master'
-    services:
-      mongodb:
-        image: mongo:latest
-        ports:
-          - 27017:27017
-    
-    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
-        env:
-          MONGODB_URI: mongodb://localhost:27017/fraim_test
-        run: npm run test-all-ci
-        timeout-minutes: 30

package/.github/workflows/deploy-fraim.yml

@@ -1,87 +0,0 @@
-name: Deploy Fraim Standalone Server
-
-on:
-  workflow_dispatch:
-  push:
-    branches:
-      - master
-    paths:
-      - 'src/fraim-mcp-server.ts'
-      - 'src/fraim/**'
-      - '.ai-agents/**'
-      - '.fraim/**'
-      - '.github/workflows/deploy-fraim.yml'
-
-concurrency:
-  group: deploy-fraim-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  deploy-fraim:
-    runs-on: ubuntu-latest
-    environment: production
-    permissions:
-      id-token: write
-      contents: read
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          cache: 'npm'
-
-      - name: Install dependencies
-        run: npm ci --prefer-offline --no-audit
-
-      - name: Build application
-        run: npm run build
-
-      - name: Login to Azure
-        uses: azure/login@v2
-        with:
-          client-id: 4acc096e-efff-417f-b177-cfa54a53b65c
-          tenant-id: ad354a76-b97f-4ae4-9d93-665418b31e12
-          subscription-id: c3af927d-af55-463b-9810-25bede96d185
-
-      - name: Create deployment package
-        run: |
-          mkdir -p deploy-package
-          # Prune dev dependencies to reduce package size
-          npm prune --production
-          
-          # Copy necessary files
-          cp -r dist deploy-package/
-          cp -r node_modules deploy-package/
-          # Include registry and .fraim directory for runtime
-          cp -r registry deploy-package/
-          cp -r .fraim deploy-package/
-          
-          cp package.json deploy-package/
-          cp package-lock.json deploy-package/
-
-      - name: Configure Startup Command
-        uses: azure/CLI@v2
-        with:
-          inlineScript: |
-            az webapp config appsettings set -g rg-ashley-fraim-prod -n app-ashley-fraim-prod --settings SCM_DO_BUILD_DURING_DEPLOYMENT=false MONGODB_DB_NAME="fraim_prod"
-            az webapp config set -g rg-ashley-fraim-prod -n app-ashley-fraim-prod --startup-file "node dist/src/fraim-mcp-server.js"
-
-      - name: Deploy to Azure Web App
-        uses: azure/webapps-deploy@v3
-        with:
-          app-name: 'app-ashley-fraim-prod'
-          package: ./deploy-package
-
-      - name: Post-deploy health check
-        uses: azure/CLI@v2
-        with:
-          inlineScript: |
-            FRAIM_URL=$(az webapp show -g rg-ashley-fraim-prod -n app-ashley-fraim-prod --query defaultHostName -o tsv)
-            FRAIM_KEY=$(az webapp config appsettings list -g rg-ashley-fraim-prod -n app-ashley-fraim-prod --query "[?name=='FRAIM_API_KEY'].value" -o tsv)
-            echo "🧪 Waiting 30s for startup..."
-            sleep 30
-            curl -f -H "x-api-key: ${FRAIM_KEY}" "https://${FRAIM_URL}/health" && echo "✅ Fraim health check passed!" || echo "⚠️ Fraim health check failed (app may still be starting)"

package/.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/.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/.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/examples/simple-webapp/TESTING.md

@@ -1,62 +0,0 @@
-# Testing with FRAIM Framework
-
-This directory contains example test cases that demonstrate how to use the FRAIM testing framework with proper tagging and structure.
-
-## Test Structure
-
-The example test file (`example-test.ts`) demonstrates:
-
-- **BaseTestCase Interface**: All test cases extend the `BaseTestCase` interface
-- **Tagging System**: Tests are tagged with categories like `smoke`, `integration`, `performance`, etc.
-- **Test Organization**: Tests are organized by functionality and complexity
-- **Mock Functions**: Example mock functions for common scenarios
-
-## Recommended Test Tags (you can add others to your preference)
-
-- **`smoke`**: Critical tests that must pass for basic functionality
-- **`flaky`**: Tests that may be unreliable or environment-dependent
-- **`failing`**: Tests that are currently failing and need debugging
-
-## Running Tests
-
-### Run All Tests
-```bash
-npx run test example-test.ts
-```
-
-### Run Only Smoke Tests
-```bash
-npx run test-smoke example-test.ts
-```
-
-### Run Only Flaky Tests
-```bash
-npx run test-flkay *test*.ts
-```
-
-## Best Practices
-
-1. **Always use tags**: Tag your tests appropriately for easy filtering
-2. **Include descriptions**: Provide clear descriptions of what each test does
-3. **Use meaningful names**: Test names should clearly indicate what's being tested
-4. **Handle errors gracefully**: Catch and report errors appropriately
-5. **Use mocks for external dependencies**: Don't rely on external services in tests
-6. **Test both success and failure cases**: Ensure your tests cover edge cases
-
-## Integration with FRAIM
-
-This testing framework integrates with FRAIM's agent coordination system:
-
-- **AI Agents**: Use these tests during implementation phase
-- **CI/CD**: Automated test execution with proper tagging
-- **Evidence Collection**: Test results are collected as evidence for reviews
-
-## Customization
-
-To adapt this testing framework for your project:
-
-1. **Update mock functions**: Replace example mocks with your actual functions
-2. **Add project-specific tags**: Define tags relevant to your domain
-3. **Customize test structure**: Modify the test case interface as needed
-4. **Add setup/teardown**: Include any necessary test setup or cleanup
-5. **Configure CI integration**: Set up automated test execution in your CI pipeline