BuildCommand Phase 1 · Flight Control
Flight Control Office
Portfolio air traffic — integrate cross-lane signals, route findings to staffed offices, and arbitrate go/no-go without executing launches.
Responsibilities
- integrate portfolio, Guardian, and dispatch signals
- maintain configurable routing directory
- coordinate launch readiness across lanes
- surface environment-limited probe constraints
- record post-flight proof lineage
- escalate blocked assignments to ALL BUILDS
Office rules
Read-only · display only
- Pulse displays; ALL BUILDS dispatches.
- No launch, deploy, merge, or publish controls on this surface.
- Guardian RED blocks protected actions until cleared.
- Environment-limited probes cannot assert FAILED or RELEASED alone.
Office routing directory
21 rules · signal → office → worker → escalation
| Signal | Source | Office | Worker | Escalation | Guardian | Priority |
|---|---|---|---|---|---|---|
portfolio.health.degraded Project health drops below READY | portfolio-snapshot.json | monitoring | Portfolio Health Director mon-portfolio-health-director | Flight Director | ANY | high |
worktree.dirty Uncommitted changes in canonical worktree | portfolio-snapshot.json | monitoring | Repository Monitor mon-repository-monitor | Trajectory Analyst | ANY | medium |
branch.drift Ahead/behind drift on tracked branch | portfolio-snapshot.json | monitoring | Repository Monitor mon-repository-monitor | Launch Coordinator | ANY | medium |
guardian.handoff YELLOW Guardian gate — protected action review | guardian-routing seed | flight-control | Guardian Liaison fc-guardian-liaison | Go/No-Go Arbiter | YELLOW | high |
guardian.handoff RED Guardian gate — launch blocked | guardian-routing seed | flight-control | Go/No-Go Arbiter fc-go-no-go-arbiter | Flight Director | RED | critical |
release.needs_guardian Release row requires Guardian clearance | releaseReadiness extras | release-readiness | Guardian Coordinator rel-guardian-coordinator | Guardian Liaison | YELLOW | high |
release.needs_audit Release blocked pending Audit evidence | releaseReadiness extras | evidence-audit | Proof Verifier ev-proof-verifier | Release Flight Officer | ANY | high |
incident.active Active health incident on a portfolio lane | portfolio-snapshot incidents | incident-response | Incident Commander ir-incident-commander | Incident Flight Controller | ANY | critical |
dispatch.inbox New assignment awaiting capability preflight | kleinhub-builder dispatch inbox | portfolio-coordination | Dispatch Coordinator pc-dispatch-coordinator | Launch Coordinator | ANY | medium |
dispatch.blocked Assignment blocked on missing capability | kleinhub-builder dispatch blocked | flight-control | Launch Coordinator fc-launch-coordinator | Flight Director | ANY | high |
build.failed Trusted build evidence reports FAILED | portfolio-snapshot health | monitoring | Build & Test Monitor mon-build-test | Incident Flight Controller | ANY | high |
probe.environment_limited Live probe cannot assert FAILED or RELEASED alone | monitoring findings | flight-control | Environment Analyst fc-environment-analyst | Telemetry Monitor | ANY | low |
approval.pending Human or guardian approval gate pending | approvalQueue extras | release-readiness | Approval Liaison rel-approval-liaison | Go/No-Go Arbiter | YELLOW | high |
connection.missing Lovable or Supabase linkage gap | portfolio-snapshot connections | monitoring | Lovable Connection Monitor mon-lovable-connection | Signal Integrator | ANY | medium |
wire.degraded A proven service wire became DEGRADED, STALE, or DOWN | Dev Workbench wire observations | monitoring | Build & Test Monitor mon-build-test | Signal Integrator | ANY | high |
wire.repair.approval_required A bounded wire repair is ready for Owner approval | Dev Workbench dev notifications | flight-control | Approval Gate Monitor fc-approval-gate-monitor | Go/No-Go Arbiter | YELLOW | high |
wire.recovered A previously unhealthy wire has fresh CONNECTED proof | Dev Workbench wire observations | flight-control | Post-Flight Recorder fc-post-flight-recorder | Signal Integrator | GREEN | low |
tower.export.ready Executive summary export available for Tower | control-tower snapshot | flight-control | Signal Integrator fc-signal-integrator | Communications Officer | GREEN | low |
publish.requested Explicit publish gate — never auto-execute | owner command / proof packet | flight-control | Release Flight Officer fc-release-flight-officer | Go/No-Go Arbiter | RED | critical |
proof.completed Assignment completion record filed | kleinhub-builder docs/proof | flight-control | Post-Flight Recorder fc-post-flight-recorder | Portfolio Coordination Office | GREEN | low |
security.finding Security posture or connection review finding | security office seed | security | Security Specialist sec-security-specialist | Guardian Liaison | YELLOW | high |
Signal sources
Read-only inputs consumed by Flight Control and Command Center
Portfolio snapshot
src-portfolio-snapshot
Origin
kleinhub-builder export pipeline
Refresh
Coordinator refresh · read-only in Pulse
Consumed by
monitoring · flight-control · command-center
Guardian handoffs
src-guardian-handoffs
Origin
guardian-routing seed
Refresh
Static until coordinator proof updates
Consumed by
flight-control · command-center
Release readiness rows
src-release-readiness
Origin
portfolio-snapshot releaseReadiness extras
Refresh
Optional snapshot field
Consumed by
release-readiness · flight-control
Approval queue
src-approval-queue
Origin
portfolio-snapshot approvalQueue extras
Refresh
Optional snapshot field
Consumed by
release-readiness · command-center
Dispatch inbox
src-dispatch-inbox
Origin
kleinhub-builder docs/dispatch/inbox
Refresh
Coordinator lane only
Consumed by
portfolio-coordination · flight-control
Dispatch blocked
src-dispatch-blocked
Origin
kleinhub-builder docs/dispatch/blocked
Refresh
Coordinator lane only
Consumed by
flight-control · portfolio-coordination
Incident registry
src-incidents
Origin
portfolio-snapshot incidents
Refresh
Snapshot-derived
Consumed by
incident-response · flight-control
Evidence records
src-evidence
Origin
portfolio-snapshot evidence
Refresh
Snapshot-derived
Consumed by
evidence-audit · flight-control
Control Tower exports
src-control-tower
Origin
control-tower snapshot modules
Refresh
Read-only display
Consumed by
flight-control · command-center
Build & test probes
src-build-test
Origin
project health fields
Refresh
Trusted evidence only
Consumed by
monitoring · flight-control
Connection health
src-connection-health
Origin
Dev Workbench /api/wires/observations + Connect drift evidence; legacy linkage fields remain supplemental
Refresh
Live read-only observation; never turns a failed probe into execution authority
Consumed by
monitoring · security · flight-control
Dev wire repair notifications
src-dev-wire-notifications
Origin
Dev Workbench /api/dev/notifications
Refresh
Read-only pending repair cards; approval remains Controller/Nexus Owner authority
Consumed by
flight-control · release-readiness · command-center
Proof packets
src-proof-packets
Origin
kleinhub-builder docs/proof
Refresh
Coordinator filing
Consumed by
evidence-audit · flight-control
Communication channel registry
Flight Control references channels for routing display — no send
All outbound attempts return blocked or needs_approval — never sent in Phase 1.
| Channel | Kind | Readiness | Direction | Guardian outbound | Owner office | Evidence |
|---|---|---|---|---|---|---|
ch-email | UNKNOWN | both | Required | Support Office | connection-readiness-2026-08-05.md — email UNKNOWN for all lanes | |
In-app notifications ch-in-app | in_app | SEEDED | outbound | No | Flight Control | Pulse MockNotice + ReadOnlyBanner surfaces |
Webhooks ch-webhook | webhook | NOT_CONFIGURED | outbound | Required | Portfolio Coordination | No webhook registry in Phase 1 |
SMS ch-sms | sms | NOT_CONFIGURED | outbound | Required | Support Office | Worksheet — SMS Later phase |
Live chat ch-chat | chat | UNKNOWN | both | Required | Support Office | support.tsx — NOT CONNECTED / UNKNOWN |
Staff directory
12 seeded Flight Control roles · officeId flight-control
| Worker | Role | Kind | Capability | Status | Assignment | Escalation |
|---|---|---|---|---|---|---|
Flight Director | Flight Director | System | seeded | Available | — (seeded, not live) | Portfolio Coordination Office |
Launch Coordinator | Launch Coordinator | System | seeded | Available | — (seeded, not live) | Flight Director |
Trajectory Analyst | Trajectory Analyst | System | seeded | Available | — (seeded, not live) | Launch Coordinator |
Signal Integrator | Signal Integrator | System | seeded | Available | — (seeded, not live) | Flight Director |
Guardian Liaison | Guardian Liaison | System | seeded | Available | — (seeded, not live) | Go/No-Go Arbiter |
Release Flight Officer | Release Flight Officer | System | seeded | Available | — (seeded, not live) | Go/No-Go Arbiter |
Incident Flight Controller | Incident Flight Controller | System | seeded | Available | — (seeded, not live) | Flight Director |
Environment Analyst | Environment Analyst | System | seeded | Available | — (seeded, not live) | Telemetry Monitor |
Communications Officer | Communications Officer | System | seeded | Available | — (seeded, not live) | Post-Flight Recorder |
Telemetry Monitor | Telemetry Monitor | System | seeded | Available | — (seeded, not live) | Signal Integrator |
Go/No-Go Arbiter | Go/No-Go Arbiter | System | seeded | Available | — (seeded, not live) | Flight Director |
Post-Flight Recorder | Post-Flight Recorder | System | seeded | Available | — (seeded, not live) | Evidence & Audit Office |