dimagx 0.2.0__tar.gz

dimagx-0.2.0/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-05-16
+
+### Added
+- **Symbol-Level Indexing**: Integrated **Tree-sitter** for deep code parsing. Extracted functions, classes, and methods are now indexed as nodes in the project brain.
+- **Semantic Search**: Implemented local vector embeddings using `sentence-transformers`. The `query_memory` tool now supports natural language semantic search over the entire memory graph.
+- **Framework-Specific Entities**: Auto-detection and indexing of architectural patterns:
+  - **Flutter**: Cubits, Blocs, Providers, and Pages.
+  - **React**: Components and Hooks.
+  - **FastAPI**: API Routes and endpoints.
+- **Bug Tracking Layer**: Added dedicated `dimagx bug` commands (`report`, `fix`, `list`) to track project issues and link them to files and commits.
+- **Agentic Memory Automation**: MCP server now automatically detects if a prompt relates to a Bug Fix or Feature implementation and logs it accordingly.
+- **Hierarchical Graph View**: New `dimagx graph` command provides a structural ASCII visualization of PRDs, Features, Files, and Architecture.
+- **Git Branch Integration**: Automatic feature name detection from git branch names when starting a new feature.
+- **Interactive CLI Splash**: A modern, futuristic terminal entry screen powered by `rich` and `pyfiglet`.
+- **Background File Watcher**: Support for background daemonization with `dimagx watch --background`.
+
+### Changed
+- Improved `get_context` MCP tool to provide a more concise and structured overview of project status, active features, and recent agentic history.
+- Enhanced `dimagx init` to perform deep symbol and entity scanning during the initial project setup.
+
+---
+
+## [0.1.0] - 2026-05-15
+
+### Added
+- Initial project release.
+- Core graph memory system using **Kuzu DB**.
+- Basic CLI for project initialization (`init`) and status tracking (`status`).
+- Feature management (`dimagx feature start/done/list`).
+- PRD ingestion and AI-powered summarization using Anthropic Claude.
+- File indexing and stack detection.
+- Git history scanning and automated post-commit hook.
+- MCP (Model Context Protocol) server for coding agent integration.
+- Real-time file system watcher.
+
+[0.2.0]: https://github.com/shmehdi01/dimagx/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/shmehdi01/dimagx/releases/tag/v0.1.0

dimagx-0.2.0/LICENSE

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

dimagx-0.2.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include requirements.txt
+recursive-include dimagx/static *

dimagx-0.2.0/PKG-INFO

