elliot-stack 1.0.39 → 1.0.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/package.json +1 -1
  2. package/skills/estack-migrate-claude-session-history/SKILL.md +3 -2
  3. package/skills/estack-migrate-claude-session-history/scripts/__pycache__/validate-migration.cpython-313.pyc +0 -0
  4. package/skills/estack-read-claude-session-history/SKILL.md +34 -3
  5. package/skills/estack-read-claude-session-history/references/modes.md +53 -7
  6. package/skills/estack-read-claude-session-history/references/recipes.md +7 -1
  7. package/skills/estack-read-claude-session-history/scripts/__pycache__/read_transcript.cpython-313.pyc +0 -0
  8. package/skills/estack-read-claude-session-history/scripts/lib/__pycache__/__init__.cpython-313.pyc +0 -0
  9. package/skills/estack-read-claude-session-history/scripts/lib/__pycache__/parser.cpython-313.pyc +0 -0
  10. package/skills/estack-read-claude-session-history/scripts/lib/__pycache__/paths.cpython-313.pyc +0 -0
  11. package/skills/estack-read-claude-session-history/scripts/lib/__pycache__/search.cpython-313.pyc +0 -0
  12. package/skills/estack-read-claude-session-history/scripts/lib/__pycache__/subagents.cpython-313.pyc +0 -0
  13. package/skills/estack-read-claude-session-history/scripts/lib/__pycache__/tools.cpython-313.pyc +0 -0
  14. package/skills/estack-read-claude-session-history/scripts/read_transcript.py +163 -20
  15. package/skills/estack-migrate-claude-session-history/scripts/test-append-note.js +0 -48
  16. package/skills/estack-migrate-claude-session-history/scripts/test-validate-migration.py +0 -326
  17. package/skills/estack-read-claude-session-history/scripts/tests/conftest.py +0 -40
  18. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/README.md +0 -20
  19. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/all-noise.jsonl +0 -4
  20. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/basic-session.jsonl +0 -2
  21. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-gaps.jsonl +0 -9
  22. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-noise.jsonl +0 -7
  23. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-parallel-a.jsonl +0 -3
  24. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-parallel-b.jsonl +0 -3
  25. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/engagement-waiting.jsonl +0 -5
  26. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/interrupted.jsonl +0 -2
  27. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/multi-compact.jsonl +0 -8
  28. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/pending-user.jsonl +0 -2
  29. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-no-meta/subagents/agent-aaa.jsonl +0 -2
  30. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-no-meta.jsonl +0 -2
  31. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-parent/subagents/agent-xyz123.jsonl +0 -2
  32. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-parent/subagents/agent-xyz123.meta.json +0 -1
  33. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/subagent-parent.jsonl +0 -4
  34. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/time-spread.jsonl +0 -6
  35. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/timeline-day-test.jsonl +0 -5
  36. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/tool-usage-parent/subagents/agent-sub1.jsonl +0 -3
  37. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/tool-usage-parent.jsonl +0 -3
  38. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/tool-zoo.jsonl +0 -10
  39. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/truncated.jsonl +0 -3
  40. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/unicode.jsonl +0 -2
  41. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/with-advisor.jsonl +0 -3
  42. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/with-compact.jsonl +0 -5
  43. package/skills/estack-read-claude-session-history/scripts/tests/fixtures/with-thinking.jsonl +0 -2
  44. package/skills/estack-read-claude-session-history/scripts/tests/test_backup_roots.py +0 -56
  45. package/skills/estack-read-claude-session-history/scripts/tests/test_engagement.py +0 -239
  46. package/skills/estack-read-claude-session-history/scripts/tests/test_json_format.py +0 -201
  47. package/skills/estack-read-claude-session-history/scripts/tests/test_modes.py +0 -323
  48. package/skills/estack-read-claude-session-history/scripts/tests/test_parser.py +0 -204
  49. package/skills/estack-read-claude-session-history/scripts/tests/test_paths.py +0 -133
  50. package/skills/estack-read-claude-session-history/scripts/tests/test_search.py +0 -94
  51. package/skills/estack-read-claude-session-history/scripts/tests/test_search_output.py +0 -161
  52. package/skills/estack-read-claude-session-history/scripts/tests/test_subagents.py +0 -43
  53. package/skills/estack-read-claude-session-history/scripts/tests/test_timeline.py +0 -179
  54. package/skills/estack-read-claude-session-history/scripts/tests/test_timezone_and_project.py +0 -225
  55. package/skills/estack-read-claude-session-history/scripts/tests/test_tools.py +0 -80
