Files
gcp_solution_architecture_a…/.env.example
Jonathan Boniface 5adc911a82 feat: keep an unchanged description, list conditions, review coverage with Jev
After case 02 (completed at 100%, but with two Revisions of the Target
architecture for gaps validation found one pass at a time):

- A Deliverable stands while what it was written from is unchanged. The
  architecture description is written from the Elements and Relationships,
  so a Revision that only adds or rewords Checks no longer runs the describer.
- Non-functional requirements and recommendations list their conditions,
  one entry per separate thing that must be true; submission requires them.
- A coverage review at submission (JEV_COVERAGE_REVIEW, off by default):
  for each condition, Jev chooses which Check verifies it, or none. Asked as
  one broad yes-or-no per requirement it could not tell a complete design
  from one with known gaps; asked as a choice per condition it raised all
  four known gaps of case 02 and nothing on the complete graph. An opt-in
  live test (LIVE_JEV=1) repeats that.
- The validator is told to report every gap in its first pass.

Plans record the case 02 run and both forms of the review with figures.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 20:58:38 +01:00

75 lines
2.7 KiB
Plaintext

# GCP Solution Architecture Agent Environment Variables
# Agent Identity
AGENT_NAME=gcp_solution_architecture_agent
AGENT_VERSION=1.0.0
LOG_LEVEL=INFO
# A2A server (python -m app.main). The container image sets A2A_PORT=8080.
A2A_HOST=0.0.0.0
A2A_PORT=8000
# A2A_PUBLIC_URL=https://agents.example.com/solution-architect
# Models (providers/<name>.yaml): gemini/<model> uses ADK's native Gemini client.
# These are read by Google's client, not by this app's settings. The app exports them
# from this file at start-up; a value already set in the environment wins.
# Vertex AI with Application Default Credentials:
# GOOGLE_GENAI_USE_ENTERPRISE=true
# GOOGLE_CLOUD_PROJECT=your-project-id
# GOOGLE_CLOUD_LOCATION=global
# GOOGLE_APPLICATION_CREDENTIALS=/app/credentials/adc.json
# Or the Gemini API: GOOGLE_API_KEY=...
MODEL_TIMEOUT_SECONDS=180
# Cloud Provider Bundle (providers/<name>.yaml) & Remote MCP Servers
CLOUD_PROVIDER=gcp
MCP_ENABLED=true
MCP_ENABLE_PREVIEW=true
# MCP_QUOTA_PROJECT=your-project-id # defaults to the Application Default Credentials project
MCP_TIMEOUT_SECONDS=30
# Local Terraform tools (fmt, validate, plan; never apply)
TERRAFORM_BINARY=terraform
TERRAFORM_TIMEOUT_SECONDS=300
# Terraform providers are cached here so each check does not download them again.
# Relative to the repository root; set it empty to disable.
TF_PLUGIN_CACHE_DIR=.cache/terraform-plugins
# Hierarchical Execution Engine
ORCHESTRATOR=router # router | model
ORCHESTRATOR_BUDGET=40
SPECIALIST_BUDGET=15
MAX_REVISIONS=3
MAX_ORCHESTRATOR_TURNS=100
MAX_PARALLEL_SPECIALISTS=4
CHECKPOINTER=sqlite
CHECKPOINT_DB_PATH=checkpoints.db
# Jev decision service, through the TypeSafe AI Python SDK (typesafe-sdk).
# Leave the key unset to run without it: every decision then takes its fallback.
# TYPESAFE_API_KEY=
# TYPESAFE_BASE_URL= # defaults to the SDK's endpoint
# TYPESAFE_DEFAULT_MODEL= # defaults to the SDK's model
JEV_TIMEOUT_SECONDS=5
JEV_REQUESTS_PER_SECOND=5
JEV_MAX_IN_FLIGHT=8
JEV_BUDGET_CALLS=500
JEV_BUDGET_TOKENS=1000000
JEV_ACT_THRESHOLD=0.75
JEV_CLOSE_THRESHOLD=0.15
JEV_CONFIDENCE_THRESHOLD=0.6
# Review a design's coverage with Jev before it is submitted: for each condition a
# requirement lists, which Check verifies it. Off until a full case has run with it.
JEV_COVERAGE_REVIEW=false
# How likely "no Check verifies this" must be before the condition is raised.
JEV_COVERAGE_THRESHOLD=0.6
# PostgreSQL (Execution records, and checkpoints when CHECKPOINTER=postgres)
POSTGRES_HOST=localhost
POSTGRES_PORT=5432
POSTGRES_DB=gcp_agent_db
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
# DATABASE_URL=postgresql://postgres:postgres@localhost:5432/gcp_agent_db
SQLITE_FALLBACK_DB=gcp_agent_local.db