develop to master

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets).
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md).

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.4/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "master",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.github/actions/gemini/action.yml

@@ -0,0 +1,154 @@
+name: 'Run Gemini with fallback'
+description: 'Run gemini-cli against a prompt file, with CLI model fallback and optional direct REST API fallback for plan-style read-only tasks.'
+
+inputs:
+  api_key:
+    description: 'Gemini API key (secret).'
+    required: true
+  prompt_file:
+    description: 'Path to a file containing the prompt to send.'
+    required: true
+  output_file:
+    description: 'Path to write Gemini stdout to.'
+    required: true
+  models:
+    description: 'Comma-separated fallback chain (CLI --model values).'
+    required: true
+  yolo:
+    description: 'If "true", pass --yolo so tool calls (file edits) auto-accept. Set "false" for analysis-only callers that should also fail-safe via prompt instruction.'
+    default: 'true'
+  allow_rest_fallback:
+    description: 'If "true", also try a direct Gemini REST API call when every CLI attempt fails. Useful for plan/eval phases that only need text output; pointless for phases that must edit files.'
+    default: 'false'
+  reset_between_attempts:
+    description: 'If "true", run `git reset --hard` + `git clean -fd -e .ai -e .harness` between CLI fallback attempts. Required for agentic (file-editing) callers so a partially-modified tree from a failed attempt does not leak into the next model''s context.'
+    default: 'false'
+
+outputs:
+  used_model:
+    description: 'The model that produced output, or empty if all attempts failed.'
+    value: ${{ steps.run.outputs.used_model }}
+  used_rest:
+    description: 'true if the REST fallback produced the output, false if CLI did.'
+    value: ${{ steps.run.outputs.used_rest }}
+
+runs:
+  using: composite
+  steps:
+    - name: Install gemini-cli
+      shell: bash
+      run: |
+        if ! command -v gemini >/dev/null 2>&1; then
+          npm install -g @google/gemini-cli
+        fi
+        echo "::group::gemini version"
+        gemini --version || true
+        echo "::endgroup::"
+
+    - name: Run with fallback
+      id: run
+      shell: bash
+      env:
+        GEMINI_API_KEY: ${{ inputs.api_key }}
+        PROMPT_FILE: ${{ inputs.prompt_file }}
+        OUTPUT_FILE: ${{ inputs.output_file }}
+        MODELS_CSV: ${{ inputs.models }}
+        YOLO_FLAG: ${{ inputs.yolo == 'true' && '--yolo' || '' }}
+        ALLOW_REST: ${{ inputs.allow_rest_fallback }}
+        RESET_BETWEEN: ${{ inputs.reset_between_attempts }}
+        GEMINI_CLI_TRUST_WORKSPACE: 'true'
+      run: |
+        set -e
+        mkdir -p "$(dirname "$OUTPUT_FILE")" .ai
+
+        rc=1
+        used_model=""
+        used_rest="false"
+
+        # Snapshot the working tree state. Used to reset between fallback
+        # attempts when the caller is editing files (otherwise a quota-killed
+        # attempt leaves half-written files that confuse the next model).
+        initial_head=""
+        if [ "$RESET_BETWEEN" = "true" ]; then
+          initial_head=$(git rev-parse HEAD 2>/dev/null || echo "")
+          echo "::notice::reset_between_attempts=true (initial HEAD=$initial_head)"
+        fi
+
+        attempt=0
+        IFS=',' read -ra MODELS <<< "$MODELS_CSV"
+        for model in "${MODELS[@]}"; do
+          model="$(echo "$model" | xargs)"
+          [ -z "$model" ] && continue
+
+          # Before any retry (attempt > 0), restore the working tree to its
+          # pre-Gemini state so the next model starts from a clean slate.
+          if [ "$attempt" -gt 0 ] && [ -n "$initial_head" ]; then
+            echo "::notice::resetting working tree before retry"
+            git reset --hard "$initial_head" 2>/dev/null || true
+            git clean -fd -e .ai -e .harness 2>/dev/null || true
+          fi
+          attempt=$((attempt + 1))
+
+          echo "::group::CLI attempt: $model"
+          set +e
+          gemini --model "$model" $YOLO_FLAG --prompt "$(cat "$PROMPT_FILE")" \
+            > "$OUTPUT_FILE" 2> .ai/gemini.err
+          rc=$?
+          set -e
+          echo "exit: $rc"
+          tail -n 20 .ai/gemini.err 2>/dev/null || true
+          echo "::endgroup::"
+
+          if [ $rc -eq 0 ]; then
+            used_model="$model"
+            echo "CLI succeeded with $model"
+            break
+          fi
+          if grep -qE 'TerminalQuotaError|Quota exceeded|"code": ?429|status: ?429' .ai/gemini.err 2>/dev/null; then
+            echo "::notice::$model hit quota; trying next"
+            continue
+          fi
+          echo "::warning::$model failed with non-quota error; stop CLI loop"
+          break
+        done
+
+        if [ $rc -ne 0 ] && [ "$ALLOW_REST" = "true" ]; then
+          echo "::notice::falling back to direct Gemini REST API"
+          for model in "${MODELS[@]}"; do
+            model="$(echo "$model" | xargs)"
+            [ -z "$model" ] && continue
+            echo "::group::REST attempt: $model"
+            body=$(jq -n --rawfile p "$PROMPT_FILE" '{contents:[{parts:[{text:$p}]}]}')
+            http_code=$(curl -sS -o .ai/rest.json -w '%{http_code}' \
+              "https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent" \
+              -H "x-goog-api-key: $GEMINI_API_KEY" \
+              -H "Content-Type: application/json" \
+              -d "$body" || echo "000")
+            echo "HTTP $http_code"
+            if [ "$http_code" = "200" ]; then
+              text=$(jq -r '.candidates[0].content.parts[0].text // empty' .ai/rest.json)
+              if [ -n "$text" ]; then
+                printf '%s' "$text" > "$OUTPUT_FILE"
+                rc=0
+                used_model="$model"
+                used_rest="true"
+                echo "REST succeeded with $model"
+                echo "::endgroup::"
+                break
+              fi
+            fi
+            jq -r '.error.message // .' .ai/rest.json 2>/dev/null | head -3 || true
+            echo "::endgroup::"
+          done
+        fi
+
+        echo "used_model=$used_model" >> "$GITHUB_OUTPUT"
+        echo "used_rest=$used_rest" >> "$GITHUB_OUTPUT"
+
+        if [ $rc -ne 0 ]; then
+          echo "::error::all Gemini attempts (CLI${ALLOW_REST:+ + REST}) failed"
+          echo "::group::stdout tail"
+          tail -n 60 "$OUTPUT_FILE" 2>/dev/null || echo "(empty)"
+          echo "::endgroup::"
+          exit $rc
+        fi