Fix test collection, add tests for new features, update docs

- Add `pythonpath = ["src"]` to pytest config to fix module shadowing
  from root-level `ghpr.py`
- Add `test_render.py` with tests for `render_unified_diff` newline
  indicator logic
- Add test for trailing newline preservation in
  `write_description_with_link_ref`
- Update CLAUDE.md: add recent changes (ownership warnings, trailing
  newline handling), note that `init` is in `create.py`, add `tests/`
- Update README.md: fix directory structure example (`repo#123.md` not
  `owner-repo#123.md`), add draft comments to features list

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ryan-williams

CLAUDE.md

@@ -43,6 +43,7 @@ The gist is a **read replica** of the local clone. `push`/`pull` operations sync
 ├── README.md
 ├── CLAUDE.md           # This file
 ├── ghpr.py             # Standalone uv run script
+├── tests/               # pytest test suite
 └── src/ghpr/
     ├── __init__.py
     ├── cli.py          # Main CLI entry point, registers commands
@@ -55,7 +56,7 @@ The gist is a **read replica** of the local clone. `push`/`pull` operations sync
     ├── render.py       # Diff rendering utilities
     └── commands/       # Modular command implementations
         ├── clone.py
-        ├── create.py
+        ├── create.py        # Also contains `init` command
         ├── diff.py
         ├── ingest_attachments.py
         ├── open.py
@@ -68,22 +69,25 @@ The gist is a **read replica** of the local clone. `push`/`pull` operations sync
 
 ### Recent Changes
 
-**Draft Comment Workflow** (completed):
+**Comment Ownership Warnings** (latest):
+- `ghpr diff` and `ghpr push -n` warn when showing diffs for comments authored by others
+- `ghpr push` skips others' comments by default, with clear summary message
+- Use `-C` (`--force-others`) to attempt pushing edits to others' comments
+
+**Trailing Newline Handling** (latest):
+- `write_description_with_link_ref` ensures files always end with a newline
+- Fixes diff thrashing when GitHub strips trailing newlines from PR descriptions
+- `render_unified_diff` only shows "No newline" indicator when sides actually differ
+
+**Draft Comment Workflow**:
 - Create files starting with `new` and ending in `.md` (e.g., `new.md`, `new-feature.md`)
 - Commit them to git
 - `ghpr push` automatically:
   1. Posts them as comments to GitHub
   2. Creates a commit renaming `new*.md` → `z{comment_id}-{author}.md`
   3. Syncs to gist
-- Handles local modifications gracefully (uses `git rm -f`)
-
-**Unified Diff Display** (completed):
-- Both `diff` and `push -n` show identical output
-- Draft comments displayed in green
-- Comment changes shown with unified diff
-- Metadata (line counts, etc.) in bold
 
-**Image Upload** (completed):
+**Image Upload**:
 - `ghpr upload <file>` uploads to gist and returns markdown URLs
 - Uses `utz.git.gist` module for shared functionality
 - Auto-formats as markdown for images, URL for other files

README.md

@@ -16,10 +16,11 @@
 
 - **Clone** PR/Issues locally with comments
 - **Sync** bidirectionally between GitHub and local files
