neux 0.2.0__tar.gz

neux-0.2.0/LICENSE

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

neux-0.2.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: neux
+Version: 0.2.0
+Summary: Codebase nervous system — knowledge graph for AI-assisted development
+Author: IronDevz
+License: MIT
+Project-URL: Homepage, https://github.com/IronDevz/neux
+Project-URL: Repository, https://github.com/IronDevz/neux
+Keywords: claude-code,codebase,graph,ast,context,ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0
+Requires-Dist: jinja2>=3.1
+Requires-Dist: tree-sitter>=0.23
+Requires-Dist: tree-sitter-language-pack>=0.4
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Dynamic: license-file
+
+# NEUX
+
+> Codebase nervous system — knowledge graph for AI-assisted development.
+
+NEUX is a Python CLI that builds a relationship graph of your codebase in SQLite,
+detects patterns and conventions automatically (no LLM, pure AST), and integrates
+with [Claude Code](https://claude.com/claude-code) via hooks to inject precise context
+at the moment a tool call is about to modify a file.
+
+Companion of [ANVL](https://github.com/juanlumanmx29/anvl). ANVL monitors tokens per
+session. NEUX maps project intelligence.
+
+⚒ forged by **IronDevz**
+
+---
+
+## Features (v0.1)
+
+- SQLite knowledge graph with FTS5 full-text search
+- Language scanners: Python (`ast`), React/JS/TS/JSX/TSX (tree-sitter), SQL
+- 12 pattern/convention detectors (naming, imports, security, style, UI, API, data, state, errors, file structure, testing)
+- Claude Code hooks that inject contextual rules before `Write`/`Edit`
+- Auto-generated `CLAUDE.md` with module sub-manuals
+- Impact analysis via recursive CTE (no networkx)
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+```bash
+cd your-project
+neux init               # initial scan, generates CLAUDE.md, installs hooks
+neux status             # graph stats
+neux impact <target>    # what breaks if you change this
+neux scan --changed     # incremental rescan
+```
+
+## License
+
+MIT © IronDevz

neux-0.2.0/README.md

@@ -0,0 +1,44 @@
+# NEUX
+
+> Codebase nervous system — knowledge graph for AI-assisted development.
+
+NEUX is a Python CLI that builds a relationship graph of your codebase in SQLite,
+detects patterns and conventions automatically (no LLM, pure AST), and integrates
+with [Claude Code](https://claude.com/claude-code) via hooks to inject precise context
+at the moment a tool call is about to modify a file.
+
+Companion of [ANVL](https://github.com/juanlumanmx29/anvl). ANVL monitors tokens per
+session. NEUX maps project intelligence.
+
+⚒ forged by **IronDevz**
+
+---
+
+## Features (v0.1)
+
+- SQLite knowledge graph with FTS5 full-text search
+- Language scanners: Python (`ast`), React/JS/TS/JSX/TSX (tree-sitter), SQL
+- 12 pattern/convention detectors (naming, imports, security, style, UI, API, data, state, errors, file structure, testing)
+- Claude Code hooks that inject contextual rules before `Write`/`Edit`
+- Auto-generated `CLAUDE.md` with module sub-manuals
+- Impact analysis via recursive CTE (no networkx)
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+```bash
+cd your-project
+neux init               # initial scan, generates CLAUDE.md, installs hooks
+neux status             # graph stats
+neux impact <target>    # what breaks if you change this
+neux scan --changed     # incremental rescan
+```
+
+## License
+
+MIT © IronDevz

neux-0.2.0/logo.txt

@@ -0,0 +1,11 @@
+ ███▄    █ ▓█████  █    ██ ▒██   ██▒
+ ██ ▀█   █ ▓█   ▀  ██  ▓██▒▒▒ █ █ ▒░
+▓██  ▀█ ██▒▒███   ▓██  ▒██░░░  █   ░
+▓██▒  ▐▌██▒▒▓█  ▄ ▓▓█  ░██░ ░ █ █ ▒
+▒██░   ▓██░░▒████▒▒▒█████▓ ▒██▒ ▒██▒
+░ ▒░   ▒ ▒ ░░ ▒░ ░░▒▓▒ ▒ ▒ ▒▒ ░ ░▓ ░
+░ ░░   ░ ▒░ ░ ░  ░░░▒░ ░ ░ ░░   ░▒ ░
+   ░   ░ ░    ░    ░░░ ░ ░  ░    ░
+         ░    ░  ░   ░       ░    ░
+            ⚒ forged by IronDevz
+   codebase nervous system v0.1.0

neux-0.2.0/neux/__init__.py

@@ -0,0 +1,8 @@
+"""NEUX — codebase nervous system.
+
+Python CLI that builds a knowledge graph of your codebase in SQLite,
+detects patterns automatically, and integrates with Claude Code via hooks.
+"""
+
+__version__ = "0.1.0"
+__author__ = "IronDevz"

neux-0.2.0/neux/categorizer.py

@@ -0,0 +1,141 @@
+"""TaskCategorizer — classify a user prompt + file path into a task category.
+
+Returns one of:
+``style_change`` | ``logic_change`` | ``new_feature`` | ``bug_fix`` | ``refactor`` |
+``test_writing`` | ``api_change`` | ``database_change`` | ``config_change`` | ``general``
+
+The categorization is score-based: count keyword hits in the prompt, add a
+path hint (e.g. ``components/`` → ``style_change`` weight bump). No NLP, no LLM.
+Kept deliberately simple so the hook entrypoint can run it without any heavy imports.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+# Keywords per category — bilingual (Spanish + English) to match how IronDevz
+# developers usually phrase requests.
+CATEGORY_KEYWORDS: dict[str, list[str]] = {
+    "style_change": [
+        "color", "colour", "style", "styles", "estilo", "estilos", "css", "scss",
+        "sass", "theme", "tema", "font", "fuente", "tailwind", "responsive",
+        "padding", "margin", "layout", "design", "diseño", "ui", "visual",
+        "dark mode", "tipograf", "hover", "border",
+    ],
+    "new_feature": [
+        "crear", "nuevo", "nueva", "agregar", "añadir", "implementar",
+        "construir", "create", "add", "build", "implement", "feature",
+        "introduce", "support for", "soporte para",
+    ],
+    "logic_change": [
+        "función", "function", "cambiar", "modificar", "change", "modify",
+        "update", "actualizar", "adjust", "ajustar", "transform", "lógica",
+        "logic", "algorithm", "algoritmo", "flow", "flujo",
+    ],
+    "bug_fix": [
+        "bug", "error", "errors", "errores", "fix", "arreglar", "crash",
+        "falla", "broken", "roto", "issue", "problema", "incorrect",
+        "incorrecto", "no funciona", "not working", "regression", "regresión",
+    ],
+    "refactor": [
+        "refactor", "refactoring", "rename", "renombrar", "reorganizar",
+        "reorganize", "cleanup", "limpiar", "extract", "extraer", "simplify",
+        "simplificar", "dry", "deduplicate",
+    ],
+    "test_writing": [
+        "test", "tests", "prueba", "pruebas", "mock", "fixture", "coverage",
+        "spec", "unit test", "integration test", "pytest", "jest", "vitest",
+        "assert", "expect",
+    ],
+    "api_change": [
+        "endpoint", "endpoints", "api", "ruta", "rutas", "route", "routes",
+        "middleware", "auth", "authorization", "rest", "graphql", "request",
+        "response", "http", "get", "post", "put", "delete", "patch",
+    ],
+    "database_change": [
+        "tabla", "table", "migración", "migration", "modelo", "model",
+        "schema", "query", "sql", "database", "base de datos", "column",
+        "columna", "index", "índice", "foreign key", "constraint",
+    ],
+    "config_change": [
+        "config", "configuration", "configuración", "env", ".env", "docker",
+        "deploy", "deployment", "ci", "cd", "workflow", "pipeline",
+        "environment variable", "variable de entorno", "pyproject",
+        "package.json", "tsconfig", "settings",
+    ],
+}
+
+# Path hints: substring → category score bonus
+PATH_HINTS: dict[str, str] = {
+    "/components/": "style_change",
+    "/styles/": "style_change",
+    "/css/": "style_change",
+    "theme": "style_change",
+    "tailwind": "style_change",
+    "/api/": "api_change",
+    "/routes/": "api_change",
+    "/endpoints/": "api_change",
+    "/migrations/": "database_change",
+    ".sql": "database_change",
+    "/models/": "database_change",
+    "/tests/": "test_writing",
+    "test_": "test_writing",
+    ".test.": "test_writing",
+    ".spec.": "test_writing",
+    "dockerfile": "config_change",
+    ".env": "config_change",
+    "config": "config_change",
+}
+
+
+@dataclass(slots=True)
+class Categorization:
+    category: str
+    score: float
+    matched_keywords: list[str] = field(default_factory=list)
+    path_hint: str | None = None
+
+
+class TaskCategorizer:
+    """Score-based categorizer. No external dependencies."""
+
+    def __init__(
+        self,
+        keywords: dict[str, list[str]] | None = None,
+        path_hints: dict[str, str] | None = None,
+    ):
+        self.keywords = keywords or CATEGORY_KEYWORDS
+        self.path_hints = path_hints or PATH_HINTS
+
+    def categorize(self, prompt: str, file_path: str | None = None) -> Categorization:
+        if not prompt and not file_path:
+            return Categorization("general", 0.0)
+
+        lower_prompt = (prompt or "").lower()
+        scores: dict[str, float] = {k: 0.0 for k in self.keywords}
+        matched: dict[str, list[str]] = {k: [] for k in self.keywords}
+
+        for category, kws in self.keywords.items():
+            for kw in kws:
+                if kw in lower_prompt:
+                    scores[category] += 1.0
+                    matched[category].append(kw)
+
+        hint_category: str | None = None
+        if file_path:
+            lower_path = file_path.lower()
+            for substr, cat in self.path_hints.items():
+                if substr in lower_path:
+                    scores[cat] = scores.get(cat, 0.0) + 0.5
+                    hint_category = cat
+                    break
+
+        best = max(scores.items(), key=lambda kv: kv[1])
+        if best[1] == 0:
+            return Categorization("general", 0.0, path_hint=hint_category)
+        return Categorization(
+            category=best[0],
+            score=best[1],
+            matched_keywords=matched[best[0]],
+            path_hint=hint_category,
+        )