Optional JSONPath query/extract support, FTS5 section/block search, mkt cache query and search. Local SQLite backend now supports parsed snapshot persistence, incremental refresh, cached querying, and ranked full-text search

tests/test_query_extraction.py

@@ -1,11 +1,17 @@
 from pathlib import Path
+import importlib.util
 
 import pytest
 from click.testing import CliRunner
 
 from markitect_tool.cli import main
 from markitect_tool.core import parse_markdown
-from markitect_tool.query import InvalidQueryError, extract_document, query_document
+from markitect_tool.query import (
+    InvalidQueryError,
+    extract_document,
+    query_document,
+    query_document_jsonpath,
+)
 
 
 QUERY_DOC = """---
@@ -110,6 +116,41 @@ def test_invalid_query_reports_error():
         query_document(document, "sections[heading")
 
 
+@pytest.mark.skipif(
+    importlib.util.find_spec("jsonpath_ng") is None,
+    reason="jsonpath-ng optional dependency is not installed",
+)
+def test_query_document_jsonpath_returns_shared_match_envelope():
+    document = parse_markdown(QUERY_DOC)
+
+    matches = query_document_jsonpath(document, "$.headings[?(@.level == 2)].text")
+
+    assert [match.value for match in matches] == [
+        "Context",
+        "Decision",
+        "Consequences",
+    ]
+    assert all(match.kind == "heading_value" for match in matches)
+
+
+def test_query_document_jsonpath_reports_missing_optional_dependency(monkeypatch):
+    document = parse_markdown(QUERY_DOC)
+
+    import builtins
+
+    real_import = builtins.__import__
+
+    def fake_import(name, *args, **kwargs):
+        if name.startswith("jsonpath_ng"):
+            raise ImportError("blocked")
+        return real_import(name, *args, **kwargs)
+
+    monkeypatch.setattr(builtins, "__import__", fake_import)
+
+    with pytest.raises(InvalidQueryError, match="optional `jsonpath-ng`"):
+        query_document_jsonpath(document, "$.headings[*].text")
+
+
 def test_mkt_query_outputs_json(tmp_path: Path):
     source = tmp_path / "doc.md"
     source.write_text(QUERY_DOC, encoding="utf-8")
@@ -136,6 +177,24 @@ def test_mkt_query_outputs_text(tmp_path: Path):
     assert "## Context" in result.output
 
 
+@pytest.mark.skipif(
+    importlib.util.find_spec("jsonpath_ng") is None,
+    reason="jsonpath-ng optional dependency is not installed",
+)
+def test_mkt_query_jsonpath_outputs_json(tmp_path: Path):
+    source = tmp_path / "doc.md"
+    source.write_text(QUERY_DOC, encoding="utf-8")
+
+    result = CliRunner().invoke(
+        main,
+        ["query", str(source), "$.frontmatter.status", "--engine", "jsonpath"],
+    )
+
+    assert result.exit_code == 0
+    assert '"engine": "jsonpath"' in result.output
+    assert '"value": "accepted"' in result.output
+
+
 def test_mkt_extract_outputs_text(tmp_path: Path):
     source = tmp_path / "doc.md"
     source.write_text(QUERY_DOC, encoding="utf-8")