killeros 2.0.21 → 2.0.22

package/CHANGELOG.md

@@ -4,6 +4,18 @@ 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

package/README.md

@@ -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.21`. 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/footer.ts

@@ -12,7 +12,13 @@ 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> {
+interface GitFileChanges {
+  modified: number;
+  added: number;
+  deleted: number;
+}
+
+function resolveGitFileChanges(cwd: string): Promise<GitFileChanges | undefined> {
   return new Promise((resolve) => {
     execFile(
       "git",
@@ -29,25 +35,32 @@ function resolveUncommittedFileCount(cwd: string): Promise<number | undefined> {
           return;
         }
 
+        const changes: GitFileChanges = { modified: 0, added: 0, deleted: 0 };
         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;
+          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(count);
+        resolve(changes);
       },
     );
   });
 }
 
-/** Coalesces Git status requests to one active scan and one queued follow-up. */
-export function createGitStatusRefresh(
+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,
-  onCount: (count: number | undefined) => void,
-  resolveCount: (cwd: string) => Promise<number | undefined> = resolveUncommittedFileCount,
+  onResult: (result: T | undefined) => void,
+  resolveResult: (cwd: string) => Promise<T | undefined>,
 ): { request: () => void; dispose: () => void } {
   let disposed = false;
   let pending = false;
@@ -59,8 +72,8 @@ export function createGitStatusRefresh(
       return;
     }
     pending = true;
-    void resolveCount(cwd).then((count) => {
-      if (!disposed) onCount(count);
+    void resolveResult(cwd).then((result) => {
+      if (!disposed) onResult(result);
     }).finally(() => {
       pending = false;
       if (!disposed && queued) {
@@ -78,6 +91,22 @@ export function createGitStatusRefresh(
   };
 }
 
+/** 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) => {
@@ -236,6 +265,12 @@ function formatGoalFooter(state: GoalState | undefined, theme: Theme): string {
   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";
@@ -273,10 +308,10 @@ export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void
 
     ctx.ui.setFooter((tui, theme, footerData) => {
       activeTui = tui;
-      let uncommittedFileCount: number | undefined;
-      const gitStatus = createGitStatusRefresh(ctx.cwd, (count) => {
-        if (count === uncommittedFileCount) return;
-        uncommittedFileCount = count;
+      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;
@@ -332,10 +367,9 @@ export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void
               : footerRowFits(primaryFocused, "", width)
                 ? renderFooterRow(primaryFocused, "", width)
                 : renderFooterRow(essentialModel, context, width);
+          const changes = gitFileChanges ? formatGitFileChanges(gitFileChanges, theme) : "";
           const branchLabel = branch
-            ? uncommittedFileCount
-              ? `${theme.fg("dim", `${branch} · `)}${theme.fg("warning", `${uncommittedFileCount} changed`)}`
-              : theme.fg("dim", branch)
+            ? `${theme.fg("dim", branch)}${changes ? `${theme.fg("dim", " · ")}${changes}` : ""}`
             : "";
           const workspaceRight = goal || fullDirectory;
           const secondaryRow = footerRowFits(branchLabel, workspaceRight, width)

package/killeros/hooks.ts

@@ -197,16 +197,27 @@ function appendBounded(output: HookOutputBuffer, chunk: Buffer | string): void {
   output.text += output.decoder.write(captured);
 }
 
+/** Terminates a Windows hook tree without depending on the caller's PATH. */
+function terminateWindowsHookTree(child: HookChildProcess): Promise<boolean> {
+  return new Promise((resolve) => {
+    try {
+      const taskkill = process.env.SystemRoot
+        ? path.join(process.env.SystemRoot, "System32", "taskkill.exe")
+        : "taskkill";
+      const killer = spawn(taskkill, ["/pid", String(child.pid), "/T", "/F"], {
+        shell: false,
+        stdio: "ignore",
+        windowsHide: true,
+      });
+      killer.once("error", () => resolve(false));
+      killer.once("close", (code) => resolve(code === 0));
+    } catch {
+      resolve(false);
+    }
+  });
+}
+
 function terminateHookProcess(child: HookChildProcess, force: boolean): void {
-  if (process.platform === "win32" && force && child.pid) {
-    const killer = spawn("taskkill", ["/pid", String(child.pid), "/T", "/F"], {
-      shell: false,
-      stdio: "ignore",
-      windowsHide: true,
-    });
-    killer.unref();
-    return;
-  }
   if (process.platform !== "win32" && child.pid) {
     try {
       process.kill(-child.pid, force ? "SIGKILL" : "SIGTERM");
@@ -282,6 +293,7 @@ export function executeHook(
     let timer: NodeJS.Timeout | undefined;
     let forceTimer: NodeJS.Timeout | undefined;
     let settleTimer: NodeJS.Timeout | undefined;
+    let windowsCleanupPending = false;
     const finish = (code: number, exitUnconfirmed = false): void => {
       if (completed) return;
       completed = true;
@@ -304,6 +316,21 @@ export function executeHook(
     const beginTermination = (reason: "timeout" | "cancelled"): void => {
       if (completed || termination) return;
       termination = reason;
+      if (process.platform === "win32" && child.pid) {
+        windowsCleanupPending = true;
+        void terminateWindowsHookTree(child).then((confirmed) => {
+          if (completed) return;
+          if (!confirmed) terminateHookProcess(child, true);
+          finish(terminationCode(), !confirmed);
+          windowsCleanupPending = false;
+        });
+        settleTimer = setTimeout(() => {
+          terminateHookProcess(child, true);
+          finish(terminationCode(), true);
+          windowsCleanupPending = false;
+        }, 2_000);
+        return;
+      }
       terminateHookProcess(child, false);
       forceTimer = setTimeout(() => {
         if (completed) return;
@@ -318,9 +345,11 @@ export function executeHook(
     child.stderr.on("data", (chunk) => appendBounded(stderr, chunk));
     child.on("error", (error) => {
       appendBounded(stderr, error.message);
-      finish(termination ? terminationCode() : 1);
+      if (!windowsCleanupPending) finish(termination ? terminationCode() : 1);
+    });
+    child.once("close", (code) => {
+      if (!windowsCleanupPending) finish(termination ? terminationCode() : code ?? 1);
     });
-    child.once("close", (code) => finish(termination ? terminationCode() : code ?? 1));
     timer = setTimeout(() => beginTermination("timeout"), Math.max(1, Math.min(timeoutMs, HOOK_TIMEOUT_MAX_MS)));
   });
 }

package/killeros/personal-instructions.ts

@@ -11,7 +11,12 @@ const PERSONAL_INSTRUCTIONS_LIMIT = 32 * 1024;
 function readBoundedText(filePath: string, limit = PERSONAL_INSTRUCTIONS_LIMIT): string | undefined {
   let descriptor: number | undefined;
   try {
+    const pathStat = lstatSync(filePath);
+    if (!pathStat.isFile() || pathStat.isSymbolicLink() || pathStat.nlink !== 1) return undefined;
     descriptor = openSync(filePath, "r");
+    const openedStat = fstatSync(descriptor);
+    if (!openedStat.isFile() || openedStat.nlink !== 1
+      || openedStat.dev !== pathStat.dev || openedStat.ino !== pathStat.ino) return undefined;
     const buffer = Buffer.alloc(limit + 1);
     const bytesRead = readSync(descriptor, buffer, 0, buffer.length, 0);
     const decoder = new StringDecoder("utf8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "killeros",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "TUI, goals, and workflow automation for the Pi coding agent",
   "type": "module",
   "keywords": [