mirror of
https://github.com/LorenEteval/Furious.git
synced 2026-10-08 06:48:09 +03:00
Loren Eteval
9c5a64acc6
Reconstruct the project operating model from source, tests, packaging, and runtime flows, then rewrite the AGENTS hierarchy around durable ownership, lifecycle, compatibility, and verification invariants. Consolidate redundant UI and backend child guides, add evidence-based self-evolution rules, and keep specialized guidance only where local constraints materially differ. Signed-off-by: Loren Eteval <loren.eteval@proton.me>
1.5 KiB
1.5 KiB
Application composition guidance
Furious.__main__andAppMainProcessown the outer process/crash boundary;DesktopApplicationowns the inner Qt composition. Keep those responsibilities separate and preserve semantic exit codes and original failure context.- Startup acquires singleton ownership before composing process-lifetime repositories, plugins, controllers, logging, host integration, UI, and optional restored connection. Register cleanup as each acquisition succeeds.
- Partial startup, normal exit, signals, and event-loop failure converge on one reverse-order, failure-isolating,
idempotent cleanup path.
exit()requests Qt termination; action/window/session handlers do not run cleanup directly. - Singleton election is atomic: serialize candidates, re-probe after waiting, recover only a confirmed stale endpoint, and fail closed when ownership is uncertain, including privilege handoff.
- Native session callbacks cross to the GUI thread before touching Qt-owned state. Tray, dock, System Proxy daemon, Flatpak/AppImage, and no-tray behavior are explicit platform capabilities.
- The application owns the top-level window/tray wrappers;
MainWindowowns the persistent page tree. Do not let dynamic menus, sockets, theme snapshots, workers, or partial startup owners outlive their registered cleanup stage. - Verify each acquisition failure, reverse/repeated cleanup, singleton races/commands, queued session shutdown, tray-present/absent close policy, restored connection, and exact child/thread-pool ownership with host effects mocked.