Skip to content
Proyectos

aimasteracc/tree-sitter-analyzer

Ver en GitHub

aimasteracc/tree-sitter-analyzer has 61 GitHub stars and 17 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and 0 in 15 days. Last checked 2026-11-16 23:14 UTC. Last push 2026-11-01.

Cómo se miden estas cifras

What you can do

  • BM25-ranked symbol search - all search tools - min-max normalized relevance_score on every result; sort(by='confidence') in DSL
  • Semantic search (BM25 pre-filtered) - search action=chain (semantic() DSL) - lexical pre-filter before cosine rerank
  • Project A–F health grading - health action=project - combines size, complexity, dependencies, coverage, duplication, structure, and git hotspots
  • JSON output - every tool, output_format: "json" (default) - standard structured response envelopes

Crecimiento de estrellas medido

in 24h
0
in 7 days
0
in 15 days
0
in 1 month
Recopilando historial

Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.

Acerca de

Cross-language-safe code-intelligence MCP for AI agents: 13 languages, family-gated call graph, blast radius, health grading, 8 facade tools, JSON envelopes, 100% local. Run miswire-audit on your repo.

Herramientas de desarrollo

README.es-ES.md

Original

🌳 Tree-sitter Analyzer

English | 日本語 | 简体中文 | Español

PyPI Python License Coverage Stars Works with Claude Code · Cursor · MCP

Inteligencia de código en la que los agentes de IA pueden confiar — estructura correcta entre lenguajes según el inventario de lenguajes soportados, nativo para agentes (MCP + CLI).

TSA indexa tu base de código con tree-sitter y sirve gráficos de llamadas correctos, búsqueda de símbolos y consultas estructurales a agentes de código IA — localmente, sin telemetría.

Por qué es diferente:

  • Los vínculos entre lenguajes están controlados por familia. Una coincidencia de nombre no crea por sí sola una arista entre lenguajes; las puertas que lo imponen son pruebas ejecutables, no una convención.
  • Diseñado nativo para agentes. 8 herramientas MCP con salida JSON estructurada y sobres de veredicto, más acceso por CLI y flujos de trabajo curados.
  • Amplio y correctamente clasificado. El inventario de profundidad de soporte generado distingue la evidencia de pipeline del comportamiento entre archivos aún no verificado.

¿Actualizando desde v1.x? Consulta docs/MIGRATION.md.


Primeros pasos

Requiere Python 3.10+ (verifica con: python3 --version). Instálalo desde python.org si es necesario.

Instalación automatizada (recomendada)

curl -fsSL https://raw.githubusercontent.com/aimasteracc/tree-sitter-analyzer/main/install.sh | bash

Instala automáticamente uv si falta, detecta Claude Desktop / Claude Code / Cursor / VS Code, y escribe la entrada MCP. Ejecuta tree-sitter-analyzer --doctor para verificar.

Confianza en el arranque (bootstrap): por comodidad, el comando anterior descarga y ejecuta el instalador oficial de uv cuando uv falta o está desactualizado. Ese instalador es mutable y no está vinculado a un contenido fijo; TSA avisa antes de descargarlo a un archivo temporal por TLS y realiza una comprobación estricta de versión tras la instalación. Para evitar este arranque no verificado, instala uv >= 0.11.0 manualmente primero, o usa la opción segura de exclusión (que termina con instrucciones de instalación manual cuando se necesita el arranque):

curl -fsSL https://raw.githubusercontent.com/aimasteracc/tree-sitter-analyzer/main/install.sh \
  | TSA_DISABLE_UNVERIFIED_UV_BOOTSTRAP=1 bash

Comando de instalación para Claude Code:

claude mcp add tree-sitter-analyzer \
  --env TREE_SITTER_PROJECT_ROOT="$PWD" \
  -- uvx --from "tree-sitter-analyzer[mcp]" tree-sitter-analyzer-mcp

Reinicia tu agente y luego di: "Ejecuta la herramienta index con action=status." Equivalente en CLI (sin agente): tree-sitter-analyzer --codegraph-status

Usuarios de PyPI / uvx — instala las skills: las skills tsa-* vienen empaquetadas en la wheel. Cópialas una vez con:

tree-sitter-analyzer --install-skills              # into ./.claude/skills/ (this project)
tree-sitter-analyzer --install-skills-global       # into ~/.claude/skills/ (all projects)

