portable-agent-layer 0.35.0 → 0.36.0

package/src/tools/agent/handoff-note.ts

@@ -0,0 +1,116 @@
+#!/usr/bin/env bun
+/**
+ * HandoffNote — Write or clear a handoff note for the current project.
+ *
+ * Called in the ALGORITHM LEARN phase when work is unfinished.
+ * Written by Claude in-session — no inference call needed.
+ *
+ * Usage:
+ *   bun ~/.pal/tools/handoff-note.ts --title "what we were doing" --text "what remains + next steps"
+ *   bun ~/.pal/tools/handoff-note.ts --done   # mark completed, suppress next-session injection
+ */
+
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { ensureDir, paths } from "../../hooks/lib/paths";
+
+interface HandoffEntry {
+  timestamp: string;
+  title: string;
+  status: "in-progress" | "completed";
+  handoff: string;
+  artifacts: string[];
+}
+
+function handoffPath(): string {
+  return resolve(ensureDir(paths.state()), "last-handoff.json");
+}
+
+function readHandoffs(): Record<string, HandoffEntry> {
+  const p = handoffPath();
+  if (!existsSync(p)) return {};
+  try {
+    return JSON.parse(readFileSync(p, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+
+function writeHandoffs(handoffs: Record<string, HandoffEntry>): void {
+  const entries = Object.entries(handoffs);
+  const trimmed = entries.length > 20 ? Object.fromEntries(entries.slice(-20)) : handoffs;
+  writeFileSync(handoffPath(), JSON.stringify(trimmed, null, 2), "utf-8");
+}
+
+export function writeHandoffNote(
+  cwd: string,
+  title: string,
+  text: string,
+  done: boolean
+): { success: boolean; message: string } {
+  const handoffs = readHandoffs();
+  handoffs[cwd] = {
+    timestamp: new Date().toISOString(),
+    title,
+    status: done ? "completed" : "in-progress",
+    handoff: text,
+    artifacts: [],
+  };
+  writeHandoffs(handoffs);
+  return {
+    success: true,
+    message: done ? "Handoff cleared (marked completed)" : "Handoff note written",
+  };
+}
+
+function run() {
+  const { values } = parseArgs({
+    args: Bun.argv.slice(2),
+    options: {
+      title: { type: "string" },
+      text: { type: "string" },
+      done: { type: "boolean" },
+      help: { type: "boolean", short: "h" },
+    },
+  });
+
+  if (values.help) {
+    console.log(`
+HandoffNote — Write a handoff note for the current project
+
+Usage:
+  bun ~/.pal/tools/handoff-note.ts --title "what we were doing" --text "what remains"
+  bun ~/.pal/tools/handoff-note.ts --done    # mark session completed
+
+Arguments:
+  --title   Brief title of what was being worked on (5-10 words)
+  --text    What remains unfinished — decisions made, next steps, blockers
+  --done    Mark as completed; suppresses "pick up where you left off" injection
+
+Output: writes to memory/state/last-handoff.json keyed by cwd
+`);
+    process.exit(0);
+  }
+
+  if (values.done) {
+    const result = writeHandoffNote(
+      process.cwd(),
+      values.title || "session",
+      values.text || "",
+      true
+    );
+    console.log(JSON.stringify(result, null, 2));
+    process.exit(0);
+  }
+
+  if (!values.title || !values.text) {
+    console.error("Required: --title and --text (or --done to close)");
+    process.exit(1);
+  }
+
+  const result = writeHandoffNote(process.cwd(), values.title, values.text, false);
+  console.log(JSON.stringify(result, null, 2));
+}
+
+if (import.meta.main) run();

package/src/tools/agent/relationship-note.ts

@@ -0,0 +1,51 @@
+#!/usr/bin/env bun
+/**
+ * RelationshipNote — Write a B entry to today's relationship log.
+ *
+ * Called in the ALGORITHM LEARN phase. Claude writes the B entry directly
+ * from full session context — no inference call needed.
+ *
+ * Usage:
+ *   bun ~/.pal/tools/relationship-note.ts --b "what I did this session"
+ */
+
+import { parseArgs } from "node:util";
+import { appendNotes } from "../../hooks/lib/relationship";
+
+function run() {
+  const { values } = parseArgs({
+    args: Bun.argv.slice(2),
+    options: {
+      b: { type: "string" },
+      help: { type: "boolean", short: "h" },
+    },
+  });
+
+  if (values.help) {
+    console.log(`
+RelationshipNote — Append a B entry to today's relationship log
+
+Usage:
+  bun ~/.pal/tools/relationship-note.ts --b "description"
+
+Arguments:
+  --b   What happened this session (1-2 sentences, first-person, specific)
+
+Output: appends to memory/relationship/YYYY-MM/YYYY-MM-DD.md
+`);
+    process.exit(0);
+  }
+
+  if (!values.b) {
+    console.error("Required: --b");
+    process.exit(1);
+  }
+
+  appendNotes([{ type: "Session", text: values.b }]);
+
+  console.log(
+    JSON.stringify({ success: true, message: "Relationship note written" }, null, 2)
+  );
+}
+
+if (import.meta.main) 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;
@@ -94,7 +94,7 @@ export function loadNotes(daysBack: number): ParsedNote[] {
           const obMatch = line.match(/^- ([OB])\(c=([\d.]+)\):\s*(.+)$/);
           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,

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;
@@ -292,9 +292,9 @@ function readRelationshipNotes(since: Date): RelationshipNote[] {
           continue;
         }
 
-        const behaviorMatch = noteContent.match(/^B:\s*(.+)$/);
+        const behaviorMatch = noteContent.match(/^Session:\s*(.+)$/);
         if (behaviorMatch) {
-          notes.push({ type: "B", content: behaviorMatch[1], date: dateStr });
+          notes.push({ type: "Session", content: behaviorMatch[1], date: dateStr });
         }
       }
     }
@@ -376,7 +376,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),

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 |
-|---------|--------|----------|-------|
-|         |        |          |       |