@@ -0,0 +1,401 @@
+Metadata-Version: 2.4
+Name: dimagx
+Version: 0.2.0
+Summary: Project brain for coding agents — memory graph for code, prompts, features and PRDs
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: kuzu>=0.7.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: anthropic>=0.25.0
+Requires-Dist: pypdf2>=3.0.0
+Requires-Dist: python-docx>=1.0.0
+Requires-Dist: watchdog>=4.0.0
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: uvicorn>=0.27.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: tree-sitter>=0.20.0
+Requires-Dist: tree-sitter-languages>=1.7.0
+Requires-Dist: sentence-transformers>=2.2.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: pyfiglet>=1.0.2
+Requires-Dist: colorama>=0.4.6
+Dynamic: license-file
+
+# DimagX 🧠
+
+> **Project brain for coding agents.**  
+> One command. Persistent memory. Switch models freely — your agent always knows where you left off.
+>
+> [View Changelog](./CHANGELOG.md) | [Documentation](./docs/architecture.md)
+
+---
+
+## The Problem
+
+Every time you start a new coding session, your agent reads your entire codebase from scratch. Switch from Claude to Cursor to GPT-4 — you re-explain everything. Your PRDs, decisions, and context live nowhere.
+
+## The Solution
+
+DimagX builds a **persistent memory graph** for your project — code, features, prompts, PRDs, git history, and architectural decisions — and exposes it to any coding agent via MCP.
+
+```
+Without DimagX                    With DimagX
+─────────────────────             ─────────────────────
+New session → agent reads         New session → agent calls
+50 files, asks you to             get_context() → instantly
+re-explain everything             oriented, no re-explaining
+```
+
+---
+
+## How It Works
+
+```
+your-project/
+└── .dimagx/              ← created by dimagx init
+    ├── config.yaml       ← project identity
+    ├── graph.db          ← Kuzu embedded graph (gitignored)
+    └── prd/              ← drop PRDs here
+```
+
+DimagX indexes your codebase into a graph with 8 node types:
+
+```
+Project → File → Symbol → Feature → Prompt → PRD → Decision → Commit
+```
+
+Your coding agent queries this graph via MCP instead of re-reading everything.
+
+---
+
+## v0.2.0: Semantic Memory & Code Symbols 🚀
+
+DimagX now goes deeper than just file names. It understands **what's inside** your code and can search your memory **semantically**.
+
+### 1. Symbol-Level Indexing
+Using **Tree-sitter**, DimagX extracts classes and functions from your code.
+- Filter by `Symbol` nodes in your memory.
+- Instant access to function definitions and class structures.
+- Supported languages: Python, JavaScript, TypeScript, Go, Rust, Java, and more.
+
+### 2. Semantic Search (Embeddings)
+The `query_memory(question)` tool now uses **Vector Embeddings** (`sentence-transformers`).
+- Doesn't rely on keyword matching.
+- Asks "How do I handle auth?" and finds the relevant PRD, File, and Feature even if they don't contain the word "auth".
+- Local execution — no tokens sent to external embedding providers.
+
+---
+
+## Install
+
+### Requirements
+- Python 3.10+
+- pip
+
+### From source
+
+```bash
+git clone https://github.com/yourname/dimagx
+cd dimagx
+pip install -e .
+```
+
+### Verify
+
+```bash
+dimagx --help
+```
+
+---
+
+## Quick Start
+
+```bash
+# Go to any project — new or existing
+cd my-project
+
+# Initialize DimagX (scans files, git history, builds graph)
+dimagx init
+
+# See what's in memory
+dimagx status
+
+# See where you left off
+dimagx context
+```
+
+---
+
+## All Commands
+
+### Project
+```bash
+dimagx init              # Scan project, build memory graph
+dimagx status            # Memory dashboard — node counts per layer
+dimagx context           # Human summary: features, commits, prompts, PRDs
+```
+
+### Features
+```bash
+dimagx feature start "Pricing Engine"   # Tag what you're working on
+dimagx feature done  "Pricing Engine"   # Mark it complete
+dimagx feature list                      # Show all features + status
+```
+
+### PRDs
+```bash
+# Single file (MD, PDF, DOCX, TXT supported)
+dimagx prd ingest ./docs/pricing.md
+
+# Bulk — ingest entire folder
+dimagx prd ingest --dir ./docs/prd/
+
+# List and inspect
+dimagx prd list
+dimagx prd show "Pricing Engine"
+```
+
+> PRD ingestion requires an Anthropic API key for AI summarization.  
+> Set `ANTHROPIC_API_KEY` in your environment.
+
+### Decisions (Architectural Decision Records)
+```bash
+dimagx decision add      # Interactive — prompts for title, context, choice, reason
+dimagx decision list     # Show all decisions
+```
+
+### File Watcher
+```bash
+dimagx watch                    # Foreground — auto re-index on file save
+dimagx watch --background       # Background daemon
+dimagx watch --stop             # Stop background watcher
+```
+
+### Git Hook
+```bash
+# Auto-installed on dimagx init if .git exists
+# Manual control:
+dimagx hook install             # Install post-commit hook
+dimagx hook uninstall           # Remove hook
+```
+
+### MCP Server
+```bash
+dimagx mcp                      # Start MCP server + show agent config
+```
+
+---
+
+## Connect to Your Coding Agent
+
+Add to your agent config and it automatically calls `get_context()` at the start of every session.
+
+**Claude Code** — `.claude/mcp.json`
+```json
+{
+  "mcpServers": {
+    "dimagx": {
+      "command": "dimagx-mcp"
+    }
+  }
+}
+```
+
+**Cursor / Windsurf** — `.cursor/mcp.json`
+```json
+{
+  "mcpServers": {
+    "dimagx": {
+      "command": "dimagx-mcp"
+    }
+  }
+}
+```
+
+### MCP Tools Available to Your Agent
+
+| Tool | When to call | What it returns |
+|---|---|---|
+| `get_context()` | Start of every session | Full project orientation |
+| `query_memory(question)` | Before asking the user anything | Relevant memory nodes |
+| `log_prompt(text, summary, outcome)` | After completing a task | Stores in graph |
+| `add_decision(title, context, choice, reason)` | After an architectural decision | Stored as ADR |
+| `get_features(status?)` | When planning work | Feature list |
+| `get_files(feature?, language?)` | When navigating codebase | Filtered file list |
+
+---
+
+## PRD Ingestion
+
+DimagX reads your PRD, summarizes it with AI, extracts features, and links everything in the graph.
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# Single file
+dimagx prd ingest ./docs/auth_prd.md
+
+# Bulk folder
+dimagx prd ingest --dir ./docs/prd/
+```
+
+Supported formats: `.md` `.pdf` `.docx` `.txt`
+
+Multi-PRD projects are fully supported — each PRD is a separate node linked to its features:
+
+```
+prd_auth      → covers → [OTP Login, Session Mgmt, RBAC]
+prd_pricing   → covers → [GST Calc, Discount Engine, Charges]
+prd_store     → covers → [QR Menu, Cart, Online Payment]
+```
+
+---
+
+## Daily Workflow
+
+```bash
+cd my-project
+
+# Morning — see where you left off
+dimagx context
+
+# Start a feature
+dimagx feature start "Online Store"
+
+# Start background watcher
+dimagx watch --background
+
+# Work normally — files auto-indexed, commits auto-logged
+
+# Log a decision
+dimagx decision add
+
+# End of day — check memory
+dimagx status
+```
+
+---
+
+## What Gets Stored Automatically
+
+| Layer | Source | How |
+|---|---|---|
+| Files | Codebase | Auto on `init` + `watch` |
+| Git commits | Git history | Auto on `init` + post-commit hook |
+| Features | You | `dimagx feature start` |
+| PRDs | You drop files | `dimagx prd ingest` or auto via `watch` |
+| Prompts | Agent sessions | MCP `log_prompt()` |
+| Decisions | You / agent | `dimagx decision add` / MCP |
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────────┐
+│              Your Codebase              │
+└──────────────┬──────────────────────────┘
+               │ dimagx init / watch
+               ▼
+┌─────────────────────────────────────────┐
+│           DimagX Memory Graph           │
+│  (Kuzu embedded graph DB — .dimagx/)    │
+│                                         │
+│  Project ── File ── Feature             │
+│     │          │       │                │
+│  Commit     Symbol    PRD               │
+│                │       │                │
+│            Prompt ── Decision           │
+└──────────────┬──────────────────────────┘
+               │ MCP (stdio)
+               ▼
+┌─────────────────────────────────────────┐
+│         Any Coding Agent                │
+│  Claude Code / Cursor / Windsurf / etc  │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## Stack
+
+| Component | Library |
+|---|---|
+| Graph DB | [Kuzu](https://kuzudb.com/) — embedded, no server needed |
+| CLI | [Typer](https://typer.tiangolo.com/) + [Rich](https://rich.readthedocs.io/) |
+| Agent protocol | [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) |
+| File watcher | [Watchdog](https://python-watchdog.readthedocs.io/) |
+| PRD summarization | [Anthropic SDK](https://github.com/anthropics/anthropic-sdk-python) |
+| Code parsing | [Tree-sitter](https://tree-sitter.github.io/tree-sitter/) |
+| Embeddings | [Sentence-Transformers](https://sbert.net/) |
+
+---
+
+## Project Structure
+
+```
+dimagx/
+├── dimagx/
+│   ├── __init__.py        # Package entry
+│   ├── cli.py             # All CLI commands
+│   ├── mcp_server.py      # MCP server + tools
+│   ├── graph.py           # Kuzu schema (7 nodes, 10 relationships)
+│   ├── db.py              # DB upsert helpers
+│   ├── scanner.py         # Stack detection, file scan, git history
+│   ├── config.py          # .dimagx/config.yaml read/write
+│   ├── prd.py             # PRD extraction + AI summarization
+│   ├── watcher.py         # File system watcher
+│   ├── watcher_daemon.py  # Background daemon entry point
+│   ├── githook.py         # Git hook installer + commit logger
+│   ├── commit_log.py      # Called by post-commit hook
+│   ├── symbols.py         # Tree-sitter symbol extraction
+│   └── embeddings.py      # Local vector embedding generation
+├── pyproject.toml
+├── setup.py
+└── README.md
+```
+
+---
+
+## Roadmap
+
+- [x] Semantic search (embeddings) in `query_memory`
+- [x] Tree-sitter code parsing — function/class level indexing
+- [x] Framework-specific entity extraction (Flutter, React, FastAPI)
+- [x] Bug tracking commands & auto-detection
+- [x] Hierarchical Graph View (`dimagx graph`)
+- [x] `dimagx feature update` — add description post-creation
+- [x] Web UI — browser-based memory explorer
+- [ ] PyPI publish — `pip install dimagx`
+- [ ] VS Code extension
+
+---
+
+## Contributing
+
+PRs welcome. Please open an issue first for major changes.
+
+```bash
+git clone https://github.com/yourname/dimagx
+cd dimagx
+pip install -e .
+```
+
+---
+
+## License
+
+MIT — use it, fork it, build on it.
+
+---
+
+## Built by
+
+[@syedhussainmehdi](https://github.com/shmehdi01) - SYED HUSSAIN MEHDI.
+
+> *"Dimaag" (دماغ) means brain in Urdu/Hindi. DimagX is the brain your coding agent never had.*