@rubytech/create-maxy-code 0.1.163 → 0.1.165

package/payload/platform/plugins/admin/hooks/pre-turn-graph-pass.sh

@@ -1,171 +0,0 @@
-#!/usr/bin/env bash
-# UserPromptSubmit hook — pre-turn graph pass. Tasks 425, 430, 439.
-#
-# Fires once per admin-agent operator prompt submission. Emits a
-# directive into the admin agent's `additionalContext` that instructs
-# **admin** to scan the just-submitted operator turn for new candidate
-# graph rows (mentions, ideas, commitments, contacts, learnings — any
-# label the schema admits), then dispatch one `database-operator` Task
-# per candidate write. Admin is the session-walker; the specialist only
-# sees a narrowly-scoped per-write brief, never the conversation.
-#
-# Task 430 corrects the Task 425 orchestration shape (the Task 425 hook
-# packaged the full conversation blob into the specialist's prompt and
-# collapsed data and instruction channels into one context, so operator
-# prose pattern-matching as a writer-binding instruction was treated as
-# binding and the pass self-denied — same failure class as the writer-POV
-# schema doctrine read as binding the agent, Tasks 199 / 995).
-#
-# Task 439 converges the shared plumbing — stdin parse, role / specialist
-# / transcript guards, log-ingest envelope — with `session-end-retrospective.sh`
-# via `lib/admin-graph-pass-common.sh`. The only event-specific code in
-# this hook is the wrong-hook-event check, the post-turn-context fetch,
-# the directive-body composition, and the UserPromptSubmit JSON envelope
-# emission on stdout.
-#
-# Input: Claude Code's UserPromptSubmit hook stdin shape
-#   { "session_id": "<intrinsic>", "transcript_path": "<jsonl path>",
-#     "cwd": "<…>", "hook_event_name": "UserPromptSubmit",
-#     "prompt": "<operator text>" }
-# `prompt` is ignored — the directive instructs admin to read the turn
-# it already has in context.
-#
-# Output: stdout JSON of the documented UserPromptSubmit shape:
-#   { "hookSpecificOutput": { "hookEventName": "UserPromptSubmit",
-#                              "additionalContext": "<directive body>" } }
-# exit 0.
-
-set -uo pipefail
-
-AGP_LOG_TAG="pre-turn-graph-pass"
-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
-CONTEXT_URL="${UI_BASE}/api/admin/post-turn-context"
-
-agp_read_stdin
-agp_parse_stdin
-
-# Wrong-hook-event guard. Pre-turn-graph-pass is UserPromptSubmit-only;
-# reject stale Stop-shaped payloads before the role / transcript guards
-# run so the operator observes a `wrong-hook-event` skip line, not a
-# misleading `missing-transcript`.
-if [ -n "$HOOK_EVENT_NAME" ] && [ "$HOOK_EVENT_NAME" != "UserPromptSubmit" ]; then
-  agp_emit_log "trigger-skipped sessionId=${SESSION_ID_REPORTED} reason=wrong-hook-event event=${HOOK_EVENT_NAME}"
-  exit 0
-fi
-
-agp_guard_role_specialist
-agp_guard_transcript
-
-# Task 429 — the env var carries the graph `:Conversation.sessionId`.
-# Claude Code's own stdin `session_id` field (parsed into `SESSION_ID`
-# by `agp_parse_stdin`) is a distinct identifier (JSONL filename); one
-# graph sessionId can map to many Claude session ids. Shadow the lib's
-# `SESSION_ID` into `CLAUDE_SESSION_ID` so the rest of this hook can
-# refer to the graph identifier as `SESSION_ID` without collision.
-CLAUDE_SESSION_ID="$SESSION_ID"
-SESSION_ID="${SESSION_NODE_ID:-}"
-
-# Fetch the actual content of every node already written under this
-# conversation, account-scoped. The route runs loopback-only — the hook
-# is in-process on the device, same trust boundary as `/log-ingest`.
-# Admin reads this skip-list before deciding what new writes to
-# dispatch; the specialist never sees it (per-write briefs name the
-# elementId admin already resolved when attaching to an existing node).
-PRIOR_WRITES="(none)"
-PRIOR_WRITES_COUNT=0
-if [ -n "$SESSION_ID" ]; then
-  CONTEXT_JSON=$(curl -sS --max-time 5 -G \
-    --data-urlencode "sessionId=${SESSION_ID}" \
-    --data-urlencode "accountId=${ACCOUNT_ID:-}" \
-    "$CONTEXT_URL" 2>/dev/null || echo '')
-  if [ -n "$CONTEXT_JSON" ]; then
-    PARSED_CTX=$(printf '%s' "$CONTEXT_JSON" | python3 -c '
-import sys, json
-try:
-    d = json.load(sys.stdin)
-except Exception:
-    print("0\t")
-    sys.exit(0)
-writes = d.get("writes") or []
-if not isinstance(writes, list):
-    print("0\t")
-    sys.exit(0)
-lines = []
-for w in writes:
-    if not isinstance(w, dict):
-        continue
-    eid = w.get("elementId") or ""
-    labels = w.get("labels") or []
-    props = w.get("properties") or {}
-    if isinstance(labels, list):
-        labels_str = ":".join(str(x) for x in labels)
-    else:
-        labels_str = str(labels)
-    try:
-        props_str = json.dumps(props, ensure_ascii=False, sort_keys=True)
-    except Exception:
-        props_str = "{}"
-    lines.append(f"- ({eid}) :{labels_str} {props_str}")
-print(f"{len(writes)}\t" + "\n".join(lines))
-' 2>/dev/null)
-    PRIOR_WRITES_COUNT="${PARSED_CTX%%	*}"
-    PRIOR_WRITES_BODY="${PARSED_CTX#*	}"
-    if [ -n "$PRIOR_WRITES_BODY" ]; then
-      PRIOR_WRITES="$PRIOR_WRITES_BODY"
-    fi
-  fi
-fi
-
-# Compose the directive body before logging so contextBytes reflects
-# the actual payload size handed to admin (skip-list + directive prose).
-DIRECTIVE_BODY=$(ACCOUNT_ID_OUT="${ACCOUNT_ID:-<unset>}" \
-  CLAUDE_SESSION_ID_OUT="${CLAUDE_SESSION_ID}" \
-  SESSION_ID_OUT="${SESSION_ID:-<unset>}" \
-  PRIOR_WRITES_OUT="${PRIOR_WRITES}" \
-  python3 - <<'PY'
-import os
-body = (
-    "[system: pre-turn-graph-pass-hook]\n"
-    "Before responding to the operator, run the pre-turn graph pass. "
-    "Scan the operator turn you just received for any new graph-worthy content not already covered by the prior-writes list below — "
-    "mentions of named entities, ideas or learnings the operator stated, contacts named for the first time, tasks the operator committed to, decisions, anything the schema admits. "
-    "For each candidate write, dispatch one Task to the `database-operator` specialist with a brief that names the label, the relevant properties, and (when attaching to an existing node) the elementId from the prior-writes list. "
-    "Skip writes the prior-writes list already covers — a `:MENTIONS` edge that is already there does not need re-emitting; an existing `:Person` is attached to by elementId, not re-created. "
-    "If the turn supports no new writes, dispatch nothing. "
-    "Do not surface these dispatches in your reply to the operator. After the dispatches return, continue with your normal response to the operator's prompt.\n\n"
-    f"accountId: {os.environ['ACCOUNT_ID_OUT']}\n"
-    f"claudeSessionId: {os.environ['CLAUDE_SESSION_ID_OUT']}\n"
-    f"sessionId: {os.environ['SESSION_ID_OUT']}\n\n"
-    "<prior-writes>\n"
-    f"{os.environ['PRIOR_WRITES_OUT']}\n"
-    "</prior-writes>\n"
-)
-print(body, end="")
-PY
-)
-CONTEXT_BYTES=${#DIRECTIVE_BODY}
-
-agp_emit_log "dispatch claudeSessionId=${CLAUDE_SESSION_ID} sessionId=${SESSION_ID:-<unset>} directive-shape=admin-walks priorWritesCount=${PRIOR_WRITES_COUNT} contextBytes=${CONTEXT_BYTES} ms=0"
-
-# Emit the documented UserPromptSubmit JSON envelope on stdout. Python
-# handles JSON encoding so embedded newlines, quotes, and backslashes
-# in the prior-writes block are escaped correctly.
-DIRECTIVE_BODY_OUT="$DIRECTIVE_BODY" python3 - <<'PY'
-import os, json, sys
-sys.stdout.write(json.dumps({
-    "hookSpecificOutput": {
-        "hookEventName": "UserPromptSubmit",
-        "additionalContext": os.environ["DIRECTIVE_BODY_OUT"],
-    }
-}))
-PY
-
-exit 0