@narumitw/pi-starship 0.62.0 → 0.64.0
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 +23 -11
- package/dist/chunks/{chunk-PWTSHSP3.ts → chunk-A65IOGL6.ts} +6 -7
- package/dist/chunks/chunk-A65IOGL6.ts.map +7 -0
- package/dist/chunks/{chunk-HPZTMIZS.ts → chunk-DIHVBO5Z.ts} +41 -8
- package/dist/chunks/chunk-DIHVBO5Z.ts.map +7 -0
- package/dist/chunks/{chunk-43VIENBN.ts → chunk-UIKPE4UC.ts} +7 -7
- package/dist/chunks/{chunk-43VIENBN.ts.map → chunk-UIKPE4UC.ts.map} +2 -2
- package/dist/chunks/{command-configuration-menu-S2LXCOJG.ts → command-configuration-menu-ZN2VXU4L.ts} +3 -3
- package/dist/chunks/{command-settings-chat-O34BEU4X.ts → command-settings-chat-KLUVZXMO.ts} +632 -196
- package/dist/chunks/command-settings-chat-KLUVZXMO.ts.map +7 -0
- package/dist/chunks/{commands-ZYIJVIEJ.ts → commands-UAUSSHVS.ts} +25 -20
- package/dist/chunks/commands-UAUSSHVS.ts.map +7 -0
- package/dist/index.ts +116 -59
- package/dist/index.ts.map +3 -3
- package/package.json +1 -1
- package/skills/configure-pi-starship/SKILL.md +3 -1
- package/skills/configure-pi-starship/references/configuration.md +14 -12
- package/src/command-commit.ts +41 -7
- package/src/command-configuration.ts +8 -10
- package/src/command-settings-chat.ts +18 -48
- package/src/commands.ts +23 -26
- package/src/config.ts +6 -6
- package/src/pi-starship.ts +155 -88
- package/src/settings-chat-display.ts +11 -0
- package/src/settings-chat-fullscreen.ts +264 -0
- package/src/settings-chat-scroll.ts +17 -0
- package/src/settings-chat-tools.ts +207 -0
- package/src/settings-chat-transcript.ts +133 -62
- package/src/settings-chat-ui.ts +109 -98
- package/dist/chunks/chunk-HPZTMIZS.ts.map +0 -7
- package/dist/chunks/chunk-PWTSHSP3.ts.map +0 -7
- package/dist/chunks/command-settings-chat-O34BEU4X.ts.map +0 -7
- package/dist/chunks/commands-ZYIJVIEJ.ts.map +0 -7
- /package/dist/chunks/{command-configuration-menu-S2LXCOJG.ts.map → command-configuration-menu-ZN2VXU4L.ts.map} +0 -0
package/README.md
CHANGED
|
@@ -10,7 +10,7 @@ The extension parses and renders the footer itself, so it does not need the `sta
|
|
|
10
10
|
|
|
11
11
|
## ✨ Features
|
|
12
12
|
|
|
13
|
-
-
|
|
13
|
+
- Keeps Pi's native footer until settings are saved and offers Starship presets plus a Pi-native Minimal preset.
|
|
14
14
|
- Supports root and module formats, conditional groups, `$all`, styles, palettes, and width-aware `$fill` alignment.
|
|
15
15
|
- Selects provider, model, and thinking styles from exact runtime values with ordered module rules.
|
|
16
16
|
- Provides Pi, model, usage, Git, pull request, package, language, environment, deployment, cloud, and execution modules, with usage totals including persisted cache warming.
|
|
@@ -48,7 +48,7 @@ Do not enable this with `@narumitw/pi-statusline`: both own Pi's footer, and Pi
|
|
|
48
48
|
|
|
49
49
|
## 🚀 Quick start
|
|
50
50
|
|
|
51
|
-
Start Pi with the extension to
|
|
51
|
+
Start Pi with the extension to keep Pi's native footer without creating a settings file.
|
|
52
52
|
Run `/starship` and choose **Configure with agent** for edits and explanations, or choose a preset.
|
|
53
53
|
|
|
54
54
|
The bundled configuration skill is manual-only and is not available for automatic model invocation.
|
|
@@ -76,7 +76,7 @@ It does not cover general TOML, shell Starship configuration, extension source d
|
|
|
76
76
|
All routes support TUI and RPC with the exceptions above and reject unknown or trailing arguments.
|
|
77
77
|
Print and JSON modes produce no command output; the footer runs only in TUI mode.
|
|
78
78
|
Profiles, history, preset selection, configuration chat, and Gist sharing and import are menu-only, not extra subcommands.
|
|
79
|
-
|
|
79
|
+
**Restore built-in…** archives the exact settings bytes in History, removes the active settings document, and returns to Pi's native footer. It requires an existing document, including a saved built-in Starship example.
|
|
80
80
|
Configuration shows source, path, health, and warnings above its reload, Gist, and History operations. Configured selection page-up/page-down actions scroll long summaries without changing the selected operation.
|
|
81
81
|
|
|
82
82
|
## ⚙️ Settings
|
|
@@ -109,7 +109,7 @@ See [Configuration and format](./skills/configure-pi-starship/references/configu
|
|
|
109
109
|
Use `/starship` for interactive configuration, preview, diagnostics, presets, and recovery.
|
|
110
110
|
Manual file edits load at the next `session_start`, including `/reload`.
|
|
111
111
|
|
|
112
|
-
|
|
112
|
+
The built-in Starship example remains an editing seed; saving it enables a Starship footer, not Pi's native footer.
|
|
113
113
|
Module references cover bounded regex substitutions/context rules, component version formats, Git templates/controls, clock zones/ranges, Python argv alternatives, environment detectors, requirement styling, and private-package visibility.
|
|
114
114
|
The six Jujutsu/system modules require explicit `disabled = false` plus a root reference or `$all`; see [module behavior](./skills/configure-pi-starship/references/modules.md#jujutsu-modules).
|
|
115
115
|
|
|
@@ -131,23 +131,28 @@ These tool limits are not an operating-system sandbox for extension code.
|
|
|
131
131
|
The native editor retains editing, newline, submission, and large-paste behavior.
|
|
132
132
|
While the agent runs, normal submission queues a steering message for the next assistant turn; `app.message.followUp` queues a message after the current task finishes.
|
|
133
133
|
The default follow-up key is Alt+Enter, or Ctrl+Q on Windows and WSL; when idle, it submits normally.
|
|
134
|
+
Tool output starts with the main conversation's current expansion setting (collapsed by default in Pi). Ctrl+O follows `app.tools.expand` and changes only this side thread; its setting is retained when returning from review or profile naming. Completed tool blocks also support native click-to-toggle behavior.
|
|
135
|
+
Tool arguments, progress, results, errors, and edit previews use Pi's built-in read/write/edit renderers and lifecycle. Edit previews can read only the owned draft. Native renderer rules still apply: Ctrl+O does not force an edit diff to collapse if Pi's edit renderer keeps it visible.
|
|
134
136
|
Pending messages appear in gray above the editor, with a count on its upper border; the view shows at most three pending rows.
|
|
135
137
|
Use `app.message.dequeue` (Alt+Up, or Alt+Q on Windows and WSL) to restore queued messages to the editor.
|
|
136
138
|
These message shortcuts use Pi's configured bindings and native precedence, including explicit history actions taking priority.
|
|
137
|
-
The configured cancel action stops an active response and restores undelivered messages to the editor; when idle, it
|
|
139
|
+
The configured cancel action stops an active response and restores undelivered messages to the editor; when idle, it leaves the conversation open without opening a menu.
|
|
138
140
|
Failed or aborted responses also restore undelivered messages without restarting automatically.
|
|
139
|
-
Editor actions win conflicting cancel bindings, and Escape remains a
|
|
141
|
+
Editor actions win conflicting cancel bindings, and Escape remains a stop fallback unless assigned to an editor action.
|
|
140
142
|
Ctrl+C discards the entire flow, including when cancellation is remapped, and restores the current session's active footer.
|
|
141
|
-
The fullscreen chat
|
|
142
|
-
|
|
143
|
+
The fullscreen chat uses a Starship-owned `TuiAltScreen` with Pi's native user, assistant, and tool message components, including Markdown, user-message backgrounds, and message spacing.
|
|
144
|
+
A native `ScrollView` holds the history; queued messages, the editor, diagnostics, and footer preview stay in a fixed bottom dock.
|
|
145
|
+
Use the mouse wheel or configured `tui.altScreen.*` viewport actions to scroll history, including `tui.altScreen.pageUp` and `tui.altScreen.pageDown`.
|
|
146
|
+
This intentionally replaces history paging through `tui.editor.pageUp` and `tui.editor.pageDown`; move custom history paging bindings to the corresponding `tui.altScreen.*` actions.
|
|
147
|
+
The editor retains its native editing bindings; native viewport actions take priority when bindings conflict.
|
|
143
148
|
Short gray labels on the editor borders show draft status and controls.
|
|
144
149
|
The full-width preview has no extra separator, with its last line at the terminal bottom, matching the saved footer's position.
|
|
145
150
|
At short heights, error details yield first; if the whole preview cannot fit beside the editor, it is hidden rather than clipped.
|
|
146
|
-
The view shows recent output with
|
|
147
|
-
Choose **Continue** in
|
|
151
|
+
The view shows recent output with read-only tool results and the current local expansion setting.
|
|
152
|
+
Choose **Continue** in the exact-draft save review; cancelling discards the temporary draft but keeps any previously saved profile.
|
|
148
153
|
|
|
149
154
|
**The agent never writes the active settings file or profiles.** When idle with a valid draft, press **Ctrl+S** to save it as a profile; the gray editor-border hint shows the active save key.
|
|
150
|
-
If Ctrl+S conflicts with a native editing, cancel, or message action, **F2** is used instead. If both are reserved,
|
|
155
|
+
If Ctrl+S conflicts with a native editing, cancel, or message action, **F2** is used instead. If both are reserved, saving is unavailable until one shortcut is free; no save shortcut is shown.
|
|
151
156
|
Review the exact draft and enter a profile name; invalid or existing names require another name, without overwriting profiles.
|
|
152
157
|
After the profile is saved, a separate confirmation asks whether to apply it to the current footer without reload, retaining the previous active document in History.
|
|
153
158
|
Declining closes the chat, keeps the saved profile, and leaves active settings unchanged; an application failure also retains the profile.
|
|
@@ -156,6 +161,12 @@ Cancelling the name prompt returns to the chat without saving. Closing, discardi
|
|
|
156
161
|
Detected changes to disk, loaded settings, or the saved profile block stale application; this is not a cross-process lock.
|
|
157
162
|
Saving a repair of an invalid original document requires an explicit repair warning in the confirmation.
|
|
158
163
|
|
|
164
|
+
The parent TUI is suspended while the chat owns the shared terminal; only one renderer is active at a time.
|
|
165
|
+
Terminal ownership returns before the existing parent-hosted review, profile-name, and apply-confirmation screens open.
|
|
166
|
+
This intentionally deviates from Pi's guidance not to create a second terminal renderer in an extension: Starship uses a separate fullscreen host for native history scrolling and a fixed dock, with lifecycle tests required for safe ownership transfer.
|
|
167
|
+
It is not a claim of official support or a diagnosis or verified fix of the originally reported wheel/key failure.
|
|
168
|
+
See [Configuration chat runtime](https://github.com/narumiruna/pi-extensions/blob/main/packages/pi-starship/docs/configuration-chat-runtime.md) in the repository for ownership rules, verification evidence, and the maintainer's physical-terminal checklist.
|
|
169
|
+
|
|
159
170
|
Your chat input, settings and runtime module snapshots read by the agent, local paths, and tool results are sent to the selected model provider.
|
|
160
171
|
Do not include secrets in the draft or conversation.
|
|
161
172
|
This flow requires TUI mode and a model whose provider supports normal tool calls; it does not load parent extensions, project instructions, MCP tools, or the main transcript into the child.
|
|
@@ -234,6 +245,7 @@ packages/pi-starship/
|
|
|
234
245
|
│ └── pi-starship.ts # Footer lifecycle and cached refresh
|
|
235
246
|
├── dist/ # Generated Jiti runtime
|
|
236
247
|
├── scripts/build-runtime.mjs # Runtime builder
|
|
248
|
+
├── docs/ # Configuration chat runtime and terminal handoff
|
|
237
249
|
├── skills/configure-pi-starship/ # Authoritative configuration skill and references
|
|
238
250
|
└── test/ # Behavior and lifecycle coverage
|
|
239
251
|
```
|
|
@@ -2083,6 +2083,9 @@ ${BUILT_IN_FORMAT_DOCUMENT}
|
|
|
2083
2083
|
function settingsFilePath(agentDir) {
|
|
2084
2084
|
return join(agentDir, CONFIG_FILE_NAME);
|
|
2085
2085
|
}
|
|
2086
|
+
function nativeFooterConfig(settingsPath) {
|
|
2087
|
+
return { config: cloneBuiltInConfig(), source: "built-in", settingsPath, diagnostics: [] };
|
|
2088
|
+
}
|
|
2086
2089
|
function loadStarshipConfig(settingsPath) {
|
|
2087
2090
|
let rawDocument;
|
|
2088
2091
|
let snapshot;
|
|
@@ -2093,12 +2096,7 @@ function loadStarshipConfig(settingsPath) {
|
|
|
2093
2096
|
rawDocument = rawBytes.toString("utf8");
|
|
2094
2097
|
} catch (error) {
|
|
2095
2098
|
if (error.code === "ENOENT" && !existsSync(settingsPath)) {
|
|
2096
|
-
return
|
|
2097
|
-
config: cloneBuiltInConfig(),
|
|
2098
|
-
source: "built-in",
|
|
2099
|
-
settingsPath,
|
|
2100
|
-
diagnostics: []
|
|
2101
|
-
};
|
|
2099
|
+
return nativeFooterConfig(settingsPath);
|
|
2102
2100
|
}
|
|
2103
2101
|
return {
|
|
2104
2102
|
config: cloneBuiltInConfig(),
|
|
@@ -2687,6 +2685,7 @@ export {
|
|
|
2687
2685
|
MODULE_NAMES,
|
|
2688
2686
|
BUILT_IN_EXAMPLE,
|
|
2689
2687
|
settingsFilePath,
|
|
2688
|
+
nativeFooterConfig,
|
|
2690
2689
|
loadStarshipConfig,
|
|
2691
2690
|
readConfigDocumentSnapshot,
|
|
2692
2691
|
assertConfigDocumentUnchanged,
|
|
@@ -2697,4 +2696,4 @@ export {
|
|
|
2697
2696
|
removeConfigDocumentIfMatches,
|
|
2698
2697
|
activePalette
|
|
2699
2698
|
};
|
|
2700
|
-
//# sourceMappingURL=chunk-
|
|
2699
|
+
//# sourceMappingURL=chunk-A65IOGL6.ts.map
|