pi-context-engine 0.5.0 → 0.5.1

package/README.md

@@ -103,6 +103,12 @@ unchanged repo took 237 ms.
 - **Switches**: `indexer.auto_index: false` disables the session-start and
   lazy kicks; `indexer.watch: false` disables the file watcher. Use
   `/context-index` for manual builds.
+- **Cold-start visibility**: the first build on an empty index announces its
+  start (`building the first index…`) and always closes with a result line
+  (`updated: N file(s)` or `no files to index`). This is the one background
+  run that can take minutes, so a pause reads as "indexing", not as a hung
+  session. Warm incremental runs stay quiet on start: they finish in a few
+  hundred ms, and a toast per session would be noise.
 - **Why it matters**: incremental runs are cheap (a few hundred ms on an
   unchanged repo), so this removes the classic cold-start failure of searching
   an empty index, without ever blocking the UI.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-context-engine",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Semantic code context for pi: tree-sitter index + hybrid vector/BM25 retrieval + cross-session memory, all local. Port of code-context-engine (MIT, elara-labs) as a native pi extension.",
   "keywords": [
     "pi-package",

package/src/extension.ts

@@ -137,6 +137,14 @@ export default function contextEngineExtension(pi: ExtensionAPI) {
 	const kickBackgroundIndex = (eng: ContextEngine, notify?: (msg: string, level: "info" | "warning") => void) => {
 		lazyIndexStarted = true;
 		indexInFlight = true;
+		// Cold-start visibility: the first build on an empty index is the only
+		// background run that can take minutes (every file gets chunked and
+		// embedded), and it used to stay invisible until the completion line.
+		// Announce the start so a long pause reads as "indexing", not as a hung
+		// session. Warm incremental runs are NOT announced: they finish in a few
+		// hundred ms and a toast on every session start would be noise.
+		const announcedStart = eng.chunkCount() === 0 && notify !== undefined;
+		if (announcedStart) notify?.(`Context index: building the first index for ${eng.projectName}…`, "info");
 		void eng
 			.autoIndexOnce()
 			.then((result) => {
@@ -145,6 +153,11 @@ export default function contextEngineExtension(pi: ExtensionAPI) {
 					notify(`Context index: background index hit ${result.errors.length} error(s)`, "warning");
 				} else if (result.indexed > 0) {
 					notify(`Context index updated: ${result.indexed} file(s), ${result.chunks} chunk(s)`, "info");
+				} else if (announcedStart) {
+					// The start toast promised feedback — close the loop even when
+					// there is nothing to index (empty project), instead of leaving
+					// "building…" hanging without a result.
+					notify(`Context index: no files to index for ${eng.projectName}`, "info");
 				}
 			})
 			.catch((err: unknown) => {