Skip to content

v1.7.0

Latest

Choose a tag to compare

@github-actions github-actions released this 15 Nov 15:49
e25dea0

jdx v1.7.0 — annotated views, jar metadata, Kotlin-true, setup complete

Minor release: six new query commands (annotated, literals, services,
modules, manifest, resources), Kotlin views that stop lying about
nullability and file facades, override-aware callers, and the last two
jdx setup backends (Windsurf + Aider) — the setup umbrella is now the full
ten agents. Plus a native Windows installer path. Exit codes are unchanged;
existing query shapes keep working. New commands and flags are additive.

Install

curl -fsSL https://raw.githubusercontent.com/MohammadMD1383/jdx/main/install-release.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/MohammadMD1383/jdx/main/install-release.ps1 | iex

Or download jdx-1.7.0-windows.zip from the assets below and run
install-release.ps1 / sh install-release.sh --tarball jdx-1.7.0-windows.zip.
Release installs self-update with jdx upgrade.

Releases are unsigned: expect a first-run warning — Unblock-File on
Windows (PowerShell), xattr -d com.apple.quarantine <install-dir>/jdx on
macOS.

jdx annotated + annotation --where (issue #26)

Dedicated annotation-driven view (also reachable as usages --kind annotation):

$ jdx annotated forRemoval --limit 5
$ jdx annotated 'Deprecated(forRemoval=true)'
$ jdx usages java.lang.Deprecated --kind annotation --where forRemoval=true

Recipe aliases: deprecated, forRemoval, test/junit5, junit4, bean.
--where key=value is repeatable (AND), understands dotted nested paths and
order-insensitive {…} arrays, and merges AnnotationDefault for omitted
elements when matching (printed @use stays explicit). Annotation-use spelling
on the CLI omits the leading @ (Clikt @file); MCP accepts @Type(k=v).

Jar metadata & resources (issue #25)

Command Answers
jdx services [pattern] META-INF/services SPI registrations
jdx modules [pattern] JPMS module-info (requires/exports/opens/uses/provides)
jdx manifest [pattern] MANIFEST.MF main attributes; --entries for JarEntry attrs
jdx resources [pattern] Non-class resource paths; --cat extracts unique text content

jdx literals (issue #86)

Search string constants across bytecode (LDC + String field ConstantValue)
and .properties resource keys/values. --regex, --ignore-case, --in /
--exclude, --limit. Properties hits render as prop path#key.

Graph & navigation upgrades

  • callers is override-aware by default (issue #6): includes call sites
    through overrides and declaring supertypes; --exact opts out.
    Constructors/static/private stay exact. calls stays bytecode-exact.
  • usages --context N (issue #10): inline source window around each site
    (capped at 15); 0 keeps file:line only.
  • Bytecode ref edges carry File.java:line when a LineNumberTable is
    present (issue #8).
  • samples --max-lines (issue #9): snippet cap is no longer hard-wired at 15.

Kotlin-true views

  • File facades and multi-file parts expose Kotlin property / suspend /
    @JvmName views instead of raw JVM projections (issue #12).
  • Nullability rendered from @Metadata (issue #13).
  • Mismatch-detector blind spots closed (Companion const, property removal)
    (issue #14).
  • Kotlin PSI covers facade file-docs, enum entries with bodies, and
    parameterised extensions (issue #15).

jdx setup: Windsurf + Aider (issues #38, #41)

The ninth and tenth backends — setup umbrella complete:

--agent Project scope System scope Version probe
windsurf (aliases devin, …) .devin/mcp_config.json, walk-up ~/.config/devin/mcp_config.json devin --version
aider (aliases aiderdesk, …) .aider-desk/mcp-servers.json, walk-up $AIDER_DESK_HOME_DIR/mcp-servers.json else ~/.aider-desk/… aiderdesk --version

Same merge discipline as the other eight: unrelated servers survive, re-runs
are byte-exact no-ops, --check reports without writing.

Also in setup/doctor: $HOME / $JDX_SETUP_HOME honouring (issue #85) and
single-line sanitized detected: probes (issue #84).

Windows installers (issue #92)

  • install-release.ps1 — fetch jdx-<version>-windows.zip, unpack into
    %LOCALAPPDATA%\Programs\jdx, write .jdx-release, add install dir to user
    PATH.
  • install.ps1 — local-from-dist twin with a jdx.cmd forwarder into
    %USERPROFILE%\.local\bin (no symlink / Developer Mode required).

Both stay ASCII-only for Windows PowerShell 5.1 (irm | iex).

Reliability / agent UX

  • Launcher reads the real java -version line past Picked up … option banners
    (issue #88).
  • Warm daemon text re-colorizes on TTY (issue #17); plain on the wire unchanged.
  • Warm exit 5 when the daemon cannot resolve coords is actionable (issue #18);
    daemon status labels indexed-artifacts 0 as live-roots-first (issue #4).
  • Text warnings go to stderr with a per-code cap; --json keeps the envelope
    warnings array (issue #86).
  • Vineflower $VF stubs treated as engine failures → javap fallback (issue #86).
  • Shell-expanded --jars/--src globs exit 3 with a quote-the-glob hint
    (issue #86).
  • Default search miss hints --kind method (issue #86).
  • Uppercase package segments resolve for soak corpora (issue #1).

Known limitations

  • Standing phase-2 backlog unchanged in kind: persistent-index acceleration
    (#5), mappings/remap
    (#24), --since
    (#27), dataflow-lite
    (#28), multi-release
    variant selection beyond the warning
    (#29).
  • usages --kind throw remains declaration-level (throws), not ATHROW
    sites — as documented in v1.6.1.
  • Kotlin bodies still need the ~55 MB compiler sidecar
    (#16).

Testing

  • Release gate: full ./gradlew check -Pci plus per-OS distribution builds and
    launcher smoke tests.
  • Fixture-corpus Test wiring centralized (issue #82); PIT javap-oracle fan-out
    bounded (issue #81).

PRs in this release

PR What
#94 Launcher reads java -version past JVM option banners (#88)
#95 Sanitize multi-line version probes in detected: (#84)
#96 Honour $HOME / JDX_SETUP_HOME for setup and doctor (#85)
#97 Centralize fixture-corpus Test wiring (#82)
#98 samples --max-lines (#9)
#99 Windsurf / Devin Local setup (#38)
#100 Aider / AiderDesk setup (#41)
#101 Windows install-release.ps1 / install.ps1 (#92)
#102 Hint --kind method on default search miss
#103 Daemon status live-roots-first label (#4)
#104 Quote hint for shell-expanded --jars/--src
#105 Vineflower $VF stubs → engine failure / javap fallback
#106 Text warnings to stderr with per-code cap
#107 LineNumberTable file:line on bytecode ref edges (#8)
#108 usages --context inline snippets (#10)
#109 Kotlin nullability from @Metadata (#13)
#110 Bound javap oracle / PIT threads under fan-out (#81)
#111 Kotlin mismatch-detector blind spots (#14)
#112 Re-colorize warm daemon text on TTY (#17)
#113 Actionable warm exit-5 when daemon cannot resolve coords (#18)
#114 Resolve uppercase package segments for soak (#1)
#115 Override-aware callers with --exact opt-out (#6)
#116 Kotlin-true file facades / multi-file parts (#12)
#117 Kotlin PSI for facade docs, enum bodies, generic extensions (#15)
#118 jdx literals string-constant search (#86)
#119 jdx services SPI listing (#25)
#120 jdx modules module-info listing (#25)
#121 jdx manifest attributes (#25)
#122 jdx resources path listing (#25)
#123 jdx manifest --entries (#25)
#124 jdx resources --cat (#25)
#125 .properties keys/values in literals (#86)
#126 usages --where annotation value predicates (#26)
#127 Peel annotation-use spelling in usages (#26)
#128 jdx annotated with recipe aliases (#26)
#129 Nested-path / array-aware annotation --where (#26)
#130 AnnotationValue AST + annotation-default merging (#26)

Full Changelog: v1.6.1...v1.7.0