App Map

Position

App Map is the OS-level capability map for Próx OS. It answers:

What capabilities exist in this OS, and how do they relate?

It belongs under /app-os because it describes the operating environment, registered apps, route groups, folders, connectors, developer tools, and future AI surfaces. It is not a personal data graph.

Current Surface

• Route: /app-os/app-map
• Package: @prox-os/os-apps/app-map
• Source: packages/apps/system-apps/src/apps/core/app-map/
• Runtime kind: os-package
• Current status: mock UI with typed topology data

The current implementation groups app-like nodes into System Core, User Apps, Connectors, Dev Tools, Founder Apps, and AI Layer clusters. Relationship rows model verbs such as opens, depends_on, shares_context_with, reads_events_from, writes_activity_to, uses_connector, exposes_docs, and future_integration.

Future Contract

The production version should read:

• shell app manifests and route groups;
• app permissions and data scopes;
• docs links and architecture metadata;
• connector status from the connector registry;
• activity-producing apps from the Activity event provider;
• AI action registry metadata once it exists.

The graph should remain readonly unless a future app contract adds explicit actions such as open app, inspect permissions, or jump to docs.

Mock Boundary

The current App Map does not run graph algorithms, inspect live windows, crawl docs, or infer dependencies. It is a high-quality static UI for validating the control-plane shape.