portable-agent-layer 0.78.2 → 0.79.0

package/src/hooks/lib/semi-static.ts

@@ -7,10 +7,11 @@
  */
 
 import { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { basename, resolve } from "node:path";
 import { type FailureEntry, readFailures } from "./learning-store";
 import { loadOpinionContext } from "./opinions";
 import { palHome, paths } from "./paths";
+import { type ProjectProgress, readAllProjects, resolveProjectFromCwd } from "./projects";
 import { readFramePrinciples } from "./wisdom";
 
 /** A single semi-static context source — built at session stop, loaded natively at session start. */
@@ -67,6 +68,12 @@ export function rankFailures(
     .slice(0, limit);
 }
 
+function projectTag(cwd: string, projects: ProjectProgress[]): string {
+  if (!cwd) return "";
+  const name = resolveProjectFromCwd(cwd, projects)?.name ?? basename(cwd);
+  return `[${name}]`;
+}
+
 /** Build the failure avoid-list, prioritized by relevance to the current project. */
 export function loadFailurePatterns(): string {
   try {
@@ -74,11 +81,11 @@ export function loadFailurePatterns(): string {
     const all = readFailures(paths.failures());
     if (all.length === 0) return "";
 
+    const projects = readAllProjects();
     const lines = rankFailures(all, cwd).map((e) => {
       const label = e.rating ? `[${e.rating}/10]` : "";
-      const tag = e.cwd === cwd ? "[project]" : "[other]";
       const text = e.principle || e.context;
-      return `- ${label} ${tag} ${text}`.trim();
+      return ["-", label, projectTag(e.cwd, projects), text].filter(Boolean).join(" ");
     });
 
     return ["## Lessons from Recent Failures — Apply These Now", ...lines].join("\n");

package/src/hooks/lib/session-context.ts

@@ -24,6 +24,28 @@ export function isSubagentSession(env: NodeJS.ProcessEnv): boolean {
   return env.CLAUDE_PROJECT_DIR?.includes("/.claude/Agents/") ?? false;
 }
 
+export type SessionStartContext = "full" | "without-handoff" | "none";
+
+/**
+ * Claude Code and Codex replay the context injected at startup when a session
+ * is resumed. Copilot does not document it, and has shipped a release that
+ * dropped startup context, so it keeps getting the full context on resume.
+ */
+const RESUME_KEEPS_CONTEXT: ReadonlySet<string> = new Set(["claude", "codex"]);
+
+/**
+ * After a compaction, CompactRecover restores the last exchange, so the
+ * handoff is redundant. Agents that name no source get everything.
+ */
+export function contextForSource(
+  agent: string,
+  source: string | undefined
+): SessionStartContext {
+  if (source === "resume" && RESUME_KEEPS_CONTEXT.has(agent)) return "none";
+  if (source === "compact") return "without-handoff";
+  return "full";
+}
+
 /**
  * Copilot and Cursor read AGENTS.md natively from nothing, so it is prepended
  * here; Codex reaches it through a symlink and Claude Code loads it itself.

package/src/hooks/lib/session-dir.ts

@@ -0,0 +1,9 @@
+/**
+ * The folder a session was started in. A hook's own cwd follows every `cd`
+ * the agent makes, so keying by it files a session under whatever subfolder
+ * it happened to end in. Claude Code exports the start folder as
+ * CLAUDE_PROJECT_DIR; agents that do not fall back to the cwd.
+ */
+export function sessionDir(env: NodeJS.ProcessEnv = process.env): string {
+  return env.CLAUDE_PROJECT_DIR || process.cwd();
+}

package/src/hooks/lib/settings.ts

@@ -54,28 +54,27 @@ const IDENTITY_DEFAULTS: Identity = {
 
 // ── Singleton ──
 
-let cached: PalSettingsData | null = null;
+let cached: { path: string; data: PalSettingsData } | null = null;
 
 function settingsPath(): string {
   return resolve(paths.memory(), "pal-settings.json");
 }
 
-function load(): PalSettingsData {
-  if (cached) return cached;
-  const p = settingsPath();
-  if (!existsSync(p)) {
-    cached = {};
-    return cached;
-  }
+function readSettingsFile(p: string): PalSettingsData {
+  if (!existsSync(p)) return {};
   try {
-    cached = JSON.parse(readFileSync(p, "utf-8")) as PalSettingsData;
-    return cached;
+    return JSON.parse(readFileSync(p, "utf-8")) as PalSettingsData;
   } catch {
-    cached = {};
-    return cached;
+    return {};
   }
 }
 
+function load(): PalSettingsData {
+  const p = settingsPath();
+  if (cached?.path !== p) cached = { path: p, data: readSettingsFile(p) };
+  return cached.data;
+}
+
 /** Force re-read from disk (useful after writes) */
 export function reload(): PalSettingsData {
   cached = null;

package/src/hooks/lib/work-tracking.ts

@@ -169,7 +169,15 @@ export function appendProjectHistory(cwd: string, entry: ProjectHistoryEntry): v
 
 /** Read the session history for a given cwd */
 export function readProjectHistory(cwd: string, limit = 15): ProjectHistoryEntry[] {
-  const historyPath = historyFileFor(cwd);
+  return readHistoryFile(historyFileFor(cwd), limit);
+}
+
+export function lastSessionTitle(project: string): string | undefined {
+  const historyPath = resolve(paths.projectHistory(), project, "history.jsonl");
+  return readHistoryFile(historyPath, 1)[0]?.title;
+}
+
+function readHistoryFile(historyPath: string, limit: number): ProjectHistoryEntry[] {
   if (!existsSync(historyPath)) return [];
   try {
     const lines = readFileSync(historyPath, "utf-8").trim().split("\n").filter(Boolean);

package/src/tools/{relationship-reflect.ts → agent/relationship-reflect.ts}

@@ -8,17 +8,17 @@
  * - Generate a summary report
  *
  * Usage:
- *   bun run tool:reflect              # Reflect on last 7 days
- *   bun run tool:reflect -- --month   # Reflect on last 30 days
- *   bun run tool:reflect -- --dry-run # Preview without writing
+ *   pal cli relationship-reflect             # Reflect on last 7 days
+ *   pal cli relationship-reflect --month     # Reflect on last 30 days
+ *   pal cli relationship-reflect --dry-run   # Preview without writing
  */
 
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { parseArgs } from "node:util";
-import { readOpinions, saveOpinion, setLastReflectDate } from "../hooks/lib/opinions";
-import { palHome } from "../hooks/lib/paths";
-import { emit } from "./lib/emit";
+import { readOpinions, saveOpinion, setLastReflectDate } from "../../hooks/lib/opinions";
+import { palHome } from "../../hooks/lib/paths";
+import { emit } from "../lib/emit";
 import {
   consoleLines,
   formatReport,
@@ -27,7 +27,8 @@ import {
   loadRatings,
   planPromotions,
   reportPath,
-} from "./lib/relationship-reflect";
+} from "../lib/relationship-reflect";
+import { scriptArgs } from "../lib/script-args";
 
 const HELP = `
 RelationshipReflect — Periodic reflection + opinion promotion
@@ -36,9 +37,9 @@ Reads recent relationship notes and ratings. Promotes recurring
 observations (O type) into tracked opinions with confidence scoring.
 
 Usage:
-  bun run tool:reflect              Reflect on last 7 days (default)
-  bun run tool:reflect -- --month   Reflect on last 30 days
-  bun run tool:reflect -- --dry-run Preview without writing
+  pal cli relationship-reflect             Reflect on last 7 days (default)
+  pal cli relationship-reflect --month     Reflect on last 30 days
+  pal cli relationship-reflect --dry-run   Preview without writing
 
 Output:
   - Updates memory/relationship/opinions.json (confidence tracking)
@@ -56,9 +57,9 @@ function saveReport(report: string, period: string): string {
   return filepath;
 }
 
-function run() {
+export function run(argv: string[] = scriptArgs()) {
   const { values } = parseArgs({
-    args: Bun.argv.slice(2),
+    args: argv,
     options: {
       month: { type: "boolean" },
       "dry-run": { type: "boolean" },