import os
import unicodedata
import pytest
from pathlib import Path
from graphify.detect import classify_file, count_words, detect, detect_incremental, save_manifest, FileType, _looks_like_paper, _is_ignored, _load_graphifyignore, _is_sensitive
from graphify import detect as detect_mod

FIXTURES = Path(__file__).parent / "fixtures"

def test_classify_python():
    assert classify_file(Path("foo.py")) == FileType.CODE

def test_classify_typescript():
    assert classify_file(Path("bar.ts")) == FileType.CODE

def test_classify_powershell_module():
    # #1315: .psm1 modules were never indexed (CODE_EXTENSIONS gap).
    assert classify_file(Path("Utils.psm1")) == FileType.CODE

def test_classify_powershell_manifest():
    # #1331: .psd1 manifests must be classified as CODE so the manifest extractor runs.
    assert classify_file(Path("MyModule.psd1")) == FileType.CODE

def test_classify_markdown():
    assert classify_file(Path("README.md")) == FileType.DOCUMENT

def test_classify_skill():
    # #1901: .skill agent files (Markdown with YAML frontmatter) were dropped as unclassified.
    assert classify_file(Path("10_Orchestrator.skill")) == FileType.DOCUMENT

def test_classify_pdf():
    assert classify_file(Path("paper.pdf")) == FileType.PAPER

def test_classify_pdf_in_xcassets_skipped():
    # PDFs inside Xcode asset catalogs are vector icons, not papers
    asset_pdf = Path("MyApp/Images.xcassets/icon.imageset/icon.pdf")
    assert classify_file(asset_pdf) is None

def test_classify_pdf_in_xcassets_root_skipped():
    asset_pdf = Path("Pods/HXPHPicker/Assets.xcassets/photo.pdf")
    assert classify_file(asset_pdf) is None

def test_classify_unknown_returns_none():
    assert classify_file(Path("archive.zip")) is None

def test_classify_image():
    assert classify_file(Path("screenshot.png")) == FileType.IMAGE
    assert classify_file(Path("design.jpg")) == FileType.IMAGE
    assert classify_file(Path("diagram.webp")) == FileType.IMAGE

def test_count_words_sample_md():
    words = count_words(FIXTURES / "sample.md")
    assert words > 5

def test_detect_finds_fixtures():
    result = detect(FIXTURES)
    assert result["total_files"] >= 2
    assert "code" in result["files"]
    assert "document" in result["files"]

def test_detect_warns_small_corpus():
    result = detect(FIXTURES)
    assert result["needs_graph"] is False
    assert result["warning"] is not None

def test_detect_skips_noise_dot_dirs():
    """Noise dot dirs (.next, .nuxt, .graphify cache, …) are skipped (#873).
    Non-noise dot dirs (.github, .claude, …) are now allowed through."""
    result = detect(FIXTURES)
    for files in result["files"].values():
        for f in files:
            # graphify's own cache is always skipped
            assert "/.graphify/" not in f
            # well-known framework caches are always skipped
            for noise in ("/.next/", "/.nuxt/", "/.turbo/", "/.angular/"):
                assert noise not in f


def test_detect_skips_obsidian_vault_metadata_dirs(tmp_path):
    """Obsidian metadata and plugin caches are not part of the source corpus (#2493)."""
    for directory in (".obsidian", ".smart-env"):
        metadata_dir = tmp_path / directory
        metadata_dir.mkdir()
        (metadata_dir / "state.json").write_text("{}")
    trash_dir = tmp_path / ".trash"
    trash_dir.mkdir()
    (trash_dir / "state.json").write_text("{}")
    (tmp_path / "project.json").write_text("{}")

    result = detect(tmp_path)

    assert result["files"]["code"] == [
        str(trash_dir / "state.json"),
        str(tmp_path / "project.json"),
    ]


def test_classify_md_paper_by_signals(tmp_path):
    """A .md file with enough paper signals should classify as PAPER."""
    paper = tmp_path / "paper.md"
    paper.write_text(
        "# Abstract\n\nWe propose a new method. See [1] and [23].\n"
        "This work was published in the Journal of AI. ArXiv preprint.\n"
        "See Equation 3 for details. \\cite{vaswani2017}.\n"
    )
    assert classify_file(paper) == FileType.PAPER


def test_classify_md_doc_without_signals(tmp_path):
    """A plain .md file without paper signals should stay DOCUMENT."""
    doc = tmp_path / "notes.md"
    doc.write_text("# My Notes\n\nHere are some notes about the project.\n")
    assert classify_file(doc) == FileType.DOCUMENT


def test_classify_attention_paper():
    """The real attention paper file should be classified as PAPER."""
    paper_path = Path("/home/safi/graphify_eval/papers/attention_is_all_you_need.md")
    if paper_path.exists():
        result = classify_file(paper_path)
        assert result == FileType.PAPER


def test_graphifyignore_excludes_file(tmp_path):
    """Files matching .graphifyignore patterns are excluded from detect()."""
    (tmp_path / ".graphifyignore").write_text("vendor/\n*.generated.py\n")
    vendor = tmp_path / "vendor"
    vendor.mkdir()
    (vendor / "lib.py").write_text("x = 1")
    (tmp_path / "main.py").write_text("print('hi')")
    (tmp_path / "schema.generated.py").write_text("x = 1")

    result = detect(tmp_path)
    file_list = result["files"]["code"]
    assert any("main.py" in f for f in file_list)
    assert not any("vendor" in f for f in file_list)
    assert not any("generated" in f for f in file_list)
    assert result["graphifyignore_patterns"] == 2


def test_graphifyignore_matches_nfd_path_with_nfc_pattern(tmp_path):
    """An accented pattern excludes its directory even when the FS stores NFD.

    macOS returns filenames in NFD ("c" + U+0327) while editors write ignore
    files in NFC (U+00E7). Without normalization the two compare unequal and
    the rule silently does nothing — the files get scanned, and docs/PDFs are
    sent to an LLM despite an explicit exclusion.
    """
    nfc_name = unicodedata.normalize("NFC", "Or\u00e7amento")
    nfd_name = unicodedata.normalize("NFD", nfc_name)
    assert nfc_name != nfd_name  # guard: the two forms really do differ

    (tmp_path / ".graphifyignore").write_text(f"{nfc_name}/\n")
    secret_dir = tmp_path / nfd_name
    secret_dir.mkdir()
    (secret_dir / "contrato.py").write_text("x = 1")
    (tmp_path / "main.py").write_text("print('hi')")

    result = detect(tmp_path)
    file_list = result["files"]["code"]
    assert any("main.py" in f for f in file_list)
    assert not any("contrato.py" in f for f in file_list)


def test_graphifyignore_matches_nfc_path_with_nfd_pattern(tmp_path):
    """The reverse direction also holds: NFD pattern, NFC path on disk."""
    nfc_name = unicodedata.normalize("NFC", "Or\u00e7amento")
    nfd_name = unicodedata.normalize("NFD", nfc_name)

    (tmp_path / ".graphifyignore").write_text(f"{nfd_name}/\n")
    d = tmp_path / nfc_name
    d.mkdir()
    (d / "contrato.py").write_text("x = 1")
    (tmp_path / "main.py").write_text("print('hi')")

    result = detect(tmp_path)
    file_list = result["files"]["code"]
    assert any("main.py" in f for f in file_list)
    assert not any("contrato.py" in f for f in file_list)


def test_graphifyignore_ascii_patterns_unaffected(tmp_path):
    """Normalization is a no-op for ASCII patterns — no regression."""
    (tmp_path / ".graphifyignore").write_text("vendor/\n")
    v = tmp_path / "vendor"
    v.mkdir()
    (v / "lib.py").write_text("x = 1")
    (tmp_path / "main.py").write_text("x = 1")

    result = detect(tmp_path)
    file_list = result["files"]["code"]
    assert any("main.py" in f for f in file_list)
    assert not any("vendor" in f for f in file_list)


def test_graphifyignore_missing_is_fine(tmp_path):
    """No .graphifyignore is not an error."""
    (tmp_path / "main.py").write_text("x = 1")
    result = detect(tmp_path)
    assert result["graphifyignore_patterns"] == 0


def test_graphifyignore_comments_ignored(tmp_path):
    """Comment lines in .graphifyignore are not treated as patterns."""
    (tmp_path / ".graphifyignore").write_text("# this is a comment\n\nmain.py\n")
    (tmp_path / "main.py").write_text("x = 1")
    (tmp_path / "other.py").write_text("x = 2")
    result = detect(tmp_path)
    assert not any("main.py" in f for f in result["files"]["code"])
    assert any("other.py" in f for f in result["files"]["code"])


def test_graphifyignore_utf8_bom_first_pattern_honored(tmp_path):
    """A UTF-8 BOM at the start of .graphifyignore must not corrupt the first
    pattern (#2163): git strips a single leading BOM, so `*.log` on line 1
    must still exclude app.log."""
    (tmp_path / ".graphifyignore").write_bytes(b"\xef\xbb\xbf*.log\nbuild/\n")
    build = tmp_path / "build"
    build.mkdir()
    (build / "lib.py").write_text("x = 1")
    (tmp_path / "app.log").write_text("log line")
    (tmp_path / "main.py").write_text("print('hi')")

    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any("app.log" in f for f in all_files), "BOM'd first pattern was dropped"
    assert not any("build" in f for f in all_files)
    assert any("main.py" in f for f in all_files)
    assert result["graphifyignore_patterns"] == 2


def test_gitignore_utf8_bom_matches_git(tmp_path):
    """A BOM'd .gitignore first pattern must match, exactly like git (#2163)."""
    (tmp_path / ".gitignore").write_bytes(b"\xef\xbb\xbf*.log\n")
    (tmp_path / "app.log").write_text("log line")
    (tmp_path / "main.py").write_text("print('hi')")

    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any("app.log" in f for f in all_files)
    assert any("main.py" in f for f in all_files)


def test_graphifyignore_bom_only_file(tmp_path):
    """A .graphifyignore containing only a BOM yields zero patterns, not one
    bogus U+FEFF pattern (#2163)."""
    (tmp_path / ".graphifyignore").write_bytes(b"\xef\xbb\xbf")
    (tmp_path / "main.py").write_text("x = 1")

    result = detect(tmp_path)
    assert result["graphifyignore_patterns"] == 0
    assert any("main.py" in f for f in result["files"]["code"])


def test_graphifyignore_bom_then_comment(tmp_path):
    """A BOM followed by a comment must still parse as a comment, not become
    a `\\ufeff# comment` pattern (#2163)."""
    (tmp_path / ".graphifyignore").write_bytes(b"\xef\xbb\xbf# comment\nmain.py\n")
    (tmp_path / "main.py").write_text("x = 1")
    (tmp_path / "other.py").write_text("x = 2")

    result = detect(tmp_path)
    assert not any("main.py" in f for f in result["files"]["code"])
    assert any("other.py" in f for f in result["files"]["code"])
    assert result["graphifyignore_patterns"] == 1, "BOM'd comment became a pattern"


def test_nested_gitignore_utf8_bom(tmp_path):
    """A BOM'd .gitignore below the scan root (loaded live during the walk,
    #1206 path) must also have its first pattern honored (#2163)."""
    sub = tmp_path / "sub"
    sub.mkdir()
    (sub / ".gitignore").write_bytes(b"\xef\xbb\xbf*.log\n")
    (sub / "app.log").write_text("log line")
    (sub / "keep.py").write_text("x = 1")

    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any("app.log" in f for f in all_files)
    assert any("keep.py" in f for f in all_files)


def test_git_info_exclude_utf8_bom(tmp_path):
    """A BOM at the start of $GIT_DIR/info/exclude must not corrupt the first
    pattern either (#2163) — second read site in _load_graphifyignore."""
    (tmp_path / ".git" / "info").mkdir(parents=True)
    (tmp_path / ".git" / "info" / "exclude").write_bytes(b"\xef\xbb\xbfsecrets/\n")
    secrets = tmp_path / "secrets"
    secrets.mkdir()
    (secrets / "x.py").write_text("token = 'x'")
    (tmp_path / "real.py").write_text("def real(): pass")

    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any("secrets" in f for f in all_files), "BOM'd info/exclude pattern was dropped"
    assert any("real.py" in f for f in all_files)


def test_detect_follows_symlinked_directory(tmp_path):
    real_dir = tmp_path / "real_lib"
    real_dir.mkdir()
    (real_dir / "util.py").write_text("x = 1")
    (tmp_path / "linked_lib").symlink_to(real_dir)

    result_no = detect(tmp_path, follow_symlinks=False)
    result_yes = detect(tmp_path, follow_symlinks=True)

    assert any("real_lib" in f for f in result_no["files"]["code"])
    assert not any("linked_lib" in f for f in result_no["files"]["code"])
    assert any("linked_lib" in f for f in result_yes["files"]["code"])


def test_detect_follows_symlinked_file(tmp_path):
    (tmp_path / "real.py").write_text("x = 1")
    (tmp_path / "link.py").symlink_to(tmp_path / "real.py")

    result = detect(tmp_path, follow_symlinks=True)
    code = result["files"]["code"]
    assert any("real.py" in f for f in code)
    assert any("link.py" in f for f in code)


def test_graphifyignore_hermetic_without_vcs(tmp_path):
    """Without a VCS root, parent .graphifyignore does NOT apply (hermetic)."""
    (tmp_path / ".graphifyignore").write_text("vendor/\n")
    sub = tmp_path / "packages" / "mylib"
    sub.mkdir(parents=True)
    (sub / "main.py").write_text("x = 1")
    vendor = sub / "vendor"
    vendor.mkdir()
    (vendor / "dep.py").write_text("y = 2")

    result = detect(sub)
    code_files = result["files"]["code"]
    assert any("main.py" in f for f in code_files)
    # parent .graphifyignore must NOT leak into a non-VCS scan
    assert any("vendor" in f for f in code_files)
    assert result["graphifyignore_patterns"] == 0


def test_graphifyignore_discovered_from_parent_in_vcs(tmp_path):
    """Inside a VCS repo, parent .graphifyignore applies to subdirectory scans."""
    (tmp_path / ".git").mkdir()
    (tmp_path / ".graphifyignore").write_text("vendor/\n")
    sub = tmp_path / "packages" / "mylib"
    sub.mkdir(parents=True)
    (sub / "main.py").write_text("x = 1")
    vendor = sub / "vendor"
    vendor.mkdir()
    (vendor / "dep.py").write_text("y = 2")

    result = detect(sub)
    code_files = result["files"]["code"]
    assert any("main.py" in f for f in code_files)
    assert not any("vendor" in f for f in code_files)
    assert result["graphifyignore_patterns"] >= 1


def test_graphifyignore_stops_at_git_boundary(tmp_path):
    """Upward search stops at the git repo root (.git directory)."""
    (tmp_path / ".graphifyignore").write_text("main.py\n")
    repo = tmp_path / "repo"
    repo.mkdir()
    (repo / ".git").mkdir()
    sub = repo / "sub"
    sub.mkdir()
    (sub / "main.py").write_text("x = 1")

    result = detect(sub)
    code_files = result["files"]["code"]
    assert any("main.py" in f for f in code_files)
    assert result["graphifyignore_patterns"] == 0


