@henryqw/pi-herdr-rename 5.0.1 → 5.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -20
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# `@henryqw/pi-herdr-rename`
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Give each conversation one short Pi title that can also label its Herdr location and Git branch. Titles are generated in the background and restored on resume without another model call.
|
|
4
4
|
|
|
5
5
|
## Install
|
|
6
6
|
|
|
@@ -9,9 +9,7 @@ pi install npm:@henryqw/pi-task-models
|
|
|
9
9
|
pi install npm:@henryqw/pi-herdr-rename
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
Run `/task-models` and configure the `fast` profile. Open `/task-models` again and verify that `fast` no longer says `not configured`.
|
|
13
|
-
|
|
14
|
-
Outside Herdr, the extension still changes the Pi session name.
|
|
12
|
+
Run `/task-models` and configure the `fast` profile. Open `/task-models` again and verify that `fast` no longer says `not configured`.
|
|
15
13
|
|
|
16
14
|
## Works with
|
|
17
15
|
|
|
@@ -21,39 +19,43 @@ Outside Herdr, the extension still changes the Pi session name.
|
|
|
21
19
|
|
|
22
20
|
## Use
|
|
23
21
|
|
|
24
|
-
|
|
22
|
+
In a new, untitled conversation, send the first real prompt. Pi generates a title in the background without delaying the reply.
|
|
25
23
|
|
|
26
|
-
|
|
24
|
+
| Surface | Type | Purpose |
|
|
25
|
+
| --- | --- | --- |
|
|
26
|
+
| First real user prompt | ui | In a new, untitled conversation, starts title generation once the expanded prompt is ready. |
|
|
27
|
+
| `pi-herdr-rename/rename` | model task | Title-generation route; users configure its profile through `/task-models`. |
|
|
28
|
+
| `/rename` | command | For people: generate a new title from up to five recent user messages. |
|
|
27
29
|
|
|
28
30
|
## Flow
|
|
29
31
|
|
|
30
32
|
### Trigger
|
|
31
33
|
|
|
32
|
-
|
|
34
|
+
In a new, untitled session, the first real user prompt generates a title in the background after Pi expands skill and prompt-template shorthand. It does not delay the main reply. Extension-injected prompts, empty prompts, and image-only input are ignored.
|
|
33
35
|
|
|
34
36
|
### Title and branch rules
|
|
35
37
|
|
|
36
38
|
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`.
|
|
37
39
|
|
|
38
|
-
- In a linked worktree, a detached checkout or Herdr `worktree/...` branch is renamed.
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
42
|
-
|
|
43
|
-
|
|
40
|
+
- In a linked worktree, a detached checkout or Herdr `worktree/...` branch is renamed. An existing non-generated branch stays.
|
|
41
|
+
- A linked worktree's generated workspace label, such as `worktree-brave-meadow-4aa8`, becomes the display title automatically. A manual `/rename` can also replace a custom workspace name.
|
|
42
|
+
- The pane is renamed in Herdr. The enclosing tab updates only when this pane is the tab's only pane.
|
|
43
|
+
- Outside Herdr, only the Pi session name changes. Herdr is required for pane, tab, workspace, and linked-worktree branch updates.
|
|
44
|
+
|
|
45
|
+
### Model route
|
|
44
46
|
|
|
45
|
-
|
|
47
|
+
The task `pi-herdr-rename/rename` defaults to the `fast` profile. The shared [`pi-task-models` config](https://pi.henry.wang/extensions/pi-task-models#config) at `~/.pi/agent/config/pi-task-models/config.json` can explicitly override that assignment.
|
|
46
48
|
|
|
47
|
-
The
|
|
49
|
+
The extension tries the assigned profile's primary route, then its fallback, while honoring the configured thinking level. It never substitutes the current session model.
|
|
48
50
|
|
|
49
|
-
|
|
51
|
+
## State and storage
|
|
50
52
|
|
|
51
|
-
|
|
53
|
+
The Pi session stores each generated display title and semantic branch in a `pi-herdr-rename/title` session entry. When resuming a session created by this version, the extension reapplies the saved title and branch without another model request.
|
|
52
54
|
|
|
53
55
|
## Limits and recovery
|
|
54
56
|
|
|
55
|
-
Display titles are natural task phrases
|
|
57
|
+
Display titles are natural task phrases, preferably three or four words, and always at most four words and 20 characters.
|
|
56
58
|
|
|
57
|
-
A missing shared task-model config warns once at session start. Run `/task-models` to configure rename routing. No viable route leaves titles unchanged.
|
|
59
|
+
A missing shared task-model config warns once at session start. Run `/task-models` to configure rename routing. No viable route leaves titles unchanged. `/rename` warns if the session has no user text to rename.
|
|
58
60
|
|
|
59
|
-
Herdr and Git synchronization failures appear as warnings. Cancellation by a newer rename remains silent. Older titles receive no migration.
|
|
61
|
+
Herdr and Git synchronization failures appear as warnings. Fix the reported issue, then run `/rename` to try again. Cancellation by a newer rename remains silent. Older titles receive no migration.
|