subconscious-cli 6.2.1 → 6.3.1

package/bin/runbook/cursor/hooks.json

@@ -1,17 +0,0 @@
-{
-  "version": 1,
-  "hooks": {
-    "beforeSubmitPrompt": [
-      {
-        "command": "HOOK_SH_PATH",
-        "timeout": 2
-      }
-    ],
-    "preCompact": [
-      {
-        "command": "HOOK_SH_PATH",
-        "timeout": 2
-      }
-    ]
-  }
-}

package/bin/runbook/cursor/install.sh

@@ -1,259 +0,0 @@
-#!/usr/bin/env bash
-# ── Subconscious API Gateway — Cursor hooks setup ─────────────────────────────
-# Install Cursor hooks that announce each agent handoff to your gateway so
-# /v1/chat/completions requests are grouped into Conversations.
-#
-# Quick start:
-#   ./install.sh --gateway-url https://your-gateway.example --api-key sk-gw-...
-#   ./install.sh status                 # show current hook config
-#   ./install.sh uninstall              # remove hooks
-#
-# Cursor model/URL are set in Cursor settings (OpenAI API Key Override), not
-# here. This script installs the conversation-correlation hooks (user-wide
-# under ~/.cursor). Restart Cursor after install so it reloads hooks.json.
-#
-# ── What this does under the hood ────────────────────────────────────────────
-# Equivalent manual setup (three pieces):
-#
-#   1. Cursor settings → enable "OpenAI API Key Override":
-#        Base URL: https://your-gateway.example/v1
-#        API Key:  sk-gw-...
-#
-#   2. Write ~/.cursor/hooks.json pointing at the hook script:
-#        {
-#          "version": 1,
-#          "hooks": {
-#            "beforeSubmitPrompt": [{ "command": "~/.cursor/hooks/subconscious-hook.sh", "timeout": 2 }],
-#            "preCompact": [{ "command": "~/.cursor/hooks/subconscious-hook.sh", "timeout": 2 }]
-#          }
-#        }
-#
-#   3. Write ~/.cursor/subconscious-hooks.env (mode 600):
-#        export SUBCONSCIOUS_GATEWAY_URL=https://your-gateway.example
-#        export SUBCONSCIOUS_API_KEY=sk-gw-...
-#
-# The hook script (hook.sh) POSTs conversation_ensure to /v1/agent-hooks with the raw
-# prompt text once per submission. The gateway fingerprints the prompt itself,
-# binds the first LLM request of that prompt, then chains every later turn of the
-# conversation onto it -- including subagents. Unlike Claude Code / Pi /
-# OpenCode, Cursor has no native session headers and hooks cannot inject headers
-# into model HTTP, so this announcement is required for correlation.
-# ─────────────────────────────────────────────────────────────────────────────
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-HOOK_SRC="${SCRIPT_DIR}/hook.sh"
-
-GATEWAY_URL="${GATEWAY_URL:-}"
-API_KEY="${CURSOR_API_KEY:-${API_KEY:-}}"
-MODEL="${MODEL:-}"
-COMMAND="install"
-
-usage() {
-  cat <<'EOF'
-Usage:
-  subc cursor install [--gateway-url URL] [--api-key KEY]
-  subc cursor uninstall
-  subc cursor status
-
-Installs Cursor hooks (user-wide under ~/.cursor) that POST to /v1/agent-hooks:
-conversation_ensure on each prompt submission so the gateway can group
-Conversations for Cursor traffic, and conversation_compaction on preCompact so
-context accounting restarts at the right turn. Existing hook entries are kept.
-
-Requires: jq, curl. Restart Cursor after install.
-EOF
-}
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    install|uninstall|status)
-      COMMAND="$1"
-      shift
-      ;;
-    --gateway-url)
-      GATEWAY_URL="${2:-}"
-      shift 2
-      ;;
-    --api-key)
-      API_KEY="${2:-}"
-      shift 2
-      ;;
-    -h|--help)
-      usage
-      exit 0
-      ;;
-    *)
-      echo "unknown argument: $1" >&2
-      usage >&2
-      exit 1
-      ;;
-  esac
-done
-
-CURSOR_DIR="${HOME}/.cursor"
-HOOKS_JSON="${CURSOR_DIR}/hooks.json"
-HOOK_DST="${CURSOR_DIR}/hooks/subconscious-hook.sh"
-ENV_FILE="${CURSOR_DIR}/subconscious-hooks.env"
-MARKER="subconscious-hook.sh"
-
-require_cmds() {
-  local missing=0
-  for c in jq curl; do
-    if ! command -v "$c" >/dev/null 2>&1; then
-      echo "missing required command: $c" >&2
-      missing=1
-    fi
-  done
-  if [[ "$missing" -ne 0 ]]; then
-    exit 1
-  fi
-}
-
-write_env() {
-  umask 077
-  cat >"$ENV_FILE" <<EOF
-# Generated by subc — do not commit secrets.
-export SUBCONSCIOUS_GATEWAY_URL='${GATEWAY_URL}'
-export SUBCONSCIOUS_API_KEY='${API_KEY}'
-EOF
-  chmod 600 "$ENV_FILE"
-}
-
-install_hook_script() {
-  mkdir -p "$(dirname "$HOOK_DST")"
-  cp "$HOOK_SRC" "$HOOK_DST"
-  chmod +x "$HOOK_DST"
-}
-
-# merge_hook_entries <hooks_json> <marker> <command> <event> [<event>...]
-#
-# Additive, idempotent merge of a single hook command into one or more events
-# of a hooks.json file. Preserves ALL other entries verbatim, including
-# third-party hooks, prompt hooks (no `command` field), and unknown events.
-#
-# Invariants:
-#  - Only entries whose `command` contains <marker> are replaced; others untouched.
-#  - Running twice yields the same result as once (idempotent, order-stable).
-#  - Entries without a `command` field are never matched/removed.
-#  - Missing/empty file is initialized to {"version":1,"hooks":{}}.
-merge_hook_entries() {
-  local hooks_json="$1" marker="$2" command="$3"
-  shift 3
-  local events
-  events="$(printf '%s\n' "$@" | jq -R . | jq -s .)"
-
-  if [[ ! -f "$hooks_json" ]]; then
-    printf '%s\n' '{"version":1,"hooks":{}}' >"$hooks_json"
-  fi
-
-  local tmp
-  tmp="$(mktemp)"
-  jq --arg marker "$marker" --arg cmd "$command" --argjson events "$events" '
-    .version = (.version // 1) |
-    .hooks = (.hooks // {}) |
-    # Strip prior entries with our marker from every event, keep everything else.
-    .hooks |= with_entries(
-      .value = ((.value // []) | map(select((.command // "") | tostring | contains($marker) | not)))
-    ) |
-    # Append our entry to each requested event (preserving any other entries).
-    .hooks = (.hooks | reduce ($events[]) as $e (.;
-      .[$e] = ((.[$e] // []) + [{"command": $cmd, "timeout": 2}])
-    ))
-  ' "$hooks_json" >"$tmp"
-  mv "$tmp" "$hooks_json"
-}
-
-# remove_hook_entries <hooks_json> <marker>
-#
-# Remove every entry whose `command` contains <marker> from all events.
-# Preserves all other entries (third-party, prompt hooks, unknown events).
-remove_hook_entries() {
-  local hooks_json="$1" marker="$2"
-  [[ -f "$hooks_json" ]] || return 0
-  local tmp
-  tmp="$(mktemp)"
-  jq --arg marker "$marker" '
-    .hooks //= {} |
-    .hooks |= with_entries(
-      .value = ((.value // []) | map(select((.command // "") | tostring | contains($marker) | not)))
-    )
-  ' "$hooks_json" >"$tmp"
-  mv "$tmp" "$hooks_json"
-}
-
-merge_hooks_json() {
-  local command
-  command="$(jq -rn --arg path "$HOOK_DST" '$path | @sh')"
-  # The merge handles both first install and refresh; jq escapes JSON while
-  # @sh keeps spaces and shell characters inside the executable path.
-  merge_hook_entries "$HOOKS_JSON" "$MARKER" "$command" beforeSubmitPrompt preCompact
-}
-
-uninstall_hooks() {
-  remove_hook_entries "$HOOKS_JSON" "$MARKER"
-  rm -f "$HOOK_DST" "$ENV_FILE"
-}
-
-status() {
-  echo "cursor dir: $CURSOR_DIR"
-  echo "hooks.json: $HOOKS_JSON"
-  if [[ -f "$HOOKS_JSON" ]] && jq -e --arg m "$MARKER" '
-      [.hooks[]?[]? | select((.command // "") | tostring | contains($m))] | length > 0
-    ' "$HOOKS_JSON" >/dev/null 2>&1; then
-    echo "hooks: installed"
-  else
-    echo "hooks: not installed"
-  fi
-  if [[ -f "$ENV_FILE" ]]; then
-    echo "env: $ENV_FILE (present)"
-    # shellcheck disable=SC1090
-    source "$ENV_FILE"
-    echo "gateway: ${SUBCONSCIOUS_GATEWAY_URL:-unset}"
-    if [[ -n "${SUBCONSCIOUS_API_KEY:-}" ]]; then
-      echo "api key: set (${#SUBCONSCIOUS_API_KEY} chars)"
-    else
-      echo "api key: unset"
-    fi
-  else
-    echo "env: missing"
-  fi
-  if [[ -x "$HOOK_DST" ]]; then
-    echo "hook script: $HOOK_DST (executable)"
-  else
-    echo "hook script: missing"
-  fi
-}
-
-case "$COMMAND" in
-  install)
-    require_cmds
-    if [[ -z "$GATEWAY_URL" || -z "$API_KEY" ]]; then
-      echo "--gateway-url and --api-key are required for install" >&2
-      exit 1
-    fi
-    mkdir -p "$CURSOR_DIR"
-    install_hook_script
-    write_env
-    merge_hooks_json
-    echo "Installed Subconscious Cursor hooks into $CURSOR_DIR"
-    echo ""
-    echo "Finish in Cursor Settings"
-    echo "  Enable OpenAI API Key Override, then use:"
-    echo "    Base URL: ${GATEWAY_URL%/}/v1"
-    echo "  Add the available custom models:"
-    while IFS= read -r model_id; do
-      echo "    ${model_id}"
-    done <<< "$SUBC_MODEL_IDS"
-    echo "  Select ${MODEL} for this profile."
-    echo "  Paste your Subconscious API key there, then fully restart Cursor."
-    ;;
-  uninstall)
-    uninstall_hooks
-    echo "Removed Subconscious Cursor hooks from $CURSOR_DIR"
-    ;;
-  status)
-    status
-    ;;
-esac