def test_graphifyignore_at_git_root_is_included(tmp_path):
    """A .graphifyignore at the git repo root is included when scanning a subdir."""
    repo = tmp_path / "repo"
    repo.mkdir()
    (repo / ".git").mkdir()
    (repo / ".graphifyignore").write_text("vendor/\n")
    sub = repo / "packages" / "mylib"
    sub.mkdir(parents=True)
    (sub / "main.py").write_text("x = 1")
    vendor = sub / "vendor"
    vendor.mkdir()
    (vendor / "dep.py").write_text("y = 2")

    result = detect(sub)
    code_files = result["files"]["code"]
    assert any("main.py" in f for f in code_files)
    assert not any("vendor" in f for f in code_files)
    assert result["graphifyignore_patterns"] == 1


def test_gitignore_nested_below_root_excludes_file(tmp_path):
    """A .gitignore in a subdirectory below the scan root is honored too (#1206).

    Previously only the scan root and its ancestors were read, so a
    .gitignore sitting inside e.g. vendor/sub/ was silently skipped.
    """
    (tmp_path / ".gitignore").write_text("*.log\n")
    sub = tmp_path / "vendor" / "sub"
    sub.mkdir(parents=True)
    (sub / ".gitignore").write_text("secret.txt\n")
    (tmp_path / "root.py").write_text("x = 1")
    (tmp_path / "root.log").write_text("noise")
    (sub / "keep.py").write_text("y = 2")
    (sub / "secret.txt").write_text("shh")

    result = detect(tmp_path)
    code_files = result["files"]["code"]
    assert any("root.py" in f for f in code_files)
    assert any("keep.py" in f for f in code_files)
    assert not any("root.log" in f for f in code_files)
    assert not any("secret.txt" in f for f in code_files)
    assert result["graphifyignore_patterns"] == 2


def test_gitignore_nested_below_root_prunes_whole_directory(tmp_path):
    """A nested .gitignore excluding a directory prevents descending into it."""
    sub = tmp_path / "vendor" / "sub"
    sub.mkdir(parents=True)
    (sub / ".gitignore").write_text("build/\n")
    build = sub / "build"
    build.mkdir()
    (build / "generated.py").write_text("x = 1")
    (sub / "keep.py").write_text("y = 2")

    result = detect(tmp_path)
    code_files = result["files"]["code"]
    assert any("keep.py" in f for f in code_files)
    assert not any("generated.py" in f for f in code_files)


def test_gitignore_nested_negation_overrides_broader_root_rule(tmp_path):
    """A closer (nested) .gitignore's `!` re-include wins over a root exclude,
    matching git's closer-file-wins precedence. Uses .py so classification lands
    in the deterministic `code` bucket."""
    (tmp_path / ".gitignore").write_text("*.py\n")
    sub = tmp_path / "vendor" / "sub"
    sub.mkdir(parents=True)
    (sub / ".gitignore").write_text("!important.py\n")
    (tmp_path / "root.py").write_text("a = 1")
    (sub / "important.py").write_text("b = 1")
    (sub / "other.py").write_text("c = 1")

    result = detect(tmp_path)
    code = result["files"]["code"]
    # nested `!important.py` re-includes it despite the root `*.py` exclude...
    assert any("vendor/sub/important.py" in f for f in code)
    # ...while the root-excluded and non-re-included files stay out
    assert not any(f.endswith("root.py") for f in code)
    assert not any(f.endswith("other.py") for f in code)


def test_nested_ignore_overrides_git_info_exclude_and_root(tmp_path):
    """Precedence across all three sources: a nested `.gitignore` `!` re-include
    outranks both a root `.gitignore` and `.git/info/exclude` (lowest, from
    #1810), while an info/exclude-only file with no re-include stays out."""
    (tmp_path / ".git" / "info").mkdir(parents=True)
    (tmp_path / ".git" / "info" / "exclude").write_text("*.py\n")
    (tmp_path / ".gitignore").write_text("keep.py\n")           # root also excludes it
    sub = tmp_path / "a" / "b"
    sub.mkdir(parents=True)
    (sub / ".gitignore").write_text("!keep.py\n")               # nearest wins -> re-included
    (sub / "keep.py").write_text("x = 1")
    (tmp_path / "drop.py").write_text("y = 1")                  # only info/exclude -> excluded

    result = detect(tmp_path)
    code = result["files"]["code"]
    assert any("a/b/keep.py" in f for f in code), "nested ! must beat root + info/exclude"
    assert not any(f.endswith("drop.py") for f in code)


def test_detect_handles_circular_symlinks(tmp_path):
    sub = tmp_path / "a"
    sub.mkdir()
    (sub / "main.py").write_text("x = 1")
    (sub / "loop").symlink_to(tmp_path)

    result = detect(tmp_path, follow_symlinks=True)
    assert any("main.py" in f for f in result["files"]["code"])


def test_detect_default_does_not_auto_follow_direct_symlink_child(tmp_path):
    """Symlink directory following is explicit opt-in."""
    real_dir = tmp_path / "real_lib"
    real_dir.mkdir()
    (real_dir / "util.py").write_text("x = 1")
    (tmp_path / "linked_lib").symlink_to(real_dir)

    result = detect(tmp_path)
    assert any("real_lib" in f for f in result["files"]["code"])
    assert not any("linked_lib" in f for f in result["files"]["code"])


def test_detect_default_does_not_follow_when_no_symlinks(tmp_path):
    """Ordinary scans still walk normal directories by default."""
    (tmp_path / "main.py").write_text("x = 1")
    sub = tmp_path / "sub"
    sub.mkdir()
    (sub / "other.py").write_text("y = 2")

    result = detect(tmp_path)
    assert any("main.py" in f for f in result["files"]["code"])
    assert any("other.py" in f for f in result["files"]["code"])


def test_detect_explicit_false_overrides_auto_detect(tmp_path):
    """An explicit follow_symlinks=False skips symlinked directories."""
    real_dir = tmp_path / "real_lib"
    real_dir.mkdir()
    (real_dir / "util.py").write_text("x = 1")
    (tmp_path / "linked_lib").symlink_to(real_dir)

    # Explicit False overrides auto-detect; symlink contents must NOT appear.
    result = detect(tmp_path, follow_symlinks=False)
    assert not any("linked_lib" in f for f in result["files"]["code"])


def test_detect_skips_out_of_root_symlinked_directory_even_when_following(tmp_path):
    root = tmp_path / "root"
    root.mkdir()
    outside = tmp_path / "outside"
    outside.mkdir()
    (outside / "secret.py").write_text("token = 'outside'")
    (root / "linked_secret").symlink_to(outside)

    result = detect(root, follow_symlinks=True)

    assert not any("linked_secret" in f for f in result["files"]["code"])
    assert any("symlink target outside scan root" in item for item in result["skipped_sensitive"])


def test_detect_skips_out_of_root_symlinked_file_by_default(tmp_path):
    root = tmp_path / "root"
    root.mkdir()
    outside = tmp_path / "outside"
    outside.mkdir()
    (outside / "secret.py").write_text("token = 'outside'")
    (root / "secret_link.py").symlink_to(outside / "secret.py")

    result = detect(root)

    assert not any("secret_link.py" in f for f in result["files"]["code"])
    assert any("symlink target outside scan root" in item for item in result["skipped_sensitive"])


def test_detect_incremental_propagates_follow_symlinks(tmp_path, monkeypatch):
    """detect_incremental must forward follow_symlinks so symlinked sub-trees
    appear in incremental scans the same way they appear in full scans."""
    monkeypatch.chdir(tmp_path)

    real_dir = tmp_path / "real_corpus"
    real_dir.mkdir()
    (real_dir / "note.md").write_text("# real note\n\nsome content")
    (tmp_path / "linked_corpus").symlink_to(real_dir)

    # Store manifest inside graphify-out/ so it is pruned by _SKIP_DIRS
    # and doesn't get re-detected as a code file now that .json is indexed.
    manifest_dir = tmp_path / "graphify-out"
    manifest_dir.mkdir()
    manifest_path = str(manifest_dir / "manifest.json")

    # Without following symlinks, the symlinked dir contents are invisible.
    no_link = detect_incremental(tmp_path, manifest_path, follow_symlinks=False)
    assert not any("linked_corpus" in f for f in no_link["files"]["document"])

    # With follow_symlinks=True, the symlinked dir contents appear and are new.
    yes_link = detect_incremental(tmp_path, manifest_path, follow_symlinks=True)
    assert any("linked_corpus" in f for f in yes_link["files"]["document"])
    assert yes_link["new_total"] >= 2  # real + linked

    # After saving manifest, a second incremental scan should see no changes.
    save_manifest(yes_link["files"], manifest_path)
    second = detect_incremental(tmp_path, manifest_path, follow_symlinks=True)
    assert second["new_total"] == 0


def test_detect_incremental_survives_dict_valued_mtime(tmp_path, monkeypatch):
    """A schema-drifted manifest whose entry stores mtime as a nested dict
    (instead of a float) must not crash detect_incremental (#1163). The guard
    coerces the bad mtime to None so the file is re-verified by content hash and
    treated as new, rather than blowing up on the int/float comparison.
    """
    import json

    monkeypatch.chdir(tmp_path)

    src = tmp_path / "mod.py"
    src.write_text("def f():\n    return 1\n", encoding="utf-8")

    manifest_dir = tmp_path / "graphify-out"
    manifest_dir.mkdir()
    manifest_path = str(manifest_dir / "manifest.json")

    # Drifted entry: a non-empty ast_hash (so the dict branch reaches the mtime
    # comparison) with mtime stored as a dict rather than a float. Absolute key
    # so it matches detect's absolute file paths without re-anchoring.
    drifted = {
        str(src.resolve()): {
            "mtime": {"mtime": 123.0},
            "ast_hash": "deadbeef" * 4,
            "semantic_hash": "cafebabe" * 4,
        }
    }
    Path(manifest_path).write_text(json.dumps(drifted), encoding="utf-8")

    # Must not raise (pre-fix: TypeError comparing float and dict).
    result = detect_incremental(tmp_path, manifest_path)

    # The drifted file is re-classified as new rather than silently skipped.
    assert any("mod.py" in f for f in result["new_files"]["code"])
    assert not any("mod.py" in f for f in result["unchanged_files"]["code"])


def test_detect_incremental_legacy_float_reextracts_on_backwards_mtime(tmp_path, monkeypatch):
    """Legacy float manifests must re-extract when mtime moves BACKWARDS (#1859).

    Pre-fix the legacy branch used `current_mtime > stored`, which silently kept
    the cached entry after operations that restore older mtimes: `git checkout`
    of an older commit, `tar -xf` restore, or `rsync --times`. The graph then
    reflected the newer content while disk held the older content. The dict
    branch has always used `!=`; this test pins the legacy branch to the same
    contract.
    """
    import json

    monkeypatch.chdir(tmp_path)

    src = tmp_path / "mod.py"
    src.write_text("def old_content():\n    return 1\n", encoding="utf-8")
    current_mtime = os.stat(src).st_mtime

    manifest_dir = tmp_path / "graphify-out"
    manifest_dir.mkdir()
    manifest_path = str(manifest_dir / "manifest.json")

    # Legacy schema (pre-dict-migration): the value is a bare float mtime.
    # Store a mtime FROM THE FUTURE, simulating a checkout of an older
    # revision that restored the file to an earlier timestamp.
    future_mtime = current_mtime + 3600
    legacy = {str(src.resolve()): future_mtime}
    Path(manifest_path).write_text(json.dumps(legacy), encoding="utf-8")

    result = detect_incremental(tmp_path, manifest_path)

    assert any("mod.py" in f for f in result["new_files"]["code"]), (
        "backwards-moving mtime on a legacy manifest entry must trigger re-extract"
    )
    assert not any("mod.py" in f for f in result["unchanged_files"]["code"])


def test_detect_incremental_legacy_float_skips_when_mtime_matches(tmp_path, monkeypatch):
    """Non-regression for the fix above: legacy float branch still skips when
    the stored mtime equals the current mtime."""
    import json

    monkeypatch.chdir(tmp_path)

    src = tmp_path / "mod.py"
    src.write_text("def stable():\n    return 1\n", encoding="utf-8")

    manifest_dir = tmp_path / "graphify-out"
    manifest_dir.mkdir()
    manifest_path = str(manifest_dir / "manifest.json")

    # Legacy schema with the exact current mtime → no change → skip.
    legacy = {str(src.resolve()): os.stat(src).st_mtime}
    Path(manifest_path).write_text(json.dumps(legacy), encoding="utf-8")

    result = detect_incremental(tmp_path, manifest_path)

    assert not any("mod.py" in f for f in result["new_files"]["code"])
    assert any("mod.py" in f for f in result["unchanged_files"]["code"])


def test_classify_video_extensions():
    """Video and audio file extensions should classify as VIDEO."""
    from graphify.detect import FileType
    assert classify_file(Path("lecture.mp4")) == FileType.VIDEO
    assert classify_file(Path("podcast.mp3")) == FileType.VIDEO
    assert classify_file(Path("talk.mov")) == FileType.VIDEO
    assert classify_file(Path("recording.wav")) == FileType.VIDEO
    assert classify_file(Path("webinar.webm")) == FileType.VIDEO
    assert classify_file(Path("audio.m4a")) == FileType.VIDEO


def test_classify_google_workspace_shortcuts():
    assert classify_file(Path("notes.gdoc")) == FileType.DOCUMENT
    assert classify_file(Path("budget.gsheet")) == FileType.DOCUMENT
    assert classify_file(Path("deck.gslides")) == FileType.DOCUMENT


def test_detect_skips_google_workspace_shortcuts_by_default(tmp_path):
    (tmp_path / "notes.gdoc").write_text('{"doc_id":"doc-1"}', encoding="utf-8")

    result = detect(tmp_path)

    assert not result["files"]["document"]
    assert any("Google Workspace shortcut skipped" in item for item in result["skipped_sensitive"])


def test_detect_converts_google_workspace_shortcuts_when_enabled(tmp_path, monkeypatch):
    shortcut = tmp_path / "notes.gdoc"
    shortcut.write_text('{"doc_id":"doc-1"}', encoding="utf-8")

    def fake_convert(path, out_dir, *, xlsx_to_markdown=None, root=None):
        out_dir.mkdir(parents=True, exist_ok=True)
        out = out_dir / "notes_converted.md"
        out.write_text("# Notes\n\nA converted Google Doc.", encoding="utf-8")
        return out

    monkeypatch.setattr("graphify.detect.convert_google_workspace_file", fake_convert)

    result = detect(tmp_path, google_workspace=True)

    assert len(result["files"]["document"]) == 1
    assert result["files"]["document"][0].endswith("notes_converted.md")
    assert result["total_words"] > 0


def test_detect_includes_video_key(tmp_path):
    """detect() result always includes a 'video' key even with no video files."""
    (tmp_path / "main.py").write_text("x = 1")
    result = detect(tmp_path)
    assert "video" in result["files"]


