# almanaccode/codealmanac architecture

> Architecture diagram of the GitHub repository almanaccode/codealmanac, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/almanaccode/codealmanac
- Repository: https://github.com/almanaccode/codealmanac

## Overview

1. **Product boundary**
   - This is a **local-only Python CLI application** (`codealmanac`) for maintaining a markdown wiki inside a repository, with derived runtime state kept under `~/.codealmanac/`.
   - The committed wiki lives only under `almanac/`; the rest is generated/searchable state, run history, and local automation metadata.

2. **Top-level architecture**
   - The code is organized into a fairly strict layered split: **CLI entrypoints**, **service layer**, **workflows**, and **integrations**.
   - The CLI parses commands, the service layer owns business rules, workflows orchestrate multi-step operations, and integrations isolate external systems like Git, filesystem, transcript stores, Codex, Claude, and the local scheduler.

3. **CLI layer**
   - `src/codealmanac/cli` contains parser/dispatch/render modules for command groups such as `wiki`, `topics`, `search`, `show`, `health`, `validate`, `ingest`, `garden`, `sync`, `jobs`, `serve`, `setup`, `automation`, `update`, `doctor`, and `config`.
   - Rendering is separated from dispatch, so terminal output and command logic are not mixed. That matters for architecture diagrams because the CLI is an adapter over services rather than the place where domain rules live.

4. **Core domain and shared primitives**
   - `src/codealmanac/core` holds cross-cutting primitives like paths, slugs, text handling, error types, and small model definitions.
   - This is the “shared kernel” used by multiple services for repository identity, wiki page naming, and filesystem conventions.

5. **Wiki subsystem**
   - `src/codealmanac/services/wiki` handles page formats, frontmatter, links, topic files, templates, and path normalization.
   - It is responsible for turning markdown files plus `topics.yaml` into a coherent local wiki model, including page identity and backlink/link resolution.
   - The wiki is the core read/write artifact that the rest of the system manipulates.

6. **Indexing and read models**
   - `src/codealmanac/services/index` builds the searchable/readable projection over wiki content, with views for pages, topics, summaries, search, and health.
   - The README’s `search`, `show`, `topics`, `health`, and `validate` commands are driven from this indexed read model rather than directly from raw files.
   - This subsystem also bridges to the per-repository runtime database under `~/.codealmanac/repos/<repo-id>/index.db`.

7. **Repository and workspace selection**
   - `src/codealmanac/services/repositories` manages repository identity, root selection, and local state for registered repos.
   - The architecture supports operating on “the current repo” and, for the viewer, browsing among registered repos, but the committed wiki root remains fixed to `almanac/`.

8. **Lifecycle workflows**
   - `src/codealmanac/workflows` contains the higher-level orchestration for **build**, **garden**, **ingest**, **operations**, **run queue**, and **sync**.
   - These workflows coordinate read/write tasks, validation, mutation safety, commits, and queueing.
   - The important boundary is that workflows do the multi-step orchestration while services provide the domain operations they call.

9. **Run queue and job execution**
   - Lifecycle operations like `ingest` and `garden` are not executed inline; they create queued runs managed by `workflows/run_queue` and tracked by `services/runs`.
   - Runs have persistent records, locks, state transitions, event streams, snapshots, and worker execution support.
   - `jobs` is the user-facing view of this subsystem: it exposes run status, logs, attach/cancel behavior, and historical events.

10. **Harness/provider integration**
   - `src/codealmanac/services/harnesses` and `src/codealmanac/integrations/harnesses` encapsulate the local AI execution backends.
   - The project supports at least **Codex app-server** and **Claude Agent SDK** harnesses, each with its own adapter, event model, streaming/result handling, and failure mapping.
   - These harnesses are only used for write-capable lifecycle commands, not for read-only wiki queries.

11. **Source ingestion and sync**
   - `src/codealmanac/services/sources` plus `integrations/sources` resolve source addresses and fetch material from files, directories, Git, GitHub, web pages, and local transcripts.
   - `sync` scans local Claude/Codex transcript stores, discovers active conversations, and turns them into ordinary ingest runs.
   - This is the main inbound data flow into the wiki: external material is normalized into source requests, then folded into markdown pages.

