pi-rtk-optimizer 0.7.1 → 0.8.1

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.1] - 2026-05-26
+
+### Changed
+- Widened `@earendil-works/pi-coding-agent` and `@earendil-works/pi-tui` peer dependency ranges to `^0.74.0 || ^0.75.0`.
+
+## [0.8.0] - 2026-05-22
+
+### Added
+- Added tabbed `/rtk` settings modal groups with left/right tab navigation and context-aware help for search and value changes.
+- Added anchor-safe `read` compaction that detects hashline/anchored read output and preserves complete edit anchors during source filtering, smart truncation, and hard truncation.
+
+### Changed
+- Updated package metadata and lockfile version to `0.8.0` and migrated Pi peer dependency metadata to the `@earendil-works` scope.
+
 ## [0.7.1] - 2026-05-04
 
 ### Changed

package/README.md

@@ -33,11 +33,12 @@ Multi-stage pipeline to reduce token consumption:
 | Search Grouping | Groups `grep`/`rg` results by file |
 | Source Code Filtering | `none`, `minimal`, or `aggressive` comment/whitespace removal with userscript metadata preservation |
 | Smart Truncation | Preserves file boundaries and important lines while keeping 80-line reads exact |
+| Anchor-Safe Read Compaction | Detects hashline/anchored `read` output and preserves complete edit anchors when filtering or truncating anchored lines |
 | Hard Truncation | Final character limit enforcement |
 
 ### Interactive Settings
 
-- TUI settings modal via `/rtk` command
+- Tabbed TUI settings modal via `/rtk` command
 - Real-time configuration changes without restart
 - Command completions for all subcommands
 
