From ba7e3d9803e004a31971bcacec51a5495f261a5f Mon Sep 17 00:00:00 2001
From: Tomas <tomas.bitvinskas@copla.com>
Date: Thu, 27 Aug 2026 19:21:59 +0300
Subject: [PATCH] fix: ignore slash-separated prose references

Signed-off-by: Tomas <tomas.bitvinskas@copla.com>
---
 src/skillspector/references.py           |  3 +-
 tests/nodes/test_security_remediation.py | 35 ++++++++++++++++++++++++
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/src/skillspector/references.py b/src/skillspector/references.py
index b91626d3..f1270f43 100644
--- a/src/skillspector/references.py
+++ b/src/skillspector/references.py
@@ -44,7 +44,8 @@ class ReferenceResolutionResult:
 
 
 _PLAIN_RELATIVE_PATH = re.compile(
-    r"(?<![\w:/.-])((?:\./)?(?:[A-Za-z0-9_.-]+/)+[A-Za-z0-9_.-]+(?:\.[A-Za-z0-9]{1,12})?)(?![\w/.-])"
+    r"(?<![\w:/.-])((?:\./(?:[A-Za-z0-9_.-]+/)+[A-Za-z0-9_.-]+|"
+    r"(?:[A-Za-z0-9_.-]+/)+[A-Za-z0-9_.-]+\.[A-Za-z0-9]{1,12}))(?![\w/.-])"
 )
 
 
diff --git a/tests/nodes/test_security_remediation.py b/tests/nodes/test_security_remediation.py
index 64ed77eb..0c21aa12 100644
--- a/tests/nodes/test_security_remediation.py
+++ b/tests/nodes/test_security_remediation.py
@@ -178,6 +178,41 @@ def test_full_body_reference_resolver_handles_markdown_and_unique_basename(
     assert all(record["status"] == "resolved" for record in records)
 
 
+def test_plain_slash_separated_prose_is_not_a_reference(tmp_path: Path) -> None:
+    records = resolve_bundle_references(
+        tmp_path,
+        source_path="SKILL.md",
+        source_text=(
+            "Compare reads/writes, environment/profile settings, and operation/node behavior."
+        ),
+        known_paths=["SKILL.md"],
+    )
+
+    assert records == []
+
+
+@pytest.mark.parametrize(
+    ("source_text", "target_path"),
+    [
+        ("Read references/guide.md before continuing.", "references/guide.md"),
+        ("Read ./references/guide before continuing.", "references/guide"),
+    ],
+)
+def test_plain_local_reference_requires_an_explicit_path_signal(
+    tmp_path: Path, source_text: str, target_path: str
+) -> None:
+    records = resolve_bundle_references(
+        tmp_path,
+        source_path="SKILL.md",
+        source_text=source_text,
+        known_paths=["SKILL.md", target_path],
+    )
+
+    assert len(records) == 1
+    assert records[0]["status"] == "resolved"
+    assert records[0]["target_path"] == target_path
+
+
 def test_reference_resolver_rejects_external_and_parent_escape(tmp_path: Path) -> None:
     records = resolve_bundle_references(
         tmp_path,