12. **Automation and updates**
   - `src/codealmanac/services/automation` and `integrations/automation` manage scheduled local jobs such as sync, garden, and update.
   - The scheduler integration shown in the tree is `launchd`, so the automation model is local OS scheduling rather than a cloud service.
   - `update` has its own service and integration boundary for package/version checks and install actions.

13. **Setup, prompts, and local environment**
   - `src/codealmanac/services/setup` and `integrations/setup` generate local agent instructions, install guides, and unmanaged text blocks for supported runners.
   - `src/codealmanac/prompts` and `src/codealmanac/manual` provide runtime content used to guide AI behavior and document product expectations.
   - These are not just docs; they are part of the operational contract for how lifecycle runs should behave.

14. **Local viewer and static server**
   - `src/codealmanac/server` plus `services/viewer` provide the read-only local web viewer exposed by `codealmanac serve`.
   - The viewer renders pages, search, topics, backlinks, file references, and job views from local data and static assets.
   - It is intentionally separate from the mutation workflows: it reads the index and run data but does not own them.

15. **Persistence and boundaries**
   - Persistent state is split between committed wiki content in `almanac/` and runtime databases under `~/.codealmanac/` using SQLite.
   - The README and architecture docs emphasize that the tool does not stage, split, or commit changes itself; Git operations are delegated to the selected agent when auto-commit is allowed.
   - That separation is a key diagram boundary: **repo-owned content**, **local runtime state**, and **external agent execution** are distinct zones.

16. **Quality and evolution**
   - The repository includes a large `tests/` suite and extensive `docs/` architecture audits, refactor plans, and design notes.
   - Those docs are part of the system’s architecture discipline: they encode the intended boundaries around CLI, services, lifecycle, sources, harnesses, and storage.

