@wjarka/cezarion 0.16.0 → 0.17.0

package/dist/handoff.d.ts

@@ -1,10 +1,16 @@
+import { type HandoffRecords } from './contract/index.js';
+import type { RunStore } from './runs/store.ts';
 /**
  * Per-task handoff journal (spec 007): `.ai/cezar/runs/<runId>.handoff.md`,
  * next to the run's NDJSON events and outside the task worktree — it survives
- * worktree removal. Cez seeds the skeleton and appends heartbeats; the agent
- * (told via CEZ_HANDOFF_FILE + the system-prompt fragment below) keeps the
- * "Progress log" and "Resume notes" sections up to date. Everything here is
- * best-effort: the handoff is a journal, never a reason to fail a run.
+ * worktree removal. Cez seeds the skeleton; the agent (told via
+ * CEZ_HANDOFF_FILE + the system-prompt fragment below) keeps the "Progress log"
+ * and "Resume notes" sections up to date. cezar's own records, the autosave
+ * reports, live in the run store (`RunRecord.handoffRecords`) and reach the file
+ * as ONE block that cezar rewrites whole (hearsay-tools/cezarion#1809), so cezar
+ * never edits a line the agent writes. cezar writes no lifecycle line: the run
+ * event log and the run status hold those facts. Everything here is best-effort:
+ * the handoff is a journal, never a reason to fail a run.
  */
 export declare function handoffPath(dataDir: string, runId: string): string;
 export interface HandoffSeed {
@@ -12,51 +18,55 @@ export interface HandoffSeed {
     title: string;
     workflow: string;
     task: string;
-    branch?: string;
-    worktreePath?: string;
+    branch?: string | undefined;
+    worktreePath?: string | undefined;
 }
 /** Create the handoff skeleton. Idempotent — an existing file (resume,
  *  continuation) is never overwritten. Returns the file path. */
 export declare function seedHandoffFile(dataDir: string, run: HandoffSeed): string;
 /**
- * Cez's own heartbeat (the janitor pattern): insert `- <ISO ts> — <note>`
- * right under the `## Progress log` header (newest at the top), so the file
- * stays current even when the agent forgets to write. Missing header →
- * append at the end of the file; missing file → no-op.
+ * `text` with its records block replaced by the one for `records` (hearsay-tools/cezarion#1809).
+ * The block runs from the first begin-marker line through the first end-marker line after it; a
+ * begin marker with no end marker is that one line. Without a block, a new one goes right before
+ * the seeded `## Goal` line, or at the start. No other part of `text` is read or changed, and an
+ * empty `text` (no file) stays empty.
  */
-export declare function appendHandoffHeartbeat(dataDir: string, runId: string, note: string): void;
-/** Full handoff markdown, or '' when the file doesn't exist (yet). */
-export declare function readHandoff(dataDir: string, runId: string): string;
+export declare function renderHandoffRecords(text: string, records: HandoffRecords | undefined): string;
+type HandoffStore = Pick<RunStore, 'getRun' | 'updateRun'>;
+/** Show the store's records in the file again. Every session launch does, so its opening message
+ *  carries them after a crash, an agent edit, or a deleted block or file. */
+export declare function refreshHandoffRecords(store: HandoffStore, dataDir: string, runId: string): void;
+/** Cez's autosave report (hearsay-tools/cezarion#1004): a commit or a skip, newest first. The
+ *  block shows it, never the Progress log, whose lines are the agent's own. */
+export declare function recordHandoffAutosave(store: HandoffStore, dataDir: string, runId: string, note: string): void;
 /**
- * First few non-empty lines under "## Progress log" (spec 010 — the variant
- * comparison columns). Stops at the next `## ` header; '' when there's no
- * Progress log section or it's empty.
+ * The periodic timer's commit (hearsay-tools/cezarion#1004): a clean closing flush reports
+ * nothing, so the timer reports its own commits, as ONE record per run of consecutive periodic
+ * commits on one branch — a record every 90 s would bury the block. When the newest record is a
+ * periodic one for `commit.branch`, it is replaced with the count + 1, its first sha, this sha as
+ * the latest and a new time; any other newest record gets a new one above it. The merge reads the
+ * record's fields, never the file, so an agent edit cannot restart the count. `sha: null` is a
+ * commit whose hash could not be read back; `branch: null` is a detached HEAD.
  */
-export declare function handoffProgressExcerpt(text: string, maxLines?: number): string;
+export declare function recordHandoffPeriodicAutosave(store: HandoffStore, dataDir: string, runId: string, commit: {
+    sha: string | null;
+    branch: string | null;
+}): void;
+/** Full handoff markdown, or '' when the file doesn't exist (yet). */
+export declare function readHandoff(dataDir: string, runId: string): string;
 export declare function deleteHandoff(dataDir: string, runId: string): void;
+/** The rolling handoff journal and lifecycle guidance for sessions without cezar tools. */
+export declare const HANDOFF_ONLY_INSTRUCTIONS: string;
 /**
- * Is the global follow-up inbox on? (#471)
- *
- * Opt-in, off by default: agents kept hanging on stale, pre-saved follow-ups,
- * which made skill behavior unpredictable. This is the single source of truth —
- * `resolveCapabilities` reports it to the UI and `RunManager` enforces it on
- * every run, so the HTTP route, the `cezar run` CLI and the inbox's own "▶ Run"
- * cannot drift apart. The per-task handoff journal is a separate feature and is
- * never gated by this.
- *
- * An exact `'1'` opts in — the house spelling (`AGENTS.md`: "opt-in behind a
- * `CEZ_*` flag, off by default").
- */
-export declare function followupsEnabled(env?: NodeJS.ProcessEnv): boolean;
-/**
- * Appended to every agent step's `--append-system-prompt` (spec 007). The
- * matching handoff/task env vars are set on every agent process;
- * CEZ_TODOS_FILE carries a usable path only when follow-up generation is
- * enabled (#444, #471) — opted-out runs get it empty, never absent, so an
- * inherited value from a parent cezar cannot shine through
- * (`RunManager.agentEnv`).
+ * The handoff contract for one agent session. With `tools` (the session has cezar's tools) the
+ * lifecycle is taught as cezar_done, cezar_ask and cezar_wait calls; without them it is today's marker
+ * variant, `HANDOFF_ONLY_INSTRUCTIONS`. The marker lines are parsed in
+ * both cases. With `handoffInjected` the launch's opening message already carries the file
+ * (hearsay-tools/cezarion#1584), so step 1 points there instead of asking for a read; the
+ * writing duties never change.
  */
-export declare const HANDOFF_ONLY_INSTRUCTIONS = "## Handoff (cezar)\n\nCEZ_HANDOFF_FILE (env) is the absolute path to this task's rolling handoff file. Treat it like a HANDOFF.md:\n1. At the start of work, read it \u2014 \"Resume notes\" left by a previous session is your starting context.\n2. After every meaningful milestone (passing tests, a commit, a PR, a scope decision), append one terse timestamped line under \"## Progress log\", newest at the top.\n3. Before finishing or pausing, update \"## Resume notes\" with what's done, what's next and any blockers. Leave it empty only when the task is truly complete.\n\nTask completion marker: when the task's goal is fully achieved and you have no question for the user, end your final message with a line containing exactly CEZ:DONE \u2014 cez then closes the session and marks the task finished. If you are waiting on the user (a question, a decision, missing input), just end your message normally; the session stays open for their reply. Never emit CEZ:DONE while anything is unfinished or unverified.\n\nStill-working marker: if you end a turn while still working on your OWN downstream work \u2014 a sub-agent you dispatched, or a long-running command you're monitoring \u2014 and are NOT waiting on the user for anything, end your final message with a line containing exactly CEZ:MONITORING. cez then shows the task as \"monitoring\" (still working) instead of asking for your attention. Use CEZ:MONITORING only for that in-progress case; use CEZ:DONE when the goal is done; end plainly (no marker) only when you are genuinely waiting on the user. When the watched work is finished and the task goal is complete, end your final message with CEZ:DONE. If the watched work is still pending, end with CEZ:MONITORING. Never yield markerless for a monitoring wrap-up. A genuine question for the user still follows the question paths above and below. Never combine CEZ:MONITORING with CEZ:DONE.\n\nStructured question marker: when you are blocked on a decision that is genuinely the user's to make \u2014 one you cannot resolve from the request, the code, or sensible defaults \u2014 and it comes down to a few concrete choices, end your turn with a single line CEZ:ASK <json> instead of asking in prose. cez renders it as clickable option chips in the cockpit so the user can answer in one tap. The <json> is ONE object on ONE line, the last thing in your message: {\"questions\":[{\"header\":\"\u226412-char label\",\"question\":\"a clear question ending in ?\",\"multiSelect\":false,\"options\":[{\"label\":\"short choice\",\"description\":\"what it means / the trade-off\"}]}]} \u2014 use only those keys (plus an optional non-empty \"id\" up to 64 characters), with 1\u20134 questions, 2\u20134 options per question, unique question text and option labels, header 1\u201312 characters, question 1\u2013400, option label 1\u201360, and description at most 280. The JSON must be syntactically valid \u2014 every brace and bracket closed, no trailing commas; re-read the line before you send it, because a payload cez cannot parse is shown to the user as raw JSON instead of chips. The user can always type a free-form reply, so never add an \"Other\" option. Prefer sensible defaults over asking; use CEZ:ASK only when the choice is truly the user's. Never combine CEZ:ASK with CEZ:DONE or CEZ:MONITORING.\n\nTask reference markers: as soon as you know which GitHub pull request or issue this task is ABOUT (it was named in the task, or you just opened it), declare it by emitting, on its own line in your message text: CEZ:PR=<number> and/or CEZ:ISSUE=<number>. Re-emit with the new number if the subject changes (e.g. you open a PR later in the task). Declare only the task's own subject \u2014 never a PR/issue you merely mention, list, or compare against. You may also emit CEZ:TITLE=<terse gerund phrase, max 40 chars, e.g. \"implementing comment threads\"> once the work has a clearer shape than its current title; cez uses these instead of guessing from the transcript. Put markers in plain message text, never inside a code fence.\n\n## Pasted attachments\nUser-attached screenshots and files (PDF, TXT, MD) are saved as real files; their absolute paths are listed in the message that carries them. Read a file from its path when you need its contents, and use the path when a task needs the file itself (saving, uploading, attaching to issues/PRs). An image also rides along inline, but that copy is for viewing only; a non-image attachment exists ONLY as the file at that path.";
-export declare const FOLLOWUP_INSTRUCTIONS = "## Follow-ups (cezar)\n\nCEZ_TODOS_FILE (env) is the absolute path to the user's follow-up inbox \u2014 a JSON array. Only append an entry when a genuinely actionable follow-up remains: something concrete a human or the next agent still needs to decide or do (a review nit worth a dedicated pass, a manual step you cannot take yourself, a decision blocked on the user, a known next task). Do NOT append filler \u2014 a restated summary of what you just finished, a congratulatory note, or \"no further action needed\" is not a follow-up; when the task is simply done, skip this file entirely. When (and only when) a real follow-up exists, read the file (treat a missing file as []), append ONE object and write the whole array back:\n{ \"ts\": \"<ISO 8601>\", \"taskId\": \"<value of CEZ_TASK_ID>\", \"summary\": \"<one sentence: the concrete next action, not a status report>\", \"action\": \"<imperative user action, optional>\", \"prUrl\": \"<optional>\", \"suggestedSkill\": \"<optional skill name for the follow-up>\", \"suggestedArgs\": \"<optional>\", \"suggestedPrompt\": \"<optional freeform prompt for the follow-up task>\", \"runnable\": <true when an agent can execute this follow-up, false when it is a note> }\nSet \"runnable\": false for anything a human must do or merely read \u2014 manual QA, \"remember to\u2026\", informational notes \u2014 and leave out suggestedSkill/suggestedPrompt for those; the inbox then offers \"Acknowledge\" instead of \"Run\". Set \"runnable\": true only when suggestedSkill or suggestedPrompt says what to actually execute.\nNever modify or remove existing entries \u2014 append only.";
-/** Default-on combined contract retained for old callers and runs. */
-export declare const HANDOFF_INSTRUCTIONS = "## Handoff (cezar)\n\nCEZ_HANDOFF_FILE (env) is the absolute path to this task's rolling handoff file. Treat it like a HANDOFF.md:\n1. At the start of work, read it \u2014 \"Resume notes\" left by a previous session is your starting context.\n2. After every meaningful milestone (passing tests, a commit, a PR, a scope decision), append one terse timestamped line under \"## Progress log\", newest at the top.\n3. Before finishing or pausing, update \"## Resume notes\" with what's done, what's next and any blockers. Leave it empty only when the task is truly complete.\n\nTask completion marker: when the task's goal is fully achieved and you have no question for the user, end your final message with a line containing exactly CEZ:DONE \u2014 cez then closes the session and marks the task finished. If you are waiting on the user (a question, a decision, missing input), just end your message normally; the session stays open for their reply. Never emit CEZ:DONE while anything is unfinished or unverified.\n\nStill-working marker: if you end a turn while still working on your OWN downstream work \u2014 a sub-agent you dispatched, or a long-running command you're monitoring \u2014 and are NOT waiting on the user for anything, end your final message with a line containing exactly CEZ:MONITORING. cez then shows the task as \"monitoring\" (still working) instead of asking for your attention. Use CEZ:MONITORING only for that in-progress case; use CEZ:DONE when the goal is done; end plainly (no marker) only when you are genuinely waiting on the user. When the watched work is finished and the task goal is complete, end your final message with CEZ:DONE. If the watched work is still pending, end with CEZ:MONITORING. Never yield markerless for a monitoring wrap-up. A genuine question for the user still follows the question paths above and below. Never combine CEZ:MONITORING with CEZ:DONE.\n\nStructured question marker: when you are blocked on a decision that is genuinely the user's to make \u2014 one you cannot resolve from the request, the code, or sensible defaults \u2014 and it comes down to a few concrete choices, end your turn with a single line CEZ:ASK <json> instead of asking in prose. cez renders it as clickable option chips in the cockpit so the user can answer in one tap. The <json> is ONE object on ONE line, the last thing in your message: {\"questions\":[{\"header\":\"\u226412-char label\",\"question\":\"a clear question ending in ?\",\"multiSelect\":false,\"options\":[{\"label\":\"short choice\",\"description\":\"what it means / the trade-off\"}]}]} \u2014 use only those keys (plus an optional non-empty \"id\" up to 64 characters), with 1\u20134 questions, 2\u20134 options per question, unique question text and option labels, header 1\u201312 characters, question 1\u2013400, option label 1\u201360, and description at most 280. The JSON must be syntactically valid \u2014 every brace and bracket closed, no trailing commas; re-read the line before you send it, because a payload cez cannot parse is shown to the user as raw JSON instead of chips. The user can always type a free-form reply, so never add an \"Other\" option. Prefer sensible defaults over asking; use CEZ:ASK only when the choice is truly the user's. Never combine CEZ:ASK with CEZ:DONE or CEZ:MONITORING.\n\nTask reference markers: as soon as you know which GitHub pull request or issue this task is ABOUT (it was named in the task, or you just opened it), declare it by emitting, on its own line in your message text: CEZ:PR=<number> and/or CEZ:ISSUE=<number>. Re-emit with the new number if the subject changes (e.g. you open a PR later in the task). Declare only the task's own subject \u2014 never a PR/issue you merely mention, list, or compare against. You may also emit CEZ:TITLE=<terse gerund phrase, max 40 chars, e.g. \"implementing comment threads\"> once the work has a clearer shape than its current title; cez uses these instead of guessing from the transcript. Put markers in plain message text, never inside a code fence.\n\n## Pasted attachments\nUser-attached screenshots and files (PDF, TXT, MD) are saved as real files; their absolute paths are listed in the message that carries them. Read a file from its path when you need its contents, and use the path when a task needs the file itself (saving, uploading, attaching to issues/PRs). An image also rides along inline, but that copy is for viewing only; a non-image attachment exists ONLY as the file at that path.\n\n## Follow-ups (cezar)\n\nCEZ_TODOS_FILE (env) is the absolute path to the user's follow-up inbox \u2014 a JSON array. Only append an entry when a genuinely actionable follow-up remains: something concrete a human or the next agent still needs to decide or do (a review nit worth a dedicated pass, a manual step you cannot take yourself, a decision blocked on the user, a known next task). Do NOT append filler \u2014 a restated summary of what you just finished, a congratulatory note, or \"no further action needed\" is not a follow-up; when the task is simply done, skip this file entirely. When (and only when) a real follow-up exists, read the file (treat a missing file as []), append ONE object and write the whole array back:\n{ \"ts\": \"<ISO 8601>\", \"taskId\": \"<value of CEZ_TASK_ID>\", \"summary\": \"<one sentence: the concrete next action, not a status report>\", \"action\": \"<imperative user action, optional>\", \"prUrl\": \"<optional>\", \"suggestedSkill\": \"<optional skill name for the follow-up>\", \"suggestedArgs\": \"<optional>\", \"suggestedPrompt\": \"<optional freeform prompt for the follow-up task>\", \"runnable\": <true when an agent can execute this follow-up, false when it is a note> }\nSet \"runnable\": false for anything a human must do or merely read \u2014 manual QA, \"remember to\u2026\", informational notes \u2014 and leave out suggestedSkill/suggestedPrompt for those; the inbox then offers \"Acknowledge\" instead of \"Run\". Set \"runnable\": true only when suggestedSkill or suggestedPrompt says what to actually execute.\nNever modify or remove existing entries \u2014 append only.";
+export declare function handoffInstructions(opts: {
+    tools: boolean;
+    handoffInjected?: boolean;
+}): string;
+export {};

package/dist/handoff.js

@@ -1,12 +1,17 @@
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
+import { exactLineIndex, HANDOFF_AUTOSAVE_RECORDS_MAX, nextLineIndex } from './contract/index.js';
 /**
  * Per-task handoff journal (spec 007): `.ai/cezar/runs/<runId>.handoff.md`,
  * next to the run's NDJSON events and outside the task worktree — it survives
- * worktree removal. Cez seeds the skeleton and appends heartbeats; the agent
- * (told via CEZ_HANDOFF_FILE + the system-prompt fragment below) keeps the
- * "Progress log" and "Resume notes" sections up to date. Everything here is
- * best-effort: the handoff is a journal, never a reason to fail a run.
+ * worktree removal. Cez seeds the skeleton; the agent (told via
+ * CEZ_HANDOFF_FILE + the system-prompt fragment below) keeps the "Progress log"
+ * and "Resume notes" sections up to date. cezar's own records, the autosave
+ * reports, live in the run store (`RunRecord.handoffRecords`) and reach the file
+ * as ONE block that cezar rewrites whole (hearsay-tools/cezarion#1809), so cezar
+ * never edits a line the agent writes. cezar writes no lifecycle line: the run
+ * event log and the run status hold those facts. Everything here is best-effort:
+ * the handoff is a journal, never a reason to fail a run.
  */
 export function handoffPath(dataDir, runId) {
     return join(dataDir, 'runs', `${runId}.handoff.md`);
@@ -34,27 +39,52 @@ export function seedHandoffFile(dataDir, run) {
     }
     return file;
 }
+const RECORDS_BEGIN = '<!-- cezar:records — cezar rewrites this block whole from its run store; edits here are replaced -->';
+const RECORDS_END = '<!-- /cezar:records -->';
+/** The block that shows `records`, or '' when there is nothing to show. */
+function recordsBlock(records) {
+    const autosave = records?.autosave ?? [];
+    if (autosave.length === 0)
+        return '';
+    const lines = autosave.map((record) => `- ${record.at} — ${record.note}`);
+    return [RECORDS_BEGIN, '## Cezar records', '', '### Autosave', '', ...lines, RECORDS_END, ''].join('\n');
+}
 /**
- * Cez's own heartbeat (the janitor pattern): insert `- <ISO ts> — <note>`
- * right under the `## Progress log` header (newest at the top), so the file
- * stays current even when the agent forgets to write. Missing header →
- * append at the end of the file; missing file → no-op.
+ * `text` with its records block replaced by the one for `records` (hearsay-tools/cezarion#1809).
+ * The block runs from the first begin-marker line through the first end-marker line after it; a
+ * begin marker with no end marker is that one line. Without a block, a new one goes right before
+ * the seeded `## Goal` line, or at the start. No other part of `text` is read or changed, and an
+ * empty `text` (no file) stays empty.
  */
-export function appendHandoffHeartbeat(dataDir, runId, note) {
+export function renderHandoffRecords(text, records) {
+    if (!text)
+        return text;
+    const block = recordsBlock(records);
+    const begin = exactLineIndex(text, RECORDS_BEGIN);
+    if (begin >= 0) {
+        const body = nextLineIndex(text, begin);
+        const end = exactLineIndex(text.slice(body), RECORDS_END);
+        const after = end < 0 ? body : nextLineIndex(text, body + end);
+        return `${text.slice(0, begin)}${block}${text.slice(after)}`;
+    }
+    if (!block)
+        return text;
+    const at = Math.max(exactLineIndex(text, '## Goal'), 0);
+    return `${text.slice(0, at)}${block}\n${text.slice(at)}`;
+}
+/** Show `records` in the run's handoff file. Missing file → no-op: seeding is `seedHandoffFile`'s job. */
+function writeHandoffRecords(dataDir, runId, records) {
     const file = handoffPath(dataDir, runId);
     let text;
     try {
         text = readFileSync(file, 'utf8');
     }
     catch {
-        return; // not seeded — nothing to heartbeat
+        return;
     }
-    const line = `- ${new Date().toISOString()} — ${note}\n`;
-    const marker = '## Progress log\n';
-    const idx = text.indexOf(marker);
-    const next = idx >= 0
-        ? `${text.slice(0, idx + marker.length)}\n${line}${text.slice(idx + marker.length).replace(/^\n+/, '')}`
-        : `${text}${text.endsWith('\n') || text === '' ? '' : '\n'}${line}`;
+    const next = renderHandoffRecords(text, records);
+    if (next === text)
+        return;
     try {
         writeFileSync(file, next, 'utf8');
     }
@@ -62,37 +92,73 @@ export function appendHandoffHeartbeat(dataDir, runId, note) {
         // best effort
     }
 }
-/** Full handoff markdown, or '' when the file doesn't exist (yet). */
-export function readHandoff(dataDir, runId) {
+/** Show the store's records in the file again. Every session launch does, so its opening message
+ *  carries them after a crash, an agent edit, or a deleted block or file. */
+export function refreshHandoffRecords(store, dataDir, runId) {
+    let records;
     try {
-        return readFileSync(handoffPath(dataDir, runId), 'utf8');
+        records = store.getRun(runId)?.handoffRecords;
     }
     catch {
-        return '';
+        return; // a closed store: the next launch shows them
+    }
+    writeHandoffRecords(dataDir, runId, records);
+}
+/**
+ * Keep `next(current)` as the run's autosave records, newest first. `updateRun` commits a
+ * `handoffRecords` patch at once and throws when the store refuses it; the file shows the records
+ * only after that commit, so it never shows one that a crash would lose.
+ */
+function recordAutosave(store, dataDir, runId, next) {
+    try {
+        const run = store.getRun(runId);
+        if (!run)
+            return;
+        const autosave = next(run.handoffRecords?.autosave ?? []).slice(0, HANDOFF_AUTOSAVE_RECORDS_MAX);
+        writeHandoffRecords(dataDir, runId, store.updateRun(runId, { handoffRecords: { autosave } })?.handoffRecords);
     }
+    catch {
+        // The handoff is a journal, never a reason to fail; an uncommitted record stays out of the file.
+    }
+}
+/** Cez's autosave report (hearsay-tools/cezarion#1004): a commit or a skip, newest first. The
+ *  block shows it, never the Progress log, whose lines are the agent's own. */
+export function recordHandoffAutosave(store, dataDir, runId, note) {
+    recordAutosave(store, dataDir, runId, (current) => [{ at: new Date().toISOString(), note }, ...current]);
+}
+const SHA_UNAVAILABLE = '(sha unavailable)';
+function periodicAutosaveNote({ count, branch, first, latest }) {
+    return `periodic: ${count} cezar autosave commit(s) on ${branch ?? 'detached HEAD'}, first ${first ?? SHA_UNAVAILABLE}, latest ${latest ?? SHA_UNAVAILABLE}; ` +
+        `to fold the latest into your own commits while it is HEAD, run \`git reset --soft ${latest ?? 'HEAD'}~1\``;
 }
 /**
- * First few non-empty lines under "## Progress log" (spec 010 — the variant
- * comparison columns). Stops at the next `## ` header; '' when there's no
- * Progress log section or it's empty.
+ * The periodic timer's commit (hearsay-tools/cezarion#1004): a clean closing flush reports
+ * nothing, so the timer reports its own commits, as ONE record per run of consecutive periodic
+ * commits on one branch — a record every 90 s would bury the block. When the newest record is a
+ * periodic one for `commit.branch`, it is replaced with the count + 1, its first sha, this sha as
+ * the latest and a new time; any other newest record gets a new one above it. The merge reads the
+ * record's fields, never the file, so an agent edit cannot restart the count. `sha: null` is a
+ * commit whose hash could not be read back; `branch: null` is a detached HEAD.
  */
-export function handoffProgressExcerpt(text, maxLines = 3) {
-    const marker = '## Progress log';
-    const idx = text.indexOf(marker);
-    if (idx < 0)
+export function recordHandoffPeriodicAutosave(store, dataDir, runId, commit) {
+    recordAutosave(store, dataDir, runId, (current) => {
+        const [newest, ...older] = current;
+        const run = newest?.periodic && newest.periodic.branch === commit.branch ? newest.periodic : undefined;
+        const periodic = run
+            ? { ...run, count: run.count + 1, latest: commit.sha }
+            : { branch: commit.branch, count: 1, first: commit.sha, latest: commit.sha };
+        const record = { at: new Date().toISOString(), note: periodicAutosaveNote(periodic), periodic };
+        return run ? [record, ...older] : [record, ...current];
+    });
+}
+/** Full handoff markdown, or '' when the file doesn't exist (yet). */
+export function readHandoff(dataDir, runId) {
+    try {
+        return readFileSync(handoffPath(dataDir, runId), 'utf8');
+    }
+    catch {
         return '';
-    const lines = [];
-    for (const line of text.slice(idx + marker.length).split('\n')) {
-        if (line.startsWith('## '))
-            break;
-        const trimmed = line.trim();
-        if (!trimmed)
-            continue;
-        lines.push(trimmed);
-        if (lines.length >= maxLines)
-            break;
     }
-    return lines.join('\n');
 }
 export function deleteHandoff(dataDir, runId) {
     try {
@@ -102,53 +168,39 @@ export function deleteHandoff(dataDir, runId) {
         // best effort
     }
 }
-/**
- * Is the global follow-up inbox on? (#471)
- *
- * Opt-in, off by default: agents kept hanging on stale, pre-saved follow-ups,
- * which made skill behavior unpredictable. This is the single source of truth —
- * `resolveCapabilities` reports it to the UI and `RunManager` enforces it on
- * every run, so the HTTP route, the `cezar run` CLI and the inbox's own "▶ Run"
- * cannot drift apart. The per-task handoff journal is a separate feature and is
- * never gated by this.
- *
- * An exact `'1'` opts in — the house spelling (`AGENTS.md`: "opt-in behind a
- * `CEZ_*` flag, off by default").
- */
-export function followupsEnabled(env = process.env) {
-    return env.CEZ_FOLLOWUPS === '1';
-}
-/**
- * Appended to every agent step's `--append-system-prompt` (spec 007). The
- * matching handoff/task env vars are set on every agent process;
- * CEZ_TODOS_FILE carries a usable path only when follow-up generation is
- * enabled (#444, #471) — opted-out runs get it empty, never absent, so an
- * inherited value from a parent cezar cannot shine through
- * (`RunManager.agentEnv`).
- */
-export const HANDOFF_ONLY_INSTRUCTIONS = `## Handoff (cezar)
+const HANDOFF_AUTOSAVE_NOTE = `The "Cezar records" block near the top, when present, is cezar's record of autosave commits on your branch (with the command that folds one back) or of work it left uncommitted; cezar rewrites the whole block, so never edit it.`;
+const HANDOFF_READ_STEP = `1. At the start of work, read it — "Resume notes" left by a previous session is your starting context. ${HANDOFF_AUTOSAVE_NOTE}`;
+/** Step 1 when the launch's opening message already carries the file (hearsay-tools/cezarion#1584). */
+const HANDOFF_INJECTED_STEP = `1. Its contents as of this launch open your first message for this session, in the cezar context block with id "handoff"; read the file again only when you need a later version. "Resume notes" left by a previous session is your starting context. ${HANDOFF_AUTOSAVE_NOTE}`;
+const handoffJournal = (injected) => `## Handoff (cezar)
 
 CEZ_HANDOFF_FILE (env) is the absolute path to this task's rolling handoff file. Treat it like a HANDOFF.md:
-1. At the start of work, read it — "Resume notes" left by a previous session is your starting context.
+${injected ? HANDOFF_INJECTED_STEP : HANDOFF_READ_STEP}
 2. After every meaningful milestone (passing tests, a commit, a PR, a scope decision), append one terse timestamped line under "## Progress log", newest at the top.
-3. Before finishing or pausing, update "## Resume notes" with what's done, what's next and any blockers. Leave it empty only when the task is truly complete.
-
-Task completion marker: when the task's goal is fully achieved and you have no question for the user, end your final message with a line containing exactly CEZ:DONE — cez then closes the session and marks the task finished. If you are waiting on the user (a question, a decision, missing input), just end your message normally; the session stays open for their reply. Never emit CEZ:DONE while anything is unfinished or unverified.
+3. Before finishing or pausing, update "## Resume notes" with what's done, what's next and any blockers. Leave it empty only when the task is truly complete.`;
+/** The lifecycle markers a session without cezar tools ends its turns with. */
+const LIFECYCLE_MARKERS = `Task completion marker: when the task's goal is fully achieved and you have no question for the user, end your final message with a line containing exactly CEZ:DONE — cez then closes the session and marks the task finished. If you are waiting on the user (a question, a decision, missing input), just end your message normally; the session stays open for their reply. Never emit CEZ:DONE while anything is unfinished or unverified.
 
 Still-working marker: if you end a turn while still working on your OWN downstream work — a sub-agent you dispatched, or a long-running command you're monitoring — and are NOT waiting on the user for anything, end your final message with a line containing exactly CEZ:MONITORING. cez then shows the task as "monitoring" (still working) instead of asking for your attention. Use CEZ:MONITORING only for that in-progress case; use CEZ:DONE when the goal is done; end plainly (no marker) only when you are genuinely waiting on the user. When the watched work is finished and the task goal is complete, end your final message with CEZ:DONE. If the watched work is still pending, end with CEZ:MONITORING. Never yield markerless for a monitoring wrap-up. A genuine question for the user still follows the question paths above and below. Never combine CEZ:MONITORING with CEZ:DONE.
 
-Structured question marker: when you are blocked on a decision that is genuinely the user's to make — one you cannot resolve from the request, the code, or sensible defaults — and it comes down to a few concrete choices, end your turn with a single line CEZ:ASK <json> instead of asking in prose. cez renders it as clickable option chips in the cockpit so the user can answer in one tap. The <json> is ONE object on ONE line, the last thing in your message: {"questions":[{"header":"≤12-char label","question":"a clear question ending in ?","multiSelect":false,"options":[{"label":"short choice","description":"what it means / the trade-off"}]}]} — use only those keys (plus an optional non-empty "id" up to 64 characters), with 1–4 questions, 2–4 options per question, unique question text and option labels, header 1–12 characters, question 1–400, option label 1–60, and description at most 280. The JSON must be syntactically valid — every brace and bracket closed, no trailing commas; re-read the line before you send it, because a payload cez cannot parse is shown to the user as raw JSON instead of chips. The user can always type a free-form reply, so never add an "Other" option. Prefer sensible defaults over asking; use CEZ:ASK only when the choice is truly the user's. Never combine CEZ:ASK with CEZ:DONE or CEZ:MONITORING.
-
-Task reference markers: as soon as you know which GitHub pull request or issue this task is ABOUT (it was named in the task, or you just opened it), declare it by emitting, on its own line in your message text: CEZ:PR=<number> and/or CEZ:ISSUE=<number>. Re-emit with the new number if the subject changes (e.g. you open a PR later in the task). Declare only the task's own subject — never a PR/issue you merely mention, list, or compare against. You may also emit CEZ:TITLE=<terse gerund phrase, max 40 chars, e.g. "implementing comment threads"> once the work has a clearer shape than its current title; cez uses these instead of guessing from the transcript. Put markers in plain message text, never inside a code fence.
+Structured question marker: when you are blocked on a decision that is genuinely the user's to make — one you cannot resolve from the request, the code, or sensible defaults — and it comes down to a few concrete choices, end your turn with a single line CEZ:ASK <json> instead of asking in prose. Before the CEZ:ASK line, send everything the decision depends on (the full draft, every finding, what each option means) as ordinary text in the same message. The user sees only your message text and the chips. Your reasoning never reaches them, so never call content "above" unless you sent it as message text. cez renders it as clickable option chips in the cockpit so the user can answer in one tap. The <json> is ONE object on ONE line, the last thing in your message: {"questions":[{"header":"≤12-char label","question":"a clear question ending in ?","multiSelect":false,"options":[{"label":"short choice","description":"what it means / the trade-off"}]}]} — use only those keys (plus an optional non-empty "id" up to 64 characters per question, plus an optional "context" of up to 20000 characters of Markdown shown above the chips), with 1–4 questions, 2–4 options per question, unique question text and option labels, header 1–12 characters, question 1–400, option label 1–60, and description at most 280. The JSON must be syntactically valid — every brace and bracket closed, no trailing commas; re-read the line before you send it, because a payload cez cannot parse is shown to the user as raw JSON instead of chips. The user can always type a free-form reply, so never add an "Other" option. Prefer sensible defaults over asking; use CEZ:ASK only when the choice is truly the user's. Never combine CEZ:ASK with CEZ:DONE or CEZ:MONITORING.`;
+/** hearsay-tools/cezarion#1234: the same lifecycle as tool calls, for a session that has them. */
+const LIFECYCLE_TOOLS = `Lifecycle tools (cezar): End every turn with a cezar tool call that says what happens next. When the goal is fully achieved and verified and you have no question for the user, call cezar_done, then end your turn. When a user decision or missing input is needed, call cezar_ask with the complete decision context and short questions. Put the full draft, findings, evidence and option meanings in context. Cezar shows context as Markdown above the card. Reasoning and rejected calls are hidden. Give a question 2–4 options to show them as choices, or leave its options out and the user types the answer. Once the call accepts the context and questions, end the turn and wait for the user. When you are waiting on something else, call cezar_wait with kind "pr" for a pull request's checks or its merge, or kind "timer" to re-check later, then end your turn. A human message or any resolved wait wakes you. The user's reply answers your question; PR waits and timers stay open until they resolve or you cancel them with cezar_cancel_wait. Never call cezar_done while anything is unfinished or unverified.`;
+const REFERENCES_AND_ATTACHMENTS = `Task reference markers: as soon as you know which GitHub pull request or issue this task is ABOUT (it was named in the task, or you just opened it), declare it by emitting, on its own line in your message text: CEZ:PR=<number> and/or CEZ:ISSUE=<number>. Declare each PR this task opens, even when it opens several. Earlier declarations remain associated with the task; the last declaration selects the current subject. For issues, an issue directly identified as the task subject in its prompt remains the primary attribution; later issue declarations and discovered links do not replace it. Re-emit with the new number if the subject changes (e.g. you open a PR later in the task). Declare only the task's own subject — never a PR/issue you merely mention, list, or compare against. You may also emit CEZ:TITLE=<terse gerund phrase, max 40 chars, e.g. "implementing comment threads"> once the work has a clearer shape than its current title; cez uses these instead of guessing from the transcript. Put markers in plain message text, never inside a code fence.
 
 ## Pasted attachments
 User-attached screenshots and files (PDF, TXT, MD) are saved as real files; their absolute paths are listed in the message that carries them. Read a file from its path when you need its contents, and use the path when a task needs the file itself (saving, uploading, attaching to issues/PRs). An image also rides along inline, but that copy is for viewing only; a non-image attachment exists ONLY as the file at that path.`;
-export const FOLLOWUP_INSTRUCTIONS = `## Follow-ups (cezar)
-
-CEZ_TODOS_FILE (env) is the absolute path to the user's follow-up inbox — a JSON array. Only append an entry when a genuinely actionable follow-up remains: something concrete a human or the next agent still needs to decide or do (a review nit worth a dedicated pass, a manual step you cannot take yourself, a decision blocked on the user, a known next task). Do NOT append filler — a restated summary of what you just finished, a congratulatory note, or "no further action needed" is not a follow-up; when the task is simply done, skip this file entirely. When (and only when) a real follow-up exists, read the file (treat a missing file as []), append ONE object and write the whole array back:
-{ "ts": "<ISO 8601>", "taskId": "<value of CEZ_TASK_ID>", "summary": "<one sentence: the concrete next action, not a status report>", "action": "<imperative user action, optional>", "prUrl": "<optional>", "suggestedSkill": "<optional skill name for the follow-up>", "suggestedArgs": "<optional>", "suggestedPrompt": "<optional freeform prompt for the follow-up task>", "runnable": <true when an agent can execute this follow-up, false when it is a note> }
-Set "runnable": false for anything a human must do or merely read — manual QA, "remember to…", informational notes — and leave out suggestedSkill/suggestedPrompt for those; the inbox then offers "Acknowledge" instead of "Run". Set "runnable": true only when suggestedSkill or suggestedPrompt says what to actually execute.
-Never modify or remove existing entries — append only.`;
-/** Default-on combined contract retained for old callers and runs. */
-export const HANDOFF_INSTRUCTIONS = `${HANDOFF_ONLY_INSTRUCTIONS}\n\n${FOLLOWUP_INSTRUCTIONS}`;
+/** The rolling handoff journal and lifecycle guidance for sessions without cezar tools. */
+export const HANDOFF_ONLY_INSTRUCTIONS = `${handoffJournal(false)}\n\n${LIFECYCLE_MARKERS}\n\n${REFERENCES_AND_ATTACHMENTS}`;
+/**
+ * The handoff contract for one agent session. With `tools` (the session has cezar's tools) the
+ * lifecycle is taught as cezar_done, cezar_ask and cezar_wait calls; without them it is today's marker
+ * variant, `HANDOFF_ONLY_INSTRUCTIONS`. The marker lines are parsed in
+ * both cases. With `handoffInjected` the launch's opening message already carries the file
+ * (hearsay-tools/cezarion#1584), so step 1 points there instead of asking for a read; the
+ * writing duties never change.
+ */
+export function handoffInstructions(opts) {
+    return `${handoffJournal(opts.handoffInjected ?? false)}\n\n${opts.tools ? LIFECYCLE_TOOLS : LIFECYCLE_MARKERS}\n\n${REFERENCES_AND_ATTACHMENTS}`;
+}
 //# sourceMappingURL=handoff.js.map

package/dist/handoff.js.map

@@ -1 +1 @@
-{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../src/handoff.ts"],"names":[],"mappings":"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"}