@@ -82,7 +83,7 @@ Open the interactive settings modal:
 /rtk
 ```
 
-Use arrow keys to navigate settings, Enter to cycle values, and Escape to close.
+Use ←/→ to switch tabs, ↑/↓ to navigate settings in the active tab, type to search, Enter/Space to cycle values, and Escape to close.
 
 ### Subcommands
 
@@ -146,6 +147,8 @@ Bash command support is intentionally resolved by the installed `rtk` binary thr
 
 Skill-read preservation covers the global Pi skills directory (`~/.pi/agent/skills` by default, or `$PI_CODING_AGENT_DIR/skills` when set), `~/.agents/skills`, project `.pi/skills`, and ancestor `.agents/skills` directories.
 
+When `read` output uses Pi hashline/anchor prefixes, the compactor treats each anchored line as an indivisible edit anchor. Source filtering and truncation may omit anchored lines, but retained lines keep their complete anchor prefixes; hard truncation inserts an anchor-safe marker instead of cutting through an anchor.
+
 #### Truncation Settings
 
 | Option | Type | Default | Range | Description |
@@ -252,7 +255,7 @@ Automatic fixes applied on Windows:
 
 ### Dependencies
 
-- **Peer dependencies:** `@mariozechner/pi-coding-agent`, `@mariozechner/pi-tui`
+- **Peer dependencies:** `@earendil-works/pi-coding-agent`, `@earendil-works/pi-tui`
 - **Runtime:** Node.js ≥20, optional `rtk` binary for command rewriting
 - **Development verification:** Node.js ≥20, npm, and Bun for the test scripts
 

package/package.json

@@ -1,67 +1,67 @@
-{
-  "name": "pi-rtk-optimizer",
-  "version": "0.7.1",
-  "description": "Pi extension that optimizes RTK command rewriting and tool output compaction for the coding agent.",
-  "type": "module",
-  "main": "./index.ts",
-  "exports": {
-    ".": "./index.ts"
-  },
-  "files": [
-    "index.ts",
-    "src",
-    "config/config.example.json",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json --noCheck",
-    "typecheck": "tsc -p tsconfig.json",
-    "test": "bun ./src/output-compactor-test.ts && bun ./src/command-rewriter-test.ts && bun ./src/runtime-guard-test.ts && bun ./src/additional-coverage-test.ts && bun ./src/config-modal-test.ts && bun ./src/index-test.ts",
-    "check": "npm run typecheck && npm run test && npm run build:check",
-    "build:check": "esbuild ./index.ts --bundle --platform=node --format=esm --outfile=./.pi-rtk-optimizer-check.mjs --external:@mariozechner/pi-coding-agent --external:@mariozechner/pi-tui && node -e \"import { unlinkSync } from 'node:fs'; unlinkSync('./.pi-rtk-optimizer-check.mjs');\""
-  },
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "pi-coding-agent",
-    "coding-agent",
-    "rtk",
-    "token-optimization",
-    "tool-compaction",
-    "output-compaction",
-    "command-rewrite",
-    "optimization"
-  ],
-  "author": "MasuRii",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MasuRii/pi-rtk-optimizer.git"
-  },
-  "bugs": {
-    "url": "https://github.com/MasuRii/pi-rtk-optimizer/issues"
-  },
-  "homepage": "https://github.com/MasuRii/pi-rtk-optimizer#readme",
-  "engines": {
-    "node": ">=20"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "esbuild": "0.28.0",
-    "typescript": "5.7.3"
-  },
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ]
-  },
-  "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "^0.72.0",
-    "@mariozechner/pi-tui": "^0.72.0"
-  }
-}
+{
+  "name": "pi-rtk-optimizer",
+  "version": "0.8.1",
+  "description": "Pi extension that optimizes RTK command rewriting and tool output compaction for the coding agent.",
+  "type": "module",
+  "main": "./index.ts",
+  "exports": {
+    ".": "./index.ts"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "config/config.example.json",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json --noCheck",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "bun ./src/output-compactor-test.ts && bun ./src/command-rewriter-test.ts && bun ./src/runtime-guard-test.ts && bun ./src/additional-coverage-test.ts && bun ./src/config-modal-test.ts && bun ./src/index-test.ts",
+    "check": "npm run typecheck && npm run test && npm run build:check",
+    "build:check": "esbuild ./index.ts --bundle --platform=node --format=esm --outfile=./.pi-rtk-optimizer-check.mjs --external:@mariozechner/pi-coding-agent --external:@mariozechner/pi-tui && node -e \"import { unlinkSync } from 'node:fs'; unlinkSync('./.pi-rtk-optimizer-check.mjs');\""
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "pi-coding-agent",
+    "coding-agent",
+    "rtk",
+    "token-optimization",
+    "tool-compaction",
+    "output-compaction",
+    "command-rewrite",
+    "optimization"
+  ],
+  "author": "MasuRii",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MasuRii/pi-rtk-optimizer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MasuRii/pi-rtk-optimizer/issues"
+  },
+  "homepage": "https://github.com/MasuRii/pi-rtk-optimizer#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "esbuild": "0.28.0",
+    "typescript": "6.0.3"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.74.0 || ^0.75.0",
+    "@earendil-works/pi-tui": "^0.74.0 || ^0.75.0"
+  }
+}

package/src/additional-coverage-test.ts

@@ -13,7 +13,7 @@ import { sanitizeStreamingBashExecutionResult } from "./tool-execution-sanitizer
 import { sanitizeRtkEmojiOutput } from "./techniques/emoji.ts";
 import { stripRtkHookWarnings } from "./techniques/rtk.ts";
 
-mock.module("@mariozechner/pi-coding-agent", () => ({
+mock.module("@earendil-works/pi-coding-agent", () => ({
 	getAgentDir: () => "/tmp/.pi/agent",
 }));
 

package/src/command-completions.ts

@@ -1,49 +1,49 @@
-import type { AutocompleteItem } from "@mariozechner/pi-tui";
-
-interface CompletionDefinition {
-	name: string;
-	description: string;
-}
-
-const TOP_LEVEL_SUBCOMMANDS: CompletionDefinition[] = [
-	{ name: "show", description: "Show current RTK config + runtime summary" },
-	{ name: "path", description: "Show RTK config file path" },
-	{ name: "verify", description: "Check whether rtk binary is available" },
-	{ name: "stats", description: "Show output compaction metrics" },
-	{ name: "clear-stats", description: "Clear output compaction metrics" },
-	{ name: "reset", description: "Reset RTK settings to defaults" },
-	{ name: "help", description: "Show usage help" },
-];
-
-function startsWithFilter(value: string, prefix: string): boolean {
-	if (!prefix) {
-		return true;
-	}
-	return value.startsWith(prefix);
-}
-
-function mapCompletions(values: CompletionDefinition[]): AutocompleteItem[] {
-	return values.map((entry) => ({
-		value: entry.name,
-		label: entry.name,
-		description: entry.description,
-	}));
-}
-
-export function getRtkArgumentCompletions(argumentPrefix: string): AutocompleteItem[] | null {
-	const normalized = argumentPrefix.trimStart().toLowerCase();
-	if (!normalized) {
-		return mapCompletions(TOP_LEVEL_SUBCOMMANDS);
-	}
-
-	if (normalized.includes(" ")) {
-		return null;
-	}
-
-	const filtered = TOP_LEVEL_SUBCOMMANDS.filter((entry) => startsWithFilter(entry.name, normalized));
-	if (filtered.length === 0) {
-		return null;
-	}
-
-	return mapCompletions(filtered);
-}
+import type { AutocompleteItem } from "@earendil-works/pi-tui";
+
+interface CompletionDefinition {
+	name: string;
+	description: string;
+}
+
+const TOP_LEVEL_SUBCOMMANDS: CompletionDefinition[] = [
+	{ name: "show", description: "Show current RTK config + runtime summary" },
+	{ name: "path", description: "Show RTK config file path" },
+	{ name: "verify", description: "Check whether rtk binary is available" },
+	{ name: "stats", description: "Show output compaction metrics" },
+	{ name: "clear-stats", description: "Clear output compaction metrics" },
+	{ name: "reset", description: "Reset RTK settings to defaults" },
+	{ name: "help", description: "Show usage help" },
+];
+
+function startsWithFilter(value: string, prefix: string): boolean {
+	if (!prefix) {
+		return true;
+	}
+	return value.startsWith(prefix);
+}
+
+function mapCompletions(values: CompletionDefinition[]): AutocompleteItem[] {
+	return values.map((entry) => ({
+		value: entry.name,
+		label: entry.name,
+		description: entry.description,
+	}));
+}
+
+export function getRtkArgumentCompletions(argumentPrefix: string): AutocompleteItem[] | null {
+	const normalized = argumentPrefix.trimStart().toLowerCase();
+	if (!normalized) {
+		return mapCompletions(TOP_LEVEL_SUBCOMMANDS);
+	}
+
+	if (normalized.includes(" ")) {
+		return null;
+	}
+
+	const filtered = TOP_LEVEL_SUBCOMMANDS.filter((entry) => startsWithFilter(entry.name, normalized));
+	if (filtered.length === 0) {
+		return null;
+	}
+
+	return mapCompletions(filtered);
+}

package/src/command-rewriter-test.ts

@@ -3,7 +3,7 @@ import assert from "node:assert/strict";
 import { computeRewriteDecision } from "./command-rewriter.ts";
 import { resolveRtkRewrite } from "./rtk-rewrite-provider.ts";
 import { cloneDefaultConfig, runTest } from "./test-helpers.ts";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
 function createMockPi(execResult: { code: number; stdout?: string; stderr?: string }): ExtensionAPI {
 	return {

package/src/command-rewriter.ts

@@ -1,46 +1,46 @@
-import { resolveRtkRewrite, type RtkRewriteProviderOptions } from "./rtk-rewrite-provider.js";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import type { RtkIntegrationConfig } from "./types.js";
-
-export interface RewriteDecision {
-	changed: boolean;
-	originalCommand: string;
-	rewrittenCommand: string;
-	reason: "ok" | "empty" | "already_rtk" | "no_match";
-	warning?: string;
-}
-
-export async function computeRewriteDecision(
-	command: string,
-	_config: RtkIntegrationConfig,
-	pi: ExtensionAPI,
-	rewriteOptions: RtkRewriteProviderOptions = {},
-): Promise<RewriteDecision> {
-	if (!command || !command.trim()) {
-		return { changed: false, originalCommand: command, rewrittenCommand: command, reason: "empty" };
-	}
-
-	const trimmedStart = command.trimStart();
-	if (trimmedStart === "rtk" || trimmedStart.startsWith("rtk ")) {
-		return { changed: false, originalCommand: command, rewrittenCommand: command, reason: "already_rtk" };
-	}
-
-	const result = await resolveRtkRewrite(pi, command, rewriteOptions);
-
-	if (result.changed && result.rewrittenCommand) {
-		return {
-			changed: true,
-			originalCommand: command,
-			rewrittenCommand: result.rewrittenCommand,
-			reason: "ok",
-		};
-	}
-
-	return {
-		changed: false,
-		originalCommand: command,
-		rewrittenCommand: command,
-		reason: "no_match",
-		warning: result.error,
-	};
-}
+import { resolveRtkRewrite, type RtkRewriteProviderOptions } from "./rtk-rewrite-provider.js";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { RtkIntegrationConfig } from "./types.js";
+
+export interface RewriteDecision {
+	changed: boolean;
+	originalCommand: string;
+	rewrittenCommand: string;
+	reason: "ok" | "empty" | "already_rtk" | "no_match";
+	warning?: string;
+}
+
+export async function computeRewriteDecision(
+	command: string,
+	_config: RtkIntegrationConfig,
+	pi: ExtensionAPI,
+	rewriteOptions: RtkRewriteProviderOptions = {},
+): Promise<RewriteDecision> {
+	if (!command || !command.trim()) {
+		return { changed: false, originalCommand: command, rewrittenCommand: command, reason: "empty" };
+	}
+
+	const trimmedStart = command.trimStart();
+	if (trimmedStart === "rtk" || trimmedStart.startsWith("rtk ")) {
+		return { changed: false, originalCommand: command, rewrittenCommand: command, reason: "already_rtk" };
+	}
+
+	const result = await resolveRtkRewrite(pi, command, rewriteOptions);
+
+	if (result.changed && result.rewrittenCommand) {
+		return {
+			changed: true,
+			originalCommand: command,
+			rewrittenCommand: result.rewrittenCommand,
+			reason: "ok",
+		};
+	}
+
+	return {
+		changed: false,
+		originalCommand: command,
+		rewrittenCommand: command,
+		reason: "no_match",
+		warning: result.error,
+	};
+}

package/src/config-modal-test.ts

@@ -3,7 +3,7 @@ import { mock } from "bun:test";
 
 import { cloneDefaultConfig, runTest } from "./test-helpers.ts";
 
-mock.module("@mariozechner/pi-coding-agent", () => ({
+mock.module("@earendil-works/pi-coding-agent", () => ({
 	getAgentDir: () => "/tmp/.pi/agent",
 	getSettingsListTheme: () => ({}),
 }));
@@ -11,7 +11,7 @@ mock.module("@mariozechner/pi-coding-agent", () => ({
 const settingsListInputs: string[] = [];
 const settingsListUpdates: Array<{ id: string; value: string }> = [];
 
-mock.module("@mariozechner/pi-tui", () => ({
+mock.module("@earendil-works/pi-tui", () => ({
 	Box: class {
 		addChild(): void {}
 	},

package/src/config-modal.ts

@@ -1,5 +1,5 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import type { SettingItem } from "@mariozechner/pi-tui";
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import type { SettingItem } from "@earendil-works/pi-tui";
 import { toOnOff } from "./boolean-format.js";
 import { ZellijModal, ZellijSettingsModal } from "./zellij-modal.js";
 import { getRtkArgumentCompletions } from "./command-completions.js";
@@ -31,6 +31,70 @@ const TRUNCATE_MAX_CHAR_VALUES = ["4000", "8000", "12000", "20000", "50000", "10
 const SMART_TRUNCATE_LINE_VALUES = ["40", "80", "120", "160", "220", "320", "500", "1000", "2000", "4000"];
 const RTK_USAGE_TEXT =
 	"Usage: /rtk [show|path|verify|stats|clear-stats|reset|help] (or run /rtk with no args to open settings modal)";
+const SETTINGS_TAB_DEFINITIONS = [
+	{
+		label: "General",
+		settingIds: ["enabled", "mode", "showRewriteNotifications", "guardWhenRtkMissing"],
+	},
+	{
+		label: "Compaction",
+		settingIds: [
+			"outputCompactionEnabled",
+			"outputStripAnsi",
+			"outputAggregateTestOutput",
+			"outputFilterBuildOutput",
+			"outputCompactGitOutput",
+			"outputAggregateLinterOutput",
+			"outputGroupSearchOutput",
+			"outputTrackSavings",
+		],
+	},
+	{
+		label: "Read & Source",
+		settingIds: [
+			"outputReadCompactionEnabled",
+			"outputSourceFilteringEnabled",
+			"outputSourceFiltering",
+			"outputPreserveExactSkillReads",
+		],
+	},
+	{
+		label: "Truncation",
+		settingIds: [
+			"outputTruncateEnabled",
+			"outputTruncateMaxChars",
+			"outputSmartTruncate",
+			"outputSmartTruncateMaxLines",
+		],
+	},
+] as const;
+
+function buildTabbedSettingGroups(settings: SettingItem[]): Array<{ label: string; settings: SettingItem[] }> {
+	const byId = new Map(settings.map((setting) => [setting.id, setting]));
+	const assignedIds = new Set<string>();
+
+	const tabs = SETTINGS_TAB_DEFINITIONS.map(({ label, settingIds }) => ({
+		label,
+		settings: settingIds.map((id) => {
+			const setting = byId.get(id);
+			if (!setting) {
+				throw new Error(`Missing setting item for tab '${label}': ${id}`);
+			}
+			if (assignedIds.has(id)) {
+				throw new Error(`Setting item assigned to multiple tabs: ${id}`);
+			}
+			assignedIds.add(id);
+			return setting;
+		}),
+	}));
+
+	const unassignedIds = settings.map((setting) => setting.id).filter((id) => !assignedIds.has(id));
+	if (unassignedIds.length > 0) {
+		throw new Error(`Unassigned setting items: ${unassignedIds.join(", ")}`);
+	}
+
+	return tabs;
+}
 
 function parseSourceFilterLevel(
 	value: string,
@@ -400,12 +464,14 @@ async function openSettingsModal(ctx: ExtensionCommandContext, controller: RtkIn
 		(tui, theme, _keybindings, done) => {
 			let current = controller.getConfig();
 			let settingsModal: ZellijSettingsModal | null = null;
+			const allSettings = buildSettingItems(current);
+			const tabs = buildTabbedSettingGroups(allSettings);
 
 			settingsModal = new ZellijSettingsModal(
 				{
-					title: "RTK Integration Settings",
-					description: "Bash rewrite + tool output compaction for lower token usage",
-					settings: buildSettingItems(current),
+					title: "Pi RTK Optimizer",
+					tabs,
+					activeTabIndex: 0,
 					onChange: (id, newValue) => {
 						current = applySetting(current, id, newValue);
 						controller.setConfig(current, ctx);
@@ -415,7 +481,7 @@ async function openSettingsModal(ctx: ExtensionCommandContext, controller: RtkIn
 						}
 					},
 					onClose: () => done(),
-					helpText: `/rtk show • /rtk verify • /rtk stats • /rtk reset • ${controller.getConfigPath()}`,
+					helpText: `Config: ${controller.getConfigPath()}`,
 					enableSearch: true,
 				},
 				theme,
@@ -426,11 +492,14 @@ async function openSettingsModal(ctx: ExtensionCommandContext, controller: RtkIn
 				{
 					borderStyle: "rounded",
 					titleBar: {
-						left: "RTK Integration Settings",
-						right: "pi-rtk-optimizer",
+						left: "Pi RTK Optimizer",
 					},
 					helpUndertitle: {
-						text: "Esc: close | ↑↓: navigate | Space: toggle",
+						variants: [
+							"←/→ tabs • Type to search • Enter/Space change • Esc close",
+							"←/→ tabs • Type to search • Esc close",
+							"←/→ tabs • Esc close",
+						],
 						color: "dim",
 					},
 					overlay: overlayOptions,

package/src/constants.ts

@@ -1,4 +1,4 @@
-import { getAgentDir } from "@mariozechner/pi-coding-agent";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
 import { join } from "node:path";
 
 export const EXTENSION_NAME = "pi-rtk-optimizer";

package/src/index-test.ts

@@ -3,13 +3,13 @@ import { mock } from "bun:test";
 
 import { runTest } from "./test-helpers.ts";
 
-mock.module("@mariozechner/pi-coding-agent", () => ({
+mock.module("@earendil-works/pi-coding-agent", () => ({
 	getAgentDir: () => "/tmp/.pi/agent",
 	getSettingsListTheme: () => ({}),
 	isToolCallEventType: (toolName: string, event: Record<string, unknown>) => event.toolName === toolName,
 }));
 
-mock.module("@mariozechner/pi-tui", () => ({
+mock.module("@earendil-works/pi-tui", () => ({
 	Box: class {},
 	Container: class {
 		addChild(): void {}

package/src/index.ts

@@ -1,4 +1,4 @@
-import { isToolCallEventType, type ExtensionAPI, type ExtensionCommandContext, type ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { isToolCallEventType, type ExtensionAPI, type ExtensionCommandContext, type ExtensionContext } from "@earendil-works/pi-coding-agent";
 import {
 	ensureConfigExists,
 	getRtkIntegrationConfigPath,