killeros 2.1.29 → 2.1.31

package/Killeros.ts

@@ -1,53 +1,53 @@
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { registerRequestActivity } from "./killeros/activity.ts";
-import { registerAutoCompaction } from "./killeros/auto-compaction.ts";
-import {
-  createSlashCommandResolver,
-  registerAliases,
-  registerSlashAutocomplete,
-} from "./killeros/commands.ts";
-import { registerFooter } from "./killeros/footer.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 {
-  registerCompletionNotifications,
-  type CompletionNotificationDependencies,
-} from "./killeros/notifications.ts";
-import { registerCodexFastMode } from "./killeros/codex-fast.ts";
-import { registerPersonalInstructions } from "./killeros/personal-instructions.ts";
-import { registerQuestionTool } from "./killeros/question.ts";
-import { createGoalRuntime } from "./killeros/runtime.ts";
-import { registerShellUi } from "./killeros/shell-ui.ts";
-import { registerWorkedFor } from "./killeros/worked-for.ts";
-
-export { contextPercentRemaining, formatCost, formatContextProgress } from "./killeros/footer.ts";
-export { executeHook } from "./killeros/hooks.ts";
-export interface KillerosOptions {
-  completionNotifications?: CompletionNotificationDependencies;
-  /** Output-token budget for /handoff summaries; invalid values fall back to killeros.json, then the default. */
-  handoffMaxTokens?: number;
-}
-
-export default function Killeros(pi: ExtensionAPI, options: KillerosOptions = {}): void {
-  const goalRuntime = createGoalRuntime();
-  const commandResolver = createSlashCommandResolver(pi);
-  registerShellUi(pi, commandResolver);
-  registerGoalInterface(pi, goalRuntime);
-  registerGoalRuntime(pi, goalRuntime);
-  registerPersonalInstructions(pi);
-  registerQuestionTool(pi);
-  registerAliases(pi);
-  registerHandoff(pi, goalRuntime, options.handoffMaxTokens);
-  registerSlashAutocomplete(pi, commandResolver);
-  registerFooter(pi, goalRuntime);
-  registerCodexFastMode(pi);
-  registerLifecycleHooks(pi);
-  registerWorkedFor(pi);
-  const goalCompaction = registerGoalSettlement(pi, goalRuntime);
-  registerAutoCompaction(pi, { goal: goalCompaction });
-  registerRequestActivity(pi);
-  registerCompletionNotifications(pi, options.completionNotifications);
-}
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { registerRequestActivity } from "./killeros/activity.ts";
+import { registerAutoCompaction } from "./killeros/auto-compaction.ts";
+import {
+  createSlashCommandResolver,
+  registerAliases,
+  registerSlashAutocomplete,
+} from "./killeros/commands.ts";
+import { registerFooter } from "./killeros/footer.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 {
+  registerCompletionNotifications,
+  type CompletionNotificationDependencies,
+} from "./killeros/notifications.ts";
+import { registerCodexFastMode } from "./killeros/codex-fast.ts";
+import { registerPersonalInstructions } from "./killeros/personal-instructions.ts";
+import { registerQuestionTool } from "./killeros/question.ts";
+import { createGoalRuntime } from "./killeros/runtime.ts";
+import { registerShellUi } from "./killeros/shell-ui.ts";
+import { registerWorkedFor } from "./killeros/worked-for.ts";
+
+export { contextPercentRemaining, formatCost, formatContextProgress } from "./killeros/footer.ts";
+export { executeHook } from "./killeros/hooks.ts";
+export interface KillerosOptions {
+  completionNotifications?: CompletionNotificationDependencies;
+  /** Output-token budget for /handoff summaries; invalid values fall back to killeros.json, then the default. */
+  handoffMaxTokens?: number;
+}
+
+export default function Killeros(pi: ExtensionAPI, options: KillerosOptions = {}): void {
+  const goalRuntime = createGoalRuntime();
+  const commandResolver = createSlashCommandResolver(pi);
+  registerShellUi(pi, commandResolver);
+  registerGoalInterface(pi, goalRuntime);
+  registerGoalRuntime(pi, goalRuntime);
+  registerPersonalInstructions(pi);
+  registerQuestionTool(pi);
+  registerAliases(pi);
+  registerHandoff(pi, goalRuntime, options.handoffMaxTokens);
+  registerSlashAutocomplete(pi, commandResolver);
+  registerFooter(pi, goalRuntime);
+  registerCodexFastMode(pi);
+  registerLifecycleHooks(pi);
+  registerWorkedFor(pi);
+  const goalCompaction = registerGoalSettlement(pi, goalRuntime);
+  registerAutoCompaction(pi, { goal: goalCompaction });
+  registerRequestActivity(pi);
+  registerCompletionNotifications(pi, options.completionNotifications);
+}

