@trycore/spec-build-harness 0.8.5 → 0.11.0

package/hooks/build/session-start.sh

@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+# session-start.sh — SessionStart (startup|clear|compact) [EP-OR-08-B].
+# La parte de RED del arranque de sesión: registro idempotente del agente (con el catálogo
+# de asset types del paquete), hidratación de la caché de proyección desde /agent/context,
+# sincronización de contexto por hash y aseguramiento del daemon de heartbeat.
+# El RENDER del estado a `additionalContext` lo hace load-build-state.sh, que corre después.
+# Fail-open absoluto: cualquier fallo imprime un aviso por stderr y sale 0 — un runtime
+# caído jamás impide arrancar una sesión (RNF-6).
+set -uo pipefail
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$HERE/lib/runtime-client.sh"
+source "$HERE/lib/projection.sh"
+source "$HERE/lib/agent-context.sh"
+
+cat >/dev/null 2>&1   # consumir el payload del hook (protocolo); no se usa aquí
+
+MODE="$(runtime_mode)"
+[ "$MODE" = "legacy" ] && exit 0
+command -v python3 >/dev/null 2>&1 || exit 0
+[ -n "$(runtime_url)" ] || exit 0   # sin `trycore-build init` (sub-slice D) no hay runtime
+
+# sst_pkg_root — raíz del PAQUETE (no del proyecto). Los hooks se instalan como symlinks
+# por fichero (linkChildren), así que hay que resolver la cadena de enlaces a mano:
+# `readlink -f` no es portable al BSD readlink de macOS.
+sst_pkg_root() {
+  local src="${BASH_SOURCE[0]}" target i=0
+  while [ -L "$src" ] && [ "$i" -lt 10 ]; do
+    target="$(readlink "$src" 2>/dev/null)" || break
+    case "$target" in
+      /*) src="$target" ;;
+      *)  src="$(dirname "$src")/$target" ;;
+    esac
+    i=$((i + 1))
+  done
+  (cd "$(dirname "$src")/../.." >/dev/null 2>&1 && pwd -P) 2>/dev/null
+}
+
+# sst_harness_version — versión instalada en el consumidor; si no, la del paquete.
+sst_harness_version() {
+  local f pkg
+  f="$(config_root)/.claude/.build-harness-version"
+  if [ -f "$f" ]; then
+    tr -d ' \n' < "$f"
+    return
+  fi
+  pkg="$(sst_pkg_root)"
+  if [ -n "$pkg" ] && [ -f "$pkg/VERSION" ]; then
+    tr -d ' \n' < "$pkg/VERSION"
+    return
+  fi
+  echo "0.0.0"
+}
+
+# sst_asset_types — el array `types` de asset-types.json del paquete (protocolo §6).
+# Cadena de resolución: plugin > copia en .claude/ (la siembra es del sub-slice D) >
+# paquete resuelto por symlink. Sin fichero: "[]" — el registro sigue funcionando.
+sst_asset_types() {
+  local pkg candidates f
+  pkg="$(sst_pkg_root)"
+  candidates="${CLAUDE_PLUGIN_ROOT:-}/asset-types.json
+$(config_root)/.claude/asset-types.json
+${pkg:-}/asset-types.json"
+  while IFS= read -r f; do
+    case "$f" in /asset-types.json|asset-types.json) continue ;; esac
+    [ -f "$f" ] || continue
+    python3 - "$f" <<'PY' 2>/dev/null && return
+import json,sys
+try:
+    d=json.load(open(sys.argv[1]))
+    t=d.get("types")
+    print(json.dumps(t if isinstance(t,list) else [],ensure_ascii=False))
+except Exception:
+    raise SystemExit(1)
+PY
+  done <<EOS
+$candidates
+EOS
+  echo "[]"
+}
+
+HV="$(sst_harness_version)"
+AT="$(sst_asset_types)"
+
+runtime_register "$HV" "$AT"
+RC=$?
+if [ "$RC" -eq 2 ]; then
+  echo "⛔ El runtime rechaza esta versión del arnés ($HV): incompatible_version." >&2
+  echo "   Actualiza el paquete (npm i -g @trycore/spec-build-harness@latest) y reabre la sesión." >&2
+  echo "   Mientras tanto se trabaja con la caché local: los guards siguen operando." >&2
+  exit 0
+fi
+
+if ! agent_context_fetch_and_cache; then
+  echo "⚠ El runtime no respondió: se trabaja con la caché de proyección local." >&2
+fi
+
+EXPECTED="$(projection_get context.manifest_hash "")"
+[ -n "$EXPECTED" ] || EXPECTED="$(runtime_field manifest_hash)"
+bash "$HERE/context-sync.sh" "$EXPECTED"
+
+bash "$HERE/heartbeat.sh" --ensure "$PPID" >/dev/null 2>&1
+
+exit 0

package/hooks/build/session-stop.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# session-stop.sh — Stop [EP-OR-08-B].
+# Flush de la cola al cerrar el turno, pero SIN red en el hilo del hook: deja un sentinela
+# en outbox/.flush-request y se asegura de que el daemon esté vivo. El daemon lo consume en
+# su siguiente tick y despacha (protocolo §5, spec §11: «señal local al daemon»).
+# Nunca bloquea el cierre: exit 0 siempre, sin stdout (en Stop, stdout inyecta contexto).
+set -uo pipefail
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$HERE/lib/runtime-client.sh"
+
+cat >/dev/null 2>&1   # consumir el payload del hook
+
+MODE="$(runtime_mode)"
+[ "$MODE" = "legacy" ] && exit 0
+
+DIR="$(runtime_outbox_dir)"
+mkdir -p "$DIR" 2>/dev/null
+: > "$DIR/.flush-request" 2>/dev/null
+
+bash "$HERE/heartbeat.sh" --ensure "$PPID" >/dev/null 2>&1
+
+exit 0