feat(echidnabot): pinned sync from hyperpolymath/echidnabot + drift gate [mass-delete-ok] (#586)

## Summary

Owner decision (2026-10-05): standalone `hyperpolymath/echidnabot` is
canon. `bots/echidnabot/` is now a **pinned sync** of it, with a CI
drift check, instead of a hand-maintained fork.

- `bots/echidnabot/FLEET-SYNC.json` pins
`hyperpolymath/echidnabot@bf2c0ff` (upstream `main` head at time of
writing). Only the crate surface is vendored; upstream
docs/packaging/wiki stay upstream (`bots/` slots are thin, CLAUDE.md
invariant 6).
- `scripts/sync-vendored-bot.sh` (`--check` / `--sync [--rev SHA]`) +
`scripts/tests/sync-vendored-bot.sh` (21 offline assertions, planted
controls: edited file, extra file, mode change, non-canonical lock,
short/error-body rev, side-branch rev, empty include).
- `.github/workflows/vendored-bot-drift.yml`: runs on PRs, pushes to
`main`, weekly; reports how far upstream is ahead of the pin.
- Dependabot no longer watches `/bots/echidnabot`, so the copy is never
bumped independently. `dependabot.yml` converted to KYAML (D280,
non-workflow YAML). This also repairs an `ignore:` block that was
mis-nested under the github-actions `groups` key.
- `CANONICAL_SOURCE.adoc` rewritten. It lists the six fleet-only files
that the switch drops (recoverable from `8a4f983`).
`tests/webhook_e2e_test.rs` should be promoted upstream.
- `actions.lock` resynced with `gh actions-lock`. On `main`, `--no-fix`
reported an unused `codeql-action@1c5b675` entry. `codeql.yml` now names
`v4.38.2`, which is the SHA it already ran (`2892aa5`), so CodeQL
behaviour is unchanged.
- `shared-context/findings` cleanup:
  - Repointed the dangling `echidna/latest.json`.
- Dropped three byte-identical duplicate echidna scans and two zero-byte
non-marker files. The `.processed` markers are kept.
- Dropped three misfiled root `hypatia-echidnabot-*` files: an error
log, a log-prefixed partial and a bare array, all superseded by
`findings/echidnabot/`.
- `echidnabot/latest.json` is now the symlink that `submit-finding.sh`
writes.
- `scripts/enroll-hypatia-fleet.sh`: discovery now covers the star-list
layout (depth 1–3). At depth 1 it found 3 of 406 clones under
`hyper-repos/`. New `tests/enroll-discovery-test.sh` with a depth-1
planted control, wired into `e2e.yml`.

`[mass-delete-ok]`: 65 tracked files are deliberately removed, mostly
upstream-only docs/packaging dropped from the vendored slot. All of them
remain in history.

## Verification (local)

- `bash scripts/tests/sync-vendored-bot.sh` → 21 passed, 0 failed
- `bash scripts/sync-vendored-bot.sh echidnabot --check` → matches, 75
entries
- `bash tests/enroll-discovery-test.sh` → ok (incl. planted control)
- `gh actions-lock --no-fix` → clean
- `kyaml-format.sh --check .github/dependabot.yml` → clean
- `docstring-scan.sh --staged --check` → 18/18 documented

Not covered by this PR: per-repo `FLEET-ENROLLMENT.a2ml` directives live
in the target repos, and those repos' own PRs carry them.

## CI follow-ups in this PR

- `Dispatch path and outcome contracts` (required, red on `main` since
#571): the test now asserts the quarantine on the production runner and
runs the path/outcome contracts through a test-only seam copy, with
planted controls. Closes #587.
- `GSBot build, tests and dependency security` (required, red on
`main`): `bots/gsbot` rustls 0.23.40 → 0.23.45 for RUSTSEC-2026-0285;
`cargo deny ... check advisories` is clean locally.
- `governance / Validate Hypatia Baseline` and `Hypatia`: the four new
findings are in vendored upstream echidnabot code, which the drift gate
forbids editing here. They are baselined with `tracking_issue` and
`expires_at`.

## Deferred red checks (AGENTS.md §5c item 3)

- `Hypatia`: deferred to #588 (vendored echidnabot findings must be
fixed upstream; baselined here).
- `governance / Validate Hypatia Baseline`: deferred to #588.
- `scorecard / Run Scorecard PR`: deferred to #589 (pre-existing on
`main`; reconciler fails on `casket-pages.yml`, which this PR does not
touch).
- `Codeac analyze results`: deferred to #590 (pre-existing on `main`;
external service cannot analyse the repo).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

