queue-session-retro.sh

#!/usr/bin/env bash
# SPDX-License-Identifier: MIT
# code-quality-atlas SessionEnd hook — Q17/D17 stage 1 ("Process notes + local
# log"). Queues the just-ended session's transcript for later post-hoc
# digestion (docs/self-improvement-loop.md §3.4's `/atlas-retro`, stage 2+,
# unbuilt) instead of doing any analysis here — this hook stays
# milliseconds-cheap and does no LLM work and no network, by design.
#
# Opt-in and off by default: no-ops unless the reviewed repo has turned the
# feedback loop on (see hooks/lib/feedback-tier.sh and
# docs/self-improvement-loop.md §5). When on, appends one compact JSON line
# per session to `.code-quality-atlas/learnings/pending-retro.jsonl` in the
# project's working directory: the transcript's basename (#364 — never the
# full `transcript_path`, which is an absolute local path carrying the OS
# username, `$HOME`, and project layout; the basename alone is enough to
# identify the session file to a stage-2+ digestion pass running on the same
# machine, which still has the standard transcript directory available), the
# plugin commit SHA (D9 — so a later regeneration's champion/challenger
# comparison knows which suite version reviewed), and why the session ended.
#
# Always exits 0 — a broken or absent dependency (jq), an unwritable
# directory, or malformed input degrades to "don't queue this one", never to
# blocking or delaying session teardown.
#
# bash 3.2 compatible (macOS default), matching tooling/keep-plugin-current.sh.

set -u

input="$(cat)"   # drain stdin unconditionally so the caller never blocks on a full pipe

# Resolve the sibling lib relative to CLAUDE_PLUGIN_ROOT when the plugin runtime
# set it (the normal case); fall back to this script's own directory so the
# hook is also runnable directly (manual testing, this repo's own test suite).
_hook_dir="$(cd "$(dirname "$0")" && pwd)"
if [ -n "${CLAUDE_PLUGIN_ROOT:-}" ]; then
  _lib="${CLAUDE_PLUGIN_ROOT}/hooks/lib/feedback-tier.sh"
else
  _lib="${_hook_dir}/lib/feedback-tier.sh"
fi
# A missing/unreadable lib can't tell us the tier at all, so this exits the
# same way "off" would rather than let `set -u` and no lib functions defined
# fail loudly out from under `source` (#365).
[ -f "$_lib" ] || exit 0
# shellcheck source=lib/feedback-tier.sh
source "$_lib"

_code_quality_atlas_hook_prologue "session"
log_dir="$LOG_DIR"
plugin_sha="$PLUGIN_SHA"

record="$(printf '%s' "$input" | jq -c \
  --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  --arg plugin_sha "$plugin_sha" \
  '{
    ts: $ts,
    plugin_sha: (if $plugin_sha == "" then null else $plugin_sha end),
    session_id: (.session_id // null),
    transcript_basename: ((.transcript_path // "") | if . == "" then null else (gsub("\\\\"; "/") | split("/") | last) end),
    reason: (.reason // null)
  }' 2>/dev/null)"

[ -n "$record" ] || exit 0   # malformed stdin JSON: nothing sane to append, skip silently

_code_quality_atlas_append "$log_dir/pending-retro.jsonl" "$record"

exit 0