fix: Spring Boot 4.0 bean lifecycle + DevTools classloader compatibility

- AtmosphereFramework bean not available during auto-config creation
- Use ApplicationReadyEvent for deferred handler registration
- Use reflection for cross-classloader DevTools compatibility
- Lazy framework lookup via ApplicationContext
- Add spring-devtools.properties for classloader inclusion

Author: jfarcand

src/main/java/ai/javaclaw/channels/atmosphere/AtmosphereChannelAutoConfiguration.java

@@ -17,7 +17,6 @@
 
 import ai.javaclaw.agent.Agent;
 import ai.javaclaw.channels.ChannelRegistry;
-import org.atmosphere.cpr.AtmosphereFramework;
 import org.springframework.ai.chat.client.ChatClient;
 import org.springframework.ai.chat.model.ChatModel;
 import org.springframework.boot.autoconfigure.AutoConfiguration;
@@ -43,7 +42,7 @@
  * {@code Agent} are on the classpath.</p>
  */
 @AutoConfiguration
-@ConditionalOnClass(AtmosphereFramework.class)
+@ConditionalOnClass(org.atmosphere.cpr.AtmosphereFramework.class)
 @ConditionalOnBean(Agent.class)
 public class AtmosphereChannelAutoConfiguration {
 
@@ -57,18 +56,28 @@ public ChatModel syntheticChatModel() {
     @Bean
     public AtmosphereChatChannel atmosphereChatChannel(Agent agent,
                                                        ChannelRegistry channelRegistry,
-                                                       AtmosphereFramework framework) {
-        return new AtmosphereChatChannel(agent, channelRegistry, framework);
+                                                       org.springframework.context.ApplicationContext ctx) {
+        // Lazy lookup: AtmosphereFramework bean is created during servlet init
+        return new AtmosphereChatChannel(agent, channelRegistry, ctx);
     }
 
     @Bean
     public AtmosphereChatHandler atmosphereChatHandler(ChatClient chatClient,
                                                        ChannelRegistry channelRegistry,
                                                        ObjectMapper objectMapper,
-                                                       AtmosphereFramework framework) {
-        var handler = new AtmosphereChatHandler(chatClient, channelRegistry, objectMapper);
-        framework.addAtmosphereHandler(AtmosphereChatChannel.BROADCASTER_PATH, handler);
-        return handler;
+                                                       org.springframework.context.ApplicationContext ctx) {
+        return new AtmosphereChatHandler(chatClient, channelRegistry, objectMapper, ctx);
+    }
+
+    /**
+     * Registers the chat handler with Atmosphere after the web server starts.
+     * Uses ApplicationReadyEvent
+     * to ensure the servlet container (and Atmosphere) is fully initialized.
+     */
+    @Bean
+    public org.springframework.context.ApplicationListener<org.springframework.boot.context.event.ApplicationReadyEvent>
+    atmosphereHandlerRegistrar(AtmosphereChatHandler handler) {
+        return event -> handler.ensureRegistered();
     }
 
     /**

src/main/java/ai/javaclaw/channels/atmosphere/AtmosphereChatChannel.java

@@ -40,17 +40,25 @@ public class AtmosphereChatChannel implements Channel {
 
     private final Agent agent;
     private final ChannelRegistry channelRegistry;
-    private final AtmosphereFramework framework;
+    private final org.springframework.context.ApplicationContext ctx;
+    private volatile AtmosphereFramework framework;
 
     public AtmosphereChatChannel(Agent agent, ChannelRegistry channelRegistry,
-                                 AtmosphereFramework framework) {
+                                 org.springframework.context.ApplicationContext ctx) {
         this.agent = agent;
         this.channelRegistry = channelRegistry;
-        this.framework = framework;
+        this.ctx = ctx;
         channelRegistry.registerChannel(this);
         log.info("Started Atmosphere Chat channel");
     }
 
+    private AtmosphereFramework framework() {
+        if (framework == null) {
+            framework = ctx.getBean(AtmosphereFramework.class);
+        }
+        return framework;
+    }
+
     @Override
     public String getName() {
         return CHANNEL_NAME;
@@ -73,7 +81,7 @@ public String chat(String message) {
      */
     @Override
     public void sendMessage(String message) {
-        BroadcasterFactory factory = framework.getBroadcasterFactory();
+        BroadcasterFactory factory = framework().getBroadcasterFactory();
         if (factory == null) {
             log.warn("Atmosphere framework not yet initialized, message dropped");
             return;

src/main/java/ai/javaclaw/channels/atmosphere/AtmosphereChatHandler.java

@@ -49,14 +49,46 @@ public class AtmosphereChatHandler implements AtmosphereHandler {
     private final ChatClient chatClient;
     private final ChannelRegistry channelRegistry;
     private final ObjectMapper objectMapper;
+    private final org.springframework.context.ApplicationContext ctx;
+    private volatile boolean registered;
 
     public AtmosphereChatHandler(ChatClient chatClient, ChannelRegistry channelRegistry,
-                                 ObjectMapper objectMapper) {
+                                 ObjectMapper objectMapper,
+                                 org.springframework.context.ApplicationContext ctx) {
         this.chatClient = chatClient;
         this.channelRegistry = channelRegistry;
+        this.ctx = ctx;
         this.objectMapper = objectMapper;
     }
 
+    /**
+     * Lazily registers this handler with the Atmosphere framework on first request.
+     * This deferred registration avoids the Spring Boot 4.0 bean lifecycle ordering
+     * issue where the AtmosphereFramework bean isn't available at auto-config time.
+     */
+    void ensureRegistered() {
+        if (!registered) {
+            synchronized (this) {
+                if (!registered) {
+                    try {
+                        // Use full reflection to avoid DevTools dual-classloader ClassCastException
+                        var reg = ctx.getBean("atmosphereServletRegistration");
+                        var servlet = reg.getClass().getMethod("getServlet").invoke(reg);
+                        var framework = servlet.getClass().getMethod("framework").invoke(servlet);
+                        framework.getClass().getMethod("addAtmosphereHandler",
+                                        String.class, org.atmosphere.cpr.AtmosphereHandler.class)
+                                .invoke(framework, AtmosphereChatChannel.BROADCASTER_PATH, this);
+                        registered = true;
+                        log.info("Registered Atmosphere chat handler at {}",
+                                AtmosphereChatChannel.BROADCASTER_PATH);
+                    } catch (Exception e) {
+                        log.error("Failed to register Atmosphere handler: {}", e.getMessage());
+                    }
+                }
+            }
+        }
+    }
+
     @Override
     public void onRequest(AtmosphereResource resource) throws IOException {
         String body = resource.getRequest().body().asString();

src/main/java/ai/javaclaw/channels/atmosphere/JavaClawAgentBridge.java

@@ -39,8 +39,8 @@
  * <p>Exposes:</p>
  * <ul>
  *   <li>{@code @Prompt} — streaming AI chat via WebSocket</li>
- *   <li>{@code @AgentSkill("chat")} — A2A-discoverable chat skill</li>
- *   <li>{@code @AgentSkill("ask")} — synchronous Q&A via JavaClaw agent</li>
+ *   <li>AgentSkill chat — A2A-discoverable chat skill</li>
+ *   <li>AgentSkill ask — synchronous QA via JavaClaw agent</li>
  * </ul>
  */
 public class JavaClawAgentBridge {

src/main/resources/META-INF/spring-devtools.properties

@@ -0,0 +1 @@
+restart.include.javaclaw=/javaclaw-.*\.jar