Los usuarios que clonan el repositorio ya las tienen bajo .claude/skills/ — no se requiere ninguna acción.

Otros agentes (Cursor, Copilot, Cline, Continue, Claude Desktop, Roo Code) →

Instalación rápida

1. Instalar dependencias

# uv (required). This official convenience installer is mutable/not content-bound;
# see https://docs.astral.sh/uv/ for alternative manual installation methods.
curl -LsSf https://astral.sh/uv/install.sh | sh        # macOS / Linux
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows

2. Instalar Tree-sitter Analyzer

# Standalone install (persistent CLI command):
uv tool install "tree-sitter-analyzer[all,mcp]"
# — or skip installing entirely: the MCP entry below runs via uvx on demand.
# Inside a uv-managed Python project, use: uv add "tree-sitter-analyzer[all,mcp]"

3. Conéctalo a tu agente

Consulta Agentes soportados. La mayoría de los clientes necesitan esta entrada de servidor MCP:

{
  "mcpServers": {
    "tree-sitter-analyzer": {
      "command": "uvx",
      "args": ["--from", "tree-sitter-analyzer[mcp]", "tree-sitter-analyzer-mcp"],
      "env": { "TREE_SITTER_PROJECT_ROOT": "/absolute/path/to/your/project" }
    }
  }
}

Tras reiniciar: "Ejecuta la herramienta index con action=status." Equivalente en CLI (sin agente): tree-sitter-analyzer --codegraph-status

Comprueba la ventaja de corrección en tu propio repositorio — sin instalación, sin CodeGraph (primero reindexa):

uvx --from tree-sitter-analyzer miswire-audit .

Reporta posibles colisiones de nombres entre lenguajes para que puedas inspeccionar el comportamiento del resolutor en tu propio repositorio. Los resultados son diagnósticos, no una afirmación de benchmark competitivo.


Por qué Tree-sitter Analyzer

  • Salida estructurada. Las respuestas MCP usan sobres JSON estándar; el comportamiento del payload está protegido por pruebas de contrato de respuesta.
  • Sobres de veredicto. Cada respuesta lleva verdict: SAFE | CAUTION | UNSAFE | INFO | REVIEW | WARN | ERROR | NOT_FOUND, para que los orquestadores bifurquen según los resultados sin volver a preguntar.
  • Clasificación de salud del proyecto (A–F). TSA clasifica proyectos según tamaño, complejidad, cobertura, duplicación, dependencias, estructura y puntos calientes de git.
  • Flujos de trabajo curados (Skills). Subconjuntos de herramientas preconfigurados para "encontrar símbolo", "rastrear cadena de llamadas", "evaluar salud", "seguro para editar antes de refactorizar", "revisión de PR", etc.
  • Seguridad por capas. edit action=safe + edit action=guard + DSL de restricciones + edit action=impact + sobres de veredicto — diseñado para que los agentes sepan antes de tocar.
  • Una superficie de consulta compartida. Las primitivas de análisis y el DSL de consulta unificado están disponibles tanto para agentes como para shells.

Características clave

Inteligencia de código pre-indexada

El coste de un agente lo dominan los turnos, no el tamaño de cada respuesta: cada llamada extra a una herramienta reenvía la conversación completa. TSA está construido para que una llamada devuelva la evidencia necesaria para dejar de preguntar.

Pregunta Herramienta TSA Qué incluye la respuesta
Dónde está este símbolo y quién lo referencia nav action=navigate ubicación de definición, referencias y jerarquía de llamadas juntas
Qué se rompe si lo cambio nav action=impact dependientes transitivos con veredicto de riesgo
Quién llama a esto y a qué llama nav action=callers / action=callees puntos de llamada resueltos y los que no se pudieron resolver
Buscar un símbolo por nombre search action=symbol coincidencias ordenadas por relevancia (FTS5 + BM25)
Obtener símbolos relacionados con su mapa de relaciones structure action=explore los símbolos solicitados y cómo se conectan
¿El índice es utilizable ahora mismo? index action=status cobertura, antigüedad y número de bordes
Construir o refrescar el gráfico de llamadas index action=auto / action=full / action=sync estado del índice tras la ejecución
Qué pruebas toca este cambio --affected FILE... (CLI) pruebas afectadas de forma transitiva

Capacidades más allá de la navegación de código