def test_detect_finds_video_files(tmp_path):
    """detect() correctly counts video files and does not add them to word count."""
    (tmp_path / "lecture.mp4").write_bytes(b"fake video data")
    (tmp_path / "notes.md").write_text("# Notes\nSome content here.")
    result = detect(tmp_path)
    assert len(result["files"]["video"]) == 1
    assert any("lecture.mp4" in f for f in result["files"]["video"])
    # total_words should not include video files (they have no readable text)
    assert result["total_words"] >= 0  # won't crash


def test_detect_video_not_in_words(tmp_path):
    """Video files do not contribute to total_words."""
    (tmp_path / "clip.mp4").write_bytes(b"\x00" * 100)
    result = detect(tmp_path)
    # Only video file present — total_words should be 0
    assert result["total_words"] == 0


def test_detect_skips_coverage_dir(tmp_path):
    """coverage/ and lcov-report/ are noise dirs — HTML reports inside must be excluded (#870)."""
    cov = tmp_path / "coverage" / "lcov-report"
    cov.mkdir(parents=True)
    (cov / "index.html").write_text("<html>coverage report</html>")
    (cov / "src.ts.html").write_text("<html>file coverage</html>")
    (tmp_path / "main.py").write_text("def hello(): pass")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    cov_prefix = str(tmp_path / "coverage")
    assert not any(f.startswith(cov_prefix) for f in all_files)
    assert any("main.py" in f for f in all_files)


def test_detect_skips_coverage_dir_by_lcov_info(tmp_path):
    """A coverage/ dir is still pruned on any single artefact file — an lcov.info
    with no lcov-report/ subtree is enough evidence (#870, #2339)."""
    cov = tmp_path / "coverage"
    cov.mkdir()
    (cov / "lcov.info").write_text("TN:\nSF:src/app.ts\nend_of_record\n")
    (cov / "prettify.js").write_text("var PR_SHOULD_USE_CONTINUATION=true;")
    (tmp_path / "main.py").write_text("def hello(): pass")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any(f.startswith(str(cov)) for f in all_files)
    assert any("main.py" in f for f in all_files)


def test_detect_keeps_coverage_code_namespace(tmp_path):
    """#2339: a coverage/ dir holding real modules and no coverage artefacts is a
    legitimate package name, not a generated report, and must NOT be pruned.

    Pruning it by name dropped an entire production package while leaving its
    dependents in the graph, so queries kept returning plausible neighbours and
    nothing in the report or skipped lists showed the loss."""
    pkg = tmp_path / "auditor_toolkit" / "assurance" / "coverage"
    pkg.mkdir(parents=True)
    (pkg / "__init__.py").write_text("from .impact import Impact\n")
    (pkg / "impact.py").write_text("class Impact:\n    def score(self): return 1\n")
    (pkg / "inventory.py").write_text("def inventory():\n    return []\n")
    (tmp_path / "app.py").write_text("from auditor_toolkit.assurance import coverage\n")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert any("impact.py" in f for f in all_files)
    assert any("inventory.py" in f for f in all_files)
    assert any(f.endswith("coverage" + os.sep + "__init__.py") for f in all_files)


def test_collect_files_keeps_coverage_code_namespace(tmp_path):
    """#2339 as reported: collect_files returned [] for a real coverage package,
    both when it is the walk target and when it is reached through the repo root.
    A genuine report dir alongside it must still be skipped."""
    from graphify.extract import collect_files

    pkg = tmp_path / "auditor_toolkit" / "assurance" / "coverage"
    pkg.mkdir(parents=True)
    for name in ("__init__.py", "impact.py", "mapping.py"):
        (pkg / name).write_text("def f(): pass\n")

    report = tmp_path / "webapp" / "coverage"
    report.mkdir(parents=True)
    (report / "index.html").write_text("<html>coverage</html>")
    (report / "base.css").write_text("body{}")
    (report / "prettify.js").write_text("var PR=1;")

    assert sorted(p.name for p in collect_files(pkg)) == [
        "__init__.py", "impact.py", "mapping.py",
    ]
    walked = {str(p.relative_to(tmp_path)) for p in collect_files(tmp_path)}
    assert any(p.endswith("impact.py") for p in walked)
    assert not any("webapp" in p for p in walked), (
        "a generated Istanbul report dir must still be pruned (#870)"
    )


def test_is_noise_dir_coverage_is_evidence_gated(tmp_path):
    """The gate itself: name alone is not enough, and an unverifiable call
    (no parent) keeps a possibly-real code dir — same contract as env/snapshots."""
    src = tmp_path / "coverage"
    src.mkdir()
    (src / "__init__.py").write_text("")
    assert detect_mod._is_noise_dir("coverage", tmp_path) is False

    generated = tmp_path / "report" / "coverage"
    generated.mkdir(parents=True)
    (generated / "coverage-final.json").write_text("{}")
    assert detect_mod._is_noise_dir("coverage", tmp_path / "report") is True

    assert detect_mod._is_noise_dir("coverage") is False
    # lcov-report stays unconditional — no package is ever named that.
    assert detect_mod._is_noise_dir("lcov-report") is True


def test_detect_skips_visual_tests_dir(tmp_path):
    """visual-tests/ bundles and snapshots are noise — must be excluded (#869)."""
    vt = tmp_path / "visual-tests"
    vt.mkdir()
    (vt / "bundle.js").write_text("var u3=function(){};var d2=function(){}")
    (vt / "screens.tsx").write_text("export const Screen = () => <div/>")
    (tmp_path / "app.py").write_text("def main(): pass")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any("visual-tests" in f for f in all_files)
    assert any("app.py" in f for f in all_files)


def test_detect_skips_snapshots_dir(tmp_path):
    """__snapshots__/ and real jest/vitest snapshots/ dirs are artefacts — excluded."""
    (tmp_path / "__snapshots__").mkdir()
    (tmp_path / "__snapshots__" / "app.test.ts.snap").write_text("// Jest Snapshot\nexports[`test 1`] = `<div/>`")
    # a bare snapshots/ dir that actually holds .snap files is still a JS artefact
    snap = tmp_path / "snapshots"
    snap.mkdir()
    (snap / "component.test.tsx.snap").write_text("exports[`renders`] = `<span/>`")
    (tmp_path / "app.ts").write_text("export function greet() { return 'hi'; }")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any("__snapshots__" in f for f in all_files)
    assert not any(f"{os.sep}snapshots{os.sep}" in f for f in all_files)
    assert any("app.ts" in f for f in all_files)


def test_detect_keeps_snapshots_code_namespace(tmp_path):
    """#1666: a bare snapshots/ dir with no .snap files is a legit code namespace
    (e.g. Rails app/services/snapshots/) and must NOT be pruned as a JS artefact."""
    svc = tmp_path / "app" / "services" / "snapshots"
    svc.mkdir(parents=True)
    (svc / "round_reader.rb").write_text("class RoundReader\n  def call; end\nend\n")
    (svc / "backfill_marker.rb").write_text("class BackfillMarker\n  def run; end\nend\n")
    (tmp_path / "app.rb").write_text("class App; end\n")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert any("round_reader.rb" in f for f in all_files)
    assert any("backfill_marker.rb" in f for f in all_files)


def test_detect_skips_storybook_static_dir(tmp_path):
    """storybook-static/ is a build artefact — must be excluded."""
    sb = tmp_path / "storybook-static"
    sb.mkdir()
    (sb / "index.html").write_text("<html>storybook</html>")
    (sb / "main.js").write_text("(function(){var s=1;})()")
    (tmp_path / "Button.tsx").write_text("export const Button = () => <button/>")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any("storybook-static" in f for f in all_files)
    assert any("Button.tsx" in f for f in all_files)


# --- #873: dot dirs allowed, framework caches blocked ---

def test_detect_allows_github_dir(tmp_path):
    """Files inside .github/ (workflows etc.) are now indexed (#873)."""
    gh = tmp_path / ".github" / "workflows"
    gh.mkdir(parents=True)
    (gh / "ci.yml").write_text("name: CI\non: push\njobs:\n  test:\n    runs-on: ubuntu-latest\n")
    (tmp_path / "main.py").write_text("def run(): pass")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert any(".github" in f for f in all_files), "expected .github/workflows/ci.yml to be detected"


def test_detect_skips_next_cache(tmp_path):
    """.next/ (Next.js build cache) must be excluded even after dot-dir fix (#873)."""
    next_dir = tmp_path / ".next" / "cache"
    next_dir.mkdir(parents=True)
    (next_dir / "build.js").write_text("(function(){var s=1;})()")
    pages = tmp_path / "pages"
    pages.mkdir()
    (pages / "index.tsx").write_text("export default function Home() { return <div/> }")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any(".next" in f for f in all_files)
    assert any("index.tsx" in f for f in all_files)


def test_detect_skips_nox_virtualenv(tmp_path):
    """.nox/ (nox virtualenvs, tox's successor) must be excluded like .tox (#1804)."""
    nox = tmp_path / ".nox" / "tests" / "lib" / "site-packages" / "pydeck"
    nox.mkdir(parents=True)
    (nox / "widget.py").write_text("class Deck: pass")
    (tmp_path / "app.py").write_text("def go(): pass")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any(".nox" in f for f in all_files)
    assert any("app.py" in f for f in all_files)


def test_detect_honors_git_info_exclude(tmp_path):
    """.git/info/exclude (where `git worktree add` records nested worktree paths,
    and where local-only excludes live) must be honored, not just .gitignore /
    .graphifyignore — otherwise nested worktree copies get fully indexed (#1810)."""
    (tmp_path / ".git" / "info").mkdir(parents=True)
    (tmp_path / ".git" / "info" / "exclude").write_text("worktrees/\n")
    wt = tmp_path / "worktrees" / "foo"
    wt.mkdir(parents=True)
    (wt / "dupe.py").write_text("def dupe(): pass")
    (tmp_path / "real.py").write_text("def real(): pass")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any("dupe.py" in f for f in all_files), "worktree dir was not excluded"
    assert any("real.py" in f for f in all_files), "real source was dropped"


def test_git_info_exclude_ranks_below_gitignore_negation(tmp_path):
    """info/exclude is loaded at lowest priority, so a later .gitignore `!` negation
    of the same (non-directory) pattern still wins under last-match-wins (#1810)."""
    from graphify.detect import _load_graphifyignore, _is_ignored
    (tmp_path / ".git" / "info").mkdir(parents=True)
    (tmp_path / ".git" / "info" / "exclude").write_text("secret*.txt\n")
    (tmp_path / ".gitignore").write_text("!secret-ok.txt\n")
    (tmp_path / "secret-bad.txt").write_text("x")
    (tmp_path / "secret-ok.txt").write_text("x")
    patterns = _load_graphifyignore(tmp_path)
    assert _is_ignored(tmp_path / "secret-bad.txt", tmp_path, patterns)
    assert not _is_ignored(tmp_path / "secret-ok.txt", tmp_path, patterns)


def test_detect_skips_graphify_own_cache(tmp_path):
    """.graphify/ (extraction cache) must never be re-indexed as source (#873)."""
    cache = tmp_path / ".graphify" / "cache"
    cache.mkdir(parents=True)
    (cache / "abc123.json").write_text('{"nodes": [], "edges": []}')
    (tmp_path / "app.py").write_text("def go(): pass")
    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any(".graphify" in f for f in all_files)
    assert any("app.py" in f for f in all_files)


# --- #882: gitignore parent-exclusion rule for ! re-includes ---

def test_anchored_root_wildcard_negation_reincludes_subtree(tmp_path):
    """`/*` stays at the root, so `!/src/` makes the subtree walkable (#1975)."""
    for rel in ("src/app/main.py", "src/lib/util.py", "docs/guide.md", "README.md"):
        path = tmp_path / rel
        path.parent.mkdir(parents=True, exist_ok=True)
        path.write_text("x\n")
    (tmp_path / ".graphifyignore").write_text("/*\n!/src/\n")

    result = detect(tmp_path)

    files = {
        Path(path).relative_to(tmp_path).as_posix()
        for paths in result["files"].values()
        for path in paths
    }
    assert files == {"src/app/main.py", "src/lib/util.py"}


def test_anchored_negation_cannot_skip_excluded_parent(tmp_path):
    """Re-including a child cannot rescue it while its parent stays excluded."""
    victim = tmp_path / "src" / "app" / "main.py"
    victim.parent.mkdir(parents=True)
    victim.write_text("x\n")
    (tmp_path / ".graphifyignore").write_text("/*\n!/src/app/\n")

    assert detect(tmp_path)["total_files"] == 0


def test_path_pattern_single_star_does_not_cross_segment(tmp_path):
    """A regular `*` matches one component; recursive matching requires `**`."""
    direct = tmp_path / "src" / "main.py"
    nested = tmp_path / "src" / "app" / "main.py"
    nested.parent.mkdir(parents=True)
    direct.write_text("x\n")
    nested.write_text("x\n")
    for pattern in ("/src/*.py", "src/*.py"):
        (tmp_path / ".graphifyignore").write_text(f"{pattern}\n")
        result = detect(tmp_path)
        files = [path for paths in result["files"].values() for path in paths]
        assert not any(path.endswith("src/main.py") for path in files)
        assert any(path.endswith("src/app/main.py") for path in files)


def test_directory_only_negation_does_not_reinclude_file(tmp_path):
    """A trailing slash restricts a pattern to directories, as in gitignore."""
    readme = tmp_path / "README.md"
    readme.write_text("# docs\n")
    (tmp_path / ".graphifyignore").write_text("/*\n!/README.md/\n")

    assert detect(tmp_path)["total_files"] == 0


def test_anchored_double_star_crosses_path_segments(tmp_path):
    """`**` retains recursive gitignore matching at zero or more depths."""
    direct = tmp_path / "src" / "generated.py"
    nested = tmp_path / "src" / "app" / "deep" / "generated.py"
    nested.parent.mkdir(parents=True)
    direct.write_text("x\n")
    nested.write_text("x\n")
    (tmp_path / ".graphifyignore").write_text("/src/**/generated.py\n")

    assert detect(tmp_path)["total_files"] == 0

def test_negation_cannot_rescue_file_under_excluded_dir(tmp_path):
    """A ! re-include cannot un-ignore a file whose parent dir is excluded (#882)."""
    from graphify.detect import _is_ignored, _load_graphifyignore
    android = tmp_path / "android" / "app" / "src"
    android.mkdir(parents=True)
    victim = android / "Main.kt"
    victim.write_text("fun main() {}")
    (tmp_path / ".graphifyignore").write_text("android/\n!src/\n")
    patterns = _load_graphifyignore(tmp_path)
    assert _is_ignored(victim, tmp_path, patterns), (
        "android/app/src/Main.kt must remain ignored even with !src/ because "
        "the parent android/ is excluded"
    )


