dvm-eahelper 0.1.0__tar.gz

dvm_eahelper-0.1.0/.env.example

@@ -0,0 +1,3 @@
+NEO4J_URI=bolt://localhost:7687
+NEO4J_USERNAME=neo4j
+NEO4J_PASSWORD=your-password-here

dvm_eahelper-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/dvm-eahelper
+    permissions:
+      id-token: write   # required for Trusted Publishing (OIDC — no token needed)
+
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

dvm_eahelper-0.1.0/.gitignore

@@ -0,0 +1,55 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# uv
+.uv/
+
+# Distribution / packaging
+*.egg
+MANIFEST
+.installed.cfg
+lib/
+lib64/
+
+# Testing & coverage
+.pytest_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+
+# Type checkers
+.mypy_cache/
+.pytype/
+.ruff_cache/
+
+# IDE & editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project-specific
+~/.lean-ix/
+leanix-graphql.pdf
+# eahelper
+_version.py
+eahelper-kuzu-db/
+data/leanix/
+.env
+*.kuzu

dvm_eahelper-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 divyavanmahajan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dvm_eahelper-0.1.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: dvm-eahelper
+Version: 0.1.0
+Summary: LeanIX enterprise-architecture helper: GraphQL proxy, factsheet download, and graph loading into KuzuDB or Neo4j
+Project-URL: Homepage, https://github.com/divyavanmahajan/dvm-eahelper
+Project-URL: Source, https://github.com/divyavanmahajan/dvm-eahelper
+Project-URL: Bug Tracker, https://github.com/divyavanmahajan/dvm-eahelper/issues
+Author-email: Divya Van Mahajan <divyavanmahajan@users.noreply.github.com>
+License: MIT
+License-File: LICENSE
+Keywords: enterprise-architecture,graphql,kuzu,leanix,neo4j
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.115
+Requires-Dist: httpx>=0.27
+Requires-Dist: kuzu>=0.7
+Requires-Dist: neo4j>=5.0
+Requires-Dist: playwright>=1.49
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: uvicorn[standard]>=0.32
+Description-Content-Type: text/markdown
+
+# dvm-eahelper — LeanIX Enterprise Architecture Helper
+
+Successor to [`dvm-leanix`](https://github.com/divyavanmahajan/dvm-leanix) and
+[`dvm-eagraph`](https://github.com/divyavanmahajan/dvm-eagraph), combined into a single package.
+
+One CLI (`eahelper`) to:
+
+- Run a local **GraphQL proxy** to SAP LeanIX — extracts the Bearer token from your
+  already-logged-in browser via Playwright CDP, serves GraphiQL for exploration
+- **Download** factsheets and relationships as JSON
+- **Load** them into a graph database — **KuzuDB** (embedded, default) or **Neo4j**
+
+Works on **Windows** and **macOS**.
+
+## Installation
+
+```bash
+uv tool install dvm-eahelper        # or: pip install dvm-eahelper
+uvx playwright install chromium     # one-time, for the proxy
+```
+
+## Quick start
+
+### 1. Launch a debug browser and log into LeanIX
+
+**Windows (PowerShell, Edge):**
+
+```powershell
+Start-Process "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" `
+  "--remote-debugging-port=9222 --user-data-dir=C:\Temp\edge-debug --no-first-run --no-default-browser-check"
+```
+
+**macOS (Chrome):**
+
+```bash
+open -na "Google Chrome" --args --remote-debugging-port=9222 --user-data-dir="$HOME/chrome-debug"
+```
+
+Log into your LeanIX workspace in that browser window.
+
+### 2. Run the proxy (separate terminal, keep it running)
+
+```bash
+eahelper proxy
+```
+
+### 3. Download and load
+
+```bash
+eahelper download --relations
+eahelper load              # prompts for DB backend; KuzuDB is the default
+eahelper load --db neo4j   # or choose explicitly
+```
+
+KuzuDB is embedded — no server needed; the database is a local directory
+(`--db-path`, default `./eahelper-kuzu-db`). For Neo4j, start your server and put
+`NEO4J_URI`, `NEO4J_USERNAME`, `NEO4J_PASSWORD` in a `.env` file.
+
+## Commands
+
+| Command | Purpose |
+|---|---|
+| `eahelper proxy` | Local GraphQL proxy + GraphiQL UI |
+| `eahelper diagnose` | Check browser/CDP/SSL connectivity |
+| `eahelper download` | Download factsheets & relationships to JSON |
+| `eahelper load` | Load downloaded JSON into KuzuDB or Neo4j |
+| `eahelper seed` | Seed example/reference data |
+
+Backend selection precedence: `--db` flag → `EAHELPER_DB` env var → interactive
+prompt (default **kuzu**).
+
+## Agent skill
+
+An installable Agent Skill (Claude Code, GitHub Copilot, and other
+[agentskills.io](https://agentskills.io)-compatible tools) that walks you through
+setup and usage lives at
+[dvm-eahelper-skills](https://github.com/divyavanmahajan/dvm-eahelper-skills).
+
+## Migrating from dvm-leanix / dvm-eagraph
+
+| Old | New |
+|---|---|
+| `dvm-leanix serve` / `lean-ix serve` | `eahelper proxy` |
+| `dvm-leanix download` | `eahelper download` |
+| `dvm-leanix diagnose` | `eahelper diagnose` |
+| `dvm-eagraph` | `eahelper load` |
+| `dvm-eagraph-seed` | `eahelper seed` |
+
+Token store moved from `~/.lean-ix/` to `~/.eahelper/`.
+
+## License
+
+MIT

dvm_eahelper-0.1.0/README.md

@@ -0,0 +1,93 @@
+# dvm-eahelper — LeanIX Enterprise Architecture Helper
+
+Successor to [`dvm-leanix`](https://github.com/divyavanmahajan/dvm-leanix) and
+[`dvm-eagraph`](https://github.com/divyavanmahajan/dvm-eagraph), combined into a single package.
+
+One CLI (`eahelper`) to:
+
+- Run a local **GraphQL proxy** to SAP LeanIX — extracts the Bearer token from your
+  already-logged-in browser via Playwright CDP, serves GraphiQL for exploration
+- **Download** factsheets and relationships as JSON
+- **Load** them into a graph database — **KuzuDB** (embedded, default) or **Neo4j**
+
+Works on **Windows** and **macOS**.
+
+## Installation
+
+```bash
+uv tool install dvm-eahelper        # or: pip install dvm-eahelper
+uvx playwright install chromium     # one-time, for the proxy
+```
+
+## Quick start
+
+### 1. Launch a debug browser and log into LeanIX
+
+**Windows (PowerShell, Edge):**
+
+```powershell
+Start-Process "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" `
+  "--remote-debugging-port=9222 --user-data-dir=C:\Temp\edge-debug --no-first-run --no-default-browser-check"
+```
+
+**macOS (Chrome):**
+
+```bash
+open -na "Google Chrome" --args --remote-debugging-port=9222 --user-data-dir="$HOME/chrome-debug"
+```
+
+Log into your LeanIX workspace in that browser window.
+
+### 2. Run the proxy (separate terminal, keep it running)
+
+```bash
+eahelper proxy
+```
+
+### 3. Download and load
+
+```bash
+eahelper download --relations
+eahelper load              # prompts for DB backend; KuzuDB is the default
+eahelper load --db neo4j   # or choose explicitly
+```
+
+KuzuDB is embedded — no server needed; the database is a local directory
+(`--db-path`, default `./eahelper-kuzu-db`). For Neo4j, start your server and put
+`NEO4J_URI`, `NEO4J_USERNAME`, `NEO4J_PASSWORD` in a `.env` file.
+
+## Commands
+
+| Command | Purpose |
+|---|---|
+| `eahelper proxy` | Local GraphQL proxy + GraphiQL UI |
+| `eahelper diagnose` | Check browser/CDP/SSL connectivity |
+| `eahelper download` | Download factsheets & relationships to JSON |
+| `eahelper load` | Load downloaded JSON into KuzuDB or Neo4j |
+| `eahelper seed` | Seed example/reference data |
+
+Backend selection precedence: `--db` flag → `EAHELPER_DB` env var → interactive
+prompt (default **kuzu**).
+
+## Agent skill
+
+An installable Agent Skill (Claude Code, GitHub Copilot, and other
+[agentskills.io](https://agentskills.io)-compatible tools) that walks you through
+setup and usage lives at
+[dvm-eahelper-skills](https://github.com/divyavanmahajan/dvm-eahelper-skills).
+
+## Migrating from dvm-leanix / dvm-eagraph
+
+| Old | New |
+|---|---|
+| `dvm-leanix serve` / `lean-ix serve` | `eahelper proxy` |
+| `dvm-leanix download` | `eahelper download` |
+| `dvm-leanix diagnose` | `eahelper diagnose` |
+| `dvm-eagraph` | `eahelper load` |
+| `dvm-eagraph-seed` | `eahelper seed` |
+
+Token store moved from `~/.lean-ix/` to `~/.eahelper/`.
+
+## License
+
+MIT

dvm_eahelper-0.1.0/pyproject.toml

@@ -0,0 +1,69 @@
+[project]
+name = "dvm-eahelper"
+dynamic = ["version"]
+description = "LeanIX enterprise-architecture helper: GraphQL proxy, factsheet download, and graph loading into KuzuDB or Neo4j"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+    { name = "Divya Van Mahajan", email = "divyavanmahajan@users.noreply.github.com" },
+]
+keywords = ["leanix", "graphql", "kuzu", "neo4j", "enterprise-architecture"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "fastapi>=0.115",
+    "uvicorn[standard]>=0.32",
+    "httpx>=0.27",
+    "playwright>=1.49",
+    "kuzu>=0.7",
+    "neo4j>=5.0",
+    "python-dotenv>=1.0",
+    "pyyaml>=6.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/divyavanmahajan/dvm-eahelper"
+Source = "https://github.com/divyavanmahajan/dvm-eahelper"
+"Bug Tracker" = "https://github.com/divyavanmahajan/dvm-eahelper/issues"
+
+[project.scripts]
+eahelper = "dvm_eahelper.cli:main"
+dvm-eahelper = "dvm_eahelper.cli:main"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/dvm_eahelper/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dvm_eahelper"]
+
+[dependency-groups]
+dev = ["ruff>=0.9"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W", "UP"]
+ignore = ["E501"]

dvm_eahelper-0.1.0/src/dvm_eahelper/__init__.py

@@ -0,0 +1,4 @@
+try:
+    from ._version import __version__
+except ImportError:
+    __version__ = "0.0.0"

dvm_eahelper-0.1.0/src/dvm_eahelper/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

dvm_eahelper-0.1.0/src/dvm_eahelper/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.1.0'
+__version_tuple__ = version_tuple = (0, 1, 0)
+
+__commit_id__ = commit_id = None