@procrastivity/clast 0.0.6 → 0.0.8

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "clast",
-  "version": "0.1.0",
+  "version": "0.0.8",
   "description": "Capture, curate, and surface Claude Code session history across all your projects.",
   "homepage": "https://github.com/procrastivity/clast",
   "author": {

package/hooks/hooks.json

@@ -1,8 +1,14 @@
 {
-  "hooks": [
-    {
-      "event": "SessionStart",
-      "command": "${CLAUDE_PLUGIN_ROOT}/hooks/snapshot.sh"
-    }
-  ]
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/snapshot.sh"
+          }
+        ]
+      }
+    ]
+  }
 }

package/lib/clast/clast-porcelain-lib.bash

@@ -21,6 +21,27 @@ clast_porcelain_info() { printf '%s\n' "$1"; }
 
 clast_porcelain_log_error() { printf 'clast: error: %s\n' "$1" >&2; }
 
+# --- Timing ------------------------------------------------------------------
+#
+# Shared by the porcelain subcommands that time model calls (wake, retro) so
+# their progress output stays consistent.
+
+# clast_porcelain_now — epoch seconds with fraction (GNU date). Falls back to
+# whole seconds where `%N` is unsupported (e.g. BSD/macOS date echoes a literal
+# N). Pair two readings with clast_porcelain_elapsed.
+clast_porcelain_now() {
+  local t
+  t="$(date +%s.%N 2>/dev/null)" || t="$(date +%s)"
+  [[ "$t" == *N* ]] && t="$(date +%s)"
+  printf '%s' "$t"
+}
+
+# clast_porcelain_elapsed <start> <end> — seconds between two clast_porcelain_now
+# readings, one decimal place (never negative).
+clast_porcelain_elapsed() {
+  awk -v a="$1" -v b="$2" 'BEGIN { d = b - a; if (d < 0) d = 0; printf "%.1f", d }'
+}
+
 # --- Version / usage ---------------------------------------------------------
 
 # Reuses the plumbing's clast_version helper if available (loaded by sourcing

package/lib/clast/clast-porcelain-subcommands/retro.bash

@@ -46,21 +46,6 @@ _clast_retro_progress() {
   fi
 }
 
-# _clast_retro_now — epoch seconds with fraction (GNU date). Falls back to whole
-# seconds where `%N` is unsupported (e.g. BSD/macOS date echoes a literal N).
-_clast_retro_now() {
-  local t
-  t="$(date +%s.%N 2>/dev/null)" || t="$(date +%s)"
-  [[ "$t" == *N* ]] && t="$(date +%s)"
-  printf '%s' "$t"
-}
-
-# _clast_retro_elapsed <start> <end> — seconds between two _clast_retro_now
-# readings, one decimal place (never negative).
-_clast_retro_elapsed() {
-  awk -v a="$1" -v b="$2" 'BEGIN { d = b - a; if (d < 0) d = 0; printf "%.1f", d }'
-}
-
 # _clast_retrosum_fingerprint  (stdin → short hex/cksum on stdout)
 #   Content fingerprint of a session body; changes invalidate the cache.
 _clast_retrosum_fingerprint() {
@@ -223,12 +208,12 @@ clast_cmd_retro() {
       # Time the call so we can report how long the model took. rc distinguishes
       # a cache hit (0, instant) from a fresh model call (3) from a failure.
       rc=0
-      t0="$(_clast_retro_now)"
+      t0="$(clast_porcelain_now)"
       summary="$(_clast_retrosum_summary "$project" "$work_day" "$cache_id" "$body" "$cache_dir" "$refresh")" || rc=$?
-      t1="$(_clast_retro_now)"
+      t1="$(clast_porcelain_now)"
       case "$rc" in
         0) : ;;  # served from cache — no model call, nothing to time
-        3) dt="$(_clast_retro_elapsed "$t0" "$t1")"
+        3) dt="$(clast_porcelain_elapsed "$t0" "$t1")"
            queried=$(( queried + 1 ))
            model_total="$(awk -v a="$model_total" -v d="$dt" 'BEGIN { printf "%.1f", a + d }')"
            _clast_retro_progress "        done in ${dt}s (model total ${model_total}s)" ;;

