Skip to content

fix(g2-s7): pin SERVING_BACKEND=duckdb for single-container demo deploys#165

Merged
brownjuly2003-code merged 3 commits into
mainfrom
fix/g2-s7-demo-serving-backend
Jul 6, 2026
Merged

fix(g2-s7): pin SERVING_BACKEND=duckdb for single-container demo deploys#165
brownjuly2003-code merged 3 commits into
mainfrom
fix/g2-s7-demo-serving-backend

Conversation

@brownjuly2003-code

Copy link
Copy Markdown
Owner

What

Pins SERVING_BACKEND=duckdb in the three places the single-container demo is configured:

  • deploy/hf-space/DockerfileENV next to the other demo conventions
  • deploy/fly/fly.toml[env]
  • deploy/fly/README.md — the local docker run verify example (Dockerfile.api bakes no demo env, so the example must pass it explicitly)

Why

config/serving.yaml has defaulted to backend: clickhouse since the ADR 0006 Phase 1 cutover, and the config directory ships inside the demo image. Any demo image built from current main therefore boots the ClickHouse backend, finds no server, and dies in the API lifespan (BackendExecutionError: [Errno 111] Connection refused).

Caught live on the first three-node bring-up (G2 S7): liovina/agentflow-center built fine and hit RUNTIME_ERROR on boot. Hypothesis verified on the same Space before this commit — setting the env var flips the engine to embedded DuckDB and the node comes up healthy (/v1/health 200, duckdb_pool live). The standalone agentflow-demo Space never showed this because it still runs a pre-cutover image; its next Factory rebuild would have hit the same crash.

Verify

  • tests/unit/test_node_deploy_artifacts.py — 4 passed
  • fly.toml tomllib parse — OK
  • Live: center Space RUNNING + /v1/health 200 with the env override

🤖 Generated with Claude Code

config/serving.yaml has defaulted to ClickHouse since the ADR 0006 Phase 1
cutover, so any demo image built from current main crashes on boot
(BackendExecutionError: connection refused) — no ClickHouse runs beside the
single-container demo. Caught live on the first three-node HF Space bring-up
(liovina/agentflow-center, RUNTIME_ERROR), fix verified on the same Space:
setting the env flips the engine back to embedded DuckDB and the node boots
healthy.

Pin the backend where the demo conventions already live: ENV in
deploy/hf-space/Dockerfile, [env] in deploy/fly/fly.toml, and the local
docker-run example in deploy/fly/README.md (Dockerfile.api bakes no demo
env, so the example must pass it explicitly).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown

DORA Metrics

  • Window: last 30 days
  • Branch: main
  • Deployment frequency: 88 total / 20.53 per week
  • Lead time for changes: avg 0.45h / median 0.0h
  • Change failure rate: 59.09% (52/88)
  • MTTR: n/a across 0 incident(s)

MTTR note: No failed mainline CI runs in the selected window.

JuliaEdom and others added 2 commits July 6, 2026 18:16
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The build spec, ADR 0012, DEPLOY.md and the center Space README all claimed
the public demo-key POST to /v1/node/events gets 403. The implemented and
N2/N3-tested ladder is: role != center -> 404, no/malformed bearer -> 401
(the demo-key caller sends none, so it lands here), wrong bearer -> 403.
Caught by the first live §12 verify against the deployed center. Docs follow
the code: the tests assert 401 deliberately and the guard property (public
key can never push) is unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@brownjuly2003-code brownjuly2003-code merged commit 6146f16 into main Jul 6, 2026
19 checks passed
@brownjuly2003-code brownjuly2003-code deleted the fix/g2-s7-demo-serving-backend branch July 6, 2026 15:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants