# Daemon Dispatch Ledger

> Nested daemon-manual reference for append-order ledger warnings and non-repair diagnostics.

- Skill: `lingtai-ai/daemon-dispatch-ledger` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lingtai-ai/daemon-dispatch-ledger`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lingtai-ai/daemon-dispatch-ledger/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lingtai-ai (https://skillmd.com/u/lingtai-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lingtai-ai/daemon-dispatch-ledger

---


# Dispatch Ledger Diagnostics

`daemons/.dispatch-ledger.jsonl` records accepted run membership and append
order: `schema`, monotonic `sequence`, `run_id`, and informational
`created_at`. It is not lifecycle truth; read each ledger-selected
`daemon.json` for state, result, and usage. `.dispatch-recovery/` contains only
unresolved running or pending-notification markers.

## Normal operation

- A new or cutover agent may have no ledger; legacy folders are not backfilled.
- `daemon(action="list", input={})` reads the newest 1000 ledger records in
  append order. It does not sort timestamps, scan lifetime folders, or repair an
  index.
- Use exact `daemon(action="check", input={"id": "<run_id>"})` or manual
  filesystem inspection for a known legacy run. An omitted list item is not
  proof of deletion or failure.
- The owning Agent Record refreshes a bounded ledger-selected summary
  asynchronously; heartbeat/liveness does not depend on that snapshot.

## Warnings and write failures

List warnings are advisory and bounded: `dispatch_ledger_empty`,
`dispatch_ledger_invalid_record`,
`dispatch_ledger_sequence_non_monotonic`,
`dispatch_ledger_duplicate_run_id`, and
`dispatch_ledger_daemon_state_unreadable`. They include the checked scope and
never repair files.

A malformed final record is stricter than a read warning: a later acceptance
refuses before launch because the next sequence is unprovable. No runtime path
truncates, repairs, sorts, migrates, or rebuilds this ledger.