Capacidad Herramienta TSA Nota
Búsqueda de símbolos clasificada por BM25 todas las herramientas de búsqueda relevance_score normalizado min-máx en cada resultado; sort(by='confidence') en el DSL
Búsqueda semántica (pre-filtrada por BM25) search action=chain (semantic() DSL) pre-filtro léxico antes de reordenar por coseno
Clasificación de salud del proyecto A–F health action=project combina tamaño, complejidad, dependencias, cobertura, duplicación, estructura y puntos calientes de git
Salida JSON cada herramienta, output_format: "json" (predeterminado) sobres de respuesta estructurados estándar
Sobres de veredicto cada herramienta SAFE/CAUTION/UNSAFE/INFO/WARN/ERROR/NOT_FOUND
Control de seguridad para editar edit action=safe / action=guard rechaza ediciones de alto riesgo antes de que ocurran
DSL de restricciones arquitectónicas edit action=constraints "el módulo A no puede importar B" → aplicado
Salud del código (nivel de archivo) health action=file detección de bloques/métodos largos/code smells
Jerarquía de clases structure action=class_tree árbol de herencia de tipos
Matriz de dependencias health action=matrix matriz de acoplamiento de módulos
Código muerto health action=dead análisis transitivo de inalcanzabilidad
Mapa de calor de complejidad health action=heatmap complejidad ciclomática por función + vista de proyecto
Detección de clones estructurales AST viz action=similarity más allá de la similitud textual
Exportación de gráfico de llamadas Mermaid viz action=graph listo para pegar en documentación
Exportación UML Mermaid viz action=uml diagramas de clase / paquete / componente / secuencia
Revisión de PR edit action=pr AST-diff + clasificación semántica + radio de impacto
agent_summary cada respuesta pista del siguiente paso incluida en el sobre
Resolutor Synapse entre archivos interno consciente de importaciones, supera la conjetura por regex
Activación temporal nav action=lineage frecuencia de modificación git por símbolo
Orientación de archivo project action=smart salud + exportaciones + deps + riesgo de edición en una respuesta combinada
Diario de decisiones arquitectónicas project action=journal persiste el razonamiento entre sesiones — poco común entre herramientas de inteligencia de código

Skills

TSA envía flujos de trabajo curados bajo .claude/skills/tsa-*/:

tsa-landing, tsa-find, tsa-graph, tsa-structure, tsa-deps, tsa-index, tsa-health-watch, tsa-edit-safety, tsa-edit-then-verify, tsa-constraints, tsa-pr-review, tsa-refactor-queue, tsa-temporal.

Cada skill incluye un subconjunto de allowed-tools + receta de procedimiento + esquema de superficie de decisión, para que el agente no tenga que clasificar entre 8 herramientas en cada pregunta.

367 banderas de CLI

Destacados:

tree-sitter-analyzer --table full <file>          # method/signature/complexity table
tree-sitter-analyzer --partial-read --start-line N --end-line M <file>
tree-sitter-analyzer --project-health             # A-F grade across the project
# Note: --callers / --callees require the call-graph index — run --full-index first
tree-sitter-analyzer --full-index                 # build call-graph index (run once)
tree-sitter-analyzer --callers <symbol>           # who-calls
tree-sitter-analyzer --codegraph-impact <fn>      # blast radius + risk
tree-sitter-analyzer --affected <file...>         # tests transitively affected
tree-sitter-analyzer --dead-code                  # transitive unreachable
tree-sitter-analyzer --check-constraints          # architectural rules
tree-sitter-analyzer --safe-to-edit <file>        # refuse if risky
tree-sitter-analyzer --uml class                  # Mermaid UML class diagram

TSA realiza la búsqueda indexada y la verificación de código fuente en el mismo proceso, sin instalar ripgrep ni fd.

search-content y find-and-grep se han eliminado en develop. Consulta la guía de migración y el mapa de CLI.


Gobernanza de afirmaciones cuantitativas

Las cifras públicas de benchmark, rendimiento o comparación competitiva solo se emiten desde el registro con procedencia verificada en benchmarks/codegraph_compare/claim_registry.json. La evidencia de nivel E4 debe vincular nombres y versiones exactos de las herramientas, mediciones, corpus, fecha/versión de benchmark, y un digest del artefacto. La evidencia por debajo de E4 permanece interna y no puede emitir texto público. Consulta el manual del benchmark.

La ausencia de un elemento generado significa que actualmente no hay ninguna afirmación pública cuantitativa autorizada. Las descripciones cualitativas anteriores son capacidades del producto delimitadas, no afirmaciones de superioridad medida.


