@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.
Files changed (34) hide show
  1. package/README.md +23 -11
  2. package/dist/chunks/{chunk-PWTSHSP3.ts → chunk-A65IOGL6.ts} +6 -7
  3. package/dist/chunks/chunk-A65IOGL6.ts.map +7 -0
  4. package/dist/chunks/{chunk-HPZTMIZS.ts → chunk-DIHVBO5Z.ts} +41 -8
  5. package/dist/chunks/chunk-DIHVBO5Z.ts.map +7 -0
  6. package/dist/chunks/{chunk-43VIENBN.ts → chunk-UIKPE4UC.ts} +7 -7
  7. package/dist/chunks/{chunk-43VIENBN.ts.map → chunk-UIKPE4UC.ts.map} +2 -2
  8. package/dist/chunks/{command-configuration-menu-S2LXCOJG.ts → command-configuration-menu-ZN2VXU4L.ts} +3 -3
  9. package/dist/chunks/{command-settings-chat-O34BEU4X.ts → command-settings-chat-KLUVZXMO.ts} +632 -196
  10. package/dist/chunks/command-settings-chat-KLUVZXMO.ts.map +7 -0
  11. package/dist/chunks/{commands-ZYIJVIEJ.ts → commands-UAUSSHVS.ts} +25 -20
  12. package/dist/chunks/commands-UAUSSHVS.ts.map +7 -0
  13. package/dist/index.ts +116 -59
  14. package/dist/index.ts.map +3 -3
  15. package/package.json +1 -1
  16. package/skills/configure-pi-starship/SKILL.md +3 -1
  17. package/skills/configure-pi-starship/references/configuration.md +14 -12
  18. package/src/command-commit.ts +41 -7
  19. package/src/command-configuration.ts +8 -10
  20. package/src/command-settings-chat.ts +18 -48
  21. package/src/commands.ts +23 -26
  22. package/src/config.ts +6 -6
  23. package/src/pi-starship.ts +155 -88
  24. package/src/settings-chat-display.ts +11 -0
  25. package/src/settings-chat-fullscreen.ts +264 -0
  26. package/src/settings-chat-scroll.ts +17 -0
  27. package/src/settings-chat-tools.ts +207 -0
  28. package/src/settings-chat-transcript.ts +133 -62
  29. package/src/settings-chat-ui.ts +109 -98
  30. package/dist/chunks/chunk-HPZTMIZS.ts.map +0 -7
  31. package/dist/chunks/chunk-PWTSHSP3.ts.map +0 -7
  32. package/dist/chunks/command-settings-chat-O34BEU4X.ts.map +0 -7
  33. package/dist/chunks/commands-ZYIJVIEJ.ts.map +0 -7
  34. /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
- - Starts with a readable built-in footer and offers Starship presets plus a Pi-native Minimal preset.
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 use the built-in footer without creating a settings file.
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
- Restoring built-in configuration requires an existing settings document to replace; see [Settings](#-settings).
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
- Existing defaults and the built-in footer remain unchanged.
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 opens review actions for continuing, inspecting the full transcript or exact draft, saving, or discarding.
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 review fallback unless assigned to an editor action.
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 reuses Pi's native user, assistant, and tool message components, including Markdown, user-message backgrounds, and message spacing.
142
- The editor and footer preview stay at the bottom while the transcript grows above them.
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 expanded, read-only tool results; use the full conversation review for earlier or long responses.
147
- Choose **Continue** in a document or transcript review; cancelling discards the temporary draft but keeps any previously saved profile.
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, no save shortcut is shown; the review menu still offers **Save draft as profile…**.
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-PWTSHSP3.ts.map
2699
+ //# sourceMappingURL=chunk-A65IOGL6.ts.map