get_release_ledger
THE tool for "did this piece ship on this channel" — reads the cross-channel Release Ledger, the queryable truth for every confirmed send (x/linkedin/instagram/facebook/threads, hub letters, Beehiiv) written by the publish rail itself at send time. Use this instead of title-matching or a markdown tracking doc when a reconciler or operator asks whether a piece released, where it released, or wants a recent-releases feed. Returns rows plus a per-piece coverage summary (which channels a piece is KNOWN to have shipped on — never a speculative claim about what's missing).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many recent releases to return, newest first (default 50, max 200). | |
| since | No | ISO timestamp lower bound — only releases at/after this time. | |
| channel | No | Filter to one channel. | |
| companyId | Yes | FreedomOS company id to act within (you must be a member). Required for company-scoped tools. | |
| piece_key | No | Filter to one piece's releases (e.g. 'output:<pipeline_outputs.id>', 'idea:<content_ideas.id>', 'hub-letter:<slug>'). | |
| released_by | No | Filter by who released it: 'agent', 'human', or 'system'. |