@oh-my-pi/pi-coding-agent 5.2.0 → 5.3.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## [Unreleased]
 
+## [5.3.0] - 2026-01-15
+### Changed
+
+- Expanded bash tool guidance to explicitly list appropriate use cases including file operations, build commands, and process management
+
+## [5.2.1] - 2026-01-14
+### Fixed
+
+- Fixed stale diagnostic results by tracking diagnostic versions before file sync operations
+- Fixed race condition where LSP diagnostics could return outdated results after file modifications
+
 ## [5.2.0] - 2026-01-14
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "5.2.0",
+	"version": "5.3.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"ompConfig": {
@@ -39,10 +39,10 @@
 		"prepublishOnly": "bun run generate-template && bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-agent-core": "5.2.0",
-		"@oh-my-pi/pi-ai": "5.2.0",
-		"@oh-my-pi/pi-git-tool": "5.2.0",
-		"@oh-my-pi/pi-tui": "5.2.0",
+		"@oh-my-pi/pi-agent-core": "5.3.0",
+		"@oh-my-pi/pi-ai": "5.3.0",
+		"@oh-my-pi/pi-git-tool": "5.3.0",
+		"@oh-my-pi/pi-tui": "5.3.0",
 		"@openai/agents": "^0.3.7",
 		"@silvia-odwyer/photon-node": "^0.3.4",
 		"@sinclair/typebox": "^0.34.46",

package/src/core/tools/lsp/index.ts

@@ -331,12 +331,14 @@ async function waitForDiagnostics(
 	uri: string,
 	timeoutMs = 3000,
 	signal?: AbortSignal,
+	minVersion?: number,
 ): Promise<Diagnostic[]> {
 	const start = Date.now();
 	while (Date.now() - start < timeoutMs) {
 		signal?.throwIfAborted();
 		const diagnostics = client.diagnostics.get(uri);
-		if (diagnostics !== undefined) return diagnostics;
+		const versionOk = minVersion === undefined || client.diagnosticsVersion > minVersion;
+		if (diagnostics !== undefined && versionOk) return diagnostics;
 		await sleep(100);
 	}
 	return client.diagnostics.get(uri) ?? [];
@@ -462,12 +464,35 @@ export interface FileDiagnosticsResult {
 	formatter?: FileFormatResult;
 }
 
+/** Captured diagnostic versions per server (before sync) */
+type DiagnosticVersions = Map<string, number>;
+
+/**
+ * Capture current diagnostic versions for all LSP servers.
+ * Call this BEFORE syncing content to detect stale diagnostics later.
+ */
+async function captureDiagnosticVersions(
+	cwd: string,
+	servers: Array<[string, ServerConfig]>,
+): Promise<DiagnosticVersions> {
+	const versions = new Map<string, number>();
+	await Promise.allSettled(
+		servers.map(async ([serverName, serverConfig]) => {
+			if (serverConfig.createClient) return;
+			const client = await getOrCreateClient(serverConfig, cwd);
+			versions.set(serverName, client.diagnosticsVersion);
+		}),
+	);
+	return versions;
+}
+
 /**
  * Get diagnostics for a file using LSP or custom linter client.
  *
  * @param absolutePath - Absolute path to the file
  * @param cwd - Working directory for LSP config resolution
  * @param servers - Servers to query diagnostics for
+ * @param minVersions - Minimum diagnostic versions per server (to detect stale results)
  * @returns Diagnostic results or undefined if no servers
  */
 async function getDiagnosticsForFile(
@@ -475,6 +500,7 @@ async function getDiagnosticsForFile(
 	cwd: string,
 	servers: Array<[string, ServerConfig]>,
 	signal?: AbortSignal,
+	minVersions?: DiagnosticVersions,
 ): Promise<FileDiagnosticsResult | undefined> {
 	if (servers.length === 0) {
 		return undefined;
@@ -499,8 +525,9 @@ async function getDiagnosticsForFile(
 			// Default: use LSP
 			const client = await getOrCreateClient(serverConfig, cwd);
 			signal?.throwIfAborted();
-			// Content already synced + didSave sent, just wait for diagnostics
-			const diagnostics = await waitForDiagnostics(client, uri, 3000, signal);
+			// Content already synced + didSave sent, wait for fresh diagnostics
+			const minVersion = minVersions?.get(serverName);
+			const diagnostics = await waitForDiagnostics(client, uri, 3000, signal, minVersion);
 			return { serverName, diagnostics };
 		}),
 	);
@@ -675,6 +702,9 @@ export function createLspWritethrough(cwd: string, options?: WritethroughOptions
 		const getWritePromise = once(() => writeContent(finalContent));
 		const useCustomFormatter = enableFormat && customLinterServers.length > 0;
 
+		// Capture diagnostic versions BEFORE syncing to detect stale diagnostics
+		const minVersions = enableDiagnostics ? await captureDiagnosticVersions(cwd, servers) : undefined;
+
 		let formatter: FileFormatResult | undefined;
 		let diagnostics: FileDiagnosticsResult | undefined;
 		try {
@@ -710,9 +740,9 @@ export function createLspWritethrough(cwd: string, options?: WritethroughOptions
 				// 5. Notify saved to LSP servers
 				await notifyFileSaved(dst, cwd, lspServers, operationSignal);
 
-				// 6. Get diagnostics from all servers
+				// 6. Get diagnostics from all servers (wait for fresh results)
 				if (enableDiagnostics) {
-					diagnostics = await getDiagnosticsForFile(dst, cwd, servers, operationSignal);
+					diagnostics = await getDiagnosticsForFile(dst, cwd, servers, operationSignal, minVersions);
 				}
 			});
 		} catch {
@@ -829,8 +859,9 @@ export function createLspTool(session: ToolSession): AgentTool<typeof lspSchema,
 								continue;
 							}
 							const client = await getOrCreateClient(serverConfig, session.cwd);
+							const minVersion = client.diagnosticsVersion;
 							await refreshFile(client, resolved);
-							const diagnostics = await waitForDiagnostics(client, uri);
+							const diagnostics = await waitForDiagnostics(client, uri, 3000, undefined, minVersion);
 							allDiagnostics.push(...diagnostics);
 						} catch {
 							// Server failed, continue with others
@@ -1091,8 +1122,9 @@ export function createLspTool(session: ToolSession): AgentTool<typeof lspSchema,
 							};
 						}
 
