portable-agent-layer 0.61.3 → 0.62.0

package/src/tools/relationship-reflect.ts

@@ -26,6 +26,7 @@ import {
 } from "../hooks/lib/opinions";
 import { palHome } from "../hooks/lib/paths";
 import { similarity } from "../hooks/lib/text-similarity";
+import { emit } from "./lib/emit";
 
 // ── Types ──
 
@@ -413,11 +414,11 @@ Output:
   const notes = loadNotes(daysBack);
   const ratings = loadRatings(daysBack);
 
-  console.log(`Loaded ${notes.length} notes from last ${daysBack} days`);
-  console.log(`Loaded ${ratings.length} ratings`);
+  emit.ok(`Loaded ${notes.length} notes from last ${daysBack} days`);
+  emit.ok(`Loaded ${ratings.length} ratings`);
 
   if (notes.length === 0 && ratings.length === 0) {
-    console.log("No data to analyze");
+    emit.ok("No data to analyze");
     process.exit(0);
   }
 
@@ -425,42 +426,42 @@ Output:
 
   const avgRating =
     ratings.length > 0 ? ratings.reduce((s, r) => s + r.rating, 0) / ratings.length : 0;
-  console.log(`\nAverage Rating: ${avgRating.toFixed(1)}/10`);
+  emit.ok(`\nAverage Rating: ${avgRating.toFixed(1)}/10`);
 
   const summaries = groupNoteOccurrences(notes);
-  console.log(`Observations: ${summaries.length} unique`);
+  emit.ok(`Observations: ${summaries.length} unique`);
 
   if (opinionChanges.length > 0) {
-    console.log("\nOpinion changes:");
+    emit.ok("\nOpinion changes:");
     for (const change of opinionChanges) {
       if (change.action === "created") {
-        console.log(
+        emit.ok(
           `  + NEW (${Math.round(change.newConfidence * 100)}%) ${change.statement.slice(0, 80)}`
         );
       } else {
-        console.log(
+        emit.ok(
           `  ~ ${Math.round(change.oldConfidence ?? 0 * 100)}% → ${Math.round(change.newConfidence * 100)}% ${change.statement.slice(0, 80)}`
         );
       }
     }
   } else {
-    console.log("\nNo opinion changes");
+    emit.ok("\nNo opinion changes");
   }
 
   if (dryRun) {
-    console.log("\n[DRY RUN] Would write reflection report + update opinions");
+    emit.data("[DRY RUN] Would write reflection report + update opinions");
   } else {
     const report = formatReport(period, notes, ratings, opinionChanges);
     const filepath = writeReport(report, period);
     setLastReflectDate(new Date().toISOString().slice(0, 10));
-    console.log(`\nCreated reflection report: ${filepath}`);
+    emit.ok(`\nCreated reflection report: ${filepath}`);
 
     const opinions = readOpinions();
     const high = opinions.filter((o) => o.confidence >= 0.85);
     if (high.length > 0) {
-      console.log("\nHigh-confidence opinions (injected into context):");
+      emit.ok("\nHigh-confidence opinions (injected into context):");
       for (const o of high) {
-        console.log(`  [${Math.round(o.confidence * 100)}%] ${o.statement.slice(0, 80)}`);
+        emit.ok(`  [${Math.round(o.confidence * 100)}%] ${o.statement.slice(0, 80)}`);
       }
     }
   }

package/src/tools/token-cost.ts

@@ -8,12 +8,14 @@
  * Invoked via `pal cli usage [--today|--week|--month|--all] [--project <name>]`.
  */
 
+import { spawnSync } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { resolve } from "node:path";
 import { parseArgs } from "node:util";
 import { MODEL_PRICING } from "../hooks/lib/models";
 import { palHome } from "../hooks/lib/paths";
+import { findBinaryOnPath } from "../hooks/lib/which";
 
 // ── Types ──
 
@@ -370,6 +372,51 @@ function readPalInference(): {
   return { buckets, byModel, byCaller };
 }
 
+// ── rtk compression savings ──
+
+interface RtkSummary {
+  total_commands: number;
+  total_saved: number;
+  avg_savings_pct: number;
+}
+
+/**
+ * Query rtk's own savings ledger. `installed: false` means rtk isn't on PATH;
+ * `summary: null` with `installed: true` means rtk is present but has no data
+ * (or errored) — the two cases print differently in the usage report.
+ */
+function readRtkGain(): { installed: boolean; summary: RtkSummary | null } {
+  const rtk = findBinaryOnPath("rtk");
+  if (!rtk) return { installed: false, summary: null };
+  try {
+    const r = spawnSync(rtk, ["gain", "--format", "json"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    });
+    if (r.status !== 0 || !r.stdout) return { installed: true, summary: null };
+    const parsed = JSON.parse(r.stdout) as { summary?: RtkSummary };
+    return { installed: true, summary: parsed.summary ?? null };
+  } catch {
+    return { installed: true, summary: null };
+  }
+}
+
+function printRtkGain(): void {
+  const { installed, summary } = readRtkGain();
+  console.log("\n  rtk Compression\n");
+  if (!installed) {
+    console.log("  rtk not installed");
+    return;
+  }
+  if (!summary || summary.total_commands === 0) {
+    console.log("  rtk installed — no savings recorded yet");
+    return;
+  }
+  console.log(
+    `  Tokens saved   ${fmt(summary.total_saved).padStart(8)} tok  ${summary.avg_savings_pct.toFixed(1)}% avg  across ${fmt(summary.total_commands)} commands`
+  );
+}
+
 // ── CLI ──
 
 export function usage() {
@@ -426,6 +473,8 @@ export function usage() {
     printRow("Total", tb.total);
   }
 
+  printRtkGain();
+
   const grand = emptyBucket();
   for (const b of [cc.buckets.total, pal.buckets.total]) {
     grand.input += b.input;