release: 0.9.61 — fix Python 3.12/3.13 breakage from 0.9.60

- chinese extra: pin jieba-py from 3.12 (was 3.14); jieba's invalid escapes are
  a hard error on 3.12+ and broke graphify.serve import.
- serve.py: suppress the tokenizer SyntaxWarning by category so -W error can't
  escalate it; catch SyntaxError as a fallback.
- hooks.py: harden the Graphify-Labs#3492 rebuild-root guard for 3.13, whose resolve() no
  longer raises on a symlink loop — require a real directory.
Verified full suite green on both 3.10 (5628) and 3.13 (5627).

Author: safishamsi

CHANGELOG.md

@@ -2,7 +2,12 @@
 
 Full release notes with details on each version: [GitHub Releases](https://github.com/safishamsi/graphify/releases)
 
-## 0.9.60 (unreleased)
+## 0.9.61 (unreleased)
+
+- Fix: `graphify.serve` now imports cleanly on Python 3.12 and 3.13. The `chinese` extra pins `jieba-py` from 3.12 onward (0.9.60 mistakenly kept the old `jieba` until 3.14, and its invalid regex escapes are a hard error on 3.12+), and the jieba import now suppresses the tokenizer's `SyntaxWarning` regardless of message or line so it never escalates under `-W error`.
+- Fix: the git hook's rebuild-root guard now rejects a symlink-loop or dangling `.graphify_root` on Python 3.13, whose `Path.resolve()` no longer raises on a loop — the saved root must resolve to a real directory inside the repo before it is adopted.
+
+## 0.9.60 (2026-09-12)
 
 - Fix: atomic writes now fall back correctly on Windows `WinError 17` (cannot move to a different drive), not just `PermissionError` — a shared `os_replace_with_fallback` copies through a temp in the target directory and restores the original if the swap fails, keeping install/export/cache writes crash-safe (#3508, thanks @ayushcodes10).
 - Fix: files that could not be classified into any language or type are now surfaced (a count and top extensions in the console and GRAPH_REPORT) instead of vanishing from a "successful" run; noise and ignored paths are unaffected (#3511, thanks @ayushcodes10).

graphify/hooks.py

@@ -192,7 +192,10 @@ def _bail():
             try:
                 _cwd = Path.cwd().resolve()
                 _resolved = _candidate.resolve()
-                _in_repo = _resolved == _cwd or _cwd in _resolved.parents
+                # Python 3.13 no longer raises on a symlink loop (resolve returns
+                # the path unresolved), so require a real directory: a loop or a
+                # dangling target is not a dir and correctly falls back.
+                _in_repo = (_resolved == _cwd or _cwd in _resolved.parents) and _resolved.is_dir()
             except (OSError, RuntimeError):
                 _in_repo = False
             if _in_repo:
@@ -264,7 +267,10 @@ def _bail():
             try:
                 _cwd = Path.cwd().resolve()
                 _resolved = _candidate.resolve()
-                _in_repo = _resolved == _cwd or _cwd in _resolved.parents
+                # Python 3.13 no longer raises on a symlink loop (resolve returns
+                # the path unresolved), so require a real directory: a loop or a
+                # dangling target is not a dir and correctly falls back.
+                _in_repo = (_resolved == _cwd or _cwd in _resolved.parents) and _resolved.is_dir()
             except (OSError, RuntimeError):
                 _in_repo = False
             if _in_repo:

graphify/serve.py

@@ -19,14 +19,15 @@
 
 try:
     with warnings.catch_warnings():
-        warnings.filterwarnings(
-            "ignore",
-            message=r'^"\\\." is an invalid escape sequence\.',
-            category=SyntaxWarning,
-            lineno=7,
-        )
+        # jieba/jieba-py carry invalid regex escapes that emit a SyntaxWarning on
+        # compile; the message and line moved across Python versions (3.12 also
+        # reworded it), so ignore the category wholesale here rather than pinning
+        # a message/lineno. Under `-W error::SyntaxWarning` this keeps the import
+        # from escalating to a fatal SyntaxError.
+        warnings.simplefilter("ignore", SyntaxWarning)
         import jieba as _jieba  # type: ignore[import-untyped]
-except ImportError:
+except (ImportError, SyntaxError):
+    # A stray/broken jieba must never take down the whole server import.
     _jieba = None
 
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "graphifyy"
-version = "0.9.60"
+version = "0.9.61"
 description = "AI coding assistant skill (Claude Code, CodeBuddy, Codex, OpenCode, Kilo Code, Cursor, Gemini CLI, Aider, OpenClaw, Factory Droid, Trae, Hermes, Kiro, Pi, Devin CLI, Google Antigravity) - turn any folder of code, docs, papers, images, or videos into a queryable knowledge graph"
 readme = "README.md"
 license = "Apache-2.0"
@@ -81,8 +81,8 @@ anthropic = ["anthropic"]
 gemini = ["openai", "tiktoken"]
 openai = ["openai", "tiktoken"]
 chinese = [
-    "jieba; python_version < '3.14'",
-    "jieba-py>=0.46.12,<1; python_version >= '3.14'",
+    "jieba; python_version < '3.12'",
+    "jieba-py>=0.46.12,<1; python_version >= '3.12'",
 ]
 sql = ["tree-sitter-sql"]
 # extract_pascal() uses tree-sitter-pascal for AST-quality extraction (more
@@ -105,7 +105,7 @@ commonlisp = ["tree-sitter-commonlisp"]
 # every platform, no C toolchain; optional because Robot Framework corpora are
 # QA-automation specific.
 robot = ["robotframework>=4.0"]
-all = ["mcp>=1,<3", "starlette>=1.3.1,<2", "neo4j", "falkordb", "pypdf>=6.16.1", "markdownify", "watchdog", "graspologic; python_version < '3.13'", "graspologic-native>=1.3.1,<2; python_version >= '3.13'", "python-docx", "openpyxl", "psycopg[binary]", "faster-whisper; python_version >= '3.11'", "yt-dlp>=2026.7.4", "matplotlib", "numpy>=2.0; python_version >= '3.13'", "openai", "tiktoken", "boto3", "anthropic", "tree-sitter-sql", "jieba; python_version < '3.14'", "jieba-py>=0.46.12,<1; python_version >= '3.14'", "tree-sitter-dm", "tree-sitter-hcl", "tree-sitter-pascal", "tree-sitter-ocaml", "tree-sitter-commonlisp", "robotframework>=4.0"]
+all = ["mcp>=1,<3", "starlette>=1.3.1,<2", "neo4j", "falkordb", "pypdf>=6.16.1", "markdownify", "watchdog", "graspologic; python_version < '3.13'", "graspologic-native>=1.3.1,<2; python_version >= '3.13'", "python-docx", "openpyxl", "psycopg[binary]", "faster-whisper; python_version >= '3.11'", "yt-dlp>=2026.7.4", "matplotlib", "numpy>=2.0; python_version >= '3.13'", "openai", "tiktoken", "boto3", "anthropic", "tree-sitter-sql", "jieba; python_version < '3.12'", "jieba-py>=0.46.12,<1; python_version >= '3.12'", "tree-sitter-dm", "tree-sitter-hcl", "tree-sitter-pascal", "tree-sitter-ocaml", "tree-sitter-commonlisp", "robotframework>=4.0"]
 
 [project.scripts]
 graphify = "graphify.__main__:main"

tests/test_backend_extras.py

@@ -46,7 +46,7 @@ def test_version_gated_optional_backends_are_packaged():
     for extra in ("leiden", "all"):
         assert "graspologic-native>=1.3.1,<2; python_version >= '3.13'" in extras[extra]
     for extra in ("chinese", "all"):
-        assert "jieba-py>=0.46.12,<1; python_version >= '3.14'" in extras[extra]
+        assert "jieba-py>=0.46.12,<1; python_version >= '3.12'" in extras[extra]
 
 
 def test_backend_pkg_hint_points_at_uv_tool_and_extra():