# agent_reports_publish

> Store a scheduled-routine report (daily plan, daily review, or weekly plan) about the ActuallyCare PLATFORM CODEBASE.

<!-- Source: https://docs.actuallycare.com/tools/agent-reports/agent_reports_publish -->
<!-- Last updated: 2026-10-28 -->

Store a scheduled-routine report (daily plan, daily review, or weekly plan) about the ActuallyCare PLATFORM CODEBASE.

This is platform-engineering tooling for automated routines. It has nothing to do with escrows, clients, leads, or any CRM record — never call it to answer a question about real estate data.

Publishing is idempotent on (report_type, report_date): re-publishing the same type and date CORRECTS the existing report rather than creating a second one. That is deliberate — these routines re-arm themselves on retry.

Pass the report body as markdown. It is rendered to HTML for email and web at read time, so do not send HTML.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `report_type` | enum | Yes | Which routine produced this report. · One of: `daily_plan`, `daily_review`, `weekly_plan` |
| `report_date` | string | Yes | The day the report COVERS (YYYY-MM-DD), not the time it ran. Half of the idempotency key. · Format: Date (YYYY-MM-DD) |
| `title` | string | Yes | Subject-line-worthy title, e.g. "2026-08-08 — daily review". · Max length: 500 · Min length: 1 |
| `summary_md` | string | No | One or two sentences. Used as the email preheader and the calendar event description. · Max length: 2000 |
| `body_md` | string | Yes | The full report as markdown. Do NOT send HTML. · Min length: 1 |
| `needs_attention` | array of objects | No | Structured list of items requiring a human. Empty array means nothing is blocked. · Max items: 10 |
| `needs_attention[].title` | string | Yes | Max length: 300 |
| `needs_attention[].detail` | string | No | Max length: 1000 |
| `needs_attention[].urgency` | enum | No | One of: `low`, `medium`, `high` |
| `facts` | object | No | Machine-readable findings — commit counts, PR numbers, queue depth. Free-form. |
| `generated_at` | string | No | ISO-8601 timestamp of when the ANALYSIS was performed. Defaults to now. A publish carrying an older generated_at than the stored report is dropped, so a late retry cannot overwrite a newer report. |
| `routine_id` | string | No | The scheduling trigger id (trig_...) that produced this, for provenance. · Max length: 100 |
| `git_sha_range` | string | No | Commit range the report covers, e.g. "abc1234..def5678". · Max length: 100 |

## Example prompts

- "Store a scheduled-routine report (daily plan, daily review, or weekly plan) about the ActuallyCare PLATFORM CODEBASE — just ask in plain English."

## Safety

**Creates data.** Creates a new record in your CRM and may trigger notifications or webhooks. Running it twice creates a duplicate, so Claude runs it once per request.
