patch.moi/docs/pages/index.md

title	description
patch.moi	Feed watching and flow dispatch for upstream project events.

patch.moi

Patch is a small Bun service that watches upstream Atom/RSS feeds and turns selected upstream activity into durable Patch records, Discord notifications, or generic codex-flow events.

The service keeps the product boundary narrow:

• Feeds describe upstream repositories and events.
• Patch normalizes feed entries into FeedSignal records.
• Targets decide whether a signal is notification-only, a legacy fork-sync job, or a generic flow dispatch.
• Flow dispatch uses @peezy.tech/flow-runtime/client so Patch can run flows locally during development or send events to an HTTP backend in service mode.
• Admin endpoints inspect stored flow events and dispatch records, then retry or replay events when an upstream automation needs another attempt.

flowchart LR
  Feed["Atom or RSS feed"] --> Patch["Patch poller"]
  Patch --> Signal["FeedSignal JSONL"]
  Signal --> Notify["Discord output"]
  Signal --> Job["fork_sync job JSONL"]
  Signal --> Event["FlowEvent JSONL"]
  Event --> Client["flow-runtime client"]
  Client --> Local["local flow execution"]
  Client --> Backend["HTTP flow backend"]

Start here

• New service setup: Watch an upstream release.
• Codex release automation: Dispatch a Codex release flow.
• Running the service: Run Patch locally.
• Exact feed shape: Feed sources.
• Admin operations: HTTP API.

What is in this repo

• apps/patch: the Patch Bun service, feed poller, JSONL store, Discord output, and flow dispatch adapter.
• docs: this Tome documentation site, organized with the Diataxis framework.
• Dockerfile: container image for the Patch service app.