killeros 1.1.0 → 1.3.0

package/README.md

@@ -1,12 +1,12 @@
 # KillerOS
 
-A production-hardened Pi extension that combines a custom TUI, reasoning controls, interactive questions, command aliases, and concise-response guidance.
+A production-hardened Pi extension that combines a custom TUI, repository initialization, long-running goals, reasoning controls, interactive questions, command aliases, and concise-response guidance.
 
 ## Requirements
 
 - Node.js `22.19.0` or later
 - Pi `0.82.1` or later
-- Interactive TUI mode for the custom header, editor, footer, and `question` tool
+- Interactive TUI mode for the custom header, editor, footer, `question` tool, and `/init`
 
 The extension is strict TypeScript and uses only packages provided by Pi.
 
@@ -29,20 +29,22 @@ pi install git:github.com/KyrosHendrix/pi-KillerOS
 Pin an install to a release:
 
 ```bash
-pi install git:github.com/KyrosHendrix/pi-KillerOS@v1.1.0
+pi install git:github.com/KyrosHendrix/pi-KillerOS@v1.3.0
 ```
 
 Add `-l` to either command for a project-only install. Restart Pi after installing.
 
 ## Features
 
-- Compact KillerOS startup card with model, directory, context, and loaded capability state
+- 52-column Compact startup card with inline version, polished model/provider identity, adjacent `/model`, directory, conditional Git branch, and a shuffled session-stable tip
 - Cohesive dark theme with coral accents and neutral tool-call containers across pending, success, and error states
 - Coral Spark activity indicator with Claude-adjacent verbs that advance between agent runs and a quiet hidden-thinking label
 - Framed multiline editor with Shift+Enter support
-- Footer with model, reasoning, context remaining, Git branch, elapsed time, and cost
+- Responsive footer with polished model/provider identity, plain-language context, and active goal state remaining; reasoning, Git branch, elapsed time, cost, and path cut down by available width
 - `/variants` selector and direct reasoning-level arguments
-- `question` tool with filtering, keyboard selection, custom answers, history, cancellation, and resize-safe rendering
+- Codex-style `/goal` for durable long-running objectives with pause, resume, edit, clear, automatic continuation, and explicit completion
+- Claude Code-style `/init` that scans the repository and generates a concise root `AGENTS.md` without setup questions
+- `question` tool with filtering, proposal previews, keyboard selection, custom answers, history, cancellation, and resize-safe rendering
 - Mid-prompt slash completion with current Pi `0.82.1` commands, extensions, prompts, and skills
 - `/clear` for a confirmed new session, plus `/exit` for graceful shutdown
 - Concise system-prompt guidance without modifying completed assistant messages
@@ -50,33 +52,42 @@ Add `-l` to either command for a project-only install. Restart Pi after installi
 ## Commands
 
 ```text
+/init                     Generate root AGENTS.md from repository evidence
+/goal                     View the current long-running goal
+/goal <objective>         Set an objective and start working
+/goal edit                Edit and reactivate the current goal
+/goal pause               Stop automatic continuation
+/goal resume              Resume automatic continuation
+/goal clear               Remove the current goal
 /variants                 Open the reasoning-level selector
 /variants high            Set a reasoning level directly
 /clear                    Start a new session after confirmation
 /exit                     Quit Pi gracefully
 ```
 
