feat(terraphim): enrich KG with ast-grep code anchors + refresh script

Alex · Alex · commit ba07485eb125 · 2026-06-29T09:37:11.000+01:00
Structurally-derived identifiers (pub struct/enum/trait + impl Provider)
mined via ast-grep now back each concept, so terraphim-grep matches real
code tokens (ReadTool, AnthropicProvider, ModelRegistry, AuthStorage, ...)
instead of prose only. KG-boosted chunks now rank the actual definition
files (e.g. providers/anthropic.rs, tools.rs) above baseline.

- kg/*.md: appended curated, name-selective code anchors per concept
  (provider/session/extension/model-registry/sse/acp/auth/interactive-tui/
  tool/hashline-edit). Thesaurus grew from 180 -&gt; 409 entries.
- scripts/refresh-anchors.sh: repeatable, idempotent refresh — re-runs the
  ast-grep extraction, appends new anchors, regenerates thesaurus.json.
  Run it whenever the code changes to keep the KG aligned.

Anchors are selective (name patterns, not file-wide dumps) to keep the
thesaurus signal-rich. Idempotent: a second run appends 0.
diff --git a/.terraphim/kg/acp.md b/.terraphim/kg/acp.md
@@ -6,4 +6,4 @@ Agent Client Protocol support. `pi --acp` runs pi as an ACP server (stdin JSON-R
 
 Related: interactive-tui, session, rpc
 
-synonyms:: acp, agent client protocol, --acp, acp server, acp session, set_model, set_config_option, session-dir, json-rpc server, rpc mode, stdin mode, rpc
+synonyms:: acp, agent client protocol, --acp, acp server, acp session, set_model, set_config_option, session-dir, json-rpc server, rpc mode, stdin mode, rpc, AcpOptions
diff --git a/.terraphim/kg/auth.md b/.terraphim/kg/auth.md
@@ -6,4 +6,4 @@ Credential storage and OAuth flows (`src/auth.rs`). `auth.json` (perms 600) at `
 
 Related: provider, interactive-tui
 
-synonyms:: auth, authentication, oauth, auth.json, login, /login, credentials, oauth token, token expired, api key, openai-codex login, kimi oauth, copilot login, auth storage, re-login
+synonyms:: auth, authentication, oauth, auth.json, login, /login, credentials, oauth token, token expired, api key, openai-codex login, kimi oauth, copilot login, auth storage, re-login, PendingOAuth, OAuthConfig, AuthDiagnostic, AuthFile, AuthStorage, OAuthStartInfo, OAuthCallbackServer, CopilotOAuthConfig, GitLabOAuthConfig, AuthCredential, AuthDiagnosticCode
diff --git a/.terraphim/kg/extension.md b/.terraphim/kg/extension.md
@@ -6,4 +6,4 @@ JavaScript extension runtime on QuickJS with a capability policy layer. Extensio
 
 Related: tool, provider, conformance
 
-synonyms:: extension, extensions, quickjs, quickjs runtime, javascript extension, capability policy, hostcall, hostcalls, extension runtime, wasm host, wasmtime, extension parity, extension taxonomy, extension oauth
+synonyms:: extension, extensions, quickjs, quickjs runtime, javascript extension, capability policy, hostcall, hostcalls, extension runtime, wasm host, wasmtime, extension parity, extension taxonomy, extension oauth, ExtensionTrustTracker, ExtensionCliFlag, HostcallRewritePlan, HostcallRewriteDecision, HostcallRewriteEngine, ExtensionIndex, ExtensionIndexEntry, ExtensionSearchHit, ExtensionSafetyProvenance, ExtensionIndexRefreshStats, ExtensionIndexStore, ExtensionResourcePaths, HostcallRequest, ExtensionToolDef, ExtensionRepairEvent, CapabilityProofReport, CapabilityPromptOverlay, ExtensionCustomOverlay, ExtensionToolWrapper, HostcallSuperinstructionPlan, HostcallSuperinstructionCompiler, HostcallSuperinstructionSelection, HostcallSuperinstructionExecution, HostcallQueueTelemetry, HostcallEpochPin, ExtensionPolicyConfig, ExtensionRiskConfig, ExtensionConformanceResult, ExtensionRegression, CompatCapabilityEvidence, ExtensionOverride, ExtensionPolicy, ExtensionQuotaConfig, ExtensionBudgetControllerConfig, BaselineCapabilityProfile, RuntimeHostcallSequenceContext, RuntimeHostcallFeatureVector, RuntimeHostcallTelemetryEvent, RuntimeHostcallTelemetryArtifact, AdaptiveHostcallPolicyDiffConfig, AdaptiveHostcallPolicySampleSupport, AdaptiveHostcallPolicyTelemetryMetrics, AdaptiveHostcallPolicyLatencyEffect, AdaptiveHostcallPolicyLaneChange, AdaptiveHostcallPolicyActionChange, AdaptiveHostcallPolicyThresholdChange, AdaptiveHostcallPolicyRollbackCondition, AdaptiveHostcallPolicyDiffReport, CapabilityExplanation, ExtensionMessage, CapabilityManifest, CapabilityRequirement, CapabilityScope, CapabilityProvenance, CapabilityIntegrityAttestation, CapabilityPublisherAttestation, HostcallReactorConfig, HostcallReactorRequest, HostcallReactorCompletion, HostcallReactorBackpressure, HostcallReactorTelemetry, HostcallReactorMesh, ExtensionUiRequest, ExtensionUiResponse, ExtensionSendMessage, ExtensionSendUserMessage, ExtensionAiCompletionRequest, ExtensionManifest, ExtensionManifestSource, ExtensionPermissionSnapshot, ExtensionPermissionDriftReport, ExtensionManager, ExtensionManagerHandle, ExtensionRegion, ExtensionIndexSource, HostcallOutcome, ExtensionTrustState, ExtensionEvent, ExtensionShape, HostcallRewritePlanKind, ExtensionCategory, HostcallQueueMode, HostcallQueueEnqueueResult, CapabilityAction, HostcallKind, CapabilityDelta, CapabilityMonotonicityVerdict, HostcallCategory, HostcallDelta, HostcallDispatchLane, HostcallIoHint, HostcallCapabilityClass, HostCapability, Capability, ExtensionPolicyMode, ExtensionBudgetTier, AdaptiveHostcallPolicyDiffVerdict, ExtensionBody, CommonHostcallOpcode, ExtensionDeliverAs, ExtensionEventName, ExtensionRuntime, ExtensionPermissionTrust, ExtensionPermissionDriftClass, ExtensionPermissionRiskLevel, ExtensionPermissionProvenanceStatus, ExtensionPermissionDriftVerdict, ExtensionLoadSpec, ExtensionRuntimeHandle, ExtensionRuntimeEngineSelection, ExtensionStreamSimpleProvider
diff --git a/.terraphim/kg/hashline-edit.md b/.terraphim/kg/hashline-edit.md
@@ -6,4 +6,4 @@ Precise-edit tool using `LINE#HASH` anchors emitted by `read`/`grep` with `hashl
 
 Related: tool
 
-synonyms:: hashline_edit, hashline, line hash, hash line, precise edit, line hash edit, hash anchor, LINE#HASH, hashline edit tool
+synonyms:: hashline_edit, hashline, line hash, hash line, precise edit, line hash edit, hash anchor, LINE#HASH, hashline edit tool, HashlineEditTool
diff --git a/.terraphim/kg/interactive-tui.md b/.terraphim/kg/interactive-tui.md
@@ -6,4 +6,4 @@ Interactive terminal front-end (`src/interactive.rs`, `src/tui.rs`) built on the
 
 Related: rpc, acp, model-registry
 
-synonyms:: interactive, tui, interactive tui, terminal ui, bubbletea, charmed_rust, lipgloss, glamour, slash command, /login, /model, /mcp, mouse capture, pi no mouse capture, frontend
+synonyms:: interactive, tui, interactive tui, terminal ui, bubbletea, charmed_rust, lipgloss, glamour, slash command, /login, /model, /mcp, mouse capture, pi no mouse capture, frontend, TreeSelectorRow, TreeSelectorState, PiApp, SessionPickerOverlay, ThemePickerOverlay, BranchPickerOverlay, ThemePickerItem
diff --git a/.terraphim/kg/model-registry.md b/.terraphim/kg/model-registry.md
@@ -6,4 +6,4 @@ Model resolution layer (`src/models.rs`, `src/app.rs`). Resolves `ModelEntry` re
 
 Related: provider, interactive-tui, auth
 
-synonyms:: model registry, modelregistry, model entry, modelentry, models.json, model catalog, built-in models, provider default models, model resolution, autocomplete, reasoning effort, thinking control, default model, model id, model fetch, kimi-k2.7, glm-5.2
+synonyms:: model registry, modelregistry, model entry, modelentry, models.json, model catalog, built-in models, provider default models, model resolution, autocomplete, reasoning effort, thinking control, default model, model id, model fetch, kimi-k2.7, glm-5.2, RpcModelInfo, RpcCycleModelResult, ModelKey, ModelSelectorOverlay, RpcScopedModel, ScopedModel, ModelSelection, Model, ModelCost, ModelRoutingEvidence, ModelsConfig, ModelConfig, ModelAutocompleteCandidate, ModelChangeEntry, RuntimeRiskBaselineModel
diff --git a/.terraphim/kg/provider.md b/.terraphim/kg/provider.md
@@ -6,4 +6,4 @@ Abstract LLM backend implementing the `Provider` trait (`src/provider.rs`). pi_a
 
 Related: model-registry, sse, auth, tool
 
-synonyms:: provider, llm backend, llm provider, anthropic, openai, openai-codex, codex, gemini, google, cohere, azure, bedrock, vertex, github copilot, copilot, gitlab duo, gitlab, kimi, kimi-for-coding, deepseek, minimax, zai, provider trait, streaming provider
+synonyms:: provider, llm backend, llm provider, anthropic, openai, openai-codex, codex, gemini, google, cohere, azure, bedrock, vertex, github copilot, copilot, gitlab duo, gitlab, kimi, kimi-for-coding, deepseek, minimax, zai, provider trait, streaming provider, VertexProvider, CopilotProvider, AzureOpenAIProvider, AnthropicProvider, OpenAIResponsesProvider, OpenAIProvider, AutocompleteProvider, GeminiProvider, GitLabProvider, CohereProvider, BedrockProvider, KnownProvider, ExtensionStreamSimpleProvider, ToolCallingProvider, DummyProvider, NoopProvider, IdleCommandProvider, ToolUseProvider, PiAiCaptureProvider, HangingProvider, CountingProvider, PhasedProvider, ToolCallProvider, SingleShotProvider, StreamSetupErrorProvider, ToolTurnProvider, SilentProvider, DeltaOnlyProvider, CapturingProvider, ContinueProbeProvider, FlakyProvider, AlwaysErrorProvider, RpcDeadlineProbeProvider
diff --git a/.terraphim/kg/session.md b/.terraphim/kg/session.md
@@ -6,4 +6,4 @@ JSONL session persistence (version 3 format) with a tree structure for branching
 
 Related: model-registry, interactive-tui, rpc
 
-synonyms:: session, sessions, jsonl session, session persistence, session tree, session branch, session index, session replay, sqlite session, sqlite-sessions, compaction, session entry, session migrate
+synonyms:: session, sessions, jsonl session, session persistence, session tree, session branch, session index, session replay, sqlite session, sqlite-sessions, compaction, session entry, session migrate, SessionMeta, SessionIndexRefreshSummary, SessionIndex, SessionMetrics, SessionBeforeCompactOutcome, SessionBeforeCompactCompaction, SessionOptions, AgentSessionHandle, AgentSessionState, RpcSessionState, RpcSessionStats, InteractiveExtensionSession, SessionPicker, SessionPickerOverlay, SessionOpenDiagnostics, SessionOpenSkippedEntry, SessionOpenOrphanedParentLink, SessionColdStartTraceBundle, SessionColdStartStorageTrace, SessionColdStartInputTrace, SessionColdStartPhaseTrace, SessionColdStartIndexRefreshTrace, SessionColdStartOpenDiagnosticsTrace, SessionReplayMinimizationTrace, SessionColdStartCompactionTrace, SessionColdStartFirstRenderTrace, SessionColdStartBoundsTrace, SessionHeader, SessionInfoEntry, SqliteSessionMeta, SessionStoreV2, AgentSession, ToolOutputArtifactSessionGuard, SessionPromptResult, SessionTransportEvent, SessionTransportState, SessionTransport, SessionStoreKind, SessionEntry, SessionMessage
diff --git a/.terraphim/kg/sse.md b/.terraphim/kg/sse.md
@@ -6,4 +6,4 @@ Server-Sent Events parser for streaming LLM responses (`src/sse.rs`). Parses the
 
 Related: provider, model-registry
 
-synonyms:: sse, server-sent events, sse parser, streaming, stream parser, event stream, delta, streaming response, provider streaming, provider_streaming, model fetch
+synonyms:: sse, server-sent events, sse parser, streaming, stream parser, event stream, delta, streaming response, provider streaming, provider_streaming, model fetch, SseEvent, SseParser, StreamEvent
diff --git a/.terraphim/kg/tool.md b/.terraphim/kg/tool.md
@@ -6,4 +6,4 @@ Built-in agent tools (`src/tools.rs`) invoked by the agent loop (`src/agent.rs`)
 
 Related: extension, hashline-edit, agent loop
 
-synonyms:: tool, tools, built-in tool, read tool, write tool, edit tool, bash tool, grep tool, find tool, ls tool, hashline_edit, agent tool, tool registry, tool call, tool definition
+synonyms:: tool, tools, built-in tool, read tool, write tool, edit tool, bash tool, grep tool, find tool, ls tool, hashline_edit, agent tool, tool registry, tool call, tool definition, GeminiTool, ToolRegistry, ReadTool, BashTool, EditTool, WriteTool, GrepTool, FindTool, LsTool, HashlineEditTool
diff --git a/.terraphim/scripts/refresh-anchors.sh b/.terraphim/scripts/refresh-anchors.sh
@@ -0,0 +1,131 @@
+#!/usr/bin/env bash
+# .terraphim/scripts/refresh-anchors.sh
+#
+# Refresh the pi_agent_rust terraphim-grep KG with structurally-derived code
+# anchors, using ast-grep. Repeatable + idempotent: run it whenever the code
+# changes to keep the thesaurus aligned with real identifiers.
+#
+# What it does:
+#   1. ast-grep extracts pub struct / pub enum / pub trait names and
+#      `impl Provider for X` targets from src/.
+#   2. Identifiers are bucketed onto KG concepts by curated keyword rules.
+#   3. New anchors are APPENDED to each .terraphim/kg/*.md `synonyms::` line
+#      (idempotent — existing synonyms are never duplicated or removed).
+#   4. .terraphim/thesaurus.json is regenerated from the (enriched) KG.
+#
+# Requirements: ast-grep (sg) on PATH, python3.
+#
+# Usage:
+#   .terraphim/scripts/refresh-anchors.sh        # from repo root
+set -euo pipefail
+
+REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
+KG_DIR="$REPO_ROOT/.terraphim/kg"
+THESAURUS="$REPO_ROOT/.terraphim/thesaurus.json"
+TMP="$(mktemp -d)"; trap 'rm -rf "$TMP"' EXIT
+
+cd "$REPO_ROOT"
+command -v ast-grep >/dev/null || { echo "ast-grep not found on PATH" >&2; exit 1; }
+
+echo ">> extracting structural identifiers with ast-grep ..."
+ast-grep run -l Rust -p 'pub struct $NAME { $$$BODY }' src --json=compact > "$TMP/structs.json" 2>/dev/null || true
+ast-grep run -l Rust -p 'pub enum $NAME { $$$BODY }'   src --json=compact > "$TMP/enums.json"   2>/dev/null || true
+ast-grep run -l Rust -p 'pub trait $NAME { $$$BODY }'  src --json=compact > "$TMP/traits.json"  2>/dev/null || true
+ast-grep run -l Rust -p 'impl $T for $NAME { $$$BODY }' src --json=compact > "$TMP/impls.json"  2>/dev/null || true
+
+python3 - "$TMP" "$KG_DIR" "$THESAURUS" <<'PY'
+import json, os, sys, collections
+tmp, kg_dir, thesaurus_path = sys.argv[1], sys.argv[2], sys.argv[3]
+
+def names(path, var):
+    try: d = json.load(open(path))
+    except FileNotFoundError: return []
+    out = []
+    for m in d:
+        s = (m.get("metaVariables") or {}).get("single", {})
+        n = s.get(var)
+        t = n.get("text", "") if isinstance(n, dict) else ""
+        if t: out.append((t, m.get("file", "")))
+    return out
+
+items = []
+items += names(f"{tmp}/structs.json", "NAME")
+items += names(f"{tmp}/enums.json", "NAME")
+items += names(f"{tmp}/traits.json", "NAME")
+# impl Provider for X -> capture the concrete type
+try:
+    for m in json.load(open(f"{tmp}/impls.json")):
+        s = (m.get("metaVariables") or {}).get("single", {})
+        T = s.get("T"); T = T.get("text","") if isinstance(T, dict) else ""
+        N = s.get("NAME"); N = N.get("text","") if isinstance(N, dict) else ""
+        if T == "Provider" and N: items.append((N, "src/providers/"))
+except FileNotFoundError:
+    pass
+
+# Curated concept-bucketing rules (name, file) -> concept stem.
+# Selective by design: name-based patterns only. Avoid file-wide catch-alls
+# (e.g. f.startswith("src/providers/")) — they flood the thesaurus with
+# peripheral request/response types and metrics noise.
+rules = {
+    "provider":        lambda n,f: n.endswith("Provider"),
+    "session":         lambda n,f: "Session" in n,
+    "extension":       lambda n,f: "Hostcall" in n or n.startswith("Extension") or "Capability" in n,
+    "model-registry":  lambda n,f: "Model" in n,
+    "sse":             lambda n,f: "Sse" in n or n == "StreamEvent",
+    "acp":             lambda n,f: "Acp" in n,
+    "auth":            lambda n,f: "Auth" in n or "OAuth" in n,
+    "interactive-tui": lambda n,f: ("Picker" in n or "Selector" in n or n == "PiApp") and "src/interactive" in f,
+    "tool":            lambda n,f: n.endswith("Tool") or n == "ToolRegistry",
+    "hashline-edit":   lambda n,f: n == "HashlineEditTool",
+}
+
+buckets = collections.defaultdict(list)
+seen = collections.defaultdict(set)
+for n, f in items:
+    if not (3 <= len(n) <= 40):
+        continue
+    for concept, fn in rules.items():
+        if fn(n, f) and n not in seen[concept]:
+            buckets[concept].append(n); seen[concept].add(n)
+
+# Append new anchors to each concept's synonyms:: line (idempotent).
+enriched = 0
+for concept, anchors in buckets.items():
+    path = os.path.join(kg_dir, f"{concept}.md")
+    if not os.path.exists(path):
+        continue
+    lines = open(path, encoding="utf-8").read().splitlines()
+    out, done = [], False
+    for line in lines:
+        if line.strip().lower().startswith("synonyms::") and not done:
+            existing = line.split("::", 1)[1]
+            have = {t.strip().lower() for t in existing.split(",")}
+            new = [a for a in anchors if a.lower() not in have]
+            out.append(line.rstrip() + ("" if not new else ", " + ", ".join(new)))
+            enriched += len(new)
+            done = True
+        else:
+            out.append(line)
+    if done:
+        open(path, "w", encoding="utf-8").write("\n".join(out) + "\n")
+print(f">> appended {enriched} new structural anchors across {len(buckets)} concepts")
+
+# Regenerate thesaurus.json from the (now enriched) KG markdown.
+data, cid = {}, 100
+for f in sorted(os.listdir(kg_dir)):
+    if not f.endswith(".md"):
+        continue
+    nterm = os.path.splitext(f)[0]
+    txt = open(os.path.join(kg_dir, f), encoding="utf-8").read()
+    syn = next((l.split("::", 1)[1] for l in txt.splitlines()
+                if l.strip().lower().startswith("synonyms::")), "")
+    for t in dict.fromkeys([nterm] + [s.strip().lower() for s in syn.split(",") if s.strip()]):
+        data.setdefault(t.lower(), {"id": cid, "nterm": nterm})
+    cid += 1
+json.dump({"name": "Pi Agent Rust Engineer", "data": data},
+          open(thesaurus_path, "w"), indent=2, ensure_ascii=False)
+print(f">> regenerated {thesaurus_path}: {len(data)} thesaurus entries")
+PY
+
+echo ">> done. verify with:"
+echo "   terraphim-grep 'ReadTool' --paths src --thesaurus .terraphim/thesaurus.json -n 3 --json"
diff --git a/.terraphim/thesaurus.json b/.terraphim/thesaurus.json

Original file line number	Diff line number	Diff line change
@@ -6,4 +6,4 @@ Agent Client Protocol support. `pi --acp` runs pi as an ACP server (stdin JSON-R
`6`	`6`
`7`	`7`	`Related: interactive-tui, session, rpc`
`8`	`8`
`9`		`-synonyms:: acp, agent client protocol, --acp, acp server, acp session, set_model, set_config_option, session-dir, json-rpc server, rpc mode, stdin mode, rpc`
	`9`	`+synonyms:: acp, agent client protocol, --acp, acp server, acp session, set_model, set_config_option, session-dir, json-rpc server, rpc mode, stdin mode, rpc, AcpOptions`
Original file line number	Diff line number	Diff line change
@@ -6,4 +6,4 @@ Credential storage and OAuth flows (`src/auth.rs`). `auth.json` (perms 600) at `
`6`	`6`
`7`	`7`	`Related: provider, interactive-tui`
`8`	`8`
`9`		`-synonyms:: auth, authentication, oauth, auth.json, login, /login, credentials, oauth token, token expired, api key, openai-codex login, kimi oauth, copilot login, auth storage, re-login`
	`9`	`+synonyms:: auth, authentication, oauth, auth.json, login, /login, credentials, oauth token, token expired, api key, openai-codex login, kimi oauth, copilot login, auth storage, re-login, PendingOAuth, OAuthConfig, AuthDiagnostic, AuthFile, AuthStorage, OAuthStartInfo, OAuthCallbackServer, CopilotOAuthConfig, GitLabOAuthConfig, AuthCredential, AuthDiagnosticCode`
Original file line number	Diff line number	Diff line change
`@@ -6,4 +6,4 @@ JavaScript extension runtime on QuickJS with a capability policy layer. Extensio`
`6`	`6`
`7`	`7`	`Related: tool, provider, conformance`
`8`	`8`
`9`		`-synonyms:: extension, extensions, quickjs, quickjs runtime, javascript extension, capability policy, hostcall, hostcalls, extension runtime, wasm host, wasmtime, extension parity, extension taxonomy, extension oauth`
	`9`	+synonyms:: extension, extensions, quickjs, quickjs runtime, javascript extension, capability policy, hostcall, hostcalls, extension runtime, wasm host, wasmtime, extension parity, extension taxonomy, extension oauth, ExtensionTrustTracker, ExtensionCliFlag, HostcallRewritePlan, HostcallRewriteDecision, HostcallRewriteEngine, ExtensionIndex, ExtensionIndexEntry, ExtensionSearchHit, ExtensionSafetyProvenance, ExtensionIndexRefreshStats, ExtensionIndexStore, ExtensionResourcePaths, HostcallRequest, ExtensionToolDef, ExtensionRepairEvent, CapabilityProofReport, CapabilityPromptOverlay, ExtensionCustomOverlay, ExtensionToolWrapper, HostcallSuperinstructionPlan, HostcallSuperinstructionCompiler, HostcallSuperinstructionSelection, HostcallSuperinstructionExecution, HostcallQueueTelemetry, HostcallEpochPin, ExtensionPolicyConfig, ExtensionRiskConfig, ExtensionConformanceResult, ExtensionRegression, CompatCapabilityEvidence, ExtensionOverride, ExtensionPolicy, ExtensionQuotaConfig, ExtensionBudgetControllerConfig, BaselineCapabilityProfile, RuntimeHostcallSequenceContext, RuntimeHostcallFeatureVector, RuntimeHostcallTelemetryEvent, RuntimeHostcallTelemetryArtifact, AdaptiveHostcallPolicyDiffConfig, AdaptiveHostcallPolicySampleSupport, AdaptiveHostcallPolicyTelemetryMetrics, AdaptiveHostcallPolicyLatencyEffect, AdaptiveHostcallPolicyLaneChange, AdaptiveHostcallPolicyActionChange, AdaptiveHostcallPolicyThresholdChange, AdaptiveHostcallPolicyRollbackCondition, AdaptiveHostcallPolicyDiffReport, CapabilityExplanation, ExtensionMessage, CapabilityManifest, CapabilityRequirement, CapabilityScope, CapabilityProvenance, CapabilityIntegrityAttestation, CapabilityPublisherAttestation, HostcallReactorConfig, HostcallReactorRequest, HostcallReactorCompletion, HostcallReactorBackpressure, HostcallReactorTelemetry, HostcallReactorMesh, ExtensionUiRequest, ExtensionUiResponse, ExtensionSendMessage, ExtensionSendUserMessage, ExtensionAiCompletionRequest, ExtensionManifest, ExtensionManifestSource, ExtensionPermissionSnapshot, ExtensionPermissionDriftReport, ExtensionManager, ExtensionManagerHandle, ExtensionRegion, ExtensionIndexSource, HostcallOutcome, ExtensionTrustState, ExtensionEvent, ExtensionShape, HostcallRewritePlanKind, ExtensionCategory, HostcallQueueMode, HostcallQueueEnqueueResult, CapabilityAction, HostcallKind, CapabilityDelta, CapabilityMonotonicityVerdict, HostcallCategory, HostcallDelta, HostcallDispatchLane, HostcallIoHint, HostcallCapabilityClass, HostCapability, Capability, ExtensionPolicyMode, ExtensionBudgetTier, AdaptiveHostcallPolicyDiffVerdict, ExtensionBody, CommonHostcallOpcode, ExtensionDeliverAs, ExtensionEventName, ExtensionRuntime, ExtensionPermissionTrust, ExtensionPermissionDriftClass, ExtensionPermissionRiskLevel, ExtensionPermissionProvenanceStatus, ExtensionPermissionDriftVerdict, ExtensionLoadSpec, ExtensionRuntimeHandle, ExtensionRuntimeEngineSelection, ExtensionStreamSimpleProvider
Original file line number	Diff line number	Diff line change
@@ -6,4 +6,4 @@ Precise-edit tool using `LINE#HASH` anchors emitted by `read`/`grep` with `hashl
`6`	`6`
`7`	`7`	`Related: tool`
`8`	`8`
`9`		`-synonyms:: hashline_edit, hashline, line hash, hash line, precise edit, line hash edit, hash anchor, LINE#HASH, hashline edit tool`
	`9`	`+synonyms:: hashline_edit, hashline, line hash, hash line, precise edit, line hash edit, hash anchor, LINE#HASH, hashline edit tool, HashlineEditTool`
Original file line number	Diff line number	Diff line change
@@ -6,4 +6,4 @@ Interactive terminal front-end (`src/interactive.rs`, `src/tui.rs`) built on the
`6`	`6`
`7`	`7`	`Related: rpc, acp, model-registry`
`8`	`8`
`9`		`-synonyms:: interactive, tui, interactive tui, terminal ui, bubbletea, charmed_rust, lipgloss, glamour, slash command, /login, /model, /mcp, mouse capture, pi no mouse capture, frontend`
	`9`	`+synonyms:: interactive, tui, interactive tui, terminal ui, bubbletea, charmed_rust, lipgloss, glamour, slash command, /login, /model, /mcp, mouse capture, pi no mouse capture, frontend, TreeSelectorRow, TreeSelectorState, PiApp, SessionPickerOverlay, ThemePickerOverlay, BranchPickerOverlay, ThemePickerItem`
Original file line number	Diff line number	Diff line change
@@ -6,4 +6,4 @@ Model resolution layer (`src/models.rs`, `src/app.rs`). Resolves `ModelEntry` re
`6`	`6`
`7`	`7`	`Related: provider, interactive-tui, auth`
`8`	`8`
`9`		`-synonyms:: model registry, modelregistry, model entry, modelentry, models.json, model catalog, built-in models, provider default models, model resolution, autocomplete, reasoning effort, thinking control, default model, model id, model fetch, kimi-k2.7, glm-5.2`
	`9`	+synonyms:: model registry, modelregistry, model entry, modelentry, models.json, model catalog, built-in models, provider default models, model resolution, autocomplete, reasoning effort, thinking control, default model, model id, model fetch, kimi-k2.7, glm-5.2, RpcModelInfo, RpcCycleModelResult, ModelKey, ModelSelectorOverlay, RpcScopedModel, ScopedModel, ModelSelection, Model, ModelCost, ModelRoutingEvidence, ModelsConfig, ModelConfig, ModelAutocompleteCandidate, ModelChangeEntry, RuntimeRiskBaselineModel
Original file line number	Diff line number	Diff line change
@@ -6,4 +6,4 @@ Abstract LLM backend implementing the `Provider` trait (`src/provider.rs`). pi_a
`6`	`6`
`7`	`7`	`Related: model-registry, sse, auth, tool`
`8`	`8`
`9`		`-synonyms:: provider, llm backend, llm provider, anthropic, openai, openai-codex, codex, gemini, google, cohere, azure, bedrock, vertex, github copilot, copilot, gitlab duo, gitlab, kimi, kimi-for-coding, deepseek, minimax, zai, provider trait, streaming provider`
	`9`	+synonyms:: provider, llm backend, llm provider, anthropic, openai, openai-codex, codex, gemini, google, cohere, azure, bedrock, vertex, github copilot, copilot, gitlab duo, gitlab, kimi, kimi-for-coding, deepseek, minimax, zai, provider trait, streaming provider, VertexProvider, CopilotProvider, AzureOpenAIProvider, AnthropicProvider, OpenAIResponsesProvider, OpenAIProvider, AutocompleteProvider, GeminiProvider, GitLabProvider, CohereProvider, BedrockProvider, KnownProvider, ExtensionStreamSimpleProvider, ToolCallingProvider, DummyProvider, NoopProvider, IdleCommandProvider, ToolUseProvider, PiAiCaptureProvider, HangingProvider, CountingProvider, PhasedProvider, ToolCallProvider, SingleShotProvider, StreamSetupErrorProvider, ToolTurnProvider, SilentProvider, DeltaOnlyProvider, CapturingProvider, ContinueProbeProvider, FlakyProvider, AlwaysErrorProvider, RpcDeadlineProbeProvider
Original file line number	Diff line number	Diff line change
`@@ -6,4 +6,4 @@ JSONL session persistence (version 3 format) with a tree structure for branching`
`6`	`6`
`7`	`7`	`Related: model-registry, interactive-tui, rpc`
`8`	`8`
`9`		`-synonyms:: session, sessions, jsonl session, session persistence, session tree, session branch, session index, session replay, sqlite session, sqlite-sessions, compaction, session entry, session migrate`
	`9`	+synonyms:: session, sessions, jsonl session, session persistence, session tree, session branch, session index, session replay, sqlite session, sqlite-sessions, compaction, session entry, session migrate, SessionMeta, SessionIndexRefreshSummary, SessionIndex, SessionMetrics, SessionBeforeCompactOutcome, SessionBeforeCompactCompaction, SessionOptions, AgentSessionHandle, AgentSessionState, RpcSessionState, RpcSessionStats, InteractiveExtensionSession, SessionPicker, SessionPickerOverlay, SessionOpenDiagnostics, SessionOpenSkippedEntry, SessionOpenOrphanedParentLink, SessionColdStartTraceBundle, SessionColdStartStorageTrace, SessionColdStartInputTrace, SessionColdStartPhaseTrace, SessionColdStartIndexRefreshTrace, SessionColdStartOpenDiagnosticsTrace, SessionReplayMinimizationTrace, SessionColdStartCompactionTrace, SessionColdStartFirstRenderTrace, SessionColdStartBoundsTrace, SessionHeader, SessionInfoEntry, SqliteSessionMeta, SessionStoreV2, AgentSession, ToolOutputArtifactSessionGuard, SessionPromptResult, SessionTransportEvent, SessionTransportState, SessionTransport, SessionStoreKind, SessionEntry, SessionMessage
Original file line number	Diff line number	Diff line change
@@ -6,4 +6,4 @@ Server-Sent Events parser for streaming LLM responses (`src/sse.rs`). Parses the
`6`	`6`
`7`	`7`	`Related: provider, model-registry`
`8`	`8`
`9`		`-synonyms:: sse, server-sent events, sse parser, streaming, stream parser, event stream, delta, streaming response, provider streaming, provider_streaming, model fetch`
	`9`	`+synonyms:: sse, server-sent events, sse parser, streaming, stream parser, event stream, delta, streaming response, provider streaming, provider_streaming, model fetch, SseEvent, SseParser, StreamEvent`
Original file line number	Diff line number	Diff line change
@@ -6,4 +6,4 @@ Built-in agent tools (`src/tools.rs`) invoked by the agent loop (`src/agent.rs`)
`6`	`6`
`7`	`7`	`Related: extension, hashline-edit, agent loop`
`8`	`8`
`9`		`-synonyms:: tool, tools, built-in tool, read tool, write tool, edit tool, bash tool, grep tool, find tool, ls tool, hashline_edit, agent tool, tool registry, tool call, tool definition`
	`9`	`+synonyms:: tool, tools, built-in tool, read tool, write tool, edit tool, bash tool, grep tool, find tool, ls tool, hashline_edit, agent tool, tool registry, tool call, tool definition, GeminiTool, ToolRegistry, ReadTool, BashTool, EditTool, WriteTool, GrepTool, FindTool, LsTool, HashlineEditTool`