release: prepare v0.8.0 (#57)

* release: prepare v0.8.0

Bumps pom.xml/Version.java to 0.8.0 and adds release notes covering the
four additive feature PRs (#53-#56): search, Nsql/NsqlGenerateSql,
active-query management, and async queries.

japicmp.oldVersion stays at 0.6.0 rather than bumping to 0.7.0: v0.7.0
was tagged and GitHub-released but its Maven Central publish never
completed, so it isn't a resolvable dependency. See the pom.xml comment
for detail.

* docs: reflect that #54 (search) and #55 (nsql) have merged

* docs: scope v0.8.0 to search + nsql only

#53 (active queries) and #56 (async queries) will not merge for this
release; remove them from the release notes' What's New and reflect
that in Release status instead of listing them as still-pending
dependencies.

* Update release notes for v0.8.0

Removed release status section and notes on features not included in v0.8.0.

* Update release notes for v0.8.0

Removed testing section from release notes for v0.8.0.

* Update release notes for v0.8.0

Removed highlights section from release notes for v0.8.0.

* Change japicmp.oldVersion from 0.6.0 to 0.7.0

Updated the old version for japicmp to 0.7.0.

Author: krinart

docs/release_notes/v0.8.0.md

@@ -0,0 +1,36 @@
+# Spice Java SDK v0.8.0
+
+## What's New
+
+### 🔎 Search
+
+`search()` finds documents similar to a piece of text via the runtime's `/v1/search` endpoint (vector, keyword, and hybrid search), for datasets with an embedding column and a loaded embedding model.
+
+```java
+SearchResponse response = client.search(
+    new SearchRequest("delayed flights to Seattle")
+        .withDatasets(List.of("flight_reviews"))
+        .withLimit(5));
+
+for (SearchMatch match : response.getResults()) {
+    System.out.println(match.getDataset() + ": " + match.getScore());
+}
+```
+
+### 🗣️ Natural Language to SQL (Nsql)
+
+`nsql()` translates a natural-language query into SQL via the runtime's configured LLM and runs it, returning the rows alongside the generated SQL. `nsqlGenerateSql()` generates the SQL without running it — inspect or edit it, or run it through `query()`/`queryWithParams()` for Arrow-typed results instead of `nsql()`'s decoded JSON rows.
+
+```java
+NsqlResponse response = client.nsql(new NsqlRequest("how many trips were over 10 miles?"));
+System.out.println(response.getSql());
+System.out.println(response.getData());
+
+String sql = client.nsqlGenerateSql(new NsqlRequest("how many trips were over 10 miles?"));
+```
+
+## Compatibility
+
+- Public API unchanged: both features are new methods; nothing existing was renamed, removed, or retyped.
+- No new dependencies.
+

pom.xml

@@ -4,7 +4,7 @@
     <groupId>ai.spice</groupId>
     <artifactId>spiceai</artifactId>
     <packaging>jar</packaging>
-    <version>0.7.0</version>
+    <version>0.8.0</version>
     <name>Java Spice SDK</name>
     <url>https://github.com/spiceai/spice-java/</url>
     <description>Spice provides a unified SQL query interface and portable runtime to locally materialize, accelerate, and query datasets from any database, data warehouse, or data lake.</description>
@@ -46,7 +46,7 @@
         <!-- The last published release, which the japicmp API-compatibility
              gate compares against. Bump when releasing; the publish workflow
              fails if this still equals the version being released. -->
-        <japicmp.oldVersion>0.6.0</japicmp.oldVersion>
+        <japicmp.oldVersion>0.7.0</japicmp.oldVersion>
     </properties>
     <dependencyManagement>
         <dependencies>

src/main/java/ai/spice/Version.java

@@ -30,6 +30,6 @@ public class Version {
     public static final String SPICE_JAVA_VERSION;
 
     static {
-        SPICE_JAVA_VERSION = "0.7.0";
+        SPICE_JAVA_VERSION = "0.8.0";
     }
 }