docs(sustainabot): add Green Web integration docs, fix Oikos→SustainaBot naming

Document the Hypatia green_web.ex → fleet_dispatcher → SustainaBot pipeline
in both README.adoc and ARCHITECTURE.md. Fix "Oikos Bot" naming remnants in
the GitHub App setup guide.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: hyperpolymath

bots/sustainabot/ARCHITECTURE.md

@@ -135,9 +135,26 @@ sustainabot ──────── SARIF ──────── GitHub Secur
      |       |
      |       +── shared-context ──── Cross-bot findings
      |
+     |── hypatia (green_web.ex) ──── Green Web hosting/CDN/registry checks
+     |       |                        Routes via fleet_dispatcher.ex
+     |       +── reportEcoScore ──── GraphQL mutation → eco_score findings
+     |
      +── .bot_directives/ ────────── Per-repo permission control
 ```
 
+### Hypatia Green Web Integration
+
+SustainaBot receives infrastructure-level sustainability findings from Hypatia's
+`green_web.ex` rule module via the fleet dispatch pipeline:
+
+1. **Hypatia** scans repos for hosting provider, CDN, container registry choices
+2. **fleet_dispatcher.ex** classifies Green Web findings as `:control` actions
+3. **`dispatch_to_sustainabot/1`** sends a `reportEcoScore` GraphQL mutation
+4. **SustainaBot** incorporates the infrastructure eco score and generates fix suggestions
+
+This separates concerns: Hypatia owns *detection* (scanning 500+ repos), SustainaBot
+owns *action* (PRs, badges, SARIF annotations).
+
 ## Scoring
 
 ### Health Index

bots/sustainabot/README.adoc

@@ -181,6 +181,25 @@ def is_high_energy(energy_joules: Float) -> Bool
 
 Built-in policies (in `policies/`): energy threshold, carbon budget, memory efficiency, security-sustainability correlation.
 
+=== Green Web Integration
+
+SustainaBot receives **Green Web findings** from https://github.com/hyperpolymath/hypatia[Hypatia]'s neurosymbolic scanner. Hypatia's `green_web.ex` rule module detects:
+
+* Non-green hosting providers (AWS, Vultr, GoDaddy, etc.)
+* Missing Green Web Foundation badges in README
+* Non-green CDN providers (CloudFront, StackPath)
+* Non-green container registries
+
+Hypatia routes these findings through its **fleet dispatcher** as `:control` actions, which arrive at SustainaBot via the `reportEcoScore` GraphQL mutation. SustainaBot then:
+
+1. Incorporates the hosting/infrastructure eco score into its overall `HealthIndex`
+2. Generates SARIF annotations with fix suggestions (e.g., migrate from AWS to Hetzner)
+3. Opens PRs to add Green Web Foundation badges where missing
+
+This creates a full pipeline: **Hypatia detects** → **fleet dispatcher routes** → **SustainaBot acts**.
+
+See https://api.thegreenwebfoundation.org[Green Web Foundation API] for domain verification.
+
 === Fleet Integration
 
 SustainaBot runs as a https://github.com/hyperpolymath/gitbot-fleet[gitbot-fleet] member for multi-repo orchestration:

bots/sustainabot/docs/GITHUB_APP_SETUP.md

@@ -3,7 +3,7 @@
 
 # GitHub App Setup Guide
 
-This guide explains how to create and configure a GitHub App for Oikos Bot.
+This guide explains how to create and configure a GitHub App for SustainaBot.
 
 ## Prerequisites
 
@@ -18,7 +18,7 @@ This guide explains how to create and configure a GitHub App for Oikos Bot.
 
    | Field | Value |
    |-------|-------|
-   | **GitHub App name** | Oikos Bot (or your chosen name) |
+   | **GitHub App name** | SustainaBot (or your chosen name) |
    | **Homepage URL** | Your repo URL |
    | **Webhook URL** | `https://your-domain.com/webhooks/github` |
    | **Webhook secret** | Generate a secure random string |
@@ -81,7 +81,7 @@ For production, use a secrets manager. For Kubernetes:
 apiVersion: v1
 kind: Secret
 metadata:
-  name: oikos-bot
+  name: sustainabot
 type: Opaque
 stringData:
   GITHUB_APP_ID: "123456"