@metasession.co/devaudit-cli 0.3.18 → 0.3.20

package/sdlc/files/_common/scripts/record-uat-execution.test.sh

@@ -0,0 +1,144 @@
+#!/usr/bin/env bash
+# record-uat-execution.test.sh - Regression tests for the manual UAT execution helper.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+HELPER="$SCRIPT_DIR/record-uat-execution.sh"
+[ -x "$HELPER" ] || chmod +x "$HELPER"
+
+PASS=0
+FAIL=0
+
+ok() { echo "  PASS: $1"; PASS=$((PASS + 1)); }
+no() { echo "  FAIL: $1"; FAIL=$((FAIL + 1)); }
+
+make_fixture() {
+  local dir="$1"
+  rm -rf "$dir"
+  mkdir -p "$dir/bin"
+  cat > "$dir/bin/report-test-execution.sh" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+LOG_FILE="${UAT_TEST_LOG:?}"
+printf 'CALL:%s\n' "$*" >> "$LOG_FILE"
+mode="$1"
+shift
+out=""
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --output-file) out="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+if [ -n "$out" ]; then
+  {
+    printf 'execution_supported=true\n'
+    printf 'execution_record_id=execution-%s\n' "$mode"
+    printf 'execution_idempotency_key=stub\n'
+  } >> "$out"
+fi
+EOF
+  chmod +x "$dir/bin/report-test-execution.sh"
+}
+
+run_helper() {
+  UAT_TEST_LOG="$1/uat.log" \
+  DEVAUDIT_BASE_URL="https://devaudit.example.test" \
+  DEVAUDIT_API_KEY="mc_test_dummy" \
+  REPORT_TEST_EXECUTION_HELPER="$1/bin/report-test-execution.sh" \
+  "$HELPER" "${@:2}"
+}
+
+assert_contains() {
+  local label="$1" needle="$2" file="$3"
+  if grep -Fq -- "$needle" "$file"; then ok "$label"; else no "$label"; fi
+}
+
+echo "=== record-uat-execution.sh tests ==="
+
+case_passed_records_stage_four_pair() {
+  echo "case: passed UAT records Stage 4 start and complete"
+  local dir out exit_code
+  dir=$(mktemp -d)
+  make_fixture "$dir"
+  out="$dir/out.env"
+  run_helper "$dir" \
+    --project-slug fixture-app \
+    --release REQ-100 \
+    --outcome passed \
+    --executor "Jane Reviewer" \
+    --tested-sha abc123def456 \
+    --build-version build-42 \
+    --checklist-ref compliance/evidence/REQ-100/uat-checklist.md \
+    --evidence-ref https://devaudit.example.test/projects/fixture-app/releases/release-1 \
+    --executed-at 2026-07-20T12:00:00Z \
+    --output-file "$out" >"$dir/stdout.log" 2>"$dir/stderr.log" && exit_code=0 || exit_code=$?
+  if [ "$exit_code" -eq 0 ]; then ok "exit code 0"; else no "expected exit 0"; fi
+  assert_contains "called start" "CALL:start" "$dir/uat.log"
+  assert_contains "called complete" "CALL:complete" "$dir/uat.log"
+  assert_contains "stage 4" "--sdlc-stage 4" "$dir/uat.log"
+  assert_contains "uat environment" "--environment uat" "$dir/uat.log"
+  assert_contains "uat kind" "--suite-kind uat" "$dir/uat.log"
+  assert_contains "manual provider" "--provider manual_uat" "$dir/uat.log"
+  assert_contains "tested sha" "--commit-sha abc123def456" "$dir/uat.log"
+  assert_contains "passed outcome" "--outcome passed" "$dir/uat.log"
+  assert_contains "executor provenance" "executor=Jane Reviewer" "$dir/uat.log"
+  if grep -q '^uat_execution_id=' "$out"; then ok "output execution id"; else no "missing output execution id"; fi
+  rm -rf "$dir"
+}
+
+case_idempotency_is_stable() {
+  echo "case: derived execution id is stable for repeat command"
+  local dir out1 out2 id1 id2
+  dir=$(mktemp -d)
+  make_fixture "$dir"
+  out1="$dir/out1.env"
+  out2="$dir/out2.env"
+  run_helper "$dir" --project-slug fixture-app --release REQ-100 --outcome passed --executor "Jane Reviewer" --tested-sha abc123def456 --executed-at 2026-07-20T12:00:00Z --output-file "$out1" >/dev/null
+  run_helper "$dir" --project-slug fixture-app --release REQ-100 --outcome passed --executor "Jane Reviewer" --tested-sha abc123def456 --executed-at 2026-07-20T13:00:00Z --output-file "$out2" >/dev/null
+  id1=$(grep '^uat_idempotency_key=' "$out1")
+  id2=$(grep '^uat_idempotency_key=' "$out2")
+  if [ "$id1" = "$id2" ]; then ok "stable idempotency key"; else no "idempotency key changed"; fi
+  rm -rf "$dir"
+}
+
+case_failed_records_remediation() {
+  echo "case: failed UAT includes remediation reference"
+  local dir
+  dir=$(mktemp -d)
+  make_fixture "$dir"
+  run_helper "$dir" \
+    --project-slug fixture-app \
+    --release REQ-100 \
+    --outcome failed \
+    --executor "Jane Reviewer" \
+    --tested-sha abc123def456 \
+    --remediation-ref https://github.com/example/repo/issues/10 \
+    >/dev/null
+  assert_contains "failed outcome" "--outcome failed" "$dir/uat.log"
+  assert_contains "incident reference" "--incident-reference https://github.com/example/repo/issues/10" "$dir/uat.log"
+  rm -rf "$dir"
+}
+
+case_invalid_outcome_fails_before_calls() {
+  echo "case: invalid outcome fails before lifecycle calls"
+  local dir exit_code
+  dir=$(mktemp -d)
+  make_fixture "$dir"
+  run_helper "$dir" --project-slug fixture-app --release REQ-100 --outcome green --executor Jane --tested-sha abc123 >/dev/null 2>"$dir/stderr.log" && exit_code=0 || exit_code=$?
+  if [ "$exit_code" -ne 0 ]; then ok "exit code non-zero"; else no "expected non-zero"; fi
+  if [ ! -f "$dir/uat.log" ]; then ok "no lifecycle call"; else no "unexpected lifecycle call"; fi
+  rm -rf "$dir"
+}
+
+case_passed_records_stage_four_pair
+case_idempotency_is_stable
+case_failed_records_remediation
+case_invalid_outcome_fails_before_calls
+
+echo ""
+echo "=== record-uat-execution.test.sh: $PASS passed, $FAIL failed ==="
+if [ "$FAIL" -gt 0 ]; then
+  exit 1
+fi

