tim-hooks 0.1.0-beta.0

package/scripts/tim-claude-session-start.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+# tim-claude-session-start.sh — Claude Code SessionStart hook (TIM project auto-load).
+# Reads cwd from the SessionStart payload, resolves nearest .tim-project (walk-up),
+# emits additionalContext directive. Requires: jq, node. Override path with TIM_CLI.
+set -euo pipefail
+
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_LINK_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" == /* ]] || SCRIPT_PATH="$SCRIPT_LINK_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+unset SCRIPT_PATH SCRIPT_LINK_DIR
+# shellcheck source=lib/resolve-tim-cli.sh
+source "$SCRIPT_DIR/lib/resolve-tim-cli.sh"
+
+payload="$(cat -)"
+cwd=$(printf '%s' "$payload" | jq -r '.cwd // empty')
+[[ -z "$cwd" ]] && exit 0
+
+directive=$(run_tim_cli resolve-project --cwd "$cwd" --format directive 2>/dev/null || true)
+[[ -z "$directive" ]] && exit 0
+
+jq -n --arg ctx "$directive" \
+  '{hookSpecificOutput: {hookEventName: "SessionStart", additionalContext: $ctx}}'

package/scripts/tim-cursor-inject.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# tim-cursor-inject.sh — print the TIM load directive for a workspace, for the
+# orchestrator to prepend to Cursor's first prompt (Cursor has no SessionStart hook).
+# Usage: tim-cursor-inject.sh <project-dir>
+set -euo pipefail
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_LINK_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" == /* ]] || SCRIPT_PATH="$SCRIPT_LINK_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+unset SCRIPT_PATH SCRIPT_LINK_DIR
+# shellcheck source=lib/resolve-tim-cli.sh
+source "$SCRIPT_DIR/lib/resolve-tim-cli.sh"
+cwd="${1:-$PWD}"
+run_tim_cli resolve-project --cwd "$cwd" --format directive 2>/dev/null || true

package/scripts/tim-hermes-session-cache.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# tim-hermes-session-cache.sh — Hermes pre_llm_call: cache session_id + cwd for status bar
+# Output: {} (no prompt injection). Register before tim-hermes-statusline refresh.
+set -euo pipefail
+
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_LINK_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" == /* ]] || SCRIPT_PATH="$SCRIPT_LINK_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+unset SCRIPT_PATH SCRIPT_LINK_DIR
+# shellcheck source=lib/resolve-tim-cli.sh
+source "$SCRIPT_DIR/lib/resolve-tim-cli.sh"
+
+payload="$(cat)"
+session_id=$(printf '%s' "$payload" | jq -r '.session_id // empty')
+cwd=$(printf '%s' "$payload" | jq -r '.cwd // empty')
+
+[[ -z "$session_id" && -z "$cwd" ]] && { printf '{}\n'; exit 0; }
+
+cache_dir="${TIM_CACHE_DIR:-$HOME/.tim}"
+mkdir -p "$cache_dir"
+jq -n \
+  --arg sid "$session_id" \
+  --arg cwd "${cwd:-$HOME}" \
+  '{session_id: $sid, cwd: $cwd, ts: (now | todate)}' \
+  > "${cache_dir}/.session-cache"
+
+printf '{}\n'
+exit 0

package/scripts/tim-hermes-statusline.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# tim-hermes-statusline.sh — Hermes TUI status bar (JSON stdout for hermes-cli patch)
+# Project from nearest .tim-project walk-up only (tim statusline / resolve-project). No session cache.
+# Install: symlink to ~/.hermes/agent-hooks/ + apply hermes-cli-tim-statusline.patch
+set -euo pipefail
+
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_LINK_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" == /* ]] || SCRIPT_PATH="$SCRIPT_LINK_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+unset SCRIPT_PATH SCRIPT_LINK_DIR
+# shellcheck source=lib/resolve-tim-cli.sh
+source "$SCRIPT_DIR/lib/resolve-tim-cli.sh"
+
+# CWD: explicit env, else PWD (Hermes hook cwd is not piped here)
+CWD="${TIM_STATUSLINE_CWD:-${PWD:-$HOME}}"
+[[ -z "$CWD" ]] && CWD="${HOME}"
+
+out=$(run_tim_cli statusline --format hermes --cwd "$CWD" 2>/dev/null || true)
+if [[ -z "$out" ]]; then
+  echo '{}'
+else
+  echo "$out"
+fi
+exit 0

package/scripts/tim-post-commit.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# Back-compat wrapper — delegates to post-commit.sh
+set -euo pipefail
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_LINK_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" == /* ]] || SCRIPT_PATH="$SCRIPT_LINK_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+unset SCRIPT_PATH SCRIPT_LINK_DIR
+# shellcheck source=lib/resolve-tim-cli.sh
+source "$SCRIPT_DIR/lib/resolve-tim-cli.sh"
+exec "$TIM_HOOKS_SCRIPTS_DIR/post-commit.sh" "$@"

package/scripts/tim-session-start.sh

