jonah-fleet 1.13.0 → 1.15.0

package/templates/prompts/optimizer.md

@@ -1,5 +1,13 @@
 # Prompt Optimizer
 
+<!--
+================================================================================
+TIER 1: STATIC INVARIANT PREFIX
+Routine objective, Definition of Done, constraints, instructions, and logging.
+100% cacheable across all runs and repositories.
+================================================================================
+-->
+
 ## Objective
 
 Scan recent agent run logs and closed issues, diagnose four classes of problem — **failures** (runs that logged FAILURE), **inefficiency** (runs burning excessive iterations or multi-loop PRs), **token consumption & cost anomalies** (runs trending toward weekly budget ceilings), and **preventable bugs & defect avoidance** (analyzing resolved bugs to determine root causes and authoring/review prevention checks) — and propose targeted prompt, template, test, and workflow fixes via pull requests.
@@ -133,3 +141,38 @@ After completing (SUCCESS or FAILURE), record run execution details to `.jonah-f
   ```
 - Follow the Routine Issue Logging & Telemetry Protocol in `ORCHESTRATION.md`. Never commit run logs to git branches.
 
+<!--
+================================================================================
+TIER 2: SEMI-STABLE PROJECT RULES
+Repository rules from AGENTS.md, manifest configurations, and LESSONS.md.
+Cacheable across consecutive runs within the same repository.
+================================================================================
+-->
+
+## Repository Rules & Project Context (Tier 2)
+
+In this tier, Prompt Optimizer ingests semi-stable repository conventions, operational memory, and configuration rules that change infrequently across consecutive runs in the same repository:
+
+1. **Repository Conventions (`AGENTS.md`)**: Read `AGENTS.md` (or `CLAUDE.md` / `GEMINI.md`) for baseline project guidelines, prompt conventions, and test commands.
+2. **Operational Memory (`LESSONS.md`)**: Scan `LESSONS.md` to identify candidate lessons for graduation into automated linter rules or CI workflow checks, and archive stale entries to `LESSONS_ARCHIVE.md`.
+3. **Fleet Manifest (`agents-manifest.json`)**: Ingest per-routine budget overrides, enabled routines, and model assignments to evaluate against the 70% weekly token ceiling (~8.75M tokens).
+4. **Engineering Skills (`.agents/skills/`)**: Leverage `writing-for-agents` to prune prompt sprawl and apply leading words.
+
+<!--
+================================================================================
+TIER 3: DYNAMIC TAIL PAYLOAD
+Target issue / PR data, git diff, active branch, timestamps, and runtime vars.
+Appended strictly at the tail of the prompt to preserve prefix cache validity.
+================================================================================
+-->
+
+## Dynamic Context & Execution Payload (Tier 3)
+
+The dynamic execution context for this optimization sweep is injected strictly at the tail of the prompt:
+
+- **Scan Boundary**: Incremental window timestamp established in Step 0.
+- **Runtime Metadata**: `$ROUTINE_ISSUE_NUMBER`, `$GITHUB_RUN_ID`, and runner timestamp.
+- **In-Window Telemetry**: Routine log issues (`routine-log`), failure categories, and token consumption data.
+- **Prefix Caching Invariant**: Harnesses and runners MUST NEVER interpolate dynamic timestamps, run IDs, or target identifiers into Tier 1 or Tier 2 prefix blocks.
+
+

package/templates/prompts/peer-review.md

@@ -1,5 +1,13 @@
 # Peer Review
 
+<!--
+================================================================================
+TIER 1: STATIC INVARIANT PREFIX
+Routine objective, Definition of Done, constraints, instructions, and logging.
+100% cacheable across all runs and repositories.
+================================================================================
+-->
+
 ## Objective
 
 Review a pull request (in Targeted mode for a specific `$PR_NUMBER`, or in Scan mode selecting the highest-priority open PR), evaluate code quality, security, and specification compliance via multi-angle subagent code reviews (`/code-review`), and take exactly one final action: squash-merge if clean, or post findings and bounce the PR back to draft (`gh pr ready <N> --undo`) for in-session author fixes.
@@ -174,3 +182,38 @@ After completing (SUCCESS or FAILURE), record run execution details to `.jonah-f
 - **Next**: Routine finished; issue closed by harness" || true
   ```
 - Follow the Routine Issue Logging & Telemetry Protocol in `ORCHESTRATION.md`. Never commit run logs to git branches.
