v1.91.7.0 feat: add functional QA and pre-publication docs checks (#2983)

* feat: add surface-aware exploratory QA and ship documentation gates

* test: preserve delegated QA setup authority after main integration

* fix(qa): clarify exploration order and preserve report artifacts

* test(qa): follow the shared setup reference directly

* refactor(ship): make verification and recovery routes explicit

* test(ship): align evidence and review guards with explicit routes

* fix(workflows): clarify ship recovery and functional QA evidence

* fix(workflows): clarify approval recovery and full QA coverage

* refactor(workflows): order review transactions and clarify ship state

* fix(ship): clarify final verification and fail closed at publication

* fix(evals): attribute native atomic documentation writes

* fix(ship): clarify recovery and documentation lifecycle guidance

* fix(test): preserve observed native placeholder styling in CI

* fix(codex): report watchdog timeouts without a process-exit race

* Checkpoint functional QA implementation and workflow validation repairs

* Fix documentation and shared-review fixture contracts

* docs: clarify judge reuse and evaluation supervision

* test: align review evidence and selected case contracts

* test: verify append-only documentation checkpoints and recovery

* fix: qualify QA workflows and CI validation repairs

* fix: launch shared-libs fixture scripts on Windows

* fix: qualify QA deadlines, fixture isolation, and shard cleanup

* fix: preserve qualified QA and cancellation repairs

* fix: enforce functional fixture authority and share strict event decoding

* fix: retain free-test evidence and explain recovery

* fix: reject malformed native evidence after decoder consolidation

* test: use reliable capture for telemetry privacy filters

* test: refresh measured quick coverage and document validation costs

* Fix native fixture receipts and preserve VM validation evidence

* Align negative judge controls with upstream clarity policy

* Fix report-only QA preparation and public evidence handling

* Clarify QA-only preparation and current-report preservation

* Stream Ship quality judgments with an explicit 64k response contract

* Validate compact judge reasoning locally with supported wire schema

* Align functional QA fixture instructions with evidence acceptance

* Bind native browser diagnostics to execution evidence and align review verdicts

* Preserve native diagnostic line boundaries

* Serialize functional QA evidence from native captures

* Keep large QA evidence fixture payload out of Windows argv

setup

@@ -2595,6 +2595,32 @@ if [ "$INSTALL_KIRO" -eq 1 ]; then
           _link_or_copy "$section_file" "$section_dest"
         done
       fi
+      if [ "$skill_name" = "gstack-qa" ] && [ -f "$skill_dir/templates/functional-report-template.md" ]; then
+        if [ -L "$target_dir/templates" ]; then
+          template_target="$(_gstack_link_target_abs "$target_dir/templates")"
+          if ! _gstack_target_is_ours "$template_target" "$SOURCE_GSTACK_DIR"; then
+            echo "  kept $skill_name/templates: directory link is not gstack-managed" >&2
+            continue
+          fi
+          rm -f "$target_dir/templates"
+        elif [ -e "$target_dir/templates" ] && [ ! -d "$target_dir/templates" ]; then
+          echo "  kept $skill_name/templates: existing entry is not a directory" >&2
+          continue
+        fi
+        mkdir -p "$target_dir/templates"
+        template_dest="$target_dir/templates/functional-report-template.md"
+        if [ -L "$template_dest" ]; then
+          template_target="$(_gstack_link_target_abs "$template_dest")"
+          if ! _gstack_target_is_ours "$template_target" "$SOURCE_GSTACK_DIR"; then
+            echo "  kept $skill_name/templates/functional-report-template.md: file link is not gstack-managed" >&2
+            continue
+          fi
+        elif [ -e "$template_dest" ] && ! _gstack_generated_header "$template_dest"; then
+          echo "  kept $skill_name/templates/functional-report-template.md: existing file is not gstack-managed" >&2
+          continue
+        fi
+        _link_or_copy "$skill_dir/templates/functional-report-template.md" "$template_dest"
+      fi
     done
     _prune_stale_generated "$SOURCE_GSTACK_DIR" "$KIRO_DIR" "$KIRO_SKILLS"
     echo "gstack ready (kiro)."