"""A SessionStart that loads no project says why, and names the first move. A fetch written as `curl -f … || body=""` collapses a timeout, an HTTP error and a refused key into one sentence, and a fallback that suggests `enter_project()` "as needed" reads as optional. A session that skips it starts with no recent milestones or open tasks, and so has no way to know which prior work exists to look for. These pin both halves on the path that needs no server: the cause is named, and the fallback is a concrete first step. """ from __future__ import annotations import json import os import subprocess from pathlib import Path from tests.helpers import need_tools HOOK = Path(__file__).resolve().parents[1] / "plugin" / "hooks" / "grimoire_session_context.sh" def run_hook(tmp_path: Path, url: str, marker_project: int | None = None) -> str: need_tools("bash", "curl", "awk") if marker_project is not None: (tmp_path / ".grimoire").write_text(json.dumps({ "instance": url, "project_id": marker_project, "project": "P", })) env = {**os.environ, "GRIMOIRE_URL": url, "GRIMOIRE_TOKEN": "t", "CLAUDE_PROJECT_DIR": str(tmp_path)} r = subprocess.run(["bash", str(HOOK)], input=b'{"source":"startup"}', capture_output=True, env=env, timeout=60) assert r.returncode == 0, r.stderr.decode() return json.loads(r.stdout)["hookSpecificOutput"]["additionalContext"] # Port 9 (discard) on loopback: refused at once, so both tries fail fast. DEAD = "http://127.0.0.1:9" def test_an_unreachable_instance_is_named_as_one(tmp_path): out = run_hook(tmp_path, DEAD) assert "could not be reached (curl exit 7, after a retry)" in out def test_the_fallback_is_a_first_step_not_an_option(tmp_path): out = run_hook(tmp_path, DEAD) assert "as needed" not in out assert "Start by finding this repo's project" in out assert "before any other work" in out def test_a_marker_names_the_exact_call(tmp_path): out = run_hook(tmp_path, DEAD, marker_project=31) assert "Start by calling `enter_project(31)`" in out