brief_validate
Validate a brief payload to check if it can be saved or promoted, returning normalized data and structured errors without persisting the input.
Instructions
Validate a public Nogra brief payload without persisting it.
Parses and normalizes the supplied payload, then runs the public brief schema checks. Invalid input is returned
as structured errors rather than raised to the caller.
When to use:
- Check whether a draft can be saved or promoted before writing it.
- Inspect the normalized public brief shape produced from markdown.
When NOT to use:
- Do not use this to persist a draft; use brief_save for writes.
- Do not use this to read stored briefs; use brief_read or recent_briefs.
Examples:
>>> brief_validate({"title": "Import audit", ...})
{"valid": true, "errors": [], "normalized": {...}}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| payload | Yes | Brief payload as markdown, JSON string, or structured object. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||