fix(serve): invoke GraphBootstrapper directly instead of via dead ApplicationReadyEvent listener

GraphBootstrapper's H2->Neo4j fallback was registered for
@eventlistener(ApplicationReadyEvent.class), but that event never
fires during a normal serve run because ServeCommand.call() blocks
in Thread.join() as a CommandLineRunner. Consequence: if someone
shipped a bundle with only the H2 analysis cache (no enriched Neo4j
graph) and ran `code-iq serve`, Neo4j would stay empty forever and
graph-traversal queries would return nothing. Not observed in our
pipeline today only because `enrich` always runs before `serve`.

Fix:
- Drop @eventlistener from bootstrapNeo4jFromCache() and its
  associated imports (ApplicationReadyEvent, @eventlistener).
- ServeCommand.call() now calls graphBootstrapper.bootstrapNeo4jFromCache()
  explicitly before the Neo4j status report, so the advertised
  node/edge counts reflect post-bootstrap state. Injection is
  Optional since the bean only exists in the "serving" profile
  (matches the existing @Profile + @ConditionalOnBean guards).
- Class javadoc updated to document the new invocation model and
  the reason the event-listener path did not work.

The method is idempotent (guards on count>0 and on missing H2 file),
so moving the invocation is safe even in scenarios where Neo4j is
already populated by `enrich`.

Tests: existing GraphBootstrapperTest still passes unchanged (it calls
the method directly).

Integration verification:
  # full pipeline to populate both H2 + Neo4j
  ./scripts/baseline/run-pipeline.sh spring-petclinic
  # wipe ONLY Neo4j; keep H2
  rm -rf .seeds/spring-petclinic/.code-iq/graph
  # re-run serve
  java -jar target/code-iq-*-cli.jar serve .seeds/spring-petclinic --port 18080 &
  # wait for /actuator/health=200, then:
  curl http://127.0.0.1:18080/api/stats

Before this fix: Neo4j empty, stats=0.
After this fix:  log shows "Bootstrapped Neo4j with 634 nodes and
                  604 edges from H2 cache", /api/stats returns 677
                  nodes / 604 edges / 65 files.

Author: aksOps

src/main/java/io/github/randomcodespace/iq/cli/ServeCommand.java

@@ -1,6 +1,7 @@
 package io.github.randomcodespace.iq.cli;
 
 import io.github.randomcodespace.iq.config.CodeIqConfig;
+import io.github.randomcodespace.iq.config.GraphBootstrapper;
 import io.github.randomcodespace.iq.graph.GraphStore;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -63,6 +64,10 @@ public class ServeCommand implements Callable<Integer> {
     @Autowired
     private ApplicationEventPublisher events;
 
+    // Optional: only present in the "serving" profile (same conditions as the bean).
+    @Autowired(required = false)
+    private GraphBootstrapper graphBootstrapper;
+
     @Override
     public Integer call() {
         Path root = path.toAbsolutePath().normalize();
@@ -72,6 +77,15 @@ public Integer call() {
         }
         NumberFormat nf = NumberFormat.getIntegerInstance(Locale.US);
 
+        // Bootstrap Neo4j from the H2 analysis cache if Neo4j is empty. This is
+        // a no-op when enrich has already run (guarded internally by a count>0
+        // check) and when the H2 cache file is missing. Must happen before the
+        // status report below so the advertised node/edge counts are truthful.
+        // See GraphBootstrapper javadoc for why this is not an @EventListener.
+        if (graphBootstrapper != null) {
+            graphBootstrapper.bootstrapNeo4jFromCache();
+        }
+
         // Report Neo4j graph status
         if (graphStore != null) {
             try {

src/main/java/io/github/randomcodespace/iq/config/GraphBootstrapper.java

@@ -7,9 +7,7 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnBean;
-import org.springframework.boot.context.event.ApplicationReadyEvent;
 import org.springframework.context.annotation.Profile;
-import org.springframework.context.event.EventListener;
 import org.springframework.stereotype.Component;
 
 import java.nio.file.Files;
@@ -25,7 +23,13 @@
  * {@code serve} (which needs Neo4j for graph traversal queries like shortest path,
  * cycles, impact trace, ego graph, and neighbors).
  * <p>
- * Runs after the Spring context is fully ready, so Neo4j and GraphStore are available.
+ * Invoked explicitly by {@link io.github.randomcodespace.iq.cli.ServeCommand}
+ * before the server reports "Server started", so the advertised node/edge counts
+ * reflect the bootstrapped state. Previously triggered via
+ * {@code @EventListener(ApplicationReadyEvent.class)}, but that event never fires
+ * because {@code ServeCommand.call()} blocks (as a {@code CommandLineRunner}) and
+ * Spring's ready-event publication waits for runners to return.
+ * <p>
  * Only active in the "serving" profile when GraphStore is present.
  */
 @Component
@@ -43,7 +47,6 @@ public GraphBootstrapper(GraphStore graphStore, CodeIqConfig config) {
         this.config = config;
     }
 
-    @EventListener(ApplicationReadyEvent.class)
     public void bootstrapNeo4jFromCache() {
         // Skip bootstrap in read-only mode (no writes allowed)
         if (config.isReadOnly()) {