killeros 2.0.19 → 2.0.21

package/CHANGELOG.md

@@ -4,6 +4,35 @@ All notable changes to KillerOS are documented here.
 
 ## [Unreleased]
 
+## [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
+
+- Added a typescript-eslint type-checked lint gate (`npm run lint`) alongside `tsc --noEmit`, and cleaned up the dead imports and untyped boundaries it surfaced.
+
+### Fixed
+
+- Treated Pi's exact `Nothing to compact (session too small)` rejection as an expected automatic-compaction skip: no failure notification, silent retry on the next eligible turn, and active goals resume through a dedicated skip recovery instead of pausing for `/goal resume`.
+- Made `/handoff` resilient to an unreadable `killeros.json`: explicit `KillerosOptions` budgets bypass the file, while other summaries fall back to the default budget with a visible warning.
+- Named `/handoff` output truncation instead of reporting "did not finish", raised the default summary budget to 8192 tokens for reasoning models, and made the budget configurable through `KillerosOptions` or the `killeros.json` `handoffMaxTokens` key.
+
 ## [2.0.19] - 2026-08-24
 
 ### Changed

package/Killeros.ts

@@ -30,6 +30,8 @@ export { buildInitEvidence, listInitEvidence, readInitEvidence } from "./killero
 export { captureInitTargetBaseline, installInitAgentsFile, validateGeneratedGuidance, writeInitAgentsFile } from "./killeros/init-target.ts";
 export interface KillerosOptions {
   completionNotifications?: CompletionNotificationDependencies;
+  /** Output-token budget for /handoff summaries; invalid values fall back to killeros.json, then the default. */
+  handoffMaxTokens?: number;
 }
 
 export default function Killeros(pi: ExtensionAPI, options: KillerosOptions = {}): void {
@@ -41,7 +43,7 @@ export default function Killeros(pi: ExtensionAPI, options: KillerosOptions = {}
   registerPersonalInstructions(pi, initRuntime);
   registerQuestionTool(pi);
   registerAliases(pi);
-  registerHandoff(pi, goalRuntime);
+  registerHandoff(pi, goalRuntime, options.handoffMaxTokens);
   registerSlashAutocomplete(pi, commandResolver);
   registerFooter(pi, goalRuntime);
   registerVariants(pi);

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.19`. Add `-l` to install only for the current project. Restart Pi after installing.
+Pin a release by appending its tag, for example `@v2.0.21`. Add `-l` to install only for the current project. Restart Pi after installing.
 
 ## Commands
 
@@ -67,10 +67,13 @@ The packaged `killeros` theme activates on TUI start. Compaction triggers by def
   "autoCompaction": {
     "enabled": true,
     "percentRemaining": 15
-  }
+  },
+  "handoffMaxTokens": 8192
 }
 ```
 
+`handoffMaxTokens` caps the `/handoff` summary output at 8192 tokens by default; raise it when long sessions truncate the summary.
+
 Completion sounds are off by default; change with `/notification` in TUI mode. The tab-title indicator requires a Nerd Font.
 
 ## Development

package/killeros/auto-compaction.ts

@@ -12,6 +12,8 @@ import { createKillerosSettingsStore } from "./settings.ts";
 export const DEFAULT_AUTO_COMPACTION_PERCENT_REMAINING = 15;
 export const AUTO_COMPACTION_MESSAGE_TYPE = "killeros-auto-compaction";
 export const AUTO_COMPACTION_MESSAGE = "Continue the interrupted task from the compacted context.";
+/** Pi's exact rejection when a session has no eligible history to summarize; an expected skip, not a failure. */
+export const SESSION_TOO_SMALL_COMPACTION_ERROR = "Nothing to compact (session too small)";
 
 export interface AutoCompactionPreference {
   enabled: boolean;
@@ -23,6 +25,8 @@ export interface AutoCompactionGoalHandlers {
   onRequested(): void;
   onCompleted(ctx: ExtensionContext): void;
   onFailed(ctx: ExtensionContext, error: unknown): void;
+  /** Recovers the goal paused for a request Pi rejected as session-too-small, without claiming success. */
+  onSkipped(ctx: ExtensionContext): void;
 }
 
 export interface AutoCompactionDependencies {
@@ -72,6 +76,11 @@ function reserveTokens(settings: Pick<CompactionSettings, "reserveTokens">): num
     : 0;
 }
 
+/** Matches only Pi's exact rejection text on a real Error; near-matches and stringified values stay failures. */
+export function isSessionTooSmallCompactionError(error: unknown): boolean {
+  return error instanceof Error && error.message === SESSION_TOO_SMALL_COMPACTION_ERROR;
+}
+
 /** Triggers at the stricter of the user's percentage and Pi's token reserve. */
 export function shouldTriggerAutoCompaction(
   usage: Pick<ContextUsage, "tokens" | "contextWindow"> | undefined,
@@ -116,13 +125,7 @@ export function registerAutoCompaction(
     ctx.ui.notify(`Automatic compaction failed: ${errorMessage(error)}`, "error");
   };
 
-  const finishFailure = (
-    ctx: ExtensionContext,
-    token: symbol,
-    goal: boolean,
-    error: unknown,
-  ): void => {
-    if (!request || request.token !== token) return;
+  const finishFailure = (ctx: ExtensionContext, goal: boolean, error: unknown): void => {
     request = undefined;
     if (goal && dependencies.goal) {
       try {
@@ -135,6 +138,33 @@ export function registerAutoCompaction(
     notifyFailure(ctx, error);
   };
 
+  /** Ends a request with Pi's expected eligibility rejection: silent, rearmed, and never a failure. */
+  const finishSkip = (ctx: ExtensionContext, goal: boolean): void => {
+    request = undefined;
+    armed = true;
+    if (!goal) return;
+    try {
+      dependencies.goal?.onSkipped(ctx);
+    } catch (callbackError) {
+      notifyFailure(ctx, callbackError);
+    }
+  };
+
+  /** Single entry point for rejected requests: classifies before any sanitization, stale tokens stay inert. */
+  const finishRequestError = (
+    ctx: ExtensionContext,
+    token: symbol,
+    goal: boolean,
+    error: unknown,
+  ): void => {
+    if (!request || request.token !== token) return;
+    if (isSessionTooSmallCompactionError(error)) {
+      finishSkip(ctx, goal);
+      return;
+    }
+    finishFailure(ctx, goal, error);
+  };
+
   pi.on("turn_end", (_event, ctx) => {
     if (!supportedMode(ctx) || request) return;
 
@@ -179,7 +209,7 @@ export function registerAutoCompaction(
       try {
         dependencies.goal.onRequested();
       } catch (error) {
-        finishFailure(ctx, token, true, error);
+        finishFailure(ctx, true, error);
         return;
       }
     }
@@ -207,10 +237,10 @@ export function registerAutoCompaction(
             notifyFailure(ctx, error);
           }
         },
-        onError: (error) => finishFailure(ctx, token, goal, error),
+        onError: (error) => finishRequestError(ctx, token, goal, error),
       });
     } catch (error) {
-      finishFailure(ctx, token, goal, error);
+      finishRequestError(ctx, token, goal, error);
     }
   });
 

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,98 @@
-import { DynamicBorder, type ExtensionAPI, type ExtensionContext, type Theme, type ThemeColor } from "@earendil-works/pi-coding-agent";
-import { Container, Text, truncateToWidth, visibleWidth, type TUI } from "@earendil-works/pi-tui";
+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`;
+
+function resolveUncommittedFileCount(cwd: string): Promise<number | 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 entries = stdout.split("\0");
+        let count = 0;
+        for (let index = 0; index < entries.length; index += 1) {
+          const entry = entries[index];
+          if (!entry) continue;
+          count += 1;
+          if (entry[0] === "R" || entry[0] === "C" || entry[1] === "R" || entry[1] === "C") index += 1;
+        }
+        resolve(count);
+      },
+    );
+  });
+}
+
+/** 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 } {
+  let disposed = false;
+  let pending = false;
+  let queued = false;
+  const request = (): void => {
+    if (disposed) return;
+    if (pending) {
+      queued = true;
+      return;
+    }
+    pending = true;
+    void resolveCount(cwd).then((count) => {
+      if (!disposed) onCount(count);
+    }).finally(() => {
+      pending = false;
+      if (!disposed && queued) {
+        queued = false;
+        request();
+      }
+    });
+  };
+  return {
+    request,
+    dispose() {
+      disposed = true;
+      queued = false;
+    },
+  };
+}
+
+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,23 +226,10 @@ 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");
@@ -172,6 +243,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 +273,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 uncommittedFileCount: number | undefined;
+      const gitStatus = createGitStatusRefresh(ctx.cwd, (count) => {
+        if (count === uncommittedFileCount) return;
+        uncommittedFileCount = count;
+        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 +311,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 +332,11 @@ 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 branchLabel = branch
+            ? uncommittedFileCount
+              ? `${theme.fg("dim", `${branch} · `)}${theme.fg("warning", `${uncommittedFileCount} changed`)}`
+              : theme.fg("dim", branch)
+            : "";
           const workspaceRight = goal || fullDirectory;
           const secondaryRow = footerRowFits(branchLabel, workspaceRight, width)
             ? renderFooterRow(branchLabel, workspaceRight, width)
@@ -271,8 +359,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 +374,7 @@ export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void
     unsubscribeCodexFast = undefined;
     resetSessionCost();
     activeTui = undefined;
+    requestGitStatusRefresh = undefined;
     goalRuntime.requestRender = undefined;
   });
 }