serpentine-parser 0.3.2__tar.gz → 0.5.0__tar.gz

serpentine_parser-0.3.2/README.md → serpentine_parser-0.5.0/PKG-INFO

@@ -1,3 +1,48 @@
+Metadata-Version: 2.4
+Name: serpentine-parser
+Version: 0.5.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Requires-Dist: watchdog>=6.0.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: starlette>=1.3.1
+Requires-Dist: uvicorn[standard]>=0.30.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: google-cloud-storage>=2.0 ; extra == 'gcs'
+Requires-Dist: pygit2>=1.15 ; extra == 'git'
+Requires-Dist: fastmcp>=2.0 ; extra == 'mcp'
+Requires-Dist: httpx>=0.27 ; extra == 'mcp'
+Requires-Dist: pyjwt[crypto]>=2.8 ; extra == 'mcp'
+Requires-Dist: boto3>=1.34 ; extra == 's3'
+Provides-Extra: gcs
+Provides-Extra: git
+Provides-Extra: hg
+Provides-Extra: mcp
+Provides-Extra: s3
+Provides-Extra: svn
+License-File: LICENSE
+Summary: Fast dependency graph analysis and visualization for Python, JavaScript/TypeScript, Rust, and Terraform projects
+Keywords: dependency-graph,visualization,static-analysis,python,javascript,rust,terraform,tree-sitter
+Author: Christopher Garretty
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/serpentine-parser/serpentine
+Project-URL: Issues, https://github.com/serpentine-parser/serpentine/issues
+Project-URL: Repository, https://github.com/serpentine-parser/serpentine
+
 <p align="center">
   <img src="frontend/public/logo.svg" alt="Serpentine" width="64" />
 </p>
@@ -18,6 +63,7 @@ Serpentine builds a **code reference graph** for Python, JavaScript/TypeScript,
 - **Full reference resolution**: Traces calls, type annotations, assignments, and inheritance — not just import edges
 - **Interactive graph**: Expandable nodes, search, pan/zoom, collapsible modules
 - **Real-time updates**: File watcher pushes changes via WebSocket
+- **VCS integration**: Compare any two git refs and see added, modified, and deleted nodes highlighted on the graph
 - **Agent-ready CLI**: Structured JSON output with selectors for use in AI agent workflows
 
 ### What counts as a code reference?
@@ -307,6 +353,52 @@ Each edge has a `from` and `to` field with node IDs, and a `type` field:
 
 ---
 
+## VCS Integration
+
+When Serpentine is run inside a git repository, it automatically detects available refs (branches, tags, and recent commits) and enables the **compare** toolbar in the UI.
+
+### Comparing refs
+
+Click the compare toolbar to select a baseline ref and a target ref. Serpentine analyzes the graph at each ref and overlays change status on every node:
+
+| Status | Meaning |
+|---|---|
+| `modified` | Node exists in both refs but its dependencies changed |
+| `added` | Node exists in the target ref but not the baseline |
+| `deleted` | Node existed in the baseline ref but was removed |
+
+Unchanged nodes remain visible for context.
+
+### Filtering by state
+
+Use the `state:` selector method in the search bar to filter the graph to only changed nodes:
+
+```
+state:modified
+state:added
+state:deleted
+```
+
+Selectors compose with all graph operators:
+
+```
+# All nodes modified on the current branch, plus their upstream dependencies
++state:modified
+
+# Full connected component of every added node
+@state:added
+```
+
+### Checkpoints
+
+The **checkpoint** button marks the current live graph state as the comparison baseline. This is useful when you want to track changes made during a session rather than comparing against a git ref.
+
+### Configuration
+
+Files excluded via `.serpentine.yml` (`exclude_dirs`, `exclude_patterns`) are excluded from VCS snapshot analysis as well — ensuring consistent results between live analysis and historical comparison.
+
+---
+
 ## Configuration
 
 Serpentine looks for `.serpentine.yml` or `serpentine.yml` in the project root. All settings are optional.
@@ -448,3 +540,4 @@ These three events are the minimum required for the graph builder to resolve all
 ## License
 
 [Apache 2.0](LICENSE)
