enforce-cpg 0.2.0__tar.gz

enforce_cpg-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,12 @@
+name: ci
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv python install 3.12
+      - run: uv sync --dev
+      - run: uv run ruff check src tests
+      - run: uv run pytest -v

enforce_cpg-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,41 @@
+# Publish enforce-cpg to PyPI on a version tag. Pure-Python: one wheel + sdist.
+# The grammar (tree-sitter-enforce) must already be on PyPI so the clean-venv
+# smoke install below can resolve it.
+name: pypi-release
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch: {}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv build
+      - name: smoke-test the built wheel in a clean venv (resolves deps from PyPI)
+        run: |
+          python -m venv /tmp/smoke
+          /tmp/smoke/bin/pip install --upgrade pip
+          /tmp/smoke/bin/pip install dist/*.whl
+          /tmp/smoke/bin/enforce-cpg --version
+          /tmp/smoke/bin/python -c "from enforce_cpg import parser; t = parser.parse(b'class A{}'); assert not t.root_node.has_error; print('grammar+parse OK')"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    if: ${{ github.event_name == 'push' }}  # only tag pushes reach here; dispatch = build+smoke only
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

enforce_cpg-0.2.0/.gitignore

@@ -0,0 +1,8 @@
+.enforce-cpg/
+__pycache__/
+*.pyc
+.venv/
+dist/
+build/
+*.egg-info/
+/enforce-cpg.toml

enforce_cpg-0.2.0/LICENSE

@@ -0,0 +1,85 @@
+Attribution Assurance License (AAL)
+
+Copyright (c) 2026 tommyz4
+https://github.com/tommyz4/enforce-cpg
+
+The following is the full, official text of the Open Source Initiative (OSI)
+approved Attribution Assurance License (SPDX identifier: AAL), as published
+at https://opensource.org/license/aal, with the license's own attribution
+fields filled in for this project: Author = tommyz4; Professional
+Identification = enforce-cpg maintainer; URL = https://github.com/tommyz4/enforce-cpg.
+
+--------------------------------------------------------------------------
+
+Copyright (c) 2026 tommyz4
+
+tommyz4, enforce-cpg maintainer * https://github.com/tommyz4/enforce-cpg
+
+"enforce-cpg: Code Property Graph MCP server for DayZ Enforce Script"
+
+All Rights Reserved
+
+ATTRIBUTION ASSURANCE LICENSE (adapted from the original BSD license)
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the conditions below are met.
+
+These conditions require a modest attribution to tommyz4 (the "Author"), who
+hopes that its promotional value may help justify the thousands of dollars in
+otherwise billable time invested in writing this and other freely available,
+open-source software.
+
+1. Redistributions of source code, in whole or part and with or without
+modification (the "Code"), must prominently display this GPG-signed text in
+verifiable form.
+
+2. Redistributions of the Code in binary form must be accompanied by this
+GPG-signed text in any documentation and, each time the resulting executable
+program or a program dependent thereon is launched, a prominent display
+(e.g., splash screen or banner text) of the Author's attribution
+information, which includes:
+
+(a) Name ("tommyz4"),
+
+(b) Professional identification ("enforce-cpg maintainer"), and
+
+(c) URL ("https://github.com/tommyz4/enforce-cpg").
+
+3. Neither the name nor any trademark of the Author may be used to endorse
+or promote products derived from this software without specific prior
+written permission.
+
+4. Users are entirely responsible, to the exclusion of the Author and any
+other persons, for compliance with
+
+(1) regulations set by owners or administrators of employed equipment,
+
+(2) licensing terms of any other software, and
+
+(3) local regulations regarding use, including those regarding import,
+export, and use of encryption software.
+
+THIS FREE SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
+EVENT SHALL THE AUTHOR OR ANY CONTRIBUTOR BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, EFFECTS OF UNAUTHORIZED OR MALICIOUS NETWORK
+ACCESS; PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+--End of License
+
+Originally written by Edwin A. Suominen for licensing his PRIVARIA secure
+networking software (see www.privaria.org). The author, who is not an
+attorney, places this license template into the public domain along with a
+complete disclaimer of any warranty or responsibility for its content or
+legal efficacy. You may use or modify the language freely, but entirely at
+your own risk.
+
+--------------------------------------------------------------------------
+
+Source: https://opensource.org/license/aal (fetched 2026-07-24).

enforce_cpg-0.2.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include NOTICE
+include README.md

enforce_cpg-0.2.0/NOTICE

@@ -0,0 +1,9 @@
+enforce-cpg
+Copyright (c) 2026 tommyz4
+https://github.com/tommyz4/enforce-cpg
+
+This product includes software developed by tommyz4.
+Licensed under the Attribution Assurance License (AAL).
+
+Attribution Notice (must be displayed per AAL clause):
+  enforce-cpg — © 2026 tommyz4 — https://github.com/tommyz4/enforce-cpg

enforce_cpg-0.2.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: enforce-cpg
+Version: 0.2.0
+Summary: Code Property Graph MCP server for DayZ Enforce Script
+Project-URL: Homepage, https://github.com/tommyz4/enforce-cpg
+Project-URL: Repository, https://github.com/tommyz4/enforce-cpg
+Project-URL: Issues, https://github.com/tommyz4/enforce-cpg/issues
+Author: tommyz4
+License-Expression: AAL
+License-File: LICENSE
+License-File: NOTICE
+Keywords: code-property-graph,dayz,enforce,enfusion,mcp,tree-sitter
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Attribution Assurance License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.12
+Requires-Dist: mcp>=1.2
+Requires-Dist: tree-sitter-enforce>=0.4
+Requires-Dist: tree-sitter>=0.25
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="assets/logo.svg" alt="enforce-cpg — Code Property Graph for Enforce Script" width="460">
+</p>
+
+<h1 align="center">enforce-cpg</h1>
+
+A Code Property Graph (CPG) MCP server for **DayZ Enforce Script**.
+
+It parses Enforce Script (`.c`) source across a vanilla/base layer and any
+number of mod layers, builds a graph of declarations, inheritance,
+overrides, and calls, and exposes that graph over the [Model Context
+Protocol](https://modelcontextprotocol.io) so an AI coding assistant (e.g.
+Claude Code) can answer real DayZ-modding questions: "what overrides
+`Speak` on `Animal`?", "who calls this method?", "what breaks if I change
+this field?" — across a real, multi-mod, load-order-dependent codebase,
+without ever crashing on a bad file or an unresolved reference.
+
+## Install
+
+```bash
+pip install enforce-cpg        # or: uvx enforce-cpg --version
+```
+
+No compiler needed — the Enforce grammar ships as prebuilt wheels
+([`tree-sitter-enforce`](https://pypi.org/project/tree-sitter-enforce/)).
+
+Or, from a local checkout:
+
+```bash
+uv sync
+uv run enforce-cpg --version
+```
+
+## Configure
+
+Point `enforce-cpg` at your vanilla scripts and mod source trees with an
+`enforce-cpg.toml` file (see `enforce-cpg.example.toml`):
+
+```toml
+[project]
+name = "my-server"
+db_path = ".enforce-cpg/index.db"
+
+# ORDERED: earlier = loaded first = base precedence. This IS your -mod= order.
+[[sources]]
+name = "vanilla"
+kind = "core"
+path = "/path/to/vanilla_scripts"
+
+[[sources]]
+name = "MyMod"
+kind = "mod"
+path = "/path/to/MyMod/Scripts"
+```
+
+**Load-order warning:** the order of `[[sources]]` in this file *is* the
+override precedence used to resolve `Animal.Speak`-style method stacks —
+it must mirror your server's real `-mod=` load order. A source listed
+earlier is treated as the base that later sources override; get this
+wrong and `resolve_method` / `get_inheritance` will report the wrong
+override winner.
+
+Build (or rebuild) the index:
+
+```bash
+uv run enforce-cpg index --config enforce-cpg.toml --full
+```
+
+## Tools
+
+Once registered with an MCP client, enforce-cpg exposes 12 tools:
+
+| Tool | Description |
+| --- | --- |
+| `reindex` | Rebuild the code property graph index. `full=true` forces a from-scratch rebuild; otherwise only changed files are re-indexed. |
+| `find_symbol` | Find declarations of a symbol by name (optionally filtered by kind). |
+| `find_references` | Find references to a symbol by name (optionally filtered by kind; declaration sites excluded by default). |
+| `find_callers` | Find callers of a class method, transitively up to the given depth. |
+| `resolve_method` | Resolve a method call to its override stack across the source layers (core -> mods), in resolution order, flagging cut chains. |
+| `get_inheritance` | Get the inheritance chain for a class, optionally scoped to a method. |
+| `impact_of_change` | Estimate the blast radius of changing a class member. |
+| `get_overview` | Get a structural overview of a file or a class. |
+| `audit_overrides` | Corpus-wide override audit: every modded layer that overrides without `super`, silently disabling earlier layers. |
+| `mod_surface` | Every method a given source overrides that another source also defines — the mod's footprint on the shared hierarchy. |
+| `doctor` | Setup + index-health report: sources resolved, per-source parse coverage, missing-vanilla warning, diagnostics, unresolved hotspots. |
+| `ingest` | Register a source from an extracted directory (always) or a `.pbo` (de-rapified if a tool is available), copied under `.enforce-cpg/sources/` with the `[[sources]]` entry added. |
+
+The same surface is available on the CLI (`enforce-cpg find-symbol`,
+`… audit`, `… mod-surface --source <name>`, `… doctor`,
+`… ingest <path> --name <n> --kind core|mod`, …).
+
+Every tool degrades honestly instead of crashing: an unresolved symbol or
+a missing argument returns `{"results": [], "note": "..."}` rather than an
+exception, so a single bad query never takes down the server.
+
+## Register with Claude Code
+
+```bash
+claude mcp add enforce-cpg -- uvx enforce-cpg-mcp
+```
+
+The server reads its config from the `ENFORCE_CPG_CONFIG` environment
+variable (defaults to `enforce-cpg.toml` in the working directory), so
+set that to your project's config path when registering.
+
+## License
+
+enforce-cpg is licensed under the **Attribution Assurance License (AAL)**,
+an OSI-approved open-source license. The full license text is in
+[`LICENSE`](./LICENSE); the required attribution notice is in
+[`NOTICE`](./NOTICE).
+
+Attribution notice (must be displayed per the AAL's attribution clause):
+
+```
+enforce-cpg — © 2026 tommyz4 — https://github.com/tommyz4/enforce-cpg
+```

enforce_cpg-0.2.0/README.md

@@ -0,0 +1,117 @@
+<p align="center">
+  <img src="assets/logo.svg" alt="enforce-cpg — Code Property Graph for Enforce Script" width="460">
+</p>
+
+<h1 align="center">enforce-cpg</h1>
+
+A Code Property Graph (CPG) MCP server for **DayZ Enforce Script**.
+
+It parses Enforce Script (`.c`) source across a vanilla/base layer and any
+number of mod layers, builds a graph of declarations, inheritance,
+overrides, and calls, and exposes that graph over the [Model Context
+Protocol](https://modelcontextprotocol.io) so an AI coding assistant (e.g.
+Claude Code) can answer real DayZ-modding questions: "what overrides
+`Speak` on `Animal`?", "who calls this method?", "what breaks if I change
+this field?" — across a real, multi-mod, load-order-dependent codebase,
+without ever crashing on a bad file or an unresolved reference.
+
+## Install
+
+```bash
+pip install enforce-cpg        # or: uvx enforce-cpg --version
+```
+
+No compiler needed — the Enforce grammar ships as prebuilt wheels
+([`tree-sitter-enforce`](https://pypi.org/project/tree-sitter-enforce/)).
+
+Or, from a local checkout:
+
+```bash
+uv sync
+uv run enforce-cpg --version
+```
+
+## Configure
+
+Point `enforce-cpg` at your vanilla scripts and mod source trees with an
+`enforce-cpg.toml` file (see `enforce-cpg.example.toml`):
+
+```toml
+[project]
+name = "my-server"
+db_path = ".enforce-cpg/index.db"
+
+# ORDERED: earlier = loaded first = base precedence. This IS your -mod= order.
+[[sources]]
+name = "vanilla"
+kind = "core"
+path = "/path/to/vanilla_scripts"
+
+[[sources]]
+name = "MyMod"
+kind = "mod"
+path = "/path/to/MyMod/Scripts"
+```
+
+**Load-order warning:** the order of `[[sources]]` in this file *is* the
+override precedence used to resolve `Animal.Speak`-style method stacks —
+it must mirror your server's real `-mod=` load order. A source listed
+earlier is treated as the base that later sources override; get this
+wrong and `resolve_method` / `get_inheritance` will report the wrong
+override winner.
+
+Build (or rebuild) the index:
+
+```bash
+uv run enforce-cpg index --config enforce-cpg.toml --full
+```
+
+## Tools
+
+Once registered with an MCP client, enforce-cpg exposes 12 tools:
+
+| Tool | Description |
+| --- | --- |
+| `reindex` | Rebuild the code property graph index. `full=true` forces a from-scratch rebuild; otherwise only changed files are re-indexed. |
+| `find_symbol` | Find declarations of a symbol by name (optionally filtered by kind). |
+| `find_references` | Find references to a symbol by name (optionally filtered by kind; declaration sites excluded by default). |
+| `find_callers` | Find callers of a class method, transitively up to the given depth. |
+| `resolve_method` | Resolve a method call to its override stack across the source layers (core -> mods), in resolution order, flagging cut chains. |
+| `get_inheritance` | Get the inheritance chain for a class, optionally scoped to a method. |
+| `impact_of_change` | Estimate the blast radius of changing a class member. |
+| `get_overview` | Get a structural overview of a file or a class. |
+| `audit_overrides` | Corpus-wide override audit: every modded layer that overrides without `super`, silently disabling earlier layers. |
+| `mod_surface` | Every method a given source overrides that another source also defines — the mod's footprint on the shared hierarchy. |
+| `doctor` | Setup + index-health report: sources resolved, per-source parse coverage, missing-vanilla warning, diagnostics, unresolved hotspots. |
+| `ingest` | Register a source from an extracted directory (always) or a `.pbo` (de-rapified if a tool is available), copied under `.enforce-cpg/sources/` with the `[[sources]]` entry added. |
+
+The same surface is available on the CLI (`enforce-cpg find-symbol`,
+`… audit`, `… mod-surface --source <name>`, `… doctor`,
+`… ingest <path> --name <n> --kind core|mod`, …).
+
+Every tool degrades honestly instead of crashing: an unresolved symbol or
+a missing argument returns `{"results": [], "note": "..."}` rather than an
+exception, so a single bad query never takes down the server.
+
+## Register with Claude Code
+
+```bash
+claude mcp add enforce-cpg -- uvx enforce-cpg-mcp
+```
+
+The server reads its config from the `ENFORCE_CPG_CONFIG` environment
+variable (defaults to `enforce-cpg.toml` in the working directory), so
+set that to your project's config path when registering.
+
+## License
+
+enforce-cpg is licensed under the **Attribution Assurance License (AAL)**,
+an OSI-approved open-source license. The full license text is in
+[`LICENSE`](./LICENSE); the required attribution notice is in
+[`NOTICE`](./NOTICE).
+
+Attribution notice (must be displayed per the AAL's attribution clause):
+
+```
+enforce-cpg — © 2026 tommyz4 — https://github.com/tommyz4/enforce-cpg
+```

enforce_cpg-0.2.0/assets/logo.svg

@@ -0,0 +1,39 @@
+<svg width="560" height="160" viewBox="0 0 560 160" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="enforce-cpg">
+  <defs>
+    <linearGradient id="tileL" x1="0" y1="0" x2="160" y2="160" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#0C1524"/>
+      <stop offset="1" stop-color="#111F33"/>
+    </linearGradient>
+    <linearGradient id="chainL" x1="52" y1="118" x2="116" y2="42" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#64748B"/>
+      <stop offset="0.55" stop-color="#38BDF8"/>
+      <stop offset="1" stop-color="#22D3EE"/>
+    </linearGradient>
+    <radialGradient id="glowL" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(114 44) scale(34)">
+      <stop stop-color="#22D3EE" stop-opacity="0.55"/>
+      <stop offset="1" stop-color="#22D3EE" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+
+  <!-- mark -->
+  <g>
+    <rect x="2" y="2" width="156" height="156" rx="36" fill="url(#tileL)" stroke="#1E2E45" stroke-width="2"/>
+    <path d="M52 116 L30 128" stroke="#2A3B55" stroke-width="3" stroke-linecap="round"/>
+    <path d="M82 82 L128 100" stroke="#2A3B55" stroke-width="3" stroke-linecap="round"/>
+    <circle cx="28" cy="130" r="6" fill="#243349" stroke="#33475F" stroke-width="2"/>
+    <circle cx="132" cy="102" r="7" fill="#243349" stroke="#33475F" stroke-width="2"/>
+    <path d="M52 114 L82 82 L114 46" stroke="url(#chainL)" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
+    <circle cx="114" cy="44" r="30" fill="url(#glowL)"/>
+    <circle cx="50" cy="116" r="13" fill="#1B2A40" stroke="#475569" stroke-width="3"/>
+    <circle cx="82" cy="82" r="13" fill="#F59E0B" stroke="#FBBF24" stroke-width="2"/>
+    <circle cx="114" cy="44" r="16" fill="#22D3EE" stroke="#A5F3FC" stroke-width="2.5"/>
+  </g>
+
+  <!-- wordmark -->
+  <g font-family="ui-monospace, 'SF Mono', 'JetBrains Mono', 'Cascadia Code', Menlo, Consolas, monospace">
+    <text x="196" y="82" font-size="46" font-weight="700" letter-spacing="-1">
+      <tspan fill="#E2E8F0">enforce</tspan><tspan fill="#22D3EE">-cpg</tspan>
+    </text>
+    <text x="198" y="112" font-size="17.5" font-weight="500" letter-spacing="0.5" fill="#7C8CA5">Code Property Graph for Enforce Script</text>
+  </g>
+</svg>

enforce_cpg-0.2.0/assets/mark.svg

@@ -0,0 +1,38 @@
+<svg width="160" height="160" viewBox="0 0 160 160" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="enforce-cpg mark">
+  <defs>
+    <linearGradient id="tile" x1="0" y1="0" x2="160" y2="160" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#0C1524"/>
+      <stop offset="1" stop-color="#111F33"/>
+    </linearGradient>
+    <linearGradient id="chain" x1="52" y1="118" x2="116" y2="42" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#64748B"/>
+      <stop offset="0.55" stop-color="#38BDF8"/>
+      <stop offset="1" stop-color="#22D3EE"/>
+    </linearGradient>
+    <radialGradient id="glow" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(114 44) scale(34)">
+      <stop stop-color="#22D3EE" stop-opacity="0.55"/>
+      <stop offset="1" stop-color="#22D3EE" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+
+  <rect x="2" y="2" width="156" height="156" rx="36" fill="url(#tile)" stroke="#1E2E45" stroke-width="2"/>
+
+  <!-- faint satellite edges (references / callers) -> gives the graph feel -->
+  <path d="M52 116 L30 128" stroke="#2A3B55" stroke-width="3" stroke-linecap="round"/>
+  <path d="M82 82 L128 100" stroke="#2A3B55" stroke-width="3" stroke-linecap="round"/>
+  <circle cx="28" cy="130" r="6" fill="#243349" stroke="#33475F" stroke-width="2"/>
+  <circle cx="132" cy="102" r="7" fill="#243349" stroke="#33475F" stroke-width="2"/>
+
+  <!-- the override stack: base -> modded -> resolved (main chain) -->
+  <path d="M52 114 L82 82 L114 46" stroke="url(#chain)" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- glow behind the resolved node -->
+  <circle cx="114" cy="44" r="30" fill="url(#glow)"/>
+
+  <!-- base node (vanilla / lowest precedence) -->
+  <circle cx="50" cy="116" r="13" fill="#1B2A40" stroke="#475569" stroke-width="3"/>
+  <!-- modded layer node -->
+  <circle cx="82" cy="82" r="13" fill="#F59E0B" stroke="#FBBF24" stroke-width="2"/>
+  <!-- resolved / effective node (top of stack) -->
+  <circle cx="114" cy="44" r="16" fill="#22D3EE" stroke="#A5F3FC" stroke-width="2.5"/>
+</svg>

enforce_cpg-0.2.0/assets/social-preview.svg

@@ -0,0 +1,48 @@
+<svg width="1280" height="640" viewBox="0 0 1280 640" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1280" y2="640" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#070D18"/>
+      <stop offset="1" stop-color="#0E1B2E"/>
+    </linearGradient>
+    <linearGradient id="tileS" x1="0" y1="0" x2="220" y2="220" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#0C1524"/><stop offset="1" stop-color="#111F33"/>
+    </linearGradient>
+    <linearGradient id="chainS" x1="70" y1="162" x2="158" y2="58" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#64748B"/><stop offset="0.55" stop-color="#38BDF8"/><stop offset="1" stop-color="#22D3EE"/>
+    </linearGradient>
+    <radialGradient id="glowS" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(156 60) scale(46)">
+      <stop stop-color="#22D3EE" stop-opacity="0.5"/><stop offset="1" stop-color="#22D3EE" stop-opacity="0"/>
+    </radialGradient>
+    <radialGradient id="halo" cx="0" cy="0" r="1" gradientUnits="userSpaceOnUse" gradientTransform="translate(340 300) scale(520)">
+      <stop stop-color="#123049" stop-opacity="0.6"/><stop offset="1" stop-color="#123049" stop-opacity="0"/>
+    </radialGradient>
+  </defs>
+
+  <rect width="1280" height="640" fill="url(#bg)"/>
+  <circle cx="340" cy="300" r="520" fill="url(#halo)"/>
+
+  <!-- mark, scaled up and centered-left -->
+  <g transform="translate(150 150) scale(1.36)">
+    <rect x="2" y="2" width="216" height="216" rx="50" fill="url(#tileS)" stroke="#1E2E45" stroke-width="2.5"/>
+    <path d="M70 160 L40 178" stroke="#2A3B55" stroke-width="4" stroke-linecap="round"/>
+    <path d="M112 112 L176 138" stroke="#2A3B55" stroke-width="4" stroke-linecap="round"/>
+    <circle cx="38" cy="180" r="8" fill="#243349" stroke="#33475F" stroke-width="2.5"/>
+    <circle cx="180" cy="140" r="9" fill="#243349" stroke="#33475F" stroke-width="2.5"/>
+    <path d="M70 158 L112 112 L156 64" stroke="url(#chainS)" stroke-width="7" stroke-linecap="round" stroke-linejoin="round"/>
+    <circle cx="156" cy="60" r="42" fill="url(#glowS)"/>
+    <circle cx="68" cy="160" r="18" fill="#1B2A40" stroke="#475569" stroke-width="4"/>
+    <circle cx="112" cy="112" r="18" fill="#F59E0B" stroke="#FBBF24" stroke-width="2.5"/>
+    <circle cx="156" cy="60" r="22" fill="#22D3EE" stroke="#A5F3FC" stroke-width="3"/>
+  </g>
+
+  <g font-family="ui-monospace, 'JetBrains Mono', 'SF Mono', Menlo, Consolas, monospace">
+    <text x="530" y="270" font-size="82" font-weight="700" letter-spacing="-2"><tspan fill="#E8EEF6">enforce</tspan><tspan fill="#22D3EE">-cpg</tspan></text>
+    <text x="534" y="330" font-size="30" font-weight="500" fill="#93A3BC">Code Property Graph MCP server for DayZ Enforce Script</text>
+  </g>
+
+  <!-- feature line -->
+  <g font-family="ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif">
+    <text x="534" y="420" font-size="25" fill="#5D7290">resolve modded-override chains · call graph · inheritance · impact</text>
+    <text x="534" y="470" font-size="21" font-weight="600" fill="#6B7F9C">AAL-licensed · pip / uvx · tree-sitter</text>
+  </g>
+</svg>