Adds Discovery search and refactors UI fragments

Implements HTMX-driven search functionality for the Discovery page, leveraging new services and a dedicated controller endpoint.

Restructures common Thymeleaf layout fragments into a dedicated `fragments/layout` directory for improved organization and maintainability. Updates all affected controllers and templates.

Centralizes model attribute management by introducing helper methods in controllers for page-specific data and a `GlobalControllerAdvice` for application-wide data, such as available scopes.

Integrates the `force-graph` JavaScript library as a new dependency.

Author: aks8m

src/main/java/dev/ikm/server/cosmos/constellations/ConstellationsController.java

@@ -13,24 +13,27 @@ public class ConstellationsController {
 
 	Logger LOG = LoggerFactory.getLogger(ConstellationsController.class);
 
-	@GetMapping("/constellations")
-	public String getKnowledge(Model model) {
+	private void addSharedModelAttributes(Model model) {
 		model.addAttribute("activePage", "constellations");
+		model.addAttribute("titleDisplayName", "Constellations");
 		model.addAttribute("footerText", "Mapping the stars of knowledge");
+	}
+
+	@GetMapping("/constellations")
+	public String getKnowledge(Model model) {
+		addSharedModelAttributes(model);
 		return "constellations";
 	}
 
 	@HxRequest
 	@GetMapping("/constellations")
 	public FragmentsRendering getKnowledgeWithFragments(Model model) {
-		model.addAttribute("titleDisplayName", "Constellations");
-		model.addAttribute("activePage", "constellations");
-		model.addAttribute("footerText", "Mapping the stars of knowledge");
+		addSharedModelAttributes(model);
 		return FragmentsRendering
 				.with("constellations :: main-content")
-				.fragment("fragments/title :: title-content")
-				.fragment("fragments/navigation :: navigation-content")
-				.fragment("fragments/footer :: footer-content")
+				.fragment("fragments/layout/title :: title-content")
+				.fragment("fragments/layout/navigation :: navigation-content")
+				.fragment("fragments/layout/footer :: footer-content")
 				.build();
 	}
 }

src/main/java/dev/ikm/server/cosmos/discovery/DiscoveryController.java

@@ -3,34 +3,55 @@
 import io.github.wimdeblauwe.htmx.spring.boot.mvc.HxRequest;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Controller;
 import org.springframework.ui.Model;
 import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.servlet.view.FragmentsRendering;
 
 @Controller
 public class DiscoveryController {
 
 	Logger LOG = LoggerFactory.getLogger(DiscoveryController.class);
 
-	@GetMapping("/discovery")
-	public String getData(Model model) {
+	private final DiscoveryService discoveryService;
+	private final SearchService searchService;
+
+	@Autowired
+	public DiscoveryController(DiscoveryService discoveryService, SearchService searchService) {
+		this.discoveryService = discoveryService;
+		this.searchService = searchService;
+	}
+
+	private void addSharedModelAttributes(Model model) {
 		model.addAttribute("activePage", "discovery");
+		model.addAttribute("titleDisplayName", "Discovery");
 		model.addAttribute("footerText", "Navigate your knowledge universe");
+	}
+
+	@GetMapping("/discovery")
+	public String getData(Model model) {
+		addSharedModelAttributes(model);
 		return "discovery";
 	}
 
 	@HxRequest
 	@GetMapping("/discovery")
 	public FragmentsRendering getDataWithFragments(Model model) {
-		model.addAttribute("titleDisplayName", "Discovery");
-		model.addAttribute("activePage", "discovery");
-		model.addAttribute("footerText", "Navigate your knowledge universe");
+		addSharedModelAttributes(model);
 		return FragmentsRendering
 				.with("discovery :: main-content")
-				.fragment("fragments/title :: title-content")
-				.fragment("fragments/navigation :: navigation-content")
-				.fragment("fragments/footer :: footer-content")
+				.fragment("fragments/layout/title :: title-content")
+				.fragment("fragments/layout/navigation :: navigation-content")
+				.fragment("fragments/layout/footer :: footer-content")
 				.build();
 	}
+
+	@HxRequest
+	@GetMapping("/discovery/search")
+	public String search(@RequestParam("query") String query, Model model) {
+		searchService.search(query);
+		return "discovery-search";
+	}
 }

src/main/java/dev/ikm/server/cosmos/discovery/DiscoveryService.java

@@ -0,0 +1,15 @@
+package dev.ikm.server.cosmos.discovery;
+
+import dev.ikm.server.cosmos.api.coordinate.CalculatorService;
+import org.springframework.stereotype.Service;
+
+@Service
+public class DiscoveryService {
+
+	private final CalculatorService calculatorService;
+
+	public DiscoveryService(CalculatorService calculatorService) {
+		this.calculatorService = calculatorService;
+	}
+
+}

src/main/java/dev/ikm/server/cosmos/discovery/SearchResultDTO.java

@@ -0,0 +1,10 @@
+package dev.ikm.server.cosmos.discovery;
+
+import java.util.List;
+import java.util.UUID;
+
+public record SearchResultDTO(
+		List<UUID> id
+
+) {
+}

src/main/java/dev/ikm/server/cosmos/discovery/SearchService.java

@@ -0,0 +1,31 @@
+package dev.ikm.server.cosmos.discovery;
+
+import dev.ikm.server.cosmos.api.coordinate.CalculatorService;
+import dev.ikm.tinkar.coordinate.stamp.calculator.LatestVersionSearchResult;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Service
+public class SearchService {
+
+	private final CalculatorService calculatorService;
+
+	@Autowired
+	public SearchService(CalculatorService calculatorService) {
+		this.calculatorService = calculatorService;
+	}
+
+	public List<SearchResultDTO> search(String query) {
+		List<LatestVersionSearchResult> results = new ArrayList<>();
+		try {
+			results.addAll(calculatorService.getStampCalculator().search(query, 100).castToList());
+		} catch (Exception e) {
+			throw new RuntimeException(e);
+		}
+
+		return null;
+	}
+}

src/main/java/dev/ikm/server/cosmos/global/GlobalControllerAdvice.java

@@ -0,0 +1,25 @@
+package dev.ikm.server.cosmos.global;
+
+import dev.ikm.server.cosmos.scope.ScopeService;
+import org.springframework.ui.Model;
+import org.springframework.web.bind.annotation.ControllerAdvice;
+import org.springframework.web.bind.annotation.ModelAttribute;
+
+@ControllerAdvice
+public class GlobalControllerAdvice {
+
+	private final ScopeService scopeService;
+
+	public GlobalControllerAdvice(ScopeService scopeService) {
+		this.scopeService = scopeService;
+	}
+
+	@ModelAttribute
+	public void addGlobalAttributes(Model model) {
+		// This ensures 'scopes' is available on every page for the navigation dropdown
+		model.addAttribute("scopes", scopeService.retrieveAllScopes());
+
+		// You can also handle 'activeScope' here if it's stored in the session
+		// or determine it based on the request
+	}
+}

src/main/java/dev/ikm/server/cosmos/home/HomeController.java

@@ -13,24 +13,27 @@ public class HomeController {
 
 	Logger LOG = LoggerFactory.getLogger(HomeController.class);
 
-	@GetMapping("/home")
-	public String getHome(Model model) {
+	private void addSharedModelAttributes(Model model) {
 		model.addAttribute("activePage", "home");
+		model.addAttribute("titleDisplayName", "Home");
 		model.addAttribute("footerText", "Explore your knowledge universe");
+	}
+
+	@GetMapping("/home")
+	public String getHome(Model model) {
+		addSharedModelAttributes(model);
 		return "home";
 	}
 
 	@HxRequest
 	@GetMapping("/home")
 	public FragmentsRendering getHomeWithFragments(Model model) {
-		model.addAttribute("titleDisplayName", "Home");
-		model.addAttribute("activePage", "home");
-		model.addAttribute("footerText", "Explore your knowledge universe");
+		addSharedModelAttributes(model);
 		return FragmentsRendering
 				.with("home :: main-content")
-				.fragment("fragments/title :: title-content")
-				.fragment("fragments/navigation :: navigation-content")
-				.fragment("fragments/footer :: footer-content")
+				.fragment("fragments/layout/title :: title-content")
+				.fragment("fragments/layout/navigation :: navigation-content")
+				.fragment("fragments/layout/footer :: footer-content")
 				.build();
 	}
 }

src/main/java/dev/ikm/server/cosmos/portal/PortalController.java

@@ -13,24 +13,27 @@ public class PortalController {
 
 	Logger LOG = LoggerFactory.getLogger(PortalController.class);
 
-	@GetMapping("/portal")
-	public String getQuality(Model model) {
+	private void addSharedModelAttributes(Model model) {
 		model.addAttribute("activePage", "portal");
+		model.addAttribute("titleDisplayName", "Portal");
 		model.addAttribute("footerText", "Gateway to the Cosmos AI");
+	}
+
+	@GetMapping("/portal")
+	public String getQuality(Model model) {
+		addSharedModelAttributes(model);
 		return "portal";
 	}
 
 	@HxRequest
 	@GetMapping("/portal")
 	public FragmentsRendering getQualityWithFragments(Model model) {
-		model.addAttribute("titleDisplayName", "Portal");
-		model.addAttribute("activePage", "portal");
-		model.addAttribute("footerText", "Gateway to the Cosmos AI");
+		addSharedModelAttributes(model);
 		return FragmentsRendering
 				.with("portal :: main-content")
-				.fragment("fragments/title :: title-content")
-				.fragment("fragments/navigation :: navigation-content")
-				.fragment("fragments/footer :: footer-content")
+				.fragment("fragments/layout/title :: title-content")
+				.fragment("fragments/layout/navigation :: navigation-content")
+				.fragment("fragments/layout/footer :: footer-content")
 				.build();
 	}
 }

src/main/java/dev/ikm/server/cosmos/query/QueryController.java

@@ -13,24 +13,27 @@ public class QueryController {
 
 	Logger LOG = LoggerFactory.getLogger(QueryController.class);
 
-	@GetMapping("/query")
-	public String getQuery(Model model) {
+	private void addSharedModelAttributes(Model model) {
 		model.addAttribute("activePage", "query");
+		model.addAttribute("titleDisplayName", "Query");
 		model.addAttribute("footerText", "Precise knowledge retrieval");
+	}
+
+	@GetMapping("/query")
+	public String getQuery(Model model) {
+		addSharedModelAttributes(model);
 		return "query";
 	}
 
 	@HxRequest
 	@GetMapping("/query")
 	public FragmentsRendering getQueryWithFragments(Model model) {
-		model.addAttribute("titleDisplayName", "Query");
-		model.addAttribute("activePage", "query");
-		model.addAttribute("footerText", "Precise knowledge retrieval");
+		addSharedModelAttributes(model);
 		return FragmentsRendering
 				.with("query :: main-content")
-				.fragment("fragments/title :: title-content")
-				.fragment("fragments/navigation :: navigation-content")
-				.fragment("fragments/footer :: footer-content")
+				.fragment("fragments/layout/title :: title-content")
+				.fragment("fragments/layout/navigation :: navigation-content")
+				.fragment("fragments/layout/footer :: footer-content")
 				.build();
 	}
 }

src/main/java/dev/ikm/server/cosmos/rules/RulesController.java

@@ -13,24 +13,27 @@ public class RulesController {
 
 	Logger LOG = LoggerFactory.getLogger(RulesController.class);
 
-	@GetMapping("/rules")
-	public String getQuery(Model model) {
+	private void addSharedModelAttributes(Model model) {
 		model.addAttribute("activePage", "rules");
+		model.addAttribute("titleDisplayName", "Rules");
 		model.addAttribute("footerText", "Automation and logic management");
+	}
+
+	@GetMapping("/rules")
+	public String getQuery(Model model) {
+		addSharedModelAttributes(model);
 		return "rules";
 	}
 
 	@HxRequest
 	@GetMapping("/rules")
 	public FragmentsRendering getQueryWithFragments(Model model) {
-		model.addAttribute("titleDisplayName", "Rules");
-		model.addAttribute("activePage", "rules");
-		model.addAttribute("footerText", "Automation and logic management");
+		addSharedModelAttributes(model);
 		return FragmentsRendering
 				.with("rules :: main-content")
-				.fragment("fragments/title :: title-content")
-				.fragment("fragments/navigation :: navigation-content")
-				.fragment("fragments/footer :: footer-content")
+				.fragment("fragments/layout/title :: title-content")
+				.fragment("fragments/layout/navigation :: navigation-content")
+				.fragment("fragments/layout/footer :: footer-content")
 				.build();
 	}
 }