docs: design native Zara desktop Copilot #81

Merged

lost-rob0t merged 1 commit from research/desktop-copilot into master

2026-08-12 14:45:39 +00:00

lost-rob0t commented

2026-08-12 14:39:59 +00:00

(Migrated from github.com)

Summary

Adds the research/design baseline for a native PySide6 Zara Desktop Copilot.

The design is grounded in the current Zara runtime rather than introducing a second assistant stack. It covers the requested 25 areas, including current runtime lifecycle, Qt technology choice, quick/full Copilot UX, tray/global shortcuts, structured runtime events, context attachments, tools, Prolog, voice, plugins, Pets, persistence, security, concurrency, Linux Wayland/X11 behavior, Nix packaging, testing, migration, and dependency-ordered implementation slices.

Key decisions

standardize on the existing PySide6 stack
one canonical desktop QApplication + Zara tray
separate Quick Copilot and Full Chat windows backed by the same models
promote pet-specific runtime events into a desktop-neutral runtime event contract
preserve TurnCoordinator turn IDs/cancellation
run the assistant runtime off the Qt main thread
keep existing SQLite/TOML persistence surfaces
reuse existing runtime streaming/context roadmap rather than build desktop-only duplicates
make Pets an optional consumer of the same generic runtime events
treat current ChatGPT pet adapters as observed compatibility formats, not a guaranteed official OpenAI schema

Scope

Documentation/research only. No runtime behavior changes in this PR.

Validation

GitHub Actions is the merge gate. The repository's normal CI remains authoritative.

## Summary Adds the research/design baseline for a native PySide6 Zara Desktop Copilot. The design is grounded in the current Zara runtime rather than introducing a second assistant stack. It covers the requested 25 areas, including current runtime lifecycle, Qt technology choice, quick/full Copilot UX, tray/global shortcuts, structured runtime events, context attachments, tools, Prolog, voice, plugins, Pets, persistence, security, concurrency, Linux Wayland/X11 behavior, Nix packaging, testing, migration, and dependency-ordered implementation slices. ## Key decisions - standardize on the existing PySide6 stack - one canonical desktop `QApplication` + Zara tray - separate Quick Copilot and Full Chat windows backed by the same models - promote pet-specific runtime events into a desktop-neutral runtime event contract - preserve `TurnCoordinator` turn IDs/cancellation - run the assistant runtime off the Qt main thread - keep existing SQLite/TOML persistence surfaces - reuse existing runtime streaming/context roadmap rather than build desktop-only duplicates - make Pets an optional consumer of the same generic runtime events - treat current ChatGPT pet adapters as observed compatibility formats, not a guaranteed official OpenAI schema ## Scope Documentation/research only. No runtime behavior changes in this PR. ## Validation GitHub Actions is the merge gate. The repository's normal CI remains authoritative.