--- a/lib/tests/higgsfield.test.sh
+++ b/lib/tests/higgsfield.test.sh
@@ -110,5 +110,150 @@
expect entries "$(entries "$EXT")" 3
verdict SYNC_FAIL_KEEPS_COPY
+# ── toggle ──────────────────────────────────────────────────
+BIN="$WORK/bin"; mkdir -p "$BIN"
+cat > "$BIN/higgsfield" <<'EOF'
+#!/usr/bin/env bash
+# Fake CLI: `auth token` answers per $FAKE_HF_SESSION (in | out).
+[ "${1:-} ${2:-}" = "auth token" ] || exit 64
+if [ "${FAKE_HF_SESSION:-in}" = in ]; then echo "fixture-token"; exit 0; fi
+echo "Error: Not authenticated." >&2; exit 2
+EOF
+cat > "$BIN/21st" <<'EOF'
+#!/usr/bin/env bash
+[ "${1:-}" = whoami ] && echo "Logged in as fixture (saved in fixture)."
+EOF
+chmod +x "$BIN/higgsfield" "$BIN/21st"
+
+# Precondition, loud: the CLI-absent case runs on a sanitized PATH that must
+# not resolve a real `higgsfield`.
+if PATH=/usr/bin:/bin command -v higgsfield >/dev/null 2>&1; then
+ echo "FAIL precondition: a system-wide higgsfield resolves on /usr/bin:/bin"
+ exit 1
+fi
+
+# mk_toggle_fx
[skill...] — fixture repo: the toggle script plus one
+# skills-external source per named skill (none → installed-nothing tree).
+mk_toggle_fx() {
+ local fx="$1" s; shift
+ mkdir -p "$fx/lib" "$fx/skills"
+ cp "$ROOT/lib/toggle-external.sh" "$ROOT/lib/gstack-removed.sh" "$fx/lib/"
+ for s in "$@"; do
+ mkdir -p "$fx/skills-external/$s"
+ echo "---" > "$fx/skills-external/$s/SKILL.md"
+ done
+}
+PACK=(higgsfield-alpha higgsfield-beta higgsfield-websites)
+
+# tog — run the fixture's toggle script, fake CLIs first.
+tog() {
+ local fx="$1"; shift
+ TOGGLE_EXTERNAL_REPO_OVERRIDE="$fx" PATH="$BIN:$PATH" \
+ bash "$fx/lib/toggle-external.sh" "$@" 2>&1
+}
+# list_row — the status column of `list` for one tool.
+list_row() { tog "$1" list | awk -v t="$2" '$1 == t { print $2 }'; }
+
+F0="$WORK/f0"; mk_toggle_fx "$F0"
+F1="$WORK/f1"; mk_toggle_fx "$F1" "${PACK[@]}"
+expect pack-missing "$(tog "$F0" status higgsfield)" missing
+expect web-missing "$(tog "$F0" status higgsfield-websites)" missing
+expect pack-disabled "$(tog "$F1" status higgsfield)" disabled
+expect web-disabled "$(tog "$F1" status higgsfield-websites)" disabled
+ln -s "$F1/skills-external/higgsfield-alpha" "$F1/skills/higgsfield-alpha"
+expect pack-partial "$(tog "$F1" status higgsfield)" enabled
+expect web-apart "$(tog "$F1" status higgsfield-websites)" disabled
+expect list-pack "$(list_row "$F1" higgsfield)" enabled
+expect list-web "$(list_row "$F1" higgsfield-websites)" disabled
+verdict STATUS_STATES
+
+F2="$WORK/f2"; mk_toggle_fx "$F2" "${PACK[@]}"
+out="$(tog "$F2" enable higgsfield)"; rc=$?
+expect rc "$rc" 0
+expect alpha "$(readlink "$F2/skills/higgsfield-alpha")" \
+ "$F2/skills-external/higgsfield-alpha"
+expect beta "$(readlink "$F2/skills/higgsfield-beta")" \
+ "$F2/skills-external/higgsfield-beta"
+expect no-websites "$(yn test -e "$F2/skills/higgsfield-websites")" no
+expect_has count "$out" "higgsfield enabled (2 skills: 0 restored, 2 linked)"
+out="$(tog "$F2" enable higgsfield)"; rc=$?
+expect again-rc "$rc" 0
+expect_has again "$out" "higgsfield already enabled"
+verdict ENABLE_PACK_EXCLUDES_WEBSITES
+
+F3="$WORK/f3"; mk_toggle_fx "$F3" "${PACK[@]}"
+out="$(tog "$F3" enable higgsfield-websites)"; rc=$?
+expect rc "$rc" 0
+expect link "$(readlink "$F3/skills/higgsfield-websites")" \
+ "$F3/skills-external/higgsfield-websites"
+expect no-alpha "$(yn test -e "$F3/skills/higgsfield-alpha")" no
+expect pack-status "$(tog "$F3" status higgsfield)" disabled
+expect web-status "$(tog "$F3" status higgsfield-websites)" enabled
+verdict ENABLE_WEBSITES_ALONE
+
+# Continues on F2: the pack is enabled, websites is not.
+tog "$F2" enable higgsfield-websites >/dev/null
+out="$(tog "$F2" disable higgsfield)"; rc=$?
+expect rc "$rc" 0
+expect_has msg "$out" "higgsfield disabled (2 skills parked)"
+expect parked "$(yn test -L "$F2/skills-disabled/higgsfield-alpha")" yes
+expect unlinked "$(yn test -e "$F2/skills/higgsfield-alpha")" no
+expect web-untouched "$(yn test -e "$F2/skills/higgsfield-websites")" yes
+out="$(tog "$F2" enable higgsfield)"
+expect_has restored "$out" "2 restored, 0 linked"
+tog "$F2" disable higgsfield-websites >/dev/null
+expect web-parked "$(yn test -L "$F2/skills-disabled/higgsfield-websites")" yes
+expect pack-on "$(tog "$F2" status higgsfield)" enabled
+verdict DISABLE_PARKS
+
+F4="$WORK/f4"; mk_toggle_fx "$F4" "${PACK[@]}"
+out="$(FAKE_HF_SESSION=out tog "$F4" enable higgsfield)"; rc=$?
+expect out-rc "$rc" 0
+expect out-linked "$(yn test -e "$F4/skills/higgsfield-alpha")" yes
+expect_has out-hint "$out" "higgsfield auth login"
+F5="$WORK/f5"; mk_toggle_fx "$F5" "${PACK[@]}"
+out="$(FAKE_HF_SESSION=in tog "$F5" enable higgsfield)"
+expect_not in-quiet "$out" "auth login"
+expect_not in-no-token "$out" "fixture-token"
+F6="$WORK/f6"; mk_toggle_fx "$F6" "${PACK[@]}"
+out="$(TOGGLE_EXTERNAL_REPO_OVERRIDE="$F6" PATH=/usr/bin:/bin \
+ bash "$F6/lib/toggle-external.sh" enable higgsfield 2>&1)"; rc=$?
+expect absent-rc "$rc" 0
+expect absent-linked "$(yn test -e "$F6/skills/higgsfield-alpha")" yes
+expect_has absent-hint "$out" "not on PATH"
+verdict SIGNED_OUT_WARNS
+
+out="$(tog "$F0" enable higgsfield)"; rc=$?
+expect pack-rc "$rc" 1
+expect_has pack-path "$out" "$F0/skills-external"
+out="$(tog "$F0" enable higgsfield-websites)"; rc=$?
+expect web-rc "$rc" 1
+expect_has web-path "$out" "$F0/skills-external/higgsfield-websites"
+verdict ENABLE_MISSING_ERRS
+
+# The pack arms are shared with 21st: its behaviour must not move.
+F7="$WORK/f7"; mk_toggle_fx "$F7" 21st-one 21st-two
+expect off "$(tog "$F7" status 21st)" disabled
+out="$(tog "$F7" enable 21st)"
+expect_has on "$out" "21st enabled (2 skills: 0 restored, 2 linked)"
+expect_not quiet "$out" "21st login"
+expect hf-apart "$(tog "$F7" status higgsfield)" missing
+out="$(tog "$F7" disable 21st)"
+expect_has parked "$out" "21st disabled (2 skills parked)"
+verdict PACK_21ST_UNCHANGED
+
+# ── wiring ──────────────────────────────────────────────────
+# count — matching lines (0 when none).
+count() { grep -cF -- "$2" "$ROOT/$1"; }
+
+# Positive control first: the pattern does bite on a line that carries it.
+expect control "$(echo 'higgsfield-alpha external' | grep -cF higgsfield)" 1
+expect link-sh "$(count link.sh higgsfield)" 0
+expect profile-sh "$(count lib/profile.sh higgsfield)" 0
+expect profiles \
+ "$(cat "$ROOT"/lib/profiles/*.profile | grep -cF higgsfield)" 0
+expect pins-map "$(count lib/effort-pins.txt higgsfield)" 0
+verdict OFF_BY_DEFAULT_WIRING
+
# ── tally ───────────────────────────────────────────────────
printf 'PASS=%s FAIL=%s\n' "$pass" "$fail"; [ "$fail" -eq 0 ]