Pilot Plan

Project State

Project State

  • Last Updated: 2026-02-17
  • Updated By: Documentation System (Plan 7)

Overview

Pilot is a web-based AI platform monorepo (similar to ChatGPT, Claude Web) integrating OpenChamber UI with custom runtime infrastructure.

Current Phase

Transitioning from experimentation to production.

Key activities:

  • Consolidating runtime services (compute + sandbox → runtime)
  • Integrating chamber-ui into pilot/app
  • Establishing upstream tracking for openchamber/opencode

Services Status

ServiceStatusDescriptionPort
@pilot/appActiveMain web application (React + TanStack Start)14070
@pilot/gatewayActiveAPI gateway (Hono on CF Workers)14040
@pilot/chamberActiveStandalone Chamber frontend (temporary)14071
@pilot/runtimeNewUnified runtime orchestrator + TLS proxy14044-14045
@pilot/computeDeprecatedLegacy Fly.io compute runtime14050-14052
@pilot/sandboxDeprecatedLegacy CF Workers sandbox runtime14041

Migration Path

@pilot/compute ─┐
                ├──► @pilot/runtime (unified)
@pilot/sandbox ─┘

Packages Status

Core Packages (@core/)

PackageStatusDescription
@repo/aiStableAI CLI commands, .ai/ sync
@repo/baseStableDomain modeling, Zod validation
@repo/queryStableType-safe query builder (FAST/SAST)
@repo/lintStableESLint flat config
@repo/typescriptStableShared tsconfig presets
@repo/uiStableCore UI components (Base UI, shadcn)

Application Packages (@packages/)

PackageStatusDescription
@repo/chamber-uiActiveOpenChamber UI components (upstream: openchamber/packages/ui)
@repo/frontendActiveRuntimeAPIs adapters, gateway client
@repo/backendActiveHono app factory, runtime adapters
@repo/domainStableAI Platform domain models
@repo/sharedStableShared contracts, helpers

Upstream Tracking

PackageUpstreamBaselineCurrent
@repo/chamber-uiopenchamber/packages/uiv1.6.8v1.6.8 (1.6.9 available)
@repo/frontendopenchamber/packages/web (frontend)v1.6.8v1.6.8 (1.6.9 available)
@repo/backendopenchamber/packages/web (backend)v1.6.8v1.6.8 (1.6.9 available)

Demos Status

DemoStatusDescription
@pilot/demo-opencodePOCOpenCode in CF Worker sandbox
@pilot/demo-openchamberPOCOpenChamber in CF Worker sandbox
@pilot/demo-opencode-flyPOCOpenCode on Fly.io
@pilot/demo-openchamber-flyPOCOpenChamber on Fly.io
@pilot/demo-openclaw-flyPOCOpenClaw on Fly.io

Recent Completed Work

Plan 6: Frontend Integration (2026-02-17)

  • Renamed chamber-fe → frontend
  • Implemented RuntimeAPIs adapters (terminal, files, git, settings, etc.)
  • Created ChamberWrapper for embedding
  • Added /workspaces/:workspace/v2 route

Plan 5: Backend Consolidation (2026-02-16)

  • Renamed chamber-be → backend
  • Implemented RuntimeAdapter (LocalAdapter, MockAdapter)
  • Scaffolded @services/runtime with Pulumi + Caddy
  • Deprecated compute/sandbox services

Plan 4: Chamber Upstream Canonical Sync (2026-02-15)

  • Removed vendored @refs/ directory
  • Established sync workflow and manifest system
  • Baselined on openchamber v1.6.8

In-Progress Work

Plan 7: Documentation System (2026-02-17)

  • Creating structured documentation for sustainability
  • Phases: Foundation → Upstream Tracking → Product → Technical

Known Issues

  1. Chamber-UI styling conflicts - Direct integration into @pilot/app has styling conflicts; @pilot/chamber exists as temporary isolation
  2. Runtime consolidation incomplete - Codex still references @pilot/compute in some contexts
  3. 1.6.9 upgrade pending - OpenChamber 1.6.9 has breaking changes in useUIStore; upgrade deferred until documentation complete

Key Decisions Made

DecisionDateRationale
Keep @plan/ as single doc home2026-02-17Avoid ambiguity between @plan/ and @docs/
Option A (Overlay) for divergence2026-02-17Keep Pilot-specific code in designated areas
Defer 1.6.9 upgrade2026-02-17Complete documentation first for clarity
Defer @pilot/chamber rename2026-02-17Decision requires product clarity

  • Architecture: @plan/ARCHITECTURE.md
  • Onboarding: @plan/QUICKSTART.md
  • Glossary: @plan/GLOSSARY.md
  • Upstream divergence: @plan/upstream/openchamber/DIVERGENCE.md
  • Network config: NETWORK.yml