+						const actionsMinVersion = client.diagnosticsVersion;
 						await refreshFile(client, targetFile);
-						const diagnostics = await waitForDiagnostics(client, uri);
+						const diagnostics = await waitForDiagnostics(client, uri, 3000, undefined, actionsMinVersion);
 						const endLine = (end_line ?? line ?? 1) - 1;
 						const endCharacter = (end_character ?? column ?? 1) - 1;
 						const range = { start: position, end: { line: endLine, character: endCharacter } };

package/src/prompts/system/system-prompt.md

@@ -67,8 +67,18 @@ This matters. Get it right.
 
 Every tool is a choice. The wrong choice is friction. The right choice is invisible.
 
-### What bash is not for
-Bash is the fallback, not the first reach.
+### What bash IS for
+File and system operations:
+- `mv`, `cp`, `rm`, `ln -s` — moving, copying, deleting, symlinking
+- `mkdir -p`, `chmod` — directory creation, permissions
+- `sd` — bulk find/replace across multiple files (faster than repeated edits)
+- `tar`, `zip`, `unzip` — archives
+- `curl` — downloading files
+- Build commands: `cargo`, `npm`, `make`, `docker`
+- Process management: running servers, background tasks
+
+### What bash is NOT for
+Specialized tools exist. Use them.
 
 {{#has tools "read"}}- Reading files: `read` sees. `cat` just runs.{{/has}}
 {{#has tools "grep"}}- Searching content: `grep` finds. Shell pipelines guess.{{/has}}