pi-powerline 0.6.0 → 0.6.2

package/CHANGELOG.md

@@ -0,0 +1,167 @@
+## [0.6.2](https://github.com/jwu/pi-powerline/compare/v0.6.1...v0.6.2) (2026-05-22)
+
+
+### Bug Fixes
+
+* simplify nerd font detection ([52dacaf](https://github.com/jwu/pi-powerline/commit/52dacaf693161456a8acfcc0da5a6abc98330ffc))
+
+## [0.6.1](https://github.com/jwu/pi-powerline/compare/v0.6.0...v0.6.1) (2026-05-15)
+
+
+### Bug Fixes
+
+* **header:** dedupe extension entries ([2b2db6e](https://github.com/jwu/pi-powerline/commit/2b2db6e4ed2973a50d145205a3884726591a2663))
+
+# [0.6.0](https://github.com/jwu/pi-powerline/compare/v0.5.1...v0.6.0) (2026-05-15)
+
+
+### Bug Fixes
+
+* **header:** add missing return in resolvePackageDir npm branch, add tests ([823d4eb](https://github.com/jwu/pi-powerline/commit/823d4ebec8d502c5dd3e07cb9a1c954d62b086bc))
+* **header:** check .pi/npm/node_modules for project-scoped npm packages ([ad2d8d6](https://github.com/jwu/pi-powerline/commit/ad2d8d6a5694ff5371813fcf9e9eaa69e12e3bdc))
+* **header:** resolve npm root via pi-coding-agent instead of pi-subagents ([0ba1051](https://github.com/jwu/pi-powerline/commit/0ba1051a231ad98c4a964658ec0c2a45307cc4c9))
+* **header:** use NVM_DIR/env probe instead of createRequire for npm root ([3081f77](https://github.com/jwu/pi-powerline/commit/3081f77dd49117d831433857c7fd91f89fa1e8c1))
+
+
+### Features
+
+* **header:** add packages and extensions sections, refactor to config-based discovery ([769465d](https://github.com/jwu/pi-powerline/commit/769465d0798548ff7e6098631739c9f5178fc938))
+* **header:** annotate packages with [project]/[global] scope tag ([d451e96](https://github.com/jwu/pi-powerline/commit/d451e96222b1a88f497b07b19fbc386344879417))
+
+## [0.5.1](https://github.com/jwu/pi-powerline/compare/v0.5.0...v0.5.1) (2026-05-12)
+
+### Code Refactoring
+
+* migrate peer deps from @mariozechner to @earendil-works scope ([3d7de22](https://github.com/jwu/pi-powerline/commit/3d7de22))
+
+# [0.5.0](https://github.com/jwu/pi-powerline/compare/v0.4.2...v0.5.0) (2026-05-12)
+
+
+### Features
+
+* show active tools in header info ([bcbc9a3](https://github.com/jwu/pi-powerline/commit/bcbc9a3d41b12ff86c252860cd941e4370d20108))
+
+## [0.4.2](https://github.com/jwu/pi-powerline/compare/v0.4.1...v0.4.2) (2026-05-08)
+
+
+### Bug Fixes
+
+* improve header session status ([58d644d](https://github.com/jwu/pi-powerline/commit/58d644d6dafe0c83e0b83eb6c451705c51a5e2d3))
+
+## [0.4.1](https://github.com/jwu/pi-powerline/compare/v0.4.0...v0.4.1) (2026-05-08)
+
+
+### Bug Fixes
+
+* enable header info by default ([bc229be](https://github.com/jwu/pi-powerline/commit/bc229befa2f552c89249bc5c110b5dde13c306c3))
+
+# [0.4.0](https://github.com/jwu/pi-powerline/compare/v0.3.1...v0.4.0) (2026-05-08)
+
+
+### Bug Fixes
+
+* respect quiet startup for header info ([fb243f5](https://github.com/jwu/pi-powerline/commit/fb243f5502f3a866ba971a243f7236f02a9cd96a))
+
+
+### Features
+
+* add optional header info ([40a2a29](https://github.com/jwu/pi-powerline/commit/40a2a29d758459962656f098da254939f537b87f))
+* center header status ([963e6ef](https://github.com/jwu/pi-powerline/commit/963e6ef0b0fc30fe896d6356734fcd23d1ae4ff5))
+
+## [0.3.1](https://github.com/jwu/pi-powerline/compare/v0.3.0...v0.3.1) (2026-05-06)
+
+
+### Bug Fixes
+
+* guard prepare script to skip simple-git-hooks outside git repos ([c26bcad](https://github.com/jwu/pi-powerline/commit/c26bcad428ea0a855e9725abb0d269a5f975d09f))
+
+# [0.3.0](https://github.com/jwu/pi-powerline/compare/v0.2.3...v0.3.0) (2026-05-06)
+
+
+### Bug Fixes
+
+* remove npm provenance (requires CI, not supported with --no-ci) ([d9e9005](https://github.com/jwu/pi-powerline/commit/d9e90055df72e9d3b991ba48ecd2acbbd3af998b))
+
+
+### Features
+
+* switch from git-cliff to semantic-release, add commitlint, strengthen TUI tests ([4cec86e](https://github.com/jwu/pi-powerline/commit/4cec86e61666436ef1cbc0a1cab3426408a0ce70))
+
+## [0.2.3] - 2026-05-06
+
+### 🐛 Bug Fixes
+
+- Husky command not found when installed as dependency
+
+### 📚 Documentation
+
+- Credit pi-powerline-footer by nicobailon
+
+### ⚙️ Miscellaneous Tasks
+
+- Update changelog
+## [0.2.2] - 2026-05-05
+
+### 🐛 Bug Fixes
+
+- Use GitHub raw URL for screenshot in README
+
+### ⚙️ Miscellaneous Tasks
+
+- Add homepage and repository fields to package.json
+## [0.2.1] - 2026-05-05
+
+### ⚙️ Miscellaneous Tasks
+
+- Add git-cliff changelog
+- Bump version to 0.2.1
+## [0.2.0] - 2026-05-05
+
+### 🚀 Features
+
+- Add powerline master switch, simplify README, use local assets
+
+### ⚙️ Miscellaneous Tasks
+
+- Bump version to 0.2.0
+## [0.1.0] - 2026-05-03
+
+### 🚀 Features
+
+- Powerline UI extensions with auto-format and pre-commit hooks
+- Add /powerline toggle command for editor, footer, header
+- Add powerline status widget above editor
+- /powerline commands take effect immediately via events bus
+
+### 🐛 Bug Fixes
+
+- EditorTheme type mismatch, add diagnostics checks
+
+### 💼 Other
+
+- Use pi.getThinkingLevel() and pi.on(thinking_level_select) for think level
+- Mirror built-in footer layout with full stats, context usage, thinking level
+- Drop redundant pwd line (already shown by widget)
+- Show only think level on right side, styled like widget
+- Add Nerd Font think icon to right side
+- Real-time token stats via message_update live usage fusion
+- Show (auto) marker when auto-compact is enabled
+- Move context usage to front of stats line, preserve per-segment coloring
+- Restore original dim-wrapping, keep context-first ordering only
+- Remove think level display (now in footer), show only model → folder
+- Truncate with ellipsis instead of wrapping to next line
+- Drop think: prefix from level label in stats line
+- Embed widget info (model + folder) in top border line
+
+### 🚜 Refactor
+
+- Unified settings model with breadcrumb/footer/header config keys
+- Extract shared breadcrumb helpers into breadcrumb.ts
+
+### 📚 Documentation
+
+- Update README to reflect current features, settings, and commands
+
+### ⚙️ Miscellaneous Tasks
+
+- Prepare package.json for pi package publishing

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jwu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -40,6 +40,24 @@ Settings are read from both global and project files. Project settings override
 | `header` | `true` / `false` | `true` | Enable custom gradient-logo header |
 | `header-info` | `true` / `false` | `true` | Show header diagnostic info on startup/reload |
 
+### Nerd Font icons
+
+pi-powerline uses Nerd Font icons when it can infer that the terminal supports them.
+
+Detection order:
+
+1. `PI_NERD_FONTS=1` forces icons on
+2. `PI_NERD_FONTS=0` forces icons off
+3. `GHOSTTY_RESOURCES_DIR` enables icons for Ghostty
+4. `TERM_PROGRAM` or `TERM` containing `iterm`, `wezterm`, `kitty`, `ghostty`, or `alacritty` enables icons
+5. Otherwise icons are disabled and plain text fallbacks are used
+
+For SSH or terminals that cannot be detected reliably, set it explicitly:
+
+```bash
+export PI_NERD_FONTS=1
+```
+
 ### Header info
 
 `header-info` adds diagnostic sections under the header:

package/{breadcrumb.ts → extensions/breadcrumb.ts}

@@ -1,23 +1,12 @@
 /**
  * Shared breadcrumb display helpers
  *
- * Export nerd font detection, icons, and helper functions used by
- * widget.ts and editor.ts to render the model→folder breadcrumb.
+ * Exports icons and helper functions used by widget.ts and editor.ts
+ * to render the model→folder breadcrumb.
  */
 import { basename } from 'node:path';
 import type { ExtensionContext, Theme } from '@earendil-works/pi-coding-agent';
-
-// ═══════════════════════════════════════════════════════════════════════════
-// nerd font detection
-// ═══════════════════════════════════════════════════════════════════════════
-
-export function hasNerdFonts(): boolean {
-  if (process.env.POWERLINE_NERD_FONTS === '1') return true;
-  if (process.env.POWERLINE_NERD_FONTS === '0') return false;
-  if (process.env.GHOSTTY_RESOURCES_DIR) return true;
-  const term = (process.env.TERM_PROGRAM || '').toLowerCase();
-  return ['iterm', 'wezterm', 'kitty', 'ghostty', 'alacritty'].some((t) => term.includes(t));
-}
+import { hasNerdFonts, hexFg, withIcon } from './utils.ts';
 
 const NERD = hasNerdFonts();
 
@@ -25,23 +14,6 @@ export const ICON_MODEL = NERD ? '\uF4BC' : '';
 export const ICON_FOLDER = NERD ? '\uF115' : '';
 export const SEP = NERD ? '\uf054' : '/';
 
-// ═══════════════════════════════════════════════════════════════════════════
-// helpers
-// ═══════════════════════════════════════════════════════════════════════════
-
-export function withIcon(icon: string, text: string): string {
-  return icon ? `${icon} ${text}` : text;
-}
-
-/** hex → ANSI true color (model/folder use hex, not pi theme tokens) */
-export function hexFg(hex: string, text: string): string {
-  const h = hex.replace('#', '');
-  const r = parseInt(h.slice(0, 2), 16);
-  const g = parseInt(h.slice(2, 4), 16);
-  const b = parseInt(h.slice(4, 6), 16);
-  return `\x1b[38;2;${r};${g};${b}m${text}`;
-}
-
 // ═══════════════════════════════════════════════════════════════════════════
 // breadcrumb data
 // ═══════════════════════════════════════════════════════════════════════════

package/{footer.ts → extensions/footer.ts}

@@ -16,7 +16,7 @@ import { join } from 'node:path';
 import type { AssistantMessage } from '@earendil-works/pi-ai';
 import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';
 import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
-import { hasNerdFonts, hexFg, withIcon } from './breadcrumb.ts';
+import { hasNerdFonts, hexFg, withIcon } from './utils.ts';
 import { readPowerlineSettings } from './settings.ts';
 
 // ═══════════════════════════════════════════════════════════════════════════

package/{header.ts → extensions/header.ts}

@@ -52,6 +52,10 @@ function gradientLine(line: string): string {
 
 const ANSI_PATTERN = /\x1b\[[0-9;]*m/g;
 
+function getHomeDir(): string {
+  return process.env.HOME ?? homedir();
+}
+
 function visibleLength(line: string): number {
   return line.replace(ANSI_PATTERN, '').length;
 }
@@ -251,7 +255,7 @@ function formatRelativePath(cwd: string, filePath: string): string {
 }
 
 function formatDisplayPath(cwd: string, filePath: string): string {
-  const home = homedir();
+  const home = getHomeDir();
   const rel = relative(cwd, filePath);
   if (!rel || !rel.startsWith('..')) return rel || '.';
   if (filePath === home) return '~';
@@ -334,7 +338,7 @@ function getNpmRoot(): string | undefined {
   if (_npmRootResolved) return _npmRoot;
   _npmRootResolved = true;
 
-  const home = homedir();
+  const home = getHomeDir();
 
   // NVM: ~/.nvm/versions/node/<version>/lib/node_modules
   if (process.env.NVM_DIR) {
@@ -394,7 +398,12 @@ interface PackageSource {
   scope: 'project' | 'user';
 }
 
-function readPackageSources(cwd: string, home = homedir()): PackageSource[] {
+interface ExtensionSource {
+  source: string;
+  baseDir: string;
+}
+
+function readPackageSources(cwd: string, home = getHomeDir()): PackageSource[] {
   const globalPkgs = readSettingsArray(join(home, '.pi', 'agent', 'settings.json'), 'packages');
   const projectPkgs = readSettingsArray(join(cwd, '.pi', 'settings.json'), 'packages');
 
@@ -416,7 +425,7 @@ function readPackageSources(cwd: string, home = homedir()): PackageSource[] {
 
 // ── resolve a package source to its directory path ──
 
-function resolvePackageDir(source: string, cwd: string, home = homedir()): string | undefined {
+function resolvePackageDir(source: string, cwd: string, home = getHomeDir()): string | undefined {
   if (source.startsWith('npm:')) {
     const name = source.slice(4);
     const npmRoot = getNpmRoot();
@@ -441,7 +450,7 @@ function resolvePackageDir(source: string, cwd: string, home = homedir()): strin
 
 // ── getPackages: name+version from each configured package ──
 
-function getPackages(cwd: string, home = homedir()): string[] {
+function getPackages(cwd: string, home = getHomeDir()): string[] {
   const sources = readPackageSources(cwd, home);
   const results: string[] = [];
 
@@ -463,16 +472,37 @@ function getPackages(cwd: string, home = homedir()): string[] {
 
 // ── getExtensionItems: scan .ts files from settings.json extensions dirs ──
 
-function getExtensionItems(cwd: string, home = homedir()): string[] {
+function readExtensionSources(cwd: string, home = getHomeDir()): ExtensionSource[] {
+  const projectBaseDir = join(cwd, '.pi');
+  const globalBaseDir = join(home, '.pi', 'agent');
+  const projectExts = readSettingsArray(join(projectBaseDir, 'settings.json'), 'extensions');
+  const globalExts = readSettingsArray(join(globalBaseDir, 'settings.json'), 'extensions');
+
+  return [
+    ...projectExts.map((source) => ({ source, baseDir: projectBaseDir })),
+    ...globalExts.map((source) => ({ source, baseDir: globalBaseDir })),
+  ];
+}
+
+function resolveSettingsSource(source: string, baseDir: string, home = getHomeDir()): string {
+  return source.startsWith('~')
+    ? join(home, source.slice(source.startsWith('~/') ? 2 : 1))
+    : resolve(baseDir, source);
+}
+
+function getExtensionItems(cwd: string, home = getHomeDir()): string[] {
   const results: string[] = [];
+  const seenFiles = new Set<string>();
 
-  const globalExts = readSettingsArray(join(home, '.pi', 'agent', 'settings.json'), 'extensions');
-  const projectExts = readSettingsArray(join(cwd, '.pi', 'settings.json'), 'extensions');
+  function addFile(filePath: string) {
+    const key = resolve(filePath);
+    if (seenFiles.has(key)) return;
+    seenFiles.add(key);
+    results.push(formatDisplayPath(cwd, filePath));
+  }
 
-  for (const ext of [...projectExts, ...globalExts]) {
-    const resolved = ext.startsWith('~')
-      ? join(home, ext.slice(ext.startsWith('~/') ? 2 : 1))
-      : resolve(cwd, ext);
+  for (const { source, baseDir } of readExtensionSources(cwd, home)) {
+    const resolved = resolveSettingsSource(source, baseDir, home);
 
     if (!existsSync(resolved)) continue;
 
@@ -480,12 +510,10 @@ function getExtensionItems(cwd: string, home = homedir()): string[] {
       const s = statSync(resolved);
       if (s.isDirectory()) {
         for (const f of readdirSync(resolved).sort()) {
-          if (f.endsWith('.ts')) {
-            results.push(formatDisplayPath(cwd, join(resolved, f)));
-          }
+          if (f.endsWith('.ts')) addFile(join(resolved, f));
         }
       } else {
-        results.push(formatDisplayPath(cwd, resolved));
+        addFile(resolved);
       }
     } catch {
       // ignore unreadable paths

package/extensions/utils.ts

@@ -0,0 +1,44 @@
+/**
+ * Shared utility functions
+ *
+ * Rendering and font-detection helpers used by breadcrumb, footer, and other extensions.
+ */
+
+// ═══════════════════════════════════════════════════════════════════════════
+// nerd font detection (cached)
+// ═══════════════════════════════════════════════════════════════════════════
+
+let _nerdCache: boolean | null = null;
+
+export function hasNerdFonts(): boolean {
+  if (_nerdCache !== null) return _nerdCache;
+
+  if (process.env.PI_NERD_FONTS === '1') return (_nerdCache = true);
+  if (process.env.PI_NERD_FONTS === '0') return (_nerdCache = false);
+  if (process.env.GHOSTTY_RESOURCES_DIR) return (_nerdCache = true);
+
+  const terminal = `${process.env.TERM_PROGRAM || ''} ${process.env.TERM || ''}`.toLowerCase();
+  if (['iterm', 'wezterm', 'kitty', 'ghostty', 'alacritty'].some((t) => terminal.includes(t))) {
+    return (_nerdCache = true);
+  }
+
+  return (_nerdCache = false);
+}
+
+// ═══════════════════════════════════════════════════════════════════════════
+// rendering helpers
+// ═══════════════════════════════════════════════════════════════════════════
+
+/** Prepend icon with trailing space, or return plain text if icon is empty */
+export function withIcon(icon: string, text: string): string {
+  return icon ? `${icon} ${text}` : text;
+}
+
+/** hex → ANSI true color escape (no reset appended) */
+export function hexFg(hex: string, text: string): string {
+  const h = hex.replace('#', '');
+  const r = parseInt(h.slice(0, 2), 16);
+  const g = parseInt(h.slice(2, 4), 16);
+  const b = parseInt(h.slice(4, 6), 16);
+  return `\x1b[38;2;${r};${g};${b}m${text}`;
+}

package/package.json

@@ -1,21 +1,23 @@
 {
   "name": "pi-powerline",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Powerline-style UI extensions for pi coding agent (custom editor, breadcrumb, footer, header)",
   "homepage": "https://github.com/jwu/pi-powerline#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/jwu/pi-powerline.git"
   },
+  "bugs": {
+    "url": "https://github.com/jwu/pi-powerline/issues"
+  },
   "type": "module",
   "files": [
-    "index.ts",
-    "editor.ts",
-    "breadcrumb.ts",
-    "widget.ts",
-    "footer.ts",
-    "header.ts",
-    "settings.ts"
+    "extensions/",
+    "README.md",
+    "package.json",
+    "CHANGELOG.md",
+    "LICENSE",
+    "assets/"
   ],
   "keywords": [
     "pi-package",
@@ -24,11 +26,12 @@
     "powerline",
     "extension"
   ],
-  "author": "",
+  "author": "jwu",
   "license": "MIT",
   "scripts": {
     "test": "bun test",
     "typecheck": "bun tsc --noEmit --ignoreDeprecations 6.0",
+    "lint": "bun run format:check && bun run typecheck",
     "format": "prettier --write '**/*.ts'",
     "format:check": "prettier --check '**/*.ts'",
     "prepare": "[ -d .git ] && simple-git-hooks || true",
@@ -70,9 +73,12 @@
     "pre-commit": "bun prettier --check '**/*.ts' && bun test",
     "commit-msg": "bun commitlint --edit \"$1\""
   },
+  "engines": {
+    "node": ">=20"
+  },
   "pi": {
     "extensions": [
-      "./index.ts"
+      "./extensions"
     ],
     "image": "https://raw.githubusercontent.com/jwu/pi-powerline/refs/heads/main/assets/pi-powerline.png"
   },