package/sdlc/files/_common/scripts/render-test-executions.sh

@@ -0,0 +1,146 @@
+#!/usr/bin/env bash
+# render-test-executions.sh - Render release test executions as markdown tables.
+#
+# Usage:
+#   bash scripts/render-test-executions.sh path/to/release-journey.json
+#
+# Supported input:
+#   First-class test execution payloads with `.testExecutions[]`.
+#
+# Output:
+#   Markdown suitable for inclusion under `## Test Executions` in
+#   `compliance/evidence/REQ-XXX/test-execution-summary.md`.
+
+set -euo pipefail
+
+INPUT_JSON="${1:-}"
+
+if [ -z "$INPUT_JSON" ] || [ ! -f "$INPUT_JSON" ]; then
+  echo "Usage: $0 <release-journey.json>" >&2
+  exit 2
+fi
+
+if ! command -v jq >/dev/null 2>&1; then
+  echo "Error: jq is required." >&2
+  exit 1
+fi
+
+stage_label() {
+  case "$1" in
+    1) printf '1 plan' ;;
+    2) printf '2 implement_test' ;;
+    3) printf '3 compile_evidence' ;;
+    4) printf '4 uat_review' ;;
+    5) printf '5 production' ;;
+    *) printf '%s unknown' "${1:-?}" ;;
+  esac
+}
+
+format_date() {
+  local value="$1"
+  if [ -z "$value" ] || [ "$value" = "null" ]; then
+    printf 'Unknown'
+  else
+    printf '%s' "$value" | sed -E 's/T/ /; s/Z$//; s/[.][0-9]+$//'
+  fi
+}
+
+render_test_executions() {
+  echo "| Source Release | SDLC Stage | Execution | Suite | Outcome | Workflow / Run | Related Evidence | Incident / Remediation | Date |"
+  echo "| --- | --- | --- | --- | --- | --- | --- | --- | --- |"
+
+  declare -A COUNTS=()
+  local rows
+  rows="$(
+    jq -r '
+      (.testExecutions // [])
+      | sort_by(.sourceRelease // "", .sdlcStage // 0, .startedAt // "", .completedAt // "", .suiteKind // .executionKind // "")
+      | .[]
+      | {
+          sourceRelease: (.sourceRelease // "Unknown"),
+          stageCode: ((.sdlcStage // 0) | tostring),
+          kind: (.suiteKind // .executionKind // "unknown"),
+          outcome: (.outcome // "unknown"),
+          workflow: (
+            if (.workflowUrl // "") != "" then
+              "[" + ((.workflowName // "Workflow")) + "](" + .workflowUrl + ")"
+            else
+              (.workflowName // "Manual")
+            end
+          ),
+          runMeta: (
+            [
+              (if (.externalRunId // "") != "" then "run " + .externalRunId else empty end),
+              (if (.externalRunAttempt // null) != null then "attempt " + (.externalRunAttempt | tostring) else empty end)
+            ]
+            | map(select(length > 0))
+            | join(", ")
+          ),
+          evidence: (
+            (.relatedEvidence // [])
+            | map(.displayName // .fileName // .name // .evidenceType // empty)
+            | map(select(length > 0))
+            | join(", ")
+          ),
+          incident: (
+            [
+              (.incidentReference // empty),
+              (.remediationReference // empty),
+              (.outcomeReason // empty)
+            ]
+            | map(select(length > 0))
+            | join("; ")
+          ),
+          date: (.completedAt // .startedAt // "")
+        }
+      | @base64
+    ' "$INPUT_JSON"
+  )"
+
+  if [ -z "$rows" ]; then
+    echo "| Unknown | Unknown | None | unknown | unknown | No test execution records returned | None | None | Unknown |"
+    echo
+    echo "**Final assessment:** No first-class test execution records were returned by the portal."
+    return 0
+  fi
+
+  while IFS= read -r row_b64; do
+    [ -n "$row_b64" ] || continue
+    local source_release stage_code kind outcome workflow run_meta evidence incident date
+    source_release="$(printf '%s' "$row_b64" | base64 -d | jq -r '.sourceRelease')"
+    stage_code="$(printf '%s' "$row_b64" | base64 -d | jq -r '.stageCode')"
+    kind="$(printf '%s' "$row_b64" | base64 -d | jq -r '.kind')"
+    outcome="$(printf '%s' "$row_b64" | base64 -d | jq -r '.outcome')"
+    workflow="$(printf '%s' "$row_b64" | base64 -d | jq -r '.workflow')"
+    run_meta="$(printf '%s' "$row_b64" | base64 -d | jq -r '.runMeta')"
+    evidence="$(printf '%s' "$row_b64" | base64 -d | jq -r '.evidence')"
+    incident="$(printf '%s' "$row_b64" | base64 -d | jq -r '.incident')"
+    date="$(printf '%s' "$row_b64" | base64 -d | jq -r '.date')"
+    [ -n "$source_release" ] || continue
+    local group_key execution_ordinal workflow_cell evidence_cell incident_cell
+    group_key="${source_release}|${stage_code}"
+    COUNTS["$group_key"]=$(( ${COUNTS["$group_key"]:-0} + 1 ))
+    execution_ordinal="#${COUNTS[$group_key]}"
+    workflow_cell="$workflow"
+    if [ -n "$run_meta" ]; then
+      workflow_cell="${workflow_cell} (${run_meta})"
+    fi
+    evidence_cell="${evidence:-None}"
+    incident_cell="${incident:-None}"
+    printf '| %s | %s | %s | %s | %s | %s | %s | %s | %s |\n' \
+      "$source_release" \
+      "$(stage_label "$stage_code")" \
+      "$execution_ordinal" \
+      "$kind" \
+      "$outcome" \
+      "$workflow_cell" \
+      "$evidence_cell" \
+      "$incident_cell" \
+      "$(format_date "$date")"
+  done <<<"$rows"
+
+  echo
+  echo "**Final assessment:** Stage-scoped execution numbering is authoritative from first-class portal test execution records."
+}
+
+render_test_executions

package/sdlc/files/_common/scripts/{render-test-cycles.test.sh → render-test-executions.test.sh}

@@ -1,10 +1,10 @@
 #!/usr/bin/env bash
-# render-test-cycles.test.sh — Tests for render-test-cycles.sh.
+# render-test-executions.test.sh - Tests for render-test-executions.sh.
 
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-HELPER="$SCRIPT_DIR/render-test-cycles.sh"
+HELPER="$SCRIPT_DIR/render-test-executions.sh"
 [ -x "$HELPER" ] || chmod +x "$HELPER"
 
 PASS=0
@@ -27,15 +27,15 @@ assert_contains() {
   fi
 }
 
-echo "=== render-test-cycles.sh tests ==="
+echo "=== render-test-executions.sh tests ==="
 
 cat > "$WORK/first-class.json" <<'EOF'
 {
-  "cycles": [
+  "testExecutions": [
     {
       "sourceRelease": "REQ-091",
       "sdlcStage": 2,
-      "cycleKind": "quality_gate",
+      "suiteKind": "quality_gate",
       "outcome": "failed",
       "workflowName": "Quality Gates",
       "workflowUrl": "https://github.com/example/repo/actions/runs/100",
@@ -49,7 +49,7 @@ cat > "$WORK/first-class.json" <<'EOF'
     {
       "sourceRelease": "REQ-091",
       "sdlcStage": 2,
-      "cycleKind": "quality_gate",
+      "suiteKind": "quality_gate",
       "outcome": "passed",
       "workflowName": "Quality Gates",
       "workflowUrl": "https://github.com/example/repo/actions/runs/101",
@@ -63,7 +63,7 @@ cat > "$WORK/first-class.json" <<'EOF'
     {
       "sourceRelease": "REQ-090",
       "sdlcStage": 4,
-      "cycleKind": "uat",
+      "suiteKind": "uat",
       "outcome": "passed",
       "workflowName": "UAT Review",
       "workflowUrl": "https://portal.example/releases/req-090",
@@ -76,32 +76,26 @@ cat > "$WORK/first-class.json" <<'EOF'
 EOF
 
 OUTPUT="$(bash "$HELPER" "$WORK/first-class.json")"
-assert_contains "first-class heading rendered" "| Source Release | SDLC Stage | Cycle | Kind | Outcome | Workflow / Run | Related Evidence | Incident / Remediation | Date |" "$OUTPUT"
+assert_contains "first-class heading rendered" "| Source Release | SDLC Stage | Execution | Suite | Outcome | Workflow / Run | Related Evidence | Incident / Remediation | Date |" "$OUTPUT"
 assert_contains "stage label rendered" "| REQ-091 | 2 implement_test | #1 | quality_gate | failed | [Quality Gates](https://github.com/example/repo/actions/runs/100) (run 100, attempt 1) | quality-gates.json | #501 | 2026-07-15 08:05:00 |" "$OUTPUT"
 assert_contains "ordinal increments within source release + stage" "| REQ-091 | 2 implement_test | #2 | quality_gate | passed | [Quality Gates](https://github.com/example/repo/actions/runs/101) (run 101, attempt 2) | quality-gates-rerun.json | PR #507 | 2026-07-15 09:07:00 |" "$OUTPUT"
 assert_contains "different release/stage restarts numbering" "| REQ-090 | 4 uat_review | #1 | uat | passed | [UAT Review](https://portal.example/releases/req-090) | uat-checklist.md | None | 2026-07-15 10:12:00 |" "$OUTPUT"
-assert_contains "first-class final assessment rendered" "Stage-scoped cycle numbering is authoritative from first-class portal cycle records." "$OUTPUT"
+assert_contains "first-class final assessment rendered" "Stage-scoped execution numbering is authoritative from first-class portal test execution records." "$OUTPUT"
 
 cat > "$WORK/legacy.json" <<'EOF'
 {
   "legacyCycles": [
     {
       "testCycleId": "287654321",
-      "workflowName": "Legacy E2E",
-      "workflowUrl": "https://github.com/example/repo/actions/runs/287654321",
-      "relatedEvidence": [{ "fileName": "e2e-results.json" }, { "fileName": "screenshot.png" }],
-      "notes": "grouped from uploaded evidence only",
-      "date": "2026-07-14T18:30:00Z"
+      "workflowName": "Legacy E2E"
     }
   ]
 }
 EOF
 
 OUTPUT="$(bash "$HELPER" "$WORK/legacy.json")"
-assert_contains "legacy fallback note rendered" "Legacy portal fallback — first-class cycle records unavailable; grouped by uploaded evidence" "$OUTPUT"
-assert_contains "legacy row rendered" "| Legacy grouped evidence | legacy grouping | 287654321 | legacy | unknown | [Legacy E2E](https://github.com/example/repo/actions/runs/287654321) | e2e-results.json, screenshot.png | grouped from uploaded evidence only | 2026-07-14 18:30:00 |" "$OUTPUT"
-assert_contains "legacy final assessment rendered" "Legacy grouping was used because the portal did not expose first-class cycle records." "$OUTPUT"
+assert_contains "legacy grouping is ignored" "No first-class test execution records were returned by the portal." "$OUTPUT"
 
 echo
-echo "=== render-test-cycles.test.sh: $PASS passed, $FAIL failed ==="
+echo "=== render-test-executions.test.sh: $PASS passed, $FAIL failed ==="
 [ "$FAIL" -eq 0 ]

package/sdlc/files/_common/scripts/{report-test-cycle.sh → report-test-execution.sh}

@@ -1,18 +1,20 @@
 #!/usr/bin/env bash
-# report-test-cycle.sh — Producer helper for first-class cycle lifecycle events.
+# report-test-execution.sh - Producer helper for first-class test execution lifecycle events.
 #
 # Usage:
-#   ./scripts/report-test-cycle.sh start|complete [flags...]
+#   ./scripts/report-test-execution.sh start|complete [flags...]
 #
 # Required flags:
 #   --project-slug <slug>
 #   --release <version>
 #   --sdlc-stage <1-5>
 #   --environment <ci|uat|production>
-#   --cycle-kind <kind>
+#   --suite-kind <kind>
 #   --idempotency-key <key>
 #
 # Optional flags:
+#   --iteration-key <key>
+#   --iteration-ordinal <n>
 #   --provider <name>              Defaults to github_actions
 #   --external-run-id <id>
 #   --external-run-attempt <n>
@@ -26,17 +28,18 @@
 #   --outcome <value>              Terminal outcome for `complete`
 #   --outcome-reason <text>
 #   --incident-reference <text>
+#   --remediation-reference <text>
 #   --output-file <path>           Writes key=value outputs for callers
 #
 # Output keys:
-#   cycle_supported=true|false
-#   cycle_release_id=<uuid-if-resolved>
-#   cycle_release_version=<exact-version-if-resolved>
-#   cycle_record_id=<uuid-if-created-or-updated>
-#   cycle_idempotency_key=<input-key>
-#   cycle_started_at=<iso8601-if-known>
-#   cycle_completed_at=<iso8601-if-known>
-#   cycle_endpoint=<start|complete|reconcile-if-used>
+#   execution_supported=true
+#   execution_release_id=<uuid>
+#   execution_release_version=<exact-version>
+#   execution_record_id=<uuid-if-created-or-updated>
+#   execution_idempotency_key=<input-key>
+#   execution_started_at=<iso8601-if-known>
+#   execution_completed_at=<iso8601-if-known>
+#   execution_endpoint=<start|complete|reconcile-if-used>
 
 set -euo pipefail
 
@@ -58,7 +61,9 @@ PROJECT_SLUG=""
 RELEASE_VERSION=""
 SDLC_STAGE=""
 ENVIRONMENT=""
-CYCLE_KIND=""
+SUITE_KIND=""
+ITERATION_KEY=""
+ITERATION_ORDINAL=""
 PROVIDER="github_actions"
 EXTERNAL_RUN_ID=""
 EXTERNAL_RUN_ATTEMPT=""
@@ -73,6 +78,7 @@ COMPLETED_AT=""
 OUTCOME=""
 OUTCOME_REASON=""
 INCIDENT_REFERENCE=""
+REMEDIATION_REFERENCE=""
 OUTPUT_FILE=""
 
 while [ "$#" -gt 0 ]; do
@@ -81,7 +87,9 @@ while [ "$#" -gt 0 ]; do
     --release) RELEASE_VERSION="$2"; shift 2 ;;
     --sdlc-stage) SDLC_STAGE="$2"; shift 2 ;;
     --environment) ENVIRONMENT="$2"; shift 2 ;;
-    --cycle-kind) CYCLE_KIND="$2"; shift 2 ;;
+    --suite-kind) SUITE_KIND="$2"; shift 2 ;;
+    --iteration-key) ITERATION_KEY="$2"; shift 2 ;;
+    --iteration-ordinal) ITERATION_ORDINAL="$2"; shift 2 ;;
     --provider) PROVIDER="$2"; shift 2 ;;
     --external-run-id) EXTERNAL_RUN_ID="$2"; shift 2 ;;
     --external-run-attempt) EXTERNAL_RUN_ATTEMPT="$2"; shift 2 ;;
@@ -96,6 +104,7 @@ while [ "$#" -gt 0 ]; do
     --outcome) OUTCOME="$2"; shift 2 ;;
     --outcome-reason) OUTCOME_REASON="$2"; shift 2 ;;
     --incident-reference) INCIDENT_REFERENCE="$2"; shift 2 ;;
+    --remediation-reference) REMEDIATION_REFERENCE="$2"; shift 2 ;;
     --output-file) OUTPUT_FILE="$2"; shift 2 ;;
     *) echo "Unknown option: $1"; exit 1 ;;
   esac
@@ -113,7 +122,7 @@ require_arg "$PROJECT_SLUG" "--project-slug"
 require_arg "$RELEASE_VERSION" "--release"
 require_arg "$SDLC_STAGE" "--sdlc-stage"
 require_arg "$ENVIRONMENT" "--environment"
-require_arg "$CYCLE_KIND" "--cycle-kind"
+require_arg "$SUITE_KIND" "--suite-kind"
 require_arg "$IDEMPOTENCY_KEY" "--idempotency-key"
 
 if [ -z "${DEVAUDIT_BASE_URL:-}" ]; then
@@ -146,11 +155,16 @@ fi
 case "$OUTCOME" in
   ""|passed|failed|cancelled|skipped|timed_out|action_required|unknown) ;;
   *)
-    echo "Error: --outcome must be a terminal cycle outcome" >&2
+    echo "Error: --outcome must be a terminal test execution outcome" >&2
     exit 1
     ;;
 esac
 
+if [ -n "$ITERATION_ORDINAL" ] && ! [[ "$ITERATION_ORDINAL" =~ ^[0-9]+$ ]]; then
+  echo "Error: --iteration-ordinal must be a positive integer" >&2
+  exit 1
+fi
+
 iso_now() {
   date -u +"%Y-%m-%dT%H:%M:%SZ"
 }
@@ -171,18 +185,6 @@ write_output() {
   fi
 }
 
-emit_fallback() {
-  local release_id="${1:-}" resolved_version="${2:-}"
-  write_output cycle_supported false
-  write_output cycle_release_id "$release_id"
-  write_output cycle_release_version "$resolved_version"
-  write_output cycle_record_id ""
-  write_output cycle_idempotency_key "$IDEMPOTENCY_KEY"
-  write_output cycle_started_at "$STARTED_AT"
-  write_output cycle_completed_at "$COMPLETED_AT"
-  write_output cycle_endpoint "$MODE"
-}
-
 uri_escape() {
   jq -rn --arg v "$1" '$v|@uri'
 }
@@ -199,23 +201,21 @@ resolve_release_exact() {
     --max-time "$MAX_TIME_SECONDS" \
     "$url")
   if [ "$code" -lt 200 ] || [ "$code" -ge 300 ]; then
-    echo "::warning::Cycle lifecycle skipped: could not resolve release ${RELEASE_VERSION} (HTTP ${code})." >&2
+    echo "Error: could not resolve release ${RELEASE_VERSION} for test execution lifecycle (HTTP ${code})." >&2
     rm -f "$body"
-    emit_fallback "" ""
     return 1
   fi
   latest_id=$(jq -r '.latest.id // empty' "$body" 2>/dev/null || true)
   latest_version=$(jq -r '.latest.version // empty' "$body" 2>/dev/null || true)
   rm -f "$body"
   if [ -z "$latest_id" ] || [ "$latest_version" != "$RELEASE_VERSION" ]; then
-    echo "::warning::Cycle lifecycle skipped: release resolve for ${RELEASE_VERSION} was empty or ambiguous (latest=${latest_version:-none})." >&2
-    emit_fallback "$latest_id" "$latest_version"
+    echo "Error: release resolve for ${RELEASE_VERSION} was empty or ambiguous (latest=${latest_version:-none})." >&2
     return 1
   fi
   RELEASE_ID="$latest_id"
   RESOLVED_RELEASE_VERSION="$latest_version"
-  write_output cycle_release_id "$RELEASE_ID"
-  write_output cycle_release_version "$RESOLVED_RELEASE_VERSION"
+  write_output execution_release_id "$RELEASE_ID"
+  write_output execution_release_version "$RESOLVED_RELEASE_VERSION"
   return 0
 }
 
@@ -231,7 +231,9 @@ build_payload() {
     --arg mode "$mode" \
     --arg sdlcStage "$SDLC_STAGE" \
     --arg environment "$ENVIRONMENT" \
-    --arg cycleKind "$CYCLE_KIND" \
+    --arg suiteKind "$SUITE_KIND" \
+    --arg iterationKey "$ITERATION_KEY" \
+    --arg iterationOrdinal "$ITERATION_ORDINAL" \
     --arg provider "$PROVIDER" \
     --arg externalRunId "$EXTERNAL_RUN_ID" \
     --argjson externalRunAttempt "$EXTERNAL_RUN_ATTEMPT_JSON" \
@@ -246,12 +248,16 @@ build_payload() {
     --arg workflowName "$WORKFLOW_NAME" \
     --arg workflowUrl "$WORKFLOW_URL" \
     --arg incidentReference "$INCIDENT_REFERENCE" \
+    --arg remediationReference "$REMEDIATION_REFERENCE" \
     '
       {
         schemaVersion: $schemaVersion,
         sdlcStage: ($sdlcStage | tonumber),
         environment: $environment,
-        cycleKind: $cycleKind,
+        cycleKind: $suiteKind,
+        suiteKind: $suiteKind,
+        iterationKey: ($iterationKey | if . == "" then null else . end),
+        iterationOrdinal: ($iterationOrdinal | if . == "" then null else tonumber end),
         provider: $provider,
         externalRunId: ($externalRunId | if . == "" then null else . end),
         externalRunAttempt: $externalRunAttempt,
@@ -262,7 +268,8 @@ build_payload() {
         branch: ($branch | if . == "" then null else . end),
         workflowName: ($workflowName | if . == "" then null else . end),
         workflowUrl: ($workflowUrl | if . == "" then null else . end),
-        incidentReference: ($incidentReference | if . == "" then null else . end)
+        incidentReference: ($incidentReference | if . == "" then null else . end),
+        remediationReference: ($remediationReference | if . == "" then null else . end)
       }
       + (if $mode == "start"
           then { outcome: "running" }
@@ -275,7 +282,7 @@ build_payload() {
     '
 }
 
-post_cycle_event() {
+post_execution_event() {
   local endpoint="$1" payload="$2" body code
   body=$(mktemp)
   code=$(curl -sS -o "$body" -w "%{http_code}" \
@@ -286,59 +293,44 @@ post_cycle_event() {
     --max-time "$MAX_TIME_SECONDS" \
     "${DEVAUDIT_BASE_URL}/api/ci/releases/${RELEASE_ID}/cycles/${endpoint}" \
     -d "$payload")
-  CYCLE_HTTP_CODE="$code"
-  CYCLE_RESPONSE_BODY_FILE="$body"
-}
-
-handle_unavailable_endpoint() {
-  case "$CYCLE_HTTP_CODE" in
-    404|405|501)
-      echo "::warning::Cycle lifecycle endpoint ${MODE} unavailable on this portal (HTTP ${CYCLE_HTTP_CODE}); continuing in legacy testCycleId mode." >&2
-      emit_fallback "$RELEASE_ID" "$RESOLVED_RELEASE_VERSION"
-      rm -f "$CYCLE_RESPONSE_BODY_FILE"
-      return 0
-      ;;
-  esac
-  return 1
+  EXECUTION_HTTP_CODE="$code"
+  EXECUTION_RESPONSE_BODY_FILE="$body"
 }
 
 if ! resolve_release_exact; then
-  exit 0
+  exit 1
 fi
 
 PAYLOAD="$(build_payload "$MODE")"
 ENDPOINT="$MODE"
-post_cycle_event "$ENDPOINT" "$PAYLOAD"
+post_execution_event "$ENDPOINT" "$PAYLOAD"
 
-if [ "$MODE" = "complete" ] && [ "$CYCLE_HTTP_CODE" -eq 400 ]; then
-  if grep -q 'different terminal outcome' "$CYCLE_RESPONSE_BODY_FILE" 2>/dev/null; then
+if [ "$MODE" = "complete" ] && [ "$EXECUTION_HTTP_CODE" -eq 400 ]; then
+  if grep -q 'different terminal outcome' "$EXECUTION_RESPONSE_BODY_FILE" 2>/dev/null; then
     ENDPOINT="reconcile"
-    post_cycle_event "$ENDPOINT" "$PAYLOAD"
+    post_execution_event "$ENDPOINT" "$PAYLOAD"
   fi
 fi
 
-if [ "$CYCLE_HTTP_CODE" -lt 200 ] || [ "$CYCLE_HTTP_CODE" -ge 300 ]; then
-  if handle_unavailable_endpoint; then
-    exit 0
-  fi
-  BODY_EXCERPT="$(head -c 500 "$CYCLE_RESPONSE_BODY_FILE" 2>/dev/null || true)"
-  rm -f "$CYCLE_RESPONSE_BODY_FILE"
-  echo "Error: cycle ${ENDPOINT} failed for ${RELEASE_VERSION} (HTTP ${CYCLE_HTTP_CODE})${BODY_EXCERPT:+ — ${BODY_EXCERPT}}" >&2
+if [ "$EXECUTION_HTTP_CODE" -lt 200 ] || [ "$EXECUTION_HTTP_CODE" -ge 300 ]; then
+  BODY_EXCERPT="$(head -c 500 "$EXECUTION_RESPONSE_BODY_FILE" 2>/dev/null || true)"
+  rm -f "$EXECUTION_RESPONSE_BODY_FILE"
+  echo "Error: test execution ${ENDPOINT} failed for ${RELEASE_VERSION} (HTTP ${EXECUTION_HTTP_CODE})${BODY_EXCERPT:+ - ${BODY_EXCERPT}}" >&2
   exit 1
 fi
 
-CYCLE_RECORD_ID=$(jq -r '.id // empty' "$CYCLE_RESPONSE_BODY_FILE" 2>/dev/null || true)
-rm -f "$CYCLE_RESPONSE_BODY_FILE"
-if [ -z "$CYCLE_RECORD_ID" ]; then
-  echo "Error: cycle ${ENDPOINT} succeeded but response did not include an id" >&2
+EXECUTION_RECORD_ID=$(jq -r '.id // empty' "$EXECUTION_RESPONSE_BODY_FILE" 2>/dev/null || true)
+rm -f "$EXECUTION_RESPONSE_BODY_FILE"
+if [ -z "$EXECUTION_RECORD_ID" ]; then
+  echo "Error: test execution ${ENDPOINT} succeeded but response did not include an id" >&2
   exit 1
 fi
 
-write_output cycle_supported true
-write_output cycle_record_id "$CYCLE_RECORD_ID"
-write_output cycle_idempotency_key "$IDEMPOTENCY_KEY"
-write_output cycle_started_at "$STARTED_AT"
-write_output cycle_completed_at "$COMPLETED_AT"
-write_output cycle_endpoint "$ENDPOINT"
+write_output execution_supported true
+write_output execution_record_id "$EXECUTION_RECORD_ID"
+write_output execution_idempotency_key "$IDEMPOTENCY_KEY"
+write_output execution_started_at "$STARTED_AT"
+write_output execution_completed_at "$COMPLETED_AT"
+write_output execution_endpoint "$ENDPOINT"
 
-echo "Cycle ${ENDPOINT} recorded for ${RELEASE_VERSION}: ${CYCLE_RECORD_ID}"
+echo "Test execution ${ENDPOINT} recorded for ${RELEASE_VERSION}: ${EXECUTION_RECORD_ID}"