klapcontext 0.2.0__tar.gz → 0.2.2__tar.gz

{klapcontext-0.2.0/src/klapcontext.egg-info → klapcontext-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: klapcontext
-Version: 0.2.0
+Version: 0.2.2
 Summary: Make your repository understandable to humans and AI.
 Author: Willy Cordon
 License-Expression: Apache-2.0

{klapcontext-0.2.0 → klapcontext-0.2.2}/src/klapcontext/__init__.py

@@ -1,3 +1,3 @@
 """KlapContext local engineering-context generator."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"

{klapcontext-0.2.0 → klapcontext-0.2.2}/src/klapcontext/context_builder.py

@@ -86,7 +86,7 @@ def _empty_raw() -> dict:
 
 
 def _semantic(root: Path, stack: dict) -> tuple[SemanticModel, dict]:
-    if "Laravel" in stack["frameworks"]:
+    if "Laravel" in stack["frameworks"] or "Lumen" in stack["frameworks"]:
         model = LaravelAdapter().analyze(root)
         return model, model.metadata["raw"]
     if "FastAPI" in stack["frameworks"]:

{klapcontext-0.2.0 → klapcontext-0.2.2}/src/klapcontext/detector.py

@@ -8,16 +8,20 @@ from .evidence import Evidence
 
 def detect_project(root: Path) -> tuple[dict, list[Evidence]]:
     evidence: list[Evidence] = []
-    stack = {"languages": [], "frameworks": [], "databases": [], "runtime": [], "infrastructure": []}
+    stack = {"languages": [], "frameworks": [], "databases": [], "runtime": [], "infrastructure": [], "package_managers": [], "project_type": "unknown"}
     def add(bucket: str, value: str, path: str, reason: str) -> None:
         if value not in stack[bucket]: stack[bucket].append(value)
         evidence.append(Evidence("file", path, reason, "CONFIRMED", 1.0))
     composer = root / "composer.json"
     if composer.exists():
         add("languages", "PHP", "composer.json", "Composer manifest detected")
+        stack["runtime"].append("PHP"); stack["package_managers"].append("composer")
         try: deps = {**json.loads(composer.read_text(encoding="utf-8")).get("require", {}), **json.loads(composer.read_text(encoding="utf-8")).get("require-dev", {})}
         except json.JSONDecodeError: deps = {}
         if "laravel/framework" in deps: add("frameworks", "Laravel", "composer.json", "laravel/framework dependency detected")
+        if "laravel/lumen-framework" in deps:
+            add("frameworks", "Lumen", "composer.json", "laravel/lumen-framework dependency detected")
+            stack["project_type"] = "backend-api"
     elif any(root.rglob("*.php")):
         # A standalone PHP repository has no Composer manifest to identify it,
         # but language analysis can still provide a useful generic model.
@@ -26,16 +30,33 @@ def detect_project(root: Path) -> tuple[dict, list[Evidence]]:
     package = root / "package.json"
     if package.exists():
         add("languages", "JavaScript", "package.json", "npm manifest detected")
+        stack["runtime"].append("Node.js"); stack["package_managers"].append("npm")
         try: deps = {**json.loads(package.read_text(encoding="utf-8")).get("dependencies", {}), **json.loads(package.read_text(encoding="utf-8")).get("devDependencies", {})}
         except json.JSONDecodeError: deps = {}
         for name, label in (("next", "Next.js"), ("vue", "Vue"), ("react", "React"), ("express", "Express"), ("@nestjs/core", "NestJS")):
             if name in deps: add("frameworks", label, "package.json", f"{name} dependency detected")
+        if any(root.rglob("*.ts")) or any(root.rglob("*.tsx")): add("languages", "TypeScript", "package.json", "TypeScript source detected")
     if (root / "pyproject.toml").exists() or (root / "requirements.txt").exists():
         python_manifest = root / "pyproject.toml" if (root / "pyproject.toml").exists() else root / "requirements.txt"
         add("languages", "Python", python_manifest.name, "Python manifest detected")
+        stack["runtime"].append("Python"); stack["package_managers"].append("pip")
         if "fastapi" in python_manifest.read_text(encoding="utf-8", errors="ignore").casefold(): add("frameworks", "FastAPI", python_manifest.name, "FastAPI dependency detected")
     if (root / "manage.py").exists(): add("frameworks", "Django", "manage.py", "Django entry point detected")
-    if list(root.glob("*.csproj")): add("languages", "C#", next(root.glob("*.csproj")).name, ".NET project detected")
+    if list(root.glob("*.csproj")):
+        add("languages", "C#", next(root.glob("*.csproj")).name, ".NET project detected"); stack["runtime"].append(".NET"); stack["package_managers"].append("NuGet")
+        if (root / "Program.cs").exists(): add("frameworks", ".NET Web API", "Program.cs", "ASP.NET entry point detected")
+    if (root / "go.mod").exists():
+        add("languages", "Go", "go.mod", "Go module detected"); stack["runtime"].append("Go"); stack["package_managers"].append("go modules")
+    if (root / "Cargo.toml").exists():
+        add("languages", "Rust", "Cargo.toml", "Rust manifest detected"); stack["runtime"].append("Rust"); stack["package_managers"].append("cargo")
+    if (root / "pom.xml").exists() or (root / "build.gradle").exists() or (root / "build.gradle.kts").exists():
+        manifest = "pom.xml" if (root / "pom.xml").exists() else "build.gradle" if (root / "build.gradle").exists() else "build.gradle.kts"
+        add("languages", "Java", manifest, "Java build manifest detected"); stack["runtime"].append("JVM"); stack["package_managers"].append("maven" if manifest == "pom.xml" else "gradle")
+    # Keep generic analysis useful for small repositories without a manifest.
+    for suffix, language in (("*.py", "Python"), ("*.js", "JavaScript"), ("*.ts", "TypeScript"), ("*.java", "Java"), ("*.go", "Go"), ("*.rs", "Rust")):
+        if language not in stack["languages"] and any(root.rglob(suffix)):
+            first = next(root.rglob(suffix)); add("languages", language, first.relative_to(root).as_posix(), f"{language} source file detected")
+    if any(name in stack["frameworks"] for name in ("Laravel", "Lumen", "FastAPI", "Express", "NestJS", ".NET Web API")): stack["project_type"] = "backend-api"
     if (root / "Dockerfile").exists(): add("infrastructure", "Docker", "Dockerfile", "Dockerfile detected")
     if list(root.glob("docker-compose*")) or list(root.glob("compose*")): add("infrastructure", "Docker Compose", "docker-compose", "Compose configuration detected")
     if (root / ".github" / "workflows").exists(): add("infrastructure", "GitHub Actions", ".github/workflows", "GitHub Actions workflows detected")

{klapcontext-0.2.0 → klapcontext-0.2.2}/src/klapcontext/frameworks/laravel.py

@@ -61,7 +61,7 @@ def _routes(root: Path) -> tuple[list[dict], list[dict]]:
     directory = root / "routes"
     if not directory.is_dir():
         return routes, scheduled
-    route_pattern = re.compile(r"Route::(get|post|put|patch|delete|options|any)\s*\(\s*['\"]([^'\"]+)['\"]\s*,\s*(.+?)\);", re.S | re.I)
+    route_pattern = re.compile(r"(?:Route|\$app|\$router)(?:::|->)(get|post|put|patch|delete|options|any)\s*\(\s*['\"]([^'\"]+)['\"]\s*,\s*(.+?)\);", re.S | re.I)
     resource_pattern = re.compile(r"Route::(?:api)?resource\s*\(\s*['\"]([^'\"]+)['\"]\s*,\s*([A-Za-z_]\w*(?:\\[A-Za-z_]\w*)*)::class", re.I)
     schedule_pattern = re.compile(r"Schedule::(?:command|job)\s*\(\s*['\"]([^'\"]+)['\"]\s*\).*?->([A-Za-z]\w*)\s*\(", re.S)
     for file in directory.glob("*.php"):
@@ -69,6 +69,9 @@ def _routes(root: Path) -> tuple[list[dict], list[dict]]:
         for match in route_pattern.finditer(text):
             method, uri, target = match.groups()
             handler = _symbol(target)
+            if not handler:
+                callback = re.search(r"['\"]([A-Za-z_]\w*)@([A-Za-z_]\w*)['\"]", target)
+                handler = f"{callback.group(1)}::{callback.group(2)}" if callback else None
             name = f"{method.upper()} /{uri.lstrip('/')}"
             routes.append({"type": "http", "method": method.upper(), "uri": "/" + uri.lstrip("/"), "name": name, "path": str(file.relative_to(root)), "source": str(file.relative_to(root)), "line": text.count("\n", 0, match.start()) + 1, "target": handler, "handler": handler, "middleware": [], "status": "CONFIRMED", "evidence": _e(root, file, match.start(), "Declaración de ruta Laravel", symbol=name)})
         for match in resource_pattern.finditer(text):

{klapcontext-0.2.0 → klapcontext-0.2.2}/src/klapcontext/portal.py

@@ -43,7 +43,7 @@ def system_map(interactions: dict) -> str:
         if edge.get("source") in points and edge.get("target") in points
     )
     boxes = "".join(
-        f"<g class='map-node'><rect x='{points[node['name']][0] - 65}' y='{points[node['name']][1] - 24}' width='130' height='48' rx='8'/>"
+        f"<g class='map-node' tabindex='0' role='button' data-node='{e(node['name'])}' data-kind='{e(node.get('type', 'componente'))}'><rect x='{points[node['name']][0] - 65}' y='{points[node['name']][1] - 24}' width='130' height='48' rx='8'/>"
         f"<text x='{points[node['name']][0]}' y='{points[node['name']][1] - 2}'>{e(node['name'])[:18]}</text>"
         f"<text class='map-kind' x='{points[node['name']][0]}' y='{points[node['name']][1] + 13}'>{e(node.get('type', 'componente'))[:18]}</text></g>"
         for node in nodes
@@ -113,10 +113,10 @@ def render(context: dict, agent_text: str, graphify_files: list[str]) -> str:
       </section>
       <section class='map-card' aria-label='Mapa de interacción del sistema'><header><div><span class='icon'>⌘</span><div><h2>Mapa del sistema</h2><p>Componentes, relaciones y puntos de entrada en una sola lectura.</p></div></div><button class='outline' data-go='tecnico'>Explorar evidencia <span>→</span></button></header>{system_map(system.get('system_interactions', {}))}</section>
       <section class='quick-grid'>
-        <article><b>{len(points)}</b><span>Puntos de entrada</span><small>CLI, HTTP, archivos o scheduler</small></article>
-        <article><b>{len(flows)}</b><span>Flujos principales</span><small>Procesos y secuencias detectadas</small></article>
-        <article><b>{len(evidence)}</b><span>Hechos confirmados</span><small>Con respaldo en el código</small></article>
-        <article class='attention'><b>{len(unknowns)}</b><span>Incertidumbres</span><small>Aspectos pendientes de validar</small></article>
+        <article data-go='entradas'><b>{len(points)}</b><span>Puntos de entrada</span><small>CLI, HTTP, archivos o scheduler</small></article>
+        <article data-go='flujos'><b>{len(flows)}</b><span>Flujos principales</span><small>Procesos y secuencias detectadas</small></article>
+        <article data-go='evidencia'><b>{len(evidence)}</b><span>Hechos confirmados</span><small>Con respaldo en el código</small></article>
+        <article class='attention' data-go='evidencia'><b>{len(unknowns)}</b><span>Pendientes de validar</span><small>Aspectos con evidencia insuficiente</small></article>
       </section>
       <section class='dashboard-bottom'><div class='compact-panel'><header><h2>Cómo se ejecuta</h2><button class='text-button' data-go='entradas'>Ver entradas →</button></header><div class='surfaces'>{surface_cards}</div></div>
       <div class='compact-panel'><header><h2>Lectura recomendada</h2><button class='text-button' data-go='flujos'>Ver flujos →</button></header><ul class='start-list'>{start_rows}</ul></div></section>

{klapcontext-0.2.0 → klapcontext-0.2.2/src/klapcontext.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: klapcontext
-Version: 0.2.0
+Version: 0.2.2
 Summary: Make your repository understandable to humans and AI.
 Author: Willy Cordon
 License-Expression: Apache-2.0

{klapcontext-0.2.0 → klapcontext-0.2.2}/tests/test_klapcontext.py

@@ -37,6 +37,22 @@ def test_detector_collects_confirmed_evidence(tmp_path):
     assert all(item.status == "CONFIRMED" for item in evidence)
 
 
+def test_detector_identifies_manifest_and_source_languages(tmp_path):
+    (tmp_path / "go.mod").write_text("module example")
+    (tmp_path / "src").mkdir(); (tmp_path / "src" / "main.ts").write_text("export {}")
+    stack, _ = detect_project(tmp_path)
+    assert {"Go", "TypeScript"} <= set(stack["languages"])
+    assert "go modules" in stack["package_managers"]
+
+
+def test_lumen_detection_and_route_adapter():
+    root = Path(__file__).parent / "fixtures" / "lumen_semantic"
+    stack, _ = detect_project(root)
+    assert "Lumen" in stack["frameworks"]
+    context = build(root, {"nodes": []})
+    assert context["system_model"]["routes"][0]["name"] == "POST /api/v1/call-vtex"
+
+
 def test_portal_has_dashboard_and_real_views(tmp_path):
     context = build(fixture_repo(tmp_path), {"nodes": [{"name": "UserController", "path": "app/Http/UserController.php", "type": "controller"}]})
     page = render_portal(context, render_agent(context), ["graph.html"])
@@ -45,6 +61,8 @@ def test_portal_has_dashboard_and_real_views(tmp_path):
     assert "data-view='flujos'" in page
     assert "data-go='evidencia'" in page
     assert "Copiar contexto" in page
+    assert "data-go='entradas'" in page
+    assert "data-node=" in page or "map-empty" in page
 
 
 def test_exclude_klap_is_idempotent(tmp_path, monkeypatch):