# Changelog

All notable changes to Overseer should be recorded in this file.

The format follows a simple release-by-release log, with the detailed long-form notes stored under `releases/notes/`.

## [0.1.4] - 2026-05-09

### Added

- **Intent-Driven Response Synthesis (V3.3.2)**: The final synthesizer now matches response detail to the user's actual question — concise for specific questions, brief for general descriptions, and full evidence only for research/analysis requests.
- **3-Tier JSON Extraction Pipeline (V3.3.1)**: Synthesizer output parsing now uses direct parse → fence stripping → object extraction, preventing internal LLM artifacts (`NEXT STEPS:`, `PLAN:`) from leaking into user-facing responses.
- **Conversational Intelligence (V3.4)**: Simple greetings and high-context follow-ups now bypass the Lattice for low-latency direct chat, while creative/conversational tasks preserve narrative framing instead of reducing to status reports.
- **Metadata-Aware History (V3.4)**: Conversation history now includes artifact filenames, cited source titles, and deserialized JSON results for richer LLM context on follow-up turns.
- **Tiered Media Perception (V3.5)**: Multimodal inputs are processed through native Rust parsers (high perf), local OCR, or a Vision Assistant depending on complexity.
- **Query-Guided Vision (V3.6)**: The user's specific query is passed to the Vision Assistant for targeted perception, with findings injected as shadow context ground-truth.
- **Grounding Decoupling (V3.7)**: Generic image descriptions are cached permanently; turn-specific guided perception is transient and never contaminates the cache, preventing contextual echo.
- **User Attachment Visibility (V3.8)**: User-sent file attachments now render inline in chat bubbles via `AttachmentPreview`, with immediate optimistic display before the database round-trip completes.


### Changed

- Synthesis pipeline overhauled: intermediate LLM synthesis is skipped for artifact-generating steps (PDFs, Excel), saving compute — the final synthesizer handles centralized delivery.
- Evidence governance now only preserves sources when the user explicitly requests citations; vision/media queries receive natural conversational answers instead of raw data-point dumps.
- Grounding enforcement uses silent delivery for operational tasks ("open the calculator", "make a PDF"), suppressing technical noise in favor of clean success messages.
- Heuristic routing guard now context-sensitively prioritizes local artifact context over broad web research when artifacts are present.
- Core engine files modularized under a strict 100-line rule; the synthesizer was refactored from monolithic to a structured module directory (`step.rs`, `final_res.rs`).

### Fixed

- User-sent file attachments were stored correctly in the database but never rendered in the `UserBubble` component; attachments now display with download capability on both user and assistant messages.
- Optimistic user messages no longer show empty attachment lists — file metadata is populated immediately from pending attachments.
- Physical Reality stalls eliminated: the grounding engine now recognizes when a domain synthesizes from existing shadow context, preventing false "stalled" triggers when no new tools are required.
- Contextual echo resolved: previous answers no longer bleed into new turns as grounding facts, thanks to the permanent/transient perception split.

## [0.1.3] - 2026-03-28

### Added

- Artifact persistence and inspection surfaces so runs can hand off screenshots, files, and outputs as first-class work objects.
- Work items with tracked status, latest result summaries, and direct execution from the workspace.
- Persistent workspace sessions for artifacts and work items instead of collapsing everything back into one chat view.
- Selector-first desktop control improvements for Windows UI Automation, including richer blocked diagnostics, app hints, toggle and expand/collapse handling, and post-action verification evidence.
- Microsoft Store publishing guidance for the packaged Windows installer flow.

### Changed

- Native desktop and machine-state requests now survive more model-backend outages by routing through local fast paths when the intent is obvious.
- README and release-facing docs now describe Overseer as a desktop-first local AI operator with artifacts, work items, and supervised desktop execution.
- Real-app phrasing like search boxes, address bars, sidebars, and toggles now maps more reliably into UIA selector actions.

### Fixed

- UIA selector misses now block with retryable diagnostics instead of vague repeated-tool or grounding failures.
- Native desktop action traces now report verification state instead of overclaiming success.
- Screenshot and local-action phrasing like `workspace`, `open discord on my pc`, and typoed screenshot prompts now hit the correct native path more consistently.

## [0.1.2] - 2026-03-25

### Added

- Native computer fast paths for screenshots, running-process inspection, local file search, browser state, file open, and file read flows.
- Inline assistant image attachments for generated desktop screenshots, rendered directly inside chat messages.

### Changed

- Screenshot requests now route through the computer operator and complete through the native desktop capture path instead of fragile UI guessing.
- Computer Control now focuses on the live operating state, pending approval, and the core session controls instead of noisy secondary details.
- Machine-state questions such as background tasks, resume/file lookup, and browser state now prefer native tool inspection before broader orchestration.

### Fixed

- Desktop screenshot replies no longer dump raw HTML/SVG-like artifact text into chat.
- Screenshot artifacts now ground correctly as successful completion evidence for screenshot tasks.
- Assistant screenshot previews now render reliably in the desktop UI instead of broken `file:///` image links.

## [0.1.1] - 2026-03-23

### Added

- Computer Control surface for session modes, allowlists, action caps, timeout control, and emergency stop handling.
- Approval-backed desktop supervision flow with pending-action staging and one-shot approval from the app.
- Saved tool test cases in the Tools Workshop with pass/fail result tracking.
- Runtime health panel in Settings for Ollama, selected models, Python, and `protoc`.

### Changed

- Chat now auto-creates a conversation on first send and shows stronger starter, routing, and failure states.
- Execution Trace now supports filtered event views, clearer event labels, and expandable raw payloads.
- Workflow automation now shows richer run summaries, better status badges, and clearer rerun controls.
- Computer and desktop tool execution now respects session state, approval mode, action limits, and session timeout policy.

### Fixed

- Follow-up replies like `continue` now stay anchored to active computer supervision sessions.
- Legacy Python tools that import `requests` now run inside the staged runtime without failing immediately.
- Desktop-action approvals now surface as explicit blocked trace events instead of vague supervisor drift.

## [0.1.0] - 2026-03-22

### Added

- Local-first desktop runtime built with Rust and Dioxus 0.7.
- Dynamic workshops for agents, tools, supervisors, and planners.
- Workflow automation with persisted runs and step history.
- Execution run and event tracing for conversations and workflows.
- Version snapshots and rollback support for agents and tools.
- Windows release packaging, install scripts, and release metadata foundation.

### Changed

- Tool runtime staging is now OS-aware and Windows-friendly.
- Python and `protoc` detection flow has been hardened for desktop development.
- Workflow execution now uses real orchestration status instead of optimistic completion.

### Fixed

- Windows `nvidia-smi` probing no longer flashes a console window.
- Startup error reporting now surfaces the actual initialization stage that failed.
- Installed builds can now resolve packaged tool scripts relative to the executable.
