@procrastivity/clast 0.0.2 → 0.0.4

package/lib/clast/clast-subcommands/projects.bash

@@ -145,8 +145,14 @@ clast_cmd_projects() {
 
     seg_session_count["$seg"]=$(( ${seg_session_count["$seg"]:-0} + 1 ))
 
+    # Prefer cached msg_count on the manifest line (step 21); fall back to
+    # counting transcript lines for legacy lines that predate the cache.
     abs_path="$journal_dir/$snapshot"
-    if [[ -r "$abs_path" ]]; then
+    local cached_msgs
+    cached_msgs="$(jq -r '.msg_count // empty' <<<"$line")"
+    if [[ -n "$cached_msgs" ]]; then
+      msgs="$cached_msgs"
+    elif [[ -r "$abs_path" ]]; then
       msgs="$(wc -l <"$abs_path" 2>/dev/null | tr -d ' ')"
       [[ -z "$msgs" ]] && msgs=0
     else

package/lib/clast/clast-subcommands/sessions.bash

@@ -207,32 +207,60 @@ clast_cmd_sessions() {
       | jq -r --arg s "$project_filter" '.[] | select(.slug == $s) | .path')
   fi
 
-  # Most-recent manifest line per session_id within window.
-  declare -A latest_line=()
-  local line sid
-  while IFS= read -r line; do
-    [[ -z "$line" ]] && continue
-    sid="$(jq -r '.session_id' <<<"$line")"
-    [[ -z "$sid" || "$sid" == "null" ]] && continue
-    # Skip dismissed sessions early to avoid unnecessary work.
-    if [[ -n "${dismissed_ids[$sid]:-}" ]]; then
-      continue
-    fi
-    latest_line["$sid"]="$line"
-  done < <(clast_manifest_iterate "$filter")
+  local manifest_path
+  manifest_path="$(clast_manifest_path)"
 
-  local -a rows=()
-  local snapshot day_bucket mtime seg abs_path msgs
-  local first_ts last_ts start_ts end_ts curated branch slug
   local entries_dir
   entries_dir="$journal_dir/entries"
 
-  for sid in "${!latest_line[@]}"; do
-    line="${latest_line[$sid]}"
-    snapshot="$(jq -r '.snapshot' <<<"$line")"
-    day_bucket="$(jq -r '.day_bucket' <<<"$line")"
-    mtime="$(jq -r '.source_mtime' <<<"$line")"
-    seg="$(awk -F/ 'NR==1{print $3}' <<<"$snapshot")"
+  # Curated/stale index: scan every entry file ONCE up front instead of
+  # grepping the entries dir per session (the old approach was
+  # O(sessions × entries)). `curated_seen[sid]` marks a session as curated;
+  # `curated_mtime[sid]` holds the max curated_source_mtime across its
+  # entries ("" when none carry one — legacy entries then stay non-stale).
+  declare -A curated_seen=() curated_mtime=()
+  if [[ -d "$entries_dir" ]] && compgen -G "$entries_dir/*.md" >/dev/null 2>&1; then
+    local idx_sid idx_cm
+    while IFS=$'\t' read -r idx_sid idx_cm; do
+      [[ -z "$idx_sid" ]] && continue
+      curated_seen["$idx_sid"]=1
+      if [[ -n "$idx_cm" ]]; then
+        if [[ -z "${curated_mtime[$idx_sid]:-}" || "$idx_cm" > "${curated_mtime[$idx_sid]}" ]]; then
+          curated_mtime["$idx_sid"]="$idx_cm"
+        fi
+      fi
+    done < <(awk '
+      function flush() { if (sid != "") { print sid "\t" cm } sid=""; cm="" }
+      FNR==1 && NR>1 { flush() }
+      /^session_id:/           { v=$0; sub(/^session_id:[[:space:]]*/, "", v); sid=v }
+      /^curated_source_mtime:/ { v=$0; sub(/^curated_source_mtime:[[:space:]]*/, "", v); gsub(/"/, "", v); cm=v }
+      END { flush() }
+    ' "$entries_dir"/*.md 2>/dev/null)
+  fi
+
+  # Most-recent manifest line per session_id within window, in a SINGLE jq
+  # pass. Previously this forked one jq per manifest line plus several more
+  # per session; for large manifests that dominated runtime. The reduce keeps
+  # the last line seen per session_id (manifest is append-only, so last =
+  # most recent). Emits @tsv columns: session_id, snapshot, day_bucket,
+  # source_mtime.
+  local -a rows=()
+  local sid snapshot day_bucket mtime seg abs_path msgs
+  local cached_msgs cached_first cached_last
+  local first_ts last_ts start_ts end_ts curated stale branch slug
+  declare -A seg_slug=()
+
+  while IFS=$'\t' read -r sid snapshot day_bucket mtime cached_msgs cached_first cached_last; do
+    [[ -z "$sid" ]] && continue
+    # Skip dismissed sessions early, before any per-session file work.
+    if [[ -n "${dismissed_ids[$sid]:-}" ]]; then
+      continue
+    fi
+
+    # segment = third path component of transcripts/<day>/<segment>/<uuid>.
+    seg="${snapshot#transcripts/}"   # <day>/<segment>/<uuid>.jsonl
+    seg="${seg#*/}"                  # <segment>/<uuid>.jsonl
+    seg="${seg%%/*}"                 # <segment>
 
     if (( have_project_filter == 1 )); then
       if [[ -z "${allowed_segs[$seg]:-}" ]]; then
@@ -241,7 +269,15 @@ clast_cmd_sessions() {
     fi
 
     abs_path="$journal_dir/$snapshot"
-    if [[ -r "$abs_path" ]]; then
+    if [[ -n "$cached_msgs" ]]; then
+      # Cache hit (step 21): the manifest line carries msg_count/first_ts/
+      # last_ts, so we never open the transcript. Empty cached_first/last
+      # means the cached value was JSON null (no first/last timestamp).
+      msgs="$cached_msgs"
+      first_ts="$cached_first"
+      last_ts="$cached_last"
+    elif [[ -r "$abs_path" ]]; then
+      # Legacy line (pre-cache): fall back to reading the transcript.
       msgs="$(wc -l <"$abs_path" 2>/dev/null | tr -d ' ')"
       [[ -z "$msgs" ]] && msgs=0
       first_ts="$(head -n1 "$abs_path" 2>/dev/null | jq -r '.timestamp // empty' 2>/dev/null || true)"
@@ -257,35 +293,30 @@ clast_cmd_sessions() {
     start_ts="${first_ts:-$mtime}"
     end_ts="${last_ts:-$mtime}"
 
-    if slug="$(clast_registry_resolve "$seg" 2>/dev/null)" && [[ -n "$slug" ]]; then
-      :
+    # Resolve the slug once per unique segment (segments repeat heavily
+    # across sessions; each resolve forks several jq calls).
+    if [[ -n "${seg_slug[$seg]+x}" ]]; then
+      slug="${seg_slug[$seg]}"
     else
-      slug="$seg"
+      if slug="$(clast_registry_resolve "$seg" 2>/dev/null)" && [[ -n "$slug" ]]; then
+        :
+      else
+        slug="$seg"
+      fi
+      seg_slug["$seg"]="$slug"
     fi
 
     # TODO(step-10): branch field is best-effort; revisit when stats command lands.
     branch=""
 
+    # Curated/stale from the prebuilt index (no per-session grep).
     curated=false
-    local stale=false
-    if [[ -d "$entries_dir" ]]; then
-      local entry_matches
-      entry_matches="$(grep -l "session_id: $sid" "$entries_dir"/*.md 2>/dev/null)" || true
-      if [[ -n "$entry_matches" ]]; then
-        curated=true
-        local best_curated_mtime="" ef cm
-        while IFS= read -r ef; do
-          [[ -z "$ef" ]] && continue
-          cm="$(grep '^curated_source_mtime:' "$ef" 2>/dev/null | head -n1 | sed 's/^curated_source_mtime:[[:space:]]*//')" || true
-          cm="${cm#\"}"
-          cm="${cm%\"}"
-          if [[ -n "$cm" && ( -z "$best_curated_mtime" || "$cm" > "$best_curated_mtime" ) ]]; then
-            best_curated_mtime="$cm"
-          fi
-        done <<<"$entry_matches"
-        if [[ -n "$best_curated_mtime" && "$best_curated_mtime" != "$mtime" ]]; then
-          stale=true
-        fi
+    stale=false
+    if [[ -n "${curated_seen[$sid]:-}" ]]; then
+      curated=true
+      local best_curated_mtime="${curated_mtime[$sid]:-}"
+      if [[ -n "$best_curated_mtime" && "$best_curated_mtime" != "$mtime" ]]; then
+        stale=true
       fi
     fi
 
@@ -321,11 +352,25 @@ clast_cmd_sessions() {
          stale: $stale,
          dismissed: $dismissed
        }')")
-  done
+  done < <(
+    if [[ -f "$manifest_path" ]]; then
+      jq -rRn '
+        reduce (inputs | fromjson?
+                | select('"$filter"')
+                | select(.session_id != null and .session_id != "")) as $l
+          ({}; .[$l.session_id] = $l)
+        | to_entries[] | .value
+        | [.session_id, .snapshot, .day_bucket, .source_mtime,
+           .msg_count, .first_ts, .last_ts] | @tsv
+      ' "$manifest_path"
+    fi
+  )
 
   local rows_json='[]'
   if (( ${#rows[@]} > 0 )); then
-    rows_json="$(printf '%s\n' "${rows[@]}" | jq -cs 'sort_by(.start)')"
+    # Tiebreak on session_id so the order is deterministic when sessions
+    # share a start timestamp (the old assoc-array iteration order was not).
+    rows_json="$(printf '%s\n' "${rows[@]}" | jq -cs 'sort_by(.start, .session_id)')"
   fi
 
   if [[ -n "${CLAST_JSON:-}" ]]; then

package/lib/clast/clast-subcommands/show.bash

@@ -94,11 +94,22 @@ clast_cmd_show() {
     slug="$seg"
   fi
 
+  # Prefer the cached metadata on the manifest line (step 21); fall back to
+  # reading the transcript for legacy lines that predate the cache.
   local msgs first_ts last_ts start_ts end_ts
-  msgs="$(wc -l <"$abs_path" 2>/dev/null | tr -d ' ')"
-  [[ -z "$msgs" ]] && msgs=0
-  first_ts="$(head -n1 "$abs_path" 2>/dev/null | jq -r '.timestamp // empty' 2>/dev/null || true)"
-  last_ts="$(tail -n1 "$abs_path" 2>/dev/null | jq -r '.timestamp // empty' 2>/dev/null || true)"
+  local cached_msgs cached_first cached_last
+  IFS=$'\t' read -r cached_msgs cached_first cached_last \
+    < <(jq -r '[(.msg_count // ""), (.first_ts // ""), (.last_ts // "")] | @tsv' <<<"$line")
+  if [[ -n "$cached_msgs" ]]; then
+    msgs="$cached_msgs"
+    first_ts="$cached_first"
+    last_ts="$cached_last"
+  else
+    msgs="$(wc -l <"$abs_path" 2>/dev/null | tr -d ' ')"
+    [[ -z "$msgs" ]] && msgs=0
+    first_ts="$(head -n1 "$abs_path" 2>/dev/null | jq -r '.timestamp // empty' 2>/dev/null || true)"
+    last_ts="$(tail -n1 "$abs_path" 2>/dev/null | jq -r '.timestamp // empty' 2>/dev/null || true)"
+  fi
   start_ts="${first_ts:-$source_mtime}"
   end_ts="${last_ts:-$source_mtime}"
 
@@ -224,7 +235,7 @@ clast_cmd_show() {
 _clast_show_user_messages() {
   local path="$1"
   jq -r '
-    select((.role // .message.role) == "user")
+    select((.role // .message.role // .type) == "user")
     | (.message.content // .content // empty)
     | if type == "array" then map(.text? // "") | join(" ") else . end
     | select(. != null and . != "")
@@ -237,9 +248,9 @@ _clast_show_collect_turns() {
   local path="$1"
   jq -sc '
     map(
-      select((.role // .message.role) as $r | $r == "user" or $r == "assistant")
+      select((.role // .message.role // .type) as $r | $r == "user" or $r == "assistant")
       | {
-          role: (.role // .message.role),
+          role: (.role // .message.role // .type),
           text: ((.message.content // .content // "") | if type == "array" then map(.text? // "") | join(" ") else . end)
         }
       | select(.text != null and .text != "")

package/lib/clast/clast-subcommands/snapshot.bash

@@ -117,7 +117,7 @@ clast_cmd_snapshot() {
   # TODO(v1.1): parallel capture across segments.
   if [[ -d "$projects_dir" ]]; then
     local source segment session_id mtime_epoch mtime_iso source_size
-    local first_ts ts_epoch day_bucket
+    local first_ts ts_epoch day_bucket last_ts msg_count
     local dest_rel dest dest_dir tmp
     while IFS= read -r -d '' source; do
       segment="$(basename "$(dirname "$source")")"
@@ -163,6 +163,16 @@ clast_cmd_snapshot() {
         day_bucket="$(_clast_snapshot_bucket_for_epoch "$mtime_epoch")"
       fi
 
+      # Cache per-session metadata in the manifest (step 21) so readers
+      # don't re-open the transcript. msg_count uses wc -l semantics to
+      # match the readers' file-read fallback exactly; last_ts mirrors the
+      # existing first_ts extraction. Kept as separate reads (not a fused
+      # awk pass) to avoid the trailing-newline parsing hazard and because
+      # snapshot is a batch path where the extra forks are negligible.
+      last_ts="$(tail -n1 "$source" 2>/dev/null | jq -r '.timestamp // empty' 2>/dev/null || true)"
+      msg_count="$(wc -l <"$source" 2>/dev/null | tr -d ' ')"
+      [[ "$msg_count" =~ ^[0-9]+$ ]] || msg_count=0
+
       # Dedup on (session_id, source_mtime). Mtime — not ctime or size —
       # is the manifest's "most recent line wins" key; Claude Code's
       # writer bumps mtime whenever a session grows.
@@ -199,7 +209,7 @@ clast_cmd_snapshot() {
         # Invariant: a manifest line implies the dest file exists. If the
         # append fails the dest is an orphan; doctor (step 10) will reap
         # it, and a re-run of snapshot overwrites + retries the append.
-        if ! clast_manifest_append "$session_id" "$source" "$dest_rel" "$mtime_iso" "$source_size" "$day_bucket"; then
+        if ! clast_manifest_append "$session_id" "$source" "$dest_rel" "$mtime_iso" "$source_size" "$day_bucket" "$msg_count" "$first_ts" "$last_ts"; then
           error_lines+=("$(jq -cn --arg f "$source" --arg r "manifest append failed" '{file:$f,reason:$r}')")
           continue
         fi

package/lib/clast/clast-subcommands/stats.bash

@@ -244,8 +244,13 @@ clast_cmd_stats() {
     [[ "$size" =~ ^[0-9]+$ ]] || size=0
     bytes_sum=$((bytes_sum + size))
 
-    local abs="$journal_dir/$snapshot" m=0
-    if [[ -r "$abs" ]]; then
+    # Prefer cached msg_count on the manifest line (step 21); fall back to
+    # counting transcript lines for legacy lines that predate the cache.
+    local abs="$journal_dir/$snapshot" m=0 cached_m
+    cached_m="$(jq -r '.msg_count // empty' <<<"$row")"
+    if [[ -n "$cached_m" ]]; then
+      m="$cached_m"
+    elif [[ -r "$abs" ]]; then
       m="$(wc -l <"$abs" 2>/dev/null | tr -d ' ')"
       [[ -z "$m" ]] && m=0
     fi

package/lib/clast/prompts/day-wakeup-draft-system.md

@@ -26,3 +26,4 @@ One sentence describing what this session was trying to accomplish.
 Be concise. Prefer bullets over paragraphs. Use the user's terminology (project-specific names, file paths). Do not invent details. If you are uncertain about something, omit it rather than guess.
 
 After the entry, add a blank line and then: "Suggested tags: tag1, tag2, tag3"
+Tags must be lowercase kebab-case (regex: `^[a-z0-9][a-z0-9-]{0,31}$`). Examples: `adrs`, `symfony-bot`, `mr-umbrella`, `phase-0`. Never use uppercase letters.

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@procrastivity/clast",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "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": "bin/clast",
+    "clast-plumbing": "bin/clast-plumbing"
   },
   "files": [
     "bin/",

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 "$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 "$@"