Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

tests/hermes_cli/test_terminal_breadcrumbs.py

@@ -0,0 +1,204 @@
+"""Tests for hermes_cli/terminal_breadcrumbs.py — per-terminal ``hermes -c``.
+
+Covers terminal id derivation (tty vs env vars vs none), breadcrumb
+write/read roundtrip under a temp HERMES_HOME, stale-session fallback
+(breadcrumb pointing at a deleted session), compression-tip projection,
+and the session.terminal_continue config gate.
+"""
+
+import json
+import os
+import time
+from pathlib import Path
+
+import pytest
+
+from hermes_cli import terminal_breadcrumbs as tb
+
+
+TERMINAL_ENV_VARS = (
+    "ZELLIJ_PANE_ID",
+    "TMUX_PANE",
+    "KITTY_WINDOW_ID",
+    "WEZTERM_PANE",
+    "TERM_SESSION_ID",
+    "WT_SESSION",
+)
+
+
+@pytest.fixture
+def hermes_home(tmp_path, monkeypatch):
+    home = tmp_path / ".hermes"
+    home.mkdir()
+    monkeypatch.setenv("HERMES_HOME", str(home))
+    return home
+
+
+@pytest.fixture
+def no_terminal_env(monkeypatch):
+    """Strip every terminal-identity env var so tests control identity."""
+    for var in TERMINAL_ENV_VARS:
+        monkeypatch.delenv(var, raising=False)
+
+
+def _fake_no_tty(monkeypatch):
+    monkeypatch.setattr(tb.os, "ttyname", lambda fd: (_ for _ in ()).throw(OSError()))
+
+
+def _fake_tty(monkeypatch, name="/dev/pts/7"):
+    monkeypatch.setattr(tb.os, "ttyname", lambda fd: name)
+
+
+# ---------------------------------------------------------------- identity
+
+def test_terminal_id_prefers_tty(monkeypatch, no_terminal_env):
+    _fake_tty(monkeypatch, "/dev/pts/7")
+    monkeypatch.setenv("TMUX_PANE", "%3")
+    assert tb.get_terminal_id() == "tty-dev-pts-7"
+
+
+def test_terminal_id_env_var_order(monkeypatch, no_terminal_env):
+    _fake_no_tty(monkeypatch)
+    monkeypatch.setenv("KITTY_WINDOW_ID", "12")
+    monkeypatch.setenv("WT_SESSION", "abc-123")
+    # KITTY_WINDOW_ID comes before WT_SESSION in the preference order
+    assert tb.get_terminal_id() == "kitty_window_id-12"
+
+
+def test_terminal_id_sanitizes_env_value(monkeypatch, no_terminal_env):
+    _fake_no_tty(monkeypatch)
+    monkeypatch.setenv("TMUX_PANE", "%41")
+    tid = tb.get_terminal_id()
+    assert tid is not None
+    assert "/" not in tid and "%" not in tid
+
+
+def test_terminal_id_none_when_no_identity(monkeypatch, no_terminal_env):
+    _fake_no_tty(monkeypatch)
+    assert tb.get_terminal_id() is None
+
+
+# ---------------------------------------------------------- write / read
+
+def test_breadcrumb_roundtrip(hermes_home, monkeypatch, no_terminal_env):
+    _fake_tty(monkeypatch)
+    tb.write_breadcrumb("20260815_120000_abc123", cwd="/tmp/project")
+    crumb = tb.read_breadcrumb()
+    assert crumb is not None
+    assert crumb["session_id"] == "20260815_120000_abc123"
+    assert crumb["cwd"] == "/tmp/project"
+    assert isinstance(crumb["ts"], float)
+    files = list((hermes_home / "terminal-sessions").iterdir())
+    assert [f.name for f in files] == ["tty-dev-pts-7"]
+
+
+def test_write_skipped_without_terminal_identity(hermes_home, monkeypatch, no_terminal_env):
+    _fake_no_tty(monkeypatch)
+    tb.write_breadcrumb("20260815_120000_abc123")
+    assert not (hermes_home / "terminal-sessions").exists()
+    assert tb.read_breadcrumb() is None
+
+
+def test_two_terminals_do_not_clobber(hermes_home, monkeypatch, no_terminal_env):
+    _fake_tty(monkeypatch, "/dev/pts/1")
+    tb.write_breadcrumb("session-one")
+    _fake_tty(monkeypatch, "/dev/pts/2")
+    tb.write_breadcrumb("session-two")
+    assert tb.read_breadcrumb()["session_id"] == "session-two"
+    _fake_tty(monkeypatch, "/dev/pts/1")
+    assert tb.read_breadcrumb()["session_id"] == "session-one"
+
+
+def test_stale_breadcrumb_ignored_and_pruned(hermes_home, monkeypatch, no_terminal_env):
+    _fake_tty(monkeypatch, "/dev/pts/1")
+    directory = hermes_home / "terminal-sessions"
+    directory.mkdir(parents=True)
+    stale = directory / "tty-dev-pts-1"
+    stale.write_text(
+        json.dumps({"session_id": "old", "cwd": "/", "ts": time.time() - 40 * 86400})
+    )
+    old_mtime = time.time() - 40 * 86400
+    os.utime(stale, (old_mtime, old_mtime))
+    # read: stale payload rejected
+    assert tb.read_breadcrumb() is None
+    # write from another terminal prunes the stale file
+    _fake_tty(monkeypatch, "/dev/pts/2")
+    tb.write_breadcrumb("fresh")
+    assert not stale.exists()
+
+
+def test_corrupt_breadcrumb_returns_none(hermes_home, monkeypatch, no_terminal_env):
+    _fake_tty(monkeypatch, "/dev/pts/1")
+    directory = hermes_home / "terminal-sessions"
+    directory.mkdir(parents=True)
+    (directory / "tty-dev-pts-1").write_text("not json{")
+    assert tb.read_breadcrumb() is None
+
+
+# ------------------------------------------------------------- resolution
+
+def _make_session(home: Path, session_id: str):
+    from hermes_state import SessionDB
+
+    db = SessionDB()
+    db.create_session(session_id, "cli")
+    db.close()
+
+
+def test_resolve_picks_this_terminals_session(hermes_home, monkeypatch, no_terminal_env):
+    _fake_tty(monkeypatch, "/dev/pts/5")
+    _make_session(hermes_home, "20260815_100000_aaaaaa")
+    _make_session(hermes_home, "20260815_110000_bbbbbb")  # newer, other terminal
+    tb.write_breadcrumb("20260815_100000_aaaaaa")
+    assert tb.resolve_breadcrumb_session() == "20260815_100000_aaaaaa"
+
+
+def test_resolve_falls_back_when_session_deleted(hermes_home, monkeypatch, no_terminal_env):
+    _fake_tty(monkeypatch, "/dev/pts/5")
+    _make_session(hermes_home, "20260815_110000_bbbbbb")
+    tb.write_breadcrumb("20260815_100000_deleted")  # never existed / deleted
+    assert tb.resolve_breadcrumb_session() is None
+
+
+def test_resolve_projects_through_compression_chain(hermes_home, monkeypatch, no_terminal_env):
+    _fake_tty(monkeypatch, "/dev/pts/5")
+    _make_session(hermes_home, "20260815_100000_parent")
+    tb.write_breadcrumb("20260815_100000_parent")
+
+    from hermes_state import SessionDB
+
+    monkeypatch.setattr(
+        SessionDB,
+        "get_compression_tip",
+        lambda self, sid: "20260815_110000_child",
+    )
+    assert tb.resolve_breadcrumb_session() == "20260815_110000_child"
+
+
+# ------------------------------------------------------------ config gate
+
+def test_config_gate_off_disables_writes_and_resolution(
+    hermes_home, monkeypatch, no_terminal_env
+):
+    _fake_tty(monkeypatch, "/dev/pts/9")
+    import hermes_cli.config as config_mod
+
+    monkeypatch.setattr(
+        config_mod, "load_config", lambda: {"session": {"terminal_continue": False}}
+    )
+    tb.write_breadcrumb("20260815_120000_abc123")
+    assert not (hermes_home / "terminal-sessions").exists()
+    # Even with a pre-existing breadcrumb, resolution must decline
+    monkeypatch.setattr(config_mod, "load_config", lambda: {})
+    tb.write_breadcrumb("20260815_120000_abc123")
+    monkeypatch.setattr(
+        config_mod, "load_config", lambda: {"session": {"terminal_continue": False}}
+    )
+    assert tb.resolve_breadcrumb_session() is None
+
+
+def test_config_gate_default_is_enabled(monkeypatch):
+    import hermes_cli.config as config_mod
+
+    monkeypatch.setattr(config_mod, "load_config", lambda: {})
+    assert tb.is_enabled() is True