agent-bios 0.16.0 → 0.17.1

package/compose/corpus_ui.py

@@ -9,8 +9,11 @@ from __future__ import annotations
 import difflib
 import json
 import re
+from pathlib import PurePosixPath
 from typing import Any
-from urllib.parse import unquote
+from urllib.parse import quote, unquote
+
+from rich.text import Text
 
 from textual.app import App, ComposeResult
 from textual.binding import Binding
@@ -31,15 +34,55 @@ from textual.widgets import (
 )
 
 try:
-    from corpus_catalog import CLAUDE_HOOK_EVENTS
+    from corpus_catalog import HOOK_EVENTS
 except ImportError:  # pragma: no cover - package import from repository root
-    from .corpus_catalog import CLAUDE_HOOK_EVENTS
+    from .corpus_catalog import HOOK_EVENTS
 
 
 SURFACES = ("always", "relevant", "requested", "event", "delegated")
 VIEWS = ("effective", "installed", "change", "diff", "history")
 
 
+def guide_pointers(item: dict[str, Any], inventory: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    """Display literal guide references, not inferred dependencies or new routing."""
+    if item.get("kind") != "rule":
+        return []
+    paths = dict.fromkeys(re.findall(r"\bguides/[A-Za-z0-9][A-Za-z0-9_./-]*\.md\b", item.get("body", "")))
+    result = []
+    for path in paths:
+        if ".." in PurePosixPath(path).parts:
+            continue
+        matches = [candidate for candidate in inventory
+                   if candidate.get("package_id") == item.get("package_id")
+                   and candidate.get("kind") == "guide" and path in candidate.get("members", {})]
+        result.append({"path": path, "target": matches[0] if len(matches) == 1 else None,
+                       "problem": "Ambiguous guide reference" if matches else "Not found in this package"})
+    return result
+
+
+def library_label(item: dict[str, Any], inventory: list[dict[str, Any]]) -> Text:
+    pointers = guide_pointers(item, inventory)
+    label = Text()
+    if pointers:
+        label.append("→ GUIDE ", style="bold cyan")
+        label.append(", ".join(PurePosixPath(pointer["path"]).stem for pointer in pointers))
+        label.append(" · ")
+    label.append(f"{item.get('title', item.get('ref'))} · {item.get('surface', '?')}")
+    return label
+
+
+def render_member_body(body: str, member: str | None, kind: str | None = None) -> str:
+    """Render prose as Markdown and preserve source files as literal code."""
+    suffix = PurePosixPath(member).suffix.lower() if member else ""
+    if suffix in {".md", ".markdown"} or (not member and kind != "hook"):
+        return body
+    language = {".py": "python", ".json": "json", ".toml": "toml",
+                ".sh": "bash", ".zsh": "bash", ".yaml": "yaml", ".yml": "yaml",
+                ".js": "javascript", ".ts": "typescript"}.get(suffix, "")
+    fence = "`" * max(3, 1 + max((len(run) for run in re.findall(r"`+", body)), default=0))
+    return f"{fence}{language}\n{body}\n{fence}"
+
+
 class Confirmation(ModalScreen[bool]):
     """One bounded confirmation; the caller decides what the answer means."""
 
@@ -70,6 +113,9 @@ class CorpusMarkdownViewer(MarkdownViewer):
     """Keep all links inside Studio; never hand a URL to the operating system."""
 
     async def _on_markdown_link_clicked(self, message: Markdown.LinkClicked) -> None:
+        # stop() prevents bubbling, not the inherited MarkdownViewer handler.
+        # Its default go() would try to load corpus:// as a filesystem path.
+        message.prevent_default()
         message.stop()
         if message.href.startswith("corpus://"):
             ref = unquote(message.href.removeprefix("corpus://"))
@@ -181,8 +227,8 @@ class CorpusStudio(App[None]):
                                      id="editor-primary-member")
                     with Horizontal(id="hook-binding-row"):
                         yield Select(
-                            [(event, event) for event in sorted(CLAUDE_HOOK_EVENTS)],
-                            value=sorted(CLAUDE_HOOK_EVENTS)[0], allow_blank=False, id="editor-hook-event",
+                            [(event, event) for event in sorted(HOOK_EVENTS)],
+                            value=sorted(HOOK_EVENTS)[0], allow_blank=False, id="editor-hook-event",
                         )
                         yield Input(placeholder="Hook matcher", id="editor-hook-matcher")
                     yield TextArea(language="markdown", id="editor-body")
