harnesstrim 0.0.2 → 0.0.3

package/dist/cli.mjs

@@ -22747,11 +22747,23 @@ function pluginIndex(plugin) {
     (e) => typeof e === "string" && e.includes(OPENCODE_PLUGIN_NAME) || Array.isArray(e) && typeof e[0] === "string" && e[0].includes(OPENCODE_PLUGIN_NAME)
   );
 }
+function legacyPluginIndex(plugin) {
+  return plugin.findIndex(
+    (entry) => typeof entry === "object" && entry !== null && typeof entry.name === "string" && entry.name.includes(OPENCODE_PLUGIN_NAME)
+  );
+}
 function planOpencodeInstall(config2, adapterConfig) {
   const base = typeof config2 === "object" && config2 !== null ? { ...config2 } : {};
   const plugin = Array.isArray(base.plugin) ? [...base.plugin] : [];
   const desired = adapterConfig ? [OPENCODE_PLUGIN_NAME, adapterConfig] : OPENCODE_PLUGIN_NAME;
   const idx = pluginIndex(plugin);
+  const legacyIdx = idx === -1 ? legacyPluginIndex(plugin) : -1;
+  if (legacyIdx !== -1) {
+    const legacy = plugin[legacyIdx];
+    const options = legacy.options;
+    plugin[legacyIdx] = adapterConfig ? desired : typeof options === "object" && options !== null && !Array.isArray(options) ? [OPENCODE_PLUGIN_NAME, options] : OPENCODE_PLUGIN_NAME;
+    return { nextConfig: { ...base, plugin }, alreadyInstalled: true, changed: true };
+  }
   if (idx === -1) {
     plugin.push(desired);
     return { nextConfig: { ...base, plugin }, alreadyInstalled: false, changed: true };
@@ -22801,7 +22813,56 @@ import path6 from "node:path";
 
 // ../adapter-codex/src/index.ts
 import path3 from "node:path";
+
+// ../adapter-codex/src/hook.ts
+init_src();
+function reduceCodexPayload(rawJson, minLength) {
+  const extracted = extractToolOutput(rawJson);
+  if (extracted === null) return { response: "{}", event: null };
+  const result = reduceAuto(extracted.output, minLength);
+  if (!result.changed) return { response: "{}", event: null };
+  const response = JSON.stringify({
+    decision: "block",
+    reason: `HarnessTrim reduced ${extracted.toolName} output (${result.reducer}):
+
+${result.output}`
+  });
+  return {
+    response,
+    event: {
+      tool: extracted.toolName,
+      reducer: result.reducer,
+      beforeChars: extracted.output.length,
+      afterChars: result.output.length
+    }
+  };
+}
+function extractToolOutput(rawJson) {
+  let payload;
+  try {
+    payload = JSON.parse(rawJson);
+  } catch {
+    return null;
+  }
+  if (typeof payload !== "object" || payload === null) return null;
+  const p = payload;
+  const output = extractOutputText(p.tool_response);
+  return output === null ? null : { toolName: typeof p.tool_name === "string" ? p.tool_name : "unknown", output };
+}
+function extractOutputText(response) {
+  if (typeof response === "string") return response;
+  if (typeof response !== "object" || response === null) return null;
+  const r = response;
+  for (const key of ["stdout", "output", "content"]) {
+    if (typeof r[key] === "string") return r[key];
+  }
+  return null;
+}
+
+// ../adapter-codex/src/index.ts
 var HARNESSTRIM_MARKER = "harnesstrim:begin";
+var CODEX_HOOK_COMMAND = "harnesstrim hook codex --metrics .harnesstrim/metrics.jsonl";
+var CODEX_HOOK_MATCHER = "^Bash$";
 var REDUCE_INSTRUCTION_SNIPPET = `<!-- ${HARNESSTRIM_MARKER} -->
 ## Token economy (HarnessTrim)
 
@@ -22814,6 +22875,45 @@ This keeps failures, errors, assertions, and summaries while dropping passing-te
 generated-file (lockfile/dist) diffs. Prefer the installed skills for output, review, and
 scaffolding discipline.
 <!-- harnesstrim:end -->`;
+function hasHarnessTrimHook(document) {
+  const hooks = document.hooks;
+  const post = hooks?.PostToolUse;
+  if (!Array.isArray(post)) return false;
+  return post.some(
+    (entry) => Array.isArray(entry?.hooks) && entry.hooks.some((hook) => typeof hook?.command === "string" && hook.command.includes("harnesstrim hook codex"))
+  );
+}
+function planCodexHookInstall(input) {
+  let document = {};
+  let action;
+  if (input.hooksJsonContent === null) {
+    action = "create";
+  } else {
+    let parsed;
+    try {
+      parsed = JSON.parse(input.hooksJsonContent);
+    } catch {
+      throw new Error(".codex/hooks.json is not valid JSON; refusing to overwrite it.");
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      throw new Error(".codex/hooks.json must contain a JSON object; refusing to overwrite it.");
+    }
+    document = parsed;
+    action = hasHarnessTrimHook(document) ? "present" : "patch";
+  }
+  if (action === "present") {
+    return { hooksFile: path3.join(input.projectDir, ".codex", "hooks.json"), action, nextHooks: document };
+  }
+  const hooks = { ...document.hooks ?? {} };
+  const post = Array.isArray(hooks.PostToolUse) ? [...hooks.PostToolUse] : [];
+  post.push({ matcher: CODEX_HOOK_MATCHER, hooks: [{ type: "command", command: CODEX_HOOK_COMMAND }] });
+  hooks.PostToolUse = post;
+  return {
+    hooksFile: path3.join(input.projectDir, ".codex", "hooks.json"),
+    action,
+    nextHooks: { ...document, hooks }
+  };
+}
 function planCodexInstall(input) {
   const skillsDest = path3.join(input.projectDir, ".codex", "skills");
   const existing = new Set(input.existingSkillNames);
@@ -22881,7 +22981,20 @@ function existingSkillNames(dest) {
 }
 
 // src/install-codex.ts
-function runInstallCodex(dir, apply) {
+function readHooksJson(hooksPath) {
+  try {
+    return fs5.readFileSync(hooksPath, "utf8");
+  } catch {
+    return null;
+  }
+}
+function applyHookPlan(plan, apply) {
+  if (!apply || plan.action === "present") return false;
+  fs5.mkdirSync(path6.dirname(plan.hooksFile), { recursive: true });
+  fs5.writeFileSync(plan.hooksFile, JSON.stringify(plan.nextHooks, null, 2) + "\n");
+  return true;
+}
+function runInstallCodex(dir, apply, hook = false) {
   const skillsSourceDir = resolveSkillsSourceDir();
   const skillNames = listShippedSkills(skillsSourceDir);
   const skillsDest = path6.join(dir, ".codex", "skills");
@@ -22899,6 +23012,9 @@ function runInstallCodex(dir, apply) {
     agentsMdContent,
     existingSkillNames: existingSkillNames(skillsDest)
   });
+  const hooksPath = path6.join(dir, ".codex", "hooks.json");
+  const hooksJsonContent = hook ? readHooksJson(hooksPath) : null;
+  const hookPlan = hook ? planCodexHookInstall({ projectDir: dir, hooksJsonContent }) : null;
   const copied = [];
   let applied = false;
   if (apply) {
@@ -22912,9 +23028,20 @@ function runInstallCodex(dir, apply) {
     } else if (plan.instructionsAction === "append") {
       fs5.appendFileSync(plan.instructionsFile, "\n\n" + plan.instructionsSnippet + "\n");
     }
+    if (hookPlan) applyHookPlan(hookPlan, true);
     applied = true;
   }
-  return { plan, applied, copied };
+  return { plan, hookPlan, applied, copied };
+}
+function runInstallCodexGlobalHook(codexHome, apply) {
+  const hooksPath = path6.join(codexHome, "hooks.json");
+  const hookPlan = planCodexHookInstall({
+    // The planner expects the directory that contains .codex; for a user-level config
+    // the Codex home is itself that directory, so add its parent and use a normal path.
+    projectDir: path6.dirname(codexHome),
+    hooksJsonContent: readHooksJson(hooksPath)
+  });
+  return { hookPlan, applied: applyHookPlan(hookPlan, apply) };
 }
 
 // src/install-claude.ts
@@ -22924,7 +23051,7 @@ import path8 from "node:path";
 // ../adapter-claude/src/hook.ts
 init_src();
 function reduceClaudePayload(rawJson, minLength) {
-  const extracted = extractToolOutput(rawJson);
+  const extracted = extractToolOutput2(rawJson);
   if (extracted === null) return { response: "{}", event: null };
   const result = reduceAuto(extracted.output, minLength);
   if (!result.changed) return { response: "{}", event: null };
@@ -22944,7 +23071,7 @@ function reduceClaudePayload(rawJson, minLength) {
     }
   };
 }
-function extractToolOutput(rawJson) {
+function extractToolOutput2(rawJson) {
   let payload;
   try {
     payload = JSON.parse(rawJson);
@@ -22954,10 +23081,10 @@ function extractToolOutput(rawJson) {
   if (typeof payload !== "object" || payload === null) return null;
   const p = payload;
   const toolName = typeof p.tool_name === "string" ? p.tool_name : "unknown";
-  const output = extractOutputText(p);
+  const output = extractOutputText2(p);
   return output === null ? null : { toolName, output };
 }
-function extractOutputText(p) {
+function extractOutputText2(p) {
   if (typeof p.tool_output === "string") return p.tool_output;
   const resp = p.tool_response;
   if (typeof resp === "string") return resp;
@@ -22974,7 +23101,7 @@ function extractOutputText(p) {
 import path7 from "node:path";
 var HOOK_COMMAND = "harnesstrim hook claude";
 var HOOK_MATCHER = "Bash";
-function hasHarnessTrimHook(settings) {
+function hasHarnessTrimHook2(settings) {
   const hooks = settings.hooks;
   const post = hooks?.PostToolUse;
   if (!Array.isArray(post)) return false;
@@ -23002,7 +23129,7 @@ function planClaudeInstall(input) {
     } catch {
       settings = {};
     }
-    action = hasHarnessTrimHook(settings) ? "present" : "patch";
+    action = hasHarnessTrimHook2(settings) ? "present" : "patch";
   }
   const nextSettings = action === "present" ? settings : addHook(settings);
   return {
@@ -23327,12 +23454,42 @@ function renderCodexInstall(result, apply) {
   lines.push("");
   const instr = plan.instructionsAction === "present" ? "AGENTS.md already contains the HarnessTrim instruction (no change)." : plan.instructionsAction === "create" ? `AGENTS.md ${apply ? "created" : "would be created"} with the reduce-pipe instruction.` : `Reduce-pipe instruction ${apply ? "appended" : "would be appended"} to AGENTS.md.`;
   lines.push(instr);
+  if (result.hookPlan) {
+    lines.push("");
+    if (result.hookPlan.action === "present") {
+      lines.push(`${result.hookPlan.hooksFile}: HarnessTrim Bash PostToolUse hook already present (no change).`);
+    } else {
+      lines.push(
+        `${result.hookPlan.hooksFile}: experimental Bash PostToolUse hook ${apply ? result.hookPlan.action === "create" ? "created" : "added" : "would be added"}.`
+      );
+      lines.push("It reduces simple Bash output automatically and records JSONL telemetry in .harnesstrim/metrics.jsonl.");
+      if (!apply) {
+        lines.push("Resulting hooks.json:");
+        lines.push(JSON.stringify(result.hookPlan.nextHooks, null, 2));
+      }
+    }
+  }
   if (!apply) {
     lines.push("");
     lines.push("Dry run \u2014 nothing written. Re-run with `--apply`.");
   }
   return lines.join("\n");
 }
+function renderCodexGlobalHookInstall(result, apply) {
+  const lines = [`${apply ? "Installed" : "Would install"} global Codex Bash PostToolUse hook`, ""];
+  if (result.hookPlan.action === "present") {
+    lines.push(`${result.hookPlan.hooksFile}: HarnessTrim hook already present (no change).`);
+  } else {
+    lines.push(`${result.hookPlan.hooksFile}: experimental Bash PostToolUse hook ${apply ? result.hookPlan.action === "create" ? "created" : "added" : "would be added"}.`);
+    lines.push("It applies in trusted projects and writes telemetry to each project's .harnesstrim/metrics.jsonl.");
+    if (!apply) {
+      lines.push("Resulting hooks.json:");
+      lines.push(JSON.stringify(result.hookPlan.nextHooks, null, 2));
+    }
+  }
+  if (!apply) lines.push("", "Dry run \u2014 nothing written. Re-run with `--apply`.");
+  return lines.join("\n");
+}
 function renderClaudeInstall(result, apply) {
   const { plan } = result;
   const lines = [];
@@ -23444,8 +23601,10 @@ Usage:
   harnesstrim install opencode [dir]       Wire the adapter into opencode.json (dry-run)
                             --apply         Actually write the change
                             --preset <name> Bake a policy preset's adapter config in
-  harnesstrim install codex [dir]          Install skills + AGENTS.md reduce-pipe (dry-run)
+  harnesstrim install codex [dir]          Install skills + AGENTS.md reduction guidance (dry-run)
                             --apply         Actually write the change
+                            --hook          Also install the experimental Bash PostToolUse hook
+                            --global        With --hook, install it once in ~/.codex (no project files)
   harnesstrim install claude [dir]         Install skills + PostToolUse reducer hook (dry-run)
                             --apply         Actually write the change
   harnesstrim install hermes [dir]         Install Hermes plugin (dry-run)
@@ -23454,6 +23613,8 @@ Usage:
                             --apply         Actually write the change
   harnesstrim hook claude [--metrics <path>]
                                            PostToolUse hook runtime; --metrics records a TrimEvent per reduction
+  harnesstrim hook codex [--metrics <path>]
+                                           PostToolUse runtime for Codex's experimental Bash hook
   harnesstrim preset list                  List policy presets
   harnesstrim preset show <name>           Show a preset in detail
   harnesstrim metrics [path]               Summarize adapter telemetry (JSONL)
@@ -23477,7 +23638,9 @@ async function main(argv) {
       stats: { type: "boolean" },
       "min-length": { type: "string" },
       log: { type: "string" },
-      metrics: { type: "string" }
+      metrics: { type: "string" },
+      hook: { type: "boolean" },
+      global: { type: "boolean" }
     }
   });
   const [command, ...rest] = positionals;
@@ -23501,7 +23664,15 @@ async function main(argv) {
         return 0;
       }
       if (target === "codex") {
-        console.log(renderCodexInstall(runInstallCodex(dir, apply), apply));
+        if (values.global === true) {
+          if (values.hook !== true) {
+            console.error("`harnesstrim install codex --global` requires `--hook`.");
+            return 1;
+          }
+          console.log(renderCodexGlobalHookInstall(runInstallCodexGlobalHook(path14.join(os2.homedir(), ".codex"), apply), apply));
+          return 0;
+        }
+        console.log(renderCodexInstall(runInstallCodex(dir, apply, values.hook === true), apply));
         return 0;
       }
       if (target === "claude") {
@@ -23521,12 +23692,12 @@ async function main(argv) {
     }
     case "hook": {
       const which = rest[0];
-      if (which !== "claude") {
-        console.error(`Unknown hook target: ${which ?? "(none)"}. Supported: claude.`);
+      if (which !== "claude" && which !== "codex") {
+        console.error(`Unknown hook target: ${which ?? "(none)"}. Supported: claude, codex.`);
         return 1;
       }
       const input = await readStdin();
-      const { response, event } = reduceClaudePayload(input);
+      const { response, event } = which === "claude" ? reduceClaudePayload(input) : reduceCodexPayload(input);
       process.stdout.write(response);
       if (values.metrics && event) {
         try {
@@ -23534,7 +23705,7 @@ async function main(argv) {
           fs10.mkdirSync(path14.dirname(p), { recursive: true });
           fs10.appendFileSync(
             p,
-            JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), harness: "claude", ...event }) + "\n"
+            JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), harness: which, ...event }) + "\n"
           );
         } catch {
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harnesstrim",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "HarnessTrim CLI: doctor (diagnose token waste), install adapters, run benchmarks.",
   "license": "MIT",
   "type": "module",