+

serpentine_parser-0.3.2/PKG-INFO → serpentine_parser-0.5.0/README.md

@@ -1,36 +1,3 @@
-Metadata-Version: 2.4
-Name: serpentine-parser
-Version: 0.3.2
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Environment :: Web Environment
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Rust
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Utilities
-Requires-Dist: watchdog>=6.0.0
-Requires-Dist: click>=8.1.0
-Requires-Dist: starlette>=0.38.0
-Requires-Dist: uvicorn[standard]>=0.30.0
-Requires-Dist: websockets>=12.0
-License-File: LICENSE
-Summary: Fast dependency graph analysis and visualization for Python, JavaScript/TypeScript, Rust, and Terraform projects
-Keywords: dependency-graph,visualization,static-analysis,python,javascript,rust,terraform,tree-sitter
-Author: Christopher Garretty
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Homepage, https://github.com/serpentine-parser/serpentine
-Project-URL: Issues, https://github.com/serpentine-parser/serpentine/issues
-Project-URL: Repository, https://github.com/serpentine-parser/serpentine
-
 <p align="center">
   <img src="frontend/public/logo.svg" alt="Serpentine" width="64" />
 </p>
@@ -51,6 +18,7 @@ Serpentine builds a **code reference graph** for Python, JavaScript/TypeScript,
 - **Full reference resolution**: Traces calls, type annotations, assignments, and inheritance — not just import edges
 - **Interactive graph**: Expandable nodes, search, pan/zoom, collapsible modules
 - **Real-time updates**: File watcher pushes changes via WebSocket
+- **VCS integration**: Compare any two git refs and see added, modified, and deleted nodes highlighted on the graph
 - **Agent-ready CLI**: Structured JSON output with selectors for use in AI agent workflows
 
 ### What counts as a code reference?
@@ -340,6 +308,52 @@ Each edge has a `from` and `to` field with node IDs, and a `type` field:
 
 ---
 
+## VCS Integration
+
+When Serpentine is run inside a git repository, it automatically detects available refs (branches, tags, and recent commits) and enables the **compare** toolbar in the UI.
+
+### Comparing refs
+
+Click the compare toolbar to select a baseline ref and a target ref. Serpentine analyzes the graph at each ref and overlays change status on every node:
+
+| Status | Meaning |
+|---|---|
+| `modified` | Node exists in both refs but its dependencies changed |
+| `added` | Node exists in the target ref but not the baseline |
+| `deleted` | Node existed in the baseline ref but was removed |
+
+Unchanged nodes remain visible for context.
+
+### Filtering by state
+
+Use the `state:` selector method in the search bar to filter the graph to only changed nodes:
+
+```
+state:modified
+state:added
+state:deleted
+```
+
+Selectors compose with all graph operators:
+
+```
+# All nodes modified on the current branch, plus their upstream dependencies
++state:modified
+
+# Full connected component of every added node
+@state:added
+```
+
+### Checkpoints
+
+The **checkpoint** button marks the current live graph state as the comparison baseline. This is useful when you want to track changes made during a session rather than comparing against a git ref.
+
+### Configuration
+
+Files excluded via `.serpentine.yml` (`exclude_dirs`, `exclude_patterns`) are excluded from VCS snapshot analysis as well — ensuring consistent results between live analysis and historical comparison.
+
+---
+
 ## Configuration
 
 Serpentine looks for `.serpentine.yml` or `serpentine.yml` in the project root. All settings are optional.
@@ -481,4 +495,3 @@ These three events are the minimum required for the graph builder to resolve all
 ## License
 
 [Apache 2.0](LICENSE)
-

{serpentine_parser-0.3.2 → serpentine_parser-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "serpentine-parser"
-version = "0.3.2"
+version = "0.5.0"
 description = "Fast dependency graph analysis and visualization for Python, JavaScript/TypeScript, Rust, and Terraform projects"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -30,11 +30,19 @@ classifiers = [
 dependencies = [
     "watchdog>=6.0.0",
     "click>=8.1.0",
-    "starlette>=0.38.0",
+    "starlette>=1.3.1",
     "uvicorn[standard]>=0.30.0",
     "websockets>=12.0",
 ]
 
+[project.optional-dependencies]
+mcp = ["fastmcp>=2.0", "httpx>=0.27", "PyJWT[crypto]>=2.8"]
+git = ["pygit2>=1.15"]
+gcs = ["google-cloud-storage>=2.0"]
+s3  = ["boto3>=1.34"]
+hg  = []
+svn = []
+
 [project.urls]
 Homepage = "https://github.com/serpentine-parser/serpentine"
 Repository = "https://github.com/serpentine-parser/serpentine"
@@ -65,4 +73,5 @@ dev = [
     "maturin>=1.9.4",
     "pre-commit>=4.6.0",
     "pytest>=8.0.0",
+    "hypothesis>=6.0",
 ]

{serpentine_parser-0.3.2 → serpentine_parser-0.5.0}/rust/Cargo.lock

@@ -4,18 +4,18 @@ version = 4
 
 [[package]]
 name = "aho-corasick"
-version = "1.1.4"
+version = "1.1.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ddd31a130427c27518df266943a5308ed92d4b226cc639f5a8f1002816174301"
+checksum = "c982642fa9e8606056828ee9a8505737230110bb1099153c79efe865c59d12ba"
 dependencies = [
  "memchr",
 ]
 
 [[package]]
 name = "cc"
-version = "1.2.65"
+version = "1.4.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e228eec9be7c17ccb640b59b36a5cd805ea2a564a4c5e162c2f659fea30d3b96"
+checksum = "509591b7bcd67f4ef775afad7662703b4935daaa6ec0e5605cfb1090b32a2b6d"
 dependencies = [
  "find-msvc-tools",
  "shlex",
@@ -23,9 +23,9 @@ dependencies = [
 
 [[package]]
 name = "crossbeam-deque"
-version = "0.8.6"
+version = "0.8.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9dd111b7b7f7d55b72c0a6ae361660ee5853c9af73f70c3c2ef6858b950e2e51"
+checksum = "5181e0de7b61eb03a81e347d6dd8797bae9da5146707b51077e2d71a54ec0ceb"
 dependencies = [
  "crossbeam-epoch",
  "crossbeam-utils",
@@ -33,24 +33,24 @@ dependencies = [
 
 [[package]]
 name = "crossbeam-epoch"
-version = "0.9.18"
+version = "0.9.20"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b82ac4a3c2ca9c3460964f020e1402edd5753411d7737aa39c3714ad1b5420e"
+checksum = "2d6914041f254d6e9176c01941b21115dcfb7089e55135a35411081bd106ef3f"
 dependencies = [
  "crossbeam-utils",
 ]
 
 [[package]]
 name = "crossbeam-utils"
-version = "0.8.21"
+version = "0.8.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28"
+checksum = "61803da095bee82a81bb1a452ecc25d3b2f1416d1897eb86430c6159ef717c17"
 
 [[package]]
 name = "either"
-version = "1.16.0"
+version = "1.17.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "91622ff5e7162018101f2fea40d6ebf4a78bbe5a49736a2020649edf9693679e"
+checksum = "9e5e8f6c15a24b9a3ee5efec809ccd006d3b30e8b3bb63c39af737c7f87daa1d"
 
 [[package]]
 name = "equivalent"
@@ -60,9 +60,9 @@ checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
 
 [[package]]
 name = "find-msvc-tools"
-version = "0.1.9"
+version = "0.1.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5baebc0774151f905a1a2cc41989300b1e6fbb29aff0ceffa1064fdd3088d582"
+checksum = "d45db016d36b838f563236e9193d0ee6ce38f3f68b6c94e914b4929c96bbb890"
 
 [[package]]
 name = "hashbrown"
@@ -94,15 +94,15 @@ checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
 
 [[package]]
 name = "libc"
-version = "0.2.186"
+version = "0.2.189"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
+checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
 
 [[package]]
 name = "memchr"
-version = "2.8.2"
+version = "2.8.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "88904434abc2901f197fe8cc55f0445e7ded921dba5911dad2e2b39b48e663c4"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
 
 [[package]]
 name = "once_cell"
@@ -112,24 +112,24 @@ checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
 
 [[package]]
 name = "portable-atomic"
-version = "1.13.1"
+version = "1.15.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.106"
+version = "1.0.107"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
 dependencies = [
  "unicode-ident",
 ]
 
 [[package]]
 name = "pyo3"
-version = "0.29.0"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cd274650b21d4bfc26a0a47587962c1edb425f69287324355cd040c3ea66071c"
+checksum = "4688ddedf473e32662b9b067670129a8afb8c18e351482c70d62ba4a88171e8b"
 dependencies = [
  "libc",
  "once_cell",
@@ -141,18 +141,18 @@ dependencies = [
 
 [[package]]
 name = "pyo3-build-config"
-version = "0.29.0"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c5e2a7d2f0d013342f295c048ad19237add5154a55b1c5a254c0ec93d4109078"
+checksum = "f41027e41b4bd03f6e60f9f417fe24a6341a6bb744edd62b6f709f2a52ea30e9"
 dependencies = [
  "target-lexicon",
 ]
 
 [[package]]
 name = "pyo3-ffi"
-version = "0.29.0"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ca85c467da1bbc8d866eea5deff9cf29ea5f7785054a17da36e65bda9c05845b"
+checksum = "e591a95526fead067432c3b3a33fc74770b87b1e04e73671090d9c2055a2b327"
 dependencies = [
  "libc",
  "pyo3-build-config",
@@ -160,33 +160,33 @@ dependencies = [
 
 [[package]]
 name = "pyo3-macros"
-version = "0.29.0"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ac53762fd065daa3194dd09337a38bd793a188100fd1a9304c4ab312d901771"
+checksum = "73225868fc1cd84eef2c3c230ddb91273bf1de46aeb8a4248da76d32a0924a1c"
 dependencies = [
  "proc-macro2",
  "pyo3-macros-backend",
  "quote",
- "syn",
+ "syn 2.0.119",
 ]
 
 [[package]]
 name = "pyo3-macros-backend"
-version = "0.29.0"
+version = "0.29.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4ca3a1557399783172dc5bf39cfca835157732532cba56b71d2292161e53b362"
+checksum = "571575aa3749fa6216757dd47d2a3e7ef360f329a40f0666a9fbd14889024952"
 dependencies = [
  "heck",
  "proc-macro2",
  "quote",
- "syn",
+ "syn 2.0.119",
 ]
 
 [[package]]
 name = "quote"
-version = "1.0.45"
+version = "1.0.47"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
 dependencies = [
  "proc-macro2",
 ]
@@ -213,9 +213,9 @@ dependencies = [
 
 [[package]]
 name = "regex"
-version = "1.12.4"
+version = "1.13.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f1292b7759ae1cb9ec195452d1390a074f0cd8541ab7a5a8c31cd6db45d4a6ba"
+checksum = "f020237b6c8eed93db2e2cb53c00c60a8e1bc73da7d073199a1180401450218d"
 dependencies = [
  "aho-corasick",
  "memchr",
@@ -225,9 +225,9 @@ dependencies = [
 
 [[package]]
 name = "regex-automata"
-version = "0.4.14"
+version = "0.4.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6e1dd4122fc1595e8162618945476892eefca7b88c52820e74af6262213cae8f"
+checksum = "ad8553b9b26413251cbf30e620595c7a41b3887f03da04579c0e6b0d6a06b4b2"
 dependencies = [
  "aho-corasick",
  "memchr",
@@ -242,9 +242,9 @@ checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
 
 [[package]]
 name = "serde"
-version = "1.0.228"
+version = "1.0.229"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+checksum = "4148590afebada386688f18773da617792bf2ef03ffc1e4cbd2b1d45b023e0ba"
 dependencies = [
  "serde_core",
  "serde_derive",
@@ -252,29 +252,29 @@ dependencies = [
 
 [[package]]
 name = "serde_core"
-version = "1.0.228"
+version = "1.0.229"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+checksum = "67dca2c9c51e58a4791a4b1ed58308b39c64224d349a935ab5039aa360942a48"
 dependencies = [
  "serde_derive",
 ]
 
 [[package]]
 name = "serde_derive"
-version = "1.0.228"
+version = "1.0.229"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+checksum = "e7a5d71263a5a7d47b41f6b3f06ba276f10cc18b0931f1799f710578e2309348"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn",
+ "syn 3.0.3",
 ]
 
 [[package]]
 name = "serde_json"
-version = "1.0.150"
+version = "1.0.151"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e8014e44b4736ed0538adeecded0fce2a272f22dc9578a7eb6b2d9993c74cfb9"
+checksum = "c841b55ecdae098c80dcae9cf767f6f8a0c2cdb3416bbef72181df4d0fe73f14"
 dependencies = [
  "indexmap",
  "itoa",
@@ -286,7 +286,7 @@ dependencies = [
 
 [[package]]
 name = "serpentine"
-version = "0.3.2"
+version = "0.5.0"
 dependencies = [
  "indexmap",
  "pyo3",
@@ -315,9 +315,20 @@ checksum = "2b2231b7c3057d5e4ad0156fb3dc807d900806020c5ffa3ee6ff2c8c76fb8520"
 
 [[package]]
 name = "syn"
-version = "2.0.118"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "syn"
+version = "3.0.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b9ae57f904213ebb649ce6895b8a66c66f0203b9319718f69a5612a065b1422"
+checksum = "53e9bae58849f64dfa4f5d5ae372c8341f7305f82a3868709269343628b659a3"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -408,6 +419,6 @@ checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
 
 [[package]]
 name = "zmij"
-version = "1.0.21"
+version = "1.0.23"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"
+checksum = "29666d0abbfad1e3dc4dcf6144730dd3a3ab225bbbdac83319345b1b44ccfc1b"

{serpentine_parser-0.3.2 → serpentine_parser-0.5.0}/rust/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "serpentine"
-version = "0.3.2"
+version = "0.5.0"
 edition = "2021"
 license = "Apache-2.0"
 

{serpentine_parser-0.3.2 → serpentine_parser-0.5.0}/rust/src/graph/builder.rs

@@ -233,7 +233,11 @@ impl GraphBuilder {
                     children.retain(|c| c != qualname.as_str());
                 }
             }
-            self.hierarchy_children.shift_remove(qualname.as_str());
+            // Do NOT shift_remove hierarchy_children[qualname] here — other files
+            // may have registered children under this qualname (e.g. test_package.app
+            // registered as a child of test_package even when test_package is owned by
+            // a different file). write_node_json guards on definitions.contains_key(child)
+            // so orphaned empty entries are harmless.
             // Invalidate the per-node JSON fragment cache entry
             self.node_json_cache.remove(qualname.as_str());
             // Mark the top-level subtree dirty so snapshot rebuilds it

{serpentine_parser-0.3.2 → serpentine_parser-0.5.0}/src/serpentine/__init__.py

@@ -22,7 +22,7 @@ Or programmatically:
     app = create_app(state)
 """
 
-__version__ = "0.3.2"
+__version__ = "0.5.0"
 
 from serpentine.server import create_app
 from serpentine.state import GraphStateManager

serpentine_parser-0.5.0/src/serpentine/adapters.py

@@ -0,0 +1,28 @@
+"""
+Infrastructure adapters implementing domain protocols.
+"""
+
+from pathlib import Path
+from typing import Any
+
+from serpentine.services import SourceProvider  # noqa: F401 — re-export for convenience
+
+
+class DiskSourceProvider:
+    """Reads files from the local filesystem."""
+    def get_file(self, path: str) -> str | None:
+        try:
+            return Path(path).read_text(encoding="utf-8")
+        except OSError:
+            return None
+
+
+class VcsSourceProvider:
+    """Reads files from a VCS backend at a specific ref."""
+    def __init__(self, backend: Any, ref: str) -> None:
+        self._backend = backend
+        self._ref = ref
+
+    def get_file(self, path: str) -> str | None:
+        content = self._backend.get_file_at(self._ref, path)
+        return content.decode("utf-8", errors="replace") if content else None