feat: Architecture Review action V1

.codeboarding/.codeboardingignore

@@ -0,0 +1,133 @@
+# CodeBoarding Ignore File
+# Add patterns here for files and directories that should be excluded from CodeBoarding analysis.
+# Use the same format as .gitignore (gitignore syntax / gitwildmatch patterns).
+#
+# To stop ignoring a pattern, prefix it with ! (e.g., !important_file.txt)
+#
+# NOTE: The following are ALWAYS excluded (not configurable):
+#   - Hidden directories (starting with .)
+#   - .git/, .codeboarding/, node_modules/, __pycache__/
+#   - Build output: build/, dist/, coverage/
+#
+# This file is automatically loaded by CodeBoarding analysis tools to exclude
+# specified paths from code analysis, architecture generation, and other processing.
+
+# ============================================================================
+# Ignored directories (customizable — remove lines to include them)
+# ============================================================================
+
+# Python virtual environments
+venv/
+env/
+*.egg-info/
+
+# Java (Maven/Gradle) and Rust (Cargo) build output. Both ecosystems
+# produce a top-level ``target/`` directory full of compiled artifacts —
+# kept here as well as in ``_ALWAYS_IGNORED_DIRS`` so users who customize
+# their ``.codeboardingignore`` continue to skip it even after edits.
+target/
+bin/
+out/
+
+# .NET / C# build output
+obj/
+
+# Go
+vendor/
+testdata/
+
+# PHP
+cache/
+
+# Custom
+temp/
+repos/
+
+# Bundled React webview build (minified JS — not part of this repo's architecture)
+webview-dist/
+runs/
+
+# ============================================================================
+# Test and infrastructure files
+# ============================================================================
+
+# Test directories
+**/__tests__/**
+**/tests/**
+**/test/**
+**/__test__/**
+**/testing/**
+**/testutil/**
+
+# Java/Kotlin test directories (Maven/Gradle structure)
+**/src/test/**
+**/src/testFixtures/**
+**/src/integration-test/**
+**/src/jmh/**
+**/src/contractTest/**
+**/osgi-tests/**
+
+# Test files by naming convention
+*.test.*
+*.spec.*
+*_test.*
+*test_*.py
+test_*.py
+*Test.java
+*IT.java
+*Test.kt
+*IT.kt
+*Tests.java
+
+# Mock, fixture, and stub directories
+**/__mocks__/**
+**/mocks/**
+**/fixtures/**
+**/fixture/**
+**/stubs/**
+**/stub/**
+**/fakes/**
+**/fake/**
+
+# E2E and integration test directories
+**/e2e/**
+**/integration-tests/**
+**/integration_test*/**
+
+# ============================================================================
+# Non-production code
+# ============================================================================
+
+# Example and documentation code
+**/examples/**
+**/documentation/examples/**
+
+# Generated code
+*.pb.go
+**/generated_parser*
+
+# Java/Kotlin metadata files
+module-info.java
+
+# ============================================================================
+# Build artifacts and minified files
+# ============================================================================
+
+*.bundle.js
+*.bundle.js.map
+*.min.js
+*.min.css
+*.chunk.js
+*.chunk.js.map
+
+# ============================================================================
+# Build tool configs and infrastructure
+# ============================================================================
+
+esbuild*
+webpack*
+rollup*
+vite.config.*
+gulpfile*
+gruntfile*
+*.config.*

.github/workflows/example-usage.yml

@@ -1,126 +1,30 @@
-name: Example Usage of CodeBoarding Action
+name: Architecture review (self-test)
+
+# Self-test: every PR opened against this repo runs the local action.
+# Useful for verifying the action's wiring; on first runs this will hit
+# the "no baseline" path because the repo has no .codeboarding/analysis.json.
 
 on:
-  workflow_dispatch:
-    inputs:
-      repository_url:
-        description: 'Repository URL to test with'
-        required: false
-        default: 'https://github.com/microsoft/markitdown'
-        type: string
-      source_branch:
-        description: 'Source branch for comparison'
-        required: false
-        default: 'main'
-        type: string
-      target_branch:
-        description: 'Target branch for comparison'
-        required: false
-        default: 'develop'
-        type: string
-      output_format:
-        description: 'Output format for documentation'
-        required: false
-        default: '.md'
-        type: choice
-        options:
-          - '.md'
-          - '.rst'
-
   pull_request:
-    branches: [ main, master ]
-    types: [opened, synchronize, reopened]
-  
-  schedule:
-    # Run daily at 2 AM UTC
-    - cron: '0 2 * * *'
+    types: [opened, synchronize, reopened, ready_for_review]
+  workflow_dispatch:
+
+permissions:
+  pull-requests: write
+  contents: write
 
 jobs:
-  update-docs-action-usage:
+  architecture-review:
     runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-
+    if: github.event_name == 'workflow_dispatch' || github.event.pull_request.draft == false
+    timeout-minutes: 60
     steps:
-      - name: Checkout repository
+      - name: Checkout action
         uses: actions/checkout@v4
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          fetch-depth: 0  # Required to access branch history
 
-      # Determine branches based on context
-      - name: Set branch variables
-        id: set-branches
-        run: |
-          if [ "${{ github.event_name }}" = "pull_request" ]; then
-            echo "source_branch=${{ github.head_ref }}" >> $GITHUB_OUTPUT
-            echo "target_branch=${{ github.base_ref }}" >> $GITHUB_OUTPUT
-          elif [ "${{ github.event.inputs.source_branch }}" != "" ] && [ "${{ github.event.inputs.target_branch }}" != "" ]; then
-            echo "source_branch=${{ github.event.inputs.source_branch }}" >> $GITHUB_OUTPUT
-            echo "target_branch=${{ github.event.inputs.target_branch }}" >> $GITHUB_OUTPUT
-          else
-            # Default to current branch and main
-            echo "source_branch=${{ github.ref_name }}" >> $GITHUB_OUTPUT
-            echo "target_branch=main" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Fetch CodeBoarding Documentation
-        id: codeboarding
+      - name: Run CodeBoarding Architecture Review
         uses: ./
         with:
-          repository_url: ${{ github.event.inputs.repository_url }}
-          source_branch: ${{ steps.set-branches.outputs.source_branch }}
-          target_branch: ${{ steps.set-branches.outputs.target_branch }}
-          output_directory: 'docs'
-          output_format: ${{ github.event.inputs.output_format || '.md' }}
-
-      - name: Display Action Results
-        run: |
-          echo "Documentation files created: ${{ steps.codeboarding.outputs.markdown_files_created }}"
-          echo "JSON files created: ${{ steps.codeboarding.outputs.json_files_created }}"
-          echo "Documentation directory: ${{ steps.codeboarding.outputs.output_directory }}"
-          echo "JSON directory: ${{ steps.codeboarding.outputs.json_directory }}"
-          echo "Has changes: ${{ steps.codeboarding.outputs.has_changes }}"
-
-      # Check if we have any changes to commit
-      - name: Check for changes
-        id: git-changes
-        run: |
-          if [ -n "$(git status --porcelain)" ]; then
-            echo "has_git_changes=true" >> $GITHUB_OUTPUT
-          else
-            echo "has_git_changes=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Create Pull Request
-        if: steps.git-changes.outputs.has_git_changes == 'true' && steps.codeboarding.outputs.has_changes == 'true'
-        uses: peter-evans/create-pull-request@v5
-        with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          commit-message: "docs: update codeboarding documentation"
-          title: "📚 CodeBoarding Documentation Update"
-          body: |
-            ## 📚 Documentation Update
-
-            This PR contains updated documentation files fetched from the CodeBoarding service.
-
-            ### 📊 Summary
-            - **Documentation files created/updated**: ${{ steps.codeboarding.outputs.markdown_files_created }}
-            - **JSON files created/updated**: ${{ steps.codeboarding.outputs.json_files_created }}
-            - **Documentation directory**: `${{ steps.codeboarding.outputs.output_directory }}/`
-            - **JSON directory**: `${{ steps.codeboarding.outputs.json_directory }}/`
-            - **Source branch**: `${{ steps.set-branches.outputs.source_branch }}`
-            - **Target branch**: `${{ steps.set-branches.outputs.target_branch }}`
-            - **Output format**: `${{ github.event.inputs.output_format || '.md' }}`
-            - **Repository analyzed**: `${{ steps.codeboarding.outputs.repo_url }}`
-
-            ### 🔍 Changes
-            Files have been updated with fresh documentation content based on code changes between branches.
-
-            ---
-
-            🤖 This PR was automatically generated by the CodeBoarding documentation update workflow.
-          branch: docs/codeboarding-update
-          base: ${{ steps.set-branches.outputs.target_branch }}
-          delete-branch: true
+          llm_api_key: ${{ secrets.OPENROUTER_API_KEY }}
+          agent_model: ${{ secrets.AGENT_MODEL }}
+          parsing_model: ${{ secrets.PARSING_MODEL }}

.gitignore

@@ -8,6 +8,10 @@ test_codeboarding/
 # Logs
 *.log
 
+# Runtime deps (Playwright etc. installed at action execution time)
+node_modules/
+package-lock.json
+
 # OS generated files
 .DS_Store
 .DS_Store?