Skip to content

fix(mongodb-java): use released Maven Central installation - #1054

Merged
nik13 merged 2 commits into
mainfrom
fix/mongodb-java-central-installation
Nov 4, 2026
Merged

nik13 merged 2 commits into
mainfrom
fix/mongodb-java-central-installation

Conversation

@nik13

@nik13 nik13 commented Oct 31, 2026

Copy link
Copy Markdown
Contributor

Summary

Correct the MongoDB section of the Java vector-database guide to use the packages already released on Maven Central.

  • Replace mutable JitPack coordinates with com.futureagi:traceai-java-core:1.0.0 and com.futureagi:traceai-java-mongodb:1.0.0 in both build tools. Explain replacing the old coordinates rather than mixing duplicate SDK classes.
  • Install the synchronous MongoDB driver explicitly (5.14.0); the instrumentation POM declares the driver as provided, so installing only the wrapper does not supply it.
  • Replace the incomplete snippet with a compilable search method, link initialization/privacy settings, and clarify that this explicit wrapper traces aggregation and result consumption, not arbitrary driver calls.
  • Add two page-contract regression tests to the existing integration test suite. No package APIs, versions, other database sections, or shared Java setup page change.

Keep the helper: it builds the vector-search pipeline, appends scores, and consumes results within a semantic RETRIEVER span. General command monitoring is not an equivalent replacement. The package is already released; this fix needs only a docs deployment.

Verification

  • The two new MongoDB documentation tests both fail on the original page and pass on this change, with outbound networking denied.
  • npm run test:integrations: 11 pass. npm run check:integrations, npm run audit-links, and npm run build pass. Link audit reports zero broken navigation/content links and the existing 28 orphan-page warnings. Pagefind retains existing redirect-page warnings.
  • Local released-package consumer: compile the exact Java block unchanged with Java 21 targeting Java 17, then execute against MongoDB driver 5.2.0 (the package's compile-time floor) and 5.14.0 (current). Both pass using only Central artifacts in an isolated Maven cache.
  • Synthetic collection/cursor fixtures check pipeline/filter construction, score results, the active span during cursor consumption, cursor errors, and insert/delete operations. A localhost HTTP receiver decodes actual OTLP protobuf exports and checks six spans, RETRIEVER/VECTOR_DB kinds, result counts, top score, error status, project resource, and no duplicate wrapper spans.
  • Test execution uses the supplied outbound-deny sandbox (localhost only), an empty environment with synthetic credentials, and JVM IPv4 sockets for localhost compatibility. No MongoDB Atlas, Future AGI Cloud, or model APIs were called. Gradle coordinates are checked for parity; no Gradle execution is claimed.
  • Built page inspected in headless Chrome at 1440×1100: Maven and Gradle tabs render and switch correctly, with no page errors. No product screenshot or live-service claim added to the guide.

Sources:

Review and scope

Internal-standards self-review found no blocking issues. No migration, application contract, runtime instrumentation, or privacy behavior changes. Ruff, migration, and application frontend-contract gates do not apply to this docs/test diff.

E2E coverage: not applicable (no e2e/ harness); flows hit: n/a; marker: n/a; verdict: not applicable.

Checked open traceAI/docs MongoDB and Java PRs before editing. Docs #1046 touches a separate ChromaDB section of the same page; it does not fix MongoDB and is not duplicated here.

🤖 Generated with Claude Code

nik13 and others added 2 commits October 31, 2026 08:01
Keep the semantic vector-search helper, explicitly install its provided driver, and replace incomplete setup with a compilable example. Guard Maven/Gradle coordinates and wrapper scope with regression tests.

Co-Authored-By: Claude Code <noreply@anthropic.com>
Preserve the MongoDB Maven Central checks alongside all integration regressions from main.

Co-Authored-By: Claude Code <noreply@anthropic.com>
@nik13
nik13 merged commit d9b2c00 into main Nov 4, 2026
10 checks passed
@nik13
nik13 deleted the fix/mongodb-java-central-installation branch November 4, 2026 12:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant