@agnishc/edb-system-prompt-watch 0.14.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## [Unreleased]
+
+- Initial release: alert when Pi's bundled default system prompt source changes.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agnish Chakraborty
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @agnishc/edb-system-prompt-watch
+
+A Pi CLI extension that alerts when Pi's bundled default system prompt source changes.
+
+This is for setups where you use your own `SYSTEM.md`, but still want to know when Pi's upstream default prompt changed so you can manually review and merge any useful updates.
+
+## Behavior
+
+On Pi startup, the extension:
+
+1. Reads the installed `@earendil-works/pi-coding-agent` package version
+2. Hashes the installed `dist/core/system-prompt.js`
+3. Compares it with the last startup hash stored in `~/.pi/agent/state/system-prompt-watch.json`
+4. Shows a warning if the bundled default system prompt source changed
+5. Stores the current hash as the new baseline
+
+First run is silent and only stores the baseline.
+
+The extension does not fetch anything from the network and does not modify your custom prompt.
+
+## Install
+
+```bash
+pi install npm:@agnishc/edb-system-prompt-watch
+```
+
+## License
+
+[MIT](LICENSE) © Agnish Chakraborty

package/package.json

@@ -0,0 +1,43 @@
+{
+	"name": "@agnishc/edb-system-prompt-watch",
+	"version": "0.14.0",
+	"description": "Pi extension: alert when Pi's bundled default system prompt changes",
+	"keywords": [
+		"pi-package",
+		"pi-extension",
+		"edb",
+		"system-prompt"
+	],
+	"type": "module",
+	"license": "MIT",
+	"author": "Agnish Chakraborty",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agnishcc/pi-extention-monorepo.git",
+		"directory": "packages/edb-system-prompt-watch"
+	},
+	"homepage": "https://github.com/agnishcc/pi-extention-monorepo/tree/main/packages/edb-system-prompt-watch#readme",
+	"bugs": {
+		"url": "https://github.com/agnishcc/pi-extention-monorepo/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"test": "vitest run"
+	},
+	"files": [
+		"src",
+		"README.md",
+		"LICENSE",
+		"CHANGELOG.md"
+	],
+	"pi": {
+		"extensions": [
+			"./src/index.ts"
+		]
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-coding-agent": "*"
+	}
+}

package/src/index.ts

@@ -0,0 +1,25 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { checkPromptSource } from "./state";
+
+export default function systemPromptWatchExtension(pi: ExtensionAPI): void {
+	pi.on("session_start", async (event, ctx) => {
+		if (event.reason !== "startup") return;
+
+		try {
+			const result = await checkPromptSource();
+			if (!result.changed) return;
+
+			const previousVersion = result.previous?.lastSeenPiVersion ?? "unknown";
+			const currentVersion = result.snapshot.piVersion;
+			const versionText =
+				previousVersion === currentVersion ? currentVersion : `${previousVersion} → ${currentVersion}`;
+
+			ctx.ui.notify(
+				`Pi default system prompt changed (${versionText}). Review your custom SYSTEM.md against the bundled default prompt.`,
+				"warning",
+			);
+		} catch (error: unknown) {
+			console.error("[edb-system-prompt-watch] Failed to check Pi default system prompt:", error);
+		}
+	});
+}

package/src/state.ts

@@ -0,0 +1,82 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { getAgentDir, VERSION } from "@earendil-works/pi-coding-agent";
+
+export interface PromptWatchState {
+	lastSeenPromptSourceHash?: string;
+	lastSeenPiVersion?: string;
+	lastSeenPromptSourcePath?: string;
+	lastCheckedAt?: string;
+}
+
+export interface PromptSourceSnapshot {
+	piVersion: string;
+	promptSourcePath: string;
+	promptSourceHash: string;
+}
+
+export interface PromptWatchResult {
+	changed: boolean;
+	firstRun: boolean;
+	previous?: PromptWatchState;
+	snapshot: PromptSourceSnapshot;
+}
+
+export function hashText(text: string): string {
+	return createHash("sha256").update(text).digest("hex");
+}
+
+export function getStatePath(): string {
+	return join(getAgentDir(), "state", "system-prompt-watch.json");
+}
+
+export function readState(statePath = getStatePath()): PromptWatchState | undefined {
+	if (!existsSync(statePath)) return undefined;
+
+	try {
+		return JSON.parse(readFileSync(statePath, "utf8")) as PromptWatchState;
+	} catch {
+		return undefined;
+	}
+}
+
+export function writeState(state: PromptWatchState, statePath = getStatePath()): void {
+	mkdirSync(dirname(statePath), { recursive: true });
+	writeFileSync(statePath, `${JSON.stringify(state, null, "\t")}\n`);
+}
+
+export async function getPromptSourceSnapshot(): Promise<PromptSourceSnapshot> {
+	const packageEntryUrl = await import.meta.resolve("@earendil-works/pi-coding-agent");
+	const packageEntry = fileURLToPath(packageEntryUrl);
+	const packageRoot = dirname(dirname(packageEntry));
+	const promptSourcePath = join(packageRoot, "dist", "core", "system-prompt.js");
+	const promptSource = readFileSync(promptSourcePath, "utf8");
+
+	return {
+		piVersion: VERSION,
+		promptSourcePath,
+		promptSourceHash: hashText(promptSource),
+	};
+}
+
+export async function checkPromptSource(previous = readState()): Promise<PromptWatchResult> {
+	const snapshot = await getPromptSourceSnapshot();
+	const firstRun = !previous?.lastSeenPromptSourceHash;
+	const changed = !firstRun && previous.lastSeenPromptSourceHash !== snapshot.promptSourceHash;
+
+	writeState({
+		lastSeenPromptSourceHash: snapshot.promptSourceHash,
+		lastSeenPiVersion: snapshot.piVersion,
+		lastSeenPromptSourcePath: snapshot.promptSourcePath,
+		lastCheckedAt: new Date().toISOString(),
+	});
+
+	return {
+		changed,
+		firstRun,
+		previous,
+		snapshot,
+	};
+}