def test_negation_works_when_no_ancestor_excluded(tmp_path):
    """A ! re-include must still un-ignore a file when no ancestor is excluded (#882)."""
    from graphify.detect import _is_ignored, _load_graphifyignore
    src = tmp_path / "src"
    src.mkdir()
    keep = src / "keep.py"
    keep.write_text("x = 1")
    (tmp_path / ".graphifyignore").write_text("*.py\n!src/keep.py\n")
    patterns = _load_graphifyignore(tmp_path)
    assert not _is_ignored(keep, tmp_path, patterns), (
        "src/keep.py should be un-ignored by !src/keep.py since src/ itself is not excluded"
    )


def test_negation_ancestor_itself_reincluded(tmp_path):
    """If the ancestor dir itself is re-included, its children should not be blocked (#882)."""
    from graphify.detect import _is_ignored, _load_graphifyignore
    vendor = tmp_path / "vendor" / "lib"
    vendor.mkdir(parents=True)
    f = vendor / "utils.py"
    f.write_text("x = 1")
    (tmp_path / ".graphifyignore").write_text("vendor/\n!vendor/\n")
    patterns = _load_graphifyignore(tmp_path)
    # vendor/ is excluded then re-included; ancestor eval returns False so file is evaluated on its own
    assert not _is_ignored(f, tmp_path, patterns)


def test_negation_does_not_disable_directory_pruning(tmp_path, monkeypatch):
    """A single `!` re-include must not switch off pruning of *unrelated* ignored dirs.

    Regression: a blanket ``has_negation`` flag used to disable directory-level pruning
    for EVERY ignored dir whenever any ``!`` pattern existed, so a single ``!docs/**``
    made os.walk descend bin/, obj/, wwwroot/, generated/, … — a pathological slowdown
    on large repos. Output stayed correct (the per-file ``_is_ignored`` filter still
    excluded those files), so this guards the *walk* itself: the ignored dir must never
    be descended, while the negation must still re-include its target.
    """
    import os
    import graphify.detect as det

    (tmp_path / ".graphifyignore").write_text("myignored/\n*.md\n!docs/**\n")
    deep = tmp_path / "myignored" / "deep" / "deeper"
    deep.mkdir(parents=True)
    (deep / "junk.py").write_text("x = 1")
    (tmp_path / "docs").mkdir()
    (tmp_path / "docs" / "guide.md").write_text("# guide")
    (tmp_path / "src").mkdir()
    (tmp_path / "src" / "app.py").write_text("y = 2")

    visited: list[str] = []
    real_walk = os.walk

    def tracking_walk(top, *args, **kwargs):
        for dirpath, dirnames, filenames in real_walk(top, *args, **kwargs):
            visited.append(dirpath)
            yield dirpath, dirnames, filenames

    monkeypatch.setattr(det.os, "walk", tracking_walk)
    result = det.detect(tmp_path)

    # The ignored (non-noise) dir must never be descended, despite the !docs/** negation.
    assert not any("myignored" in Path(v).parts for v in visited), (
        "ignored 'myignored/' was walked despite being ignored — the has_negation bypass regressed"
    )
    # Detection itself is unaffected: negation still re-includes docs/*.md, real source is
    # found, and nothing leaks out of the ignored dir.
    all_files = [p for cat in result["files"].values() for p in cat]
    assert any(p.endswith("app.py") for p in all_files)
    assert any(p.endswith("guide.md") for p in all_files)
    assert not any("junk.py" in p for p in all_files)


# Regression tests for #1087 - anchored patterns must not match basename deep in tree

def test_anchored_dir_not_matched_at_depth(tmp_path):
    """/inbox/ must not match src/inbox/ — only inbox/ at the anchor root."""
    from graphify.detect import _is_ignored, _load_graphifyignore
    src_inbox = tmp_path / "src" / "inbox"
    src_inbox.mkdir(parents=True)
    f = src_inbox / "main.rs"
    f.write_text("fn main() {}")
    (tmp_path / ".graphifyignore").write_text("/inbox/\n")
    patterns = _load_graphifyignore(tmp_path)
    assert not _is_ignored(f, tmp_path, patterns), (
        "src/inbox/main.rs must NOT be ignored by /inbox/ — the pattern is anchored to root"
    )
    assert not _is_ignored(src_inbox, tmp_path, patterns), (
        "src/inbox/ must NOT be ignored by /inbox/ — the pattern is anchored to root"
    )


def test_anchored_dir_matches_at_root(tmp_path):
    """/inbox/ must still match inbox/ at the anchor root (positive case)."""
    from graphify.detect import _is_ignored, _load_graphifyignore
    inbox = tmp_path / "inbox"
    inbox.mkdir()
    f = inbox / "data.json"
    f.write_text("{}")
    (tmp_path / ".graphifyignore").write_text("/inbox/\n")
    patterns = _load_graphifyignore(tmp_path)
    assert _is_ignored(f, tmp_path, patterns), (
        "inbox/data.json must be ignored by /inbox/"
    )
    assert _is_ignored(inbox, tmp_path, patterns), (
        "inbox/ must be ignored by /inbox/"
    )


def test_anchored_file_not_matched_at_depth(tmp_path):
    """/build must not match src/build."""
    from graphify.detect import _is_ignored, _load_graphifyignore
    src_build = tmp_path / "src" / "build"
    src_build.mkdir(parents=True)
    (tmp_path / ".graphifyignore").write_text("/build\n")
    patterns = _load_graphifyignore(tmp_path)
    assert not _is_ignored(src_build, tmp_path, patterns), (
        "src/build must NOT be ignored by /build"
    )


def test_unanchored_dir_still_matches_at_depth(tmp_path):
    """inbox/ (no leading /) must still match src/inbox/ anywhere in the tree."""
    from graphify.detect import _is_ignored, _load_graphifyignore
    src_inbox = tmp_path / "src" / "inbox"
    src_inbox.mkdir(parents=True)
    f = src_inbox / "main.rs"
    f.write_text("fn main() {}")
    (tmp_path / ".graphifyignore").write_text("inbox/\n")
    patterns = _load_graphifyignore(tmp_path)
    assert _is_ignored(f, tmp_path, patterns), (
        "src/inbox/main.rs must be ignored by unanchored inbox/"
    )


def test_anchored_multi_segment_pattern(tmp_path):
    """/src/inbox/ must match src/inbox/ but not x/src/inbox/."""
    from graphify.detect import _is_ignored, _load_graphifyignore
    (tmp_path / "src" / "inbox").mkdir(parents=True)
    (tmp_path / "x" / "src" / "inbox").mkdir(parents=True)
    target_ok = tmp_path / "src" / "inbox" / "a.py"
    target_ok.write_text("x=1")
    target_bad = tmp_path / "x" / "src" / "inbox" / "b.py"
    target_bad.write_text("x=1")
    (tmp_path / ".graphifyignore").write_text("/src/inbox/\n")
    patterns = _load_graphifyignore(tmp_path)
    assert _is_ignored(target_ok, tmp_path, patterns), (
        "src/inbox/a.py must be ignored by /src/inbox/"
    )
    assert not _is_ignored(target_bad, tmp_path, patterns), (
        "x/src/inbox/b.py must NOT be ignored by /src/inbox/"
    )


def test_detect_does_not_ignore_scan_root_itself_via_parent_gitignore(tmp_path):
    """If a parent `.gitignore` (at the repo root) ignores the directory being scanned
    (the scan root itself), files inside the scan root must not be ignored (#2468)."""
    (tmp_path / ".git").mkdir()

    corpus_dir = tmp_path / "graphify-corpus"
    corpus_dir.mkdir()

    (corpus_dir / "keep.py").write_text("x = 1\n", encoding="utf-8")
    
    docs_dir = corpus_dir / "docs"
    docs_dir.mkdir()
    (docs_dir / "intro.md").write_text("# Introduction\n", encoding="utf-8")

    (tmp_path / ".gitignore").write_text("graphify-corpus/\n", encoding="utf-8")

    result = detect(corpus_dir)

    all_files = [Path(f) for files in result["files"].values() for f in files]
    file_names = {f.name for f in all_files}

    assert result["total_files"] == 2
    assert "keep.py" in file_names
    assert "intro.md" in file_names


def test_detect_preserves_unrelated_parent_ignores_inside_scan_root(tmp_path):
    """A parent `.gitignore` should still ignore unrelated directories (like `node_modules/`)
    inside the scan root, even while the scan root itself is not ignored (#2468)."""
    (tmp_path / ".git").mkdir()

    corpus_dir = tmp_path / "graphify-corpus"
    corpus_dir.mkdir()

    (corpus_dir / "keep.py").write_text("x = 1\n", encoding="utf-8")
    
    docs_dir = corpus_dir / "docs"
    docs_dir.mkdir()
    (docs_dir / "intro.md").write_text("# Introduction\n", encoding="utf-8")

    node_modules_dir = corpus_dir / "node_modules"
    node_modules_dir.mkdir()
    (node_modules_dir / "lib.js").write_text("console.log(1);\n", encoding="utf-8")

    # Parent .gitignore ignoring the scan root itself AND node_modules/
    (tmp_path / ".gitignore").write_text("graphify-corpus/\nnode_modules/\n", encoding="utf-8")

    result = detect(corpus_dir)

    all_files = [Path(f) for files in result["files"].values() for f in files]
    file_names = {f.name for f in all_files}

    assert result["total_files"] == 2
    assert "keep.py" in file_names
    assert "intro.md" in file_names
    assert "lib.js" not in file_names


# Tests for #1235 - memoise _is_ignored/_eval results via a per-detect() cache

def test_is_ignored_cache_matches_uncached_results(tmp_path):
    """A shared _cache must not change _is_ignored results, including negation.

    Builds a tree with a normal ignore pattern and a negation pattern, then
    asserts that evaluating every path with a cache yields identical results
    to evaluating without one (#1235).
    """
    from graphify.detect import _is_ignored, _load_graphifyignore

    # Normal pattern: ignore everything under build/.
    # Negation pattern: re-include logs/keep.log even though *.log is ignored.
    (tmp_path / "build" / "sub").mkdir(parents=True)
    (tmp_path / "logs").mkdir()
    (tmp_path / "src").mkdir()
    paths = [
        tmp_path / "build",
        tmp_path / "build" / "out.o",
        tmp_path / "build" / "sub",
        tmp_path / "build" / "sub" / "deep.o",
        tmp_path / "logs",
        tmp_path / "logs" / "drop.log",
        tmp_path / "logs" / "keep.log",
        tmp_path / "src" / "main.py",
    ]
    for p in paths:
        if p.suffix:
            p.write_text("x")
    (tmp_path / ".graphifyignore").write_text(
        "build/\n*.log\n!logs/keep.log\n"
    )
    patterns = _load_graphifyignore(tmp_path)

    cache: dict = {}
    for p in paths:
        uncached = _is_ignored(p, tmp_path, patterns)
        cached = _is_ignored(p, tmp_path, patterns, _cache=cache)
        assert cached == uncached, (
            f"cached result for {p} ({cached}) differs from uncached ({uncached})"
        )

    # Sanity: the negation actually fired so the test exercises a non-trivial case.
    assert not _is_ignored(tmp_path / "logs" / "keep.log", tmp_path, patterns)
    assert _is_ignored(tmp_path / "logs" / "drop.log", tmp_path, patterns)


def test_is_ignored_cache_evaluates_each_dir_once():
    """Siblings under the same subtree must share the cached parent result (#1235).

    Counts how many times each unique target path is evaluated through the
    cache: every directory (ancestor) should be evaluated exactly once across
    a multi-file subtree rather than once per descendant file.
    """
    from graphify.detect import _is_ignored

    root = Path("/repo")
    patterns = [(root, "*.tmp")]  # non-empty so _eval runs

    # A subtree where many files share the same ancestor directories.
    files = [
        root / "a" / "b" / "f1.py",
        root / "a" / "b" / "f2.py",
        root / "a" / "b" / "f3.py",
        root / "a" / "c" / "f4.py",
        root / "a" / "c" / "f5.py",
    ]

    eval_counts: dict[Path, int] = {}

    # A dict subclass records every cache write. Since _eval writes to the
    # cache exactly once per computed target (and reads short-circuit before
    # any write), one write == one evaluation of that path.
    class CountingCache(dict):
        def __setitem__(self, key, value):
            eval_counts[key] = eval_counts.get(key, 0) + 1
            super().__setitem__(key, value)

    cache = CountingCache()
    for f in files:
        _is_ignored(f, root, patterns, _cache=cache)

    # Each unique path (files + ancestor dirs) must be computed exactly once.
    for target, count in eval_counts.items():
        assert count == 1, f"{target} evaluated {count} times, expected 1 (cache miss)"

    # Shared ancestors must be present and counted only once each.
    assert eval_counts[root / "a"] == 1
    assert eval_counts[root / "a" / "b"] == 1
    assert eval_counts[root / "a" / "c"] == 1
    # All five distinct files are computed once each.
    for f in files:
        assert eval_counts[f] == 1


# Regression tests for #920 - sensitive pattern misses underscore-prefixed names
def test_sensitive_flags_api_token_txt():
    assert _is_sensitive(Path("api_token.txt"))

def test_sensitive_flags_oauth_token_json():
    assert _is_sensitive(Path("oauth_token.json"))

def test_sensitive_flags_underscore_secret():
    assert _is_sensitive(Path("app_secret.yaml"))

def test_sensitive_does_not_flag_tokenizer_py():
    assert not _is_sensitive(Path("tokenizer.py"))

def test_sensitive_does_not_flag_tokenize_py():
    assert not _is_sensitive(Path("tokenize.py"))

def test_sensitive_does_not_flag_passwords_py():
    # #1666: a programming-language source file named after a domain noun is a
    # module, not a secret store. Silently dropping it hid real code from the graph.
    # Genuine secret stores are .env/.pem/credentials.json etc. (still flagged below).
    assert not _is_sensitive(Path("passwords.py"))


def test_sensitive_does_not_flag_ruby_code_modules():
    # #1666 exact cases: Rails source modules with keyword-ish names must survive.
    assert not _is_sensitive(Path("app/models/device_token.rb"))
    assert not _is_sensitive(Path("app/controllers/api/v1/passwords_controller.rb"))


def test_sensitive_still_flags_data_secret_stores():
    # #1666 guard: the exemption is ONLY for real source code, not data/config
    # formats — credentials.json / oauth_token.json / secrets.yaml are the secret
    # stores Stage 3 must keep catching (even though .json routes through CODE).
    assert _is_sensitive(Path("credentials.json"))
    assert _is_sensitive(Path("oauth_token.json"))
    assert _is_sensitive(Path("app_secret.yaml"))

def test_sensitive_flags_ssh_dir():
    assert _is_sensitive(Path("/home/user/.ssh/id_rsa"))

def test_sensitive_flags_secrets_dir():
    assert _is_sensitive(Path("config/secrets/db.json"))

def test_sensitive_flags_token_txt():
    assert _is_sensitive(Path("token.txt"))

def test_sensitive_flags_credentials_json():
    assert _is_sensitive(Path("credentials.json"))

