install-dependency

Install Dependency

Monorepo-aware dependency installation using bundled scripts.

⚠️ AskUserQuestion Guard

CRITICAL: After EVERY AskUserQuestion call, check if answers are empty/blank. Known Claude Code bug: outside Plan Mode, AskUserQuestion silently returns empty answers without showing UI.

If answers are empty: DO NOT proceed with assumptions. Instead:

1. Output: "⚠️ Questions didn't display (known Claude Code bug outside Plan Mode)."
2. Present the options as a numbered text list and ask user to reply with their choice number.
3. WAIT for user reply before continuing.

Quick Reference

Types: python (pip), js (bun), system (apt/brew/dnf)

SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "$SKILL_DIR/scripts/setup-env.sh"           # 1. Setup env
"$SKILL_DIR/scripts/scan.sh" <pkg> <type>          # 2. Check existing
# 3. Prompt user if needed (see below)
"$SKILL_DIR/scripts/install-{python,js,system}.sh" <pkg> [shared|local]  # 4. Install
"$SKILL_DIR/scripts/verify.sh" <pkg> <type>        # 5. Verify
"$SKILL_DIR/scripts/cleanup.sh"                    # 6. Cleanup (optional)

Workflow

1. Setup Environment

SKILL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
source "$SKILL_DIR/scripts/setup-env.sh"

Sets $LOCAL_TMP, $GIT_ROOT, overrides $TMPDIR to avoid /tmp/claude conflicts.

2. Scan for Existing Package

if "$SKILL_DIR/scripts/scan.sh" <package> <type>; then
  echo "✓ Package already installed"
  exit 0
fi

Exit codes: 0=found, 1=not found, 2=usage error.

3. Prompt User (if needed)

Decision tree:

if_found_in_parent:
  action: Report "✓ <package> already at <path>"
  install: false

if_at_git_root:
  action: Install locally (no prompt)
  mode: local

if_in_subproject_not_found:
  action: Use AskUserQuestion
  options:
    - "Shared at {GIT_ROOT} (recommended)" → mode=shared
    - "Local at {PWD} (isolated)" → mode=local

AskUserQuestion example: