@saifymatteo/pi-extensions 0.1.3 → 0.1.5

package/packages/pi-codegraph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-codegraph",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "license": "AGPL-3.0-only",
   "type": "module",
   "keywords": [
@@ -11,6 +11,7 @@
     "src",
     "examples",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-codegraph/src/index.ts

@@ -12,7 +12,7 @@
 // Provides:
 //   - codegraph_explore tool : symbol source + call paths from the .codegraph/ index
 //   - /codegraph-init /codegraph-sync /codegraph-status /codegraph-unlock
-//   - session_start : CLI check (report once if missing), config setup, auto-init
+//   - session_start : non-blocking CLI check (report once if missing), config setup, auto-init
 //                     when no index is found walking up from cwd (bounded by home
 //                     dir / filesystem root), and startup sync when indexed
 //   - agent_settled : single-flight sync after each completed turn (at most one
@@ -199,16 +199,26 @@ async function execCg(
 }
 
 export default function codegraph(pi: ExtensionAPI) {
-	// ── shared CLI availability check ─────────────────────────────────────
+	let initialization: Promise<void> | null = null;
+	let cliCheck: Promise<boolean> | null = null;
+
+	// Share a cancellable probe across startup and concurrent first calls.
 	async function ensureCli(pi2: ExtensionAPI): Promise<boolean> {
 		if (cliAvailable !== null) return cliAvailable;
-		try {
-			const r = await execCg(pi2, ["version"], { timeout: CLI_CHECK_TIMEOUT_MS });
-			cliAvailable = r.code === 0;
-		} catch {
-			cliAvailable = false;
-		}
-		return cliAvailable;
+		const gen = sessionGen;
+		const signal = runtimeAbort.signal;
+		cliCheck ??= (async () => {
+			try {
+				const r = await execCg(pi2, ["version"], { timeout: CLI_CHECK_TIMEOUT_MS, signal });
+				if (gen !== sessionGen || signal.aborted) return false;
+				cliAvailable = r.code === 0 && !r.killed;
+			} catch {
+				if (gen !== sessionGen || signal.aborted) return false;
+				cliAvailable = false;
+			}
+			return cliAvailable === true;
+		})();
+		return cliCheck;
 	}
 
 	// ── UI helpers: drop writes from a replaced session, never crash pi ───
@@ -335,7 +345,14 @@ export default function codegraph(pi: ExtensionAPI) {
 			),
 		}),
 		execute: async (_toolCallId, params, signal, _onUpdate, ctx) => {
-			if (!(await ensureCli(pi))) return textResult(INSTALL_HINT);
+			const lifecycle = runtimeAbort.signal;
+			await initialization;
+			lifecycle.throwIfAborted();
+			signal?.throwIfAborted();
+			const available = await ensureCli(pi);
+			lifecycle.throwIfAborted();
+			signal?.throwIfAborted();
+			if (!available) return textResult(INSTALL_HINT);
 			const cwd = params.path ?? ctx.cwd;
 			const args = ["explore", params.query, "-p", cwd];
 			if (typeof params.maxFiles === "number" && params.maxFiles > 0) {
@@ -366,6 +383,8 @@ export default function codegraph(pi: ExtensionAPI) {
 				const token = indexes ? ++opSeq : 0;
 				if (token) currentOpToken = token;
 				try {
+					await initialization;
+					if (gen !== sessionGen || runtimeAbort.signal.aborted) return;
 					await command.handler(args, ctx);
 				} catch (err) {
 					reportError(ctx, gen, `CodeGraph command /${name} failed`, err instanceof Error ? (err.stack ?? err.message) : String(err));
@@ -505,30 +524,24 @@ export default function codegraph(pi: ExtensionAPI) {
 		},
 	});
 
-	pi.on("session_shutdown", () => {
+	pi.on("session_shutdown", async () => {
 		cancelRetry();
 		runtimeAbort.abort();
 		sessionGen++;
 		currentOpToken = 0;
 		pendingSync = false;
 		latestCtx = null;
+		const pending = initialization;
+		initialization = null;
+		cliCheck = null;
+		await pending?.catch(() => {});
 	});
 
 	// ── session_start: CLI check → config → auto-init / startup sync ──────
-	pi.on("session_start", async (_event, ctx) => {
-		runtimeAbort.abort();
-		runtimeAbort = new AbortController();
-		const gen = ++sessionGen;
-		cancelRetry();
-		retriesExhausted = false;
-		state = null;
-		latestCtx = ctx;
-		currentOpToken = 0; // invalidate any op from a replaced session
-		pendingSync = false;
-		status(ctx, gen, undefined);
-
+	async function initialize(ctx: ExtensionContext, gen: number, signal: AbortSignal) {
+		if (gen !== sessionGen || signal.aborted) return;
 		if (!(await ensureCli(pi))) {
-			if (gen !== sessionGen) return;
+			if (gen !== sessionGen || signal.aborted) return;
 			if (ctx.hasUI && !notifiedMissing) {
 				notifiedMissing = true;
 				reportError(ctx, gen, INSTALL_HINT);
@@ -537,24 +550,51 @@ export default function codegraph(pi: ExtensionAPI) {
 		}
 
 		// Config setup happens in every mode; background spawning is TUI/RPC only.
+		if (gen !== sessionGen || signal.aborted) return;
 		await ensureGlobalConfig();
+		if (gen !== sessionGen || signal.aborted) return;
 		const indexedRoot = findIndexRoot(ctx.cwd);
 		const projectRoot = indexedRoot ?? ctx.cwd;
-		const globalCfg = await readConfigFile(globalConfigPath());
-		const projectCfg = await readConfigFile(path.join(projectRoot, ".pi", "codegraph.json"));
+		const [globalCfg, projectCfg] = await Promise.all([
+			readConfigFile(globalConfigPath()),
+			readConfigFile(path.join(projectRoot, ".pi", "codegraph.json")),
+		]);
 		const config: CgConfig = {
 			autoInit: boolOr(projectCfg, globalCfg, "autoInit"),
 			syncOnSettle: boolOr(projectCfg, globalCfg, "syncOnSettle"),
 		};
-		if (gen !== sessionGen) return;
+		if (gen !== sessionGen || signal.aborted) return;
 		state = { config, projectRoot, indexed: indexedRoot !== null };
 
+		// A manual init/sync requested during setup already owns the writer slot.
+		if (currentOpToken !== 0) return;
 		if (indexedRoot !== null) {
 			// Startup sync on the index owner (not cwd — cwd may be a subdir).
 			if (ctx.hasUI) spawnOp("sync", ctx, gen, projectRoot);
 		} else if (config.autoInit && ctx.hasUI && !isHomeOrRoot(ctx.cwd)) {
 			spawnOp("init", ctx, gen, ctx.cwd);
 		}
+	}
+
+	pi.on("session_start", (_event, ctx) => {
+		runtimeAbort.abort();
+		runtimeAbort = new AbortController();
+		const signal = runtimeAbort.signal;
+		const gen = ++sessionGen;
+		cancelRetry();
+		retriesExhausted = false;
+		state = null;
+		latestCtx = ctx;
+		currentOpToken = 0;
+		pendingSync = false;
+		cliCheck = null;
+		status(ctx, gen, undefined);
+
+		// Startup never waits; early tool/command calls share this setup promise.
+		initialization = Promise.resolve().then(() => initialize(ctx, gen, signal));
+		void initialization.catch((error) => {
+			if (!signal.aborted) reportError(ctx, gen, "CodeGraph startup failed", error instanceof Error ? error.message : String(error));
+		});
 	});
 
 	// ── agent_settled: single-flight sync after each completed turn ────────

package/packages/pi-compact-tools/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-compact-tools/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-compact-tools",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Groups consecutive tool calls into compact expandable transcript cards.",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -11,6 +11,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-decisions/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-decisions/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-decisions",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "license": "AGPL-3.0-only",
   "type": "module",
   "keywords": [
@@ -11,6 +11,7 @@
     "src",
     "examples",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-load-pi-dotenv/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-load-pi-dotenv/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-load-pi-dotenv",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Loads environment variables from the Pi agent directory without replacing existing environment values.",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -11,6 +11,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-model-go/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-model-go/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-model-go",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "license": "AGPL-3.0-only",
   "type": "module",
   "keywords": [
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-prestart-working/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-prestart-working/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-prestart-working",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Show a labelled Working spinner while before_agent_start hooks run.",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -11,6 +11,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-root-guard/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-root-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-root-guard",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Blocks selected write/edit and simple bash writes into Pi and Claude configuration roots.",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -11,6 +11,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-session-finder/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-session-finder/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-session-finder",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "license": "AGPL-3.0-only",
   "type": "module",
   "keywords": [
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-session-id/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-session-id/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-session-id",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "license": "AGPL-3.0-only",
   "type": "module",
   "keywords": [
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-session-nav/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-session-nav/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-session-nav",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "license": "AGPL-3.0-only",
   "type": "module",
   "keywords": [
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-session-rename/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.4]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-session-rename/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-session-rename",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "license": "AGPL-3.0-only",
   "type": "module",
   "keywords": [
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],

package/packages/pi-session-retention/AGENTS.md

@@ -0,0 +1,15 @@
+# Session retention
+
+## Startup contract
+
+Automatic maintenance is background work, not a prerequisite for startup. The session-start handler only schedules it; a busy agent defers the launch until `agent_settled`. After launch, work may overlap an agent run, so automatic discovery offers `/session-cleanup` in a notification rather than opening an approval dialog. The explicit command owns first approval; previously approved stores retain daily automatic cleanup.
+
+The original operational READMEs describe the older startup approval dialog. Use the contract above for current startup behavior; preserve the existing daily schedule, pause state and explicit commands.
+
+## Lifecycle safety
+
+Queued timers are cancelled on shutdown or explicit maintenance. Running work holds the existing per-store lock, protects the current session family and checks other Pi processes. Switches and forks remain blocked while maintenance runs. Shutdown aborts and drains the complete background task and any file operation before the context can be replaced. Retain graph revalidation and filesystem safety checks even when optimizing scans.
+
+## Verification
+
+Run `node --test packages/pi-session-retention/test/*.test.mjs` from the repository root. Startup tests use controlled timers and a gated real-store scan to assert non-blocking dispatch, idle deferral, lock ownership during shutdown and explicit approval. Fixtures stay in temporary directories; live retention approval can authorize moves and permanent purges, so interactive checks require an isolated agent home.

package/packages/pi-session-retention/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+Release notes are recorded from 0.1.3 onward.
+
+## [Unreleased]
+
+## [0.1.5]
+
+### Added
+
+- Include package release notes in Pi 1.5.0's Extension Updates.
+
+## [0.1.4]
+
+### Fixed
+
+- Schedule automatic maintenance outside the awaited session-start handler; defer launch while the agent is busy.
+- Offer `/session-cleanup` for first approval without interrupting startup, retaining store locking, protected sessions, and shutdown draining.
+
+## [0.1.3]
+
+### Fixed
+
+- Classify the package as an extension in the Pi package gallery.
+- Show the package screenshot as its gallery preview.

package/packages/pi-session-retention/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saifymatteo/pi-session-retention",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "license": "AGPL-3.0-only",
   "type": "module",
   "keywords": [
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "README.md",
+    "CHANGELOG.md",
     "NOTICE.md",
     "LICENSE"
   ],