Cómo funciona

Source code → tree-sitter parse → SQLite + FTS5 index (.ast-cache/index.db)
                                         ↓
        nav (navigate) / structure (explore) / nav (callers) / ...
                                         ↓
                            JSON response envelope
                            (verdict + agent_summary + data)
                                         ↓
                              MCP client / CLI consumer

Las 8 herramientas MCP exponen consultas indexadas y análisis directo del código fuente. Construye el índice AST explícitamente antes de las consultas indexadas de símbolos/contexto con tree-sitter-analyzer --ast-cache --ast-cache-mode index --format json. Actualízalo tras cambios en el código fuente con index action=sync. Las consultas indexadas reutilizan datos AST en caché; el precalentamiento automático es específico de cada herramienta.


Agentes soportados

📘 Claude Code (recomendado)
claude mcp add tree-sitter-analyzer \
  --env TREE_SITTER_PROJECT_ROOT="$PWD" \
  -- uvx --from "tree-sitter-analyzer[mcp]" tree-sitter-analyzer-mcp

Verifica: claude mcp list. Las skills tsa-* empaquetadas se auto-descubren desde .claude/skills/.

Usuarios de PyPI / uvx — instala las skills empaquetadas una vez con:

tree-sitter-analyzer --install-skills              # into ./.claude/skills/ (this project)
tree-sitter-analyzer --install-skills-global       # into ~/.claude/skills/ (all projects)

Los usuarios que clonan el repositorio ya las tienen — no se requiere ninguna acción.

📗 Claude Desktop

Edita claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\, Linux: ~/.config/Claude/):

{
  "mcpServers": {
    "tree-sitter-analyzer": {
      "command": "uvx",
      "args": ["--from", "tree-sitter-analyzer[mcp]", "tree-sitter-analyzer-mcp"],
      "env": { "TREE_SITTER_PROJECT_ROOT": "/absolute/path/to/your/project" }
    }
  }
}
📙 GitHub Copilot (VS Code)

Crea .vscode/mcp.json (nota: servers, no mcpServers):

{
  "servers": {
    "tree-sitter-analyzer": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "tree-sitter-analyzer[mcp]", "tree-sitter-analyzer-mcp"],
      "env": { "TREE_SITTER_PROJECT_ROOT": "${workspaceFolder}" }
    }
  }
}
🖱 Cursor / Cline / Continue / Roo Code

Todos leen el mismo esquema mcpServers que Claude Desktop. Cursor: Settings → MCP. Cline: panel MCP → Edit settings. Continue: ~/.continue/config.json bajo experimental.modelContextProtocolServers. Roo Code: panel MCP → Edit MCP Settings.

🐳 Docker (sin Python / uv local)

El repositorio incluye un Dockerfile que construye el servidor MCP (transporte stdio) desde el código fuente, para que la imagen siempre coincida con el código confirmado (committed).

# Build once
docker build -t tree-sitter-analyzer-mcp .

# Run against the current repo (server speaks MCP over stdio; -i keeps stdin open)
docker run --rm -i --user "$(id -u):$(id -g)" \
  -v "$PWD:/work" -w /work tree-sitter-analyzer-mcp

--user "$(id -u):$(id -g)" ejecuta con tu UID/GID de host, para que .ast-cache/, el diario de decisiones y cualquier escritura de edit bajo el repositorio montado te pertenezcan a ti, no a root.

Configuración del cliente MCP (la raíz del proyecto dentro del contenedor es el punto de montaje /work):

{
  "mcpServers": {
    "tree-sitter-analyzer": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "--user", "1000:1000",
        "-v", "/absolute/path/to/your/project:/work",
        "-w", "/work",
        "-e", "TREE_SITTER_PROJECT_ROOT=/work",
        "tree-sitter-analyzer-mcp"
      ]
    }
  }
}

⚠️ TREE_SITTER_PROJECT_ROOT debe ser absoluto. El servidor aplica un límite de seguridad contra escapes de ruta mediante SecurityValidator.


Lenguajes soportados

