killeros 2.0.16 → 2.0.17

package/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to KillerOS are documented here.
 
 ## [Unreleased]
 
+## [2.0.17] - 2026-08-23
+
+### Added
+
+- Added per-task token usage to settled TUI receipts for ordinary requests and individual goal turns.
+
+### Changed
+
+- Limited push CI to `main` and `dev`; feature branches run through pull request CI without duplicate push runs.
+- Removed obsolete Pi tool API casts, shared caught-error formatting, and expanded the non-repeating startup tip and editor suggestion banks.
+- Clarified that the README's pinned Git tag is an example rather than the current package version.
+
+### Fixed
+
+- Limited retired-feature repository checks to tracked and non-ignored files so ignored private notes cannot fail the suite.
+
 ## [2.0.16] - 2026-08-23
 
 ### Fixed

package/Killeros.ts

@@ -48,10 +48,10 @@ export default function Killeros(pi: ExtensionAPI, options: KillerosOptions = {}
   registerCodexFastMode(pi);
   registerInitCommand(pi, initRuntime, goalRuntime);
   registerLifecycleHooks(pi);
+  registerWorkedFor(pi);
   const goalCompaction = registerGoalSettlement(pi, goalRuntime, initRuntime);
   registerAutoCompaction(pi, { goal: goalCompaction });
   registerInitSettlement(pi, initRuntime);
   registerRequestActivity(pi);
   registerCompletionNotifications(pi, options.completionNotifications);
-  registerWorkedFor(pi);
 }

package/README.md

@@ -4,7 +4,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.
+- 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.
 - `/init`: generates a root `AGENTS.md` from repository evidence, preserving compatible existing rules.
 - `/variants`: pick a reasoning level supported by the active model.
@@ -34,7 +34,7 @@ Or from GitHub:
 pi install git:github.com/KyrosHendrix/pi-KillerOS
 ```
 
-Pin a version with `@v2.0.16`, add `-l` to install only for the current project. Restart Pi after installing.
+Pin a release by appending its tag, for example `@v2.0.17`. Add `-l` to install only for the current project. Restart Pi after installing.
 
 ## Commands
 

package/killeros/auto-compaction.ts

@@ -6,6 +6,7 @@ import {
   type ExtensionAPI,
   type ExtensionContext,
 } from "@earendil-works/pi-coding-agent";
+import { errorMessage } from "./errors.ts";
 import { createKillerosSettingsStore } from "./settings.ts";
 
 export const DEFAULT_AUTO_COMPACTION_PERCENT_REMAINING = 15;
@@ -71,6 +72,7 @@ function reserveTokens(settings: Pick<CompactionSettings, "reserveTokens">): num
     : 0;
 }
 
+/** Triggers at the stricter of the user's percentage and Pi's token reserve. */
 export function shouldTriggerAutoCompaction(
   usage: Pick<ContextUsage, "tokens" | "contextWindow"> | undefined,
   preference: AutoCompactionPreference,
@@ -90,10 +92,6 @@ export function shouldTriggerAutoCompaction(
   return remainingTokens <= threshold;
 }
 
-function errorMessage(error: unknown): string {
-  return error instanceof Error ? error.message : String(error);
-}
-
 function supportedMode(ctx: ExtensionContext): boolean {
   return ctx.mode === "tui" || ctx.mode === "rpc";
 }

package/killeros/errors.ts

@@ -1,6 +1,10 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 
+/** Converts unknown caught values into text suitable for user-facing errors. */
+export function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}
+
 export function reportError(ctx: ExtensionContext, area: string, error: unknown): void {
-  const message = error instanceof Error ? error.message : String(error);
-  ctx.ui.notify(`${area}: ${message}`, "error");
+  ctx.ui.notify(`${area}: ${errorMessage(error)}`, "error");
 }

package/killeros/goals.ts

@@ -5,7 +5,6 @@ import path from "node:path";
 import { type ExtensionAPI, type ExtensionCommandContext, type ExtensionContext, type ThemeColor } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
-import { MAX_NODE_TIMER_MS } from "./limits.ts";
 import { BoundedText } from "./bounded-text.ts";
 import { formatTime, formatTokens } from "./display.ts";
 import { reportError } from "./errors.ts";
@@ -131,6 +130,7 @@ function captureGoalFileBaseline(filePath: string): GoalFileBaseline {
   }
 }
 
+/** Captures one explicit absolute output path so goal completion can verify its creation or modification. */
 function inferGoalVerification(objective: string): GoalFileVerification | undefined {
   const destination = /\b(?:create|write|save|generate)\b[^\r\n]{0,160}?\b(?:file|document|markdown|report|spreadsheet|presentation|image)\b\s+(?:to|at|as|destination(?:\s+is)?|output(?:\s+(?:to|at))?)\b\s*(?:`([^`\r\n]+)`|"([^"\r\n]+)"|'([^'\r\n]+)'|([A-Za-z]:\\[^\s,;]+|\/[^\s,;]+))/giu;
   const paths = [...objective.matchAll(destination)]
