continue

name	continue
description	Pick up a pending handoff in this repo. Reads `.momentum/inbox/handoff-NNN.md`, parses the structured context block, marks the inbox file as read, and emits a `[NOTE]` in the receiving repo's active phase history. Activates when the user invokes /continue or asks momentum to run the continue recipe.

Pick up a pending handoff in this repo. Reads .momentum/inbox/handoff-NNN.md, parses the structured context block, marks the inbox file as read, and emits a [NOTE] in the receiving repo's active phase history.

Three doors, one library. This is the slash-command door for Codex. CLI: momentum continue [--handoff <id>]. SessionStart hook auto-greets pending handoffs. All three call core/orchestration/continue.js.

Usage

/continue                     pick up the OLDEST pending handoff
/continue <id>                pick up handoff-<id> specifically
/continue list                list pending handoffs without picking

Steps

Step 1 — List or pick

const orchestration = require('<momentum-root>/core/orchestration');
const block = await orchestration.continueHandoff.continueHandoff({
  repo, handoffId, ecosystem,
});

Step 2 — Act on the block

Narrate summary, decisions, files, verification commands, open questions. Proceed with the work.

Step 3 — Don't surprise the user

Large blocks → summarise + offer "want me to read the full block?".

Tracking contract

• Auto: inbox file → read/ + [NOTE] in receiving active phase history.

Errors

• No pending → "no pending handoffs in this repo" (not an error).
• Specified id not found → error with list of pending ids.
• Malformed inbox → error pointing at the file.