Skip to content

docs(hive): Spindle Hive layout, per-hive GitHub Apps, Bitwarden recovery items - #359

Closed
hanthor wants to merge 6 commits into
masterfrom
docs/hive-spindle-apps-recovery
Closed

hanthor wants to merge 6 commits into
masterfrom
docs/hive-spindle-apps-recovery

Conversation

@hanthor

@hanthor hanthor commented Oct 30, 2026 •

Copy link
Copy Markdown
Owner

Documents the current Spindle Hive deployment after 2026-10-30:

  • docs/src/cluster/hive.md: running fork build (compose.override.yaml), /srv/hives layout, which config layer wins, the two GitHub Apps (School: hanthor-hive-agent, Reef: tuna-reef-hive) with App/installation IDs, additional_bot_logins on the 6 shared repos, key restore and a budget check.
  • docs/src/bitwarden.md: new Recovery items table for hive-github-app-hanthor-hive-agent, hive-github-app-tuna-reef-hive and hive-spindle-env (created and verified against the host; no role reads them).
  • docs/src/servers/spindle-vps/README.md: points to the Hive section.

Docs only; no secrets in the diff.

Verified Matrix pilot

The Spindle runbook now also records the deployed Reef/School Matrix pilot (637bae44f), matching Node-served dashboard HTML, immutable pins, rollback snapshot stamps and the short-repository-name admission fix. Hub remains unchanged.

Actual browser playback was verified across Rain, Cascade, Ghost and Terminal; P-key pause/resume worked. Both feeds held 1,200 accepted lines, samples matched real public PR additions after whitespace trimming, and anonymous requests remained 401. Current Apps poll; this is buffered PR-patch playback, not live editor keystrokes. Existing rolling-buffer limits and cold-start/quota delays are documented. Larger-window/replay controls remain design feedback, not delivered settings.

Source and verification: tuna-os/hive#172 . Fleet ledger: tuna-os/hive#173 . Existing Bitwarden records are unchanged; no new credentials were needed, and disposable local configuration copies were removed.

…arden recovery items

School and Reef now use separate GitHub Apps (hanthor-hive-agent, tuna-reef-hive). Document where the IDs and keys live on Spindle, the cross-registered bot logins, the running fork build, and the three Bitwarden secure notes that hold the App keys and /srv/hives/.env.
Signed-off-by: James Reilly <jreilly1821@gmail.com>
Signed-off-by: James Reilly <jreilly1821@gmail.com>
Signed-off-by: James Reilly <jreilly1821@gmail.com>
Signed-off-by: James Reilly <jreilly1821@gmail.com>
Signed-off-by: James Reilly <jreilly1821@gmail.com>
@hanthor

hanthor commented Nov 18, 2026

Copy link
Copy Markdown
Owner Author

Folded into #387: the GitHub Apps section (in cluster/hive.md) and the Bitwarden recovery items (in bitwarden.md), with paths updated for the move to bihar. The Spindle layout and the code-activity pilot sections are superseded: the hives left spindle on 2026-11-18, and the fork dropped the code-activity diffs on 2026-11-13. Closed during the 2026-11-18 cleanup; the branch is kept.

@hanthor hanthor closed this Nov 18, 2026
hanthor added a commit that referenced this pull request Nov 18, 2026
… updated for bihar

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
hanthor added a commit that referenced this pull request Nov 18, 2026
…rchive Talos (#387)

* docs: document the live fleet, add hive failover and home k3s kits, archive Talos

Bring the handbook and repo in line with the fleet as of 2026-11-18:

- Add docs/src/fleet.md: every tailnet host as live, intermittent or
  retired, plus a list of offline tagged nodes to remove.
- Add host pages for bihar and karnataka (Bluefin + k3s, no longer Talos),
  a home k3s + KubeStellar page, and a hives hosting/failover runbook.
- Add hives/: the failover lease scripts (hive-failover on spindle;
  hive-reconcile and hive-sync on the hosts), compose host layers and
  systemd units, byte-identical to what is deployed.
- Add home-k3s/{bihar,karnataka}: the k3s install kits and karnataka's
  workload manifests (secrets are out of band; only secretKeyRefs here).
- Update punjab (now a KubeVirt VM on karnataka), spindle (hives moved
  off; MAS replaced by Spindle OIDC; v0.1.6), the hive guide's current
  deployment section, README, index, inventory, network, CONTEXT and
  CLAUDE.md.
- inventory.yml: point punjab at its VM (the old address was the retired
  EC2 instance) and add bihar as bootstrap.sh registered it.
- Archive: move the home Talos handbooks and the retired Hetzner VPS pages
  under docs/src/archive/, banner talos-k8s/ (kept for tests), and mark
  the home-k8s server images as not deployed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(hive): fold in GitHub Apps and Bitwarden recovery items from #359, updated for bihar

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(hives): make the host timers actually run; add hive-cleanup

hive-reconcile and hive-sync never ran from their timers: SELinux denies
systemd exec of var_t scripts (203/EXEC). Start them through /usr/bin/bash.
Under systemd, rsync also moves into rsync_t, where its ssh cannot read the
key or ssh_config, so hive-sync.service runs as unconfined_t (setsebool -P
does not persist on bootc).

Port spindle's hive-cleanup to the podman hosts (hourly): idle Claude
scratch and stale /tmp work dirs in running spokes, dangling images, old
backups; measures /var. Document all of this and the reduced spindle
rollback path (its stale data, arm64 binaries and images were removed).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant