Skip to content

FORK-NOTES.md

Latest commit

 

History

History
47 lines (34 loc) · 1.61 KB

FORK-NOTES.md

File metadata and controls

47 lines (34 loc) · 1.61 KB
Raw

Fork notes

control-plane is a fork of paperclipai/paperclip (MIT). The goal of the fork is a dashboard that natively understands an AI-agent fleet driven by session-orchestrator.

Fork rule: add, don't edit

To keep rebases against a fast-moving upstream cheap:

  • Add, don't edit. New features live in new files.
  • Minimal seams. Touch upstream files by at most a line or two, only at obvious mount points, and list every such edit so a rebase conflict is trivial to resolve.

Portfolio Session Board (shipped)

Reads each repo's .orchestrator/session.lock and shows which sessions are live vs. stale, per host.

  • Endpoint: GET /api/portfolio/sessions → PortfolioSnapshot
  • UI: sidebar → Portfolio, polls every few seconds
  • Config: PORTFOLIO_ROOT (default: current working directory)

New files:

  • server/src/services/portfolio-sessions.ts (+ .test.ts)
  • server/src/routes/portfolio.ts
  • ui/src/api/portfolio.ts
  • ui/src/pages/Portfolio.tsx

Upstream seams (1–2 lines each):

  • server/src/app.ts — import + api.use(portfolioRoutes())
  • ui/src/App.tsx — import + <Route path="portfolio" …>
  • ui/src/components/Sidebar.tsx — icon import + nav item

Keeping up with upstream

git fetch upstream
git rebase upstream/master   # resolve the few listed seams if they move

Roadmap ideas

  • Usage / quota view sourced from your LLM gateway.
  • Start/stop/kill-switch controls for orchestrator autopilot runs.
  • Map orchestrator wave output → run summaries.