Something went wrong. Try again.
personal memory agent
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431# SPDX-License-Identifier: AGPL-3.0-only# Copyright (c) 2026 sol pbc
import jsonimport osimport timefrom pathlib import Pathfrom types import SimpleNamespace
import pytest
from solstone.think import sync_check
@pytest.fixture(autouse=True)def isolated_journal(tmp_path, monkeypatch): journal = tmp_path / "journal" monkeypatch.setenv("SOLSTONE_JOURNAL", str(journal)) return journal
def _reset_machine_id(monkeypatch): monkeypatch.setattr(sync_check, "_MACHINE_ID", None)
def _set_identity(monkeypatch, *, machine_id="self-machine-1234", hostname="self-host"): monkeypatch.setattr(sync_check, "get_machine_id", lambda: machine_id) monkeypatch.setattr(sync_check, "get_self_hostname_sanitized", lambda: hostname) monkeypatch.setattr(sync_check, "_solstone_version", lambda: "test-version")
def _write_foreign( journal: Path, name: str = "other-host", *, mtime: float | None = None, payload: dict | None = None, raw: bytes | None = None,) -> Path: sync_dir = journal / "health" / "sync" sync_dir.mkdir(parents=True, exist_ok=True) path = sync_dir / f"{name}.check" if raw is not None: path.write_bytes(raw) else: data = { "schema": sync_check.SCHEMA_VERSION, "machine_id": f"{name}-machine", "hostname": name, "pid": 123, "wall_time": "2026-05-11T00:00:00Z", "solstone_version": "1.2.3", "journal_path": "/foreign/journal", } if payload is not None: data = payload path.write_text(json.dumps(data) + "\n", encoding="utf-8") if mtime is not None: os.utime(path, (mtime, mtime)) return path
def test_get_machine_id_linux_reads_machine_id(monkeypatch): _reset_machine_id(monkeypatch) monkeypatch.setattr(sync_check.sys, "platform", "linux")
def fake_read_text(self, encoding="utf-8"): if str(self) == "/etc/machine-id": return "linux-machine\n" raise OSError
monkeypatch.setattr(Path, "read_text", fake_read_text)
assert sync_check.get_machine_id() == "linux-machine"
def test_get_machine_id_darwin_reads_ioplatform_uuid(monkeypatch): _reset_machine_id(monkeypatch) monkeypatch.setattr(sync_check.sys, "platform", "darwin")
def fake_run(*args, **kwargs): return SimpleNamespace(stdout='"IOPlatformUUID" = "ABC-123"\n')
monkeypatch.setattr(sync_check.subprocess, "run", fake_run)
assert sync_check.get_machine_id() == "ABC-123"
def test_get_machine_id_returns_empty_when_unavailable(monkeypatch): _reset_machine_id(monkeypatch) monkeypatch.setattr(sync_check.sys, "platform", "linux")
def fake_read_text(self, encoding="utf-8"): raise OSError
monkeypatch.setattr(Path, "read_text", fake_read_text)
assert sync_check.get_machine_id() == ""
_reset_machine_id(monkeypatch) monkeypatch.setattr(sync_check.sys, "platform", "darwin")
def fake_run(*args, **kwargs): return SimpleNamespace(stdout="")
monkeypatch.setattr(sync_check.subprocess, "run", fake_run)
assert sync_check.get_machine_id() == ""
def test_get_self_hostname_sanitized_normal_weird_empty(monkeypatch): monkeypatch.setattr(sync_check.socket, "gethostname", lambda: "my-laptop") assert sync_check.get_self_hostname_sanitized() == "my-laptop"
monkeypatch.setattr(sync_check.socket, "gethostname", lambda: "My Laptop.local!") assert sync_check.get_self_hostname_sanitized() == "my-laptop-local"
monkeypatch.setattr(sync_check.socket, "gethostname", lambda: "") assert sync_check.get_self_hostname_sanitized() == "unknown-host"
def test_write_self_heartbeat_writes_expected_json_and_overwrites( tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch)
first = sync_check.write_self_heartbeat(journal=journal) second = sync_check.write_self_heartbeat(journal=journal)
assert first == second data = json.loads(second.read_text(encoding="utf-8")) assert data["schema"] == sync_check.SCHEMA_VERSION assert data["machine_id"] == "self-machine-1234" assert data["hostname"] == "self-host" assert data["pid"] == os.getpid() assert "boot" + "_id" not in data assert "monotonic" + "_ms" not in data assert data["solstone_version"] == "test-version" assert data["interval_seconds"] == sync_check.DEFAULT_INTERVAL_SECONDS assert data["journal_path"] == str(journal.resolve()) assert second.read_text(encoding="utf-8").endswith("\n")
def test_write_self_heartbeat_tolerates_empty_machine_id(isolated_journal, monkeypatch): monkeypatch.setattr(sync_check, "get_machine_id", lambda: "")
path = sync_check.write_self_heartbeat(journal=isolated_journal)
data = json.loads(path.read_text(encoding="utf-8")) assert data["machine_id"] == ""
def test_write_self_heartbeat_replace_failure_leaves_existing_file_intact( tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) path = sync_check.write_self_heartbeat(journal=journal) original = path.read_text(encoding="utf-8")
def fail_replace(src, dst): raise OSError("boom")
monkeypatch.setattr(sync_check.os, "replace", fail_replace)
with pytest.raises(OSError): sync_check.write_self_heartbeat(journal=journal)
assert path.read_text(encoding="utf-8") == original assert list(path.parent.glob(".tmp_*.check")) == []
def test_clear_self_heartbeat_removes_file_and_missing_is_noop(tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) path = sync_check.write_self_heartbeat(journal=journal)
sync_check.clear_self_heartbeat(journal=journal) assert not path.exists()
sync_check.clear_self_heartbeat(journal=journal)
def test_check_journal_sync_no_dir_empty_dir_only_self_are_clean(tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch)
result = sync_check.check_journal_sync(journal=journal, now=1000.0) assert not result.is_conflict assert result.foreign_writers == ()
(journal / "health" / "sync").mkdir(parents=True) result = sync_check.check_journal_sync(journal=journal, now=1000.0) assert not result.is_conflict assert result.foreign_writers == ()
sync_check.write_self_heartbeat(journal=journal) result = sync_check.check_journal_sync(journal=journal, now=time.time()) assert not result.is_conflict assert result.foreign_writers == ()
def test_check_journal_sync_tolerates_empty_machine_id(isolated_journal, monkeypatch): monkeypatch.setattr(sync_check, "get_machine_id", lambda: "") (isolated_journal / "health" / "sync").mkdir(parents=True)
result = sync_check.check_journal_sync(journal=isolated_journal, now=1000.0)
assert result.is_conflict is False assert isinstance(sync_check.format_doctor_report(result), str)
def test_check_journal_sync_fresh_foreign_is_live(tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) now = 1000.0 _write_foreign(journal, mtime=now - 5)
result = sync_check.check_journal_sync(journal=journal, now=now)
assert result.is_conflict assert result.primary_conflict is not None assert result.primary_conflict.hostname == "other-host"
def test_check_journal_sync_same_machine_multiple_filenames_skip(tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch, machine_id="abc-machine", hostname="newhost") now = 1000.0 for hostname in ("newhost", "oldhost"): _write_foreign( journal, hostname, payload={ "schema": sync_check.SCHEMA_VERSION, "machine_id": "abc-machine", "hostname": hostname, "pid": 123, "wall_time": "2026-05-11T00:00:00Z", "solstone_version": "1.2.3", "journal_path": "/self/journal", }, mtime=now - 5, )
result = sync_check.check_journal_sync(journal=journal, now=now)
assert result.is_conflict is False assert result.foreign_writers == ()
def test_check_journal_sync_same_machine_different_pids_skip(tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch, machine_id="abc-machine", hostname="host") now = 1000.0 for hostname, pid in (("host", 111), ("host-old", 222)): _write_foreign( journal, hostname, payload={ "schema": sync_check.SCHEMA_VERSION, "machine_id": "abc-machine", "hostname": hostname, "pid": pid, "wall_time": "2026-05-11T00:00:00Z", "solstone_version": "1.2.3", "journal_path": "/self/journal", }, mtime=now - 5, )
result = sync_check.check_journal_sync(journal=journal, now=now)
assert result.is_conflict is False assert result.foreign_writers == ()
def test_check_journal_sync_empty_machine_id_malformed_file_not_skipped( tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch, machine_id="", hostname="self") now = 1000.0 _write_foreign(journal, "weird-name", raw=b"{not json", mtime=now - 5)
result = sync_check.check_journal_sync(journal=journal, now=now)
assert len(result.foreign_writers) == 1 assert result.foreign_writers[0].path.name == "weird-name.check" assert result.foreign_writers[0].parse_error == "invalid JSON"
def test_check_journal_sync_stale_foreign_is_history_only(tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) now = 1000.0 _write_foreign(journal, mtime=now - 120)
result = sync_check.check_journal_sync(journal=journal, now=now)
assert not result.is_conflict assert len(result.history_foreign_writers) == 1
def test_check_journal_sync_new_stale_file_since_snapshot_is_live( tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) sync_dir = journal / "health" / "sync" sync_dir.mkdir(parents=True) now = 1000.0 previous = sync_check.check_journal_sync(journal=journal, now=now)
_write_foreign(journal, mtime=now - 120) result = sync_check.check_journal_sync( previous=previous.snapshot, journal=journal, now=now )
assert result.is_conflict assert result.live_foreign_writers[0].appeared_since_snapshot
def test_check_journal_sync_changed_mtime_and_sha_since_snapshot_is_live( tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) now = 1000.0 path = _write_foreign(journal, mtime=now - 120) previous = sync_check.check_journal_sync(journal=journal, now=now)
path.write_text( json.dumps( { "machine_id": "other-host-machine", "hostname": "other-host", "pid": 999, "journal_path": "/foreign/journal", } ) + "\n", encoding="utf-8", ) os.utime(path, (now - 119, now - 119)) result = sync_check.check_journal_sync( previous=previous.snapshot, journal=journal, now=now )
assert result.is_conflict assert result.live_foreign_writers[0].changed_since_snapshot
def test_check_journal_sync_missing_fields_tolerated_unknown_hostname( tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) now = 1000.0 _write_foreign(journal, payload={}, mtime=now - 5)
result = sync_check.check_journal_sync(journal=journal, now=now)
assert result.foreign_writers[0].display_hostname == "(unknown)"
def test_format_conflict_message_includes_resolution_guidance(tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) now = time.time() _write_foreign(journal, mtime=now - 5) result = sync_check.check_journal_sync(journal=journal, now=now)
message = sync_check.format_conflict_message(result)
assert "one service per journal" in message assert "Multiple observers" in message assert "stop solstone on" in message assert "other-host" in message
def test_format_conflict_message_multiple_foreign_lists_bullets(tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) now = time.time() _write_foreign(journal, "other-host", mtime=now - 5) _write_foreign(journal, "third-host", mtime=now - 10) result = sync_check.check_journal_sync(journal=journal, now=now)
message = sync_check.format_conflict_message(result)
assert "other-host" in message assert "third-host" in message assert "\n • " in message
def test_format_conflict_message_future_mtime_shows_in_the_future( tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) now = time.time() _write_foreign(journal, mtime=now + 600) result = sync_check.check_journal_sync(journal=journal, now=now)
message = sync_check.format_conflict_message(result)
assert "in the future" in message
def test_format_doctor_report_clean_history_live(tmp_path, monkeypatch): journal = tmp_path / "journal" _set_identity(monkeypatch) now = time.time()
clean = sync_check.check_journal_sync(journal=journal, now=now) assert sync_check.format_doctor_report(clean).startswith("this device only")
_write_foreign(journal, mtime=now - 120) history = sync_check.check_journal_sync(journal=journal, now=now) history_report = sync_check.format_doctor_report(history) assert "last foreign writer" in history_report assert "other-host" in history_report
_write_foreign(journal, "live-host", mtime=now - 5) live = sync_check.check_journal_sync(journal=journal, now=now) live_report = sync_check.format_doctor_report(live) assert "Refusing to start" in live_report assert "live-host" in live_report