portable-agent-layer 0.35.0 → 0.37.0

package/src/tools/agent/synthesize.ts

@@ -17,6 +17,7 @@ import { existsSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { parseArgs } from "node:util";
 import { ensureDir, paths } from "../../hooks/lib/paths";
+import { readJsonl } from "../self-model";
 
 // ── Config ──
 
@@ -27,7 +28,6 @@ const SYNTHESIS_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
 interface SynthesisState {
   timestamp: string;
   days: number;
-  threads: { id: string; cwd?: string; title: string; context: string; opened: string }[];
   sessions: { date: string; titles: string[] }[];
   sessionCount: number;
   ratings: {
@@ -74,14 +74,6 @@ function shouldRun(force: boolean): boolean {
   }
 }
 
-function readJsonl<T>(path: string): T[] {
-  if (!existsSync(path)) return [];
-  return readFileSync(path, "utf-8")
-    .split("\n")
-    .filter((l) => l.trim())
-    .map((l) => JSON.parse(l) as T);
-}
-
 function daysAgo(days: number): Date {
   return new Date(Date.now() - days * 24 * 60 * 60 * 1000);
 }
@@ -100,28 +92,6 @@ function safeReaddir(dir: string): string[] {
 
 // ── Data readers ──
 
-interface Thread {
-  id: string;
-  cwd?: string;
-  title: string;
-  context: string;
-  status: string;
-  created: string;
-}
-
-function getOpenThreads(): SynthesisState["threads"] {
-  const threads = readJsonl<Thread>(resolve(stateDir(), "threads.jsonl"));
-  return threads
-    .filter((t) => t.status === "open")
-    .map((t) => ({
-      id: t.id,
-      cwd: t.cwd,
-      title: t.title,
-      context: t.context,
-      opened: formatDate(t.created),
-    }));
-}
-
 interface Reflection {
   timestamp: string;
   cwd?: string;
@@ -210,12 +180,9 @@ function getRatingStats(since: Date): SynthesisState["ratings"] {
   const secondHalf = ratings.slice(mid);
   const firstAvg = firstHalf.reduce((s, r) => s + r.rating, 0) / firstHalf.length;
   const secondAvg = secondHalf.reduce((s, r) => s + r.rating, 0) / secondHalf.length;
-  const trend =
-    secondAvg - firstAvg > 0.5
-      ? "improving"
-      : secondAvg - firstAvg < -0.5
-        ? "declining"
-        : "stable";
+  const diff = secondAvg - firstAvg;
+  const decliningOrStable = diff < -0.5 ? "declining" : "stable";
+  const trend = diff > 0.5 ? "improving" : decliningOrStable;
 
   return {
     count: ratings.length,
@@ -251,8 +218,8 @@ function getRecentSessions(since: Date): {
 
         const content = readFileSync(resolve(monthDir, file), "utf-8");
         const titleMatch =
-          content.match(/^title:\s*"?(.+?)"?\s*$/m) ??
-          content.match(/^\*\*Title:\*\*\s*(.+?)\s*$/m);
+          new RegExp(/^title:\s*"?(.+?)"?\s*$/m).exec(content) ??
+          new RegExp(/^\*\*Title:\*\*\s*(.+?)\s*$/m).exec(content);
         const title = titleMatch?.[1] ?? file.replace(/\.md$/, "");
 
         const existing = byDate.get(isoDate) ?? [];
@@ -280,7 +247,6 @@ export function writeSynthesis(state: SynthesisState): string {
 
 export function synthesize(days: number): SynthesisState {
   const since = daysAgo(days);
-  const threads = getOpenThreads();
   const { sessions, count: sessionCount } = getRecentSessions(since);
   const ratings = getRatingStats(since);
   const algorithm = getAlgorithmStats(since);
@@ -288,7 +254,6 @@ export function synthesize(days: number): SynthesisState {
   return {
     timestamp: new Date().toISOString(),
     days,
-    threads,
     sessions,
     sessionCount,
     ratings,
@@ -346,7 +311,6 @@ Output: ~/.pal/memory/state/synthesis.json
       {
         success: true,
         path: sp,
-        threads: state.threads.length,
         sessions: state.sessionCount,
         ratings: state.ratings.count,
         reflections: state.algorithm.reflectionCount,

package/src/tools/agent/thread.ts

@@ -18,7 +18,7 @@ import { ensureDir, paths } from "../../hooks/lib/paths";
 
 // ── Types ──
 
-interface Thread {
+export interface Thread {
   id: string;
   cwd: string;
   title: string;
@@ -38,16 +38,20 @@ function generateId(): string {
   return Date.now().toString(36) + Math.random().toString(36).slice(2, 5);
 }
 
-function readThreads(): Thread[] {
+export function readThreads(): Thread[] {
   const p = threadsPath();
   if (!existsSync(p)) return [];
-  return readFileSync(p, "utf-8")
-    .split("\n")
-    .filter((l) => l.trim())
-    .map((l) => JSON.parse(l) as Thread);
+  try {
+    return readFileSync(p, "utf-8")
+      .split("\n")
+      .filter((l) => l.trim())
+      .map((l) => JSON.parse(l) as Thread);
+  } catch {
+    return [];
+  }
 }
 
-function writeThreads(threads: Thread[]): void {
+export function writeThreads(threads: Thread[]): void {
   writeFileSync(
     threadsPath(),
     `${threads.map((t) => JSON.stringify(t)).join("\n")}\n`,
@@ -110,13 +114,10 @@ function run() {
     },
   });
 
-  const cmd = values.add
-    ? "add"
-    : values.resolve
-      ? "resolve"
-      : values.list
-        ? "list"
-        : null;
+  let cmd: string | null = null;
+  if (values.add) cmd = "add";
+  else if (values.resolve) cmd = "resolve";
+  else if (values.list) cmd = "list";
 
   if (values.help || !cmd) {
     console.log(`

package/src/tools/agent/wisdom-frame.ts

@@ -39,7 +39,7 @@ function date(): string {
 }
 
 function parseObservationCount(content: string): number {
-  const match = content.match(/\*\*Observation Count:\*\*\s*(\d+)/);
+  const match = new RegExp(/\*\*Observation Count:\*\*\s*(\d+)/).exec(content);
   return match ? parseInt(match[1], 10) : 0;
 }
 
@@ -90,6 +90,12 @@ export function updateFrame(
   if (!existsSync(framePath)) {
     mkdirSync(framesDir, { recursive: true });
 
+    const contextualRuleEntry =
+      type === "contextual-rule" ? `- ${observation} (${date()})` : "*None yet.*";
+    const antiPatternEntry =
+      type === "anti-pattern"
+        ? `### ${observation}\n- **Severity:** Medium\n- **Frequency:** Observed`
+        : "*None yet.*";
     const content = `# Frame: ${domain.charAt(0).toUpperCase() + domain.slice(1)}
 
 ## Meta
@@ -107,13 +113,13 @@ export function updateFrame(
 
 ## Contextual Rules
 
-${type === "contextual-rule" ? `- ${observation} (${date()})` : "*None yet.*"}
+${contextualRuleEntry}
 
 ---
 
 ## Anti-Patterns
 
-${type === "anti-pattern" ? `### ${observation}\n- **Severity:** Medium\n- **Frequency:** Observed` : "*None yet.*"}
+${antiPatternEntry}
 
 ---
 

package/src/tools/import.ts

@@ -108,4 +108,4 @@ async function run() {
   importZip(zipPath, repoRoot, dryRun);
 }
 
-if (import.meta.main) run();
+if (import.meta.main) await run();

package/src/tools/relationship-reflect.ts

@@ -37,7 +37,7 @@ interface Rating {
 }
 
 interface ParsedNote {
-  type: "W" | "O" | "B";
+  type: "W" | "O" | "Session";
   text: string;
   confidence?: number;
   date: string;
@@ -84,17 +84,17 @@ export function loadNotes(daysBack: number): ParsedNote[] {
         let currentTime = "";
 
         for (const line of content.split("\n")) {
-          const timeMatch = line.match(/^## (\d{2}:\d{2})/);
+          const timeMatch = new RegExp(/^## (\d{2}:\d{2})/).exec(line);
           if (timeMatch) {
             currentTime = timeMatch[1];
             continue;
           }
 
           // O(c=0.85): text or B(c=0.85): text
-          const obMatch = line.match(/^- ([OB])\(c=([\d.]+)\):\s*(.+)$/);
+          const obMatch = new RegExp(/^- ([OB])\(c=([\d.]+)\):\s*(.+)$/).exec(line);
           if (obMatch) {
             notes.push({
-              type: obMatch[1] as "O" | "B",
+              type: obMatch[1] as "O" | "Session",
               confidence: Number.parseFloat(obMatch[2]),
               text: obMatch[3],
               date: dateStr,
@@ -104,7 +104,7 @@ export function loadNotes(daysBack: number): ParsedNote[] {
           }
 
           // W: text
-          const worldMatch = line.match(/^- W:\s*(.+)$/);
+          const worldMatch = new RegExp(/^- W:\s*(.+)$/).exec(line);
           if (worldMatch) {
             notes.push({
               type: "W",
@@ -261,19 +261,21 @@ function correlateRatings(ratings: Rating[]): string[] {
   const highRatings = ratings.filter((r) => r.rating >= 7);
 
   if (lowRatings.length > 0) {
+    const lowContexts = lowRatings
+      .slice(0, 3)
+      .map((r) => `"${r.context.slice(0, 60)}"`)
+      .join(", ");
     correlations.push(
-      `${lowRatings.length} low ratings (<=4) — common contexts: ${lowRatings
-        .slice(0, 3)
-        .map((r) => `"${r.context.slice(0, 60)}"`)
-        .join(", ")}`
+      `${lowRatings.length} low ratings (<=4) — common contexts: ${lowContexts}`
     );
   }
   if (highRatings.length > 0) {
+    const highContexts = highRatings
+      .slice(0, 3)
+      .map((r) => `"${r.context.slice(0, 60)}"`)
+      .join(", ");
     correlations.push(
-      `${highRatings.length} high ratings (>=7) — common contexts: ${highRatings
-        .slice(0, 3)
-        .map((r) => `"${r.context.slice(0, 60)}"`)
-        .join(", ")}`
+      `${highRatings.length} high ratings (>=7) — common contexts: ${highContexts}`
     );
   }
 

package/src/tools/self-model.ts

@@ -71,7 +71,7 @@ interface AlgorithmReflection {
 }
 
 interface RelationshipNote {
-  type: "O" | "W" | "B";
+  type: "O" | "W" | "Session";
   content: string;
   confidence?: number;
   date: string;
@@ -107,12 +107,16 @@ function shouldRun(force: boolean): boolean {
   }
 }
 
-function readJsonl<T>(path: string): T[] {
+export function readJsonl<T>(path: string): T[] {
   if (!existsSync(path)) return [];
-  return readFileSync(path, "utf-8")
-    .split("\n")
-    .filter((l) => l.trim())
-    .map((l) => JSON.parse(l) as T);
+  try {
+    return readFileSync(path, "utf-8")
+      .split("\n")
+      .filter((l) => l.trim())
+      .map((l) => JSON.parse(l) as T);
+  } catch {
+    return [];
+  }
 }
 
 function safeReadJson<T>(path: string, fallback: T): T {
@@ -261,7 +265,9 @@ function readRelationshipNotes(since: Date): RelationshipNote[] {
   const notes: RelationshipNote[] = [];
   const sinceStr = formatDate(since.toISOString());
 
-  for (const monthDir of safeReaddir(baseDir).filter((d) => d.match(/^\d{4}-\d{2}$/))) {
+  for (const monthDir of safeReaddir(baseDir).filter((d) =>
+    new RegExp(/^\d{4}-\d{2}$/).exec(d)
+  )) {
     const fullMonthDir = resolve(baseDir, monthDir);
     for (const file of safeReaddir(fullMonthDir).filter((f) => f.endsWith(".md"))) {
       const dateStr = file.replace(/\.md$/, "");
@@ -275,7 +281,7 @@ function readRelationshipNotes(since: Date): RelationshipNote[] {
         const noteContent = trimmed.substring(2);
 
         // Parse O(c=X.XX): ..., W: ..., B: ...
-        const opinionMatch = noteContent.match(/^O\(c=([\d.]+)\):\s*(.+)$/);
+        const opinionMatch = new RegExp(/^O\(c=([\d.]+)\):\s*(.+)$/).exec(noteContent);
         if (opinionMatch) {
           notes.push({
             type: "O",
@@ -286,15 +292,15 @@ function readRelationshipNotes(since: Date): RelationshipNote[] {
           continue;
         }
 
-        const wisdomMatch = noteContent.match(/^W:\s*(.+)$/);
+        const wisdomMatch = new RegExp(/^W:\s*(.+)$/).exec(noteContent);
         if (wisdomMatch) {
           notes.push({ type: "W", content: wisdomMatch[1], date: dateStr });
           continue;
         }
 
-        const behaviorMatch = noteContent.match(/^B:\s*(.+)$/);
+        const behaviorMatch = new RegExp(/^Session:\s*(.+)$/).exec(noteContent);
         if (behaviorMatch) {
-          notes.push({ type: "B", content: behaviorMatch[1], date: dateStr });
+          notes.push({ type: "Session", content: behaviorMatch[1], date: dateStr });
         }
       }
     }
@@ -376,7 +382,7 @@ function gatherData(days: number): SelfModelData {
     wisdomFrames,
     graduated,
     reflections,
-    behaviorNotes: relNotes.filter((n) => n.type === "B").map((n) => n.content),
+    behaviorNotes: relNotes.filter((n) => n.type === "Session").map((n) => n.content),
     wisdomNotes: relNotes.filter((n) => n.type === "W").map((n) => n.content),
     selfObservations: reflections.map((r) => r.q1).filter(Boolean),
     algorithmObservations: reflections.map((r) => r.q2).filter(Boolean),
@@ -388,12 +394,10 @@ function gatherData(days: number): SelfModelData {
 function formatDataForInference(data: SelfModelData): string {
   const sections: string[] = [];
 
-  sections.push(`## Raw Data — ${data.days}-day window, ${data.now}`);
-  sections.push(`Sessions: ${data.sessionCount}`);
-  sections.push(
-    `Ratings: ${data.ratings.count} total, ${data.ratings.avg}/10 avg, recent ${data.ratings.recentAvg}/10, trend ${data.ratings.trend}`
-  );
   sections.push(
+    `## Raw Data — ${data.days}-day window, ${data.now}`,
+    `Sessions: ${data.sessionCount}`,
+    `Ratings: ${data.ratings.count} total, ${data.ratings.avg}/10 avg, recent ${data.ratings.recentAvg}/10, trend ${data.ratings.trend}`,
     `${data.ratings.highCount} high (8+), ${data.ratings.lowCount} low (<=3)`
   );
 
@@ -508,7 +512,7 @@ Where are you heading? Improving, declining, stagnating? What's the single most
 
 // ── Narrative Composer ──
 
-export async function composeSelfModel(days: number): Promise<string> {
+async function composeSelfModel(days: number): Promise<string> {
   const data = gatherData(days);
   const rawData = formatDataForInference(data);
   const id = loadSettingsIdentity();
@@ -668,4 +672,4 @@ Output: ~/.pal/memory/self-model.md (synthesized by Sonnet)
   );
 }
 
-if (import.meta.main) run();
+if (import.meta.main) await run();

package/src/tools/session-summary.ts

@@ -27,7 +27,7 @@ interface Usage {
 
 // ── Core Functions ──
 
-export function findSessionFile(
+function findSessionFile(
   sessionId: string,
   claudeDir: string
 ): { filepath: string; project: string } | null {
@@ -79,7 +79,7 @@ export function findSessionFile(
   return latest;
 }
 
-export function parseSession(filepath: string, sessionId: string): Usage {
+function parseSession(filepath: string, sessionId: string): Usage {
   const usage: Usage = {
     input: 0,
     output: 0,
@@ -122,7 +122,7 @@ export function parseSession(filepath: string, sessionId: string): Usage {
       if (d.sessionId !== sessionId) continue;
 
       if (d.timestamp) {
-        if (!firstTs) firstTs = d.timestamp;
+        firstTs ??= d.timestamp;
         lastTs = d.timestamp;
       }
 

package/src/tools/token-cost.ts

@@ -17,7 +17,7 @@ import { palHome } from "../hooks/lib/paths";
 
 // ── Types ──
 
-export interface Bucket {
+interface Bucket {
   input: number;
   output: number;
   cacheWrite5m: number;
@@ -27,7 +27,7 @@ export interface Bucket {
   calls: number;
 }
 
-export function emptyBucket(): Bucket {
+function emptyBucket(): Bucket {
   return {
     input: 0,
     output: 0,
@@ -39,14 +39,14 @@ export function emptyBucket(): Bucket {
   };
 }
 
-export interface TimeBuckets {
+interface TimeBuckets {
   today: Bucket;
   week: Bucket;
   month: Bucket;
   total: Bucket;
 }
 
-export function emptyTimeBuckets(): TimeBuckets {
+function emptyTimeBuckets(): TimeBuckets {
   return {
     today: emptyBucket(),
     week: emptyBucket(),
@@ -85,7 +85,7 @@ function costForUsage(
   );
 }
 
-export function addToBucket(
+function addToBucket(
   bucket: Bucket,
   model: string,
   input: number,
@@ -160,7 +160,7 @@ function addToTimeBuckets(
     addToBucket(tb.today, model, input, output, cacheWrite5m, cacheWrite1h, cacheRead);
 }
 
-export function readClaudeCode(projectFilter?: string): {
+function readClaudeCode(projectFilter?: string): {
   buckets: TimeBuckets;
   byModel: Record<string, Bucket>;
   byProject: Record<string, TimeBuckets>;
@@ -267,7 +267,7 @@ export function readClaudeCode(projectFilter?: string): {
             monthAgo
           );
 
-          if (!byModel[model]) byModel[model] = emptyBucket();
+          byModel[model] ??= emptyBucket();
           addToBucket(
             byModel[model],
             model,
@@ -278,7 +278,7 @@ export function readClaudeCode(projectFilter?: string): {
             cr
           );
 
-          if (!byProject[projName]) byProject[projName] = emptyTimeBuckets();
+          byProject[projName] ??= emptyTimeBuckets();
           addToTimeBuckets(
             byProject[projName],
             ts,
@@ -304,7 +304,7 @@ export function readClaudeCode(projectFilter?: string): {
 
 // ── PAL inference ──
 
-export function readPalInference(): {
+function readPalInference(): {
   buckets: TimeBuckets;
   byModel: Record<string, TimeBuckets>;
   byCaller: Record<string, Bucket>;
@@ -346,7 +346,7 @@ export function readPalInference(): {
         weekAgo,
         monthAgo
       );
-      if (!byModel[e.model]) byModel[e.model] = emptyTimeBuckets();
+      byModel[e.model] ??= emptyTimeBuckets();
       addToTimeBuckets(
         byModel[e.model],
         e.ts,
@@ -360,7 +360,7 @@ export function readPalInference(): {
         weekAgo,
         monthAgo
       );
-      if (!byCaller[e.caller]) byCaller[e.caller] = emptyBucket();
+      byCaller[e.caller] ??= emptyBucket();
       addToBucket(byCaller[e.caller], e.model, e.inputTokens, e.outputTokens, 0, 0, 0);
     } catch {
       /* skip */
@@ -415,11 +415,10 @@ export function usage() {
 
   for (const [model, tb] of Object.entries(pal.byModel)) {
     if (tb.total.calls === 0) continue;
-    const label = model.includes("haiku")
-      ? "Haiku"
-      : model.includes("sonnet")
-        ? "Sonnet"
-        : model.replace("claude-", "");
+    let label: string;
+    if (model.includes("haiku")) label = "Haiku";
+    else if (model.includes("sonnet")) label = "Sonnet";
+    else label = model.replace("claude-", "");
     console.log(`\n  PAL Inference (${label})\n`);
     printRow("Today", tb.today);
     printRow("7d", tb.week);

package/assets/skills/telos/tools/update-projects.ts

@@ -1,106 +0,0 @@
-#!/usr/bin/env bun
-/**
- * UpdateProjects — Upsert a project row in PROJECTS.md by ID.
- *
- * Usage:
- *   bun update-projects.ts <id> "<row>" "<description>"
- *
- * - <id> is the value in the first column (e.g., "my-proj", "side-gig")
- * - <row> is the full table row including the ID column (e.g., "| my-proj | My Project | Done | High | ... |")
- * - If a row with that ID exists, it is replaced
- * - If no row with that ID exists, it is appended
- * - Creates a timestamped backup before modifying
- * - Logs the change to updates.md
- */
-
-import {
-  copyFileSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  writeFileSync,
-} from "node:fs";
-import { resolve } from "node:path";
-import { palHome } from "../../../../src/hooks/lib/paths";
-
-const TELOS_DIR = resolve(palHome(), "telos");
-const BACKUPS_DIR = resolve(TELOS_DIR, "backups");
-const UPDATES_LOG = resolve(TELOS_DIR, "updates.md");
-const PROJECTS_FILE = resolve(TELOS_DIR, "PROJECTS.md");
-
-function timestamp(): string {
-  const now = new Date();
-  const pad = (n: number) => n.toString().padStart(2, "0");
-  return `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
-}
-
-function isoDate(): string {
-  return new Date().toISOString().replace("T", " ").slice(0, 19);
-}
-
-export interface UpsertProjectResult {
-  file: string;
-  id: string;
-  mode: "replaced" | "appended";
-  backed_up: boolean;
-  logged: boolean;
-  description: string;
-}
-
-export function upsertProject(
-  id: string,
-  row: string,
-  description: string
-): UpsertProjectResult {
-  mkdirSync(BACKUPS_DIR, { recursive: true });
-  if (existsSync(PROJECTS_FILE)) {
-    const backupName = `PROJECTS-${timestamp()}.md`;
-    copyFileSync(PROJECTS_FILE, resolve(BACKUPS_DIR, backupName));
-  }
-
-  const existing = existsSync(PROJECTS_FILE) ? readFileSync(PROJECTS_FILE, "utf-8") : "";
-
-  const escapedId = id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const idPattern = new RegExp(`^\\|\\s*${escapedId}\\s*\\|.*$`, "m");
-  let mode: "replaced" | "appended";
-
-  if (idPattern.test(existing)) {
-    writeFileSync(PROJECTS_FILE, existing.replace(idPattern, row.trim()), "utf-8");
-    mode = "replaced";
-  } else {
-    const separator = existing.trim() ? "\n" : "";
-    writeFileSync(
-      PROJECTS_FILE,
-      `${existing.trimEnd()}${separator}${row.trim()}\n`,
-      "utf-8"
-    );
-    mode = "appended";
-  }
-
-  const logEntry = `- **${isoDate()}** — \`PROJECTS.md\` [${id}]: ${description}`;
-  const existingLog = existsSync(UPDATES_LOG)
-    ? readFileSync(UPDATES_LOG, "utf-8")
-    : "# TELOS Updates\n";
-  writeFileSync(UPDATES_LOG, `${existingLog.trimEnd()}\n${logEntry}\n`, "utf-8");
-
-  return { file: "PROJECTS.md", id, mode, backed_up: true, logged: true, description };
-}
-
-function run() {
-  const args = process.argv.slice(2);
-  const id = args[0];
-  const row = args[1];
-  const description = args[2];
-
-  if (!id || !row || !description) {
-    console.error('Usage: bun update-projects.ts <id> "<row>" "<description>"');
-    console.error(
-      '\nExample: bun update-projects.ts my-proj "| my-proj | My Project | In progress | High | Notes |" "Added My Project"'
-    );
-    process.exit(1);
-  }
-
-  console.log(JSON.stringify(upsertProject(id, row, description), null, 2));
-}
-
-if (import.meta.main) run();

package/assets/templates/telos/PROJECTS.md

@@ -1,7 +0,0 @@
-# Projects
-
-<!-- Current projects, their status, and how they relate to each other. -->
-
-| Project | Status | Priority | Notes |
-|---------|--------|----------|-------|
-|         |        |          |       |