@howaboua/pi-ask 0.0.16 → 0.0.18

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @howaboua/pi-ask
 
+## 0.0.18
+
+- Requires Pi 1.5 or newer.
+  - Waiting prompts now report Pi's native blocked state. Steering prompts remain non-blocking.
+  - Invalid question arguments now explain how to find the supported format.
+  - Removed custom changelog suppression. Updates use Pi's native notices and `collapseChangelog`.
+
+## 0.0.17
+
+- - Removed redundant help-call instructions from Ask's help.
+  - GPT mode uses note-style question and handoff guidance.
+
 ## 0.0.16
 
 - Use denser question and handoff help in PCC GPT prompt mode.
@@ -15,7 +27,6 @@
 ## 0.0.13
 
 - Ask now accepts supervisor replies through Shepherdr's `reply` action. Update and reload Ask and Shepherdr together on controllers and workers.
-
   - Supervisors receive questions, choices and a reply template. Valid replies complete the worker's existing wait or steer panel. Human handoffs still require the user's confirmation.
   - Unknown or misnamed fields, such as `options` instead of `choices`, and malformed choices now return errors naming the invalid field and accepted shape instead of silently dropping input.
 

package/README.md

@@ -39,8 +39,8 @@ Both templates are enabled by default. The extension creates `ask.json` under Pi
 
 ```json
 {
-  "grill": true,
-  "fold": true
+	"grill": true,
+	"fold": true
 }
 ```
 
@@ -49,7 +49,6 @@ Set either value to `false`, then run `/reload`, to hide that template. The same
 ## TUI controls
 
 The panel uses Pi's active keybindings. The defaults are:
-
 - `Up` / `Down` — move through choices, free text, and comments
 - `Enter` — choose or edit the focused item, or save an edit
 - `Left` / `Right` — move between prompts and the review tab

package/ask/normalize.ts

@@ -57,7 +57,7 @@ function unknownField(
 	const field = Object.keys(value).find((key) => !fields.includes(key));
 	return field === undefined
 		? undefined
-		: `Unknown ask field ${path}${field}; allowed: ${fields.join(", ")}`;
+		: `Ask doesn't recognise ${path}${field}. Use ${fields.join(", ")}; call ask({}) for the supported format.`;
 }
 
 /** Why a tool call would lose input to normalization, so a misnamed field fails instead of vanishing. */

package/ask/tool.ts

