@procrastivity/clast 0.0.3 → 0.0.5

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@procrastivity/clast",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Capture, curate, and surface Claude Code session history across all your projects.",
   "homepage": "https://github.com/procrastivity/clast#readme",
   "bin": {
     "clast": "bin/clast",
-    "clast-wake": "bin/clast-wake",
-    "clast-brief": "bin/clast-brief"
+    "clast-plumbing": "bin/clast-plumbing"
   },
   "files": [
     "bin/",
     "lib/",
     ".claude-plugin/",
+    "skills/",
     "hooks/",
     "examples/",
     "README.md",

package/{.claude-plugin/skills/wakeup → skills/brief}/SKILL.md

@@ -1,49 +1,51 @@
 ---
-name: wakeup
+name: brief
 description: |
-  Synthesize a briefing for the current project (or a named one) so the user can resume work without re-explaining context. Use when the user says "/wakeup", "wakeup", "wake up", "catch me up", "where was I", "what was I working on", "load last session", "resume", or otherwise signals they want prior context for the project they're about to work on. Optionally accepts a project slug like "/wakeup xesapps". Reads recent curated entries and today's breadcrumbs from `~/.claude/journal/` and produces a 2–5k-token briefing. This is the per-project read flow; for cross-project daily curation use /day-wakeup; for mid-session pivots use session-brief.
+  Synthesize a briefing for the current project (or a named one) so the user can resume work without re-explaining context. Use when the user says "/brief", "brief me", "catch me up", "where was I", "what was I working on", "load last session", "resume", or otherwise signals they want prior context for the project they're about to work on. Optionally accepts a project slug like "/brief xesapps". Reads recent curated entries and today's breadcrumbs from `~/.claude/journal/` and produces a 2–5k-token briefing. This is the per-project read flow; for cross-project daily curation use /wake; for mid-session pivots use session-brief.
 ---
 
-# Wakeup
+# Brief
 
 Synthesize a briefing for the current (or named) project so the user can resume without re-explaining context.
 
 ## Why this exists
 
-`/day-wakeup` curates yesterday's work into entries. `/wakeup` reads those entries back when starting work in a specific repo. The two are complementary: one writes, one reads.
+`/wake` curates yesterday's work into entries. `/brief` reads those entries back when starting work in a specific repo. The two are complementary: one writes, one reads.
 
-## Step 0: Resolve the clast binary
+## Step 0: Resolve the clast-plumbing binary
 
-Before running any `clast` command, determine which binary to use. Run this
-once at the start and reuse the result for all commands in this skill:
+This skill calls the deterministic core (`clast-plumbing`), not the
+LLM-aware porcelain (`clast`). Determine the binary to use once at the
+start and reuse the result for all commands in this skill:
 
 ```bash
-if [[ -n "${CLAUDE_PLUGIN_ROOT:-}" && -x "$CLAUDE_PLUGIN_ROOT/bin/clast" ]]; then
-  CLAST_BIN="$CLAUDE_PLUGIN_ROOT/bin/clast"
-elif command -v clast >/dev/null 2>&1; then
-  CLAST_BIN="clast"
+if [[ -n "${CLAUDE_PLUGIN_ROOT:-}" && -x "$CLAUDE_PLUGIN_ROOT/bin/clast-plumbing" ]]; then
+  CLAST_BIN="$CLAUDE_PLUGIN_ROOT/bin/clast-plumbing"
+elif command -v clast-plumbing >/dev/null 2>&1; then
+  CLAST_BIN="clast-plumbing"
 else
   _pdir="$(find ~/.claude -maxdepth 5 -name plugin.json -path '*/clast/.claude-plugin/*' -print -quit 2>/dev/null)"
   if [[ -n "$_pdir" ]]; then
-    CLAST_BIN="$(cd "$(dirname "$_pdir")/../.." && pwd)/bin/clast"
+    CLAST_BIN="$(cd "$(dirname "$_pdir")/../.." && pwd)/bin/clast-plumbing"
   fi
 fi
 ```
 
-If `CLAST_BIN` is still empty, tell the user: "clast CLI not found. Install it
-with `npm i -g @procrastivity/clast` or see the README for other options."
+If `CLAST_BIN` is still empty, tell the user: "clast-plumbing CLI not found.
+Install it with `npm i -g @procrastivity/clast` or see the README for other
+options."
 
-Use `$CLAST_BIN` in place of bare `clast` for all commands in this skill.
+Use `$CLAST_BIN` in place of bare `clast-plumbing` for all commands in this skill.
 
 ## Step 1: Resolve the project
 
-If the user passed a slug as an argument (`/wakeup xesapps`), use it directly. Otherwise resolve from current working directory:
+If the user passed a slug as an argument (`/brief xesapps`), use it directly. Otherwise resolve from current working directory:
 
 ```bash
 $CLAST_BIN registry resolve "$(pwd)"
 ```
 
-If `pwd` doesn't resolve and no slug was given: print "Not in a registered project. Run `clast registry add .` first, or invoke as `/wakeup <slug>`." and stop.
+If `pwd` doesn't resolve and no slug was given: print "Not in a registered project. Run `clast-plumbing registry add .` first, or invoke as `/brief <slug>`." and stop.
 
 ## Step 2: Gather data
 
@@ -71,7 +73,7 @@ $CLAST_BIN entries read <entry-path>
 Using the **synthesis prompt** (see below), produce a briefing of 2–5k tokens. Structure:
 
 ```
-## Wakeup briefing — <project>
+## Brief — <project>
 
 **Active thread:** <one-line from most recent entry's "Open threads" section, or "None">
 
@@ -99,11 +101,11 @@ End with one of:
 
 ## Step 4: Don't write anything
 
-Wakeup is read-only. Never invoke write-form subcommands (`entries write`, `breadcrumb '<text>'`, `snapshot`) from this skill.
+Brief is read-only. Never invoke write-form subcommands (`entries write`, `breadcrumb '<text>'`, `snapshot`) from this skill.
 
 ## Edge cases
 
-- **No entries for project**: print "No curated entries for `<slug>` yet. Run `/day-wakeup` to process recent sessions, or run `clast sessions --project <slug>` to see what's available." and stop.
+- **No entries for project**: print "No curated entries for `<slug>` yet. Run `/wake` to process recent sessions, or run `clast-plumbing sessions --project <slug>` to see what's available." and stop.
 - **Slug resolves but no entries and no sessions**: print "Project `<slug>` registered but has no journal activity yet."
 - **Today's session count > 5**: summarize ("worked 12 sessions today, most recent 16:22 on branch `loop-guard-ngram`") rather than listing all.
 

package/{.claude-plugin/skills/day-wakeup → skills/wake}/SKILL.md

@@ -1,40 +1,42 @@
 ---
-name: day-wakeup
-description: 'Generate curated journal entries from yesterday''s Claude Code sessions across all projects. Use when the user says "/day-wakeup", "day wakeup", "morning briefing", "catch me up on yesterday", "what did I work on yesterday", "review my day", "process yesterday''s sessions", or otherwise signals they want to curate prior work across projects at the start of a new day. Runs `clast snapshot` to ensure fresh data, then walks through each uncurated session from yesterday and proposes a draft entry the user can accept, edit, or skip. Prompts for promotion of decisions, common-issues, and workflows per accepted session. This is the once-per-day curation flow; for per-project briefings use /wakeup; for mid-session pivots use session-brief.'
+name: wake
+description: 'Generate curated journal entries from yesterday''s Claude Code sessions across all projects. Use when the user says "/wake", "wake", "morning briefing", "catch me up on yesterday", "what did I work on yesterday", "review my day", "process yesterday''s sessions", or otherwise signals they want to curate prior work across projects at the start of a new day. Runs `clast-plumbing snapshot` to ensure fresh data, then walks through each uncurated session from yesterday and proposes a draft entry the user can accept, edit, or skip. Prompts for promotion of decisions, common-issues, and workflows per accepted session. This is the once-per-day curation flow; for per-project briefings use /brief; for mid-session pivots use session-brief.'
 ---
 
-# Day Wakeup
+# Wake
 
 Process yesterday's Claude Code sessions across all projects. For each session, generate a draft journal entry and walk the user through accepting/editing/skipping it.
 
 ## Why this exists
 
-Curation at end-of-session has high friction (the user wants to stop, not summarize). Curation at start-of-next-day has lower friction (fresh eyes, easier to decide what's worth keeping). `/day-wakeup` is that start-of-next-day flow.
+Curation at end-of-session has high friction (the user wants to stop, not summarize). Curation at start-of-next-day has lower friction (fresh eyes, easier to decide what's worth keeping). `/wake` is that start-of-next-day flow.
 
-The transcripts themselves are captured automatically by the SessionStart hook + cron — the user never has to remember to log anything. What `/day-wakeup` does is **curate the captured transcripts into durable entries the user controls**, and prompt for promotion of decisions, common-issues, and workflows along the way.
+The transcripts themselves are captured automatically by the SessionStart hook + cron — the user never has to remember to log anything. What `/wake` does is **curate the captured transcripts into durable entries the user controls**, and prompt for promotion of decisions, common-issues, and workflows along the way.
 
-## Step 0: Resolve the clast binary
+## Step 0: Resolve the clast-plumbing binary
 
-Before running any `clast` command, determine which binary to use. Run this
-once at the start and reuse the result for all commands in this skill:
+This skill calls the deterministic core (`clast-plumbing`), not the
+LLM-aware porcelain (`clast`). Determine the binary to use once at the
+start and reuse the result for all commands in this skill:
 
 ```bash
-if [[ -n "${CLAUDE_PLUGIN_ROOT:-}" && -x "$CLAUDE_PLUGIN_ROOT/bin/clast" ]]; then
-  CLAST_BIN="$CLAUDE_PLUGIN_ROOT/bin/clast"
-elif command -v clast >/dev/null 2>&1; then
-  CLAST_BIN="clast"
+if [[ -n "${CLAUDE_PLUGIN_ROOT:-}" && -x "$CLAUDE_PLUGIN_ROOT/bin/clast-plumbing" ]]; then
+  CLAST_BIN="$CLAUDE_PLUGIN_ROOT/bin/clast-plumbing"
+elif command -v clast-plumbing >/dev/null 2>&1; then
+  CLAST_BIN="clast-plumbing"
 else
   _pdir="$(find ~/.claude -maxdepth 5 -name plugin.json -path '*/clast/.claude-plugin/*' -print -quit 2>/dev/null)"
   if [[ -n "$_pdir" ]]; then
-    CLAST_BIN="$(cd "$(dirname "$_pdir")/../.." && pwd)/bin/clast"
+    CLAST_BIN="$(cd "$(dirname "$_pdir")/../.." && pwd)/bin/clast-plumbing"
   fi
 fi
 ```
 
-If `CLAST_BIN` is still empty, tell the user: "clast CLI not found. Install it
-with `npm i -g @procrastivity/clast` or see the README for other options."
+If `CLAST_BIN` is still empty, tell the user: "clast-plumbing CLI not found.
+Install it with `npm i -g @procrastivity/clast` or see the README for other
+options."
 
-Use `$CLAST_BIN` in place of bare `clast` for all commands in this skill.
+Use `$CLAST_BIN` in place of bare `clast-plumbing` for all commands in this skill.
 
 ## Step 1: Ensure fresh data
 
@@ -56,6 +58,27 @@ $CLAST_BIN --json sessions --since -30d
 
 Filter to sessions with `curated: false` or `stale: true` (stale sessions were curated but their transcript was updated since). If none remain, print "Nothing to curate — all sessions are curated or dismissed." and stop.
 
+### Step 2a: Auto-dismiss no-op sessions (deterministic, no LLM)
+
+Each session row carries a deterministic `substantive` flag (computed by
+`clast-plumbing` from the transcript, cached at snapshot time). A session is
+`substantive: false` when **Claude never replied** — an empty session, one that
+contains only slash commands like `/clear`, `/model`, `/config`, or one abandoned
+before any response. These are worthless to curate. (A session driven by a *custom*
+slash command still has assistant replies, so it stays `substantive: true`.)
+
+Before generating any drafts, auto-dismiss every uncurated session with
+`substantive == false` (skip this if the user set `CLAST_WAKE_AUTODISMISS_NOOP=0`):
+
+```bash
+$CLAST_BIN sessions dismiss <session-id> --reason "auto: no substantive content (empty / slash-command-only)"
+```
+
+Do **not** call the LLM for these. Dismissal is reversible via `clast undismiss <id>`.
+Remove them from the working set, keep a count, and report it in the final summary
+(e.g. "Auto-dismissed 5 no-op session(s)."). If nothing substantive remains after this,
+print "Nothing to curate — all remaining sessions were empty or slash-command-only." and stop.
+
 ### Triage when multiple days have uncurated sessions
 
 If uncurated sessions span more than one day (e.g., after a weekend or break), present a triage step before processing. Show a per-day breakdown:
@@ -108,18 +131,19 @@ For each session in the list:
 5. Present the **promotion question** (see below) via AskUserQuestion.
 
 6. Handle the response:
-   - **Accept** (any combination of accept-flavored options): pipe the draft to `clast entries write` via stdin.
+   - **Accept** (any combination of accept-flavored options): pipe the draft to `clast-plumbing entries write` via stdin.
    - **Edit**: prompt the user for what to change, regenerate the draft incorporating their feedback, loop.
    - **Skip**: do not write.
-   - **Stop here**: end the entire `/day-wakeup` flow, leaving remaining sessions uncurated (user can resume tomorrow).
+   - **Stop here**: end the entire `/wake` flow, leaving remaining sessions uncurated (user can resume tomorrow).
 
 ## Step 4: Final summary
 
 After all sessions are processed (or user stopped early), print a summary:
 
 ```
-Day wakeup complete.
+Wake complete.
 Curated: 3 sessions across 2 projects.
+Auto-dismissed (no-op): 5 sessions.
 Skipped: 1 session.
 Remaining uncurated: 0.
 
@@ -128,15 +152,15 @@ Promoted:
   Common-issues: 0
   Workflows: 1
 
-Run `/wakeup <project>` to start working on a specific project today.
+Run `/brief <project>` to start working on a specific project today.
 ```
 
 ## Draft generation prompt
 
-The prompt templates live in `lib/clast/prompts/` so they are shared with the standalone `clast-wake` script:
+The prompt templates are installed alongside the plugin under `$CLAUDE_PLUGIN_ROOT/lib/clast/prompts/`:
 
-- **System prompt:** `lib/clast/prompts/day-wakeup-draft-system.md`
-- **User prompt template:** `lib/clast/prompts/day-wakeup-draft-user.md` (uses `{{placeholder}}` syntax)
+- **System prompt:** `$CLAUDE_PLUGIN_ROOT/lib/clast/prompts/wake-draft-system.md`
+- **User prompt template:** `$CLAUDE_PLUGIN_ROOT/lib/clast/prompts/wake-draft-user.md` (uses `{{placeholder}}` syntax)
 
 When generating each draft, read those files and substitute the placeholders with session data. The user prompt template uses these placeholders: `{{project}}`, `{{branch}}`, `{{start}}`, `{{end}}`, `{{msg_count}}`, `{{first_turns}}`, `{{last_turns}}`, `{{breadcrumbs}}`.
 
@@ -154,7 +178,7 @@ After showing the draft, present:
   - `Accept + promote workflow` — also write a workflow file
   - `Edit` — user wants to revise; will prompt for changes
   - `Skip` — do not write this entry
-  - `Stop here` — end /day-wakeup entirely, leave remaining sessions uncurated
+  - `Stop here` — end /wake entirely, leave remaining sessions uncurated
 
 If `Skip` and `Stop here` are both selected, treat as `Stop here`. If `Edit` is selected alongside any accept option, treat as `Edit` first (the user wants to revise before accepting).
 
@@ -175,7 +199,7 @@ If the user selects `Edit`:
 When the user accepts:
 
 1. Extract the suggested tags from the draft (the user may have edited them).
-2. Pipe the entry body (without the suggested-tags trailer) to `clast entries write`:
+2. Pipe the entry body (without the suggested-tags trailer) to `clast-plumbing entries write`:
 
 ```bash
 $CLAST_BIN entries write \
@@ -190,14 +214,15 @@ $CLAST_BIN entries write \
 
 3. If the write succeeds, append a one-line confirmation to the running summary.
 
-For promoted items (decisions, common-issues, workflows): currently these are tracked inside the entry's body for v1. **TODO for v1.1: separate `clast decisions write` / `clast common-issues write` / `clast workflows write` subcommands and a directory structure to match.** Note this in the user-facing summary so the user knows they're folded into the entry for now.
+For promoted items (decisions, common-issues, workflows): currently these are tracked inside the entry's body for v1. **TODO for v1.1: separate `clast-plumbing decisions write` / `clast-plumbing common-issues write` / `clast-plumbing workflows write` subcommands and a directory structure to match.** Note this in the user-facing summary so the user knows they're folded into the entry for now.
 
-<!-- step-12 addition: v1 promotion section convention --> When folding promoted items into the accepted entry body, append `## Decision`, `## Common issue`, or `## Workflow` (h2, singular, capitalized), each followed by the prompted-for title (h3) and body before invoking `clast entries write`.
+<!-- step-12 addition: v1 promotion section convention --> When folding promoted items into the accepted entry body, append `## Decision`, `## Common issue`, or `## Workflow` (h2, singular, capitalized), each followed by the prompted-for title (h3) and body before invoking `clast-plumbing entries write`.
 
 ## Edge cases
 
 - **No uncurated sessions**: print "Nothing to curate — all sessions are curated or dismissed." and stop.
+- **All uncurated sessions are no-ops**: after Step 2a auto-dismisses them, nothing substantive remains — print "Nothing to curate — all remaining sessions were empty or slash-command-only." and stop.
 - **Multi-day backlog**: present the triage step (Step 2) so the user can choose scope before processing.
-- **`clast snapshot` fails**: warn the user, then attempt to proceed with whatever's already in the manifest.
-- **`clast show` fails for a specific session**: skip that session, note it in the final summary, continue with the rest.
+- **`clast-plumbing snapshot` fails**: warn the user, then attempt to proceed with whatever's already in the manifest.
+- **`clast-plumbing show` fails for a specific session**: skip that session, note it in the final summary, continue with the rest.
 - **User says "do them all without prompting"**: not a v1 feature. Each session gets its own AskUserQuestion. The friction is intentional — it's where curation happens.

package/bin/clast-brief

@@ -1,305 +0,0 @@
-#!/usr/bin/env bash
-# clast-brief — LLM-powered project briefing without Claude Code.
-#
-# Replicates the /wakeup plugin skill using an OpenAI-compatible
-# chat completions endpoint. Reads curated entries, breadcrumbs,
-# and today's sessions for a project, then synthesizes a briefing.
-#
-# Usage: clast-brief [<project-slug>]
-#
-# If no slug is given, resolves from the current working directory.
-#
-# Required env vars:
-#   CLAST_LLM_BASE_URL  — e.g. https://api.openai.com/v1
-#   CLAST_LLM_API_KEY   — bearer token
-#   CLAST_LLM_MODEL     — e.g. gpt-4o, llama3
-set -euo pipefail
-
-CLAST_BRIEF_DIR="$(cd "$(dirname "$(realpath "$0")")/.." && pwd)"
-
-# ── Helpers ──────────────────────────────────────────────────────────
-
-die() { printf 'clast-brief: %s\n' "$1" >&2; exit "${2:-1}"; }
-warn() { printf 'clast-brief: warning: %s\n' "$1" >&2; }
-info() { printf '%s\n' "$1"; }
-
-# ── Preflight ────────────────────────────────────────────────────────
-
-preflight() {
-  for tool in clast curl jq; do
-    if ! command -v "$tool" >/dev/null 2>&1; then
-      die "required tool not found: $tool"
-    fi
-  done
-
-  local missing=0
-  if [[ -z "${CLAST_LLM_BASE_URL:-}" ]]; then
-    warn "CLAST_LLM_BASE_URL not set"; missing=1
-  fi
-  if [[ -z "${CLAST_LLM_API_KEY:-}" ]]; then
-    warn "CLAST_LLM_API_KEY not set"; missing=1
-  fi
-  if [[ -z "${CLAST_LLM_MODEL:-}" ]]; then
-    warn "CLAST_LLM_MODEL not set"; missing=1
-  fi
-
-  if (( missing )); then
-    cat >&2 <<'EOF'
-
-Set these env vars before running clast-brief:
-
-  export CLAST_LLM_BASE_URL="https://api.openai.com/v1"
-  export CLAST_LLM_API_KEY="sk-..."
-  export CLAST_LLM_MODEL="gpt-4o"
-
-Or for a local model (ollama, vllm, etc.):
-
-  export CLAST_LLM_BASE_URL="http://localhost:11434/v1"
-  export CLAST_LLM_API_KEY="unused"
-  export CLAST_LLM_MODEL="llama3"
-EOF
-    exit 1
-  fi
-}
-
-# ── LLM call ─────────────────────────────────────────────────────────
-
-llm_chat() {
-  local system_msg="$1"
-  local user_msg="$2"
-
-  local payload
-  payload="$(jq -cn \
-    --arg model "$CLAST_LLM_MODEL" \
-    --arg system "$system_msg" \
-    --arg user "$user_msg" \
-    '{
-      model: $model,
-      messages: [
-        {role: "system", content: $system},
-        {role: "user", content: $user}
-      ],
-      temperature: 0.3
-    }')"
-
-  local response http_code body
-  response="$(curl -s -w '\n%{http_code}' \
-    "${CLAST_LLM_BASE_URL}/chat/completions" \
-    -H "Authorization: Bearer $CLAST_LLM_API_KEY" \
-    -H "Content-Type: application/json" \
-    -d "$payload" 2>&1)" || true
-
-  http_code="$(tail -n1 <<<"$response")"
-  body="$(sed '$d' <<<"$response")"
-
-  if [[ "$http_code" != "200" ]]; then
-    warn "LLM API returned HTTP $http_code"
-    if [[ -n "$body" ]]; then
-      local err_msg
-      err_msg="$(jq -r '.error.message // .error // .' <<<"$body" 2>/dev/null || echo "$body")"
-      warn "$err_msg"
-    fi
-    return 1
-  fi
-
-  local content
-  content="$(jq -r '.choices[0].message.content // empty' <<<"$body" 2>/dev/null)" || {
-    warn "failed to parse LLM response"
-    return 1
-  }
-
-  if [[ -z "$content" ]]; then
-    warn "LLM returned empty content"
-    return 1
-  fi
-
-  printf '%s' "$content"
-}
-
-# ── Prompt template ──────────────────────────────────────────────────
-
-resolve_prompt_dir() {
-  local dir="$CLAST_BRIEF_DIR/lib/clast/prompts"
-  if [[ -d "$dir" ]]; then
-    printf '%s' "$dir"
-    return
-  fi
-  local installed
-  for installed in /usr/local/lib/clast/prompts "$HOME/.local/lib/clast/prompts"; do
-    if [[ -d "$installed" ]]; then
-      printf '%s' "$installed"
-      return
-    fi
-  done
-  die "cannot find prompts directory (checked $dir and install paths)"
-}
-
-load_system_prompt() {
-  local prompt_dir
-  prompt_dir="$(resolve_prompt_dir)"
-  local file="$prompt_dir/brief-system.md"
-  if [[ ! -r "$file" ]]; then
-    die "system prompt not found: $file"
-  fi
-  cat "$file"
-}
-
-build_user_prompt() {
-  local project="$1" entries="$2" breadcrumbs="$3" sessions="$4"
-
-  local prompt_dir
-  prompt_dir="$(resolve_prompt_dir)"
-  local template_file="$prompt_dir/brief-user.md"
-
-  if [[ -r "$template_file" ]]; then
-    local template
-    template="$(cat "$template_file")"
-    template="${template//\{\{project\}\}/${project}}"
-    template="${template//\{\{entries\}\}/${entries:-None.}}"
-    template="${template//\{\{breadcrumbs\}\}/${breadcrumbs:-None.}}"
-    template="${template//\{\{sessions\}\}/${sessions:-None.}}"
-    printf '%s' "$template"
-  else
-    warn "user prompt template not found: $template_file — using inline fallback"
-    cat <<EOF
-Project: ${project}
-
-Recent curated entries (newest first):
-${entries:-None.}
-
-Today's breadcrumbs for this project:
-${breadcrumbs:-None.}
-
-Today's session activity for this project:
-${sessions:-None.}
-EOF
-  fi
-}
-
-# ── Resolve project ──────────────────────────────────────────────────
-
-resolve_project() {
-  local slug="${1:-}"
-
-  if [[ -n "$slug" ]]; then
-    printf '%s' "$slug"
-    return
-  fi
-
-  local resolved
-  resolved="$(clast registry resolve "$(pwd)" 2>/dev/null)" || true
-  if [[ -n "$resolved" ]]; then
-    printf '%s' "$resolved"
-    return
-  fi
-
-  die "Not in a registered project. Run \`clast registry add .\` first, or invoke as \`clast-brief <slug>\`."
-}
-
-# ── Gather data ──────────────────────────────────────────────────────
-
-gather_entries() {
-  local project="$1"
-  local entries_json
-  entries_json="$(clast --json entries --project "$project" --limit 5 2>/dev/null)" || true
-
-  if [[ -z "$entries_json" ]] || [[ "$(jq 'length' <<<"$entries_json" 2>/dev/null)" == "0" ]]; then
-    return
-  fi
-
-  local n i entry_meta entry_path entry_body result=""
-  n="$(jq 'length' <<<"$entries_json")"
-
-  for (( i = 0; i < n; i++ )); do
-    entry_meta="$(jq -c ".[$i]" <<<"$entries_json")"
-    entry_path="$(jq -r '.path' <<<"$entry_meta")"
-
-    entry_body="$(clast entries read "$entry_path" 2>/dev/null)" || true
-    if [[ -z "$entry_body" ]]; then
-      local title date
-      title="$(jq -r '.title // "untitled"' <<<"$entry_meta")"
-      date="$(jq -r '.date' <<<"$entry_meta")"
-      entry_body="# $date — $title (body not available)"
-    fi
-
-    if [[ -n "$result" ]]; then
-      result="${result}
-
----
-
-"
-    fi
-    result="${result}${entry_body}"
-  done
-
-  printf '%s' "$result"
-}
-
-gather_breadcrumbs() {
-  local project="$1"
-  clast breadcrumb --read --project "$project" --day today 2>/dev/null || true
-}
-
-gather_sessions() {
-  local project="$1"
-  local sessions_json
-  sessions_json="$(clast --json sessions --day today --project "$project" 2>/dev/null)" || true
-
-  if [[ -z "$sessions_json" ]] || [[ "$(jq 'length' <<<"$sessions_json" 2>/dev/null)" == "0" ]]; then
-    return
-  fi
-
-  local n
-  n="$(jq 'length' <<<"$sessions_json")"
-
-  if (( n > 5 )); then
-    local latest_start
-    latest_start="$(jq -r 'sort_by(.start) | last | .start // ""' <<<"$sessions_json")"
-    printf 'Worked %d sessions today, most recent at %s.' "$n" "${latest_start:11:5}"
-    return
-  fi
-
-  jq -r '
-    sort_by(.start) | .[] |
-    "\(.start[11:16]) start: \(if .branch and .branch != "null" then .branch else "no branch" end), \(.msg_count_approx) messages"
-  ' <<<"$sessions_json" 2>/dev/null || true
-}
-
-# ── Main ─────────────────────────────────────────────────────────────
-
-main() {
-  preflight
-
-  local project
-  project="$(resolve_project "${1:-}")"
-  info "Briefing for project: $project"
-
-  info "Gathering context..."
-
-  local entries breadcrumbs sessions
-  entries="$(gather_entries "$project")"
-  breadcrumbs="$(gather_breadcrumbs "$project")"
-  sessions="$(gather_sessions "$project")"
-
-  if [[ -z "$entries" && -z "$breadcrumbs" && -z "$sessions" ]]; then
-    info "No curated entries, breadcrumbs, or sessions for \`$project\`."
-    info "Run \`clast-wake\` to curate recent sessions first, or run \`clast sessions --project $project\` to see what's available."
-    exit 0
-  fi
-
-  local system_prompt user_prompt
-  system_prompt="$(load_system_prompt)"
-  user_prompt="$(build_user_prompt "$project" "$entries" "$breadcrumbs" "$sessions")"
-
-  info "Synthesizing briefing..."
-  printf '\n'
-
-  local briefing
-  if ! briefing="$(llm_chat "$system_prompt" "$user_prompt")"; then
-    die "LLM call failed"
-  fi
-
-  printf '%s\n' "$briefing"
-}
-
-main "$@"