Skip to content

Repository Variables — Implementation Guide

Last Updated: 2026-07-11 Version: v0.2.0

Source: PR #3483 comment #issuecomment-3988416714 Author: Copilot variable analysis (2026-03-03) Version: 1.0.0 **Last Updated: 2026-07-11 Human Admin Action Guide: HUMAN_ADMIN_REPO_VARIABLES_SETUP.md


Table of Contents

  1. Architecture Overview
  2. Current Variable Status
  3. New Variables — Cognitive Brain
  4. New Variables — Copilot CLI
  5. New Variables — CI/CD Health
  6. Session Number Auto-Increment
  7. CI Failure Rate Lifecycle
  8. Code Wiring Reference
  9. Variable Dependency Map

1. Architecture Overview

The repository variables feed three subsystems: the Cognitive Brain (memory injection pipeline), the Copilot CLI (FastAPI cognitive_app at port 8765), and the CI/CD health automation layer.

%%{init: {'accessibility': {'title': 'Diagram showing "GitHub Repository Variables", " Cognitive Brain\nMAX_CONTEXT_TOKENS\nLTM_RETENTION_DAYS\nPATTERN_MIN_CONFIDENCE\nMEMORY_TIER\nSESSION_NUMBER\nINJECTION_ENABLED\nALLOWED_ACTORS"'}}%%

graph TB
 subgraph GH["GitHub Repository Variables"]
 direction TB
 CB_GROUP[" Cognitive Brain\nMAX_CONTEXT_TOKENS\nLTM_RETENTION_DAYS\nPATTERN_MIN_CONFIDENCE\nMEMORY_TIER\nSESSION_NUMBER\nINJECTION_ENABLED\nALLOWED_ACTORS"]
 CLI_GROUP[" Copilot CLI\nCLI_BASE_URL\nCLI_ENABLED\nSESSION_RESTORE_ENABLED\nMAX_AUTONOMY_LEVEL\nAGENT_AUTH_ENABLED\nAGENT_FIREWALL_ENABLED"]
 CI_GROUP[" CI/CD Health\nCI_FAILURE_RATE\nCI_FAILURE_THRESHOLD\nCI_LAST_GREEN_SHA\nHANDOFF_TIMEOUT_SECONDS\nEMBEDDING_INDEX_AUTO_REBUILD\nAUTO_PROMOTE_TIER_ENABLED"]
 STATIC_GROUP[" Static / Identity\nAGENT_NAME\nAPI_VERSION\nORG_NAME\nISOLATED_PATH\nNETWORK_MODE\nGENESIS_TIMESTAMP\nAUDIT_RETENTION_DAYS"]
 end

 subgraph CONSUMERS["Workflow / Code Consumers"]
 CHATOPS["chatops_copilot_trigger.yml\n(session injection)"]
 ADMIN["admin_setup_verification.yml\n(bootstrap validation)"]
 HEALTH["ci-health-monitor.yml\n(failure rate writer)"]
 AGENT_AUTH["agent-auth-delegation.yml\n(preflight + activation)"]
 REGISTRY["agent-registry-validation.yml\n(FAISS rebuild trigger)"]
 FRONTEND["cognitive_app / ApiClient.tsx\n(VITE_CLI_API_URL)"]
 MANIFEST["scripts/ci/generate_manifest.py\n(context injection)"]
 end

 CB_GROUP --> CHATOPS

 CB_GROUP --> ADMIN

 CB_GROUP --> MANIFEST

 CLI_GROUP --> FRONTEND

 CLI_GROUP --> AGENT_AUTH

 CI_GROUP --> HEALTH

 CI_GROUP --> REGISTRY

 STATIC_GROUP --> ADMIN

 STATIC_GROUP --> CHATOPS

2. Current Variable Status

2a. Placeholder / Auto-Updated Variables

These variables drift when stored as static integers or strings — they must be updated programmatically by a workflow step.

Variable Current Value Update Mechanism Format Spec
COGNITIVE_BRAIN_SESSION_NUMBER 109 Auto-increment via chatops_copilot_trigger.yml step (see §6) Integer, monotonically increasing
CODEX_CI_FAILURE_RATE 11.0:degraded Written by ci-health-monitor.yml step "Update CODEX_CI_FAILURE_RATE repo variable" <float>:<status> where status ∈ {ok, degraded, critical}

Format spec for CODEX_CI_FAILURE_RATE: - ok — rate < CODEX_CI_FAILURE_THRESHOLD - degraded — rate ≥ CODEX_CI_FAILURE_THRESHOLD (default threshold: 10.0) - critical — rate ≥ 2 × CODEX_CI_FAILURE_THRESHOLD (default: 20.0)

2b. Correctly Static Variables

These are human-controlled governance flags and identity constants. Automation must never overwrite them without explicit owner approval.

Variable Rationale
AUTONOMOUS_ACTIONS_ENABLED Human governance flag — gates all autonomous agent actions
COPILOT_AGENT_AUTH_ENABLED Human governance flag — gates token delegation
COPILOT_AGENT_FIREWALL_ENABLED Human governance flag — network isolation control
COGNITIVE_BRAIN_INJECTION_ENABLED Human governance flag — session context injection master switch
GENESIS_TIMESTAMP Immutable identity constant set at repository creation
CODEX_ORG_NAME Identity constant
CODEX_AGENT_NAME Identity constant
CODEX_API_VERSION API version pin
CODEX_ISOLATED_PATH Network isolation path
CODEX_NETWORK_MODE Network mode policy
AUDIT_RETENTION_DAYS Retention policy (change only with explicit decision)

3. New Variables — Cognitive Brain

These variables externalise constants currently embedded in Python scripts, enabling workflow-level override without code changes.

Variable Definitions

Variable Recommended Value Type
COGNITIVE_BRAIN_MAX_CONTEXT_TOKENS 32000 Integer (read-only by agents)
COGNITIVE_BRAIN_LTM_RETENTION_DAYS 90 Integer
COGNITIVE_BRAIN_PATTERN_MIN_CONFIDENCE 0.75 Float string
COGNITIVE_BRAIN_MEMORY_TIER both Enum: stm | ltm | both

Purpose Details

COGNITIVE_BRAIN_MAX_CONTEXT_TOKENS Mirrors CONTEXT_WINDOW_BUDGET = 32_000 in scripts/ci/generate_manifest.py:59. Externalising this allows CI to override the injection ceiling without a code change. Consumed by sanitize_for_injection() — raises ValueError when safe payload exceeds budget.

# scripts/ci/generate_manifest.py (current hardcoded constant — wire to var)
CONTEXT_WINDOW_BUDGET: int = int(os.environ.get("COGNITIVE_BRAIN_MAX_CONTEXT_TOKENS", 32_000))

COGNITIVE_BRAIN_LTM_RETENTION_DAYS Aligns with AUDIT_RETENTION_DAYS = 90. Consumed by scripts/ci/prune_corpus.py (90-day corpus retention). Externalising enables tuning without commits.

COGNITIVE_BRAIN_PATTERN_MIN_CONFIDENCE Gate threshold before a memory pattern is injected into a Copilot session. Referenced by AgentBrainInterface.query_patterns() in src/codex/cognitive/brain_interface.py.

COGNITIVE_BRAIN_MEMORY_TIER Controls which SQLite tiers are active for session recall. STM = short-term (deque), LTM = long-term (SQLite persist), both = full recall pipeline.

Wiring Diagram

%%{init: {'accessibility': {'title': 'Flowchart showing "COGNITIVE_BRAIN_MAX_CONTEXT_TOKENS\n= 32000", "generate_manifest.py\nCONTEXT_WINDOW_BUDGET"'}}%%

flowchart LR

 VAR_TOKENS["COGNITIVE_BRAIN_MAX_CONTEXT_TOKENS\n= 32000"] --> MANIFEST["generate_manifest.py\nCONTEXT_WINDOW_BUDGET"]

 VAR_LTM["COGNITIVE_BRAIN_LTM_RETENTION_DAYS\n= 90"] --> PRUNE["prune_corpus.py\nretention_days"]

 VAR_CONF["COGNITIVE_BRAIN_PATTERN_MIN_CONFIDENCE\n= 0.75"] --> BRAIN["brain_interface.py\nquery_patterns(min_confidence)"]

 VAR_TIER["COGNITIVE_BRAIN_MEMORY_TIER\n= both"] --> BRAIN

 MANIFEST --> INJECT["sanitize_for_injection()\nSession context payload"]

 BRAIN --> INJECT

 INJECT --> SESSION["Copilot Agent Session\n<repository_memories>"]

4. New Variables — Copilot CLI

These variables wire the cognitive_app FastAPI server endpoint into CI and enable feature-flagging of CLI capabilities without code changes.

Variable Definitions

Variable Recommended Value Type
COPILOT_CLI_BASE_URL http://localhost:8765 URL string
COPILOT_CLI_ENABLED true Boolean string
COPILOT_AGENT_SESSION_RESTORE_ENABLED true Boolean string
COPILOT_AGENT_MAX_AUTONOMY_LEVEL E Enum: E (advisory) | D (autonomous with approval)

Purpose Details

COPILOT_CLI_BASE_URL The cognitive_app API endpoint. Currently hardcoded in three frontend files: - cognitive_app/src/components/cli/ApiClient.tsx:40 — CLI_API constant - cognitive_app/src/components/cli/XtermTerminal.tsx:13 — API_BASE constant - cognitive_app/src/components/cli/index.tsx:30 — CLI_API constant

ApiClient.tsx already reads VITE_CLI_API_URL (commit cf85ef5); XtermTerminal.tsx also reads VITE_CLI_API_URL at line 13. Setting this repo variable allows CI integration tests to point at a test server without modifying code.

COPILOT_CLI_ENABLED Feature flag. When false, workflows skip CLI startup and API health checks. Useful for environments where port 8765 is blocked.

COPILOT_AGENT_SESSION_RESTORE_ENABLED When true, session-log-retrieval-agent injects prior session context at session start. Enables true memory continuity across Copilot coding agent sessions.

COPILOT_AGENT_MAX_AUTONOMY_LEVEL Caps the autonomy tier the agent may act at within a session. E = advisory only; D = autonomous with human approval required (controlled by e-to-d-transition-gate.yml). Currently the gate score is 5/5 (D_CAPABLE unlocked) — this variable is the runtime cap.

Wiring Diagram

%%{init: {'accessibility': {'title': 'Flowchart showing "COPILOT_CLI_BASE_URL\n= http://localhost:8765", "ApiClient.tsx\nXtermTerminal.tsx"'}}%%

flowchart TD

 VAR_URL["COPILOT_CLI_BASE_URL\n= http://localhost:8765"] --> |VITE_CLI_API_URL| FE_API["ApiClient.tsx\nXtermTerminal.tsx"]

 VAR_URL --> |CI integration tests| TEST_SERVER["test API server\n(port override)"]

 VAR_ENABLED["COPILOT_CLI_ENABLED\n= true"] --> |feature gate| WORKFLOW_STEP["copilot-setup-steps.yml\nStart CLI API Server step"]

 VAR_RESTORE["COPILOT_AGENT_SESSION_RESTORE_ENABLED\n= true"] --> SESSION_AGENT["session-log-retrieval-agent\nContext injection at session start"]

 VAR_AUTONOMY["COPILOT_AGENT_MAX_AUTONOMY_LEVEL\n= E"] --> |runtime cap| GATE["e-to-d-transition-gate.yml\nFSM autonomy control"]

 GATE --> |D_CAPABLE score 5/5| AGENT_ACTIONS["Autonomous agent actions\n(require human approval at tier D)"]

5. New Variables — CI/CD Health

These variables drive the self-healing CI pipeline, tier promotion automation, and FAISS index management.

Variable Definitions

Variable Recommended Value Type Update Mechanism
CODEX_CI_FAILURE_THRESHOLD 10.0 Float string Static (human-set)
CODEX_CI_LAST_GREEN_SHA (empty — auto-set) Git SHA string Auto-written on green push
AGENT_HANDOFF_TIMEOUT_SECONDS 120 Integer string Static
EMBEDDING_INDEX_AUTO_REBUILD true Boolean string Static
AUTO_PROMOTE_TIER_ENABLED false Boolean string Static (promote to true after validation)

Purpose Details

CODEX_CI_FAILURE_THRESHOLD The numeric rate at which CODEX_CI_FAILURE_RATE status flips to degraded. ci-health-monitor.yml currently compares against a hardcoded value; externalising it allows threshold adjustment without a workflow commit.

CODEX_CI_LAST_GREEN_SHA Auto-set by a post-green-push workflow step. Enables bisect commands like:

git bisect good "$CODEX_CI_LAST_GREEN_SHA"

AGENT_HANDOFF_TIMEOUT_SECONDS Maximum wait time in agent-handoff-gate.yml before a handoff is declared failed. Currently hardcoded in the workflow step; externalising enables tuning.

EMBEDDING_INDEX_AUTO_REBUILD Controls whether agent-registry-validation.yml triggers embedding-index-rebuild.yml on push to main via gh workflow run. Already wired at lines 231–238 of the validation workflow — this variable becomes the guard condition.

AUTO_PROMOTE_TIER_ENABLED Gates scripts/ci/auto_promote_tier.py. Start at false until promotion logic is fully validated. Flip to true to enable automatic agent tier elevation.

CI Health State Machine

%%{init: {'accessibility': {'title': 'State Diagram showing *, *'}}%%

stateDiagram-v2

 [*] --> ok : failure_rate < THRESHOLD(10.0)

 ok --> degraded : failure_rate >= THRESHOLD(10.0)

 degraded --> critical : failure_rate >= 2×THRESHOLD(20.0)

 critical --> degraded : failure_rate < 2×THRESHOLD

 degraded --> ok : failure_rate < THRESHOLD

 ok --> [*] : CODEX_CI_LAST_GREEN_SHA written

 note right of ok
 CODEX_CI_FAILURE_RATE = "<rate>:ok"
 CODEX_CI_LAST_GREEN_SHA = HEAD_SHA
 end note
 note right of degraded
 CODEX_CI_FAILURE_RATE = "<rate>:degraded"
 Self-healing CI escalates
 end note
 note right of critical
 CODEX_CI_FAILURE_RATE = "<rate>:critical"
 Emergency response agent triggered
 end note

5a. New Variables — Codespaces Prebuild

These variables ensure GitHub Codespaces prebuilds succeed and give Copilot agents a consistent runtime environment. They resolve prebuild error 1309 (UnifiedContainersErrorPrebuilTemplateOnCreateFailed), triggered when the APT list directory is missing/corrupted during onCreateCommand (E: List directory /var/lib/apt/lists/partial is missing.).

Variable Definitions

Variable Recommended Value Type MUST/SHOULD/MAY
CODESPACES_APT_UPDATE_RETRY true Boolean string SHOULD
CODESPACES_APT_CLEANUP_AGGRESSIVE true Boolean string MAY
CODEX_DEVCONTAINER_WORKSPACE /workspaces/_codex_ Path string SHOULD
CODEX_DEVCONTAINER_PYTHON_VERSION 3.12 Version string MUST
CODEX_DEVCONTAINER_NODE_VERSION 22 Version string SHOULD
CODEX_DEVCONTAINER_RUST_VERSION stable Version string MAY
CODEX_SESSION_LOG_DIR /workspaces/_codex_/.codex/sessions Path string MUST
CODEX_DB_PATH /workspaces/_codex_/.codex/codex.db Path string MUST
CODEX_SQLITE_POOL 1 Integer string SHOULD
CODEX_CLI_API_URL http://localhost:8765 URL string MUST

Setup Instructions

Via GitHub UI (Settings Secrets and variables Actions Variables):

  1. CODESPACES_APT_UPDATE_RETRY = true
  2. CODESPACES_APT_CLEANUP_AGGRESSIVE = true
  3. CODEX_DEVCONTAINER_WORKSPACE = /workspaces/_codex_
  4. CODEX_DEVCONTAINER_PYTHON_VERSION = 3.12
  5. CODEX_DEVCONTAINER_NODE_VERSION = 22
  6. CODEX_DEVCONTAINER_RUST_VERSION = stable
  7. CODEX_SESSION_LOG_DIR = /workspaces/_codex_/.codex/sessions
  8. CODEX_DB_PATH = /workspaces/_codex_/.codex/codex.db
  9. CODEX_SQLITE_POOL = 1
  10. CODEX_CLI_API_URL = http://localhost:8765

Via gh CLI (requires an authenticated token with repo scope):

bash .codex/CODESPACES_VARIABLES_BOOTSTRAP.sh

Wiring Diagram

%%{init: {'accessibility': {'title': 'Flowchart showing "CODESPACES_APT_UPDATE_RETRY\n= true", "on-create.sh\napt_update_with_retry()"'}}%%

flowchart TD

 RETRY["CODESPACES_APT_UPDATE_RETRY\n= true"] --> ONCREATE["on-create.sh\napt_update_with_retry()"]

 CLEAN["CODESPACES_APT_CLEANUP_AGGRESSIVE\n= true"] --> ONCREATE

 ONCREATE --> |repairs| APT["/var/lib/apt/lists/partial\n(recreated, chmod 0755)"]

 APT --> |update succeeds| INSTALL["apt-get install build-essential …"]

 INSTALL --> |cleanup only on success| PRUNE["rm -rf /var/lib/apt/lists/*"]

 DBPATH["CODEX_DB_PATH / CODEX_SESSION_LOG_DIR"] --> DEVJSON["devcontainer.json containerEnv"]

 POOL["CODEX_SQLITE_POOL = 1"] --> DEVJSON

6. Session Number Auto-Increment

COGNITIVE_BRAIN_SESSION_NUMBER must be incremented by a workflow step, not set manually, to maintain meaningful recall ordering.

Implementation Pattern

Add the following step to chatops_copilot_trigger.yml (or agent-auth-delegation.yml) immediately after reading the current session number:

- name: Increment COGNITIVE_BRAIN_SESSION_NUMBER
 env:
 GH_TOKEN: ${{ secrets.CODEX_MASTER_KEY }}
 run: |
 CURRENT="${{ vars.COGNITIVE_BRAIN_SESSION_NUMBER }}"
 NEXT=$((CURRENT + 1))
 gh api \
 --method PATCH \
 -H "Accept: application/vnd.github+json" \
 /repos/${{ github.repository }}/actions/variables/COGNITIVE_BRAIN_SESSION_NUMBER \
 -f name='COGNITIVE_BRAIN_SESSION_NUMBER' \
 -f value="$NEXT"
 echo "Session number incremented: $CURRENT $NEXT"

Auto-Increment Flow

%%{init: {'accessibility': {'title': 'Sequence Diagram: >>WF: N

 WF'}}%%
sequenceDiagram
 participant PR as PR event
 participant WF as chatops_copilot_trigger.yml
 participant GH as GitHub Variables API
 participant BRAIN as Cognitive Brain Session

 PR->>WF: PR comment / @copilot trigger
 WF->>GH: GET COGNITIVE_BRAIN_SESSION_NUMBER (current = N)

 GH-->>WF: N
 WF->>GH: PATCH COGNITIVE_BRAIN_SESSION_NUMBER = N+1

 GH-->>WF: 204 No Content
 WF->>BRAIN: Inject session context with SESSION_NUMBER = N+1

 BRAIN-->>PR: Session activated (number N+1)

 Note over WF,GH: Requires CODEX_MASTER_KEY with\nvariables: read+write permission

7. CI Failure Rate Lifecycle

CODEX_CI_FAILURE_RATE is written by ci-health-monitor.yml after every telemetry run. The format spec <float>:<status> must be parsed consistently by all consumers.

Lifecycle

%%{init: {'accessibility': {'title': 'Flowchart showing "telemetry-collection.yml\nCollects run outcomes\nfailure_rate = failed/total", "ci-health-monitor.yml\nStep: Update CODEX_CI_FAILURE_RATE"'}}%%

flowchart TD

 TELEMETRY["telemetry-collection.yml\nCollects run outcomes\nfailure_rate = failed/total"] --> MONITOR

 MONITOR["ci-health-monitor.yml\nStep: Update CODEX_CI_FAILURE_RATE"] --> |PATCH API| VAR["CODEX_CI_FAILURE_RATE\n= '11.0:degraded'"]

 VAR --> |parsed by| ALERT["ci-health-alert-agent\nthreshold check vs\nCODEX_CI_FAILURE_THRESHOLD"]

 VAR --> |displayed in| BOOTSTRAP["copilot-agent-vars-bootstrap.yml\nSession context echo"]

 VAR --> |read by| SESSION["Copilot Coding Agent\nSession pre-flight summary"]

 ALERT --> |rate >= threshold| ESCALATE["Self-Healing Escalation\nPost PR comment\niterative-self-healing-ci.yml"]

 ALERT --> |rate < threshold| CLEAR["Status: ok\nCODEX_CI_LAST_GREEN_SHA updated"]

 subgraph FORMAT["Format: &lt;float&gt;:&lt;status&gt;"]
 F1["'5.2:ok'"]
 F2["'11.0:degraded'"]
 F3["'22.5:critical'"]
 end

Parser Reference (Bash)

# Parse CODEX_CI_FAILURE_RATE in any workflow step
RATE_RAW="${{ vars.CODEX_CI_FAILURE_RATE }}" # e.g. "11.0:degraded"
RATE_FLOAT="${RATE_RAW%%:*}" # "11.0"
RATE_STATUS="${RATE_RAW##*:}" # "degraded"
THRESHOLD="${{ vars.CODEX_CI_FAILURE_THRESHOLD }}" # "10.0"

if (( $(echo "$RATE_FLOAT >= $THRESHOLD" | bc -l) )); then
 echo "::warning::CI failure rate ${RATE_FLOAT}% exceeds threshold ${THRESHOLD}%"
fi

8. Code Wiring Reference

Files that need updating once variables are created:

File Line Change Required
scripts/ci/generate_manifest.py 59 CONTEXT_WINDOW_BUDGET = int(os.environ.get("COGNITIVE_BRAIN_MAX_CONTEXT_TOKENS", 32_000))
scripts/ci/prune_corpus.py (retention constant) Read COGNITIVE_BRAIN_LTM_RETENTION_DAYS env var
cognitive_app/src/components/cli/index.tsx 30 const CLI_API = import.meta.env.VITE_CLI_API_URL ?? 'http://localhost:8765';
.github/workflows/ci-health-monitor.yml (threshold constant) Replace hardcoded threshold with vars.CODEX_CI_FAILURE_THRESHOLD
.github/workflows/agent-handoff-gate.yml (timeout constant) Replace hardcoded timeout with vars.AGENT_HANDOFF_TIMEOUT_SECONDS
.github/workflows/agent-registry-validation.yml 231–238 Guard gh workflow run with vars.EMBEDDING_INDEX_AUTO_REBUILD == 'true'
.github/workflows/e-to-d-transition-gate.yml (autonomy output) Cap effective tier at vars.COPILOT_AGENT_MAX_AUTONOMY_LEVEL

9. Variable Dependency Map

Shows which variables must exist before others can function correctly.

%%{init: {'accessibility': {'title': 'Flowchart showing "CODEX_CI_FAILURE_THRESHOLD", "CODEX_CI_FAILURE_RATE\n(parser)"'}}%%

graph LR

 THRESHOLD["CODEX_CI_FAILURE_THRESHOLD"] --> |required by| RATE["CODEX_CI_FAILURE_RATE\n(parser)"]

 RATE --> |feeds| LAST_GREEN["CODEX_CI_LAST_GREEN_SHA\n(written when ok)"]

 MAX_TOKENS["COGNITIVE_BRAIN_MAX_CONTEXT_TOKENS"] --> |required by| MANIFEST_SCRIPT["generate_manifest.py\nsanitize_for_injection()"]

 LTM_DAYS["COGNITIVE_BRAIN_LTM_RETENTION_DAYS"] --> |required by| PRUNE_SCRIPT["prune_corpus.py"]

 MIN_CONF["COGNITIVE_BRAIN_PATTERN_MIN_CONFIDENCE"] --> |required by| BRAIN_IFACE["brain_interface.py\nquery_patterns()"]

 MEM_TIER["COGNITIVE_BRAIN_MEMORY_TIER"] --> BRAIN_IFACE

 MANIFEST_SCRIPT --> |builds| INJECTION_PAYLOAD["Session injection payload\n<repository_memories>"]

 BRAIN_IFACE --> INJECTION_PAYLOAD

 SESSION_NUM["COGNITIVE_BRAIN_SESSION_NUMBER"] --> |tags| INJECTION_PAYLOAD

 CLI_URL["COPILOT_CLI_BASE_URL"] --> |VITE_CLI_API_URL| FE["cognitive_app frontend"]

 CLI_ENABLED["COPILOT_CLI_ENABLED"] --> |gates| SERVER_START["CLI server startup step"]

 MAX_AUTON["COPILOT_AGENT_MAX_AUTONOMY_LEVEL"] --> |caps| E_TO_D["e-to-d-transition-gate.yml"]

 RESTORE["COPILOT_AGENT_SESSION_RESTORE_ENABLED"] --> |gates| SESSION_AGENT["session-log-retrieval-agent"]

 AUTO_PROMOTE["AUTO_PROMOTE_TIER_ENABLED"] --> |gates| PROMOTE_SCRIPT["auto_promote_tier.py"]

 EMBED_REBUILD["EMBEDDING_INDEX_AUTO_REBUILD"] --> |gates| FAISS["embedding-index-rebuild.yml"]

 HANDOFF_TO["AGENT_HANDOFF_TIMEOUT_SECONDS"] --> |configures| HANDOFF["agent-handoff-gate.yml"]

Document Maintenance

Field Value
Source comment PR #3483 #issuecomment-3988416714
Human admin action guide HUMAN_ADMIN_REPO_VARIABLES_SETUP.md
Related workflows ci-health-monitor.yml, chatops_copilot_trigger.yml, agent-auth-delegation.yml, agent-registry-validation.yml
Related scripts scripts/ci/generate_manifest.py, scripts/ci/prune_corpus.py, scripts/ci/auto_promote_tier.py
Next review After any of the 5 Tier-1 GROUNDED gates change behaviour