drive

/mb drive

Drive goal.md to completion by looping the deterministic decision function scripts/mb-drive.sh — a "ralph-loop" rebuilt over the firewall instead of over the model's own judgement (drive-loop ADR-1).

You are the runtime. mb-drive.sh is a stateless brain: it prints exactly ONE next action and exits. It starts no daemon, holds no cross-invocation state, and never dispatches a subagent itself. You call it, execute the action it returned, then call it again — until it returns a stop_* action (REQ-DR-002/003).

/mb drive [--route R] [--phase P] [--budget TOK] [--max-cycles N]

1. Preflight — resolve or refuse (REQ-DR-031)

/mb drive never silently starts. It reads goal.md; if the file is absent it scaffolds templates/goal.md into the bank and still refuses, so you have something concrete to fill in. If the file exists but does not resolve, it reuses the /mb goal failure path verbatim — scripts/mb-goal-validate.sh prints one concrete fix-hint per problem on stderr and exits 1.

Run this before the loop, every time:

SKILL_DIR="${SKILL_DIR:-$(cd "$(dirname "$0")/.." && pwd)}"   # memory-bank skill bundle root

# Bank resolution goes through the skill's ONE resolver (explicit arg → MB_PATH
# → local .memory-bank → global registry → legacy pointer). A hardcoded default
# would silently drive the wrong bank for globally-stored or relocated banks.
# shellcheck source=../scripts/_lib.sh
. "$SKILL_DIR/scripts/_lib.sh"
BANK="$(mb_resolve_path "${BANK:-}")"

# Flags this fence conducts. The loop below reads the very same variables, so a
# flag is either wired here or it does not exist.
BUDGET="${BUDGET:-}"          # --budget TOK
MAX_CYCLES="${MAX_CYCLES:-}"  # --max-cycles N

# No bank at all — /mb drive has nothing to drive.
if [ ! -d "$BANK" ]; then
  echo "[drive] refusing to start: no Memory Bank at '$BANK' — run /mb init first, then re-run /mb drive" >&2
  exit 1
fi

# Absent goal.md: scaffold the durable template, but still refuse. A bare
# template is not a goal — the loop must never start off placeholder text.
if [ ! -f "$BANK/goal.md" ]; then
  cp "$SKILL_DIR/templates/goal.md" "$BANK/goal.md"
  echo "[drive] refusing to start: no goal.md — scaffolded a template at $BANK/goal.md." >&2
  echo "[drive] fill in id, ## Description, ## Acceptance criteria and progress_source, then re-run /mb drive" >&2
  exit 1
fi

# Present but unresolvable: reuse the validator's failure path (exit 1 + one
# fix-hint per problem on stderr). The second argument pins the bank being
# driven, so `progress_source` resolves against IT and not against whatever
# .memory-bank happens to sit in the current working directory.
# An untouched scaffold fails here too: the validator rejects `<...>`
# placeholder acceptance criteria (a template is not a goal).
if ! bash "$SKILL_DIR/scripts/mb-goal-validate.sh" "$BANK/goal.md" "$BANK"; then
  echo "[drive] refusing to start: goal.md does not resolve — fix the hints above, then re-run /mb drive" >&2
  exit 1
fi

# ---- the goal resolves; arm durable state ---------------------------------
# ONE run id is minted here and threaded through every stateful consumer
# (work-state, budget, stop-telemetry, and the loop itself), so a parallel
# drive can never read another run's cycle counter or budget.
RUN_ID="${MB_WORK_RUN_ID:-$(bash "$SKILL_DIR/scripts/mb-work-state.sh" new-run-id)}"
export MB_WORK_RUN_ID="$RUN_ID"

# Durable cycle counter. `--max-cycles` reaches the run HERE or nowhere: it is
# what turns `stop_human max-cycle` from a constant into a user-set ceiling.
bash "$SKILL_DIR/scripts/mb-work-state.sh" init drive 0 --run-id "$RUN_ID" --mb "$BANK" ${MAX_CYCLES:+--max-cycles "$MAX_CYCLES"} >/dev/null

# Budget is stamped ONLY when --budget was given. A drive without --budget must
# not inherit or invent a ceiling — mb-drive.sh then never emits `stop_budget`.
if [ -n "$BUDGET" ]; then
  bash "$SKILL_DIR/scripts/mb-work-budget.sh" init "$BUDGET" --run-id "$RUN_ID" --mb "$BANK" >/dev/null
fi

# Arm stop-telemetry LAST — only a drive that actually starts is RUNNING. This
# is also the only thing that arms hooks/mb-drive-resume-gate.sh, so ordinary
# sessions are never gated (REQ-DR-033/034).
bash "$SKILL_DIR/scripts/mb-drive-stop.sh" arm --bank "$BANK" --run-id "$RUN_ID" >/dev/null