UI map
Papercup ships as a Next.js app at apps/web/app/papercup/. It’s the operator’s surface — directors run autonomously, you observe and intervene.
Top-level routes
Section titled “Top-level routes”| Route | What’s there |
|---|---|
/papercup | Redirects to Directives |
/papercup/directives | Directive index — list, expand, route, status, summaries, ”+ New directive” modal |
/papercup/organization | Director control room — 5 dept tiles + charter + audit + emergency stop + per-dept auto-loop controls |
/papercup/projects | Project portfolio grouped by vertical — ”+ New project” |
/papercup/timeline | Cross-department activity feed with filters + search |
/papercup/search?q= | Deep-linkable universal search across messages / directives / projects |
/papercup/harnesses | Embedded coding harness picker |
/papercup/briefings | (Paperclip-built) Investor briefing summaries |
/papercup/documentation | These docs (iframe of apps/papercup-docs) |
Detail pages (deep-linkable)
Section titled “Detail pages (deep-linkable)”| Route | What’s there |
|---|---|
/directives/:id | Full directive view — body, status, metadata, action buttons, linked projects grid, summary log + add form, linked messages |
/projects/:slug | 7-section detail — Overview, Timeline, Build (links to harness), Capabilities, Spinouts, Campaigns, Settings (with delete Danger zone) |
/messages/:id | Single message — body, metadata, status, in-response-to, responses, comments + add form |
/harness/:slug | Smart router: department harness (inbox/outbox/director) for org-* slugs, coding harness for everything else |
Department harness (per-director)
Section titled “Department harness (per-director)”When /harness/org-{dept} resolves, you see the Department Harness Dashboard with 7 tabs:
- Inbox — pending messages with kind badge, status, click to detail
- Outbox — messages this dept emitted
- Compose — kind selector (limited to dept’s allowed
outboxKinds), multi-select recipients, project picker (required), subject, body - Decisions — decision-log.md viewer
- Charter — canonical charter markdown
- Director notes — editable textarea + Save
- Director agent — prompt resolver, role/mode selectors, ”▶ Run director” + “Show prompt only”, live result panel, recent-runs disclosure with inline expansion
Organization page widgets
Section titled “Organization page widgets”The control room at /papercup/organization includes:
- Hero with charter editor, audit log viewer, emergency stop, project portfolio link
- 5 dept tiles with mandate, message-kind chips, live counts, DepartmentControls (auto-loop toggle, interval, Run-now / Stop, scheduler countdown, stats strip)
- Workload matrix — sortable table view of pending workload across the org
Navigation
Section titled “Navigation”Nav at apps/web/components/Nav.tsx includes Papercup under the Agents group, between Meridian and Harness.
Papercup’s own tab strip (across the top of every Papercup page) lives in apps/web/app/papercup/PapercupTabs.tsx with: Directives → Organization → Projects → Timeline → Harnesses → Briefings.