@dozimple/abap-adt 1.0.1 → 1.2.0

package/docs/TOOLS.md

@@ -1,17 +1,17 @@
 # Referencia de tools — abap-adt-doZimple
 
-Generado desde el código con `npm run docs`. 47 tools en 9 grupos y 3 flujos guiados.
+Generado desde el código con `npm run docs`. 51 tools en 9 grupos y 3 flujos guiados.
 Producto de [DoZimple](https://dozimple.cl).
 
 ## Índice
 
 - [Revisión de código y pases](#revision) — 5 tools: `transport_diff`, `transport_contents`, `co_change`, `inactive_objects`, `edit_preflight`
-- [Calidad, ATC y remediación](#calidad) — 5 tools: `run_atc`, `atc_quickfix`, `api_release_state`, `syntax_check`, `run_unit_tests`
-- [Exploración del repositorio](#exploracion) — 9 tools: `search_objects`, `get_source`, `where_used`, `object_versions`, `package_contents`, `ddic_type_info`, `transaction_info`, `function_modules`, `text_elements`
+- [Calidad, ATC y remediación](#calidad) — 6 tools: `run_atc`, `atc_quickfix`, `api_release_state`, `sap_notes`, `syntax_check`, `run_unit_tests`
+- [Exploración del repositorio](#exploracion) — 11 tools: `search_objects`, `get_source`, `where_used`, `source_search`, `object_versions`, `package_contents`, `ddic_type_info`, `transaction_info`, `function_modules`, `text_elements`, `enhancements`
 - [Consulta de datos](#datos) — 2 tools: `sql_query`, `table_contents`
 - [Diagnóstico de incidentes](#diagnostico) — 4 tools: `dumps`, `jobs`, `application_log`, `gateway_errors`
 - [Documentación SAP](#documentacion) — 7 tools: `abap_feature_matrix`, `docs_search`, `docs_fetch`, `clean_core_objects`, `clean_core_object`, `abap_lint`, `docs_community_search`
-- [Escritura controlada](#escritura) — 4 tools: `write_source`, `activate`, `write_text_elements`, `create_transport`
+- [Escritura controlada](#escritura) — 5 tools: `write_source`, `revert_source`, `activate`, `write_text_elements`, `create_transport`
 - [DoZimple Transport Risk](#transport-risk) — 7 tools: `analyze_transport_risk`, `import_health`, `failure_ranking`, `change_audit`, `object_transport_history`, `remote_source`, `transport_source_check`
 - [Operación y crecimiento](#operacion) — 4 tools: `sap_systems`, `report_gap`, `close_gap`, `usage_stats`
 - [Flujos guiados](#flujos-guiados)
@@ -185,6 +185,33 @@ Estado de liberación de un objeto SAP (clase, FM/BAPI, tabla, CDS…) por contr
 
 \* obligatorio
 
+### `sap_notes` — Notas SAP en el sistema (SNOTE)
+
+Estado de notas SAP en este sistema, como en SNOTE: si está descargada, estado de implementación (completa, incompleta, versión anterior, se puede implementar, obsoleta, no se puede implementar), estado de tratamiento, versión, componente y título. Con notes=[…] responde por notas concretas (p. ej. «¿está la 2198647 en PRD?»); sin notas, lista las del estado pedido. Solo conoce las notas descargadas en el sistema: no consulta el portal.
+
+| | |
+|---|---|
+| **Acceso** | Solo lectura |
+| **Créditos** | [abap-adt-api](https://github.com/marcellourbani/abap-adt-api) — Marcello Urbani (MIT, dependencia) |
+
+| Parámetro | Tipo | Por defecto | Descripción |
+|---|---|---|---|
+| `system` | string |  | Sistema SAP configurado. Obligatorio si hay varios y ninguno por defecto. |
+| `notes` | lista de string |  |  |
+| `implementation` | lista de `E` \| `U` \| `V` \| `N` \| `O` \| `-` |  | Sin notes: filtrar por estado de implementación (E completa, U incompleta, V versión anterior, N se puede implementar, O obsoleta, - no se puede) |
+| `component` | string |  | Sin notes: prefijo de componente, p. ej. SD-BF o MM-PUR |
+| `max` | number | 100 |  |
+
+\* obligatorio
+
+Salida estructurada (`structuredContent`, además del texto):
+
+| Campo | Tipo | Descripción |
+|---|---|---|
+| `notes` | lista de { note, downloaded, implementation, implementation_code, processing, version, component, title, processor } |  |
+| `total` | number |  |
+| `truncated` | boolean |  |
+
 ### `syntax_check` — Chequeo de sintaxis SAP
 
 Chequeo de sintaxis real de SAP (no abaplint). Si pasas `source`, se comprueba ESE código sin guardarlo: sirve para validar un cambio antes de escribirlo. Sin `source`, comprueba lo último guardado.
@@ -206,6 +233,16 @@ Chequeo de sintaxis real de SAP (no abaplint). Si pasas `source`, se comprueba E
 
 \* obligatorio
 
+Salida estructurada (`structuredContent`, además del texto):
+
+| Campo | Tipo | Descripción |
+|---|---|---|
+| `object` | string |  |
+| `checked` | `proposed` \| `saved` | proposed = la fuente pasada sin guardar; saved = lo último guardado |
+| `errors` | number |  |
+| `warnings` | number |  |
+| `messages` | lista de { severity, line, offset, text, uri } |  |
+
 ### `run_unit_tests` — Ejecutar ABAP Unit
 
 Ejecuta los tests ABAP Unit de una clase o programa y devuelve el resultado por método, con el detalle de cada fallo. Solo corre tests RISK LEVEL HARMLESS y DURATION SHORT. Si no hay clases de test lo dice: cero tests no es un éxito.
@@ -288,6 +325,41 @@ Lista de uso (where-used) de un objeto: quién lo referencia, con paquete y resp
 
 \* obligatorio
 
+### `source_search` — Buscar texto en el código
+
+Busca un texto (o una expresión regular) en el código fuente de un paquete (con subpaquetes), de una orden de transporte o de una lista de objetos, y devuelve objeto, include, línea y la línea encontrada. Sirve donde where_used no llega: llamadas dinámicas, literales, código Z que el índice de referencias no cubre. Lee cada fuente, así que exige un alcance y tiene tope de objetos; los objetos que no se pudieron leer se listan aparte.
+
+| | |
+|---|---|
+| **Acceso** | Solo lectura |
+| **Créditos** | [abap-adt-api](https://github.com/marcellourbani/abap-adt-api) — Marcello Urbani (MIT, dependencia)<br>[vibing-steampunk](https://github.com/oisee/vibing-steampunk) — oisee y contribuidores (MIT, idea) |
+
+| Parámetro | Tipo | Por defecto | Descripción |
+|---|---|---|---|
+| `system` | string |  | Sistema SAP configurado. Obligatorio si hay varios y ninguno por defecto. |
+| `text` * | string |  | Texto a buscar (sin distinguir mayúsculas), p. ej. RV_FLOW o 'CALL FUNCTION' |
+| `regex` | boolean | false | Tratar text como expresión regular (máx. 200 caracteres) |
+| `package` | string |  | Alcance: paquete de desarrollo |
+| `include_subpackages` | boolean | true |  |
+| `transport` | string |  | Alcance: orden (o tarea) de transporte |
+| `objects` | lista de string |  | Alcance: lista de objetos por nombre |
+| `ignore_comments` | boolean | false | No contar líneas de comentario |
+| `max_objects` | number | 150 |  |
+| `max_hits` | number | 300 |  |
+
+\* obligatorio
+
+Salida estructurada (`structuredContent`, además del texto):
+
+| Campo | Tipo | Descripción |
+|---|---|---|
+| `scope` | string |  |
+| `objects_in_scope` | number |  |
+| `scanned` | number | Objetos leídos |
+| `truncated` | boolean | true si el alcance tenía más objetos que max_objects o más coincidencias que max_hits |
+| `hits` | lista de { object, type, include, line, text } |  |
+| `skipped` | lista de { object, reason } | Objetos que no se pudieron leer |
+
 ### `object_versions` — Versiones de un objeto
 
 Historial de versiones de un objeto (fecha, autor, orden). Con show=N devuelve la fuente de la versión N de la lista (1 = la más reciente), para comparar con la actual.
@@ -395,6 +467,37 @@ Lee los símbolos de texto (TEXT-001…), textos de selección o encabezados de
 
 \* obligatorio
 
+### `enhancements` — Ampliaciones y BAdI
+
+Qué ampliaciones hay y dónde. badi=NOMBRE: implementaciones de esa BAdI, nuevas y clásicas, activas o no. program + program_type (PROG, CLAS, FUGR): ampliaciones de código (puntos y secciones implícitos o explícitos) implementadas dentro de ese programa, clase o grupo — lo que cambia el comportamiento de un estándar sin tocar su código. prefix (p. ej. Z): implementaciones de ampliación de ese espacio de nombres, por tipo. Solo lectura.
+
+| | |
+|---|---|
+| **Acceso** | Solo lectura |
+| **Créditos** | [abap-adt-api](https://github.com/marcellourbani/abap-adt-api) — Marcello Urbani (MIT, dependencia)<br>[vibing-steampunk](https://github.com/oisee/vibing-steampunk) — oisee y contribuidores (MIT, idea) |
+
+| Parámetro | Tipo | Por defecto | Descripción |
+|---|---|---|---|
+| `system` | string |  | Sistema SAP configurado. Obligatorio si hay varios y ninguno por defecto. |
+| `badi` | string |  | Definición de BAdI, p. ej. MB_MIGO_BADI |
+| `program` | string |  | Programa, clase o grupo de funciones ampliado, p. ej. SAPMV45A |
+| `program_type` | `PROG` \| `CLAS` \| `FUGR` | "PROG" |  |
+| `prefix` | string |  | Implementaciones cuyo nombre empieza así, p. ej. Z o ZSD |
+| `tool_type` | string |  | Con prefix: filtrar por tipo, p. ej. BADI_IMPL o HOOK_IMPL |
+| `max` | number | 200 |  |
+
+\* obligatorio
+
+Salida estructurada (`structuredContent`, además del texto):
+
+| Campo | Tipo | Descripción |
+|---|---|---|
+| `mode` | `badi` \| `program` \| `prefix` |  |
+| `target` | string |  |
+| `rows` | lista de record |  |
+| `total` | number |  |
+| `truncated` | boolean |  |
+
 <a id="datos"></a>
 ## Consulta de datos
 
@@ -417,6 +520,16 @@ Ejecuta un SELECT de ABAP SQL (con WHERE, JOIN, ORDER BY, subconsultas) vía la
 
 \* obligatorio
 
+Salida estructurada (`structuredContent`, además del texto):
+
+| Campo | Tipo | Descripción |
+|---|---|---|
+| `rows` | number | Filas devueltas |
+| `columns` | lista de string |  |
+| `values` | lista de record | Filas como objetos columna→valor (hasta 500; el texto las trae todas) |
+| `truncated` | boolean | true si values no incluye todas las filas |
+| `notes` | lista de string | Avisos de la política de datos (enmascarado, tope de filas) |
+
 ### `table_contents` — Contenido de una tabla
 
 Filas de una tabla, vista o CDS, con columnas y filtro opcionales. Atajo de sql_query para el caso típico «enséñame lo que hay en ZTABLA donde …». Para JOIN, subconsultas o agregados usa sql_query.
@@ -444,7 +557,7 @@ Filas de una tabla, vista o CDS, con columnas y filtro opcionales. Atajo de sql_
 
 ### `dumps` — Dumps (ST22)
 
-Lista los dumps de ejecución (ST22): fecha, error, programa, usuario y texto corto. Filtra por usuario y por texto (error o programa). Con detail=N devuelve el dump N completo (qué pasó, análisis, dónde terminó, fuente, pila).
+Lista los dumps de ejecución (ST22): fecha, error, programa, usuario y texto corto. Filtra por usuario y por texto (error o programa). Con detail=N devuelve el dump N completo (qué pasó, análisis, dónde terminó, fuente, pila). Con group_by (error, program, error_program, user, day) y days=N responde «los errores más frecuentes del periodo»: cuenta los dumps de los últimos N días agrupados, con primer y último caso, usuarios afectados y dónde terminó. La lista y el detalle salen del feed ADT (solo los más recientes); los grupos, de la cabecera de ST22 (SNAP_BEG).
 
 | | |
 |---|---|
@@ -459,9 +572,24 @@ Lista los dumps de ejecución (ST22): fecha, error, programa, usuario y texto co
 | `contains` | string |  | Filtra por error o programa, p. ej. CALL_FUNCTION_NOT_FOUND o ZFI_REPORTE |
 | `max` | number | 20 |  |
 | `detail` | number |  | Número de la lista para ver el dump completo |
+| `group_by` | `error` \| `program` \| `error_program` \| `user` \| `day` |  | Agrupar los dumps del periodo: por error, programa, error+programa, usuario o día |
+| `days` | number | 7 | Periodo hacia atrás para group_by (días) |
 
 \* obligatorio
 
+Salida estructurada (`structuredContent`, además del texto):
+
+| Campo | Tipo | Descripción |
+|---|---|---|
+| `mode` | `list` \| `detail` \| `groups` |  |
+| `total` | number | Dumps considerados (feed leído o filas del periodo) |
+| `period_days` | number |  |
+| `since` | string | AAAAMMDD desde el que se contó |
+| `truncated` | boolean | true si el periodo tiene más dumps de los que se pudieron leer |
+| `group_by` | `error` \| `program` \| `error_program` \| `user` \| `day` |  |
+| `groups` | lista de { key, count, first, last, users, where } |  |
+| `dumps` | lista de { n, error, program, user } |  |
+
 ### `jobs` — Jobs de fondo (SM37)
 
 Jobs de fondo por nombre (admite *), usuario, estado y fecha, con sus pasos (programa y variante). Responde «¿corrió anoche el job de X?, ¿por qué se canceló?». El log detallado del job sigue en SM37.
@@ -684,6 +812,28 @@ Sustituye la fuente COMPLETA de un objeto existente (o de un include de clase),
 
 \* obligatorio
 
+### `revert_source` — Volver a una versión anterior
+
+Deshace un cambio escribiendo de nuevo una versión anterior del objeto: la última activa (para limpiar un borrador inactivo tras un write_source cuya activación falló), la anterior a la activa, o una concreta del historial de object_versions. Pasa por la misma vista previa, confirmación, bloqueo y orden que write_source: nunca revierte por su cuenta. Solo objetos de código fuente.
+
+| | |
+|---|---|
+| **Acceso** | Escribe (solo DEV con `allowWrite`; nunca QAS/PRD) |
+| **Créditos** | [abap-adt-api](https://github.com/marcellourbani/abap-adt-api) — Marcello Urbani (MIT, dependencia) |
+
+| Parámetro | Tipo | Por defecto | Descripción |
+|---|---|---|---|
+| `system` | string |  | Sistema SAP configurado. Obligatorio si hay varios y ninguno por defecto. |
+| `object_name` * | string |  |  |
+| `object_type` | string |  | Tipo corto: PROG, INCL, CLAS, INTF, FUGR, FUNC, DDLS, DDLX, DCLS, TABL, STRU, VIEW, DTEL, DOMA, TTYP, MSAG, XSLT, BDEF, SRVD, SRVB, ENHO. También vale el tipo ADT (p. ej. PROG/P). |
+| `include` | `main` \| `definitions` \| `implementations` \| `macros` \| `testclasses` | "main" |  |
+| `target` | union | "active" | «active»: la última versión activa (deshace un borrador inactivo, p. ej. un write_source cuya activación falló). «previous»: la versión anterior a la activa (deshace la última activación). Un número N: la versión N tal como la lista object_versions. |
+| `transport` | string |  | Orden (o tarea) donde debe ir la reversión. Obligatoria salvo objetos locales |
+| `activate` | boolean | true |  |
+| `confirm_token` | string |  | Token de la vista previa. Sin él la tool no escribe: devuelve qué va a cambiar y el token, que se usa tras la conformidad del usuario (un solo uso, 10 min). |
+
+\* obligatorio
+
 ### `activate` — Activar objeto
 
 Activa un objeto y devuelve los mensajes de SAP tal cual (errores con línea, avisos, objetos que quedan inactivos).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dozimple/abap-adt",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "DoZimple MCP server for SAP ABAP: multi-system, secure by design — code review, ATC, diagnosis and documentation for ECC and S/4HANA",
   "keywords": [
     "sap",