def test_sensitive_does_not_flag_root_file_named_credentials():
    # A root-level file called "credentials" (no parent dir named credentials)
    # must NOT be flagged by Stage 1; Stage 2 name-pattern check catches it instead.
    # Specifically: Path("credentials").parts == ('credentials',) which is parts[:-1] == ()
    # so the dir check passes. The name pattern for "credential" then picks it up.
    # What we are asserting here is that the Stage 1 check uses parts[:-1], not parts.
    p = Path("credentials")
    # The name pattern WILL match "credentials" (it's a sensitive name), but the
    # false-flag we fixed was Stage 1 matching on the filename itself as a "dir".
    # Verify the whole function still returns True (via name pattern, not dir check).
    assert _is_sensitive(p)

def test_sensitive_secret_handler_txt():
    # Both patterns now use (?![a-zA-Z]) so underscore after keyword is allowed.
    # "secret_handler.txt": "secret" followed by "_" (not alpha) → flagged.
    assert _is_sensitive(Path("secret_handler.txt"))

def test_sensitive_token_config_yaml():
    # "token_config.yaml": "token" followed by "_" (not alpha) → flagged.
    assert _is_sensitive(Path("token_config.yaml"))


# ── #1943: Stage 1 dir check gets the same source carve-out as Stage 3 ──
# secrets/ and credentials/ are as often real source packages (Go
# internal/secrets, a credentials/ service module) as credential stores.
# Genuine programming-language source beneath them must be graphed; data and
# config formats — the formats credentials actually ship in — stay dropped,
# and dedicated credential-store dirs (.ssh, .gnupg, .aws, .gcloud) keep
# dropping everything with no carve-out.

def test_sensitive_does_not_flag_source_under_secrets_dir():
    # #1943 exact cases: real source under ambiguous dir names survives.
    assert not _is_sensitive(Path("internal/secrets/vault.go"))
    assert not _is_sensitive(Path("app/services/credentials/manager.py"))

def test_sensitive_still_flags_data_under_secrets_dir():
    # #1943 guard: the carve-out is ONLY for real source — data/config files
    # under ambiguous dirs remain flagged, whatever their nesting depth.
    assert _is_sensitive(Path("secrets/db.json"))
    assert _is_sensitive(Path(".secrets/token.yaml"))
    assert _is_sensitive(Path("deploy/credentials/prod.env"))
    assert _is_sensitive(Path("internal/secrets/README.md"))  # docs are not source

def test_sensitive_flags_everything_under_credential_store_dirs():
    # #1943: dedicated stores get no carve-out — even source-classified files
    # inside .ssh/.gnupg/.aws/.gcloud stay dropped.
    assert _is_sensitive(Path("/home/user/.ssh/config"))
    assert _is_sensitive(Path(".aws/credentials"))
    assert _is_sensitive(Path(".gnupg/helper.py"))
    assert _is_sensitive(Path("backup/.gcloud/sync.sh"))

def test_sensitive_dir_carveout_does_not_bypass_name_screens():
    # #1943: rescued source still falls through to Stages 2-3, so a NON-source
    # file whose name/extension is sensitive stays dropped even though the dir
    # carve-out spared genuine source beside it.
    assert _is_sensitive(Path("credentials/id_rsa"))           # extensionless key
    assert _is_sensitive(Path("secrets/deploy.pem"))           # Stage 2 extension
    # #2106: `service_account.py` is real source (e.g. Google's oauth2 lib), not a
    # secret. The old unbounded `service.account` substring wrongly dropped it;
    # it is now indexed. A downloaded `service-account.json` key still drops.
    assert not _is_sensitive(Path("secrets/service_account.py"))


def test_sensitive_dir_carveout_still_drops_tfvars_values_store():
    # #1943 follow-up: genuine source under secrets/ is rescued, but .tfvars is
    # Terraform's canonical values store (real secrets), not source — it stays
    # dropped, while the real code file beside it is kept.
    assert _is_sensitive(Path("secrets/prod.tfvars"))
    assert not _is_sensitive(Path("secrets/loader.py"))
    # .tf / .hcl are genuine infra source and remain graphable under secrets/.
    assert not _is_sensitive(Path("secrets/main.tf"))


# ── Generic keywords must be load-bearing: topic slugs are not secret stores ──
# A keyword buried mid-phrase in a >=3-word descriptive name is a note ABOUT
# the topic, not a credential file. It must not be silently dropped.

def test_sensitive_does_not_flag_token_economics_note():
    assert not _is_sensitive(Path("token-economics-of-recall.md"))

def test_sensitive_does_not_flag_password_policy_discussion():
    assert not _is_sensitive(Path("password-policy-discussion.md"))

def test_sensitive_flags_keyword_at_end_of_long_name():
    # Keyword as the final word names the file's contents — still a secret store.
    assert _is_sensitive(Path("github-personal-access-token.txt"))

def test_sensitive_flags_my_private_key_txt():
    # Multi-word keyword at end of stem (end-of-stem check runs before word
    # counting, so splitting private_key on "_" cannot un-flag it).
    assert _is_sensitive(Path("my_private_key.txt"))

def test_sensitive_flags_dotfile_token():
    # Leading dot stripped before stem extraction; ".token" keeps its keyword.
    assert _is_sensitive(Path(".token"))

def test_sensitive_flags_plural_tokens_txt():
    assert _is_sensitive(Path("tokens.txt"))


# ── Issue #933: failed-chunk files must not be frozen in manifest ─────────────

def test_save_manifest_skips_semantic_hash_for_files_without_cache(tmp_path):
    """Files in failed chunks have no semantic cache entry; save_manifest must
    leave their semantic_hash empty so detect_incremental re-queues them (#933)."""
    import json
    from graphify.cache import save_cached

    doc1 = tmp_path / "docs" / "a.md"
    doc2 = tmp_path / "docs" / "b.md"
    doc1.parent.mkdir()
    doc1.write_text("# A\n\ncontent a")
    doc2.write_text("# B\n\ncontent b")

    # Simulate: doc1's chunk succeeded (has a cache entry), doc2's chunk failed (no entry).
    save_cached(doc1, {"nodes": [{"id": "a", "source_file": str(doc1)}], "edges": [], "hyperedges": []}, root=tmp_path, kind="semantic")
    # doc2: no cache entry written

    files = {"document": [str(doc1), str(doc2)]}
    manifest_path = str(tmp_path / "manifest.json")

    # Simulate what __main__.py now does: only include files with semantic output.
    sem_extracted = {str(doc1)}  # doc2 not present — failed chunk
    sem_types = {"document", "paper", "image"}
    safe_files = {
        ftype: [f for f in flist if ftype not in sem_types or f in sem_extracted]
        for ftype, flist in files.items()
    }
    save_manifest(safe_files, manifest_path)

    manifest = json.loads(Path(manifest_path).read_text())
    assert str(doc1) in manifest, "successful file must be in manifest"
    assert manifest[str(doc1)]["semantic_hash"] != "", "successful file must have semantic_hash"
    assert str(doc2) not in manifest, "failed-chunk file must be absent from manifest"


def test_save_manifest_clear_semantic_erases_stale_hash_for_omitted_file(tmp_path):
    """#1948: a file stamped in an earlier run, then omitted from ``files`` on
    a later run (LLM dropped its chunk / #1890 retry), must not keep surviving
    with its stale semantic_hash from the prior run — the seed loop copies
    the on-disk row verbatim otherwise, and detect_incremental(kind='semantic')
    reports it unchanged, silently defeating the #1890 retry promise."""
    import json

    doc = tmp_path / "docs" / "doc.md"
    doc.parent.mkdir()
    doc.write_text("# Doc\n\ncontent")
    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")

    # Run 1: doc.md is dispatched and stamped.
    corpus = {str(doc)}
    save_manifest({"document": [str(doc)]}, manifest_path, root=tmp_path, scan_corpus=corpus)
    manifest = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert manifest["docs/doc.md"]["semantic_hash"] != ""

    # Run 2 (--force re-run): the model omits doc.md this time, so cli.py's
    # _stamped_manifest_files() drops it from the files dict passed here —
    # but it was still dispatched, so the caller passes it via clear_semantic.
    save_manifest(
        {"document": []}, manifest_path, root=tmp_path,
        scan_corpus=corpus, clear_semantic={str(doc)},
    )
    manifest = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert manifest["docs/doc.md"]["semantic_hash"] == "", (
        "omitted file must have its stale semantic_hash cleared, not inherited"
    )

    inc = detect_incremental(tmp_path, manifest_path, kind="semantic")
    assert [Path(f).name for f in inc["new_files"]["document"]] == ["doc.md"], (
        "cleared file must be re-queued for semantic extraction"
    )


def test_save_manifest_clear_ast_blanks_both_hashes_for_failed_extra(tmp_path):
    """#2543: AST failure (missing optional extra) must blank both hashes so
    the next extract re-queues the file without deleting graphify-out/."""
    import json

    sql = tmp_path / "schema.sql"
    sql.write_text("CREATE TABLE users (id INT);\n")
    py = tmp_path / "main.py"
    py.write_text("def main():\n    return 1\n")
    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
    corpus = {str(sql), str(py)}

    # Run 1: both files stamped as if a prior full extract succeeded.
    save_manifest(
        {"code": [str(sql), str(py)]},
        manifest_path,
        root=tmp_path,
        scan_corpus=corpus,
    )
    manifest = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert manifest["schema.sql"]["ast_hash"] != ""
    assert manifest["schema.sql"]["semantic_hash"] != ""
    assert manifest["main.py"]["ast_hash"] != ""

    # Run 2: sql fails (missing extra) — omitted from stamped files, listed in clear_ast.
    save_manifest(
        {"code": [str(py)]},
        manifest_path,
        root=tmp_path,
        scan_corpus=corpus,
        clear_ast={str(sql)},
    )
    manifest = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert manifest["schema.sql"]["ast_hash"] == "", "failed AST source must lose ast_hash"
    assert manifest["schema.sql"]["semantic_hash"] == "", "failed AST source must lose semantic_hash"
    assert manifest["main.py"]["ast_hash"] != "", "successful code must keep its stamp"

    inc = detect_incremental(tmp_path, manifest_path, kind="semantic")
    new_names = {Path(f).name for f in inc["new_files"].get("code", [])}
    assert "schema.sql" in new_names, "failed-extra file must be re-queued"
    assert "main.py" not in new_names, "unchanged successful code must stay warm"


def test_save_manifest_without_filter_unchanged_for_code(tmp_path):
    """Code files must be stamped in the manifest regardless of semantic cache."""
    import json

    py = tmp_path / "main.py"
    py.write_text("print('hello')")

    files = {"code": [str(py)]}
    manifest_path = str(tmp_path / "manifest.json")
    save_manifest(files, manifest_path)

    manifest = json.loads(Path(manifest_path).read_text())
    assert str(py) in manifest
    assert manifest[str(py)]["ast_hash"] != ""
# Regression tests for #945 - .gitignore fallback when no .graphifyignore exists

def test_gitignore_fallback_when_no_graphifyignore(tmp_path):
    """When no .graphifyignore exists, .gitignore patterns are honored (#945)."""
    (tmp_path / ".git").mkdir()
    (tmp_path / ".gitignore").write_text("vendor/\n*.generated.py\n")
    vendor = tmp_path / "vendor"
    vendor.mkdir()
    (vendor / "lib.py").write_text("x = 1")
    (tmp_path / "main.py").write_text("print('hi')")
    (tmp_path / "schema.generated.py").write_text("x = 1")

    result = detect(tmp_path)
    code = result["files"]["code"]
    assert any("main.py" in f for f in code)
    assert not any("vendor" in f for f in code)
    assert not any("generated" in f for f in code)


def test_graphifyignore_and_gitignore_are_merged(tmp_path):
    """When both exist, their patterns are MERGED — a file excluded only by
    .gitignore stays excluded even though .graphifyignore says nothing about it
    (#1363). Previously the presence of a .graphifyignore silently disabled the
    dir's .gitignore, leaking gitignore-only secrets into the graph."""
    (tmp_path / ".git").mkdir()
    (tmp_path / ".gitignore").write_text("main.py\n")        # gitignore-only exclusion
    (tmp_path / ".graphifyignore").write_text("other.py\n")  # says nothing about main.py
    (tmp_path / "main.py").write_text("x = 1")
    (tmp_path / "other.py").write_text("x = 2")
    (tmp_path / "keep.py").write_text("x = 3")

    result = detect(tmp_path)
    code = result["files"]["code"]
    assert not any("main.py" in f for f in code)   # gitignore STILL applied (merged)
    assert not any("other.py" in f for f in code)  # graphifyignore applied
    assert any("keep.py" in f for f in code)       # neither excludes it


def test_graphifyignore_negation_overrides_gitignore(tmp_path):
    """.graphifyignore is evaluated after .gitignore, so a `!` negation in it can
    re-include a file the .gitignore excluded (last-match-wins, #1363)."""
    (tmp_path / ".git").mkdir()
    (tmp_path / ".gitignore").write_text("*.py\n")           # exclude all .py
    (tmp_path / ".graphifyignore").write_text("!keep.py\n")  # but rescue keep.py
    (tmp_path / "main.py").write_text("x = 1")
    (tmp_path / "keep.py").write_text("x = 2")

    result = detect(tmp_path)
    code = result["files"]["code"]
    assert any("keep.py" in f for f in code)      # rescued by graphifyignore negation
    assert not any("main.py" in f for f in code)  # still excluded


# Regression tests for #947 - .worktrees/ skipped and --exclude flag

def test_detect_skips_worktrees_dir(tmp_path):
    """Files inside .worktrees/ are never indexed (#947)."""
    wt = tmp_path / ".worktrees" / "feature-branch"
    wt.mkdir(parents=True)
    (wt / "main.py").write_text("x = 1")
    (tmp_path / "app.py").write_text("y = 2")

    result = detect(tmp_path)
    code = result["files"]["code"]
    assert any("app.py" in f for f in code)
    assert not any(".worktrees" in f for f in code)


def test_detect_skips_nested_worktrees_dir(tmp_path):
    """Files inside .claude/worktrees/ (nested placement) are never indexed (#1023)."""
    wt = tmp_path / ".claude" / "worktrees" / "feature-branch"
    wt.mkdir(parents=True)
    (wt / "main.py").write_text("x = 1")
    (tmp_path / "app.py").write_text("y = 2")

    result = detect(tmp_path)
    code = result["files"]["code"]
    assert any("app.py" in f for f in code)
    assert not any("worktrees" in f for f in code)


def test_detect_extra_excludes_pattern(tmp_path):
    """extra_excludes patterns exclude matching files from detect() (#947)."""
    (tmp_path / "main.py").write_text("x = 1")
    (tmp_path / "secret.py").write_text("API_KEY = 'abc'")
    subdir = tmp_path / "legacy"
    subdir.mkdir()
    (subdir / "old.py").write_text("y = 2")

    result = detect(tmp_path, extra_excludes=["secret.py", "legacy/"])
    code = result["files"]["code"]
    assert any("main.py" in f for f in code)
    assert not any("secret.py" in f for f in code)
    assert not any("legacy" in f for f in code)


# ---------------------------------------------------------------------------
# Shebang interpreter parsing
# ---------------------------------------------------------------------------

