Files
wanderbooks/install.sh
T
swaitsandClaude Fable 5.1 af553a3706
check / check (push) Canceled after 0s
two-user / two-user (push) Canceled after 0s
docs: the 2026-10-28 drift review; the plan, status and docs brought to date
The planning session read plan/served.md, every design document and the
five branches the owner paused on 2026-10-27 against main (44ee4083),
with dry-run merges touching no branch. plan/2026-10-28_DRIFT_REPORT.md
lists every divergence and judges every recorded departure (all kept;
three owed back; one needs a decision: P6 made ledger-store depend on
ledger-import).

The plan: section 0 "What changed on 2026-10-28"; 8.0.1 and the unit
Status lines name S4.4, S5, S6, S7 and P6 as built but unmerged; 8.0.2
records the destination (D-56: the installed app, P11a starts now) and
the resume order with the known conflicts (the shared documents.rs
test file, the types.rs appends, P6 retaking schema 18, the law numbers
34 to 37); 8.0.3 lists the names the EM approved during the wave; P11a
gains step 0 (the macOS and Windows keyring stores, the Windows data
root and pipes, a cross-platform CI build: today the agent path runs on
Linux alone); Q-5 is due and Q-8 asks whether D-47 to D-54 stand; the
Landlock sentences in section 2 and server.toml are struck.

STATUS.md and HANDOFF.md say where things stand and how to resume;
roadmap.md and gui.md are rewritten to today. The docs lose their
stale facts: 122 tools, 2,700 tests, the parity floor at 21 with the
P4b notes the slices never wrote, the ten crates and their dependency
graph (jiff added to the core's allowed list), the cutover of
2026-10-20 recorded in capability-parity.md and parallel-run.md, the
P4b S1 law and its two Kani harnesses added to verification.md (law
34), the proof counts (51 and 9), and README, the site and install.sh
honest about macOS (the viewer runs; connecting an agent waits for
P11a's keyring store, and the installer now says so instead of failing).

just check on main at 44ee4083: exit 0 (167 suites, 2,871 passed, 0
failed, 7 ignored, the server-only build clean). No code changed.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HS8WZziDnyxunC23MUxrLp
2026-10-28 18:26:23 -06:00

93 lines
3.9 KiB
Bash
Executable File

#!/bin/sh
# wanderbooks installer. One line on a new machine:
#
# curl -fsSL https://wanderbooks.ai/install.sh | sh -s -- acme
#
# Linux, and macOS with one gap: agents' tokens live in the OS keyring and
# only the Linux store exists until the macOS app (plan P11a), so on macOS
# this installs, sets up and starts the books but cannot connect an agent
# yet (it says so instead of failing). On Windows, run it inside WSL2
# (Ubuntu): the viewer opens as a normal window on Windows 11.
#
# Installs Rust if needed, then the one `wanderbooks` program (into
# ~/.cargo/bin), then makes the books' private folder (`wanderbooks setup`).
# Given a name (lowercase letters, digits, hyphens), it also starts books of
# that name and lets Claude Code reach them. Nothing runs as root; the
# books close on their own a few seconds after the last command.
#
# WANDERBOOKS_REPO overrides where it installs from (a git URL).
set -eu
REPO="${WANDERBOOKS_REPO:-https://git.swaits.com/swaits/wanderbooks}"
say() { printf '\033[1m%s\033[0m\n' "$*"; }
die() { printf '\033[1;31m%s\033[0m\n' "$*" >&2; exit 1; }
case "$(uname -s)" in
Linux) os=linux ;;
Darwin) os=macos ;;
MINGW* | MSYS* | CYGWIN*)
die "On Windows, install WSL2 (wsl --install), open Ubuntu, and run this there." ;;
*) die "Unsupported system: $(uname -s). wanderbooks runs on Linux and macOS (Windows via WSL2)." ;;
esac
# A C compiler: SQLite and a few other pieces are compiled from source.
if ! command -v cc >/dev/null 2>&1 && ! command -v gcc >/dev/null 2>&1 && ! command -v clang >/dev/null 2>&1; then
if [ "$os" = macos ]; then
die "Needs Apple's command line tools. Run: xcode-select --install (then run this again)"
fi
hint="your distribution's C compiler package"
if command -v apt-get >/dev/null 2>&1; then hint="sudo apt-get install -y build-essential"
elif command -v dnf >/dev/null 2>&1; then hint="sudo dnf install -y gcc"
elif command -v pacman >/dev/null 2>&1; then hint="sudo pacman -S --needed base-devel"
elif command -v zypper >/dev/null 2>&1; then hint="sudo zypper install -y gcc"
elif command -v apk >/dev/null 2>&1; then hint="sudo apk add build-base"
fi
die "Needs a C compiler. Run: $hint (then run this again)"
fi
command -v git >/dev/null 2>&1 || die "Needs git. Install it, then run this again."
if ! command -v cargo >/dev/null 2>&1; then
if [ -x "$HOME/.cargo/bin/cargo" ]; then
PATH="$HOME/.cargo/bin:$PATH"
else
say "Installing Rust (rustup)…"
curl -fsSL https://sh.rustup.rs | sh -s -- -y --profile minimal
# shellcheck disable=SC1091
. "$HOME/.cargo/env"
fi
fi
say "Installing wanderbooks from $REPO (a few minutes, once)…"
cargo install --locked --git "$REPO" ledger-cli
case ":$PATH:" in
*":$HOME/.cargo/bin:"*) ;;
*) say "Add ~/.cargo/bin to your PATH (rustup's installer usually does; open a new terminal)." ;;
esac
wb="$HOME/.cargo/bin/wanderbooks"
# The books' private folder, and (at a terminal) the owner passphrase.
if [ -t 1 ] && [ -e /dev/tty ]; then
"$wb" setup </dev/tty
else
"$wb" setup
fi
if [ $# -gt 0 ]; then
# Books of that name already (the line run again): connected, not made.
if ! "$wb" books list | cut -d' ' -f1 | grep -qx "$1"; then
"$wb" books create "$1"
fi
if [ "$os" = macos ]; then
say "Done. Your books \"$1\" exist and 'wanderbooks gui $1' shows them. Connecting Claude Code waits for the macOS keyring store (the app, plan P11a); until then agents connect from Linux."
elif command -v claude >/dev/null 2>&1; then
"$wb" connect claude --book "$1"
say "Done. Start Claude Code and say hello: your books \"$1\" are ready."
else
say "Done. Install Claude Code (https://claude.com/claude-code), then: wanderbooks connect claude --book $1"
fi
exit 0
fi
say "Done. Start books with: wanderbooks books create acme then: wanderbooks connect claude --book acme"