Function build_turn_message

atomic-agent/src/record/message.rs:27–63

Build the change message for a turn. Message priority: 1. If the prompt is meaningful (not a slash command, not too short), use it directly — the user's intent is the best commit message. 2. Generate a descriptive message from the actual file changes (e.g., "Add CLAUDE.md" or "Modify auth.rs; add test_auth.rs"). 3. Extract a wrap-up summary from the agent's transcript — but ONLY text that appears

(
    options: &TurnRecordOptions<'_>,
    status: &RepositoryStatus,
    untracked_paths: &[String],
)

/// in the SessionEnvelope metadata and `atomic log` can render it from there.
/// The change message should describe *what changed*, not bookkeeping.
pub(crate) fn build_turn_message(
    options: &TurnRecordOptions<'_>,
    status: &RepositoryStatus,
    untracked_paths: &[String],
) -> String {
    // Priority 1: If we have a meaningful prompt, use it directly.
    // The user typed something like "Fix the auth bug" — that's the best
    // description of intent. Slash commands (/init, /help) are filtered out.
    if let Some(prompt) = &options.prompt {
        if is_meaningful_prompt(prompt) {
            return truncate_prompt(prompt, 72);
        }
    }

    // Priority 2: Generate a message from the actual file changes.
    // This is always accurate and concrete: "Add CLAUDE.md" or
    // "Modify auth.rs; add test_auth.rs, utils.rs (+3 more)".
    let file_summary = build_file_change_summary(status, untracked_paths);
    if !file_summary.is_empty() {
        return truncate_prompt(&file_summary, 72);
    }

    // Priority 3: Try the transcript as a last resort.
    // Only use assistant text that appears AFTER the last tool call —
    // that's Claude's wrap-up summary, not its opening analysis/planning.
    if let Some(ref transcript_path) = options.session.transcript_path {
        if let Some(summary) = summarize_from_transcript(transcript_path) {
            return truncate_prompt(&summary, 72);
        }
    }

    // Priority 4: Last resort
    format!(
        "Turn {} ({})",
        options.turn_number, options.session.agent_display_name
    )
}

/// Extract a one-line commit message from the agent's transcript file.
///