portable-agent-layer 0.90.0 → 0.91.1

package/src/cli/whats-new.ts

@@ -0,0 +1,108 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { palPkg } from "../hooks/lib/paths";
+
+export interface Release {
+  tag_name: string;
+  body?: string | null;
+}
+
+export interface WhatsNew {
+  items: string[];
+  more: number;
+  url: string;
+}
+
+const SHOWN = 3;
+
+function parts(version: string): number[] {
+  return version.replace(/^v/, "").split(".").map(Number);
+}
+
+export function newer(a: string, b: string): boolean {
+  const [x, y] = [parts(a), parts(b)];
+  for (let i = 0; i < 3; i++) {
+    if ((x[i] ?? 0) !== (y[i] ?? 0)) return (x[i] ?? 0) > (y[i] ?? 0);
+  }
+  return false;
+}
+
+/** "* **rating:** confirm corrections ([abc](url))" reads "Confirm corrections". */
+export function noteText(bullet: string): string {
+  const text = bullet
+    .replace(/^\s*[*-]\s*/, "")
+    .replace(/^\*\*[^*]+:\*\*\s*/, "")
+    .replace(/\s*\(\[[^\]]*\]\([^)]*\)\)/g, "")
+    .trim();
+  return text.charAt(0).toUpperCase() + text.slice(1);
+}
+
+function section(body: string, heading: string): string[] {
+  const start = body.indexOf(`### ${heading}`);
+  if (start < 0) return [];
+  const rest = body.slice(start).split("\n").slice(1);
+  const end = rest.findIndex((line) => line.startsWith("#"));
+  return (end < 0 ? rest : rest.slice(0, end))
+    .filter((line) => /^\s*[*-]\s/.test(line))
+    .map(noteText);
+}
+
+export function releaseNotes(body: string): string[] {
+  return [...section(body, "Features"), ...section(body, "Bug Fixes")];
+}
+
+function repoSlug(pkg = palPkg()): string | null {
+  try {
+    const manifest = JSON.parse(readFileSync(resolve(pkg, "package.json"), "utf-8")) as {
+      repository?: { url?: string };
+    };
+    return (
+      /github\.com\/([^/]+\/[^/.]+)/.exec(manifest.repository?.url ?? "")?.[1] ?? null
+    );
+  } catch {
+    return null;
+  }
+}
+
+export function summarizeReleases(
+  releases: Release[],
+  from: string,
+  to: string,
+  slug: string
+): WhatsNew | null {
+  const items = releases
+    .filter((r) => newer(r.tag_name, from) && !newer(r.tag_name, to))
+    .flatMap((r) => releaseNotes(r.body ?? ""));
+  if (items.length === 0) return null;
+  return {
+    items: items.slice(0, SHOWN),
+    more: Math.max(0, items.length - SHOWN),
+    url: `github.com/${slug}/releases/tag/v${to}`,
+  };
+}
+
+async function fetchReleases(slug: string): Promise<Release[]> {
+  const response = await fetch(
+    `https://api.github.com/repos/${slug}/releases?per_page=30`,
+    {
+      headers: { accept: "application/vnd.github+json" },
+      signal: AbortSignal.timeout(3000),
+    }
+  );
+  return response.ok ? ((await response.json()) as Release[]) : [];
+}
+
+/** Null when the notes cannot be fetched in time: an update never waits on GitHub. */
+export async function whatsNew(
+  from: string,
+  to: string,
+  fetchAll: (slug: string) => Promise<Release[]> = fetchReleases
+): Promise<WhatsNew | null> {
+  const slug = repoSlug();
+  if (!slug) return null;
+  try {
+    return summarizeReleases(await fetchAll(slug), from, to, slug);
+  } catch {
+    return null;
+  }
+}

package/src/targets/lib.ts

@@ -18,6 +18,7 @@ import {
 } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, isAbsolute, resolve, sep } from "node:path";
+import { createStyle, PALETTE, type Rgb } from "../cli/ui/style";
 import {
   AGENT_NAMES,
   AGENT_REGISTRY,
@@ -45,12 +46,47 @@ function narrate(line: string): void {
   if (narrating) console.log(line);
 }
 
+export type LogLevel = "info" | "success" | "warn" | "error" | "detail";
+type LogSink = (level: LogLevel, message: string) => void;
+
+let sink: LogSink | null = null;
+
+/** Hands every log line to `collect` while `work` runs, so a caller can place it under its own step. */
+export async function capturingLog<T>(
+  collect: LogSink,
+  work: () => Promise<T>
+): Promise<T> {
+  const previous = sink;
+  sink = collect;
+  try {
+    return await work();
+  } finally {
+    sink = previous;
+  }
+}
+
+const LEVEL_COLOR: Record<LogLevel, Rgb> = {
+  info: PALETTE.indigo,
+  success: PALETTE.green,
+  warn: PALETTE.amber,
+  error: PALETTE.rose,
+  detail: PALETTE.indigo,
+};
+
+function tagged(level: LogLevel, message: string): string {
+  return `${createStyle().paint(LEVEL_COLOR[level], "[pal]")} ${message}`;
+}
+
+function emit(level: LogLevel, message: string, write: (line: string) => void): void {
+  if (sink) sink(level, message);
+  else write(tagged(level, message));
+}
+
 export const log = {
-  info: (msg: string) => narrate(`\x1b[34m[pal]\x1b[0m ${msg}`),
-  success: (msg: string) => narrate(`\x1b[32m[pal]\x1b[0m ${msg}`),
-  heading: (label: string) => narrate(`\n━━━ ${label} ━━━`),
-  warn: (msg: string) => console.log(`\x1b[33m[pal]\x1b[0m ${msg}`),
-  error: (msg: string) => console.error(`\x1b[31m[pal]\x1b[0m ${msg}`),
+  info: (msg: string) => emit("info", msg, narrate),
+  success: (msg: string) => emit("success", msg, narrate),
+  warn: (msg: string) => emit("warn", msg, (line) => console.log(line)),
+  error: (msg: string) => emit("error", msg, (line) => console.error(line)),
 
   /**
    * Per-item narration from inside a loop, where the caller already reports the
@@ -61,7 +97,7 @@ export const log = {
    */
   detail: (msg: string) => {
     if (runningUnderTest()) return;
-    narrate(`\x1b[34m[pal]\x1b[0m ${msg}`);
+    emit("detail", msg, narrate);
   },
 };
 
@@ -1152,6 +1188,13 @@ function shippedAgentNames(): Set<string> {
   );
 }
 
+export function installedShippedAgentCount(agent: AgentName): number {
+  const dir = nativeAgentsDir(agent);
+  return [...shippedAgentNames()].filter((name) =>
+    existsSync(resolve(dir, agentFileName(name, agent)))
+  ).length;
+}
+
 /** List the user-authored subagents in ~/.pal/agents/. */
 export function listPersonalSubagents(): string[] {
   if (!existsSync(palAgentsStore())) return [];