Skip to content
Shepherd

parseRecapVerdict

parseRecapVerdict(raw): { blocks: VisualBlock[]; body: string; headline: string; openItems: string[]; verdict: RecapVerdict; } | null

Defined in: src/recap-core.ts:47

Parse + validate the raw .shepherd-recap.json the spawn wrote. Returns null when the shape is invalid (caller fails closed). Clamps headline to RECAP_HEADLINE_MAX, coerces openItems to a string[] (drops non-strings), requires verdict ∈ RECAP_VERDICTS (normalized). Unwraps a prose-wrapped array (see unwrapRecapObject) so a chatty agent doesn’t fail the recap. blocks is additive — parsed tolerantly via parseVisualBlocks ([] on missing/garbage).

Parameters

Section titled “Parameters”

raw

Section titled “raw”

unknown

Returns

Section titled “Returns”

{ blocks: VisualBlock[]; body: string; headline: string; openItems: string[]; verdict: RecapVerdict; } | null