@lucern/sdk 1.0.9 → 1.0.11

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to `@lucern/sdk` will be documented in this file.
 ## [Unreleased]
 - No unreleased changes yet.
 
+## [1.0.11] - 2026-05-29
+- Release notes pending.
+
+## [1.0.10] - 2026-05-29
+- Release notes pending.
+
 ## [1.0.9] - 2026-05-29
 - Release notes pending.
 

package/README.md

@@ -46,6 +46,41 @@ code should stay on `@lucern/sdk`, `@lucern/react`, `@lucern/mcp`,
   control-plane operations must be added to the manifest first, then exposed
   through the generated surfaces.
 
+### Headless hybrid discovery
+
+The SDK exposes the same advanced discovery tools as CLI, MCP, and REST. Use
+the first-class namespaces from product code; use `raw.functionSurface` when
+you are building a generic manifest-driven runner.
+
+```typescript
+const discovered = await lucern.hybrid.discover({
+  query: "what have we built around graph-native discovery?",
+  include: ["topics", "nodes", "worktrees", "evidence"],
+  via: ["bm25", "embeddings", "topic-tree", "edges"],
+  depth: 2,
+  limit: 10,
+});
+
+const topic = await lucern.hybrid.resolveTopicSemantic({
+  query: "headless substrate surfaces",
+  via: ["bm25", "embeddings", "topic-tree"],
+  limit: 8,
+});
+
+const vectorMatches = await lucern.embeddings.vectorSearchByTopic({
+  workspaceId: "wks_...",
+  topicId: "top_...",
+  queryText: "semantic search for stale reasoning claims",
+  limit: 10,
+});
+```
+
+Surface parity is intentional: `lucern.hybrid.discover()` maps to the
+`hybrid_discover` manifest operation, `lucern discover`, the `hybrid_discover`
+MCP tool, and `POST /hybrid/discover`. The same pattern holds for
+`resolve_topic_semantic`, `expand_graph_neighborhood`, `find_related_nodes`,
+`analyze_graph_impact`, `detect_graph_drift`, and the embedding operations.
+
 IA-7 closes the remaining SDK surface gaps needed for SDK-first clients:
 
 - Kernel mutations that previously only existed behind route or MCP adapters now have SDK wrappers across beliefs, evidence, questions, edges, topics, worktrees, and nodes.

package/dist/beliefs/index.js

@@ -4276,6 +4276,15 @@ function createClientPlatformNamespaces(ctx) {
     bootstrap: {
       generateSessionHandoff: functionSurfaceClient.generateSessionHandoff
     },
+    hybrid: {
+      discover: functionSurfaceClient.hybridDiscover,
+      hybridDiscover: functionSurfaceClient.hybridDiscover,
+      resolveTopicSemantic: functionSurfaceClient.resolveTopicSemantic,
+      expandGraphNeighborhood: functionSurfaceClient.expandGraphNeighborhood,
+      findRelatedNodes: functionSurfaceClient.findRelatedNodes,
+      analyzeGraphImpact: functionSurfaceClient.analyzeGraphImpact,
+      detectGraphDrift: functionSurfaceClient.detectGraphDrift
+    },
     embeddings: embeddingsClient,
     graphAnalysis: graphAnalysisClient,
     graphRecommendations: graphRecommendationsClient,
@@ -9567,7 +9576,7 @@ function createToolRegistryClient(config = {}) {
 }
 
 // src/version.ts
-var LUCERN_SDK_VERSION = "1.0.9";
+var LUCERN_SDK_VERSION = "1.0.11";
 
 // src/workflowClient.ts
 function normalizeLensQuery(value) {