cloudflare-project

Hub for the projects deployed on Cloudflare. Shared tools live in the hub Worker; this page is the notes board: how things connect, live status, and ideas.

Live status

Architecture

 Browser
   │
   ├── Pages sites (static): agon-agent, x-os
   ├── Workers: github-manager, claudebridge, xenarth, aura-signals, conduit
   └── Hub Worker (cf-hub)
         ├── /projects, /projects/status   registry + live health
         ├── POST /tools/:name             shared tools (hub.ping, hub.echo, projects.list)
         └── /p/:id/*                      forwards to that project's origin
  

Shared code lives in packages/shared (helpers, tool definitions, project registry). The hub bundles it. Projects adopt it by importing it once their repo is updated; the six project repos are not modified yet.

How to call the hub

curl https://cf-hub.justinsimpsad.workers.dev/projects/status
curl -X POST https://cf-hub.justinsimpsad.workers.dev/tools/hub.echo -H 'content-type: application/json' -d '{"hello":"hub"}'
curl https://cf-hub.justinsimpsad.workers.dev/p/xenarth/
  

Ideas

• Give every project one login by putting Cloudflare Access in front of the hub routes.
• Move shared state (notes, settings) into a D1 or KV binding once the token has storage permissions.
• Expose each project's own API through /p/:id/api/* so the other projects can call it.
• Add a cron Worker that pings /projects/status and records outages.

Open items

• Secrets not set yet: xenarth needs its AI and GitHub keys; aura-signals needs Supabase keys. Conduit has its admin password and master secret; provider keys are added in its UI.
• github-manager and claudebridge run as Workers (assets plus api/ routes). Their Pages sites stay up until the Workers are confirmed with a real token.
• agon-agent and x-os are still Pages builds. Confirm whether either has server code before moving it.
• The GitHub token pasted in chat, the Cloudflare API token, and the R2 keys should be rotated. An earlier GitHub token is in the git history of this repo.