package/lib/clast/clast-porcelain-subcommands/wake.bash

@@ -27,11 +27,41 @@ _clast_wake_separator() {
   printf '── %s %s\n' "$label" "$dashes"
 }
 
-# --- Preflight ---------------------------------------------------------------
+# --- Usage / preflight -------------------------------------------------------
+
+_clast_wake_usage() {
+  cat <<'EOF'
+Usage: clast wake [--auto]
+
+Interactive day curation: for each uncurated session, generate a draft journal
+entry with the LLM and accept/edit/dismiss/skip it.
+
+Flags:
+  --auto      Non-interactive: auto-accept every generated draft and write it.
+              Skips the triage menu and the per-session prompt, and does not
+              require a tty — suitable for cron/scripts. Sessions whose draft
+              fails to generate are skipped. The scan window still honors
+              CLAST_WAKE_SINCE (default -14d).
+  -h, --help  Print this usage and exit.
+
+Env:
+  CLAST_WAKE_SINCE            Scan window (default -14d).
+  CLAST_WAKE_AUTO_MIN_CHARS   In --auto, skip drafts whose body is shorter than
+                              this many characters (likely trivial sessions);
+                              they stay uncurated for a later interactive pass.
+                              Default 60. Set 0 to write every draft.
+
+Requires the CLAST_LLM_* env vars (see `clast --help`).
+EOF
+}
 
+# _clast_wake_preflight <auto>
+#   In interactive mode (auto=0) a tty is required so we can read choices; --auto
+#   reads nothing from the terminal, so that check is skipped.
 _clast_wake_preflight() {
-  if [[ ! -t 0 ]]; then
-    clast_porcelain_die "clast wake requires an interactive terminal (stdin is not a tty)."
+  local auto="${1:-0}"
+  if (( ! auto )) && [[ ! -t 0 ]]; then
+    clast_porcelain_die "clast wake requires an interactive terminal (stdin is not a tty). Use --auto for non-interactive curation."
   fi
   clast_porcelain_preflight_llm
 }
@@ -239,7 +269,19 @@ _clast_wake_triage() {
 # --- Main --------------------------------------------------------------------
 
 clast_cmd_wake() {
-  _clast_wake_preflight
+  local auto=0
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --auto)     auto=1; shift ;;
+      -h|--help)  _clast_wake_usage; return 0 ;;
+      --) shift; break ;;
+      *) clast_porcelain_log_error "wake: unknown argument '$1'"; return 2 ;;
+    esac
+  done
+
+  _clast_wake_preflight "$auto"
+
+  (( auto )) && clast_porcelain_info "Auto mode: drafts will be accepted without review."
 
   clast_porcelain_info "Snapshotting fresh transcripts..."
   if ! clast-plumbing snapshot 2>/dev/null; then
