brief_read
Read a public Nogra brief by ID, first checking draft JSON, then falling back to promoted markdown.
Instructions
Read a public Nogra brief by id.
Reads draft JSON first and falls back to matching promoted markdown when no draft exists.
When to use:
- Retrieve a saved or promoted public brief through tools.
- Verify the current status and path for a known brief id.
When NOT to use:
- Do not use this to list recent briefs; use recent_briefs.
- Do not use this to validate arbitrary unsaved input; use brief_validate.
Examples:
>>> brief_read("brief-import-audit-2026-05-06-a1b2c3")
{"status": "ok", "brief": {...}, "path": ".nogra/briefs/BRIEF-import-audit-2026-05-06.md"}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brief_id | Yes | Brief id to read from draft storage first, then promoted markdown fallback. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||