killeros 2.0.18 → 2.0.20

package/killeros/runtime.ts

@@ -38,31 +38,66 @@ export interface GoalFileVerification {
   baseline: GoalFileBaseline;
 }
 
-export interface GoalState {
+export interface GoalStateCommon {
   version: 1;
   revision: number;
   objective: string;
-  status: GoalStatus;
   createdAt: number;
   updatedAt: number;
   activeMilliseconds: number;
-  activeStartedAt?: number;
   turns: number;
   blockedAuditStartTurn: number;
   baselineTokens: number;
-  result?: string;
-  resumeAfterManualCompaction?: true;
-  blockerAudit?: GoalBlockerAudit;
   verification?: GoalFileVerification;
 }
 
+export type GoalState = GoalStateCommon & (
+  | {
+      status: "active";
+      activeStartedAt: number;
+      result?: string;
+      blockerAudit?: GoalBlockerAudit;
+      resumeAfterManualCompaction?: never;
+    }
+  | {
+      status: "paused";
+      activeStartedAt?: never;
+      result?: string;
+      blockerAudit?: GoalBlockerAudit;
+      resumeAfterManualCompaction?: true;
+    }
+  | {
+      status: "blocked";
+      activeStartedAt?: never;
+      result: string;
+      blockerAudit?: GoalBlockerAudit;
+      resumeAfterManualCompaction?: never;
+    }
+  | {
+      status: "complete";
+      activeStartedAt?: never;
+      result: string;
+      blockerAudit?: never;
+      resumeAfterManualCompaction?: never;
+    }
+);
+
+/** Pi request outcomes for goal recovery: awaiting result, compacted, or rejected as session-too-small. */
+export type AutomaticGoalCompactionOutcome = "pending" | "completed" | "skipped";
+
+export interface AutomaticGoalCompaction {
+  pausedRevision: number;
+  outcome: AutomaticGoalCompactionOutcome;
+  turnSettled: boolean;
+}
+
 export interface GoalRuntime {
   state?: GoalState;
   continuationScheduled: boolean;
   continuationHeld: boolean;
   goalTurnInFlight: boolean;
   agentEndObserved: boolean;
-  automaticCompaction?: "pending";
+  automaticCompaction?: AutomaticGoalCompaction;
   persistenceRetryNeeded: boolean;
   lastStopReason?: string;
   lastError?: string;

package/killeros/settings.ts

@@ -2,6 +2,7 @@ import { randomUUID } from "node:crypto";
 import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { hasErrorCode } from "./errors.ts";
 
 export type KillerosSettings = Record<string, unknown>;
 
@@ -10,15 +11,17 @@ export interface KillerosSettingsStore {
   update(patch: Readonly<Record<string, unknown>>): void;
 }
 
+function isSettings(value: unknown): value is KillerosSettings {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 function readStoredSettings(settingsPath: string): KillerosSettings {
   try {
     const parsed: unknown = JSON.parse(readFileSync(settingsPath, "utf8"));
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      throw new Error("KillerOS settings must contain a JSON object");
-    }
-    return parsed as KillerosSettings;
+    if (!isSettings(parsed)) throw new Error("KillerOS settings must contain a JSON object");
+    return parsed;
   } catch (error) {
-    if ((error as NodeJS.ErrnoException).code === "ENOENT") return {};
+    if (hasErrorCode(error, "ENOENT")) return {};
     throw error;
   }
 }

package/killeros/shell-ui.ts

@@ -2,7 +2,6 @@ import { execFile } from "node:child_process";
 import { readFileSync } from "node:fs";
 import {
   CustomEditor,
-  VERSION,
   type ExtensionAPI,
   type ExtensionContext,
   type KeybindingsManager,
@@ -25,14 +24,19 @@ import {
 } from "./commands.ts";
 import { reportError } from "./errors.ts";
 import { formatModel } from "./footer.ts";
-import { LEVEL_COLORS, type ThinkingLevel } from "./variants.ts";
+import { LEVEL_COLORS } from "./variants.ts";
 
 const COMPACT_HEADER_MAX_WIDTH = 52;
 
 function readPackageVersion(path: string | URL): string | undefined {
   try {
-    const value = JSON.parse(readFileSync(path, "utf8")) as { version?: unknown };
-    return typeof value.version === "string" ? value.version : undefined;
+    const value: unknown = JSON.parse(readFileSync(path, "utf8"));
+    return typeof value === "object"
+      && value !== null
+      && "version" in value
+      && typeof value.version === "string"
+      ? value.version
+      : undefined;
   } catch {
     return undefined;
   }
@@ -93,7 +97,11 @@ function shuffledDeck(values: readonly string[]): string[] {
   const deck = [...values];
   for (let index = deck.length - 1; index > 0; index -= 1) {
     const swapIndex = Math.floor(Math.random() * (index + 1));
-    [deck[index], deck[swapIndex]] = [deck[swapIndex]!, deck[index]!];
+    const current = deck[index];
+    const swap = deck[swapIndex];
+    if (current === undefined || swap === undefined) continue;
+    deck[index] = swap;
+    deck[swapIndex] = current;
   }
   return deck;
 }
@@ -152,7 +160,7 @@ class PiStartupHeader {
     const innerWidth = panelWidth - 4;
     const version = KILLEROS_VERSION ? theme.fg("dim", ` (v${KILLEROS_VERSION})`) : "";
     const identity = `${theme.fg("dim", "›")} ${theme.fg("text", theme.bold("KillerOS"))}${version}`;
-    const thinkingLevel = this.pi.getThinkingLevel() as ThinkingLevel;
+    const thinkingLevel = this.pi.getThinkingLevel();
     const reasoning = this.ctx.model?.reasoning === false
       ? theme.fg("thinkingOff", "no reasoning")
       : theme.fg(LEVEL_COLORS[thinkingLevel], thinkingLevel);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "killeros",
-  "version": "2.0.18",
+  "version": "2.0.20",
   "description": "TUI, goals, and workflow automation for the Pi coding agent",
   "type": "module",
   "keywords": [
@@ -30,7 +30,8 @@
     "node": ">=22.19.0"
   },
   "scripts": {
-    "check": "tsc --noEmit",
+    "check": "tsc --noEmit && eslint .",
+    "lint": "eslint .",
     "test": "node --test --experimental-strip-types test/*.test.*"
   },
   "pi": {
@@ -52,8 +53,10 @@
     "@earendil-works/pi-coding-agent": "0.84.3",
     "@earendil-works/pi-tui": "0.84.3",
     "@types/node": "24.12.4",
+    "eslint": "^10.9.1",
     "typebox": "1.1.38",
-    "typescript": "5.9.3"
+    "typescript": "5.9.3",
+    "typescript-eslint": "^8.68.0"
   },
   "overrides": {
     "brace-expansion": "5.0.9",