Flow Spec hints + deviation Findings

[0Calories]

Type: AFK · Source: PRD v1 · Stories: 6, 7, 8

What to build

The Flow Spec module: parse(text) → { goal, hints[], mode }. In Persona mode hints are soft — the Bud improvises the path from the goal and may deviate. The adapter emits milestone events (hint reached / deviated / goal achieved), and deviations from hints become discoverability Findings.

Acceptance criteria

• parse() unit-tested for goal-only and goal + step-hints inputs
• Hints are soft in Persona mode: deviating from a hint is logged, not fatal to the Run
• milestone events are emitted for hint reached / deviated; a deviation maps to a discoverability Finding with evidence
• Demo: a hinted Flow where the Bud takes a different path yields a deviation Finding in the Run Artifact

Blocked by

• Web Interaction adapter: real Bud achieves a goal on a real Target #3