killeros 2.1.25 → 2.1.26

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to KillerOS are documented here.
 
 ## [Unreleased]
 
+## [2.1.26] - 2026-09-08
+
+### Fixed
+
+- Restored Pi lifecycle loading, blocked footer Git status from invoking configured filesystem monitors, and kept replaced `/init` guidance at a disclosed recovery path so late writes remain recoverable.
+- Preserved Unicode blocker evidence when restoring goals, rejected cancelled goal updates before completion is saved, and read untracked symlink destinations instead of their targets in change receipts.
+- Kept `/init` isolated from proactive compaction, refreshed Git filter safeguards for each receipt scan, and preserved compaction recovery after cancelled session replacements.
+
 ## [2.1.25] - 2026-09-06
 
 ### Fixed

package/Killeros.ts

@@ -53,7 +53,7 @@ export default function Killeros(pi: ExtensionAPI, options: KillerosOptions = {}
   registerLifecycleHooks(pi);
   registerWorkedFor(pi);
   const goalCompaction = registerGoalSettlement(pi, goalRuntime, initRuntime);
-  registerAutoCompaction(pi, { goal: goalCompaction });
+  registerAutoCompaction(pi, { goal: goalCompaction, isInitActive: () => initRuntime.active });
   registerInitSettlement(pi, initRuntime);
   registerRequestActivity(pi);
   registerCompletionNotifications(pi, options.completionNotifications);

package/README.md

@@ -33,7 +33,7 @@ Or from GitHub:
 pi install git:github.com/KyrosHendrix/pi-KillerOS
 ```
 
-Pin a release by appending its tag, for example `@v2.1.25`. Add `-l` to install only for the current project. Restart Pi after installing.
+Pin a release by appending its tag, for example `@v2.1.26`. Add `-l` to install only for the current project. Restart Pi after installing.
 
 ## Commands
 

package/killeros/auto-compaction.ts

@@ -33,6 +33,7 @@ export interface AutoCompactionDependencies {
   loadPreference?: (ctx: ExtensionContext) => AutoCompactionPreference;
   getCompactionSettings?: (ctx: ExtensionContext) => CompactionSettings;
   goal?: AutoCompactionGoalHandlers;
+  isInitActive?: () => boolean;
 }
 
 type AutoCompactionRequest = {
@@ -192,7 +193,7 @@ export function registerAutoCompaction(
   };
 
   pi.on("turn_end", (_event, ctx) => {
-    if (!supportedMode(ctx) || request) return;
+    if (!supportedMode(ctx) || dependencies.isInitActive?.() === true || request) return;
 
     let preference: AutoCompactionPreference;
     let compactionSettings: CompactionSettings;
@@ -288,6 +289,4 @@ export function registerAutoCompaction(
   pi.on("session_start", resetForLifecycle);
   pi.on("session_shutdown", resetForLifecycle);
   pi.on("session_tree", resetForLifecycle);
-  pi.on("session_before_switch", resetForLifecycle);
-  pi.on("session_before_fork", resetForLifecycle);
 }

package/killeros/change-receipt.ts

@@ -119,47 +119,23 @@ function missingFile(error: unknown): boolean {
   return error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT";
 }
 
-type FilterConfiguration = { names: readonly string[]; sources: ReadonlyMap<string, Buffer> };
 type Repository = {
   root: string;
   gitDirectory: string;
   commonDirectory: string;
   objectDirectory: string;
-  filterConfiguration: FilterConfiguration;
   blobCache: Map<string, Buffer>;
   blobCacheBytes: number;
 };
 const repositoryCache = new Map<string, Promise<Repository>>();
 
-async function loadFilterConfiguration(root: string, gitDirectory: string): Promise<FilterConfiguration> {
-  const records = decode(await runGit(root, ["config", "--null", "--show-origin", "--name-only", "--list"])).split("\0");
+async function loadFilterNames(root: string): Promise<readonly string[]> {
+  const records = decode(await runGit(root, ["config", "--null", "--name-only", "--list"])).split("\0");
   const names = new Set<string>();
-  const sourcePaths = new Set<string>([path.join(gitDirectory, "HEAD")]);
-  for (let index = 0; index + 1 < records.length; index += 2) {
-    const origin = records[index];
-    const key = records[index + 1];
-    if (origin?.startsWith("file:")) sourcePaths.add(path.resolve(root, origin.slice("file:".length)));
+  for (const key of records) {
     if (key && /^filter\..*\.(clean|process)$/u.test(key)) names.add(key.slice("filter.".length, key.lastIndexOf(".")));
   }
-  const sources = new Map<string, Buffer>();
-  for (const sourcePath of sourcePaths) sources.set(sourcePath, await readBoundedFile(sourcePath, GIT_OUTPUT_LIMIT));
-  return { names: [...names], sources };
-}
-
-async function currentFilterNames(repo: Repository): Promise<readonly string[]> {
-  for (const [sourcePath, previous] of repo.filterConfiguration.sources) {
-    try {
-      if (!(await readBoundedFile(sourcePath, GIT_OUTPUT_LIMIT)).equals(previous)) {
-        repo.filterConfiguration = await loadFilterConfiguration(repo.root, repo.gitDirectory);
-        break;
-      }
-    } catch (error) {
-      if (!missingFile(error)) throw error;
-      repo.filterConfiguration = await loadFilterConfiguration(repo.root, repo.gitDirectory);
-      break;
-    }
-  }
-  return repo.filterConfiguration.names;
+  return [...names];
 }
 
 async function repository(cwd: string): Promise<Repository> {
@@ -174,7 +150,6 @@ async function repository(cwd: string): Promise<Repository> {
       gitDirectory,
       commonDirectory,
       objectDirectory: path.join(commonDirectory, "objects"),
-      filterConfiguration: await loadFilterConfiguration(root, gitDirectory),
       blobCache: new Map(),
       blobCacheBytes: 0,
     };
@@ -278,7 +253,7 @@ function discardMonitor(monitor: RepositoryMonitor): void {
 }
 
 async function snapshot(repo: Repository, paths?: readonly string[]): Promise<Snapshot> {
-  const filterNames = await currentFilterNames(repo);
+  const filterNames = await loadFilterNames(repo.root);
   const output = decode(await runGit(repo.root, [
     "-c", "core.fsmonitor=false",
     ...filterNames.flatMap((name) => ["-c", `filter.${name}.clean=`, "-c", `filter.${name}.process=`, "-c", `filter.${name}.required=false`]),
@@ -295,12 +270,13 @@ async function snapshot(repo: Repository, paths?: readonly string[]): Promise<Sn
     if (record.startsWith("? ")) {
       const filePath = record.slice(2);
       if (!filePath || filePath.endsWith("/")) continue;
+      const stats = await lstat(path.join(repo.root, ...filePath.split("/")));
       files.set(filePath, {
         ...files.get(filePath),
         path: filePath,
         indexMode: undefined,
         indexObjectId: undefined,
-        mode: "100644",
+        mode: stats.isSymbolicLink() ? "120000" : stats.mode & 0o111 ? "100755" : "100644",
         contentObjectId: undefined,
       });
       continue;

package/killeros/footer.ts

@@ -43,7 +43,7 @@ export function resolveGitFileChanges(
   return new Promise((resolve) => {
     execute(
       "git",
-      ["-C", cwd, "status", "--porcelain=v1", "-z", "--untracked-files=all"],
+      ["-C", cwd, "-c", "core.fsmonitor=false", "status", "--porcelain=v1", "-z", "--untracked-files=all"],
       {
         encoding: "utf8",
         env: { ...process.env, GIT_OPTIONAL_LOCKS: "0" },

package/killeros/goal-interface.ts

@@ -90,6 +90,7 @@ export function registerGoalInterface(
     parameters: GoalUpdateParams,
     executionMode: "sequential",
     async execute(_toolCallId, params, signal, _onUpdate, ctx) {
+      signal?.throwIfAborted();
       if (!isGoalModeSupported(ctx)) throw new Error("KillerOS goals require TUI or RPC mode");
       if (!isSavedSession(ctx)) throw new Error("KillerOS goals require a saved session");
       const state = runtime.state;
@@ -98,6 +99,7 @@ export function registerGoalInterface(
       if (!evidence) throw new Error("Goal evidence must not be empty");
       if (params.status === "complete") {
         if (state.verification) await verifyGoalDeliverable(state.verification);
+        signal?.throwIfAborted();
         if (runtime.state !== state) throw new Error("Goal changed while completion was being verified");
         const verification = state.verification ? "file" : "model-reported";
         transitionGoal(pi, runtime, "complete", "complete", evidence, { resetBlockedAudit: true });

package/killeros/goal-settlement.ts

@@ -224,10 +224,6 @@ export function registerGoalSettlement(
     recoverGoalAfterManualCompaction(pi, runtime, initState, ctx);
   });
 
-  const resetAutomaticRecovery = (): void => { runtime.automaticCompaction = undefined; };
-  pi.on("session_before_switch", resetAutomaticRecovery);
-  pi.on("session_before_fork", resetAutomaticRecovery);
-
   return {
     isActive: (ctx: ExtensionContext): boolean => isGoalModeSupported(ctx)
       && isSavedSession(ctx)

package/killeros/goal-state.ts

@@ -10,6 +10,7 @@ export const GOAL_MAX_TURNS = 10_000;
 export const GOAL_VERSION = 1;
 const FILE_HASH_CHUNK_SIZE = 64 * 1024;
 export const FILE_HASH_LIMIT = 64 * 1024 * 1024;
+const graphemeSegmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 type OpenGoalFile = (filePath: string) => Promise<FileHandle>;
 const openGoalFile: OpenGoalFile = (filePath) => open(filePath, "r");
 
@@ -84,6 +85,14 @@ function isMaxTurns(value: unknown): value is number {
   return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= GOAL_MAX_TURNS;
 }
 
+function exceedsBlockerEvidenceLimit(value: string): boolean {
+  let length = 0;
+  for (const _ of graphemeSegmenter.segment(value)) {
+    if (++length > 2_000) return true;
+  }
+  return false;
+}
+
 function isGoalBlockerAudit(value: unknown, turns: number, status: GoalStatus): value is GoalBlockerAudit {
   if (!isUnknownRecord(value)
     || typeof value.key !== "string"
@@ -91,7 +100,7 @@ function isGoalBlockerAudit(value: unknown, turns: number, status: GoalStatus):
     || typeof value.streak !== "number" || !Number.isInteger(value.streak) || value.streak < 1 || value.streak > 3
     || typeof value.lastTurn !== "number" || !Number.isInteger(value.lastTurn) || value.lastTurn < 1 || value.lastTurn > turns
     || value.evidence !== undefined && (typeof value.evidence !== "string"
-      || value.evidence !== value.evidence.trim() || !value.evidence || value.evidence.length > 2_000)) {
+      || value.evidence !== value.evidence.trim() || !value.evidence || exceedsBlockerEvidenceLimit(value.evidence))) {
     return false;
   }
   if (status === "complete") return false;

package/killeros/init-target.ts

@@ -155,12 +155,12 @@ async function pathExists(filePath: string): Promise<boolean> {
 }
 
 /** Installs generated guidance atomically and preserves any target changed after baseline capture. */
-export async function installInitAgentsFile(
+export async function installInitAgentsFileWithRecovery(
   targetPath: string,
   content: string,
   baseline: InitTargetBaseline,
   operations: InitInstallOperations = {},
-): Promise<void> {
+): Promise<string | undefined> {
   const validationError = validateGeneratedGuidance(content);
   if (validationError) throw new Error(validationError);
   const renameFile = operations.renameFile ?? fs.rename;
@@ -208,8 +208,8 @@ export async function installInitAgentsFile(
         return;
       }
 
-      // Node cannot lock arbitrary external writers. The exclusive links, held-target
-      // boundary, final held-file hash, and Pi mutation queue make installation fail closed.
+      // Node cannot lock arbitrary external writers, so keep the original inode named
+      // after commit. Writers with an open handle then remain recoverable.
       await renameFile(targetPath, heldPath);
       held = true;
       const moved = await captureExistingTarget(heldPath);
@@ -242,10 +242,12 @@ export async function installInitAgentsFile(
       if (!sameBaseline(finalHeld, baseline) || !await installedCandidateMatches(targetPath, candidate)) {
         throw new Error("/init target changed while /init was generating; the newer AGENTS.md was preserved");
       }
-      await unlinkFile(heldPath);
+      retainedRecovery = recoveryPath(targetPath);
+      await renameFile(heldPath, retainedRecovery);
       held = false;
       await removeCandidateName(candidatePath, unlinkFile);
       installed = false;
+      return retainedRecovery;
     } catch (error) {
       if (held) {
         if (installed && candidate && await installedCandidateMatches(targetPath, candidate)) {
@@ -288,6 +290,15 @@ export async function installInitAgentsFile(
   });
 }
 
+export async function installInitAgentsFile(
+  targetPath: string,
+  content: string,
+  baseline: InitTargetBaseline,
+  operations: InitInstallOperations = {},
+): Promise<void> {
+  await installInitAgentsFileWithRecovery(targetPath, content, baseline, operations);
+}
+
 export async function writeInitAgentsFile(
   targetPath: string,
   content: string,

package/killeros/init.ts

@@ -13,7 +13,7 @@ import {
 } from "./init-evidence.ts";
 import {
   captureInitTargetBaseline,
-  installInitAgentsFile,
+  installInitAgentsFileWithRecovery,
   validateGeneratedGuidance,
 } from "./init-target.ts";
 import { resetInitRuntime, type GoalRuntime, type InitOutcome, type InitRuntime } from "./runtime.ts";
@@ -109,11 +109,12 @@ export function registerInitCommand(pi: ExtensionAPI, initState: InitRuntime, go
       if (!initState.targetPath || !initState.baseline) throw new Error("/init target baseline is unavailable");
       const validationError = validateGeneratedGuidance(content);
       if (validationError) throw new Error(validationError);
-      await installInitAgentsFile(initState.targetPath, content, initState.baseline);
-      initState.outcome = { kind: "written" };
+      const recoveryPath = await installInitAgentsFileWithRecovery(initState.targetPath, content, initState.baseline);
+      initState.outcome = { kind: "written", ...(recoveryPath ? { recoveryPath } : {}) };
+      const recoveryNotice = recoveryPath ? ` Previous AGENTS.md preserved at ${safeTerminalText(recoveryPath)}.` : "";
       return {
-        content: [{ type: "text" as const, text: "Generated root AGENTS.md; read it once with killeros_init_read." }],
-        details: { path: initState.targetPath },
+        content: [{ type: "text" as const, text: `Generated root AGENTS.md.${recoveryNotice} Read it once with killeros_init_read.` }],
+        details: { path: initState.targetPath, ...(recoveryPath ? { recoveryPath } : {}) },
       };
     },
   });
@@ -244,6 +245,9 @@ export function registerInitCommand(pi: ExtensionAPI, initState: InitRuntime, go
       const outcome = await settled;
       switch (outcome.kind) {
         case "written":
+          if (outcome.recoveryPath) {
+            ctx.ui.notify(`/init preserved the previous AGENTS.md at ${safeTerminalText(outcome.recoveryPath)}`, "info");
+          }
           await new Promise<void>((resolve) => setImmediate(resolve));
           try {
             await ctx.reload();

package/killeros/runtime.ts

@@ -3,7 +3,7 @@ import type { InitTargetBaseline } from "./init-target.ts";
 
 export type InitOutcome =
   | { kind: "pending" }
-  | { kind: "written" }
+  | { kind: "written"; recoveryPath?: string }
   | { kind: "policy-conflict"; reason: string }
   | { kind: "cancelled" }
   | { kind: "no-outcome" };

package/package.json

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