@howaboua/pi-notes-compaction 0.0.1 → 0.0.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @howaboua/pi-notes-compaction
 
+## 0.0.3
+
+- Fixed shared agent startup after package updates when the startup changelog is present.
+
+## 0.0.2
+
+- Added a `/notes` settings panel for normal compaction, idle rollover, continuity status and confirmed pruning, replacing the subcommands and JSON status output.
+
 ## 0.0.1
 
 - Added Notes Compaction: local checkpoint notes, searchable session history and notes-guided context windows for any Pi model, with optional Codex Conversion integration and cached remote lookup.

package/README.md

@@ -12,7 +12,7 @@ pi install npm:@howaboua/pi-notes-compaction
 
 Reload Pi, then ask the agent to save a checkpoint and start a new context window. It can read those notes and search earlier session history to continue.
 
-With Pi Codex Conversion 3.0.48 or newer, local notes work alongside Codex tools, Code Mode, Notebook and normal compaction. Older PCC versions without this integration leave the extension inactive. Run `/notes status` to check activation and available capabilities. Extension authors can read the [integration contract](PCC-INTEGRATION.md).
+With Pi Codex Conversion 3.0.48 or newer, local notes work alongside Codex tools, Code Mode, Notebook and normal compaction. Older PCC versions without this integration leave the extension inactive. Run `/notes` to check activation and available capabilities. Extension authors can read the [integration contract](PCC-INTEGRATION.md).
 
 ## Notes and windows
 
@@ -22,15 +22,15 @@ By default, `new_context` starts a fresh window without generating a summary. Th
 
 Reminders arrive at 85% and 90% context use. `/compact` requests a notes checkpoint and opens a new window only after a completed run with fresh saved notes. Abort, errors and failed writes retain the old context. Overflow recovery still uses Pi's normal compaction.
 
-Idle rollover is off by default. Enable it with `/notes idle 5`, `15`, `25` or `55` (minutes). After that interval, the next input waits for rollover only if the latest completed turn saved fresh notes. Otherwise it proceeds in the current window without requesting a checkpoint. These intervals are user preferences, not provider cache-expiry guarantees. Held input retains its original text, attachments and SDK options. A failed rollover keeps input pending. Submit another prompt to retry, or reload to cancel it.
+Idle rollover is off by default. Choose 5, 15, 25 or 55 minutes in `/notes`. After that interval, the next input waits for rollover only if the latest completed turn saved fresh notes. Otherwise it proceeds in the current window without requesting a checkpoint. These intervals are user preferences, not provider cache-expiry guarantees. Held input retains its original text, attachments and SDK options. A failed rollover keeps input pending. Submit another prompt to retry, or reload to cancel it.
 
 ## Management
 
-- `/notes status` shows activation, storage counts and optional remote capabilities.
-- `/notes compact on` runs the installed normal Pi or PCC compaction flow, including on `new_context`.
-- `/notes compact off` restores notes-only rollover. This is the default.
-- `/notes idle off` disables idle rollover. The interval is saved alongside the compaction setting.
-- `/notes prune` removes SQLite records for sessions whose recorded files are missing. Unknown paths, permission errors and the active session are retained.
+`/notes` opens the settings panel in interactive Pi. It shows continuity status, storage counts and remote capabilities. Changes save immediately.
+
+- **Normal compaction** includes the installed Pi or PCC compaction flow on `new_context`. Off keeps notes-only rollover, the default.
+- **Idle rollover** selects the interval or disables it.
+- **Prune missing sessions** removes records for missing session files after confirmation. Unknown paths, permission errors and the active session are retained.
 
 Notes are stored as plaintext in `<Pi agent directory>/notes-compaction/notes.sqlite`, honoring `PI_CODING_AGENT_DIR`. Saved session snapshots preserve notes across forks and branch navigation, including after database pruning. Existing plaintext PCC notes remain readable without an import.
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@howaboua/pi-notes-compaction",
-	"version": "0.0.1",
+	"version": "0.0.3",
 	"publishConfig": {
 		"access": "public"
 	},

package/src/index.ts

@@ -12,7 +12,8 @@ import {
 } from "./bridge.js";
 import { NotesLifecycle } from "./lifecycle.js";
 import { exportNotesSnapshot, sessionRef } from "./notes.js";