@@ -1,225 +0,0 @@
1
- """Tests for timezone handling (set_timezone / --tz) and the --project filter."""
2
-
3
- import json
4
- import os
5
- import shutil
6
- import subprocess
7
- import sys
8
- from datetime import datetime
9
- from pathlib import Path
10
-
11
- import pytest
12
-
13
- from lib import parser as PR
14
- from lib import paths as P
15
-
16
-
17
- def _run_cli(cli_path, *args, env_overrides=None):
18
- env = dict(os.environ)
19
- env["PYTHONIOENCODING"] = "utf-8"
20
- if env_overrides:
21
- env.update(env_overrides)
22
- return subprocess.run(
23
- [sys.executable, str(cli_path), *args],
24
- capture_output=True,
25
- text=True,
26
- encoding="utf-8",
27
- env=env,
28
- )
29
-
30
-
31
- @pytest.fixture(autouse=True)
32
- def _reset_tz():
33
- yield
34
- PR.set_timezone(None)
35
-
36
-
37
- # ── set_timezone / _parse_timestamp ─────────────────────────────────────────
38
-
39
- def test_parse_timestamp_default_is_naive():
40
- dt = PR._parse_timestamp("2026-05-01T10:00:00Z")
41
- assert dt is not None
42
- assert dt.tzinfo is None
43
-
44
-
45
- def test_parse_timestamp_utc():
46
- PR.set_timezone("UTC")
47
- assert PR._parse_timestamp("2026-05-01T10:00:00Z") == datetime(2026, 5, 1, 10, 0)
48
-
49
-
50
- def test_parse_timestamp_offset():
51
- PR.set_timezone("+2")
52
- assert PR._parse_timestamp("2026-05-01T10:00:00Z") == datetime(2026, 5, 1, 12, 0)
53
-
54
-
55
- def test_parse_timestamp_utc_minus():
56
- PR.set_timezone("UTC-4")
57
- assert PR._parse_timestamp("2026-05-01T10:00:00Z") == datetime(2026, 5, 1, 6, 0)
58
-
59
-
60
- def test_set_timezone_half_hour_offset():
61
- PR.set_timezone("+05:30")
62
- assert PR._parse_timestamp("2026-05-01T10:00:00Z") == datetime(2026, 5, 1, 15, 30)
63
-
64
-
65
- def test_set_timezone_local_resets():
66
- PR.set_timezone("UTC")
67
- PR.set_timezone("local")
68
- assert PR._TARGET_TZ is None
69
-
70
-
71
- def test_set_timezone_iana():
72
- try:
73
- PR.set_timezone("America/New_York")
74
- except ValueError:
75
- pytest.skip("IANA tz database not available on this machine")
76
- dt = PR._parse_timestamp("2026-01-15T10:00:00Z") # EST = UTC-5
77
- assert dt == datetime(2026, 1, 15, 5, 0)
78
-
79
-
80
- def test_set_timezone_invalid_raises():
81
- with pytest.raises(ValueError):
82
- PR.set_timezone("Mars/Olympus_Mons")
83
-
84
-
85
- def test_epoch_to_display_utc():
86
- PR.set_timezone("UTC")
87
- # 2026-05-01T10:00:00Z as epoch
88
- epoch = datetime(2026, 5, 1, 10, 0).replace(
89
- tzinfo=__import__("datetime").timezone.utc
90
- ).timestamp()
91
- assert PR.epoch_to_display(epoch) == datetime(2026, 5, 1, 10, 0)
92
-
93
-
94
- def test_cli_tz_invalid(cli_path, fixtures_dir):
95
- r = _run_cli(
96
- cli_path, "--file", str(fixtures_dir / "basic-session.jsonl"),
97
- "--mode", "changelog", "--tz", "Nope/Nowhere",
98
- )
99
- assert r.returncode == 1
100
- assert "timezone" in r.stderr.lower()
101
-
102
-
103
- def test_display_to_epoch_roundtrip_offset_tz():
104
- PR.set_timezone("+2")
105
- epoch = 1772546400.0
106
- assert PR.display_to_epoch(PR.epoch_to_display(epoch)) == epoch
107
-
108
-
109
- def test_display_to_epoch_roundtrip_local():
110
- epoch = 1772546400.0
111
- assert PR.display_to_epoch(PR.epoch_to_display(epoch)) == epoch
112
-
113
-
114
- def test_now_display_matches_utc_clock():
115
- from datetime import timezone as _tzmod
116
- PR.set_timezone("UTC")
117
- delta = abs((PR.now_display() - datetime.now(_tzmod.utc).replace(tzinfo=None)).total_seconds())
118
- assert delta < 5
119
-
120
-
121
- def test_parse_timespec_now_respects_tz():
122
- from datetime import timezone as _tzmod
123
- PR.set_timezone("UTC")
124
- now_spec = P.parse_timespec("now")
125
- delta = abs((now_spec - datetime.now(_tzmod.utc).replace(tzinfo=None)).total_seconds())
126
- assert delta < 5
127
-
128
-
129
- def test_json_timestamps_are_display_tz(cli_path, fixtures_dir):
130
- # basic-session events are 10:00:0xZ — with +2 the JSON timestamps read 12:00
131
- r = _run_cli(
132
- cli_path, "--file", str(fixtures_dir / "basic-session.jsonl"),
133
- "--mode", "last", "--format", "json", "--tz", "+2",
134
- )
135
- assert r.returncode == 0
136
- data = json.loads(r.stdout)
137
- assert data[-1]["timestamp"].startswith("2026-05-01T12:00:05")
138
-
139
-
140
- def test_cli_changelog_respects_tz(cli_path, fixtures_dir):
141
- # tool-zoo events are 10:00:0xZ — with +3 they display as 13:00
142
- r = _run_cli(
143
- cli_path, "--file", str(fixtures_dir / "tool-zoo.jsonl"),
144
- "--mode", "changelog", "--tz", "+3",
145
- )
146
- assert r.returncode == 0
147
- assert "13:00:01" in r.stdout
148
-
149
-
150
- # ── --project filter ─────────────────────────────────────────────────────────
151
-
152
- @pytest.fixture
153
- def multi_root(fixtures_dir, tmp_path):
154
- root = tmp_path / "projects"
155
- keel = root / "C--Users-x-Keel-Project"
156
- other = root / "C--Users-x-Other-Claude-Code"
157
- keel.mkdir(parents=True)
158
- other.mkdir(parents=True)
159
- shutil.copy(fixtures_dir / "basic-session.jsonl", keel / "keelsession.jsonl")
160
- shutil.copy(fixtures_dir / "tool-zoo.jsonl", other / "othersession.jsonl")
161
- return root
162
-
163
-
164
- def test_filter_projects_substring(multi_root):
165
- dirs = P.filter_projects(multi_root, "keel")
166
- assert len(dirs) == 1
167
- assert "Keel" in dirs[0].name
168
-
169
-
170
- def test_filter_projects_spaces_match_hyphens(multi_root):
171
- dirs = P.filter_projects(multi_root, "Keel Project")
172
- assert len(dirs) == 1
173
-
174
-
175
- def test_filter_projects_no_match(multi_root):
176
- assert P.filter_projects(multi_root, "zzz") == []
177
-
178
-
179
- def test_cli_list_project_filter(cli_path, multi_root):
180
- r = _run_cli(
181
- cli_path, "--root", str(multi_root), "--mode", "list", "--project", "keel",
182
- )
183
- assert r.returncode == 0
184
- assert "keelsess" in r.stdout
185
- assert "othersess" not in r.stdout
186
-
187
-
188
- def test_cli_search_project_filter(cli_path, multi_root):
189
- # Wide scope summarizes by default: the session shows as its uuid8 prefix,
190
- # and the off-project session must not appear.
191
- r = _run_cli(
192
- cli_path, "--root", str(multi_root), "--mode", "search",
193
- "--query", "help", "--project", "keel",
194
- )
195
- assert r.returncode == 0
196
- assert "keelsess" in r.stdout
197
- assert "othersess" not in r.stdout
198
-
199
-
200
- def test_cli_search_project_filter_full(cli_path, multi_root):
201
- # --full expands to match windows, which include the full session filename.
202
- r = _run_cli(
203
- cli_path, "--root", str(multi_root), "--mode", "search",
204
- "--query", "help", "--project", "keel", "--full",
205
- )
206
- assert r.returncode == 0
207
- assert "keelsession" in r.stdout
208
-
209
-
210
- def test_cli_journal_project_filter_json(cli_path, multi_root):
211
- r = _run_cli(
212
- cli_path, "--root", str(multi_root), "--mode", "journal",
213
- "--since", "2020-01-01", "--project", "other claude", "--format", "json",
214
- )
215
- assert r.returncode == 0
216
- data = json.loads(r.stdout)
217
- assert len(data) == 1
218
- assert data[0]["uuid"] == "othersession"
219
-
220
-
221
- def test_cli_project_no_match_exits_1(cli_path, multi_root):
222
- r = _run_cli(
223
- cli_path, "--root", str(multi_root), "--mode", "list", "--project", "zzz",
224
- )
225
- assert r.returncode == 1
@@ -1,80 +0,0 @@
1
- """Tests for lib.tools."""
2
-
3
- from pathlib import Path
4
-
5
- from lib import parser as PR
6
- from lib import tools as T
7
-
8
-
9
- def _load(fixtures_dir, name):
10
- return PR.parse_lines(fixtures_dir / name)
11
-
12
-
13
- def test_extract_tool_calls_count(fixtures_dir):
14
- lines = _load(fixtures_dir, "tool-zoo.jsonl")
15
- calls = T.extract_tool_calls(lines)
16
- assert len(calls) == 9
17
-
18
-
19
- def test_format_bash():
20
- call = {"name": "Bash", "input": {"command": "ls -la /tmp"}}
21
- out = T.format_tool_call(call)
22
- assert out == "Bash: ls -la /tmp"
23
-
24
-
25
- def test_format_powershell():
26
- call = {"name": "PowerShell", "input": {"command": "Get-ChildItem"}}
27
- assert "PowerShell" in T.format_tool_call(call)
28
-
29
-
30
- def test_format_read_with_lines():
31
- call = {"name": "Read", "input": {"file_path": "C:\\foo.py", "offset": 1, "limit": 50}}
32
- out = T.format_tool_call(call)
33
- assert "C:\\foo.py" in out
34
- assert "lines 1" in out
35
-
36
-
37
- def test_format_edit_with_edits():
38
- call = {"name": "Edit", "input": {"file_path": "C:\\foo.py", "edits": [{}, {}, {}]}}
39
- out = T.format_tool_call(call)
40
- assert "3 edits" in out
41
-
42
-
43
- def test_format_write():
44
- call = {"name": "Write", "input": {"file_path": "C:\\bar.py", "content": "print('hi')"}}
45
- out = T.format_tool_call(call)
46
- assert "chars" in out
47
-
48
-
49
- def test_format_agent():
50
- call = {"name": "Agent", "input": {"subagent_type": "Explore", "description": "Find X"}}
51
- out = T.format_tool_call(call)
52
- assert "Agent[Explore]" in out
53
- assert "Find X" in out
54
-
55
-
56
- def test_format_skill():
57
- call = {"name": "Skill", "input": {"skill": "using-superpowers"}}
58
- out = T.format_tool_call(call)
59
- assert "using-superpowers" in out
60
-
61
-
62
- def test_tool_filter(fixtures_dir):
63
- lines = _load(fixtures_dir, "tool-zoo.jsonl")
64
- calls = T.extract_tool_calls(lines, tool_filter={"Bash"})
65
- assert len(calls) == 1
66
- assert calls[0]["name"] == "Bash"
67
-
68
-
69
- def test_files_touched(fixtures_dir):
70
- lines = _load(fixtures_dir, "tool-zoo.jsonl")
71
- files = T.files_touched(lines)
72
- assert any("foo.py" in str(p) for p in files)
73
- assert any("bar.py" in str(p) for p in files)
74
-
75
-
76
- def test_extract_tool_results(fixtures_dir):
77
- lines = _load(fixtures_dir, "subagent-parent.jsonl")
78
- result = T.extract_tool_results(lines, "toolu_01abc")
79
- assert result is not None
80
- assert "Found it" in result