killeros 2.0.21 → 2.1.22

package/CHANGELOG.md

@@ -4,6 +4,41 @@ All notable changes to KillerOS are documented here.
 
 ## [Unreleased]
 
+## [2.1.22] - 2026-09-03
+
+### Added
+
+- Added named goal completion checks, per-goal turn limits, and branch-aware `/goal history`.
+- Added per-response TUI receipts for net Git changes and recognized verification results.
+
+### Changed
+
+- Defaulted new goals to 20 turns, added safe `/goal checks` discovery, preserved blocker evidence in history, and separated pure goal parsing and history formatting.
+- Refreshed footer Git telemetry from throttled filesystem changes instead of every completed turn, while retaining branch and 30-second fallback scans.
+
+### Fixed
+
+- Prevented Linux CI test workers from waiting indefinitely on extension-owned handles after their tests finish.
+- Made change receipts use a final repository scan, disable current Git filters, report line-ending-only edits, and recheck file goals after completion commands.
+- Released automatic-compaction request state when Pi rejects an ordinary continuation before accepting its hidden message.
+- Resumed ordinary tasks exactly once after automatic compaction and interrupted-turn settlement, keeping the hidden continuation pending until Pi accepts it.
+- Allowed Git footer scans up to five seconds, contained rejected refreshes, and kept the last successful file-change status after transient failures.
+- Recorded only exact check commands in response receipts, replaced verification claims with observed-check copy, and reserved `/goal` command words so malformed controls cannot start objectives.
+- Rejected unsafe persisted goal counters, contained file-verification inference errors, and prevented stale completion checks from completing a newly restored goal.
+- Kept lifecycle hooks stable for corrupt payload serialization, `NaN` direct timeouts, abort races, stream errors, and synchronous process completion without tightening custom process adapter contracts.
+
+## [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/Killeros.ts

@@ -7,7 +7,9 @@ import {
   registerSlashAutocomplete,
 } from "./killeros/commands.ts";
 import { registerFooter } from "./killeros/footer.ts";
-import { registerGoal, registerGoalSettlement } from "./killeros/goals.ts";
+import { registerGoalInterface } from "./killeros/goal-interface.ts";
+import { registerGoalRuntime } from "./killeros/goal-runtime.ts";
+import { registerGoalSettlement } from "./killeros/goal-settlement.ts";
 import { registerHandoff } from "./killeros/handoff.ts";
 import { registerLifecycleHooks } from "./killeros/hooks.ts";
 import { registerInitCommand, registerInitSettlement } from "./killeros/init.ts";
