"""Default SOUL.md template seeded into HERMES_HOME on first run."""

# Kept identical to agent/prompt_builder.py's DEFAULT_AGENT_IDENTITY (#95681,
# maintainer-directed rewrite) -- this is the text virtually every real user
# actually gets, since _ensure_default_soul_md() seeds it into SOUL.md on
# first run. DEFAULT_AGENT_IDENTITY only serves sessions with no SOUL.md at
# all (e.g. skip_context_files), which is not the common case. The old
# "targeted and efficient exploration" line is deliberately absent -- see the
# comment on DEFAULT_AGENT_IDENTITY for why -- never re-add it here either.
DEFAULT_SOUL_MD = (
    "You are Hermes Agent, built by Nous Research. Be direct: match the "
    "length of your reply to the weight of the ask — a one-line question "
    "gets a one-line answer, and finished work gets a short report of what "
    "changed, what's verified, and what's left, never a replay of the "
    "process. No filler (\"Great question,\" \"I'd be happy to\"), no "
    "restating the request back, no re-summarizing what you already said, "
    "no narrating tool calls the user can see. Plain claims over "
    "adjectives; when unsure, say so plainly. Agree because it's right, "
    "not because the user said it. Depth is earned — give it when the "
    "user asks for detail, teaches, or the stakes demand it, not by "
    "default."
)

# Legacy SOUL.md boilerplate that older installers (install.sh / install.ps1 /
# docker/SOUL.md) seeded before they were switched to write DEFAULT_SOUL_MD.
# These templates contain no persona text -- they are pure comment scaffolding,
# so a SOUL.md whose content matches one of these was demonstrably never
# customized by the user and is safe to upgrade to DEFAULT_SOUL_MD in place.
#
# Match on normalized content (stripped, line-endings unified) so trailing
# newlines or CRLF from Windows installers don't defeat the comparison. NEVER
# add anything here that a user might have intentionally written -- the whole
# safety guarantee is that these strings carry zero user intent.
_LEGACY_TEMPLATE_SOULS = (
    (
        "# Hermes Agent Persona\n"
        "\n"
        "<!--\n"
        "This file defines the agent's personality and tone.\n"
        "The agent will embody whatever you write here.\n"
        "Edit this to customize how Hermes communicates with you.\n"
        "\n"
        "Examples:\n"
        '  - "You are a warm, playful assistant who uses kaomoji occasionally."\n'
        '  - "You are a concise technical expert. No fluff, just facts."\n'
        '  - "You speak like a friendly coworker who happens to know everything."\n'
        "\n"
        "This file is loaded fresh each message -- no restart needed.\n"
        "Delete the contents (or this file) to use the default personality.\n"
        "-->"
    ),
    # docker/SOUL.md and the install.sh heredoc differ only by an "Examples"
    # block / trailing newline in some historical revisions; the bare scaffold
    # (no Examples block) was also shipped briefly.
    (
        "# Hermes Agent Persona\n"
        "\n"
        "<!--\n"
        "This file defines the agent's personality and tone.\n"
        "The agent will embody whatever you write here.\n"
        "Edit this to customize how Hermes communicates with you.\n"
        "\n"
        "This file is loaded fresh each message -- no restart needed.\n"
        "Delete the contents (or this file) to use the default personality.\n"
        "-->"
    ),
    # The pre-#95681 DEFAULT_SOUL_MD text: every install between that text's
    # introduction and this fix got it auto-seeded on first run, so it also
    # carries zero user intent (it's the same auto-seed mechanism, just an
    # older generation of the same non-customized string) and is safe to
    # upgrade in place, same as the comment-only scaffolds above.
    (
        "You are Hermes Agent, an intelligent AI assistant created by Nous "
        "Research. You are helpful, knowledgeable, and direct. You assist "
        "users with a wide range of tasks including answering questions, "
        "writing and editing code, analyzing information, creative work, "
        "and executing actions via your tools. You communicate clearly, "
        "admit uncertainty when appropriate, and prioritize being "
        "genuinely useful over being verbose unless otherwise directed "
        "below. Be targeted and efficient in your exploration and "
        "investigations."
    ),
    # ASCII-dashed variant of the current DEFAULT_SOUL_MD, as seeded by
    # scripts/install.ps1 (which must stay pure ASCII -- see
    # tests/test_install_ps1_ascii_only.py -- so it writes "--" where the
    # canonical text has an em-dash). Still pure auto-seed, zero user intent;
    # upgrading it in place converges Windows installs onto the canonical
    # em-dash text on first run.
    DEFAULT_SOUL_MD.replace("\u2014", "--"),
)


def _normalize_soul(text: str) -> str:
    """Normalize SOUL.md content for legacy-template comparison."""
    # Unify line endings (Windows installer writes CRLF-free but be defensive),
    # strip a leading UTF-8 BOM, and trim surrounding whitespace.
    return text.replace("\r\n", "\n").replace("\r", "\n").lstrip("\ufeff").strip()


def is_legacy_template_soul(text: str) -> bool:
    """True if ``text`` is a non-customized, auto-seeded SOUL.md.

    Covers two generations of non-user-authored content: older installers'
    comment-only scaffold (which shadowed the runtime default and left users
    with no persona), and the pre-#95681 generation of DEFAULT_SOUL_MD itself
    (auto-seeded, never edited). A file matching one of those known strings
    carries zero user intent and is safe to upgrade in place. Any deviation
    (the user typed a persona, even one character outside the comment) makes
    this return False.
    """
    normalized = _normalize_soul(text)
    return any(normalized == _normalize_soul(t) for t in _LEGACY_TEMPLATE_SOULS)