-import { IDLE_MINUTES, readSettings, writeSettings } from "./settings.js";
+import { type NotesSettings, readSettings, writeSettings } from "./settings.js";
+import { openNotesSettings } from "./settings-screen.js";
 import { NotesStore } from "./store.js";
 import {
 	createSharedExecutor,
@@ -26,9 +27,6 @@ import {
 	windowDetails,
 } from "./windows.js";
 
-const HELP =
-	"Use /notes status, /notes prune, /notes compact on|off, or /notes idle off|5|15|25|55 (minutes). Compaction and idle rollover default off. Compaction adds the normal installed Pi/PCC compaction flow to new_context. Idle intervals are not provider cache-expiry guarantees.";
-
 export default function notesCompaction(pi: ExtensionAPI): void {
 	registerWindowRenderer(pi);
 	const dir = join(getAgentDir(), "notes-compaction");
@@ -49,6 +47,12 @@ export default function notesCompaction(pi: ExtensionAPI): void {
 			lifecycle.active &&
 			ctx.isIdle() &&
 			ctx.sessionManager.getEntries().every((entry) => {
+				// The first startup after an update records a UI-only changelog.
+				if (
+					entry.type === "custom" &&
+					entry.customType === "@howaboua/pi-stuff/changelog"
+				)
+					return true;
 				// Herdr activation persists its empty registry before first task delivery.
 				if (
 					entry.type === "custom" &&
@@ -209,66 +213,49 @@ export default function notesCompaction(pi: ExtensionAPI): void {
 	pi.registerCommand("notes", {
 		description: "Manage local notes and context rollover",
 		handler: async (args, ctx) => {
-			const command = args.trim() || "status";
-			if (command === "help") {
-				ctx.ui.notify(HELP, "info");
+			if (args.trim()) {
+				ctx.ui.notify("Use /notes to open settings.", "info");
 				return;
 			}
-			if (command === "status") {
-				ctx.ui.notify(
-					JSON.stringify({
-						active: lifecycle.active,
-						...(unavailable ? { unavailable } : {}),
-						normalCompaction: lifecycle.normalCompaction,
-						idleMinutes: lifecycle.idleMinutes,
-						...store.status(),
-						database: store.path,
-						hybridLookup: Boolean(lifecycle.bridge?.lookup),
-						encryptedDelivery: Boolean(lifecycle.bridge?.projectResult),
-					}),
-					"info",
-				);
+			if (!ctx.hasUI) {
+				ctx.ui.notify("Notes settings require interactive Pi.", "warning");
 				return;
 			}
-			if (command === "compact on" || command === "compact off") {
-				writeSettings(settingsPath, {
-					normalCompaction: command === "compact on",
-					idleMinutes: lifecycle.idleMinutes,
-				});
-				lifecycle.normalCompaction = command === "compact on";
-				ctx.ui.notify(
-					`Normal compaction ${lifecycle.normalCompaction ? "enabled" : "disabled"}.`,
-					"info",
-				);
-				return;
-			}
-			const idle = IDLE_MINUTES.find(
-				(minutes) => command === `idle ${minutes === 0 ? "off" : minutes}`,
-			);
-			if (idle !== undefined) {
-				writeSettings(settingsPath, {
-					normalCompaction: lifecycle.normalCompaction,
-					idleMinutes: idle,
-				});
-				lifecycle.idleMinutes = idle;
-				ctx.ui.notify(
-					idle === 0
-						? "Idle rollover disabled."
-						: `Idle rollover after ${idle} minutes, when fresh notes are available. This is not a cache-expiry guarantee.`,
-					"info",
-				);
-				return;
-			}
-			if (command === "prune") {
+			const save = (settings: NotesSettings) => {
+				writeSettings(settingsPath, settings);
+				Object.assign(lifecycle, settings);
+			};
+			const prune = async () => {
 				await ctx.waitForIdle();
 				store.updateFile(sessionRef(ctx));
+				const result = store.prune(ctx.sessionManager.getSessionId());
 				ctx.ui.notify(
-					JSON.stringify(store.prune(ctx.sessionManager.getSessionId())),
+					`Pruned ${result.removed} sessions. Retained ${result.unknownPaths} unknown paths and ${result.inaccessible} inaccessible files.`,
 					"info",
 				);
-				return;
+			};
+			try {
+				await openNotesSettings(ctx, {
+					settings: () => ({
+						normalCompaction: lifecycle.normalCompaction,
+						idleMinutes: lifecycle.idleMinutes,
+					}),
+					save,
+					prune,
+					status: () => {
+						const counts = store.status();
+						return [
+							lifecycle.active
+								? "Continuity active"
+								: `Continuity inactive: ${unavailable ?? "not initialized"}`,
+							`${counts.sessions} sessions · ${counts.revisions} note revisions · ${counts.cachedResponses} cached responses`,
+							`Hybrid lookup: ${lifecycle.bridge?.lookup ? "available" : "unavailable"} · Encrypted delivery: ${lifecycle.bridge?.projectResult ? "available" : "unavailable"}`,
+						];
+					},
+				});
+			} catch (error) {
+				ctx.ui.notify(`Notes settings failed: ${String(error)}`, "error");
 			}
-			ctx.ui.notify(HELP, "warning");
 		},
 	});
 }

package/src/settings-screen.ts

@@ -0,0 +1,115 @@
+import {
+	type ExtensionContext,
+	getSettingsListTheme,
+} from "@earendil-works/pi-coding-agent";
+import { SettingsList, truncateToWidth } from "@earendil-works/pi-tui";
+import { IDLE_MINUTES, type NotesSettings } from "./settings.js";
+
+export async function openNotesSettings(
+	ctx: ExtensionContext,
+	options: {
+		settings: () => NotesSettings;
+		save: (settings: NotesSettings) => void;
+		status: () => string[];
+		prune: () => Promise<void>;
+	},
+): Promise<void> {
+	while (true) {
+		const status = options.status();
+		const action = await ctx.ui.custom<"close" | "prune">(
+			(tui, theme, _kb, done) => {
+				const settings = options.settings();
+				const idleValue = (minutes: number) =>
+					minutes === 0 ? "off" : `${minutes} min`;
+				const list = new SettingsList(
+					[
+						{
+							id: "compact",
+							label: "Normal compaction",
+							description:
+								"Include the installed Pi/PCC compaction flow on new_context. Off keeps notes-only rollover.",
+							currentValue: settings.normalCompaction ? "on" : "off",
+							values: ["off", "on"],
+						},
+						{
+							id: "idle",
+							label: "Idle rollover",
+							description:
+								"Roll over before the next input only with fresh notes from a completed turn. Not a cache-expiry guarantee.",
+							currentValue: idleValue(settings.idleMinutes),
+							values: IDLE_MINUTES.map(idleValue),
+						},
+						{
+							id: "prune",
+							label: "Prune missing sessions",
+							description:
+								"Remove stored records only for missing session files. Keeps active sessions, unknown paths and inaccessible files. Confirmation required.",
+							currentValue: "select…",
+							values: ["select…", "prune…"],
+						},
+					],
+					5,
+					getSettingsListTheme(),
+					(id, value) => {
+						if (id === "prune") {
+							done("prune");
+							return;
+						}
+						const current = options.settings();
+						try {
+							if (id === "compact")
+								options.save({ ...current, normalCompaction: value === "on" });
+							else {
+								const idleMinutes = IDLE_MINUTES.find(
+									(minutes) => idleValue(minutes) === value,
+								);
+								if (idleMinutes !== undefined)
+									options.save({ ...current, idleMinutes });
+							}
+						} catch (error) {
+							list.updateValue(
+								id,
+								id === "compact"
+									? current.normalCompaction
+										? "on"
+										: "off"
+									: idleValue(current.idleMinutes),
+							);
+							ctx.ui.notify(
+								`Could not save notes settings: ${String(error)}`,
+								"error",
+							);
+						}
+						tui.requestRender();
+					},
+					() => done("close"),
+					{ enableSearch: false },
+				);
+				return {
+					render: (width) =>
+						[
+							theme.fg("accent", "Notes & context"),
+							...status.map((line) => theme.fg("dim", line)),
+							"",
+							...list.render(width),
+							"",
+							theme.fg(
+								"dim",
+								"↑↓ navigate · Enter/Space change · Esc close · saved immediately",
+							),
+						].map((line) => truncateToWidth(line, width)),
+					invalidate: () => list.invalidate(),
+					handleInput: (data) => list.handleInput(data),
+				};
+			},
+		);
+		if (action === "close") return;
+		if (
+			await ctx.ui.confirm(
+				"Prune missing sessions?",
+				"Delete local notes and cached responses for missing session files? The active session, unknown paths and inaccessible files are retained.",
+			)
+		)
+			await options.prune();
+	}
+}

package/src/settings.ts

@@ -25,7 +25,7 @@ export function readSettings(path: string): NotesSettings {
 		typeof settings.normalCompaction !== "boolean"
 	)
 		throw new Error(
-			"Invalid notes settings. Use /notes compact on or /notes compact off to replace them.",
+			"Invalid notes settings. Save a setting in /notes, then reload Pi.",
 		);
 	const idleMinutes = "idleMinutes" in settings ? settings.idleMinutes : 0;
 	if (!IDLE_MINUTES.some((value) => value === idleMinutes))