HandoffCandidateZ

const HandoffCandidateZ: ZodObject<{ activePhase: ZodNullable<ZodString>; fileName: ZodString; generatedAt: ZodNullable<ZodString>; label: ZodNullable<ZodString>; liveLoopPosition: ZodNullable<ZodString>; loopPosition: ZodNullable<ZodString>; path: ZodString; source: ZodEnum<{ local: "local"; sibling: "sibling"; }>; worktreeBranch: ZodNullable<ZodString>; worktreePath: ZodString; }, $strip>

Defined in: types/src/handoff.ts:47

A discoverable SESSION handoff doc, local or from a sibling worktree, for a future cross-worktree cadence resume picker. worktreePath/ worktreeBranch always come from a live git worktree list scan, never from the doc’s own frontmatter — a worktree can move after the doc was written, so the doc is not a reliable source for “where is this now”. liveLoopPosition is that worktree’s current state.json position, distinct from loopPosition (what the doc said at generation time).