docs: address Copilot feedback - safer Java examples and fernignore polish

All 5 Copilot threads:

- .fernignore: add trailing slashes on .claude/ and .agents/ to match
  the file's dir/ convention. Add a comment explaining that CLAUDE.md
  is a defensive entry (file may not exist in every checkout).

- deepgram-java-speech-to-text/SKILL.md: guard channels + alternatives
  against empty results before indexing, matching the pattern in
  examples/listen/TranscribeUrl.java. Prevents IndexOutOfBoundsException
  on empty/quiet audio.

- deepgram-java-text-to-speech/SKILL.md: close the FileOutputStream in
  an onDisconnected handler (previously leaked the file handle); log IO
  errors in the audio callback rather than rethrowing RuntimeException
  from the WebSocket thread. Matches examples/speak/StreamingTts.java.

- deepgram-java-management-api/SKILL.md: guard projects.isEmpty() before
  indexing projects.get(0) — new accounts may have zero projects.

Author: lukeocodes

.agents/skills/deepgram-java-management-api/SKILL.md

@@ -49,7 +49,12 @@ for (ListProjectsV1ResponseProjectsItem project : projects) {
 
 ## Quick start — project models / keys
 
+Pick a project from the list above. New accounts may have zero projects — guard against that before indexing.
+
 ```java
+if (projects.isEmpty()) {
+    throw new IllegalStateException("No Deepgram projects are visible to this API key.");
+}
 String projectId = projects.get(0).getProjectId().orElseThrow();
 
 client.manage().v1().projects().models().list(projectId);

.agents/skills/deepgram-java-speech-to-text/SKILL.md

@@ -62,11 +62,21 @@ MediaTranscribeResponse result = client.listen().v1().media().transcribeUrl(requ
 result.visit(new MediaTranscribeResponse.Visitor<Void>() {
     @Override
     public Void visit(ListenV1Response response) {
-        String transcript = response.getResults()
-                .getChannels().get(0)
-                .getAlternatives().orElse(java.util.Collections.emptyList())
-                .get(0)
-                .getTranscript().orElse("");
+        // Guard channels + alternatives against empty results (matches examples/listen/TranscribeUrl.java).
+        String transcript = "";
+        java.util.List<?> channels = response.getResults().getChannels();
+        if (channels != null && !channels.isEmpty()) {
+            java.util.List<?> alternatives = response.getResults()
+                    .getChannels().get(0)
+                    .getAlternatives().orElse(java.util.Collections.emptyList());
+            if (!alternatives.isEmpty()) {
+                transcript = response.getResults()
+                        .getChannels().get(0)
+                        .getAlternatives().orElse(java.util.Collections.emptyList())
+                        .get(0)
+                        .getTranscript().orElse("");
+            }
+        }
         System.out.println(transcript);
         return null;
     }

.agents/skills/deepgram-java-text-to-speech/SKILL.md

@@ -57,17 +57,32 @@ import com.deepgram.resources.speak.v1.types.SpeakV1FlushType;
 import com.deepgram.resources.speak.v1.types.SpeakV1Text;
 import com.deepgram.resources.speak.v1.websocket.V1WebSocketClient;
 import java.io.FileOutputStream;
+import java.io.IOException;
 import java.io.OutputStream;
 import java.util.concurrent.TimeUnit;
+import java.util.logging.Level;
+import java.util.logging.Logger;
 
+Logger logger = Logger.getLogger("StreamingTts");
 V1WebSocketClient wsClient = client.speak().v1().v1WebSocket();
 OutputStream audioOutput = new FileOutputStream("output_streaming.wav");
 
+// Log write failures rather than throwing from the WebSocket callback thread
+// (matches examples/speak/StreamingTts.java).
 wsClient.onSpeakV1Audio(audioData -> {
     try {
         audioOutput.write(audioData.toByteArray());
-    } catch (Exception e) {
-        throw new RuntimeException(e);
+    } catch (IOException e) {
+        logger.log(Level.SEVERE, "Failed to write streaming audio to output file.", e);
+    }
+});
+
+// Close the output stream when the server disconnects so we don't leak the file handle.
+wsClient.onDisconnected(message -> {
+    try {
+        audioOutput.close();
+    } catch (IOException e) {
+        logger.log(Level.WARNING, "Failed to close streaming audio output file.", e);
     }
 });
 

.fernignore

@@ -50,8 +50,10 @@ examples/
 target/
 
 # Agent files (Claude Code, OpenCode, other agent tools)
-# .agents/skills/ holds agent-agnostic skills discoverable via `npx skills`
+# .agents/skills/ holds agent-agnostic skills discoverable via `npx skills`.
+# CLAUDE.md is kept here defensively alongside AGENTS.md — some agent tooling
+# expects one name, some the other, and layouts vary across checkouts.
 CLAUDE.md
 AGENTS.md
-.claude
-.agents
+.claude/
+.agents/