context-graph-viewer 0.1.0__tar.gz

context_graph_viewer-0.1.0/.gitignore

@@ -0,0 +1,189 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+
+# VS Code
+.vscode/
+
+
+# Local agent hook configuration
+/.codex/
+/.claude/settings.local.json
+
+# Project specific files
+/enterprise-context/sic-agent/sic-scrapper/output/*
+
+# deepeval writes run caches and telemetry here; build artifacts, not source.
+.deepeval/

context_graph_viewer-0.1.0/LICENSE

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

context_graph_viewer-0.1.0/PKG-INFO

@@ -0,0 +1,87 @@
+Metadata-Version: 2.5
+Name: context-graph-viewer
+Version: 0.1.0
+Summary: Read-only terminal viewer for a Context Graph: capture health, pipeline state, session anatomy and the knowledge graph
+License: MIT
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: memgraph-context-graph>=0.6.0
+Requires-Dist: memgraph-toolbox
+Requires-Dist: textual<9,>=8.2
+Provides-Extra: test
+Requires-Dist: actions-graph[memgraph-context-graph]>=0.5.0; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.26.0; extra == 'test'
+Requires-Dist: pytest>=9.0.3; extra == 'test'
+Requires-Dist: resources-graph[memgraph-context-graph]; extra == 'test'
+Requires-Dist: sessions-graph[memgraph-context-graph]>=0.8.1; extra == 'test'
+Description-Content-Type: text/markdown
+
+# context-graph-viewer
+
+A read-only terminal viewer for your Context Graph. It shows what your Claude Code / Codex hooks captured, whether
+capture is failing, where reconciliation stands, and what the graph learned, without Cypher or Memgraph Lab.
+
+```bash
+memgraph-context-graph ui
+```
+
+It reads the same config file as the hooks (`CONTEXT_GRAPH_CONFIG`, else `~/.config/context-graph/config.toml`),
+polls Memgraph every few seconds, and never writes to the graph.
+
+## Install
+
+`memgraph-context-graph setup` installs it unless you pass `--no-viewer`. It runs in the same tool environment as
+`memgraph-context-graph`, so to add it by hand, add it to that tool's `uv tool install`:
+
+```bash
+uv tool install "memgraph-context-graph[mcp]" \
+  --with "skills-graph[memgraph-context-graph]" \
+  --with "actions-graph[memgraph-context-graph]" \
+  --with "sessions-graph[memgraph-context-graph]" \
+  --with context-graph-viewer
+```
+
+`context-graph-viewer` also installs its own command, which takes the same flags as `memgraph-context-graph ui`.
+
+## Views
+
+| View | Reached by | Shows |
+|---|---|---|
+| **Dashboard** | start | Sessions in scope, the pipeline (reconcile and embedding queues, extraction backend, ontology version, failures, capture tokens), capture health (the local capture-failure log plus hints from the graph), and new entities per day. |
+| **Session** | `enter` on a session | The timeline with subagents folded under the call that spawned them, each action's input and the resources it touched, and what the session produced (chunks, entities, memory files). |
+| **Entities** | `k` on the dashboard, `g` on a session | Entities merged by name, by support (how many sessions and memory files ground them) or most recent, with their provenance. |
+| **Neighbourhood** | `enter` on an entity | One entity's relations grouped by type, with the evidence behind each. `enter` on a neighbour moves there; `esc` walks back. |
+
+## Keys
+
+| Key | Does |
+|---|---|
+| `a` | Widen the scope: your sessions → plus unattributed ones → everyone's |
+| `p` | Narrow every view to one project (working directory) |
+| `/` | Filter the table |
+| `1`–`4` | Jump to a pane; `f` makes it fill the screen |
+| `v` | Neighbourhood: relation tree or flat table |
+| `+` / `-` | Neighbourhood: raise or lower the confidence floor |
+| `h` / `s` | Entities: show value types (dates, amounts) / sort by most recent |
+| `w` | Enterprise: next space this login can read |
+| `r` | Refresh now |
+| `?` | All keys |
+| `esc` / `q` | Back / quit |
+
+## Scope
+
+By default you see your own sessions: `identity.user_id` in Community, your Memgraph login in Enterprise. Sessions
+captured before a user was configured belong to nobody (reconcile files them under an `anon-…` user), so if the
+dashboard opens empty, press `a`.
+
+## Development
+
+Tests run against a real Memgraph and drive the app headless:
+
+```bash
+./scripts/dev-memgraph.sh test context-graph-viewer
+```

context_graph_viewer-0.1.0/README.md

@@ -0,0 +1,65 @@
+# context-graph-viewer
+
+A read-only terminal viewer for your Context Graph. It shows what your Claude Code / Codex hooks captured, whether
+capture is failing, where reconciliation stands, and what the graph learned, without Cypher or Memgraph Lab.
+
+```bash
+memgraph-context-graph ui
+```
+
+It reads the same config file as the hooks (`CONTEXT_GRAPH_CONFIG`, else `~/.config/context-graph/config.toml`),
+polls Memgraph every few seconds, and never writes to the graph.
+
+## Install
+
+`memgraph-context-graph setup` installs it unless you pass `--no-viewer`. It runs in the same tool environment as
+`memgraph-context-graph`, so to add it by hand, add it to that tool's `uv tool install`:
+
+```bash
+uv tool install "memgraph-context-graph[mcp]" \
+  --with "skills-graph[memgraph-context-graph]" \
+  --with "actions-graph[memgraph-context-graph]" \
+  --with "sessions-graph[memgraph-context-graph]" \
+  --with context-graph-viewer
+```
+
+`context-graph-viewer` also installs its own command, which takes the same flags as `memgraph-context-graph ui`.
+
+## Views
+
+| View | Reached by | Shows |
+|---|---|---|
+| **Dashboard** | start | Sessions in scope, the pipeline (reconcile and embedding queues, extraction backend, ontology version, failures, capture tokens), capture health (the local capture-failure log plus hints from the graph), and new entities per day. |
+| **Session** | `enter` on a session | The timeline with subagents folded under the call that spawned them, each action's input and the resources it touched, and what the session produced (chunks, entities, memory files). |
+| **Entities** | `k` on the dashboard, `g` on a session | Entities merged by name, by support (how many sessions and memory files ground them) or most recent, with their provenance. |
+| **Neighbourhood** | `enter` on an entity | One entity's relations grouped by type, with the evidence behind each. `enter` on a neighbour moves there; `esc` walks back. |
+
+## Keys
+
+| Key | Does |
+|---|---|
+| `a` | Widen the scope: your sessions → plus unattributed ones → everyone's |
+| `p` | Narrow every view to one project (working directory) |
+| `/` | Filter the table |
+| `1`–`4` | Jump to a pane; `f` makes it fill the screen |
+| `v` | Neighbourhood: relation tree or flat table |
+| `+` / `-` | Neighbourhood: raise or lower the confidence floor |
+| `h` / `s` | Entities: show value types (dates, amounts) / sort by most recent |
+| `w` | Enterprise: next space this login can read |
+| `r` | Refresh now |
+| `?` | All keys |
+| `esc` / `q` | Back / quit |
+
+## Scope
+
+By default you see your own sessions: `identity.user_id` in Community, your Memgraph login in Enterprise. Sessions
+captured before a user was configured belong to nobody (reconcile files them under an `anon-…` user), so if the
+dashboard opens empty, press `a`.
+
+## Development
+
+Tests run against a real Memgraph and drive the app headless:
+
+```bash
+./scripts/dev-memgraph.sh test context-graph-viewer
+```

context_graph_viewer-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[project]
+name = "context-graph-viewer"
+version = "0.1.0"
+description = "Read-only terminal viewer for a Context Graph: capture health, pipeline state, session anatomy and the knowledge graph"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+classifiers = [
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    # Config, identity and spaces come from the hub, so the viewer reads exactly what the hooks write to.
+    "memgraph-context-graph>=0.6.0",
+    "memgraph-toolbox",
+    # Pinned to one major: Textual's maintenance has slowed and majors break widget APIs (#382).
+    "textual>=8.2,<9",
+]
+
+[project.optional-dependencies]
+test = [
+    "pytest>=9.0.3",
+    "pytest-asyncio>=0.26.0",
+    # The tests write sessions through the real hooks pipeline rather than hand-written Cypher.
+    "actions-graph[memgraph-context-graph]>=0.5.0",
+    "sessions-graph[memgraph-context-graph]>=0.8.1",
+    "resources-graph[memgraph-context-graph]",
+]
+
+[project.scripts]
+context-graph-viewer = "context_graph_viewer.cli:main"
+
+[tool.uv.sources]
+memgraph-context-graph = { workspace = true }
+memgraph-toolbox = { workspace = true }
+actions-graph = { workspace = true }
+sessions-graph = { workspace = true }
+resources-graph = { workspace = true }
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

context_graph_viewer-0.1.0/src/context_graph_viewer/__init__.py

@@ -0,0 +1,9 @@
+"""Read-only terminal viewer for a Context Graph (map #374).
+
+Run it with ``memgraph-context-graph ui``. It reads the hooks' config file, polls Memgraph, and never writes.
+"""
+
+from .app import ViewerApp
+from .cli import main
+
+__all__ = ["ViewerApp", "main"]

context_graph_viewer-0.1.0/src/context_graph_viewer/app.py

@@ -0,0 +1,146 @@
+"""The viewer app: one reader per space, a scope shared by every view, and a polling tick."""
+
+from __future__ import annotations
+
+from dataclasses import replace
+from datetime import datetime, timezone
+from typing import TYPE_CHECKING, ClassVar
+
+from textual.app import App
+from textual.binding import Binding
+
+from . import fmt, queries
+from .base import PolledScreen
+from .dashboard import DashboardScreen
+from .source import Identity, Reader, describe
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+POLL_SECONDS = 3.0
+
+CSS = """
+#left { width: 2fr; }
+#sessions, #entities, #nb { height: 1fr; }
+#side { width: 1fr; }
+#banner { padding: 0 1; border: round $warning; height: auto; }
+#filter { height: 3; }
+.pane { border: round $primary-darken-2; padding: 0 1; height: 1fr; }
+.pane:focus-within, .pane:focus { border: round $accent; }
+#growth-pane { height: auto; }
+#growth { height: 3; }
+#timeline { height: 3fr; border: round $primary-darken-2; }
+#timeline:focus { border: round $accent; }
+#produced-pane { height: 1fr; max-height: 12; }
+#main { width: 3fr; }
+#details-pane { width: 2fr; }
+#entities { width: 3fr; border: round $primary-darken-2; }
+#entities:focus, #sessions:focus { border: round $accent; }
+#sessions { border: round $primary-darken-2; }
+#prov-pane { width: 2fr; }
+#nbmain { width: 3fr; }
+#nb { border: round $primary-darken-2; }
+#nb:focus { border: round $accent; }
+#evidence-pane { width: 2fr; }
+#view-status { height: 1; padding: 0 1; background: $panel; }
+ProjectPicker { align: center middle; }
+#picker { width: 80%; max-width: 100; height: 70%; border: round $accent; background: $surface; padding: 0 1; }
+#picker .title { text-style: bold; padding: 0 0 1 0; }
+"""
+
+
+class ViewerApp(App[None]):
+    """Read-only Context Graph viewer. Opens on the dashboard and polls the active view."""
+
+    TITLE = "Context Graph"
+    CSS = CSS
+    BINDINGS: ClassVar = [
+        Binding("a", "widen_scope", "scope"),
+        Binding("w", "next_space", "space", show=False),
+        Binding("question_mark", "help", "keys"),
+        Binding("q", "quit", "quit"),
+    ]
+
+    def __init__(
+        self,
+        identity: Identity,
+        *,
+        poll_seconds: float = POLL_SECONDS,
+        clock: Callable[[], datetime] | None = None,
+        reader_factory: Callable[..., Reader] = Reader,
+    ) -> None:
+        """Args:
+        identity: Who is looking, and which spaces they may read (personal first).
+        poll_seconds: How often the active view reloads; 0 turns polling off (tests drive it by hand).
+        clock: The current time, for "3m ago" text; tests pin it.
+        reader_factory: Builds the reader for a space.
+        """
+        super().__init__()
+        self.identity = identity
+        self.scope = queries.Scope(user_id=identity.user_id)
+        self.poll_seconds = poll_seconds
+        self._clock = clock or (lambda: datetime.now(timezone.utc))
+        self._reader_factory = reader_factory
+        self.space_index = 0
+        self.reader = reader_factory(identity.spaces[0])
+
+    def now(self) -> datetime:
+        """The current time, from the injected clock."""
+        return self._clock()
+
+    def on_mount(self) -> None:
+        """Open the dashboard and start polling."""
+        self.push_screen(DashboardScreen())
+        if self.poll_seconds > 0:
+            self.set_interval(self.poll_seconds, self.poll_active)
+
+    def on_unmount(self) -> None:
+        """Close the connection."""
+        self.reader.close()
+
+    def poll_active(self) -> None:
+        """Reload the view on top; views underneath catch up when they're shown again."""
+        if isinstance(self.screen, PolledScreen):
+            self.screen.action_poll()
+
+    def context_line(self) -> str:
+        """Where, as whom, and what scope: shown under every view's title."""
+        space = self.identity.spaces[self.space_index]
+        user = self.identity.user_id or "no user configured"
+        parts = [f"{describe(space)}", f"{space.name} space", f"user {user}", f"scope {self.scope.mode}"]
+        if self.scope.project:
+            parts.append(f"project {fmt.project_name(self.scope.project)}")
+        return " · ".join(parts)
+
+    def _rescoped(self) -> None:
+        for screen in self.screen_stack:
+            if isinstance(screen, PolledScreen):
+                screen.refresh_titles()
+        self.poll_active()
+
+    def action_widen_scope(self) -> None:
+        """Cycle the scope: your sessions, plus unattributed ones, everyone's."""
+        self.scope = self.scope.widened()
+        self._rescoped()
+
+    def set_project(self, project: str | None) -> None:
+        """Narrow every view to one working directory, or None for all."""
+        self.scope = replace(self.scope, project=project)
+        self._rescoped()
+
+    def action_next_space(self) -> None:
+        """Enterprise: switch to the next space this login may read; Community has only one."""
+        if len(self.identity.spaces) < 2:
+            self.notify("Only one space: shared spaces need the Enterprise edition.", timeout=3)
+            return
+        self.reader.close()
+        self.space_index = (self.space_index + 1) % len(self.identity.spaces)
+        self.reader = self._reader_factory(self.identity.spaces[self.space_index])
+        self._rescoped()
+
+    def action_help(self) -> None:
+        """Toggle the key help panel."""
+        if self.screen.query("HelpPanel"):
+            self.action_hide_help_panel()
+        else:
+            self.action_show_help_panel()