package/README.md

@@ -1,112 +1,112 @@
-# KillerOS
-
-A TypeScript extension for the [Pi coding agent](https://github.com/earendil-works/pi) that replaces the stock TUI and adds long-running goals, reasoning controls, and workflow commands.
-
-## What you get
-
-- A custom TUI: startup masthead with versions, model, 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. Each turn must record `continue` with evidence and one next action, `complete`, or the existing blocker decision; otherwise the goal pauses. New goals pause after 20 turns; `/goal resume` grants another 20.
-- `/codex-fast`: toggles the `priority` service tier on Codex requests or reports its status.
-- `/handoff`: starts a fresh linked session carrying visible continuation context.
-- `/auto-compact`: reports, enables, disables, or tunes automatic context compaction.
-- A `question` tool with single-select and multi-select modes.
-- Lifecycle hooks (`tool_call`, `tool_result`, `agent_settled`) from `.pi/killeros-hooks.json`, plus `AGENTS.local.md` loading for trusted projects.
-- Optional completion sounds for settled requests.
-
-
-## Requirements
-
-- Node.js 22.19.0+
-- Pi 0.85.0 or later within the 0.x release line
-- An interactive TUI session for the custom header, editor, footer, and `question`
-
-## Install
-
-```bash
-pi install npm:killeros
-```
-
-Or from GitHub:
-
-```bash
-pi install git:github.com/KyrosHendrix/pi-KillerOS
-```
-
-Pin a release by appending its tag, for example `@v2.1.29`. Add `-l` to install only for the current project. Restart Pi after installing.
-
-## Commands
-
-```text
-/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
-/codex-fast [status]      Toggle or report Codex fast mode
-/auto-compact [status|on|off|<percent>]
-                          Inspect or change automatic compaction
-/notification             Configure the completion sound
-/handoff [focus]          Fresh session with continuation context
-/clear                    New session after confirmation
-/exit                     Quit Pi gracefully
-```
-
-## Behavior by mode
-
-| Mode | What works |
-| --- | --- |
-| TUI | Everything |
-| RPC | Goals, proactive compaction; no TUI components, sounds, title indicator |
-| Print/JSON | No interactive questions, `/goal`, or proactive compaction |
-
-## Configuration
-
-The packaged `killeros` theme activates on TUI start. Compaction triggers by default at 15% tokens remaining, stored in global `killeros.json`:
-
-```json
-{
-  "autoCompaction": {
-    "enabled": true,
-    "percentRemaining": 15
-  },
-  "handoffMaxTokens": 8192
-}
-```
-
-Use `/auto-compact status` to inspect the effective KillerOS preference, `/auto-compact on` or `/auto-compact off` to toggle it, and `/auto-compact <percent>` to set an integer threshold from 0 through 100. A threshold of 0 does not disable Pi's own token reserve.
-
-`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. A normal response never continues a goal by itself: the agent must record `continue`, `complete`, or a blocker decision through `killeros_goal_update`. Repeated continuation reports and unavailable goal tools pause the goal. 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
-
-Strict TypeScript throughout. Tests run on Node's built-in test runner:
-
-```bash
-npm ci && npm run check && npm test
-```
-
-Releases go through CI on `main`; do not push version tags manually.
-
-## Security
-
-Pi extensions run with your user permissions. Review the source before installing globally. Hook commands run only for projects Pi marks as trusted; check `.pi/killeros-hooks.json` before enabling project trust. KillerOS accepts that configuration only as a regular, non-linked file no larger than 64 KiB in the project's real `.pi` directory.
-
-## License
-
-[MIT](LICENSE) © 2026 KyrosHendrix
+# KillerOS
+
+A TypeScript extension for the [Pi coding agent](https://github.com/earendil-works/pi) that replaces the stock TUI and adds long-running goals, reasoning controls, and workflow commands.
+
+## What you get
+
+- A custom TUI: startup masthead with versions, model, 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. Each turn must record `continue` with evidence and one next action, `complete`, or the existing blocker decision; otherwise the goal pauses. New goals pause after 20 turns; `/goal resume` grants another 20.
+- `/codex-fast`: toggles the `priority` service tier on Codex requests or reports its status.
+- `/handoff`: starts a fresh linked session carrying visible continuation context.
+- `/auto-compact`: reports, enables, disables, or tunes automatic context compaction.
+- A `question` tool with single-select and multi-select modes.
+- Lifecycle hooks (`tool_call`, `tool_result`, `agent_settled`) from `.pi/killeros-hooks.json`, plus `AGENTS.local.md` loading for trusted projects.
+- Optional completion sounds for settled requests.
+
+
+## Requirements
+
+- Node.js 22.19.0+
+- Pi 0.85.0 or later within the 0.x release line
+- An interactive TUI session for the custom header, editor, footer, and `question`
+
+## Install
+
+```bash
+pi install npm:killeros
+```
+
+Or from GitHub:
+
+```bash
+pi install git:github.com/KyrosHendrix/pi-KillerOS
+```
+
+Pin a release by appending its tag, for example `@v2.1.30`. Add `-l` to install only for the current project. Restart Pi after installing.
+
+## Commands
+
+```text
+/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
+/codex-fast [status]      Toggle or report Codex fast mode
+/auto-compact [status|on|off|<percent>]
+                          Inspect or change automatic compaction
+/notification             Configure the completion sound
+/handoff [focus]          Fresh session with continuation context
+/clear                    New session after confirmation
+/exit                     Quit Pi gracefully
+```
+
+## Behavior by mode
+
+| Mode | What works |
+| --- | --- |
+| TUI | Everything |
+| RPC | Goals, proactive compaction; no TUI components, sounds, title indicator |
+| Print/JSON | No interactive questions, `/goal`, or proactive compaction |
+
+## Configuration
+
+The packaged `killeros` theme activates on TUI start. Compaction triggers by default at 15% tokens remaining, stored in global `killeros.json`:
+
+```json
+{
+  "autoCompaction": {
+    "enabled": true,
+    "percentRemaining": 15
+  },
+  "handoffMaxTokens": 8192
+}
+```
+
+Use `/auto-compact status` to inspect the effective KillerOS preference, `/auto-compact on` or `/auto-compact off` to toggle it, and `/auto-compact <percent>` to set an integer threshold from 0 through 100. A threshold of 0 does not disable Pi's own token reserve.
+
+`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. A normal response never continues a goal by itself: the agent must record `continue`, `complete`, or a blocker decision through `killeros_goal_update`. Repeated continuation reports and unavailable goal tools pause the goal. 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
+
+Strict TypeScript throughout. Tests run on Node's built-in test runner:
+
+```bash
+npm ci && npm run check && npm test
+```
+
+Releases go through CI on `main`; do not push version tags manually.
+
+## Security
+
+Pi extensions run with your user permissions. Review the source before installing globally. Hook commands run only for projects Pi marks as trusted; check `.pi/killeros-hooks.json` before enabling project trust. KillerOS accepts that configuration only as a regular, non-linked file no larger than 64 KiB in the project's real `.pi` directory.
+
+## License
+
+[MIT](LICENSE) © 2026 KyrosHendrix

package/killeros/activity.ts

@@ -1,110 +1,110 @@
-import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth } from "@earendil-works/pi-tui";
-import { modelDisplayName } from "./display.ts";
-
-export type ActivityMessage =
-  | { kind: "prompt" }
-  | { kind: "tool"; toolName: string }
-  | { kind: "tool-result"; failed: boolean }
-  | { kind: "responding" };
-
-function safeToolName(toolName: string): string {
-  const normalized = toolName.replace(/[\u0000-\u001F\u007F]+/gu, " ").replace(/\s+/gu, " ").trim();
-  return truncateToWidth(normalized || "tool", 32, "…");
-}
-
-export function formatActivityMessage(message: ActivityMessage, theme: Theme, modelId?: string): string {
-  let verb: string;
-  let detail: string;
-
-  switch (message.kind) {
-    case "prompt":
-      verb = "Mapping…";
-      detail = "understanding request";
-      break;
-    case "tool-result":
-      verb = message.failed ? "Recovering…" : "Reviewing…";
-      detail = message.failed ? "tool failed" : "reading the result";
-      break;
-    case "responding":
-      verb = "Responding…";
-      detail = "assembling the answer";
-      break;
-    case "tool":
-      switch (message.toolName.trim().toLowerCase()) {
-        case "read":
-        case "grep":
-        case "find":
-        case "ls":
-          verb = "Inspecting…";
-          detail = "reading relevant code";
-          break;
-        case "edit":
-        case "write":
-          verb = "Changing…";
-          detail = "editing";
-          break;
-        case "bash":
-          verb = "Running…";
-          detail = "command";
-          break;
-        default:
-          verb = "Working…";
-          detail = `using ${safeToolName(message.toolName)}`;
-      }
-      break;
-    default: {
-      const exhaustive: never = message;
-      return exhaustive;
-    }
-  }
-
-  const suffix = modelDisplayName({ id: modelId }) || "unknown model";
-  return `${theme.fg("accent", verb)} ${theme.fg("dim", `(${theme.bold("esc")} to interrupt · ${detail})`)}${theme.fg("dim", ` · ${suffix}`)}`;
-}
-
-export function registerRequestActivity(pi: ExtensionAPI): void {
-  let active = false;
-  let activeModel: string | undefined;
-
-  const render = (message: ActivityMessage, ctx: ExtensionContext): void => {
-    ctx.ui.setWorkingMessage(formatActivityMessage(message, ctx.ui.theme, activeModel));
-  };
-
-  const clear = (ctx?: ExtensionContext): void => {
-    active = false;
-    activeModel = undefined;
-    if (ctx?.mode === "tui") {
-      ctx.ui.setWorkingMessage();
-    }
-  };
-
-  pi.on("agent_start", (_event, ctx) => {
-    if (ctx.mode !== "tui") return;
-    if (!active) activeModel = ctx.model?.id;
-    active = true;
-    render({ kind: "prompt" }, ctx);
-  });
-
-  pi.on("tool_execution_start", (event, ctx) => {
-    if (ctx.mode !== "tui" || !active) return;
-    render({ kind: "tool", toolName: event.toolName }, ctx);
-  });
-
-  pi.on("tool_execution_end", (event, ctx) => {
-    if (ctx.mode !== "tui" || !active) return;
-    render({ kind: "tool-result", failed: event.isError }, ctx);
-  });
-
-  pi.on("message_update", (event, ctx) => {
-    if (ctx.mode !== "tui" || !active || event.assistantMessageEvent.type !== "text_start") return;
-    render({ kind: "responding" }, ctx);
-  });
-
-  pi.on("agent_settled", (_event, ctx) => {
-    if (ctx.mode !== "tui" || !active || !ctx.isIdle?.() || ctx.hasPendingMessages?.()) return;
-    clear(ctx);
-  });
-
-  pi.on("session_shutdown", (_event, ctx) => clear(ctx));
-}
+import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth } from "@earendil-works/pi-tui";
+import { modelDisplayName } from "./display.ts";
+
+export type ActivityMessage =
+  | { kind: "prompt" }
+  | { kind: "tool"; toolName: string }
+  | { kind: "tool-result"; failed: boolean }
+  | { kind: "responding" };
+
+function safeToolName(toolName: string): string {
+  const normalized = toolName.replace(/[\u0000-\u001F\u007F]+/gu, " ").replace(/\s+/gu, " ").trim();
+  return truncateToWidth(normalized || "tool", 32, "…");
+}
+
+export function formatActivityMessage(message: ActivityMessage, theme: Theme, modelId?: string): string {
+  let verb: string;
+  let detail: string;
+
+  switch (message.kind) {
+    case "prompt":
+      verb = "Mapping…";
+      detail = "understanding request";
+      break;
+    case "tool-result":
+      verb = message.failed ? "Recovering…" : "Reviewing…";
+      detail = message.failed ? "tool failed" : "reading the result";
+      break;
+    case "responding":
+      verb = "Responding…";
+      detail = "assembling the answer";
+      break;
+    case "tool":
+      switch (message.toolName.trim().toLowerCase()) {
+        case "read":
+        case "grep":
+        case "find":
+        case "ls":
+          verb = "Inspecting…";
+          detail = "reading relevant code";
+          break;
+        case "edit":
+        case "write":
+          verb = "Changing…";
+          detail = "editing";
+          break;
+        case "bash":
+          verb = "Running…";
+          detail = "command";
+          break;
+        default:
+          verb = "Working…";
+          detail = `using ${safeToolName(message.toolName)}`;
+      }
+      break;
+    default: {
+      const exhaustive: never = message;
+      return exhaustive;
+    }
+  }
+
+  const suffix = modelDisplayName({ id: modelId }) || "unknown model";
+  return `${theme.fg("accent", verb)} ${theme.fg("dim", `(${theme.bold("esc")} to interrupt · ${detail})`)}${theme.fg("dim", ` · ${suffix}`)}`;
+}
+
+export function registerRequestActivity(pi: ExtensionAPI): void {
+  let active = false;
+  let activeModel: string | undefined;
+
+  const render = (message: ActivityMessage, ctx: ExtensionContext): void => {
+    ctx.ui.setWorkingMessage(formatActivityMessage(message, ctx.ui.theme, activeModel));
+  };
+
+  const clear = (ctx?: ExtensionContext): void => {
+    active = false;
+    activeModel = undefined;
+    if (ctx?.mode === "tui") {
+      ctx.ui.setWorkingMessage();
+    }
+  };
+
+  pi.on("agent_start", (_event, ctx) => {
+    if (ctx.mode !== "tui") return;
+    if (!active) activeModel = ctx.model?.id;
+    active = true;
+    render({ kind: "prompt" }, ctx);
+  });
+
+  pi.on("tool_execution_start", (event, ctx) => {
+    if (ctx.mode !== "tui" || !active) return;
+    render({ kind: "tool", toolName: event.toolName }, ctx);
+  });
+
+  pi.on("tool_execution_end", (event, ctx) => {
+    if (ctx.mode !== "tui" || !active) return;
+    render({ kind: "tool-result", failed: event.isError }, ctx);
+  });
+
+  pi.on("message_update", (event, ctx) => {
+    if (ctx.mode !== "tui" || !active || event.assistantMessageEvent.type !== "text_start") return;
+    render({ kind: "responding" }, ctx);
+  });
+
+  pi.on("agent_settled", (_event, ctx) => {
+    if (ctx.mode !== "tui" || !active || !ctx.isIdle?.() || ctx.hasPendingMessages?.()) return;
+    clear(ctx);
+  });
+
+  pi.on("session_shutdown", (_event, ctx) => clear(ctx));
+}