@narumitw/pi-starship 0.60.1 → 0.63.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 +67 -9
- package/dist/chunks/chunk-63R6R5DH.ts +679 -0
- package/dist/chunks/chunk-63R6R5DH.ts.map +7 -0
- package/dist/chunks/{chunk-KZZKGGFW.ts → chunk-A65IOGL6.ts} +858 -1007
- package/dist/chunks/chunk-A65IOGL6.ts.map +7 -0
- package/dist/chunks/chunk-IYDZ3R2T.ts +69 -0
- package/dist/chunks/chunk-IYDZ3R2T.ts.map +7 -0
- package/dist/chunks/chunk-KP33I6BR.ts +579 -0
- package/dist/chunks/chunk-KP33I6BR.ts.map +7 -0
- package/dist/chunks/{chunk-PD457PX5.ts → chunk-S2KBLHE2.ts} +75 -10
- package/dist/chunks/chunk-S2KBLHE2.ts.map +7 -0
- package/dist/chunks/chunk-XQUIQO2G.ts +20 -0
- package/dist/chunks/chunk-XQUIQO2G.ts.map +7 -0
- package/dist/chunks/{chunk-ADX4CY27.ts → chunk-XTLQ4WUL.ts} +1 -1
- package/dist/chunks/chunk-XTLQ4WUL.ts.map +7 -0
- package/dist/chunks/chunk-Y24TJYG6.ts +1586 -0
- package/dist/chunks/chunk-Y24TJYG6.ts.map +7 -0
- package/dist/chunks/{cloud-EPAEV4ZB.ts → cloud-J2ZOE3HE.ts} +6 -2
- package/dist/chunks/cloud-J2ZOE3HE.ts.map +7 -0
- package/dist/chunks/command-configuration-menu-YOLN2SPR.ts +147 -0
- package/dist/chunks/command-configuration-menu-YOLN2SPR.ts.map +7 -0
- package/dist/chunks/command-settings-chat-5AHP3JGV.ts +1124 -0
- package/dist/chunks/command-settings-chat-5AHP3JGV.ts.map +7 -0
- package/dist/chunks/commands-IOG2PL67.ts +1026 -0
- package/dist/chunks/commands-IOG2PL67.ts.map +7 -0
- package/dist/chunks/{deployment-7J54EHNR.ts → deployment-NOJ2KCLI.ts} +85 -5
- package/dist/chunks/deployment-NOJ2KCLI.ts.map +7 -0
- package/dist/chunks/{development-IWJAAAEV.ts → development-T3XXVVDP.ts} +67 -15
- package/dist/chunks/development-T3XXVVDP.ts.map +7 -0
- package/dist/chunks/directory-OX6BWJZA.ts +31 -0
- package/dist/chunks/directory-OX6BWJZA.ts.map +7 -0
- package/dist/chunks/{execution-P4WZALW2.ts → execution-R2OHIP2L.ts} +8 -4
- package/dist/chunks/execution-R2OHIP2L.ts.map +7 -0
- package/dist/chunks/jujutsu-XLDYKSX2.ts +174 -0
- package/dist/chunks/jujutsu-XLDYKSX2.ts.map +7 -0
- package/dist/chunks/languages-CBQNNYXM.ts +262 -0
- package/dist/chunks/languages-CBQNNYXM.ts.map +7 -0
- package/dist/chunks/{package-H24VJEX3.ts → package-7KVAK3TC.ts} +6 -2
- package/dist/chunks/package-7KVAK3TC.ts.map +7 -0
- package/dist/chunks/system-574MHB4R.ts +165 -0
- package/dist/chunks/system-574MHB4R.ts.map +7 -0
- package/dist/index.ts +670 -206
- package/dist/index.ts.map +4 -4
- package/package.json +5 -1
- package/skills/configure-pi-starship/SKILL.md +17 -1
- package/skills/configure-pi-starship/references/configuration.md +119 -32
- package/skills/configure-pi-starship/references/module-catalog.md +278 -25
- package/skills/configure-pi-starship/references/modules.md +213 -36
- package/skills/configure-pi-starship/references/runtime-and-security.md +88 -28
- package/src/command-commit.ts +41 -7
- package/src/command-configuration-menu.ts +155 -0
- package/src/command-configuration.ts +15 -94
- package/src/command-preview.ts +3 -3
- package/src/command-settings-chat.ts +168 -0
- package/src/commands.ts +76 -124
- package/src/config/module-options.ts +112 -0
- package/src/config.ts +23 -59
- package/src/effective-config.ts +5 -4
- package/src/format/bounded-regex.ts +66 -0
- package/src/format/version.ts +24 -0
- package/src/modules/catalog.ts +10 -0
- package/src/modules/cloud.ts +1 -0
- package/src/modules/deployment.ts +8 -0
- package/src/modules/development.ts +20 -2
- package/src/modules/directory.ts +171 -51
- package/src/modules/execution.ts +2 -0
- package/src/modules/git/branch.ts +19 -4
- package/src/modules/git/commit.ts +9 -2
- package/src/modules/git/metrics.ts +9 -4
- package/src/modules/git/runtime.ts +122 -33
- package/src/modules/git/state.ts +23 -2
- package/src/modules/git/status-templates.ts +58 -0
- package/src/modules/git/status.ts +96 -30
- package/src/modules/jujutsu.ts +225 -0
- package/src/modules/languages.ts +26 -2
- package/src/modules/package.ts +1 -0
- package/src/modules/render.ts +42 -16
- package/src/modules/system.ts +54 -0
- package/src/modules/time-format.ts +188 -0
- package/src/modules/time.ts +11 -5
- package/src/modules/types.ts +42 -4
- package/src/pi-starship.ts +198 -88
- package/src/profile-store.ts +5 -0
- package/src/runtime/cloud.ts +3 -0
- package/src/runtime/command.ts +1 -1
- package/src/runtime/deployment.ts +120 -4
- package/src/runtime/development.ts +86 -13
- package/src/runtime/directory.ts +33 -0
- package/src/runtime/execution.ts +12 -2
- package/src/runtime/helpers.ts +57 -8
- package/src/runtime/jujutsu.ts +225 -0
- package/src/runtime/languages.ts +106 -19
- package/src/runtime/package.ts +3 -0
- package/src/runtime/system.ts +202 -0
- package/src/runtime/types.ts +3 -0
- package/src/runtime/version-requirements.ts +30 -0
- package/src/runtime/workspace.ts +12 -1
- package/src/settings-agent.ts +80 -0
- package/src/settings-chat-transcript.ts +192 -0
- package/src/settings-chat-ui.ts +526 -0
- package/src/settings-draft.ts +260 -0
- package/src/settings-snapshots.ts +41 -0
- package/dist/chunks/chunk-ADX4CY27.ts.map +0 -7
- package/dist/chunks/chunk-KZZKGGFW.ts.map +0 -7
- package/dist/chunks/chunk-PD457PX5.ts.map +0 -7
- package/dist/chunks/cloud-EPAEV4ZB.ts.map +0 -7
- package/dist/chunks/commands-C2VJ6ZBN.ts +0 -3374
- package/dist/chunks/commands-C2VJ6ZBN.ts.map +0 -7
- package/dist/chunks/deployment-7J54EHNR.ts.map +0 -7
- package/dist/chunks/development-IWJAAAEV.ts.map +0 -7
- package/dist/chunks/execution-P4WZALW2.ts.map +0 -7
- package/dist/chunks/languages-JO6R2PHL.ts +0 -168
- package/dist/chunks/languages-JO6R2PHL.ts.map +0 -7
- package/dist/chunks/package-H24VJEX3.ts.map +0 -7
- package/src/command-inspector.ts +0 -41
package/README.md
CHANGED
|
@@ -10,13 +10,15 @@ 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.
|
|
17
|
+
- Offers opt-in Jujutsu, native RAM/optional Linux swap, and Linux sysfs battery modules, all disabled by default.
|
|
17
18
|
- Wraps native multiline layouts to terminal width instead of truncating them.
|
|
18
19
|
- Keeps rendering pure while refreshing filesystem, process, and network-derived data through bounded caches.
|
|
19
20
|
- Uses `/starship` for named TOML profiles, live previews, presets, customization, and recovery history.
|
|
21
|
+
- Offers a separate configuration chat with the bundled skill and draft-only file tools; valid edits preview immediately without reload.
|
|
20
22
|
- Shares settings through unlisted GitHub Gists and reviews imported settings before replacement.
|
|
21
23
|
- Bundles the authoritative configuration skill and references for editing `pi-starship.toml` or answering setup questions.
|
|
22
24
|
- Loads a generated split runtime to reduce Pi package startup work.
|
|
@@ -46,8 +48,8 @@ Do not enable this with `@narumitw/pi-statusline`: both own Pi's footer, and Pi
|
|
|
46
48
|
|
|
47
49
|
## 🚀 Quick start
|
|
48
50
|
|
|
49
|
-
Start Pi with the extension to
|
|
50
|
-
Run `/starship`
|
|
51
|
+
Start Pi with the extension to keep Pi's native footer without creating a settings file.
|
|
52
|
+
Run `/starship` and choose **Configure with agent** for edits and explanations, or choose a preset.
|
|
51
53
|
|
|
52
54
|
The bundled configuration skill is manual-only and is not available for automatic model invocation.
|
|
53
55
|
Run `/skill:configure-pi-starship` before asking Pi to explain or edit `pi-starship.toml`:
|
|
@@ -59,22 +61,23 @@ Run `/skill:configure-pi-starship` before asking Pi to explain or edit `pi-stars
|
|
|
59
61
|
|
|
60
62
|
The skill was renamed from `configuring-pi-starship`; use `/skill:configure-pi-starship` instead of the old invocation.
|
|
61
63
|
The skill loads the relevant reference and validates file edits.
|
|
64
|
+
For a separate preview-only conversation, open `/starship` → **Configure with agent** instead.
|
|
62
65
|
It does not cover general TOML, shell Starship configuration, extension source development, or unrelated footer work.
|
|
63
66
|
|
|
64
67
|
## 💬 Commands
|
|
65
68
|
|
|
66
69
|
| Command | Purpose |
|
|
67
70
|
| --- | --- |
|
|
68
|
-
| `/starship` |
|
|
71
|
+
| `/starship` | Configure with agent, manage profiles, preview presets, or recover settings; RPC shows help. |
|
|
69
72
|
| `/starship settings` | Edit, preview, and confirm TOML; RPC shows the file path. |
|
|
70
73
|
| `/starship status` | Show the configuration source, path, and diagnostics. |
|
|
71
74
|
| `/starship help` | Show command and configuration help. |
|
|
72
75
|
|
|
73
76
|
All routes support TUI and RPC with the exceptions above and reject unknown or trailing arguments.
|
|
74
77
|
Print and JSON modes produce no command output; the footer runs only in TUI mode.
|
|
75
|
-
Profiles, history, preset selection,
|
|
76
|
-
|
|
77
|
-
|
|
78
|
+
Profiles, history, preset selection, configuration chat, and Gist sharing and import are menu-only, not extra subcommands.
|
|
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
|
+
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.
|
|
78
81
|
|
|
79
82
|
## ⚙️ Settings
|
|
80
83
|
|
|
@@ -106,6 +109,58 @@ See [Configuration and format](./skills/configure-pi-starship/references/configu
|
|
|
106
109
|
Use `/starship` for interactive configuration, preview, diagnostics, presets, and recovery.
|
|
107
110
|
Manual file edits load at the next `session_start`, including `/reload`.
|
|
108
111
|
|
|
112
|
+
The built-in Starship example remains an editing seed; saving it enables a Starship footer, not Pi's native footer.
|
|
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
|
+
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
|
+
|
|
116
|
+
## 🧠 Configuration chat
|
|
117
|
+
|
|
118
|
+
Open `/starship` → **Configure with agent** to adjust the footer in a separate, temporary conversation.
|
|
119
|
+
The agent explicitly loads `configure-pi-starship` and uses the model and thinking level selected when the chat opens, through Pi's current provider authentication.
|
|
120
|
+
The main conversation, tools, and model selection are unchanged; the chat is not persisted and has no automatic compaction or retry workflow.
|
|
121
|
+
Its usage is separate from the main session's usage totals.
|
|
122
|
+
|
|
123
|
+
The agent has `read`, `write`, and `edit`, but no shell tool.
|
|
124
|
+
Reads are limited to immutable disk and loaded-settings snapshots, normalized active TOML, configuration diagnostics, module inspection, the private draft, and bundled configuration skill/source documents; writes and edits can change only the private draft, limited to 64 KiB.
|
|
125
|
+
Active-state snapshots are fixed when the chat opens, not continuously current; draft previews do not update them. Module inspection uses existing runtime data without starting collectors and reports when the footer is unavailable.
|
|
126
|
+
The disk baseline can differ from the loaded document after external edits. The ordinary main-session skill does not gain live runtime access; use this chat for active-state questions.
|
|
127
|
+
Each valid edit updates the footer preview immediately, without `/reload`; an invalid edit returns diagnostics and retains the last valid preview until repaired.
|
|
128
|
+
Previews use cached runtime data and do not start module commands or network requests.
|
|
129
|
+
These tool limits are not an operating-system sandbox for extension code.
|
|
130
|
+
|
|
131
|
+
The native editor retains editing, newline, submission, and large-paste behavior.
|
|
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
|
+
The default follow-up key is Alt+Enter, or Ctrl+Q on Windows and WSL; when idle, it submits normally.
|
|
134
|
+
Tool output starts expanded. Press Ctrl+O to collapse or expand all tool output in this conversation; this follows Pi's `app.tools.expand` keybinding and does not change the main conversation.
|
|
135
|
+
Pending messages appear in gray above the editor, with a count on its upper border; the view shows at most three pending rows.
|
|
136
|
+
Use `app.message.dequeue` (Alt+Up, or Alt+Q on Windows and WSL) to restore queued messages to the editor.
|
|
137
|
+
These message shortcuts use Pi's configured bindings and native precedence, including explicit history actions taking priority.
|
|
138
|
+
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.
|
|
139
|
+
Failed or aborted responses also restore undelivered messages without restarting automatically.
|
|
140
|
+
Editor actions win conflicting cancel bindings, and Escape remains a stop fallback unless assigned to an editor action.
|
|
141
|
+
Ctrl+C discards the entire flow, including when cancellation is remapped, and restores the current session's active footer.
|
|
142
|
+
The fullscreen chat reuses Pi's native user, assistant, and tool message components, including Markdown, user-message backgrounds, and message spacing.
|
|
143
|
+
The editor and footer preview stay at the bottom while the transcript grows above them.
|
|
144
|
+
Short gray labels on the editor borders show draft status and controls.
|
|
145
|
+
The full-width preview has no extra separator, with its last line at the terminal bottom, matching the saved footer's position.
|
|
146
|
+
At short heights, error details yield first; if the whole preview cannot fit beside the editor, it is hidden rather than clipped.
|
|
147
|
+
The view shows recent output with expanded, read-only tool results.
|
|
148
|
+
Choose **Continue** in the exact-draft save review; cancelling discards the temporary draft but keeps any previously saved profile.
|
|
149
|
+
|
|
150
|
+
**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.
|
|
151
|
+
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.
|
|
152
|
+
Review the exact draft and enter a profile name; invalid or existing names require another name, without overwriting profiles.
|
|
153
|
+
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.
|
|
154
|
+
Declining closes the chat, keeps the saved profile, and leaves active settings unchanged; an application failure also retains the profile.
|
|
155
|
+
Applying can start enabled module commands and network requests; review those settings first.
|
|
156
|
+
Cancelling the name prompt returns to the chat without saving. Closing, discarding, session replacement, or shutdown removes the temporary draft, not a previously saved profile.
|
|
157
|
+
Detected changes to disk, loaded settings, or the saved profile block stale application; this is not a cross-process lock.
|
|
158
|
+
Saving a repair of an invalid original document requires an explicit repair warning in the confirmation.
|
|
159
|
+
|
|
160
|
+
Your chat input, settings and runtime module snapshots read by the agent, local paths, and tool results are sent to the selected model provider.
|
|
161
|
+
Do not include secrets in the draft or conversation.
|
|
162
|
+
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.
|
|
163
|
+
|
|
109
164
|
## 🗃️ Profiles and history
|
|
110
165
|
|
|
111
166
|
Open `/starship` → **Profiles** to save the current TOML under a name, edit it, duplicate it, rename it, or delete it.
|
|
@@ -153,8 +208,11 @@ Cancelling or losing an upload response cannot undo a Gist already created on Gi
|
|
|
153
208
|
|
|
154
209
|
## 🔒 Security and privacy
|
|
155
210
|
|
|
156
|
-
Some opt-in modules read local development, deployment, cloud, host, or
|
|
157
|
-
Review [Runtime and security](./skills/configure-pi-starship/references/runtime-and-security.md) before enabling them.
|
|
211
|
+
Some opt-in modules read local development, deployment, cloud, host, user, or system metadata, run bounded local commands, or query GitHub through `gh`.
|
|
212
|
+
Review [Runtime and security](./skills/configure-pi-starship/references/runtime-and-security.md) before enabling them or accepting imported settings, especially configured Python executables/arguments and environment detector names.
|
|
213
|
+
Jujutsu reads the recorded change without snapshotting dirty files or integrating operations.
|
|
214
|
+
Battery is Linux sysfs only; memory uses native RAM totals with Linux swap only when requested.
|
|
215
|
+
Physical battery-state transitions remain unverified; no cross-platform battery support is claimed.
|
|
158
216
|
|
|
159
217
|
## 🚧 Limitations
|
|
160
218
|
|