Merge branch 'main' into findings-submissions

Author: hyperpolymath

.claude/CLAUDE.md

@@ -1,21 +1,28 @@
 # SPDX-License-Identifier: MPL-2.0
 
-# CLAUDE.md - Gitbot Fleet
+# CLAUDE.md — Gitbot Fleet
 
 ## Project Overview
 
-Gitbot Fleet is the bot orchestration hub for automated repository quality enforcement across 500+ hyperpolymath repositories. It coordinates multiple bots through a shared-context system with safety-triangle-aware routing.
+Gitbot Fleet is the bot orchestration hub for automated repository
+quality enforcement across ~500 hyperpolymath repositories. It
+coordinates 11 bots through a shared-context system with safety-triangle
+-aware routing.
 
-## Architecture
+The authoritative architecture document is [`docs/ARCHITECTURE.md`](../docs/ARCHITECTURE.md).
+The repo-root `README.adoc` is the entry point for humans.
+
+## Architecture (summary — see `docs/ARCHITECTURE.md` for the full pipeline)
 
 ```
 hypatia (scanner)  →  findings JSONL  →  fleet-coordinator.sh  →  dispatch-runner.sh
-                                               ↓
+                                               │
                                     ┌──────────┼──────────┐
                                     ▼          ▼          ▼
-                               rhodibot   echidnabot  sustainabot
-                               (git ops)  (quality)   (deps)
-                                    ↓
+                               rhodibot   echidnabot  sustainabot   ... + 8 more
+                               (git ops)  (quality)   (eco/econ)
+                                    │
+                                    ▼
                         robot-repo-automaton
                         (scan → fix → commit → PR)
 ```
@@ -24,18 +31,20 @@ hypatia (scanner)  →  findings JSONL  →  fleet-coordinator.sh  →  dispatch
 
 | Component | Location | Purpose |
 |-----------|----------|---------|
-| fleet-coordinator.sh | root | Orchestrates bot dispatching |
-| dispatch-runner.sh | scripts/ | Reads JSONL manifests, executes fixes |
-| process-review-findings.sh | scripts/ | Creates GitHub issues for review-tier |
-| fix-*.sh | scripts/ | 7 fix scripts for eliminate-tier patterns |
-| shared-context/ | shared-context/ | Rust crate for inter-bot communication |
-| robot-repo-automaton/ | robot-repo-automaton/ | Rust CLI: scan, fix, PR creation |
+| `fleet-coordinator.sh` | repo root | Orchestrates bot dispatching |
+| `dispatch-runner.sh` | `scripts/` | Reads JSONL manifests, executes fixes |
+| `process-review-findings.sh` | `scripts/` | Opens GitHub issues for review-tier findings |
+| `fix-*.sh` | `scripts/` | ~50 fix scripts for eliminate-tier patterns |
+| `shared-context/` | `shared-context/` | Rust crate for inter-bot communication |
+| `robot-repo-automaton/` | `robot-repo-automaton/` | Rust CLI: scan, fix, PR creation |
 
 ## Build & Run
 
 ```bash
 # Shell scripts (no build needed)
 bash fleet-coordinator.sh --help
+just maintenance-hard-pass /absolute/path/to/repo
+just scan-supervised
 
 # Robot-repo-automaton (Rust)
 cd robot-repo-automaton
@@ -48,8 +57,8 @@ OPENSSL_NO_VENDOR=1 cargo build --release
 
 ```
 Eliminate (auto_execute >= 0.95)  →  Direct fix, no review
-Substitute (review >= 0.85)      →  proven module replacement, needs review
-Control (report < 0.85)          →  Human review required
+Substitute (review >= 0.85)       →  Proven module replacement, needs review
+Control    (report < 0.85)        →  Human review required
 ```
 
 ## Code Style
@@ -62,8 +71,20 @@ Control (report < 0.85)          →  Human review required
 
 ## Critical Invariants
 
-1. SCM files ONLY in `.machine_readable/6scm/` (never root)
-2. All shell scripts must validate untrusted input before use
-3. No hardcoded secrets — use env vars with `${VAR:-}` defaults
-4. Fix scripts must be idempotent (safe to run multiple times)
-5. Confidence thresholds gate all automated actions
+1. The seven canonical A2ML files (`STATE`, `META`, `ECOSYSTEM`,
+   `AGENTIC`, `NEUROSYM`, `PLAYBOOK`, `ANCHOR`) live directly under
+   `.machine_readable/`, per the `A2ML-REPO-TEMPLATE` in
+   `hyperpolymath/standards`. (Earlier versions of this CLAUDE.md
+   referenced a `.machine_readable/6scm/` subdir; that layout has been
+   retired.)
+2. All shell scripts validate untrusted input before use.
+3. No hardcoded secrets — use env vars with `${VAR:-}` defaults.
+4. Fix scripts must be idempotent (safe to run multiple times).
+5. Confidence thresholds gate all automated actions.
+
+## Repo health
+
+- Open PRs / issues, dated session reports, and historical status
+  snapshots: see [`docs/archive/`](../docs/archive/).
+- Component readiness (CRG grades + evidence): [`READINESS.md`](../READINESS.md).
+- Roadmap (all 11 bots): [`ROADMAP.adoc`](../ROADMAP.adoc).

.hypatia-baseline.json

@@ -208,149 +208,5 @@
     "rule_module": "cicd_rules",
     "type": "banned_language_file",
     "file": "bots/gsbot/tests/unit/test_services.py"
-  },
-  {
-    "severity": "high",
-    "rule_module": "code_safety",
-    "type": "obj_magic",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/Analysis.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "code_safety",
-    "type": "obj_magic",
-    "file": "bots/sustainabot/bot-integration/src/Analysis.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/bindings/Deno.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/Analysis.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/Deno.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/GitHubAPI.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/GitHubApp.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/Main.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/Oikos.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/Report.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/Router.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/ServerTea.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/Types.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/lib/ocaml/Webhook.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/Analysis.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/GitHubAPI.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/GitHubApp.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/Main.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/Oikos.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/Report.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/Router.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/Types.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/Webhook.res"
-  },
-  {
-    "severity": "high",
-    "rule_module": "migration_rules",
-    "type": "deprecated_api",
-    "file": "bots/sustainabot/bot-integration/src/tea/ServerTea.res"
   }
 ]