@groeponline/pi-wishcraft 0.19.2 → 0.21.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## [Unreleased]
 
+## [0.21.0] - 2026-08-20
+
+### Added
+- `/powerline doctor` and `/powerline export`.
+- `/queue archive [hours]` with a single clock snapshot so sent items cannot vanish from both inbox and archive.
+- Focused guides under `docs/` (commands, configuration, segments, bash mode, vibes, shortcuts).
+- What's New welcome widget, cost-alert threshold, ChefGroep status export, and optional fleet SSH open-port probes.
+
+## [0.20.0] - 2026-08-20
+
+### Added
+- `alt+p` menu is three overlay entries (Navigate, Configure, Status) with a Status drill-down for ports, TPS, and toggle.
+
+### Fixed
+- `theme.json` in the working directory overrides icons, and the theme cache busts when that file changes.
+
+### Changed
+- npm pack includes `banner.png` so the published tarball matches `pi.image`.
+
 ## [0.19.2] - 2026-08-20
 
 ### Added

package/README.md

@@ -66,6 +66,8 @@ curl -fsSL https://raw.githubusercontent.com/GroepOnline/pi-wishcraft/main/scrip
 
 Restart or `/reload` pi to activate.
 
+Extended guides (segments, bash mode, commands, configuration) live in [`docs/`](docs/index.md).
+
 ## Usage
 
 Activates automatically. Toggle with `/powerline`, switch presets with `/powerline <name>`, and move the primary row with `/powerline placement above|below|toggle`. Tab after `/powerline` completes preset names and `placement`; tab again after `placement` completes `above`, `below`, or `toggle`.
