Merge remote-tracking branch 'origin/main' into stlc/promote-next

Author: kernel-internal[bot]

src/kernel/types/config_registry_response.py

@@ -21,3 +21,11 @@ class ConfigRegistryResponse(BaseModel):
     """A recommendation or a structured no-recommendation result."""
 
     target: Target
+
+    guidance: Optional[str] = None
+    """Short advisory markdown to facilitate navigating this target.
+
+    Returned even when no configuration reached the target, since knowing what
+    prevented success is useful without a configuration. Not verified against this
+    target. Null when nothing applicable was observed or no notes exist.
+    """

src/kernel/types/lookup_response.py

@@ -13,3 +13,11 @@ class LookupResponse(BaseModel):
     recommendation: Optional[Recommendation] = None
 
     target: Target
+
+    guidance: Optional[str] = None
+    """Short advisory markdown to facilitate navigating this target.
+
+    Returned even when no configuration reached the target, since knowing what
+    prevented success is useful without a configuration. Not verified against this
+    target. Null when nothing applicable was observed or no notes exist.
+    """