@henryqw/pi-herdr-rename 4.1.0 → 4.1.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 +18 -15
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,11 +1,6 @@
|
|
|
1
1
|
# `@henryqw/pi-herdr-rename`
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## Why
|
|
6
|
-
|
|
7
|
-
- **Created for**: Users who cannot identify conversations from generated workspace labels.
|
|
8
|
-
- **Advantage**: One concise title labels Pi and Herdr, maps to Git, and returns on resume without another model call.
|
|
3
|
+
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.
|
|
9
4
|
|
|
10
5
|
## Install
|
|
11
6
|
|
|
@@ -14,13 +9,15 @@ pi install npm:@henryqw/pi-task-models
|
|
|
14
9
|
pi install npm:@henryqw/pi-herdr-rename
|
|
15
10
|
```
|
|
16
11
|
|
|
17
|
-
Run `/task-models` and configure the `fast` profile. Herdr is required for pane, tab, workspace, and branch updates.
|
|
12
|
+
Run `/task-models` and configure the `fast` profile. Open `/task-models` again and verify that `fast` no longer says `not configured`. Herdr is required for pane, tab, workspace, and branch updates.
|
|
18
13
|
|
|
19
14
|
Outside Herdr, the extension still changes the Pi session name.
|
|
20
15
|
|
|
21
|
-
##
|
|
16
|
+
## Works with
|
|
22
17
|
|
|
23
|
-
|
|
18
|
+
| Package | Relationship | Purpose |
|
|
19
|
+
| --- | --- | --- |
|
|
20
|
+
| [`@henryqw/pi-task-models`](https://pi.henry.wang/extensions/pi-task-models) | Required | Provides shared title-generation model profiles. |
|
|
24
21
|
|
|
25
22
|
## Use
|
|
26
23
|
|
|
@@ -28,14 +25,14 @@ Send the first real prompt. A title appears in the background without delaying t
|
|
|
28
25
|
|
|
29
26
|
Run `/rename` after the task changes. It generates a new display title and semantic branch from up to five recent user messages.
|
|
30
27
|
|
|
28
|
+
## Flow
|
|
29
|
+
|
|
31
30
|
### Trigger
|
|
32
31
|
|
|
33
32
|
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.
|
|
34
33
|
|
|
35
34
|
### Title and branch rules
|
|
36
35
|
|
|
37
|
-
Display titles are natural task phrases. They are preferably three or four words and always at most four words and 20 characters.
|
|
38
|
-
|
|
39
36
|
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`.
|
|
40
37
|
|
|
41
38
|
- In a linked worktree, a detached checkout or Herdr `worktree/...` branch is renamed.
|
|
@@ -45,12 +42,18 @@ A semantic branch is a Git-safe branch name made from a task type and the displa
|
|
|
45
42
|
- The enclosing Herdr tab updates only when this pane is the tab's only pane.
|
|
46
43
|
- Outside Herdr, only the Pi session name changes.
|
|
47
44
|
|
|
48
|
-
### Model
|
|
45
|
+
### Model route and resume
|
|
49
46
|
|
|
50
47
|
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`.
|
|
51
48
|
|
|
52
|
-
The extension tries the assigned profile primary, then fallback, while honoring the configured thinking level. It never substitutes the current session model.
|
|
49
|
+
The extension tries the assigned profile primary, then fallback, while honoring the configured thinking level. It never substitutes the current session model.
|
|
50
|
+
|
|
51
|
+
Resuming a session created by this version reapplies the saved display title and semantic branch without another model request.
|
|
52
|
+
|
|
53
|
+
## Limits and recovery
|
|
54
|
+
|
|
55
|
+
Display titles are natural task phrases. They are preferably three or four words and always at most four words and 20 characters.
|
|
53
56
|
|
|
54
|
-
|
|
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.
|
|
55
58
|
|
|
56
|
-
Older titles receive no migration.
|
|
59
|
+
Herdr and Git synchronization failures appear as warnings. Cancellation by a newer rename remains silent. Older titles receive no migration.
|