tianwen

Bump TianWen's version number across all version locations that must stay in sync (the AssemblyVersion in TianWen.Lib.csproj, the VersionPrefix default in each published-app csproj — Cli, Server, UI.FitsViewer, UI.Gui, AI.MCP — and VERSION_PREFIX in .github/workflows/dotnet.yml). Use when the user asks to bump, update, or increment TianWen's version.

Mark a TODO item done in TODO.md and propagate updates to CLAUDE.md, docs/plans/*.md files, and related memory entries. Use when the user asks to tick off, check off, mark done, or close out a TODO item.

Run `tianwen stack` against a folder of FITS lights + calibration. Use when the user asks to stack frames, build a master, integrate a session, or wants a tianwen stack run kicked off (e.g. "stack C:\temp\stack", "integrate the SoL frames", "build a master from the latest session").

Compare test-output PNGs across yyyyMMdd run folders to flag visual regressions. Walks `%TEMP%/TianWen.Lib.Tests/` and `%TEMP%/FC.SDK.Raw.Tests/`, picks the two most recent date directories, diffs same-named PNGs (matched by test-name folder + filename), and reports per-file mean absolute pixel difference, max difference, changed-pixel percent, and byte-size delta. Use after a CPU/GPU pipeline change to confirm nothing else moved, or after refactoring the render pipeline to spot unintended regressions in the Canon CR2, FITS viewer, or stretch-test outputs.

Delete old `yyyyMMdd` test-output date folders under `%TEMP%/TianWen.Lib.Tests/` and `%TEMP%/FC.SDK.Raw.Tests/`, keeping only the N most recent (default 3). These folders accumulate quickly because the test fixtures dump TIFFs/PNGs on every run; pruning keeps disk usage in check. Use when the user asks to clean up, prune, delete old, free disk, or trim test outputs.

Build and launch the TianWen.UI.FitsViewer application with stderr redirected to fitsviewer-stderr.log. Use when the user asks to run, launch, start, or open the FITS viewer.

Cut a TianWen binary release. Triggers a workflow_dispatch run of `.github/workflows/dotnet.yml` on `main`, which builds AOT publishes for all six RIDs (win-x64, win-arm64, linux-x64, linux-arm64, osx-arm64, osx-x64) and creates a GitHub Release tagged `v4.2.<run_number>` with .tar.gz assets for tianwen-cli, tianwen-fits, tianwen-gui, and tianwen-server. Use when the user asks to release, ship, publish, or cut a TianWen release. NOT for sibling NuGet libraries -- use `/release-lib` for those.

Check GitHub Actions CI status across all SharpAstro repos (DIR.Lib, Console.Lib, SdlVulkan.Renderer, Fonts.Lib, FITS.Lib, FC.SDK, ZWOptical.SDK, QHYCCD.SDK, TianWen.DAL, tianwen). Use when the user asks about CI status, build health, latest workflow runs, or whether recent pushes passed.

Build and launch the TianWen.Cli TUI in a new Windows console window with stderr redirected to tui-stderr.log. Use when the user asks to run, launch, start, or open the TianWen TUI.

Release a SharpAstro sibling library (DIR.Lib, Console.Lib, SdlVulkan.Renderer, Fonts.Lib, FITS.Lib, ZWOptical.SDK, QHYCCD.SDK) to NuGet and update TianWen to consume the new version. Handles the full chain - bump, push, poll NuGet, update downstream Directory.Packages.props. Use when the user asks to release, publish, ship, or cut a NuGet package for a SharpAstro library.

Show git status, current branch, last commit, and VersionPrefix across ALL SharpAstro sibling repos (DIR.Lib, Console.Lib, SdlVulkan.Renderer, Fonts.Lib, FITS.Lib, ZWOptical.SDK, QHYCCD.SDK, tianwen). Use when the user asks for status across all repos, which siblings are ahead or dirty, or before a multi-repo release.

Build and launch the TianWen.UI.Gui application with stderr redirected to gui-stderr.log. Use when the user asks to run, launch, start, or open the TianWen GUI.

Run TianWen tests matching a name pattern via `dotnet test --filter "FullyQualifiedName~<pattern>"`. Use when the user asks to run specific tests by name (e.g. "run the Mosaic tests", "test the Session class", "run guider tests"). Dispatches between TianWen.Lib.Tests and TianWen.Lib.Tests.Functional based on the pattern.