killeros 2.0.20 → 2.0.22

package/CHANGELOG.md

@@ -4,6 +4,35 @@ All notable changes to KillerOS are documented here.
 
 ## [Unreleased]
 
+## [2.0.22] - 2026-08-30
+
+### Changed
+
+- Replaced the footer's changed-file total with a colored modified, added, and deleted breakdown.
+
+### Fixed
+
+- Preserved the existing `createGitStatusRefresh` changed-file count callback contract.
+- Rejected linked `AGENTS.local.md` files before reading personal instructions.
+- Confirmed Windows hook process-tree cleanup before settling cancellations and timeouts, even when `taskkill` is absent from `PATH`.
+
+## [2.0.21] - 2026-08-29
+
+### Changed
+
+- Bounded goal verification and Pi compatibility, reduced Git status polling, reserved handoff context, and separated goal state and question UI logic.
+- Blocked moderate dependency advisories in CI and updated TypeBox within the supported 1.x line.
+- Preserved seconds in footer and goal elapsed times after one minute.
+- Added a muted top border to the prompt editor.
+- Colored the footer workspace path `#F0F89A`.
+- Added a live changed-file count beside the Git branch when the worktree is dirty.
+- Synced `dev` back to successful `main` releases after publishing.
+
+### Fixed
+
+- Kept likely secrets out of `/init`, restricted personal-instruction imports to Pi's agent directory, and replaced injectable handoff framing with validated JSON.
+- Hardened releases against stale CI runs, mismatched existing npm artifacts, and tag conflicts discovered after publication.
+
 ## [2.0.20] - 2026-08-25
 
 ### Changed

package/README.md