Generado a partir de los registros en tiempo de ejecución; consulta docs/CODEMAPS/languages.md para la matriz de capacidades completa. 22 plugins: 13 registrados en el pipeline, 3 admitidos por el índice, 0 solo con despacho de llamadas, 5 de datos/markup, 1 de andamiaje (scaffold). pipeline_registered es evidencia de registro, no prueba positiva de vinculación entre archivos. pipeline_registered: C, C++, C#, Go, Java, JavaScript, Kotlin, PHP, Python, Ruby, Rust, Swift, TypeScript | index_admitted: Bash, Lua, Scala | call_dispatch_only: | data_markup: CSS, HTML, Markdown, SQL, YAML | scaffold: JSON

Configuración

Casi nada. Los valores predeterminados están diseñados para que puedas conectarlo a tu agente y olvidarte:

  • Formato de salida: JSON. El parámetro output_format: "json" se conserva por explicitud.
  • Raíz del proyecto: TREE_SITTER_PROJECT_ROOT (variable de entorno, MCP) o --project-root (CLI).
  • Ubicación de la caché: <project>/.ast-cache/. Segura de eliminar — se reconstruye automáticamente.
  • Opcional: TREE_SITTER_OUTPUT_PATH como destino de escritura para salidas grandes.

Calidad y pruebas

Métrica Valor
Pruebas superadas Suite de pruebas integral ✅
Cobertura Coverage
Seguridad de tipos mypy
Plataformas macOS · Linux · Windows para operaciones ordinarias; la evidencia de instantáneas tiene el alcance más limitado descrito arriba
Puertas de pre-commit ruff · bandit · mypy · pyupgrade · detect-secrets · tsa-codemap-sync
uv run pytest -q                                # bounded local quick gate
uv run pytest tests/ -q --timeout=120 -m "not e2e and not network and not benchmark"  # comprehensive local suite
PYTEST_XDIST_AUTO_NUM_WORKERS=1 uv run pytest -q --maxfail=1                  # quick gate, one worker (lower CPU load)
PYTEST_XDIST_AUTO_NUM_WORKERS=2 uv run pytest -q --maxfail=1                  # quick gate, two workers (balanced)
uv run pytest --lf --maxfail=1                  # rerun only failed tests from last run
uv run python check_quality.py --new-code-only  # quality gate

Solución de problemas

Síntoma Solución
unsupported language en .swift / .kt / .rb / .php / .cs Actualiza a una versión soportada actual — la brecha del lenguaje faltante se corrigió en el commit 50e99a8f. Los módulos de gramática para lenguajes controlados por extras no vienen empaquetados en la instalación base; ejecuta pip install "tree-sitter-analyzer[swift]" (o kotlin, ruby, php, csharp) para añadirlos.
El servidor MCP no aparece en el cliente TREE_SITTER_PROJECT_ROOT debe ser una ruta absoluta (p. ej. $(pwd) o /home/user/project); una ruta relativa hace que el servidor resuelva contra el directorio incorrecto. Reinicia el cliente después de editar. Ejecuta tree-sitter-analyzer --doctor para verificar.
database is locked Detén cualquier otro proceso que tenga abierto .ast-cache/index.db; si persiste, rm -rf .ast-cache && tree-sitter-analyzer --full-index.
Primera llamada lenta o índice faltante Algunas herramientas precalientan el índice automáticamente. Ejecuta --full-index de antemano antes de las consultas indexadas.
El agente elige la herramienta equivocada Usa una skill tsa-* (/tsa-graph, /tsa-find, ...) — cada skill restringe el conjunto de herramientas visible a su flujo de trabajo dedicado.

Desarrollo

git clone https://github.com/aimasteracc/tree-sitter-analyzer.git
cd tree-sitter-analyzer
uv sync --extra all --extra mcp
uv run pytest -q                                # quick gate (bounded)

Consulta docs/CONTRIBUTING.md para la guía de desarrollo.


Límites y alcance conocido

Afirmaciones de alcance que, leídas sueltas, parecerían marketing. Se reúnen aquí para no interrumpir la ruta de instalación de arriba.

Tamaño de respuesta y nombres de parámetros

nav action=navigate inserta el cuerpo de cada definición que coincide y no informa truncamiento. Cuando varias clases de archivos distintos comparten un nombre de símbolo, el conjunto completo de referencias se devuelve en la misma respuesta. Usa search action=symbol para acotar primero, o nav action=callers / action=callees, que respetan limit y activan truncated.

symbol y function_name se aceptan en callers, callees e impact. navigate y lineage requieren symbol; pasarles function_name lanza una excepción en lugar de devolver un sobre de veredicto.

Alcance de la evidencia de instantáneas por plataforma

