brief_promote
Convert a saved brief draft into a ready markdown artifact by validating and promoting it, returning local writes and a stable path.
Instructions
Promote a saved public Nogra brief draft.
Marks a draft ready, validates it, renders markdown, and returns localWrites for the promoted brief artifact.
Hosted/plugin mode should pass the inline brief payload because the customer's local `.nogra/` store is the
authority.
When to use:
- Convert a valid draft payload into a ready markdown brief artifact.
- Produce a stable promoted brief path while keeping draft JSON readable.
When NOT to use:
- In hosted/plugin mode, do not rely on server-side draft state; pass the local draft payload inline.
- Do not use this to edit a draft; use brief_save for updates.
Examples:
>>> brief_promote("brief-import-audit-2026-05-06-a1b2c3", payload={...})
{"draft": {...}, "brief": {...}, "path": ".nogra/briefs/BRIEF-import-audit-2026-05-06.md"}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payload | No | Optional inline brief payload. Required in hosted/stateless mode when promoting customer-local drafts. | |
| brief_id | No | Brief draft id to promote, normally shaped like brief-<slug>-<date>-<hex>. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||