fix: install patched spinosa shim on PATH and document beta.2

Local patch now writes the user-facing shim to SPINOSA_BIN_DIR (~/.local/bin) and CHANGELOG covers the theater/CLI cleanup for the next beta.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: TommasoPrinetti

CHANGELOG.md

@@ -36,6 +36,26 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Shellcheck passes on `install.sh` (legacy shim detection uses explicit disable comments).
 - `bun install` catalog entry for `@effect/platform-node-shared` restored.
 
+## [1.0.3-beta.2] — 2026-07-30
+
+### Changed
+
+- Settings writes real `auto_upgrade` in `~/.spinosa/metadata/config.yaml` (removed unused `autoupdate` / skipped-version theater).
+- Product identity leftovers rebranded to Spinosa; OpenCode Zen and OpenCode Go providers kept as-is.
+- Worktree branch prefix is `spinosa/` instead of `opencode/`.
+- Local patch installer also installs the user-facing shim into `SPINOSA_BIN_DIR` (default `~/.local/bin`).
+
+### Removed
+
+- `spinosa github` and `spinosa acp` from the product CLI (quarantined under `script/orphan/`).
+- Fake tips for github install, `/review`, and related OpenCode leftovers.
+
+### Fixed
+
+- TUI picker Escape restores the previous route; failed workspace opens roll back path/KV.
+- Skills and docs use `spinosa export` (no unsupported `--session`/`--last`).
+- Stable channel UI notes that the rolling channel may be unavailable until published.
+
 ## [1.0.3-beta.1] — 2026-07-30
 
 ### Changed

script/patch-local-install.sh

@@ -7,15 +7,30 @@ ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 VERSION="$(awk -F'"' '/"version":/ { print $4; exit }' "$ROOT/package.json")"
 SPINOSA_HOME="${SPINOSA_HOME:-$HOME/.spinosa}"
 TARGET="${SPINOSA_HOME}/versions/${VERSION}"
+# Real installs put the user-facing shim in ~/.local/bin (see env.sh / install.sh).
+# ~/.spinosa/bin/spinosa is the home-local copy; PATH uses SPINOSA_BIN_DIR.
+if [[ -z "${SPINOSA_BIN_DIR:-}" && -f "${SPINOSA_HOME}/env.sh" ]]; then
+  # shellcheck disable=SC1090
+  # Only pull BIN_DIR — do not source the whole file (would mutate caller PATH).
+  SPINOSA_BIN_DIR="$(
+    awk -F= '/^export SPINOSA_BIN_DIR=/ {
+      gsub(/"/, "", $2)
+      print $2
+      exit
+    }' "${SPINOSA_HOME}/env.sh"
+  )"
+fi
+SPINOSA_BIN_DIR="${SPINOSA_BIN_DIR:-$HOME/.local/bin}"
 BUN="${SPINOSA_HOME}/bin/bun"
 if [[ ! -x "$BUN" ]]; then
   BUN="$(command -v bun)"
 fi
 [[ -n "$BUN" && -x "$BUN" ]] || { echo "Error: bun not found" >&2; exit 1; }
 
 echo "→ Patching ${SPINOSA_HOME} with local repo v${VERSION}"
+echo "  Shim dir: ${SPINOSA_BIN_DIR}"
 
-mkdir -p "${SPINOSA_HOME}/versions" "${SPINOSA_HOME}/bin" "${SPINOSA_HOME}/metadata"
+mkdir -p "${SPINOSA_HOME}/versions" "${SPINOSA_HOME}/bin" "${SPINOSA_HOME}/metadata" "${SPINOSA_BIN_DIR}"
 rsync -a --delete \
   --exclude '.git/' \
   --exclude 'node_modules/' \
@@ -29,6 +44,7 @@ mkdir -p "${TARGET}/metadata" "${TARGET}/workspace-template/.bin"
 printf '%s\n' "$VERSION" > "${TARGET}/metadata/version"
 install -m 755 "${ROOT}/workspace-template/.bin/spinosa" "${TARGET}/workspace-template/.bin/spinosa"
 install -m 755 "${ROOT}/workspace-template/.bin/spinosa" "${SPINOSA_HOME}/bin/spinosa"
+install -m 755 "${ROOT}/workspace-template/.bin/spinosa" "${SPINOSA_BIN_DIR}/spinosa"
 
 link_workspace_packages() {
   local root="$1" nm="${1}/node_modules/@spinosa"
@@ -55,5 +71,7 @@ SPINOSA_HOME="$SPINOSA_HOME" SPINOSA_TEMPLATE_ROOT="$TARGET" \
   "$BUN" run "${TARGET}/packages/spinosa-kernel/src/index.ts" version
 
 echo "✓ Patched ${SPINOSA_HOME} to local v${VERSION}"
+echo "  Shim: ${SPINOSA_BIN_DIR}/spinosa"
 echo "  Run: spinosa version"
 echo "  Run: spinosa upgrade --check"
+echo "  If command not found: source ${SPINOSA_HOME}/env.sh  (or open a new shell)"