ci: add on-demand baseline refresh workflow

[Svilen-Stefanov]

What

Adds .github/workflows/refresh-baseline.yml — a workflow_dispatch (manually-triggered) job that regenerates .codeboarding/analysis.json against main's current tree and commits it, refreshing metadata.commit_hash to main's tip.

Why

The PR review workflow (codeboarding.yml) only ever writes to PR branches — it never refreshes main's committed analysis.json. As a result main's baseline is frozen at the last manual commit (currently the 2026-05-25 baseline), so:

• every PR diffs its head against a stale base, and
• the new webview "explore in browser" link compares head vs the analysis committed at the PR base SHA — which is that same stale file → a misleading diff.

This is the manually-triggered form of the "baseline keeper" described in docs/COMMIT_STRATEGY.md. Run it from Actions → Refresh CodeBoarding baseline → Run workflow to bring main current; re-run whenever main drifts.

How

Reuses the exact engine bootstrap and cb_engine.py base path the review action uses (engine checkout at the pinned engine_ref, Python/Node/uv, LSP servers), then commits the result. Uses the repo's existing OPENROUTER_API_KEY secret and optional AGENT_MODEL/PARSING_MODEL vars. Needs contents: write (declared on the job).

This is a single new workflow file — no changes to the action code.

🤖 Generated with Claude Code

[codeboarding-review]

Architecture review · no architectural changes

graph LR
    n_Analysis_Orchestrator["Analysis Orchestrator"]
    n_Visual_Diff_Engine["Visual Diff Engine"]
    n_UI_Metadata_Generator["UI #amp; Metadata Generator"]
    n_Analysis_Orchestrator -- "Provides analysis.json files to" --> n_Visual_Diff_Engine
    n_Visual_Diff_Engine -- "Passes Mermaid diagram and identifiers to" --> n_UI_Metadata_Generator
    n_Analysis_Orchestrator -- "Supplies repository context to" --> n_UI_Metadata_Generator
    classDef added fill:#1f883d,stroke:#0b5d23,color:#ffffff;
    classDef modified fill:#bf8700,stroke:#7d4e00,color:#ffffff;
    classDef deleted fill:#cf222e,stroke:#82071e,color:#ffffff,stroke-dasharray:5 3;

Loading

Colors indicate component changes compared to main: 🟩 Added · 🟨 Modified · 🟥 Removed

---

See this architecture in your editor: Open in VS Code →

_{codeboarding-action · run 27361481585}