Author: hyperpolymath

.github/dependabot.yml

@@ -1,43 +1,63 @@
 # SPDX-License-Identifier: MPL-2.0
-version: 2
-updates:
-  - package-ecosystem: "github-actions"
-    directory: "/"
-    schedule:
-      interval: "daily"
-    groups:
-      actions:
-        patterns:
-          - "*"
-    open-pull-requests-limit: 2
-
-  # Rust dependencies. Keep every Cargo project in one update entry so the
-  # open-PR limit applies to the fleet as a whole, rather than once per bot.
-  # Grouping by dependency name updates a shared crate across every affected
-  # project in one PR instead of opening one PR per Cargo.lock.
-    ignore:
-      # HOLD: github/codeql-action at v4.38.0 (SHA-pinned). v4.38.1 fails
-      # GitHub workflow-startup validation estate-wide (nexia-list#100;
-      # SHA-form re-bump bypassed versions-scoped ignores - nexia-list#101).
-      # Hold until upstream clears 4.38.1 or a new release verifies green.
-      - dependency-name: "github/codeql-action"
-
-  - package-ecosystem: "cargo"
-    directories:
-      - "/robot-repo-automaton"
-      - "/shared-context"
-      - "/bots/echidnabot"
-      - "/bots/glambot"
-      - "/bots/rhodibot"
-      - "/bots/seambot"
-      - "/bots/sustainabot"
-      - "/bots/finishingbot"
-      - "/bots/accessibilitybot"
-      - "/bots/cipherbot"
-      - "/bots/panicbot"
-    schedule:
-      interval: "weekly"
-    open-pull-requests-limit: 3
-    groups:
-      fleet-dependencies:
-        group-by: dependency-name
+{
+  version: 2,
+  updates: [
+    {
+      package-ecosystem: "github-actions",
+      directory: "/",
+      schedule: {
+        interval: "daily",
+      },
+      groups: {
+        actions: {
+          patterns: [
+            "*",
+          ],
+        },
+      },
+      open-pull-requests-limit: 2,
+      ignore: [
+        # HOLD: github/codeql-action at v4.38.0 (SHA-pinned). v4.38.1 fails
+        # GitHub workflow-startup validation estate-wide (nexia-list#100;
+        # SHA-form re-bump bypassed versions-scoped ignores - nexia-list#101).
+        # Hold until upstream clears 4.38.1 or a new release verifies green.
+        {
+          dependency-name: "github/codeql-action",
+        },
+      ],
+    },
+    # Rust dependencies. Keep every Cargo project in one update entry so the
+    # open-PR limit applies to the fleet as a whole, rather than once per bot.
+    # Grouping by dependency name updates a shared crate across every affected
+    # project in one PR instead of opening one PR per Cargo.lock.
+    #
+    # /bots/echidnabot is deliberately absent: it is a pinned sync of
+    # hyperpolymath/echidnabot (bots/echidnabot/FLEET-SYNC.json). Its dependencies
+    # are bumped upstream and arrive here by a pin bump, never independently;
+    # the Vendored bot drift workflow fails on any local edit.
+    {
+      package-ecosystem: "cargo",
+      directories: [
+        "/robot-repo-automaton",
+        "/shared-context",
+        "/bots/glambot",
+        "/bots/rhodibot",
+        "/bots/seambot",
+        "/bots/sustainabot",
+        "/bots/finishingbot",
+        "/bots/accessibilitybot",
+        "/bots/cipherbot",
+        "/bots/panicbot",
+      ],
+      schedule: {
+        interval: "weekly",
+      },
+      open-pull-requests-limit: 3,
+      groups: {
+        fleet-dependencies: {
+          group-by: "dependency-name",
+        },
+      },
+    },
+  ],
+}

.github/workflows/actions.lock

@@ -15,7 +15,7 @@ workflows:
         - 'haskell-actions/setup@v2.12.1'
     '.github/workflows/codeql.yml':
         - 'actions/checkout@v7.0.1'