def test_shebang_interpreter_plain(tmp_path):
    """Plain shebang returns the interpreter basename."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "plain"
    script.write_bytes(b"#!/usr/bin/python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"


def test_shebang_interpreter_env_single_arg(tmp_path):
    """`#!/usr/bin/env python3` returns the interpreter, not 'env'."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_single"
    script.write_bytes(b"#!/usr/bin/env python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"


def test_shebang_interpreter_env_dash_s(tmp_path):
    """`#!/usr/bin/env -S python3 -u` (-S split-args form) recovers the interpreter."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_dashs"
    script.write_bytes(b"#!/usr/bin/env -S python3 -u\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"


def test_shebang_interpreter_env_with_flags(tmp_path):
    """`#!/usr/bin/env -i bash` skips env flags and resolves to the interpreter."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_flags"
    script.write_bytes(b"#!/usr/bin/env -i bash\necho hi\n")
    assert _shebang_interpreter(script) == "bash"


def test_shebang_interpreter_env_with_assignment(tmp_path):
    """`#!/usr/bin/env DEBUG=1 python3` skips var=value assignments."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_assign"
    script.write_bytes(b"#!/usr/bin/env DEBUG=1 python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"


def test_shebang_interpreter_no_shebang(tmp_path):
    """File without shebang returns None."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "no_shebang"
    script.write_bytes(b"print('x')\n")
    assert _shebang_interpreter(script) is None


def test_shebang_interpreter_quoted_path(tmp_path):
    """Quoted interpreter path with spaces parses correctly via shlex."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "quoted"
    # Note: actual `#!` on disk wouldn't permit a quoted path on most kernels,
    # but shlex must not crash and should produce a reasonable answer
    script.write_bytes(b'#!"/usr/local/bin/python3"\nprint("x")\n')
    assert _shebang_interpreter(script) == "python3"


def test_shebang_file_type_classifies_via_interpreter(tmp_path):
    """Classify file type via interpreter, including env -S form."""
    script = tmp_path / "tool"
    script.write_bytes(b"#!/usr/bin/env -S python3 -u\nprint('x')\n")
    # No extension, must be classified via shebang
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_unreadable_returns_none(tmp_path):
    """Unreadable / nonexistent files return None, never raise."""
    from graphify.detect import _shebang_interpreter
    missing = tmp_path / "does_not_exist"
    assert _shebang_interpreter(missing) is None


def test_shebang_interpreter_env_unset_with_operand(tmp_path):
    """`env -u VAR python3` skips both -u and its required operand."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_unset"
    script.write_bytes(b"#!/usr/bin/env -u PYTHONPATH python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_chdir_with_operand(tmp_path):
    """`env -C /tmp python3` skips both -C and its workdir operand."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_chdir"
    script.write_bytes(b"#!/usr/bin/env -C /tmp python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_path_with_operand(tmp_path):
    """`env -P /bin python3` skips both -P and its utilpath operand."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_path"
    script.write_bytes(b"#!/usr/bin/env -P /bin python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_dash_s_after_flag(tmp_path):
    """`env -i -S "python3 -u"` handles -S after another env flag."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_flag_dash_s"
    script.write_bytes(b'#!/usr/bin/env -i -S "python3 -u"\nprint("x")\n')
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_clumped_u_operand(tmp_path):
    """Clumped `-uPYTHONPATH` form (no space between flag and operand) is one arg."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_clumped"
    script.write_bytes(b"#!/usr/bin/env -uPYTHONPATH python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_missing_operand_returns_none(tmp_path):
    """`env -u` with no operand → not a valid command, return None."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_missing_op"
    script.write_bytes(b"#!/usr/bin/env -u\n")
    assert _shebang_interpreter(script) is None


def test_shebang_interpreter_env_gnu_split_string_equals(tmp_path):
    """GNU `--split-string='python3 -u'` (with `=` operand) → python3."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_split_eq"
    script.write_bytes(b"#!/usr/bin/env --split-string='python3 -u'\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_gnu_split_string_separate(tmp_path):
    """GNU `--split-string "python3 -u"` (separate operand) → python3."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_split_sep"
    script.write_bytes(b'#!/usr/bin/env --split-string "python3 -u"\nprint("x")\n')
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_gnu_argv0_operand(tmp_path):
    """GNU `-a alias python3` skips both -a and its argv0 operand."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_argv0"
    script.write_bytes(b"#!/usr/bin/env -a alias python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_compact_dash_s(tmp_path):
    """Compact `-Spython3 -u` form (no space between -S and packed string)."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_compact_dash_s"
    script.write_bytes(b"#!/usr/bin/env -Spython3 -u\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_compact_v_then_s(tmp_path):
    """Compact `-vSpython3` (-v plus compact -S)."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_compact_vs"
    script.write_bytes(b"#!/usr/bin/env -vSpython3 -u\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_long_unset_separate_operand(tmp_path):
    """GNU `--unset PYTHONPATH python3` (separate operand)."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_long_unset"
    script.write_bytes(b"#!/usr/bin/env --unset PYTHONPATH python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_long_unset_equals(tmp_path):
    """GNU `--unset=PYTHONPATH python3` (`=` operand form)."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_long_unset_eq"
    script.write_bytes(b"#!/usr/bin/env --unset=PYTHONPATH python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_long_chdir_separate_operand(tmp_path):
    """GNU `--chdir /tmp python3` (separate operand)."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_long_chdir"
    script.write_bytes(b"#!/usr/bin/env --chdir /tmp python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_long_chdir_equals(tmp_path):
    """GNU `--chdir=/tmp python3` (`=` operand form)."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_long_chdir_eq"
    script.write_bytes(b"#!/usr/bin/env --chdir=/tmp python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_signal_flags(tmp_path):
    """GNU signal-handling flags skip transparently."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_signal"
    script.write_bytes(b"#!/usr/bin/env --default-signal=TERM --ignore-signal=PIPE python3\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_unknown_option_returns_none(tmp_path):
    """Unknown hyphen-prefixed env option → return None rather than guessing."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_unknown"
    script.write_bytes(b"#!/usr/bin/env --no-such-flag python3\n")
    # Must refuse to guess: if we can't classify the option, we can't trust
    # that the next token is the interpreter. Safer to return None.
    assert _shebang_interpreter(script) is None


def test_shebang_interpreter_env_dash_s_assignment_before_interpreter(tmp_path):
    """`-S` payload may carry NAME=value assignments before the interpreter."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_s_assignment"
    script.write_bytes(
        b"#!/usr/bin/env -S PYTHONPATH=/opt/custom:${PYTHONPATH} python3\n"
        b"print('x')\n"
    )
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_dash_s_flag_before_interpreter(tmp_path):
    """`-S` payload may carry env flags (e.g. -i) before the interpreter."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_s_flag"
    script.write_bytes(b"#!/usr/bin/env -S -i OLDUSER=${USER} python3\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_long_split_assignment_before_interpreter(tmp_path):
    """`--split-string=` payload may carry assignments before the interpreter."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_long_split_assignment"
    script.write_bytes(
        b"#!/usr/bin/env --split-string='PYTHONPATH=/opt/custom:${PYTHONPATH} python3 -u'\n"
        b"print('x')\n"
    )
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_long_split_flag_before_interpreter(tmp_path):
    """`--split-string=` payload may carry env flags before the interpreter."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_long_split_flag"
    script.write_bytes(b"#!/usr/bin/env --split-string='-i python3 -u'\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


def test_shebang_interpreter_env_nested_split_string_rejected(tmp_path):
    """A `-S` payload that itself starts with `-S` is rejected (allow_split=False
    on the recursive call bounds the recursion depth at one). Without this guard,
    a malicious or strange shebang could spin the parser indefinitely."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_nested_split"
    # Outer -S splits into ["-S", "python3", "-u"]; inner -S is treated as an
    # unknown option in the recursed pass, so we get None (refuse to guess).
    script.write_bytes(b"#!/usr/bin/env -S -S python3 -u\nprint('x')\n")
    assert _shebang_interpreter(script) is None


def test_shebang_interpreter_env_vs_assignment_before_interpreter(tmp_path):
    """`-vS` packed payload also re-parses for leading assignments."""
    from graphify.detect import _shebang_interpreter
    script = tmp_path / "env_vs_assignment"
    script.write_bytes(b"#!/usr/bin/env -vS DEBUG=1 python3 -u\nprint('x')\n")
    assert _shebang_interpreter(script) == "python3"
    assert classify_file(script) == FileType.CODE


# --- #777: portable manifest paths ------------------------------------------
# When ``root`` is supplied, the on-disk manifest stores forward-slash
# relative keys so a committed ``graphify-out/`` round-trips across machines
# and CI runners. In-memory the keys are still absolute, so internal callers
# (notably :func:`detect_incremental`) remain unchanged.

def test_save_manifest_relativizes_keys_when_root_given(tmp_path):
    """``save_manifest(root=...)`` writes forward-slash relative keys."""
    import json
    from graphify.detect import save_manifest, load_manifest

    (tmp_path / "src").mkdir()
    (tmp_path / "src" / "foo.py").write_text("def x(): pass\n")
    (tmp_path / "doc.md").write_text("hello\n")

    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
    files = {
        "code": [str(tmp_path / "src" / "foo.py")],
        "document": [str(tmp_path / "doc.md")],
    }
    save_manifest(files, manifest_path, root=tmp_path)

    raw = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert set(raw) == {"src/foo.py", "doc.md"}, (
        f"on-disk keys must be relative posix paths, got {set(raw)}"
    )

    # Same file, loaded with root: callers see absolute keys back.
    loaded = load_manifest(manifest_path, root=tmp_path)
    abs_foo = str((tmp_path / "src" / "foo.py").resolve())
    abs_doc = str((tmp_path / "doc.md").resolve())
    assert set(loaded) == {abs_foo, abs_doc}


def test_save_manifest_without_root_keeps_absolute_keys(tmp_path):
    """Back-compat: callers that don't pass ``root`` still get the legacy
    absolute-keyed manifest format. Required so skill-generated scripts that
    call ``save_manifest(detect['files'])`` keep working unchanged."""
    import json
    from graphify.detect import save_manifest

    f = tmp_path / "foo.py"
    f.write_text("pass\n")
    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
    save_manifest({"code": [str(f)]}, manifest_path)

    raw = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert list(raw)[0] == str(f.resolve()), (
        f"without root, keys must remain absolute; got {list(raw)}"
    )


def test_load_manifest_absolutizes_relative_keys(tmp_path):
    """``load_manifest(root=...)`` re-anchors stored relative keys so the
    in-memory shape matches what :func:`detect` returns."""
    import json
    from graphify.detect import load_manifest

    manifest_path = tmp_path / "graphify-out" / "manifest.json"
    manifest_path.parent.mkdir(parents=True)
    manifest_path.write_text(json.dumps({
        "src/foo.py": {"mtime": 0.0, "ast_hash": "h1", "semantic_hash": ""},
        "doc.md": {"mtime": 0.0, "ast_hash": "h2", "semantic_hash": ""},
    }))

    loaded = load_manifest(str(manifest_path), root=tmp_path)
    assert str((tmp_path / "src" / "foo.py").resolve()) in loaded
    assert str((tmp_path / "doc.md").resolve()) in loaded


def test_load_manifest_passes_through_legacy_absolute_keys(tmp_path):
    """Legacy absolute-keyed manifests still load correctly when ``root``
    is supplied — the absolutize step is a no-op for already-absolute keys."""
    import json
    from graphify.detect import load_manifest

    manifest_path = tmp_path / "graphify-out" / "manifest.json"
    manifest_path.parent.mkdir(parents=True)
    abs_key = str((tmp_path / "foo.py").resolve())
    manifest_path.write_text(json.dumps({abs_key: {"mtime": 0.0, "ast_hash": "h", "semantic_hash": ""}}))

    loaded = load_manifest(str(manifest_path), root=tmp_path)
    assert abs_key in loaded


def test_save_manifest_out_of_root_keeps_absolute(tmp_path):
    """Files outside ``root`` (e.g. symlinked external corpora) are stored
    absolute so they round-trip on the saving machine even when they can't
    be portably encoded."""
    import json
    from graphify.detect import save_manifest

    outside = tmp_path.parent / f"{tmp_path.name}-sibling.py"
    outside.write_text("pass\n")
    try:
        manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
        save_manifest({"code": [str(outside)]}, manifest_path, root=tmp_path)
        raw = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
        key = list(raw)[0]
        assert Path(key).is_absolute(), (
            f"out-of-root entries must keep absolute keys, got {key!r}"
        )
    finally:
        outside.unlink(missing_ok=True)


def test_detect_incremental_portable_across_paths(tmp_path):
    """End-to-end: a manifest written at one root must be readable from a
    different absolute prefix (the cross-machine case #777 is about).
    Simulates two checkouts of the same corpus by hard-linking files into a
    second tmp dir and comparing detection results."""
    import json
    from graphify.detect import save_manifest, detect_incremental

    # First "machine": create corpus, save manifest with root.
    repo_a = tmp_path / "repo_a"
    repo_a.mkdir()
    (repo_a / "src").mkdir()
    (repo_a / "src" / "foo.py").write_text("pass\n")
    (repo_a / "doc.md").write_text("hello\n")

    manifest_a = str(repo_a / "graphify-out" / "manifest.json")
    files = {
        "code": [str(repo_a / "src" / "foo.py")],
        "document": [str(repo_a / "doc.md")],
    }
    save_manifest(files, manifest_a, root=repo_a)

    # Second "machine": copy the corpus + manifest to a different absolute path.
    repo_b = tmp_path / "repo_b"
    (repo_b / "src").mkdir(parents=True)
    (repo_b / "src" / "foo.py").write_text("pass\n")
    (repo_b / "doc.md").write_text("hello\n")
    (repo_b / "graphify-out").mkdir()
    manifest_b = repo_b / "graphify-out" / "manifest.json"
    manifest_b.write_text(Path(manifest_a).read_text())

    # Stat the copied files match the originals' content hash so
    # detect_incremental should see zero new files.
    inc = detect_incremental(repo_b, str(manifest_b))
    assert inc["new_total"] == 0, (
        f"manifest must port across absolute paths; got new_total={inc['new_total']}"
    )


def _rewrite_manifest_keys_nfd(manifest_path):
    """Rewrite a saved manifest so every key is in NFD form, simulating a
    manifest written by a macOS run where os.walk/getcwd yielded decomposed
    paths (#2221). Returns the rewritten key list for sanity checks."""
    import json
    p = Path(manifest_path)
    raw = json.loads(p.read_text(encoding="utf-8"))
    nfd = {unicodedata.normalize("NFD", k): v for k, v in raw.items()}
    p.write_text(json.dumps(nfd), encoding="utf-8")
    return list(nfd)


def test_manifest_nfc_keys_survive_macos_path_forms(tmp_path):
    """#2221 (portable/relative-key manifest): a manifest whose keys were
    written in NFD (macOS os.walk form) must still match an NFC scan, so
    --update reports nothing new/changed/deleted instead of re-extracting
    the whole corpus.

    NOTE: the fixture filename must contain a character that actually
    decomposes under NFD ("é" in "café" does, as do "ä" and "й"). Plain
    Cyrillic like "заметка" has no decomposition, so NFC == NFD and the
    test would pass vacuously even without the fix. Keep the byte-wise
    inequality assertion below when changing the fixture name.
    """
    corpus = tmp_path / "corpus"
    (corpus / "docs").mkdir(parents=True)
    nfc_name = unicodedata.normalize("NFC", "café.md")
    assert nfc_name != unicodedata.normalize("NFD", nfc_name)  # must decompose
    (corpus / "docs" / nfc_name).write_text("hello unicode\n")

    # Manifest lives OUTSIDE the corpus so it never enters the scan.
    manifest_path = str(tmp_path / "out" / "manifest.json")
    full = detect(corpus)
    assert full["total_files"] == 1  # sanity: the café file was scanned
    save_manifest(full["files"], manifest_path, root=corpus)

    # Simulate the macOS-written manifest: keys stored in NFD form.
    nfd_keys = _rewrite_manifest_keys_nfd(manifest_path)
    # Sanity: the on-disk keys are genuinely decomposed, not silently NFC.
    assert any(unicodedata.normalize("NFC", k) != k for k in nfd_keys)

    inc = detect_incremental(corpus, manifest_path)
    assert inc["new_total"] == 0, (
        f"NFD manifest keys must match NFC scan paths (#2221); "
        f"new_files={inc['new_files']}"
    )
    assert all(v == [] for v in inc["new_files"].values())
    assert inc["deleted_files"] == [], (
        f"NFD keys misreported as deletions: {inc['deleted_files']}"
    )
    assert inc["excluded_files"] == []


def test_manifest_nfc_keys_legacy_absolute(tmp_path):
    """#2221 exact repro: legacy manifest saved WITHOUT root (absolute keys),
    then rewritten to NFD. Before the load_manifest/detect_incremental NFC
    normalization, every file looked simultaneously new AND deleted on
    --update.

    NOTE: as above, the filename must contain an NFD-decomposable character
    ("é"); a non-decomposing name would make this test vacuous.
    """
    corpus = tmp_path / "corpus"
    (corpus / "docs").mkdir(parents=True)
    nfc_name = unicodedata.normalize("NFC", "café.md")
    assert nfc_name != unicodedata.normalize("NFD", nfc_name)  # must decompose
    (corpus / "docs" / nfc_name).write_text("hello unicode\n")

    manifest_path = str(tmp_path / "out" / "manifest.json")
    full = detect(corpus)
    assert full["total_files"] == 1
    # No root= -> legacy absolute-keyed manifest format.
    save_manifest(full["files"], manifest_path)

    _rewrite_manifest_keys_nfd(manifest_path)

    inc = detect_incremental(corpus, manifest_path)
    assert inc["new_total"] == 0, (
        f"legacy absolute NFD keys must match NFC scan (#2221); "
        f"new_files={inc['new_files']}"
    )
    assert inc["deleted_files"] == []
    assert inc["excluded_files"] == []


def test_save_manifest_in_root_symlink_roundtrips(tmp_path):
    """In-root symlinks must store under the symlink's own name, not the
    resolved target. Resolving the key when relativizing pointed the stored
    entry at ``sub/target.py`` instead of ``alias.py``, so the original
    ``alias.py`` key missed on reload and re-extracted on every incremental
    run."""
    import json
    from graphify.detect import save_manifest, load_manifest

    (tmp_path / "sub").mkdir()
    target = tmp_path / "sub" / "target.py"
    target.write_text("pass\n")
    alias = tmp_path / "alias.py"
    try:
        alias.symlink_to(target)
    except (OSError, NotImplementedError):
        import pytest
        pytest.skip("filesystem does not support symlinks")

    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
    save_manifest({"code": [str(alias)]}, manifest_path, root=tmp_path)

    raw = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert "alias.py" in raw, (
        f"in-root symlink must be stored under its own name, got {list(raw)}"
    )
    assert "sub/target.py" not in raw, (
        f"symlink must not be stored under resolved target path; got {list(raw)}"
    )

    loaded = load_manifest(manifest_path, root=tmp_path)
    assert str(tmp_path.resolve() / "alias.py") in loaded


def test_convert_office_file_hash_stable_across_nfc_nfd(tmp_path, monkeypatch):
    """The sidecar name must be identical whether the source path arrives in
    NFC or NFD form. On macOS os.walk/rglob yield NFD paths while directly
    constructed Paths are NFC; without NFC-normalizing before hashing the same
    .docx would get a different sidecar name (and manifest key) on every run,
    forcing a full re-extraction under --update (#1226).
    """
    monkeypatch.setattr(detect_mod, "docx_to_markdown", lambda p: "hello world")

    out_dir = tmp_path / "converted"
    # "한글" / "ä" style filename with a precomposed (NFC) and decomposed (NFD)
    # representation that are distinct byte strings but the same logical name.
    base = tmp_path / "report"
    nfc_name = unicodedata.normalize("NFC", "café.docx")
    nfd_name = unicodedata.normalize("NFD", "café.docx")
    assert nfc_name != nfd_name  # sanity: the two forms differ byte-wise

    nfc_path = base / nfc_name
    nfd_path = base / nfd_name

    out_nfc = detect_mod.convert_office_file(nfc_path, out_dir)
    out_nfd = detect_mod.convert_office_file(nfd_path, out_dir)

    assert out_nfc is not None and out_nfd is not None
    # The hash suffix (and therefore the whole sidecar filename) must match.
    assert out_nfc.name.split("_")[-1] == out_nfd.name.split("_")[-1]


def test_convert_office_file_does_not_rewrite_existing_sidecar(tmp_path, monkeypatch):
    """A second conversion of an unchanged source must not rewrite the sidecar,
    so its mtime stays put and detect_incremental keeps treating it as
    unchanged (#1226)."""
    monkeypatch.setattr(detect_mod, "docx_to_markdown", lambda p: "hello world")

    out_dir = tmp_path / "converted"
    src = tmp_path / "doc.docx"

    first = detect_mod.convert_office_file(src, out_dir)
    assert first is not None
    mtime_before = first.stat().st_mtime_ns

    second = detect_mod.convert_office_file(src, out_dir)
    assert second == first
    assert second.stat().st_mtime_ns == mtime_before


def test_convert_office_file_sidecar_name_stable_across_checkouts(tmp_path, monkeypatch):
    """#2059: the sidecar name must depend on the scan-root-RELATIVE path, not the
    absolute checkout location, so the same tracked file in two clones/worktrees
    produces the same sidecar name (no unbounded duplicates when graphify-out/ is
    committed). Also verifies the no-root fallback matches the explicit form."""
    monkeypatch.setattr(detect_mod, "xlsx_to_markdown", lambda p: "sheet body")

    def _sidecar(root):
        src = root / "docs" / "report.xlsx"
        out_dir = root / "graphify-out" / "converted"
        return detect_mod.convert_office_file(src, out_dir, root=root)

    checkout_a = tmp_path / "checkout-a"
    checkout_b = tmp_path / "somewhere-else" / "checkout-b"
    (checkout_a / "docs").mkdir(parents=True)
    (checkout_b / "docs").mkdir(parents=True)
    out_a = _sidecar(checkout_a)
    out_b = _sidecar(checkout_b)
    assert out_a is not None and out_b is not None
    assert out_a.name == out_b.name, "sidecar name must be stable across checkouts (#2059)"
    assert out_a.parent != out_b.parent  # sanity: genuinely different locations

    # No explicit root -> the out_dir.parent.parent fallback yields the same name.
    fallback = detect_mod.convert_office_file(
        checkout_a / "docs" / "report.xlsx", checkout_a / "graphify-out" / "converted"
    )
    assert fallback is not None and fallback.name == out_a.name


def test_convert_office_file_hash_disambiguates_same_stem(tmp_path, monkeypatch):
    """Two same-stem Office files in different subdirs must still get distinct
    sidecar names — the relative-path hash preserves the disambiguation purpose."""
    monkeypatch.setattr(detect_mod, "xlsx_to_markdown", lambda p: "body")
    root = tmp_path / "repo"
    (root / "a").mkdir(parents=True)
    (root / "b").mkdir(parents=True)
    out_dir = root / "graphify-out" / "converted"
    out_a = detect_mod.convert_office_file(root / "a" / "report.xlsx", out_dir, root=root)
    out_b = detect_mod.convert_office_file(root / "b" / "report.xlsx", out_dir, root=root)
    assert out_a is not None and out_b is not None
    assert out_a.name != out_b.name, "same-stem files in different dirs must differ (#2059)"


def test_convert_office_file_outside_root_falls_back(tmp_path, monkeypatch):
    """A source outside the scan root (--include, custom layouts) falls back to the
    absolute-path hash without raising, and stays deterministic."""
    monkeypatch.setattr(detect_mod, "docx_to_markdown", lambda p: "body")
    root = tmp_path / "repo"
    (root / "graphify-out" / "converted").mkdir(parents=True)
    outside = tmp_path / "elsewhere" / "doc.docx"
    out_dir = root / "graphify-out" / "converted"
    out1 = detect_mod.convert_office_file(outside, out_dir, root=root)
    out2 = detect_mod.convert_office_file(outside, out_dir, root=root)
    assert out1 is not None and out1.name == out2.name


def test_detect_keeps_env_source_dirs(tmp_path):
    """#2058: a real source directory named env/ or *_env/ with no virtualenv
    markers must be indexed, not silently pruned as a false-positive venv."""
    src_env = tmp_path / "src_env"
    (src_env / "env").mkdir(parents=True)
    (src_env / "env" / "ctrl_mem_env.py").write_text("def build_env():\n    return 1\n")
    (src_env / "other_dir").mkdir()
    (src_env / "other_dir" / "also_real.py").write_text("def x():\n    return 2\n")

    all_files = [f for files in detect(tmp_path)["files"].values() for f in files]
    assert any("ctrl_mem_env.py" in f for f in all_files), "env/ source dir wrongly pruned (#2058)"
    assert any("also_real.py" in f for f in all_files), "*_env/ subtree wrongly pruned (#2058)"

    # Nested env/ under a scan root that IS the *_env dir (issue's exact-match case).
    nested = [f for files in detect(src_env)["files"].values() for f in files]
    assert any("ctrl_mem_env.py" in f for f in nested), "nested env/ pruned when scanned directly (#2058)"


def test_detect_still_prunes_real_env_venv(tmp_path):
    """#2058: an env/ dir that IS a real virtualenv (has markers) is still pruned,
    and the pruned dir is recorded in the traceable pruned_noise_dirs bucket."""
    venv = tmp_path / "env"
    (venv / "lib").mkdir(parents=True)
    (venv / "pyvenv.cfg").write_text("home = /usr/bin\n")
    (venv / "lib" / "sixish.py").write_text("x = 1\n")
    (tmp_path / "main.py").write_text("def main():\n    return 1\n")

    result = detect(tmp_path)
    all_files = [f for files in result["files"].values() for f in files]
    assert not any("sixish.py" in f for f in all_files), "real venv env/ must still be pruned"
    assert any("main.py" in f for f in all_files)
    assert any(f"{os.sep}env{os.sep}" in d for d in result["pruned_noise_dirs"]), (
        "pruned venv must be traceable in pruned_noise_dirs (#2058)"
    )


def test_detect_prunes_venv_names_without_markers(tmp_path):
    """#2058 must not loosen the unambiguous names: venv/.venv/*_venv are still
    pruned by name alone (no markers needed)."""
    for name in ("venv", ".venv", "my_venv"):
        d = tmp_path / name
        d.mkdir()
        (d / "mod.py").write_text("y = 1\n")
    (tmp_path / "app.py").write_text("def a():\n    return 1\n")
    all_files = [f for files in detect(tmp_path)["files"].values() for f in files]
    assert any("app.py" in f for f in all_files)
    for name in ("venv", ".venv", "my_venv"):
        assert not any(f"{os.sep}{name}{os.sep}" in f for f in all_files), f"{name} must stay pruned"


@pytest.mark.parametrize(
    ("configured_out", "absolute", "symlink_target"),
    [
        pytest.param("graphify-out/nlp", False, None, id="default-parent"),
        pytest.param("artifacts/nlp", False, None, id="custom-parent"),
        pytest.param("artifacts/nlp", True, None, id="absolute"),
        pytest.param(
            "aliases/output-link",
            False,
            "artifacts/nlp",
            id="in-root-symlink",
        ),
    ],
)
def test_nested_graphify_out_prunes_only_configured_path(
    tmp_path, configured_out, absolute, symlink_target
):
    """#2273: a nested output basename must not prune same-named source dirs."""
    import json
    import subprocess
    import sys

    if absolute:
        configured_out = str(tmp_path / configured_out)

    source = tmp_path / "src" / "revil" / "nexus" / "nlp" / "core.py"
    source.parent.mkdir(parents=True)
    source.write_text("def tokenize(text):\n    return text.split()\n")

    output_dir = (
        tmp_path / symlink_target
        if symlink_target is not None
        else tmp_path / configured_out
    )
    if symlink_target is not None:
        output_dir.mkdir(parents=True)
        configured_out_link = tmp_path / configured_out
        configured_out_link.parent.mkdir(parents=True)
        try:
            configured_out_link.symlink_to(output_dir, target_is_directory=True)
        except (OSError, NotImplementedError):
            pytest.skip("filesystem does not support symlinks")

    generated = output_dir / "generated.py"
    generated.parent.mkdir(parents=True, exist_ok=True)
    generated.write_text("SHOULD_NOT_BE_INDEXED = True\n")

    probe = subprocess.run(
        [
            sys.executable,
            "-c",
            (
                "import json, sys\n"
                "from pathlib import Path\n"
                "from graphify.detect import detect\n"
                "result = detect(Path(sys.argv[1]))\n"
                "print(json.dumps(result['files']['code']))\n"
            ),
            str(tmp_path),
        ],
        cwd=Path(__file__).parents[1],
        env={**os.environ, "GRAPHIFY_OUT": configured_out},
        check=True,
        capture_output=True,
        text=True,
    )
    detected = {Path(p).resolve() for p in json.loads(probe.stdout)}

    assert source.resolve() in detected
    assert generated.resolve() not in detected


def test_detect_records_unclassified_extensionless_files(tmp_path):
    # #1692: extensionless, non-shebang project files (Dockerfile, Makefile, ...)
    # were considered but left no trace. detect() now lists them under
    # "unclassified" so they can be surfaced instead of silently vanishing.
    (tmp_path / "app.py").write_text("def f():\n    return 1\n")
    (tmp_path / "Dockerfile").write_text("FROM python:3.12\nRUN pip install x\n")
    (tmp_path / "Makefile").write_text("build:\n\techo hi\n")
    (tmp_path / "LICENSE").write_text("MIT License\n")
    res = detect(tmp_path)
    unclassified = sorted(Path(p).name for p in res.get("unclassified", []))
    assert unclassified == ["Dockerfile", "LICENSE", "Makefile"]
    # real code is still classified, not swept into unclassified
    assert any("app.py" in f for f in res["files"].get("code", []))


def test_detect_unclassified_empty_when_all_supported(tmp_path):
    (tmp_path / "a.py").write_text("x = 1\n")
    (tmp_path / "README.md").write_text("# hi\n")
    res = detect(tmp_path)
    assert res.get("unclassified", []) == []


def test_graphifyinclude_is_inert_and_not_unclassified(tmp_path, capsys):
    """#2112: .graphifyinclude support was removed (dead since #873).

    A leftover .graphifyinclude must not error, must not surface in the
    unclassified list, and must not change which real files are indexed.
    detect() prints a one-time stderr note so the removal is not silent.
    """
    (tmp_path / "main.py").write_text("x = 1\n")

    baseline = detect(tmp_path)
    capsys.readouterr()  # discard any baseline output

    (tmp_path / ".graphifyinclude").write_text(".github/\ndocs/**\n")
    result = detect(tmp_path)

    # not surfaced as an unclassified scan input
    assert not any(".graphifyinclude" in p for p in result["unclassified"])
    # real files are indexed exactly as before; the file changes nothing
    assert result["files"] == baseline["files"]
    assert any("main.py" in f for f in result["files"]["code"])
    # one-time stderr note, matching the [graphify] warning convention
    err = capsys.readouterr().err
    assert err.count("[graphify] WARNING: .graphifyinclude is no longer supported") == 1


def test_detect_reports_walk_errors_key():
    """detect() always surfaces a walk_errors list so callers can tell whether
    enumeration was complete."""
    import tempfile
    d = Path(tempfile.mkdtemp())
    (d / "a.py").write_text("def f(): pass\n")
    res = detect(d)
    assert "walk_errors" in res
    assert res["walk_errors"] == []


def test_detect_surfaces_unreadable_dir_instead_of_silent_skip(tmp_path, capsys):
    """os.walk silently skips a subtree whose scandir raises (permissions, or a
    dir deleted mid-walk); that under-enumeration used to be invisible and could
    yield a silently partial graph. detect() now records it in walk_errors and
    warns, while still enumerating the rest of the tree."""
    import os
    if os.geteuid() == 0:
        import pytest
        pytest.skip("running as root: chmod 000 does not block scandir")
    (tmp_path / "a.py").write_text("def f(): pass\n")
    locked = tmp_path / "locked"
    locked.mkdir()
    (locked / "b.py").write_text("def g(): pass\n")
    os.chmod(locked, 0o000)
    try:
        res = detect(tmp_path)
    finally:
        os.chmod(locked, 0o755)  # restore for cleanup
    code = res["files"]["code"]
    assert any(f.endswith("a.py") for f in code)  # rest of tree still enumerated
    assert len(res["walk_errors"]) >= 1
    assert "could not scan" in capsys.readouterr().err


def test_nested_gitignore_star_does_not_ignore_outside_its_dir(tmp_path):
    """A nested .gitignore containing a bare `*` (auto-written by e.g. the
    hypothesis library into .hypothesis/) must ignore ONLY that directory's
    contents — matching it against root-relative paths ignored the entire
    corpus (detect() returned 0 files on a real repo). Regression for #1873."""
    (tmp_path / "README.md").write_text("# hello")
    (tmp_path / "main.py").write_text("x = 1")
    hyp = tmp_path / ".hypothesis"
    hyp.mkdir()
    (hyp / ".gitignore").write_text("*\n")
    (hyp / "cached.py").write_text("y = 2")

    result = detect(tmp_path)

    assert result["total_files"] == 2  # README.md + main.py survive; .hypothesis/* ignored


def test_nested_gitignore_patterns_still_apply_inside_their_dir(tmp_path):
    """Counterpart guard: the anchor-scoped fix must not stop nested ignore
    files from working WITHIN their own subtree."""
    (tmp_path / "main.py").write_text("x = 1")
    sub = tmp_path / "sub"
    sub.mkdir()
    (sub / ".gitignore").write_text("*.log\n")
    (sub / "keep.py").write_text("y = 2")
    (sub / "noise.log").write_text("z")

    result = detect(tmp_path)

    assert result["total_files"] == 2  # main.py + sub/keep.py; sub/noise.log ignored


def test_nested_gitignore_does_not_govern_sibling_project(tmp_path):
    """A nested .gitignore ('data/') in one project must not drop a sibling
    project's data/ files, and the drop must be recorded in the `ignored`
    diagnostic field rather than silently vanishing (#1922)."""
    (tmp_path / "run.py").write_text("x = 1")
    pa = tmp_path / "project_a" / "data"
    pa.mkdir(parents=True)
    (pa / "loader.py").write_text("def load(): pass")
    pb = tmp_path / "project_b"
    (pb / "data").mkdir(parents=True)
    (pb / ".gitignore").write_text("data/\n")
    (pb / "data" / "dump.csv").write_text("a,b\n1,2\n")

    result = detect(tmp_path)

    all_paths = [f for v in result["files"].values() for f in v]
    assert any(
        f.endswith(os.path.join("project_a", "data", "loader.py")) for f in all_paths
    ), "sibling project_a/data/loader.py must survive project_b's nested ignore"
    assert not any(f.endswith("dump.csv") for f in all_paths)
    # The legitimately-ignored subtree is recorded, not silently dropped.
    assert any(
        e.rstrip(os.sep).endswith(os.path.join("project_b", "data"))
        for e in result["ignored"]
    ), f"ignored subtree should be recorded in detect()['ignored']: {result['ignored']}"


# ---------------------------------------------------------------------------
# #1908: manifest must not retain scan-excluded files as permanent
# "deleted" entries. Full-scan saves prune excluded-but-alive rows; subset
# saves keep preserving untouched rows (#917); out-of-root rows never prune.
# ---------------------------------------------------------------------------

def test_save_manifest_full_scan_prunes_excluded_but_alive_row(tmp_path):
    """A row for a file that still exists on disk but left the scan corpus
    (newly excluded) is dropped when the caller passes the full corpus."""
    import json
    a = tmp_path / "a.py"
    b = tmp_path / "b.py"
    a.write_text("x = 1\n")
    b.write_text("y = 2\n")
    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")

    save_manifest({"code": [str(a), str(b)]}, manifest_path, root=tmp_path)
    raw = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert set(raw) == {"a.py", "b.py"}

    # Second full scan no longer covers b.py (excluded), yet b.py is alive.
    save_manifest(
        {"code": [str(a)]}, manifest_path, root=tmp_path,
        scan_corpus={str(a)},
    )
    raw = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert set(raw) == {"a.py"}, (
        f"excluded-but-alive row must be pruned on a full-scan save, got {set(raw)}"
    )


def test_save_manifest_full_scan_still_prunes_missing_file(tmp_path):
    """Genuine deletions keep being pruned when scan_corpus is passed."""
    import json
    a = tmp_path / "a.py"
    gone = tmp_path / "gone.py"
    a.write_text("x = 1\n")
    gone.write_text("y = 2\n")
    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
    save_manifest({"code": [str(a), str(gone)]}, manifest_path, root=tmp_path)

    gone.unlink()
    save_manifest(
        {"code": [str(a)]}, manifest_path, root=tmp_path,
        scan_corpus={str(a)},
    )
    raw = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert set(raw) == {"a.py"}


def test_save_manifest_subset_save_preserves_untouched_rows(tmp_path):
    """Without scan_corpus (changed_paths hooks, skill runbooks, #917) a
    subset save must keep seeding rows for files it wasn't given."""
    import json
    a = tmp_path / "a.py"
    b = tmp_path / "b.py"
    a.write_text("x = 1\n")
    b.write_text("y = 2\n")
    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
    save_manifest({"code": [str(a), str(b)]}, manifest_path, root=tmp_path)

    # Incremental hook re-stamps only a.py; b.py's row must survive.
    save_manifest({"code": [str(a)]}, manifest_path, root=tmp_path)
    raw = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
    assert set(raw) == {"a.py", "b.py"}, (
        f"subset saves must preserve untouched rows (#917), got {set(raw)}"
    )


def test_save_manifest_full_scan_keeps_out_of_root_rows(tmp_path):
    """Out-of-root entries (--include sources, symlinked corpora) are never
    walked by detect, so their absence from the corpus is not exclusion
    evidence — a full-scan save must keep them."""
    import json
    a = tmp_path / "a.py"
    a.write_text("x = 1\n")
    outside = tmp_path.parent / f"{tmp_path.name}-extern.py"
    outside.write_text("z = 3\n")
    try:
        manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
        save_manifest(
            {"code": [str(a), str(outside)]}, manifest_path, root=tmp_path
        )
        save_manifest(
            {"code": [str(a)]}, manifest_path, root=tmp_path,
            scan_corpus={str(a)},
        )
        raw = json.loads(Path(manifest_path).read_text(encoding="utf-8"))
        assert "a.py" in raw
        assert str(outside.resolve()) in raw, (
            f"out-of-root rows must never be pruned to the scan, got {set(raw)}"
        )
    finally:
        outside.unlink(missing_ok=True)


def test_detect_incremental_reports_excluded_not_deleted(tmp_path):
    """A previously-indexed file that becomes excluded (still on disk) must
    land in excluded_files, not deleted_files (#1908)."""
    a = tmp_path / "a.py"
    b = tmp_path / "b.py"
    a.write_text("x = 1\n")
    b.write_text("y = 2\n")
    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
    full = detect(tmp_path)
    save_manifest(full["files"], manifest_path, root=tmp_path)

    inc = detect_incremental(
        tmp_path, manifest_path, extra_excludes=["b.py"]
    )
    assert inc["deleted_files"] == [], (
        f"excluded-but-alive file misreported as deleted: {inc['deleted_files']}"
    )
    assert [Path(f).name for f in inc["excluded_files"]] == ["b.py"]


def test_detect_incremental_still_reports_real_deletions(tmp_path):
    """Counterpart: a manifest row whose file is gone from disk stays in
    deleted_files."""
    a = tmp_path / "a.py"
    b = tmp_path / "b.py"
    a.write_text("x = 1\n")
    b.write_text("y = 2\n")
    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
    full = detect(tmp_path)
    save_manifest(full["files"], manifest_path, root=tmp_path)

    b.unlink()
    inc = detect_incremental(tmp_path, manifest_path)
    assert [Path(f).name for f in inc["deleted_files"]] == ["b.py"]
    assert inc["excluded_files"] == []


def test_detect_incremental_exclusion_stable_across_runs(tmp_path):
    """After a full-scan save prunes the excluded row, later incremental runs
    report the file neither as deleted nor as excluded — the exclusion has
    fully settled instead of resurfacing forever."""
    a = tmp_path / "a.py"
    b = tmp_path / "b.py"
    a.write_text("x = 1\n")
    b.write_text("y = 2\n")
    manifest_path = str(tmp_path / "graphify-out" / "manifest.json")
    full = detect(tmp_path)
    save_manifest(full["files"], manifest_path, root=tmp_path)

    # Run 1: b.py newly excluded — reported as excluded, then the full-scan
    # save (what extract does at the end of the run) prunes its row.
    inc1 = detect_incremental(tmp_path, manifest_path, extra_excludes=["b.py"])
    assert [Path(f).name for f in inc1["excluded_files"]] == ["b.py"]
    assert inc1["deleted_files"] == []
    corpus = {f for flist in inc1["files"].values() for f in flist}
    save_manifest(inc1["files"], manifest_path, root=tmp_path, scan_corpus=corpus)

    # Run 2 (and beyond): steady state — nothing deleted, nothing excluded.
    inc2 = detect_incremental(tmp_path, manifest_path, extra_excludes=["b.py"])
    assert inc2["deleted_files"] == []
    assert inc2["excluded_files"] == []


# ── #2106: sensitive-filter over-match (prose/source rescued, real secrets kept) ──

@pytest.mark.parametrize("path", [
    "wiki/privacy-tokens.md",          # reporter's own hub node
    "wiki/ai-token-economics.md",
    "wiki/chain-of-hope-tokenomics.md",
    "tokenizer.py",
    "secretary.py",
    "google/oauth2/service_account.py",   # real Google auth source
    "docs/service-account-setup.md",
    "wiki/aws_credentials_rotation_guide.md",
    "token.economics.notes.md",           # multi-dot topic slug
    "password-reset/design.md",
])
def test_sensitive_filter_indexes_topic_prose_and_source(path):
    from graphify.detect import _is_sensitive
    assert not _is_sensitive(Path(path)), f"{path} is a topic doc / real source, must be indexed (#2106)"


@pytest.mark.parametrize("path", [
    ".env", "id_rsa", "credentials.json", "server.pem", "certs/server.key",
    "secrets.md", "passwords.md", "token.md", "token.txt", "api_token.json",
    "service-account.json",                # a downloaded GCP key file
    ".npmrc", ".pypirc", "secring.gpg", ".git-credentials",   # #2106 newly-caught
    "Secrets/creds.json", "SECRETS/db.json", "ID_RSA",        # #2106 case variants
    "secrets/prod.tfvars", "credentials/id_rsa",
])
def test_sensitive_filter_still_excludes_real_secrets(path):
    from graphify.detect import _is_sensitive
    assert _is_sensitive(Path(path)), f"{path} is a real secret, must stay excluded (#2106)"


def test_sensitive_bare_keyword_prose_still_dropped():
    """A prose file whose stem IS exactly a bare keyword still reads as a dump."""
    from graphify.detect import _is_sensitive
    assert _is_sensitive(Path("secrets.md"))
    assert _is_sensitive(Path("token.rst"))
    assert not _is_sensitive(Path("token-lifecycle.md"))  # multi-word slug indexed


# ── #2232 / #2184: committed dotenv templates (.env.example etc.) are graphable ──

@pytest.mark.parametrize("path", [
    ".env.example",
    ".env.sample",
    ".env.template",
    ".env.dist",
    ".ENV.EXAMPLE",              # case-insensitive, real on macOS/Windows
    ".envrc.sample",             # direnv template
    ".env.production.example",   # per-environment template
])
def test_sensitive_filter_indexes_env_templates(path):
    """Placeholder-only committed templates must not be treated as live secrets."""
    assert not _is_sensitive(Path(path)), f"{path} is a committed template, must be indexed (#2184)"


@pytest.mark.parametrize("path", [
    ".env",
    ".env.local",
    ".env.production",
    ".envrc",
    ".env.example.local",   # template suffix not final -> a real local override
    ".env.example.bak",     # backup of a (possibly filled-in) env file
])
def test_sensitive_filter_still_excludes_real_env_files(path):
    """The template carve-out is suffix-anchored; live env files stay excluded."""
    assert _is_sensitive(Path(path)), f"{path} is a live env file, must stay excluded (#2184)"


@pytest.mark.parametrize("path", [
    "secrets/.env.example",
    "deploy/credentials/.env.example",
])
def test_sensitive_env_template_inside_secrets_dir_still_dropped(path):
    """Stage 1 dir guard runs before the Stage 2 template exemption: anything
    under a secrets/credentials dir stays excluded, template suffix or not."""
    assert _is_sensitive(Path(path)), f"{path} is under a secrets dir, must stay excluded (#2184)"