From 942ed8974bf03c07e3ce0fb1a1ec8a894c3e442a Mon Sep 17 00:00:00 2001
From: Tom Boucher <trekkie@nomorestars.com>
Date: Mon, 18 May 2026 23:30:26 -0400
Subject: [PATCH] chore(changeset): phase.uat-passed v1 (#3184)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .changeset/3184-phase-uat-passed.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/3184-phase-uat-passed.md

diff --git a/.changeset/3184-phase-uat-passed.md b/.changeset/3184-phase-uat-passed.md
new file mode 100644
index 000000000..2b9fc70c1
--- /dev/null
+++ b/.changeset/3184-phase-uat-passed.md
@@ -0,0 +1,5 @@
+---
+type: Added
+pr: TBD
+---
+**`phase.uat-passed` query and `isPhaseUatPassed` SDK export** — adds canonical read-only query `phase.uat-passed` (alias `phase uat-passed`) and programmatic export `isPhaseUatPassed(projectDir, phase, workstream?)` returning typed `{ passed, reasons, reasonsHuman, items }`. Predicate consumes `*-HUMAN-UAT.md` files; hardens against markdown injection (YAML frontmatter, fenced code blocks, HTML comments, blockquote-prefixed lines); surfaces operator-mistake signals as typed `REASON_CODE` frozen enum values (`CASE_MISMATCH`, `ORPHAN_ITEM_MISSING_RESULT`, `BRACKETED_PLACEHOLDER`, `NO_ITEMS_EXTRACTED`). Typed `PhaseUatPassedError extends GSDError` for invalid arguments. Refs #3184.