@leo-alvarenga/pi-zen-frame 0.12.1 → 0.12.2

package/extensions/components/header.ts

@@ -143,7 +143,7 @@ export function createHeader(
 
       const rightW = inner - leftW - 1;
 
-      const rightLines = infoRows(env, rightW);
+      const rightLines = infoRows(env, rightW - 2);
       const leftLines = [
         ...logo.lines.map((l) => theme.fg(logo.color, l)),
 
@@ -152,7 +152,7 @@ export function createHeader(
 
         ...wrapLines(
           [settings.header?.heading ?? DEFAULT_SETTINGS.header?.heading ?? ""],
-          leftW,
+          leftW - 2,
         ).map((line) => theme.bold(theme.fg("muted", line))),
 
         "",
@@ -163,7 +163,7 @@ export function createHeader(
               DEFAULT_SETTINGS.header?.subheading ??
               "",
           ],
-          leftW,
+          leftW - 2,
         ).map((line) => theme.italic(theme.fg("muted", line))),
       ];
 

package/extensions/config/constants/contracts.ts

@@ -0,0 +1,12 @@
+/** External contract IDs: the zen-mode keybinding and the optional
+ *  pi-agent-manager integration (no hard dependency).
+ */
+/** pi-agent-manager integration (optional — no hard dependency). */
+export const PI_AGENT_MANAGER_AGENT_EVENT = "pi-agent-manager:agent-changed";
+export const PI_AGENT_MANAGER_AGENT_DATA_KEY = "pi-agent-manager-agent";
+
+/** Keybinding id users bind in keybindings.json to toggle zen mode. */
+export const ZEN_MODE_SHORTCUT_ID = "piZenFrame.zenMode";
+/** Default key when the user hasn't bound one (override or disable via
+ *  keybindings.json; `[]` disables the shortcut, `/zen_mode` still works). */
+export const ZEN_MODE_DEFAULT_KEY = "ctrl+shift+z";

package/extensions/config/constants/defaults.ts

@@ -0,0 +1,47 @@
+import type { Settings } from "../types";
+import { WORKING_MESSAGES } from "./messages";
+export const DEFAULT_SETTINGS: Settings = {
+  zenMode: false,
+  accentColor: "accent",
+
+  header: {
+    enable: false,
+    logoColor: "text",
+    accentColor: "accent",
+
+    heading: "Welcome back!",
+    subheading:
+      "Ready for your next session? Terminal warm, context clean, tools ready to execute",
+
+    logo: ["█████████  ", "███   ███  ", "██████     ", "███     ███"],
+  },
+
+  workingMessage: {
+    enable: true,
+    intervalMs: 3000,
+    messages: WORKING_MESSAGES,
+  },
+
+  frame: {
+    icons: {},
+    paddingX: 1,
+    enable: true,
+    minWidth: 20,
+    marginTop: 0,
+    showCwd: true,
+    paddingTop: 1,
+    marginBottom: 0,
+    showModel: true,
+    paddingBottom: 1,
+    showSpinner: false,
+    showContext: true,
+    showThinking: true,
+    showAgentMode: true,
+    borderColor: "text",
+
+    colors: {},
+    // ponytail: colors were dormant (nothing read them); now wired — keep
+    // defaults unset so segments keep their natural colors and zen-mode is
+    // the mute switch.
+  },
+};

package/extensions/config/constants/file.ts

@@ -0,0 +1,2 @@
+/** Config file name (in the pi agent dir) holding user settings. */
+export const CONFIG_FILE_NAME = "pi-zen-frame.json";

package/extensions/config/constants/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Constants, grouped by concern and re-exported from a single barrel.
+ * Import everything with `import { ... } from "../config/constants"` —
+ * resolution keeps working now that this is a directory.
+ */
+export * from "./file";
+export * from "./contracts";
+export * from "./visuals";
+export * from "./messages";
+export * from "./defaults";

package/extensions/config/constants/messages.ts

@@ -0,0 +1,176 @@
+import type { BannerTip } from "../types";
+export const WORKING_MESSAGES: string[] = [
+  "Exploring",
+  "Tinkering",
+  "Searching",
+  "Polishing",
+  "Herding",
+  "Consulting",
+  "Chasing",
+  "Rearranging",
+  "Sharpening",
+  "Reticulating",
+  "Warming",
+  "Feeding",
+  "Whispering",
+  "Counting",
+  "Dusting",
+  "Tightening",
+  "Watering",
+  "Aligning",
+  "Reading",
+  "Charging",
+  "Summoning",
+  "Calibrating",
+  "Sorting",
+  "Debating",
+  "Brewing",
+  "Stargazing",
+  "Walking",
+  "Folding",
+  "Rounding",
+  "Cooking",
+  "Crunching",
+  "Cogitating",
+  "Analyzing",
+  "Architecting",
+  "Assembling",
+  "Building",
+  "Calculating",
+  "Compiling",
+  "Composing",
+  "Crafting",
+  "Decoding",
+  "Designing",
+  "Drafting",
+  "Editing",
+  "Evaluating",
+  "Experimenting",
+  "Explaining",
+  "Extracting",
+  "Generating",
+  "Integrating",
+  "Iterating",
+  "Juggling",
+  "Mapping",
+  "Measuring",
+  "Merging",
+  "Modeling",
+  "Navigating",
+  "Optimizing",
+  "Organizing",
+  "Parsing",
+  "Planning",
+  "Pondering",
+  "Processing",
+  "Refactoring",
+  "Refining",
+  "Rendering",
+  "Resolving",
+  "Reviewing",
+  "Scanning",
+  "Sifting",
+  "Simulating",
+  "Streamlining",
+  "Structuring",
+  "Synthesizing",
+  "Testing",
+  "Tracing",
+  "Translating",
+  "Triaging",
+  "Unraveling",
+  "Validating",
+  "Verifying",
+  "Wrangling",
+];
+
+export const HEADER_TIPS: BannerTip[] = [
+  {
+    type: "Tip",
+    text: "Press Ctrl + G inside Pi's input box to open your default system $EDITOR (e.g., Neovim) for writing long, complex prompts",
+  },
+  {
+    type: "Did You Know?",
+    text: "Model reasoning quality degrades as the context window fills up. Use /compact or start fresh sessions once context exceeds 50–60%",
+  },
+  {
+    type: "Workflow",
+    text: "Isolate planning from execution: use a read-only profile for architectural planning and switch to full permissions only when building",
+  },
+  {
+    type: "Did You Know?",
+    text: "Modern models like Claude 3.5 and 3.7 process boundaries in XML tags (<context>, <rules>, <code_diff>) significantly better than raw Markdown dividers",
+  },
+  {
+    type: "Tip",
+    text: "Always truncate or filter large log outputs before handing them to an agent — a 10,000-line stack trace will immediately saturate your token cache",
+  },
+  {
+    type: "Tip",
+    text: "Export global environment variables (like $EDITOR and $VISUAL) in ~/.bashenv (or your shell's env file) so background subshells and GUI-spawned processes inherit them cleanly",
+  },
+  {
+    type: "Did You Know?",
+    text: "Smooth 80ms Braille sequences (⠋, ⠙, ⠹, ⠸) or quadrant block meters give immediate visual feedback without consuming much screen real estate",
+  },
+  {
+    type: "Prompting",
+    text: "Tell models what TO DO instead of what NOT to do—negative constraints like 'don't use markdown' are frequently ignored compared to positive instructions",
+  },
+  {
+    type: "Workflow",
+    text: "Use fuzzy file references by typing `@` in Pi's input box to quickly anchor specific codebase files directly into the prompt context",
+  },
+  {
+    type: "Tip",
+    text: "Place heavy longform context or data files near the top of your prompt and put your actual instructions or questions at the very end for better accuracy",
+  },
+  {
+    type: "Did You Know?",
+    text: "Pi saves session history as a tree. You can use `/tree` or `/fork` to branch off a previous point in a conversation to test an alternative approach",
+  },
+  {
+    type: "Prompting",
+    text: "Define specific output formats (e.g., JSON schemas or concise bullet points) upfront to prevent models from generating unnecessary verbose prose",
+  },
+  {
+    type: "Tip",
+    text: "Paste screenshots straight into the prompt with Ctrl+V (Alt+V on Windows) — models can see error dialogs, UIs, and graphs you can't describe in words",
+  },
+  {
+    type: "Tip",
+    text: "Type `@` to anchor files into the prompt — pi inlines the real contents, so the model reads your code, not your summary of it",
+  },
+  {
+    type: "Tip",
+    text: "Swap models mid-session with `/model` or Ctrl+L instead of restarting — you keep the conversation context, just change the brain",
+  },
+  {
+    type: "Did You Know?",
+    text: "Shift+Tab cycles through your recent models without opening the picker — fastest way to A/B two models on the same prompt",
+  },
+  {
+    type: "Workflow",
+    text: "Run `/compact` before starting a big new task: the conversation is summarized and you continue with a clean, cheap context",
+  },
+  {
+    type: "Workflow",
+    text: "Assign one agent mode per task phase — read-only for planning/research, full privileges only for execution — so a misfired tool call can't touch your repo",
+  },
+  {
+    type: "Prompting",
+    text: "Restate the single most important requirement in the *last* line of a long prompt — instructions given early fade as context grows",
+  },
+  {
+    type: "Prompting",
+    text: "Show, don't tell: paste the exact error text plus the file:line that produced it. Vague 'it's broken' prompts get shotgun fixes",
+  },
+  {
+    type: "Tip",
+    text: "Keep messages atomic — one question or one change per message. Mega-prompts amortize badly over a long session",
+  },
+  {
+    type: "Workflow",
+    text: "For multi-file changes, ask for a plan first (files touched + order) and approve it before any edits — cheap insurance against wrong-direction refactors",
+  },
+];

package/extensions/config/constants/visuals.ts

@@ -0,0 +1,84 @@
+import type { ThemeColor } from "@earendil-works/pi-coding-agent";
+import type { FrameIcons, SpinnerPhase } from "../types";
+/** Spinner animation frames per phase (pi-editor-shell style). */
+export const SPINNER_FRAMES: Record<SpinnerPhase, string[]> = {
+  idle: ["⠃", "⠞", "⡵", "⠿", "⢹", "⠄"],
+  outputting: ["⠋", "⠙", "⠸", "⠴", "⠦", "⠇", "⠏"],
+  thinking: ["󰌶", "󰌶", "󰌶", "󰌶", "󰌵", "󰌵", "󰌵", "󰌵"],
+  toolcall: ["●", "●", "●", "●", "○", "○", "○", "○"],
+  exec: ["⠂", "⠅", "⠍", "⠟", "⠿", "⠽", "⠿", "⠟", "⠍", "⠅", "⠂"],
+
+  // Sample ["░", "▒", "▓", "█", "▓", "▒"],
+};
+
+/** Nerd Font defaults (override any subset via `frame.icons`). */
+export const DEFAULT_ICONS: FrameIcons = {
+  model: "󰣖",
+  folder: " ",
+  context: "",
+  gitDirty: "",
+  thinking: "󰌶",
+  gitBranch: "",
+};
+
+/** Thinking level → theme token, mirroring pi's own border-color mapping. */
+export const THINKING_TOKEN: Record<string, string> = {
+  off: "thinkingOff",
+  minimal: "thinkingMinimal",
+  low: "thinkingLow",
+  medium: "thinkingMedium",
+  high: "thinkingHigh",
+  xhigh: "thinkingXhigh",
+  max: "thinkingMax",
+};
+
+
+export const THEME_COLORS: Record<ThemeColor, true> = {
+  accent: true,
+  border: true,
+  borderAccent: true,
+  borderMuted: true,
+  success: true,
+  error: true,
+  warning: true,
+  muted: true,
+  dim: true,
+  text: true,
+  searchMatchText: true,
+  thinkingText: true,
+  userMessageText: true,
+  customMessageText: true,
+  customMessageLabel: true,
+  toolTitle: true,
+  toolOutput: true,
+  mdHeading: true,
+  mdLink: true,
+  mdLinkUrl: true,
+  mdCode: true,
+  mdCodeBlock: true,
+  mdCodeBlockBorder: true,
+  mdQuote: true,
+  mdQuoteBorder: true,
+  mdHr: true,
+  mdListBullet: true,
+  toolDiffAdded: true,
+  toolDiffRemoved: true,
+  toolDiffContext: true,
+  syntaxComment: true,
+  syntaxKeyword: true,
+  syntaxFunction: true,
+  syntaxVariable: true,
+  syntaxString: true,
+  syntaxNumber: true,
+  syntaxType: true,
+  syntaxOperator: true,
+  syntaxPunctuation: true,
+  thinkingOff: true,
+  thinkingMinimal: true,
+  thinkingLow: true,
+  thinkingMedium: true,
+  thinkingHigh: true,
+  thinkingXhigh: true,
+  thinkingMax: true,
+  bashMode: true,
+};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@leo-alvarenga/pi-zen-frame",
   "description": "A pi-coding-agent extension that gives the TUI editor a simple yet polished look and feel",
   "author": "Leonardo A. Alvarenga",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "license": "MIT",
   "repository": "github.com/leo-alvarenga/pi-mono",
   "publishConfig": {

package/extensions/config/constants.ts

@@ -1,279 +0,0 @@
-import { ThemeColor } from "@earendil-works/pi-coding-agent";
-import type { BannerTip, FrameIcons, Settings, SpinnerPhase } from "./types";
-
-export const CONFIG_FILE_NAME = "pi-zen-frame.json";
-
-/** pi-agent-manager integration (optional — no hard dependency). */
-export const PI_AGENT_MANAGER_AGENT_EVENT = "pi-agent-manager:agent-changed";
-export const PI_AGENT_MANAGER_AGENT_DATA_KEY = "pi-agent-manager-agent";
-
-/** Keybinding id users bind in keybindings.json to toggle zen mode. */
-export const ZEN_MODE_SHORTCUT_ID = "piZenFrame.zenMode";
-/** Default key when the user hasn't bound one (override or disable via
- *  keybindings.json; `[]` disables the shortcut, `/zen_mode` still works). */
-export const ZEN_MODE_DEFAULT_KEY = "ctrl+shift+z";
-
-/** Spinner animation frames per phase (pi-editor-shell style). */
-export const SPINNER_FRAMES: Record<SpinnerPhase, string[]> = {
-  idle: ["⠃", "⠞", "⡵", "⠿", "⢹", "⠄"],
-  outputting: ["⠋", "⠙", "⠸", "⠴", "⠦", "⠇", "⠏"],
-  thinking: ["󰌶", "󰌶", "󰌶", "󰌶", "󰌵", "󰌵", "󰌵", "󰌵"],
-  toolcall: ["●", "●", "●", "●", "○", "○", "○", "○"],
-  exec: ["⠂", "⠅", "⠍", "⠟", "⠿", "⠽", "⠿", "⠟", "⠍", "⠅", "⠂"],
-
-  // Sample ["░", "▒", "▓", "█", "▓", "▒"],
-};
-
-/** Nerd Font defaults (override any subset via `frame.icons`). */
-export const DEFAULT_ICONS: FrameIcons = {
-  model: "󰣖",
-  folder: " ",
-  context: "",
-  gitDirty: "",
-  thinking: "󰌶",
-  gitBranch: "",
-};
-
-/** Thinking level → theme token, mirroring pi's own border-color mapping. */
-export const THINKING_TOKEN: Record<string, string> = {
-  off: "thinkingOff",
-  minimal: "thinkingMinimal",
-  low: "thinkingLow",
-  medium: "thinkingMedium",
-  high: "thinkingHigh",
-  xhigh: "thinkingXhigh",
-  max: "thinkingMax",
-};
-
-/** Rotating messages for the working loader (single-word verbs; some silly, some plausible). */
-export const WORKING_MESSAGES: string[] = [
-  "Exploring",
-  "Tinkering",
-  "Searching",
-  "Polishing",
-  "Herding",
-  "Consulting",
-  "Chasing",
-  "Rearranging",
-  "Sharpening",
-  "Reticulating",
-  "Warming",
-  "Feeding",
-  "Whispering",
-  "Counting",
-  "Dusting",
-  "Tightening",
-  "Watering",
-  "Aligning",
-  "Reading",
-  "Charging",
-  "Summoning",
-  "Calibrating",
-  "Sorting",
-  "Debating",
-  "Brewing",
-  "Stargazing",
-  "Walking",
-  "Folding",
-  "Rounding",
-  "Cooking",
-  "Crunching",
-  "Cogitating",
-  "Analyzing",
-  "Architecting",
-  "Assembling",
-  "Building",
-  "Calculating",
-  "Compiling",
-  "Composing",
-  "Crafting",
-  "Decoding",
-  "Designing",
-  "Drafting",
-  "Editing",
-  "Evaluating",
-  "Experimenting",
-  "Explaining",
-  "Extracting",
-  "Generating",
-  "Integrating",
-  "Iterating",
-  "Juggling",
-  "Mapping",
-  "Measuring",
-  "Merging",
-  "Modeling",
-  "Navigating",
-  "Optimizing",
-  "Organizing",
-  "Parsing",
-  "Planning",
-  "Pondering",
-  "Processing",
-  "Refactoring",
-  "Refining",
-  "Rendering",
-  "Resolving",
-  "Reviewing",
-  "Scanning",
-  "Sifting",
-  "Simulating",
-  "Streamlining",
-  "Structuring",
-  "Synthesizing",
-  "Testing",
-  "Tracing",
-  "Translating",
-  "Triaging",
-  "Unraveling",
-  "Validating",
-  "Verifying",
-  "Wrangling",
-];
-
-export const HEADER_TIPS: BannerTip[] = [
-  {
-    type: "Tip",
-    text: "Press Ctrl + G inside Pi's input box to open your default system $EDITOR (e.g., Neovim) for writing long, complex prompts",
-  },
-  {
-    type: "Did You Know?",
-    text: "Model reasoning quality degrades as the context window fills up. Use /compact or start fresh sessions once context exceeds 50–60%",
-  },
-  {
-    type: "Workflow",
-    text: "Isolate planning from execution: use a read-only profile for architectural planning and switch to full permissions only when building",
-  },
-  {
-    type: "Did You Know?",
-    text: "Modern models like Claude 3.5 and 3.7 process boundaries in XML tags (<context>, <rules>, <code_diff>) significantly better than raw Markdown dividers",
-  },
-  {
-    type: "Tip",
-    text: "Always truncate or filter large log outputs before handing them to an agent—a 10,000-line stack trace will immediately saturate your token cache",
-  },
-  {
-    type: "Tip",
-    text: "Export global environment variables (like $EDITOR and $VISUAL) in ~/.bashenv (or your shell's env file) so background subshells and GUI-spawned processes inherit them cleanly",
-  },
-  {
-    type: "Did You Know?",
-    text: "Smooth 80ms Braille sequences (⠋, ⠙, ⠹, ⠸) or quadrant block meters give immediate visual feedback without consuming much screen real estate",
-  },
-  {
-    type: "Prompting",
-    text: "Tell models what TO DO instead of what NOT to do—negative constraints like 'don't use markdown' are frequently ignored compared to positive instructions",
-  },
-  {
-    type: "Workflow",
-    text: "Use fuzzy file references by typing `@` in Pi's input box to quickly anchor specific codebase files directly into the prompt context",
-  },
-  {
-    type: "Tip",
-    text: "Place heavy longform context or data files near the top of your prompt and put your actual instructions or questions at the very end for better accuracy",
-  },
-  {
-    type: "Did You Know?",
-    text: "Pi saves session history as a tree. You can use `/tree` or `/fork` to branch off a previous point in a conversation to test an alternative approach",
-  },
-  {
-    type: "Prompting",
-    text: "Define specific output formats (e.g., JSON schemas or concise bullet points) upfront to prevent models from generating unnecessary verbose prose",
-  },
-];
-
-export const DEFAULT_SETTINGS: Settings = {
-  zenMode: false,
-  accentColor: "accent",
-
-  header: {
-    enable: false,
-    logoColor: "text",
-    accentColor: "accent",
-
-    heading: "Welcome back!",
-    subheading:
-      "Ready for your next session? Terminal warm, context clean, tools ready to execute",
-
-    logo: ["█████████  ", "███   ███  ", "██████     ", "███     ███"],
-  },
-
-  workingMessage: {
-    enable: true,
-    intervalMs: 3000,
-    messages: WORKING_MESSAGES,
-  },
-
-  frame: {
-    icons: {},
-    paddingX: 1,
-    enable: true,
-    minWidth: 20,
-    marginTop: 0,
-    showCwd: true,
-    paddingTop: 1,
-    marginBottom: 0,
-    showModel: true,
-    paddingBottom: 1,
-    showSpinner: false,
-    showContext: true,
-    showThinking: true,
-    showAgentMode: true,
-    borderColor: "text",
-
-    colors: {},
-    // ponytail: colors were dormant (nothing read them); now wired — keep
-    // defaults unset so segments keep their natural colors and zen-mode is
-    // the mute switch.
-  },
-};
-
-export const THEME_COLORS: Record<ThemeColor, true> = {
-  accent: true,
-  border: true,
-  borderAccent: true,
-  borderMuted: true,
-  success: true,
-  error: true,
-  warning: true,
-  muted: true,
-  dim: true,
-  text: true,
-  searchMatchText: true,
-  thinkingText: true,
-  userMessageText: true,
-  customMessageText: true,
-  customMessageLabel: true,
-  toolTitle: true,
-  toolOutput: true,
-  mdHeading: true,
-  mdLink: true,
-  mdLinkUrl: true,
-  mdCode: true,
-  mdCodeBlock: true,
-  mdCodeBlockBorder: true,
-  mdQuote: true,
-  mdQuoteBorder: true,
-  mdHr: true,
-  mdListBullet: true,
-  toolDiffAdded: true,
-  toolDiffRemoved: true,
-  toolDiffContext: true,
-  syntaxComment: true,
-  syntaxKeyword: true,
-  syntaxFunction: true,
-  syntaxVariable: true,
-  syntaxString: true,
-  syntaxNumber: true,
-  syntaxType: true,
-  syntaxOperator: true,
-  syntaxPunctuation: true,
-  thinkingOff: true,
-  thinkingMinimal: true,
-  thinkingLow: true,
-  thinkingMedium: true,
-  thinkingHigh: true,
-  thinkingXhigh: true,
-  thinkingMax: true,
-  bashMode: true,
-};