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

tests/hermes_cli/test_update_modified_notice.py

@@ -0,0 +1,60 @@
+"""Guard: every `hermes update` path that reports user-modified skills must
+also tell the user how to find them.
+
+`hermes update` keeps (does not overwrite) bundled skills the user edited and
+prints a ``~ N user-modified (kept)`` count. There are two independent update
+code paths in ``hermes_cli/main.py`` that print this notice (the git-pull path
+in ``_cmd_update_impl`` and the unpack/install path). Both must point the user
+at ``hermes skills list-modified`` so the count is actionable — otherwise,
+depending on which path a user hits, they may never learn the discovery command
+exists.
+
+This is an *invariant* test (the two sibling notices must agree), not a literal
+snapshot: it asserts the relationship "count line ⇒ discovery hint", so it
+keeps holding if the wording is reworded, as long as both sites stay in sync.
+"""
+
+import re
+from pathlib import Path
+
+import hermes_cli.main as main_mod
+import hermes_cli.update_cmd as update_mod
+
+
+_COUNT_RE = re.compile(r"user-modified \(kept\)")
+_HINT_RE = re.compile(r"hermes skills list-modified")
+
+
+def _source_lines() -> list[str]:
+    # The update pipeline was extracted to hermes_cli/update_cmd.py
+    # (main.py decomposition); scan both homes of the notice.
+    return [
+        line
+        for mod in (main_mod, update_mod)
+        for line in Path(mod.__file__).read_text(encoding="utf-8").splitlines()
+    ]
+
+
+def test_every_user_modified_notice_points_at_list_modified():
+    lines = _source_lines()
+    count_sites = [i for i, ln in enumerate(lines) if _COUNT_RE.search(ln)]
+
+    # The notice must exist somewhere (guard against it being deleted outright),
+    # but we deliberately do NOT assert a fixed *count* of sites: consolidating
+    # the duplicated print paths into a shared helper is a welcome refactor and
+    # must not fail this test. The invariant is per-site, not how many sites.
+    assert count_sites, (
+        "no 'user-modified (kept)' notice found in main.py — the update "
+        "summary that surfaces kept user edits appears to have been removed"
+    )
+
+    for idx in count_sites:
+        # The count print and its discovery hint sit on adjacent lines; allow a
+        # small window so wording/formatting tweaks don't break the check.
+        window = "\n".join(lines[idx : idx + 5])
+        assert _HINT_RE.search(window), (
+            "a 'user-modified (kept)' notice near line "
+            f"{idx + 1} of main.py does not point users at "
+            "`hermes skills list-modified` within the following lines — the "
+            "update paths have drifted apart again:\n" + window
+        )