kumiho-onboard

Kumiho Onboarding Wizard

Run the onboarding wizard that configures the kumiho-memory plugin end-to-end: Python venv, backend selection, MCP server config, and skill ingestion into the graph.

Before any step: resolve the interpreter

No single interpreter name exists on every platform. Resolve by OS first. On Windows, never execute python, python3, or a PATH-resolved py as a probe: App Execution Aliases and shims can open Store/legacy application windows. Derive the home directory from the OS account record, then use the existing ~/.kumiho/venv/Scripts/python.exe; if it is absent, use only a PE-validated Python Launcher at its OS-managed path. If neither works, stop and report Python 3.10+ missing. On macOS/Linux, derive the home directory from the OS account database, prefer the shared ~/.kumiho/venv/bin/python, then probe only fixed absolute Python locations. Never trust host/project HOME, PATH, or a shell shim.

The MCP server itself starts through the persistent ${CLAUDE_PLUGIN_DATA}/venv compatibility alias. The wizard also records a known-good absolute KUMIHO_PYTHON for older external integrations. Resolve the bootstrap interpreter here, in this shell:

KUMIHO_UID=$(/usr/bin/id -u) || exit 1
KUMIHO_ACCOUNT_HOME=""
KUMIHO_PASSWD=""
if [ -x /usr/bin/getent ]; then
  KUMIHO_PASSWD=$(/usr/bin/getent passwd "$KUMIHO_UID")
elif [ -x /bin/getent ]; then
  KUMIHO_PASSWD=$(/bin/getent passwd "$KUMIHO_UID")
fi
if [ -n "$KUMIHO_PASSWD" ]; then
  IFS=: read -r _ _ _ _ _ KUMIHO_ACCOUNT_HOME _ <<EOF
$KUMIHO_PASSWD
EOF
elif [ -x /usr/bin/dscacheutil ]; then
  KUMIHO_DS=$(/usr/bin/dscacheutil -q user -a uid "$KUMIHO_UID")
  while IFS= read -r KUMIHO_LINE; do
    case "$KUMIHO_LINE" in
      "dir: "*) KUMIHO_ACCOUNT_HOME=${KUMIHO_LINE#dir: } ;;
    esac
  done <<EOF
$KUMIHO_DS
EOF
fi
case "$KUMIHO_ACCOUNT_HOME" in
  /*) ;;
  *) echo "Kumiho: OS account home could not be resolved safely" >&2; exit 1 ;;
esac

KUMIHO_SHARED_ROOT="$KUMIHO_ACCOUNT_HOME/.kumiho/venv"
KUMIHO_PY="$KUMIHO_SHARED_ROOT/bin/python"
if ! { [ -x "$KUMIHO_PY" ] && [ -f "$KUMIHO_SHARED_ROOT/pyvenv.cfg" ] &&
       "$KUMIHO_PY" -I -S -c 'import sys; raise SystemExit(0 if sys.version_info >= (3,10) else 3)' 2>/dev/null &&
       "$KUMIHO_PY" -I -c 'import os,sys; raise SystemExit(0 if os.path.realpath(sys.prefix) == os.path.realpath(sys.argv[1]) else 3)' "$KUMIHO_SHARED_ROOT" 2>/dev/null; }; then
  KUMIHO_PY=""
  for KUMIHO_CANDIDATE in /usr/bin/python3 /usr/local/bin/python3 /opt/homebrew/bin/python3; do
    if [ -x "$KUMIHO_CANDIDATE" ] &&
       "$KUMIHO_CANDIDATE" -I -S -c 'import sys; raise SystemExit(0 if sys.version_info >= (3,10) else 3)' 2>/dev/null; then
      KUMIHO_PY="$KUMIHO_CANDIDATE"
      break
    fi
  done
fi
[ -n "$KUMIHO_PY" ] || { echo "Kumiho: Python 3.10+ not found" >&2; exit 1; }