@@ -299,7 +341,8 @@ clast_cmd_wake() {
   last_day="$(jq -r '[.[].day_bucket] | sort | last' <<<"$uncurated")"
   project_count="$(jq '[.[].project] | unique | length' <<<"$uncurated")"
 
-  if (( day_count > 1 )); then
+  # Triage is an interactive scope picker; --auto processes the whole window.
+  if (( ! auto )) && (( day_count > 1 )); then
     uncurated="$(_clast_wake_triage "$uncurated" "$total" "$day_count" "$first_day" "$last_day" "$project_count")"
     total="$(jq 'length' <<<"$uncurated")"
     if (( total == 0 )); then
@@ -315,6 +358,15 @@ clast_cmd_wake() {
   local curated_count=0 skipped_count=0 dismissed_count=0
   local -a curated_projects=()
   local i=0 stop=0
+  # Cumulative model time across every draft generation (excludes the time the
+  # reviewer spends at the menu), so the run's LLM cost is legible — mirrors the
+  # per-call + total timing `clast retro` reports.
+  local wake_model_total="0.0"
+  # --auto guard: skip (do NOT write) a draft whose body is shorter than this
+  # many characters — likely a trivial/low-value session. Skipped sessions stay
+  # uncurated for a later interactive pass, so this is safe to tune aggressively.
+  # 0 disables the guard. Ignored in interactive mode (the reviewer decides).
+  local auto_min_chars="${CLAST_WAKE_AUTO_MIN_CHARS:-60}"
 
   while (( i < total && stop == 0 )); do
     local session
@@ -349,7 +401,10 @@ clast_cmd_wake() {
     local recorded="$rec_date"
     if [[ -n "$start_short" ]]; then
       recorded="$recorded $start_short"
-      [[ -n "$end_short" && "$end_short" != "$start_short" ]] && recorded="$recorded–$end_short"
+      # Brace the expansion: the separator is an en dash (U+2013), and bash in a
+      # UTF-8 locale reads its bytes as part of the identifier — `$recorded–` then
+      # expands as the unset name `recorded–` and `set -u` kills the run.
+      [[ -n "$end_short" && "$end_short" != "$start_short" ]] && recorded="${recorded}–${end_short}"
       recorded="$recorded $tz"
     fi
 
@@ -419,9 +474,15 @@ Revisions requested by user: ${edit_extra}"
       fi
 
       clast_porcelain_info "Generating draft..."
+      local gen_t0 gen_t1 gen_dt
+      gen_t0="$(clast_porcelain_now)"
       if ! draft="$(clast_porcelain_llm_chat "$full_system" "$full_user")"; then
         printf '\n'
         clast_porcelain_warn "LLM call failed for session $sid"
+        # No tty to prompt in auto mode — skip this session and move on.
+        if (( auto )); then
+          skipped_count=$(( skipped_count + 1 )); break
+        fi
         local retry
         printf '  [r] Retry    [s] Skip    [q] Stop\n  Choice: '
         read -r -n1 retry </dev/tty
@@ -432,12 +493,37 @@ Revisions requested by user: ${edit_extra}"
           *) skipped_count=$(( skipped_count + 1 )); break ;;
         esac
       fi
-
-      printf '\n%s\n' "$draft"
-      printf '\n'
+      # Only reached when the draft succeeded (every failure branch above
+      # continues or breaks), so this times just the model call.
+      gen_t1="$(clast_porcelain_now)"
+      gen_dt="$(clast_porcelain_elapsed "$gen_t0" "$gen_t1")"
+      wake_model_total="$(awk -v a="$wake_model_total" -v d="$gen_dt" 'BEGIN { printf "%.1f", a + d }')"
+      clast_porcelain_info "  done in ${gen_dt}s (model total ${wake_model_total}s)"
 
       local choice
-      choice="$(_clast_wake_prompt_choice)"
+      if (( auto )); then
+        # Guard unattended writes: skip a draft whose body is below the minimum
+        # length (likely a trivial session). Skipped — not dismissed — so it
+        # stays uncurated and can be handled in a later interactive pass.
+        local auto_body auto_len
+        auto_body="$(_clast_wake_strip_tags_trailer "$draft")"
+        auto_body="${auto_body#"${auto_body%%[![:space:]]*}"}"   # ltrim
+        auto_body="${auto_body%"${auto_body##*[![:space:]]}"}"   # rtrim
+        auto_len=${#auto_body}
+        if (( auto_min_chars > 0 && auto_len < auto_min_chars )); then
+          clast_porcelain_info "  Draft below threshold (${auto_len} < ${auto_min_chars} chars) — skipping (stays uncurated)."
+          skipped_count=$(( skipped_count + 1 ))
+          drafting=0
+          continue
+        fi
+        # Auto-accept without printing the full draft or prompting — the write
+        # result below records what landed. Reuses the `a` case verbatim.
+        choice="a"
+      else
+        printf '\n%s\n' "$draft"
+        printf '\n'
+        choice="$(_clast_wake_prompt_choice)"
+      fi
 
       case "$choice" in
         a|A)
@@ -511,4 +597,5 @@ Revisions requested by user: ${edit_extra}"
   if (( remaining > 0 )); then
     clast_porcelain_info "  Remaining: $remaining session(s) (stopped early)"
   fi
+  clast_porcelain_info "  Model time: ${wake_model_total}s"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@procrastivity/clast",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "Capture, curate, and surface Claude Code session history across all your projects.",
   "homepage": "https://github.com/procrastivity/clast#readme",
   "bin": {

package/skills/wake/SKILL.md

@@ -1,6 +1,6 @@
 ---
 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.'
+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. Supports an opt-in auto mode when the user explicitly asks to curate everything without review ("do them all", "don''t ask me") — the equivalent of `clast wake --auto`. This is the once-per-day curation flow; for per-project briefings use /brief; for mid-session pivots use session-brief.'
 ---
 
 # Wake
@@ -81,7 +81,7 @@ print "Nothing to curate — all remaining sessions were empty or slash-command-
 
 ### 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:
+If uncurated sessions span more than one day (e.g., after a weekend or break), present a triage step before processing. (In [Auto mode](#auto-mode) skip triage entirely and process the whole window.) Show a per-day breakdown:
 
 ```
 Found 45 uncurated sessions across 5 days (2026-05-26 to 2026-05-30).
@@ -128,7 +128,7 @@ For each session in the list:
 
 4. Display the draft to the user inside a fenced markdown code block, with a brief preamble: "Here's a draft for the X session in <project> at HH:MM:".
 
-5. Present the **promotion question** (see below) via AskUserQuestion.
+5. Present the **promotion question** (see below) via AskUserQuestion. (In [Auto mode](#auto-mode) skip this and accept the draft, subject to the length guard.)
 
 6. Handle the response:
    - **Accept** (any combination of accept-flavored options): pipe the draft to `clast-plumbing entries write` via stdin.
@@ -147,6 +147,8 @@ Auto-dismissed (no-op): 5 sessions.
 Skipped: 1 session.
 Remaining uncurated: 0.
 
+(In Auto mode, also report: "Skipped (below length threshold): N sessions.")
+
 Promoted:
   Decisions: 1
   Common-issues: 0
@@ -155,6 +157,35 @@ Promoted:
 Run `/brief <project>` to start working on a specific project today.
 ```
 
+## Auto mode
+
+By default every session gets its own AskUserQuestion — the friction is the point, it's where
+curation happens. But if the user **explicitly** asks to curate everything without reviewing it
+("do them all", "don't ask me", "no prompts", "just write them all"), switch to auto mode.
+
+This mirrors `clast wake --auto` in the CLI porcelain, and behaves the same way:
+
+- **Skip the triage step** (Step 2) even when the backlog spans multiple days. The whole scan
+  window is processed.
+- **Skip the per-session promotion question** (Step 3, item 5). Accept and write every draft via
+  the normal `entries write` path in "Writing the entry" below. Nothing is promoted — promotion
+  requires a human choice.
+- **Length guard.** Before writing, take the draft body *without* the suggested-tags trailer and
+  trim surrounding whitespace. If it is shorter than `CLAST_WAKE_AUTO_MIN_CHARS` characters
+  (default `60`; `0` disables the guard), **skip** it — do not write it, and do **not** dismiss
+  it. It stays uncurated so it can be handled in a later interactive pass. Report it as
+  `Draft below threshold (N < M chars) — skipping (stays uncurated).`
+- **A draft that fails to generate is skipped**, not retried — there's no reviewer to ask.
+- Step 2a no-op auto-dismissal still runs first, unchanged.
+- Don't print each draft in full; the write confirmation is the record of what landed.
+
+Everything else is unchanged. Announce the mode up front ("Auto mode: drafts will be accepted
+without review.") and report the counts in the Step 4 summary, including how many were skipped
+for being under the length threshold.
+
+For unattended/cron curation outside a Claude Code session, the CLI equivalent is
+`clast wake --auto`.
+
 ## Draft generation prompt
 
 The prompt templates are installed alongside the plugin under `$CLAUDE_PLUGIN_ROOT/lib/clast/prompts/`:
@@ -225,4 +256,4 @@ For promoted items (decisions, common-issues, workflows): currently these are tr
 - **Multi-day backlog**: present the triage step (Step 2) so the user can choose scope before processing.
 - **`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.
+- **User says "do them all without prompting"**: switch to [Auto mode](#auto-mode) — accept and write every draft, skipping triage and the per-session question, with the `CLAST_WAKE_AUTO_MIN_CHARS` length guard applied. This is opt-in only: the interactive per-session AskUserQuestion stays the default, because the friction is where curation happens.