brief_save
Save a public Nogra brief draft by parsing markdown or structured input, validating it, and returning local draft writes.
Instructions
Save a public Nogra brief draft.
Parses markdown or structured input, normalizes it to the public brief schema, validates it, and returns
localWrites for the caller-owned `.nogra/` draft store. In hosted mode, this tool does not rely on persistent
server-side draft storage.
When to use:
- Create or update a caller-owned brief draft through the MCP tool interface.
- Convert a markdown brief into public structured brief JSON before promotion.
When NOT to use:
- Do not use this to mark a brief ready; use brief_promote for promotion.
- Do not use this for run updates or events; use the run/event tools for those substrates.
Examples:
>>> brief_save({"title": "Import audit", ...}, source="cli")
{"schema": "nogra.brief.v1", "releaseVersion": "v1.0.0", "briefId": "brief-...", "status": "draft", "path": ".nogra/briefs/drafts/brief-....json", ...}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | Optional source label stored in public brief metadata. | |
| payload | Yes | Brief payload as markdown, JSON string, or structured object. | |
| brief_id | No | Optional existing or explicit brief id to save as a draft. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||