Main entry points: [`src/codealmanac/cli/dispatch`](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/cli/dispatch) (Dispatchers), [`src/codealmanac/services/sources`](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/sources) (Sources), [`src/codealmanac/services/wiki`](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/wiki) (Wiki), [`src/codealmanac/services/runs`](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/runs) (Runs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI"]
  node_app["App<br/>entrypoint<br/>[app.py]"]
  node_cli_main["Main CLI<br/>entrypoint<br/>[main.py]"]
  node_cli_parser["Command parsers<br/>cli parser"]
  node_cli_dispatch["Dispatchers<br/>cli dispatch"]
  node_cli_render["Renderers<br/>cli render"]
end

subgraph group_services["Services"]
  node_core{{"Core kernel<br/>shared kernel"}}
  node_repo_svc["Repos"]
  node_wiki_svc["Wiki"]
  node_index_svc[("Index")]
  node_page_svc["Pages"]
  node_topics_svc["Topics"]
  node_health_svc["Health"]
  node_source_svc["Sources"]
  node_harness_svc["Harnesses"]
  node_runs_svc[("Runs")]
  node_viewer_svc["Viewer"]
end

subgraph group_workflows["Workflows"]
  node_build_wf["Build<br/>workflow"]
  node_ingest_wf["Ingest<br/>workflow"]
  node_garden_wf["Garden<br/>workflow"]
  node_ops_wf["Operations<br/>workflow"]
  node_queue_wf["Run queue<br/>workflow"]
  node_sync_wf["Sync<br/>workflow"]
end

subgraph group_integrations["Integrations"]
  node_git_int["Git probe<br/>git adapter"]
  node_fs_src["Filesystem source<br/>source adapter"]
  node_git_src["Git source<br/>source adapter"]
  node_gh_src["GitHub source<br/>source adapter"]
  node_web_src["Web source<br/>source adapter"]
  node_tx_src["Transcript source<br/>source adapter"]
  node_claude_h["Claude SDK<br/>harness adapter"]
  node_codex_h["Codex app server<br/>harness adapter"]
  node_launchd["Launchd<br/>scheduler<br/>[launchd.py]"]
  node_setup_int["Setup adapters"]
end

subgraph group_runtime["Runtime"]
  node_db[("SQLite state<br/>local store")]
  node_server["Server"]
end

node_app -->|"starts"| node_cli_main
node_cli_main -->|"parses"| node_cli_parser
node_cli_parser -->|"routes to"| node_cli_dispatch
node_cli_dispatch -->|"renders via"| node_cli_render
node_cli_dispatch -->|"selects repo"| node_repo_svc
node_cli_dispatch -->|"wiki ops"| node_wiki_svc
node_cli_dispatch -->|"read model"| node_index_svc
node_cli_dispatch -->|"topic ops"| node_topics_svc
node_cli_dispatch -->|"health checks"| node_health_svc
node_cli_dispatch -->|"source requests"| node_source_svc
node_cli_dispatch -->|"harness config"| node_harness_svc
node_cli_dispatch -->|"jobs view"| node_runs_svc
node_cli_dispatch -->|"viewer data"| node_viewer_svc
node_wiki_svc -->|"uses"| node_core
node_index_svc -->|"persists index"| node_db
node_repo_svc -->|"persists repos"| node_db
node_runs_svc -->|"persists runs"| node_db
node_build_wf -->|"refreshes"| node_index_svc
node_ingest_wf -->|"reads sources"| node_source_svc
node_ingest_wf -->|"writes wiki"| node_wiki_svc
node_garden_wf -->|"maintains"| node_wiki_svc
node_ops_wf -->|"executes"| node_harness_svc
node_ops_wf -->|"mutates"| node_wiki_svc
node_ops_wf -->|"records run"| node_runs_svc
node_queue_wf -->|"queues runs"| node_runs_svc
node_sync_wf -->|"discovers transcripts"| node_tx_src
node_sync_wf -->|"enqueues ingest"| node_queue_wf
node_viewer_svc -->|"reads index"| node_index_svc
node_viewer_svc -->|"reads runs"| node_runs_svc
node_server -->|"serves"| node_viewer_svc
node_git_int -->|"probes"| node_repo_svc
node_fs_src -->|"adapts"| node_source_svc
node_git_src -->|"adapts"| node_source_svc
node_gh_src -->|"adapts"| node_source_svc
node_web_src -->|"adapts"| node_source_svc
node_tx_src -->|"adapts"| node_source_svc
node_claude_h -->|"implements"| node_harness_svc
node_codex_h -->|"implements"| node_harness_svc
node_launchd -->|"schedules"| node_setup_int
node_setup_int -->|"setup flow"| node_cli_dispatch

click node_app "https://github.com/almanaccode/codealmanac/blob/main/src/codealmanac/app.py"
click node_cli_main "https://github.com/almanaccode/codealmanac/blob/main/src/codealmanac/cli/main.py"
click node_cli_parser "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/cli/parser"
click node_cli_dispatch "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/cli/dispatch"
click node_cli_render "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/cli/render"
click node_core "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/core"
click node_repo_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/repositories"
click node_wiki_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/wiki"
click node_index_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/index"
click node_page_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/pages"
click node_topics_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/topics"
click node_health_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/health"
click node_source_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/sources"
click node_harness_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/harnesses"
click node_runs_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/runs"
click node_viewer_svc "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/viewer"
click node_build_wf "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/build"
click node_ingest_wf "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/ingest"
click node_garden_wf "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/garden"
click node_ops_wf "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/operations"
click node_queue_wf "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/run_queue"
click node_sync_wf "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/sync"
click node_db "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/database"
click node_server "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/server"
click node_git_int "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/repositories/git"
click node_fs_src "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/filesystem"
click node_git_src "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/git"
click node_gh_src "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/github"
click node_web_src "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/web"
click node_tx_src "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/transcripts"
click node_claude_h "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/harnesses/claude"
click node_codex_h "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/harnesses/codex"
click node_launchd "https://github.com/almanaccode/codealmanac/blob/main/src/codealmanac/integrations/automation/scheduler/launchd.py"
click node_setup_int "https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/setup"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_cli_main,node_cli_parser,node_cli_dispatch,node_cli_render toneBlue
class node_core,node_repo_svc,node_wiki_svc,node_index_svc,node_page_svc,node_topics_svc,node_health_svc,node_source_svc,node_harness_svc,node_runs_svc,node_viewer_svc toneAmber
class node_build_wf,node_ingest_wf,node_garden_wf,node_ops_wf,node_queue_wf,node_sync_wf toneMint
class node_git_int,node_fs_src,node_git_src,node_gh_src,node_web_src,node_tx_src,node_claude_h,node_codex_h,node_launchd,node_setup_int toneRose
class node_db,node_server toneIndigo
```

## Components

### CLI

Command parsing, dispatch, and terminal rendering adapters

- [App](https://github.com/almanaccode/codealmanac/blob/main/src/codealmanac/app.py): entrypoint · CLI application bootstrap and wiring · `src/codealmanac/app.py`
- [Main CLI](https://github.com/almanaccode/codealmanac/blob/main/src/codealmanac/cli/main.py): entrypoint · Root command entry and top-level dispatch · `src/codealmanac/cli/main.py`
- [Command parsers](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/cli/parser): cli parser · Command-group parsing for wiki, topics, search, jobs, serve, setup, sync, and admin commands · `src/codealmanac/cli/parser`
- [Dispatchers](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/cli/dispatch): cli dispatch · Command handlers that call services and workflows · `src/codealmanac/cli/dispatch`
- [Renderers](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/cli/render): cli render · Terminal and JSON output formatting separated from dispatch · `src/codealmanac/cli/render`

### Services

Domain services and shared application logic

- [Core kernel](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/core): shared kernel · Paths, slugs, text handling, error types, and common models · `src/codealmanac/core`
- [Repos](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/repositories): service · Repository identity, root selection, and local repo state · `src/codealmanac/services/repositories`
- [Wiki](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/wiki): service · Markdown pages, frontmatter, links, topics, templates, and path normalization · `src/codealmanac/services/wiki`
- [Index](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/index): service · Searchable read model over wiki pages, topics, summaries, health, and views · `src/codealmanac/services/index`
- [Pages](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/pages): service · Page-level requests and mutations over wiki content · `src/codealmanac/services/pages`
- [Topics](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/topics): service · Topic graph, read model, and mutation logic · `src/codealmanac/services/topics`
- [Health](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/health): service · Validation and health reporting for wiki and sources · `src/codealmanac/services/health`
- [Sources](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/sources): service · Source address resolution and source request normalization · `src/codealmanac/services/sources`
- [Harnesses](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/harnesses): service · AI execution ports, events, results, and provider selection · `src/codealmanac/services/harnesses`
- [Runs](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/runs): service · Persistent run ledger, locks, records, transitions, and streaming state · `src/codealmanac/services/runs`
- [Viewer](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/services/viewer): service · Read-only viewer projections and repository scoping · `src/codealmanac/services/viewer`

### Workflows

Multi-step orchestration for lifecycle operations and run execution

- [Build](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/build): workflow · Refreshes derived wiki index and projections · `src/codealmanac/workflows/build`
- [Ingest](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/ingest): workflow · Normalizes source material into wiki mutations · `src/codealmanac/workflows/ingest`
- [Garden](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/garden): workflow · Maintenance workflow for wiki upkeep and curation · `src/codealmanac/workflows/garden`
- [Operations](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/operations): workflow · Mutation orchestration, harness execution, and commit policy · `src/codealmanac/workflows/operations`
- [Run queue](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/run_queue): workflow · Queued run creation, worker execution, and lifecycle coordination · `src/codealmanac/workflows/run_queue`
- [Sync](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/workflows/sync): workflow · Discovers transcript activity and enqueues ingest runs · `src/codealmanac/workflows/sync`

### Integrations

Adapters for filesystems, AI harnesses, scheduling, git, and external sources

- [Git probe](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/repositories/git): git adapter · Repository probing and git status integration · `src/codealmanac/integrations/repositories/git`
- [Filesystem source](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/filesystem): source adapter · Local file and directory source ingestion · `src/codealmanac/integrations/sources/filesystem`
- [Git source](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/git): source adapter · Git-based source ingestion · `src/codealmanac/integrations/sources/git`
- [GitHub source](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/github): source adapter · GitHub-based source ingestion · `src/codealmanac/integrations/sources/github`
- [Web source](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/web): source adapter · Web page fetching and normalization · `src/codealmanac/integrations/sources/web`
- [Transcript source](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/sources/transcripts): source adapter · Claude and Codex transcript discovery and reading · `src/codealmanac/integrations/sources/transcripts`
- [Claude SDK](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/harnesses/claude): harness adapter · Claude Agent SDK execution backend · `src/codealmanac/integrations/harnesses/claude`
- [Codex app server](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/harnesses/codex): harness adapter · Codex app-server execution backend · `src/codealmanac/integrations/harnesses/codex`
- [Launchd](https://github.com/almanaccode/codealmanac/blob/main/src/codealmanac/integrations/automation/scheduler/launchd.py): scheduler · Local OS scheduler integration for automation jobs · `src/codealmanac/integrations/automation/scheduler/launchd.py`
- [Setup adapters](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/integrations/setup): setup adapter · Installer instructions, managed blocks, and uninstall helpers · `src/codealmanac/integrations/setup`

### Runtime

Local databases and server/viewer runtime surfaces

- [SQLite state](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/database): local store · Per-repository runtime databases under ~/.codealmanac/repos/... · `src/codealmanac/database`
- [Server](https://github.com/almanaccode/codealmanac/tree/main/src/codealmanac/server): http server · Local viewer server and API routes for read-only browsing · `src/codealmanac/server`

## Connections

- App → Main CLI: starts · Bootstraps the CLI application
- Main CLI → Command parsers: parses · Builds the command surface
- Command parsers → Dispatchers: routes to · Maps parsed commands to handlers
- Dispatchers → Renderers: renders via · Separates output formatting from command logic
- Dispatchers → Repos: selects repo · Resolves repository context for commands
- Dispatchers → Wiki: wiki ops · Invokes wiki read/write operations
- Dispatchers → Index: read model · Drives search, show, topics, health, and validate views
- Dispatchers → Topics: topic ops · Handles topic mutation and inspection commands
- Dispatchers → Health: health checks · Runs repository and wiki diagnostics
- Dispatchers → Sources: source requests · Normalizes inbound source selection and addresses
- Dispatchers → Harnesses: harness config · Chooses execution backend for lifecycle runs
- Dispatchers → Runs: jobs view · Exposes run status, logs, and events
- Dispatchers → Viewer: viewer data · Feeds read-only viewer routes and projections
- Wiki → Core kernel: uses · Shares path, slug, text, and error primitives
- Index → SQLite state: persists index · Stores searchable projections in SQLite runtime state
- Repos → SQLite state: persists repos · Tracks registered repositories and local state
- Runs → SQLite state: persists runs · Stores ledgers, locks, snapshots, and transitions
- Build → Index: refreshes · Build workflow updates read models
- Ingest → Sources: reads sources · Resolves and fetches external material
- Ingest → Wiki: writes wiki · Folds source material into markdown pages
- Garden → Wiki: maintains · Curation and upkeep over wiki content
- Operations → Harnesses: executes · Delegates write-capable work to AI harnesses
- Operations → Wiki: mutates · Applies safe wiki mutations
- Operations → Runs: records run · Creates and updates lifecycle run state
- Run queue → Runs: queues runs · Manages queued execution and worker progression
- Sync → Transcript source: discovers transcripts · Scans local Claude and Codex transcript stores
- Sync → Run queue: enqueues ingest · Turns transcript discoveries into queued runs
- Viewer → Index: reads index · Uses projections for pages, search, topics, and health
- Viewer → Runs: reads runs · Displays job history and logs
- Server → Viewer: serves · HTTP surface over viewer projections
- Git probe → Repos: probes · Determines repository identity and git state
- Filesystem source → Sources: adapts · Filesystem source runtime
- Git source → Sources: adapts · Git source runtime
- GitHub source → Sources: adapts · GitHub source runtime
- Web source → Sources: adapts · Web source runtime
- Transcript source → Sources: adapts · Transcript source runtime
- Claude SDK → Harnesses: implements · Claude SDK backend adapter
- Codex app server → Harnesses: implements · Codex app-server backend adapter
- Launchd → Setup adapters: schedules · Installs and runs local automation jobs
- Setup adapters → Dispatchers: setup flow · Supports onboarding, install guides, and uninstall actions
