Fix get_paths losing class/def context across blank and continuation lines

Two bugs in the indentation path stack:

1. Blank lines computed indent as 0, wiping the entire stack — now
   skipped so enclosing class/function context is preserved.

2. Closing-bracket continuation lines (e.g. `) -> str:` from a
   multi-line def signature) at the same indent as the opening
   statement replaced it in the stack — now treated as continuations
   that only pop deeper entries, not same-indent ones.

Co-Authored-By: Claude Code 2.1.81 / Claude Opus 4.6 <noreply@anthropic.com>

Author: yarikoptic

bin/show-paths

@@ -194,14 +194,30 @@ def get_paths(lines):
 
     for i, line in enumerate(lines):
         stripped = line.lstrip()
+
+        # Skip blank lines — they have indent 0 which would
+        # incorrectly pop the entire path stack
+        if not stripped:
+            paths.append((i, tuple(path_stack)))
+            continue
+
         indent = len(line) - len(stripped)
 
+        # Lines starting with closing brackets/parens or commas are
+        # continuations of a previous statement — they should not
+        # replace the current entry at the same indent level.
+        is_continuation = stripped[0] in ")]},"
+
         # Adjust the stack based on indentation
-        while path_stack and path_stack[-1][1] >= indent:
-            path_stack.pop()
+        if is_continuation:
+            while path_stack and path_stack[-1][1] > indent:
+                path_stack.pop()
+        else:
+            while path_stack and path_stack[-1][1] >= indent:
+                path_stack.pop()
 
         # Extract the "key" (first non-space word before :, {, etc.)
-        if stripped:
+        if not is_continuation:
             key = stripped.split()[0].rstrip(":{")
             if key:
                 path_stack.append((key, indent, i))

tests/data/sample_multiline.py

@@ -0,0 +1,12 @@
+class Storage:
+    """A storage class."""
+
+    def upload(
+        self,
+        name,
+        content_type=None,
+    ) -> str:
+        if name:
+            return self.client.call(
+                Method='put_object',
+            )

tests/test_show_paths.py

@@ -910,3 +910,60 @@ def test_show_paths_github_markdown_filename_name_linked():
     assert (
         len(header_lines) > 0
     ), f"Expected linked filename header for sample.py: {output}"
+
+
+@pytest.mark.ai_generated
+def test_show_paths_blank_lines_preserve_context():
+    """Test that blank lines do not destroy the indentation path stack.
+
+    Blank lines have zero indentation which previously caused the path
+    stack to be wiped, losing class/function context.
+    """
+    result = run_show_paths(
+        str(DATA_DIR / "sample_multiline.py"),
+        "-e",
+        "put_object",
+        "-f",
+        "full-lines",
+        "--color",
+        "off",
+    )
+    assert result.returncode == 0
+    output = result.stdout
+    lines = output.strip().split("\n")
+    texts = [line.split(maxsplit=1)[1] if " " in line else "" for line in lines]
+    # The class definition must appear in the context — blank line inside
+    # the docstring must not wipe it from the stack.
+    assert any("class Storage" in t for t in texts), (
+        f"class definition missing from context:\n{output}"
+    )
+
+
+@pytest.mark.ai_generated
+def test_show_paths_continuation_lines_preserve_context():
+    """Test that closing-paren continuation lines do not replace the def.
+
+    A multi-line function signature like:
+        def upload(
+            self,
+        ) -> str:
+    has ') -> str:' at the same indent as 'def upload('. The closing
+    paren line must not replace the def in the path stack.
+    """
+    result = run_show_paths(
+        str(DATA_DIR / "sample_multiline.py"),
+        "-e",
+        "put_object",
+        "-f",
+        "full-lines",
+        "--color",
+        "off",
+    )
+    assert result.returncode == 0
+    output = result.stdout
+    lines = output.strip().split("\n")
+    texts = [line.split(maxsplit=1)[1] if " " in line else "" for line in lines]
+    # The def line must appear, not ') -> str:'
+    assert any("def upload" in t for t in texts), (
+        f"def line missing from context (replaced by continuation?):\n{output}"
+    )