-        - 'github/codeql-action@1c5b675653bb5c22dbe9b12b556ec555138e09fd'
+        - 'github/codeql-action@v4.38.2'
     '.github/workflows/dogfood-gate.yml':
         - 'actions/checkout@v7.0.1'
         - 'hyperpolymath/deed-ecosystem@main'
@@ -48,7 +48,7 @@ workflows:
         - 'actions/checkout@v7.0.1'
         - 'actions/upload-artifact@v7.0.1'
         - 'dtolnay/rust-toolchain@v1'
-        - 'Swatinem/rust-cache@v2.9.2'
+        - 'swatinem/rust-cache@v2.9.2'
     '.github/workflows/push-email-notify.yml':
         - 'hyperpolymath/smtp-notify-action@v0.3.0'
     '.github/workflows/repo-integrity-guard.yml':
@@ -61,12 +61,9 @@ workflows:
         - 'hyperpolymath/standards@571cc734cd69fb846032ec77a662aa8ee4fc32cd'
     '.github/workflows/supervised-fleet-scan.yml':
         - 'actions/checkout@v7.0.1'
+    '.github/workflows/vendored-bot-drift.yml':
+        - 'actions/checkout@v7.0.1'
 dependencies:
-    'Swatinem/rust-cache@v2.9.2':
-        ref: 'v2.9.2'
-        commit: 'sha1-6323deb102c322ba6fcbdcafc7e3dddab59af2b6'
-        owner_id: 580492
-        repo_id: 298565987
     'actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9':
         ref: '55cc8345863c7cc4c66a329aec7e433d2d1c52a9'
         commit: 'sha1-55cc8345863c7cc4c66a329aec7e433d2d1c52a9'
@@ -144,36 +141,16 @@ dependencies:
         commit: 'sha1-54075bcc5e249e4758d363f27d099f55d843f124'
         owner_id: 47606891
         repo_id: 331103973
-    'github/codeql-action@b96794f015dfd88f77b49b1c93e0fa7110f94c63':
-        ref: 'b96794f015dfd88f77b49b1c93e0fa7110f94c63'
-        commit: 'sha1-b96794f015dfd88f77b49b1c93e0fa7110f94c63'
-        owner_id: 9919
-        repo_id: 259445878
-    'github/codeql-action@1c5b675653bb5c22dbe9b12b556ec555138e09fd':
-        ref: '1c5b675653bb5c22dbe9b12b556ec555138e09fd'
-        commit: 'sha1-1c5b675653bb5c22dbe9b12b556ec555138e09fd'
-        owner_id: 9919
-        repo_id: 259445878
     'github/codeql-action@cdf488f595d80d6e07e03d4674febd5ab45fa938':
         ref: 'cdf488f595d80d6e07e03d4674febd5ab45fa938'
         commit: 'sha1-cdf488f595d80d6e07e03d4674febd5ab45fa938'
         owner_id: 9919
         repo_id: 259445878
-    'github/codeql-action@v4.37.8':
-        ref: 'v4.37.8'
-        commit: 'sha1-db488ddef3bf6cb639b32c2e9a7c0a7ea8271d28'
-        owner_id: 9919
-        repo_id: 259445878
-    'github/codeql-action@v4.38.0':
-        ref: 'v4.38.0'
-        commit: 'sha1-b96794f015dfd88f77b49b1c93e0fa7110f94c63'
+    'github/codeql-action@v4.38.2':
+        ref: 'v4.38.2'
+        commit: 'sha1-2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2'
         owner_id: 9919
         repo_id: 259445878
-    'haskell-actions/setup@v2.12.0':
-        ref: 'v2.12.0'
-        commit: 'sha1-6037f33647c3f17758a2356c80fc4a53d7e0685d'
-        owner_id: 75048950
-        repo_id: 623796603
     'haskell-actions/setup@v2.12.1':
         ref: 'v2.12.1'
         commit: 'sha1-0f7370ccbc65f22514ec3e094f6601b8d61fbbf7'
@@ -221,11 +198,6 @@ dependencies:
         commit: 'sha1-2d1146689b8cda280b9bc96326124645441f03bc'
         owner_id: 67707773
         repo_id: 421101922