El análisis de archivos ordinario, la creación/actualización del índice, y las consultas heredadas respaldadas por índice son independientes del acceso certificado a instantáneas (snapshots). Sus rutas operativas existentes en Windows no requieren el nuevo núcleo privado de instantáneas WAL. Pueden crear o actualizar la caché; el acceso certificado de solo lectura tiene un contrato separado.

La implementación de instantáneas añade captura de evidencia de base de datos/WAL privada exclusiva de POSIX, que requiere operaciones relativas a descriptores, O_NOFOLLOW, un directorio temporal externo seguro, y comprobaciones exitosas de origen/manifiesto/proyección. No aporta paridad de instantáneas de solo lectura en Windows ni extiende la puerta de calificación existente para consumidores explícitos con access_mode="read_existing".

La certificación de instantáneas en Windows ya no estaba disponible en la línea base de develop (SECURE_FD_SNAPSHOT_UNSUPPORTED). Sigue sin estar disponible en esta implementación (WAL_PRIVATE_SNAPSHOT_UNSUPPORTED, completeness="unknown", sin token de instantánea). Esto no es una afirmación de que el índice físico esté vacío ni de que las consultas ordinarias estén deshabilitadas. No se ha realizado la calificación nativa de Windows para la nueva ruta de captura; una prueba local de capacidad no la sustituye.

El estado certified_at por archivo no reemplaza la autoridad completa de instantáneas. El historial persistente partial_at no está implementado ni incluido en este PR. Una proyección incompleta o no verificable no puede autorizar a un consumidor certificado.

Pulse / TQL / Semantic Query

Estos subsistemas sostienen acciones de nav y la API interna; no forman parte de la superficie de herramientas que un agente configura. Sus límites se declaran en lugar de insinuarse.

Los selectores temporales de TQL comparan marcas de tiempo de modificación, no recuentos de modificación. La acción tql_schema documenta la ventana y el valor por defecto compartido para :hot y :recently_modified sin calificar. Las consultas de profundidad conservan la identidad exacta de la definición y fallan explícitamente cuando se superan los límites de recorrido.

Las solicitudes de Pulse devuelven contexto vinculado a una instantánea. Las lecturas SQL para identidad, relaciones, contexto de importación inversa y el enriquecimiento LSP en caché opcional comparten un punto de guardado (savepoint) sin terminar una transacción propiedad del llamador. Esto no es un round-trip de SQL ni una garantía de latencia.

El contexto de importación inversa de Python en Pulse usa el resolutor de módulos existente; esto no es una afirmación de resolución completa de módulos entre lenguajes. El contexto de comentarios requiere un índice reconstruido con extracción de comentarios. Los índices antiguos y los lenguajes sin extracción de comentarios devuelven COMMENTS_NOT_INDEXED, en lugar de un éxito vacío; omite explícitamente el contexto de comentarios con el ajuste documentado max_comments cuando no se necesita. Las proyecciones de mensajes de commit heredadas que faltan pasan a pending para actualización perezosa; se conserva la activación disabled. Los estados de activación NULL heredados también pasan a pending, sin borrar mensajes o conteos antiguos. Los ciclos de indexación en caché habilitados continúan con actualización de activación acotada. Pulse expone la activación no disponible como null, mientras que las consultas temporales rechazan evidencia de activación incompleta. La actualización lee historial real de Git mediante lotes acotados; las lecturas de mensajes fallidas conservan el trabajo pendiente en lugar de reclamar finalización.

Las consultas semánticas requieren un modelo de embedding almacenado conocido y una dimensión consistente. Modelos mixtos o desconocidos son errores, sin resolución alternativa de proveedor. Las pruebas offline usan dobles de modelo; no certifican la calidad de un proveedor en vivo.

Los lotes de Pulse conservan las entradas exitosas pero reportan fallo si un objetivo falla. TQL trata los índices faltantes o ilegibles como errores, distintos de un índice listo sin coincidencias. La validación de solicitudes públicas rechaza tipos y límites inválidos antes de abrir el índice o invocar un proveedor de embeddings.


Contribuciones y licencia

  • ⭐ Una estrella en GitHub ayuda a que esta herramienta llegue a otros usuarios de agentes de IA.
  • 💖 Patrocinador — apoya el desarrollo continuo de MCP / Skills.
  • Patrocinador principal: @o93.
  • Con licencia MIT — consulta LICENSE.
  • Historial de versiones: CHANGELOG.md.