init

Project Initialization

Per-project LETS setup. Bridges to lets init --json (Go binary) for all filesystem mutation. Slash command captures user prefs via AskUserQuestion, exec's the binary, parses JSON stdout, renders to user.

IMPORTANT: If the spec below invokes any deferred tool (e.g. AskUserQuestion), you MUST load and call it as specified. Never skip the call, never substitute a default answer of your own — the tool invocation is part of the contract. This is critical.

MANDATORY: Execute every Step's bash block literally as written. Do not substitute output from earlier ls/cat/bd show in this conversation — .env and other dotfiles are invisible to plain ls. The test -f / test -d checks below ARE the contract for branching first-time-vs-re-run paths; shortcutting them produces wrong branches.

Step 1: Pre-checks

command -v lets >/dev/null 2>&1 || { echo "NO_LETS_BINARY"; exit 0; }
LETS_PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || echo "NOT_GIT_REPO"
if [ -n "$LETS_PROJECT_ROOT" ]; then
  test -f "$LETS_PROJECT_ROOT/.lets/.env" && echo "ENV_EXISTS" || echo "ENV_ABSENT"
  test -d "$LETS_PROJECT_ROOT/.beads" && echo "BEADS_EXISTS" || echo "BEADS_ABSENT"
fi

Branch on output:

• NO_LETS_BINARY → tell user "lets binary not found on $PATH. Install it — ! curl -fsSL https://raw.githubusercontent.com/restarter/lets-workflow/main/scripts/install.sh | bash (the leading ! runs it in this session; or the same command without ! in a terminal). See the README → Quick Start." NO LETS box. STOP.
• NOT_GIT_REPO → ask user via AskUserQuestion (Step 1a below). If user picks "Init git" → run git init, recompute LETS_PROJECT_ROOT, ENV_ABSENT/BEADS_ABSENT (both will be absent for fresh repo). If "Cancel" → stop, NO LETS box.
• ENV_ABSENT → first-time path (Step 2). Use BEADS_ABSENT/BEADS_EXISTS to decide whether to ask about beads init in Step 2c-bis.
• ENV_EXISTS → re-run path (Step 3). Don't re-ask about beads — lets init self-heals (StepSkip if already inited; StepWarn if bd not on PATH).