@danypops/pi-lector 0.1.8 → 0.1.10

package/extension/src/cross-workspace-search-rendering.ts

@@ -1,5 +1,6 @@
 import type { SymbolSearchResult, TextSearchResult, WorkspaceQueryOutcome } from "@danypops/lector";
 import { keyHint } from "@earendil-works/pi-coding-agent";
+import { describeFindSymbolSources } from "./find-symbols-rendering.ts";
 import type { LectorTheme } from "./lector-tui-theme.ts";
 
 const DEFAULT_VISIBLE_PER_WORKSPACE = 10;
@@ -29,6 +30,7 @@ export function formatFindSymbolsAcrossProjectsResult(
 		lines.push(
 			theme.fg("muted", `  ${outcome.result.provenance.fidelity} via ${outcome.result.provenance.backend}${outcome.result.truncated ? " (truncated)" : ""}`),
 		);
+		for (const source of describeFindSymbolSources(outcome.result)) lines.push(theme.fg("muted", `  ${source}`));
 		if (outcome.result.symbols.length === 0) {
 			lines.push(theme.fg("dim", "  no symbols matched"));
 			continue;

package/extension/src/find-symbols-rendering.ts

@@ -24,6 +24,16 @@ export function formatFindSymbolsCall(args: { query?: unknown; directory?: unkno
 	return content;
 }
 
+export function describeFindSymbolSources(result: SymbolSearchResult): readonly string[] {
+	return (result.sources ?? []).map((source) => {
+		const identity = `${source.provenance.languageId}: ${source.status} via ${source.provenance.backend}`;
+		if (source.status === "failed") {
+			return source.error ? `${identity} [${source.error.code}] ${source.error.message}` : identity;
+		}
+		return `${identity} (${source.symbolCount} symbol${source.symbolCount === 1 ? "" : "s"}${source.truncated ? ", truncated" : ""})`;
+	});
+}
+
 /** One result line, kind-padded to the widest kind actually present so the name column lines up. */
 function formatSymbolLine(symbol: WorkspaceSymbol, theme: FindSymbolsTheme, kindColumnWidth: number): string {
 	const kind = theme.fg(colorForKind(symbol.kind), symbol.kind.padEnd(kindColumnWidth));
@@ -36,13 +46,18 @@ export function formatFindSymbolsResult(result: SymbolSearchResult | undefined,
 	if (!result) return theme.fg("dim", `No symbols found matching "${query}".`);
 	const { symbols, provenance, truncated } = result;
 	const source = `${provenance.fidelity} via ${provenance.backend}${truncated ? " (truncated)" : ""}`;
+	const sourceLines = describeFindSymbolSources(result).map((line) => theme.fg("muted", line));
 	if (symbols.length === 0) {
-		return `${theme.fg("muted", source)}\n${theme.fg("dim", `No symbols found matching "${query}".`)}`;
+		return [theme.fg("muted", source), ...sourceLines, theme.fg("dim", `No symbols found matching "${query}".`)].join("\n");
 	}
 
 	const kindColumnWidth = Math.max(...symbols.map((symbol) => symbol.kind.length));
 	const displayCount = expanded ? symbols.length : Math.min(symbols.length, DEFAULT_VISIBLE_RESULTS);
-	const lines = [theme.fg("muted", source), theme.fg("muted", `${symbols.length} symbol${symbols.length === 1 ? "" : "s"} matching "${query}":`)];
+	const lines = [
+		theme.fg("muted", source),
+		...sourceLines,
+		theme.fg("muted", `${symbols.length} symbol${symbols.length === 1 ? "" : "s"} matching "${query}":`),
+	];
 
 	for (const symbol of symbols.slice(0, displayCount)) {
 		lines.push(formatSymbolLine(symbol, theme, kindColumnWidth));

package/extension/src/index.ts

@@ -53,7 +53,7 @@ import { createLectorCrossWorkspaceSearchOperations } from "./cross-workspace-se
 import { formatCrossWorkspaceCall, formatFindSymbolsAcrossProjectsResult, formatSearchTextAcrossProjectsResult } from "./cross-workspace-search-rendering.ts";
 import { createLectorEditOperations } from "./edit-operations.ts";
 import { createLectorFindSymbolsOperations } from "./find-symbols-operations.ts";
-import { formatFindSymbolsCall, formatFindSymbolsResult } from "./find-symbols-rendering.ts";
+import { describeFindSymbolSources, formatFindSymbolsCall, formatFindSymbolsResult } from "./find-symbols-rendering.ts";
 import { createLectorGitOperations } from "./git-operations.ts";
 import { formatGitDiffCall, formatGitDiffResult, formatGitLogCall, formatGitLogResult, formatGitStatusCall, formatGitStatusResult } from "./git-rendering.ts";
 import { nearestGitRoot } from "./nearest-workspace-root.ts";
@@ -64,7 +64,13 @@ import { createLectorRepoFetchOperations } from "./repo-fetch-operations.ts";
 import { formatRepoFetchCall, formatRepoFetchResult } from "./repo-fetch-rendering.ts";
 import { createLectorSearchOperations } from "./search-operations.ts";
 import { formatSearchCall, formatSearchResult } from "./search-rendering.ts";
-import { type CachePresentationState, createWorkspaceCacheOperations, monitorWorkspaceCache } from "./workspace-cache-operations.ts";
+import {
+	type CachePresentationState,
+	cacheContextMessage,
+	createWorkspaceCacheOperations,
+	describeCacheState,
+	monitorWorkspaceCache,
+} from "./workspace-cache-operations.ts";
 import { createLectorWriteOperations } from "./write-operations.ts";
 
 function describeIntelligenceSource(provenance: IntelligenceProvenance): string {
@@ -99,13 +105,6 @@ export default function (pi: ExtensionAPI) {
 	let cacheState: CachePresentationState | undefined;
 	let lastInjectedCacheState: string | undefined;
 
-	function describeCacheState(state: CachePresentationState): string {
-		if (state.status === "not-cached") return `not cached (${state.reason})`;
-		if (state.status === "caching") return `caching (job ${state.jobId})`;
-		if (state.status === "finished-caching") return `finished caching (job ${state.job.id})`;
-		return "cached";
-	}
-
 	pi.on("before_agent_start", () => {
 		if (!cacheState) return;
 		const description = describeCacheState(cacheState);
@@ -114,7 +113,7 @@ export default function (pi: ExtensionAPI) {
 		return {
 			message: {
 				customType: "lector-cache-status",
-				content: `Lector workspace cache: ${description}. A caching graph is still loading; use live code-intelligence operations until it becomes cached.`,
+				content: cacheContextMessage(cacheState),
 				display: false,
 			},
 		};
@@ -187,10 +186,12 @@ export default function (pi: ExtensionAPI) {
 				const result = await findSymbolsOperations.findSymbols(params.query, directory);
 				const { symbols, provenance, truncated } = result;
 				const source = `${provenance.fidelity} via ${provenance.backend}${truncated ? " (truncated)" : ""}`;
+				const sourceDetails = describeFindSymbolSources(result);
+				const heading = [source, ...sourceDetails].join("\n");
 				const text =
 					symbols.length === 0
-						? `${source}\nNo symbols found matching "${params.query}".`
-						: `${source}\n${symbols
+						? `${heading}\nNo symbols found matching "${params.query}".`
+						: `${heading}\n${symbols
 								.map((symbol) => `${symbol.kind} ${symbol.name} -- ${symbol.location.path}:${symbol.location.line}:${symbol.location.character}`)
 								.join("\n")}`;
 				return { content: [{ type: "text", text }], details: result };

package/extension/src/workspace-cache-operations.ts

@@ -46,6 +46,20 @@ export type CachePresentationState =
 	| { readonly status: "finished-caching"; readonly job: JobSnapshot<PopulateSymbolGraphResult> & { readonly status: "succeeded" } }
 	| { readonly status: "cached" };
 
+export function describeCacheState(state: CachePresentationState): string {
+	if (state.status === "not-cached") return `not cached (${state.reason})`;
+	if (state.status === "caching") return `caching (job ${state.jobId})`;
+	if (state.status === "finished-caching") return `finished caching (job ${state.job.id})`;
+	return "cached";
+}
+
+export function cacheContextMessage(state: CachePresentationState): string {
+	const prefix = `Lector workspace cache: ${describeCacheState(state)}.`;
+	if (state.status === "not-cached") return `${prefix} Live code-intelligence operations remain available.`;
+	if (state.status === "caching") return `${prefix} The cached graph is still building; use live code-intelligence operations until it is ready.`;
+	return `${prefix} The cached graph is ready.`;
+}
+
 export interface MonitorWorkspaceCacheOptions {
 	readonly directory: string;
 	readonly maxFiles: number;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@danypops/pi-lector",
-	"version": "0.1.8",
+	"version": "0.1.10",
 	"description": "Pi host adapter for Lector: overrides read/write/edit with a daemon-backed, hash-guarded filesystem",
 	"license": "MIT",
 	"type": "module",
@@ -18,7 +18,7 @@
 		"typebox": "*"
 	},
 	"dependencies": {
-		"@danypops/lector": "^0.1.8"
+		"@danypops/lector": "^0.1.9"
 	},
 	"devDependencies": {
 		"@earendil-works/pi-ai": "^0.81.1",