pi-reasoning-zip 0.2.5 → 0.2.6

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.6] - 2026-07-03
+
+### Changed
+
+- Replaced `thresholds.targetRatio` with `compressionRole` presets for compactor prompt style.
+
 ## [0.2.5] - 2026-07-03
 
 ### Fixed
@@ -78,7 +84,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added package motto to README.
 - Added npm release metadata: description, keywords, repository links, exports, and Node engine.
 
-[Unreleased]: https://github.com/Ryu-CZ/pi-reasoning-zip/compare/v0.2.5...HEAD
+[Unreleased]: https://github.com/Ryu-CZ/pi-reasoning-zip/compare/v0.2.6...HEAD
+[0.2.6]: https://github.com/Ryu-CZ/pi-reasoning-zip/compare/v0.2.5...v0.2.6
 [0.2.5]: https://github.com/Ryu-CZ/pi-reasoning-zip/compare/v0.2.4...v0.2.5
 [0.2.4]: https://github.com/Ryu-CZ/pi-reasoning-zip/compare/v0.2.3...v0.2.4
 [0.2.3]: https://github.com/Ryu-CZ/pi-reasoning-zip/compare/v0.2.2...v0.2.3

package/README.md

@@ -27,7 +27,7 @@ Compress reasoning blocks to keep the context short.
 verbose thinking block  ->  facts / decisions / constraints / failed / next
 ```
 
-Use this when local models expose long reasoning and you want future Pi turns to replay compact traces instead of raw reasoning haystacks.
+Use this when local models expose long reasoning and you want future Pi turns to replay compact traces instead of raw reasoning as verbose prose.
 
 ## Install
 
@@ -83,6 +83,7 @@ Settings live in project `.pi/settings.json` or global `~/.pi/agent/settings.jso
     "enabled": true,
     "mode": "llama-only",
     "storageMode": "compact-new",
