Skip to content

docs(wiki): update project wiki#563

Merged
fro-bot merged 1 commit into
mainfrom
fro-bot/wiki-update
Apr 29, 2026
Merged

docs(wiki): update project wiki#563
fro-bot merged 1 commit into
mainfrom
fro-bot/wiki-update

Conversation

@fro-bot
Copy link
Copy Markdown
Owner

@fro-bot fro-bot commented Apr 26, 2026

Summary

Weekly wiki update covering changes since the last wiki update (e59a85d).

Major changes documented

Three significant architectural changes landed since the last update:

  1. Monorepo extraction (e1b53a0) — Core logic extracted into packages/runtime/ (@fro-bot/runtime). The action imports shared types and functions from this package, enabling future surfaces (Discord gateway) to reuse the runtime.

  2. Coordination primitives (510ceb3) — New packages/runtime/src/coordination/ module with S3-backed distributed lock, heartbeat controller, and run-state primitives for cross-surface mutual exclusion.

  3. Lock acquisition phase (fbcb62a) — New phase 4 in the execution lifecycle between deduplication and acknowledge. Acquires a per-repo coordination lock via S3 conditional-put. Lock is released in cleanup's finally block.

Pages updated

All 6 canonical pages + index were updated:

  • Architecture Overview — Rewrote to document monorepo structure (packages/runtime/, apps/action/), split module map into runtime and action sections, added coordination module
  • Execution Lifecycle — Added phase 4 (Acquire Lock), renumbered phases 5–10, documented lock release in cleanup's finally block, updated sources
  • Session Persistence — Updated all source paths from src/services/ to packages/runtime/src/, updated prose references
  • Prompt Architecture — Updated sources to reflect split between runtime package (packages/runtime/src/agent/) and action-specific prompt code (src/features/agent/)
  • Setup and Configuration — Added packages/runtime/src/shared/constants.ts to sources for version pinning
  • Conventions and Patterns — Updated source paths, noted conventions apply across both action and runtime package
  • Index — Updated summary for Architecture Overview

Lint results

  • All wikilinks verified — no broken references
  • No orphan pages detected

@fro-bot fro-bot merged commit f8081d9 into main Apr 29, 2026
10 checks passed
@fro-bot fro-bot deleted the fro-bot/wiki-update branch April 29, 2026 07:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants