strata:save

strata:save

Persist what just happened so the next session can pick up where this one Left off. Lands in <vault>/<repo>/pr-context/<branch-slug>/<timestamp>--<initials>--<topic>.md.

Two modes

Direct (default)

User says "save this as " or you decide to save autonomously.

1. Compose the note body in your reply.
2. Write:

"${CLAUDE_PLUGIN_ROOT}/bin/strata" save \
  --topic "<topic>" --kind session <<'STRATA_NOTE'
<note body>
STRATA_NOTE

Draft (interactive review)

User says "draft a save", "what would you save", or you're at the Stop-hook nudge and want help. Build a draft from real git state, then ask before writing.

1. Snapshot the session:

"${CLAUDE_PLUGIN_ROOT}/bin/run-python.sh" -c \
  "import sys; sys.path.insert(0, '${CLAUDE_PLUGIN_ROOT}/scripts'); \
   import session_state; \
   print(session_state.draft_note_body(session_state.snapshot()))"

The draft has four sections: What was done (from commits), In progress (from uncommitted), Decided (placeholder), Left open (placeholder).

1. Present the draft. Offer:

   • Accept — save with the suggested topic
   • Edit — apply changes (or fill Decided/Left open from conversation), re-confirm
   • Skip — abandon

2. On accept, pipe the final body through strata save with the topic from the draft.

Apply-draft (one-keystroke acceptance of a Stop-hook offer)

When the Stop hook stashes a pre-filled draft (it does this when the session crossed a signal threshold: 3+ commits, or 1+ commit with 3+ uncommitted files, or 8+ uncommitted files), the user can save it as-is with no further prompting:

"${CLAUDE_PLUGIN_ROOT}/bin/strata" save \
  --apply-draft

The script reads ${PLUGIN_DATA}/pending-draft.json, writes it to the current branch's pr-context/ folder, and clears the stash. Drafts older than 24h are silently dropped (treat as no-op).

If the user wants to edit the draft first, snapshot it, present it, then apply with the edited body (drop the stash via import draft_store; draft_store.clear_draft() after, or let it expire naturally).