+    "compressionRole": "grug",
     "injectPrompt": true,
     "compactor": {
       "baseUrl": "http://127.0.0.1:7484/v1",
@@ -94,7 +95,6 @@ Settings live in project `.pi/settings.json` or global `~/.pi/agent/settings.jso
     },
     "thresholds": {
       "minChars": 1000,
-      "targetRatio": 0.15,
       "maxTraceChars": 2000
     }
   }
@@ -117,6 +117,14 @@ Settings live in project `.pi/settings.json` or global `~/.pi/agent/settings.jso
 | `compact-new` | Compact new assistant thinking before storage |
 | `off` | Do not alter assistant messages |
 
+### Compression roles
+
+| Role | Behavior |
+|---|---|
+| `balanced` | concise bullets while preserving extra context |
+| `grug` | terse, keyword-heavy default |
+| `ultra-grug` | most aggressive fragment-style trace |
+
 ## Compactor endpoint
 
 The compactor must expose an OpenAI-compatible chat completions endpoint:
@@ -142,7 +150,7 @@ next:
 - ...
 ```
 
-If the compactor returns `none`, empty output, output above `thresholds.targetRatio` of the original length, output longer than the original, or output over `thresholds.maxTraceChars`, the original block is preserved.
+The configured `compressionRole` guides the compactor's terse style. If the compactor returns `none`, empty output, output longer than the original, or output over `thresholds.maxTraceChars`, the original block is preserved.
 
 ## Safety model
 

package/dist/compactPrompt.d.ts

@@ -1 +1,2 @@
-export declare function buildCompactionPrompt(thinking: string): string;
+import type { ReasoningZipCompressionRole } from "./types.js";
+export declare function buildCompactionPrompt(thinking: string, compressionRole?: ReasoningZipCompressionRole): string;

package/dist/compactPrompt.js

@@ -1,10 +1,15 @@
-export function buildCompactionPrompt(thinking) {
+const ROLE_INSTRUCTIONS = {
+    balanced: "Compression role: balanced. Use concise bullets, but keep enough context that another coding agent can continue without guessing.",
+    grug: "Compression role: grug. Few words. Keyword-heavy. No prose. Keep only useful state for the next coding turn.",
+    "ultra-grug": "Compression role: ultra-grug. Compress hard. Fragment bullets only. Symbols and exact names over sentences. Keep only critical state.",
+};
+export function buildCompactionPrompt(thinking, compressionRole = "grug") {
     return `Compress this model reasoning into a compact decision trace for future coding-agent context.
 
 Keep exact paths, commands, symbols, errors, decisions, constraints, failed attempts, and next actions.
 Drop self-talk, repeated planning, obvious reasoning, filler, and prose.
 Use terse bullets under: facts, decisions, constraints, failed, next.
-Target 10-20% of original length.
+${ROLE_INSTRUCTIONS[compressionRole]}
 If no useful content remains, output exactly: none
 
 Reasoning:

package/dist/compactorClient.js

@@ -4,7 +4,7 @@ function buildPayload(thinking, settings, disableThinking) {
         model: settings.compactor.model,
         messages: [
             { role: "system", content: "You compress reasoning traces. Output only compact trace." },
-            { role: "user", content: buildCompactionPrompt(thinking) },
+            { role: "user", content: buildCompactionPrompt(thinking, settings.compressionRole) },
         ],
         max_tokens: settings.compactor.maxTokens,
         temperature: settings.compactor.temperature,

package/dist/messageTransform.js

@@ -16,8 +16,6 @@ function acceptableCompaction(original, compacted, settings) {
         return undefined;
     if (text.length >= original.length)
         return undefined;
-    if (text.length / original.length > settings.thresholds.targetRatio)
-        return undefined;
     if (text.length > settings.thresholds.maxTraceChars)
         return undefined;
     return text;

package/dist/settings.js

@@ -2,6 +2,7 @@ export const DEFAULT_SETTINGS = {
     enabled: true,
     mode: "llama-only",
     storageMode: "compact-new",
+    compressionRole: "grug",
     injectPrompt: true,
     compactor: {
         baseUrl: "http://127.0.0.1:7484/v1",
@@ -13,12 +14,12 @@ export const DEFAULT_SETTINGS = {
     },
     thresholds: {
         minChars: 1000,
-        targetRatio: 0.15,
         maxTraceChars: 2000,
     },
 };
 const modes = new Set(["llama-only", "local-only", "all", "disabled"]);
 const storageModes = new Set(["compact-new", "off"]);
+const compressionRoles = new Set(["balanced", "grug", "ultra-grug"]);
 function asObject(value) {
     return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
@@ -39,10 +40,14 @@ export function resolveReasoningZipSettings(input) {
     const storageMode = storageModes.has(root.storageMode)
         ? root.storageMode
         : DEFAULT_SETTINGS.storageMode;
+    const compressionRole = compressionRoles.has(root.compressionRole)
+        ? root.compressionRole
+        : DEFAULT_SETTINGS.compressionRole;
     return {
         enabled: booleanValue(root.enabled, DEFAULT_SETTINGS.enabled),
         mode,
         storageMode,
+        compressionRole,
         injectPrompt: booleanValue(root.injectPrompt, DEFAULT_SETTINGS.injectPrompt),
         compactor: {
             baseUrl: stringValue(compactor.baseUrl, DEFAULT_SETTINGS.compactor.baseUrl).replace(/\/$/, ""),
@@ -54,7 +59,6 @@ export function resolveReasoningZipSettings(input) {
         },
         thresholds: {
             minChars: numberValue(thresholds.minChars, DEFAULT_SETTINGS.thresholds.minChars, 0),
-            targetRatio: numberValue(thresholds.targetRatio, DEFAULT_SETTINGS.thresholds.targetRatio, 0),
             maxTraceChars: numberValue(thresholds.maxTraceChars, DEFAULT_SETTINGS.thresholds.maxTraceChars, 1),
         },
     };

package/dist/types.d.ts

@@ -1,9 +1,11 @@
 export type ReasoningZipMode = "llama-only" | "local-only" | "all" | "disabled";
 export type ReasoningZipStorageMode = "compact-new" | "off";
+export type ReasoningZipCompressionRole = "balanced" | "grug" | "ultra-grug";
 export interface ReasoningZipSettings {
     enabled: boolean;
     mode: ReasoningZipMode;
     storageMode: ReasoningZipStorageMode;
+    compressionRole: ReasoningZipCompressionRole;
     injectPrompt: boolean;
     compactor: {
         baseUrl: string;
@@ -15,7 +17,6 @@ export interface ReasoningZipSettings {
     };
     thresholds: {
         minChars: number;
-        targetRatio: number;
         maxTraceChars: number;
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-reasoning-zip",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "private": false,
   "description": "Compact reasoning blocks to keep the context short.",
   "license": "MIT",

package/scripts/smoke-extension.mjs

@@ -15,7 +15,7 @@ try {
     JSON.stringify({
       reasoningZip: {
         mode: "llama-only",
-        thresholds: { minChars: 5, targetRatio: 1, maxTraceChars: 100 },
+        thresholds: { minChars: 5, maxTraceChars: 100 },
         compactor: { baseUrl: "http://mock.local/v1", model: "mock", timeoutMs: 1000 },
       },
     }),

package/src/compactPrompt.ts

@@ -1,10 +1,18 @@
-export function buildCompactionPrompt(thinking: string): string {
+import type { ReasoningZipCompressionRole } from "./types.js";
+
+const ROLE_INSTRUCTIONS: Record<ReasoningZipCompressionRole, string> = {
+  balanced: "Compression role: balanced. Use concise bullets, but keep enough context that another coding agent can continue without guessing.",
+  grug: "Compression role: grug. Few words. Keyword-heavy. No prose. Keep only useful state for the next coding turn.",
+  "ultra-grug": "Compression role: ultra-grug. Compress hard. Fragment bullets only. Symbols and exact names over sentences. Keep only critical state.",
+};
+
+export function buildCompactionPrompt(thinking: string, compressionRole: ReasoningZipCompressionRole = "grug"): string {
   return `Compress this model reasoning into a compact decision trace for future coding-agent context.
 
 Keep exact paths, commands, symbols, errors, decisions, constraints, failed attempts, and next actions.
 Drop self-talk, repeated planning, obvious reasoning, filler, and prose.
 Use terse bullets under: facts, decisions, constraints, failed, next.
-Target 10-20% of original length.
+${ROLE_INSTRUCTIONS[compressionRole]}
 If no useful content remains, output exactly: none
 
 Reasoning:

package/src/compactorClient.ts

@@ -6,7 +6,7 @@ function buildPayload(thinking: string, settings: ReasoningZipSettings, disableT
     model: settings.compactor.model,
     messages: [
       { role: "system", content: "You compress reasoning traces. Output only compact trace." },
-      { role: "user", content: buildCompactionPrompt(thinking) },
+      { role: "user", content: buildCompactionPrompt(thinking, settings.compressionRole) },
     ],
     max_tokens: settings.compactor.maxTokens,
     temperature: settings.compactor.temperature,

package/src/messageTransform.ts

@@ -22,7 +22,6 @@ function acceptableCompaction(original: string, compacted: string, settings: Rea
   const text = compacted.trim();
   if (!text || text === "none") return undefined;
   if (text.length >= original.length) return undefined;
-  if (text.length / original.length > settings.thresholds.targetRatio) return undefined;
   if (text.length > settings.thresholds.maxTraceChars) return undefined;
   return text;
 }

package/src/settings.ts

@@ -1,9 +1,10 @@
-import type { ReasoningZipMode, ReasoningZipSettings, ReasoningZipStorageMode } from "./types.js";
+import type { ReasoningZipCompressionRole, ReasoningZipMode, ReasoningZipSettings, ReasoningZipStorageMode } from "./types.js";
 
 export const DEFAULT_SETTINGS: ReasoningZipSettings = {
   enabled: true,
   mode: "llama-only",
   storageMode: "compact-new",
+  compressionRole: "grug",
   injectPrompt: true,
   compactor: {
     baseUrl: "http://127.0.0.1:7484/v1",
@@ -15,13 +16,13 @@ export const DEFAULT_SETTINGS: ReasoningZipSettings = {
   },
   thresholds: {
     minChars: 1000,
-    targetRatio: 0.15,
     maxTraceChars: 2000,
   },
 };
 
 const modes = new Set<ReasoningZipMode>(["llama-only", "local-only", "all", "disabled"]);
 const storageModes = new Set<ReasoningZipStorageMode>(["compact-new", "off"]);
+const compressionRoles = new Set<ReasoningZipCompressionRole>(["balanced", "grug", "ultra-grug"]);
 
 function asObject(value: unknown): Record<string, unknown> {
   return value && typeof value === "object" && !Array.isArray(value) ? (value as Record<string, unknown>) : {};
@@ -48,11 +49,15 @@ export function resolveReasoningZipSettings(input: unknown): ReasoningZipSetting
   const storageMode = storageModes.has(root.storageMode as ReasoningZipStorageMode)
     ? (root.storageMode as ReasoningZipStorageMode)
     : DEFAULT_SETTINGS.storageMode;
+  const compressionRole = compressionRoles.has(root.compressionRole as ReasoningZipCompressionRole)
+    ? (root.compressionRole as ReasoningZipCompressionRole)
+    : DEFAULT_SETTINGS.compressionRole;
 
   return {
     enabled: booleanValue(root.enabled, DEFAULT_SETTINGS.enabled),
     mode,
     storageMode,
+    compressionRole,
     injectPrompt: booleanValue(root.injectPrompt, DEFAULT_SETTINGS.injectPrompt),
     compactor: {
       baseUrl: stringValue(compactor.baseUrl, DEFAULT_SETTINGS.compactor.baseUrl).replace(/\/$/, ""),
@@ -64,7 +69,6 @@ export function resolveReasoningZipSettings(input: unknown): ReasoningZipSetting
     },
     thresholds: {
       minChars: numberValue(thresholds.minChars, DEFAULT_SETTINGS.thresholds.minChars, 0),
-      targetRatio: numberValue(thresholds.targetRatio, DEFAULT_SETTINGS.thresholds.targetRatio, 0),
       maxTraceChars: numberValue(thresholds.maxTraceChars, DEFAULT_SETTINGS.thresholds.maxTraceChars, 1),
     },
   };

package/src/types.ts

@@ -1,10 +1,12 @@
 export type ReasoningZipMode = "llama-only" | "local-only" | "all" | "disabled";
 export type ReasoningZipStorageMode = "compact-new" | "off";
+export type ReasoningZipCompressionRole = "balanced" | "grug" | "ultra-grug";
 
 export interface ReasoningZipSettings {
   enabled: boolean;
   mode: ReasoningZipMode;
   storageMode: ReasoningZipStorageMode;
+  compressionRole: ReasoningZipCompressionRole;
   injectPrompt: boolean;
   compactor: {
     baseUrl: string;
@@ -16,7 +18,6 @@ export interface ReasoningZipSettings {
   };
   thresholds: {
     minChars: number;
-    targetRatio: number;
     maxTraceChars: number;
   };
 }