adaptive-multi-protocol-gateway/docs/wownero-integration.md

# Wownero Integration

> Status: draft | Updated 2026-07-05 | Applies to: Wownero static site publishing

The Wownero integration exercises AMPG against a real public static site. The source is
the existing `wownero.org` website checked out next to this repository as
`../wownero.org-website`.

## Objective

Start with the existing clearnet site, preserve the rich web output, and generate
transport-specific variants with defaults:

- clearnet: faithful static site output.
- Tor: privacy-hardened static HTML.
- I2P: privacy-hardened static HTML.
- Gemini: text-first `.gmi` pages.
- IPFS: static output tree for gateway or pinning workflows.
- Reticulum: compact Micron `.mu` pages.

## Source Adapter

The Wownero site is a static HTML/CSS/JS tree:

- top-level pages such as `index.html`, `mining.html`, `emission.html`, and
  `wownero-wallet-generator.html`.
- local CSS, JavaScript, image, PDF, text, and icon assets.
- JavaScript-driven translation and UI behavior.
- an `onion-location` meta tag in `index.html`.

This makes `static-html` the right source adapter. Markdown migration is optional and
must not be required for AMPG adoption.

## Generated Outputs

```text
/var/www/ampg/wownero/
  clearnet/
    index.html
    css/
    js/
    img/
  tor/
    index.html
    mining.html
    emission.html
  i2p/
    index.html
    mining.html
    emission.html
  gemini/
    index.gmi
    mining.gmi
    emission.gmi
  ipfs/
    index.html
    css/
    img/
  reticulum/
    index.mu
    mining.mu
    emission.mu
```

## Renderer Behavior

### Clearnet

Copy the source tree by default, excluding VCS/editor clutter, hidden private files, and
backup artifacts.

### Tor and I2P

Use `privacy-html`:

- remove JavaScript.
- remove inline event handlers.
- remove inline styles.
- keep local CSS only when configured.
- preserve local links to PDFs, text files, and reasonably sized images.
- preserve or generate onion/I2P location metadata only when configured.

### Gemini

Use `gemtext`:

- extract page title, headings, paragraphs, lists, and links.
- emit links near the paragraph that referenced them.
- convert large media to plain download links.
- skip repeated navigation noise.

### IPFS

Use `clearnet` static output for content-addressed publishing. AMPG emits route
expectations for AMPB, but pinning and CID publication remain explicit operator actions.

### Reticulum

Use `micron`:

- prioritize short informational pages.
- omit heavy images by default.
- generate compact navigation.
- treat downloadable files as links with size hints.

## Daemon Policy

Recommended defaults:

```toml
[site.protocols.clearnet]
enabled = true
daemon_policy = "adopt"

[site.protocols.tor]
enabled = true
daemon_policy = "auto"

[site.protocols.i2p]
enabled = true
daemon_policy = "auto"

[site.protocols.gemini]
enabled = false
daemon_policy = "auto"

[site.protocols.ipfs]
enabled = false
renderer = "clearnet"
daemon_policy = "auto"

[site.protocols.reticulum]
enabled = false
daemon_policy = "auto"
```

## Acceptance Criteria

- `ampg plan` identifies the Wownero source tree and selected protocols.
- `ampg build` creates clearnet, Tor, I2P, and Gemini output without requiring Markdown.
- `ampg build` writes a fixture manifest that AMPB can check.
- `ampg preview manifest` writes loopback fixture URLs that AMPB can check before live
  transport daemons are installed or adopted.
- `ampg deploy apply --stage state --dry-run` and `--stage supervisor --dry-run` show
  approved managed-daemon files before any Wownero transport service is started.
- Tor output contains no `<script>` tags or inline event handlers.
- Generated Gemini output has readable headings, paragraphs, and links.
- Generated Micron output fits terminal-first browsing.
- `ampg plan` clearly says whether each selected daemon is adopted or managed.

## Local Commands

```sh
python3 -m ampg --config gateway.toml init site wownero --domain wownero.org --source ../wownero.org-website --preset full
python3 -m ampg --config gateway.toml deploy plan --profile vps-full
python3 -m ampg --config gateway.toml dns plan --profile vps-full
python3 -m ampg --config gateway.toml dns plan --profile vps-full --free-domain-hints
python3 -m ampg --config examples/wownero.gateway.toml plan
python3 -m ampg --config examples/wownero.gateway.toml build
python3 -m ampg --config examples/wownero.gateway.toml manifest
python3 -m ampg --config examples/wownero.gateway.toml addresses list
python3 -m ampg --config examples/wownero.gateway.toml preview endpoints
python3 -m ampg --config examples/wownero.gateway.toml preview manifest
python3 -m ampg --config examples/wownero.gateway.toml install-plan --profile mobile-i2p --write-artifacts
python3 -m ampg --config examples/wownero.gateway.toml approvals list --profile mobile-i2p
python3 -m ampg --config examples/wownero.gateway.toml approvals approve --profile mobile-i2p --all
python3 -m ampg --config examples/wownero.gateway.toml deploy apply --stage state --dry-run --profile mobile-i2p
python3 -m ampg --config examples/wownero.gateway.toml deploy apply --stage supervisor --dry-run --profile mobile-i2p
python3 -m ampg --config examples/i2p-only.gateway.toml plan
python3 -m ampg --config examples/i2p-only.gateway.toml build
```

## Reusable checklist

- [ ] Build from `../wownero.org-website` using `source.kind = "static-html"`.
- [ ] Preserve clearnet output first.
- [ ] Generate Tor `privacy-html` and verify active content is stripped.
- [ ] Add Gemini conversion fixtures.
- [ ] Add Reticulum/Micron conversion fixtures.
- [ ] Enable I2P and Reticulum daemon management only after static outputs are stable.
- [ ] Copy only reviewed Wownero daemon and supervisor artifacts before service start.