From c12d61ba4f8ec0127bfb7c6fd87ca1e3e0d6af3e Mon Sep 17 00:00:00 2001
From: engineer <engineer@opencode.ai>
Date: Wed, 27 May 2026 14:58:36 -0700
Subject: [PATCH] ci: trigger CUA smoke test on release tags + document test
 policy

- Add v* tag trigger to cua-smoke.yml so releases are E2E tested
- Add 'When to run CUA test' section to AGENTS.md documenting mandatory testing

Closes #13 (partial)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .github/workflows/cua-smoke.yml |  1 +
 AGENTS.md                       | 11 +++++++++++
 2 files changed, 12 insertions(+)

diff --git a/.github/workflows/cua-smoke.yml b/.github/workflows/cua-smoke.yml
index 3067607..1bcd205 100644
--- a/.github/workflows/cua-smoke.yml
+++ b/.github/workflows/cua-smoke.yml
@@ -4,6 +4,7 @@ on:
   workflow_dispatch:
   push:
     branches: [main]
+    tags: ["v*"]
     paths:
       - "scripts/android-cua-smoke.py"
       - "src/**"
diff --git a/AGENTS.md b/AGENTS.md
index 2ffc299..2b6a5cd 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -103,6 +103,17 @@ The correct Azure AI Services endpoint (with actual deployments) is:
 GitHub Actions workflow: `.github/workflows/cua-smoke.yml`
 Secrets required: `AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_ENDPOINT` (already set on `dzianisv/opencode-mobile`).
 
+**Triggers**: Runs on push to `main` (with path filters) AND on `v*` tags (releases).
+
+### When to run CUA test
+
+**MANDATORY**: Run the CUA smoke test before any merge to `main` or release:
+1. Before merging a PR that touches `src/**`, `app/**`, or `scripts/android-cua-smoke.py`
+2. After creating a release tag — CI runs it automatically
+3. When debugging UI issues — run locally with `--include-xml` for richer context
+
+If the CUA test fails, do NOT merge or release until fixed.
+
 ## Secrets Management
 
 All project secrets are stored in Bitwarden vault under folder **`opencode-mobile`**.