Pilot is the project manager: it owns multi-step work front to end across the KubeCoder fleet, and
the operator decides and does only what their hands must. This repository is the app. Its specs
and slices are in pvginkel/PilotAppSpecs, its deploy chart in pvginkel/PilotDeploy, and the
store environment's repository in pvginkel/PilotProjects.
Status: version 1 is being built. Its first screens are in, in the mockup's look, with a PWA's
manifest and service worker (docs/ui.md): the handle a person chooses at their first
sign-in (docs/sign-in.md), the project list, and a project's head with its
plan, its members, the auto pilot switch, which offers to answer the confirmations it would take as
it turns on, and Finish, Reopen, Archive and Bring back, a finish followed by the question whether
to archive, which Pilot's Finish and archive leaves out (docs/projects.md); under the head, its timeline, where every item
that asks one thing is answered in place, chosen and then sent, and a document inline or from its
card, with Undo, an open item folded for every member, an urgent banner, the auto pilot mark, a badge per tab and a URL per item, an item
Pilot is still working on one line until it is done, read-only under a gold strip with Stop and
take over, and which every open browser follows live (docs/timeline.md); its
work items, each a
session Pilot runs, live on the timeline with its one current line, the steps its run publishes on
a donut, a repeat round's why under its step, Stop, Resume and Close, its session log, which shows
what each turn was sent, and, once done, the debrief its stage session gave, behind the Debrief on
its line, every role's account in the full debrief behind that, and Pilot's own
background jobs, each shown on the item it follows from, one at a time per project, each a session of
the brain's, fresh but for a wait's run: the setup, the pre-ruling pass after every worker's turn,
which reads the stage session's debrief where the run gave one and may ask the worker's writer, or claim an action or research a fact for a work item of
Pilot's, the blocks held through its run, the plan's next
step after every item of Pilot's a person closes in the app, the chat carrying out a ruling it
records itself, and a wait's run, with Retry on one that failed
(docs/work.md); each
project's status as one icon on its tab, which pauses it, and the gold bar, a badge in the top bar
or a line on a phone, while the controller does not answer, Pilot updates its store or a usage
halt holds; and on the desktop the tabs that open a document, an attachment or the handbook in the
timeline's place, each project's kept in the browser, beside the side panel, always open, its width
dragged, with the project's chat and its documents (docs/documents.md); and on a phone no top bar, a home listing the
projects, a project's head in one line over the tabs at the bottom and what opens from them a view
pushed over them, the item alone from a notification's link among them, Back the browser's
(docs/projects.md); everywhere the page tinted while its connection to the
server is down (docs/ui.md). A
project starts from the plus beside the list, its definition chat alone until its first message
makes the draft, each project then at its own address, its slug once created: the chat stands in
the timeline's place while Pilot writes the draft, project.md, in the panel's Draft tab, its asks
answered in place, and Create project opens it, hands it to Pilot's setup, the brain's first
background job, and pauses it, so that its work waits for a person's resume, which a box at the
timeline's foot offers (docs/projects.md, docs/work.md). Beneath the screens are
the record's schema and the engine behind it: the block DSL, the parse gate and the merge by
ownership, the record's own writes, and the rendered timeline.json, reference.json and
plan.json (docs/engine.md); and the sync that keeps the store environment's
tree in step with the record: the /api/sync routes and pilot-sync, the Go sidecar, in each
stage's store environment, with the hooks that hold a project's write lock around each of the
brain's edits, so that each save is its session's, and tell it what the record made of
them (docs/sync.md); and the server's jobs on the KubeCoder controller: the
environments of its own Pilot creates from a work item's repository, resets before each fresh start,
stops and deletes, or the one a work item is placed in by name, and the sessions it runs there through the gate every start passes, recorded and
streamed live (docs/sessions.md); and Pilot's MCP server, handed to every
session it creates (docs/mcp.md), through which a work item's session registers the
documents it wrote and attaches what backs them: each read onto the timeline once the run ends,
written back to its file once answered, and the conversation continued as a new work item once none
is open, or resumed first by a clarification run that puts the pre-ruling pass's questions to the
writer (docs/round-trip.md); and the project's chat, in the side panel's
Chat tab, which every member watches live, Discuss quoting into it anything the project shows: a
person's message starts the brain's session in the store, sandboxed and briefed, which takes the
messages after it until it closes, after 55 quiet minutes or at Create project, Finish, Reopen and
Archive, and acts on the record through its own tools, each call's effect shown where it ran, an
answer given there reached from its block by In the chat, its chats projected for it as chat.md
(docs/chats.md); and the notifications through web push, on each browser where a
person turns them on, from their profile page or the gold bar's offer, and never while they are in
Pilot: one per member and project for what waits on them that they have not been shown, naming the
latest, and one per person, the alarms, when the controller has been unreachable for five minutes
or the week's usage halt holds the work, beside the profile's switch that turns the alarms off, the app closing
each on the device where it opens what it is about
(docs/notifications.md); and the subscription's usage limits, on work
items alone: KubeCoder's reading of the week's and the five-hour share, the halts at their limits,
each as its setting says, holding new work, asking running work to stop through a halt file, or
stopping it, the week's halt's overrule from the gold bar, and the nudge that carries a halted,
paused or walled run on once nothing holds it, with each turn's tokens and cost kept in the
database (docs/usage.md); and the store's update, one command that holds the
store's chats, conversations and jobs while the server stops them, resets the store onto PilotProjects' main,
retries the jobs it stopped and lifts the hold (docs/store-update.md);
and the brain's waits on the timeline, a card wait fired when YouTrack posts that one of its cards
entered one of its states, a timed wait at its due time, either by a person's Check now or Skip
wait, their firings batched into one run of the brain, which resumes its previous run's
conversation while the prompt cache holds and closes the wait through mark with a note
(docs/waits.md); and the projects surface, pilot-projects, a third server of
Pilot's MCP process for any session of KubeCoder's production fleet, behind one shared token: it
lists the projects, reads a project's head, its items and its files as Pilot renders them, and
starts a draft as Pilot's service user, its members the person it is for and everyone whose profile
switch joins them (docs/mcp.md), and talks to Pilot about a project: a conversation
of the calling environment's own, a brain session in the store beside the project's chat, its reply
waited on in one long poll, which the project's people read in its Conversations tab
(docs/conversations.md); and the record of the fleet's Claude Code
transcripts, their launches, prompts, calls and tool calls, which a collector publishes through a
door of its own, whole or appended as a file grows, a launch a Turn of Pilot's started placed under
its session, and a group of work done before Pilot standing as an adopted project, listed with the
archived ones (docs/collection.md).
The brain's own repository holds its map, its
rules, its four skills, and pilot.py, the script it edits a project's folder with, on the block
DSL's own package (docs/block-dsl.md); its four skills' bodies are written:
the chat's, the create skill's, the pre-ruling pass and the plan skill's modes. Each stage follows
its own KubeCoder's fleet stream, and the dev stage's testing routes make projects there too. It is
built on the ModernAppTemplate stack (Flask on PostgreSQL, React + Vite, Playwright), which CI
builds and Argo CD deploys: every green build to the dev stage at https://pilot-dev.home, and
production at https://pilot.ginbov.nl when the operator promotes it
(docs/deployment.md).