The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Prompt assembly with native Windows paths, through real Hermes processes.
* Subdirectory hints: after a terminal command touches ``backend\\src``, the tool result the
model receives carries ``backend/AGENTS.md`` — for the forward-slash spelling AND the
native backslash spelling a model emits on Windows (#121150).
* AGENTS.md chain: ``hermes chat -q`` launched in ``pkg\\inner`` of a git repo loads all
three AGENTS.md files and labels them ``../../AGENTS.md`` / ``../AGENTS.md`` / ``AGENTS.md``
— one spelling on every OS (#121015).
* ``@folder:`` references through the TUI gateway (the Ink TUI's process): the listing
header injected into the user message is ``pkg/sub/``, matching its own ``/`` directory
marker and entry lines, not ``pkg\\sub/`` (#121114).
"""
from __future__ import annotations
import subprocess
from pathlib import Path
import pytest
from tests.e2e.core._pending_fixes import known_gate
from tests.e2e.core.windows._helpers import (
KnownBugSymptom,
expect,
hermes,
last_user,
make_home,
nonce,
system_prompt,
tool_results,
)
from tests.e2e.core.windows._rpc import StdioGateway
from tests.fakes.fake_llm_provider import FakeLLMServer, Text, ToolCall
pytestmark = [pytest.mark.platforms("windows"), pytest.mark.integration]
# key -> (the bug's own failure signature, "#issue reason"); see _pending_fixes.known_failure.
KNOWN: dict[str, tuple[str, str]] = {
"native-backslash": (r"^native-backslash: backend/AGENTS\.md never reached the model after ",
"#121150 subdirectory hints never load from native Windows paths (POSIX shlex)"),
"chain_labels": (r"^AGENTS\.md chain headings are not the portable spelling: \[.*\\",
"#121015 AGENTS.md chain labels use os.path.relpath separators (..\\AGENTS.md)"),
"folder_header": (r"^@folder header lines: \['pkg\\+sub/'\]",
"#121114 @folder listing header mixes separators on Windows (pkg\\sub/)"),
}
# spelling -> terminal command the model issues (the issue's own repro commands)
HINT_COMMANDS: dict[str, str] = {
"forward-slash": "python backend/src/main.py",
"native-backslash": "python backend\\src\\main.py",
}
@pytest.mark.parametrize("spelling", list(HINT_COMMANDS))
def test_subdirectory_hint_reaches_model(spelling: str, tmp_path: Path) -> None:
canary = nonce("BACKEND-RULES")
with FakeLLMServer([ToolCall("terminal", {"command": HINT_COMMANDS[spelling]}), Text("done")]) as srv:
home = make_home(tmp_path, srv.base_url)
(home.project / "backend" / "src").mkdir(parents=True)
(home.project / "backend" / "src" / "main.py").write_text("print('hi')\n", encoding="utf-8")
(home.project / "backend" / "AGENTS.md").write_text(f"# Backend\n\n{canary}\n", encoding="utf-8")
res = hermes(home, "chat", "-q", "Run the backend entry point.", "-Q")
assert res.returncode == 0, res.tail()
results = tool_results(srv)
assert len(results) == 1, f"expected one terminal result on the wire, got {results}"
with known_gate(KNOWN, spelling, raises=KnownBugSymptom):
expect(canary in results[0],
f"{spelling}: backend/AGENTS.md never reached the model after {HINT_COMMANDS[spelling]!r}:\n"
f"{results[0][-1500:]}")
def test_agents_chain_labels_are_os_independent(tmp_path: Path) -> None:
canaries = {name: nonce(name.upper()) for name in ("root", "pkg", "inner")}
with FakeLLMServer([Text("done")]) as srv:
home = make_home(tmp_path, srv.base_url)
repo = home.project
subprocess.run(["git", "init", "-q", str(repo)], check=True, timeout=60)
inner = repo / "pkg" / "inner"
inner.mkdir(parents=True)
for directory, name in ((repo, "root"), (repo / "pkg", "pkg"), (inner, "inner")):
(directory / "AGENTS.md").write_text(f"# {name}\n\n{canaries[name]}\n", encoding="utf-8")
res = hermes(home, "chat", "-q", "hello", "-Q", cwd=inner)
assert res.returncode == 0, res.tail()
prompt = system_prompt(srv.main_requests()[0])
missing = [name for name, c in canaries.items() if c not in prompt]
assert not missing, f"AGENTS.md chain members missing from the system prompt: {missing}"
headings = [line[3:] for line in prompt.splitlines() if line.startswith("## ") and "AGENTS.md" in line]
with known_gate(KNOWN, "chain_labels", raises=KnownBugSymptom):
expect(headings == ["../../AGENTS.md", "../AGENTS.md", "AGENTS.md"],
f"AGENTS.md chain headings are not the portable spelling: {headings}")
def test_folder_reference_header_uses_one_separator(tmp_path: Path) -> None:
body = nonce("FOLDER-FILE")
with FakeLLMServer([Text("done")]) as srv:
home = make_home(tmp_path, srv.base_url)
nested = home.project / "pkg" / "sub"
nested.mkdir(parents=True)
(nested / "a.py").write_text(f"# {body}\nx = 1\n", encoding="utf-8")
gw = StdioGateway(home)
try:
gw.turn("Review @folder:pkg/sub")
finally:
gw.close()
user = last_user(srv.main_requests()[0])
assert "- a.py" in user, f"@folder listing never reached the model:\n{user[-2000:]}"
# The header is the one non-entry line naming the folder; entries are "- name" lines.
header = [ln.strip() for ln in user.splitlines() if ln.strip().endswith("sub/") and not ln.lstrip().startswith("-")]
with known_gate(KNOWN, "folder_header", raises=KnownBugSymptom):
expect(header == ["pkg/sub/"], f"@folder header lines: {header}\n{user[-1500:]}")