-- **Diff** local changes vs remote
+- **Diff** local changes vs remote (with ownership warnings for others' comments)
 - **Push** updates back to GitHub
 - **Gist mirroring** for version control and sharing
 - **Comment management** - edit and sync PR/issue comments
+- **Draft comments** - create `new*.md` files, push to post as comments
 
 ## Installation
 
@@ -84,7 +85,7 @@ ghpr upload screenshot.png
 Cloned PRs and issues are stored as:
 ```
 gh/123/
-  owner-repo#123.md       # Main description
+  repo#123.md             # Main description
   z3404494861-user.md     # Comments (ID-author format)
   z3407382913-user.md
 ```

pyproject.toml

@@ -45,3 +45,6 @@ where = ["src"]
 
 [tool.setuptools.package-data]
 ghpr = ["shell/*.bash", "shell/*.fish"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]

tests/test_files.py

@@ -199,6 +199,36 @@ def test_body_with_existing_link_def(self):
             link_def = '[owner/myrepo#999]: https://github.com/owner/myrepo/pull/999'
             assert content.count(link_def) == 1
 
+    def test_body_with_existing_link_def_no_trailing_newline(self):
+        """Test that file ends with newline even when body (with link) lacks one.
+
+        GitHub strips trailing newlines from PR descriptions. When the body
+        already contains the link definition but lacks a trailing newline,
+        we should still ensure the file ends with one.
+        """
+        with TemporaryDirectory() as tmpdir:
+            tmppath = Path(tmpdir)
+            filepath = tmppath / 'myrepo#888.md'
+            # Body has link def but no trailing newline (simulates GitHub stripping it)
+            body = 'Some content.\n\n[owner/myrepo#888]: https://github.com/owner/myrepo/pull/888'
+
+            write_description_with_link_ref(
+                filepath,
+                owner='owner',
+                repo='myrepo',
+                pr_number='888',
+                title='No Trailing Newline',
+                body=body,
+                url='https://github.com/owner/myrepo/pull/888'
+            )
+
+            content = filepath.read_text()
+            # File should end with newline
+            assert content.endswith('\n'), "File should end with a newline"
+            # Link def should appear exactly once
+            link_def = '[owner/myrepo#888]: https://github.com/owner/myrepo/pull/888'
+            assert content.count(link_def) == 1
+
 
 class TestReadDescriptionFile:
     """Test reading and parsing description files."""

tests/test_render.py

@@ -0,0 +1,109 @@
+"""Tests for diff rendering utilities."""
+
+import io
+from unittest.mock import patch
+
+import pytest
+
+from ghpr.render import render_unified_diff
+
+
+class TestRenderUnifiedDiff:
+    """Test unified diff rendering."""
+
+    def test_no_newline_indicator_when_both_lack_newline(self):
+        """Test that 'No newline' indicator doesn't appear when both sides lack it."""
+        output = io.StringIO()
+
+        def capture(msg):
+            output.write(msg + '\n')
+
+        render_unified_diff(
+            remote_content='Line 1\nLine 2',  # No trailing newline
+            local_content='Line 1\nLine 2 modified',  # No trailing newline
+            fromfile='remote',
+            tofile='local',
+            use_color=False,
+            log=capture,
+        )
+
+        result = output.getvalue()
+        assert 'No newline at end of file' not in result
+
+    def test_no_newline_indicator_when_both_have_newline(self):
+        """Test that 'No newline' indicator doesn't appear when both have it."""
+        output = io.StringIO()
+
+        def capture(msg):
+            output.write(msg + '\n')
+
+        render_unified_diff(
+            remote_content='Line 1\nLine 2\n',  # Has trailing newline
+            local_content='Line 1\nLine 2 modified\n',  # Has trailing newline
+            fromfile='remote',
+            tofile='local',
+            use_color=False,
+            log=capture,
+        )
+
+        result = output.getvalue()
+        assert 'No newline at end of file' not in result
+
+    def test_no_newline_indicator_when_local_lacks_newline(self):
+        """Test that 'No newline' indicator appears when local lacks trailing newline."""
+        output = io.StringIO()
+
+        def capture(msg):
+            output.write(msg + '\n')
+
+        # Content differs AND trailing newline differs
+        render_unified_diff(
+            remote_content='Line 1\nLine 2\n',  # Has trailing newline
+            local_content='Line 1\nLine 2 modified',  # No trailing newline, different content
+            fromfile='remote',
+            tofile='local',
+            use_color=False,
+            log=capture,
+        )
+
+        result = output.getvalue()
+        assert 'No newline at end of file' in result
+
+    def test_no_newline_indicator_when_remote_lacks_newline(self):
+        """Test that 'No newline' indicator appears when remote lacks trailing newline."""
+        output = io.StringIO()
+
+        def capture(msg):
+            output.write(msg + '\n')
+
+        # Content differs AND trailing newline differs
+        render_unified_diff(
+            remote_content='Line 1\nLine 2',  # No trailing newline
+            local_content='Line 1\nLine 2 modified\n',  # Has trailing newline, different content
+            fromfile='remote',
+            tofile='local',
+            use_color=False,
+            log=capture,
+        )
+
+        result = output.getvalue()
+        assert 'No newline at end of file' in result
+
+    def test_only_trailing_newline_differs(self):
+        """Test minimal diff when only trailing newline differs."""
+        output = io.StringIO()
+
+        def capture(msg):
+            output.write(msg + '\n')
+
+        render_unified_diff(
+            remote_content='Same content\n',
+            local_content='Same content',
+            fromfile='remote',
+            tofile='local',
+            use_color=False,
+            log=capture,
+        )
+
+        result = output.getvalue()
+        assert 'Only trailing newline differs' in result