@groeponline/pi-wishcraft 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [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

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`.

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.
 
@@ -173,9 +173,12 @@ 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.
+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 /
@@ -218,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) — 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
 

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 {

package/docs/bash-mode.md

@@ -0,0 +1,46 @@
+# Bash mode
+
+Toggle bash mode with either:
+
+- `ctrl+shift+b`
+- `/bash-mode on`
+- `/bash-mode off`
+- `/bash-mode toggle`
+
+Reset the managed shell with `/bash-reset`.
+
+While bash mode is active:
+
+- Enter runs the current shell command
+- Right Arrow accepts ghost text into the editor without running it
+- Tab completes the ghost suggestion one token/segment at a time (repeat Tab to step through each further token); once the full suggestion is inserted it clears, otherwise Tab does nothing
+- Up and Down browse matching shell history
+- `escape` exits bash mode and returns to normal prompt mode
+- `ctrl+c` interrupts the active shell job before falling back to normal pi behavior
+
+The managed shell is persistent for the current pi session. Command output appears in a transcript below the editor, and shell cwd changes are reflected in the footer path and `shell_mode` segment.
+
+## Shell ghost suggestions
+
+Bash mode is ghost-first. Successful per-project shell history is the primary source, while deterministic path and git continuations can still extend an existing command. Shell-native completion probes are disabled so `!command` predictions never spawn interactive shell completion subprocesses.
+
+At command position, short stems first resolve from the newest successful local command, can use guarded global shell history for high-confidence heads like `git`, and finally fall back to a tiny curated default set when history is absent. Right now that curated set is `g` → `git status` and `c` → `cd ..`.
+
+If the bash prompt is empty, bash mode shows the newest successful project-history ghost suggestion immediately when one exists, including right after mode entry or after the prompt is cleared again. One-off `!command` and `!!command` prompts reuse the same shell prediction pipeline, including ghost text. Right Arrow or Tab accepts ghost text into the editor, and Enter runs the current shell command. Mode entry stays quiet: there is no automatic or manual dropdown completion surface, and ghost suggestions do not run shell-native completion probes.
+
+## Configuration
+
+In `~/.pi/agent/settings.json` (or under `PI_CODING_AGENT_DIR` when that environment variable is set):
+
+```json
+{
+  "bashMode": {
+    "toggleShortcut": "ctrl+shift+b",
+    "transcriptMaxLines": 2000,
+    "transcriptMaxBytes": 524288,
+    "initScript": "export NODE_ENV=development\nalias g='git status'"
+  }
+}
+```
+
+`initScript` is a project-scoped shell setup block: it is sourced once when the managed shell starts (before your first command), so a repo can export env vars, define aliases, or set shell options per project. Put it in the project-local `.pi/settings.json` to keep it repo-specific; omit it (or use a global `bashMode` entry) otherwise.