portable-agent-layer 0.17.0 → 0.18.1

package/src/tools/token-cost.ts

@@ -15,27 +15,9 @@ import { parseArgs } from "node:util";
 import { MODEL_PRICING } from "../hooks/lib/models";
 import { palHome } from "../hooks/lib/paths";
 
-// ── Args ──
-
-const { values: args } = parseArgs({
-  options: {
-    today: { type: "boolean", default: false },
-    week: { type: "boolean", default: false },
-    month: { type: "boolean", default: false },
-    all: { type: "boolean", default: false },
-    project: { type: "string" },
-  },
-  strict: false,
-});
-
-const now = new Date();
-const todayPrefix = now.toISOString().slice(0, 10);
-const weekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000).toISOString();
-const monthAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000).toISOString();
-
 // ── Types ──
 
-interface Bucket {
+export interface Bucket {
   input: number;
   output: number;
   cacheWrite: number;
@@ -44,14 +26,30 @@ interface Bucket {
   calls: number;
 }
 
-function emptyBucket(): Bucket {
+export function emptyBucket(): Bucket {
   return { input: 0, output: 0, cacheWrite: 0, cacheRead: 0, cost: 0, calls: 0 };
 }
 
+export interface TimeBuckets {
+  today: Bucket;
+  week: Bucket;
+  month: Bucket;
+  total: Bucket;
+}
+
+export function emptyTimeBuckets(): TimeBuckets {
+  return {
+    today: emptyBucket(),
+    week: emptyBucket(),
+    month: emptyBucket(),
+    total: emptyBucket(),
+  };
+}
+
+// ── Helpers ──
+
 function findPricing(model: string): (typeof MODEL_PRICING)[string] | null {
-  // Exact match first
   if (MODEL_PRICING[model]) return MODEL_PRICING[model];
-  // Prefix match (e.g. "claude-sonnet-4-5-20250929" matches "claude-sonnet-4-5")
   for (const key of Object.keys(MODEL_PRICING)) {
     if (model.startsWith(key)) return MODEL_PRICING[key];
   }
@@ -76,7 +74,7 @@ function costForUsage(
   );
 }
 
-function addToBucket(
+export function addToBucket(
   bucket: Bucket,
   model: string,
   input: number,
@@ -120,22 +118,6 @@ function printDetailed(label: string, b: Bucket, labelWidth = 14): void {
 
 // ── Claude Code transcripts ──
 
-interface TimeBuckets {
-  today: Bucket;
-  week: Bucket;
-  month: Bucket;
-  total: Bucket;
-}
-
-function emptyTimeBuckets(): TimeBuckets {
-  return {
-    today: emptyBucket(),
-    week: emptyBucket(),
-    month: emptyBucket(),
-    total: emptyBucket(),
-  };
-}
-
 function addToTimeBuckets(
   tb: TimeBuckets,
   ts: string,
@@ -143,7 +125,10 @@ function addToTimeBuckets(
   input: number,
   output: number,
   cacheWrite: number,
-  cacheRead: number
+  cacheRead: number,
+  todayPrefix: string,
+  weekAgo: string,
+  monthAgo: string
 ): void {
   addToBucket(tb.total, model, input, output, cacheWrite, cacheRead);
   if (ts >= monthAgo) addToBucket(tb.month, model, input, output, cacheWrite, cacheRead);
@@ -152,11 +137,16 @@ function addToTimeBuckets(
     addToBucket(tb.today, model, input, output, cacheWrite, cacheRead);
 }
 
-function readClaudeCode(): {
+export function readClaudeCode(projectFilter?: string): {
   buckets: TimeBuckets;
   byModel: Record<string, Bucket>;
   byProject: Record<string, TimeBuckets>;
 } {
+  const now = new Date();
+  const todayPrefix = now.toISOString().slice(0, 10);
+  const weekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000).toISOString();
+  const monthAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000).toISOString();
+
   const buckets = emptyTimeBuckets();
   const byModel: Record<string, Bucket> = {};
   const byProject: Record<string, TimeBuckets> = {};
@@ -170,20 +160,17 @@ function readClaudeCode(): {
 
   for (const projDir of projectDirs) {
     const projPath = resolve(claudeDir, projDir);
-    // Project dir is like "-Users-rico-Development-git-myproject" — extract last meaningful segment
     const segments = projDir.replace(/^-/, "").split("-");
     const projName = segments.length > 1 ? segments.slice(-1)[0] : projDir;
 
-    if (typeof args.project === "string" && !projName.includes(args.project)) continue;
+    if (typeof projectFilter === "string" && !projName.includes(projectFilter)) continue;
 
-    // Collect all JSONL files: top-level + subagent directories
     const jsonlFiles: string[] = [];
 
     for (const entry of readdirSync(projPath, { withFileTypes: true })) {
       if (entry.isFile() && entry.name.endsWith(".jsonl")) {
         jsonlFiles.push(resolve(projPath, entry.name));
       } else if (entry.isDirectory()) {
-        // Check for subagent transcripts inside session directories
         const subagentsDir = resolve(projPath, entry.name, "subagents");
         try {
           for (const sub of readdirSync(subagentsDir)) {
@@ -232,13 +219,35 @@ function readClaudeCode(): {
           const cw = usage.cache_creation_input_tokens ?? 0;
           const cr = usage.cache_read_input_tokens ?? 0;
 
-          addToTimeBuckets(buckets, ts, model, input, output, cw, cr);
+          addToTimeBuckets(
+            buckets,
+            ts,
+            model,
+            input,
+            output,
+            cw,
+            cr,
+            todayPrefix,
+            weekAgo,
+            monthAgo
+          );
 
           if (!byModel[model]) byModel[model] = emptyBucket();
           addToBucket(byModel[model], model, input, output, cw, cr);
 
           if (!byProject[projName]) byProject[projName] = emptyTimeBuckets();
-          addToTimeBuckets(byProject[projName], ts, model, input, output, cw, cr);
+          addToTimeBuckets(
+            byProject[projName],
+            ts,
+            model,
+            input,
+            output,
+            cw,
+            cr,
+            todayPrefix,
+            weekAgo,
+            monthAgo
+          );
         } catch {
           /* skip */
         }
@@ -251,7 +260,15 @@ function readClaudeCode(): {
 
 // ── PAL Haiku inference ──
 
-function readPalInference(): { buckets: TimeBuckets; byCaller: Record<string, Bucket> } {
+export function readPalInference(): {
+  buckets: TimeBuckets;
+  byCaller: Record<string, Bucket>;
+} {
+  const now = new Date();
+  const todayPrefix = now.toISOString().slice(0, 10);
+  const weekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000).toISOString();
+  const monthAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000).toISOString();
+
   const buckets = emptyTimeBuckets();
   const byCaller: Record<string, Bucket> = {};
 
@@ -270,7 +287,18 @@ function readPalInference(): { buckets: TimeBuckets; byCaller: Record<string, Bu
         inputTokens: number;
         outputTokens: number;
       };
-      addToTimeBuckets(buckets, e.ts, e.model, e.inputTokens, e.outputTokens, 0, 0);
+      addToTimeBuckets(
+        buckets,
+        e.ts,
+        e.model,
+        e.inputTokens,
+        e.outputTokens,
+        0,
+        0,
+        todayPrefix,
+        weekAgo,
+        monthAgo
+      );
       if (!byCaller[e.caller]) byCaller[e.caller] = emptyBucket();
       addToBucket(byCaller[e.caller], e.model, e.inputTokens, e.outputTokens, 0, 0);
     } catch {
@@ -281,54 +309,68 @@ function readPalInference(): { buckets: TimeBuckets; byCaller: Record<string, Bu
   return { buckets, byCaller };
 }
 
-// ── Main ──
-
-const cc = readClaudeCode();
-const pal = readPalInference();
-
-console.log("\n  Claude Code Usage\n");
-printRow("Today", cc.buckets.today);
-printRow("7d", cc.buckets.week);
-printRow("30d", cc.buckets.month);
-printRow("Total", cc.buckets.total);
+// ── CLI ──
+
+function run() {
+  parseArgs({
+    options: {
+      today: { type: "boolean", default: false },
+      week: { type: "boolean", default: false },
+      month: { type: "boolean", default: false },
+      all: { type: "boolean", default: false },
+      project: { type: "string" },
+    },
+    strict: false,
+  });
+
+  const cc = readClaudeCode();
+  const pal = readPalInference();
+
+  console.log("\n  Claude Code Usage\n");
+  printRow("Today", cc.buckets.today);
+  printRow("7d", cc.buckets.week);
+  printRow("30d", cc.buckets.month);
+  printRow("Total", cc.buckets.total);
+
+  if (Object.keys(cc.byModel).length > 0) {
+    console.log("\n  By Model (all time)\n");
+    const sorted = Object.entries(cc.byModel).sort((a, b) => b[1].cost - a[1].cost);
+    const modelNames = sorted.map(([m]) => m.replace("claude-", ""));
+    const modelWidth = Math.max(14, ...modelNames.map((n) => n.length + 2));
+    for (let i = 0; i < sorted.length; i++) {
+      printDetailed(modelNames[i], sorted[i][1], modelWidth);
+    }
+  }
 
-if (Object.keys(cc.byModel).length > 0) {
-  console.log("\n  By Model (all time)\n");
-  const sorted = Object.entries(cc.byModel).sort((a, b) => b[1].cost - a[1].cost);
-  const modelNames = sorted.map(([m]) => m.replace("claude-", ""));
-  const modelWidth = Math.max(14, ...modelNames.map((n) => n.length + 2));
-  for (let i = 0; i < sorted.length; i++) {
-    printDetailed(modelNames[i], sorted[i][1], modelWidth);
+  if (Object.keys(cc.byProject).length > 1) {
+    console.log("\n  By Project (all time)\n");
+    const sorted = Object.entries(cc.byProject).sort(
+      (a, b) => b[1].total.cost - a[1].total.cost
+    );
+    for (const [proj, tb] of sorted) {
+      printRow(proj, tb.total);
+    }
   }
-}
 
-if (Object.keys(cc.byProject).length > 1) {
-  console.log("\n  By Project (all time)\n");
-  const sorted = Object.entries(cc.byProject).sort(
-    (a, b) => b[1].total.cost - a[1].total.cost
-  );
-  for (const [proj, tb] of sorted) {
-    printRow(proj, tb.total);
+  if (pal.buckets.total.calls > 0) {
+    console.log("\n  PAL Inference (Haiku)\n");
+    printRow("Today", pal.buckets.today);
+    printRow("7d", pal.buckets.week);
+    printRow("30d", pal.buckets.month);
+    printRow("Total", pal.buckets.total);
   }
-}
 
-if (pal.buckets.total.calls > 0) {
-  console.log("\n  PAL Inference (Haiku)\n");
-  printRow("Today", pal.buckets.today);
-  printRow("7d", pal.buckets.week);
-  printRow("30d", pal.buckets.month);
-  printRow("Total", pal.buckets.total);
-}
+  const grand = emptyBucket();
+  for (const b of [cc.buckets.total, pal.buckets.total]) {
+    grand.input += b.input;
+    grand.output += b.output;
+    grand.cacheWrite += b.cacheWrite;
+    grand.cacheRead += b.cacheRead;
+    grand.cost += b.cost;
+    grand.calls += b.calls;
+  }
 
-// Grand total
-const grand = emptyBucket();
-for (const b of [cc.buckets.total, pal.buckets.total]) {
-  grand.input += b.input;
-  grand.output += b.output;
-  grand.cacheWrite += b.cacheWrite;
-  grand.cacheRead += b.cacheRead;
-  grand.cost += b.cost;
-  grand.calls += b.calls;
+  console.log(`\n  Grand Total: ${fmtCost(grand.cost)}\n`);
 }
 
-console.log(`\n  Grand Total: ${fmtCost(grand.cost)}\n`);
+if (import.meta.main) run();

package/src/tools/analyze.ts

@@ -1,152 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Unified Learning Analysis — graduation patterns + ratings summary.
- *
- * Reads failures and session learnings, finds recurring patterns,
- * summarizes ratings, and generates recommendations.
- *
- * Usage: bun run tool:analyze
- */
-
-import { parseArgs } from "node:util";
-import { analyze } from "../hooks/lib/graduation";
-
-// ── ANSI Colors ──
-
-const c = {
-  bold: (s: string) => `\x1b[1m${s}\x1b[0m`,
-  dim: (s: string) => `\x1b[2m${s}\x1b[0m`,
-  cyan: (s: string) => `\x1b[36m${s}\x1b[0m`,
-  yellow: (s: string) => `\x1b[33m${s}\x1b[0m`,
-  green: (s: string) => `\x1b[32m${s}\x1b[0m`,
-  red: (s: string) => `\x1b[31m${s}\x1b[0m`,
-  magenta: (s: string) => `\x1b[35m${s}\x1b[0m`,
-};
-
-const { values } = parseArgs({
-  args: Bun.argv.slice(2),
-  options: {
-    help: { type: "boolean", short: "h" },
-    actionable: { type: "boolean", short: "a" },
-  },
-});
-
-if (values.help) {
-  console.log(`
-  PAL Learning Analysis — unified graduation + ratings report
-
-  Reads all captured failures (rating ≤3) and session learnings,
-  groups recurring patterns via Dice similarity on context text,
-  and summarizes rating trends.
-
-  Sections:
-    Ratings       Overall average, low/high counts
-    Graduation    Patterns with 3+ occurrences → ready to crystallize
-    Emerging      Patterns with 2 occurrences → one more to graduate
-
-  Flags:
-    --actionable, -a  Generate actionable recommendations via Haiku inference
-
-  To crystallize a graduated pattern, add it to the target wisdom frame:
-    - Your principle here [CRYSTAL: 85%]
-
-  Usage: bun run tool:analyze [--actionable] [--help]
-`);
-  process.exit(0);
-}
-
-const result = await analyze({ actionable: values.actionable });
-
-const hasPatterns = result.candidates.length > 0 || result.emerging.length > 0;
-const hasRatings = result.ratings !== null;
-
-if (!hasPatterns && !hasRatings) {
-  console.log("\n  No patterns or ratings data found.\n");
-  process.exit(0);
-}
-
-// ── Ratings Summary ──
-
-if (result.ratings) {
-  const r = result.ratings;
-  const avgColor = r.average >= 7 ? c.green : r.average <= 4 ? c.red : c.yellow;
-  console.log(
-    `\n  ${c.bold("Ratings:")} ${avgColor(`${r.average.toFixed(1)}/10`)} avg (${r.total} total)`
-  );
-  console.log(
-    `  ${c.red(`Low (≤4): ${r.low.count}`)} | ${c.green(`High (≥7): ${r.high.count}`)}`
-  );
-}
-
-// ── Graduation Candidates ──
-
-if (result.candidates.length > 0) {
-  console.log(
-    `\n  ${c.bold(c.green(`Graduation Report — ${result.candidates.length} pattern(s) detected`))}\n`
-  );
-  console.log(`  ${c.dim("─────────────────────────────────────────────────")}\n`);
-
-  for (const candidate of result.candidates) {
-    console.log(
-      `  ${c.cyan(`[${candidate.domain}]`)} ${c.bold(`${candidate.entries.length}x`)} occurrences`
-    );
-    console.log("");
-
-    for (const entry of candidate.entries) {
-      const sourceType = entry.source.startsWith("failure:") ? "failure" : "learning";
-      const tag =
-        sourceType === "failure" ? c.red(`[${sourceType}]`) : c.yellow(`[${sourceType}]`);
-      console.log(
-        `    ${c.dim(entry.date || "unknown")} ${tag} ${entry.text.slice(0, 100)}`
-      );
-    }
-
-    console.log(`\n  ${c.dim("Files:")}`);
-    for (const entry of candidate.entries) {
-      console.log(`    ${c.dim(entry.path)}`);
-    }
-
-    console.log("");
-    console.log(
-      `  Target frame: ${c.magenta(`memory/wisdom/frames/${candidate.domain}.md`)}`
-    );
-    console.log(`  ${c.dim("─────────────────────────────────────────────────")}\n`);
-  }
-}
-
-// ── Emerging Patterns ──
-
-if (result.emerging.length > 0) {
-  console.log(`  ${c.bold(c.yellow("Emerging (2x — one more to graduate)"))}\n`);
-  for (const group of result.emerging) {
-    console.log(`  ${c.cyan(`[${group.domain}]`)} ${c.bold(`${group.entries.length}x`)}`);
-    for (const entry of group.entries) {
-      const sourceType = entry.source.startsWith("failure:") ? "failure" : "learning";
-      const tag =
-        sourceType === "failure" ? c.red(`[${sourceType}]`) : c.yellow(`[${sourceType}]`);
-      console.log(
-        `    ${c.dim(entry.date || "unknown")} ${tag} ${entry.text.slice(0, 80)}`
-      );
-    }
-    console.log("  Files:");
-    for (const entry of group.entries) {
-      console.log(`    ${c.dim(entry.path)}`);
-    }
-    console.log("");
-  }
-}
-
-// ── Recommendations ──
-
-if (result.recommendations.length > 0) {
-  console.log(`  ${c.bold("Recommendations:")}\n`);
-  for (const rec of result.recommendations) {
-    console.log(`    ${rec}`);
-  }
-  console.log("");
-}
-
-if (result.candidates.length > 0) {
-  console.log(`  To crystallize: add a line to the wisdom frame file.`);
-  console.log(`  Format: ${c.green("- Your principle here [CRYSTAL: 85%]")}\n`);
-}