harnesstrim 0.0.7 → 0.1.0

package/assets/adapter-hermes/plugin/__init__.py

@@ -236,6 +236,7 @@ def _write_metric(tool: str, reducer: str | None, before: int, after: int) -> No
         "reducer": reducer,
         "beforeChars": before,
         "afterChars": after,
+        "changed": True,
         "beforeTokens": None,
         "afterTokens": None,
     }

package/dist/cli.mjs

@@ -724,6 +724,7 @@ function makeTrimEvent(partial2) {
     reducer: partial2.reducer,
     beforeChars: partial2.beforeChars,
     afterChars: partial2.afterChars,
+    changed: partial2.changed ?? true,
     beforeTokens: partial2.beforeTokens ?? null,
     afterTokens: partial2.afterTokens ?? null
   };
@@ -735,10 +736,30 @@ function pct(before, after) {
 function summarize(events) {
   let beforeChars = 0;
   let afterChars = 0;
+  let reduced = 0;
+  let passThrough = 0;
+  let reductionErrors = 0;
+  let grewChars = 0;
   const byReducerMap = /* @__PURE__ */ new Map();
+  const byHarnessMap = /* @__PURE__ */ new Map();
   for (const e of events) {
     beforeChars += e.beforeChars;
     afterChars += e.afterChars;
+    if (e.changed === false) {
+      passThrough++;
+    } else if (e.afterChars > e.beforeChars) {
+      reductionErrors++;
+      grewChars += e.afterChars - e.beforeChars;
+    } else {
+      reduced++;
+    }
+    const harness = e.harness ?? "unknown";
+    const h = byHarnessMap.get(harness) ?? { harness, count: 0, beforeChars: 0, afterChars: 0, savedChars: 0, reductionPct: 0 };
+    h.count += 1;
+    h.beforeChars += e.beforeChars;
+    h.afterChars += e.afterChars;
+    h.savedChars += e.beforeChars - e.afterChars;
+    byHarnessMap.set(harness, h);
     if (e.reducer === null) continue;
     const b = byReducerMap.get(e.reducer) ?? { reducer: e.reducer, count: 0, beforeChars: 0, afterChars: 0, savedChars: 0 };
     b.count += 1;
@@ -748,13 +769,20 @@ function summarize(events) {
     byReducerMap.set(e.reducer, b);
   }
   const byReducer = [...byReducerMap.values()].sort((a, b) => b.savedChars - a.savedChars);
+  const byHarness = [...byHarnessMap.values()].map((h) => ({ ...h, reductionPct: pct(h.beforeChars, h.afterChars) })).sort((a, b) => b.savedChars - a.savedChars);
   return {
     events: events.length,
     beforeChars,
     afterChars,
     savedChars: beforeChars - afterChars,
     reductionPct: pct(beforeChars, afterChars),
-    byReducer
+    byReducer,
+    byHarness,
+    reduced,
+    passThrough,
+    passThroughRate: events.length === 0 ? 0 : Math.round(passThrough / events.length * 1e3) / 10,
+    reductionErrors,
+    grewChars
   };
 }
 function parseTrimEvents(jsonl) {
@@ -787,6 +815,7 @@ function normalize(v) {
     reducer: v.reducer,
     beforeChars: v.beforeChars,
     afterChars: v.afterChars,
+    changed: typeof v.changed === "boolean" ? v.changed : true,
     beforeTokens: typeof v.beforeTokens === "number" ? v.beforeTokens : null,
     afterTokens: typeof v.afterTokens === "number" ? v.afterTokens : null
   };
@@ -22675,8 +22704,9 @@ function createFileSink(metricsPath) {
     }
   };
 }
-function runReduceTool(text, minLength, sink = noopSink) {
+function runReduceTool(text, minLength, sink = noopSink, trackPassThrough2 = true) {
   const result = reduceAuto(text, minLength);
+  const threshold = minLength ?? DEFAULT_MIN_LENGTH;
   if (result.changed) {
     sink(
       makeTrimEvent({
@@ -22687,11 +22717,23 @@ function runReduceTool(text, minLength, sink = noopSink) {
         afterChars: result.output.length
       })
     );
+  } else if (trackPassThrough2 && text.length >= threshold) {
+    sink(
+      makeTrimEvent({
+        harness: "mcp",
+        tool: "reduce",
+        reducer: null,
+        beforeChars: text.length,
+        afterChars: text.length,
+        changed: false
+      })
+    );
   }
   return { content: [{ type: "text", text: result.output }] };
 }
 function createServer(options = {}) {
   const sink = options.metricsPath ? createFileSink(options.metricsPath) : noopSink;
+  const trackPassThrough2 = options.trackPassThrough !== false;
   const server = new McpServer({ name: "harnesstrim", version: "0.0.1" });
   server.registerTool(
     "reduce",
@@ -22703,13 +22745,15 @@ function createServer(options = {}) {
         minLength: external_exports.number().optional().describe("Skip reduction for inputs shorter than this many characters (default 400)")
       }
     },
-    async ({ text, minLength }) => runReduceTool(text, minLength, sink)
+    async ({ text, minLength }) => runReduceTool(text, minLength, sink, trackPassThrough2)
   );
   return server;
 }
 async function startStdioServer(options = {}) {
   const metricsPath = options.metricsPath ?? process.env.HARNESSTRIM_TELEMETRY_PATH;
-  const server = createServer({ metricsPath });
+  const envTrack = process.env.HARNESSTRIM_TRACK_PASSTHROUGH;
+  const trackPassThrough2 = options.trackPassThrough ?? (envTrack !== void 0 ? envTrack !== "0" && envTrack !== "false" : true);
+  const server = createServer({ metricsPath, trackPassThrough: trackPassThrough2 });
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
@@ -23042,9 +23086,15 @@ import path3 from "node:path";
 init_src();
 function reduceCodexPayload(rawJson, minLength) {
   const extracted = extractToolOutput(rawJson);
-  if (extracted === null) return { response: "{}", event: null };
+  if (extracted === null) return { response: "{}", event: null, attempt: null };
   const result = reduceAuto(extracted.output, minLength);
-  if (!result.changed) return { response: "{}", event: null };
+  if (!result.changed) {
+    return {
+      response: "{}",
+      event: null,
+      attempt: extracted.output.length >= (minLength ?? DEFAULT_MIN_LENGTH) ? { tool: extracted.toolName, beforeChars: extracted.output.length } : null
+    };
+  }
   const response = JSON.stringify({
     decision: "block",
     reason: `HarnessTrim reduced ${extracted.toolName} output (${result.reducer}):
@@ -23058,7 +23108,8 @@ ${result.output}`
       reducer: result.reducer,
       beforeChars: extracted.output.length,
       afterChars: result.output.length
-    }
+    },
+    attempt: null
   };
 }
 function extractToolOutput(rawJson) {
@@ -23319,9 +23370,15 @@ import path8 from "node:path";
 init_src();
 function reduceClaudePayload(rawJson, minLength) {
   const extracted = extractToolOutput2(rawJson);
-  if (extracted === null) return { response: "{}", event: null };
+  if (extracted === null) return { response: "{}", event: null, attempt: null };
   const result = reduceAuto(extracted.output, minLength);
-  if (!result.changed) return { response: "{}", event: null };
+  if (!result.changed) {
+    return {
+      response: "{}",
+      event: null,
+      attempt: extracted.output.length >= (minLength ?? DEFAULT_MIN_LENGTH) ? { tool: extracted.toolName, beforeChars: extracted.output.length } : null
+    };
+  }
   const response = JSON.stringify({
     hookSpecificOutput: {
       hookEventName: "PostToolUse",
@@ -23335,7 +23392,8 @@ function reduceClaudePayload(rawJson, minLength) {
       reducer: result.reducer,
       beforeChars: extracted.output.length,
       afterChars: result.output.length
-    }
+    },
+    attempt: null
   };
 }
 function extractToolOutput2(rawJson) {
@@ -23675,7 +23733,7 @@ function loadMetrics(filePath) {
 // package.json
 var package_default = {
   name: "harnesstrim",
-  version: "0.0.7",
+  version: "0.1.0",
   description: "HarnessTrim CLI: doctor (diagnose token waste), install adapters, run benchmarks.",
   license: "MIT",
   type: "module",
@@ -24284,15 +24342,28 @@ Enable it in the adapter (telemetry: true) to record reductions.`;
   const lines = [
     `harnesstrim metrics \u2014 ${result.path}`,
     "",
-    `Reductions: ${s.events}`,
-    `Chars:      ${s.beforeChars} -> ${s.afterChars}  (saved ${s.savedChars}, -${s.reductionPct}%)`,
-    "",
-    "By reducer:"
+    `Attempts:     ${s.events} (${s.reduced} reduced, ${s.passThrough} pass-through, ${s.reductionErrors} error)`,
+    `Pass-through: ${s.passThroughRate}% of attempts unchanged`,
+    `Chars:        ${s.beforeChars} -> ${s.afterChars}  (saved ${s.savedChars}, -${s.reductionPct}%)`
   ];
+  if (s.reductionErrors > 0) {
+    lines.push(`Reduction errors: ${s.reductionErrors} attempt(s) GREW the output (+${s.grewChars} chars) \u2014 investigate`);
+  }
+  lines.push("");
+  lines.push("By reducer:");
   for (const b of s.byReducer) {
     const p = b.beforeChars === 0 ? 0 : Math.round(b.savedChars / b.beforeChars * 1e3) / 10;
     lines.push(`  ${b.reducer.padEnd(20)} ${b.count}x  saved ${b.savedChars} chars (-${p}%)`);
   }
+  if (s.byHarness.length > 0) {
+    lines.push("");
+    lines.push("By harness:");
+    for (const h of s.byHarness) {
+      const p = h.beforeChars === 0 ? 0 : Math.round(h.savedChars / h.beforeChars * 1e3) / 10;
+      const sign = p < 0 ? "" : "-";
+      lines.push(`  ${h.harness.padEnd(12)} ${h.count}x  saved ${h.savedChars} chars (${sign}${Math.abs(p)}%)`);
+    }
+  }
   return lines.join("\n");
 }
 function renderUninstall(result, apply) {
@@ -24665,22 +24736,39 @@ async function main(argv) {
         return 1;
       }
       const input = await readStdin();
-      const { response, event } = which === "claude" ? reduceClaudePayload(input) : reduceCodexPayload(input);
+      const { response, event, attempt } = which === "claude" ? reduceClaudePayload(input) : reduceCodexPayload(input);
       process.stdout.write(response);
-      if (values.metrics && event) {
+      if (values.metrics) {
         try {
           const p = path16.resolve(values.metrics);
           fs12.mkdirSync(path16.dirname(p), { recursive: true });
-          fs12.appendFileSync(
-            p,
-            JSON.stringify(
-              makeTrimEvent({
-                ts: (/* @__PURE__ */ new Date()).toISOString(),
-                harness: which,
-                ...event
-              })
-            ) + "\n"
-          );
+          if (event) {
+            fs12.appendFileSync(
+              p,
+              JSON.stringify(
+                makeTrimEvent({
+                  ts: (/* @__PURE__ */ new Date()).toISOString(),
+                  harness: which,
+                  ...event
+                })
+              ) + "\n"
+            );
+          } else if (attempt && trackPassThrough()) {
+            fs12.appendFileSync(
+              p,
+              JSON.stringify(
+                makeTrimEvent({
+                  ts: (/* @__PURE__ */ new Date()).toISOString(),
+                  harness: which,
+                  tool: attempt.tool,
+                  reducer: null,
+                  beforeChars: attempt.beforeChars,
+                  afterChars: attempt.beforeChars,
+                  changed: false
+                })
+              ) + "\n"
+            );
+          }
         } catch {
         }
       }
@@ -24734,23 +24822,40 @@ async function main(argv) {
       const input = await readStdin();
       const result = reducePipe(input, minLength);
       process.stdout.write(result.output);
-      if (values.metrics && result.changed) {
+      if (values.metrics) {
         try {
           const p = path16.resolve(values.metrics);
           fs12.mkdirSync(path16.dirname(p), { recursive: true });
-          fs12.appendFileSync(
-            p,
-            JSON.stringify(
-              makeTrimEvent({
-                ts: (/* @__PURE__ */ new Date()).toISOString(),
-                harness: "pipe",
-                tool: "reduce",
-                reducer: result.reducer,
-                beforeChars: result.beforeChars,
-                afterChars: result.afterChars
-              })
-            ) + "\n"
-          );
+          if (result.changed) {
+            fs12.appendFileSync(
+              p,
+              JSON.stringify(
+                makeTrimEvent({
+                  ts: (/* @__PURE__ */ new Date()).toISOString(),
+                  harness: "pipe",
+                  tool: "reduce",
+                  reducer: result.reducer,
+                  beforeChars: result.beforeChars,
+                  afterChars: result.afterChars
+                })
+              ) + "\n"
+            );
+          } else if (trackPassThrough() && input.length >= (minLength ?? DEFAULT_MIN_LENGTH)) {
+            fs12.appendFileSync(
+              p,
+              JSON.stringify(
+                makeTrimEvent({
+                  ts: (/* @__PURE__ */ new Date()).toISOString(),
+                  harness: "pipe",
+                  tool: "reduce",
+                  reducer: null,
+                  beforeChars: input.length,
+                  afterChars: input.length,
+                  changed: false
+                })
+              ) + "\n"
+            );
+          }
         } catch {
         }
       }
@@ -24796,6 +24901,10 @@ function parseModeFlag(value) {
 function splitTools(value) {
   return value.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
 }
+function trackPassThrough() {
+  const v = process.env.HARNESSTRIM_TRACK_PASSTHROUGH;
+  return v === void 0 || v !== "0" && v !== "false";
+}
 main(process.argv.slice(2)).then((code) => {
   process.exitCode = code;
 }).catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnesstrim",
-  "version": "0.0.7",
+  "version": "0.1.0",
   "description": "HarnessTrim CLI: doctor (diagnose token waste), install adapters, run benchmarks.",
   "license": "MIT",
   "type": "module",
@@ -15,18 +15,20 @@
     "access": "public"
   },
   "devDependencies": {
-    "esbuild": "^0.25.0",
-    "@harnesstrim/adapter-codex": "0.0.1",
-    "@harnesstrim/adapter-claude": "0.0.1",
-    "@harnesstrim/adapter-pi": "0.0.1",
-    "@harnesstrim/benchmarks": "0.0.1",
-    "@harnesstrim/mcp": "0.0.1",
-    "@harnesstrim/adapter-hermes": "0.0.1",
-    "@harnesstrim/core": "0.0.2"
+    "@harnesstrim/adapter-claude": "workspace:*",
+    "@harnesstrim/adapter-codex": "workspace:*",
+    "@harnesstrim/adapter-hermes": "workspace:*",
+    "@harnesstrim/adapter-pi": "workspace:*",
+    "@harnesstrim/benchmarks": "workspace:*",
+    "@harnesstrim/core": "workspace:*",
+    "@harnesstrim/mcp": "workspace:*",
+    "esbuild": "^0.25.0"
   },
   "scripts": {
     "build": "node build.mjs",
+    "prepare": "node build.mjs",
+    "prepack": "node build.mjs",
     "test": "node --test \"src/**/*.test.ts\"",
     "typecheck": "tsc -p tsconfig.json"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 HarnessTrim contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.