@rubytech/create-realagent-code 0.1.254 → 0.1.255

package/payload/platform/plugins/admin/hooks/session-end-retrospective.sh

@@ -1,214 +0,0 @@
-#!/usr/bin/env bash
-# Stop hook — gates session termination until the admin agent has performed
-# a four-pass retrospective (technical learnings, operator-relationship
-# updates, graph-completeness sweep, typed-edge auto-extraction) and called
-# the deterministic `session-retrospective-mark-complete` MCP sentinel
-# tool. Task 282; converged onto the Task 439 shared helper.
-#
-# Trigger detection. End-intent is the operator's most recent real-user
-# message matching one of the literal token strings:
-#     /end | /archive | end session | archive this session
-# "Real user" follows the same shape used by
-# askuserquestion-investigate-gate.sh — `type=user, message.role=user,
-# content` is a string OR a list with at least one non-`tool_result` block.
-# `tool_result`-only user records are tool replies, not turn starts, and
-# never count as the latest user message.
-#
-# The Sidebar Archive button POSTs `/:sessionId/archive` which kills the
-# PTY directly — no Stop fires after that, so clicking Archive is the
-# operator's de-facto skip path. The spec lists opt-out as a deferred
-# follow-up; archive-click is its current shape and acceptable behaviour.
-#
-# Sentinel detection. Completion is recognised by greping the operator's
-# own JSONL (transcript_path on the Stop envelope) for a `tool_use` block
-# whose `name` is exactly `mcp__admin__session-retrospective-mark-complete`
-# — that is the prefixed form Claude Code writes for MCP tools in the
-# JSONL; the unprefixed name only appears in the operator-facing
-# instruction text below. The sentinel-grep doubles as the re-entry guard:
-# every Stop that fires after the agent's sentinel call sees the sentinel
-# and exits 0 with `gate-released`, so the agent's wrap-up turn never
-# re-blocks.
-# [[feedback_no_stdout_parsing_for_control_flow]],
-# [[feedback_doctrine_paragraph_is_not_a_gate]] — the LLM is removed from
-# the per-decision path entirely.
-#
-# Gating (common guards live in `lib/admin-graph-pass-common.sh`; this
-# hook adds the end-intent gating layered on top):
-#   - role-not-admin / is-specialist / empty-stdin / missing-transcript:
-#     handled by the shared helper, emit `trigger-skipped` and exit 0.
-#   - no-intent-match: latest real-user message has no end-intent token,
-#     emit `trigger-skipped` and exit 0.
-#
-# Releases:
-#   - gate-released sessionId=<id> (when sentinel present in transcript)
-#
-# Blocks:
-#   - gate-blocked sessionId=<id> reason=sentinel-absent
-#     (exit 2; stderr carries the four-pass retrospective instruction —
-#     stderr is the Stop-hook contract for handing instructions back to
-#     the agent).
-#
-# Input: Claude Code's Stop hook stdin shape
-#   { "session_id": "<intrinsic>", "transcript_path": "<jsonl path>", ... }
-
-set -uo pipefail
-
-AGP_LOG_TAG="session-retrospective"
-AGP_LIB="$(dirname "$0")/lib/admin-graph-pass-common.sh"
-if [ ! -f "$AGP_LIB" ]; then
-  echo "[${AGP_LOG_TAG}] trigger-skipped sessionId=unknown reason=missing-helper path=${AGP_LIB}" >&2
-  exit 0
-fi
-# shellcheck source=lib/admin-graph-pass-common.sh
-source "$AGP_LIB"
-
-agp_setup_logging
-agp_read_stdin
-agp_parse_stdin
-agp_guard_role_specialist
-agp_guard_transcript require-stdin
-
-# Single Python pass walks the transcript and reports two facts:
-#   1. The latest end-intent token in the most recent real-user message,
-#      or empty if no real user message matches.
-#   2. Whether any `tool_use` block in the transcript names the sentinel
-#      tool `mcp__admin__session-retrospective-mark-complete`.
-# Output one line: <intent-token-or-empty>\t<sentinel-present-yes|no>
-INSPECTION=$(TRANSCRIPT_PATH="$TRANSCRIPT_PATH" python3 - <<'PY'
-import os, json
-
-SENTINEL_TOOL = "mcp__admin__session-retrospective-mark-complete"
-INTENT_TOKENS = ("/end", "/archive", "end session", "archive this session")
-
-def is_real_user(rec):
-    if not isinstance(rec, dict) or rec.get("type") != "user":
-        return False
-    msg = rec.get("message")
-    if not isinstance(msg, dict) or msg.get("role") != "user":
-        return False
-    content = msg.get("content")
-    if isinstance(content, str):
-        return True
-    if isinstance(content, list):
-        for b in content:
-            if isinstance(b, dict) and b.get("type") != "tool_result":
-                return True
-        return False
-    return True
-
-def extract_user_text(rec):
-    msg = rec.get("message", {}) or {}
-    content = msg.get("content")
-    if isinstance(content, str):
-        return content
-    if isinstance(content, list):
-        out = []
-        for b in content:
-            if not isinstance(b, dict):
-                continue
-            if b.get("type") == "text":
-                t = b.get("text")
-                if isinstance(t, str):
-                    out.append(t)
-        return "".join(out)
-    return ""
-
-def assistant_tool_use_names(rec):
-    if not isinstance(rec, dict) or rec.get("type") != "assistant":
-        return []
-    msg = rec.get("message", {}) or {}
-    if msg.get("role") != "assistant":
-        return []
-    content = msg.get("content")
-    if not isinstance(content, list):
-        return []
-    names = []
-    for b in content:
-        if isinstance(b, dict) and b.get("type") == "tool_use":
-            n = b.get("name")
-            if isinstance(n, str):
-                names.append(n)
-    return names
-
-path = os.environ["TRANSCRIPT_PATH"]
-records = []
-try:
-    with open(path, "r", encoding="utf-8") as f:
-        for raw in f:
-            raw = raw.strip()
-            if not raw:
-                continue
-            try:
-                records.append(json.loads(raw))
-            except Exception:
-                continue
-except Exception:
-    print("\tno")
-    raise SystemExit(0)
-
-# Sentinel presence — any assistant tool_use of the sentinel tool anywhere
-# in this session's JSONL.
-sentinel_present = False
-for r in records:
-    if SENTINEL_TOOL in assistant_tool_use_names(r):
-        sentinel_present = True
-        break
-
-# Latest real-user message text.
-latest_user_text = ""
-for r in reversed(records):
-    if is_real_user(r):
-        latest_user_text = extract_user_text(r).strip()
-        break
-
-matched = ""
-if latest_user_text:
-    # Case-insensitive whole-message match against the token set. A token
-    # must appear as the entire user message (after .strip()), or as a
-    # standalone line within it — not embedded inside a paragraph. Keeps
-    # the gate from false-positiving on "I'll end session by 5pm" prose.
-    haystacks = {latest_user_text.lower()}
-    for line in latest_user_text.splitlines():
-        s = line.strip().lower()
-        if s:
-            haystacks.add(s)
-    for tok in INTENT_TOKENS:
-        if tok.lower() in haystacks:
-            matched = tok
-            break
-
-print(f"{matched}\t{'yes' if sentinel_present else 'no'}")
-PY
-)
-INTENT_TOKEN="${INSPECTION%%	*}"
-SENTINEL_PRESENT="${INSPECTION#*	}"
-
-if [ -z "$INTENT_TOKEN" ]; then
-  agp_emit_log "trigger-skipped sessionId=${SESSION_ID} reason=no-intent-match"
-  exit 0
-fi
-
-agp_emit_log "trigger sessionId=${SESSION_ID} token=${INTENT_TOKEN}"
-
-if [ "$SENTINEL_PRESENT" = "yes" ]; then
-  agp_emit_log "gate-released sessionId=${SESSION_ID}"
-  exit 0
-fi
-
-agp_emit_log "gate-blocked sessionId=${SESSION_ID} reason=sentinel-absent"
-
-cat >&2 <<'INSTRUCTION'
-The operator signalled session end. Before this session can close, run the four-pass retrospective inside this same admin session — do not spawn a new session, do not background anything. Use the tools you already have.
-
-Pass 1 — Technical learnings. Walk this session for operator corrections and self-detected mistakes. For each one, delegate one graph write to `database-operator` via the Task tool, persisting a Learning or Correction node per the schema. Count what you write.
-
-Pass 2 — Operator-relationship updates. Walk this session for tonal signals, rejected phrasings, and working-style preferences. For each one worth carrying forward, Write the observation into `SOUL.md` at the account-scoped path. Count what you write.
-
-Pass 3 — Graph completeness sweep. Walk this session for any node, edge, or commitment that was discussed but not written to the graph in-flight. For each missing write, delegate to `database-operator` via the Task tool. Count what you write.
-
-Pass 4 — Typed-edge auto-extraction. Delegate to `database-operator` via the Task tool with a prompt naming the typed-edge pass and the session-start timestamp. The specialist calls `memory-typed-edge-pass` with that timestamp and returns the counters. Capture `nodesProcessed` and the accepted count from its reply.
-
-Then call `session-retrospective-mark-complete` with all five counts (learningsCount, preferencesCount, graphWriteCount, typedEdgesCount, nodesProcessed) and reply with one short paragraph in your house voice summarising what you wrote.
-INSTRUCTION
-
-exit 2