-    'ossf/scorecard-action@v2.4.4':
-        ref: 'v2.4.4'
-        commit: 'sha1-2d1146689b8cda280b9bc96326124645441f03bc'
-        owner_id: 67707773
-        repo_id: 421101922
     'peter-evans/repository-dispatch@v4.0.1':
         ref: 'v4.0.1'
         commit: 'sha1-28959ce8df70de7be546dd1250a005dd32156697'

.github/workflows/codeql.yml

@@ -48,12 +48,12 @@ jobs:
         uses: actions/checkout@v7.0.1
 
       - name: Initialize CodeQL
-        uses: github/codeql-action/init@2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2 # v4.38.0 (4.38.1 blocked estate-wide; nexia-list#100)
+        uses: github/codeql-action/init@v4.38.2
         with:
           languages: ${{ matrix.language }}
           build-mode: ${{ matrix.build-mode }}
 
       - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@2892aa5e19bbd11bc0cff5427e3b750a04d9e3c2 # v4.38.0 (4.38.1 blocked estate-wide; nexia-list#100)
+        uses: github/codeql-action/analyze@v4.38.2
         with:
           category: "/language:${{ matrix.language }}"

.github/workflows/e2e.yml

@@ -26,3 +26,5 @@ jobs:
         run: bash tests/e2e.sh
       - name: Verify canonical descriptile policy repair
         run: bash tests/retired-descriptile-policy-test.sh
+      - name: Verify star-list enrollment discovery
+        run: bash tests/enroll-discovery-test.sh

.github/workflows/lock-sync-gate.yml

@@ -1,3 +1,4 @@
+# This workflow is managed by gh actions-lock.
 # SPDX-License-Identifier: MPL-2.0
 name: Lock Sync Gate
 

.github/workflows/panicbot-sweep.yml

@@ -46,8 +46,6 @@ jobs:
 
       - name: Install Rust toolchain
         uses: dtolnay/rust-toolchain@v1
-        with:
-          toolchain: master
         with:
           toolchain: stable
 

.github/workflows/vendored-bot-drift.yml

@@ -0,0 +1,58 @@
+# This workflow is managed by gh actions-lock.
+# SPDX-License-Identifier: MPL-2.0
+# Vendored bot drift — bots/<bot>/ copies of standalone repositories are pinned
+# syncs, not forks. This fails when a vendored copy differs from the upstream
+# commit pinned in bots/<bot>/FLEET-SYNC.json (see scripts/sync-vendored-bot.sh
+# and bots/echidnabot/CANONICAL_SOURCE.adoc).
+name: Vendored bot drift
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: ['**']
+  schedule:
+    - cron: '17 6 * * 1'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  tool-tests:
+    name: sync-vendored-bot tests (planted controls)
+    runs-on: ubuntu-24.04
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          persist-credentials: false
+      - run: bash scripts/tests/sync-vendored-bot.sh
+
+  drift:
+    name: echidnabot pinned to hyperpolymath/echidnabot
+    runs-on: ubuntu-24.04
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v7.0.1
+        with:
+          persist-credentials: false
+      - name: Fleet copy equals pinned upstream rev
+        run: bash scripts/sync-vendored-bot.sh echidnabot --check
+      - name: Report how far upstream main is ahead of the pin (informational)
+        run: |
+          set -euo pipefail
+          lock=bots/echidnabot/FLEET-SYNC.json
+          repo="$(jq -r .repo "$lock")"
+          rev="$(jq -r .rev "$lock")"
+          branch="$(jq -r .upstream_branch "$lock")"
+          tmp="$(mktemp -d)"
+          git init -q --bare "$tmp/up.git"
+          git -C "$tmp/up.git" fetch -q --no-tags --filter=blob:none "$repo" "+refs/heads/$branch:refs/heads/$branch"
+          ahead="$(git -C "$tmp/up.git" rev-list --count "$rev..refs/heads/$branch")"
+          head="$(git -C "$tmp/up.git" rev-parse "refs/heads/$branch")"
+          if [ "$ahead" -gt 0 ]; then
+            echo "::notice::echidnabot upstream $branch is $ahead commit(s) ahead of the pin ($rev -> $head). Bump with: scripts/sync-vendored-bot.sh echidnabot --sync --rev $head"
+          else
+            echo "Pin is at upstream $branch head ($head)."
+          fi