Function writeHandoff

orchestrate/skills/orchestrate/scripts/core/handoff.ts:166–196

(args: {
  handoffsDir: string;
  task: TaskState;
  body: string;
  resultStatus: string;
  finishedAt: string;
})

}

export function writeHandoff(args: {
  handoffsDir: string;
  task: TaskState;
  body: string;
  resultStatus: string;
  finishedAt: string;
}): string {
  const s = args.task;
  const path = join(args.handoffsDir, `${s.name}.md`);
  const header = `<!-- orchestrate handoff
task: ${s.name}
branch: ${s.branch}
agentId: ${s.agentId}
runId: ${s.runId}
resultStatus: ${args.resultStatus}
finishedAt: ${args.finishedAt}
-->\n\n`;
  // Non-"finished" runs don't produce the structured template; flag it so
  // downstream readers don't mis-parse the raw narrative.
  const banner =
    args.resultStatus === "finished"
      ? ""
      : `> ⚠️ Run ended with \`status=${args.resultStatus}\`. No structured handoff produced — the content below is the worker's raw output up to the point of failure.\n\n`;
  const tmp = `${path}.tmp`;
  writeFileSync(
    tmp,
    header + banner + (args.body || "_(empty final message)_\n")
  );
  renameSync(tmp, path);
  return path;
}

export function emptyErrorHandoffBody(args: {
  task: TaskState;