+
+<!--
+================================================================================
+TIER 2: SEMI-STABLE PROJECT RULES
+Repository rules from AGENTS.md, manifest configurations, and LESSONS.md.
+Cacheable across consecutive runs within the same repository.
+================================================================================
+-->
+
+## Repository Rules & Project Context (Tier 2)
+
+In this tier, Peer Review ingests semi-stable repository conventions, operational memory, and configuration rules that change infrequently across consecutive runs in the same repository:
+
+1. **Repository Conventions (`AGENTS.md`)**: Read `AGENTS.md` (or `CLAUDE.md` / `GEMINI.md`) for coding standards, architectural patterns, design system token purity, and required CI / test commands.
+2. **Operational Memory (`LESSONS.md`)**: Verify that any non-obvious quirks or gotchas captured on the active PR branch adhere to the 25-entry hard cap.
+3. **Fleet Manifest (`agents-manifest.json`)**: Ingest configured review models, round caps, and iteration ceilings.
+4. **Engineering Skills (`.agents/skills/`)**: Leverage `code-review`, `design-critique`, and `writing-for-agents` for structured evaluation.
+
+<!--
+================================================================================
+TIER 3: DYNAMIC TAIL PAYLOAD
+Target issue / PR data, git diff, active branch, timestamps, and runtime vars.
+Appended strictly at the tail of the prompt to preserve prefix cache validity.
+================================================================================
+-->
+
+## Dynamic Context & Execution Payload (Tier 3)
+
+The dynamic execution context for this specific review run is injected strictly at the tail of the prompt:
+
+- **Target PR**: `$PR_NUMBER` (or `$PR_URL`), PR title, body, author, and review round N.
+- **Runtime Metadata**: `$ROUTINE_ISSUE_NUMBER`, `$GITHUB_RUN_ID`, runner timestamp, and trigger event.
+- **Pull Request Payload**: Head commit SHA, base branch diff, status check rollup (CI status), and unaddressed comments.
+- **Prefix Caching Invariant**: Harnesses and runners MUST NEVER interpolate dynamic timestamps, run IDs, or target identifiers into Tier 1 or Tier 2 prefix blocks.
+

package/templates/prompts/product-planning.md

@@ -1,5 +1,13 @@
 # Product Planning
 
+<!--
+================================================================================
+TIER 1: STATIC INVARIANT PREFIX
+Routine objective, Definition of Done, constraints, instructions, and logging.
+100% cacheable across all runs and repositories.
+================================================================================
+-->
+
 ## Objective
 
 Turn strategy and evidence into **well-scoped, ready-to-build work** and a **current roadmap** — the "plan" between analytics/measurement and autowork's build phase. Each run reads roadmap priorities, closed measurement trackers (`RECOMMENDATION: [PIVOT | DEPRECATE | ITERATE]`), analytics signals, and user feedback to **propose** the next units of product work: new feature issues, feature pruning and deprecations, formal specs/PRDs for larger epics, backlog re-ranking recommendations, and roadmap updates.
@@ -80,3 +88,38 @@ Follow the Routine Issue Logging Protocol in `ORCHESTRATION.md`:
    - Staged or promoted proposals tally
 3. The surrounding execution harness will reconcile the corresponding GitHub issue.
 
+<!--
+================================================================================
+TIER 2: SEMI-STABLE PROJECT RULES
+Repository rules from AGENTS.md, manifest configurations, and LESSONS.md.
+Cacheable across consecutive runs within the same repository.
+================================================================================
+-->
+
+## Repository Rules & Project Context (Tier 2)
+
+In this tier, Product Planning ingests semi-stable repository conventions and strategic guidance:
+
+1. **Repository Conventions & Product Strategy (`AGENTS.md`, `ROADMAP.md`)**: Read `AGENTS.md` (or `CLAUDE.md` / `GEMINI.md`) and `ROADMAP.md` for current feature priorities, milestones, and architectural constraints.
+2. **Operational Memory (`LESSONS.md`)**: Ingest active operational gotchas to avoid proposing infeasible or recurring architectural patterns.
+3. **Fleet Manifest (`agents-manifest.json`)**: Ingest configured routine presets and budgets.
+4. **Engineering Skills (`.agents/skills/`)**: Leverage `domain-modeling` and `grill-me` when scoping epics and drafting specifications.
+
+<!--
+================================================================================
+TIER 3: DYNAMIC TAIL PAYLOAD
+Target issue / PR data, git diff, active branch, timestamps, and runtime vars.
+Appended strictly at the tail of the prompt to preserve prefix cache validity.
+================================================================================
+-->
+
+## Dynamic Context & Execution Payload (Tier 3)
+
+The dynamic execution context for this planning sweep is injected strictly at the tail of the prompt:
+
+- **Planning Mode & Directives**: Mode indicator (`Propose` vs `Promote`) and operator approval tokens.
+- **Input Artifacts**: Closed measurement trackers with `RECOMMENDATION: [PIVOT | DEPRECATE | ITERATE]`, open `🎨 Design Review` issues, and maintainer feedback.
+- **Runtime Metadata**: `$ROUTINE_ISSUE_NUMBER`, `$GITHUB_RUN_ID`, and runner timestamp.
+- **Prefix Caching Invariant**: Harnesses and runners MUST NEVER interpolate dynamic timestamps, run IDs, or target identifiers into Tier 1 or Tier 2 prefix blocks.
+
+

