Mission Control Capability, Workflow, and Admission Map
Evidence boundary: this assessment uses the tracked Mission Control files at checked out commit d902fae . The checkout was detached from a branch, and its local origin/main ref pointed to 4700573 . Untracked review artifacts were excluded.
A focused view of boundaries, contracts, state, authority, failure paths, and tradeoffs drawn from this chapter.
Reconstruct and defend this chapter’s architecture.
Reconstruct the architecture, name each boundary, and defend the tradeoffs.
Open the source exercise
Draw the five planes and the full delivery spine. Add the production admission chain as a precondition to Attempt claim. For every transition, name the actor, authoritative record, digest or version, hard policy check, emitted evidence, failure state, recovery path, and human-only authority. Circle every place where telemetry could be mistaken for evidence or registration for promotion.
4. Tradeoffs and alternatives
Exact versioning and digest binding make runs reproducible and auditable, but increase configuration work and make drift fail closed. A lighter system could move faster for low-risk experiments, but it should label that lower assurance instead of implying equivalent production readiness.
Atomic tools improve composability and emergent problem solving. Domain tools reduce calls and variance for repeated workflows. Keep policy enforcement, credential boundaries, exact schemas, and irreversible actions deterministic; let the agent apply judgment within those boundaries.
A single authoritative control plane improves consistency but may add latency and create a critical dependency. Durable local checkpoints and reconciliation help execution survive temporary control-plane or provider ambiguity without allowing a worker to invent authoritative state.
Action parity increases product usefulness and test surface. Some actions must
remain human-only, including identity bootstrap, approval of consequential
authority, risk acceptance, merge, and other irreversible decisions. Marking an
action human-only is clearer than leaving an accidental capability gap.
5. Current Mission Control implementation
Repository and authority model
At the studied commit, Mission Control is a TypeScript and pnpm monorepo. The React/Vite application provides operator surfaces, Convex owns authoritative durable state and server-side transitions, and the Hono orchestration service hosts execution adapters and provider boundaries. Current product doctrine prioritizes an exception-first operator experience over agent activity feeds.
The repository's Software Factory documentation defines an authority order: product doctrine, accepted decisions, normative contracts, current implementation guides, plans, validation evidence, and historical material. This case study follows that order and uses code and retained evidence to bound present-tense claims.
Lifecycle map
| Factory stage | Mission Control realization at d902fae | Assessment |
|---|---|---|
| Intent | Project Constitution, immutable Mission Spec revisions, Missions, stable requirements, acceptance expectations, and source references | Implemented mechanisms; spec-driven intake is feature-gated and default off |
| Plan | Versioned Mission Plans, human approval, WorkOrder blueprints, validation assertions, and a Quality Contract projection | Implemented and system-qualified for the bounded V1 path |
| Define Agent | Agent templates/versions plus Attempt-bound hashes for the agent genome, prompt bundle, tool manifest, provider, and model | Material binding exists; not yet one universal Agent Definition record |
| Execute through Harness | Provider-neutral harness lifecycle, codex/v1, exact capability manifest, persistent-worker or remote-sandbox backend, lease, budgets, and structured result | Generic harness is production architecture; current production execution remains unconfigured |
| Apply Skills | Skill discovery, import, frontmatter validation, linting, context evaluation, and configuration scanning | Registry and quality mechanisms exist; exact skill-version binding in the execution manifest was not found |
| Evaluate | Policy V2 Verification Subjects and Plans, separate verifier Attempts, evidence and receipts, exact-currentness checks, and Quality Gate Decisions | Implemented and system-qualified; the executing harness cannot certify the candidate |
| Improve | Deterministic learning signals, clusters, improvement candidates, datasets, experiments, and submitted Mission Plans | Implemented as advisory proposal flow; no automatic promotion |
| Deliver Software | GitHub App publication boundary, PR currentness, human WorkOrder acceptance, release-gate records, deployments, activation, and production evidence | Mechanisms exist at different maturity levels; production admission packet remained blocked |
Capability map
| Capability | Current evidence | Boundary or missing proof |
|---|---|---|
| Builder surfaces | North Star and V1 strategy define Mission intake, plan review, exception queues, run inspection, review packages, and release decisions | No current repository-wide action-parity manifest or browser proof for every surface |
| Intent recognition | Mission Spec quality evaluation, clarification, decisions, and requirement identities exist | Default-off feature and bounded V1 journey; not general natural-language intent autonomy |
| Planning and decomposition | Plans release governed WorkOrder blueprints; graph workflows support explicit dependencies | Plan approval does not dispatch, and graph execution does not grant new scope |
| Agent definitions | Versioned agent records and exact agent hashes are frozen into execution | Exact skills, credentials, and all policy fields are not consolidated into one definition |
| Model gateway and routing | Model catalog, exact route identity, evidence qualification, advisory routing, guarded-auto gates, and immutable decision snapshots exist | Production catalog had zero qualified routes; Guarded Auto remained disabled |
| Context and memory | Provenance-backed retrieval, graph relationships, planning, Attempt-bound Context Packages, context evals, and configuration drift scans exist | Factory Memory is advisory and gated by phase; it cannot satisfy acceptance |
| Tools and MCP | Harness manifests freeze native tool support and permitted capabilities | The studied Codex and DeepSeek manifests declare MCP unsupported; no first-class production MCP gateway was verified |
| Skills | SKILL.md parsing, linting, registry import, eval scenarios, and local repository scanning exist | No exact skill digest/version was observed in factory-execution-manifest/v1 |
| Harness and sandbox | Generic lifecycle, normalized results, capability manifests, Sandbox Profiles, credential and teardown contracts, and local/remote backends exist | Hardened remote production use requires operator promotion and live canary proof |
| State and recovery | Tasks, immutable Attempts, leases, heartbeats, retry budgets, events, artifacts, pause/drain/kill controls, and compatibility projections exist | Ambiguous external effects still require reconciliation; old runs remain historical, not current evidence |
| Evaluation | Independent Verification Factory, criterion-linked evidence, receipts, exact-currentness, and fail-closed gates exist | A complete production outcome proof remains outside the retained admission packet |
| Feedback and learning | Signals, clusters, candidates, experiments, baseline/candidate comparison, and promotion history exist | Promotion stops at a submitted Plan and requires a different human approval |
| Policy and approvals | Server-side permissions, risk classes, policy envelopes, approval records, separation of duties, and publication permits exist | Production identities and configuration must be established legitimately; no service identity may simulate human promotion |
| Observability | Run events, traces, observations, model/token/cost fields, inspector views, and eval records exist | Diagnostic observations are not acceptance evidence; unavailable telemetry remains unknown rather than zero |
| Deployment and release | Separate PR, acceptance, release, deployment, activation, rollback, and production-evidence records exist | Current V1 proof is stronger before merge than after production outcome validation |
| Multi-tenancy | Company/workspace/repository boundaries, membership authorization, scoped records, and cross-scope tests exist | Fleet-scale and cross-organization production load are not established by repository tests |
| Adoption and versioning | Basic/intermediate/advanced presentation, feature flags, immutable versions, migration guidance, and docs exist | Presentation modes do not alter authority; broad company adoption remains a future operating proof |
Workflow 1: governed intent to review-ready change
The important property is negative authority: Plan approval does not dispatch; the harness does not verify; verification does not publish; publication does not merge; and merge does not prove the production outcome.
Workflow 2: production execution admission
The admission packet records the following operator sequence:
Canonical GitHub App installation
→ current structured workflow registration
→ exact model-route registration
→ human evidence-based route promotion
→ immutable hardened Sandbox Profile creation
→ human profile promotion
→ code scopes + agents + policy + verifiers
→ exact Factory Version creation
→ exact worker/Factory Version attestation
→ readiness assessment and activation
→ human-selected local then remote canary
→ independent verification
→ controlled publication canary
Registration never counts as qualification. Promotion grants execution-only eligibility, not routing, verification, publication, acceptance, merge, or deployment authority. Worker admission compares exact repository, Factory Version, configuration digest, harness manifest, effective configuration, model route, backend, and Sandbox Profile identity.
The local implementation qualification passed 17 composed gates. The retained production observation still found zero GitHub App installations, exact routes, promoted Sandbox Profiles, current production workflows, Factory Versions, workers, and Attempts. No production mutation or canary was fabricated. This is a strong example of honest blocking: qualified code is not the same as an operationally configured factory.
Workflow 3: failure, recovery, and reconciliation
Detect failure
→ classify policy / capability / environment / provider / execution / result
→ contain authority and preserve events
→ retry only a permitted failure class within Attempt and wall-clock budgets
→ create attributable new Attempt or reconcile ambiguous external effects
→ quarantine, drain, kill, or escalate when safe continuation is unavailable
→ independently re-evaluate the new exact candidate
The workflow contract rejects heuristic STATUS: done completion and requires
structured status for non-gate steps. Historical runs are projected read-only
as current, legacy-but-valid, malformed, incomplete, stale-schema, or genuinely
invalid. Compatibility logic does not rewrite history or invent a terminal
outcome.
Workflow 4: governed learning
Attempt, verification, review, and production observations
→ deterministic Learning Signals
→ bounded failure or opportunity clusters
→ human-reviewable Improvement Candidate
→ frozen baseline/candidate experiment
→ reviewed result
→ submitted Mission Plan
→ separate human Plan approval
→ ordinary WorkOrder and execution lifecycle
This is the practical meaning of: Learning can be autonomous. Promotion should be governed. The learning subsystem is prohibited from accepting, publishing, merging, changing an active Factory Version, or granting itself new authority.
Workflow 5: authorized action parity
Mission Control contains slice-level capability maps, including Graph Engineering mappings between UI actions, Convex capabilities, and shared state. The reusable factory workflow is:
- inventory each meaningful builder action and the state it changes;
- map it to an authenticated API or tool outcome, or mark it human-only;
- require UI and agent paths to use the same authoritative transition;
- apply the same policy, scope, idempotency, and audit rules;
- surface the result and receipt immediately to the operator; and
- test the resulting state, not merely the selected tool call.
A repository-wide parity map and drift check would make this discipline continuous rather than case-study-specific.
Curriculum maturity is not implementation proof.
This case study records scoped implementation claims. Inspect the exact evidence, commit references, gaps, and verification boundaries in the source below.
Review this chapter.
Challenge a claim, boundary, missing failure mode, unclear term, or unsupported evidence statement.
- Claim
- Boundary
- Failure
- Evidence