beevibe-pre-task-setup

Pre-Task Setup

When this fires

Every session that starts with a <task id="..."/> intent block. The session lifecycle (per the beevibe umbrella) requires you to set up your worktree before doing any work.

The protocol

1. Find the repo URL

Check for repo_url on the task. Fetch the task with get_task(task_id) if you don't already have it. The repo_url field tells you where to clone.

If task.repo_url is null:

• Parse the task description for git context (URLs, branch hints, "the foo repo")
• If still ambiguous, call report_blocker(task_id, "Cannot determine repo for this task") — the parent agent or operator will clarify

2. Check for existing clone

Your cwd is the workspace root (~/.beevibe/workspaces/<your_agent_id>/). The base clone lives at <repo_name>/:

ls <repo_name>/.git/HEAD 2>/dev/null && echo "EXISTS" || echo "MISSING"

3. Clone or pull

• If missing: git clone <task.repo_url>
• If present: refresh the base:

  cd <repo_name>
  git fetch --prune origin
  git checkout <default_branch>
  git pull --ff-only
  

4. Prune landed worktrees from earlier tasks

Before adding a new worktree, reclaim sibling <repo_name>-<task_id_short> dirs from earlier tasks whose work has already landed on origin/<default_branch>. git cherry compares by patch-id, so this catches both merge-commit and squash-merge cases:

# Run from inside <repo_name>/ (the base clone).
for wt in $(git worktree list --porcelain | awk '/^worktree/ {print $2}'); do
  branch=$(git -C "$wt" symbolic-ref --short HEAD 2>/dev/null || echo "")
  case "$branch" in
    agent/*)
      # 0 unmerged commits → all work already on the default branch → safe to remove.
      if [ "$(git cherry origin/<default_branch> "$branch" 2>/dev/null | grep -c '^+')" = "0" ]; then
        git worktree remove "$wt" 2>/dev/null && git branch -D "$branch" 2>/dev/null
      fi
      ;;
  esac
done

Worktrees with uncommitted state or unmerged commits stay — those may be pending revision or post-escalation. No --force here on purpose: if git worktree remove refuses, the worktree was still doing something useful.