Add llms.txt and llms-all.txt endpoints for LLM-friendly content

src/main/java/io/jenkins/plugins/designlibrary/Home.java

@@ -3,10 +3,15 @@
 import hudson.Extension;
 import hudson.PluginWrapper;
 import hudson.model.RootAction;
+import java.io.IOException;
+import java.io.PrintWriter;
+import java.net.URL;
 import java.util.List;
 import java.util.Map;
 import java.util.concurrent.ThreadLocalRandom;
 import jenkins.model.Jenkins;
+import org.kohsuke.stapler.StaplerRequest2;
+import org.kohsuke.stapler.StaplerResponse2;
 
 /**
  * Entry point to all the UI samples.
@@ -45,15 +50,71 @@
      * Dynamically retrieves the appropriate UI sample based on the current URL
      */
     public UISample getDynamic(String name) {
+        String normalizedName = name != null && name.endsWith(".mdx") ? name.substring(0, name.length() - 4) : name;
         for (UISample ui : getAll()) {
             String urlName = ui.getUrlName();
-            if (urlName != null && urlName.equals(name)) {
+            if (urlName != null && urlName.equals(normalizedName)) {
                 return ui;
             }
         }
         return null;
     }
 
+    /**
+     * Serves LLM-friendly content as plain text markdown.
+     *
+     * <ul>
+     *   <li>{@code llms.txt} - index of all components with links to individual pages</li>
+     *   <li>{@code llms-all.txt} - all component documentation in a single file</li>
+     *   <li>{@code {component}.md} - documentation for a single component</li>
+     * </ul>
+     */
+    public void doDynamic(StaplerRequest2 req, StaplerResponse2 rsp) throws IOException {
+        String restOfPath = req.getRestOfPath();
+        if (restOfPath.startsWith("/")) {
+            restOfPath = restOfPath.substring(1);
+        }
+
+        String content = resolveLlmContent(restOfPath, req);
+        if (content != null) {
+            rsp.setContentType("text/plain;charset=UTF-8");
+            try (PrintWriter w = rsp.getWriter()) {
+                w.write(content);
+            }
+            return;
+        }
+
+        rsp.sendError(404);
+    }
+
+    private String resolveLlmContent(String name, StaplerRequest2 req) {
+        String baseUrl = req.getContextPath() + "/" + getUrlName() + "/";
+
+        if ("llms.txt".equals(name)) {
+            return LlmContent.generateIndex(baseUrl);
+        }
+
+        URL resourceBase = getPluginResourceBase();
+
+        if ("llms-all.txt".equals(name)) {
+            return LlmContent.generateAll(resourceBase);
+        }
+        if (name.endsWith(".md")) {
+            String componentName = name.substring(0, name.length() - 3);
+            for (UISample sample : getAll()) {
+                if (componentName.equals(sample.getUrlName())) {
+                    return LlmContent.generateComponentMarkdown(sample, resourceBase);
+                }
+            }
+        }
+        return null;
+    }
+
+    private URL getPluginResourceBase() {
+        PluginWrapper plugin = Jenkins.get().getPluginManager().getPlugin("design-library");
+        return plugin != null ? plugin.baseResourceURL : null;
+    }
+
     public String getPluginVersion() {
         Jenkins jenkins = Jenkins.get();
         PluginWrapper plugin = jenkins.getPluginManager().getPlugin("design-library");