pi-jev-auto-mode 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.5.0 - 2026-09-24
+
+- **Decision records are compact by default.** An approval is drawn as one line — status, tool,
+  latency, and the command — and a block as two, keeping the rationale. Each record used to take
+  five padded blocks, so a long session was mostly gate records. `/jev-auto-mode display full`
+  (or `"display": "full"`) restores the previous view, and the expanded view shows every detail
+  in either mode.
+
 ## 0.4.1 - 2026-09-18
 
 - **An unclear answer passes by default.** `uncertain` defaulted to `deny`, which meant a

package/README.md

@@ -113,8 +113,14 @@ Packages are discovered in the [package gallery](https://pi.dev/packages) throug
 /jev-auto-mode uncertain                show what the middle band resolves to
 /jev-auto-mode uncertain deny|ask|allow
 /jev-auto-mode scope all|matched        how far the semantic layer reaches
+/jev-auto-mode display full|compact     how decision records are drawn
 ```
 
+Each decision leaves a record in the transcript. `display: "compact"` (the default) folds an
+approval into one line and a block into two (the rationale stays, because a block is something
+to act on). `display: "full"` shows the heading, the engine line, the command, the reasons, and
+the rationale. The expanded view shows every detail in either mode.
+
 ```
 pi --jev-auto-mode        start with auto mode enabled
 ```
@@ -195,6 +201,7 @@ Policy notes: `$PI_CODING_AGENT_DIR/jev-auto-mode-policy.md`.
   "maxStateCharacters": 120000,
   "uncertain": "deny",
   "gateScope": "all",
+  "display": "compact",
   "thresholds": {}
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-jev-auto-mode",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Jev (TypeSafe System One) backed auto mode for the Pi coding agent: semantically auto-approves bash, write, and edit tool calls and fails closed when a decision cannot be made.",
   "keywords": [
     "pi-package",

package/src/extension.ts

@@ -55,6 +55,7 @@ import {
 import {
   DEFAULT_SETTINGS,
   JevAutoModeStore,
+  isDisplayMode,
   isGateScope,
   isUncertainAction,
   parseThreshold,
@@ -64,6 +65,7 @@ import {
 import {
   buildConfirmationDialog,
   describeSettings,
+  DISPLAY_EXPLANATION,
   GATE_SCOPE_EXPLANATION,
   UNCERTAIN_EXPLANATION,
   formatRuleTable,
@@ -571,7 +573,7 @@ export function register(pi: ExtensionAPI, options: RegisterOptions = {}): void
     default: false,
   });
 
-  registerDecisionEntryRenderer(pi);
+  registerDecisionEntryRenderer(pi, () => state.settings.display);
 
   pi.registerCommand(AUTO_MODE_COMMAND, {
     description: "Show or change the Jev auto mode settings",
@@ -579,7 +581,7 @@ export function register(pi: ExtensionAPI, options: RegisterOptions = {}): void
       const value = String(argumentPrefix ?? "");
       const tokens = value.split(/\s+/).filter(Boolean);
       if (tokens.length === 0) {
-        return ["status", "on", "off", "policy", "threshold", "scope", "uncertain", "login", "logout"].map((item) => ({
+        return ["status", "on", "off", "policy", "threshold", "scope", "uncertain", "display", "login", "logout"].map((item) => ({
           value: item,
           label: item,
         }));
@@ -756,6 +758,23 @@ export function register(pi: ExtensionAPI, options: RegisterOptions = {}): void
         return;
       }
 
+      if (value.startsWith("display")) {
+        const argument = value.slice("display".length).trim();
+        if (argument === "") {
+          ctx.ui.notify(`display: ${state.settings.display}\n\n${DISPLAY_EXPLANATION}`, "info");
+          return;
+        }
+        if (!isDisplayMode(argument)) {
+          ctx.ui.notify(`Expected one of full, compact.\n\n${DISPLAY_EXPLANATION}`, "error");
+          return;
+        }
+
+        state.settings = { ...state.settings, display: argument };
+        await save(gateContext);
+        ctx.ui.notify(`decision records now display as: ${argument}`, "info");
+        return;
+      }
+
       if (value.startsWith("uncertain")) {
         const argument = value.slice("uncertain".length).trim();
         if (argument === "") {

package/src/records.ts

@@ -6,10 +6,11 @@
  * recorded rationale should not become ammunition for the next tool call.
  */
 
-import { Box, Text } from "@earendil-works/pi-tui";
+import { Box, Text, truncateToWidth, type Component } from "@earendil-works/pi-tui";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { ConditionReport, DecisionSource } from "./decide.ts";
 import { formatThreshold } from "./jev/decide.ts";
+import type { DisplayMode } from "./settings.ts";
 
 export const DECISION_ENTRY_TYPE = "jev-auto-mode-decision";
 
@@ -85,12 +86,77 @@ export function formatConditionLines(record: DecisionRecord): string[] {
   });
 }
 
-export function registerDecisionEntryRenderer(pi: Pick<ExtensionAPI, "registerEntryRenderer">): void {
+/** Collapse whitespace so a multi-line command reads as one line. */
+function oneLine(text: string): string {
+  return text.replace(/\s+/g, " ").trim();
+}
+
+export interface CompactDecisionLines {
+  /** `🛡 jev allowed · bash · 299ms · <command>`: everything an approval needs. */
+  readonly headline: string;
+  /**
+   * The rationale, only for a call that did not run. An approval does not need its
+   * reasoning on screen; a block does, because the user has to act on it.
+   */
+  readonly detail?: string;
+}
+
+/**
+ * The compact view: one line for an approval, two for a block.
+ *
+ * Width is applied at render time. This only decides what the lines say.
+ */
+export function formatCompactLines(record: DecisionRecord): CompactDecisionLines {
+  const approved = record.status === "allowed" || record.status === "confirmed";
+  const parts = [`${approved ? "🛡" : "⛔"} jev ${STATUS_LABEL[record.status]}`, record.tool];
+  if (!approved) parts.push(`via ${record.source}`);
+  if (typeof record.latencyMs === "number") parts.push(`${Math.round(record.latencyMs)}ms`);
+  const summary = oneLine(record.summary);
+  if (summary.length > 0) parts.push(summary);
+  const headline = parts.join(" · ");
+  if (approved) return { headline };
+  return { headline, detail: oneLine(record.rationale) };
+}
+
+/** A single line clipped to the viewport instead of wrapped. */
+class ClippedLine implements Component {
+  private readonly text: string;
+
+  constructor(text: string) {
+    this.text = text;
+  }
+
+  render(width: number): string[] {
+    return [truncateToWidth(this.text, Math.max(1, width))];
+  }
+
+  invalidate(): void {}
+}
+
+export type DisplayModeSource = () => DisplayMode;
+
+export function registerDecisionEntryRenderer(
+  pi: Pick<ExtensionAPI, "registerEntryRenderer">,
+  displayMode: DisplayModeSource = () => "compact",
+): void {
   pi.registerEntryRenderer<DecisionRecord>(DECISION_ENTRY_TYPE, (entry, options, theme) => {
     const record = entry.data;
     if (!record) return undefined;
 
     const approved = record.status === "allowed" || record.status === "confirmed";
+
+    // The expanded view is the place to read a decision in full, so it ignores the
+    // compact setting.
+    if (displayMode() === "compact" && !options.expanded) {
+      const lines = formatCompactLines(record);
+      const box = new Box(1, 0, (text) => theme.bg("customMessageBg", text));
+      box.addChild(new ClippedLine(theme.fg(approved ? "muted" : "error", lines.headline)));
+      if (lines.detail !== undefined) {
+        box.addChild(new ClippedLine(theme.fg("dim", `rationale: ${lines.detail}`)));
+      }
+      return box;
+    }
+
     const icon = approved ? "🛡" : "⛔";
     const heading = `${icon} ${theme.bold("jev auto mode")} ${theme.fg(
       approved ? "success" : "error",

package/src/settings.ts

@@ -45,6 +45,23 @@ export interface JevAutoModeSettings {
    * visible in `/jev-auto-mode threshold` instead of silently resetting the rule.
    */
   readonly thresholds: Readonly<Record<string, number>>;
+  /**
+   * How decision records are drawn in the transcript.
+   *
+   * `compact` (the default) folds an approval into one line and a block into two, so
+   * a long session is not dominated by gate records. `full` shows the heading, the
+   * engine line, the command, the reasons, and the rationale. The expanded view (the tool
+   * expansion key) always shows every detail, whichever mode is set.
+   */
+  readonly display: DisplayMode;
+}
+
+export type DisplayMode = "full" | "compact";
+
+export const DISPLAY_MODES: readonly DisplayMode[] = ["full", "compact"];
+
+export function isDisplayMode(value: unknown): value is DisplayMode {
+  return typeof value === "string" && DISPLAY_MODES.includes(value as DisplayMode);
 }
 
 export type SettingsScope = "global" | "project";
@@ -90,6 +107,7 @@ export const DEFAULT_SETTINGS: JevAutoModeSettings = {
   uncertain: "allow",
   gateScope: "all",
   thresholds: {},
+  display: "compact",
 };
 
 const MAX_PATTERN_ENTRIES = 200;
@@ -193,6 +211,10 @@ export function parseSettingsPatch(value: unknown): SettingsPatch {
     patch.gateScope = record.gateScope;
   }
 
+  if (record.display !== undefined && isDisplayMode(record.display)) {
+    patch.display = record.display;
+  }
+
   const safeCommands = record.safeCommands === undefined ? undefined : readStringArray(record.safeCommands);
   if (safeCommands !== undefined) patch.safeCommands = safeCommands;
 

package/src/ui.ts

@@ -44,6 +44,7 @@ export function describeSettings(settings: JevAutoModeSettings, scope: SettingsS
     `max state characters: ${settings.maxStateCharacters}`,
     `uncertain band: ${settings.uncertain}`,
     `gate scope: ${settings.gateScope}`,
+    `display: ${settings.display}`,
   ].join("\n");
 }
 
@@ -149,6 +150,15 @@ export const USAGE_TEXT = [
   "  /jev-auto-mode uncertain            show what the middle band resolves to",
   "  /jev-auto-mode uncertain deny|ask|allow",
   "  /jev-auto-mode scope all|matched    which calls reach Jev",
+  "  /jev-auto-mode display full|compact how decision records are drawn",
+].join("\n");
+
+export const DISPLAY_EXPLANATION = [
+  "How decision records are drawn in the transcript.",
+  "  compact - one line for an approval, two for a block (with the rationale) (default).",
+  "  full    - heading, engine line, command, reasons, and rationale.",
+  "The expanded view always shows every detail. New records use the mode at once;",
+  "records already on screen switch when Pi redraws them (e.g. toggling expansion).",
 ].join("\n");
 
 export const GATE_SCOPE_EXPLANATION = [