devin-graph 0.1.0__py3-none-any.whl

devin_graph-0.1.0.dist-info/METADATA

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: devin-graph
+Version: 0.1.0
+Summary: Knowledge graph over Devin sessions — projects, files, tools and decisions as queryable nodes.
+Author: Icaro0310
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: devin-internals-spec<0.4.0,>=0.3.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="assets/banner.svg" alt="devin-graph" width="100%"/>
+
+<a href="https://github.com/Icaro0310/devin-graph/actions/workflows/ci.yml"><img src="https://github.com/Icaro0310/devin-graph/actions/workflows/ci.yml/badge.svg" alt="ci"/></a>
+
+
+<a href="https://scorecard.dev/viewer/?uri=github.com/Icaro0310/devin-graph"><img src="https://api.scorecard.dev/projects/github.com/Icaro0310/devin-graph/badge" alt="OpenSSF Scorecard"/></a>
+<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"/></a>
+<a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+"/></a>
+<a href="https://github.com/Icaro0310/devin-graph"><img src="https://img.shields.io/github/stars/Icaro0310/devin-graph" alt="GitHub stars"/></a>
+<a href="https://github.com/Icaro0310/devin-graph/commits/main"><img src="https://img.shields.io/github/last-commit/Icaro0310/devin-graph" alt="Last commit"/></a>
+<a href="https://github.com/Icaro0310/awesome-devin"><img src="https://img.shields.io/badge/part%20of-devin--*-ecosystem-7c3aed" alt="devin-* ecosystem"/></a>
+<a href="https://github.com/Icaro0310/devin-graph/issues"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen" alt="PRs welcome"/></a>
+</div>
+
+<!-- DEVIN-ECO:BEGIN -->
+> **Part of the [DEVIN ecosystem](https://github.com/Icaro0310/awesome-devin)**  
+> Track: Understand · Nature: product  
+> For: Developers, AI engineers  
+> Interface: CLI / Python library
+<!-- DEVIN-ECO:END -->
+
+
+# devin-graph
+
+> **Unofficial community project.** Not affiliated with, endorsed by, or
+> sponsored by Cognition AI. "Devin" is a trademark of Cognition AI.
+
+**[Linux](README.linux.md)** · **[Personal Windows](README.windows.md)** · **[Corporate Windows](README.corporate-windows.md)**
+
+Part of the [awesome-devin](https://github.com/Icaro0310/awesome-devin) ecosystem: the curated hub for the devin-* tools.
+
+A knowledge graph over Devin sessions: sessions, projects, files and tools
+become nodes — queryable ("which sessions touched file X?", "which tools does
+project Y depend on?") and exportable for visualization.
+
+## The problem
+
+After dozens of Devin sessions you lose the thread: which sessions touched
+that config file, which tools a project relies on, which projects share the
+same files. The data exists in `sessions.db` (`tool_call_state` records every
+call the agent made) but there is no way to query across sessions — only
+per-session scrolling in the UI.
+
+## Prior art
+
+- Code-knowledge graphs (Sourcegraph, Glean-style indexes) map *code*, not
+  *agent activity*; they don't know what your AI sessions touched.
+- `devin-internals-spec` provides the schema + typed read-only parsers this
+  tool builds on; `devin-history` exports the same store to notes but has no
+  cross-session structure.
+- You could hand-write SQL — but the `tool_call_json` payload format is
+  undocumented and changes; here it's extracted defensively in one place.
+
+## What makes it Devin-native
+
+Edges come from **ground truth, not prose**: `file_touched` edges are
+extracted from `tool_call_state` payloads (file paths in fs/terminal tool
+calls) and anchored to the session's `working_directory`. That data simply
+doesn't exist outside Devin's store — remove Devin and there is no graph to
+build. Schema drift is gated by `devin-internals-spec`'s version detector.
+
+## Install
+
+Requires Python ≥ 3.10 and `pipx` or `uv`. Per-OS setup lives in the platform guides: [Linux](README.linux.md) · [Personal Windows](README.windows.md) · [Corporate Windows](README.corporate-windows.md).
+
+<!-- DIST-STATUS:BEGIN — generated from devin-powerups/registry.json -->
+> **Source-only distribution.** This tool is not yet published to PyPI.
+> Install from source:
+>
+> ```bash
+> pipx install git+https://github.com/Icaro0310/devin-graph.git
+> # or
+> uv tool install git+https://github.com/Icaro0310/devin-graph.git
+> ```
+<!-- DIST-STATUS:END -->
+
+## Usage
+
+```bash
+# build the graph (auto-detects the Devin sessions.db for your OS) — safe to
+# re-run: unchanged sessions are skipped
+devin-graph build --graph graph.db
+
+# canned queries
+devin-graph query file "src/app.py"        --graph graph.db
+devin-graph query tool "execute"           --graph graph.db
+devin-graph query project "my-repo"        --graph graph.db
+devin-graph query shared-files             --graph graph.db
+devin-graph query projects-graph           --graph graph.db --json
+
+# D3-friendly dump: {"meta", "nodes", "edges"}
+devin-graph export --format json --graph graph.db --out graph.json
+```
+
+Matching is forgiving (`src/app.py` finds `/repo/alpha/src/app.py`);
+everything has `--json`. `query shared-files` lists every file touched
+by two or more distinct projects, with the project and session lists —
+exportable as JSON like the other queries. The source DB is opened
+`mode=ro` and never written — tests assert its hash is unchanged.
+
+## Works with Devin alone (Devin-only mode)
+
+devin-graph builds `graph.db` locally from Devin's session stores — the whole
+pipeline is offline. Note that the derived database contains the same
+sensitive content as the sessions themselves (prompts, paths, commands):
+keep it private like the originals.
+
+## Platform support
+
+Tested on **Windows and Linux** (`windows-latest` + `ubuntu-latest` in CI).
+The CLI session DB is auto-detected: `%APPDATA%/devin/cli/sessions.db` on
+Windows and `$XDG_DATA_HOME/devin/cli/sessions.db` on Linux (default
+`~/.local/share/devin/cli/sessions.db`). A legacy `~/.config/devin` location
+is also checked. Pass `--sessions-db` to override.
+
+
+`commit` nodes + `produced`/`referenced` edges attribute sessions to git SHAs seen in tool calls (exact when the SHA appears in a `git commit`/`git push` call, `seen` otherwise). `devin-graph sql "SELECT ..."` runs read-only SQL over graph.db (SELECT/WITH only, `query_only` pragma).
+
+
+`--vscdb` (auto-detected on build) adds GUI coverage: `gui_session` nodes keyed by the generated session slug, `gui_workspace` edges to their workspace project, enriched with `lastAccessed` when a `resourceToSpace` editor URI links a space to the slug. Best-effort: only the observed `windsurfSpace.*` keys are read; unknown/malformed keys are skipped. Pass `--vscdb none` to disable.
+
+
+`devin-graph view --out file.html` renders the graph as a self-contained HTML page (embedded JSON + vanilla-JS force layout — zero CDN, works fully offline). `--limit` caps nodes (highest-degree kept, flagged TRUNCATED in the header).
+
+## Limitations
+
+- **Schema-gated.** Only `sessions.db` schema v15–v17; newer fails loudly
+  (update `devin-internals-spec` first).
+- **Heuristic path extraction.** `tool_call_*_json` is an unstable, opaque
+  format: paths are collected from path-ish keys plus path-looking tokens in
+  command strings — best-effort, not contractual. A brand-new tool payload
+  shape may yield partial edges.
+- **CLI sessions only (M1).** GUI sessions (`acp-messages/*.db`) and
+  `state.vscdb` are planned for M2.
+- **Not a code index.** Nodes are files *the agent touched*, not repo
+  contents; no symbol/AST knowledge.
+- **Read-only by design** on Devin stores; `graph.db` is the only thing it
+  writes.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+python -m pytest
+```
+
+Fixtures are generated at test time by `devin_internals.fixtures` (real v17
+DDL, synthetic rows) — no binary fixtures are committed. See
+[docs/SPEC.md](docs/SPEC.md) for the graph model and
+[STATUS.md](STATUS.md) for the roadmap.
+
+## When to use this
+
+- You need cross-session questions: which sessions touched file X, which
+  tools project Y depends on, which projects share files.
+- You want edges from ground truth — real `tool_call_state` payloads, not
+  heuristics over chat text.
+- You want a graph export to visualize agent activity
+  (`devin-graph export --format json` produces a D3-ready dump).
+- You want incremental builds — re-running `devin-graph build` skips
+  unchanged sessions.
+
+## When NOT to use this
+
+- You need a code index — nodes are files the agent *touched*, not repo
+  contents; there is no symbol/AST knowledge.
+- You need message-content search (use `devin-search`) or activity/context metrics
+  (use `devin-metrics`).
+- You need GUI session data — M1 covers CLI `sessions.db` only;
+  `acp-messages` is planned for M2.
+
+## FAQ
+
+**What is devin-graph?** A local tool that turns Devin's session database
+into a knowledge graph: sessions, projects, files, and tools become nodes,
+with edges extracted from real tool-call payloads. You query it with
+`devin-graph query file|tool|project|shared-files` and export it as JSON
+for visualization.
+
+**How is devin-graph different from devin-search?** devin-search finds text:
+ranked full-text hits inside session content. devin-graph finds structure:
+which sessions touched which files, which tools which projects use, and
+which projects share files — relationships, not text matches.
+
+**Does it write to Devin's databases?** No. The source `sessions.db` is
+opened `mode=ro` and never written — the test suite asserts its hash is
+unchanged. The only file devin-graph creates is its own `graph.db`.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

devin_graph-0.1.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+devin_graph/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+devin_graph/cli.py,sha256=E55uOLsuI9qIouEiAxB1KmnW8Bo0xfeRAJAJ9idJfEc,10424
+devin_graph/extract.py,sha256=bXoahp49H2YRoxIj79AB8P6IRlLl1NWcSUByPcYZD84,10780
+devin_graph/identity.py,sha256=n-FuPXeTCeF371UcWdq8rCgcdINQtOCNvkOuNnxwXwo,4334
+devin_graph/paths.py,sha256=SJJQ8qij-ES5IidRw7c29EZo9d1r5x2xDm7ZV0WwOxw,3009
+devin_graph/query.py,sha256=Ed4pJkplqH0hDrF3eY4VWcFJbuk-leMJ2FtPBAy0Kcw,8176
+devin_graph/store.py,sha256=BkI4uvDRLH6yWwmYitr7tGejG2iB4nLZJbmtoBuTJek,9537
+devin_graph/view.py,sha256=pFtGOPDq8PVaW8Q-7qJVLZx0gTqVPzif9aYOlRnP75s,6358
+devin_graph/vscdb.py,sha256=MtpbN9fH3_WW1IovIU6rD_2lPiNGg7CTeC9qoyscZPU,4334
+devin_graph-0.1.0.dist-info/licenses/LICENSE,sha256=dxS8nFGmsVpbMH3Qz4fmf0j6irSSpO4k5H5F6ZealWg,1066
+devin_graph-0.1.0.dist-info/METADATA,sha256=f7mCVdb4jITaT2mS-ZwPgvpecJiPc7LBSMFZFonBg5M,9633
+devin_graph-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+devin_graph-0.1.0.dist-info/entry_points.txt,sha256=5rigqqYfZIXekrjSKnOSxF4cVj7AQZ2FTU3tyTpZfuk,53
+devin_graph-0.1.0.dist-info/top_level.txt,sha256=cAHIhfbOcj8L4IvMrB1eOPckDXc3OJB2WtA0OLkZcjw,12
+devin_graph-0.1.0.dist-info/RECORD,,

devin_graph-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

devin_graph-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+devin-graph = devin_graph.cli:main

devin_graph-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Icaro0310
+
+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.

devin_graph-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+devin_graph