feat: v1.12.3.0 migration — wire existing brain-sync repos into gbrain

Idempotent migration script. For users who already opted into brain-sync
before this release (gbrain_sync_mode != off, ~/.gstack/.git exists), runs
the new gstack-gbrain-source-wireup helper so their existing brain repo
becomes searchable via gbrain immediately on /gstack-upgrade.

Skip conditions (each ends with exit 0):
  - HOME unset or empty (defensive)
  - gbrain_sync_mode = off or empty (user opted out)
  - no ~/.gstack/.git (brain-init never ran)
  - helper missing on disk (broken install)

No --strict on the helper invocation: missing or old gbrain is a benign
skip during a batch upgrade rather than a blocker.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

gstack-upgrade/migrations/v1.12.3.0.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# Migration: v1.12.3.0 — Wire existing brain-sync repos as gbrain federated sources
+#
+# Pre-1.12.3.0 /setup-gbrain wrote ~/.gstack/consumers.json with a placeholder
+# `status: "pending"` and an empty `ingest_url`, expecting a gbrain HTTP
+# /ingest-repo endpoint that never shipped. This migration runs the real
+# wireup (gbrain sources add + worktree + initial sync) for users who
+# already opted into brain-sync but never got the gbrain side connected.
+#
+# Idempotent: safe to re-run. Skips when:
+#   - User never opted into brain-sync (gbrain_sync_mode = off or unset)
+#   - No ~/.gstack/.git (brain-init never ran)
+#   - The wireup helper is missing on disk (broken install — defensive)
+#
+# Failure mode: invokes the helper WITHOUT --strict, so a missing/old gbrain
+# CLI is a benign skip rather than blocking the rest of /gstack-upgrade.
+set -euo pipefail
+
+if [ -z "${HOME:-}" ]; then
+  echo "  [v1.12.3.0] HOME is unset or empty — skipping migration." >&2
+  exit 0
+fi
+
+SKILLS_DIR="${HOME}/.claude/skills"
+BIN_DIR="${SKILLS_DIR}/gstack/bin"
+CONFIG_BIN="${BIN_DIR}/gstack-config"
+WIREUP_BIN="${BIN_DIR}/gstack-gbrain-source-wireup"
+
+# Skip if user never opted into brain-sync.
+SYNC_MODE=""
+if [ -x "$CONFIG_BIN" ]; then
+  SYNC_MODE=$("$CONFIG_BIN" get gbrain_sync_mode 2>/dev/null || echo "")
+fi
+if [ "$SYNC_MODE" = "off" ] || [ -z "$SYNC_MODE" ]; then
+  exit 0
+fi
+
+# Skip if no brain-sync git repo exists.
+if [ ! -d "${HOME}/.gstack/.git" ]; then
+  exit 0
+fi
+
+# Skip if helper missing (defensive — should always be present post-upgrade).
+if [ ! -x "$WIREUP_BIN" ]; then
+  echo "  [v1.12.3.0] $WIREUP_BIN missing or non-executable — skipping wireup." >&2
+  exit 0
+fi
+
+echo "  [v1.12.3.0] Wiring brain-sync repo into gbrain (federated source + initial sync)..."
+
+# No --strict: missing/old gbrain is a benign skip during a batch upgrade.
+"$WIREUP_BIN" || {
+  echo "  [v1.12.3.0] Wireup exited non-zero — re-run manually with: $WIREUP_BIN" >&2
+}