@@ -283,12 +283,10 @@ function sumGoalTokens(ctx: ExtensionContext): number {
 }
 
 function setGoalUpdateToolActive(pi: ExtensionAPI, active: boolean): void {
-  const api = pi as ExtensionAPI & { getActiveTools?: () => string[]; setActiveTools?: (names: string[]) => void };
-  if (!api.getActiveTools || !api.setActiveTools) return;
-  const activeTools = api.getActiveTools();
+  const activeTools = pi.getActiveTools();
   const isActive = activeTools.includes(GOAL_UPDATE_TOOL);
   if (active === isActive) return;
-  api.setActiveTools(active
+  pi.setActiveTools(active
     ? [...activeTools, GOAL_UPDATE_TOOL]
     : activeTools.filter((name) => name !== GOAL_UPDATE_TOOL));
 }
@@ -495,6 +493,7 @@ function beginGoalTurn(
   return next;
 }
 
+/** Starts one goal turn only after Pi is idle and all competing workflow gates are clear. */
 function scheduleGoalContinuation(
   pi: ExtensionAPI,
   runtime: GoalRuntime,

package/killeros/init-target.ts

@@ -146,6 +146,7 @@ async function pathExists(filePath: string): Promise<boolean> {
   }
 }
 
+/** Installs generated guidance atomically and preserves any target changed after baseline capture. */
 export async function installInitAgentsFile(
   targetPath: string,
   content: string,

package/killeros/init.ts

@@ -47,16 +47,14 @@ After a successful write, read generated AGENTS.md once through killeros_init_re
 `.trim();
 
 function setInitTools(pi: ExtensionAPI, initState: InitRuntime, active: boolean): void {
-  const runtime = pi as ExtensionAPI & { getActiveTools?: () => string[]; setActiveTools?: (names: string[]) => void };
-  if (!runtime.getActiveTools || !runtime.setActiveTools) return;
   if (active) {
-    initState.activeTools ??= runtime.getActiveTools().filter((name) => !INIT_SCOPED_TOOLS.includes(name as (typeof INIT_SCOPED_TOOLS)[number]));
-    runtime.setActiveTools([...INIT_SCOPED_TOOLS]);
+    initState.activeTools ??= pi.getActiveTools().filter((name) => !INIT_SCOPED_TOOLS.includes(name as (typeof INIT_SCOPED_TOOLS)[number]));
+    pi.setActiveTools([...INIT_SCOPED_TOOLS]);
   } else if (initState.activeTools) {
-    runtime.setActiveTools(initState.activeTools);
+    pi.setActiveTools(initState.activeTools);
     initState.activeTools = undefined;
   } else {
-    runtime.setActiveTools(runtime.getActiveTools().filter((name) => !INIT_SCOPED_TOOLS.includes(name as (typeof INIT_SCOPED_TOOLS)[number])));
+    pi.setActiveTools(pi.getActiveTools().filter((name) => !INIT_SCOPED_TOOLS.includes(name as (typeof INIT_SCOPED_TOOLS)[number])));
   }
 }
 

package/killeros/notifications.ts

@@ -4,6 +4,7 @@ import {
   type ExtensionAPI,
   type ExtensionContext,
 } from "@earendil-works/pi-coding-agent";
+import { errorMessage } from "./errors.ts";
 import { createKillerosSettingsStore } from "./settings.ts";
 
 export interface NotificationPreferenceStore {
@@ -40,10 +41,6 @@ export function formatNotificationTitle(
   return enabled ? `${base} ${COMPLETION_BELL_GLYPH}` : base;
 }
 
-function errorMessage(error: unknown): string {
-  return error instanceof Error ? error.message : String(error);
-}
-
 export function registerCompletionNotifications(
   pi: ExtensionAPI,
   dependencies?: CompletionNotificationDependencies,

package/killeros/shell-ui.ts

@@ -45,6 +45,12 @@ const STARTUP_TIPS = [
   "Run /variants to tune the model's reasoning depth.",
   "Type / to browse every command available in this session.",
   "Run /notification to enable a terminal bell when work settles.",
+  "Run /goal <objective> to keep long-running work moving across turns.",
+  "Run /init to generate root AGENTS.md from bounded repository evidence.",
+  "Run /handoff [focus] to continue work in a fresh linked session.",
+  "Run /codex-fast to toggle priority requests for Codex models.",
+  "Run /clear to start a fresh session after confirmation.",
+  "Ask the agent to show a short choice list when you need to decide.",
 ] as const;
 
 const EDITOR_SUGGESTIONS = [
@@ -52,6 +58,12 @@ const EDITOR_SUGGESTIONS = [
   'Try "find edge cases in <filepath>"',
   'Try "simplify <filepath> without changing behavior"',
   'Try "write tests for <filepath>"',
+  'Try "trace this failure to its first bad state"',
+  'Try "review this diff against <spec>"',
+  'Try "explain why this test fails"',
+  'Try "find the smallest safe fix for <issue>"',
+  'Try "map the data flow through <feature>"',
+  'Try "draft an implementation plan for <feature>"',
 ] as const;
 
 export function resolveGitBranch(cwd: string): Promise<string | undefined> {
@@ -216,6 +228,7 @@ function extractTerminalSequence(text: string, position: number): { code: string
   return undefined;
 }
 
+/** Styles valid slash-command tokens while preserving embedded terminal control sequences. */
 export function highlightSlashCommands(
   line: string,
   isValidCommand: (name: string) => boolean,

package/killeros/worked-for.ts

@@ -1,6 +1,8 @@
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { StopReason } from "@earendil-works/pi-ai";
 import { Text } from "@earendil-works/pi-tui";
+import { formatTokens } from "./display.ts";
+import { errorMessage } from "./errors.ts";
 
 const WORKED_FOR_ENTRY_TYPE = "killeros-worked-for";
 
@@ -17,7 +19,14 @@ interface WorkedForEntryDataV2 {
   outcome: WorkedForOutcome;
 }
 
-type WorkedForEntryData = WorkedForEntryDataV1 | WorkedForEntryDataV2;
+interface WorkedForEntryDataV3 {
+  version: 3;
+  milliseconds: number;
+  outcome: WorkedForOutcome;
+  tokens: number;
+}
+
+type WorkedForEntryData = WorkedForEntryDataV1 | WorkedForEntryDataV2 | WorkedForEntryDataV3;
 
 const OUTCOMES = {
   done: { marker: "✓", label: "Done", color: "success" },
@@ -29,6 +38,23 @@ function isWorkedForOutcome(value: unknown): value is WorkedForOutcome {
   return value === "done" || value === "stopped" || value === "failed";
 }
 
+function sessionTokenTotal(ctx: ExtensionContext): number | undefined {
+  try {
+    let total = 0;
+    for (const entry of ctx.sessionManager.getEntries()) {
+      const tokens = entry.type === "message" && (entry.message.role === "assistant" || entry.message.role === "toolResult")
+        ? entry.message.usage?.totalTokens
+        : (entry.type === "compaction" || entry.type === "branch_summary")
+          ? entry.usage?.totalTokens
+          : undefined;
+      if (typeof tokens === "number" && Number.isFinite(tokens) && tokens > 0) total += tokens;
+    }
+    return total;
+  } catch {
+    return undefined;
+  }
+}
+
 export function formatWorkedForDuration(milliseconds: number): string {
   const boundedMilliseconds = Number.isFinite(milliseconds) ? Math.max(0, milliseconds) : 0;
   const totalSeconds = Math.max(1, Math.floor(boundedMilliseconds / 1_000));
@@ -49,10 +75,11 @@ function parseWorkedForEntryData(data: unknown): WorkedForEntryData | undefined
     return undefined;
   }
   if (data.version === 1) return { version: 1, milliseconds: data.milliseconds };
-  if (data.version !== 2 || !("outcome" in data) || !isWorkedForOutcome(data.outcome)) {
-    return undefined;
-  }
-  return { version: 2, milliseconds: data.milliseconds, outcome: data.outcome };
+  if (!("outcome" in data) || !isWorkedForOutcome(data.outcome)) return undefined;
+  if (data.version === 2) return { version: 2, milliseconds: data.milliseconds, outcome: data.outcome };
+  if (data.version !== 3 || !("tokens" in data)
+    || typeof data.tokens !== "number" || !Number.isFinite(data.tokens) || data.tokens < 0) return undefined;
+  return { version: 3, milliseconds: data.milliseconds, outcome: data.outcome, tokens: data.tokens };
 }
 
 export function workedForOutcome(stopReason: StopReason | undefined): WorkedForOutcome {
@@ -61,15 +88,12 @@ export function workedForOutcome(stopReason: StopReason | undefined): WorkedForO
   return "failed";
 }
 
-function errorMessage(error: unknown): string {
-  return error instanceof Error ? error.message : String(error);
-}
-
 export function registerWorkedFor(
   pi: ExtensionAPI,
   now: () => number = Date.now,
 ): void {
   let startedAt: number | undefined;
+  let startedTokens: number | undefined;
   let stopReason: StopReason | undefined;
 
   pi.registerEntryRenderer<WorkedForEntryData>(WORKED_FOR_ENTRY_TYPE, (entry, _options, theme) => {
@@ -83,8 +107,9 @@ export function registerWorkedFor(
       );
     }
     const outcome = OUTCOMES[data.outcome];
+    const tokens = data.version === 3 ? ` · ↑ ${formatTokens(data.tokens)} tokens` : "";
     return new Text(
-      `${theme.fg(outcome.color, `${outcome.marker} ${outcome.label}`)}${theme.fg("dim", ` · ${formatWorkedForDuration(data.milliseconds)}`)}`,
+      `${theme.fg(outcome.color, `${outcome.marker} ${outcome.label}`)}${theme.fg("dim", ` · ${formatWorkedForDuration(data.milliseconds)}${tokens}`)}`,
       0,
       0,
     );
@@ -92,12 +117,14 @@ export function registerWorkedFor(
 
   pi.on("session_start", () => {
     startedAt = undefined;
+    startedTokens = undefined;
     stopReason = undefined;
   });
 
   pi.on("agent_start", (_event, ctx) => {
     if (ctx.mode !== "tui" || startedAt !== undefined) return;
     startedAt = now();
+    startedTokens = sessionTokenTotal(ctx);
   });
 
   pi.on("agent_end", (event, ctx) => {
@@ -112,16 +139,21 @@ export function registerWorkedFor(
 
   pi.on("agent_settled", (_event, ctx) => {
     if (ctx.mode !== "tui" || startedAt === undefined) return;
-    if (!ctx.isIdle() || ctx.hasPendingMessages()) return;
     const milliseconds = Math.max(0, now() - startedAt);
+    const settledTokens = sessionTokenTotal(ctx);
+    const tokens = startedTokens === undefined || settledTokens === undefined
+      ? 0
+      : Math.max(0, settledTokens - startedTokens);
     const outcome = workedForOutcome(stopReason);
     startedAt = undefined;
+    startedTokens = undefined;
     stopReason = undefined;
     try {
-      pi.appendEntry<WorkedForEntryDataV2>(WORKED_FOR_ENTRY_TYPE, {
-        version: 2,
+      pi.appendEntry<WorkedForEntryDataV3>(WORKED_FOR_ENTRY_TYPE, {
+        version: 3,
         milliseconds,
         outcome,
+        tokens,
       });
     } catch (error) {
       ctx.ui.notify(`Worked-for timing could not be saved: ${errorMessage(error)}`, "error");
@@ -130,6 +162,7 @@ export function registerWorkedFor(
 
   pi.on("session_shutdown", () => {
     startedAt = undefined;
+    startedTokens = undefined;
     stopReason = undefined;
   });
 }

package/package.json

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

package/killeros/limits.ts

@@ -1 +0,0 @@
-export const MAX_NODE_TIMER_MS = 2_147_483_647;