sumo_qa_format_context_bundle
Validate and render a host-neutral issue or PR context bundle into a compact markdown brief for QA review, with explicit warnings for stale or missing facts.
Instructions
Validate and render a host-neutral issue/PR CONTEXT BUNDLE as a compact markdown brief for QA review/planning (issue #149). FILE/FORMAT PLUMBING ONLY — the host gathers the facts; this tool never inspects a repo, makes a network call, or assumes GitHub. A partial/empty bundle is first-class: when little is supplied, the consuming skill falls back to direct repo inspection.
Common natural-language phrasings that map to this tool: "build the review context bundle", "format this PR/issue context for review", "render the context bundle with its freshness", "summarise the diff/CI/test facts I gathered".
bundle is a dict with optional issue_summary, pr_summary,
head_sha, changed_files (each {path, change_kind}),
test_evidence / ci_status (each {result, freshness, source},
plus optional captured_at / detail), and user_constraints.
freshness is one of fresh/stale/unknown/absent; only a FRESH PASS is
safety-supporting — a stale, unknown, or absent fact is rendered with an
explicit "do not claim safety from it" warning. Supply local_head_sha
(the host's live local head) to detect a bundle-vs-local-state conflict;
when the shas differ the brief calls out the divergence instead of
trusting either side. max_files bounds the changed-file list.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bundle | Yes | ||
| local_head_sha | No | ||
| max_files | No |