@@ -247,7 +249,7 @@ Interactivity (Pi core renders the footer as static text, so live click is not p
 
 - `/tps [value]`: show or set `POWERLINE_TPS`
 - `/open-ports`: list listening ports and pick one
-- `alt+p`: **powerline menu**: navigate the live segments (`↑`/`↓` + `enter`), configure (preset / TPS / UDP / labels), or open the full ports list
+- `alt+p`: **powerline menu**: three overlays (Navigate, Configure, Status). Status drills down to ports, TPS, and toggle.
 - `alt+i`: **powerline info**: full open-ports list
 
 Both `alt+p` and `alt+i` are rebindable (see Keybinds below); changes apply after `/reload`.

package/ROADMAP.md

@@ -1,9 +1,9 @@
 # Roadmap — pi-wishcraft
 
-Herschreven 2026-08-18. Vierde pass 2026-08-20: conflict-restant uit
-`19d6cc0` weg. 0.19-code + catalogus staan op main (#12, #11). Overlay-
-submenus en de rest van de repairs blijven 0.20. CHE-40 is follow-up,
-geen 0.19-blocker. `v0.19.0` en `v0.19.1` staan op npm.
+Herschreven 2026-08-18. Vijfde pass 2026-08-20: 0.19.0–0.19.2 staan
+op npm. CHE-40 (`/powerline` tab) is Done via #18. Overlay-submenus
+(CHE-42 / #19) starten 0.20. ROADMAP was achter op de code: hooks,
+repairs-subset en skills-manager v2 UI zitten al op `main`.
 
 Pi core is de engine. Wishcraft is de cockpit. Elke feature dient één van
 drie doelen: **grip** (skills, tokens, config), **prestatie** (repairs,
@@ -76,7 +76,7 @@ Niet de fork. Niet de SaaS-agent.
   gebruikerscontent.
 - Geen skills-markt als identiteit vóór 1.0. Eerst discovery die klopt
   en een manager die zoekt.
-- Geen fleet-SSH `open_ports` totdat iemand het concreet vraagt.
+- Geen fleet-SSH `open_ports` zonder expliciete opt-in (`segmentOptions.openPorts.host`; sanitized, geen shell-injectie).
 - Geen versie-reset naar 1.0.0. We blijven op 0.19 → 0.20 → 1.0 wanneer
   de cockpit stabiel is.
 
@@ -84,16 +84,15 @@ Niet de fork. Niet de SaaS-agent.
 
 ## Mijlpalen
 
-- **0.19.0 — "Correctheid"** (deze campagne). Bugs en hygiëne eerst.
-  Kleine config-afmakers. Geen hooks, geen repairs, geen manager-v2-UI,
-  geen overlay-submenus. Done = npm 0.19.0 live, `/skills` filtert,
-  `$test` expandeert geen debris, `npm test` + `npm run typecheck` +
-  `madge --circular` groen op de tag. Als de config-PR uitloopt:
-  tag **0.18.1** met alleen PR A (bugs). Correctheid wacht niet op
-  labels.
-- **0.20.0 — "Harness"**. Hooks + tool-input repairs + skills-manager
-  v2-UI + token-overlays. Done = drie README-hookvoorbeelden werken,
-  repair-teller zichtbaar, `/skills` zoekt op naam+beschrijving+pad.
+- **0.19.0–0.19.2 — "Correctheid"** (geland). Bugs, hygiëne, catalogus,
+  auto-release, `/powerline` tab. Hooks, repairs-subset en skills
+  manager v2 UI gingen mee in #12, eerder dan deze sectie beloofde.
+  Done = npm 0.19.2 live, `/skills` filtert, `$test` expandeert geen
+  debris, verify-trio groen op de tag.
+- **0.20.0 — "Harness"**. Overlay-chrome + CHE-42 drill-down, Configure
+  uit `ctx.ui.select`, token-overlays, rest-repairs, README-hooks die
+  waar zijn. Done = drie README-hookvoorbeelden werken, repair-teller
+  zichtbaar, `alt+p` overlay-boom, `/tps` deelt de ring met het segment.
 - **1.0 — "Cockpit"**. Skills-doctor/install, declaratieve policy,
   preset-editor, idee-review, stabiele ChefGroep-statuskeys,
   documentatie die waar is. Done = README dekt alles wat we shipten,
@@ -173,7 +172,13 @@ GRO-1061 (runner-queue) is ops, geen product-slice.
 
 ## 0.20.0 — Harness
 
-Vier stacked PRs. Pas starten als 0.19 (of 0.18.1) op npm staat.
+Vier stacked PRs. 0.19.2 staat op npm. Hooks, repairs-subset en
+skills-manager v2 UI zijn al op `main` (#12). Op `feat/complete-wishcraft-backlog`
+(reopen #13) landen nu de unieke 0.20-expansies bovenop CHE-42 (#19):
+`/powerline doctor` + `export`, queue-archive + retention (P1 single-clock),
+`customItems.auto`, fleet-SSH `openPorts.host`, what's-new welcome widget,
+cost-alert, bash editor-history split, `docs/` guides, custom-preset builder in
+Configure. Nog open: token-overlays, rest-repairs, README-hookvoorbeelden.
 
 Overlay-chrome kit, één keer, daarna hergebruiken: box + ronde hoeken,
 accent-kop, dim metadata, rechts uitgelijnde counts, `→` detail /
@@ -216,15 +221,13 @@ zijn eigen schema's.
 Done: pure `repairToolInput(tool, input)` + table-driven tests voor
 de zes gevallen + de parse-vóór-wrap invariant.
 
-### PR G — overlay-submenus (CHE-42)
+### PR G — overlay-submenus (CHE-42) — ✅ #19 + expansion (#13 reopen)
 
 Het `alt+p`-menu krijgt gestapelde `SelectList`-overlays (pijltjes +
 descriptions) in plaats van platte `ctx.ui.select`. Max drie
-top-level ingangen. Pure functie `buildPowerlineMenuItems`
-unit-testen. Sluit CHE-42. CHE-40 (`/powerline <tab>` subcommands)
-blijft open — 0.18 shipped alleen bash token-step, niet deze
-hiërarchie. Landt in 0.19 PR B of een kleine follow-up. CHE-41
-wordt de per-segment detail view in 1.0, geen tweede `alt+i`-pad.
+top-level ingangen. #19 landt de top-level boom (Navigate / Configure /
+Status). Configure gebruikt nu `showSelectOverlay` (CHE-42 rest). CHE-40
+is Done (#18). CHE-41 is 1.0 per-segment detail, geen tweede `alt+i`-pad.
 
 ### PR H — skills manager v2 UI + token-overlays
 
@@ -301,11 +304,11 @@ Pas na 0.20. Geen parallelle 1.0-tak.
 
 | Ticket | Actie |
 |---|---|
-| GRO-1060 fork cleanup | Deels gedaan (tags). Rest = PR A debris + concept-png. CHANGELOG niet inkorten. Versie niet resetten. |
+| GRO-1060 fork cleanup | Done. Release-pad bewezen. CHANGELOG niet inkorten. Versie niet resetten. `banner.png` blijft. |
 | GRO-1061 CI queue | Ops, niet deze roadmap. |
-| CHE-40 `/powerline` tab | In Progress. `/powerline` tab completes presets and placement above, below, or toggle. |
-| CHE-41 alt+i info | Wordt 1.0 detail-view. Ticket hernoemen of GRO-child. |
-| CHE-42 drill-down | = 0.20 PR G. Hernoemen naar wishcraft / GRO. |
+| CHE-40 `/powerline` tab | Done (#18 / 0.19.2). |
+| CHE-41 per-segment detail | 1.0. Ticket hernoemd; geen tweede `alt+i`-pad. |
+| CHE-42 drill-down | In Progress. #19 = drie top-level overlays + Status. Configure-overlay volgt. |
 
 Oude `pi-powerline-footer`-projecttickets niet laten staan alsof
 die package nog leeft.
@@ -333,8 +336,8 @@ die package nog leeft.
 - `npm deprecate` van de oude naam faalt tot de scope-owner het
   token verruimt. Gebruikers die `pi-powerline-footer` installeren
   blijven op 0.17.2.
-- Hooks spawnen processen. Default timeout 30s; kill-switch moet
-  in 0.20 vanaf dag één bestaan.
+- Hooks spawnen processen. Default timeout 30s; kill-switch
+  `wishcraft.hooksEnabled` bestaat al op `main`.
 - Repairs op core-tools raken we niet aan. Als DeepSeek-achtige
   modellen daar alsnog op stuklopen, is dat een gesprek met pi
   core, geen stille override.
@@ -369,8 +372,9 @@ die package nog leeft.
       Verify-trio groen. (#12)
 - [x] Gallery-contract gemerged (`chore/pi-dev-gallery`): keywords,
       `publishConfig.access`, `pi.image`, `npm run verify:package`. (#11)
-- [x] PR C: merge to `main` tagged `v0.19.0` then `v0.19.1` and published
-      (`npm view` = `0.19.1`). Same-job bump publish via #16.
-- [ ] README skills-sectie waar; deze ROADMAP in sync.
-- [ ] CHE-40: `/powerline` subcommand-tab landt (deze branch) of blijft een
-      open GRO-child. CHE-41/42 hernoemen.
+- [x] PR C: merge to `main` tagged `v0.19.0` then `v0.19.1` then
+      `v0.19.2` and published (`npm view` = `0.19.2`). Same-job bump
+      publish via #16. CHE-40 tab-complete via #18.
+- [x] README skills-sectie waar; deze ROADMAP in sync met 0.19.2.
+- [x] CHE-40: `/powerline` subcommand-tab geland (#18). CHE-41/42
+      hernoemd naar wishcraft.

package/bash-mode/editor-ghost.ts

@@ -38,3 +38,66 @@ export function overlayGhostSuggestion(
   next[contentLine] = `${text}${cursorBlock}${ghostText}${padding}`;
   return next;
 }
+
+/**
+ * Insert the full ghost suggestion when the cursor sits at the end of a
+ * single-line buffer that is a strict prefix of the ghost. Returns true when
+ * the suggestion was accepted.
+ */
+export function acceptGhostSuggestion(editor: any): boolean {
+  const ghost = Reflect.get(editor, "ghost") as GhostSuggestion | null;
+  if (!ghost) return false;
+
+  const text = editor.getExpandedText();
+  if (text.includes("\n")) return false;
+
+  const cursor = editor.getCursor();
+  if (cursor.line !== 0 || cursor.col !== text.length) return false;
+
+  if (!ghost.value.startsWith(text) || ghost.value === text) return false;
+  editor.setText(ghost.value);
+  editor.clearGhostSuggestion();
+  return true;
+}
+
+/**
+ * Advance the buffer by exactly one token/segment toward the active ghost
+ * suggestion (the next whitespace-delimited chunk). Repeated Tabs step through
+ * the rest of the suggestion one token at a time instead of inserting the whole
+ * line at once. The ghost stays live after a partial step so the next Tab
+ * continues from where it left off, and it is only cleared once the full
+ * suggestion has been inserted.
+ */
+export function completeGhostSuggestionOneToken(editor: any): boolean {
+  const ghost = Reflect.get(editor, "ghost") as GhostSuggestion | null;
+  if (!ghost) return false;
+
+  const text = editor.getExpandedText();
+  if (text.includes("\n")) return false;
+
+  const cursor = editor.getCursor();
+  if (cursor.line !== 0 || cursor.col !== text.length) return false;
+
+  const value = ghost.value;
+  if (!value.startsWith(text) || value === text) return false;
+
+  // Next chunk = leading whitespace (when the current token is complete) plus
+  // the next whitespace-delimited token from the projected ghost value.
+  const rest = value.slice(text.length);
+  const nextChunk = rest.match(/^\s*\S*/)?.[0];
+  if (!nextChunk) return false;
+
+  const next = text + nextChunk;
+  editor.setText(next);
+
+  if (value === next) {
+    // The full ghost suggestion is now in the buffer; nothing is left to step.
+    editor.clearGhostSuggestion();
+  } else if (value.startsWith(next)) {
+    // Re-resolve against the updated buffer rather than reusing a stale ghost.
+    editor.scheduleGhostUpdate();
+  } else {
+    editor.clearGhostSuggestion();
+  }
+  return true;
+}

package/bash-mode/editor-history.ts

@@ -0,0 +1,81 @@
+/**
+ * History navigation for `BashModeEditor`.
+ *
+ * These helpers operate on the editor instance through its public methods plus
+ * `Reflect`-based access to fields that are private on the editor class. This
+ * mirrors the existing `resetShellHistoryBrowse` convention in `editor-input.ts`
+ * and keeps the main editor class under the module-size ceiling.
+ */
+
+/** Whether pressing ↑ in non-bash mode should recall the previous prompt. */
+export function isPromptHistoryRecallPosition(editor: any): boolean {
+  if (editor.isShowingAutocomplete()) return false;
+
+  const history = Reflect.get(editor, "history");
+  if (!Array.isArray(history) || history.length === 0) return false;
+
+  const lines = editor.getLines();
+  const cursor = editor.getCursor();
+  if (lines.length === 1) {
+    return cursor.line === 0 && cursor.col === (lines[0]?.length ?? 0);
+  }
+
+  const isOnFirstVisualLine = Reflect.get(editor, "isOnFirstVisualLine");
+  if (
+    typeof isOnFirstVisualLine === "function" &&
+    !isOnFirstVisualLine.call(editor)
+  ) {
+    return false;
+  }
+
+  return cursor.line === 0;
+}
+
+/**
+ * Step through the shell history list in bash mode. `direction` is -1 (older,
+ * i.e. cursor-up) or +1 (newer, i.e. cursor-down). The first step snapshots the
+ * current draft and loads matching history entries; returning past the newest
+ * entry restores that draft.
+ */
+export function navigateShellHistory(
+  editor: any,
+  direction: -1 | 1,
+): void {
+  const optionsRef = Reflect.get(editor, "optionsRef");
+  let index = Reflect.get(editor, "shellHistoryIndex") as number;
+  let items = Reflect.get(editor, "shellHistoryItems") as string[];
+  let draft = Reflect.get(editor, "shellHistoryDraft") as string;
+
+  const prefix = draft || editor.getExpandedText();
+  if (index === -1) {
+    draft = prefix;
+    items = optionsRef.getHistoryEntries(prefix);
+  }
+
+  if (items.length === 0) {
+    Reflect.set(editor, "shellHistoryIndex", index);
+    Reflect.set(editor, "shellHistoryItems", items);
+    Reflect.set(editor, "shellHistoryDraft", draft);
+    optionsRef.onNotify("No shell history matches", "info");
+    return;
+  }
+
+  if (direction < 0) {
+    index = Math.min(items.length - 1, index + 1);
+  } else {
+    index -= 1;
+  }
+
+  if (index < 0) {
+    index = -1;
+    editor.setText(draft);
+    editor.scheduleGhostUpdate();
+  } else {
+    editor.setText(items[index] ?? draft);
+    editor.clearGhostSuggestion();
+  }
+
+  Reflect.set(editor, "shellHistoryIndex", index);
+  Reflect.set(editor, "shellHistoryItems", items);
+  Reflect.set(editor, "shellHistoryDraft", draft);
+}

package/bash-mode/editor-input.ts

@@ -78,3 +78,38 @@ export function resetShellHistoryBrowse(state: object): void {
   Reflect.set(state, "shellHistoryItems", []);
   Reflect.set(state, "shellHistoryDraft", "");
 }
+
+/**
+ * Move the editor cursor to the first or last visual line/column. Reads and
+ * writes the editor's internal cursor state through `Reflect` so the helper can
+ * live outside the editor class without widening its private surface.
+ */
+export function moveCursorToEditorBoundary(
+  editor: any,
+  position: "start" | "end",
+): void {
+  const state = Reflect.get(editor, "state");
+  const lines =
+    state && typeof state === "object" ? Reflect.get(state, "lines") : null;
+  if (!Array.isArray(lines)) {
+    throw new Error("Editor cursor state is unavailable");
+  }
+
+  if (position === "start") {
+    Reflect.set(state, "cursorLine", 0);
+    Reflect.set(state, "cursorCol", 0);
+  } else {
+    const lastLine = Math.max(0, lines.length - 1);
+    Reflect.set(state, "cursorLine", lastLine);
+    Reflect.set(
+      state,
+      "cursorCol",
+      typeof lines[lastLine] === "string" ? lines[lastLine].length : 0,
+    );
+  }
+
+  Reflect.set(editor, "lastAction", null);
+  Reflect.set(editor, "preferredVisualCol", null);
+  Reflect.set(editor, "snappedFromCursorCol", null);
+  editor.tui.requestRender();
+}

package/bash-mode/editor.ts

@@ -14,9 +14,18 @@ import {
   droppedPathTextFromInput,
   isCommandUndoShortcut,
   isPrintableInput,
+  moveCursorToEditorBoundary as moveCursorToEditorBoundaryImpl,
   resetShellHistoryBrowse,
 } from "./editor-input.ts";
-import { overlayGhostSuggestion } from "./editor-ghost.ts";
+import {
+  acceptGhostSuggestion as acceptGhostSuggestionImpl,
+  completeGhostSuggestionOneToken as completeGhostSuggestionOneTokenImpl,
+  overlayGhostSuggestion,
+} from "./editor-ghost.ts";
+import {
+  isPromptHistoryRecallPosition as isPromptHistoryRecallPositionImpl,
+  navigateShellHistory as navigateShellHistoryImpl,
+} from "./editor-history.ts";
 import type {
   BashModeEditorOptions,
   GhostSuggestion,
@@ -301,155 +310,28 @@ export class BashModeEditor extends CustomEditor {
     return (
       this.optionsRef.isBashModeActive() || this.isOneOffBashCommandContext()
     );
-  }
-
-  private isOneOffBashCommandContext(): boolean {
+  }  private isOneOffBashCommandContext(): boolean {
     return getOneOffBashCommandContext(this.getExpandedText()) !== null;
   }
 
   private moveCursorToEditorBoundary(position: "start" | "end"): void {
-    const state = Reflect.get(this, "state");
-    const lines =
-      state && typeof state === "object" ? Reflect.get(state, "lines") : null;
-    if (!Array.isArray(lines)) {
-      throw new Error("Editor cursor state is unavailable");
-    }
-
-    if (position === "start") {
-      Reflect.set(state, "cursorLine", 0);
-      Reflect.set(state, "cursorCol", 0);
-    } else {
-      const lastLine = Math.max(0, lines.length - 1);
-      Reflect.set(state, "cursorLine", lastLine);
-      Reflect.set(
-        state,
-        "cursorCol",
-        typeof lines[lastLine] === "string" ? lines[lastLine].length : 0,
-      );
-    }
-
-    Reflect.set(this, "lastAction", null);
-    Reflect.set(this, "preferredVisualCol", null);
-    Reflect.set(this, "snappedFromCursorCol", null);
-    this.tui.requestRender();
+    moveCursorToEditorBoundaryImpl(this, position);
   }
 
   private acceptGhostSuggestion(): boolean {
-    if (!this.ghost) return false;
-    const text = this.getExpandedText();
-    if (text.includes("\n")) return false;
-
-    const cursor = this.getCursor();
-    if (cursor.line !== 0 || cursor.col !== text.length) return false;
-
-    if (!this.ghost.value.startsWith(text) || this.ghost.value === text)
-      return false;
-    this.setText(this.ghost.value);
-    this.clearGhostSuggestion();
-    return true;
+    return acceptGhostSuggestionImpl(this);
   }
 
-  /**
-   * Advance the buffer by exactly one token/segment toward the active ghost
-   * suggestion (the next whitespace-delimited chunk). Repeated Tabs step
-   * through the rest of the suggestion one token at a time instead of
-   * inserting the whole line at once. The ghost stays live after a partial
-   * step so the next Tab continues from where it left off, and it is only
-   * cleared once the full suggestion has been inserted.
-   */
   private completeGhostSuggestionOneToken(): boolean {
-    if (!this.ghost) return false;
-    const text = this.getExpandedText();
-    if (text.includes("\n")) return false;
-
-    const cursor = this.getCursor();
-    if (cursor.line !== 0 || cursor.col !== text.length) return false;
-
-    const value = this.ghost.value;
-    if (!value.startsWith(text) || value === text) return false;
-
-    // Next chunk = leading whitespace (when the current token is complete)
-    // plus the next whitespace-delimited token from the projected ghost value.
-    const rest = value.slice(text.length);
-    const nextChunk = rest.match(/^\s*\S*/)?.[0];
-    if (!nextChunk) return false;
-
-    const next = text + nextChunk;
-    this.setText(next);
-
-    if (value === next) {
-      // The full ghost suggestion is now in the buffer; nothing is left to
-      // step through.
-      this.clearGhostSuggestion();
-    } else if (value.startsWith(next)) {
-      // Re-resolve against the updated buffer rather than reusing a stale ghost.
-      this.scheduleGhostUpdate();
-    } else {
-      this.clearGhostSuggestion();
-    }
-    return true;
+    return completeGhostSuggestionOneTokenImpl(this);
   }
 
   private isPromptHistoryRecallPosition(): boolean {
-    if (this.isShowingAutocomplete()) return false;
-
-    const history = Reflect.get(this, "history");
-    if (!Array.isArray(history) || history.length === 0) return false;
-
-    const lines = this.getLines();
-    const cursor = this.getCursor();
-    if (lines.length === 1) {
-      return cursor.line === 0 && cursor.col === (lines[0]?.length ?? 0);
-    }
-
-    const isOnFirstVisualLine = Reflect.get(this, "isOnFirstVisualLine");
-    if (
-      typeof isOnFirstVisualLine === "function" &&
-      !isOnFirstVisualLine.call(this)
-    ) {
-      return false;
-    }
-
-    return cursor.line === 0;
+    return isPromptHistoryRecallPositionImpl(this);
   }
 
   private navigateShellHistory(direction: -1 | 1): void {
-    const prefix = this.shellHistoryDraft || this.getExpandedText();
-    if (this.shellHistoryIndex === -1) {
-      this.shellHistoryDraft = prefix;
-      this.shellHistoryItems = this.optionsRef.getHistoryEntries(prefix);
-    }
-
-    if (this.shellHistoryItems.length === 0) {
-      this.optionsRef.onNotify("No shell history matches", "info");
-      return;
-    }
-
-    if (direction < 0) {
-      this.shellHistoryIndex = Math.min(
-        this.shellHistoryItems.length - 1,
-        this.shellHistoryIndex + 1,
-      );
-      this.setText(
-        this.shellHistoryItems[this.shellHistoryIndex] ??
-          this.shellHistoryDraft,
-      );
-      this.clearGhostSuggestion();
-      return;
-    }
-
-    this.shellHistoryIndex -= 1;
-    if (this.shellHistoryIndex < 0) {
-      this.shellHistoryIndex = -1;
-      this.setText(this.shellHistoryDraft);
-      this.scheduleGhostUpdate();
-      return;
-    }
-
-    this.setText(
-      this.shellHistoryItems[this.shellHistoryIndex] ?? this.shellHistoryDraft,
-    );
-    this.clearGhostSuggestion();
+    navigateShellHistoryImpl(this, direction);
   }
 
   private scheduleGhostUpdate(): void {

package/bash-mode/shell-session.ts

@@ -1,4 +1,4 @@
-import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { mkdtempSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { basename, join } from "node:path";
 import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
@@ -87,6 +87,7 @@ print -r -- "${READY_SENTINEL}:$PWD"
 
 export class ManagedShellSession {
   private readonly shellPath: string;
+  private readonly initScript: string | null;
   private readonly transcript: BashTranscriptStore;
   private readonly onStateChange: () => void;
   private readonly onCommandSuccess: (command: string, cwd: string) => void;
@@ -107,8 +108,10 @@ export class ManagedShellSession {
     transcript: BashTranscriptStore,
     onStateChange: () => void,
     onCommandSuccess: (command: string, cwd: string) => void,
+    initScript: string | null = null,
   ) {
     this.shellPath = shellPath;
+    this.initScript = initScript;
     this.transcript = transcript;
     this.onStateChange = onStateChange;
     this.onCommandSuccess = onCommandSuccess;
@@ -174,7 +177,12 @@ export class ManagedShellSession {
       this.onStateChange();
     });
 
-    this.sendRaw(getShellInitScript(this.state.shellName) + "\n");
+    const projectInit = this.initScript
+      ? this.initScript.endsWith("\n")
+        ? this.initScript
+        : `${this.initScript}\n`
+      : "";
+    this.sendRaw(projectInit + getShellInitScript(this.state.shellName) + "\n");
     return this.readyPromise;
   }
 
@@ -214,11 +222,6 @@ export class ManagedShellSession {
     this.readyPromise = null;
     this.readyResolve = null;
     this.readyReject = null;
-    try {
-      rmSync(this.tempDir, { recursive: true, force: true });
-    } catch {
-      // tempdir opruimen is best-effort
-    }
     if (!this.process) return;
     try {
       process.kill(-this.process.pid!, "SIGKILL");
@@ -257,10 +260,7 @@ export class ManagedShellSession {
       }
 
       if (line.startsWith(`${COMMAND_START_SENTINEL}:`)) {
-        // cwd kan zelf ':' bevatten: alles na het tweede veld is cwd
-        const parts = line.split(":");
-        const id = parts[1];
-        const cwd = parts.slice(2).join(":");
+        const [, id, cwd] = line.split(":");
         if (cwd) this.state.cwd = cwd;
         this.currentCommandId = id ?? this.currentCommandId;
         this.onStateChange();
@@ -268,10 +268,7 @@ export class ManagedShellSession {
       }
 
       if (line.startsWith(`${COMMAND_DONE_SENTINEL}:`)) {
-        const parts = line.split(":");
-        const id = parts[1];
-        const exitCodeText = parts[2];
-        const cwd = parts.slice(3).join(":");
+        const [, id, exitCodeText, cwd] = line.split(":");
         const exitCode = Number.parseInt(exitCodeText ?? "1", 10);
         this.state.running = false;
         this.state.lastExitCode = Number.isFinite(exitCode) ? exitCode : 1;

package/bash-mode/types.ts

@@ -6,6 +6,8 @@ export interface BashModeSettings {
   toggleShortcut: string | null;
   transcriptMaxLines: number;
   transcriptMaxBytes: number;
+  /** Shell commands sourced once when the managed shell starts (project-scoped init). */
+  initScript: string | null;
 }
 
 export interface BashCommandRecord {