@henryqw/pi-herdr-rename 4.0.1 → 4.1.1

package/README.md

@@ -1,11 +1,6 @@
 # `@henryqw/pi-herdr-rename`
 
-Give each Pi conversation a short title, and use it for Herdr labels and generated Git branches.
-
-## Why
-
-- **Created for**: Users who cannot identify conversations from generated workspace labels.
-- **Advantage**: One concise title labels Pi and Herdr, maps to Git, and returns on resume without another model call.
+Replace hard-to-identify generated workspace labels with one short Pi conversation title. The title labels Pi and Herdr, maps to Git, and returns on resume without another model call.
 
 ## Install
 
@@ -18,15 +13,17 @@ Run `/task-models` and configure the `fast` profile. Herdr is required for pane,
 
 Outside Herdr, the extension still changes the Pi session name.
 
-## With
+## Works with
 
-[`@henryqw/pi-task-models`](https://pi.henry.wang/extensions/pi-task-models) is required for shared title-generation model profiles.
+**Required.** [`@henryqw/pi-task-models`](https://pi.henry.wang/extensions/pi-task-models) provides shared title-generation model profiles.
 
 ## Use
 
 Send the first real prompt. A title appears in the background without delaying the reply.
 
-Run `/rename` after the task changes. It generates a new display title and semantic branch from up to three recent rounds.
+Run `/rename` after the task changes. It generates a new display title and semantic branch from up to five recent user messages.
+
+## Flow
 
 ### Trigger
 
@@ -34,8 +31,6 @@ The first real user prompt generates a title in the background after Pi expands
 
 ### Title and branch rules
 
-Display titles are natural task phrases. They are preferably three or four words and always at most four words and 20 characters.
-
 A semantic branch is a Git-safe branch name made from a task type and the display-title words. Model classification stays internal. For example, `refactor: update task logic` displays as `Update task logic` and maps to `refactor/update-task-logic`.
 
 - In a linked worktree, a detached checkout or Herdr `worktree/...` branch is renamed.
@@ -45,12 +40,18 @@ A semantic branch is a Git-safe branch name made from a task type and the displa
 - The enclosing Herdr tab updates only when this pane is the tab's only pane.
 - Outside Herdr, only the Pi session name changes.
 
-### Model choice and resume
+### Model route and resume
 
 The shared [`pi-task-models` config](https://pi.henry.wang/extensions/pi-task-models#config) is at `~/.pi/agent/config/pi-task-models/config.json`. It can explicitly override the local `pi-herdr-rename/rename` declaration, which defaults to `fast`.
 
-The extension tries the assigned profile primary, then fallback, while honoring the configured thinking level. It never substitutes the current session model. A missing shared task-model config warns once at session start; run `/task-models` to configure rename routing. No viable route leaves titles unchanged.
+The extension tries the assigned profile primary, then fallback, while honoring the configured thinking level. It never substitutes the current session model.
+
+Resuming a session created by this version reapplies the saved display title and semantic branch without another model request.
+
+## Limits and recovery
+
+Display titles are natural task phrases. They are preferably three or four words and always at most four words and 20 characters.
 
-Resuming a session created by this version reapplies the saved display title and semantic branch without another model request. Herdr and Git synchronization failures appear as warnings. Cancellation by a newer rename remains silent.
+A missing shared task-model config warns once at session start. Run `/task-models` to configure rename routing. No viable route leaves titles unchanged.
 
-Older titles receive no migration.
+Herdr and Git synchronization failures appear as warnings. Cancellation by a newer rename remains silent. Older titles receive no migration.

package/extensions/rename.ts

@@ -16,7 +16,8 @@ import {
 const WIDGET_KEY = "pi-herdr-rename";
 const WIDGET_RESULT_MS = 2_000;
 const MAX_MESSAGE_CHARS = 1_000;
-const MAX_CONTEXT_CHARS = 2_000;
+const MAX_CONTEXT_CHARS = 5_000;
+const MAX_CONTEXT_MESSAGES = 5;
 const DISPLAY_MAX_WORDS = 4;
 const DISPLAY_MAX_CHARS = 20;
 const SEMANTIC_TYPE_MAX_CHARS = 12;
@@ -121,30 +122,23 @@ function latestSessionUserText(ctx: ExtensionContext): string | undefined {
 	}
 }
 
-function recentConversation(ctx: ExtensionContext, fallback?: string): string | undefined {
-	const rounds: Array<{ user: string; assistant?: string }> = [];
-	for (const entry of ctx.sessionManager.getBranch()) {
-		if (entry.type !== "message") continue;
-		if (entry.message.role !== "user" && entry.message.role !== "assistant") continue;
+function recentUserMessages(ctx: ExtensionContext, fallback?: string): string | undefined {
+	const messages = ctx.sessionManager.getBranch().flatMap((entry) => {
+		if (entry.type !== "message" || entry.message.role !== "user") return [];
 		const text = messageText(entry.message.content).trim();
-		if (!text) continue;
-		if (entry.message.role === "user") rounds.push({ user: text });
-		else if (entry.message.role === "assistant" && rounds.length) rounds[rounds.length - 1].assistant = text;
-	}
-	if (!rounds.length && fallback?.trim()) rounds.push({ user: fallback.trim() });
-	if (!rounds.length) return undefined;
+		return text ? [`user: ${text.slice(0, MAX_MESSAGE_CHARS)}`] : [];
+	});
+	if (!messages.length && fallback?.trim()) messages.push(`user: ${fallback.trim().slice(0, MAX_MESSAGE_CHARS)}`);
+	if (!messages.length) return undefined;
 
-	const messages = rounds.slice(-3).flatMap((round) => [
-		`user: ${round.user.slice(0, MAX_MESSAGE_CHARS)}`,
-		...(round.assistant ? [`assistant: ${round.assistant.slice(0, MAX_MESSAGE_CHARS)}`] : []),
-	]);
+	const recentMessages = messages.slice(-MAX_CONTEXT_MESSAGES);
 	const selected: string[] = [];
 	let remaining = MAX_CONTEXT_CHARS;
-	for (let index = messages.length - 1; index >= 0 && remaining > 0; index--) {
+	for (let index = recentMessages.length - 1; index >= 0 && remaining > 0; index--) {
 		const separator = selected.length ? 2 : 0;
 		const available = remaining - separator;
 		if (available <= 0) break;
-		const text = messages[index].slice(0, available);
+		const text = recentMessages[index].slice(0, available);
 		if (!text) break;
 		selected.push(text);
 		remaining -= text.length + separator;
@@ -400,9 +394,9 @@ export default function herdrRenameExtension(pi: ExtensionAPI): void {
 	});
 
 	pi.registerCommand("rename", {
-		description: "Generate a new display title from recent conversation context",
+		description: "Generate a new display title from recent user messages",
 		handler: async (_args, ctx) => {
-			const context = recentConversation(ctx, latestUserText);
+			const context = recentUserMessages(ctx, latestUserText);
 			if (!context) {
 				ctx.ui.notify("No user text is available to rename this chat.", "warning");
 				return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@henryqw/pi-herdr-rename",
-  "version": "4.0.1",
+  "version": "4.1.1",
   "description": "Generate short Pi display titles and rename the current Herdr location.",
   "keywords": [
     "pi-package",