killeros 2.0.22 → 2.1.23

package/CHANGELOG.md

@@ -4,6 +4,41 @@ All notable changes to KillerOS are documented here.
 
 ## [Unreleased]
 
+## [2.1.23] - 2026-09-04
+
+### Changed
+
+- Simplified `/goal` to five forms with proof-by-prose and silent file proof, removing configured completion checks.
+
+### Fixed
+
+- Kept the automatic 20-turn goal pause silent as documented.
+- Stripped sentence punctuation from unquoted inferred goal paths and picked token units after rounding so 999.6 shows as 1k and 999999 as 1M.
+- Increased change-receipt Git timeouts to five seconds and stopped timeout failures from showing warning notifications.
+
+## [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

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 pause after 20 turns; `/goal resume` grants another 20.
 - `/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,14 +34,17 @@ Or from GitHub:
 pi install git:github.com/KyrosHendrix/pi-KillerOS
 ```
 
-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.
+Pin a release by appending its tag, for example `@v2.1.23`. 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 edit|pause|resume|clear
+/goal                     View the current goal
+/goal <objective>        Set an objective
+/goal pause               Stop automatic continuation
+/goal resume              Resume automatic continuation
+/goal clear               Remove the current goal
 /variants                 Reasoning-level selector (/variants high sets directly)
 /codex-fast               Toggle Codex fast mode
 /notification             Configure the completion sound
@@ -55,7 +58,7 @@ Pin a release by appending its tag, for example `@v2.0.22`. Add `-l` to install
 | Mode | What works |
 | --- | --- |
 | TUI | Everything |
-| RPC | Goals, proactive compaction; no TUI components, `/goal edit`, `/init`, sounds, title indicator |
+| RPC | Goals, proactive compaction; no TUI components, `/init`, sounds, title indicator |
 | Print/JSON | No interactive questions, `/goal`, `/init`, or proactive compaction |
 
 ## Configuration
@@ -74,6 +77,20 @@ 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.
 
+State proof in the objective so the agent can verify it with its normal tools:
+
+```text
+/goal Reduce p95 checkout latency below 120 ms, verified by the checkout benchmark, while keeping the correctness suite green
+```
+
+A direct quoted file target binds silent file proof:
+
+```text
+/goal Fix `killeros/footer.ts`, verified by npm test
+```
+
+KillerOS captures the file baseline at goal start and only completes when the file is created or changed. New goals pause after 20 turns without warning. An explicit `/goal resume` on an exhausted goal grants another 20 turns; compaction recovery never grants 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);