@@ -239,7 +285,7 @@ class CorpusStudio(App[None]):
                 groups[key] = state_nodes[state].add(package)
                 groups[key].expand()
             groups[key].add_leaf(
-                f"{item.get('title', item.get('ref'))} · {item.get('surface', '?')}",
+                library_label(item, self.items),
                 data=item.get("ref"),
             )
         tree.root.expand()
@@ -314,8 +360,7 @@ class CorpusStudio(App[None]):
             members[self.current_member] = self.query_one("#editor-body", TextArea).text
         return members
 
-    @staticmethod
-    def _render_item(row: dict[str, Any], result: dict[str, Any], view: str) -> str:
+    def _render_item(self, row: dict[str, Any], result: dict[str, Any], view: str) -> str:
         if view == "effective" and isinstance(result.get("item"), dict):
             item = result["item"]
             links = "\n".join(
@@ -330,11 +375,29 @@ class CorpusStudio(App[None]):
                     "Edit the body to the intended member text, or choose a primary member through the API."
                     + (f" Available members: {members}." if members else "") + "\n"
                 )
+            body = render_member_body(item.get("body", ""), item.get("primary_member"), item.get("kind"))
+            pointers = guide_pointers(item, self.items)
+            guide_links = ""
+            if pointers:
+                lines = []
+                for pointer in pointers:
+                    target = pointer["target"]
+                    if target is None:
+                        lines.append(f"- `{pointer['path']}` — {pointer['problem']}")
+                    else:
+                        destination = quote(target["ref"], safe="@/:")
+                        lines.append(f"- [{pointer['path']}](corpus://{destination}) — "
+                                     f"**{target['surface']}** · {target.get('state', 'active')}")
+                guide_links = (
+                    "## Guide pointer\n\nThis rule explicitly references the following guide(s). "
+                    "The rule keeps its own consumption surface; these links do not change "
+                    "delivery or prove that a guide was loaded.\n\n" + "\n".join(lines) + "\n\n## Rule\n\n"
+                )
             return (
                 f"# {item.get('title', item.get('ref'))}\n\n"
                 f"`{item.get('ref')}` · **{row.get('state', 'active')}** · "
                 f"{item.get('surface')} · {item.get('kind')}\n\n"
-                f"{reconciliation}\n{item.get('body', '')}\n\n## Dependencies\n\n{links}\n"
+                f"{guide_links}{reconciliation}\n{body}\n\n## Dependencies\n\n{links}\n"
                 + ("\n## Native consumption\n\nRequires explicit `agent-launch --corpus-native`.\n"
                    if item.get("kind") == "hook" else "")
             )
@@ -373,11 +436,8 @@ class CorpusStudio(App[None]):
                 body = item["members"][event.value]
                 if event.value == primary:
                     markdown = self._render_item(self._row() or item, {"item": item}, "effective")
-                elif event.value.endswith(".md"):
-                    markdown = f"# {event.value}\n\n{body}"
                 else:
-                    fence = "`" * (max(2, max((len(run) for run in re.findall(r'`+', body)), default=0)) + 1)
-                    markdown = f"# {event.value}\n\n{fence}\n{body}\n{fence}\n"
+                    markdown = f"# {event.value}\n\n{render_member_body(body, event.value)}\n"
                 await self.query_one("#wiki", CorpusMarkdownViewer).document.update(markdown)
 
     def editor_dirty(self) -> bool:
@@ -420,7 +480,7 @@ class CorpusStudio(App[None]):
         self.query_one("#editor-surface", Select).value = surface
         self.query_one("#hook-binding-row").styles.display = "block" if is_hook else "none"
         if is_hook:
-            event = hook.get("event") if isinstance(hook, dict) else sorted(CLAUDE_HOOK_EVENTS)[0]
+            event = hook.get("event") if isinstance(hook, dict) else sorted(HOOK_EVENTS)[0]
             matcher = hook.get("matcher") if isinstance(hook, dict) else ""
             self.query_one("#editor-hook-event", Select).value = event
             self.query_one("#editor-hook-matcher", Input).value = matcher
@@ -555,8 +615,8 @@ class CorpusStudio(App[None]):
         if self.editor_item.get("kind") == "hook":
             event = self.query_one("#editor-hook-event", Select).value
             matcher = self.query_one("#editor-hook-matcher", Input).value
-            if not isinstance(event, str) or event not in CLAUDE_HOOK_EVENTS:
-                raise ValueError("Choose a supported Claude hook event.")
+            if not isinstance(event, str) or event not in HOOK_EVENTS:
+                raise ValueError("Choose a supported hook event.")
             if not matcher or "\n" in matcher or "\r" in matcher:
                 raise ValueError("Hook matcher must be one non-empty line.")
             patch["hook"] = {"event": event, "matcher": matcher}