+`/goal` requires a saved session in TUI or RPC mode. Goal state is stored in versioned session entries on the active branch and restored after reload, resume, fork, or tree navigation. Active goals inject their unchanged objective every turn and continue one settled turn at a time. The model must use KillerOS’s private goal tool to mark verified completion or a blocker repeated across at least three goal turns; final prose alone does not end the loop. Aborted turns, provider failures, and continuation failures pause safely. Replacing unfinished work requires confirmation, and `/goal edit` requires TUI mode.
+
+`/init` builds a bounded project map, reads high-value manifests, documentation, and CI configuration, and lets the active model inspect additional implementation files before generating root `AGENTS.md`. Existing `AGENTS.md` and `CLAUDE.md` content is intentionally excluded so stale guidance is not inherited. The command asks no setup questions, starts no second model process, writes only `AGENTS.md`, and reloads Pi resources when finished.
+
 Supported reasoning levels are `off`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. KillerOS limits choices to levels supported by the current model.
 
 ## Configuration
 
 KillerOS activates its packaged `killeros` theme when a TUI session starts. Tool-call backgrounds stay neutral across pending, successful, and failed states; restrained text and icons preserve status visibility.
 
-KillerOS displays provider costs in USD.
+KillerOS displays session costs in USD. The footer uses Pi's human-readable model name when available, keeps the provider visually secondary, and renders context as `percent left (tokens)` without a progress bar. When a goal exists, the footer adds its active time or terminal state; at narrow widths, context pressure and goal state take priority.
 
-Set a custom footer shortcut hint with:
+For trusted projects, KillerOS loads `AGENTS.local.md` after Pi's shared repository context. A one-line `@path` or `@~/path` file imports personal guidance from another location.
 
-```text
-PI_SHORTCUT_HINT=/variants
-```
+Lifecycle hooks are loaded from `.pi/killeros-hooks.json` at session start. Supported event keys are `tool_call`, `tool_result`, and `agent_settled`; matchers are JavaScript regular expressions over Pi tool names. Hook commands run from the repository root with `KILLEROS_EVENT`, `KILLEROS_TOOL`, and `KILLEROS_PAYLOAD` environment variables. Failed `tool_call` hooks block the tool, while later-event failures notify the user.
 
 ## Behavior by mode
 
 | Mode | Behavior |
 |---|---|
 | TUI | All features are available |
-| RPC | Commands and concise prompt guidance work; TUI components are disabled |
-| Print/JSON | Concise prompt guidance works; interactive questions fail explicitly |
+| RPC | Goal set/view/pause/resume/clear and concise prompt guidance work; TUI components, `/goal edit`, and `/init` are disabled |
+| Print/JSON | Concise prompt guidance works; interactive questions, `/goal`, and `/init` fail explicitly |
 
 ## Validation
 
@@ -107,7 +118,7 @@ git push origin main --follow-tags
 
 ## Security
 
-Pi extensions run with your user permissions. Review the source before installing it globally.
+Pi extensions run with your user permissions. Review the source before installing it globally. KillerOS executes lifecycle hook commands only for projects Pi marks as trusted; review `.pi/killeros-hooks.json` before enabling project trust.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "killeros",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "A production-hardened TUI and workflow extension for the Pi coding agent.",
   "type": "module",
   "keywords": [

package/themes/killeros.json

@@ -4,14 +4,14 @@
   "vars": {
     "coral": "#d77757",
     "coralBright": "#e58b6d",
-    "canvas": "#090b0e",
-    "surface": "#101419",
-    "surfaceRaised": "#151a20",
-    "line": "#39424b",
-    "lineMuted": "#2b333b",
-    "text": "#dce1e5",
-    "muted": "#8f99a3",
-    "dim": "#606b75",
+    "canvas": "#0a0a0a",
+    "surface": "#121212",
+    "surfaceRaised": "#1a1a1a",
+    "line": "#404040",
+    "lineMuted": "#2e2e2e",
+    "text": "#f2f2f2",
+    "muted": "#adadad",
+    "dim": "#808080",
     "success": "#8fa88b",
     "error": "#c8786c",
     "warning": "#bda36c",
@@ -78,8 +78,8 @@
     "bashMode": "warning"
   },
   "export": {
-    "pageBg": "#090b0e",
-    "cardBg": "#101419",
-    "infoBg": "#151a20"
+    "pageBg": "#0a0a0a",
+    "cardBg": "#121212",
+    "infoBg": "#1a1a1a"
   }
 }