Metadata-Version: 2.4
Name: appecosystem-hub
Version: 0.1.0
Summary: Embedded/sidecar Hub runtime, single-host lock, capability registry, and durable offline outbox for appEcosystem
Author: Mikel Smart
License-Expression: MIT
Project-URL: Homepage, https://github.com/M1K31/appEcosystem
Project-URL: Source, https://github.com/M1K31/appEcosystem
Project-URL: Issues, https://github.com/M1K31/appEcosystem/issues
Keywords: appecosystem,service-mesh,capabilities,notifications,embedded-hub
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Requires-Dist: appecosystem-auth>=0.4.0
Requires-Dist: appecosystem-client>=0.4.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
Dynamic: license-file

# `appecosystem-hub` (`ecosystem_hub`)

App-embeddable Hub lifecycle manager, single-host lock, capability registry, and SQLite durable notification outbox for `appEcosystem`.

## Role Modes (`ECOSYSTEM_HUB_ROLE`)

- `auto` *(default)*: Discovers an existing Hub (`registry → mDNS → static`); if none responds and the device is at least Tier 1 (`>= 4 GB` RAM), acquires a single-host advisory file lock and launches a managed Hub sidecar.
- `host`: Explicitly hosts the Hub on this device (falling back to `join` if another local app already holds the single-host lock and passes `/health`).
- `join`: Joins an existing Hub when reachable; degrades gracefully to local standalone operation + durable SQLite outbox when offline.
- `off`: Pure standalone operation with zero network discovery or hosting.

