portable-agent-layer 0.85.17 → 0.85.19

package/assets/schema/pal-settings.schema.json

@@ -70,6 +70,10 @@
           "type": "boolean",
           "description": "One line of the current time with every prompt, in identity.principal.timezone, so a session resumed hours later knows the day changed."
         },
+        "repoState": {
+          "type": "boolean",
+          "description": "One line with every prompt saying whether the work in the current directory is committed, pushed and released; a registered project without git is named as such."
+        },
         "dueReminders": {
           "type": "boolean",
           "description": "Opt-in, off by default until 1.0. Due maintenance reminders (learning analysis, relationship reflect) with every prompt until a reply names their command; then quiet until the next day."

package/assets/templates/pal-settings.json

@@ -26,6 +26,7 @@
     "contextualSteering": true,
     "skillMatching": true,
     "wallClock": true,
+    "repoState": true,
     "dueReminders": false,
     "interactionAwareness": true,
     "reactionSampling": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portable-agent-layer",
-  "version": "0.85.17",
+  "version": "0.85.19",
   "description": "PAL — Portable Agent Layer: persistent personal context for AI coding assistants",
   "type": "module",
   "bin": {

package/src/hooks/handlers/inject-retrieval.ts

@@ -12,6 +12,7 @@ import { dueNudgeReminder } from "../lib/daily-nudge";
 import { observeTurn } from "../lib/interaction";
 import { logDebug, logError } from "../lib/log";
 import { parkPromptContext } from "../lib/parked-context";
+import { getRepoStateReminder } from "../lib/repo-state";
 import { runRetrieval } from "../lib/retrieval";
 import { ensureIndex } from "../lib/retrieval-index";
 import { isEnabled } from "../lib/settings";
@@ -70,7 +71,7 @@ function writeForAgent(reminder: string, sessionId?: string): void {
   else if (sessionId) parkPromptContext(sessionId, reminder);
 }
 
-/** Merge every prompt-time source — the wall clock, contextual steering, skill
+/** Merge every prompt-time source — the wall clock, the repo state, contextual steering, skill
  *  matches, prior-lesson retrieval — into one payload, or null when none of them
  *  produced anything. The clock leads: it is the only part that is true of the
  *  moment rather than of the prompt.
@@ -81,6 +82,7 @@ export async function getPromptContext(
 ): Promise<string | null> {
   const parts = [
     getWallClockReminder(),
+    withinBudget(() => getRepoStateReminder(), BUDGET_MS),
     withinBudget(() => observeTurn(prompt, sessionId), BUDGET_MS),
     withinBudget(() => dueNudgeReminder(), BUDGET_MS),
     getSteeringReminder(prompt),

package/src/hooks/lib/repo-state.ts

@@ -0,0 +1,101 @@
+/**
+ * Whether the work here is committed, pushed and released, read fresh with every
+ * prompt — so the agent answers from the checkout, not from what it remembers.
+ */
+
+import { spawnSync } from "node:child_process";
+import { basename } from "node:path";
+import { readAllProjects, resolveProjectFromCwd } from "./projects";
+import { isEnabled } from "./settings";
+
+const GIT_TIMEOUT_MS = 1000;
+
+interface Status {
+  head: string;
+  hasCommits: boolean;
+  upstream: string | null;
+  ahead: number;
+  behind: number;
+  changed: number;
+}
+
+function git(cwd: string, ...args: string[]): string | null {
+  const result = spawnSync("git", ["-C", cwd, ...args], {
+    encoding: "utf-8",
+    timeout: GIT_TIMEOUT_MS,
+  });
+  return result.status === 0 ? result.stdout.trim() : null;
+}
+
+function header(lines: string[], key: string): string | null {
+  const line = lines.find((l) => l.startsWith(`# branch.${key} `));
+  return line ? line.slice(`# branch.${key} `.length) : null;
+}
+
+function parseStatus(porcelain: string): Status {
+  const lines = porcelain.split("\n").filter(Boolean);
+  const [ahead, behind] = (header(lines, "ab") ?? "+0 -0")
+    .split(" ")
+    .map((n) => Math.abs(Number(n)));
+  return {
+    head: header(lines, "head") ?? "(detached)",
+    hasCommits: header(lines, "oid") !== "(initial)",
+    upstream: header(lines, "upstream"),
+    ahead,
+    behind,
+    changed: lines.filter((l) => !l.startsWith("#")).length,
+  };
+}
+
+const count = (n: number, noun: string) => `${n} ${noun}${n === 1 ? "" : "s"}`;
+
+function syncState(status: Status): string[] {
+  if (!status.upstream) return ["never pushed"];
+  const unsynced = [
+    status.ahead > 0 ? `${count(status.ahead, "commit")} not pushed` : "",
+    status.behind > 0
+      ? `${count(status.behind, "commit")} behind ${status.upstream}`
+      : "",
+  ].filter(Boolean);
+  return unsynced.length > 0 ? unsynced : ["pushed"];
+}
+
+function releaseState(cwd: string): string[] {
+  const described = git(cwd, "describe", "--tags", "--long");
+  const match = described ? /^(.*)-(\d+)-g[0-9a-f]+$/.exec(described) : null;
+  if (!match) return [];
+  const [, tag, since] = match;
+  return Number(since) === 0
+    ? [`at tag ${tag}`]
+    : [`${count(Number(since), "commit")} since tag ${tag}`];
+}
+
+function workState(status: Status): string {
+  if (!status.hasCommits) return "no commits yet";
+  return status.changed > 0 ? `${count(status.changed, "file")} uncommitted` : "clean";
+}
+
+function gitLine(cwd: string, toplevel: string): string | null {
+  const porcelain = git(cwd, "status", "--porcelain=v2", "--branch");
+  if (porcelain === null) return null;
+  const status = parseStatus(porcelain);
+  return [
+    `Repo: ${basename(toplevel)} on ${status.head}`,
+    workState(status),
+    ...syncState(status),
+    ...releaseState(cwd),
+  ].join(" · ");
+}
+
+function unversionedProjectLine(cwd: string): string | null {
+  const project = resolveProjectFromCwd(cwd, readAllProjects());
+  if (!project) return null;
+  return `Repo: ${project.name} is not under git — nothing in it is committed, pushed or released; the files on disk are its whole state`;
+}
+
+export function getRepoStateReminder(cwd: string = process.cwd()): string | null {
+  if (!isEnabled("repoState")) return null;
+  const toplevel = git(cwd, "rev-parse", "--show-toplevel");
+  const line = toplevel ? gitLine(cwd, toplevel) : unversionedProjectLine(cwd);
+  return line ? `<system-reminder>${line}</system-reminder>` : null;
+}