|
| 1 | +#!/usr/bin/env bash |
| 2 | +# java-direct — proxy jdtls (Eclipse JDT.LS) over persistent HTTP; per-workspace isolation; LSP-workaround convention per rules/lsp.md |
| 3 | +# subcommands: start [workspace] | call <method> <json-params> [workspace] | stop [workspace] | status | tools [workspace] |
| 4 | +set -euo pipefail |
| 5 | + |
| 6 | +STATE_ROOT="${JAVA_DIRECT_STATE:-$HOME/.cache/java-direct}" |
| 7 | +PROXY="$HOME/.claude/bin/lsp-stdio-proxy.js" |
| 8 | +LSP_BIN="jdtls" |
| 9 | +LANG_ID="java" |
| 10 | +WORKSPACE_MARKERS=(pom.xml build.gradle.kts build.gradle settings.gradle.kts settings.gradle .project) |
| 11 | + |
| 12 | +die() { echo "java-direct: $*" >&2; exit 1; } |
| 13 | + |
| 14 | +resolve_workspace() { |
| 15 | + local ws="${1:-}" |
| 16 | + if [ -n "$ws" ]; then ws="$(cd "$ws" && pwd)"; echo "$ws"; return; fi |
| 17 | + ws="$PWD" |
| 18 | + while [ "$ws" != "/" ]; do |
| 19 | + for marker in "${WORKSPACE_MARKERS[@]}"; do |
| 20 | + [ -e "$ws/$marker" ] && { echo "$ws"; return; } |
| 21 | + done |
| 22 | + ws="$(dirname "$ws")" |
| 23 | + done |
| 24 | + echo "$PWD" |
| 25 | +} |
| 26 | + |
| 27 | +state_dir() { |
| 28 | + local hash |
| 29 | + hash="$(printf '%s' "$1" | shasum | awk '{print $1}' | cut -c1-12)" |
| 30 | + echo "$STATE_ROOT/$hash" |
| 31 | +} |
| 32 | + |
| 33 | +free_port() { |
| 34 | + python3 -c 'import socket; s=socket.socket(); s.bind(("",0)); print(s.getsockname()[1]); s.close()' |
| 35 | +} |
| 36 | + |
| 37 | +state_get() { [ -f "$1/$2" ] && cat "$1/$2" || echo ""; } |
| 38 | + |
| 39 | +port_ready() { |
| 40 | + curl -fsS -m 2 "http://127.0.0.1:$1/health" >/dev/null 2>&1 |
| 41 | +} |
| 42 | + |
| 43 | +server_alive() { |
| 44 | + local port; port="$(state_get "$1" port)" |
| 45 | + [ -z "$port" ] && return 1 |
| 46 | + port_ready "$port" |
| 47 | +} |
| 48 | + |
| 49 | +cmd_start() { |
| 50 | + command -v "$LSP_BIN" >/dev/null || die "$LSP_BIN not on PATH — install jdtls (brew install jdtls; requires JDK 17+)" |
| 51 | + [ -f "$PROXY" ] || die "proxy missing: $PROXY" |
| 52 | + local ws dir port pid |
| 53 | + ws="$(resolve_workspace "${1:-}")" |
| 54 | + dir="$(state_dir "$ws")" |
| 55 | + mkdir -p "$dir" |
| 56 | + if server_alive "$dir"; then |
| 57 | + echo "already running: workspace=$ws port=$(state_get "$dir" port) pid=$(state_get "$dir" pid)" |
| 58 | + return 0 |
| 59 | + fi |
| 60 | + port="$(free_port)" |
| 61 | + echo "$ws" > "$dir/workspace" |
| 62 | + echo "$port" > "$dir/port" |
| 63 | + # jdtls needs a per-workspace -data dir (Eclipse workspace metadata); scope under our state hash for clean stop |
| 64 | + local lsp_args=(-data "$dir/jdt-data") |
| 65 | + nohup node "$PROXY" --workspace "$ws" --port "$port" --lang-id "$LANG_ID" -- "$LSP_BIN" "${lsp_args[@]}" >"$dir/log" 2>&1 & |
| 66 | + pid=$! |
| 67 | + echo "$pid" > "$dir/pid" |
| 68 | + local i=0 |
| 69 | + until port_ready "$port"; do |
| 70 | + sleep 1 |
| 71 | + i=$((i+1)) |
| 72 | + [ "$i" -ge 180 ] && { kill "$pid" 2>/dev/null; die "proxy did not bind port $port within 180s — check $dir/log"; } |
| 73 | + done |
| 74 | + echo "started: workspace=$ws port=$port pid=$pid state=$dir" |
| 75 | +} |
| 76 | + |
| 77 | +cmd_call() { |
| 78 | + local method="${1:-}"; shift || true |
| 79 | + local params_json="${1-}"; shift || true |
| 80 | + [ -z "$params_json" ] && params_json='{}' |
| 81 | + [ -z "$method" ] && die "usage: java-direct call <method> '<json-params>' [workspace]" |
| 82 | + local ws dir port |
| 83 | + ws="$(resolve_workspace "${1:-}")" |
| 84 | + dir="$(state_dir "$ws")" |
| 85 | + server_alive "$dir" || { echo "server not running for $ws — starting..." >&2; cmd_start "$ws" >&2; } |
| 86 | + port="$(state_get "$dir" port)" |
| 87 | + local payload |
| 88 | + payload="$(jq -cn --arg method "$method" --argjson params "$params_json" '{method:$method,params:$params}')" |
| 89 | + curl -fsS -m 120 "http://localhost:$port/lsp" -X POST \ |
| 90 | + -H 'Content-Type: application/json' \ |
| 91 | + -d "$payload" || die "lsp call failed" |
| 92 | + echo |
| 93 | +} |
| 94 | + |
| 95 | +cmd_tools() { |
| 96 | + cat <<EOF |
| 97 | +java-direct exposes raw LSP methods (jdtls / Eclipse JDT.LS surface). |
| 98 | +invoke: java-direct call <method> '<json-params>' [workspace] |
| 99 | +
|
| 100 | +common methods: |
| 101 | + textDocument/documentSymbol outline of a .java file |
| 102 | + textDocument/hover type + javadoc at position |
| 103 | + textDocument/definition jump to definition |
| 104 | + textDocument/references find references |
| 105 | + textDocument/typeDefinition jump to type |
| 106 | + textDocument/implementation find implementations |
| 107 | + textDocument/completion completions at position |
| 108 | + textDocument/signatureHelp call signature |
| 109 | + textDocument/prepareCallHierarchy get call-hierarchy handle |
| 110 | + callHierarchy/incomingCalls callers |
| 111 | + callHierarchy/outgoingCalls callees |
| 112 | + workspace/symbol fuzzy search across workspace |
| 113 | +
|
| 114 | +params MUST include textDocument.uri as file://<abs-path> for textDocument/* methods. |
| 115 | +note: jdtls runs a background "Building workspace" job after start — workspace/symbol may return empty until it completes (typically 5-15s on small projects, longer on Maven/Gradle imports). |
| 116 | +
|
| 117 | +example: |
| 118 | + java-direct call textDocument/documentSymbol '{"textDocument":{"uri":"file:///path/to/Hello.java"}}' |
| 119 | +EOF |
| 120 | +} |
| 121 | + |
| 122 | +cmd_stop() { |
| 123 | + local ws dir pid |
| 124 | + ws="$(resolve_workspace "${1:-}")" |
| 125 | + dir="$(state_dir "$ws")" |
| 126 | + pid="$(state_get "$dir" pid)" |
| 127 | + if [ -n "$pid" ]; then |
| 128 | + kill "$pid" 2>/dev/null && echo "stopped: pid=$pid workspace=$ws" || echo "kill failed (pid=$pid) — state cleared for $ws" |
| 129 | + else |
| 130 | + echo "no pid for $ws" |
| 131 | + fi |
| 132 | + rm -f "$dir/pid" "$dir/port" |
| 133 | +} |
| 134 | + |
| 135 | +cmd_status() { |
| 136 | + [ -d "$STATE_ROOT" ] || { echo "no servers tracked"; return; } |
| 137 | + local any=0 |
| 138 | + for dir in "$STATE_ROOT"/*/; do |
| 139 | + [ -d "$dir" ] || continue |
| 140 | + any=1 |
| 141 | + local ws pid port alive |
| 142 | + ws="$(state_get "$dir" workspace)" |
| 143 | + pid="$(state_get "$dir" pid)" |
| 144 | + port="$(state_get "$dir" port)" |
| 145 | + alive="dead" |
| 146 | + [ -n "$port" ] && port_ready "$port" && alive="alive" |
| 147 | + printf 'workspace=%s port=%s pid=%s %s\n' "$ws" "$port" "$pid" "$alive" |
| 148 | + done |
| 149 | + [ "$any" = 0 ] && echo "no servers tracked" |
| 150 | +} |
| 151 | + |
| 152 | +case "${1:-}" in |
| 153 | + start) shift; cmd_start "$@" ;; |
| 154 | + call) shift; cmd_call "$@" ;; |
| 155 | + tools) shift; cmd_tools "$@" ;; |
| 156 | + stop) shift; cmd_stop "$@" ;; |
| 157 | + status) shift; cmd_status "$@" ;; |
| 158 | + ""|-h|--help) |
| 159 | + cat <<EOF |
| 160 | +java-direct — proxy jdtls (Eclipse JDT.LS) over persistent HTTP; one server per workspace |
| 161 | +
|
| 162 | +usage: |
| 163 | + java-direct start [workspace] spawn proxy for workspace (default: cwd walking up for pom.xml/build.gradle/settings.gradle/.project) |
| 164 | + java-direct call <method> '<json-params>' [ws] issue raw LSP method — auto-starts server |
| 165 | + java-direct tools list LSP method surface |
| 166 | + java-direct stop [workspace] kill server for workspace |
| 167 | + java-direct status show all tracked servers |
| 168 | +
|
| 169 | +workspace markers (walk-up order): ${WORKSPACE_MARKERS[*]} |
| 170 | +
|
| 171 | +state: $STATE_ROOT/<workspace-hash>/{pid,port,workspace,log} |
| 172 | +jdt-data (Eclipse workspace metadata): $STATE_ROOT/<workspace-hash>/jdt-data/ |
| 173 | +
|
| 174 | +prereqs: |
| 175 | + brew install jdtls # ships launcher script + Eclipse JDT.LS |
| 176 | + java >= 17 # JDK, not just JRE |
| 177 | +EOF |
| 178 | + ;; |
| 179 | + *) die "unknown subcommand: $1 (try --help)" ;; |
| 180 | +esac |
0 commit comments