@@ -19,7 +19,7 @@ A TypeScript extension for the [Pi coding agent](https://github.com/earendil-wor
 ## Requirements
 
 - Node.js 22.19.0+
-- Pi 0.84.3+
+- Pi 0.84.3 or later within the 0.x release line
 - An interactive TUI session for the custom header, editor, footer, `question`, and `/init`
 
 ## Install
@@ -34,7 +34,7 @@ Or from GitHub:
 pi install git:github.com/KyrosHendrix/pi-KillerOS
 ```
 
-Pin a release by appending its tag, for example `@v2.0.20`. Add `-l` to install only for the current project. Restart Pi after installing.
+Pin a release by appending its tag, for example `@v2.0.22`. Add `-l` to install only for the current project. Restart Pi after installing.
 
 ## Commands
 

package/killeros/display.ts

@@ -28,9 +28,14 @@ export function formatTime(milliseconds: number): string {
   if (!Number.isFinite(milliseconds)) return "0s";
   const totalSeconds = Math.max(0, Math.floor(milliseconds / 1_000));
   if (totalSeconds < 60) return `${totalSeconds}s`;
-  const minutes = Math.floor(totalSeconds / 60);
-  if (minutes < 60) return `${minutes}m`;
-  return `${Math.floor(minutes / 60)}h${minutes % 60}m`;
+
+  const seconds = totalSeconds % 60;
+  const totalMinutes = Math.floor(totalSeconds / 60);
+  if (totalMinutes < 60) return `${totalMinutes}m ${seconds.toString().padStart(2, "0")}s`;
+
+  const hours = Math.floor(totalMinutes / 60);
+  const minutes = totalMinutes % 60;
+  return `${hours}h ${minutes.toString().padStart(2, "0")}m ${seconds.toString().padStart(2, "0")}s`;
 }
 
 export function formatTokens(value: number): string {

package/killeros/footer.ts

@@ -1,14 +1,127 @@
+import { execFile } from "node:child_process";
 import { type ExtensionAPI, type ExtensionContext, type Theme, type ThemeColor } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth, type TUI } from "@earendil-works/pi-tui";
 import { isCodexFastEnabled, subscribeCodexFast } from "./codex-fast-state.ts";
 import { formatCwd, formatTime, formatTokens, padRight } from "./display.ts";
-import { goalElapsedMilliseconds } from "./goals.ts";
+import { goalElapsedMilliseconds } from "./goal-state.ts";
 import type { GoalRuntime, GoalState } from "./runtime.ts";
 import { safeTerminalText } from "./safe-terminal-text.ts";
 import { LEVEL_COLORS, type ThinkingLevel } from "./variants.ts";
 
-const FOOTER_REFRESH_INTERVAL_MS = 1_000;
+const GIT_STATUS_REFRESH_INTERVAL_MS = 30_000;
 const CODEX_PROVIDER = "openai-codex";
+const colorDirectory = (text: string): string => `\x1B[38;2;240;248;154m${text}\x1B[39m`;
+
+interface GitFileChanges {
+  modified: number;
+  added: number;
+  deleted: number;
+}
+
+function resolveGitFileChanges(cwd: string): Promise<GitFileChanges | undefined> {
+  return new Promise((resolve) => {
+    execFile(
+      "git",
+      ["-C", cwd, "status", "--porcelain=v1", "-z", "--untracked-files=all"],
+      {
+        encoding: "utf8",
+        maxBuffer: 4 * 1024 * 1024,
+        timeout: 1_000,
+        windowsHide: true,
+      },
+      (error, stdout) => {
+        if (error) {
+          resolve(undefined);
+          return;
+        }
+
+        const changes: GitFileChanges = { modified: 0, added: 0, deleted: 0 };
+        const entries = stdout.split("\0");
+        for (let index = 0; index < entries.length; index += 1) {
+          const entry = entries[index];
+          if (!entry) continue;
+          const status = entry.slice(0, 2);
+          if (status.includes("D")) changes.deleted += 1;
+          else if (status === "??" || status.includes("A")) changes.added += 1;
+          else changes.modified += 1;
+          if (status.includes("R") || status.includes("C")) index += 1;
+        }
+        resolve(changes);
+      },
+    );
+  });
+}
+
+async function resolveUncommittedFileCount(cwd: string): Promise<number | undefined> {
+  const changes = await resolveGitFileChanges(cwd);
+  return changes && changes.modified + changes.added + changes.deleted;
+}
+
+function createGitRefresh<T>(
+  cwd: string,
+  onResult: (result: T | undefined) => void,
+  resolveResult: (cwd: string) => Promise<T | undefined>,
+): { request: () => void; dispose: () => void } {
+  let disposed = false;
+  let pending = false;
+  let queued = false;
+  const request = (): void => {
+    if (disposed) return;
+    if (pending) {
+      queued = true;
+      return;
+    }
+    pending = true;
+    void resolveResult(cwd).then((result) => {
+      if (!disposed) onResult(result);
+    }).finally(() => {
+      pending = false;
+      if (!disposed && queued) {
+        queued = false;
+        request();
+      }
+    });
+  };
+  return {
+    request,
+    dispose() {
+      disposed = true;
+      queued = false;
+    },
+  };
+}
+
+/** Coalesces Git status requests to one active scan and one queued follow-up. */
+export function createGitStatusRefresh(
+  cwd: string,
+  onCount: (count: number | undefined) => void,
+  resolveCount: (cwd: string) => Promise<number | undefined> = resolveUncommittedFileCount,
+): { request: () => void; dispose: () => void } {
+  return createGitRefresh(cwd, onCount, resolveCount);
+}
+
+function createGitFileChangesRefresh(
+  cwd: string,
+  onChanges: (changes: GitFileChanges | undefined) => void,
+): { request: () => void; dispose: () => void } {
+  return createGitRefresh(cwd, onChanges, resolveGitFileChanges);
+}
+
+type ScheduleFallback = (refresh: () => void, intervalMs: number) => () => void;
+
+const scheduleFallback: ScheduleFallback = (refresh, intervalMs) => {
+  const timer = setInterval(refresh, intervalMs);
+  timer.unref?.();
+  return () => clearInterval(timer);
+};
+
+/** Schedules the fallback Git scan independently from footer rendering. */
+export function scheduleGitStatusFallback(
+  refresh: () => void,
+  schedule: ScheduleFallback = scheduleFallback,
+): () => void {
+  return schedule(refresh, GIT_STATUS_REFRESH_INTERVAL_MS);
+}
 
 export function formatCost(usd: number): string {
   if (!Number.isFinite(usd)) return "$—";
@@ -142,29 +255,22 @@ function renderFooter(rows: string[], width: number, theme: Theme): string[] {
   return [theme.fg("borderMuted", "─".repeat(width)), ...rows];
 }
 
-function formatGoalElapsed(milliseconds: number): string {
-  const totalSeconds = Number.isFinite(milliseconds) ? Math.max(0, Math.floor(milliseconds / 1_000)) : 0;
-  if (totalSeconds < 60) return `${totalSeconds}s`;
-
-  const seconds = totalSeconds % 60;
-  const totalMinutes = Math.floor(totalSeconds / 60);
-  if (totalMinutes < 60) return `${totalMinutes}m ${seconds.toString().padStart(2, "0")}s`;
-
-  const hours = Math.floor(totalMinutes / 60);
-  const minutes = totalMinutes % 60;
-  return `${hours}h ${minutes.toString().padStart(2, "0")}m ${seconds.toString().padStart(2, "0")}s`;
-}
-
 function formatGoalFooter(state: GoalState | undefined, theme: Theme): string {
   if (!state) return "";
   if (state.status === "active") {
-    return theme.fg("warning", `/goal is active (${formatGoalElapsed(goalElapsedMilliseconds(state))})`);
+    return theme.fg("warning", `/goal is active (${formatTime(goalElapsedMilliseconds(state, Date.now()))})`);
   }
   if (state.status === "paused") return theme.fg("warning", "/goal is paused");
   if (state.status === "blocked") return theme.fg("error", "/goal is blocked");
   return "";
 }
 
+function formatGitFileChanges(changes: GitFileChanges, theme: Theme): string {
+  const total = changes.modified + changes.added + changes.deleted;
+  if (total === 0) return "";
+  return `${theme.fg("dim", `±${total} [`)}${theme.fg("warning", `~${changes.modified}`)} ${theme.fg("success", `+${changes.added}`)} ${theme.fg("error", `−${changes.deleted}`)}${theme.fg("dim", "]")}`;
+}
+
 export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void {
   let currentModel: ExtensionContext["model"];
   let thinkingLevel: ThinkingLevel = "off";
@@ -172,6 +278,7 @@ export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void
   let cachedSessionCost = 0;
   let sessionCostDirty = true;
   let unsubscribeCodexFast: (() => void) | undefined;
+  let requestGitStatusRefresh: (() => void) | undefined;
   const resetSessionCost = (): void => {
     cachedSessionCost = 0;
     sessionCostDirty = true;
@@ -201,13 +308,25 @@ export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void
 
     ctx.ui.setFooter((tui, theme, footerData) => {
       activeTui = tui;
-      const unsubscribe = footerData.onBranchChange(() => tui.requestRender());
-      const refreshTimer = setInterval(() => tui.requestRender(), FOOTER_REFRESH_INTERVAL_MS);
-      refreshTimer.unref?.();
+      let gitFileChanges: GitFileChanges | undefined;
+      const gitStatus = createGitFileChangesRefresh(ctx.cwd, (changes) => {
+        if (JSON.stringify(changes) === JSON.stringify(gitFileChanges)) return;
+        gitFileChanges = changes;
+        tui.requestRender();
+      });
+      requestGitStatusRefresh = gitStatus.request;
+      const unsubscribe = footerData.onBranchChange(() => {
+        gitStatus.request();
+        tui.requestRender();
+      });
+      gitStatus.request();
+      const stopFallback = scheduleGitStatusFallback(gitStatus.request);
       return {
         dispose() {
           unsubscribe();
-          clearInterval(refreshTimer);
+          stopFallback();
+          gitStatus.dispose();
+          if (requestGitStatusRefresh === gitStatus.request) requestGitStatusRefresh = undefined;
           if (activeTui === tui) activeTui = undefined;
         },
         invalidate() {},
@@ -227,8 +346,8 @@ export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void
           const context = formatContextProgress(usage?.tokens ?? null, contextWindow, theme);
           const branch = footerData.getGitBranch();
           const signature = formatModel(model, theme, true, isCodexFastEnabled());
-          const fullDirectory = theme.fg("dim", cwd);
-          const focusedDirectory = theme.fg("dim", compactDirectory(cwd));
+          const fullDirectory = colorDirectory(cwd);
+          const focusedDirectory = colorDirectory(compactDirectory(cwd));
           const goal = formatGoalFooter(goalRuntime.state, theme);
           const primary = joinFooterParts([
             signature,
@@ -248,7 +367,10 @@ export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void
               : footerRowFits(primaryFocused, "", width)
                 ? renderFooterRow(primaryFocused, "", width)
                 : renderFooterRow(essentialModel, context, width);
-          const branchLabel = branch ? theme.fg("dim", branch) : "";
+          const changes = gitFileChanges ? formatGitFileChanges(gitFileChanges, theme) : "";
+          const branchLabel = branch
+            ? `${theme.fg("dim", branch)}${changes ? `${theme.fg("dim", " · ")}${changes}` : ""}`
+            : "";
           const workspaceRight = goal || fullDirectory;
           const secondaryRow = footerRowFits(branchLabel, workspaceRight, width)
             ? renderFooterRow(branchLabel, workspaceRight, width)
@@ -271,8 +393,12 @@ export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void
     thinkingLevel = event.level;
     activeTui?.requestRender();
   });
-  pi.on("turn_end", invalidateSessionCost);
-  pi.on("session_compact", invalidateSessionCost);
+  const refreshAfterActivity = (): void => {
+    invalidateSessionCost();
+    requestGitStatusRefresh?.();
+  };
+  pi.on("turn_end", refreshAfterActivity);
+  pi.on("session_compact", refreshAfterActivity);
   pi.on("session_tree", () => {
     resetSessionCost();
     activeTui?.requestRender();
@@ -282,6 +408,7 @@ export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void
     unsubscribeCodexFast = undefined;
     resetSessionCost();
     activeTui = undefined;
+    requestGitStatusRefresh = undefined;
     goalRuntime.requestRender = undefined;
   });
 }