patch.moi/docs/pages/reference/packages.md
matamune 81ea91e387
Some checks failed
check / check (push) Failing after 3s
Adopt codex-flows 0.3.5 surfaces
2026-05-18 00:07:15 +00:00

2.5 KiB

title description
Packages Workspace packages in the patch.moi monorepo.

Packages

@peezy.tech/patch

The Bun service in apps/patch. It exports no public package API; its runtime entry points are src/server.ts for the service and src/cli.ts for local operator commands.

Responsibilities:

  • Poll configured feeds.
  • Normalize entries into FeedSignal records.
  • Store JSONL state.
  • Submit generic FlowEvent triggers through the patch.moi workspace backend adapter.
  • Provide the patch.moi CLI for setup, local maintenance runs, status, retry, replay, and sync.
  • Serve admin inspection, retry, and replay endpoints.

The service package does not store patch contents. Maintained patch stacks live in Git repositories operated on by local workspaces or forge runners.

@peezy.tech/patch-docs

The Tome documentation package in docs. Build it with:

bun run docs:build

Root Workspace

The repository root owns shared scripts and dev dependencies. It installs the current @peezy.tech/codex-flows package surface so repo-native workspace, flow, app-server, and backend commands are available:

bun run flow:list
bun run workspace:backend
bun run workspace:doctor
bun run workspace:tick
bun run workspace:run:harness

Those commands are operator automation around the repo. They do not replace the Patch service package or its DATA_DIR state.

Installed Flow Capabilities

External flow capabilities are installed under .codex/flows and tracked in .codex/pack-lock.json. The current install brings in the Codex release maintenance flows from the sibling ../codex-flows repository:

codex-flows pack doctor --json

openai-codex-bindings and peezy-codex-fork both match upstream.release events for openai/codex. They are installed capabilities, not patch.moi product state. patch.moi still records feed-owned flow events, workspace dispatches, and maintenance attempts under DATA_DIR.

patch.moi uses the consolidated codex-flows package surface:

Package Published version patch.moi use
@peezy.tech/codex-flows ^0.3.5 flow runtime, Bun flow helpers, workspace backend protocol/client, Actions/local flow state, CLI automation, and backend bins

patch.moi product state still belongs in the Patch service JSONL store by default. Generic flow backend state is execution/run state. It is useful for inspection and sync, but it is not the default home for feed signals, workspace dispatch records, or maintenance attempts.