AgentHandover Files

The biggest Skill-quality jump since v0.2.0. Eight fixes targeting silent data losses between the VLM, the saved procedure JSON, and the app UI — every one of which left users looking at procedures that were a fraction of what the model had actually produced.

What changed

Step descriptions are now saved AND rendered. Gemma 4 e4b emits a description field on every step (verified 19/19 on the dailynews validation run). Two separate bugs were dropping it: procedure_schema.sop_template_to_procedure() was silently dropping it on the way to JSON, AND SOPDetailView.swift rendered description as a ??-fallback for action so it never appeared on screen even when the JSON was right. Both gaps closed. The Swift step card now shows action (semibold) + description (dim) + → target (monospaced) + Input: + ✓ verify lines, all conditional. Old v0.2.x procedures look the same as before.

Behavioral synthesis fails loud. Empty-insights returns from the VLM now raise EmptyInsightsError, retry once, and only stamp last_synthesized when the extraction was substantive — instead of silently leaving procedures with empty behavioral fields.

Voice profile reads real user-authored text. Style analyzer now reads from clipboard events, step inputs/descriptions, and content samples — not only the late-populated extracted_evidence.content_produced which was empty for most fresh sessions. Min combined text 50 → 30 chars.

Q&A no longer corrupts procedures. Removed _merge_credentials() and _merge_decision() — free-text answers were being auto-merged into structured accounts / branches / decision fields, overwriting clean data with prose. FocusQuestion now carries a step_indexes field; clarifications rewrite the specific steps they cover, in place.

Variables wired into step text. Declared variables with concrete examples are now post-substituted into step text and parameters as {{varname}} templates. Skips generic example values (yes/no/true/false).

Brace double-wrap fix. {{{{var}}suffix}} (Gemma occasionally double-wraps an already-templated reference) is now collapsed to {{var}}suffix. Caught in the wild as target: '{{{{bohemia}}.io}}'.

Schemas tightened. FOCUS_SOP_PROMPT, PASSIVE_SOP_PROMPT, and ENRICHED_PASSIVE_PROMPT now require description and verify per step. Coherence-check rule refined so intermediate actions aren't dropped as "unused later".

Tests

3026/3026 Python tests pass. New regression test test_write_preserves_step_description locks the procedure_schema fix.

End-to-end validation on the dailynews focus session: 19/19 steps with rich descriptions and verifies, 0 brace bugs, 0 Q&A corruption, behavioral synthesis confidence 0.81 with retries=0.

Install

• Direct download: AgentHandover-0.3.0.pkg (signed + notarized + stapled)
• Homebrew: brew install --cask sandroandric/agenthandover/agenthandover
• Sparkle auto-update: v0.2.x users will be prompted on next check.

SHA-256: 20de3341f76d2bf6e2b69048dcf7bbf636370082300df979a502bf5245ce652e

Thanks

To the v0.2.x users who recorded long focus sessions and showed where Skill quality fell short — the dailynews / domain-leads / X-email recordings drove every fix in this release.