agents-pod 0.3.5 → 0.3.7

package/src/wrapper.ts

@@ -28,6 +28,7 @@ import {
   withRegistryLock,
   writePods,
   type PodRecord,
+  type WakeUpEntry,
   type WakeUpOutcome,
 } from "./registry.ts";
 import { snapshotDocs } from "./workspace.ts";
@@ -70,7 +71,7 @@ export function composePrompt(goal: string, docsDir: string, roleInstructions =
     `1. ${join(docsDir, "HANDOFF.md")} — your predecessor's handoff; start where it ended.`,
     `2. ${join(docsDir, "TASKS.md")} — the plan and its checkboxes.`,
     `3. ${join(docsDir, "DECISIONS.md")} — the why behind the plan.`,
-    "When this window's work is done, end with pod_handoff (status: rotating or done) so your successor starts clean. Write-then-exit is the protocol: an exit without a fresh handoff counts as a failure.",
+    "When this window's work is done, end with pod_handoff so your successor starts clean: status rotating (the goal is open and the next wake-up continues), quiet (this window is satisfied, nothing is scheduled — wake me when work arrives), or done (the goal is reached and the pod ends). Write-then-exit is the protocol: an exit without a fresh handoff counts as a failure.",
   ].join("\n");
   const goalBlock = `Goal: ${goal}`;
   const sections = [preamble, roleInstructions.trim(), goalBlock].filter(
@@ -170,14 +171,19 @@ export interface Adjudication {
 async function freshDeclaration(
   docsDir: string,
   wakeStart: number,
-): Promise<"more" | "done" | undefined> {
+): Promise<"more" | "quiet" | "done" | undefined> {
   const handoff = join(docsDir, "HANDOFF.md");
   const info = await stat(handoff).catch(() => undefined);
   if (!info || info.mtimeMs <= wakeStart) return undefined;
   const firstLine = (await readFile(handoff, "utf8")).split("\n", 1)[0]!.trim();
-  const declared = /^status:\s*(rotating|done)\s*$/.exec(firstLine);
+  // Three words, and no fourth (ADR 0009 amendment, #36): `rotating` — another
+  // wake-up is the work; `quiet` — this window is satisfied and nothing is
+  // scheduled; `done` — terminal. Anything else is not a declaration.
+  const declared = /^status:\s*(rotating|quiet|done)\s*$/.exec(firstLine);
   if (!declared) return undefined;
-  return declared[1] === "done" ? "done" : "more";
+  const word = declared[1];
+  if (word === "done") return "done";
+  return word === "quiet" ? "quiet" : "more";
 }
 
 /**
@@ -265,7 +271,13 @@ async function recordUnresolved(
   what: string,
 ): Promise<boolean> {
   return updatePodRecord(podId, podRoot, n, (record) => {
-    record.wakeUps.push({ n, outcome: "failed", detail: what });
+    record.wakeUps.push({
+      n,
+      outcome: "failed",
+      detail: what,
+      at: Date.now(),
+      ...(record.admitted === undefined ? {} : { trigger: record.admitted }),
+    });
     record.state = "idle";
   });
 }
@@ -493,11 +505,13 @@ export async function runWrapper(argv: string[]): Promise<number> {
       // a wedged kill. A human cancel has no intent and records exactly as
       // before.
       if (record.killIntent?.n !== n) {
-        record.wakeUps.push(
-          killedAfterGrace
-            ? { n, outcome: "cancelled", detail: "killed after grace" }
-            : { n, outcome: "cancelled" },
-        );
+        record.wakeUps.push({
+          n,
+          outcome: "cancelled",
+          ...(killedAfterGrace ? { detail: "killed after grace" } : {}),
+          at: Date.now(),
+          ...(record.admitted === undefined ? {} : { trigger: record.admitted }),
+        });
         record.state = "cancelled";
       }
     });
@@ -518,7 +532,17 @@ export async function runWrapper(argv: string[]): Promise<number> {
   // (ADR 0025). Failures are logged inside the flush and never change outcome.
   await flushOutbox(podId, pod.project, n);
   const recorded = await updatePodRecord(podId, podRoot, n, (record) => {
-    record.wakeUps.push(detail === undefined ? { n, outcome } : { n, outcome, detail });
+    // Provenance (ADR 0032): when, and what admitted the window. `admitted` is
+    // written by the launcher under the registry lock, so a wake-up the tick
+    // started and one a human started stop looking identical after the fact.
+    const entry: WakeUpEntry = {
+      n,
+      outcome,
+      ...(detail === undefined ? {} : { detail }),
+      at: Date.now(),
+      ...(record.admitted === undefined ? {} : { trigger: record.admitted }),
+    };
+    record.wakeUps.push(entry);
     record.state = outcome === "done" ? "done" : "idle";
   });
   if (!recorded) return 1;