Wiki Analytics Specification MCP Server

name: Transform Wiki to Specs on: # Automated daily sync (optional - uncomment to enable) # schedule: # # Run once daily at 2 AM UTC # - cron: '0 2 * * *' # Allow manual triggering from GitHub UI workflow_dispatch: inputs: force_transform: description: 'Force transformation even if no wiki changes detected' required: false type: boolean default: false jobs: transform: runs-on: ubuntu-latest permissions: contents: write env: HUSKY: 0 # Disable Husky hooks in CI (bot is allowed to commit specs) steps: # Step 1: Checkout main repo - name: Checkout main repository uses: actions/checkout@v4 with: fetch-depth: 0 # Full history needed for tracking # Step 2: Clone wiki repository - name: Clone wiki repository run: | echo "📚 Cloning wiki repository..." git clone https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.wiki.git wiki cd wiki echo "Latest wiki commit: $(git rev-parse HEAD)" cd .. # Step 3: Check for wiki changes - name: Check for wiki changes id: check_changes run: | echo "🔍 Checking for wiki changes..." # Get the last processed wiki commit hash if [ -f .last_wiki_commit ]; then LAST_COMMIT=$(cat .last_wiki_commit) echo "Last processed wiki commit: $LAST_COMMIT" else LAST_COMMIT="" echo "No previous wiki commit found (first run)" fi # Get current wiki commit hash cd wiki CURRENT_COMMIT=$(git rev-parse HEAD) cd .. echo "Current wiki commit: $CURRENT_COMMIT" # Check if there are new commits or force flag is set FORCE="${{ inputs.force_transform }}" if [ "$FORCE" = "true" ]; then echo "⚡ Force transformation requested" echo "has_changes=true" >> $GITHUB_OUTPUT echo "current_commit=$CURRENT_COMMIT" >> $GITHUB_OUTPUT echo "reason=forced" >> $GITHUB_OUTPUT elif [ "$LAST_COMMIT" != "$CURRENT_COMMIT" ]; then echo "✅ Wiki has new commits - will transform" echo "has_changes=true" >> $GITHUB_OUTPUT echo "current_commit=$CURRENT_COMMIT" >> $GITHUB_OUTPUT echo "reason=new_commits" >> $GITHUB_OUTPUT else echo "⏭️ No wiki changes detected - skipping transformation" echo "has_changes=false" >> $GITHUB_OUTPUT fi # Step 4: Setup Node.js (only if changes detected) - name: Setup Node.js if: steps.check_changes.outputs.has_changes == 'true' uses: actions/setup-node@v4 with: node-version: '20' cache: 'npm' # Step 5: Install dependencies (only if changes detected) - name: Install dependencies if: steps.check_changes.outputs.has_changes == 'true' run: | echo "📦 Installing dependencies..." npm ci # Step 6: Run transformation (only if changes detected) - name: Build specs from wiki if: steps.check_changes.outputs.has_changes == 'true' run: | echo "🔄 Building specs from wiki..." npm run build echo "✅ Build complete" # Step 7: Check if specs actually changed - name: Check for spec changes if: steps.check_changes.outputs.has_changes == 'true' id: check_spec_changes run: | # Check for both modified tracked files and new untracked files CHANGES=$(git status --porcelain specs/) if [ -z "$CHANGES" ]; then echo "specs_changed=false" >> $GITHUB_OUTPUT echo "ℹ️ No changes to specs (wiki changed but output is identical)" else echo "specs_changed=true" >> $GITHUB_OUTPUT echo "✅ Specs have changed" echo "Changes detected:" echo "$CHANGES" fi # Step 8: Commit and push changes (only if specs changed) - name: Commit and push changes if: steps.check_changes.outputs.has_changes == 'true' && steps.check_spec_changes.outputs.specs_changed == 'true' run: | echo "💾 Committing changes..." # Configure git git config user.name "github-actions[bot]" git config user.email "github-actions[bot]@users.noreply.github.com" # Add specs changes only git add specs/ # Create commit message with wiki commit reference WIKI_COMMIT="${{ steps.check_changes.outputs.current_commit }}" LAST_COMMIT=$(cat .last_wiki_commit 2>/dev/null || echo "") # Get wiki commit messages since last sync cd wiki if [ -n "$LAST_COMMIT" ]; then COMMIT_COUNT=$(git rev-list --count $LAST_COMMIT..$WIKI_COMMIT) COMMIT_LIST=$(git log --format="- %h: %s" $LAST_COMMIT..$WIKI_COMMIT) else COMMIT_COUNT=1 COMMIT_LIST=$(git log --format="- %h: %s" -1 $WIKI_COMMIT) fi cd .. # Build commit message if [ "${{ steps.check_changes.outputs.reason }}" = "forced" ]; then COMMIT_MSG="chore(specs): Regenerate from wiki [skip ci]" elif [ "$COMMIT_COUNT" -eq 1 ]; then WIKI_MSG=$(cd wiki && git log --format="%s" -1 $WIKI_COMMIT) COMMIT_MSG="chore(specs): $WIKI_MSG [skip ci]" else COMMIT_MSG="chore(specs): Multiple wiki updates ($COMMIT_COUNT commits) [skip ci]" fi # Commit specs with subject and body git commit -m "$COMMIT_MSG" \ -m "Automatically synced from wiki." \ -m "Recent wiki changes:" \ -m "$COMMIT_LIST" \ -m "Wiki commit: $WIKI_COMMIT" # Push specs commit git push # ONLY after successful push, update the tracking file echo "$WIKI_COMMIT" > .last_wiki_commit git add .last_wiki_commit git commit -m "chore: update wiki sync marker [skip ci]" git push echo "✅ Changes pushed to repository" # Step 9: Summary - name: Workflow summary if: always() run: | echo "## Workflow Summary" >> $GITHUB_STEP_SUMMARY echo "" >> $GITHUB_STEP_SUMMARY if [ "${{ steps.check_changes.outputs.has_changes }}" = "true" ]; then echo "✅ **Changes detected and processed**" >> $GITHUB_STEP_SUMMARY echo "" >> $GITHUB_STEP_SUMMARY echo "- Wiki commit: \`${{ steps.check_changes.outputs.current_commit }}\`" >> $GITHUB_STEP_SUMMARY echo "- Reason: ${{ steps.check_changes.outputs.reason }}" >> $GITHUB_STEP_SUMMARY if [ "${{ steps.check_spec_changes.outputs.specs_changed }}" = "true" ]; then echo "- Result: Specs updated and committed" >> $GITHUB_STEP_SUMMARY else echo "- Result: No spec changes (transformation produced identical output)" >> $GITHUB_STEP_SUMMARY fi else echo "ℹ️ **No changes detected**" >> $GITHUB_STEP_SUMMARY echo "" >> $GITHUB_STEP_SUMMARY echo "Wiki has not been updated since last transformation." >> $GITHUB_STEP_SUMMARY fi