feat: Implement timeline management for GitHub pull requests

- Add models for PullRequestRef, PullRequestMeta, TimelineEvent, and TimelineContext to represent pull request data and timeline events.
- Create a TimelinePager class to handle pagination of timeline events, including fetching and storing pages of events.
- Introduce rendering functions to format timeline data for display, including headers, pages, and event details.
- Remove the old main entry point for the moelib project as it is no longer needed.
- Add comprehensive tests for the CLI functionality, ensuring correct behavior for viewing and expanding pull request timelines.
- Update dependency management to include necessary packages for the new functionality.

Author: SigureMo

README.md

@@ -14,3 +14,36 @@ Just a template for quickly creating a python library.
 </p>
 
 Before the work starts, replace the `moelib` with the name of your library.
+
+## gh-llm prototype
+
+This repo includes a `gh-llm` CLI prototype for PR timeline reading with **real GitHub cursor pagination**.
+
+```bash
+# Show PR overview and timeline page 1 + last page (server-side pagination)
+gh-llm pr view 123 --repo owner/repo
+
+# Expand a timeline page by number (loads more from GitHub API)
+gh-llm pr timeline-expand 2 --pr 77900 --repo owner/repo
+
+# Get full content of one timeline event by index
+gh-llm pr event 42 --pr 77900 --repo owner/repo
+
+# Expand resolved review comments for one or more review events
+gh-llm pr review-expand PRR_xxx,PRR_yyy --pr 77900 --repo owner/repo
+```
+
+Behavior:
+
+- Unified interface:
+  `gh-llm pr view [<number>|<url>|<branch>] [--repo owner/repo] [--page-size N]`
+  and `gh-llm pr timeline-expand <page> --pr ... --repo ... [--page-size N]`.
+- PR metadata is rendered as frontmatter at the top, followed by the PR description body.
+- Timeline data comes from GraphQL `timelineItems` cursor pagination (`first/after` and `last/before`).
+- `pr view` fetches and renders page 1 + last page first, then prints actionable expand commands.
+- When the last page is short, `pr view` also shows the previous page to preserve enough tail context.
+- `pr timeline-expand N` fetches page `N` on-demand via server-side pagination and updates local cursor checkpoints.
+- Long event bodies are truncated only when very long; use `gh-llm pr event <index>` to fetch full text.
+- Resolved review comments are folded by default in timeline pages; use `gh-llm pr review-expand <PRR_ids>` to expand them in bulk.
+- No local session state is required between commands. The tool only uses collision-safe keyed cache for acceleration.
+- Timeline includes commit/review/comment and state events (merged/closed/reopened), with ordering matching GitHub timeline flow.

justfile

@@ -1,4 +1,4 @@
-VERSION := `uv run python -c "import sys; from moelib import __version__ as version; sys.stdout.write(version)"`
+VERSION := `uv run python -c "import sys; from gh_llm import __version__ as version; sys.stdout.write(version)"`
 
 install:
   uv sync --all-extras --dev
@@ -12,7 +12,7 @@ fmt:
   prettier --write '**/*.md'
 
 lint:
-  uv run pyright src/moelib tests
+  uv run pyright src/gh_llm tests
   uv run ruff check .
 
 fmt-docs:

pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "moelib"
+name = "gh-llm"
 version = "0.1.0"
 description = ""
 readme = "README.md"
@@ -23,13 +23,13 @@ classifiers = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/ShigureLab/moelib"
-Documentation = "https://github.com/ShigureLab/moelib"
-Repository = "https://github.com/ShigureLab/moelib"
-Issues = "https://github.com/ShigureLab/moelib/issues"
+Homepage = "https://github.com/ShigureLab/gh-llm"
+Documentation = "https://github.com/ShigureLab/gh-llm"
+Repository = "https://github.com/ShigureLab/gh-llm"
+Issues = "https://github.com/ShigureLab/gh-llm/issues"
 
 [project.scripts]
-moelib = "moelib.__main__:main"
+gh-llm = "gh_llm.__main__:main"
 
 [dependency-groups]
 dev = [
@@ -40,13 +40,13 @@ dev = [
 ]
 
 [tool.pyright]
-include = ["src/moelib", "tests"]
-pythonVersion = "3.10"
+include = ["src/gh_llm", "tests"]
+pythonVersion = "3.14"
 typeCheckingMode = "strict"
 
 [tool.ruff]
 line-length = 120
-target-version = "py310"
+target-version = "py314"
 
 [tool.ruff.lint]
 select = [
@@ -95,7 +95,7 @@ future-annotations = true
 
 [tool.ruff.lint.isort]
 required-imports = ["from __future__ import annotations"]
-known-first-party = ["moelib"]
+known-first-party = ["gh_llm"]
 combine-as-imports = true
 
 [build-system]

src/moelib/__init__.py src/gh_llm/__init__.pysrc/moelib/__init__.py renamed to src/gh_llm/__init__.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+import sys
+
+from gh_llm.cli import run
+
+
+def main() -> None:
+    raise SystemExit(run(sys.argv[1:]))
+
+
+if __name__ == "__main__":
+    main()

src/gh_llm/__main__.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+import json
+import os
+from hashlib import sha256
+from pathlib import Path
+from typing import cast
+
+
+class CacheStore:
+    def __init__(self, cache_dir: Path | None = None) -> None:
+        self._cache_dir = cache_dir or _default_cache_dir()
+
+    def get_json(self, namespace: str, key: str) -> dict[str, object] | None:
+        path = self._path(namespace=namespace, key=key)
+        if not path.exists():
+            return None
+        raw: object = json.loads(path.read_text(encoding="utf-8"))
+        if not isinstance(raw, dict):
+            return None
+        raw_dict = cast("dict[object, object]", raw)
+        return {str(k): v for k, v in raw_dict.items()}
+
+    def set_json(self, namespace: str, key: str, value: dict[str, object]) -> None:
+        path = self._path(namespace=namespace, key=key)
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(json.dumps(value, ensure_ascii=False), encoding="utf-8")
+
+    def _path(self, *, namespace: str, key: str) -> Path:
+        safe_namespace = namespace.replace("/", "_")
+        digest = sha256(key.encode("utf-8")).hexdigest()
+        return self._cache_dir / safe_namespace / f"{digest}.json"
+
+
+def _default_cache_dir() -> Path:
+    xdg_cache = os.environ.get("XDG_CACHE_HOME")
+    if xdg_cache:
+        return Path(xdg_cache) / "gh-llm"
+    return Path.home() / ".cache" / "gh-llm"