@xynogen/pix-runtime 0.14.0 → 0.15.0

package/README.md

@@ -10,7 +10,7 @@ See `DESIGN.md` for the full contract.
 ## What it does
 
 - Versioned, sparse `pix.json` (`$version: 1`) — defaults resolve in code.
-- Typed sections: `collapse`, `pretty`, `io`, `compaction`, `optimizer`, `gate`, `fetch`, `search`, `voice`, `toolbox`.
+- Typed sections: `collapse`, `pretty`, `io`, `compaction`, `edit`, `optimizer`, `gate`, `fetch`, `search`, `voice`, `toolbox`.
 - `/pix` has a Footer tab for `pretty.footer` visibility.
 - Startup imports legacy service config files and archives them only after a successful save.
 - Atomic writes behind a serialized in-process queue and a short-lived
@@ -65,6 +65,17 @@ The default floor is 100K and the hard minimum is 25K (values below clamp up);
 `/pix` offers 25K, 50K, 100K, 150K, 200K, 300K, 400K, 600K, 800K, and 1M.
 pix-core consumes both settings.
 
+Over that threshold, pix-core masks older tool output before it summarizes.
+`compaction.maskKeep` (default `10`) is the number of newest tool results kept as
+is. Older successful `bash`/`grep`/`find`/`ls`/`read` output becomes a one-line
+stub; errors stay. `compaction.maskMinTokens` (default `5000`) skips a pass that
+would free fewer tokens, because each pass breaks the prompt cache. Both are
+`pix.json` calibration knobs with no `/pix` picker.
+
+`edit.rejectNewSyntaxErrors` (default `false`, `/pix` → **Edit → syntax guard**)
+makes pix-diagnostics restore a file and fail the edit when LSP reports a syntax
+error that was not there before. Type errors never trigger it.
+
 Collapse policy helpers:
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-runtime",
-	"version": "0.14.0",
+	"version": "0.15.0",
 	"description": "Pix shared runtime — versioned pix.json config, atomic persistence, typed change events",
 	"type": "module",
 	"main": "src/index.ts",

package/src/pix-command.ts

@@ -22,6 +22,7 @@ import type { PixRuntime } from "./runtime.ts";
 import { type DeepPartial, deepMerge, type SectionHandle } from "./schema.ts";
 import { collapseSection } from "./sections/collapse.ts";
 import { compactionSection } from "./sections/compaction.ts";
+import { editSection } from "./sections/edit.ts";
 import { gateSection } from "./sections/gate.ts";
 import { ioSection } from "./sections/io.ts";
 import { prettySection, type RenderSize } from "./sections/pretty.ts";
@@ -176,6 +177,14 @@ const SETTINGS: SettingRow<unknown>[] = [
 		read: (v) => formatTokens(v.minimumTokens),
 		patch: (value) => ({ minimumTokens: parseTokens(value) }),
 	}),
+	row({
+		section: "Edit",
+		label: "syntax guard",
+		handle: editSection,
+		values: ["off", "on"],
+		read: (v) => (v.rejectNewSyntaxErrors ? "on" : "off"),
+		patch: (value) => ({ rejectNewSyntaxErrors: value === "on" }),
+	}),
 	row({
 		section: "Gate",
 		label: "Guardrails",

package/src/sections/compaction.ts

@@ -12,6 +12,10 @@ export interface CompactionConfig {
 	triggerPercent: number;
 	/** Absolute floor for a percentage-based trigger. */
 	minimumTokens: number;
+	/** Over threshold: newest tool results kept as is; older bash/grep/find/ls/read output is masked. */
+	maskKeep: number;
+	/** Skip a masking pass that would free fewer tokens than this (each pass breaks the prompt cache). */
+	maskMinTokens: number;
 }
 
 const MINIMUM_TOKEN_FLOOR = 25_000;
@@ -20,6 +24,8 @@ const MINIMUM_TOKEN_DEFAULT = 100_000;
 const DEFAULTS: Readonly<CompactionConfig> = {
 	triggerPercent: 60,
 	minimumTokens: MINIMUM_TOKEN_DEFAULT,
+	maskKeep: 10,
+	maskMinTokens: 5_000,
 };
 
 /** Clamp to [0, 100]; non-numbers fall back. */
@@ -35,6 +41,12 @@ function minimumTokensOr(v: unknown, fallback: number): number {
 	return Math.max(MINIMUM_TOKEN_FLOOR, Math.round(v));
 }
 
+/** Non-negative integer; non-numbers fall back. */
+function countOr(v: unknown, fallback: number): number {
+	if (typeof v !== "number" || !Number.isFinite(v)) return fallback;
+	return Math.max(0, Math.round(v));
+}
+
 function parseTokenString(label: string): number | undefined {
 	const raw = label.trim();
 	if (!raw) return undefined;
@@ -60,6 +72,8 @@ export const compactionSection = defineSection<"compaction", CompactionConfig>({
 		return {
 			triggerPercent: pctOr(raw.triggerPercent, DEFAULTS.triggerPercent),
 			minimumTokens: minimumTokensOr(coercedMin, DEFAULTS.minimumTokens),
+			maskKeep: countOr(raw.maskKeep, DEFAULTS.maskKeep),
+			maskMinTokens: countOr(raw.maskMinTokens, DEFAULTS.maskMinTokens),
 		};
 	},
 });

package/src/sections/edit.ts

@@ -0,0 +1,21 @@
+import { boolOr, defineSection, isObj } from "../schema.ts";
+
+export interface EditConfig {
+	/** Restore the file and fail the edit when LSP reports new syntax errors after it. */
+	rejectNewSyntaxErrors: boolean;
+}
+
+const DEFAULTS: Readonly<EditConfig> = {
+	rejectNewSyntaxErrors: false,
+};
+
+export const editSection = defineSection<"edit", EditConfig>({
+	key: "edit",
+	defaults: DEFAULTS,
+	parse(raw) {
+		if (!isObj(raw)) return { ...DEFAULTS };
+		return {
+			rejectNewSyntaxErrors: boolOr(raw.rejectNewSyntaxErrors, DEFAULTS.rejectNewSyntaxErrors),
+		};
+	},
+});

package/src/sections/index.ts

@@ -1,5 +1,6 @@
 export { type CollapseConfig, collapseSection } from "./collapse.ts";
 export { type CompactionConfig, compactionSection } from "./compaction.ts";
+export { type EditConfig, editSection } from "./edit.ts";
 export {
 	type GateConfig,
 	type GateRuleConfig,
@@ -25,6 +26,7 @@ export {
 
 import { collapseSection } from "./collapse.ts";
 import { compactionSection } from "./compaction.ts";
+import { editSection } from "./edit.ts";
 import { gateSection } from "./gate.ts";
 import { ioSection } from "./io.ts";
 import { optimizerSection } from "./optimizer.ts";
@@ -50,6 +52,7 @@ export const builtinSections = [
 	optimizerSection,
 	gateSection,
 	compactionSection,
+	editSection,
 	fetchSection,
 	searchSection,
 	voiceSection,