# Desktop project indicator

The indicator uses a monochrome center square with four separate hard corners.
Online, offline and checking states have distinct center treatments. SVG, PNG
and multi-resolution ICO assets share a deterministic generator; package audits
check all nine assets and their dimensions.

Projects opens a submenu of established Omnius directories. Successful `init`
and interactive startup register projects in the active configuration scope.
Existing preference sentinels and Omnius-managed guidance recover older projects.
Background discovery traverses home, the working directory and an explicit
`OMNIUS_PROJECT_ROOT`, in bounded asynchronous passes. Registered projects outside
those roots remain available. Dependency/cache trees and automatic symlink
traversal are skipped; missing directories are omitted. There is no project-count
cap. Custom names and existing preference identities survive deduplication.
Initial backfill advances at 250 ms intervals with a 30 ms work budget per pass,
then stops its extra timer. Ordinary health/network polling remains at 10 seconds.

Clicking a project starts a new terminal in that directory with the current CLI,
an explicit `--repo`, and matching project-root environment. No daemon project
switch occurs. Linux launches use argument vectors. macOS and Windows plans
quote/encode paths as data. Only Linux/GNOME Terminal was tested on real hardware;
the other platforms have command-plan and escaping tests.

The pinned tray library has two demonstrated integration limits: new rows are
absent from its constructor-only click map, and its native helper ignores nested
submenu replacements. Omnius owns click IDs and recreates only the indicator when
the project catalog changes. Old helper events are ignored. Ordinary health
updates do not recreate the indicator or restart the daemon.

Verification: 48 focused catalog/init/isolation/tray tests and five icon-asset
tests passed. The actual pinned helper passed eleven desktop checks with eleven screenshots on an isolated
GTK StatusNotifier host, Xvfb and D-Bus session. Native project clicks launched
real GNOME Terminal and Omnius processes with verified directories, TTYs and
render acknowledgements. Rename/add/remove, all icon states and clean native Quit
passed. Repeated helper, health and checked-item updates retained exactly one
checkmark, with none when unchecked. On a 960-pixel display, the native menu was
230 pixels wide and its long Unicode/duplicate project submenu was 338 pixels
wide; distinct truncated labels remained clickable and launched the correct
project. No inference, model loading or daemon actions were permitted. This host is a GTK test
panel, not a GNOME Shell panel.

- [Native desktop report](evidence/tray-projects-live.json)
- [Project menu](evidence/tray-projects-menu.png)
- [Long project labels](evidence/tray-projects-long-menu.png)
- [Checked menu after repeated updates](evidence/tray-checked-menu-final.png)
- [Dark panel](evidence/tray-native-host-dark.png)
- [Light panel](evidence/tray-native-host.png)
