portable-agent-layer 0.17.0 → 0.18.1

package/src/tools/import.ts

@@ -13,53 +13,21 @@ import { createInterface } from "node:readline";
 import AdmZip from "adm-zip";
 import { palHome } from "../hooks/lib/paths";
 
-const repoRoot = palHome();
-const args = process.argv.slice(2);
-const dryRun = args.includes("--dry-run");
-const pathArg = args.find((a) => a !== "--dry-run");
+export function findLatestExport(root: string): string | null {
+  const candidates: string[] = [];
 
-async function confirm(message: string): Promise<boolean> {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((res) => {
-    rl.question(`${message} [y/N] `, (answer) => {
-      rl.close();
-      res(answer.trim().toLowerCase() === "y");
-    });
-  });
-}
-
-function findLatestExport(): string | null {
-  const files = readdirSync(repoRoot)
-    .filter((f) => f.startsWith("pal-export-") && f.endsWith(".zip"))
-    .sort()
-    .reverse();
-
-  // Also check backups/
   try {
-    const backupDir = resolve(repoRoot, "backups");
-    const backups = readdirSync(backupDir)
-      .filter(
-        (f) =>
-          (f.startsWith("pal-export-") || f.startsWith("pal-backup-")) &&
-          f.endsWith(".zip")
-      )
-      .map((f) => ({ name: f, path: resolve(backupDir, f) }))
-      .sort((a, b) => b.name.localeCompare(a.name));
-    if (backups.length > 0) files.push(backups[0].name);
+    candidates.push(
+      ...readdirSync(root)
+        .filter((f) => f.startsWith("pal-export-") && f.endsWith(".zip"))
+        .map((f) => resolve(root, f))
+    );
   } catch {
-    // No backups dir
+    /* empty */
   }
 
-  if (files.length === 0) return null;
-
-  // Find the most recent by mtime across both locations
-  const candidates = [
-    ...readdirSync(repoRoot)
-      .filter((f) => f.startsWith("pal-export-") && f.endsWith(".zip"))
-      .map((f) => resolve(repoRoot, f)),
-  ];
   try {
-    const backupDir = resolve(repoRoot, "backups");
+    const backupDir = resolve(root, "backups");
     candidates.push(
       ...readdirSync(backupDir)
         .filter(
@@ -70,54 +38,74 @@ function findLatestExport(): string | null {
         .map((f) => resolve(backupDir, f))
     );
   } catch {
-    // No backups dir
+    /* empty */
   }
 
   if (candidates.length === 0) return null;
   return candidates.sort((a, b) => statSync(b).mtimeMs - statSync(a).mtimeMs)[0];
 }
 
-// Resolve zip path
-let zipPath: string;
+export function importZip(zipPath: string, targetDir: string, dryRun: boolean): number {
+  const zip = new AdmZip(zipPath);
+  const entries = zip.getEntries();
 
-if (pathArg) {
-  zipPath = resolve(pathArg);
-} else {
-  const latest = findLatestExport();
-  if (!latest) {
-    console.error(
-      "No export or backup files found. Provide a path: bun run tool:import <path-to-zip>"
-    );
-    process.exit(1);
+  if (entries.length === 0) {
+    console.log("Archive is empty — nothing to import.");
+    return 0;
   }
-  console.log(`Found: ${latest}`);
-  const zip = new AdmZip(latest);
-  const entries = zip.getEntries();
-  console.log(
-    `Contains ${entries.length} files, created ${statSync(latest).mtime.toISOString().slice(0, 16).replace("T", " ")}`
-  );
 
-  if (!(await confirm("Import this file?"))) {
-    console.log("Cancelled.");
-    process.exit(0);
+  if (dryRun) {
+    console.log(`Would import ${entries.length} files → ${targetDir}\n`);
+    for (const e of entries) console.log(`  ${e.entryName}`);
+    return entries.length;
   }
-  zipPath = latest;
+
+  zip.extractAllTo(targetDir, true);
+  console.log(`Imported ${entries.length} files → ${targetDir}`);
+  console.log("\nRun 'bun run install:all' to re-create symlinks and hooks.");
+  return entries.length;
 }
 
-// Import
-const zip = new AdmZip(zipPath);
-const entries = zip.getEntries();
+async function run() {
+  const repoRoot = palHome();
+  const args = process.argv.slice(2);
+  const dryRun = args.includes("--dry-run");
+  const pathArg = args.find((a) => a !== "--dry-run");
 
-if (entries.length === 0) {
-  console.log("Archive is empty — nothing to import.");
-  process.exit(0);
-}
+  let zipPath: string;
 
-if (dryRun) {
-  console.log(`Would import ${entries.length} files → ${repoRoot}\n`);
-  for (const e of entries) console.log(`  ${e.entryName}`);
-} else {
-  zip.extractAllTo(repoRoot, true);
-  console.log(`Imported ${entries.length} files → ${repoRoot}`);
-  console.log("\nRun 'bun run install:all' to re-create symlinks and hooks.");
+  if (pathArg) {
+    zipPath = resolve(pathArg);
+  } else {
+    const latest = findLatestExport(repoRoot);
+    if (!latest) {
+      console.error(
+        "No export or backup files found. Provide a path: bun run tool:import <path-to-zip>"
+      );
+      process.exit(1);
+    }
+    console.log(`Found: ${latest}`);
+    const zip = new AdmZip(latest);
+    const entries = zip.getEntries();
+    console.log(
+      `Contains ${entries.length} files, created ${statSync(latest).mtime.toISOString().slice(0, 16).replace("T", " ")}`
+    );
+
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise<string>((res) => {
+      rl.question("Import this file? [y/N] ", (a) => {
+        rl.close();
+        res(a);
+      });
+    });
+    if (answer.trim().toLowerCase() !== "y") {
+      console.log("Cancelled.");
+      process.exit(0);
+    }
+    zipPath = latest;
+  }
+
+  importZip(zipPath, repoRoot, dryRun);
 }
+
+if (import.meta.main) run();

package/src/tools/relationship-reflect.ts

@@ -27,12 +27,6 @@ import {
 import { palHome } from "../hooks/lib/paths";
 import { similarity } from "../hooks/lib/text-similarity";
 
-// ── Paths ──
-
-const RATINGS_FILE = resolve(palHome(), "memory", "signals", "ratings.jsonl");
-const RELATIONSHIP_DIR = resolve(palHome(), "memory", "relationship");
-const REFLECTION_DIR = resolve(palHome(), "memory", "relationship", "reflections");
-
 // ── Types ──
 
 interface Rating {
@@ -59,16 +53,17 @@ interface OpinionChange {
 
 // ── Note Parsing ──
 
-function loadNotes(daysBack: number): ParsedNote[] {
-  if (!existsSync(RELATIONSHIP_DIR)) return [];
+export function loadNotes(daysBack: number): ParsedNote[] {
+  const relationshipDir = resolve(palHome(), "memory", "relationship");
+  if (!existsSync(relationshipDir)) return [];
 
   const cutoff = new Date();
   cutoff.setDate(cutoff.getDate() - daysBack);
   const notes: ParsedNote[] = [];
 
-  for (const monthDir of readdirSync(RELATIONSHIP_DIR).sort().reverse()) {
+  for (const monthDir of readdirSync(relationshipDir).sort().reverse()) {
     if (!/^\d{4}-\d{2}$/.test(monthDir)) continue;
-    const monthPath = resolve(RELATIONSHIP_DIR, monthDir);
+    const monthPath = resolve(relationshipDir, monthDir);
 
     let files: string[];
     try {
@@ -130,13 +125,14 @@ function loadNotes(daysBack: number): ParsedNote[] {
 
 // ── Ratings ──
 
-function loadRatings(daysBack: number): Rating[] {
-  if (!existsSync(RATINGS_FILE)) return [];
+export function loadRatings(daysBack: number): Rating[] {
+  const ratingsFile = resolve(palHome(), "memory", "signals", "ratings.jsonl");
+  if (!existsSync(ratingsFile)) return [];
 
   const cutoff = new Date();
   cutoff.setDate(cutoff.getDate() - daysBack);
 
-  return readFileSync(RATINGS_FILE, "utf-8")
+  return readFileSync(ratingsFile, "utf-8")
     .split("\n")
     .filter((l) => l.trim())
     .map((l) => {
@@ -153,11 +149,10 @@ function loadRatings(daysBack: number): Rating[] {
 
 // ── Opinion Promotion ──
 
-function promoteToOpinions(notes: ParsedNote[], dryRun: boolean): OpinionChange[] {
+export function promoteToOpinions(notes: ParsedNote[], dryRun: boolean): OpinionChange[] {
   const changes: OpinionChange[] = [];
   const opinions = readOpinions();
 
-  // All O notes in the window — deduplication happens at the evidence level
   const opinionNotes = notes.filter((n) => n.type === "O");
 
   // Group similar notes together
@@ -177,11 +172,9 @@ function promoteToOpinions(notes: ParsedNote[], dryRun: boolean): OpinionChange[
   }
 
   for (const [representative, group] of groups) {
-    // Check against existing opinions
     const existing = findSimilarOpinion(representative, opinions);
 
     if (existing) {
-      // Add supporting evidence for each new note
       let updated = existing;
       for (const note of group) {
         updated = addEvidence(updated, "supporting", note.text.slice(0, 120));
@@ -197,8 +190,6 @@ function promoteToOpinions(notes: ParsedNote[], dryRun: boolean): OpinionChange[
         if (!dryRun) saveOpinion(updated);
       }
     } else if (group.length >= 2) {
-      // New opinion — requires at least 2 occurrences
-      // Store individual note texts as evidence so re-runs deduplicate correctly
       let opinion = createOpinion(representative, group[0].text.slice(0, 120));
       for (const note of group.slice(1)) {
         opinion = addEvidence(opinion, "supporting", note.text.slice(0, 120));
@@ -224,7 +215,7 @@ interface OpinionSummary {
   dates: string[];
 }
 
-function groupNoteOccurrences(notes: ParsedNote[]): OpinionSummary[] {
+export function groupNoteOccurrences(notes: ParsedNote[]): OpinionSummary[] {
   const opNotes = notes.filter((n) => n.type === "O");
   const groups = new Map<
     string,
@@ -297,7 +288,7 @@ function correlateRatings(ratings: Rating[]): string[] {
 
 // ── Report ──
 
-function formatReport(
+export function formatReport(
   period: string,
   notes: ParsedNote[],
   ratings: Rating[],
@@ -360,8 +351,8 @@ function formatReport(
 
   if (ratingInsights.length > 0) {
     lines.push("## Rating Insights", "");
-    for (const c of ratingInsights) {
-      lines.push(`- ${c}`);
+    for (const insight of ratingInsights) {
+      lines.push(`- ${insight}`);
     }
     lines.push("");
   }
@@ -369,13 +360,14 @@ function formatReport(
   return lines.join("\n");
 }
 
-function writeReport(report: string, period: string): string {
-  if (!existsSync(REFLECTION_DIR)) mkdirSync(REFLECTION_DIR, { recursive: true });
+export function writeReport(report: string, period: string): string {
+  const reflectionDir = resolve(palHome(), "memory", "relationship", "reflections");
+  if (!existsSync(reflectionDir)) mkdirSync(reflectionDir, { recursive: true });
 
   const date = new Date().toISOString().slice(0, 10);
   const slug = period.toLowerCase().replace(/\s+/g, "-");
   const filename = `${date}_${slug}-reflection.md`;
-  const filepath = resolve(REFLECTION_DIR, filename);
+  const filepath = resolve(reflectionDir, filename);
 
   writeFileSync(filepath, report, "utf-8");
   return filepath;
@@ -383,17 +375,18 @@ function writeReport(report: string, period: string): string {
 
 // ── CLI ──
 
-const { values } = parseArgs({
-  args: Bun.argv.slice(2),
-  options: {
-    month: { type: "boolean" },
-    "dry-run": { type: "boolean" },
-    help: { type: "boolean", short: "h" },
-  },
-});
-
-if (values.help) {
-  console.log(`
+function run() {
+  const { values } = parseArgs({
+    args: Bun.argv.slice(2),
+    options: {
+      month: { type: "boolean" },
+      "dry-run": { type: "boolean" },
+      help: { type: "boolean", short: "h" },
+    },
+  });
+
+  if (values.help) {
+    console.log(`
 RelationshipReflect — Periodic reflection + opinion promotion
 
 Reads recent relationship notes and ratings. Promotes recurring
@@ -408,65 +401,67 @@ Output:
   - Updates memory/relationship/opinions.json (confidence tracking)
   - Creates reflection report in memory/relationship/reflections/
 `);
-  process.exit(0);
-}
+    process.exit(0);
+  }
 
-const daysBack = values.month ? 30 : 7;
-const period = values.month ? "Monthly" : "Weekly";
-const dryRun = values["dry-run"] ?? false;
+  const daysBack = values.month ? 30 : 7;
+  const period = values.month ? "Monthly" : "Weekly";
+  const dryRun = values["dry-run"] ?? false;
 
-const notes = loadNotes(daysBack);
-const ratings = loadRatings(daysBack);
+  const notes = loadNotes(daysBack);
+  const ratings = loadRatings(daysBack);
 
-console.log(`Loaded ${notes.length} notes from last ${daysBack} days`);
-console.log(`Loaded ${ratings.length} ratings`);
+  console.log(`Loaded ${notes.length} notes from last ${daysBack} days`);
+  console.log(`Loaded ${ratings.length} ratings`);
 
-if (notes.length === 0 && ratings.length === 0) {
-  console.log("No data to analyze");
-  process.exit(0);
-}
+  if (notes.length === 0 && ratings.length === 0) {
+    console.log("No data to analyze");
+    process.exit(0);
+  }
 
-// Promote notes to opinions
-const opinionChanges = promoteToOpinions(notes, dryRun);
+  const opinionChanges = promoteToOpinions(notes, dryRun);
 
-const avgRating =
-  ratings.length > 0 ? ratings.reduce((s, r) => s + r.rating, 0) / ratings.length : 0;
-console.log(`\nAverage Rating: ${avgRating.toFixed(1)}/10`);
+  const avgRating =
+    ratings.length > 0 ? ratings.reduce((s, r) => s + r.rating, 0) / ratings.length : 0;
+  console.log(`\nAverage Rating: ${avgRating.toFixed(1)}/10`);
 
-const summaries = groupNoteOccurrences(notes);
-console.log(`Observations: ${summaries.length} unique`);
+  const summaries = groupNoteOccurrences(notes);
+  console.log(`Observations: ${summaries.length} unique`);
 
-if (opinionChanges.length > 0) {
-  console.log(`\nOpinion changes:`);
-  for (const change of opinionChanges) {
-    if (change.action === "created") {
-      console.log(
-        `  + NEW (${Math.round(change.newConfidence * 100)}%) ${change.statement.slice(0, 80)}`
-      );
-    } else {
-      console.log(
-        `  ~ ${Math.round(change.oldConfidence ?? 0 * 100)}% → ${Math.round(change.newConfidence * 100)}% ${change.statement.slice(0, 80)}`
-      );
+  if (opinionChanges.length > 0) {
+    console.log("\nOpinion changes:");
+    for (const change of opinionChanges) {
+      if (change.action === "created") {
+        console.log(
+          `  + NEW (${Math.round(change.newConfidence * 100)}%) ${change.statement.slice(0, 80)}`
+        );
+      } else {
+        console.log(
+          `  ~ ${Math.round(change.oldConfidence ?? 0 * 100)}% → ${Math.round(change.newConfidence * 100)}% ${change.statement.slice(0, 80)}`
+        );
+      }
     }
+  } else {
+    console.log("\nNo opinion changes");
   }
-} else {
-  console.log("\nNo opinion changes");
-}
-
-if (dryRun) {
-  console.log("\n[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}`);
 
-  const opinions = readOpinions();
-  const high = opinions.filter((o) => o.confidence >= 0.85);
-  if (high.length > 0) {
-    console.log(`\nHigh-confidence opinions (injected into context):`);
-    for (const o of high) {
-      console.log(`  [${Math.round(o.confidence * 100)}%] ${o.statement.slice(0, 80)}`);
+  if (dryRun) {
+    console.log("\n[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}`);
+
+    const opinions = readOpinions();
+    const high = opinions.filter((o) => o.confidence >= 0.85);
+    if (high.length > 0) {
+      console.log("\nHigh-confidence opinions (injected into context):");
+      for (const o of high) {
+        console.log(`  [${Math.round(o.confidence * 100)}%] ${o.statement.slice(0, 80)}`);
+      }
     }
   }
 }
+
+if (import.meta.main) run();

package/src/tools/session-summary.ts

@@ -6,25 +6,30 @@
  */
 
 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";
 
-const { values: args } = parseArgs({
-  options: { session: { type: "string" } },
-  strict: false,
-});
-
-const sessionId = args.session;
-if (!sessionId) process.exit(0);
-
-import { homedir } from "node:os";
+// ── Types ──
 
-const claudeDir = resolve(homedir(), ".claude", "projects");
+interface Usage {
+  input: number;
+  output: number;
+  cacheWrite: number;
+  cacheRead: number;
+  cost: number;
+  calls: number;
+  models: Set<string>;
+  durationMs: number;
+}
 
-// ── Find the JSONL file containing this session ──
+// ── Core Functions ──
 
-function findSessionFile(): { filepath: string; project: string } | null {
+export function findSessionFile(
+  sessionId: string,
+  claudeDir: string
+): { filepath: string; project: string } | null {
   if (!existsSync(claudeDir)) return null;
 
   const projectDirs = readdirSync(claudeDir, { withFileTypes: true }).filter((d) =>
@@ -35,7 +40,6 @@ function findSessionFile(): { filepath: string; project: string } | null {
     const projPath = resolve(claudeDir, dir.name);
     const projName = dir.name.split("-").pop() ?? dir.name;
 
-    // Session ID is often the filename
     const directFile = resolve(projPath, `${sessionId}.jsonl`);
     if (existsSync(directFile)) {
       return { filepath: directFile, project: projName };
@@ -74,20 +78,7 @@ function findSessionFile(): { filepath: string; project: string } | null {
   return latest;
 }
 
-// ── Parse only messages belonging to this session ──
-
-interface Usage {
-  input: number;
-  output: number;
-  cacheWrite: number;
-  cacheRead: number;
-  cost: number;
-  calls: number;
-  models: Set<string>;
-  durationMs: number;
-}
-
-function parseSession(filepath: string): Usage {
+export function parseSession(filepath: string, sessionId: string): Usage {
   const usage: Usage = {
     input: 0,
     output: 0,
@@ -122,7 +113,6 @@ function parseSession(filepath: string): Usage {
         };
       };
 
-      // Only count messages from this session
       if (d.sessionId !== sessionId) continue;
 
       if (d.timestamp) {
@@ -187,21 +177,34 @@ function fmtDuration(ms: number): string {
   return rem > 0 ? `${hrs}h ${rem}m` : `${hrs}h`;
 }
 
-// ── Main ──
+// ── CLI ──
+
+function run() {
+  const { values: args } = parseArgs({
+    options: { session: { type: "string" } },
+    strict: false,
+  });
+
+  const sessionId = typeof args.session === "string" ? args.session : "";
+  if (!sessionId) process.exit(0);
 
-const file = findSessionFile();
-if (!file) process.exit(0);
+  const claudeDir = resolve(homedir(), ".claude", "projects");
+  const file = findSessionFile(sessionId, claudeDir);
+  if (!file) process.exit(0);
 
-const usage = parseSession(file.filepath);
-if (usage.calls === 0) process.exit(0);
+  const usage = parseSession(file.filepath, sessionId);
+  if (usage.calls === 0) process.exit(0);
 
-const totalTokens = usage.input + usage.output + usage.cacheWrite + usage.cacheRead;
-const model = [...usage.models].map((m) => m.replace("claude-", "")).join(", ");
+  const totalTokens = usage.input + usage.output + usage.cacheWrite + usage.cacheRead;
+  const model = [...usage.models].map((m) => m.replace("claude-", "")).join(", ");
 
-const dim = "\x1b[2m";
-const reset = "\x1b[0m";
-const cyan = "\x1b[36m";
+  const dim = "\x1b[2m";
+  const reset = "\x1b[0m";
+  const cyan = "\x1b[36m";
+
+  console.log(
+    `\n${dim}Session: ${file.project} · ${model} · ${fmtDuration(usage.durationMs)} · ${fmtTokens(totalTokens)} tokens · ${usage.calls} calls · ${cyan}${fmtCost(usage.cost)}${reset}`
+  );
+}
 
-console.log(
-  `\n${dim}Session: ${file.project} · ${model} · ${fmtDuration(usage.durationMs)} · ${fmtTokens(totalTokens)} tokens · ${usage.calls} calls · ${cyan}${fmtCost(usage.cost)}${reset}`
-);
+if (import.meta.main) run();