memory-neo 0.1.0__tar.gz

memory_neo-0.1.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: memory-neo
+Version: 0.1.0
+Summary: Push your codebase to a graph DB and query it with natural language
+Author: memory-neo
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.7
+Requires-Dist: python-dotenv>=1.0
+
+# memory-neo/docs/README.md
+# Path: docs/README.md
+# Purpose: User-facing documentation — install, usage, deployment
+
+# 🧠 memory-neo
+
+Push your codebase to a graph database. Query it with natural language.
+
+```bash
+pip install memory-neo
+cd your-project/
+memory-neo push
+memory-neo query "show all auth functions"
+memory-neo context parse_directory
+```
+
+---
+
+## How it works
+
+1. **Push** — `memory-neo push` scans your project, extracts files and Python functions via AST, and sends the structure to a hosted Memgraph graph database.
+2. **Query** — `memory-neo query "..."` converts your question to Cypher via Claude, runs it against your graph, and prints results with code highlighting.
+3. **Context** — `memory-neo context <name>` fetches a function or file as prompt-ready code you can paste into any LLM.
+
+---
+
+## Install
+
+```bash
+pip install memory-neo
+```
+
+Python 3.9+ required.
+
+---
+
+## Authentication
+
+Get an API key at [memory-neo.dev](https://memory-neo.dev), then:
+
+```bash
+memory-neo login
+# Paste your API key when prompted
+# Saved to ~/.memoryneo/config.json
+```
+
+---
+
+## Commands
+
+### `memory-neo push`
+
+Scan the current directory and push its structure to Memgraph.
+
+```bash
+memory-neo push                        # use directory name as project name
+memory-neo push my-project             # explicit project name
+memory-neo push --dir ./src            # scan a subdirectory
+memory-neo push --dry-run              # scan only, don't push
+```
+
+What gets indexed:
+- Files: `.py` `.js` `.jsx` `.ts` `.tsx` `.html` `.md` `.txt`
+- Python: full AST extraction — function names, line numbers, args, docstrings, code
+- Other: file name, path, content, line count
+
+Ignored by default (via `memIgnore`):
+- `.venv/`, `node_modules/`, `__pycache__/`, `.git/`, `*.pyc`, `.env`, and more
+
+Custom ignore: place a `memIgnore` file in your project root (same syntax as `.gitignore`).
+
+---
+
+### `memory-neo query`
+
+Ask a natural language question about your indexed codebase.
+
+```bash
+memory-neo query "show all auth functions"
+memory-neo query "which files import httpx"
+memory-neo query "list all Python files"
+memory-neo query "how many functions are in each file"
+memory-neo query "show the parse_directory function"
+memory-neo query --project my-project "show all classes"
+memory-neo query --raw "..."           # print raw JSON
+memory-neo query --context "..."       # dump results as prompt-ready context block
+memory-neo query                       # interactive mode
+```
+
+---
+
+### `memory-neo context`
+
+Fetch the raw code of a function or file — ready to paste into a prompt.
+
+```bash
+memory-neo context parse_directory           # fetch function by name
+memory-neo context memory_neo/main.py        # fetch file by path
+memory-neo context login --type function     # force function lookup
+memory-neo context main.py --copy            # copy to clipboard
+```
+
+---
+
+## Ignore patterns (`memIgnore`)
+
+Place a `memIgnore` file in your project root to control what gets scanned.
+Uses the same syntax as `.gitignore`:
+
+```
+# Folders
+.venv/
+node_modules/
+dist/
+
+# Wildcards
+*.log
+*.tmp
+*.pyc
+
+# Files
+.env
+secrets.json
+```
+
+If no `memIgnore` is found in your project, the package default is used (covers most common cases).
+
+---
+
+## Self-hosting
+
+You can run the entire backend yourself.
+
+### Requirements
+- Fly.io account
+- Supabase (or any PostgreSQL) account
+- Anthropic API key
+
+### Deploy
+
+```bash
+# 1. Deploy Memgraph
+fly deploy --config deploy/fly.memgraph.toml
+
+# 2. Create persistent volume
+fly volumes create memgraph_data --size 20 --region cdg --app memory-neo-graph
+
+# 3. Init Memgraph schema
+fly ssh console --app memory-neo-graph
+# Inside pod:
+cat /init.cypher | mgconsole
+
+# 4. Set API secrets
+fly secrets set \
+  ANTHROPIC_API_KEY=sk-ant-... \
+  DATABASE_URL=postgresql://... \
+  API_SECRET_SALT=$(openssl rand -base64 32) \
+  --app memory-neo-api
+
+# 5. Deploy API
+fly deploy --config deploy/fly.api.toml
+
+# 6. Run Prisma migrations
+fly ssh console --app memory-neo-api
+# Inside pod:
+prisma migrate deploy --schema=schema.prisma
+```
+
+### Point CLI to your instance
+
+```bash
+memory-neo login --api-url https://your-api.fly.dev
+```
+
+---
+
+## Project structure
+
+```
+memory-neo/
+├── memory_neo/              ← Python package (pip install memory-neo)
+│   ├── cli/                 ← push, query, context, login commands
+│   ├── core/                ← scanner, AST extractor, ignore patterns
+│   ├── graph/               ← HTTP client to backend
+│   ├── nlp/                 ← result formatter
+│   └── utils/               ← config, display helpers
+├── api/                     ← FastAPI backend (Fly.io)
+│   ├── routes/              ← push, query, context, auth endpoints
+│   ├── services/            ← graph (Memgraph), nlp (Claude), auth
+│   └── db/                  ← schema.prisma (PostgreSQL)
+├── deploy/                  ← Dockerfiles, fly.toml configs, init.cypher
+└── docs/                    ← this file
+```
+
+---
+
+## Tech stack
+
+| Layer | Technology |
+|---|---|
+| CLI package | Python + Click + Rich |
+| Backend | FastAPI on Fly.io |
+| Graph DB | Memgraph on Fly.io (Bolt protocol) |
+| Postgres | Supabase |
+| NLP engine | Claude API (claude-sonnet) |
+| Auth | API key (SHA-256 hashed) |
+
+---
+
+## License
+
+MIT

memory_neo-0.1.0/docs/README.md

@@ -0,0 +1,212 @@
+# memory-neo/docs/README.md
+# Path: docs/README.md
+# Purpose: User-facing documentation — install, usage, deployment
+
+# 🧠 memory-neo
+
+Push your codebase to a graph database. Query it with natural language.
+
+```bash
+pip install memory-neo
+cd your-project/
+memory-neo push
+memory-neo query "show all auth functions"
+memory-neo context parse_directory
+```
+
+---
+
+## How it works
+
+1. **Push** — `memory-neo push` scans your project, extracts files and Python functions via AST, and sends the structure to a hosted Memgraph graph database.
+2. **Query** — `memory-neo query "..."` converts your question to Cypher via Claude, runs it against your graph, and prints results with code highlighting.
+3. **Context** — `memory-neo context <name>` fetches a function or file as prompt-ready code you can paste into any LLM.
+
+---
+
+## Install
+
+```bash
+pip install memory-neo
+```
+
+Python 3.9+ required.
+
+---
+
+## Authentication
+
+Get an API key at [memory-neo.dev](https://memory-neo.dev), then:
+
+```bash
+memory-neo login
+# Paste your API key when prompted
+# Saved to ~/.memoryneo/config.json
+```
+
+---
+
+## Commands
+
+### `memory-neo push`
+
+Scan the current directory and push its structure to Memgraph.
+
+```bash
+memory-neo push                        # use directory name as project name
+memory-neo push my-project             # explicit project name
+memory-neo push --dir ./src            # scan a subdirectory
+memory-neo push --dry-run              # scan only, don't push
+```
+
+What gets indexed:
+- Files: `.py` `.js` `.jsx` `.ts` `.tsx` `.html` `.md` `.txt`
+- Python: full AST extraction — function names, line numbers, args, docstrings, code
+- Other: file name, path, content, line count
+
+Ignored by default (via `memIgnore`):
+- `.venv/`, `node_modules/`, `__pycache__/`, `.git/`, `*.pyc`, `.env`, and more
+
+Custom ignore: place a `memIgnore` file in your project root (same syntax as `.gitignore`).
+
+---
+
+### `memory-neo query`
+
+Ask a natural language question about your indexed codebase.
+
+```bash
+memory-neo query "show all auth functions"
+memory-neo query "which files import httpx"
+memory-neo query "list all Python files"
+memory-neo query "how many functions are in each file"
+memory-neo query "show the parse_directory function"
+memory-neo query --project my-project "show all classes"
+memory-neo query --raw "..."           # print raw JSON
+memory-neo query --context "..."       # dump results as prompt-ready context block
+memory-neo query                       # interactive mode
+```
+
+---
+
+### `memory-neo context`
+
+Fetch the raw code of a function or file — ready to paste into a prompt.
+
+```bash
+memory-neo context parse_directory           # fetch function by name
+memory-neo context memory_neo/main.py        # fetch file by path
+memory-neo context login --type function     # force function lookup
+memory-neo context main.py --copy            # copy to clipboard
+```
+
+---
+
+## Ignore patterns (`memIgnore`)
+
+Place a `memIgnore` file in your project root to control what gets scanned.
+Uses the same syntax as `.gitignore`:
+
+```
+# Folders
+.venv/
+node_modules/
+dist/
+
+# Wildcards
+*.log
+*.tmp
+*.pyc
+
+# Files
+.env
+secrets.json
+```
+
+If no `memIgnore` is found in your project, the package default is used (covers most common cases).
+
+---
+
+## Self-hosting
+
+You can run the entire backend yourself.
+
+### Requirements
+- Fly.io account
+- Supabase (or any PostgreSQL) account
+- Anthropic API key
+
+### Deploy
+
+```bash
+# 1. Deploy Memgraph
+fly deploy --config deploy/fly.memgraph.toml
+
+# 2. Create persistent volume
+fly volumes create memgraph_data --size 20 --region cdg --app memory-neo-graph
+
+# 3. Init Memgraph schema
+fly ssh console --app memory-neo-graph
+# Inside pod:
+cat /init.cypher | mgconsole
+
+# 4. Set API secrets
+fly secrets set \
+  ANTHROPIC_API_KEY=sk-ant-... \
+  DATABASE_URL=postgresql://... \
+  API_SECRET_SALT=$(openssl rand -base64 32) \
+  --app memory-neo-api
+
+# 5. Deploy API
+fly deploy --config deploy/fly.api.toml
+
+# 6. Run Prisma migrations
+fly ssh console --app memory-neo-api
+# Inside pod:
+prisma migrate deploy --schema=schema.prisma
+```
+
+### Point CLI to your instance
+
+```bash
+memory-neo login --api-url https://your-api.fly.dev
+```
+
+---
+
+## Project structure
+
+```
+memory-neo/
+├── memory_neo/              ← Python package (pip install memory-neo)
+│   ├── cli/                 ← push, query, context, login commands
+│   ├── core/                ← scanner, AST extractor, ignore patterns
+│   ├── graph/               ← HTTP client to backend
+│   ├── nlp/                 ← result formatter
+│   └── utils/               ← config, display helpers
+├── api/                     ← FastAPI backend (Fly.io)
+│   ├── routes/              ← push, query, context, auth endpoints
+│   ├── services/            ← graph (Memgraph), nlp (Claude), auth
+│   └── db/                  ← schema.prisma (PostgreSQL)
+├── deploy/                  ← Dockerfiles, fly.toml configs, init.cypher
+└── docs/                    ← this file
+```
+
+---
+
+## Tech stack
+
+| Layer | Technology |
+|---|---|
+| CLI package | Python + Click + Rich |
+| Backend | FastAPI on Fly.io |
+| Graph DB | Memgraph on Fly.io (Bolt protocol) |
+| Postgres | Supabase |
+| NLP engine | Claude API (claude-sonnet) |
+| Auth | API key (SHA-256 hashed) |
+
+---
+
+## License
+
+MIT

memory_neo-0.1.0/memory_neo/__init__.py

@@ -0,0 +1,5 @@
+# memory-neo/memory_neo/__init__.py
+# Path: memory_neo/__init__.py
+# Purpose: Package init — exposes version
+
+__version__ = "0.1.0"

memory_neo-0.1.0/memory_neo/cli/__init__.py

@@ -0,0 +1,2 @@
+# memory-neo/memory_neo/cli/__init__.py
+# Path: memory_neo/cli/__init__.py

memory_neo-0.1.0/memory_neo/cli/context.py

@@ -0,0 +1,86 @@
+# memory-neo/memory_neo/cli/context.py
+# Path: memory_neo/cli/context.py
+# Purpose: `memory-neo context <fn_or_file>` — fetch code from Memgraph, print prompt-ready
+# Flow: user names a function or file → GET /context → returns raw code block
+
+import click
+import httpx
+
+from memory_neo.utils.config import require_auth
+from memory_neo.utils.display import error, info, panel
+from rich.syntax import Syntax
+from rich.console import Console
+
+console = Console()
+
+
+@click.command()
+@click.argument("target")
+@click.option("--project", "-p", default=None, help="Project name (default: current dir name)")
+@click.option("--type", "-t", "target_type", default="auto",
+              type=click.Choice(["auto", "function", "file"]),
+              help="Whether target is a function or file (default: auto-detect)")
+@click.option("--copy", "-c", is_flag=True, help="Copy result to clipboard")
+def context(target, project, target_type, copy):
+    """Fetch a function or file as prompt-ready context.
+
+    \b
+    Examples:
+      memory-neo context parse_directory
+      memory-neo context memory_neo/main.py
+      memory-neo context login --type function
+      memory-neo context --copy parse_directory
+    """
+    cfg = require_auth()
+
+    if not project:
+        import os
+        project = os.path.basename(os.path.abspath("."))
+
+    panel("memory-neo context", subtitle=f"Fetching: {target}")
+
+    try:
+        resp = httpx.get(
+            f"{cfg['api_url']}/context/{target}",
+            headers={"X-API-Key": cfg["api_key"]},
+            params={
+                "project_name": project,
+                "user_id": cfg["user_id"],
+                "target_type": target_type,
+            },
+            timeout=15,
+        )
+
+        if resp.status_code == 404:
+            error(f"Not found: [bold]{target}[/bold] in project [bold]{project}[/bold]")
+            info("Tip: run `memory-neo push` first to index your code.")
+            raise SystemExit(1)
+
+        if resp.status_code != 200:
+            error(f"Context fetch failed (HTTP {resp.status_code}): {resp.text}")
+            raise SystemExit(1)
+
+        data = resp.json()
+        code = data.get("code", "")
+        source = data.get("source", target)
+        lang = data.get("language", "python")
+
+        info(f"  Source   : [dim]{source}[/dim]")
+        info(f"  Type     : {data.get('type', '?')}")
+        if data.get("start_line"):
+            info(f"  Lines    : {data['start_line']}–{data['end_line']}")
+
+        console.print()
+        console.print(Syntax(code, lang, theme="monokai", line_numbers=True))
+
+        if copy:
+            try:
+                import subprocess
+                subprocess.run("pbcopy", input=code.encode(), check=True)
+                info("Copied to clipboard.")
+            except Exception:
+                error("Could not copy — install pbcopy (macOS) or xclip (Linux).")
+
+    except httpx.ConnectError:
+        error(f"Could not reach {cfg['api_url']}.")
+        raise SystemExit(1)

memory_neo-0.1.0/memory_neo/cli/login.py

@@ -0,0 +1,49 @@
+# memory-neo/memory_neo/cli/login.py
+# Path: memory_neo/cli/login.py
+# Purpose: `memory-neo login` — stores API key in ~/.memoryneo/config.json
+# Flow: user pastes API key → validated against backend → saved locally
+
+import click
+import httpx
+from memory_neo.utils.config import save_config, load_config
+from memory_neo.utils.display import success, error, info, panel
+
+
+@click.command()
+@click.option("--key", "-k", default=None, help="API key (skip interactive prompt)")
+@click.option("--api-url", default=None, help="Override API base URL (for self-hosting)")
+def login(key, api_url):
+    """Authenticate with your memory-neo API key."""
+
+    panel("memory-neo login", subtitle="Authenticate to push and query your repos")
+
+    if not key:
+        info("Get your API key at https://memory-neo.dev or run your own backend.")
+        key = click.prompt("  Paste your API key", hide_input=True)
+
+    base_url = api_url or "https://api.memory-neo.dev"
+
+    info(f"Validating key against {base_url} ...")
+
+    try:
+        resp = httpx.post(
+            f"{base_url}/auth/validate",
+            headers={"X-API-Key": key},
+            timeout=10,
+        )
+        if resp.status_code == 200:
+            data = resp.json()
+            save_config({
+                "api_key": key,
+                "api_url": base_url,
+                "user_id": data.get("user_id"),
+                "email": data.get("email"),
+            })
+            success(f"Logged in as {data.get('email', 'unknown')}.")
+            success("Config saved to ~/.memoryneo/config.json")
+        else:
+            error(f"Invalid API key (HTTP {resp.status_code}).")
+            raise SystemExit(1)
+    except httpx.ConnectError:
+        error(f"Could not reach {base_url}. Check your internet or --api-url.")
+        raise SystemExit(1)

memory_neo-0.1.0/memory_neo/cli/main.py

@@ -0,0 +1,35 @@
+# memory-neo/memory_neo/cli/main.py
+# Path: memory_neo/cli/main.py
+# Purpose: CLI entrypoint — registers all commands under `memory-neo` binary
+# Registered via pyproject.toml [project.scripts]: memory-neo = "memory_neo.cli.main:cli"
+
+
+import click
+from memory_neo import __version__
+from memory_neo.cli.login import login
+from memory_neo.cli.push import push
+from memory_neo.cli.query import query
+from memory_neo.cli.context import context
+
+
+@click.group()
+@click.version_option(__version__, prog_name="memory-neo")
+def cli():
+    """
+    \b
+    memory-neo — push your codebase to a graph, query it with language.
+
+    \b
+    Commands:
+      login    Authenticate with your API key
+      push     Scan current directory and push to Memgraph
+      query    Ask a natural language question about your code
+      context  Fetch a file or function as prompt-ready context
+    """
+    pass
+
+
+cli.add_command(login)
+cli.add_command(push)
+cli.add_command(query)
+cli.add_command(context)