Skip to content

Solutions

Solved problems and the lessons kept from them. Each entry links to the source document on GitHub; the documents are not rendered on this site.

Date Solution Module Type
2026-11-19 Reviewing a long fro-bot/agent pin jump: compare named paths at both tags, then measure what source cannot settle apps/gateway best_practice
2026-11-19 A CSRF token fetched before a wait expired at the quarter-hour boundary and failed Gate 5 docs/runbooks/operator-surface-acceptance-automated.md integration_issue
2026-11-10 Gate a human-only release check on a last-pass anchor and a diff trigger, not on a passive ledger docs/runbooks best_practice
2026-11-10 GitHub’s compare endpoint lists at most 300 changed files, so a path-change check must fail closed at 300 docs/runbooks integration_issue
2026-11-08 Root minimatch and katex overrides cross majors: keep ESLint Node-hosted package.json tooling_decision
2026-11-08 Size the status-history gap threshold from measured run intervals, not cadence plus slack apps/docs best_practice
2026-11-08 Upload Trivy SARIF from a reusable workflow: gate on the file, not hashFiles .github/workflows/deploy-gateway.yaml best_practice
2026-11-08 A trailing comma in .systematic.jsonc fails the scheduled Fro Bot run at the plugin gate .systematic.jsonc integration_issue
2026-11-05 Privacy terms that exist only as docs prose: a fail-closed snapshot, a review PR and fixture-pinned tests packages/shared/opencode-go architecture_pattern
2026-11-05 OpenCode Go through CLIProxyAPI: the session header, double listing, the billing_source signal and key scope apps/cliproxy integration_issue
2026-11-04 Diagram drift test: a node-keyed fact table, checked in every direction, failing on structure only apps/docs design_pattern
2026-11-04 Download one upstream data file instead of checking out upstream source: Bun test discovery ignores .gitignore apps/docs best_practice
2026-11-02 Docs site redaction gate: bypass classes closed and accepted limits apps/docs best_practice
2026-11-02 Status history in an Actions artifact: look up the newest eligible artifact, whatever its run concluded packages/cli architecture_pattern
2026-11-02 Shallow CI checkout breaks a test that needs git history: skip it and name the covering job apps/docs workflow_issue
2026-10-31 Unpruned containerd image store filled the cliproxy disk and a truncated OAuth file took Claude down apps/cliproxy integration_issue
2026-10-31 OpenCode V2 gateway rollout: deploy checks passed while every model call failed apps/gateway workflow_issue
2026-10-24 The dashboard app owns routing; Caddy only splits /operator/* from everything else apps/dashboard architecture_pattern
2026-10-20 Brokered push checked out main but anchored trusted-head-sha on the PR head .github/workflows/fro-bot.yaml integration_issue
2026-10-14 Warning-only gateway operator health probe failed on every deploy through an untrusted forwarded-header peer apps/gateway integration_issue
2026-09-12 Verify delegated findings against primary source, not against their reasoning infra workflow_issue
2026-09-02 Approval-gated GitHub Actions runs ignore cancellation requests infra workflow_issue
2026-09-01 Reusable workflow permission parity causes deploy router startup failure infra workflow_issue
2026-08-28 Brokered push on issue_comment mention runs — auth model and the silent trusted-head-sha bypass .github/workflows/fro-bot.yaml architecture_pattern
2026-08-23 npm publishing silently failed for nine days from stacked workflow-auth and expired-token causes .github/workflows/release.yaml integration_issue
2026-08-03 Use a dedicated hermetic child environment when a CLI shells out to a cloud CLI agent-storage best_practice
2026-08-03 Agent S3 IAM policy drifts from the Fro Bot Action’s object-key contract apps/agent integration_issue
2026-08-03 Egress allowlist on the credential-bearing autoheal job blocked its own health checks fro-bot integration_issue
2026-08-03 Autoheal single-report reconciliation deadlocked on an unseeded trust-anchor label fro-bot workflow_issue
2026-08-03 Dashboard deployment correctness needs replacement, audit-pin, and same-target proofs apps/dashboard workflow_issue
2026-08-03 Production deploy harnesses must preserve Linux kernel semantics and deadline behavior apps/dashboard workflow_issue
2026-07-26 Bind-mounted Caddyfile and PEM key changes not loaded on dashboard deploy (missing –force-recreate) apps/dashboard integration_issue
2026-07-02 Broker credential-lifecycle races: stale bind-mounted bundle + reconcile deleting in-flight keys on restart apps/broker integration_issue
2026-06-30 Broker first deploy: 6-hit cascade, all from prior solution docs apps/broker workflow_issue
2026-06-28 Gateway bash approval gate never fired (OpenCode default-allow); deploy code now owns the policy apps/gateway integration_issue
2026-06-28 Release pipeline flakes on changeset changelog GraphQL fetch (ERR_STREAM_PREMATURE_CLOSE) tooling workflow_issue
2026-06-25 Aggregate deploy concurrency cancels gated deploys awaiting approval infra workflow_issue
2026-06-24 Gateway operator /operator/repos returns 404 — unmounted route plus keyless legacy bindings apps/gateway integration_issue
2026-06-21 Dashboard operator-session cutover redirect loop — container cannot hairpin to its own public hostname apps/dashboard integration_issue
2026-06-20 Bundling the published CLI with bun build to reuse private workspace code packages/cli architecture_pattern
2026-06-20 Applying CLIProxyAPI config fields at deploy time via the management API apps/cliproxy architecture_pattern
2026-06-20 Claude OAuth refresh token expiry broke Anthropic-routed CLIProxyAPI requests apps/cliproxy integration_issue
2026-06-19 Provider firewall management belongs in provisioning, not the deploy hot path apps/gateway workflow_issue
2026-06-18 Docker network stale-subnet cleanup for explicit-IPAM compose networks apps/gateway integration_issue
2026-06-14 Scheduled Fro Bot runs no-op when the per-cron session grows unbounded fro-bot workflow_issue
2026-06-13 SSH status checks fail with “Too many authentication failures” when ssh-agent key order exceeds MaxAuthTries packages/cli integration_issue
2026-06-12 Docker-based MCP server fails with -32000 because OpenCode {env:} interpolation reads an empty process env opencode.jsonc integration_issue
2026-06-12 WireGuard split-tunnel blackholes when NAT masquerade hardcodes the wrong WAN interface apps/vpn integration_issue
2026-06-10 AWS Lightsail VPN first-provision and first-deploy bug cascade apps/vpn workflow_issue
2026-06-09 A healthcheck that depended on the app image: an upstream alpine to debian base migration removed wget and broke deploys apps/cliproxy workflow_issue
2026-06-04 Off-droplet Docker image build for a single-droplet deploy (CI build → GHCR push → droplet pull) apps/gateway best_practice
2026-06-04 Caddy path-scoped reverse proxy 404s its own route via directive ordering apps/gateway integration_issue
2026-06-03 Gateway mention loop stalls — layered causes (supervisor timeout, model config, permission prompts, wiped clones) apps/gateway integration_issue
2026-06-02 Gateway v0.50.0 undeployable: daemon required secrets its own compose never wired apps/gateway workflow_issue
2026-05-29 Major-version upstream upgrade playbook (probe-first, backup-anchored) apps/cliproxy best_practice
2026-05-29 Umami first deploy: 7-wave cascade caught mostly pre-merge apps/umami workflow_issue
2026-05-20 Gateway first deploy: 5-wave cascade from contract drift to NDJSON parsing apps/gateway workflow_issue
2026-04-15 Renovate-Changesets Monorepo Targeting Saga .github/workflows/renovate-changesets.yaml workflow_issue
2026-04-06 CLIProxyAPI first deploy: 4-failure cascade from lockfile to auth-dir apps/cliproxy workflow_issue
2026-04-02 Bun CI deploy with non-root user: permission fixes for rsync, backups, and postinstall apps/keeweb workflow_issue