Saphan StudioDocs
Reference/Commands

saphan verify-union

Tests what a stream's branch does once merged: it combines the branch with the current tip of its trunk in a temporary detached worktree and runs the repository's full test suite there, then removes t

Tests what a stream's branch does once merged: it combines the branch with the current tip of its trunk in a temporary detached worktree and runs the repository's full test suite there, then removes that worktree. The verdict — clean-green, clean-red, clean-crash (the suite failed to build or crashed) or conflict (git could not combine them, so nothing ran) — is recorded against both commits under <workspace>/.saphan/union/<stream>/. saphan merge reads it for the exact pair it lands and writes its assessment to the record, but in this release it does not refuse a merge whose union is missing, stale or red: the result is advisory. ⚠ The suite's time limit must be declared first with saphan config set verify.full.timeout "<duration>", and an existing record for the same pair is returned without running again.

saphan verify-union <stream>
flagtypedefaultwhat it does
--forceboolfalseRun again even when this exact pair of commits is already recorded, replacing the record.
--statusboolfalseShow the last recorded verdict without running anything, whether either commit has moved since (STALE), and any leftover temporary worktrees; cannot be combined with --force.

Global options apply to every command — see Every command.