@groeponline/pi-wishcraft 0.20.0 → 0.22.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [0.22.0] - 2026-08-20
+
+### Added
+- `/tps` overlay reads the same 1s/5s ring as the segment; `/usage` shows session / today / week from `wishcraft-usage.json`.
+- Rest of the tool-input repairs on custom tools: JSON-string arrays, `{}` placeholders, bare-string wrap, and path aliases.
+- README hook examples (bash-guard, write-audit, SessionStart git-status) plus `wishcraft.hooksEnabled` kill-switch docs.
+- Overlay type-to-filter uses substring on label, value, and description.
+- `wishcraft.tokenBudget.daily` colours the cost segment at 80%/100% and warns on welcome; it never blocks.
+
+## [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

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`.
@@ -246,6 +248,7 @@ Define your own preset in settings; it merges over built-ins and is selectable v
 Interactivity (Pi core renders the footer as static text, so live click is not possible; actions live in commands and a navigable overlay):
 
 - `/tps [value]`: show or set `POWERLINE_TPS`
+- `/usage`: today / week / session token overlay (same ledger as the cost segment)
 - `/open-ports`: list listening ports and pick one
 - `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
@@ -472,6 +475,86 @@ Browse and insert your installed skills (`SKILL.md` files and `*.md`/`*.txt` pro
 
 The manager reuses the same skill discovery as inline `/command`/`$skill` triggers, so anything you can inline you can also browse and insert manually.
 
+## Hooks (harness)
+
+Wishcraft can run Command Code-style hooks on Pi's native events (`tool_call`, `tool_result`, `session_start`, `turn_end`). Each hook is a command that reads JSON on stdin. Set `wishcraft.hooksEnabled` to `false` to kill-switch every hook without deleting the config. Hook *definitions* are read from the global agent settings file only (project `.pi/settings.json` cannot install new commands).
+
+Put the scripts somewhere executable (example: `~/.pi/agent/hooks/`) and point settings at them:
+
+```json
+{
+  "wishcraft": {
+    "hooksEnabled": true,
+    "hooks": {
+      "preToolUse": [
+        {
+          "matcher": "bash",
+          "hooks": [{ "command": "~/.pi/agent/hooks/bash-guard.sh", "timeout": 5 }]
+        }
+      ],
+      "postToolUse": [
+        {
+          "matcher": "write",
+          "hooks": [{ "command": "~/.pi/agent/hooks/write-audit.sh", "timeout": 5 }]
+        }
+      ],
+      "sessionStart": [
+        {
+          "hooks": [{ "command": "~/.pi/agent/hooks/session-git-status.sh", "timeout": 10 }]
+        }
+      ]
+    }
+  }
+}
+```
+
+**1. bash-guard** — deny `rm -rf /` (and close variants) before bash runs. Exit 2 is deny; the first stderr line or `permissionDecisionReason` is what the model sees.
+
+```bash
+#!/usr/bin/env bash
+# ~/.pi/agent/hooks/bash-guard.sh
+payload=$(cat)
+cmd=$(printf '%s' "$payload" | python3 -c 'import json,sys; print(json.load(sys.stdin).get("tool_input",{}).get("command",""))')
+if printf '%s' "$cmd" | grep -Eq '(^|[[:space:]])rm[[:space:]]+(-[a-zA-Z]*[[:space:]]+)*-r[a-zA-Z]*f|-fr[a-zA-Z]*|[[:space:]]/[[:space:]]*$'; then
+  printf '%s\n' '{"hookSpecificOutput":{"permissionDecision":"deny","permissionDecisionReason":"blocked destructive rm"}}'
+  echo "blocked destructive rm" >&2
+  exit 2
+fi
+exit 0
+```
+
+**2. write-audit** — append-only log of write tool calls (does not block).
+
+```bash
+#!/usr/bin/env bash
+# ~/.pi/agent/hooks/write-audit.sh
+mkdir -p "$HOME/.pi/agent/logs"
+printf '%s\n' "$(date -Is) $1" >> "$HOME/.pi/agent/logs/write-audit.jsonl"
+cat >> "$HOME/.pi/agent/logs/write-audit.jsonl"
+```
+
+The hook receives the JSON payload on stdin; the snippet above stores the raw event. Trim or jq-filter as you like.
+
+**3. SessionStart git-status** — inject `git status --short` as extra context at session start.
+
+```bash
+#!/usr/bin/env bash
+# ~/.pi/agent/hooks/session-git-status.sh
+status=$(git status --short 2>/dev/null | head -n 40)
+CTX="$status" python3 - <<'PY'
+import json, os
+print(json.dumps({
+  "hookSpecificOutput": {
+    "additionalContext": "git status:\n" + os.environ.get("CTX", "")
+  }
+}))
+PY
+```
+
+Tool-input repairs (custom/extension tools only) run before hooks: null-for-optional, JSON-string arrays, `{}` → `[]` on array keys, bare-string wrap, path aliases, and markdown auto-link unwrap. `/repairs` shows the counters. Core tools (`bash`, `read`, `edit`, `write`, `grep`, `find`, `ls`) are never rewritten.
+
+`wishcraft.tokenBudget.daily` (token count) paints the cost segment warning/red at 80%/100% and notifies on welcome. It never blocks a turn. `/usage` shows session / today / week from `~/.pi/agent/wishcraft-usage.json`. `/tps` with no args opens the live ring overlay (same sampler as the segment).
+
 ## Working Vibes
 
 Transform boring "Working..." messages into themed phrases that match your style:

package/ROADMAP.md

@@ -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.
 
@@ -89,10 +89,10 @@ Niet de fork. Niet de SaaS-agent.
   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.
+- **0.20.0–0.22 — "Harness"** (0.20.0 + 0.21.0 op npm; leftovers in GRO-1414).
+  Overlay-chrome + CHE-42 drill-down, Configure als SelectList, token-overlays,
+  rest-repairs, README-hooks. Done = drie README-hookvoorbeelden, repair-teller,
+  `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,
@@ -172,10 +172,9 @@ GRO-1061 (runner-queue) is ops, geen product-slice.
 
 ## 0.20.0 — Harness
 
-Vier stacked PRs. 0.19.2 staat op npm. Hooks, repairs-subset en
-skills-manager v2 UI zijn al op `main` (#12). Wat hier nog openstaat:
-overlay-chrome, CHE-42, Configure-submenu, token-overlays, rest-repairs,
-README-voorbeelden.
+Vier stacked PRs. 0.20.0 (#19) en 0.21.0 (#13) staan op npm. CHE-42
+Configure-overlay, doctor/export, queue-archive en `docs/` zijn geland.
+GRO-1414 sluit README-hooks, rest-repairs, `/tps`+`/usage`, substring-filter.
 
 Overlay-chrome kit, één keer, daarna hergebruiken: box + ronde hoeken,
 accent-kop, dim metadata, rechts uitgelijnde counts, `→` detail /
@@ -183,7 +182,7 @@ accent-kop, dim metadata, rechts uitgelijnde counts, `→` detail /
 skills v2; tweede = `/usage`; derde = queue/idea. Pure render-
 functies, geen `ctx.ui`-mock.
 
-### PR E — hooks — ✅ geland in `feat/wishcraft-0.19` (`src/extension/hooks/`, `/repairs` stats-command; README-voorbeelden volgen in de release-PR)
+### PR E — hooks — ✅ geland in `feat/wishcraft-0.19`; README-voorbeelden in GRO-1414
 
 Settings: `wishcraft.hooks` met events
 `preToolUse | postToolUse | sessionStart | turnEnd`. Per hook
@@ -198,7 +197,7 @@ Done: `parseHookOutput` unit-testen. README met drie werkende
 voorbeelden: bash-guard (`rm -rf /` blokkeren), write-audit
 (append-only log), SessionStart git-status injectie.
 
-### PR F — tool-input repairs — ✅ geland in `feat/wishcraft-0.19` (schema-loze subset: null-for-optional + auto-link unwrap; schema-afhankelijke repairs wachten op validator-issues in pi core)
+### PR F — tool-input repairs — ✅ schema-loze subset in 0.19; rest (JSON-array, `{}`, bare-wrap, path aliases) in GRO-1414. Core tools blijven met rust.
 
 `tool_call`-handler repareert bekende malformaties vóór executie
 (mutable input). Volgorde vast: json-parse vóór bare-wrap.
@@ -218,15 +217,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) — in #19
+### 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. #19 landt de top-level boom (Navigate / Configure /
-Status). Configure zelf blijft `ctx.ui.select` tot de volgende
-0.20-snede. CHE-40 is Done (#18). CHE-41 is 1.0 per-segment detail,
-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
 
@@ -307,7 +304,8 @@ Pas na 0.20. Geen parallelle 1.0-tak.
 | GRO-1061 CI queue | Ops, niet deze roadmap. |
 | 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. |
+| CHE-42 drill-down | Done (#19 + Configure in #13). |
+| GRO-1414 0.20 leftovers | In Progress. Hooks docs, rest-repairs, `/tps` `/usage`, substring filter. |
 
 Oude `pi-powerline-footer`-projecttickets niet laten staan alsof
 die package nog leeft.
@@ -330,8 +328,8 @@ die package nog leeft.
 
 ## Residual risks
 
-- `SelectList.setFilter` matcht alleen prefix op `value`. 0.19
-  accepteert dat; 0.20 vervangt het.
+- `SelectList.setFilter` matcht alleen prefix op `value`. Overlay-chrome
+  filtert zelf op substring (GRO-1414). Skills-manager had dat al.
 - `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.

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 {