@@ -39,7 +41,8 @@ export default function Killeros(pi: ExtensionAPI, options: KillerosOptions = {}
   const goalRuntime = createGoalRuntime();
   const commandResolver = createSlashCommandResolver(pi);
   registerShellUi(pi, commandResolver);
-  registerGoal(pi, goalRuntime, initRuntime);
+  registerGoalInterface(pi, goalRuntime, initRuntime);
+  registerGoalRuntime(pi, goalRuntime, initRuntime);
   registerPersonalInstructions(pi, initRuntime);
   registerQuestionTool(pi);
   registerAliases(pi);

package/README.md

@@ -5,7 +5,7 @@ A TypeScript extension for the [Pi coding agent](https://github.com/earendil-wor
 ## What you get
 
 - A custom TUI: startup card with version, model, provider, working directory, and Git branch; a dark theme with coral accents; a multiline editor with slash-command completion; a footer that tracks model, context, and goal state; settled task receipts with duration and token usage.
-- `/goal`: set an objective and Pi keeps working toward it across turns, compaction, reloads, and branch navigation. Pause, resume, edit, or clear it anytime.
+- `/goal`: set an objective and Pi keeps working toward it across turns, compaction, reloads, and branch navigation. New goals default to 20 turns. Named checks and turn limits control completion and unattended work.
 - `/init`: generates a root `AGENTS.md` from repository evidence, preserving compatible existing rules.
 - `/variants`: pick a reasoning level supported by the active model.
 - `/codex-fast`: toggles the `priority` service tier on Codex requests.
@@ -34,13 +34,18 @@ 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.1.22`. Add `-l` to install only for the current project. Restart Pi after installing.
 
 ## Commands
 
 ```text
 /init                     Generate root AGENTS.md from repository evidence
-/goal                     Open goal status, or set an objective with /goal <objective>
+/goal                     Open status, or set with /goal <objective>
+/goal start [--check name] [--turns count] -- <objective>
+/goal check <name|clear>  Set or clear a named completion check
+/goal checks              List configured completion-check names
+/goal limit <count|clear> Set a limit or clear it for unlimited turns
+/goal history [count]     Show transitions and blocker evidence on this branch
 /goal edit|pause|resume|clear
 /variants                 Reasoning-level selector (/variants high sets directly)
 /codex-fast               Toggle Codex fast mode
@@ -74,6 +79,23 @@ The packaged `killeros` theme activates on TUI start. Compaction triggers by def
 
 `handoffMaxTokens` caps the `/handoff` summary output at 8192 tokens by default; raise it when long sessions truncate the summary.
 
+Trusted projects can define up to 32 named goal checks in `.pi/killeros-hooks.json`:
+
+```json
+{
+  "goalChecks": {
+    "quality": {
+      "command": "npm run check && npm test",
+      "timeoutMs": 300000
+    }
+  }
+}
+```
+
+Use `/goal checks` to list configured names. Use `/goal start -- <objective>` when an objective begins with `start`, `check`, `checks`, `limit`, `history`, `clear`, `edit`, `pause`, or `resume`. Bind a check with `/goal start --check quality -- <objective>` or `/goal check quality`. KillerOS stores the check name and definition hash, not the command. If the project changes the command or timeout, bind the check again before completing the goal.
+
+New goals use a 20-turn limit unless `/goal start --turns <count> -- <objective>` supplies another value. Use `/goal limit <count>` to change the current goal or `/goal limit clear` to allow unlimited turns. Restored goals keep their persisted limit.
+
 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

@@ -35,10 +35,16 @@ export interface AutoCompactionDependencies {
   goal?: AutoCompactionGoalHandlers;
 }
 
-interface AutoCompactionRequest {
+type AutoCompactionRequest = {
+  phase: "compacting";
   goal: boolean;
   token: symbol;
-}
+  turnSettled: boolean;
+  compactionCompleted: boolean;
+} | {
+  phase: "continuation-dispatched";
+  goal: false;
+};
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
@@ -157,7 +163,7 @@ export function registerAutoCompaction(
     goal: boolean,
     error: unknown,
   ): void => {
-    if (!request || request.token !== token) return;
+    if (request?.phase !== "compacting" || request.token !== token) return;
     if (isSessionTooSmallCompactionError(error)) {
       finishSkip(ctx, goal);
       return;
@@ -165,6 +171,26 @@ export function registerAutoCompaction(
     finishFailure(ctx, goal, error);
   };
 
+  /** Dispatches one ordinary continuation after compaction and the interrupted run have both finished. */
+  const finalizeOrdinaryContinuation = (ctx: ExtensionContext, token: symbol): void => {
+    if (request?.phase !== "compacting"
+      || request.token !== token
+      || request.goal
+      || !request.turnSettled
+      || !request.compactionCompleted) return;
+    request = { phase: "continuation-dispatched", goal: false };
+    try {
+      pi.sendMessage({
+        customType: AUTO_COMPACTION_MESSAGE_TYPE,
+        content: AUTO_COMPACTION_MESSAGE,
+        display: false,
+      }, { triggerTurn: true, deliverAs: "followUp" });
+    } catch (error) {
+      request = undefined;
+      notifyFailure(ctx, error);
+    }
+  };
+
   pi.on("turn_end", (_event, ctx) => {
     if (!supportedMode(ctx) || request) return;
 
@@ -204,7 +230,13 @@ export function registerAutoCompaction(
     armed = false;
     const token = Symbol();
     const goal = dependencies.goal?.isActive(ctx) === true;
-    request = { goal, token };
+    request = {
+      phase: "compacting",
+      goal,
+      token,
+      turnSettled: false,
+      compactionCompleted: false,
+    };
     if (goal && dependencies.goal) {
       try {
         dependencies.goal.onRequested();
@@ -217,9 +249,9 @@ export function registerAutoCompaction(
     try {
       ctx.compact({
         onComplete: () => {
-          if (!request || request.token !== token) return;
-          request = undefined;
+          if (request?.phase !== "compacting" || request.token !== token) return;
           if (goal && dependencies.goal) {
+            request = undefined;
             try {
               dependencies.goal.onCompleted(ctx);
             } catch (error) {
@@ -227,15 +259,8 @@ export function registerAutoCompaction(
             }
             return;
           }
-          try {
-            pi.sendMessage({
-              customType: AUTO_COMPACTION_MESSAGE_TYPE,
-              content: AUTO_COMPACTION_MESSAGE,
-              display: false,
-            }, { triggerTurn: true, deliverAs: "followUp" });
-          } catch (error) {
-            notifyFailure(ctx, error);
-          }
+          request.compactionCompleted = true;
+          finalizeOrdinaryContinuation(ctx, token);
         },
         onError: (error) => finishRequestError(ctx, token, goal, error),
       });
@@ -244,6 +269,22 @@ export function registerAutoCompaction(
     }
   });
 
+  pi.on("agent_settled", (_event, ctx) => {
+    if (request?.phase === "continuation-dispatched") {
+      request = undefined;
+      notifyFailure(ctx, new Error("continuation was not accepted"));
+      return;
+    }
+    if (request?.phase !== "compacting" || request.goal) return;
+    request.turnSettled = true;
+    finalizeOrdinaryContinuation(ctx, request.token);
+  });
+  pi.on("message_start", (event) => {
+    if (request?.phase === "continuation-dispatched"
+      && event.message.role === "custom"
+      && event.message.customType === AUTO_COMPACTION_MESSAGE_TYPE) request = undefined;
+  });
+
   pi.on("session_start", resetForLifecycle);
   pi.on("session_shutdown", resetForLifecycle);
   pi.on("session_tree", resetForLifecycle);