The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""Detached owners must not lose the checkout their session still uses."""
from pathlib import Path
import subprocess
import sys
import pytest
def _pending_turn(db_path, sid, status='queued'):
"""An accepted turn the gateway still owes this session: quitting the viewer keeps its tree (N8)."""
import sqlite3
conn = sqlite3.connect(db_path)
try:
conn.execute(
"INSERT INTO session_admissions(admission_id,request_id,principal_id,target_session_id,lineage_json,"
"payload_json,payload_digest,intent,status,outcome,owner_epoch,generation) "
"VALUES(?,?,'p',?,'[]','{}','d','queue',?,NULL,1,1)", (f'adm-{sid}', f'req-{sid}', sid, status))
conn.commit()
finally:
conn.close()
def _finish_turns(db_path):
import sqlite3
conn = sqlite3.connect(db_path)
try:
conn.execute("UPDATE session_admissions SET status='terminal', outcome='completed'")
conn.commit()
finally:
conn.close()
@pytest.mark.parametrize('resumable', [True, False])
def test_retained_tui_worktree_survives_stale_prune_while_its_session_resumes(tmp_path, monkeypatch, resumable):
"""The launch lock names the exiting launcher's pid; once it is gone a later launch's 24 h
prune must still keep a clean retained tree whose session can be resumed (and only then)."""
import json
import os
import time
from hermes_cli import main_tui_launch
from hermes_cli.worktree_ops import _prune_stale_worktrees, _setup_worktree
from hermes_constants import get_hermes_home
from hermes_state import SessionDB
repo = tmp_path / 'repo'
git = ['git', '-c', 'user.name=Test', '-c', '[email protected]']
subprocess.run(['git', 'init', '-q', '-b', 'main', str(repo)], check=True)
(repo / '.gitignore').write_text('.worktrees/\n')
subprocess.run([*git, '-C', str(repo), 'add', '.gitignore'], check=True)
subprocess.run([*git, '-C', str(repo), 'commit', '-qm', 'fixture'], check=True)
monkeypatch.chdir(repo)
monkeypatch.setenv('HERMES_PYTHON', sys.executable)
wt_info = _setup_worktree(str(repo), sync_base=False)
# The real launcher exits with the TUI, so its `hermes pid=<pid>` launch lock is dead by the next launch.
subprocess.run(['git', '-C', str(repo), 'worktree', 'unlock', wt_info['path']], check=True)
subprocess.run(['git', '-C', str(repo), 'worktree', 'lock', '--reason', 'hermes pid=999999999',
wt_info['path']], check=True)
monkeypatch.setattr(main_tui_launch, '_setup_tui_worktree', lambda: wt_info)
monkeypatch.setattr(main_tui_launch, '_make_tui_argv', lambda *_: (['node'], Path('.')))
monkeypatch.setattr(main_tui_launch, '_print_tui_exit_summary', lambda *_: None)
def ink(_argv, cwd=None, env=None):
db = SessionDB(db_path=get_hermes_home() / 'state.db')
db.create_session('tui-wt', 'tui', cwd=env['HERMES_TUI_CWD'])
if resumable:
db.append_message('tui-wt', 'user', 'keep my checkout')
db.close()
_pending_turn(get_hermes_home() / 'state.db', 'tui-wt')
Path(env['HERMES_TUI_ACTIVE_SESSION_FILE']).write_text(json.dumps({'session_id': 'tui-wt'}))
ink.checkout = Path(env['HERMES_TUI_CWD'])
return 0
monkeypatch.setattr(main_tui_launch.subprocess, 'call', ink)
with pytest.raises(SystemExit):
main_tui_launch._launch_tui(worktree=True)
# The turn finished and the launcher is gone; the next launch runs its prune a day later.
_finish_turns(get_hermes_home() / 'state.db')
old = time.time() - 25 * 3600
os.utime(ink.checkout, (old, old))
_prune_stale_worktrees(str(repo))
assert ink.checkout.is_dir() is resumable
@pytest.mark.parametrize('case', ['quoted_home', 'after_new', 'terminal_closed'])
def test_retained_tui_worktree_kept_while_any_session_in_it_resumes(tmp_path, monkeypatch, case):
"""N5: liveness comes from the store, for every way the lock used to read as dead — a home
git C-quotes (non-ASCII / quote / backslash, every Windows path), ``/new`` leaving the older
session's history behind the named empty one, and a launcher killed with its terminal
(SIGHUP skips the exit re-lock)."""
import json
import os
import re
import time
from hermes_cli import main_tui_launch, worktree_ops
from hermes_constants import get_hermes_home
from hermes_state import SessionDB
home = tmp_path / ('Zoë "q" \\ home' if case == 'quoted_home' else 'home')
home.mkdir()
monkeypatch.setenv('HERMES_HOME', str(home))
repo = tmp_path / 'repo'
git = ['git', '-c', 'user.name=Test', '-c', '[email protected]']
subprocess.run(['git', 'init', '-q', '-b', 'main', str(repo)], check=True)
(repo / '.gitignore').write_text('.worktrees/\n')
subprocess.run([*git, '-C', str(repo), 'add', '.gitignore'], check=True)
subprocess.run([*git, '-C', str(repo), 'commit', '-qm', 'fixture'], check=True)
monkeypatch.chdir(repo)
monkeypatch.setenv('HERMES_PYTHON', sys.executable)
monkeypatch.setattr(main_tui_launch, '_make_tui_argv', lambda *_: (['node'], Path('.')))
monkeypatch.setattr(main_tui_launch, '_print_tui_exit_summary', lambda *_: None)
if case == 'terminal_closed':
monkeypatch.setattr(worktree_ops, '_retain_worktree_for_session', lambda *_: False)
def ink(_argv, cwd=None, env=None):
db = SessionDB(db_path=get_hermes_home() / 'state.db')
db.create_session('tui-a', 'tui', cwd=env['HERMES_TUI_CWD'])
db.append_message('tui-a', 'user', 'keep my checkout')
attached = 'tui-a'
if case == 'after_new': # /new: the attached session has nothing sent yet
db.create_session(attached := 'tui-b', 'tui', cwd=env['HERMES_TUI_CWD'])
db.close()
_pending_turn(get_hermes_home() / 'state.db', attached)
Path(env['HERMES_TUI_ACTIVE_SESSION_FILE']).write_text(json.dumps({'session_id': attached}))
ink.checkout = Path(env['HERMES_TUI_CWD'])
return 0
monkeypatch.setattr(main_tui_launch.subprocess, 'call', ink)
with pytest.raises(SystemExit):
main_tui_launch._launch_tui(worktree=True)
listing = subprocess.run(['git', '-C', str(repo), 'worktree', 'list', '--porcelain', '-z'],
capture_output=True, text=True, check=True).stdout
reason = next(f[len('locked '):] for f in listing.split('\0') if f.startswith('locked '))
# The launcher process is gone by the next launch, whichever lock it left.
subprocess.run(['git', '-C', str(repo), 'worktree', 'unlock', str(ink.checkout)], check=True)
subprocess.run(['git', '-C', str(repo), 'worktree', 'lock', '--reason',
re.sub(r'pid=\d+', 'pid=999999999', reason), str(ink.checkout)], check=True)
_finish_turns(get_hermes_home() / 'state.db')
old = time.time() - 25 * 3600
os.utime(ink.checkout, (old, old))
worktree_ops._prune_stale_worktrees(str(repo))
assert ink.checkout.is_dir()