@xynogen/pix-optimizer 1.1.12 → 1.1.14

package/README.md

@@ -21,7 +21,7 @@ There is no text-arg form: the overlay is the only UI. Selecting a value calls
 the tool's `run()` handler, which persists the new value and repaints the
 shared status cell. Headless/test fallbacks print a plain status summary.
 
-State persists to `~/.pi/agent/optimizer.json` (caveman/rtk/toon/ponytail).
+State persists to `~/.pi/agent/optimizer.json` (caveman/rtk/toon/ponytail). **Initial values** for a new session can be set in the `optimizer` section of `~/.pi/agent/pix.json` — the runtime toggle via `/optimizer` still persists changes to `optimizer.json` as before.
 
 ## Status bar
 
@@ -118,6 +118,21 @@ works. Validation, error handling, security, and accessibility are never cut.
 **No install required** — pure prompt injection, no external binary or PATH
 dependency (unlike RTK and TOON).
 
+## Configuration via `pix.json`
+
+Set the initial optimizer state for new sessions in `~/.pi/agent/pix.json`. These values are applied once at session start; subsequent changes via `/optimizer` persist to `optimizer.json` and take precedence.
+
+```jsonc
+{
+  "optimizer": {
+    "caveman": "lite",   // off | lite | full | ultra | micro
+    "rtk":     true,
+    "toon":    false,
+    "ponytail": "off"   // off | lite | full | ultra
+  }
+}
+```
+
 ## Installation
 
 ```bash
@@ -141,7 +156,7 @@ pi install npm:@xynogen/pix-optimizer
 | `src/rtk.ts`      | RTK prompt + bash command rewriting                       |
 | `src/json.ts`     | jq+TOON guidance, heuristics, system-prompt injection     |
 | `src/ponytail.ts` | Ponytail logic, levels, prompt                            |
-| `src/persist.ts`  | Disk-backed `~/.pi/agent/optimizer.json` persistence      |
+| `src/persist.ts`  | Disk-backed `~/.pi/agent/optimizer.json` persistence; seeds initial state from `pix.json` |
 | `src/tool-result-filter.ts` | Strips model-guidance warnings from tool_result |
 
 Each tool registers its own lifecycle hooks and exposes an `OptimizerHandle`

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-optimizer",
-	"version": "1.1.12",
+	"version": "1.1.14",
 	"description": "Performance optimization suite for Pi Coding Agent - caveman mode + RTK tool rewriting + jq/TOON JSON compression + ponytail lazy-dev mode",
 	"type": "module",
 	"main": "src/index.ts",
@@ -48,7 +48,8 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@xynogen/pix-pretty": "^1.7.9"
+		"@xynogen/pix-pretty": "^1.7.9",
+		"@xynogen/pix-data": "workspace:*"
 	},
 	"peerDependencies": {
 		"@earendil-works/pi-coding-agent": "*",

package/src/opt.ts

@@ -136,7 +136,7 @@ export function registerOptCommand(
 						const values = handles[tool].values;
 						const cur = values.indexOf(handles[tool].current());
 						const next = (cur + direction + values.length) % values.length;
-						handles[tool].run(values[next] as string, ctx);
+						handles[tool].run(values[next] ?? "", ctx);
 					};
 
 					const move = (direction: -1 | 1) => {

package/src/persist.ts

@@ -12,29 +12,37 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { pixConfig } from "@xynogen/pix-data/pix-config";
 import type { OptimizerTool } from "./status.ts";
 
-type OptimizerConfig = Partial<Record<OptimizerTool, string>>;
+type OptimizerFileConfig = Partial<Record<OptimizerTool, string>>;
 
 function getStatePath(): string {
 	return join(getAgentDir(), "optimizer.json");
 }
 
-function readAll(): OptimizerConfig {
+function readFile(): OptimizerFileConfig {
 	try {
 		const sp = getStatePath();
 		if (!existsSync(sp)) return {};
-		const raw = JSON.parse(readFileSync(sp, "utf-8")) as OptimizerConfig;
+		const raw = JSON.parse(readFileSync(sp, "utf-8")) as OptimizerFileConfig;
 		return raw && typeof raw === "object" ? raw : {};
 	} catch {
-		// Missing, corrupt, or no getAgentDir (tests/headless) — start clean.
 		return {};
 	}
 }
 
-/** Read a single tool's persisted value, or undefined if none. */
+/**
+ * Read a single tool's persisted value.
+ * Precedence: optimizer.json (runtime toggle) → pix.json → undefined
+ */
 export function loadOptValue(tool: OptimizerTool): string | undefined {
-	return readAll()[tool];
+	const fromFile = readFile()[tool];
+	if (fromFile !== undefined) return fromFile;
+	// Fall back to pix.json
+	const pix = pixConfig().optimizer;
+	const val = pix[tool as keyof typeof pix];
+	return val && val !== "off" ? val : undefined;
 }
 
 /** Persist a single tool's value, merging into the shared config file. */
@@ -42,7 +50,7 @@ export function saveOptValue(tool: OptimizerTool, value: string): void {
 	try {
 		const sp = getStatePath();
 		mkdirSync(dirname(sp), { recursive: true });
-		const next = { ...readAll(), [tool]: value };
+		const next = { ...readFile(), [tool]: value };
 		writeFileSync(sp, JSON.stringify(next, null, 2), "utf-8");
 	} catch (err) {
 		console.warn(`optimizer: persist ${tool} failed:`, err);

package/src/rtk.ts

@@ -156,7 +156,7 @@ export function splitChain(command: string): string[] | null {
 	let quote: "'" | '"' | null = null;
 
 	for (let i = 0; i < command.length; i++) {
-		const c = command[i] as string;
+		const c = command[i] ?? "";
 		const next = command[i + 1];
 
 		if (quote) {