@@ -58,7 +58,9 @@ export function createAskRuntime({
 			const problem = askInputProblem(params);
 			if (problem) throw new Error(problem);
 			if (!Check(AskParameters, params))
-				throw new Error("Invalid ask arguments; ask({}) returns help");
+				throw new Error(
+					"Ask couldn't read these arguments. Call ask({}) for the supported format.",
+				);
 			return params;
 		},
 		async execute(toolCallId, params, signal, _onUpdate, ctx) {
@@ -68,14 +70,12 @@ export function createAskRuntime({
 						textContent(
 							(isGpt()
 								? [
-										"ask({}) / ask({help:true}): usage",
 										'ask({prompts:[{title,body?,multiple?,choices?:[{label,description?}]}],delivery?:"wait"|"steer",handoff?})',
-										"wait default; steer only with reversible work remaining. Handoff: await user action; state completion signal",
-										"Review: each finding=prompt+disposition choices; never report first",
-										"Other/rephrase automatic; no choices=free text; blank Other/rephrase=rephrase/follow up",
+										"wait default; steer ONLY if reversible work remains; handoff→wait user action+state completion signal",
+										"Review: finding→prompt+disposition choices; NEVER report first",
+										"Auto Other/rephrase; no choices=free text; blank Other/rephrase→rephrase/follow up",
 									]
 								: [
-										"ask({}) or ask({ help: true }) returns usage",
 										'ask({ prompts: [{ title, body?, multiple?, choices?: [{ label, description? }] }], delivery?: "wait"|"steer", handoff? })',
 										"Omit delivery to wait; steer only while reversible work can continue. Handoffs wait for user action; state the completion signal",
 										"For reviews, make each finding a prompt with disposition choices; do not report first",
@@ -90,7 +90,7 @@ export function createAskRuntime({
 			const { delivery, handoff, prompts } = normalizeAskInput(params);
 			if (prompts.length === 0) {
 				throw new Error(
-					"ask requires at least one prompt with a non-empty title.",
+					"Add at least one prompt with a non-empty title. Call ask({}) for the format.",
 				);
 			}
 			if (!askInComposer && !ctx.hasUI)

package/ask/tui.ts

@@ -34,202 +34,213 @@ export async function askInTui(
 	}: { handoff?: boolean; steering?: boolean; signal?: AbortSignal } = {},
 ): Promise<AskResponse[] | null> {
 	if (!ctx.hasUI || signal?.aborted) return null;
-	return await ctx.ui.custom<AskResponse[] | null>((tui, theme, kb, done) => {
-		let settled = false;
-		const finish = (result: AskResponse[] | null) => {
-			if (settled) return;
-			settled = true;
-			signal?.removeEventListener("abort", abort);
-			done(result);
-		};
-		const abort = () => finish(null);
-		signal?.addEventListener("abort", abort, { once: true });
-		if (signal?.aborted) queueMicrotask(abort);
-		const state: AskUiState = { tab: 0, focus: 0, editing: null };
-		let cached: string[] | undefined;
-		// Keep response lifecycle in one object per prompt. Parallel arrays made tab/default
-		// transitions easy to desynchronise as this tool grows.
-		const promptStates = prompts.map(createPromptState);
-		const editor = new Editor(tui, {
-			borderColor: (text) => theme.fg("accent", text),
-			selectList: {
-				selectedPrefix: (text) => theme.fg("accent", text),
-				selectedText: (text) => theme.fg("accent", text),
-				description: (text) => theme.fg("muted", text),
-				scrollInfo: (text) => theme.fg("dim", text),
-				noMatch: (text) => theme.fg("muted", text),
-			},
-		});
+	return await ctx.ui.custom<AskResponse[] | null>(
+		(tui, theme, kb, done) => {
+			let settled = false;
+			const finish = (result: AskResponse[] | null) => {
+				if (settled) return;
+				settled = true;
+				signal?.removeEventListener("abort", abort);
+				done(result);
+			};
+			const abort = () => finish(null);
+			signal?.addEventListener("abort", abort, { once: true });
+			if (signal?.aborted) queueMicrotask(abort);
+			const state: AskUiState = { tab: 0, focus: 0, editing: null };
+			let cached: { width: number; lines: string[] } | undefined;
+			// Keep response lifecycle in one object per prompt. Parallel arrays made tab/default
+			// transitions easy to desynchronise as this tool grows.
+			const promptStates = prompts.map(createPromptState);
+			const editor = new Editor(tui, {
+				borderColor: (text) => theme.fg("accent", text),
+				selectList: {
+					selectedPrefix: (text) => theme.fg("accent", text),
+					selectedText: (text) => theme.fg("accent", text),
+					description: (text) => theme.fg("muted", text),
+					scrollInfo: (text) => theme.fg("dim", text),
+					noMatch: (text) => theme.fg("muted", text),
+				},
+			});
 
-		const reviewTab = () => prompts.length;
-		const current = () => prompts[state.tab];
-		const currentPromptState = () => promptStates[state.tab];
-		const choices = () => current()?.choices ?? [];
-		const isReview = () => state.tab === reviewTab();
-		const count = () => choices().length + 2;
-		const refresh = () => {
-			cached = undefined;
-			tui.requestRender();
-		};
-		const responded = (index: number) =>
-			promptStateResponded(promptStates[index]);
-		const setTab = (next: number) => {
-			state.tab = Math.max(0, Math.min(reviewTab(), next));
-			state.focus = 0;
-			state.editing = null;
-			editor.setText(promptStates[state.tab]?.customText ?? "");
-			refresh();
-		};
-		const saveCustom = (submittedText = editor.getText()) => {
-			const prompt = current();
-			const promptState = currentPromptState();
-			if (!prompt || !promptState) return;
-			saveCustomSelection(prompt, promptState, submittedText);
-		};
-		const saveEditing = (submittedText = editor.getText()) => {
-			const promptState = currentPromptState();
-			if (!promptState) return;
-			if (state.editing === "comment") saveComment(promptState, submittedText);
-			else saveCustom(submittedText);
-		};
-		const startEditing = (kind: EditingKind) => {
-			const promptState = currentPromptState();
-			if (!promptState) return;
-			state.editing = kind;
-			editor.setText(
-				kind === "comment" ? promptState.comment : promptState.customText,
-			);
-			refresh();
-		};
-		const selectOther = () => {
-			const prompt = current();
-			const promptState = currentPromptState();
-			if (!prompt || !promptState) return;
-			if (prompt.multiple && promptState.customEnabled) {
-				clearCustomSelection(promptState);
+			const reviewTab = () => prompts.length;
+			const current = () => prompts[state.tab];
+			const currentPromptState = () => promptStates[state.tab];
+			const choices = () => current()?.choices ?? [];
+			const isReview = () => state.tab === reviewTab();
+			const count = () => choices().length + 2;
+			const refresh = () => {
+				cached = undefined;
+				tui.requestRender();
+			};
+			const responded = (index: number) =>
+				promptStateResponded(promptStates[index]);
+			const setTab = (next: number) => {
+				state.tab = Math.max(0, Math.min(reviewTab(), next));
+				state.focus = 0;
+				state.editing = null;
+				editor.setText(promptStates[state.tab]?.customText ?? "");
+				refresh();
+			};
+			const saveCustom = (submittedText = editor.getText()) => {
+				const prompt = current();
+				const promptState = currentPromptState();
+				if (!prompt || !promptState) return;
+				saveCustomSelection(prompt, promptState, submittedText);
+			};
+			const saveEditing = (submittedText = editor.getText()) => {
+				const promptState = currentPromptState();
+				if (!promptState) return;
+				if (state.editing === "comment")
+					saveComment(promptState, submittedText);
+				else saveCustom(submittedText);
+			};
+			const startEditing = (kind: EditingKind) => {
+				const promptState = currentPromptState();
+				if (!promptState) return;
+				state.editing = kind;
+				editor.setText(
+					kind === "comment" ? promptState.comment : promptState.customText,
+				);
 				refresh();
-				return;
-			}
-			startEditing("other");
-		};
-		const advance = () => setTab(state.tab + 1);
-		const advanceWithDefault = () => {
-			if (!isReview() && !responded(state.tab)) saveCustom("");
-			advance();
-		};
-		editor.onSubmit = (value) => {
-			saveEditing(value);
-			state.editing = null;
-			refresh();
-		};
-		const pick = (index: number) => {
-			const choice = choices()[index];
-			const prompt = current();
-			const promptState = currentPromptState();
-			if (!choice || !promptState) return;
-			pickChoiceSelection(prompt, promptState, choice);
-			refresh();
-		};
-		const handleInput = (data: string) => {
-			if (state.editing) {
-				handleAskEditingInput(data, {
-					advance,
-					editor,
+			};
+			const selectOther = () => {
+				const prompt = current();
+				const promptState = currentPromptState();
+				if (!prompt || !promptState) return;
+				if (prompt.multiple && promptState.customEnabled) {
+					clearCustomSelection(promptState);
+					refresh();
+					return;
+				}
+				startEditing("other");
+			};
+			const advance = () => setTab(state.tab + 1);
+			const advanceWithDefault = () => {
+				if (!isReview() && !responded(state.tab)) saveCustom("");
+				advance();
+			};
+			editor.onSubmit = (value) => {
+				saveEditing(value);
+				state.editing = null;
+				refresh();
+			};
+			const pick = (index: number) => {
+				const choice = choices()[index];
+				const prompt = current();
+				const promptState = currentPromptState();
+				if (!choice || !promptState) return;
+				pickChoiceSelection(prompt, promptState, choice);
+				refresh();
+			};
+			const handleInput = (data: string) => {
+				if (state.editing) {
+					handleAskEditingInput(data, {
+						advance,
+						editor,
+						keybindings: kb,
+						refresh,
+						saveEditing,
+						state,
+					});
+					return;
+				}
+				if (
+					handleAskNavigationInput(data, {
+						done: finish,
+						isReview,
+						keybindings: kb,
+						promptStates,
+						prompts,
+						setTab,
+						state,
+					})
+				) {
+					return;
+				}
+				handleAskPromptInput(data, {
+					advanceWithDefault,
+					count,
+					choices,
 					keybindings: kb,
+					pick,
 					refresh,
-					saveEditing,
+					selectOther,
+					startEditingComment: () => startEditing("comment"),
 					state,
 				});
-				return;
-			}
-			if (
-				handleAskNavigationInput(data, {
-					done: finish,
-					isReview,
-					keybindings: kb,
-					promptStates,
-					prompts,
-					setTab,
-					state,
-				})
-			) {
-				return;
-			}
-			handleAskPromptInput(data, {
-				advanceWithDefault,
-				count,
-				choices,
-				keybindings: kb,
-				pick,
-				refresh,
-				selectOther,
-				startEditingComment: () => startEditing("comment"),
-				state,
-			});
-		};
-		const render = (width: number) => {
-			if (cached) return cached;
-			const lines: string[] = [];
-			const add: AddLine = (line = "") =>
-				lines.push(truncateToWidth(line, width));
-			add(theme.fg("accent", "─".repeat(width)));
-			add(
-				renderAskTabs({
-					handoff,
-					prompts,
-					responded,
-					steering,
-					tab: state.tab,
-					theme,
-				}),
-			);
-			add();
-			if (isReview()) {
-				renderAskReview({
-					add,
-					handoff,
-					keybindings: kb,
-					promptStates,
-					prompts,
-					theme,
-					width,
-				});
-			} else {
-				const prompt = current();
-				if (prompt) {
-					renderAskPrompt({
+			};
+			const render = (width: number) => {
+				if (cached?.width === width) return cached.lines;
+				const lines: string[] = [];
+				const add: AddLine = (line = "") =>
+					lines.push(truncateToWidth(line, width));
+				add(theme.fg("accent", "─".repeat(width)));
+				add(
+					renderAskTabs({
+						handoff,
+						prompts,
+						responded,
+						steering,
+						tab: state.tab,
+						theme,
+					}),
+				);
+				add();
+				if (isReview()) {
+					renderAskReview({
 						add,
-						editor,
 						handoff,
-						isEditing: state.editing,
 						keybindings: kb,
-						choices: choices(),
-						prompt,
-						promptState: currentPromptState(),
-						state,
+						promptStates,
+						prompts,
 						theme,
 						width,
 					});
+				} else {
+					const prompt = current();
+					if (prompt) {
+						renderAskPrompt({
+							add,
+							editor,
+							handoff,
+							isEditing: state.editing,
+							keybindings: kb,
+							choices: choices(),
+							prompt,
+							promptState: currentPromptState(),
+							state,
+							theme,
+							width,
+						});
+					}
 				}
-			}
-			add(theme.fg("accent", "─".repeat(width)));
-			cached = lines;
-			return lines;
-		};
-		return {
-			get focused() {
-				return editor.focused;
-			},
-			set focused(value: boolean) {
-				editor.focused = value;
-				cached = undefined;
-			},
-			render,
-			handleInput,
-			dispose: () => signal?.removeEventListener("abort", abort),
-			invalidate: () => {
-				cached = undefined;
-			},
-		};
-	});
+				add(theme.fg("accent", "─".repeat(width)));
+				cached = { width, lines };
+				return lines;
+			};
+			return {
+				get focused() {
+					return editor.focused;
+				},
+				set focused(value: boolean) {
+					editor.focused = value;
+					cached = undefined;
+				},
+				render,
+				handleInput,
+				dispose: () => signal?.removeEventListener("abort", abort),
+				invalidate: () => {
+					cached = undefined;
+				},
+			};
+		},
+		steering
+			? undefined
+			: {
+					blocked: {
+						kind: "question",
+						message: handoff ? "Human action needed" : "Waiting for input",
+					},
+				},
+	);
 }

package/biome.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://biomejs.dev/schemas/2.5.15/schema.json",
+	"$schema": "https://biomejs.dev/schemas/2.6.3/schema.json",
 	"vcs": {
 		"enabled": true,
 		"clientKind": "git",

package/index.ts

@@ -16,7 +16,6 @@ import {
 import { isAskHelpInput, isSteeringAskInput } from "./ask/normalize.js";
 import { PENDING_ASK_ENTRY_TYPE, readPendingAsks } from "./ask/pending.js";
 import { createAskRuntime, createAskTool } from "./ask/tool.js";
-import registerPackageChangelog from "./changelog.js";
 
 export { createAskTool } from "./ask/tool.js";
 
@@ -28,7 +27,6 @@ const CODE_MODE_MODULE = `${CODE_MODE_PACKAGE}/code-mode`;
 const DEVELOPER_MESSAGES_MODULE = `${CODE_MODE_PACKAGE}/developer-messages`;
 
 export default async function humanInTheLoop(pi: ExtensionAPI): Promise<void> {
-	registerPackageChangelog(pi);
 	const trySendCodexDeveloperMessage = await loadCodexDeveloperMessageSender();
 	let gpt = false;
 	const askRuntime = createAskRuntime({

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@howaboua/pi-ask",
-	"version": "0.0.16",
+	"version": "0.0.18",
 	"description": "Interactive decisions, review triage, and human handoffs for Pi.",
 	"type": "module",
 	"license": "MIT",
@@ -36,7 +36,6 @@
 		"LICENSE",
 		"tsconfig.json",
 		"biome.json",
-		"changelog.ts",
 		"CHANGELOG.md"
 	],
 	"pi": {
@@ -45,9 +44,9 @@
 		]
 	},
 	"peerDependencies": {
-		"@howaboua/pi-codex-conversion": ">=4.0.3",
+		"@howaboua/pi-codex-conversion": ">=4.0.8",
 		"@earendil-works/pi-ai": ">=1.0.0",
-		"@earendil-works/pi-coding-agent": ">=1.0.0",
+		"@earendil-works/pi-coding-agent": ">=1.5.0",
 		"@earendil-works/pi-tui": ">=1.0.0",
 		"typebox": "*"
 	},
@@ -57,12 +56,12 @@
 		}
 	},
 	"devDependencies": {
-		"@howaboua/pi-codex-conversion": "4.0.3",
-		"@biomejs/biome": "^2.5.15",
-		"@earendil-works/pi-ai": "1.3.0",
-		"@earendil-works/pi-coding-agent": "1.3.0",
-		"@earendil-works/pi-tui": "1.3.0",
-		"typebox": "1.3.37",
+		"@howaboua/pi-codex-conversion": "4.0.8",
+		"@biomejs/biome": "^2.6.3",
+		"@earendil-works/pi-ai": "1.5.0",
+		"@earendil-works/pi-coding-agent": "1.5.0",
+		"@earendil-works/pi-tui": "1.5.0",
+		"typebox": "1.4.3",
 		"typescript": "^7.0.2"
 	},
 	"scripts": {

package/prompts/fold.md

@@ -1,7 +1,9 @@
 ---
+
 description: Fold a long report or list into interactive review
 argument-hint: "[report or instructions]"
 ---
+
 Fold this material into `ask` instead of replying with another long report:
 
 $ARGUMENTS

package/prompts/grill.md

@@ -1,7 +1,9 @@
 ---
+
 description: Grill an idea into an agreed plan
 argument-hint: "[idea or plan]"
 ---
+
 Grill this into an agreed plan:
 
 $ARGUMENTS

package/changelog.ts

@@ -1,337 +0,0 @@
-// Generated extension packages copy this file during changelog:extensions.
-
-import { randomUUID } from "node:crypto";
-import { readFileSync } from "node:fs";
-import { mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import {
-	DynamicBorder,
-	type ExtensionAPI,
-	getAgentDir,
-	getMarkdownTheme,
-} from "@earendil-works/pi-coding-agent";
-import { Container, Markdown, Spacer, Text } from "@earendil-works/pi-tui";
-
-const ENTRY_TYPE = "@howaboua/pi-stuff/changelog";
-const REGISTRATION_CHANNEL = "@howaboua/pi-stuff/changelog/register/v1";
-const STATE_FILENAME = "howaboua-pi-stuff-changelog.json";
-const SUPPRESS_KEY = "suppress";
-const LOCK_STALE_MS = 30_000;
-const LOCK_TIMEOUT_MS = 2_000;
-
-interface PackageMetadata {
-	name: string;
-	version: string;
-}
-
-interface PackageRegistration extends PackageMetadata {
-	changelogPath: string;
-}
-
-interface RegistrationEvent {
-	accept: () => void;
-	registration: PackageRegistration;
-}
-
-interface ChangelogEntry {
-	content: string;
-	version: string;
-}
-
-interface ChangelogEntryData {
-	markdown: string;
-}
-
-type ChangelogState = Record<string, boolean | string>;
-
-function packageRegistration(): PackageRegistration {
-	const packageDirectory = fileURLToPath(new URL(".", import.meta.url));
-	const metadata = JSON.parse(
-		readFileSync(join(packageDirectory, "package.json"), "utf8"),
-	) as Partial<PackageMetadata>;
-	if (typeof metadata.name !== "string" || typeof metadata.version !== "string")
-		throw new Error(`Invalid package metadata in ${packageDirectory}`);
-	return {
-		name: metadata.name,
-		version: metadata.version,
-		changelogPath: join(packageDirectory, "CHANGELOG.md"),
-	};
-}
-
-function isRegistrationEvent(value: unknown): value is RegistrationEvent {
-	if (!value || typeof value !== "object") return false;
-	const event = value as Partial<RegistrationEvent>;
-	return (
-		typeof event.accept === "function" &&
-		typeof event.registration?.name === "string" &&
-		typeof event.registration.version === "string" &&
-		typeof event.registration.changelogPath === "string"
-	);
-}
-
-function parseChangelog(markdown: string): ChangelogEntry[] {
-	const entries: ChangelogEntry[] = [];
-	let currentLines: string[] = [];
-	let currentVersion: string | undefined;
-
-	for (const line of markdown.split("\n")) {
-		const version = line.match(/^##\s+\[?(\d+\.\d+\.\d+)\]?(?:\s.*)?$/)?.[1];
-		if (version) {
-			if (currentVersion)
-				entries.push({
-					content: currentLines.join("\n").trim(),
-					version: currentVersion,
-				});
-			currentVersion = version;
-			currentLines = [line];
-		} else if (currentVersion) {
-			currentLines.push(line);
-		}
-	}
-
-	if (currentVersion)
-		entries.push({
-			content: currentLines.join("\n").trim(),
-			version: currentVersion,
-		});
-	return entries;
-}
-
-function compareVersions(left: string, right: string): number {
-	const leftParts = left.split(".").map(Number);
-	const rightParts = right.split(".").map(Number);
-	for (let index = 0; index < 3; index++) {
-		const difference = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
-		if (difference !== 0) return difference;
-	}
-	return 0;
-}
-
-function isStableVersion(version: string): boolean {
-	return /^\d+\.\d+\.\d+$/.test(version);
-}
-
-function statePath(): string {
-	return join(getAgentDir(), STATE_FILENAME);
-}
-
-async function readState(path: string): Promise<ChangelogState> {
-	let text: string;
-	try {
-		text = await readFile(path, "utf8");
-	} catch (error) {
-		if ((error as NodeJS.ErrnoException).code === "ENOENT") return {};
-		throw error;
-	}
-	const parsed = JSON.parse(text) as unknown;
-	if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
-		throw new Error(`${path} must contain a JSON object`);
-	for (const [name, value] of Object.entries(parsed)) {
-		if (name === SUPPRESS_KEY) {
-			if (typeof value !== "boolean")
-				throw new Error(`${path} ${SUPPRESS_KEY} must be a boolean`);
-		} else if (typeof value !== "string") {
-			throw new Error(`${path} version for ${name} must be a string`);
-		}
-	}
-	return parsed as ChangelogState;
-}
-
-async function acquireLock(path: string): Promise<() => Promise<void>> {
-	const deadline = Date.now() + LOCK_TIMEOUT_MS;
-	while (true) {
-		try {
-			await mkdir(path);
-			return () => rm(path, { force: true, recursive: true });
-		} catch (error) {
-			if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
-			const info = await stat(path).catch(() => undefined);
-			if (info && Date.now() - info.mtimeMs > LOCK_STALE_MS) {
-				await rm(path, { force: true, recursive: true });
-				continue;
-			}
-			if (Date.now() >= deadline)
-				throw new Error(`Timed out waiting for ${path}`);
-			await new Promise((resolve) => setTimeout(resolve, 20));
-		}
-	}
-}
-
-async function writeState(path: string, state: ChangelogState): Promise<void> {
-	await mkdir(dirname(path), { mode: 0o700, recursive: true });
-	const temporaryPath = `${path}.${process.pid}.${randomUUID()}.tmp`;
-	try {
-		const ordered = Object.fromEntries(
-			Object.entries(state).sort(([left], [right]) =>
-				left.localeCompare(right),
-			),
-		);
-		await writeFile(temporaryPath, `${JSON.stringify(ordered, null, 2)}\n`, {
-			encoding: "utf8",
-			mode: 0o600,
-		});
-		await rename(temporaryPath, path);
-	} catch (error) {
-		await rm(temporaryPath, { force: true });
-		throw error;
-	}
-}
-
-function packageMarkdown(
-	registration: PackageRegistration,
-	entries: ChangelogEntry[],
-): string {
-	const body = (entry: ChangelogEntry) =>
-		entry.content
-			.replace(/^##[^\n]*\n*/, "")
-			.replace(/^###\s+(?:Changes|Minor Changes|Patch Changes)\s*\n*/gim, "")
-			.replace(/^###\s+(.+)$/gm, "**$1**");
-	if (entries.length === 1) {
-		const [entry] = entries;
-		if (!entry) return "";
-		return `## ${registration.name} ${entry.version}\n\n${body(entry)}`;
-	}
-	return [
-		`## ${registration.name}`,
-		...entries.map((entry) => `**${entry.version}**\n\n${body(entry)}`),
-	].join("\n\n");
-}
-
-async function claimUpdates(
-	registrations: Iterable<PackageRegistration>,
-): Promise<{ errors: string[]; markdown?: string }> {
-	const stableRegistrations = [...registrations]
-		.filter((registration) => isStableVersion(registration.version))
-		.sort((left, right) => left.name.localeCompare(right.name));
-	if (stableRegistrations.length === 0) return { errors: [] };
-	const path = statePath();
-	await mkdir(dirname(path), { mode: 0o700, recursive: true });
-	const release = await acquireLock(`${path}.lock`);
-	try {
-		const state = await readState(path);
-		const errors: string[] = [];
-		const sections: string[] = [];
-		let changed = false;
-		if (state[SUPPRESS_KEY] === true) {
-			for (const registration of stableRegistrations) {
-				const seenVersion = state[registration.name];
-				if (
-					typeof seenVersion !== "string" ||
-					compareVersions(registration.version, seenVersion) > 0
-				) {
-					state[registration.name] = registration.version;
-					changed = true;
-				}
-			}
-			if (changed) await writeState(path, state);
-			return { errors };
-		}
-		for (const registration of stableRegistrations) {
-			const seenVersion = state[registration.name];
-			if (
-				typeof seenVersion === "string" &&
-				compareVersions(registration.version, seenVersion) <= 0
-			)
-				continue;
-			try {
-				const entries = parseChangelog(
-					await readFile(registration.changelogPath, "utf8"),
-				).filter(
-					(entry) =>
-						compareVersions(entry.version, registration.version) <= 0 &&
-						(typeof seenVersion === "string"
-							? compareVersions(entry.version, seenVersion) > 0
-							: entry.version === registration.version),
-				);
-				if (entries.length === 0) {
-					errors.push(
-						`No ${registration.version} changelog entry found for ${registration.name}`,
-					);
-					continue;
-				}
-				sections.push(packageMarkdown(registration, entries));
-				state[registration.name] = registration.version;
-				changed = true;
-			} catch (error) {
-				errors.push(
-					`Could not read the ${registration.name} changelog: ${error instanceof Error ? error.message : String(error)}`,
-				);
-			}
-		}
-		if (changed) await writeState(path, state);
-		return {
-			errors,
-			...(sections.length > 0 ? { markdown: sections.join("\n\n") } : {}),
-		};
-	} finally {
-		await release();
-	}
-}
-
-function registerCoordinator(
-	pi: ExtensionAPI,
-	registration: PackageRegistration,
-): void {
-	let accepted = false;
-	pi.events.emit(REGISTRATION_CHANNEL, {
-		registration,
-		accept: () => {
-			accepted = true;
-		},
-	} satisfies RegistrationEvent);
-	if (accepted) return;
-
-	const registrations = new Map([[registration.name, registration]]);
-	pi.events.on(REGISTRATION_CHANNEL, (value) => {
-		if (!isRegistrationEvent(value)) return;
-		registrations.set(value.registration.name, value.registration);
-		value.accept();
-	});
-	pi.registerEntryRenderer<ChangelogEntryData>(
-		ENTRY_TYPE,
-		(entry, _options, theme) => {
-			if (!entry.data) return undefined;
-			const container = new Container();
-			container.addChild(new DynamicBorder());
-			container.addChild(
-				new Text(theme.bold(theme.fg("accent", "What's New")), 1, 0),
-			);
-			container.addChild(new Spacer(1));
-			container.addChild(
-				new Markdown(entry.data.markdown.trim(), 1, 0, getMarkdownTheme()),
-			);
-			container.addChild(new Spacer(1));
-			container.addChild(new DynamicBorder());
-			return container;
-		},
-	);
-	pi.on("session_start", async (event, ctx) => {
-		if (event.reason === "reload" || ctx.mode !== "tui") return;
-		if (
-			ctx.sessionManager
-				.getEntries()
-				.some((entry) =>
-					["branch_summary", "compaction", "message"].includes(entry.type),
-				)
-		)
-			return;
-		try {
-			const update = await claimUpdates(registrations.values());
-			if (update.markdown)
-				pi.appendEntry<ChangelogEntryData>(ENTRY_TYPE, {
-					markdown: update.markdown,
-				});
-			for (const error of update.errors) ctx.ui.notify(error, "warning");
-		} catch (error) {
-			ctx.ui.notify(
-				`Could not update Howaboua changelog state: ${error instanceof Error ? error.message : String(error)}`,
-				"warning",
-			);
-		}
-	});
-}
-
-export default function howabouaPackageChangelog(pi: ExtensionAPI): void {
-	registerCoordinator(pi, packageRegistration());
-}