Initial AMPB scaffold

2026-10-27 18:28:32 +01:00 · 2026-07-05 20:14:46 -04:00
commit ff287b8b4b
22 changed files with 896 additions and 0 deletions
@@ -0,0 +1,57 @@
+# Adaptive Multi-Protocol Browser
+
+> Status: draft | Updated 2026-07-05 | Applies to: AMPB contributors and operators
+
+Adaptive Multi-Protocol Browser, or AMPB, is a transport-aware browser shell. It routes
+URLs to the right network, adopts transports that are already healthy, and manages missing
+transports when configured to do so.
+
+The first fixture is Wownero across clearnet, Tor, I2P, Gemini, and Reticulum-oriented
+targets generated by AMPG. Interactive fixtures include `ai-gen-bot` and the Medusa
+multi-tenant platform.
+
+## Goals
+
+- Route URLs by protocol and address family.
+- Adopt existing Tor, I2P, Reticulum, and Gemini-capable tools when healthy.
+- Prompt on first visit before installing or starting a missing transport.
+- Manage approved transports through isolated AMPB state.
+- Keep browser profiles isolated by transport.
+- Present transport health in plain language.
+
+## Non-goals
+
+- Forking a browser engine before the orchestration model is proven.
+- Mixing clearnet, Tor, I2P, and Reticulum cookies/storage in one profile.
+- Publishing private transport state, keys, or host inventory in public docs.
+
+## Local Commands
+
+```sh
+python3 -m ampbrowser route https://wownero.org/
+python3 -m ampbrowser route http://example.b32.i2p/
+python3 -m ampbrowser route gemini://wownero.org/
+python3 -m ampbrowser inspect
+python3 -m ampbrowser plan gemini://wownero.org/
+python3 -m ampbrowser docs generate
+python3 -m ampbrowser docs generate --check
+python3 tools/docs_check.py
+python3 -m unittest discover -s tests
+```
+
+## Documentation
+
+- [Architecture](docs/architecture.md)
+- [Configuration](docs/configuration.md)
+- [Transport management](docs/transport-management.md)
+- [Test fixtures](docs/test-fixtures.md)
+- [Autodocs and drift gates](docs/autodocs.md)
+
+## Reusable checklist
+
+- [ ] Route URL to transport.
+- [ ] Inspect whether transport can be adopted.
+- [ ] Prompt before installing or starting a missing transport.
+- [ ] Use isolated profile state for each transport.
+- [ ] Spawn/manage only after a dry-run plan.
+- [ ] Keep private notes under `docs/private/`.