package/templates/workflows/analytics-review-cron.yml

@@ -0,0 +1,313 @@
+name: Analytics Review Scheduled Cron (agy)
+
+# Scheduled execution of the Analytics Review routine using Antigravity CLI on Gemini 3.8 Flash.
+# Queries Vercel, PostHog, and GitHub CI volume, executes §1–§7 checks, updates measurement trackers,
+# stages product action directives into Product Planning, and logs to a two-phase routine run issue.
+
+on:
+  schedule:
+    # Daily at 07:00 UTC (09:00 Paris CEST)
+    - cron: '0 7 * * *'
+  workflow_dispatch:
+
+# Single-flight: do not run overlapping analytics review runs.
+concurrency:
+  group: analytics-review-agent
+  cancel-in-progress: false
+
+jobs:
+  run-analytics-review:
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+      statuses: write
+      actions: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Configure Git author identity
+        env:
+          GH_TOKEN: ${{ secrets.GH_PAT || github.token }}
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+          git config --global --add safe.directory "$GITHUB_WORKSPACE"
+          gh auth setup-git
+
+      - name: Cache Antigravity CLI
+        id: cache-agy
+        uses: actions/cache@v4
+        with:
+          path: ~/.local/bin/agy
+          key: agy-cli-linux-amd64-v1
+
+      - name: Install Antigravity CLI
+        if: steps.cache-agy.outputs.cache-hit != 'true'
+        run: |
+          curl -fsSL https://antigravity.google/cli/install.sh | bash
+
+      - name: Add Antigravity CLI to PATH
+        run: echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+      - name: Write Antigravity OAuth Token
+        env:
+          ANTIGRAVITY_OAUTH_TOKEN: ${{ secrets.ANTIGRAVITY_OAUTH_TOKEN || secrets.GEMINI_API_KEY }}
+        run: |
+          if [ -z "$ANTIGRAVITY_OAUTH_TOKEN" ]; then
+            echo "::error::Neither ANTIGRAVITY_OAUTH_TOKEN nor GEMINI_API_KEY secret is set; cannot authenticate Antigravity CLI." >&2
+            exit 1
+          fi
+          mkdir -p "$HOME/.gemini/antigravity-cli"
+          chmod 700 "$HOME/.gemini/antigravity-cli"
+          printf '%s' "$ANTIGRAVITY_OAUTH_TOKEN" > "$HOME/.gemini/antigravity-cli/antigravity-oauth-token"
+          chmod 600 "$HOME/.gemini/antigravity-cli/antigravity-oauth-token"
+
+      - name: Fast preflight credential validation (SwarmClaw Pattern #2)
+        run: |
+          if [ ! -s "$HOME/.gemini/antigravity-cli/antigravity-oauth-token" ]; then
+            echo "::error::Preflight credential check failed: Antigravity OAuth token file is missing or empty." >&2
+            exit 1
+          fi
+          echo "✓ Preflight credential validation passed."
+
+      - name: Discover and compile domain skills (SwarmClaw Pattern #4)
+        id: skills
+        run: |
+          SKILLS_LIST=""
+          if [ -f ".agents/skills/validate-data/SKILL.md" ]; then
+            SKILLS_LIST="Read and follow .agents/skills/validate-data/SKILL.md."
+          fi
+          echo "skills_prompt=$SKILLS_LIST" >> "$GITHUB_OUTPUT"
+
+      - name: Resolve routine configuration
+        id: routine-config
+        run: |
+          ROUTINE="analytics-review"
+          DEFAULT_MODEL="gemini-3.8-flash-high"
+          DEFAULT_TIMEOUT="50"
+
+          MODEL="$DEFAULT_MODEL"
+          TIMEOUT="$DEFAULT_TIMEOUT"
+
+          if [ -f "agents-manifest.json" ]; then
+            CONFIG_JSON=$(node -e '
+              try {
+                const fs = require("fs");
+                const m = JSON.parse(fs.readFileSync("agents-manifest.json", "utf8"));
+                const r = process.argv[1];
+                const model = m.models?.[r] || m.models?.default;
+                const timeout = m.budgets?.timeoutMinutes?.[r] || m.budgets?.timeoutMinutes?.default;
+                console.log(JSON.stringify({ model: model || "", timeout: timeout ? String(timeout) : "" }));
+              } catch (e) {
+                console.log(JSON.stringify({ model: "", timeout: "" }));
+              }
+            ' "$ROUTINE")
+
+            RESOLVED_MODEL=$(node -e "try { console.log(JSON.parse(process.argv[1]).model || ''); } catch {}" "$CONFIG_JSON")
+            RESOLVED_TIMEOUT=$(node -e "try { console.log(JSON.parse(process.argv[1]).timeout || ''); } catch {}" "$CONFIG_JSON")
+
+            if [ -n "$RESOLVED_MODEL" ]; then
+              MODEL="$RESOLVED_MODEL"
+            fi
+            if [ -n "$RESOLVED_TIMEOUT" ]; then
+              TIMEOUT="$RESOLVED_TIMEOUT"
+            fi
+          fi
+
+          echo "model=$MODEL" >> "$GITHUB_OUTPUT"
+          echo "print_timeout=${TIMEOUT}m" >> "$GITHUB_OUTPUT"
+          echo "Resolved routine configuration: model=$MODEL, timeout=${TIMEOUT}m"
+
+      - name: Initialize Routine Run Issue
+        id: run-issue
+        env:
+          GH_TOKEN: ${{ secrets.GH_PAT || github.token }}
+          EVENT_NAME: ${{ github.event_name }}
+          RUN_ID: ${{ github.run_id }}
+          SERVER_URL: ${{ github.server_url }}
+          REPOSITORY: ${{ github.repository }}
+        run: |
+          TIMESTAMP=$(date -u +"%Y-%m-%dT%H-%M-%SZ")
+          TITLE="[analytics-review] run ${TIMESTAMP}"
+          BODY="### Autonomous Routine Execution in Progress
+          - **Routine**: \`analytics-review\`
+          - **Timestamp**: \`${TIMESTAMP}\`
+          - **Trigger**: \`${EVENT_NAME}\`
+          - **Run ID**: [\`${RUN_ID}\`](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})
+
+          ---
+          _Generated by [Antigravity](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})_"
+          ISSUE_URL=$(gh issue create --title "$TITLE" --body "$BODY" --label "routine-log,routine:analytics-review,status:running,runner:github-actions")
+          ISSUE_NUMBER=$(echo "$ISSUE_URL" | grep -oE '[0-9]+$')
+          echo "issue_number=$ISSUE_NUMBER" >> "$GITHUB_OUTPUT"
+          echo "ROUTINE_ISSUE_NUMBER=$ISSUE_NUMBER" >> "$GITHUB_ENV"
+
+      - name: Run Analytics Review
+        timeout-minutes: 50
+        env:
+          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+          GOOGLE_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+          ANTIGRAVITY_API_KEY: ${{ secrets.GEMINI_API_KEY }}
+          GH_TOKEN: ${{ secrets.GH_PAT || github.token }}
+          ROUTINE_ISSUE_NUMBER: ${{ steps.run-issue.outputs.issue_number }}
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+          POSTHOG_API_KEY: ${{ secrets.POSTHOG_API_KEY }}
+          MODEL: ${{ steps.routine-config.outputs.model || 'gemini-3.8-flash-high' }}
+          PRINT_TIMEOUT: ${{ steps.routine-config.outputs.print_timeout || '50m' }}
+          SKILLS_PROMPT: ${{ steps.skills.outputs.skills_prompt }}
+          GITHUB_SERVER_URL: ${{ github.server_url }}
+          GITHUB_REPOSITORY: ${{ github.repository }}
+          GITHUB_RUN_ID: ${{ github.run_id }}
+        run: |
+          PROMPT="You are the Analytics Review routine for this repository. Read and follow the instructions in .github/prompts/analytics-review.md exactly. ${SKILLS_PROMPT}"
+
+          set +e
+          agy -p "$PROMPT" \
+            --model "$MODEL" \
+            --output-format text \
+            --print-timeout "$PRINT_TIMEOUT" \
+            --dangerously-skip-permissions 2>&1 | tee /tmp/agy.log
+          AGY_EXIT_CODE="${PIPESTATUS[0]}"
+          set -e
+
+          if [ "$AGY_EXIT_CODE" -ne 0 ]; then
+            if grep -qiE "Individual quota reached|quota reached" /tmp/agy.log; then
+              RESET_INFO=$(grep -oE "Resets in [^.]+" /tmp/agy.log | head -n 1 || echo "Resets in future window")
+              echo "QUOTA_PAUSED=true" >> "$GITHUB_ENV"
+              echo "QUOTA_RESET_INFO=$RESET_INFO" >> "$GITHUB_ENV"
+              echo "⚠️ LLM quota limit reached ($RESET_INFO). Pausing routine gracefully until next sweep."
+              exit 0
+            fi
+            exit "$AGY_EXIT_CODE"
+          fi
+
+      - name: Emit run summary
+        if: always()
+        run: |
+          if [ "$QUOTA_PAUSED" = "true" ]; then
+            echo "### ⏸️ Milestone: Routine Execution Quota-Paused" >> "$GITHUB_STEP_SUMMARY"
+            echo "- **Status**: LLM quota reached (\`${QUOTA_RESET_INFO}\`)" >> "$GITHUB_STEP_SUMMARY"
+            echo "- **Next Action**: Routine execution paused cleanly. Work will resume automatically on the next scheduled sweep after the quota window resets." >> "$GITHUB_STEP_SUMMARY"
+          else
+            REPORT_FILE=".jonah-fleet/run-report.md"
+            if [ -f "$REPORT_FILE" ] && [ -n "$GITHUB_STEP_SUMMARY" ]; then
+              cat "$REPORT_FILE" >> "$GITHUB_STEP_SUMMARY"
+            fi
+          fi
+
+      - name: Emit Fleet Telemetry (Opt-in)
+        if: always()
+        env:
+          GH_TOKEN: ${{ secrets.GH_PAT || github.token }}
+          TELEMETRY_ENDPOINT: ${{ secrets.JONAH_FLEET_TELEMETRY_ENDPOINT }}
+          GITHUB_REPOSITORY: ${{ github.repository }}
+          GITHUB_RUN_ID: ${{ github.run_id }}
+          GITHUB_RUN_NUMBER: ${{ github.run_number }}
+        run: |
+          REPORT_FILE=".jonah-fleet/run-report.md"
+          if [ -f "$REPORT_FILE" ]; then
+            npx --yes jonah-fleet telemetry --emit --log "$REPORT_FILE" --endpoint "$TELEMETRY_ENDPOINT" || true
+          fi
+
+      - name: Reconcile Routine Run Issue
+        if: always()
+        env:
+          GH_TOKEN: ${{ secrets.GH_PAT || github.token }}
+          ISSUE_NUMBER: ${{ steps.run-issue.outputs.issue_number }}
+          JOB_STATUS: ${{ job.status }}
+          EVENT_NAME: ${{ github.event_name }}
+          RUN_ID: ${{ github.run_id }}
+          SERVER_URL: ${{ github.server_url }}
+          REPOSITORY: ${{ github.repository }}
+          QUOTA_PAUSED: ${{ env.QUOTA_PAUSED }}
+          QUOTA_RESET_INFO: ${{ env.QUOTA_RESET_INFO }}
+        run: |
+          if [ -z "$ISSUE_NUMBER" ]; then
+            echo "No routine issue to reconcile."
+            exit 0
+          fi
+
+          if [ "$QUOTA_PAUSED" = "true" ]; then
+            RESET_STR="${QUOTA_RESET_INFO:-Resets in upcoming window}"
+            PAUSE_BODY="### ⏸️ Autonomous Routine Execution Quota-Paused
+          - **Routine**: \`analytics-review\`
+          - **Run ID**: [\`${RUN_ID}\`](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})
+          - **Trigger**: \`${EVENT_NAME}\`
+          - **Status**: LLM quota reached (\`${RESET_STR}\`)
+          - **Next Action**: Routine execution paused cleanly. Work will resume automatically on the next scheduled sweep after the quota window resets.
+
+          ---
+          _Generated by [Antigravity](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})_"
+
+            TEMP_BODY=$(mktemp)
+            echo "$PAUSE_BODY" > "$TEMP_BODY"
+            gh issue edit "$ISSUE_NUMBER" --body-file "$TEMP_BODY"
+            rm -f "$TEMP_BODY"
+
+            PAUSE_COMMENT=$(printf '%s\n' \
+              "### ⏸️ Milestone: Routine Execution Quota-Paused" \
+              "- **Routine**: \`analytics-review\`" \
+              "- **Status**: LLM quota reached (\`${RESET_STR}\`)" \
+              "- **Action Log**: [View GitHub Actions Run](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})" \
+              "- **Next Action**: Execution paused cleanly. The routine will resume automatically on the next scheduled sweep." \
+              "" \
+              "---" \
+              "_Generated by [Antigravity](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})_")
+            gh issue comment "$ISSUE_NUMBER" --body "$PAUSE_COMMENT" || true
+            gh issue edit "$ISSUE_NUMBER" --add-label "status:quota-paused" --remove-label "status:running"
+            gh issue close "$ISSUE_NUMBER" --reason completed
+            echo "⏸️ Routine run issue #$ISSUE_NUMBER closed with status:quota-paused."
+            exit 0
+          fi
+
+          REPORT_FILE=".jonah-fleet/run-report.md"
+
+          if [ -f "$REPORT_FILE" ]; then
+            BODY_CONTENT=$(cat "$REPORT_FILE")
+          else
+            BODY_CONTENT="### Autonomous Routine Execution Completed (${JOB_STATUS})
+          - **Routine**: \`analytics-review\`
+          - **Run ID**: [\`${RUN_ID}\`](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})
+          - **Trigger**: \`${EVENT_NAME}\`"
+          fi
+
+          FINAL_BODY="${BODY_CONTENT}
+
+          ---
+          _Generated by [Antigravity](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})_"
+
+          TEMP_BODY=$(mktemp)
+          echo "$FINAL_BODY" > "$TEMP_BODY"
+          gh issue edit "$ISSUE_NUMBER" --body-file "$TEMP_BODY"
+          rm -f "$TEMP_BODY"
+
+          if [ "$JOB_STATUS" = "success" ]; then
+            gh issue edit "$ISSUE_NUMBER" --add-label "status:success" --remove-label "status:running"
+            gh issue close "$ISSUE_NUMBER" --reason completed
+            echo "✓ Routine run issue #$ISSUE_NUMBER closed as completed."
+          else
+            INTERRUPTION_BODY=$(printf '%s\n' \
+              "### ❌ Milestone: Run Interrupted / Failed" \
+              "- **Routine**: \`analytics-review\`" \
+              "- **Status**: Workflow job failed or timed out (\`${JOB_STATUS}\`)" \
+              "- **Step**: Actions execution halted before normal completion" \
+              "- **Action Log**: [View GitHub Actions Run](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})" \
+              "" \
+              "---" \
+              "_Generated by [Antigravity](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})_")
+            gh issue comment "$ISSUE_NUMBER" --body "$INTERRUPTION_BODY" || true
+            gh issue edit "$ISSUE_NUMBER" --add-label "status:failure,needs-attention" --remove-label "status:running"
+            echo "⚠️ Routine run issue #$ISSUE_NUMBER left open for triage (status: $JOB_STATUS)."
+          fi

package/templates/workflows/autowork-cron.yml

@@ -198,18 +198,38 @@ jobs:
             PROMPT="You are the Autowork routine for this repository. Read and follow the instructions in .github/prompts/autowork.md exactly. ${SKILLS_PROMPT} You are in Scan mode: check open PRs for review comments to fix, close merged issues, then pick the highest-priority unclaimed issue."
           fi
 
+          set +e
           agy -p "$PROMPT" \
             --model "$MODEL" \
             --output-format text \
             --print-timeout "$PRINT_TIMEOUT" \
-            --dangerously-skip-permissions
+            --dangerously-skip-permissions 2>&1 | tee /tmp/agy.log
+          AGY_EXIT_CODE="${PIPESTATUS[0]}"
+          set -e
+
+          if [ "$AGY_EXIT_CODE" -ne 0 ]; then
+            if grep -qiE "Individual quota reached|quota reached" /tmp/agy.log; then
+              RESET_INFO=$(grep -oE "Resets in [^.]+" /tmp/agy.log | head -n 1 || echo "Resets in future window")
+              echo "QUOTA_PAUSED=true" >> "$GITHUB_ENV"
+              echo "QUOTA_RESET_INFO=$RESET_INFO" >> "$GITHUB_ENV"
+              echo "⚠️ LLM quota limit reached ($RESET_INFO). Pausing routine gracefully until next sweep."
+              exit 0
+            fi
+            exit "$AGY_EXIT_CODE"
+          fi
 
       - name: Emit run summary
         if: always()
         run: |
-          REPORT_FILE=".jonah-fleet/run-report.md"
-          if [ -f "$REPORT_FILE" ] && [ -n "$GITHUB_STEP_SUMMARY" ]; then
-            cat "$REPORT_FILE" >> "$GITHUB_STEP_SUMMARY"
+          if [ "$QUOTA_PAUSED" = "true" ]; then
+            echo "### ⏸️ Milestone: Routine Execution Quota-Paused" >> "$GITHUB_STEP_SUMMARY"
+            echo "- **Status**: LLM quota reached (\`${QUOTA_RESET_INFO}\`)" >> "$GITHUB_STEP_SUMMARY"
+            echo "- **Next Action**: Routine execution paused cleanly. Work will resume automatically on the next scheduled sweep after the quota window resets." >> "$GITHUB_STEP_SUMMARY"
+          else
+            REPORT_FILE=".jonah-fleet/run-report.md"
+            if [ -f "$REPORT_FILE" ] && [ -n "$GITHUB_STEP_SUMMARY" ]; then
+              cat "$REPORT_FILE" >> "$GITHUB_STEP_SUMMARY"
+            fi
           fi
 
       - name: Emit Fleet Telemetry (Opt-in)
@@ -257,12 +277,47 @@ jobs:
           RUN_ID: ${{ github.run_id }}
           SERVER_URL: ${{ github.server_url }}
           REPOSITORY: ${{ github.repository }}
+          QUOTA_PAUSED: ${{ env.QUOTA_PAUSED }}
+          QUOTA_RESET_INFO: ${{ env.QUOTA_RESET_INFO }}
         run: |
           if [ -z "$ISSUE_NUMBER" ]; then
             echo "No routine issue to reconcile."
             exit 0
           fi
 
+          if [ "$QUOTA_PAUSED" = "true" ]; then
+            RESET_STR="${QUOTA_RESET_INFO:-Resets in upcoming window}"
+            PAUSE_BODY="### ⏸️ Autonomous Routine Execution Quota-Paused
+          - **Routine**: \`autowork\`
+          - **Run ID**: [\`${RUN_ID}\`](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})
+          - **Trigger**: \`${EVENT_NAME}\`
+          - **Status**: LLM quota reached (\`${RESET_STR}\`)
+          - **Next Action**: Routine execution paused cleanly. Work will resume automatically on the next scheduled sweep after the quota window resets.
+
+          ---
+          _Generated by [Antigravity](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})_"
+
+            TEMP_BODY=$(mktemp)
+            echo "$PAUSE_BODY" > "$TEMP_BODY"
+            gh issue edit "$ISSUE_NUMBER" --body-file "$TEMP_BODY"
+            rm -f "$TEMP_BODY"
+
+            PAUSE_COMMENT=$(printf '%s\n' \
+              "### ⏸️ Milestone: Routine Execution Quota-Paused" \
+              "- **Routine**: \`autowork\`" \
+              "- **Status**: LLM quota reached (\`${RESET_STR}\`)" \
+              "- **Action Log**: [View GitHub Actions Run](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})" \
+              "- **Next Action**: Execution paused cleanly. The routine will resume automatically on the next scheduled sweep." \
+              "" \
+              "---" \
+              "_Generated by [Antigravity](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})_")
+            gh issue comment "$ISSUE_NUMBER" --body "$PAUSE_COMMENT" || true
+            gh issue edit "$ISSUE_NUMBER" --add-label "status:quota-paused" --remove-label "status:running"
+            gh issue close "$ISSUE_NUMBER" --reason completed
+            echo "⏸️ Routine run issue #$ISSUE_NUMBER closed with status:quota-paused."
+            exit 0
+          fi
+
           REPORT_FILE=".jonah-fleet/run-report.md"
 
           if [ -f "$REPORT_FILE" ]; then

package/templates/workflows/dependency-check-cron.yml

@@ -148,11 +148,39 @@ jobs:
         run: |
           PROMPT="You are the Dependency Update & Security Check routine. Read and follow .github/prompts/dependency-update-security-check.md exactly. Check dependencies for updates and vulnerabilities, and create or update tracking issues."
 
+          set +e
           agy -p "$PROMPT" \
             --model "$MODEL" \
             --output-format text \
             --print-timeout "$PRINT_TIMEOUT" \
-            --dangerously-skip-permissions
+            --dangerously-skip-permissions 2>&1 | tee /tmp/agy.log
+          AGY_EXIT_CODE="${PIPESTATUS[0]}"
+          set -e
+
+          if [ "$AGY_EXIT_CODE" -ne 0 ]; then
+            if grep -qiE "Individual quota reached|quota reached" /tmp/agy.log; then
+              RESET_INFO=$(grep -oE "Resets in [^.]+" /tmp/agy.log | head -n 1 || echo "Resets in future window")
+              echo "QUOTA_PAUSED=true" >> "$GITHUB_ENV"
+              echo "QUOTA_RESET_INFO=$RESET_INFO" >> "$GITHUB_ENV"
+              echo "⚠️ LLM quota limit reached ($RESET_INFO). Pausing routine gracefully until next sweep."
+              exit 0
+            fi
+            exit "$AGY_EXIT_CODE"
+          fi
+
+      - name: Emit run summary
+        if: always()
+        run: |
+          if [ "$QUOTA_PAUSED" = "true" ]; then
+            echo "### ⏸️ Milestone: Routine Execution Quota-Paused" >> "$GITHUB_STEP_SUMMARY"
+            echo "- **Status**: LLM quota reached (\`${QUOTA_RESET_INFO}\`)" >> "$GITHUB_STEP_SUMMARY"
+            echo "- **Next Action**: Routine execution paused cleanly. Work will resume automatically on the next scheduled sweep after the quota window resets." >> "$GITHUB_STEP_SUMMARY"
+          else
+            REPORT_FILE=".jonah-fleet/run-report.md"
+            if [ -f "$REPORT_FILE" ] && [ -n "$GITHUB_STEP_SUMMARY" ]; then
+              cat "$REPORT_FILE" >> "$GITHUB_STEP_SUMMARY"
+            fi
+          fi
 
       - name: Reconcile Routine Run Issue
         if: always()
@@ -164,12 +192,47 @@ jobs:
           RUN_ID: ${{ github.run_id }}
           SERVER_URL: ${{ github.server_url }}
           REPOSITORY: ${{ github.repository }}
+          QUOTA_PAUSED: ${{ env.QUOTA_PAUSED }}
+          QUOTA_RESET_INFO: ${{ env.QUOTA_RESET_INFO }}
         run: |
           if [ -z "$ISSUE_NUMBER" ]; then
             echo "No routine issue to reconcile."
             exit 0
           fi
 
+          if [ "$QUOTA_PAUSED" = "true" ]; then
+            RESET_STR="${QUOTA_RESET_INFO:-Resets in upcoming window}"
+            PAUSE_BODY="### ⏸️ Autonomous Routine Execution Quota-Paused
+          - **Routine**: \`dependency-update-security-check\`
+          - **Run ID**: [\`${RUN_ID}\`](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})
+          - **Trigger**: \`${EVENT_NAME}\`
+          - **Status**: LLM quota reached (\`${RESET_STR}\`)
+          - **Next Action**: Routine execution paused cleanly. Work will resume automatically on the next scheduled sweep after the quota window resets.
+
+          ---
+          _Generated by [Antigravity](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})_"
+
+            TEMP_BODY=$(mktemp)
+            echo "$PAUSE_BODY" > "$TEMP_BODY"
+            gh issue edit "$ISSUE_NUMBER" --body-file "$TEMP_BODY"
+            rm -f "$TEMP_BODY"
+
+            PAUSE_COMMENT=$(printf '%s\n' \
+              "### ⏸️ Milestone: Routine Execution Quota-Paused" \
+              "- **Routine**: \`dependency-check\`" \
+              "- **Status**: LLM quota reached (\`${RESET_STR}\`)" \
+              "- **Action Log**: [View GitHub Actions Run](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})" \
+              "- **Next Action**: Execution paused cleanly. The routine will resume automatically on the next scheduled sweep." \
+              "" \
+              "---" \
+              "_Generated by [Antigravity](${SERVER_URL}/${REPOSITORY}/actions/runs/${RUN_ID})_")
+            gh issue comment "$ISSUE_NUMBER" --body "$PAUSE_COMMENT" || true
+            gh issue edit "$ISSUE_NUMBER" --add-label "status:quota-paused" --remove-label "status:running"
+            gh issue close "$ISSUE_NUMBER" --reason completed
+            echo "⏸️ Routine run issue #$ISSUE_NUMBER closed with status:quota-paused."
+            exit 0
+          fi
+
           REPORT_FILE=".jonah-fleet/run-report.md"
 
           if [ -f "$REPORT_FILE" ]; then