@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+# tim-session-start.sh — Generic TIM auto-load hook for CLI coding agents.
+#
+# Supports: Claude Code, Cursor CLI, Codex CLI, OpenCode (via plugin wrapper).
+#
+# Reads a harness-specific session-start payload from stdin, resolves the nearest
+# .tim-project marker (walk-up from cwd), and emits the buildLoadDirective text
+# wrapped in the JSON envelope expected by the calling harness.
+#
+# Requires: bash, jq, node (for tim CLI). Override TIM_CLI path via env var.
+#
+# Output formats (auto-detected from stdin payload shape):
+#   Claude Code  → {hookSpecificOutput: {hookEventName: "SessionStart", additionalContext: "…"}}
+#   Cursor CLI   → {additional_context: "…"}
+#   Hermes/Codex → {context: "…"}  (JSON — plain text broke Hermes session binding, PITFALLS-45)
+#   Fallback     → {additional_context: "…"}  (Cursor-safe, also works as plain text)
+
+set -euo pipefail
+
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_LINK_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" == /* ]] || SCRIPT_PATH="$SCRIPT_LINK_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+unset SCRIPT_PATH SCRIPT_LINK_DIR
+# shellcheck source=lib/resolve-tim-cli.sh
+source "$SCRIPT_DIR/lib/resolve-tim-cli.sh"
+TIM_HOOKS_MARKER="${TIM_MARKER_MODULE:-${SCRIPT_DIR}/../dist/marker.js}"
+
+# Read stdin once (some harnesses pass payload, some pass nothing)
+payload="$(cat -)"
+
+# --- Determine cwd ---
+cwd=""
+
+# Strategy 1: Extract from payload (Claude Code, Codex, Hermes send .cwd)
+if [[ -n "$payload" ]]; then
+  cwd=$(printf '%s' "$payload" | jq -r '.cwd // empty' 2>/dev/null || true)
+fi
+
+# Strategy 2: Extract workspace path (some Cursor versions)
+if [[ -z "$cwd" && -n "$payload" ]]; then
+  cwd=$(printf '%s' "$payload" | jq -r '.workspace // empty' 2>/dev/null || true)
+fi
+
+# Strategy 3: Fall back to current working directory
+if [[ -z "$cwd" ]]; then
+  cwd=$(pwd)
+fi
+
+# Extract session_id from payload (for marker rotation, Fix F)
+hook_session=$(printf '%s' "$payload" | jq -r '.session_id // empty' 2>/dev/null || true)
+
+# --- Resolve project marker ---
+directive=$(run_tim_cli resolve-project --walk-up --cwd "$cwd" --format directive 2>/dev/null || true)
+if [[ -z "$directive" ]]; then
+  # No .tim-project marker found — silent skip (exit 0)
+  exit 0
+fi
+
+# ── Session rotation: update .tim-project with current session ──
+# Prevents stale cron session IDs from persisting in the marker (PITFALLS-46).
+# cwd/session are passed via env, never interpolated into the JS source —
+# paths or session ids containing quotes/backslashes must not break rotation.
+if [[ -n "$hook_session" && -f "$TIM_HOOKS_MARKER" ]]; then
+  TIM_HOOK_CWD="$cwd" TIM_HOOK_SESSION="$hook_session" TIM_MARKER_MODULE="$TIM_HOOKS_MARKER" \
+    node --input-type=module -e "
+    const { pathToFileURL } = await import('node:url');
+    const m = await import(pathToFileURL(process.env.TIM_MARKER_MODULE).href);
+    m.rotateMarkerSession(process.env.TIM_HOOK_CWD, process.env.TIM_HOOK_SESSION);
+  " 2>/dev/null || true
+fi
+
+# --- Detect harness and format output ---
+
+# Claude Code sends hook_event_name in hook input. Keep accepting the older
+# hookSpecificOutput-shaped payload used by existing integrations/tests.
+if printf '%s' "$payload" | jq -e \
+  '(.hook_event_name == "SessionStart") or (.hookSpecificOutput // false)' >/dev/null 2>&1; then
+  # Claude Code format
+  exec jq -n --arg ctx "$directive" \
+    '{hookSpecificOutput: {hookEventName: "SessionStart", additionalContext: $ctx}}'
+fi
+
+# Cursor sends payload with .conversation_id or .additional_context
+if printf '%s' "$payload" | jq -e '(.conversation_id // empty) or (.additional_context // empty)' >/dev/null 2>&1; then
+  # Cursor format
+  exec jq -n --arg ctx "$directive" \
+    '{additional_context: $ctx}'
+fi
+
+# Hermes / Codex — payload has .session_id but NOT .hookSpecificOutput or .conversation_id
+if printf '%s' "$payload" | jq -e '.session_id // empty' >/dev/null 2>&1; then
+  # Hermes expects JSON context (PITFALLS-45: plain-text broke session binding)
+  exec jq -n --arg ctx "$directive" \
+    '{context: $ctx}'
+fi
+
+# Fallback: no recognizable payload (empty stdin) — emit Cursor-safe JSON
+# This covers: Cursor without payload, manual testing, unknown harnesses
+exec jq -n --arg ctx "$directive" \
+  '{additional_context: $ctx}'

package/scripts/tim-statusline.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# tim-statusline.sh — debug helper: one-line TIM status (stdin JSON optional, like Claude Code)
+# Hermes TUI bar: use tim-hermes-statusline.sh + hermes-cli-tim-statusline.patch instead.
+set -euo pipefail
+
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [[ -L "$SCRIPT_PATH" ]]; do
+  SCRIPT_LINK_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+  SCRIPT_PATH="$(readlink "$SCRIPT_PATH")"
+  [[ "$SCRIPT_PATH" == /* ]] || SCRIPT_PATH="$SCRIPT_LINK_DIR/$SCRIPT_PATH"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SCRIPT_PATH")" && pwd)"
+unset SCRIPT_PATH SCRIPT_LINK_DIR
+# shellcheck source=lib/resolve-tim-cli.sh
+source "$SCRIPT_DIR/lib/resolve-tim-cli.sh"
+run_tim_cli statusline 2>/dev/null || true