Build Log

Deployment Topology and Two Production Outages

August 21, 2026

Fixed the ghost-deploy problem (every Vercel project waking on every push), then found and fixed two real, standing production outages (Known, Hearth) while building it.

DeploymentOSVercelKnownHearthMedinaCHF

production outages fixed

systemic bug caught before rollout

apps in the topology manifest

Timeline

Start

Ghost-deploy report

Every Vercel project woke and failed after a MedinaCHF-only push

Design

Chat-reviewed architecture pass

Elaborate workspace/Turborepo design proposed, corrected to a scoped fix by the same review

Freeze

Hard diagnosis-only freeze

Zeb ordered a stop on implementation after repeated discover-patch-discover spin; full reality reconstruction required first

Known fix

Known production outage found and fixed

Root Directory pointed at repo root since at least 2026-08-16, every git-triggered deploy had failed

Canary

Real Vercel canary proved the mechanism

git rev-parse-based ignore-command executed correctly, VERCEL_GIT_PREVIOUS_SHA resolved, correct SKIP, deployment canceled

Session closed

Native Vercel Skip Unaffected Projects parked as a separate follow-up, not a blocker

What shipped

forgekit-os/config/deployment-topology.json — canonical manifest of every app's provider, Root Directory, deploymentMode (git|cli), and grep-verified watch paths

forgekit-os/scripts/vercel-affected.mjs — the ignoreCommand script; fails open (BUILD) on any uncertainty, no unsafe HEAD^ fallback in production

forgekit-os/scripts/lib/ignore-command.mjs — single canonical, cwd-independent command string shared by the writer and the auditor

forgekit-os/scripts/set-vercel-ignore-commands.mjs — writes commandForIgnoringBuildStep via the Vercel API, gated on deploymentMode='git' only

forgekit-os/scripts/deploy-audit.mjs — two-section report (config integrity vs. grep-verified consumer accuracy), --live flag cross-checks the real Vercel API

Known production outage fixed: Root Directory corrected from '.' to products/known, project-level .vercelignore added

Hearth production outage fixed: Root Directory corrected from nonexistent 'forgehome' to products/hearth, project-level .vercelignore added, deploy:hearth script's --cwd bug fixed

“I asked chat if we were circling.... one thing I want understood - Court and Nichole are at the picnic folks might be looking at the MedinaCHF, DO NOT RISK the site going down or having issues”
— Zeb, mid-session — the constraint that correctly bounded scope for the entire back half of this session