diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 8bc2590..bd1a3de 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -25,12 +25,12 @@ jobs: python-version: '3.11' cache: pip - run: python -m pip install --upgrade pip - - run: python -m pip install -e ".[dev]" + - run: python -m pip install -e ".[dev,gui]" - run: python -m pip check - name: Integration tests run: | set +e - python -m coverage run --branch --source=src -m pytest -p no:cacheprovider 2>&1 | tee test-output.log + python -m coverage run --branch --source=src -m pytest -p no:cacheprovider --junitxml=pytest.xml 2>&1 | tee test-output.log status=${PIPESTATUS[0]} if [ "$status" -ne 0 ]; then grep -E 'FAIL:|ERROR:|FAILED|AssertionError|ModuleNotFoundError|AttributeError|OSError|Ran [0-9]+ tests' test-output.log | tail -10 | while IFS= read -r line; do @@ -38,6 +38,16 @@ jobs: done fi exit "$status" + - name: Preserve test diagnostics + if: always() + uses: actions/upload-artifact@v4 + with: + name: tests-linux-${{ github.sha }} + path: | + pytest.xml + test-output.log + if-no-files-found: warn + retention-days: 14 - name: Branch coverage gate run: | python -m coverage report --precision=4 --fail-under=60 @@ -67,3 +77,34 @@ jobs: path: coverage.xml if-no-files-found: error retention-days: 14 + + windows-tests: + runs-on: windows-2022 + timeout-minutes: 30 + env: + LANCTL_GUI_BROWSER_TESTS: '1' + strategy: + fail-fast: false + matrix: + python-version: ['3.10', '3.11'] + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: ${{ matrix.python-version }} + cache: pip + - run: python -m pip install --upgrade pip + - run: python -m pip install -e ".[dev,gui]" + - name: Browser regression runtime (uses runner Microsoft Edge) + run: python -m pip install playwright==1.63.0 + - run: python -m pip check + - name: Native Windows regression tests + run: python -m pytest -q -p no:cacheprovider --junitxml=pytest.xml + - name: Preserve Windows test diagnostics + if: always() + uses: actions/upload-artifact@v4 + with: + name: tests-windows-${{ matrix.python-version }}-${{ github.sha }} + path: pytest.xml + if-no-files-found: warn + retention-days: 14 diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 78ce123..46dd590 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -3,13 +3,13 @@ name: Build release artifacts on: push: tags: ['v[0-9]+.[0-9]+.[0-9]+*'] - branches: ['stable/**'] + branches: ['stable/**', 'experimental-gui'] workflow_dispatch: inputs: version: description: Version without v prefix required: true - default: 0.3.3 + default: 0.3.4-alpha.1 permissions: contents: read @@ -19,7 +19,7 @@ env: concurrency: group: release-${{ github.ref }} - cancel-in-progress: false + cancel-in-progress: ${{ github.ref == 'refs/heads/experimental-gui' }} jobs: prepare: @@ -36,6 +36,18 @@ jobs: if [[ "${GITHUB_EVENT_NAME}" == "workflow_dispatch" ]]; then version='${{ inputs.version }}' stable_branch=false + elif [[ "${GITHUB_REF}" == refs/heads/experimental-gui ]]; then + version="$(python -c "import runpy; print(runpy.run_path('src/lanctl/__init__.py')['__version__'])")" + if [[ ! "$version" =~ -alpha\.[0-9]+$ ]]; then + echo 'experimental-gui requires an alpha version' >&2 + exit 1 + fi + published_tag="$(git ls-remote --tags origin "refs/tags/v${version}")" + if [[ -n "$published_tag" ]]; then + echo 'This experimental version is already published; increment the alpha version.' >&2 + exit 1 + fi + stable_branch=false elif [[ "${GITHUB_REF}" == refs/heads/stable/* ]]; then version="${GITHUB_REF_NAME#stable/}" stable_branch=true @@ -59,12 +71,12 @@ jobs: - uses: actions/setup-python@v5 with: {python-version: '3.11', cache: pip} - run: python -m pip install --upgrade pip - - run: python -m pip install -e ".[dev]" pyinstaller==6.21.0 + - run: python -m pip install -e ".[dev,gui]" pyinstaller==6.21.0 - run: python -m pip check - name: Tests run: | set +e - python -m coverage run --branch --source=src -m pytest -p no:cacheprovider 2>&1 | tee test-output.log + python -m coverage run --branch --source=src -m pytest -p no:cacheprovider --junitxml=pytest.xml 2>&1 | tee test-output.log status=${PIPESTATUS[0]} if [ "$status" -ne 0 ]; then grep -E 'FAIL:|ERROR:|FAILED|AssertionError|ModuleNotFoundError|AttributeError|OSError|Ran [0-9]+ tests' test-output.log | tail -10 | while IFS= read -r line; do @@ -72,6 +84,16 @@ jobs: done fi exit "$status" + - name: Preserve validation diagnostics + if: always() + uses: actions/upload-artifact@v4 + with: + name: release-validation-${{ github.sha }} + path: | + pytest.xml + test-output.log + if-no-files-found: warn + retention-days: 14 - name: Coverage gate run: | python -m coverage report --precision=4 --fail-under=60 @@ -168,6 +190,15 @@ jobs: if ($uninstalled.ExitCode -ne 0) { throw "Clean uninstall failed ($($uninstalled.ExitCode))" } if (-not (Test-Path -LiteralPath $sentinel)) { throw 'User data was not preserved' } if (Test-Path -LiteralPath "$install/LANCTL.exe") { throw 'Application files remain' } + - name: Frozen portable GUI smoke + timeout-minutes: 10 + shell: pwsh + run: | + $version = '${{ needs.prepare.outputs.version }}' + $portable = Join-Path $env:RUNNER_TEMP 'LANCTL-experimental-gui-smoke' + Expand-Archive -LiteralPath "dist/release/LANCTL-$version-windows-x64-portable.zip" -DestinationPath $portable + python tests/portable_smoke.py $portable + if ($LASTEXITCODE -ne 0) { throw 'Frozen experimental GUI smoke failed' } - uses: actions/upload-artifact@v4 with: name: windows-x64 @@ -259,7 +290,8 @@ jobs: - uses: softprops/action-gh-release@v2 with: tag_name: v${{ needs.prepare.outputs.version }} - name: LANCTL ${{ needs.prepare.outputs.version }} + name: ${{ needs.prepare.outputs.stable_branch == 'true' && format('LANCTL {0}', needs.prepare.outputs.version) || format('LANCTL {0} - GUI experimental (NO ESTABLE)', needs.prepare.outputs.version) }} + make_latest: ${{ needs.prepare.outputs.stable_branch == 'true' && 'true' || 'false' }} target_commitish: ${{ github.sha }} prerelease: ${{ needs.prepare.outputs.stable_branch != 'true' && contains(needs.prepare.outputs.version, '-') }} generate_release_notes: true diff --git a/LANCTL.spec b/LANCTL.spec index 4b96caa..d8a636f 100644 --- a/LANCTL.spec +++ b/LANCTL.spec @@ -29,6 +29,7 @@ datas = collect_data_files("manuf") + [ ("bundled/lanctl.lab.network-emulator.lcp", "bundled"), ("bundled/plugin-catalog.json", "bundled"), ("assets/lanctl-icon-v3.png", "assets"), + ("assets/launcher-icons", "assets/launcher-icons"), ("assets/device-icons", "assets/device-icons"), ("errorList.txt", "."), ] @@ -62,7 +63,7 @@ exe = EXE( strip=False, upx=True, console=True, - icon="assets/lanctl-v3.ico", + icon="assets/launcher-icons/lanctl.ico", version=VERSION_INFO, ) @@ -97,7 +98,7 @@ ip_exe = EXE( strip=False, upx=True, console=True, - icon="assets/lanctl-v3.ico", + icon="assets/launcher-icons/lanip.ico", version=VERSION_INFO, ) @@ -108,12 +109,12 @@ physical_a = Analysis( ["packaging/entrypoints/lanwire_entry.py"], pathex=[str(SOURCE_ROOT)], binaries=[], - datas=[], - hiddenimports=collect_submodules("lanctl.apps.wire"), + datas=datas, + hiddenimports=["paramiko", "cryptography"] + collect_runtime_modules(), hookspath=[], hooksconfig={}, runtime_hooks=[], - excludes=["PIL", "numpy"], + excludes=LEGACY_GUI_EXCLUDES, noarchive=False, optimize=0, ) @@ -131,7 +132,7 @@ physical_exe = EXE( strip=False, upx=True, console=True, - icon="assets/lanctl-v3.ico", + icon="assets/launcher-icons/lanwire.ico", version=VERSION_INFO, ) @@ -163,7 +164,7 @@ monitor_exe = EXE( strip=False, upx=True, console=True, - icon="assets/lanctl-v3.ico", + icon="assets/launcher-icons/lanmon.ico", version=VERSION_INFO, ) @@ -180,7 +181,7 @@ rack_pyz = PYZ(rack_a.pure) rack_exe = EXE( rack_pyz, rack_a.scripts, rack_a.binaries, rack_a.datas, [], name="lanrack", debug=False, bootloader_ignore_signals=False, strip=False, upx=True, console=True, - icon="assets/lanctl-v3.ico", version=VERSION_INFO, + icon="assets/launcher-icons/lanrack.ico", version=VERSION_INFO, ) access_a = Analysis( @@ -196,5 +197,5 @@ access_pyz = PYZ(access_a.pure) access_exe = EXE( access_pyz, access_a.scripts, access_a.binaries, access_a.datas, [], name="lanaccess", debug=False, bootloader_ignore_signals=False, strip=False, upx=True, console=True, - icon="assets/lanctl-v3.ico", version=VERSION_INFO, + icon="assets/launcher-icons/lanaccess.ico", version=VERSION_INFO, ) diff --git a/README.md b/README.md index 20f56db..20cfe95 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,14 @@ -# LANCTL +# LANCTL — GUI experimental + +> **PROTOTIPO EXPERIMENTAL — NO ES UNA VERSIÓN ESTABLE.** +> Rama `experimental-gui`, versión **0.3.4-alpha.1**. Para pruebas de la GUI en +> Windows x64: [descargas e instrucciones](docs/RELEASE-0.3.4-alpha.1.md). +> La versión estable sigue disponible en [Releases](https://github.com/CctrGy/LANCTL/releases/latest). Interfaces de los seis launchers: [CLI y TUI](docs/LAUNCHER-INTERFACES.md). +Centro de administración GUI: `lanctl --gui`; consulta [GUI de LANCTL](docs/LANCTL-GUI.md). + Interfaz de escritorio de LANIP: [GUI de LANIP](docs/LANIP-GUI.md). Se ejecuta con `lanip --gui` y se incluye en los instaladores de Windows de 0.3.3. Linux conserva la distribución CLI/TUI. @@ -17,8 +24,8 @@ La [LANCTL Reference](reference/index.html) ofrece un índice web con búsqueda, sintaxis, opciones y ejemplos de todos los launchers y comandos, además de proyectos VLF, plugins LCP y el catálogo de documentación. -> Versión actual: **0.3.3**, canal estable. Consulta las -> [notas y limitaciones](docs/RELEASE-0.3.3.md). +> Versión de esta rama: **0.3.4-alpha.1**, GUI experimental, no estable. +> Consulta las [notas de prueba](docs/RELEASE-0.3.4-alpha.1.md). > Conserva copias de seguridad; no utilices el programa como única fuente de inventario. ### Cambios de 0.3.3 @@ -414,11 +421,11 @@ plan sin ejecutar). Consulta [repositoryTerminal](repositoryTerminal/README.md) para requisitos y ejemplos. No cambia la versión ni realiza Git/push. ```powershell -.\scripts\build-windows.ps1 -Version 0.3.3 +.\scripts\build-windows.ps1 -Version 0.3.4-alpha.1 ``` ```sh -./scripts/build-linux.sh 0.3.3 +./scripts/build-linux.sh 0.3.4-alpha.1 ``` Los builds generan metadatos, `SHA256SUMS.txt` y verifican el conjunto final. @@ -474,3 +481,7 @@ archivos de documentación. Si LANCTL te resulta útil, puedes seguir y apoyar su desarrollo en [CctrGy Donations](https://cctrgy.github.io/donations.html). + +Configuración CLI completa, agrupada por programa y proyecto: [guía de ajustes](docs/CLI-SETTINGS.md). + +Interfaces gráficas de LANWIRE, LANRACK, LANACCESS y LANMON: [uso y funciones](docs/LAUNCHER-GUI.md). diff --git a/assets/launcher-icons/lanaccess.ico b/assets/launcher-icons/lanaccess.ico new file mode 100644 index 0000000..59a883b Binary files /dev/null and b/assets/launcher-icons/lanaccess.ico differ diff --git a/assets/launcher-icons/lanaccess.png b/assets/launcher-icons/lanaccess.png new file mode 100644 index 0000000..29caae7 Binary files /dev/null and b/assets/launcher-icons/lanaccess.png differ diff --git a/assets/launcher-icons/lanaccess.svg b/assets/launcher-icons/lanaccess.svg new file mode 100644 index 0000000..bd01bc9 --- /dev/null +++ b/assets/launcher-icons/lanaccess.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/assets/launcher-icons/lanctl.ico b/assets/launcher-icons/lanctl.ico new file mode 100644 index 0000000..8bf1768 Binary files /dev/null and b/assets/launcher-icons/lanctl.ico differ diff --git a/assets/launcher-icons/lanctl.png b/assets/launcher-icons/lanctl.png new file mode 100644 index 0000000..09b8378 Binary files /dev/null and b/assets/launcher-icons/lanctl.png differ diff --git a/assets/launcher-icons/lanctl.svg b/assets/launcher-icons/lanctl.svg new file mode 100644 index 0000000..7855ebe --- /dev/null +++ b/assets/launcher-icons/lanctl.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/assets/launcher-icons/lanip.ico b/assets/launcher-icons/lanip.ico new file mode 100644 index 0000000..9532398 Binary files /dev/null and b/assets/launcher-icons/lanip.ico differ diff --git a/assets/launcher-icons/lanip.png b/assets/launcher-icons/lanip.png new file mode 100644 index 0000000..7ccb1f1 Binary files /dev/null and b/assets/launcher-icons/lanip.png differ diff --git a/assets/launcher-icons/lanip.svg b/assets/launcher-icons/lanip.svg new file mode 100644 index 0000000..7b1eb68 --- /dev/null +++ b/assets/launcher-icons/lanip.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/assets/launcher-icons/lanmon.ico b/assets/launcher-icons/lanmon.ico new file mode 100644 index 0000000..1ba80f9 Binary files /dev/null and b/assets/launcher-icons/lanmon.ico differ diff --git a/assets/launcher-icons/lanmon.png b/assets/launcher-icons/lanmon.png new file mode 100644 index 0000000..6b56b14 Binary files /dev/null and b/assets/launcher-icons/lanmon.png differ diff --git a/assets/launcher-icons/lanmon.svg b/assets/launcher-icons/lanmon.svg new file mode 100644 index 0000000..2fb6fe9 --- /dev/null +++ b/assets/launcher-icons/lanmon.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/assets/launcher-icons/lanrack.ico b/assets/launcher-icons/lanrack.ico new file mode 100644 index 0000000..463114d Binary files /dev/null and b/assets/launcher-icons/lanrack.ico differ diff --git a/assets/launcher-icons/lanrack.png b/assets/launcher-icons/lanrack.png new file mode 100644 index 0000000..703a8b8 Binary files /dev/null and b/assets/launcher-icons/lanrack.png differ diff --git a/assets/launcher-icons/lanrack.svg b/assets/launcher-icons/lanrack.svg new file mode 100644 index 0000000..e4526bf --- /dev/null +++ b/assets/launcher-icons/lanrack.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/assets/launcher-icons/lanwire.ico b/assets/launcher-icons/lanwire.ico new file mode 100644 index 0000000..71d0234 Binary files /dev/null and b/assets/launcher-icons/lanwire.ico differ diff --git a/assets/launcher-icons/lanwire.png b/assets/launcher-icons/lanwire.png new file mode 100644 index 0000000..7737d74 Binary files /dev/null and b/assets/launcher-icons/lanwire.png differ diff --git a/assets/launcher-icons/lanwire.svg b/assets/launcher-icons/lanwire.svg new file mode 100644 index 0000000..526bd89 --- /dev/null +++ b/assets/launcher-icons/lanwire.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/assets/launcher-icons/terminal.ico b/assets/launcher-icons/terminal.ico new file mode 100644 index 0000000..9a9156b Binary files /dev/null and b/assets/launcher-icons/terminal.ico differ diff --git a/assets/launcher-icons/terminal.png b/assets/launcher-icons/terminal.png new file mode 100644 index 0000000..3f734b8 Binary files /dev/null and b/assets/launcher-icons/terminal.png differ diff --git a/assets/launcher-icons/terminal.svg b/assets/launcher-icons/terminal.svg new file mode 100644 index 0000000..439f2d4 --- /dev/null +++ b/assets/launcher-icons/terminal.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/docs/ACCESS.md b/docs/ACCESS.md index 7cf98c0..c4494b1 100644 --- a/docs/ACCESS.md +++ b/docs/ACCESS.md @@ -39,6 +39,26 @@ un canal confiable. `access status` distingue configuración habilitada de proceso realmente activo. La recuperación se ejecuta localmente y no existen cuentas o contraseñas predeterminadas. +## Cuenta inicial desde el instalador de Windows + +Setup ofrece **Crear la primera cuenta de acceso remoto del servicio**. Después +de copiar los ejecutables y proteger el directorio de acceso, abre el asistente +`lanaccess remote-setup` con los privilegios de la instalación. Solicita usuario, +contraseña (al menos 12 caracteres) y confirmación directamente en su ventana. +No recibe contraseñas por línea de comandos ni las guarda en archivos temporales. + +La cuenta tiene el rol `administrator` de LANACCESS y pertenece al ámbito +`service`, en `ProgramData\LANCTL\access\users.dc`; no crea usuarios de Windows +ni credenciales para dispositivos del inventario. El almacén conserva únicamente +el hash Scrypt. Si ya existen cuentas, las conserva y bloquea una nueva creación +inicial; para administrarlas usa los comandos `access user` con `--scope service`. +Las rutas personalizadas requieren esa administración existente, sin sobrescribir +su configuración desde este asistente. + +Crear la cuenta no habilita SSH/HTTPS ni modifica el firewall. Configura después +los endpoints y autenticadores necesarios siguiendo los pasos anteriores. Es +posible omitir o cerrar el asistente; una instalación silenciosa no lo abre. + ## Remote Access desde SETTINGS La pestaña `REMOTE ACCESS` de F12 reúne la IP de escucha, CIDR autorizado, diff --git a/docs/BACKLOG-VERIFICATION.md b/docs/BACKLOG-VERIFICATION.md new file mode 100644 index 0000000..2a053db --- /dev/null +++ b/docs/BACKLOG-VERIFICATION.md @@ -0,0 +1,1185 @@ +# Comprobación del backlog — 15/10/2026 + +Evidencia de los 33 puntos de [BACKLOG.md](BACKLOG.md), sobre la versión de +desarrollo 0.3.3. «Verificado» identifica el alcance local indicado, con datos de +prueba aislados. No implica certificación de instalaciones ni plataformas no +ejecutadas. Los cambios permanecen en la rama de trabajo, sin publicación. + +## Resultado por punto + +| Punto | Resultado y alcance comprobado | Evidencia reproducible | +| --- | --- | --- | +| P01 | Corregido: Ctrl+S guarda SETTINGS y formularios de proyectos; POSIX desactiva IXON/IXOFF y restaura el TTY al salir. | `test_backlog_projects.py`, `test_tui.py` | +| P02 | Verificado: detección de cambios, escritura atómica, bloqueo, error de disco, recarga y conservación semántica del inventario. | `test_project_save_policy.py`, `test_file_transaction.py`, `gui_native_smoke.py` | +| P03 | Verificado: guardado activo/sin proyecto, atajo reasignado en gestores y con escaneo activo; los formularios guardan sus propios datos. Los modales de acceso/cierre conservan sus acciones locales. | `test_backlog_projects.py`, `test_tui.py` | +| P04 | Verificado: descubrimiento, paquetes, dependencias, permisos, activación, revocación y error; esquema de configuración inválido no oculta todos los plugins. | `test_plugins.py`, `test_backlog_plugins.py`, `test_suite_gui.py` | +| P05 | Corregido el flujo GUI de confianza: distingue falta de firma y falta de autorización del editor. Un LCP firmado coincidente puede autorizarse; cancelar, otra versión o paquete sin firma no concede confianza. | `test_backlog_plugins.py`, `test_suite_browser.py` | +| P06 | Corregido: Configurar depende de campos disponibles, incluidos valores por defecto sin archivo guardado; se recalcula al cargar el catálogo. | `test_backlog_plugins.py`, `test_suite_browser.py` | +| P07 | Verificado: guardado manual del proyecto activo. Editar otro proyecto modifica sus metadatos directamente, sin copiarle el inventario activo. | `test_tui.py`, `test_project_save_policy.py`, `gui_native_smoke.py` | +| P08 | Implementados los siete campos: nombre, descripción, autor, LAN, ubicación, empresa y responsable. Se mantienen UUID, inventario y hashes válidos. | `test_backlog_projects.py`, `test_settings_catalog.py` | +| P09 | Formularios TUI/GUI de creación y edición; vista compacta y desplazamiento hasta el campo seleccionado. | `test_tui.py`, `test_backlog_projects.py`, `test_suite_browser.py` | +| P10 | Validación antes de escribir; cancelación de cambios requiere confirmación. Una revisión obsoleta o un fallo de disco conserva el VLF anterior. | `test_backlog_projects.py`, `test_suite_browser.py` | +| P11 | Catálogo e información se recargan tras operaciones; la edición de un proyecto no activo notifica al proyecto correcto sin cambiar las sesiones. | `test_project_catalog.py`, `test_backlog_projects.py`, `test_tui.py` | +| P12 | Preferencia persistente CLI/TUI/GUI sin argumentos y prioridad de argumentos explícitos. Probada selección en código y ejecutables; GUI nativa sin argumentos. CLI/TUI empaquetados probados con entrada redirigida, no con clic manual en Explorer. | `test_backlog_startup.py`, `gui_coordination_smoke.py`, `portable_smoke.py` | +| P13 | Cierre opcional de LANCTL solo tras confirmar disponibilidad del launcher. Fallo conserva ventana; prueba nativa confirma que el hijo sobrevive al padre. | `test_backlog_startup.py`, `gui_coordination_smoke.py` | +| P14 | Exclusión real entre procesos, recuperación después de terminar el propietario, restauración y primer plano en Windows. Aperturas simultáneas del ejecutable portable dejan una sola GUI. | `test_backlog_startup.py`, `gui_coordination_smoke.py`, `portable_smoke.py` | +| P15 | LANCTL/LANIP simultáneos, feedback de apertura/cierre, eventos dirigidos al proyecto correcto y aislamiento entre proyectos. Las demás aplicaciones tienen coordinación CLI/TUI, no una GUI nueva. | `test_coordination.py`, `test_backlog_projects.py`, ambos smokes de coordinación/portable | +| P16 | Flecha independiente → con fondo de tecla en Plugins. | `test_tui_render.py::RichTuiRendererTests::test_plugin_footer_styles_standalone_arrow_as_keycap` | +| P17 | Estilo común de flechas, funciones, Supr, Enter, Esc, Ctrl y Shift+Tab; pies actualizados para guardar y editar proyectos. | `test_tui_render.py`, `controllers.py`, `managers.py` | +| P18 | Conflictos y teclas reservadas rechazados sin escritura; None desactiva, reasignar el valor inicial persiste; Esc restaura la edición del campo. | `test_backlog_projects.py`, `test_settings.py`, `test_tui.py` | +| P19 | Visibilidad del botón y asignación del atajo se verifican por separado; ocultar no desactiva. | `test_settings.py`, `test_tui.py` | +| P20 | Atajos del gestor consumidos dentro del modal; crear/editar no se despachan como acciones de inventario. | `test_tui.py`, `test_backlog_projects.py` | +| P21 | Inicio/cancelación/fallo/final de escaneo, guardado con/sin cambios, recarga y errores recuperables quedan visibles. | `test_tui.py`, `test_backlog_projects.py` | +| P22 | Mensaje final junto al prompt; selección anterior de salida se limpia. Errores nuevos conservan origen y catálogo. | `test_tui.py`, `test_error_catalog.py`, `test_errors.py` | +| P23 | Salida retenida: 2.000 líneas; historial: 500 comandos. Ajuste al ancho y navegación de salida/historial verificados. | `test_backlog_projects.py`, `test_tui.py`, `test_tui_components.py` | +| P24 | Revisados componentes compartidos de overlays: bordes, pestaña seleccionada, separación, ancho Unicode y fondos. Es verificación automatizada del renderizador; no una revisión física de todas las terminales. | `test_tui_render.py`, `test_tui_components.py` | +| P25 | Tamaños 40×12, 80×24, 160×50 y 240×70; el formulario mantiene visible su último campo. | `test_backlog_projects.py`, `test_tui_components.py` | +| P26 | Cobertura del rectángulo modal, captura de fondo y limpieza al redimensionar; no se borra toda la pantalla en cada frame. El parpadeo perceptible depende del terminal. | `test_tui_render.py`, `test_tui_components.py` | +| P27 | Selección, edición activa, asterisco de cambios y controles deshabilitados usan los estilos comunes; confirmación antes de descartar. | `test_tui_components.py`, `test_backlog_projects.py`, `test_suite_browser.py` | +| P28 | Validada la corrección de interfaz que ya estaba en curso: listas de 50 elementos, búsqueda, scroll y barra accesible en 790×570, 660×460 y 375×650. | `test_suite_browser.py::test_suite_footer_stays_visible_when_lists_scroll` | +| P29 | Procesos simultáneos, exclusión de archivo, escrituras atómicas, instantáneas obsoletas y contexto de sesiones. | `test_file_transaction.py`, `test_coordination.py`, `test_audit_regressions.py`, `test_backlog_projects.py` | +| P30 | No se solapan escaneos; cancelación, recuperación tras fallo, cierre de CLI integrado y liberación del bloqueo GUI después de una caída. | `test_tui.py`, `test_suite_gui.py`, `test_backlog_startup.py`, smokes nativos | +| P31 | Catálogo regenerado, orígenes conservados, contratos de eventos/funciones sin renombrar y comunicación por proyecto. | `test_error_catalog.py`, `test_errors.py`, `test_plugins.py`, `test_coordination.py` | +| P32 | **Parcial**: Windows desde fuentes y seis ejecutables portable comprobados. Pendientes Windows instalado limpio, Linux ARM64 y sesión SSH real desde otro equipo. | Comandos abajo; `.github/workflows/release.yml` contiene la matriz de distribución | +| P33 | Hallazgos, reproducción, gravedad, correcciones y límites registrados en este documento. | Tabla siguiente | + +## Hallazgos corregidos + +| Gravedad | Reproducción / problema | Impacto y aceptación | +| --- | --- | --- | +| Alta | Editar metadatos desde dos ventanas y guardar la antigua después. | Evita pérdida silenciosa: revisión optimista rechaza el segundo guardado y conserva inventario/UUID. | +| Alta | Abrir simultáneamente dos GUI del mismo launcher. | Evita duplicados y estados divergentes: bloqueo de vida del proceso, foco de instancia existente y recuperación tras caída. | +| Media | Ctrl+S en SETTINGS o en formulario de proyecto; terminal POSIX con IXON. | Antes no confirmaba el formulario o podía pausar la salida. Guarda el destino local y conserva/restaura los atributos TTY. | +| Media | Seleccionar y editar proyecto B desde una sesión cuyo activo es A. | Los observadores de B no recibían el aviso. Ahora se publica sobre B y A conserva su contexto. | +| Media | Activar WOL sin firma marcando todos los permisos. | La GUI explicaba el fallo demasiado tarde y remitía solo al CLI. Distingue firma/confianza y ofrece autorización verificable de un LCP firmado. | +| Media | Cancelar/cerrar un formulario GUI/TUI con cambios. | Evita perder la edición sin una decisión explícita. | +| Media | Cambiar continuamente de comandos con salidas grandes. | Retención acotada de historial y salida; conserva las entradas más recientes. | +| Baja | Plugin sin campos que ofrece Configurar. | Elimina paneles vacíos sin ocultar ajustes predeterminados disponibles. | +| Baja | Redimensionar un formulario largo o mostrar categorías con texto mal codificado. | Campo seleccionado visible, filas ajustadas al ancho y etiquetas corregidas. | + +## Contratos y alcance + +- Se conservan IDs públicos de cuatro segmentos, contratos de eventos y funciones, + formatos VLF/LCP y rutas de importación. No se mueve ni renombra un contrato. +- `startup` es una ampliación aditiva del esquema de configuración. Los archivos + previos mantienen CLI y ventana principal abierta. Se conservan aliases planos + para consumidores existentes. +- `DesktopApi.create_project` conserva sus argumentos anteriores; los metadatos + son un argumento opcional. La edición usa un servicio común para TUI/GUI. +- La cola de coordinación mantiene versión 1, propietarios y acciones permitidas; + `view gui` se admite también para la GUI raíz. No se habilita ejecución de shell. +- La validación de editores, firmas y permisos no se relaja. Para activar el WOL + distribuido sin firma aún hace falta publicar/obtener un LCP firmado por su editor. + +## Ejecución reproducible + +Resultado de la suite completa, incluidas GUI legacy y pruebas de navegador: +**964 pruebas y 643 subpruebas aprobadas; 1 prueba POSIX omitida en Windows**. +Cobertura combinada de líneas/ramas: **67,55 %**, superior al mínimo del 60 %. +Ruff, formato, Bandit (perfil de release), catálogos, referencias, higiene y +comprobación de espacios de Git pasan. Los smokes nativos de Windows también +confirman restauración/primer plano y supervivencia del launcher al cerrar LANCTL. + +En Windows, desde el entorno `.venv` del proyecto: + +```powershell +$env:LANCTL_GUI_BROWSER_TESTS='1' +python -m coverage run --branch --source=src -m pytest -m 'legacy_gui or not legacy_gui' -q +python -m coverage report --precision=2 --fail-under=60 +python tests/gui_native_smoke.py +python tests/gui_coordination_smoke.py +python tests/portable_smoke.py RUTA_BUILD_AISLADO +python -m ruff check . +python -m ruff format --check . +python -m bandit -q -r src -ll -s B104 +python tools/generate_error_catalog.py --check +python tools/generate_cli_reference.py --check +python tools/generate_web_reference.py --check +python tools/check_repository_hygiene.py +git diff --check +``` + +El smoke portable utiliza el marcador portable y datos exclusivos de su build. +Prueba los seis launchers, preferencia sin argumentos, prioridad de `--cli`, +dos aperturas simultáneas, restauración y cierre independiente. No instala el +programa ni publica los ejecutables generados. + +La prueba de IPC parcialmente recibido es específica de pipes POSIX y se omite +en Windows; debe ejecutarse en Linux. La suite de acceso remoto cubre validación, +autorización y encaminamiento, pero no sustituye conectar por SSH desde otra +máquina ni verificar un instalador con servicios y permisos reales. + +## Pendientes externos concretos + +1. Windows limpio: instalar, actualizar y desinstalar Setup; repetir el arranque + con doble clic en Explorer y terminal interactiva para CLI/TUI/GUI. No se + altera la instalación del usuario para simular una máquina de pruebas. +2. Linux ARM64: suite completa, prueba POSIX omitida aquí, paquete y terminal + real. Este equipo no tiene una distribución WSL instalada ni un runner ARM64. +3. Acceso remoto: sesión SSH real, persistencia/cancelación y desconexión desde + otro equipo autorizado; aquí solo se verifican sus regresiones locales. +4. Distribución de WOL: obtener/publicar el LCP firmado y su huella de editor; + el arreglo de interfaz no convierte el paquete sin firma en uno autorizado. + +## Revisión de backend de plugins — 16/10/2026 (P34, P40/P42) + +Alcance de AUDITOR: `core/plugins/manager.py`, `package.py`, `publishers.py`, +regresiones nuevas en `tests/test_plugin_security_review.py` y documentación. +GUI-DESIGN conserva las ventanas, formularios, diálogos, estilos y empaquetado. +Las correcciones se realizan en la rama de trabajo existente, sin modificar +los paquetes instalados ni conceder permisos o confianza en los datos del usuario. + +### Hallazgos reproducidos y correcciones + +Antes de corregir se ejecutaron 20 casos nuevos: los 20 fallaron y reprodujeron +los problemas descritos. Se amplió después la cobertura a concurrencia, +dependencias, reinstalación y recuperación. + +| Gravedad | Problema confirmado | Corrección y efecto futuro | +| --- | --- | --- | +| Alta | `verify ID` devolvía válido sin leer los archivos; activar/recargar podía ejecutar código modificado después del descubrimiento. | Verificación del directorio, checksum y firma antes de publicar la instalación y antes de cargar código o extensiones. El contenido alterado queda bloqueado. | +| Alta | La firma se recuperaba del texto guardado en el registro; borrar o alterar `meta/signature` no invalidaba esa confianza. Los paquetes preinstalados firmados podían aparecer como `UNSIGNED`. | Verificación criptográfica Ed25519 de los bytes instalados y cotejo con la identidad previamente registrada. Descubrimiento recupera la firma real sin autorizar al editor automáticamente. | +| Alta | El arranque omitía permisos, compatibilidad y dependencias; una activación fallida podía dejar el runtime anterior funcionando. | Mismas precondiciones al activar y restaurar; descarga de módulos, procesos y registros al fallar. | +| Alta | Dos gestores podían sobrescribir cambios ajenos y restaurar permisos revocados. Autorizar un editor concurrentemente también podía deshacer una revocación. | Bloqueo de lectura/modificación/escritura, actualización por plugin y rechazo de revisiones antiguas antes de reemplazar o activar; transacción completa del almacén de editores. | +| Media | El orden de arranque dependía del nombre visible y se ignoraban versiones de dependencias. | Orden por dependencias, restricciones de versión, rechazo de ciclos y fallos; descarga de consumidores locales al desactivar su dependencia. | +| Media | Repetir activación, descubrir de nuevo o reinstalar perdía referencias al runtime anterior. | Activación idempotente y limpieza antes de redescubrir/reemplazar. | +| Alta | Un fallo de disco al persistir la activación dejaba el código cargado aunque la operación devolviese error. | Tanto activación manual como arranque descargan sus runtimes si no pueden guardar el estado; el registro anterior permanece intacto. | +| Media | El motivo de bloqueo no siempre persistía; la cuarentena desaparecía del catálogo tras otro reinicio. | Motivo de fallo persistente y conservación de la cuarentena visible, sin que su historial haga reaparecer plugins desinstalados. | +| Media | Registros corruptos se interpretaban como vacíos o causaban excepciones de estructura sin contexto. | Validación de esquema y tipos; error contextual sin sobrescribir el documento dañado. | + +### Estado observado y límites + +Lectura de los paquetes incluidos y del registro local de desarrollo: MAC +Vendor, mDNS/SSDP, Windows SMB y WOL usan `trusted`, carecen de firma y figuran +desactivados. El tema y Network Summary Example figuran activados y usan +`isolated`; el emulador de red también es `isolated` y figura desactivado. +Esta lectura no certifica el estado de otro directorio de datos o instalación. + +El bloqueo de mDNS/SSDP y WOL mostrado en las capturas es correcto para los LCP +actuales. Las pruebas positivas firman paquetes con claves efímeras en carpetas +temporales, autorizan explícitamente al editor de prueba y verifican activación +y revocación. No sustituyen la entrega de paquetes firmados por el editor real. + +P34 sigue parcial: falta notificar y aplicar inmediatamente las revocaciones +en otros procesos ya activos y actualizar sus vistas. La protección añadida +evita sobrescribir el estado nuevo y bloquea operaciones posteriores con copias +antiguas; no detiene por sí sola código `trusted` que ya esté ejecutándose en +otro proceso. La publicación de LCP oficiales y las plataformas de P32 siguen +pendientes. P40/P42 describen la misma incidencia, con alcance técnico y visual. + +Se conservan métodos públicos, valores de `PluginState`, esquemas de registro 1, +formatos LCP/VLF e IDs de eventos/funciones del Core. La salida de `verify ID` +añade checksum y firma comprobados a sus campos anteriores. Las entradas de +dependencias existentes con `*` siguen siendo válidas. Un registro corrupto +ahora exige reparación explícita en lugar de activar valores por defecto. + +### Validación de esta revisión + +Suite completa final, incluidas GUI legacy y pruebas de navegador: +**1.013 pruebas y 643 subpruebas aprobadas; 1 prueba POSIX omitida en Windows**, +en 113,72 segundos. Cobertura combinada: **67,83 %**, por encima del mínimo +del 60 %. Las fuentes comprobadas no cambiaron durante la ejecución. +Los resultados del 15/10/2026 de la sección anterior son históricos. + +Comparación con HEAD: conservadas las **28 firmas públicas/estructuras** de +los tres módulos modificados y el catálogo de eventos del Core. Los comandos +reproducibles de suite/cobertura son los indicados en la sección anterior; +las regresiones específicas se ejecutan con: + +```text +python -m pytest tests/test_plugin_security_review.py -q +``` + +Las **43 regresiones nuevas** pasan. Bandit con el perfil de release, Ruff lint, +referencias CLI/web, catálogo de errores (1.237 puntos) e higiene pasan. El +formato de los cuatro archivos Python de esta revisión también pasa. + +El formato global aún señala cinco archivos del trabajo paralelo de GUI-DESIGN: +`src/lanctl/apps/ip/interfaces/gui/desktop.py`, `src/lanctl/apps/suite/gui.py`, +`src/lanctl/core/session.py`, `tests/test_distribution.py` y +`tests/test_suite_browser.py`. AUDITOR no los modifica para evitar solaparse. +Queda pendiente ese ajuste antes de integrar. Los binarios/instaladores generados +en paralelo tampoco se consideran certificados por estas pruebas de fuentes; +deberán incorporar las correcciones finales del backend y validarse después. + +## GUI: comprobación local del 16/10/2026 + +- P36/P41: `test_project_defaults_do_not_require_a_folder_picker` y navegador + comprueban carpeta predeterminada editable y LAN inicial sin selector obligatorio. +- P37/P39: `test_home_terminal_and_project_defaults_fit_client_area` comprueba + Inicio sin scroll y salida de terminal desplazable con entrada visible a + 790×570, 660×460 y 1440×900. +- P38: `test_complete_settings_catalog_and_edit_use_shared_validation` compara + el catálogo completo y comprueba guardado y rechazo de un valor inválido. +- Confirmaciones: `test_project_edit_form_discard_confirmation_and_preserved_revision` + comprueba el diálogo de aplicación y la conservación de cambios al cancelar. +- Plugins GUI: `test_signed_plugin_replacement_checks_identity_and_signature` + verifica ID/firma antes de instalar y que no se concede confianza implícita. +- Smoke nativo local: LANCTL verifica catálogo, valores iniciales, icono HICON + y cierre; LANIP verifica crear/editar/grupos/guardar/cambiar/restaurar/cerrar. +- Pasada completa local: 961 pruebas, 643 subtests; seis omitidas y 21 excluidas. + Las pruebas de navegador se ejecutaron por separado con su opción habilitada. + +Estas verificaciones no certifican Linux ni una instalación limpia de Windows. +La auditoría de distribución de firmas de plugins se mantiene en AUDITOR. + +## P43: carga de iconos en Windows — 16/10/2026 + +Causa reproducida: `run_gui()` de LANCTL y LANIP entregaba respectivamente +`lanctl.png` y `lanip.png` a `webview.start`. El backend WinForms de pywebview +invoca `System.Drawing.Icon` sin convertir la imagen. Ambos PNG generan la +misma `ArgumentException` de la traza original; los ICO incluidos cargan como +iconos nativos de 32×32. La selección del recurso queda centralizada en +`apps/suite/window_style.py`: ICO en Windows, PNG en las otras plataformas. +No se modifica la dependencia instalada ni se oculta la excepción con un +manejador genérico. No cambian imágenes, estilos, parsers ni contratos del Core. + +`tests/test_gui_window_icons.py` ejecuta los dos puntos de entrada con WebView +simulado, comprueba plataforma y contenido del recurso, y repite con una ruta +de extracción PyInstaller con espacios. Cuatro casos adicionales usan el +constructor real de .NET en Windows y liberan sus recursos. Resultado antes +de corregir: ocho fallos y ocho aprobados; después: **16 aprobados**. Con las +pruebas relacionadas de GUI y distribución: **69 aprobados**. + +GUI-DESIGN comenzó otros cambios durante esta revisión. Para verificar P43 sin +incorporar trabajo incompleto, se exportó `a6fadc8e88cd0ac3fcd41e882cec57ff74c489b2` +y se aplicaron únicamente los tres módulos de la corrección y su nueva prueba. +Sobre esa copia se ejecutó la suite completa, incluidas GUI legacy y navegador: +**1.029 pruebas y 643 subpruebas aprobadas, una omisión POSIX, 90,94 segundos**. +Comparación AST: conservadas las **101 firmas de funciones y métodos existentes** +de esos tres módulos. Ruff, catálogo de errores (1.237 puntos) y referencias +CLI/web de esa copia pasan. El árbol compartido no se considera certificado +por este resultado: una ejecución anterior coincidió con cambios de GUI-DESIGN +y falló en tres pruebas de sus parsers, distribución y apertura de launchers. + +Se compilaron los seis ejecutables desde la copia aislada en `dist/p43-verified`. +Los seis responden correctamente a `--version`. LANCTL y LANIP abren ventanas +nativas con HICON desde fuentes y desde esos ejecutables, sin la excepción de +P43. Se generó `dist/p43-verified/LANCTL-0.3.3-p43-setup.exe`; no se ejecutó el +instalador ni se modificó la instalación del usuario. Los resultados y scripts +de diagnóstico locales están en `.tool-reports/p43/`, incluido +`full-suite-verified.xml`, `snapshot.json` y `contracts.json`. + +Límite descubierto en la comprobación nativa: con datos nuevos el registro de +plugins contiene `{}` y el validador lo rechaza. Esto impide el bootstrap de +LANIP, incluso después de corregir el icono; queda registrado como **P44**. +La prueba empaquetada de P43 se repite con un registro de prueba explícitamente +válido (`schemaVersion: 1`, `plugins: {}`). No constituye una validación de +instalación limpia ni resuelve P44. No se alteraron datos reales del usuario. + +Comprobación final del adaptador especializado añadido durante el trabajo de +GUI-DESIGN: `suite/launcher_gui.py` repetía el PNG incompatible. Se modificaron +solo la importación del selector y el argumento `icon` de `webview.start`. +Ocho casos nuevos invocan ese punto de entrada con LANWIRE, LANRACK, LANACCESS +y LANMON y cargan el recurso resultante con .NET, desde fuentes y rutas de +extracción. Los ocho reproducen la excepción antes del ajuste y pasan después: +**24 regresiones P43 aprobadas** en el árbol compartido. Esta comprobación no +certifica las nuevas interfaces completas de GUI-DESIGN ni las incorpora al +instalador aislado descrito arriba. La última prueba de los ejecutables aislados +también verifica el cierre normal de LANCTL y LANIP una vez termina su bootstrap. + +## Integración de la plantilla de plugins — P44, 16/10/2026 + +GUI-DESIGN cambió únicamente el documento inicial de `data_migration.py` a +`{"schemaVersion": 1, "plugins": {}}`. AUDITOR verificó el cambio en una carpeta +temporal independiente: `ensure_data_layout()` genera exactamente ese esquema +y el constructor real de `PluginManager` completa el descubrimiento sin el +error del registro. No se cambian el gestor ni sus comprobaciones de permisos, +firmas o confianza de editores durante esta integración. + +También se comprobó el caso previo: con `registry.json` igual a `{}`, repetir +`ensure_data_layout()` conserva el archivo y el gestor sigue rechazándolo. +P44 permanece parcial hasta resolver explícitamente esa compatibilidad y +verificar el recorrido de arranque correspondiente. La compilación aislada +`dist/p43-verified` se generó antes del ajuste de la plantilla y no lo contiene. + +Validación relacionada: **50 pruebas y 17 subpruebas aprobadas** al ejecutar +`tests/test_data_migration.py` y `tests/test_plugin_security_review.py`. + +## Launchers con GUI real: verificación del 16/10/2026 + +- Suite completa: **1022 pruebas superadas**, 643 subtests; seis omitidas y 21 + excluidas. Navegador: seis pruebas adicionales con la opción habilitada. +- `tests/test_launcher_gui.py`: persistencia IDF, conexiones incompatibles y + ocupadas, revisión frente a ediciones antiguas, renombrado de puertos y + actualización de referencias; visor LANRACK; cifrado portable y enlace de + credenciales; métricas reales guardadas; contexto de proceso; modos directos + y enrutados; registro inicial de plugins con esquema válido. +- `tests/launcher_gui_native_smoke.py`: cuatro ventanas nativas, API real, + operaciones con datos temporales, contexto y cierre. +- `tests/launcher_suite_native_smoke.py`: los cuatro botones de LANCTL abren + simultáneamente sus aplicaciones, reciben IPC y cierran sin dejar sesiones. +- Los cuatro ejecutables compilados se han abierto con `--gui` en este Windows; + se han comprobado sus recursos frente a las fuentes, iconos HICON, IPC, + reconocimiento de `--gui` y cierre con código cero. +- Instalador local reconstruido en `dist/gui-current`, incluyendo accesos de + menú a las seis GUI. No se ha publicado una versión ni ejecutado la matriz de + instalación limpia/Linux/acceso remoto de P32. + +## LANWIRE GUI: lista y topología interactivas (16/10/2026) + +- Vistas independientes a pantalla completa; detalle por pestañas con JSON + copiable, edición validada, grupos del TUI y clasificación cable/Wi-Fi/mixta. +- Lienzo con zoom, desplazamiento, posiciones manuales, distribución por + componentes, enfoque por niveles, minimapa, navegación y enlaces por puerto. +- Filtros combinables, columnas configurables y redimensionables, selector de + proyecto VLF y configuración agrupada con etiquetas legibles. +- Almacén físico compartido explícito; fallo de apertura de proyecto conserva + el contexto. Las revisiones evitan sobrescribir ediciones concurrentes. +- Validación: suite general 1.027 passed, 8 skipped, 21 deselected; prueba de + navegador contra WireGuiService real (edición, filtros, puertos, desconexión, + JSON, doble clic y navegación); regresiones visuales de los otros launchers; + arranque/puente/cierre nativo de LANWIRE en Windows. Los datos usados son + temporales, sin modificar proyectos ni inventario del usuario. + +## P44: migración del registro vacío histórico — 16/10/2026 + +### Validación y planificación previas + +Se revisaron las reglas del proyecto, el estado del árbol compartido y todas +las tareas abiertas. El plan de objetivos, módulos/archivos, dependencias, +conflictos, riesgos e impacto está en «Orden de ejecución validado» del backlog. +P44 se adelantó por bloquear el arranque con datos antiguos; P40/P42 conservan +un seguimiento único. Los cambios visuales siguen asignados a GUI-DESIGN. + +La plantilla de datos nuevos ya estaba corregida por GUI-DESIGN. El problema +restante era `{}` persistido por versiones anteriores. `ensure_data_layout()` +se invoca desde LANIP, mientras otras entradas acceden directamente al gestor: +corregir solo ese inicializador no cubría todos los consumidores. Se eligió el +lector compartido y se reutilizó el lock reentrante y la escritura atómica +existentes. Riesgo estimado de la intervención: **Alto**, por afectar al registro +de autorizaciones. No se requirieron dependencias nuevas ni una refactorización +estructural adicional durante la implementación. + +### Cambio y efectos comprobados + +`PluginManager._read_registry()` reconoce únicamente el objeto JSON vacío +histórico y lo sustituye por `{"schemaVersion": 1, "plugins": {}}`. La lectura y +migración comparten el lock de los escritores. Un documento ya versionado se +conserva sin reescritura; datos corruptos, tipos incorrectos y esquemas +desconocidos mantienen su rechazo. La migración no recupera permisos, confianza +de editor ni estado activo. Un fallo de escritura conserva el documento original +y el origen `LANCTL.Plugin.Registry.Load` con la excepción causante. + +Archivos modificados en este ciclo: + +- `src/lanctl/core/plugins/manager.py`: migración acotada en el lector privado. +- `tests/test_plugin_registry_migration.py`: 18 casos de regresión nuevos. +- `errorList.txt`: regenerado sobre el árbol actual, con 1.285 puntos. +- `docs/BACKLOG.md`: planificación, prioridades, dependencias y cierre de P44. +- `docs/BACKLOG-VERIFICATION.md`: este informe y sus límites. + +`data_migration.py` se verificó sin volver a modificarlo. Los cambios previos de +GUI-DESIGN y los de P43 se conservaron; no se añadieron funcionalidades de GUI. + +### Verificación + +- Antes del cambio: **6 fallos y 12 aprobados** en las regresiones de P44. +- Después: **87 pruebas y 17 subpruebas aprobadas** entre migración del registro, + revisión de seguridad de plugins, migración de datos y pruebas de plugins. + Incluyen idempotencia, documentos inválidos intactos, error de disco con causa, + espera del escritor concurrente, conservación de su autorización y ausencia + de ejecución de un plugin `trusted` instalado sin permisos. +- Arranque LANIP con datos nuevos y antiguos en procesos aislados: API real de + bootstrap, sustituyendo únicamente la creación de la ventana en esas pruebas. +- Smoke nativo Windows adicional con registro `{}` y datos/secretos temporales: + puente real, crear proyecto, editar dispositivo, grupos, guardar, cambiar, + restaurar y cerrar correctamente. No se modifican datos del usuario. +- Suite completa con navegador y GUI legacy: **1.073 pruebas y 643 subpruebas + aprobadas; una prueba POSIX omitida en Windows**, en 130,95 segundos. Cobertura + de ramas combinada: **68,0842 %**, superior al umbral del 60 %. +- Los hashes de **418 archivos** de fuentes, pruebas, herramientas, recursos y + empaquetado coinciden antes/después de la suite: no hubo cambios concurrentes. +- Comparación AST con HEAD: se conservan las **37 firmas de funciones/métodos** + del gestor; el resto del módulo es idéntico salvo el cuerpo de `_read_registry`. + Por tanto se conservan registro de eventos y contratos públicos existentes. + También coinciden los **51 IDs y orígenes de error** del gestor, salvo líneas. +- Ruff lint global, Bandit con el perfil de release, referencias CLI/web, + catálogo, higiene y `git diff --check`: aprobados. Formato de los dos archivos + Python de P44: aprobado. + +Reproducción de la suite en PowerShell: + +```powershell +$env:LANCTL_GUI_BROWSER_TESTS='1' +$env:COVERAGE_FILE='.tool-reports/p44/.coverage' +python -m coverage run --branch --source=src -m pytest -m 'legacy_gui or not legacy_gui' -q --tb=short --junitxml .tool-reports/p44/full-suite.xml +python -m coverage report --precision=4 --fail-under=60 +``` + +Evidencia local: `.tool-reports/p44/full-suite.xml`, `full-suite.log`, +`coverage.xml`, `native-legacy.log`, `contracts.json`, `source-snapshot.json`, +`snapshot-check.json` y `format-check.json`. Son artefactos ignorados por Git. + +### Dependencias y trabajo pendiente + +**P44 queda completada en fuentes**, sustituyendo el estado parcial de la +sección anterior. Se pueden verificar P34/P32 con registros antiguos y queda +satisfecha la dependencia de arranque de P46/P47; sus otros requisitos siguen +vigentes. **La siguiente tarea es P34**, empezando por validar revocación entre +procesos, limpieza de consumidores, límites del runtime `trusted` y orden de +locks. No se implementó esa segunda tarea en este ciclo. + +El formato global sigue pendiente en seis archivos de cambios anteriores: +`src/lanctl/apps/access/manager_cli.py`, `src/lanctl/bootstrap/lanmon.py`, +`src/lanctl/core/data_migration.py`, `tests/launcher_gui_native_smoke.py`, +`tests/test_suite_browser.py` y `tests/test_suite_gui.py`. Debe corregirse antes +de integrar; no se alteraron esos archivos al resolver P44. + +Los instaladores ya existentes no incorporan esta migración; quedan su +reconstrucción y las comprobaciones externas de P32. Tampoco se cierra P40/P42: +la distribución de LCP oficiales firmados requiere la identidad y los paquetes +autorizados del editor. El resto de pendientes conserva su orden y responsable +en el backlog. No se cambió la versión del programa ni se publicó una entrega. + +## LANWIRE P55–P63 y CPD LANRACK P64–P65 — 17/10/2026 + +Implementadas las correcciones en fuentes manteniendo grafito y lima. LANWIRE +separa Interior de racks y Vista general, con contenedores por rack/CPD, filtros, +contexto de extremos externos y agrupación desplegable de enlaces paralelos. +La distribución determinista usa fuerzas de conexiones y separación de tarjetas; +solo los conjuntos sin enlaces se ordenan en cuadrícula. También considera los +enlaces salientes al organizar los equipos dentro de cada rack. Los puertos se +distribuyen por medio, ocupación y posición del destino, conservando sus nombres. +Los cables usan coordenadas DOM de sus puertos, etiquetas con fondo y guías, +abrevian con poco zoom y permiten consultar nombre, medio y extremos completos. +Pulsar un puerto del lienzo selecciona el equipo; conectar sigue siendo una acción +explícita de su ventana de datos. El doble clic desde Lista conserva el acceso +para centrarlo en Topología. + +LANRACK permite crear/editar CPD con nombre, descripción y ubicación, trasladar +racks y eliminar salas conservando los armarios sin asignación o en otra sala. +Incluye vistas de salas, lista y detalle de rack/equipo, búsqueda y filtro CPD. +La extensión aditiva `cpdOrganization` lleva `schemaVersion: 1` dentro del mismo +inventario IDF; `data.location.cpd` contiene la pertenencia única del rack. +No hay duplicación de inventarios ni cambio de identidad de equipos o cables. +Las bases anteriores se leen sin CPD y se extienden en la primera escritura. +Lectura coherente y escritura atómica usan el lock común del almacén; la revisión +del documento rechaza actualizaciones obsoletas. Corrupción o versiones +incompatibles se conservan y se notifican con su origen. + +### Comprobaciones de esta entrega + +- 22 pruebas dirigidas aprobadas con navegador Edge: servicios reales y dos + ventanas sobre la misma base temporal; creación de CPD desde LANRACK visible + en LANWIRE, traslado de racks, conservación de equipos/puertos/cables, + eliminación con y sin traslado, nombres duplicados con IDs distintos, + actualización obsoleta rechazada y documento inválido sin sobrescritura. +- Topología real con siete racks, ciclo y enlaces paralelos; prueba adicional + con 24 racks, tres CPD y 25 cables. Se comprueban recuentos, agrupación de + enlaces, salidas de filtros, ausencia de solapamientos, contención de racks, + anclaje de puertos tras zoom, 48 puertos sin scroll interno y ausencia de + errores JavaScript. Cabecera/pie y ancho comprobados también a 960×650. +- Arranque/cierre nativo de LANWIRE y LANRACK aprobados con puente real y datos + temporales, también tras el cambio de versión a 0.3.4-alpha.1. +- Ruff y formato de los archivos Python de este cambio, sintaxis JavaScript, + higiene, referencias CLI/web y catálogo de 1.300 puntos comprobados. + +La primera suite completa se cruzó con un cambio concurrente de versión: +1.074 pruebas aprobadas y dos fallos por comparar el 0.3.3 ya cargado con procesos +0.3.4-alpha.1 y con su referencia nueva. No se alteró la versión para ocultarlos; +se regeneraron las referencias y se repitió la suite con el árbol actualizado. +La reconstrucción y sus resultados finales se consignan a continuación. + +Evidencia local ignorada: `tmp/cpd-browser-last.log`, `tmp/cpd-full-current.log`, +`tmp/cpd-build-current.log`, `tmp/cpd-lanwire-general.png` y `tmp/cpd-lanrack.png`. +Los escenarios no escanean redes ni modifican inventarios del usuario. El trazado +busca legibilidad y no garantiza un óptimo matemático global. La agrupación física +sigue en `physicalDatabase`, compartida por las dos interfaces; no se añade una +copia del inventario dentro del VLF. + +Resultado de la repetición con versión coherente: **1.076 pruebas y 643 +subpruebas aprobadas; una prueba POSIX omitida en Windows**, en 143,84 segundos. +El escenario adicional de 24 racks se ejecutó después junto con las regresiones +dirigidas: **22 aprobadas**, en 43,54 segundos. No se cambió código de ejecución +después de esa comprobación. Las referencias y la higiene permanecen correctas. + +La comprobación de versiones de los ejecutables detectó que el empaquetado +incremental había retenido bytecode 0.3.3 en LANIP, aunque los recursos gráficos +ya coincidían. Esa entrega se descartó y se reconstruyó con caché limpia y +carpeta de trabajo nueva; se exige comprobar recursos y versión de los seis +binarios antes de considerar válida la entrega. + +Verificación dirigida final: **22 aprobadas en 32,00 segundos** después del +ajuste de conservación de contexto al cambiar el filtro CPD. La regresión +adicional de volver de un CPD a la vista global recuperando la cámara también +pasó (24 racks, 3,80 segundos). Registros: `tmp/cpd-browser-delivery.log` y +`tmp/cpd-navigation-final.log`. Se reconstruyen los recursos finales desde +`build/cpd-final-alpha`; no se usa el instalador incremental descartado. + +Entrega final verificada: los seis ejecutables contienen el servicio CPD, los +recursos gráficos idénticos a las fuentes finales y la versión 0.3.4-alpha.1. +LANWIRE, LANRACK, LANACCESS y LANMON compilados abren y cierran correctamente, +con ventana, icono, coordinación IPC y recursos válidos. El instalador local +`dist/gui-current/LANCTL-0.3.4-alpha.1-gui-setup.exe` se generó correctamente +(135.025.921 bytes). Evidencia: `tmp/cpd-frozen-resources.log`, +`tmp/cpd-frozen-windows.log`, `tmp/cpd-build-delivery.log` y +`tmp/cpd-installer-final.log`. No se instaló ni publicó automáticamente. +P55–P65 quedan completadas para esta entrega; las certificaciones externas de +P32 y las tareas de plugins ajenas a este cambio mantienen su estado propio. + +## P66: skins de equipos en LANRACK — 17/10/2026 + +Se añaden frentes SVG genéricos superpuestos a las unidades ocupadas: 30 +plantillas y ajustes personalizados, RJ45/SFP, montaje rack o bandeja, servidores, +SAI, paneles, routers y tapas. El editor ofrece vista previa y guarda únicamente +`data.rackAppearance` (`schemaVersion: 1`). Los conectores dibujados sin registro +son representaciones; la apariencia no crea puertos ni altera cables. El modo +automático usa tipo y puertos reales, sin inventar telemetría del SAI. Las +preferencias de visibilidad y tamaño de U también tienen esquema local versionado. + +Se comprueba que una skin 48 RJ45 + 4 SFP no cambia los 24 puertos originales del +equipo de prueba. Las alturas se validan contra los límites del rack y el espacio +ocupado; un servidor desde U5 de 2 U ocupa U5–U6. LANWIRE respeta esa ocupación al +trasladar equipos y reducir la altura del armario. Las filas libres y ocupadas +mantienen la misma altura por U; los frentes de varias U abarcan el espacio real. + +Validación: + +- Suite completa: **1.080 pruebas y 643 subpruebas aprobadas**, una prueba POSIX + omitida en Windows, en 144,74 segundos. +- 25 pruebas dirigidas de skins, CPD y launchers aprobadas. Regresión gráfica + final adicional: 3 aprobadas, incluyendo las 30 plantillas en vista previa, + guardar y volver a leer desde LANWIRE, vista simple/gráfica, altura por U y + tamaño ajustable con preferencias versionadas. Sin errores JavaScript. +- Guardado obsoleto, cantidades inválidas, altura fuera del armario y solapamiento + rechazados, preservando el inventario anterior. Acceso de escritura restringido + a LANRACK; se mantienen los servicios de inventario compartidos. +- Arranque y cierre nativo de LANRACK aprobados. Ruff/formato de Python, sintaxis + JavaScript, higiene y catálogo de **1.310 puntos** comprobados. + +Fuentes principales: `apps/rack/skins.py`, `rack/service.py`, +`suite/launcher_gui.py`, validación de ubicación en `wire/gui_service.py`, +`gui/rack-skins.js`, `gui/physical-gui.js`, HTML/CSS compartidos y +`tests/test_rack_skins.py`. No se modifican proyectos ni inventarios del usuario. +Evidencia local: `tmp/rack-skins-full.log`, `tmp/rack-skins-final-browser.log`, +`tmp/rack-skins-targeted.log`, `tmp/lanrack-skins.png` y logs de empaquetado. + +Empaquetado final de P66: los seis ejecutables tienen versión 0.3.4-alpha.1, +servicio de skins incluido y recursos HTML/CSS/JS idénticos a las fuentes. +LANWIRE, LANRACK, LANACCESS y LANMON compilados abren y cierran correctamente +con ventana, icono e IPC. El instalador actualizado +`dist/gui-current/LANCTL-0.3.4-alpha.1-gui-setup.exe` se generó con éxito +(135.076.670 bytes), sin instalarlo ni publicarlo automáticamente. Evidencia: +`tmp/rack-skins-frozen-resources.log`, `tmp/rack-skins-frozen-windows.log`, +`tmp/rack-skins-build.log`, `tmp/rack-skins-root-ip.log` y +`tmp/rack-skins-installer.log`. + +### Aclaración P66: puertos decorativos — 17/10/2026 + +Los puertos de las skins quedan explícitamente sin eventos de puntero, foco ni +acciones propias. No abren conexiones ni muestran respuestas individuales al +pasar el ratón. El acceso a los datos se conserva en la unidad completa del rack. +Las tres regresiones existentes de skins pasan con el cambio; no se añaden +pruebas que solo dupliquen las reglas CSS. No hay cambios de datos ni de contratos. +Las futuras ampliaciones mencionadas por el usuario quedan por concretar. + +El ajuste decorativo queda también incluido en los seis ejecutables y en el +instalador local actualizado. Recursos finales comprobados contra las fuentes, +versión 0.3.4-alpha.1 y compilación del Setup correctas. Evidencia: +`tmp/rack-skins-passive-build.log`, `tmp/rack-skins-passive-resources.log` y +`tmp/rack-skins-passive-installer.log`. No se instaló automáticamente. + +## Servicios, datos e instalación — AUDITOR, 17/10/2026 + +Se validaron dependencias antes de implementar y se comunicaron firmas y +payloads mediante `.tool-reports/gui-auditor-sync.json`. GUI-DESIGN conserva +los adaptadores y recursos visuales. AUDITOR no cambió rama ni versión +(`experimental-gui`, `0.3.4-alpha.1`), no publicó, no instaló y no ejecutó builds +ni la suite completa mientras la integración visual estaba en curso. + +### Cambios y archivos + +- **P54:** `core/official_links.py`, `bootstrap/lanctl.py`, Lua y referencias + generadas. Opciones `-web/-github/-reference` y alias largos; URL completa + legible en terminal y salida redirigida; únicamente destinos oficiales. +- **P35:** `core/gui_preferences.py`, `config.py`, `settings_catalog.py` y + función aditiva `active_theme_extensions` en `plugins/manager.py`. Presets + graphite/midnight/forest/violet/light; density, fontScale y reducedMotion. + La configuración canónica v2 guarda un bloque `gui` de esquema 1. Un plugin + de tema explícito añade solo sus tokens/componentes declarados; se informa + `effectivePlugin`, `pluginTokens` y `pluginComponents`. La paleta incluida + `lanctl.theme.default.palette` es base sustituible por el preset, pues + aplicarla como overlay anulaba las cinco elecciones. No se modifican las + preferencias guardadas al aplicar un plugin. Se corrigió el error de catálogo + `'gui' is not in list` registrando la categoría y el mismo validador. +- **P49:** `apps/monitor/log_tui.py`, `log_stream.py`, `bootstrap/lanmon.py`. + `lanmon logs --tui` y `open_log_window(tui=True)` usan el mismo lector + incremental. Pausa de vista sin perder el seguimiento, historial acotado, + navegación, filtro de texto y nivel. Lotes de hasta 1.000 líneas dejan los + bytes restantes en disco para la siguiente consulta; se conserva UTF-8 + parcial, rotación y el seguimiento de texto existente. +- **P53:** `core/activity.py`. Almacén SQLite versionado, máximo 10.000 + mensajes por propietario, validación del emisor contra la sesión viva y + filtros explícitos. `project=None` consulta todos los proyectos del usuario; + `project=''` solo mensajes sin proyecto. `latest=True` entrega los últimos + registros en orden ascendente; `after` permite seguimiento incremental. + Las filas sobreviven al cierre del emisor. No se relaja el canal de + coordinación de metadatos ni se reutilizan sus IDs públicos. +- **P52:** `core/diagnostics.py`, `apps/monitor/bug_reports.py`. Preparación + pura con evidencia seleccionada, límites, origen/código/versiones y errores + repetidos agrupados. Se filtran credenciales incluso al desactivar la + anonimización de identidad; esta última oculta rutas, IP, MAC y correos. + Exportación Markdown y URL de formulario, con nueva redacción tras editar + el borrador. Sin inventario completo ni publicación automática. La revisión + humana sigue siendo necesaria para datos privados no reconocibles por sus + claves o patrones; no se afirma una anonimización universal. +- **P51:** `core/updates.py`. Comparación SemVer y filtro por `draft=false`, + `prerelease=false` y publicación efectiva, incluso con sufijos históricos. + Se consulta un máximo acotado de páginas del repositorio oficial; reserva + diaria persistente antes de red, también en fallos o consultas simultáneas. + Recordatorio por versión y validación de enlaces incluso al leer caché. + El adaptador GUI debe usar worker. Se contrastaron los campos y paginación + con [GitHub REST](https://docs.github.com/en/rest/releases/releases#list-releases) + y la comparación con [SemVer](https://semver.org/). No se descarga ni instala. +- **P66 «Dimensiones»:** `core/rack_dimensions.py`, `apps/rack/service.py`, + `apps/rack/cli.py`, `apps/wire/gui_service.py`, `apps/wire/idf/database.py` + y `apps/wire/models/rack.py`. Enteros 4–52 U y anchos 10/19/21/23. Altura + canónica `data.units`, ancho en `data.rackDimensions` esquema 1. Las bases + antiguas conservan valores inválidos o desconocidos con advertencias; solo + una edición explícita los corrige, manteniendo alias heredados coherentes. + La transacción compartida impide reducir por debajo de los equipos y sus + frentes de varias U. LANRACK añade `dimensions ID --units U --width-inches W`. +- **P45/P46:** `core/installation.py`, `plugins/selection.py`, `builtin.py` y + `packaging/inno/LANCTL.iss`. `setup-defaults` guarda una vez la elección de + tema/plugins; una actualización conserva selección, configuración y registro + de permisos. Los plugins omitidos no reaparecen por bootstrap; el tema base + sigue obligatorio. El ejemplo incluido ya no reescribe manifiestos idénticos + en cada inicio. El instalador ofrece selección individual y cinco previews; + su compilación/certificación corresponde a la fase de integración. +- **P47, alcance seguro:** `core/first_scan.py`, entrada CLI LANIP, orquestador + e instalador. `post-install [--first-scan]` exige usuario normal, deja una + petición de confirmación antes de abrir LANIP y nunca inicia sondas. La + petición caduca tras 24 horas y se consume una vez. `scan_choices` no inventa + interfaces ni máscaras; el escáner usa las rutas del sistema. Falta enlazar + realmente una interfaz a todas las sondas: REF-P47-interface. +- **P48:** `core/clink_integration.py`, `packaging/clink/*`, instalador, + `packaging/portable/prepare.ps1`, README y `scripts/build-windows.ps1`. + Distribución del Lua y registro/retirada de una carpeta mediante argumentos + nativos. Instalación de registro con usuario normal; desinstalación elevada + solo busca binarios en Program Files consultado en HKLM, sin usar PATH de + usuario. Se conserva marcador por usuario/directorio. Clink registra rutas + en el perfil del usuario según su [documentación](https://chrisant996.github.io/clink/clink.html#command-line-options). + Inno no recupera siempre la identidad original y no admite ExecAsOriginalUser + al desinstalar, según [su contrato](https://jrsoftware.org/ishelp/topic_isxfunc_execasoriginaluser.htm). + Por ello otra cuenta administrativa no se presenta como limpieza completa + del registro del propietario; se documenta retirada manual previa. + +### Verificación de AUDITOR + +Resultado consolidado de 23 módulos de pruebas relacionados: **281 pruebas y +11 subpruebas aprobadas en 36,91 s**. Incluye regresiones de los diez archivos +nuevos `test_official_links`, `test_gui_preferences`, `test_activity`, +`test_log_tui`, `test_diagnostics`, `test_updates`, `test_rack_dimensions`, +`test_installation_preferences`, `test_first_scan`, `test_clink_integration`, +además de plugins, permisos/firmas, migración, configuración, coordinación, +IDF/modelos, launchers, distribución, Clink y errores existentes. + +Después de ajustar la fixture sintética de redacción para respetar la higiene +y cubrir la paleta base que anulaba presets: **20 pruebas adicionales pasan** +(preferencias/diagnósticos). No se modificó el detector de secretos. + +Evidencia local no versionada: +`.tool-reports/auditor-20261017/focused.log`, `focused.xml` y `contracts.json`. +La prueba de actividad ejecuta un proceso Python separado, escribe con una +sesión real, la cierra y comprueba recepción y conservación desde el padre. +Las pruebas de actualizaciones no consultan la red y las de Clink no alteran +el registro real del equipo. + +- Ruff global `check src tests`: correcto; formato de los 35 archivos Python + propios revisados: correcto. +- Bandit `-q -r src -ll`: sin hallazgos de nivel exigido; conserva dos avisos + previos de `nosec B104` sin incidencia coincidente. +- Referencias CLI/web actualizadas y comprobadas; catálogo de errores + regenerado y comprobado (**1.388 puntos** al cierre de AUDITOR). +- Higiene correcta y `git diff --check` sin errores; Git solo advierte sobre + normalización CRLF/LF de archivos compartidos. +- Comparación AST contra HEAD: **29 métodos existentes de PluginManager + idénticos**, además de preservar los archivos públicos de contratos, + eventos y funciones. Se añadieron interfaces/keywords compatibles; las + nuevas restricciones de dimensiones responden expresamente al requisito. + +### Dependencias abiertas y siguiente paso + +**Fuentes de AUDITOR listas para integración**; GUI-DESIGN ejecuta la suite +completa con cobertura, pruebas visuales/nativas, recursos y un único build. +No se atribuyen aquí resultados finales que aún no hayan terminado. + +P34 requiere REF-P34-runtime: el host no puede detener de forma segura hilos +arbitrarios de un plugin trusted ya cargado en su propio proceso. El diseño +previo a implementarlo debe introducir runtime cancelable propiedad del host, +RPC versionado, concesiones por revisión, validación antes de cada operación, +retirada de callbacks y cierre con plazo, sin mantener locks durante callbacks +externos. Implica cambios de arquitectura y compatibilidad, no una notificación +de GUI. P34 permanece crítica y abierta. + +P50 depende además de un contrato de snapshot vivo: enumeración por propietario, +selección explícita de sesión/proyecto, revisión solicitada/observada, estado +guardado frente a cambios en memoria y errores de sesión caducada o revisión +desfasada. El coordinador actual no ofrece ese snapshot y el VLF no lo sustituye. +El transporte/autenticación externos deben verificarse antes de exponerlo. El +preparador de P52 queda reutilizable sin introducir GitHub en ese futuro puente. + +P40/P42 requieren firmas e identidad reales autorizadas. P47 no certifica +selección de interfaz hasta REF-P47-interface. P48 requiere CMD/Clink real y +resolver/probar los escenarios de usuario administrador distinto. P32 conserva +la matriz externa Windows limpio/Linux ARM64/SSH. Estos puntos no se marcan +completados ni se rebaja su prioridad. +## Integración coordinada de pendientes GUI — 17/10/2026 + +GUI-DESIGN implementa la presentación y los adaptadores de escritorio; AUDITOR +entrega servicios, modelos, CLI/TUI e instalador. El reparto y las dependencias +se registran en `docs/GUI-AUDITOR-COORDINATION.md`. + +- P35: cinco temas, vista previa/cancelación, persistencia, sincronización entre + ventanas, densidad, escala de texto y reducción de animaciones. Los overrides + de plugins conservan el tema base y se retiran sus estilos de componente. +- P49/P53: botón Registros en LANIP para la TUI, actividad y registros en LANMON + con pausa, filtros y límites. Transporte con sesión/proyecto/origen reales; + se conserva el buffer local hasta transmitir y el historial tras cerrar la + sesión. Reloj retirado solo del pie de LANCTL. +- P51/P54: consulta de actualizaciones fuera del hilo de interfaz, revisión + manual, versión/novedades, recordar después y navegador explícito. Web, + GitHub y Referencia comparten destinos con los comandos CLI/TUI. +- P52: Report a bug en las seis ventanas nativas; errores agrupados con + origen/código/ID; borrador en LANMON con sesión, selección de evidencias, + campos editables, anonimización y vista previa antes de abrir GitHub o + exportar Markdown. No se publican incidencias automáticamente. +- P66 «Dimensiones»: creación y edición en LANRACK, lectura en LANWIRE desde + el mismo inventario. Altura estricta 4–52 U y ancho 10/19/21/23 pulgadas; + advertencias sobre datos heredados sin normalizarlos a escondidas. Las skins + y sus puertos decorativos se conservan. +- P47: confirmación de interfaz IPv4, CIDR con máscara real y perfil antes de + sondear. Se valida el origen con el Core y se comunica el alcance ICMP/ARP; + DNS y descubridores externos se omiten con aviso. Sin interfaces o tras un + error de escaneo, la solicitud sigue pendiente y permite reintentar. El + selector habitual también permite recuperar las rutas del sistema. + +Verificación de fuentes: trece regresiones nuevas con servicios reales y +navegador Edge aprobadas en 18,25 s tras las últimas correcciones; además pasan +las regresiones combinadas de interfaces, topología/CPD y skins +aprobadas. También pasan el arranque/cierre nativo de LANIP y de los cuatro +launchers y la coordinación nativa de los cuatro botones de LANCTL. + +La suite integral y el paquete final se registran al concluir esta integración. +Estas pruebas no certifican P34, P40/P42, P50, los transportes restantes de P47 ni +P32 en plataformas externas. Esos pendientes mantienen su estado explícito. + +### Correcciones tras la primera suite integral — AUDITOR + +La primera ejecución integral de GUI-DESIGN terminó con 1.166 pruebas y 644 +subpruebas aprobadas, un caso omitido y seis fallos. Tres pertenecían a la +interfaz y los corrige GUI-DESIGN; los tres no visuales quedan resueltos: + +- La plantilla RK-00 ahora declara las mismas dimensiones que persiste la + creación (18 U, 19 pulgadas). `sample_topology.py` conserva la idempotencia + con muestras antiguas sin añadir dimensiones a sus datos; sigue rechazando + modificaciones reales. Pruebas de repetición, conservación y conflicto. +- `settings_catalog.py` añade GUI al final de las categorías para conservar + la numeración previa: la opción 8 sigue siendo LANIP. La prueba original de + navegación pasa sin cambiar su secuencia. +- La prueba de expansión de variables usa un directorio personalizado y ya + no lo confunde con el valor histórico que Windows redirige a Documentos. + `test_project_paths.py` cubre también la falta de Known Folder; el código de + producción y el contrato de redirección permanecen iguales. + +Además, `event_view.py` reconoce `GUI_ACTIVITY` esquema 1 emitido por la GUI +con nivel entero 1–59, manteniendo el mensaje y su origen. Los éxitos no se +convierten en ErrorEvent. La regresión escribe mediante el logger real y +comprueba lectura incremental, filtrado TUI e histórico; un marcador incluido +en el texto del mensaje no sustituye al marcador externo. Los datos malformados +siguen visibles, sin asignarles un nivel inventado. + +Evaluación de impacto: medio para la comparación de muestras y navegación, +bajo para el lector y aislamiento de pruebas. No se cambian IDs públicos, +firmas de métodos ni rutas de producción. Verificación enfocada ampliada: +**147 pruebas aprobadas en 14,95 s**, incluyendo TUI física, dimensiones, +configuración, rutas y seguimiento de registros. Evidencia local: +`.tool-reports/auditor-20261017/integration-followup.xml`. +Ruff, referencias CLI/web e higiene correctos; catálogo regenerado y comprobado +con **1.390 puntos**. Fuentes no visuales congeladas de nuevo para repetir la +suite integral y el build bajo responsabilidad de GUI-DESIGN. + +## Segundo ciclo AUDITOR — 17/10/2026 + +Validación y orden: primero el acceso de plugins al Core y la limpieza de runtimes +(P34, riesgo crítico); después origen del primer escaneo (P47, alto); herramientas +de desarrollo P67/P68 cuando las fuentes estén congeladas. GUI-DESIGN conserva +la propiedad de las vistas y sus adaptadores. Se mantienen IDs y versión +0.3.4-alpha.1; no se fusionan PR ni se publican ramas o instaladores. + +### P34: revocación de accesos y ciclo de limpieza + +Cambios en `core/plugins/authorization.py`, `manager.py`, `api.py` y +`core/plugin_storage.py`. Cada activación recibe una concesión distinta. Las +operaciones del API comprueban la autoridad persistida y el editor; referencias +antiguas de funciones, eventos, monitor y almacenes dejan de autorizar llamadas. +Los callbacks comprueban además la concesión al retornar. Un observador del +gestor global reconcilia cambios cada 0,5 s; las llamadas no esperan ese sondeo. +La corrupción de la autoridad retira accesos y conserva el archivo averiado. + +Se retiran también los checks del monitor, los consumidores dependientes y los +runtimes aislados que han terminado. La limpieza externa se reserva bajo lock, +pero se ejecuta después de liberarlo y se espera como máximo 0,5 s por plugin. +Una limpieza pendiente impide activar la generación siguiente. `reload` espera +esa fase antes de reactivar. El método aditivo `runtime_status(id)` devuelve +esquema 1, `active`, `coreAccess`, `restartRequired`, `cleanupPending` y `execution`. + +Pruebas: las tres regresiones principales fallaban antes del cambio. Las dieciséis +nuevas incluyen un segundo proceso, revocación de editor, referencias retenidas, +llamada en curso, limpieza colgada, carrera antes de arrancar la limpieza, +dependencias transitivas y terminación de un proceso aislado. El conjunto +ampliado de plugins pasó 119 pruebas en 42,56 s sobre las fuentes aplicadas. +Se añade un lock de inicialización global: ocho accesos simultáneos crean un +solo gestor y un solo observador (regresión específica aprobada). +La comparación AST conserva las firmas de 13 métodos públicos del gestor y +30 del API. Los contratos de eventos y funciones no se modifican. + +Límite explícito: un plugin `trusted` ya cargado puede haber creado hilos y +efectos nativos fuera del API; no se garantiza su terminación ni se deshacen +efectos anteriores o de operaciones ya iniciadas. `restartRequired` persiste +durante la vida del gestor. P34/REF-P34-runtime siguen abiertos hasta disponer +del host de ejecución cancelable y RPC versionado, conservando el runtime +heredado como compatibilidad explícita. No se presenta esta mitigación como +aislamiento del SO. + +### P47: inventario de interfaces y sondeo con origen + +Cambios en `core/network_interfaces.py`, `core/first_scan.py`, servicios +`lan_scanner.py`/`source_binding.py` y comando CLI `list.py`. La enumeración es +local, con máscara real; Windows incluye interfaces virtuales conectadas y +Linux consume `ip -j`. Se valida índice, dirección, prefijo y selección única. +El origen se vuelve a comprobar antes del escaneo: una interfaz desaparecida, +una dirección repetida o un CIDR ajeno no provocan fallback a otra ruta. + +`list --interface ID_O_IPV4` conserva las invocaciones anteriores. Sin un +`--network` explícito usa la máscara de la interfaz; con rango explícito exige +que pertenezca a ella. Rechaza su combinación con un laboratorio activo. +Windows usa IcmpSendEcho2Ex y SendARP con dirección de origen; Linux pasa +interfaz y dirección a ping/arping. La caché ARP se consulta por interfaz. +Los límites de hosts siguen vigentes antes de sondear. + +La modalidad seleccionada es ICMP/ARP: DNS y descubridores externos se omiten +con aviso porque todavía carecen del contrato de origen. No se afirma que +TCP, mDNS, SSDP, WSD o plugins estén vinculados. REF-P47-interface conserva ese +alcance restante y la certificación nativa con varias NIC/Linux. Enumeración +Windows real comprobada sin tráfico; conjunto de 132 pruebas y 10 subpruebas +aprobado en 3,18 s. Dieciséis regresiones nuevas cubren +validación, comandos/llamadas nativas, ausencia de fallback y confirmación. + +Fuentes técnicas consultadas: +[Get-NetIPConfiguration](https://learn.microsoft.com/en-us/powershell/module/nettcpip/get-netipconfiguration), +[IcmpSendEcho2Ex](https://learn.microsoft.com/en-us/windows/win32/api/icmpapi/nf-icmpapi-icmpsendecho2ex), +[SendARP](https://learn.microsoft.com/en-us/windows/win32/api/iphlpapi/nf-iphlpapi-sendarp), +[implementación de ping de iputils](https://github.com/iputils/iputils/blob/master/ping/ping.c). + +### Bloqueos y prioridades restantes + +P40/P42: el usuario confirma que aún no existe editor oficial configurado. +Faltan identidad autorizada y artefactos LCP firmados; no se crea una identidad +oficial ficticia ni se desactiva la verificación. Las claves generadas por las +pruebas son efímeras y solo se usan en directorios temporales. + +P50: el coordinador actual comparte metadatos y avisos, no un snapshot coherente +del estado de trabajo. `_SESSION_DEVICES` vive dentro de cada proceso; leer el +VLF desde un servidor externo perdería esos datos y cambios sin guardar. +Se antepone REF-P50-session: proveedor de snapshot del proceso propietario, +revisión, sesión/proyecto explícitos, caducidad/cierre y lista permitida de datos +sin credenciales. Impacto alto sobre sesión/inventario; no añadir transporte +externo que finja un estado vivo antes de ese contrato y REF-P34-runtime. + +La documentación oficial confirma transportes STDIO y Streamable HTTP para +Codex; ChatGPT web no toma la configuración local de Codex. Para el transporte +remoto autenticado se requiere identidad de usuario y validación de permisos +por petición. No hay conexión externa certificada ni proveedor de identidad +del proyecto definido. Referencias: +[MCP y clientes](https://learn.chatgpt.com/docs/extend/mcp?surface=cli), +[autenticación de servidores MCP](https://developers.openai.com/plugins/build/auth). + +P48 conserva la verificación real de Clink en CMD y el caso de desinstalación +con otra identidad. P32 conserva Windows limpio, Linux ARM64 y SSH remoto. +Las pruebas locales de fuentes no sustituyen esas certificaciones. + +## Estabilización con evidencia de GitHub — 17/10/2026 + +Validación previa: se revisaron los workflows y los jobs/logs reales de las +últimas ejecuciones fallidas y correctas. Objetivo: corregir causas vigentes, +separar fallos de fixtures de fallos del producto y conservar los contratos. + +| Trabajo | Archivos / dependencias | Riesgo e impacto | Resultado | +| --- | --- | --- | --- | +| Dependencias GUI ausentes en CI | `.github/workflows/ci.yml`, `tests/test_distribution.py`; extra `gui` ya usado por Release | Medio; evita que pruebas de confianza fallen por `webview` ausente | CI instala `dev,gui`; regresión de distribución pasa | +| Diagnóstico y plataforma | CI/Release; JUnit/logs y job Windows 3.10/3.11 | Medio; evidencia descargable tras un fallo, sin bajar cobertura Linux del 60 % | Definiciones preparadas; ejecución nueva remota pendiente de integración | +| Cabeceras HTTP | `apps/access/https_server.py`, `tests/test_http_session_headers.py` | Alto; impide valores de cookie/cabecera inyectados por adaptadores o MIME del sistema | Seis IDs malformados rechazados por HTTPS real; tres recursos conservan MIME seguro | +| Pruebas SSH | `tests/test_access.py`; claves Ed25519 efímeras del servidor de prueba | Medio; cliente rechaza servidores con una clave distinta | Dos `AutoAddPolicy` retiradas; pruebas de acceso pasan | +| Salidas de metadatos | `tests/test_lanaccess_manager.py`, `tests/test_hygiene_output.py` | Alto por sensibilidad del almacén; no cambia el contrato de salida | List/show/doctor/settings/protocol y diagnóstico TUI no imprimen contraseña; higiene no imprime el token detectado | +| Fuga real en alta de usuario remoto | `apps/ip/interfaces/cli/commands/access.py`, `tests/test_access_cli_output.py` | Alto; el `asdict` anterior imprimía `passwordHash` en stdout | Proyección explícita conserva metadatos y clave/tipo `passwordHash`, ahora vacía; `passwordConfigured` es aditivo. Pruebas con contraseña y SSH, autenticación persistida y campo privado futuro | +| Canal estable | `.github/workflows/release.yml`, regresión de distribución | Medio; el nombre «experimental» y `make_latest:false` eran incondicionales | Solo el canal experimental conserva esa etiqueta; estable tiene nombre propio y puede ser última versión | +| Herramientas P67/P68 | `pyproject.toml`; Python 3.10.11, Coverage 7.10.6/7.16.2, Ruff 0.17.0 | Medio; comparación sobre fuentes idénticas, sin relajar reglas | Ambas suites: 1.208 pruebas y 645 subpruebas correctas; cobertura idéntica 69,3568 %, umbral 60 % | + +La comparación completa termina en 182,07 s con Coverage 7.10.6 y 189,55 s con +7.16.2. Ambas registran 19.740 líneas cubiertas de 27.055 y 5.243 ramas cubiertas +de 8.966, sin diferencias de cómputo. Un caso de framing IPC POSIX se omite en +Windows y 21 pruebas `legacy_gui` se excluyen según la configuración existente. +Se adopta Coverage 7.16.2; Ruff 0.17.0 comprueba 483 archivos. El entorno no +presenta dependencias rotas. Los XML JUnit, JSON de cobertura y huellas de fuentes +se conservan localmente en `.tool-reports/tool-upgrades/`. + +El nuevo job Windows activa también `LANCTL_GUI_BROWSER_TESTS=1`, instala +Playwright 1.63.0 (la misma versión verificada localmente, compatible con Python +3.10) y usa Microsoft Edge incluido en la +[imagen oficial Windows 2022](https://github.com/actions/runner-images/blob/main/images/windows/Windows2022-Readme.md). +Así esas regresiones no quedan omitidas en todas las plataformas de CI. + +Se reprodujo el comportamiento anterior de cookies en el nuevo caso de prueba: +respondía 200 ante un identificador con CRLF; con el validador responde 400 y no +emite la cabecera inyectada ni la cookie. El contrato normal usa UUID y sigue +funcionando. La API pública de HTTPS y los IDs de eventos no se modifican. +Regresiones enfocadas: 59 pruebas de acceso/distribución/credenciales y otras +9 de salidas/higiene pasan. `pip-audit . --strict`: ninguna vulnerabilidad conocida. + +### Resultados remotos comprobados + +- [Release 39052546460](https://github.com/CctrGy/LANCTL/actions/runs/39052546460): + éxito de validación, Windows y Linux amd64/arm64 sobre `4ca563d`. + Los fallos anteriores de dependencia GUI, fixture de plataforma, arranque + frío y comprobación de permisos del sentinel ya tienen una ejecución posterior + correcta. No equivale a validar el candidato local posterior. +- [Seguridad PR 25](https://github.com/CctrGy/LANCTL/actions/runs/38596122454) y + [seguridad PR 23](https://github.com/CctrGy/LANCTL/actions/runs/37421942821): + fallaban repetidamente porque **Dependency graph estaba Off**. Se activó en + el repositorio público y se relanzaron los jobs fallidos desde la sesión del + propietario. Ambos intentos 2 finalizan correctamente. No se cambió el umbral + `moderate`, no se deshabilitó el control ni se fusionaron las PR. +- Documentación contrastada: + [revisión de dependencias de GitHub](https://docs.github.com/en/code-security/getting-started/quickstart-for-securing-your-repository) + y [acción oficial](https://github.com/actions/dependency-review-action). + +### Avisos CodeQL y límites de la comprobación + +Se inventariaron los 13 avisos abiertos de `main`: 6/7/8/10/12/14/15/16/17/18 +de salida de datos, 5/13 sobre `AutoAddPolicy` en pruebas y 9 sobre +`Content-Type`. El flujo completo de #18 identifica `secret_root()` como +origen sensible y termina mostrando **la ruta**, sin leer el secreto: falso +positivo comprobado. #7/#8/#15 muestran rutas; #14 muestra nombre de archivo y +clase del hallazgo, probado sin volcar el valor. Los listados del almacén usan +proyecciones explícitas de metadatos, verificadas con contraseñas centinela. + +#9 deja de depender de MIME obtenido del sistema; 5/13 ahora usan host keys +conocidas. La revisión de las ramas del comando `access` detectó una +fuga real: `user add` serializaba el hash de contraseña. La regresión reproduce +el fallo anterior y verifica la proyección segura. El código de emparejamiento +solo se emite bajo su petición explícita. + +Se creó la [PR 26 en borrador](https://github.com/CctrGy/LANCTL/pull/26), desde +`codex/stable-readiness-20261017`, con copia aislada y comprobada de las fuentes; +`main`, `experimental-gui`, tags y ramas estables no se modificaron. El +[análisis de seguridad del candidato](https://github.com/CctrGy/LANCTL/actions/runs/39068885618) +completa dependency-review y CodeQL correctamente. Se inspeccionaron los SARIF +de `main` (1952995019) y de la PR (1973832502): en el candidato figura #6 con +origen `user.passwordRotatedAt`, una fecha opcional de metadatos. El hash real +ya no sale; el JSON conserva su clave como string vacío. No se cambia el +contrato de fechas ni se renombra código para esquivar el analizador. + +Para evitar confundir el análisis incremental de la PR con el repositorio +completo, se ejecutó también +[CodeQL manual sobre la rama candidata](https://github.com/CctrGy/LANCTL/actions/runs/39069160510). +El análisis completo 1973841429 de `2b8494a` termina sin errores ni advertencias +del analizador, con 43 reglas y **10 resultados**: #6/#7/#10/#12/#14/#15/#16/#17/ +#18/#19. Se revisaron sus orígenes: fecha `passwordRotatedAt`, rutas de +`secret_root`, IDs/metadatos de credenciales y etiquetas del detector de higiene. +#19 corresponde a la ruta del archivo de configuración, antes registrada como +#8 en `main`. Los dos hallazgos de host keys y el de cabecera HTTP no aparecen +en este análisis completo. Los diez resultados de metadatos siguen visibles; +no se han añadido exclusiones ni se han descartado alertas para obtener un verde. + +El SARIF histórico confirma que #10/#12/#16/#17 siguen IDs públicos y campos +de metadatos desde el documento descifrado, no `password`; #14 sigue las +etiquetas de patrones del detector, no los tokens encontrados; #6/#7/#8/#15/#18 +seguían rutas devueltas por `secret_root`. Las regresiones con secretos centinela +comprueban la separación. No se han descartado alertas remotamente: los 13 de +`main` conservan el estado correspondiente a su propio código hasta integración. + +### Verificación final local y primer CI del candidato + +Con Coverage 7.16.2 y navegador Edge: **1.212 pruebas, 645 subpruebas correctas** +en 185,61 s, una omisión POSIX en Windows y 21 heredadas excluidas por defecto. +Estas últimas se ejecutaron también explícitamente: **21/21 correctas** en +1,82 s. Total: **1.233 pruebas correctas**. Cobertura 69,4720 %, umbral 60 %. +Ruff/formato (484 archivos), catálogo (1.420 puntos), referencias e higiene +correctos. No cambian los archivos de contratos/IDs Core ni las firmas públicas +revisadas de acceso y HTTPS frente a `main` (`ccd728b`). + +El primer [CI remoto](https://github.com/CctrGy/LANCTL/actions/runs/39068885619) +detectó un fallo de fixture exclusivo de Linux: la prueba simulaba Windows sin +proporcionar `subprocess.CREATE_NO_WINDOW`. Se corrige únicamente +`tests/test_network_interfaces.py`, manteniendo la implementación nativa. Sus +16 pruebas pasan también al eliminar esa constante del módulo local antes de +ejecutarlas; ahora se comprueba el flag Windows y el cero Linux. No requiere +recompilar los binarios. La validación remota posterior queda registrada al +terminar; no se equipara el resultado local a un CI Linux correcto. + +GUI-DESIGN completó la compilación y comprobación nativa de los seis launchers. +Se verifican independientemente las 386 entradas congeladas y la huella del +instalador local: 135.487.663 bytes, SHA-256 +`5401cb5a085c4cf8fa2b86dbb9270e72f6a45ff0cfdfbdbf1c4ce113626bde3a`. +El resultado está en `dist/gui-current/LANCTL-0.3.4-alpha.1-gui-setup.exe`. +Los seis binarios incluyen los recursos/módulos actuales y pasan apertura, +icono, IPC y cierre; los datos de prueba están aislados. No se ha instalado ni +publicado ese instalador en el equipo del usuario. La certificación remota de +instalación y paquetes continúa mediante el workflow manual, que excluye el +job de publicación por exigir un evento `push`. + +Los jobs Windows 3.10 y 3.11 del segundo CI detectaron **seis expectativas de +rutas incorrectas** en `test_paths.py`, `test_icons.py` y +`test_physical_core_libraries.py`. El directorio temporal del runner usa +`RUNNER~1`, mientras que los servicios devuelven rutas canónicas con +`runneradmin`. Se reprodujeron los mismos seis fallos localmente mediante un +alias 8.3 real obtenido con `GetShortPathNameW`. Las expectativas ahora resuelven +la ruta esperada, conservando los componentes/nombres y el contrato existente; +**16/16 pruebas correctas** con el alias. Solo cambian pruebas, sin modificar +servicios ni invalidar los binarios compilados. La matriz Windows se repite +sobre la corrección; no se normaliza el entorno del runner para ocultar el caso. + +La siguiente [ejecución CI](https://github.com/CctrGy/LANCTL/actions/runs/39069631762) +de `4193664` completa correctamente Linux y Windows Python 3.10/3.11 con las +regresiones de navegador activadas en Windows. El +[workflow manual de distribución](https://github.com/CctrGy/LANCTL/actions/runs/39069158807) +de `2b8494a` también finaliza correctamente: Windows instalado/actualizado/ +desinstalado conservando datos, portable con los seis launchers y exclusión de +GUI duplicada, paquetes nativos Linux amd64 y arm64 con instalación/actualización/ +desinstalación. El job `release` se omite; no crea tags ni publicaciones. +Estos resultados preceden a la corrección nativa Clink y a los previews P45, +por lo que se repiten las comprobaciones pertinentes sobre el siguiente corte. + +### P48: comprobación nativa y corrección de registro repetido + +Se usa el ZIP oficial de [Clink 1.9.34](https://github.com/chrisant996/clink/releases/tag/v1.9.34), +contrastado con su SHA-256 publicado, en `.tool-reports/clink-native/`, sin +instalar autorun ni modificar PATH/perfil de forma permanente. CMD con Clink +completa `--version` para los seis launchers y el contexto `lanctl ip history`. + +La prueba real detectó que `installscripts` devuelve 1 para una carpeta ya +registrada; `uninstallscripts` hace lo mismo si ya fue retirada. El adaptador +trataba esos casos como fallos. Se corrige `core/clink_integration.py`: ante +código 1 comprueba el listado real y exige coincidencia exacta normalizada de +la carpeta y el estado solicitado. No acepta prefijos ni un listado fallido. +Conserva bloqueo, propietario, protección ante elevación, plazo y origen de +errores; no cambia la API pública. Riesgo medio, sin impacto en Linux. + +Las regresiones reproducen tres fallos anteriores; después pasan 22 pruebas +y seis subpruebas enfocadas. Con Clink real pasan registro, repetición, retirada, +repetición de retirada y retirada previa por otra herramienta. El registro +original del usuario se comprueba y restaura exactamente; los marcadores de +prueba permanecen en un directorio aislado. P48 solo conserva la comprobación +de desinstalación elevada por otra cuenta. No se atribuye esa certificación a +la prueba del usuario normal. + +El supuesto bloqueo de cierre LANIP fue un fallo del harness: usaba proyectos +reales y pipes sin consumir. GUI-DESIGN comprobó cierre nativo y código de salida +0 con directorio temporal y salida a archivo; no necesitó cambiar la aplicación +por esa observación. P34/P47 están integrándose con sus avisos y selector real. + +La regresión adicional de codificación reproduce el fallo con salida UTF-8 y +CP1252 como codificación predeterminada de Windows. Se declara UTF-8 en las +dos llamadas Clink. La prueba pasa tras fallar antes; Clink 1.9.34 real confirma +registro repetido y retirada de una ruta con espacios y «é», restaurando el +registro original. La suite completa anterior a este último ajuste pasó +1.241 pruebas, 645 subpruebas y una omisión, con cobertura 69,8801 %. + +### P71.4: validación y plan de cuenta inicial en Setup + +Solicitud humana nueva recibida mediante GUI-DESIGN: el instalador no pide +crear las credenciales de acceso remoto. Se adelanta exclusivamente ese punto +de P71, sin incorporar el resto de la reorganización del instalador. + +- Objetivo: ofrecer un asistente local para la primera cuenta administrativa + LANACCESS del servicio; preservar todas las cuentas de una actualización. +- Archivos: `apps/access/remote_setup.py`, parser `manager_cli.py`, regresiones, + Clink y referencias. GUI-DESIGN posee `gui/remote-setup.{html,css,js}` e Inno. +- Dependencias: `AuthenticationService`, `AccessStore`, bloqueo entre procesos, + privilegios del SO, WebView2 y ACL de la carpeta del servicio aplicadas antes + del asistente. Ventana independiente después de copiar los ejecutables. +- Riesgo alto: confundir el perfil de quien acepta UAC con el almacén del + servicio o filtrar secretos por argv/logs. La ruta procede de Windows y se + rechazan redirecciones/configuraciones personalizadas incompatibles. +- Contrato: comando aditivo `lanaccess remote-setup`; puente local limitado a + estado, creación inicial y cierre. Contraseña/confirmación solo en memoria; + hash Scrypt mediante el servicio existente; ninguna contraseña predeterminada. +- Impacto: no modifica autenticación ni cuentas existentes, no abre listeners, + no habilita SSH/HTTPS ni toca firewall. La creación concurrente se serializa. + Cancelación/silencioso permiten instalar sin configurar acceso remoto. +- Verificación prevista: no administrador, validación, duplicado, concurrencia, + actualización, rutas, ausencia de secretos, contrato parser, navegador y + suite completa; repetir CI y distribución después de integrar GUI-DESIGN. + +La implementación de P71.4 pasa las regresiones de permisos del SO, longitud y +confirmación de contraseña, creación concurrente, actualización sin reemplazar +cuentas, migración heredada, corrupción, rutas redirigidas/personalizadas, +cancelación y redacción de errores. La integración Edge llama al servicio real +con un almacén temporal: crea la cuenta y verifica después su autenticación +Scrypt y rol administrativo, sin modificar cuentas reales ni abrir listeners. +Los errores de inicio se muestran dentro del asistente, también con consola +oculta. El recorrido humano completo bajo UAC se comprobará con el instalador +reconstruido; no se da por verificado por la prueba de navegador. + +La inspección final contrasta 89 firmas públicas con `main` (`ccd728b`) y, para +el adaptador Clink añadido después, con el checkpoint `581c5a3`: no se elimina +ni cambia ninguna. `AccessManager.__init__/list/delete` siguen disponibles con +las mismas firmas por herencia de `CredentialService`. Los tres archivos de +contratos/IDs Core permanecen idénticos. `remote-setup` es un comando aditivo; +se regeneran CLI, Clink y referencia web. La redacción de `passwordHash` en la +salida CLI es el cambio de seguridad intencionado ya descrito, manteniendo la +clave JSON y añadiendo `passwordConfigured`. + +### Corte final local con P45, P48 y P71.4 + +Suite completa, incluidas las pruebas heredadas y navegador Edge: +**1.269 pruebas y 645 subpruebas correctas**, una omisión POSIX en Windows, +196,59 s. Cobertura de ramas/líneas combinada **69,9154 %**, umbral 60 %. +Ruff/formato: 490 archivos; Bandit con el mismo nivel `-ll` de CI, pip check, +pip-audit, compileall, catálogo (1.434 puntos), referencias CLI/web, higiene y +`git diff --check` correctos. Se congela este código para reconstrucción local +y CI/distribución de la PR 26; sus resultados remotos se añaden por commit. + +El candidato `3a02230` supera el job Linux de +[CI 39070877629](https://github.com/CctrGy/LANCTL/actions/runs/39070877629): +1.195 pruebas, 54 omisiones de plataforma/navegador y 21 heredadas excluidas +por la configuración ordinaria; estas últimas sí están incluidas en la suite +local completa. Cobertura Linux 68,4067 %. Ruff, referencias, catálogo, Bandit, +higiene y dependencias pasan en el runner. + +El análisis CodeQL completo de la rama, +[39070884827](https://github.com/CctrGy/LANCTL/actions/runs/39070884827), produce +el análisis 1973896053 sobre `3a02230`, 43 reglas, sin errores ni advertencias +del motor. Conserva exactamente los diez resultados previamente inspeccionados +sobre rutas, fechas y metadatos; no incorpora resultados nuevos con P48/P71.4. +No se han silenciado ni descartado alertas en GitHub. Esto no declara cerradas +las alertas de `main` antes de integrar la corrección y analizar esa rama. + +La matriz completa de CI 39070877629 termina correctamente para `3a02230`: +Linux y Windows Python 3.10/3.11. Las regresiones de navegador están habilitadas +en ambos jobs Windows, incluidas las del asistente de cuenta remota. + +El Setup local se reconstruye sin ejecutar el instalador: Inno retorna 0 y +produce `dist/gui-verified/LANCTL-0.3.4-alpha.1-gui-setup.exe`, 135.699.318 bytes, +SHA-256 `54b71767a472d4d0da8fb7fd64ba1ce289a749f5505dede980e0280e6fd936e5`. +Se verifican las 398 entradas del manifest congelado; los seis ejecutables +contienen los 32 recursos y 17 módulos esperados y el parser `remote-setup`. +La última prueba nativa de ventanas se interrumpe por Escape del usuario y +queda pendiente; no se declara éxito por el mero arranque. Las cuentas reales +y el control UAC no se modifican. El artefacto local es experimental y procede +del checkout compartido; los paquetes de certificación se generan desde el +commit limpio de la PR en los runners de GitHub. + +### Último caso de plataforma del asistente + +La revisión posterior encuentra un fallo en `remote-setup` fuera de Windows: +intentaba importar WebView antes de rechazar la plataforma, por lo que una +instalación Linux sin GUI terminaba con `ModuleNotFoundError`. Se reproduce +con una prueba que impide cargar WebView; después se rechaza con `ValueError` +antes de importar la interfaz, conservando el manejo CLI existente. Cambian +únicamente dos líneas del adaptador, una regresión y el catálogo (1.435 puntos). +Pasan 35 pruebas enfocadas, Ruff, formato, referencias e higiene. Se repiten +CI y distribución sobre esta corrección; los resultados de `3a02230` anteriores +se conservan como evidencia del corte previo, sin atribuirlos al nuevo commit. diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md index 80b5b4d..809a43d 100644 --- a/docs/BACKLOG.md +++ b/docs/BACKLOG.md @@ -1,72 +1,1028 @@ # Trabajo pendiente de LANCTL -Lista de asuntos acordados para revisar en una sesión futura. Este documento no -indica que las tareas estén implementadas. +## Revisión de pendientes solicitada — 17/10/2026, segundo ciclo + +Se vuelve a comprobar toda la lista, incluidas las entradas implementadas que +esperan el cierre de GUI-DESIGN. No se inicia una segunda compilación durante +su validación. El usuario confirma que **todavía no existe un editor oficial +configurado**: P40/P42 siguen requiriendo identidad y firma autorizadas. + +| Orden | Objetivo / alcance | Archivos previstos | Dependencias e impacto | Riesgo | +| --- | --- | --- | --- | --- | +| 1 | P34: comprobar autorización vigente en cada acceso al Core, invalidar referencias antiguas, propagar revocaciones y separar limpieza de locks. Exponer los límites del runtime trusted heredado. | `core/plugins/manager.py`, `api.py`, nuevo servicio de autorización y regresiones de plugins. | Esperar cierre del build en curso; conservar firmas públicas y autorización explícita. Hilos nativos heredados requieren una migración de runtime, nunca declarar su terminación por quitar callbacks. | Crítico | +| 2 | REF-P47-interface/P47: enumerar redes reales y vincular las sondas a un origen seleccionado. | Servicios de descubrimiento, `core/first_scan.py`, CLI de escaneo y regresiones; adaptador visual coordinado. | Contrato de selección explícita, máscara real, rechazo de interfaz desaparecida; ninguna sonda previa a confirmar. | Alto | +| 3 | P50: contrato de consulta de sesión viva, revisión y datos sin guardar antes del transporte externo. | `core/session.py`, servicios de consulta y adaptador MCP; pruebas de contexto y redacción. | Contexto explícito, revocación y autenticación. La disponibilidad en ChatGPT exige conexión externa real; no se confunde una prueba local con esa certificación. | Alto | +| 4 | P67/P68: comparar Coverage 7.10.6/7.16.2 y Ruff 0.16.2/0.17.0 con Python 3.10 y umbral 60 %. | `pyproject.toml`, documentación de herramientas; entornos de evaluación locales. | Evaluación aislada durante build; suite con ambas versiones sobre las mismas fuentes cuando quede libre. No fusionar PR ni publicar ramas estables. | Medio | +| 5 | P45/P46/P48/P32: contrastar instalación, portable, completado y plataformas con evidencia real. | Empaquetado y pruebas de distribución. | Artefactos de GUI-DESIGN, CMD/Clink y entornos disponibles. Firmas, Linux ARM64 o SSH no disponibles no se certifican. | Alto | + +P35/P49/P51/P52/P53/P54 y P66 «Dimensiones» tienen implementación compartida; +su cierre se contrastará con el resultado integral y los artefactos del primer +ciclo. Las decisiones y resultados de este segundo ciclo se añaden a la matriz +de verificación, conservando el historial anterior. + +Resultado del segundo ciclo (fuentes): mitigaciones de P34 aplicadas y verificadas +con 119 pruebas; P47 incorpora máscara real y origen ICMP/ARP, con 132 pruebas +y 10 subpruebas. Integración visual P34/P47 aplicada por GUI-DESIGN. P68 revisada: +Ruff 0.17.0 pasa lint/formato y queda fijado en `pyproject.toml`; P67 supera la +comparación integral y fija Coverage 7.16.2. No cambian IDs públicos +ni versión de LANCTL. Los detalles y límites figuran en la matriz de verificación. +P69–P73 fueron incorporadas desde HELP durante este ciclo por peticiones de +anotación. La creación inicial de cuentas de P71.4 se adelanta por nueva petición +humana; el resto sigue pendiente y no se presenta como implementado. + +### Estabilización y comprobaciones GitHub — 17/10/2026 + +El usuario solicita corregir fallos persistentes/intermitentes y preparar la +próxima estable. Se anteponen los fallos reproducibles de seguridad y CI a las +nuevas opciones del instalador. No se cambia la versión ni se publica una estable +durante esta validación. + +- [x] Resolver el fallo repetido de `dependency-review`: grafo de dependencias + desactivado, activado y verificado mediante reintentos reales de las PR 23/25. +- [x] Igualar dependencias de CI y Release (`dev,gui`), conservar JUnit/logs + incluso al fallar y añadir regresiones Windows Python 3.10/3.11 a CI. Las nuevas + definiciones pasan en CI 39070877629 sobre `3a02230`. +- [x] Endurecer cabeceras HTTPS: tipos MIME fijos para recursos publicados y + validación de identificadores de sesión; pruebas TLS contra inyección. +- [x] Sustituir confianza SSH automática en dos pruebas por la clave efímera + conocida; verificar salidas de metadatos/TUI/higiene sin contraseñas. +- [x] Corregir fuga del hash de contraseña al crear un usuario remoto desde + CLI: proyección explícita de metadatos, clave `passwordHash` vacía por + compatibilidad y nueva señal `passwordConfigured`; autenticación conservada. +- [x] Corregir nombre y selección de última versión del workflow estable, + manteniendo el canal experimental. No se ha publicado ni movido ningún tag. +- [x] Comparación integral Coverage 7.10.6/7.16.2 sobre fuentes idénticas: + ambas pasan 1.208 pruebas y 645 subpruebas, con cobertura idéntica 69,3568 % + y umbral conservado del 60 %. Se adopta 7.16.2 (P67). +- [x] Verificación local final tras corregir el reintento del primer escaneo: + 1.269 pruebas (incluidas heredadas y navegador) y 645 subpruebas pasan; + un caso POSIX omitido en Windows. Cobertura 69,9154 %, umbral 60 %. + Este corte incluye P45/P48/P71.4. +- [x] Reejecutar CodeQL sobre el candidato e inspeccionar el SARIF: el resultado + de la PR 26 conserva #6 sobre `passwordRotatedAt`, una fecha, no el hash. + El análisis completo de la rama registra diez resultados sobre rutas, + fechas y metadatos; los tres de SSH/cabecera ya no aparecen. + No se ocultan alertas; los avisos de `main` no se consideran cerrados antes + de integrar y analizar esa rama. +- [x] Corregir el fallo exclusivo de CI Linux en la simulación de Windows: + la prueba de interfaces ahora suministra `CREATE_NO_WINDOW` y verifica flags. +- [x] Corregir seis expectativas de rutas que fallaban en Windows CI con + alias 8.3 (`RUNNER~1`). Reproducidas localmente con una ruta corta real: + seis fallos antes, 16 pruebas correctas después; contrato canónico conservado. +- [x] Completar CI de la PR 26 sobre `3a02230`: Linux y Windows Python + 3.10/3.11 correctos en 39070877629, con navegador en Windows. +- [ ] Completar la validación de paquetes 39070883667 sobre ese mismo código; + el workflow manual no publica releases ni tags. +- [x] Compilar los seis launchers y Setup actualizado: 398 entradas, + recursos/módulos y parser comprobados; Inno termina con código 0. +- [ ] Completar la revisión visual nativa final: interrumpida con Escape por + el usuario en GUI-DESIGN; no se reanuda ni se marca como aprobada. + Firmas oficiales y REF-P34-runtime conservan sus bloqueos explícitos. + +Estado consolidado el **17/10/2026**; se conserva debajo el historial del 16/10. Los puntos marcados tienen corrección o +verificación local con evidencia en [la matriz de comprobación](BACKLOG-VERIFICATION.md). +La validación de plataformas externas sigue separada; las marcas no equivalen +a certificar instaladores ni sistemas que no se han ejecutado. + +## Coordinación no visual AUDITOR — 17/10/2026 + +Esta revisión complementa el orden histórico del 16/10. El usuario ha encargado +continuar los pendientes disponibles en coordinación con GUI-DESIGN. Se conserva +`experimental-gui` y la versión existente; no se publican ni instalan artefactos. +GUI-DESIGN conserva los archivos `gui/*`, SuiteApi/LauncherApi, `gui_support.py` +y `desktop.py`; AUDITOR desarrolla servicios, datos, CLI/TUI e instalación. + +| Tarea | Objetivo y archivos de AUDITOR | Dependencias / impacto | Riesgo | Resultado en fuentes | +| --- | --- | --- | --- | --- | +| P54 | Enlaces compartidos en `core/official_links.py`, `bootstrap/lanctl.py`, Clink y referencias. | Opciones aditivas; sin shell ni destino arbitrario. Desbloquea botones GUI y catálogo de P48. | Bajo | Backend y CLI/TUI verificados; integración visual a cargo de GUI-DESIGN. | +| P35 | Cinco presets y preferencias en `core/gui_preferences.py`, `config.py`, `settings_catalog.py`; lectura de temas activos en `plugins/manager.py`. | Base elegida + tokens/componentes explícitos de plugins; no cambia preferencias guardadas. P34 sigue pendiente para revocación completa entre procesos. | Medio | Persistencia, validación y catálogo comprobados; corregida categoría GUI ausente. | +| P49 | TUI incremental en `apps/monitor/log_tui.py`, `log_stream.py`, `bootstrap/lanmon.py`. | Reutiliza lector, limita lotes y memoria, conserva `--follow`; cierre sin parar tareas. | Medio | Pausa, navegación, filtros y terminal independiente verificados en pruebas enfocadas. | +| P53 | Transporte en `core/activity.py`. | SQLite por propietario, sesión/proyecto explícitos, cursor y últimos registros; conserva mensajes tras cerrar el emisor. | Alto | Verificada escritura desde proceso independiente y lectura desde otro; GUI puede retirar buffer local. | +| P52 | Preparador `core/diagnostics.py` y adaptador `apps/monitor/bug_reports.py`. | Selección acotada, anonimización, agrupación de errores y nueva redacción al exportar; sin proyectos completos ni publicación automática. | Alto | Backend comprobado. Separa el preparador sin red del formulario GitHub; desbloquea esa parte de P50. | +| P51 | Consulta `core/updates.py`. | REST oficial, comparación semántica y canal publicado; caché y reserva entre procesos; tolera fallos. GUI debe invocarlo en worker. | Medio | Verificadas versiones, fallos, recordatorio, concurrencia y validación de enlaces de caché. No instala ni descarga. | +| P66 «Dimensiones» | `core/rack_dimensions.py`, servicios rack/wire, base IDF, modelo NetworkRack y CLI/TUI de LANRACK. | 4–52 U y 10/19/21/23 pulgadas; conserva datos antiguos con advertencias y bloquea reducciones que excluyan equipos. | Alto | Validación y persistencia compartidas comprobadas. La otra entrada P66 «Frentes» conserva su ID y estado. | +| P46 | `plugins/selection.py`, `builtin.py`, `core/installation.py`, instalador. | Selección inicial all/none/individual persistente; tema base obligatorio; actualización conserva elección y permisos. P40 impide certificar uso de trusted oficiales. | Alto | Backend verificado; fuente del instalador preparada, pendiente empaquetado/certificación. | +| P45 | Cinco temas con preview en `packaging/inno/LANCTL.iss`; `setup-defaults` consume el mismo validador. | P35/P46 implementadas en fuentes; actualización no sobrescribe configuración existente. | Medio | Implementación preparada; la compilación/prueba visual del instalador corresponde a integración final. | +| P47 | `core/first_scan.py`, enumeración de interfaces, CLI `list --interface` y transporte ICMP/ARP con origen explícito. | Selección de NIC/rango real, usuario normal y confirmación antes de sondas; adaptador visual en integración. | Alto | 132 pruebas y 10 subpruebas pasan. REF-P47-interface conserva TCP/descubridores y certificación nativa varias NIC/Linux. | +| P48 | `core/clink_integration.py`, Lua, instalador, `portable/prepare.ps1`, script de build. | Solo carpeta de esta distribución/usuario; no ejecutar PATH de usuario al desinstalar elevado. Falta desinstalación desde otra cuenta. | Medio | CMD/Clink 1.9.34 real: completado de los seis launchers, registro repetido y retirada verificados. Corregido código 1 de operación ya aplicada; registro original restaurado. | +| P34 | Concesiones por activación, comprobación de autoridad, retirada de referencias y limpieza fuera de locks implementadas; 119 pruebas pasan. | REF-P34-runtime sigue necesaria: hilos y efectos nativos del trusted heredado no son cancelables desde la API. | Crítico | `runtime_status` distingue acceso al Core, limpieza pendiente y reinicio requerido. No se declara revocación nativa completa. | +| P40/P42 | Artefactos LCP oficiales y confianza real. | Requiere editor/clave y paquetes firmados autorizados; no crear identidad ficticia. | Alto | Bloqueo externo mantenido. | +| P50 | Puente MCP de consulta y diagnóstico. | REF-P34-runtime, contrato de snapshots de sesión viva/revisión y transporte autenticado verificable; el coordinador actual solo comparte metadatos. | Alto | Preparador P52 disponible; puente no implementado ni certificado. No sustituir cambios sin guardar por lectura del VLF. | +| P32 | Certificación de distribución. | Windows instalado/portable y Linux amd64/arm64 pasan en GitHub sobre `2b8494a`; se repite tras P45/P48. SSH externo y varias NIC siguen pendientes. | Alto | Evidencia por commit y plataforma; no se confunde compilación o SSH de loopback con certificación de red externa. | + +Refactorizaciones necesarias antes de reanudar las tareas bloqueadas: + +- [ ] **REF-P34-runtime.** Contrato de ejecución con revocación comprobable. + Separar los plugins con ejecución cancelable en procesos propiedad del host; + versionar el RPC, permisos por llamada y concesión/revisión de autorización. + Definir suspensión de nuevas llamadas, retirada de callbacks/funciones, + cancelación y terminación con plazo, dependencias y confirmación por proceso. + Nunca mantener locks de registro mientras se invoca `deactivate` de código + externo. Conservar runtime/API anteriores como compatibilidad explícita con + sus límites; no anunciar aislamiento para `trusted` en proceso. Impacto alto + en plugins y contratos, riesgo crítico; condición previa de cierre P34/P50. +- [ ] **REF-P47-interface.** Completar el origen explícito de TCP y de los + descubridores mDNS/SSDP/WSD, y certificar varias NIC en Windows/Linux. + La enumeración con máscara real y la vinculación ICMP/ARP ya están + implementadas; el modo explícito omite los mecanismos que aún no garantizan + ese origen. No introducir escaneos fuera del rango confirmado. Impacto + transversal en descubrimiento, riesgo alto; requisito para completar P47. + +- [ ] **REF-P50-session.** Antes del puente MCP, definir un proveedor de snapshot + del proceso propietario con revisión, contexto de sesión/proyecto explícito, + caducidad al cerrar/cambiar de proyecto y datos temporales aún no guardados. + Seleccionar campos por capacidad y excluir credenciales. El coordinador solo + contiene metadatos y `_SESSION_DEVICES` es memoria de proceso: leer un VLF + desde el servidor no cumple ese contrato. Riesgo alto, impacto en sesión e + inventario; depende de REF-P34-runtime para exposición mediante plugin. + +Orden recomendado tras validar el candidato: resolver REF-P34-runtime, +completar REF-P47-interface y la certificación externa P32/P48; configurar el +editor autorizado antes de cerrar P40/P42. P50 requiere además el contrato de +sesión viva REF-P50-session. P45 está comprobada por el usuario; P67/P68 están +aplicadas y verificadas. Las nuevas páginas y opciones P69–P73 conservan su +planificación separada, salvo la creación inicial de cuentas de P71.4. + +Las marcas históricas de las tareas con alcance GUI/instalador no se adelantan +a la validación final. Evidencia y límites: sección AUDITOR del 17/10 en +`docs/BACKLOG-VERIFICATION.md`; contratos de integración en el informe local +`.tool-reports/gui-auditor-sync.json`. + +## Orden de ejecución validado — 16/10/2026 + +Este orden gobierna las tareas abiertas; los IDs y el historial de las secciones +posteriores se conservan. En cada ciclo se valida y planifica antes de escribir +código, se implementa una sola tarea disponible y se actualiza su evidencia. +Los riesgos de la tabla describen el riesgo de introducir el cambio. Una tarea +bloqueada no impide avanzar otra independiente. GUI-DESIGN estaba inactivo al +comprobar esta planificación; sus archivos conservan cambios sin integrar. + +Hallazgos de validación: P40/P42 son una sola incidencia; P44 impedía comprobar +el arranque con datos antiguos; la inicialización completa del layout solo se +invoca en la entrada LANIP, mientras otras GUI usan el gestor directamente. +Por ello la compatibilidad del registro debe resolverse en su límite de lectura +compartido, sin añadir inicializadores a cada interfaz. P34 conserva autorización +y runtimes en memoria por proceso: notificar cambios visuales no basta para +revocar ejecución. Su siguiente revisión debe definir el alcance del cierre de +un plugin `trusted` dentro del proceso y el orden de locks antes de implementar. + +| Orden / tarea | Objetivo | Módulos y archivos afectados | Dependencias y conflictos detectados | Riesgo | Impacto / estado actual | +| --- | --- | --- | --- | --- | --- | +| Completada · P44 | Recuperar exclusivamente el registro vacío histórico y conservar rechazos de corrupción. | Plugins/persistencia: `src/lanctl/core/plugins/manager.py`, `src/lanctl/core/data_migration.py` (plantilla ya corregida), `src/lanctl/core/file_transaction.py` (reutilizar); nueva prueba `tests/test_plugin_registry_migration.py`; `errorList.txt`. | Sin bloqueo externo. No duplicar la migración en GUI ni relajar el validador. Compartir el lock de los escritores. | Alto | Arranque antiguo recuperado y verificado. Dependencia satisfecha para P34/P46/P47/P32. | +| 1 · P34 | Aplicar cambios de autorización a gestores/runtimes activos y reflejar estado real. | `core/plugins/manager.py`, `publishers.py`, `api.py`, `events.py`, `functions.py`, `isolated_runtime.py`; `core/session.py`, `coordination.py`; adaptadores GUI y pruebas de plugins/coordinación bajo `src/lanctl/` y `tests/`. | P44 completada permite reproducir actualizaciones desde datos previos. Concretar cancelación de `trusted`, propagación entre procesos, dependencia de consumidores y revocación durante llamadas; las vistas se coordinan con GUI-DESIGN. | Crítico | Seguridad transversal; no basta invalidar una caché ni emitir un evento. Pendiente de validación específica del ciclo de vida. | +| 2 · P40 | Distribuir y verificar los LCP oficiales firmados. | `core/plugins/package.py`, `publishers.py`, `builtin.py`, `bundled/*.lcp`, `bundled/plugin-catalog.json`, herramientas de empaquetado y pruebas de instalación. | Requiere identidad/clave del editor y artefactos autorizados. P34 para certificar revocación en caliente; la firma del paquete puede prepararse en paralelo. No generar una identidad oficial ficticia. | Alto | Desbloquea uso de los cuatro plugins `trusted` y la entrega de P46. Bloqueada externamente para publicar firmas reales. | +| 2 · P42 | Conservar evidencia y seguimiento del bloqueo de mDNS/SSDP. | `docs/BACKLOG.md`, `docs/BACKLOG-VERIFICATION.md`; mismos módulos de P40. | Alias de seguimiento de P40, no una segunda implementación. | Bajo | Se cerrará junto a P40 cuando exista evidencia de instalación real. | +| 3 · P35 | Definir opciones básicas y verificar persistencia/feedback de temas. | `core/plugins/theme.py`, `settings.py`, `core/config.py`; `apps/ip/interfaces/gui/theme.py`; `gui/suite.js`, `suite.css`, `launcher.js`; pruebas de configuración/navegador. | P34 para estado de plugins consistente entre procesos. Acordar catálogo de opciones antes de añadir campos; propiedad visual de GUI-DESIGN. | Medio | Establece el contrato de temas que consumirá P45; evita un estado visual distinto del guardado. Pendiente de diseño acotado. | +| 4 · P46 | Respetar selección de plugins opcionales durante instalación y actualización. | `core/plugins/builtin.py`, `core/data_migration.py`, `LANCTL.spec`, `packaging/inno/LANCTL.iss`, `scripts/build-windows.ps1`, pruebas de distribución. | P44 completada; P40 para entregar plugins `trusted` utilizables. Definir exclusión persistente para que el bootstrap no reinstale lo omitido y preservar el tema base. | Alto | Cambia instalación/primer arranque sin conceder permisos. Antes de P45 y de certificar P47. | +| 5 · P45 | Elegir cinco temas con vista previa sin sobrescribir preferencias al actualizar. | `core/plugins/theme.py`, `core/config.py`, recursos de temas, `packaging/inno/LANCTL.iss`, pruebas de instalación/configuración. | P35 define preferencias y los cinco temas; P46 define qué recursos son obligatorios. Comparte instalador con P46/P47/P48: cambios secuenciales. | Medio | Afecta primer inicio y actualización; no escribir configuraciones con un formato paralelo. | +| 6 · P47 | Abrir LANIP y ofrecer el primer escaneo elegido por el usuario. | `packaging/inno/LANCTL.iss`, `bootstrap/lanip.py`, `apps/ip/interfaces/gui/desktop.py`, `core/config.py`; pruebas nativas/distribución. | P44 completada; contrato de selección de P46; revisar sesión normal frente a instalador elevado y selección de red antes del escaneo. | Alto | Puede iniciar tráfico de red: consentimiento explícito y límites/progreso compartidos. Pendiente. | +| 7 · P54 | Compartir enlaces oficiales entre GUI y comandos CLI/TUI. | `bootstrap/lanctl.py`, `apps/suite/interfaces.py`, `apps/suite/gui.py`, `gui/suite.html`, `suite.js`; servicio de enlaces propuesto; generadores de referencias, `packaging/clink/lanctl.lua` y tests. | No depende de la migración. URLs proporcionadas; no usar shell. Coordinar barra inferior con P53/P52. Antes de la comprobación final de Clink de P48. | Bajo | Añade opciones públicas; conservar las anteriores y salida legible sin soporte de hipervínculos. Pendiente. | +| 8 · P48 | Empaquetar y registrar Clink para el usuario correcto, con desinstalación acotada. | `packaging/clink/lanctl.lua`, `README.md`, `packaging/inno/LANCTL.iss`, `scripts/build-windows.ps1`, `packaging/portable/`, `tests/test_clink.py`, `test_distribution.py`. | P54 para certificar el catálogo final de opciones; instalación puede prepararse antes. Requiere CMD con Clink real y pruebas de actualización, sin registrar en la cuenta administrativa equivocada. | Medio | Afecta PATH/completado y paquetes; no retirar scripts ajenos ni duplicar registros. Pendiente. | +| 9 · P49 | Visor TUI de logs operativo, incremental y acotado, independiente de LANIP. | `apps/monitor/log_stream.py`, `event_view.py`, `interfaces.py`, `bootstrap/lanmon.py`; `core/logger.py`; `apps/ip/interfaces/gui/desktop.py`; pruebas de logs, launcher y terminal. | Reutilizar `LogFollower`, no crear un segundo lector. Definir contrato de origen/sesión que P53 amplía con actividad GUI. Coordinar botón con GUI-DESIGN. | Medio | Debe soportar rotación, pausa, filtros y cierre sin detener tareas; no confundir auditoría VLF con log operativo. Pendiente. | +| 10 · P53 | Trasladar actividad a LANMON preservando origen y retirar el reloj visual. | `gui/suite.js`, `suite.html`; `core/session.py`, `coordination.py`, `logger.py`; `apps/monitor/event_view.py`, `gui_service.py`; pruebas entre procesos. | P49 ofrece visor común. El buffer local de hasta 100 mensajes necesita transporte explícito; no eliminarlo antes de que LANMON reciba esos mensajes. | Alto | Riesgo de perder mensajes o mezclar proyectos. No elimina timestamps ni comandos CLI/TUI. Pendiente, ámbito visual de GUI-DESIGN. | +| 11 · P52 | Preparar reportes revisables y anonimizados desde LANMON. | `core/errors.py`, `logger.py`, `history.py`; servicio de diagnóstico propuesto; `apps/monitor/reports.py`, `gui_service.py`; barra GUI y pruebas de redacción/exportación. | P49/P53 para fuentes/origen compartidos. Servicio de preparación independiente de abrir GitHub; no usarlo como dependencia de red de P50. Agrupar errores sin recursión de notificaciones. | Alto | Maneja datos potencialmente privados; excluir secretos y publicar solo mediante revisión humana. Pendiente. | +| 12 · P51 | Avisar de versiones estables superiores con consultas limitadas y tolerantes a fallos. | `infrastructure/distribution/release.py`, `core/config.py`, `core/session.py`, GUI de ajustes; servicio de consulta propuesto y pruebas de versiones/red/caché. | Reglas de canal existentes; un sufijo histórico no determina por sí solo estabilidad. Separar comparación semántica del nombre del artefacto y del orden de publicación. No requiere P50. | Medio | Arranque, red y preferencias; ningún instalador se descarga ni ejecuta. Sincronizar la versión de la futura entrega antes de publicarla. Pendiente. | +| 13 · P50 | Puente MCP externo de consulta y diagnóstico con contexto explícito. | `core/plugins/api.py`, `contracts.py`, `core/session.py`, `coordination.py`, `session_context.py`, proyectos; plugin/adaptador MCP nuevos; diagnóstico de P52 y pruebas de permisos. | P34 y contrato de sesión/revisión; reutilizar el preparador de P52 sin su navegación GitHub. Definir transporte/autenticación con documentación vigente de los clientes antes de implementar. Control con escrituras queda para una fase posterior. | Alto | Frontera externa: no exponer secretos, confundir datos guardados con cambios en memoria ni elegir arbitrariamente una sesión. Pendiente de diseño de conexión. | +| Cierre de candidato · P32 | Certificar instalación, actualización, portable, Linux ARM64 y acceso remoto. | `.github/workflows/release.yml`, `scripts/build-windows.ps1`, `build-linux.sh`, `tests/portable_smoke.py`, smokes nativos y documentación de validación. | P44 completada; P34 y todos los cambios incluidos en el candidato; identidad de versión/artefactos congelada. Requiere Windows limpio, Linux ARM64 y otro equipo SSH. No exige implementar todas las funciones futuras del backlog. | Alto | Evidencia reproducible por plataforma. Las pruebas locales pueden adelantarse; la certificación externa sigue bloqueada por entornos pendientes. | + +Plan acotado de P44, previo a implementación: reconocer únicamente el objeto +JSON vacío histórico en el lector compartido del registro; migrarlo a esquema 1 +bajo el mismo lock que usan los escritores, mediante sustitución atómica. +Mantener intactos los registros versionados, permisos, firmas y editores. JSON +roto, esquemas desconocidos y documentos no vacíos inválidos seguirán fallando +con su origen. Probar datos nuevos/antiguos, idempotencia, errores de escritura, +concurrencia y arranque LANIP; ejecutar después la suite completa. Si aparece +un bloqueo estructural que exija ampliar el alcance, detener este cambio y +registrar una refactorización con dependencia y estimación antes de continuar. + +Resultado del ciclo: **P44 completada y verificada en fuentes**, sin ampliar el +alcance ni modificar interfaces de GUI-DESIGN. Su dependencia de arranque queda +satisfecha para P34, P46, P47 y P32; estas tareas conservan sus otros requisitos. +No apareció un problema estructural nuevo que obligara a detener P44 y crear +una refactorización. **Siguiente tarea recomendada: P34**, comenzando por validar +revocación, ciclo de vida de runtimes y orden de locks antes de implementar. + +La suite completa pasa con 1.073 pruebas, 643 subpruebas, una omisión POSIX y +cobertura del 68,0842 %. Sigue pendiente el formato de seis archivos de cambios +anteriores, enumerados en la matriz de verificación; debe resolverse antes de +integrar. Los instaladores existentes todavía no incluyen esta migración. ## Prioridad alta: persistencia y fiabilidad -- [ ] Reproducir el fallo de `Ctrl+S` en el TUI y determinar qué cambios no se +- [x] **P01.** Reproducir el fallo de `Ctrl+S` en el TUI y determinar qué cambios no se guardan: configuración, proyecto, inventario o estado de los gestores. -- [ ] Verificar el flujo completo de guardado: detección de cambios, validación, +- [x] **P02.** Verificar el flujo completo de guardado: detección de cambios, validación, escritura transaccional, bloqueo, confirmación visual y recarga posterior. -- [ ] Comprobar el comportamiento de `Ctrl+S` con proyecto activo, sin proyecto, +- [x] **P03.** Comprobar el comportamiento de `Ctrl+S` con proyecto activo, sin proyecto, en cada ventana modal y durante tareas de segundo plano. -- [ ] Revisar la carga de plugins: descubrimiento, dependencias, permisos, +- [x] **P04.** Revisar la carga de plugins: descubrimiento, dependencias, permisos, estados pendiente/activo/fallido, recarga y presentación de errores. +## Incidencia reportada: activación de Wake-on-LAN en la GUI + +- [x] **P05.** Investigar y corregir el flujo de activación de Wake-on-LAN cuando se + conceden los permisos y se autoriza la ejecución `trusted`, pero la GUI + devuelve un error de confianza del editor. + +Estado: **flujo corregido y verificado**. Gravedad: media. El LCP WOL incluido +no lleva firma; se conserva el bloqueo de seguridad y la GUI explica el requisito. +Un LCP firmado permite autorizar al editor seleccionando el paquete original. +Evidencia: captura aportada por el usuario del diálogo «Activar Wake-on-LAN». +La versión instalada y la procedencia/firma del LCP no se pueden determinar +a partir de la captura. + +Secuencia a reproducir: abrir la activación de Wake-on-LAN, marcar +`network.udp`, `functions.register`, `ui-action.register` y «Autorizar ejecución +trusted (requiere editor autorizado)», y pulsar «Activar plugin». + +Mensaje mostrado, con su identificador tal como aparece en la captura: + +```text +el runtime trusted requiere un LCP firmado por un editor confiable; usa plugin publisher trust (0e94E1E397) +``` + +Impacto observado: la activación queda bloqueada y el diálogo remite a un comando +CLI sin completar el flujo de autorización del editor desde esa pantalla. +Referencia para investigar: `PluginManager.enable()` en +`src/lanctl/core/plugins/manager.py`, verificación de firma y almacén de editores +confiables. Se confirmó el bloqueo para paquetes sin firma y para editores no autorizados. +La GUI distingue ambos casos; no se concede confianza al marcar permisos. + +Criterio de aceptación: un paquete firmado por un editor autorizado se activa con +los permisos concedidos; si falta esa confianza o la firma no es válida, la GUI +explica el requisito concreto y los pasos necesarios. La corrección debe conservar +la validación de firmas y añadir regresiones para ambos casos. + +## Plugins: disponibilidad del botón de configuración + +- [x] **P06.** Mostrar el botón de configuración únicamente en los plugins que ofrezcan + opciones configurables. Si el plugin no dispone de ninguna, ocultar el botón + para evitar abrir un panel vacío. + +Criterio de aceptación: comprobar plugins sin opciones y plugins configurables, +incluidos los que todavía usan valores predeterminados y no tienen configuración +guardada. La visibilidad debe depender de las opciones disponibles, no de haber +guardado ajustes previamente, y actualizarse al recargar o actualizar el plugin. + ## Project Manager -- [ ] Permitir guardar manualmente el proyecto seleccionado o activo. -- [ ] Añadir edición de nombre, descripción, autor, LAN, ubicación, empresa y +- [x] **P07.** Permitir guardar manualmente el proyecto seleccionado o activo. +- [x] **P08.** Añadir edición de nombre, descripción, autor, LAN, ubicación, empresa y responsable. -- [ ] Crear formularios modales con cuadros de texto para crear y editar los +- [x] **P09.** Crear formularios modales con cuadros de texto para crear y editar los metadatos del proyecto. -- [ ] Validar los datos antes de escribir y pedir confirmación si existen +- [x] **P10.** Validar los datos antes de escribir y pedir confirmación si existen modificaciones sin guardar. -- [ ] Refrescar el catálogo y la pestaña de información inmediatamente después +- [x] **P11.** Refrescar el catálogo y la pestaña de información inmediatamente después de crear, editar, guardar, activar o eliminar un proyecto. +## Arranque de LANCTL y coordinación de launchers + +Pendientes de revisión incorporados el 15/10/2026: + +- [x] **P12.** Añadir una opción de configuración global y persistente para elegir + **CLI, TUI o GUI como interfaz preferida al iniciar LANCTL sin argumentos**. + Debe aplicarse tanto al doble clic sobre el ejecutable principal como a su + invocación desde una terminal. Los argumentos explícitos deben conservar su + prioridad sobre esta preferencia. Verificar los tres modos en ambos arranques. +- [x] **P13.** Permitir configurar el comportamiento de la GUI principal al abrir un + launcher: **cerrar la GUI de LANCTL** o **mantenerla abierta**. Comprobar que + cerrar la ventana principal no cierre el launcher y que un fallo al abrirlo + mantenga visible el error, sin cerrar prematuramente LANCTL. +- [x] **P14.** Impedir que se abran dos ventanas GUI del mismo launcher. Detectar la + ventana existente, restaurarla si está minimizada y traerla al frente al + solicitar otra apertura. Revisar este comportamiento desde LANCTL, terminal + y doble clic, incluyendo aperturas simultáneas y recuperación después de un + cierre inesperado, para evitar duplicados o bloqueos por instancias obsoletas. +- [x] **P15.** Verificar que **launchers distintos puedan permanecer abiertos al mismo + tiempo** y mantengan comunicación y feedback entre ellos: estado de apertura, + cierre y errores, eventos y actualización de los datos compartidos que les + correspondan. Confirmar que cada interfaz refleje los cambios relevantes sin + reiniciarse, respete el contexto de su proyecto y que cerrar un launcher no + interrumpa los demás. Incluir la GUI de LANCTL cuando se configure para seguir + abierta y probar la coordinación cuando se cierre. + ## Teclado y ayudas visuales -- [ ] Remarcar `→` con fondo blanco en el pie del menú Plugins. -- [ ] Auditar todos los pies de ventanas para encontrar teclas sin el fondo de +- [x] **P16.** Remarcar `→` con fondo blanco en el pie del menú Plugins. +- [x] **P17.** Auditar todos los pies de ventanas para encontrar teclas sin el fondo de tecla correcto, incluyendo flechas, teclas de función, `Supr`, `Enter`, `Esc` y combinaciones `Ctrl+…`. -- [ ] Revisar el editor de asignaciones: conflictos, teclas reservadas, +- [x] **P18.** Revisar el editor de asignaciones: conflictos, teclas reservadas, desactivación con `None`, persistencia y restauración de valores iniciales. -- [ ] Verificar por separado qué atajos están activos y cuáles son visibles en +- [x] **P19.** Verificar por separado qué atajos están activos y cuáles son visibles en la barra inferior. -- [ ] Comprobar que los atajos locales de una ventana no se ejecuten fuera de +- [x] **P20.** Comprobar que los atajos locales de una ventana no se ejecuten fuera de ella. ## Consola integrada del TUI -- [ ] Añadir más mensajes útiles sobre inicio y final de tareas, resultados, +- [x] **P21.** Añadir más mensajes útiles sobre inicio y final de tareas, resultados, guardado, recarga, cambios pendientes y errores recuperables. -- [ ] Mantener los mensajes breves, con nivel y origen coherentes y sin desplazar +- [x] **P22.** Mantener los mensajes breves, con nivel y origen coherentes y sin desplazar innecesariamente la tabla principal. -- [ ] Revisar el historial, el límite de líneas y el ajuste al ancho disponible. +- [x] **P23.** Revisar el historial, el límite de líneas y el ajuste al ancho disponible. ## Revisión estética general -- [ ] Auditar bordes, títulos, pestañas, separadores, colores de fondo, +- [x] **P24.** Auditar bordes, títulos, pestañas, separadores, colores de fondo, alineación y recorte en todos los overlays. -- [ ] Probar tamaños de terminal pequeños, medios y muy grandes, además de +- [x] **P25.** Probar tamaños de terminal pequeños, medios y muy grandes, además de cambios de tamaño mientras el TUI está abierto. -- [ ] Verificar que las ventanas modales oculten correctamente las líneas del +- [x] **P26.** Verificar que las ventanas modales oculten correctamente las líneas del fondo y que el renderizado diferencial no deje residuos ni produzca parpadeo. -- [ ] Unificar el estilo de selección, campos editables, cambios pendientes, +- [x] **P27.** Unificar el estilo de selección, campos editables, cambios pendientes, estados deshabilitados y mensajes de confirmación. +### GUI: disposición y recorte de la barra inferior + +Estado: **corrección validada en navegador** el 15/10/2026. Se conserva la +corrección de interfaz que el usuario indicó en curso el 14/10/2026: pruebas con +50 proyectos/plugins, desplazamiento y ventanas de 790×570, 660×460 y 375×650. + +Evidencia: dos capturas de la vista de proyectos; la primera muestra la barra +inferior con plugins, CLI, Actividad y Sistema, y en la segunda esa barra no +queda visible dentro de la ventana. La primera captura muestra la versión 0.3.3. + +- [x] **P28.** Validar la corrección que ya está en marcha: la barra y sus controles + deben permanecer visibles y accesibles al redimensionar la ventana y desplazar + la lista de proyectos, sin recortes ni superposiciones. + ## Auditoría técnica -- [ ] Revisar concurrencia, bloqueos de archivos y escrituras simultáneas entre +- [x] **P29.** Revisar concurrencia, bloqueos de archivos y escrituras simultáneas entre TUI, CLI, backend y plugins. -- [ ] Revisar tareas de segundo plano, cancelación, cierre seguro y liberación +- [x] **P30.** Revisar tareas de segundo plano, cancelación, cierre seguro y liberación de recursos. -- [ ] Confirmar que errores, eventos, logs y puntos de extensión del core se +- [x] **P31.** Confirmar que errores, eventos, logs y puntos de extensión del core se emitan de forma coherente en todos los flujos anteriores. -- [ ] Ejecutar pruebas de regresión en Windows instalado, Windows portable, +- [ ] **P32.** Ejecutar pruebas de regresión en Windows instalado, Windows portable, Linux ARM64 y acceso remoto. -- [ ] Registrar durante la revisión cualquier hallazgo técnico adicional con + Windows instalado/portable y Linux amd64/arm64 verificados por el workflow + manual 39069158807 (`2b8494a`); pendiente repetir para P45/P48 y certificar + acceso desde otro equipo, sin confundirlo con las pruebas TLS/SSH locales. +- [x] **P33.** Registrar durante la revisión cualquier hallazgo técnico adicional con pasos de reproducción, impacto y prueba de aceptación. + +## Validación que sigue pendiente + +P32 permanece abierto: instalación/actualización/desinstalación en Windows +limpio, Linux ARM64 y acceso SSH desde otra máquina. Las pruebas locales y los +smokes de GUI no sustituyen esas comprobaciones. La matriz registra el alcance +exacto de cada prueba y los hallazgos corregidos. + +## Próxima revisión: pendientes añadidos el 16/10/2026 + +Estado actualizado el **16/10/2026**. Los avances de GUI-DESIGN y AUDITOR se +indican por separado; las comprobaciones de backend se amplían en +[la matriz de verificación](BACKLOG-VERIFICATION.md). + +- [ ] **P34.** Revisar el estado actual de los plugins y comprobar que su estado + real se corresponda con el que muestra la interfaz. Esta nueva revisión + complementa las comprobaciones anteriores de P04, P05 y P06. + **Parcial — AUDITOR:** corregidas integridad y firma al activar/verificar, + restauración segura al arrancar, dependencias, limpieza de runtimes, + cuarentena persistente y escrituras concurrentes. Falta la propagación + inmediata de cambios y revocaciones a todos los runtimes e interfaces ya + abiertos; las operaciones con una revisión antigua se rechazan y piden recarga. + Verificación final: 43 regresiones nuevas; suite completa con 1.013 pruebas y + 643 subpruebas aprobadas, 1 omisión POSIX y cobertura del 67,83 %. +- [x] **P35.** Revisar el feedback del sistema de temas y paletas de colores: + comprobar cómo se reflejan los cambios seleccionados en la interfaz y en los + ajustes guardados. Definir y añadir opciones básicas de configuración de la + GUI; las opciones concretas quedan por determinar en esa revisión. +- [x] **P36.** Al crear un proyecto, rellenar automáticamente el campo de carpeta + de guardado con la ruta predeterminada. Permitir que el usuario la edite o + seleccione otra carpeta si lo desea, sin exigir una selección manual para + aceptar la ubicación predeterminada. + +## Observaciones de GUI del 16/10/2026 + +- [x] **P37.** Ajustar Inicio al área útil inicial, incluyendo escalado de Windows, + para mostrar los cinco launchers completos sin scroll. Mantener cabecera y pie + visibles al redimensionar. +- [x] **P38.** Completar Configuración GUI con las opciones de programa y proyecto + agrupadas por temas, reutilizando el catálogo y las validaciones compartidas + del CLI. Diferenciar campos editables y automáticos y comprobar persistencia. +- [x] **P39.** Hacer que la terminal integrada ocupe el espacio disponible al + redimensionar; solo la salida debe desplazarse, con entrada y pie visibles. +- [ ] **P40.** Revisar con AUDITOR el diálogo de permisos de plugins y el bloqueo + por firma no válida (mDNS + SSDP Discovery). Distinguir permisos, firma y + confianza del editor; relacionado con P34/P05. No asumir fallo del backend + ni retirar validaciones de seguridad. Anotación enviada a AUDITOR. + **Parcial — AUDITOR:** confirmado que los LCP incluidos de mDNS/SSDP y WOL + carecen de firma; el bloqueo es correcto. Corregidos fallos independientes del + backend de validación, estado y persistencia, con regresiones. Sigue pendiente + distribuir LCP firmados por el editor del proyecto y verificar su instalación + real. P42 conserva la evidencia del mismo caso; no es una incidencia adicional. +- [x] **P41.** Ampliar P36: proponer valores iniciales editables para metadatos + técnicos de proyectos, especialmente LAN, sin copiar datos privados del + proyecto anterior ni sobrescribir VLF existentes. + +La confirmación de cambios sin guardar de LANCTL utiliza ahora un diálogo +propio con botón principal verde lima, en lugar del aviso «Esta página dice». +- [ ] **P42.** Seguimiento de P40: revisar permisos y firmas de plugins a partir del + bloqueo reportado al activar **LANCTL mDNS + SSDP Discovery**. Relacionado con + P34 y con el antecedente de Wake-on-LAN de P05. + + Evidencia reportada: captura del 16/10/2026 del diálogo «Activar LANCTL mDNS + + SSDP Discovery», que muestra los permisos `scanner.register`, + `functions.register` y `network.scan`. El diálogo informa de que el paquete + no tiene una firma válida, solicita un LCP firmado y no permite activarlo. + La captura por sí sola no demuestra un fallo del backend: el bloqueo de este + paquete sin firma es correcto. La auditoría posterior encontró y corrigió + otros fallos de integridad, activación y persistencia, registrados en la matriz. + + Revisión técnica realizada: permisos solicitados/concedidos, autorización + del runtime `trusted`, validez de la firma y confianza del editor. La firma de + los cuatro plugins `trusted` del catálogo sigue pendiente de distribución; + no se ha generado ni autorizado una identidad oficial durante la auditoría. + + +Implementación GUI del 16/10/2026: P36/P37/P38/P39/P41 completados con +validación local de catálogo compartido, persistencia y distribución a tamaños +790×570, 960×590, 660×460 y 1440×900. P40/P42: el flujo gráfico ahora permite +instalar una versión firmada verificada sin recurrir a comandos; la auditoría +de la distribución/firma de los paquetes sigue separada. No se autoriza un +paquete sin firma por marcar sus permisos. + +## Errores reportados en el chat — 16/10/2026 + +- [x] **P43.** Corregir la excepción no controlada al inicializar un icono + mediante `System.Drawing.Icon.Initialize(Int32 width, Int32 height)`. + **Corregido y verificado localmente — AUDITOR, 16/10/2026. Gravedad alta:** + LANCTL y LANIP pasaban un PNG a `webview.start(icon=...)`; el backend WinForms + lo entregaba directamente a `System.Drawing.Icon`, que exige un ICO. Los dos + PNG reproducen exactamente la excepción reportada. Se selecciona ahora el + ICO incluido en Windows y se conserva el PNG en las otras plataformas. + + Evidencia aportada por el usuario (traza íntegra): + + ```text + Excepción no controlada: System.ArgumentException: El argumento 'picture' debe ser una imagen que puede utilizarse como Icon. + en System.Drawing.Icon.Initialize(Int32 width, Int32 height) + --- Fin del seguimiento de la pila de la ubicación anterior donde se produjo la excepción --- + en System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw() + en Python.Runtime.PythonException.ThrowLastAsClrException() + en Python.Runtime.Dispatcher.TrueDispatch(Object[] args) + en Python.Runtime.Dispatcher.Dispatch(Object[] args) + en __System_Threading_ThreadStartDispatcher.Invoke() + en System.Threading.ExecutionContext.RunInternal(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx) + en System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state, Boolean preserveSyncCtx) + en System.Threading.ExecutionContext.Run(ExecutionContext executionContext, ContextCallback callback, Object state) + en System.Threading.ThreadHelper.ThreadStart() + ``` + + Verificación inicial: 16 regresiones (ocho fallaban antes de la corrección), constructor + real de .NET, rutas de fuentes y extracción PyInstaller, ventanas nativas y + ejecutables nuevos de LANCTL/LANIP con HICON. Suite completa sobre una copia + de `a6fadc8` más la corrección: 1.029 pruebas y 643 subpruebas aprobadas; + una prueba POSIX omitida en Windows. Se conservan las firmas existentes y + los contratos del Core. Catálogo de errores regenerado y comprobado. + + Durante la revisión, el adaptador nuevo `suite/launcher_gui.py` de GUI-DESIGN + introdujo la misma llamada con PNG. Corregidos únicamente su importación y + selección de icono. Ocho regresiones adicionales reproducen la excepción y + pasan después para LANWIRE/LANRACK/LANACCESS/LANMON: **24 regresiones de P43 + aprobadas** en el árbol compartido. Sus nuevas interfaces siguen bajo + GUI-DESIGN y no forman parte de los ejecutables aislados de esta revisión. + + Los artefactos de prueba están en `dist/p43-verified/`, incluido + `LANCTL-0.3.3-p43-setup.exe`. Se han separado del desarrollo concurrente de + GUI-DESIGN; no se ha actualizado la instalación del usuario. La prueba de + arranque empaquetado de LANIP requiere un registro de plugins válido por P44. + Detalle y límites en `docs/BACKLOG-VERIFICATION.md`. + +- [x] **P44.** Corregir la inicialización del registro de plugins y migrar el vacío histórico. + **Completada y verificada en fuentes — 16/10/2026. Gravedad alta.** Detectado al verificar P43: + `ensure_data_layout()` creaba `plugins/registry.json` con `{}`, pero + `PluginManager._read_registry()` exige `schemaVersion: 1` y un objeto `plugins`. + La GUI de LANIP muestra «registro de plugins no válido»; el ejecutable puede + terminar con código 2 antes de abrirla. Es independiente del formato del icono. + GUI-DESIGN corrigió la plantilla de creación a `{"schemaVersion": 1, "plugins": {}}`. + AUDITOR comprobó con datos temporales nuevos que ese documento se crea y + `PluginManager` inicia correctamente. La validación de permisos y firmas no + se ha relajado. El instalador aislado de P43 es anterior a este ajuste. + + El lector compartido migra ahora exclusivamente el objeto JSON vacío `{}` + al esquema 1 mediante escritura atómica y bajo el lock del registro. No + reescribe documentos versionados ni concede permisos, confianza o ejecución. + Los documentos corruptos, no vacíos sin esquema o de versión desconocida + siguen fallando con su origen; un fallo de escritura conserva el original. + + Verificación: 18 regresiones nuevas (seis fallaban antes), 87 pruebas + relacionadas y 17 subpruebas aprobadas; arranque y recorrido nativo completo + de LANIP con `{}` en datos temporales. Suite completa: 1.073 pruebas y 643 + subpruebas aprobadas, una omisión POSIX, cobertura del 68,0842 %. Conservadas + las 37 firmas de funciones/métodos del gestor, sus eventos y 51 IDs/orígenes + de error. Desbloqueadas las comprobaciones con datos antiguos de P34/P32 y + satisfecha la dependencia de arranque de P46/P47. La reconstrucción y + certificación de instaladores sigue dentro de la entrega/P32. + +## Configuración inicial del instalador — 16/10/2026 + +- [x] **P45.** Añadir una selección de cinco temas durante la instalación, con + nombre y vista previa. Guardar la elección mediante la configuración compartida + del programa y conservar el tema existente en actualizaciones, salvo cambio + explícito del usuario. + **Reabierta por reporte visual — 17/10/2026.** En el instalador + «LANCTL GUI experimental (NO ESTABLE) version 0.3.4-alpha.1», página + «Apariencia inicial», no se ven las imágenes de ejemplo de los temas. + La captura aportada muestra las cinco opciones y «Bosque» seleccionado, + pero el área de vista previa aparece vacía, con el texto «LANCTL · Vista + previa de fondo y acento» apenas legible. Resultado esperado: mostrar una + imagen representativa del aspecto del programa y actualizarla al cambiar + de tema. Pendiente de diagnóstico: comprobar generación, inclusión y carga + de los recursos en el instalador compilado, así como contraste y renderizado + del control. Validar visualmente las cinco opciones en el Setup distribuido; + la implementación en fuentes no cierra este fallo observado en el instalador. + **Corregida y comprobada — 17/10/2026.** El instalador usa cinco capturas + reales del GUI con las paletas del Core, incluidas y extraídas como BMP, + en lugar de paneles de color. Pasan 16 pruebas de recursos/distribución. + El usuario abrió el Setup actualizado y confirmó que las cinco imágenes + son distintas y se ven completas: «Sí, las cinco se ven bien». La captura + automatizada de la ventana elevada no estuvo disponible; la evidencia visual + corresponde a esa comprobación humana. Se conserva el contrato de preferencias. +- [x] **P46.** Permitir elegir si se instalan los plugins predeterminados del + programa, con selección individual opcional. Adaptar el empaquetado y el primer + inicio para respetar la elección, distinguir los recursos necesarios (como el + tema base) de los plugins opcionales y conservar permisos, firmas y confianza + del editor. Mantener las elecciones existentes al actualizar. +- [ ] **P47.** Ofrecer al finalizar la instalación las opciones «Abrir LANIP» y + «Realizar un primer escaneo». Arrancar la GUI con el usuario normal, mostrar la + red detectada y permitir seleccionar interfaz/rango cuando haya varias redes; + mostrar el progreso del escaneo en la GUI y ejecutarlo solo si se ha elegido. + **Implementado y probado:** selector con máscara real, origen ICMP/ARP, + progreso y reintento conservando la petición tras fallo. Queda completar + REF-P47-interface y verificar varias NIC reales. +- [ ] **P48.** Corregir la distribución del completado Clink: incluir + `packaging/clink/lanctl.lua` y sus instrucciones en el instalador Windows y en + el ZIP portable. Detectar Clink y registrar automáticamente la carpeta de + scripts con `clink installscripts` para el usuario correspondiente, tanto en + la instalación como en el flujo de preparación del portable. Evitar registros + duplicados al actualizar y retirar el registro de la instalación al + desinstalar, sin afectar otras carpetas de Clink. Verificar el contenido de + ambos paquetes y el completado real de los seis ejecutables en CMD con Clink; + mantener la validación del Lua frente a los parsers de la versión distribuida. + **Implementado y probado:** CMD/Clink 1.9.34 real, seis launchers, registro + repetido, retirada y rutas con espacios/acentos; corregida decodificación UTF-8. + Resta la desinstalación elevada realizada desde otra cuenta. + +## Monitorización simultánea con LANIP — 16/10/2026 + +- [x] **P49.** Añadir a LANMON una TUI de logs en tiempo real que pueda + permanecer abierta en una terminal mientras se controla y modifica el + inventario desde la GUI de LANIP. Reutilizar el seguimiento incremental del + log común, con actualización automática, colores por nivel, filtros, pausa + y navegación del historial; conservar el origen de los eventos y limitar el + uso de memoria. Añadir un botón en la GUI de LANIP para abrir este visor en + otra terminal, tanto desde fuentes como desde los ejecutables instalados y + portables. Cerrar el visor no debe cerrar LANIP ni interrumpir sus tareas. + Distinguir el log operativo de las auditorías VLF y explicitar su cobertura; + verificar que las operaciones registradas desde la GUI aparecen en directo. + +## Puente externo MCP con ChatGPT y Codex — 16/10/2026 + +- [ ] **P50.** Diseñar e implementar un plugin puente externo MCP usable desde + ChatGPT y Codex, sin incorporar un chat dentro de LANCTL. Exponer herramientas + estructuradas para consultar proyectos, inventario, tareas y errores mediante + lenguaje natural. Detectar las sesiones y el proyecto abierto; si hay varias + sesiones o proyectos, permitir seleccionar explícitamente el contexto. + Consultar el estado de trabajo de la sesión, incluidos los cambios sin guardar, + distinguiéndolos de los datos persistidos en el VLF sin forzar su guardado. + Contemplar cambios de proyecto, cierre de sesión y revisiones del estado para + evitar presentar datos obsoletos como actuales. Definir y verificar la conexión + externa y autenticación correspondientes para ChatGPT y Codex. + La primera fase será de consulta + y diagnóstico, incluyendo la preparación de borradores de incidencias con + versión, origen, contexto y evidencia seleccionada, revisables y exportables + por el usuario. No incluir conexión, sincronización ni publicación en GitHub. + Definir contratos versionados y permisos por capacidad. Excluir + credenciales de las respuestas y permitir seleccionar o anonimizar los datos + incluidos en informes. Ampliar después el control por lenguaje natural con + operaciones validadas por los servicios compartidos del Core, respetando + transacciones, bloqueos, auditoría y coordinación con las interfaces abiertas. + +## Avisos de actualizaciones estables — 16/10/2026 + +- [x] **P51.** Añadir una comprobación de actualizaciones en las Releases del + repositorio oficial de GitHub, con aviso automático en segundo plano y botón + «Buscar actualizaciones» en ajustes. Ofrecer únicamente versiones estables + publicadas superiores a la instalada; excluir borradores y prereleases y + determinar la estabilidad por el canal de publicación, respetando las reglas + de `stable/VERSION` incluso cuando exista un sufijo histórico. Comparar + versiones semánticamente, sin confundir orden de publicación con versión + superior. Mostrar versión instalada/disponible, novedades y enlace de descarga, + con opción de recordar más tarde. Limitar las comprobaciones automáticas + (como máximo una al día), sin bloquear el arranque ni el uso si falla la red. + No descargar, ejecutar instaladores ni instalar actualizaciones automáticamente. + +## Reportes de errores desde LANMON — 16/10/2026 + +- [x] **P52.** Centralizar en LANMON la recopilación y preparación de reportes + de errores. Al detectar un error, mostrar una ventana emergente con resumen + y acciones para ver detalles, preparar el reporte o cerrar; agrupar errores + repetidos para evitar una sucesión de ventanas. Añadir en la barra inferior + de información de las GUI un botón de texto «Report a bug», con el mismo + estilo y comportamiento visual que el botón «CLI», que permita informar + también de problemas sin error registrado. Ambas entradas abrirán el mismo + flujo de reporte gestionado por LANMON. + Preparar un borrador editable con descripción, pasos de reproducción, + resultado esperado, versión de LANCTL y del sistema, aplicación/interfaz, + código y origen del error, fecha, sesión/tarea relacionada, versiones de + plugins y fragmentos de logs pertinentes. Mostrar una vista previa de los + datos y logs antes de abrir el formulario de incidencias del repositorio + oficial en GitHub, con selección/exclusión de datos y anonimización de + información privada; excluir credenciales y no adjuntar proyectos completos + por defecto. Abrir el formulario con el resumen rellenado y permitir exportar + un diagnóstico adjuntable para logs extensos; el usuario revisará y publicará + la incidencia en GitHub. Mantener esta función independiente del puente MCP + de P50, que continúa sin conexión con GitHub. + +## Barra inferior y actividad centralizada en LANMON — 16/10/2026 + +- [x] **P53.** Retirar la fecha y hora (TIME/DATE) de la barra inferior de + información de la GUI de LANCTL mostrada por el usuario. Trasladar el visor + «Actividad» de esa barra al launcher LANMON, conservando el acceso a los + mensajes de actividad de LANCTL. Actualmente son mensajes locales en memoria + de la GUI (hasta 100), distintos del historial compartido y de los eventos de + monitorización que ya muestra LANMON: definir su transporte y conservación + para que el traslado no pierda información ni mezcle sus orígenes. + Coordinar el visor con P49. Revisar el impacto en las interfaces CLI/TUI y + conservar sus comandos, consultas de logs e historial y contratos públicos; + retirar el reloj visual no elimina las marcas de tiempo de los registros. + Verificar actividad entre procesos, selección de proyecto/sesión y cierre de + ventanas, además de las regresiones relacionadas de GUI, CLI y TUI. + +- [x] **P54.** Añadir accesos de texto «Web», «GitHub» y «Referencia» a la + barra inferior de información de LANCTL, con estilo coherente con «CLI», + apertura en el navegador del sistema y distribución adaptable al ancho. + Exponer también `lanctl -web`, `lanctl -github` y `lanctl -reference`, + utilizables desde terminal y las consolas CLI/TUI, para abrir respectivamente + `https://cctrgy.github.io/lanctl/`, `https://github.com/CctrGy/LANCTL` y + `https://cctrgy.github.io/lanctl/reference/`. Mostrar asimismo la URL completa + en la salida, clicable con el ratón en terminales compatibles mediante + hipervínculos de terminal y/o su detección nativa de URLs; mantener texto + legible en terminales sin soporte y en salida redirigida. Compartir las rutas + entre GUI y CLI/TUI, verificar el comportamiento desde los ejecutables + instalados y portables y actualizar ayuda, referencias CLI/web y completado + Clink al incorporar estas opciones. + +## Correcciones visuales de Topología LANWIRE — 17/10/2026 + +Implementadas en fuentes el 17/10/2026. La evidencia de comprobación y +sus límites se documentan en `docs/BACKLOG-VERIFICATION.md`. + +- [x] **P55.** Sustituir la distribución en cuadrícula de los elementos + conectados por una organización automática basada en sus conexiones reales. + Evaluar un trazado jerárquico o de grafos por componentes que reduzca cruces, + solapamientos y recorridos innecesarios, respete tamaños y puertos de cada + equipo y maneje ramificaciones y ciclos. Reservar la cuadrícula para los + elementos sin conexiones establecidas, separados del conjunto conectado. + Conservar el movimiento manual y permitir reorganizar explícitamente. + Validar con router, switches, paneles, tomas y suministro externo, además de + componentes independientes: ningún equipo debe quedar tapado y las + conexiones deben poder seguirse visualmente. No prometer un óptimo global: + priorizar una distribución legible y reproducible. + +- [x] **P56.** Corregir el anclaje visual de los cables a los elementos y sus + puertos. En la captura del «Switch Rack» la línea termina fuera de la tarjeta, + dejando un hueco en lugar de llegar a la conexión correspondiente. Revisar + coordenadas, dimensiones y capas al desplazar nodos, aplicar zoom, redimensionar + la ventana o desplazar la lista interna de puertos. Cuando el puerto quede + oculto, mostrar un anclaje de borde identificable sin dejar extremos flotantes. + Verificar también varios cables por equipo y enlaces seleccionados. + +- [x] **P57.** Mejorar las etiquetas de los cables en Topología: el trazado + no debe atravesar el nombre ni los extremos mostrados. Separar texto y línea, + usar fondo/contraste acorde con grafito y lima y evitar colisiones con nodos + y otras etiquetas. Mantener legibilidad según el zoom; si se abrevia el texto, + permitir consultar el nombre y los extremos completos al señalar o seleccionar + el cable. Comprobar nombres largos, cables próximos y distintos niveles de zoom. + +- [x] **P58.** Optimizar automáticamente la distribución visual de los puertos + de los switches. Adaptar filas, columnas, separación y tamaño de la tarjeta + al número de puertos y a sus conexiones, coordinándolo con P55/P56 para + facilitar el seguimiento de los cables y reducir cruces. Mantener etiquetas + legibles y distinguir puertos libres y ocupados, sin cambiar sus nombres, + numeración, identidad ni conexiones almacenadas por reorganizar su dibujo. + Comprobar switches de 5, 12, 24 y 48 puertos, con distintas ocupaciones, + tamaños de ventana y niveles de zoom; evitar recortes y scroll interno que + oculte los puntos de conexión cuando sea posible. + +- [x] **P59.** Trasladar la acción de conectar cables a la ventana de datos del + propio elemento, en la pestaña de puertos/conexiones. Pulsar un puerto en el + lienzo de Topología no debe sugerir ni iniciar una conexión: debe conservar + la interacción de selección del elemento, y el doble clic abrir sus datos. + Desde esa ventana se elegirá explícitamente el puerto y el cable compatible, + mostrando ocupación y extremos existentes. Mantener las validaciones reales + de compatibilidad y disponibilidad. Verificar que seleccionar, arrastrar y + abrir un elemento desde el área de sus puertos no abra formularios de conexión + inesperados ni cambie enlaces; comprobar el flujo de conexión desde sus datos. + +- [x] **P60.** Representar los racks como contenedores de ubicación y filtros + de Topología, sin dibujarlos como equipos de red independientes. Agrupar + visualmente dentro de cada rack los elementos que ya tengan esa ubicación; + distinguir los equipos sin rack asignado. Ofrecer «Todos los racks», selección + de un rack y «Sin rack», manteniendo su registro editable en el inventario. + Coordinar la distribución automática de P55 con las fronteras visuales de + los contenedores para que no coloque fuera de ellos los equipos que contienen. + +- [x] **P61.** Conservar y representar las conexiones entre equipos de distintos + racks: la pertenencia física no limita la conectividad ni convierte el rack + en extremo del cable. En la vista global, dibujar los enlaces cruzando los + límites de sus contenedores y anclados a los puertos reales. Al filtrar un rack, + señalar las conexiones salientes y su destino externo, con acceso para + centrar/ver el equipo o rack de destino; no ocultarlas silenciosamente ni + presentar un enlace existente como desconectado. Comprobar dos o más racks, + equipos sin rack, enlaces internos y entre racks, filtros y zoom, sin alterar + ubicaciones o conexiones almacenadas. Coordinar con P55, P56 y P60. + +- [x] **P62.** Añadir dos niveles de visualización de Topología: «Interior del + rack» y «Vista general de racks». La vista interior muestra los equipos, + puertos y cables del rack elegido, conservando sus conexiones salientes (P61). + La exterior representa cada rack como un contenedor contraído con su nombre + o identificador (A, B, C…), y muestra sus enlaces hacia otros racks, equipos + externos o suministros, siguiendo el esquema aportado por el usuario. + Los puntos de entrada/salida del contenedor resumen extremos reales de sus + equipos: no crean puertos físicos ni conexiones propias del rack. Los enlaces + internos quedan disponibles al entrar en él. Permitir entrar mediante doble + clic o acción explícita y volver a la vista general conservando posición, + zoom y filtros; mostrar claramente el nivel y rack actuales. Ambas vistas + deben representar el mismo inventario cargado, sin duplicar registros. + +- [x] **P63.** Hacer legible la vista general con numerosos racks y conexiones + en malla. El trazado debe admitir ciclos, enlaces paralelos y múltiples + destinos, sin imponer una estructura de árbol ni reducirla a cinco líneas. + Ofrecer agrupación visual desplegable de cables entre los mismos contenedores, + indicando su cantidad y permitiendo consultar cada cable y sus extremos. + Distinguir medios como fibra y cobre mediante etiquetas/leyenda además del + color, y permitir filtrar, buscar, enfocar un rack y resaltar sus conexiones. + Coordinar distribución, rutas y etiquetas con P55/P57/P60/P61/P62; mantener + zoom, desplazamiento y minimapa para instalaciones grandes. Verificar racks + A–G y escenarios de mayor tamaño, conexiones cruzadas, paralelas y salidas + externas, sin perder ni inventar enlaces al agrupar, filtrar o cambiar de nivel. + +Ámbito implementado: `gui/wire-gui.js`, `gui/physical-gui.js`, +`gui/launcher.css` y pruebas de interacción de LANWIRE/LANRACK. Mantener la estética actual y los datos y contratos del inventario. + +## Agrupación de armarios por CPD en LANRACK — 17/10/2026 + +Implementado en fuentes el 17/10/2026; comparte el inventario físico con LANWIRE. + +- [x] **P64.** Incorporar en LANRACK la entidad CPD, como sala o conjunto con + nombre propio que contiene uno o varios armarios rack. Permitir crear, + consultar y editar el nombre, descripción y ubicación del CPD, asignar o + retirar racks y trasladarlos entre CPD. Distinguir los racks sin CPD asignado. + Cada rack tendrá como máximo un CPD físico; conservar su identidad, equipos, + unidades y conexiones al cambiar la agrupación. Retirar un rack del grupo o + eliminar el CPD no debe borrar armarios ni su contenido; ofrecer conservarlos + sin asignación o trasladarlos. La creación puede prepararse sin racks, pero + debe mostrar expresamente que el CPD está vacío. + +- [x] **P65.** Utilizar la agrupación por CPD en las visualizaciones de LANRACK: + lista de armarios agrupable y filtrable por CPD, vista general de la sala con + sus armarios y vista detallada de cada rack con sus unidades y equipos. + Permitir navegar CPD → rack → equipo y volver conservando el contexto, con + búsqueda por nombre de CPD o rack y resumen de armarios, capacidad y ocupación + calculado desde los datos reales. Mantener nombres naturales y la estética + actual. Acordar los formatos visuales adicionales antes de implementarlos. + +LANRACK será responsable de gestionar esta organización física; reutilizar el +inventario y los servicios compartidos para que LANWIRE pueda reflejarla sin +mantener grupos duplicados. Coordinar con P60–P63, conservando las conexiones +entre racks y entre CPD. Antes de persistir el nuevo modelo, definir esquema +versionado, validación y migración compatible de los racks existentes, que +seguirán disponibles sin CPD asignado. Comprobar CPD con uno y varios racks, +nombres repetidos con identificadores distintos, cambios de pertenencia y +conservación de equipos y enlaces. La migración conserva los registros existentes y no modifica conexiones. + +## Dimensiones de armarios rack — 17/10/2026 + +- [x] **P66.** Corregir la altura de los armarios rack para admitir únicamente + valores enteros entre **4 y 52 U**, ambos incluidos; rechazar cualquier valor + fuera del rango en creación y edición mediante validación compartida. Añadir + como propiedad independiente de cada rack el **ancho de montaje en pulgadas**, + limitado a **10, 19, 21 o 23**. Ambas dimensiones serán editables en **LANRACK** + y visibles como datos en **LANWIRE**, con representación coherente en **GUI y + TUI**. No confundir el ancho físico con la anchura visual de paneles o columnas. + Persistirlas en el inventario físico compartido y el proyecto, sin duplicar + datos por launcher; coordinar con P60–P65. Definir esquema versionado y + tratamiento compatible de racks existentes sin ancho o con alturas fuera + del nuevo rango: señalar los casos que requieran corrección, sin truncar, + asignar dimensiones ni eliminar equipos silenciosamente. Impedir reducir + la altura si deja equipos fuera del armario y conservar ubicaciones y enlaces. + Verificar los límites 4/52 U, el rechazo de 3/53 U y valores no enteros, las + cuatro anchuras admitidas y el rechazo de otras medidas; comprobar guardado, + reapertura y consistencia entre launchers e interfaces. + + +## Frentes de equipos en LANRACK — 17/10/2026 + +- [x] **P66.** Superponer skins vectoriales genéricas en la elevación del rack: + switches rackmount y de sobremesa, combinaciones RJ45/SFP, paneles, + servidores, SAI, routers, bandejas y paneles ciegos. Catálogo de 30 plantillas + y frente personalizado con vista previa, altura, montaje y conectores. + Guardar apariencia versionada sin inventar puertos ni alterar conexiones; + validar ocupación de varias U, traslados desde LANWIRE y límites del rack. + Mantener vista simple, tamaño ajustable y estética grafito/lima. + Implementado en fuentes; comprobaciones en `docs/BACKLOG-VERIFICATION.md`. + + +## Actualizaciones de herramientas propuestas por Dependabot — 17/10/2026 + +Estas ramas son propuestas automáticas de mantenimiento de dependencias Python +(`pip`), dirigidas a `main`. Los números corresponden a las herramientas, no a +versiones de LANCTL. En la revisión del 17/10/2026 ambas pull requests están +abiertas y pendientes de integración; cada una modifica únicamente su versión +fijada en el grupo opcional `dev` de `pyproject.toml`. + +- [x] **P67.** Revisar e integrar, si supera las comprobaciones, la actualización + de **Coverage 7.10.6 → 7.16.2**, propuesta en la rama + `dependabot/pip/coverage-7.16.2` mediante la + [PR #23](https://github.com/CctrGy/LANCTL/pull/23). Coverage mide las líneas y + ramas de código ejercitadas por las pruebas. Ejecutar la suite con cobertura, + comparar los resultados y revisar posibles diferencias en su cálculo, sin + rebajar el umbral exigido para aceptar la actualización. + +- [x] **P68.** Revisar e integrar, si supera las comprobaciones, la actualización + de **Ruff 0.16.2 → 0.17.0**, propuesta en la rama + `dependabot/pip/ruff-0.17.0` mediante la + [PR #25](https://github.com/CctrGy/LANCTL/pull/25). Ruff realiza análisis + estático y comprueba el formato de Python. Revisar sus cambios incompatibles, + ejecutar `ruff check` y `ruff format --check` con la versión propuesta y + evaluar cualquier modificación necesaria conservando la compatibilidad con + las versiones Python admitidas por el proyecto. + +P67/P68 validadas e incorporadas a las fuentes de la rama de trabajo: Python +3.10, reglas y umbral conservados; 483 archivos con formato correcto. Las dos +suites de Coverage pasan 1.208 pruebas y 645 subpruebas cada una, con un caso +POSIX omitido en Windows y 21 pruebas GUI heredadas excluidas por la política +existente. Ambas miden 69,3568 %: mismos contadores de líneas y ramas. Las PR +remotas permanecen sin fusionar y la integración en `main` sigue su revisión. + +Son herramientas de desarrollo y CI: estas propuestas no añaden funciones al +programa, no representan versiones instalables alternativas y no cambian por sí +solas el número de versión de LANCTL. La integración se realizará en `main` +cuando se valide cada propuesta; las ramas estables, tags e instaladores ya +publicados conservarán su contenido original. + + +## Cierre de interfaz coordinado — 17/10/2026 + +P35, P46, P49, P51–P54 y P66 «Dimensiones» quedan implementados y +verificados localmente junto con sus adaptadores de escritorio. La evidencia +está en `docs/BACKLOG-VERIFICATION.md`. P45 tiene imágenes reales incorporadas; +el usuario comprobó las cinco opciones en Setup y confirmó que se ven completas +y distintas. La revisión visual es humana, sin captura automatizada. P47 enlaza +ICMP/ARP a interfaz/CIDR real y conserva el reintento; faltan otros transportes +y certificación con varias NIC. P48 ya pasa con CMD/Clink real y conserva la +certificación de desinstalación por otra cuenta. P32 registra la instalación +limpia de Windows y Linux amd64/arm64 por commit; el acceso externo sigue abierto. +P34, P40/P42 y P50 no se consideran completados por estas mejoras visuales: +AUDITOR continúa su trabajo interno por separado tras el paquete comprobado. +Los puertos de las skins permanecen decorativos y los datos se comparten entre +LANRACK y LANWIRE sin duplicar inventarios. + +## Configuración editable según interfaz — 17/10/2026 + +- [ ] **P69.** Corregir los cruces de configuración entre GUI, TUI y CLI: + cada interfaz solo podrá consultar y modificar sus preferencias específicas + y los ajustes comunes del programa o proyecto. Definir en un catálogo + compartido una lista explícita de ajustes editables, con ámbito de interfaz, + launcher, programa/proyecto, validación y permisos administrativos cuando + correspondan. No exponer variables internas, rutas de bases y locks, + esquemas, identificadores, estado de ejecución ni secretos como ajustes. + Usar `docs/CONFIGURATION-USER-REVIEW.txt` como referencia de revisión, + contrastándolo con los consumidores y servicios actuales antes de implementar. + Filtrar tanto los catálogos y menús como las operaciones de guardado en el + backend: rechazar claves ajenas a la interfaz, internas o desconocidas aunque + se invoque directamente el adaptador, sin cambios parciales. No confiar + únicamente en controles ocultos ni en el nombre del launcher; el contexto + de interfaz debe determinarlo el adaptador de entrada, no un valor arbitrario + enviado por el cliente. Aplicar el criterio a los editores generales y por + launcher, formularios específicos y rutas compatibles de configuración. + Separar, por ejemplo, `startup.closeGuiOnLaunch` (GUI), las preferencias + `tui.*` (TUI), el comportamiento CLI y `ip.listColumns` (CLI/TUI), conservando + los ajustes funcionales comunes. Un CLI integrado conserva su contexto CLI. + Mantener las preferencias existentes al ocultarlas de interfaces ajenas y + conservar los servicios compartidos de validación, transacciones y permisos. + Verificar la matriz de lectura/escritura GUI/TUI/CLI, los ajustes comunes, + accesos directos al backend, permisos administrativos y ausencia de variables + internas; actualizar ayuda y referencias si cambia el contrato de comandos. + +## Explicación del servicio LANMON en el instalador — 17/10/2026 + +- [ ] **P70.** Sustituir el texto «Monitor service» por **«Servicio de + monitorización en segundo plano (LANMON)»** en la selección de componentes + del instalador. Añadir una explicación visible en esa pantalla: instala + LANMON como servicio de Windows para ejecutar las comprobaciones de + monitorización configuradas en segundo plano, sin mantener abierta la GUI + ni una terminal. Aclarar que es opcional y que desmarcarlo no elimina LANMON + ni impide utilizarlo de forma interactiva. Incluir el servicio LANMON entre + los componentes marcados por defecto al seleccionar el tipo de instalación + **Standard**, manteniendo la posibilidad de desmarcarlo en la selección + personalizada. Actualmente el componente `monitor` solo declara los tipos + `monitor custom`; corregir su pertenencia para incluir también `standard` + y comprobar la selección inicial y los cambios del desplegable de tipos. + Comprobar que el nombre completo + y la explicación sean legibles sin recortes en el instalador; describir + fielmente el comportamiento real del servicio. El cambio de selección + predeterminada no modifica el funcionamiento del motor de monitorización. + +## Asistente de instalación por pasos — 17/10/2026 + +- [ ] **P71.** Reorganizar las opciones del instalador en cinco páginas de + configuración, respetando este orden y coordinando P45–P47 y P70. Son pasos + de opciones dentro del asistente; conservar las pantallas necesarias de + destino, progreso y finalización sin repetir selecciones. + + 1. **Integración y segundo plano:** casillas para añadir LANCTL al PATH y + «Servicio de monitorización en segundo plano (LANMON)». Explicación breve + del PATH y más detallada del servicio, su funcionamiento sin ventanas y + su carácter opcional. Mantener LANMON seleccionado en Standard según P70. + 2. **Plugins incluidos:** selección individual de los complementos distribuidos + por el autor de LANCTL, con selección de todos o ninguno y descripción + breve. Instalar un plugin no debe omitir comprobaciones de firma, confianza + ni permisos; reutilizar P46 sin volver a marcarlo como no implementado. + 3. **Tema general GUI:** elegir uno de los cinco temas de P45, con nombre y + vista previa. Aplicar la selección a la estética general de todas las + ventanas GUI de la suite mediante el contrato compartido, preservándola + al actualizar. No trasladar preferencias visuales GUI a CLI/TUI. + 4. **Acceso remoto, solo en instalación avanzada:** permitir activar SSH y/o + WEB-GUI y crear el usuario inicial y sus credenciales de acceso, con + confirmación de contraseña y validación mediante servicios de LANACCESS. + Mantener estos accesos desactivados salvo elección explícita. Permitir + gestionar después varios usuarios con credenciales propias, no una única + contraseña compartida. No guardar secretos en logs, argumentos de proceso + ni respuestas persistentes del instalador; conservar usuarios existentes + durante actualizaciones. No confundir estas cuentas con credenciales de + dispositivos del inventario. Omitir la página en el recorrido normal. + 5. **Accesos directos:** cuadrícula con filas LANCTL, LANIP, LANWIRE, LANRACK, + LANACCESS y LANMON, y columnas Escritorio y Barra de tareas de Windows. + Selección independiente por aplicación y destino. Verificar los mecanismos + oficiales de anclaje y su disponibilidad en las versiones de Windows + admitidas; cuando requieran intervención del usuario, solicitar el anclaje + o proporcionar la acción guiada, sin prometer un anclaje automático ni + mostrar éxito si Windows no lo ha confirmado. Mantener separadas barra + de tareas y menú Inicio. + + Al finalizar, conservar las opciones de abrir LANIP y realizar el primer + escaneo de P47. Verificar avanzar/retroceder sin perder elecciones, recorrido + estándar y avanzado, actualización conservando preferencias y correspondencia + entre lo elegido y lo realmente instalado/configurado. Esta entrada define + el flujo pendiente; no supone que las nuevas páginas estén implementadas. + + **Avance P71.4:** implementada la creación opcional de la primera cuenta + administrativa del servicio mediante `lanaccess remote-setup`, ofrecida por + Setup después de aplicar ACL. Formulario con confirmación, autenticación + Scrypt existente, bloqueo entre procesos, rechazo de rutas incompatibles y + conservación de cuentas al actualizar. Probada la integración navegador/API + real en un almacén temporal. No activa listeners ni firewall y no completa + las cinco páginas de P71. Falta la comprobación humana del recorrido elevado + del instalador definitivo; la instalación silenciosa lo omite. + +## Desinstalación completa de LANCTL — 17/10/2026 + +- [ ] **P72.** Hacer que la desinstalación elimine los componentes y datos + propios de LANCTL, incluida la carpeta **Documentos/LanCTL** con sus proyectos + y archivos, además de ejecutables, plugins, preferencias, configuración, + bases, credenciales, registros, cachés, temporales y copias de seguridad + gestionadas por la aplicación. Mostrar en el desinstalador que la eliminación + completa incluye proyectos y credenciales y no conserva datos para reinstalar. + Resolver Documentos mediante la carpeta conocida de Windows, contemplando + redirección a OneDrive y ubicaciones heredadas. Inventariar también los datos + de usuario y servicio en ProgramData, LocalAppData y otras rutas propias + realmente utilizadas, sin asumir que todas pertenecen a la cuenta elevada. + Detener y retirar servicios y procesos de LANCTL; eliminar sus accesos + directos, entrada propia del PATH, registro Clink, reglas de firewall y + registros del sistema creados por la instalación. Coordinar con P48 y P71. + Utilizar un inventario de instalación y validar cada ruta absoluta antes de + borrar recursivamente; no seguir enlaces o redirecciones fuera del destino + previsto ni borrar carpetas compartidas o archivos ajenos por su nombre. + Las ubicaciones personalizadas requieren identificar los recursos propios, + sin vaciar indiscriminadamente el directorio elegido por el usuario. + Contemplar errores de permisos y archivos bloqueados y comunicar cualquier + resto que no se haya podido retirar. No prometer borrar copias externas, + históricos de Windows/OneDrive o datos de otras cuentas sin acceso autorizado. + Separar desinstalación definitiva de actualización: actualizar debe conservar + los datos y preferencias existentes. Verificar instalación/desinstalación y + reinstalación limpia, carpetas heredadas, servicio, cuenta distinta y rutas + personalizadas, comprobando ausencia de restos propios y conservación de + contenido ajeno. + +## Inicio gráfico sin consola adicional — 17/10/2026 + +- [ ] **P73.** Corregir el arranque de las GUI de LANCTL y sus launchers desde + los accesos directos para que no aparezca una terminal adicional del backend, + ni permanezca visible ni parpadee durante el inicio. Revisar el empaquetado + Windows y los destinos de los accesos del menú Inicio, escritorio y barra + de tareas, coordinándolo con P71. Conservar el funcionamiento de CLI/TUI, + entrada/salida estándar, redirecciones y códigos de salida; no desactivar + indiscriminadamente la consola de todos los ejecutables. Tampoco ocultar o + cerrar una terminal existente del usuario al invocar un modo gráfico desde + ella. Mantener el registro de errores y logs compartidos y su consulta en + LANMON, incluidos los fallos de arranque gráfico; ofrecer información útil + si la GUI no llega a abrirse. Verificar los seis launchers en instalación + y portable, apertura desde accesos y desde terminal, lanzamiento de otras + GUI desde LANCTL y apertura explícita de CLI/TUI y LANMON desde la GUI. diff --git a/docs/CLI-REFERENCE.md b/docs/CLI-REFERENCE.md index 627ffc5..dd1ca05 100644 --- a/docs/CLI-REFERENCE.md +++ b/docs/CLI-REFERENCE.md @@ -6,36 +6,43 @@ No lo edites manualmente; ejecuta `python tools/generate_cli_reference.py`. ## `LANCTL` ```text -Usage: LANCTL [-h] [--version] [--cli | -tui] [--admin] LAUNCHER ... +Usage: LANCTL [-h] [--version] [--cli | -tui | --gui] [-web | -github | -reference] [--admin] + LAUNCHER ... Orquestador raíz de las aplicaciones de la suite LANCTL. Arguments: LAUNCHER - lanip (ip) Inventario lógico, descubrimiento, IP, MAC y servicios. - lanwire (wire) Cableado, puertos, paneles y topología física. - lanrack (rack) Salas técnicas, racks, unidades U y equipos. - lanaccess (access) - Usuarios, credenciales y accesos remotos. - lanmon (monitor) Monitorización, eventos, incidencias e historial. - plugin Administración compartida de la suite. - settings Administración compartida de la suite. - language Administración compartida de la suite. - backend Administración compartida de la suite. - -Options: - -h, --help Show this help and exit. - --version Muestra la versión común de la suite y termina. - --cli, -cli Abre la consola principal. - -tui, --tui Abre el TUI principal. - --admin Solicita UAC explícitamente para un launcher instalado en Windows. + lanip (ip) Inventario lógico, descubrimiento, IP, MAC y servicios. + lanwire (wire) Cableado, puertos, paneles y topología física. + lanrack (rack) Salas técnicas, racks, unidades U y equipos. + lanaccess (access) Usuarios, credenciales y accesos remotos. + lanmon (monitor) Monitorización, eventos, incidencias e historial. + plugin Administración compartida de la suite. + settings Administración compartida de la suite. + language Administración compartida de la suite. + backend Administración compartida de la suite. + setup-defaults Inicializa preferencias de instalación sin sobrescribir las existentes. + completions Registra o retira el completado Clink del usuario actual. + post-install Abre LANIP con el usuario normal al finalizar la instalación. + +Options: + -h, --help Show this help and exit. + --version Muestra la versión común de la suite y termina. + --cli, -cli Abre la consola principal. + -tui, --tui Abre el TUI principal. + --gui Abre el centro gráfico de LANCTL. + -web, --web Muestra y abre la web oficial. + -github, --github Muestra y abre GitHub oficial. + -reference, --reference Muestra y abre la referencia oficial. + --admin Solicita UAC explícitamente para un launcher instalado en Windows. ``` ## `LANIP` ```text -Usage: LANIP [-h] [--version] [--quiet | --verbose] [--gui] [--cli] [-tui [VENTANA]] - [-project ARCHIVO.vlf] +Usage: LANIP [-h] [--version] [--quiet | --verbose] [--gui] [--first-scan] [--cli] + [-tui [VENTANA]] [-project ARCHIVO.vlf] COMANDO ... Logical control of LAN devices and infrastructure. @@ -88,6 +95,8 @@ Options: --quiet Omite la salida correcta; conserva errores. --verbose Añade diagnóstico de ejecución a stderr. --gui Abre la interfaz gráfica de LANIP. + --first-scan Solicita confirmación del primer escaneo al abrir la GUI; no escanea + automáticamente. --cli, -cli Open the persistent interactive LANCTL terminal. -tui [VENTANA], --tui [VENTANA] Open the advanced full-screen terminal interface. Puede abrir @@ -125,11 +134,11 @@ Options: ## `LANIP list` ```text -Usage: LANIP list [-h] [--network NETWORK] [--database DATABASE] [--groups GROUPS] - [-f {table,json,csv,html,xml,yaml}] [-o OUTPUT] [-recurrent] [--where WHERE] - [-w WORKERS] [-t TIMEOUT] [--scan-order {ascending,descending,random}] - [--include-unknown] [--resolve-names] [--max-hosts MAX_HOSTS] - [--discovery {icmp,arp,hybrid}] +Usage: LANIP list [-h] [--network NETWORK] [--interface INTERFACE] [--database DATABASE] + [--groups GROUPS] [-f {table,json,csv,html,xml,yaml}] [-o OUTPUT] [-recurrent] + [--where WHERE] [-w WORKERS] [-t TIMEOUT] + [--scan-order {ascending,descending,random}] [--include-unknown] + [--resolve-names] [--max-hosts MAX_HOSTS] [--discovery {icmp,arp,hybrid}] [--profile {fast,normal,accurate} | --fast | --normal | --accurate] [--progress | --no-progress] [--show-discovery] [--include-arp-cache] [--show-detection] [--active | -disconnected] [-basic] [-cnf {O,X,-,S,F}] @@ -140,6 +149,8 @@ Realiza un escaneo básico de IP/MAC, actualiza la base de datos por MAC y muest Options: -h, --help Show this help and exit. --network NETWORK Red CIDR. Por defecto detecta la LAN como /24. + --interface INTERFACE Origen IPv4 local o ID de interfaz; usa su máscara real. Solo + ICMP/ARP, sin DNS ni descubridores externos. --database DATABASE Archivo JSON de elementos. --groups GROUPS Archivo JSON de grupos. -f {table,json,csv,html,xml,yaml}, --format {table,json,csv,html,xml,yaml} @@ -257,7 +268,8 @@ Options: ## `LANIP settings` ```text -Usage: LANIP settings [-h] [-range CIDR] [-list-fields CAMPO [CAMPO ...]] [-dhcp-range INICIO-FIN] +Usage: LANIP settings [-h] [--startup-interface {cli,tui,gui}] [--close-gui-on-launch {on,off}] + [-range CIDR] [-list-fields CAMPO [CAMPO ...]] [-dhcp-range INICIO-FIN] [-credentials ARCHIVO] [-discovery {icmp,arp,hybrid}] [--scan-profile {fast,normal,accurate}] [--progress {on,off}] [--service-identification {on,off}] @@ -277,9 +289,16 @@ Usage: LANIP settings [-h] [-range CIDR] [-list-fields CAMPO [CAMPO ...]] [-dhcp [--tui-key ACCIÓN=TECLA] [--tui-layout {cli.bottom,cli.top}] [--tui-cli-percent 15-75] [--tui-column COLUMNA=TAMAÑO] [--tui-footer-buttons ACCIONES] [--tui-footer-button ACCIÓN=on|off] + [--menu | --catalog | --get RUTA | --set RUTA VALOR] + [--scope {program,project}] [--category CATEGORY] Options: -h, --help Show this help and exit. + --startup-interface {cli,tui,gui} + Interfaz preferida al abrir LANCTL sin argumentos. + --close-gui-on-launch {on,off} + Cierra la GUI principal cuando el launcher solicitado esté + disponible. -range CIDR Rango LAN predeterminado, por ejemplo 192.168.1.1/24. -list-fields CAMPO [CAMPO ...], --list-fields CAMPO [CAMPO ...], -list CAMPO [CAMPO ...] Columnas mostradas por list, separadas por espacios o comas. @@ -352,6 +371,12 @@ Options: --tui-footer-button ACCIÓN=on|off Muestra u oculta una acción concreta de la barra inferior. Puede repetirse. + --menu Editor interactivo por categorías de programa y proyecto. + --catalog Lista todos los ajustes por categorías, con valor y estado editable. + --get RUTA Consulta un ajuste por su ruta, por ejemplo ip.workers. + --set RUTA VALOR Modifica un ajuste; listas y booleanos usan JSON. + --scope {program,project} Ámbito de configuración (predeterminado: program). + --category CATEGORY Filtra el catálogo por categoría, por ejemplo network o monitor. ``` ## `LANIP call` @@ -885,7 +910,7 @@ Options: -alias NEW_ALIAS, --alias NEW_ALIAS Asigna ALIAS al elemento indicado. -description NEW_DESCRIPTION, --description NEW_DESCRIPTION - Asigna DESCRIPTION al elemento indicado (máximo 42 caracteres). + Asigna DESCRIPTION al elemento indicado. -cnf NEW_CNF, --cnf NEW_CNF Asigna el estado CNF. -idf NEW_IDF, --idf NEW_IDF @@ -1616,7 +1641,7 @@ Options: ## `LANWIRE` ```text -Usage: LANWIRE [-h] [--version] [--database ARCHIVO.db] [-tui | --cli] COMANDO ... +Usage: LANWIRE [-h] [--version] [--database ARCHIVO.db] [--gui | -tui | --cli] COMANDO ... Gestión física, IDF, cableado y topología de la suite LANCTL. @@ -1640,6 +1665,7 @@ Options: -h, --help Show this help and exit. --version Muestra la versión común de la suite y termina. --database ARCHIVO.db Base física IDF; por defecto usa physical/idf.db en la raíz compartida. + --gui Abre la interfaz gráfica de escritorio. -tui, --tui Abre la interfaz de pantalla completa. --cli, -cli Abre la consola interactiva de LANWIRE. ``` @@ -1949,21 +1975,24 @@ Options: ## `LANRACK` ```text -Usage: LANRACK [-h] [--version] [--database ARCHIVO.db] [-tui | --cli] {list,ls,show} ... +Usage: LANRACK [-h] [--version] [--database ARCHIVO.db] [--gui | -tui | --cli] + {list,ls,show,dimensions} ... Visualiza racks y sus equipos. Arguments: - {list,ls,show} - list (ls) Lista los racks disponibles. - show Muestra un rack y sus ocupantes. + {list,ls,show,dimensions} + list (ls) Lista los racks disponibles. + show Muestra un rack y sus ocupantes. + dimensions Edita altura y ancho de montaje del rack. Options: - -h, --help Show this help and exit. - --version Muestra la versión común de la suite y termina. - --database ARCHIVO.db Base física IDF compartida. - -tui, --tui Abre la interfaz de pantalla completa. - --cli, -cli Abre la consola interactiva. + -h, --help Show this help and exit. + --version Muestra la versión común de la suite y termina. + --database ARCHIVO.db Base física IDF compartida. + --gui Abre la interfaz gráfica de escritorio. + -tui, --tui Abre la interfaz de pantalla completa. + --cli, -cli Abre la consola interactiva. ``` ## `LANRACK list` @@ -1987,18 +2016,36 @@ Options: -h, --help Show this help and exit. ``` +## `LANRACK dimensions` + +```text +Usage: LANRACK dimensions [-h] --units UNITS --width-inches {10,19,21,23} rack + +Arguments: + rack ID del rack. + +Options: + -h, --help Show this help and exit. + --units UNITS Altura de 4 a 52 U. + --width-inches {10,19,21,23} + Ancho de montaje en pulgadas. +``` + ## `LANACCESS` ```text Usage: LANACCESS [-h] [--version] [--database DATABASE] [--store STORE] [--cipher {auto,dpapi,portable}] [--scope {program,windows,project}] - [--project-dir PROJECT_DIR] [-tui | --cli] - {list,ls,show,set,delete,del,credential,doctor,settings,protocol,user} ... + [--project-dir PROJECT_DIR] [--gui | -tui | --cli] + {remote-setup,list,ls,show,set,delete,del,credential,doctor,settings,protocol,user} + ... Gestiona credenciales cifradas del entorno LANCTL. Arguments: - {list,ls,show,set,delete,del,credential,doctor,settings,protocol,user} + {remote-setup,list,ls,show,set,delete,del,credential,doctor,settings,protocol,user} + remote-setup Crea la primera cuenta remota del servicio en Windows (requiere + administrador). list (ls) Lista metadatos; nunca secretos. show Muestra metadatos de una credencial. set Crea o actualiza una credencial. @@ -2019,10 +2066,20 @@ Options: --scope {program,windows,project} Ubicación; no cambia permisos ni copia secretos automáticamente. --project-dir PROJECT_DIR Directorio del proyecto para su almacén independiente. + --gui Abre la interfaz gráfica de escritorio. -tui, --tui Abre la interfaz de pantalla completa. --cli, -cli Abre la consola interactiva. ``` +## `LANACCESS remote-setup` + +```text +Usage: LANACCESS remote-setup [-h] + +Options: + -h, --help Show this help and exit. +``` + ## `LANACCESS list` ```text @@ -2253,8 +2310,8 @@ Usage: LANMON [-h] [--version] [--project PROJECT] [--permanent] [--duration DUR [--profiles PROFILES] [--assignments-store ASSIGNMENTS_STORE] [--profile PROFILE] [--priority {low,normal,high,critical}] [--check CHECK] [--presence PRESENCE] [--discovery DISCOVERY] [--services SERVICES] [--deep DEEP] [--workers WORKERS] - [--timeout TIMEOUT] [--cli | --tui] [--source {all,program,project}] [--limit LIMIT] - [--window] [--level LEVEL] + [--timeout TIMEOUT] [--gui | --cli | --tui] [--source {all,program,project}] + [--limit LIMIT] [--window] [--level LEVEL] [words ...] Monitorización, eventos e incidencias de la suite LANCTL. @@ -2301,6 +2358,7 @@ Options: --deep DEEP Intervalo profundo. --workers WORKERS Workers del perfil. --timeout TIMEOUT Timeout del perfil. + --gui Abre la interfaz gráfica de escritorio. --cli, -cli Abre la consola de comandos. --tui, -tui Abre el visor tabular de eventos. --source {all,program,project} diff --git a/docs/CLI-SETTINGS.md b/docs/CLI-SETTINGS.md new file mode 100644 index 0000000..02ee56f --- /dev/null +++ b/docs/CLI-SETTINGS.md @@ -0,0 +1,93 @@ +# Configuración completa desde el CLI + +`lanctl settings` abre el editor por categorías cuando se ejecuta en una terminal +interactiva. `lanctl settings --menu` lo abre explícitamente. Con entrada/salida +redirigida se conserva la consulta JSON anterior sin preguntas interactivas. + +El menú separa **Programa completo** y **Proyecto activo**. Cada categoría muestra +los ajustes, su valor actual y los campos de solo lectura. Selecciona un número +para editar, introduce el nuevo valor y pulsa Intro para guardarlo. `0` vuelve al +nivel anterior; una entrada vacía cancela la edición. Las cadenas se pueden +introducir directamente; para vaciarlas usa `""`. Booleanos, listas y objetos +usan JSON (`true`, `false`, `["1.1.1.1"]`). `null` elimina un valor opcional. + +## Categorías del programa + +- Almacenamiento y rutas de credenciales e iconos. +- Registros, limpieza, retención y nivel de diagnóstico. +- Proyectos: directorio, guardado, intervalos, bases y espacio de trabajo. +- Plugins: directorios, registro, almacenamiento y modo seguro. +- Idioma y directorio de traducciones. +- CLI: confirmación al salir y encadenamiento de comandos. +- Inicio: interfaz preferida de LANCTL y cierre de la GUI al abrir un launcher. +- Red: rango, DHCP, DNS, gateway, máscara, dominio, reservas y TR-064. +- LANIP: perfiles, descubrimiento, concurrencia, tiempos, límites, retención, + columnas, perfiles Cisco y visor Radmin. +- TUI: distribución, proporciones, columnas, todos los atajos y botones. +- Wake on LAN: puerto, repeticiones, intervalos, espera, método y secuencias. +- LANACCESS: almacenes y configuración del acceso remoto. +- LANMON: activación, perfil, modo, autoridad, interfaz, CIDR, duración, ejecución, intervalos y retención. +- Información del formato. + +El catálogo se deriva del esquema canónico: incluye todas sus opciones sin +mantener una segunda lista reducida. Los campos de versión, selección del +proyecto y fecha de descarga se muestran como automáticos y explican cómo se +gestionan. El catálogo muestra rutas de almacenes, nunca descifra sus secretos. +La configuración propia declarada por cada plugin sigue utilizando su servicio +`PluginSettings`; las cuentas, claves y permisos conservan los comandos LANACCESS. + +## Categorías del proyecto + +Selecciona primero el proyecto mediante `project use`. Las categorías son: + +- `identity`: nombre, descripción y autor; UUID, fechas, versiones, hashes y + contadores se muestran como datos automáticos. +- `lan`: nombre de la LAN, descripción, ubicación, empresa y responsable. +- `network`: CIDR, gateway, DNS, DHCP, descubrimiento, perfil y orden de escaneo, + modo e intervalo de guardado. Dirección de red, máscara y prefijo se derivan + del CIDR. +- `vlan`: definición de VLANs, VLAN nativa y VLAN de gestión. + +Cada modificación del proyecto escribe el VLF inmediatamente, guarda una copia +en `.lanctl-backups` y actualiza sus hashes. Conserva el inventario y el espacio +de trabajo con cambios pendientes. Las preferencias de red explícitas quedan +versionadas en `lan/settings.override.json` (schemaVersion 1), se mantienen en +los siguientes guardados y se aplican al activar el proyecto. También se aplican +a la sesión que modifica el proyecto activo. Otros procesos ya abiertos pueden +necesitar volver a seleccionar el proyecto para recargar sus preferencias. + +## Acceso directo y automatización + +```text +lanctl settings --catalog +lanctl settings --catalog --category monitor +lanctl settings --get ip.workers +lanctl settings --set ip.workers 32 +lanctl settings --set cli.commandChaining false +lanctl settings --startup-interface gui --close-gui-on-launch off +lanctl settings --set startup.interface tui +lanctl settings --set startup.closeGuiOnLaunch true +lanctl settings --scope project --catalog +lanctl settings --scope project --set identity.name "Oficina principal" +lanctl settings --scope project --set lan.company "Mi empresa" +lanctl settings --scope project --set network.cidr 192.168.20.0/24 +``` + +Para modificar conjuntamente el enlace y la red permitida de acceso remoto, +selecciona el ajuste `access.remote` e introduce un objeto JSON con `bind`, +`cidr` y, opcionalmente, `enabled`, `port`, `passwordAuthentication`, `backend` +o `forcedView`. Esta operación reutiliza la validación y aplicación del backend +remoto existente. Los flags clásicos de `settings` siguen disponibles; no se +mezclan con `--menu`, `--catalog`, `--get` o `--set` en una misma llamada. + +La preferencia de inicio solo se aplica sin argumentos. `lanctl --cli`, +`lanctl --tui`, `lanctl --gui` y los comandos explícitos conservan prioridad. +Los valores anteriores sin sección `startup` conservan el inicio CLI y la GUI +principal abierta. Son campos aditivos del esquema de configuración existente. + +En SETTINGS del TUI, `Ctrl+S` guarda el formulario mediante el mismo comando +validado que el menú de salida. En Project Manager, `Ctrl+E` edita el proyecto +seleccionado y el atajo de guardado del inventario guarda el proyecto activo. +En los formularios de creación/edición, `Ctrl+S` confirma el formulario local. +`Esc` solicita confirmación antes de descartar cambios. Los atajos locales no +modifican las asignaciones globales del inventario. diff --git a/docs/CONFIGURATION-INVENTORY-ANNEX.csv b/docs/CONFIGURATION-INVENTORY-ANNEX.csv new file mode 100644 index 0000000..0d8f868 --- /dev/null +++ b/docs/CONFIGURATION-INVENTORY-ANNEX.csv @@ -0,0 +1,1004 @@ +categoria,variable,tipo,predeterminado,ambito,launcher,almacen,editable,alias_compatibilidad,fuente,linea,observaciones +Parametros de ejecucion CLI,--version,'version',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,33,Contexto del comando en archivo fuente. help='Muestra la versión común de la suite y termina.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,39,Contexto del comando en archivo fuente. help='Base de elementos LANCTL.' +Parametros de ejecucion CLI,--store,str,config['credentials'],Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,40,Contexto del comando en archivo fuente. help='Almacén cifrado de credenciales.' +Parametros de ejecucion CLI,--cipher,str,'auto',Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,43,"Contexto del comando en archivo fuente. choices=('auto', 'dpapi', 'portable'); help='Proveedor de cifrado; portable pide contraseña.'" +Parametros de ejecucion CLI,--scope,str,'program',Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,49,"Contexto del comando en archivo fuente. choices=('program', 'windows', 'project'); help='Ubicación; no cambia permisos ni copia secretos automáticamente.'" +Parametros de ejecucion CLI,--project-dir,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,55,Contexto del comando en archivo fuente. help='Directorio del proyecto para su almacén independiente.' +Parametros de ejecucion CLI,--gui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,59,Contexto del comando en archivo fuente. help='Abre la interfaz gráfica de escritorio.' +Parametros de ejecucion CLI,-tui / --tui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,60,Contexto del comando en archivo fuente. help='Abre la interfaz de pantalla completa.' +Parametros de ejecucion CLI,--cli / -cli,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,63,Contexto del comando en archivo fuente. help='Abre la consola interactiva.' +Parametros de ejecucion CLI,credential_id,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,67,Contexto del comando en archivo fuente. help='Identificador de la credencial.' +Parametros de ejecucion CLI,element,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,69,"Contexto del comando en archivo fuente. help='IP, MAC, alias o ID del dispositivo.'" +Parametros de ejecucion CLI,protocol,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,70,"Contexto del comando en archivo fuente. help='Protocolo asociado, por ejemplo ssh.'" +Parametros de ejecucion CLI,--username / -user,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,71,Contexto del comando en archivo fuente. required=True; help='Usuario remoto.' +Parametros de ejecucion CLI,credential_id,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,73,Contexto del comando en archivo fuente. help='Identificador de la credencial.' +Parametros de ejecucion CLI,element,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,83,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,protocol,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,84,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--username,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,85,Contexto del comando en archivo fuente. required=True +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,90,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--target-cipher,str,'portable',Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,91,"Contexto del comando en archivo fuente. choices=('dpapi', 'portable')" +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,95,Contexto del comando en archivo fuente. help='Aplica reparaciones; por defecto sólo diagnostica.' +Parametros de ejecucion CLI,action,str,'show',Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,100,"Contexto del comando en archivo fuente. choices=('show', 'use-store'); nargs='?'" +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,101,Contexto del comando en archivo fuente. nargs='?' +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,102,Contexto del comando en archivo fuente. help='Confirma cambiar el almacén configurado sin mover secretos.' +Parametros de ejecucion CLI,action,str,'list',Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,108,"Contexto del comando en archivo fuente. choices=('list', 'configure'); nargs='?'" +Parametros de ejecucion CLI,element,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,109,Contexto del comando en archivo fuente. nargs='?' +Parametros de ejecucion CLI,protocol,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,110,Contexto del comando en archivo fuente. nargs='?' +Parametros de ejecucion CLI,--port,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,111,Contexto del comando en archivo fuente. help='Puerto 1-65535.' +Parametros de ejecucion CLI,--driver,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,112,Contexto del comando en archivo fuente. help='Driver del protocolo.' +Parametros de ejecucion CLI,action,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,114,"Contexto del comando en archivo fuente. choices=('list', 'add', 'enable', 'disable', 'delete')" +Parametros de ejecucion CLI,username,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,115,Contexto del comando en archivo fuente. nargs='?' +Parametros de ejecucion CLI,--role,str,'viewer',Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,116,"Contexto del comando en archivo fuente. choices=('viewer', 'operator', 'manager', 'administrator')" +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,119,Contexto del comando en archivo fuente. help='Confirma eliminación.' +Parametros de ejecucion CLI,credential_id,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,81,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANACCESS,Línea de comandos,por invocación,,src/lanctl/apps/access/manager_cli.py,88,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,words,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,28,"Contexto del comando en archivo fuente. nargs='*'; help='init, status, enable, disable, configure, user, role, session, web o certificate.'" +Parametros de ejecucion CLI,--bind,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,33,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--cidr,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,34,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--port,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,35,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--password-auth,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,36,"Contexto del comando en archivo fuente. choices=('on', 'off')" +Parametros de ejecucion CLI,--role,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,37,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--ssh-key,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,38,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--expires,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,39,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--permission,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,40,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--certificate,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,41,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--private-key,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,42,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--common-name,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,43,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,44,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,45,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--scope,str,'user',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,46,"Contexto del comando en archivo fuente. choices=('user', 'service'); help='Separa credenciales del usuario y del servicio permanente.'" +Parametros de ejecucion CLI,--config,str,config['accessConfig'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,52,Contexto del comando en archivo fuente. help='Configuración remota separada.' +Parametros de ejecucion CLI,--users,str,config['accessUsers'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,55,Contexto del comando en archivo fuente. help='Almacén de usuarios remotos.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/call.py,48,"Contexto del comando en archivo fuente. help='Alias, IP o MAC del dispositivo.'" +Parametros de ejecucion CLI,-f / --field,str,'ip',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/call.py,49,Contexto del comando en archivo fuente. choices=tuple(FIELDS); help='Dato devuelto (por defecto: ip).' +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/call.py,56,Contexto del comando en archivo fuente. help='Devuelve el registro completo como JSON.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/call.py,61,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/cnf.py,16,"Contexto del comando en archivo fuente. help='IP, MAC o alias del elemento.'" +Parametros de ejecucion CLI,value,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/cnf.py,17,"Contexto del comando en archivo fuente. nargs='?'; help='O (OK), X (UNKNOWN), - (UNRECOGNIZED), S (MARKED) o F (FIXED). Sin valor libera F y restaura O.'" +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/cnf.py,25,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/credential.py,21,"Contexto del comando en archivo fuente. help='IP, MAC o alias del elemento.'" +Parametros de ejecucion CLI,action,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/credential.py,22,"Contexto del comando en archivo fuente. nargs='?'; choices=('set', 'list', 'delete'); help='Operación sobre la credencial.'" +Parametros de ejecucion CLI,protocol,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/credential.py,28,"Contexto del comando en archivo fuente. nargs='?'; help='Protocolo, por ejemplo tr-064.'" +Parametros de ejecucion CLI,-user / --username,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/credential.py,29,Contexto del comando en archivo fuente. dest='username'; help='Nombre de usuario remoto.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/credential.py,30,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--store,str,config['credentials'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/credential.py,33,Contexto del comando en archivo fuente. help='Almacén cifrado de credenciales.' +Parametros de ejecucion CLI,--diagnose,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/database.py,22,Contexto del comando en archivo fuente. help='Valida los almacenes configurados.' +Parametros de ejecucion CLI,--export,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/database.py,25,Contexto del comando en archivo fuente. help='Exporta datos con hashes verificables.' +Parametros de ejecucion CLI,--verify,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/database.py,28,Contexto del comando en archivo fuente. help='Verifica una exportación sin importarla.' +Parametros de ejecucion CLI,--import,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/database.py,31,Contexto del comando en archivo fuente. dest='import_file'; help='Importa datos verificados.' +Parametros de ejecucion CLI,--restore,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/database.py,34,Contexto del comando en archivo fuente. help='Restaura un backup validado del almacén.' +Parametros de ejecucion CLI,--target,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/database.py,37,"Contexto del comando en archivo fuente. choices=('database', 'groups', 'physical'); help='Almacén que se restaura.'" +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/database.py,40,Contexto del comando en archivo fuente. help='Confirma la sustitución de datos.' +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/database.py,41,Contexto del comando en archivo fuente. help='Emite el diagnóstico como JSON.' +Parametros de ejecucion CLI,--output,str,'LANCTL-demo',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/demo.py,22,Contexto del comando en archivo fuente. help='Directorio donde se guardará el proyecto y el informe.' +Parametros de ejecucion CLI,--force,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/demo.py,28,Contexto del comando en archivo fuente. help='Reemplaza una demo anterior.' +Parametros de ejecucion CLI,--format,str,'all',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/demo.py,29,"Contexto del comando en archivo fuente. choices=('json', 'html', 'all'); help='Formato del informe exportado.'" +Parametros de ejecucion CLI,--port,int,"int(config.get('tr064Port', 49000))",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/download_settings.py,23,Contexto del comando en archivo fuente. help='Puerto TR-064 del router.' +Parametros de ejecucion CLI,--timeout,float,5.0,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/download_settings.py,29,Contexto del comando en archivo fuente. help='Tiempo máximo de espera en segundos.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/download_settings.py,35,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--store,str,config['credentials'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/download_settings.py,40,Contexto del comando en archivo fuente. help='Almacén cifrado de credenciales.' +Parametros de ejecucion CLI,gateway,str,'GATEWAY',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/download_settings.py,18,"Contexto del comando en archivo fuente. nargs='?'; help='IP, MAC o alias del router.'" +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,21,"Contexto del comando en archivo fuente. nargs='?'; help='IP, MAC o alias.'" +Parametros de ejecucion CLI,action,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,22,"Contexto del comando en archivo fuente. nargs='?'; choices=('edit', *FIELDS, *DELETE_ACTIONS); help='Campo o acción que se quiere editar.'" +Parametros de ejecucion CLI,values,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,28,Contexto del comando en archivo fuente. nargs='*'; help='Nuevo valor.' +Parametros de ejecucion CLI,-add,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,29,Contexto del comando en archivo fuente. help='Añade un elemento nuevo utilizando su dirección MAC.' +Parametros de ejecucion CLI,-name / --name,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,34,Contexto del comando en archivo fuente. dest='new_name'; help='Asigna NAME al elemento indicado.' +Parametros de ejecucion CLI,-ip / --ip,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,37,Contexto del comando en archivo fuente. dest='new_ip'; help='Asigna una dirección IPv4.' +Parametros de ejecucion CLI,-alias / --alias,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,38,Contexto del comando en archivo fuente. dest='new_alias'; help='Asigna ALIAS al elemento indicado.' +Parametros de ejecucion CLI,-description / --description,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,41,Contexto del comando en archivo fuente. dest='new_description'; help='Asigna DESCRIPTION al elemento indicado.' +Parametros de ejecucion CLI,-cnf / --cnf,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,47,Contexto del comando en archivo fuente. dest='new_cnf'; help='Asigna el estado CNF.' +Parametros de ejecucion CLI,-idf / --idf,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,48,Contexto del comando en archivo fuente. dest='new_idf'; help='Asigna un IDF único (2-5 letras y 2-5 dígitos).' +Parametros de ejecucion CLI,-group / --group,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,51,Contexto del comando en archivo fuente. dest='new_group'; help='Añade el elemento al grupo.' +Parametros de ejecucion CLI,-protocol / --protocol,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,52,Contexto del comando en archivo fuente. dest='new_protocol'; help='Activa un protocolo.' +Parametros de ejecucion CLI,-delete / --delete,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,55,Contexto del comando en archivo fuente. dest='delete_requested'; help='Elimina completamente el elemento indicado.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,62,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--groups,str,config['groups'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,65,Contexto del comando en archivo fuente. help='Archivo JSON de grupos.' +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/element.py,66,Contexto del comando en archivo fuente. help='Elimina sin solicitar confirmación.' +Parametros de ejecucion CLI,--range,str,config.get('range'),Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py,44,Contexto del comando en archivo fuente. dest='network'; help='Rango CIDR que se explorará solo durante esta ejecución.' +Parametros de ejecucion CLI,--resolve-names,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py,50,Contexto del comando en archivo fuente. help='Resuelve nombres sin almacenarlos.' +Parametros de ejecucion CLI,--ports,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py,53,"Contexto del comando en archivo fuente. help='Puertos TCP opcionales, por ejemplo 22,80,443.'" +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py,54,Contexto del comando en archivo fuente. help='Devuelve la sesión como JSON.' +Parametros de ejecucion CLI,--workers,int,"config.get('workers', 64)",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py,55,Contexto del comando en archivo fuente. help='Sondeos simultáneos.' +Parametros de ejecucion CLI,--timeout,float,"config.get('timeout', 0.8)",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py,58,"Contexto del comando en archivo fuente. help='Tiempo máximo base por sondeo, en segundos.'" +Parametros de ejecucion CLI,--max-hosts,int,"config.get('maxHosts', 4096)",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py,64,Contexto del comando en archivo fuente. help='Límite defensivo de direcciones autorizadas.' +Parametros de ejecucion CLI,--scan-order,str,"config.get('scanOrder', 'ascending')",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py,70,"Contexto del comando en archivo fuente. choices=('ascending', 'descending', 'random'); help='Orden de exploración de las direcciones.'" +Parametros de ejecucion CLI,error_id,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/error.py,15,Contexto del comando en archivo fuente. help='Identificador estable del error.' +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/error.py,16,Contexto del comando en archivo fuente. help='Emite el resultado como JSON.' +Parametros de ejecucion CLI,name,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,22,Contexto del comando en archivo fuente. nargs='?'; help='Nombre del grupo.' +Parametros de ejecucion CLI,-new,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,24,Contexto del comando en archivo fuente. help='Crea el grupo.' +Parametros de ejecucion CLI,-del,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,25,Contexto del comando en archivo fuente. dest='delete'; help='Elimina el grupo.' +Parametros de ejecucion CLI,-rename,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,26,Contexto del comando en archivo fuente. help='Renombra el grupo.' +Parametros de ejecucion CLI,-description,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,27,Contexto del comando en archivo fuente. help='Edita su descripción.' +Parametros de ejecucion CLI,-add,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,28,"Contexto del comando en archivo fuente. help='Añade IP, MAC o alias.'" +Parametros de ejecucion CLI,-remove,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,29,"Contexto del comando en archivo fuente. help='Retira IP, MAC o alias.'" +Parametros de ejecucion CLI,-list,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,30,Contexto del comando en archivo fuente. help='Lista los elementos que pertenecen al grupo.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,35,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--groups,str,config['groups'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,38,Contexto del comando en archivo fuente. help='Archivo JSON de grupos.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,16,"Contexto del comando en archivo fuente. nargs='?'; help='DeviceId, alias, nombre, MAC, IP actual o histórica.'" +Parametros de ejecucion CLI,--all,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,19,Contexto del comando en archivo fuente. help='Incluye eventos generales de toda la LAN.' +Parametros de ejecucion CLI,--commands,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,22,Contexto del comando en archivo fuente. help='En CLI interactiva muestra los comandos de la sesión.' +Parametros de ejecucion CLI,--today,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,27,Contexto del comando en archivo fuente. help='Limita la consulta al día local actual.' +Parametros de ejecucion CLI,--from,date.fromisoformat,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,30,Contexto del comando en archivo fuente. dest='date_from'; help='Fecha inicial YYYY-MM-DD.' +Parametros de ejecucion CLI,--to,date.fromisoformat,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,37,Contexto del comando en archivo fuente. dest='date_to'; help='Fecha final YYYY-MM-DD.' +Parametros de ejecucion CLI,--type,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,44,Contexto del comando en archivo fuente. dest='types'; help='Tipo canónico; se puede repetir.' +Parametros de ejecucion CLI,--source,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,47,Contexto del comando en archivo fuente. help='Filtra por origen.' +Parametros de ejecucion CLI,--result,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,48,Contexto del comando en archivo fuente. help='Filtra por resultado.' +Parametros de ejecucion CLI,--errors,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,49,Contexto del comando en archivo fuente. help='Muestra únicamente errores.' +Parametros de ejecucion CLI,--search,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,50,Contexto del comando en archivo fuente. help='Busca texto seguro.' +Parametros de ejecucion CLI,--limit,int,100,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,51,Contexto del comando en archivo fuente. help='Máximo de eventos (1..10000).' +Parametros de ejecucion CLI,--reverse,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,52,Contexto del comando en archivo fuente. help='Orden descendente.' +Parametros de ejecucion CLI,--format,str,'table',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/history.py,53,"Contexto del comando en archivo fuente. choices=('table', 'json', 'csv'); help='Formato de salida.'" +Parametros de ejecucion CLI,--name,str,'lab',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,18,Contexto del comando en archivo fuente. help='Nombre del escenario.' +Parametros de ejecucion CLI,--cidr,str,'192.0.2.0/24',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,19,Contexto del comando en archivo fuente. help='Red IPv4 virtual.' +Parametros de ejecucion CLI,--profile,str,'home',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,20,"Contexto del comando en archivo fuente. choices=('home', 'office', 'datacenter', 'industrial', 'chaotic'); help='Perfil de dispositivos.'" +Parametros de ejecucion CLI,--devices,int,20,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,26,Contexto del comando en archivo fuente. help='Cantidad de dispositivos.' +Parametros de ejecucion CLI,--seed,int,1,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,27,Contexto del comando en archivo fuente. help='Semilla reproducible.' +Parametros de ejecucion CLI,--active-percent,float,80,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,28,Contexto del comando en archivo fuente. help='Porcentaje activo.' +Parametros de ejecucion CLI,--dhcp-percent,float,70,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,29,Contexto del comando en archivo fuente. help='Porcentaje DHCP.' +Parametros de ejecucion CLI,--type,str,'snapshot',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,30,"Contexto del comando en archivo fuente. choices=('snapshot', 'timeline', 'chaos'); help='Evolución del escenario.'" +Parametros de ejecucion CLI,scenario,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,44,Contexto del comando en archivo fuente. help='Nombre del escenario.' +Parametros de ejecucion CLI,scenario,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,47,Contexto del comando en archivo fuente. help='Nombre del escenario.' +Parametros de ejecucion CLI,scenario,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,50,Contexto del comando en archivo fuente. help='Nombre del escenario.' +Parametros de ejecucion CLI,--format,str,'json',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,51,"Contexto del comando en archivo fuente. choices=('json', 'csv'); help='Formato de salida.'" +Parametros de ejecucion CLI,--output,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,54,Contexto del comando en archivo fuente. help='Archivo de destino; stdout si se omite.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,57,Contexto del comando en archivo fuente. help='Archivo JSON.' +Parametros de ejecucion CLI,--name,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,62,Contexto del comando en archivo fuente. required=True; help='Nombre del escenario.' +Parametros de ejecucion CLI,--cidr,str,'192.0.2.0/24',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,63,Contexto del comando en archivo fuente. help='CIDR virtual.' +Parametros de ejecucion CLI,scenario,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,68,Contexto del comando en archivo fuente. help='Escenario.' +Parametros de ejecucion CLI,--ip,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,69,Contexto del comando en archivo fuente. required=True; help='IPv4 simulada.' +Parametros de ejecucion CLI,--mac,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,70,Contexto del comando en archivo fuente. required=True; help='MAC simulada.' +Parametros de ejecucion CLI,--alias,str,'',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,71,Contexto del comando en archivo fuente. help='Alias.' +Parametros de ejecucion CLI,--name,str,'',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,72,Contexto del comando en archivo fuente. help='Nombre.' +Parametros de ejecucion CLI,--inactive,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,73,Contexto del comando en archivo fuente. help='Lo crea inactivo.' +Parametros de ejecucion CLI,scenario,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,76,Contexto del comando en archivo fuente. help='Escenario.' +Parametros de ejecucion CLI,device,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,77,"Contexto del comando en archivo fuente. help='ID, IP, MAC o alias.'" +Parametros de ejecucion CLI,--seconds,float,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lab.py,80,Contexto del comando en archivo fuente. required=True; help='Segundos virtuales.' +Parametros de ejecucion CLI,language,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/language.py,22,"Contexto del comando en archivo fuente. help='Language code or name, for example en or Español.'" +Parametros de ejecucion CLI,language,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/language.py,25,Contexto del comando en archivo fuente. nargs='?'; help='Language code or name; active language by default.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/language.py,30,Contexto del comando en archivo fuente. help='Language catalog with .lang extension.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/language.py,33,Contexto del comando en archivo fuente. help='Language catalog with .lang extension.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/language.py,36,Contexto del comando en archivo fuente. help='Destination .lang file.' +Parametros de ejecucion CLI,--new-window,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lanwire.py,19,Contexto del comando en archivo fuente. help='Abre LANWIRE en una consola independiente incluso si se indican argumentos.' +Parametros de ejecucion CLI,--version,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lanwire.py,24,Contexto del comando en archivo fuente. dest='lanwire_version'; help='Muestra la versión común de LANWIRE y termina.' +Parametros de ejecucion CLI,--database,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lanwire.py,30,Contexto del comando en archivo fuente. dest='lanwire_database'; help='Selecciona una base física IDF alternativa.' +Parametros de ejecucion CLI,-tui / --tui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lanwire.py,37,Contexto del comando en archivo fuente. dest='lanwire_tui'; help='Abre la interfaz TUI de LANWIRE.' +Parametros de ejecucion CLI,--cli,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lanwire.py,44,Contexto del comando en archivo fuente. dest='lanwire_cli'; help='Abre la consola interactiva de LANWIRE.' +Parametros de ejecucion CLI,arguments,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/lanwire.py,50,"Contexto del comando en archivo fuente. nargs=argparse.REMAINDER; help='Argumentos enviados a LANWIRE, por ejemplo: list.'" +Parametros de ejecucion CLI,--network,str,config['range'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,37,Contexto del comando en archivo fuente. help='Red CIDR. Por defecto detecta la LAN como /24.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,43,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--groups,str,config['groups'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,46,Contexto del comando en archivo fuente. help='Archivo JSON de grupos.' +Parametros de ejecucion CLI,-f / --format,str,'table',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,47,"Contexto del comando en archivo fuente. choices=('table', 'json', 'csv', 'html', 'xml', 'yaml'); help='Formato de salida (por defecto: table).'" +Parametros de ejecucion CLI,-o / --output,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,54,Contexto del comando en archivo fuente. help='Guarda la salida en un archivo.' +Parametros de ejecucion CLI,-recurrent / --recurrent,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,55,Contexto del comando en archivo fuente. help='Lista los elementos recurrentes sin escanear la LAN ni mostrar IP.' +Parametros de ejecucion CLI,--where,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,61,"Contexto del comando en archivo fuente. help='Consulta combinable, por ejemplo: ""active and group=IOT and vendor~Amazon"".'" +Parametros de ejecucion CLI,-w / --workers,int,config['workers'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,65,Contexto del comando en archivo fuente. help='Comprobaciones simultáneas.' +Parametros de ejecucion CLI,-t / --timeout,float,config['timeout'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,72,Contexto del comando en archivo fuente. help='Timeout base en segundos por operación y host; el perfil puede ajustarlo.' +Parametros de ejecucion CLI,--scan-order,str,"config.get('scanOrder', 'ascending')",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,79,"Contexto del comando en archivo fuente. choices=SCAN_ORDERS; help='Orden de sondeo de IP: ascending, descending o random.'" +Parametros de ejecucion CLI,--include-unknown,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,85,Contexto del comando en archivo fuente. help='Incluye hosts activos aunque todavía no tengan MAC.' +Parametros de ejecucion CLI,--resolve-names,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,90,Contexto del comando en archivo fuente. help='Resuelve y guarda nombres DNS de los elementos detectados.' +Parametros de ejecucion CLI,--max-hosts,int,config['maxHosts'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,95,Contexto del comando en archivo fuente. help='Máximo de hosts permitido en un escaneo.' +Parametros de ejecucion CLI,--discovery,str,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,101,"Contexto del comando en archivo fuente. choices=DISCOVERY_MODES; help='Método: icmp, arp activo o hybrid (por defecto según settings).'" +Parametros de ejecucion CLI,--profile,str,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,108,"Contexto del comando en archivo fuente. choices=tuple(SCAN_PROFILES); help='Perfil completo de escaneo: fast, normal o accurate.'" +Parametros de ejecucion CLI,--fast,'store_const',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,114,Contexto del comando en archivo fuente. dest='profile'; help='Escaneo ARP rápido.' +Parametros de ejecucion CLI,--normal,'store_const',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,117,Contexto del comando en archivo fuente. dest='profile'; help='Escaneo híbrido equilibrado.' +Parametros de ejecucion CLI,--accurate,'store_const',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,124,Contexto del comando en archivo fuente. dest='profile'; help='Escaneo profundo con varios métodos.' +Parametros de ejecucion CLI,--progress,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,132,Contexto del comando en archivo fuente. dest='progress'; help='Muestra el progreso interactivo.' +Parametros de ejecucion CLI,--no-progress,'store_false',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,135,Contexto del comando en archivo fuente. dest='progress'; help='Oculta el progreso.' +Parametros de ejecucion CLI,--show-discovery,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,138,"Contexto del comando en archivo fuente. help='Añade una columna con ICMP, ARP, LOCAL, BASIC o CACHE.'" +Parametros de ejecucion CLI,--include-arp-cache,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,143,Contexto del comando en archivo fuente. help='Importa vecinos ARP en caché como CACHE no verificada; no cuentan como activos.' +Parametros de ejecucion CLI,--show-detection,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,148,Contexto del comando en archivo fuente. help='Añade los métodos históricos y la fecha de última detección.' +Parametros de ejecucion CLI,--active / -active / -connected / --connected / -conected,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,154,Contexto del comando en archivo fuente. dest='connected'; help='Muestra solo los dispositivos activos en el escaneo actual.' +Parametros de ejecucion CLI,-disconnected / --disconnected / -offline,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,164,Contexto del comando en archivo fuente. help='Muestra solo los dispositivos no detectados actualmente.' +Parametros de ejecucion CLI,-basic / --basic,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,171,"Contexto del comando en archivo fuente. help='Vista reducida: IP, alias y descripción.'" +Parametros de ejecucion CLI,-cnf / --cnf-state,str.upper,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,177,"Contexto del comando en archivo fuente. choices=('O', 'X', '-', 'S', 'F'); help='Filtra por estado CNF: O, X, -, S o F.'" +Parametros de ejecucion CLI,-group / --group,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,184,Contexto del comando en archivo fuente. help='Muestra solo los elementos de un grupo.' +Parametros de ejecucion CLI,-dhcp / --dhcp-only,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/list.py,190,Contexto del comando en archivo fuente. help='Muestra solo IP incluidas en el rango DHCP configurado.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,69,"Contexto del comando en archivo fuente. help='IP, MAC o alias del elemento.'" +Parametros de ejecucion CLI,protocol,str,'auto',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,70,Contexto del comando en archivo fuente. nargs='?'; choices=OPEN_PROTOCOLS; help='Protocolo o detección automática.' +Parametros de ejecucion CLI,--port,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,77,Contexto del comando en archivo fuente. help='Puerto alternativo.' +Parametros de ejecucion CLI,--path,str,'',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,78,Contexto del comando en archivo fuente. help='Ruta HTTP/FTP/RTSP o recurso SMB.' +Parametros de ejecucion CLI,--mode,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,79,Contexto del comando en archivo fuente. choices=RADMIN_MODES; help='Modo de conexión Radmin.' +Parametros de ejecucion CLI,--through,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,80,Contexto del comando en archivo fuente. help='Servidor Radmin intermedio HOST:PUERTO.' +Parametros de ejecucion CLI,--fullscreen,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,81,Contexto del comando en archivo fuente. help='Abre control o vista a pantalla completa.' +Parametros de ejecucion CLI,--color-depth,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,84,"Contexto del comando en archivo fuente. choices=COLOR_DEPTHS; help='Profundidad de color de Radmin (1, 2, 4, 8, 16 o 24 bits).'" +Parametros de ejecucion CLI,--updates,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,90,Contexto del comando en archivo fuente. help='Máximo de actualizaciones de pantalla por segundo (1-120).' +Parametros de ejecucion CLI,--phonebook,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,95,Contexto del comando en archivo fuente. help='Ruta de phonebook Radmin .rpb.' +Parametros de ejecucion CLI,--phonebook-id,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,96,Contexto del comando en archivo fuente. help='Identificador de entrada dentro del phonebook de Radmin.' +Parametros de ejecucion CLI,--dry-run,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,101,Contexto del comando en archivo fuente. help='Muestra el destino sin abrirlo.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,102,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--store,str,config['credentials'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/open.py,105,Contexto del comando en archivo fuente. help='Almacén cifrado de credenciales.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ping.py,31,"Contexto del comando en archivo fuente. help='IP, MAC, alias o nombre registrado.'" +Parametros de ejecucion CLI,--method,str,'auto',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ping.py,33,"Contexto del comando en archivo fuente. choices=PING_METHODS; help='Buscador utilizado: auto, ping o arp (por defecto: auto).'" +Parametros de ejecucion CLI,--ping,'store_const',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ping.py,39,Contexto del comando en archivo fuente. dest='method'; help='Usa únicamente una solicitud ICMP.' +Parametros de ejecucion CLI,--arp,'store_const',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ping.py,46,Contexto del comando en archivo fuente. dest='method'; help='Usa únicamente una solicitud ARP activa.' +Parametros de ejecucion CLI,--timeout,float,config['timeout'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ping.py,53,"Contexto del comando en archivo fuente. help='Tiempo máximo de cada comprobación, en segundos.'" +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ping.py,59,Contexto del comando en archivo fuente. help='Devuelve el diagnóstico como JSON.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ping.py,60,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,plugin_id,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,29,Contexto del comando en archivo fuente. help='Identificador estable del complemento.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,32,Contexto del comando en archivo fuente. help='Archivo de paquete con extensión .lcp.' +Parametros de ejecucion CLI,plugin_id,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,35,Contexto del comando en archivo fuente. help='Identificador del complemento instalado.' +Parametros de ejecucion CLI,--grant,str,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,36,Contexto del comando en archivo fuente. nargs='*'; help='Permisos concretos que se conceden.' +Parametros de ejecucion CLI,--grant-all,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,43,Contexto del comando en archivo fuente. help='Concede todos los permisos solicitados.' +Parametros de ejecucion CLI,--trust,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,46,Contexto del comando en archivo fuente. help='Autoriza código trusted dentro del proceso.' +Parametros de ejecucion CLI,target,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,59,Contexto del comando en archivo fuente. help='Identificador instalado o ruta de un archivo .lcp.' +Parametros de ejecucion CLI,plugin_id,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,64,Contexto del comando en archivo fuente. help='Identificador del complemento instalado.' +Parametros de ejecucion CLI,plugin_id,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,67,Contexto del comando en archivo fuente. help='Identificador del complemento instalado.' +Parametros de ejecucion CLI,permissions,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,68,Contexto del comando en archivo fuente. nargs='*'; help='Vacío revoca todos los permisos.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,84,Contexto del comando en archivo fuente. help='Paquete .lcp firmado y verificado.' +Parametros de ejecucion CLI,--name,str,'',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,85,Contexto del comando en archivo fuente. help='Nombre descriptivo del editor.' +Parametros de ejecucion CLI,fingerprint,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,88,Contexto del comando en archivo fuente. help='Huella SHA-256 Ed25519 completa.' +Parametros de ejecucion CLI,--type,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,93,Contexto del comando en archivo fuente. help='Filtra por tipo de extensión unificada.' +Parametros de ejecucion CLI,directory,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,96,Contexto del comando en archivo fuente. help='Directorio fuente que contiene plugin.info.' +Parametros de ejecucion CLI,output,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,97,Contexto del comando en archivo fuente. help='Archivo .lcp de salida.' +Parametros de ejecucion CLI,--force,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,98,Contexto del comando en archivo fuente. help='Sobrescribe el paquete de salida existente.' +Parametros de ejecucion CLI,--signing-key,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,101,Contexto del comando en archivo fuente. help='Clave privada Ed25519 PEM para firmar el LCP.' +Parametros de ejecucion CLI,plugin_id,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/plugin.py,56,Contexto del comando en archivo fuente. help='Identificador del complemento instalado.' +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,35,Contexto del comando en archivo fuente. help='Devuelve JSON.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,39,Contexto del comando en archivo fuente. help='Archivo de salida; se añade .vlf si falta.' +Parametros de ejecucion CLI,--name,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,40,Contexto del comando en archivo fuente. help='Nombre humano del proyecto.' +Parametros de ejecucion CLI,--description,str,'',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,41,Contexto del comando en archivo fuente. help='Descripción general.' +Parametros de ejecucion CLI,--author,str,getpass.getuser(),Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,42,Contexto del comando en archivo fuente. help='Autor del proyecto.' +Parametros de ejecucion CLI,--lan-name,str,'',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,43,Contexto del comando en archivo fuente. help='Nombre humano de la LAN.' +Parametros de ejecucion CLI,--location,str,'',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,44,Contexto del comando en archivo fuente. help='Ubicación física.' +Parametros de ejecucion CLI,--company,str,'',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,45,Contexto del comando en archivo fuente. help='Empresa u organización.' +Parametros de ejecucion CLI,--responsible,str,'',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,46,Contexto del comando en archivo fuente. help='Responsable de la LAN.' +Parametros de ejecucion CLI,--empty,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,47,Contexto del comando en archivo fuente. help=argparse.SUPPRESS +Parametros de ejecucion CLI,--clone-current,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,52,Contexto del comando en archivo fuente. help='Crea el proyecto copiando explícitamente el inventario y grupos activos.' +Parametros de ejecucion CLI,--force,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,57,Contexto del comando en archivo fuente. help='Sobrescribe un VLF existente.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,63,Contexto del comando en archivo fuente. help='Proyecto VLF existente.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,70,Contexto del comando en archivo fuente. help='Proyecto VLF.' +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,71,Contexto del comando en archivo fuente. help='Devuelve JSON.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,75,Contexto del comando en archivo fuente. help='Proyecto VLF.' +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,76,Contexto del comando en archivo fuente. help='Devuelve JSON.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,80,Contexto del comando en archivo fuente. help='Proyecto VLF existente.' +Parametros de ejecucion CLI,file,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/project.py,84,Contexto del comando en archivo fuente. help='Proyecto VLF.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/protocol.py,17,"Contexto del comando en archivo fuente. help='IP, MAC o alias.'" +Parametros de ejecucion CLI,action,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/protocol.py,18,"Contexto del comando en archivo fuente. choices=('show', 'configure'); help='Consulta o modifica el protocolo.'" +Parametros de ejecucion CLI,protocol,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/protocol.py,21,Contexto del comando en archivo fuente. help='Protocolo que se configura.' +Parametros de ejecucion CLI,--port,int,22,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/protocol.py,22,Contexto del comando en archivo fuente. help='Puerto remoto.' +Parametros de ejecucion CLI,--driver,str,'autodetect',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/protocol.py,23,Contexto del comando en archivo fuente. help='Controlador del dispositivo.' +Parametros de ejecucion CLI,--host-key,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/protocol.py,24,Contexto del comando en archivo fuente. help='Algoritmo de clave de host permitido; se puede repetir.' +Parametros de ejecucion CLI,--kex,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/protocol.py,30,Contexto del comando en archivo fuente. help='Algoritmo de intercambio de claves; se puede repetir.' +Parametros de ejecucion CLI,--profile,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/protocol.py,36,Contexto del comando en archivo fuente. choices=tuple(SSH_PROFILES); help='Perfil SSH reutilizable.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/protocol.py,37,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,23,"Contexto del comando en archivo fuente. help='IP, MAC o alias del elemento.'" +Parametros de ejecucion CLI,action,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,24,"Contexto del comando en archivo fuente. choices=('probe', 'configure', 'open')" +Parametros de ejecucion CLI,--mode,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,25,Contexto del comando en archivo fuente. choices=MODES +Parametros de ejecucion CLI,--port,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,26,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--executable,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,27,"Contexto del comando en archivo fuente. help=""Ruta por dispositivo; usa 'auto' para detección automática.""" +Parametros de ejecucion CLI,--through,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,30,Contexto del comando en archivo fuente. help='Servidor intermedio HOST:PUERTO.' +Parametros de ejecucion CLI,--fullscreen,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,31,Contexto del comando en archivo fuente. help='Abre control o vista a pantalla completa.' +Parametros de ejecucion CLI,--color-depth,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,34,"Contexto del comando en archivo fuente. choices=COLOR_DEPTHS; help='Profundidad de color de Radmin (1, 2, 4, 8, 16 o 24 bits).'" +Parametros de ejecucion CLI,--updates,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,40,Contexto del comando en archivo fuente. help='Máximo de actualizaciones de pantalla por segundo (1-120).' +Parametros de ejecucion CLI,--phonebook,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,45,Contexto del comando en archivo fuente. help='Phonebook .rpb administrado por Radmin.' +Parametros de ejecucion CLI,--phonebook-id,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,46,Contexto del comando en archivo fuente. help='Identificador de entrada dentro del phonebook de Radmin.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,51,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--store,str,config['credentials'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/radmin.py,52,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,-list / --list,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/recurrent.py,28,Contexto del comando en archivo fuente. dest='list_elements'; required=True; help='Lista todos los elementos recurrentes sin sus IP.' +Parametros de ejecucion CLI,-f / --format,str,'table',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/recurrent.py,36,"Contexto del comando en archivo fuente. choices=('table', 'json', 'csv', 'html', 'xml', 'yaml'); help='Formato de salida (por defecto: table).'" +Parametros de ejecucion CLI,-o / --output,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/recurrent.py,43,Contexto del comando en archivo fuente. help='Guarda la salida en un archivo.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/scan.py,30,"Contexto del comando en archivo fuente. help='IP, MAC o alias registrado en LANCTL.'" +Parametros de ejecucion CLI,--ports,str,'common',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/scan.py,31,"Contexto del comando en archivo fuente. help='Puertos o rangos: 22,80,443,8000-8100 (por defecto: common).'" +Parametros de ejecucion CLI,--all-ports,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/scan.py,37,Contexto del comando en archivo fuente. help='Autoriza explícitamente el escaneo TCP 1-65535.' +Parametros de ejecucion CLI,--timeout,float,0.5,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/scan.py,42,"Contexto del comando en archivo fuente. help='Tiempo máximo por conexión, en segundos.'" +Parametros de ejecucion CLI,--workers,int,128,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/scan.py,45,Contexto del comando en archivo fuente. help='Número máximo de conexiones simultáneas.' +Parametros de ejecucion CLI,--banners,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/scan.py,48,Contexto del comando en archivo fuente. help='Lee banners pasivos; no envía sondas específicas de protocolo.' +Parametros de ejecucion CLI,--identify,'store_true',"bool(config.get('serviceIdentification', True))",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/scan.py,53,Contexto del comando en archivo fuente. help='Reconoce servicios y deduce el tipo de dispositivo con evidencias.' +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/scan.py,59,Contexto del comando en archivo fuente. help='Salida JSON.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/scan.py,60,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/search.py,31,"Contexto del comando en archivo fuente. help='Alias, nombre, IP o MAC exactos.'" +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/search.py,32,Contexto del comando en archivo fuente. help='Devuelve el registro completo como JSON para scripts.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/search.py,37,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--startup-interface,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,49,"Contexto del comando en archivo fuente. choices=('cli', 'tui', 'gui'); help='Interfaz preferida al abrir LANCTL sin argumentos.'" +Parametros de ejecucion CLI,--close-gui-on-launch,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,54,"Contexto del comando en archivo fuente. choices=('on', 'off'); help='Cierra la GUI principal cuando el launcher solicitado esté disponible.'" +Parametros de ejecucion CLI,-range,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,59,"Contexto del comando en archivo fuente. dest='network_range'; help='Rango LAN predeterminado, por ejemplo 192.168.1.1/24.'" +Parametros de ejecucion CLI,-list-fields / --list-fields / -list,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,65,"Contexto del comando en archivo fuente. nargs='+'; help='Columnas mostradas por list, separadas por espacios o comas.'" +Parametros de ejecucion CLI,-dhcp-range / --dhcp-range / -dhcp,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,73,"Contexto del comando en archivo fuente. help=""Rango DHCP manual. Usa 'off' para dejarlo sin configurar.""" +Parametros de ejecucion CLI,-credentials / --credentials,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,80,Contexto del comando en archivo fuente. help='Ruta del almacén de credenciales cifradas.' +Parametros de ejecucion CLI,-discovery / --discovery,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,86,"Contexto del comando en archivo fuente. choices=('icmp', 'arp', 'hybrid'); help='Método predeterminado utilizado por list.'" +Parametros de ejecucion CLI,--scan-profile,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,92,"Contexto del comando en archivo fuente. choices=tuple(SCAN_PROFILES); help='Perfil predeterminado de list: fast, normal o accurate.'" +Parametros de ejecucion CLI,--progress,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,97,"Contexto del comando en archivo fuente. choices=('on', 'off'); help='Activa o desactiva el progreso interactivo.'" +Parametros de ejecucion CLI,--service-identification,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,100,"Contexto del comando en archivo fuente. choices=('on', 'off'); help='Activa o desactiva el reconocimiento de servicios en scan.'" +Parametros de ejecucion CLI,--disconnected-retention,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,105,"Contexto del comando en archivo fuente. choices=RETENTION_MODES; help='Persistencia de desconectados: permanent, session o forget.'" +Parametros de ejecucion CLI,--disconnected-target,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,110,Contexto del comando en archivo fuente. choices=RETENTION_TARGETS; help='Aplica la retención solo a CNF=X (unconfirmed) o a todos (all).' +Parametros de ejecucion CLI,--disconnected-scope,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,115,Contexto del comando en archivo fuente. choices=RETENTION_SCOPES; help='Aplica la regla a toda la LAN (all) o solo al rango DHCP (dhcp).' +Parametros de ejecucion CLI,--workers,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,120,Contexto del comando en archivo fuente. help='Concurrencia predeterminada de los escaneos.' +Parametros de ejecucion CLI,--timeout,float,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,121,Contexto del comando en archivo fuente. help='Timeout predeterminado por operación de red.' +Parametros de ejecucion CLI,--scan-order,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,124,"Contexto del comando en archivo fuente. choices=SCAN_ORDERS; help='Orden predeterminado de sondeo: ascending, descending o random.'" +Parametros de ejecucion CLI,--max-hosts,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,129,Contexto del comando en archivo fuente. help='Máximo de hosts autorizado por escaneo.' +Parametros de ejecucion CLI,--database,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,130,Contexto del comando en archivo fuente. help='Ruta del inventario de elementos.' +Parametros de ejecucion CLI,--physical-database,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,131,Contexto del comando en archivo fuente. help='Ruta de la base física SQLite administrada exclusivamente por LANWIRE.' +Parametros de ejecucion CLI,--groups,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,136,Contexto del comando en archivo fuente. help='Ruta de la base de grupos.' +Parametros de ejecucion CLI,--log,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,137,Contexto del comando en archivo fuente. help='Directorio de registros.' +Parametros de ejecucion CLI,--error-log-level,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,138,Contexto del comando en archivo fuente. help='Nivel mínimo de ErrorEvent escrito en el log (1 incluye diagnóstico detallado).' +Parametros de ejecucion CLI,--projects-directory,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,144,Contexto del comando en archivo fuente. help='Carpeta predeterminada para nombres de proyecto VLF relativos.' +Parametros de ejecucion CLI,-save-mode / --save-mode,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,149,"Contexto del comando en archivo fuente. help=""Política de guardado VLF. Usa 'list' para consultar las opciones integradas y las aportadas por plugins.""" +Parametros de ejecucion CLI,-save-interval / --save-interval,float,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,158,Contexto del comando en archivo fuente. help='Intervalo de automatic.timeToSave en minutos (mínimo 0.1).' +Parametros de ejecucion CLI,--cli-exit-save-prompt,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,165,"Contexto del comando en archivo fuente. choices=('on', 'off'); help='Consulta si se guarda al terminar cada comando individual de consola.'" +Parametros de ejecucion CLI,--cli-command-chaining,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,170,"Contexto del comando en archivo fuente. choices=('on', 'off'); help='Permite encadenar órdenes con ; dentro de la CLI interactiva.'" +Parametros de ejecucion CLI,-log-cleanup / --log-cleanup,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,175,"Contexto del comando en archivo fuente. choices=('on', 'off'); help='Activa o desactiva la limpieza automática de logs antiguos.'" +Parametros de ejecucion CLI,-log-retention-days / --log-retention-days,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,181,Contexto del comando en archivo fuente. help='Días durante los que se conservan los archivos de log.' +Parametros de ejecucion CLI,--remote-access,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,188,"Contexto del comando en archivo fuente. choices=('on', 'off'); help='Activa el acceso SSH restringido.'" +Parametros de ejecucion CLI,--remote-bind,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,191,Contexto del comando en archivo fuente. help='IPv4 local de escucha SSH.' +Parametros de ejecucion CLI,--remote-cidr,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,192,Contexto del comando en archivo fuente. help='Red de origen autorizada.' +Parametros de ejecucion CLI,--remote-port,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,193,Contexto del comando en archivo fuente. help='Puerto del servidor SSH remoto.' +Parametros de ejecucion CLI,--remote-password-auth,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,194,"Contexto del comando en archivo fuente. choices=('on', 'off'); help='Permite o bloquea autenticación SSH mediante contraseña.'" +Parametros de ejecucion CLI,--remote-backend,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,199,"Contexto del comando en archivo fuente. choices=('service', 'user'); help='Ejecuta el backend como servicio persistente o proceso de usuario.'" +Parametros de ejecucion CLI,--remote-forced-view,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,204,"Contexto del comando en archivo fuente. choices=('off', 'gui', 'tui', 'plugins', 'projects', 'settings'); help='Vista predeterminada para root forced-view.'" +Parametros de ejecucion CLI,--tui-key,'append',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,209,Contexto del comando en archivo fuente. help='Asigna una tecla a una acción del TUI. Puede repetirse.' +Parametros de ejecucion CLI,--tui-layout,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,215,Contexto del comando en archivo fuente. choices=PANEL_LAYOUTS; help='Coloca el CLI arriba (cli.top) o abajo (cli.bottom).' +Parametros de ejecucion CLI,--tui-cli-percent,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,220,Contexto del comando en archivo fuente. help='Porcentaje vertical reservado al CLI; ListElement conserva al menos 25%%.' +Parametros de ejecucion CLI,--tui-column,'append',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,225,Contexto del comando en archivo fuente. help='Peso de columna (GROUP=15%%); IP=15ch y MAC=17ch son fijas.' +Parametros de ejecucion CLI,--tui-footer-buttons,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,231,"Contexto del comando en archivo fuente. help='Acciones visibles en la barra inferior, separadas por comas; usa all para todas.'" +Parametros de ejecucion CLI,--tui-footer-button,'append',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings.py,236,Contexto del comando en archivo fuente. help='Muestra u oculta una acción concreta de la barra inferior. Puede repetirse.' +Parametros de ejecucion CLI,--menu,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py,15,Contexto del comando en archivo fuente. help='Editor interactivo por categorías de programa y proyecto.' +Parametros de ejecucion CLI,--catalog,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py,20,"Contexto del comando en archivo fuente. help='Lista todos los ajustes por categorías, con valor y estado editable.'" +Parametros de ejecucion CLI,--get,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py,25,"Contexto del comando en archivo fuente. help='Consulta un ajuste por su ruta, por ejemplo ip.workers.'" +Parametros de ejecucion CLI,--set,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py,28,Contexto del comando en archivo fuente. nargs=2; help='Modifica un ajuste; listas y booleanos usan JSON.' +Parametros de ejecucion CLI,--scope,str,'program',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py,34,"Contexto del comando en archivo fuente. choices=('program', 'project'); help='Ámbito de configuración (predeterminado: program).'" +Parametros de ejecucion CLI,--category,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py,40,"Contexto del comando en archivo fuente. help='Filtra el catálogo por categoría, por ejemplo network o monitor.'" +Parametros de ejecucion CLI,name,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,30,Contexto del comando en archivo fuente. nargs='?'; help='Servidor/dispositivo (sin acción equivale a info).' +Parametros de ejecucion CLI,action,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,33,"Contexto del comando en archivo fuente. nargs='?'; help='scan, info, shares, open, printers, workgroups, connect, disconnect, status o printer.'" +Parametros de ejecucion CLI,resource,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,38,Contexto del comando en archivo fuente. nargs='?'; help='Carpeta o impresora compartida.' +Parametros de ejecucion CLI,resource_action,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,39,"Contexto del comando en archivo fuente. nargs='?'; choices=('open', 'queue', 'connect'); help='Acción sobre la impresora.'" +Parametros de ejecucion CLI,--network,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,45,Contexto del comando en archivo fuente. help='Examina todo el inventario LANCTL.' +Parametros de ejecucion CLI,--group,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,48,Contexto del comando en archivo fuente. help='Limita el escaneo a un grupo LANCTL.' +Parametros de ejecucion CLI,--timeout,float,config['timeout'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,49,Contexto del comando en archivo fuente. help='Tiempo máximo del probe TCP.' +Parametros de ejecucion CLI,--workers,int,"min(32, int(config['workers']))",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,52,Contexto del comando en archivo fuente. help='Número máximo de probes concurrentes.' +Parametros de ejecucion CLI,--anonymous,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,58,Contexto del comando en archivo fuente. help='No carga credenciales asociadas.' +Parametros de ejecucion CLI,--include-system,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,61,Contexto del comando en archivo fuente. help='Incluye recursos administrativos y especiales.' +Parametros de ejecucion CLI,--dry-run,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,66,"Contexto del comando en archivo fuente. help='Muestra el plan sin autenticar, abrir ni mutar.'" +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,69,Contexto del comando en archivo fuente. help='Confirma una conexión de impresora.' +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,70,Contexto del comando en archivo fuente. help='Emite JSON estructurado.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,71,Contexto del comando en archivo fuente. help='Archivo JSON del inventario.' +Parametros de ejecucion CLI,--store,str,config['credentials'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,74,Contexto del comando en archivo fuente. help='Almacén DPAPI de credenciales.' +Parametros de ejecucion CLI,--storage,str,config['smbStorage'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/smb.py,77,Contexto del comando en archivo fuente. help='Directorio de observaciones de plugins.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ssh.py,24,"Contexto del comando en archivo fuente. help='IP, MAC o alias.'" +Parametros de ejecucion CLI,action,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ssh.py,25,"Contexto del comando en archivo fuente. choices=('probe', 'fingerprint', 'trust', 'open', 'show'); help='Operación SSH.'" +Parametros de ejecucion CLI,remote_command,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ssh.py,28,"Contexto del comando en archivo fuente. nargs='*'; help='Huella o comando remoto, según la operación.'" +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ssh.py,34,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--store,str,config['credentials'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ssh.py,37,Contexto del comando en archivo fuente. help='Almacén cifrado de credenciales.' +Parametros de ejecucion CLI,--host,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/ssh.py,40,"Contexto del comando en archivo fuente. help='IP candidata para probe/fingerprint, sin modificar la base de datos.'" +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/switch.py,48,"Contexto del comando en archivo fuente. help='IP, MAC o alias del switch.'" +Parametros de ejecucion CLI,--profile,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/switch.py,49,Contexto del comando en archivo fuente. help='Perfil Cisco que remapea los puertos.' +Parametros de ejecucion CLI,--profiles,str,"config.get('ciscoProfiles', str(PROFILE_PATH))",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/switch.py,50,Contexto del comando en archivo fuente. help='Archivo JSON que contiene los perfiles Cisco.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/switch.py,55,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--dry-run,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/switch.py,60,Contexto del comando en archivo fuente. help='Solo muestra el plan.' +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/switch.py,61,Contexto del comando en archivo fuente. help='Confirma cambios sin preguntar.' +Parametros de ejecucion CLI,arguments,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/switch.py,62,Contexto del comando en archivo fuente. nargs=argparse.REMAINDER; help='Acción Cisco gestionada que se quiere planificar.' +Parametros de ejecucion CLI,selector,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/terminal.py,19,"Contexto del comando en archivo fuente. help='IP, MAC o alias del elemento.'" +Parametros de ejecucion CLI,-p / --protocol,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/terminal.py,20,Contexto del comando en archivo fuente. help='Protocolo si hay varias terminales.' +Parametros de ejecucion CLI,--native,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/terminal.py,21,Contexto del comando en archivo fuente. help='Usa el cliente SSH nativo sin la capa de color de LANCTL.' +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/terminal.py,26,Contexto del comando en archivo fuente. help='Archivo JSON de elementos.' +Parametros de ejecucion CLI,--store,str,config['credentials'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/terminal.py,29,Contexto del comando en archivo fuente. help='Almacén cifrado de credenciales.' +Parametros de ejecucion CLI,words,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,33,Contexto del comando en archivo fuente. nargs='*'; help='NAME [wakeup|status|shutdown|restart|sleep|hibernate|configure] o sequence ...' +Parametros de ejecucion CLI,-if / --if,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,38,Contexto del comando en archivo fuente. dest='conditions' +Parametros de ejecucion CLI,--if-all,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,41,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--if-any,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,42,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--if-not,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,43,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,-t / --time,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,44,Contexto del comando en archivo fuente. dest='schedule' +Parametros de ejecucion CLI,--message,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,45,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--force,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,46,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--cancel,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,47,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--broadcast,str,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,48,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--port,int,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,49,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--repeat,int,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,50,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--interval,float,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,51,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--wait,float,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,52,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--method,str,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,53,"Contexto del comando en archivo fuente. choices=('auto', 'arp', 'ping', 'port')" +Parametros de ejecucion CLI,--check-port,int,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,54,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--interface,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,55,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--retry,int,0,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,56,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--dry-run,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,57,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,58,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--quiet,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,59,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--group,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,60,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--all,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,61,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,62,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--after,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,63,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--delay,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,64,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--timeout,float,60,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,65,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--on-failure,str,'stop',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,66,"Contexto del comando en archivo fuente. choices=('stop', 'continue', 'retry')" +Parametros de ejecucion CLI,--cooldown,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,67,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--max-attempts,int,1,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,68,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--power-transport,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,69,"Contexto del comando en archivo fuente. choices=('ssh', 'disabled')" +Parametros de ejecucion CLI,--power-platform,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,70,"Contexto del comando en archivo fuente. choices=('windows', 'linux')" +Parametros de ejecucion CLI,--power-command,'append',[],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,71,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--database,str,config['database'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,72,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--store,str,config['credentials'],Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,73,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--sequences,str,"config.get('wolSequences', 'data/lc/wol-sequences.json')",Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/commands/wol.py,74,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--version,'version',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/main.py,117,Contexto del comando en archivo fuente. help='Muestra la versión y termina.' +Parametros de ejecucion CLI,--quiet,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/main.py,124,Contexto del comando en archivo fuente. help='Omite la salida correcta; conserva errores.' +Parametros de ejecucion CLI,--verbose,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/main.py,127,Contexto del comando en archivo fuente. help='Añade diagnóstico de ejecución a stderr.' +Parametros de ejecucion CLI,--gui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/main.py,131,Contexto del comando en archivo fuente. help='Abre la interfaz gráfica de LANIP.' +Parametros de ejecucion CLI,--cli / -cli,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/main.py,136,Contexto del comando en archivo fuente. help=t('LANCTL.CORE.APP.CLI_HELP') +Parametros de ejecucion CLI,-tui / --tui,str.casefold,None,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/main.py,142,"Contexto del comando en archivo fuente. nargs='?'; choices=('inventory', 'plugins', 'projects', 'settings'); help=f""{t('LANCTL.CORE.APP.TUI_HELP')} Puede abrir directamente PLUGINS, PROJECTS o SETTINGS.""" +Parametros de ejecucion CLI,-project / --project,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/apps/ip/interfaces/cli/main.py,156,Contexto del comando en archivo fuente. dest='startup_project'; help='Selecciona un proyecto VLF antes de abrir el TUI o ejecutar un comando.' +Parametros de ejecucion CLI,words,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,48,"Contexto del comando en archivo fuente. nargs='*'; help='attach, detach, status, once, session, incidents, incident, service o foreground.'" +Parametros de ejecucion CLI,--project,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,53,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--permanent,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,54,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--duration,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,55,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--mode,str,'temporary',Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,56,"Contexto del comando en archivo fuente. choices=('permanent', 'temporary', 'diagnostic', 'once')" +Parametros de ejecucion CLI,--authority,str,'observe',Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,59,"Contexto del comando en archivo fuente. choices=('observe', 'operate', 'administer')" +Parametros de ejecucion CLI,--json,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,62,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--yes,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,63,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--interval,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,64,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--every,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,65,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--group,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,66,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--type,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,67,"Contexto del comando en archivo fuente. choices=('presence', 'services', 'ports', 'identity', 'smb', 'full')" +Parametros de ejecucion CLI,--fast,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,70,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--unknown,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,71,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--follow,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,72,Contexto del comando en archivo fuente. +Parametros de ejecucion CLI,--sessions,str,config['monitorRuntime'],Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,73,Contexto del comando en archivo fuente. help='Estado runtime de sesiones.' +Parametros de ejecucion CLI,--incidents-store,str,config['monitorIncidents'],Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,76,Contexto del comando en archivo fuente. help='Estado runtime de incidencias.' +Parametros de ejecucion CLI,--lock,str,config['monitorLock'],Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,81,Contexto del comando en archivo fuente. help='Lock singleton del monitor.' +Parametros de ejecucion CLI,--monitor-db,str,config['monitorDatabase'],Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,84,Contexto del comando en archivo fuente. help='Repositorio SQLite del monitor.' +Parametros de ejecucion CLI,--profiles,str,config['monitorProfiles'],Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,87,Contexto del comando en archivo fuente. help='Perfiles personalizados.' +Parametros de ejecucion CLI,--assignments-store,str,config['monitorAssignments'],Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,90,Contexto del comando en archivo fuente. help='Asignaciones persistentes.' +Parametros de ejecucion CLI,--profile,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,95,Contexto del comando en archivo fuente. help='Perfil monitor.' +Parametros de ejecucion CLI,--priority,str,'normal',Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,96,"Contexto del comando en archivo fuente. choices=('low', 'normal', 'high', 'critical'); help='Prioridad de asignación.'" +Parametros de ejecucion CLI,--check,'append',[],Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,102,"Contexto del comando en archivo fuente. help='Check ping, arp o port:NN.'" +Parametros de ejecucion CLI,--presence,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,103,Contexto del comando en archivo fuente. help='Intervalo de presencia.' +Parametros de ejecucion CLI,--discovery,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,104,Contexto del comando en archivo fuente. help='Intervalo de descubrimiento.' +Parametros de ejecucion CLI,--services,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,105,Contexto del comando en archivo fuente. help='Intervalo de servicios.' +Parametros de ejecucion CLI,--deep,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,106,Contexto del comando en archivo fuente. help='Intervalo profundo.' +Parametros de ejecucion CLI,--workers,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,107,Contexto del comando en archivo fuente. help='Workers del perfil.' +Parametros de ejecucion CLI,--timeout,float,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANMON,Línea de comandos,por invocación,,src/lanctl/apps/monitor/commands.py,108,Contexto del comando en archivo fuente. help='Timeout del perfil.' +Parametros de ejecucion CLI,--version,'version',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANRACK,Línea de comandos,por invocación,,src/lanctl/apps/rack/cli.py,27,Contexto del comando en archivo fuente. help='Muestra la versión común de la suite y termina.' +Parametros de ejecucion CLI,--database,str,"load_config().get('physicalDatabase', DEFAULT_DATABASE_PATH)",Invocación; no persistente salvo comando que guarda,LANRACK,Línea de comandos,por invocación,,src/lanctl/apps/rack/cli.py,33,Contexto del comando en archivo fuente. help='Base física IDF compartida.' +Parametros de ejecucion CLI,--gui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANRACK,Línea de comandos,por invocación,,src/lanctl/apps/rack/cli.py,40,Contexto del comando en archivo fuente. help='Abre la interfaz gráfica de escritorio.' +Parametros de ejecucion CLI,-tui / --tui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANRACK,Línea de comandos,por invocación,,src/lanctl/apps/rack/cli.py,41,Contexto del comando en archivo fuente. help='Abre la interfaz de pantalla completa.' +Parametros de ejecucion CLI,--cli / -cli,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANRACK,Línea de comandos,por invocación,,src/lanctl/apps/rack/cli.py,44,Contexto del comando en archivo fuente. help='Abre la consola interactiva.' +Parametros de ejecucion CLI,rack,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANRACK,Línea de comandos,por invocación,,src/lanctl/apps/rack/cli.py,48,Contexto del comando en archivo fuente. help='ID o nombre del rack.' +Parametros de ejecucion CLI,--version,'version',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,30,Contexto del comando en archivo fuente. help='Muestra la versión común de la suite y termina.' +Parametros de ejecucion CLI,--database,str,"load_config().get('physicalDatabase', DEFAULT_DATABASE_PATH)",Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,36,Contexto del comando en archivo fuente. help='Base física IDF; por defecto usa physical/idf.db en la raíz compartida.' +Parametros de ejecucion CLI,--gui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,43,Contexto del comando en archivo fuente. help='Abre la interfaz gráfica de escritorio.' +Parametros de ejecucion CLI,-tui / --tui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,44,Contexto del comando en archivo fuente. help='Abre la interfaz de pantalla completa.' +Parametros de ejecucion CLI,--cli / -cli,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,47,Contexto del comando en archivo fuente. help='Abre la consola interactiva de LANWIRE.' +Parametros de ejecucion CLI,prefix,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,56,Contexto del comando en archivo fuente. nargs='?'; help='Filtra por prefijo IDF.' +Parametros de ejecucion CLI,idf,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,59,Contexto del comando en archivo fuente. help='Identificador físico que se desea consultar.' +Parametros de ejecucion CLI,prefix,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,61,Contexto del comando en archivo fuente. help='Prefijo del tipo de elemento físico.' +Parametros de ejecucion CLI,--digits,int,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,62,"Contexto del comando en archivo fuente. choices=range(2, 6); help='Cantidad de dígitos del contador (2 a 5).'" +Parametros de ejecucion CLI,-more / --more,int,1,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,65,Contexto del comando en archivo fuente. help='Crea N IDF consecutivos.' +Parametros de ejecucion CLI,prefix,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,71,Contexto del comando en archivo fuente. nargs='?'; help='Prefijo cuyos elementos se listan.' +Parametros de ejecucion CLI,code,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,74,Contexto del comando en archivo fuente. help='Prefijo o IDF concreto.' +Parametros de ejecucion CLI,code,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,76,Contexto del comando en archivo fuente. help='Prefijo o IDF concreto.' +Parametros de ejecucion CLI,data,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,77,Contexto del comando en archivo fuente. nargs='*'; help='Datos del IDF.' +Parametros de ejecucion CLI,-type,str,'',Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,78,Contexto del comando en archivo fuente. dest='element_type'; help='Nuevo perfil del prefijo.' +Parametros de ejecucion CLI,-name,str,'',Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,81,Contexto del comando en archivo fuente. help='Nombre del prefijo.' +Parametros de ejecucion CLI,-alias,str,'',Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,82,Contexto del comando en archivo fuente. help='Alias del prefijo.' +Parametros de ejecucion CLI,-description,str,'',Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,83,Contexto del comando en archivo fuente. help='Descripción del prefijo.' +Parametros de ejecucion CLI,code,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,85,Contexto del comando en archivo fuente. help='IDF concreto; no elimina prefijos.' +Parametros de ejecucion CLI,-type,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,95,Contexto del comando en archivo fuente. required=True; dest='element_type'; help='Perfil físico.' +Parametros de ejecucion CLI,idf,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,97,Contexto del comando en archivo fuente. help='IDF exacto que se desea reservar.' +Parametros de ejecucion CLI,data,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,98,Contexto del comando en archivo fuente. nargs='*'; help='Datos iniciales opcionales.' +Parametros de ejecucion CLI,idf,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,104,Contexto del comando en archivo fuente. help='IDF que se desea consultar o actualizar.' +Parametros de ejecucion CLI,data,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,105,Contexto del comando en archivo fuente. nargs='*'; help='Campos físicos que se desean modificar.' +Parametros de ejecucion CLI,idf,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,109,Contexto del comando en archivo fuente. help='IDF que se desea eliminar.' +Parametros de ejecucion CLI,letters,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,115,Contexto del comando en archivo fuente. help='Letras del prefijo.' +Parametros de ejecucion CLI,letters,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,117,Contexto del comando en archivo fuente. help='Letras del prefijo.' +Parametros de ejecucion CLI,name,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,118,Contexto del comando en archivo fuente. help='Nombre descriptivo del tipo.' +Parametros de ejecucion CLI,description,str,'',Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,119,Contexto del comando en archivo fuente. nargs='?'; help='Descripción opcional.' +Parametros de ejecucion CLI,letters,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,123,Contexto del comando en archivo fuente. help='Letras del prefijo que se desea eliminar.' +Parametros de ejecucion CLI,code,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,89,Contexto del comando en archivo fuente. help='Prefijo para new o IDF exacto para add.' +Parametros de ejecucion CLI,-name,str,'',Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,90,Contexto del comando en archivo fuente. help='Nombre del registro.' +Parametros de ejecucion CLI,-alias,str,'',Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,91,Contexto del comando en archivo fuente. help='Alias opcional.' +Parametros de ejecucion CLI,-description / -descriptionn,str,'',Invocación; no persistente salvo comando que guarda,LANWIRE,Línea de comandos,por invocación,,src/lanctl/apps/wire/cli/main.py,92,Contexto del comando en archivo fuente. help='Descripción opcional.' +Parametros de ejecucion CLI,--version,'version',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanctl.py,39,Contexto del comando en archivo fuente. help='Muestra la versión común de la suite y termina.' +Parametros de ejecucion CLI,--cli / -cli,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanctl.py,46,Contexto del comando en archivo fuente. help='Abre la consola principal.' +Parametros de ejecucion CLI,-tui / --tui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanctl.py,47,Contexto del comando en archivo fuente. help='Abre el TUI principal.' +Parametros de ejecucion CLI,--gui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanctl.py,48,Contexto del comando en archivo fuente. help='Abre el centro gráfico de LANCTL.' +Parametros de ejecucion CLI,--admin,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanctl.py,49,Contexto del comando en archivo fuente. help='Solicita UAC explícitamente para un launcher instalado en Windows.' +Parametros de ejecucion CLI,arguments,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanctl.py,57,Contexto del comando en archivo fuente. nargs=argparse.REMAINDER; help=argparse.SUPPRESS +Parametros de ejecucion CLI,arguments,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanctl.py,62,Contexto del comando en archivo fuente. nargs=argparse.REMAINDER; help=argparse.SUPPRESS +Parametros de ejecucion CLI,--version,'version',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanmon.py,27,Contexto del comando en archivo fuente. help='Muestra la versión común de la suite y termina.' +Parametros de ejecucion CLI,--gui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanmon.py,38,Contexto del comando en archivo fuente. help='Abre la interfaz gráfica de escritorio.' +Parametros de ejecucion CLI,--cli / -cli,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanmon.py,39,Contexto del comando en archivo fuente. help='Abre la consola de comandos.' +Parametros de ejecucion CLI,--tui / -tui,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanmon.py,40,Contexto del comando en archivo fuente. help='Abre el visor tabular de eventos.' +Parametros de ejecucion CLI,--source,str,'all',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanmon.py,43,"Contexto del comando en archivo fuente. choices=('all', 'program', 'project'); help='Origen para logs.'" +Parametros de ejecucion CLI,--limit,int,100,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanmon.py,46,Contexto del comando en archivo fuente. help='Máximo de eventos (1-1000).' +Parametros de ejecucion CLI,--window,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanmon.py,47,Contexto del comando en archivo fuente. help='Abre logs en otra terminal y sigue el registro común.' +Parametros de ejecucion CLI,--level,int,1,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/bootstrap/lanmon.py,52,Contexto del comando en archivo fuente. help='Nivel mínimo (1-59); conserva líneas sin nivel.' +Parametros de ejecucion CLI,action,str,'status',Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/core/coordination_cli.py,16,"Contexto del comando en archivo fuente. nargs='?'; choices=('status', 'sessions', 'events', 'tasks', 'refresh')" +Parametros de ejecucion CLI,--session,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/core/coordination_cli.py,22,Contexto del comando en archivo fuente. help='ID exacto de la interfaz que se actualizará.' +Parametros de ejecucion CLI,--after,int,0,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/core/coordination_cli.py,23,Contexto del comando en archivo fuente. help='Cursor de eventos (seq).' +Parametros de ejecucion CLI,--limit,int,100,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/core/coordination_cli.py,24,"Contexto del comando en archivo fuente. help='Máximo de eventos, 1-1000.'" +Parametros de ejecucion CLI,--follow,'store_true',argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/core/coordination_cli.py,25,Contexto del comando en archivo fuente. help='Sigue eventos en vivo; Ctrl+C termina.' +Parametros de ejecucion CLI,plugin_arguments,str,argparse/servicio,Invocación; no persistente salvo comando que guarda,LANCTL/LANIP o comando delegado,Línea de comandos,por invocación,,src/lanctl/core/plugins/declarative_commands.py,29,Contexto del comando en archivo fuente. nargs=argparse.REMAINDER; help='Argumentos gestionados por el complemento.' +Modelos / FirewallRule,protocol,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/firewall.py,12, +Modelos / FirewallRule,name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/firewall.py,13, +Modelos / FirewallRule,bind,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/firewall.py,14, +Modelos / FirewallRule,cidr,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/firewall.py,15, +Modelos / FirewallRule,port,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/firewall.py,16, +Modelos / RemoteUser,userId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,51, +Modelos / RemoteUser,username,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,52, +Modelos / RemoteUser,roles,list[str],(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,53, +Modelos / RemoteUser,enabled,bool,True,Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,54, +Modelos / RemoteUser,expiresAt,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,55, +Modelos / RemoteUser,lockedUntil,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,56, +Modelos / RemoteUser,failedAttempts,int,0,Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,57, +Modelos / RemoteUser,passwordHash,str,'',Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,58, +Modelos / RemoteUser,sshKeys,list[str],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,59, +Modelos / RemoteUser,createdAt,str,'',Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,60, +Modelos / RemoteUser,updatedAt,str,'',Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,61, +Modelos / RemoteUser,passwordRotatedAt,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,62, +Modelos / AccessSession,sessionId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,67, +Modelos / AccessSession,userId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,68, +Modelos / AccessSession,authenticator,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,69, +Modelos / AccessSession,sourceIp,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,70, +Modelos / AccessSession,createdAt,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,71, +Modelos / AccessSession,expiresAt,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,72, +Modelos / AccessSession,csrfHash,str,'',Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,73, +Modelos / AccessSession,revokedAt,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANACCESS,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/access/models.py,74, +Modelos / DiscoveryResult,devices,"tuple[Device, ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/discovery.py,13, +Modelos / DiscoveryResult,source,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/discovery.py,14, +Modelos / DiscoveryResult,provider,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/discovery.py,15, +Modelos / DiscoveryResult,scenario_id,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/discovery.py,16, +Modelos / DiscoveryResult,seed,int | None,None,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/discovery.py,17, +Modelos / DiscoveryResult,metadata,"dict[str, Any]",field(default_factory=dict),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/discovery.py,18, +Modelos / Device,ip,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,138, +Modelos / Device,cnf,str,'X',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,139, +Modelos / Device,mac,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,140, +Modelos / Device,name,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,141, +Modelos / Device,default_name,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,142, +Modelos / Device,alias,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,143, +Modelos / Device,default_alias,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,144, +Modelos / Device,groups,list[str],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,145, +Modelos / Device,description,str,'-',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,146, +Modelos / Device,manufacturer,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,147, +Modelos / Device,name_deleted,bool,False,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,148, +Modelos / Device,alias_deleted,bool,False,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,149, +Modelos / Device,device_id,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,150, +Modelos / Device,idf,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,151, +Modelos / Device,protocols,list[str],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,152, +Modelos / Device,credentials,"dict[str, str]",field(default_factory=dict),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,153, +Modelos / Device,protocol_options,"dict[str, dict[str, Any]]",field(default_factory=dict),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,154, +Modelos / Device,discovery_methods,list[str],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,155, +Modelos / Device,last_discovery,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,156, +Modelos / Device,last_seen,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,157, +Modelos / Device,previous_ips,list[str],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,158, +Modelos / Device,icon_id,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,159, +Modelos / Device,JSON_FIELDS,"ClassVar[dict[str, str]]","{'IP': 'ip', 'cnf': 'cnf', 'ALIAS': 'alias', 'MAC': 'mac', 'NAME': 'name', 'GROUP': 'groups', 'description': 'description', 'manufacturer': 'manufacturer', 'defaultAlias': 'default_alias', 'defaultName': 'default_name', 'nameDeleted': 'name_deleted', 'aliasDeleted': 'alias_deleted', 'deviceId': 'device_id', 'idf': 'idf', 'protocols': 'protocols', 'credentials': 'credentials', 'protocolOptions': 'protocol_options', 'discoveryMethods': 'discovery_methods', 'lastDiscovery': 'last_discovery', 'lastSeen': 'last_seen', 'previousIPs': 'previous_ips', 'iconId': 'icon_id'}",Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/device.py,161, +Modelos / Group,name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/group.py,14, +Modelos / Group,description,str,'-',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/group.py,15, +Modelos / Group,members,list[str],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/group.py,16, +Modelos / Group,editable,bool,True,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/domain/models/group.py,17, +Modelos / CiscoContext,profile,SwitchProfile,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/context.py,10, +Modelos / CiscoContext,selected_port,PortProfile | None,None,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/context.py,11, +Modelos / ExecutionResult,status,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/executor.py,11, +Modelos / ExecutionResult,output,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/executor.py,12, +Modelos / PortProfile,id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,22, +Modelos / PortProfile,native,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,23, +Modelos / PortProfile,aliases,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,24, +Modelos / PortProfile,label,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,25, +Modelos / SwitchProfile,id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,33, +Modelos / SwitchProfile,model,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,34, +Modelos / SwitchProfile,ports,"tuple[PortProfile, ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,35, +Modelos / CommandSpec,id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,53, +Modelos / CommandSpec,path,"tuple[str, ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,54, +Modelos / CommandSpec,aliases,"tuple[tuple[str, ...], ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,55, +Modelos / CommandSpec,context,"tuple[str, ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,56, +Modelos / CommandSpec,risk,Risk,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,57, +Modelos / CommandSpec,help,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,58, +Modelos / CommandSpec,templates,"tuple[str, ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,59, +Modelos / CommandSpec,port_required,bool,False,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,60, +Modelos / CommandSpec,argument,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,61, +Modelos / CommandSpec,response_parser,"Callable[[str], Any] | None",None,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,62, +Modelos / CommandPlan,command_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,67, +Modelos / CommandPlan,device_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,68, +Modelos / CommandPlan,device_label,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,69, +Modelos / CommandPlan,endpoint,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,70, +Modelos / CommandPlan,risk,Risk,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,71, +Modelos / CommandPlan,native_commands,"tuple[str, ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,72, +Modelos / CommandPlan,target,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,73, +Modelos / CommandPlan,native_target,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,74, +Modelos / CommandPlan,arguments,"dict[str, str]",field(default_factory=dict),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/cisco/models.py,75, +Modelos / RadminLaunch,executable,Path,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/protocols/radmin.py,143, +Modelos / RadminLaunch,arguments,list[str],(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/protocols/radmin.py,144, +Modelos / RadminLaunch,process,object,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/protocols/radmin.py,145, +Modelos / SshProfile,port,int,22,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/protocols/ssh.py,42, +Modelos / SshProfile,driver,str,'autodetect',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/protocols/ssh.py,43, +Modelos / SshProfile,host_key_algorithms,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/protocols/ssh.py,44, +Modelos / SshProfile,kex_algorithms,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/protocols/ssh.py,45, +Modelos / SshProfile,fingerprint,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/protocols/ssh.py,46, +Modelos / OpenPort,port,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,112, +Modelos / OpenPort,service,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,113, +Modelos / OpenPort,banner,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,114, +Modelos / OpenPort,product,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,115, +Modelos / OpenPort,confidence,str,'low',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,116, +Modelos / OpenPort,evidence,str,'port mapping',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,117, +Modelos / DeviceIdentification,device_type,str,'unknown',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,122, +Modelos / DeviceIdentification,confidence,str,'low',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,123, +Modelos / DeviceIdentification,evidence,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,124, +Modelos / ElementScanResult,ip,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,129, +Modelos / ElementScanResult,reachable,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,130, +Modelos / ElementScanResult,latency_ms,float | None,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,131, +Modelos / ElementScanResult,ttl,int | None,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,132, +Modelos / ElementScanResult,hostname,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,133, +Modelos / ElementScanResult,observed_mac,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,134, +Modelos / ElementScanResult,scanned_ports,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,135, +Modelos / ElementScanResult,open_ports,list[OpenPort],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,136, +Modelos / ElementScanResult,identification,DeviceIdentification,field(default_factory=DeviceIdentification),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,137, +Modelos / ElementScanResult,duration,float,0.0,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/element_scanner.py,138, +Modelos / ScanProfile,name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/scan_profiles.py,8, +Modelos / ScanProfile,discovery,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/scan_profiles.py,9, +Modelos / ScanProfile,timeout_factor,float,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/scan_profiles.py,10, +Modelos / ScanProfile,workers_factor,float,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/scan_profiles.py,11, +Modelos / ScanProfile,attempts,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/scan_profiles.py,12, +Modelos / ScanProfile,resolve_names,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/scan_profiles.py,13, +Modelos / ScanProfile,extra_methods,"tuple[str, ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/infrastructure/services/scan_profiles.py,14, +Modelos / CliSelection,selector,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/cli/commands/modes.py,60, +Modelos / CliSelection,label,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/cli/commands/modes.py,61, +Modelos / GuiEdit,device_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/gui/main.py,40, +Modelos / GuiEdit,device_label,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/gui/main.py,41, +Modelos / GuiEdit,before,"dict[str, str]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/gui/main.py,42, +Modelos / GuiEdit,after,"dict[str, str]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/gui/main.py,43, +Modelos / GuiEditHistory,undo,list[GuiEdit],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/gui/main.py,48, +Modelos / GuiEditHistory,redo,list[GuiEdit],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/gui/main.py,49, +Modelos / TuiLayout,compact,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/layout.py,10, +Modelos / TuiLayout,modal_margin,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/layout.py,11, +Modelos / TuiLayout,modal_width,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/layout.py,12, +Modelos / TuiLayout,modal_height,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/layout.py,13, +Modelos / TuiLayout,body_rows,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/layout.py,14, +Modelos / HelpCommand,name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,9, +Modelos / HelpCommand,description,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,10, +Modelos / HelpCommand,usage,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,11, +Modelos / HelpCommand,aliases,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,12, +Modelos / HelpCommand,subcommands,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,13, +Modelos / HelpCommand,options,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,14, +Modelos / SettingField,key,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,19, +Modelos / SettingField,label,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,20, +Modelos / SettingField,option,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,21, +Modelos / SettingField,value,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,22, +Modelos / SettingField,original,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,23, +Modelos / SettingField,hint,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,24, +Modelos / SettingField,section,str,'GENERAL',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,25, +Modelos / SettingField,description,str,'Sin descripción disponible.',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,26, +Modelos / SettingField,choices,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,27, +Modelos / SettingField,visible,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,28, +Modelos / SettingField,original_visible,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,29, +Modelos / ModalState,kind,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,36, +Modelos / ModalState,title,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,37, +Modelos / ModalState,tabs,list[str],(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,38, +Modelos / ModalState,pages,list[list[str]],(requerido),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,39, +Modelos / ModalState,tab_index,int,0,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,40, +Modelos / ModalState,scroll,int,0,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,41, +Modelos / ModalState,selected,int,0,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,42, +Modelos / ModalState,items,list[Any],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,43, +Modelos / ModalState,footer,str,'←/→ sección ↑/↓ desplazar Esc cerrar',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,44, +Modelos / ModalState,background,list[str],field(default_factory=list),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,45, +Modelos / ModalState,editor_fresh,bool,True,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,46, +Modelos / ModalState,editing,bool,False,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,47, +Modelos / ModalState,edit_snapshot,str,'',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,48, +Modelos / ModalState,tab_selections,"dict[int, int]",field(default_factory=dict),Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,49, +Modelos / ModalState,max_width,int | None,None,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,50, +Modelos / ModalState,max_height,int | None,None,Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/modal.py,51, +Modelos / TuiTheme,accent,str,'bright_cyan',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/theme.py,8, +Modelos / TuiTheme,muted,str,'bright_black',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/theme.py,9, +Modelos / TuiTheme,selected,str,'bold black on bright_cyan',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/theme.py,10, +Modelos / TuiTheme,keycap,str,'bold black on bright_white',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/theme.py,11, +Modelos / TuiTheme,success,str,'bold green',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/theme.py,12, +Modelos / TuiTheme,warning,str,'bold yellow',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/theme.py,13, +Modelos / TuiTheme,error,str,'bold red',Datos de dominio/estado; no implica ajuste editable,LANIP,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/ip/interfaces/tui/theme.py,14, +Modelos / MonitorConfig,enabled,bool,False,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,52, +Modelos / MonitorConfig,profile,str,'normal',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,53, +Modelos / MonitorConfig,mode,str,'permanent',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,54, +Modelos / MonitorConfig,authority,str,'observe',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,55, +Modelos / MonitorConfig,interface,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,56, +Modelos / MonitorConfig,cidr,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,57, +Modelos / MonitorConfig,duration,float | None,None,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,58, +Modelos / MonitorAssignment,assignmentId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,238, +Modelos / MonitorAssignment,selector,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,239, +Modelos / MonitorAssignment,deviceId,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,240, +Modelos / MonitorAssignment,group,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,241, +Modelos / MonitorAssignment,priority,str,'normal',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,242, +Modelos / MonitorAssignment,profile,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,243, +Modelos / MonitorAssignment,checks,"tuple[dict, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,244, +Modelos / MonitorAssignment,enabled,bool,True,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,245, +Modelos / MonitorAssignment,source,str,'user',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,246, +Modelos / MonitorAssignment,createdAt,str,field(default_factory=utc_now),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,247, +Modelos / MonitorAssignment,updatedAt,str,field(default_factory=utc_now),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/configuration.py,248, +Modelos / NetworkIdentity,cidr,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/identity.py,8, +Modelos / NetworkIdentity,gatewayIp,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/identity.py,9, +Modelos / NetworkIdentity,gatewayMac,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/identity.py,10, +Modelos / NetworkIdentity,interface,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/identity.py,11, +Modelos / NetworkIdentity,localIp,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/identity.py,12, +Modelos / NetworkIdentity,confidence,str,'unknown',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/identity.py,13, +Modelos / NetworkIdentity,evidence,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/identity.py,14, +Modelos / MonitorProfile,profile_id,str,'default',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,20, +Modelos / MonitorProfile,presence_interval,float,60,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,21, +Modelos / MonitorProfile,critical_interval,float,15,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,22, +Modelos / MonitorProfile,discovery_interval,float,300,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,23, +Modelos / MonitorProfile,services_interval,float,1800,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,24, +Modelos / MonitorProfile,deep_interval,float,86400,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,25, +Modelos / MonitorProfile,timeout,float,0.8,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,26, +Modelos / MonitorProfile,workers,int,8,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,27, +Modelos / MonitorProfile,jitter,float,0.1,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,28, +Modelos / MonitorProfile,failure_threshold,int,3,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,29, +Modelos / MonitorProfile,recovery_threshold,int,2,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,30, +Modelos / MonitorTargetPlan,target,Any,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,37, +Modelos / MonitorTargetPlan,priority,str,'normal',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,38, +Modelos / MonitorTargetPlan,profile_id,str,'',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,39, +Modelos / MonitorTargetPlan,checks,"tuple[dict, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,40, +Modelos / MonitorSession,sessionId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,45, +Modelos / MonitorSession,runId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,46, +Modelos / MonitorSession,managerId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,47, +Modelos / MonitorSession,projectId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,48, +Modelos / MonitorSession,network,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,49, +Modelos / MonitorSession,interface,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,50, +Modelos / MonitorSession,localIp,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,51, +Modelos / MonitorSession,mode,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,52, +Modelos / MonitorSession,authority,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,53, +Modelos / MonitorSession,startedAt,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,54, +Modelos / MonitorSession,expiresAt,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,55, +Modelos / MonitorSession,status,str,'pending',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,56, +Modelos / MonitorSession,error,dict | None,None,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,57, +Modelos / CheckSpec,check_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,70, +Modelos / CheckSpec,owner,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,71, +Modelos / CheckSpec,handler,Any,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,72, +Modelos / CheckSpec,minimum_interval,float,10,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,73, +Modelos / CheckSpec,timeout,float,1,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,74, +Modelos / CheckSpec,critical,bool,False,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,75, +Modelos / CheckResult,checkId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,80, +Modelos / CheckResult,target,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,81, +Modelos / CheckResult,success,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,82, +Modelos / CheckResult,timestamp,str,field(default_factory=now_iso),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,83, +Modelos / CheckResult,latencyMs,float | None,None,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,84, +Modelos / CheckResult,evidence,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,85, +Modelos / CheckResult,metrics,dict,field(default_factory=dict),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,86, +Modelos / CheckResult,error,dict | None,None,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,87, +Modelos / DeviceState,deviceId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,92, +Modelos / DeviceState,presence,str,'unknown',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,93, +Modelos / DeviceState,health,str,'healthy',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,94, +Modelos / DeviceState,consecutiveFailures,int,0,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,95, +Modelos / DeviceState,consecutiveRecoveries,int,0,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,96, +Modelos / DeviceState,updatedAt,str,field(default_factory=now_iso),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,97, +Modelos / Incident,incidentId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,102, +Modelos / Incident,deviceId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,103, +Modelos / Incident,severity,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,104, +Modelos / Incident,cause,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,105, +Modelos / Incident,origin,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,106, +Modelos / Incident,openedAt,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,107, +Modelos / Incident,status,str,'open',Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,108, +Modelos / Incident,resolvedAt,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,109, +Modelos / Incident,correlationId,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,110, +Modelos / Incident,sessionId,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/models.py,111, +Modelos / ScheduledCheck,due,float,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,12, +Modelos / ScheduledCheck,sequence,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,13, +Modelos / ScheduledCheck,task_id,str,field(compare=False),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,14, +Modelos / ScheduledCheck,target,str,field(compare=False),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,15, +Modelos / ScheduledCheck,check_id,str,field(compare=False),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,16, +Modelos / ScheduledCheck,interval,float,field(compare=False),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,17, +Modelos / ScheduledCheck,timeout,float,field(compare=False),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,18, +Modelos / ScheduledCheck,handler,object,field(compare=False),Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,19, +Modelos / ScheduledCheck,failures,int,"field(default=0, compare=False)",Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,20, +Modelos / ScheduledCheck,cancelled,bool,"field(default=False, compare=False)",Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,21, +Modelos / ScheduledCheck,last_error,str,"field(default='', compare=False)",Datos de dominio/estado; no implica ajuste editable,LANMON,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/monitor/scheduler.py,22, +Modelos / CommandResult,lines,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/cli/commands.py,18, +Modelos / CommandResult,refresh,bool,False,Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/cli/commands.py,19, +Modelos / CommandResult,exit_requested,bool,False,Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/cli/commands.py,20, +Modelos / CommandResult,list_prefix,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/cli/commands.py,21, +Modelos / CommandResult,list_group,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/cli/commands.py,22, +Modelos / CommandResult,view_id,str | None,None,Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/cli/commands.py,23, +Modelos / CommandResult,graph,bool,False,Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/cli/commands.py,24, +Modelos / IDF,prefix,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/idf/idf.py,37, +Modelos / IDF,number,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/idf/idf.py,38, +Modelos / IDF,prefix_width,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/idf/idf.py,39, +Modelos / IDF,number_width,int,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/idf/idf.py,40, +Modelos / EditableField,label,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/tui/editor.py,17, +Modelos / EditableField,path,"tuple[str | int, ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/tui/editor.py,18, +Modelos / EditableField,value,Any,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/tui/editor.py,19, +Modelos / HelpEntry,name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/tui/help.py,12, +Modelos / HelpEntry,arguments,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/tui/help.py,13, +Modelos / HelpEntry,description,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/tui/help.py,14, +Modelos / HelpEntry,usage,str,(requerido),Datos de dominio/estado; no implica ajuste editable,LANWIRE/LANRACK,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/apps/wire/tui/help.py,15, +Modelos / Condition,text,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/conditions.py,22, +Modelos / Condition,kind,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/conditions.py,23, +Modelos / Condition,values,"tuple[str, ...]",(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/conditions.py,24, +Modelos / RetentionResult,persistent,list[Device],(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/device_retention.py,19, +Modelos / RetentionResult,visible,list[Device],(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/device_retention.py,20, +Modelos / RetentionResult,removed,"tuple[Device, ...]",(),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/device_retention.py,21, +Modelos / RetentionResult,session_only,"tuple[Device, ...]",(),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/device_retention.py,22, +Modelos / ScanDifferences,rows,list[Device],(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/differences.py,21, +Modelos / ScanDifferences,colors,"list[dict[str, str]]",(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/differences.py,22, +Modelos / ScanDifferences,new_devices,int,0,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/differences.py,23, +Modelos / ScanDifferences,ip_changes,int,0,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/differences.py,24, +Modelos / ScanDifferences,mac_conflicts,int,0,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/differences.py,25, +Modelos / ScanDifferences,disappeared_devices,int,0,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/differences.py,26, +Modelos / ScanDifferences,disappeared_ids,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/differences.py,27, +Modelos / ScanDifferences,pending_values,int,0,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/differences.py,28, +Modelos / ErrorCatalogEntry,error_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/error_catalog.py,15, +Modelos / ErrorCatalogEntry,level,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/error_catalog.py,16, +Modelos / ErrorCatalogEntry,source,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/error_catalog.py,17, +Modelos / ErrorCatalogEntry,line,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/error_catalog.py,18, +Modelos / ErrorCatalogEntry,origin,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/error_catalog.py,19, +Modelos / ErrorCatalogEntry,kind,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/error_catalog.py,20, +Modelos / ErrorEvent,level,str | int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/errors.py,115, +Modelos / ErrorEvent,origin,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/errors.py,116, +Modelos / ErrorEvent,code,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/errors.py,117, +Modelos / ErrorEvent,message,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/errors.py,118, +Modelos / ErrorEvent,recoverable,bool,True,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/errors.py,119, +Modelos / ErrorEvent,details,"Mapping[str, Any]",field(default_factory=dict),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/errors.py,120, +Modelos / ErrorEvent,correlation_id,str,field(default_factory=lambda: str(uuid.uuid4())),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/errors.py,121, +Modelos / ErrorEvent,timestamp,datetime,field(default_factory=lambda: datetime.now(timezone.utc).astimezone()),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/errors.py,122, +Modelos / ErrorEvent,error_id,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/errors.py,123, +Modelos / DeviceSnapshot,id,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,51, +Modelos / DeviceSnapshot,mac,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,52, +Modelos / DeviceSnapshot,ip,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,53, +Modelos / DeviceSnapshot,label,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,54, +Modelos / HistoryEvent,type,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,59, +Modelos / HistoryEvent,source,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,60, +Modelos / HistoryEvent,actor,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,61, +Modelos / HistoryEvent,result,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,62, +Modelos / HistoryEvent,summary,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,63, +Modelos / HistoryEvent,timestamp,str,field(default_factory=lambda: datetime.now().astimezone().isoformat()),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,64, +Modelos / HistoryEvent,schemaVersion,int,1,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,65, +Modelos / HistoryEvent,eventId,str,field(default_factory=lambda: str(uuid.uuid4())),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,66, +Modelos / HistoryEvent,correlationId,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,67, +Modelos / HistoryEvent,runId,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,68, +Modelos / HistoryEvent,taskId,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,69, +Modelos / HistoryEvent,operationId,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,70, +Modelos / HistoryEvent,device,DeviceSnapshot | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,71, +Modelos / HistoryEvent,changes,"tuple[dict, ...]",(),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,72, +Modelos / HistoryEvent,details,dict,field(default_factory=dict),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,73, +Modelos / HistoryEvent,error,dict | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,74, +Modelos / HistoryEvent,durationMs,int | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/history.py,75, +Modelos / LogCleanupResult,enabled,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/log_cleanup.py,13, +Modelos / LogCleanupResult,retention_days,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/log_cleanup.py,14, +Modelos / LogCleanupResult,deleted,"tuple[Path, ...]",(),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/log_cleanup.py,15, +Modelos / StorageCheck,path,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/persistence.py,21, +Modelos / StorageCheck,exists,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/persistence.py,22, +Modelos / StorageCheck,valid,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/persistence.py,23, +Modelos / StorageCheck,kind,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/persistence.py,24, +Modelos / StorageCheck,detail,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/persistence.py,25, +Modelos / EventMetadata,event_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,11, +Modelos / EventMetadata,event_version,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,12, +Modelos / EventMetadata,source,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,13, +Modelos / EventMetadata,timestamp,datetime,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,14, +Modelos / EventMetadata,correlation_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,15, +Modelos / EventContract,metadata,EventMetadata,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,20, +Modelos / FunctionResult,success,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,28, +Modelos / FunctionResult,code,str,'OK',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,29, +Modelos / FunctionResult,message,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,30, +Modelos / FunctionResult,data,Any,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,31, +Modelos / LifecycleEvent,version,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,39, +Modelos / LifecycleEvent,mode,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,40, +Modelos / ProjectFileEvent,path,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,45, +Modelos / ProjectFileEvent,project_id,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,46, +Modelos / NetworkScanEvent,scan_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,51, +Modelos / NetworkScanEvent,target_range,str | None,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,52, +Modelos / NetworkScanEvent,running,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,53, +Modelos / NetworkScanEvent,active,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,54, +Modelos / NetworkScanEvent,devices,int,0,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,55, +Modelos / DeviceRemoteEvent,selector,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,60, +Modelos / DeviceRemoteEvent,protocol,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,61, +Modelos / DeviceRemoteEvent,connected,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,62, +Modelos / VaultOperationEvent,operation,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,69, +Modelos / VaultOperationEvent,count,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,70, +Modelos / NetworkLabEvent,scenario_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,75, +Modelos / NetworkLabEvent,seed,int | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,76, +Modelos / NetworkLabEvent,path,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,77, +Modelos / NetworkLabEvent,device_id,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,78, +Modelos / NetworkLabEvent,action,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,79, +Modelos / NetworkLabEvent,clock,float | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/contracts.py,80, +Modelos / HookDecision,allowed,bool,True,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/events.py,16, +Modelos / HookDecision,reason,str | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/events.py,17, +Modelos / EventDefinition,event_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/events.py,22, +Modelos / EventDefinition,version,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/events.py,23, +Modelos / EventDefinition,contract,type[EventContract],(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/events.py,24, +Modelos / EventDefinition,owner,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/events.py,25, +Modelos / EventDefinition,cancelable,bool,False,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/events.py,26, +Modelos / Extension,extension_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/extensions.py,32, +Modelos / Extension,extension_type,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/extensions.py,33, +Modelos / Extension,owner,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/extensions.py,34, +Modelos / Extension,specification,"dict[str, Any]",field(default_factory=dict),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/extensions.py,35, +Modelos / InstalledPlugin,manifest,PluginManifest,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,60, +Modelos / InstalledPlugin,path,Path,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,61, +Modelos / InstalledPlugin,state,PluginState,PluginState.DISABLED,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,62, +Modelos / InstalledPlugin,granted,set[str] | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,63, +Modelos / InstalledPlugin,trusted,bool,False,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,64, +Modelos / InstalledPlugin,error,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,65, +Modelos / InstalledPlugin,signature,str,'UNSIGNED',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,66, +Modelos / InstalledPlugin,checksum,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,67, +Modelos / InstalledPlugin,module,object | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,68, +Modelos / InstalledPlugin,isolated_runtime,object | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/manager.py,69, +Modelos / PluginDependency,plugin_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,46, +Modelos / PluginDependency,version,str,'*',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,47, +Modelos / PluginManifest,schema_version,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,52, +Modelos / PluginManifest,plugin_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,53, +Modelos / PluginManifest,name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,54, +Modelos / PluginManifest,version,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,55, +Modelos / PluginManifest,description,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,56, +Modelos / PluginManifest,author,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,57, +Modelos / PluginManifest,entry_point,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,58, +Modelos / PluginManifest,minimum_lanctl,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,59, +Modelos / PluginManifest,maximum_lanctl,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,60, +Modelos / PluginManifest,permissions,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,61, +Modelos / PluginManifest,capabilities,"tuple[str, ...]","('plugin',)",Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,62, +Modelos / PluginManifest,dependencies,"tuple[PluginDependency, ...]",(),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,63, +Modelos / PluginManifest,runtime,str,'isolated',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,64, +Modelos / PluginManifest,raw,"dict[str, Any]","field(default_factory=dict, compare=False)",Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/plugins/models.py,65, +Modelos / ProjectCatalogEntry,path,Path,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/catalog.py,18, +Modelos / ProjectCatalogEntry,name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/catalog.py,19, +Modelos / ProjectCatalogEntry,project_id,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/catalog.py,20, +Modelos / ProjectCatalogEntry,in_default_directory,bool,False,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/catalog.py,21, +Modelos / ProjectCatalogEntry,available,bool,True,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/catalog.py,22, +Modelos / ProjectCatalogEntry,discovered_at,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/catalog.py,23, +Modelos / ProjectCatalogEntry,last_seen,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/catalog.py,24, +Modelos / SaveModeDefinition,mode,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/save_policy.py,74, +Modelos / SaveModeDefinition,triggers,frozenset[str],(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/save_policy.py,75, +Modelos / SaveModeDefinition,owner,str,'LANCTL',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/save_policy.py,76, +Modelos / SaveModeDefinition,description,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/save_policy.py,77, +Modelos / SaveResult,saved,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/save_policy.py,82, +Modelos / SaveResult,mode,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/save_policy.py,83, +Modelos / SaveResult,trigger,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/save_policy.py,84, +Modelos / SaveResult,path,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/save_policy.py,85, +Modelos / SaveResult,reason,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/save_policy.py,86, +Modelos / ProjectWorkspace,project,Path,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/workspace.py,27, +Modelos / ProjectWorkspace,project_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/workspace.py,28, +Modelos / ProjectWorkspace,database,Path,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/workspace.py,29, +Modelos / ProjectWorkspace,groups,Path,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/workspace.py,30, +Modelos / ProjectWorkspace,metadata,Path,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/workspace.py,31, +Modelos / ProjectWorkspace,content_hash,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/projects/workspace.py,32, +Modelos / OperationResult,runId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,22, +Modelos / OperationResult,taskId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,23, +Modelos / OperationResult,operationId,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,24, +Modelos / OperationResult,target,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,25, +Modelos / OperationResult,status,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,26, +Modelos / OperationResult,startedAt,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,27, +Modelos / OperationResult,finishedAt,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,28, +Modelos / OperationResult,durationMs,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,29, +Modelos / OperationResult,error,dict | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,30, +Modelos / OperationResult,detail,dict | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tasking.py,31, +Modelos / Tr064Service,service_type,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tr064.py,23, +Modelos / Tr064Service,service_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tr064.py,24, +Modelos / Tr064Service,control_url,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tr064.py,25, +Modelos / Tr064Service,scpd_url,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/core/tr064.py,26, +Modelos / ServiceResult,supported,bool,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/infrastructure/platform/base.py,8, +Modelos / ServiceResult,status,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/infrastructure/platform/base.py,9, +Modelos / ServiceResult,message,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/infrastructure/platform/base.py,10, +Modelos / ServiceResult,detail,dict | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/infrastructure/platform/base.py,11, +Modelos / IconEntry,icon_id,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,23, +Modelos / IconEntry,name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,24, +Modelos / IconEntry,filename,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,25, +Modelos / IconEntry,width,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,26, +Modelos / IconEntry,height,int,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,27, +Modelos / IconEntry,checksum,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,28, +Modelos / IconEntry,category,str,'general',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,29, +Modelos / IconEntry,tags,"tuple[str, ...]",(),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,30, +Modelos / IconEntry,owner,str,'LANCTL',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,31, +Modelos / IconEntry,created,str,'',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,32, +Modelos / IconEntry,path,Path | None,None,Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/assets/icons.py,33, +Modelos / LanguageCatalog,code,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/i18n.py,137, +Modelos / LanguageCatalog,name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/i18n.py,138, +Modelos / LanguageCatalog,native_name,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/i18n.py,139, +Modelos / LanguageCatalog,region,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/i18n.py,140, +Modelos / LanguageCatalog,version,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/i18n.py,141, +Modelos / LanguageCatalog,author,str,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/i18n.py,142, +Modelos / LanguageCatalog,path,Path | None,(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/i18n.py,143, +Modelos / LanguageCatalog,strings,"dict[str, str]",(requerido),Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/i18n.py,144, +Modelos / LanguageCatalog,owner,str,'LANCTL',Datos de dominio/estado; no implica ajuste editable,Core compartido,Según repositorio del modelo,según servicio; no asumir editable,,src/lanctl/shared/i18n.py,145, +Modelos / NetworkWire,idf,IDF,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/basics.py,22, +Modelos / NetworkWire,kind,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/basics.py,22, +Modelos / NetworkConnector,kind,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/basics.py,52, +Modelos / NetworkConnector,num,int,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/basics.py,52, +Modelos / NetworkConnector,name,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/basics.py,52, +Modelos / NetworkConnector,idf,IDF,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/basics.py,52, +Modelos / NetworkPanel,name,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/panel.py,14, +Modelos / NetworkPanel,idf,IDF,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/panel.py,14, +Modelos / NetworkPanel,port_count,int,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/panel.py,14, +Modelos / NetworkPanel,port_name_format,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/panel.py,14, +Modelos / RackElement,kind,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/rack.py,16, +Modelos / RackElement,obj,,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/rack.py,16, +Modelos / NetworkRack,name,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/rack.py,36, +Modelos / NetworkRack,size_u,int,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/rack.py,36, +Modelos / NetworkSwitch,name,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/switch.py,12, +Modelos / NetworkSwitch,idf,IDF,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/switch.py,13, +Modelos / NetworkSwitch,port_count,int,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/switch.py,14, +Modelos / NetworkSwitch,port_name_format,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/switch.py,15, +Modelos / NetworkSwitch,kind,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/switch.py,16, +Modelos / NetworkTerminal,name,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/terminal.py,10, +Modelos / NetworkTerminal,idf,IDF,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/terminal.py,10, +Modelos / NetworkTerminal,port_count,int,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/terminal.py,10, +Modelos / NetworkTerminal,port_name_format,str,,Datos fisicos del proyecto,LANWIRE/LANRACK,,Mediante editor de dominio,,src/lanctl/apps/wire/models/terminal.py,10, diff --git a/docs/CONFIGURATION-INVENTORY.csv b/docs/CONFIGURATION-INVENTORY.csv new file mode 100644 index 0000000..4ac73db --- /dev/null +++ b/docs/CONFIGURATION-INVENTORY.csv @@ -0,0 +1,290 @@ +categoria,variable,tipo,predeterminado,ambito,launcher,almacen,editable,alias_compatibilidad,fuente,linea,observaciones +Programa / schemaVersion,schemaVersion,int,2,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),automático/gestionado,,src/lanctl/core/config.py,54, +Programa / storage,storage.credentials,str,"""data/lc/.credentials""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",credentials,src/lanctl/core/config.py,54, +Programa / storage,storage.iconsDirectory,str,"""data/lc/icons""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",iconsDirectory,src/lanctl/core/config.py,54, +Programa / logging,logging.directory,str,"""data/lc/log""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",log,src/lanctl/core/config.py,54, +Programa / logging,logging.programDirectory,str,"""data/lc/log""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",programLog,src/lanctl/core/config.py,54, +Programa / logging,logging.cleanupEnabled,bool,false,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",logCleanupEnabled,src/lanctl/core/config.py,54, +Programa / logging,logging.retentionDays,int,90,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",logRetentionDays,src/lanctl/core/config.py,54, +Programa / logging,logging.errorLevel,int,20,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",errorLogLevel,src/lanctl/core/config.py,54, +Programa / projects,projects.active,NoneType,null,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),automático/gestionado,activeProject,src/lanctl/core/config.py,54, +Programa / projects,projects.saveMode,str,"""manual""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",projectSaveMode,src/lanctl/core/config.py,54, +Programa / projects,projects.saveIntervalMinutes,int,5,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",projectSaveIntervalMinutes,src/lanctl/core/config.py,54, +Programa / projects,projects.directory,NoneType,null,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",projectsDirectory,src/lanctl/core/config.py,54, +Programa / projects,projects.workspace.active,NoneType,null,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),automático/gestionado,projectWorkspace,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.directory,str,"""data/lc/projects/workspaces/default""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.databases.devices,str,"""data/lc/projects/workspaces/default/database/devices.json""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",database,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.databases.groups,str,"""data/lc/projects/workspaces/default/database/groups.json""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",groups,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.databases.monitor,str,"""data/lc/projects/workspaces/default/monitoring/monitor.db""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",monitorDatabase,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.databases.physical,str,"""data/lc/projects/workspaces/default/physical/idf.db""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",physicalDatabase,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.monitoring.runtime,str,"""data/lc/projects/workspaces/default/monitoring/sessions.json""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",monitorRuntime,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.monitoring.incidents,str,"""data/lc/projects/workspaces/default/monitoring/incidents.json""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",monitorIncidents,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.monitoring.lock,str,"""data/lc/projects/workspaces/default/monitoring/monitor.lock""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",monitorLock,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.monitoring.profiles,str,"""data/lc/projects/workspaces/default/monitoring/profiles.json""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",monitorProfiles,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.workspace.monitoring.assignments,str,"""data/lc/projects/workspaces/default/monitoring/assignments.json""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",monitorAssignments,src/lanctl/core/config.py,54,Ruta/contexto de proyecto; puede variar por sesión. No es una preferencia estética. +Programa / projects,projects.networkDatabase,NoneType,null,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",networkDatabase,src/lanctl/core/config.py,54, +Programa / projects,projects.networkGroups,NoneType,null,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",networkGroups,src/lanctl/core/config.py,54, +Programa / projects,projects.databaseLog,NoneType,null,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",databaseLog,src/lanctl/core/config.py,54, +Programa / plugins,plugins.directory,str,"""data/lc/plugins""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",plugins,src/lanctl/core/config.py,54, +Programa / plugins,plugins.registry,str,"""data/lc/plugins.registry""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",pluginRegistry,src/lanctl/core/config.py,54, +Programa / plugins,plugins.storage,str,"""data/lc/plugin-storage""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",smbStorage,src/lanctl/core/config.py,54, +Programa / plugins,plugins.safeMode,bool,false,Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",pluginSafeMode,src/lanctl/core/config.py,54, +Programa / localization,localization.language,str,"""en""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",language,src/lanctl/core/config.py,54, +Programa / localization,localization.languagesDirectory,str,"""data/lc/languages""",Programa; no necesariamente usuario individual,Core compartido,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",languagesDirectory,src/lanctl/core/config.py,54, +Programa / cli,cli.promptSaveOnCommandExit,bool,false,Programa; no necesariamente usuario individual,Consolas CLI compartidas,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",cliPromptSaveOnCommandExit,src/lanctl/core/config.py,54, +Programa / cli,cli.commandChaining,bool,true,Programa; no necesariamente usuario individual,Consolas CLI compartidas,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",cliCommandChaining,src/lanctl/core/config.py,54, +Programa / startup,startup.interface,str,"""cli""",Programa; no necesariamente usuario individual,LANCTL,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",startupInterface,src/lanctl/core/config.py,54, +Programa / startup,startup.closeGuiOnLaunch,bool,false,Programa; no necesariamente usuario individual,LANCTL,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",closeGuiOnLaunch,src/lanctl/core/config.py,54, +Programa / network,network.range,NoneType,null,Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",range,src/lanctl/core/config.py,54, +Programa / network,network.dhcpRange,NoneType,null,Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",dhcpRange,src/lanctl/core/config.py,54, +Programa / network,network.tr064Port,int,49000,Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",tr064Port,src/lanctl/core/config.py,54, +Programa / network,network.gateway,NoneType,null,Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",gateway,src/lanctl/core/config.py,54, +Programa / network,network.subnetMask,NoneType,null,Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",subnetMask,src/lanctl/core/config.py,54, +Programa / network,network.dhcpEnabled,NoneType,null,Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",dhcpEnabled,src/lanctl/core/config.py,54, +Programa / network,network.dnsServers,list,[],Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",dnsServers,src/lanctl/core/config.py,54, +Programa / network,network.domainName,str,"""""",Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",domainName,src/lanctl/core/config.py,54, +Programa / network,network.reservedAddresses,list,[],Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",reservedAddresses,src/lanctl/core/config.py,54, +Programa / network,network.tr064Host,NoneType,null,Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",tr064Host,src/lanctl/core/config.py,54, +Programa / network,network.dhcpLeaseTime,NoneType,null,Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",dhcpLeaseTime,src/lanctl/core/config.py,54, +Programa / network,network.settingsDownloadedAt,NoneType,null,Programa; no necesariamente usuario individual,LANIP; LANMON según operación,CONFIG_PATH: application_path(data/lc/.config),automático/gestionado,settingsDownloadedAt,src/lanctl/core/config.py,54, +Programa / ip,ip.workers,int,64,Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",workers,src/lanctl/core/config.py,54, +Programa / ip,ip.timeout,float,0.8,Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",timeout,src/lanctl/core/config.py,54, +Programa / ip,ip.maxHosts,int,4096,Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",maxHosts,src/lanctl/core/config.py,54, +Programa / ip,ip.discovery,str,"""hybrid""",Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",discovery,src/lanctl/core/config.py,54, +Programa / ip,ip.scanProfile,str,"""normal""",Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",scanProfile,src/lanctl/core/config.py,54, +Programa / ip,ip.scanOrder,str,"""ascending""",Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",scanOrder,src/lanctl/core/config.py,54, +Programa / ip,ip.progress,bool,true,Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",progress,src/lanctl/core/config.py,54, +Programa / ip,ip.serviceIdentification,bool,true,Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",serviceIdentification,src/lanctl/core/config.py,54, +Programa / ip,ip.disconnectedRetention,str,"""permanent""",Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",disconnectedRetention,src/lanctl/core/config.py,54, +Programa / ip,ip.disconnectedRetentionTarget,str,"""unconfirmed""",Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",disconnectedRetentionTarget,src/lanctl/core/config.py,54, +Programa / ip,ip.disconnectedRetentionScope,str,"""all""",Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",disconnectedRetentionScope,src/lanctl/core/config.py,54, +Programa / ip,ip.listColumns,list,"[""ip"", ""cnf"", ""alias"", ""mac"", ""name"", ""group"", ""description""]",Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",listColumns,src/lanctl/core/config.py,54, +Programa / ip,ip.ciscoProfiles,str,"""data/lc/cisco_profiles.json""",Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",ciscoProfiles,src/lanctl/core/config.py,54, +Programa / ip,ip.radminViewer,NoneType,null,Programa; no necesariamente usuario individual,LANIP,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",radminViewer,src/lanctl/core/config.py,54, +Programa / tui,tui.schemaVersion,int,2,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),automático/gestionado,,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.panelLayout,str,"""cli.bottom""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",tuiPanelLayout,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.cliHeightPercent,int,28,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",tuiCliHeightPercent,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.IP,str,"""15ch""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.responseMs,str,"""4%""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.cnf,str,"""2%""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.ALIAS,str,"""10%""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.MAC,str,"""17ch""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.NAME,str,"""12%""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.GROUP,str,"""12%""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.description,str,"""33%""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.manufacturer,str,"""17%""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.columnWidths.users,str,"""10%""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.help,str,"""F1""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.info,str,"""F2""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.ping,str,"""F3""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.refresh,str,"""F5""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.plugins,str,"""F7""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.projects,str,"""F9""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.settings,str,"""F12""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.history,str,"""CTRL_H""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.search,str,"""CTRL_F""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.reload,str,"""CTRL_R""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.edit,str,"""CTRL_E""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.groups,str,"""CTRL_G""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.ports,str,"""CTRL_P""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.open,str,"""CTRL_O""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.save,str,"""CTRL_S""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.differences,str,"""CTRL_D""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.copyLine,str,"""CTRL_X""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.copyJson,str,"""CTRL_J""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.console,str,"""CTRL_L""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.quit,str,"""CTRL_Q""",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.deviceHistory,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.scanSelected,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.filterActive,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.filterDisconnected,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.filterAll,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.ssh,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.terminal,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.credentials,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.wakeOnLan,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.copyIp,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.copyMac,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.keyBindings.projectStatus,NoneType,null,Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / tui,tui.footerButtons,list,"[""help"", ""info"", ""ping"", ""refresh"", ""plugins"", ""projects"", ""settings"", ""select""]",Programa; no necesariamente usuario individual,LANIP TUI,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",tuiFooterButtons,src/lanctl/core/config.py,54,El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. +Programa / wol,wol.port,int,9,Programa; no necesariamente usuario individual,LANIP; plugin WOL,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / wol,wol.repeat,int,3,Programa; no necesariamente usuario individual,LANIP; plugin WOL,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / wol,wol.interval,float,0.5,Programa; no necesariamente usuario individual,LANIP; plugin WOL,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / wol,wol.wait,int,60,Programa; no necesariamente usuario individual,LANIP; plugin WOL,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / wol,wol.method,str,"""auto""",Programa; no necesariamente usuario individual,LANIP; plugin WOL,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / wol,wol.sequences,str,"""data/lc/wol-sequences.json""",Programa; no necesariamente usuario individual,LANIP; plugin WOL,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",wolSequences,src/lanctl/core/config.py,54, +Programa / access,access.config,str,"""data/lc/access/config.json""",Programa; no necesariamente usuario individual,LANACCESS,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",accessConfig,src/lanctl/core/config.py,54, +Programa / access,access.users,str,"""data/lc/access/users.dc""",Programa; no necesariamente usuario individual,LANACCESS,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",accessUsers,src/lanctl/core/config.py,54, +Programa / access,access.remote.enabled,bool,false,Programa; no necesariamente usuario individual,LANACCESS,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",remoteAccessEnabled,src/lanctl/core/config.py,54, +Programa / access,access.remote.bind,str,"""""",Programa; no necesariamente usuario individual,LANACCESS,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",remoteAccessBind,src/lanctl/core/config.py,54, +Programa / access,access.remote.cidr,str,"""""",Programa; no necesariamente usuario individual,LANACCESS,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",remoteAccessCidr,src/lanctl/core/config.py,54, +Programa / access,access.remote.port,int,2222,Programa; no necesariamente usuario individual,LANACCESS,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",remoteAccessPort,src/lanctl/core/config.py,54, +Programa / access,access.remote.passwordAuthentication,bool,false,Programa; no necesariamente usuario individual,LANACCESS,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",remoteAccessPasswordAuthentication,src/lanctl/core/config.py,54, +Programa / access,access.remote.backend,str,"""service""",Programa; no necesariamente usuario individual,LANACCESS,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",remoteAccessBackend,src/lanctl/core/config.py,54, +Programa / access,access.remote.forcedView,str,"""off""",Programa; no necesariamente usuario individual,LANACCESS,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",remoteAccessForcedView,src/lanctl/core/config.py,54, +Programa / monitor,monitor.enabled,bool,false,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.profile,str,"""normal""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.mode,str,"""permanent""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.authority,str,"""observe""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.interface,str,"""""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.cidr,str,"""""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.duration,NoneType,null,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.execution.workers,int,32,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.execution.timeout,float,0.8,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.execution.scanOrder,str,"""ascending""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.execution.failureThreshold,int,3,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.execution.recoveryThreshold,int,2,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.intervals.criticalDevices,int,15,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.intervals.deviceStatus,int,60,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.intervals.networkDiscovery,int,300,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.intervals.serviceScan,int,1800,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.intervals.fullScan,int,86400,Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.retention.rawSamples,str,"""24h""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.retention.fiveMinuteAggregates,str,"""30d""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.retention.hourlyAggregates,str,"""365d""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Programa / monitor,monitor.retention.events,str,"""permanent""",Programa; no necesariamente usuario individual,LANMON,CONFIG_PATH: application_path(data/lc/.config),"sí, con validación",,src/lanctl/core/config.py,54, +Preferencias de interfaz,panelLayout,str,"""cli.bottom""",Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,cliHeight,int,12,Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,tableDensity,str,"""comfortable""",Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,confirmExit,bool,true,Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,showDescriptions,bool,true,Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,showGroups,bool,true,Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,columnWidths.idf,int,10,Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,columnWidths.type,int,14,Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,columnWidths.name,int,18,Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,columnWidths.group,int,12,Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Preferencias de interfaz,columnWidths.description,int,0,Interfaz,LANWIRE TUI,data/lw/tui.config,mediante servicio o extensión,,src/lanctl/apps/wire/tui/settings.py,16, +Servicio de acceso,schemaVersion,int,1,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,ssh.enabled,bool,false,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,ssh.bind,NoneType,null,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,ssh.cidr,NoneType,null,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,ssh.port,int,2222,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,ssh.passwordAuthentication,bool,false,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,ssh.hostKey,NoneType,null,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,https.enabled,bool,false,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,https.bind,NoneType,null,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,https.cidr,NoneType,null,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,https.port,int,8443,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,https.certificate,NoneType,null,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,https.privateKey,NoneType,null,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,firewall.managed,bool,false,Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Servicio de acceso,control.forcedView,str,"""off""",Servicio/plugin,LANACCESS,access.config resuelto desde configuración general,mediante servicio o extensión,,src/lanctl/apps/access/service.py,15, +Tokens de tema,color.background,str,"""#071522""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,color.surface,str,"""#0d2031""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,color.surface-raised,str,"""#122a3e""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,color.border,str,"""#244157""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,color.text,str,"""#edf6ff""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,color.text-muted,str,"""#91a8ba""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,color.accent,str,"""#25a9e8""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,color.success,str,"""#55c879""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,color.warning,str,"""#f5a623""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,color.danger,str,"""#ef5350""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,radius.panel,str,"""10px""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,radius.control,str,"""7px""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Tokens de tema,space.unit,str,"""8px""",Servicio/plugin,GUI compartida,Extensión theme del plugin; fallback del Core,mediante servicio o extensión,,src/lanctl/core/plugins/theme.py,25, +Proyecto VLF / identity,author,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,project.info,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / identity,description,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,project.info,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / identity,name,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,project.info,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / lan,company,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/lanIdentifier.info,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / lan,description,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/lanIdentifier.info,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / lan,location,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/lanIdentifier.info,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / lan,name,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/lanIdentifier.info,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / lan,responsible,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/lanIdentifier.info,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / network,cidr,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/network.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / network,dhcpRange,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/network.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / network,discovery,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/network.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / network,dns,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/network.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / network,gateway,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/network.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / network,saveIntervalMinutes,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/network.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / network,saveMode,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/network.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / network,scanOrder,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/network.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / network,scanProfile,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/network.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / vlan,managementVlan,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/vlan.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / vlan,nativeVlan,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/vlan.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / vlan,vlans,según esquema,,Proyecto,Compartido; red: LANIP/LANMON; VLAN: topología,lan/vlan.config,sí,,src/lanctl/core/projects/settings.py,22, +Proyecto VLF / estructura y datos,format,,,Proyecto,Core compartido,project.info,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,formatVersion,,,Proyecto,Core compartido,project.info,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,created,,,Proyecto,Core compartido,project.info,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,updated,,,Proyecto,Core compartido,project.info,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,lanctlVersion,,,Proyecto,Core compartido,project.info,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,id,,,Proyecto,Core compartido,project.info,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,contentHash,,,Proyecto,Core compartido,project.info,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,devices,,,Proyecto,Core compartido,project.info,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,groups,,,Proyecto,Core compartido,project.info,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,schemaVersion,,,Proyecto,Core compartido,lan/network.config,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,network,,,Proyecto,Core compartido,lan/network.config,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,netmask,,,Proyecto,Core compartido,lan/network.config,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,prefixLength,,,Proyecto,Core compartido,lan/network.config,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,schemaVersion,,,Proyecto,Core compartido,lan/vlan.config,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,schemaVersion,,,Proyecto,Core compartido,lan/settings.override.json,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,network,,,Proyecto,Core compartido,lan/settings.override.json,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,schemaVersion,,,Proyecto,Core compartido,lan/topology.map,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,nodes,,,Proyecto,Core compartido,lan/topology.map,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,links,,,Proyecto,Core compartido,lan/topology.map,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,physical.racks,,,Proyecto,Core compartido,lan/topology.map,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,physical.wires,,,Proyecto,Core compartido,lan/topology.map,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,physical.ports,,,Proyecto,Core compartido,lan/topology.map,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,logical.segments,,,Proyecto,Core compartido,lan/topology.map,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Proyecto VLF / estructura y datos,logical.vlans,,,Proyecto,Core compartido,lan/topology.map,derivado o mediante editor de dominio,,src/lanctl/core/projects/vlf.py,,No tratar como preferencia global. Colecciones con campos ampliables. +Preferencias locales GUI,lanctl.columns,dict,{},Perfil/origen del WebView; posiciones por almacenamiento,LANIP GUI,localStorage,"sí, salvo schemaVersion",,gui/lanip.js,, +Preferencias locales GUI,lanctl.width.,str,"""ancho px""",Perfil/origen del WebView; posiciones por almacenamiento,LANIP GUI,localStorage,"sí, salvo schemaVersion",,gui/lanip.js,, +Preferencias locales GUI,lanwire.gui.preferences.schemaVersion,int,1,Perfil/origen del WebView; posiciones por almacenamiento,LANWIRE GUI,localStorage,"sí, salvo schemaVersion",,gui/wire-gui.js,, +Preferencias locales GUI,lanwire.gui.preferences.depth,int,1,Perfil/origen del WebView; posiciones por almacenamiento,LANWIRE GUI,localStorage,"sí, salvo schemaVersion",,gui/wire-gui.js,, +Preferencias locales GUI,lanwire.gui.preferences.labels,bool,true,Perfil/origen del WebView; posiciones por almacenamiento,LANWIRE GUI,localStorage,"sí, salvo schemaVersion",,gui/wire-gui.js,, +Preferencias locales GUI,lanwire.gui.preferences.minimap,bool,false,Perfil/origen del WebView; posiciones por almacenamiento,LANWIRE GUI,localStorage,"sí, salvo schemaVersion",,gui/wire-gui.js,, +Preferencias locales GUI,lanwire.gui.preferences.view,str,"""map""",Perfil/origen del WebView; posiciones por almacenamiento,LANWIRE GUI,localStorage,"sí, salvo schemaVersion",,gui/wire-gui.js,, +Preferencias locales GUI,lanwire.gui.preferences.columns,list,"[""id"", ""type"", ""connections"", ""rack"", ""mode""]",Perfil/origen del WebView; posiciones por almacenamiento,LANWIRE GUI,localStorage,"sí, salvo schemaVersion",,gui/wire-gui.js,, +Preferencias locales GUI,lanwire.layout..schemaVersion,int,1,Perfil/origen del WebView; posiciones por almacenamiento,LANWIRE GUI,localStorage,"sí, salvo schemaVersion",,gui/wire-gui.js,, +Preferencias locales GUI,lanwire.layout..positions,dict,{},Perfil/origen del WebView; posiciones por almacenamiento,LANWIRE GUI,localStorage,"sí, salvo schemaVersion",,gui/wire-gui.js,, +Entorno,LOCALAPPDATA,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/access/manager_cli.py,281, +Entorno,PROGRAMDATA,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/access/root_control.py,23, +Entorno,LANCTL_DATA_SCOPE,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/ip/interfaces/cli/commands/access.py,65, +Entorno,NO_COLOR,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/ip/interfaces/cli/commands/group.py,182, +Entorno,LANCTL_DATA_DIR,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/ip/interfaces/cli/commands/lanwire.py,77, +Entorno,LANCTL_ENABLE_LEGACY_GUI,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/ip/interfaces/cli/main.py,58, +Entorno,HOME,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/ip/interfaces/tui/keyboard.py,149, +Entorno,XDG_STATE_HOME,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/monitor/database.py,38, +Entorno,LANWRE_ERROR,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/wire/error.py,31, +Entorno,LANWRE_DATA_DIR,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/apps/wire/path.py,24, +Entorno,LANCTL_CANONICAL_HELP,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/core/config.py,623, +Entorno,LANCTL_SECRET_DIR,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/core/paths.py,102, +Entorno,XDG_DATA_HOME,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/core/paths.py,94, +Entorno,XDG_CONFIG_HOME,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/core/paths.py,121, +Entorno,LANCTL_SERVICE_MODE,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/core/paths.py,68, +Entorno,NO_PROGRESS,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/core/progress.py,13, +Entorno,USERPROFILE,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/core/projects/paths.py,59, +Entorno,LANCTL_SESSION_CONTEXT,str,,Proceso/SO,Según consumidor,Entorno del proceso,externo o interno según consumidor,,src/lanctl/core/session_context.py,6, +Plugin / emulador,schemaVersion,int,1,Plugin,lanctl.lab.network-emulator,plugins-src/lanctl.lab.network-emulator/config/default.config,según API del plugin,,plugins-src/lanctl.lab.network-emulator/config/default.config,, +Plugin / emulador,enabled,bool,false,Plugin,lanctl.lab.network-emulator,plugins-src/lanctl.lab.network-emulator/config/default.config,según API del plugin,,plugins-src/lanctl.lab.network-emulator/config/default.config,, +Plugin / emulador,defaultProfile,str,"""home""",Plugin,lanctl.lab.network-emulator,plugins-src/lanctl.lab.network-emulator/config/default.config,según API del plugin,,plugins-src/lanctl.lab.network-emulator/config/default.config,, +Plugin / emulador,defaultDeviceCount,int,20,Plugin,lanctl.lab.network-emulator,plugins-src/lanctl.lab.network-emulator/config/default.config,según API del plugin,,plugins-src/lanctl.lab.network-emulator/config/default.config,, +Plugin / emulador,defaultSeed,NoneType,null,Plugin,lanctl.lab.network-emulator,plugins-src/lanctl.lab.network-emulator/config/default.config,según API del plugin,,plugins-src/lanctl.lab.network-emulator/config/default.config,, +Plugin / emulador,defaultCidr,str,"""192.0.2.0/24""",Plugin,lanctl.lab.network-emulator,plugins-src/lanctl.lab.network-emulator/config/default.config,según API del plugin,,plugins-src/lanctl.lab.network-emulator/config/default.config,, +Plugin / emulador,allowMixedSources,bool,false,Plugin,lanctl.lab.network-emulator,plugins-src/lanctl.lab.network-emulator/config/default.config,según API del plugin,,plugins-src/lanctl.lab.network-emulator/config/default.config,, +Plugin / emulador,clockSpeed,float,1.0,Plugin,lanctl.lab.network-emulator,plugins-src/lanctl.lab.network-emulator/config/default.config,según API del plugin,,plugins-src/lanctl.lab.network-emulator/config/default.config,, +Plugin / emulador,safety.disableRealActions,bool,true,Plugin,lanctl.lab.network-emulator,plugins-src/lanctl.lab.network-emulator/config/default.config,según API del plugin,,plugins-src/lanctl.lab.network-emulator/config/default.config,, +Plugin / WOL,port,int,9,Plugin/compartido con WOL,lanctl.network.wol,Ajustes WOL compartidos,sí,,src/lanctl/core/plugins/settings.py,, +Plugin / WOL,repeat,int,3,Plugin/compartido con WOL,lanctl.network.wol,Ajustes WOL compartidos,sí,,src/lanctl/core/plugins/settings.py,, +Plugin / WOL,wait,int,60,Plugin/compartido con WOL,lanctl.network.wol,Ajustes WOL compartidos,sí,,src/lanctl/core/plugins/settings.py,, +Credenciales,deviceId,str,,Secreto por dispositivo/protocolo,LANACCESS; consumidores autorizados,CredentialStore cifrado,mediante servicio de credenciales,,src/lanctl/core/credentials.py,,"Se documenta nombre, nunca valor local." +Credenciales,protocol,str,,Secreto por dispositivo/protocolo,LANACCESS; consumidores autorizados,CredentialStore cifrado,mediante servicio de credenciales,,src/lanctl/core/credentials.py,,"Se documenta nombre, nunca valor local." +Credenciales,username,str,,Secreto por dispositivo/protocolo,LANACCESS; consumidores autorizados,CredentialStore cifrado,mediante servicio de credenciales,,src/lanctl/core/credentials.py,,"Se documenta nombre, nunca valor local." +Credenciales,password,str,,Secreto por dispositivo/protocolo,LANACCESS; consumidores autorizados,CredentialStore cifrado,mediante servicio de credenciales,,src/lanctl/core/credentials.py,,"Se documenta nombre, nunca valor local." +Esquema extensible de preferencias de plugins,schemaVersion,según campo,,Manifiesto de cada plugin,Plugin que lo declara,plugin.info: settingsSchema; valores: .settings/.json,declaración del autor; valores por usuario,,src/lanctl/core/plugins/settings.py,,La lista de nombres cambia con los plugins instalados. No existe lista universal cerrada. +Esquema extensible de preferencias de plugins,fields[].name,según campo,,Manifiesto de cada plugin,Plugin que lo declara,plugin.info: settingsSchema; valores: .settings/.json,declaración del autor; valores por usuario,,src/lanctl/core/plugins/settings.py,,La lista de nombres cambia con los plugins instalados. No existe lista universal cerrada. +Esquema extensible de preferencias de plugins,fields[].label,según campo,,Manifiesto de cada plugin,Plugin que lo declara,plugin.info: settingsSchema; valores: .settings/.json,declaración del autor; valores por usuario,,src/lanctl/core/plugins/settings.py,,La lista de nombres cambia con los plugins instalados. No existe lista universal cerrada. +Esquema extensible de preferencias de plugins,fields[].type,según campo,,Manifiesto de cada plugin,Plugin que lo declara,plugin.info: settingsSchema; valores: .settings/.json,declaración del autor; valores por usuario,,src/lanctl/core/plugins/settings.py,,La lista de nombres cambia con los plugins instalados. No existe lista universal cerrada. +Esquema extensible de preferencias de plugins,fields[].default,según campo,,Manifiesto de cada plugin,Plugin que lo declara,plugin.info: settingsSchema; valores: .settings/.json,declaración del autor; valores por usuario,,src/lanctl/core/plugins/settings.py,,La lista de nombres cambia con los plugins instalados. No existe lista universal cerrada. +Esquema extensible de preferencias de plugins,fields[].minimum,según campo,,Manifiesto de cada plugin,Plugin que lo declara,plugin.info: settingsSchema; valores: .settings/.json,declaración del autor; valores por usuario,,src/lanctl/core/plugins/settings.py,,La lista de nombres cambia con los plugins instalados. No existe lista universal cerrada. +Esquema extensible de preferencias de plugins,fields[].maximum,según campo,,Manifiesto de cada plugin,Plugin que lo declara,plugin.info: settingsSchema; valores: .settings/.json,declaración del autor; valores por usuario,,src/lanctl/core/plugins/settings.py,,La lista de nombres cambia con los plugins instalados. No existe lista universal cerrada. +Esquema extensible de preferencias de plugins,fields[].choices,según campo,,Manifiesto de cada plugin,Plugin que lo declara,plugin.info: settingsSchema; valores: .settings/.json,declaración del autor; valores por usuario,,src/lanctl/core/plugins/settings.py,,La lista de nombres cambia con los plugins instalados. No existe lista universal cerrada. +Instalación Windows,core,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, +Instalación Windows,path,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, +Instalación Windows,monitor,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, +Instalación Windows,ipgui,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, +Instalación Windows,desktopicon,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, +Instalación Windows,eventviewer,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, +Instalación Windows,accessadmin,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, +Instalación Windows,postinstall LANACCESS,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, +Instalación Windows,/MODE,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, +Instalación Windows,directorio de instalación,opción de instalador,,Instalación/equipo,Suite,Setup/Inno; accesos y PATH,al instalar,,packaging/inno/LANCTL.iss,, diff --git a/docs/CONFIGURATION-USER-REVIEW.txt b/docs/CONFIGURATION-USER-REVIEW.txt new file mode 100644 index 0000000..bec86b3 --- /dev/null +++ b/docs/CONFIGURATION-USER-REVIEW.txt @@ -0,0 +1,199 @@ +// LANCTL - preferencias editables del usuario por interfaz (17/10/2026). +// DOCUMENTO DE REVISION: agrupaciones y editar_desde son politica propuesta, no claves del programa. +// No importar este texto como configuracion. Valores: predeterminados o contexto indicado. +// REGLA: toda interfaz ofrece los ajustes COMUNES y solo sus preferencias especificas. +// GUI excluye preferencias CLI/TUI; TUI excluye GUI/CLI; CLI excluye GUI/TUI. +// CLI/TUI se usa unicamente cuando ambos consumen el mismo ajuste, como ip.listColumns. +// Un terminal CLI integrado conserva su modo CLI; no convierte sus preferencias en ajustes GUI. +// El launcher y la interfaz son dimensiones diferentes: LANIP GUI y LANIP TUI comparten dominio, no apariencia. +// El nombre de un valor (ej. cli.bottom o startup.interface=gui) no determina por si solo su ambito. +// editar_desde indica exposicion deseada en configuracion; no certifica que exista ya ese control en cada interfaz. +// Solo editar mediante servicios con validacion. Los campos administrativos requieren autorizacion y flujo propio. +// P1/P2 son prioridad de exposicion; nunca conceden permisos ni habilitan edicion arbitraria. +// Excluidos: estado automatico, rutas internas, bases, locks, esquemas, IDs, sesiones, inventario y secretos. +// Los metadatos editables del proyecto permanecen en su editor de proyecto, separados de preferencias del programa. +// Los tokens de temas pertenecen al autor del plugin; no hay aqui un editor libre de contratos theme. +// Plugins: publicar solo preferencias declaradas y validadas, filtradas por interfaz; no exponer su manifiesto. +// CFG = RAIZ_DATOS/config/config.json. localStorage = perfil/origen del WebView. +// Hallazgos en el codigo actual, pendientes de corregir en una implementacion posterior: +// - suite/gui.py settings_catalog entrega _entries(scope) completo y save_catalog_setting delega en _set sin filtro de interfaz. +// - _launcher_categories filtra categorias por launcher, pero no distingue GUI/TUI/CLI dentro de una categoria. +// - GUI desktop.SETTINGS incluye cliCommandChaining; TUI show_settings incluye closeGuiOnLaunch y otras preferencias CLI. +// - settings_catalog.read_only bloquea pocos campos automaticos y admite rutas tecnicas; no basta como lista de ajustes del usuario. +// Aplicar la misma lista permitida en lectura y escritura del backend; ocultar controles por si solo no impide modificarlos. +// Este cambio revisa el documento: no implementa esos filtros en el programa. +{ + "TUI / LANWIRE": { + "panelLayout": "cli.bottom", // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANWIRE TUI | archivo=data/lw/tui.config | origen=src/lanctl/apps/wire/tui/settings.py:16 | prioridad=P1 + "cliHeight": 12, // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANWIRE TUI | archivo=data/lw/tui.config | origen=src/lanctl/apps/wire/tui/settings.py:16 | prioridad=P1 + "tableDensity": "comfortable", // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANWIRE TUI | archivo=data/lw/tui.config | origen=src/lanctl/apps/wire/tui/settings.py:16 | prioridad=P1 + "confirmExit": true, // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANWIRE TUI | archivo=data/lw/tui.config | origen=src/lanctl/apps/wire/tui/settings.py:16 | prioridad=P1 + "showDescriptions": true, // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANWIRE TUI | archivo=data/lw/tui.config | origen=src/lanctl/apps/wire/tui/settings.py:16 | prioridad=P1 + "showGroups": true, // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANWIRE TUI | archivo=data/lw/tui.config | origen=src/lanctl/apps/wire/tui/settings.py:16 | prioridad=P1 + "columnWidths": {"idf": 10, "type": 14, "name": 18, "group": 12, "description": 0} // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANWIRE TUI | archivo=data/lw/tui.config | origen=src/lanctl/apps/wire/tui/settings.py:16 | prioridad=P1 | descripcion=Anchura de las columnas de LANWIRE TUI + }, + + "GUI / LANIP": { + "lanctl.columns": {}, // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANIP GUI | archivo=localStorage | origen=gui/lanip.js | prioridad=P1 + "lanctl.width.": "ancho px" // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANIP GUI | archivo=localStorage | origen=gui/lanip.js | prioridad=P1 + }, + + "GUI / LANWIRE": { + "lanwire.gui.preferences.depth": 1, // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANWIRE GUI | archivo=localStorage | origen=gui/wire-gui.js | prioridad=P1 + "lanwire.gui.preferences.labels": true, // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANWIRE GUI | archivo=localStorage | origen=gui/wire-gui.js | prioridad=P1 + "lanwire.gui.preferences.minimap": false, // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANWIRE GUI | archivo=localStorage | origen=gui/wire-gui.js | prioridad=P1 + "lanwire.gui.preferences.view": "map", // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANWIRE GUI | archivo=localStorage | origen=gui/wire-gui.js | prioridad=P1 + "lanwire.gui.preferences.columns": ["id", "type", "connections", "rack", "mode"], // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANWIRE GUI | archivo=localStorage | origen=gui/wire-gui.js | prioridad=P1 + "lanwire.gui.preferences.showWifi": false, // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANWIRE GUI | archivo=localStorage | origen=gui/wire-gui.js | prioridad=P1 | descripcion=Mostrar enlaces Wi-Fi en el lienzo + "lanwire.gui.preferences.connectionMode": "wired", // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANWIRE GUI | archivo=localStorage | origen=gui/wire-gui.js | prioridad=P1 | descripcion=Conexión predeterminada para elementos nuevos: wired, wifi o mixed + "lanwire.gui.preferences.showPorts": true // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANWIRE GUI | archivo=localStorage | origen=gui/wire-gui.js | prioridad=P1 | descripcion=Mostrar puertos en el lienzo + }, + + "COMUN / Programa / access": { + "access.remote.enabled": false, // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "access.remote.bind": "", // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "access.remote.cidr": "", // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "access.remote.port": 2222, // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "access.remote.passwordAuthentication": false, // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "access.remote.backend": "service", // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 | opciones=["service", "user"] + "access.remote.forcedView": "off" // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 | opciones=["off", "gui", "tui", "plugins", "projects", "settings"] + }, + + "CLI / consola": { + "cli.promptSaveOnCommandExit": false, // editar_desde=CLI | acceso=usuario; validacion del servicio | launcher=Consolas CLI compartidas | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 + "cli.commandChaining": true, // editar_desde=CLI | acceso=usuario; validacion del servicio | launcher=Consolas CLI compartidas | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 + "ip.progress": true // editar_desde=CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Progreso textual de comandos; no controla el progreso propio de la GUI o TUI + }, + + "COMUN / Programa / ip": { + "ip.workers": 64, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "ip.timeout": 0.8, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "ip.maxHosts": 4096, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "ip.discovery": "hybrid", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | opciones=["icmp", "arp", "hybrid"] + "ip.scanProfile": "normal", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | opciones=["fast", "normal", "accurate"] + "ip.scanOrder": "ascending", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | opciones=["ascending", "descending", "random"] + "ip.serviceIdentification": true, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 + "ip.disconnectedRetention": "permanent", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | opciones=["permanent", "session", "forget"] + "ip.disconnectedRetentionTarget": "unconfirmed", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | opciones=["unconfirmed", "all"] + "ip.disconnectedRetentionScope": "all", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | opciones=["all", "dhcp"] + "ip.radminViewer": null // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | null=sin valor configurado + }, + + "CLI y TUI / columnas LANIP": { + "ip.listColumns": ["ip", "cnf", "alias", "mac", "name", "group", "description"] // editar_desde=CLI/TUI | acceso=usuario; validacion del servicio | launcher=LANIP | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Columnas de list y del inventario TUI; la GUI usa preferencias locales separadas + }, + + "COMUN / Programa / localization": { + "localization.language": "en" // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Idioma de la interfaz + }, + + "COMUN / Programa / logging": { + "logging.cleanupEnabled": false, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Limpieza automática de registros + "logging.retentionDays": 90, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Días de conservación de registros + "logging.errorLevel": 20 // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 | descripcion=Umbral de registro de errores; ajuste avanzado + }, + + "COMUN / Programa / monitor": { + "monitor.enabled": false, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 + "monitor.profile": "normal", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 + "monitor.mode": "permanent", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | opciones=["permanent", "temporary", "diagnostic", "once"] + "monitor.authority": "observe", // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | opciones=["observe", "operate", "administer"] + "monitor.interface": "", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 + "monitor.cidr": "", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 + "monitor.duration": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | null=sin valor configurado + "monitor.execution.workers": 32, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.execution.timeout": 0.8, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.execution.scanOrder": "ascending", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 | opciones=["ascending", "descending", "random"] + "monitor.execution.failureThreshold": 3, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.execution.recoveryThreshold": 2, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.intervals.criticalDevices": 15, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.intervals.deviceStatus": 60, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.intervals.networkDiscovery": 300, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.intervals.serviceScan": 1800, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.intervals.fullScan": 86400, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.retention.rawSamples": "24h", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.retention.fiveMinuteAggregates": "30d", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.retention.hourlyAggregates": "365d", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "monitor.retention.events": "permanent" // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANMON | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + }, + + "COMUN / Programa / network": { + "network.range": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP; LANMON según operación | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Rango de red utilizado por LANIP | null=sin valor configurado + "network.dhcpRange": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP; LANMON según operación | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Rango DHCP de referencia; no reconfigura por sí solo el router | null=sin valor configurado + "network.tr064Port": 49000, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP; LANMON según operación | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 | descripcion=Puerto del servicio TR-064 + "network.tr064Host": null // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP; LANMON según operación | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 | descripcion=Host del servicio TR-064 | null=sin valor configurado + }, + + "COMUN / Programa / plugins": { + "plugins.safeMode": false // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 | descripcion=Modo seguro de plugins para diagnóstico + }, + + "COMUN / Programa / projects": { + "projects.saveMode": "manual", // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | opciones=["manual", "manual.inCloseConsult", "automatic.toClose", "automatic.toScan", "automatic.timeToSave", "automatic.allChanges"] + "projects.saveIntervalMinutes": 5, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 + "projects.directory": null // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Carpeta de proyectos elegida por el usuario; null conserva la resolución predeterminada | null=sin valor configurado + }, + + "COMUN / Programa / startup": { + "startup.interface": "cli" // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Interfaz de inicio | opciones=["cli", "tui", "gui"] | descripcion=Preferencia global de inicio, aunque el valor elegido sea cli, tui o gui + }, + + "GUI / LANCTL": { + "startup.closeGuiOnLaunch": false // editar_desde=GUI | acceso=usuario; validacion del servicio | launcher=LANCTL | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Cerrar la GUI al lanzar una aplicación + }, + + "TUI / LANIP": { + "tui.panelLayout": "cli.bottom", // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANIP TUI | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. + "tui.cliHeightPercent": 28, // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANIP TUI | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. + "tui.footerButtons": ["help", "info", "ping", "refresh", "plugins", "projects", "settings", "select"], // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANIP TUI | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=El bloque TUI general corresponde a LANIP; LANWIRE tiene preferencias independientes. + "tui.keyBindings": {"help": "F1", "info": "F2", "ping": "F3", "refresh": "F5", "plugins": "F7", "projects": "F9", "settings": "F12", "history": "CTRL_H", "search": "CTRL_F", "reload": "CTRL_R", "edit": "CTRL_E", "groups": "CTRL_G", "ports": "CTRL_P", "open": "CTRL_O", "save": "CTRL_S", "differences": "CTRL_D", "copyLine": "CTRL_X", "copyJson": "CTRL_J", "console": "CTRL_L", "quit": "CTRL_Q", "deviceHistory": null, "scanSelected": null, "filterActive": null, "filterDisconnected": null, "filterAll": null, "ssh": null, "terminal": null, "credentials": null, "wakeOnLan": null, "copyIp": null, "copyMac": null, "projectStatus": null}, // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANIP TUI | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Atajos personalizables; null deja la acción sin tecla asignada + "tui.columnWidths": {"IP": "15ch", "responseMs": "4%", "cnf": "2%", "ALIAS": "10%", "MAC": "17ch", "NAME": "12%", "GROUP": "12%", "description": "33%", "manufacturer": "17%", "users": "10%"} // editar_desde=TUI | acceso=usuario; validacion del servicio | launcher=LANIP TUI | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P1 | descripcion=Anchura de las columnas de LANIP TUI + }, + + "COMUN / Programa / wol": { + "wol.port": 9, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP; plugin WOL | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "wol.repeat": 3, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP; plugin WOL | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "wol.interval": 0.5, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP; plugin WOL | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "wol.wait": 60, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP; plugin WOL | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 + "wol.method": "auto" // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANIP; plugin WOL | archivo=CFG | origen=src/lanctl/core/config.py:54 | prioridad=P2 | opciones=["auto", "arp", "ping", "port"] + }, + + "COMUN / Proyecto VLF / identity": { + "author": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=project.info | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "description": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=project.info | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "name": null // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=project.info | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + }, + + "COMUN / Proyecto VLF / lan": { + "company": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/lanIdentifier.info | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "description": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/lanIdentifier.info | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "location": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/lanIdentifier.info | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "name": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/lanIdentifier.info | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "responsible": null // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/lanIdentifier.info | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + }, + + "COMUN / Proyecto VLF / network": { + "cidr": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/network.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "dhcpRange": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/network.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "discovery": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/network.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "dns": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/network.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "gateway": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/network.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "saveIntervalMinutes": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/network.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "saveMode": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/network.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "scanOrder": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/network.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "scanProfile": null // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/network.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + }, + + "COMUN / Proyecto VLF / vlan": { + "managementVlan": null, // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/vlan.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + "nativeVlan": null // editar_desde=GUI/TUI/CLI | acceso=usuario; validacion del servicio | launcher=LANCTL general / proyecto compartido | archivo=lan/vlan.config | origen=src/lanctl/core/projects/settings.py:22 | prioridad=P1 | null=valor propio del proyecto, no predeterminado universal + }, + + "COMUN / Servicio de acceso": { + "https.enabled": false, // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=access.config resuelto desde configuración general | origen=src/lanctl/apps/access/service.py:15 | prioridad=P2 + "https.bind": null, // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=access.config resuelto desde configuración general | origen=src/lanctl/apps/access/service.py:15 | prioridad=P2 | null=sin valor configurado + "https.cidr": null, // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=access.config resuelto desde configuración general | origen=src/lanctl/apps/access/service.py:15 | prioridad=P2 | null=sin valor configurado + "https.port": 8443 // editar_desde=GUI/TUI/CLI | acceso=administracion autorizada; servicio especifico | launcher=LANACCESS | archivo=access.config resuelto desde configuración general | origen=src/lanctl/apps/access/service.py:15 | prioridad=P2 + } + +} diff --git a/docs/COORDINATION.md b/docs/COORDINATION.md index d772b64..c6edc78 100644 --- a/docs/COORDINATION.md +++ b/docs/COORDINATION.md @@ -25,6 +25,14 @@ sigue disponible para consumidores anteriores, pero las interfaces coordinadas se registran individualmente. Si hay varias ventanas, las órdenes requieren un ID de sesión; nunca se escoge arbitrariamente la última ventana abierta. +Las GUI de LANCTL y LANIP añaden exclusión por launcher, usuario y raíz de datos +mediante un bloqueo del SO mantenido durante la vida del proceso. Una segunda +apertura espera a que la interfaz esté disponible y le envía `view gui`; restaura +la ventana y solicita el primer plano. Al morir el proceso se libera el bloqueo. +Un timeout informa del fallo sin crear una ventana duplicada. Launchers distintos +conservan bloqueos independientes. Las órdenes explícitas de backend mantienen +su requisito de destinatario; la apertura GUI resuelve su única instancia. + ## Uso ```text diff --git a/docs/GUI-AUDITOR-COORDINATION.md b/docs/GUI-AUDITOR-COORDINATION.md new file mode 100644 index 0000000..44a42d8 --- /dev/null +++ b/docs/GUI-AUDITOR-COORDINATION.md @@ -0,0 +1,133 @@ +# Integración de pendientes GUI y AUDITOR — 17/10/2026 + +El usuario solicita completar los pendientes de interfaz y encarga a AUDITOR +los cambios internos. El trabajo continúa en la rama existente experimental-gui, +sin publicar, instalar ni modificar la versión durante la integración. + +## Propiedad de los cambios + +- GUI-DESIGN: `gui/*`, adaptadores `apps/suite/gui.py`, `launcher_gui.py` y + `apps/ip/interfaces/gui/desktop.py`; pruebas de integración de interfaces. +- AUDITOR: servicios y modelos compartidos, CLI/TUI, permisos, instaladores, + comprobación de versiones, diagnóstico, transporte de actividad y dimensiones. +- Contratos de AUDITOR: `.tool-reports/gui-auditor-sync.json` (informe local, + excluido de Git). Indicar firmas, payloads, archivos, comprobaciones y bloqueos. +- Los cambios de ambos se integran antes de ejecutar la suite completa y una + única compilación final. Cada responsable ejecuta regresiones focalizadas. + +## Dependencias + +1. P54: enlaces oficiales compartidos; botones GUI con apertura de navegador + mediante servicio, sin shell. +2. P34/P35: estado de permisos coherente, preferencias visuales validadas, + cinco temas con previsualización y aplicación persistente. +3. P49/P53: visor de registros y transporte de actividad antes de sustituir + el visor local de LANCTL. Conservar origen, proyecto, sesión y timestamps. +4. P52: preparación y redacción en LANMON, edición y revisión visual antes + de abrir GitHub; nunca publicar automáticamente. +5. P51: consulta de actualizaciones en segundo plano y manual, estado visible, + recordar después y enlace explícito sin descargar ni ejecutar instaladores. +6. Dimensiones de racks: validación compartida 4–52 U y ancho 10/19/21/23 + pulgadas; LANRACK edita y LANWIRE muestra el mismo registro. +7. P45–P48 y P32: integración del instalador y comprobaciones de distribución. + +El backlog contiene dos entradas P66. En esta coordinación se identifican por +su título: «Frentes de equipos» (completada) y «Dimensiones de armarios rack» +(pendiente). No se reescriben identificadores públicos ni resultados anteriores. + +## Requisitos que deben conservarse + +Los puertos de los frentes de LANRACK son exclusivamente decorativos. Las +operaciones siguen en las ventanas de datos. Ninguna modificación visual +concede permisos de plugins, inventa firmas o sustituye la validación del Core. +Los cambios no deben perder conexiones, pertenencia a rack/CPD o datos del +proyecto. Las verificaciones externas no disponibles se documentan como tales. + +## Integración de interfaz comprobada + +Se incorporan los adaptadores `apps/suite/gui_support.py` y las extensiones +`app-preferences`, `app-support`, `monitor-support`, `rack-dimensions` y +`first-scan`. Usan los contratos internos entregados por AUDITOR, sin duplicar +la validación de preferencias, dimensiones o diagnósticos. + +Las trece regresiones de `tests/test_gui_support.py` comprueban persistencia y +sincronización, origen de errores, redacción y revisión de reportes, consulta +asíncrona de versiones, enlaces con navegador explícito, edición compartida de +racks y confirmación previa al primer escaneo. Incluyen el reintento tras error, +el envío real de interfaz/CIDR al parser y el estado de reinicio/limpieza de +plugins, que impide ofrecer acciones no disponibles. Las regresiones de GUI, +topología/CPD y skins pasan con navegador Edge real. Los cuatro launchers +especializados abren y cierran correctamente mediante el host nativo. + +La comprobación integral y el empaquetado final se registran después de que +AUDITOR estabilice los servicios. P34 (aislamiento/revocación completa), P50 +(puente externo con contexto y autenticación), los transportes distintos de +ICMP/ARP de P47 y las certificaciones externas no se consideran terminados por +estas pruebas visuales. + +## Corte final de fuentes + +AUDITOR valida el corte integrado con Coverage 7.16.2: 1.212 pruebas y 645 +subpruebas aprobadas en 185,61 s; cobertura de líneas/ramas 69,4720 %, sobre +el umbral del 60 %. La omisión corresponde al IPC POSIX en Windows. Las 21 +pruebas GUI heredadas, excluidas por el selector habitual, pasan por separado: +1.233 pruebas aprobadas en total. Las trece regresiones de controles GUI +incluyen la conservación de la solicitud del primer escaneo tras error. + +Antes de compilar se congelan 386 entradas de construcción, con hashes en +`.tool-reports/gui-package-freeze.json`. Las evidencias de distribución se +añaden tras comprobar recursos, versiones y cierre nativo de los binarios. +P69–P73 son anotaciones nuevas incorporadas desde HELP durante el ciclo y se +conservan pendientes; no se presentan como implementadas en este corte. + +## Artefactos locales verificados + +Compilados los seis ejecutables `0.3.4-alpha.1` sin cambios en las 386 entradas +congeladas. Cada archivo contiene los 29 recursos actuales de GUI/catálogo y +los 16 módulos compartidos comprobados, incluidos origen de red y estado de +plugins. Las seis ventanas pasan arranque nativo, icono, registro IPC y cierre +mediante `WM_CLOSE`; LANIP espera además a completar su inventario inicial. +Las pruebas usan almacenes y carpeta de proyectos temporales. + +Inno Setup termina correctamente y genera +`dist/gui-current/LANCTL-0.3.4-alpha.1-gui-setup.exe` (135.487.663 bytes). +SHA-256: +`5401cb5a085c4cf8fa2b86dbb9270e72f6a45ff0cfdfbdbf1c4ce113626bde3a`. +Es un instalador experimental local; no se ha instalado ni publicado. +Compilar y ejecutar los binarios no certifica instalación/actualización en una +máquina limpia ni los entornos externos que AUDITOR sigue comprobando. + +## Reapertura P45: imágenes de los temas + +El reporte visual identifica que el Setup anterior solo mostraba `TPanel` +con fondo/acento y una leyenda de poco contraste: no contenía imágenes. +Se reemplaza por `TBitmapImage`, cinco BMP versionados con capturas de Inicio +y las paletas reales del Core, extracción temporal y cambio de archivo al +seleccionar tema. Se amplía la página y se distribuyen opciones e imagen en +dos columnas, manteniendo la proporción 8:5. El generador usa datos sintéticos. + +Pasan 16 pruebas de distribución/recursos y Ruff; Inno compila correctamente. +El instalador actualizado ocupa 135.659.290 bytes y su SHA-256 es +`dcb5bd5a50fdb7167af7550cfc76eec4982194e726d044627270919f18d96ce5`. +Los seis ejecutables de aplicación conservan la compilación verificada previa. +El usuario abrió el Setup actualizado, aceptó manualmente UAC y confirmó que +las cinco vistas previas cambian y se ven completas: «Sí, las cinco se ven +bien». La herramienta no pudo capturar la ventana elevada, por lo que se +registra esa revisión humana, sin atribuirla a una captura automatizada. +P45 queda comprobada. La siguiente compilación incluirá además la corrección +posterior de registro Clink repetido (P48) entregada por AUDITOR. + +## Corte P45/P48/P71.4 y límite de la comprobación visual + +La suite final de AUDITOR pasa 1.269 pruebas, 645 subpruebas y una omisión, +con cobertura 69,9154 %. Se reconstruyen los seis ejecutables y se comprueban +398 entradas de construcción sin cambios, 32 recursos y 17 módulos compartidos +por binario, además de `lanaccess remote-setup --help`. + +El usuario interrumpe con Escape el control de ventanas de la última prueba +nativa. GUI-DESIGN detiene esa operación y retira únicamente sus procesos de +prueba. **El smoke nativo final queda incompleto**, incluido el asistente; no +se atribuye éxito a ventanas que solo llegaron a arrancar. No se crean cuentas +reales ni se automatiza UAC. La prueba de creación de cuenta con API real y +almacén temporal sí pasó en Edge, por separado. La certificación remota de los +paquetes continúa en runners GitHub sin reanudar el control local de interfaz. diff --git a/docs/GUI-PROTOTYPES.md b/docs/GUI-PROTOTYPES.md new file mode 100644 index 0000000..453a8d4 --- /dev/null +++ b/docs/GUI-PROTOTYPES.md @@ -0,0 +1,22 @@ +# Prototipos de los launchers pendientes + +Abrir `gui/launcher-prototypes.html` en el navegador. No requiere servidor ni +dependencias externas. Las cuatro vistas se seleccionan en la barra superior; +también admiten los fragmentos `#wire`, `#rack`, `#access` y `#mon`. + +- LANWIRE: topología, lista de enlaces, extremos y medio de conexión. +- LANRACK: selector de racks, vista frontal numerada y selección de ocupantes. +- LANACCESS: perfiles agrupados, destinos, protocolos y detalle sin secretos. +- LANMON: indicadores, lista de equipos, gráfico ilustrativo y eventos. + +Mantienen los colores y los iconos SVG del centro LANCTL, con cabecera, +controles y barra inferior fuera del área desplazable. La búsqueda y el filtro +actúan sobre los datos de ejemplo. Se pueden seleccionar elementos, abrir sus +detalles con doble clic y modificar datos temporalmente. Al recargar se restaura +la demostración. «Nuevo» crea un registro visual a partir de un ejemplo. + +Son propuestas de interfaz, no nuevas implementaciones de los servicios. +Configuración muestra el formulario propuesto; LANCTL y CLI explican su destino +previsto. No ejecutan procesos, sondeos ni conexiones, ni leen/escriben VLF o +credenciales. LANRACK propone edición futura, aunque su servicio actual es de +solo lectura. Los accesos de producción de LANCTL mantienen su comportamiento. diff --git a/docs/INSTALL.md b/docs/INSTALL.md index 045001b..500106d 100644 --- a/docs/INSTALL.md +++ b/docs/INSTALL.md @@ -30,6 +30,13 @@ Inno instala en Program Files y puede añadir LANCTL al PATH. Sin un certificado de firma configurado en GitHub Secrets, Windows mostrará editor desconocido o SmartScreen; la verificación SHA-256 sigue siendo obligatoria. +El Setup interactivo ofrece crear la primera cuenta administrativa de acceso +remoto del servicio mediante `lanaccess remote-setup`. El asistente pide usuario, +contraseña y confirmación en su propia ventana, conserva cuentas existentes y +permite omitir el paso. No activa SSH/HTTPS ni abre puertos; consulta +[la configuración de acceso](ACCESS.md#cuenta-inicial-desde-el-instalador-de-windows). +La instalación silenciosa omite este asistente. + ## Linux y Raspberry Pi OS 64-bit Uso rápido: diff --git a/docs/KNOWN-ISSUES.md b/docs/KNOWN-ISSUES.md index 7fcbb88..f498709 100644 --- a/docs/KNOWN-ISSUES.md +++ b/docs/KNOWN-ISSUES.md @@ -1,4 +1,4 @@ -# Limitaciones conocidas de la beta +# Limitaciones conocidas - Los binarios de una arquitectura no funcionan en otra. Raspberry Pi OS debe ser de 64 bits para usar el artefacto `arm64`. @@ -13,10 +13,21 @@ local y explícita. - Los instaladores conservan los datos al desinstalar. Su eliminación requiere una acción administrativa independiente. -- La beta no debe ser la única copia de proyectos o inventarios importantes. +- La versión experimental no debe ser la única copia de proyectos o inventarios importantes. - Los plugins Python aislados aplican límites y auditoría, pero no constituyen una frontera de seguridad contra código deliberadamente hostil. Instala solo paquetes firmados y de confianza. +- Revocar un plugin `trusted` heredado retira su acceso al Core, pero no puede + detener de forma segura los hilos nativos que ya ejecuta dentro del proceso. + Si aparece `restartRequired`, es necesario reiniciar ese proceso para retirar + su código. El aislamiento cancelable completo sigue en `REF-P34-runtime`. +- Todavía no existe un editor oficial de plugins configurado. Los complementos + que requieren firma y confianza no se habilitan automáticamente por estar + incluidos en la distribución; P40/P42 requieren identidad y paquetes firmados. +- La selección explícita de interfaz vincula ICMP y ARP al origen elegido. + En ese modo se omiten los descubridores adicionales y la resolución de nombres + que todavía no garantizan ese origen. La certificación con varias NIC en + Windows/Linux y el resto de protocolos siguen en `REF-P47-interface`. - `root forced-view` no puede mostrar una ventana en el escritorio interactivo cuando el backend se ejecuta como servicio Windows (Session 0). diff --git a/docs/LANCTL-GUI.md b/docs/LANCTL-GUI.md new file mode 100644 index 0000000..557db05 --- /dev/null +++ b/docs/LANCTL-GUI.md @@ -0,0 +1,151 @@ +# Centro gráfico de LANCTL + +Inicia `lanctl --gui` (desde fuentes: `python -m lanctl --gui`). La consola +habitual `lanctl --cli` y el TUI siguen disponibles. Desde fuentes se necesita +el extra `gui`: `pip install -e ".[gui]"`. + +El centro utiliza la distribución compacta Grafito y lima: LANIP/LANWIRE, +LANRACK/LANACCESS y LANMON a todo el ancho. Los accesos abren exclusivamente +interfaces gráficas reales de LANIP, LANWIRE, LANRACK, LANACCESS y LANMON, +sin abrir una CLI/TUI como sustituto. Véase [GUI de launchers](LAUNCHER-GUI.md). + +## Proyectos + +«Nuevo proyecto» solicita una carpeta y un nombre. «Crear archivo VLF» escribe +un VLF real y vacío mediante el servicio existente, sin copiar dispositivos ni +credenciales del proyecto anterior. No sobrescribe archivos existentes. +La interfaz confirma el resultado y su ruta cuando la creación y activación han +terminado. Los cambios pendientes deben guardarse antes de cambiar de proyecto. +También permite abrir VLF existentes y guardar el proyecto activo. La creación +y «Editar» incluyen nombre, descripción, autor, LAN, ubicación, empresa y +responsable. Los cambios de metadatos se guardan conjuntamente, conservando UUID, +inventario y otros contenidos. Si otra ventana modificó esos datos, se pide +recargar antes de guardar. Cancelar o cerrar un formulario modificado pide +confirmación. La lista se actualiza al completar la operación. + +Las operaciones de proyectos y preferencias reutilizan temporalmente el +adaptador compatible `DesktopApi` de LANIP. `SuiteApi` expone exclusivamente los +métodos de administración necesarios, sin publicar los RPC de inventario. + +## Plugins + +Cada plugin instalado ofrece activación y desactivación. «Configurar» aparece +únicamente si ofrece campos configurables, aunque todavía use valores +predeterminados y no exista un archivo de ajustes. +Los campos se leen del manifiesto actual al consultar la configuración, también +si el paquete instalado fue actualizado por otro proceso. Un manifiesto inválido +se muestra como error de configuración sin abrir un formulario vacío. +La activación muestra los permisos solicitados y requiere seleccionarlos; +no se concede confianza a código trusted sin un editor autorizado. +El diálogo de configuración muestra las opciones declaradas por el plugin. +Los plugins sin opciones propias no muestran un botón que abra un panel vacío. +Wake-on-LAN ofrece puerto UDP, repeticiones y espera de arranque, conectados +a los valores compartidos que ya utiliza el CLI de WOL. + +Un paquete trusted sin firma válida muestra el requisito de obtener un LCP +firmado antes de intentar la activación. Para un paquete firmado cuyo editor +todavía no es confiable, el diálogo muestra su huella y permite seleccionar el +LCP original para autorizar al editor. Se verifica que ID, checksum y firma coincidan +con la versión instalada. Después se conceden permisos y ejecución trusted. +Cancelar o seleccionar otro paquete no concede confianza. El paquete WOL +incluido actualmente está sin firmar; este flujo no elimina ese requisito. + +Contrato opcional y aditivo en `plugin.info`: + +```json +{ + "settingsSchema": { + "schemaVersion": 1, + "fields": [ + {"name": "retries", "label": "Reintentos", "type": "integer", "minimum": 1, "maximum": 10, "default": 3}, + {"name": "enabled", "label": "Habilitar análisis", "type": "boolean", "default": true}, + {"name": "mode", "label": "Modo", "type": "select", "choices": ["fast", "normal"], "default": "normal"} + ] + } +} +``` + +Tipos admitidos: `text`, `integer`, `boolean`, `select`. Cada campo requiere un +valor predeterminado válido. No se admiten contraseñas ni secretos. Los valores +se guardan fuera del paquete, en `plugins/.settings/ID.json`, con `schemaVersion` +y escritura transaccional. Un archivo corrupto o de versión desconocida produce +un error; no se sustituye silenciosamente por valores vacíos. +Cada plugin puede consultar sus propios valores mediante `api.settings`. +Los procesos aislados reciben una instantánea al iniciarse; tras cambiar opciones +hay que desactivar y activar el plugin para que vuelva a leerlas. + +## Terminales + +«Terminal», junto a Configuración, ejecuta un CLI general real de LANCTL en un +proceso separado y muestra su salida dentro del programa. No interpreta HTML ni +ejecuta comandos de shell. La sesión continúa al cambiar de sección y se cierra +con el centro gráfico. Para SSH, contraseñas, TUI y otras sesiones que necesitan +una terminal nativa se utiliza el acceso inferior. + +«CLI», en la barra inferior, abre `lanctl --cli` en la terminal del sistema: +Windows utiliza el host de terminal predeterminado; Linux utiliza +`x-terminal-emulator` (o `xterm` como alternativa). Si no hay terminal instalada, +se informa del error. Esta consola independiente permanece abierta al cerrar +la GUI. Ninguno de los dos accesos inicia un escaneo por sí mismo. + +La barra inferior muestra versión, proyecto y número de plugins activos. +«Sistema» muestra SO, arquitectura e información de la interfaz local. +«Actividad» permite consultar los mensajes de las últimas operaciones de la sesión. + +En Proyectos y Plugins, solo se desplaza la lista: cabecera, acciones, +buscador y barra inferior permanecen visibles. La búsqueda por nombre es local, +no distingue mayúsculas y muestra el número de resultados. Cada plugin muestra +versión, estado y autor; su información técnica desplegable incluye ID, runtime, +compatibilidad LANCTL, capacidades, permisos solicitados/concedidos y firma. + +## Inicio y ventanas + +En Configuración general, `startupInterface` elige `cli`, `tui` o `gui` cuando +LANCTL arranca sin argumentos, tanto desde terminal como desde su ejecutable. +El valor predeterminado sigue siendo `cli`; un argumento explícito tiene prioridad. +`closeGuiOnLaunch` permite cerrar LANCTL después de confirmar que LANIP está +disponible. Si la apertura falla, LANCTL conserva su ventana y muestra el error. + +Solo hay una GUI por launcher, usuario y raíz de datos. Una nueva solicitud +restaura y enfoca la existente. LANCTL y LANIP sí pueden coexistir; cerrar una +no cierra la otra. La página inicial y Actividad reflejan apertura y cierre. +Los cambios compartidos se recargan cuando no hay un formulario abierto; no se +reemplaza una edición en curso. Cada sesión conserva su proyecto. + +## Iconos de aplicaciones + +`assets/launcher-icons/` contiene SVG, PNG e ICO de LANCTL, LANIP, LANWIRE, +LANRACK, LANACCESS, LANMON y terminal. Los ICO incluyen ocho tamaños de 16 a +256 píxeles y el spec de Windows asigna el correspondiente a cada ejecutable. +Las ventanas nativas LANCTL/LANIP aplican su icono al mostrarse. Los demás +launchers conservan sus iconos propios de ejecutable y de ventana. +CLI/TUI usan el icono común de terminal y un título con el launcher en consolas +clásicas Windows. Windows Terminal administra el icono de pestaña mediante su +perfil; no se modifica la configuración personal del anfitrión. Reinicia las +ventanas abiertas para cargar los recursos nuevos. Los cambios de código de las +ventanas requieren reconstruir el ejecutable; cambiar su recurso ICO no +actualiza el código interno del binario. + +## Ajustes completos y adaptación de ventana + +Configuración incluye el catálogo completo de programa y proyecto activo, +agrupado por categorías y con buscador. Cada ajuste muestra su tipo y los +campos automáticos aparecen como solo lectura. Las listas y objetos se editan +como JSON; booleanos y números tienen controles específicos. El acceso remoto +reutiliza el adaptador de CLI para aplicar también los cambios en el servicio, +no solamente en el archivo. Los cambios de proyecto conservan la validación, +las copias VLF y las preferencias del catálogo CLI. Los formularios modificados +conservan la confirmación de descarte. + +Inicio distribuye las cinco tarjetas en el área útil sin scroll al tamaño +mínimo de escritorio. La terminal utiliza toda el área central disponible; +solo su salida se desplaza. Cabecera, entrada y pie permanecen visibles. + +Crear proyecto abre directamente el formulario con la carpeta de proyectos +predeterminada y «LAN principal». Ambos valores se pueden editar y la carpeta +puede seleccionarse opcionalmente. No copia los metadatos del proyecto anterior. + +Los plugins sin firma ofrecen «Instalar versión firmada…». Se comprueban la +firma y el ID antes de instalar; autorizar al editor y conceder permisos siguen +siendo pasos explícitos posteriores. No se genera confianza ni se firman +paquetes automáticamente. Una versión firmada debe proceder del editor. diff --git a/docs/LANIP-GUI.md b/docs/LANIP-GUI.md index 2ea3fa0..a233ded 100644 --- a/docs/LANIP-GUI.md +++ b/docs/LANIP-GUI.md @@ -63,3 +63,59 @@ $env:LANCTL_GUI_BROWSER_TESTS = "1" La prueba nativa usa exclusivamente una carpeta temporal y no escanea la red. El test de navegador utiliza respuestas simuladas y prueba formularios, filtros, guardado, creación de proyectos y tamaños de ventana. + +## Diseño Grafito y lima + +La GUI utiliza la misma identidad del centro LANCTL. El inventario ocupa el +área principal completa. Una barra inferior reúne las acciones del equipo +seleccionado. El doble clic abre su ficha en pestañas: Resumen, Editar, Grupos, +Puertos y servicios y Registro completo. Se pueden editar nombre, alias, +descripción, icono, confirmación, IP e IDF mediante los servicios existentes. +Los grupos se añaden o retiran con sus propias acciones transaccionales. +La ficha muestra todos los campos guardados, ocultando secretos y referencias +de credenciales. Abrirla no inicia sondas: la inspección de puertos se solicita +expresamente. Los cambios pendientes se consultan al cerrar la ficha. + +El escaneo comienza al pulsar su botón, sin una confirmación adicional del +navegador. HTTP/HTTPS, FTP, SMB, RDP, RTSP y Radmin se abren directamente en +sus aplicaciones; SSH, Telnet y TR-064 conservan su terminal interactiva. + +Los controles separan escaneo, búsqueda, filtros y presentación. «Vista +esencial» muestra las columnas de uso habitual; «Completa» permite consultar +todos los campos con desplazamiento horizontal y «Columnas» personaliza la +selección. Se conservan la selección de columnas y las anchuras guardadas. +`Ctrl+K` enfoca la búsqueda; `Ctrl+S`, deshacer/rehacer, menú contextual, +plugins, historial y protección de cambios pendientes mantienen sus funciones. +El tema estándar se presenta en grafito y lima; los temas personalizados +conservan sus tokens y sus identificadores públicos de componentes. + +«Nuevo grupo» crea un grupo con nombre y descripción (máximo 42 caracteres), +incluso sin seleccionar un equipo. También aparecen en el selector los grupos +vacíos del proyecto. «Más filtros» permite combinar fabricante, protocolo, +confirmación y equipos con/sin grupo, además de estado, grupo y búsqueda. +«Limpiar filtros» restablece la lista sin alterar el inventario. + +Las pestañas superiores se sustituyen por el menú «Paneles» de la barra inferior, +que conserva el acceso a paneles de plugins e historial. El botón «CLI» inferior +abre `lanip --cli` en la terminal del sistema, independientemente de la consola +general de LANCTL. + +La configuración incluye red y DHCP, método/perfil/orden/concurrencia y límites +del escaneo, identificación de servicios, reglas de retención de desconectados, +carpeta/política/intervalo de proyectos, nivel/limpieza/conservación de logs y +encadenamiento de órdenes CLI. Las opciones con valores cerrados se presentan +como selectores y se validan con el parser de configuración existente. + +La descripción de los **elementos** admite texto multilínea sin el límite +anterior de 42 caracteres, tanto al importar como al editar mediante GUI/CLI. +Los grupos conservan su contrato propio de descripción. +En la ficha, la pertenencia a grupos se modifica con casillas; se puede crear +y añadir un grupo sin abrir otro diálogo. Las ediciones de identificación +pendientes se guardan antes de aplicar cambios de grupos. + +La barra inferior incluye «LANCTL» para abrir el centro GUI. Las acciones de +equipo se deshabilitan según selección, protocolos disponibles, plugins y +posibilidad de ejecutar acciones reales. El cierre nativo solicita la decisión +de guardado sin bloquear el hilo de Windows; un escaneo en curso se cancela +antes de cerrar. En Windows compatible se aplica el tema oscuro a la barra +nativa conservando minimizar, maximizar y cerrar. diff --git a/docs/LAUNCHER-GUI.md b/docs/LAUNCHER-GUI.md new file mode 100644 index 0000000..adce664 --- /dev/null +++ b/docs/LAUNCHER-GUI.md @@ -0,0 +1,245 @@ +# GUI de LANWIRE, LANRACK, LANACCESS y LANMON + +Desde LANCTL, pulsa la tarjeta de la aplicación. También se abren directamente: + +```text +lanwire --gui +lanrack --gui +lanaccess --gui +lanmon --gui +lanctl lanwire --gui +``` + +Se requiere el extra `gui` en desarrollo y WebView2 en Windows, igual que LANIP. +Se conserva el arranque CLI/TUI predeterminado de cada launcher. Cada aplicación +tiene icono, sesión coordinada y ventana propios; la instancia existente recibe +el foco en una segunda apertura. El lanzamiento transporta una instantánea +versionada de las rutas del proyecto, sin credenciales, para conservar el +contexto aunque otra ventana seleccione un proyecto distinto. No persiste esta +selección sobre la de otra sesión. + +## LANWIRE + +LANWIRE ofrece dos vistas independientes a pantalla completa: **Lista** y +**Topología**. Las barras superior e inferior permanecen visibles. La lista +permite ordenar, redimensionar y elegir columnas, buscar por nombre, alias, +identificador o IP y combinar filtros de tipo, prefijo, grupos del TUI, rack, +medio, conexión cableada/Wi-Fi y disponibilidad de puertos. + +El lienzo de Topología muestra cables reales, sus puertos y suministros externos. +Admite zoom centrado en el cursor, arrastre del fondo y de equipos, minimapa, +encuadre completo, reorganización automática, historial de navegación, menú +contextual y enfoque de un elemento con profundidad configurable. Las posiciones +manuales se conservan localmente por almacén. Los equipos marcados solo Wi-Fi +quedan excluidos por defecto; los mixtos conservan sus conexiones físicas. +Pulsar un puerto en el lienzo selecciona el equipo; conectar cables es una +acción explícita de las pestañas Puertos/Conexiones de su ventana de datos. +Seleccionar un cable permite consultar o editar sus extremos. La topología representa también enlaces +cruzados: no presupone que la red sea un árbol sin bucles. + +El doble clic en Lista o Topología abre un detalle con pestañas General, +Ubicación, Puertos, Conexiones, Datos técnicos y JSON copiable. Los campos de +nombre, alias, descripción, grupos, conexión, IP, velocidades, ubicación, medio, +PoE y altura de rack son editables según el tipo. Renombrar un puerto actualiza +sus referencias. «Centrar en Topología» conserva la selección y ofrece limpiar +filtros si impiden mostrarla. Una revisión de contenido impide sobrescribir +cambios de otra ventana; medio, ocupación, unidad y extremos se validan antes +de persistir. Los identificadores y fechas generadas son de consulta. + +Configuración agrupa General, Lista y búsqueda, Topología, Puertos y conexiones, +Almacenamiento, Proyecto y Avanzado, con controles tipados, buscador y aviso de +solo lectura. Las preferencias visuales se guardan localmente con versión de +formato; los ajustes compartidos pasan por el catálogo y validación del programa. +Restaurar preferencias visuales no altera rutas ni opciones del proyecto. + +«Cambiar proyecto» lista los VLF disponibles y permite abrir otro archivo. Los +cambios pendientes se guardan antes de cambiar; una apertura fallida conserva +el contexto anterior. **El inventario físico sigue siendo compartido**, mediante +`physicalDatabase` (o `--database` al arrancar); no está contenido en el VLF. El +selector cambia el contexto del proyecto y vuelve a enlazar el servicio físico +a la ruta configurada. No se simula una exportación VLF del inventario físico. +Las rutas modificadas en Configuración requieren volver a abrir la interfaz. + + +## LANRACK + +LANRACK gestiona CPD (salas con nombre, descripción y ubicación) que agrupan +armarios del mismo almacén físico. Permite crear y editar CPD, asignar o trasladar +racks y eliminar una sala conservando sus armarios sin asignación o trasladándolos +a otra. Los identificadores internos distinguen salas con el mismo nombre. + +Incluye vista de salas, lista filtrable/buscable por CPD o rack y detalle del +armario con unidades numeradas y equipos. Se navega de sala a rack y a los datos +del equipo; el detalle del armario conserva también los ocupantes sin unidad. +«Cambiar CPD» modifica la pertenencia física. La edición de equipos y cables +sigue en LANWIRE, accesible con «Abrir LANWIRE». + +La organización se persiste en el propio `physicalDatabase` mediante la extensión +`cpdOrganization` con `schemaVersion: 1`; cada rack referencia su sala mediante +`data.location.cpd`. Las bases anteriores se leen sin CPD y guardan la extensión +al realizar la primera operación, sin reescribir identificadores ni conexiones. +Un esquema desconocido o datos inválidos se rechazan sin sobrescribirlos. +Las operaciones son atómicas bajo el lock común y requieren la revisión actual +del inventario, para no sobrescribir cambios de otra ventana. + +### Frentes visuales de equipos (skins) + +La elevación del armario muestra frentes SVG genéricos sobre las unidades +ocupadas, con orejas de montaje o bandeja para equipos de sobremesa. Incluye +30 plantillas: automático, switches de 12/24/48 RJ45 y combinaciones con SFP +(24+2, 24+4, 48+2, 50+2, 48+4, 48+6 y 48+8), switches de sobremesa de +5/8/12/16/24 puertos, paneles de 12/24/48, servidores de 1/2/4 U, SAI de +2/3/4 U, router/cortafuegos, bandejas y paneles ciegos. Son representaciones +genéricas y no un catálogo de modelos comerciales. + +Pulsa un equipo y elige «Personalizar frente» para seleccionar una plantilla, +verla previamente o ajustar el tipo, número de RJ45/SFP, montaje y altura. +El modo automático deduce el frontal de los puertos y tipo del inventario. +Los puertos del frente son decorativos: no reciben clics, foco ni acciones de +conexión, ni muestran respuestas al pasar el ratón. La unidad completa conserva +el acceso a sus datos. +El número representado no añade ni renumera puertos; los conectores adicionales +se identifican como representación sin registro. Solo se resaltan conexiones +realmente registradas. El SAI no presenta porcentajes o estados de batería +inventados. Las unidades se numeran de abajo hacia arriba; una altura de 2 U +partiendo de U5 ocupa U5–U6, con validación de espacio y límite del armario. + +La apariencia se guarda en `data.rackAppearance` con `schemaVersion: 1` en la +base compartida, y conserva equipos, CPD, ubicación, puertos y cables. Las +revisiones impiden sobrescribir cambios de otra ventana. El traslado desde la +GUI de LANWIRE y la reducción de altura del rack respetan el espacio ocupado. +Los equipos anteriores conservan 1 U y un frente automático hasta configurarlos. +La vista simple permanece disponible y el tamaño visual de las unidades es +ajustable; estas preferencias locales llevan su propio esquema versionado. + +### Racks y CPD en Topología LANWIRE + +«Interior de racks» agrupa los equipos dentro de contenedores por rack. +«Vista general de racks» contrae cada armario y muestra los cables que salen a +otros racks, equipos externos y suministros. Un rack es un contenedor visual, +nunca un extremo físico nuevo. El doble clic entra en el rack; los controles +permiten volver a la vista general y conservar cámara y posiciones por contexto. +Las conexiones salientes permanecen visibles con sus equipos/racks de destino +como contexto, aunque pertenezcan a otra sala. + +Se puede filtrar por CPD, rack o elementos sin asignación, y agrupar/desplegar +los enlaces paralelos. Un grupo de cables permite abrir los registros reales +que lo componen. Los medios se identifican por texto, sin depender solo del color. +Las ventanas refrescan el almacén cada cinco segundos cuando no se edita ni +arrastra; «Actualizar» permite consultar antes los cambios de la otra interfaz. + +La distribución usa fuerzas deterministas por componentes y separación de +rectángulos, tanto para equipos como para contenedores conectados. Solo los +componentes sin conexiones se colocan en cuadrícula. No garantiza un óptimo +matemático global. Los puertos se ordenan por medio y número, con filas/columnas +adaptadas a su cantidad; su numeración e identidad no se modifican. Se muestran +libres/ocupados sin scroll interno y las posiciones manuales respetan el rack. +«Reorganizar» recalcula el dibujo sin alterar los datos físicos. + +Los cables se anclan a coordenadas de puertos reales recalculadas con cada zoom +o movimiento. Sus etiquetas llevan fondo y se separan de equipos y otras +etiquetas; una guía discontinua identifica el enlace si el texto se desplaza. +Con poco zoom se abrevia a identificador/cantidad; señalar la etiqueta muestra +el nombre, medio y extremos completos. El minimapa y «Ver todo» incluyen los +tamaños variables de las tarjetas y contenedores. + +## LANACCESS + +Lista metadatos de credenciales con equipos, protocolo y usuario. Permite crear +o actualizar la combinación equipo/protocolo, eliminar y abrir el cliente de +conexión disponible. El almacén y el enlace con el inventario utilizan el mismo +servicio transaccional que CLI/TUI; `AccessManager` conserva su ruta compatible +como adaptador de entrada de secretos de consola. + +Los secretos no se devuelven a JavaScript en listas o detalles, ni se colocan en +argumentos de procesos. La edición solicita una contraseña nueva y su +confirmación. DPAPI mantiene su protección de usuario de Windows. Un almacén +portable se desbloquea explícitamente; uno nuevo requiere al menos 12 caracteres +y confirmación. Bloquear o cerrar elimina la contraseña de desbloqueo de la +instancia. Se respetan `--database`, `--store`, `--cipher` y las opciones de scope. +Las conexiones interactivas usan una terminal del sistema para autenticarse. + +## LANMON + +Lee el inventario, las últimas observaciones, latencia y hasta 60 muestras +reales por equipo, incidencias y eventos del proyecto. La ventana no inicia +sondeos ni un servicio al abrirse. «Iniciar monitor», «Detener» y «Comprobar una +vez» requieren una decisión explícita y llaman a las mismas operaciones que +el CLI, con autoridad observe. Los resultados se escriben en la base del monitor. +No permite detener desde la GUI la sesión de otro proyecto ni iniciar una +segunda sesión si ya existe una activa. Las incidencias del inventario mostrado +se pueden reconocer y cerrar mediante su servicio. + +El proceso de monitorización continúa al cerrar la ventana. Sus reglas y +perfiles avanzados permanecen disponibles en configuración y CLI. Las acciones +remotas con mayor autoridad mantienen sus comprobaciones existentes. + +## Interacción compartida y comprobación + +Cabecera, filtros, barra de acciones y pie permanecen visibles; el contenido +central se desplaza. Cada GUI incluye configuración por categorías, CLI propio, +acceso a LANCTL, errores con su origen y confirmaciones con la temática de la +aplicación. La actualización de datos no reemplaza formularios abiertos. + +Pruebas reproducibles: + +```text +python -m pytest tests/test_launcher_gui.py -q +python tests/launcher_gui_native_smoke.py lanwire +python tests/launcher_gui_native_smoke.py lanrack +python tests/launcher_gui_native_smoke.py lanaccess +python tests/launcher_gui_native_smoke.py lanmon +python tests/launcher_suite_native_smoke.py +``` + +Los smokes nativos Windows utilizan directorios temporales y cierran solamente +sus propias ventanas y procesos. La revisión local no certifica otras plataformas. + +Las rutas de almacén están vinculadas a la instancia abierta: después de +cambiarlas en configuración, cierra y vuelve a abrir el launcher. Los cambios +de parámetros del monitor se aplican al reiniciar su sesión de ejecución. +# Controles compartidos de escritorio — 17/10/2026 + +Las seis ventanas nativas comparten un editor de apariencia con cinco paletas +(Grafito, Azul noche, Bosque, Violeta y Claro), densidad, tamaño de texto y +reducción de animaciones. La vista previa se cancela sin guardar; Aplicar usa +las preferencias validadas del Core y las demás ventanas las reciben en vivo. +Los temas de plugins amplían únicamente sus tokens declarados, sin reemplazar +la preferencia base. Al retirarlos se limpian sus estilos de componente. + +El pie incluye `Report a bug`. Los errores conservan código, origen e identidad +y se agrupan para evitar ventanas repetidas. LANMON permite elegir sesión y +evidencias, editar descripción/pasos/resultado esperado, anonimizar y revisar +el borrador antes de exportarlo o abrir el formulario oficial. Abrir GitHub no +publica una incidencia. Las credenciales se excluyen incluso si se desactiva +la anonimización de datos identificativos. + +LANCTL conserva su buffer local de actividad y envía los mensajes al transporte +compartido antes de abrir el visor de LANMON. Allí se filtra por proyecto, +sesión, nivel y texto. Los registros operativos tienen una vista independiente, +historial acotado y pausa. LANIP ofrece además Registros para abrir la TUI en +otra terminal. Cerrar el visor no detiene el monitor. + +La barra de LANCTL ya no muestra reloj. Web, GitHub y Referencia usan el servicio +de enlaces oficiales compartido con CLI/TUI. Configuración ofrece la búsqueda +manual de actualizaciones; la consulta automática corre en segundo plano y el +Core la limita a una diaria. El usuario puede recordar después o abrir la +Release; no se descargan ni ejecutan instaladores automáticamente. + +LANRACK crea armarios y edita altura (4–52 U) y ancho de montaje +(10/19/21/23 pulgadas). LANWIRE muestra esas dimensiones desde el mismo registro +y remite su edición a LANRACK. Los datos heredados incompletos se identifican +para revisión; una altura inválida no se convierte en una elevación inventada. +Los puertos de las skins siguen siendo exclusivamente decorativos. + +La solicitud de primer escaneo del instalador abre una confirmación editable +en LANIP con las interfaces IPv4 disponibles y su máscara real. Se confirma +adaptador, CIDR y perfil antes de sondear. El modo de origen seleccionado usa +ICMP/ARP y omite DNS y descubridores externos con un aviso; no atribuye ese +enlace a transportes todavía no adaptados. Sin interfaz válida no inicia ni +descarta la solicitud. Un escaneo fallido conserva la petición para reintentar. +El botón Red de escaneo permite cambiar la selección o recuperar las rutas +habituales del sistema. La selección se conserva solo en la ventana abierta. + +Estos adaptadores son exclusivos del escritorio local. El frontend remoto +conserva su superficie restringida y no obtiene métodos nativos adicionales. diff --git a/docs/LAUNCHER-INTERFACES.md b/docs/LAUNCHER-INTERFACES.md index 50a7864..b8d6044 100644 --- a/docs/LAUNCHER-INTERFACES.md +++ b/docs/LAUNCHER-INTERFACES.md @@ -4,7 +4,15 @@ Todos los launchers admiten `--cli` (también `-cli`) y `--tui` (también `-tui` Los comandos directos y `/?` siguen disponibles. No cambia el formato de los proyectos, credenciales ni contratos de plugins. -LANIP incorpora además `--gui`: véase [interfaz de escritorio](LANIP-GUI.md). +Todos los launchers incorporan `--gui`. LANIP: [interfaz de escritorio](LANIP-GUI.md). +LANWIRE, LANRACK, LANACCESS y LANMON: [interfaces gráficas](LAUNCHER-GUI.md). +LANCTL incorpora `--gui` para proyectos, plugins, preferencias y terminales: +véase [centro gráfico de LANCTL](LANCTL-GUI.md). + +Sin argumentos, LANCTL usa la preferencia global `startup.interface` (`cli` por +defecto). Se configura con `lanctl settings --startup-interface cli|tui|gui`. +Un comando o interfaz explícitos siempre tienen prioridad. La preferencia no +cambia el arranque predeterminado de los launchers especializados. Las instancias comparten [coordinación local](COORDINATION.md): sesiones, proyectos independientes, tareas, eventos y órdenes de refresco dirigidas. @@ -79,6 +87,7 @@ ni convertir pantallas interactivas en logs. Enter devuelve al panel. El tamaño se recalcula al dibujar; no hay repintado autónomo durante `input()`. Los TUI especializados de LANIP/LANWIRE conservan sus controles actuales. -LANRACK continúa siendo visor; LANBACK no se añade como aplicación ficticia. +LANRACK conserva sus consultas CLI/TUI y añade gestión de agrupaciones CPD +en la GUI sobre el inventario compartido. LANBACK no se añade como aplicación ficticia. Las configuraciones compartidas todavía usan el adaptador compatible de LANIP. ProjectDock es una herramienta de desarrollo, no una dependencia de ejecución. diff --git a/docs/LCP.md b/docs/LCP.md index 111b22c..8803fcd 100644 --- a/docs/LCP.md +++ b/docs/LCP.md @@ -220,6 +220,42 @@ el arranque si su huella no sigue autorizada; `--trust` no omite esa comprobaci Además, `plugin install` muestra firma y permisos solicitados antes de modificar la instalación. `lanctl plugin revoke ID [PERMISOS]` desactiva el plugin antes de retirar permisos y confianza de ejecución. + +La verificación de un ID instalado comprueba de nuevo los archivos, el checksum +y la firma Ed25519; no utiliza el texto de firma guardado en el registro como +prueba criptográfica. Activar, recargar y restaurar al arrancar aplica estas +comprobaciones antes de cargar código o extensiones, junto con permisos, +compatibilidad y dependencias. Los plugins alterados quedan en cuarentena y +deben reinstalarse desde un LCP verificado. + +Las dependencias se activan antes de sus consumidores. `depends[].version` +admite una versión exacta, `*`, prefijos como `1.x` o `1.2.*` y comparaciones +`>=`, `<=`, `>`, `<`, `==`, `!=` combinadas con comas, por ejemplo +`>=1.0.0,<2.0.0`. Un ciclo o una dependencia fallida impide cargar el consumidor. +Desactivar una dependencia descarga también sus consumidores activos locales. + +Los registros de plugins y editores validan su esquema y rechazan documentos +corruptos sin reemplazarlos por un estado vacío. Las modificaciones se protegen +con bloqueo entre procesos; los cambios de un plugin no sobrescriben los de +otro. Si otro proceso ha modificado el mismo plugin, el gestor rechaza operar +con su copia antigua y pide recargar. Esta protección no constituye una +notificación inmediata de revocaciones a runtimes ya cargados en otros procesos. + +## Estado de la distribución de plugins — 16/10/2026 + +Los paquetes incluidos de MAC Vendor, mDNS/SSDP, Windows SMB y Wake-on-LAN usan +runtime `trusted` y actualmente **no llevan firma**. Su checksum válido no +autoriza ejecutar código dentro del proceso. Marcar todos los permisos o usar +`--trust` no sustituye una firma válida ni la confianza explícita en el editor. +El tema predeterminado y el emulador de red usan runtime `isolated`. + +Para distribuir las variantes `trusted`, el editor debe construir los LCP con +su clave Ed25519, verificar los paquetes y comunicar la huella por un canal +independiente. Después se instala el paquete firmado, se autoriza su editor y +se conceden los permisos y la ejecución `trusted`. La auditoría utiliza claves +efímeras exclusivamente en pruebas: no crea una identidad oficial ni concede +confianza automáticamente. La publicación de esos paquetes sigue pendiente. + # Fachada Wake-on-LAN Los plugins trusted pueden solicitar `network.udp` y usar exclusivamente diff --git a/docs/RELEASE-0.3.4-alpha.1.md b/docs/RELEASE-0.3.4-alpha.1.md new file mode 100644 index 0000000..b3fd6bd --- /dev/null +++ b/docs/RELEASE-0.3.4-alpha.1.md @@ -0,0 +1,60 @@ +# LANCTL 0.3.4-alpha.1 — GUI EXPERIMENTAL (NO ESTABLE) + +Prototipo de la rama `experimental-gui`, publicado como **pre-release** para +probar las interfaces gráficas en otro ordenador. No es una versión estable y +no sustituye a la Release estable 0.3.3. No se necesita instalar Python. + +## Descargas de Windows x64 + +- **Setup**: `LANCTL-0.3.4-alpha.1-windows-x64-setup.exe`. +- **Portable**: `LANCTL-0.3.4-alpha.1-windows-x64-portable.zip`. +- Comprueba el SHA-256 de la descarga con `SHA256SUMS.txt`. + +Requisito de las interfaces gráficas: Microsoft Edge WebView2 Runtime. +El instalador no incorpora ese runtime; debe estar instalado en el ordenador +de prueba. Sin certificado Authenticode, Windows puede mostrar editor desconocido. + +## Cómo probar la GUI + +1. Instala el Setup o extrae todo el ZIP en una carpeta con permiso de escritura. +2. Abre el acceso «LANCTL GUI» del menú Inicio o ejecuta `LANCTL.exe --gui`. +3. Desde el centro gráfico abre LANIP, LANWIRE, LANRACK, LANACCESS y LANMON. + También puedes ejecutar cada launcher con `--gui`. +4. Crea un proyecto de prueba o abre una copia de un VLF. Prueba creación, + edición, guardado, ajustes, ventanas simultáneas y cierre con cambios pendientes. +5. Informa de la versión, Windows/WebView2 utilizados, pasos y error observado. + No publiques credenciales ni proyectos privados al comunicar un problema. + +El Setup utiliza la identidad y carpeta de instalación habituales de LANCTL: +actualiza una instalación existente. Para probar sin sustituirla, usa el ZIP +portable; guarda su estado en `data/lanctl` junto a los ejecutables, salvo que +hayas configurado variables de entorno que seleccionen otra raíz de datos. +Conserva copias de proyectos, configuración y credenciales antes de probar. + +## Prototipo incluido + +- Centro gráfico LANCTL con proyectos, metadatos, ajustes y gestión de plugins. +- Interfaces reales para LANIP, LANWIRE, LANRACK, LANACCESS y LANMON. +- Iconos por launcher, ventanas coordinadas, preferencias de arranque y terminal + integrada. CLI y TUI permanecen disponibles. +- Mejoras de configuración de proyectos y plugins, topología física y controles + de integridad y seguridad desarrollados desde la versión 0.3.3. + +## Alcance y límites + +Es software experimental, con flujos y controles todavía sujetos a cambios. +Las pruebas automáticas y el smoke de ejecutables no equivalen a una validación +manual completa de todas las pantallas o de un entorno de producción. +Los prototipos visuales de `GUI-PROTOTYPES.md` no se presentan como funciones terminadas. +Las distribuciones Linux conservan su alcance CLI/TUI; esta pre-release no declara +soporte gráfico Linux. El acceso remoto no se habilita automáticamente. + +La Release incluye los scripts de instalación, metadatos de versión/revisión y +sumas SHA-256. Para fijar la versión experimental en Windows: + +```powershell +.\install.ps1 -Version 0.3.4-alpha.1 +``` + +Documentación: [centro gráfico](LANCTL-GUI.md), [LANIP](LANIP-GUI.md), +[otras aplicaciones](LAUNCHER-GUI.md) y [limitaciones pendientes](BACKLOG.md). diff --git a/docs/SECURITY.md b/docs/SECURITY.md index 22079fe..5ee8941 100644 --- a/docs/SECURITY.md +++ b/docs/SECURITY.md @@ -38,6 +38,17 @@ interna no es una API pública para plugins. Los audit hooks y los límites del proceso siguen sin equivaler a un sandbox del sistema operativo para código hostil, como se indica en README. +Cada activación recibe una concesión nueva para el API del Core. Se comprueban +los permisos persistidos y la confianza del editor en cada acceso; las +referencias retenidas de callbacks, funciones, checks y almacenes dejan de ser +válidas al revocar. El gestor global reconcilia también cambios externos cada +0,5 s. La limpieza externa ocurre fuera de los locks del registro y no bloquea +la interfaz indefinidamente; una limpieza pendiente impide reactivar el plugin. +Esto no termina hilos nativos arbitrarios del runtime `trusted` heredado ni +deshace operaciones ya iniciadas. Su estado expone `restartRequired` y conserva +ese aviso durante la vida del gestor. La migración de runtime cancelable sigue +en REF-P34-runtime; no se declara esa frontera resuelta por invalidar callbacks. + Los VLF requieren un UUID canónico y su workspace resuelto debe permanecer dentro de la raíz configurada. Los checksums validan integridad, no confianza en las rutas proporcionadas por el archivo. Los paquetes LCP se extraen y verifican diff --git a/docs/VLF.md b/docs/VLF.md index 60fdae8..eca23bb 100644 --- a/docs/VLF.md +++ b/docs/VLF.md @@ -134,3 +134,13 @@ VLF 1.0 admite de forma aditiva `logs/events/YYYY-MM-DD.jsonl`, con un objeto `meta/checksum`; `project update` preserva el directorio completo. Las líneas corruptas o truncadas se omiten en lectura normal y producen error en modo estricto. `logs/dd-mm-yyyy.log` permanece disponible para auditoría legacy. + +### Preferencias explícitas del proyecto + +El editor `lanctl settings --scope project` conserva las preferencias de red +editadas en `lan/settings.override.json`, un documento opcional con +`schemaVersion: 1` y un objeto `network`. Sus campos corresponden a +`lan/network.config`; `network`, `netmask` y `prefixLength` se derivan de `cidr`. +El guardado conserva este documento y aplica sus valores sobre los valores +generados. Forma parte del cálculo de hashes del VLF. La activación carga las +preferencias explícitas sin reemplazar el inventario del espacio de trabajo. diff --git a/errorList.txt b/errorList.txt index f53a1b5..b50ec17 100644 --- a/errorList.txt +++ b/errorList.txt @@ -3,434 +3,551 @@ # Static IDs derive from semantic points; literal runtime events use origin + code 0e00423BAE | 43 | src/lanctl/core/group_database.py | 75 | src.lanctl.core.group_database.recover_device_group_transaction | raise 0e0069A197 | 43 | src/lanctl/core/history.py | 81 | src.lanctl.core.history.HistoryEvent.__post_init__ | raise -0e008332CA | 35 | src/lanctl/apps/ip/interfaces/tui/main.py | 3553 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise +0e008332CA | 35 | src/lanctl/apps/ip/interfaces/tui/main.py | 3688 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise 0e00873B45 | 43 | src/lanctl/core/database.py | 468 | src.lanctl.core.database.DeviceDatabase.search | raise -0e00B21620 | 45 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 189 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise +0e00AA9F9C | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py | 239 | src.lanctl.apps.ip.interfaces.cli.commands.settings_menu.dispatch_settings | raise +0e00B21620 | 45 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 188 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise 0e00CD3D84 | 45 | src/lanctl/apps/access/auth.py | 262 | src.lanctl.apps.access.auth.AuthenticationService.consume_pairing.consume | raise 0e0113BDBE | 32 | src/lanctl/apps/access/root_control.py | 199 | src.lanctl.apps.access.root_control.forced_view | raise +0e0117D8D5 | 42 | src/lanctl/core/settings_catalog.py | 120 | src.lanctl.core.settings_catalog.validate_value | raise 0e01B88F8B | 21 | src/lanctl/apps/access/audit.py | 9 | src.lanctl.apps.access.audit.completed | diagnostic 0e01D0583E | 46 | src/lanctl/apps/access/ssh_server.py | 52 | src.lanctl.apps.access.ssh_server.RestrictedSshServer.check_auth_password | return-error 0e020D6779 | 47 | src/lanctl/core/plugins/extensions.py | 49 | src.lanctl.core.plugins.extensions.ExtensionRegistry.register | raise -0e0245BC6A | 47 | src/lanctl/core/plugins/manager.py | 479 | src.lanctl.core.plugins.manager.PluginManager._activate | raise +0e0245BC6A | 47 | src/lanctl/core/plugins/manager.py | 658 | src.lanctl.core.plugins.manager.PluginManager._activate | raise 0e0280A965 | 33 | src/lanctl/core/coordination.py | 173 | src.lanctl.core.coordination.Coordinator.events | raise 0e028C4820 | 33 | src/lanctl/core/query.py | 52 | src.lanctl.core.query.matches_query | raise +0e02B4D815 | 36 | src/lanctl/apps/rack/organization.py | 87 | src.lanctl.apps.rack.organization.mutate.change | raise 0e02DD6BB3 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/open.py | 126 | src.lanctl.apps.ip.interfaces.cli.commands.open.run_open | raise -0e02EB2721 | 42 | src/lanctl/apps/monitor/commands.py | 311 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._assignment_action | raise -0e03DDC47C | 47 | src/lanctl/core/plugins/manager.py | 647 | src.lanctl.core.plugins.manager.PluginManager._check_dependencies | raise +0e02E2B2C3 | 32 | src/lanctl/apps/rack/organization.py | 84 | src.lanctl.apps.rack.organization.mutate.change | raise +0e02EB2721 | 42 | src/lanctl/apps/monitor/commands.py | 317 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._assignment_action | raise +0e03DDC47C | 47 | src/lanctl/core/plugins/manager.py | 877 | src.lanctl.core.plugins.manager.PluginManager._check_dependencies | raise 0e03F1C29C | 49 | src/lanctl/core/group_database.py | 157 | src.lanctl.core.group_database.GroupDatabase._commit_pair | raise 0e0432BE91 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/switch.py | 300 | src.lanctl.apps.ip.interfaces.cli.commands.switch.run_switch | raise +0e0446E5CC | 36 | src/lanctl/apps/suite/gui.py | 326 | src.lanctl.apps.suite.gui.SuiteApi.set_plugin_enabled.operation | raise +0e0457FBC7 | 42 | src/lanctl/core/settings_catalog.py | 204 | src.lanctl.core.settings_catalog.validate_value | raise 0e045995F7 | 36 | src/lanctl/apps/ip/lab/scenario.py | 39 | src.lanctl.apps.ip.lab.scenario.validate_scenario | raise -0e04D13546 | 18 | src/lanctl/core/plugins/manager.py | 670 | LANCTL.Plugin.Registry.Load | diagnostic -0e054AC130 | 46 | src/lanctl/bootstrap/lanctl.py | 101 | src.lanctl.bootstrap.lanctl.main | diagnostic +0e04D13546 | 18 | src/lanctl/core/plugins/manager.py | 931 | LANCTL.Plugin.Registry.Load | diagnostic +0e054AC130 | 46 | src/lanctl/bootstrap/lanctl.py | 134 | src.lanctl.bootstrap.lanctl.main | diagnostic 0e05844642 | 35 | src/lanctl/apps/ip/interfaces/cli/commands/ssh.py | 87 | src.lanctl.apps.ip.interfaces.cli.commands.ssh.run_ssh | raise +0e05978B11 | 42 | src/lanctl/core/clink_integration.py | 105 | src.lanctl.core.clink_integration.configure_clink | raise 0e05C25D19 | 48 | src/lanctl/apps/ip/interfaces/cli/commands/database.py | 63 | src.lanctl.apps.ip.interfaces.cli.commands.database.run_database | raise 0e0614E29A | 43 | src/lanctl/core/projects/save_policy.py | 224 | src.lanctl.core.projects.save_policy.normalize_save_mode | raise 0e063D0A7B | 36 | src/lanctl/apps/access/vault_service.py | 14 | src.lanctl.apps.access.vault_service.transfer | raise 0e064D1C88 | 37 | src/lanctl/core/plugins/device_adapters.py | 41 | src.lanctl.core.plugins.device_adapters.resolve_manufacturer_extensions | diagnostic +0e0673EAD5 | 33 | src/lanctl/core/rack_dimensions.py | 88 | src.lanctl.core.rack_dimensions.validate_dimension_change | raise 0e06BC4BC8 | 31 | src/lanctl/apps/wire/tui/app.py | 1325 | src.lanctl.apps.wire.tui.app.LanwireTui._move_selected_connection | raise 0e06BF4B62 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ssh.py | 110 | src.lanctl.apps.ip.interfaces.cli.commands.ssh.run_ssh | raise 0e073992C1 | 46 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 115 | src.lanctl.apps.ip.infrastructure.protocols.ssh.host_fingerprint | raise 0e07552047 | 43 | src/lanctl/core/projects/vlf.py | 122 | src.lanctl.core.projects.vlf.create_project | raise -0e0767D881 | 41 | src/lanctl/apps/ip/interfaces/gui/main.py | 924 | src.lanctl.apps.ip.interfaces.gui.main.run_gui | raise +0e0767D881 | 41 | src/lanctl/apps/ip/interfaces/gui/main.py | 928 | src.lanctl.apps.ip.interfaces.gui.main.run_gui | raise 0e077EE104 | 48 | src/lanctl/core/plugins/ui_contracts.py | 46 | src.lanctl.core.plugins.ui_contracts.validate_ui_action | raise 0e078AEF93 | 36 | src/lanctl/apps/ip/infrastructure/cisco/models.py | 45 | src.lanctl.apps.ip.infrastructure.cisco.models.SwitchProfile.resolve_port | raise -0e07A33054 | 16 | src/lanctl/core/plugins/builtin.py | 260 | LANCTL.Plugins.Builtin.Package | diagnostic +0e07A33054 | 16 | src/lanctl/core/plugins/builtin.py | 268 | LANCTL.Plugins.Builtin.Package | diagnostic 0e0827AAD2 | 49 | src/lanctl/apps/wire/xfile.py | 61 | src.lanctl.apps.wire.xfile.FileLock.acquire | raise 0e08E8EE8F | 31 | src/lanctl/apps/ip/interfaces/cli/commands/element.py | 187 | src.lanctl.apps.ip.interfaces.cli.commands.element.run_element | raise 0e090779F7 | 43 | src/lanctl/core/group_database.py | 73 | src.lanctl.core.group_database.recover_device_group_transaction | raise +0e090A538D | 43 | src/lanctl/apps/suite/gui.py | 41 | src.lanctl.apps.suite.gui.SuiteApi._respond | diagnostic 0e09285B2D | 33 | src/lanctl/core/plugins/events.py | 45 | src.lanctl.core.plugins.events.EventRegistry.register | raise 0e093DD8F0 | 32 | src/lanctl/apps/access/store.py | 101 | src.lanctl.apps.access.store.AccessStore.delete_user.operation | raise -0e0AB38C47 | 48 | src/lanctl/core/plugins/package.py | 170 | src.lanctl.core.plugins.package._verify_signature | raise +0e0AB38C47 | 48 | src/lanctl/core/plugins/package.py | 172 | src.lanctl.core.plugins.package._verify_signature | raise 0e0B00FEF9 | 46 | src/lanctl/core/plugins/isolated_runtime.py | 162 | src.lanctl.core.plugins.isolated_runtime._windows_memory_job | raise 0e0B1B01FD | 14 | src/lanctl/shared/i18n.py | 429 | src.lanctl.shared.i18n.initialize_language | diagnostic 0e0B83AA07 | 12 | src/lanctl/apps/ip/infrastructure/services/network_discovery.py | 52 | LANCTL.Discovery.Multicast.Receive | diagnostic 0e0B96DCFD | 43 | src/lanctl/core/projects/vlf.py | 63 | src.lanctl.core.projects.vlf.validate_project_id | raise 0e0BA977E1 | 33 | src/lanctl/apps/ip/domain/models/device.py | 128 | src.lanctl.apps.ip.domain.models.device.normalize_cnf | raise 0e0BC9AFD1 | 33 | src/lanctl/core/plugins/wol_runtime.py | 39 | src.lanctl.core.plugins.wol_runtime.send_magic_packet | raise -0e0BDCDFA0 | 43 | src/lanctl/core/database.py | 649 | src.lanctl.core.database.DeviceDatabase.add_device | raise -0e0BEE887B | 46 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 624 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._read_arp_table | raise +0e0BEE887B | 46 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 701 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._read_arp_table | raise 0e0C501A8C | 47 | src/lanctl/core/plugins/smb_runtime.py | 261 | src.lanctl.core.plugins.smb_runtime.SMBNative._linux_shares | raise +0e0C65A9AD | 12 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 490 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner.scan | diagnostic 0e0C763EF8 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/group.py | 63 | src.lanctl.apps.ip.interfaces.cli.commands.group.run_group | raise 0e0C86209C | 36 | src/lanctl/apps/ip/lab/scenario.py | 70 | src.lanctl.apps.ip.lab.scenario.generate_scenario | raise 0e0C8C6619 | 36 | src/lanctl/apps/access/service.py | 111 | src.lanctl.apps.access.service.AccessService.configure | raise 0e0C955571 | 42 | src/lanctl/core/vault_crypto.py | 38 | src.lanctl.core.vault_crypto.decrypt | raise 0e0CC4A288 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/plugin.py | 227 | src.lanctl.apps.ip.interfaces.cli.commands.plugin._publisher_revoke | raise +0e0CD7F702 | 36 | src/lanctl/apps/wire/gui_service.py | 202 | src.lanctl.apps.wire.gui_service.WireGuiService.connect | raise 0e0CE83FCB | 47 | src/lanctl/core/plugins/smb_runtime.py | 365 | src.lanctl.core.plugins.smb_runtime.SMBService.inspect | raise 0e0D0381E9 | 41 | src/lanctl/apps/monitor/lifecycle.py | 32 | src.lanctl.apps.monitor.lifecycle.SingletonLock.acquire | raise 0e0D7D326B | 41 | src/lanctl/core/database.py | 406 | src.lanctl.core.database.DeviceDatabase.save_devices | raise -0e0D9F00E3 | 47 | src/lanctl/core/plugins/package.py | 87 | src.lanctl.core.plugins.package.install_package | raise +0e0D9F00E3 | 47 | src/lanctl/core/plugins/package.py | 89 | src.lanctl.core.plugins.package.install_package | raise 0e0DD4110F | 33 | src/lanctl/apps/wire/cli/commands.py | 364 | src.lanctl.apps.wire.cli.commands.CommandProcessor._add_options | raise 0e0E2D0CAF | 42 | src/lanctl/core/plugins/scanners.py | 45 | src.lanctl.core.plugins.scanners.run_scanner_extensions | diagnostic +0e0E3CA228 | 43 | src/lanctl/bootstrap/lanctl.py | 219 | src.lanctl.bootstrap.lanctl.main | diagnostic 0e0E41EE57 | 36 | src/lanctl/apps/access/auth.py | 59 | src.lanctl.apps.access.auth.fingerprint_key | raise -0e0E4E7508 | 46 | src/lanctl/apps/access/manager_cli.py | 156 | src.lanctl.apps.access.manager_cli.AccessManager.set | raise 0e0E7539C2 | 33 | src/lanctl/apps/wire/idf/idf.py | 53 | src.lanctl.apps.wire.idf.idf.IDF.__post_init__ | raise -0e0E9E3FD2 | 33 | src/lanctl/apps/ip/domain/models/device.py | 200 | src.lanctl.apps.ip.domain.models.device.Device.from_dict | raise -0e0EDA4179 | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 1832 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._run_refresh | diagnostic +0e0E8FDEA3 | 34 | src/lanctl/core/network_interfaces.py | 112 | src.lanctl.core.network_interfaces.select_interface | raise +0e0EDA4179 | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 1854 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._run_refresh | diagnostic 0e0EE5F8D3 | 46 | src/lanctl/apps/access/vault_service.py | 24 | src.lanctl.apps.access.vault_service.transfer | raise 0e0EF4D527 | 33 | src/lanctl/apps/wire/error.py | 44 | src.lanctl.apps.wire.error.Error.__init__ | raise -0e0FC162F7 | 43 | src/lanctl/core/database.py | 651 | src.lanctl.core.database.DeviceDatabase.add_device | raise +0e0F00507B | 42 | src/lanctl/core/settings_catalog.py | 138 | src.lanctl.core.settings_catalog.validate_value | raise +0e0FC162F7 | 43 | src/lanctl/core/database.py | 647 | src.lanctl.core.database.DeviceDatabase.add_device | raise 0e0FF1A845 | 33 | src/lanctl/apps/access/auth.py | 21 | src.lanctl.apps.access.auth.hash_password | raise 0e0FF91669 | 33 | src/lanctl/core/error_catalog.py | 62 | src.lanctl.core.error_catalog.find_error | raise 0e102ED40F | 16 | src/lanctl/apps/access/root_control.py | 79 | src.lanctl.apps.access.root_control.interface_status | diagnostic -0e1035242E | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 715 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._apply_edit_history | raise -0e107FE90C | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 485 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise -0e10AEA0B5 | 14 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 64 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.local_ipv4 | diagnostic +0e1035242E | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 719 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._apply_edit_history | raise +0e107FE90C | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 507 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e109CD7E2 | 41 | src/lanctl/apps/suite/gui_support.py | 44 | src.lanctl.apps.suite.gui_support.GuiSupportMixin._support_reply | return-error +0e10AEA0B5 | 14 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 84 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.local_ipv4 | diagnostic 0e10AEC937 | 33 | src/lanctl/shared/assets/icons.py | 260 | src.lanctl.shared.assets.icons.jpeg_dimensions | raise 0e10CFEB59 | 33 | src/lanctl/apps/monitor/configuration.py | 143 | src.lanctl.apps.monitor.configuration.validate_profile | raise 0e10DC4E40 | 42 | src/lanctl/core/error_catalog.py | 46 | src.lanctl.core.error_catalog.load_error_catalog | raise 0e11233C96 | 35 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 572 | src.lanctl.apps.ip.interfaces.cli.commands.wol._power_command | raise 0e1156369F | 32 | src/lanctl/apps/access/root_control.py | 139 | src.lanctl.apps.access.root_control.enqueue | raise +0e1199AFEC | 48 | src/lanctl/core/plugins/package.py | 216 | src.lanctl.core.plugins.package.verify_directory | raise 0e11BF316D | 36 | src/lanctl/apps/wire/idf/idf.py | 78 | src.lanctl.apps.wire.idf.idf.IDF.parse | raise -0e11C44084 | 42 | src/lanctl/apps/access/manager_cli.py | 256 | src.lanctl.apps.access.manager_cli._tui_loop | diagnostic +0e11C44084 | 42 | src/lanctl/apps/access/manager_cli.py | 224 | src.lanctl.apps.access.manager_cli._tui_loop | diagnostic 0e11D3C0CA | 31 | src/lanctl/apps/ip/interfaces/cli/commands/terminal.py | 62 | src.lanctl.apps.ip.interfaces.cli.commands.terminal.run_terminal | raise -0e120A3995 | 48 | src/lanctl/core/plugins/package.py | 228 | src.lanctl.core.plugins.package.safe_package | raise +0e120A3995 | 48 | src/lanctl/core/plugins/package.py | 276 | src.lanctl.core.plugins.package.safe_package | raise 0e12164D14 | 36 | src/lanctl/apps/wire/cli/commands.py | 226 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise 0e12462B38 | 47 | src/lanctl/core/plugins/extensions.py | 52 | src.lanctl.core.plugins.extensions.ExtensionRegistry.register | raise +0e125923E5 | 33 | src/lanctl/core/activity.py | 40 | src.lanctl.core.activity.ActivityStore.append | raise 0e125A6CC0 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/modes.py | 97 | src.lanctl.apps.ip.interfaces.cli.commands.modes._run_global_command | print-error 0e129D02FA | 36 | src/lanctl/apps/wire/idf/database.py | 100 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.create.reserve | raise +0e12BDA0F4 | 33 | src/lanctl/apps/suite/gui.py | 243 | src.lanctl.apps.suite.gui.SuiteApi.settings_catalog.operation | raise 0e12F0605E | 33 | src/lanctl/core/projects/vlf.py | 69 | src.lanctl.core.projects.vlf.validate_project_id | raise -0e1307A9E4 | 31 | src/lanctl/apps/access/manager_cli.py | 284 | src.lanctl.apps.access.manager_cli._interactive_command | diagnostic +0e1307A9E4 | 31 | src/lanctl/apps/access/manager_cli.py | 252 | src.lanctl.apps.access.manager_cli._interactive_command | diagnostic 0e13301EF1 | 33 | src/lanctl/apps/ip/lab/scenario.py | 72 | src.lanctl.apps.ip.lab.scenario.generate_scenario | raise 0e13407BA0 | 47 | src/lanctl/core/plugins/theme.py | 50 | src.lanctl.core.plugins.theme.validate_theme_specification | raise -0e13556A93 | 43 | src/lanctl/core/projects/vlf.py | 660 | src.lanctl.core.projects.vlf._verify_sqlite | raise -0e1373B826 | 42 | src/lanctl/apps/monitor/commands.py | 337 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._report_action | raise -0e14405981 | 36 | src/lanctl/apps/access/https_server.py | 188 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise +0e13556A93 | 43 | src/lanctl/core/projects/vlf.py | 669 | src.lanctl.core.projects.vlf._verify_sqlite | raise +0e1373B826 | 42 | src/lanctl/apps/monitor/commands.py | 343 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._report_action | raise +0e138F02F8 | 45 | src/lanctl/core/plugins/authorization.py | 41 | src.lanctl.core.plugins.authorization.RuntimeAuthorizations.check | raise +0e14405981 | 36 | src/lanctl/apps/access/https_server.py | 198 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise 0e14786481 | 36 | src/lanctl/apps/wire/cli/commands.py | 176 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise 0e14B2D227 | 36 | src/lanctl/apps/ip/interfaces/gui/theme.py | 53 | src.lanctl.apps.ip.interfaces.gui.theme.validate_theme_specification | raise 0e14C8CBEF | 36 | src/lanctl/infrastructure/distribution/release.py | 39 | src.lanctl.infrastructure.distribution.release.artifact_name | raise 0e14CB3847 | 34 | src/lanctl/core/interactive_console.py | 119 | src.lanctl.core.interactive_console.command_console | diagnostic -0e154E22FA | 48 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 207 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.use_project.operation | raise +0e14D1B4FD | 35 | src/lanctl/apps/access/gui_service.py | 61 | src.lanctl.apps.access.gui_service.AccessGuiService.set | raise +0e1539113E | 36 | src/lanctl/apps/access/gui_service.py | 88 | src.lanctl.apps.access.gui_service.AccessGuiService.open | raise +0e154E22FA | 48 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 354 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.use_project.operation | raise 0e154E2A24 | 43 | src/lanctl/core/group_database.py | 77 | src.lanctl.core.group_database.recover_device_group_transaction | raise -0e15A2BB69 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 444 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e15A2BB69 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 466 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0e15AB2359 | 43 | src/lanctl/core/group_database.py | 66 | src.lanctl.core.group_database.recover_device_group_transaction | raise 0e15C25B19 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 410 | src.lanctl.apps.ip.interfaces.cli.commands.wol._sequence_locked | raise +0e15EBD509 | 41 | src/lanctl/bootstrap/lanctl.py | 171 | src.lanctl.bootstrap.lanctl.main | return-error 0e15F20570 | 36 | src/lanctl/apps/wire/error.py | 42 | src.lanctl.apps.wire.error.Error.__init__ | raise 0e15F2ABDD | 32 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 209 | LANCTL.WOL.Resolve.Device | diagnostic -0e1647DD82 | 43 | src/lanctl/core/projects/vlf.py | 361 | src.lanctl.core.projects.vlf.append_monitor_document | raise +0e1647DD82 | 43 | src/lanctl/core/projects/vlf.py | 369 | src.lanctl.core.projects.vlf.append_monitor_document | raise +0e166260AE | 42 | src/lanctl/apps/monitor/gui_service.py | 101 | src.lanctl.apps.monitor.gui_service.MonitorGuiService.action | raise 0e1683931F | 42 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 66 | src.lanctl.apps.ip.infrastructure.protocols.radmin.find_viewer | raise +0e16D08B11 | 42 | src/lanctl/core/installation.py | 23 | src.lanctl.core.installation.initialize_defaults | raise 0e16D6BF9B | 36 | src/lanctl/infrastructure/platform/linux.py | 72 | src.lanctl.infrastructure.platform.linux._systemd_quote | raise 0e16DF104D | 46 | src/lanctl/infrastructure/platform/windows_service.py | 64 | src.lanctl.infrastructure.platform.windows_service.WindowsServiceHost.run | raise 0e16EB2664 | 36 | src/lanctl/apps/ip/infrastructure/terminals/registry.py | 74 | src.lanctl.apps.ip.infrastructure.terminals.registry.open_terminal | raise 0e176C6939 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 98 | src.lanctl.core.plugins.isolated_runtime._MessageReader.receive | raise -0e17745A91 | 14 | src/lanctl/core/plugins/manager.py | 323 | src.lanctl.core.plugins.manager.PluginManager.disable | diagnostic -0e1777191D | 48 | src/lanctl/core/plugins/package.py | 129 | src.lanctl.core.plugins.package.build_package | raise +0e1777191D | 48 | src/lanctl/core/plugins/package.py | 131 | src.lanctl.core.plugins.package.build_package | raise 0e1796FC0B | 47 | src/lanctl/core/plugins/functions.py | 35 | src.lanctl.core.plugins.functions.FunctionRegistry.call | raise -0e179F90C5 | 46 | src/lanctl/bootstrap/lanctl.py | 101 | LANCTL.Suite.Access.Elevate | diagnostic +0e179F90C5 | 46 | src/lanctl/bootstrap/lanctl.py | 134 | LANCTL.Suite.Access.Elevate | diagnostic 0e17FD4502 | 36 | src/lanctl/shared/i18n.py | 205 | src.lanctl.shared.i18n.LanguageManager.load_file | raise 0e181FD4CC | 45 | src/lanctl/core/local_permissions.py | 31 | src.lanctl.core.local_permissions.launch_elevated | raise 0e183CB70B | 33 | src/lanctl/core/projects/workspace.py | 164 | src.lanctl.core.projects.workspace.prepare_project_workspace | raise 0e1891649C | 36 | src/lanctl/apps/ip/interfaces/gui/theme.py | 65 | src.lanctl.apps.ip.interfaces.gui.theme.validate_theme_specification | raise +0e189D5C08 | 36 | src/lanctl/apps/rack/organization.py | 69 | src.lanctl.apps.rack.organization.mutate.change | raise 0e18A7D0A7 | 33 | src/lanctl/apps/ip/lab/scenario.py | 76 | src.lanctl.apps.ip.lab.scenario.generate_scenario | raise +0e18C0E169 | 42 | src/lanctl/core/gui_preferences.py | 23 | src.lanctl.core.gui_preferences.validate_preferences | raise 0e18C266E9 | 44 | src/lanctl/apps/access/auth.py | 222 | src.lanctl.apps.access.auth.AuthenticationService.validate_session | raise 0e18FB2575 | 43 | src/lanctl/core/group_database.py | 84 | src.lanctl.core.group_database.recover_device_group_transaction | raise -0e1908DC4A | 33 | src/lanctl/apps/wire/idf/database.py | 271 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise +0e1908DC4A | 33 | src/lanctl/apps/wire/idf/database.py | 285 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise 0e19A60A78 | 33 | src/lanctl/apps/access/auth.py | 124 | src.lanctl.apps.access.auth.AuthenticationService.add_user | raise 0e19D83355 | 49 | src/lanctl/core/errors.py | 37 | src.lanctl.core.errors.ErrorLevel.parse | raise 0e19FC0798 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 494 | src.lanctl.apps.ip.interfaces.cli.commands.wol._validate_graph.visit | raise +0e1A40CF4D | 42 | src/lanctl/core/updates.py | 82 | src.lanctl.core.updates.UpdateService._read | raise 0e1ABAC71C | 42 | src/lanctl/core/device_retention.py | 48 | src.lanctl.core.device_retention.normalize_retention_scope | raise +0e1ACDDCD7 | 32 | src/lanctl/apps/wire/gui_service.py | 199 | src.lanctl.apps.wire.gui_service.WireGuiService.connect | raise 0e1ADDD452 | 36 | src/lanctl/shared/i18n.py | 406 | src.lanctl.shared.i18n._validate_placeholders | raise +0e1AE22FBA | 45 | src/lanctl/core/plugins/manager.py | 851 | src.lanctl.core.plugins.manager.PluginManager._validate_activation | raise 0e1AF3284A | 43 | src/lanctl/core/credentials.py | 57 | src.lanctl.core.credentials.protect_secret | raise +0e1AFEA522 | 47 | src/lanctl/core/plugins/manager.py | 914 | src.lanctl.core.plugins.manager.PluginManager._read_registry | raise 0e1B056742 | 34 | src/lanctl/core/credentials.py | 130 | src.lanctl.core.credentials.CredentialStore._vault_password | raise 0e1B168589 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/credential.py | 59 | src.lanctl.apps.ip.interfaces.cli.commands.credential.run_credential | raise 0e1B1A75C0 | 36 | src/lanctl/apps/wire/idf/database.py | 226 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.update.replace | raise -0e1B1EFBCB | 42 | src/lanctl/apps/monitor/commands.py | 232 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._incident_action | raise +0e1B1EFBCB | 42 | src/lanctl/apps/monitor/commands.py | 238 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._incident_action | raise 0e1BA6B260 | 41 | src/lanctl/apps/access/firewall.py | 39 | src.lanctl.apps.access.firewall.FirewallManager.remove | raise -0e1BE9318C | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 343 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.diagnose_device.operation | raise -0e1C7305CF | 46 | src/lanctl/apps/access/https_server.py | 293 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler.do_POST | diagnostic +0e1BE9318C | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 347 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.diagnose_device.operation | raise +0e1BFD62FE | 43 | src/lanctl/core/projects/settings.py | 99 | src.lanctl.core.projects.settings.update_project_setting | raise +0e1C7305CF | 46 | src/lanctl/apps/access/https_server.py | 303 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler.do_POST | diagnostic 0e1C795854 | 42 | src/lanctl/apps/monitor/configuration.py | 254 | src.lanctl.apps.monitor.configuration.MonitorAssignment.__post_init__ | raise 0e1C79E256 | 35 | src/lanctl/core/session.py | 67 | LANCTL.Core.Coordination.Transport | diagnostic -0e1C95FA6C | 33 | src/lanctl/apps/monitor/event_view.py | 49 | src.lanctl.apps.monitor.event_view.read_events | raise +0e1C95FA6C | 33 | src/lanctl/apps/monitor/event_view.py | 59 | src.lanctl.apps.monitor.event_view.read_events | raise 0e1CB9A9D7 | 35 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 161 | src.lanctl.apps.ip.infrastructure.protocols.ssh.verify_pinned_host | raise 0e1CBDCE30 | 18 | src/lanctl/apps/monitor/scheduler.py | 124 | LANCTL.Monitor.Scheduler.Task | diagnostic +0e1D04553C | 42 | src/lanctl/core/activity.py | 75 | src.lanctl.core.activity.ActivityStore.query | raise 0e1D1DB330 | 36 | src/lanctl/__main__.py | 6 | src.lanctl.__main__ | raise 0e1D1DDAA7 | 49 | src/lanctl/core/errors.py | 43 | src.lanctl.core.errors.ErrorLevel.parse | raise -0e1DBCE5F5 | 24 | src/lanctl/apps/ip/interfaces/tui/main.py | 870 | LANCTL.Project.Catalog.Refresh | diagnostic -0e1DCE3A51 | 33 | src/lanctl/apps/ip/interfaces/gui/main.py | 301 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.scan_network.operation | raise -0e1E2F0265 | 43 | src/lanctl/core/database.py | 661 | src.lanctl.core.database.DeviceDatabase.add_device | raise -0e1E770EC1 | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 3627 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise +0e1D1E1294 | 36 | src/lanctl/apps/wire/gui_service.py | 162 | src.lanctl.apps.wire.gui_service.WireGuiService.update | raise +0e1D3C7A44 | 48 | src/lanctl/core/plugins/package.py | 188 | src.lanctl.core.plugins.package._verify_signature_bytes | raise +0e1DB226D7 | 36 | src/lanctl/apps/suite/gui_support.py | 174 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.open_monitor.launch | raise +0e1DBCE5F5 | 24 | src/lanctl/apps/ip/interfaces/tui/main.py | 874 | LANCTL.Project.Catalog.Refresh | diagnostic +0e1E2F0265 | 43 | src/lanctl/core/database.py | 657 | src.lanctl.core.database.DeviceDatabase.add_device | raise +0e1E770EC1 | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 3762 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise 0e1E9ABBA7 | 48 | src/lanctl/core/projects/workspace.py | 114 | src.lanctl.core.projects.workspace._inventory_documents | raise -0e1F4367C3 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 178 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise -0e1F769131 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 461 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.open_service.operation | raise +0e1EE66D29 | 41 | src/lanctl/apps/suite/processes.py | 98 | src.lanctl.apps.suite.processes.EmbeddedCli.send | raise +0e1F4367C3 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 180 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise +0e1F769131 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 465 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.open_service.operation | raise 0e1FB89F94 | 31 | src/lanctl/apps/wire/cli/commands.py | 327 | src.lanctl.apps.wire.cli.commands.CommandProcessor._element_field_label | raise 0e1FCD16D0 | 36 | src/lanctl/shared/i18n.py | 193 | src.lanctl.shared.i18n.LanguageManager.load_file | raise 0e2002E2A0 | 48 | src/lanctl/core/plugins/contracts.py | 93 | src.lanctl.core.plugins.contracts.construct_contract | raise 0e202C1D48 | 33 | src/lanctl/apps/monitor/configuration.py | 263 | src.lanctl.apps.monitor.configuration.MonitorAssignment.__post_init__ | raise -0e202F34F8 | 48 | src/lanctl/core/plugins/package.py | 177 | src.lanctl.core.plugins.package._verify_signature | raise 0e20883C51 | 33 | src/lanctl/shared/assets/icons.py | 141 | src.lanctl.shared.assets.icons.IconManager.add_provider | raise -0e20C5C91D | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 87 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.resolve_network | raise +0e20C5C91D | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 107 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.resolve_network | raise 0e20D91694 | 35 | src/lanctl/apps/ip/interfaces/cli/commands/element.py | 87 | src.lanctl.apps.ip.interfaces.cli.commands.element.run_element | raise 0e20F4C96F | 45 | src/lanctl/apps/access/auth.py | 149 | src.lanctl.apps.access.auth.AuthenticationService._usable | raise 0e212B8BB0 | 47 | src/lanctl/core/plugins/smb_runtime.py | 256 | src.lanctl.core.plugins.smb_runtime.SMBNative.connect_printer | raise +0e213BD7C9 | 47 | src/lanctl/core/plugins/selection.py | 43 | src.lanctl.core.plugins.selection.initialize_selection | raise 0e216F2DBF | 43 | src/lanctl/core/projects/save_policy.py | 62 | src.lanctl.core.projects.save_policy.remember_close_answer | raise -0e21BB00EC | 45 | src/lanctl/core/plugins/manager.py | 472 | src.lanctl.core.plugins.manager.PluginManager._activate | raise +0e2188C98A | 34 | src/lanctl/apps/ip/interfaces/tui/main.py | 3026 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._project_metadata_error | diagnostic +0e21BB00EC | 45 | src/lanctl/core/plugins/manager.py | 651 | src.lanctl.core.plugins.manager.PluginManager._activate | raise 0e21CC0A14 | 42 | src/lanctl/apps/monitor/configuration.py | 186 | src.lanctl.apps.monitor.configuration.JsonDocument.load | raise +0e21F26520 | 36 | src/lanctl/apps/wire/gui_service.py | 186 | src.lanctl.apps.wire.gui_service.WireGuiService.connect | raise +0e21F99FAD | 46 | src/lanctl/core/clink_integration.py | 135 | src.lanctl.core.clink_integration.configure_clink | raise 0e221FB9BC | 46 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 201 | src.lanctl.apps.ip.infrastructure.protocols.ssh.run_show_command | raise -0e226FB5FB | 46 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 75 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.local_ipv4 | raise -0e22903F54 | 43 | src/lanctl/core/projects/vlf.py | 416 | src.lanctl.core.projects.vlf.verify_project | raise +0e225C4088 | 34 | src/lanctl/apps/monitor/gui_service.py | 107 | src.lanctl.apps.monitor.gui_service.MonitorGuiService.action | raise +0e226FB5FB | 46 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 95 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.local_ipv4 | raise +0e22903F54 | 43 | src/lanctl/core/projects/vlf.py | 424 | src.lanctl.core.projects.vlf.verify_project | raise 0e22A38744 | 33 | src/lanctl/apps/wire/cli/commands.py | 377 | src.lanctl.apps.wire.cli.commands.CommandProcessor._add_options | raise 0e22B8634B | 33 | src/lanctl/apps/ip/domain/models/device.py | 69 | src.lanctl.apps.ip.domain.models.device.normalize_mac | raise +0e2312E310 | 42 | src/lanctl/core/network_interfaces.py | 56 | src.lanctl.core.network_interfaces.ipv4_interfaces | raise 0e234B2DBC | 33 | src/lanctl/apps/monitor/configuration.py | 102 | src.lanctl.apps.monitor.configuration.ConfigProvider.profile | raise 0e2354781D | 36 | src/lanctl/apps/ip/interfaces/gui/theme.py | 62 | src.lanctl.apps.ip.interfaces.gui.theme.validate_theme_specification | raise 0e238939DB | 36 | src/lanctl/shared/i18n.py | 241 | src.lanctl.shared.i18n.LanguageManager.add_provider | raise +0e2397C59A | 48 | src/lanctl/core/plugins/package.py | 238 | src.lanctl.core.plugins.package.directory_hash | raise 0e239F426F | 39 | src/lanctl/apps/ip/interfaces/cli/commands/database.py | 69 | src.lanctl.apps.ip.interfaces.cli.commands.database.run_database | raise 0e23ADCA65 | 42 | src/lanctl/core/coordination.py | 61 | src.lanctl.core.coordination.Coordinator.connection | raise +0e23E7C262 | 32 | src/lanctl/apps/rack/skins.py | 128 | src.lanctl.apps.rack.skins.validate_location | raise 0e24AE8CD3 | 41 | src/lanctl/apps/wire/tui/app.py | 1109 | src.lanctl.apps.wire.tui.app.LanwireTui._editor_field | raise 0e24E40047 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/ping.py | 91 | src.lanctl.apps.ip.interfaces.cli.commands.ping.run_ping | raise -0e24F8B6A9 | 48 | src/lanctl/core/plugins/package.py | 67 | src.lanctl.core.plugins.package.install_package | raise +0e24F8B6A9 | 48 | src/lanctl/core/plugins/package.py | 68 | src.lanctl.core.plugins.package.install_package | raise 0e25215E1E | 36 | src/lanctl/apps/wire/cli/commands.py | 331 | src.lanctl.apps.wire.cli.commands.CommandProcessor._element_field_label | raise -0e262B76BA | 43 | src/lanctl/core/database.py | 665 | src.lanctl.core.database.DeviceDatabase.add_device | raise +0e25A3402C | 41 | src/lanctl/bootstrap/lanctl.py | 203 | src.lanctl.bootstrap.lanctl.main | return-error +0e260FD1D9 | 34 | src/lanctl/apps/access/remote_setup.py | 116 | src.lanctl.apps.access.remote_setup.InitialRemoteAccount.create | raise +0e262B76BA | 43 | src/lanctl/core/database.py | 661 | src.lanctl.core.database.DeviceDatabase.add_device | raise 0e26475D84 | 47 | src/lanctl/core/plugins/smb_runtime.py | 187 | src.lanctl.core.plugins.smb_runtime.SMBNative.connect | raise 0e2660BE4D | 33 | src/lanctl/apps/ip/domain/models/device.py | 93 | src.lanctl.apps.ip.domain.models.device.normalize_protocol | raise 0e26B93FC1 | 41 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 161 | src.lanctl.apps.ip.infrastructure.protocols.radmin.launch | raise 0e26CCF0B1 | 47 | src/lanctl/core/plugins/smb_runtime.py | 239 | src.lanctl.core.plugins.smb_runtime.SMBNative.open_path | raise 0e26D1DC90 | 42 | src/lanctl/core/plugin_storage.py | 18 | src.lanctl.core.plugin_storage.PluginStorage.__init__ | raise 0e26D34573 | 46 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 204 | src.lanctl.apps.ip.infrastructure.protocols.ssh.run_show_command | raise -0e26F913DF | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 391 | src.lanctl.apps.ip.interfaces.gui.desktop.run_gui | raise +0e26F913DF | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 602 | src.lanctl.apps.ip.interfaces.gui.desktop.run_gui | raise 0e2741D1BC | 34 | src/lanctl/core/interactive_console.py | 119 | LANCTL.Suite.Console.Command | diagnostic 0e27669255 | 43 | src/lanctl/core/projects/workspace.py | 182 | src.lanctl.core.projects.workspace.prepare_project_workspace | raise 0e278FA162 | 46 | src/lanctl/apps/access/ssh_server.py | 243 | src.lanctl.apps.access.ssh_server.SshAccessServer._execute | return-error 0e2832E3DE | 36 | src/lanctl/bootstrap/lanip.py | 19 | src.lanctl.bootstrap.lanip | raise 0e2875C2E7 | 44 | src/lanctl/apps/ip/interfaces/cli/commands/smb.py | 102 | src.lanctl.apps.ip.interfaces.cli.commands.smb._credential | raise 0e28ACBF03 | 36 | src/lanctl/apps/ip/infrastructure/cisco/profiles.py | 69 | src.lanctl.apps.ip.infrastructure.cisco.profiles.load_profile | raise -0e28C322DA | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 470 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e28C322DA | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 492 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0e28CE78FA | 36 | src/lanctl/apps/ip/interfaces/gui/theme.py | 58 | src.lanctl.apps.ip.interfaces.gui.theme.validate_theme_specification | raise +0e28D4CA61 | 36 | src/lanctl/apps/rack/skins.py | 92 | src.lanctl.apps.rack.skins.appearance | raise 0e28D50BF0 | 36 | src/lanctl/apps/wire/tui/editor.py | 422 | src.lanctl.apps.wire.tui.editor._parse_value | raise 0e29526A6B | 31 | src/lanctl/apps/ip/interfaces/cli/commands/credential.py | 84 | src.lanctl.apps.ip.interfaces.cli.commands.credential.run_credential | raise 0e2958B51D | 36 | src/lanctl/shared/i18n.py | 210 | src.lanctl.shared.i18n.LanguageManager.load_file | raise 0e29A4E48E | 43 | src/lanctl/core/database.py | 435 | src.lanctl.core.database.DeviceDatabase._find | raise -0e29F7FD18 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/list.py | 272 | src.lanctl.apps.ip.interfaces.cli.commands.list.run_list | raise -0e2A059148 | 39 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 170 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._parallel | raise +0e29BDAE7C | 36 | src/lanctl/apps/rack/organization.py | 34 | src.lanctl.apps.rack.organization.organization | raise +0e29F7FD18 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/list.py | 297 | src.lanctl.apps.ip.interfaces.cli.commands.list.run_list | raise +0e2A059148 | 39 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 207 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._parallel | raise +0e2A50F4B3 | 43 | src/lanctl/core/projects/settings.py | 97 | src.lanctl.core.projects.settings.update_project_setting | raise 0e2A7ECABB | 48 | src/lanctl/core/plugins/models.py | 70 | src.lanctl.core.plugins.models.PluginManifest.from_dict | raise 0e2A908373 | 45 | src/lanctl/apps/ip/interfaces/gui/main.py | 147 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.plugin_panel_data.operation | raise 0e2B099EBE | 36 | src/lanctl/apps/ip/lab/scenario.py | 173 | src.lanctl.apps.ip.lab.scenario.LabRepository.path | raise 0e2B1DAB3C | 42 | src/lanctl/core/tr064.py | 128 | src.lanctl.core.tr064.Tr064Client.call | raise 0e2B62B73C | 34 | src/lanctl/apps/access/store.py | 78 | src.lanctl.apps.access.store.AccessStore.create_user.operation | raise -0e2BCE014C | 48 | src/lanctl/core/plugins/package.py | 231 | src.lanctl.core.plugins.package.safe_package | raise -0e2C3E9A07 | 43 | src/lanctl/core/group_database.py | 251 | src.lanctl.core.group_database.GroupDatabase.create | raise -0e2C5CFDFC | 43 | src/lanctl/core/database.py | 602 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise +0e2BA42E29 | 47 | src/lanctl/core/plugins/manager.py | 908 | src.lanctl.core.plugins.manager.PluginManager._read_registry | raise +0e2BCE014C | 48 | src/lanctl/core/plugins/package.py | 279 | src.lanctl.core.plugins.package.safe_package | raise +0e2C3E9A07 | 43 | src/lanctl/core/group_database.py | 253 | src.lanctl.core.group_database.GroupDatabase.create | raise +0e2C5CFDFC | 43 | src/lanctl/core/database.py | 600 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise 0e2C6BC017 | 35 | src/lanctl/apps/ip/interfaces/cli/commands/element.py | 106 | src.lanctl.apps.ip.interfaces.cli.commands.element.run_element | raise 0e2CB76538 | 33 | src/lanctl/core/output.py | 520 | src.lanctl.core.output.normalize_columns | raise +0e2D3068A8 | 36 | src/lanctl/apps/suite/launcher_gui.py | 253 | src.lanctl.apps.suite.launcher_gui.LauncherApi.open_gui.operation | raise +0e2D951B7D | 45 | src/lanctl/core/plugins/manager.py | 866 | src.lanctl.core.plugins.manager.PluginManager._validate_activation | raise +0e2DDAE5B5 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py | 251 | src.lanctl.apps.ip.interfaces.cli.commands.settings_menu.dispatch_settings | raise +0e2DFECC36 | 36 | src/lanctl/apps/wire/gui_service.py | 192 | src.lanctl.apps.wire.gui_service.WireGuiService.connect | raise +0e2E026F64 | 41 | src/lanctl/apps/ip/interfaces/gui/main.py | 334 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._scan_with_target.operation | raise 0e2E0869A0 | 36 | src/lanctl/apps/ip/lab/scenario.py | 33 | src.lanctl.apps.ip.lab.scenario.validate_scenario | raise 0e2EC31D4E | 48 | src/lanctl/core/plugins/ui_contracts.py | 29 | src.lanctl.core.plugins.ui_contracts.validate_ui_panel | raise 0e2EDE7D77 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/project.py | 179 | src.lanctl.apps.ip.interfaces.cli.commands.project._update | raise 0e2EFFBA9F | 32 | src/lanctl/apps/access/store.py | 89 | src.lanctl.apps.access.store.AccessStore.update_user.operation | raise -0e2F6EABA0 | 32 | src/lanctl/apps/ip/interfaces/gui/main.py | 424 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.create_project.operation | raise +0e2F6EABA0 | 32 | src/lanctl/apps/ip/interfaces/gui/main.py | 428 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.create_project.operation | raise 0e2FA0BB43 | 48 | src/lanctl/core/plugins/ui_contracts.py | 38 | src.lanctl.core.plugins.ui_contracts.validate_ui_panel | raise -0e2FBB0835 | 36 | src/lanctl/apps/access/manager_cli.py | 146 | src.lanctl.apps.access.manager_cli.AccessManager.set | raise +0e2FBB0835 | 36 | src/lanctl/apps/access/manager_cli.py | 134 | src.lanctl.apps.access.manager_cli.AccessManager.set | raise +0e2FBE844C | 48 | src/lanctl/core/plugins/package.py | 185 | src.lanctl.core.plugins.package._verify_signature_bytes | raise 0e30319C23 | 42 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 335 | src.lanctl.apps.ip.infrastructure.protocols.ssh.open_colored_interactive | raise 0e30AEF6D5 | 45 | src/lanctl/apps/access/remote.py | 250 | src.lanctl.apps.access.remote.RemoteGuiApi.call | raise 0e31040603 | 33 | src/lanctl/shared/assets/icons.py | 265 | src.lanctl.shared.assets.icons.jpeg_dimensions | raise 0e3131B8D2 | 47 | src/lanctl/core/plugins/smb_runtime.py | 161 | src.lanctl.core.plugins.smb_runtime.SMBNative.shares | raise -0e315FA610 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 173 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise -0e318299C5 | 06 | src/lanctl/core/plugins/manager.py | 184 | src.lanctl.core.plugins.manager.PluginManager.activate_enabled | diagnostic +0e315FA610 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 175 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise +0e318299C5 | 06 | src/lanctl/core/plugins/manager.py | 239 | src.lanctl.core.plugins.manager.PluginManager.activate_enabled | diagnostic +0e31A96002 | 43 | src/lanctl/core/projects/settings.py | 65 | src.lanctl.core.projects.settings.update_project_setting | raise +0e31D3BE8D | 36 | src/lanctl/apps/rack/organization.py | 95 | src.lanctl.apps.rack.organization.mutate.change | raise 0e31E01D7B | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 129 | src.lanctl.apps.ip.interfaces.cli.commands.wol._online | raise -0e31EEAEF4 | 34 | src/lanctl/core/projects/vlf.py | 420 | src.lanctl.core.projects.vlf.verify_project | raise +0e31EEAEF4 | 34 | src/lanctl/core/projects/vlf.py | 428 | src.lanctl.core.projects.vlf.verify_project | raise 0e32142F32 | 46 | src/lanctl/apps/ip/interfaces/tui/clipboard.py | 43 | src.lanctl.apps.ip.interfaces.tui.clipboard.copy_text | raise 0e322615AE | 36 | src/lanctl/apps/wire/tui/app.py | 1305 | src.lanctl.apps.wire.tui.app.LanwireTui._connect_selected_port | raise 0e323FFF7C | 42 | src/lanctl/core/plugins/scanners.py | 45 | LANCTL.Plugin.Scanner.Result | diagnostic -0e32E0F3C0 | 45 | src/lanctl/core/plugins/api.py | 167 | src.lanctl.core.plugins.api._PluginFunctions.register | raise +0e32CE1AF1 | 48 | src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py | 124 | src.lanctl.apps.ip.interfaces.cli.commands.settings_menu._set | raise +0e32E0F3C0 | 45 | src/lanctl/core/plugins/api.py | 194 | src.lanctl.core.plugins.api._PluginFunctions.register | raise +0e32FB209A | 33 | src/lanctl/core/settings_catalog.py | 105 | src.lanctl.core.settings_catalog.validate_value | raise 0e3335B8B1 | 36 | src/lanctl/apps/ip/lab/scenario.py | 48 | src.lanctl.apps.ip.lab.scenario.validate_scenario | raise -0e3377A10C | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 183 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise +0e3377A10C | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 185 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise 0e33949171 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 387 | src.lanctl.apps.ip.interfaces.cli.commands.wol._sequence_locked | raise -0e33A32677 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 494 | src.lanctl.apps.ip.interfaces.cli.commands.access._role | raise +0e33A32677 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 512 | src.lanctl.apps.ip.interfaces.cli.commands.access._role | raise 0e3462E2D7 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 392 | src.lanctl.apps.ip.interfaces.cli.commands.wol._sequence_locked | raise +0e34B9A71E | 36 | src/lanctl/apps/suite/gui_support.py | 333 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.export_report.export | raise 0e3501550B | 36 | src/lanctl/apps/ip/interfaces/gui/theme.py | 96 | src.lanctl.apps.ip.interfaces.gui.theme._validate_value | raise -0e3549DC2D | 43 | src/lanctl/core/database.py | 577 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise +0e35478A8E | 32 | src/lanctl/apps/rack/organization.py | 63 | src.lanctl.apps.rack.organization.mutate.change | raise +0e3549DC2D | 43 | src/lanctl/core/database.py | 575 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise +0e3595A2FE | 42 | src/lanctl/core/updates.py | 112 | src.lanctl.core.updates.UpdateService._read | raise +0e35FE1CA6 | 47 | src/lanctl/core/plugins/manager.py | 500 | src.lanctl.core.plugins.manager.PluginManager.refresh_authorizations | raise 0e3615E8FF | 48 | src/lanctl/core/plugins/ui_contracts.py | 64 | src.lanctl.core.plugins.ui_contracts.validate_form_schema | raise +0e3633EA8C | 41 | src/lanctl/apps/suite/launcher_gui.py | 62 | src.lanctl.apps.suite.launcher_gui.LauncherApi._respond | return-error +0e364367B4 | 48 | src/lanctl/core/plugins/package.py | 243 | src.lanctl.core.plugins.package.directory_hash | raise 0e366D108A | 36 | src/lanctl/apps/access/models.py | 80 | src.lanctl.apps.access.models.aware | raise +0e36DF5A92 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py | 95 | src.lanctl.apps.ip.interfaces.cli.commands.settings_menu._set | raise +0e3708F7A8 | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 429 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.open_terminal.operation | raise 0e37108092 | 47 | src/lanctl/core/plugins/events.py | 59 | src.lanctl.core.plugins.events.EventRegistry.get | raise -0e3786F9BE | 49 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 185 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._parallel | raise +0e3786F9BE | 49 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 222 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._parallel | raise 0e37B1DBAC | 31 | src/lanctl/apps/ip/interfaces/cli/commands/terminal.py | 40 | src.lanctl.apps.ip.interfaces.cli.commands.terminal.choose_terminal | raise -0e38261541 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 451 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner.scan | raise -0e38D601DB | 49 | src/lanctl/core/session.py | 135 | src.lanctl.core.session.Session.poll | raise +0e38261541 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 504 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner.scan | raise +0e38D601DB | 49 | src/lanctl/core/session.py | 136 | src.lanctl.core.session.Session.poll | raise 0e38FC5367 | 36 | src/lanctl/apps/wire/tui/app.py | 1290 | src.lanctl.apps.wire.tui.app.LanwireTui._execute_wire_side_action | raise -0e398CE550 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 467 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.open_service.operation | raise -0e39CFF61D | 42 | src/lanctl/apps/monitor/commands.py | 209 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._required_word | raise -0e39FC5E23 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 260 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise -0e3A07EDC0 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 498 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise +0e39038C77 | 48 | src/lanctl/core/plugins/package.py | 228 | src.lanctl.core.plugins.package.verify_directory | raise +0e39758DAF | 33 | src/lanctl/core/projects/settings.py | 93 | src.lanctl.core.projects.settings.update_project_setting | raise +0e398CE550 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 471 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.open_service.operation | raise +0e399CE7A5 | 24 | src/lanctl/core/updates.py | 194 | LANCTL.Core.Updates.Check | diagnostic +0e39CD2799 | 33 | src/lanctl/core/plugins/settings.py | 67 | src.lanctl.core.plugins.settings.PluginSettings.fields | raise +0e39CFF61D | 42 | src/lanctl/apps/monitor/commands.py | 215 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._required_word | raise +0e39FC5E23 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 259 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise +0e3A07EDC0 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 510 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise 0e3A3B820B | 32 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 209 | src.lanctl.apps.ip.interfaces.cli.commands.wol._wake | diagnostic -0e3A4D46AD | 43 | src/lanctl/core/projects/vlf.py | 638 | src.lanctl.core.projects.vlf._safe_archive | raise +0e3A4D46AD | 43 | src/lanctl/core/projects/vlf.py | 647 | src.lanctl.core.projects.vlf._safe_archive | raise 0e3A5DFFD5 | 47 | src/lanctl/core/plugins/scanners.py | 26 | LANCTL.Plugin.Scanner.Execution | diagnostic -0e3AA21C22 | 16 | src/lanctl/core/plugins/builtin.py | 232 | LANCTL.Plugins.Builtin.Theme | diagnostic +0e3AA21C22 | 16 | src/lanctl/core/plugins/builtin.py | 240 | LANCTL.Plugins.Builtin.Theme | diagnostic 0e3AA49C8C | 31 | src/lanctl/apps/ip/interfaces/cli/commands/switch.py | 293 | src.lanctl.apps.ip.interfaces.cli.commands.switch.run_switch | raise 0e3AC31598 | 18 | src/lanctl/core/database.py | 390 | src.lanctl.core.database.DeviceDatabase._audit_changes | diagnostic +0e3ACCAF69 | 42 | src/lanctl/core/network_interfaces.py | 73 | src.lanctl.core.network_interfaces.ipv4_interfaces | raise 0e3B06CEFA | 47 | src/lanctl/core/plugins/events.py | 50 | src.lanctl.core.plugins.events.EventRegistry.register | raise +0e3B08719F | 42 | src/lanctl/apps/access/gui_service.py | 122 | src.lanctl.apps.access.gui_service.AccessGuiService.open | raise +0e3B0F272A | 47 | src/lanctl/core/plugins/authorization.py | 24 | src.lanctl.core.plugins.authorization.RuntimeAuthorizations.begin | raise 0e3B206235 | 43 | src/lanctl/core/database.py | 545 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise -0e3B28D029 | 36 | src/lanctl/apps/access/manager_cli.py | 315 | src.lanctl.apps.access.manager_cli._main | raise +0e3B28D029 | 36 | src/lanctl/apps/access/manager_cli.py | 287 | src.lanctl.apps.access.manager_cli._main | raise 0e3B4CDA9A | 42 | src/lanctl/core/error_catalog.py | 42 | src.lanctl.core.error_catalog.load_error_catalog | raise -0e3B6025CF | 45 | src/lanctl/apps/monitor/commands.py | 149 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._start_monitor | raise +0e3B6025CF | 45 | src/lanctl/apps/monitor/commands.py | 155 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._start_monitor | raise 0e3B6EDB3F | 43 | src/lanctl/apps/monitor/database.py | 79 | src.lanctl.apps.monitor.database.MonitorDatabase._migrate | raise -0e3BD5067B | 47 | src/lanctl/core/plugins/manager.py | 545 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_extensions | raise +0e3BD43EDB | 32 | src/lanctl/apps/access/gui_service.py | 70 | src.lanctl.apps.access.gui_service.AccessGuiService.delete | raise +0e3BD5067B | 47 | src/lanctl/core/plugins/manager.py | 730 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_extensions | raise +0e3C1AA054 | 36 | src/lanctl/apps/rack/skins.py | 142 | src.lanctl.apps.rack.skins.validate_location | raise 0e3C616E52 | 45 | src/lanctl/apps/ip/interfaces/gui/main.py | 283 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.delete_device.operation | raise -0e3C8111A1 | 33 | src/lanctl/core/plugins/publishers.py | 60 | src.lanctl.core.plugins.publishers.TrustedPublisherStore._read | raise +0e3C8111A1 | 33 | src/lanctl/core/plugins/publishers.py | 65 | src.lanctl.core.plugins.publishers.TrustedPublisherStore._read | raise 0e3C9A0757 | 43 | src/lanctl/core/projects/workspace.py | 262 | src.lanctl.core.projects.workspace.activate_project_workspace | raise -0e3CAC7931 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 427 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e3CAC7931 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 449 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0e3CC2F3A7 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/credential.py | 76 | src.lanctl.apps.ip.interfaces.cli.commands.credential.run_credential | raise 0e3CF2A2DE | 33 | src/lanctl/apps/wire/path.py | 27 | src.lanctl.apps.wire.path.data_root | raise -0e3CF32CAE | 36 | src/lanctl/apps/wire/xfile.py | 153 | src.lanctl.apps.wire.xfile.read | raise -0e3D2AE2B4 | 33 | src/lanctl/core/config.py | 585 | src.lanctl.core.config.normalize_dhcp_range | raise -0e3D93DD43 | 41 | src/lanctl/core/session.py | 288 | src.lanctl.core.session.coordinated_launcher.decorate.wrapped | return-error +0e3CF32CAE | 36 | src/lanctl/apps/wire/xfile.py | 157 | src.lanctl.apps.wire.xfile.read | raise +0e3D2AE2B4 | 33 | src/lanctl/core/config.py | 604 | src.lanctl.core.config.normalize_dhcp_range | raise +0e3D2D6C07 | 41 | src/lanctl/core/gui_instance.py | 49 | src.lanctl.core.gui_instance.focus_gui | raise +0e3D93DD43 | 41 | src/lanctl/core/session.py | 332 | src.lanctl.core.session.coordinated_launcher.decorate.wrapped | return-error 0e3DB23E98 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py | 99 | src.lanctl.apps.ip.interfaces.cli.commands.ephemeral.run_ephemeral | raise 0e3E1B33CA | 47 | src/lanctl/apps/access/runtime.py | 100 | src.lanctl.apps.access.runtime.AccessRuntime._serve | diagnostic 0e3E341C52 | 43 | src/lanctl/core/database.py | 44 | src.lanctl.core.database.DeviceDatabase.load | raise -0e3EDFA5F3 | 45 | src/lanctl/core/plugins/api.py | 16 | src.lanctl.core.plugins.api.PluginApi.require | raise +0e3EAFB2A0 | 36 | src/lanctl/apps/suite/gui.py | 167 | src.lanctl.apps.suite.gui.SuiteApi.install_signed_plugin.operation | raise +0e3EDFA5F3 | 45 | src/lanctl/core/plugins/api.py | 28 | src.lanctl.core.plugins.api.PluginApi.require | raise +0e3EE4DACE | 47 | src/lanctl/core/plugins/publishers.py | 62 | src.lanctl.core.plugins.publishers.TrustedPublisherStore._read | raise 0e3EF0D53D | 48 | src/lanctl/core/tasking.py | 83 | src.lanctl.core.tasking.JsonStore.load | raise 0e3F0CBC66 | 36 | src/lanctl/apps/wire/cli/commands.py | 305 | src.lanctl.apps.wire.cli.commands.CommandProcessor._element_command | raise 0e3F61B6F6 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 35 | src.lanctl.core.plugins.isolated_runtime._receive_message | raise -0e3FC54047 | 48 | src/lanctl/apps/wire/idf/database.py | 375 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise +0e3F98B2A8 | 42 | src/lanctl/core/settings_catalog.py | 199 | src.lanctl.core.settings_catalog.validate_value | raise +0e3FC54047 | 48 | src/lanctl/apps/wire/idf/database.py | 394 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise +0e4016E1F2 | 34 | src/lanctl/apps/ip/interfaces/tui/main.py | 3026 | LANCTL.TUI.ProjectManager.Metadata | diagnostic 0e40529F91 | 36 | src/lanctl/apps/wire/topology.py | 51 | src.lanctl.apps.wire.topology.build_new_idf_data | raise 0e40C129C5 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 475 | src.lanctl.apps.ip.interfaces.cli.commands.wol._sequence_locked | raise 0e4115E23A | 46 | src/lanctl/core/file_transaction.py | 50 | src.lanctl.core.file_transaction.InterProcessLock.acquire | raise 0e4121699C | 18 | src/lanctl/core/projects/save_policy.py | 133 | LANCTL.Project.Autosave.Timer | diagnostic -0e41B62588 | 42 | src/lanctl/apps/access/manager_cli.py | 373 | LANCTL.Access.CLI.Command | diagnostic +0e4155CCEE | 48 | src/lanctl/apps/suite/gui.py | 143 | src.lanctl.apps.suite.gui.SuiteApi.trust_plugin_publisher.operation | raise +0e41B62588 | 42 | src/lanctl/apps/access/manager_cli.py | 349 | LANCTL.Access.CLI.Command | diagnostic 0e420745CF | 47 | src/lanctl/core/plugins/smb_runtime.py | 379 | src.lanctl.core.plugins.smb_runtime.SMBService.inspect | raise -0e423B7D34 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 723 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._apply_edit_history | raise +0e423B7D34 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 727 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._apply_edit_history | raise +0e4255A092 | 33 | src/lanctl/apps/wire/gui_service.py | 58 | src.lanctl.apps.wire.gui_service.WireGuiService._fields | raise +0e427F3BD6 | 36 | src/lanctl/apps/rack/skins.py | 117 | src.lanctl.apps.rack.skins.span | raise 0e429F9F7C | 36 | src/lanctl/apps/wire/cli/commands.py | 242 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise +0e4303CCF3 | 32 | src/lanctl/apps/suite/processes.py | 18 | src.lanctl.apps.suite.processes.launcher_command | raise 0e431F3002 | 33 | src/lanctl/apps/monitor/configuration.py | 231 | src.lanctl.apps.monitor.configuration.ProfileManager.delete.remove | raise -0e436CA306 | 43 | src/lanctl/core/config.py | 633 | src.lanctl.core.config._load_config | raise +0e434B79B6 | 36 | src/lanctl/apps/rack/skins.py | 100 | src.lanctl.apps.rack.skins.appearance | raise +0e436CA306 | 43 | src/lanctl/core/config.py | 652 | src.lanctl.core.config._load_config | raise 0e437EB181 | 42 | src/lanctl/apps/monitor/configuration.py | 147 | src.lanctl.apps.monitor.configuration.validate_profile | raise -0e4383CB47 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 398 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e4383CB47 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 420 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0e438D7B53 | 33 | src/lanctl/apps/ip/infrastructure/services/element_scanner.py | 161 | src.lanctl.apps.ip.infrastructure.services.element_scanner.parse_ports | raise 0e43DB118F | 47 | src/lanctl/core/plugins/device_adapters.py | 22 | LANCTL.Plugin.DeviceAdapter.Manufacturer | diagnostic 0e440654DD | 36 | src/lanctl/infrastructure/distribution/release.py | 46 | src.lanctl.infrastructure.distribution.release.artifact_name | raise 0e44D18CF9 | 47 | src/lanctl/core/plugins/theme.py | 65 | src.lanctl.core.plugins.theme.validate_theme_specification | raise 0e44E7A77F | 35 | src/lanctl/core/vault_crypto.py | 19 | src.lanctl.core.vault_crypto._key | raise -0e4554913C | 16 | src/lanctl/core/plugins/manager.py | 168 | LANCTL.Plugin.Discovery.Manifest | diagnostic +0e4554913C | 16 | src/lanctl/core/plugins/manager.py | 215 | LANCTL.Plugin.Discovery.Manifest | diagnostic 0e455A728B | 32 | src/lanctl/apps/ip/interfaces/cli/commands/ssh.py | 114 | src.lanctl.apps.ip.interfaces.cli.commands.ssh.run_ssh | raise -0e459333D3 | 33 | src/lanctl/apps/access/manager_cli.py | 437 | src.lanctl.apps.access.manager_cli._extended_command | raise +0e459333D3 | 33 | src/lanctl/apps/access/manager_cli.py | 413 | src.lanctl.apps.access.manager_cli._extended_command | raise 0e4594E997 | 33 | src/lanctl/apps/wire/idf/database.py | 37 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.__init__ | raise 0e45AF41FC | 43 | src/lanctl/apps/monitor/scheduler.py | 28 | src.lanctl.apps.monitor.scheduler.MonitorWorkerPool.__init__ | raise -0e45D44646 | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 2333 | LANCTL.TUI.Project.Save | diagnostic -0e45DF45D9 | 36 | src/lanctl/apps/access/https_server.py | 182 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise -0e4686167A | 36 | src/lanctl/apps/access/manager_cli.py | 352 | src.lanctl.apps.access.manager_cli._main | raise -0e46B46631 | 36 | src/lanctl/bootstrap/lanmon.py | 88 | src.lanctl.bootstrap.lanmon._main | raise -0e46B4A430 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 508 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise -0e46F49C4E | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 225 | src.lanctl.apps.wire.idf.sample_topology.migrate_legacy_links | raise +0e45B37919 | 43 | src/lanctl/apps/access/remote_setup.py | 158 | src.lanctl.apps.access.remote_setup.RemoteSetupApi._respond | diagnostic +0e45D44646 | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 2358 | LANCTL.TUI.Project.Save | diagnostic +0e45DF45D9 | 36 | src/lanctl/apps/access/https_server.py | 192 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise +0e461402C0 | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 266 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi._respond | return-error +0e463D1CF7 | 42 | src/lanctl/core/activity.py | 44 | src.lanctl.core.activity.ActivityStore.append | raise +0e4686167A | 36 | src/lanctl/apps/access/manager_cli.py | 328 | src.lanctl.apps.access.manager_cli._main | raise +0e46B46631 | 36 | src/lanctl/bootstrap/lanmon.py | 102 | src.lanctl.bootstrap.lanmon._main | raise +0e46B4A430 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 520 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise +0e46F49C4E | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 236 | src.lanctl.apps.wire.idf.sample_topology.migrate_legacy_links | raise 0e46FA77B0 | 36 | src/lanctl/apps/wire/topology.py | 196 | src.lanctl.apps.wire.topology.build_ports | raise 0e47071D43 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/open.py | 114 | src.lanctl.apps.ip.interfaces.cli.commands.open._automatic_protocol | raise +0e4709BC9E | 42 | src/lanctl/core/network_interfaces.py | 69 | src.lanctl.core.network_interfaces.ipv4_interfaces | raise +0e4846EDD5 | 33 | src/lanctl/core/settings_catalog.py | 132 | src.lanctl.core.settings_catalog.validate_value | raise 0e4891124C | 31 | src/lanctl/apps/ip/interfaces/cli/commands/smb.py | 92 | src.lanctl.apps.ip.interfaces.cli.commands.smb._grammar | raise 0e490FD41A | 45 | src/lanctl/core/local_permissions.py | 33 | src.lanctl.core.local_permissions.launch_elevated | raise -0e49181464 | 31 | src/lanctl/apps/wire/xfile.py | 163 | src.lanctl.apps.wire.xfile.write | raise -0e492302FC | 45 | src/lanctl/core/plugins/api.py | 133 | src.lanctl.core.plugins.api._PluginEvents.emit | raise +0e49181464 | 31 | src/lanctl/apps/wire/xfile.py | 167 | src.lanctl.apps.wire.xfile.write | raise +0e4920B1C2 | 47 | src/lanctl/core/plugins/selection.py | 28 | src.lanctl.core.plugins.selection.selected_plugins | raise +0e492302FC | 45 | src/lanctl/core/plugins/api.py | 160 | src.lanctl.core.plugins.api._PluginEvents.emit | raise 0e4965EAFC | 35 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 557 | src.lanctl.apps.ip.interfaces.cli.commands.wol._power_command | raise -0e498E6AC5 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 376 | src.lanctl.apps.ip.interfaces.cli.commands.access._setup_wizard | raise -0e4991F6A6 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 297 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise +0e498E6AC5 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 394 | src.lanctl.apps.ip.interfaces.cli.commands.access._setup_wizard | raise +0e4991F6A6 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 296 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise 0e49B52588 | 46 | src/lanctl/apps/access/remote.py | 173 | src.lanctl.apps.access.remote.LanctlCommandAdapter.execute | return-error -0e49D58D10 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 128 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._ordered_hosts | raise -0e49D65182 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 286 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise +0e49CD1825 | 47 | src/lanctl/core/plugins/manager.py | 307 | src.lanctl.core.plugins.manager.PluginManager.install | raise +0e49D58D10 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 165 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._ordered_hosts | raise +0e49D65182 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 285 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise 0e4A1AD3BE | 46 | src/lanctl/apps/ip/interfaces/cli/commands/lanwire.py | 66 | src.lanctl.apps.ip.interfaces.cli.commands.lanwire.lanwire_command | raise 0e4A5C110D | 43 | src/lanctl/core/projects/vlf.py | 67 | src.lanctl.core.projects.vlf.validate_project_id | raise 0e4A844243 | 35 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 316 | src.lanctl.apps.ip.infrastructure.protocols.ssh.open_colored_interactive | raise -0e4A84BE09 | 45 | src/lanctl/core/plugins/manager.py | 526 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_extensions | raise +0e4A84BE09 | 45 | src/lanctl/core/plugins/manager.py | 711 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_extensions | raise 0e4A874595 | 36 | src/lanctl/apps/ip/lab/provider.py | 20 | src.lanctl.apps.ip.lab.provider.LabDiscoveryProvider.discover | raise +0e4AA3D340 | 42 | src/lanctl/apps/suite/gui.py | 131 | src.lanctl.apps.suite.gui.SuiteApi.trust_plugin_publisher.operation | raise 0e4AD2A264 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/download_settings.py | 83 | src.lanctl.apps.ip.interfaces.cli.commands.download_settings.lan_settings | raise -0e4B284C3E | 32 | src/lanctl/apps/monitor/commands.py | 224 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._incident_action | raise -0e4B2A9C90 | 08 | src/lanctl/core/config.py | 618 | LANCTL.Config.Load.Defaults | diagnostic +0e4AED119E | 42 | src/lanctl/core/settings_catalog.py | 97 | src.lanctl.core.settings_catalog.validate_value | raise +0e4B284C3E | 32 | src/lanctl/apps/monitor/commands.py | 230 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._incident_action | raise +0e4B2A9C90 | 08 | src/lanctl/core/config.py | 637 | LANCTL.Config.Load.Defaults | diagnostic 0e4BC4B9B6 | 47 | src/lanctl/core/plugins/smb_runtime.py | 397 | src.lanctl.core.plugins.smb_runtime.SMBService.inspect | raise +0e4C2A61BA | 36 | src/lanctl/apps/suite/processes.py | 95 | src.lanctl.apps.suite.processes.EmbeddedCli.send | raise 0e4C5E703D | 36 | src/lanctl/apps/wire/tui/app.py | 1334 | src.lanctl.apps.wire.tui.app.LanwireTui._move_selected_connection | raise -0e4C7E0F85 | 33 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 360 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.save_settings.operation | raise -0e4CA685A3 | 47 | src/lanctl/core/plugins/manager.py | 659 | src.lanctl.core.plugins.manager.PluginManager._check_compatibility | raise +0e4C7E0F85 | 33 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 571 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.save_settings.operation | raise +0e4CA685A3 | 47 | src/lanctl/core/plugins/manager.py | 894 | src.lanctl.core.plugins.manager.PluginManager._check_compatibility | raise 0e4D177301 | 36 | src/lanctl/apps/ip/infrastructure/cisco/planner.py | 89 | src.lanctl.apps.ip.infrastructure.cisco.planner.CiscoPlanner.plan | raise -0e4D2E8C55 | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 3023 | LANCTL.TUI.ProjectManager.Delete | diagnostic +0e4D2E8C55 | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 3158 | LANCTL.TUI.ProjectManager.Delete | diagnostic 0e4D469B9F | 31 | src/lanctl/apps/ip/interfaces/cli/commands/element.py | 124 | src.lanctl.apps.ip.interfaces.cli.commands.element.run_element | raise 0e4D4C0AE9 | 36 | src/lanctl/infrastructure/distribution/release.py | 29 | src.lanctl.infrastructure.distribution.release.normalize_architecture | raise -0e4D71FFDE | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 274 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.open_device.operation | raise +0e4D71FFDE | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 442 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.open_device.operation | raise 0e4DBE5B0B | 42 | src/lanctl/apps/monitor/models.py | 65 | src.lanctl.apps.monitor.models.MonitorSession.__post_init__ | raise -0e4DCD7BF4 | 43 | src/lanctl/core/database.py | 564 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise 0e4DD0765F | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 725 | src.lanctl.apps.ip.interfaces.cli.commands.wol.run_wol | raise 0e4DF7FD84 | 42 | src/lanctl/core/tr064.py | 100 | src.lanctl.core.tr064.Tr064Client.service | raise 0e4DFAEA86 | 43 | src/lanctl/apps/monitor/database.py | 362 | src.lanctl.apps.monitor.database._normalize | raise 0e4E2C61EA | 42 | src/lanctl/core/recurrent_elements.py | 28 | src.lanctl.core.recurrent_elements.RecurrentElementDatabase.load | raise +0e4E4BCF76 | 42 | src/lanctl/core/settings_catalog.py | 130 | src.lanctl.core.settings_catalog.validate_value | raise +0e4E748425 | 43 | src/lanctl/core/plugins/authorization.py | 120 | src.lanctl.core.plugins.authorization.RuntimeAuthorizations.start_watch.watch | diagnostic 0e4E91AC21 | 33 | src/lanctl/apps/wire/error.py | 36 | src.lanctl.apps.wire.error.Error.__init__ | raise -0e4EA956B5 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 253 | src.lanctl.core.plugins.isolated_runtime._install_security_policy.violation | raise +0e4EA956B5 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 254 | src.lanctl.core.plugins.isolated_runtime._install_security_policy.violation | raise 0e4EAC3B3F | 36 | src/lanctl/apps/wire/log.py | 37 | src.lanctl.apps.wire.log.write_error | raise 0e4EE883BB | 33 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 168 | src.lanctl.apps.ip.interfaces.cli.commands.wol._options | raise -0e4F41DD21 | 33 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 276 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.open_device.operation | raise -0e4FBAB213 | 44 | src/lanctl/core/session.py | 282 | src.lanctl.core.session.coordinated_launcher.decorate.wrapped | diagnostic -0e4FDE31E6 | 42 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 165 | LANCTL.GUI.Desktop.Response | diagnostic +0e4F41DD21 | 33 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 444 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.open_device.operation | raise +0e4FBAB213 | 44 | src/lanctl/core/session.py | 326 | src.lanctl.core.session.coordinated_launcher.decorate.wrapped | diagnostic +0e4FDE31E6 | 42 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 259 | LANCTL.GUI.Desktop.Response | diagnostic +0e5016F5FC | 34 | src/lanctl/core/plugins/manager.py | 154 | src.lanctl.core.plugins.manager.PluginManager.discover | raise 0e50709BF6 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 227 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.update_device.operation | raise 0e509AC375 | 43 | src/lanctl/core/group_database.py | 49 | src.lanctl.core.group_database._decoded_snapshot | raise 0e50DE7510 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/smb.py | 223 | src.lanctl.apps.ip.interfaces.cli.commands.smb.run_smb | raise 0e50FC9093 | 43 | src/lanctl/core/history.py | 104 | src.lanctl.core.history.HistoryEvent.from_dict | raise -0e5131174B | 31 | src/lanctl/apps/ip/interfaces/tui/main.py | 3624 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise +0e5131174B | 31 | src/lanctl/apps/ip/interfaces/tui/main.py | 3759 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise 0e513617EA | 32 | src/lanctl/apps/ip/interfaces/cli/commands/history.py | 63 | src.lanctl.apps.ip.interfaces.cli.commands.history.run_history | raise -0e515509D8 | 33 | src/lanctl/core/config.py | 596 | src.lanctl.core.config.normalize_dhcp_range | raise -0e51DD51A9 | 41 | src/lanctl/apps/ip/interfaces/gui/main.py | 330 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.scan_network.operation | raise -0e521E15C7 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/list.py | 258 | src.lanctl.apps.ip.interfaces.cli.commands.list.run_list | raise -0e52233AA3 | 43 | src/lanctl/core/database.py | 663 | src.lanctl.core.database.DeviceDatabase.add_device | raise +0e515509D8 | 33 | src/lanctl/core/config.py | 615 | src.lanctl.core.config.normalize_dhcp_range | raise +0e5195DD4C | 42 | src/lanctl/core/clink_integration.py | 118 | src.lanctl.core.clink_integration.configure_clink | raise +0e51BBDD8A | 46 | src/lanctl/apps/access/remote_setup.py | 165 | src.lanctl.apps.access.remote_setup.RemoteSetupApi._respond | return-error +0e51FA37C5 | 33 | src/lanctl/core/updates.py | 156 | src.lanctl.core.updates.UpdateService.check | raise +0e521E15C7 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/list.py | 271 | src.lanctl.apps.ip.interfaces.cli.commands.list.run_list | raise +0e52233AA3 | 43 | src/lanctl/core/database.py | 659 | src.lanctl.core.database.DeviceDatabase.add_device | raise 0e523E3436 | 36 | src/lanctl/apps/wire/cli/commands.py | 240 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise +0e52C71BD2 | 36 | src/lanctl/apps/suite/launcher_gui.py | 109 | src.lanctl.apps.suite.launcher_gui.LauncherApi.rack_create.create | raise 0e52CB51A0 | 36 | src/lanctl/apps/wire/idf/database.py | 145 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.list_group | raise -0e52EA58F9 | 48 | src/lanctl/core/plugins/package.py | 105 | src.lanctl.core.plugins.package.build_package | raise -0e52F5110B | 46 | src/lanctl/core/plugins/isolated_runtime.py | 469 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise -0e53503CAC | 46 | src/lanctl/apps/monitor/commands.py | 597 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._restart_action | diagnostic +0e52EA58F9 | 48 | src/lanctl/core/plugins/package.py | 107 | src.lanctl.core.plugins.package.build_package | raise +0e52F5110B | 46 | src/lanctl/core/plugins/isolated_runtime.py | 481 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise +0e53503CAC | 46 | src/lanctl/apps/monitor/commands.py | 603 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._restart_action | diagnostic 0e537760AC | 45 | src/lanctl/apps/access/auth.py | 145 | src.lanctl.apps.access.auth.AuthenticationService._usable | raise +0e53B01099 | 42 | src/lanctl/core/network_interfaces.py | 108 | src.lanctl.core.network_interfaces.select_interface | raise 0e53BAAED7 | 31 | src/lanctl/apps/wire/cli/commands.py | 64 | src.lanctl.apps.wire.cli.commands.CommandProcessor.execute_parts | raise +0e53BDB438 | 36 | src/lanctl/apps/suite/gui_support.py | 207 | src.lanctl.apps.suite.gui_support.GuiSupportMixin._require_monitor_view | raise 0e5472E6CA | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ping.py | 96 | src.lanctl.apps.ip.interfaces.cli.commands.ping.run_ping | raise 0e5476F476 | 42 | src/lanctl/core/persistence.py | 202 | src.lanctl.core.persistence.migrate_schema | raise 0e548841F2 | 48 | src/lanctl/core/plugins/smb_runtime.py | 466 | src.lanctl.core.plugins.smb_runtime.SMBService.printer | raise +0e54A1ADCA | 42 | src/lanctl/core/network_interfaces.py | 115 | src.lanctl.core.network_interfaces.select_interface | raise 0e54A6D5B1 | 41 | src/lanctl/core/projects/save_policy.py | 354 | src.lanctl.core.projects.save_policy.save_active_project | raise +0e5509BD43 | 45 | src/lanctl/core/plugins/manager.py | 861 | src.lanctl.core.plugins.manager.PluginManager._validate_activation | raise 0e55303CB1 | 36 | src/lanctl/apps/wire/tui/app.py | 1329 | src.lanctl.apps.wire.tui.app.LanwireTui._move_selected_connection | raise -0e55449111 | 35 | src/lanctl/core/group_database.py | 327 | src.lanctl.core.group_database.GroupDatabase.remove | raise -0e55889B79 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 486 | src.lanctl.apps.ip.interfaces.cli.commands.access._role | raise +0e55449111 | 35 | src/lanctl/core/group_database.py | 329 | src.lanctl.core.group_database.GroupDatabase.remove | raise +0e55889B79 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 504 | src.lanctl.apps.ip.interfaces.cli.commands.access._role | raise 0e55CFC9A1 | 36 | src/lanctl/apps/ip/interfaces/tui/layout.py | 95 | src.lanctl.apps.ip.interfaces.tui.layout.normalize_cli_percent | raise -0e55ED69D6 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 513 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.wake_device.operation | raise +0e55E62D40 | 43 | src/lanctl/core/projects/metadata.py | 39 | src.lanctl.core.projects.metadata.validate_metadata | raise +0e55ED69D6 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 517 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.wake_device.operation | raise 0e55F668B7 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/element.py | 121 | src.lanctl.apps.ip.interfaces.cli.commands.element.run_element | raise +0e560E960B | 41 | src/lanctl/apps/suite/gui.py | 48 | src.lanctl.apps.suite.gui.SuiteApi._respond | return-error 0e564A1629 | 43 | src/lanctl/core/projects/workspace.py | 191 | src.lanctl.core.projects.workspace.prepare_project_workspace | raise +0e56823CC7 | 36 | src/lanctl/apps/suite/gui.py | 364 | src.lanctl.apps.suite.gui.SuiteApi.launch_gui.operation | raise 0e56A51239 | 42 | src/lanctl/core/error_catalog.py | 48 | src.lanctl.core.error_catalog.load_error_catalog | raise 0e57144098 | 33 | src/lanctl/core/coordination.py | 196 | src.lanctl.core.coordination.Coordinator.task | raise 0e575C1FAB | 37 | src/lanctl/apps/ip/infrastructure/services/element_scanner.py | 263 | src.lanctl.apps.ip.infrastructure.services.element_scanner.identify_device | raise -0e5777B73D | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 314 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e5777B73D | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 336 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0e57FAEF6E | 42 | src/lanctl/core/tr064.py | 150 | src.lanctl.core.tr064.Tr064Client.call | raise 0e580353F5 | 33 | src/lanctl/core/conditions.py | 14 | src.lanctl.core.conditions.duration | raise 0e58217701 | 46 | src/lanctl/core/persistence.py | 52 | src.lanctl.core.persistence.restore_backup | raise 0e58669832 | 45 | src/lanctl/apps/ip/interfaces/gui/main.py | 168 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.plugin_action.operation | raise 0e58825A80 | 33 | src/lanctl/core/plugins/wol_runtime.py | 37 | src.lanctl.core.plugins.wol_runtime.send_magic_packet | raise -0e597BB865 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 462 | src.lanctl.apps.ip.interfaces.cli.commands.access._setup_wizard | raise -0e59861963 | 36 | src/lanctl/apps/wire/idf/database.py | 379 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise +0e58E8F296 | 42 | src/lanctl/apps/monitor/gui_service.py | 105 | src.lanctl.apps.monitor.gui_service.MonitorGuiService.action | raise +0e59056FE1 | 42 | src/lanctl/core/updates.py | 26 | src.lanctl.core.updates.version_key | raise +0e597BB865 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 480 | src.lanctl.apps.ip.interfaces.cli.commands.access._setup_wizard | raise +0e59861963 | 36 | src/lanctl/apps/wire/idf/database.py | 398 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise +0e59ACDAFA | 42 | src/lanctl/core/official_links.py | 20 | src.lanctl.core.official_links.open_official_link | raise +0e59B0FEA4 | 42 | src/lanctl/core/activity.py | 77 | src.lanctl.core.activity.ActivityStore.query | raise 0e59CEC09A | 43 | src/lanctl/core/history.py | 240 | src.lanctl.core.history.HistoryService.__init__ | raise -0e59DA7164 | 43 | src/lanctl/core/projects/vlf.py | 708 | src.lanctl.core.projects.vlf._read_json_entry | raise +0e59DA7164 | 43 | src/lanctl/core/projects/vlf.py | 717 | src.lanctl.core.projects.vlf._read_json_entry | raise +0e5A107E90 | 36 | src/lanctl/apps/suite/gui_support.py | 331 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.export_report.export | raise 0e5A20FBA8 | 33 | src/lanctl/apps/wire/cli/commands.py | 351 | src.lanctl.apps.wire.cli.commands.CommandProcessor._add_options | raise 0e5A3BA3F3 | 14 | src/lanctl/apps/ip/infrastructure/services/manufacturer.py | 15 | src.lanctl.apps.ip.infrastructure.services.manufacturer._parser | diagnostic -0e5A64E778 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 441 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner.scan | raise -0e5A83A097 | 31 | src/lanctl/apps/ip/interfaces/tui/main.py | 3729 | src.lanctl.apps.ip.interfaces.tui.main._parse_list_filter | raise -0e5A8CF0B9 | 33 | src/lanctl/apps/ip/domain/models/device.py | 254 | src.lanctl.apps.ip.domain.models.device.Device.__post_init__ | raise -0e5AB9995C | 46 | src/lanctl/core/plugins/isolated_runtime.py | 468 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise +0e5A64E778 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 480 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner.scan | raise +0e5A83A097 | 31 | src/lanctl/apps/ip/interfaces/tui/main.py | 3864 | src.lanctl.apps.ip.interfaces.tui.main._parse_list_filter | raise +0e5AB9995C | 46 | src/lanctl/core/plugins/isolated_runtime.py | 480 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise 0e5AF970EE | 42 | src/lanctl/core/recurrent_elements.py | 45 | src.lanctl.core.recurrent_elements.RecurrentElementDatabase.load | raise -0e5B0D74F2 | 31 | src/lanctl/apps/access/manager_cli.py | 284 | LANCTL.Access.CLI.Input | diagnostic +0e5B0D74F2 | 31 | src/lanctl/apps/access/manager_cli.py | 252 | LANCTL.Access.CLI.Input | diagnostic 0e5B1AE5CC | 47 | src/lanctl/core/plugins/smb_runtime.py | 250 | src.lanctl.core.plugins.smb_runtime.SMBNative.connect_printer | raise 0e5B2DF8EF | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ssh.py | 52 | src.lanctl.apps.ip.interfaces.cli.commands.ssh.run_ssh | raise +0e5B39E3CD | 42 | src/lanctl/core/activity.py | 38 | src.lanctl.core.activity.ActivityStore.append | raise 0e5BE4239A | 33 | src/lanctl/apps/ip/interfaces/cli/commands/protocol.py | 51 | src.lanctl.apps.ip.interfaces.cli.commands.protocol.run_protocol | raise 0e5BE42E9B | 37 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 259 | src.lanctl.apps.ip.interfaces.cli.commands.wol._wake | diagnostic 0e5C775656 | 31 | src/lanctl/apps/wire/cli/commands.py | 170 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise +0e5C9F7549 | 41 | src/lanctl/apps/suite/gui.py | 393 | src.lanctl.apps.suite.gui.run_gui | raise 0e5CF5F80E | 31 | src/lanctl/apps/ip/interfaces/cli/commands/demo.py | 156 | src.lanctl.apps.ip.interfaces.cli.commands.demo.run_demo | raise -0e5D074BA4 | 45 | src/lanctl/core/plugins/manager.py | 605 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_events | raise +0e5D023E81 | 36 | src/lanctl/apps/suite/launcher_gui.py | 20 | src.lanctl.apps.suite.launcher_gui.LauncherApi.__init__ | raise +0e5D074BA4 | 45 | src/lanctl/core/plugins/manager.py | 790 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_events | raise +0e5D078A03 | 43 | src/lanctl/bootstrap/lanctl.py | 165 | src.lanctl.bootstrap.lanctl.main | diagnostic 0e5D0CC0A2 | 39 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 710 | src.lanctl.apps.ip.interfaces.cli.commands.wol.run_wol | raise 0e5D452762 | 47 | src/lanctl/core/plugins/theme.py | 62 | src.lanctl.core.plugins.theme.validate_theme_specification | raise 0e5D52AFC0 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/scan.py | 82 | src.lanctl.apps.ip.interfaces.cli.commands.scan.run_scan | raise 0e5D558C7E | 42 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 183 | src.lanctl.apps.ip.infrastructure.protocols.ssh.run_show_command | raise 0e5DC661FC | 36 | src/lanctl/apps/ip/__main__.py | 4 | src.lanctl.apps.ip.__main__ | raise -0e5DEAD535 | 36 | src/lanctl/apps/access/https_server.py | 186 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise +0e5DDBFCE0 | 49 | src/lanctl/core/gui_instance.py | 83 | src.lanctl.core.gui_instance.GuiInstance.__enter__ | raise +0e5DEAD535 | 36 | src/lanctl/apps/access/https_server.py | 196 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise 0e5E24626E | 33 | src/lanctl/core/plugins/models.py | 98 | src.lanctl.core.plugins.models.PluginManifest.from_dict | raise 0e5E3DF74A | 36 | src/lanctl/infrastructure/distribution/release.py | 11 | src.lanctl.infrastructure.distribution.release.validate_version | raise 0e5E97FC5D | 46 | src/lanctl/core/tr064.py | 60 | src.lanctl.core.tr064.Tr064Client._open | raise -0e5F08D38B | 47 | src/lanctl/core/plugins/isolated_runtime.py | 298 | src.lanctl.core.plugins.isolated_runtime._worker | raise +0e5F08D38B | 47 | src/lanctl/core/plugins/isolated_runtime.py | 301 | src.lanctl.core.plugins.isolated_runtime._worker | raise +0e5F288732 | 36 | src/lanctl/apps/wire/gui_service.py | 81 | src.lanctl.apps.wire.gui_service.WireGuiService._fields | raise 0e5F753B0F | 31 | src/lanctl/apps/ip/infrastructure/terminals/tr064.py | 22 | src.lanctl.apps.ip.infrastructure.terminals.tr064.parse_call | raise 0e5FC6C4C6 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/switch.py | 324 | src.lanctl.apps.ip.interfaces.cli.commands.switch.run_switch | raise 0e5FF59CA2 | 35 | src/lanctl/core/vault_crypto.py | 44 | src.lanctl.core.vault_crypto.decrypt | raise 0e60113FC6 | 43 | src/lanctl/core/history.py | 89 | src.lanctl.core.history.HistoryEvent.__post_init__ | raise -0e608902E4 | 33 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 348 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.save_settings.operation | raise +0e608902E4 | 33 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 559 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.save_settings.operation | raise 0e6092F72A | 31 | src/lanctl/apps/ip/interfaces/cli/commands/lab.py | 150 | src.lanctl.apps.ip.interfaces.cli.commands.lab.run_lab | raise 0e60A5FBE0 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/switch.py | 79 | src.lanctl.apps.ip.interfaces.cli.commands.switch._device_profile | raise 0e60AD02D2 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 54 | src.lanctl.core.plugins.isolated_runtime._receive_message | raise 0e60B99F43 | 43 | src/lanctl/core/plugins/functions.py | 45 | src.lanctl.core.plugins.functions.FunctionRegistry.call | diagnostic -0e60D13E7F | 43 | src/lanctl/core/group_database.py | 248 | src.lanctl.core.group_database.GroupDatabase.create | raise +0e60D13E7F | 43 | src/lanctl/core/group_database.py | 250 | src.lanctl.core.group_database.GroupDatabase.create | raise +0e61098D56 | 47 | src/lanctl/core/plugins/manager.py | 978 | src.lanctl.core.plugins.manager.PluginManager._save_registry | raise 0e613C04D1 | 45 | src/lanctl/apps/access/remote.py | 74 | src.lanctl.apps.access.remote.required_permission | raise 0e616E32FC | 34 | src/lanctl/core/interactive_console.py | 40 | LANCTL.Suite.Console.Render | diagnostic 0e6187A4FD | 36 | src/lanctl/apps/ip/interfaces/gui/theme.py | 50 | src.lanctl.apps.ip.interfaces.gui.theme.validate_theme_specification | raise -0e61B87B77 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 355 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e6198A5CF | 33 | src/lanctl/core/plugins/settings.py | 25 | src.lanctl.core.plugins.settings.PluginSettings.__init__ | raise +0e61B87B77 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 377 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0e61BF7CDB | 36 | src/lanctl/apps/access/root_control.py | 194 | src.lanctl.apps.access.root_control.forced_view | raise +0e62466176 | 43 | src/lanctl/apps/access/remote_setup.py | 32 | src.lanctl.apps.access.remote_setup._program_data | raise 0e624E8D5D | 31 | src/lanctl/apps/wire/cli/commands.py | 173 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise -0e6271F5B9 | 43 | src/lanctl/core/database.py | 659 | src.lanctl.core.database.DeviceDatabase.add_device | raise +0e62590828 | 33 | src/lanctl/core/updates.py | 58 | src.lanctl.core.updates._fetch_releases | raise +0e6271F5B9 | 43 | src/lanctl/core/database.py | 655 | src.lanctl.core.database.DeviceDatabase.add_device | raise 0e6283A1E7 | 36 | src/lanctl/apps/wire/idf/database.py | 212 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.delete_prefix.remove | raise 0e62EE5EBA | 35 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 233 | src.lanctl.apps.ip.interfaces.cli.commands.wol._wake | diagnostic 0e62F8D5EA | 31 | src/lanctl/apps/ip/interfaces/cli/commands/smb.py | 262 | src.lanctl.apps.ip.interfaces.cli.commands.smb.run_smb | raise @@ -439,61 +556,76 @@ 0e63452DC8 | 33 | src/lanctl/core/plugins/contracts.py | 89 | src.lanctl.core.plugins.contracts.construct_contract | raise 0e63702CA6 | 41 | src/lanctl/core/projects/save_policy.py | 293 | src.lanctl.core.projects.save_policy._verify_saved_workspace | raise 0e63841CC0 | 43 | src/lanctl/apps/monitor/database.py | 60 | src.lanctl.apps.monitor.database.MonitorDatabase.__init__ | raise -0e63DDF2DB | 41 | src/lanctl/apps/monitor/commands.py | 605 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._restart_action | return-error +0e63DDF2DB | 41 | src/lanctl/apps/monitor/commands.py | 611 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._restart_action | return-error 0e63DFF10B | 36 | src/lanctl/apps/ip/interfaces/gui/theme.py | 93 | src.lanctl.apps.ip.interfaces.gui.theme._validate_value | raise +0e640D6912 | 41 | src/lanctl/apps/suite/launcher_gui.py | 288 | src.lanctl.apps.suite.launcher_gui.run_gui | raise 0e641608BB | 33 | src/lanctl/shared/assets/icons.py | 270 | src.lanctl.shared.assets.icons._validate_id | raise 0e6419A83F | 33 | src/lanctl/core/plugins/theme.py | 47 | src.lanctl.core.plugins.theme.validate_theme_specification | raise 0e645F4B72 | 47 | src/lanctl/core/plugins/theme.py | 58 | src.lanctl.core.plugins.theme.validate_theme_specification | raise 0e6476E3E3 | 36 | src/lanctl/apps/wire/cli/commands.py | 228 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise 0e64840D1D | 46 | src/lanctl/apps/ip/interfaces/cli/commands/lanwire.py | 71 | src.lanctl.apps.ip.interfaces.cli.commands.lanwire.lanwire_command | raise +0e648CCC72 | 36 | src/lanctl/apps/wire/gui_service.py | 73 | src.lanctl.apps.wire.gui_service.WireGuiService._fields | raise +0e649B3FC3 | 42 | src/lanctl/core/updates.py | 114 | src.lanctl.core.updates.UpdateService._read | raise 0e64FB88EB | 45 | src/lanctl/core/plugins/events.py | 47 | src.lanctl.core.plugins.events.EventRegistry.register | raise 0e6509FDFF | 36 | src/lanctl/infrastructure/platform/linux.py | 19 | src.lanctl.infrastructure.platform.linux.LinuxPlatform.unit_text | raise 0e65CA69D8 | 36 | src/lanctl/apps/ip/interfaces/tui/layout.py | 126 | src.lanctl.apps.ip.interfaces.tui.layout.normalize_column_spec | raise -0e65FF5D24 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 211 | src.lanctl.apps.wire.idf.sample_topology.seed_sample_topology | raise +0e65FF5D24 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 222 | src.lanctl.apps.wire.idf.sample_topology.seed_sample_topology | raise 0e661AA7CB | 42 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 158 | src.lanctl.apps.ip.infrastructure.protocols.radmin.launch | raise 0e6684F6E4 | 36 | src/lanctl/apps/ip/infrastructure/cisco/executor.py | 27 | src.lanctl.apps.ip.infrastructure.cisco.executor.CiscoExecutor.execute | raise 0e669ACA12 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/smb.py | 237 | src.lanctl.apps.ip.interfaces.cli.commands.smb.run_smb | raise -0e66DEC4BF | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 229 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.create_project.operation | raise +0e66CCAE16 | 33 | src/lanctl/core/updates.py | 54 | src.lanctl.core.updates._fetch_releases | raise +0e66DEC4BF | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 376 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.create_project.operation | raise +0e67036A82 | 46 | src/lanctl/core/clink_integration.py | 137 | src.lanctl.core.clink_integration.configure_clink | raise 0e678ACF44 | 43 | src/lanctl/core/plugins/functions.py | 45 | LANCTL.Plugin.Function.Call | diagnostic -0e67DC23A5 | 48 | src/lanctl/core/plugins/package.py | 234 | src.lanctl.core.plugins.package.safe_package | raise -0e680AB220 | 36 | src/lanctl/apps/wire/idf/database.py | 277 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise +0e67D33758 | 42 | src/lanctl/core/updates.py | 96 | src.lanctl.core.updates.UpdateService._read | raise +0e67DC23A5 | 48 | src/lanctl/core/plugins/package.py | 282 | src.lanctl.core.plugins.package.safe_package | raise +0e680AB220 | 36 | src/lanctl/apps/wire/idf/database.py | 291 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise 0e680CC146 | 48 | src/lanctl/core/plugins/models.py | 79 | src.lanctl.core.plugins.models.PluginManifest.from_dict | raise 0e6876C77B | 42 | src/lanctl/apps/access/firewall.py | 82 | src.lanctl.apps.access.firewall.FirewallManager._command | raise 0e689FCD7C | 42 | src/lanctl/core/error_catalog.py | 52 | src.lanctl.core.error_catalog.load_error_catalog | raise 0e68E0EF61 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/terminal.py | 45 | src.lanctl.apps.ip.interfaces.cli.commands.terminal.choose_terminal | raise -0e68EBCB55 | 42 | src/lanctl/core/coordination.py | 241 | src.lanctl.core.coordination.Coordinator.enqueue | raise +0e68EBCB55 | 42 | src/lanctl/core/coordination.py | 240 | src.lanctl.core.coordination.Coordinator.enqueue | raise 0e6917D4D2 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/credential.py | 81 | src.lanctl.apps.ip.interfaces.cli.commands.credential.run_credential | raise 0e69286933 | 33 | src/lanctl/apps/monitor/configuration.py | 158 | src.lanctl.apps.monitor.configuration.validate_monitor_settings | raise -0e693A5ED2 | 42 | src/lanctl/bootstrap/lanmon.py | 122 | LANCTL.Monitor.CLI.Command | diagnostic +0e693A5ED2 | 42 | src/lanctl/bootstrap/lanmon.py | 136 | LANCTL.Monitor.CLI.Command | diagnostic 0e693B967C | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ssh.py | 100 | src.lanctl.apps.ip.interfaces.cli.commands.ssh.run_ssh | raise +0e6A0DE991 | 36 | src/lanctl/apps/access/remote_setup.py | 69 | src.lanctl.apps.access.remote_setup._installed_store_path | raise 0e6A2A50BC | 47 | src/lanctl/core/plugins/smb_runtime.py | 39 | src.lanctl.core.plugins.smb_runtime.unc_path | raise -0e6A3BEAFC | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 3598 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise +0e6A3BEAFC | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 3733 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise 0e6A873C1A | 36 | src/lanctl/apps/access/auth.py | 61 | src.lanctl.apps.access.auth.fingerprint_key | raise 0e6AFBD5D3 | 47 | src/lanctl/core/plugins/theme.py | 93 | src.lanctl.core.plugins.theme._validate_value | raise -0e6B1B3C6D | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 549 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.get_history.operation | raise +0e6B1B3C6D | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 553 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.get_history.operation | raise 0e6B7D104C | 41 | src/lanctl/core/projects/save_policy.py | 320 | src.lanctl.core.projects.save_policy._verify_saved_workspace | raise +0e6BDBA27F | 31 | src/lanctl/apps/wire/gui_service.py | 139 | src.lanctl.apps.wire.gui_service.WireGuiService.update | raise 0e6CBA6A77 | 43 | src/lanctl/core/database.py | 479 | src.lanctl.core.database.DeviceDatabase.set_value | raise 0e6CC3BC3D | 42 | src/lanctl/core/error_catalog.py | 54 | src.lanctl.core.error_catalog.load_error_catalog | raise 0e6CDF8C92 | 46 | src/lanctl/apps/monitor/lifecycle.py | 144 | src.lanctl.apps.monitor.lifecycle._windows_process_identity | raise -0e6D2E2048 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 510 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise +0e6D035BA9 | 45 | src/lanctl/core/plugins/authorization.py | 31 | src.lanctl.core.plugins.authorization.RuntimeAuthorizations.check | raise +0e6D2E2048 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 522 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise 0e6D39D26F | 42 | src/lanctl/core/tr064.py | 56 | src.lanctl.core.tr064.Tr064Client._open | raise +0e6D6F6A16 | 42 | src/lanctl/core/updates.py | 110 | src.lanctl.core.updates.UpdateService._read | raise +0e6D80FE01 | 33 | src/lanctl/core/activity.py | 79 | src.lanctl.core.activity.ActivityStore.query | raise 0e6D97C7F8 | 33 | src/lanctl/apps/ip/domain/models/group.py | 23 | src.lanctl.apps.ip.domain.models.group.Group.__post_init__ | raise 0e6E802936 | 46 | src/lanctl/apps/access/ssh_server.py | 179 | src.lanctl.apps.access.ssh_server.SshAccessServer.prepare | raise 0e6E81C002 | 34 | src/lanctl/core/credentials.py | 150 | src.lanctl.core.credentials.CredentialStore._load | raise 0e6EA37F60 | 47 | src/lanctl/core/plugins/scanners.py | 26 | src.lanctl.core.plugins.scanners.run_scanner_extensions | diagnostic -0e6EDE24AF | 43 | src/lanctl/core/database.py | 605 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise +0e6EDE24AF | 43 | src/lanctl/core/database.py | 603 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise 0e6EDF7437 | 33 | src/lanctl/shared/assets/icons.py | 212 | src.lanctl.shared.assets.icons.IconManager._read_registry | raise 0e6F0082A9 | 33 | src/lanctl/core/group_database.py | 110 | src.lanctl.core.group_database.GroupDatabase.load | raise 0e6F20EF37 | 42 | src/lanctl/core/persistence.py | 98 | src.lanctl.core.persistence.export_storage | raise 0e6FB56C38 | 33 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 62 | src.lanctl.apps.ip.infrastructure.protocols.ssh.SshProfile.from_options | raise +0e6FBC1CF1 | 42 | src/lanctl/core/diagnostics.py | 189 | src.lanctl.core.diagnostics._validated | raise 0e6FBF302A | 42 | src/lanctl/core/recurrent_elements.py | 40 | src.lanctl.core.recurrent_elements.RecurrentElementDatabase.load | raise -0e6FC1BF2E | 47 | src/lanctl/core/plugins/isolated_runtime.py | 411 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime._watch_runtime | raise +0e6FC1BF2E | 47 | src/lanctl/core/plugins/isolated_runtime.py | 416 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime._watch_runtime | raise +0e7020F157 | 36 | src/lanctl/apps/access/remote_setup.py | 80 | src.lanctl.apps.access.remote_setup._installed_store_path | raise 0e706A3E23 | 34 | src/lanctl/apps/access/auth.py | 106 | src.lanctl.apps.access.auth.AuthenticationService.add_user | raise 0e709D1702 | 18 | src/lanctl/apps/access/service.py | 200 | LANCTL.Access.Audit | diagnostic -0e711DF1A3 | 36 | src/lanctl/apps/wire/idf/database.py | 391 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise +0e70AC5E3F | 36 | src/lanctl/apps/rack/organization.py | 27 | src.lanctl.apps.rack.organization.organization | raise +0e711DF1A3 | 36 | src/lanctl/apps/wire/idf/database.py | 410 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise 0e71854926 | 47 | src/lanctl/core/plugins/declarative_commands.py | 55 | src.lanctl.core.plugins.declarative_commands._run | raise +0e71AB839E | 36 | src/lanctl/apps/rack/organization.py | 58 | src.lanctl.apps.rack.organization.mutate.change | raise 0e71B713A9 | 42 | src/lanctl/apps/monitor/checks.py | 18 | src.lanctl.apps.monitor.checks.CheckRegistry.register | raise -0e72126103 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 360 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e72126103 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 382 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0e722AA790 | 32 | src/lanctl/apps/monitor/database.py | 244 | src.lanctl.apps.monitor.database.SessionRepository.get | raise 0e7285EFE5 | 33 | src/lanctl/core/query.py | 35 | src.lanctl.core.query.matches_query | raise 0e7290EC8E | 42 | src/lanctl/apps/monitor/configuration.py | 28 | src.lanctl.apps.monitor.configuration.parse_duration | raise @@ -501,76 +633,98 @@ 0e72BFB335 | 31 | src/lanctl/apps/wire/topology.py | 216 | src.lanctl.apps.wire.topology.build_ports | raise 0e72D15949 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 180 | src.lanctl.core.plugins.isolated_runtime._windows_memory_job | raise 0e72D4FC3B | 47 | src/lanctl/core/plugins/declarative_commands.py | 26 | src.lanctl.core.plugins.declarative_commands.register_declarative_commands | raise +0e7335426C | 46 | src/lanctl/core/gui_instance.py | 51 | src.lanctl.core.gui_instance.focus_gui | raise 0e733C475F | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ssh.py | 56 | src.lanctl.apps.ip.interfaces.cli.commands.ssh.run_ssh | raise +0e733F02B6 | 45 | src/lanctl/core/plugins/manager.py | 856 | src.lanctl.core.plugins.manager.PluginManager._validate_activation | raise 0e7341739D | 31 | src/lanctl/apps/ip/infrastructure/cisco/planner.py | 81 | src.lanctl.apps.ip.infrastructure.cisco.planner.CiscoPlanner.plan | raise -0e74035FAF | 06 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 286 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._retry_icmp | diagnostic -0e74A0CC95 | 43 | src/lanctl/core/group_database.py | 344 | src.lanctl.core.group_database.GroupDatabase.delete_device | raise +0e7379475F | 42 | src/lanctl/core/network_interfaces.py | 23 | src.lanctl.core.network_interfaces._read | raise +0e739CC9BF | 33 | src/lanctl/core/rack_dimensions.py | 11 | src.lanctl.core.rack_dimensions.validate_height | raise +0e74035FAF | 06 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 323 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._retry_icmp | diagnostic +0e74A0CC95 | 43 | src/lanctl/core/group_database.py | 346 | src.lanctl.core.group_database.GroupDatabase.delete_device | raise 0e74A20A3A | 33 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 527 | src.lanctl.apps.ip.interfaces.cli.commands.wol._configure_power | raise 0e74CF80B0 | 42 | src/lanctl/apps/monitor/checks.py | 32 | src.lanctl.apps.monitor.checks.CheckRegistry.get | raise -0e74E5B9EE | 33 | src/lanctl/core/config.py | 594 | src.lanctl.core.config.normalize_dhcp_range | raise +0e74E5B9EE | 33 | src/lanctl/core/config.py | 613 | src.lanctl.core.config.normalize_dhcp_range | raise 0e750D874F | 46 | src/lanctl/apps/monitor/lifecycle.py | 127 | src.lanctl.apps.monitor.lifecycle._windows_process_identity | raise 0e758F6422 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 164 | src.lanctl.apps.ip.interfaces.cli.commands.wol._options | raise 0e7593284F | 43 | src/lanctl/core/credentials.py | 71 | src.lanctl.core.credentials.protect_secret | raise -0e75A03131 | 42 | src/lanctl/core/plugins/api.py | 94 | src.lanctl.core.plugins.api._PluginErrors.emit | diagnostic -0e75ADF44F | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 3023 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._delete_project_from_manager | diagnostic -0e75DC7108 | 24 | src/lanctl/apps/ip/interfaces/tui/main.py | 870 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui.show_project_manager | diagnostic +0e75A03131 | 42 | src/lanctl/core/plugins/api.py | 116 | src.lanctl.core.plugins.api._PluginErrors.emit | diagnostic +0e75ADF44F | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 3158 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._delete_project_from_manager | diagnostic +0e75DC7108 | 24 | src/lanctl/apps/ip/interfaces/tui/main.py | 874 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui.show_project_manager | diagnostic 0e7654067B | 47 | src/lanctl/core/plugins/functions.py | 60 | src.lanctl.core.plugins.functions.FunctionRegistry.owner | raise -0e76658D5B | 45 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 408 | src.lanctl.apps.ip.interfaces.cli.commands.access._setup_wizard | raise -0e76BB6FA0 | 47 | src/lanctl/core/plugins/api.py | 325 | src.lanctl.core.plugins.api._PluginMonitor.write_metric | raise -0e76E5A551 | 39 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 217 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._parallel_discovery | raise +0e76658D5B | 45 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 426 | src.lanctl.apps.ip.interfaces.cli.commands.access._setup_wizard | raise +0e76A5CCD6 | 36 | src/lanctl/apps/wire/gui_service.py | 66 | src.lanctl.apps.wire.gui_service.WireGuiService._fields | raise +0e76BB6FA0 | 47 | src/lanctl/core/plugins/api.py | 359 | src.lanctl.core.plugins.api._PluginMonitor.write_metric | raise +0e76E5A551 | 39 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 254 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._parallel_discovery | raise 0e76EC9EB6 | 36 | src/lanctl/shared/i18n.py | 199 | src.lanctl.shared.i18n.LanguageManager.load_file | raise 0e7710ADEA | 32 | src/lanctl/apps/ip/interfaces/gui/main.py | 159 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.plugin_action.operation | raise 0e7711D41A | 36 | src/lanctl/apps/access/remote.py | 204 | src.lanctl.apps.access.remote.LanctlCommandAdapter._root | raise -0e7721E670 | 47 | src/lanctl/core/plugins/manager.py | 572 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_extensions | raise +0e7721E670 | 47 | src/lanctl/core/plugins/manager.py | 757 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_extensions | raise 0e772CABA9 | 36 | src/lanctl/apps/wire/tui/app.py | 1288 | src.lanctl.apps.wire.tui.app.LanwireTui._execute_wire_side_action | raise 0e772CC88B | 45 | src/lanctl/apps/access/remote.py | 259 | src.lanctl.apps.access.remote.RemoteGuiApi.call | raise 0e77614BCF | 32 | src/lanctl/apps/monitor/incidents.py | 64 | src.lanctl.apps.monitor.incidents.IncidentManager._set | raise 0e77CC636D | 47 | src/lanctl/core/plugins/theme.py | 53 | src.lanctl.core.plugins.theme.validate_theme_specification | raise 0e783EB1B1 | 21 | src/lanctl/apps/access/audit.py | 9 | LANCTL.Access.Vault.Operation | diagnostic 0e78A77B3F | 31 | src/lanctl/apps/wire/cli/commands.py | 196 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise -0e79966074 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 485 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise +0e790D7249 | 36 | src/lanctl/bootstrap/lanmon.py | 77 | src.lanctl.bootstrap.lanmon._main | raise +0e7955C702 | 47 | src/lanctl/core/plugins/manager.py | 926 | src.lanctl.core.plugins.manager.PluginManager._read_registry | raise +0e79966074 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 497 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise 0e799949FA | 43 | src/lanctl/core/credentials.py | 206 | src.lanctl.core.credentials.CredentialStore.get | raise 0e7999776C | 31 | src/lanctl/apps/ip/interfaces/cli/commands/error.py | 23 | src.lanctl.apps.ip.interfaces.cli.commands.error.run_error | raise -0e79BDA8E3 | 47 | src/lanctl/core/plugins/api.py | 214 | src.lanctl.core.plugins.api._PluginCredentials.get_for_device | raise +0e79BDA8E3 | 47 | src/lanctl/core/plugins/api.py | 244 | src.lanctl.core.plugins.api._PluginCredentials.get_for_device | raise 0e79CEDE56 | 33 | src/lanctl/apps/wire/error.py | 38 | src.lanctl.apps.wire.error.Error.__init__ | raise 0e7A0945B3 | 43 | src/lanctl/core/credentials.py | 159 | src.lanctl.core.credentials.CredentialStore._load | raise 0e7A143685 | 43 | src/lanctl/core/group_database.py | 212 | src.lanctl.core.group_database.GroupDatabase._find | raise -0e7A600492 | 42 | src/lanctl/apps/access/manager_cli.py | 373 | src.lanctl.apps.access.manager_cli.main | diagnostic -0e7A6CF283 | 43 | src/lanctl/core/projects/vlf.py | 653 | src.lanctl.core.projects.vlf._verify_sqlite | raise +0e7A1982B7 | 45 | src/lanctl/core/plugins/manager.py | 848 | src.lanctl.core.plugins.manager.PluginManager._validate_activation | raise +0e7A600492 | 42 | src/lanctl/apps/access/manager_cli.py | 349 | src.lanctl.apps.access.manager_cli.main | diagnostic +0e7A6665FF | 33 | src/lanctl/core/updates.py | 136 | src.lanctl.core.updates.UpdateService.check | raise +0e7A6CF283 | 43 | src/lanctl/core/projects/vlf.py | 662 | src.lanctl.core.projects.vlf._verify_sqlite | raise +0e7AA39EEF | 34 | src/lanctl/apps/access/gui_service.py | 63 | src.lanctl.apps.access.gui_service.AccessGuiService.set | raise 0e7AF1876A | 46 | src/lanctl/core/projects/workspace.py | 79 | src.lanctl.core.projects.workspace.mark_workspace_synchronized | raise -0e7B0BD88A | 36 | src/lanctl/apps/ip/interfaces/cli/main.py | 198 | src.lanctl.apps.ip.interfaces.cli.main.main | raise -0e7BE916E1 | 45 | src/lanctl/apps/ip/interfaces/gui/main.py | 576 | LANCTL.GUI.RPC.Response | diagnostic -0e7C5BFF54 | 33 | src/lanctl/apps/ip/domain/models/device.py | 310 | src.lanctl.apps.ip.domain.models.device.Device.__delitem__ | raise +0e7B0BD88A | 36 | src/lanctl/apps/ip/interfaces/cli/main.py | 203 | src.lanctl.apps.ip.interfaces.cli.main.main | raise +0e7BC8FEFB | 33 | src/lanctl/core/plugins/manager.py | 911 | src.lanctl.core.plugins.manager.PluginManager._read_registry | raise +0e7BDCB84A | 36 | src/lanctl/apps/suite/gui_support.py | 259 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.prepare_report.prepare | raise +0e7BE916E1 | 45 | src/lanctl/apps/ip/interfaces/gui/main.py | 580 | LANCTL.GUI.RPC.Response | diagnostic +0e7C5BFF54 | 33 | src/lanctl/apps/ip/domain/models/device.py | 306 | src.lanctl.apps.ip.domain.models.device.Device.__delitem__ | raise 0e7CD1CE98 | 33 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 115 | src.lanctl.apps.ip.infrastructure.protocols.radmin.build_arguments | raise 0e7CD9B070 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/element.py | 171 | src.lanctl.apps.ip.interfaces.cli.commands.element.run_element | raise 0e7CDCAE97 | 33 | src/lanctl/shared/assets/icons.py | 203 | src.lanctl.shared.assets.icons.IconManager._add | raise +0e7CFCD8A1 | 42 | src/lanctl/apps/monitor/gui_service.py | 97 | src.lanctl.apps.monitor.gui_service.MonitorGuiService.action | raise 0e7D373DC8 | 36 | src/lanctl/apps/wire/topology.py | 207 | src.lanctl.apps.wire.topology.build_ports | raise 0e7D74DA38 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/scan.py | 84 | src.lanctl.apps.ip.interfaces.cli.commands.scan.run_scan | raise -0e7DA17A99 | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 178 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.scan_network | return-error +0e7D7C1BEE | 34 | src/lanctl/apps/suite/gui_support.py | 156 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.record_activity.append | diagnostic +0e7DA17A99 | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 277 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.scan_network | return-error 0e7DC8E2A5 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 231 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.update_device.operation | raise 0e7E0C3080 | 47 | src/lanctl/core/plugins/functions.py | 28 | src.lanctl.core.plugins.functions.FunctionRegistry.register | raise 0e7E5B27C8 | 33 | src/lanctl/apps/access/network.py | 16 | src.lanctl.apps.access.network.validate_endpoint | raise -0e7E751B48 | 43 | src/lanctl/core/config.py | 442 | src.lanctl.core.config._path_get | raise +0e7E751B48 | 43 | src/lanctl/core/config.py | 458 | src.lanctl.core.config._path_get | raise 0e7EC7C1FC | 31 | src/lanctl/apps/ip/infrastructure/terminals/tr064.py | 32 | src.lanctl.apps.ip.infrastructure.terminals.tr064.parse_call | raise 0e7EC8008B | 42 | src/lanctl/apps/monitor/configuration.py | 64 | src.lanctl.apps.monitor.configuration.MonitorConfig.__post_init__ | raise +0e7EE29447 | 36 | src/lanctl/apps/suite/gui.py | 335 | src.lanctl.apps.suite.gui.SuiteApi.set_plugin_enabled.operation | raise 0e7F8CE483 | 36 | src/lanctl/apps/wire/topology.py | 243 | src.lanctl.apps.wire.topology.resize_port_pattern | raise +0e7FA3E538 | 41 | src/lanctl/apps/suite/processes.py | 51 | src.lanctl.apps.suite.processes.open_system_cli | raise 0e8004521F | 42 | src/lanctl/core/persistence.py | 148 | src.lanctl.core.persistence.import_storage | raise 0e805BFB83 | 34 | src/lanctl/core/interactive_console.py | 40 | src.lanctl.core.interactive_console.command_console | diagnostic 0e809214C3 | 47 | src/lanctl/core/plugins/functions.py | 54 | src.lanctl.core.plugins.functions.FunctionRegistry.call | raise -0e80D69A87 | 43 | src/lanctl/core/config.py | 592 | src.lanctl.core.config.normalize_dhcp_range | raise -0e80F3F25E | 18 | src/lanctl/core/plugins/manager.py | 200 | src.lanctl.core.plugins.manager.PluginManager.activate_enabled | diagnostic +0e8097A323 | 35 | src/lanctl/apps/access/gui_service.py | 45 | src.lanctl.apps.access.gui_service.AccessGuiService.unlock | raise +0e809D46CE | 36 | src/lanctl/apps/wire/gui_service.py | 44 | src.lanctl.apps.wire.gui_service.WireGuiService._record | raise +0e80D69A87 | 43 | src/lanctl/core/config.py | 611 | src.lanctl.core.config.normalize_dhcp_range | raise +0e80F3F25E | 18 | src/lanctl/core/plugins/manager.py | 271 | src.lanctl.core.plugins.manager.PluginManager.activate_enabled | diagnostic +0e81145D34 | 32 | src/lanctl/apps/wire/gui_service.py | 175 | src.lanctl.apps.wire.gui_service.WireGuiService.update | raise +0e81379C8D | 32 | src/lanctl/apps/rack/organization.py | 79 | src.lanctl.apps.rack.organization.mutate.change | raise 0e8148A8CC | 42 | src/lanctl/apps/access/ssh_server.py | 235 | LANCTL.Access.SSH.Command | diagnostic 0e814F2E3D | 46 | src/lanctl/bootstrap/commands.py | 22 | src.lanctl.bootstrap.commands.ip_command | raise +0e81D2C6F4 | 47 | src/lanctl/core/plugins/settings.py | 135 | src.lanctl.core.plugins.settings.PluginSettings.save | raise 0e81E2F6B8 | 33 | src/lanctl/apps/wire/topology.py | 189 | src.lanctl.apps.wire.topology.build_ports | raise +0e81FD0DDC | 33 | src/lanctl/core/plugins/settings.py | 77 | src.lanctl.core.plugins.settings.PluginSettings.fields | raise 0e8229AA55 | 48 | src/lanctl/core/plugins/ui_contracts.py | 33 | src.lanctl.core.plugins.ui_contracts.validate_ui_panel | raise 0e8245A67A | 43 | src/lanctl/core/projects/save_policy.py | 337 | src.lanctl.core.projects.save_policy.save_active_project | raise 0e82B68637 | 36 | src/lanctl/apps/wire/tui/editor.py | 395 | src.lanctl.apps.wire.tui.editor.set_field | raise -0e82D4E75C | 33 | src/lanctl/apps/ip/interfaces/cli/commands/list.py | 256 | src.lanctl.apps.ip.interfaces.cli.commands.list.run_list | raise +0e82D4E75C | 33 | src/lanctl/apps/ip/interfaces/cli/commands/list.py | 269 | src.lanctl.apps.ip.interfaces.cli.commands.list.run_list | raise 0e830B5131 | 45 | src/lanctl/apps/access/remote.py | 110 | src.lanctl.apps.access.remote.parse_remote_command | raise -0e83238E87 | 33 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 122 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._ordered_hosts | raise -0e8323C5FC | 46 | src/lanctl/apps/ip/interfaces/tui/main.py | 3319 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui.run | raise +0e83238E87 | 33 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 159 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._ordered_hosts | raise +0e8323C5FC | 46 | src/lanctl/apps/ip/interfaces/tui/main.py | 3454 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui.run | raise 0e8359F2FE | 34 | src/lanctl/core/interactive_console.py | 107 | src.lanctl.core.interactive_console.command_console | print-error -0e8389B96E | 42 | src/lanctl/apps/monitor/commands.py | 675 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._run_monitor_action | raise +0e8389B96E | 42 | src/lanctl/apps/monitor/commands.py | 681 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._run_monitor_action | raise 0e83D02A56 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/project.py | 195 | src.lanctl.apps.ip.interfaces.cli.commands.project._save | raise 0e84620347 | 31 | src/lanctl/apps/wire/cli/commands.py | 163 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise 0e84668650 | 44 | src/lanctl/apps/access/auth.py | 194 | src.lanctl.apps.access.auth.AuthenticationService.authenticate_ssh_key | raise @@ -579,92 +733,116 @@ 0e84DE4F42 | 48 | src/lanctl/core/plugins/ui_contracts.py | 58 | src.lanctl.core.plugins.ui_contracts.validate_form_schema | raise 0e84EC3E56 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/credential.py | 87 | src.lanctl.apps.ip.interfaces.cli.commands.credential.run_credential | raise 0e84ECA26B | 31 | src/lanctl/apps/ip/interfaces/cli/commands/group.py | 58 | src.lanctl.apps.ip.interfaces.cli.commands.group.run_group | raise -0e8530D2D7 | 41 | src/lanctl/apps/ip/interfaces/cli/main.py | 306 | src.lanctl.apps.ip.interfaces.cli.main.main | return-error +0e851E2CFD | 47 | src/lanctl/core/plugins/selection.py | 35 | src.lanctl.core.plugins.selection.selected_plugins | raise +0e8530D2D7 | 41 | src/lanctl/apps/ip/interfaces/cli/main.py | 317 | src.lanctl.apps.ip.interfaces.cli.main.main | return-error 0e853A703D | 35 | src/lanctl/core/tasking.py | 85 | src.lanctl.core.tasking.JsonStore.load | raise -0e8578939D | 42 | src/lanctl/core/plugin_storage.py | 40 | src.lanctl.core.plugin_storage.PluginStorage.put_observations | raise +0e8578939D | 42 | src/lanctl/core/plugin_storage.py | 43 | src.lanctl.core.plugin_storage.PluginStorage.put_observations | raise +0e859651DB | 33 | src/lanctl/core/plugins/settings.py | 79 | src.lanctl.core.plugins.settings.PluginSettings.fields | raise +0e859788D2 | 47 | src/lanctl/core/plugins/manager.py | 834 | src.lanctl.core.plugins.manager.PluginManager._verify_installed | raise 0e86055A13 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/scan.py | 105 | src.lanctl.apps.ip.interfaces.cli.commands.scan.run_scan | raise -0e866529E9 | 36 | src/lanctl/apps/rack/service.py | 23 | src.lanctl.apps.rack.service.RackService.get | raise +0e866529E9 | 36 | src/lanctl/apps/rack/service.py | 65 | src.lanctl.apps.rack.service.RackService.get | raise 0e866DB4C7 | 42 | src/lanctl/core/data_migration.py | 98 | src.lanctl.core.data_migration.ensure_data_layout | raise 0e8711F423 | 42 | src/lanctl/apps/access/ssh_server.py | 167 | src.lanctl.apps.access.ssh_server.SshAccessServer.prepare | raise 0e8728E0EC | 31 | src/lanctl/apps/ip/interfaces/cli/commands/open.py | 176 | src.lanctl.apps.ip.interfaces.cli.commands.open.run_open | raise +0e872C0391 | 33 | src/lanctl/core/gui_preferences.py | 33 | src.lanctl.core.gui_preferences.validate_preferences | raise 0e873096F6 | 36 | src/lanctl/apps/ip/interfaces/tui/layout.py | 82 | src.lanctl.apps.ip.interfaces.tui.layout.normalize_panel_layout | raise -0e8777DDE8 | 43 | src/lanctl/core/projects/vlf.py | 720 | src.lanctl.core.projects.vlf._existing_vlf | raise -0e87957B71 | 06 | src/lanctl/core/plugins/manager.py | 184 | LANCTL.Plugin.Activation.State | diagnostic -0e87C4262D | 47 | src/lanctl/core/plugins/isolated_runtime.py | 474 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise -0e87C93ECF | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 103 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.update_device.operation | raise -0e87F154B3 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 277 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise +0e875B39B0 | 43 | src/lanctl/bootstrap/lanctl.py | 165 | LANCTL.Suite.Install.Configure | diagnostic +0e8777DDE8 | 43 | src/lanctl/core/projects/vlf.py | 729 | src.lanctl.core.projects.vlf._existing_vlf | raise +0e87957B71 | 06 | src/lanctl/core/plugins/manager.py | 239 | LANCTL.Plugin.Activation.State | diagnostic +0e87A4C6A4 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py | 50 | src.lanctl.apps.ip.interfaces.cli.commands.settings_menu._project | raise +0e87C4262D | 47 | src/lanctl/core/plugins/isolated_runtime.py | 486 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise +0e87C93ECF | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 166 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.update_device.operation | raise +0e87F154B3 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 276 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise 0e87FC3193 | 18 | src/lanctl/core/database.py | 390 | LANCTL.Database.History | diagnostic 0e880A2669 | 42 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 102 | src.lanctl.apps.ip.infrastructure.protocols.radmin.build_arguments | raise 0e88B5B6A4 | 42 | src/lanctl/apps/monitor/configuration.py | 145 | src.lanctl.apps.monitor.configuration.validate_profile | raise -0e88C60671 | 33 | src/lanctl/apps/monitor/log_stream.py | 79 | src.lanctl.apps.monitor.log_stream.follow_logs | raise +0e88C60671 | 33 | src/lanctl/apps/monitor/log_stream.py | 93 | src.lanctl.apps.monitor.log_stream.follow_logs | raise 0e88C71705 | 43 | src/lanctl/core/credentials.py | 175 | src.lanctl.core.credentials.CredentialStore._load | raise 0e88D27FD4 | 33 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 68 | src.lanctl.apps.ip.infrastructure.protocols.radmin.find_viewer | raise -0e8991BCE9 | 43 | src/lanctl/core/group_database.py | 278 | src.lanctl.core.group_database.GroupDatabase.rename | raise -0e8A2BBE6F | 41 | src/lanctl/bootstrap/lanctl.py | 104 | src.lanctl.bootstrap.lanctl.main | return-error +0e8910F143 | 33 | src/lanctl/apps/rack/skins.py | 103 | src.lanctl.apps.rack.skins.appearance | raise +0e89592C04 | 33 | src/lanctl/core/projects/vlf.py | 149 | src.lanctl.core.projects.vlf.create_project | raise +0e8991BCE9 | 43 | src/lanctl/core/group_database.py | 280 | src.lanctl.core.group_database.GroupDatabase.rename | raise +0e899F0970 | 42 | src/lanctl/apps/monitor/gui_service.py | 88 | src.lanctl.apps.monitor.gui_service.MonitorGuiService.incident | raise +0e89AF8803 | 33 | src/lanctl/apps/monitor/log_stream.py | 21 | src.lanctl.apps.monitor.log_stream.LogFollower.__init__ | raise +0e89E56CE9 | 33 | src/lanctl/core/settings_catalog.py | 140 | src.lanctl.core.settings_catalog.validate_value | raise +0e89F84452 | 36 | src/lanctl/apps/wire/gui_service.py | 179 | src.lanctl.apps.wire.gui_service.WireGuiService.update | raise +0e8A0552BE | 35 | src/lanctl/apps/access/remote_setup.py | 78 | src.lanctl.apps.access.remote_setup._installed_store_path | raise +0e8A2BBE6F | 41 | src/lanctl/bootstrap/lanctl.py | 137 | src.lanctl.bootstrap.lanctl.main | return-error 0e8A3CFB19 | 19 | src/lanctl/apps/access/runtime.py | 139 | src.lanctl.apps.access.runtime.AccessRuntime.reconcile | diagnostic -0e8A6FB8AC | 45 | src/lanctl/apps/monitor/commands.py | 181 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._monitor_once | raise +0e8A574974 | 36 | src/lanctl/apps/suite/gui_support.py | 120 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.record_activity.append | raise +0e8A6FB8AC | 45 | src/lanctl/apps/monitor/commands.py | 187 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._monitor_once | raise 0e8ADA50E3 | 33 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 32 | src.lanctl.apps.ip.infrastructure.protocols.radmin.validate_port | raise 0e8B0FEF0E | 31 | src/lanctl/apps/ip/interfaces/cli/commands/project.py | 120 | src.lanctl.apps.ip.interfaces.cli.commands.project._create | raise 0e8B17049D | 45 | src/lanctl/core/plugins/events.py | 63 | src.lanctl.core.plugins.events.EventRegistry.remove_owner | raise -0e8B342821 | 49 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 237 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._parallel_discovery | raise -0e8B4A8D3B | 08 | src/lanctl/core/config.py | 618 | src.lanctl.core.config._load_config | diagnostic +0e8B342821 | 49 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 274 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._parallel_discovery | raise +0e8B4A8D3B | 08 | src/lanctl/core/config.py | 637 | src.lanctl.core.config._load_config | diagnostic 0e8B55B2FD | 33 | src/lanctl/shared/assets/icons.py | 238 | src.lanctl.shared.assets.icons.jpeg_dimensions | raise -0e8B5643D1 | 48 | src/lanctl/apps/wire/xfile.py | 176 | src.lanctl.apps.wire.xfile.update_json | raise +0e8B5643D1 | 48 | src/lanctl/apps/wire/xfile.py | 180 | src.lanctl.apps.wire.xfile.update_json | raise 0e8BA69C93 | 35 | src/lanctl/core/plugins/wol_runtime.py | 14 | src.lanctl.core.plugins.wol_runtime.validate_mac | raise -0e8BE835BB | 45 | src/lanctl/apps/ip/interfaces/gui/main.py | 576 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._respond | diagnostic -0e8C1D0BB9 | 47 | src/lanctl/core/plugins/publishers.py | 63 | src.lanctl.core.plugins.publishers.TrustedPublisherStore._read | raise +0e8BE835BB | 45 | src/lanctl/apps/ip/interfaces/gui/main.py | 580 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._respond | diagnostic +0e8C1D0BB9 | 47 | src/lanctl/core/plugins/publishers.py | 77 | src.lanctl.core.plugins.publishers.TrustedPublisherStore._read | raise +0e8C37325E | 42 | src/lanctl/core/first_scan.py | 39 | src.lanctl.core.first_scan._requested | raise 0e8C3EE11D | 47 | src/lanctl/core/plugins/functions.py | 26 | src.lanctl.core.plugins.functions.FunctionRegistry.register | raise +0e8C82E1A6 | 36 | src/lanctl/apps/rack/organization.py | 19 | src.lanctl.apps.rack.organization.organization | raise 0e8CBC5559 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/modes.py | 194 | src.lanctl.apps.ip.interfaces.cli.commands.modes.run_global_cli | print-error 0e8CE4A12F | 42 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 150 | src.lanctl.apps.ip.infrastructure.protocols.ssh.host_fingerprint | raise -0e8CEA39A8 | 16 | src/lanctl/core/plugins/manager.py | 168 | src.lanctl.core.plugins.manager.PluginManager.discover | diagnostic -0e8D1DAB24 | 33 | src/lanctl/apps/wire/idf/database.py | 350 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._normalize_prefix | raise -0e8D79A3B2 | 35 | src/lanctl/core/plugin_storage.py | 47 | src.lanctl.core.plugin_storage.PluginStorage.put_observations.replace | raise -0e8DD057E6 | 41 | src/lanctl/apps/ip/interfaces/cli/main.py | 286 | src.lanctl.apps.ip.interfaces.cli.main.main | return-error +0e8CEA39A8 | 16 | src/lanctl/core/plugins/manager.py | 215 | src.lanctl.core.plugins.manager.PluginManager.discover | diagnostic +0e8D1DAB24 | 33 | src/lanctl/apps/wire/idf/database.py | 364 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._normalize_prefix | raise +0e8D53D985 | 45 | src/lanctl/core/first_scan.py | 88 | src.lanctl.core.first_scan.launch_installed_gui | raise +0e8D631674 | 36 | src/lanctl/apps/wire/gui_service.py | 53 | src.lanctl.apps.wire.gui_service.WireGuiService._fields | raise +0e8D79A3B2 | 35 | src/lanctl/core/plugin_storage.py | 50 | src.lanctl.core.plugin_storage.PluginStorage.put_observations.replace | raise +0e8DD057E6 | 41 | src/lanctl/apps/ip/interfaces/cli/main.py | 297 | src.lanctl.apps.ip.interfaces.cli.main.main | return-error 0e8DDE2A34 | 48 | src/lanctl/core/plugins/ui_contracts.py | 25 | src.lanctl.core.plugins.ui_contracts.validate_ui_panel | raise 0e8DECA2FD | 42 | src/lanctl/apps/monitor/configuration.py | 260 | src.lanctl.apps.monitor.configuration.MonitorAssignment.__post_init__ | raise +0e8E093347 | 36 | src/lanctl/apps/suite/gui_support.py | 262 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.prepare_report.prepare | raise 0e8E39D9F8 | 44 | src/lanctl/apps/access/auth.py | 176 | src.lanctl.apps.access.auth.AuthenticationService.authenticate_password | raise 0e8E947612 | 42 | src/lanctl/core/recurrent_elements.py | 57 | src.lanctl.core.recurrent_elements.RecurrentElementDatabase.load | raise 0e8E9D97BD | 46 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 356 | LANCTL.WOL.Send.Network | diagnostic 0e8F9C083B | 41 | src/lanctl/apps/ip/interfaces/cli/commands/smb.py | 261 | src.lanctl.apps.ip.interfaces.cli.commands.smb.run_smb | return-error -0e8FA9B9EA | 35 | src/lanctl/core/plugin_storage.py | 26 | src.lanctl.core.plugin_storage.PluginStorage.load | raise +0e8FA9B9EA | 35 | src/lanctl/core/plugin_storage.py | 28 | src.lanctl.core.plugin_storage.PluginStorage.load | raise 0e8FFF6AF9 | 47 | src/lanctl/core/plugins/declarative_commands.py | 60 | src.lanctl.core.plugins.declarative_commands._run | raise 0e8FFFA998 | 48 | src/lanctl/core/plugins/ui_contracts.py | 35 | src.lanctl.core.plugins.ui_contracts.validate_ui_panel | raise 0e900508E1 | 36 | src/lanctl/apps/ip/infrastructure/cisco/catalog.py | 182 | src.lanctl.apps.ip.infrastructure.cisco.catalog.find_spec | raise 0e90107759 | 35 | src/lanctl/core/credentials.py | 145 | src.lanctl.core.credentials.CredentialStore._load | raise 0e90336961 | 36 | src/lanctl/apps/wire/topology.py | 204 | src.lanctl.apps.wire.topology.build_ports | raise -0e90649CC4 | 42 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 165 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi._respond | diagnostic -0e90BF2A51 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 188 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise +0e90649CC4 | 42 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 259 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi._respond | diagnostic +0e90BF2A51 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 190 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise 0e9103EA9B | 41 | src/lanctl/apps/monitor/lifecycle.py | 36 | src.lanctl.apps.monitor.lifecycle.SingletonLock.acquire | raise -0e9105E4C1 | 47 | src/lanctl/core/plugins/package.py | 241 | src.lanctl.core.plugins.package.safe_package | raise +0e9105E4C1 | 47 | src/lanctl/core/plugins/package.py | 289 | src.lanctl.core.plugins.package.safe_package | raise 0e91106B10 | 33 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 30 | src.lanctl.apps.ip.infrastructure.protocols.radmin.validate_port | raise -0e91205421 | 42 | src/lanctl/apps/ip/interfaces/cli/main.py | 294 | src.lanctl.apps.ip.interfaces.cli.main.main | diagnostic +0e91205421 | 42 | src/lanctl/apps/ip/interfaces/cli/main.py | 305 | src.lanctl.apps.ip.interfaces.cli.main.main | diagnostic 0e916F54D6 | 33 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 98 | src.lanctl.apps.ip.infrastructure.protocols.radmin.build_arguments | raise 0e91AF172C | 33 | src/lanctl/core/plugins/wol_runtime.py | 43 | src.lanctl.core.plugins.wol_runtime.send_magic_packet | raise 0e91F23458 | 43 | src/lanctl/core/group_database.py | 218 | src.lanctl.core.group_database.GroupDatabase._require_editable | raise -0e922B1C82 | 43 | src/lanctl/core/projects/vlf.py | 632 | src.lanctl.core.projects.vlf._safe_archive | raise -0e9240EE2F | 48 | src/lanctl/core/plugins/package.py | 72 | src.lanctl.core.plugins.package.install_package | raise +0e9228116F | 24 | src/lanctl/bootstrap/lanctl.py | 200 | LANCTL.Suite.Links.Open | diagnostic +0e922B1C82 | 43 | src/lanctl/core/projects/vlf.py | 641 | src.lanctl.core.projects.vlf._safe_archive | raise +0e9269745F | 42 | src/lanctl/core/settings_catalog.py | 134 | src.lanctl.core.settings_catalog.validate_value | raise 0e927CC888 | 37 | src/lanctl/apps/ip/infrastructure/services/element_scanner.py | 159 | src.lanctl.apps.ip.infrastructure.services.element_scanner.parse_ports | raise 0e9285C952 | 49 | src/lanctl/core/errors.py | 128 | src.lanctl.core.errors.ErrorEvent.__post_init__ | raise 0e92904C41 | 47 | src/lanctl/core/plugins/declarative_commands.py | 23 | src.lanctl.core.plugins.declarative_commands.register_declarative_commands | raise -0e929304AA | 47 | src/lanctl/core/plugins/manager.py | 588 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_extensions | raise -0e92FD7A8E | 46 | src/lanctl/apps/monitor/commands.py | 840 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._lanctl_command | raise +0e929304AA | 47 | src/lanctl/core/plugins/manager.py | 773 | src.lanctl.core.plugins.manager.PluginManager._load_declarative_extensions | raise +0e929A8BB2 | 46 | src/lanctl/apps/ip/infrastructure/services/source_binding.py | 37 | src.lanctl.apps.ip.infrastructure.services.source_binding.windows_ping | raise +0e92D1F0D7 | 42 | src/lanctl/core/network_interfaces.py | 49 | src.lanctl.core.network_interfaces.ipv4_interfaces | raise +0e92FD7A8E | 46 | src/lanctl/apps/monitor/commands.py | 846 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._lanctl_command | raise 0e9358CC2F | 33 | src/lanctl/apps/wire/cli/commands.py | 383 | src.lanctl.apps.wire.cli.commands.CommandProcessor._add_options | raise 0e937EBBE6 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 639 | src.lanctl.apps.ip.interfaces.cli.commands.wol._power | raise -0e93972F5B | 43 | src/lanctl/core/projects/vlf.py | 635 | src.lanctl.core.projects.vlf._safe_archive | raise +0e93972F5B | 43 | src/lanctl/core/projects/vlf.py | 644 | src.lanctl.core.projects.vlf._safe_archive | raise +0e93A6A851 | 24 | src/lanctl/core/updates.py | 194 | src.lanctl.core.updates.UpdateService.check | diagnostic 0e94044F05 | 43 | src/lanctl/core/credentials.py | 81 | src.lanctl.core.credentials.unprotect_secret | raise -0e946C3312 | 47 | src/lanctl/core/plugins/manager.py | 507 | src.lanctl.core.plugins.manager.PluginManager._load_declared_hooks | raise +0e946C3312 | 47 | src/lanctl/core/plugins/manager.py | 687 | src.lanctl.core.plugins.manager.PluginManager._load_declared_hooks | raise 0e95114949 | 33 | src/lanctl/apps/ip/infrastructure/cisco/planner.py | 71 | src.lanctl.apps.ip.infrastructure.cisco.planner.CiscoPlanner.plan | raise 0e95144774 | 33 | src/lanctl/shared/assets/icons.py | 171 | src.lanctl.shared.assets.icons.IconManager.resolve | raise -0e957C175E | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 450 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e957C175E | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 472 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0e958F801D | 45 | src/lanctl/apps/access/auth.py | 226 | src.lanctl.apps.access.auth.AuthenticationService.validate_session | raise 0e960775B9 | 33 | src/lanctl/core/plugins/wol_runtime.py | 41 | src.lanctl.core.plugins.wol_runtime.send_magic_packet | raise 0e968FAEB1 | 32 | src/lanctl/apps/access/auth.py | 139 | src.lanctl.apps.access.auth.AuthenticationService.user | raise 0e96B8C37C | 42 | src/lanctl/core/coordination.py | 152 | src.lanctl.core.coordination.Coordinator.publish | raise 0e96C1F3F2 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/modes.py | 138 | src.lanctl.apps.ip.interfaces.cli.commands.modes._run_global_command | raise -0e976E3D10 | 34 | src/lanctl/apps/ip/interfaces/tui/main.py | 2984 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._submit_project_creation | diagnostic +0e974CA5F0 | 42 | src/lanctl/core/updates.py | 86 | src.lanctl.core.updates.UpdateService._read | raise +0e976E3D10 | 34 | src/lanctl/apps/ip/interfaces/tui/main.py | 3119 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._submit_project_creation | diagnostic 0e97F73C6B | 36 | src/lanctl/apps/wire/tui/app.py | 1313 | src.lanctl.apps.wire.tui.app.LanwireTui._connect_selected_port | raise -0e984E5B75 | 45 | src/lanctl/core/plugins/isolated_runtime.py | 507 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise -0e9874FFCB | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 500 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0e984E5B75 | 45 | src/lanctl/core/plugins/isolated_runtime.py | 519 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise +0e9874FFCB | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 522 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0e9882F7E0 | 48 | src/lanctl/core/tr064.py | 69 | src.lanctl.core.tr064.Tr064Client.discover | raise 0e98849D96 | 42 | src/lanctl/apps/monitor/configuration.py | 265 | src.lanctl.apps.monitor.configuration.MonitorAssignment.__post_init__ | raise 0e993BDD22 | 12 | src/lanctl/core/projects/save_policy.py | 151 | src.lanctl.core.projects.save_policy._plugin_modes | diagnostic @@ -674,40 +852,53 @@ 0e99962B7C | 46 | src/lanctl/apps/monitor/lifecycle.py | 140 | src.lanctl.apps.monitor.lifecycle._windows_process_identity | raise 0e999D3103 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 688 | src.lanctl.apps.ip.interfaces.cli.commands.wol.run_wol | raise 0e99AC7B93 | 14 | src/lanctl/apps/ip/infrastructure/services/element_scanner.py | 332 | LANCTL.Scanner.ServiceIdentification | diagnostic +0e99B123F2 | 42 | src/lanctl/core/clink_integration.py | 88 | src.lanctl.core.clink_integration.configure_clink | raise 0e9A04825E | 34 | src/lanctl/apps/ip/interfaces/cli/commands/modes.py | 197 | src.lanctl.apps.ip.interfaces.cli.commands.modes.run_global_cli | print-error 0e9AB2B53A | 47 | src/lanctl/core/plugins/isolated_runtime.py | 94 | src.lanctl.core.plugins.isolated_runtime._MessageReader.receive | raise +0e9ACC0906 | 36 | src/lanctl/apps/suite/launcher_gui.py | 71 | src.lanctl.apps.suite.launcher_gui.LauncherApi._require | raise 0e9B2C4C74 | 33 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 58 | src.lanctl.apps.ip.infrastructure.protocols.ssh.SshProfile.from_options | raise 0e9B7C877E | 37 | src/lanctl/core/plugins/device_adapters.py | 41 | LANCTL.Plugin.DeviceAdapter.Result | diagnostic -0e9BBCB817 | 36 | src/lanctl/apps/wire/idf/database.py | 385 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise +0e9BBCB817 | 36 | src/lanctl/apps/wire/idf/database.py | 404 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise 0e9BBD25C6 | 36 | src/lanctl/apps/access/auth.py | 109 | src.lanctl.apps.access.auth.AuthenticationService.add_user | raise -0e9BBD7732 | 31 | src/lanctl/apps/wire/idf/database.py | 273 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise +0e9BBD7732 | 31 | src/lanctl/apps/wire/idf/database.py | 287 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise +0e9BC19963 | 43 | src/lanctl/apps/suite/gui_support.py | 37 | src.lanctl.apps.suite.gui_support.GuiSupportMixin._support_reply | diagnostic 0e9BC7123A | 42 | src/lanctl/core/recurrent_elements.py | 49 | src.lanctl.core.recurrent_elements.RecurrentElementDatabase.load | raise -0e9BE753EC | 48 | src/lanctl/core/plugins/package.py | 180 | src.lanctl.core.plugins.package._verify_signature | raise 0e9C325967 | 42 | src/lanctl/apps/access/service.py | 143 | src.lanctl.apps.access.service.AccessService.enable.operation | raise 0e9D8D9590 | 31 | src/lanctl/apps/wire/cli/commands.py | 153 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise 0e9DAC616F | 46 | src/lanctl/core/coordination.py | 40 | src.lanctl.core.coordination.principal_id | raise 0e9DF5B836 | 14 | src/lanctl/apps/ip/infrastructure/services/network_discovery.py | 66 | LANCTL.Discovery.Multicast | diagnostic -0e9E16F998 | 18 | src/lanctl/core/projects/workspace.py | 315 | LANCTL.Project.Workspace.Active | diagnostic +0e9E16F998 | 18 | src/lanctl/core/projects/workspace.py | 320 | LANCTL.Project.Workspace.Active | diagnostic 0e9E476FB5 | 36 | src/lanctl/apps/wire/tui/app.py | 1278 | src.lanctl.apps.wire.tui.app.LanwireTui._execute_wire_side_action | raise 0e9E48C5D4 | 46 | src/lanctl/apps/ip/interfaces/tui/clipboard.py | 31 | src.lanctl.apps.ip.interfaces.tui.clipboard.copy_text | raise +0e9E504836 | 24 | src/lanctl/bootstrap/lanctl.py | 200 | src.lanctl.bootstrap.lanctl.main | diagnostic +0e9E51B128 | 42 | src/lanctl/core/updates.py | 31 | src.lanctl.core.updates.version_key | raise 0e9E89C42A | 42 | src/lanctl/apps/monitor/checks.py | 24 | src.lanctl.apps.monitor.checks.CheckRegistry.register | raise -0e9EE18D3B | 43 | src/lanctl/core/projects/vlf.py | 642 | src.lanctl.core.projects.vlf._safe_archive | raise +0e9EE18D3B | 43 | src/lanctl/core/projects/vlf.py | 651 | src.lanctl.core.projects.vlf._safe_archive | raise 0e9F1928B5 | 47 | src/lanctl/core/plugins/smb_runtime.py | 207 | src.lanctl.core.plugins.smb_runtime.SMBNative.connect | raise 0e9FBD23D6 | 16 | src/lanctl/apps/access/runtime.py | 178 | LANCTL.Access.Runtime.Supervisor | diagnostic 0e9FE5C2D5 | 33 | src/lanctl/apps/monitor/configuration.py | 72 | src.lanctl.apps.monitor.configuration.MonitorConfig.__post_init__ | raise -0eA04A58AC | 36 | src/lanctl/apps/wire/idf/database.py | 242 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.update.replace | raise +0eA03046A5 | 42 | src/lanctl/core/activity.py | 42 | src.lanctl.core.activity.ActivityStore.append | raise +0eA04A58AC | 36 | src/lanctl/apps/wire/idf/database.py | 256 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.update.replace | raise +0eA099DE53 | 23 | src/lanctl/core/first_scan.py | 65 | src.lanctl.core.first_scan.scan_choices | diagnostic 0eA0C22C4D | 34 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 394 | src.lanctl.apps.ip.interfaces.cli.commands.wol._sequence_locked | raise -0eA1547D34 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 393 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0eA0D500BF | 41 | src/lanctl/bootstrap/lanctl.py | 222 | src.lanctl.bootstrap.lanctl.main | return-error +0eA132915B | 33 | src/lanctl/apps/suite/gui.py | 263 | src.lanctl.apps.suite.gui.SuiteApi.save_catalog_setting.operation | raise +0eA1547D34 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 415 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0eA17C1FB7 | 36 | src/lanctl/apps/rack/organization.py | 22 | src.lanctl.apps.rack.organization.organization | raise 0eA17C70E4 | 33 | src/lanctl/apps/wire/cli/commands.py | 381 | src.lanctl.apps.wire.cli.commands.CommandProcessor._add_options | raise +0eA1D5A87B | 33 | src/lanctl/core/projects/metadata.py | 67 | src.lanctl.core.projects.metadata.update_metadata | raise +0eA2544F94 | 36 | src/lanctl/apps/rack/service.py | 50 | src.lanctl.apps.rack.service.RackService.set_dimensions | raise 0eA25B62B2 | 45 | src/lanctl/apps/access/remote.py | 263 | src.lanctl.apps.access.remote.RemoteGuiApi.call | raise 0eA2988C89 | 14 | src/lanctl/shared/i18n.py | 429 | LANCTL.I18N.Initialization | diagnostic 0eA2AA6977 | 42 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 119 | src.lanctl.apps.ip.infrastructure.protocols.radmin.build_arguments | raise -0eA2AD19FA | 47 | src/lanctl/core/plugins/manager.py | 370 | src.lanctl.core.plugins.manager.PluginManager.revoke | raise -0eA33FE22A | 39 | src/lanctl/apps/ip/interfaces/tui/main.py | 3647 | src.lanctl.apps.ip.interfaces.tui.main._TuiScanProgress._check_cancelled | raise +0eA2AD19FA | 47 | src/lanctl/core/plugins/manager.py | 443 | src.lanctl.core.plugins.manager.PluginManager.revoke | raise +0eA33FE22A | 39 | src/lanctl/apps/ip/interfaces/tui/main.py | 3782 | src.lanctl.apps.ip.interfaces.tui.main._TuiScanProgress._check_cancelled | raise 0eA3603602 | 48 | src/lanctl/core/group_database.py | 51 | src.lanctl.core.group_database._decoded_snapshot | raise 0eA3904AEB | 32 | src/lanctl/apps/ip/interfaces/cli/commands/smb.py | 211 | src.lanctl.apps.ip.interfaces.cli.commands.smb.run_smb | raise 0eA393E7CA | 36 | src/lanctl/apps/ip/infrastructure/cisco/profiles.py | 51 | src.lanctl.apps.ip.infrastructure.cisco.profiles.load_profiles | raise 0eA3C38058 | 47 | src/lanctl/core/plugins/__init__.py | 28 | src.lanctl.core.plugins.__init__.__getattr__ | raise +0eA3EB4234 | 45 | src/lanctl/core/plugins/authorization.py | 36 | src.lanctl.core.plugins.authorization.RuntimeAuthorizations.check | raise +0eA43B71F9 | 47 | src/lanctl/core/plugins/publishers.py | 74 | src.lanctl.core.plugins.publishers.TrustedPublisherStore._read | raise 0eA474F6E2 | 42 | src/lanctl/core/tr064.py | 142 | src.lanctl.core.tr064.Tr064Client.call | raise 0eA48AF81E | 36 | src/lanctl/apps/ip/interfaces/tui/clipboard.py | 34 | src.lanctl.apps.ip.interfaces.tui.clipboard.copy_text | raise 0eA4C7ACB9 | 42 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 41 | src.lanctl.apps.ip.infrastructure.protocols.radmin.validate_mode | raise @@ -715,38 +906,45 @@ 0eA564E65D | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ping.py | 79 | src.lanctl.apps.ip.interfaces.cli.commands.ping._resolve_target | raise 0eA573C475 | 16 | src/lanctl/apps/monitor/scheduler.py | 139 | src.lanctl.apps.monitor.scheduler.MonitorScheduler._done | diagnostic 0eA583FCB0 | 36 | src/lanctl/apps/wire/cli/commands.py | 373 | src.lanctl.apps.wire.cli.commands.CommandProcessor._add_options | raise -0eA597AA7D | 45 | src/lanctl/core/plugins/manager.py | 236 | src.lanctl.core.plugins.manager.PluginManager.install | raise +0eA597AA7D | 45 | src/lanctl/core/plugins/manager.py | 316 | src.lanctl.core.plugins.manager.PluginManager.install | raise 0eA59959E4 | 48 | src/lanctl/core/plugins/ui_contracts.py | 48 | src.lanctl.core.plugins.ui_contracts.validate_ui_action | raise 0eA5C76110 | 42 | src/lanctl/apps/ip/interfaces/gui/main.py | 72 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.select_project_file.operation | raise +0eA5FEBEAD | 47 | src/lanctl/core/plugins/manager.py | 826 | src.lanctl.core.plugins.manager.PluginManager._verify_installed | raise 0eA61EC4AD | 37 | src/lanctl/apps/ip/infrastructure/services/element_scanner.py | 429 | src.lanctl.apps.ip.infrastructure.services.element_scanner.ElementScanner.__init__ | raise 0eA64071CB | 47 | src/lanctl/core/plugins/smb_runtime.py | 313 | src.lanctl.core.plugins.smb_runtime.SMBNative._linux_shares | raise 0eA65904C1 | 35 | src/lanctl/core/group_database.py | 178 | src.lanctl.core.group_database.GroupDatabase.edit_device_fields | raise 0eA6721055 | 18 | src/lanctl/apps/access/ssh_server.py | 217 | LANCTL.Access.SSH.Session | diagnostic 0eA6886BAB | 47 | src/lanctl/core/plugins/smb_runtime.py | 224 | src.lanctl.core.plugins.smb_runtime.SMBNative.disconnect | raise +0eA697D59D | 47 | src/lanctl/core/plugins/manager.py | 297 | src.lanctl.core.plugins.manager.PluginManager.activate_enabled | raise 0eA69EF92B | 43 | src/lanctl/core/history.py | 156 | src.lanctl.core.history.HistoryReader._structured_events | raise -0eA708E0AB | 45 | src/lanctl/core/plugins/manager.py | 468 | src.lanctl.core.plugins.manager.PluginManager._activate | raise -0eA70FBDFF | 34 | src/lanctl/apps/ip/interfaces/tui/main.py | 2984 | LANCTL.TUI.ProjectManager.Create | diagnostic -0eA712BDDB | 42 | src/lanctl/apps/monitor/commands.py | 829 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._targets | raise +0eA6AF99FC | 36 | src/lanctl/apps/rack/organization.py | 77 | src.lanctl.apps.rack.organization.mutate.change | raise +0eA7064FA6 | 33 | src/lanctl/core/plugins/settings.py | 31 | src.lanctl.core.plugins.settings.PluginSettings.__init__ | raise +0eA708E0AB | 45 | src/lanctl/core/plugins/manager.py | 647 | src.lanctl.core.plugins.manager.PluginManager._activate | raise +0eA70FBDFF | 34 | src/lanctl/apps/ip/interfaces/tui/main.py | 3119 | LANCTL.TUI.ProjectManager.Create | diagnostic +0eA712BDDB | 42 | src/lanctl/apps/monitor/commands.py | 835 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._targets | raise 0eA716DE05 | 46 | src/lanctl/core/tr064.py | 58 | src.lanctl.core.tr064.Tr064Client._open | raise -0eA71B913B | 47 | src/lanctl/core/plugins/manager.py | 404 | src.lanctl.core.plugins.manager.PluginManager.get | raise +0eA71B913B | 47 | src/lanctl/core/plugins/manager.py | 479 | src.lanctl.core.plugins.manager.PluginManager.get | raise 0eA7533D08 | 48 | src/lanctl/core/plugins/ui_contracts.py | 27 | src.lanctl.core.plugins.ui_contracts.validate_ui_panel | raise 0eA76651DB | 49 | src/lanctl/core/persistence.py | 171 | src.lanctl.core.persistence.import_storage | raise 0eA7753DA2 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/language.py | 61 | src.lanctl.apps.ip.interfaces.cli.commands.language._use | raise -0eA7794CCE | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 3424 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._open_startup_modal | raise -0eA77C076B | 42 | src/lanctl/apps/access/manager_cli.py | 256 | LANCTL.Access.TUI.Action | diagnostic +0eA7794CCE | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 3559 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._open_startup_modal | raise +0eA77C076B | 42 | src/lanctl/apps/access/manager_cli.py | 224 | LANCTL.Access.TUI.Action | diagnostic +0eA789AA07 | 36 | src/lanctl/apps/access/credential_service.py | 31 | src.lanctl.apps.access.credential_service.CredentialService.set_secret | raise 0eA7B33044 | 46 | src/lanctl/apps/access/ssh_server.py | 149 | src.lanctl.apps.access.ssh_server.SshAccessServer.serve_forever | raise 0eA7C44A23 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/group.py | 48 | src.lanctl.apps.ip.interfaces.cli.commands.group.run_group | raise 0eA7C64F77 | 42 | src/lanctl/core/recurrent_elements.py | 33 | src.lanctl.core.recurrent_elements.RecurrentElementDatabase.load | raise 0eA7E5F466 | 49 | src/lanctl/core/file_transaction.py | 77 | src.lanctl.core.file_transaction.InterProcessLock.acquire | raise -0eA7F10300 | 35 | src/lanctl/core/group_database.py | 309 | src.lanctl.core.group_database.GroupDatabase.add | raise -0eA80577A4 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 191 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise +0eA7F10300 | 35 | src/lanctl/core/group_database.py | 311 | src.lanctl.core.group_database.GroupDatabase.add | raise +0eA80577A4 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 193 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise 0eA8572C86 | 33 | src/lanctl/core/paths.py | 82 | src.lanctl.core.paths.data_root | raise 0eA88740B4 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/modes.py | 156 | src.lanctl.apps.ip.interfaces.cli.commands.modes._run_global_command | print-error 0eA8C2E8CD | 41 | src/lanctl/core/file_transaction.py | 82 | src.lanctl.core.file_transaction.InterProcessLock.release | raise 0eA8D8BEE3 | 33 | src/lanctl/core/query.py | 48 | src.lanctl.core.query.matches_query | raise 0eA9041487 | 33 | src/lanctl/apps/monitor/operations.py | 21 | src.lanctl.apps.monitor.operations.BoundedRunner.run | raise -0eA9327AC9 | 48 | src/lanctl/core/plugins/package.py | 36 | src.lanctl.core.plugins.package.verify_package | raise +0eA9327AC9 | 48 | src/lanctl/core/plugins/package.py | 37 | src.lanctl.core.plugins.package.verify_package | raise 0eA935A3C7 | 42 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 106 | src.lanctl.apps.ip.infrastructure.protocols.radmin.build_arguments | raise +0eA98DCE5B | 35 | src/lanctl/apps/rack/organization.py | 25 | src.lanctl.apps.rack.organization.organization | raise +0eA9A24EB4 | 42 | src/lanctl/core/network_interfaces.py | 87 | src.lanctl.core.network_interfaces.ipv4_interfaces | raise 0eAA130A4C | 46 | src/lanctl/apps/ip/interfaces/tui/clipboard.py | 14 | src.lanctl.apps.ip.interfaces.tui.clipboard.copy_text | raise 0eAA279D8E | 35 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 185 | src.lanctl.apps.ip.infrastructure.protocols.ssh.run_show_command | raise 0eAA28EA46 | 36 | src/lanctl/apps/wire/topology.py | 257 | src.lanctl.apps.wire.topology.resize_port_pattern | raise @@ -756,42 +954,49 @@ 0eAB5BE296 | 47 | src/lanctl/core/plugins/smb_runtime.py | 294 | src.lanctl.core.plugins.smb_runtime.SMBNative._linux_shares | raise 0eABAFAE9F | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 166 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.plugin_action.operation | raise 0eABBE6622 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/project.py | 170 | src.lanctl.apps.ip.interfaces.cli.commands.project._update | raise +0eABDA484D | 36 | src/lanctl/apps/access/remote_setup.py | 45 | src.lanctl.apps.access.remote_setup._reject_redirected_paths | raise 0eAC120C3F | 47 | src/lanctl/core/plugins/smb_runtime.py | 215 | src.lanctl.core.plugins.smb_runtime.SMBNative.connect | raise 0eAC1CCC0B | 41 | src/lanctl/apps/wire/xfile.py | 65 | src.lanctl.apps.wire.xfile.FileLock.release | raise +0eAC260FA9 | 47 | src/lanctl/core/plugins/manager.py | 1025 | src.lanctl.core.plugins.manager._matches_dependency | raise 0eAC27ED48 | 48 | src/lanctl/core/plugins/models.py | 85 | src.lanctl.core.plugins.models.PluginManifest.from_dict | raise 0eACCB83D4 | 43 | src/lanctl/core/database.py | 49 | src.lanctl.core.database.DeviceDatabase.load | raise +0eAD03689B | 36 | src/lanctl/apps/wire/gui_service.py | 211 | src.lanctl.apps.wire.gui_service.WireGuiService.connect | raise 0eADA501B8 | 42 | src/lanctl/core/persistence.py | 128 | src.lanctl.core.persistence.verify_export | raise -0eADC750D2 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 380 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.get_device_details.operation | raise +0eADC750D2 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 384 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.get_device_details.operation | raise 0eADCD3536 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/group.py | 53 | src.lanctl.apps.ip.interfaces.cli.commands.group.run_group | raise 0eADD6569E | 33 | src/lanctl/core/log_cleanup.py | 26 | src.lanctl.core.log_cleanup.cleanup_old_logs | raise -0eADDB22B0 | 33 | src/lanctl/apps/ip/interfaces/gui/main.py | 464 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.open_service.operation | raise +0eADDB22B0 | 33 | src/lanctl/apps/ip/interfaces/gui/main.py | 468 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.open_service.operation | raise 0eAE3DF573 | 12 | src/lanctl/core/projects/save_policy.py | 151 | LANCTL.Project.SaveMode.Discovery | diagnostic 0eAE480AC2 | 43 | src/lanctl/core/database.py | 39 | src.lanctl.core.database.DeviceDatabase.load | raise -0eAE741BF7 | 36 | src/lanctl/apps/wire/cli/main.py | 221 | src.lanctl.apps.wire.cli.main | raise -0eAEC91E95 | 14 | src/lanctl/core/plugins/manager.py | 323 | LANCTL.Plugin.Deactivation | diagnostic +0eAE741BF7 | 36 | src/lanctl/apps/wire/cli/main.py | 227 | src.lanctl.apps.wire.cli.main | raise +0eAEC91E95 | 14 | src/lanctl/core/plugins/authorization.py | 78 | LANCTL.Plugin.Deactivation | diagnostic +0eAF138431 | 36 | src/lanctl/apps/suite/gui.py | 297 | src.lanctl.apps.suite.gui.SuiteApi.save_launcher_setting.operation | raise 0eAF221281 | 33 | src/lanctl/apps/wire/cli/commands.py | 355 | src.lanctl.apps.wire.cli.commands.CommandProcessor._add_options | raise 0eAF23D80F | 35 | src/lanctl/core/session.py | 67 | src.lanctl.core.session._report | diagnostic -0eAF2B8567 | 36 | src/lanctl/bootstrap/lanmon.py | 66 | src.lanctl.bootstrap.lanmon._main | raise -0eAF37F129 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 186 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise +0eAF2B8567 | 36 | src/lanctl/bootstrap/lanmon.py | 71 | src.lanctl.bootstrap.lanmon._main | raise +0eAF37F129 | 36 | src/lanctl/apps/wire/idf/sample_topology.py | 188 | src.lanctl.apps.wire.idf.sample_topology.validate_topology | raise 0eAF9D1BFF | 31 | src/lanctl/apps/wire/cli/commands.py | 283 | src.lanctl.apps.wire.cli.commands.CommandProcessor._element_command | raise 0eAFB35BAA | 43 | src/lanctl/core/database.py | 558 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise 0eB0732069 | 34 | src/lanctl/apps/access/service.py | 121 | src.lanctl.apps.access.service.AccessService.configure.operation | raise 0eB088918C | 33 | src/lanctl/apps/ip/interfaces/gui/theme.py | 47 | src.lanctl.apps.ip.interfaces.gui.theme.validate_theme_specification | raise -0eB0A6E4F9 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 329 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise -0eB0D7D1EF | 33 | src/lanctl/core/plugins/api.py | 322 | src.lanctl.core.plugins.api._PluginMonitor.write_metric | raise +0eB0A6E4F9 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 351 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0eB0D7D1EF | 33 | src/lanctl/core/plugins/api.py | 356 | src.lanctl.core.plugins.api._PluginMonitor.write_metric | raise 0eB1346C6E | 47 | src/lanctl/core/plugins/smb_runtime.py | 389 | src.lanctl.core.plugins.smb_runtime.SMBService.inspect | raise -0eB137D0C8 | 43 | src/lanctl/core/config.py | 639 | src.lanctl.core.config._load_config | raise -0eB145EDE5 | 36 | src/lanctl/apps/wire/idf/database.py | 268 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise -0eB1B07D6B | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 368 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise -0eB20BE011 | 18 | src/lanctl/core/projects/workspace.py | 315 | src.lanctl.core.projects.workspace.ensure_active_project_workspace | diagnostic +0eB137D0C8 | 43 | src/lanctl/core/config.py | 658 | src.lanctl.core.config._load_config | raise +0eB145EDE5 | 36 | src/lanctl/apps/wire/idf/database.py | 282 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise +0eB1B07D6B | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 390 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0eB20BE011 | 18 | src/lanctl/core/projects/workspace.py | 320 | src.lanctl.core.projects.workspace.ensure_active_project_workspace | diagnostic +0eB21FE404 | 42 | src/lanctl/core/settings_catalog.py | 136 | src.lanctl.core.settings_catalog.validate_value | raise 0eB233A365 | 33 | src/lanctl/apps/ip/infrastructure/cisco/profiles.py | 40 | src.lanctl.apps.ip.infrastructure.cisco.profiles._from_dict | raise 0eB23FE3DE | 36 | src/lanctl/shared/i18n.py | 282 | src.lanctl.shared.i18n.LanguageManager.translate | raise 0eB2470DF5 | 42 | src/lanctl/core/persistence.py | 204 | src.lanctl.core.persistence.migrate_schema | raise -0eB2574240 | 45 | src/lanctl/core/plugins/api.py | 265 | src.lanctl.core.plugins.api._PluginHistory.write | raise -0eB26A9C13 | 43 | src/lanctl/core/database.py | 624 | src.lanctl.core.database.DeviceDatabase._set_protocol_in_memory | raise +0eB2574240 | 45 | src/lanctl/core/plugins/api.py | 299 | src.lanctl.core.plugins.api._PluginHistory.write | raise +0eB26A9C13 | 43 | src/lanctl/core/database.py | 622 | src.lanctl.core.database.DeviceDatabase._set_protocol_in_memory | raise 0eB29509B9 | 36 | src/lanctl/apps/access/vault_service.py | 20 | src.lanctl.apps.access.vault_service.transfer | raise +0eB2AAB64A | 43 | src/lanctl/core/projects/metadata.py | 46 | src.lanctl.core.projects.metadata.validate_metadata | raise 0eB307AB93 | 47 | src/lanctl/core/plugins/theme.py | 96 | src.lanctl.core.plugins.theme._validate_value | raise 0eB30D3FFE | 46 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 320 | src.lanctl.apps.ip.infrastructure.protocols.ssh.open_colored_interactive | raise +0eB34BE113 | 43 | src/lanctl/core/projects/metadata.py | 56 | src.lanctl.core.projects.metadata.update_metadata | raise 0eB36C9EDE | 36 | src/lanctl/apps/wire/cli/commands.py | 269 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_options | raise 0eB3EAAFE8 | 36 | src/lanctl/apps/access/service.py | 158 | src.lanctl.apps.access.service.AccessService.disable | raise 0eB4126FEC | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 715 | src.lanctl.apps.ip.interfaces.cli.commands.wol.run_wol | raise @@ -801,241 +1006,314 @@ 0eB49213B4 | 42 | src/lanctl/core/recurrent_elements.py | 42 | src.lanctl.core.recurrent_elements.RecurrentElementDatabase.load | raise 0eB4B67819 | 36 | src/lanctl/apps/wire/cli/commands.py | 267 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_options | raise 0eB4BDDDF4 | 33 | src/lanctl/apps/wire/log.py | 98 | src.lanctl.apps.wire.log.cleanup_old_logs | raise -0eB510F9F2 | 32 | src/lanctl/apps/monitor/commands.py | 147 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._start_monitor | raise +0eB4F1CCB4 | 33 | src/lanctl/core/plugins/settings.py | 70 | src.lanctl.core.plugins.settings.PluginSettings.fields | raise +0eB510F9F2 | 32 | src/lanctl/apps/monitor/commands.py | 153 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._start_monitor | raise 0eB529D800 | 42 | src/lanctl/core/tr064.py | 86 | src.lanctl.core.tr064.Tr064Client.discover | raise 0eB54599E2 | 41 | src/lanctl/apps/monitor/sessions.py | 50 | src.lanctl.apps.monitor.sessions.SessionManager.stop | raise 0eB5BFF09C | 14 | src/lanctl/apps/ip/infrastructure/services/manufacturer.py | 15 | LANCTL.Manufacturer.LocalDatabase | diagnostic 0eB5C75D30 | 42 | src/lanctl/apps/access/keys.py | 41 | src.lanctl.apps.access.keys.generate_certificate | raise 0eB5FCC731 | 33 | src/lanctl/apps/access/audit.py | 21 | LANCTL.Access.Vault.Observer | diagnostic -0eB602020B | 36 | src/lanctl/apps/wire/xfile.py | 165 | src.lanctl.apps.wire.xfile.write | raise +0eB602020B | 36 | src/lanctl/apps/wire/xfile.py | 169 | src.lanctl.apps.wire.xfile.write | raise 0eB618767D | 34 | src/lanctl/apps/ip/interfaces/cli/commands/modes.py | 130 | src.lanctl.apps.ip.interfaces.cli.commands.modes._run_global_command | print-error 0eB6195B2B | 31 | src/lanctl/apps/ip/interfaces/cli/commands/group.py | 78 | src.lanctl.apps.ip.interfaces.cli.commands.group.run_group | raise -0eB64C275A | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 153 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi._respond | return-error +0eB64C275A | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 247 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi._respond | return-error 0eB65E9FD8 | 46 | src/lanctl/apps/access/ssh_server.py | 41 | src.lanctl.apps.access.ssh_server.RestrictedSshServer.check_auth_publickey | return-error 0eB69B7C5B | 31 | src/lanctl/apps/ip/interfaces/cli/commands/credential.py | 98 | src.lanctl.apps.ip.interfaces.cli.commands.credential.run_credential | raise 0eB7426356 | 42 | src/lanctl/apps/access/keys.py | 16 | src.lanctl.apps.access.keys.generate_host_key | raise +0eB795AF9A | 36 | src/lanctl/apps/suite/gui_support.py | 100 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.open_update_release.open_release | raise +0eB8000527 | 42 | src/lanctl/core/session_context.py | 40 | src.lanctl.core.session_context.consume_context | raise +0eB80E495C | 42 | src/lanctl/core/settings_catalog.py | 110 | src.lanctl.core.settings_catalog.validate_value | raise +0eB81E5FE0 | 36 | src/lanctl/apps/rack/organization.py | 72 | src.lanctl.apps.rack.organization.mutate.change | raise 0eB8397E7C | 42 | src/lanctl/apps/wire/tui/app.py | 1595 | src.lanctl.apps.wire.tui.app.LanwireTui.run | raise -0eB881DA05 | 43 | src/lanctl/core/projects/vlf.py | 706 | src.lanctl.core.projects.vlf._read_json_entry | raise +0eB881DA05 | 43 | src/lanctl/core/projects/vlf.py | 715 | src.lanctl.core.projects.vlf._read_json_entry | raise +0eB8B83BFD | 36 | src/lanctl/apps/wire/gui_service.py | 190 | src.lanctl.apps.wire.gui_service.WireGuiService.connect | raise 0eB8E11C99 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/switch.py | 284 | src.lanctl.apps.ip.interfaces.cli.commands.switch.run_switch | raise +0eB90513CC | 42 | src/lanctl/core/rack_dimensions.py | 74 | src.lanctl.core.rack_dimensions.new_rack_dimensions | raise 0eB90E5979 | 32 | src/lanctl/apps/access/remote.py | 96 | src.lanctl.apps.access.remote.parse_remote_command | raise 0eB921BF85 | 47 | src/lanctl/core/plugins/events.py | 43 | src.lanctl.core.plugins.events.EventRegistry.register | raise -0eB9957178 | 47 | src/lanctl/core/plugins/manager.py | 655 | src.lanctl.core.plugins.manager.PluginManager._check_compatibility | raise +0eB9957178 | 47 | src/lanctl/core/plugins/manager.py | 890 | src.lanctl.core.plugins.manager.PluginManager._check_compatibility | raise 0eB9DE8BB8 | 46 | src/lanctl/apps/access/remote.py | 165 | LANCTL.Access.Remote.Command | diagnostic -0eB9E38A99 | 48 | src/lanctl/core/projects/vlf.py | 424 | src.lanctl.core.projects.vlf.verify_project | raise +0eB9E38A99 | 48 | src/lanctl/core/projects/vlf.py | 432 | src.lanctl.core.projects.vlf.verify_project | raise 0eBA6EE584 | 36 | src/lanctl/apps/ip/infrastructure/terminals/tr064.py | 25 | src.lanctl.apps.ip.infrastructure.terminals.tr064.parse_call | raise -0eBA7EDC9E | 45 | src/lanctl/core/plugins/manager.py | 501 | src.lanctl.core.plugins.manager.PluginManager._load_declared_hooks | raise +0eBA7EDC9E | 45 | src/lanctl/core/plugins/manager.py | 681 | src.lanctl.core.plugins.manager.PluginManager._load_declared_hooks | raise 0eBA8A16D2 | 43 | src/lanctl/apps/monitor/scheduler.py | 69 | src.lanctl.apps.monitor.scheduler.MonitorScheduler.schedule | raise 0eBA9785EF | 46 | src/lanctl/apps/ip/interfaces/tui/clipboard.py | 27 | src.lanctl.apps.ip.interfaces.tui.clipboard.copy_text | raise 0eBAD0D06C | 36 | src/lanctl/apps/ip/interfaces/tui/layout.py | 129 | src.lanctl.apps.ip.interfaces.tui.layout.normalize_column_spec | raise -0eBAEF9E07 | 42 | src/lanctl/bootstrap/lanmon.py | 122 | src.lanctl.bootstrap.lanmon.main | diagnostic -0eBB9E4629 | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 1738 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._read_secret | raise -0eBBC365B2 | 33 | src/lanctl/core/plugins/package.py | 209 | src.lanctl.core.plugins.package.safe_package | raise -0eBC52EA9D | 46 | src/lanctl/apps/monitor/commands.py | 597 | LANCTL.Monitor.Restart.Stop | diagnostic +0eBAEF9E07 | 42 | src/lanctl/bootstrap/lanmon.py | 136 | src.lanctl.bootstrap.lanmon.main | diagnostic +0eBAF89B60 | 33 | src/lanctl/apps/ip/interfaces/gui/main.py | 304 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._scan_with_target.operation | raise +0eBB9E4629 | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 1760 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._read_secret | raise +0eBBC365B2 | 33 | src/lanctl/core/plugins/package.py | 257 | src.lanctl.core.plugins.package.safe_package | raise +0eBBD08C2E | 31 | src/lanctl/apps/ip/interfaces/cli/commands/list.py | 285 | src.lanctl.apps.ip.interfaces.cli.commands.list.run_list | raise +0eBC52EA9D | 46 | src/lanctl/apps/monitor/commands.py | 603 | LANCTL.Monitor.Restart.Stop | diagnostic 0eBC8643EB | 42 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 167 | src.lanctl.apps.ip.infrastructure.protocols.ssh.verify_pinned_host | raise 0eBC9B203A | 33 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 543 | src.lanctl.apps.ip.interfaces.cli.commands.wol._schedule_seconds | raise -0eBD1A4595 | 41 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 155 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise +0eBD1A4595 | 41 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 154 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise 0eBD2FA037 | 49 | src/lanctl/core/errors.py | 254 | src.lanctl.core.errors.ErrorManager.emit | raise 0eBD32CD7D | 41 | src/lanctl/apps/monitor/sessions.py | 27 | src.lanctl.apps.monitor.sessions.SessionManager.start | raise -0eBD40AD15 | 44 | src/lanctl/core/session.py | 282 | LANCTL.Core.Coordination.Startup | diagnostic +0eBD40AD15 | 44 | src/lanctl/core/session.py | 326 | LANCTL.Core.Coordination.Startup | diagnostic 0eBD5AD32D | 43 | src/lanctl/core/history.py | 243 | src.lanctl.core.history.HistoryService.__init__ | raise +0eBE2F312A | 36 | src/lanctl/apps/access/remote_setup.py | 190 | src.lanctl.apps.access.remote_setup.run_remote_setup | raise +0eBE5320C7 | 33 | src/lanctl/apps/wire/gui_service.py | 141 | src.lanctl.apps.wire.gui_service.WireGuiService.update | raise 0eBE55CEC7 | 42 | src/lanctl/core/coordination.py | 234 | src.lanctl.core.coordination.Coordinator.enqueue | raise 0eBE5CA940 | 36 | src/lanctl/apps/ip/infrastructure/terminals/tr064.py | 29 | src.lanctl.apps.ip.infrastructure.terminals.tr064.parse_call | raise 0eBE7ABEA1 | 32 | src/lanctl/core/group_database.py | 186 | src.lanctl.core.group_database.GroupDatabase.edit_device_fields | raise -0eBEC0F917 | 48 | src/lanctl/core/plugins/package.py | 31 | src.lanctl.core.plugins.package.verify_package | raise -0eBEF0D5FE | 41 | src/lanctl/apps/ip/interfaces/gui/main.py | 584 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._respond | return-error +0eBEC0F917 | 48 | src/lanctl/core/plugins/package.py | 32 | src.lanctl.core.plugins.package.verify_package | raise +0eBEC4EEC9 | 42 | src/lanctl/core/activity.py | 48 | src.lanctl.core.activity.ActivityStore.append | raise +0eBEF0D5FE | 41 | src/lanctl/apps/ip/interfaces/gui/main.py | 588 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi._respond | return-error +0eBF4F99C6 | 36 | src/lanctl/apps/rack/skins.py | 154 | src.lanctl.apps.rack.skins.save.change | raise 0eBF6AD4DF | 33 | src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py | 101 | src.lanctl.apps.ip.interfaces.cli.commands.ephemeral.run_ephemeral | raise +0eBF8A696E | 41 | src/lanctl/apps/suite/processes.py | 56 | src.lanctl.apps.suite.processes.open_system_cli | raise 0eBF8BAE56 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 551 | src.lanctl.apps.ip.interfaces.cli.commands.wol._power_command | raise -0eBFDE595A | 42 | src/lanctl/core/plugins/api.py | 117 | src.lanctl.core.plugins.api._PluginErrors.interpolate | diagnostic -0eBFFF26A4 | 45 | src/lanctl/core/plugins/api.py | 263 | src.lanctl.core.plugins.api._PluginHistory.write | raise +0eBF8E159A | 33 | src/lanctl/core/plugins/settings.py | 74 | src.lanctl.core.plugins.settings.PluginSettings.fields | raise +0eBFDE595A | 42 | src/lanctl/core/plugins/api.py | 140 | src.lanctl.core.plugins.api._PluginErrors.interpolate | diagnostic +0eBFFF26A4 | 45 | src/lanctl/core/plugins/api.py | 297 | src.lanctl.core.plugins.api._PluginHistory.write | raise 0eC024EEAA | 47 | src/lanctl/core/plugins/smb_runtime.py | 233 | src.lanctl.core.plugins.smb_runtime.SMBNative.open_path | raise 0eC0343E21 | 45 | src/lanctl/apps/ip/interfaces/gui/main.py | 163 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.plugin_action.operation | raise -0eC03B3A58 | 33 | src/lanctl/core/plugins/manager.py | 492 | src.lanctl.core.plugins.manager.PluginManager._activate | raise -0eC046085B | 34 | src/lanctl/apps/ip/interfaces/cli/main.py | 289 | src.lanctl.apps.ip.interfaces.cli.main.main | print-error -0eC0AD77E7 | 35 | src/lanctl/apps/ip/interfaces/tui/main.py | 3559 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise -0eC122C92F | 43 | src/lanctl/core/group_database.py | 340 | src.lanctl.core.group_database.GroupDatabase.delete_device | raise +0eC03B3A58 | 33 | src/lanctl/core/plugins/manager.py | 672 | src.lanctl.core.plugins.manager.PluginManager._activate | raise +0eC046085B | 34 | src/lanctl/apps/ip/interfaces/cli/main.py | 300 | src.lanctl.apps.ip.interfaces.cli.main.main | print-error +0eC0AD77E7 | 35 | src/lanctl/apps/ip/interfaces/tui/main.py | 3694 | src.lanctl.apps.ip.interfaces.tui.main._translate_tui_element | raise +0eC122C92F | 43 | src/lanctl/core/group_database.py | 342 | src.lanctl.core.group_database.GroupDatabase.delete_device | raise 0eC1292CC3 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 617 | src.lanctl.apps.ip.interfaces.cli.commands.wol._power | raise -0eC16AA528 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 77 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise -0eC1DD190E | 36 | src/lanctl/apps/access/https_server.py | 180 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise +0eC16AA528 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 76 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise +0eC1BFE58A | 47 | src/lanctl/core/plugins/manager.py | 939 | src.lanctl.core.plugins.manager.PluginManager._read_registry | raise +0eC1DD190E | 36 | src/lanctl/apps/access/https_server.py | 190 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise 0eC1E7E7F8 | 33 | src/lanctl/core/vault_crypto.py | 34 | src.lanctl.core.vault_crypto.decrypt | raise -0eC2D53998 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 357 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime._log_call | raise -0eC3223DD4 | 48 | src/lanctl/core/projects/vlf.py | 422 | src.lanctl.core.projects.vlf.verify_project | raise +0eC2270A3F | 42 | src/lanctl/core/gui_preferences.py | 105 | src.lanctl.core.gui_preferences.preferences_payload | raise +0eC2D53998 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 362 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime._log_call | raise +0eC3223DD4 | 48 | src/lanctl/core/projects/vlf.py | 430 | src.lanctl.core.projects.vlf.verify_project | raise 0eC3C21690 | 42 | src/lanctl/core/output.py | 516 | src.lanctl.core.output.normalize_columns | raise -0eC419963C | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 193 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise +0eC419963C | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 192 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise 0eC424F5DC | 37 | src/lanctl/apps/ip/infrastructure/services/scan_profiles.py | 33 | src.lanctl.apps.ip.infrastructure.services.scan_profiles.apply_profile | raise -0eC428C875 | 46 | src/lanctl/apps/access/manager_cli.py | 376 | src.lanctl.apps.access.manager_cli.main | return-error +0eC428C875 | 46 | src/lanctl/apps/access/manager_cli.py | 352 | src.lanctl.apps.access.manager_cli.main | return-error 0eC490225B | 33 | src/lanctl/apps/ip/infrastructure/cisco/planner.py | 40 | src.lanctl.apps.ip.infrastructure.cisco.planner.CiscoPlanner._validate | raise 0eC49270E7 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 487 | src.lanctl.apps.ip.interfaces.cli.commands.wol._validate_graph | raise 0eC4A46E9C | 48 | src/lanctl/core/plugins/models.py | 95 | src.lanctl.core.plugins.models.PluginManifest.from_dict | raise 0eC51A1712 | 45 | src/lanctl/core/plugins/events.py | 109 | src.lanctl.core.plugins.events.EventBus.emit | raise +0eC58F7E88 | 48 | src/lanctl/core/network_interfaces.py | 121 | src.lanctl.core.network_interfaces.select_interface | raise 0eC591F858 | 47 | src/lanctl/core/plugins/device_adapters.py | 22 | src.lanctl.core.plugins.device_adapters.resolve_manufacturer_extensions | diagnostic -0eC59577CD | 18 | src/lanctl/core/plugins/manager.py | 670 | src.lanctl.core.plugins.manager.PluginManager._read_registry | diagnostic -0eC5D1B4B2 | 46 | src/lanctl/apps/access/https_server.py | 92 | src.lanctl.apps.access.https_server._BoundedHttpServer.process_request | raise -0eC5E1ECBD | 43 | src/lanctl/core/projects/vlf.py | 630 | src.lanctl.core.projects.vlf._safe_archive | raise -0eC61F4D0F | 16 | src/lanctl/core/plugins/builtin.py | 260 | src.lanctl.core.plugins.builtin._install_builtin_package | diagnostic -0eC628BD86 | 34 | src/lanctl/apps/access/manager_cli.py | 148 | src.lanctl.apps.access.manager_cli.AccessManager.set | raise +0eC59577CD | 18 | src/lanctl/core/plugins/manager.py | 931 | src.lanctl.core.plugins.manager.PluginManager._read_registry | diagnostic +0eC5D1B4B2 | 46 | src/lanctl/apps/access/https_server.py | 100 | src.lanctl.apps.access.https_server._BoundedHttpServer.process_request | raise +0eC5E1ECBD | 43 | src/lanctl/core/projects/vlf.py | 639 | src.lanctl.core.projects.vlf._safe_archive | raise +0eC61F4D0F | 16 | src/lanctl/core/plugins/builtin.py | 268 | src.lanctl.core.plugins.builtin._install_builtin_package | diagnostic +0eC628BD86 | 34 | src/lanctl/apps/access/manager_cli.py | 136 | src.lanctl.apps.access.manager_cli.AccessManager.set | raise 0eC628EDC0 | 33 | src/lanctl/apps/access/auth.py | 111 | src.lanctl.apps.access.auth.AuthenticationService.add_user | raise 0eC637B16A | 18 | src/lanctl/core/projects/save_policy.py | 133 | src.lanctl.core.projects.save_policy.ProjectAutosaveScheduler._run_bound | diagnostic -0eC65DB7D0 | 34 | src/lanctl/apps/ip/interfaces/cli/main.py | 305 | src.lanctl.apps.ip.interfaces.cli.main.main | print-error +0eC65DB7D0 | 34 | src/lanctl/apps/ip/interfaces/cli/main.py | 316 | src.lanctl.apps.ip.interfaces.cli.main.main | print-error 0eC66C9305 | 31 | src/lanctl/apps/wire/cli/commands.py | 142 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise -0eC6A02ECB | 42 | src/lanctl/apps/monitor/log_stream.py | 117 | src.lanctl.apps.monitor.log_stream.open_log_window | raise -0eC75689DD | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 85 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.resolve_network | raise +0eC6A02ECB | 42 | src/lanctl/apps/monitor/log_stream.py | 133 | src.lanctl.apps.monitor.log_stream.open_log_window | raise +0eC6D5E466 | 47 | src/lanctl/core/plugins/manager.py | 880 | src.lanctl.core.plugins.manager.PluginManager._check_dependencies | raise +0eC706411E | 42 | src/lanctl/core/network_interfaces.py | 85 | src.lanctl.core.network_interfaces.ipv4_interfaces | raise +0eC75689DD | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 105 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.resolve_network | raise 0eC78121D0 | 41 | src/lanctl/apps/access/firewall.py | 31 | src.lanctl.apps.access.firewall.FirewallManager.add | raise -0eC78EA968 | 32 | src/lanctl/apps/access/manager_cli.py | 478 | src.lanctl.apps.access.manager_cli._user_command | raise +0eC78EA968 | 32 | src/lanctl/apps/access/manager_cli.py | 454 | src.lanctl.apps.access.manager_cli._user_command | raise 0eC7CE986E | 36 | src/lanctl/apps/wire/cli/commands.py | 271 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_options | raise 0eC808BD11 | 34 | src/lanctl/core/parser.py | 119 | src.lanctl.core.parser.LANCTLArgumentParser.error | print-error +0eC8577183 | 42 | src/lanctl/core/settings_catalog.py | 211 | src.lanctl.core.settings_catalog.set_program_value | raise 0eC8613DE2 | 33 | src/lanctl/apps/wire/idf/idf.py | 49 | src.lanctl.apps.wire.idf.idf.IDF.__post_init__ | raise 0eC863322A | 42 | src/lanctl/core/device_retention.py | 30 | src.lanctl.core.device_retention.normalize_retention_mode | raise +0eC86E213D | 42 | src/lanctl/core/settings_catalog.py | 163 | src.lanctl.core.settings_catalog.validate_value | raise 0eC8E19BA2 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py | 133 | src.lanctl.apps.ip.interfaces.cli.commands.ephemeral.run_ephemeral | raise 0eC8F8F53C | 33 | src/lanctl/apps/monitor/configuration.py | 128 | src.lanctl.apps.monitor.configuration.validate_profile | raise +0eC90467DA | 36 | src/lanctl/apps/rack/skins.py | 130 | src.lanctl.apps.rack.skins.validate_location | raise 0eC95FD9E7 | 33 | src/lanctl/apps/monitor/configuration.py | 227 | src.lanctl.apps.monitor.configuration.ProfileManager.delete | raise 0eC96C8406 | 36 | src/lanctl/apps/ip/infrastructure/cisco/profiles.py | 58 | src.lanctl.apps.ip.infrastructure.cisco.profiles.load_profiles | raise -0eC99B7B95 | 14 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 64 | LANCTL.Scanner.LocalIPv4.Route | diagnostic +0eC9969C21 | 42 | src/lanctl/core/network_interfaces.py | 53 | src.lanctl.core.network_interfaces.ipv4_interfaces | raise +0eC99B7B95 | 14 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 84 | LANCTL.Scanner.LocalIPv4.Route | diagnostic 0eC9E3879A | 16 | src/lanctl/apps/monitor/scheduler.py | 139 | LANCTL.Monitor.Scheduler.ErrorCallback | diagnostic 0eCA787361 | 49 | src/lanctl/core/errors.py | 131 | src.lanctl.core.errors.ErrorEvent.__post_init__ | raise 0eCA92AE3D | 36 | src/lanctl/apps/wire/tui/app.py | 1404 | src.lanctl.apps.wire.tui.app.LanwireTui._edit_or_save_field | raise -0eCABAB506 | 48 | src/lanctl/core/plugins/package.py | 237 | src.lanctl.core.plugins.package.safe_package | raise +0eCAB8B805 | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 450 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.open_device.operation | raise +0eCABAB506 | 48 | src/lanctl/core/plugins/package.py | 285 | src.lanctl.core.plugins.package.safe_package | raise 0eCAE6C4E1 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/open.py | 129 | src.lanctl.apps.ip.interfaces.cli.commands.open.run_open | raise 0eCAFFC631 | 18 | src/lanctl/apps/access/ssh_server.py | 217 | src.lanctl.apps.access.ssh_server.SshAccessServer._client | diagnostic -0eCB13F702 | 46 | src/lanctl/apps/access/https_server.py | 293 | LANCTL.Access.HTTPS.Request | diagnostic +0eCB13F702 | 46 | src/lanctl/apps/access/https_server.py | 303 | LANCTL.Access.HTTPS.Request | diagnostic 0eCB3EF421 | 33 | src/lanctl/shared/assets/icons.py | 173 | src.lanctl.shared.assets.icons.IconManager.resolve | raise +0eCB77648B | 43 | src/lanctl/core/projects/settings.py | 101 | src.lanctl.core.projects.settings.update_project_setting | raise +0eCB9184A1 | 43 | src/lanctl/core/projects/metadata.py | 44 | src.lanctl.core.projects.metadata.validate_metadata | raise 0eCBACBFC0 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 525 | src.lanctl.apps.ip.interfaces.cli.commands.wol._configure_power | raise -0eCBCAD3A2 | 36 | src/lanctl/apps/wire/idf/database.py | 321 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.delete.remove | raise +0eCBCAD3A2 | 36 | src/lanctl/apps/wire/idf/database.py | 335 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.delete.remove | raise 0eCBE080DD | 36 | src/lanctl/apps/wire/cli/commands.py | 247 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise 0eCBFDB879 | 33 | src/lanctl/apps/access/remote.py | 201 | src.lanctl.apps.access.remote.LanctlCommandAdapter._root | raise 0eCC2BB69B | 46 | src/lanctl/apps/ip/interfaces/tui/clipboard.py | 37 | src.lanctl.apps.ip.interfaces.tui.clipboard.copy_text | raise 0eCC5CDE63 | 43 | src/lanctl/core/history.py | 79 | src.lanctl.core.history.HistoryEvent.__post_init__ | raise 0eCC698537 | 31 | src/lanctl/core/plugins/ui_contracts.py | 71 | src.lanctl.core.plugins.ui_contracts.validate_form_schema | raise -0eCCBEA3F0 | 34 | src/lanctl/apps/access/manager_cli.py | 389 | src.lanctl.apps.access.manager_cli._extended_command | raise +0eCC6F4DAF | 46 | src/lanctl/apps/access/credential_service.py | 39 | src.lanctl.apps.access.credential_service.CredentialService.set_secret | raise +0eCCAAA82A | 48 | src/lanctl/core/plugins/package.py | 223 | src.lanctl.core.plugins.package.verify_directory | raise +0eCCBEA3F0 | 34 | src/lanctl/apps/access/manager_cli.py | 365 | src.lanctl.apps.access.manager_cli._extended_command | raise 0eCCCFEB1C | 36 | src/lanctl/apps/wire/idf/idf.py | 55 | src.lanctl.apps.wire.idf.idf.IDF.__post_init__ | raise -0eCCD31434 | 36 | src/lanctl/apps/wire/idf/database.py | 264 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise +0eCCD31434 | 36 | src/lanctl/apps/wire/idf/database.py | 278 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise 0eCD2878EA | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ephemeral.py | 105 | src.lanctl.apps.ip.interfaces.cli.commands.ephemeral.run_ephemeral | raise 0eCD6C913A | 36 | src/lanctl/apps/wire/cli/commands.py | 148 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise 0eCD957F7C | 36 | src/lanctl/apps/wire/tui/app.py | 1327 | src.lanctl.apps.wire.tui.app.LanwireTui._move_selected_connection | raise 0eCDBF7470 | 43 | src/lanctl/core/database.py | 54 | src.lanctl.core.database.DeviceDatabase.load | raise -0eCE381F2D | 48 | src/lanctl/core/plugins/package.py | 108 | src.lanctl.core.plugins.package.build_package | raise +0eCE381F2D | 48 | src/lanctl/core/plugins/package.py | 110 | src.lanctl.core.plugins.package.build_package | raise 0eCE6510D7 | 43 | src/lanctl/core/database.py | 500 | src.lanctl.core.database.DeviceDatabase.set_value | raise 0eCE713417 | 42 | src/lanctl/core/recurrent_elements.py | 70 | src.lanctl.core.recurrent_elements.RecurrentElementDatabase.load | raise -0eCE7DD663 | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 144 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.group_action.operation | raise -0eCEB48B84 | 45 | src/lanctl/core/plugins/manager.py | 277 | src.lanctl.core.plugins.manager.PluginManager.enable | raise -0eCEB548F4 | 34 | src/lanctl/apps/ip/interfaces/cli/main.py | 285 | src.lanctl.apps.ip.interfaces.cli.main.main | print-error -0eCEEB4D00 | 48 | src/lanctl/core/plugins/package.py | 191 | src.lanctl.core.plugins.package._verify_signature | raise +0eCE7DD663 | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 207 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.group_action.operation | raise +0eCEB548F4 | 34 | src/lanctl/apps/ip/interfaces/cli/main.py | 296 | src.lanctl.apps.ip.interfaces.cli.main.main | print-error 0eCF00B44E | 36 | src/lanctl/shared/i18n.py | 203 | src.lanctl.shared.i18n.LanguageManager.load_file | raise 0eCF05382A | 33 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 519 | src.lanctl.apps.ip.interfaces.cli.commands.wol._configure_power | raise 0eCF094C80 | 46 | src/lanctl/apps/access/remote.py | 165 | src.lanctl.apps.access.remote.LanctlCommandAdapter.execute | diagnostic 0eCF4544D1 | 33 | src/lanctl/apps/monitor/configuration.py | 217 | src.lanctl.apps.monitor.configuration.ProfileManager.save | raise -0eCFD68D00 | 41 | src/lanctl/apps/monitor/commands.py | 378 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._service_host_action | raise +0eCFD68D00 | 41 | src/lanctl/apps/monitor/commands.py | 384 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._service_host_action | raise 0eCFE77CBE | 12 | src/lanctl/apps/ip/infrastructure/services/network_discovery.py | 52 | src.lanctl.apps.ip.infrastructure.services.network_discovery.multicast_discover | diagnostic 0eD02CCFC0 | 32 | src/lanctl/apps/access/remote.py | 57 | src.lanctl.apps.access.remote.required_permission | raise 0eD0376AFF | 47 | src/lanctl/core/plugins/smb_runtime.py | 246 | src.lanctl.core.plugins.smb_runtime.SMBNative.open_path | raise 0eD041AB81 | 47 | src/lanctl/apps/access/runtime.py | 100 | LANCTL.Access.Runtime.Server | diagnostic 0eD0BDA655 | 33 | src/lanctl/apps/ip/infrastructure/protocols/radmin.py | 110 | src.lanctl.apps.ip.infrastructure.protocols.radmin.build_arguments | raise -0eD0C954AA | 43 | src/lanctl/core/database.py | 597 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise +0eD0C954AA | 43 | src/lanctl/core/database.py | 595 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise +0eD0D5E70F | 42 | src/lanctl/core/diagnostics.py | 118 | src.lanctl.core.diagnostics.prepare_diagnostic | raise 0eD1057F20 | 32 | src/lanctl/apps/monitor/configuration.py | 327 | src.lanctl.apps.monitor.configuration.AssignmentManager.unassign.remove | raise +0eD159ECF2 | 48 | src/lanctl/apps/suite/gui.py | 169 | src.lanctl.apps.suite.gui.SuiteApi.install_signed_plugin.operation | raise 0eD15FF37E | 31 | src/lanctl/apps/ip/interfaces/cli/commands/ssh.py | 90 | src.lanctl.apps.ip.interfaces.cli.commands.ssh.run_ssh | raise -0eD25CE4DA | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 2333 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._manual_save | diagnostic +0eD1742993 | 42 | src/lanctl/core/gui_preferences.py | 30 | src.lanctl.core.gui_preferences.validate_preferences | raise +0eD1BA5708 | 42 | src/lanctl/core/diagnostics.py | 122 | src.lanctl.core.diagnostics.prepare_diagnostic | raise +0eD25CE4DA | 38 | src/lanctl/apps/ip/interfaces/tui/main.py | 2358 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._manual_save | diagnostic 0eD286D301 | 42 | src/lanctl/apps/access/service.py | 149 | src.lanctl.apps.access.service.AccessService.enable.operation | raise -0eD2F6B42A | 45 | src/lanctl/core/plugins/manager.py | 256 | src.lanctl.core.plugins.manager.PluginManager.uninstall | raise +0eD2E88127 | 36 | src/lanctl/apps/suite/gui_support.py | 317 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.open_report_form.open_form | raise +0eD2F6B42A | 45 | src/lanctl/core/plugins/manager.py | 341 | src.lanctl.core.plugins.manager.PluginManager.uninstall | raise +0eD32219A1 | 46 | src/lanctl/core/network_interfaces.py | 67 | src.lanctl.core.network_interfaces.ipv4_interfaces | raise +0eD35EF0BA | 46 | src/lanctl/apps/ip/infrastructure/services/source_binding.py | 56 | src.lanctl.apps.ip.infrastructure.services.source_binding.windows_ping | raise +0eD36004FC | 47 | src/lanctl/core/plugins/settings.py | 99 | src.lanctl.core.plugins.settings.PluginSettings._value | raise 0eD37535C2 | 36 | src/lanctl/apps/wire/cli/commands.py | 286 | src.lanctl.apps.wire.cli.commands.CommandProcessor._element_command | raise +0eD39D2022 | 35 | src/lanctl/apps/access/gui_service.py | 68 | src.lanctl.apps.access.gui_service.AccessGuiService.delete | raise 0eD3CDD5BB | 33 | src/lanctl/core/plugins/events.py | 55 | src.lanctl.core.plugins.events.EventRegistry.get | raise +0eD3D2315E | 43 | src/lanctl/apps/suite/launcher_gui.py | 55 | src.lanctl.apps.suite.launcher_gui.LauncherApi._respond | diagnostic 0eD3FC03C0 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/element.py | 198 | src.lanctl.apps.ip.interfaces.cli.commands.element.run_element | raise -0eD3FF7D31 | 33 | src/lanctl/apps/monitor/log_stream.py | 95 | src.lanctl.apps.monitor.log_stream.open_log_window | raise +0eD3FF7D31 | 33 | src/lanctl/apps/monitor/log_stream.py | 109 | src.lanctl.apps.monitor.log_stream.open_log_window | raise 0eD40B1693 | 31 | src/lanctl/apps/wire/topology.py | 187 | src.lanctl.apps.wire.topology.build_ports | raise -0eD453C3FC | 39 | src/lanctl/apps/access/manager_cli.py | 411 | src.lanctl.apps.access.manager_cli._extended_command | raise -0eD458DA68 | 36 | src/lanctl/apps/ip/interfaces/cli/main.py | 251 | src.lanctl.apps.ip.interfaces.cli.main.main | raise +0eD453C3FC | 39 | src/lanctl/apps/access/manager_cli.py | 387 | src.lanctl.apps.access.manager_cli._extended_command | raise +0eD458DA68 | 36 | src/lanctl/apps/ip/interfaces/cli/main.py | 258 | src.lanctl.apps.ip.interfaces.cli.main.main | raise +0eD47027BA | 34 | src/lanctl/apps/suite/gui.py | 113 | src.lanctl.apps.suite.gui.SuiteApi._configuration_status | diagnostic 0eD4F91D50 | 36 | src/lanctl/apps/ip/lab/scenario.py | 183 | src.lanctl.apps.ip.lab.scenario.LabRepository.load | raise 0eD517D6B7 | 32 | src/lanctl/apps/ip/infrastructure/cisco/planner.py | 47 | src.lanctl.apps.ip.infrastructure.cisco.planner.CiscoPlanner.plan | raise 0eD52B904C | 45 | src/lanctl/core/plugins/events.py | 139 | src.lanctl.core.plugins.events.EventBus.emit | diagnostic 0eD55BB650 | 42 | src/lanctl/core/device_retention.py | 39 | src.lanctl.core.device_retention.normalize_retention_target | raise 0eD5E24FE0 | 36 | src/lanctl/apps/ip/infrastructure/cisco/models.py | 47 | src.lanctl.apps.ip.infrastructure.cisco.models.SwitchProfile.resolve_port | raise +0eD5ECC42F | 33 | src/lanctl/core/diagnostics.py | 126 | src.lanctl.core.diagnostics.prepare_diagnostic | raise +0eD620920D | 31 | src/lanctl/apps/wire/gui_service.py | 207 | src.lanctl.apps.wire.gui_service.WireGuiService.connect | raise 0eD6427A6D | 33 | src/lanctl/apps/access/network.py | 10 | src.lanctl.apps.access.network.validate_endpoint | raise -0eD70ED1ED | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 172 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi._respond | return-error +0eD66BFAA2 | 33 | src/lanctl/core/updates.py | 51 | src.lanctl.core.updates._fetch_releases | raise +0eD716150B | 12 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 490 | LANCTL.Scanner.Interface.Methods | diagnostic 0eD72EF9C8 | 36 | src/lanctl/apps/access/remote.py | 100 | src.lanctl.apps.access.remote.parse_remote_command | raise 0eD781A6B9 | 16 | src/lanctl/apps/access/runtime.py | 178 | src.lanctl.apps.access.runtime.AccessRuntime._supervise | diagnostic 0eD7955963 | 16 | src/lanctl/apps/access/root_control.py | 79 | LANCTL.RootControl.InterfaceStatus | diagnostic 0eD7B2DB2B | 33 | src/lanctl/core/errors.py | 135 | src.lanctl.core.errors.ErrorEvent.__post_init__ | raise 0eD7BB1855 | 32 | src/lanctl/apps/ip/infrastructure/cisco/planner.py | 27 | src.lanctl.apps.ip.infrastructure.cisco.planner.CiscoPlanner._port | raise -0eD7DDC00E | 42 | src/lanctl/apps/ip/interfaces/gui/main.py | 919 | src.lanctl.apps.ip.interfaces.gui.main.run_gui | raise -0eD7F667E4 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 274 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise -0eD7FA9528 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 301 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0eD7CCF520 | 33 | src/lanctl/apps/access/remote_setup.py | 110 | src.lanctl.apps.access.remote_setup.InitialRemoteAccount.create | raise +0eD7DDC00E | 42 | src/lanctl/apps/ip/interfaces/gui/main.py | 923 | src.lanctl.apps.ip.interfaces.gui.main.run_gui | raise +0eD7E28CA1 | 46 | src/lanctl/apps/suite/gui.py | 423 | src.lanctl.apps.suite.gui.run_gui.remote_action | raise +0eD7F667E4 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 273 | src.lanctl.apps.ip.interfaces.cli.commands.access._user | raise +0eD7FA9528 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 323 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0eD8317B5E | 42 | src/lanctl/core/command_line.py | 27 | src.lanctl.core.command_line.split_command_chain | raise 0eD886DD36 | 34 | src/lanctl/apps/ip/interfaces/cli/commands/modes.py | 143 | src.lanctl.apps.ip.interfaces.cli.commands.modes._run_global_command | print-error -0eD8AB9850 | 43 | src/lanctl/core/group_database.py | 292 | src.lanctl.core.group_database.GroupDatabase.set_description | raise +0eD88BE0CC | 42 | src/lanctl/core/settings_catalog.py | 213 | src.lanctl.core.settings_catalog.set_program_value | raise +0eD8A7B7B3 | 33 | src/lanctl/core/projects/settings.py | 125 | src.lanctl.core.projects.settings.update_project_setting | raise +0eD8AB9850 | 43 | src/lanctl/core/group_database.py | 294 | src.lanctl.core.group_database.GroupDatabase.set_description | raise 0eD8DE590C | 35 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 254 | src.lanctl.apps.ip.infrastructure.protocols.ssh.run_remote_command | raise -0eD8DE73C3 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 411 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.save_project.operation | raise +0eD8DE73C3 | 36 | src/lanctl/apps/ip/interfaces/gui/main.py | 415 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.save_project.operation | raise +0eD9169C0B | 42 | src/lanctl/core/gui_instance.py | 57 | src.lanctl.core.gui_instance.GuiInstance.__init__ | raise +0eD9813364 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py | 247 | src.lanctl.apps.ip.interfaces.cli.commands.settings_menu.dispatch_settings | raise 0eDA31B880 | 33 | src/lanctl/apps/access/store.py | 31 | src.lanctl.apps.access.store.AccessStore._load_unlocked | raise -0eDA48F08E | 33 | src/lanctl/apps/access/manager_cli.py | 433 | src.lanctl.apps.access.manager_cli._extended_command | raise +0eDA48F08E | 33 | src/lanctl/apps/access/manager_cli.py | 409 | src.lanctl.apps.access.manager_cli._extended_command | raise +0eDA60B702 | 36 | src/lanctl/apps/suite/gui_support.py | 116 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.record_activity.append | raise +0eDAD2F45F | 33 | src/lanctl/core/gui_preferences.py | 35 | src.lanctl.core.gui_preferences.validate_preferences | raise 0eDADCA695 | 33 | src/lanctl/core/conditions.py | 50 | src.lanctl.core.conditions.parse_condition | raise -0eDB4B56C0 | 43 | src/lanctl/apps/monitor/commands.py | 812 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._run_foreground | raise +0eDB4B56C0 | 43 | src/lanctl/apps/monitor/commands.py | 818 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._run_foreground | raise 0eDB5B5DD9 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 166 | src.lanctl.apps.ip.interfaces.cli.commands.wol._options | raise -0eDB6BDE5C | 36 | src/lanctl/apps/access/https_server.py | 178 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise -0eDB6DD045 | 39 | src/lanctl/apps/access/manager_cli.py | 488 | src.lanctl.apps.access.manager_cli._user_command | raise +0eDB6BDE5C | 36 | src/lanctl/apps/access/https_server.py | 188 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._body | raise +0eDB6DD045 | 39 | src/lanctl/apps/access/manager_cli.py | 464 | src.lanctl.apps.access.manager_cli._user_command | raise +0eDB8D2FDA | 33 | src/lanctl/apps/access/remote_setup.py | 71 | src.lanctl.apps.access.remote_setup._installed_store_path | raise +0eDBDE9531 | 33 | src/lanctl/apps/wire/gui_service.py | 171 | src.lanctl.apps.wire.gui_service.WireGuiService.update | raise 0eDC1C24B4 | 45 | src/lanctl/core/local_permissions.py | 15 | src.lanctl.core.local_permissions.require_admin | raise +0eDC1D4052 | 48 | src/lanctl/core/plugins/package.py | 199 | src.lanctl.core.plugins.package._verify_signature_bytes | raise 0eDC447C23 | 42 | src/lanctl/apps/monitor/configuration.py | 196 | src.lanctl.apps.monitor.configuration.JsonDocument.update.validate | raise 0eDC61CE9B | 36 | src/lanctl/apps/wire/error.py | 40 | src.lanctl.apps.wire.error.Error.__init__ | raise 0eDC8C9D40 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 565 | src.lanctl.apps.ip.interfaces.cli.commands.wol._power_command | raise +0eDCB8924F | 33 | src/lanctl/apps/monitor/log_tui.py | 27 | src.lanctl.apps.monitor.log_tui.LogViewModel.__init__ | raise 0eDCEC4ADD | 46 | src/lanctl/core/persistence.py | 31 | src.lanctl.core.persistence.create_backup | raise 0eDCEDED36 | 42 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 192 | src.lanctl.apps.ip.infrastructure.protocols.ssh.run_show_command.PinnedHostKeyPolicy.missing_host_key | raise -0eDDAB37B6 | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 2790 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._handle_info_key | raise +0eDD245D36 | 42 | src/lanctl/core/diagnostics.py | 187 | src.lanctl.core.diagnostics._validated | raise +0eDD75781A | 42 | src/lanctl/core/session_context.py | 32 | src.lanctl.core.session_context.consume_context | raise +0eDDAB37B6 | 36 | src/lanctl/apps/ip/interfaces/tui/main.py | 2832 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._handle_info_key | raise 0eDDCE61FA | 34 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 425 | src.lanctl.apps.ip.interfaces.cli.commands.wol._sequence_locked | raise 0eDDEA5DC2 | 32 | src/lanctl/core/credentials.py | 117 | src.lanctl.core.credentials.CredentialStore.__init__ | raise +0eDE24C6B6 | 33 | src/lanctl/core/diagnostics.py | 113 | src.lanctl.core.diagnostics.prepare_diagnostic | raise 0eDE72D9BB | 35 | src/lanctl/core/vault_crypto.py | 25 | src.lanctl.core.vault_crypto.encrypt | raise 0eDE896AEF | 36 | src/lanctl/apps/access/network.py | 18 | src.lanctl.apps.access.network.validate_endpoint | raise 0eDE8C2F2C | 36 | src/lanctl/shared/i18n.py | 189 | src.lanctl.shared.i18n.LanguageManager.load_file | raise 0eDEBAD5A2 | 19 | src/lanctl/apps/access/runtime.py | 139 | LANCTL.Access.Runtime.Build | diagnostic -0eDED27663 | 36 | src/lanctl/apps/wire/idf/database.py | 377 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise +0eDED27663 | 36 | src/lanctl/apps/wire/idf/database.py | 396 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise 0eDF00577D | 14 | src/lanctl/apps/ip/infrastructure/services/network_discovery.py | 66 | src.lanctl.apps.ip.infrastructure.services.network_discovery.multicast_discover | diagnostic 0eDF2B9D4F | 45 | src/lanctl/apps/access/remote.py | 124 | src.lanctl.apps.access.remote.parse_remote_command | raise -0eDF817B46 | 36 | src/lanctl/apps/access/https_server.py | 203 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._origin | raise +0eDF817B46 | 36 | src/lanctl/apps/access/https_server.py | 213 | src.lanctl.apps.access.https_server.HttpsAccessServer.__init__.Handler._origin | raise 0eDF870D17 | 43 | src/lanctl/core/credentials.py | 165 | src.lanctl.core.credentials.CredentialStore._load | raise 0eE010DF62 | 18 | src/lanctl/apps/access/service.py | 200 | src.lanctl.apps.access.service.AccessService._audit | diagnostic -0eE1225021 | 43 | src/lanctl/core/config.py | 637 | src.lanctl.core.config._load_config | raise +0eE03B5CE3 | 42 | src/lanctl/core/updates.py | 88 | src.lanctl.core.updates.UpdateService._read | raise +0eE1225021 | 43 | src/lanctl/core/config.py | 656 | src.lanctl.core.config._load_config | raise 0eE14A2AD4 | 14 | src/lanctl/apps/ip/infrastructure/services/element_scanner.py | 332 | src.lanctl.apps.ip.infrastructure.services.element_scanner.scan_tcp_ports.inspect | diagnostic 0eE14C0024 | 43 | src/lanctl/core/group_database.py | 108 | src.lanctl.core.group_database.GroupDatabase.load | raise 0eE17968F9 | 48 | src/lanctl/core/plugins/ui_contracts.py | 66 | src.lanctl.core.plugins.ui_contracts.validate_form_schema | raise -0eE1EF626D | 33 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 106 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise -0eE1F8B034 | 45 | src/lanctl/core/plugins/api.py | 328 | src.lanctl.core.plugins.api._PluginMonitor.write_metric | raise +0eE1AEC3A4 | 42 | src/lanctl/core/settings_catalog.py | 157 | src.lanctl.core.settings_catalog.validate_value | raise +0eE1EF626D | 33 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 105 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise +0eE1F8B034 | 45 | src/lanctl/core/plugins/api.py | 362 | src.lanctl.core.plugins.api._PluginMonitor.write_metric | raise 0eE2688E3D | 35 | src/lanctl/core/plugins/wol_runtime.py | 16 | src.lanctl.core.plugins.wol_runtime.validate_mac | raise -0eE2B78F5E | 43 | src/lanctl/core/projects/vlf.py | 722 | src.lanctl.core.projects.vlf._existing_vlf | raise -0eE2D855D8 | 36 | src/lanctl/apps/wire/idf/database.py | 382 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise -0eE2DA4E24 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 107 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner.__init__ | raise +0eE2B78F5E | 43 | src/lanctl/core/projects/vlf.py | 731 | src.lanctl.core.projects.vlf._existing_vlf | raise +0eE2D855D8 | 36 | src/lanctl/apps/wire/idf/database.py | 401 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise +0eE2DA4E24 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 129 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner.__init__ | raise +0eE2FA9546 | 36 | src/lanctl/apps/rack/skins.py | 151 | src.lanctl.apps.rack.skins.save.change | raise +0eE30875BB | 42 | src/lanctl/core/rack_dimensions.py | 84 | src.lanctl.core.rack_dimensions.validate_dimension_change | raise 0eE314D699 | 41 | src/lanctl/apps/access/root_control.py | 148 | src.lanctl.apps.access.root_control.enqueue | raise -0eE326FB60 | 06 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 286 | LANCTL.Scanner.ICMP.Retry | diagnostic +0eE326FB60 | 06 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 323 | LANCTL.Scanner.ICMP.Retry | diagnostic 0eE3A25817 | 18 | src/lanctl/apps/monitor/scheduler.py | 124 | src.lanctl.apps.monitor.scheduler.MonitorScheduler._done | diagnostic 0eE3C4ACEF | 35 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 233 | LANCTL.WOL.Resolve.MAC | diagnostic 0eE3E0FDE3 | 36 | src/lanctl/apps/access/service.py | 132 | src.lanctl.apps.access.service.AccessService.enable | raise -0eE4338449 | 18 | src/lanctl/core/plugins/manager.py | 200 | LANCTL.Plugin.Activation.Startup | diagnostic +0eE406BEEC | 32 | src/lanctl/apps/access/remote_setup.py | 108 | src.lanctl.apps.access.remote_setup.InitialRemoteAccount.create | raise +0eE4338449 | 18 | src/lanctl/core/plugins/manager.py | 271 | LANCTL.Plugin.Activation.Startup | diagnostic 0eE460A68F | 36 | src/lanctl/apps/wire/tui/app.py | 1281 | src.lanctl.apps.wire.tui.app.LanwireTui._execute_wire_side_action | raise 0eE46BF5DF | 36 | src/lanctl/infrastructure/platform/linux.py | 15 | src.lanctl.infrastructure.platform.linux.LinuxPlatform.unit_text | raise +0eE46DC340 | 36 | src/lanctl/apps/access/remote_setup.py | 54 | src.lanctl.apps.access.remote_setup._installed_store_path | raise 0eE49D1B57 | 37 | src/lanctl/apps/ip/infrastructure/services/element_scanner.py | 282 | src.lanctl.apps.ip.infrastructure.services.element_scanner.identify_device | raise +0eE4A5787C | 47 | src/lanctl/core/plugins/manager.py | 1029 | src.lanctl.core.plugins.manager._matches_dependency | raise 0eE4A8E358 | 43 | src/lanctl/core/database.py | 433 | src.lanctl.core.database.DeviceDatabase._find | raise -0eE4B03789 | 32 | src/lanctl/apps/ip/interfaces/tui/main.py | 2787 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._handle_info_key | raise +0eE4B03789 | 32 | src/lanctl/apps/ip/interfaces/tui/main.py | 2829 | src.lanctl.apps.ip.interfaces.tui.main.LanctlTui._handle_info_key | raise 0eE4BA96D2 | 42 | src/lanctl/core/coordination.py | 223 | src.lanctl.core.coordination.Coordinator.enqueue | raise -0eE4E217B3 | 33 | src/lanctl/apps/ip/domain/models/device.py | 300 | src.lanctl.apps.ip.domain.models.device.Device.__getitem__ | raise +0eE4E217B3 | 33 | src/lanctl/apps/ip/domain/models/device.py | 296 | src.lanctl.apps.ip.domain.models.device.Device.__getitem__ | raise 0eE4E9FF78 | 33 | src/lanctl/shared/assets/icons.py | 275 | src.lanctl.shared.assets.icons._validate_dimensions | raise +0eE510F60B | 43 | src/lanctl/bootstrap/lanctl.py | 219 | LANCTL.Suite.GUI.Start | diagnostic 0eE515C531 | 31 | src/lanctl/apps/wire/cli/commands.py | 220 | src.lanctl.apps.wire.cli.commands.CommandProcessor._idf_command | raise -0eE5410F0C | 47 | src/lanctl/core/plugins/manager.py | 306 | src.lanctl.core.plugins.manager.PluginManager.enable | raise +0eE52D488E | 36 | src/lanctl/apps/rack/service.py | 53 | src.lanctl.apps.rack.service.RackService.set_dimensions | raise +0eE5410F0C | 47 | src/lanctl/core/plugins/manager.py | 382 | src.lanctl.core.plugins.manager.PluginManager.enable | raise 0eE55D099F | 36 | src/lanctl/apps/wire/idf/database.py | 113 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.add.insert | raise -0eE563C0C2 | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 298 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.open_device.operation | raise -0eE5644894 | 44 | src/lanctl/core/plugins/api.py | 217 | src.lanctl.core.plugins.api._PluginCredentials.get_for_device | raise -0eE58D9112 | 33 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 358 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.save_settings.operation | raise +0eE563C0C2 | 41 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 488 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.open_device.operation | raise +0eE5644894 | 44 | src/lanctl/core/plugins/api.py | 247 | src.lanctl.core.plugins.api._PluginCredentials.get_for_device | raise +0eE58D9112 | 33 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 569 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.save_settings.operation | raise 0eE59D6908 | 36 | src/lanctl/apps/wire/tui/app.py | 1283 | src.lanctl.apps.wire.tui.app.LanwireTui._execute_wire_side_action | raise +0eE5ADDBDA | 36 | src/lanctl/apps/suite/gui_support.py | 113 | src.lanctl.apps.suite.gui_support.GuiSupportMixin.record_activity.append | raise +0eE5CF45CE | 36 | src/lanctl/apps/rack/skins.py | 95 | src.lanctl.apps.rack.skins.appearance | raise 0eE61009E6 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/terminal.py | 43 | src.lanctl.apps.ip.interfaces.cli.commands.terminal.choose_terminal | raise 0eE616B62E | 37 | src/lanctl/apps/ip/infrastructure/services/element_scanner.py | 154 | src.lanctl.apps.ip.infrastructure.services.element_scanner.parse_ports | raise +0eE64DD7ED | 34 | src/lanctl/apps/access/remote_setup.py | 112 | src.lanctl.apps.access.remote_setup.InitialRemoteAccount.create | raise 0eE6952F8F | 42 | src/lanctl/apps/monitor/configuration.py | 68 | src.lanctl.apps.monitor.configuration.MonitorConfig.__post_init__ | raise 0eE6B2100D | 32 | src/lanctl/apps/access/auth.py | 234 | src.lanctl.apps.access.auth.AuthenticationService.revoke | raise -0eE6C2CCE7 | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 232 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.create_project.operation | raise -0eE6E4086B | 39 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 144 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise +0eE6C2CCE7 | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 379 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.create_project.operation | raise +0eE6E4086B | 39 | src/lanctl/apps/ip/interfaces/cli/commands/access.py | 143 | src.lanctl.apps.ip.interfaces.cli.commands.access.run_access | raise +0eE6F390FC | 48 | src/lanctl/core/plugins/settings.py | 28 | src.lanctl.core.plugins.settings.PluginSettings.__init__ | raise 0eE790900F | 42 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 208 | src.lanctl.apps.ip.infrastructure.protocols.ssh.run_show_command | raise 0eE8057F83 | 36 | src/lanctl/apps/ip/interfaces/tui/layout.py | 118 | src.lanctl.apps.ip.interfaces.tui.layout.normalize_column_spec | raise 0eE80BD10A | 33 | src/lanctl/apps/monitor/operations.py | 19 | src.lanctl.apps.monitor.operations.BoundedRunner.run | raise 0eE829FB9F | 43 | src/lanctl/core/projects/vlf.py | 92 | src.lanctl.core.projects.vlf.create_project | raise +0eE8396DCD | 48 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 283 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.scan_network | raise 0eE86101BB | 36 | src/lanctl/shared/i18n.py | 181 | src.lanctl.shared.i18n.LanguageManager.discover | raise -0eE8A2E3AC | 34 | src/lanctl/apps/access/manager_cli.py | 482 | src.lanctl.apps.access.manager_cli._user_command | raise +0eE8A2E3AC | 34 | src/lanctl/apps/access/manager_cli.py | 458 | src.lanctl.apps.access.manager_cli._user_command | raise 0eE8E4A3F4 | 33 | src/lanctl/core/coordination.py | 147 | src.lanctl.core.coordination.Coordinator.publish | raise -0eE94F4AE1 | 33 | src/lanctl/core/plugins/isolated_runtime.py | 303 | src.lanctl.core.plugins.isolated_runtime._worker | raise +0eE8FFBE9D | 42 | src/lanctl/apps/monitor/gui_service.py | 90 | src.lanctl.apps.monitor.gui_service.MonitorGuiService.incident | raise +0eE94F4AE1 | 33 | src/lanctl/core/plugins/isolated_runtime.py | 306 | src.lanctl.core.plugins.isolated_runtime._worker | raise 0eE96EAA58 | 43 | src/lanctl/core/projects/__init__.py | 44 | src.lanctl.core.projects.__init__.__getattr__ | raise 0eE96EC845 | 36 | src/lanctl/apps/ip/lab/scenario.py | 36 | src.lanctl.apps.ip.lab.scenario.validate_scenario | raise +0eE9927E67 | 42 | src/lanctl/apps/suite/gui.py | 159 | src.lanctl.apps.suite.gui.SuiteApi.install_signed_plugin.operation | raise 0eEA1EBB08 | 42 | src/lanctl/apps/ip/interfaces/gui/main.py | 88 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.select_project_directory.operation | raise +0eEA2B6571 | 42 | src/lanctl/core/activity.py | 28 | src.lanctl.core.activity.ActivityStore._connection | raise 0eEA401CCE | 45 | src/lanctl/apps/ip/domain/discovery.py | 36 | src.lanctl.apps.ip.domain.discovery.require_real_target | raise 0eEA486813 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/group.py | 73 | src.lanctl.apps.ip.interfaces.cli.commands.group.run_group | raise 0eEA6145C7 | 33 | src/lanctl/apps/monitor/configuration.py | 62 | src.lanctl.apps.monitor.configuration.MonitorConfig.__post_init__ | raise @@ -1044,89 +1322,117 @@ 0eEB2ED208 | 46 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 356 | src.lanctl.apps.ip.interfaces.cli.commands.wol._wake | diagnostic 0eEB432B90 | 31 | src/lanctl/apps/wire/cli/commands.py | 379 | src.lanctl.apps.wire.cli.commands.CommandProcessor._add_options | raise 0eEB5FF5C4 | 36 | src/lanctl/apps/access/remote.py | 104 | src.lanctl.apps.access.remote.parse_remote_command | raise -0eEB92D7C4 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 198 | src.lanctl.core.plugins.isolated_runtime._IsolatedApi._call | raise -0eEBBB98CA | 33 | src/lanctl/apps/ip/interfaces/cli/commands/list.py | 260 | src.lanctl.apps.ip.interfaces.cli.commands.list.run_list | raise +0eEB92D7C4 | 47 | src/lanctl/core/plugins/isolated_runtime.py | 199 | src.lanctl.core.plugins.isolated_runtime._IsolatedApi._call | raise +0eEBBB98CA | 33 | src/lanctl/apps/ip/interfaces/cli/commands/list.py | 273 | src.lanctl.apps.ip.interfaces.cli.commands.list.run_list | raise +0eEBE0F7F7 | 47 | src/lanctl/core/plugins/manager.py | 163 | src.lanctl.core.plugins.manager.PluginManager.discover | raise 0eEBEFBBCD | 47 | src/lanctl/core/plugins/smb_runtime.py | 163 | src.lanctl.core.plugins.smb_runtime.SMBNative.shares | raise -0eEC404E18 | 36 | src/lanctl/apps/access/manager_cli.py | 360 | src.lanctl.apps.access.manager_cli._main | raise +0eEC404E18 | 36 | src/lanctl/apps/access/manager_cli.py | 336 | src.lanctl.apps.access.manager_cli._main | raise +0eEC4C6E8D | 14 | src/lanctl/core/plugins/authorization.py | 78 | src.lanctl.core.plugins.authorization.RuntimeAuthorizations.retire.cleanup | diagnostic 0eEC5F65D4 | 36 | src/lanctl/apps/wire/idf/database.py | 152 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.define_prefix | raise -0eEC9D92B7 | 33 | src/lanctl/apps/ip/domain/models/device.py | 306 | src.lanctl.apps.ip.domain.models.device.Device.__setitem__ | raise +0eEC6EC9B8 | 46 | src/lanctl/apps/suite/launcher_gui.py | 327 | src.lanctl.apps.suite.launcher_gui.run_gui.remote_action | raise +0eEC9D92B7 | 33 | src/lanctl/apps/ip/domain/models/device.py | 302 | src.lanctl.apps.ip.domain.models.device.Device.__setitem__ | raise +0eECABE0EE | 33 | src/lanctl/core/plugins/settings.py | 108 | src.lanctl.core.plugins.settings.PluginSettings._document | raise 0eECCE51BE | 42 | src/lanctl/core/coordination.py | 155 | src.lanctl.core.coordination.Coordinator.publish | raise +0eED2CC6F3 | 43 | src/lanctl/core/group_database.py | 247 | src.lanctl.core.group_database.GroupDatabase.create | raise 0eED4E5E56 | 42 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 431 | src.lanctl.apps.ip.interfaces.cli.commands.wol._sequence_locked | raise 0eED68A44D | 42 | src/lanctl/apps/access/service.py | 147 | src.lanctl.apps.access.service.AccessService.enable.operation | raise -0eED9FA6B0 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 422 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0eED6FC226 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py | 97 | src.lanctl.apps.ip.interfaces.cli.commands.settings_menu._set | raise +0eED9FA6B0 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 444 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0eEE0B3D26 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/history.py | 61 | src.lanctl.apps.ip.interfaces.cli.commands.history.run_history | raise 0eEE3CFF08 | 36 | src/lanctl/apps/access/network.py | 14 | src.lanctl.apps.access.network.validate_endpoint | raise 0eEE9AF36D | 33 | src/lanctl/apps/wire/tui/editor.py | 349 | src.lanctl.apps.wire.tui.editor.set_field | raise +0eEE9F681D | 48 | src/lanctl/core/plugins/package.py | 214 | src.lanctl.core.plugins.package.verify_directory | raise 0eEEB12E78 | 36 | src/lanctl/apps/wire/tui/app.py | 1303 | src.lanctl.apps.wire.tui.app.LanwireTui._connect_selected_port | raise 0eEEBD5AEA | 33 | src/lanctl/apps/ip/infrastructure/cisco/planner.py | 42 | src.lanctl.apps.ip.infrastructure.cisco.planner.CiscoPlanner._validate | raise 0eEEC175AD | 36 | src/lanctl/apps/ip/interfaces/tui/keyboard.py | 120 | src.lanctl.apps.ip.interfaces.tui.keyboard.validate_key_bindings | raise 0eEEE04677 | 32 | src/lanctl/apps/ip/interfaces/cli/commands/wol.py | 405 | src.lanctl.apps.ip.interfaces.cli.commands.wol._sequence_locked | raise 0eEF18595E | 36 | src/lanctl/apps/access/auth.py | 55 | src.lanctl.apps.access.auth.fingerprint_key | raise -0eEF33400C | 43 | src/lanctl/core/database.py | 647 | src.lanctl.core.database.DeviceDatabase.add_device | raise -0eEF5505F9 | 45 | src/lanctl/core/plugins/manager.py | 279 | src.lanctl.core.plugins.manager.PluginManager.enable | raise -0eEFB9DBAD | 43 | src/lanctl/core/database.py | 570 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise -0eEFE7E889 | 33 | src/lanctl/apps/ip/interfaces/gui/main.py | 495 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.open_terminal.operation | raise +0eEF33400C | 43 | src/lanctl/core/database.py | 645 | src.lanctl.core.database.DeviceDatabase.add_device | raise +0eEFB9DBAD | 43 | src/lanctl/core/database.py | 568 | src.lanctl.core.database.DeviceDatabase._edit_device_in_memory | raise +0eEFE7E889 | 33 | src/lanctl/apps/ip/interfaces/gui/main.py | 499 | src.lanctl.apps.ip.interfaces.gui.main.GuiApi.open_terminal.operation | raise 0eEFFEAB17 | 33 | src/lanctl/shared/assets/icons.py | 257 | src.lanctl.shared.assets.icons.jpeg_dimensions | raise -0eF02FD890 | 43 | src/lanctl/core/config.py | 567 | src.lanctl.core.config._config_version | raise +0eF02FD890 | 43 | src/lanctl/core/config.py | 586 | src.lanctl.core.config._config_version | raise +0eF0772C48 | 42 | src/lanctl/core/settings_catalog.py | 178 | src.lanctl.core.settings_catalog.validate_value | raise +0eF0923BB2 | 42 | src/lanctl/core/settings_catalog.py | 123 | src.lanctl.core.settings_catalog.validate_value | raise 0eF0CA8F62 | 43 | src/lanctl/core/credentials.py | 95 | src.lanctl.core.credentials.unprotect_secret | raise -0eF10422DA | 36 | src/lanctl/apps/wire/idf/database.py | 388 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise +0eF10422DA | 36 | src/lanctl/apps/wire/idf/database.py | 407 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager._validate_database | raise 0eF1671430 | 37 | src/lanctl/apps/ip/infrastructure/services/network_discovery.py | 24 | src.lanctl.apps.ip.infrastructure.services.network_discovery.discovery_probe | raise 0eF168B902 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/download_settings.py | 127 | src.lanctl.apps.ip.interfaces.cli.commands.download_settings.run_download_settings | raise 0eF1A51AA0 | 47 | src/lanctl/core/plugins/functions.py | 39 | src.lanctl.core.plugins.functions.FunctionRegistry.call | raise 0eF1D329AA | 36 | src/lanctl/apps/wire/cli/commands.py | 132 | src.lanctl.apps.wire.cli.commands.CommandProcessor._parse_data | raise -0eF213E533 | 43 | src/lanctl/core/projects/vlf.py | 411 | src.lanctl.core.projects.vlf.verify_project | raise -0eF2471A57 | 35 | src/lanctl/apps/access/manager_cli.py | 416 | src.lanctl.apps.access.manager_cli._extended_command | raise +0eF213E533 | 43 | src/lanctl/core/projects/vlf.py | 419 | src.lanctl.core.projects.vlf.verify_project | raise +0eF2471A57 | 35 | src/lanctl/apps/access/manager_cli.py | 392 | src.lanctl.apps.access.manager_cli._extended_command | raise +0eF26AF095 | 23 | src/lanctl/core/first_scan.py | 65 | LANCTL.FirstScan.Interfaces | diagnostic +0eF26EF91B | 47 | src/lanctl/core/plugins/manager.py | 841 | src.lanctl.core.plugins.manager.PluginManager._verify_installed | raise 0eF2786D54 | 47 | src/lanctl/core/plugins/smb_runtime.py | 213 | src.lanctl.core.plugins.smb_runtime.SMBNative.connect | raise -0eF2E2EA15 | 48 | src/lanctl/core/plugins/publishers.py | 27 | src.lanctl.core.plugins.publishers.TrustedPublisherStore.trust_package | raise -0eF37C02C1 | 41 | src/lanctl/bootstrap/lanmon.py | 125 | src.lanctl.bootstrap.lanmon.main | return-error +0eF2E2EA15 | 48 | src/lanctl/core/plugins/publishers.py | 29 | src.lanctl.core.plugins.publishers.TrustedPublisherStore.trust_package | raise +0eF37C02C1 | 41 | src/lanctl/bootstrap/lanmon.py | 139 | src.lanctl.bootstrap.lanmon.main | return-error 0eF37CCE2C | 31 | src/lanctl/apps/access/remote.py | 108 | src.lanctl.apps.access.remote.parse_remote_command | raise +0eF3836063 | 34 | src/lanctl/apps/suite/gui_support.py | 156 | LANCTL.GUI.Activity.Log | diagnostic 0eF3A0CAEB | 33 | src/lanctl/apps/access/audit.py | 21 | src.lanctl.apps.access.audit.completed | diagnostic 0eF3BB11D9 | 45 | src/lanctl/apps/monitor/identity.py | 32 | src.lanctl.apps.monitor.identity.IdentityResolver.validate | raise 0eF3CFEA4F | 41 | src/lanctl/core/parser.py | 120 | src.lanctl.core.parser.LANCTLArgumentParser.error | exit +0eF4362BE8 | 43 | src/lanctl/core/plugins/authorization.py | 120 | LANCTL.Plugin.Authorization.Refresh | diagnostic 0eF43DAE28 | 49 | src/lanctl/core/persistence.py | 45 | src.lanctl.core.persistence.create_backup | raise 0eF46E0703 | 31 | src/lanctl/apps/ip/infrastructure/cisco/planner.py | 32 | src.lanctl.apps.ip.infrastructure.cisco.planner.CiscoPlanner._validate | raise +0eF49C96AB | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py | 128 | src.lanctl.apps.ip.interfaces.cli.commands.settings_menu._set | raise 0eF4ABEA28 | 42 | src/lanctl/core/persistence.py | 132 | src.lanctl.core.persistence.verify_export | raise 0eF518A526 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/lab.py | 143 | src.lanctl.apps.ip.interfaces.cli.commands.lab.run_lab | raise 0eF5353140 | 45 | src/lanctl/apps/access/auth.py | 93 | src.lanctl.apps.access.auth.AuthorizationService.require | raise 0eF54C0787 | 33 | src/lanctl/core/paths.py | 106 | src.lanctl.core.paths.secret_root | raise 0eF5802634 | 43 | src/lanctl/core/history.py | 83 | src.lanctl.core.history.HistoryEvent.__post_init__ | raise 0eF5AEDC31 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/smb.py | 183 | src.lanctl.apps.ip.interfaces.cli.commands.smb.run_smb | raise -0eF5B5C754 | 36 | src/lanctl/apps/wire/idf/database.py | 275 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise -0eF6306AB2 | 45 | src/lanctl/core/plugins/api.py | 75 | src.lanctl.core.plugins.api._PluginErrors._origin | raise +0eF5B5C754 | 36 | src/lanctl/apps/wire/idf/database.py | 289 | src.lanctl.apps.wire.idf.database.IDFDatabaseManager.edit_port.edit | raise +0eF5C8715D | 35 | src/lanctl/apps/access/gui_service.py | 83 | src.lanctl.apps.access.gui_service.AccessGuiService.open | raise +0eF6079D06 | 32 | src/lanctl/apps/rack/service.py | 45 | src.lanctl.apps.rack.service.RackService.set_dimensions | raise +0eF6306AB2 | 45 | src/lanctl/core/plugins/api.py | 96 | src.lanctl.core.plugins.api._PluginErrors._origin | raise 0eF684380F | 42 | src/lanctl/core/coordination.py | 225 | src.lanctl.core.coordination.Coordinator.enqueue | raise +0eF718C877 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py | 232 | src.lanctl.apps.ip.interfaces.cli.commands.settings_menu.dispatch_settings | raise 0eF72688B1 | 42 | src/lanctl/apps/monitor/service.py | 230 | src.lanctl.apps.monitor.service.MonitorService._execute_check | raise -0eF7538B40 | 49 | src/lanctl/core/session.py | 207 | src.lanctl.core.session.task | raise +0eF7538B40 | 49 | src/lanctl/core/session.py | 212 | src.lanctl.core.session.task | raise 0eF7EB0227 | 33 | src/lanctl/shared/assets/icons.py | 106 | src.lanctl.shared.assets.icons.IconManager.register | raise 0eF807540F | 36 | src/lanctl/apps/wire/cli/commands.py | 135 | src.lanctl.apps.wire.cli.commands.CommandProcessor._parse_data | raise +0eF80BBC54 | 42 | src/lanctl/core/gui_preferences.py | 25 | src.lanctl.core.gui_preferences.validate_preferences | raise +0eF81C27E7 | 47 | src/lanctl/core/plugins/manager.py | 965 | src.lanctl.core.plugins.manager.PluginManager._ensure_current | raise 0eF825B0AF | 31 | src/lanctl/apps/ip/interfaces/cli/commands/switch.py | 310 | src.lanctl.apps.ip.interfaces.cli.commands.switch.run_switch | raise -0eF82C12F2 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 424 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0eF82C12F2 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 446 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise 0eF8BA08DA | 33 | src/lanctl/shared/assets/icons.py | 110 | src.lanctl.shared.assets.icons.IconManager.register | raise 0eF8BE909D | 33 | src/lanctl/apps/wire/topology.py | 199 | src.lanctl.apps.wire.topology.build_ports | raise 0eF8CB9A3D | 31 | src/lanctl/apps/ip/interfaces/cli/commands/group.py | 68 | src.lanctl.apps.ip.interfaces.cli.commands.group.run_group | raise -0eF8EB85EA | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 92 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.update_device.operation | raise +0eF8EB85EA | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 155 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.update_device.operation | raise 0eF8F702B0 | 34 | src/lanctl/apps/ip/lab/scenario.py | 51 | src.lanctl.apps.ip.lab.scenario.validate_scenario | raise +0eF943F21C | 46 | src/lanctl/apps/access/gui_service.py | 52 | src.lanctl.apps.access.gui_service.AccessGuiService.unlock | raise +0eF965C715 | 33 | src/lanctl/core/projects/settings.py | 185 | src.lanctl.core.projects.settings.project_network_overrides | raise +0eF9B07F9F | 36 | src/lanctl/apps/rack/organization.py | 29 | src.lanctl.apps.rack.organization.organization | raise 0eF9C54124 | 36 | src/lanctl/apps/ip/interfaces/tui/layout.py | 110 | src.lanctl.apps.ip.interfaces.tui.layout.normalize_column_specs | raise -0eF9C6A6E8 | 48 | src/lanctl/core/plugins/package.py | 211 | src.lanctl.core.plugins.package.safe_package | raise -0eF9F97EC1 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 316 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise -0eFA300BC4 | 16 | src/lanctl/core/plugins/builtin.py | 232 | src.lanctl.core.plugins.builtin._install_builtin_theme | diagnostic -0eFA764A49 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 381 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise -0eFA843578 | 36 | src/lanctl/apps/access/manager_cli.py | 321 | src.lanctl.apps.access.manager_cli._main | raise +0eF9C6A6E8 | 48 | src/lanctl/core/plugins/package.py | 259 | src.lanctl.core.plugins.package.safe_package | raise +0eF9F97EC1 | 33 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 338 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0eFA300BC4 | 16 | src/lanctl/core/plugins/builtin.py | 240 | src.lanctl.core.plugins.builtin._install_builtin_theme | diagnostic +0eFA3ACA02 | 36 | src/lanctl/apps/ip/interfaces/gui/desktop.py | 299 | src.lanctl.apps.ip.interfaces.gui.desktop.DesktopApi.scan_network.fail | raise +0eFA622FC4 | 36 | src/lanctl/apps/access/https_server.py | 38 | src.lanctl.apps.access.https_server._session_cookie | raise +0eFA764A49 | 31 | src/lanctl/apps/ip/interfaces/cli/commands/settings.py | 403 | src.lanctl.apps.ip.interfaces.cli.commands.settings.run_settings | raise +0eFA843578 | 36 | src/lanctl/apps/access/manager_cli.py | 293 | src.lanctl.apps.access.manager_cli._main | raise 0eFB5BC68A | 36 | src/lanctl/apps/wire/tui/app.py | 1309 | src.lanctl.apps.wire.tui.app.LanwireTui._connect_selected_port | raise +0eFB83A96A | 32 | src/lanctl/apps/wire/gui_service.py | 129 | src.lanctl.apps.wire.gui_service.WireGuiService.update | raise +0eFBA42CEC | 34 | src/lanctl/apps/suite/gui.py | 113 | LANCTL.Suite.GUI.PluginSettingsRead | diagnostic 0eFBF8DA08 | 47 | src/lanctl/core/plugins/smb_runtime.py | 32 | src.lanctl.core.plugins.smb_runtime.validate_component | raise +0eFC285D7B | 33 | src/lanctl/core/rack_dimensions.py | 17 | src.lanctl.core.rack_dimensions.validate_width | raise 0eFC4C6507 | 42 | src/lanctl/apps/ip/infrastructure/protocols/ssh.py | 277 | src.lanctl.apps.ip.infrastructure.protocols.ssh.run_remote_command | raise +0eFC518DCE | 36 | src/lanctl/apps/access/remote_setup.py | 153 | src.lanctl.apps.access.remote_setup.RemoteSetupApi._respond | raise 0eFCAE1870 | 43 | src/lanctl/core/projects/workspace.py | 209 | src.lanctl.core.projects.workspace.prepare_project_workspace | raise 0eFCCE6809 | 48 | src/lanctl/core/plugins/models.py | 73 | src.lanctl.core.plugins.models.PluginManifest.from_dict | raise 0eFCE7C56E | 33 | src/lanctl/apps/wire/idf/idf.py | 51 | src.lanctl.apps.wire.idf.idf.IDF.__post_init__ | raise 0eFD199768 | 42 | src/lanctl/apps/access/ssh_server.py | 235 | src.lanctl.apps.access.ssh_server.SshAccessServer._execute | diagnostic 0eFD6DA0BA | 33 | src/lanctl/apps/ip/interfaces/cli/commands/download_settings.py | 87 | src.lanctl.apps.ip.interfaces.cli.commands.download_settings.lan_settings | raise 0eFDAB0054 | 45 | src/lanctl/apps/access/remote.py | 91 | src.lanctl.apps.access.remote.required_permission | raise -0eFDD9FF6A | 33 | src/lanctl/apps/monitor/commands.py | 283 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._profile_action | raise +0eFDD9FF6A | 33 | src/lanctl/apps/monitor/commands.py | 289 | src.lanctl.apps.ip.interfaces.cli.commands.monitor._profile_action | raise 0eFDF8FC90 | 36 | src/lanctl/apps/ip/interfaces/tui/layout.py | 122 | src.lanctl.apps.ip.interfaces.tui.layout.normalize_column_spec | raise 0eFE01107E | 33 | src/lanctl/core/history.py | 86 | src.lanctl.core.history.HistoryEvent.__post_init__ | raise 0eFE66512C | 42 | src/lanctl/core/device_retention.py | 101 | src.lanctl.core.device_retention.apply_retention | raise 0eFE759B11 | 37 | src/lanctl/apps/ip/infrastructure/services/element_scanner.py | 163 | src.lanctl.apps.ip.infrastructure.services.element_scanner.parse_ports | raise -0eFF74CCCC | 47 | src/lanctl/core/plugins/isolated_runtime.py | 520 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise -0eFF76FBD4 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 131 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._ordered_hosts | raise +0eFF161761 | 32 | src/lanctl/apps/wire/gui_service.py | 42 | src.lanctl.apps.wire.gui_service.WireGuiService._record | raise +0eFF74CCCC | 47 | src/lanctl/core/plugins/isolated_runtime.py | 532 | src.lanctl.core.plugins.isolated_runtime.IsolatedPluginRuntime.start | raise +0eFF76FBD4 | 37 | src/lanctl/apps/ip/infrastructure/services/lan_scanner.py | 168 | src.lanctl.apps.ip.infrastructure.services.lan_scanner.LanScanner._ordered_hosts | raise 0eFFC4981D | 36 | src/lanctl/apps/ip/infrastructure/cisco/planner.py | 63 | src.lanctl.apps.ip.infrastructure.cisco.planner.CiscoPlanner.plan | raise 0eFFE65362 | 31 | src/lanctl/apps/access/remote.py | 267 | src.lanctl.apps.access.remote.RemoteGuiApi.call | raise 0eFFF1F043 | 33 | src/lanctl/apps/monitor/configuration.py | 137 | src.lanctl.apps.monitor.configuration.validate_profile | raise diff --git a/gui/app-dialogs.js b/gui/app-dialogs.js new file mode 100644 index 0000000..f4fa366 --- /dev/null +++ b/gui/app-dialogs.js @@ -0,0 +1,24 @@ +"use strict"; +// Local presentation only; decisions remain with the calling application. +const appNotice=document.createElement("dialog"); +appNotice.setAttribute("aria-labelledby","app-notice-title"); +appNotice.innerHTML='

LANIP

'; +document.body.append(appNotice); +let appNoticeResolve=null,appNoticePrompt=false; +function appDecision(text,prompt=false){ + if(appNoticeResolve)return Promise.resolve(prompt?null:false); + appNoticePrompt=prompt; + document.querySelector("#app-notice-text").textContent=text; + const input=document.querySelector("#app-notice-value");input.hidden=!prompt;input.value=""; + return new Promise(resolve=>{appNoticeResolve=resolve;appNotice.showModal();(prompt?input:document.querySelector("#app-notice-cancel")).focus();}); +} +function appDecisionFinish(accepted){ + if(!appNoticeResolve)return; + const resolve=appNoticeResolve;appNoticeResolve=null; + const value=appNoticePrompt?(accepted?document.querySelector("#app-notice-value").value:null):accepted; + appNotice.close();resolve(value); +} +document.querySelector("#app-notice-cancel").onclick=()=>appDecisionFinish(false); +document.querySelector("#app-notice-accept").onclick=()=>appDecisionFinish(true); +appNotice.addEventListener("cancel",event=>{event.preventDefault();appDecisionFinish(false);}); +appNotice.addEventListener("keydown",event=>{if(event.key==="Enter"&&appNoticePrompt){event.preventDefault();appDecisionFinish(true);}}); diff --git a/gui/app-preferences.css b/gui/app-preferences.css new file mode 100644 index 0000000..bb3ecd0 --- /dev/null +++ b/gui/app-preferences.css @@ -0,0 +1,306 @@ +.gui-preferences-active { + color-scheme: dark; + --gui-font-scale: 1; +} +.gui-preferences-active body { + color: var(--color-text); + background: var(--color-background); +} +.gui-preferences-active header, +.gui-preferences-active .controls, +.gui-preferences-active footer { + background: color-mix(in srgb, var(--color-background), #000 12%); +} +.gui-preferences-active dialog, +.gui-preferences-active .panel, +.gui-preferences-active .launch, +.gui-preferences-active .terminal header { + background: var(--color-surface); + color: var(--color-text); + border-color: var(--color-border); +} +.gui-preferences-active input, +.gui-preferences-active select, +.gui-preferences-active textarea, +.gui-preferences-active pre { + background: var(--color-background); + color: var(--color-text); + border-color: var(--color-border); +} +.gui-preferences-active button { + color: var(--color-text); +} +.gui-preferences-active button.primary { + background: var(--color-accent); + border-color: var(--color-accent); + color: var(--gui-primary-ink, #182105) !important; +} +.gui-preferences-active nav button.active { + background: color-mix(in srgb, var(--color-accent) 15%, var(--color-surface)); + color: var(--color-accent); +} +.gui-preferences-active + :is(p, label, td, th, button, input, select, textarea, dt, dd) { + font-size: calc(12px * var(--gui-font-scale)); +} +.gui-preferences-active footer :is(button, span) { + font-size: calc(11px * var(--gui-font-scale)); +} +.gui-preferences-active footer { + height: auto; + min-height: 32px; + flex-wrap: wrap; + gap: 8px; +} +.gui-preferences-active footer > span { + flex-wrap: wrap; + gap: 8px; +} +.gui-preferences-active .app-shell { + grid-template-rows: auto minmax(0, 1fr) auto; +} +.gui-preferences-active[data-density="compact"] :is(main, .content) { + padding: 10px; +} +.gui-preferences-active[data-density="compact"] :is(td, .panel, .launch) { + padding-top: 8px; + padding-bottom: 8px; +} +.gui-preferences-active[data-reduced-motion="true"] * { + animation: none !important; + transition: none !important; + scroll-behavior: auto !important; +} +.preferences-dialog { + width: min(660px, calc(100vw - 28px)); + max-height: calc(100dvh - 28px); + overflow: auto; + background: var(--color-surface); + color: var(--color-text); + border: 1px solid var(--color-border); + border-radius: 12px; + padding: 22px; +} +.preferences-dialog::backdrop { + background: #0008; +} +.preferences-dialog form { + display: grid; + gap: 16px; +} +.preferences-dialog h2, +.preferences-dialog p { + margin: 0; +} +.preferences-dialog label { + display: grid; + gap: 6px; +} +.preferences-dialog label.check { + display: flex; + align-items: center; + gap: 8px; +} +.preferences-dialog .actions { + display: flex; + gap: 8px; + justify-content: flex-end; + flex-wrap: wrap; +} +.theme-choices { + display: grid; + grid-template-columns: repeat(auto-fit, minmax(135px, 1fr)); + gap: 10px; +} +.theme-choices button { + display: grid; + gap: 8px; + text-align: left; + border: 1px solid var(--color-border); + padding: 12px; + border-radius: 8px; + background: var(--color-background); +} +.theme-choices button[aria-pressed="true"] { + outline: 2px solid var(--color-accent); + outline-offset: 1px; +} +.theme-swatches { + display: flex; + height: 30px; + border-radius: 5px; + overflow: hidden; + border: 1px solid var(--color-border); +} +.theme-swatches i { + flex: 1; +} +.preferences-feedback { + color: var(--color-danger); +} +.support-dialog { + width: min(740px, calc(100vw - 28px)); + max-height: calc(100dvh - 28px); + overflow: auto; + background: var(--color-surface); + color: var(--color-text); + border: 1px solid var(--color-border); + border-radius: 12px; + padding: 22px; +} +.support-dialog::backdrop { + background: #0008; +} +.support-dialog h2 { + margin: 0 0 16px; +} +.support-dialog p { + overflow-wrap: anywhere; +} +.support-dialog pre { + white-space: pre-wrap; + overflow-wrap: anywhere; + max-height: 40dvh; + overflow: auto; + padding: 12px; + border-radius: 7px; + background: var(--color-background); +} +.support-dialog a, +.support-dialog summary { + color: var(--color-accent); +} +.support-dialog .actions { + display: flex; + gap: 8px; + justify-content: flex-end; + flex-wrap: wrap; + margin-top: 18px; +} +.support-dialog button { + padding: 8px 12px; + border: 1px solid var(--color-border); + border-radius: 7px; + background: var(--color-surface); + color: var(--color-text); + cursor: pointer; +} +.support-dialog button.primary { + background: var(--color-accent); + color: var(--gui-primary-ink, #182105) !important; +} +.report-dialog form { + display: grid; + gap: 14px; +} +.report-dialog label { + display: grid; + gap: 6px; +} +.report-dialog textarea { + width: 100%; + resize: vertical; + padding: 8px; + font: inherit; +} +.report-dialog fieldset { + border: 1px solid var(--color-border); + border-radius: 8px; + display: grid; + gap: 10px; +} +.report-dialog fieldset label { + display: flex; + gap: 8px; + align-items: center; +} +.monitor-evidence { + height: 100%; + min-height: 0; + display: flex; + flex-direction: column; + gap: 12px; +} +.monitor-filters { + display: flex; + gap: 12px; + flex-wrap: wrap; + align-items: end; +} +.monitor-filters label { + display: grid; + gap: 5px; +} +.monitor-filters label.check { + display: flex; + align-items: center; + align-self: center; +} +#monitor-evidence { + flex: 1; + min-height: 0; + overflow: auto; + border: 1px solid var(--color-border); + border-radius: 9px; + padding: 12px; + background: var(--color-background); +} +#monitor-evidence article { + padding: 10px 0; + border-bottom: 1px solid var(--color-border); +} +#monitor-evidence small { + color: var(--color-text-muted); + overflow-wrap: anywhere; +} +#monitor-evidence pre { + margin: 6px 0 0; + white-space: pre-wrap; + overflow-wrap: anywhere; +} +.first-scan-dialog form { + display: grid; + gap: 14px; +} +.first-scan-dialog label { + display: grid; + gap: 6px; +} +.first-scan-dialog input, +.first-scan-dialog select { + padding: 8px; + border: 1px solid var(--color-border); + border-radius: 7px; + font: inherit; +} +.first-scan-error { + color: var(--color-danger); +} +.panel .plugin-runtime-warning { + border-left: 3px solid var(--color-warning); + padding: 8px 12px; + color: var(--color-text); + background: var(--color-background); +} +.statusbar { + height: auto; + min-height: 32px; + grid-template-columns: minmax(0, 1fr) minmax(0, 1fr) auto; +} +.statusbar > span:first-child { + flex-wrap: wrap; + white-space: normal; +} +@media (max-width: 850px) { + .statusbar { + grid-template-columns: minmax(0, 1fr) auto; + } +} +@media (max-width: 480px) { + .statusbar { + grid-template-columns: minmax(0, 1fr); + } + .statusbar > span:last-child { + text-align: left; + } +} diff --git a/gui/app-preferences.js b/gui/app-preferences.js new file mode 100644 index 0000000..b279916 --- /dev/null +++ b/gui/app-preferences.js @@ -0,0 +1,225 @@ +"use strict"; + +// Shared native desktop presentation. Preferences are validated and stored by Core. +(() => { + if (/^https?:$/.test(window.location.protocol)) return; + const rpc = async (method, ...args) => { + const result = await window.pywebview.api[method](...args); + if (!result.ok) + throw new Error(result.error || "No se pudo completar la operación"); + return result; + }; + let saved = null, + editing = false, + reading = false; + const componentStyles = new Map(); + const aliases = { + "--color-background": "--bg", + "--color-surface": "--surface", + "--color-border": "--line", + "--color-text": "--text", + "--color-text-muted": "--muted", + "--color-accent": "--lime", + }; + function apply(payload, preferences = payload.preferences) { + const root = document.documentElement; + const selected = payload.themes.find((t) => t.id === preferences.theme); + const theme = + preferences === payload.preferences + ? payload.theme + : { + ...selected, + tokens: { ...selected.tokens, ...payload.theme.pluginTokens }, + components: + payload.theme.pluginComponents || payload.theme.components, + }; + for (const [key, value] of Object.entries(theme?.tokens || {})) { + root.style.setProperty(key, value); + if (aliases[key]) root.style.setProperty(aliases[key], value); + } + root.dataset.density = preferences.density; + const rgb = (key) => + (root.style.getPropertyValue(key).match(/[a-f0-9]{2}/gi) || []) + .slice(0, 3) + .map((c) => parseInt(c, 16)); + const brightness = (color) => + color.length === 3 + ? color[0] * 0.299 + color[1] * 0.587 + color[2] * 0.114 + : 0; + root.style.colorScheme = + brightness(rgb("--color-background")) > 150 ? "light" : "dark"; + root.style.setProperty( + "--gui-primary-ink", + rgb("--color-accent").reduce((sum, value, index) => { + const channel = value / 255; + return ( + sum + + [0.2126, 0.7152, 0.0722][index] * + (channel <= 0.04045 + ? channel / 12.92 + : ((channel + 0.055) / 1.055) ** 2.4) + ); + }, 0) > 0.179 + ? "#101810" + : "#ffffff", + ); + for (const [element, keys] of componentStyles) + for (const key of keys) element.style.removeProperty(key); + componentStyles.clear(); + for (const [id, tokens] of Object.entries(theme.components || {})) { + document + .querySelectorAll(`[data-component-id="${id}"]`) + .forEach((element) => { + componentStyles.set(element, new Set(Object.keys(tokens))); + for (const [key, value] of Object.entries(tokens)) + element.style.setProperty(key, value); + }); + } + root.dataset.reducedMotion = String(preferences.reducedMotion); + root.style.setProperty("--gui-font-scale", preferences.fontScale); + root.classList.add("gui-preferences-active"); + } + const dialog = document.createElement("dialog"); + dialog.className = "preferences-dialog"; + dialog.setAttribute("aria-label", "Apariencia de la interfaz"); + dialog.innerHTML = `

Apariencia

Vista previa en esta ventana. Aplicar guarda la selección para toda la suite.

+
+ + + +

`; + document.body.append(dialog); + let draft; + function preview() { + const form = dialog.querySelector("form"); + draft.density = form.elements.density.value; + draft.fontScale = Number(form.elements.fontScale.value); + draft.reducedMotion = form.elements.reducedMotion.checked; + apply(saved, draft); + dialog + .querySelectorAll("[data-theme]") + .forEach((b) => + b.setAttribute("aria-pressed", String(b.dataset.theme === draft.theme)), + ); + } + function fill() { + const form = dialog.querySelector("form"); + form.elements.density.value = draft.density; + if ( + ![...form.elements.fontScale.options].some( + (option) => option.value === String(draft.fontScale), + ) + ) + form.elements.fontScale.add( + new Option( + Math.round(draft.fontScale * 100) + " %", + String(draft.fontScale), + ), + ); + form.elements.fontScale.value = String(draft.fontScale); + form.elements.reducedMotion.checked = draft.reducedMotion; + preview(); + } + function cancel() { + if (saved) apply(saved); + editing = false; + dialog.close(); + } + async function open() { + saved = await rpc("gui_preferences"); + draft = { ...saved.preferences }; + editing = true; + const choices = dialog.querySelector(".theme-choices"); + choices.replaceChildren(); + for (const theme of saved.themes) { + const button = document.createElement("button"); + button.type = "button"; + button.dataset.theme = theme.id; + button.textContent = theme.name; + const swatches = document.createElement("span"); + swatches.className = "theme-swatches"; + swatches.setAttribute("aria-hidden", "true"); + for (const token of [ + "--color-background", + "--color-surface", + "--color-accent", + ]) { + const swatch = document.createElement("i"); + swatch.style.backgroundColor = theme.tokens[token]; + swatches.append(swatch); + } + button.prepend(swatches); + button.onclick = () => { + draft.theme = theme.id; + preview(); + }; + choices.append(button); + } + dialog.querySelector(".preferences-feedback").textContent = + saved.effectivePlugin + ? "El plugin " + + saved.effectivePlugin + + " amplía la paleta seleccionada." + : ""; + fill(); + dialog.showModal(); + } + dialog.addEventListener("change", preview); + dialog.addEventListener("cancel", (event) => { + event.preventDefault(); + cancel(); + }); + dialog.querySelector('[data-preference="cancel"]').onclick = cancel; + dialog.querySelector('[data-preference="reset"]').onclick = () => { + draft = { + theme: "graphite", + density: "comfortable", + fontScale: 1, + reducedMotion: false, + }; + fill(); + }; + dialog.querySelector("form").onsubmit = async (event) => { + event.preventDefault(); + const submit = dialog.querySelector('[type="submit"]'); + submit.disabled = true; + try { + saved = await rpc("save_gui_preferences", draft); + apply(saved); + editing = false; + dialog.close(); + } catch (error) { + dialog.querySelector(".preferences-feedback").textContent = error.message; + } finally { + submit.disabled = false; + } + }; + const button = document.createElement("button"); + button.type = "button"; + button.id = "gui-appearance"; + button.hidden = true; + button.textContent = "Apariencia"; + button.onclick = () => + open().catch((error) => { + if (typeof message === "function") message(error.message, true); + }); + const footer = document.querySelector("footer > div, footer > span"); + footer?.append(button); + async function sync() { + if (editing || reading || !window.pywebview?.api.gui_preferences) return; + reading = true; + try { + const result = await rpc("gui_preferences"); + button.hidden = false; + saved = result; + apply(result); + } catch (error) { + console.warn("Preferencias GUI:", error.message); + } finally { + reading = false; + } + } + window.addEventListener("pywebviewready", sync); + setInterval(sync, 3000); + window.guiAppearance = { open, sync }; +})(); diff --git a/gui/app-support.js b/gui/app-support.js new file mode 100644 index 0000000..08538b6 --- /dev/null +++ b/gui/app-support.js @@ -0,0 +1,284 @@ +"use strict"; + +(() => { + if (/^https?:$/.test(window.location.protocol)) return; + const api = async (method, ...args) => { + const result = await window.pywebview.api[method](...args); + if (!result.ok) { + throw Object.assign( + new Error(result.error || "No se pudo completar la operación"), + { errorDetails: result.errorDetails }, + ); + } + return result; + }; + const footer = document.querySelector("footer > div, footer > span"); + function footerButton(id, label, click) { + const button = document.createElement("button"); + button.type = "button"; + button.id = id; + button.textContent = label; + button.hidden = true; + button.onclick = () => + Promise.resolve(click()).catch((error) => message(error.message, true)); + footer?.append(button); + window.addEventListener("pywebviewready", () => { + button.hidden = + id === "live-logs" + ? !window.pywebview?.api.open_live_logs + : !window.pywebview?.api.open_monitor; + }); + return button; + } + const queue = []; + let transmission = null; + function flush() { + if (transmission) return transmission; + if (!window.pywebview?.api.record_activity) return Promise.resolve(); + transmission = (async () => { + try { + while (queue.length) { + const item = queue[0]; + const result = await api( + "record_activity", + item.text, + item.level, + item.details, + ); + if (result.loggingWarning) notify(result.loggingWarning); + if (queue[0] === item) queue.shift(); + } + } catch (error) { + console.warn("Actividad pendiente de enviar a LANMON:", error.message); + } + })().finally(() => { + transmission = null; + }); + return transmission; + } + const notice = document.createElement("dialog"); + notice.className = "support-dialog"; + notice.setAttribute("aria-labelledby", "support-error-title"); + notice.innerHTML = `

No se ha completado la operación

Ver detalles
`; + document.body.append(notice); + let lastError = "", + repeats = 0, + lastTime = 0; + notice.querySelector('[data-error="close"]').onclick = () => notice.close(); + notice.querySelector('[data-error="report"]').onclick = async () => { + notice.close(); + try { + await openMonitor("report"); + } catch (error) { + message(error.message, true); + } + }; + function notify(text, details = null) { + const repeated = text === lastError && Date.now() - lastTime < 60000; + lastError = text; + lastTime = Date.now(); + repeats = repeated ? repeats + 1 : 1; + notice.querySelector(".support-error-summary").textContent = + text.slice(0, 260) + (repeats > 1 ? ` · Repetido ${repeats} veces` : ""); + notice.querySelector(".support-error-details").textContent = + text + + (details + ? "\n\n" + + [ + ["Origen", details.origin], + ["Código", details.code], + ["ID", details.errorId], + ] + .filter(([, value]) => value) + .map(([label, value]) => label + ": " + value) + .join("\n") + : ""); + if (!notice.open && !repeated) notice.showModal(); + } + let handledError = "", + handledAt = 0; + function record(text, error, details = null) { + queue.push({ + text: String(text).slice(0, 4096), + level: error ? 43 : 20, + details, + }); + if (queue.length > 100) queue.shift(); + flush(); + } + if (typeof call === "function") { + const originalCall = call; + call = async function (...args) { + try { + if (args[0] === "request_close") await flush(); + return await originalCall(...args); + } catch (error) { + handledError = error.message; + handledAt = Date.now(); + record(error.message, true, error.errorDetails); + notify(error.message, error.errorDetails); + throw error; + } + }; + } + if (typeof message === "function") { + const original = message; + message = function (text, error = false) { + original(text, error); + const alreadyHandled = + error && String(text) === handledError && Date.now() - handledAt < 1000; + if (text && !alreadyHandled) record(text, error); + if (error && text && !alreadyHandled) notify(String(text)); + }; + } + async function openMonitor(view) { + await flush(); + if (queue.length) + throw new Error( + "No se ha podido conservar la actividad. Reintenta antes de abrir el reporte.", + ); + if (window.openLanmonView) return window.openLanmonView(view); + return api("open_monitor", view); + } + footerButton("report-bug", "Report a bug", () => openMonitor("report")); + if (document.querySelector("#lanip-cli")) + footerButton("live-logs", "Registros", () => api("open_live_logs")); + document.addEventListener( + "click", + (event) => { + const button = event.target.closest("button"); + if (!button) return; + if (button.id === "activity") { + event.stopImmediatePropagation(); + openMonitor("activity").catch((error) => message(error.message, true)); + } + if (button.dataset.officialLink) { + event.stopImmediatePropagation(); + api("open_official_link", button.dataset.officialLink) + .then((result) => { + if (!result.opened) + message("No se pudo abrir el navegador. " + result.url, true); + }) + .catch((error) => message(error.message, true)); + } + if (button.dataset.support === "appearance") { + event.stopImmediatePropagation(); + window.guiAppearance + .open() + .catch((error) => message(error.message, true)); + } + if (button.dataset.support === "updates") { + event.stopImmediatePropagation(); + showUpdates(); + } + }, + true, + ); + const updates = document.createElement("dialog"); + updates.className = "support-dialog"; + updates.setAttribute("aria-label", "Actualizaciones"); + updates.innerHTML = `

Actualizaciones

`; + document.body.append(updates); + let latestUpdate = null, + updateReading = false, + announcedVersion = null; + updates.querySelector(".update-link").onclick = (event) => { + event.preventDefault(); + api("open_update_release").catch((error) => { + updates.querySelector(".update-state").textContent = error.message; + }); + }; + updates.querySelector('[data-update="close"]').onclick = () => + updates.close(); + updates.querySelector('[data-update="later"]').onclick = async () => { + try { + await api("remind_update_later", latestUpdate.available); + updates.close(); + } catch (error) { + updates.querySelector(".update-state").textContent = error.message; + } + }; + function updateView(result) { + latestUpdate = result; + updates.querySelector(".update-state").textContent = + { + idle: "Pulsa Buscar actualizaciones para consultar versiones estables.", + checking: "Buscando versiones estables…", + current: "La versión instalada está al día.", + available: "Hay una versión estable superior disponible.", + unavailable: + "No se pudo consultar GitHub. Puedes reintentarlo más tarde.", + }[result.status] || + result.error || + "Consulta finalizada."; + const versions = updates.querySelector(".update-versions"); + versions.replaceChildren(); + for (const [label, value] of [ + ["Instalada", result.installed], + ["Disponible", result.available], + ]) + if (value) { + const dt = document.createElement("dt"), + dd = document.createElement("dd"); + dt.textContent = label; + dd.textContent = value; + versions.append(dt, dd); + } + updates.querySelector(".update-notes").textContent = result.notes || ""; + const link = updates.querySelector(".update-link"); + link.hidden = !/^https:\/\/github\.com\/CctrGy\/LANCTL\/releases\//i.test( + result.url || "", + ); + if (!link.hidden) link.href = result.url; + updates.querySelector('[data-update="later"]').hidden = + result.status !== "available"; + updates.querySelector('[data-update="check"]').disabled = + result.status === "checking"; + } + async function checkUpdates(manual) { + try { + updateView(await api("check_updates", manual)); + } catch (error) { + updateView({ status: "unavailable", error: error.message }); + } + } + function showUpdates() { + if (!updates.open) updates.showModal(); + if (latestUpdate) updateView(latestUpdate); + checkUpdates(true); + } + updates.querySelector('[data-update="check"]').onclick = () => + checkUpdates(true); + async function pollUpdate() { + if ( + updateReading || + !window.pywebview?.api.update_status || + !document.querySelector("#external-cli") + ) + return; + updateReading = true; + try { + const result = await api("update_status"); + updateView(result); + if ( + result.status === "available" && + !result.deferred && + announcedVersion !== result.available + ) { + announcedVersion = result.available; + if (!updates.open) updates.showModal(); + } + } catch (error) { + console.warn("Actualizaciones:", error.message); + } finally { + updateReading = false; + } + } + window.addEventListener("pywebviewready", () => { + flush(); + if (document.querySelector("#external-cli")) checkUpdates(false); + }); + setInterval(flush, 3000); + setInterval(pollUpdate, 2000); + window.guiActivityFlush = flush; +})(); diff --git a/gui/app.js b/gui/app.js index c2e6d94..fbd82c5 100644 --- a/gui/app.js +++ b/gui/app.js @@ -7,8 +7,8 @@ const columns=["state","icon","ip","latency","cnf","alias","mac","name","vendor" function applyTheme(theme){Object.entries(theme.tokens||{}).forEach(([n,v])=>document.documentElement.style.setProperty(n,v));Object.entries(theme.components||{}).forEach(([id,tokens])=>document.querySelectorAll(`[data-component-id="${id}"]`).forEach(el=>Object.entries(tokens).forEach(([n,v])=>el.style.setProperty(n,v))));} function message(text,error=false){const el=$("#status-message");el.textContent=text;el.classList.toggle("error-text",error)} function renderEditHistory(history={}){state.editHistory=history;const undo=$("#undo-edit"),redo=$("#redo-edit");undo.disabled=!history.canUndo;redo.disabled=!history.canRedo;undo.title=history.canUndo?`Deshacer ${history.undoLabel} (Ctrl+Z)`:"No hay ediciones que deshacer";redo.title=history.canRedo?`Rehacer ${history.redoLabel} (Ctrl+Y)`:"No hay ediciones que rehacer"} -function setBusy(busy,text="Procesando…"){document.body.classList.toggle("busy",busy);document.body.classList.toggle("scan-running",busy&&text.includes("Escaneando"));document.querySelectorAll("button").forEach(button=>button.disabled=busy);if(busy)message(text);else renderEditHistory(state.editHistory)} -async function call(method,...args){const fn=window.pywebview?.api?.[method];if(!fn)throw new Error("La API de LANCTL no está disponible");const response=await fn(...args);if(!response.ok)throw new Error(response.error||"Error desconocido del núcleo");if(response.editHistory)renderEditHistory(response.editHistory);return response} +function setBusy(busy,text="Procesando…"){document.body.classList.toggle("busy",busy);document.body.classList.toggle("scan-running",busy&&text.includes("Escaneando"));document.querySelectorAll("button").forEach(button=>{if(!button.closest(".support-dialog,.preferences-dialog")&&!["report-bug","live-logs","gui-appearance"].includes(button.id))button.disabled=busy});if(busy)message(text);else renderEditHistory(state.editHistory)} +async function call(method,...args){const fn=window.pywebview?.api?.[method];if(!fn)throw new Error("La API de LANCTL no está disponible");const response=await fn(...args);if(!response.ok)throw Object.assign(new Error(response.error||"Error desconocido del núcleo"),{errorDetails:response.errorDetails});if(response.editHistory)renderEditHistory(response.editHistory);return response} function relativeDate(value){if(!value)return"Nunca";const date=new Date(value);if(Number.isNaN(date.getTime()))return value;const minutes=Math.max(0,Math.round((Date.now()-date.getTime())/60000));if(minutes<1)return"Ahora";if(minutes<60)return`Hace ${minutes} min`;if(minutes<1440)return`Hace ${Math.round(minutes/60)} h`;return`Hace ${Math.round(minutes/1440)} d`} function iconFor(id){return state.icons.find(icon=>icon.id===id)||state.icons.find(icon=>icon.id==="device.generic")} function cnfIcon(value){const span=document.createElement("span");const map={O:["cnf-o","○","Círculo · confirmado"],X:["cnf-x","×","Cruz · desconocido"],S:["cnf-select","","Select · marcado"],F:["cnf-fixed","","Fixed · selección fijada"],"@":["cnf-local","@","Equipo local desde el que se monitoriza la LAN"],"-":["cnf-unrecognized","−","No reconocido"]};const spec=map[value]||map["-"];span.className=`cnf-icon ${spec[0]}`;span.textContent=spec[1];span.title=spec[2];span.setAttribute("aria-label",spec[2]);return span} @@ -18,7 +18,7 @@ function selectDevice(id){state.selectedId=id;document.querySelectorAll("#device function contextDevice(){return state.devices.find(device=>device.id===$("#device-context-menu").dataset.deviceId)} function closeDeviceContextMenu(){const menu=$("#device-context-menu");menu.hidden=true;delete menu.dataset.deviceId} function openDeviceContextMenu(event,id){event.preventDefault();selectDevice(id);const menu=$("#device-context-menu"),device=state.devices.find(item=>item.id===id);if(!device)return;menu.dataset.deviceId=id;menu.querySelector('[data-context-action="wake"]').disabled=!device.wolAvailable;menu.hidden=false;const margin=8,width=menu.offsetWidth,height=menu.offsetHeight;menu.style.left=`${Math.max(margin,Math.min(event.clientX,window.innerWidth-width-margin))}px`;menu.style.top=`${Math.max(margin,Math.min(event.clientY,window.innerHeight-height-margin))}px`;menu.querySelector('button:not([disabled]):not([hidden])')?.focus()} -async function deleteContextDevice(device){const label=device.alias||device.name||device.ip||device.mac;if(!confirm(`¿Eliminar completamente ${label} (${device.mac||"sin MAC"})?\n\nTambién se retirará de todos sus grupos.`))return;setBusy(true,"Eliminando elemento…");try{const payload=await call("delete_device",device.id,true);if(state.selectedId===payload.deletedId)clearSelected();renderInventory(payload);message(payload.message)}catch(error){message(error.message,true)}finally{setBusy(false)}} +async function deleteContextDevice(device){const label=device.alias||device.name||device.ip||device.mac;if(!await appDecision(`¿Eliminar completamente ${label} (${device.mac||"sin MAC"})?\n\nTambién se retirará de todos sus grupos.`))return;setBusy(true,"Eliminando elemento…");try{const payload=await call("delete_device",device.id,true);if(state.selectedId===payload.deletedId)clearSelected();renderInventory(payload);message(payload.message)}catch(error){message(error.message,true)}finally{setBusy(false)}} async function runDeviceContextAction(action){const device=contextDevice();closeDeviceContextMenu();if(!device)return;switch(action){case"select":selectDevice(device.id);document.querySelector(`tr[data-device-id="${device.id}"]`)?.scrollIntoView({block:"nearest"});break;case"details":await showDeviceDetails(device.id);break;case"reload":await refresh($("#device-search").value);break;case"diagnose":selectDevice(device.id);$("#diagnose-device").click();break;case"open":selectDevice(device.id);$("#open-device").click();break;case"terminal":selectDevice(device.id);$("#open-terminal").click();break;case"wake":selectDevice(device.id);$("#wake-device").click();break;case"delete":await deleteContextDevice(device);break}} function addDetailField(container,label,value){const box=document.createElement("div"),term=document.createElement("dt"),detail=document.createElement("dd");term.textContent=label;detail.textContent=value||"-";box.append(term,detail);container.append(box)} async function openService(id,service,port){try{const payload=await call("open_service",id,service,port);message(payload.message)}catch(error){message(error.message,true)}} @@ -46,7 +46,7 @@ function renderPluginData(data){state.pluginItems=data.items||[];const metrics=$ function renderPluginRows(items){const body=$("#plugin-rows");body.replaceChildren();const columns=state.pluginPanel.columns||[];items.forEach(item=>{const row=document.createElement("tr");columns.forEach(column=>{const cell=document.createElement("td");cell.textContent=item[column.field]??"-";row.append(cell)});row.addEventListener("click",()=>{state.pluginSelected=item;document.querySelectorAll("#plugin-rows tr").forEach(x=>x.classList.remove("selected"));row.classList.add("selected");renderPluginDetail(item)});body.append(row)});const empty=$("#plugin-empty");empty.textContent=state.pluginPanel.emptyState?.description||"No hay datos";empty.hidden=items.length>0} function renderPluginDetail(item){const detail=$("#plugin-detail");detail.replaceChildren();const title=document.createElement("h2");title.textContent=item.name||item.server||"Recurso";detail.append(title);const list=document.createElement("dl");[["Tipo",item.type],["Ruta",item.path],["Estado",item.state],["Servidor",item.server],["Acceso",item.access]].forEach(([label,value])=>{const box=document.createElement("div"),dt=document.createElement("dt"),dd=document.createElement("dd");dt.textContent=label;dd.textContent=value||"-";box.append(dt,dd);list.append(box)});detail.append(list);const server=document.createElement("button");server.textContent="Ver servidor";server.addEventListener("click",showResourceServer);detail.append(server);renderPluginActions(state.pluginPanel.actions.filter(a=>a.placement==="detail"),detail)} function showResourceServer(){const id=state.pluginSelected?.deviceId;if(!id)return;setView("devices");selectDevice(id);document.querySelector(`tr[data-device-id="${id}"]`)?.scrollIntoView({block:"center"})} -function renderPluginActions(actions,host){host.querySelectorAll("button").forEach(button=>button.remove());actions.forEach(action=>{const button=document.createElement("button");button.textContent=action.label;button.addEventListener("click",async()=>{const confirmed=!action.confirmation||confirm(action.confirmation);if(!confirmed)return;try{const payload=await call("plugin_action",action.id,{itemId:state.pluginSelected?.id,confirmed});message(payload.result.message||"Acción completada",!payload.result.success);if(action.id.includes("scan"))await showPluginPanel(state.pluginPanel.id,{})}catch(error){message(error.message,true)}});host.append(button)})} +function renderPluginActions(actions,host){host.querySelectorAll("button").forEach(button=>button.remove());actions.forEach(action=>{const button=document.createElement("button");button.textContent=action.label;button.addEventListener("click",async()=>{const confirmed=!action.confirmation||await appDecision(action.confirmation);if(!confirmed)return;try{const payload=await call("plugin_action",action.id,{itemId:state.pluginSelected?.id,confirmed});message(payload.result.message||"Acción completada",!payload.result.success);if(action.id.includes("scan"))await showPluginPanel(state.pluginPanel.id,{})}catch(error){message(error.message,true)}});host.append(button)})} $("#plugin-search").addEventListener("input",event=>{const query=event.target.value.toLocaleLowerCase();renderPluginRows(state.pluginItems.filter(item=>Object.values(item).some(value=>typeof value==="string"&&value.toLocaleLowerCase().includes(query))))});document.querySelectorAll(".main-navigation button[data-panel]").forEach(button=>button.addEventListener("click",()=>button.dataset.panel==="activity"?showActivity():setView(button.dataset.panel))); $("#refresh-devices").addEventListener("click",()=>refresh($("#device-search").value));let searchTimer;$("#device-search").addEventListener("input",event=>{clearTimeout(searchTimer);searchTimer=setTimeout(()=>refresh(event.target.value),180)}); @@ -57,7 +57,7 @@ $("#device-context-menu").addEventListener("click",event=>{const button=event.ta document.addEventListener("pointerdown",event=>{if(!event.target.closest("#device-context-menu"))closeDeviceContextMenu()}); document.addEventListener("scroll",closeDeviceContextMenu,true); window.addEventListener("resize",closeDeviceContextMenu); -$("#scan-network").addEventListener("click",async()=>{if(!confirm("¿Iniciar un escaneo normal de la red autorizada?"))return;setBusy(true,"Escaneando la red LAN…");try{const payload=await call("scan_network","normal");renderInventory(payload);message(payload.message)}catch(error){message(error.message,true)}finally{setBusy(false)}}); +$("#scan-network").addEventListener("click",async()=>{setBusy(true,"Escaneando la red LAN…");try{const payload=await call("scan_network","normal");renderInventory(payload);message(payload.message)}catch(error){message(error.message,true)}finally{setBusy(false)}}); $("#save-device").addEventListener("click",async()=>{if(!state.selectedId)return message("Selecciona un elemento",true);setBusy(true,"Guardando cambios…");try{const payload=await call("update_device",state.selectedId,{name:$("#edit-name").value,alias:$("#edit-alias").value,description:$("#edit-description").value,icon:$("#edit-icon").value});renderInventory(payload);message(payload.message)}catch(error){message(error.message,true)}finally{setBusy(false)}}); $("#diagnose-device").addEventListener("click",async()=>{if(!state.selectedId)return message("Selecciona un elemento",true);setBusy(true,"Diagnosticando y detectando protocolos…");try{const {diagnostic}=await call("diagnose_device",state.selectedId);const ports=diagnostic.open_ports.map(port=>`${port.port}/${port.service}${port.product?` · ${port.product}`:""}`).join("\n")||"Ningún puerto habitual abierto";const output=$("#diagnostic-output");output.textContent=`${diagnostic.reachable?"ACTIVO":"NO DETECTADO"}\nLatencia: ${diagnostic.latency_ms??"-"} ms\nHostname: ${diagnostic.hostname||"-"}\nProtocolos: ${(diagnostic.detected_protocols||[]).join(", ")||"-"}\n\n${ports}`;output.hidden=false;await refresh($("#device-search").value);message("Diagnóstico y protocolos actualizados")}catch(error){message(error.message,true)}finally{setBusy(false)}}); $("#show-details").addEventListener("click",()=>showDeviceDetails()); @@ -71,7 +71,7 @@ $("#project-select").addEventListener("change",async event=>{if(!event.target.va $("#project-open").addEventListener("click",async()=>{try{const selected=await call("select_project_file");if(!selected.path)return;setBusy(true,"Cargando proyecto…");const payload=await call("use_project",selected.path);renderProjects(payload);renderInventory(payload);message(payload.message)}catch(error){message(error.message,true)}finally{setBusy(false)}}); $("#activity-refresh").addEventListener("click",showActivity); $("#project-save").addEventListener("click",async()=>{setBusy(true,"Guardando proyecto…");try{const payload=await call("save_project");renderProjects(payload);renderInventory(payload);message(payload.message)}catch(error){message(error.message,true)}finally{setBusy(false)}}); -$("#project-new").addEventListener("click",async()=>{const name=prompt("Nombre del nuevo proyecto:");if(!name)return;try{const selected=await call("select_project_directory");if(!selected.path)return;setBusy(true,"Creando proyecto…");const payload=await call("create_project",name,selected.path);renderProjects(payload);renderInventory(payload);message(payload.message)}catch(error){message(error.message,true)}finally{setBusy(false)}}); +$("#project-new").addEventListener("click",async()=>{const name=await appDecision("Nombre del nuevo proyecto:",true);if(!name)return;try{const selected=await call("select_project_directory");if(!selected.path)return;setBusy(true,"Creando proyecto…");const payload=await call("create_project",name,selected.path);renderProjects(payload);renderInventory(payload);message(payload.message)}catch(error){message(error.message,true)}finally{setBusy(false)}}); document.addEventListener("keydown",event=>{if(event.key==="Escape"&&!$("#device-context-menu").hidden){closeDeviceContextMenu();return}if(!["ArrowUp","ArrowDown"].includes(event.key)||["INPUT","SELECT","TEXTAREA"].includes(document.activeElement?.tagName))return;if(!state.devices.length)return;event.preventDefault();const current=Math.max(0,state.devices.findIndex(device=>device.id===state.selectedId));const next=event.key==="ArrowDown"?Math.min(state.devices.length-1,current+1):Math.max(0,current-1);selectDevice(state.devices[next].id);document.querySelector(`tr[data-device-id="${state.devices[next].id}"]`)?.scrollIntoView({block:"nearest"})}); document.addEventListener("keydown",event=>{if(!(event.ctrlKey||event.metaKey)||event.altKey||["INPUT","SELECT","TEXTAREA"].includes(document.activeElement?.tagName))return;const key=event.key.toLocaleLowerCase();const direction=key==="y"||key==="z"&&event.shiftKey?"redo":key==="z"?"undo":"";if(!direction||!state.editHistory[direction==="undo"?"canUndo":"canRedo"])return;event.preventDefault();applyEditHistory(direction)},true); let remoteCsrf=""; diff --git a/gui/desktop.js b/gui/desktop.js index 83b9523..21dd677 100644 --- a/gui/desktop.js +++ b/gui/desktop.js @@ -73,13 +73,15 @@ async function protectProject() { return true; } async function desktopClose() { - if(desktopBusy) return message("Espera a que termine la operación o cancela el escaneo.", true); + if(window.desktopClosing)return;window.desktopClosing=true; try { + if(desktopBusy){await call("cancel_scan");let stopped=false;for(let i=0;i<100;i++){if(!(await call("scan_status")).running){stopped=true;break;}await new Promise(resolve=>setTimeout(resolve,100));}if(!stopped)return message("Cancelación solicitada. Espera a que termine la operación y vuelve a cerrar.",true);} const status = await call("project_state"); const decision = status.dirty || editorDirty() ? await chooseSave() : "discard"; if(decision === "save") await commitEditor(); if(decision !== "cancel") await call("request_close", decision); } catch(error) { message(error.message, true); } + finally {window.desktopClosing=false;} } function showForm(title, fields, submit) { const dialog = $("#desktop-dialog"), host = $("#desktop-fields"); @@ -87,6 +89,9 @@ function showForm(title, fields, submit) { $("#desktop-error").textContent = ""; host.replaceChildren(); fields.forEach(field => { + if(field.section && ![...host.querySelectorAll("h3")].some(heading=>heading.textContent===field.section)) { + const heading=document.createElement("h3");heading.textContent=field.section;host.append(heading); + } const choices=field.choices || {discovery:["icmp","arp","hybrid"],scanProfile:["fast","normal","accurate"],projectSaveMode:["manual","manual.inCloseConsult","automatic.toClose","automatic.toScan","automatic.timeToSave","automatic.allChanges"]}[field.key]; const label = document.createElement("label"), input = document.createElement(choices?"select":"input"); if(choices) choices.forEach(choice=>input.add(new Option(choice.label||choice,choice.value||choice))); @@ -109,19 +114,27 @@ renderInventory = function(payload) { inventorySnapshot = payload; const select = $("#group-filter"), previous = select.value; select.replaceChildren(new Option("Todos los grupos", "")); - [...new Set((payload.devices||[]).flatMap(device=>device.groups))].sort().forEach(group=>select.add(new Option(group, group))); + [...new Set([...(payload.devices||[]).flatMap(device=>device.groups),...(payload.groupCatalog||[]).map(group=>group.name)])].sort().forEach(group=>select.add(new Option(group, group))); select.value = previous; + for(const [id,values] of [["#vendor-filter",(payload.devices||[]).map(d=>d.manufacturer)],["#protocol-filter",(payload.devices||[]).flatMap(d=>d.protocols)]]){ + const input=$(id),value=input.value;input.replaceChildren(new Option("Todos",""));[...new Set(values.filter(Boolean))].sort().forEach(item=>input.add(new Option(item,item)));input.value=value; + } filterInventory(); }; function filterInventory() { if(!inventorySnapshot) return; const filter = $("#state-filter").value, group = $("#group-filter").value; const query = $("#device-search").value.toLocaleLowerCase(); + const vendor=$("#vendor-filter").value,protocol=$("#protocol-filter").value,cnf=$("#cnf-filter").value,membership=$("#membership-filter").value; const mapping = {vendor:"manufacturer", group:"groups", latency:"responseMs", state:"active"}; const key = mapping[sortColumn] || sortColumn; const devices = (inventorySnapshot.devices||[]).filter(device => (filter === "all" || (filter === "active" ? device.active : !device.active)) && (!group || device.groups.includes(group)) && + (!vendor || device.manufacturer===vendor) && + (!protocol || device.protocols.includes(protocol)) && + (!cnf || (device.editableCnf??device.cnf)===cnf) && + (!membership || (membership==="grouped"?device.groups.length>0:device.groups.length===0)) && [device.ip,device.mac,device.alias,device.name,device.manufacturer,...device.groups].join(" ").toLocaleLowerCase().includes(query) ).sort((a,b)=>sortDirection*String(a[key]??"").localeCompare(String(b[key]??""),undefined,{numeric:true})); inventoryRenderer({...inventorySnapshot,devices}); @@ -132,7 +145,7 @@ window.addEventListener("pywebviewready", () => { desktopReady = true; replaceHandler("#project-save","click",async()=>{ setBusy(true,"Guardando proyecto…"); - try {await commitEditor(); const payload=await call("save_project"); renderProjects(payload); renderInventory(payload); message(payload.message);} + try {await commitEditor(); const payload=await call("save_project"); renderProjects(payload); renderInventory(payload);message(payload.message);} catch(error){message(error.message,true);} finally{setBusy(false);} }); replaceHandler("#save-device","click",async()=>{ @@ -166,14 +179,13 @@ window.addEventListener("pywebviewready", () => { filterInventory(); })); replaceHandler("#scan-network", "click", async()=>{ - if(!confirm("¿Escanear la red autorizada con el perfil seleccionado?")) return; setBusy(true,"Escaneando la red…"); $("#cancel-scan").hidden=false; $("#scan-progress").hidden=false; const poll=setInterval(async()=>{ try {const status=await call("scan_status"); $("#scan-progress").value=100*status.current/Math.max(1,status.total);} catch(error) { message(error.message,true); } },500); - try {const payload=await call("scan_network",$("#scan-profile").value); renderInventory(payload); message(payload.message);} + try {const target=window.lanipScanTarget;const payload=await call("scan_network",$("#scan-profile").value,...(target?[target.source,target.network]:[])); renderInventory(payload);window.lanipScanCompleted?.(); message(payload.message);} catch(error) {message(error.message,true);} finally {clearInterval(poll); $("#cancel-scan").hidden=true; $("#scan-progress").hidden=true; setBusy(false);} }); diff --git a/gui/device-sheet.js b/gui/device-sheet.js new file mode 100644 index 0000000..4d3cbbc --- /dev/null +++ b/gui/device-sheet.js @@ -0,0 +1,64 @@ +"use strict"; + +// Keep the public control IDs: existing save/history/remote adapters still own their RPCs. +const sheet=$("#device-details"), sheetContent=$("#details-content"); +const paneNames=["overview","edit","groups","ports","record"]; +const panes=Object.fromEntries(paneNames.map(name=>{ + const panel=document.createElement("section");panel.id="pane-"+name;panel.setAttribute("role","tabpanel");panel.setAttribute("aria-labelledby","tab-"+name);panel.hidden=name!=="overview";return[name,panel]; +})); +sheetContent.append(...Object.values(panes)); +panes.overview.append($("#details-fields")); +const editSection=$(".inspector details.inspector-section");editSection.querySelector("summary").remove();const editorPanel=document.createElement("section");editorPanel.className="inspector-section";editorPanel.append(...editSection.childNodes);editSection.remove();panes.edit.append(editorPanel); +const detailsFields=$(".technical-details");panes.overview.prepend(detailsFields); +const ipLabel=document.createElement("label");ipLabel.textContent="Dirección IP";const ipInput=document.createElement("input");ipInput.id="edit-ip";ipInput.className="field";ipInput.maxLength=45;ipLabel.append(ipInput); +const idfLabel=document.createElement("label");idfLabel.textContent="Identificador IDF";const idfInput=document.createElement("input");idfInput.id="edit-idf";idfInput.className="field";idfInput.maxLength=255;idfLabel.append(idfInput); +$(".editable-fields").append(ipLabel,idfLabel);const descriptionInput=$("#edit-description"),descriptionArea=document.createElement("textarea");descriptionArea.id=descriptionInput.id;descriptionArea.className="field";descriptionArea.rows=4;descriptionInput.replaceWith(descriptionArea); +const groupEditor=document.createElement("div");groupEditor.className="sheet-groups"; +groupEditor.innerHTML='

Los cambios de grupo se aplican al pulsar Añadir o Retirar.

'; +panes.groups.append(groupEditor);const manageGroups=$("#device-groups");manageGroups.hidden=true;panes.groups.append(manageGroups);const inlineGroups=document.createElement("div");inlineGroups.innerHTML='

Pertenencia a grupos

Crear grupo

';panes.groups.append(inlineGroups);panes.ports.append($(".services-section")); +const inspectPorts=document.createElement("button");inspectPorts.id="sheet-inspect";inspectPorts.textContent="Actualizar puertos y servicios";panes.ports.prepend(inspectPorts); +const raw=document.createElement("pre");raw.id="sheet-record";panes.record.append(raw); +sheetContent.replaceChildren(...Object.values(panes)); +const actions=$(".element-actions");const secondActions=document.querySelectorAll(".element-actions")[1]; +if(secondActions)actions.append(...secondActions.children); +const inspector=$(".inspector");inspector.querySelectorAll(".inspector-section").forEach(section=>section.remove());inspector.append(actions); +$("#diagnostic-output").remove();const diagnostic=document.createElement("pre");diagnostic.id="diagnostic-output";diagnostic.hidden=true;panes.ports.append(diagnostic); +let sheetId=null,requestId=0; +function sheetMessage(text,error=false){$("#record-message").textContent=text;$("#record-message").classList.toggle("error-text",error);} +function selectSheetTab(name){paneNames.forEach(key=>{panes[key].hidden=key!==name;$("#tab-"+key).setAttribute("aria-selected",String(key===name));});} +sheet.querySelectorAll("[data-device-tab]").forEach(button=>button.addEventListener("click",()=>selectSheetTab(button.dataset.deviceTab))); +sheet.querySelector(".device-tabs").addEventListener("keydown",event=>{const buttons=[...sheet.querySelectorAll("[role=tab]")],index=buttons.indexOf(document.activeElement);if(index<0)return;let target;if(event.key==="ArrowRight")target=(index+1)%buttons.length;else if(event.key==="ArrowLeft")target=(index+buttons.length-1)%buttons.length;else if(event.key==="Home")target=0;else if(event.key==="End")target=buttons.length-1;else return;event.preventDefault();buttons[target].click();buttons[target].focus();}); +const oldEditorValues=editorValues; +editorValues=function(){return desktopReady?{...oldEditorValues(),ip:$("#edit-ip").value,idf:$("#edit-idf").value}:oldEditorValues();}; +const oldEditorDirty=editorDirty; +editorDirty=function(){const d=state.devices.find(item=>item.id===state.selectedId);return oldEditorDirty()||Boolean(desktopReady&&d&&($("#edit-ip").value!==(d.ip||"")||$("#edit-idf").value!==(d.idf||"")));}; +const sheetSelected=renderSelected; +renderSelected=function(device){sheetSelected(device);$("#edit-ip").value=device.ip||"";$("#edit-idf").value=device.idf||"";$("#sheet-current-groups").textContent="Grupos actuales: "+(device.groups.join(", ")||"ninguno");}; +const previousSyncInspector=syncInspector; +syncInspector=function(){previousSyncInspector();const selected=state.devices.some(d=>d.id===state.selectedId);sheet.querySelectorAll(".editable-fields input,.editable-fields textarea,.editable-fields select,#save-device,#device-groups,#sheet-inspect,#sheet-group-add,#sheet-group-remove").forEach(control=>control.disabled=!selected||desktopBusy);const d=state.devices.find(d=>d.id===state.selectedId),protocols=d?.protocols||[],real=Boolean(d&&d.realTarget!==false&&d.ip&&d.ip!=="-"&&d.mac!=="FF:FF:FF:FF:FF:FF"),ready=real&&!desktopBusy;$("#open-device").disabled=!ready||!(protocols.includes("https")||protocols.includes("http")||protocols.length===1&&["ssh","tr-064","telnet","ftp","rdp","smb","rtsp","radmin"].includes(protocols[0]));$("#open-terminal").disabled=!ready||!protocols.some(p=>["ssh","tr-064","telnet"].includes(p));$("#diagnose-device").disabled=!ready;$("#sheet-inspect").disabled=!ready;$("#show-shares").disabled=!ready||!state.pluginPanels.some(p=>p.id==="windows-smb.resources");$("#wake-device").disabled=!ready||!d?.wolAvailable;}; +function paintRecord(payload){const device=payload.device;$("#details-title").textContent=device.alias||device.name||device.ip;$("#details-fields").replaceChildren(); + const membership=$("#sheet-memberships");membership.replaceChildren();for(const group of inventorySnapshot?.groupCatalog||device.groups.map(name=>({name,editable:true}))){const label=document.createElement("label"),input=document.createElement("input");label.className="membership-option";input.type="checkbox";input.checked=device.groups.includes(group.name);input.disabled=group.editable===false||!device.mac;label.append(input,group.name+(group.description&&group.description!=="-"?" · "+group.description:""));input.addEventListener("change",async()=>{const wanted=input.checked;input.disabled=true;try{if(editorDirty())await commitEditor();renderInventory(await call("group_action",wanted?"add":"remove",group.name,sheetId));paintRecord(await call("device_record",sheetId));sheetMessage("Pertenencia actualizada.");}catch(error){input.checked=!wanted;input.disabled=false;sheetMessage(error.message,true);}});membership.append(label);} + const values=[["Estado",device.active?"Activo":"No detectado"],["ID",device.id],["IP",device.ip],["MAC",device.mac],["Nombre",device.name],["Alias",device.alias],["Fabricante",device.manufacturer],["Confirmación",device.editableCnf||device.cnf],["Grupos",device.groups.join(", ")],["Protocolos",device.protocols.join(", ")],["Latencia",device.responseMs==null?"Sin medición":device.responseMs+" ms"],["Última detección",device.lastSeen],["Último descubrimiento",device.lastDiscovery],["Tipo / icono",device.iconId],["IDF",device.idf],["Descripción",device.description]]; + values.forEach(([label,value])=>addDetailField($("#details-fields"),label,value)); + $("#sheet-record").textContent=JSON.stringify(payload.record||device,null,2); + $("#sheet-current-groups").textContent="Grupos actuales: "+(device.groups.join(", ")||"ninguno"); + const groups=[...new Set([...state.devices.flatMap(d=>d.groups),...device.groups,...(inventorySnapshot?.groupCatalog||[]).map(g=>g.name)])];$("#sheet-group-list").replaceChildren(...groups.map(g=>new Option(g,g))); +} +showDeviceDetails=async function(id=state.selectedId){if(!id)return message("Selecciona un elemento",true);if(editorDirty()&&id!==state.selectedId)return message("Guarda o descarta los cambios antes de seleccionar otro equipo.",true); + selectDevice(id);sheetId=id;const token=++requestId;selectSheetTab("overview");sheetMessage("");$("#details-loading").textContent="Cargando datos del inventario…";$("#details-loading").hidden=false;sheetContent.hidden=true;$("#details-services").replaceChildren(); + if(!sheet.open)sheet.showModal(); + try{const payload=await call(window.pywebview?.api?.device_record?"device_record":"get_device_details",id);if(token!==requestId||!sheet.open)return;const index=state.devices.findIndex(d=>d.id===id);if(index>=0)state.devices[index]=payload.device;renderSelected(payload.device);paintRecord(payload);$("#details-loading").hidden=true;sheetContent.hidden=false;const hint=document.createElement("p");hint.className="muted";hint.textContent="Pulsa Actualizar para inspeccionar los puertos del equipo.";$("#details-services").append(hint);} + catch(error){if(token===requestId){$("#details-loading").textContent=error.message;sheetMessage(error.message,true);}} +}; +async function closeSheet(){if(editorDirty()){const answer=await chooseSave();if(answer==="cancel")return;if(answer==="save"){try{await commitEditor();}catch(error){sheetMessage(error.message,true);return;}}else{const d=state.devices.find(d=>d.id===state.selectedId);if(d)renderSelected(d);}}requestId++;sheet.close();} +sheet.addEventListener("cancel",event=>{event.preventDefault();closeSheet();}); +window.addEventListener("pywebviewready",()=>{ + replaceHandler("#close-details","click",closeSheet); + replaceHandler("#save-device","click",async()=>{try{await commitEditor();const payload=await call("device_record",sheetId);paintRecord(payload);sheetMessage("Cambios guardados.");}catch(error){sheetMessage(error.message,true);}}); + replaceHandler("#diagnose-device","click",async()=>{await showDeviceDetails();if(sheet.open){selectSheetTab("ports");inspectPorts.click();}}); +}); +$("#sheet-inspect").addEventListener("click",async()=>{const id=sheetId,token=requestId;inspectPorts.disabled=true;sheetMessage("Inspeccionando puertos y servicios…");try{const payload=await call("get_device_details",id);if(token!==requestId||!sheet.open)return;const host=$("#details-services");host.replaceChildren();for(const port of payload.diagnostic.open_ports||[]){const row=document.createElement("div");row.className="service-row";for(const [cls,value] of [["service-port","TCP "+port.port],["service-name",port.label||port.service],["service-evidence",port.product||port.evidence||"Puerto detectado"]]){const span=document.createElement("span");span.className=cls;span.textContent=value;row.append(span);}if(port.interactive){const b=document.createElement("button");b.textContent="Abrir";b.addEventListener("click",()=>openService(id,port.service,port.port));row.append(b);}host.append(row);}if(!host.children.length)host.textContent="No se detectaron puertos abiertos en la inspección.";sheetMessage("Inspección terminada.");}catch(error){sheetMessage(error.message,true);}finally{inspectPorts.disabled=false;}}); +async function changeGroup(action){const name=$("#sheet-group-name").value.trim();if(!name)return sheetMessage("Indica un grupo existente.",true);try{if(editorDirty())await commitEditor();const payload=await call("group_action",action,name,sheetId);renderInventory(payload);paintRecord(await call("device_record",sheetId));sheetMessage("Grupo actualizado.");}catch(error){sheetMessage(error.message,true);}} +$("#sheet-group-add").onclick=()=>changeGroup("add");$("#sheet-group-remove").onclick=()=>changeGroup("remove"); +syncInspector(); +$("#sheet-create-group").addEventListener("click",async()=>{const name=$("#sheet-new-group-name").value.trim(),description=$("#sheet-new-group-description").value;if(!name)return sheetMessage("Indica un nombre de grupo.",true);const button=$("#sheet-create-group");button.disabled=true;try{if(editorDirty())await commitEditor();renderInventory(await call("create_group",name,description));const device=state.devices.find(d=>d.id===sheetId);if(device?.mac)renderInventory(await call("group_action","add",name,sheetId));paintRecord(await call("device_record",sheetId));$("#sheet-new-group-name").value="";$("#sheet-new-group-description").value="";sheetMessage("Grupo creado." );}catch(error){sheetMessage(error.message,true);}finally{button.disabled=false;}}); diff --git a/gui/first-scan.js b/gui/first-scan.js new file mode 100644 index 0000000..c1088ed --- /dev/null +++ b/gui/first-scan.js @@ -0,0 +1,149 @@ +"use strict"; +(() => { + let pending = false, + first = false, + options; + const button = document.createElement("button"); + button.type = "button"; + button.id = "scan-target"; + button.textContent = "Red de escaneo"; + button.hidden = true; + document.querySelector(".scan-controls")?.append(button); + const dialog = document.createElement("dialog"); + dialog.className = "support-dialog first-scan-dialog"; + dialog.setAttribute("aria-label", "Red de escaneo"); + dialog.innerHTML = `

Red de escaneo

`; + document.body.append(dialog); + function change() { + const form = dialog.querySelector("form"), + explicit = first || Boolean(form.elements.source.value); + form.elements.range.disabled = !explicit; + form.elements.range.required = explicit; + form.elements.source.required = first; + if (!explicit) + dialog.querySelector(".first-scan-notice").textContent = + "Se conserva el escaneo habitual con las rutas y la configuración del sistema."; + else if (options.networks?.length) + dialog.querySelector(".first-scan-notice").textContent = options.notice; + } + function populate(result) { + options = result; + const form = dialog.querySelector("form"), + source = form.elements.source, + selected = window.lanipScanTarget; + source.replaceChildren(); + if (!first) + source.add(new Option("Rutas del sistema (configuración habitual)", "")); + for (const nic of result.networks || []) + source.add( + new Option(`${nic.name} · ${nic.address} (${nic.network})`, nic.id), + ); + if ( + selected && + [...source.options].some((option) => option.value === selected.source) + ) + source.value = selected.source; + else if (first && source.options.length) + source.value = ( + result.networks.find((nic) => nic.address === result.localIp) || + result.networks[0] + ).id; + form.elements.range.value = + selected?.network || + result.networks?.find((nic) => nic.id === source.value)?.network || + result.range || + ""; + const available = !first || Boolean(result.networks?.length); + dialog.querySelector('[type="submit"]').disabled = !available; + source.disabled = !available; + dialog.querySelector(".first-scan-notice").textContent = available + ? result.notice + : "No se han podido obtener interfaces de red disponibles. Puedes reintentar; el primer escaneo sigue pendiente."; + dialog.querySelector(".first-scan-network").textContent = result.localIp + ? "Dirección local detectada: " + result.localIp + : "Selecciona un adaptador disponible."; + change(); + } + dialog.querySelector('[name="source"]').onchange = (event) => { + const nic = options.networks?.find((nic) => nic.id === event.target.value); + if (nic) dialog.querySelector('[name="range"]').value = nic.network; + change(); + }; + async function show(initial = false, result = null) { + result ||= await call(initial ? "first_scan_options" : "scan_targets"); + if (initial && !result.requested) { + pending = false; + initial = false; + result = await call("scan_targets"); + } + first = initial; + dialog.querySelector("h2").textContent = first + ? "Primer escaneo de la red" + : "Red de escaneo"; + dialog.querySelector('[type="submit"]').textContent = first + ? "Confirmar y escanear" + : "Aplicar"; + dialog.querySelector(".first-scan-profile").hidden = !first; + dialog.querySelector(".first-scan-error").textContent = ""; + populate(result); + if (!dialog.open) dialog.showModal(); + } + dialog.querySelector('[data-first-scan="retry"]').onclick = () => + show(first).catch((error) => { + dialog.querySelector(".first-scan-error").textContent = error.message; + }); + dialog.querySelector('[data-first-scan="cancel"]').onclick = async () => { + try { + if (first && options.networks?.length) { + await call("dismiss_first_scan"); + pending = false; + } + dialog.close(); + } catch (error) { + dialog.querySelector(".first-scan-error").textContent = error.message; + } + }; + dialog.querySelector("form").onsubmit = async (event) => { + event.preventDefault(); + const form = event.target; + window.lanipScanTarget = form.elements.source.value + ? { + source: form.elements.source.value, + network: form.elements.range.value.trim(), + } + : null; + if (first && !window.lanipScanTarget) return; + button.textContent = window.lanipScanTarget + ? "Red: " + + options.networks.find((nic) => nic.id === window.lanipScanTarget.source) + .name + : "Red de escaneo"; + const start = first; + if (start) $("#scan-profile").value = form.elements.profile.value; + dialog.close(); + if (start) $("#scan-network").click(); + }; + window.lanipScanCompleted = () => { + pending = false; + }; + button.onclick = () => + show(pending).catch((error) => message(error.message, true)); + window.addEventListener("pywebviewready", async () => { + if ( + !window.pywebview?.api.first_scan_options || + !window.pywebview?.api.scan_targets + ) + return; + try { + for (let attempt = 0; attempt < 100 && !inventorySnapshot; attempt++) + await new Promise((resolve) => setTimeout(resolve, 100)); + if (!inventorySnapshot) return; + button.hidden = false; + const result = await call("first_scan_options"); + pending = result.requested; + if (pending) await show(true, result); + } catch (error) { + message(error.message, true); + } + }); +})(); diff --git a/gui/index.html b/gui/index.html index 473d9fe..f26e350 100644 --- a/gui/index.html +++ b/gui/index.html @@ -6,44 +6,48 @@ LANIP - + +
-
LANIPInventario de red
+
LANIPNETWORK INVENTORY
Proyecto
- -
Sesión local
+ +
● Sesión local
- +
+
+ +
+ +
+ FILTRAR - - - +
Más filtros
+
+
+
Columnas
- -
- 0 elementos - 0 activos - 0 no detectados - 0 switches + +
-

Elementos de red

Cargando inventario del núcleo de LANCTL…

-
ActivoNo detectado
+

Inventario de red

Cargando inventario del núcleo de LANCTL…

+
0 equipos0 activos0 sin respuesta0 switches
-
- +
+
@@ -66,6 +70,7 @@
Fabricante
-
Protocolos
-
+
Editar identificación
@@ -73,16 +78,17 @@
+
+
+

Acceso al equipo

- - - - - - - + + + +
+

Diagnóstico y servicios

@@ -90,7 +96,7 @@

Recursos compartidos

EstadoTipoIPmsCNF AliasMACNombreFabricante

Historial del proyecto

Cambios y eventos registrados en el proyecto activo

FechaElementoEventoResultadoResumen
No hay eventos registrados.
-
LANCTL —Vista de inventario lógico0 filas
+
● LANIP · LANCTL —
Paneles
Inventario lógico · Ctrl K buscar · Ctrl S guardar0 filas
Inspeccionando servicios y puertos…
+ +

+

Cambios pendientes

El proyecto tiene modificaciones sin guardar.

- + + + + diff --git a/gui/lanip-controls.js b/gui/lanip-controls.js new file mode 100644 index 0000000..d55e1f3 --- /dev/null +++ b/gui/lanip-controls.js @@ -0,0 +1,28 @@ +"use strict"; + +// Keep plugin/history providers available without a permanent navigation row. +function updatePanelMenu(){ + const host=$("#panel-menu-items");host.replaceChildren(); + document.querySelectorAll(".main-navigation button").forEach(source=>{ + const button=document.createElement("button");button.type="button";button.textContent=source.textContent; + button.addEventListener("click",()=>{source.click();$("#panel-menu").open=false;});host.append(button); + }); +} +new MutationObserver(updatePanelMenu).observe($("#plugin-navigation"),{childList:true});updatePanelMenu(); +for(const id of ["#vendor-filter","#protocol-filter","#cnf-filter","#membership-filter"])$(id).addEventListener("change",filterInventory); +$("#clear-filters").addEventListener("click",()=>{ + $("#device-search").value="";$("#state-filter").value="all"; + for(const id of ["#group-filter","#vendor-filter","#protocol-filter","#cnf-filter","#membership-filter"])$(id).value=""; + filterInventory(); +}); +$("#lanip-cli").addEventListener("click",async()=>{try{message((await call("open_cli")).message);}catch(error){message(error.message,true);}}); +$("#lanctl-gui").addEventListener("click",async()=>{try{message((await call("open_suite")).message);}catch(error){message(error.message,true);}}); +$("#new-group").addEventListener("click",()=>{ + showForm("Crear grupo",[{key:"name",label:"Nombre del grupo",value:""},{key:"description",label:"Descripción (máximo 42 caracteres)",value:""}],async values=>{ + if(!values.name.trim())throw new Error("Indica el nombre del grupo."); + const result=await call("create_group",values.name,values.description);renderInventory(result);message(result.message); + }); + document.querySelector('#desktop-fields input[name="name"]').required=true; + document.querySelector('#desktop-fields input[name="description"]').maxLength=42; +}); +window.addEventListener("pywebviewready",()=>{if(!desktopReady){$("#lanip-cli").hidden=true;$("#new-group").hidden=true;}}); diff --git a/gui/lanip.css b/gui/lanip.css new file mode 100644 index 0000000..83d3e07 --- /dev/null +++ b/gui/lanip.css @@ -0,0 +1,29 @@ +/* Graphite/lime desktop layout. Public component IDs and custom theme tokens remain intact. */ +:root{--color-background:#15181c;--color-surface:#1d2328;--color-surface-raised:#252d33;--color-border:#374149;--color-text:#eef2f5;--color-text-muted:#a6b3c1;--color-accent:#b2ef26;--color-success:#91d748;--color-warning:#e4b56c;--radius-panel:12px;--radius-control:7px} +body{min-width:0;min-height:0;font-size:12px}button,input,select{font:inherit}button{padding:8px 11px;transition:border-color .15s}button:hover:not(:disabled){border-color:var(--color-accent)}button:disabled{opacity:.4;cursor:default}button:focus-visible,input:focus-visible,select:focus-visible,summary:focus-visible,.table-scroll:focus-visible{outline:2px solid var(--color-accent);outline-offset:2px}input[type=checkbox]{accent-color:var(--color-accent)}[hidden]{display:none!important} +.app-shell{grid-template-rows:auto auto minmax(0,1fr) 32px;height:100dvh;background:var(--color-background)}.topbar{padding:14px 20px;gap:20px;background:color-mix(in srgb,var(--color-background),#000 25%)}.brand{min-width:180px;gap:12px}.brand .launcher-icon{width:26px;height:26px;fill:none;stroke:var(--color-accent);stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round}.brand strong{font-size:22px;letter-spacing:1px}.brand strong span{color:var(--color-accent)}.brand small{display:block!important;margin:2px 0 0;font-size:9px;letter-spacing:1.6px}.project{flex:1;min-width:0;flex-wrap:wrap}.project select{min-width:130px;max-width:230px;height:32px;padding:4px 8px}.project button{font-size:11px;padding:7px 10px}.connection{font-size:11px;white-space:nowrap;color:var(--color-accent)}.main-navigation{padding:0 20px 8px;align-items:center;flex-wrap:wrap;gap:5px;background:color-mix(in srgb,var(--color-background),#000 25%)}.main-navigation button{padding:7px 12px;color:var(--color-text-muted);font-size:12px;border-radius:7px}.main-navigation button.active{background:color-mix(in srgb,var(--color-accent) 13%,var(--color-surface));color:var(--color-accent);border-bottom:0} +.content{display:grid;grid-template-columns:minmax(0,1fr) 292px;grid-template-rows:auto minmax(0,1fr);grid-template-areas:"toolbar toolbar" "inventory inspector";padding:16px;gap:14px;min-height:0}.commandbar{grid-area:toolbar;display:grid;grid-template-columns:auto minmax(180px,1fr);gap:14px 24px;border:0;padding:0;background:transparent}.scan-controls,.filter-controls,.list-controls{display:flex;gap:8px;align-items:center;flex-wrap:wrap;min-width:0}.scan-controls{grid-column:1}.filter-controls{grid-column:1;grid-row:2}.list-controls{grid-column:2;grid-row:2;justify-content:flex-end}.control-caption{color:var(--color-text-muted);font-size:10px;letter-spacing:1px;margin-right:4px}.commandbar select{background:var(--color-surface);border:1px solid var(--color-border);border-radius:7px;padding:7px 9px;min-width:0;max-width:220px}.view-picker{display:flex;gap:7px;align-items:center;color:var(--color-text-muted);font-size:11px}.primary{border-color:var(--color-accent)!important;background:var(--color-accent)!important;color:#182105!important;font-weight:600}.search{grid-column:2;grid-row:1;max-width:none;min-width:0;width:100%;height:35px;padding:0 12px;background:var(--color-surface);border-color:var(--color-border)}.search input{min-width:0;font-size:12px}.search kbd{font:10px Consolas,monospace;white-space:nowrap;color:var(--color-text-muted);padding:1px 5px;border:1px solid var(--color-border);border-radius:4px}.column-menu summary{padding:7px 11px;font-size:11px}.column-menu>div{left:auto;right:0;top:36px;background:var(--color-surface-raised);max-width:calc(100vw - 32px);grid-template-columns:repeat(2,minmax(100px,145px))} +.table-panel{grid-area:inventory;grid-template-rows:auto minmax(0,1fr);background:var(--color-surface);border-color:var(--color-border)}.table-title{padding:16px;gap:12px;min-height:75px;align-items:start;flex-wrap:wrap}.table-title h1{font-size:17px;letter-spacing:-.2px;font-weight:600}.table-title p{font-size:11px;max-width:470px;overflow-wrap:anywhere;margin-top:5px}.summary{font-size:11px;gap:12px;margin-left:0;flex-wrap:wrap;white-space:normal}.summary span:nth-child(n){display:inline}.summary b{font-size:13px}.table-scroll{overflow:auto;scrollbar-color:#536047 var(--color-surface);scrollbar-width:thin;overscroll-behavior:contain}.table-scroll table{table-layout:auto;width:100%;min-width:650px}.table-scroll table:has(th[data-column="mac"]:not(.column-hidden)){min-width:1050px}.table-scroll th{background:var(--color-surface-raised);height:37px;color:var(--color-text-muted);font-size:11px;font-weight:500;border-right:0;padding:0 13px}.table-scroll td{height:42px;padding:0 13px;border-right:0;border-bottom:1px solid color-mix(in srgb,var(--color-border),transparent 50%);max-width:200px;font-size:12px}.table-scroll td[data-column="ip"],.table-scroll td[data-column="mac"],.table-scroll td[data-column="latency"]{font-family:Consolas,monospace;font-variant-numeric:tabular-nums}.table-scroll td[data-column="alias"]{font-weight:600;color:var(--color-text)}.table-scroll th[data-column]{width:auto;min-width:45px}.table-scroll th[aria-sort]{color:var(--color-accent)}tbody tr:nth-child(even){background:transparent}tbody tr:hover{background:color-mix(in srgb,var(--color-surface-raised),var(--color-accent) 5%)}tbody tr.selected{background:color-mix(in srgb,var(--color-surface),var(--color-accent) 11%);outline:0;box-shadow:inset 3px 0 var(--color-accent)}.device-icon{width:23px;height:23px}.cnf-local{background:var(--color-surface-raised);color:var(--color-accent);box-shadow:none}.empty-state{padding:48px 24px;font-size:12px}.table-scroll td[data-column="state"]{font-size:11px}.table-scroll i{width:6px;height:6px} +.inspector{grid-area:inspector;display:flex;flex-direction:column;align-items:stretch;gap:0;min-height:0;max-height:none;overflow:auto;padding:18px;background:var(--color-surface);scrollbar-width:thin;scrollbar-color:#536047 var(--color-surface)}.selected-identity{padding:0 0 18px;gap:5px}.selected-icon{width:34px;height:34px;background:var(--color-surface-raised)}.selected-identity>i{width:7px;height:7px}.selected-identity>div{min-width:0;flex:1}.selected-identity small{font-size:10px;text-transform:uppercase;letter-spacing:1px}.selected-identity h2{font-size:17px;margin:5px 0}.selected-identity p{font-size:11px;white-space:normal;overflow-wrap:anywhere}.technical-details{display:grid;grid-template-columns:1fr;gap:4px;margin:0 0 18px}.technical-details div{display:grid;grid-template-columns:65px minmax(0,1fr);gap:8px;font-size:11px;padding:4px 0}.technical-details dt{width:auto}.technical-details dd{white-space:normal;overflow-wrap:anywhere}.technical-details dd span{display:inline-block;font-size:9px;padding:1px 5px;margin:2px 0}.inspector-section{padding:16px 0;border-top:1px solid var(--color-border)}.inspector-section summary,.inspector-section h3{margin:0 0 12px;font-size:12px;font-weight:600;color:var(--color-text)}.inspector-section summary{cursor:pointer}.inspector-section:not([open]) summary{margin-bottom:0}.editable-fields{grid-template-columns:repeat(2,minmax(0,1fr));gap:10px}.editable-fields label{font-size:11px;gap:5px}.editable-fields label:nth-child(3){grid-column:1/-1;grid-row:2}.field{height:32px;background:var(--color-background);padding:6px 8px}.editor-actions{display:flex;gap:8px;margin-top:12px}.editor-actions button{font-size:11px}.element-actions{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}.element-actions button{font-size:11px;padding:9px 5px;white-space:normal}#diagnostic-output{flex:none;max-height:160px;font-size:11px;white-space:pre-wrap;overflow-wrap:anywhere;background:var(--color-background)} +.statusbar{background:color-mix(in srgb,var(--color-background),#000 25%);font-size:10px;padding:0 16px}.footer-dot{color:var(--color-accent)}#event-tray{bottom:32px;right:16px;background:var(--color-surface-raised);border-color:var(--color-border);font-size:11px;max-width:min(500px,calc(100vw - 32px))}#event-tray summary{padding:5px 10px}#event-tray:not(:has(details[open])){border-bottom:0;background:var(--color-surface)}#session-events{font-size:11px} +#desktop-dialog,#save-dialog,#device-details{background:var(--color-surface);color:var(--color-text);border-color:var(--color-border)}#desktop-fields input,#desktop-fields select,.details-fields div,.service-row,.plugin-table input{background:var(--color-background);border-color:var(--color-border)}.details-header,.context-menu{background:var(--color-surface-raised)}.context-menu button:hover,.context-menu button:focus-visible{background:var(--color-surface);outline:revert}.plugin-panel{padding:18px}.plugin-table,.plugin-browser aside,.activity-card{background:var(--color-surface)}.plugin-metrics span{background:var(--color-surface-raised)}.plugin-table tr.selected,.activity-table tr.selected{background:color-mix(in srgb,var(--color-surface),var(--color-accent) 11%)}.plugin-browser{grid-template-columns:minmax(0,1fr) 280px}.plugin-table{overflow:auto}.plugin-table table{min-width:600px}.activity-table{min-width:650px}.service-port{color:var(--color-accent)}#scan-progress{accent-color:var(--color-accent)} +@media(max-width:1150px){.topbar{gap:12px}.brand{min-width:160px}.connection{display:none}.summary{gap:10px}.content{grid-template-columns:minmax(0,1fr) 270px;padding:12px;gap:12px}.inspector{padding:15px}.table-title{padding:14px}.brand small{display:block}} +@media(max-width:850px){body{overflow:auto}.app-shell{height:auto;min-height:100dvh;grid-template-rows:auto auto 1fr 32px}.topbar{flex-wrap:wrap;padding:13px 15px}.brand{min-width:145px}.project{order:3;flex-basis:100%}.project select{flex:1;max-width:none}.topbar>#desktop-settings{margin-left:auto}.content{grid-template-columns:minmax(0,1fr);grid-template-rows:auto minmax(280px,50dvh) auto;grid-template-areas:"toolbar" "inventory" "inspector"}.commandbar{gap:12px;grid-template-columns:1fr}.scan-controls,.filter-controls,.list-controls,.search{grid-column:1;grid-row:auto}.search{grid-row:2}.list-controls{justify-content:start}.inspector{overflow:visible;display:grid;grid-template-columns:1fr 1fr;gap:0 20px}.selected-identity,.technical-details{align-self:start}.inspector-section:first-of-type{grid-row:2/5;grid-column:1}.inspector-section{grid-column:2}.inspector #diagnostic-output{grid-column:1/-1}.statusbar span:nth-child(2){display:none}.statusbar{grid-template-columns:1fr 1fr}.plugin-browser{grid-template-columns:1fr}.details-fields{grid-template-columns:repeat(2,minmax(0,1fr))}} +@media(max-width:480px){.inspector{display:flex}.commandbar select{max-width:170px}.search kbd{display:none}.scan-controls{gap:6px}.scan-controls button{padding:8px}.control-caption{display:none}.main-navigation{padding-left:12px}.project{gap:6px}.project button{padding:7px 8px}.brand strong{font-size:20px}.brand small{font-size:8px}.details-fields{grid-template-columns:1fr}.service-row{grid-template-columns:60px 1fr}.service-evidence{grid-column:1/-1}.table-title{gap:10px}.summary{gap:8px}#desktop-fields label{grid-template-columns:1fr;gap:5px}.plugin-toolbar{align-items:start;flex-wrap:wrap;gap:12px}} +.table-panel .table-scroll table{min-width:800px}.table-panel th[data-column="state"]{min-width:115px}.table-panel th[data-column="ip"]{min-width:125px}.table-panel th[data-column="latency"]{min-width:60px}.table-panel th[data-column="alias"]{min-width:150px}.table-panel th[data-column="vendor"]{min-width:125px}.table-panel th[data-column="group"]{min-width:130px} +@media(prefers-reduced-motion:reduce){button{transition:none}.scan-running #scan-network::before{animation:none}} + +/* Full-width inventory, with selected-device actions in a bottom dock. */ +.content{grid-template-columns:minmax(0,1fr);grid-template-rows:auto minmax(0,1fr) auto;grid-template-areas:"toolbar" "inventory" "inspector"} +.inspector{display:flex;flex-direction:row;align-items:center;justify-content:space-between;gap:16px;padding:10px 14px;overflow:visible;max-height:none;min-height:65px} +.inspector .selected-identity{padding:0;min-width:170px;max-width:330px;flex:1}.inspector .selected-identity small{display:none}.inspector .selected-identity p{white-space:nowrap;text-overflow:ellipsis;overflow:hidden}.inspector .selected-identity h2{font-size:14px;margin:0 0 3px} +.inspector>.element-actions{display:flex;gap:8px;flex-wrap:wrap;justify-content:flex-end}.inspector>.element-actions button{padding:9px 12px}.inspector #diagnostic-output{display:none} +.device-tabs{display:flex;gap:5px;flex-wrap:wrap;padding:10px 18px;border-bottom:1px solid var(--color-border)}.device-tabs button{border:0;background:transparent;color:var(--color-text-muted);font-size:12px}.device-tabs button[aria-selected=true]{color:var(--color-accent);background:color-mix(in srgb,var(--color-accent) 12%,var(--color-surface))} +#device-details{width:min(980px,calc(100vw - 32px));max-height:calc(100dvh - 32px);overflow:auto}#device-details .details-header{position:sticky;top:0;z-index:3}#device-details #details-content{max-height:none;overflow:visible;padding:18px}#device-details .technical-details{display:none}#device-details .details-fields{grid-template-columns:repeat(3,minmax(0,1fr));margin:0}#device-details [role=tabpanel][hidden]{display:none!important}#device-details .inspector-section{padding:0;border:0}#device-details .editable-fields{grid-template-columns:repeat(2,minmax(0,1fr));gap:14px}#device-details .editable-fields label{font-size:12px}#device-details .field{height:36px}#device-details .editable-fields label:nth-child(3){grid-column:auto;grid-row:auto}#device-details .services-section{border:0;padding-top:16px}#record-message{padding:10px 18px;margin:0;font-size:12px;color:var(--color-accent);border-top:1px solid var(--color-border)}#record-message:empty{display:none}#sheet-record{margin:0;white-space:pre-wrap;overflow-wrap:anywhere;font:12px/1.7 Consolas,monospace;background:var(--color-background);padding:16px;border-radius:8px}.sheet-group-toolbar{display:flex;gap:10px;align-items:end;flex-wrap:wrap;margin:16px 0}.sheet-group-toolbar label{display:grid;gap:7px;font-size:12px;color:var(--color-text-muted)}.sheet-group-toolbar input{background:var(--color-background);border:1px solid var(--color-border);border-radius:7px;color:var(--color-text);padding:9px}#event-tray{bottom:0;right:110px;border-radius:0;border:0;background:transparent;font-size:10px;z-index:8}#event-tray:has(details[open]){bottom:32px;right:16px;border:1px solid var(--color-border);border-radius:8px;background:var(--color-surface-raised)} +@media(max-width:1000px){.inspector{align-items:start}.inspector>.element-actions{max-width:65%}.inspector .selected-identity{max-width:30%}} +@media(max-width:850px){.content{grid-template-rows:auto minmax(280px,50dvh) auto}.inspector{flex-wrap:wrap}.inspector .selected-identity{max-width:100%}.inspector>.element-actions{max-width:none;justify-content:start;flex-basis:100%}#device-details .details-fields{grid-template-columns:repeat(2,minmax(0,1fr))}#event-tray{right:85px}} +@media(max-width:480px){#device-details .details-fields,#device-details .editable-fields{grid-template-columns:1fr}.device-tabs{padding:8px;gap:3px}.device-tabs button{font-size:11px;padding:7px}.inspector>.element-actions{display:grid;grid-template-columns:1fr 1fr;width:100%}.inspector>.element-actions button{padding:9px}.statusbar span:nth-child(2){display:none}#event-tray{right:65px}} +.remote-mode #tab-groups,.remote-mode .editable-fields label:has(#edit-ip),.remote-mode .editable-fields label:has(#edit-idf){display:none} +.main-navigation{display:none}.app-shell{grid-template-rows:auto minmax(0,1fr) 32px}.topbar{flex-wrap:wrap}.topbar #new-group{font-size:11px}.statusbar>span:first-child{display:flex;align-items:center;gap:8px;overflow:visible}.statusbar button,.statusbar summary{background:transparent;border:0;padding:2px 4px;color:var(--color-text-muted);font-size:11px;cursor:pointer}.statusbar button:hover{color:var(--color-accent)}#panel-menu{position:relative}#panel-menu>div{position:absolute;bottom:26px;left:0;z-index:20;display:grid;min-width:180px;border:1px solid var(--color-border);border-radius:8px;background:var(--color-surface-raised);padding:7px;box-shadow:0 6px 20px #0006}#panel-menu>div button{text-align:left;padding:8px}#advanced-filters{position:relative;font-size:11px}#advanced-filters>summary{padding:8px 10px;border:1px solid var(--color-border);border-radius:7px;cursor:pointer;background:var(--color-surface)}#advanced-filters>div{position:absolute;top:38px;left:0;z-index:10;background:var(--color-surface-raised);border:1px solid var(--color-border);border-radius:10px;padding:15px;display:grid;gap:12px;width:min(300px,calc(100vw - 32px));box-shadow:0 12px 24px #0005}#advanced-filters label{display:grid;gap:6px;color:var(--color-text-muted)}#advanced-filters select{width:100%;max-width:none}#desktop-fields h3{font-size:13px;color:var(--color-accent);border-bottom:1px solid var(--color-border);padding-bottom:9px;margin:8px 0 0}.remote-mode #new-group,.remote-mode #lanip-cli{display:none} +@media(max-width:850px){.app-shell{grid-template-rows:auto 1fr 32px}#advanced-filters>div{left:auto;right:0}.topbar>.project{order:4}.statusbar{grid-template-columns:minmax(0,1fr) auto}.statusbar>span:first-child{gap:4px}} +#device-details textarea.field{min-height:100px;height:auto;resize:vertical;font:inherit;line-height:1.5}.membership-option{display:flex;gap:9px;align-items:center;padding:9px 0;border-bottom:1px solid var(--color-border);font-size:12px}.sheet-groups{display:none}#pane-groups h3{font-size:13px;margin:16px 0 8px} diff --git a/gui/lanip.js b/gui/lanip.js new file mode 100644 index 0000000..bd57129 --- /dev/null +++ b/gui/lanip.js @@ -0,0 +1,87 @@ +"use strict"; + +// Presentation-only adapters; all mutations continue through the existing RPCs. +const essentialColumns = ["state", "icon", "ip", "latency", "alias", "vendor", "group"]; +const graphiteTokens = { + "--color-background":"#15181c", "--color-surface":"#1d2328", + "--color-surface-raised":"#252d33", "--color-border":"#374149", + "--color-text":"#eef2f5", "--color-text-muted":"#a6b3c1", + "--color-accent":"#b2ef26", "--color-success":"#91d748", + "--color-warning":"#e4b56c", "--color-danger":"#ef7777", + "--radius-panel":"12px", "--radius-control":"7px" +}; +const previousTheme = applyTheme; +applyTheme = function(theme = {}) { + if(!theme.id || ["lanctl.core.fallback","lanctl.theme.default.palette"].includes(theme.id)) { + previousTheme({tokens:graphiteTokens,components:{}}); + } else previousTheme(theme); +}; +function columnPreferences() { + try { + const saved=JSON.parse(localStorage.getItem("lanctl.columns")||"null"); + if(saved && typeof saved==="object" && !Array.isArray(saved)) return saved; + } catch { /* Ignore invalid presentation preferences, not project data. */ } + return Object.fromEntries(columns.map(key=>[key,essentialColumns.includes(key)])); +} +function selectedPreset(saved) { + if(columns.every(key=>saved[key]!==false)) return "complete"; + if(columns.every(key=>(saved[key]!==false)===essentialColumns.includes(key))) return "essential"; + return "custom"; +} +setupColumns = function() { + const host=$("#column-options");host.replaceChildren(); + document.querySelectorAll(".table-panel th[data-column]").forEach(header=>{ + const key=header.dataset.column,label=document.createElement("label"),input=document.createElement("input"); + input.type="checkbox";input.dataset.columnToggle=key; + input.addEventListener("change",()=>{ + const saved=columnPreferences();saved[key]=input.checked; + // Keep at least one useful identifier visible. + if(!columns.some(column=>saved[column]!==false)){input.checked=true;return;} + localStorage.setItem("lanctl.columns",JSON.stringify(saved));applyColumnPreferences(); + }); + label.append(input,header.textContent);host.append(label); + }); + applyColumnPreferences(); +}; +applyColumnPreferences = function() { + const saved=columnPreferences(); + columns.forEach(key=>{ + document.querySelectorAll(`.table-panel [data-column="${key}"]`).forEach(cell=>cell.classList.toggle("column-hidden",saved[key]===false)); + const input=document.querySelector(`[data-column-toggle="${key}"]`);if(input)input.checked=saved[key]!==false; + }); + $("#inventory-view").value=selectedPreset(saved); +}; +restoreWidths = function() { + columns.forEach(key=>{ + const width=Number(localStorage.getItem(`lanctl.width.${key}`)); + const header=document.querySelector(`.table-panel th[data-column="${key}"]`); + if(header && Number.isFinite(width) && width>=45 && width<=1000){header.style.width=width+"px";header.style.minWidth=width+"px";} + }); +}; +$("#inventory-view").addEventListener("change",event=>{ + const preset=event.target.value; + if(preset==="custom"){$(".column-menu").open=true;return;} + const saved=Object.fromEntries(columns.map(key=>[key,preset==="complete"||essentialColumns.includes(key)])); + localStorage.setItem("lanctl.columns",JSON.stringify(saved));applyColumnPreferences(); +}); +function syncInspector() { + const selected=state.devices.some(device=>device.id===state.selectedId); + document.querySelectorAll(".inspector input,.inspector select,.inspector button:not(.contract-only)").forEach(control=>control.disabled=!selected||desktopBusy); + const device=state.devices.find(device=>device.id===state.selectedId); + $("#wake-device").disabled=!selected||desktopBusy||!device?.wolAvailable; + $(".inspector").setAttribute("aria-label",selected?"Opciones del equipo seleccionado":"Selecciona un equipo del inventario"); +} +const selectedRenderer=renderSelected; +renderSelected=function(device){selectedRenderer(device);syncInspector();}; +const clearedRenderer=clearSelected; +clearSelected=function(){clearedRenderer();syncInspector();}; +const presentationBusy=setBusy; +setBusy=function(busy,text){presentationBusy(busy,text);syncInspector();}; +document.addEventListener("keydown",event=>{ + if((event.ctrlKey||event.metaKey)&&event.key.toLowerCase()==="k"&&!document.querySelector("dialog[open]")){ + event.preventDefault();$("#device-search").focus();$("#device-search").select(); + } + if(event.key==="Escape")$(".column-menu").open=false; +}); +document.addEventListener("click",event=>{const menu=$(".column-menu");if(menu.open&&!menu.contains(event.target)&&event.target!==$("#inventory-view"))menu.open=false;}); +syncInspector(); diff --git a/gui/launcher-prototypes.css b/gui/launcher-prototypes.css new file mode 100644 index 0000000..f270951 --- /dev/null +++ b/gui/launcher-prototypes.css @@ -0,0 +1 @@ +.identity{display:flex;align-items:center;gap:14px}.identity svg{width:29px;height:29px;color:var(--lime)}svg{fill:none;stroke:currentColor;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round}.brand small{font-size:9px}header{padding:17px 24px}.controls{padding:9px 24px}.controls>#settings{margin-left:auto;font-size:12px}#workspace{display:flex;flex-direction:column;overflow:hidden;padding:22px 24px 14px}.toolbar{flex:none;margin-bottom:16px}h1{font-size:23px}.eyebrow{font-size:10px;letter-spacing:1.8px;color:var(--lime);margin-bottom:5px}#subtitle{font-size:12px;margin:5px 0 0}.filterbar{display:flex;gap:10px;align-items:center;margin-bottom:16px;flex:none}.filterbar input{width:340px}.filterbar select{min-width:160px}.filterbar #count{margin-left:auto;font-size:11px}#canvas{flex:1;min-height:0;overflow:auto;scrollbar-width:thin}.split{display:grid;grid-template-columns:minmax(0,1fr) 270px;gap:16px;min-height:100%}.panel{padding:18px}.panel h2{margin-bottom:12px}.aside{background:#1a2024}.aside dl{grid-template-columns:94px 1fr;font-size:12px;gap:14px}.aside p{font-size:12px}.aside hr{border:0;border-top:1px solid var(--line);margin:20px 0}.section-label{font-size:10px;letter-spacing:1px;color:var(--muted);margin:0 0 12px}.commandbar{flex:none;border-top:1px solid var(--line);padding:11px 24px;display:flex;justify-content:space-between;gap:12px;align-items:center;background:#1a2024}.commandbar>span{color:var(--muted);font-size:12px}.commandbar button{font-size:12px}.table-wrap{border:1px solid var(--line);border-radius:10px;overflow:auto}table{border-collapse:collapse;width:100%;font-size:12px;text-align:left}th{font-size:10px;letter-spacing:.5px;color:var(--muted);font-weight:500;background:#20272c;position:sticky;top:0;padding:13px 16px}td{padding:17px 16px;border-top:1px solid #303940}tr[data-id]{cursor:pointer}tr[data-id]:hover{background:#242d30}tr.selected{background:#2b3624;box-shadow:inset 3px 0 var(--lime)}td small{display:block;color:var(--muted);margin-top:4px;font-size:11px}.pill{display:inline-block;border:1px solid #46563a;color:#c0e994;padding:2px 7px;border-radius:5px;font-size:10px}.warn{color:#edc783;border-color:#66543b}.topology{min-height:290px;background:radial-gradient(#46513f66 .8px,transparent .8px);background-size:18px 18px;position:relative;border:1px solid var(--line);border-radius:10px;overflow:hidden}.topology svg{position:absolute;width:100%;height:100%;color:#6a8550}.node{position:absolute;transform:translate(-50%,-50%);padding:12px 18px;min-width:125px;box-shadow:0 6px 20px #0004;background:#20282d;text-align:left}.node small{display:block;color:var(--muted);font-size:10px;margin-top:5px}.node.selected{border-color:var(--lime)}.legend{font-size:11px;display:flex;gap:18px;color:var(--muted);margin:12px 0}.legend span:first-child{color:var(--lime)}.rack-layout{display:grid;grid-template-columns:180px minmax(230px,1fr) 250px;gap:16px}.rack-list{display:grid;align-content:start;gap:8px}.rack-list button{text-align:left;padding:15px}.rack-list small{display:block;color:var(--muted);margin-top:5px}.rack-list .active{border-color:#7caa32;background:#293323}.cabinet{background:#101518;border:1px solid #45515b;border-radius:9px;padding:12px 15px;max-width:440px;margin:auto}.rack-unit{display:flex;align-items:center;gap:10px;height:31px;margin:3px 0}.rack-unit>span{color:#7e909e;width:22px;font:10px Consolas,monospace}.rack-unit button{flex:1;padding:4px 12px;border-radius:3px;font-size:11px;text-align:left;display:flex;justify-content:space-between;align-items:center;height:100%}.rack-unit .empty{border:1px dashed #30393e;background:transparent;color:#53616b;font-size:10px}.rack-unit .selected{border-color:var(--lime);color:var(--lime)}.ports{display:flex;gap:3px}.ports i{height:7px;width:7px;background:#a0d237;border-radius:1px}.metric-row{display:grid;grid-template-columns:repeat(4,1fr);gap:12px;margin-bottom:16px}.metric{border:1px solid var(--line);border-radius:9px;padding:14px 18px;background:#20272c}.metric strong{font-size:25px;font-weight:600;display:block}.metric small{color:var(--muted);font-size:11px}.chart{width:100%;height:115px;color:var(--lime);background:repeating-linear-gradient(0deg,transparent 0 27px,#34403955 28px)}.chart polyline{stroke-width:2;vector-effect:non-scaling-stroke}.timeline{display:grid;gap:0}.event{padding:14px 0;border-bottom:1px solid var(--line);display:grid;grid-template-columns:65px 12px 1fr;gap:8px;font-size:12px}.event time{color:var(--muted);font-size:11px}.event b{color:var(--lime)}.empty-result{padding:40px;text-align:center;color:var(--muted)}#detail-fields{display:grid;gap:14px}#detail-fields label{display:grid;gap:6px;color:var(--muted);font-size:12px}textarea{background:#151b1f;color:var(--text);border:1px solid var(--line);border-radius:7px;padding:10px;font:inherit;resize:vertical}footer{min-height:42px}#feedback{max-width:330px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}@media(min-width:1400px){#workspace{padding-left:40px;padding-right:40px}}@media(max-width:850px){.split{grid-template-columns:1fr}.rack-layout{grid-template-columns:150px 1fr}.aside{grid-column:1/-1}.metric-row{grid-template-columns:1fr 1fr}.commandbar{flex-wrap:wrap}.controls>#settings{margin-left:0}.badge{font-size:9px}.filterbar input{width:100%}.filterbar{flex-wrap:wrap}.topology{height:300px}}@media(prefers-reduced-motion:no-preference){button{transition:background .12s,border-color .12s}} diff --git a/gui/launcher-prototypes.html b/gui/launcher-prototypes.html new file mode 100644 index 0000000..5e7e65a --- /dev/null +++ b/gui/launcher-prototypes.html @@ -0,0 +1,10 @@ + + +LANCTL · Prototipos de launchers +
+
Prototipo interactivo · datos de ejemplo
+
+

+
Selecciona un elemento para ver sus opciones
+
● Vista de diseñoOficina · VLF de ejemplo
Cambios solo en esta vista
+

diff --git a/gui/launcher-prototypes.js b/gui/launcher-prototypes.js new file mode 100644 index 0000000..163a87a --- /dev/null +++ b/gui/launcher-prototypes.js @@ -0,0 +1,30 @@ +"use strict"; +// Deliberately isolated presentation model: no desktop RPC, secrets or persistence. +const $=s=>document.querySelector(s); +const esc=v=>String(v??"").replace(/[&<>"']/g,c=>({"&":"&","<":"<",">":">",'"':""","'":"'"}[c])); +const icons={wire:'',rack:'',access:'',mon:''}; +const definitions={wire:["LANWIRE","CABLING & TOPOLOGY","Conexiones de red","Traza cada enlace, desde el puerto hasta su destino.","Topología física","Nuevo enlace"],rack:["LANRACK","ROOMS & RACKS","Infraestructura física","Distribución de equipos, espacios y ocupación.","Sala técnica","Nuevo rack"],access:["LANACCESS","CREDENTIALS & ACCESS","Accesos del proyecto","Organiza los perfiles y sus equipos asociados.","Acceso centralizado","Nuevo perfil"],mon:["LANMON","MONITORING & EVENTS","Estado de la red","Disponibilidad, latencia e incidencias en un mismo lugar.","Supervisión","Nueva regla"]}; +const data={wire:[{id:1,name:"Uplink principal",group:"Troncales",a:"Router principal · ether2",b:"Switch planta · Gi1/0/1",type:"Cat 6A",state:"Documentado",description:"Enlace de distribución de la oficina."},{id:2,name:"Puesto recepción",group:"Puestos",a:"Patch panel · 08",b:"Recepción · ETH0",type:"Cat 6",state:"Por verificar",description:"Pendiente de comprobar el etiquetado."},{id:3,name:"AP oficina",group:"Puntos de acceso",a:"Switch planta · Gi1/0/8",b:"AP oficina · LAN",type:"Cat 6 · PoE",state:"Documentado",description:"Punto de acceso del área de trabajo."}],rack:[{id:1,name:"Switch planta",group:"Rack principal",type:"Switch · 1 U",position:"U 18",description:"Distribución de la planta. 24 puertos."},{id:2,name:"Patch panel",group:"Rack principal",type:"Panel · 1 U",position:"U 19",description:"Cableado estructurado de la oficina."},{id:3,name:"NAS oficina",group:"Rack principal",type:"Almacenamiento · 2 U",position:"U 08–09",description:"Almacenamiento y copias locales."}],access:[{id:1,name:"Administración de red",group:"Infraestructura",target:"Router principal",protocol:"SSH",user:"admin-red",state:"Asignado",description:"Perfil de ejemplo. No contiene credenciales reales."},{id:2,name:"Gestión del switch",group:"Infraestructura",target:"Switch planta",protocol:"HTTPS",user:"operador",state:"Asignado",description:"Acceso web de mantenimiento."},{id:3,name:"Almacenamiento",group:"Servicios",target:"NAS oficina",protocol:"HTTPS",user:"admin-nas",state:"Sin asignar",description:"Perfil pendiente de asociación."}],mon:[{id:1,name:"Router principal",group:"Infraestructura",ip:"192.168.1.1",state:"En línea",latency:"2 ms",availability:"99,98 %",description:"Supervisión de conectividad del router."},{id:2,name:"Switch planta",group:"Infraestructura",ip:"192.168.1.2",state:"En línea",latency:"3 ms",availability:"99,95 %",description:"Supervisión de la distribución."},{id:3,name:"NAS oficina",group:"Servicios",ip:"192.168.1.10",state:"Atención",latency:"48 ms",availability:"99,72 %",description:"Latencia superior al umbral de ejemplo."},{id:4,name:"Recepción",group:"Puestos",ip:"192.168.1.24",state:"Sin respuesta",latency:"—",availability:"97,41 %",description:"Última respuesta de ejemplo a las 10:34."}]}; +let app="wire",selected=1,view="map",paused=false,rack="Rack principal",selectionTimer=null; +const feedback=t=>$("#feedback").textContent=t; +const button=(label,action,primary=false)=>``; +function start(next){document.querySelector('link[rel="icon"]').href='../assets/launcher-icons/'+({wire:'lanwire',rack:'lanrack',access:'lanaccess',mon:'lanmon'}[next])+'.svg';app=next;selected=1;view="map";$("#search").value="";const d=definitions[app];$("#brand-icon").innerHTML=``;$("#brand").innerHTML=`LAN${d[0].slice(3)}${d[1]}`;$("#title").textContent=d[2];$("#subtitle").textContent=d[3];$("#eyebrow").textContent=d[4];$("#footer-app").textContent=d[0];$("#launchers").innerHTML=Object.entries(definitions).map(([key,val])=>``).join("");$("#filter").innerHTML=''+[...new Set(data[app].map(x=>x.group))].map(g=>``).join("");render();history.replaceState(null,"","#"+app);} +function rows(){let q=$("#search").value.toLocaleLowerCase();return data[app].filter(r=>(!$("#filter").value||r.group===$("#filter").value)&&Object.values(r).join(" ").toLocaleLowerCase().includes(q));} +function detail(r,extra=""){return ``;} +function table(headers,items,columns){return `
${headers.map(h=>``).join("")}${items.map(r=>`${columns.map(c=>``).join("")}`).join("")}
${h}
${esc(r[c])}
`;} +function render(){let items=rows(),r=items.find(x=>x.id===selected)||items[0];selected=r?.id??null;$("#count").textContent=items.length+" elementos";$("#tools").innerHTML=(app==="wire"?button(view==="map"?"≡ Lista de enlaces":"⌘ Topología","view"):app==="mon"?button(paused?"▷ Reanudar vista":"Ⅱ Pausar vista","pause"):"")+button(definitions[app][5],"new",true);$("#selection").textContent=r?`${r.name} · ${r.group}`:"Sin selección";$("#commands").innerHTML=r?button("Ver detalles","details")+(app!=="mon"?button("Editar","edit"):button("Ver eventos","events")):"";if(!r){$("#canvas").innerHTML='
No hay coincidencias. Prueba otro nombre o grupo.
';return;} +if(app==="wire"){$("#canvas").innerHTML=`
${view==="map"?`
━ Enlace documentadoVista lógica de ejemplo
`:""}${table(["ENLACE","ORIGEN","DESTINO","ESTADO"],items,["name","a","b","state"])}
${detail(r,`
Medio
${esc(r.type)}
Estado
${esc(r.state)}
Origen
${esc(r.a)}
Destino
${esc(r.b)}
`)}
`;} +if(app==="rack"){$("#canvas").innerHTML=`
${["Rack principal","Rack reserva"].map(n=>``).join("")}

Vista frontal
Numeración descendente

${rack}${rack==="Rack principal"?"17 % ocupado":"Sin ocupación"}
${Array.from({length:rack==="Rack principal"?24:12},(_,i)=>{let u=(rack==="Rack principal"?24:12)-i,e=rack==="Rack principal"?items.find(x=>x.id===1&&u===18||x.id===2&&u===19||x.id===3&&(u===8||u===9)):null;return `
${u}
`;}).join("")}
${detail(r,`
Tipo
${esc(r.type)}
Posición
${esc(r.position)}
Vista
Frontal
`)}
`;} +if(app==="access"){$("#canvas").innerHTML=`
◇ Perfiles de demostración

Las claves no se muestran en las listas. Este prototipo no almacena contraseñas.

${table(["PERFIL","EQUIPO","PROTOCOLO","ESTADO"],items,["name","target","protocol","state"])}
${detail(r,`
Usuario
${esc(r.user)}
Protocolo
${esc(r.protocol)}
Equipo
${esc(r.target)}
Secreto
Sin credencial real
`)}
`;$("#commands").innerHTML+= '';} +if(app==="mon"){$("#canvas").innerHTML=`
DISPOSITIVOS4Supervisión de ejemplo
EN LÍNEA3Incluye 1 con atención
SIN RESPUESTA1Recepción
INTERVALO30 s${paused?"Vista pausada":"Datos estáticos de demostración"}
${table(["EQUIPO","IP","ESTADO","LATENCIA","DISPONIBILIDAD"],items,["name","ip","state","latency","availability"])}
LATENCIA · ${esc(r.name)}Últimos 15 min · ejemplo
`;}} +function form(mode){const r=data[app].find(x=>x.id===selected);$("#detail-title").textContent=mode==="settings"?"Preferencias de la vista":mode==="new"?definitions[app][5]:r.name;let fields=mode==="settings"?{density:"Compacta",refresh:"30 segundos (ejemplo)"}:mode==="new"?{name:"",group:"",description:""}:Object.fromEntries(Object.entries(r).filter(([k])=>k!=="id"));const labels={name:"Nombre",group:"Grupo",description:"Descripción",a:"Origen",b:"Destino",type:"Tipo / medio",state:"Estado",target:"Equipo de destino",protocol:"Protocolo",user:"Usuario",position:"Posición",ip:"Dirección IP",latency:"Latencia",availability:"Disponibilidad",density:"Densidad",refresh:"Intervalo visual"};$("#detail-fields").innerHTML=Object.entries(fields).map(([k,v])=>``).join("");$("#detail-form").dataset.mode=mode;$("#detail").showModal();} +document.addEventListener("click",e=>{const b=e.target.closest("button");if(!b)return;if(b.dataset.app)return start(b.dataset.app);if(b.dataset.rack){rack=b.dataset.rack;render();return;}if(b.dataset.id){selected=Number(b.dataset.id);clearTimeout(selectionTimer);selectionTimer=setTimeout(render,280);return;}const a=b.dataset.action;if(a==="view"){view=view==="map"?"list":"map";render();}if(a==="pause"){paused=!paused;render();feedback(paused?"Vista de ejemplo pausada":"Vista de ejemplo reanudada");}if(["new","edit","details"].includes(a))form(a);if(a==="events")feedback("Los eventos de ejemplo se muestran a la derecha");}); +document.addEventListener("dblclick",e=>{if(e.target.closest("[data-id]")){clearTimeout(selectionTimer);selected=Number(e.target.closest("[data-id]").dataset.id);render();form("edit");}}); +document.addEventListener("keydown",e=>{if(e.key==="Enter"&&e.target.matches("tr[data-id]")){selected=Number(e.target.dataset.id);render();form("details");}}); +$("#search").addEventListener("input",render);$("#filter").addEventListener("change",render); +$("#settings").onclick=()=>form("settings");$("#close").onclick=$("#cancel").onclick=()=>$("#detail").close(); +$("#detail-form").onsubmit=e=>{e.preventDefault();let mode=e.target.dataset.mode,values=Object.fromEntries(new FormData(e.target));if(mode==="new"){let item={...data[app][0],...values,id:Math.max(...data[app].map(x=>x.id))+1};data[app].push(item);selected=item.id;}else if(mode!=="settings")Object.assign(data[app].find(x=>x.id===selected),values);$("#detail").close();render();feedback("Aplicado solo al prototipo · no se ha guardado ningún archivo");}; +$("#home").onclick=()=>feedback("En la versión integrada, este botón abrirá LANCTL GUI");$("#cli").onclick=()=>feedback(`En la versión integrada, abrirá el CLI de ${definitions[app][0]}`); +document.querySelector(".controls select").onchange=()=>feedback("Selector visual · se mantienen los datos de demostración"); +$("#clock").textContent=new Intl.DateTimeFormat("es",{hour:"2-digit",minute:"2-digit"}).format(new Date()); +start(Object.hasOwn(definitions,location.hash.slice(1))?location.hash.slice(1):"wire"); diff --git a/gui/launcher.css b/gui/launcher.css new file mode 100644 index 0000000..ba5103a --- /dev/null +++ b/gui/launcher.css @@ -0,0 +1,19 @@ +.shell>#workspace{flex:1;min-height:0}.shell>.commandbar{flex:none}#project-name{margin-left:8px;font-weight:400;color:var(--text)}#storage{max-width:260px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}#status{max-height:70px;flex:none}.table-wrap td{padding:13px 14px}.topology{height:220px;overflow:auto}.graph-inner{position:relative;min-width:700px}.graph-inner>svg{position:absolute;width:100%;height:100%;left:0;top:0;pointer-events:none;color:#7b9e48}.graph-inner .node{transform:translate(-50%,-50%);min-width:100px;max-width:155px;overflow-wrap:anywhere}.aside{min-width:0}.aside dd{overflow-wrap:anywhere}.commandbar button{white-space:nowrap}.rack-unit .ports{overflow:hidden}#detail-fields>label{display:grid;gap:6px;color:var(--muted);font-size:12px}#detail-fields input,#detail-fields select{width:100%}#detail-fields pre{white-space:pre-wrap;overflow-wrap:anywhere;font-size:11px;max-height:330px;overflow:auto;background:#101518;padding:12px;border-radius:8px}#detail-error{color:#ffb5ab;margin-top:12px}#detail-fields details{border:1px solid var(--line);padding:10px;border-radius:7px}#detail-fields summary{cursor:pointer;color:var(--lime)}.settings-option{display:block;width:100%;margin:7px 0;text-align:left;overflow-wrap:anywhere}.empty-result{border:1px dashed var(--line);border-radius:10px;margin-top:12px}.status-offline{color:#edc783}.status-online{color:var(--lime)}.toolbar h1{font-size:22px}.chart-note{font-size:11px;color:var(--muted);margin-top:7px}.record-open{padding:0;border:0;background:none;text-align:left;color:var(--text)}.rack-layout .panel{padding:14px}.rack-list{overflow-wrap:anywhere}.connection-line{font:11px Consolas,monospace;overflow-wrap:anywhere}.locked-vault{max-width:560px;margin:25px auto;text-align:center}.locked-vault h2{font-size:20px;margin-bottom:10px}button[hidden]{display:none!important}#app-notice-text{white-space:pre-line}#app-notice-title{margin-bottom:12px}@media(max-width:900px){.split{grid-template-columns:minmax(0,1fr) 240px}.rack-layout{grid-template-columns:140px minmax(220px,1fr)}.rack-layout .aside{grid-column:1/-1}.filterbar input{width:280px}.metric{padding:10px}.metric-row{grid-template-columns:repeat(4,1fr)}.metric strong{font-size:20px}} +/* LANWIRE uses the full workspace; the only scrolling area is the active view. */ +.wire-app #workspace{padding-top:14px}.wire-app .toolbar{margin-bottom:10px}.wire-app #subtitle{font-size:11px}.wire-app .filterbar{margin-bottom:6px}.wire-app #wire-active-filters{font-size:10px;color:var(--muted);padding-bottom:8px}.wire-app #canvas{display:flex;flex-direction:column;overflow:hidden}.wire-app #canvas>.table-wrap{flex:1;min-height:0;overflow:auto}.wire-app .table-wrap th{resize:horizontal;overflow:auto;min-width:90px}.wire-list-tools{display:flex;align-items:center;gap:8px;margin-bottom:8px}.wire-list-tools label{display:flex;align-items:center;gap:8px}.wire-topology{display:flex;flex-direction:column;flex:1;min-height:0}.wire-navigation{display:flex;flex-wrap:wrap;gap:5px;margin-bottom:8px;align-items:center}.wire-navigation button,.wire-navigation select{padding:6px 9px;font-size:11px}.wire-navigation label{font-size:11px;color:var(--muted);display:flex;gap:5px;align-items:center}#wire-board{position:relative;flex:1;min-height:160px;overflow:hidden;touch-action:none;border:1px solid var(--line);border-radius:10px;background:radial-gradient(#46513f77 1px,transparent 1px) 0 0/20px 20px;cursor:grab}#wire-board:active{cursor:grabbing}#wire-world{position:absolute;inset:0;transform-origin:0 0;pointer-events:none}#wire-lines{position:absolute;left:-20000px;top:-20000px;width:40000px;height:40000px;overflow:visible;transform:translate(20000px,20000px);pointer-events:none}#wire-lines g{pointer-events:stroke;cursor:pointer}#wire-lines path{stroke:#769f48;stroke-width:3;fill:none;pointer-events:stroke}#wire-lines .highlight path{stroke:var(--lime);stroke-width:4}#wire-lines text{fill:var(--muted);stroke:none;font:11px sans-serif;pointer-events:auto}.wire-node{position:absolute;width:190px;min-height:90px;padding:12px;pointer-events:auto;text-align:left;background:#20282d;box-shadow:0 6px 20px #0004;cursor:move}.wire-node.selected{border-color:var(--lime);box-shadow:0 0 0 1px #a8ed2055}.wire-node small{display:block;color:var(--muted);font-size:10px;margin-top:4px}.wire-ports{display:flex;gap:4px;flex-wrap:wrap;margin-top:8px;max-height:72px;overflow:auto}.wire-ports span{font-size:9px;border:1px solid #48574b;border-radius:3px;padding:2px;cursor:crosshair;color:var(--lime)}.wire-node.no-labels small{display:none}.wire-hint{position:absolute;bottom:8px;left:10px;font-size:10px;color:var(--muted);pointer-events:none;background:#101518df;padding:5px 8px;border-radius:5px}#wire-minimap{position:absolute;right:10px;bottom:30px;width:160px;height:100px;background:#101518e8;border:1px solid var(--line);cursor:crosshair}#wire-minimap rect{fill:#607c3c;stroke:none}#wire-minimap .viewport{fill:#b3f62719;stroke:var(--lime);stroke-width:3}.wire-tabs{display:flex;gap:5px;flex-wrap:wrap;position:sticky;top:0;background:#20282d;padding:8px 0;z-index:2}.wire-tabs button{font-size:12px;padding:8px 10px}.wire-tabs .active{color:var(--lime);background:#303c24}.wire-tab-panel{display:grid;gap:13px;padding:12px 0}.wire-tab-panel[hidden]{display:none!important}.wire-tab-panel label{display:grid;gap:7px}.wire-tab-panel dl{display:grid;grid-template-columns:180px 1fr;gap:12px;font-size:12px}.wire-tab-panel dd{overflow-wrap:anywhere;color:var(--muted)}.wire-port-row{display:flex;align-items:center;gap:8px;border-bottom:1px solid var(--line);padding:8px 0}.wire-port-row span{flex:1;font-size:12px}.wire-app #detail{width:min(920px,94vw);max-height:90vh;overflow:hidden}.wire-app #detail-form{display:flex;flex-direction:column;max-height:84vh}.wire-app #detail-fields{overflow:auto;min-height:0;padding-right:8px}.wire-app #detail-form>.actions{flex:none;position:sticky;bottom:0;background:#20282d;padding-top:12px}.wire-app #detail-fields textarea{width:100%;box-sizing:border-box}.wire-app #detail-fields [hidden]{display:none!important}.wire-app #wire-project{font-size:11px}.wire-app #status:empty{display:none}.wire-app .commandbar{padding-top:7px;padding-bottom:7px}.wire-app header{padding-top:12px;padding-bottom:12px} +#wire-lines{left:0;top:0;width:1px;height:1px;transform:none;overflow:visible} +@media(max-height:650px){.wire-app header{padding:8px 24px}.wire-app .brand small{display:none}.wire-app #workspace{padding-top:8px}.wire-app .toolbar h1{font-size:18px}.wire-app #subtitle{display:none}.wire-app .toolbar{margin-bottom:7px}.wire-app .wire-navigation button{padding:5px 7px}.wire-app #status{font-size:10px;margin:0;padding:3px 20px}.wire-app .controls{padding:6px 24px}.wire-app .wire-hint{display:none}} +.wire-port-row{flex-wrap:wrap}.wire-port-row>label{max-width:150px}.wire-port-row>span{min-width:180px} +.wire-app table{table-layout:fixed;min-width:700px}.wire-app th{overflow:visible;resize:none}.wire-column-grip{position:absolute;right:0;top:0;width:8px;height:100%;cursor:col-resize;background:#a5d52c0d}.wire-column-grip:hover{background:#a5d52c55}.wire-app td{overflow-wrap:anywhere} +/* Rack y CPD mantienen la paleta de la suite. */ +.physical-levels{display:flex;gap:8px;flex-wrap:wrap;align-items:center;margin-bottom:8px;font-size:11px}.physical-levels label{display:flex;align-items:center;gap:5px}.physical-levels select,.physical-levels button{padding:6px 9px;font-size:11px}.physical-levels .active{color:var(--lime);background:#303c24}.physical-region{position:absolute;border:1px dashed #718b42;border-radius:18px;background:#50652b0a;color:var(--lime);font-size:14px;padding:18px;box-sizing:border-box;z-index:0;pointer-events:none}.wire-node{z-index:1;box-sizing:border-box}.wire-ports{display:grid;max-height:none;overflow:visible;gap:5px}.wire-ports span{font-size:10px;min-height:20px;display:flex;align-items:center;justify-content:center;cursor:inherit;white-space:nowrap;overflow:hidden}.wire-ports .occupied{background:#45631e;color:#c6ff43;border-color:#95bd3a}.wire-ports .free{color:#a5b79b;background:#172018}#wire-lines{z-index:2}#wire-lines path{stroke-width:2;opacity:.8}#wire-lines circle{fill:var(--lime);stroke:#101518;stroke-width:1}#wire-lines .physical-cable-label{pointer-events:all}#wire-lines .physical-cable-label rect{fill:#10171a;stroke:#536636;stroke-width:1}#wire-lines .physical-cable-label text{fill:#dbe6d0;font-size:11px}.cpd-rooms{overflow:auto;display:grid;gap:18px;align-content:start}.cpd-room{padding:20px}.cpd-room .row{flex-wrap:wrap}.cpd-room h2{margin-right:auto}.cpd-racks{display:flex;flex-wrap:wrap;gap:16px}.rack-cabinet{width:215px;min-height:200px;border:1px solid #566442;background:linear-gradient(135deg,#252f33,#141b1e);padding:18px;text-align:left;display:grid;gap:12px}.rack-cabinet small{color:var(--muted);line-height:1.7}.rack-cabinet>span{font-size:32px;color:#a3ca50;text-align:center;line-height:.85}.rack-detail-layout{display:grid;grid-template-columns:minmax(200px,1fr) minmax(250px,1.4fr);gap:20px;overflow:auto}.rack-detail-layout>.panel{padding:20px;align-self:start}.rack-elevation{background:#101719;border:8px solid #2d363a;border-radius:10px;padding:12px;display:grid;gap:3px}.rack-elevation button{text-align:left;min-height:30px;padding:5px 12px}.rack-elevation button span{display:inline-block;min-width:50px;color:var(--muted)}.rack-elevation .occupied{background:#2e3b24;color:var(--lime)}.rack-app #canvas{overflow:auto}.rack-app #detail{width:min(920px,94vw)} +@media(max-width:700px){.rack-detail-layout{grid-template-columns:1fr}.physical-levels{gap:4px}.physical-levels select{max-width:150px}} +#wire-lines .physical-label-leader{stroke:#60794e;stroke-width:1;stroke-dasharray:3 4;opacity:.6;pointer-events:none}#wire-lines [data-cable]:hover>path{stroke:var(--lime);stroke-width:4}#wire-lines .physical-cable-label:hover text{fill:var(--lime)} +/* Frentes de equipos, escalables en la elevación del armario. */ +.rack-detail-layout{grid-template-columns:minmax(200px,.65fr) minmax(400px,2fr)}.rack-skinned{gap:3px}.rack-skinned .rack-skin-unit{display:flex;align-items:center;gap:9px;padding:2px 5px;box-sizing:border-box;border-radius:3px;background:#192125;min-height:63px}.rack-skinned .rack-skin-unit.occupied{background:#12191d;border-color:#55634a}.rack-skinned .rack-u-label{flex:0 0 44px;font-size:10px;text-align:center;color:var(--muted)}.rack-skinned .rack-skin-face{flex:1;min-width:0;display:block}.rack-face{width:100%;height:auto;display:block}.rack-face .skin-chassis{fill:#283236;stroke:#65716c;stroke-width:2}.rack-face .skin-ear{fill:#3f494c;stroke:#79817c;stroke-width:1}.rack-face .skin-bolt{fill:#101619;stroke:#a2aba1;stroke-width:1}.rack-face .skin-device-name{fill:#e0e8e4;font:600 17px sans-serif}.rack-face .skin-device-id{fill:#93a6a1;font:11px sans-serif}.rack-face .skin-port rect{fill:#0d1418;stroke:#879281;stroke-width:1.5}.rack-face .skin-port path{fill:none;stroke:#ad9d6b;stroke-width:1.2}.rack-face .skin-port text{fill:#bac6bb;font:8px monospace;text-anchor:middle}.rack-face .skin-port.connected rect{stroke:#b7ed38;fill:#293a21}.rack-face .skin-sfp rect{fill:#0d1720;stroke:#8eaabc;stroke-width:2}.rack-face .skin-power{fill:#7e8a80}.rack-face .skin-drive rect{fill:#172024;stroke:#6e7a75;stroke-width:2}.rack-face .skin-drive path{stroke:#83918a;stroke-width:3}.rack-face .skin-drive circle{fill:#809777}.rack-face .skin-display{fill:#142823;stroke:#5b7169;stroke-width:2}.rack-face .skin-display-text{fill:#aac3b2;font:17px monospace;text-anchor:middle}.rack-face .skin-vent{stroke:#121b20;stroke-width:9;stroke-linecap:round;fill:none}.rack-face .skin-tray{stroke:#8b9689;stroke-width:5;fill:none}.rack-skin-preview{padding:12px;border:1px solid var(--line);border-radius:8px;background:#131b1e;min-width:0}.rack-skin-controls{display:grid;grid-template-columns:1fr 1fr;gap:14px}.rack-skin-controls label{min-width:0}.rack-skin-controls select,.rack-skin-controls input{width:100%;box-sizing:border-box}.rack-app #rack-skins-toggle{margin:8px 0}.rack-app #detail .rack-face{max-height:300px}.rack-skinned .rack-skin-empty{min-height:63px;opacity:.5} +@media(max-width:850px){.rack-detail-layout{grid-template-columns:1fr}.rack-skin-controls{grid-template-columns:1fr}.rack-skinned .rack-u-label{flex-basis:32px}} +.rack-face{stroke:none}.rack-skin-size{display:grid;gap:6px;margin:12px 0;color:var(--muted);font-size:11px}.rack-skin-size input{width:100%;accent-color:var(--lime)} +.rack-skinned .rack-skin-face{height:100%;overflow:hidden}.rack-skinned .rack-face{height:100%;max-height:none} + +/* El frente completo es decorativo; la selección pertenece a la unidad. */ +.rack-face,.rack-face *{pointer-events:none;cursor:inherit} diff --git a/gui/launcher.html b/gui/launcher.html new file mode 100644 index 0000000..3ebe590 --- /dev/null +++ b/gui/launcher.html @@ -0,0 +1,9 @@ + +LANCTL +
+
LANCTLINICIANDO INTERFAZ
Conectando…
+
Proyecto —
+

Conectando con los servicios de LANCTL…

+
Sin selección
+

● GUI local
+

diff --git a/gui/launcher.js b/gui/launcher.js new file mode 100644 index 0000000..cac5359 --- /dev/null +++ b/gui/launcher.js @@ -0,0 +1,54 @@ +"use strict"; +const $=s=>document.querySelector(s); +const icons = { + network:'', + cable:'', + server:'', + key:'', + activity:'' +}; +function icon(name){return ``;} +const esc=v=>String(v??"").replace(/[&<>"']/g,c=>({"&":"&","<":"<",">":">",'"':""","'":"'"}[c])); +const definitions={lanwire:["LANWIRE","CABLING & TOPOLOGY","Conexiones e infraestructura","Equipos, cables y puertos del almacén físico.","cable"],lanrack:["LANRACK","ROOMS & RACKS","Infraestructura física","Consulta de racks y ocupantes. La edición se realiza en LANWIRE.","server"],lanaccess:["LANACCESS","CREDENTIALS & ACCESS","Accesos y credenciales","Metadatos y credenciales cifradas del almacén seleccionado.","key"],lanmon:["LANMON","MONITORING & EVENTS","Estado de la red","Métricas e incidencias reales. Abrir esta vista no inicia sondeos.","activity"]}; +let state={launcher:"",records:[]},selected=null,view="map",busy=false,formSubmit=null,formOriginal="",refreshing=false; +const idOf=r=>state.launcher==="lanaccess"?r.credentialId:r.id; +const labelOf=r=>r.data?.name||r.data?.alias||r.name||r.element||r.id||r.credentialId; +const dataOf=r=>r.data||r; +function message(text,error=false){$("#status").textContent=text;$("#status").classList.toggle("error",error);} +async function call(method,...args){const response=await window.pywebview.api[method](...args);if(!response.ok)throw Object.assign(new Error(response.error+(response.errorId?" ("+response.errorId+")":"")),{errorDetails:response.errorDetails});return response;} +async function refresh(){if(refreshing)return;refreshing=true;try{const previousFilter=$("#filter").value;state=await call("bootstrap");const d=definitions[state.launcher];document.title=d[0]+" · LANCTL";$("#brand").innerHTML=`LAN${d[0].slice(3)}${d[1]}`;$("#brand-icon").innerHTML=icon(d[4]);document.querySelector('link[rel="icon"]').href="../assets/launcher-icons/"+state.launcher+".svg";$("#title").textContent=d[2];$("#subtitle").textContent=d[3];$("#project-name").textContent=state.projectName;$("#version").textContent="v"+state.version;$("#connection").textContent="Sesión local";$("#storage").textContent=state.storage;$("#storage").title=state.storage;$("#save").hidden=!state.project||["lanwire","lanrack"].includes(state.launcher);document.querySelector("#app-notice-title").textContent=d[0];const filters=[...new Set(state.records.map(groupOf).filter(Boolean))];$("#filter").innerHTML=''+filters.map(x=>``).join("");if(filters.includes(previousFilter))$("#filter").value=previousFilter;render();}finally{refreshing=false;}} +function groupOf(r){if(state.launcher==="lanwire")return r.data?.type||"element";if(state.launcher==="lanrack")return String(r.location?.room||"Racks");if(state.launcher==="lanaccess")return r.protocol;return r.presence;} +function records(){const query=$("#search").value.trim().toLocaleLowerCase(),filter=$("#filter").value;return state.records.filter(r=>(!filter||groupOf(r)===filter)&&JSON.stringify(r).toLocaleLowerCase().includes(query));} +function button(text,action,primary=false,disabled=false){return ``;} +function table(headers,rows,cells){return '
'+headers.map(h=>``).join("")+''+rows.map(r=>`${cells(r).map((value,i)=>``).join("")}`).join("")+'
${h}
${i===0?``:esc(value??"—")}
';} +function aside(r,fields){return ``;} +function render(){const rows=records(),r=rows.find(x=>idOf(x)===selected)||rows[0];selected=r?idOf(r):null;$("#count").textContent=rows.length+" de "+state.records.length;$("#selection").textContent=r?labelOf(r):"Sin selección";$("#tools").innerHTML=button("Actualizar","refresh")+(state.launcher==="lanwire"?button("Nuevo elemento","new",true):state.launcher==="lanrack"?button("Abrir LANWIRE","wire",true):state.launcher==="lanaccess"?(state.locked?button("Desbloquear","unlock",true):button("Nueva credencial","new",true,false)+(state.portable?button("Bloquear","lock"):"")):button("Iniciar monitor","start",true,!!state.session||!state.project)+button("Detener","stop",false,!state.session)+button("Comprobar una vez","once",false,!!state.session||!state.records.length||!state.project));$("#views").innerHTML=state.launcher==="lanwire"?``:""; +$("#commands").innerHTML=r?button("Ver detalles","details")+(state.launcher==="lanwire"?button("Editar","edit")+(r.data.type==="wire"?button("Conectar / desconectar","connect"):Object.keys(r.data.ports||{}).length?button("Editar puertos","port"):"")+button("Eliminar","delete"):state.launcher==="lanaccess"?button("Actualizar credencial","edit")+button("Conectar ↗","connect",false,!state.devices.some(d=>d.id===r.deviceId))+button("Eliminar","delete"):""):""; +if(state.launcher==="lanaccess"&&state.locked){$("#canvas").innerHTML='

Almacén bloqueado

Introduce la contraseña del almacén para consultar o modificar sus credenciales.

La contraseña y los secretos no se incluyen en las listas ni en los detalles.

'+button(state.newVault?"Preparar almacén cifrado":"Desbloquear almacén","unlock",true)+'
';return;} +if(!r){$("#canvas").innerHTML='
'+(state.records.length?"No hay coincidencias para los filtros.":"Todavía no hay elementos en este almacén.")+'
'+(state.launcher==="lanmon"?events():"");return;} +if(state.launcher==="lanwire")renderWire(rows,r);if(state.launcher==="lanrack")renderRack(rows,r);if(state.launcher==="lanaccess")$("#canvas").innerHTML='
'+table(["EQUIPO","PROTOCOLO","USUARIO","REFERENCIA"],rows,x=>[x.element,x.protocol,x.username,x.credentialId])+aside(r,[["Equipo",r.element],["Protocolo",r.protocol],["Usuario",r.username],["Contraseña","Oculta · almacén cifrado"]])+'
';if(state.launcher==="lanmon")renderMonitor(rows,r);document.querySelectorAll("[data-action]").forEach(b=>{if(busy)b.disabled=true;});} +function renderWire(rows,r){let graph="";if(view==="map"){const nodes=rows.filter(x=>x.data.type!=="wire"),positions=new Map(nodes.map((n,i)=>[n.id,{x:125+(i%4)*250,y:60+Math.floor(i/4)*110}])),height=Math.max(230,Math.ceil(nodes.length/4)*110+20);const lines=rows.filter(x=>x.data.type==="wire").map(w=>{const [a,b]=w.data.endpoints||[],p=positions.get(a?.device),q=positions.get(b?.device);return p&&q?`${esc(w.id)}`:"";}).join("");graph=`
${lines}${nodes.map(n=>{const p=positions.get(n.id);return ``;}).join("")}
━ Cables conectadosPosiciones automáticas · enlaces almacenados
`;} +const ends=(r.data.endpoints||[]).map(x=>x.device+" · "+x.port).join(" ↔ ")||"Sin extremos";$("#canvas").innerHTML='
'+graph+table(["ELEMENTO","IDF","TIPO","CONEXIONES / UBICACIÓN"],rows,x=>[labelOf(x),x.id,x.data.type,x.data.type==="wire"?(x.data.endpoints||[]).map(e=>e.device+"."+e.port).join(" ↔ "):x.data.location?.rack||"—"])+"
"+aside(r,[["IDF",r.id],["Tipo",r.data.type],["Puertos",Object.keys(r.data.ports||{}).length],["Extremos",r.data.type==="wire"?ends:"—"],["Rack",r.data.location?.rack],["Unidad",r.data.location?.unit]])+'
';} +function renderRack(rows,r){const occupied=new Map(r.occupants.map(o=>[Number(o.unit),o]));$("#canvas").innerHTML='
'+rows.map(x=>``).join("")+'
'+esc(r.name)+''+r.units+' U
'+Array.from({length:Math.min(r.units,100)},(_,i)=>{const u=r.units-i,item=occupied.get(u);return `
${u}
`;}).join("")+'
'+aside(r,[["IDF",r.id],["Altura",r.units+" U"],["Ocupantes",r.occupants.length],["Sin unidad",r.occupants.filter(o=>!o.unit).map(o=>o.id).join(", ")||"Ninguno"],["Modo","Consulta · editar en LANWIRE"]])+'
';} +function events(){return '';} +function renderMonitor(rows,r){const online=state.records.filter(x=>x.presence==="online").length,offline=state.records.filter(x=>x.presence==="offline").length;$("#canvas").innerHTML=`
EQUIPOS${state.records.length}Inventario actual
EN LÍNEA${online}Última observación
SIN RESPUESTA${offline}Última observación
MONITOR${state.session?esc(state.session.status):"Detenido"}${state.process?.running?"Proceso activo":"Sin proceso activo"}
${table(["EQUIPO","IP","PRESENCIA","SALUD","LATENCIA"],rows,x=>[x.name,x.ip,x.presence,x.health,x.latency==null?"—":x.latency+" ms"])}
LATENCIA · ${esc(r.name)}Hasta 60 muestras reales
Cargando muestras…
${events()}
`;const expected=r.id;call("monitor_samples",r.id).then(payload=>{if(selected!==expected||!$("#metrics-chart"))return;const samples=payload.samples;if(!samples.length){$("#metrics-chart").textContent="Sin muestras registradas para este equipo.";return;}const values=samples.filter(x=>x.latency_ms!=null),max=Math.max(1,...values.map(x=>x.latency_ms)),points=samples.map((x,i)=>x.latency_ms==null?null:`${i*600/Math.max(1,samples.length-1)},${105-x.latency_ms/max*95}`).filter(Boolean).join(" ");$("#metrics-chart").innerHTML=`

${samples.length} muestras · máximo ${max.toFixed(1)} ms · ${esc(samples[0].timestamp)} — ${esc(samples.at(-1).timestamp)}

`;}).catch(error=>message(error.message,true));} +function field(label,name,value="",type="text",choices=null){const node=document.createElement("label");node.textContent=label;const input=document.createElement(choices?"select":type==="textarea"?"textarea":"input");if(choices)for(const [value,label] of choices)input.add(new Option(label,value));else if(type!=="textarea")input.type=type;input.name=name;input.value=value??"";if(type==="textarea")input.rows=4;if(type==="password"){input.autocomplete="new-password";input.required=true;}node.append(input);return node;} +function showForm(title,fields,submit=null){$("#detail-title").textContent=title;$("#detail-fields").replaceChildren(...fields);$("#detail-error").textContent="";$("#submit").hidden=!submit;$("#cancel").textContent=submit?"Cancelar":"Cerrar";formSubmit=submit;formOriginal=JSON.stringify([...new FormData($("#detail-form"))]);if(!$("#detail").open)$("#detail").showModal();} +async function dismiss(){if(formSubmit&&formOriginal!==JSON.stringify([...new FormData($("#detail-form"))])&&!await appDecision("Hay cambios sin guardar. ¿Descartarlos?"))return;$("#detail").close();$("#detail-fields").replaceChildren();formSubmit=null;} +function fullDetails(r){const pre=document.createElement("pre");pre.textContent=JSON.stringify(r,null,2);showForm("Detalle · "+labelOf(r),[pre]);} +function wireNew(){const choices=[["switch.24ports","Switch · 24 puertos"],["switch.5ports","Switch · 5 puertos"],["router.gateway","Router"],["pc.1port","PC · 1 puerto"],["server.2ports","Servidor · 2 puertos"],["wire.copper","Cable de cobre"],["wire.fiber","Cable de fibra"],["wire.dac","Cable DAC"],["rack","Rack"]];const fields=[field("Tipo","kind","switch.24ports","text",choices),field("Prefijo IDF","prefix","SW"),field("Nombre","name"),field("Alias","alias"),field("Descripción","description","","textarea"),field("Unidades (solo rack)","units",42,"number")];showForm("Nuevo elemento físico",fields,async values=>{const result=await call("wire_create",{...values,units:Number(values.units)});selected=result.id;});} +function wireEdit(r){const d=r.data,racks=state.records.filter(x=>x.data.type==="rack");showForm("Editar · "+labelOf(r),[field("Nombre","name",d.name),field("Alias","alias",d.alias),field("Descripción","description",d.description,"textarea"),field("Rack","rack",d.location?.rack,"text",[["","Sin rack"],...racks.filter(x=>x.id!==r.id).map(x=>[x.id,labelOf(x)])]),field("Unidad","unit",d.location?.unit,"number")],values=>call("wire_update",r.id,r.revision,{...values,unit:values.unit?Number(values.unit):null}));} +function wireConnect(r){const choices=[["","Sin conectar"],...state.records.flatMap(x=>Object.keys(x.data.ports||{}).map(port=>[x.id+"|"+port,labelOf(x)+" · "+port]))],ends=r.data.endpoints||[];showForm("Extremos · "+labelOf(r),[field("Extremo A","a",ends[0]?ends[0].device+"|"+ends[0].port:"","text",choices),field("Extremo B","b",ends[1]?ends[1].device+"|"+ends[1].port:"","text",choices)],values=>call("wire_connect",r.id,r.revision,[values.a,values.b].filter(Boolean).map(x=>{const [device,port]=x.split("|");return {device,port};})));} +function wirePort(r){const ports=Object.keys(r.data.ports||{});showForm("Editar puerto · "+labelOf(r),[field("Puerto","port",ports[0],"text",ports.map(x=>[x,x])),field("Nombre nuevo","name",ports[0]),field("Posición","position",1,"number")],values=>call("wire_port",r.id,r.revision,values.port,values.name,Number(values.position)));} +function accessForm(r=null){const choices=state.devices.map(d=>[d.id,d.name||d.id]);if(!choices.length){message("Añade primero un equipo al inventario con LANIP.",true);return;}showForm(r?"Actualizar credencial":"Nueva credencial",[field("Equipo","device",r?.deviceId||choices[0][0],"text",choices),field("Protocolo","protocol",r?.protocol||"ssh","text",["ssh","https","http","rdp","smb","ftp","telnet","tr-064"].map(x=>[x,x])),field("Usuario","username",r?.username),field("Contraseña","password","","password"),field("Repetir contraseña","confirmation","","password")],values=>call("access_set",values.device,values.protocol,values.username,values.password,values.confirmation));} +function unlock(){const fields=[field("Contraseña del almacén","password","","password")];if(state.newVault)fields.push(field("Repetir contraseña (mínimo 12 caracteres)","confirmation","","password"));showForm(state.newVault?"Preparar almacén cifrado":"Desbloquear almacén",fields,values=>call("access_unlock",values.password,values.confirmation||""));} +async function settings(){const payload=await call("settings"),list=document.createElement("div"),search=field("Buscar configuración","query");list.append(search);const options=[];for(const category of [...new Set(payload.entries.map(x=>x.category))]){const group=document.createElement("details"),summary=document.createElement("summary");summary.textContent=payload.categories[category]||category;group.append(summary);group.open=true;for(const e of payload.entries.filter(x=>x.category===category)){const b=document.createElement("button");b.type="button";b.className="settings-option";b.textContent=e.path+(e.readOnly?" · Solo lectura":"");b.onclick=()=>{const object=e.value===null||typeof e.value==="object",type=typeof e.value==="number"?"number":typeof e.value==="boolean"?"select":object?"textarea":"text";const note=document.createElement("p");note.textContent=e.readOnly||"Ajuste compartido; se valida antes de guardar.";showForm(e.path,[note,field("Valor"+(object?" JSON":""),"value",object?JSON.stringify(e.value,null,2):String(e.value),type,type==="select"?[["true","Activado"],["false","Desactivado"]]:null)],e.readOnly?null:values=>call("save_setting",e.path,object?JSON.parse(values.value):type==="number"?Number(values.value):type==="select"?values.value==="true":values.value));};group.append(b);options.push(b);}list.append(group);}search.querySelector("input").oninput=e=>options.forEach(b=>b.hidden=!b.textContent.toLocaleLowerCase().includes(e.target.value.toLocaleLowerCase()));showForm("Configuración · "+state.launcher.toUpperCase(),[list]);} +async function action(name){if(busy)return;const r=state.records.find(x=>idOf(x)===selected);if(name==="refresh")return refresh();if(name==="details"&&r)return fullDetails(r);if(name==="new")return state.launcher==="lanwire"?wireNew():accessForm();if(name==="edit"&&r)return state.launcher==="lanwire"?wireEdit(r):accessForm(r);if(name==="port"&&r)return wirePort(r);if(name==="unlock")return unlock();if(name==="connect"&&r&&state.launcher==="lanwire")return wireConnect(r);if(name==="wire")return call("open_gui","lanwire");if(name==="delete"&&r){if(!await appDecision("¿Eliminar "+labelOf(r)+"? Esta operación modifica el almacén real."))return;}if(["start","stop","once"].includes(name)&&!await appDecision(name==="start"?"¿Iniciar la monitorización real de este proyecto? Continuará al cerrar la ventana.":name==="stop"?"¿Detener la sesión de monitorización de este proyecto?":"¿Comprobar ahora los equipos de este proyecto? Se realizarán sondeos de red."))return;busy=true;render();try{if(name==="delete")await(state.launcher==="lanwire"?call("wire_delete",r.id,r.revision):call("access_delete",r.credentialId));if(name==="lock")await call("access_lock");if(name==="connect"&&state.launcher==="lanaccess"){const result=await call("access_open",r.credentialId);message(result.message);return;}if(["start","stop","once"].includes(name)){const result=await call("monitor_action",name);message("Operación completada · "+(result.result.status||result.result.session?.status||name));}await refresh();}finally{busy=false;render();}} +let clickTimer=null; +document.addEventListener("click",e=>{const button=e.target.closest("button");const target=button?.dataset.select||e.target.closest("[data-id]")?.dataset.id;if(target){clearTimeout(clickTimer);selected=target;clickTimer=setTimeout(render,240);return;}if(!button)return;if(button.dataset.view){view=button.dataset.view;render();return;}if(button.dataset.incident){const incident=state.incidents.find(i=>i.incidentId===button.dataset.incident);const pre=document.createElement("pre");pre.textContent=JSON.stringify(incident,null,2);const actions=document.createElement("div");actions.className="row";for(const [verb,label] of [["acknowledge","Reconocer"],["close","Cerrar incidencia"]]){const b=document.createElement("button");b.type="button";b.textContent=label;b.disabled=incident.status==="closed";b.onclick=async()=>{try{await call("monitor_incident",incident.incidentId,verb);$("#detail").close();await refresh();message("Incidencia actualizada");}catch(error){$("#detail-error").textContent=error.message;}};actions.append(b);}showForm("Incidencia",[pre,actions]);return;}if(button.dataset.occupant){const item=state.records.find(x=>x.id===selected)?.occupants.find(x=>x.id===button.dataset.occupant);if(item)fullDetails(item);return;}if(button.dataset.action)action(button.dataset.action).catch(error=>message(error.message,true));}); +document.addEventListener("dblclick",e=>{const row=e.target.closest("[data-id]");if(row){clearTimeout(clickTimer);selected=row.dataset.id;fullDetails(state.records.find(x=>idOf(x)===selected));}}); +$("#search").oninput=render;$("#filter").onchange=render;$("#settings").onclick=()=>settings().catch(error=>message(error.message,true));$("#home").onclick=()=>call("open_gui","lanctl").then(x=>message(x.message)).catch(e=>message(e.message,true));$("#cli").onclick=()=>call("open_cli").then(x=>message(x.message)).catch(e=>message(e.message,true));$("#save").onclick=()=>call("save_project").then(x=>message(x.message)).catch(e=>message(e.message,true));$("#close").onclick=$("#cancel").onclick=dismiss;$("#detail").addEventListener("cancel",e=>{e.preventDefault();dismiss();}); +$("#detail-form").onsubmit=async e=>{e.preventDefault();if(!formSubmit||busy)return;busy=true;$("#submit").disabled=true;try{await formSubmit(Object.fromEntries(new FormData(e.target)));$("#detail").close();$("#detail-fields").replaceChildren();formSubmit=null;await refresh();message("Cambios guardados en el almacén real.");}catch(error){$("#detail-error").textContent=error.message;}finally{busy=false;$("#submit").disabled=false;render();}}; +async function launcherClose(){try{if(busy){message("Espera a que termine la operación antes de cerrar.");return;}if($("#detail").open){await dismiss();if($("#detail").open)return;}const payload=await call("project_state");if(payload.dirty){if(!await appDecision("El proyecto tiene cambios pendientes. ¿Guardarlos antes de cerrar?"))return;await call("save_project");}await call("request_close");}catch(error){message(error.message,true);}} +window.addEventListener("pywebviewready",()=>refresh().catch(error=>message(error.message,true))); +setInterval(()=>{$("#clock").textContent=new Date().toLocaleTimeString("es",{hour:"2-digit",minute:"2-digit"});if(state.launcher&&!busy&&!$("#detail").open&&!appNotice.open)refresh().catch(error=>message(error.message,true));},5000); diff --git a/gui/monitor-support.js b/gui/monitor-support.js new file mode 100644 index 0000000..da3f916 --- /dev/null +++ b/gui/monitor-support.js @@ -0,0 +1,252 @@ +"use strict"; + +// LANMON owns activity, operational logs and the reviewable diagnostic workflow. +(() => { + let page = "network", + paused = false, + reading = false, + rows = [], + session = "", + allProjects = false; + const baseRender = render; + function navigation() { + $("#views").innerHTML = [ + ["network", "Monitorización"], + ["activity", "Actividad"], + ["logs", "Registros"], + ] + .map( + ([id, label]) => + ``, + ) + .join(""); + } + render = function () { + if (state.launcher !== "lanmon") return baseRender(); + if (page === "network") { + baseRender(); + navigation(); + $("#workspace .filterbar").hidden = false; + return; + } + navigation(); + $("#workspace .filterbar").hidden = true; + $("#title").textContent = + page === "logs" ? "Registros operativos" : "Actividad de las interfaces"; + $("#subtitle").textContent = + page === "logs" + ? "Registro incremental de LANCTL. La pausa detiene la actualización de esta vista." + : "Mensajes con origen, proyecto y sesión. El historial de monitorización se mantiene separado."; + $("#tools").innerHTML = + ''; + $("#commands").replaceChildren(); + $("#selection").textContent = + "LANMON · " + (page === "logs" ? "Registros" : "Actividad"); + if (!$("#monitor-evidence")) { + $("#canvas").innerHTML = + `

`; + $("#monitor-query").oninput = paint; + $("#monitor-level").onchange = paint; + $("#monitor-session").onchange = (event) => { + session = event.target.value; + load(); + }; + $("#monitor-all-projects").checked = allProjects; + $("#monitor-all-projects").onchange = (event) => { + allProjects = event.target.checked; + session = ""; + load(); + }; + $("#monitor-pause").onclick = () => { + paused = !paused; + $("#monitor-pause").textContent = paused ? "Reanudar" : "Pausar"; + if (!paused) load(); + }; + } + $("#monitor-session-label").hidden = page === "logs"; + $("#monitor-projects-label").hidden = page === "logs"; + paint(); + load(); + }; + function paint() { + if (!$("#monitor-evidence")) return; + const query = $("#monitor-query").value.toLocaleLowerCase(), + level = Number($("#monitor-level").value); + const visible = rows.filter( + (row) => + (!level || Number(row.level || 0) >= level) && + JSON.stringify(row).toLocaleLowerCase().includes(query), + ); + $("#monitor-evidence-status").textContent = + `${visible.length} registros · máximo 500${paused ? " · En pausa" : ""}`; + const host = $("#monitor-evidence"), + fragment = document.createDocumentFragment(); + for (const row of visible) { + const article = document.createElement("article"), + meta = document.createElement("small"), + text = document.createElement("pre"); + meta.textContent = [ + row.created, + row.launcher || row.source, + row.session, + row.project || row.file, + row.level ? "Nivel " + row.level : "", + ] + .filter(Boolean) + .join(" · "); + text.textContent = row.message; + article.append(meta, text); + fragment.append(article); + } + host.replaceChildren(fragment); + } + async function load() { + if (reading || paused || state.launcher !== "lanmon" || page === "network") + return; + reading = true; + try { + const result = + page === "logs" + ? await call("monitor_logs") + : await call("monitor_activity", session || null, allProjects); + rows = result.records; + if (page === "activity" && $("#monitor-session")) { + const select = $("#monitor-session"); + select.innerHTML = + '' + + result.sessions + .map((id) => ``) + .join(""); + select.value = session; + } + paint(); + } catch (error) { + if ($("#monitor-evidence-status")) + $("#monitor-evidence-status").textContent = error.message; + } finally { + reading = false; + } + } + const report = document.createElement("dialog"); + report.className = "support-dialog report-dialog"; + report.setAttribute("aria-label", "Preparar reporte en LANMON"); + report.innerHTML = `

Preparar reporte

Revisa los datos antes de abrir GitHub. La incidencia se publica desde el navegador cuando tú la envíes.

Datos que se incluirán

Las credenciales se excluyen siempre. No se adjunta el proyecto completo.

`; + document.body.append(report); + let prepared = false; + function invalidate() { + prepared = false; + report + .querySelectorAll('[data-report="export"],[data-report="github"]') + .forEach((b) => (b.disabled = true)); + report.querySelector(".report-preview").hidden = true; + } + report.addEventListener("input", invalidate); + report.querySelector('[data-report="close"]').onclick = () => report.close(); + report.querySelector("form").onsubmit = async (event) => { + event.preventDefault(); + const form = event.target, + button = form.querySelector('[type="submit"]'); + button.disabled = true; + try { + const values = { + session: form.elements.reportSession.value, + description: form.elements.description.value, + steps: form.elements.steps.value, + expected: form.elements.expected.value, + }; + for (const key of [ + "includeErrors", + "includeActivity", + "includeLogs", + "includePlugins", + "anonymize", + ]) + values[key] = form.elements[key].checked; + const result = await call("prepare_report", values); + const preview = report.querySelector(".report-preview"); + preview.textContent = result.markdown; + preview.hidden = false; + prepared = true; + report + .querySelectorAll('[data-report="export"],[data-report="github"]') + .forEach((b) => (b.disabled = false)); + report.querySelector(".report-state").textContent = + "Borrador preparado. Comprueba la vista previa antes de continuar."; + } catch (error) { + report.querySelector(".report-state").textContent = error.message; + } finally { + button.disabled = false; + } + }; + for (const [action, method] of [ + ["export", "export_report"], + ["github", "open_report_form"], + ]) + report.querySelector(`[data-report="${action}"]`).onclick = async () => { + if (!prepared) return; + try { + const result = await call(method); + report.querySelector(".report-state").textContent = result.cancelled + ? "Exportación cancelada." + : result.path + ? "Diagnóstico exportado: " + result.path + : result.opened + ? "Formulario abierto para tu revisión." + : "No se ha podido abrir el navegador."; + } catch (error) { + report.querySelector(".report-state").textContent = error.message; + } + }; + window.openLanmonView = async function (next) { + if (state.launcher !== "lanmon") return call("open_monitor", next); + if (next === "report") { + if (!report.open) { + const evidence = await call("monitor_activity", null, false); + const select = report.querySelector('[name="reportSession"]'); + select.innerHTML = + '' + + evidence.sessions + .map((id) => ``) + .join(""); + select.value = evidence.sessions.includes(session) ? session : ""; + invalidate(); + report.showModal(); + } + return; + } + page = next; + rows = []; + $("#canvas").replaceChildren(); + render(); + }; + document.addEventListener("click", (event) => { + const button = event.target.closest("button"); + if (!button) return; + if (button.dataset.monitorPage) { + page = button.dataset.monitorPage; + rows = []; + $("#canvas").replaceChildren(); + render(); + } + if (button.hasAttribute("data-monitor-report")) + window.openLanmonView("report"); + }); + window.addEventListener("pywebviewready", async () => { + if (!window.pywebview?.api.monitor_view) return; + try { + const initial = await call("monitor_view"); + if (initial.view) { + session = initial.sourceSession; + const timer = setInterval(() => { + if (state.launcher) { + clearInterval(timer); + window.openLanmonView(initial.view); + } + }, 100); + } + } catch (error) { + console.warn(error.message); + } + }); + setInterval(load, 1500); +})(); diff --git a/gui/physical-gui.js b/gui/physical-gui.js new file mode 100644 index 0000000..1ba7aa8 --- /dev/null +++ b/gui/physical-gui.js @@ -0,0 +1,1114 @@ +/* Organización física compartida: CPD, racks y navegación de topología. */ +let physicalLevel = "inside", + physicalRack = "", + physicalCpd = "", + physicalBundles = true; +let physicalRegions = [], + physicalOriginalEdges = [], + physicalLabelBounds = []; +const physicalViews = new Map(), + physicalSignatures = new Map(); +wireNames["rack.summary"] = "Armario rack"; +wirePositionKey = function () { + return ( + "lanwire.layout.v2." + + state.storage + + ":" + + physicalLevel + + ":" + + physicalRack + + ":" + + physicalCpd + ); +}; +const physicalBase = { + render, + refresh, + fullDetails, + topology: wireRenderTopology, + paint: wirePaint, + pointer: wirePointer, + bounds: wireBounds, + center: wireCenterFromDetails, +}; +function wireOrderedPorts(n) { + const targets = new Map(); + for (const e of wireEdges()) { + const local = + e.a?.device === n.id ? e.a : e.b?.device === n.id ? e.b : null; + const remote = local === e.a ? e.b : e.a; + if (local) + targets.set(local.port, wirePositions[remote?.device] || { x: 0, y: 0 }); + } + return Object.keys(n.data.ports || {}).sort((a, b) => { + const pa = n.data.ports[a], + pb = n.data.ports[b], + ta = targets.get(a), + tb = targets.get(b); + return ( + String(pa.kind || "").localeCompare(String(pb.kind || "")) || + Number(Boolean(tb)) - Number(Boolean(ta)) || + (ta && tb ? ta.x - tb.x || ta.y - tb.y : 0) || + a.localeCompare(b, "es", { numeric: true }) + ); + }); +} +function physicalRackOf(r) { + return ["rack", "rack.summary"].includes(r.data?.type) + ? r.id + : r.data?.location?.rack || ""; +} +function physicalCpdOf(rack) { + return state.records.find((r) => r.id === rack)?.data?.location?.cpd || ""; +} +function physicalRoomName(id) { + return state.cpds?.find((c) => c.id === id)?.name || "Sin CPD"; +} +function physicalSize(n) { + if (n.physicalSize) return n.physicalSize; + const count = Object.keys(n.data.ports || {}).length; + const cols = count > 24 ? 12 : count > 8 ? 8 : Math.max(1, count); + return { + w: count ? Math.max(240, cols * 43 + 28) : 240, + h: 90 + Math.ceil(count / cols) * 29, + }; +} +// Fuerzas deterministas por componente: atracción de cables y separación de tarjetas. +function physicalPack(nodes, edges) { + const sizes = new Map(nodes.map((n) => [n.id, physicalSize(n)])); + const adjacency = new Map(nodes.map((n) => [n.id, new Set()])); + for (const e of edges) + if ( + adjacency.has(e.a?.device) && + adjacency.has(e.b?.device) && + e.a.device !== e.b.device + ) { + adjacency.get(e.a.device).add(e.b.device); + adjacency.get(e.b.device).add(e.a.device); + } + const result = new Map(), + seen = new Set(); + let offsetX = 0, + offsetY = 0, + rowH = 0; + const connected = nodes + .filter((n) => adjacency.get(n.id).size) + .sort( + (a, b) => + adjacency.get(b.id).size - adjacency.get(a.id).size || + a.id.localeCompare(b.id), + ); + for (const root of connected) { + if (seen.has(root.id)) continue; + const ids = [], + queue = [root.id]; + seen.add(root.id); + while (queue.length) { + const id = queue.shift(); + ids.push(id); + for (const next of adjacency.get(id)) + if (!seen.has(next)) { + seen.add(next); + queue.push(next); + } + } + const positions = ids.map((id, i) => ({ + id, + x: i ? Math.cos(i * 2.39996) * Math.sqrt(i) * 220 : 0, + y: i ? Math.sin(i * 2.39996) * Math.sqrt(i) * 220 : 0, + })); + const index = new Map(positions.map((p) => [p.id, p])); + // El límite mantiene la interacción acotada incluso en instalaciones grandes. + const iterations = ids.length > 200 ? 45 : 110; + for (let step = 0; step < iterations; step++) { + const forces = new Map(ids.map((id) => [id, { x: 0, y: 0 }])); + for (let i = 0; i < positions.length; i++) + for (let j = i + 1; j < positions.length; j++) { + const a = positions[i], + b = positions[j], + sa = sizes.get(a.id), + sb = sizes.get(b.id); + let dx = b.x - a.x, + dy = b.y - a.y; + if (!dx && !dy) dx = 1; + const overlapX = (sa.w + sb.w) / 2 + 80 - Math.abs(dx), + overlapY = (sa.h + sb.h) / 2 + 85 - Math.abs(dy); + if (overlapX > 0 && overlapY > 0) { + const axis = overlapX < overlapY ? "x" : "y", + delta = axis === "x" ? dx : dy; + const f = + (axis === "x" ? overlapX : overlapY) * + 0.32 * + Math.sign(delta || 1); + forces.get(a.id)[axis] -= f; + forces.get(b.id)[axis] += f; + } + } + for (const a of positions) + for (const id of adjacency.get(a.id)) { + const b = index.get(id), + dx = b.x - a.x, + dy = b.y - a.y, + d = Math.hypot(dx, dy) || 1; + const desired = (sizes.get(a.id).w + sizes.get(id).w) / 2 + 140; + const f = (d - desired) * 0.025; + forces.get(a.id).x += (dx / d) * f; + forces.get(a.id).y += (dy / d) * f; + } + for (const p of positions) { + const f = forces.get(p.id); + p.x += Math.max(-32, Math.min(32, f.x)); + p.y += Math.max(-32, Math.min(32, f.y)); + } + } + // Separación final sin fuerzas de atracción para garantizar tarjetas no solapadas. + for (let step = 0; step < Math.min(80, ids.length * 3); step++) { + let changed = false; + for (let i = 0; i < positions.length; i++) + for (let j = i + 1; j < positions.length; j++) { + const a = positions[i], + b = positions[j], + sa = sizes.get(a.id), + sb = sizes.get(b.id), + dx = b.x - a.x, + dy = b.y - a.y; + const ox = (sa.w + sb.w) / 2 + 55 - Math.abs(dx), + oy = (sa.h + sb.h) / 2 + 70 - Math.abs(dy); + if (ox > 0 && oy > 0) { + changed = true; + if (ox < oy) { + const v = (ox / 2 + 0.1) * Math.sign(dx || 1); + a.x -= v; + b.x += v; + } else { + const v = (oy / 2 + 0.1) * Math.sign(dy || 1); + a.y -= v; + b.y += v; + } + } + } + if (!changed) break; + } + const minX = Math.min(...positions.map((p) => p.x - sizes.get(p.id).w / 2)), + minY = Math.min(...positions.map((p) => p.y - sizes.get(p.id).h / 2)); + const width = + Math.max(...positions.map((p) => p.x + sizes.get(p.id).w / 2)) - minX, + height = + Math.max(...positions.map((p) => p.y + sizes.get(p.id).h / 2)) - minY; + if (offsetX && offsetX + width > 1800) { + offsetX = 0; + offsetY += rowH + 140; + rowH = 0; + } + for (const p of positions) + result.set(p.id, { + x: offsetX + p.x - minX - sizes.get(p.id).w / 2, + y: offsetY + p.y - minY - sizes.get(p.id).h / 2, + }); + offsetX += width + 150; + rowH = Math.max(rowH, height); + } + const empty = nodes.filter((n) => !seen.has(n.id)); + const top = offsetY + rowH + (connected.length ? 160 : 0); + const maxW = Math.max(260, ...empty.map((n) => sizes.get(n.id).w + 50)), + maxH = Math.max(150, ...empty.map((n) => sizes.get(n.id).h + 60)); + empty.forEach((n, i) => + result.set(n.id, { x: (i % 4) * maxW, y: top + Math.floor(i / 4) * maxH }), + ); + return result; +} +wireLayout = function (nodes) { + const edges = wireEdges(); + physicalRegions = []; + const groupOfNode = (n) => + physicalLevel === "outside" + ? n.data.location?.cpd || "" + : physicalRackOf(n); + const groups = new Map(); + for (const n of nodes) { + const id = groupOfNode(n); + if (!groups.has(id)) groups.set(id, []); + groups.get(id).push(n); + } + const regions = []; + for (const [id, items] of groups) { + // Los enlaces salientes también influyen en la distribución local. + const localIds = new Set(items.map((n) => n.id)), + proxies = new Map(); + const localEdges = edges + .filter((e) => localIds.has(e.a?.device) || localIds.has(e.b?.device)) + .map((e) => { + const mapEnd = (end) => { + if (!end || localIds.has(end.device)) return end; + const remote = state.records.find((n) => n.id === end.device); + const id = "@outside:" + (remote ? groupOfNode(remote) : end.device); + if (!proxies.has(id)) + proxies.set(id, { id, data: {}, physicalSize: { w: 80, h: 65 } }); + return { ...end, device: id }; + }; + return { a: mapEnd(e.a), b: mapEnd(e.b) }; + }); + const local = physicalPack([...items, ...proxies.values()], localEdges); + const w = + Math.max( + 300, + ...items.map((n) => local.get(n.id).x + physicalSize(n).w), + ) + 80, + h = + Math.max( + 140, + ...items.map((n) => local.get(n.id).y + physicalSize(n).h), + ) + 100; + regions.push({ + id, + items, + local, + physicalSize: { w, h }, + data: {}, + label: + physicalLevel === "outside" + ? state.cpds?.find((c) => c.id === id)?.name || "Sin CPD" + : id + ? labelOf(state.records.find((r) => r.id === id) || { id }) + : "Equipos sin rack", + }); + } + const nodeGroups = new Map(nodes.map((n) => [n.id, groupOfNode(n)])); + const links = edges + .filter((e) => nodeGroups.has(e.a?.device) && nodeGroups.has(e.b?.device)) + .map((e) => ({ + a: { device: nodeGroups.get(e.a.device) }, + b: { device: nodeGroups.get(e.b.device) }, + })); + const places = physicalPack(regions, links), + result = new Map(); + for (const region of regions) { + const p = places.get(region.id); + physicalRegions.push({ + id: region.id, + x: p.x, + y: p.y, + w: region.physicalSize.w, + h: region.physicalSize.h, + label: region.label, + }); + for (const n of region.items) { + const point = region.local.get(n.id); + result.set(n.id, { x: p.x + 40 + point.x, y: p.y + 65 + point.y }); + } + } + return result; +}; +function physicalSwitchLevel(level, rack = "", cpd = physicalCpd) { + const key = physicalLevel + ":" + physicalRack + ":" + physicalCpd; + physicalViews.set(key, { + positions: structuredClone(wirePositions), + camera: { ...camera }, + focus: wireFocus, + }); + wireSavePositions(); + physicalLevel = level; + physicalRack = rack; + physicalCpd = cpd; + wireFocus = null; + wireHidden.clear(); + const saved = physicalViews.get(level + ":" + rack + ":" + physicalCpd); + if (!saved) wireLoadPositions(); + wirePositions = saved?.positions || wirePositions; + camera = saved?.camera || { x: 40, y: 40, z: 1 }; + wireFocus = saved?.focus || null; + render(); + if (!saved) wireFit(); +} +wireRenderTopology = function (rows) { + physicalLabelBounds = []; + physicalOriginalEdges = wireEdges(); + const scope = physicalLevel + ":" + physicalRack + ":" + physicalCpd; + const signature = JSON.stringify( + state.records.map((r) => [ + r.id, + r.data.location, + Object.keys(r.data.ports || {}), + r.data.endpoints, + r.data.source, + ]), + ); + if ( + physicalSignatures.has(scope) && + physicalSignatures.get(scope) !== signature + ) + wirePositions = {}; + physicalSignatures.set(scope, signature); + const original = state.records; + const effectiveRack = physicalRack || wireFilter.rack; + const rackAllowed = (id) => + (!effectiveRack || id === effectiveRack) && + (!physicalCpd || + (physicalCpd === "none" + ? !physicalCpdOf(id) + : physicalCpdOf(id) === physicalCpd)); + if (physicalLevel === "outside") { + const allowedIds = new Set(rows.map((r) => r.id)); + const contextFiltered = Boolean( + $("#search").value.trim() || + $("#filter").value || + Object.values(wireFilter).some(Boolean), + ); + const eligible = new Set(rows.map(physicalRackOf)); + for (const edge of physicalOriginalEdges) + if (allowedIds.has(edge.wire.id)) + for (const end of [edge.a, edge.b]) + if (end) { + const r = original.find((r) => r.id === end.device); + if (r) eligible.add(physicalRackOf(r)); + } + const racks = original.filter( + (r) => + r.data.type === "rack" && + rackAllowed(r.id) && + (!contextFiltered || eligible.has(r.id)), + ); + const represented = new Set(racks.map((r) => r.id)); + const context = new Map(); + const visibleEdges = []; + for (const e of physicalOriginalEdges) { + const mapEnd = (end) => { + if (!end) return null; + const record = original.find((r) => r.id === end.device); + const rack = record?.data.location?.rack; + return { + device: rack || end.device, + port: record ? labelOf(record) + " · " + end.port : end.port, + }; + }; + const a = mapEnd(e.a), + b = mapEnd(e.b); + if (!a && !b) continue; + const touches = represented.has(a?.device) || represented.has(b?.device); + const unassigned = + (!physicalRack || physicalRack === "none") && + !physicalCpd && + [e.a, e.b].some( + (end) => + end && + allowedIds.has(end.device) && + (physicalRack !== "none" || + !original.find((r) => r.id === end.device)?.data.location?.rack), + ); + if (!touches && !unassigned) continue; + if (a?.device === b?.device) continue; + if ( + !allowedIds.has(e.wire.id) && + ![e.a, e.b].some((end) => end && allowedIds.has(end.device)) && + !racks.some((r) => allowedIds.has(r.id)) + ) + continue; + for (const end of [a, b]) + if (end && !represented.has(end.device)) { + const r = original.find((r) => r.id === end.device); + if (r) + context.set(r.id, { + ...r, + data: { + ...r.data, + ports: {}, + type: r.data.type === "rack" ? "rack.summary" : r.data.type, + }, + }); + } + visibleEdges.push({ + ...e, + wire: { + ...e.wire, + data: { + ...e.wire.data, + source: undefined, + endpoints: [a, b].filter(Boolean), + }, + }, + }); + } + const grouped = new Map(); + for (const e of visibleEdges) { + const key = physicalBundles + ? [e.wire.data.endpoints[0]?.device, e.wire.data.endpoints[1]?.device] + .sort() + .join("|") + : e.wire.id; + if (!grouped.has(key)) grouped.set(key, []); + grouped.get(key).push(e); + } + const wires = [...grouped.values()].map((es) => ({ + ...es[0].wire, + bundle: es.map((e) => e.wire.id), + })); + const nodes = [ + ...racks.map((r) => ({ + ...r, + data: { ...r.data, type: "rack.summary", ports: {} }, + })), + ...context.values(), + ]; + state.records = [...nodes, ...wires]; + try { + physicalBase.topology(state.records); + } finally { + state.records = original; + } + } else { + let filtered = rows.filter( + (r) => + r.data.type !== "rack" && + (!effectiveRack || + r.data.type === "wire" || + (effectiveRack === "none" + ? !physicalRackOf(r) + : physicalRackOf(r) === effectiveRack)) && + (!physicalCpd || + r.data.type === "wire" || + rackAllowed(physicalRackOf(r))), + ); + if (effectiveRack || physicalCpd) { + const ids = new Set( + filtered.filter((r) => r.data.type !== "wire").map((r) => r.id), + ); + filtered = filtered.filter( + (r) => + r.data.type !== "wire" || + physicalOriginalEdges.some( + (e) => + e.wire.id === r.id && + (ids.has(e.a?.device) || ids.has(e.b?.device)), + ), + ); + } + // Los extremos externos se conservan como contexto, dentro de su rack real. + physicalBase.topology(filtered); + } + const toolbar = $(".wire-navigation"); + const controls = document.createElement("div"); + controls.className = "physical-levels"; + controls.innerHTML = ``; + toolbar.before(controls); + $("#physical-cpd").value = physicalCpd; + $("#physical-rack").value = effectiveRack; + controls + .querySelectorAll("[data-level]") + .forEach( + (b) => + (b.onclick = () => physicalSwitchLevel(b.dataset.level, physicalRack)), + ); + $("#physical-rack").onchange = (e) => + physicalSwitchLevel(physicalLevel, e.target.value); + $("#physical-cpd").onchange = (e) => { + physicalSwitchLevel(physicalLevel, "", e.target.value); + }; + $("#physical-bundles").onchange = (e) => { + physicalBundles = e.target.checked; + render(); + }; + $("#wire-board").ondblclick = (e) => { + const el = e.target.closest("[data-node]") || physicalNodeAt(e); + if (!el) return; + clearTimeout(clickTimer); + selected = el.dataset.node; + const r = state.records.find((r) => r.id === selected); + if (physicalLevel === "outside" && r?.data.type === "rack") + physicalSwitchLevel("inside", r.id); + else if (r) fullDetails(r); + }; + for (const n of wireGraph.nodes) { + const el = document.querySelector(`[data-node="${CSS.escape(n.id)}"]`); + el.style.width = physicalSize(n).w + "px"; + el.style.minHeight = physicalSize(n).h + "px"; + const ports = el.querySelector(".wire-ports"); + if (ports) + ports.style.gridTemplateColumns = `repeat(${Object.keys(n.data.ports || {}).length > 24 ? 12 : 8},minmax(0,1fr))`; + } + wirePaint(); +}; +wireBounds = function () { + if (!wireGraph) return { x: 0, y: 0, right: 240, bottom: 100 }; + const rectangles = wireGraph.nodes.map((n) => { + const p = wirePositions[n.id], + s = physicalSize(n); + return { x: p.x, y: p.y, right: p.x + s.w, bottom: p.y + s.h }; + }); + rectangles.push( + ...physicalLabelBounds.map((r) => ({ + x: r.x, + y: r.y, + right: r.x + r.w, + bottom: r.y + r.h, + })), + ); + rectangles.push( + ...physicalRegions.map((r) => ({ + x: r.x, + y: r.y, + right: r.x + r.w, + bottom: r.y + r.h, + })), + ); + return { + x: Math.min(0, ...rectangles.map((r) => r.x)), + y: Math.min(0, ...rectangles.map((r) => r.y)), + right: Math.max(240, ...rectangles.map((r) => r.right)), + bottom: Math.max(100, ...rectangles.map((r) => r.bottom)), + }; +}; +wireAnchor = function (endpoint, toward) { + const node = document.querySelector( + `[data-node="${CSS.escape(endpoint.device)}"]`, + ); + if (!node) return { x: 0, y: 0 }; + const port = node.querySelector( + `[data-port="${CSS.escape(endpoint.port || "")}"]`, + ), + rect = ( + port && wirePrefs.showPorts !== false ? port : node + ).getBoundingClientRect(), + world = $("#wire-world").getBoundingClientRect(); + if ((!port || wirePrefs.showPorts === false) && toward) { + const target = document.querySelector( + `[data-node="${CSS.escape(toward.device)}"]`, + ); + if (target) { + const tr = target.getBoundingClientRect(), + left = tr.left + tr.width / 2 < rect.left + rect.width / 2; + return { + x: ((left ? rect.left : rect.right) - world.left) / camera.z, + y: (rect.top + rect.height * 0.65 - world.top) / camera.z, + }; + } + } + return { + x: (rect.left + rect.width / 2 - world.left) / camera.z, + y: (rect.top + rect.height / 2 - world.top) / camera.z, + }; +}; +wirePaint = function () { + if (!wireGraph || !$("#wire-world")) return; + // Las posiciones manuales permanecen dentro del contenedor de su rack. + for (const n of wireGraph.nodes) { + const region = physicalRegions.find( + (r) => + r.id === + (physicalLevel === "outside" + ? n.data.location?.cpd || "" + : physicalRackOf(n)), + ); + if (region && wirePositions[n.id]) { + const p = wirePositions[n.id], + s = physicalSize(n); + p.x = Math.max( + region.x + 25, + Math.min(region.x + region.w - s.w - 25, p.x), + ); + p.y = Math.max( + region.y + 60, + Math.min(region.y + region.h - s.h - 25, p.y), + ); + } + } + physicalBase.paint(); + document.querySelectorAll(".physical-region").forEach((e) => e.remove()); + for (const region of physicalRegions) { + const el = document.createElement("div"); + el.className = "physical-region"; + Object.assign(el.style, { + left: region.x + "px", + top: region.y + "px", + width: region.w + "px", + height: region.h + "px", + }); + el.textContent = + region.label + + (physicalLevel === "inside" + ? " · " + physicalRoomName(physicalCpdOf(region.id)) + : ""); + $("#wire-world").prepend(el); + } + const labels = []; + $("#wire-lines").innerHTML = wireGraph.edges + .filter((e) => + wireGraph.nodes.some((n) => n.id === e.a?.device || n.id === e.b?.device), + ) + .map((e, i) => { + const visible = (id) => wireGraph.nodes.some((n) => n.id === id); + const first = visible(e.a?.device) ? e.a : e.b, + second = first === e.a ? e.b : e.a; + const a = wireAnchor(first, second), + b = + second && visible(second.device) + ? wireAnchor(second, first) + : { x: a.x + 240, y: a.y + 130 }; + const dx = b.x - a.x, + dy = b.y - a.y, + bend = Math.max(70, Math.abs(dx) * 0.28), + parallel = ((i % 3) - 1) * 28; + const path = `M${a.x} ${a.y} C${a.x + Math.sign(dx || 1) * bend} ${a.y + parallel},${b.x - Math.sign(dx || 1) * bend} ${b.y + parallel},${b.x} ${b.y}`; + const bundle = e.wire.bundle || [e.wire.id], + actual = state.records.find((r) => r.id === e.wire.id) || e.wire; + const media = [ + ...new Set( + bundle.map((id) => + wireName( + state.records.find((r) => r.id === id)?.data.kind || "wire", + ), + ), + ), + ]; + const medium = media.join(" / "); + const text = + bundle.length > 1 + ? `${bundle.length} cables · ${medium}` + : `${labelOf(actual)} · ${actual.id} · ${medium}`; + const full = `${text} · ${first.device} ${first.port} ↔ ${second ? second.device + " " + second.port : "Sin conectar"}`; + const caption = + camera.z < 0.65 + ? bundle.length > 1 + ? bundle.length + " cables" + : actual.id + : text; + const short = caption.length > 48 ? caption.slice(0, 45) + "…" : caption; + const labelScale = 1 / Math.max(0.5, Math.min(1, camera.z)); + const width = Math.max(80, short.length * 6.8 + 18) * labelScale, + height = 24 * labelScale; + const midX = (a.x + b.x) / 2, + midY = (a.y + b.y) / 2 + parallel * 0.75; + let x = midX - width / 2, + y = midY - height - 10; + const obstacles = wireGraph.nodes.map((n) => { + const p = wirePositions[n.id], + s = physicalSize(n); + return { x: p.x, y: p.y, w: s.w, h: s.h }; + }); + const collides = (x, y) => + [...labels, ...obstacles].some( + (r) => + x < r.x + r.w + 8 && + x + width > r.x - 8 && + y < r.y + r.h + 8 && + y + height > r.y - 8, + ); + for (let tries = 0; tries < 120 && collides(x, y); tries++) { + const ring = Math.floor(tries / 8) + 1, + angle = ((tries % 8) * Math.PI) / 4; + x = midX - width / 2 + Math.cos(angle) * ring * 55; + y = midY - height / 2 + Math.sin(angle) * ring * 40; + } + labels.push({ x, y, w: width, h: height }); + return `${esc(full)}${wirePrefs.labels ? `${Math.hypot(x + width / 2 - midX, y + height / 2 - midY) > 40 ? `` : ""}${esc(short)}` : ""}`; + }) + .join(""); + physicalLabelBounds = labels; + for (const label of document.querySelectorAll( + "#wire-lines .physical-cable-label", + )) { + const group = label.parentElement; + label.dataset.cable = group.dataset.cable; + label.prepend(group.querySelector("title").cloneNode(true)); + $("#wire-lines").append(label); + } + $("#wire-lines").onclick = (e) => { + const node = physicalNodeAt(e); + if (node) { + selected = node.dataset.node; + clearTimeout(clickTimer); + clickTimer = setTimeout(render, 260); + return; + } + + const el = e.target.closest("[data-cable]"); + if (!el) return; + const edge = wireGraph.edges.find((x) => x.wire.id === el.dataset.cable); + if (edge?.wire.bundle?.length > 1) { + const section = document.createElement("div"); + for (const id of edge.wire.bundle) { + const r = state.records.find((r) => r.id === id); + section.append( + wireAction(labelOf(r) + " · " + id, () => { + $("#detail").close(); + fullDetails(r); + }), + ); + } + showForm("Cables entre racks", [section]); + } else { + const r = state.records.find((r) => r.id === el.dataset.cable); + if (r) fullDetails(r); + } + }; +}; +let rackMode = "rooms", + rackCpd = "", + rackChoice = ""; +function rackMetric(r) { + const used = new Set( + r.occupants.flatMap((o) => + o.unit + ? Array.from({ length: o.span || 1 }, (_, i) => Number(o.unit) + i) + : [], + ), + ); + return `${used.size} / ${r.units} U ocupadas · ${r.occupants.length} equipos`; +} +function rackRoomForm(room) { + showForm( + room ? "Editar CPD" : "Nuevo CPD", + [ + field("Nombre", "name", room?.name), + field("Descripción", "description", room?.description, "textarea"), + field("Ubicación", "location", room?.location), + ], + async (values) => { + await call( + "rack_organization", + state.organizationRevision, + room ? "edit" : "create", + { ...values, id: room?.id }, + ); + }, + ); +} +function rackAssign(r) { + showForm( + "CPD de " + r.name, + [ + field("Sala CPD", "id", r.location?.cpd || "", "text", [ + ["", "Sin CPD"], + ...(state.cpds || []).map((c) => [c.id, c.name]), + ]), + ], + (v) => + call("rack_organization", state.organizationRevision, "assign", { + rack: r.id, + id: v.id, + }), + ); +} +function rackDeleteRoom(room) { + showForm( + "Eliminar CPD · " + room.name, + [ + Object.assign(document.createElement("p"), { + textContent: + "Los armarios, sus equipos y cables se conservarán. Elige dónde dejar los armarios de esta sala.", + }), + field("Trasladar armarios a", "target", "", "text", [ + ["", "Sin CPD"], + ...state.cpds + .filter((c) => c.id !== room.id) + .map((c) => [c.id, c.name]), + ]), + ], + async (v) => { + await call("rack_organization", state.organizationRevision, "delete", { + id: room.id, + target: v.target, + }); + rackCpd = ""; + }, + ); +} +function rackShowDetails(r) { + const general = [ + Object.assign(document.createElement("p"), { + textContent: r.name + " · " + r.id, + }), + Object.assign(document.createElement("p"), { + textContent: r.description || "Sin descripción", + }), + Object.assign(document.createElement("p"), { textContent: rackMetric(r) }), + wireAction("Cambiar CPD", () => { + $("#detail").close(); + rackAssign(r); + }), + ]; + const items = document.createElement("div"); + for (const o of r.occupants) + items.append( + wireAction(`${o.name || o.id} · U${o.unit || "—"}`, () => { + $("#detail").close(); + rackOccupantDetails(o); + }), + ); + const json = document.createElement("textarea"); + json.readOnly = true; + json.rows = 16; + json.value = JSON.stringify(r, null, 2); + showForm("Rack · " + r.name, [ + wireTabs([ + ["Resumen", general], + ["Equipos", [items]], + [ + "JSON", + [ + json, + wireAction("Copiar JSON", async () => { + try { + await navigator.clipboard.writeText(json.value); + } catch { + json.select(); + document.execCommand("copy"); + } + }), + ], + ], + ]), + ]); +} +render = function () { + if (state.launcher !== "lanrack") { + physicalBase.render(); + return; + } + document.body.classList.add("wire-app", "rack-app"); + const query = $("#search").value.toLocaleLowerCase().trim(), + filter = $("#filter").value; + if (filter !== rackCpd) rackCpd = filter; + $("#title").textContent = "Salas CPD y armarios rack"; + $("#subtitle").textContent = + "Organización física compartida con LANWIRE · equipos y conexiones conservados"; + $("#filter").innerHTML = + '' + + (state.cpds || []) + .map((c) => ``) + .join(""); + $("#filter").value = rackCpd; + const roomName = (id) => physicalRoomName(id); + const rows = state.records.filter( + (r) => + (!rackCpd || + (rackCpd === "none" + ? !r.location?.cpd + : r.location?.cpd === rackCpd)) && + (!query || + [r.name, r.id, r.description, roomName(r.location?.cpd)] + .join(" ") + .toLocaleLowerCase() + .includes(query)), + ); + selected = rows.some((r) => r.id === selected) + ? selected + : rows[0]?.id || null; + const chosen = rows.find((r) => r.id === selected); + $("#count").textContent = + rows.length + " de " + state.records.length + " racks"; + $("#selection").textContent = chosen?.name || "Sin selección"; + $("#views").innerHTML = [ + ["rooms", "Vista de salas"], + ["list", "Lista"], + ["rack", "Detalle del rack"], + ] + .map( + ([key, name]) => + ``, + ) + .join(""); + $("#tools").innerHTML = + button("Actualizar", "refresh") + + '' + + button("Abrir LANWIRE", "wire"); + $("#rack-new-room").onclick = () => rackRoomForm(); + $("#commands").innerHTML = chosen + ? '' + : ""; + if (chosen) { + $("#rack-data").onclick = () => rackShowDetails(chosen); + $("#rack-assign").onclick = () => rackAssign(chosen); + } + if (rackMode === "list") { + $("#canvas").innerHTML = table( + ["ARMARIO", "ID", "CPD", "CAPACIDAD / OCUPACIÓN"], + rows, + (r) => [r.name, r.id, roomName(r.location?.cpd), rackMetric(r)], + ); + } else if (rackMode === "rack" && chosen) { + const occupancy = new Map( + chosen.occupants.flatMap((o) => + o.unit + ? Array.from({ length: o.span || 1 }, (_, i) => [ + Number(o.unit) + i, + o, + ]) + : [], + ), + ); + $("#canvas").innerHTML = + `

${esc(chosen.name)}

${esc(roomName(chosen.location?.cpd))}

${esc(rackMetric(chosen))}

${esc(chosen.description)}

${Array.from( + { length: chosen.units }, + (_, i) => chosen.units - i, + ) + .map((u) => { + const o = occupancy.get(u); + return ``; + }) + .join("")}
`; + $("#rack-back").onclick = () => { + rackMode = "rooms"; + $("#filter").value = chosen.location?.cpd || "none"; + render(); + }; + document + .querySelectorAll("[data-rack-occupant]") + .forEach( + (b) => + (b.onclick = () => + rackOccupantDetails( + chosen.occupants.find((o) => o.id === b.dataset.rackOccupant), + )), + ); + } else { + const rooms = (state.cpds || []) + .filter((c) => !rackCpd || c.id === rackCpd) + .filter( + (c) => + !query || + c.name.toLocaleLowerCase().includes(query) || + rows.some((r) => r.location?.cpd === c.id), + ); + const cards = [ + ...rooms, + { + id: "", + name: "Sin CPD", + description: "Armarios pendientes de asignación", + }, + ].filter( + (c) => !rackCpd || (rackCpd === "none" ? !c.id : c.id === rackCpd), + ); + $("#canvas").innerHTML = + '
' + + cards + .map((c) => { + const racks = rows.filter((r) => (r.location?.cpd || "") === c.id); + if (!c.id && !racks.length) return ""; + return `

${esc(c.name)}

${c.id ? `` : ""}

${esc(c.description || "")}

${esc(c.location || "")} · ${racks.length} armarios · ${racks.reduce((s, r) => s + r.units, 0)} U totales

${racks.map((r) => ``).join("") || '

CPD vacío. Usa «Cambiar CPD» en un rack para asignarlo.

'}
`; + }) + .join("") + + "
"; + document.querySelectorAll("[data-rack-open]").forEach( + (b) => + (b.onclick = () => { + selected = b.dataset.rackOpen; + rackMode = "rack"; + render(); + }), + ); + document + .querySelectorAll("[data-cpd-edit]") + .forEach( + (b) => + (b.onclick = () => + rackRoomForm(state.cpds.find((c) => c.id === b.dataset.cpdEdit))), + ); + document + .querySelectorAll("[data-cpd-delete]") + .forEach( + (b) => + (b.onclick = () => + rackDeleteRoom( + state.cpds.find((c) => c.id === b.dataset.cpdDelete), + )), + ); + } + document.querySelectorAll("[data-rack-mode]").forEach( + (b) => + (b.onclick = () => { + rackMode = b.dataset.rackMode; + render(); + }), + ); +}; +fullDetails = function (r) { + if (state.launcher === "lanrack" && r?.occupants) return rackShowDetails(r); + return physicalBase.fullDetails(r); +}; +refresh = async function () { + const previous = $("#filter").value; + await physicalBase.refresh(); + if (state.launcher === "lanrack") { + $("#filter").value = previous; + rackCpd = previous; + render(); + } +}; + +wireCenterFromDetails = async function (r) { + wireSavePositions(); + physicalLevel = r.data.type === "rack" ? "outside" : "inside"; + physicalRack = + r.data.type === "rack" + ? r.id + : r.data.type === "wire" + ? "" + : physicalRackOf(r); + physicalCpd = ""; + wirePositions = {}; + return physicalBase.center(r); +}; + +const physicalClearFilters = wireClearFilters; +wireClearFilters = function () { + physicalRack = ""; + physicalCpd = ""; + wirePositions = {}; + physicalClearFilters(); +}; +function rackOccupantDetails(r) { + const data = r.data || {}; + const summary = document.createElement("dl"); + for (const [name, value] of [ + ["Nombre", r.name || r.id], + ["Identificador", r.id], + ["Tipo", wireName(r.type)], + ["Unidad", r.unit || "Sin asignar"], + ["Descripción", r.description || "—"], + ]) { + const dt = document.createElement("dt"), + dd = document.createElement("dd"); + dt.textContent = name; + dd.textContent = String(value); + summary.append(dt, dd); + } + const ports = document.createElement("div"); + for (const [id, p] of Object.entries(data.ports || {})) { + const line = document.createElement("p"); + line.textContent = + id + " · " + wireName(p.kind) + " · " + (p.connector || ""); + ports.append(line); + } + if (!ports.childNodes.length) ports.textContent = "Sin puertos registrados"; + const json = document.createElement("textarea"); + json.readOnly = true; + json.rows = 16; + json.value = JSON.stringify(r, null, 2); + showForm("Equipo · " + (r.name || r.id), [ + wireTabs([ + ["Resumen", [summary]], + ["Puertos", [ports]], + ["JSON", [json]], + ]), + ]); +} + +function physicalNodeAt(event) { + return ( + [...document.querySelectorAll("[data-node]")].find((node) => { + const r = node.getBoundingClientRect(); + return ( + event.clientX >= r.left && + event.clientX <= r.right && + event.clientY >= r.top && + event.clientY <= r.bottom + ); + }) || null + ); +} diff --git a/gui/rack-dimensions.js b/gui/rack-dimensions.js new file mode 100644 index 0000000..4851420 --- /dev/null +++ b/gui/rack-dimensions.js @@ -0,0 +1,107 @@ +"use strict"; + +// Dimensions are edited in LANRACK and validated against the shared physical inventory. +(() => { + const base = { render, details: rackShowDetails, metric: rackMetric }; + const validHeight = (r) => + Number.isInteger(r.units) && r.units >= 4 && r.units <= 52; + rackMetric = (r) => + `${base.metric(r)} · ${r.widthInches ? r.widthInches + "″ de montaje" : "Ancho pendiente"}${r.dimensions?.needsReview ? " · Revisar dimensiones" : ""}`; + function dimensionFields(r) { + const height = field("Altura (4–52 U)", "units", r?.units ?? 42, "number"); + const input = height.querySelector("input"); + input.min = 4; + input.max = 52; + input.step = 1; + input.required = true; + const width = field( + "Ancho de montaje (pulgadas)", + "widthInches", + r?.widthInches ?? (r ? "" : 19), + "text", + [ + ["", "Seleccionar ancho"], + [10, "10″"], + [19, "19″"], + [21, "21″"], + [23, "23″"], + ], + ); + width.querySelector("select").required = true; + return [height, width]; + } + function edit(r) { + const note = document.createElement("p"); + note.textContent = + (r.dimensions?.warnings || []).join(". ") || + "Los equipos y sus conexiones se conservarán. La altura no puede dejar equipos fuera del rack."; + showForm( + "Dimensiones · " + r.name, + [note, ...dimensionFields(r)], + (values) => + call("rack_dimensions", state.organizationRevision, r.id, { + units: Number(values.units), + widthInches: Number(values.widthInches), + }), + ); + } + function create() { + showForm( + "Nuevo armario rack", + [ + field("Nombre", "name"), + field("Descripción", "description", "", "textarea"), + field("Prefijo del identificador", "prefix", "RK"), + ...dimensionFields(), + ], + async (values) => { + const result = await call("rack_create", { + ...values, + units: Number(values.units), + widthInches: Number(values.widthInches), + }); + selected = result.id; + }, + ); + } + rackShowDetails = function (r) { + base.details(r); + const summary = document.querySelector("#detail-fields .wire-tab-panel"); + if (summary) + summary.append( + wireAction("Editar dimensiones", () => { + $("#detail").close(); + edit(r); + }), + ); + }; + render = function () { + if (state.launcher !== "lanrack") return base.render(); + const rack = state.records.find((r) => r.id === selected), + invalid = rack && !validHeight(rack), + previous = rackMode; + if (invalid && rackMode === "rack") rackMode = "list"; + base.render(); + rackMode = previous; + if (invalid && previous === "rack") { + const section = document.createElement("section"); + section.className = "panel"; + const title = document.createElement("h2"); + title.textContent = "Dimensiones pendientes de revisión"; + const note = document.createElement("p"); + note.textContent = (rack.dimensions?.warnings || []).join(". "); + section.append( + title, + note, + wireAction("Corregir dimensiones", () => edit(rack)), + ); + $("#canvas").replaceChildren(section); + } + $("#tools").append(wireAction("Nuevo rack", create)); + const chosen = state.records.find((r) => r.id === selected); + if (chosen) + $("#commands").append( + wireAction("Editar dimensiones", () => edit(chosen)), + ); + }; +})(); diff --git a/gui/rack-skins.js b/gui/rack-skins.js new file mode 100644 index 0000000..cbe3301 --- /dev/null +++ b/gui/rack-skins.js @@ -0,0 +1,314 @@ +/* Frentes vectoriales genéricos de equipos en la elevación del rack. */ +const rackSkinBase = { render, details: rackOccupantDetails }; +let rackSkinUnitHeight = 52, + rackSkinsVisible = true; +try { + const saved = JSON.parse( + localStorage.getItem("lanrack.skins.preferences") || "{}", + ); + if (saved.schemaVersion === 1) { + if ( + Number.isInteger(saved.unitHeight) && + saved.unitHeight >= 36 && + saved.unitHeight <= 84 + ) + rackSkinUnitHeight = saved.unitHeight; + if (typeof saved.visible === "boolean") rackSkinsVisible = saved.visible; + } +} catch {} +function rackSkinStore() { + localStorage.setItem( + "lanrack.skins.preferences", + JSON.stringify({ + schemaVersion: 1, + visible: rackSkinsVisible, + unitHeight: rackSkinUnitHeight, + }), + ); +} +const rackSkinKinds = [ + ["auto", "Automático según inventario"], + ["switch", "Switch"], + ["panel", "Panel de conexiones"], + ["server", "Servidor"], + ["ups", "SAI / UPS"], + ["router", "Router / cortafuegos"], + ["shelf", "Bandeja"], + ["blank", "Panel ciego"], +]; +function rackAutoSkin(r) { + const data = r.data || {}, + type = data.type || r.type || ""; + const entries = Object.entries(data.ports || {}), + fiber = entries.filter(([, p]) => + /fiber|sfp/i.test([p.kind, p.connector, p.type].join(" ")), + ); + const kind = /switch/.test(type) + ? "switch" + : /panel/.test(type) + ? "panel" + : /server/.test(type) + ? "server" + : /ups|sai/.test(type) + ? "ups" + : /router|gateway|firewall/.test(type) + ? "router" + : "shelf"; + return { + kind, + rj45: entries.length - fiber.length, + sfp: fiber.length, + units: r.span || 1, + rackmount: !/switch/.test(type) || entries.length >= 12, + }; +} +function rackSkinOf(r) { + const saved = r.data?.rackAppearance; + return !saved || saved.kind === "auto" + ? { ...rackAutoSkin(r), units: saved?.units || r.span || 1 } + : saved; +} +function rackFace(r, override) { + const p = + override?.kind === "auto" + ? { ...rackAutoSkin(r), units: override.units } + : override || rackSkinOf(r), + units = p.units || 1, + h = 88 * units; + const ports = Object.entries(r.data?.ports || {}), + fiber = ports.filter(([, v]) => + /fiber|sfp/i.test([v.kind, v.connector, v.type].join(" ")), + ), + copper = ports.filter((e) => !fiber.includes(e)); + const used = new Set(r.connectedPorts || []), + name = r.name || r.id; + const title = `${name} · ${r.id} · ${units} U · Frente genérico ${p.kind} · ${p.rj45} RJ45 + ${p.sfp} SFP`; + const label = name.length > 33 ? name.slice(0, 30) + "…" : name; + let body = ``; + if (p.rackmount) + for (const x of [5, 1184]) + body += ``; + else + body += ``; + const textX = p.rackmount ? 38 : 220; + body += `${esc(label)}${esc(r.id)} · ${esc(rackSkinKinds.find((k) => k[0] === p.kind)?.[1] || p.kind)}`; + if (["switch", "panel", "router"].includes(p.kind)) { + const columns = Math.max(1, Math.ceil(p.rj45 / 2)), + area = p.rj45 > 24 ? 650 : 390, + cell = Math.min(31, area / columns), + size = Math.max(9, cell - 5), + right = p.rackmount ? 1040 : 925, + start = right - columns * cell; + for (let i = 0; i < p.rj45; i++) { + const col = Math.floor(i / 2), + row = i % 2, + x = start + col * cell, + y = 15 + row * 33; + const port = copper[i], + active = port && used.has(port[0]); + body += `${esc(port ? port[0] + (active ? " · Conectado" : " · Sin conexión registrada") : "RJ45 " + (i + 1) + " · Representación sin puerto asociado")}${i + 1}`; + } + const sfpStart = p.rackmount ? 1065 : 945, + cols = Math.max(1, Math.ceil(p.sfp / 2)), + sfpCell = Math.min(38, (p.rackmount ? 100 : 48) / cols); + for (let i = 0; i < p.sfp; i++) { + const x = sfpStart + Math.floor(i / 2) * sfpCell, + y = 15 + (i % 2) * 33, + port = fiber[i]; + body += `${esc(port ? port[0] : "SFP " + (i + 1) + " · Representación sin puerto asociado")}S${i + 1}`; + } + body += `${p.rj45} RJ45${p.sfp ? " + " + p.sfp + " SFP" : ""}`; + } else if (p.kind === "server") { + const rows = Math.min(4, units), + cols = 6, + bayH = Math.max(18, (h - 22) / rows); + for (let i = 0; i < rows * cols; i++) { + const x = 440 + (i % cols) * 115, + y = 12 + Math.floor(i / cols) * bayH; + body += ``; + } + } else if (p.kind === "ups") { + body += `SAI / UPSSin telemetría`; + for (let i = 0; i < 16; i++) + body += ``; + } else if (p.kind === "shelf") { + for (let i = 0; i < 24; i++) + body += ``; + } else body += ``; + return `${esc(title)}${body}`; +} +function rackSkinElevation(rack) { + const occupied = new Map(), + conflicts = new Set(); + for (const r of rack.occupants) { + if (!r.unit) continue; + for ( + let u = Number(r.unit); + u < Number(r.unit) + (r.span || 1) && u <= rack.units; + u++ + ) { + if (occupied.has(u)) conflicts.add(u); + else occupied.set(u, r); + } + } + const rendered = new Set(); + let html = ""; + for (let u = rack.units; u >= 1; u--) { + const r = occupied.get(u); + if (r && rendered.has(r.id)) continue; + if (r) { + rendered.add(r.id); + const span = r.span || 1; + html += ``; + } else + html += ``; + } + if (conflicts.size) + html = + '

Hay posiciones solapadas en el inventario: ' + + [...conflicts].sort((a, b) => b - a).join(", ") + + " U. Revisa sus ubicaciones en LANWIRE.

" + + html; + return html; +} +function rackSkinEditor(r) { + const current = r.data?.rackAppearance || { + schemaVersion: 1, + ...rackAutoSkin(r), + kind: "auto", + }, + values = { ...current }; + const preview = document.createElement("div"); + preview.className = "rack-skin-preview"; + const note = document.createElement("p"); + note.className = "muted"; + note.textContent = + "Frentes genéricos. La apariencia no crea puertos ni cambia conexiones. La altura ocupa unidades desde la posición inicial hacia arriba; se validará el espacio disponible."; + const profiles = state.skinProfiles || []; + const fields = [ + field("Plantilla", "preset", "custom", "text", [ + ["custom", "Personalizado"], + ...profiles.map((p) => [p.id, p.name]), + ]), + field("Tipo de frente", "kind", values.kind, "text", rackSkinKinds), + field("Puertos RJ45 (representación)", "rj45", values.rj45, "number"), + field("Puertos SFP / SFP+ (representación)", "sfp", values.sfp, "number"), + field("Altura ocupada (U)", "units", values.units, "number"), + field("Formato", "rackmount", String(values.rackmount), "text", [ + ["true", "Montaje en rack"], + ["false", "Sobremesa sobre bandeja"], + ]), + ]; + const controls = document.createElement("div"); + controls.className = "rack-skin-controls"; + controls.append(...fields); + showForm( + "Frente visual · " + (r.name || r.id), + [preview, note, controls], + () => call("rack_appearance", state.organizationRevision, r.id, read()), + ); + function read() { + return { + kind: controls.querySelector("[name=kind]").value, + rj45: Number(controls.querySelector("[name=rj45]").value), + sfp: Number(controls.querySelector("[name=sfp]").value), + units: Number(controls.querySelector("[name=units]").value), + rackmount: controls.querySelector("[name=rackmount]").value === "true", + }; + } + function paint() { + const v = read(); + if (v.kind === "auto") { + const auto = rackAutoSkin(r); + for (const key of ["rj45", "sfp", "rackmount"]) + controls.querySelector(`[name=${key}]`).value = String(auto[key]); + } + controls.querySelector("[name=rackmount]").disabled = v.kind === "auto"; + preview.innerHTML = rackFace(r, { + ...v, + rj45: Math.max(0, Math.min(96, v.rj45 || 0)), + sfp: Math.max(0, Math.min(32, v.sfp || 0)), + units: Math.max(1, Math.min(8, v.units || 1)), + }); + for (const k of ["rj45", "sfp"]) + controls.querySelector(`[name=${k}]`).disabled = v.kind === "auto"; + } + controls.querySelector("[name=preset]").onchange = (e) => { + const p = profiles.find((p) => p.id === e.target.value); + if (!p) return; + for (const k of ["kind", "rj45", "sfp", "units", "rackmount"]) + controls.querySelector(`[name=${k}]`).value = String(p[k]); + paint(); + }; + for (const key of ["rj45", "sfp", "units"]) { + const input = controls.querySelector(`[name=${key}]`); + input.min = key === "units" ? 1 : 0; + input.max = key === "rj45" ? 96 : key === "sfp" ? 32 : 8; + input.step = 1; + } + controls.addEventListener("input", paint); + controls.addEventListener("change", paint); + paint(); +} +rackOccupantDetails = function (r) { + rackSkinBase.details(r); + const panel = document.querySelector("#detail-fields .wire-tab-panel"); + if (!panel) return; + const front = document.createElement("div"); + front.className = "rack-skin-preview"; + front.innerHTML = rackFace(r); + panel.prepend( + front, + wireAction("Personalizar frente", () => { + $("#detail").close(); + rackSkinEditor(r); + }), + ); +}; +render = function () { + rackSkinBase.render(); + if (state.launcher !== "lanrack" || rackMode !== "rack") return; + const chosen = state.records.find((r) => r.id === selected), + elevation = document.querySelector(".rack-elevation"); + if (!chosen || !elevation) return; + const toggle = document.createElement("button"); + toggle.id = "rack-skins-toggle"; + toggle.textContent = rackSkinsVisible + ? "Ver unidades simples" + : "Ver frentes de equipos"; + toggle.onclick = () => { + rackSkinsVisible = !rackSkinsVisible; + rackSkinStore(); + render(); + }; + $("#rack-back").after(toggle); + const size = document.createElement("label"); + size.className = "rack-skin-size"; + size.textContent = "Tamaño de las unidades"; + const slider = document.createElement("input"); + slider.type = "range"; + slider.min = 36; + slider.max = 84; + slider.step = 1; + slider.value = rackSkinUnitHeight; + slider.setAttribute("aria-label", "Tamaño de las unidades"); + slider.onchange = () => { + rackSkinUnitHeight = Number(slider.value); + rackSkinStore(); + render(); + }; + size.append(slider); + toggle.after(size); + if (!rackSkinsVisible) return; + elevation.classList.add("rack-skinned"); + elevation.innerHTML = rackSkinElevation(chosen); + elevation + .querySelectorAll("[data-rack-occupant]") + .forEach( + (b) => + (b.onclick = () => + rackOccupantDetails( + chosen.occupants.find((r) => r.id === b.dataset.rackOccupant), + )), + ); +}; diff --git a/gui/remote-setup.css b/gui/remote-setup.css new file mode 100644 index 0000000..6af7fe9 --- /dev/null +++ b/gui/remote-setup.css @@ -0,0 +1,3 @@ +:root{color-scheme:dark;--bg:#15181c;--surface:#20272c;--line:#343e46;--text:#e9eff4;--muted:#a7b5bf;--accent:#b2ef26;font:15px/1.5 "Segoe UI",sans-serif;color:var(--text);background:var(--bg)} +*{box-sizing:border-box}body{margin:0;min-height:100vh;display:flex;flex-direction:column}header{display:flex;align-items:center;gap:15px;padding:22px 28px;background:#101417;border-bottom:1px solid var(--line)}header img{width:38px;height:38px}header strong{font-size:25px;letter-spacing:1px}header span{color:var(--accent)}header small{display:block;color:var(--muted);font-size:10px;letter-spacing:2px}main{padding:24px 28px;flex:1}h1{font-size:24px;margin:0 0 12px}p{margin:0 0 16px;color:var(--muted)}.notice{padding:12px 14px;background:var(--surface);border:1px solid var(--line);border-radius:9px}form{display:grid;gap:16px}label{display:grid;gap:6px}label small{color:var(--muted)}input{width:100%;padding:11px 13px;color:var(--text);background:#101417;border:1px solid var(--line);border-radius:8px;font:inherit}input:focus-visible,button:focus-visible{outline:2px solid var(--accent);outline-offset:2px}input:disabled,button:disabled{opacity:.5;cursor:default}.actions{display:flex;justify-content:flex-end;gap:10px}button{padding:11px 17px;border:1px solid var(--line);border-radius:8px;background:var(--surface);color:var(--text);font:inherit;cursor:pointer}.primary{background:var(--accent);border-color:var(--accent);color:#142000}#status{min-height:23px;margin:0}#status.error{color:#ff7a79}#status.success{color:var(--accent)}#account-role:empty{display:none}footer{padding:12px 28px;border-top:1px solid var(--line);color:var(--muted);font-size:12px}@media(max-width:500px){header,main{padding:18px}.actions{flex-wrap:wrap}} +body{height:100vh;min-height:0;overflow:hidden}header,footer{flex-shrink:0}main{min-height:0;overflow:auto}form{grid-template-columns:1fr 1fr}form>label:first-child,#account-role,#status{grid-column:1/-1}footer{display:flex;align-items:center;justify-content:space-between;gap:12px}footer small{font-size:12px}@media(max-width:640px){form{grid-template-columns:1fr}footer{flex-wrap:wrap}} diff --git a/gui/remote-setup.html b/gui/remote-setup.html new file mode 100644 index 0000000..4a33bac --- /dev/null +++ b/gui/remote-setup.html @@ -0,0 +1,27 @@ + + + + + + LANACCESS · Cuenta de acceso remoto + + + + + +
LANACCESSCONFIGURACIÓN DE ACCESO REMOTO
+
+

Crear cuenta de acceso remoto

+

Esta cuenta administrativa permite identificarse en los accesos remotos del servicio de LANCTL. Es independiente de tu cuenta de Windows y de las credenciales de los dispositivos del inventario.

+

Comprobando la configuración…

+
+ + + +

+

+
+
+
LANCTL · Configuración local
+ + diff --git a/gui/remote-setup.js b/gui/remote-setup.js new file mode 100644 index 0000000..7bc1cd3 --- /dev/null +++ b/gui/remote-setup.js @@ -0,0 +1,65 @@ +"use strict"; +(() => { + const form = document.querySelector("#account-form"), + status = document.querySelector("#status"), + cancel = document.querySelector("#cancel"), + submit = document.querySelector('[type="submit"]'); + let busy = false, complete = false; + async function call(method, ...args) { + const result = await window.pywebview.api[method](...args); + if (!result.ok) throw new Error(result.error || "No se pudo completar la operación."); + return result; + } + function message(text, kind = "") { + status.textContent = text; + status.className = kind; + } + async function close() { + if (busy) return; + form.elements.password.value = ""; + form.elements.confirmation.value = ""; + try { await call("request_close"); } + catch (error) { message(error.message, "error"); } + } + window.remoteSetupClose = close; + cancel.onclick = close; + document.addEventListener("keydown", event => { + if (event.key === "Escape") close(); + }); + form.onsubmit = async event => { + event.preventDefault(); + if (busy || complete) return; + if (form.elements.password.value !== form.elements.confirmation.value) { + message("Las contraseñas no coinciden.", "error"); + return; + } + busy = true; submit.disabled = true; cancel.disabled = true; + message("Creando la cuenta…"); + try { + const result = await call("create_initial_user", form.elements.username.value.trim(), + form.elements.password.value, form.elements.confirmation.value); + complete = true; + message(result.message || "Cuenta de acceso remoto creada.", "success"); + for (const input of form.querySelectorAll("input")) input.disabled = true; + submit.hidden = true; cancel.textContent = "Finalizar"; + } catch (error) { message(error.message, "error"); } + finally { + form.elements.password.value = ""; + form.elements.confirmation.value = ""; + busy = false; submit.disabled = false; cancel.disabled = false; + } + }; + window.addEventListener("pywebviewready", async () => { + try { + const result = await call("setup_status"); + document.querySelector("#scope").textContent = result.hasUsers + ? "El servicio ya tiene cuentas. Se conservan todas; utiliza LANACCESS para gestionarlas." + : "Se creará la primera cuenta administrativa del servicio LANACCESS, disponible para el acceso remoto cuando lo configures."; + document.querySelector("#account-role").textContent = "Crear esta cuenta no activa HTTPS, SSH ni reglas de firewall. Estos servicios requieren configuración posterior."; + if (!result.canCreate) return; + for (const input of form.querySelectorAll("input")) input.disabled = false; + submit.disabled = false; + form.elements.username.focus(); + } catch (error) { message(error.message, "error"); } + }); +})(); diff --git a/gui/suite.css b/gui/suite.css new file mode 100644 index 0000000..d12a189 --- /dev/null +++ b/gui/suite.css @@ -0,0 +1,29 @@ +:root{color-scheme:dark;--bg:#15181c;--surface:#20272c;--line:#343e46;--text:#eef1f4;--muted:#a6b4c3;--lime:#b2ef26;font:13px/1.5 "Segoe UI",sans-serif;color:var(--text);background:var(--bg)} +/* The viewport owns the shell; only the central workspace scrolls. */ +html,body{height:100%;overflow:hidden} +.shell{height:100vh;height:100dvh;display:flex;flex-direction:column;min-height:0;overflow:hidden} +.shell>header,.shell>.controls,.shell>footer,.shell>#status{flex:none} +.shell>main{flex:1 1 0;min-height:0;overflow:auto;overscroll-behavior:contain;scrollbar-width:thin;scrollbar-color:#536047 var(--bg)} +.shell>#status{max-height:20dvh;overflow:auto} +dialog{max-height:calc(100dvh - 32px);overflow:auto} +.shell>main.list-page{display:flex;flex-direction:column;overflow:hidden;gap:12px} +.list-page>.toolbar,.collection-search{flex:none} +.list-page>.toolbar{margin-bottom:0} +.collection-search{display:flex;align-items:end;justify-content:space-between;gap:12px;padding-bottom:3px} +.collection-search label{display:grid;gap:6px;color:var(--muted);font-size:12px;flex:1;max-width:420px} +.collection-search input{width:100%} +.collection-search>span{font-size:11px;white-space:nowrap;padding-bottom:8px} +.collection-list{flex:1;min-height:0;overflow:auto;align-content:start;overscroll-behavior:contain;padding-right:6px;scrollbar-width:thin;scrollbar-color:#536047 var(--bg)} +.collection-list>[hidden]{display:none!important} +.collection-list>.panel{flex:none} +.plugin-facts{display:flex;gap:8px 20px;flex-wrap:wrap;margin:12px 0 0;font-size:11px;color:var(--muted)} +.plugin-facts b{color:var(--text);font-weight:500;margin-left:4px} +.plugin-technical{font-size:11px;margin-top:12px;color:var(--muted)} +.plugin-technical summary{cursor:pointer;color:var(--lime)} +.plugin-technical dl{margin-top:12px;grid-template-columns:minmax(90px,140px) minmax(0,1fr)} +*{box-sizing:border-box}body{margin:0}button,input,select{font:inherit;color:inherit}button{cursor:pointer;background:var(--surface);border:1px solid var(--line);border-radius:7px;padding:7px 10px}button:hover{border-color:#90ae53}button:disabled{cursor:default;opacity:.55}input,select{max-width:100%;min-width:0;background:#171d21;border:1px solid #45515b;border-radius:7px;padding:7px 9px}input[type=checkbox]{accent-color:var(--lime)}button:focus-visible,input:focus-visible,select:focus-visible{outline:2px solid var(--lime);outline-offset:3px}header{display:flex;justify-content:space-between;align-items:center;padding:19px 22px;background:#101417}.brand{font-weight:700;font-size:22px;letter-spacing:2px}.brand span{color:var(--lime)}.brand small{display:block;color:var(--muted);font-size:10px;font-weight:400;letter-spacing:2px;margin-top:3px}.badge{border:1px solid #3c4a2c;color:var(--lime);border-radius:18px;padding:3px 10px;font-size:11px}.controls{display:flex;align-items:center;gap:13px;flex-wrap:wrap;padding:10px 18px;background:#101417;border-bottom:1px solid var(--line)}.controls label{display:flex;align-items:center;gap:8px;color:var(--muted);font-size:12px}.controls select{max-width:130px}nav{display:flex;gap:3px;flex-wrap:wrap}nav button{border:0;background:transparent;color:var(--muted);padding:7px 8px;font-size:12px}nav button.active{color:var(--lime);background:#2c3820}main{padding:20px}.launch-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px}.launch{display:flex;align-items:center;gap:14px;min-height:85px;padding:16px 18px;text-align:left;border-radius:12px;background:linear-gradient(120deg,#252d32,#1d2328);box-shadow:inset 0 1px #ffffff06}.launch:last-child{grid-column:1/-1;background:linear-gradient(120deg,#263022,#1b2422);min-height:75px}.launch::after{content:"↗";margin-left:auto;color:#85956d;align-self:start}.launch strong{display:block;font-size:19px;letter-spacing:1px;font-weight:600}.launch small{display:block;color:var(--muted);font-size:12px;margin-top:4px}.launch svg{width:25px;height:25px;color:var(--lime);flex:none;fill:none;stroke:currentColor;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round}.caption{display:flex;justify-content:space-between;gap:10px;flex-wrap:wrap;color:var(--muted);font-size:11px;margin-bottom:14px}.ready{color:var(--lime)}footer{display:flex;justify-content:space-between;align-items:center;flex-wrap:wrap;gap:8px;background:#101417;border-top:1px solid var(--line);padding:10px 16px;color:var(--muted);font-size:11px}footer div{display:flex;align-items:center;gap:12px;flex-wrap:wrap}footer button{padding:0;background:transparent;border:0;font-size:11px;color:var(--muted)}footer button:hover{color:var(--lime)}h1{font-size:23px;margin:0 0 6px}h2{font-size:17px;margin:0}p{margin:0 0 12px}.muted{color:var(--muted)}.toolbar,.actions,.row{display:flex;gap:10px;align-items:center;flex-wrap:wrap}.toolbar{margin:0 0 16px;justify-content:space-between}.stack{display:grid;gap:12px}.panel{padding:16px;border:1px solid var(--line);border-radius:10px;background:var(--surface)}.panel .row{justify-content:space-between}.panel p{color:var(--muted);font-size:12px;margin-top:7px;overflow-wrap:anywhere}.primary{color:#182006;background:var(--lime);border-color:var(--lime)}#status{margin:0;padding:0 20px 12px;color:var(--lime);font-size:12px;overflow-wrap:anywhere}#status:empty{display:none}#status.error,#form-error{color:#ffb5ab}dialog{width:min(560px,95%);background:#20272c;color:var(--text);border:1px solid #53613f;border-radius:12px;padding:22px}dialog::backdrop{background:#0008}.dialog-head{display:flex;justify-content:space-between;gap:12px;align-items:center;margin-bottom:18px}.actions{justify-content:end;margin-top:18px}#fields{display:grid;gap:14px}#fields label{display:grid;gap:7px;color:var(--muted)}#fields label.check{display:flex;gap:9px;align-items:center}#fields small{color:var(--muted)}#form-error{margin-top:12px}.terminal{border:1px solid var(--line);border-radius:10px;background:#101518}.terminal header{padding:10px 14px;border-radius:10px 10px 0 0;background:#20282e}#terminal-output{font:12px/1.8 Consolas,monospace;color:#c9d7c4;white-space:pre-wrap;overflow-wrap:anywhere;padding:14px;margin:0;min-height:160px;max-height:320px;overflow:auto}.terminal form{display:flex;gap:10px;padding:12px;border-top:1px solid var(--line);align-items:center}.terminal label{color:var(--lime);white-space:nowrap}.terminal input{flex:1;min-width:0;font-family:Consolas,monospace;background:transparent;border:0}.terminal small{display:block;padding:0 14px 12px;color:var(--muted)}dl{display:grid;grid-template-columns:110px 1fr;gap:8px;margin:0}dt{color:var(--muted)}dd{margin:0;overflow-wrap:anywhere}@media(max-width:600px){.controls{gap:9px}nav{width:100%}main{padding:15px}.launch{padding:14px 12px;gap:10px}.launch strong{font-size:16px}.launch small{font-size:11px}}@media(max-width:390px){.launch-grid{grid-template-columns:1fr}} + +.launch-card{position:relative;min-width:0}.launch-card>.launch{width:100%;height:100%;padding-right:58px}.launch-card:last-child{grid-column:1/-1}.launch-card:not(:last-child)>.launch{background:linear-gradient(120deg,#252d32,#1d2328);min-height:85px}.launch-card>.launcher-settings{position:absolute;bottom:10px;right:12px;padding:4px 7px;color:var(--muted);background:transparent;border-color:transparent;font-size:18px;line-height:1.2}.launcher-settings:hover{color:var(--lime);background:#2c3820;border-color:#53613f}.setting-link{display:block;width:100%;text-align:left;margin-top:7px;overflow-wrap:anywhere;font-size:12px}#fields details summary{color:var(--lime);cursor:pointer} + +/* Fit the home launcher grid and terminal to the available client area. */ +.shell>main.home-page{display:flex;flex-direction:column;overflow:hidden;padding:16px 20px}.home-page>.caption{flex:none;margin-bottom:10px}.home-page .launch-grid{flex:1;min-height:0;grid-template-rows:repeat(3,minmax(0,1fr));gap:10px}.home-page .launch-card .launch{min-height:0;padding:12px 50px 12px 16px}.home-page .launch-card{min-height:0}.home-page .launch-card .launch strong{font-size:clamp(15px,2vw,20px)}.home-page .launch-card .launch small{font-size:11px}.home-page .launch-card .launch svg{width:23px;height:23px}.shell>main.terminal-page{display:flex;overflow:hidden;min-height:0}.terminal-page .terminal{display:flex;flex-direction:column;flex:1;min-height:0;min-width:0}.terminal-page .terminal>header,.terminal-page .terminal>form,.terminal-page .terminal>small{flex:none}.terminal-page #terminal-output{flex:1;min-height:0;max-height:none;overflow:auto}.shell>main.settings-page{display:flex;flex-direction:column;overflow:hidden}.settings-page>.toolbar,.settings-page>p{flex:none}.settings-browser{display:grid;gap:14px}.settings-browser>input{width:100%}.settings-browser details{border:1px solid var(--line);border-radius:8px;padding:12px;background:var(--surface)}.settings-browser summary{color:var(--lime);cursor:pointer}.setting-link[hidden]{display:none}textarea{font:12px/1.6 Consolas,monospace;color:var(--text);background:#171d21;border:1px solid #45515b;border-radius:7px;padding:10px;resize:vertical;width:100%}@media(max-height:510px){.shell>header{padding:9px 18px}.brand{font-size:19px}.brand small{margin-top:0}.controls{padding:6px 18px}.home-page .launch-card .launch small{margin-top:0}.shell>main.home-page{padding:10px 16px}.home-page .launch-grid{gap:7px}.home-page .launch-card .launch{padding-top:5px;padding-bottom:5px}} diff --git a/gui/suite.html b/gui/suite.html new file mode 100644 index 0000000..eb2ec76 --- /dev/null +++ b/gui/suite.html @@ -0,0 +1,18 @@ + + +LANCTL + +
+
LANCTLNETWORK CONTROL SUITE
Sesión local
+
+
+

+
● GUISin proyecto
+
+

+ +

LANCTL · Confirmación

+

+
+ + diff --git a/gui/suite.js b/gui/suite.js new file mode 100644 index 0000000..18f4515 --- /dev/null +++ b/gui/suite.js @@ -0,0 +1,304 @@ +"use strict"; +const $ = selector => document.querySelector(selector); +// Application-owned confirmation: never delegate to browser-native prompts. +let pendingConfirmation=null; +function confirmAction(text,acceptLabel="Continuar"){ + if(pendingConfirmation)return Promise.resolve(false); + const dialog=$("#confirmation"); + $("#confirmation-message").textContent=text; + $("#confirmation-accept").textContent=acceptLabel; + return new Promise(resolve=>{pendingConfirmation=resolve;dialog.showModal();$("#confirmation-cancel").focus();}); +} +function finishConfirmation(accepted){ + const resolve=pendingConfirmation;if(!resolve)return; + pendingConfirmation=null;$("#confirmation").close();resolve(accepted); +} +const state = {page:"home", projects:[], plugins:[], activeProject:"", version:"", system:"", architecture:""}; +let submitForm = null; +let originalForm = ""; +let terminalTimer = null; +let terminalReading = false; +const listQueries={projects:"",plugins:""}; +const activity = []; +const apps = [ + ["lanip","LANIP","Inventario y diagnóstico","network"], + ["lanwire","LANWIRE","Cableado y topología","cable"], + ["lanrack","LANRACK","Salas y racks","server"], + ["lanaccess","LANACCESS","Credenciales y acceso","key"], + ["lanmon","LANMON","Monitorización y eventos","activity"] +]; +// Local vector icons: no remote dependency or executable plugin markup. +const icons = { + network:'', + cable:'', + server:'', + key:'', + activity:'' +}; +function icon(name){return ``;} +function esc(value){return String(value??"").replace(/[&<>"']/g,c=>({"&":"&","<":"<",">":">",'"':""","'":"'"}[c]));} +function message(text,error=false){$("#status").textContent=text;$("#status").classList.toggle("error",error);if(text){activity.push(new Date().toLocaleTimeString()+" · "+text);if(activity.length>100)activity.shift();}} +async function call(method,...args){ + if(!window.pywebview?.api)throw new Error("Abre esta interfaz con lanctl --gui."); + const response=await window.pywebview.api[method](...args); + if(!response.ok)throw Object.assign(new Error(response.error+(response.errorId?` (${response.errorId})`:"")),{errorDetails:response.errorDetails}); + return response; +} +function apply(payload){ + Object.assign(state,payload); + const select=$("#project");select.replaceChildren(new Option("Sin proyecto","")); + state.projects.forEach(p=>select.add(new Option(p.name,p.path)));select.value=state.activeProject||""; + $("#version").textContent="v"+state.version; + $("#project-status").textContent=(state.activeProjectInfo?.name||"Sin proyecto")+(state.activeProject?" · VLF":""); + $("#plugin-count").textContent=state.plugins.filter(p=>p.state==="ENABLED").length+" plugins"; +} +async function refresh(){apply(await call("bootstrap"));render();} +function render(){ + document.querySelectorAll("nav button").forEach(b=>b.classList.toggle("active",b.dataset.page===state.page)); + const host=$("#content"); + host.classList.toggle("home-page",state.page==="home"); + host.classList.toggle("terminal-page",state.page==="terminal"); + host.classList.toggle("settings-page",state.page==="settings"); + host.classList.toggle("list-page",["projects","plugins"].includes(state.page)); + if(state.page==="home")host.innerHTML='
PROGRAMASProyecto compartido · interfaces GUI
'+apps.map(([id,name,title,i])=>`
`).join("")+"
"; + if(state.page==="projects")host.innerHTML='

Proyectos

'+state.projects.map(p=>`

${esc(p.name)}

${esc(p.path)}

`).join("")+(!state.projects.length?'

Crea un proyecto o abre un archivo VLF existente.

':"")+"
"; + if(state.page==="plugins")host.innerHTML='

Plugins

'+state.plugins.map(p=>`

${esc(p.name)}

${p.hasSettings?``:""}

${esc(p.description)}

${esc(p.id)} · ${esc(p.version)} · ${esc(p.state)}${p.error?`

${esc(p.error)}

`:""}${p.settingsError?`

Configuración: ${esc(p.settingsError)}

`:""}
`).join("")+(!state.plugins.length?'

No hay plugins instalados. Usa el CLI para instalar paquetes LCP.

':"")+"
"; + if(["projects","plugins"].includes(state.page))prepareCollection(state.page); + if(state.page==="settings")host.innerHTML='

Configuración general

Todos los ajustes, agrupados por tema. Selecciona Programa o Proyecto activo.

'; + if(state.page==="terminal")host.innerHTML='
›_ LANCTL · CLI generalProceso local
Para sesiones SSH, contraseñas o TUI utiliza «CLI» en la barra inferior.
'; + if(state.page==="settings")generalSettings(state.settingsScope||"program").catch(error=>message(error.message,true)); +} +function prepareCollection(kind){ + const host=$("#content"),list=host.querySelector(".stack");list.classList.add("collection-list");list.setAttribute("aria-label",kind==="projects"?"Lista de proyectos":"Lista de plugins"); + const bar=document.createElement("div");bar.className="collection-search"; + const label=document.createElement("label");label.textContent=kind==="projects"?"Buscar proyecto":"Buscar plugin"; + const input=document.createElement("input");input.type="search";input.id="collection-search";input.placeholder="Buscar por nombre…";input.value=listQueries[kind];label.append(input); + const count=document.createElement("span");count.className="muted";count.id="collection-count";count.setAttribute("role","status");bar.append(label,count);list.before(bar); + const cards=[...list.querySelectorAll(".panel")]; + if(kind==="plugins")cards.forEach((card,i)=>{ + const p=state.plugins[i];card.querySelector("small.muted")?.remove(); + const data=document.createElement("div");data.className="plugin-facts"; + data.innerHTML=`Versión ${esc(p.version||"—")}Estado ${esc(p.state||"—")}Autor ${esc(p.author||"No indicado")}`; + const details=document.createElement("details");details.className="plugin-technical"; + details.innerHTML=`Información técnica
Identificador
${esc(p.id)}
Runtime
${esc(p.runtime||"No indicado")}
Compatibilidad LANCTL
${esc(p.minimumLanctl||"—")} → ${esc(p.maximumLanctl||"—")}
Capacidades
${esc((p.capabilities||[]).join(", ")||"Ninguna declarada")}
Permisos solicitados
${esc((p.permissions||[]).join(", ")||"Ninguno")}
Permisos concedidos
${esc((p.granted||[]).join(", ")||"Ninguno")}
Firma
${esc(p.signature||"No disponible")}
`; + const runtime=p.runtimeStatus; + if(runtime){ + const access=document.createElement("span");access.textContent="Acceso al Core: "+(runtime.coreAccess?"Autorizado":"Sin acceso");data.append(access); + if(runtime.restartRequired||runtime.cleanupPending){const notice=document.createElement("p");notice.className="plugin-runtime-warning";notice.textContent=runtime.restartRequired?"El acceso al Core está revocado. El código cargado requiere reiniciar este proceso; los hilos nativos no se consideran detenidos.":"Acceso retirado. La limpieza del complemento sigue pendiente.";card.append(notice);} + } + card.append(data,details); + }); + const empty=document.createElement("p");empty.className="collection-empty muted";empty.textContent="No hay resultados para esta búsqueda.";empty.hidden=true;list.append(empty); + function filter(){const query=input.value.trim().toLocaleLowerCase();listQueries[kind]=input.value;let shown=0;cards.forEach(card=>{card.hidden=!card.querySelector("h2").textContent.toLocaleLowerCase().includes(query);if(!card.hidden)shown++;});empty.hidden=shown>0||cards.length===0;count.textContent=shown+" de "+cards.length;list.scrollTop=0;} + input.addEventListener("input",filter);filter(); +} +async function navigate(page){ + if(page===state.page)return; + if(terminalTimer){clearInterval(terminalTimer);terminalTimer=null;} + state.page=page;message("");render(); + if(page==="terminal"){ + await call("start_terminal");await readTerminal(); + terminalTimer=setInterval(()=>readTerminal().catch(e=>message(e.message,true)),250); + $("#command").focus(); + } +} +async function readTerminal(){ + if(terminalReading)return;terminalReading=true; + try{const payload=await call("terminal_output"),host=$("#terminal-output");if(host){host.textContent=(host.textContent+payload.text).slice(-20000);host.scrollTop=host.scrollHeight;if(!payload.running)message("Consola cerrada. Cambia de sección y vuelve a Terminal para reiniciarla.");}} + finally{terminalReading=false;} +} +function field(label,name,value,type="text"){ + const node=document.createElement("label");node.textContent=label; + const input=document.createElement("input");input.name=name;input.type=type; + if(type==="checkbox"){node.className="check";input.checked=Boolean(value);}else input.value=value??""; + node.append(input);return node; +} +function showForm(title,nodes,submit,label="Guardar"){ + $("#dialog-title").textContent=title;$("#fields").replaceChildren(...nodes);$("#form-error").textContent=""; + $("#submit").textContent=label;$("#submit").hidden=!submit;$("#dismiss").hidden=!submit;submitForm=submit;originalForm=JSON.stringify([...new FormData($("#form"))]);if(!$("#dialog").open)$("#dialog").showModal(); +} +const metadataFields=[["name","Nombre"],["description","Descripción"],["author","Autor"],["lan","LAN"],["location","Ubicación"],["company","Empresa"],["responsible","Responsable"]]; +async function preserveProject(){ + const {dirty}=await call("project_state"); + if(!dirty)return true; + if(!await confirmAction("Hay cambios pendientes en el proyecto activo. ¿Guardarlos antes de continuar?","Guardar y continuar"))return false; + const result=await call("save_project");message(result.message);return true; +} +async function editProject(path){ + const data=await call("project_metadata",path); + showForm("Editar proyecto",metadataFields.map(([key,label])=>field(label,key,data.values[key])),async values=>{ + const result=await call("save_project_metadata",path,values,data.revision);apply(result);render();message(result.message); + }); +} +async function newProject(){ + if(!await preserveProject())return; + const defaults=await call("project_defaults"); + const directory={path:defaults.directory}; + const name=field("Nombre del proyecto","name",""),location=field("Carpeta","directory",directory.path); + name.querySelector("input").required=true;location.querySelector("input").required=true; + const help=document.createElement("small");help.textContent="Se creará un archivo .vlf vacío en esta carpeta. Los archivos existentes no se sobrescriben."; + const browse=document.createElement("button");browse.type="button";browse.textContent="Elegir otra carpeta…";browse.onclick=async()=>{try{const folder=await call("select_project_directory");if(folder.path)location.querySelector("input").value=folder.path;}catch(error){$("#form-error").textContent=error.message;}}; + showForm("Crear proyecto VLF",[name,location,browse,...metadataFields.slice(1).map(([key,label])=>field(label,key,key==="lan"?defaults.lan:"")),help],async values=>{ + const metadata=Object.fromEntries(metadataFields.map(([key])=>[key,values[key]||""])); + const payload=await call("create_project",values.name,values.directory,metadata);apply(payload);await refresh();message(payload.message+" · "+payload.activeProject); + },"Crear archivo VLF"); +} +async function configurePlugin(id){ + const p=state.plugins.find(p=>p.id===id),data=await call("plugin_settings",id),nodes=[]; + const info=document.createElement("p");info.textContent=`${p.runtime} · Permisos: ${p.permissions.join(", ")||"ninguno"}. Concedidos: ${p.granted.join(", ")||"ninguno"}.`;nodes.push(info); + if(!data.fields.length){const hint=document.createElement("p");hint.className="muted";hint.textContent="Este plugin no declara opciones propias de configuración.";nodes.push(hint);} + for(const f of data.fields){ + let node; + if(f.type==="select"){node=document.createElement("label");node.textContent=f.label||f.name;const select=document.createElement("select");select.name=f.name;f.choices.forEach(c=>select.add(new Option(c,c)));select.value=data.values[f.name];node.append(select);} + else{node=field(f.label||f.name,f.name,data.values[f.name],f.type==="boolean"?"checkbox":f.type==="integer"?"number":"text");const input=node.querySelector("input");if(f.type==="integer"){input.step="1";if(f.minimum!==undefined)input.min=f.minimum;if(f.maximum!==undefined)input.max=f.maximum;}} + nodes.push(node); + } + showForm(p.name,nodes,data.fields.length?async values=>{ + const options={};for(const f of data.fields)options[f.name]=f.type==="boolean"?values[f.name]==="on":f.type==="integer"?Number(values[f.name]):values[f.name]; + const result=await call("save_plugin_settings",id,options);message(result.message); + }:null); +} +async function togglePlugin(id){ + const p=state.plugins.find(p=>p.id===id); + if(p.state==="ENABLED"){apply(await call("set_plugin_enabled",id,false));render();return;} + const info=document.createElement("p");info.textContent="Revisa los permisos solicitados antes de activar este complemento."; + const nodes=[info,...p.permissions.map(permission=>field(permission,permission,p.granted.includes(permission),"checkbox"))]; + if(p.runtime==="trusted"&&!p.publisherTrusted){ + const help=document.createElement("p"); + if(!p.signature?.startsWith("VALID_ED25519:")){ + help.textContent="Este paquete no tiene una firma válida. Solicita al editor un LCP firmado e instálalo antes de activarlo. Marcar permisos no autoriza un paquete sin firma."; + const install=document.createElement("button");install.type="button";install.className="primary";install.textContent="Instalar versión firmada…"; + install.onclick=async()=>{install.disabled=true;try{const result=await call("install_signed_plugin",id);if(!result.cancelled){apply(result);await togglePlugin(id);}}catch(error){$("#form-error").textContent=error.message;}finally{install.disabled=false;}}; + nodes.push(help,install);showForm("Activar "+p.name,nodes,null);return; + } + help.textContent="El paquete está firmado, pero su editor todavía no está autorizado. Comprueba esta huella con el editor antes de confiar: "+p.signature.slice(14); + const trust=document.createElement("button");trust.type="button";trust.textContent="Autorizar editor seleccionando su LCP firmado…"; + trust.onclick=async()=>{trust.disabled=true;try{const result=await call("trust_plugin_publisher",id);if(!result.cancelled){apply(result);await togglePlugin(id);}}catch(error){$("#form-error").textContent=error.message;}finally{trust.disabled=false;}}; + nodes.push(help,trust);showForm("Autorizar editor de "+p.name,nodes,null);return; + } + if(p.runtime==="trusted")nodes.push(field("Autorizar ejecución trusted (editor autorizado)","_trust",p.trusted,"checkbox")); + showForm("Activar "+p.name,nodes,async values=>{apply(await call("set_plugin_enabled",id,true,p.permissions.filter(x=>values[x]==="on"),values._trust==="on"));render();},"Activar plugin"); +} +async function editSettings(){ + const payload=await call("get_settings"); + showForm("Configuración general",payload.fields.map(f=>{ + if(!f.choices)return field(f.label,f.key,f.value); + const label=document.createElement("label");label.textContent=f.label; + const select=document.createElement("select");select.name=f.key;f.choices.forEach(c=>select.add(new Option(c,c)));select.value=f.value;label.append(select);return label; + }),async values=>message((await call("save_settings",values)).message)); +} +$("#form").addEventListener("submit",async e=>{e.preventDefault();if(!submitForm)return;$("#submit").disabled=true;try{await submitForm(Object.fromEntries(new FormData(e.target)));$("#dialog").close();}catch(error){$("#form-error").textContent=error.message;}finally{$("#submit").disabled=false;}}); +async function dismissForm(){ + if(submitForm&&originalForm!==JSON.stringify([...new FormData($("#form"))])&&!await confirmAction("Hay cambios sin guardar. ¿Descartarlos?","Descartar cambios"))return; + $("#dialog").close(); +} +async function suiteClose(){ + try{ + if($("#dialog").open&&submitForm&&originalForm!==JSON.stringify([...new FormData($("#form"))])&&!await confirmAction("Hay cambios sin guardar en el formulario. ¿Descartarlos y cerrar?","Descartar y cerrar"))return; + if(!await preserveProject())return; + const result=await call("request_close");if(!result.closed)message("No se pudo cerrar la ventana.",true); + }catch(error){message(error.message,true);} +} +$("#close-dialog").onclick=$("#dismiss").onclick=dismissForm; +$("#dialog").addEventListener("cancel",e=>{e.preventDefault();dismissForm();}); +$("#project").addEventListener("change",async e=>{try{if(!e.target.value){e.target.value=state.activeProject;return;}if(!await preserveProject()){e.target.value=state.activeProject;return;}apply(await call("use_project",e.target.value));render();}catch(error){e.target.value=state.activeProject;message(error.message,true);}}); +document.addEventListener("click",async e=>{ + const b=e.target.closest("button");if(!b)return; + try{ + if(b.dataset.settingsScope)return await generalSettings(b.dataset.settingsScope); + if(b.dataset.page){await navigate(b.dataset.page);return;} + if(b.dataset.launcherSettings)return await launcherSettings(b.dataset.launcherSettings); + if(b.dataset.launch){if(window.guiActivityFlush)await window.guiActivityFlush();const result=await call("launch_gui",b.dataset.launch);if(!result.closed)message(result.message);return;} + if(b.dataset.editProject)return await editProject(b.dataset.editProject); + if(b.dataset.project){if(!await preserveProject())return;apply(await call("use_project",b.dataset.project));render();return;} + if(b.dataset.pluginConfig)return await configurePlugin(b.dataset.pluginConfig); + if(b.dataset.pluginToggle)return await togglePlugin(b.dataset.pluginToggle); + if(b.id==="external-cli")return message((await call("open_cli")).message); + if(b.id==="activity"){const log=document.createElement("div");log.className="stack";for(const text of activity.slice(-20)){const line=document.createElement("p");line.textContent=text;log.append(line);}if(!activity.length)log.textContent="Sin operaciones registradas en esta sesión.";showForm("Actividad de sesión",[log],null);return;} + if(b.id==="system-info"){ + const dl=document.createElement("dl");for(const [label,value] of [["Versión",state.version],["Sistema",state.system],["Arquitectura",state.architecture],["Proyecto",state.activeProject||"Sin proyecto"],["Interfaz","GUI local · pywebview"],["Archivos","Proyectos VLF · plugins LCP"]]){const dt=document.createElement("dt"),dd=document.createElement("dd");dt.textContent=label;dd.textContent=value;dl.append(dt,dd);}showForm("Información del sistema",[dl],null);return; + } + if(b.dataset.action==="new-project")await newProject(); + if(b.dataset.action==="refresh")await refresh(); + if(b.dataset.action==="save-project"){const result=await call("save_project");message(result.message);} + if(b.dataset.action==="open-project"){const file=await call("select_project_file");if(file.path&&await preserveProject()){apply(await call("use_project",file.path));render();}} + if(b.dataset.action==="edit-settings")await editSettings(); + }catch(error){message(error.message,true);} +}); +document.addEventListener("submit",async e=>{if(e.target.id!=="terminal-form")return;e.preventDefault();const input=$("#command"),line=input.value;input.value="";try{await call("terminal_send",line);await readTerminal();}catch(error){message(error.message,true);}}); +window.addEventListener("pywebviewready",()=>refresh().catch(error=>message(error.message,true))); + +// Reconcile shared state without replacing a form or interrupting terminal input. +window.suiteDataChanged=false; +let backgroundRefresh=false; +setInterval(async()=>{ + if(!window.suiteDataChanged||backgroundRefresh||$("#dialog").open||!window.pywebview?.api)return; + backgroundRefresh=true;window.suiteDataChanged=false; + try{apply(await call("bootstrap"));if(state.page!=="terminal")render();} + catch(error){window.suiteDataChanged=true;message(error.message,true);} + finally{backgroundRefresh=false;} +},1000); + +let runtimeReading=false; +setInterval(async()=>{ + if(runtimeReading||!window.pywebview?.api.runtime_status)return; + runtimeReading=true; + try{ + const result=await call("runtime_status"),old=state.sessions||[],next=result.sessions; + for(const session of next.filter(s=>s.mode==="gui"&&!old.some(p=>p.id===s.id)))message(session.launcher.toUpperCase()+" · GUI abierta"); + for(const session of old.filter(s=>s.mode==="gui"&&!next.some(p=>p.id===s.id)))message(session.launcher.toUpperCase()+" · GUI cerrada o desconectada"); + const changed=JSON.stringify(old.map(s=>s.id))!==JSON.stringify(next.map(s=>s.id)); + const pluginsChanged=result.plugins&&JSON.stringify(state.plugins)!==JSON.stringify(result.plugins); + if(result.plugins)state.plugins=result.plugins; + state.sessions=next; + if(pluginsChanged&&$("#dialog").open)window.suiteDataChanged=true; + else if((changed&&state.page==="home")||(pluginsChanged&&state.page==="plugins"))render(); + }catch(error){message(error.message,true);}finally{runtimeReading=false;} +},2000); + +$("#confirmation-cancel").onclick=()=>finishConfirmation(false); +$("#confirmation-accept").onclick=()=>finishConfirmation(true); +$("#confirmation").addEventListener("cancel",e=>{e.preventDefault();finishConfirmation(false);}); + +function settingsEditor(entry,save,title){ + const note=document.createElement("p"); + note.textContent=entry.readOnly||"Los cambios se comparten con las demás interfaces y se validan antes de guardarse."; + const complex=entry.value===null||typeof entry.value==="object"; + const type=typeof entry.value==="boolean"?"checkbox":typeof entry.value==="number"?"number":"text"; + const input=field(complex?"Valor JSON":"Valor","value",complex?JSON.stringify(entry.value,null,2):entry.value,type); + if(type==="number")input.querySelector("input").step="any"; + if(complex){const area=document.createElement("textarea");area.name="value";area.rows=8;area.value=JSON.stringify(entry.value,null,2);input.querySelector("input").replaceWith(area);} + if(entry.readOnly)input.querySelector("input,textarea").disabled=true; + showForm(title+" · "+entry.path,[note,input],entry.readOnly?null:async values=>{ + const value=type==="checkbox"?values.value==="on":type==="number"?Number(values.value):complex?JSON.parse(values.value):values.value; + await save(value); + }); +} +function settingsList(payload,edit){ + const wrapper=document.createElement("div");wrapper.className="settings-browser"; + const search=document.createElement("input");search.type="search";search.placeholder="Buscar una opción…";search.setAttribute("aria-label","Buscar configuración");wrapper.append(search); + const sections=[]; + for(const category of [...new Set(payload.entries.map(e=>e.category))]){ + const section=document.createElement("details"),title=document.createElement("summary");section.open=true;title.textContent=payload.categories[category]||category;section.append(title); + const buttons=[]; + for(const entry of payload.entries.filter(e=>e.category===category)){ + const b=document.createElement("button");b.type="button";b.className="setting-link";b.textContent=entry.path+(entry.readOnly?" · Solo lectura":"");b.onclick=()=>edit(entry);section.append(b);buttons.push(b); + }wrapper.append(section);sections.push([section,buttons]); + } + search.oninput=()=>{for(const [section,buttons] of sections){for(const b of buttons)b.hidden=!b.textContent.toLocaleLowerCase().includes(search.value.toLocaleLowerCase());section.hidden=buttons.every(b=>b.hidden);}}; + return wrapper; +} +async function generalSettings(scope){ + state.settingsScope=scope; + const payload=await call("settings_catalog",scope); + if(state.page!=="settings")return; + $("#settings-catalog").replaceChildren(settingsList(payload,entry=>settingsEditor(entry,async value=>{ + message((await call("save_catalog_setting",scope,entry.path,value)).message);await generalSettings(scope); + },scope==="program"?"LANCTL":"Proyecto"))); + document.querySelectorAll("[data-settings-scope]").forEach(b=>b.classList.toggle("primary",b.dataset.settingsScope===scope)); +} +async function launcherSettings(launcher){ + const payload=await call("launcher_settings",launcher); + const intro=document.createElement("p");intro.className="muted";intro.textContent=["lanwire","lanrack"].includes(launcher)?"Opciones compartidas de proyectos y almacenamiento.":"Opciones del launcher agrupadas por tema."; + showForm("Configuración de "+launcher.toUpperCase(),[intro,settingsList(payload,entry=>settingsEditor(entry,async value=>message((await call("save_launcher_setting",launcher,entry.path,value)).message),launcher.toUpperCase()))],null); +} diff --git a/gui/wire-gui.js b/gui/wire-gui.js new file mode 100644 index 0000000..d1e89c5 --- /dev/null +++ b/gui/wire-gui.js @@ -0,0 +1,1580 @@ +/* LANWIRE workspace: independent list and interactive topology, real RPC operations. */ +const wireBase = { render, refresh, records, fullDetails, settings, wireEdit }; +const wireNames = { + "device.switch": "Switch de red", + "device.router": "Router", + "device.pc": "Ordenador", + "device.server": "Servidor", + "device.outlet": "Toma de red", + "device.panel": "Panel de conexiones", + panel: "Panel de conexiones", + wire: "Cable", + rack: "Rack", + "external.supply": "Suministro del proveedor", + "wire.copper": "Cable de cobre", + "wire.fiber": "Cable de fibra", + "wire.dac": "Cable DAC", + element: "Elemento", + "device.gateway": "Puerta de enlace", + "device.workstation": "Estación de trabajo", + "connection.rj45": "RJ45", + "connection.fiber": "Fibra óptica", + "connection.dac": "DAC", + "connection.unknown": "Sin especificar", +}; +function wireName(v) { + return ( + wireNames[v] || + String(v || "Elemento") + .replace(/^device\./, "") + .replace(/[._]/g, " ") + ); +} +const wireModes = [ + ["wired", "Cable"], + ["wifi", "Wi-Fi"], + ["mixed", "Cable y Wi-Fi"], +]; +function wireReadPrefs() { + try { + const saved = JSON.parse( + localStorage.getItem("lanwire.gui.preferences") || "{}", + ); + if (saved.schemaVersion !== 1) return {}; + return { + ...saved, + view: ["map", "list"].includes(saved.view) ? saved.view : "map", + depth: + Number.isInteger(saved.depth) && saved.depth >= 1 && saved.depth <= 10 + ? saved.depth + : 1, + columns: Array.isArray(saved.columns) + ? saved.columns + : ["id", "type", "connections", "rack", "mode"], + }; + } catch { + return {}; + } +} +let wirePrefs = { + schemaVersion: 1, + depth: 1, + labels: true, + minimap: false, + view: "map", + columns: ["id", "type", "connections", "rack", "mode"], + ...wireReadPrefs(), +}; +view = wirePrefs.view; +let wireFilter = { + kind: "", + prefix: "", + group: "", + rack: "", + mode: "", + status: "", + medium: "", + }, + wireSort = { key: "name", direction: 1 }; +let camera = { x: 40, y: 40, z: 1 }, + wirePositions = {}, + wireFocus = null, + wireHidden = new Set(), + wireHistory = [], + wireHistoryIndex = -1, + wireDragging = false, + wireGraph = null, + wireInitialized = false; +function wireStore() { + localStorage.setItem("lanwire.gui.preferences", JSON.stringify(wirePrefs)); +} +function wirePositionKey() { + return "lanwire.layout." + state.storage; +} +function wireLoadPositions() { + try { + const saved = JSON.parse(localStorage.getItem(wirePositionKey()) || "{}"); + wirePositions = saved.schemaVersion === 1 ? saved.positions || {} : {}; + } catch { + wirePositions = {}; + } +} +function wireSavePositions() { + localStorage.setItem( + wirePositionKey(), + JSON.stringify({ schemaVersion: 1, positions: wirePositions }), + ); +} +function wireConnections(r) { + return state.records.filter( + (w) => + w.data.type === "wire" && + (w.data.endpoints || []).some((e) => e.device === r.id), + ); +} +function wireFree(r) { + return Object.keys(r.data.ports || {}).some( + (p) => + !wireConnections(r).some((w) => + w.data.endpoints.some((e) => e.device === r.id && e.port === p), + ), + ); +} +records = function () { + if (state.launcher !== "lanwire") return wireBase.records(); + const query = $("#search").value.trim().toLocaleLowerCase(), + type = $("#filter").value; + let rows = state.records.filter((r) => { + const d = r.data, + f = wireFilter; + return ( + (!type || d.type === type) && + (!query || + [ + r.id, + r.prefix, + d.name, + d.alias, + d.description, + d.ip, + ...(r.filterGroups || []), + wireName(d.type), + ] + .join(" ") + .toLocaleLowerCase() + .includes(query)) && + (!f.kind || (f.kind === "wires") === (d.type === "wire")) && + (!f.prefix || r.prefix === f.prefix) && + (!f.group || (r.filterGroups || d.groups || []).includes(f.group)) && + (!f.rack || view === "map" || d.location?.rack === f.rack) && + (!f.mode || (d.connectionMode || "wired") === f.mode) && + (!f.medium || + d.kind === f.medium || + Object.values(d.ports || {}).some((p) => p.kind === f.medium)) && + (!f.status || + (f.status === "free" + ? wireFree(r) + : f.status === "connected" + ? d.type === "wire" + ? d.endpoints?.length + : wireConnections(r).length + : !(d.type === "wire" + ? d.endpoints?.length + : wireConnections(r).length))) + ); + }); + const value = (r) => + wireSort.key === "name" + ? labelOf(r) + : wireSort.key === "type" + ? wireName(r.data.type) + : r.id; + return rows.sort( + (a, b) => + String(value(a)).localeCompare(String(value(b)), "es", { + numeric: true, + }) * wireSort.direction, + ); +}; +refresh = async function () { + if (wireDragging) return; + await wireBase.refresh(); + if (state.launcher !== "lanwire") return; + for (const o of $("#filter").options) { + if (o.value) { + const identifier = o.value; + o.value = identifier; + o.textContent = wireName(identifier); + } + } + if (!wireInitialized) { + wireInitialized = true; + document.body.classList.add("wire-app"); + const project = document.createElement("button"); + project.id = "wire-project"; + project.textContent = "Cambiar proyecto"; + project.onclick = () => + wireProjects().catch((e) => message(e.message, true)); + $("#project-name").parentNode.after(project); + const more = document.createElement("button"); + more.id = "wire-filters"; + more.textContent = "Filtros"; + more.onclick = wireFilters; + $("#filter").after(more); + const clear = document.createElement("button"); + clear.textContent = "Limpiar"; + clear.onclick = wireClearFilters; + more.after(clear); + const active = document.createElement("span"); + active.id = "wire-active-filters"; + $(".filterbar").after(active); + } + $("#wire-active-filters").textContent = + Object.values(wireFilter).filter(Boolean).length + + " filtros adicionales · Almacén físico compartido"; +}; +renderWire = function (rows, r) { + if (!wireInitialized) wireLoadPositions(); + if (view === "list") { + const cols = { + id: ["Identificador", (x) => x.id], + type: ["Tipo", (x) => wireName(x.data.type)], + connections: [ + "Conexiones", + (x) => + x.data.type === "wire" + ? (x.data.endpoints || []) + .map((e) => e.device + " · " + e.port) + .join(" ↔ ") + : wireConnections(x) + .map((w) => w.id) + .join(", "), + ], + rack: [ + "Rack / unidad", + (x) => + [x.data.location?.rack, x.data.location?.unit] + .filter(Boolean) + .join(" / "), + ], + mode: [ + "Conexión", + (x) => + wireModes.find( + (m) => m[0] === (x.data.connectionMode || "wired"), + )?.[1], + ], + alias: ["Alias", (x) => x.data.alias], + group: [ + "Grupos", + (x) => (x.filterGroups || x.data.groups || []).join(", "), + ], + }; + const visible = wirePrefs.columns.filter((k) => cols[k]); + $("#canvas").innerHTML = + '
" + + table(["Elemento", ...visible.map((k) => cols[k][0])], rows, (x) => [ + labelOf(x), + ...visible.map((k) => cols[k][1](x)), + ]); + $("#wire-columns").onclick = wireColumns; + $("#wire-sort").value = wireSort.key; + $("#wire-sort").onchange = (e) => { + wireSort.key = e.target.value; + render(); + }; + $("#wire-direction").onclick = () => { + wireSort.direction *= -1; + render(); + }; + wireResizeColumns(); + return; + } + wireRenderTopology(rows); +}; +render = function () { + wireBase.render(); + if (state.launcher !== "lanwire") return; + wirePrefs.view = view; + wireStore(); + if (!state.records.length && !$("#wire-board")) return; +}; +function wireClearFilters() { + wireFilter = { + kind: "", + prefix: "", + group: "", + rack: "", + mode: "", + status: "", + medium: "", + }; + $("#search").value = ""; + $("#filter").value = ""; + wireHidden.clear(); + render(); +} +function wireFilters() { + const opts = (key, label, values) => + field(label, key, wireFilter[key], "text", [["", "Todos"], ...values]); + const unique = (values) => + [...new Set(values.filter(Boolean))].map((v) => [v, v]); + showForm( + "Filtros de elementos", + [ + opts("kind", "Mostrar", [ + ["elements", "Equipos e infraestructura"], + ["wires", "Cables"], + ]), + opts("prefix", "Prefijo", unique(state.records.map((r) => r.prefix))), + opts( + "group", + "Grupo", + unique( + state.records.flatMap((r) => r.filterGroups || r.data.groups || []), + ).map(([v]) => [ + v, + { + WIRE: "Cables", + SWITCHS: "Equipos de distribución", + PC: "Ordenadores y servidores", + }[v] || v, + ]), + ), + opts( + "rack", + "Rack", + state.records + .filter((r) => r.data.type === "rack") + .map((r) => [r.id, labelOf(r)]), + ), + opts("mode", "Tipo de conexión", wireModes), + opts("status", "Disponibilidad", [ + ["connected", "Conectados"], + ["disconnected", "Sin conectar"], + ["free", "Con puertos libres"], + ]), + opts("medium", "Medio", [ + ["wire.copper", "Cobre"], + ["wire.fiber", "Fibra"], + ["wire.dac", "DAC"], + ]), + ], + async (values) => { + wireFilter = values; + }, + ); +} +function wireColumns() { + const note = document.createElement("p"); + note.textContent = + "Identificador, Tipo, Conexiones, Rack, Conexión, Alias y Grupos."; + const box = document.createElement("div"); + for (const [key, label] of [ + ["id", "Identificador"], + ["type", "Tipo"], + ["connections", "Conexiones"], + ["rack", "Rack"], + ["mode", "Conexión"], + ["alias", "Alias"], + ["group", "Grupos"], + ]) { + const f = field(label, key, "", "checkbox"); + f.querySelector("input").checked = wirePrefs.columns.includes(key); + box.append(f); + } + showForm("Columnas de la lista", [note, box], async (v) => { + wirePrefs.columns = Object.keys(v); + wireStore(); + }); +} +function wireEdges() { + return state.records + .filter((r) => r.data.type === "wire") + .map((w) => { + const ends = [ + ...(w.data.source + ? [{ device: w.data.source, port: "Proveedor" }] + : []), + ...(w.data.endpoints || []), + ]; + return { wire: w, a: ends[0], b: ends[1] }; + }); +} +function wireNeighborhood(id, depth) { + const found = new Set([id]); + for (let i = 0; i < depth; i++) { + const before = new Set(found); + for (const e of wireEdges()) + if ( + before.has(e.a?.device) || + before.has(e.b?.device) || + before.has(e.wire.id) + ) { + found.add(e.wire.id); + if (e.a) found.add(e.a.device); + if (e.b) found.add(e.b.device); + } + } + return found; +} +function wireLayout(nodes) { + const levels = new Map(), + seen = new Set(), + adj = new Map(nodes.map((n) => [n.id, []])); + for (const e of wireEdges()) + if (adj.has(e.a?.device) && adj.has(e.b?.device)) { + adj.get(e.a.device).push(e.b.device); + adj.get(e.b.device).push(e.a.device); + } + const roots = [...nodes].sort( + (a, b) => (adj.get(b.id)?.length || 0) - (adj.get(a.id)?.length || 0), + ); + let offset = 0, + rowY = 0, + rowHeight = 0; + for (const root of roots) { + if (seen.has(root.id)) continue; + const queue = [[root.id, 0]], + width = new Map(), + component = new Map(); + while (queue.length) { + const [id, level] = queue.shift(); + if (seen.has(id)) continue; + seen.add(id); + const col = width.get(level) || 0; + width.set(level, col + 1); + component.set(id, { x: col * 235, y: level * 170 }); + for (const next of adj.get(id) || []) + if (!seen.has(next)) queue.push([next, level + 1]); + } + const componentWidth = Math.max(1, ...width.values()) * 235; + const componentHeight = width.size * 170; + if (offset && offset + componentWidth > 1200) { + offset = 0; + rowY += rowHeight + 70; + rowHeight = 0; + } + for (const [id, p] of component) + levels.set(id, { x: offset + p.x, y: rowY + p.y }); + offset += componentWidth + 70; + rowHeight = Math.max(rowHeight, componentHeight); + } + return levels; +} +function wireRenderTopology(rows) { + let allowed = new Set(rows.map((r) => r.id)); + // A matching cable needs its endpoint equipment as visual context, even + // when the type filter or search matches only the cable itself. + for (const edge of wireEdges()) { + if (allowed.has(edge.wire.id)) { + if (edge.a) allowed.add(edge.a.device); + if (edge.b) allowed.add(edge.b.device); + } + } + if (wireFocus) { + const neighborhood = wireNeighborhood(wireFocus, Number(wirePrefs.depth)); + allowed = new Set([...allowed].filter((id) => neighborhood.has(id))); + } + const nodes = state.records.filter( + (r) => + r.data.type !== "wire" && + r.data.type !== "rack" && + allowed.has(r.id) && + !wireHidden.has(r.id) && + (wirePrefs.showWifi || r.data.connectionMode !== "wifi"), + ); + const automatic = wireLayout(nodes); + for (const n of nodes) + if (!wirePositions[n.id]) wirePositions[n.id] = automatic.get(n.id); + wireGraph = { + nodes, + edges: wireEdges().filter( + (e) => + allowed.has(e.wire.id) || + (allowed.has(e.a?.device) && allowed.has(e.b?.device)), + ), + }; + $("#canvas").innerHTML = + '
' + + nodes + .map( + (n) => + ``, + ) + .join("") + + '
Arrastrar: mover · Rueda: zoom · Doble clic: detalles · Clic derecho: acciones' + + (wireFocus ? " · Enfoque: " + esc(wireFocus) : "") + + "
"; + $("#wire-depth").value = wirePrefs.depth; + $("#wire-depth").onchange = (e) => { + wirePrefs.depth = Number(e.target.value); + wireStore(); + render(); + wireFit(); + }; + $("#wire-board").onwheel = (e) => { + e.preventDefault(); + const rect = e.currentTarget.getBoundingClientRect(); + wireZoom( + Math.exp(-e.deltaY * 0.001), + e.clientX - rect.left, + e.clientY - rect.top, + ); + }; + $("#wire-board").onpointerdown = wirePointer; + $("#wire-board").ondblclick = (e) => { + const node = e.target.closest("[data-node]"); + if (node) { + clearTimeout(clickTimer); + selected = node.dataset.node; + fullDetails(state.records.find((r) => r.id === selected)); + } + }; + $("#wire-board").oncontextmenu = (e) => { + e.preventDefault(); + const n = e.target.closest("[data-node]"); + if (n) { + selected = n.dataset.node; + wireContext(state.records.find((r) => r.id === selected)); + } + }; + $("#wire-board").onkeydown = (e) => { + if ( + [ + "ArrowLeft", + "ArrowRight", + "ArrowUp", + "ArrowDown", + "+", + "-", + "Home", + ].includes(e.key) + ) + e.preventDefault(); + if (e.key === "+") wireZoom(1.2); + else if (e.key === "-") wireZoom(1 / 1.2); + else if (e.key === "Home") wireFit(); + else { + camera.x += e.key === "ArrowLeft" ? 40 : e.key === "ArrowRight" ? -40 : 0; + camera.y += e.key === "ArrowUp" ? 40 : e.key === "ArrowDown" ? -40 : 0; + wirePaint(); + } + }; + wirePaint(); +} +function wirePaint() { + if (!$("#wire-world") || !wireGraph) return; + $("#wire-world").style.transform = + `translate(${camera.x}px,${camera.y}px) scale(${camera.z})`; + for (const n of wireGraph.nodes) { + const el = document.querySelector('[data-node="' + CSS.escape(n.id) + '"]'), + p = wirePositions[n.id]; + el.style.left = p.x + "px"; + el.style.top = p.y + "px"; + el.classList.toggle("selected", n.id === selected); + el.classList.toggle("no-labels", !wirePrefs.labels); + } + const visible = new Set(wireGraph.nodes.map((n) => n.id)), + near = wireNeighborhood(selected, 1); + $("#wire-lines").innerHTML = wireGraph.edges + .filter((e) => visible.has(e.a?.device) || visible.has(e.b?.device)) + .map((original) => { + const e = visible.has(original.a?.device) + ? original + : { ...original, a: original.b, b: original.a }; + const a = wireAnchor(e.a), + b = visible.has(e.b?.device) + ? wireAnchor(e.b) + : { x: a.x + 220, y: a.y + 120 }; + return `${wirePrefs.labels ? esc(e.wire.id + " · " + e.a.port + " ↔ " + (e.b?.port || "Sin conectar")) : ""}`; + }) + .join(""); + $("#wire-lines").onclick = (e) => { + const cable = e.target.closest("[data-cable]"); + if (cable) { + selected = cable.dataset.cable; + fullDetails(state.records.find((r) => r.id === selected)); + } + }; + $("#wire-zoom").textContent = Math.round(camera.z * 100) + " %"; + wireMini(); + wireNavAvailability(); +} +function wireNavAvailability() { + const back = document.querySelector('[data-nav="back"]'); + const forward = document.querySelector('[data-nav="forward"]'); + if (back) back.disabled = wireHistoryIndex <= 0; + if (forward) forward.disabled = wireHistoryIndex >= wireHistory.length - 1; +} +function wireAnchor(endpoint) { + const node = document.querySelector( + `[data-node="${CSS.escape(endpoint.device)}"]`, + ); + const port = node?.querySelector( + `[data-port="${CSS.escape(endpoint.port || "")}"]`, + ); + if (port && wirePrefs.showPorts !== false) { + const rect = port.getBoundingClientRect(), + board = $("#wire-board").getBoundingClientRect(); + return { + x: (rect.x + rect.width / 2 - board.x - camera.x) / camera.z, + y: (rect.y + rect.height / 2 - board.y - camera.y) / camera.z, + }; + } + const position = wirePositions[endpoint.device]; + return { x: position.x + 95, y: position.y + 45 }; +} +function wireZoom(factor, x, y) { + const board = $("#wire-board"); + if (!board) return; + x ??= board.clientWidth / 2; + y ??= board.clientHeight / 2; + const z = Math.max(0.02, Math.min(3, camera.z * factor)); + camera.x = x - ((x - camera.x) * z) / camera.z; + camera.y = y - ((y - camera.y) * z) / camera.z; + camera.z = z; + wirePaint(); +} +function wireBounds() { + const ps = wireGraph.nodes.map((n) => wirePositions[n.id]); + return { + x: Math.min(0, ...ps.map((p) => p.x)), + y: Math.min(0, ...ps.map((p) => p.y)), + right: Math.max(200, ...ps.map((p) => p.x + 190)), + bottom: Math.max(100, ...ps.map((p) => p.y + 100)), + }; +} +function wireFit() { + if (!$("#wire-board") || !wireGraph) return; + const b = wireBounds(), + el = $("#wire-board"); + camera.z = Math.max( + 0.02, + Math.min( + 1.5, + (el.clientWidth - 80) / (b.right - b.x), + (el.clientHeight - 80) / (b.bottom - b.y), + ), + ); + camera.x = (el.clientWidth - (b.right - b.x) * camera.z) / 2 - b.x * camera.z; + camera.y = + (el.clientHeight - (b.bottom - b.y) * camera.z) / 2 - b.y * camera.z; + wirePaint(); +} +function wireCenter() { + let p = wirePositions[selected]; + const el = $("#wire-board"); + if (!p) { + const edge = wireEdges().find((e) => e.wire.id === selected); + const points = [edge?.a, edge?.b] + .filter((e) => e && wirePositions[e.device]) + .map((e) => wirePositions[e.device]); + if (points.length) + p = { + x: points.reduce((sum, p) => sum + p.x, 0) / points.length, + y: points.reduce((sum, p) => sum + p.y, 0) / points.length, + }; + } + if (!p || !el) { + message("Selecciona un equipo visible para centrarlo."); + return; + } + camera.x = el.clientWidth / 2 - (p.x + 95) * camera.z; + camera.y = el.clientHeight / 2 - (p.y + 45) * camera.z; + wirePaint(); +} +function wireRemember() { + wireHistory = wireHistory.slice(0, wireHistoryIndex + 1); + wireHistory.push({ camera: { ...camera }, focus: wireFocus, selected }); + wireHistoryIndex = wireHistory.length - 1; + wireNavAvailability(); +} +function wireNavigate(action) { + if (action === "back" || action === "forward") { + const next = wireHistoryIndex + (action === "back" ? -1 : 1); + if (next < 0 || next >= wireHistory.length) return; + wireHistoryIndex = next; + const h = wireHistory[next]; + camera = { ...h.camera }; + wireFocus = h.focus; + selected = h.selected; + render(); + return; + } + if (!wireHistory.length) wireRemember(); + if (action === "in") wireZoom(1.25); + if (action === "out") wireZoom(0.8); + if (action === "reset") { + wireZoom(1 / camera.z); + } + if (action === "fit") wireFit(); + if (action === "center") wireCenter(); + if (action === "focus") { + wireFocus = selected; + wireHidden.clear(); + render(); + wireFit(); + } + if (action === "all") { + wireFocus = null; + wireHidden.clear(); + render(); + wireFit(); + } + if (action === "layout") { + wirePositions = {}; + render(); + wireFit(); + wireSavePositions(); + } + if (action === "mini") { + wirePrefs.minimap = !wirePrefs.minimap; + wireStore(); + wirePaint(); + } + wireRemember(); +} +function wireMini() { + const mini = $("#wire-minimap"); + if (!mini) return; + mini.style.display = wirePrefs.minimap ? "block" : "none"; + const b = wireBounds(), + w = b.right - b.x + 80, + h = b.bottom - b.y + 80; + mini.setAttribute("viewBox", `${b.x - 40} ${b.y - 40} ${w} ${h}`); + mini.innerHTML = + wireGraph.nodes + .map((n) => { + const p = wirePositions[n.id]; + return ``; + }) + .join("") + + ``; + mini.onclick = (e) => { + const r = mini.getBoundingClientRect(), + scale = Math.min(r.width / w, r.height / h), + ox = (r.width - w * scale) / 2, + oy = (r.height - h * scale) / 2; + camera.x = + $("#wire-board").clientWidth / 2 - + ((e.clientX - r.left - ox) / scale + b.x - 40) * camera.z; + camera.y = + $("#wire-board").clientHeight / 2 - + ((e.clientY - r.top - oy) / scale + b.y - 40) * camera.z; + wirePaint(); + }; +} +function wirePointer(e) { + if (e.button !== 0 || e.target.closest("#wire-minimap")) return; + if (e.target.closest("[data-cable]") && !physicalNodeAt(e)) return; + const node = e.target.closest("[data-node]") || physicalNodeAt(e); + const start = { + x: e.clientX, + y: e.clientY, + c: { ...camera }, + p: node ? { ...wirePositions[node.dataset.node] } : null, + }; + let moved = false; + wireDragging = true; + const board = e.currentTarget; + (node || board).setPointerCapture(e.pointerId); + const move = (ev) => { + const dx = ev.clientX - start.x, + dy = ev.clientY - start.y; + moved ||= Math.abs(dx) + Math.abs(dy) > 4; + if (node) { + wirePositions[node.dataset.node] = { + x: start.p.x + dx / camera.z, + y: start.p.y + dy / camera.z, + }; + } else { + camera.x = start.c.x + dx; + camera.y = start.c.y + dy; + } + wirePaint(); + }; + const up = () => { + wireDragging = false; + board.removeEventListener("pointermove", move); + board.removeEventListener("pointerup", up); + if (node) { + selected = node.dataset.node; + document + .querySelectorAll("[data-node]") + .forEach((n) => + n.classList.toggle("selected", n.dataset.node === selected), + ); + $("#selection").textContent = labelOf( + state.records.find((r) => r.id === selected), + ); + if (moved) wireSavePositions(); + else { + clearTimeout(clickTimer); + clickTimer = setTimeout(render, 260); + } + } + if (moved) wireRemember(); + }; + board.addEventListener("pointermove", move); + board.addEventListener("pointerup", up, { once: true }); + board.addEventListener("pointercancel", up, { once: true }); +} +function wireContext(r) { + const box = document.createElement("div"); + for (const [label, fn] of [ + ["Ver y editar datos", () => fullDetails(r)], + ["Centrar", () => wireCenterFromDetails(r)], + [ + "Ver conexiones", + () => { + wireFocus = r.id; + view = "map"; + render(); + wireFit(); + }, + ], + [ + "Contraer esta rama", + () => { + for (const id of wireNeighborhood(r.id, Number(wirePrefs.depth))) + if (id !== r.id) wireHidden.add(id); + render(); + }, + ], + [ + "Expandir ramas", + () => { + wireHidden.clear(); + wirePrefs.depth = Math.min(10, Number(wirePrefs.depth) + 1); + render(); + wireFit(); + }, + ], + ]) { + const b = document.createElement("button"); + b.type = "button"; + b.textContent = label; + b.onclick = async () => { + await dismiss(); + if (!$("#detail").open) fn(); + }; + box.append(b); + } + showForm("Acciones · " + labelOf(r), [box]); +} +async function wireCenterFromDetails(r) { + await dismiss(); + if ($("#detail").open) return; + view = "map"; + selected = r.id; + const filtered = + !records().some((x) => x.id === r.id) || + (r.data.connectionMode === "wifi" && !wirePrefs.showWifi); + if ( + filtered && + !(await appDecision( + "Los filtros ocultan este elemento. ¿Limpiarlos para mostrarlo?", + )) + ) + return; + if (filtered) { + wireClearFilters(); + wirePrefs.showWifi = true; + } + wireFocus = null; + wireHidden.clear(); + render(); + if (r.data.type === "wire") { + wireFocus = r.id; + render(); + wireFit(); + } else wireCenter(); + wireRemember(); +} +function wireTabs(sections) { + const container = document.createElement("div"), + nav = document.createElement("nav"); + nav.className = "wire-tabs"; + container.append(nav); + sections.forEach(([label, nodes], index) => { + const b = document.createElement("button"); + b.type = "button"; + b.textContent = label; + b.setAttribute("role", "tab"); + const panel = document.createElement("section"); + panel.className = "wire-tab-panel"; + panel.hidden = index !== 0; + panel.append(...nodes); + b.classList.toggle("active", index === 0); + b.onclick = () => { + container + .querySelectorAll(".wire-tab-panel") + .forEach((p) => (p.hidden = p !== panel)); + nav.querySelectorAll("button").forEach((x) => { + x.classList.toggle("active", x === b); + x.setAttribute("aria-selected", x === b); + }); + }; + nav.append(b); + container.append(panel); + }); + return container; +} +function wireAction(label, fn) { + const b = document.createElement("button"); + b.type = "button"; + b.textContent = label; + b.onclick = () => + Promise.resolve(fn()).catch( + (e) => ($("#detail-error").textContent = e.message), + ); + return b; +} +fullDetails = function (r) { + if (state.launcher !== "lanwire") return wireBase.fullDetails(r); + const d = r.data, + racks = state.records.filter( + (x) => x.data.type === "rack" && x.id !== r.id, + ); + const identity = document.createElement("p"); + identity.textContent = r.id + " · " + wireName(d.type); + const general = [ + identity, + field("Nombre", "name", d.name), + field("Alias", "alias", d.alias), + field("Descripción", "description", d.description, "textarea"), + field( + "Conexión", + "connectionMode", + d.connectionMode || "wired", + "text", + wireModes, + ), + ]; + const location = [ + field("Rack", "rack", d.location?.rack, "text", [ + ["", "Sin rack"], + ...racks.map((x) => [x.id, labelOf(x)]), + ]), + field("Unidad", "unit", d.location?.unit, "number"), + ]; + const ports = document.createElement("div"); + for (const [p, value] of Object.entries(d.ports || {})) { + const row = document.createElement("div"); + row.className = "wire-port-row"; + const text = document.createElement("span"); + text.textContent = + p + + " · " + + wireName(value.kind) + + " · " + + (value.connector || "") + + " · " + + (wireConnections(r).find((w) => + w.data.endpoints.some((e) => e.device === r.id && e.port === p), + )?.id || "Libre"); + row.append( + text, + field("Medio", "port_kind_" + p, value.kind || "wire.copper", "text", [ + ["wire.copper", "Cobre"], + ["wire.fiber", "Fibra"], + ["wire.dac", "DAC"], + ["connection.rj45", "RJ45"], + ["connection.fiber", "Fibra óptica"], + ["connection.dac", "DAC (conector)"], + ["connection.unknown", "Sin especificar"], + ]), + field("PoE", "port_poe_" + p, String(!!value.poe), "text", [ + ["false", "No"], + ["true", "Sí"], + ]), + wireAction("Editar puerto", () => + wireOpenAfterSave(() => wirePort(r, p)), + ), + wireAction("Conexiones", () => + wireOpenAfterSave(() => wirePortConnections(r, p)), + ), + ); + ports.append(row); + } + if (!ports.childNodes.length) + ports.textContent = "Este elemento no tiene puertos."; + const connections = document.createElement("div"); + for (const w of d.type === "wire" ? [r] : wireConnections(r)) { + const p = document.createElement("p"); + p.textContent = + labelOf(w) + + " · " + + (w.data.endpoints || []) + .map((e) => e.device + " · " + e.port) + .join(" ↔ "); + connections.append( + p, + wireAction("Editar conexión", () => + wireOpenAfterSave(() => wireConnect(w)), + ), + ); + } + if (!connections.childNodes.length) + connections.textContent = "Sin conexiones almacenadas."; + const technical = document.createElement("dl"); + const technicalFields = [ + field( + "Grupos (separados por comas)", + "groups", + (d.groups || []).join(", "), + ), + field("Dirección IP", "ip", d.ip), + field( + "Velocidades (separadas por comas)", + "speeds", + (d.speeds || []).join(", "), + ), + ]; + if (d.type === "wire") + technicalFields.push( + field("Medio del cable", "kind", d.kind || "wire.copper", "text", [ + ["wire.copper", "Cobre"], + ["wire.fiber", "Fibra"], + ["wire.dac", "DAC"], + ]), + ); + if (d.type === "rack") + technicalFields.push( + Object.assign(document.createElement("p"), { + textContent: `Altura: ${d.units ?? "Sin especificar"} U · Ancho de montaje: ${d.rackDimensions?.widthInches ? d.rackDimensions.widthInches + "″" : "Pendiente de especificar"}. Edita las dimensiones en LANRACK.`, + }), + wireAction("Abrir LANRACK", () => call("open_gui", "lanrack")), + ); + for (const [k, v] of Object.entries({ + ...d, + created_at: r.created_at, + updated_at: r.updated_at, + })) { + if ( + [ + "ports", + "endpoints", + "name", + "alias", + "description", + "location", + ].includes(k) + ) + continue; + const dt = document.createElement("dt"), + dd = document.createElement("dd"); + dt.textContent = wireTechnicalName(k); + dd.textContent = + typeof v === "object" ? JSON.stringify(v) : String(v ?? "—"); + technical.append(dt, dd); + } + const raw = document.createElement("textarea"); + raw.readOnly = true; + raw.rows = 15; + raw.value = JSON.stringify(r, null, 2); + raw.setAttribute("aria-label", "Registro JSON"); + const copy = wireAction("Copiar JSON", async () => { + try { + await navigator.clipboard.writeText(raw.value); + message("JSON copiado"); + } catch { + raw.focus(); + raw.select(); + if (!document.execCommand("copy")) + throw Error("Selecciona el texto y pulsa Ctrl+C."); + } + }); + const center = wireAction("Centrar en Topología", () => + wireCenterFromDetails(r), + ); + showForm( + "Detalle · " + labelOf(r), + [ + center, + wireTabs([ + ["General", general], + ["Ubicación", location], + ["Puertos", [ports]], + ["Conexiones", [connections]], + ["Datos técnicos", [...technicalFields, technical]], + ["JSON", [copy, raw]], + ]), + ], + (v) => + call("wire_update", r.id, r.revision, { + name: v.name, + alias: v.alias, + description: v.description, + connectionMode: v.connectionMode, + rack: v.rack, + unit: v.unit ? Number(v.unit) : null, + groups: v.groups + .split(",") + .map((x) => x.trim()) + .filter(Boolean), + ip: v.ip, + speeds: v.speeds + .split(",") + .map((x) => x.trim()) + .filter(Boolean), + ...(v.kind ? { kind: v.kind } : {}), + ...(v.units ? { units: Number(v.units) } : {}), + portChanges: Object.fromEntries( + Object.keys(d.ports || {}).map((p) => [ + p, + { kind: v["port_kind_" + p], poe: v["port_poe_" + p] === "true" }, + ]), + ), + }), + ); +}; +wireEdit = function (r) { + if (state.launcher === "lanwire") return fullDetails(r); + return wireBase.wireEdit(r); +}; +async function wireOpenAfterSave(fn) { + if (formOriginal !== JSON.stringify([...new FormData($("#detail-form"))])) { + message( + "Guarda o cancela los cambios antes de editar puertos o conexiones.", + ); + $("#detail-error").textContent = "Guarda primero los cambios del elemento."; + return; + } + await dismiss(); + if (!$("#detail").open) fn(); +} +wirePort = function (r, p) { + const ports = Object.keys(r.data.ports || {}); + p = p || ports[0]; + const fields = [ + field( + "Puerto", + "port", + p, + "text", + ports.map((x) => [x, x]), + ), + field("Nombre nuevo", "name", p), + field("Posición", "position", ports.indexOf(p) + 1, "number"), + ]; + fields[0].querySelector("select").onchange = (e) => { + fields[1].querySelector("input").value = e.target.value; + fields[2].querySelector("input").value = ports.indexOf(e.target.value) + 1; + }; + showForm("Renombrar o reordenar puerto", fields, (v) => + call("wire_port", r.id, r.revision, v.port, v.name, Number(v.position)), + ); +}; +function wirePortConnections(r, p) { + const existing = wireConnections(r).find((w) => + w.data.endpoints.some((e) => e.device === r.id && e.port === p), + ); + if (existing) { + wireConnect(existing); + return; + } + const cables = state.records.filter( + (w) => w.data.type === "wire" && (w.data.endpoints || []).length < 2, + ); + showForm( + "Conectar puerto · " + r.id + " · " + p, + [ + field( + "Cable disponible", + "wire", + cables[0]?.id || "", + "text", + cables.map((w) => [w.id, labelOf(w)]), + ), + ], + async (v) => { + const w = state.records.find((x) => x.id === v.wire); + if (!w) throw Error("Crea primero un cable con un extremo libre."); + await call("wire_connect", w.id, w.revision, [ + ...(w.data.endpoints || []), + { device: r.id, port: p }, + ]); + }, + ); +} +async function wireProjects() { + const payload = await call("projects"); + showForm( + "Cambiar proyecto", + [ + field( + "Proyecto", + "project", + state.project, + "text", + payload.projects.map((p) => [p.path, p.name]), + ), + wireAction("Abrir archivo VLF…", async () => { + const result = await call("select_project_file"); + if (result.path) + $("#detail-fields select").add( + new Option(result.path, result.path, true, true), + ); + }), + Object.assign(document.createElement("p"), { + textContent: + "El proyecto define el contexto de la suite. Los elementos físicos de LANWIRE pertenecen al almacén compartido indicado en la barra inferior.", + }), + ], + async (v) => { + if (!v.project) throw Error("Selecciona un proyecto."); + if ((await call("project_state")).dirty) { + if ( + !(await appDecision( + "Hay cambios pendientes. ¿Guardarlos antes de cambiar de proyecto?", + )) + ) + throw Error("Cambio cancelado; se conserva el proyecto actual."); + await call("save_project"); + } + await call("use_project", v.project); + wireFocus = null; + wirePositions = {}; + selected = null; + }, + ); +} +function wireTechnicalName(path) { + const names = { + type: "Tipo", + subtype: "Variante", + kind: "Medio", + groups: "Grupos", + ip: "Dirección IP", + speeds: "Velocidades", + units: "Altura en unidades", + connectionMode: "Tipo de conexión", + created_at: "Fecha de creación", + updated_at: "Última modificación", + portCount: "Número de puertos", + portNaming: "Nombres de puertos", + portTemplate: "Plantilla de puertos", + lanipDevice: "Equipo vinculado en LANIP", + schemaVersion: "Versión de formato", + active: "Activo", + directory: "Carpeta", + database: "Base de datos", + devices: "Equipos", + groups: "Grupos", + physical: "Inventario físico", + saveMode: "Modo de guardado", + saveIntervalMinutes: "Intervalo de guardado (minutos)", + networkDatabase: "Inventario de red", + networkGroups: "Grupos de red", + databaseLog: "Registro de base de datos", + credentials: "Almacén de credenciales", + iconsDirectory: "Carpeta de iconos", + workspace: "Espacio de trabajo", + project: "Proyecto", + projectId: "Identificador del proyecto", + contentHash: "Huella de contenido", + metadata: "Metadatos", + monitor: "Monitor", + monitoring: "Monitorización", + runtime: "Ejecución", + incidents: "Incidencias", + lock: "Bloqueo", + profiles: "Perfiles", + assignments: "Asignaciones", + databases: "Bases de datos", + storage: "Almacenamiento", + projects: "Proyecto", + }; + return path + .split(".") + .map( + (k) => + names[k] || k.replace(/([a-z])([A-Z])/g, "$1 $2").replaceAll("_", " "), + ) + .join(" › "); +} +settings = async function () { + if (state.launcher !== "lanwire") return wireBase.settings(); + const payload = await call("settings"); + const general = [ + field("Vista inicial", "pref_view", wirePrefs.view, "text", [ + ["map", "Topología"], + ["list", "Lista"], + ]), + ], + list = [ + field("Ordenar por", "pref_sort", wireSort.key, "text", [ + ["name", "Nombre"], + ["id", "Identificador"], + ["type", "Tipo"], + ]), + ], + topology = [ + field( + "Mostrar nombres y etiquetas", + "pref_labels", + String(wirePrefs.labels), + "text", + [ + ["true", "Sí"], + ["false", "No"], + ], + ), + field( + "Mostrar enlaces Wi-Fi", + "pref_showWifi", + String(!!wirePrefs.showWifi), + "text", + [ + ["false", "No"], + ["true", "Sí"], + ], + ), + field( + "Mostrar minimapa", + "pref_minimap", + String(wirePrefs.minimap), + "text", + [ + ["true", "Sí"], + ["false", "No"], + ], + ), + field("Niveles de conexiones", "pref_depth", wirePrefs.depth, "number"), + ]; + const connectionsSettings = [ + field( + "Conexión predeterminada de elementos nuevos", + "pref_connectionMode", + wirePrefs.connectionMode || "wired", + "text", + wireModes, + ), + field( + "Mostrar puertos en el lienzo", + "pref_showPorts", + String(wirePrefs.showPorts !== false), + "text", + [ + ["true", "Sí"], + ["false", "No"], + ], + ), + ]; + const sections = [ + ["General", general], + ["Puertos y conexiones", connectionsSettings], + ["Lista y búsqueda", list], + ["Topología", topology], + ], + entries = new Map(); + for (const category of ["storage", "projects", "logging"]) { + const nodes = []; + for (const e of payload.entries.filter((e) => e.category === category)) { + const object = e.value === null || typeof e.value === "object", + boolean = typeof e.value === "boolean"; + const f = field( + wireTechnicalName(e.path), + "setting_" + e.path, + object ? JSON.stringify(e.value, null, 2) : String(e.value), + object ? "textarea" : typeof e.value === "number" ? "number" : "text", + boolean + ? [ + ["true", "Activado"], + ["false", "Desactivado"], + ] + : null, + ); + const input = f.querySelector("input,select,textarea"); + input.disabled = !!e.readOnly; + const note = document.createElement("small"); + note.textContent = + e.readOnly || + "Ajuste compartido de la suite. Las rutas se aplican al volver a abrir la interfaz."; + f.append(note); + if (!e.readOnly && /directory$/i.test(e.path)) { + f.append( + wireAction("Elegir carpeta…", async () => { + const selected = await call("select_project_directory"); + if (selected.path) input.value = selected.path; + }), + ); + } + nodes.push(f); + entries.set("setting_" + e.path, e); + } + sections.push([ + category === "storage" + ? "Almacenamiento" + : category === "projects" + ? "Proyecto" + : "Avanzado", + nodes, + ]); + } + const search = field("Buscar configuración", "settings_search"); + const tabs = wireTabs(sections); + search.querySelector("input").oninput = (e) => { + const q = e.target.value.toLocaleLowerCase(); + tabs.querySelectorAll(".wire-tab-panel").forEach((p) => { + p.hidden = !!q ? false : p !== tabs.querySelector(".wire-tab-panel"); + p.querySelectorAll("label").forEach( + (l) => + (l.hidden = !!q && !l.textContent.toLocaleLowerCase().includes(q)), + ); + }); + }; + const reset = wireAction("Restaurar preferencias visuales", () => { + for (const [name, val] of Object.entries({ + pref_view: "map", + pref_sort: "name", + pref_labels: "true", + pref_showWifi: "false", + pref_minimap: "false", + pref_depth: 1, + pref_connectionMode: "wired", + pref_showPorts: "true", + })) + tabs.querySelector(`[name="${name}"]`).value = val; + }); + showForm( + "Configuración de LANWIRE", + [search, reset, tabs], + async (values) => { + const depth = Number(values.pref_depth); + if (!Number.isInteger(depth) || depth < 1 || depth > 10) + throw Error("Los niveles deben estar entre 1 y 10."); + for (const [key, e] of entries) { + if (e.readOnly || !(key in values)) continue; + const raw = values[key], + value = + typeof e.value === "boolean" + ? raw === "true" + : typeof e.value === "number" + ? Number(raw) + : e.value === null || typeof e.value === "object" + ? JSON.parse(raw) + : raw; + if (JSON.stringify(value) !== JSON.stringify(e.value)) + await call("save_setting", e.path, value); + } + wirePrefs = { + ...wirePrefs, + view: values.pref_view, + depth, + labels: values.pref_labels === "true", + showWifi: values.pref_showWifi === "true", + minimap: values.pref_minimap === "true", + connectionMode: values.pref_connectionMode, + showPorts: values.pref_showPorts === "true", + }; + wireSort.key = values.pref_sort; + view = wirePrefs.view; + wireStore(); + }, + ); +}; +document.addEventListener("click", (e) => { + const b = e.target.closest("[data-nav]"); + if (b) wireNavigate(b.dataset.nav); +}); +let wireLastSize = ""; +new ResizeObserver(() => { + if (state.launcher === "lanwire" && view === "map" && $("#wire-board")) { + const size = + $("#wire-board").clientWidth + ":" + $("#wire-board").clientHeight; + if (size !== wireLastSize) { + wireLastSize = size; + wireFit(); + } else wirePaint(); + } +}).observe($("#canvas")); +wireNew = function () { + const choices = [ + ["switch.5ports", "Switch · 5 puertos", "SW"], + ["switch.12ports", "Switch · 12 puertos", "SW"], + ["switch.24ports", "Switch · 24 puertos", "SW"], + ["switch.48ports", "Switch · 48 puertos", "SW"], + ["router.gateway", "Router", "RT"], + ["pc.1port", "Ordenador · 1 puerto", "PC"], + ["pc.2ports", "Ordenador · 2 puertos", "PC"], + ["server.2ports", "Servidor · 2 puertos", "SR"], + ["panel", "Panel de conexiones · 24 puertos", "PN"], + ["outlet", "Toma de red · pared y habitación", "PX"], + ["wire.copper", "Cable de cobre", "WL"], + ["wire.fiber", "Cable de fibra", "FB"], + ["wire.dac", "Cable DAC", "WL"], + ["rack", "Rack", "RK"], + ]; + const fields = [ + field( + "Tipo", + "kind", + "switch.24ports", + "text", + choices.map(([v, l]) => [v, l]), + ), + field("Prefijo del identificador", "prefix", "SW"), + field("Nombre", "name"), + field("Alias", "alias"), + field("Descripción", "description", "", "textarea"), + field( + "Tipo de conexión", + "connectionMode", + wirePrefs.connectionMode || "wired", + "text", + wireModes, + ), + field("Altura del rack (unidades)", "units", 42, "number"), + field("Ancho de montaje (pulgadas)", "widthInches", 19, "text", [ + [10, "10″"], + [19, "19″"], + [21, "21″"], + [23, "23″"], + ]), + ]; + const height = fields.at(-2).querySelector("input"); + height.min = 4; + height.max = 52; + height.step = 1; + const change = () => { + const kind = fields[0].querySelector("select").value; + fields[1].querySelector("input").value = choices.find( + (x) => x[0] === kind, + )[2]; + fields.at(-1).hidden = fields.at(-2).hidden = kind !== "rack"; + height.required = kind === "rack"; + }; + fields[0].querySelector("select").onchange = change; + change(); + showForm("Nuevo elemento físico", fields, async (values) => { + const { units, widthInches, ...data } = values; + const result = await call("wire_create", { + ...data, + ...(values.kind === "rack" + ? { units: Number(units), widthInches: Number(widthInches) } + : {}), + }); + selected = result.id; + }); +}; +function wireResizeColumns() { + document.querySelectorAll("#canvas th").forEach((th) => { + const key = th.textContent; + const saved = wirePrefs.widths?.[key]; + if (saved) th.style.width = saved + "px"; + const grip = document.createElement("span"); + grip.className = "wire-column-grip"; + grip.title = "Arrastrar para cambiar la anchura"; + th.append(grip); + grip.onpointerdown = (e) => { + e.preventDefault(); + e.stopPropagation(); + const start = e.clientX, + width = th.getBoundingClientRect().width; + grip.setPointerCapture(e.pointerId); + grip.onpointermove = (ev) => { + th.style.width = Math.max(90, width + ev.clientX - start) + "px"; + }; + grip.onpointerup = () => { + wirePrefs.widths = { + ...wirePrefs.widths, + [key]: th.getBoundingClientRect().width, + }; + wireStore(); + grip.onpointermove = null; + }; + }; + }); +} diff --git a/info.html b/info.html index b0752de..de09d45 100644 --- a/info.html +++ b/info.html @@ -654,7 +654,7 @@
-

Especificaciones avanzadas · 0.3.3

+

Especificaciones avanzadas · 0.3.4-alpha.1

Una consola para entender y gobernar la red local.

LANCTL unifica descubrimiento, inventario, diagnóstico, automatización @@ -717,7 +717,7 @@

Una consola para entender y gobernar la red local.

Versión descrita
-
0.3.3
+
0.3.4-alpha.1
Formato de proyecto
diff --git a/packaging/clink/README.md b/packaging/clink/README.md index 23e4e66..a8c75f3 100644 --- a/packaging/clink/README.md +++ b/packaging/clink/README.md @@ -1,6 +1,6 @@ # Integración de LANCTL con Clink -`lanctl.lua`, compatible con LANCTL 0.3.3, registra completado contextual +`lanctl.lua`, compatible con LANCTL 0.3.4-alpha.1, registra completado contextual para `lanctl`, `lanip`, el alias histórico `als` y los ejecutables especializados `lanwire`, `lanrack`, `lanaccess` y `lanmon`, incluidas sus variantes `.exe`. El orquestador completa además cada launcher y su alias corto. @@ -31,7 +31,25 @@ clink installscripts "C:\ruta\a\LANCTL\packaging\clink" Comprueba las rutas activas con `clink info`. Para recargar scripts en una sesión abierta usa `Ctrl-X`, `Ctrl-R`, o abre una consola nueva. -El instalador de LANCTL deberá copiar `lanctl.lua` a -`C:\Program Files\LANCTL\clink\` y ejecutar `clink installscripts` solamente -si detecta Clink. Al desinstalar deberá usar `clink uninstallscripts` con la -misma ruta. +El instalador copia `lanctl.lua` y estas instrucciones a +`C:\Program Files\LANCTL\clink\`. Ejecuta `lanctl completions install` con +el usuario original; el adaptador detecta Clink y usa `clink installscripts` +con argumentos separados, sin shell. Repetir la instalación no añade otra ruta. +Una instalación iniciada ya elevada omite el registro para evitar asociarlo +a la cuenta administrativa: ejecuta el comando desde tu sesión normal. + +El desinstalador usa `lanctl completions uninstall`: únicamente retira la +carpeta registrada por esta instalación y usuario. Si otro administrador +desinstala la aplicación, o Clink solo existe en una ubicación privada no +disponible al desinstalador elevado, el propietario debe ejecutar antes +`lanctl completions uninstall` o `clink uninstallscripts RUTA`. No se recorren +ni alteran perfiles de otros usuarios. El completado de los seis launchers y +del contexto `lanctl ip history` se comprobó en CMD con Clink 1.9.34. También +se verificaron registro repetido, retirada y registro original conservado para +el usuario normal. Clink devuelve 1 si la ruta ya está en el estado solicitado; +LANCTL consulta `installscripts --list` para comprobarlo antes de dar éxito. +La desinstalación elevada desde otra cuenta sigue pendiente de certificación. + +El ZIP portable incluye `clink/` y `prepare.ps1`. Ejecuta `prepare.ps1` para +registrar o `prepare.ps1 -RemoveClink` antes de mover/borrar el portable. +Los demás launchers y Linux conservan su comportamiento previo. diff --git a/packaging/clink/lanctl.lua b/packaging/clink/lanctl.lua index 57de489..e41b0f3 100644 --- a/packaging/clink/lanctl.lua +++ b/packaging/clink/lanctl.lua @@ -1,5 +1,5 @@ -- Autocompletado de LANCTL para Clink 1.3.23 o posterior. --- Compatible con LANCTL 0.3.3. +-- Compatible con LANCTL 0.3.4-alpha.1. -- Desarrollo: clink installscripts \packaging\clink -- Instalación: \clink\lanctl.lua @@ -39,6 +39,7 @@ local list = clink.argmatcher() :addflags({ "-h", "--help", "/?", "--network" .. history_value("Red CIDR"), + "--interface" .. history_value("IPv4 local o ID de interfaz"), "--database" .. file_arg, "--groups" .. file_arg, "-f" .. formats, "--format" .. formats, @@ -103,6 +104,12 @@ local open = clink.argmatcher() local settings = clink.argmatcher() :addflags({ + "--startup-interface" .. values({ "cli", "tui", "gui" }), + "--close-gui-on-launch" .. on_off, + "--menu", "--catalog", "--get" .. history_value("Ruta de ajuste"), + "--set" .. history_value("Ruta y valor"), + "--scope" .. values({ "program", "project" }), + "--category" .. history_value("Categoría"), "-h", "--help", "/?", "-range" .. history_value("Red CIDR"), "-list-fields" .. history_value("Columnas"), "--list-fields" .. history_value("Columnas"), @@ -493,16 +500,17 @@ local function configure_lanwire(matcher) "graph", "map", "prefix" .. wire_prefix }):addflags({ "-h", "--help", "/?", "--version", "--database" .. file_arg, - "-tui", "--tui", "--cli", "-cli" + "-tui", "--tui", "--gui", "--cli", "-cli" }):nofiles() end local function configure_lanrack(matcher) return matcher:addarg({ - "list", "ls", "show" .. history_value("ID o nombre del rack") + "list", "ls", "show" .. history_value("ID o nombre del rack"), + "dimensions" .. clink.argmatcher():addarg({fromhistory=true, hint="ID del rack"}):addflags({"-h", "--help", "/?", "--units" .. integer_range(4,52), "--width-inches" .. values({"10","19","21","23"})}):nofiles() }):addflags({ "-h", "--help", "/?", "--version", "--database" .. file_arg, - "-tui", "--tui", "--cli", "-cli" + "-tui", "--tui", "--gui", "--cli", "-cli" }):nofiles() end @@ -527,7 +535,7 @@ local function configure_lanaccess(matcher) "-user" .. history_value("Usuario") }):nofiles(), "delete" .. history_value("ID de credencial"), "del" .. history_value("ID de credencial"), - "credential" .. access_credential, "doctor", + "credential" .. access_credential, "doctor", "remote-setup", "settings" .. clink.argmatcher():addarg({ "show", "use-store" }):addarg(clink.filematches):addflags({ "-h", "--help", "/?", "--yes" }):nofiles(), "protocol" .. clink.argmatcher():addarg({ "list", "configure" }):addarg(selector):addarg(protocols):addflags({ "-h", "--help", "/?", "--port" .. history_value("Puerto"), @@ -540,7 +548,7 @@ local function configure_lanaccess(matcher) "-h", "--help", "/?", "--version", "--database" .. file_arg, "--store" .. file_arg, "--cipher" .. values({ "auto", "dpapi", "portable" }), "--scope" .. values({ "program", "windows", "project" }), - "--project-dir" .. dir_arg, "-tui", "--tui", "--cli", "-cli" + "--project-dir" .. dir_arg, "-tui", "--tui", "--gui", "--cli", "-cli" }):nofiles() end @@ -555,7 +563,7 @@ local function configure_lanmon(matcher) "incidents", "incident", "service", "foreground", "configure", "profile", "assign", "unassign", "assignments", "report", "ping", "scan", "identify", "health" }):addflags({ - "-h", "--help", "/?", "--version", "--cli", "-cli", "--tui", "-tui", + "-h", "--help", "/?", "--version", "--cli", "-cli", "--gui", "--tui", "-tui", "--source" .. values({ "all", "program", "project" }), "--limit" .. history_value("1-1000"), "--level" .. error_log_levels, "--project" .. file_arg, "--permanent", "--duration" .. history_value("Duración"), @@ -603,7 +611,7 @@ local function configure_lanip(matcher) return matcher :addarg(root_commands) :addflags({ - "-h", "--help", "/?", "--version", "--quiet", "--verbose", "--gui", "--cli", "-cli", "-tui", "--tui", + "-h", "--help", "/?", "--version", "--quiet", "--verbose", "--gui", "--first-scan", "--cli", "-cli", "-tui", "--tui", "-project" .. file_arg, "--project" .. file_arg }) :nofiles() @@ -629,6 +637,9 @@ for _, command in ipairs(root_commands) do table.insert(suite_commands, command) end local suite_launchers = { + "post-install" .. clink.argmatcher():addflags({"-h","--help","/?","--first-scan"}):nofiles(), + "setup-defaults" .. clink.argmatcher():addflags({"-h","--help","/?","--theme" .. values({"graphite","midnight","forest","violet","light"}),"--plugins" .. history_value("all, none o IDs separados por comas")}):nofiles(), + "completions" .. values({"install","uninstall"}), "backend" .. backend, "lanip" .. configure_lanip(clink.argmatcher()), "ip" .. configure_lanip(clink.argmatcher()), @@ -643,7 +654,8 @@ end clink.argmatcher("lanctl", "lanctl.exe", "LANCTL.exe") :addarg(suite_commands) - :addflags({ - "-h", "--help", "/?", "--version", "--cli", "-cli", "-tui", "--tui", "--admin" + :addflags({ "--gui", + "-h", "--help", "/?", "--version", "--cli", "-cli", "-tui", "--tui", "--admin", + "-web", "--web", "-github", "--github", "-reference", "--reference" }) :nofiles() diff --git a/packaging/inno/LANCTL.iss b/packaging/inno/LANCTL.iss index 9bbbe35..d0209b5 100644 --- a/packaging/inno/LANCTL.iss +++ b/packaging/inno/LANCTL.iss @@ -1,6 +1,6 @@ -#define MyAppName "LANCTL" +#define MyAppName "LANCTL GUI experimental (NO ESTABLE)" #ifndef MyAppVersion - #define MyAppVersion "0.3.3" + #define MyAppVersion "0.3.4-alpha.1" #endif #ifndef BuildRoot #define BuildRoot "..\..\dist" @@ -18,11 +18,12 @@ OutputDir=..\..\dist\release OutputBaseFilename=LANCTL-{#MyAppVersion}-windows-x64-setup Compression=lzma2/max SolidCompression=yes -SetupIconFile=..\..\assets\lanctl-v3.ico +SetupIconFile=..\..\assets\launcher-icons\lanctl.ico PrivilegesRequired=admin UninstallDisplayIcon={app}\LANCTL.exe ChangesEnvironment=yes SetupLogging=yes +WizardSizePercent=130,140 [Types] Name: standard; Description: "Standard" @@ -33,6 +34,13 @@ Name: custom; Description: "Custom"; Flags: iscustom Name: core; Description: "LANCTL application"; Types: standard monitor custom; Flags: fixed Name: path; Description: "Add LANCTL to system PATH"; Types: standard monitor custom Name: monitor; Description: "Monitor service"; Types: monitor custom +Name: plugins; Description: "Plugins opcionales (todos, ninguno o selección individual)"; Types: standard monitor custom +Name: plugins\example; Description: "Ejemplo: resumen de inventario"; Types: standard monitor custom +Name: plugins\vendor; Description: "Fabricantes MAC (requiere firma autorizada para activar)"; Types: standard monitor custom +Name: plugins\mdns; Description: "Descubrimiento mDNS/SSDP (requiere firma autorizada para activar)"; Types: standard monitor custom +Name: plugins\smb; Description: "Descubrimiento Windows/SMB (requiere firma autorizada para activar)"; Types: standard monitor custom +Name: plugins\wol; Description: "Wake-on-LAN (requiere firma autorizada para activar)"; Types: standard monitor custom +Name: plugins\lab; Description: "Emulador de red"; Types: standard monitor custom [Dirs] ; La raíz también hereda permisos de modificación para que cualquier estado @@ -49,6 +57,8 @@ Name: "{commonappdata}\LANCTL\projects"; Permissions: users-modify Name: "{commonappdata}\LANCTL\automation"; Permissions: users-modify [Files] +Source: "theme-previews\*.bmp"; Flags: dontcopy +Source: "..\..\assets\launcher-icons\terminal.ico"; DestDir: "{app}\assets\launcher-icons"; Flags: ignoreversion; Components: core Source: "{#BuildRoot}\LANCTL.exe"; DestDir: "{app}"; Flags: ignoreversion; Components: core Source: "{#BuildRoot}\lanip.exe"; DestDir: "{app}"; Flags: ignoreversion; Components: core Source: "{#BuildRoot}\lanwire.exe"; DestDir: "{app}"; Flags: ignoreversion; Components: core @@ -57,6 +67,8 @@ Source: "{#BuildRoot}\lanrack.exe"; DestDir: "{app}"; Flags: ignoreversion; Comp Source: "{#BuildRoot}\lanaccess.exe"; DestDir: "{app}"; Flags: ignoreversion; Components: core Source: "..\..\docs\INSTALL.md"; DestDir: "{app}"; Flags: ignoreversion; Components: core Source: "..\..\docs\ACCESS.md"; DestDir: "{app}"; Flags: ignoreversion; Components: core +Source: "..\..\packaging\clink\lanctl.lua"; DestDir: "{app}\clink"; Flags: ignoreversion; Components: core +Source: "..\..\packaging\clink\README.md"; DestDir: "{app}\clink"; Flags: ignoreversion; Components: core [InstallDelete] ; Limpia launchers heredados que pudieron quedar al actualizar instalaciones @@ -65,23 +77,30 @@ Type: files; Name: "{app}\LANCTL-GUI.exe" Type: files; Name: "{app}\landemo.exe" [Icons] -Name: "{group}\LANCTL TUI"; Filename: "{app}\LANCTL.exe"; Parameters: "--tui"; WorkingDir: "{app}" -Name: "{group}\LANCTL CLI"; Filename: "{app}\LANCTL.exe"; Parameters: "--cli"; WorkingDir: "{app}" -Name: "{group}\LANIP"; Filename: "{app}\lanip.exe"; Parameters: "--tui"; WorkingDir: "{app}" +Name: "{group}\LANCTL GUI"; Filename: "{app}\LANCTL.exe"; Parameters: "--gui"; WorkingDir: "{app}" +Name: "{group}\LANWIRE GUI"; Filename: "{app}\lanwire.exe"; Parameters: "--gui"; WorkingDir: "{app}" +Name: "{group}\LANRACK GUI"; Filename: "{app}\lanrack.exe"; Parameters: "--gui"; WorkingDir: "{app}" +Name: "{group}\LANACCESS GUI"; Filename: "{app}\lanaccess.exe"; Parameters: "--gui"; WorkingDir: "{app}" +Name: "{group}\LANMON GUI"; Filename: "{app}\lanmon.exe"; Parameters: "--gui"; WorkingDir: "{app}" +Name: "{group}\LANCTL TUI"; Filename: "{app}\LANCTL.exe"; Parameters: "--tui"; WorkingDir: "{app}"; IconFilename: "{app}\assets\launcher-icons\terminal.ico" +Name: "{group}\LANCTL CLI"; Filename: "{app}\LANCTL.exe"; Parameters: "--cli"; WorkingDir: "{app}"; IconFilename: "{app}\assets\launcher-icons\terminal.ico" +Name: "{group}\LANIP"; Filename: "{app}\lanip.exe"; Parameters: "--tui"; WorkingDir: "{app}"; IconFilename: "{app}\assets\launcher-icons\terminal.ico" Name: "{group}\LANIP GUI"; Filename: "{app}\lanip.exe"; Parameters: "--gui"; WorkingDir: "{app}"; Tasks: ipgui -Name: "{group}\LANWIRE Physical"; Filename: "{app}\lanwire.exe"; WorkingDir: "{app}" -Name: "{group}\LANMON Monitor"; Filename: "{app}\lanmon.exe"; WorkingDir: "{app}" -Name: "{group}\LANMON Events"; Filename: "{app}\lanmon.exe"; Parameters: "--tui"; WorkingDir: "{app}"; Tasks: eventviewer -Name: "{group}\LANACCESS Administrator (UAC)"; Filename: "{app}\LANCTL.exe"; Parameters: "--admin lanaccess --tui"; WorkingDir: "{app}"; Tasks: accessadmin -Name: "{group}\LANRACK Viewer"; Filename: "{app}\lanrack.exe"; WorkingDir: "{app}" -Name: "{group}\LANACCESS Credentials"; Filename: "{app}\lanaccess.exe"; WorkingDir: "{app}" -Name: "{autodesktop}\LANCTL TUI"; Filename: "{app}\LANCTL.exe"; Parameters: "--tui"; WorkingDir: "{app}"; Tasks: desktopicon +Name: "{group}\LANWIRE Physical"; Filename: "{app}\lanwire.exe"; WorkingDir: "{app}"; IconFilename: "{app}\assets\launcher-icons\terminal.ico" +Name: "{group}\LANMON Monitor"; Filename: "{app}\lanmon.exe"; WorkingDir: "{app}"; IconFilename: "{app}\assets\launcher-icons\terminal.ico" +Name: "{group}\LANMON Events"; Filename: "{app}\lanmon.exe"; Parameters: "--tui"; WorkingDir: "{app}"; Tasks: eventviewer; IconFilename: "{app}\assets\launcher-icons\terminal.ico" +Name: "{group}\LANACCESS Administrator (UAC)"; Filename: "{app}\LANCTL.exe"; Parameters: "--admin lanaccess --tui"; WorkingDir: "{app}"; Tasks: accessadmin; IconFilename: "{app}\assets\launcher-icons\terminal.ico" +Name: "{group}\LANRACK Viewer"; Filename: "{app}\lanrack.exe"; WorkingDir: "{app}"; IconFilename: "{app}\assets\launcher-icons\terminal.ico" +Name: "{group}\LANACCESS Credentials"; Filename: "{app}\lanaccess.exe"; WorkingDir: "{app}"; IconFilename: "{app}\assets\launcher-icons\terminal.ico" +Name: "{autodesktop}\LANCTL TUI"; Filename: "{app}\LANCTL.exe"; Parameters: "--tui"; WorkingDir: "{app}"; Tasks: desktopicon; IconFilename: "{app}\assets\launcher-icons\terminal.ico" [Tasks] Name: ipgui; Description: "Crear acceso directo a la interfaz gráfica de LANIP (requiere WebView2)"; Flags: unchecked Name: desktopicon; Description: "Crear acceso directo de LANCTL TUI en el escritorio"; Flags: unchecked Name: eventviewer; Description: "Crear acceso directo al visor de eventos LANMON"; Flags: unchecked Name: accessadmin; Description: "Crear acceso LANACCESS administrativo (solicita UAC al abrir; no eleva el resto de programas)"; Flags: unchecked +Name: remoteaccount; Description: "Crear la primera cuenta de acceso remoto del servicio LANACCESS (no activa SSH ni HTTPS)"; Flags: checkedonce +Name: firstscan; Description: "Al abrir LANIP al finalizar, preparar el primer escaneo con confirmación del rango (rutas del sistema)"; Flags: unchecked [Registry] Root: HKLM; Subkey: "SYSTEM\CurrentControlSet\Control\Session Manager\Environment"; ValueType: expandsz; ValueName: "Path"; ValueData: "{olddata};{app}"; Check: NeedsAddPath('{app}'); Components: path @@ -90,13 +109,90 @@ Root: HKLM; Subkey: "SYSTEM\CurrentControlSet\Control\Session Manager\Environmen ; Corta la herencia users-modify de la raíz para credenciales y código de plugins. Filename: "{sys}\icacls.exe"; Parameters: """{commonappdata}\LANCTL\access"" /inheritance:r /grant:r ""*S-1-5-18:(OI)(CI)F"" ""*S-1-5-32-544:(OI)(CI)F"""; Flags: runhidden waituntilterminated Filename: "{sys}\icacls.exe"; Parameters: """{commonappdata}\LANCTL\plugins"" /inheritance:r /grant:r ""*S-1-5-18:(OI)(CI)F"" ""*S-1-5-32-544:(OI)(CI)F"""; Flags: runhidden waituntilterminated +Filename: "{app}\lanaccess.exe"; Parameters: "remote-setup"; Tasks: remoteaccount; Flags: runhidden waituntilterminated skipifsilent; StatusMsg: "Preparando la cuenta inicial de acceso remoto del servicio LANACCESS..." +Filename: "{app}\LANCTL.exe"; Parameters: "setup-defaults --theme {code:GetInitialTheme} --plugins {code:GetPluginSelection}"; Flags: runhidden waituntilterminated; StatusMsg: "Preparando preferencias y plugins sin activarlos; conservando elecciones existentes..." +Filename: "{app}\LANCTL.exe"; Parameters: "completions install"; Flags: runhidden waituntilterminated runasoriginaluser; StatusMsg: "Registrando el completado Clink del usuario, si está disponible..." Filename: "{app}\LANCTL.exe"; Parameters: "monitor service install --yes"; Components: monitor; Flags: runhidden waituntilterminated; StatusMsg: "Instalando el servicio permanente LANCTL Monitor..." -Filename: "{app}\lanaccess.exe"; Parameters: "--tui"; Description: "Abrir LANACCESS para configurar credenciales del usuario (sin guardarlas en el instalador)"; Flags: postinstall unchecked skipifsilent runasoriginaluser +Filename: "{app}\lanaccess.exe"; Parameters: "--tui"; Description: "Abrir LANACCESS para gestionar credenciales de dispositivos del inventario"; Flags: postinstall unchecked skipifsilent runasoriginaluser +Filename: "{app}\LANCTL.exe"; Parameters: "{code:GetLanipArguments}"; Description: "Abrir LANIP (y preparar la confirmación del primer escaneo si se seleccionó)"; Flags: postinstall unchecked skipifsilent runasoriginaluser runhidden [UninstallRun] +Filename: "{app}\LANCTL.exe"; Parameters: "completions uninstall"; Flags: runhidden waituntilterminated; RunOnceId: "LANCTLClinkCurrentUser" Filename: "{app}\LANCTL.exe"; Parameters: "monitor service uninstall --yes"; Flags: runhidden waituntilterminated; RunOnceId: "LANCTLMonitorService" [Code] +var + ThemePage: TInputOptionWizardPage; + ThemePreview: TBitmapImage; + +function GetInitialTheme(Param: String): String; +begin + case ThemePage.SelectedValueIndex of + 1: Result := 'midnight'; + 2: Result := 'forest'; + 3: Result := 'violet'; + 4: Result := 'light'; + else Result := 'graphite'; + end; +end; + +procedure UpdateThemePreview(Sender: TObject); +begin + ThemePreview.Bitmap.LoadFromFile(ExpandConstant('{tmp}\') + GetInitialTheme('') + '.bmp'); +end; + +procedure InitializeWizard; +begin + ThemePage := CreateInputOptionPage(wpSelectComponents, 'Apariencia inicial', + 'Elige un tema para el primer inicio', + 'Las actualizaciones conservan el tema y los plugins elegidos previamente. El tema base siempre se incluye.', True, False); + ThemePage.Add('Grafito'); + ThemePage.Add('Azul noche'); + ThemePage.Add('Bosque'); + ThemePage.Add('Violeta'); + ThemePage.Add('Claro'); + ThemePage.SelectedValueIndex := 0; + ThemePage.CheckListBox.SetBounds(0, ScaleY(50), ScaleX(110), ScaleY(170)); + ThemePage.CheckListBox.OnClickCheck := @UpdateThemePreview; + ExtractTemporaryFile('graphite.bmp'); + ExtractTemporaryFile('midnight.bmp'); + ExtractTemporaryFile('forest.bmp'); + ExtractTemporaryFile('violet.bmp'); + ExtractTemporaryFile('light.bmp'); + ThemePreview := TBitmapImage.Create(WizardForm); + ThemePreview.Parent := ThemePage.Surface; + ThemePreview.SetBounds(ScaleX(120), ScaleY(50), ThemePage.SurfaceWidth - ScaleX(120), + (ThemePage.SurfaceWidth - ScaleX(120)) * 5 div 8); + ThemePreview.Stretch := True; + UpdateThemePreview(nil); +end; + +procedure AddSelectedPlugin(var Selection: String; Component, PluginId: String); +begin + if WizardIsComponentSelected(Component) then begin + if Selection <> '' then Selection := Selection + ','; + Selection := Selection + PluginId; + end; +end; + +function GetPluginSelection(Param: String): String; +begin + Result := ''; + AddSelectedPlugin(Result, 'plugins\example', 'lanctl.example.network-summary'); + AddSelectedPlugin(Result, 'plugins\vendor', 'lanctl.analysis.mac-vendor'); + AddSelectedPlugin(Result, 'plugins\mdns', 'lanctl.discovery.mdns-ssdp'); + AddSelectedPlugin(Result, 'plugins\smb', 'lanctl.discovery.windows-smb'); + AddSelectedPlugin(Result, 'plugins\wol', 'lanctl.network.wol'); + AddSelectedPlugin(Result, 'plugins\lab', 'lanctl.lab.network-emulator'); + if Result = '' then Result := 'none'; +end; + +function GetLanipArguments(Param: String): String; +begin + Result := 'post-install'; + if WizardIsTaskSelected('firstscan') then Result := Result + ' --first-scan'; +end; + function NeedsAddPath(Param: string): Boolean; var Paths: string; begin diff --git a/packaging/inno/theme-previews/README.md b/packaging/inno/theme-previews/README.md new file mode 100644 index 0000000..9ee9bc4 --- /dev/null +++ b/packaging/inno/theme-previews/README.md @@ -0,0 +1,23 @@ +# Vistas previas de apariencia + +Los cinco BMP muestran la pantalla Inicio real de LANCTL, renderizada con los +presets del Core y sin proyectos, plugins ni datos de usuario. Inno los incluye +con `dontcopy`, los extrae en su directorio temporal y carga la imagen de la +opción seleccionada en `TBitmapImage`. + +Para regenerarlos en Windows, con Edge y Playwright instalados en el entorno +de desarrollo: + +```text +python tools/generate_installer_theme_previews.py +python -m pytest tests/test_installer_theme_previews.py +``` + +El generador usa el navegador para redimensionar la captura y la biblioteca +estándar de Python para escribir BMP RGB de 24 bits. No necesita Pillow. La +compilación del instalador y las pruebas de recursos usan los archivos +versionados; no requieren un navegador ni generan capturas durante CI. + +Además de esas pruebas, revisar las cinco opciones en la página Apariencia +inicial del Setup compilado, sin continuar con la instalación. Verificar que +cambia la imagen, conserva su proporción y no queda cortada por el formulario. diff --git a/packaging/inno/theme-previews/forest.bmp b/packaging/inno/theme-previews/forest.bmp new file mode 100644 index 0000000..0762b27 Binary files /dev/null and b/packaging/inno/theme-previews/forest.bmp differ diff --git a/packaging/inno/theme-previews/graphite.bmp b/packaging/inno/theme-previews/graphite.bmp new file mode 100644 index 0000000..5559a45 Binary files /dev/null and b/packaging/inno/theme-previews/graphite.bmp differ diff --git a/packaging/inno/theme-previews/light.bmp b/packaging/inno/theme-previews/light.bmp new file mode 100644 index 0000000..a6ccc6d Binary files /dev/null and b/packaging/inno/theme-previews/light.bmp differ diff --git a/packaging/inno/theme-previews/midnight.bmp b/packaging/inno/theme-previews/midnight.bmp new file mode 100644 index 0000000..5bb3ed2 Binary files /dev/null and b/packaging/inno/theme-previews/midnight.bmp differ diff --git a/packaging/inno/theme-previews/violet.bmp b/packaging/inno/theme-previews/violet.bmp new file mode 100644 index 0000000..5615947 Binary files /dev/null and b/packaging/inno/theme-previews/violet.bmp differ diff --git a/packaging/portable/README-portable.txt b/packaging/portable/README-portable.txt index 54f7506..cc3648f 100644 --- a/packaging/portable/README-portable.txt +++ b/packaging/portable/README-portable.txt @@ -1,12 +1,23 @@ -LANCTL portable -=============== +LANCTL GUI EXPERIMENTAL - NOT STABLE - 0.3.4-alpha.1 +================================================= Run LANCTL.exe, lanip.exe, lanwire.exe, lanrack.exe, lanaccess.exe or lanmon.exe from this directory. LANMON provides direct monitoring commands. All tools store mutable data in data/lanctl beside the executables. LANWIRE owns physical/idf.db while LANIP keeps its logical and monitoring databases separate. The portable package does not modify PATH, ProgramData, the -registry, services, firewall rules, or SSH/HTTPS settings. Preserve data/lanctl +registry, services, firewall rules, or SSH/HTTPS settings merely by opening a launcher. Preserve data/lanctl when replacing the executable during an update. -Running LANCTL.exe without arguments opens the TUI. The frozen legacy GUI is -not included in this portable distribution. +To open the experimental graphical center, run LANCTL.exe --gui. +You can also run lanip.exe, lanwire.exe, lanrack.exe, lanaccess.exe or lanmon.exe +with --gui. Windows x64 and Microsoft WebView2 Runtime are required. +Without arguments the saved startup preference is used (TUI by default). +This is a testing prototype. Use copies of projects and preserve data/lanctl. + +Optional Clink completion: run .\prepare.ps1 from a normal-user PowerShell, +or LANCTL.exe completions install. This registers only this directory's clink +folder for the current user, if Clink is detected. Re-running is safe. +Before moving/removing the portable directory, run .\prepare.ps1 -RemoveClink +or LANCTL.exe completions uninstall. Other script folders are not removed. +If Clink is installed only through a custom per-user path, use a normal CMD +with Clink and clink installscripts / clink uninstallscripts for that folder. diff --git a/packaging/portable/prepare.ps1 b/packaging/portable/prepare.ps1 new file mode 100644 index 0000000..2a10b03 --- /dev/null +++ b/packaging/portable/prepare.ps1 @@ -0,0 +1,7 @@ +param([switch]$RemoveClink) +$ErrorActionPreference = 'Stop' +$LauncherPath = Join-Path $PSScriptRoot 'LANCTL.exe' +if (-not (Test-Path -LiteralPath $LauncherPath -PathType Leaf)) { throw 'LANCTL.exe is missing from this portable directory.' } +$ClinkAction = if ($RemoveClink) { 'uninstall' } else { 'install' } +& $LauncherPath completions $ClinkAction +if ($LASTEXITCODE -ne 0) { throw 'Clink integration failed. See LANCTL diagnostics.' } diff --git a/packaging/windows_version_info.txt b/packaging/windows_version_info.txt index a69ec8b..80f6fc5 100644 --- a/packaging/windows_version_info.txt +++ b/packaging/windows_version_info.txt @@ -1,7 +1,7 @@ VSVersionInfo( ffi=FixedFileInfo( - filevers=(0, 3, 3, 0), - prodvers=(0, 3, 3, 0), + filevers=(0, 3, 4, 1), + prodvers=(0, 3, 4, 1), mask=0x3f, flags=0x0, OS=0x40004, @@ -15,13 +15,13 @@ VSVersionInfo( u'040904B0', [ StringStruct(u'CompanyName', u'LANCTL Project'), - StringStruct(u'FileDescription', u'LANCTL - LAN Control 0.3.3'), - StringStruct(u'FileVersion', u'0.3.3.0'), + StringStruct(u'FileDescription', u'LANCTL - GUI experimental (NO ESTABLE) 0.3.4-alpha.1'), + StringStruct(u'FileVersion', u'0.3.4.1'), StringStruct(u'InternalName', u'LANCTL'), StringStruct(u'LegalCopyright', u'Copyright © 2026 Victor'), StringStruct(u'OriginalFilename', u'LANCTL.exe'), StringStruct(u'ProductName', u'LANCTL'), - StringStruct(u'ProductVersion', u'0.3.3') + StringStruct(u'ProductVersion', u'0.3.4-alpha.1') ] ) ]), diff --git a/pyproject.toml b/pyproject.toml index d567275..9231210 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "lanctl" -version = "0.3.3" +version = "0.3.4-alpha.1" description = "CLI de control lógico y físico de infraestructuras LAN" requires-python = ">=3.10" dependencies = [ @@ -22,10 +22,10 @@ dependencies = [ gui = ["pywebview>=6.2.1,<7"] dev = [ "bandit==1.8.6", - "coverage==7.10.6", + "coverage==7.16.2", "pip-audit==2.9.0", "pytest==9.0.3", - "ruff==0.16.2", + "ruff==0.17.0", ] [project.scripts] diff --git a/reference/catalog.js b/reference/catalog.js index 1d2d89d..3691272 100644 --- a/reference/catalog.js +++ b/reference/catalog.js @@ -67,6 +67,53 @@ window.LANCTL_REFERENCE = { "metavar": "", "required": false }, + { + "choices": [], + "default": null, + "description": "Abre el centro gráfico de LANCTL.", + "flags": [ + "--gui" + ], + "label": "--gui", + "metavar": "", + "required": false + }, + { + "choices": [], + "default": null, + "description": "Muestra y abre la web oficial.", + "flags": [ + "-web", + "--web" + ], + "label": "-web, --web", + "metavar": "", + "required": false + }, + { + "choices": [], + "default": null, + "description": "Muestra y abre GitHub oficial.", + "flags": [ + "-github", + "--github" + ], + "label": "-github, --github", + "metavar": "", + "required": false + }, + { + "choices": [], + "default": null, + "description": "Muestra y abre la referencia oficial.", + "flags": [ + "-reference", + "--reference" + ], + "label": "-reference, --reference", + "metavar": "", + "required": false + }, { "choices": [], "default": null, @@ -89,13 +136,16 @@ window.LANCTL_REFERENCE = { "plugin", "settings", "language", - "backend" + "backend", + "setup-defaults", + "completions", + "post-install" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Orquestador raíz de las aplicaciones de la suite LANCTL.", - "details": "Usage: LANCTL [-h] [--version] [--cli | -tui] [--admin] LAUNCHER ...\n\nOrquestador raíz de las aplicaciones de la suite LANCTL.\n\nArguments:\n LAUNCHER\n lanip (ip) Inventario lógico, descubrimiento, IP, MAC y servicios.\n lanwire (wire) Cableado, puertos, paneles y topología física.\n lanrack (rack) Salas técnicas, racks, unidades U y equipos.\n lanaccess (access)\n Usuarios, credenciales y accesos remotos.\n lanmon (monitor) Monitorización, eventos, incidencias e historial.\n plugin Administración compartida de la suite.\n settings Administración compartida de la suite.\n language Administración compartida de la suite.\n backend Administración compartida de la suite.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --cli, -cli Abre la consola principal.\n -tui, --tui Abre el TUI principal.\n --admin Solicita UAC explícitamente para un launcher instalado en Windows.", + "details": "Usage: LANCTL [-h] [--version] [--cli | -tui | --gui] [-web | -github | -reference] [--admin]\n LAUNCHER ...\n\nOrquestador raíz de las aplicaciones de la suite LANCTL.\n\nArguments:\n LAUNCHER\n lanip (ip) Inventario lógico, descubrimiento, IP, MAC y servicios.\n lanwire (wire) Cableado, puertos, paneles y topología física.\n lanrack (rack) Salas técnicas, racks, unidades U y equipos.\n lanaccess (access) Usuarios, credenciales y accesos remotos.\n lanmon (monitor) Monitorización, eventos, incidencias e historial.\n plugin Administración compartida de la suite.\n settings Administración compartida de la suite.\n language Administración compartida de la suite.\n backend Administración compartida de la suite.\n setup-defaults Inicializa preferencias de instalación sin sobrescribir las existentes.\n completions Registra o retira el completado Clink del usuario actual.\n post-install Abre LANIP con el usuario normal al finalizar la instalación.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --cli, -cli Abre la consola principal.\n -tui, --tui Abre el TUI principal.\n --gui Abre el centro gráfico de LANCTL.\n -web, --web Muestra y abre la web oficial.\n -github, --github Muestra y abre GitHub oficial.\n -reference, --reference Muestra y abre la referencia oficial.\n --admin Solicita UAC explícitamente para un launcher instalado en Windows.", "docs": [ "CLI-REFERENCE.md", "CLI.md" @@ -113,7 +163,7 @@ window.LANCTL_REFERENCE = { "LANCTL" ], "title": "LANCTL", - "usage": "LANCTL [-h] [--version] [--cli | -tui] [--admin] LAUNCHER ..." + "usage": "LANCTL [-h] [--version] [--cli | -tui | --gui] [-web | -github | -reference] [--admin]\n LAUNCHER ..." }, { "aliases": [ @@ -180,6 +230,17 @@ window.LANCTL_REFERENCE = { "metavar": "", "required": false }, + { + "choices": [], + "default": null, + "description": "Solicita confirmación del primer escaneo al abrir la GUI; no escanea automáticamente.", + "flags": [ + "--first-scan" + ], + "label": "--first-scan", + "metavar": "", + "required": false + }, { "choices": [], "default": null, @@ -259,10 +320,10 @@ window.LANCTL_REFERENCE = { "lab" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Logical control of LAN devices and infrastructure.", - "details": "Usage: LANIP [-h] [--version] [--quiet | --verbose] [--gui] [--cli] [-tui [VENTANA]]\n [-project ARCHIVO.vlf]\n COMANDO ...\n\nLogical control of LAN devices and infrastructure.\n\nArguments:\n COMANDO\n ephemeral (-e) Escanea activos sin leer ni guardar ningún inventario.\n list Escanea la LAN y muestra dispositivos activos e históricos.\n recurrent Consulta los elementos recurrentes conocidos por LANCTL.\n ping Comprueba puntualmente si un elemento responde por PING o ARP.\n open (connect) Abre un elemento con un cliente acorde al protocolo.\n settings Consulta o modifica la configuración persistente de LANCTL.\n call Resuelve un alias, una IP o una MAC a los datos del dispositivo.\n search Busca dispositivos por alias, nombre, IP o MAC.\n scan Inspecciona en profundidad un único elemento de la LAN.\n cnf Asigna el estado CNF de un elemento por IP, MAC o alias.\n credential (credentials, auth)\n Asocia credenciales cifradas a un elemento y protocolo.\n GATEWAY (gateway) Consulta y configura el gateway mediante TR-064.\n downloadSettings (downloadsettings, download-settings)\n Alias heredado de «GATEWAY downloadSettings».\n protocol Consulta o configura un protocolo de un elemento.\n ssh Abre SSH o ejecuta una consulta show de solo lectura.\n radmin Configura, comprueba o abre Radmin Viewer.\n wol Enciende equipos mediante Wake-on-LAN y ejecuta secuencias seguras.\n history Consulta eventos estructurados del proyecto VLF activo.\n monitor Opera sesiones y checks del monitor LAN.\n access Configura acceso remoto LAN seguro por SSH y HTTPS.\n smb Descubre y abre recursos SMB de Windows.\n terminal (cli) Abre la terminal propia de un elemento según su protocolo.\n switch Planifica comandos Cisco filtrados, remapeados y clasificados.\n group Crea, edita y consulta grupos de elementos.\n element Edita uno o varios campos de un elemento identificado por IP, MAC o\n alias.\n project (projects) Crea, actualiza e inspecciona proyectos LANCTL .vlf.\n plugin (plugins, addon, addons)\n Gestiona complementos unificados LANCTL .lcp.\n language (languages, lang)\n Manage LANCTL interface languages.\n error (errors) Consulta el catálogo por identificador 0eXXXXXXXX.\n database (db) Diagnostica y exporta datos.\n demo Genera un recorrido reproducible sin depender de una red real.\n lanwire (wire) Abre LANWIRE o ejecuta uno de sus comandos sobre la base física\n compartida.\n lab Gestiona redes LAN simuladas sin tráfico real.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión y termina.\n --quiet Omite la salida correcta; conserva errores.\n --verbose Añade diagnóstico de ejecución a stderr.\n --gui Abre la interfaz gráfica de LANIP.\n --cli, -cli Open the persistent interactive LANCTL terminal.\n -tui [VENTANA], --tui [VENTANA]\n Open the advanced full-screen terminal interface. Puede abrir\n directamente PLUGINS, PROJECTS o SETTINGS.\n -project ARCHIVO.vlf, --project ARCHIVO.vlf\n Selecciona un proyecto VLF antes de abrir el TUI o ejecutar un\n comando.", + "details": "Usage: LANIP [-h] [--version] [--quiet | --verbose] [--gui] [--first-scan] [--cli]\n [-tui [VENTANA]] [-project ARCHIVO.vlf]\n COMANDO ...\n\nLogical control of LAN devices and infrastructure.\n\nArguments:\n COMANDO\n ephemeral (-e) Escanea activos sin leer ni guardar ningún inventario.\n list Escanea la LAN y muestra dispositivos activos e históricos.\n recurrent Consulta los elementos recurrentes conocidos por LANCTL.\n ping Comprueba puntualmente si un elemento responde por PING o ARP.\n open (connect) Abre un elemento con un cliente acorde al protocolo.\n settings Consulta o modifica la configuración persistente de LANCTL.\n call Resuelve un alias, una IP o una MAC a los datos del dispositivo.\n search Busca dispositivos por alias, nombre, IP o MAC.\n scan Inspecciona en profundidad un único elemento de la LAN.\n cnf Asigna el estado CNF de un elemento por IP, MAC o alias.\n credential (credentials, auth)\n Asocia credenciales cifradas a un elemento y protocolo.\n GATEWAY (gateway) Consulta y configura el gateway mediante TR-064.\n downloadSettings (downloadsettings, download-settings)\n Alias heredado de «GATEWAY downloadSettings».\n protocol Consulta o configura un protocolo de un elemento.\n ssh Abre SSH o ejecuta una consulta show de solo lectura.\n radmin Configura, comprueba o abre Radmin Viewer.\n wol Enciende equipos mediante Wake-on-LAN y ejecuta secuencias seguras.\n history Consulta eventos estructurados del proyecto VLF activo.\n monitor Opera sesiones y checks del monitor LAN.\n access Configura acceso remoto LAN seguro por SSH y HTTPS.\n smb Descubre y abre recursos SMB de Windows.\n terminal (cli) Abre la terminal propia de un elemento según su protocolo.\n switch Planifica comandos Cisco filtrados, remapeados y clasificados.\n group Crea, edita y consulta grupos de elementos.\n element Edita uno o varios campos de un elemento identificado por IP, MAC o\n alias.\n project (projects) Crea, actualiza e inspecciona proyectos LANCTL .vlf.\n plugin (plugins, addon, addons)\n Gestiona complementos unificados LANCTL .lcp.\n language (languages, lang)\n Manage LANCTL interface languages.\n error (errors) Consulta el catálogo por identificador 0eXXXXXXXX.\n database (db) Diagnostica y exporta datos.\n demo Genera un recorrido reproducible sin depender de una red real.\n lanwire (wire) Abre LANWIRE o ejecuta uno de sus comandos sobre la base física\n compartida.\n lab Gestiona redes LAN simuladas sin tráfico real.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión y termina.\n --quiet Omite la salida correcta; conserva errores.\n --verbose Añade diagnóstico de ejecución a stderr.\n --gui Abre la interfaz gráfica de LANIP.\n --first-scan Solicita confirmación del primer escaneo al abrir la GUI; no escanea\n automáticamente.\n --cli, -cli Open the persistent interactive LANCTL terminal.\n -tui [VENTANA], --tui [VENTANA]\n Open the advanced full-screen terminal interface. Puede abrir\n directamente PLUGINS, PROJECTS o SETTINGS.\n -project ARCHIVO.vlf, --project ARCHIVO.vlf\n Selecciona un proyecto VLF antes de abrir el TUI o ejecutar un\n comando.", "docs": [ "CLI-REFERENCE.md", "CLI.md" @@ -280,7 +341,7 @@ window.LANCTL_REFERENCE = { "LANIP" ], "title": "LANIP", - "usage": "LANIP [-h] [--version] [--quiet | --verbose] [--gui] [--cli] [-tui [VENTANA]]\n [-project ARCHIVO.vlf]\n COMANDO ..." + "usage": "LANIP [-h] [--version] [--quiet | --verbose] [--gui] [--first-scan] [--cli]\n [-tui [VENTANA]] [-project ARCHIVO.vlf]\n COMANDO ..." }, { "aliases": [], @@ -414,7 +475,7 @@ window.LANCTL_REFERENCE = { "category": "Descubrimiento de red", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Ejecuta el descubrimiento real en una sesión aislada en memoria. No abre, modifica ni guarda proyectos o bases de dispositivos.", "details": "Usage: LANIP ephemeral [-h] [--fast | --normal | --accurate] [--range NETWORK] [--resolve-names]\n [--ports PORTS] [--json] [--workers WORKERS] [--timeout TIMEOUT]\n [--max-hosts MAX_HOSTS] [--scan-order {ascending,descending,random}]\n\nEjecuta el descubrimiento real en una sesión aislada en memoria. No abre, modifica ni guarda proyectos o bases de dispositivos.\n\nOptions:\n -h, --help Show this help and exit.\n --fast Prioriza un barrido ARP rápido.\n --normal Combina ICMP, ARP y descubrimiento de servicios.\n --accurate Añade reintentos y reconocimiento más profundo.\n --range NETWORK Rango CIDR que se explorará solo durante esta ejecución.\n --resolve-names Resuelve nombres sin almacenarlos.\n --ports PORTS Puertos TCP opcionales, por ejemplo 22,80,443.\n --json Devuelve la sesión como JSON.\n --workers WORKERS Sondeos simultáneos.\n --timeout TIMEOUT Tiempo máximo base por sondeo, en segundos.\n --max-hosts MAX_HOSTS Límite defensivo de direcciones autorizadas.\n --scan-order {ascending,descending,random}\n Orden de exploración de las direcciones.", @@ -451,6 +512,17 @@ window.LANCTL_REFERENCE = { "metavar": "", "required": false }, + { + "choices": [], + "default": null, + "description": "Origen IPv4 local o ID de interfaz; usa su máscara real. Solo ICMP/ARP, sin DNS ni descubridores externos.", + "flags": [ + "--interface" + ], + "label": "--interface", + "metavar": "", + "required": false + }, { "choices": [], "default": "data/lc/projects/workspaces/default/database/devices.json", @@ -803,10 +875,10 @@ window.LANCTL_REFERENCE = { "category": "Inventario y búsqueda", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Realiza un escaneo básico de IP/MAC, actualiza la base de datos por MAC y muestra también los equipos no detectados.", - "details": "Usage: LANIP list [-h] [--network NETWORK] [--database DATABASE] [--groups GROUPS]\n [-f {table,json,csv,html,xml,yaml}] [-o OUTPUT] [-recurrent] [--where WHERE]\n [-w WORKERS] [-t TIMEOUT] [--scan-order {ascending,descending,random}]\n [--include-unknown] [--resolve-names] [--max-hosts MAX_HOSTS]\n [--discovery {icmp,arp,hybrid}]\n [--profile {fast,normal,accurate} | --fast | --normal | --accurate]\n [--progress | --no-progress] [--show-discovery] [--include-arp-cache]\n [--show-detection] [--active | -disconnected] [-basic] [-cnf {O,X,-,S,F}]\n [-group GRUPO] [-dhcp]\n\nRealiza un escaneo básico de IP/MAC, actualiza la base de datos por MAC y muestra también los equipos no detectados.\n\nOptions:\n -h, --help Show this help and exit.\n --network NETWORK Red CIDR. Por defecto detecta la LAN como /24.\n --database DATABASE Archivo JSON de elementos.\n --groups GROUPS Archivo JSON de grupos.\n -f {table,json,csv,html,xml,yaml}, --format {table,json,csv,html,xml,yaml}\n Formato de salida (por defecto: table).\n -o OUTPUT, --output OUTPUT Guarda la salida en un archivo.\n -recurrent, --recurrent Lista los elementos recurrentes sin escanear la LAN ni mostrar IP.\n --where WHERE Consulta combinable, por ejemplo: \"active and group=IOT and\n vendor~Amazon\".\n -w WORKERS, --workers WORKERS\n Comprobaciones simultáneas.\n -t TIMEOUT, --timeout TIMEOUT\n Timeout base en segundos por operación y host; el perfil puede\n ajustarlo.\n --scan-order {ascending,descending,random}\n Orden de sondeo de IP: ascending, descending o random.\n --include-unknown Incluye hosts activos aunque todavía no tengan MAC.\n --resolve-names Resuelve y guarda nombres DNS de los elementos detectados.\n --max-hosts MAX_HOSTS Máximo de hosts permitido en un escaneo.\n --discovery {icmp,arp,hybrid}\n Método: icmp, arp activo o hybrid (por defecto según settings).\n --profile {fast,normal,accurate}\n Perfil completo de escaneo: fast, normal o accurate.\n --fast Escaneo ARP rápido.\n --normal Escaneo híbrido equilibrado.\n --accurate Escaneo profundo con varios métodos.\n --progress Muestra el progreso interactivo.\n --no-progress Oculta el progreso.\n --show-discovery Añade una columna con ICMP, ARP, LOCAL, BASIC o CACHE.\n --include-arp-cache Importa vecinos ARP en caché como CACHE no verificada; no cuentan\n como activos.\n --show-detection Añade los métodos históricos y la fecha de última detección.\n --active, -active, -connected, --connected, -conected\n Muestra solo los dispositivos activos en el escaneo actual.\n -disconnected, --disconnected, -offline\n Muestra solo los dispositivos no detectados actualmente.\n -basic, --basic Vista reducida: IP, alias y descripción.\n -cnf {O,X,-,S,F}, --cnf-state {O,X,-,S,F}\n Filtra por estado CNF: O, X, -, S o F.\n -group GRUPO, --group GRUPO\n Muestra solo los elementos de un grupo.\n -dhcp, --dhcp-only Muestra solo IP incluidas en el rango DHCP configurado.", + "details": "Usage: LANIP list [-h] [--network NETWORK] [--interface INTERFACE] [--database DATABASE]\n [--groups GROUPS] [-f {table,json,csv,html,xml,yaml}] [-o OUTPUT] [-recurrent]\n [--where WHERE] [-w WORKERS] [-t TIMEOUT]\n [--scan-order {ascending,descending,random}] [--include-unknown]\n [--resolve-names] [--max-hosts MAX_HOSTS] [--discovery {icmp,arp,hybrid}]\n [--profile {fast,normal,accurate} | --fast | --normal | --accurate]\n [--progress | --no-progress] [--show-discovery] [--include-arp-cache]\n [--show-detection] [--active | -disconnected] [-basic] [-cnf {O,X,-,S,F}]\n [-group GRUPO] [-dhcp]\n\nRealiza un escaneo básico de IP/MAC, actualiza la base de datos por MAC y muestra también los equipos no detectados.\n\nOptions:\n -h, --help Show this help and exit.\n --network NETWORK Red CIDR. Por defecto detecta la LAN como /24.\n --interface INTERFACE Origen IPv4 local o ID de interfaz; usa su máscara real. Solo\n ICMP/ARP, sin DNS ni descubridores externos.\n --database DATABASE Archivo JSON de elementos.\n --groups GROUPS Archivo JSON de grupos.\n -f {table,json,csv,html,xml,yaml}, --format {table,json,csv,html,xml,yaml}\n Formato de salida (por defecto: table).\n -o OUTPUT, --output OUTPUT Guarda la salida en un archivo.\n -recurrent, --recurrent Lista los elementos recurrentes sin escanear la LAN ni mostrar IP.\n --where WHERE Consulta combinable, por ejemplo: \"active and group=IOT and\n vendor~Amazon\".\n -w WORKERS, --workers WORKERS\n Comprobaciones simultáneas.\n -t TIMEOUT, --timeout TIMEOUT\n Timeout base en segundos por operación y host; el perfil puede\n ajustarlo.\n --scan-order {ascending,descending,random}\n Orden de sondeo de IP: ascending, descending o random.\n --include-unknown Incluye hosts activos aunque todavía no tengan MAC.\n --resolve-names Resuelve y guarda nombres DNS de los elementos detectados.\n --max-hosts MAX_HOSTS Máximo de hosts permitido en un escaneo.\n --discovery {icmp,arp,hybrid}\n Método: icmp, arp activo o hybrid (por defecto según settings).\n --profile {fast,normal,accurate}\n Perfil completo de escaneo: fast, normal o accurate.\n --fast Escaneo ARP rápido.\n --normal Escaneo híbrido equilibrado.\n --accurate Escaneo profundo con varios métodos.\n --progress Muestra el progreso interactivo.\n --no-progress Oculta el progreso.\n --show-discovery Añade una columna con ICMP, ARP, LOCAL, BASIC o CACHE.\n --include-arp-cache Importa vecinos ARP en caché como CACHE no verificada; no cuentan\n como activos.\n --show-detection Añade los métodos históricos y la fecha de última detección.\n --active, -active, -connected, --connected, -conected\n Muestra solo los dispositivos activos en el escaneo actual.\n -disconnected, --disconnected, -offline\n Muestra solo los dispositivos no detectados actualmente.\n -basic, --basic Vista reducida: IP, alias y descripción.\n -cnf {O,X,-,S,F}, --cnf-state {O,X,-,S,F}\n Filtra por estado CNF: O, X, -, S o F.\n -group GRUPO, --group GRUPO\n Muestra solo los elementos de un grupo.\n -dhcp, --dhcp-only Muestra solo IP incluidas en el rango DHCP configurado.", "docs": [ "CLI-REFERENCE.md", "CLI.md" @@ -825,7 +897,7 @@ window.LANCTL_REFERENCE = { "list" ], "title": "LANIP list", - "usage": "LANIP list [-h] [--network NETWORK] [--database DATABASE] [--groups GROUPS]\n [-f {table,json,csv,html,xml,yaml}] [-o OUTPUT] [-recurrent] [--where WHERE]\n [-w WORKERS] [-t TIMEOUT] [--scan-order {ascending,descending,random}]\n [--include-unknown] [--resolve-names] [--max-hosts MAX_HOSTS]\n [--discovery {icmp,arp,hybrid}]\n [--profile {fast,normal,accurate} | --fast | --normal | --accurate]\n [--progress | --no-progress] [--show-discovery] [--include-arp-cache]\n [--show-detection] [--active | -disconnected] [-basic] [-cnf {O,X,-,S,F}]\n [-group GRUPO] [-dhcp]" + "usage": "LANIP list [-h] [--network NETWORK] [--interface INTERFACE] [--database DATABASE]\n [--groups GROUPS] [-f {table,json,csv,html,xml,yaml}] [-o OUTPUT] [-recurrent]\n [--where WHERE] [-w WORKERS] [-t TIMEOUT]\n [--scan-order {ascending,descending,random}] [--include-unknown]\n [--resolve-names] [--max-hosts MAX_HOSTS] [--discovery {icmp,arp,hybrid}]\n [--profile {fast,normal,accurate} | --fast | --normal | --accurate]\n [--progress | --no-progress] [--show-discovery] [--include-arp-cache]\n [--show-detection] [--active | -disconnected] [-basic] [-cnf {O,X,-,S,F}]\n [-group GRUPO] [-dhcp]" }, { "aliases": [], @@ -877,7 +949,7 @@ window.LANCTL_REFERENCE = { "category": "Comandos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Muestra identidades recurrentes por MAC. No incluye IP porque puede cambiar en cada LAN.", "details": "Usage: LANIP recurrent [-h] -list [-f {table,json,csv,html,xml,yaml}] [-o OUTPUT]\n\nMuestra identidades recurrentes por MAC. No incluye IP porque puede cambiar en cada LAN.\n\nOptions:\n -h, --help Show this help and exit.\n -list, --list Lista todos los elementos recurrentes sin sus IP.\n -f {table,json,csv,html,xml,yaml}, --format {table,json,csv,html,xml,yaml}\n Formato de salida (por defecto: table).\n -o OUTPUT, --output OUTPUT Guarda la salida en un archivo.", @@ -986,7 +1058,7 @@ window.LANCTL_REFERENCE = { "category": "Diagnóstico de red", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Diagnostica un único elemento sin modificar la base de datos. PING prueba ICMP; ARP realiza una consulta activa en la LAN; AUTO combina ambos métodos.", "details": "Usage: LANIP ping [-h] [--method {auto,ping,arp} | --ping | --arp] [--timeout TIMEOUT] [--json]\n [--database DATABASE]\n selector\n\nDiagnostica un único elemento sin modificar la base de datos. PING prueba ICMP; ARP realiza una consulta activa en la LAN; AUTO combina ambos métodos.\n\nArguments:\n selector IP, MAC, alias o nombre registrado.\n\nOptions:\n -h, --help Show this help and exit.\n --method {auto,ping,arp} Buscador utilizado: auto, ping o arp (por defecto: auto).\n --ping Usa únicamente una solicitud ICMP.\n --arp Usa únicamente una solicitud ARP activa.\n --timeout TIMEOUT Tiempo máximo de cada comprobación, en segundos.\n --json Devuelve el diagnóstico como JSON.\n --database DATABASE Archivo JSON de elementos.", @@ -1194,7 +1266,7 @@ window.LANCTL_REFERENCE = { "category": "Comandos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP open [-h] [--port PORT] [--path PATH]\n [--mode {control,view,file,shutdown,chat,voice,message,telnet}]\n [--through THROUGH] [--fullscreen] [--color-depth {24,16,8,4,2,1}]\n [--updates UPDATES] [--phonebook PHONEBOOK] [--phonebook-id PHONEBOOK_ID]\n [--dry-run] [--database DATABASE] [--store STORE]\n selector [{auto,ssh,tr-064,telnet,http,https,ftp,rdp,rtsp,smb,radmin}]", "details": "Usage: LANIP open [-h] [--port PORT] [--path PATH]\n [--mode {control,view,file,shutdown,chat,voice,message,telnet}]\n [--through THROUGH] [--fullscreen] [--color-depth {24,16,8,4,2,1}]\n [--updates UPDATES] [--phonebook PHONEBOOK] [--phonebook-id PHONEBOOK_ID]\n [--dry-run] [--database DATABASE] [--store STORE]\n selector [{auto,ssh,tr-064,telnet,http,https,ftp,rdp,rtsp,smb,radmin}]\n\nArguments:\n selector IP, MAC o alias del elemento.\n {auto,ssh,tr-064,telnet,http,https,ftp,rdp,rtsp,smb,radmin}\n Protocolo o detección automática.\n\nOptions:\n -h, --help Show this help and exit.\n --port PORT Puerto alternativo.\n --path PATH Ruta HTTP/FTP/RTSP o recurso SMB.\n --mode {control,view,file,shutdown,chat,voice,message,telnet}\n Modo de conexión Radmin.\n --through THROUGH Servidor Radmin intermedio HOST:PUERTO.\n --fullscreen Abre control o vista a pantalla completa.\n --color-depth {24,16,8,4,2,1}\n Profundidad de color de Radmin (1, 2, 4, 8, 16 o 24 bits).\n --updates UPDATES Máximo de actualizaciones de pantalla por segundo (1-120).\n --phonebook PHONEBOOK Ruta de phonebook Radmin .rpb.\n --phonebook-id PHONEBOOK_ID\n Identificador de entrada dentro del phonebook de Radmin.\n --dry-run Muestra el destino sin abrirlo.\n --database DATABASE Archivo JSON de elementos.\n --store STORE Almacén cifrado de credenciales.", @@ -1220,6 +1292,35 @@ window.LANCTL_REFERENCE = { { "aliases": [], "arguments": [ + { + "choices": [ + "cli", + "tui", + "gui" + ], + "default": null, + "description": "Interfaz preferida al abrir LANCTL sin argumentos.", + "flags": [ + "--startup-interface" + ], + "label": "--startup-interface", + "metavar": "", + "required": false + }, + { + "choices": [ + "on", + "off" + ], + "default": null, + "description": "Cierra la GUI principal cuando el launcher solicitado esté disponible.", + "flags": [ + "--close-gui-on-launch" + ], + "label": "--close-gui-on-launch", + "metavar": "", + "required": false + }, { "choices": [], "default": null, @@ -1725,15 +1826,84 @@ window.LANCTL_REFERENCE = { "label": "--tui-footer-button", "metavar": "ACCIÓN=on|off", "required": false + }, + { + "choices": [], + "default": null, + "description": "Editor interactivo por categorías de programa y proyecto.", + "flags": [ + "--menu" + ], + "label": "--menu", + "metavar": "", + "required": false + }, + { + "choices": [], + "default": null, + "description": "Lista todos los ajustes por categorías, con valor y estado editable.", + "flags": [ + "--catalog" + ], + "label": "--catalog", + "metavar": "", + "required": false + }, + { + "choices": [], + "default": null, + "description": "Consulta un ajuste por su ruta, por ejemplo ip.workers.", + "flags": [ + "--get" + ], + "label": "--get", + "metavar": "RUTA", + "required": false + }, + { + "choices": [], + "default": null, + "description": "Modifica un ajuste; listas y booleanos usan JSON.", + "flags": [ + "--set" + ], + "label": "--set", + "metavar": "('RUTA', 'VALOR')", + "required": false + }, + { + "choices": [ + "program", + "project" + ], + "default": "program", + "description": "Ámbito de configuración (predeterminado: program).", + "flags": [ + "--scope" + ], + "label": "--scope", + "metavar": "", + "required": false + }, + { + "choices": [], + "default": null, + "description": "Filtra el catálogo por categoría, por ejemplo network o monitor.", + "flags": [ + "--category" + ], + "label": "--category", + "metavar": "", + "required": false } ], "category": "Configuración", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, - "description": "usage: LANIP settings [-h] [-range CIDR] [-list-fields CAMPO [CAMPO ...]] [-dhcp-range INICIO-FIN]\n [-credentials ARCHIVO] [-discovery {icmp,arp,hybrid}]\n [--scan-profile {fast,normal,accurate}] [--progress {on,off}]\n [--service-identification {on,off}]\n [--disconnected-retention {permanent,session,forget}]\n [--disconnected-target {unconfirmed,all}] [--disconnected-scope {all,dhcp}]\n [--workers WORKERS] [--timeout TIMEOUT]\n [--scan-order {ascending,descending,random}] [--max-hosts MAX_HOSTS]\n [--database ARCHIVO] [--physical-database ARCHIVO] [--groups ARCHIVO]\n [--log DIRECTORIO] [--error-log-level 1-59]\n [--projects-directory DIRECTORIO] [-save-mode MODO] [-save-interval MINUTOS]\n [--cli-exit-save-prompt {on,off}] [--cli-command-chaining {on,off}]\n [-log-cleanup {on,off}] [-log-retention-days DÍAS]\n [--remote-access {on,off}] [--remote-bind IP] [--remote-cidr CIDR]\n [--remote-port REMOTE_PORT] [--remote-password-auth {on,off}]\n [--remote-backend {service,user}]\n [--remote-forced-view {off,gui,tui,plugins,projects,settings}]\n [--tui-key ACCIÓN=TECLA] [--tui-layout {cli.bottom,cli.top}]\n [--tui-cli-percent 15-75] [--tui-column COLUMNA=TAMAÑO]\n [--tui-footer-buttons ACCIONES] [--tui-footer-button ACCIÓN=on|off]", - "details": "Usage: LANIP settings [-h] [-range CIDR] [-list-fields CAMPO [CAMPO ...]] [-dhcp-range INICIO-FIN]\n [-credentials ARCHIVO] [-discovery {icmp,arp,hybrid}]\n [--scan-profile {fast,normal,accurate}] [--progress {on,off}]\n [--service-identification {on,off}]\n [--disconnected-retention {permanent,session,forget}]\n [--disconnected-target {unconfirmed,all}] [--disconnected-scope {all,dhcp}]\n [--workers WORKERS] [--timeout TIMEOUT]\n [--scan-order {ascending,descending,random}] [--max-hosts MAX_HOSTS]\n [--database ARCHIVO] [--physical-database ARCHIVO] [--groups ARCHIVO]\n [--log DIRECTORIO] [--error-log-level 1-59]\n [--projects-directory DIRECTORIO] [-save-mode MODO] [-save-interval MINUTOS]\n [--cli-exit-save-prompt {on,off}] [--cli-command-chaining {on,off}]\n [-log-cleanup {on,off}] [-log-retention-days DÍAS]\n [--remote-access {on,off}] [--remote-bind IP] [--remote-cidr CIDR]\n [--remote-port REMOTE_PORT] [--remote-password-auth {on,off}]\n [--remote-backend {service,user}]\n [--remote-forced-view {off,gui,tui,plugins,projects,settings}]\n [--tui-key ACCIÓN=TECLA] [--tui-layout {cli.bottom,cli.top}]\n [--tui-cli-percent 15-75] [--tui-column COLUMNA=TAMAÑO]\n [--tui-footer-buttons ACCIONES] [--tui-footer-button ACCIÓN=on|off]\n\nOptions:\n -h, --help Show this help and exit.\n -range CIDR Rango LAN predeterminado, por ejemplo 192.168.1.1/24.\n -list-fields CAMPO [CAMPO ...], --list-fields CAMPO [CAMPO ...], -list CAMPO [CAMPO ...]\n Columnas mostradas por list, separadas por espacios o comas.\n -dhcp-range INICIO-FIN, --dhcp-range INICIO-FIN, -dhcp INICIO-FIN\n Rango DHCP manual. Usa 'off' para dejarlo sin configurar.\n -credentials ARCHIVO, --credentials ARCHIVO\n Ruta del almacén de credenciales cifradas.\n -discovery {icmp,arp,hybrid}, --discovery {icmp,arp,hybrid}\n Método predeterminado utilizado por list.\n --scan-profile {fast,normal,accurate}\n Perfil predeterminado de list: fast, normal o accurate.\n --progress {on,off} Activa o desactiva el progreso interactivo.\n --service-identification {on,off}\n Activa o desactiva el reconocimiento de servicios en scan.\n --disconnected-retention {permanent,session,forget}\n Persistencia de desconectados: permanent, session o forget.\n --disconnected-target {unconfirmed,all}\n Aplica la retención solo a CNF=X (unconfirmed) o a todos (all).\n --disconnected-scope {all,dhcp}\n Aplica la regla a toda la LAN (all) o solo al rango DHCP (dhcp).\n --workers WORKERS Concurrencia predeterminada de los escaneos.\n --timeout TIMEOUT Timeout predeterminado por operación de red.\n --scan-order {ascending,descending,random}\n Orden predeterminado de sondeo: ascending, descending o random.\n --max-hosts MAX_HOSTS Máximo de hosts autorizado por escaneo.\n --database ARCHIVO Ruta del inventario de elementos.\n --physical-database ARCHIVO\n Ruta de la base física SQLite administrada exclusivamente por\n LANWIRE.\n --groups ARCHIVO Ruta de la base de grupos.\n --log DIRECTORIO Directorio de registros.\n --error-log-level 1-59 Nivel mínimo de ErrorEvent escrito en el log (1 incluye diagnóstico\n detallado).\n --projects-directory DIRECTORIO\n Carpeta predeterminada para nombres de proyecto VLF relativos.\n -save-mode MODO, --save-mode MODO\n Política de guardado VLF. Usa 'list' para consultar las opciones\n integradas y las aportadas por plugins.\n -save-interval MINUTOS, --save-interval MINUTOS\n Intervalo de automatic.timeToSave en minutos (mínimo 0.1).\n --cli-exit-save-prompt {on,off}\n Consulta si se guarda al terminar cada comando individual de\n consola.\n --cli-command-chaining {on,off}\n Permite encadenar órdenes con ; dentro de la CLI interactiva.\n -log-cleanup {on,off}, --log-cleanup {on,off}\n Activa o desactiva la limpieza automática de logs antiguos.\n -log-retention-days DÍAS, --log-retention-days DÍAS\n Días durante los que se conservan los archivos de log.\n --remote-access {on,off} Activa el acceso SSH restringido.\n --remote-bind IP IPv4 local de escucha SSH.\n --remote-cidr CIDR Red de origen autorizada.\n --remote-port REMOTE_PORT Puerto del servidor SSH remoto.\n --remote-password-auth {on,off}\n Permite o bloquea autenticación SSH mediante contraseña.\n --remote-backend {service,user}\n Ejecuta el backend como servicio persistente o proceso de usuario.\n --remote-forced-view {off,gui,tui,plugins,projects,settings}\n Vista predeterminada para root forced-view.\n --tui-key ACCIÓN=TECLA Asigna una tecla a una acción del TUI. Puede repetirse.\n --tui-layout {cli.bottom,cli.top}\n Coloca el CLI arriba (cli.top) o abajo (cli.bottom).\n --tui-cli-percent 15-75 Porcentaje vertical reservado al CLI; ListElement conserva al menos\n 25%.\n --tui-column COLUMNA=TAMAÑO\n Peso de columna (GROUP=15%); IP=15ch y MAC=17ch son fijas.\n --tui-footer-buttons ACCIONES\n Acciones visibles en la barra inferior, separadas por comas; usa all\n para todas.\n --tui-footer-button ACCIÓN=on|off\n Muestra u oculta una acción concreta de la barra inferior. Puede\n repetirse.", + "description": "usage: LANIP settings [-h] [--startup-interface {cli,tui,gui}] [--close-gui-on-launch {on,off}]\n [-range CIDR] [-list-fields CAMPO [CAMPO ...]] [-dhcp-range INICIO-FIN]\n [-credentials ARCHIVO] [-discovery {icmp,arp,hybrid}]\n [--scan-profile {fast,normal,accurate}] [--progress {on,off}]\n [--service-identification {on,off}]\n [--disconnected-retention {permanent,session,forget}]\n [--disconnected-target {unconfirmed,all}] [--disconnected-scope {all,dhcp}]\n [--workers WORKERS] [--timeout TIMEOUT]\n [--scan-order {ascending,descending,random}] [--max-hosts MAX_HOSTS]\n [--database ARCHIVO] [--physical-database ARCHIVO] [--groups ARCHIVO]\n [--log DIRECTORIO] [--error-log-level 1-59]\n [--projects-directory DIRECTORIO] [-save-mode MODO] [-save-interval MINUTOS]\n [--cli-exit-save-prompt {on,off}] [--cli-command-chaining {on,off}]\n [-log-cleanup {on,off}] [-log-retention-days DÍAS]\n [--remote-access {on,off}] [--remote-bind IP] [--remote-cidr CIDR]\n [--remote-port REMOTE_PORT] [--remote-password-auth {on,off}]\n [--remote-backend {service,user}]\n [--remote-forced-view {off,gui,tui,plugins,projects,settings}]\n [--tui-key ACCIÓN=TECLA] [--tui-layout {cli.bottom,cli.top}]\n [--tui-cli-percent 15-75] [--tui-column COLUMNA=TAMAÑO]\n [--tui-footer-buttons ACCIONES] [--tui-footer-button ACCIÓN=on|off]\n [--menu | --catalog | --get RUTA | --set RUTA VALOR]\n [--scope {program,project}] [--category CATEGORY]", + "details": "Usage: LANIP settings [-h] [--startup-interface {cli,tui,gui}] [--close-gui-on-launch {on,off}]\n [-range CIDR] [-list-fields CAMPO [CAMPO ...]] [-dhcp-range INICIO-FIN]\n [-credentials ARCHIVO] [-discovery {icmp,arp,hybrid}]\n [--scan-profile {fast,normal,accurate}] [--progress {on,off}]\n [--service-identification {on,off}]\n [--disconnected-retention {permanent,session,forget}]\n [--disconnected-target {unconfirmed,all}] [--disconnected-scope {all,dhcp}]\n [--workers WORKERS] [--timeout TIMEOUT]\n [--scan-order {ascending,descending,random}] [--max-hosts MAX_HOSTS]\n [--database ARCHIVO] [--physical-database ARCHIVO] [--groups ARCHIVO]\n [--log DIRECTORIO] [--error-log-level 1-59]\n [--projects-directory DIRECTORIO] [-save-mode MODO] [-save-interval MINUTOS]\n [--cli-exit-save-prompt {on,off}] [--cli-command-chaining {on,off}]\n [-log-cleanup {on,off}] [-log-retention-days DÍAS]\n [--remote-access {on,off}] [--remote-bind IP] [--remote-cidr CIDR]\n [--remote-port REMOTE_PORT] [--remote-password-auth {on,off}]\n [--remote-backend {service,user}]\n [--remote-forced-view {off,gui,tui,plugins,projects,settings}]\n [--tui-key ACCIÓN=TECLA] [--tui-layout {cli.bottom,cli.top}]\n [--tui-cli-percent 15-75] [--tui-column COLUMNA=TAMAÑO]\n [--tui-footer-buttons ACCIONES] [--tui-footer-button ACCIÓN=on|off]\n [--menu | --catalog | --get RUTA | --set RUTA VALOR]\n [--scope {program,project}] [--category CATEGORY]\n\nOptions:\n -h, --help Show this help and exit.\n --startup-interface {cli,tui,gui}\n Interfaz preferida al abrir LANCTL sin argumentos.\n --close-gui-on-launch {on,off}\n Cierra la GUI principal cuando el launcher solicitado esté\n disponible.\n -range CIDR Rango LAN predeterminado, por ejemplo 192.168.1.1/24.\n -list-fields CAMPO [CAMPO ...], --list-fields CAMPO [CAMPO ...], -list CAMPO [CAMPO ...]\n Columnas mostradas por list, separadas por espacios o comas.\n -dhcp-range INICIO-FIN, --dhcp-range INICIO-FIN, -dhcp INICIO-FIN\n Rango DHCP manual. Usa 'off' para dejarlo sin configurar.\n -credentials ARCHIVO, --credentials ARCHIVO\n Ruta del almacén de credenciales cifradas.\n -discovery {icmp,arp,hybrid}, --discovery {icmp,arp,hybrid}\n Método predeterminado utilizado por list.\n --scan-profile {fast,normal,accurate}\n Perfil predeterminado de list: fast, normal o accurate.\n --progress {on,off} Activa o desactiva el progreso interactivo.\n --service-identification {on,off}\n Activa o desactiva el reconocimiento de servicios en scan.\n --disconnected-retention {permanent,session,forget}\n Persistencia de desconectados: permanent, session o forget.\n --disconnected-target {unconfirmed,all}\n Aplica la retención solo a CNF=X (unconfirmed) o a todos (all).\n --disconnected-scope {all,dhcp}\n Aplica la regla a toda la LAN (all) o solo al rango DHCP (dhcp).\n --workers WORKERS Concurrencia predeterminada de los escaneos.\n --timeout TIMEOUT Timeout predeterminado por operación de red.\n --scan-order {ascending,descending,random}\n Orden predeterminado de sondeo: ascending, descending o random.\n --max-hosts MAX_HOSTS Máximo de hosts autorizado por escaneo.\n --database ARCHIVO Ruta del inventario de elementos.\n --physical-database ARCHIVO\n Ruta de la base física SQLite administrada exclusivamente por\n LANWIRE.\n --groups ARCHIVO Ruta de la base de grupos.\n --log DIRECTORIO Directorio de registros.\n --error-log-level 1-59 Nivel mínimo de ErrorEvent escrito en el log (1 incluye diagnóstico\n detallado).\n --projects-directory DIRECTORIO\n Carpeta predeterminada para nombres de proyecto VLF relativos.\n -save-mode MODO, --save-mode MODO\n Política de guardado VLF. Usa 'list' para consultar las opciones\n integradas y las aportadas por plugins.\n -save-interval MINUTOS, --save-interval MINUTOS\n Intervalo de automatic.timeToSave en minutos (mínimo 0.1).\n --cli-exit-save-prompt {on,off}\n Consulta si se guarda al terminar cada comando individual de\n consola.\n --cli-command-chaining {on,off}\n Permite encadenar órdenes con ; dentro de la CLI interactiva.\n -log-cleanup {on,off}, --log-cleanup {on,off}\n Activa o desactiva la limpieza automática de logs antiguos.\n -log-retention-days DÍAS, --log-retention-days DÍAS\n Días durante los que se conservan los archivos de log.\n --remote-access {on,off} Activa el acceso SSH restringido.\n --remote-bind IP IPv4 local de escucha SSH.\n --remote-cidr CIDR Red de origen autorizada.\n --remote-port REMOTE_PORT Puerto del servidor SSH remoto.\n --remote-password-auth {on,off}\n Permite o bloquea autenticación SSH mediante contraseña.\n --remote-backend {service,user}\n Ejecuta el backend como servicio persistente o proceso de usuario.\n --remote-forced-view {off,gui,tui,plugins,projects,settings}\n Vista predeterminada para root forced-view.\n --tui-key ACCIÓN=TECLA Asigna una tecla a una acción del TUI. Puede repetirse.\n --tui-layout {cli.bottom,cli.top}\n Coloca el CLI arriba (cli.top) o abajo (cli.bottom).\n --tui-cli-percent 15-75 Porcentaje vertical reservado al CLI; ListElement conserva al menos\n 25%.\n --tui-column COLUMNA=TAMAÑO\n Peso de columna (GROUP=15%); IP=15ch y MAC=17ch son fijas.\n --tui-footer-buttons ACCIONES\n Acciones visibles en la barra inferior, separadas por comas; usa all\n para todas.\n --tui-footer-button ACCIÓN=on|off\n Muestra u oculta una acción concreta de la barra inferior. Puede\n repetirse.\n --menu Editor interactivo por categorías de programa y proyecto.\n --catalog Lista todos los ajustes por categorías, con valor y estado editable.\n --get RUTA Consulta un ajuste por su ruta, por ejemplo ip.workers.\n --set RUTA VALOR Modifica un ajuste; listas y booleanos usan JSON.\n --scope {program,project} Ámbito de configuración (predeterminado: program).\n --category CATEGORY Filtra el catálogo por categoría, por ejemplo network o monitor.", "docs": [ "CLI-REFERENCE.md", "CLI.md" @@ -1751,7 +1921,7 @@ window.LANCTL_REFERENCE = { "settings" ], "title": "LANIP settings", - "usage": "LANIP settings [-h] [-range CIDR] [-list-fields CAMPO [CAMPO ...]] [-dhcp-range INICIO-FIN]\n [-credentials ARCHIVO] [-discovery {icmp,arp,hybrid}]\n [--scan-profile {fast,normal,accurate}] [--progress {on,off}]\n [--service-identification {on,off}]\n [--disconnected-retention {permanent,session,forget}]\n [--disconnected-target {unconfirmed,all}] [--disconnected-scope {all,dhcp}]\n [--workers WORKERS] [--timeout TIMEOUT]\n [--scan-order {ascending,descending,random}] [--max-hosts MAX_HOSTS]\n [--database ARCHIVO] [--physical-database ARCHIVO] [--groups ARCHIVO]\n [--log DIRECTORIO] [--error-log-level 1-59]\n [--projects-directory DIRECTORIO] [-save-mode MODO] [-save-interval MINUTOS]\n [--cli-exit-save-prompt {on,off}] [--cli-command-chaining {on,off}]\n [-log-cleanup {on,off}] [-log-retention-days DÍAS]\n [--remote-access {on,off}] [--remote-bind IP] [--remote-cidr CIDR]\n [--remote-port REMOTE_PORT] [--remote-password-auth {on,off}]\n [--remote-backend {service,user}]\n [--remote-forced-view {off,gui,tui,plugins,projects,settings}]\n [--tui-key ACCIÓN=TECLA] [--tui-layout {cli.bottom,cli.top}]\n [--tui-cli-percent 15-75] [--tui-column COLUMNA=TAMAÑO]\n [--tui-footer-buttons ACCIONES] [--tui-footer-button ACCIÓN=on|off]" + "usage": "LANIP settings [-h] [--startup-interface {cli,tui,gui}] [--close-gui-on-launch {on,off}]\n [-range CIDR] [-list-fields CAMPO [CAMPO ...]] [-dhcp-range INICIO-FIN]\n [-credentials ARCHIVO] [-discovery {icmp,arp,hybrid}]\n [--scan-profile {fast,normal,accurate}] [--progress {on,off}]\n [--service-identification {on,off}]\n [--disconnected-retention {permanent,session,forget}]\n [--disconnected-target {unconfirmed,all}] [--disconnected-scope {all,dhcp}]\n [--workers WORKERS] [--timeout TIMEOUT]\n [--scan-order {ascending,descending,random}] [--max-hosts MAX_HOSTS]\n [--database ARCHIVO] [--physical-database ARCHIVO] [--groups ARCHIVO]\n [--log DIRECTORIO] [--error-log-level 1-59]\n [--projects-directory DIRECTORIO] [-save-mode MODO] [-save-interval MINUTOS]\n [--cli-exit-save-prompt {on,off}] [--cli-command-chaining {on,off}]\n [-log-cleanup {on,off}] [-log-retention-days DÍAS]\n [--remote-access {on,off}] [--remote-bind IP] [--remote-cidr CIDR]\n [--remote-port REMOTE_PORT] [--remote-password-auth {on,off}]\n [--remote-backend {service,user}]\n [--remote-forced-view {off,gui,tui,plugins,projects,settings}]\n [--tui-key ACCIÓN=TECLA] [--tui-layout {cli.bottom,cli.top}]\n [--tui-cli-percent 15-75] [--tui-column COLUMNA=TAMAÑO]\n [--tui-footer-buttons ACCIONES] [--tui-footer-button ACCIÓN=on|off]\n [--menu | --catalog | --get RUTA | --set RUTA VALOR]\n [--scope {program,project}] [--category CATEGORY]" }, { "aliases": [], @@ -1815,7 +1985,7 @@ window.LANCTL_REFERENCE = { "category": "Comandos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP call [-h]\n [-f {ip,cnf,mac,alias,name,group,description,manufacturer,default-name,device-id,protocols}]\n [--json] [--database DATABASE]\n selector", "details": "Usage: LANIP call [-h]\n [-f {ip,cnf,mac,alias,name,group,description,manufacturer,default-name,device-id,protocols}]\n [--json] [--database DATABASE]\n selector\n\nArguments:\n selector Alias, IP o MAC del dispositivo.\n\nOptions:\n -h, --help Show this help and exit.\n -f {ip,cnf,mac,alias,name,group,description,manufacturer,default-name,device-id,protocols}, --field {ip,cnf,mac,alias,name,group,description,manufacturer,default-name,device-id,protocols}\n Dato devuelto (por defecto: ip).\n --json Devuelve el registro completo como JSON.\n --database DATABASE Archivo JSON de elementos.", @@ -1876,7 +2046,7 @@ window.LANCTL_REFERENCE = { "category": "Inventario y búsqueda", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP search [-h] [--json] [--database DATABASE] selector", "details": "Usage: LANIP search [-h] [--json] [--database DATABASE] selector\n\nArguments:\n selector Alias, nombre, IP o MAC exactos.\n\nOptions:\n -h, --help Show this help and exit.\n --json Devuelve el registro completo como JSON para scripts.\n --database DATABASE Archivo JSON de elementos.", @@ -2003,7 +2173,7 @@ window.LANCTL_REFERENCE = { "category": "Descubrimiento de red", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Resuelve un elemento por IP, MAC o alias y comprueba identidad, disponibilidad y puertos TCP. No modifica el dispositivo.", "details": "Usage: LANIP scan [-h] [--ports LISTA] [--all-ports] [--timeout TIMEOUT] [--workers WORKERS]\n [--banners] [--identify] [--json] [--database DATABASE]\n selector\n\nResuelve un elemento por IP, MAC o alias y comprueba identidad, disponibilidad y puertos TCP. No modifica el dispositivo.\n\nArguments:\n selector IP, MAC o alias registrado en LANCTL.\n\nOptions:\n -h, --help Show this help and exit.\n --ports LISTA Puertos o rangos: 22,80,443,8000-8100 (por defecto: common).\n --all-ports Autoriza explícitamente el escaneo TCP 1-65535.\n --timeout TIMEOUT Tiempo máximo por conexión, en segundos.\n --workers WORKERS Número máximo de conexiones simultáneas.\n --banners Lee banners pasivos; no envía sondas específicas de protocolo.\n --identify Reconoce servicios y deduce el tipo de dispositivo con evidencias.\n --json Salida JSON.\n --database DATABASE Archivo JSON de elementos.", @@ -2062,7 +2232,7 @@ window.LANCTL_REFERENCE = { "category": "Comandos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP cnf [-h] [--database DATABASE] selector [value]", "details": "Usage: LANIP cnf [-h] [--database DATABASE] selector [value]\n\nArguments:\n selector IP, MAC o alias del elemento.\n value O (OK), X (UNKNOWN), - (UNRECOGNIZED), S (MARKED) o F (FIXED). Sin valor\n libera F y restaura O.\n\nOptions:\n -h, --help Show this help and exit.\n --database DATABASE Archivo JSON de elementos.", @@ -2157,7 +2327,7 @@ window.LANCTL_REFERENCE = { "category": "Acceso remoto", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP credential [-h] [-user USERNAME] [--database DATABASE] [--store STORE]\n selector [{set,list,delete}] [protocol]", "details": "Usage: LANIP credential [-h] [-user USERNAME] [--database DATABASE] [--store STORE]\n selector [{set,list,delete}] [protocol]\n\nArguments:\n selector IP, MAC o alias del elemento.\n {set,list,delete} Operación sobre la credencial.\n protocol Protocolo, por ejemplo tr-064.\n\nOptions:\n -h, --help Show this help and exit.\n -user USERNAME, --username USERNAME\n Nombre de usuario remoto.\n --database DATABASE Archivo JSON de elementos.\n --store STORE Almacén cifrado de credenciales.", @@ -2191,7 +2361,7 @@ window.LANCTL_REFERENCE = { "downloadSettings" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP GATEWAY [-h] ACCIÓN ...", "details": "Usage: LANIP GATEWAY [-h] ACCIÓN ...\n\nArguments:\n ACCIÓN\n downloadSettings (downloadsettings, download-settings)\n Descarga las opciones LAN y DHCP interesantes para configuración.\n\nOptions:\n -h, --help Show this help and exit.", @@ -2265,7 +2435,7 @@ window.LANCTL_REFERENCE = { "category": "Comandos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP GATEWAY downloadSettings [-h] [--port PORT] [--timeout TIMEOUT] [--database DATABASE]\n [--store STORE]", "details": "Usage: LANIP GATEWAY downloadSettings [-h] [--port PORT] [--timeout TIMEOUT] [--database DATABASE]\n [--store STORE]\n\nOptions:\n -h, --help Show this help and exit.\n --port PORT Puerto TR-064 del router.\n --timeout TIMEOUT Tiempo máximo de espera en segundos.\n --database DATABASE Archivo JSON de elementos.\n --store STORE Almacén cifrado de credenciales.", @@ -2349,7 +2519,7 @@ window.LANCTL_REFERENCE = { "category": "Comandos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP downloadSettings [-h] [--port PORT] [--timeout TIMEOUT] [--database DATABASE]\n [--store STORE]\n [gateway]", "details": "Usage: LANIP downloadSettings [-h] [--port PORT] [--timeout TIMEOUT] [--database DATABASE]\n [--store STORE]\n [gateway]\n\nArguments:\n gateway IP, MAC o alias del router.\n\nOptions:\n -h, --help Show this help and exit.\n --port PORT Puerto TR-064 del router.\n --timeout TIMEOUT Tiempo máximo de espera en segundos.\n --database DATABASE Archivo JSON de elementos.\n --store STORE Almacén cifrado de credenciales.", @@ -2478,7 +2648,7 @@ window.LANCTL_REFERENCE = { "category": "Acceso remoto", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP protocol [-h] [--port PORT] [--driver DRIVER] [--host-key HOST_KEY] [--kex KEX]\n [--profile {ssh_legacy_cisco_s300,ssh_esp32_rack_monitor}]\n [--database DATABASE]\n selector {show,configure} protocol", "details": "Usage: LANIP protocol [-h] [--port PORT] [--driver DRIVER] [--host-key HOST_KEY] [--kex KEX]\n [--profile {ssh_legacy_cisco_s300,ssh_esp32_rack_monitor}]\n [--database DATABASE]\n selector {show,configure} protocol\n\nArguments:\n selector IP, MAC o alias.\n {show,configure} Consulta o modifica el protocolo.\n protocol Protocolo que se configura.\n\nOptions:\n -h, --help Show this help and exit.\n --port PORT Puerto remoto.\n --driver DRIVER Controlador del dispositivo.\n --host-key HOST_KEY Algoritmo de clave de host permitido; se puede repetir.\n --kex KEX Algoritmo de intercambio de claves; se puede repetir.\n --profile {ssh_legacy_cisco_s300,ssh_esp32_rack_monitor}\n Perfil SSH reutilizable.\n --database DATABASE Archivo JSON de elementos.", @@ -2574,7 +2744,7 @@ window.LANCTL_REFERENCE = { "category": "Acceso remoto", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP ssh [-h] [--database DATABASE] [--store STORE] [--host HOST]\n selector {probe,fingerprint,trust,open,show} [COMANDO ...]", "details": "Usage: LANIP ssh [-h] [--database DATABASE] [--store STORE] [--host HOST]\n selector {probe,fingerprint,trust,open,show} [COMANDO ...]\n\nArguments:\n selector IP, MAC o alias.\n {probe,fingerprint,trust,open,show}\n Operación SSH.\n COMANDO Huella o comando remoto, según la operación.\n\nOptions:\n -h, --help Show this help and exit.\n --database DATABASE Archivo JSON de elementos.\n --store STORE Almacén cifrado de credenciales.\n --host HOST IP candidata para probe/fingerprint, sin modificar la base de datos.", @@ -2763,7 +2933,7 @@ window.LANCTL_REFERENCE = { "category": "Acceso remoto", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP radmin [-h] [--mode {control,view,file,shutdown,chat,voice,message,telnet}]\n [--port PORT] [--executable EXECUTABLE] [--through THROUGH] [--fullscreen]\n [--color-depth {24,16,8,4,2,1}] [--updates UPDATES] [--phonebook PHONEBOOK]\n [--phonebook-id PHONEBOOK_ID] [--database DATABASE] [--store STORE]\n selector {probe,configure,open}", "details": "Usage: LANIP radmin [-h] [--mode {control,view,file,shutdown,chat,voice,message,telnet}]\n [--port PORT] [--executable EXECUTABLE] [--through THROUGH] [--fullscreen]\n [--color-depth {24,16,8,4,2,1}] [--updates UPDATES] [--phonebook PHONEBOOK]\n [--phonebook-id PHONEBOOK_ID] [--database DATABASE] [--store STORE]\n selector {probe,configure,open}\n\nArguments:\n selector IP, MAC o alias del elemento.\n {probe,configure,open} Opción de configuración de Radmin Viewer.\n\nOptions:\n -h, --help Show this help and exit.\n --mode {control,view,file,shutdown,chat,voice,message,telnet}\n Opción de configuración de Radmin Viewer.\n --port PORT Opción de configuración de Radmin Viewer.\n --executable EXECUTABLE Ruta por dispositivo; usa 'auto' para detección automática.\n --through THROUGH Servidor intermedio HOST:PUERTO.\n --fullscreen Abre control o vista a pantalla completa.\n --color-depth {24,16,8,4,2,1}\n Profundidad de color de Radmin (1, 2, 4, 8, 16 o 24 bits).\n --updates UPDATES Máximo de actualizaciones de pantalla por segundo (1-120).\n --phonebook PHONEBOOK Phonebook .rpb administrado por Radmin.\n --phonebook-id PHONEBOOK_ID\n Identificador de entrada dentro del phonebook de Radmin.\n --database DATABASE Opción de configuración de Radmin Viewer.\n --store STORE Opción de configuración de Radmin Viewer.", @@ -3204,7 +3374,7 @@ window.LANCTL_REFERENCE = { "category": "Automatización", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP wol [-h] [-if CONDICIÓN] [--if-all CONDICIÓN] [--if-any CONDICIÓN]\n [--if-not CONDICIÓN] [-t SCHEDULE] [--message MESSAGE] [--force] [--cancel]\n [--broadcast BROADCAST] [--port PORT] [--repeat REPEAT] [--interval INTERVAL]\n [--wait WAIT] [--method {auto,arp,ping,port}] [--check-port CHECK_PORT]\n [--interface INTERFACE] [--retry RETRY] [--dry-run] [--json] [--quiet]\n [--group GROUP] [--all] [--yes] [--after AFTER] [--delay DELAY]\n [--timeout TIMEOUT] [--on-failure {stop,continue,retry}] [--cooldown COOLDOWN]\n [--max-attempts MAX_ATTEMPTS] [--power-transport {ssh,disabled}]\n [--power-platform {windows,linux}] [--power-command ACCIÓN=COMANDO]\n [--database DATABASE] [--store STORE] [--sequences SEQUENCES]\n [words ...]", "details": "Usage: LANIP wol [-h] [-if CONDICIÓN] [--if-all CONDICIÓN] [--if-any CONDICIÓN]\n [--if-not CONDICIÓN] [-t SCHEDULE] [--message MESSAGE] [--force] [--cancel]\n [--broadcast BROADCAST] [--port PORT] [--repeat REPEAT] [--interval INTERVAL]\n [--wait WAIT] [--method {auto,arp,ping,port}] [--check-port CHECK_PORT]\n [--interface INTERFACE] [--retry RETRY] [--dry-run] [--json] [--quiet]\n [--group GROUP] [--all] [--yes] [--after AFTER] [--delay DELAY]\n [--timeout TIMEOUT] [--on-failure {stop,continue,retry}] [--cooldown COOLDOWN]\n [--max-attempts MAX_ATTEMPTS] [--power-transport {ssh,disabled}]\n [--power-platform {windows,linux}] [--power-command ACCIÓN=COMANDO]\n [--database DATABASE] [--store STORE] [--sequences SEQUENCES]\n [words ...]\n\nArguments:\n words NAME [wakeup|status|shutdown|restart|sleep|hibernate|configure] o\n sequence ...\n\nOptions:\n -h, --help Show this help and exit.\n -if CONDICIÓN, --if CONDICIÓN\n Condición AND adicional (repetible).\n --if-all CONDICIÓN Condición AND adicional.\n --if-any CONDICIÓN Condición OR adicional.\n --if-not CONDICIÓN Condición negada.\n -t SCHEDULE, --time SCHEDULE\n Momento del apagado programado.\n --message MESSAGE Mensaje remoto, si el transporte lo admite.\n --force Solicita cierre forzado al transporte.\n --cancel Cancela una programación, si el transporte lo admite.\n --broadcast BROADCAST IPv4 de broadcast.\n --port PORT Puerto UDP WOL.\n --repeat REPEAT Número de paquetes mágicos.\n --interval INTERVAL Intervalo entre paquetes.\n --wait WAIT Segundos máximos de verificación.\n --method {auto,arp,ping,port}\n Método de verificación.\n --check-port CHECK_PORT Puerto TCP de comprobación.\n --interface INTERFACE IPv4 local de salida.\n --retry RETRY Reintentos completos.\n --dry-run Valida sin enviar.\n --json Salida JSON estructurada.\n --quiet Omite salida humana.\n --group GROUP Actúa sobre un grupo.\n --all Actúa sobre todo el inventario.\n --yes Confirma explícitamente --all.\n --after AFTER Dependencia de paso.\n --delay DELAY Espera previa del paso.\n --timeout TIMEOUT Timeout de paso.\n --on-failure {stop,continue,retry}\n Política ante fallo.\n --cooldown COOLDOWN Espera mínima entre ejecuciones.\n --max-attempts MAX_ATTEMPTS\n Máximo de intentos.\n --power-transport {ssh,disabled}\n Transporte autorizado para apagar o reiniciar.\n --power-platform {windows,linux}\n Sistema operativo remoto.\n --power-command ACCIÓN=COMANDO\n Plantilla administrada ACCIÓN=COMANDO.\n --database DATABASE Archivo JSON de elementos.\n --store STORE Almacén cifrado de credenciales.\n --sequences SEQUENCES Archivo transaccional de secuencias.", @@ -3390,7 +3560,7 @@ window.LANCTL_REFERENCE = { "category": "Datos y exportación", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP history [-h] [--all] [--commands] [--today] [--from FECHA] [--to FECHA]\n [--type TYPES] [--source SOURCE] [--result RESULT] [--errors]\n [--search SEARCH] [--limit LIMIT] [--reverse] [--format {table,json,csv}]\n [selector]", "details": "Usage: LANIP history [-h] [--all] [--commands] [--today] [--from FECHA] [--to FECHA]\n [--type TYPES] [--source SOURCE] [--result RESULT] [--errors]\n [--search SEARCH] [--limit LIMIT] [--reverse] [--format {table,json,csv}]\n [selector]\n\nArguments:\n selector DeviceId, alias, nombre, MAC, IP actual o histórica.\n\nOptions:\n -h, --help Show this help and exit.\n --all Incluye eventos generales de toda la LAN.\n --commands En CLI interactiva muestra los comandos de la sesión.\n --today Limita la consulta al día local actual.\n --from FECHA Fecha inicial YYYY-MM-DD.\n --to FECHA Fecha final YYYY-MM-DD.\n --type TYPES Tipo canónico; se puede repetir.\n --source SOURCE Filtra por origen.\n --result RESULT Filtra por resultado.\n --errors Muestra únicamente errores.\n --search SEARCH Busca texto seguro.\n --limit LIMIT Máximo de eventos (1..10000).\n --reverse Orden descendente.\n --format {table,json,csv} Formato de salida.", @@ -3769,7 +3939,7 @@ window.LANCTL_REFERENCE = { "category": "Monitorización", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP monitor [-h] [--project PROJECT] [--permanent] [--duration DURATION]\n [--mode {permanent,temporary,diagnostic,once}]\n [--authority {observe,operate,administer}] [--json] [--yes]\n [--interval INTERVAL] [--every EVERY] [--group GROUP]\n [--type {presence,services,ports,identity,smb,full}] [--fast] [--unknown]\n [--follow] [--sessions SESSIONS] [--incidents-store INCIDENTS_STORE]\n [--lock LOCK] [--monitor-db MONITOR_DB] [--profiles PROFILES]\n [--assignments-store ASSIGNMENTS_STORE] [--profile PROFILE]\n [--priority {low,normal,high,critical}] [--check CHECK] [--presence PRESENCE]\n [--discovery DISCOVERY] [--services SERVICES] [--deep DEEP]\n [--workers WORKERS] [--timeout TIMEOUT]\n [words ...]", "details": "Usage: LANIP monitor [-h] [--project PROJECT] [--permanent] [--duration DURATION]\n [--mode {permanent,temporary,diagnostic,once}]\n [--authority {observe,operate,administer}] [--json] [--yes]\n [--interval INTERVAL] [--every EVERY] [--group GROUP]\n [--type {presence,services,ports,identity,smb,full}] [--fast] [--unknown]\n [--follow] [--sessions SESSIONS] [--incidents-store INCIDENTS_STORE]\n [--lock LOCK] [--monitor-db MONITOR_DB] [--profiles PROFILES]\n [--assignments-store ASSIGNMENTS_STORE] [--profile PROFILE]\n [--priority {low,normal,high,critical}] [--check CHECK] [--presence PRESENCE]\n [--discovery DISCOVERY] [--services SERVICES] [--deep DEEP]\n [--workers WORKERS] [--timeout TIMEOUT]\n [words ...]\n\nArguments:\n words attach, detach, status, once, session, incidents, incident, service\n o foreground.\n\nOptions:\n -h, --help Show this help and exit.\n --project PROJECT Opción operativa del monitor.\n --permanent Opción operativa del monitor.\n --duration DURATION Opción operativa del monitor.\n --mode {permanent,temporary,diagnostic,once}\n Opción operativa del monitor.\n --authority {observe,operate,administer}\n Opción operativa del monitor.\n --json Opción operativa del monitor.\n --yes Opción operativa del monitor.\n --interval INTERVAL Opción operativa del monitor.\n --every EVERY Opción operativa del monitor.\n --group GROUP Opción operativa del monitor.\n --type {presence,services,ports,identity,smb,full}\n Opción operativa del monitor.\n --fast Opción operativa del monitor.\n --unknown Opción operativa del monitor.\n --follow Opción operativa del monitor.\n --sessions SESSIONS Estado runtime de sesiones.\n --incidents-store INCIDENTS_STORE\n Estado runtime de incidencias.\n --lock LOCK Lock singleton del monitor.\n --monitor-db MONITOR_DB Repositorio SQLite del monitor.\n --profiles PROFILES Perfiles personalizados.\n --assignments-store ASSIGNMENTS_STORE\n Asignaciones persistentes.\n --profile PROFILE Perfil monitor.\n --priority {low,normal,high,critical}\n Prioridad de asignación.\n --check CHECK Check ping, arp o port:NN.\n --presence PRESENCE Intervalo de presencia.\n --discovery DISCOVERY Intervalo de descubrimiento.\n --services SERVICES Intervalo de servicios.\n --deep DEEP Intervalo profundo.\n --workers WORKERS Workers del perfil.\n --timeout TIMEOUT Timeout del perfil.", @@ -3991,7 +4161,7 @@ window.LANCTL_REFERENCE = { "category": "Acceso remoto", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP access [-h] [--bind BIND] [--cidr CIDR] [--port PORT] [--password-auth {on,off}]\n [--role ROLE] [--ssh-key SSH_KEY] [--expires EXPIRES]\n [--permission PERMISSION] [--certificate CERTIFICATE]\n [--private-key PRIVATE_KEY] [--common-name COMMON_NAME] [--yes] [--json]\n [--scope {user,service}] [--config CONFIG] [--users USERS]\n [words ...]", "details": "Usage: LANIP access [-h] [--bind BIND] [--cidr CIDR] [--port PORT] [--password-auth {on,off}]\n [--role ROLE] [--ssh-key SSH_KEY] [--expires EXPIRES]\n [--permission PERMISSION] [--certificate CERTIFICATE]\n [--private-key PRIVATE_KEY] [--common-name COMMON_NAME] [--yes] [--json]\n [--scope {user,service}] [--config CONFIG] [--users USERS]\n [words ...]\n\nArguments:\n words init, status, enable, disable, configure, user, role, session, web o\n certificate.\n\nOptions:\n -h, --help Show this help and exit.\n --bind BIND Opción de acceso remoto.\n --cidr CIDR Opción de acceso remoto.\n --port PORT Opción de acceso remoto.\n --password-auth {on,off} Opción de acceso remoto.\n --role ROLE Opción de acceso remoto.\n --ssh-key SSH_KEY Opción de acceso remoto.\n --expires EXPIRES Opción de acceso remoto.\n --permission PERMISSION Opción de acceso remoto.\n --certificate CERTIFICATE Opción de acceso remoto.\n --private-key PRIVATE_KEY Opción de acceso remoto.\n --common-name COMMON_NAME Opción de acceso remoto.\n --yes Opción de acceso remoto.\n --json Opción de acceso remoto.\n --scope {user,service} Separa credenciales del usuario y del servicio permanente.\n --config CONFIG Configuración remota separada.\n --users USERS Almacén de usuarios remotos.", @@ -4193,7 +4363,7 @@ window.LANCTL_REFERENCE = { "category": "Acceso remoto", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP smb [-h] [--network] [--group GROUP] [--timeout TIMEOUT] [--workers WORKERS]\n [--anonymous] [--include-system] [--dry-run] [--yes] [--json]\n [--database DATABASE] [--store STORE] [--storage STORAGE]\n [name] [action] [resource] [{open,queue,connect}]", "details": "Usage: LANIP smb [-h] [--network] [--group GROUP] [--timeout TIMEOUT] [--workers WORKERS]\n [--anonymous] [--include-system] [--dry-run] [--yes] [--json]\n [--database DATABASE] [--store STORE] [--storage STORAGE]\n [name] [action] [resource] [{open,queue,connect}]\n\nArguments:\n name Servidor/dispositivo (sin acción equivale a info).\n action scan, info, shares, open, printers, workgroups, connect, disconnect,\n status o printer.\n resource Carpeta o impresora compartida.\n {open,queue,connect} Acción sobre la impresora.\n\nOptions:\n -h, --help Show this help and exit.\n --network Examina todo el inventario LANCTL.\n --group GROUP Limita el escaneo a un grupo LANCTL.\n --timeout TIMEOUT Tiempo máximo del probe TCP.\n --workers WORKERS Número máximo de probes concurrentes.\n --anonymous No carga credenciales asociadas.\n --include-system Incluye recursos administrativos y especiales.\n --dry-run Muestra el plan sin autenticar, abrir ni mutar.\n --yes Confirma una conexión de impresora.\n --json Emite JSON estructurado.\n --database DATABASE Archivo JSON del inventario.\n --store STORE Almacén DPAPI de credenciales.\n --storage STORAGE Directorio de observaciones de plugins.", @@ -4277,7 +4447,7 @@ window.LANCTL_REFERENCE = { "category": "Acceso remoto", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP terminal [-h] [-p PROTOCOL] [--native] [--database DATABASE] [--store STORE] selector", "details": "Usage: LANIP terminal [-h] [-p PROTOCOL] [--native] [--database DATABASE] [--store STORE] selector\n\nArguments:\n selector IP, MAC o alias del elemento.\n\nOptions:\n -h, --help Show this help and exit.\n -p PROTOCOL, --protocol PROTOCOL\n Protocolo si hay varias terminales.\n --native Usa el cliente SSH nativo sin la capa de color de LANCTL.\n --database DATABASE Archivo JSON de elementos.\n --store STORE Almacén cifrado de credenciales.", @@ -4380,7 +4550,7 @@ window.LANCTL_REFERENCE = { "category": "Infraestructura de red", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Comandos Cisco gestionados:\n show COMANDO\n port list\n port label PUERTO NOMBRE\n port unlabel PUERTO\n port show [PUERTO] status|description|config|errors|vlan\n port set [PUERTO] description|speed|duplex VALOR\n port enable|disable|reset [PUERTO]\n start|stop|reset [PUERTO]\n save-config\n terminal\n\nOpciones globales: --profile PERFIL --dry-run --yes\nEsta fase utiliza un adaptador simulado y no conecta con el switch.", "details": "Usage: LANIP switch [-h] [--profile PROFILE] [--profiles PROFILES] [--database DATABASE]\n [--dry-run] [--yes]\n selector ...\n\nComandos Cisco gestionados:\n show COMANDO\n port list\n port label PUERTO NOMBRE\n port unlabel PUERTO\n port show [PUERTO] status|description|config|errors|vlan\n port set [PUERTO] description|speed|duplex VALOR\n port enable|disable|reset [PUERTO]\n start|stop|reset [PUERTO]\n save-config\n terminal\n\nOpciones globales: --profile PERFIL --dry-run --yes\nEsta fase utiliza un adaptador simulado y no conecta con el switch.\n\nArguments:\n selector IP, MAC o alias del switch.\n COMANDO Acción Cisco gestionada que se quiere planificar.\n\nOptions:\n -h, --help Show this help and exit.\n --profile PROFILE Perfil Cisco que remapea los puertos.\n --profiles PROFILES Archivo JSON que contiene los perfiles Cisco.\n --database DATABASE Archivo JSON de elementos.\n --dry-run Solo muestra el plan.\n --yes Confirma cambios sin preguntar.", @@ -4518,7 +4688,7 @@ window.LANCTL_REFERENCE = { "category": "Grupos de comandos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP group [-h]\n [-new | -del | -rename NUEVO | -description TEXTO | -add ELEMENTO | -remove ELEMENTO | -list]\n [--database DATABASE] [--groups GROUPS]\n [name]", "details": "Usage: LANIP group [-h]\n [-new | -del | -rename NUEVO | -description TEXTO | -add ELEMENTO | -remove ELEMENTO | -list]\n [--database DATABASE] [--groups GROUPS]\n [name]\n\nArguments:\n name Nombre del grupo.\n\nOptions:\n -h, --help Show this help and exit.\n -new Crea el grupo.\n -del Elimina el grupo.\n -rename NUEVO Renombra el grupo.\n -description TEXTO Edita su descripción.\n -add ELEMENTO Añade IP, MAC o alias.\n -remove ELEMENTO Retira IP, MAC o alias.\n -list Lista los elementos que pertenecen al grupo.\n --database DATABASE Archivo JSON de elementos.\n --groups GROUPS Archivo JSON de grupos.", @@ -4634,7 +4804,7 @@ window.LANCTL_REFERENCE = { { "choices": [], "default": null, - "description": "Asigna DESCRIPTION al elemento indicado (máximo 42 caracteres).", + "description": "Asigna DESCRIPTION al elemento indicado.", "flags": [ "-description", "--description" @@ -4740,10 +4910,10 @@ window.LANCTL_REFERENCE = { "category": "Inventario y edición", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP element [-h] [-add MAC] [-name NEW_NAME] [-ip NEW_IP] [-alias NEW_ALIAS]\n [-description NEW_DESCRIPTION] [-cnf NEW_CNF] [-idf NEW_IDF]\n [-group NEW_GROUP] [-protocol NEW_PROTOCOL] [-delete] [--database DATABASE]\n [--groups GROUPS] [--yes]\n [selector]\n [{edit,ip,cnf,name,description,alias,idf,group,protocol,delete,del,remove}]\n [values ...]", - "details": "Usage: LANIP element [-h] [-add MAC] [-name NEW_NAME] [-ip NEW_IP] [-alias NEW_ALIAS]\n [-description NEW_DESCRIPTION] [-cnf NEW_CNF] [-idf NEW_IDF]\n [-group NEW_GROUP] [-protocol NEW_PROTOCOL] [-delete] [--database DATABASE]\n [--groups GROUPS] [--yes]\n [selector]\n [{edit,ip,cnf,name,description,alias,idf,group,protocol,delete,del,remove}]\n [values ...]\n\nArguments:\n selector IP, MAC o alias.\n {edit,ip,cnf,name,description,alias,idf,group,protocol,delete,del,remove}\n Campo o acción que se quiere editar.\n values Nuevo valor.\n\nOptions:\n -h, --help Show this help and exit.\n -add MAC Añade un elemento nuevo utilizando su dirección MAC.\n -name NEW_NAME, --name NEW_NAME\n Asigna NAME al elemento indicado.\n -ip NEW_IP, --ip NEW_IP Asigna una dirección IPv4.\n -alias NEW_ALIAS, --alias NEW_ALIAS\n Asigna ALIAS al elemento indicado.\n -description NEW_DESCRIPTION, --description NEW_DESCRIPTION\n Asigna DESCRIPTION al elemento indicado (máximo 42 caracteres).\n -cnf NEW_CNF, --cnf NEW_CNF\n Asigna el estado CNF.\n -idf NEW_IDF, --idf NEW_IDF\n Asigna un IDF único (2-5 letras y 2-5 dígitos).\n -group NEW_GROUP, --group NEW_GROUP\n Añade el elemento al grupo.\n -protocol NEW_PROTOCOL, --protocol NEW_PROTOCOL\n Activa un protocolo.\n -delete, --delete Elimina completamente el elemento indicado.\n --database DATABASE Archivo JSON de elementos.\n --groups GROUPS Archivo JSON de grupos.\n --yes Elimina sin solicitar confirmación.", + "details": "Usage: LANIP element [-h] [-add MAC] [-name NEW_NAME] [-ip NEW_IP] [-alias NEW_ALIAS]\n [-description NEW_DESCRIPTION] [-cnf NEW_CNF] [-idf NEW_IDF]\n [-group NEW_GROUP] [-protocol NEW_PROTOCOL] [-delete] [--database DATABASE]\n [--groups GROUPS] [--yes]\n [selector]\n [{edit,ip,cnf,name,description,alias,idf,group,protocol,delete,del,remove}]\n [values ...]\n\nArguments:\n selector IP, MAC o alias.\n {edit,ip,cnf,name,description,alias,idf,group,protocol,delete,del,remove}\n Campo o acción que se quiere editar.\n values Nuevo valor.\n\nOptions:\n -h, --help Show this help and exit.\n -add MAC Añade un elemento nuevo utilizando su dirección MAC.\n -name NEW_NAME, --name NEW_NAME\n Asigna NAME al elemento indicado.\n -ip NEW_IP, --ip NEW_IP Asigna una dirección IPv4.\n -alias NEW_ALIAS, --alias NEW_ALIAS\n Asigna ALIAS al elemento indicado.\n -description NEW_DESCRIPTION, --description NEW_DESCRIPTION\n Asigna DESCRIPTION al elemento indicado.\n -cnf NEW_CNF, --cnf NEW_CNF\n Asigna el estado CNF.\n -idf NEW_IDF, --idf NEW_IDF\n Asigna un IDF único (2-5 letras y 2-5 dígitos).\n -group NEW_GROUP, --group NEW_GROUP\n Añade el elemento al grupo.\n -protocol NEW_PROTOCOL, --protocol NEW_PROTOCOL\n Activa un protocolo.\n -delete, --delete Elimina completamente el elemento indicado.\n --database DATABASE Archivo JSON de elementos.\n --groups GROUPS Archivo JSON de grupos.\n --yes Elimina sin solicitar confirmación.", "docs": [ "CLI-REFERENCE.md", "CLI.md" @@ -4778,7 +4948,7 @@ window.LANCTL_REFERENCE = { "list" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP project [-h] ACCIÓN ...", "details": "Usage: LANIP project [-h] ACCIÓN ...\n\nArguments:\n ACCIÓN\n status Muestra el proyecto activo.\n create Crea un proyecto VLF vacío por defecto.\n update Actualiza datos activos conservando información complementaria.\n save Guarda manualmente el proyecto VLF activo.\n info Muestra los metadatos del proyecto.\n verify Comprueba hashes, estructura y SQLite.\n use Selecciona el proyecto VLF que recibirá la auditoría.\n list Lista el contenido interno sin extraerlo.\n\nOptions:\n -h, --help Show this help and exit.", @@ -4822,7 +4992,7 @@ window.LANCTL_REFERENCE = { "category": "Proyectos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP project status [-h] [--json]", "details": "Usage: LANIP project status [-h] [--json]\n\nOptions:\n -h, --help Show this help and exit.\n --json Devuelve JSON.", @@ -4974,7 +5144,7 @@ window.LANCTL_REFERENCE = { "category": "Proyectos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP project create [-h] [--name NAME] [--description DESCRIPTION] [--author AUTHOR]\n [--lan-name LAN_NAME] [--location LOCATION] [--company COMPANY]\n [--responsible RESPONSIBLE] [--clone-current] [--force]\n file", "details": "Usage: LANIP project create [-h] [--name NAME] [--description DESCRIPTION] [--author AUTHOR]\n [--lan-name LAN_NAME] [--location LOCATION] [--company COMPANY]\n [--responsible RESPONSIBLE] [--clone-current] [--force]\n file\n\nArguments:\n file Archivo de salida; se añade .vlf si falta.\n\nOptions:\n -h, --help Show this help and exit.\n --name NAME Nombre humano del proyecto.\n --description DESCRIPTION Descripción general.\n --author AUTHOR Autor del proyecto.\n --lan-name LAN_NAME Nombre humano de la LAN.\n --location LOCATION Ubicación física.\n --company COMPANY Empresa u organización.\n --responsible RESPONSIBLE Responsable de la LAN.\n --clone-current Crea el proyecto copiando explícitamente el inventario y grupos\n activos.\n --force Sobrescribe un VLF existente.", @@ -5016,7 +5186,7 @@ window.LANCTL_REFERENCE = { "category": "Proyectos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP project update [-h] file", "details": "Usage: LANIP project update [-h] file\n\nArguments:\n file Proyecto VLF existente.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5048,7 +5218,7 @@ window.LANCTL_REFERENCE = { "category": "Proyectos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP project save [-h]", "details": "Usage: LANIP project save [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -5101,7 +5271,7 @@ window.LANCTL_REFERENCE = { "category": "Proyectos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP project info [-h] [--json] file", "details": "Usage: LANIP project info [-h] [--json] file\n\nArguments:\n file Proyecto VLF.\n\nOptions:\n -h, --help Show this help and exit.\n --json Devuelve JSON.", @@ -5154,7 +5324,7 @@ window.LANCTL_REFERENCE = { "category": "Proyectos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP project verify [-h] [--json] file", "details": "Usage: LANIP project verify [-h] [--json] file\n\nArguments:\n file Proyecto VLF.\n\nOptions:\n -h, --help Show this help and exit.\n --json Devuelve JSON.", @@ -5196,7 +5366,7 @@ window.LANCTL_REFERENCE = { "category": "Proyectos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP project use [-h] file", "details": "Usage: LANIP project use [-h] file\n\nArguments:\n file Proyecto VLF existente.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5238,7 +5408,7 @@ window.LANCTL_REFERENCE = { "category": "Proyectos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP project list [-h] file", "details": "Usage: LANIP project list [-h] file\n\nArguments:\n file Proyecto VLF.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5285,7 +5455,7 @@ window.LANCTL_REFERENCE = { "pack" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin [-h] ACCIÓN ...", "details": "Usage: LANIP plugin [-h] ACCIÓN ...\n\nArguments:\n ACCIÓN\n list Lista complementos instalados.\n catalog Muestra el catálogo oficial incluido.\n info Muestra manifiesto, permisos y estado.\n install Verifica e instala un paquete .lcp desactivado.\n enable Concede permisos y activa un complemento.\n disable Desactiva el complemento.\n reload Recarga un complemento activo.\n uninstall Desinstala el complemento.\n verify Verifica un .lcp o plugin instalado.\n permissions\n Muestra permisos solicitados y concedidos.\n revoke Revoca permisos y confianza de un complemento.\n publisher Gestiona huellas Ed25519 de editores LCP confiables.\n extensions\n Lista extensiones para CLI, TUI y futura GUI.\n pack Construye un paquete .lcp desde un directorio.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5317,7 +5487,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin list [-h]", "details": "Usage: LANIP plugin list [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -5349,7 +5519,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin catalog [-h]", "details": "Usage: LANIP plugin catalog [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -5391,7 +5561,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin info [-h] plugin_id", "details": "Usage: LANIP plugin info [-h] plugin_id\n\nArguments:\n plugin_id Identificador estable del complemento.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5433,7 +5603,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin install [-h] file", "details": "Usage: LANIP plugin install [-h] file\n\nArguments:\n file Archivo de paquete con extensión .lcp.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5508,7 +5678,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin enable [-h] [--grant [PERMISO ...]] [--grant-all] [--trust] plugin_id", "details": "Usage: LANIP plugin enable [-h] [--grant [PERMISO ...]] [--grant-all] [--trust] plugin_id\n\nArguments:\n plugin_id Identificador del complemento instalado.\n\nOptions:\n -h, --help Show this help and exit.\n --grant [PERMISO ...] Permisos concretos que se conceden.\n --grant-all Concede todos los permisos solicitados.\n --trust Autoriza código trusted dentro del proceso.", @@ -5550,7 +5720,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin disable [-h] plugin_id", "details": "Usage: LANIP plugin disable [-h] plugin_id\n\nArguments:\n plugin_id Identificador del complemento instalado.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5592,7 +5762,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin reload [-h] plugin_id", "details": "Usage: LANIP plugin reload [-h] plugin_id\n\nArguments:\n plugin_id Identificador del complemento instalado.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5634,7 +5804,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin uninstall [-h] plugin_id", "details": "Usage: LANIP plugin uninstall [-h] plugin_id\n\nArguments:\n plugin_id Identificador del complemento instalado.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5676,7 +5846,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin verify [-h] target", "details": "Usage: LANIP plugin verify [-h] target\n\nArguments:\n target Identificador instalado o ruta de un archivo .lcp.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5718,7 +5888,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin permissions [-h] plugin_id", "details": "Usage: LANIP plugin permissions [-h] plugin_id\n\nArguments:\n plugin_id Identificador del complemento instalado.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5769,7 +5939,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin revoke [-h] plugin_id [PERMISO ...]", "details": "Usage: LANIP plugin revoke [-h] plugin_id [PERMISO ...]\n\nArguments:\n plugin_id Identificador del complemento instalado.\n PERMISO Vacío revoca todos los permisos.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5805,7 +5975,7 @@ window.LANCTL_REFERENCE = { "revoke" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin publisher [-h] ACCIÓN ...", "details": "Usage: LANIP plugin publisher [-h] ACCIÓN ...\n\nArguments:\n ACCIÓN\n list Lista editores confiables.\n trust Confía en la firma que contiene un paquete LCP.\n revoke Revoca una huella de editor.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5837,7 +6007,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin publisher list [-h]", "details": "Usage: LANIP plugin publisher list [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -5891,7 +6061,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin publisher trust [-h] [--name NAME] file", "details": "Usage: LANIP plugin publisher trust [-h] [--name NAME] file\n\nArguments:\n file Paquete .lcp firmado y verificado.\n\nOptions:\n -h, --help Show this help and exit.\n --name NAME Nombre descriptivo del editor.", @@ -5934,7 +6104,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin publisher revoke [-h] fingerprint", "details": "Usage: LANIP plugin publisher revoke [-h] fingerprint\n\nArguments:\n fingerprint Huella SHA-256 Ed25519 completa.\n\nOptions:\n -h, --help Show this help and exit.", @@ -5979,7 +6149,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin extensions [-h] [--type TYPE]", "details": "Usage: LANIP plugin extensions [-h] [--type TYPE]\n\nOptions:\n -h, --help Show this help and exit.\n --type TYPE Filtra por tipo de extensión unificada.", @@ -6052,7 +6222,7 @@ window.LANCTL_REFERENCE = { "category": "Plugins y expansiones", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP plugin pack [-h] [--force] [--signing-key SIGNING_KEY] directory output", "details": "Usage: LANIP plugin pack [-h] [--force] [--signing-key SIGNING_KEY] directory output\n\nArguments:\n directory Directorio fuente que contiene plugin.info.\n output Archivo .lcp de salida.\n\nOptions:\n -h, --help Show this help and exit.\n --force Sobrescribe el paquete de salida existente.\n --signing-key SIGNING_KEY Clave privada Ed25519 PEM para firmar el LCP.", @@ -6091,7 +6261,7 @@ window.LANCTL_REFERENCE = { "export" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP language [-h] ACTION ...", "details": "Usage: LANIP language [-h] ACTION ...\n\nArguments:\n ACTION\n list List installed languages.\n use Select the interface language.\n info Show language metadata and coverage.\n install Install or update a .lang JSON catalog.\n validate Validate a .lang catalog.\n export Export the English template for translation.\n\nOptions:\n -h, --help Show this help and exit.", @@ -6120,7 +6290,7 @@ window.LANCTL_REFERENCE = { "category": "Configuración", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP language list [-h]", "details": "Usage: LANIP language list [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -6160,7 +6330,7 @@ window.LANCTL_REFERENCE = { "category": "Configuración", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP language use [-h] language", "details": "Usage: LANIP language use [-h] language\n\nArguments:\n language Language code or name, for example en or Español.\n\nOptions:\n -h, --help Show this help and exit.", @@ -6200,7 +6370,7 @@ window.LANCTL_REFERENCE = { "category": "Configuración", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP language info [-h] [language]", "details": "Usage: LANIP language info [-h] [language]\n\nArguments:\n language Language code or name; active language by default.\n\nOptions:\n -h, --help Show this help and exit.", @@ -6240,7 +6410,7 @@ window.LANCTL_REFERENCE = { "category": "Configuración", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP language install [-h] file", "details": "Usage: LANIP language install [-h] file\n\nArguments:\n file Language catalog with .lang extension.\n\nOptions:\n -h, --help Show this help and exit.", @@ -6280,7 +6450,7 @@ window.LANCTL_REFERENCE = { "category": "Configuración", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP language validate [-h] file", "details": "Usage: LANIP language validate [-h] file\n\nArguments:\n file Language catalog with .lang extension.\n\nOptions:\n -h, --help Show this help and exit.", @@ -6320,7 +6490,7 @@ window.LANCTL_REFERENCE = { "category": "Configuración", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP language export [-h] file", "details": "Usage: LANIP language export [-h] file\n\nArguments:\n file Destination .lang file.\n\nOptions:\n -h, --help Show this help and exit.", @@ -6371,7 +6541,7 @@ window.LANCTL_REFERENCE = { "category": "Comandos", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP error [-h] [--json] 0eXXXXXXXX", "details": "Usage: LANIP error [-h] [--json] 0eXXXXXXXX\n\nArguments:\n 0eXXXXXXXX Identificador estable del error.\n\nOptions:\n -h, --help Show this help and exit.\n --json Emite el resultado como JSON.", @@ -6493,7 +6663,7 @@ window.LANCTL_REFERENCE = { "category": "Datos y exportación", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP database [-h]\n (--diagnose | --export ARCHIVO.zip | --verify ARCHIVO.zip | --import ARCHIVO.zip | --restore ARCHIVO.bak)\n [--target {database,groups,physical}] [--yes] [--json]", "details": "Usage: LANIP database [-h]\n (--diagnose | --export ARCHIVO.zip | --verify ARCHIVO.zip | --import ARCHIVO.zip | --restore ARCHIVO.bak)\n [--target {database,groups,physical}] [--yes] [--json]\n\nOptions:\n -h, --help Show this help and exit.\n --diagnose Valida los almacenes configurados.\n --export ARCHIVO.zip Exporta datos con hashes verificables.\n --verify ARCHIVO.zip Verifica una exportación sin importarla.\n --import ARCHIVO.zip Importa datos verificados.\n --restore ARCHIVO.bak Restaura un backup validado del almacén.\n --target {database,groups,physical}\n Almacén que se restaura.\n --yes Confirma la sustitución de datos.\n --json Emite el diagnóstico como JSON.", @@ -6560,7 +6730,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Crea inventario, proyecto VLF, evidencias, monitorización y un informe de demostración aislados de los datos del usuario.", "details": "Usage: LANIP demo [-h] [--output DIRECTORIO] [--force] [--format {json,html,all}]\n\nCrea inventario, proyecto VLF, evidencias, monitorización y un informe de demostración aislados de los datos del usuario.\n\nOptions:\n -h, --help Show this help and exit.\n --output DIRECTORIO Directorio donde se guardará el proyecto y el informe.\n --force Reemplaza una demo anterior.\n --format {json,html,all} Formato del informe exportado.", @@ -6655,7 +6825,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lanwire [-h] [--new-window] [--version] [--database ARCHIVO.db] [-tui | --cli] ...", "details": "Usage: LANIP lanwire [-h] [--new-window] [--version] [--database ARCHIVO.db] [-tui | --cli] ...\n\nArguments:\n ARGUMENTO Argumentos enviados a LANWIRE, por ejemplo: list.\n\nOptions:\n -h, --help Show this help and exit.\n --new-window Abre LANWIRE en una consola independiente incluso si se indican\n argumentos.\n --version Muestra la versión común de LANWIRE y termina.\n --database ARCHIVO.db Selecciona una base física IDF alternativa.\n -tui, --tui Abre la interfaz TUI de LANWIRE.\n --cli Abre la consola interactiva de LANWIRE.", @@ -6696,7 +6866,7 @@ window.LANCTL_REFERENCE = { "evolve" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab [-h] ACCIÓN ...", "details": "Usage: LANIP lab [-h] ACCIÓN ...\n\nArguments:\n ACCIÓN\n generate Genera un escenario reproducible.\n list Lista escenarios.\n status Muestra el escenario activo.\n stop Desactiva el proveedor simulado.\n start Activa explícitamente un escenario virtual.\n validate Valida un escenario.\n export Exporta un escenario.\n import Importa un escenario JSON.\n network Crea manualmente una red virtual.\n device Edita dispositivos simulados.\n evolve Avanza el reloj y aplica eventos pendientes.\n\nOptions:\n -h, --help Show this help and exit.", @@ -6824,7 +6994,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab generate [-h] [--name NAME] [--cidr CIDR]\n [--profile {home,office,datacenter,industrial,chaotic}]\n [--devices DEVICES] [--seed SEED] [--active-percent ACTIVE_PERCENT]\n [--dhcp-percent DHCP_PERCENT] [--type {snapshot,timeline,chaos}]", "details": "Usage: LANIP lab generate [-h] [--name NAME] [--cidr CIDR]\n [--profile {home,office,datacenter,industrial,chaotic}]\n [--devices DEVICES] [--seed SEED] [--active-percent ACTIVE_PERCENT]\n [--dhcp-percent DHCP_PERCENT] [--type {snapshot,timeline,chaos}]\n\nOptions:\n -h, --help Show this help and exit.\n --name NAME Nombre del escenario.\n --cidr CIDR Red IPv4 virtual.\n --profile {home,office,datacenter,industrial,chaotic}\n Perfil de dispositivos.\n --devices DEVICES Cantidad de dispositivos.\n --seed SEED Semilla reproducible.\n --active-percent ACTIVE_PERCENT\n Porcentaje activo.\n --dhcp-percent DHCP_PERCENT\n Porcentaje DHCP.\n --type {snapshot,timeline,chaos}\n Evolución del escenario.", @@ -6854,7 +7024,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab list [-h]", "details": "Usage: LANIP lab list [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -6884,7 +7054,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab status [-h]", "details": "Usage: LANIP lab status [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -6914,7 +7084,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab stop [-h]", "details": "Usage: LANIP lab stop [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -6954,7 +7124,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab start [-h] scenario", "details": "Usage: LANIP lab start [-h] scenario\n\nArguments:\n scenario Nombre del escenario.\n\nOptions:\n -h, --help Show this help and exit.", @@ -6994,7 +7164,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab validate [-h] scenario", "details": "Usage: LANIP lab validate [-h] scenario\n\nArguments:\n scenario Nombre del escenario.\n\nOptions:\n -h, --help Show this help and exit.", @@ -7059,7 +7229,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab export [-h] [--format {json,csv}] [--output OUTPUT] scenario", "details": "Usage: LANIP lab export [-h] [--format {json,csv}] [--output OUTPUT] scenario\n\nArguments:\n scenario Nombre del escenario.\n\nOptions:\n -h, --help Show this help and exit.\n --format {json,csv} Formato de salida.\n --output OUTPUT Archivo de destino; stdout si se omite.", @@ -7099,7 +7269,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab import [-h] file", "details": "Usage: LANIP lab import [-h] file\n\nArguments:\n file Archivo JSON.\n\nOptions:\n -h, --help Show this help and exit.", @@ -7131,7 +7301,7 @@ window.LANCTL_REFERENCE = { "create" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab network [-h] {create} ...", "details": "Usage: LANIP lab network [-h] {create} ...\n\nArguments:\n {create}\n create Crea un escenario vacío.\n\nOptions:\n -h, --help Show this help and exit.", @@ -7184,7 +7354,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab network create [-h] --name NAME [--cidr CIDR]", "details": "Usage: LANIP lab network create [-h] --name NAME [--cidr CIDR]\n\nOptions:\n -h, --help Show this help and exit.\n --name NAME Nombre del escenario.\n --cidr CIDR CIDR virtual.", @@ -7218,7 +7388,7 @@ window.LANCTL_REFERENCE = { "delete" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab device [-h] {add,delete} ...", "details": "Usage: LANIP lab device [-h] {add,delete} ...\n\nArguments:\n {add,delete}\n add Añade un dispositivo.\n delete Elimina un dispositivo.\n\nOptions:\n -h, --help Show this help and exit.", @@ -7313,7 +7483,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab device add [-h] --ip IP --mac MAC [--alias ALIAS] [--name NAME] [--inactive]\n scenario", "details": "Usage: LANIP lab device add [-h] --ip IP --mac MAC [--alias ALIAS] [--name NAME] [--inactive]\n scenario\n\nArguments:\n scenario Escenario.\n\nOptions:\n -h, --help Show this help and exit.\n --ip IP IPv4 simulada.\n --mac MAC MAC simulada.\n --alias ALIAS Alias.\n --name NAME Nombre.\n --inactive Lo crea inactivo.", @@ -7363,7 +7533,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab device delete [-h] scenario device", "details": "Usage: LANIP lab device delete [-h] scenario device\n\nArguments:\n scenario Escenario.\n device ID, IP, MAC o alias.\n\nOptions:\n -h, --help Show this help and exit.", @@ -7406,7 +7576,7 @@ window.LANCTL_REFERENCE = { "category": "Laboratorio virtual", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANIP lab evolve [-h] --seconds SECONDS", "details": "Usage: LANIP lab evolve [-h] --seconds SECONDS\n\nOptions:\n -h, --help Show this help and exit.\n --seconds SECONDS Segundos virtuales.", @@ -7450,7 +7620,7 @@ window.LANCTL_REFERENCE = { }, { "choices": [], - "default": "data/lc/physical/idf.db", + "default": "data/lc/projects/workspaces/default/physical/idf.db", "description": "Base física IDF; por defecto usa physical/idf.db en la raíz compartida.", "flags": [ "--database" @@ -7459,6 +7629,17 @@ window.LANCTL_REFERENCE = { "metavar": "ARCHIVO.db", "required": false }, + { + "choices": [], + "default": null, + "description": "Abre la interfaz gráfica de escritorio.", + "flags": [ + "--gui" + ], + "label": "--gui", + "metavar": "", + "required": false + }, { "choices": [], "default": null, @@ -7501,10 +7682,10 @@ window.LANCTL_REFERENCE = { "prefix" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Gestión física, IDF, cableado y topología de la suite LANCTL.", - "details": "Usage: LANWIRE [-h] [--version] [--database ARCHIVO.db] [-tui | --cli] COMANDO ...\n\nGestión física, IDF, cableado y topología de la suite LANCTL.\n\nArguments:\n COMANDO\n tui Abre la interfaz de pantalla completa.\n cli Abre la consola interactiva.\n help Muestra la ayuda de comandos de LANWIRE.\n list (ls) Lista los identificadores.\n seed Carga la topología inicial de pruebas.\n show Muestra un identificador.\n add Genera el siguiente IDF.\n idf Crea identificadores con perfil físico completo.\n reserve Reserva un IDF.\n element Consulta o actualiza los datos y puertos de un elemento.\n delete (del) Elimina un IDF.\n graph (map) Muestra la topología física.\n prefix Gestiona juegos de letras.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --database ARCHIVO.db Base física IDF; por defecto usa physical/idf.db en la raíz compartida.\n -tui, --tui Abre la interfaz de pantalla completa.\n --cli, -cli Abre la consola interactiva de LANWIRE.", + "details": "Usage: LANWIRE [-h] [--version] [--database ARCHIVO.db] [--gui | -tui | --cli] COMANDO ...\n\nGestión física, IDF, cableado y topología de la suite LANCTL.\n\nArguments:\n COMANDO\n tui Abre la interfaz de pantalla completa.\n cli Abre la consola interactiva.\n help Muestra la ayuda de comandos de LANWIRE.\n list (ls) Lista los identificadores.\n seed Carga la topología inicial de pruebas.\n show Muestra un identificador.\n add Genera el siguiente IDF.\n idf Crea identificadores con perfil físico completo.\n reserve Reserva un IDF.\n element Consulta o actualiza los datos y puertos de un elemento.\n delete (del) Elimina un IDF.\n graph (map) Muestra la topología física.\n prefix Gestiona juegos de letras.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --database ARCHIVO.db Base física IDF; por defecto usa physical/idf.db en la raíz compartida.\n --gui Abre la interfaz gráfica de escritorio.\n -tui, --tui Abre la interfaz de pantalla completa.\n --cli, -cli Abre la consola interactiva de LANWIRE.", "docs": [ "LANWIRE.md", "CLI-REFERENCE.md", @@ -7523,7 +7704,7 @@ window.LANCTL_REFERENCE = { "LANWIRE" ], "title": "LANWIRE", - "usage": "LANWIRE [-h] [--version] [--database ARCHIVO.db] [-tui | --cli] COMANDO ..." + "usage": "LANWIRE [-h] [--version] [--database ARCHIVO.db] [--gui | -tui | --cli] COMANDO ..." }, { "aliases": [], @@ -7531,7 +7712,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE tui [-h]", "details": "Usage: LANWIRE tui [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -7561,7 +7742,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE cli [-h]", "details": "Usage: LANWIRE cli [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -7591,7 +7772,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE help [-h]", "details": "Usage: LANWIRE help [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -7631,7 +7812,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE list [-h] [prefix]", "details": "Usage: LANWIRE list [-h] [prefix]\n\nArguments:\n prefix Filtra por prefijo IDF.\n\nOptions:\n -h, --help Show this help and exit.", @@ -7661,7 +7842,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE seed [-h]", "details": "Usage: LANWIRE seed [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -7701,7 +7882,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE show [-h] idf", "details": "Usage: LANWIRE show [-h] idf\n\nArguments:\n idf Identificador físico que se desea consultar.\n\nOptions:\n -h, --help Show this help and exit.", @@ -7769,7 +7950,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE add [-h] [--digits {2,3,4,5}] [-more N] prefix", "details": "Usage: LANWIRE add [-h] [--digits {2,3,4,5}] [-more N] prefix\n\nArguments:\n prefix Prefijo del tipo de elemento físico.\n\nOptions:\n -h, --help Show this help and exit.\n --digits {2,3,4,5} Cantidad de dígitos del contador (2 a 5).\n -more N, --more N Crea N IDF consecutivos.", @@ -7809,7 +7990,7 @@ window.LANCTL_REFERENCE = { "add" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE idf [-h] {list,types,show,edit,delete,del,new,add} ...", "details": "Usage: LANWIRE idf [-h] {list,types,show,edit,delete,del,new,add} ...\n\nArguments:\n {list,types,show,edit,delete,del,new,add}\n list Lista prefijos o los IDF de uno de ellos.\n types Lista los perfiles físicos disponibles.\n show Consulta un prefijo o IDF.\n edit Edita un prefijo o los datos de un IDF.\n delete (del) Elimina un IDF.\n new Asigna un perfil físico a un prefijo.\n add Crea un IDF del perfil asignado al prefijo.\n\nOptions:\n -h, --help Show this help and exit.", @@ -7849,7 +8030,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE idf list [-h] [prefix]", "details": "Usage: LANWIRE idf list [-h] [prefix]\n\nArguments:\n prefix Prefijo cuyos elementos se listan.\n\nOptions:\n -h, --help Show this help and exit.", @@ -7880,7 +8061,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE idf types [-h]", "details": "Usage: LANWIRE idf types [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -7921,7 +8102,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE idf show [-h] code", "details": "Usage: LANWIRE idf show [-h] code\n\nArguments:\n code Prefijo o IDF concreto.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8015,7 +8196,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE idf edit [-h] [-type ELEMENT_TYPE] [-name NAME] [-alias ALIAS]\n [-description DESCRIPTION]\n code [CAMPO=VALOR ...]", "details": "Usage: LANWIRE idf edit [-h] [-type ELEMENT_TYPE] [-name NAME] [-alias ALIAS]\n [-description DESCRIPTION]\n code [CAMPO=VALOR ...]\n\nArguments:\n code Prefijo o IDF concreto.\n CAMPO=VALOR Datos del IDF.\n\nOptions:\n -h, --help Show this help and exit.\n -type ELEMENT_TYPE Nuevo perfil del prefijo.\n -name NAME Nombre del prefijo.\n -alias ALIAS Alias del prefijo.\n -description DESCRIPTION Descripción del prefijo.", @@ -8056,7 +8237,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE idf delete [-h] code", "details": "Usage: LANWIRE idf delete [-h] code\n\nArguments:\n code IDF concreto; no elimina prefijos.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8142,7 +8323,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE idf new [-h] [-name NAME] [-alias ALIAS] [-description DESCRIPTION] -type\n ELEMENT_TYPE\n code", "details": "Usage: LANWIRE idf new [-h] [-name NAME] [-alias ALIAS] [-description DESCRIPTION] -type\n ELEMENT_TYPE\n code\n\nArguments:\n code Prefijo para new o IDF exacto para add.\n\nOptions:\n -h, --help Show this help and exit.\n -name NAME Nombre del registro.\n -alias ALIAS Alias opcional.\n -description DESCRIPTION, -descriptionn DESCRIPTION\n Descripción opcional.\n -type ELEMENT_TYPE Perfil físico.", @@ -8217,7 +8398,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE idf add [-h] [-name NAME] [-alias ALIAS] [-description DESCRIPTION] code", "details": "Usage: LANWIRE idf add [-h] [-name NAME] [-alias ALIAS] [-description DESCRIPTION] code\n\nArguments:\n code Prefijo para new o IDF exacto para add.\n\nOptions:\n -h, --help Show this help and exit.\n -name NAME Nombre del registro.\n -alias ALIAS Alias opcional.\n -description DESCRIPTION, -descriptionn DESCRIPTION\n Descripción opcional.", @@ -8267,7 +8448,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE reserve [-h] idf [CLAVE=VALOR ...]", "details": "Usage: LANWIRE reserve [-h] idf [CLAVE=VALOR ...]\n\nArguments:\n idf IDF exacto que se desea reservar.\n CLAVE=VALOR Datos iniciales opcionales.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8316,7 +8497,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE element [-h] idf [CAMPO=VALOR ...]", "details": "Usage: LANWIRE element [-h] idf [CAMPO=VALOR ...]\n\nArguments:\n idf IDF que se desea consultar o actualizar.\n CAMPO=VALOR Campos físicos que se desean modificar.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8356,7 +8537,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE delete [-h] idf", "details": "Usage: LANWIRE delete [-h] idf\n\nArguments:\n idf IDF que se desea eliminar.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8386,7 +8567,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE graph [-h]", "details": "Usage: LANWIRE graph [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -8424,7 +8605,7 @@ window.LANCTL_REFERENCE = { "delete" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE prefix [-h] {list,ls,show,set,delete,del} ...", "details": "Usage: LANWIRE prefix [-h] {list,ls,show,set,delete,del} ...\n\nArguments:\n {list,ls,show,set,delete,del}\n list (ls) Lista las definiciones.\n show Muestra una definición.\n set Crea o actualiza una definición.\n delete (del) Elimina una definición.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8454,7 +8635,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE prefix list [-h]", "details": "Usage: LANWIRE prefix list [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -8495,7 +8676,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE prefix show [-h] letters", "details": "Usage: LANWIRE prefix show [-h] letters\n\nArguments:\n letters Letras del prefijo.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8554,7 +8735,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE prefix set [-h] letters name [description]", "details": "Usage: LANWIRE prefix set [-h] letters name [description]\n\nArguments:\n letters Letras del prefijo.\n name Nombre descriptivo del tipo.\n description Descripción opcional.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8595,7 +8776,7 @@ window.LANCTL_REFERENCE = { "category": "Cableado y topología", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANWIRE prefix delete [-h] letters", "details": "Usage: LANWIRE prefix delete [-h] letters\n\nArguments:\n letters Letras del prefijo que se desea eliminar.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8638,7 +8819,7 @@ window.LANCTL_REFERENCE = { }, { "choices": [], - "default": "data/lc/physical/idf.db", + "default": "data/lc/projects/workspaces/default/physical/idf.db", "description": "Base física IDF compartida.", "flags": [ "--database" @@ -8647,6 +8828,17 @@ window.LANCTL_REFERENCE = { "metavar": "ARCHIVO.db", "required": false }, + { + "choices": [], + "default": null, + "description": "Abre la interfaz gráfica de escritorio.", + "flags": [ + "--gui" + ], + "label": "--gui", + "metavar": "", + "required": false + }, { "choices": [], "default": null, @@ -8675,13 +8867,14 @@ window.LANCTL_REFERENCE = { "category": "Launchers", "children": [ "list", - "show" + "show", + "dimensions" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Visualiza racks y sus equipos.", - "details": "Usage: LANRACK [-h] [--version] [--database ARCHIVO.db] [-tui | --cli] {list,ls,show} ...\n\nVisualiza racks y sus equipos.\n\nArguments:\n {list,ls,show}\n list (ls) Lista los racks disponibles.\n show Muestra un rack y sus ocupantes.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --database ARCHIVO.db Base física IDF compartida.\n -tui, --tui Abre la interfaz de pantalla completa.\n --cli, -cli Abre la consola interactiva.", + "details": "Usage: LANRACK [-h] [--version] [--database ARCHIVO.db] [--gui | -tui | --cli]\n {list,ls,show,dimensions} ...\n\nVisualiza racks y sus equipos.\n\nArguments:\n {list,ls,show,dimensions}\n list (ls) Lista los racks disponibles.\n show Muestra un rack y sus ocupantes.\n dimensions Edita altura y ancho de montaje del rack.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --database ARCHIVO.db Base física IDF compartida.\n --gui Abre la interfaz gráfica de escritorio.\n -tui, --tui Abre la interfaz de pantalla completa.\n --cli, -cli Abre la consola interactiva.", "docs": [ "CLI-REFERENCE.md", "CLI.md" @@ -8699,7 +8892,7 @@ window.LANCTL_REFERENCE = { "LANRACK" ], "title": "LANRACK", - "usage": "LANRACK [-h] [--version] [--database ARCHIVO.db] [-tui | --cli] {list,ls,show} ..." + "usage": "LANRACK [-h] [--version] [--database ARCHIVO.db] [--gui | -tui | --cli]\n {list,ls,show,dimensions} ..." }, { "aliases": [], @@ -8707,7 +8900,7 @@ window.LANCTL_REFERENCE = { "category": "Racks y salas técnicas", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANRACK list [-h]", "details": "Usage: LANRACK list [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -8746,7 +8939,7 @@ window.LANCTL_REFERENCE = { "category": "Racks y salas técnicas", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANRACK show [-h] rack", "details": "Usage: LANRACK show [-h] rack\n\nArguments:\n rack ID o nombre del rack.\n\nOptions:\n -h, --help Show this help and exit.", @@ -8769,6 +8962,72 @@ window.LANCTL_REFERENCE = { "title": "LANRACK show", "usage": "LANRACK show [-h] rack" }, + { + "aliases": [], + "arguments": [ + { + "choices": [], + "default": null, + "description": "ID del rack.", + "flags": [], + "label": "rack", + "metavar": "", + "required": true + }, + { + "choices": [], + "default": null, + "description": "Altura de 4 a 52 U.", + "flags": [ + "--units" + ], + "label": "--units", + "metavar": "", + "required": true + }, + { + "choices": [ + "10", + "19", + "21", + "23" + ], + "default": null, + "description": "Ancho de montaje en pulgadas.", + "flags": [ + "--width-inches" + ], + "label": "--width-inches", + "metavar": "", + "required": true + } + ], + "category": "Racks y salas técnicas", + "children": [], + "compatibility": { + "verified": "0.3.4-alpha.1" + }, + "description": "usage: LANRACK dimensions [-h] --units UNITS --width-inches {10,19,21,23} rack", + "details": "Usage: LANRACK dimensions [-h] --units UNITS --width-inches {10,19,21,23} rack\n\nArguments:\n rack ID del rack.\n\nOptions:\n -h, --help Show this help and exit.\n --units UNITS Altura de 4 a 52 U.\n --width-inches {10,19,21,23}\n Ancho de montaje en pulgadas.", + "docs": [ + "CLI-REFERENCE.md", + "CLI.md" + ], + "examples": [ + "lanrack dimensions --help" + ], + "group": "LANRACK", + "id": "command-lanrack-dimensions", + "kind": "command", + "launcher": "LANRACK", + "name": "dimensions", + "path": [ + "LANRACK", + "dimensions" + ], + "title": "LANRACK dimensions", + "usage": "LANRACK dimensions [-h] --units UNITS --width-inches {10,19,21,23} rack" + }, { "aliases": [ "ls", @@ -8849,6 +9108,17 @@ window.LANCTL_REFERENCE = { "metavar": "", "required": false }, + { + "choices": [], + "default": null, + "description": "Abre la interfaz gráfica de escritorio.", + "flags": [ + "--gui" + ], + "label": "--gui", + "metavar": "", + "required": false + }, { "choices": [], "default": null, @@ -8876,6 +9146,7 @@ window.LANCTL_REFERENCE = { ], "category": "Launchers", "children": [ + "remote-setup", "list", "show", "set", @@ -8887,10 +9158,10 @@ window.LANCTL_REFERENCE = { "user" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Gestiona credenciales cifradas del entorno LANCTL.", - "details": "Usage: LANACCESS [-h] [--version] [--database DATABASE] [--store STORE]\n [--cipher {auto,dpapi,portable}] [--scope {program,windows,project}]\n [--project-dir PROJECT_DIR] [-tui | --cli]\n {list,ls,show,set,delete,del,credential,doctor,settings,protocol,user} ...\n\nGestiona credenciales cifradas del entorno LANCTL.\n\nArguments:\n {list,ls,show,set,delete,del,credential,doctor,settings,protocol,user}\n list (ls) Lista metadatos; nunca secretos.\n show Muestra metadatos de una credencial.\n set Crea o actualiza una credencial.\n delete (del) Elimina una credencial.\n credential Gestión, transporte y recuperación de credenciales.\n doctor Comprueba vínculos y permisos sin cambiar datos.\n settings Muestra o selecciona el almacén compartido.\n protocol Resumen por protocolos del almacén.\n user Usuarios del acceso remoto; no cuentas de Windows.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --database DATABASE Base de elementos LANCTL.\n --store STORE Almacén cifrado de credenciales.\n --cipher {auto,dpapi,portable}\n Proveedor de cifrado; portable pide contraseña.\n --scope {program,windows,project}\n Ubicación; no cambia permisos ni copia secretos automáticamente.\n --project-dir PROJECT_DIR Directorio del proyecto para su almacén independiente.\n -tui, --tui Abre la interfaz de pantalla completa.\n --cli, -cli Abre la consola interactiva.", + "details": "Usage: LANACCESS [-h] [--version] [--database DATABASE] [--store STORE]\n [--cipher {auto,dpapi,portable}] [--scope {program,windows,project}]\n [--project-dir PROJECT_DIR] [--gui | -tui | --cli]\n {remote-setup,list,ls,show,set,delete,del,credential,doctor,settings,protocol,user}\n ...\n\nGestiona credenciales cifradas del entorno LANCTL.\n\nArguments:\n {remote-setup,list,ls,show,set,delete,del,credential,doctor,settings,protocol,user}\n remote-setup Crea la primera cuenta remota del servicio en Windows (requiere\n administrador).\n list (ls) Lista metadatos; nunca secretos.\n show Muestra metadatos de una credencial.\n set Crea o actualiza una credencial.\n delete (del) Elimina una credencial.\n credential Gestión, transporte y recuperación de credenciales.\n doctor Comprueba vínculos y permisos sin cambiar datos.\n settings Muestra o selecciona el almacén compartido.\n protocol Resumen por protocolos del almacén.\n user Usuarios del acceso remoto; no cuentas de Windows.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --database DATABASE Base de elementos LANCTL.\n --store STORE Almacén cifrado de credenciales.\n --cipher {auto,dpapi,portable}\n Proveedor de cifrado; portable pide contraseña.\n --scope {program,windows,project}\n Ubicación; no cambia permisos ni copia secretos automáticamente.\n --project-dir PROJECT_DIR Directorio del proyecto para su almacén independiente.\n --gui Abre la interfaz gráfica de escritorio.\n -tui, --tui Abre la interfaz de pantalla completa.\n --cli, -cli Abre la consola interactiva.", "docs": [ "CLI-REFERENCE.md", "CLI.md" @@ -8908,7 +9179,36 @@ window.LANCTL_REFERENCE = { "LANACCESS" ], "title": "LANACCESS", - "usage": "LANACCESS [-h] [--version] [--database DATABASE] [--store STORE]\n [--cipher {auto,dpapi,portable}] [--scope {program,windows,project}]\n [--project-dir PROJECT_DIR] [-tui | --cli]\n {list,ls,show,set,delete,del,credential,doctor,settings,protocol,user} ..." + "usage": "LANACCESS [-h] [--version] [--database DATABASE] [--store STORE]\n [--cipher {auto,dpapi,portable}] [--scope {program,windows,project}]\n [--project-dir PROJECT_DIR] [--gui | -tui | --cli]\n {remote-setup,list,ls,show,set,delete,del,credential,doctor,settings,protocol,user}\n ..." + }, + { + "aliases": [], + "arguments": [], + "category": "Credenciales y acceso", + "children": [], + "compatibility": { + "verified": "0.3.4-alpha.1" + }, + "description": "usage: LANACCESS remote-setup [-h]", + "details": "Usage: LANACCESS remote-setup [-h]\n\nOptions:\n -h, --help Show this help and exit.", + "docs": [ + "CLI-REFERENCE.md", + "CLI.md" + ], + "examples": [ + "lanaccess remote-setup --help" + ], + "group": "LANACCESS", + "id": "command-lanaccess-remote-setup", + "kind": "command", + "launcher": "LANACCESS", + "name": "remote-setup", + "path": [ + "LANACCESS", + "remote-setup" + ], + "title": "LANACCESS remote-setup", + "usage": "LANACCESS remote-setup [-h]" }, { "aliases": [], @@ -8916,7 +9216,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS list [-h]", "details": "Usage: LANACCESS list [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -8955,7 +9255,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS show [-h] credential_id", "details": "Usage: LANACCESS show [-h] credential_id\n\nArguments:\n credential_id Identificador de la credencial.\n\nOptions:\n -h, --help Show this help and exit.", @@ -9015,7 +9315,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS set [-h] --username USERNAME element protocol", "details": "Usage: LANACCESS set [-h] --username USERNAME element protocol\n\nArguments:\n element IP, MAC, alias o ID del dispositivo.\n protocol Protocolo asociado, por ejemplo ssh.\n\nOptions:\n -h, --help Show this help and exit.\n --username USERNAME, -user USERNAME\n Usuario remoto.", @@ -9054,7 +9354,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS delete [-h] credential_id", "details": "Usage: LANACCESS delete [-h] credential_id\n\nArguments:\n credential_id Identificador de la credencial.\n\nOptions:\n -h, --help Show this help and exit.", @@ -9092,7 +9392,7 @@ window.LANCTL_REFERENCE = { "recover" ], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS credential [-h] {list,show,delete,set,export,import,copy,recover} ...", "details": "Usage: LANACCESS credential [-h] {list,show,delete,set,export,import,copy,recover} ...\n\nArguments:\n {list,show,delete,set,export,import,copy,recover}\n list Lista metadatos.\n show show por identificador.\n delete delete por identificador.\n set Guarda y vincula una credencial.\n export Transporta un almacén cifrado; nunca texto plano.\n import Transporta un almacén cifrado; nunca texto plano.\n copy Copia a otro almacén y verifica; origen conservado.\n recover Repara referencias ausentes; no elimina ni sobrescribe secretos.\n\nOptions:\n -h, --help Show this help and exit.", @@ -9121,7 +9421,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS credential list [-h]", "details": "Usage: LANACCESS credential list [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -9161,7 +9461,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS credential show [-h] credential_id", "details": "Usage: LANACCESS credential show [-h] credential_id\n\nArguments:\n credential_id\n\nOptions:\n -h, --help Show this help and exit.", @@ -9201,7 +9501,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS credential delete [-h] credential_id", "details": "Usage: LANACCESS credential delete [-h] credential_id\n\nArguments:\n credential_id\n\nOptions:\n -h, --help Show this help and exit.", @@ -9261,7 +9561,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS credential set [-h] --username USERNAME element protocol", "details": "Usage: LANACCESS credential set [-h] --username USERNAME element protocol\n\nArguments:\n element\n protocol\n\nOptions:\n -h, --help Show this help and exit.\n --username USERNAME", @@ -9301,7 +9601,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS credential export [-h] file", "details": "Usage: LANACCESS credential export [-h] file\n\nArguments:\n file\n\nOptions:\n -h, --help Show this help and exit.", @@ -9341,7 +9641,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS credential import [-h] file", "details": "Usage: LANACCESS credential import [-h] file\n\nArguments:\n file\n\nOptions:\n -h, --help Show this help and exit.", @@ -9395,7 +9695,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS credential copy [-h] [--target-cipher {dpapi,portable}] file", "details": "Usage: LANACCESS credential copy [-h] [--target-cipher {dpapi,portable}] file\n\nArguments:\n file\n\nOptions:\n -h, --help Show this help and exit.\n --target-cipher {dpapi,portable}", @@ -9437,7 +9737,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS credential recover [-h] [--yes]", "details": "Usage: LANACCESS credential recover [-h] [--yes]\n\nOptions:\n -h, --help Show this help and exit.\n --yes Aplica reparaciones; por defecto sólo diagnostica.", @@ -9467,7 +9767,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS doctor [-h]", "details": "Usage: LANACCESS doctor [-h]\n\nOptions:\n -h, --help Show this help and exit.", @@ -9529,7 +9829,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS settings [-h] [--yes] [{show,use-store}] [file]", "details": "Usage: LANACCESS settings [-h] [--yes] [{show,use-store}] [file]\n\nArguments:\n {show,use-store}\n file\n\nOptions:\n -h, --help Show this help and exit.\n --yes Confirma cambiar el almacén configurado sin mover secretos.", @@ -9611,7 +9911,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS protocol [-h] [--port PORT] [--driver DRIVER]\n [{list,configure}] [element] [protocol]", "details": "Usage: LANACCESS protocol [-h] [--port PORT] [--driver DRIVER]\n [{list,configure}] [element] [protocol]\n\nArguments:\n {list,configure}\n element\n protocol\n\nOptions:\n -h, --help Show this help and exit.\n --port PORT Puerto 1-65535.\n --driver DRIVER Driver del protocolo.", @@ -9692,7 +9992,7 @@ window.LANCTL_REFERENCE = { "category": "Credenciales y acceso", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "usage: LANACCESS user [-h] [--role {viewer,operator,manager,administrator}] [--yes]\n {list,add,enable,disable,delete} [username]", "details": "Usage: LANACCESS user [-h] [--role {viewer,operator,manager,administrator}] [--yes]\n {list,add,enable,disable,delete} [username]\n\nArguments:\n {list,add,enable,disable,delete}\n username\n\nOptions:\n -h, --help Show this help and exit.\n --role {viewer,operator,manager,administrator}\n --yes Confirma eliminación.", @@ -10078,6 +10378,17 @@ window.LANCTL_REFERENCE = { "metavar": "", "required": false }, + { + "choices": [], + "default": null, + "description": "Abre la interfaz gráfica de escritorio.", + "flags": [ + "--gui" + ], + "label": "--gui", + "metavar": "", + "required": false + }, { "choices": [], "default": null, @@ -10154,10 +10465,10 @@ window.LANCTL_REFERENCE = { "category": "Launchers", "children": [], "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Monitorización, eventos e incidencias de la suite LANCTL.", - "details": "Usage: LANMON [-h] [--version] [--project PROJECT] [--permanent] [--duration DURATION]\n [--mode {permanent,temporary,diagnostic,once}]\n [--authority {observe,operate,administer}] [--json] [--yes] [--interval INTERVAL]\n [--every EVERY] [--group GROUP] [--type {presence,services,ports,identity,smb,full}]\n [--fast] [--unknown] [--follow] [--sessions SESSIONS]\n [--incidents-store INCIDENTS_STORE] [--lock LOCK] [--monitor-db MONITOR_DB]\n [--profiles PROFILES] [--assignments-store ASSIGNMENTS_STORE] [--profile PROFILE]\n [--priority {low,normal,high,critical}] [--check CHECK] [--presence PRESENCE]\n [--discovery DISCOVERY] [--services SERVICES] [--deep DEEP] [--workers WORKERS]\n [--timeout TIMEOUT] [--cli | --tui] [--source {all,program,project}] [--limit LIMIT]\n [--window] [--level LEVEL]\n [words ...]\n\nMonitorización, eventos e incidencias de la suite LANCTL.\n\nArguments:\n words logs, events, status, attach, detach, once, session, incidents,\n service o foreground.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --project PROJECT Opción operativa del monitor.\n --permanent Opción operativa del monitor.\n --duration DURATION Opción operativa del monitor.\n --mode {permanent,temporary,diagnostic,once}\n Opción operativa del monitor.\n --authority {observe,operate,administer}\n Opción operativa del monitor.\n --json Opción operativa del monitor.\n --yes Opción operativa del monitor.\n --interval INTERVAL Opción operativa del monitor.\n --every EVERY Opción operativa del monitor.\n --group GROUP Opción operativa del monitor.\n --type {presence,services,ports,identity,smb,full}\n Opción operativa del monitor.\n --fast Opción operativa del monitor.\n --unknown Opción operativa del monitor.\n --follow Opción operativa del monitor.\n --sessions SESSIONS Estado runtime de sesiones.\n --incidents-store INCIDENTS_STORE\n Estado runtime de incidencias.\n --lock LOCK Lock singleton del monitor.\n --monitor-db MONITOR_DB Repositorio SQLite del monitor.\n --profiles PROFILES Perfiles personalizados.\n --assignments-store ASSIGNMENTS_STORE\n Asignaciones persistentes.\n --profile PROFILE Perfil monitor.\n --priority {low,normal,high,critical}\n Prioridad de asignación.\n --check CHECK Check ping, arp o port:NN.\n --presence PRESENCE Intervalo de presencia.\n --discovery DISCOVERY Intervalo de descubrimiento.\n --services SERVICES Intervalo de servicios.\n --deep DEEP Intervalo profundo.\n --workers WORKERS Workers del perfil.\n --timeout TIMEOUT Timeout del perfil.\n --cli, -cli Abre la consola de comandos.\n --tui, -tui Abre el visor tabular de eventos.\n --source {all,program,project}\n Origen para logs.\n --limit LIMIT Máximo de eventos (1-1000).\n --window Abre logs en otra terminal y sigue el registro común.\n --level LEVEL Nivel mínimo (1-59); conserva líneas sin nivel.", + "details": "Usage: LANMON [-h] [--version] [--project PROJECT] [--permanent] [--duration DURATION]\n [--mode {permanent,temporary,diagnostic,once}]\n [--authority {observe,operate,administer}] [--json] [--yes] [--interval INTERVAL]\n [--every EVERY] [--group GROUP] [--type {presence,services,ports,identity,smb,full}]\n [--fast] [--unknown] [--follow] [--sessions SESSIONS]\n [--incidents-store INCIDENTS_STORE] [--lock LOCK] [--monitor-db MONITOR_DB]\n [--profiles PROFILES] [--assignments-store ASSIGNMENTS_STORE] [--profile PROFILE]\n [--priority {low,normal,high,critical}] [--check CHECK] [--presence PRESENCE]\n [--discovery DISCOVERY] [--services SERVICES] [--deep DEEP] [--workers WORKERS]\n [--timeout TIMEOUT] [--gui | --cli | --tui] [--source {all,program,project}]\n [--limit LIMIT] [--window] [--level LEVEL]\n [words ...]\n\nMonitorización, eventos e incidencias de la suite LANCTL.\n\nArguments:\n words logs, events, status, attach, detach, once, session, incidents,\n service o foreground.\n\nOptions:\n -h, --help Show this help and exit.\n --version Muestra la versión común de la suite y termina.\n --project PROJECT Opción operativa del monitor.\n --permanent Opción operativa del monitor.\n --duration DURATION Opción operativa del monitor.\n --mode {permanent,temporary,diagnostic,once}\n Opción operativa del monitor.\n --authority {observe,operate,administer}\n Opción operativa del monitor.\n --json Opción operativa del monitor.\n --yes Opción operativa del monitor.\n --interval INTERVAL Opción operativa del monitor.\n --every EVERY Opción operativa del monitor.\n --group GROUP Opción operativa del monitor.\n --type {presence,services,ports,identity,smb,full}\n Opción operativa del monitor.\n --fast Opción operativa del monitor.\n --unknown Opción operativa del monitor.\n --follow Opción operativa del monitor.\n --sessions SESSIONS Estado runtime de sesiones.\n --incidents-store INCIDENTS_STORE\n Estado runtime de incidencias.\n --lock LOCK Lock singleton del monitor.\n --monitor-db MONITOR_DB Repositorio SQLite del monitor.\n --profiles PROFILES Perfiles personalizados.\n --assignments-store ASSIGNMENTS_STORE\n Asignaciones persistentes.\n --profile PROFILE Perfil monitor.\n --priority {low,normal,high,critical}\n Prioridad de asignación.\n --check CHECK Check ping, arp o port:NN.\n --presence PRESENCE Intervalo de presencia.\n --discovery DISCOVERY Intervalo de descubrimiento.\n --services SERVICES Intervalo de servicios.\n --deep DEEP Intervalo profundo.\n --workers WORKERS Workers del perfil.\n --timeout TIMEOUT Timeout del perfil.\n --gui Abre la interfaz gráfica de escritorio.\n --cli, -cli Abre la consola de comandos.\n --tui, -tui Abre el visor tabular de eventos.\n --source {all,program,project}\n Origen para logs.\n --limit LIMIT Máximo de eventos (1-1000).\n --window Abre logs en otra terminal y sigue el registro común.\n --level LEVEL Nivel mínimo (1-59); conserva líneas sin nivel.", "docs": [ "MONITOR.md", "CLI-REFERENCE.md", @@ -10176,12 +10487,12 @@ window.LANCTL_REFERENCE = { "LANMON" ], "title": "LANMON", - "usage": "LANMON [-h] [--version] [--project PROJECT] [--permanent] [--duration DURATION]\n [--mode {permanent,temporary,diagnostic,once}]\n [--authority {observe,operate,administer}] [--json] [--yes] [--interval INTERVAL]\n [--every EVERY] [--group GROUP] [--type {presence,services,ports,identity,smb,full}]\n [--fast] [--unknown] [--follow] [--sessions SESSIONS]\n [--incidents-store INCIDENTS_STORE] [--lock LOCK] [--monitor-db MONITOR_DB]\n [--profiles PROFILES] [--assignments-store ASSIGNMENTS_STORE] [--profile PROFILE]\n [--priority {low,normal,high,critical}] [--check CHECK] [--presence PRESENCE]\n [--discovery DISCOVERY] [--services SERVICES] [--deep DEEP] [--workers WORKERS]\n [--timeout TIMEOUT] [--cli | --tui] [--source {all,program,project}] [--limit LIMIT]\n [--window] [--level LEVEL]\n [words ...]" + "usage": "LANMON [-h] [--version] [--project PROJECT] [--permanent] [--duration DURATION]\n [--mode {permanent,temporary,diagnostic,once}]\n [--authority {observe,operate,administer}] [--json] [--yes] [--interval INTERVAL]\n [--every EVERY] [--group GROUP] [--type {presence,services,ports,identity,smb,full}]\n [--fast] [--unknown] [--follow] [--sessions SESSIONS]\n [--incidents-store INCIDENTS_STORE] [--lock LOCK] [--monitor-db MONITOR_DB]\n [--profiles PROFILES] [--assignments-store ASSIGNMENTS_STORE] [--profile PROFILE]\n [--priority {low,normal,high,critical}] [--check CHECK] [--presence PRESENCE]\n [--discovery DISCOVERY] [--services SERVICES] [--deep DEEP] [--workers WORKERS]\n [--timeout TIMEOUT] [--gui | --cli | --tui] [--source {all,program,project}]\n [--limit LIMIT] [--window] [--level LEVEL]\n [words ...]" }, { "category": "Proyectos", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Contenedor portable de inventario, configuración, auditoría y hashes.", "details": "Los proyectos .vlf permiten guardar, verificar, clonar y trasladar un entorno LANCTL completo.", @@ -10201,7 +10512,7 @@ window.LANCTL_REFERENCE = { { "category": "Plugins y expansiones", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Paquete verificable de extensión con manifiesto, permisos y runtimes controlados.", "details": "Los paquetes .lcp se validan antes de instalarse y permanecen desactivados hasta conceder sus permisos.", @@ -10221,7 +10532,7 @@ window.LANCTL_REFERENCE = { { "category": "Grupos de comandos", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Árboles de subcomandos que agrupan acciones relacionadas bajo una raíz común.", "details": "Usa --help en cualquier nivel para consultar sus acciones, argumentos y opciones disponibles.", @@ -10241,7 +10552,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "CLI directa, consola interactiva `lanaccess --cli` y TUI `lanaccess --tui` comparten servicios. En el TUI, N/B cambia de página, A crea, E elimina, D diagnostica y C permite ejecutar los mismos comandos sin salir. Los controles se confirman con Intro; no son todavía modales como LANIP.", "details": "Documento mantenido en docs/ACCESS-MONITOR-MANAGEMENT.md.", @@ -10259,7 +10570,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Para nodos permanentes, políticas de mínimo privilegio, PKI, actualización y recuperación, consulta la [guía de despliegue empresarial](ENTERPRISE.md).", "details": "Documento mantenido en docs/ACCESS.md.", @@ -10277,7 +10588,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "`LANCTL` es el orquestador común. Permite abrir las aplicaciones con `lanctl ip`, `lanctl wire`, `lanctl rack` y `lanctl access`; los ejecutables independientes usan los mismos datos y la misma versión de la suite.", "details": "Documento mantenido en docs/APPLICATIONS.md.", @@ -10295,7 +10606,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Base auditada: `d6b0e7d382a643789942314fd0ea18a103f19a98`, versión `0.3.2-beta.4`. Las correcciones se desarrollan en `codex/audit-corrections` para revisión e integración posterior en `main`. Ninguna rama estable se modifica.", "details": "Documento mantenido en docs/AUDIT-CORRECTIONS-2026-10.md.", @@ -10313,9 +10624,27 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, - "description": "Lista de asuntos acordados para revisar en una sesión futura. Este documento no indica que las tareas estén implementadas.", + "description": "Evidencia de los 33 puntos de [BACKLOG.md](BACKLOG.md), sobre la versión de desarrollo 0.3.3. «Verificado» identifica el alcance local indicado, con datos de prueba aislados. No implica certificación de instalaciones ni plataformas no ejecutadas. Los cambios permanecen en la rama de trabajo, sin publicación.", + "details": "Documento mantenido en docs/BACKLOG-VERIFICATION.md.", + "docs": [ + "BACKLOG-VERIFICATION.md" + ], + "examples": [], + "group": "docs/", + "id": "doc-backlog-verification", + "kind": "document", + "name": "BACKLOG-VERIFICATION.md", + "title": "Comprobación del backlog — 15/10/2026", + "url": "https://github.com/CctrGy/LANCTL/blob/main/docs/BACKLOG-VERIFICATION.md" + }, + { + "category": "Archivos de documentación", + "compatibility": { + "verified": "0.3.4-alpha.1" + }, + "description": "Se vuelve a comprobar toda la lista, incluidas las entradas implementadas que esperan el cierre de GUI-DESIGN. No se inicia una segunda compilación durante su validación. El usuario confirma que **todavía no existe un editor oficial configurado**: P40/P42 siguen requiriendo identidad y firma autorizadas.", "details": "Documento mantenido en docs/BACKLOG.md.", "docs": [ "BACKLOG.md" @@ -10331,7 +10660,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "LANCTL se distribuye como beta técnica. Utilízalo únicamente en redes propias o donde tengas autorización y conserva una copia independiente de los proyectos `.vlf`. No uses todavía LANCTL como única fuente del inventario de una red.", "details": "Documento mantenido en docs/BETA-TESTING.md.", @@ -10349,7 +10678,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "`CiscoPlanner` no conoce SSH ni Netmiko. `CommandPlan` contiene la identidad estable ALS, endpoint actual, puerto lógico y nativo, riesgo y comandos que un adaptador podría ejecutar. `FakeCiscoAdapter` es el único adaptador habilitado en esta fase.", "details": "Documento mantenido en docs/cisco-command-layer.md.", @@ -10367,7 +10696,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Documento generado automáticamente desde los parsers de la aplicación. No lo edites manualmente; ejecuta `python tools/generate_cli_reference.py`.", "details": "Documento mantenido en docs/CLI-REFERENCE.md.", @@ -10385,7 +10714,25 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" + }, + "description": "`lanctl settings` abre el editor por categorías cuando se ejecuta en una terminal interactiva. `lanctl settings --menu` lo abre explícitamente. Con entrada/salida redirigida se conserva la consulta JSON anterior sin preguntas interactivas.", + "details": "Documento mantenido en docs/CLI-SETTINGS.md.", + "docs": [ + "CLI-SETTINGS.md" + ], + "examples": [], + "group": "docs/", + "id": "doc-cli-settings", + "kind": "document", + "name": "CLI-SETTINGS.md", + "title": "Configuración completa desde el CLI", + "url": "https://github.com/CctrGy/LANCTL/blob/main/docs/CLI-SETTINGS.md" + }, + { + "category": "Archivos de documentación", + "compatibility": { + "verified": "0.3.4-alpha.1" }, "description": "Todos los comandos admiten `-h`, `--help` y `/?`. `list` y `recurrent` ofrecen `table`, `json`, `csv`, `html`, `xml` y `yaml`. Usa `--output` para escritura atómica a archivo.", "details": "Documento mantenido en docs/CLI.md.", @@ -10403,7 +10750,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "LANCTL conserva una única configuración JSON con esquema versionado. Desde el esquema 2, las opciones se agrupan por responsabilidad en vez de compartir un espacio plano de claves.", "details": "Documento mantenido en docs/CONFIGURATION.md.", @@ -10421,7 +10768,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "LANCTL, LANIP, LANWIRE, LANRACK, LANACCESS y LANMON registran sus ejecuciones en `runtime/coordinator.db`, dentro de la raíz de datos resuelta por el programa. Es un almacén SQLite transaccional con `user_version=1`, no una base de inventario ni un almacén de credenciales. No se versiona en Git.", "details": "Documento mantenido en docs/COORDINATION.md.", @@ -10439,7 +10786,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Estas reglas son el contrato de trabajo del repositorio. Se aplican a código, documentación, plugins, automatizaciones, empaquetado y publicaciones.", "details": "Documento mantenido en docs/DEVELOPMENT-RULES.md.", @@ -10457,7 +10804,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Estas herramientas ayudan a revisar LANCTL, pero no forman parte del programa ni de sus instaladores. Se instalan fuera del repositorio. Sus configuraciones reproducibles y documentos de arquitectura sí se versionan.", "details": "Documento mantenido en docs/DEVELOPMENT-TOOLS.md.", @@ -10475,7 +10822,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Esta guía describe un nodo LANCTL administrado dentro de una LAN confiable. SSH y HTTPS permanecen desactivados hasta completar la configuración y no se publican directamente en Internet.", "details": "Documento mantenido en docs/ENTERPRISE.md.", @@ -10493,7 +10840,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "LANCTL representa los fallos nuevos mediante `ErrorEvent`, con nivel, origen jerárquico, código estable, mensaje, recuperabilidad, contexto redactado y un identificador de correlación. `ErrorManager.emit()` permite decidir de forma independiente si el error se muestra (`print_output`) y si interrumpe la tarea (`break_execution`). Los errores que interrumpen se muestran mediante su `repr`, útil para soporte y diagnóstico.", "details": "Documento mantenido en docs/ERRORS.md.", @@ -10511,7 +10858,43 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" + }, + "description": "El usuario solicita completar los pendientes de interfaz y encarga a AUDITOR los cambios internos. El trabajo continúa en la rama existente experimental-gui, sin publicar, instalar ni modificar la versión durante la integración.", + "details": "Documento mantenido en docs/GUI-AUDITOR-COORDINATION.md.", + "docs": [ + "GUI-AUDITOR-COORDINATION.md" + ], + "examples": [], + "group": "docs/", + "id": "doc-gui-auditor-coordination", + "kind": "document", + "name": "GUI-AUDITOR-COORDINATION.md", + "title": "Integración de pendientes GUI y AUDITOR — 17/10/2026", + "url": "https://github.com/CctrGy/LANCTL/blob/main/docs/GUI-AUDITOR-COORDINATION.md" + }, + { + "category": "Archivos de documentación", + "compatibility": { + "verified": "0.3.4-alpha.1" + }, + "description": "Abrir `gui/launcher-prototypes.html` en el navegador. No requiere servidor ni dependencias externas. Las cuatro vistas se seleccionan en la barra superior; también admiten los fragmentos `#wire`, `#rack`, `#access` y `#mon`.", + "details": "Documento mantenido en docs/GUI-PROTOTYPES.md.", + "docs": [ + "GUI-PROTOTYPES.md" + ], + "examples": [], + "group": "docs/", + "id": "doc-gui-prototypes", + "kind": "document", + "name": "GUI-PROTOTYPES.md", + "title": "Prototipos de los launchers pendientes", + "url": "https://github.com/CctrGy/LANCTL/blob/main/docs/GUI-PROTOTYPES.md" + }, + { + "category": "Archivos de documentación", + "compatibility": { + "verified": "0.3.4-alpha.1" }, "description": "Este subsistema está destinado a la futura interfaz gráfica. No registra comandos en CLI ni TUI.", "details": "Documento mantenido en docs/ICONS.md.", @@ -10529,7 +10912,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "GitHub Releases es el canal de distribución binaria de LANCTL. Los scripts de instalación no compilan código: seleccionan un artefacto exacto para la versión, SO y arquitectura, descargan `SHA256SUMS.txt` y fallan antes de instalar si la verificación no coincide.", "details": "Documento mantenido en docs/INSTALL.md.", @@ -10547,7 +10930,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Las limitaciones resueltas deben retirarse de esta lista en la misma revisión que incorpore y pruebe la corrección.", "details": "Documento mantenido en docs/KNOWN-ISSUES.md.", @@ -10559,13 +10942,31 @@ window.LANCTL_REFERENCE = { "id": "doc-known-issues", "kind": "document", "name": "KNOWN-ISSUES.md", - "title": "Limitaciones conocidas de la beta", + "title": "Limitaciones conocidas", "url": "https://github.com/CctrGy/LANCTL/blob/main/docs/KNOWN-ISSUES.md" }, { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" + }, + "description": "Inicia `lanctl --gui` (desde fuentes: `python -m lanctl --gui`). La consola habitual `lanctl --cli` y el TUI siguen disponibles. Desde fuentes se necesita el extra `gui`: `pip install -e \".[gui]\"`.", + "details": "Documento mantenido en docs/LANCTL-GUI.md.", + "docs": [ + "LANCTL-GUI.md" + ], + "examples": [], + "group": "docs/", + "id": "doc-lanctl-gui", + "kind": "document", + "name": "LANCTL-GUI.md", + "title": "Centro gráfico de LANCTL", + "url": "https://github.com/CctrGy/LANCTL/blob/main/docs/LANCTL-GUI.md" + }, + { + "category": "Archivos de documentación", + "compatibility": { + "verified": "0.3.4-alpha.1" }, "description": "LANCTL utiliza catálogos JSON con extensión `.lang`. Las claves son contratos estables, por ejemplo `LANCTL.CORE.APP.CANCELLED`, y no el texto original.", "details": "Documento mantenido en docs/LANG.md.", @@ -10583,7 +10984,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Interfaz de escritorio sobre pywebview, HTML/CSS/JavaScript local y los servicios existentes de LANIP. No instala un servidor web ni abre un puerto de acceso remoto. La API remota anterior conserva `GuiApi`; el escritorio utiliza `DesktopApi`.", "details": "Documento mantenido en docs/LANIP-GUI.md.", @@ -10601,7 +11002,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "LANLAB permite probar inventario, filtros, historial y presentación de LANIP sin depender de una LAN física. Su proveedor implementa el contrato común `DiscoveryProvider` y devuelve `DiscoveryResult` con `source=simulated`, proveedor, escenario y semilla.", "details": "Documento mantenido en docs/LANLAB.md.", @@ -10619,7 +11020,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "LANWIRE es el gestor de infraestructura física complementario de LANCTL. En Windows se distribuye como `lanwire.exe` en el mismo directorio que `LANCTL.exe`. La GUI heredada no forma parte de la distribución.", "details": "Documento mantenido en docs/LANWIRE.md.", @@ -10637,7 +11038,25 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" + }, + "description": "Desde LANCTL, pulsa la tarjeta de la aplicación. También se abren directamente:", + "details": "Documento mantenido en docs/LAUNCHER-GUI.md.", + "docs": [ + "LAUNCHER-GUI.md" + ], + "examples": [], + "group": "docs/", + "id": "doc-launcher-gui", + "kind": "document", + "name": "LAUNCHER-GUI.md", + "title": "GUI de LANWIRE, LANRACK, LANACCESS y LANMON", + "url": "https://github.com/CctrGy/LANCTL/blob/main/docs/LAUNCHER-GUI.md" + }, + { + "category": "Archivos de documentación", + "compatibility": { + "verified": "0.3.4-alpha.1" }, "description": "Todos los launchers admiten `--cli` (también `-cli`) y `--tui` (también `-tui`). Los comandos directos y `/?` siguen disponibles. No cambia el formato de los proyectos, credenciales ni contratos de plugins.", "details": "Documento mantenido en docs/LAUNCHER-INTERFACES.md.", @@ -10655,7 +11074,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "LANCTL utiliza `.lcp` como contenedor ZIP seguro para todos sus complementos. Un mismo paquete puede aportar capacidades `plugin`, `theme`, `language`, `settings`, `automation`, `network`, `analysis`, `ui`, `security`, `protocol`, `scanner`, `parser`, `exporter`, `project-handler` o `project-save-mode`. CLI, TUI y la futura GUI consumen el mismo registro de extensiones.", "details": "Documento mantenido en docs/LCP.md.", @@ -10673,7 +11092,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "La GUI se conserva únicamente como referencia mientras el desarrollo se centra en CLI y TUI. No recibe nuevas funciones, no participa en la batería ordinaria de pruebas y no se incluye en los ejecutables, el ZIP portable, el instalador ni los accesos directos de Windows.", "details": "Documento mantenido en docs/LEGACY-GUI.md.", @@ -10691,7 +11110,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "El backend separa el motor de ejecución de la configuración y los datos. `MonitorService` consume `ConfigProvider`, `AssignmentProvider`, `MetricsStore`, `SessionRepository`, `IncidentRepository` y `ReportBuilder`. Las implementaciones persistentes usan SQLite con WAL, timeout de bloqueo, transacciones e índices por dispositivo y tiempo.", "details": "Documento mantenido en docs/MONITOR.md.", @@ -10709,7 +11128,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "La demostración aislada no modifica el inventario normal ni envía paquetes a la red. Genera un proyecto VLF verificable y dos informes:", "details": "Documento mantenido en docs/PRESENTATION.md.", @@ -10727,7 +11146,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Fecha: 2026-08-01", "details": "Documento mantenido en docs/RELEASE-0.3.0-beta.1.md.", @@ -10745,7 +11164,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Versión beta para evaluación en Windows x64. Incluye ejecutables autocontenidos: no requiere una instalación de Python en el equipo de destino.", "details": "Documento mantenido en docs/RELEASE-0.3.0-beta.20.md.", @@ -10763,7 +11182,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Beta técnica dirigida a evaluación controlada. Los launchers son autocontenidos y no requieren que Python esté instalado en el equipo destino.", "details": "Documento mantenido en docs/RELEASE-0.3.0-beta.22.md.", @@ -10781,7 +11200,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Beta técnica dirigida a evaluación controlada. Los launchers son autocontenidos y no requieren que Python esté instalado en el equipo destino.", "details": "Documento mantenido en docs/RELEASE-0.3.1-beta.1.md.", @@ -10799,7 +11218,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Beta técnica en desarrollo sobre la rama `main`. La versión estable anterior permanece congelada en `stable/0.3.1-beta.1`, en el tag `v0.3.1-beta.1` y en su GitHub Release con los instaladores originales.", "details": "Documento mantenido en docs/RELEASE-0.3.1-beta.2.md.", @@ -10817,7 +11236,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Versión de prueba publicada desde `main` como **pre-release**. Puede contener funciones todavía no sometidas a un ciclo completo de validación. La versión conservada como estable sigue siendo `0.3.1-beta.1` en la rama `stable/0.3.1-beta.1`, su tag y su GitHub Release.", "details": "Documento mantenido en docs/RELEASE-0.3.1-beta.3.md.", @@ -10835,7 +11254,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Beta de desarrollo integrada en `main`; no es una versión estable.", "details": "Documento mantenido en docs/RELEASE-0.3.2-beta.1.md.", @@ -10853,7 +11272,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Publicación solicitada en el canal estable, conservando el sufijo beta por decisión del propietario. La etiqueta de canal no implica ausencia de defectos.", "details": "Documento mantenido en docs/RELEASE-0.3.2-beta.4.md.", @@ -10871,7 +11290,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Nueva versión del canal estable, posterior a 0.3.2-beta.4. Integra el desarrollo experimental y las correcciones de auditoría de octubre en la rama `main`. Las ramas y los instaladores de versiones anteriores se conservan.", "details": "Documento mantenido en docs/RELEASE-0.3.3.md.", @@ -10889,7 +11308,25 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" + }, + "description": "Prototipo de la rama `experimental-gui`, publicado como **pre-release** para probar las interfaces gráficas en otro ordenador. No es una versión estable y no sustituye a la Release estable 0.3.3. No se necesita instalar Python.", + "details": "Documento mantenido en docs/RELEASE-0.3.4-alpha.1.md.", + "docs": [ + "RELEASE-0.3.4-alpha.1.md" + ], + "examples": [], + "group": "docs/", + "id": "doc-release-0-3-4-alpha-1", + "kind": "document", + "name": "RELEASE-0.3.4-alpha.1.md", + "title": "LANCTL 0.3.4-alpha.1 — GUI EXPERIMENTAL (NO ESTABLE)", + "url": "https://github.com/CctrGy/LANCTL/blob/main/docs/RELEASE-0.3.4-alpha.1.md" + }, + { + "category": "Archivos de documentación", + "compatibility": { + "verified": "0.3.4-alpha.1" }, "description": "LANWIRE añade perfiles de prefijos, creación explícita de IDF, identificadores de 2–5 letras/dígitos, plantillas mixtas de puertos, compatibilidad de medios, vista de topología, navegación entre cables/equipos y edición desde el TUI. La persistencia actualiza referencias al renombrar puertos y limpia conexiones al eliminar elementos, con escrituras transaccionales. La inicialización de LANWIRE puede clasificar registros antiguos FB/WL/WE: conviene respaldar bases reales antes de abrirlas con esta versión.", "details": "Documento mantenido en docs/REVIEW-EXPERIMENTAL-2026-09-25.md.", @@ -10907,7 +11344,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Las comprobaciones de cada cambio a `main` incluyen pruebas de integración y cobertura de ramas, Ruff, Bandit, `pip check`, `pip-audit`, CodeQL y revisión de dependencias. Dependabot revisa semanalmente paquetes Python y GitHub Actions. Los workflows usan permisos mínimos y la publicación solo obtiene `contents: write` dentro del trabajo que crea una release desde un tag.", "details": "Documento mantenido en docs/SECURITY.md.", @@ -10925,7 +11362,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Documento histórico: recoge la revisión anterior a la publicación de 0.3.2-beta.4. El estado siguiente corresponde a ese momento y no al estado actual del repositorio; consulta las notas de cada Release.", "details": "Documento mantenido en docs/STABILITY-REVIEW-2026-09-26.md.", @@ -10943,7 +11380,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "LANCTL separa programa, datos de usuario/servicio y proyectos. En una instalación Windows estándar, el programa reside en `Program Files` y los datos mutables en `C:\\ProgramData\\LANCTL`. Los secretos usan el ámbito de usuario o servicio configurado. Los proyectos VLF solo cambian cuando se seleccionan de forma explícita.", "details": "Documento mantenido en docs/STORAGE.md.", @@ -10961,7 +11398,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "1. Ejecuta `lanctl database --diagnose` y conserva la salida. 2. Consulta un identificador mostrado con `lanctl error 0eXXXXXXXX`. 3. Revisa `logs/` sin publicar credenciales ni la carpeta `access/`. 4. Si falla un plugin, inicia con `pluginSafeMode: true`, revoca permisos o desactívalo. 5. Verifica un LCP con `lanctl plugin verify ARCHIVO.lcp` antes de instalarlo. 6. Verifica una copia de datos con `lanctl database --verify ARCHIVO.zip`.", "details": "Documento mantenido en docs/TROUBLESHOOTING.md.", @@ -10979,7 +11416,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Inicia la interfaz con `lanctl --tui`. También puede abrir directamente `PLUGINS`, `PROJECTS` o `SETTINGS`. La pantalla se adapta automáticamente a terminales estrechas; se recomienda un mínimo de 80×24 para la demostración.", "details": "Documento mantenido en docs/TUI.md.", @@ -10997,7 +11434,7 @@ window.LANCTL_REFERENCE = { { "category": "Archivos de documentación", "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "description": "Un archivo `.vlf` es un contenedor ZIP con nombres internos POSIX y una estructura fija. No debe confundirse la compresión ZIP con cifrado.", "details": "Documento mantenido en docs/VLF.md.", @@ -11014,15 +11451,15 @@ window.LANCTL_REFERENCE = { } ], "meta": { - "entryCount": 174, + "entryCount": 183, "name": "LANCTL Reference", "repository": "https://github.com/CctrGy/LANCTL", - "version": "0.3.3" + "version": "0.3.4-alpha.1" }, "workflows": [ { "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "docs": [ "VLF.md", @@ -11081,7 +11518,7 @@ window.LANCTL_REFERENCE = { }, { "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "docs": [ "LCP.md", @@ -11139,7 +11576,7 @@ window.LANCTL_REFERENCE = { }, { "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "docs": [ "CONFIGURATION.md", @@ -11203,7 +11640,7 @@ window.LANCTL_REFERENCE = { }, { "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "docs": [ "ACCESS.md", @@ -11262,7 +11699,7 @@ window.LANCTL_REFERENCE = { }, { "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "docs": [ "ACCESS.md", @@ -11317,7 +11754,7 @@ window.LANCTL_REFERENCE = { }, { "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "docs": [ "MONITOR.md", @@ -11374,7 +11811,7 @@ window.LANCTL_REFERENCE = { }, { "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "docs": [ "STORAGE.md", @@ -11427,7 +11864,7 @@ window.LANCTL_REFERENCE = { }, { "compatibility": { - "verified": "0.3.3" + "verified": "0.3.4-alpha.1" }, "docs": [ "CLI.md", diff --git a/scripts/build-linux.sh b/scripts/build-linux.sh index 53448a4..9572fc7 100755 --- a/scripts/build-linux.sh +++ b/scripts/build-linux.sh @@ -1,6 +1,6 @@ #!/usr/bin/env bash set -euo pipefail -VERSION="${1:-0.3.3}" +VERSION="${1:-0.3.4-alpha.1}" [[ "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-(alpha|beta|rc)\.[0-9]+)?$ ]] || { echo 'Invalid version' >&2; exit 2; } ROOT="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"; cd "$ROOT" python3 scripts/verify-version.py "$VERSION" diff --git a/scripts/build-windows.ps1 b/scripts/build-windows.ps1 index d102bd1..aac4b42 100644 --- a/scripts/build-windows.ps1 +++ b/scripts/build-windows.ps1 @@ -1,5 +1,5 @@ [CmdletBinding()] param( - [string]$Version = '0.3.3', + [string]$Version = '0.3.4-alpha.1', [switch]$SkipInstaller, [switch]$AllowDirty, [string]$SigningCertificateThumbprint = '', @@ -114,6 +114,11 @@ try { Copy-Item dist\lanrack.exe (Join-Path $portable 'lanrack.exe') Copy-Item dist\lanaccess.exe (Join-Path $portable 'lanaccess.exe') Copy-Item packaging\portable\README-portable.txt (Join-Path $portable 'README-portable.txt') + Copy-Item packaging\portable\prepare.ps1 (Join-Path $portable 'prepare.ps1') + $ClinkDirectory = Join-Path $portable 'clink' + New-Item -ItemType Directory -Path $ClinkDirectory | Out-Null + Copy-Item packaging\clink\lanctl.lua (Join-Path $ClinkDirectory 'lanctl.lua') + Copy-Item packaging\clink\README.md (Join-Path $ClinkDirectory 'README.md') Set-Content -LiteralPath (Join-Path $portable 'LANCTL.portable') -Value 'LANCTL-PORTABLE-V1' -Encoding ascii Compress-Archive -Path "$portable\*" -DestinationPath "dist\release\LANCTL-$Version-windows-x64-portable.zip" -Force if (-not $SkipInstaller) { diff --git a/sonar-project.properties b/sonar-project.properties index 8f91647..f599aba 100644 --- a/sonar-project.properties +++ b/sonar-project.properties @@ -1,6 +1,6 @@ sonar.projectKey=CctrGy_LANCTL sonar.projectName=LANCTL -sonar.projectVersion=0.3.3 +sonar.projectVersion=0.3.4-alpha.1 sonar.sourceEncoding=UTF-8 sonar.sources=src,gui diff --git a/src/lanctl/__init__.py b/src/lanctl/__init__.py index 1d46041..12835b5 100644 --- a/src/lanctl/__init__.py +++ b/src/lanctl/__init__.py @@ -1,3 +1,3 @@ """LANCTL: control lógico de dispositivos e infraestructuras LAN.""" -__version__ = "0.3.3" +__version__ = "0.3.4-alpha.1" diff --git a/src/lanctl/apps/access/credential_service.py b/src/lanctl/apps/access/credential_service.py new file mode 100644 index 0000000..bce3ba3 --- /dev/null +++ b/src/lanctl/apps/access/credential_service.py @@ -0,0 +1,52 @@ +"""Shared metadata and encrypted credential transactions for CLI, TUI and GUI.""" + +from lanctl.apps.ip.domain.models import normalize_protocol +from lanctl.core.credentials import CredentialStore +from lanctl.core.database import DeviceDatabase +from lanctl.core.file_transaction import locked_files + + +class CredentialService: + def __init__(self, database_path: str, store_path: str) -> None: + self.database = DeviceDatabase(database_path) + self.store = CredentialStore(store_path) + + def list(self) -> list[dict[str, str]]: + devices = {device.device_id: device for device in self.database.load()} + rows = self.store.metadata() + for row in rows: + device = devices.get(row["deviceId"]) + row["element"] = ( + device.alias or device.name or device.ip or device.mac + if device + else row["deviceId"] + ) + return rows + + def set_secret(self, selector: str, protocol: str, username: str, password: str) -> str: + """Shared credential transaction; interactive callers obtain the secret separately.""" + device = self.database.resolve(selector) + normalized = normalize_protocol(protocol) + if not password or not username.strip(): + raise ValueError("usuario y contraseña son obligatorios") + with locked_files([self.store.path, self.database.path]): + previous = self.store._load() + identifier = self.store.set(device.device_id, normalized, username, password) + try: + self.database.bind_credential(selector, normalized, identifier) + except (OSError, ValueError): + self.store._save(previous) + raise + return identifier + + def delete(self, identifier: str) -> bool: + metadata = next( + (row for row in self.store.metadata() if row["credentialId"] == identifier), None + ) + if metadata is None: + return False + for device in self.database.load(): + for protocol, reference in tuple(device.credentials.items()): + if reference == identifier: + self.database.unbind_credential(device.device_id, protocol) + return self.store.delete(identifier) diff --git a/src/lanctl/apps/access/gui_service.py b/src/lanctl/apps/access/gui_service.py new file mode 100644 index 0000000..69d2540 --- /dev/null +++ b/src/lanctl/apps/access/gui_service.py @@ -0,0 +1,124 @@ +"""Credential GUI adapter; snapshots contain metadata, never passwords.""" + +import base64 +import os + +from lanctl.apps.access.credential_service import CredentialService +from lanctl.core.vault_crypto import MAGIC + + +class AccessGuiService: + def __init__(self, database, store, cipher="auto"): + self.manager = CredentialService(database, store) + self.manager.store.cipher = cipher + self._unlocked = False + + def _portable(self): + store = self.manager.store + if store.path.exists(): + with store.path.open("rb") as stream: + return base64.b64decode(stream.read(64), validate=True).startswith(MAGIC) + return store.cipher == "portable" or (store.cipher == "auto" and os.name != "nt") + + def snapshot(self): + locked = self._portable() and not self._unlocked + return { + "locked": locked, + "portable": self._portable(), + "newVault": not self.manager.store.path.exists(), + "records": [] if locked else self.manager.list(), + "devices": [ + { + "id": d.device_id, + "name": d.alias or d.name or d.ip, + "protocols": list(d.protocols), + } + for d in self.manager.database.load() + ], + "storage": str(self.manager.store.path), + } + + def unlock(self, password, confirmation=""): + if not self.manager.store.path.exists() and ( + len(password) < 12 or password != confirmation + ): + raise ValueError("Usa una contraseña de almacén de al menos 12 caracteres y repítela") + self.manager.store._password = password + self.manager.store.cipher = "portable" + try: + self.manager.store.metadata() + except Exception: + self.manager.store._password = None + raise + self._unlocked = True + + def lock(self): + self.manager.store._password = None + self._unlocked = False + + def set(self, selector, protocol, username, password, confirmation): + if self._portable() and not self._unlocked: + raise ValueError("Desbloquea el almacén antes de editar") + if password != confirmation: + raise ValueError("Las contraseñas no coinciden") + return {"id": self.manager.set_secret(selector, protocol, username, password)} + + def delete(self, identifier): + if self._portable() and not self._unlocked: + raise ValueError("Desbloquea el almacén antes de editar") + if not self.manager.delete(identifier): + raise ValueError("La credencial ya no existe") + + def open(self, identifier): + import argparse + import subprocess + import sys + + from lanctl.apps.ip.domain.discovery import require_real_target + from lanctl.apps.ip.interfaces.cli.commands.open import OPEN_PROTOCOLS, run_open + from lanctl.apps.suite.processes import launcher_command, process_options + + row = next((r for r in self.snapshot()["records"] if r["credentialId"] == identifier), None) + if row is None: + raise ValueError("La credencial no está disponible; desbloquea o actualiza el almacén") + device = self.manager.database.resolve(row["deviceId"]) + require_real_target(device) + protocol = row["protocol"] + if protocol not in OPEN_PROTOCOLS: + raise ValueError("Este protocolo no tiene cliente de conexión disponible") + if protocol in {"http", "https", "ftp", "smb", "rdp", "rtsp", "radmin"}: + run_open( + argparse.Namespace( + selector=device.device_id, + protocol=protocol, + port=None, + path="", + dry_run=False, + database=str(self.manager.database.path), + store=str(self.manager.store.path), + ) + ) + else: + # Interactive authentication stays in a system terminal, never process arguments. + command = launcher_command( + "lanip", + "open", + device.device_id, + "--protocol", + protocol, + "--database", + str(self.manager.database.path), + "--store", + str(self.manager.store.path), + ) + options = process_options(context_launcher="lanip") + if sys.platform == "win32": + subprocess.Popen(command, creationflags=subprocess.CREATE_NEW_CONSOLE, **options) + else: + import shutil + + terminal = shutil.which("x-terminal-emulator") or shutil.which("xterm") + if not terminal: + raise RuntimeError("No hay terminal disponible para la conexión interactiva") + subprocess.Popen([terminal, "-e", *command], **options) + return {"message": "Conexión abierta en su cliente"} diff --git a/src/lanctl/apps/access/https_server.py b/src/lanctl/apps/access/https_server.py index 5e3eb12..b9681db 100644 --- a/src/lanctl/apps/access/https_server.py +++ b/src/lanctl/apps/access/https_server.py @@ -1,7 +1,7 @@ from __future__ import annotations import json -import mimetypes +import re import ssl import threading import time @@ -29,6 +29,14 @@ } COOKIE_ATTRIBUTES = "Secure; HttpOnly; SameSite=Strict; Path=/" MAX_BODY = 64 * 1024 +STATIC_CONTENT_TYPES = {".html": "text/html", ".js": "application/javascript", ".css": "text/css"} + + +def _session_cookie(identifier): + """Keep opaque session identifiers inside one cookie/header value.""" + if not isinstance(identifier, str) or not re.fullmatch(r"[A-Za-z0-9_-]{1,128}", identifier): + raise ValueError("identificador de sesión HTTP no válido") + return f"lanctl_session={identifier}; {COOKIE_ATTRIBUTES}" class HttpsCapability: @@ -161,7 +169,9 @@ def _send_file(self, path): body = path.read_bytes() except OSError: return self._send(404, {"error": "not found"}) - content_type = mimetypes.guess_type(path.name)[0] or "application/octet-stream" + # This server exposes a fixed set of bundled assets. Do not let + # OS MIME registrations supply unvalidated HTTP header values. + content_type = STATIC_CONTENT_TYPES.get(path.suffix, "application/octet-stream") self.send_response(200) self._headers(content_type, len(body)) self.end_headers() @@ -256,7 +266,7 @@ def do_POST(self): return self._send( 200, {"csrfToken": csrf, "username": user.username, "roles": user.roles}, - f"lanctl_session={session.sessionId}; {COOKIE_ATTRIBUTES}", + _session_cookie(session.sessionId), ) user = self._session(csrf=True) body = self._body() diff --git a/src/lanctl/apps/access/manager_cli.py b/src/lanctl/apps/access/manager_cli.py index caaedc2..f8ae1fe 100644 --- a/src/lanctl/apps/access/manager_cli.py +++ b/src/lanctl/apps/access/manager_cli.py @@ -8,11 +8,10 @@ from pathlib import Path from lanctl import __version__ +from lanctl.apps.access.credential_service import CredentialService from lanctl.apps.ip.domain.models import normalize_protocol from lanctl.core.config import load_config from lanctl.core.credentials import CredentialStore -from lanctl.core.database import DeviceDatabase -from lanctl.core.file_transaction import locked_files from lanctl.core.parser import LANCTLArgumentParser, normalize_help_arguments from lanctl.core.secret_input import read_secret from lanctl.core.session import coordinated_launcher @@ -57,11 +56,16 @@ def build_parser() -> LANCTLArgumentParser: "--project-dir", help="Directorio del proyecto para su almacén independiente." ) mode = parser.add_mutually_exclusive_group() + mode.add_argument("--gui", action="store_true", help="Abre la interfaz gráfica de escritorio.") mode.add_argument( "-tui", "--tui", action="store_true", help="Abre la interfaz de pantalla completa." ) mode.add_argument("--cli", "-cli", action="store_true", help="Abre la consola interactiva.") commands = parser.add_subparsers(dest="command") + commands.add_parser( + "remote-setup", + help="Crea la primera cuenta remota del servicio en Windows (requiere administrador).", + ) commands.add_parser("list", aliases=["ls"], help="Lista metadatos; nunca secretos.") show = commands.add_parser("show", help="Muestra metadatos de una credencial.") show.add_argument("credential_id", help="Identificador de la credencial.") @@ -120,53 +124,17 @@ def build_parser() -> LANCTLArgumentParser: return parser -class AccessManager: - def __init__(self, database_path: str, store_path: str) -> None: - self.database = DeviceDatabase(database_path) - self.store = CredentialStore(store_path) - - def list(self) -> list[dict[str, str]]: - devices = {device.device_id: device for device in self.database.load()} - rows = self.store.metadata() - for row in rows: - device = devices.get(row["deviceId"]) - row["element"] = ( - device.alias or device.name or device.ip or device.mac - if device - else row["deviceId"] - ) - return rows +class AccessManager(CredentialService): + """Compatible CLI adapter: obtain secrets interactively, then call the service.""" def set(self, selector: str, protocol: str, username: str) -> str: - device = self.database.resolve(selector) - normalized = normalize_protocol(protocol) password = read_secret("Contraseña (no se mostrará): ") confirmation = read_secret("Repite la contraseña: ") if not password: raise ValueError("la contraseña no puede estar vacía") if password != confirmation: raise ValueError("las contraseñas no coinciden") - with locked_files([self.store.path, self.database.path]): - previous = self.store._load() - identifier = self.store.set(device.device_id, normalized, username, password) - try: - self.database.bind_credential(selector, normalized, identifier) - except (OSError, ValueError): - self.store._save(previous) - raise - return identifier - - def delete(self, identifier: str) -> bool: - metadata = next( - (row for row in self.store.metadata() if row["credentialId"] == identifier), None - ) - if metadata is None: - return False - for device in self.database.load(): - for protocol, reference in tuple(device.credentials.items()): - if reference == identifier: - self.database.unbind_credential(device.device_id, protocol) - return self.store.delete(identifier) + return self.set_secret(selector, protocol, username, password) def _print_rows(rows: list[dict[str, str]]) -> None: @@ -308,6 +276,10 @@ def _main(argv: list[str] | None = None) -> int: configure_utf8_stdio() arguments = normalize_help_arguments(list(sys.argv[1:] if argv is None else argv)) args = build_parser().parse_args(arguments) + if args.command == "remote-setup": + from lanctl.apps.access.remote_setup import run_remote_setup + + return run_remote_setup() if args.scope == "windows": import os @@ -324,6 +296,10 @@ def _main(argv: list[str] | None = None) -> int: args.store = str(Path(args.project_dir).resolve() / "access" / "credentials.vault") if args.cipher == "auto" and not Path(args.store).exists(): args.cipher = "portable" + if getattr(args, "gui", False): + from lanctl.apps.suite.launcher_gui import run_gui + + return run_gui("lanaccess", database=args.database, store=args.store, cipher=args.cipher) manager = AccessManager(args.database, args.store) manager.store.cipher = args.cipher if args.command == "credential": diff --git a/src/lanctl/apps/access/remote_setup.py b/src/lanctl/apps/access/remote_setup.py new file mode 100644 index 0000000..2ae42a2 --- /dev/null +++ b/src/lanctl/apps/access/remote_setup.py @@ -0,0 +1,219 @@ +"""Local, privileged first-account wizard for an installed Windows service.""" + +from __future__ import annotations + +import ctypes +import os +import stat +import sys +from pathlib import Path +from threading import Event, RLock, Thread + +from lanctl.apps.access.auth import AuthenticationService +from lanctl.apps.access.store import AccessStore +from lanctl.core.file_transaction import locked_file +from lanctl.core.local_permissions import require_admin + + +def _program_data(): + # Ask Windows rather than accepting an inherited environment override. + shell = ctypes.WinDLL("shell32", use_last_error=True) + query = shell.SHGetFolderPathW + query.argtypes = [ + ctypes.c_void_p, + ctypes.c_int, + ctypes.c_void_p, + ctypes.c_uint32, + ctypes.c_wchar_p, + ] + query.restype = ctypes.c_long + buffer = ctypes.create_unicode_buffer(260) + if query(None, 0x0023, None, 0, buffer) != 0 or not buffer.value: + raise OSError("Windows no pudo resolver el directorio de datos del servicio") + return Path(buffer.value) + + +def _reject_redirected_paths(paths): + for path in paths: + try: + info = path.lstat() + except FileNotFoundError: + continue + if stat.S_ISLNK(info.st_mode) or getattr(info, "st_file_attributes", 0) & getattr( + stat, "FILE_ATTRIBUTE_REPARSE_POINT", 0x400 + ): + raise ValueError("El asistente no admite rutas de servicio redirigidas") + + +def _installed_store_path(): + require_admin() + from lanctl.core.config import CONFIG_PATH, load_config + from lanctl.core.paths import is_portable_install + + if os.name != "nt" or not getattr(sys, "frozen", False) or is_portable_install(): + raise ValueError("Este asistente requiere LANCTL instalado en Windows") + root = _program_data() / "LANCTL" + target = root / "access" / "users.dc" + _reject_redirected_paths( + [ + root, + root / "config", + root / "config/config.json", + target.parent, + target, + target.with_name("users.json"), + target.with_name("users.dc.lock"), + ] + ) + if not target.parent.is_dir(): + raise ValueError("Ejecuta Setup para preparar el directorio protegido del servicio") + if CONFIG_PATH.resolve() != (root / "config/config.json").resolve(): + raise ValueError( + "La configuración personalizada requiere el administrador de acceso existente" + ) + configured = str(load_config()["accessUsers"]).replace("\\", "/") + if configured not in {"data/lc/access/users.dc", "data/lc/access/users.json"} and ( + not Path(configured).is_absolute() or Path(configured).resolve() != target.resolve() + ): + raise ValueError("El almacén personalizado requiere el administrador de acceso existente") + if os.environ.get("LANCTL_SECRET_DIR") or os.environ.get("LANCTL_DATA_DIR"): + raise ValueError("El asistente requiere las rutas de servicio de la instalación") + return target + + +class InitialRemoteAccount: + """Never expose this service as a remote endpoint or grant OS privileges.""" + + def __init__(self, path): + self.path = Path(path) + + def status(self): + require_admin() + with locked_file(self.path): + has_users = bool(AccessStore(self.path).users()) + return { + "scope": "service", + "storage": str(self.path), + "hasUsers": has_users, + "canCreate": not has_users, + "roleLabel": "Administrador de LANACCESS", + "message": "Ya existen cuentas; se conservan sin cambios." + if has_users + else "Crea la primera cuenta remota del servicio. Este paso no activa SSH ni HTTPS.", + } + + def create(self, username, password, confirmation): + require_admin() + if not isinstance(username, str) or not 3 <= len(username.strip()) <= 64: + raise ValueError("Indica un usuario remoto de entre 3 y 64 caracteres") + if not isinstance(password, str) or not 12 <= len(password) <= 1024: + raise ValueError("La contraseña debe tener entre 12 y 1024 caracteres") + if not isinstance(confirmation, str) or password != confirmation: + raise ValueError("Las contraseñas no coinciden") + with locked_file(self.path): + store = AccessStore(self.path) + if store.users(): + raise ValueError( + "Ya existen cuentas; usa el administrador de acceso para modificarlas" + ) + user = AuthenticationService(store).add_user( + username, roles=("administrator",), password=password + ) + return { + "created": True, + "username": user.username, + "scope": "service", + "message": "Cuenta creada. Configura el acceso remoto antes de habilitar SSH o HTTPS.", + } + + +class _InstalledRemoteAccount: + """Resolve scope on each RPC so setup errors remain visible in the wizard.""" + + def status(self): + return InitialRemoteAccount(_installed_store_path()).status() + + def create(self, username, password, confirmation): + return InitialRemoteAccount(_installed_store_path()).create( + username, password, confirmation + ) + + +class RemoteSetupApi: + def __init__(self, service): + self._service = service + self._window = None + self._lock = RLock() + self._closing = False + + def _respond(self, operation, action): + try: + with self._lock: + if self._closing: + raise ValueError("El asistente ya se está cerrando") + return {"ok": True, **operation()} + except Exception as exc: # noqa: BLE001 - local RPC boundary retains error origin + from lanctl.core.errors import errors + + event = errors.from_exception( + exc, + origin=f"LANCTL.Access.Setup.{action}", + code="ACCESS.SETUP.FAILED", + level=43, + print_output=False, + ) + return { + "ok": False, + "error": event.message, + "message": event.message, + "errorId": event.error_id, + } + + def setup_status(self): + return self._respond(self._service.status, "Read") + + def create_initial_user(self, username, password, confirmation): + return self._respond( + lambda: self._service.create(username, password, confirmation), "Create" + ) + + def request_close(self): + with self._lock: + self._closing = True + if self._window is not None: + self._window.destroy() + return {"ok": True, "closed": True} + + +def run_remote_setup(): + if os.name != "nt": + raise ValueError("Este asistente requiere LANCTL instalado en Windows") + import webview + + from lanctl.apps.suite.window_style import webview_icon_path + from lanctl.core.resources import bundled_path + + api = RemoteSetupApi(_InstalledRemoteAccount()) + api._window = webview.create_window( + "LANACCESS · Cuenta remota inicial", + bundled_path("gui/remote-setup.html").as_uri(), + js_api=api, + width=760, + height=680, + min_size=(640, 600), + background_color="#15181c", + ) + loaded = Event() + api._window.events.loaded += loaded.set + + def closing(): + if api._closing or not loaded.is_set(): + return True + Thread( + target=lambda: api._window.evaluate_js("window.remoteSetupClose()"), daemon=True + ).start() + return False + + api._window.events.closing += closing + webview.start(icon=webview_icon_path("lanaccess")) + return 0 diff --git a/src/lanctl/apps/ip/domain/models/device.py b/src/lanctl/apps/ip/domain/models/device.py index 216c574..b8d3b10 100644 --- a/src/lanctl/apps/ip/domain/models/device.py +++ b/src/lanctl/apps/ip/domain/models/device.py @@ -196,8 +196,6 @@ def from_dict(cls, value: Mapping[str, Any]) -> Device: if isinstance(raw_groups, str): raw_groups = [raw_groups] if raw_groups else [] description = str(value.get("description", "-")) or "-" - if len(description) > 42: - raise ValueError("la descripción de un elemento no puede superar 42 caracteres") return cls( ip=str(value["IP"]), cnf=normalize_cnf(value.get("cnf", False)), @@ -250,8 +248,6 @@ def __post_init__(self) -> None: self.cnf = normalize_cnf(self.cnf) if self.mac: self.mac = normalize_mac(self.mac) - if len(self.description) > 42: - raise ValueError("la descripción de un elemento no puede superar 42 caracteres") self.groups = list(dict.fromkeys(group.upper() for group in self.groups)) self.device_id = self.device_id or device_identifier(self.mac, self.ip) self.protocols = list(dict.fromkeys(normalize_protocol(item) for item in self.protocols)) diff --git a/src/lanctl/apps/ip/infrastructure/services/lan_scanner.py b/src/lanctl/apps/ip/infrastructure/services/lan_scanner.py index 21fb350..4f72103 100644 --- a/src/lanctl/apps/ip/infrastructure/services/lan_scanner.py +++ b/src/lanctl/apps/ip/infrastructure/services/lan_scanner.py @@ -21,14 +21,25 @@ SCAN_ORDERS = ("ascending", "descending", "random") -def active_arp_mac(ip: str, timeout: float = 1.0) -> str: +def active_arp_mac( + ip: str, + timeout: float = 1.0, + *, + source_address: str | None = None, + interface: str | None = None, +) -> str: """Pregunta activamente por una IPv4 local sin confiar en la caché ARP.""" + if source_address is not None: + source_address = str(ipaddress.IPv4Address(source_address)) if platform.system() == "Windows": destination = ctypes.windll.ws2_32.inet_addr(ip.encode("ascii")) mac = (ctypes.c_ubyte * 6)() length = ctypes.c_ulong(6) result = ctypes.windll.iphlpapi.SendARP( - destination, 0, ctypes.byref(mac), ctypes.byref(length) + destination, + ctypes.windll.ws2_32.inet_addr(source_address.encode("ascii")) if source_address else 0, + ctypes.byref(mac), + ctypes.byref(length), ) if result != 0 or length.value < 6: return "" @@ -36,7 +47,16 @@ def active_arp_mac(ip: str, timeout: float = 1.0) -> str: try: result = subprocess.run( - ["arping", "-c", "1", "-w", str(max(1, round(timeout))), ip], + [ + "arping", + "-c", + "1", + "-w", + str(max(1, round(timeout))), + *(["-I", interface] if interface else []), + *(["-s", source_address] if source_address else []), + ip, + ], capture_output=True, text=True, errors="replace", @@ -101,12 +121,19 @@ def __init__( max_hosts: int, scan_order: str = "ascending", gateway: str | None = None, + *, + source_address: str | None = None, ): scan_order = scan_order.casefold() if scan_order not in SCAN_ORDERS: raise ValueError( f"orden de escaneo no válido: {scan_order}. Disponibles: {', '.join(SCAN_ORDERS)}" ) + from lanctl.core.network_interfaces import select_interface + + self.interface = ( + select_interface(source_address, str(network)) if source_address is not None else None + ) self.network = network self.workers = workers self.timeout = timeout @@ -117,6 +144,16 @@ def __init__( self.confirmed_devices: set[str] = set() self.response_times_ms: dict[str, dict[str, float]] = {} + def _arp(self, ip): + if self.interface: + return active_arp_mac( + ip, + self.timeout, + source_address=self.interface["address"], + interface=self.interface["name"], + ) + return active_arp_mac(ip, self.timeout) + def _ordered_hosts(self) -> list[ipaddress.IPv4Address]: if self.max_hosts < 1: raise ValueError("max_hosts debe ser positivo") @@ -210,7 +247,7 @@ def jobs(): if use_icmp: yield ("icmp", ip), self._timed, (self._ping, ip) if use_arp: - yield ("arp", ip), self._timed, (active_arp_mac, ip, self.timeout) + yield ("arp", ip), self._timed, (self._arp, ip) for future, (method, ip) in self._bounded_futures(executor, jobs(), futures): if progress and getattr(progress, "cancelled", lambda: False)(): @@ -312,9 +349,7 @@ def _discover_extra_services(self, extra_methods, attempts, active_arp, progress missing = [ip for ip in ips if ip not in active_arp] if missing: - macs = self._parallel( - lambda ip: active_arp_mac(ip, self.timeout), missing, "ARP servicios", None - ) + macs = self._parallel(self._arp, missing, "ARP servicios", None) active_arp.update({ip: mac for ip, mac in zip(missing, macs) if mac}) return findings, ips @@ -368,10 +403,14 @@ def _discovery_records( def _include_local_device(self, records): # El equipo local no aparece en su propia caché ARP. - own_ip = str(local_ipv4(self.network)) + own_ip = self.interface["address"] if self.interface else str(local_ipv4(self.network)) if ipaddress.IPv4Address(own_ip) not in self.network: return - own_mac = self._local_mac(own_ip) + own_mac = ( + self._local_mac(own_ip, interface=self.interface["name"]) + if self.interface + else self._local_mac(own_ip) + ) existing = next((record for record in records if record.ip == own_ip), None) if existing and own_mac: existing.mac = own_mac @@ -442,6 +481,20 @@ def scan( f"método de descubrimiento no válido: {discovery}. " f"Disponibles: {', '.join(DISCOVERY_MODES)}" ) + if self.interface: + from lanctl.core.errors import errors + from lanctl.core.network_interfaces import select_interface + + self.interface = select_interface(self.interface["id"], str(self.network)) + if resolve_names or extra_methods: + errors.emit( + level=12, + origin="LANCTL.Scanner.Interface.Methods", + code="SCANNER.INTERFACE.LIMITED_METHODS", + message="Interfaz fijada: se usan ICMP/ARP; DNS y descubridores externos se omiten porque no garantizan el origen", + print_output=False, + ) + resolve_names, extra_methods = False, () self.discovery_methods = {} self.confirmed_devices = set() self.response_times_ms = {} @@ -556,7 +609,7 @@ def _resolve_name(self, ip: str) -> str: return parts[1].rstrip(".") if len(parts) >= 2 else "" @staticmethod - def _local_mac(ip: str) -> str: + def _local_mac(ip: str, *, interface: str | None = None) -> str: if platform.system() == "Windows": script = ( "$a=Get-NetIPAddress -AddressFamily IPv4 " @@ -573,7 +626,7 @@ def _local_mac(ip: str) -> str: script, ] else: - command = ["ip", "-o", "link"] + command = ["ip", "-o", "link", *(["show", "dev", interface] if interface else [])] try: result = subprocess.run( @@ -593,10 +646,26 @@ def _local_mac(ip: str) -> str: def _ping(self, ip: str) -> bool: milliseconds = max(1, int(self.timeout * 1000)) if platform.system() == "Windows": + if self.interface: + from lanctl.apps.ip.infrastructure.services.source_binding import windows_ping + + return windows_ping(self.interface["address"], ip, self.timeout) command = ["ping", "-n", "1", "-w", str(milliseconds), ip] else: seconds = max(1, round(self.timeout)) - command = ["ping", "-c", "1", "-W", str(seconds), ip] + command = [ + "ping", + "-c", + "1", + "-W", + str(seconds), + *( + ["-I", self.interface["name"], "-I", self.interface["address"], "-n"] + if self.interface + else [] + ), + ip, + ] try: result = subprocess.run( @@ -613,7 +682,15 @@ def _ping(self, ip: str) -> bool: def _read_arp_table(self) -> dict[str, str]: try: result = subprocess.run( - ["arp", "-a"], + ( + ["ip", "-4", "neigh", "show", "dev", self.interface["name"]] + if self.interface and platform.system() != "Windows" + else [ + "arp", + "-a", + *(["-N", self.interface["address"]] if self.interface else []), + ] + ), capture_output=True, text=True, errors="replace", diff --git a/src/lanctl/apps/ip/infrastructure/services/source_binding.py b/src/lanctl/apps/ip/infrastructure/services/source_binding.py new file mode 100644 index 0000000..5366256 --- /dev/null +++ b/src/lanctl/apps/ip/infrastructure/services/source_binding.py @@ -0,0 +1,60 @@ +"""Explicit source adapters. Failures never fall back to another route.""" + +from __future__ import annotations + +import ctypes +import ipaddress +import socket + + +def windows_ping(source: str, destination: str, timeout: float) -> bool: + source, destination = ( + str(ipaddress.IPv4Address(source)), + str(ipaddress.IPv4Address(destination)), + ) + api = ctypes.WinDLL("iphlpapi.dll", use_last_error=True) + api.IcmpCreateFile.argtypes = [] + api.IcmpCreateFile.restype = ctypes.c_void_p + api.IcmpCloseHandle.argtypes = [ctypes.c_void_p] + api.IcmpCloseHandle.restype = ctypes.c_int + api.IcmpSendEcho2Ex.argtypes = [ + ctypes.c_void_p, + ctypes.c_void_p, + ctypes.c_void_p, + ctypes.c_void_p, + ctypes.c_uint32, + ctypes.c_uint32, + ctypes.c_void_p, + ctypes.c_ushort, + ctypes.c_void_p, + ctypes.c_void_p, + ctypes.c_uint32, + ctypes.c_uint32, + ] + api.IcmpSendEcho2Ex.restype = ctypes.c_uint32 + handle = api.IcmpCreateFile() + if not handle or handle == ctypes.c_void_p(-1).value: + raise OSError("No se pudo crear el canal ICMP con origen explícito") + payload = ctypes.create_string_buffer(b"LANCTL") + reply = ctypes.create_string_buffer(1024) + try: + count = api.IcmpSendEcho2Ex( + handle, + None, + None, + None, + int.from_bytes(socket.inet_aton(source), "little"), + int.from_bytes(socket.inet_aton(destination), "little"), + payload, + 6, + None, + reply, + len(reply), + max(1, int(timeout * 1000)), + ) + if not count and ctypes.get_last_error() in (50, 87, 1168): + raise OSError("La interfaz seleccionada no permite emitir esta sonda ICMP") + # IPAddr and Status are the first two DWORDs of ICMP_ECHO_REPLY. + return bool(count and ctypes.c_uint32.from_buffer(reply, 4).value == 0) + finally: + api.IcmpCloseHandle(handle) diff --git a/src/lanctl/apps/ip/interfaces/cli/commands/access.py b/src/lanctl/apps/ip/interfaces/cli/commands/access.py index 206b8a9..04cf561 100644 --- a/src/lanctl/apps/ip/interfaces/cli/commands/access.py +++ b/src/lanctl/apps/ip/interfaces/cli/commands/access.py @@ -10,7 +10,6 @@ import ssl import subprocess from contextlib import suppress -from dataclasses import asdict from pathlib import Path from lanctl.apps.access.keys import generate_certificate, generate_host_key @@ -259,7 +258,7 @@ def _user(service, args, words): if password != confirmation: raise ValueError("las contraseñas no coinciden") keys = [Path(path).read_text(encoding="utf-8").strip() for path in args.ssh_key] - return asdict( + return _public_user( service.auth.add_user(words[1], args.role or ["viewer"], password, keys, args.expires) ) user = service.auth.user(words[1]) @@ -297,6 +296,25 @@ def _user(service, args, words): raise ValueError("acción de usuario no válida") +def _public_user(user): + """Preserve CLI metadata without exposing current or future authenticators.""" + return { + "userId": user.userId, + "username": user.username, + "roles": user.roles, + "enabled": user.enabled, + "expiresAt": user.expiresAt, + "lockedUntil": user.lockedUntil, + "failedAttempts": user.failedAttempts, + "passwordHash": "", # Compatibility key: authenticators never leave the store. + "passwordConfigured": bool(user.passwordHash), + "sshKeys": user.sshKeys, + "createdAt": user.createdAt, + "updatedAt": user.updatedAt, + "passwordRotatedAt": user.passwordRotatedAt, + } + + def _public_session(session): return { "sessionId": session.sessionId, diff --git a/src/lanctl/apps/ip/interfaces/cli/commands/element.py b/src/lanctl/apps/ip/interfaces/cli/commands/element.py index 0005951..4135de9 100644 --- a/src/lanctl/apps/ip/interfaces/cli/commands/element.py +++ b/src/lanctl/apps/ip/interfaces/cli/commands/element.py @@ -42,7 +42,7 @@ def register_element_command(commands: argparse._SubParsersAction) -> None: "-description", "--description", dest="new_description", - help="Asigna DESCRIPTION al elemento indicado (máximo 42 caracteres).", + help="Asigna DESCRIPTION al elemento indicado.", ) command.add_argument("-cnf", "--cnf", dest="new_cnf", help="Asigna el estado CNF.") command.add_argument( diff --git a/src/lanctl/apps/ip/interfaces/cli/commands/list.py b/src/lanctl/apps/ip/interfaces/cli/commands/list.py index 9ba5602..d1fff0b 100644 --- a/src/lanctl/apps/ip/interfaces/cli/commands/list.py +++ b/src/lanctl/apps/ip/interfaces/cli/commands/list.py @@ -24,6 +24,12 @@ from lanctl.core.query import matches_query +class _ExplicitNetwork(argparse.Action): + def __call__(self, parser, namespace, values, option_string=None): + setattr(namespace, self.dest, values) + namespace.network_explicit = True + + def register_list_command(commands: argparse._SubParsersAction) -> None: config = load_config() command = commands.add_parser( @@ -36,9 +42,16 @@ def register_list_command(commands: argparse._SubParsersAction) -> None: ) command.add_argument( "--network", + action=_ExplicitNetwork, default=config["range"], help="Red CIDR. Por defecto detecta la LAN como /24.", ) + command.add_argument( + "--interface", + default=None, + help="Origen IPv4 local o ID de interfaz; usa su máscara real. Solo ICMP/ARP, sin DNS ni descubridores externos.", + ) + command.set_defaults(network_explicit=False) command.set_defaults(configured_gateway=config.get("gateway")) command.add_argument( "--database", default=config["database"], help="Archivo JSON de elementos." @@ -263,9 +276,21 @@ def run_list(args: argparse.Namespace) -> int: lab_repository = LabRepository() lab_active = lab_repository.active() - network = resolve_network(lab_active["cidr"] if lab_active else args.network) - current_host_ip = "" if lab_active else str(local_ipv4(network)) - if args.network and not lab_active: + source = getattr(args, "interface", None) + selected = None + if source is not None: + from lanctl.core.network_interfaces import select_interface + + if lab_active: + raise ValueError("Una interfaz real no se puede usar con un laboratorio activo") + requested = args.network if getattr(args, "network_explicit", bool(args.network)) else None + selected = select_interface(source, requested) + network = ipaddress.IPv4Network(requested or selected["network"], strict=False) + current_host_ip = selected["address"] + else: + network = resolve_network(lab_active["cidr"] if lab_active else args.network) + current_host_ip = "" if lab_active else str(local_ipv4(network)) + if args.network and not lab_active and not selected: local_ip = local_ipv4(network) if local_ip not in network: suggested = resolve_network(None) @@ -304,6 +329,7 @@ def run_list(args: argparse.Namespace) -> int: max_hosts=args.max_hosts, scan_order=args.scan_order, gateway=args.configured_gateway, + **({"source_address": selected["id"]} if selected else {}), ) ) progress = getattr(args, "progress_instance", None) or ScanProgress(args.progress) diff --git a/src/lanctl/apps/ip/interfaces/cli/commands/settings.py b/src/lanctl/apps/ip/interfaces/cli/commands/settings.py index bfd2f41..e91cfa0 100644 --- a/src/lanctl/apps/ip/interfaces/cli/commands/settings.py +++ b/src/lanctl/apps/ip/interfaces/cli/commands/settings.py @@ -46,6 +46,16 @@ def register_settings_command(commands: argparse._SubParsersAction) -> None: "settings", help="Consulta o modifica la configuración persistente de LANCTL.", ) + command.add_argument( + "--startup-interface", + choices=("cli", "tui", "gui"), + help="Interfaz preferida al abrir LANCTL sin argumentos.", + ) + command.add_argument( + "--close-gui-on-launch", + choices=("on", "off"), + help="Cierra la GUI principal cuando el launcher solicitado esté disponible.", + ) command.add_argument( "-range", dest="network_range", @@ -229,7 +239,10 @@ def register_settings_command(commands: argparse._SubParsersAction) -> None: metavar="ACCIÓN=on|off", help="Muestra u oculta una acción concreta de la barra inferior. Puede repetirse.", ) - command.set_defaults(handler=run_settings) + from .settings_menu import dispatch_settings, register_catalog_options + + register_catalog_options(command) + command.set_defaults(handler=dispatch_settings) @transactional_file(CONFIG_PATH) @@ -237,6 +250,8 @@ def run_settings(args: argparse.Namespace) -> int: config = load_config() if ( args.network_range is None + and getattr(args, "startup_interface", None) is None + and getattr(args, "close_gui_on_launch", None) is None and args.list_fields is None and args.dhcp_range is None and args.credentials is None @@ -255,6 +270,7 @@ def run_settings(args: argparse.Namespace) -> int: and args.physical_database is None and args.groups is None and args.log is None + and args.error_log_level is None and args.projects_directory is None and args.save_mode is None and args.save_interval is None @@ -281,6 +297,12 @@ def run_settings(args: argparse.Namespace) -> int: return 0 changes: list[str] = [] + if getattr(args, "startup_interface", None) is not None: + config["startupInterface"] = args.startup_interface + changes.append(f"Interfaz de inicio: {args.startup_interface}") + if getattr(args, "close_gui_on_launch", None) is not None: + config["closeGuiOnLaunch"] = args.close_gui_on_launch == "on" + changes.append(f"Cerrar GUI al abrir launcher: {args.close_gui_on_launch}") if args.save_mode is not None: from lanctl.core.projects.save_policy import available_save_modes, normalize_save_mode diff --git a/src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py b/src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py new file mode 100644 index 0000000..03fb315 --- /dev/null +++ b/src/lanctl/apps/ip/interfaces/cli/commands/settings_menu.py @@ -0,0 +1,255 @@ +"""Categorized CLI editor; legacy settings flags remain supported.""" + +from __future__ import annotations + +import argparse +import json +import sys + +from lanctl.core.config import load_config +from lanctl.core.settings_catalog import CATEGORIES, catalog, leaves, set_program_value + + +def register_catalog_options(command): + action = command.add_mutually_exclusive_group() + action.add_argument( + "--menu", + action="store_true", + help="Editor interactivo por categorías de programa y proyecto.", + ) + action.add_argument( + "--catalog", + action="store_true", + help="Lista todos los ajustes por categorías, con valor y estado editable.", + ) + action.add_argument( + "--get", metavar="RUTA", help="Consulta un ajuste por su ruta, por ejemplo ip.workers." + ) + action.add_argument( + "--set", + nargs=2, + metavar=("RUTA", "VALOR"), + help="Modifica un ajuste; listas y booleanos usan JSON.", + ) + command.add_argument( + "--scope", + choices=("program", "project"), + default="program", + help="Ámbito de configuración (predeterminado: program).", + ) + command.add_argument( + "--category", help="Filtra el catálogo por categoría, por ejemplo network o monitor." + ) + + +def _project(): + from lanctl.core.projects.current import active_project_info + + project = active_project_info() + if not project or not project["valid"]: + raise ValueError( + "Selecciona un proyecto VLF válido con project use antes de configurar el proyecto" + ) + return project["path"] + + +def _entries(scope): + if scope == "program": + entries = catalog(load_config()) + from lanctl.core.config import canonical_config + + entries.append( + { + "path": "access.remote", + "category": "access", + "value": canonical_config(load_config())["access"]["remote"], + "readOnly": "", + } + ) + return sorted(entries, key=lambda entry: list(CATEGORIES).index(entry["category"])) + from lanctl.core.projects.settings import PROJECT_EDITABLE, project_settings + + return [ + { + "path": path, + "category": path.split(".")[0], + "value": value, + "readOnly": "Campo automático o derivado" + if path.split(".")[1] not in PROJECT_EDITABLE.get(path.split(".")[0], set()) + else "", + } + for path, value in leaves(project_settings(_project())) + ] + + +def _decode(text): + try: + return json.loads(text) + except json.JSONDecodeError: + return text + + +def _set(scope, path, text): + entries = {entry["path"]: entry for entry in _entries(scope)} + if path not in entries: + raise ValueError(f"Ajuste desconocido: {path}") + if entries[path]["readOnly"]: + raise ValueError(f"{path}: solo lectura. {entries[path]['readOnly']}") + value = _decode(text) + if scope == "project": + from lanctl.core.projects.settings import update_project_setting + + category, key = path.split(".", 1) + update_project_setting(_project(), category, key, value) + return + # Reuse the existing command for remote settings: it validates the endpoint + # and applies the service backend, rather than just changing a JSON flag. + if path == "access.remote" or path.startswith("access.remote."): + from .settings import register_settings_command, run_settings + + flags = { + "enabled": "--remote-access", + "bind": "--remote-bind", + "cidr": "--remote-cidr", + "port": "--remote-port", + "passwordAuthentication": "--remote-password-auth", + "backend": "--remote-backend", + "forcedView": "--remote-forced-view", + } + from lanctl.core.config import DOCUMENT_DEFAULTS + from lanctl.core.settings_catalog import validate_value + + values = value if path == "access.remote" else {path.rsplit(".", 1)[1]: value} + if not isinstance(values, dict) or not values: + raise ValueError("access.remote requiere un objeto JSON con ajustes remotos") + arguments = ["settings"] + for key, item in values.items(): + if key not in flags: + raise ValueError(f"Ajuste remoto desconocido: {key}") + validate_value(f"access.remote.{key}", item, DOCUMENT_DEFAULTS["access"]["remote"][key]) + rendered = ("on" if item else "off") if isinstance(item, bool) else str(item) + arguments.extend([flags[key], rendered]) + parser = argparse.ArgumentParser() + register_settings_command(parser.add_subparsers()) + run_settings(parser.parse_args(arguments)) + else: + set_program_value(path, value) + + +def _print_entries(entries): + previous = None + for entry in entries: + category = entry["category"] + if category != previous: + print(f"\n[{category}] {CATEGORIES.get(category, category)}") + previous = category + state = f" [solo lectura: {entry['readOnly']}]" if entry["readOnly"] else "" + print(f" {entry['path']} = {json.dumps(entry['value'], ensure_ascii=False)}{state}") + + +def configuration_menu(): + try: + while True: + print("\nConfiguración LANCTL\n1. Programa completo\n2. Proyecto activo\n0. Volver") + choice = input("> ").strip() + if choice in {"0", "", "q"}: + return 0 + if choice not in {"1", "2"}: + continue + scope = "program" if choice == "1" else "project" + try: + entries = _entries(scope) + except ValueError as error: + print(error) + continue + while True: + categories = list(dict.fromkeys(entry["category"] for entry in entries)) + for number, category in enumerate(categories, 1): + print(f"{number}. {CATEGORIES.get(category, category)} ({category})") + selection = input("Categoría (0: volver): ").strip() + if selection in {"0", "", "q"}: + break + if not selection.isdigit() or not 1 <= int(selection) <= len(categories): + continue + category = categories[int(selection) - 1] + while True: + entries = _entries(scope) + subset = [entry for entry in entries if entry["category"] == category] + for number, entry in enumerate(subset, 1): + state = " [solo lectura]" if entry["readOnly"] else "" + print( + f"{number}. {entry['path']} = {json.dumps(entry['value'], ensure_ascii=False)}{state}" + ) + selected = input("Ajuste (0: volver): ").strip() + if selected in {"0", "", "q"}: + break + if not selected.isdigit() or not 1 <= int(selected) <= len(subset): + continue + entry = subset[int(selected) - 1] + if entry["readOnly"]: + print(entry["readOnly"]) + continue + text = input("Nuevo valor (JSON para listas/booleanos; vacío: cancelar): ") + if not text: + continue + try: + _set(scope, entry["path"], text) + print("Configuración guardada.") + except (ValueError, OSError) as error: + print(f"No se ha podido guardar: {error}") + except (EOFError, KeyboardInterrupt): + print("\nConfiguración cerrada.") + return 0 + + +def dispatch_settings(args): + from .settings import run_settings + + requested = ( + args.menu + or args.catalog + or args.get is not None + or args.set is not None + or args.category + or args.scope == "project" + ) + legacy = [ + key + for key, value in vars(args).items() + if key not in {"handler", "command", "menu", "catalog", "get", "set", "scope", "category"} + and value is not None + ] + # Parser namespaces may contain launcher metadata. Only the options registered + # on the settings parser count as legacy mutations. + parser = argparse.ArgumentParser() + from .settings import register_settings_command + + sub = parser.add_subparsers() + register_settings_command(sub) + defaults = vars(parser.parse_args(["settings"])) + legacy = [key for key in legacy if key in defaults and vars(args)[key] != defaults[key]] + if requested and legacy: + raise ValueError("Usa el menú/catálogo separado de las opciones clásicas de modificación") + if args.menu or (not requested and not legacy and sys.stdin.isatty() and sys.stdout.isatty()): + return configuration_menu() + if not requested: + return run_settings(args) + if args.set is not None: + if args.category: + raise ValueError("--category filtra consultas, no modificaciones") + _set(args.scope, *args.set) + print("Configuración guardada.") + return 0 + entries = _entries(args.scope) + if args.category: + entries = [entry for entry in entries if entry["category"] == args.category] + if not entries: + raise ValueError(f"Categoría desconocida: {args.category}") + if args.get is not None: + found = next((entry for entry in entries if entry["path"] == args.get), None) + if found is None: + raise ValueError(f"Ajuste desconocido: {args.get}") + print(json.dumps(found["value"], ensure_ascii=False, indent=2)) + else: + _print_entries(entries) + return 0 diff --git a/src/lanctl/apps/ip/interfaces/cli/main.py b/src/lanctl/apps/ip/interfaces/cli/main.py index b22ba08..7a80c96 100644 --- a/src/lanctl/apps/ip/interfaces/cli/main.py +++ b/src/lanctl/apps/ip/interfaces/cli/main.py @@ -133,6 +133,11 @@ def build_parser( action="store_true", help="Abre la interfaz gráfica de LANIP.", ) + parser.add_argument( + "--first-scan", + action="store_true", + help="Solicita confirmación del primer escaneo al abrir la GUI; no escanea automáticamente.", + ) parser.add_argument( "--cli", "-cli", @@ -223,6 +228,8 @@ def main(argv: list[str] | None = None, *, program_name: str = "LANCTL") -> int: write_log(f"COMMAND LANCTL {' '.join(arguments)}".rstrip()) parser = build_parser(include_plugin_commands=True, program_name=program_name) args = parser.parse_args(arguments) + if args.first_scan and (not args.gui or args.command or args.cli or args.tui): + parser.error("--first-scan requiere --gui sin otros modos ni comandos") project_independent = bool(getattr(args, "project_independent", False)) if plugins_active and (args.tui or (not args.command and not args.cli and not args.gui)): from lanctl.core.terminal_integration import route_tui @@ -266,6 +273,10 @@ def main(argv: list[str] | None = None, *, program_name: str = "LANCTL") -> int: autosave_scheduler = start_autosave_scheduler() if args.gui: + if args.first_scan: + from lanctl.core.first_scan import request_first_scan + + request_first_scan() from lanctl.apps.ip.interfaces.gui.desktop import run_gui return run_gui() diff --git a/src/lanctl/apps/ip/interfaces/gui/desktop.py b/src/lanctl/apps/ip/interfaces/gui/desktop.py index aec388e..568b88f 100644 --- a/src/lanctl/apps/ip/interfaces/gui/desktop.py +++ b/src/lanctl/apps/ip/interfaces/gui/desktop.py @@ -2,6 +2,7 @@ from __future__ import annotations +import argparse import contextlib import hashlib import io @@ -11,9 +12,10 @@ import sys import tempfile from pathlib import Path -from threading import Event +from threading import Event, Thread from lanctl.apps.ip.interfaces.gui.main import GuiApi +from lanctl.apps.suite.gui_support import GuiSupportMixin from lanctl.core.config import load_config from lanctl.core.progress import ScanProgress from lanctl.core.projects import ( @@ -41,19 +43,41 @@ def snapshot(self): # Explicit allow-list: never expose arbitrary CLI execution through the WebView. SETTINGS = ( + ("Inicio", "startupInterface", "Inicio de LANCTL: cli / tui / gui", "--startup-interface"), + ("Inicio", "closeGuiOnLaunch", "Cerrar LANCTL al abrir un launcher", "--close-gui-on-launch"), ("Red", "range", "Red autorizada (CIDR)", "-range"), ("Red", "discovery", "Detección: icmp / arp / hybrid", "--discovery"), + ("Red", "dhcpRange", "Rango DHCP (off: desactivado)", "--dhcp-range"), ("Escaneo", "scanProfile", "Perfil: fast / normal / accurate", "--scan-profile"), ("Escaneo", "workers", "Procesos concurrentes", "--workers"), ("Escaneo", "timeout", "Timeout (segundos)", "--timeout"), ("Escaneo", "maxHosts", "Límite de hosts", "--max-hosts"), + ("Escaneo", "scanOrder", "Orden de sondeo", "--scan-order"), + ("Escaneo", "serviceIdentification", "Identificar servicios", "--service-identification"), + ( + "Retención", + "disconnectedRetention", + "Conservación de desconectados", + "--disconnected-retention", + ), + ("Retención", "disconnectedRetentionTarget", "Equipos afectados", "--disconnected-target"), + ("Retención", "disconnectedRetentionScope", "Ámbito de la regla", "--disconnected-scope"), ("Proyectos", "projectsDirectory", "Carpeta de proyectos (auto)", "--projects-directory"), ("Proyectos", "projectSaveMode", "Política de guardado", "--save-mode"), + ( + "Proyectos", + "projectSaveIntervalMinutes", + "Intervalo de guardado (minutos)", + "--save-interval", + ), ("Logs", "errorLogLevel", "Nivel de registro (1-59)", "--error-log-level"), + ("Logs", "logCleanupEnabled", "Limpieza automática de registros", "--log-cleanup"), + ("Logs", "logRetentionDays", "Conservación de registros (días)", "--log-retention-days"), + ("CLI", "cliCommandChaining", "Encadenar órdenes con ;", "--cli-command-chaining"), ) -class DesktopApi(GuiApi): +class DesktopApi(GuiSupportMixin, GuiApi): def __init__(self): super().__init__() self._scan_progress = DesktopProgress() @@ -70,8 +94,45 @@ def _serialize(self, device): result["active"] = self._activity.get(device.device_id, False) result["editableCnf"] = device.cnf result["editRevision"] = self._edit_revision(device) + result["idf"] = device.idf + result["realTarget"] = not ( + "SIMULATED" in device.discovery_methods or device.protocol_options.get("simulation") + ) return result + def _inventory_payload(self, query=""): + payload = super()._inventory_payload(query) + payload["groupCatalog"] = [ + {"name": group.name, "description": group.description, "editable": group.editable} + for group in self._groups(load_config(), self._database()).load() + ] + return payload + + @staticmethod + def _editable_snapshot(device): + return {**GuiApi._editable_snapshot(device), "ip": device.ip, "idf": device.idf} + + def device_record(self, selector): + """Read the complete stored identity without initiating network probes.""" + + def operation(): + from lanctl.core.history import redact + + device = self._database().resolve(selector) + record = device.to_dict() + record.pop("credentials", None) + # Credential references and protocol options can contain sensitive material. + for key in list(record): + if "credential" in key.casefold(): + record.pop(key) + return { + "device": self._serialize(device), + "record": redact(record), + "editable": self._editable_snapshot(device), + } + + return self._respond(operation) + def _edit_revision(self, device): return hashlib.sha256( json.dumps(self._editable_snapshot(device), sort_keys=True).encode() @@ -88,6 +149,8 @@ def operation(): "description", "cnf", "icon", + "ip", + "idf", }: raise ValueError("Campos de edición no válidos.") config = load_config() @@ -147,6 +210,37 @@ def operation(): return self._respond(operation) + def create_group(self, name, description=""): + def operation(): + from lanctl.core.projects.save_policy import SaveTrigger, save_active_project + + self._groups(load_config(), self._database()).create(str(name).strip(), description) + save_active_project(SaveTrigger.CHANGE) + return {**self._inventory_payload(), "message": f"Grupo creado: {name}"} + + return self._respond(operation) + + def open_cli(self): + def operation(): + from lanctl.apps.suite.processes import open_system_cli + + open_system_cli("lanip") + return {"message": "CLI de LANIP abierto en la terminal del sistema."} + + return self._respond(operation) + + def open_suite(self): + def operation(): + from lanctl.apps.suite.processes import launcher_command, process_options + + flags = subprocess.CREATE_NO_WINDOW if sys.platform == "win32" else 0 + subprocess.Popen( + launcher_command("lanctl", "--gui"), creationflags=flags, **process_options() + ) + return {"message": "GUI de LANCTL abierta."} + + return self._respond(operation) + def _respond(self, operation): # Do not queue stale edits/project changes behind a long-running scan. if not self._lock.acquire(blocking=False): @@ -169,19 +263,42 @@ def _respond(self, operation): level=25 if isinstance(error, InterruptedError) else 43, print_output=False, ) - return {"ok": False, "error": event.message, "errorId": event.error_id} + return { + "ok": False, + "error": event.message, + "errorId": event.error_id, + "errorDetails": event.to_dict(), + } finally: self._lock.release() - def scan_network(self, profile="normal"): + def scan_network(self, profile="normal", source=None, network=None): if not self._lock.acquire(blocking=False): return {"ok": False, "error": "Hay una operación en curso."} try: + if source is not None or network is not None: + from lanctl.core.network_interfaces import select_interface + + if not isinstance(network, str) or not network.strip(): + raise ValueError("Confirma el rango de la interfaz seleccionada") + selected = select_interface(source, network) + source = selected["id"] self._scan_progress = DesktopProgress() self._running.set() self._activity.clear() self._response_ms.clear() - return super().scan_network(profile) + response = self._scan_with_target(profile, source, network) + if response.get("ok") and source is not None: + from lanctl.core.first_scan import consume_request + + consume_request() + return response + except (ValueError, OSError) as error: + + def fail(failure=error): + raise failure + + return self._respond(fail) finally: self._running.clear() self._lock.release() @@ -189,6 +306,36 @@ def scan_network(self, profile="normal"): def scan_status(self): return {"ok": True, "running": self._running.is_set(), **self._scan_progress.snapshot()} + def first_scan_options(self): + def options(): + from lanctl.core.first_scan import scan_choices + + result = scan_choices() + result["localIp"] = self._local_ip + return result + + return self._respond(options) + + def scan_targets(self): + def options(): + from lanctl.core.first_scan import scan_choices + from lanctl.core.network_interfaces import ipv4_interfaces + + result = scan_choices() + if not result["requested"]: + result["networks"] = ipv4_interfaces() + result["interfaceSelectionAvailable"] = bool(result["networks"]) + result["routing"] = "selected-source" if result["networks"] else "unavailable" + result["localIp"] = self._local_ip + return result + + return self._respond(options) + + def dismiss_first_scan(self): + from lanctl.core.first_scan import consume_request + + return self._respond(lambda: {"dismissed": consume_request()}) + def cancel_scan(self): self._scan_progress.stop.set() return {"ok": True, "message": "Cancelación solicitada; finalizando las sondas en curso."} @@ -223,13 +370,18 @@ def operation(): return self._respond(operation) - def create_project(self, name, directory="", discard=False): + def create_project(self, name, directory="", discard=False, metadata=None): def operation(): if workspace_is_dirty(load_config()) and discard is not True: raise ValueError("Guarda los cambios pendientes antes de crear otro proyecto.") clean = str(name).strip() if not clean or len(clean) > 80 or any(c in clean for c in '/\\:<>"|?*'): raise ValueError("Nombre de proyecto no válido.") + from lanctl.core.projects.metadata import FIELDS, validate_metadata + + values = validate_metadata( + {key: "" for key, *_ in FIELDS} | (metadata or {}) | {"name": clean} + ) destination = resolve_project_path( clean + ".vlf", directory or load_config().get("projectsDirectory") ) @@ -245,7 +397,16 @@ def operation(): databaseLog=None, ) result = create_project( - destination, name=clean, config=config, initialize_reserved=False + destination, + name=clean, + config=config, + initialize_reserved=False, + description=values["description"], + author=values["author"], + lan_name=values["lan"], + location=values["location"], + company=values["company"], + responsible=values["responsible"], ) if discard is True: self._discard_current() @@ -261,10 +422,17 @@ def operation(): return self._respond(operation) def open_terminal(self, selector): - return self.open_device(selector, "auto") + def operation(): + device = self._database().resolve(selector) + protocol = next((p for p in ("ssh", "tr-064", "telnet") if p in device.protocols), None) + if protocol is None: + raise ValueError("El equipo no dispone de un protocolo de terminal.") + return self.open_device(selector, protocol) + + return self._respond(operation) def open_device(self, selector, protocol="auto", port=None): - def operation(): + def operation(protocol=protocol): from lanctl.apps.ip.domain.discovery import require_real_target from lanctl.apps.ip.interfaces.cli.commands.open import OPEN_PROTOCOLS @@ -274,6 +442,28 @@ def operation(): raise ValueError("El dispositivo no dispone de un acceso válido.") if port is not None and not 1 <= int(port) <= 65535: raise ValueError("El puerto debe estar entre 1 y 65535.") + if protocol == "auto": + from lanctl.apps.ip.interfaces.cli.commands.open import _automatic_protocol + + protocol = _automatic_protocol(device) + if protocol not in OPEN_PROTOCOLS: + raise ValueError("El servicio detectado no dispone de un cliente de acceso.") + if protocol in {"http", "https", "ftp", "smb", "rdp", "rtsp", "radmin"}: + from lanctl.apps.ip.interfaces.cli.commands.open import run_open + + config = load_config() + run_open( + argparse.Namespace( + selector=device.device_id, + protocol=protocol, + port=port, + path="", + dry_run=False, + database=config["database"], + store=config["credentials"], + ) + ) + return {"message": "Acceso abierto directamente en su aplicación"} if getattr(sys, "frozen", False): command = [ str( @@ -329,11 +519,32 @@ def redo_edit(self): def get_settings(self): def operation(): + from lanctl.apps.ip.interfaces.cli.main import build_parser + config = load_config() + parser = build_parser()._subparsers._group_actions[0].choices["settings"] + choices = { + option: action.choices + for action in parser._actions + for option in action.option_strings + if action.choices + } return { "fields": [ - {"section": section, "key": key, "label": label, "value": config.get(key)} - for section, key, label, _ in SETTINGS + { + "section": section, + "key": key, + "label": label, + "value": ("on" if config[key] else "off") + if type(config.get(key)) is bool + else ( + config.get(key) + if config.get(key) is not None + else ("off" if key == "dhcpRange" else "") + ), + "choices": list(choices[option]) if option in choices else None, + } + for section, key, label, option in SETTINGS ] } @@ -394,20 +605,26 @@ def run_gui(): "LANIP · Inventario de red", bundled_path("gui/index.html").as_uri(), js_api=api, - width=1440, - height=900, + width=1280, + height=800, min_size=(960, 640), background_color="#101820", ) api.attach_window(window) + loaded = Event() + window.events.loaded += loaded.set def closing(): - if api._closing: + if api._closing or not loaded.is_set(): return True - window.evaluate_js("desktopClose()") + # evaluate_js waits for WebView dispatch: never call it on the native close thread. + Thread(target=lambda: window.evaluate_js("desktopClose()"), daemon=True).start() return False window.events.closing += closing + from lanctl.apps.suite.window_style import apply_dark_caption, webview_icon_path + + window.events.shown += lambda: apply_dark_caption(window, "lanip") from lanctl.apps.access.root_control import RootInterfaceAgent def remote_action(command): @@ -417,9 +634,10 @@ def remote_action(command): window.restore() window.show() - agent = RootInterfaceAgent("gui", remote_action).start() + agent = RootInterfaceAgent("gui", remote_action) + window.events.loaded += agent.start try: - webview.start(debug=False) + webview.start(debug=False, icon=webview_icon_path("lanip")) finally: agent.stop() return 0 diff --git a/src/lanctl/apps/ip/interfaces/gui/main.py b/src/lanctl/apps/ip/interfaces/gui/main.py index c2dc837..e6b4868 100644 --- a/src/lanctl/apps/ip/interfaces/gui/main.py +++ b/src/lanctl/apps/ip/interfaces/gui/main.py @@ -296,21 +296,25 @@ def operation() -> dict: return self._respond(operation) def scan_network(self, profile: str = "normal") -> dict: + return self._scan_with_target(profile) + + def _scan_with_target(self, profile="normal", source=None, network=None): def operation() -> dict: if profile not in {"fast", "normal", "accurate"}: raise ValueError("perfil de escaneo GUI no válido") from lanctl.apps.ip.interfaces.cli.main import build_parser - args = build_parser().parse_args( - [ - "list", - "--profile", - profile, - "--no-progress", - "--format", - "json", - ] - ) + arguments = [ + "list", + "--profile", + profile, + "--no-progress", + "--format", + "json", + ] + if source is not None: + arguments.extend(["--interface", source, "--network", network]) + args = build_parser().parse_args(arguments) def capture(rows, activity) -> None: for row, active in zip(rows, activity): diff --git a/src/lanctl/apps/ip/interfaces/tui/controllers.py b/src/lanctl/apps/ip/interfaces/tui/controllers.py index 570ad99..1e9896d 100644 --- a/src/lanctl/apps/ip/interfaces/tui/controllers.py +++ b/src/lanctl/apps/ip/interfaces/tui/controllers.py @@ -8,7 +8,7 @@ from lanctl.apps.ip.interfaces.tui.modal import ModalState, SettingField from lanctl.core.layout import fit_text -SETTINGS_FOOTER = "←/→ menú ↑/↓ variable Tab editar Esc salir" +SETTINGS_FOOTER = "←/→ menú ↑/↓ variable Tab editar Ctrl+S guardar Esc salir" class SettingsEditor: diff --git a/src/lanctl/apps/ip/interfaces/tui/keyboard.py b/src/lanctl/apps/ip/interfaces/tui/keyboard.py index 7ca0e32..37626cf 100644 --- a/src/lanctl/apps/ip/interfaces/tui/keyboard.py +++ b/src/lanctl/apps/ip/interfaces/tui/keyboard.py @@ -306,6 +306,10 @@ def posix_terminal_mode(stream): previous = termios.tcgetattr(descriptor) try: tty.setcbreak(descriptor) + current = termios.tcgetattr(descriptor) + # Ctrl+S/Ctrl+Q must reach the application, not stop/start TTY output. + current[0] &= ~(termios.IXON | termios.IXOFF) + termios.tcsetattr(descriptor, termios.TCSADRAIN, current) yield finally: termios.tcsetattr(descriptor, termios.TCSADRAIN, previous) diff --git a/src/lanctl/apps/ip/interfaces/tui/main.py b/src/lanctl/apps/ip/interfaces/tui/main.py index c4b7676..a227009 100644 --- a/src/lanctl/apps/ip/interfaces/tui/main.py +++ b/src/lanctl/apps/ip/interfaces/tui/main.py @@ -698,6 +698,10 @@ def _render_modal(self, width: int, height: int) -> None: body_rows = max(1, min(geometry.modal_height, maximum_height) - 7) content_width = max(24, min(geometry.modal_width, maximum_width) - 6) page = self._modal_page(modal, content_width=content_width) + if modal.kind in {"project_create", "project_edit"}: + selected_row = next((index for index, row in enumerate(page) if row.startswith("◆")), 0) + if selected_row < modal.scroll or selected_row >= modal.scroll + max(1, body_rows - 1): + modal.scroll = max(0, selected_row - max(0, body_rows - 2)) maximum = max(0, len(page) - body_rows) modal.scroll = max(0, min(modal.scroll, maximum)) visible = page[modal.scroll : modal.scroll + body_rows] @@ -729,8 +733,8 @@ def _modal_page(self, modal: ModalState, content_width: int | None = None) -> li description_width=max(24, available - 4), table_width=available, ) - if modal.kind == "project_create": - return self._project_create_page(modal) + if modal.kind in {"project_create", "project_edit"}: + return self._project_create_page(modal, content_width or 100) if modal.kind == "info" and modal.tabs[modal.tab_index] != "Puertos": available = content_width or 88 return [ @@ -910,6 +914,22 @@ def text(key: str, fallback="") -> str: "separadas por comas", "Define qué columnas aparecen en la lista normal y en el inventario del TUI, respetando el orden indicado.", ), + ( + "GENERAL", + "startupInterface", + "Interfaz inicial LANCTL", + "--startup-interface", + "cli | tui | gui", + "Interfaz preferida al iniciar LANCTL sin argumentos.", + ), + ( + "GENERAL", + "closeGuiOnLaunch", + "Cerrar GUI al abrir launcher", + "--close-gui-on-launch", + "on | off", + "Cierra LANCTL después de confirmar que la otra GUI está disponible.", + ), ( "APARIENCIA", "tuiPanelLayout", @@ -1405,6 +1425,8 @@ def text(key: str, fallback="") -> str: from lanctl.core.projects.save_policy import available_save_modes choices = { + "startupInterface": ("cli", "tui", "gui"), + "closeGuiOnLaunch": ("on", "off"), "discovery": ("icmp", "arp", "hybrid"), "scanProfile": ("fast", "normal", "accurate"), "scanOrder": ("ascending", "descending", "random"), @@ -2119,7 +2141,9 @@ def ping_selected(self) -> None: self.messages = ["Ping completado." if result == 0 else "El elemento no ha respondido."] def _set_command_output(self, output: str, result: int) -> None: - self.messages = _clean_tui_output(output) if output else [f"Código de salida: {result}"] + self.messages = ( + _clean_tui_output(output)[-2000:] if output else [f"Código de salida: {result}"] + ) self.output_selectable = _selectable_output_indexes(self.messages) self.output_focus = bool(self.output_selectable) self.output_index = 0 @@ -2166,6 +2190,7 @@ def execute(self) -> None: self.command_history = [] if not self.command_history or self.command_history[-1] != raw: self.command_history.append(raw) + del self.command_history[:-500] if getattr(self, "pending_confirmation", None) is not None: answer = raw.casefold() if answer in ("s", "si", "sí", "y", "yes"): @@ -2440,17 +2465,29 @@ def _focus_console(self) -> None: self.messages = ["Consola preparada."] def handle_key(self, key: str) -> None: + save_requested = self._action_for_key(key) == "save" if getattr(self, "scanning", False) and key == "ESC" and not self.modal: self.cancel_refresh() return if getattr(self, "modal", None): + if self.modal.kind == "settings" and key == "CTRL_S": + self._save_settings(self.modal) + return + if self.modal.kind in {"project_create", "project_edit"} and key == "CTRL_S": + self._submit_project_form(self.modal) + return # Settings conserva su guardado específico. En los demás overlays, # Ctrl+S sigue siendo el guardado manual global del proyecto. - if key == "CTRL_S" and self.modal.kind not in { + if save_requested and self.modal.kind not in { "settings", "remote_users", "project_close", + "project_create", + "project_edit", }: + if self.modal.kind == "info" and self.modal.editing: + self.modal.footer = "Tab aplica el campo antes de guardar el proyecto" + return active_modal = self.modal self._manual_save() if self.modal is active_modal: @@ -2461,6 +2498,9 @@ def handle_key(self, key: str) -> None: return self._handle_modal_key(key) return + if save_requested: + self._manual_save() + return if self.detail_lines: if key == "UP": self.detail_scroll -= 1 @@ -2681,7 +2721,7 @@ def _handle_modal_key(self, key: str) -> None: if modal.kind == "project_switch": self._handle_project_switch_key(modal, key) return - if modal.kind == "project_create": + if modal.kind in {"project_create", "project_edit"}: self._handle_project_create_key(modal, key) return if modal.kind == "info": @@ -2723,6 +2763,8 @@ def _handle_modal_key(self, key: str) -> None: self._request_project_activation(path) elif modal.kind == "projects" and key == "CTRL_N": self._create_project_from_manager() + elif modal.kind == "projects" and key == "CTRL_E" and modal.items: + self._edit_project_from_manager(modal.items[modal.selected].path) elif modal.kind == "projects" and key == "DELETE" and modal.items: self._delete_project_from_manager(modal.items[modal.selected]) elif key == "CTRL_R": @@ -2868,6 +2910,13 @@ def _create_project_from_manager(self) -> None: "PROJECT", ), ] + from lanctl.core.projects.metadata import FIELDS + + fields.extend( + SettingField(key, label, "", "", "", "Dato descriptivo opcional.", "PROJECT") + for key, label, *_ in FIELDS + if key not in {"name", "description"} + ) self._open_modal( ModalState( kind="project_create", @@ -2877,32 +2926,43 @@ def _create_project_from_manager(self) -> None: items=fields, editing=True, editor_fresh=True, - footer="escribir editar Enter siguiente/crear ↑/↓ campo Esc cancelar", + footer="escribir editar Ctrl+S crear Enter siguiente/crear ↑/↓ campo Esc cancelar", max_width=120, ) ) @staticmethod - def _project_create_page(modal: ModalState) -> list[str]: - rows = [ - " CAMPO VALOR", - " ───────────────────────── ─────────────────────────────────────────────────────────────", - ] + def _project_create_page(modal: ModalState, width=100) -> list[str]: + compact = width < 54 + rows = [" CAMPO / VALOR" if compact else " CAMPO VALOR", "─" * width] for index, field in enumerate(modal.items): - marker = "▶" if index == modal.selected else " " + marker = "◆" if index == modal.selected else " " + changed = "*" if field.value != field.original else " " placeholder = { "name": "(escribe un nombre)", "path": "(indica una ruta)", }.get(field.key, "(opcional)") - rows.append(f"{marker} {field.label:<25} {fit_text(field.value or placeholder, 62)}") + if compact: + rows.extend( + (f"{marker}{changed} {field.label}", f" {field.value or placeholder}") + ) + else: + rows.append(f"{marker}{changed} {field.label:<25} {field.value or placeholder}") selected = modal.items[modal.selected] rows.extend(("", " DESCRIPCIÓN", f" {selected.description}")) - return rows + return [fit_text(row, width) for row in rows] def _handle_project_create_key(self, modal: ModalState, key: str) -> None: if key == "ESC": + if any( + field.value != field.original for field in modal.items + ) and not modal.tab_selections.get(-2): + modal.tab_selections[-2] = 1 + modal.footer = "Cambios sin guardar · Esc otra vez para descartar · cualquier otra tecla para continuar" + return self.show_project_manager() return + modal.tab_selections.pop(-2, None) if key in ("UP", "DOWN", "TAB", "SHIFT_TAB"): backwards = key in ("UP", "SHIFT_TAB") modal.selected = (modal.selected + (-1 if backwards else 1)) % len(modal.items) @@ -2914,7 +2974,7 @@ def _handle_project_create_key(self, modal: ModalState, key: str) -> None: modal.selected += 1 modal.editor_fresh = True else: - self._submit_project_creation(modal) + self._submit_project_form(modal) return if key == "BACKSPACE": field.value = field.value[:-1] @@ -2926,6 +2986,73 @@ def _handle_project_create_key(self, modal: ModalState, key: str) -> None: field.value = key if modal.editor_fresh else field.value + key modal.editor_fresh = False + def _edit_project_from_manager(self, path) -> None: + from lanctl.core.projects.metadata import FIELDS, read_metadata + + try: + data = read_metadata(path) + fields = [ + SettingField( + key, + label, + "", + data["values"][key], + data["values"][key], + "Dato descriptivo del proyecto.", + "PROJECT", + ) + for key, label, *_ in FIELDS + ] + self._open_modal( + ModalState( + kind="project_edit", + title="PROJECT MANAGER / EDITAR PROYECTO", + tabs=["Datos"], + pages=[[]], + items=fields, + editing=True, + editor_fresh=True, + edit_snapshot=json.dumps({"path": str(path), "revision": data["revision"]}), + footer="escribir editar Ctrl+S guardar Enter siguiente/guardar ↑/↓ campo Esc cancelar", + max_width=120, + ) + ) + except (OSError, ValueError, sqlite3.DatabaseError) as error: + self._project_metadata_error(error) + + def _project_metadata_error(self, error) -> None: + from lanctl.core.errors import errors + + errors.from_exception( + error, + origin="LANCTL.TUI.ProjectManager.Metadata", + code="PROJECT.MANAGER.METADATA_FAILED", + level=34, + print_output=False, + ) + self.messages = [f"No se pudieron editar los metadatos: {error}"] + if self.modal: + self.modal.footer = str(error) + + def _submit_project_form(self, modal: ModalState) -> None: + if modal.kind == "project_create": + self._submit_project_creation(modal) + return + from lanctl.core.projects.metadata import update_metadata + + try: + snapshot = json.loads(modal.edit_snapshot) + update_metadata( + snapshot["path"], + {field.key: field.value for field in modal.items}, + snapshot["revision"], + ) + self.reload() + self.show_project_manager() + self.messages = ["Metadatos del proyecto guardados."] + except (OSError, ValueError, sqlite3.DatabaseError) as error: + self._project_metadata_error(error) + def _submit_project_creation(self, modal: ModalState) -> None: from lanctl.core.projects.catalog import ProjectCatalog from lanctl.core.projects.vlf import create_project @@ -2950,6 +3077,9 @@ def _submit_project_creation(self, modal: ModalState) -> None: description = values["description"] destination = directory / (name if name.casefold().endswith(".vlf") else f"{name}.vlf") try: + from lanctl.core.projects.metadata import FIELDS, validate_metadata + + validate_metadata({key: values.get(key, "") for key, *_ in FIELDS}) destination.parent.mkdir(parents=True, exist_ok=True) # No heredar el inventario ni los grupos del proyecto activo. with tempfile.TemporaryDirectory(prefix="lanctl-project-create-") as temporary: @@ -2960,6 +3090,11 @@ def _submit_project_creation(self, modal: ModalState) -> None: destination, name=Path(name).stem, description=description, + author=values.get("author", ""), + lan_name=values.get("lan", ""), + location=values.get("location", ""), + company=values.get("company", ""), + responsible=values.get("responsible", ""), config=empty_config, initialize_reserved=False, ) diff --git a/src/lanctl/apps/ip/interfaces/tui/managers.py b/src/lanctl/apps/ip/interfaces/tui/managers.py index 4a92695..e280334 100644 --- a/src/lanctl/apps/ip/interfaces/tui/managers.py +++ b/src/lanctl/apps/ip/interfaces/tui/managers.py @@ -30,12 +30,19 @@ def project_detail(project: Any, active: str) -> list[str]: from lanctl.core.projects.vlf import inspect_project info = inspect_project(path) + from lanctl.core.projects.metadata import read_metadata + + metadata = read_metadata(path)["values"] return [ f"Nombre : {info.get('name') or path.stem}", f"Activo : {'Sí' if str(path.resolve()).casefold() == str(active).casefold() else 'No'}", f"UUID : {info.get('id') or '-'}", f"Descripción : {info.get('description') or '-'}", f"Autor : {info.get('author') or '-'}", + f"LAN : {metadata['lan'] or '-'}", + f"Ubicación : {metadata['location'] or '-'}", + f"Empresa : {metadata['company'] or '-'}", + f"Responsable : {metadata['responsible'] or '-'}", f"LANCTL : {info.get('lanctlVersion') or '-'}", f"Actualizado : {info.get('updated') or '-'}", f"Dispositivos : {info.get('devices', '-')}", @@ -77,6 +84,6 @@ def project_manager_modal(projects: list[Any], active: str, root: Path) -> Modal tabs=["Proyectos", "Información"], pages=[listing, details[0] if details else ["No hay información disponible."]], items=projects, - footer="Ctrl+N nuevo Ctrl+S guardar Supr eliminar ↑/↓ seleccionar → información Enter activar Ctrl+R recargar Esc cerrar", + footer="Ctrl+N nuevo Ctrl+E editar Ctrl+S guardar Supr eliminar ↑/↓ seleccionar → información Enter activar Ctrl+R recargar Esc cerrar", max_width=120, ) diff --git a/src/lanctl/apps/monitor/bug_reports.py b/src/lanctl/apps/monitor/bug_reports.py new file mode 100644 index 0000000..6e6b501 --- /dev/null +++ b/src/lanctl/apps/monitor/bug_reports.py @@ -0,0 +1,19 @@ +"""Human-reviewed GitHub form adapter; the diagnostic core has no GitHub dependency.""" + +from urllib.parse import urlencode + +from lanctl.core.diagnostics import diagnostic_markdown +from lanctl.core.official_links import get_official_links + + +def bug_report_url(report: dict) -> str: + body = diagnostic_markdown({**report, "logs": []}) + title = "LANCTL: informe de error" + base = get_official_links()["github"] + "/issues/new?" + body += "\nAdjunta el diagnóstico exportado si necesitas incluir los logs seleccionados.\n" + # Keep URLs useful on Windows and browsers with conservative length limits. + while len(base + urlencode({"title": title, "body": body})) > 6000: + body = ( + body[: max(1, len(body) // 2)] + "\n[Resumen abreviado; adjuntar diagnóstico exportado]" + ) + return base + urlencode({"title": title, "body": body}) diff --git a/src/lanctl/apps/monitor/commands.py b/src/lanctl/apps/monitor/commands.py index 60099ed..2a34440 100644 --- a/src/lanctl/apps/monitor/commands.py +++ b/src/lanctl/apps/monitor/commands.py @@ -117,15 +117,7 @@ def _database(args): def run_monitor(args): - words = [x.casefold() for x in args.words] - action = words[0] if words else "status" - config = load_config() - # Una sola conexión por comando evita descriptores huérfanos y garantiza - # la reversión y el cierre incluso si una acción termina con una excepción. - with _database(args) as database: - sessions = SessionManager(SqlSessionRepository(database)) - payload = _run_monitor_action(args, sessions, config, words, action) - + payload = execute_monitor(args) print( json.dumps(payload, indent=2, ensure_ascii=False) if args.json or isinstance(payload, (dict, list)) @@ -139,6 +131,20 @@ def run_monitor(args): ) +def execute_monitor(args): + """Return the shared monitor operation result without printing CLI output.""" + words = [x.casefold() for x in args.words] + action = words[0] if words else "status" + config = load_config() + # Una sola conexión por comando evita descriptores huérfanos y garantiza + # la reversión y el cierre incluso si una acción termina con una excepción. + with _database(args) as database: + sessions = SessionManager(SqlSessionRepository(database)) + payload = _run_monitor_action(args, sessions, config, words, action) + + return payload + + def _start_monitor(args, sessions, config, action): project = args.project or ( args.words[1] if action == "attach" and len(args.words) > 1 else config.get("activeProject") @@ -850,6 +856,8 @@ def _lanctl_command(*arguments): def _spawn_foreground(args): + from lanctl.core.session_context import child_environment + command = _lanctl_command( "monitor", "foreground", @@ -864,5 +872,9 @@ def _spawn_foreground(args): ) flags = getattr(subprocess, "CREATE_NO_WINDOW", 0) if platform.system() == "Windows" else 0 return subprocess.Popen( - command, creationflags=flags, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL + command, + creationflags=flags, + stdout=subprocess.DEVNULL, + stderr=subprocess.DEVNULL, + env=child_environment("lanmon", load_config()), ) diff --git a/src/lanctl/apps/monitor/event_view.py b/src/lanctl/apps/monitor/event_view.py index b4ca5c8..5098256 100644 --- a/src/lanctl/apps/monitor/event_view.py +++ b/src/lanctl/apps/monitor/event_view.py @@ -18,10 +18,20 @@ def _rows(text, source, name, limit): rows = [] for line in deque(text.splitlines(), maxlen=limit): level = None - if "ERROR_EVENT " in line: + marker = re.search(r"(?:^|\s)(ERROR_EVENT|GUI_ACTIVITY) ", line) + if marker: try: - event = json.loads(line.split("ERROR_EVENT ", 1)[1]) - level = int(event["level"]) + event = json.loads(line[marker.end() :]) + if marker.group(1) == "ERROR_EVENT": + level = int(event["level"]) + elif ( + isinstance(event, dict) + and type(event.get("schemaVersion")) is int + and event["schemaVersion"] == 1 + and type(event.get("level")) is int + and 1 <= event["level"] <= 59 + ): + level = event["level"] except (ValueError, KeyError, TypeError): level = None # Strip terminal escapes and C0 controls from untrusted log content. diff --git a/src/lanctl/apps/monitor/gui_service.py b/src/lanctl/apps/monitor/gui_service.py new file mode 100644 index 0000000..2227ffb --- /dev/null +++ b/src/lanctl/apps/monitor/gui_service.py @@ -0,0 +1,114 @@ +"""Live monitor view and bounded command adapter; opening never starts probes.""" + +from dataclasses import asdict +from pathlib import Path + +from lanctl.apps.monitor.database import IncidentRepository, MonitorDatabase, SessionRepository +from lanctl.apps.monitor.lifecycle import SingletonLock +from lanctl.core.config import load_config +from lanctl.core.database import DeviceDatabase +from lanctl.core.history import HistoryService +from lanctl.core.paths import application_path + + +class MonitorGuiService: + def snapshot(self): + config = load_config() + with MonitorDatabase(application_path(config["monitorDatabase"])) as db: + states = {r["device_id"]: dict(r) for r in db.execute("SELECT * FROM device_state")} + latest = { + row["device_id"]: dict(row) + for row in db.execute( + "SELECT s.* FROM samples s JOIN (SELECT device_id,MAX(sample_id) AS last_id FROM samples " + "WHERE check_type IN ('availability','ping','arp') GROUP BY device_id) q ON q.last_id=s.sample_id" + ) + } + rows = [] + for device in DeviceDatabase(config["database"]).load(): + last = latest.get(device.device_id, {}) + state = states.get(device.device_id) or { + "presence": "online" + if last.get("presence") + else "offline" + if last + else "unknown", + "latency_ms": last.get("latency_ms"), + "updated_at": last.get("timestamp"), + } + rows.append( + { + "id": device.device_id, + "name": device.alias or device.name or device.ip, + "ip": device.ip, + "groups": list(device.groups), + "presence": state.get("presence", "unknown"), + "health": state.get("health", "unknown"), + "latency": state.get("latency_ms"), + "updated": state.get("updated_at"), + } + ) + session = SessionRepository(db).active() + return { + "records": rows, + "incidents": [ + asdict(i) + for i in IncidentRepository(db).list() + if i.deviceId in {r["id"] for r in rows} + ], + "events": [ + event.to_dict() + for event in HistoryService(config.get("activeProject")).query( + source="lanctl.monitor", limit=30, reverse=True + ) + ] + if config.get("activeProject") + else [], + "session": asdict(session) if session else None, + "process": SingletonLock(application_path(config["monitorLock"])).status(), + "storage": str(db.path), + } + + def samples(self, identifier): + config = load_config() + DeviceDatabase(config["database"]).resolve(identifier) + with MonitorDatabase(application_path(config["monitorDatabase"])) as db: + return [ + dict(r) + for r in db.execute( + "SELECT timestamp,latency_ms,presence FROM samples WHERE device_id=? " + "AND check_type IN ('availability','ping','arp') ORDER BY sample_id DESC LIMIT 60", + (identifier,), + ) + ][::-1] + + def incident(self, identifier, action): + from lanctl.apps.monitor.incidents import IncidentManager + + if action not in {"acknowledge", "close"}: + raise ValueError("Acción de incidencia no permitida") + if not any(i["incidentId"] == identifier for i in self.snapshot()["incidents"]): + raise ValueError("La incidencia no pertenece al inventario mostrado") + with MonitorDatabase(application_path(load_config()["monitorDatabase"])) as db: + manager = IncidentManager(IncidentRepository(db)) + return asdict(getattr(manager, action)(identifier)) + + def action(self, action): + if action not in {"start", "stop", "once"}: + raise ValueError("Operación de monitor no permitida") + config = load_config() + project = config.get("activeProject") + if not project: + raise ValueError("Selecciona un proyecto antes de operar el monitor") + snapshot = self.snapshot() + session = snapshot["session"] + if session and Path(session["projectId"]).resolve() != Path(project).resolve(): + raise ValueError("El monitor está asociado a otro proyecto") + if action != "stop" and (session or snapshot["process"].get("running")): + raise ValueError("Ya existe una sesión de monitor; detenla antes de iniciar otra") + from lanctl.apps.monitor.commands import execute_monitor + from lanctl.bootstrap.lanmon import build_parser + + words = [action, "--project", project, "--json"] + if action == "start": + words.extend(["--permanent"]) + return execute_monitor(build_parser().parse_args(words)) diff --git a/src/lanctl/apps/monitor/log_stream.py b/src/lanctl/apps/monitor/log_stream.py index e00b9fc..d240ed4 100644 --- a/src/lanctl/apps/monitor/log_stream.py +++ b/src/lanctl/apps/monitor/log_stream.py @@ -17,6 +17,8 @@ class LogFollower: def __init__(self, directory, limit=100): + if type(limit) is not int or not 1 <= limit <= 1000: + raise ValueError("limit debe estar entre 1 y 1000") self.directory = Path(directory) self.limit = limit self.positions = {} @@ -24,11 +26,14 @@ def __init__(self, directory, limit=100): self.initialized = False def poll(self): - rows = [] + rows = deque(maxlen=self.limit) if not self.initialized else [] + budget = 1024 * 1024 paths = sorted(self.directory.glob("*.log"), key=lambda path: (_date(path.name), path.name)) if not self.initialized: paths = paths[-5:] for path in paths: + if self.initialized and (len(rows) >= 1000 or budget <= 0): + break try: stream = path.open("rb") except FileNotFoundError: @@ -50,12 +55,21 @@ def poll(self): stream.readline() # skip a partial first line else: stream.seek(start) - chunk = stream.read(1024 * 1024) + read_start = stream.tell() + chunk = stream.read(budget if self.initialized else 1024 * 1024) + budget -= len(chunk) self.positions[path] = (identity, stream.tell()) - data = self.pending.pop(path, b"") + chunk + previous_pending = self.pending.pop(path, b"") + data = previous_pending + chunk lines = data.split(b"\n") self.pending[path] = lines.pop()[-65536:] - for line in lines: + selected = lines if not self.initialized else lines[: 1000 - len(rows)] + if len(selected) < len(lines): + # Leave the unconsumed bytes on disk, not in an unbounded queue. + consumed = sum(len(line) + 1 for line in selected) + self.positions[path] = (identity, read_start + consumed - len(previous_pending)) + self.pending.pop(path, None) + for line in selected: rows.extend(_rows(line.decode("utf-8", errors="replace"), "program", path.name, 1)) if not self.initialized: # Record older files at EOF, without displaying their history later. @@ -71,7 +85,7 @@ def poll(self): self.positions = {path: value for path, value in self.positions.items() if path in live} self.pending = {path: value for path, value in self.pending.items() if path in live} self.initialized = True - return rows + return list(rows) def follow_logs(*, limit=100, minimum=1): @@ -90,7 +104,7 @@ def follow_logs(*, limit=100, minimum=1): return 0 -def open_log_window(*, limit=100, minimum=1): +def open_log_window(*, limit=100, minimum=1, tui=False): if not 1 <= limit <= 1000 or not 1 <= minimum <= 59: raise ValueError("limit debe estar entre 1-1000 y level entre 1-59") if getattr(sys, "frozen", False): @@ -109,6 +123,8 @@ def open_log_window(*, limit=100, minimum=1): "--level", str(minimum), ] + if tui: + command.append("--tui") if os.name == "nt": subprocess.Popen(command, creationflags=subprocess.CREATE_NEW_CONSOLE) else: diff --git a/src/lanctl/apps/monitor/log_tui.py b/src/lanctl/apps/monitor/log_tui.py new file mode 100644 index 0000000..8f41458 --- /dev/null +++ b/src/lanctl/apps/monitor/log_tui.py @@ -0,0 +1,173 @@ +"""Live, bounded operational-log viewer; closing it has no service side effects.""" + +from __future__ import annotations + +import os +import shutil +import sys +import time +from collections import deque +from contextlib import contextmanager + +from rich.console import Group +from rich.table import Table +from rich.text import Text + +from lanctl.core.terminal_ui import ManagementScreen + + +class LogViewModel: + def __init__(self, limit=100, minimum=1): + if ( + type(limit) is not int + or not 1 <= limit <= 1000 + or type(minimum) is not int + or not 1 <= minimum <= 59 + ): + raise ValueError("limit debe estar entre 1-1000 y level entre 1-59") + self.history = deque(maxlen=limit) + self.minimum = minimum + self.paused = False + self.frozen = [] + self.query = "" + self.editing = False + self.offset = 0 + + def ingest(self, rows): + self.history.extend(rows) + + def rows(self, size): + rows = self.frozen if self.paused else list(self.history) + filtered = [ + r + for r in reversed(rows) + if (r["level"] is None or r["level"] >= self.minimum) + and self.query.casefold() in r["message"].casefold() + ] + self.offset = min(self.offset, max(0, len(filtered) - 1)) + return filtered[self.offset : self.offset + size] + + def key(self, key, page_size=15): + if self.editing: + if key in {"\r", "\n", "\x1b"}: + self.editing = False + elif key in {"\b", "\x7f"}: + self.query = self.query[:-1] + elif len(key) == 1 and key.isprintable() and len(self.query) < 200: + self.query += key + self.offset = 0 + return True + if key in {"q", "Q", "\x03", "\x04"}: + return False + if key in {"p", " "}: + self.paused = not self.paused + self.frozen = list(self.history) if self.paused else [] + self.offset = 0 + elif key in {"up", "down", "pageup", "pagedown"}: + if not self.paused: + self.paused = True + self.frozen = list(self.history) + delta = {"up": 1, "down": -1, "pageup": page_size, "pagedown": -page_size}[key] + self.offset = max(0, min(len(self.frozen) - 1, self.offset + delta)) + elif key == "f": + self.minimum = next((v for v in (1, 20, 30, 40, 50) if v > self.minimum), 1) + self.offset = 0 + elif key == "/": + self.query = "" + self.editing = True + return True + + +@contextmanager +def _keyboard(): + if os.name == "nt": + import msvcrt + + def read(): + if not msvcrt.kbhit(): + return "" + key = msvcrt.getwch() + if key in {"\x00", "\xe0"}: + return {"H": "up", "P": "down", "I": "pageup", "Q": "pagedown"}.get( + msvcrt.getwch(), "" + ) + return key + + yield read + else: + import codecs + import select + import termios + import tty + + descriptor = sys.stdin.fileno() + previous = termios.tcgetattr(descriptor) + decoder = codecs.getincrementaldecoder("utf-8")(errors="replace") + try: + tty.setcbreak(descriptor) + + def read(): + if not select.select([descriptor], [], [], 0)[0]: + return "" + byte = os.read(descriptor, 1) + if not byte: + return "\x04" + key = decoder.decode(byte) + if key == "\x1b": + suffix = b"" + while len(suffix) < 4 and select.select([descriptor], [], [], 0.01)[0]: + suffix += os.read(descriptor, 1) + return {b"[A": "up", b"[B": "down", b"[5~": "pageup", b"[6~": "pagedown"}.get( + suffix, key + ) + return key + + yield read + finally: + termios.tcsetattr(descriptor, termios.TCSADRAIN, previous) + + +def follow_log_tui(*, limit=100, minimum=1): + from lanctl.apps.monitor.log_stream import LogFollower, follow_logs + from lanctl.core.config import load_config + from lanctl.core.paths import application_path + + model = LogViewModel(limit, minimum) + if not sys.stdin.isatty() or not sys.stdout.isatty(): + return follow_logs(limit=limit, minimum=minimum) + follower = LogFollower(application_path(load_config()["programLog"]), limit) + try: + with ManagementScreen() as screen, _keyboard() as read_key: + while True: + model.ingest(follower.poll()) + page_size = max(1, shutil.get_terminal_size((100, 30)).lines - 11) + table = Table( + title="LANMON · Log operativo compartido (no auditoría VLF)", expand=True + ) + table.add_column("Archivo", no_wrap=True) + table.add_column("Nivel", width=5) + table.add_column("Mensaje") + for row in model.rows(page_size): + level = row["level"] or 0 + style = "bold red" if level >= 40 else "yellow" if level >= 20 else "cyan" + table.add_row( + Text(row["file"]), + str(row["level"] or "—"), + Text(row["message"], style=style), + ) + screen.draw( + Group( + table, + Text( + f"{'PAUSA' if model.paused else 'EN DIRECTO'} · nivel ≥{model.minimum} · filtro: {model.query} · {len(model.history)}/{limit} líneas" + ), + Text( + "P pausa · ↑/↓/RePág/AvPág historial · F nivel · / filtro, Enter aceptar · Q cerrar" + ), + ) + ) + if not model.key(read_key(), page_size): + return 0 + time.sleep(0.1) + except KeyboardInterrupt: + return 0 diff --git a/src/lanctl/apps/rack/cli.py b/src/lanctl/apps/rack/cli.py index f554493..3cd8500 100644 --- a/src/lanctl/apps/rack/cli.py +++ b/src/lanctl/apps/rack/cli.py @@ -9,6 +9,7 @@ from lanctl import __version__ from lanctl.apps.rack.service import RackService from lanctl.apps.wire.idf.database import DEFAULT_DATABASE_PATH +from lanctl.core.config import load_config from lanctl.core.parser import LANCTLArgumentParser, normalize_help_arguments from lanctl.core.session import coordinated_launcher @@ -31,11 +32,12 @@ def build_parser() -> LANCTLArgumentParser: ) parser.add_argument( "--database", - default=DEFAULT_DATABASE_PATH, + default=load_config().get("physicalDatabase", DEFAULT_DATABASE_PATH), metavar="ARCHIVO.db", help="Base física IDF compartida.", ) mode = parser.add_mutually_exclusive_group() + mode.add_argument("--gui", action="store_true", help="Abre la interfaz gráfica de escritorio.") mode.add_argument( "-tui", "--tui", action="store_true", help="Abre la interfaz de pantalla completa." ) @@ -44,11 +46,25 @@ def build_parser() -> LANCTLArgumentParser: commands.add_parser("list", aliases=["ls"], help="Lista los racks disponibles.") show = commands.add_parser("show", help="Muestra un rack y sus ocupantes.") show.add_argument("rack", help="ID o nombre del rack.") + dimensions = commands.add_parser("dimensions", help="Edita altura y ancho de montaje del rack.") + dimensions.add_argument("rack", help="ID del rack.") + dimensions.add_argument("--units", type=int, required=True, help="Altura de 4 a 52 U.") + dimensions.add_argument( + "--width-inches", + type=int, + choices=(10, 19, 21, 23), + required=True, + help="Ancho de montaje en pulgadas.", + ) return parser def _print_rack(rack: dict) -> None: - print(f"{rack['id']} | {rack['name']} | {rack['units']}U | {len(rack['occupants'])} elementos") + print( + f"{rack['id']} | {rack['name']} | {rack['units']}U | {rack['widthInches'] or '?'} pulgadas | {len(rack['occupants'])} elementos" + ) + for warning in rack["dimensions"]["warnings"]: + print(f" Revisar: {warning}") for item in rack["occupants"]: unit = f"U{item['unit']}" if item["unit"] is not None else "U?" print(f" {unit:>4} {item['id']:<10} {item['name'] or item['type']}") @@ -63,6 +79,10 @@ def main(argv: list[str] | None = None) -> int: configure_utf8_stdio() arguments = normalize_help_arguments(list(sys.argv[1:] if argv is None else argv)) args = build_parser().parse_args(arguments) + if getattr(args, "gui", False): + from lanctl.apps.suite.launcher_gui import run_gui + + return run_gui("lanrack", database=args.database) service = RackService(args.database) if args.tui or (not args.cli and args.command is None): return run_tui(service) @@ -73,6 +93,14 @@ def main(argv: list[str] | None = None) -> int: if args.command == "show": print(json.dumps(service.get(args.rack), indent=2, ensure_ascii=False)) return 0 + if args.command == "dimensions": + service.set_dimensions( + service.snapshot()["organizationRevision"], + args.rack, + {"units": args.units, "widthInches": args.width_inches}, + ) + _print_rack(service.get(args.rack)) + return 0 return run_cli(service) @@ -90,6 +118,13 @@ def dispatch(words): _print_rack(rack) elif args.command == "show": _print_rack(service.get(args.rack)) + elif args.command == "dimensions": + service.set_dimensions( + service.snapshot()["organizationRevision"], + args.rack, + {"units": args.units, "widthInches": args.width_inches}, + ) + _print_rack(service.get(args.rack)) else: build_parser().print_help() return 0 @@ -97,12 +132,13 @@ def dispatch(words): def overview(): rows = service.list() inventory = "\n".join( - f"{row['id']:<12} {row['name']} · {row['units']}U · {len(row['occupants'])} elementos" + f"{row['id']:<12} {row['name']} · {row['units']}U · {row['widthInches'] or '?'} pulgadas · {len(row['occupants'])} elementos" + + (" · REVISAR DIMENSIONES" if row["dimensions"]["needsReview"] else "") for row in rows ) return ( (inventory or "No hay racks definidos en LANWIRE.") - + "\n\nlist: listar · show ID: unidades y ocupantes · R: refrescar\nLa edición física pertenece a LANWIRE." + + "\n\nlist: listar · show ID: unidades y ocupantes · R: refrescar\ndimensions ID --units U --width-inches ANCHO: editar dimensiones." ) return command_console( diff --git a/src/lanctl/apps/rack/organization.py b/src/lanctl/apps/rack/organization.py new file mode 100644 index 0000000..26cc49f --- /dev/null +++ b/src/lanctl/apps/rack/organization.py @@ -0,0 +1,101 @@ +"""Organización CPD versionada dentro del inventario físico compartido.""" + +import hashlib +import json +from copy import deepcopy +from uuid import uuid4 + +from lanctl.apps.wire.xfile import read, update_json + + +def organization(document): + # Las bases anteriores no contienen CPD; se conservan sin asignaciones. + value = document.get("cpdOrganization", {"schemaVersion": 1, "rooms": {}}) + if ( + not isinstance(value, dict) + or type(value.get("schemaVersion")) is not int + or value.get("schemaVersion") != 1 + ): + raise ValueError("Esquema CPD no compatible") + rooms = value.get("rooms") + if not isinstance(rooms, dict): + raise ValueError("Colección CPD inválida") + for key, room in rooms.items(): + if not isinstance(room, dict) or room.get("id") != key: + raise ValueError("Identidad CPD inválida") + if not all(isinstance(room.get(k, ""), str) for k in ("name", "description", "location")): + raise ValueError("Metadatos CPD inválidos") + if not room.get("name", "").strip(): + raise ValueError("El CPD necesita un nombre") + for record in document["records"].values(): + data = record.get("data") or {} + cpd = (data.get("location") or {}).get("cpd") + if cpd and (data.get("type") != "rack" or cpd not in rooms): + raise ValueError("Asignación CPD inválida") + return deepcopy(value) + + +def token(document): + return hashlib.sha256(json.dumps(document, sort_keys=True).encode()).hexdigest() + + +def snapshot(database): + document = read(database.path) + database._validate_database(document) + return { + "cpds": list(organization(document)["rooms"].values()), + "organizationRevision": token(document), + } + + +def mutate(database, expected, operation, values): + result = {} + + def change(document): + database._validate_database(document) + groups = organization(document) + if token(document) != expected: + raise ValueError("El inventario cambió en otra ventana; actualiza antes de guardar") + rooms = groups["rooms"] + identifier = values.get("id") + if operation in {"create", "edit"}: + if operation == "edit" and identifier not in rooms: + raise ValueError("El CPD ya no existe") + identifier = identifier if operation == "edit" else "CPD-" + uuid4().hex + room = {"id": identifier} + for key in ("name", "description", "location"): + value = values.get(key, "") + if not isinstance(value, str): + raise ValueError("Los datos del CPD deben ser texto") + room[key] = value.strip() + if not room["name"]: + raise ValueError("El CPD necesita un nombre") + rooms[identifier] = room + elif operation == "assign": + rack = document["records"].get(values.get("rack")) + if not rack or rack.get("data", {}).get("type") != "rack": + raise ValueError("Selecciona un armario rack existente") + if identifier and identifier not in rooms: + raise ValueError("El CPD de destino no existe") + rack["data"].setdefault("location", {})["cpd"] = identifier or "" + rack["updated_at"] = database._timestamp() + elif operation == "delete": + if identifier not in rooms: + raise ValueError("El CPD ya no existe") + target = values.get("target") or "" + if target == identifier or (target and target not in rooms): + raise ValueError("El CPD de destino no es válido") + for rack in document["records"].values(): + location = (rack.get("data") or {}).get("location") or {} + if location.get("cpd") == identifier: + location["cpd"] = target + rack["updated_at"] = database._timestamp() + del rooms[identifier] + else: + raise ValueError("Operación CPD desconocida") + document["cpdOrganization"] = groups + organization(document) + result["id"] = identifier + + update_json(database.path, dict, change) + return result diff --git a/src/lanctl/apps/rack/service.py b/src/lanctl/apps/rack/service.py index 2323fd6..a3a1f0a 100644 --- a/src/lanctl/apps/rack/service.py +++ b/src/lanctl/apps/rack/service.py @@ -1,8 +1,9 @@ -"""Consultas de solo lectura sobre los racks administrados por LANWIRE.""" +"""Consultas de racks y organización CPD del inventario compartido.""" from __future__ import annotations from lanctl.apps.wire.idf.database import IDFDatabaseManager +from lanctl.apps.wire.xfile import locked_file class RackService: @@ -13,6 +14,47 @@ def list(self) -> list[dict]: records = self.database.all() return [self.describe(record, records) for record in records if self._is_rack(record)] + def snapshot(self): + from lanctl.apps.rack.organization import snapshot + from lanctl.apps.rack.skins import profiles + + with locked_file(self.database.path): + return { + "records": self.list(), + "storage": str(self.database.path), + **snapshot(self.database), + "skinProfiles": profiles(), + } + + def organize(self, expected, operation, values): + from lanctl.apps.rack.organization import mutate + + return mutate(self.database, expected, operation, values) + + def set_appearance(self, expected, identifier, values): + from lanctl.apps.rack.skins import save + + return save(self.database, expected, identifier, values) + + def set_dimensions(self, expected, identifier, values): + from lanctl.apps.rack.organization import token + from lanctl.apps.wire.xfile import read + from lanctl.core.rack_dimensions import with_dimensions + + if not isinstance(values, dict) or set(values) != {"units", "widthInches"}: + raise ValueError("Indica altura y ancho de montaje del rack") + with locked_file(self.database.path): + document = read(self.database.path) + self.database._validate_database(document) + if token(document) != expected: + raise ValueError("El inventario cambió; actualiza antes de editar las dimensiones") + record = self.database.get(identifier) + if record is None or not self._is_rack(record): + raise ValueError("Selecciona un armario rack existente") + data = with_dimensions(record["data"], values["units"], values["widthInches"]) + self.database.update(identifier, data) + return {"id": record["id"]} + def get(self, identifier: str) -> dict: records = self.database.all() rack = next( @@ -30,6 +72,9 @@ def _is_rack(record: dict) -> bool: @staticmethod def describe(rack: dict, records: list[dict]) -> dict: + from lanctl.apps.rack.skins import span + from lanctl.core.rack_dimensions import dimension_status + data = rack.get("data") or {} occupants = [] for record in records: @@ -44,13 +89,25 @@ def describe(rack: dict, records: list[dict]) -> dict: "name": item.get("name") or item.get("alias") or "", "type": item.get("type", "element"), "description": item.get("description", ""), + "data": item, + "span": span(item), + "connectedPorts": [ + end.get("port") + for wire in records + if (wire.get("data") or {}).get("type") == "wire" + for end in wire["data"].get("endpoints", []) + if end.get("device") == record["id"] + ], } ) occupants.sort(key=lambda item: (-(int(item["unit"] or 0)), item["id"])) + dimensions = dimension_status(data) return { "id": rack["id"], "name": data.get("name") or data.get("alias") or rack["id"], - "units": int(data.get("units") or data.get("size_units") or data.get("height") or 42), + "units": dimensions["heightU"], + "widthInches": dimensions["widthInches"], + "dimensions": dimensions, "description": data.get("description", ""), "location": data.get("location", {}), "layout": data.get("layout", []), diff --git a/src/lanctl/apps/rack/skins.py b/src/lanctl/apps/rack/skins.py new file mode 100644 index 0000000..b20abd1 --- /dev/null +++ b/src/lanctl/apps/rack/skins.py @@ -0,0 +1,163 @@ +"""Frentes genéricos de equipos; la apariencia no crea puertos de inventario.""" + +from copy import deepcopy + +from lanctl.apps.rack.organization import token +from lanctl.apps.wire.xfile import update_json + + +def profiles(): + result = [ + { + "id": "auto", + "name": "Automático según inventario", + "kind": "auto", + "rj45": 0, + "sfp": 0, + "units": 1, + "rackmount": True, + } + ] + for copper, fiber in [ + (12, 0), + (24, 0), + (48, 0), + (24, 2), + (24, 4), + (48, 2), + (50, 2), + (48, 4), + (48, 6), + (48, 8), + ]: + result.append( + { + "id": f"switch-{copper}-{fiber}", + "name": f"Switch {copper} RJ45" + (f" + {fiber} SFP" if fiber else ""), + "kind": "switch", + "rj45": copper, + "sfp": fiber, + "units": 1, + "rackmount": True, + } + ) + for count in (5, 8, 12, 16, 24): + result.append( + { + "id": f"desktop-{count}", + "name": f"Switch de sobremesa {count} RJ45 (bandeja)", + "kind": "switch", + "rj45": count, + "sfp": 0, + "units": 1, + "rackmount": False, + } + ) + for count in (12, 24, 48): + result.append( + { + "id": f"panel-{count}", + "name": f"Panel de conexiones {count} RJ45", + "kind": "panel", + "rj45": count, + "sfp": 0, + "units": 1, + "rackmount": True, + } + ) + for kind, name, heights in [ + ("server", "Servidor", (1, 2, 4)), + ("ups", "SAI / UPS", (2, 3, 4)), + ("router", "Router / cortafuegos", (1,)), + ("shelf", "Bandeja", (1, 2)), + ("blank", "Panel ciego", (1, 2)), + ]: + for height in heights: + result.append( + { + "id": f"{kind}-{height}", + "name": f"{name} {height} U", + "kind": kind, + "rj45": 4 if kind == "router" else 0, + "sfp": 0, + "units": height, + "rackmount": True, + } + ) + return result + + +def appearance(values): + if not isinstance(values, dict): + raise ValueError("Apariencia de equipo inválida") + kind = values.get("kind") + if kind not in {"auto", "switch", "panel", "server", "ups", "router", "shelf", "blank"}: + raise ValueError("Selecciona un tipo de frente válido") + result = {"schemaVersion": 1, "kind": kind} + for key, minimum, maximum in [("rj45", 0, 96), ("sfp", 0, 32), ("units", 1, 8)]: + value = values.get(key) + if type(value) is not int or not minimum <= value <= maximum: + raise ValueError(f"{key} debe estar entre {minimum} y {maximum}") + result[key] = value + if type(values.get("rackmount")) is not bool: + raise ValueError("Selecciona el formato de montaje") + result["rackmount"] = values["rackmount"] + return result + + +def span(data): + value = data.get("rackAppearance") + if value is None: + return 1 + if ( + not isinstance(value, dict) + or type(value.get("schemaVersion")) is not int + or value.get("schemaVersion") != 1 + ): + raise ValueError("Esquema de apariencia no compatible") + return appearance(value)["units"] + + +def validate_location(records, identifier, data): + location = data.get("location") or {} + start = location.get("unit") + rack_id = location.get("rack") + if rack_id and start: + rack = next((r for r in records if r["id"] == rack_id), None) + if not rack or rack.get("data", {}).get("type") != "rack": + raise ValueError("El rack asignado ya no existe") + if start + span(data) - 1 > int(rack["data"].get("units", 42)): + raise ValueError("El equipo sobrepasa la altura del armario") + occupied = set(range(start, start + span(data))) + for other in records: + other_data = other.get("data") or {} + other_location = other_data.get("location") or {} + other_start = other_location.get("unit") + if ( + other["id"] != identifier + and other_location.get("rack") == rack_id + and other_start + and occupied.intersection(range(other_start, other_start + span(other_data))) + ): + raise ValueError(f"Las unidades están ocupadas por {other['id']}") + + +def save(database, expected, identifier, values): + visual = appearance(values) + + def change(document): + database._validate_database(document) + if token(document) != expected: + raise ValueError("El inventario cambió; actualiza antes de guardar el frente") + record = document["records"].get(identifier) + if not record or record.get("data", {}).get("type") in {"wire", "rack"}: + raise ValueError("Selecciona un equipo del armario") + data = record["data"] + validate_location( + list(document["records"].values()), identifier, {**data, "rackAppearance": visual} + ) + record["data"] = {**data, "rackAppearance": deepcopy(visual)} + record["updated_at"] = database._timestamp() + + update_json(database.path, dict, change) + return {"id": identifier} diff --git a/src/lanctl/apps/suite/gui.py b/src/lanctl/apps/suite/gui.py new file mode 100644 index 0000000..6be98c6 --- /dev/null +++ b/src/lanctl/apps/suite/gui.py @@ -0,0 +1,446 @@ +"""Local-only desktop entry point for the suite's shared administration.""" + +from __future__ import annotations + +import platform +import subprocess +import sys +from threading import Event, RLock, Thread + +from lanctl import __version__ +from lanctl.apps.suite.gui_support import GuiSupportMixin +from lanctl.apps.suite.processes import ( + EmbeddedCli, + launcher_command, + open_system_cli, + process_options, +) +from lanctl.core.config import load_config +from lanctl.core.plugins.manager import get_plugin_manager +from lanctl.core.plugins.settings import PluginSettings +from lanctl.core.resources import bundled_path + + +class SuiteApi(GuiSupportMixin): + def __init__(self): + # Compatibility adapter until shared desktop project/settings UI moves out of LANIP. + # Only explicitly forwarded methods are exported through this WebView. + from lanctl.apps.ip.interfaces.gui.desktop import DesktopApi + + self._desktop = DesktopApi() + self._cli = EmbeddedCli() + self._lock = RLock() + + def _respond(self, action, operation): + try: + with self._lock: + return {"ok": True, **operation()} + except Exception as exc: # noqa: BLE001 - local desktop RPC boundary + from lanctl.core.errors import errors + + event = errors.from_exception( + exc, + origin=f"LANCTL.Suite.GUI.{action}", + code="SUITE.GUI.FAILED", + level=43, + print_output=False, + ) + return { + "ok": False, + "error": event.message, + "errorId": event.error_id, + "errorDetails": event.to_dict(), + } + + def bootstrap(self): + def operation(): + from lanctl.core.coordination import Coordinator + + return { + "version": __version__, + "system": platform.system(), + "architecture": platform.machine(), + "sessions": Coordinator().sessions(), + **self._desktop._projects_payload(), + **self._plugin_payload(), + } + + return self._respond("Bootstrap", operation) + + def runtime_status(self): + from lanctl.core.coordination import Coordinator + + return self._respond( + "RuntimeStatus", + lambda: {"sessions": Coordinator().sessions(), **self._plugin_payload()}, + ) + + def _plugin_payload(self): + manager = get_plugin_manager() + return { + "plugins": [ + { + "id": p.manifest.plugin_id, + "name": p.manifest.name, + "description": p.manifest.description, + "version": p.manifest.version, + "author": p.manifest.author, + "minimumLanctl": p.manifest.minimum_lanctl, + "maximumLanctl": p.manifest.maximum_lanctl, + "capabilities": list(p.manifest.capabilities), + "signature": p.signature, + "state": p.state.value, + "permissions": list(p.manifest.permissions), + "granted": sorted(p.granted), + "trusted": p.trusted, + "runtime": p.manifest.runtime, + "runtimeStatus": manager.runtime_status(p.manifest.plugin_id), + "error": p.error, + "publisherTrusted": manager.publishers.is_trusted(p.signature), + **self._configuration_status(p), + } + for p in manager.list() + ] + } + + @staticmethod + def _configuration_status(plugin): + try: + return {"hasSettings": bool(PluginSettings(plugin).fields()), "settingsError": ""} + except (OSError, ValueError, TypeError, KeyError) as exc: + from lanctl.core.errors import errors + + errors.from_exception( + exc, + origin="LANCTL.Suite.GUI.PluginSettingsRead", + code="SUITE.GUI.PLUGIN_SETTINGS.INVALID", + level=34, + print_output=False, + ) + return {"hasSettings": False, "settingsError": str(exc)} + + def trust_plugin_publisher(self, plugin_id): + def operation(): + import webview + + from lanctl.core.plugins.package import verify_package + + manager = get_plugin_manager() + plugin = manager.get(plugin_id) + if self._desktop._window is None: + raise RuntimeError("No hay ventana disponible para seleccionar el LCP firmado") + selected = self._desktop._window.create_file_dialog( + webview.OPEN_DIALOG, allow_multiple=False, file_types=("Plugin firmado (*.lcp)",) + ) + if not selected: + return {"cancelled": True} + result = verify_package(selected[0]) + if ( + result["manifest"].plugin_id != plugin_id + or result["checksum"] != plugin.checksum + or result["signature"] != plugin.signature + ): + raise ValueError("Selecciona el LCP firmado que corresponde a la versión instalada") + manager.publishers.trust_package(selected[0]) + manager.audit(plugin_id, "PUBLISHER TRUST", plugin.signature, "OK") + return self._plugin_payload() + + return self._respond("PublisherTrust", operation) + + def install_signed_plugin(self, plugin_id): + def operation(): + import webview + + from lanctl.core.plugins.package import verify_package + + manager = get_plugin_manager() + manager.get(plugin_id) + if self._desktop._window is None: + raise RuntimeError("No hay ventana disponible para seleccionar el LCP firmado") + selected = self._desktop._window.create_file_dialog( + webview.OPEN_DIALOG, allow_multiple=False, file_types=("Plugin firmado (*.lcp)",) + ) + if not selected: + return {"cancelled": True} + result = verify_package(selected[0]) + if result["manifest"].plugin_id != plugin_id: + raise ValueError("El paquete no corresponde al plugin seleccionado") + if not result["signature"].startswith("VALID_ED25519:"): + raise ValueError("El paquete necesita una firma Ed25519 válida") + manager.install(selected[0]) + return self._plugin_payload() + + return self._respond("PluginSignedInstall", operation) + + def create_project(self, name, directory="", metadata=None): + # The existing adapter writes/validates a real VLF before returning success. + with self._lock: + return self._desktop.create_project(name, directory, metadata=metadata) + + def project_metadata(self, path): + from lanctl.core.projects.metadata import read_metadata + + return self._respond("ProjectMetadataRead", lambda: read_metadata(path)) + + def save_project_metadata(self, path, values, revision): + def operation(): + from lanctl.core.projects.metadata import update_metadata + + update_metadata(path, values, revision) + return { + **self._desktop._projects_payload(), + "message": "Metadatos del proyecto guardados.", + } + + return self._respond("ProjectMetadataSave", operation) + + def project_state(self): + return self._desktop.project_state() + + def request_close(self): + return self._desktop.request_close("save") + + def use_project(self, path): + with self._lock: + return self._desktop.use_project(path) + + def save_project(self): + with self._lock: + return self._desktop.save_project() + + def select_project_file(self): + return self._desktop.select_project_file() + + def select_project_directory(self): + return self._desktop.select_project_directory() + + def get_settings(self): + return self._desktop.get_settings() + + def project_defaults(self): + def operation(): + from lanctl.core.projects.paths import resolve_project_path + + return { + "directory": str( + resolve_project_path( + "Nuevo proyecto.vlf", load_config().get("projectsDirectory") + ).parent + ), + "lan": "LAN principal", + } + + return self._respond("ProjectDefaults", operation) + + def settings_catalog(self, scope="program"): + def operation(): + # Compatibility adapter: preserves the CLI service validation and + # remote backend side effects until this adapter moves to core. + from lanctl.apps.ip.interfaces.cli.commands.settings_menu import _entries + from lanctl.core.settings_catalog import CATEGORIES + + if scope not in {"program", "project"}: + raise ValueError("Ámbito de configuración desconocido") + return { + "entries": _entries(scope), + "categories": { + **CATEGORIES, + "identity": "Identidad del proyecto", + "lan": "Identidad LAN", + "vlan": "VLAN del proyecto", + }, + } + + return self._respond("SettingsCatalog", operation) + + def save_catalog_setting(self, scope, path, value): + def operation(): + import json + + from lanctl.apps.ip.interfaces.cli.commands.settings_menu import _set + + if scope not in {"program", "project"}: + raise ValueError("Ámbito de configuración desconocido") + _set(scope, path, json.dumps(value, ensure_ascii=False)) + return {"message": "Configuración guardada"} + + return self._respond("SettingsCatalogSave", operation) + + @staticmethod + def _launcher_categories(launcher): + return { + "lanip": ("ip", "network", "wol"), + "lanwire": ("projects", "storage"), + "lanrack": ("projects", "storage"), + "lanaccess": ("access", "storage"), + "lanmon": ("monitor", "logging"), + }[launcher] + + def launcher_settings(self, launcher): + def operation(): + from lanctl.apps.ip.interfaces.cli.commands.settings_menu import _entries + from lanctl.core.settings_catalog import CATEGORIES + + categories = self._launcher_categories(launcher) + entries = [e for e in _entries("program") if e["category"] in categories] + return {"entries": entries, "categories": CATEGORIES} + + return self._respond("LauncherSettings", operation) + + def save_launcher_setting(self, launcher, path, value): + def operation(): + import json + + from lanctl.apps.ip.interfaces.cli.commands.settings_menu import _set + + if path.split(".")[0] not in self._launcher_categories(launcher): + raise ValueError("El ajuste no pertenece a este launcher") + _set("program", path, json.dumps(value, ensure_ascii=False)) + return {"message": "Configuración guardada"} + + return self._respond("LauncherSettingSave", operation) + + def save_settings(self, values): + with self._lock: + return self._desktop.save_settings(values) + + def plugin_settings(self, plugin_id): + def operation(): + plugin = get_plugin_manager().get(plugin_id) + settings = PluginSettings(plugin) + return {"fields": settings.fields(), "values": settings.load()} + + return self._respond("PluginSettingsRead", operation) + + def save_plugin_settings(self, plugin_id, values): + def operation(): + plugin = get_plugin_manager().get(plugin_id) + PluginSettings(plugin).save(values) + return {"message": "Opciones guardadas; se aplicarán al próximo inicio del plugin."} + + return self._respond("PluginSettingsSave", operation) + + def set_plugin_enabled(self, plugin_id, enabled, grants=None, trusted=False): + def operation(): + if type(enabled) is not bool or type(trusted) is not bool: + raise ValueError("estado de plugin no válido") + manager = get_plugin_manager() + plugin = manager.get(plugin_id) + if enabled: + if grants is not None and ( + not isinstance(grants, list) + or not all(isinstance(item, str) for item in grants) + or set(grants) - set(plugin.manifest.permissions) + ): + raise ValueError("permisos de plugin no válidos") + manager.enable( + plugin_id, grant=None if grants is None else set(grants), trusted=trusted + ) + else: + manager.disable(plugin_id) + return self._plugin_payload() + + return self._respond("PluginActivation", operation) + + def open_cli(self): + return self._respond( + "ExternalCLI", + lambda: open_system_cli() or {"message": "CLI abierto en la terminal del sistema."}, + ) + + def start_terminal(self): + return self._respond("TerminalStart", lambda: self._cli.start() or {}) + + def terminal_send(self, line): + return self._respond("TerminalInput", lambda: self._cli.send(line) or {}) + + def terminal_output(self): + return self._respond("TerminalOutput", self._cli.output) + + def launch_gui(self, launcher): + def operation(): + # Launch only registered graphical applications. + if launcher not in {"lanip", "lanwire", "lanrack", "lanaccess", "lanmon"}: + raise ValueError("Este launcher todavía no dispone de interfaz GUI.") + config = load_config() + arguments = ["--gui"] + if launcher == "lanip" and config.get("activeProject"): + arguments.extend(["-project", config["activeProject"]]) + flags = subprocess.CREATE_NO_WINDOW if sys.platform == "win32" else 0 + subprocess.Popen( + launcher_command(launcher, *arguments), + creationflags=flags, + **process_options(context_launcher=launcher), + ) + from lanctl.core.coordination import Coordinator + from lanctl.core.gui_instance import focus_gui + + focus_gui(Coordinator(), launcher) + close = config.get("closeGuiOnLaunch") is True + if close and self._desktop._window is not None: + self.record_activity(f"GUI de {launcher.upper()} abierta.") + self._desktop._closing = True + self._desktop._window.destroy() + return {"message": f"GUI de {launcher.upper()} abierta.", "closed": close} + + return self._respond("Launcher", operation) + + +def run_gui(): + try: + import webview + except ImportError as exc: + raise RuntimeError('Instala la interfaz gráfica con: pip install -e ".[gui]"') from exc + api = SuiteApi() + window = webview.create_window( + "LANCTL · Network Control Suite", + bundled_path("gui/suite.html").as_uri(), + js_api=api, + width=790, + height=570, + min_size=(660, 460), + background_color="#15181c", + ) + api._desktop.attach_window(window) + loaded = Event() + window.events.loaded += loaded.set + + def closing(): + if api._desktop._closing or not loaded.is_set(): + return True + Thread(target=lambda: window.evaluate_js("suiteClose()"), daemon=True).start() + return False + + window.events.closing += closing + from lanctl.apps.suite.window_style import apply_dark_caption, webview_icon_path + + window.events.shown += lambda: apply_dark_caption(window) + from lanctl.apps.access.root_control import RootInterfaceAgent + from lanctl.core.session import current_session + + def remote_action(command): + if not loaded.wait(10): + raise TimeoutError("La interfaz LANCTL todavía no está disponible") + if command.get("action") in {"data-changed", "refresh"}: + window.evaluate_js("window.suiteDataChanged = true") + elif command.get("action") == "view" and command.get("value") == "gui": + window.restore() + window.show() + + def observe(event): + if loaded.is_set(): + window.evaluate_js("window.suiteDataChanged = true") + + agent = RootInterfaceAgent("gui", remote_action) + window.events.loaded += agent.start + session = current_session() + if session: + session.subscribers.append(observe) + try: + webview.start(icon=webview_icon_path("lanctl")) + finally: + agent.stop() + if session: + session.subscribers.remove(observe) + api._cli.close() + return 0 diff --git a/src/lanctl/apps/suite/gui_support.py b/src/lanctl/apps/suite/gui_support.py new file mode 100644 index 0000000..eff43b0 --- /dev/null +++ b/src/lanctl/apps/suite/gui_support.py @@ -0,0 +1,345 @@ +"""Shared desktop adapters; domain validation belongs to the shared services.""" + +from __future__ import annotations + +import json +import os +import subprocess +import sys +from threading import Lock, Thread + +_STATE_LOCK = Lock() + + +class GuiSupportMixin: + """Explicit RPC surface used by all six native GUI windows.""" + + def _support_state(self): + with _STATE_LOCK: + if not hasattr(self, "_gui_session"): + from lanctl.core.session import current_session + + session = current_session() + self._gui_session = session.id if session else "" + self._gui_update_lock = Lock() + self._gui_update = {"status": "idle"} + return self._gui_session + + def _support_reply(self, operation): + try: + self._support_state() + return {"ok": True, **(operation() or {})} + except Exception as exc: # noqa: BLE001 - native RPC preserves originating exception + from lanctl.core.errors import errors + + name = getattr(operation, "__qualname__", "Support").split(".") + action = name[1] if name[0] == "GuiSupportMixin" and len(name) > 1 else name[0] + event = errors.from_exception( + exc, + origin=f"LANCTL.GUI.{action}", + code="GUI.SUPPORT.FAILED", + level=43, + print_output=False, + ) + return { + "ok": False, + "error": event.message, + "errorId": event.error_id, + "errorDetails": event.to_dict(), + } + + def gui_preferences(self): + from lanctl.core.gui_preferences import preferences_payload + + return self._support_reply(preferences_payload) + + def save_gui_preferences(self, values): + from lanctl.core.gui_preferences import save_preferences + + return self._support_reply(lambda: save_preferences(values)) + + def open_official_link(self, key): + from lanctl.core.official_links import open_official_link + + return self._support_reply(lambda: open_official_link(key)) + + def check_updates(self, manual=False): + self._support_state() + with self._gui_update_lock: + if self._gui_update.get("status") == "checking": + return {"ok": True, **self._gui_update} + self._gui_update = {"status": "checking"} + + def check(): + from lanctl.core.updates import UpdateService + + result = self._support_reply(lambda: UpdateService().check(manual=bool(manual))) + with self._gui_update_lock: + self._gui_update = result + + Thread(target=check, daemon=True, name="gui-update-check").start() + return {"ok": True, "status": "checking"} + + def update_status(self): + self._support_state() + with self._gui_update_lock: + return {"ok": True, **self._gui_update} + + def remind_update_later(self, version): + from lanctl.core.updates import UpdateService + + return self._support_reply(lambda: UpdateService().remind_later(version)) + + def open_update_release(self): + def open_release(): + import re + import webbrowser + + url = self._gui_update.get("url", "") + if not re.fullmatch(r"https://github\.com/CctrGy/LANCTL/releases/[^\s]+", url, re.I): + raise ValueError("No hay un enlace de versión oficial disponible") + return {"opened": webbrowser.open(url), "url": url} + + return self._support_reply(open_release) + + def record_activity(self, message, level=20, error_details=None): + def append(): + from lanctl.core.activity import ActivityStore + from lanctl.core.config import load_config + from lanctl.core.session import current_session + + session = current_session() + if session is None: + raise ValueError("No hay sesión GUI registrada para conservar la actividad") + self._gui_session = session.id + if not isinstance(message, str) or not message.strip() or len(message) > 4096: + raise ValueError("Mensaje de actividad no válido") + stored_message = message + if error_details is not None: + if not isinstance(error_details, dict): + raise ValueError("Detalle de error no válido") + details = { + k: str(error_details[k])[:128] + for k in ("origin", "code", "errorId", "timestamp", "correlationId") + if k in error_details + } + stored_message = json.dumps( + {"message": message[:1000], "error": details}, ensure_ascii=False + ) + row = ActivityStore().append( + stored_message, + launcher=session.launcher, + session=self._gui_session, + project=load_config().get("activeProject"), + level=43 if level == 43 else 20, + ) + from lanctl.core.errors import redact_text + from lanctl.core.logger import write_log + + warning = "" + try: + write_log( + "GUI_ACTIVITY " + + json.dumps( + { + "schemaVersion": 1, + "level": row["level"], + "message": redact_text(message), + "origin": f"LANCTL.{session.launcher}.GUI", + }, + ensure_ascii=False, + ) + ) + except OSError as exc: + from lanctl.core.errors import errors + + event = errors.from_exception( + exc, + origin="LANCTL.GUI.Activity.Log", + code="GUI.ACTIVITY.LOG.FAILED", + level=34, + print_output=False, + once_key="gui.activity.log", + ) + warning = f"Actividad conservada; no se pudo escribir el registro operativo: {event.message}" + return {"activity": row, "loggingWarning": warning} + + return self._support_reply(append) + + def open_monitor(self, view="activity"): + def launch(): + from lanctl.apps.suite.processes import launcher_command, process_options + + if view not in {"activity", "report", "logs"}: + raise ValueError("Vista de LANMON desconocida") + options = process_options(context_launcher="lanmon") + options["env"]["LANCTL_GUI_VIEW"] = view + options["env"]["LANCTL_GUI_SOURCE_SESSION"] = self._gui_session + subprocess.Popen( + launcher_command("lanmon", "--gui"), + **options, + creationflags=subprocess.CREATE_NO_WINDOW if sys.platform == "win32" else 0, + ) + return {"message": "LANMON abierto", "session": self._gui_session} + + return self._support_reply(launch) + + def monitor_view(self): + if getattr(self, "_launcher", None) != "lanmon": + return {"ok": True, "view": "", "sourceSession": ""} + return { + "ok": True, + "view": os.environ.get("LANCTL_GUI_VIEW", ""), + "sourceSession": os.environ.get("LANCTL_GUI_SOURCE_SESSION", ""), + } + + def open_live_logs(self): + def launch(): + from lanctl.apps.monitor.log_stream import open_log_window + + open_log_window(tui=True) + return {"message": "Visor de registros de LANMON abierto"} + + return self._support_reply(launch) + + def _require_monitor_view(self): + if getattr(self, "_launcher", None) != "lanmon": + raise ValueError("Esta operación pertenece a LANMON") + + def monitor_activity(self, session=None, all_projects=False): + def read(): + from lanctl.core.activity import ActivityStore + from lanctl.core.config import load_config + + self._require_monitor_view() + project = None if all_projects else load_config().get("activeProject") or "" + rows = ActivityStore().query(limit=500, project=project, latest=True) + for row in rows: + try: + envelope = json.loads(row["message"]) + except (ValueError, TypeError): + continue + if isinstance(envelope, dict) and isinstance(envelope.get("error"), dict): + row["message"] = envelope.get("message", "") + row["error"] = envelope["error"] + sessions = sorted({row["session"] for row in rows}) + return { + "records": [r for r in rows if not session or r["session"] == session], + "sessions": sessions, + "project": project, + } + + return self._support_reply(read) + + def monitor_logs(self): + def read(): + from collections import deque + + from lanctl.apps.monitor.log_stream import LogFollower + from lanctl.core.config import load_config + from lanctl.core.paths import application_path + + self._require_monitor_view() + if not hasattr(self, "_gui_log_follower"): + self._gui_log_follower = LogFollower( + application_path(load_config()["programLog"]), 300 + ) + self._gui_log_rows = deque(maxlen=500) + self._gui_log_rows.extend(self._gui_log_follower.poll()) + return {"records": list(self._gui_log_rows)} + + return self._support_reply(read) + + def prepare_report(self, values): + def prepare(): + from lanctl.core.diagnostics import diagnostic_markdown, prepare_diagnostic + + self._require_monitor_view() + if not isinstance(values, dict): + raise ValueError("Borrador de reporte no válido") + activity = self.monitor_activity(values.get("session") or None) + if not activity["ok"]: + raise ValueError(activity["error"]) + logs = self.monitor_logs() if values.get("includeLogs") else {"records": []} + plugins = [] + if values.get("includePlugins"): + from lanctl.core.plugins.manager import get_plugin_manager + + plugins = [ + {"id": p.manifest.plugin_id, "version": p.manifest.version} + for p in get_plugin_manager().list() + ] + report = prepare_diagnostic( + description=str(values.get("description", ""))[:16000], + steps=str(values.get("steps", ""))[:16000], + expected=str(values.get("expected", ""))[:16000], + application=activity["records"][-1]["launcher"] + if values.get("session") and activity["records"] + else "lanmon", + interface="gui", + errors=[ + { + **r.get("error", {}), + "message": r["message"], + "level": r["level"], + "timestamp": r["created"], + } + for r in activity["records"] + if r["level"] >= 40 + ] + if values.get("includeErrors", True) + else [], + logs=logs["records"][-100:] + + ( + [{"source": "gui-activity", **r} for r in activity["records"][-100:]] + if values.get("includeActivity") + else [] + ), + plugins=plugins, + context={ + "session": values.get("session", ""), + }, + anonymize=values.get("anonymize", True) is not False, + ) + self._gui_report = report + return {"report": report, "markdown": diagnostic_markdown(report)} + + return self._support_reply(prepare) + + def open_report_form(self): + def open_form(): + import webbrowser + + from lanctl.apps.monitor.bug_reports import bug_report_url + + self._require_monitor_view() + if not getattr(self, "_gui_report", None): + raise ValueError("Prepara y revisa el reporte primero") + url = bug_report_url(self._gui_report) + return {"opened": webbrowser.open(url), "url": url} + + return self._support_reply(open_form) + + def export_report(self): + def export(): + import webview + + from lanctl.core.diagnostics import export_diagnostic + + self._require_monitor_view() + if not getattr(self, "_gui_report", None): + raise ValueError("Prepara y revisa el reporte primero") + if self._window is None: + raise ValueError("No hay ventana para seleccionar el archivo") + path = self._window.create_file_dialog( + webview.SAVE_DIALOG, + save_filename="lanctl-diagnostic.md", + file_types=("Diagnóstico Markdown (*.md)",), + ) + if not path: + return {"cancelled": True} + if isinstance(path, (tuple, list)): + path = path[0] + return {"path": export_diagnostic(self._gui_report, path)} + + return self._support_reply(export) diff --git a/src/lanctl/apps/suite/launcher_gui.py b/src/lanctl/apps/suite/launcher_gui.py new file mode 100644 index 0000000..fa5918b --- /dev/null +++ b/src/lanctl/apps/suite/launcher_gui.py @@ -0,0 +1,343 @@ +"""Native desktop host for the four specialized applications.""" + +import subprocess +import sys +from pathlib import Path +from threading import Event, RLock, Thread + +from lanctl import __version__ +from lanctl.apps.suite.gui_support import GuiSupportMixin +from lanctl.apps.suite.processes import launcher_command, open_system_cli, process_options +from lanctl.core.config import load_config +from lanctl.core.resources import bundled_path + +LAUNCHERS = {"lanwire", "lanrack", "lanaccess", "lanmon"} + + +class LauncherApi(GuiSupportMixin): + def __init__(self, launcher, *, database=None, store=None, cipher="auto"): + if launcher not in LAUNCHERS: + raise ValueError("Launcher gráfico desconocido") + from lanctl.apps.suite.gui import SuiteApi + + self._launcher = launcher + self._suite = SuiteApi() + self._window = None + self._closing = False + self._lock = RLock() + config = load_config() + if launcher == "lanwire": + from lanctl.apps.wire.gui_service import WireGuiService + + self._service = WireGuiService(database or config["physicalDatabase"]) + elif launcher == "lanrack": + from lanctl.apps.rack.service import RackService + + self._service = RackService(database or config["physicalDatabase"]) + elif launcher == "lanaccess": + from lanctl.apps.access.gui_service import AccessGuiService + + self._service = AccessGuiService( + database or config["database"], store or config["credentials"], cipher + ) + else: + from lanctl.apps.monitor.gui_service import MonitorGuiService + + self._service = MonitorGuiService() + + def _respond(self, operation, action): + try: + with self._lock: + return {"ok": True, **(operation() or {})} + except Exception as exc: # noqa: BLE001 - native RPC boundary, preserve real origin + from lanctl.core.errors import errors + + event = errors.from_exception( + exc, + origin=f"LANCTL.{self._launcher}.GUI.{action}", + code="LAUNCHER.GUI.FAILED", + level=43, + print_output=False, + ) + return { + "ok": False, + "error": event.message, + "errorId": event.error_id, + "errorDetails": event.to_dict(), + } + + def _require(self, launcher): + if self._launcher != launcher: + raise ValueError("Esta operación no pertenece a la aplicación abierta") + + def bootstrap(self): + def operation(): + config = load_config() + payload = self._service.snapshot() + return { + **payload, + "launcher": self._launcher, + "version": __version__, + "project": config.get("activeProject") or "", + "projectName": Path(config["activeProject"]).stem + if config.get("activeProject") + else "Sin proyecto", + } + + return self._respond(operation, "Read") + + def rack_appearance(self, expected, identifier, values): + def apply(): + self._require("lanrack") + return self._service.set_appearance(expected, identifier, values) + + return self._respond(apply, "Appearance") + + def rack_dimensions(self, expected, identifier, values): + def apply(): + self._require("lanrack") + return self._service.set_dimensions(expected, identifier, values) + + return self._respond(apply, "Dimensions") + + def rack_create(self, values): + def create(): + from lanctl.apps.wire.gui_service import WireGuiService + + self._require("lanrack") + if not isinstance(values, dict): + raise ValueError("Datos de armario no válidos") + return WireGuiService(self._service.database.path).create({**values, "kind": "rack"}) + + return self._respond(create, "CreateRack") + + def rack_organization(self, expected, operation, values): + def apply(): + self._require("lanrack") + return self._service.organize(expected, operation, values) + + return self._respond(apply, "Organization") + + def wire_create(self, values): + def operation(): + self._require("lanwire") + return self._service.create(values) + + return self._respond(operation, "Create") + + def wire_update(self, identifier, revision, values): + def operation(): + self._require("lanwire") + return self._service.update(identifier, revision, values) + + return self._respond(operation, "Edit") + + def wire_connect(self, identifier, revision, endpoints): + def operation(): + self._require("lanwire") + return self._service.connect(identifier, revision, endpoints) + + return self._respond(operation, "Connect") + + def wire_port(self, identifier, revision, port, name, position): + def operation(): + self._require("lanwire") + return self._service.port(identifier, revision, port, name, position) + + return self._respond(operation, "Port") + + def wire_delete(self, identifier, revision): + def operation(): + self._require("lanwire") + return self._service.delete(identifier, revision) + + return self._respond(operation, "Delete") + + def access_unlock(self, password, confirmation=""): + def operation(): + self._require("lanaccess") + return self._service.unlock(password, confirmation) + + return self._respond(operation, "Unlock") + + def access_lock(self): + def operation(): + self._require("lanaccess") + return self._service.lock() + + return self._respond(operation, "Lock") + + def access_set(self, selector, protocol, username, password, confirmation): + def operation(): + self._require("lanaccess") + return self._service.set(selector, protocol, username, password, confirmation) + + return self._respond(operation, "CredentialSave") + + def access_delete(self, identifier): + def operation(): + self._require("lanaccess") + return self._service.delete(identifier) + + return self._respond(operation, "CredentialDelete") + + def access_open(self, identifier): + def operation(): + self._require("lanaccess") + return self._service.open(identifier) + + return self._respond(operation, "Open") + + def monitor_action(self, action): + def operation(): + self._require("lanmon") + return {"result": self._service.action(action)} + + return self._respond(operation, "MonitorAction") + + def monitor_samples(self, identifier): + def operation(): + self._require("lanmon") + return {"samples": self._service.samples(identifier)} + + return self._respond(operation, "Metrics") + + def monitor_incident(self, identifier, action): + def operation(): + self._require("lanmon") + return {"incident": self._service.incident(identifier, action)} + + return self._respond(operation, "Incident") + + def settings(self): + return self._suite.launcher_settings(self._launcher) + + def projects(self): + return self._respond(self._suite._desktop._projects_payload, "Projects") + + def select_project_file(self): + return self._suite.select_project_file() + + def select_project_directory(self): + return self._suite.select_project_directory() + + def use_project(self, path): + def operation(): + self._require("lanwire") + result = self._suite.use_project(path) + if result.get("ok"): + from lanctl.apps.wire.gui_service import WireGuiService + + self._service = WireGuiService(load_config()["physicalDatabase"]) + return result + + return self._respond(operation, "ProjectSwitch") + + def save_setting(self, path, value): + return self._suite.save_launcher_setting(self._launcher, path, value) + + def project_state(self): + return self._suite._desktop.project_state() + + def save_project(self): + return self._suite.save_project() + + def open_cli(self): + return self._respond( + lambda: open_system_cli(self._launcher) or {"message": "CLI abierto"}, "CLI" + ) + + def open_gui(self, launcher="lanctl"): + def operation(): + if launcher not in {"lanctl", "lanwire", "lanrack", "lanmon"}: + raise ValueError("Destino no permitido") + subprocess.Popen( + launcher_command(launcher, "--gui"), + creationflags=subprocess.CREATE_NO_WINDOW if sys.platform == "win32" else 0, + **process_options(context_launcher=launcher), + ) + return {"message": launcher.upper() + " GUI abierta"} + + return self._respond(operation, "Launcher") + + def request_close(self): + def operation(): + if self._launcher == "lanaccess": + self._service.lock() + self._closing = True + self._window.destroy() + return {"closed": True} + + return self._respond(operation, "Close") + + +def run_gui(launcher, **options): + import webview + + from lanctl.apps.access.root_control import RootInterfaceAgent + from lanctl.apps.suite.window_style import apply_dark_caption, webview_icon_path + + project = options.pop("project", None) + if project: + from lanctl.core.projects.workspace import prepare_project_workspace + from lanctl.core.session import current_session + + workspace = prepare_project_workspace(project, config=load_config()) + session = current_session() + if session is None: + raise RuntimeError("Abre el proyecto desde el launcher coordinado") + with session.lock: + session.config.update( + activeProject=str(workspace.project), + database=str(workspace.database), + groups=str(workspace.groups), + projectWorkspace={ + "project": str(workspace.project), + "projectId": workspace.project_id, + "database": str(workspace.database), + "groups": str(workspace.groups), + "metadata": str(workspace.metadata), + "contentHash": workspace.content_hash, + }, + ) + api = LauncherApi(launcher, **options) + window = webview.create_window( + launcher.upper() + " · LANCTL", + bundled_path("gui/launcher.html").as_uri(), + js_api=api, + width=1100, + height=780, + min_size=(780, 560), + background_color="#15181c", + ) + api._window = window + api._suite._desktop.attach_window(window) + loaded = Event() + window.events.loaded += loaded.set + window.events.shown += lambda: apply_dark_caption(window, launcher) + + def closing(): + if api._closing or not loaded.is_set(): + return True + Thread(target=lambda: window.evaluate_js("launcherClose()"), daemon=True).start() + return False + + def remote_action(command): + if not loaded.wait(10): + raise TimeoutError("La GUI todavía no está disponible") + if command.get("action") in {"data-changed", "refresh"}: + window.evaluate_js("window.launcherDataChanged=true") + elif command.get("action") == "view" and command.get("value") == "gui": + window.restore() + window.show() + + window.events.closing += closing + agent = RootInterfaceAgent("gui", remote_action) + window.events.loaded += agent.start + try: + webview.start(icon=webview_icon_path(launcher)) + finally: + agent.stop() + if launcher == "lanaccess": + api._service.lock() + return 0 diff --git a/src/lanctl/apps/suite/processes.py b/src/lanctl/apps/suite/processes.py new file mode 100644 index 0000000..a17707f --- /dev/null +++ b/src/lanctl/apps/suite/processes.py @@ -0,0 +1,124 @@ +"""Local GUI process adapters; never interpolate commands into a shell.""" + +from __future__ import annotations + +import os +import shutil +import subprocess +import sys +from collections import deque +from pathlib import Path +from threading import Lock, Thread + +from lanctl.core.paths import application_directory + + +def launcher_command(launcher="lanctl", *arguments): + if launcher not in {"lanctl", "lanip", "lanwire", "lanrack", "lanaccess", "lanmon"}: + raise ValueError("launcher gráfico no disponible") + if getattr(sys, "frozen", False): + suffix = ".exe" if sys.platform == "win32" else "" + return [str(Path(sys.executable).with_name(launcher + suffix)), *arguments] + if launcher == "lanctl": + return [sys.executable, "-m", "lanctl", *arguments] + if launcher == "lanip": + return [sys.executable, "-m", "lanctl.apps.ip", *arguments] + return [sys.executable, "-m", "lanctl", launcher, *arguments] + + +def process_options(context_launcher=None): + env = dict(os.environ, PYTHONUNBUFFERED="1", PYTHONIOENCODING="utf-8") + if not getattr(sys, "frozen", False): + source = str(application_directory() / "src") + env["PYTHONPATH"] = source + os.pathsep + env.get("PYTHONPATH", "") + if context_launcher: + from lanctl.core.config import load_config + from lanctl.core.session_context import child_environment + + env = child_environment(context_launcher, load_config(), env) + return {"cwd": str(application_directory()), "env": env} + + +def open_system_cli(launcher="lanctl"): + command = launcher_command(launcher, "--cli") + options = process_options(context_launcher=launcher) + if sys.platform == "win32": + # CREATE_NEW_CONSOLE respects the user's Windows default terminal host. + subprocess.Popen(command, creationflags=subprocess.CREATE_NEW_CONSOLE, **options) + elif sys.platform.startswith("linux"): + terminal = shutil.which("x-terminal-emulator") or shutil.which("xterm") + if not terminal: + raise RuntimeError( + "No hay terminal predeterminada: instala x-terminal-emulator o xterm." + ) + subprocess.Popen([terminal, "-e", *command], **options) + else: + raise RuntimeError("El CLI externo de la GUI admite Windows y Linux.") + + +class EmbeddedCli: + """Own one real root CLI; bounded output and no command execution in the GUI process.""" + + def __init__(self): + self._process = None + self._output = deque(maxlen=20000) + self._lock = Lock() + + def start(self): + with self._lock: + if self._process is not None and self._process.poll() is None: + return + flags = subprocess.CREATE_NO_WINDOW if sys.platform == "win32" else 0 + self._process = subprocess.Popen( + launcher_command("lanctl", "--cli"), + stdin=subprocess.PIPE, + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, + text=True, + encoding="utf-8", + errors="replace", + creationflags=flags, + **process_options(), + ) + Thread(target=self._read, args=(self._process,), daemon=True).start() + + def _read(self, process): + try: + for char in iter(lambda: process.stdout.read(1), ""): + with self._lock: + self._output.append(char) + finally: + process.stdout.close() + + def send(self, line): + if not isinstance(line, str) or len(line) > 4096 or any(c in line for c in "\n\r\x00"): + raise ValueError("entrada de consola no válida") + with self._lock: + if self._process is None or self._process.poll() is not None: + raise RuntimeError("La consola está cerrada. Vuelve a abrir Terminal.") + self._process.stdin.write(line + "\n") + self._process.stdin.flush() + + def output(self): + with self._lock: + text = "".join(self._output) + self._output.clear() + return { + "text": text, + "running": self._process is not None and self._process.poll() is None, + } + + def close(self): + with self._lock: + process = self._process + self._process = None + if process is not None: + if process.poll() is None: + process.terminate() + try: + process.wait(timeout=3) + except subprocess.TimeoutExpired: + process.kill() + process.wait(timeout=3) + if process.stdin: + process.stdin.close() diff --git a/src/lanctl/apps/suite/window_style.py b/src/lanctl/apps/suite/window_style.py new file mode 100644 index 0000000..1ca16b8 --- /dev/null +++ b/src/lanctl/apps/suite/window_style.py @@ -0,0 +1,32 @@ +"""Best-effort native Windows caption styling; native window controls remain intact.""" + +import sys + +from lanctl.core.resources import bundled_path + + +def webview_icon_path(launcher: str) -> str: + """WinForms constructs System.Drawing.Icon directly, so Windows requires ICO.""" + suffix = "ico" if sys.platform == "win32" else "png" + return str(bundled_path(f"assets/launcher-icons/{launcher}.{suffix}")) + + +def apply_dark_caption(window, launcher="lanctl"): + if sys.platform != "win32": + return + import ctypes + + try: + handle = int(window.native.Handle.ToInt64()) + from lanctl.core.window_icons import apply_window_icon + + apply_window_icon(handle, launcher) + dwm = ctypes.windll.dwmapi + for attribute, value in ((20, 1), (35, 0x171410), (36, 0xF5F2EE)): + number = ctypes.c_int(value) + dwm.DwmSetWindowAttribute( + ctypes.c_void_p(handle), attribute, ctypes.byref(number), ctypes.sizeof(number) + ) + except (AttributeError, OSError, TypeError, ValueError): + # Earlier Windows versions / other WebView backends retain their native caption. + return diff --git a/src/lanctl/apps/wire/cli/main.py b/src/lanctl/apps/wire/cli/main.py index bdc483a..8085641 100644 --- a/src/lanctl/apps/wire/cli/main.py +++ b/src/lanctl/apps/wire/cli/main.py @@ -8,6 +8,7 @@ from lanctl import __version__ from lanctl.apps.wire.cli.commands import CommandProcessor from lanctl.apps.wire.idf.database import DEFAULT_DATABASE_PATH, IDFDatabaseManager +from lanctl.core.config import load_config from lanctl.core.parser import LANCTLArgumentParser, normalize_help_arguments from lanctl.core.session import coordinated_launcher @@ -34,11 +35,12 @@ def build_parser() -> LANCTLArgumentParser: ) parser.add_argument( "--database", - default=DEFAULT_DATABASE_PATH, + default=load_config().get("physicalDatabase", DEFAULT_DATABASE_PATH), metavar="ARCHIVO.db", help="Base física IDF; por defecto usa physical/idf.db en la raíz compartida.", ) mode = parser.add_mutually_exclusive_group() + mode.add_argument("--gui", action="store_true", help="Abre la interfaz gráfica de escritorio.") mode.add_argument( "-tui", "--tui", action="store_true", help="Abre la interfaz de pantalla completa." ) @@ -203,6 +205,10 @@ def main(argv: list[str] | None = None) -> int: arguments = list(sys.argv[1:] if argv is None else argv) arguments = normalize_help_arguments(arguments) args = build_parser().parse_args(arguments) + if getattr(args, "gui", False): + from lanctl.apps.suite.launcher_gui import run_gui + + return run_gui("lanwire", database=args.database) if args.tui or args.command == "tui" or (not args.cli and args.command is None): from lanctl.apps.wire.tui import run_tui diff --git a/src/lanctl/apps/wire/gui_service.py b/src/lanctl/apps/wire/gui_service.py new file mode 100644 index 0000000..d292e04 --- /dev/null +++ b/src/lanctl/apps/wire/gui_service.py @@ -0,0 +1,224 @@ +"""Structured desktop operations on the same IDF database as CLI/TUI.""" + +import hashlib +import ipaddress +import json +from copy import deepcopy + +from lanctl.apps.wire.idf.database import IDFDatabaseManager +from lanctl.apps.wire.topology import ( + build_new_idf_data, + build_ports, + compatible_connection, + groups_for, +) +from lanctl.core.file_transaction import locked_file + + +def revision(record): + return hashlib.sha256(json.dumps(record, sort_keys=True).encode()).hexdigest() + + +class WireGuiService: + def __init__(self, path): + self.database = IDFDatabaseManager(path) + + def snapshot(self): + from lanctl.apps.rack.organization import snapshot + + with locked_file(self.database.path): + return { + "records": [ + {**r, "revision": revision(r), "filterGroups": sorted(groups_for(r))} + for r in self.database.all() + ], + "storage": str(self.database.path), + **snapshot(self.database), + } + + def _record(self, identifier, expected): + record = self.database.get(identifier) + if record is None: + raise ValueError("El elemento ya no existe; actualiza la lista") + if revision(record) != expected: + raise ValueError("El elemento cambió en otra ventana; actualiza antes de editar") + return record + + @staticmethod + def _fields(data, values): + result = deepcopy(data) + for key in ("name", "alias", "description"): + if key in values: + if not isinstance(values[key], str): + raise ValueError(f"{key} debe ser texto") + result[key] = values[key].strip() + if "rack" in values: + unit = values.get("unit") + if unit is not None and (type(unit) is not int or not 1 <= unit <= 100): + raise ValueError("La unidad debe estar entre 1 y 100") + result["location"] = { + **result.get("location", {}), + "rack": values["rack"], + "unit": unit, + } + if "connectionMode" in values: + if values["connectionMode"] not in {"wired", "wifi", "mixed"}: + raise ValueError("Selecciona cable, Wi-Fi o ambas conexiones") + result["connectionMode"] = values["connectionMode"] + for key in ("groups", "speeds"): + if key in values: + if not isinstance(values[key], list) or not all( + isinstance(item, str) for item in values[key] + ): + raise ValueError(f"{key} debe ser una lista de textos") + result[key] = values[key] + if "ip" in values: + if values["ip"]: + ipaddress.ip_address(values["ip"]) + result["ip"] = values["ip"] + if "kind" in values: + if values["kind"] not in {"wire.copper", "wire.fiber", "wire.dac"}: + raise ValueError("Medio de cable desconocido") + result["kind"] = values["kind"] + if "units" in values: + from lanctl.core.rack_dimensions import validate_height + + result["units"] = validate_height(values["units"]) + for alias in ("size_units", "height"): + if alias in result: + result[alias] = result["units"] + if "widthInches" in values: + from lanctl.core.rack_dimensions import validate_width + + result["rackDimensions"] = { + "schemaVersion": 1, + "widthInches": validate_width(values["widthInches"]), + } + return result + + def create(self, values): + kind = values["kind"] + if kind == "rack": + from lanctl.core.rack_dimensions import validate_height + + units = validate_height(values.get("units", 42)) + data = {"type": "rack", "units": units} + elif kind in {"panel", "outlet"}: + data = { + "type": f"device.{kind}", + "ports": build_ports(24, "P{n}") + if kind == "panel" + else build_ports(2, "WALL,ROOM"), + } + else: + data = build_new_idf_data(kind) + data = self._fields( + data, + {key: value for key, value in values.items() if key not in {"kind", "units"}}, + ) + record = self.database.create(values["prefix"], data=data) + return {"id": record["id"]} + + def update(self, identifier, expected, values): + with locked_file(self.database.path): + record = self._record(identifier, expected) + data = self._fields(record["data"], values) + if "portChanges" in values: + for name, changes in values["portChanges"].items(): + if name not in data.get("ports", {}): + raise ValueError("El puerto ya no existe") + if changes.get("kind") not in { + "wire.copper", + "wire.fiber", + "wire.dac", + "connection.rj45", + "connection.fiber", + "connection.dac", + "connection.unknown", + }: + raise ValueError("Medio del puerto desconocido") + if type(changes.get("poe")) is not bool: + raise ValueError("PoE debe ser activado o desactivado") + data["ports"][name].update(kind=changes["kind"], poe=changes["poe"]) + all_records = self.database.all() + for wire in all_records: + cable = data if wire["id"] == identifier else wire["data"] + if cable.get("type") != "wire": + continue + if wire["id"] != identifier and not any( + endpoint.get("device") == identifier for endpoint in cable.get("endpoints", []) + ): + continue + for endpoint in cable.get("endpoints", []): + device = ( + data + if endpoint["device"] == identifier + else (self.database.get(endpoint["device"]) or {}).get("data", {}) + ) + port = device.get("ports", {}).get(endpoint["port"]) + if port is not None: + compatible, reason = compatible_connection(cable, port) + if not compatible: + raise ValueError(reason) + from lanctl.apps.rack.skins import span, validate_location + + if data.get("type") == "rack": + for other in all_records: + location = other["data"].get("location", {}) + if location.get("rack") == identifier and ( + (location.get("unit") or 0) + span(other["data"]) - 1 + ) > data.get("units", 42): + raise ValueError("La altura deja equipos fuera del rack") + if data.get("location", {}).get("rack"): + rack = self.database.get(data["location"]["rack"]) + if not rack or rack["data"].get("type") != "rack": + raise ValueError("El rack indicado no existe") + if data["location"].get("unit") and data["location"]["unit"] > int( + rack["data"].get("units", 42) + ): + raise ValueError("La unidad excede la altura del rack") + if "rack" in values or "unit" in values: + validate_location(all_records, identifier, data) + self.database.update(identifier, data) + + def connect(self, identifier, expected, endpoints): + if not isinstance(endpoints, list) or len(endpoints) > 2: + raise ValueError("Un cable admite como máximo dos extremos") + with locked_file(self.database.path): + wire = self._record(identifier, expected) + if wire["data"].get("type") != "wire": + raise ValueError("Selecciona un cable") + if wire["data"].get("source") and len(endpoints) > 1: + raise ValueError("El suministro externo ya ocupa uno de los extremos del cable") + seen = set() + normalized = [] + for endpoint in endpoints: + device = self.database.get(endpoint["device"]) + port = (device or {}).get("data", {}).get("ports", {}).get(endpoint["port"]) + if port is None: + raise ValueError("El equipo o puerto indicado no existe") + compatible, reason = compatible_connection(wire["data"], port) + if not compatible: + raise ValueError(reason) + endpoint = {"device": device["id"], "port": endpoint["port"]} + normalized.append(endpoint) + key = (device["id"], endpoint["port"]) + if key in seen: + raise ValueError("Los dos extremos no pueden ocupar el mismo puerto") + seen.add(key) + for other in self.database.all(): + if other["id"] != identifier and endpoint in other["data"].get("endpoints", []): + raise ValueError(f"El puerto ya está ocupado por {other['id']}") + data = deepcopy(wire["data"]) + data["endpoints"] = normalized + self.database.update(identifier, data) + + def port(self, identifier, expected, port, name, position): + with locked_file(self.database.path): + self._record(identifier, expected) + self.database.edit_port(identifier, port, name=name, position=int(position)) + + def delete(self, identifier, expected): + with locked_file(self.database.path): + self._record(identifier, expected) + self.database.delete(identifier) diff --git a/src/lanctl/apps/wire/idf/database.py b/src/lanctl/apps/wire/idf/database.py index febb6bc..416cc25 100644 --- a/src/lanctl/apps/wire/idf/database.py +++ b/src/lanctl/apps/wire/idf/database.py @@ -225,6 +225,20 @@ def replace(database: dict[str, Any]) -> None: if identifier.value not in database["records"]: raise KeyError(identifier.value) record = database["records"][identifier.value] + if record.get("prefix") == "RK" or (record.get("data") or {}).get("type") == "rack": + from lanctl.apps.rack.skins import span + from lanctl.core.rack_dimensions import validate_dimension_change + + occupants = [ + ( + (r.get("data") or {}).get("location", {}).get("unit"), + span(r.get("data") or {}), + ) + for r in database["records"].values() + if str((r.get("data") or {}).get("location", {}).get("rack", "")).casefold() + == identifier.value.casefold() + ] + validate_dimension_change(record.get("data") or {}, data, occupants) old_ports = set((record.get("data") or {}).get("ports") or {}) new_ports = set(data.get("ports") or {}) removed_ports = old_ports - new_ports @@ -353,6 +367,11 @@ def _normalize_prefix(prefix: str) -> str: @staticmethod def _new_record(identifier: IDF, data: dict[str, Any] | None) -> dict[str, Any]: timestamp = IDFDatabaseManager._timestamp() + normalized = apply_prefix_defaults(identifier.prefix, data) + if identifier.prefix == "RK" or normalized.get("type") == "rack": + from lanctl.core.rack_dimensions import new_rack_dimensions + + normalized = new_rack_dimensions(normalized) return { "id": identifier.value, "size": identifier.size.value if identifier.size else "custom", @@ -360,7 +379,7 @@ def _new_record(identifier: IDF, data: dict[str, Any] | None) -> dict[str, Any]: "number_width": identifier.number_width, "prefix": identifier.prefix, "number": identifier.number, - "data": apply_prefix_defaults(identifier.prefix, data), + "data": normalized, "created_at": timestamp, "updated_at": timestamp, } diff --git a/src/lanctl/apps/wire/idf/sample_topology.py b/src/lanctl/apps/wire/idf/sample_topology.py index 4c5527c..676a6ec 100644 --- a/src/lanctl/apps/wire/idf/sample_topology.py +++ b/src/lanctl/apps/wire/idf/sample_topology.py @@ -61,6 +61,8 @@ def sample_elements() -> dict[str, dict[str, Any]]: "alias": "R0", "name": "Rack principal", "size_units": 18, + "units": 18, + "rackDimensions": {"schemaVersion": 1, "widthInches": 19}, "layout": [ {"unit": 3, "height": 2, "kind": "tray", "label_lines": ["Bandeja", ""]}, {"unit": 5, "height": 4, "kind": "case", "label_lines": ["", "Server", "Case", ""]}, @@ -207,8 +209,17 @@ def seed_sample_topology(database: IDFDatabaseManager) -> tuple[str, ...]: if existing is None: database.add(identifier, data) created.append(identifier) - elif existing.get("data") != data: - raise ValueError(f"el registro existente difiere de la plantilla: {identifier}") + else: + expected = deepcopy(data) + stored = existing.get("data") or {} + if data.get("type") == "rack": + # Older samples did not store these fields. Compare without + # adding defaults to their persisted data or hiding edits. + for key in ("units", "rackDimensions"): + if key not in stored: + expected.pop(key, None) + if stored != expected: + raise ValueError(f"el registro existente difiere de la plantilla: {identifier}") return tuple(created) diff --git a/src/lanctl/apps/wire/models/rack.py b/src/lanctl/apps/wire/models/rack.py index b69734b..99fd365 100644 --- a/src/lanctl/apps/wire/models/rack.py +++ b/src/lanctl/apps/wire/models/rack.py @@ -33,9 +33,12 @@ class NetworkRack: Cada U contiene un RackElement. """ - def __init__(self, name: str, size_u: int = 18): + def __init__(self, name: str, size_u: int = 18, *, width_inches: int = 19): + from lanctl.core.rack_dimensions import validate_height, validate_width + self.name = name - self.size_u = size_u + self.size_u = validate_height(size_u) + self.width_inches = validate_width(width_inches) self.elements: list[RackElement] = [RackElement("empty") for _ in range(size_u)] def set_element(self, u: int, element: RackElement): diff --git a/src/lanctl/apps/wire/xfile.py b/src/lanctl/apps/wire/xfile.py index 5b53a71..670ac17 100644 --- a/src/lanctl/apps/wire/xfile.py +++ b/src/lanctl/apps/wire/xfile.py @@ -108,7 +108,11 @@ def lock_path(path: str | Path) -> Path: @contextmanager def locked_file(path: str | Path, *, timeout: float = 15.0) -> Iterator[None]: - with FileLock(lock_path(path), timeout=timeout): + # Preserve this adapter while sharing reentrant transaction ownership with + # core. GUI edits check a revision and write under the same outer lock. + from lanctl.core.file_transaction import locked_file as shared_lock + + with shared_lock(path, timeout=timeout): yield diff --git a/src/lanctl/bootstrap/lanctl.py b/src/lanctl/bootstrap/lanctl.py index 2786b70..cd9fa2c 100644 --- a/src/lanctl/bootstrap/lanctl.py +++ b/src/lanctl/bootstrap/lanctl.py @@ -45,6 +45,12 @@ def build_parser() -> LANCTLArgumentParser: mode = parser.add_mutually_exclusive_group() mode.add_argument("--cli", "-cli", action="store_true", help="Abre la consola principal.") mode.add_argument("-tui", "--tui", action="store_true", help="Abre el TUI principal.") + mode.add_argument("--gui", action="store_true", help="Abre el centro gráfico de LANCTL.") + links = parser.add_mutually_exclusive_group() + for key, label in (("web", "la web"), ("github", "GitHub"), ("reference", "la referencia")): + links.add_argument( + f"-{key}", f"--{key}", action="store_true", help=f"Muestra y abre {label} oficial." + ) parser.add_argument( "--admin", action="store_true", @@ -59,6 +65,33 @@ def build_parser() -> LANCTLArgumentParser: name, help="Administración compartida de la suite.", add_help=False ) child.add_argument("arguments", nargs=argparse.REMAINDER, help=argparse.SUPPRESS) + setup = launchers.add_parser( + "setup-defaults", + help="Inicializa preferencias de instalación sin sobrescribir las existentes.", + ) + setup.add_argument( + "--theme", + choices=("graphite", "midnight", "forest", "violet", "light"), + default="graphite", + help="Tema inicial.", + ) + setup.add_argument( + "--plugins", + default="all", + help="all, none o IDs de plugins opcionales separados por comas.", + ) + completions = launchers.add_parser( + "completions", help="Registra o retira el completado Clink del usuario actual." + ) + completions.add_argument("action", choices=("install", "uninstall")) + post_install = launchers.add_parser( + "post-install", help="Abre LANIP con el usuario normal al finalizar la instalación." + ) + post_install.add_argument( + "--first-scan", + action="store_true", + help="Prepara confirmación del rango; no inicia sondas.", + ) return parser @@ -107,6 +140,35 @@ def main(argv: list[str] | None = None) -> int: from lanctl.bootstrap.lanip import main as ip_main return ip_main(arguments) + if arguments and arguments[0] in {"setup-defaults", "completions", "post-install"}: + import json + + args = build_parser().parse_args(arguments) + try: + if args.launcher == "setup-defaults": + from lanctl.core.installation import initialize_defaults + + result = initialize_defaults(theme=args.theme, plugins=args.plugins) + elif args.launcher == "completions": + from lanctl.core.clink_integration import configure_clink + + result = configure_clink(args.action) + else: + from lanctl.core.first_scan import launch_installed_gui + + result = launch_installed_gui(first_scan=args.first_scan) + print(json.dumps(result, ensure_ascii=False)) + return 0 + except (OSError, ValueError) as exc: + from lanctl.core.errors import errors + + errors.from_exception( + exc, + origin="LANCTL.Suite.Install.Configure", + code="INSTALL.CONFIGURE.FAILED", + level=43, + ) + return 2 launcher_names = {*_LAUNCHERS, "ip", "wire", "rack", "access", "monitor"} if has_help_argument(arguments): if arguments and arguments[0].casefold() in launcher_names: @@ -114,12 +176,50 @@ def main(argv: list[str] | None = None) -> int: return build_parser().parse_args(arguments) if arguments and arguments[0].casefold() in launcher_names: return _run_launcher(arguments[0].casefold(), arguments[1:]) - if not arguments or arguments[0] in {"--cli", "-cli", "--tui", "-tui"}: + if any( + word in {"-web", "--web", "-github", "--github", "-reference", "--reference"} + for word in arguments + ): + import webbrowser + + from lanctl.core.official_links import get_official_links, open_official_link + + parser = build_parser() + args = parser.parse_args(arguments) + if args.launcher or args.gui or args.cli or args.tui or args.admin: + parser.error("usa el enlace oficial sin otros modos ni comandos") + key = next(key for key in get_official_links() if getattr(args, key)) + # Plain complete URLs are clickable in capable terminals and remain useful + # when redirected; no escape sequences or shell interpolation are needed. + print(get_official_links()[key]) + try: + open_official_link(key) + except (OSError, webbrowser.Error) as exc: + from lanctl.core.errors import errors + + errors.from_exception( + exc, origin="LANCTL.Suite.Links.Open", code="SUITE.LINK.OPEN.FAILED", level=24 + ) + return 2 + return 0 + if not arguments or arguments[0] in {"--cli", "-cli", "--tui", "-tui", "--gui"}: from lanctl.apps.suite.interfaces import run_console args = build_parser().parse_args(arguments) if args.launcher: build_parser().error("usa lanctl LAUNCHER --cli o --tui") + if args.gui: + from lanctl.apps.suite.gui import run_gui + + try: + return run_gui() + except (ImportError, OSError, RuntimeError) as exc: + from lanctl.core.errors import errors + + errors.from_exception( + exc, origin="LANCTL.Suite.GUI.Start", code="SUITE.GUI.START.FAILED", level=43 + ) + return 2 return run_console(tui=args.tui) parser = build_parser() parser.parse_args(arguments) diff --git a/src/lanctl/bootstrap/lanmon.py b/src/lanctl/bootstrap/lanmon.py index 3ed421c..f48bcc6 100644 --- a/src/lanctl/bootstrap/lanmon.py +++ b/src/lanctl/bootstrap/lanmon.py @@ -35,6 +35,7 @@ def build_parser() -> LANCTLArgumentParser: if action.dest == "words": action.help = "logs, events, status, attach, detach, once, session, incidents, service o foreground." mode = parser.add_mutually_exclusive_group() + mode.add_argument("--gui", action="store_true", help="Abre la interfaz gráfica de escritorio.") mode.add_argument("--cli", "-cli", action="store_true", help="Abre la consola de comandos.") mode.add_argument( "--tui", "-tui", action="store_true", help="Abre el visor tabular de eventos." @@ -62,8 +63,21 @@ def _main(argv: list[str] | None = None) -> int: return run(arguments[1:]) args = build_parser().parse_args(arguments or ["status"]) - if args.window and (args.words != ["logs"] or args.cli or args.tui): + if getattr(args, "gui", False): + from lanctl.apps.suite.launcher_gui import run_gui + + return run_gui("lanmon", project=args.project) + if args.window and (args.words != ["logs"] or args.cli): raise ValueError("--window solo se utiliza con logs") + if args.words == ["logs"] and args.tui and not args.cli: + from lanctl.apps.monitor.log_stream import open_log_window + from lanctl.apps.monitor.log_tui import follow_log_tui + + if args.project or args.source == "project": + raise ValueError("La TUI en directo muestra el log operativo, no auditorías VLF.") + if args.window: + return open_log_window(limit=args.limit, minimum=args.level, tui=True) + return follow_log_tui(limit=args.limit, minimum=args.level) if args.cli or args.tui: from lanctl.core.interactive_console import command_console diff --git a/src/lanctl/core/activity.py b/src/lanctl/core/activity.py new file mode 100644 index 0000000..57fcafc --- /dev/null +++ b/src/lanctl/core/activity.py @@ -0,0 +1,88 @@ +"""Bounded, principal-scoped GUI activity transport, independent of project files.""" + +from __future__ import annotations + +import sqlite3 +import time +from contextlib import closing, contextmanager +from pathlib import Path + +from lanctl.core.coordination import Coordinator, principal_id +from lanctl.core.paths import data_root + +RETENTION = 10000 + + +class ActivityStore: + def __init__(self, path=None): + self.path = Path(path) if path is not None else data_root() / "runtime" / "activity.db" + self.owner = principal_id() + + @contextmanager + def _connection(self): + self.path.parent.mkdir(parents=True, exist_ok=True) + with closing(sqlite3.connect(self.path, timeout=5)) as db, db: + db.row_factory = sqlite3.Row + version = db.execute("PRAGMA user_version").fetchone()[0] + if version not in (0, 1): + raise ValueError("versión del transporte de actividad no compatible") + db.execute( + "CREATE TABLE IF NOT EXISTS activity (seq INTEGER PRIMARY KEY AUTOINCREMENT, owner TEXT NOT NULL, created REAL NOT NULL, message TEXT NOT NULL, launcher TEXT NOT NULL, session TEXT NOT NULL, project TEXT, level INTEGER NOT NULL, task TEXT)" + ) + db.execute("CREATE INDEX IF NOT EXISTS activity_owner_seq ON activity(owner,seq)") + db.execute("PRAGMA user_version=1") + yield db + + def append(self, message, *, launcher, session, project=None, level=20, task=None) -> dict: + if not isinstance(message, str) or not message.strip() or len(message) > 4096: + raise ValueError("mensaje de actividad vacío o mayor de 4096 caracteres") + if type(level) is not int or not 1 <= level <= 59: + raise ValueError("nivel de actividad fuera de 1-59") + if task is not None and (not isinstance(task, str) or len(task) > 128): + raise ValueError("tarea de actividad no válida") + if not isinstance(session, str) or not isinstance(launcher, str): + raise ValueError("sesión y launcher de actividad requeridos") + # The adapter supplies its actual session, not arbitrary JS origin fields. + live = next((s for s in Coordinator().sessions() if s["id"] == session), None) + if live is None or live["launcher"] != launcher or live["project"] != project: + raise ValueError("sesión, launcher o proyecto de actividad no vigentes") + clean = " ".join("".join(c for c in message if c.isprintable() or c in "\n\t").splitlines()) + created = time.time() + with self._connection() as db: + cursor = db.execute( + "INSERT INTO activity(owner,created,message,launcher,session,project,level,task) VALUES (?,?,?,?,?,?,?,?)", + (self.owner, created, clean, launcher, session, project, level, task), + ) + seq = cursor.lastrowid + db.execute( + "DELETE FROM activity WHERE owner=? AND seq NOT IN (SELECT seq FROM activity WHERE owner=? ORDER BY seq DESC LIMIT ?)", + (self.owner, self.owner, RETENTION), + ) + return { + "schemaVersion": 1, + "seq": seq, + "created": created, + "message": clean, + "launcher": launcher, + "session": session, + "project": project, + "level": level, + "task": task, + } + + def query(self, *, after=0, limit=100, session=None, project=None, latest=False) -> list[dict]: + if type(after) is not int or after < 0 or type(limit) is not int or not 1 <= limit <= 1000: + raise ValueError("cursor o límite de actividad no válido") + if any(value is not None and not isinstance(value, str) for value in (session, project)): + raise ValueError("filtro de actividad no válido") + if type(latest) is not bool: + raise ValueError("latest debe ser booleano") + if not self.path.exists(): + return [] + with self._connection() as db: + rows = db.execute( + "SELECT seq,created,message,launcher,session,project,level,task FROM activity WHERE owner=? AND seq>? AND (? IS NULL OR session=?) AND (? IS NULL OR COALESCE(project,'')=?) ORDER BY CASE WHEN ? THEN -seq ELSE seq END LIMIT ?", + (self.owner, after, session, session, project, project, latest, limit), + ) + result = [{"schemaVersion": 1, **dict(row)} for row in rows] + return list(reversed(result)) if latest else result diff --git a/src/lanctl/core/clink_integration.py b/src/lanctl/core/clink_integration.py new file mode 100644 index 0000000..edece0e --- /dev/null +++ b/src/lanctl/core/clink_integration.py @@ -0,0 +1,144 @@ +"""Scoped Clink registration using native executable arguments, never a command shell.""" + +from __future__ import annotations + +import hashlib +import json +import os +import shutil +import subprocess +import sys +from pathlib import Path + +from lanctl.core.coordination import principal_id +from lanctl.core.file_transaction import atomic_write_json, locked_file +from lanctl.core.local_permissions import elevated +from lanctl.core.paths import application_directory + + +def _find_clink(*, trusted_only=False): + candidates = [] + if not trusted_only: + candidates.extend( + shutil.which(name) for name in ("clink.exe", "clink_x64.exe", "clink_x86.exe") + ) + if trusted_only: + import winreg + + bases = [] + try: + with winreg.OpenKey( + winreg.HKEY_LOCAL_MACHINE, + r"SOFTWARE\Microsoft\Windows\CurrentVersion", + 0, + winreg.KEY_READ | winreg.KEY_WOW64_64KEY, + ) as key: + for name in ("ProgramFilesDir", "ProgramFilesDir (x86)"): + try: + value, kind = winreg.QueryValueEx(key, name) + if kind == winreg.REG_SZ and isinstance(value, str): + bases.append(value) + except FileNotFoundError: + continue + except OSError: + return None + else: + bases = (os.environ.get("PROGRAMFILES"), os.environ.get("PROGRAMFILES(X86)")) + for base in bases: + if base: + candidates.extend( + str(Path(base) / "clink" / name) + for name in ("clink_x64.exe", "clink.exe", "clink_x86.exe") + ) + return next((str(Path(p).resolve()) for p in candidates if p and Path(p).is_file()), None) + + +def _marker(directory): + key = hashlib.sha256(os.path.normcase(str(directory)).encode()).hexdigest()[:24] + return ( + Path(os.environ.get("LOCALAPPDATA", str(Path.home()))) / "LANCTL" / "clink" / f"{key}.json" + ) + + +def _registration_matches(executable, scripts, action): + """Clink returns 1 for an already installed/absent path; verify its actual state.""" + listing = subprocess.run( + [executable, "installscripts", "--list"], + capture_output=True, + text=True, + encoding="utf-8", + errors="replace", + timeout=10, + check=False, + creationflags=subprocess.CREATE_NO_WINDOW, + ) + if listing.returncode: + return False + expected = os.path.normcase(os.path.normpath(str(scripts))) + registered = any( + os.path.normcase(os.path.normpath(line.strip())) == expected + for line in listing.stdout.splitlines() + if line.strip() + ) + return registered == (action == "install") + + +def configure_clink(action, directory=None): + if action not in {"install", "uninstall"}: + raise ValueError("acción Clink no válida") + scripts = ( + Path(directory).resolve() + if directory is not None + else application_directory() + / ("clink" if getattr(sys, "frozen", False) else "packaging/clink") + ) + result = {"action": action, "directory": str(scripts), "status": "unavailable"} + if os.name != "nt": + return {**result, "status": "unsupported-platform"} + admin = elevated() + if action == "install" and admin: + return {**result, "status": "normal-user-required"} + marker = _marker(scripts) + if action == "uninstall" and not marker.exists(): + return {**result, "status": "not-registered-for-user"} + if action == "install" and not (scripts / "lanctl.lua").is_file(): + raise ValueError("no se encuentra el completado LANCTL de esta distribución") + executable = _find_clink(trusted_only=admin) + if executable is None: + return result + with locked_file(marker): + if marker.exists(): + state = json.loads(marker.read_text(encoding="utf-8")) + if ( + not isinstance(state, dict) + or state.get("schemaVersion") != 1 + or state.get("owner") != principal_id() + or state.get("directory") != str(scripts) + ): + raise ValueError("registro de completado no corresponde al usuario/directorio") + command = "installscripts" if action == "install" else "uninstallscripts" + try: + completed = subprocess.run( + [executable, command, str(scripts)], + capture_output=True, + text=True, + encoding="utf-8", + errors="replace", + timeout=10, + check=False, + creationflags=subprocess.CREATE_NO_WINDOW, + ) + already_applied = completed.returncode == 1 and _registration_matches( + executable, scripts, action + ) + except subprocess.TimeoutExpired as exc: + raise TimeoutError("Clink no respondió dentro de 10 segundos") from exc + if completed.returncode and not already_applied: + raise OSError(f"Clink no pudo {command}: código {completed.returncode}") + if action == "install": + atomic_write_json( + marker, {"schemaVersion": 1, "owner": principal_id(), "directory": str(scripts)} + ) + elif marker.exists(): + marker.unlink() + return {**result, "status": "registered" if action == "install" else "unregistered"} diff --git a/src/lanctl/core/config.py b/src/lanctl/core/config.py index 1617b9a..2b86d49 100644 --- a/src/lanctl/core/config.py +++ b/src/lanctl/core/config.py @@ -101,6 +101,14 @@ "promptSaveOnCommandExit": False, "commandChaining": True, }, + "startup": {"interface": "cli", "closeGuiOnLaunch": False}, + "gui": { + "schemaVersion": 1, + "theme": "graphite", + "density": "comfortable", + "fontScale": 1.0, + "reducedMotion": False, + }, "network": { "range": None, "dhcpRange": None, @@ -209,6 +217,9 @@ "profile": "normal", "mode": "permanent", "authority": "observe", + "interface": "", + "cidr": "", + "duration": None, "execution": { "workers": 32, "timeout": 0.8, @@ -258,6 +269,8 @@ "languagesDirectory": "data/lc/languages", "cliPromptSaveOnCommandExit": False, "cliCommandChaining": True, + "startupInterface": "cli", + "closeGuiOnLaunch": False, "iconsDirectory": "data/lc/icons", "logCleanupEnabled": False, "logRetentionDays": 90, @@ -364,6 +377,9 @@ "languagesDirectory": ("localization", "languagesDirectory"), "cliPromptSaveOnCommandExit": ("cli", "promptSaveOnCommandExit"), "cliCommandChaining": ("cli", "commandChaining"), + "startupInterface": ("startup", "interface"), + "closeGuiOnLaunch": ("startup", "closeGuiOnLaunch"), + "guiPreferences": ("gui",), "range": ("network", "range"), "dhcpRange": ("network", "dhcpRange"), "tr064Port": ("network", "tr064Port"), @@ -458,6 +474,9 @@ def _legacy_monitor(document: dict) -> dict: "profile": monitor["profile"], "mode": monitor["mode"], "authority": monitor["authority"], + "interface": monitor.get("interface", ""), + "cidr": monitor.get("cidr", ""), + "duration": monitor.get("duration"), **deepcopy(monitor["execution"]), "intervals": deepcopy(monitor["intervals"]), "retention": deepcopy(monitor["retention"]), @@ -491,7 +510,7 @@ def _legacy_to_document(config: dict) -> dict: document["wol"][key] = deepcopy(value) if isinstance(config.get("monitor"), dict): monitor = config["monitor"] - for key in ("enabled", "profile", "mode", "authority"): + for key in ("enabled", "profile", "mode", "authority", "interface", "cidr", "duration"): if key in monitor: document["monitor"][key] = deepcopy(monitor[key]) for key in ("workers", "timeout", "scanOrder", "failureThreshold", "recoveryThreshold"): @@ -707,3 +726,8 @@ def update_config(update: Callable[[dict], Any]) -> dict: config = replacement save_config(config) return config + + +def config_from_document(document: dict) -> ConfigSnapshot: + """Adapt a canonical document to the session-aware compatible config view.""" + return _document_to_legacy(canonical_config(document)) diff --git a/src/lanctl/core/coordination.py b/src/lanctl/core/coordination.py index dde061d..245d610 100644 --- a/src/lanctl/core/coordination.py +++ b/src/lanctl/core/coordination.py @@ -233,9 +233,8 @@ def enqueue(self, target, action, value=None): if not row or not row[0]: raise ValueError("la sesión no está disponible para recibir órdenes") if action == "view" and ( - row[2] != "lanip" - or (row[3] == "gui" and value != "gui") - or (row[3] == "tui" and value == "gui") + (row[3] == "gui" and value != "gui") + or (row[3] == "tui" and (value == "gui" or row[2] != "lanip")) or row[3] not in {"gui", "tui"} ): raise ValueError("esa vista no es compatible con la interfaz destinataria") diff --git a/src/lanctl/core/data_migration.py b/src/lanctl/core/data_migration.py index d99b0c2..7eab0c7 100644 --- a/src/lanctl/core/data_migration.py +++ b/src/lanctl/core/data_migration.py @@ -47,7 +47,7 @@ "documentType": "lanctl.recurrent-elements", "elements": [], }, - "data/lc/plugins.registry": {}, + "data/lc/plugins.registry": {"schemaVersion": 1, "plugins": {}}, "data/lc/wol-sequences.json": { "schemaVersion": 1, "documentType": "lanctl.wol-sequences", diff --git a/src/lanctl/core/database.py b/src/lanctl/core/database.py index d41ad99..16cbc6c 100644 --- a/src/lanctl/core/database.py +++ b/src/lanctl/core/database.py @@ -560,8 +560,6 @@ def _edit_device_in_memory( device[deleted_field] = False device.cnf = "O" elif field == "description": - if len(value) > 42: - raise ValueError("la descripción no puede superar 42 caracteres") device.description = value or "-" elif field == "ip": try: @@ -645,8 +643,6 @@ def add_device( normalized_ip = str(ipaddress.IPv4Address(ip.strip())) except ipaddress.AddressValueError as error: raise ValueError(f"dirección IPv4 no válida: {ip}") from error - if len(description) > 42: - raise ValueError("la descripción no puede superar 42 caracteres") if alias.upper() in ("GATEWAY", "BRODCAST"): raise ValueError(f"el alias {alias.upper()} está reservado") if idf: diff --git a/src/lanctl/core/diagnostics.py b/src/lanctl/core/diagnostics.py new file mode 100644 index 0000000..1461faa --- /dev/null +++ b/src/lanctl/core/diagnostics.py @@ -0,0 +1,224 @@ +"""Explicit, bounded diagnostic selection and redaction, without network access.""" + +from __future__ import annotations + +import ipaddress +import json +import platform +import re +from datetime import datetime, timezone +from itertools import islice +from pathlib import Path + +from lanctl import __version__ +from lanctl.core.errors import redact_text +from lanctl.core.file_transaction import atomic_write_text + +_SECRET_KEY = re.compile( + r"password|passwd|credential|secret|token|private.?key|api.?key|authorization|cookie|csrf|pairing", + re.I, +) +_ASSIGNMENT = re.compile( + r"""(?i)(["']?(?:api[_ -]?key|password|passwd|secret|token|credential|authorization|cookie|csrf|pairing|private[_ -]?key)["']?\s*[:=]\s*)(?:"[^"]*"|'[^']*'|[^\s,;]+)""" +) +_PRIVATE = re.compile( + r"-----BEGIN [^-\r\n]*PRIVATE KEY-----.*?(?:-----END [^-\r\n]*PRIVATE KEY-----|$)", re.S +) +_USERINFO = re.compile(r"(\w+://)[^\s/@]+(?::[^\s/@]*)?@") +_PATH = re.compile(r"(?:[A-Za-z]:[\\/]|\\\\|(?|,;]+)") +_EMAIL = re.compile(r"[\w.+-]+@[\w.-]+\.[A-Za-z]{2,}") +_MAC = re.compile(r"(?i)\b[0-9a-f]{2}(?:[:-][0-9a-f]{2}){5}\b") +_ADDRESS = re.compile( + r"(? 5: + return "[DEPTH LIMIT]" + if isinstance(value, dict): + return { + _clean_text(k, anonymize): _sanitize(v, anonymize, str(k), depth + 1) + for k, v in islice(value.items(), 50) + } + if isinstance(value, (list, tuple)): + return [_sanitize(v, anonymize, depth=depth + 1) for v in value[:200]] + if isinstance(value, str): + return _clean_text(value, anonymize) + if value is None or type(value) in (int, float, bool): + return value + return "[UNSUPPORTED VALUE]" + + +def prepare_diagnostic( + *, + description="", + steps="", + expected="", + application="lanctl", + interface="gui", + errors=(), + logs=(), + plugins=(), + context=None, + anonymize=True, +) -> dict: + if type(anonymize) is not bool: + raise ValueError("anonymize debe ser booleano") + if any( + not isinstance(value, str) + for value in (description, steps, expected, application, interface) + ): + raise ValueError("los campos del reporte deben ser texto") + if not all(isinstance(v, (list, tuple)) for v in (errors, logs, plugins)) or ( + context is not None and not isinstance(context, dict) + ): + raise ValueError("evidencia de diagnóstico no válida") + grouped = {} + for error in errors[:200]: + if not isinstance(error, dict): + raise ValueError("cada error debe ser un objeto") + clean = _sanitize( + { + k: v + for k, v in error.items() + if k + in { + "errorId", + "code", + "origin", + "message", + "level", + "timestamp", + "correlationId", + "details", + } + }, + anonymize, + ) + key = tuple(str(clean.get(k, "")) for k in ("origin", "code", "errorId", "message")) + if key in grouped: + grouped[key]["count"] += 1 + elif len(grouped) < 50: + grouped[key] = {**clean, "count": 1} + report = { + "schemaVersion": 1, + "generatedAt": datetime.now(timezone.utc).isoformat(), + "version": __version__, + "system": { + "os": platform.system(), + "release": platform.release(), + "architecture": platform.machine(), + }, + "application": application, + "interface": interface, + "description": description, + "steps": steps, + "expected": expected, + "errors": list(grouped.values()), + "logs": list(logs[:200]), + "plugins": [ + {k: v for k, v in p.items() if k in {"id", "version", "state"}} + for p in plugins[:100] + if isinstance(p, dict) + ], + "context": { + k: v + for k, v in (context or {}).items() + if k in {"session", "task", "project", "revision", "savedRevision"} + }, + "anonymized": anonymize, + } + return _sanitize(report, anonymize) + + +def _validated(report): + if ( + not isinstance(report, dict) + or type(report.get("schemaVersion")) is not int + or report["schemaVersion"] != 1 + ): + raise ValueError("versión de diagnóstico no compatible") + if type(report.get("anonymized", True)) is not bool: + raise ValueError("anonimización de diagnóstico no válida") + # Edited drafts are scrubbed again immediately before exporting or building a URL. + return _sanitize(report, report.get("anonymized", True)) + + +def diagnostic_markdown(report: dict) -> str: + clean = _validated(report) + lines = [ + "# LANCTL · Diagnóstico", + f"Versión: {clean.get('version', '')}", + f"Aplicación/interfaz: {clean.get('application', '')}/{clean.get('interface', '')}", + f"Fecha: {clean.get('generatedAt', '')}", + ] + for key, title in ( + ("description", "Descripción"), + ("steps", "Pasos"), + ("expected", "Resultado esperado"), + ): + lines.extend(["", "## " + title, str(clean.get(key, ""))]) + evidence = {k: clean.get(k) for k in ("system", "context", "errors", "plugins", "logs")} + lines.extend( + [ + "", + "## Evidencia seleccionada", + "````json", + json.dumps(evidence, ensure_ascii=False, indent=2), + "````", + ] + ) + return "\n".join(lines) + "\n" + + +def export_diagnostic(report: dict, path) -> str: + target = Path(path) + atomic_write_text(target, diagnostic_markdown(report)) + return str(target.resolve()) diff --git a/src/lanctl/core/first_scan.py b/src/lanctl/core/first_scan.py new file mode 100644 index 0000000..e59976c --- /dev/null +++ b/src/lanctl/core/first_scan.py @@ -0,0 +1,101 @@ +"""One-shot request for a first-scan confirmation; never starts network probes.""" + +import json +import os +import subprocess +import sys +import time + +from lanctl.core.config import load_config +from lanctl.core.coordination import principal_id +from lanctl.core.file_transaction import atomic_write_json, locked_file +from lanctl.core.paths import data_root + + +def _path(): + import hashlib + + owner = hashlib.sha256(principal_id().encode()).hexdigest()[:24] + return data_root() / "runtime" / f"first-scan-{owner}.json" + + +def request_first_scan(): + path = _path() + with locked_file(path): + atomic_write_json(path, {"schemaVersion": 1, "requested": True, "created": time.time()}) + + +def _requested(path): + if not path.exists(): + return False + value = json.loads(path.read_text(encoding="utf-8")) + if ( + not isinstance(value, dict) + or type(value.get("schemaVersion")) is not int + or value["schemaVersion"] != 1 + or type(value.get("requested")) is not bool + or type(value.get("created")) not in (int, float) + ): + raise ValueError("solicitud de primer escaneo no válida") + return value["requested"] and 0 <= time.time() - value["created"] < 86400 + + +def consume_request(): + path = _path() + with locked_file(path): + requested = _requested(path) + if requested: + atomic_write_json( + path, {"schemaVersion": 1, "requested": False, "created": time.time()} + ) + return requested + + +def scan_choices(): + requested = _requested(_path()) + networks = [] + notice = "Selecciona interfaz y confirma el rango. Se usarán ICMP/ARP; DNS y descubridores externos se omiten al no garantizar el origen." + if requested: + from lanctl.core.errors import errors + from lanctl.core.network_interfaces import ipv4_interfaces + + try: + networks = ipv4_interfaces() + except (OSError, ValueError, subprocess.SubprocessError) as error: + errors.from_exception( + error, + origin="LANCTL.FirstScan.Interfaces", + code="FIRST_SCAN.INTERFACES.UNAVAILABLE", + level=23, + print_output=False, + ) + notice = "No se pudieron obtener las interfaces locales. Reintenta antes de confirmar el escaneo." + return { + "networks": networks, + "range": load_config().get("range") or "", + "requested": requested, + "interfaceSelectionAvailable": bool(networks), + "routing": "selected-source" if networks else "unavailable", + "notice": notice, + } + + +def launch_installed_gui(*, first_scan=False): + from lanctl.core.local_permissions import elevated + from lanctl.core.paths import application_directory + + if elevated(): + raise PermissionError( + "Abre LANIP desde la sesión del usuario normal; el instalador no pudo recuperar esa identidad" + ) + if first_scan: + request_first_scan() + command = ( + [str(application_directory() / ("lanip.exe" if os.name == "nt" else "lanip"))] + if getattr(sys, "frozen", False) + else [sys.executable, str(application_directory() / "lanip.py")] + ) + subprocess.Popen( + [*command, "--gui"], creationflags=subprocess.CREATE_NO_WINDOW if os.name == "nt" else 0 + ) + return {"opened": True, "scanRequested": first_scan, "scanStarted": False} diff --git a/src/lanctl/core/group_database.py b/src/lanctl/core/group_database.py index fc11f70..786af2e 100644 --- a/src/lanctl/core/group_database.py +++ b/src/lanctl/core/group_database.py @@ -242,14 +242,16 @@ def ensure_basic(self, devices: list[Device]) -> list[Group]: return groups @_transaction - def create(self, name: str) -> Group: + def create(self, name: str, description: str = "-") -> Group: + if not isinstance(description, str) or len(description) > 42: + raise ValueError("la descripción del grupo no puede superar 42 caracteres") normalized = name.upper() if not normalized: raise ValueError("el nombre del grupo no puede estar vacío") groups = self.load() if any(group.name == normalized for group in groups): raise ValueError(f"el grupo {normalized} ya existe") - group = Group(normalized) + group = Group(normalized, description or "-") groups.append(group) self._write(groups) return group diff --git a/src/lanctl/core/gui_instance.py b/src/lanctl/core/gui_instance.py new file mode 100644 index 0000000..2d4f224 --- /dev/null +++ b/src/lanctl/core/gui_instance.py @@ -0,0 +1,94 @@ +"""One GUI per launcher and local principal, protected for the process lifetime.""" + +from __future__ import annotations + +import hashlib +import os +import re +import threading +import time + +from lanctl.core.coordination import Coordinator +from lanctl.core.file_transaction import InterProcessLock + +_active = set() +_guard = threading.Lock() + + +def allow_foreground(pid): + if os.name == "nt": + import ctypes + + ctypes.windll.user32.AllowSetForegroundWindow(int(pid)) + + +def focus_gui(coordinator, launcher, *, timeout=30): + """Wait for a ready GUI and an acknowledged focus request, never spawn one.""" + deadline = time.monotonic() + timeout + command = None + while time.monotonic() < deadline: + if command is None: + for session in reversed(coordinator.sessions()): + if ( + session["launcher"] == launcher + and session["mode"] == "gui" + and session["controls"] + ): + allow_foreground(session["pid"]) + command = coordinator.enqueue(session["id"], "view", "gui") + break + else: + with coordinator.connection() as db: + row = db.execute( + "SELECT state FROM commands WHERE id=? AND owner=?", + (command, coordinator.owner), + ).fetchone() + if row and row[0] == "accepted": + return + if row and row[0] in {"failed", "expired"}: + raise RuntimeError(f"La GUI de {launcher.upper()} no pudo ponerse al frente") + time.sleep(0.05) + raise TimeoutError(f"La GUI de {launcher.upper()} no responde; no se abrirá otra ventana") + + +class GuiInstance: + def __init__(self, launcher, *, coordinator=None, timeout=30): + if not re.fullmatch(r"lan[a-z]+", launcher): + raise ValueError("launcher GUI no válido") + self.launcher = launcher + self.coordinator = coordinator or Coordinator() + identity = hashlib.sha256(self.coordinator.owner.encode()).hexdigest()[:24] + path = self.coordinator.path.parent / f"gui-{identity}-{launcher}.lock" + self.lock = InterProcessLock(path, timeout=0) + self.key = str(path.resolve()) + self.timeout = timeout + self.owned = False + + def __enter__(self): + with _guard: + available = self.key not in _active + if available: + _active.add(self.key) + if available: + try: + self.lock.acquire() + self.owned = True + return True + except TimeoutError: + with _guard: + _active.discard(self.key) + except Exception: + with _guard: + _active.discard(self.key) + raise + focus_gui(self.coordinator, self.launcher, timeout=self.timeout) + return False + + def __exit__(self, *_args): + if self.owned: + try: + self.lock.release() + finally: + self.owned = False + with _guard: + _active.discard(self.key) diff --git a/src/lanctl/core/gui_preferences.py b/src/lanctl/core/gui_preferences.py new file mode 100644 index 0000000..8a348ae --- /dev/null +++ b/src/lanctl/core/gui_preferences.py @@ -0,0 +1,116 @@ +"""Validated global display preferences; no GUI toolkit dependency.""" + +from __future__ import annotations + +import math + +from lanctl.core.config import load_config, update_config +from lanctl.core.plugins.manager import active_theme_extensions +from lanctl.core.plugins.theme import DEFAULT_TOKENS, TOKEN_TO_CSS, validate_theme_specification + +_PRESETS = ( + ("graphite", "Grafito", "#15181c", "#20272c", "#b2ef26", "#e9eff4", "#a7b5bf"), + ("midnight", "Azul noche", "#071522", "#0d2031", "#25a9e8", "#edf6ff", "#91a8ba"), + ("forest", "Bosque", "#101b18", "#1b2b24", "#8cdb81", "#e9f5ed", "#a5c0ad"), + ("violet", "Violeta", "#191622", "#282235", "#bc9cff", "#f0eafa", "#b7abc7"), + ("light", "Claro", "#f2f5f8", "#ffffff", "#477300", "#18212b", "#52616f"), +) +_DEFAULT = {"theme": "graphite", "density": "comfortable", "fontScale": 1.0, "reducedMotion": False} + + +def validate_preferences(values): + if not isinstance(values, dict) or set(values) != set(_DEFAULT): + raise ValueError("preferencias GUI desconocidas o incompletas") + if not isinstance(values["theme"], str) or values["theme"] not in {p[0] for p in _PRESETS}: + raise ValueError("tema GUI desconocido") + if not isinstance(values["density"], str) or values["density"] not in { + "comfortable", + "compact", + }: + raise ValueError("densidad GUI no válida") + scale = values["fontScale"] + if type(scale) not in (float, int) or not math.isfinite(scale) or not 0.9 <= scale <= 1.3: + raise ValueError("escala GUI debe estar entre 0.9 y 1.3") + if type(values["reducedMotion"]) is not bool: + raise ValueError("reducedMotion debe ser booleano") + return {**values, "fontScale": float(scale)} + + +def _payload(values): + preferences = validate_preferences(values) + themes = [] + for identifier, name, background, surface, accent, text, muted in _PRESETS: + tokens = { + **DEFAULT_TOKENS, + "color.background": background, + "color.surface": surface, + "color.surface-raised": "#252d33" if identifier == "graphite" else surface, + "color.accent": accent, + "color.text": text, + "color.text-muted": muted, + "color.border": { + "graphite": "#343e46", + "midnight": "#244157", + "forest": "#344b3c", + "violet": "#4b405d", + "light": "#c7d0d9", + }[identifier], + } + validate_theme_specification({"tokens": tokens}) + themes.append( + { + "id": identifier, + "name": name, + "tokens": {TOKEN_TO_CSS[k]: v for k, v in tokens.items()}, + } + ) + active = next(t for t in themes if t["id"] == preferences["theme"]) + theme = {"id": active["id"], "tokens": dict(active["tokens"]), "components": {}} + plugin_tokens = {} + effective = [] + for extension in active_theme_extensions(): + # The bundled palette is the legacy base, not a user overlay: applying it + # here would turn all five explicit presets back into the same blue theme. + if ( + extension.owner == "lanctl.theme.default" + and extension.extension_id == "lanctl.theme.default.palette" + ): + continue + overrides = validate_theme_specification(extension.specification) + theme["tokens"].update({TOKEN_TO_CSS[k]: v for k, v in overrides["tokens"].items()}) + plugin_tokens.update({TOKEN_TO_CSS[k]: v for k, v in overrides["tokens"].items()}) + for component, tokens in overrides["components"].items(): + theme["components"].setdefault(component, {}).update( + {TOKEN_TO_CSS[k]: v for k, v in tokens.items()} + ) + effective.append(extension.extension_id) + theme["effectivePlugin"] = effective[-1] if effective else None + theme["pluginTokens"] = plugin_tokens + theme["pluginComponents"] = {k: dict(v) for k, v in theme["components"].items()} + return { + "preferences": preferences, + "themes": themes, + "theme": theme, + "effectivePlugin": theme["effectivePlugin"], + } + + +def preferences_payload() -> dict: + stored = load_config().get("guiPreferences", {"schemaVersion": 1, **_DEFAULT}) + if ( + not isinstance(stored, dict) + or type(stored.get("schemaVersion")) is not int + or stored["schemaVersion"] != 1 + ): + raise ValueError("versión de preferencias GUI no compatible") + return _payload({key: value for key, value in stored.items() if key != "schemaVersion"}) + + +def save_preferences(values: dict) -> dict: + cleaned = validate_preferences(values) + + def update(config): + config["guiPreferences"] = {"schemaVersion": 1, **cleaned} + + update_config(update) + return _payload(cleaned) diff --git a/src/lanctl/core/installation.py b/src/lanctl/core/installation.py new file mode 100644 index 0000000..b6e7775 --- /dev/null +++ b/src/lanctl/core/installation.py @@ -0,0 +1,33 @@ +"""Initial installation preferences applied once, without activating optional plugins.""" + +from lanctl.core import config +from lanctl.core.file_transaction import locked_file +from lanctl.core.gui_preferences import validate_preferences +from lanctl.core.paths import application_path +from lanctl.core.plugins.builtin import bootstrap_builtin_plugins +from lanctl.core.plugins.selection import OPTIONAL_PLUGINS, initialize_selection + + +def initialize_defaults(*, theme="graphite", plugins="all"): + preferences = validate_preferences( + {"theme": theme, "density": "comfortable", "fontScale": 1.0, "reducedMotion": False} + ) + selected = ( + list(OPTIONAL_PLUGINS) + if plugins == "all" + else [] + if plugins == "none" + else plugins.split(",") + ) + if not all(item in OPTIONAL_PLUGINS for item in selected): + raise ValueError("selección de plugins opcionales desconocida") + with locked_file(config.CONFIG_PATH): + existing = config.CONFIG_PATH.exists() + settings = config.load_config() + if not existing: + settings["guiPreferences"] = {"schemaVersion": 1, **preferences} + config.save_config(settings) + root = application_path(settings["plugins"]) + actual = initialize_selection(root, selected) + bootstrap_builtin_plugins(root) + return {"preservedConfiguration": existing, "selected": sorted(actual), "activated": False} diff --git a/src/lanctl/core/network_interfaces.py b/src/lanctl/core/network_interfaces.py new file mode 100644 index 0000000..bd66570 --- /dev/null +++ b/src/lanctl/core/network_interfaces.py @@ -0,0 +1,122 @@ +"""Local IPv4 interface inventory. Enumeration never sends discovery probes.""" + +from __future__ import annotations + +import ipaddress +import json +import platform +import subprocess + + +def _read(command): + result = subprocess.run( + command, + capture_output=True, + text=True, + encoding="utf-8", + errors="strict", + check=True, + timeout=10, + creationflags=subprocess.CREATE_NO_WINDOW if platform.system() == "Windows" else 0, + ) + if len(result.stdout) > 1024 * 1024: + raise ValueError("La lista de interfaces supera el límite admitido") + return json.loads(result.stdout or "[]") + + +def ipv4_interfaces() -> list[dict]: + if platform.system() == "Windows": + document = _read( + [ + "powershell.exe", + "-NoProfile", + "-NonInteractive", + "-Command", + ( + "[Console]::OutputEncoding=[System.Text.UTF8Encoding]::new(); " + "@(Get-NetIPConfiguration -All -ErrorAction Stop | " + "Where-Object {$_.NetAdapter.Status -eq 'Up'} | ForEach-Object {" + "$c=$_; $_.IPv4Address | ForEach-Object {" + "[pscustomobject]@{name=$c.InterfaceAlias;index=$c.InterfaceIndex;" + "address=$_.IPAddress;prefix=$_.PrefixLength}}}) | ConvertTo-Json -Compress" + ), + ] + ) + raw = [document] if isinstance(document, dict) else document + elif platform.system() == "Linux": + document = _read(["ip", "-j", "-4", "address", "show", "up"]) + if not isinstance(document, list): + raise ValueError("Inventario de interfaces no válido") + raw = [] + for item in document: + if not isinstance(item, dict) or not isinstance(item.get("addr_info"), list): + raise ValueError("Inventario de interfaces no válido") + for address in item["addr_info"]: + if not isinstance(address, dict): + raise ValueError("Dirección de interfaz no válida") + if address.get("family") == "inet": + raw.append( + { + "name": item.get("ifname"), + "index": item.get("ifindex"), + "address": address.get("local"), + "prefix": address.get("prefixlen"), + } + ) + else: + raise OSError("La selección de interfaz requiere Windows o Linux") + if not isinstance(raw, list): + raise ValueError("Inventario de interfaces no válido") + result = [] + for item in raw: + if not isinstance(item, dict): + raise ValueError("Datos de interfaz no válidos") + name, index, prefix = item.get("name"), item.get("index"), item.get("prefix") + if ( + not isinstance(name, str) + or not name + or len(name) > 256 + or any(not ch.isprintable() for ch in name) + or type(index) is not int + or index < 1 + or type(prefix) is not int + or not 0 <= prefix <= 32 + ): + raise ValueError("Datos de interfaz no válidos") + if not isinstance(item.get("address"), str): + raise ValueError("Dirección de interfaz no válida") + address = ipaddress.IPv4Address(item["address"]) + if address.is_loopback or address.is_multicast or address.is_unspecified: + continue + network = ipaddress.IPv4Network(f"{address}/{prefix}", strict=False) + result.append( + { + "id": f"{index}:{address}", + "name": name, + "index": index, + "address": str(address), + "prefixLength": prefix, + "network": str(network), + } + ) + return sorted(result, key=lambda item: (item["index"], item["address"])) + + +def select_interface(source: str, network=None) -> dict: + # Accept an explicit address or the inventory's stable index/address pair. + if not isinstance(source, str) or len(source) > 80: + raise ValueError("Interfaz de origen no válida") + interfaces = ipv4_interfaces() + matches = [item for item in interfaces if source in (item["id"], item["address"])] + if len(matches) != 1: + raise ValueError("La interfaz ya no está disponible o es ambigua; vuelve a seleccionar") + selected = matches[0] + if sum(item["address"] == selected["address"] for item in interfaces) != 1: + raise ValueError("La dirección de origen está asignada a varias interfaces") + if network is not None: + requested = ipaddress.ip_network(network, strict=False) + if not isinstance(requested, ipaddress.IPv4Network) or not requested.subnet_of( + ipaddress.IPv4Network(selected["network"]) + ): + raise ValueError("El rango confirmado debe pertenecer a la interfaz seleccionada") + return selected diff --git a/src/lanctl/core/official_links.py b/src/lanctl/core/official_links.py new file mode 100644 index 0000000..83a15a8 --- /dev/null +++ b/src/lanctl/core/official_links.py @@ -0,0 +1,22 @@ +"""Canonical public destinations shared by application interfaces.""" + +from __future__ import annotations + +import webbrowser + +_LINKS = { + "web": "https://cctrgy.github.io/lanctl/", + "github": "https://github.com/CctrGy/LANCTL", + "reference": "https://cctrgy.github.io/lanctl/reference/", +} + + +def get_official_links() -> dict[str, str]: + return dict(_LINKS) + + +def open_official_link(key: str) -> dict: + if not isinstance(key, str) or key not in _LINKS: + raise ValueError("enlace oficial desconocido") + url = _LINKS[key] + return {"key": key, "url": url, "opened": bool(webbrowser.open(url, new=2))} diff --git a/src/lanctl/core/plugin_storage.py b/src/lanctl/core/plugin_storage.py index fb21ec4..03f7ae3 100644 --- a/src/lanctl/core/plugin_storage.py +++ b/src/lanctl/core/plugin_storage.py @@ -13,12 +13,14 @@ class PluginStorage: """JSON transportable, transaccional y separado del inventario Device.""" - def __init__(self, root: str | Path, plugin_id: str): + def __init__(self, root: str | Path, plugin_id: str, *, authorize=None): if not _PLUGIN_ID.fullmatch(plugin_id): raise ValueError("id de plugin no válido") self.path = Path(root) / f"{plugin_id}.json" + self._authorize = authorize or (lambda: None) def load(self) -> dict: + self._authorize() if not self.path.exists(): return {"schemaVersion": 1, "observations": {}} value = json.loads(self.path.read_text(encoding="utf-8")) @@ -34,6 +36,7 @@ def put_observation(self, device_id: str, observation: dict) -> None: def put_observations(self, observations: Mapping[str, dict]) -> None: """Guarda un lote con una sola lectura y una sola escritura del JSON.""" + self._authorize() batch: dict[str, dict] = {} for device_id, observation in observations.items(): if not device_id or not isinstance(observation, dict): diff --git a/src/lanctl/core/plugins/api.py b/src/lanctl/core/plugins/api.py index e8dd3c5..b5d9e57 100644 --- a/src/lanctl/core/plugins/api.py +++ b/src/lanctl/core/plugins/api.py @@ -10,11 +10,31 @@ def __init__(self, plugin_id: str, permissions: set[str], manager) -> None: self.plugin_id = plugin_id self.permissions = permissions self._manager = manager + self._authorization = getattr(manager, "_authorization", None) + self._lease = self._authorization.leases.get(plugin_id) if self._authorization else None + + def _check_current(self, permission=None): + if self._authorization is not None: + self._authorization.check(self.plugin_id, self._lease, permission) + + def _guarded(self, handler, permission): + if self._authorization is None: + return handler + return self._authorization.guarded(self.plugin_id, self._lease, handler, permission) def require(self, permission: str) -> None: + self._check_current(permission.casefold()) if permission.casefold() not in self.permissions: raise PermissionError(f"{self.plugin_id} no tiene el permiso {permission}") + @property + def settings(self) -> dict: + """Read only this plugin's validated, non-secret preferences.""" + from lanctl.core.plugins.settings import PluginSettings + + self._check_current() + return PluginSettings(self._manager.get(self.plugin_id)).load() + @property def events(self): return _PluginEvents(self) @@ -57,6 +77,7 @@ def errors(self): return _PluginErrors(self) def log(self, action: str, target: str = "-", result: str = "OK", detail: str = "") -> None: + self._check_current() self._manager.audit(self.plugin_id, action, target, result, detail) @@ -91,6 +112,7 @@ def emit( ): from lanctl.core.errors import errors + self.api._check_current() return errors.emit( level=level, origin=self._origin(origin), @@ -114,6 +136,7 @@ def interpolate(self, exception: Exception, *, code: str, origin: str = "Runtime details.setdefault("upstreamCode", exception.event.code) options["details"] = details exception = RuntimeError(exception.event.message) + self.api._check_current() return errors.from_exception(exception, origin=self._origin(origin), code=code, **options) @@ -124,7 +147,11 @@ def __init__(self, api: PluginApi) -> None: def subscribe(self, event_id, handler, *, version=1, priority=100): self.api.require("events.listen") self.api._manager.events.subscribe( - event_id, handler, plugin_id=self.api.plugin_id, version=version, priority=priority + event_id, + self.api._guarded(handler, "events.listen"), + plugin_id=self.api.plugin_id, + version=version, + priority=priority, ) def emit(self, event_id, values, *, version=1, correlation_id=None): @@ -166,7 +193,10 @@ def register(self, function_id, handler, return_contract): if function_id.casefold().startswith("lanctl."): raise PermissionError("namespace de funciones LANCTL reservado") self.api._manager.functions.register( - function_id, handler, return_contract, owner=self.api.plugin_id + function_id, + self.api._guarded(handler, "functions.register"), + return_contract, + owner=self.api.plugin_id, ) def call(self, function_id, *args, **kwargs): @@ -239,7 +269,11 @@ def open(self): from lanctl.core.config import load_config from lanctl.core.plugin_storage import PluginStorage - return PluginStorage(load_config()["smbStorage"], self.api.plugin_id) + return PluginStorage( + load_config()["smbStorage"], + self.api.plugin_id, + authorize=lambda: self.api.require("plugin.storage"), + ) class _PluginHistory: @@ -299,7 +333,7 @@ def register_check(self, check_id, handler, *, minimum_interval=10, timeout=1, c CheckSpec( check_id, self.api.plugin_id, - handler, + self.api._guarded(handler, "monitor.check.register"), float(minimum_interval), float(timeout), bool(critical), diff --git a/src/lanctl/core/plugins/authorization.py b/src/lanctl/core/plugins/authorization.py new file mode 100644 index 0000000..f57135d --- /dev/null +++ b/src/lanctl/core/plugins/authorization.py @@ -0,0 +1,137 @@ +"""Revocable API leases; legacy trusted code is not an OS security boundary.""" + +from __future__ import annotations + +import threading +import weakref +from functools import wraps + + +class RuntimeAuthorizations: + def __init__(self, manager): + self.manager = weakref.ref(manager) + self.leases = {} + self.restart_required = set() + self.pending = [] + self.cleanups = {} + self.stopped = threading.Event() + self.watcher = None + self.depth = threading.local() + + def begin(self, plugin_id): + previous = self.cleanups.get(plugin_id) + if previous and (previous.ident is None or previous.is_alive()): + raise RuntimeError("La desactivación anterior no terminó; reinicia LANCTL") + self.cleanups.pop(plugin_id, None) + self.leases[plugin_id] = object() + + def check(self, plugin_id, lease, permission=None): + manager = self.manager() + if manager is None: + raise PermissionError("El runtime del plugin ya no está disponible") + # Never use a cached permission set as authority for an operation. + manager.refresh_authorizations() + with manager._lock: + if lease is None or self.leases.get(plugin_id) is not lease: + raise PermissionError( + f"La autorización de {plugin_id} fue revocada; recarga el plugin" + ) + plugin = manager.get(plugin_id) + if permission is not None and permission not in plugin.granted: + raise PermissionError(f"{plugin_id} no tiene el permiso {permission}") + + def guarded(self, plugin_id, lease, handler, permission): + @wraps(handler) + def invoke(*args, **kwargs): + self.check(plugin_id, lease, permission) + result = handler(*args, **kwargs) + # A call already in progress is not reported as authorized success + # if its lease changed while external code was executing. + self.check(plugin_id, lease, permission) + return result + + return invoke + + def retire(self, plugin): + plugin_id = plugin.manifest.plugin_id + self.leases.pop(plugin_id, None) + module, runtime = plugin.module, plugin.isolated_runtime + plugin.module = plugin.isolated_runtime = None + if module is not None: + # Even a successful deactivate() cannot prove that arbitrary + # native threads started by legacy trusted code have stopped. + plugin.restart_required = True + self.restart_required.add(plugin_id) + if module is None and runtime is None: + return + + def cleanup(): + try: + if runtime is not None: + runtime.stop() + deactivate = getattr(module, "deactivate", None) + if callable(deactivate): + deactivate() + except Exception as error: # noqa: BLE001 - external teardown + from lanctl.core.errors import errors + + errors.from_exception( + error, + origin="LANCTL.Plugin.Deactivation", + code="PLUGIN.DEACTIVATION.DEGRADED", + level=14, + details={"pluginId": plugin_id}, + print_output=False, + ) + + # Reserve the cleanup while the manager lock is still held. Another + # thread must not activate a new generation before this one starts. + thread = threading.Thread(target=cleanup, name=f"plugin-close-{plugin_id}", daemon=True) + self.cleanups[plugin_id] = thread + self.pending.append(thread) + + def drain(self): + manager = self.manager() + if manager is None: + return + with manager._lock: + pending, self.pending = self.pending, [] + for thread in pending: + thread.start() + thread.join(0.5) + + def start_watch(self): + if self.watcher and self.watcher.is_alive(): + return + self.stopped.clear() + reference = self.manager + stopped = self.stopped + + def watch(): + while not stopped.wait(0.5): + manager = reference() + if manager is None: + return + try: + manager.refresh_authorizations() + except (OSError, ValueError, RuntimeError) as error: + from lanctl.core.errors import errors + + errors.from_exception( + error, + origin="LANCTL.Plugin.Authorization.Refresh", + code="PLUGIN.AUTHORIZATION.REFRESH_FAILED", + level=43, + print_output=False, + once_key="plugin.authorization.refresh", + ) + finally: + manager = None + + self.watcher = threading.Thread(target=watch, name="plugin-authorizations", daemon=True) + self.watcher.start() + + def stop_watch(self): + self.stopped.set() + if self.watcher and self.watcher is not threading.current_thread(): + self.watcher.join(1) diff --git a/src/lanctl/core/plugins/builtin.py b/src/lanctl/core/plugins/builtin.py index c73ebb6..8fc9f96 100644 --- a/src/lanctl/core/plugins/builtin.py +++ b/src/lanctl/core/plugins/builtin.py @@ -193,17 +193,24 @@ def bootstrap_builtin_plugins(root: Path) -> None: + from lanctl.core.plugins.selection import selected_plugins + + selected = selected_plugins(root) root.mkdir(parents=True, exist_ok=True) readme = root / "readme.md" if not readme.exists() or readme.read_text(encoding="utf-8") != PLUGIN_README: with locked_file(readme): atomic_write_text(readme, PLUGIN_README) - plugin = root / EXAMPLE_PLUGIN_ID - info = plugin / "plugin.info" - api_map = plugin / "api/api.map" - api_map.parent.mkdir(parents=True, exist_ok=True) - atomic_write_json(info, EXAMPLE_MANIFEST) - atomic_write_json(api_map, EXAMPLE_API_MAP) + if EXAMPLE_PLUGIN_ID in selected: + plugin = root / EXAMPLE_PLUGIN_ID + info = plugin / "plugin.info" + api_map = plugin / "api/api.map" + for path, value in ((info, EXAMPLE_MANIFEST), (api_map, EXAMPLE_API_MAP)): + # Installed protected resources need no rewrite on every normal-user start. + if path.exists() and json.loads(path.read_text(encoding="utf-8")) == value: + continue + with locked_file(path): + atomic_write_json(path, value) _install_builtin_theme(root) for package in ( "lanctl.analysis.mac-vendor.lcp", @@ -212,7 +219,8 @@ def bootstrap_builtin_plugins(root: Path) -> None: "lanctl.network.wol.lcp", "lanctl.lab.network-emulator.lcp", ): - _install_builtin_package(root, f"bundled/{package}") + if package.removesuffix(".lcp") in selected: + _install_builtin_package(root, f"bundled/{package}") def _install_builtin_theme(root: Path) -> None: diff --git a/src/lanctl/core/plugins/isolated_runtime.py b/src/lanctl/core/plugins/isolated_runtime.py index 26766c8..c1ba43d 100644 --- a/src/lanctl/core/plugins/isolated_runtime.py +++ b/src/lanctl/core/plugins/isolated_runtime.py @@ -185,10 +185,11 @@ class ExtendedLimits(Structure): class _IsolatedApi: """API mínima transportable para código Python fuera del proceso principal.""" - def __init__(self, connection, plugin_id: str, max_calls: int) -> None: + def __init__(self, connection, plugin_id: str, max_calls: int, settings=None) -> None: self.connection = connection self.plugin_id = plugin_id self.remaining = max_calls + self.settings = dict(settings or {}) def log(self, message: str) -> None: self._call("log", str(message)) @@ -281,7 +282,9 @@ def audit(event: str, arguments: tuple) -> None: sys.addaudithook(audit) -def _worker(connection, plugin_id: str, entry: str, memory_mb: int, max_calls: int) -> None: +def _worker( + connection, plugin_id: str, entry: str, memory_mb: int, max_calls: int, settings=None +) -> None: _apply_memory_limit(memory_mb) module: ModuleType | None = None try: @@ -301,7 +304,7 @@ def _worker(connection, plugin_id: str, entry: str, memory_mb: int, max_calls: i activate = getattr(module, "activate", None) if not callable(activate): raise ValueError("main.exec debe definir activate(api)") - activate(_IsolatedApi(connection, plugin_id, max_calls)) + activate(_IsolatedApi(connection, plugin_id, max_calls, settings)) _send_message(connection, ("READY", os.getpid())) while True: try: @@ -336,6 +339,7 @@ def __init__( memory_mb: int = 128, max_calls: int = 1000, audit=None, + settings=None, ) -> None: self.plugin_id = plugin_id self.entry = entry @@ -343,6 +347,7 @@ def __init__( self.memory_mb = max(16, int(memory_mb)) self.max_calls = max(1, int(max_calls)) self.audit = audit or (lambda *_args: None) + self.settings = dict(settings or {}) self.process = None self._connection = None self._reader = None @@ -446,7 +451,14 @@ def start(self) -> IsolatedPluginRuntime: parent, child = context.Pipe() process = context.Process( target=_worker, - args=(child, self.plugin_id, str(self.entry), self.memory_mb, self.max_calls), + args=( + child, + self.plugin_id, + str(self.entry), + self.memory_mb, + self.max_calls, + self.settings, + ), name=f"LANCTL plugin {self.plugin_id}", daemon=True, ) diff --git a/src/lanctl/core/plugins/manager.py b/src/lanctl/core/plugins/manager.py index 7c202bb..0bee6e7 100644 --- a/src/lanctl/core/plugins/manager.py +++ b/src/lanctl/core/plugins/manager.py @@ -3,11 +3,14 @@ import importlib.machinery import importlib.util import json +import re import shutil import sys from contextlib import suppress +from copy import deepcopy from dataclasses import dataclass, field, make_dataclass from datetime import datetime +from functools import wraps from pathlib import Path from threading import RLock @@ -17,6 +20,7 @@ from lanctl.core.logger import write_database_log, write_log from lanctl.core.paths import application_path from lanctl.core.plugins.api import PluginApi +from lanctl.core.plugins.authorization import RuntimeAuthorizations from lanctl.core.plugins.builtin import BUILTIN_PLUGIN_IDS, bootstrap_builtin_plugins from lanctl.core.plugins.contracts import ( DeviceRemoteEvent, @@ -31,9 +35,9 @@ from lanctl.core.plugins.functions import FunctionRegistry from lanctl.core.plugins.models import PluginManifest, PluginState from lanctl.core.plugins.package import ( - directory_hash, inspect_package, install_package, + verify_directory, verify_package, ) from lanctl.core.plugins.publishers import TrustedPublisherStore @@ -43,6 +47,24 @@ PLUGIN_REGISTRY = application_path("data/lc/plugins.registry") +def _synchronized(method): + @wraps(method) + def wrapped(self, *args, **kwargs): + depth = self._authorization.depth + depth.value = getattr(depth, "value", 0) + 1 + try: + with self._lock, locked_file(self.registry_path): + return method(self, *args, **kwargs) + finally: + depth.value -= 1 + if not depth.value: + # External deactivate/stop runs only after all registry locks + # in this thread have been released. + self._authorization.drain() + + return wrapped + + @dataclass(slots=True) class InstalledPlugin: manifest: PluginManifest @@ -55,6 +77,7 @@ class InstalledPlugin: checksum: str = "" module: object | None = None isolated_runtime: object | None = None + restart_required: bool = False def __post_init__(self): self.granted = set(self.granted or ()) @@ -70,7 +93,11 @@ def __init__(self, root: Path = PLUGIN_ROOT, registry_path: Path = PLUGIN_REGIST self.functions = FunctionRegistry(self.audit) self.plugins: dict[str, InstalledPlugin] = {} self.initialized = False + self._active: set[str] = set() + self._registry_known: dict = {} + self._registry_baseline: dict = {} self._lock = RLock() + self._authorization = RuntimeAuthorizations(self) self._register_core_events() bootstrap_builtin_plugins(self.root) self.discover() @@ -102,29 +129,49 @@ def _register_core_events(self) -> None: for event_id, contract, cancelable in definitions: self.event_registry.register(event_id, contract, owner="LANCTL", cancelable=cancelable) + @_synchronized def discover(self) -> list[InstalledPlugin]: persisted = self._read_registry() + for plugin in self.plugins.values(): + self._release_runtime(plugin) + self.initialized = False self.root.mkdir(parents=True, exist_ok=True) discovered: dict[str, InstalledPlugin] = {} - for info in self.root.glob("*/plugin.info"): + infos = [ + *self.root.glob("*/plugin.info"), + *sorted((self.root / ".quarantine").glob("*/plugin.info"), reverse=True), + ] + for info in infos: try: manifest = PluginManifest.from_dict(json.loads(info.read_text(encoding="utf-8"))) + quarantined = info.parent.parent == self.root / ".quarantine" saved = persisted.get(manifest.plugin_id, {}) + if quarantined and ( + manifest.plugin_id in discovered or saved.get("state") != "QUARANTINED" + ): + continue + if not quarantined and info.parent.name != manifest.plugin_id: + raise ValueError("el directorio no coincide con el id del plugin") is_builtin = manifest.plugin_id in BUILTIN_PLUGIN_IDS # La procedencia integrada pertenece al núcleo, nunca al manifiesto # controlado por el complemento. manifest.raw["builtIn"] = is_builtin default_enabled = bool(is_builtin and manifest.raw.get("defaultEnabled")) - actual_checksum = directory_hash(info.parent, {"meta/checksum", "meta/signature"}) - checksum_file = info.parent / "meta/checksum" - declared_checksum = ( - checksum_file.read_text(encoding="ascii").strip().split()[-1].casefold() - if checksum_file.is_file() - else actual_checksum - ) - expected_checksum = str(saved.get("checksum") or declared_checksum).casefold() - if actual_checksum != declared_checksum or actual_checksum != expected_checksum: - quarantine = self._quarantine_path(manifest.plugin_id) + expected_checksum = str(saved.get("checksum", "")).casefold() + try: + if quarantined: + raise ValueError( + "el plugin sigue en cuarentena; reinstala un LCP verificado" + ) + verified = verify_directory( + info.parent, + expected_checksum=expected_checksum, + expected_signature=saved.get("signature"), + ) + except (OSError, ValueError) as error: + quarantine = ( + info.parent if quarantined else self._quarantine_path(manifest.plugin_id) + ) try: info.parent.replace(quarantine) plugin_path = quarantine @@ -136,7 +183,7 @@ def discover(self) -> list[InstalledPlugin]: PluginState.QUARANTINED, set(), False, - "integridad del plugin modificada", + f"integridad del plugin modificada: {error}", str(saved.get("signature", "UNSIGNED")), expected_checksum, ) @@ -145,7 +192,7 @@ def discover(self) -> list[InstalledPlugin]: "INTEGRITY", str(info.parent), "QUARANTINED", - f"expected={expected_checksum} actual={actual_checksum}", + str(error), ) continue state = PluginState( @@ -159,8 +206,8 @@ def discover(self) -> list[InstalledPlugin]: granted, bool(saved.get("trusted", False)), str(saved.get("error", "")), - str(saved.get("signature", "UNSIGNED")), - expected_checksum, + verified["signature"], + verified["checksum"], ) except Exception as error: # noqa: BLE001 - manifiesto externo from lanctl.core.errors import errors @@ -175,8 +222,16 @@ def discover(self) -> list[InstalledPlugin]: ) self.audit(info.parent.name, "DISCOVER", str(info), "ERROR", str(error)) self.plugins = discovered + self._registry_known = deepcopy(persisted) + self._registry_baseline = self._registry_entries() + for plugin_id, plugin in self.plugins.items(): + if plugin.state == PluginState.QUARANTINED: + self._registry_baseline[plugin_id] = deepcopy(persisted.get(plugin_id, {})) + if any(p.state == PluginState.QUARANTINED for p in self.plugins.values()): + self._save_registry() return self.list() + @_synchronized def activate_enabled(self) -> bool: if self.initialized: from lanctl.core.errors import errors @@ -190,10 +245,26 @@ def activate_enabled(self) -> bool: once_key="plugins.activation.already-initialized", ) return False - for plugin in self.list(): - if plugin.state == PluginState.ENABLED: + if self._read_registry() != self._registry_known: + self.discover() + pending = {p.manifest.plugin_id: p for p in self.list() if p.state == PluginState.ENABLED} + while pending: + ready = [ + p + for p in pending.values() + if not any(d.plugin_id in pending for d in p.manifest.dependencies) + ] + if not ready: + # A dependency cycle cannot be activated in any order. + ready = list(pending.values()) + for plugin in ready: + pending.pop(plugin.manifest.plugin_id) try: - self._activate(plugin) + self._validate_activation(plugin) + if plugin.manifest.plugin_id not in self._active: + self._activate(plugin) + self._active.add(plugin.manifest.plugin_id) + plugin.error = "" except Exception as error: # noqa: BLE001 - código de plugin from lanctl.core.errors import errors @@ -205,17 +276,10 @@ def activate_enabled(self) -> bool: details={"pluginId": plugin.manifest.plugin_id}, print_output=False, ) - self.events.unsubscribe_plugin(plugin.manifest.plugin_id) - self.event_registry.remove_owner(plugin.manifest.plugin_id) - self.extensions.remove_owner(plugin.manifest.plugin_id) - self.functions.remove_owner(plugin.manifest.plugin_id) - from lanctl.shared.i18n import get_language_manager - - get_language_manager().remove_provider(plugin.manifest.plugin_id) - from lanctl.shared.assets.icons import get_icon_manager - - get_icon_manager().remove_provider(plugin.manifest.plugin_id) - plugin.state, plugin.error = PluginState.ERROR, str(error) + self._release_runtime(plugin) + if plugin.state not in (PluginState.INCOMPATIBLE, PluginState.QUARANTINED): + plugin.state = PluginState.ERROR + plugin.error = str(error) self.audit( plugin.manifest.plugin_id, "LOAD", @@ -223,19 +287,39 @@ def activate_enabled(self) -> bool: "ERROR", str(error), ) - self._save_registry() + try: + self._save_registry() + except OSError as error: + for plugin in self.plugins.values(): + if plugin.manifest.plugin_id in self._active: + self._release_runtime(plugin) + plugin.state, plugin.error = PluginState.ERROR, str(error) + raise self.initialized = True return True + @_synchronized def install(self, package: str | Path) -> InstalledPlugin: incoming = inspect_package(package) + if self._read_registry().get(incoming.plugin_id) != self._registry_known.get( + incoming.plugin_id + ): + raise ValueError( + f"el estado de {incoming.plugin_id} cambió en otro proceso; recarga los plugins" + ) existing = self.plugins.get(incoming.plugin_id) + if existing: + self._ensure_current(existing) if incoming.plugin_id in BUILTIN_PLUGIN_IDS or ( existing and existing.manifest.plugin_id in BUILTIN_PLUGIN_IDS ): raise PermissionError( "un complemento integrado no se puede reemplazar con plugin install" ) + # Verify first so a rejected replacement does not interrupt a valid runtime. + verify_package(package) + if existing: + self.disable(existing.manifest.plugin_id) manifest, destination, result = install_package(package, self.root) plugin = InstalledPlugin( manifest, @@ -250,6 +334,7 @@ def install(self, package: str | Path) -> InstalledPlugin: ) return plugin + @_synchronized def uninstall(self, plugin_id: str) -> None: plugin = self.get(plugin_id) if plugin.manifest.plugin_id in BUILTIN_PLUGIN_IDS: @@ -262,79 +347,46 @@ def uninstall(self, plugin_id: str) -> None: self._save_registry() self.audit(plugin.manifest.plugin_id, "UNINSTALL", plugin.manifest.version, "OK") + @_synchronized def enable( self, plugin_id: str, *, grant: set[str] | None = None, trusted: bool = False ) -> InstalledPlugin: plugin = self.get(plugin_id) + self._ensure_current(plugin) + previous_grants = set(plugin.granted) if grant is not None: plugin.granted = {item.casefold() for item in grant} - requested = set(plugin.manifest.permissions) - missing = requested - plugin.granted - if missing: - plugin.state = PluginState.BLOCKED - plugin.error = f"permisos sin conceder: {', '.join(sorted(missing))}" - self._save_registry() - raise PermissionError(plugin.error) - if trusted and not self.publishers.is_trusted(plugin.signature): - raise PermissionError( - "el runtime trusted requiere un LCP firmado por un editor confiable; " - "usa plugin publisher trust" - ) plugin.trusted = plugin.trusted or trusted - self._check_compatibility(plugin) - self._check_dependencies(plugin) - plugin.error = "" try: + self._validate_activation(plugin) + if plugin.manifest.plugin_id in self._active and previous_grants == plugin.granted: + return plugin + self._release_runtime(plugin) self._activate(plugin) - except Exception as error: - self.events.unsubscribe_plugin(plugin.manifest.plugin_id) - self.event_registry.remove_owner(plugin.manifest.plugin_id) - self.extensions.remove_owner(plugin.manifest.plugin_id) - self.functions.remove_owner(plugin.manifest.plugin_id) - from lanctl.shared.i18n import get_language_manager - - get_language_manager().remove_provider(plugin.manifest.plugin_id) - from lanctl.shared.assets.icons import get_icon_manager - - get_icon_manager().remove_provider(plugin.manifest.plugin_id) - plugin.module = None - plugin.state, plugin.error = PluginState.BLOCKED, str(error) + self._active.add(plugin.manifest.plugin_id) + plugin.state = PluginState.ENABLED + plugin.error = "" self._save_registry() + except Exception as error: + self._release_runtime(plugin) + if plugin.state not in (PluginState.INCOMPATIBLE, PluginState.QUARANTINED): + plugin.state = PluginState.BLOCKED + plugin.error = str(error) + # A failed atomic write must not leave executable code active. Keep + # the original exception if persisting the failure also hits the disk error. + with suppress(OSError): + self._save_registry() self.audit( plugin.manifest.plugin_id, "ENABLE", plugin.manifest.version, "ERROR", str(error) ) raise - plugin.state = PluginState.ENABLED - self._save_registry() self.audit(plugin.manifest.plugin_id, "ENABLE", plugin.manifest.version, "OK") return plugin - def disable(self, plugin_id: str) -> InstalledPlugin: - plugin = self.get(plugin_id) - if plugin.isolated_runtime is not None: - plugin.isolated_runtime.stop() - plugin.isolated_runtime = None - if plugin.module and hasattr(plugin.module, "deactivate"): - try: - plugin.module.deactivate() - except Exception as error: # noqa: BLE001 - código de plugin - from lanctl.core.errors import errors - - errors.from_exception( - error, - origin="LANCTL.Plugin.Deactivation", - code="PLUGIN.DEACTIVATION.DEGRADED", - level=14, - details={"pluginId": plugin.manifest.plugin_id}, - print_output=False, - ) - self.audit( - plugin.manifest.plugin_id, - "UNLOAD", - plugin.manifest.version, - "ERROR", - str(error), - ) + def _release_runtime(self, plugin: InstalledPlugin) -> None: + self._active.discard(plugin.manifest.plugin_id) + module = plugin.module + self._authorization.retire(plugin) self.events.unsubscribe_plugin(plugin.manifest.plugin_id) self.event_registry.remove_owner(plugin.manifest.plugin_id) self.extensions.remove_owner(plugin.manifest.plugin_id) @@ -345,21 +397,42 @@ def disable(self, plugin_id: str) -> InstalledPlugin: from lanctl.shared.assets.icons import get_icon_manager get_icon_manager().remove_provider(plugin.manifest.plugin_id) - plugin.module, plugin.state = None, PluginState.DISABLED + checks = getattr(self, "monitor_checks", None) + if checks is not None: + checks.remove_owner(plugin.manifest.plugin_id) + if module is not None and sys.modules.get(module.__name__) is module: + sys.modules.pop(module.__name__, None) + + @_synchronized + def disable(self, plugin_id: str) -> InstalledPlugin: + plugin = self.get(plugin_id) + self._ensure_current(plugin) + self._release_runtime(plugin) + if plugin.state != PluginState.QUARANTINED: + plugin.state = PluginState.DISABLED + plugin.error = "" + for dependent in list(self.plugins.values()): + if dependent.manifest.plugin_id in self._active and any( + d.plugin_id == plugin.manifest.plugin_id for d in dependent.manifest.dependencies + ): + self.disable(dependent.manifest.plugin_id) self._save_registry() self.audit(plugin.manifest.plugin_id, "DISABLE", plugin.manifest.version, "OK") return plugin def reload(self, plugin_id: str) -> InstalledPlugin: - plugin = self.get(plugin_id) - granted, trusted = set(plugin.granted), plugin.trusted + with self._lock: + plugin = self.get(plugin_id) + granted, trusted = set(plugin.granted), plugin.trusted self.disable(plugin_id) return self.enable(plugin_id, grant=granted, trusted=trusted) + @_synchronized def revoke(self, plugin_id: str, permissions: set[str] | None = None) -> InstalledPlugin: """Revoca permisos y desactiva el plugin si deja de cumplir su manifiesto.""" plugin = self.get(plugin_id) + self._ensure_current(plugin) revoked = ( set(plugin.granted) if permissions is None @@ -384,13 +457,15 @@ def revoke(self, plugin_id: str, permissions: set[str] | None = None) -> Install ) return plugin + @_synchronized def verify(self, plugin_id_or_file: str) -> dict: path = Path(plugin_id_or_file) if path.suffix.casefold() == ".lcp" or path.exists(): return verify_package(path) plugin = self.get(plugin_id_or_file) + verified = self._verify_installed(plugin) return { - "valid": True, + **verified, "installed": True, "manifest": plugin.manifest, "path": str(plugin.path), @@ -406,6 +481,107 @@ def get(self, plugin_id: str) -> InstalledPlugin: def list(self) -> list[InstalledPlugin]: return sorted(self.plugins.values(), key=lambda item: item.manifest.name.casefold()) + @_synchronized + def refresh_authorizations(self) -> None: + """Reconcile revocation without automatically granting or loading code.""" + try: + current = self._read_registry() + publishers = self.publishers._read() + except (OSError, ValueError): + for plugin in tuple(self.plugins.values()): + if plugin.manifest.plugin_id in self._authorization.leases: + self._release_runtime(plugin) + plugin.state = PluginState.BLOCKED + plugin.error = ( + "Autorización no verificable; se han retirado los accesos al Core" + ) + # Do not write a corrupt or unavailable authority back to disk. + self._registry_baseline = self._registry_entries() + raise + observed = set() + for plugin_id, plugin in tuple(self.plugins.items()): + saved = current.get(plugin_id) + changed = saved != self._registry_known.get(plugin_id) + untrusted = ( + plugin.manifest.runtime == "trusted" + and plugin_id in self._authorization.leases + and plugin.signature.removeprefix("VALID_ED25519:").casefold() not in publishers + ) + runtime = plugin.isolated_runtime + terminated = ( + plugin_id in self._active + and runtime is not None + and (runtime.process is None or not runtime.process.is_alive()) + ) + if not changed and not untrusted and not terminated: + continue + self._release_runtime(plugin) + if saved is not None: + plugin.granted = set(saved.get("granted", ())) + plugin.trusted = bool(saved.get("trusted", False)) + state = PluginState(saved.get("state", "DISABLED")) + else: + plugin.granted = set() + plugin.trusted = False + state = PluginState.DISABLED + plugin.state = PluginState.BLOCKED if state == PluginState.ENABLED else state + plugin.error = ( + "Editor revocado; accesos al Core retirados" + if untrusted + else "Autorización modificada en otro proceso; recarga antes de activar" + ) + if terminated: + plugin.state = PluginState.ERROR + plugin.error = "El proceso aislado terminó; se han retirado los accesos al Core" + observed.add(plugin_id) + # Revocation cascades through every level of active dependencies. + while True: + dependents = [ + p + for p in self.plugins.values() + if p.manifest.plugin_id in self._active + and any(d.plugin_id not in self._active for d in p.manifest.dependencies) + ] + if not dependents: + break + for plugin in dependents: + self._release_runtime(plugin) + plugin.state = PluginState.BLOCKED + plugin.error = "Dependencia revocada o desactivada; recarga antes de activar" + observed.add(plugin.manifest.plugin_id) + if observed: + entries = self._registry_entries() + for plugin_id in observed: + if plugin_id in current: + self._registry_known[plugin_id] = deepcopy(current[plugin_id]) + else: + self._registry_known.pop(plugin_id, None) + self._registry_baseline[plugin_id] = deepcopy(entries[plugin_id]) + + def runtime_status(self, plugin_id: str) -> dict: + self.refresh_authorizations() + with self._lock: + plugin = self.get(plugin_id) + closing = self._authorization.cleanups.get(plugin.manifest.plugin_id) + return { + "schemaVersion": 1, + "active": plugin.manifest.plugin_id in self._active, + "coreAccess": plugin.manifest.plugin_id in self._authorization.leases, + "restartRequired": plugin.restart_required + or plugin.manifest.plugin_id in self._authorization.restart_required, + "cleanupPending": bool(closing and (closing.ident is None or closing.is_alive())), + "execution": "legacy-in-process" + if plugin.manifest.runtime == "trusted" + else "isolated", + } + + @_synchronized + def close(self) -> None: + self._authorization.stopped.set() + for plugin in tuple(self.plugins.values()): + self._release_runtime(plugin) + self.initialized = False + def _quarantine_path(self, plugin_id: str) -> Path: root = self.root / ".quarantine" root.mkdir(parents=True, exist_ok=True) @@ -439,6 +615,7 @@ def project_registry(self) -> dict: } def _activate(self, plugin: InstalledPlugin) -> None: + self._authorization.begin(plugin.manifest.plugin_id) self._load_declarative_events(plugin) self._load_declarative_extensions(plugin) entry = plugin.path / plugin.manifest.entry_point @@ -446,6 +623,7 @@ def _activate(self, plugin: InstalledPlugin) -> None: return if plugin.manifest.runtime == "isolated": from lanctl.core.plugins.isolated_runtime import IsolatedPluginRuntime + from lanctl.core.plugins.settings import PluginSettings limits = plugin.manifest.raw.get("limits", {}) plugin.isolated_runtime = IsolatedPluginRuntime( @@ -455,6 +633,7 @@ def _activate(self, plugin: InstalledPlugin) -> None: memory_mb=int(limits.get("memoryMb", 128)), max_calls=int(limits.get("maxCalls", 1000)), audit=self.audit, + settings=PluginSettings(plugin).load(), ).start() self.audit( plugin.manifest.plugin_id, @@ -478,6 +657,7 @@ def _activate(self, plugin: InstalledPlugin) -> None: if not spec: raise ImportError(f"no se puede cargar {entry}") module = importlib.util.module_from_spec(spec) + plugin.module = module sys.modules[module_name] = module previous_bytecode_policy = sys.dont_write_bytecode sys.dont_write_bytecode = True @@ -507,7 +687,12 @@ def _load_declared_hooks(self, plugin: InstalledPlugin, module) -> None: raise ValueError(f"hook {path.name}: handler inexistente {handler_name}") self.events.subscribe( str(document["event"]), - handler, + self._authorization.guarded( + plugin.manifest.plugin_id, + self._authorization.leases[plugin.manifest.plugin_id], + handler, + "events.listen", + ), plugin_id=plugin.manifest.plugin_id, version=int(document.get("version", 1)), priority=int(document.get("priority", 100)), @@ -636,15 +821,65 @@ def _load_declarative_events(self, plugin: InstalledPlugin) -> None: cancelable=bool(spec.get("cancelable", False)), ) + def _verify_installed(self, plugin: InstalledPlugin) -> dict: + if plugin.state == PluginState.QUARANTINED: + raise ValueError("integridad del plugin no válida; reinstala un LCP verificado") + try: + result = verify_directory( + plugin.path, + expected_checksum=plugin.checksum, + expected_signature=plugin.signature, + ) + if result["manifest"].plugin_id != plugin.manifest.plugin_id: + raise ValueError("integridad del plugin modificada: id distinto") + return result + except (OSError, ValueError): + self._release_runtime(plugin) + plugin.state = PluginState.QUARANTINED + plugin.error = "integridad del plugin modificada; reinstala un LCP verificado" + self._save_registry() + raise + + def _validate_activation(self, plugin: InstalledPlugin) -> None: + self._verify_installed(plugin) + requested = set(plugin.manifest.permissions) + missing = requested - plugin.granted + if missing: + raise PermissionError(f"permisos sin conceder: {', '.join(sorted(missing))}") + extra = plugin.granted - requested + if extra: + raise PermissionError(f"permisos no solicitados: {', '.join(sorted(extra))}") + self._check_compatibility(plugin) + self._check_dependencies(plugin) + if plugin.manifest.runtime == "trusted": + if not plugin.signature.startswith("VALID_ED25519:"): + raise PermissionError( + "el runtime trusted requiere un LCP firmado por un editor confiable; " + "el paquete instalado no tiene firma; instala el LCP firmado por su editor" + ) + if not self.publishers.is_trusted(plugin.signature): + raise PermissionError( + "el runtime trusted requiere un editor confiable; la firma es válida " + "pero su editor no está autorizado o fue revocado; usa plugin publisher trust" + ) + if not plugin.trusted: + raise PermissionError("el código in-process requiere confianza explícita (--trust)") + def _check_dependencies(self, plugin: InstalledPlugin) -> None: missing = [ dep.plugin_id for dep in plugin.manifest.dependencies if dep.plugin_id not in self.plugins or self.plugins[dep.plugin_id].state != PluginState.ENABLED + or dep.plugin_id not in self._active ] if missing: raise ValueError(f"dependencias no activas: {', '.join(missing)}") + for dep in plugin.manifest.dependencies: + if not _matches_dependency(self.plugins[dep.plugin_id].manifest.version, dep.version): + raise ValueError( + f"dependencia incompatible: {dep.plugin_id} requiere {dep.version}" + ) def _check_compatibility(self, plugin: InstalledPlugin) -> None: # Se comparan los componentes numéricos de la versión; las versiones @@ -662,9 +897,35 @@ def _read_registry(self) -> dict: if not self.registry_path.exists(): return {} try: - data = json.loads(self.registry_path.read_text(encoding="utf-8")) - return data.get("plugins", {}) - except (json.JSONDecodeError, OSError) as error: + with locked_file(self.registry_path): + data = json.loads(self.registry_path.read_text(encoding="utf-8")) + # Legacy initialization wrote exactly an empty object, without a schema. + # Migrate only that format; never recover authorization from invalid data. + if data == {}: + data = {"schemaVersion": 1, "plugins": {}} + atomic_write_json(self.registry_path, data) + if not isinstance(data, dict) or data.get("schemaVersion") != 1: + raise ValueError("schema de registro no compatible") + values = data.get("plugins") + if not isinstance(values, dict): + raise ValueError("plugins debe ser un objeto") + for key, entry in values.items(): + if not isinstance(entry, dict): + raise ValueError(f"entrada no válida: {key}") + PluginState(entry.get("state", "DISABLED")) + granted = entry.get("granted", []) + if ( + not isinstance(granted, list) + or not all(isinstance(p, str) for p in granted) + or not isinstance(entry.get("trusted", False), bool) + or any( + not isinstance(entry.get(k, ""), str) + for k in ("checksum", "signature", "error", "version") + ) + ): + raise ValueError(f"autorización no válida: {key}") + return values + except (ValueError, OSError) as error: from lanctl.core.errors import errors errors.from_exception( @@ -675,27 +936,64 @@ def _read_registry(self) -> dict: details={"path": str(self.registry_path)}, print_output=False, ) - return {} + raise ValueError(f"registro de plugins no válido: {self.registry_path}") from error + + def _registry_entries(self) -> dict: + return { + p.manifest.plugin_id: { + "state": p.state.value, + "granted": sorted(p.granted), + "trusted": p.trusted, + "error": p.error, + "signature": p.signature, + "checksum": p.checksum, + "version": p.manifest.version, + } + for p in self.plugins.values() + } + + def _ensure_current(self, plugin: InstalledPlugin) -> None: + plugin_id = plugin.manifest.plugin_id + if self._read_registry().get(plugin_id) != self._registry_known.get(plugin_id): + self._release_runtime(plugin) + plugin.state = PluginState.BLOCKED + plugin.error = ( + f"el estado de {plugin_id} cambió en otro proceso; vuelve a cargar los plugins" + ) + # This local refusal must not overwrite the newer persisted authorization. + self._registry_baseline[plugin_id] = self._registry_entries()[plugin_id] + raise ValueError(plugin.error) def _save_registry(self) -> None: self.registry_path.parent.mkdir(parents=True, exist_ok=True) - data = { - "schemaVersion": 1, - "plugins": { - p.manifest.plugin_id: { - "state": p.state.value, - "granted": sorted(p.granted), - "trusted": p.trusted, - "error": p.error, - "signature": p.signature, - "checksum": p.checksum, - "version": p.manifest.version, - } - for p in self.list() - }, - } with locked_file(self.registry_path): - atomic_write_json(self.registry_path, data) + current = self._read_registry() + entries = self._registry_entries() + changed = { + key for key, value in entries.items() if self._registry_baseline.get(key) != value + } + removed = self._registry_baseline.keys() - entries.keys() + for key in changed | removed: + if current.get(key) not in (self._registry_known.get(key), entries.get(key)): + raise ValueError( + f"el registro de {key} cambió en otro proceso; recarga los plugins" + ) + for key in removed: + current.pop(key, None) + for key, entry in entries.items(): + if key in changed or (key not in current and key not in self._registry_known): + current[key] = entry + atomic_write_json(self.registry_path, {"schemaVersion": 1, "plugins": current}) + # Keep the observed revision only for entries this manager actually owns. + # Unchanged local objects may still be stale compared with another process. + for key in changed: + self._registry_known[key] = deepcopy(entries[key]) + for key in removed: + self._registry_known.pop(key, None) + for key in entries: + if key not in self._registry_known and entries[key] == current.get(key): + self._registry_known[key] = deepcopy(entries[key]) + self._registry_baseline = deepcopy(entries) def _version_tuple(value: str) -> tuple[int, int, int]: @@ -715,6 +1013,39 @@ def _matches_maximum(current: tuple[int, int, int], maximum: str) -> bool: return current <= _version_tuple(maximum) +def _matches_dependency(version: str, requirement: str) -> bool: + if requirement.strip() in ("", "*"): + return True + current = _version_tuple(version) + for part in requirement.split(","): + match = re.fullmatch( + r"\s*(>=|<=|==|!=|>|<|=)?\s*(\d+(?:\.\d+){0,2}|\d+(?:\.\d+)?\.[x*])\s*", part + ) + if not match: + raise ValueError(f"versión de dependencia no válida: {requirement}") + operator, expected = match.groups() + if expected.endswith((".x", ".*")): + if operator not in (None, "=", "==", "!="): + raise ValueError(f"rango de dependencia no válido: {requirement}") + matched = _matches_maximum(current, expected[:-1] + "x") + if matched == (operator == "!="): + return False + else: + target = _version_tuple(expected) + if not { + None: current == target, + "=": current == target, + "==": current == target, + "!=": current != target, + ">=": current >= target, + "<=": current <= target, + ">": current > target, + "<": current < target, + }[operator]: + return False + return True + + def _schema_type(value: str): return { "string": str, @@ -728,10 +1059,21 @@ def _schema_type(value: str): _MANAGER: PluginManager | None = None +_MANAGER_LOCK = RLock() + + +def active_theme_extensions(): + """Read initialized themes without bootstrapping or enabling plugin code.""" + if _MANAGER is None: + return [] + _MANAGER.refresh_authorizations() + return _MANAGER.extensions.list("theme") def get_plugin_manager() -> PluginManager: global _MANAGER - if _MANAGER is None: - _MANAGER = PluginManager() - return _MANAGER + with _MANAGER_LOCK: + if _MANAGER is None: + _MANAGER = PluginManager() + _MANAGER._authorization.start_watch() + return _MANAGER diff --git a/src/lanctl/core/plugins/package.py b/src/lanctl/core/plugins/package.py index 331f1fc..9170f3a 100644 --- a/src/lanctl/core/plugins/package.py +++ b/src/lanctl/core/plugins/package.py @@ -3,6 +3,7 @@ import base64 import hashlib import json +import re import shutil import tempfile import zipfile @@ -68,8 +69,9 @@ def install_package(path: str | Path, destination_root: Path) -> tuple[PluginMan target.parent.mkdir(parents=True, exist_ok=True) with archive.open(item) as source, target.open("wb") as output: shutil.copyfileobj(source, output) - if directory_hash(staging, {"meta/checksum", "meta/signature"}) != result["checksum"]: - raise ValueError("el paquete LCP cambió durante la instalación") + verify_directory( + staging, expected_checksum=result["checksum"], expected_signature=result["signature"] + ) old = destination.with_name(destination.name + ".old") if old.exists() and not destination.exists(): old.replace(destination) @@ -168,14 +170,20 @@ def archive_hash(archive: zipfile.ZipFile, excluded: set[str]) -> str: def _verify_signature(archive: zipfile.ZipFile, checksum: str, names: set[str]) -> str: if "meta/public-key.pem" not in names: raise ValueError("el LCP contiene firma pero no meta/public-key.pem") + return _verify_signature_bytes( + archive.read("meta/signature"), archive.read("meta/public-key.pem"), checksum + ) + + +def _verify_signature_bytes(signature: bytes, key: bytes, checksum: str) -> str: try: from cryptography.hazmat.primitives import serialization from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PublicKey - document = json.loads(archive.read("meta/signature").decode("utf-8")) + document = json.loads(signature.decode("utf-8")) if str(document.get("algorithm", "")).casefold() != "ed25519": raise ValueError("algoritmo de firma LCP no soportado") - public_key = serialization.load_pem_public_key(archive.read("meta/public-key.pem")) + public_key = serialization.load_pem_public_key(key) if not isinstance(public_key, Ed25519PublicKey): raise ValueError("la clave de firma LCP no es Ed25519") public_key.verify( @@ -191,9 +199,49 @@ def _verify_signature(archive: zipfile.ZipFile, checksum: str, names: set[str]) raise ValueError(f"firma LCP no válida: {error}") from error +def verify_directory( + root: Path, *, expected_checksum: str = "", expected_signature: str | None = None +) -> dict: + """Verify installed bytes, never treating registry signature text as proof.""" + checksum = directory_hash(root, {"meta/checksum", "meta/signature"}) + checksum_path = root / "meta/checksum" + if checksum_path.exists(): + declared = checksum_path.read_text(encoding="ascii").strip().casefold() + # Preserve the historic ' ' checksum representation. + parts = declared.split() + declared = parts[-1] if parts else "" + if not re.fullmatch(r"[0-9a-f]{64}", declared) or declared != checksum: + raise ValueError("integridad del plugin modificada: checksum no coincide") + if expected_checksum and checksum != expected_checksum.casefold(): + raise ValueError("integridad del plugin modificada: checksum instalado no coincide") + manifest = PluginManifest.from_dict(json.loads((root / "plugin.info").read_text("utf-8"))) + signature = "UNSIGNED" + signature_path = root / "meta/signature" + if signature_path.exists(): + key_path = root / "meta/public-key.pem" + if not key_path.is_file(): + raise ValueError("el LCP contiene firma pero no meta/public-key.pem") + signature = _verify_signature_bytes( + signature_path.read_bytes(), key_path.read_bytes(), checksum + ) + if expected_signature is not None and signature != expected_signature: + raise ValueError("integridad del plugin modificada: firma instalada no coincide") + return {"valid": True, "manifest": manifest, "checksum": checksum, "signature": signature} + + def directory_hash(root: Path, excluded: set[str]) -> str: digest = hashlib.sha256() - files = (item for item in root.rglob("*") if item.is_file()) + files = [] + total = 0 + for item in root.rglob("*"): + if item.is_symlink() or not item.resolve().is_relative_to(root.resolve()): + raise ValueError("ruta enlazada no segura dentro del plugin") + if item.is_file(): + size = item.stat().st_size + total += size + if size > MAX_ENTRY_SIZE or total > MAX_TOTAL_SIZE: + raise ValueError("contenido del plugin demasiado grande") + files.append(item) for path in sorted(files, key=lambda item: item.relative_to(root).as_posix()): name = path.relative_to(root).as_posix() if name in excluded: diff --git a/src/lanctl/core/plugins/publishers.py b/src/lanctl/core/plugins/publishers.py index 9fee019..74cdc89 100644 --- a/src/lanctl/core/plugins/publishers.py +++ b/src/lanctl/core/plugins/publishers.py @@ -1,10 +1,11 @@ from __future__ import annotations import json +import re from datetime import datetime, timezone from pathlib import Path -from lanctl.core.file_transaction import atomic_write_json, locked_file +from lanctl.core.file_transaction import atomic_write_json, locked_file, transactional_method from lanctl.core.paths import application_path from lanctl.core.plugins.package import verify_package @@ -20,6 +21,7 @@ def __init__(self, path: str | Path = TRUSTED_PUBLISHERS) -> None: def list(self) -> list[dict]: return sorted(self._read().values(), key=lambda item: item["name"].casefold()) + @transactional_method def trust_package(self, package: str | Path, name: str = "") -> dict: result = verify_package(package) signature = str(result["signature"]) @@ -38,6 +40,7 @@ def trust_package(self, package: str | Path, name: str = "") -> dict: self._write(publishers) return entry + @transactional_method def revoke(self, fingerprint: str) -> bool: normalized = fingerprint.strip().casefold() publishers = self._read() @@ -55,9 +58,20 @@ def _read(self) -> dict[str, dict]: return {} try: document = json.loads(self.path.read_text(encoding="utf-8")) + if not isinstance(document, dict) or document.get("schemaVersion") != 1: + raise ValueError("schema de editores no compatible") values = document.get("publishers", {}) if not isinstance(values, dict): raise ValueError("publishers debe ser un objeto") + for key, value in values.items(): + if ( + not re.fullmatch(r"[0-9a-fA-F]{64}", key) + or not isinstance(value, dict) + or not isinstance(value.get("fingerprint"), str) + or value.get("fingerprint", "").casefold() != key.casefold() + or not isinstance(value.get("name"), str) + ): + raise ValueError("entrada de editor no válida") return {str(key).casefold(): dict(value) for key, value in values.items()} except (OSError, json.JSONDecodeError, TypeError, ValueError) as error: raise ValueError(f"almacén de editores confiables no válido: {self.path}") from error diff --git a/src/lanctl/core/plugins/selection.py b/src/lanctl/core/plugins/selection.py new file mode 100644 index 0000000..90fe133 --- /dev/null +++ b/src/lanctl/core/plugins/selection.py @@ -0,0 +1,49 @@ +"""Persistent bootstrap selection; omission never grants or revokes runtime permissions.""" + +import json +from pathlib import Path + +from lanctl.core.file_transaction import atomic_write_json, locked_file + +OPTIONAL_PLUGINS = ( + "lanctl.example.network-summary", + "lanctl.analysis.mac-vendor", + "lanctl.discovery.mdns-ssdp", + "lanctl.discovery.windows-smb", + "lanctl.network.wol", + "lanctl.lab.network-emulator", +) + + +def selected_plugins(root): + path = Path(root) / "bundled-selection.json" + if not path.exists(): + return set(OPTIONAL_PLUGINS) # Compatible with existing installations. + document = json.loads(path.read_text(encoding="utf-8")) + if ( + not isinstance(document, dict) + or type(document.get("schemaVersion")) is not int + or document["schemaVersion"] != 1 + ): + raise ValueError("selección de plugins no compatible") + selected = document.get("selected") + if ( + not isinstance(selected, list) + or not all(isinstance(x, str) and x in OPTIONAL_PLUGINS for x in selected) + or len(selected) != len(set(selected)) + ): + raise ValueError("selección de plugins no válida") + return set(selected) + + +def initialize_selection(root, selected): + if not isinstance(selected, (list, tuple, set)) or not all( + isinstance(x, str) and x in OPTIONAL_PLUGINS for x in selected + ): + raise ValueError("plugins opcionales desconocidos") + path = Path(root) / "bundled-selection.json" + with locked_file(path): + if path.exists(): + return selected_plugins(root) + atomic_write_json(path, {"schemaVersion": 1, "selected": sorted(set(selected))}) + return set(selected) diff --git a/src/lanctl/core/plugins/settings.py b/src/lanctl/core/plugins/settings.py new file mode 100644 index 0000000..0da44ee --- /dev/null +++ b/src/lanctl/core/plugins/settings.py @@ -0,0 +1,157 @@ +"""Versioned, non-secret preferences declared by an installed LCP manifest.""" + +from __future__ import annotations + +import json +import re + +from lanctl.core.file_transaction import update_json + + +class PluginSettings: + def __init__(self, plugin): + self.plugin = plugin + self.path = plugin.path.parent / ".settings" / f"{plugin.manifest.plugin_id}.json" + # The running manager may retain a module loaded before an external LCP + # update. Preferences describe the current package, not that cached module. + self.raw = plugin.manifest.raw + manifest_path = plugin.path / "plugin.info" + if manifest_path.is_file(): + from lanctl.core.plugins.models import PluginManifest + + with manifest_path.open("rb") as stream: + content = stream.read(512 * 1024 + 1) + if len(content) > 512 * 1024: + raise ValueError("manifiesto de configuración de plugin demasiado grande") + document = json.loads(content) + if not isinstance(document, dict): + raise ValueError("el manifiesto de configuración debe ser un objeto JSON") + manifest = PluginManifest.from_dict(document) + if manifest.plugin_id != plugin.manifest.plugin_id: + raise ValueError("el manifiesto de configuración pertenece a otro plugin") + self.raw = manifest.raw + + def fields(self) -> list[dict]: + schema = self.raw.get("settingsSchema") + if schema is None and self.plugin.manifest.plugin_id == "lanctl.network.wol": + # Existing WOL commands already consume these shared defaults. + return [ + { + "name": "port", + "label": "Puerto UDP", + "type": "integer", + "minimum": 1, + "maximum": 65535, + "default": 9, + }, + { + "name": "repeat", + "label": "Repeticiones", + "type": "integer", + "minimum": 1, + "maximum": 100, + "default": 3, + }, + { + "name": "wait", + "label": "Espera de arranque (segundos)", + "type": "integer", + "minimum": 0, + "maximum": 3600, + "default": 60, + }, + ] + if schema is None: + return [] + if not isinstance(schema, dict) or schema.get("schemaVersion") != 1: + raise ValueError("versión de configuración de plugin no compatible") + fields = schema.get("fields") + if not isinstance(fields, list) or len(fields) > 50: + raise ValueError("campos de configuración de plugin no válidos") + names = set() + for field in fields: + if not isinstance(field, dict): + raise ValueError("campo de configuración de plugin no válido") + name = field.get("name", "") + if not isinstance(name, str) or not re.fullmatch(r"[a-zA-Z][a-zA-Z0-9_]{0,63}", name): + raise ValueError("nombre de configuración de plugin no válido") + if name in names or field.get("type") not in {"text", "integer", "boolean", "select"}: + raise ValueError("tipo de configuración de plugin no permitido") + names.add(name) + self._value(field, field.get("default")) + return fields + + @staticmethod + def _value(field, value): + kind = field["type"] + if kind == "boolean": + valid = type(value) is bool + elif kind == "integer": + valid = type(value) is int and field.get("minimum", -(2**31)) <= value <= field.get( + "maximum", 2**31 - 1 + ) + else: + valid = isinstance(value, str) and len(value) <= 4096 + if kind == "select": + choices = field.get("choices") + valid = valid and isinstance(choices, list) and value in choices + if not valid: + raise ValueError(f"valor no válido para la opción {field['name']}") + return value + + def _document(self, value): + if ( + not isinstance(value, dict) + or value.get("schemaVersion") != 1 + or not isinstance(value.get("values"), dict) + ): + raise ValueError("archivo de configuración de plugin no válido") + return value + + def load(self) -> dict: + if self._uses_wol_defaults(): + from lanctl.core.config import load_config + + values = load_config().get("wol", {}) + return { + field["name"]: self._value(field, values.get(field["name"], field["default"])) + for field in self.fields() + } + document = ( + self._document(json.loads(self.path.read_text(encoding="utf-8"))) + if self.path.exists() + else {"schemaVersion": 1, "values": {}} + ) + return { + field["name"]: self._value( + field, document["values"].get(field["name"], field.get("default")) + ) + for field in self.fields() + } + + def save(self, values: dict) -> dict: + fields = {field["name"]: field for field in self.fields()} + if not isinstance(values, dict) or set(values) != set(fields): + raise ValueError("opciones de plugin desconocidas o incompletas") + cleaned = {name: self._value(fields[name], value) for name, value in values.items()} + if self._uses_wol_defaults(): + from lanctl.core.config import update_config + + def update(config): + config.setdefault("wol", {}).update(cleaned) + + update_config(update) + return cleaned + + def replace(document): + self._document(document) + return {"schemaVersion": 1, "values": cleaned} + + update_json(self.path, lambda: {"schemaVersion": 1, "values": {}}, replace) + return cleaned + + def _uses_wol_defaults(self): + return ( + self.plugin.manifest.plugin_id == "lanctl.network.wol" + and "settingsSchema" not in self.raw + ) diff --git a/src/lanctl/core/projects/metadata.py b/src/lanctl/core/projects/metadata.py new file mode 100644 index 0000000..ef203b1 --- /dev/null +++ b/src/lanctl/core/projects/metadata.py @@ -0,0 +1,97 @@ +"""Atomic, optimistic edits of project identity and LAN descriptive metadata.""" + +from __future__ import annotations + +import hashlib +import json +import shutil +import tempfile +from datetime import datetime +from pathlib import Path + +from lanctl.core.file_transaction import transactional_path_argument +from lanctl.core.projects import vlf +from lanctl.core.projects.settings import project_settings + +FIELDS = ( + ("name", "Nombre", "identity", "name"), + ("description", "Descripción", "identity", "description"), + ("author", "Autor", "identity", "author"), + ("lan", "LAN", "lan", "name"), + ("location", "Ubicación", "lan", "location"), + ("company", "Empresa", "lan", "company"), + ("responsible", "Responsable", "lan", "responsible"), +) + + +def _snapshot(documents): + values = {name: documents[section].get(key, "") for name, _, section, key in FIELDS} + revision = hashlib.sha256(json.dumps(values, sort_keys=True).encode()).hexdigest() + return {"values": values, "revision": revision} + + +def read_metadata(path): + return _snapshot(project_settings(path)) + + +def validate_metadata(values): + if not isinstance(values, dict) or set(values) != {name for name, *_ in FIELDS}: + raise ValueError("Metadatos de proyecto desconocidos o incompletos") + if any( + not isinstance(value, str) or len(value) > 4096 or "\x00" in value + for value in values.values() + ): + raise ValueError("Los metadatos requieren texto de hasta 4096 caracteres") + if not values["name"].strip(): + raise ValueError("El nombre del proyecto no puede estar vacío") + return {key: value.strip() for key, value in values.items()} + + +@transactional_path_argument("path", transform=lambda value: vlf._vlf_path(value)) +def update_metadata(path, values, revision): + values = validate_metadata(values) + source = vlf._existing_vlf(path) + documents = project_settings(source) + if revision != _snapshot(documents)["revision"]: + raise ValueError("Los metadatos cambiaron en otra ventana; recarga antes de guardar") + for name, _, section, key in FIELDS: + documents[section][key] = values[name].strip() + with vlf._VLF_WRITE_LOCK, tempfile.TemporaryDirectory(prefix="lanctl-metadata-") as temporary: + root = Path(temporary) + with vlf._safe_archive(source) as archive: + for entry in archive.infolist(): + if entry.is_dir(): + continue + target = root / entry.filename + if not target.resolve().is_relative_to(root.resolve()): + raise ValueError("Ruta de proyecto fuera del contenedor") + target.parent.mkdir(parents=True, exist_ok=True) + with archive.open(entry) as stream, target.open("wb") as output: + shutil.copyfileobj(stream, output) + vlf._write_json(root / "lan/lanIdentifier.info", documents["lan"]) + info = documents["identity"] + info["updated"] = datetime.now().astimezone().isoformat(timespec="seconds") + info["contentHash"] = vlf._hash_directory(root, {"project.info", "meta/checksum"}) + vlf._write_json(root / "project.info", info) + vlf._write_json( + root / "meta/checksum", + { + "algorithm": "SHA-256", + "hash": vlf._hash_directory(root, {"meta/checksum"}), + "scope": "all files except meta/checksum", + "contentHash": info["contentHash"], + }, + ) + from lanctl.core.persistence import create_backup + + create_backup(source, directory=source.parent / ".lanctl-backups") + vlf._write_archive(root, source) + from lanctl.core.projects.catalog import ProjectCatalog + from lanctl.core.session import current_session + + ProjectCatalog().register(source) + if session := current_session(): + session.emit( + "LANCTL.Core.Storage.Changed", project=str(source), metadata={"path": str(source)} + ) + return _snapshot(documents) diff --git a/src/lanctl/core/projects/settings.py b/src/lanctl/core/projects/settings.py new file mode 100644 index 0000000..ddb76fd --- /dev/null +++ b/src/lanctl/core/projects/settings.py @@ -0,0 +1,196 @@ +"""Transactional editing of VLF configuration documents.""" + +from __future__ import annotations + +import ipaddress +import json +import shutil +import tempfile +from datetime import datetime +from pathlib import Path + +from lanctl.core.file_transaction import transactional_path_argument +from lanctl.core.projects import vlf +from lanctl.core.settings_catalog import validate_value + +PROJECT_SETTINGS_ENTRIES = { + "identity": "project.info", + "lan": "lan/lanIdentifier.info", + "network": "lan/network.config", + "vlan": "lan/vlan.config", +} +PROJECT_EDITABLE = { + "identity": {"name", "description", "author"}, + "lan": {"name", "description", "location", "company", "responsible"}, + "network": { + "cidr", + "gateway", + "dns", + "dhcpRange", + "discovery", + "scanProfile", + "scanOrder", + "saveMode", + "saveIntervalMinutes", + }, + "vlan": {"vlans", "nativeVlan", "managementVlan"}, +} +NETWORK_PATHS = { + "cidr": "network.range", + "gateway": "network.gateway", + "dns": "network.dnsServers", + "dhcpRange": "network.dhcpRange", + "discovery": "ip.discovery", + "scanProfile": "ip.scanProfile", + "scanOrder": "ip.scanOrder", + "saveMode": "projects.saveMode", + "saveIntervalMinutes": "projects.saveIntervalMinutes", +} + + +@transactional_path_argument("path", transform=lambda value: vlf._vlf_path(value)) +def project_settings(path): + source = vlf._existing_vlf(path) + vlf.verify_project(source) + with vlf._safe_archive(source) as archive: + return { + category: vlf._read_json_entry(archive, entry) + for category, entry in PROJECT_SETTINGS_ENTRIES.items() + } + + +@transactional_path_argument("path", transform=lambda value: vlf._vlf_path(value)) +def update_project_setting(path, category, key, value): + if key not in PROJECT_EDITABLE.get(category, set()): + raise ValueError(f"Campo de proyecto de solo lectura: {category}.{key}") + source = vlf._existing_vlf(path) + with ( + vlf._VLF_WRITE_LOCK, + tempfile.TemporaryDirectory(prefix="lanctl-vlf-settings-") as temporary, + ): + documents = project_settings(source) + previous = documents[category][key] + if category == "network": + # Null DHCP/range fields still have a known schema type. + defaults = { + "cidr": "", + "gateway": "", + "dns": [], + "dhcpRange": None, + "discovery": "hybrid", + "scanProfile": "normal", + "scanOrder": "ascending", + "saveMode": "manual", + "saveIntervalMinutes": 5.0, + } + value = validate_value(NETWORK_PATHS[key], value, defaults[key]) + elif category == "vlan": + if ( + key in {"nativeVlan", "managementVlan"} + and value is not None + and (type(value) is not int or not 1 <= value <= 4094) + ): + raise ValueError("El identificador VLAN debe estar entre 1 y 4094 o null") + if key == "vlans" and ( + not isinstance(value, list) or any(not isinstance(item, dict) for item in value) + ): + raise ValueError("vlans requiere una lista de objetos VLAN") + elif not isinstance(value, str): + raise ValueError(f"{category}.{key} requiere texto") + if category == "identity" and key == "name" and not value.strip(): + raise ValueError("El nombre del proyecto no puede estar vacío") + if value == previous: + return documents + documents[category][key] = value + if category == "network" and key == "cidr": + network = ipaddress.ip_network(value, strict=False) if value else None + documents[category].update( + network=str(network.network_address) if network else "", + netmask=str(network.netmask) if network else "", + prefixLength=network.prefixlen if network else None, + ) + root = Path(temporary) + with vlf._safe_archive(source) as archive: + archive.extractall(root) + if category == "network": + override_path = root / "lan/settings.override.json" + overrides = ( + json.loads(override_path.read_text(encoding="utf-8")) + if override_path.exists() + else {"schemaVersion": 1, "network": {}} + ) + if overrides.get("schemaVersion") != 1 or not isinstance( + overrides.get("network"), dict + ): + raise ValueError("Configuración de proyecto incompatible") + overrides["network"][key] = value + if key == "cidr": + for derived in ("network", "netmask", "prefixLength"): + overrides["network"][derived] = documents[category][derived] + vlf._write_json(override_path, overrides) + vlf._write_json(root / PROJECT_SETTINGS_ENTRIES[category], documents[category]) + info = documents["identity"] + info["updated"] = datetime.now().astimezone().isoformat(timespec="seconds") + info["contentHash"] = vlf._hash_directory(root, {"project.info", "meta/checksum"}) + vlf._write_json(root / "project.info", info) + vlf._write_json( + root / "meta/checksum", + { + "algorithm": "SHA-256", + "hash": vlf._hash_directory(root, {"meta/checksum"}), + "scope": "all files except meta/checksum", + "contentHash": info["contentHash"], + }, + ) + backup_directory = source.parent / ".lanctl-backups" + backup_directory.mkdir(parents=True, exist_ok=True) + shutil.copy2( + source, + backup_directory / f"{source.stem}-{datetime.now().astimezone():%Y%m%d-%H%M%S-%f}.vlf", + ) + vlf._write_archive(root, source) + if category == "network": + from lanctl.core.config import load_config, update_config + + def apply(current): + if current.get("activeProject") and vlf._vlf_path(current["activeProject"]) == source: + current.update(project_network_overrides(source)) + + active = load_config().get("activeProject") + if active and vlf._vlf_path(active) == source: + update_config(apply) + return project_settings(source) + + +NETWORK_LEGACY_KEYS = { + "cidr": "range", + "gateway": "gateway", + "dns": "dnsServers", + "dhcpRange": "dhcpRange", + "discovery": "discovery", + "scanProfile": "scanProfile", + "scanOrder": "scanOrder", + "saveMode": "projectSaveMode", + "saveIntervalMinutes": "projectSaveIntervalMinutes", +} + + +def project_network_overrides(path): + """Return only explicit project preferences, never authentication or inventory.""" + with vlf._safe_archive(Path(path)) as archive: + if "lan/settings.override.json" not in archive.namelist(): + return {} + document = vlf._read_json_entry(archive, "lan/settings.override.json") + if document.get("schemaVersion") != 1 or not isinstance(document.get("network"), dict): + raise ValueError("Configuración de proyecto incompatible") + from lanctl.core.config import DOCUMENT_DEFAULTS + from lanctl.core.settings_catalog import leaves + + defaults = dict(leaves(DOCUMENT_DEFAULTS)) + return { + NETWORK_LEGACY_KEYS[key]: validate_value( + NETWORK_PATHS[key], value, defaults[NETWORK_PATHS[key]] + ) + for key, value in document["network"].items() + if key in NETWORK_LEGACY_KEYS + } diff --git a/src/lanctl/core/projects/vlf.py b/src/lanctl/core/projects/vlf.py index c205b59..2ad71a7 100644 --- a/src/lanctl/core/projects/vlf.py +++ b/src/lanctl/core/projects/vlf.py @@ -140,6 +140,14 @@ def create_project( shutil.copy2(root / "devices/elements.db", root / "devices/backup.db") network = _network_document(active, devices) + overrides_path = root / "lan/settings.override.json" + if overrides_path.exists(): + overrides = json.loads(overrides_path.read_text(encoding="utf-8")) + if overrides.get("schemaVersion") != 1 or not isinstance( + overrides.get("network"), dict + ): + raise ValueError("Configuración de proyecto incompatible") + network.update(overrides["network"]) _write_json(root / "lan/network.config", network) if not (root / "lan/vlan.config").exists(): _write_json( @@ -169,7 +177,7 @@ def create_project( "location": location or old_lan.get("location", ""), "company": company or old_lan.get("company", ""), "responsible": responsible or old_lan.get("responsible", ""), - "description": description or old_lan.get("description", ""), + "description": old_lan.get("description", description) if template else description, }, ) @@ -564,6 +572,7 @@ def _copy_logs(destination: Path, config: Mapping) -> None: def _copy_template_entries(source: Path, destination: Path) -> None: preserved = { "lan/lanIdentifier.info", + "lan/settings.override.json", "lan/vlan.config", "lan/topology.map", "auth/keys/logon/access.info", diff --git a/src/lanctl/core/projects/workspace.py b/src/lanctl/core/projects/workspace.py index 67fc48f..c1f60c3 100644 --- a/src/lanctl/core/projects/workspace.py +++ b/src/lanctl/core/projects/workspace.py @@ -270,7 +270,12 @@ def activate_project_workspace( discard_changes=discard_changes, ) + from lanctl.core.projects.settings import project_network_overrides + + network_preferences = project_network_overrides(source) + def select(current: dict) -> None: + current.update(network_preferences) previous = current.get("projectWorkspace") previous_database = str(previous.get("database", "")) if isinstance(previous, dict) else "" previous_groups = str(previous.get("groups", "")) if isinstance(previous, dict) else "" diff --git a/src/lanctl/core/rack_dimensions.py b/src/lanctl/core/rack_dimensions.py new file mode 100644 index 0000000..439a634 --- /dev/null +++ b/src/lanctl/core/rack_dimensions.py @@ -0,0 +1,88 @@ +"""Physical rack dimensions, shared validation and non-destructive legacy reads.""" + +from copy import deepcopy + +WIDTHS = (10, 19, 21, 23) +HEIGHT_KEYS = ("units", "size_units", "height") + + +def validate_height(value): + if type(value) is not int or not 4 <= value <= 52: + raise ValueError("La altura del rack debe ser un entero entre 4 y 52 U") + return value + + +def validate_width(value): + if type(value) is not int or value not in WIDTHS: + raise ValueError("El ancho de montaje debe ser 10, 19, 21 o 23 pulgadas") + return value + + +def dimension_status(data): + height = next((data[k] for k in HEIGHT_KEYS if k in data), None) + dimensions = data.get("rackDimensions") + warnings = [] + try: + validate_height(height) + except ValueError as exc: + warnings.append(str(exc)) + if any(data[k] != height for k in HEIGHT_KEYS if k in data): + warnings.append("Alturas heredadas contradictorias; requiere corrección explícita") + width = None + if dimensions is None: + warnings.append("Ancho de montaje sin especificar") + elif ( + not isinstance(dimensions, dict) + or type(dimensions.get("schemaVersion")) is not int + or dimensions.get("schemaVersion") != 1 + ): + warnings.append("Esquema de dimensiones no compatible") + else: + width = dimensions.get("widthInches") + try: + validate_width(width) + except ValueError as exc: + warnings.append(str(exc)) + return { + "schemaVersion": 1, + "heightU": height, + "widthInches": width, + "needsReview": bool(warnings), + "warnings": warnings, + } + + +def with_dimensions(data, height, width): + height, width = validate_height(height), validate_width(width) + result = deepcopy(data) + # Preserve old field consumers while maintaining one consistent height. + for key in HEIGHT_KEYS: + if key == "units" or key in result: + result[key] = height + result["rackDimensions"] = {"schemaVersion": 1, "widthInches": width} + return result + + +def new_rack_dimensions(data): + height = next((data[k] for k in HEIGHT_KEYS if k in data), 42) + dimensions = data.get("rackDimensions", {"schemaVersion": 1, "widthInches": 19}) + if ( + not isinstance(dimensions, dict) + or type(dimensions.get("schemaVersion")) is not int + or dimensions.get("schemaVersion") != 1 + ): + raise ValueError("Esquema de dimensiones no compatible") + return with_dimensions(data, height, dimensions.get("widthInches")) + + +def validate_dimension_change(previous, updated, occupants): + keys = (*HEIGHT_KEYS, "rackDimensions") + if all(previous.get(key) == updated.get(key) for key in keys): + return # Editing a name must not destroy or silently repair legacy dimensions. + current = dimension_status(updated) + if current["needsReview"]: + raise ValueError("; ".join(current["warnings"])) + height = current["heightU"] + for unit, span in occupants: + if unit is not None and (type(unit) is not int or unit < 1 or unit + span - 1 > height): + raise ValueError("La altura deja equipos fuera del rack") diff --git a/src/lanctl/core/session.py b/src/lanctl/core/session.py index c9b2a2a..ac6eacf 100644 --- a/src/lanctl/core/session.py +++ b/src/lanctl/core/session.py @@ -5,7 +5,7 @@ import sqlite3 import sys import threading -from contextlib import contextmanager +from contextlib import ExitStack, contextmanager from contextvars import ContextVar from copy import deepcopy from functools import wraps @@ -98,8 +98,9 @@ def project(self): def emit(self, event, **kwargs): kwargs.setdefault("correlation", current_task_id()) + kwargs.setdefault("project", self.project) try: - return self.coordinator.publish(self.id, event, project=self.project, **kwargs) + return self.coordinator.publish(self.id, event, **kwargs) except (OSError, ValueError, RuntimeError, sqlite3.Error) as error: _report(error) return None @@ -157,7 +158,9 @@ def overlay_config(config): session = current_session() if session: with session.lock: - return {**config, **deepcopy(session.config)} + replacement = deepcopy(config) + replacement.update(deepcopy(session.config)) + return replacement return config @@ -174,7 +177,9 @@ def prepare_config_save(config, stored): changed = any(config.get(key) != session.config.get(key) for key in PROJECT_KEYS) if changed: return config - return {**config, **{key: deepcopy(stored.get(key)) for key in PROJECT_KEYS}} + replacement = deepcopy(config) + replacement.update({key: deepcopy(stored.get(key)) for key in PROJECT_KEYS}) + return replacement def commit_config(config): @@ -252,6 +257,26 @@ def decorate(function): def wrapped(argv=None, *args, **kwargs): global _current arguments = list(sys.argv[1:] if argv is None else argv) + # A routed application owns its session/window. The orchestrator + # must not claim LANCTL's GUI singleton for `lanctl lanwire --gui`. + if ( + launcher == "lanctl" + and arguments + and arguments[0].casefold() + in { + "lanip", + "lanwire", + "lanrack", + "lanaccess", + "lanmon", + "ip", + "wire", + "rack", + "access", + "monitor", + } + ): + return function(argv, *args, **kwargs) if any( word in {"--help", "-h", "/?", "--version", "ephemeral", "-e"} for word in arguments ): @@ -262,21 +287,40 @@ def wrapped(argv=None, *args, **kwargs): return _invoke(function, argv, args, kwargs) from lanctl.core.config import load_config - mode = ( - "gui" - if "--gui" in arguments - else "tui" - if any(word in {"--tui", "-tui"} for word in arguments) - or (launcher == "lanip" and not arguments) - else "backend" - if "foreground" in arguments - else "cli" - ) + stack = ExitStack() try: - session = Session( - launcher, mode, load_config(), parent=parent.id if parent else None + from lanctl.core.session_context import consume_context + + config = consume_context(launcher, load_config()) + if launcher == "lanctl" and not arguments: + preferred = config.get("startupInterface", "cli") + if preferred not in {"cli", "tui", "gui"}: + preferred = "cli" + arguments = [f"--{preferred}"] + argv = arguments + mode = ( + "gui" + if "--gui" in arguments + else "tui" + if any(word in {"--tui", "-tui"} for word in arguments) + or (launcher == "lanip" and not arguments) + else "backend" + if "foreground" in arguments + else "cli" ) - except (OSError, ValueError, sqlite3.Error) as error: + if mode in {"cli", "tui"}: + from lanctl.core.window_icons import apply_terminal_icon + + apply_terminal_icon(launcher) + if mode == "gui": + from lanctl.core.gui_instance import GuiInstance + + if not stack.enter_context(GuiInstance(launcher)): + stack.close() + return 0 + session = Session(launcher, mode, config, parent=parent.id if parent else None) + except (OSError, ValueError, RuntimeError, sqlite3.Error) as error: + stack.close() from lanctl.core.errors import errors errors.from_exception( @@ -301,6 +345,8 @@ def wrapped(argv=None, *args, **kwargs): session.close() except (OSError, sqlite3.Error) as error: _report(error) + finally: + stack.close() return wrapped diff --git a/src/lanctl/core/session_context.py b/src/lanctl/core/session_context.py new file mode 100644 index 0000000..dd251e3 --- /dev/null +++ b/src/lanctl/core/session_context.py @@ -0,0 +1,46 @@ +"""Versioned, one-shot local launch context; contains paths, never credentials.""" + +import json +import os + +ENVIRONMENT_KEY = "LANCTL_SESSION_CONTEXT" + + +def child_environment(launcher, config, environment=None): + from lanctl.core.session import PROJECT_KEYS + + result = dict(os.environ if environment is None else environment) + result[ENVIRONMENT_KEY] = json.dumps( + { + "schemaVersion": 1, + "launcher": launcher, + "config": {key: config.get(key) for key in PROJECT_KEYS}, + }, + ensure_ascii=False, + ) + return result + + +def consume_context(launcher, config): + from lanctl.core.session import PROJECT_KEYS + + encoded = os.environ.get(ENVIRONMENT_KEY, "") + if not encoded: + return config + payload = json.loads(encoded) + if payload.get("schemaVersion") != 1 or not isinstance(payload.get("config"), dict): + raise ValueError("Contexto de lanzamiento no compatible") + if payload.get("launcher") != launcher: + return config + os.environ.pop(ENVIRONMENT_KEY, None) + values = payload["config"] + if set(values) - PROJECT_KEYS or any( + not isinstance(value, (str, dict, type(None))) for value in values.values() + ): + raise ValueError("Contexto de proyecto no válido") + # ConfigSnapshot must retain its canonical document for subsequent saves. + from copy import deepcopy + + replacement = deepcopy(config) + replacement.update(values) + return replacement diff --git a/src/lanctl/core/settings_catalog.py b/src/lanctl/core/settings_catalog.py new file mode 100644 index 0000000..03b657a --- /dev/null +++ b/src/lanctl/core/settings_catalog.py @@ -0,0 +1,231 @@ +"""Complete, schema-driven settings catalog shared by interactive interfaces.""" + +from __future__ import annotations + +import ipaddress +import math +import re +from copy import deepcopy + +from lanctl.core.config import ( + DOCUMENT_DEFAULTS, + canonical_config, + config_from_document, + update_config, +) + +CATEGORIES = { + "storage": "Almacenamiento y credenciales", + "logging": "Registros y diagnóstico", + "projects": "Proyectos, guardado y espacio de trabajo", + "plugins": "Plugins", + "localization": "Idioma y traducciones", + "cli": "Consola CLI", + "network": "Red, DHCP, DNS y TR-064", + "ip": "LANIP: descubrimiento e inventario", + "tui": "Interfaz TUI: distribución, columnas y teclado", + "wol": "Wake on LAN", + "access": "LANACCESS y acceso remoto", + "monitor": "LANMON: ejecución, intervalos y retención", + "schemaVersion": "Información del formato", +} + + +CATEGORIES["startup"] = "Inicio de LANCTL y ventanas" +# Append new categories so existing numbered CLI navigation keeps its meaning. +CATEGORIES["gui"] = "Apariencia y GUI" + + +def leaves(document, prefix=""): + for key, value in document.items(): + path = f"{prefix}.{key}" if prefix else key + if isinstance(value, dict) and value: + yield from leaves(value, path) + else: + yield path, deepcopy(value) + + +def read_only(path): + if path.endswith("schemaVersion") or path == "network.settingsDownloadedAt": + return "Campo automático del formato o de la última descarga" + if path in {"projects.active", "projects.workspace.active"}: + return "Gestionado mediante project use / project create" + return "" + + +def catalog(config): + current = dict(leaves(canonical_config(config))) + return [ + { + "path": path, + "category": path.split(".")[0], + "value": value, + "default": default, + "readOnly": read_only(path), + } + for path, default in leaves(DOCUMENT_DEFAULTS) + for value in [current.get(path, default)] + ] + + +def _assign(document, path, value): + parts = path.split(".") + target = document + for part in parts[:-1]: + target = target[part] + target[parts[-1]] = value + + +def validate_value(path, value, default): + if path.startswith("gui.") and path != "gui.schemaVersion": + from lanctl.core.gui_preferences import validate_preferences + + values = {k: v for k, v in DOCUMENT_DEFAULTS["gui"].items() if k != "schemaVersion"} + key = path.split(".", 1)[1] + values[key] = value + return validate_preferences(values)[key] + if value is None and path.startswith("tui.keyBindings."): + return None + if ( + default is not None + and type(value) is not type(default) + and not ( + (type(default) is float or path == "projects.saveIntervalMinutes") + and type(value) in (int, float) + ) + ): + raise ValueError(f"{path}: requiere {type(default).__name__}") + if path == "monitor.duration": + from lanctl.apps.monitor.configuration import parse_duration + + if value is None: + return None + seconds = parse_duration(value) + if not 10 <= seconds <= 86400: + raise ValueError("La duración del monitor debe estar entre 10s y 24h") + return seconds + if path == "monitor.cidr" and value: + network = ipaddress.ip_network(value, strict=False) + if network.version != 4 or network.num_addresses > 65536: + raise ValueError("CIDR monitor no válido o demasiado amplio") + if default is None and value is not None: + expected = ( + bool + if path == "network.dhcpEnabled" + else int + if path == "network.dhcpLeaseTime" + else str + ) + if type(value) is not expected: + raise ValueError(f"{path}: requiere {expected.__name__} o null") + if isinstance(value, (int, float)) and not isinstance(value, bool): + if not math.isfinite(value) or value < 0: + raise ValueError(f"{path}: requiere un número finito no negativo") + if ( + path.endswith( + ("workers", "maxHosts", "failureThreshold", "recoveryThreshold", "retentionDays") + ) + or ".intervals." in path + ) and value < 1: + raise ValueError(f"{path}: mínimo 1") + if path == "projects.saveIntervalMinutes" and value < 0.1: + raise ValueError("El intervalo de guardado debe ser de al menos 0.1 minutos") + if path == "wol.repeat" and value < 1: + raise ValueError("wol.repeat: mínimo 1") + if path.endswith(("timeout", "saveIntervalMinutes")) and value <= 0: + raise ValueError(f"{path}: debe ser mayor que cero") + if path.endswith(("Port", ".port")) and not 1 <= value <= 65535: + raise ValueError(f"{path}: puerto entre 1 y 65535") + if path == "logging.errorLevel" and not 1 <= value <= 59: + raise ValueError("logging.errorLevel: entre 1 y 59") + enums = { + "startup.interface": ("cli", "tui", "gui"), + "ip.discovery": ("icmp", "arp", "hybrid"), + "ip.scanProfile": ("fast", "normal", "accurate"), + "ip.scanOrder": ("ascending", "descending", "random"), + "monitor.execution.scanOrder": ("ascending", "descending", "random"), + "ip.disconnectedRetention": ("permanent", "session", "forget"), + "ip.disconnectedRetentionTarget": ("unconfirmed", "all"), + "ip.disconnectedRetentionScope": ("all", "dhcp"), + "monitor.authority": ("observe", "operate", "administer"), + "monitor.mode": ("permanent", "temporary", "diagnostic", "once"), + "access.remote.backend": ("service", "user"), + "access.remote.forcedView": ("off", "gui", "tui", "plugins", "projects", "settings"), + "wol.method": ("auto", "arp", "ping", "port"), + } + if path in enums and value not in enums[path]: + raise ValueError(f"{path}: opciones {', '.join(enums[path])}") + if path == "projects.saveMode": + from lanctl.core.projects.save_policy import normalize_save_mode + + return normalize_save_mode(value) + if path == "network.range" and value and ipaddress.ip_network(value, strict=False).version != 4: + raise ValueError("Solo se admiten redes IPv4") + if path == "network.dhcpRange" and value: + from lanctl.core.config import normalize_dhcp_range + + return normalize_dhcp_range(value) + if path in {"network.gateway", "network.tr064Host"} and value: + ipaddress.ip_address(value) + if path == "network.subnetMask" and value: + ipaddress.IPv4Network(f"0.0.0.0/{value}") + if path in {"network.dnsServers", "network.reservedAddresses"}: + for address in value: + ipaddress.ip_address(address) + if path.startswith("monitor.retention.") and not re.fullmatch( + r"(?:[1-9][0-9]*[smhdw]|permanent)", value + ): + raise ValueError(f"{path}: usa una duración como 24h, 30d o permanent") + if path == "ip.listColumns": + from lanctl.core.output import normalize_columns + + return normalize_columns(value) + if path == "tui.cliHeightPercent": + from lanctl.apps.ip.interfaces.tui.layout import normalize_cli_percent + + return normalize_cli_percent(value) + if path == "tui.panelLayout": + from lanctl.apps.ip.interfaces.tui.layout import normalize_panel_layout + + return normalize_panel_layout(value) + if path.startswith("tui.columnWidths."): + from lanctl.apps.ip.interfaces.tui.layout import normalize_column_spec + + return normalize_column_spec(path.rsplit(".", 1)[1], value) + if path.startswith("tui.keyBindings.") and value is not None: + from lanctl.apps.ip.interfaces.tui.keyboard import CONFIGURABLE_TUI_KEYS + + if value not in CONFIGURABLE_TUI_KEYS: + raise ValueError(f"Tecla TUI no válida: {value}") + if path == "tui.footerButtons": + from lanctl.apps.ip.interfaces.tui.keyboard import FOOTER_ACTIONS + + if any(action not in FOOTER_ACTIONS for action in value): + raise ValueError("Acción de barra TUI desconocida") + return value + + +def set_program_value(path, value): + defaults = dict(leaves(DOCUMENT_DEFAULTS)) + if path not in defaults: + raise ValueError(f"Ajuste desconocido: {path}") + if reason := read_only(path): + raise ValueError(f"{path}: solo lectura. {reason}") + value = validate_value(path, value, defaults[path]) + + def apply(config): + document = canonical_config(config) + _assign(document, path, value) + if path.startswith("tui.keyBindings."): + from lanctl.apps.ip.interfaces.tui.keyboard import validate_key_bindings + + validate_key_bindings(document["tui"]["keyBindings"]) + replacement = config_from_document(document) + if path.startswith("monitor."): + from lanctl.apps.monitor.configuration import ConfigProvider, validate_monitor_settings + + validate_monitor_settings(replacement["monitor"]) + ConfigProvider(replacement).monitor() + return replacement + + return update_config(apply) diff --git a/src/lanctl/core/updates.py b/src/lanctl/core/updates.py new file mode 100644 index 0000000..5ac8c80 --- /dev/null +++ b/src/lanctl/core/updates.py @@ -0,0 +1,209 @@ +"""Stable release discovery only. Call from a background worker, never the GUI thread.""" + +from __future__ import annotations + +import json +import math +import re +import time +from pathlib import Path +from urllib.parse import quote +from urllib.request import Request, urlopen + +from lanctl import __version__ +from lanctl.core.file_transaction import atomic_write_json, locked_file +from lanctl.core.official_links import get_official_links +from lanctl.core.paths import data_root + +DAY = 86400 +_VERSION = re.compile( + r"^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$" +) + + +def version_key(value): + if not isinstance(value, str) or not (match := _VERSION.fullmatch(value.removeprefix("v"))): + raise ValueError("versión semántica no válida") + prerelease = match[4] + parts = [] + for part in prerelease.split(".") if prerelease else []: + if part.isdecimal() and len(part) > 1 and part[0] == "0": + raise ValueError("identificador numérico de versión no válido") + parts.append((0, int(part)) if part.isdecimal() else (1, part)) + return (tuple(int(match[i]) for i in (1, 2, 3)), 0 if prerelease else 1, tuple(parts)) + + +def _fetch_releases(): + releases = [] + for page in range(1, 6): + request = Request( + f"https://api.github.com/repos/CctrGy/LANCTL/releases?per_page=100&page={page}", + headers={ + "Accept": "application/vnd.github+json", + "User-Agent": "LANCTL-update-check", + "X-GitHub-Api-Version": "2022-11-28", + }, + ) + # Only the fixed public GitHub HTTPS endpoint is requested. + with urlopen(request, timeout=3) as response: # nosec B310 + body = response.read(2 * 1024 * 1024 + 1) + if len(body) > 2 * 1024 * 1024: + raise ValueError("respuesta de versiones demasiado grande") + rows = json.loads(body) + if not isinstance(rows, list): + raise ValueError("respuesta de versiones no válida") + releases.extend(rows) + if len(rows) < 100: + return releases + raise ValueError("catálogo de versiones excede el límite de consulta") + + +class UpdateService: + def __init__(self, path=None, *, fetcher=None, clock=None): + self.path = Path(path) if path is not None else data_root() / "config" / "update-check.json" + self.fetcher = fetcher or _fetch_releases + self.clock = clock or time.time + + def _read(self): + if not self.path.exists(): + return { + "schemaVersion": 1, + "checkedAt": None, + "result": None, + "deferredVersion": None, + "deferredUntil": 0, + } + data = json.loads(self.path.read_text(encoding="utf-8")) + if ( + not isinstance(data, dict) + or type(data.get("schemaVersion")) is not int + or data["schemaVersion"] != 1 + ): + raise ValueError("caché de actualizaciones no compatible") + for key in ("checkedAt", "deferredUntil"): + value = data.get(key) + if value is not None and (type(value) not in (int, float) or not math.isfinite(value)): + raise ValueError("fecha de caché de actualizaciones no válida") + if data.get("result") is not None and not isinstance(data["result"], dict): + raise ValueError("resultado de caché de actualizaciones no válido") + previous = data.get("result") + if previous: + if previous.get("schemaVersion") != 1 or previous.get("status") not in { + "current", + "available", + "unavailable", + }: + raise ValueError("estado de caché de actualizaciones no válido") + version_key(previous.get("installed")) + available = previous.get("available") + if available is not None: + version_key(available) + allowed = { + get_official_links()["github"] + + "/releases/tag/" + + quote(prefix + available, safe="") + for prefix in ("", "v") + } + if previous.get("url") not in allowed or version_key(available) <= version_key( + previous["installed"] + ): + raise ValueError("enlace o versión de caché de actualizaciones no válido") + elif previous.get("url") is not None or previous.get("status") == "available": + raise ValueError("caché de actualizaciones inconsistente") + if not isinstance(previous.get("notes"), str) or len(previous["notes"]) > 8000: + raise ValueError("notas de caché de actualizaciones no válidas") + return data + + @staticmethod + def _empty(now): + return { + "schemaVersion": 1, + "installed": __version__, + "available": None, + "url": None, + "notes": "", + "checkedAt": now, + "status": "unavailable", + "cached": False, + "deferred": False, + } + + def check(self, *, manual=False) -> dict: + now = self.clock() + result = self._empty(now) + try: + if type(manual) is not bool: + raise ValueError("manual debe ser booleano") + # A reservation persists before network I/O, limiting retries even on + # failure, process exit, or a simultaneous second launcher. + with locked_file(self.path): + data = self._read() + checked = data.get("checkedAt") + if not manual and checked is not None and 0 <= now - checked < DAY: + previous = data.get("result") or self._empty(checked) + if previous.get("installed") == __version__: + return { + **previous, + "cached": True, + "deferred": previous.get("available") == data.get("deferredVersion") + and now < data.get("deferredUntil", 0), + } + return {**result, "checkedAt": checked, "cached": True} + data.update(checkedAt=now, result=result) + atomic_write_json(self.path, data) + rows = self.fetcher() + if not isinstance(rows, list) or len(rows) > 500: + raise ValueError("catálogo de versiones no válido") + candidates = [] + for release in rows: + if ( + not isinstance(release, dict) + or release.get("draft") is not False + or release.get("prerelease") is not False + or not release.get("published_at") + ): + continue + try: + key = version_key(release.get("tag_name")) + except ValueError: + continue + if key > version_key(__version__): + candidates.append((key, release)) + result["status"] = "current" + if candidates: + release = max(candidates, key=lambda pair: pair[0])[1] + tag = release["tag_name"] + result.update( + status="available", + available=tag.removeprefix("v"), + url=get_official_links()["github"] + "/releases/tag/" + quote(tag, safe=""), + notes=str(release.get("body") or "")[:8000], + ) + with locked_file(self.path): + latest = self._read() + result["deferred"] = result["available"] == latest.get( + "deferredVersion" + ) and now < latest.get("deferredUntil", 0) + # A newer manual request owns the cache; never replace it with an older result. + if latest.get("checkedAt") == now: + latest["result"] = result + atomic_write_json(self.path, latest) + except (OSError, ValueError, TypeError) as exc: + from lanctl.core.errors import errors + + errors.from_exception( + exc, + origin="LANCTL.Core.Updates.Check", + code="UPDATES.CHECK.UNAVAILABLE", + level=24, + print_output=False, + ) + result = self._empty(now) + return result + + def remind_later(self, version: str) -> None: + version_key(version) + with locked_file(self.path): + data = self._read() + data.update(deferredVersion=version.removeprefix("v"), deferredUntil=self.clock() + DAY) + atomic_write_json(self.path, data) diff --git a/src/lanctl/core/window_icons.py b/src/lanctl/core/window_icons.py new file mode 100644 index 0000000..c028721 --- /dev/null +++ b/src/lanctl/core/window_icons.py @@ -0,0 +1,50 @@ +"""Local icon resources for native captions and classic Windows consoles.""" + +import sys + +from lanctl.core.resources import bundled_path + +_handles = {} # Keep HICON resources alive for the process lifetime. + + +def icon_path(name): + return bundled_path(f"assets/launcher-icons/{name}.ico") + + +def apply_window_icon(handle, name): + if sys.platform != "win32": + return + import ctypes + from ctypes import wintypes + + user = ctypes.windll.user32 + user.LoadImageW.argtypes = [ + wintypes.HINSTANCE, + wintypes.LPCWSTR, + wintypes.UINT, + ctypes.c_int, + ctypes.c_int, + wintypes.UINT, + ] + user.LoadImageW.restype = wintypes.HANDLE + user.SendMessageW.argtypes = [wintypes.HWND, wintypes.UINT, wintypes.WPARAM, wintypes.LPARAM] + user.SendMessageW.restype = ctypes.c_ssize_t + for kind, size in ((0, 16), (1, 32)): + key = (name, size) + if key not in _handles: + _handles[key] = user.LoadImageW(None, str(icon_path(name)), 1, size, size, 0x10) + if _handles[key]: + user.SendMessageW(handle, 0x80, kind, _handles[key]) + + +def apply_terminal_icon(launcher): + if sys.platform != "win32" or not sys.stdout.isatty(): + return + import ctypes + + kernel = ctypes.windll.kernel32 + kernel.GetConsoleWindow.restype = ctypes.c_void_p + kernel.SetConsoleTitleW(f"{launcher.upper()} · Terminal") + handle = kernel.GetConsoleWindow() + if handle: + apply_window_icon(handle, "terminal") diff --git a/tests/gui_coordination_smoke.py b/tests/gui_coordination_smoke.py new file mode 100644 index 0000000..8439e9a --- /dev/null +++ b/tests/gui_coordination_smoke.py @@ -0,0 +1,163 @@ +"""Windows native GUI coordination smoke, isolated from the user's data. + +Run explicitly: python tests/gui_coordination_smoke.py +Creates and closes only its own LANCTL/LANIP test windows. +""" + +import ctypes +import os +import subprocess +import tempfile +import time +from ctypes import wintypes +from pathlib import Path +from threading import Event + + +def wait_for(check, timeout=20): + deadline = time.monotonic() + timeout + while time.monotonic() < deadline: + value = check() + if value: + return value + time.sleep(0.1) + raise AssertionError("Native GUI check timed out") + + +def window_for_process(pid): + user32 = ctypes.windll.user32 + matches = [] + callback = ctypes.WINFUNCTYPE(wintypes.BOOL, wintypes.HWND, wintypes.LPARAM) + + def visit(handle, _): + owner = wintypes.DWORD() + user32.GetWindowThreadProcessId(handle, ctypes.byref(owner)) + if owner.value == pid and user32.IsWindowVisible(handle): + matches.append(handle) + return True + + user32.EnumWindows(callback(visit), 0) + return matches[0] if matches else None + + +def main(): + if os.name != "nt": + print("This smoke requires a Windows desktop session") + return 2 + with tempfile.TemporaryDirectory(prefix="lanctl-coordination-smoke-") as directory: + os.environ["LANCTL_DATA_DIR"] = directory + from lanctl.core.file_transaction import atomic_write_text + + atomic_write_text(Path(directory) / "config/migration-v2.complete", "LANCTL-DATA-V2\n") + from lanctl.core.config import load_config, save_config + from lanctl.core.data_migration import ensure_data_layout + + ensure_data_layout() + config = load_config() + config.update( + pluginSafeMode=True, + closeGuiOnLaunch=False, + startupInterface="gui", + projectsDirectory=str(Path(directory) / "projects-test"), + ) + save_config(config) + import webview + + from lanctl.apps.suite.processes import launcher_command, process_options + from lanctl.bootstrap.lanctl import main as launch + from lanctl.core.coordination import Coordinator + + coordinator = Coordinator() + original = webview.create_window + outcome = [] + children = [] + verified = Event() + popen = subprocess.Popen + + def track(*args, **kwargs): + process = popen(*args, **kwargs) + children.append(process) + return process + + def create(*args, **kwargs): + window = original(*args, **kwargs) + api = kwargs["js_api"] + closed = Event() + window.events.closed += closed.set + + def verify(): + handle = None + try: + wait_for(lambda: window.evaluate_js("Boolean(state.version)")) + result = api.launch_gui("lanip") + assert result["ok"] and not result.get("closed"), result + sessions = coordinator.sessions() + assert {s["launcher"] for s in sessions} == {"lanctl", "lanip"} + child = next(s for s in sessions if s["launcher"] == "lanip") + handle = wait_for(lambda: window_for_process(child["pid"])) + ctypes.windll.user32.ShowWindow(wintypes.HWND(handle), 6) # minimize own child + wait_for(lambda: ctypes.windll.user32.IsIconic(wintypes.HWND(handle))) + duplicate = subprocess.run( + launcher_command("lanip", "--gui"), + creationflags=subprocess.CREATE_NO_WINDOW, + timeout=20, + capture_output=True, + **process_options(), + ) + assert duplicate.returncode == 0, duplicate.stderr + wait_for(lambda: not ctypes.windll.user32.IsIconic(wintypes.HWND(handle))) + foreground = ctypes.windll.user32.GetForegroundWindow + foreground.restype = wintypes.HWND + wait_for(lambda: foreground() == handle) + assert len([s for s in coordinator.sessions() if s["launcher"] == "lanip"]) == 1 + wait_for( + lambda: window.evaluate_js("state.sessions.some(s=>s.launcher==='lanip')") + ) + ctypes.windll.user32.PostMessageW(wintypes.HWND(handle), 0x10, 0, 0) + wait_for(lambda: all(s["launcher"] != "lanip" for s in coordinator.sessions())) + wait_for( + lambda: window.evaluate_js("!state.sessions.some(s=>s.launcher==='lanip')") + ) + assert any(s["launcher"] == "lanctl" for s in coordinator.sessions()) + from lanctl.core.config import update_config + + update_config(lambda settings: settings.update(closeGuiOnLaunch=True)) + result = api.launch_gui("lanip") + assert result["ok"] and result["closed"], result + assert closed.wait(10), "LANCTL did not close after opening its launcher" + assert children[-1].poll() is None, "Closing LANCTL stopped the launcher" + child = next(s for s in coordinator.sessions() if s["launcher"] == "lanip") + handle = wait_for(lambda: window_for_process(child["pid"])) + outcome.append( + "PASS: default GUI, simultaneous launchers, duplicate focus, restore, close feedback, child survives parent" + ) + except Exception as error: + outcome.append(f"FAIL: {type(error).__name__}: {error}") + finally: + if handle: + ctypes.windll.user32.PostMessageW(wintypes.HWND(handle), 0x10, 0, 0) + if not closed.is_set(): + window.destroy() + verified.set() + + window.events.loaded += verify + return window + + webview.create_window = create + # Track only children spawned during this isolated test for bounded cleanup. + subprocess.Popen = track + try: + launch([]) + assert verified.wait(30), "GUI verification did not finish" + finally: + subprocess.Popen = popen + for process in children: + if process.poll() is None: + process.terminate() + process.wait(timeout=10) + print("\n".join(outcome)) + return 0 if outcome and outcome[0].startswith("PASS") else 1 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/tests/gui_native_smoke.py b/tests/gui_native_smoke.py index f09f5eb..3dc5ab7 100644 --- a/tests/gui_native_smoke.py +++ b/tests/gui_native_smoke.py @@ -71,7 +71,7 @@ def verify(): except Exception as error: outcome.append(f"FAIL: {error}") finally: - api._closing = True + # Exercises the native closing event and JS/RPC close handshake. window.destroy() window.events.loaded += verify diff --git a/tests/launcher_gui_native_smoke.py b/tests/launcher_gui_native_smoke.py new file mode 100644 index 0000000..f13940b --- /dev/null +++ b/tests/launcher_gui_native_smoke.py @@ -0,0 +1,120 @@ +"""Explicit native smoke for specialized GUIs; all storage is temporary.""" + +import importlib +import os +import sys +import tempfile +import time +from pathlib import Path + + +def main(launcher): + modules = { + "lanwire": "lanctl.apps.wire.cli.main", + "lanrack": "lanctl.apps.rack.cli", + "lanaccess": "lanctl.apps.access.manager_cli", + "lanmon": "lanctl.bootstrap.lanmon", + } + with tempfile.TemporaryDirectory(prefix=launcher + "-gui-native-") as temporary: + root = Path(temporary) + os.environ["LANCTL_DATA_DIR"] = str(root) + os.environ["LANCTL_SECRET_DIR"] = str(root / "secrets") + marker = root / "config/migration-v2.complete" + marker.parent.mkdir(parents=True) + marker.write_text("LANCTL-DATA-V2\n") + from lanctl.core.config import load_config, save_config + from lanctl.core.database import DeviceDatabase + from lanctl.core.projects.vlf import create_project + + config = load_config() + config.update( + database=str(root / "devices.json"), + groups=str(root / "groups.json"), + physicalDatabase=str(root / "physical.db"), + credentials=str(root / "access.vault"), + monitorDatabase=str(root / "monitor.db"), + monitorLock=str(root / "monitor.lock"), + pluginSafeMode=True, + ) + project = root / "Office.vlf" + create_project(project, name="Office", config=config, initialize_reserved=False) + config.update(activeProject=str(project), projectWorkspace=None) + save_config(config) + device = DeviceDatabase(config["database"]).upsert( + [{"IP": "192.0.2.10", "MAC": "02:00:00:00:00:10"}] + )[0] + from lanctl.apps.wire.gui_service import WireGuiService + + physical = WireGuiService(config["physicalDatabase"]) + rack = physical.create({"prefix": "RK", "kind": "rack", "name": "Principal", "units": 24})[ + "id" + ] + switch = physical.create( + {"prefix": "SW", "kind": "switch.5ports", "name": "Switch oficina"} + )["id"] + record = next(r for r in physical.snapshot()["records"] if r["id"] == switch) + physical.update(switch, record["revision"], {"rack": rack, "unit": 18}) + import webview + + original = webview.create_window + outcome = [] + + def create(*args, **kwargs): + window = original(*args, **kwargs) + api = kwargs["js_api"] + + def verify(): + try: + deadline = time.monotonic() + 20 + while time.monotonic() < deadline: + if window.evaluate_js( + "document.querySelector('#connection').textContent==='Sesión local'" + ): + break + time.sleep(0.1) + else: + raise AssertionError("WebView bridge timeout") + payload = api.bootstrap() + assert payload["ok"], payload + assert payload["launcher"] == launcher + if launcher == "lanwire": + result = api.wire_create( + {"prefix": "WL", "kind": "wire.copper", "name": "Cable nativo"} + ) + assert result["ok"], result + row = next(x for x in api.bootstrap()["records"] if x["id"] == result["id"]) + assert api.wire_connect( + row["id"], row["revision"], [{"device": switch, "port": "X1"}] + )["ok"] + elif launcher == "lanrack": + assert payload["records"][0]["occupants"][0]["unit"] == 18 + elif launcher == "lanaccess": + assert api.access_set( + device.device_id, "ssh", "native", "native-secret", "native-secret" + )["ok"] + assert "native-secret" not in str(api.bootstrap()) + else: + assert payload["session"] is None + assert api.monitor_samples(device.device_id)["ok"] + outcome.append( + "PASS: " + + launcher + + " native bridge, real services, project context and close" + ) + except Exception as error: + outcome.append("FAIL: " + launcher + " " + str(error)) + finally: + api._closing = True + window.destroy() + + window.events.loaded += verify + return window + + webview.create_window = create + result = importlib.import_module(modules[launcher]).main(["--gui"]) + print("\n".join(outcome)) + return result or (0 if outcome and outcome[0].startswith("PASS") else 1) + + +if __name__ == "__main__": + raise SystemExit(main(sys.argv[1])) diff --git a/tests/launcher_suite_native_smoke.py b/tests/launcher_suite_native_smoke.py new file mode 100644 index 0000000..1cda46d --- /dev/null +++ b/tests/launcher_suite_native_smoke.py @@ -0,0 +1,182 @@ +"""Windows native GUI coordination smoke, isolated from the user's data. + +Run explicitly: python tests/launcher_suite_native_smoke.py +Creates and closes only its own LANCTL and specialized test windows. +""" + +import ctypes +import os +import subprocess +import tempfile +import time +from ctypes import wintypes +from pathlib import Path +from threading import Event, Thread + + +def wait_for(check, timeout=20): + deadline = time.monotonic() + timeout + while time.monotonic() < deadline: + value = check() + if value: + return value + time.sleep(0.1) + raise AssertionError("Native GUI check timed out") + + +def window_for_process(pid): + user32 = ctypes.windll.user32 + matches = [] + callback = ctypes.WINFUNCTYPE(wintypes.BOOL, wintypes.HWND, wintypes.LPARAM) + + def visit(handle, _): + owner = wintypes.DWORD() + user32.GetWindowThreadProcessId(handle, ctypes.byref(owner)) + if owner.value == pid and user32.IsWindowVisible(handle): + matches.append(handle) + return True + + user32.EnumWindows(callback(visit), 0) + return matches[0] if matches else None + + +def main(): + if os.name != "nt": + print("This smoke requires a Windows desktop session") + return 2 + with tempfile.TemporaryDirectory(prefix="lanctl-coordination-smoke-") as directory: + os.environ["LANCTL_DATA_DIR"] = directory + from lanctl.core.file_transaction import atomic_write_text + + atomic_write_text(Path(directory) / "config/migration-v2.complete", "LANCTL-DATA-V2\n") + from lanctl.core.config import load_config, save_config + from lanctl.core.data_migration import ensure_data_layout + + ensure_data_layout() + config = load_config() + config.update( + pluginSafeMode=True, + closeGuiOnLaunch=False, + startupInterface="gui", + projectsDirectory=str(Path(directory) / "projects-test"), + ) + save_config(config) + import webview + + from lanctl.bootstrap.lanctl import main as launch + from lanctl.core.coordination import Coordinator + + coordinator = Coordinator() + original = webview.create_window + outcome = [] + children = [] + verified = Event() + popen = subprocess.Popen + + def track(*args, **kwargs): + process = popen(*args, **kwargs) + children.append(process) + return process + + def create(*args, **kwargs): + window = original(*args, **kwargs) + api = kwargs["js_api"] + closed = Event() + window.events.closed += closed.set + + def verify(): + handle = None + try: + print("BOOTSTRAP", api.bootstrap().get("error", "OK"), flush=True) + wait_for( + lambda: window.evaluate_js( + "Boolean(document.querySelector('#version').textContent)" + ) + ) + handles = [] + for launcher in ("lanwire", "lanrack", "lanaccess", "lanmon"): + print("CLICK", launcher, flush=True) + window.evaluate_js( + "document.querySelector('[data-launch=\"" + launcher + "\"]').click()" + ) + child = wait_for( + lambda: next( + ( + s + for s in coordinator.sessions() + if s["launcher"] == launcher and s["controls"] + ), + None, + ), + timeout=25, + ) + print("READY", launcher, child["pid"], flush=True) + handle = wait_for(lambda: window_for_process(child["pid"])) + handles.append(handle) + print( + "HANDLE", + handle, + "STATUS", + window.evaluate_js("document.querySelector('#status').textContent"), + flush=True, + ) + wait_for( + lambda: window.evaluate_js( + "activity.some(text=>text.includes('GUI de " + + launcher.upper() + + " abierta'))" + ) + ) + assert {s["launcher"] for s in coordinator.sessions()} == { + "lanctl", + "lanwire", + "lanrack", + "lanaccess", + "lanmon", + } + for child_handle in handles: + ctypes.windll.user32.PostMessageW(wintypes.HWND(child_handle), 0x10, 0, 0) + wait_for(lambda: len(coordinator.sessions()) == 1, timeout=25) + outcome.append( + "PASS: all four LANCTL buttons open real simultaneous GUIs, ready IPC and clean native close" + ) + except Exception as error: + print( + "SESSIONS", + coordinator.sessions(), + "STATUS", + window.evaluate_js("document.querySelector('#status').textContent"), + "CHILDREN", + [(p.pid, p.poll()) for p in children], + flush=True, + ) + outcome.append(f"FAIL: {type(error).__name__}: {error}") + finally: + if handle: + ctypes.windll.user32.PostMessageW(wintypes.HWND(handle), 0x10, 0, 0) + if not closed.is_set(): + api._desktop._closing = True + window.destroy() + verified.set() + + window.events.loaded += lambda: Thread(target=verify, daemon=True).start() + return window + + webview.create_window = create + # Track only children spawned during this isolated test for bounded cleanup. + subprocess.Popen = track + try: + launch([]) + assert verified.wait(30), "GUI verification did not finish" + finally: + subprocess.Popen = popen + for process in children: + if process.poll() is None: + process.terminate() + process.wait(timeout=10) + print("\n".join(outcome)) + return 0 if outcome and outcome[0].startswith("PASS") else 1 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/tests/portable_smoke.py b/tests/portable_smoke.py new file mode 100644 index 0000000..feffff9 --- /dev/null +++ b/tests/portable_smoke.py @@ -0,0 +1,137 @@ +"""Explicit Windows portable smoke for freshly built, isolated executables. + +Usage: python tests/portable_smoke.py PATH_TO_TEST_BUILD +Writes test data only under PATH_TO_TEST_BUILD/data/lanctl. +""" + +import ctypes +import os +import subprocess +import sys +from ctypes import wintypes +from pathlib import Path + +from gui_coordination_smoke import wait_for, window_for_process + + +def main(directory): + from lanctl import __version__ + + root = Path(directory).resolve() + (root / "LANCTL.portable").write_text("LANCTL-PORTABLE-V1\n", encoding="ascii") + data = root / "data/lanctl" + os.environ["LANCTL_DATA_DIR"] = str(data) + from lanctl.core.file_transaction import atomic_write_text + + atomic_write_text(data / "config/migration-v2.complete", "LANCTL-DATA-V2\n") + from lanctl.core.config import load_config, save_config + from lanctl.core.coordination import Coordinator + from lanctl.core.data_migration import ensure_data_layout + + ensure_data_layout() + config = load_config() + config.update(pluginSafeMode=True, projectsDirectory=str(data / "test-projects")) + save_config(config) + env = dict(os.environ) + env.pop("LANCTL_DATA_DIR", None) # Exercise real portable path resolution. + env.pop("LANCTL_SECRET_DIR", None) + options = dict(env=env, cwd=root, creationflags=subprocess.CREATE_NO_WINDOW) + + def run(launcher, *args, stdin=None): + result = subprocess.run( + [str(root / f"{launcher}.exe"), *args], + input=stdin, + text=True, + encoding="utf-8", + errors="replace", + capture_output=True, + timeout=45, + **options, + ) + assert result.returncode == 0, (launcher, args, result.stdout, result.stderr) + return result.stdout + + for name in ("LANCTL", "lanip", "lanwire", "lanrack", "lanaccess", "lanmon"): + assert __version__ in run(name, "--version") + for mode in ("cli", "tui", "gui"): + run("LANCTL", "settings", "--startup-interface", mode, "--close-gui-on-launch", "off") + assert f'"{mode}"' in run("LANCTL", "settings", "--get", "startup.interface") + assert "LANCTL" in run("LANCTL", "--cli", stdin="exit\n") + if mode != "gui": + assert "LANCTL" in run("LANCTL", stdin="exit\n") + children, logs = [], [] + coordinator = Coordinator() + + def start(name, *args): + log = (root / f"smoke-{len(children)}.log").open("wb") + logs.append(log) + process = subprocess.Popen( + [str(root / f"{name}.exe"), *args], stdout=log, stderr=subprocess.STDOUT, **options + ) + children.append(process) + return process + + def close(launcher): + for session in coordinator.sessions(): + if session["launcher"] == launcher and (handle := window_for_process(session["pid"])): + ctypes.windll.user32.PostMessageW(wintypes.HWND(handle), 0x10, 0, 0) + + try: + # Simultaneous no-argument invocations exercise the executable's GUI preference and lock. + start("LANCTL") + start("LANCTL") + wait_for( + lambda: ( + len( + [ + s + for s in coordinator.sessions() + if s["launcher"] == "lanctl" and s["controls"] + ] + ) + == 1 + ), + 40, + ) + wait_for(lambda: sum(p.poll() is not None for p in children) == 1, 40) + assert [p.returncode for p in children if p.poll() is not None] == [0] + first = next(s for s in coordinator.sessions() if s["launcher"] == "lanctl") + handle = wait_for(lambda: window_for_process(first["pid"])) + ctypes.windll.user32.ShowWindow(wintypes.HWND(handle), 6) + wait_for(lambda: ctypes.windll.user32.IsIconic(wintypes.HWND(handle))) + run("LANCTL") + wait_for(lambda: not ctypes.windll.user32.IsIconic(wintypes.HWND(handle))) + child = start("lanip", "--gui") + wait_for( + lambda: any(s["launcher"] == "lanip" and s["controls"] for s in coordinator.sessions()), + 40, + ) + assert {s["launcher"] for s in coordinator.sessions()} == {"lanctl", "lanip"} + close("lanctl") + wait_for(lambda: all(s["launcher"] != "lanctl" for s in coordinator.sessions())) + assert child.poll() is None + close("lanip") + wait_for(lambda: not coordinator.sessions()) + print( + "PASS: six portable launchers, CLI/TUI/GUI preference, explicit CLI override, concurrent GUI lock, restore, independent close" + ) + except Exception: + for path in sorted(root.glob("smoke-*.log")): + print(f"\n--- {path.name} ---", flush=True) + print(path.read_text(encoding="utf-8", errors="replace")[-12000:], flush=True) + raise + finally: + close("lanctl") + close("lanip") + for process in children: + try: + process.wait(timeout=10) + except subprocess.TimeoutExpired: + process.terminate() + process.wait(timeout=10) + for log in logs: + log.close() + + +if __name__ == "__main__": + main(sys.argv[1]) diff --git a/tests/test_access.py b/tests/test_access.py index 8c78cd2..bf7f780 100644 --- a/tests/test_access.py +++ b/tests/test_access.py @@ -456,11 +456,13 @@ def execute(self, user, command): break time.sleep(0.01) client = paramiko.SSHClient() - client.set_missing_host_key_policy(paramiko.AutoAddPolicy()) + port = server.socket.getsockname()[1] + expected_key = paramiko.Ed25519Key.from_private_key_file(str(host_key)) + client.get_host_keys().add(f"[127.0.0.1]:{port}", expected_key.get_name(), expected_key) try: client.connect( "127.0.0.1", - port=server.socket.getsockname()[1], + port=port, username="operator", password="another-strong-password", allow_agent=False, @@ -517,7 +519,10 @@ def execute(self, user, command): def request(index): client = paramiko.SSHClient() - client.set_missing_host_key_policy(paramiko.AutoAddPolicy()) + expected_key = paramiko.Ed25519Key.from_private_key_file(str(host_key)) + client.get_host_keys().add( + f"[127.0.0.1]:{port}", expected_key.get_name(), expected_key + ) try: client.connect( "127.0.0.1", diff --git a/tests/test_access_cli_output.py b/tests/test_access_cli_output.py new file mode 100644 index 0000000..8442248 --- /dev/null +++ b/tests/test_access_cli_output.py @@ -0,0 +1,64 @@ +"""Remote-user CLI output must not turn stored authenticators into console logs.""" + +import argparse +import json +from dataclasses import asdict, make_dataclass + +import pytest + +from lanctl.apps.access.auth import AuthenticationService, verify_password +from lanctl.apps.access.store import AccessStore +from lanctl.apps.ip.interfaces.cli.commands import access + + +@pytest.mark.parametrize("with_password", [True, False]) +def test_user_add_keeps_metadata_but_never_prints_authenticator( + tmp_path, monkeypatch, capsys, with_password +): + monkeypatch.setenv("LANCTL_DATA_DIR", str(tmp_path)) + monkeypatch.setenv("LANCTL_DATA_SCOPE", "user") + users_path = tmp_path / "users.dc" + monkeypatch.setattr( + access, + "load_config", + lambda: {"accessConfig": str(tmp_path / "config.json"), "accessUsers": str(users_path)}, + ) + password = "regression-password-for-CLI" + monkeypatch.setattr(access.getpass, "getpass", lambda _prompt: password) + public_key = tmp_path / "id_ed25519.pub" + public_key.write_text("ssh-ed25519 dGVzdC1rZXk= test-only", encoding="utf-8") + parser = argparse.ArgumentParser() + access.register_access_command(parser.add_subparsers()) + command = ["access", "user", "add", "operator", "--role", "operator", "--json"] + command += ["--password-auth", "on"] if with_password else ["--ssh-key", str(public_key)] + args = parser.parse_args(command) + + assert args.handler(args) == 0 + + captured = capsys.readouterr() + payload = json.loads(captured.out) + user = AuthenticationService(AccessStore(users_path)).user("operator") + assert password not in captured.out + captured.err + assert not user.passwordHash or user.passwordHash not in captured.out + captured.err + # Keep the existing JSON key and type for compatibility, always redacted. + assert payload["passwordHash"] == "" + assert payload["passwordConfigured"] is with_password + for name, value in asdict(user).items(): + if name != "passwordHash": + assert payload[name] == value + if with_password: + assert verify_password(password, user.passwordHash) + + +def test_user_output_does_not_serialize_future_private_fields(tmp_path, monkeypatch): + monkeypatch.setenv("LANCTL_DATA_DIR", str(tmp_path)) + user = AuthenticationService(AccessStore(tmp_path / "users.dc")).add_user( + "operator", password="regression-password-for-CLI" + ) + extended_user = make_dataclass("ExtendedUser", [("privateToken", str, "")], bases=(type(user),)) + user = extended_user(**asdict(user), privateToken="future-private-value") + + payload = access._public_user(user) + + assert "privateToken" not in payload + assert "future-private-value" not in json.dumps(payload) diff --git a/tests/test_activity.py b/tests/test_activity.py new file mode 100644 index 0000000..d5c1d0b --- /dev/null +++ b/tests/test_activity.py @@ -0,0 +1,98 @@ +import pytest + +from lanctl.core.activity import ActivityStore +from lanctl.core.coordination import Coordinator + + +def test_two_independent_stores_filter_sessions_projects_and_keep_closed_history(tmp_path): + c = Coordinator() + a = c.register("lanctl", "gui", "a.vlf") + b = c.register("lanip", "gui", "b.vlf") + path = tmp_path / "activity.db" + one, two = ActivityStore(path), ActivityStore(path) + first = one.append("uno", launcher="lanctl", session=a, project="a.vlf") + second = two.append("dos", launcher="lanip", session=b, project="b.vlf") + assert two.query(session=a) == [first] + assert one.query(project="b.vlf") == [second] + assert one.query(after=first["seq"]) == [second] + c.close(a) + assert two.query(session=a) == [first] + with pytest.raises(ValueError, match="vigentes"): + one.append("closed", launcher="lanctl", session=a, project="a.vlf") + two.owner = "another-user" + assert two.query() == [] + + +def test_mismatched_context_and_oversize_refused(tmp_path): + c = Coordinator() + sid = c.register("lanctl", "gui", "a.vlf") + store = ActivityStore(tmp_path / "activity.db") + with pytest.raises(ValueError): + store.append("x", launcher="lanip", session=sid, project="a.vlf") + with pytest.raises(ValueError): + store.append("x", launcher="lanctl", session=sid, project="b.vlf") + with pytest.raises(ValueError): + store.append("x" * 4097, launcher="lanctl", session=sid, project="a.vlf") + assert store.query() == [] + + +def test_retention_and_controls(tmp_path, monkeypatch): + monkeypatch.setattr("lanctl.core.activity.RETENTION", 2) + sid = Coordinator().register("lanctl", "gui") + store = ActivityStore(tmp_path / "activity.db") + for text in ("old", "a\nb\x07", "last"): + store.append(text, launcher="lanctl", session=sid) + assert [r["message"] for r in store.query()] == ["a b", "last"] + + +def test_read_does_not_create_storage(tmp_path): + path = tmp_path / "not-created" / "activity.db" + assert ActivityStore(path).query() == [] + assert not path.parent.exists() + + +def test_recent_and_projectless_filters(tmp_path): + c = Coordinator() + sid = c.register("lanctl", "gui") + other = c.register("lanip", "gui", "project.vlf") + store = ActivityStore(tmp_path / "activity.db") + for i in range(5): + store.append(str(i), launcher="lanctl", session=sid) + store.append("other", launcher="lanip", session=other, project="project.vlf") + assert [r["message"] for r in store.query(limit=2, latest=True, project="")] == ["3", "4"] + assert store.query(limit=1, latest=True)[0]["message"] == "other" + + +def test_activity_written_by_independent_process_survives_session_close(tmp_path): + import os + import subprocess + import sys + from pathlib import Path + + path = tmp_path / "activity.db" + coordinator = Coordinator() + script = """ +import sys +from pathlib import Path +from lanctl.core import coordination +from lanctl.core.activity import ActivityStore +coordination.coordinator_path=lambda:Path(sys.argv[1]) +c=coordination.Coordinator() +sid=c.register('lanctl','gui','project.vlf') +ActivityStore(sys.argv[2]).append('from child',launcher='lanctl',session=sid,project='project.vlf') +c.close(sid) +""" + env = { + **os.environ, + "PYTHONPATH": str(Path(__file__).resolve().parents[1] / "src"), + "LANCTL_DATA_DIR": str(tmp_path), + } + subprocess.run( + [sys.executable, "-c", script, str(coordinator.path), str(path)], + env=env, + check=True, + capture_output=True, + timeout=15, + ) + rows = ActivityStore(path).query(project="project.vlf") + assert len(rows) == 1 and rows[0]["message"] == "from child" diff --git a/tests/test_atomic_element.py b/tests/test_atomic_element.py index de01872..5d261cd 100644 --- a/tests/test_atomic_element.py +++ b/tests/test_atomic_element.py @@ -37,10 +37,8 @@ def stores(tmp_path: Path) -> tuple[DeviceDatabase, GroupDatabase]: def test_chained_element_validation_is_all_or_nothing(tmp_path: Path) -> None: database, groups = stores(tmp_path) - with pytest.raises(ValueError, match="42 caracteres"): - groups.edit_device_fields( - "OLD", [("name", "Nuevo"), ("description", "x" * 43), ("group", "LAB")] - ) + with pytest.raises(ValueError, match="IPv4"): + groups.edit_device_fields("OLD", [("name", "Nuevo"), ("ip", "invalid"), ("group", "LAB")]) device = database.resolve("OLD") assert device.name == "Old name" diff --git a/tests/test_backlog_plugins.py b/tests/test_backlog_plugins.py new file mode 100644 index 0000000..d46ab03 --- /dev/null +++ b/tests/test_backlog_plugins.py @@ -0,0 +1,139 @@ +import json +from threading import RLock +from types import SimpleNamespace +from unittest.mock import Mock + +import pytest +from cryptography.hazmat.primitives import serialization +from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PrivateKey + +from lanctl.apps.suite.gui import SuiteApi +from lanctl.core.plugins.manager import PluginManager +from lanctl.core.plugins.models import PluginState +from lanctl.core.plugins.package import build_package + + +@pytest.fixture +def installed(tmp_path, monkeypatch): + source = tmp_path / "source" + source.mkdir() + (source / "plugin.info").write_text( + json.dumps( + { + "schemaVersion": 1, + "id": "demo.trust-test", + "name": "Trust test", + "version": "1.0.0", + "entryPoint": "main.exec", + "runtime": "trusted", + "permissions": ["theme.register"], + "capabilities": ["theme"], + "lanctl": {"minimumVersion": "0.3.0", "maximumVersion": "0.x"}, + } + ), + encoding="utf-8", + ) + (source / "main.exec").write_text("def activate(api):\n api.log('ACTIVATE')\n") + key = tmp_path / "key.pem" + key.write_bytes( + Ed25519PrivateKey.generate().private_bytes( + serialization.Encoding.PEM, + serialization.PrivateFormat.PKCS8, + serialization.NoEncryption(), + ) + ) + package = tmp_path / "signed.lcp" + build_package(source, package, signing_key=key) + manager = PluginManager(tmp_path / "plugins", tmp_path / "registry.json") + manager.install(package) + api = SuiteApi.__new__(SuiteApi) + api._lock = RLock() + api._desktop = SimpleNamespace(_window=Mock()) + monkeypatch.setattr("lanctl.apps.suite.gui.get_plugin_manager", lambda: manager) + return api, manager, package + + +def test_signed_plugin_gui_requires_publisher_then_permissions_and_preserves_revoke(installed): + api, manager, package = installed + plugin_id = "demo.trust-test" + assert not api.set_plugin_enabled(plugin_id, True, ["theme.register"], True)["ok"] + api._desktop._window.create_file_dialog.return_value = [str(package)] + result = api.trust_plugin_publisher(plugin_id) + assert result["ok"], result + assert next(p for p in result["plugins"] if p["id"] == plugin_id)["publisherTrusted"] + assert api.set_plugin_enabled(plugin_id, True, ["theme.register"], True)["ok"] + assert manager.get(plugin_id).state == PluginState.ENABLED + assert api.set_plugin_enabled(plugin_id, False)["ok"] + manager.publishers.revoke(manager.get(plugin_id).signature.split(":", 1)[1]) + assert not api.set_plugin_enabled(plugin_id, True, ["theme.register"], True)["ok"] + + +def test_publisher_dialog_cancel_or_wrong_package_never_grants_trust(installed): + api, manager, package = installed + api._desktop._window.create_file_dialog.return_value = None + assert api.trust_plugin_publisher("demo.trust-test")["cancelled"] + api._desktop._window.create_file_dialog.return_value = [str(package)] + assert not api.trust_plugin_publisher("lanctl.network.wol")["ok"] + assert not manager.publishers.is_trusted(manager.get("demo.trust-test").signature) + assert not api.set_plugin_enabled( + "lanctl.network.wol", + True, + ["network.udp", "functions.register", "ui-action.register"], + True, + )["ok"] + + +def test_configuration_visibility_uses_schema_not_saved_file_and_refreshes(installed): + api, manager, _ = installed + plugin = manager.get("demo.trust-test") + # Test the in-memory fallback for a caller without a package directory. + plugin.path = plugin.path.parent / "not-materialized" + assert api._configuration_status(plugin) == {"hasSettings": False, "settingsError": ""} + plugin.manifest.raw["settingsSchema"] = { + "schemaVersion": 1, + "fields": [{"name": "test", "type": "text", "default": "value"}], + } + assert api._configuration_status(plugin)["hasSettings"] + assert api.plugin_settings(plugin.manifest.plugin_id)["values"] == {"test": "value"} + assert not (plugin.path.parent / ".settings").exists() + plugin.manifest.raw["settingsSchema"]["fields"] = [] + assert not api._configuration_status(plugin)["hasSettings"] + plugin.manifest.raw["settingsSchema"] = {"schemaVersion": 100} + status = api._configuration_status(plugin) + assert not status["hasSettings"] and status["settingsError"] + + +def test_existing_gui_reads_configuration_schema_after_external_package_update(installed): + api, manager, _ = installed + plugin = manager.get("demo.trust-test") + assert not api._configuration_status(plugin)["hasSettings"] + path = plugin.path / "plugin.info" + current = json.loads(path.read_text(encoding="utf-8")) + current["settingsSchema"] = { + "schemaVersion": 1, + "fields": [{"name": "label", "type": "text", "default": "Updated"}], + } + path.write_text(json.dumps(current), encoding="utf-8") + assert "settingsSchema" not in plugin.manifest.raw + assert api._configuration_status(plugin)["hasSettings"] + assert api.plugin_settings(plugin.manifest.plugin_id)["values"] == {"label": "Updated"} + current["settingsSchema"]["fields"] = [] + path.write_text(json.dumps(current), encoding="utf-8") + assert not api._configuration_status(plugin)["hasSettings"] + path.write_text("[]", encoding="utf-8") + status = api._configuration_status(plugin) + assert not status["hasSettings"] and status["settingsError"] + + +def test_same_content_signed_by_another_publisher_does_not_grant_trust(installed, monkeypatch): + from lanctl.core.plugins.package import verify_package + + api, manager, package = installed + result = verify_package(package) + result["signature"] = "VALID_ED25519:different-publisher" + monkeypatch.setattr("lanctl.core.plugins.package.verify_package", lambda _: result) + grant = Mock() + monkeypatch.setattr(manager.publishers, "trust_package", grant) + api._desktop._window.create_file_dialog.return_value = [str(package)] + assert not api.trust_plugin_publisher("demo.trust-test")["ok"] + grant.assert_not_called() diff --git a/tests/test_backlog_projects.py b/tests/test_backlog_projects.py new file mode 100644 index 0000000..a4f0fba --- /dev/null +++ b/tests/test_backlog_projects.py @@ -0,0 +1,254 @@ +import zipfile +from types import SimpleNamespace +from unittest.mock import Mock, patch + +import pytest + +from lanctl.apps.ip.interfaces.tui.main import LanctlTui +from lanctl.apps.ip.interfaces.tui.modal import ModalState, SettingField +from lanctl.core.projects.metadata import FIELDS, read_metadata, update_metadata +from lanctl.core.projects.vlf import create_project, inspect_project, update_project, verify_project + + +@pytest.fixture +def project(tmp_path, monkeypatch): + from lanctl.core import config + from lanctl.core.projects import catalog + + monkeypatch.setattr(config, "CONFIG_PATH", tmp_path / "config.json") + monkeypatch.setattr(catalog, "default_catalog_path", lambda: tmp_path / "projects.db") + settings = { + "database": str(tmp_path / "devices.json"), + "groups": str(tmp_path / "groups.json"), + "credentials": str(tmp_path / "credentials"), + "range": "192.0.2.0/24", + } + path = tmp_path / "demo.vlf" + create_project(path, config=settings, name="Original") + return path, settings + + +def test_metadata_roundtrip_preserves_identity_inventory_and_future_save(project): + from lanctl.core.projects.catalog import ProjectCatalog + + path, settings = project + original = inspect_project(path) + with zipfile.ZipFile(path) as archive: + inventory = archive.read("devices/elements.db") + data = read_metadata(path) + values = {key: f"Valor {label}" for key, label, *_ in FIELDS} + saved = update_metadata(path, values, data["revision"]) + assert saved["values"] == values + assert saved["revision"] != data["revision"] + assert inspect_project(path)["id"] == original["id"] + assert ProjectCatalog().list(path.parent)[0].name == values["name"] + verify_project(path) + with zipfile.ZipFile(path) as archive: + assert archive.read("devices/elements.db") == inventory + update_project(path, config=settings) + verify_project(path) + assert read_metadata(path)["values"] == values + values["description"] = "" + update_metadata(path, values, read_metadata(path)["revision"]) + assert read_metadata(path)["values"]["description"] == "" + + +@pytest.mark.parametrize( + "change", + [{"name": " "}, {"author": 1}, {"company": "a" * 4097}, {"lan": "\x00"}, {"id": "replacement"}], +) +def test_invalid_metadata_never_changes_archive(project, change): + path, _ = project + snapshot = read_metadata(path) + before = path.read_bytes() + with pytest.raises(ValueError): + update_metadata(path, snapshot["values"] | change, snapshot["revision"]) + assert path.read_bytes() == before + + +def test_stale_metadata_edit_does_not_overwrite_other_window(project): + path, _ = project + snapshot = read_metadata(path) + update_metadata(path, snapshot["values"] | {"name": "Otra ventana"}, snapshot["revision"]) + before = path.read_bytes() + with pytest.raises(ValueError, match="otra ventana"): + update_metadata(path, snapshot["values"] | {"author": "Stale"}, snapshot["revision"]) + assert path.read_bytes() == before + + +def test_metadata_disk_failure_preserves_original(project): + path, _ = project + snapshot = read_metadata(path) + before = path.read_bytes() + with ( + patch("lanctl.core.projects.vlf.os.replace", side_effect=OSError("disk full")), + pytest.raises(OSError), + ): + update_metadata(path, snapshot["values"] | {"name": "New"}, snapshot["revision"]) + assert path.read_bytes() == before + verify_project(path) + + +def test_tui_metadata_form_saves_and_requires_discard_confirmation(project): + path, _ = project + tui = LanctlTui.__new__(LanctlTui) + tui._last_screen_lines = [] + tui.reload, tui.show_project_manager = Mock(), Mock() + tui._edit_project_from_manager(path) + assert len(tui.modal.items) == 7 + tui.modal.items[0].value = "Nueva oficina" + tui.handle_key("ESC") + tui.show_project_manager.assert_not_called() + tui.handle_key("CTRL_S") + assert read_metadata(path)["values"]["name"] == "Nueva oficina" + tui.reload.assert_called_once() + tui.show_project_manager.assert_called_once() + tui._edit_project_from_manager(path) + tui.modal.items[0].value = "Sin guardar" + tui.handle_key("ESC") + tui.handle_key("ESC") + assert tui.show_project_manager.call_count == 2 + assert read_metadata(path)["values"]["name"] == "Nueva oficina" + + +@pytest.mark.parametrize("kind", ["projects", "plugins", "help", "events"]) +@pytest.mark.parametrize("scanning", [True, False]) +def test_remapped_save_in_modals_and_during_background_tasks(kind, scanning): + tui = LanctlTui.__new__(LanctlTui) + tui.modal = ModalState(kind, kind, ["Main"], [[]]) + tui.key_bindings = {"save": "F4"} + tui.scanning = scanning + tui.messages = [] + tui._manual_save, tui._update_manager_detail = Mock(), Mock() + tui.handle_key("F4") + tui._manual_save.assert_called_once() + + +@pytest.mark.parametrize("reason", ["no-active-project", "failed"]) +def test_manual_save_missing_project_or_disk_failure_is_explicit(reason): + tui = LanctlTui.__new__(LanctlTui) + tui._set_terminal_message, tui.reload = Mock(), Mock() + with ( + patch("lanctl.apps.ip.interfaces.tui.main.load_config", return_value={}), + patch("lanctl.core.projects.save_policy.workspace_is_dirty", return_value=False), + patch( + "lanctl.core.projects.save_policy.save_active_project", + side_effect=OSError("disk full") if reason == "failed" else None, + return_value=SimpleNamespace(saved=False, reason=reason), + ), + ): + tui._manual_save() + assert ( + "No se pudo" if reason == "failed" else "No hay" + ) in tui._set_terminal_message.call_args.args[0] + tui.reload.assert_not_called() + + +def test_ctrl_s_saves_changed_settings_through_existing_command(): + tui = LanctlTui.__new__(LanctlTui) + field = SettingField("workers", "Workers", "--workers", "12", "8", "entero") + tui.modal = ModalState("settings", "Settings", ["General"], [[]], items=[field]) + tui._capture = Mock(return_value=(0, "Guardado")) + tui.reload, tui._set_command_output = Mock(), Mock() + tui.handle_key("CTRL_S") + tui._capture.assert_called_once_with(["settings", "--workers", "12"]) + assert tui.modal is None + + +def test_posix_ctrl_s_reaches_application_and_tty_restores_on_failure(monkeypatch): + from lanctl.apps.ip.interfaces.tui.keyboard import posix_terminal_mode + + termios = SimpleNamespace( + IXON=1, IXOFF=2, TCSADRAIN=1, tcgetattr=Mock(side_effect=[[7], [7]]), tcsetattr=Mock() + ) + tty = SimpleNamespace(setcbreak=Mock()) + monkeypatch.setitem(__import__("sys").modules, "termios", termios) + monkeypatch.setitem(__import__("sys").modules, "tty", tty) + with pytest.raises(RuntimeError), posix_terminal_mode(SimpleNamespace(fileno=lambda: 5)): + assert termios.tcsetattr.call_args.args[-1][0] == 4 + raise RuntimeError("render failed") + assert termios.tcsetattr.call_args.args == (5, 1, [7]) + + +def test_suite_metadata_api_keeps_validation_and_updates_catalog(project): + from threading import RLock + + from lanctl.apps.suite.gui import SuiteApi + + path, _ = project + api = SuiteApi.__new__(SuiteApi) + api._lock = RLock() + api._desktop = SimpleNamespace(_projects_payload=lambda: {"projects": []}) + data = api.project_metadata(str(path)) + assert data["ok"] + values = data["values"] | {"author": "Equipo"} + assert api.save_project_metadata(str(path), values, data["revision"])["ok"] + assert not api.save_project_metadata(str(path), values, data["revision"])["ok"] + assert read_metadata(path)["values"]["author"] == "Equipo" + + +@pytest.mark.parametrize("size", [(40, 12), (80, 24), (160, 50), (240, 70)]) +def test_project_form_keeps_last_field_visible_after_resize(size): + from rich.text import Text + + tui = LanctlTui.__new__(LanctlTui) + fields = [ + SettingField(key, label, "", "Dato", "", "Texto", "PROJECT") for key, label, *_ in FIELDS + ] + tui.modal = ModalState("project_edit", "Editar", ["Datos"], [[]], items=fields, selected=6) + tui.renderer = Mock() + tui._render_modal(*size) + body = tui.renderer.render_modal.call_args.kwargs["body"] + assert any("Responsable" in row for row in body) + assert all(Text.from_ansi(row).cell_len < size[0] for row in body) + + +def test_tui_output_and_command_history_have_bounded_retention(): + tui = LanctlTui.__new__(LanctlTui) + tui._set_command_output("\n".join(f"message-{i}" for i in range(2500)), 0) + assert len(tui.messages) == 2000 + assert tui.messages[0] == "message-500" and tui.messages[-1] == "message-2499" + tui.command_history = [f"old-{i}" for i in range(500)] + tui._clear_suggestions = Mock() + tui.command = "version" + tui.execute() + assert len(tui.command_history) == 500 + assert tui.command_history[0] == "old-1" and tui.command_history[-1] == "version" + + +def test_keyboard_conflicts_reserved_keys_disable_and_restore_are_persisted(project): + from lanctl.core.config import load_config + from lanctl.core.settings_catalog import set_program_value + + for key in ("F1", "ENTER", "ESC", "CTRL_C"): + with pytest.raises(ValueError): + set_program_value("tui.keyBindings.save", key) + assert load_config()["tuiKeyBindings"]["save"] == "CTRL_S" + set_program_value("tui.keyBindings.save", None) + assert load_config()["tuiKeyBindings"]["save"] is None + set_program_value("tui.keyBindings.save", "CTRL_S") + assert load_config()["tuiKeyBindings"]["save"] == "CTRL_S" + + +def test_metadata_edit_notifies_edited_project_instead_of_editors_active_project(project): + from lanctl.core.session import Session, bind_session + + path, _ = project + editor = Session("lanctl", "gui", {"activeProject": "other.vlf"}) + viewer = Session("lanip", "gui", {"activeProject": str(path)}) + for session in (editor, viewer): + session.stop_event.set() + session.thread.join() + received = [] + viewer.handler = received.append + try: + with bind_session(editor): + data = read_metadata(path) + update_metadata(path, data["values"] | {"author": "New"}, data["revision"]) + viewer.poll() + assert received == [{"action": "data-changed"}] + assert editor.project == "other.vlf" + assert viewer.project == str(path) + finally: + editor.close() + viewer.close() diff --git a/tests/test_backlog_startup.py b/tests/test_backlog_startup.py new file mode 100644 index 0000000..e77a18b --- /dev/null +++ b/tests/test_backlog_startup.py @@ -0,0 +1,121 @@ +import multiprocessing +from types import SimpleNamespace +from unittest.mock import Mock, patch + +import pytest + +from lanctl.core.coordination import Coordinator +from lanctl.core.gui_instance import GuiInstance +from lanctl.core.session import Session + + +@pytest.mark.parametrize("error", [ValueError("invalid config"), PermissionError("config denied")]) +def test_startup_configuration_failure_keeps_existing_error_boundary(error): + from lanctl.core.session import coordinated_launcher + + target = Mock() + entry = coordinated_launcher("lanctl")(target) + with ( + patch("lanctl.core.config.load_config", side_effect=error), + patch("lanctl.core.errors.errors.from_exception") as report, + ): + assert entry([]) == 2 + target.assert_not_called() + assert report.call_args.kwargs["origin"] == "LANCTL.Core.Coordination.Startup" + + +@pytest.mark.parametrize("preferred", ["cli", "tui", "gui"]) +@pytest.mark.parametrize("explicit", [False, True]) +def test_startup_preference_and_explicit_override(preferred, explicit): + from lanctl.bootstrap.lanctl import main + + with ( + patch("lanctl.core.config.load_config", return_value={"startupInterface": preferred}), + patch("lanctl.apps.suite.gui.run_gui", return_value=0) as gui, + patch("lanctl.apps.suite.interfaces.run_console", return_value=0) as console, + ): + assert main(["--cli"] if explicit else []) == 0 + if preferred == "gui" and not explicit: + gui.assert_called_once() + console.assert_not_called() + else: + console.assert_called_once_with(tui=preferred == "tui" and not explicit) + gui.assert_not_called() + + +def test_startup_preferences_persist_and_reject_invalid_values(tmp_path, monkeypatch): + from lanctl.core import config + from lanctl.core.settings_catalog import set_program_value + + monkeypatch.setattr(config, "CONFIG_PATH", tmp_path / "config.json") + set_program_value("startup.interface", "gui") + set_program_value("startup.closeGuiOnLaunch", True) + assert config.load_config()["startupInterface"] == "gui" + assert config.load_config()["closeGuiOnLaunch"] is True + before = config.CONFIG_PATH.read_bytes() + with pytest.raises(ValueError): + set_program_value("startup.interface", "unknown") + assert config.CONFIG_PATH.read_bytes() == before + + +def _gui_worker(path, started, closed, focus): + coordinator = Coordinator(path) + with GuiInstance("lanip", coordinator=coordinator) as primary: + assert primary + session = Session("lanip", "gui", {}, coordinator=coordinator) + session.handler = lambda _: focus.set() + coordinator.heartbeat(session.id, controls=True) + started.set() + try: + closed.wait(15) + finally: + session.close() + + +def test_single_gui_across_processes_other_launchers_and_crash_recovery(tmp_path): + context = multiprocessing.get_context("spawn") + started, closed, focused = (context.Event() for _ in range(3)) + coordinator = Coordinator(tmp_path / "runtime.db") + process = context.Process(target=_gui_worker, args=(coordinator.path, started, closed, focused)) + process.start() + try: + assert started.wait(10) + with GuiInstance("lanip", coordinator=coordinator) as primary: + assert not primary + assert focused.wait(2) + with GuiInstance("lanctl", coordinator=coordinator) as primary: + assert primary + process.terminate() + process.join(5) + with GuiInstance("lanip", coordinator=coordinator) as primary: + assert primary + finally: + if process.is_alive(): + closed.set() + process.join(3) + if process.is_alive(): + process.terminate() + process.join(5) + + +@pytest.mark.parametrize("close", [True, False]) +@pytest.mark.parametrize("failure", [False, True]) +def test_gui_launch_closes_only_after_ready_when_enabled(close, failure): + from lanctl.apps.suite.gui import SuiteApi + + api = SuiteApi.__new__(SuiteApi) + from threading import RLock + + api._lock = RLock() + api._desktop = SimpleNamespace(_window=Mock()) + with ( + patch("lanctl.apps.suite.gui.load_config", return_value={"closeGuiOnLaunch": close}), + patch("lanctl.apps.suite.gui.subprocess.Popen"), + patch( + "lanctl.core.gui_instance.focus_gui", + side_effect=TimeoutError("not ready") if failure else None, + ), + ): + result = api.launch_gui("lanip") + assert result["ok"] is not failure + assert api._desktop._window.destroy.called is (close and not failure) diff --git a/tests/test_cli.py b/tests/test_cli.py index e3b1014..cc1710f 100644 --- a/tests/test_cli.py +++ b/tests/test_cli.py @@ -503,8 +503,8 @@ def test_private_mac_has_explanatory_manufacturer(self): ) def test_device_description_limit(self): - with self.assertRaises(ValueError): - Device(ip="192.168.1.20", description="x" * 43) + device = Device(ip="192.168.1.20", description="x" * 10000) + self.assertEqual(len(device.description), 10000) def test_mac_with_hyphens_is_normalized(self): self.assertEqual( diff --git a/tests/test_clink_integration.py b/tests/test_clink_integration.py new file mode 100644 index 0000000..ca2bff2 --- /dev/null +++ b/tests/test_clink_integration.py @@ -0,0 +1,135 @@ +import locale +import os +import subprocess +import sys +from types import SimpleNamespace +from unittest.mock import Mock + +import pytest + +from lanctl.core import clink_integration as clink + +pytestmark = pytest.mark.skipif(os.name != "nt", reason="Windows Clink registration") + + +@pytest.fixture +def integration(tmp_path, monkeypatch): + scripts = tmp_path / "path with spaces" / "clink" + scripts.mkdir(parents=True) + (scripts / "lanctl.lua").write_text("--test") + monkeypatch.setenv("LOCALAPPDATA", str(tmp_path / "local")) + monkeypatch.setattr(clink, "principal_id", lambda: "actual-user") + monkeypatch.setattr(clink, "elevated", lambda: False) + monkeypatch.setattr(clink, "_find_clink", lambda **kw: "C:/Program Files/clink/clink_x64.exe") + run = Mock(return_value=SimpleNamespace(returncode=0)) + monkeypatch.setattr(clink.subprocess, "run", run) + return scripts, run + + +def test_register_update_unregister_exact_directory_without_shell(integration): + scripts, run = integration + assert clink.configure_clink("install", scripts)["status"] == "registered" + assert clink.configure_clink("install", scripts)["status"] == "registered" + assert clink.configure_clink("uninstall", scripts)["status"] == "unregistered" + assert run.call_args.args[0][-2:] == ["uninstallscripts", str(scripts)] + assert all(not call.kwargs.get("shell") for call in run.call_args_list) + assert clink.configure_clink("uninstall", scripts)["status"] == "not-registered-for-user" + assert run.call_count == 3 + + +def test_wrong_principal_and_elevated_install_never_mutate_registry(integration, monkeypatch): + scripts, run = integration + monkeypatch.setattr(clink, "elevated", lambda: True) + assert clink.configure_clink("install", scripts)["status"] == "normal-user-required" + run.assert_not_called() + monkeypatch.setattr(clink, "elevated", lambda: False) + clink.configure_clink("install", scripts) + monkeypatch.setattr(clink, "principal_id", lambda: "different-user") + with pytest.raises(ValueError): + clink.configure_clink("uninstall", scripts) + assert run.call_count == 1 + + +@pytest.mark.parametrize("action", ["install", "uninstall"]) +def test_native_code_one_is_idempotent_only_when_registry_matches(integration, action): + scripts, run = integration + clink.configure_clink("install", scripts) + run.reset_mock() + listing = str(scripts).upper() + "\n" if action == "install" else "C:\\Other\\scripts\n" + run.side_effect = [ + SimpleNamespace(returncode=1), + SimpleNamespace(returncode=0, stdout=listing), + ] + + result = clink.configure_clink(action, scripts) + + assert result["status"] == ("registered" if action == "install" else "unregistered") + assert run.call_args.args[0][-2:] == ["installscripts", "--list"] + assert clink._marker(scripts).exists() is (action == "install") + assert all(not call.kwargs.get("shell") for call in run.call_args_list) + + +@pytest.mark.parametrize("list_status", [0, 1]) +@pytest.mark.parametrize("action", ["install", "uninstall"]) +def test_code_one_does_not_hide_failed_registration_or_unregistration( + integration, action, list_status +): + scripts, run = integration + if action == "uninstall": + clink.configure_clink("install", scripts) + run.reset_mock() + # A prefix match is not evidence that this exact directory is registered. + listing = str(scripts) + ("-other\n" if action == "install" else "\n") + run.side_effect = [ + SimpleNamespace(returncode=1), + SimpleNamespace(returncode=list_status, stdout=listing), + ] + + with pytest.raises(OSError, match="Clink no pudo"): + clink.configure_clink(action, scripts) + + assert clink._marker(scripts).exists() is (action == "uninstall") + + +def test_registry_verification_timeout_preserves_error_cause(integration): + scripts, run = integration + timeout = clink.subprocess.TimeoutExpired(["clink", "installscripts", "--list"], 10) + run.side_effect = [SimpleNamespace(returncode=1), timeout] + + with pytest.raises(TimeoutError) as raised: + clink.configure_clink("install", scripts) + + assert raised.value.__cause__ is timeout + assert not clink._marker(scripts).exists() + + +def test_utf8_registration_path_ignores_windows_ansi_code_page(tmp_path, monkeypatch): + scripts = tmp_path / "completado con acento é" + scripts.mkdir() + (scripts / "lanctl.lua").write_text("--test") + producer = tmp_path / "fake_clink.py" + producer.write_text( + "import sys\n" + f"path = {str(scripts)!r}\n" + "if '--list' in sys.argv:\n" + " sys.stdout.buffer.write((path + '\\n').encode('utf-8'))\n" + "else:\n" + " sys.exit(1)\n", + encoding="utf-8", + ) + run = subprocess.run + + def native_output(command, **kwargs): + return run([sys.executable, str(producer), *command[1:]], **kwargs) + + monkeypatch.setenv("LOCALAPPDATA", str(tmp_path / "local")) + monkeypatch.setattr(clink, "principal_id", lambda: "actual-user") + monkeypatch.setattr(clink, "elevated", lambda: False) + monkeypatch.setattr(clink, "_find_clink", lambda **kw: "clink.exe") + monkeypatch.setattr(locale, "getpreferredencoding", lambda *args: "cp1252") + if hasattr(subprocess, "_text_encoding"): + monkeypatch.setattr(subprocess, "_text_encoding", lambda: "cp1252") + monkeypatch.setattr(subprocess, "run", native_output) + + assert clink.configure_clink("install", scripts)["status"] == "registered" + assert clink._marker(scripts).exists() diff --git a/tests/test_cpd_topology.py b/tests/test_cpd_topology.py new file mode 100644 index 0000000..065962a --- /dev/null +++ b/tests/test_cpd_topology.py @@ -0,0 +1,237 @@ +"""Regresiones del inventario CPD compartido y de su navegación gráfica.""" + +import json +import os +from pathlib import Path + +import pytest +from test_launcher_gui import api +from test_launcher_gui import workspace as workspace + +pytest_plugins = ["test_launcher_gui"] + + +def seed(labels="ABCDEFG"): + wire, rack = api("lanwire"), api("lanrack") + racks, switches = [], [] + for i, name in enumerate(labels): + racks.append( + wire.wire_create({"kind": "rack", "prefix": "RK", "name": "Rack " + name, "units": 48})[ + "id" + ] + ) + switches.append( + wire.wire_create( + { + "kind": "switch.48ports" if i == 0 else "switch.5ports", + "prefix": "SW", + "name": "Switch " + name, + } + )["id"] + ) + row = next(r for r in wire.bootstrap()["records"] if r["id"] == switches[-1]) + assert wire.wire_update(row["id"], row["revision"], {"rack": racks[-1], "unit": 10})["ok"] + cables = [] + # Ciclo y enlaces paralelos: no es un árbol. + for i in range(len(switches)): + cable = wire.wire_create( + {"kind": "wire.copper", "prefix": "WL", "name": "Interconexión de sala " + str(i)} + )["id"] + row = next(r for r in wire.bootstrap()["records"] if r["id"] == cable) + assert wire.wire_connect( + cable, + row["revision"], + [ + {"device": switches[i], "port": "X1"}, + {"device": switches[(i + 1) % len(switches)], "port": "X2"}, + ], + )["ok"] + cables.append(cable) + cable = wire.wire_create({"kind": "wire.copper", "prefix": "WL", "name": "Redundancia A B"})[ + "id" + ] + row = next(r for r in wire.bootstrap()["records"] if r["id"] == cable) + assert wire.wire_connect( + cable, + row["revision"], + [{"device": switches[0], "port": "X3"}, {"device": switches[1], "port": "X3"}], + )["ok"] + cables.append(cable) + return wire, rack, racks, switches, cables + + +def mutate(rack, operation, values): + return rack.rack_organization(rack.bootstrap()["organizationRevision"], operation, values) + + +def test_cpd_shared_moves_delete_and_stale_rejection(workspace): + wire, rack, racks, switches, cables = seed() + before = {r["id"]: r for r in wire.bootstrap()["records"] if r["id"] in switches + cables} + c1 = mutate(rack, "create", {"name": "Sala principal", "location": "Planta 1"})["id"] + c2 = mutate(rack, "create", {"name": "Sala principal"})["id"] + assert c1 != c2 + for r in racks: + assert mutate(rack, "assign", {"id": c1, "rack": r})["ok"] + snapshot = wire.bootstrap() + assert len(snapshot["cpds"]) == 2 + assert all(r["data"]["location"]["cpd"] == c1 for r in snapshot["records"] if r["id"] in racks) + stale = rack.bootstrap()["organizationRevision"] + assert mutate(rack, "assign", {"id": c2, "rack": racks[0]})["ok"] + assert not rack.rack_organization(stale, "edit", {"id": c1, "name": "Obsoleto"})["ok"] + assert mutate(rack, "delete", {"id": c1, "target": c2})["ok"] + assert all(r["location"]["cpd"] == c2 for r in rack.bootstrap()["records"]) + assert mutate(rack, "delete", {"id": c2})["ok"] + assert not rack.bootstrap()["cpds"] + assert all(not r["location"].get("cpd") for r in rack.bootstrap()["records"]) + after = {r["id"]: r for r in wire.bootstrap()["records"] if r["id"] in switches + cables} + assert before == after + assert not wire.rack_organization( + wire.bootstrap()["organizationRevision"], "create", {"name": "No"} + )["ok"] + + +def test_cpd_legacy_and_invalid_metadata_preserved(workspace): + wire, rack, racks, _, _ = seed() + path = Path(workspace["physicalDatabase"]) + document = json.loads(path.read_text()) + assert "cpdOrganization" not in document + assert rack.bootstrap()["cpds"] == [] + assert not mutate(rack, "create", {"name": " "})["ok"] + assert not mutate(rack, "assign", {"rack": racks[0], "id": "missing"})["ok"] + assert json.loads(path.read_text()) == document + document["cpdOrganization"] = {"schemaVersion": 99, "rooms": {}} + path.write_text(json.dumps(document)) + before = path.read_bytes() + assert not rack.bootstrap()["ok"] + assert not wire.bootstrap()["ok"] + assert path.read_bytes() == before + + +@pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) +def test_cpd_two_windows_topology_real_connections(workspace): + playwright = pytest.importorskip("playwright.sync_api").sync_playwright + wire, rack, racks, switches, _cables = seed() + room = mutate(rack, "create", {"name": "CPD Madrid", "description": "Sala A"})["id"] + for r in racks: + assert mutate(rack, "assign", {"id": room, "rack": r})["ok"] + root = Path(__file__).resolve().parents[1] + with playwright() as p: + browser = p.chromium.launch(channel="msedge", headless=True) + context = browser.new_context(viewport={"width": 1440, "height": 940}) + errors = [] + + def open_page(service): + page = context.new_page() + page.on("pageerror", lambda e: errors.append(str(e))) + page.expose_function("rpc", lambda method, args: getattr(service, method)(*args)) + page.goto((root / "gui/launcher.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,m)=>(...args)=>rpc(m,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + return page + + wp = open_page(wire) + rp = open_page(rack) + wp.locator("#wire-board").wait_for() + rp.get_by_role("heading", name="CPD Madrid", exact=True).wait_for() + assert rp.locator(".rack-cabinet").count() == 7 + assert wp.locator(".wire-node").count() == 7 # Los racks son contenedores. + assert wp.locator(".physical-region").count() == 7 + assert wp.locator("#wire-lines path").count() == 8 + wp.locator('[data-nav="fit"]').click() + # Un clic de puerto selecciona, sin sugerir conexiones. + wp.locator(f'[data-node="{switches[0]}"] [data-port="X1"]').click(force=True) + assert not wp.locator("#detail").is_visible() + assert wp.locator(f'[data-node="{switches[0]}"] .wire-ports').evaluate( + "e=>e.scrollHeight<=e.clientHeight" + ) + # El extremo coincide con el centro real del puerto tras cambiar zoom. + wp.locator('[data-nav="in"]').click() + delta = wp.evaluate( + """id=>{const e=wireGraph.edges.find(e=>e.a?.device===id),a=wireAnchor(e.a),port=document.querySelector('[data-node="'+id+'"] [data-port="'+e.a.port+'"]'),r=port.getBoundingClientRect(),w=document.querySelector('#wire-world').getBoundingClientRect();return Math.hypot(a.x-(r.x+r.width/2-w.x)/camera.z,a.y-(r.y+r.height/2-w.y)/camera.z)}""", + switches[0], + ) + assert delta < 0.01 + wp.locator('[data-level="outside"]').click() + assert wp.locator(".wire-node").count() == 7 + assert wp.locator("#wire-lines path").count() == 7 # Dos enlaces A-B agrupados. + assert "2 cables" in wp.locator("#wire-lines").text_content() + wp.locator("#physical-bundles").uncheck() + assert wp.locator("#wire-lines path").count() == 8 + wp.locator(f'[data-node="{racks[0]}"] strong').dblclick() + assert wp.locator("#physical-rack").input_value() == racks[0] + assert wp.locator(f'[data-node="{switches[0]}"]').count() == 1 + assert wp.locator("#wire-lines path").count() == 3 + # CPD creado desde LANRACK visible en LANWIRE al actualizar. + rp.locator("#rack-new-room").click() + rp.locator('[name="name"]').fill("CPD Barcelona") + rp.locator("#submit").click() + rp.wait_for_function("!document.querySelector('#detail').open") + second = next(c for c in rack.bootstrap()["cpds"] if c["name"] == "CPD Barcelona") + rp.locator(f'[data-rack-open="{racks[0]}"]').click() + rp.locator("#rack-assign").click() + rp.locator('[name="id"]').select_option(second["id"]) + rp.locator("#submit").click() + rp.wait_for_function("!document.querySelector('#detail').open") + wp.evaluate("refresh()") + wp.locator('[data-level="outside"]').click() + wp.locator("#physical-rack").select_option("") + assert "CPD Barcelona" in wp.locator(".physical-region").all_text_contents() + assert len(wire.bootstrap()["records"]) == 22 + wp.locator('[data-nav="fit"]').click() + assert wp.evaluate( + """()=>{const ns=[...document.querySelectorAll('[data-node]')].map(n=>n.getBoundingClientRect());return !ns.some((a,i)=>ns.some((b,j)=>j>i&&a.leftb.left&&a.topb.top));}""" + ) + assert wp.evaluate( + """()=>wireGraph.nodes.every(n=>{const group=physicalRegions.find(r=>r.id===(n.data.location?.cpd||'')),p=wirePositions[n.id],s=physicalSize(n);return group&&p.x>=group.x&&p.y>=group.y&&p.x+s.w<=group.x+group.w&&p.y+s.h<=group.y+group.h})""" + ) + wp.screenshot(path=str(root / "tmp/cpd-lanwire-general.png")) + rp.screenshot(path=str(root / "tmp/cpd-lanrack.png")) + for page in (wp, rp): + page.set_viewport_size({"width": 960, "height": 650}) + assert page.locator("footer").bounding_box()["y"] < 650 + assert page.evaluate("document.documentElement.scrollWidth<=innerWidth") + assert not errors, errors + browser.close() + + +@pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) +def test_cpd_large_mesh_layout(workspace): + playwright = pytest.importorskip("playwright.sync_api").sync_playwright + wire, rack, racks, _switches, _cables = seed([str(i) for i in range(24)]) + rooms = [mutate(rack, "create", {"name": "Sala " + str(i)})["id"] for i in range(3)] + for i, r in enumerate(racks): + assert mutate(rack, "assign", {"id": rooms[i % 3], "rack": r})["ok"] + with playwright() as p: + browser = p.chromium.launch(channel="msedge", headless=True) + page = browser.new_page(viewport={"width": 1440, "height": 940}) + failures = [] + page.on("pageerror", lambda e: failures.append(str(e))) + page.expose_function("rpc", lambda method, args: getattr(wire, method)(*args)) + page.goto((Path(__file__).resolve().parents[1] / "gui/launcher.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,m)=>(...args)=>rpc(m,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + page.locator("#wire-board").wait_for() + assert page.locator(".wire-node").count() == 24 + assert page.locator("#wire-lines path").count() == 25 + page.locator('[data-level="outside"]').click() + page.locator('[data-nav="fit"]').click() + assert page.locator(".physical-region").count() == 3 + assert page.locator(".wire-node").count() == 24 + assert page.locator("#wire-lines path").count() == 24 + assert page.evaluate( + """()=>{const ns=[...document.querySelectorAll('[data-node]')].map(n=>n.getBoundingClientRect());return !ns.some((a,i)=>ns.some((b,j)=>j>i&&a.leftb.left+.01&&a.topb.top+.01));}""" + ) + previous_camera = page.evaluate("({...camera})") + page.locator("#physical-cpd").select_option(rooms[0]) + # Los otros CPD permanecen como contexto de las salidas reales. + assert page.locator("#wire-lines path").count() >= 8 + page.locator("#physical-cpd").select_option("") + assert page.evaluate("({...camera})") == previous_camera + assert not failures, failures + browser.close() diff --git a/tests/test_desktop_browser.py b/tests/test_desktop_browser.py index bfbd089..18e719b 100644 --- a/tests/test_desktop_browser.py +++ b/tests/test_desktop_browser.py @@ -27,6 +27,16 @@ def test_desktop_browser_flows(tmp_path): bootstrap:async()=>({...inventory,theme:{},projects:[],icons:[],version:'test'}), project_state:async()=>({ok:true,dirty:false}), list_devices:async()=>inventory, + device_record:async()=>({ok:true,device,record:{...device,previousIPs:['192.0.2.20'],discoveryMethods:['ARP']}}), + get_device_details:async()=>({ok:true,device,diagnostic:{open_ports:[{port:443,service:'https',label:'HTTPS',interactive:true,evidence:'TLS'}]}}), + open_service:async(...args)=>{window.lastService=args;return {ok:true,message:'Acceso directo'};}, + scan_network:async()=>({...inventory,message:'Escaneo terminado'}), + scan_status:async()=>({ok:true,current:1,total:1}), + create_group:async(name,description)=>{window.lastGroup={name,description};return {...inventory,groupCatalog:[{name:name.toUpperCase(),description}],message:'Grupo creado'};}, + open_cli:async()=>{window.lanipCliOpened=true;return {ok:true,message:'CLI de LANIP abierto'};}, + open_suite:async()=>{window.suiteGuiOpened=true;return {ok:true,message:'LANCTL abierto'};}, + group_action:async(action,name)=>{if(action==='add')device.groups=[...new Set([...device.groups,name])];else device.groups=device.groups.filter(n=>n!==name);window.lastGroupAction={action,name};return inventory;}, + update_device:async(id,values)=>{window.lastUpdate={id,values};Object.assign(device,values);return {...inventory,message:'Elemento actualizado'};}, get_settings:async()=>({ok:true,fields:[{key:'workers',label:'Workers',value:64}]}), save_settings:async()=>({ok:true,message:'Configuración guardada correctamente'}), save_project:async()=>({...inventory,projects:[],message:'Proyecto guardado correctamente'}), @@ -35,6 +45,53 @@ def test_desktop_browser_flows(tmp_path): window.dispatchEvent(new Event('pywebviewready')); }""") page.get_by_role("cell", name="ROUTER", exact=True).wait_for() + assert page.locator(".main-navigation").is_hidden() + assert page.locator("#open-terminal").is_disabled() + assert page.locator("#show-shares").is_disabled() + assert page.locator("#open-device").is_enabled() + page.locator("#lanctl-gui").click() + page.wait_for_function("window.suiteGuiOpened") + page.locator("#new-group").click() + page.locator('input[name="name"]').fill("nuevo") + page.locator('input[name="description"]').fill("Grupo de prueba") + page.locator('#desktop-form button[type="submit"]').click() + page.wait_for_function("window.lastGroup?.name === 'nuevo'") + assert page.evaluate("window.lastGroup.description") == "Grupo de prueba" + assert page.locator('#group-filter option[value="NUEVO"]').count() == 1 + page.locator("#lanip-cli").click() + page.wait_for_function("window.lanipCliOpened") + page.locator("#advanced-filters summary").click() + page.locator("#vendor-filter").select_option("Example") + page.locator("#protocol-filter").select_option("https") + assert page.locator("#device-rows tr").count() == 1 + page.locator("#cnf-filter").select_option("X") + assert page.locator("#device-rows tr").count() == 0 + page.locator("#clear-filters").click() + assert page.locator("#device-rows tr").count() == 1 + page.locator("#advanced-filters summary").click() + assert page.locator('th[data-column="mac"]').is_hidden() + page.locator("#inventory-view").select_option("complete") + assert page.locator('th[data-column="mac"]').is_visible() + page.locator("#inventory-view").select_option("essential") + page.keyboard.press("Control+k") + assert page.locator("#device-search").evaluate("el => el === document.activeElement") + page.locator("#device-search").fill("does-not-exist") + assert page.locator("#device-rows tr").count() == 0 + assert page.locator("#save-device").is_disabled() + page.locator("#device-search").fill("") + assert page.locator("#save-device").is_enabled() + page.evaluate("applyTheme({id:'custom.palette',tokens:{'--color-accent':'#e0a0ff'}})") + assert ( + page.evaluate("document.documentElement.style.getPropertyValue('--color-accent')") + == "#e0a0ff" + ) + page.evaluate( + "applyTheme({id:'lanctl.theme.default.palette',tokens:{'--color-accent':'#25a9e8'}})" + ) + assert ( + page.evaluate("document.documentElement.style.getPropertyValue('--color-accent')") + == "#b2ef26" + ) page.locator("#state-filter").select_option("inactive") assert page.locator("#device-rows tr").count() == 0 page.locator("#state-filter").select_option("all") @@ -45,14 +102,47 @@ def test_desktop_browser_flows(tmp_path): page.get_by_text("Configuración guardada correctamente", exact=True).first.wait_for() page.keyboard.press("Control+s") page.get_by_text("Proyecto guardado correctamente", exact=True).first.wait_for() - page.get_by_role("cell", name="ROUTER", exact=True).click() + page.get_by_role("cell", name="ROUTER", exact=True).dblclick() + page.locator("#details-fields").get_by_text("Router de prueba", exact=True).wait_for() + page.locator("#tab-record").click() + assert "192.0.2.20" in page.locator("#sheet-record").inner_text() + page.locator("#tab-ports").click() + page.locator("#sheet-inspect").click() + page.locator("#details-services button").click() + assert page.evaluate("window.lastService") == ["test-1", "https", 443] + page.locator("#tab-edit").click() + assert page.locator("#edit-description").evaluate("el=>el.tagName") == "TEXTAREA" + assert page.locator("#edit-description").get_attribute("maxlength") is None + page.locator("#edit-name").fill("Nombre editado") + page.locator("#save-device").click() + page.get_by_text("Cambios guardados.", exact=True).wait_for() + assert page.evaluate("window.lastUpdate.values.name") == "Nombre editado" + assert page.evaluate("window.lastUpdate.values.ip") == "192.0.2.1" + page.locator("#edit-name").fill("Router de prueba") + page.locator("#save-device").click() + page.wait_for_function("window.lastUpdate.values.name === 'Router de prueba'") + page.locator("#tab-groups").click() + page.locator("#sheet-new-group-name").fill("INLINE") + page.locator("#sheet-new-group-description").fill("Creado en la ficha") + page.locator("#sheet-create-group").click() + page.wait_for_function("window.lastGroupAction?.name === 'INLINE'") + assert page.locator("dialog[open]").count() == 1 + page.locator("#tab-edit").click() page.locator("#edit-name").fill("Edición sin aplicar") page.evaluate("window.desktopDataChanged=true") page.wait_for_timeout(1200) assert page.locator("#edit-name").input_value() == "Edición sin aplicar" assert page.evaluate("window.desktopDataChanged") is True page.locator("#edit-name").fill("Router de prueba") + page.locator("#close-details").click() page.wait_for_function("window.desktopDataChanged === false") + page.on("dialog", lambda dialog: pytest.fail("El escaneo no debe pedir confirmación")) + page.locator("#scan-network").click() + page.get_by_text("Escaneo terminado", exact=True).first.wait_for() + assert ( + page.locator("#open-terminal").bounding_box()["y"] + > page.locator(".table-panel").bounding_box()["y"] + ) page.screenshot(path=str(tmp_path / "lanip-desktop.png"), full_page=True) page.locator("#project-new").click() page.locator("input[name=name]").fill("Prueba") @@ -61,5 +151,8 @@ def test_desktop_browser_flows(tmp_path): assert page.locator("#device-rows tr").count() == 0 page.set_viewport_size({"width": 960, "height": 640}) assert page.locator("#desktop-settings").is_visible() + for width, height in ((1280, 800), (960, 640), (760, 720), (390, 844)): + page.set_viewport_size({"width": width, "height": height}) + assert page.evaluate("document.documentElement.scrollWidth <= innerWidth") assert not errors browser.close() diff --git a/tests/test_desktop_gui.py b/tests/test_desktop_gui.py index a5126b4..0e65ee8 100644 --- a/tests/test_desktop_gui.py +++ b/tests/test_desktop_gui.py @@ -6,6 +6,137 @@ MODULE = "lanctl.apps.ip.interfaces.gui.desktop" +def test_long_device_description_roundtrips_through_edit_and_reload(tmp_path): + from lanctl.apps.ip.domain.models import Device + from lanctl.core.database import DeviceDatabase + from lanctl.core.group_database import GroupDatabase + + instance = api() + database = DeviceDatabase(str(tmp_path / "devices.json")) + device = Device(ip="192.0.2.10", mac="02:00:00:00:00:10", description="a" * 10000) + database.save_devices([device]) + groups = GroupDatabase(str(tmp_path / "groups.json"), database) + with ( + patch.object(instance, "_database", return_value=database), + patch.object(instance, "_groups", return_value=groups), + patch("lanctl.core.projects.save_policy.save_active_project"), + ): + result = instance.update_device(device.device_id, {"description": "Detalle\n" * 2000}) + assert result["ok"], result + assert database.resolve(device.device_id).description == ("Detalle\n" * 2000).strip() + + +def test_open_lanctl_gui_does_not_use_shell(): + with ( + patch("lanctl.apps.suite.processes.launcher_command", return_value=["lanctl", "--gui"]), + patch("lanctl.apps.suite.processes.process_options", return_value={}), + patch(f"{MODULE}.subprocess.Popen") as process, + ): + assert api().open_suite()["ok"] + assert process.call_args.args[0] == ["lanctl", "--gui"] + assert "shell" not in process.call_args.kwargs + + +def test_create_group_with_description_and_invalid_description_is_atomic(tmp_path): + from lanctl.core.database import DeviceDatabase + from lanctl.core.group_database import GroupDatabase + + instance = api() + devices = DeviceDatabase(str(tmp_path / "devices.json")) + groups = GroupDatabase(str(tmp_path / "groups.json"), devices) + with ( + patch.object(instance, "_database", return_value=devices), + patch.object(instance, "_groups", return_value=groups), + patch("lanctl.core.projects.save_policy.save_active_project"), + ): + result = instance.create_group("oficina", "Equipos de oficina") + assert result["ok"], result + assert any(group["name"] == "OFICINA" for group in result["groupCatalog"]) + assert ( + next(group for group in groups.load() if group.name == "OFICINA").description + == "Equipos de oficina" + ) + assert not instance.create_group("otro", "x" * 43)["ok"] + assert "OTRO" not in [group.name for group in groups.load()] + + +def test_lanip_cli_button_opens_lanip_not_suite(): + with patch("lanctl.apps.suite.processes.open_system_cli") as launch: + assert api().open_cli()["ok"] + launch.assert_called_once_with("lanip") + + +def test_settings_include_scan_retention_projects_and_logging_options(): + fields = api().get_settings()["fields"] + by_key = {field["key"]: field for field in fields} + assert { + "scanOrder", + "dhcpRange", + "disconnectedRetention", + "serviceIdentification", + "projectSaveIntervalMinutes", + "logRetentionDays", + } <= by_key.keys() + assert by_key["serviceIdentification"]["choices"] == ["on", "off"] + + +def test_complete_device_record_is_passive_and_redacts_secrets(tmp_path): + from lanctl.apps.ip.domain.models import Device + from lanctl.core.database import DeviceDatabase + + instance = api() + database = DeviceDatabase(str(tmp_path / "devices.json")) + device = Device.from_dict( + { + "IP": "192.0.2.1", + "MAC": "02:00:00:00:00:01", + "NAME": "Router", + "previousIPs": ["192.0.2.20"], + "discoveryMethods": ["ARP"], + "credentials": {"http": "private-reference"}, + "protocolOptions": {"http": {"password": "private-password", "port": 8080}}, + } + ) + database.save_devices([device]) + with ( + patch.object(instance, "_database", return_value=database), + patch.object(instance, "_diagnose") as diagnose, + ): + result = instance.device_record(device.device_id) + assert result["ok"] + assert result["record"]["previousIPs"] == ["192.0.2.20"] + assert "private-reference" not in str(result) + assert "private-password" not in str(result) + diagnose.assert_not_called() + + +def test_web_service_opens_directly_without_a_console(tmp_path): + from lanctl.apps.ip.domain.models import Device + from lanctl.core.database import DeviceDatabase + + instance = api() + database = DeviceDatabase(str(tmp_path / "devices.json")) + device = Device.from_dict( + {"IP": "192.0.2.1", "MAC": "02:00:00:00:00:01", "protocols": ["https"]} + ) + database.save_devices([device]) + with ( + patch.object(instance, "_database", return_value=database), + patch( + f"{MODULE}.load_config", + return_value={"database": str(database.path), "credentials": "store"}, + ), + patch( + "lanctl.apps.ip.interfaces.cli.commands.open.run_open", return_value=0 + ) as open_target, + patch(f"{MODULE}.subprocess.Popen") as process, + ): + assert instance.open_service(device.device_id, "https", 8443)["ok"] + assert open_target.call_args.args[0].port == 8443 + assert open_target.call_args.args[0].protocol == "https" + process.assert_not_called() + + def api(): with patch("lanctl.apps.ip.interfaces.gui.main.local_ipv4", return_value="127.0.0.1"): return DesktopApi() diff --git a/tests/test_diagnostics.py b/tests/test_diagnostics.py new file mode 100644 index 0000000..6a2bc61 --- /dev/null +++ b/tests/test_diagnostics.py @@ -0,0 +1,87 @@ +import json +from urllib.parse import parse_qs, urlparse + +import pytest + +from lanctl.apps.monitor.bug_reports import bug_report_url +from lanctl.core.diagnostics import diagnostic_markdown, export_diagnostic, prepare_diagnostic + + +@pytest.mark.parametrize("anonymize", [True, False]) +def test_credentials_removed_even_without_identity_anonymization(anonymize): + # Synthetic framing assembled at runtime; no PEM key is stored in the repository. + key_label = "PRIVATE KEY" + report = prepare_diagnostic( + anonymize=anonymize, + description='password="secret words" Bearer super-token https://admin:private@example.test/x', + logs=[ + '{"api_key":"secret-key"}', + f"-----BEGIN {key_label}-----\nPRIVATECONTENT\n-----END {key_label}-----", + ], + errors=[ + { + "origin": "LANCTL.Test.Demo", + "code": "FAILED", + "details": {"token": "nestedsecret", "password": "nestedpass"}, + } + ], + ) + text = json.dumps(report) + for secret in ( + "secret words", + "super-token", + "admin:private", + "secret-key", + "PRIVATECONTENT", + "nestedsecret", + "nestedpass", + ): + assert secret not in text + + +def test_anonymization_and_explicit_evidence_limits(): + report = prepare_diagnostic( + description=r"C:\Users\Victor\project.vlf /home/victor/a.vlf 192.168.1.7 aa:bb:cc:dd:ee:ff user@example.test 2001:db8::1", + logs=["line"] * 1000, + context={ + "project": "private-name", + "session": "session-id", + "vault": {"password": "secret"}, + }, + ) + assert len(report["logs"]) == 200 + assert report["context"] == {"project": "[PRIVATE]", "session": "session-id"} + assert all( + x not in report["description"] + for x in ("Victor", "victor", "192.168.1.7", "aa:bb", "user@", "2001:db8") + ) + + +def test_errors_grouped_without_combining_distinct_origins(): + a = {"origin": "LANCTL.Test.One", "code": "FAILED", "message": "x"} + b = {**a, "origin": "LANCTL.Test.Two"} + result = prepare_diagnostic(errors=[a, a, b]) + assert [r["count"] for r in result["errors"]] == [2, 1] + + +def test_export_rescrubs_edited_preview_and_url_is_bounded(tmp_path): + report = prepare_diagnostic(description="á" * 4096) + report["logs"] = ["password=after-preview-secret"] + report["description"] += " token=edited-secret" + path = tmp_path / "report.md" + assert export_diagnostic(report, path) == str(path.resolve()) + assert "after-preview-secret" not in path.read_text(encoding="utf-8") + url = bug_report_url(report) + assert len(url) <= 6000 + assert urlparse(url).netloc == "github.com" + assert urlparse(url).path == "/CctrGy/LANCTL/issues/new" + body = parse_qs(urlparse(url).query)["body"][0] + assert "edited-secret" not in body + assert "after-preview-secret" not in body + + +def test_draft_does_not_read_inventory_or_require_project(): + report = prepare_diagnostic(description="manual report") + assert report["context"] == {} + assert report["logs"] == [] + assert "manual report" in diagnostic_markdown(report) diff --git a/tests/test_distribution.py b/tests/test_distribution.py index 2ef596c..e16ae06 100644 --- a/tests/test_distribution.py +++ b/tests/test_distribution.py @@ -139,17 +139,21 @@ def test_onefile_and_clean_installer_contract(self): self.assertIn('["packaging/entrypoints/lanctl_entry.py"]', spec) self.assertNotIn('["main.py"]', spec) self.assertIn("a.datas", spec) - self.assertIn('icon="assets/lanctl-v3.ico"', spec) + for launcher in ("lanctl", "lanip", "lanwire", "lanrack", "lanaccess", "lanmon"): + self.assertIn(f'icon="assets/launcher-icons/{launcher}.ico"', spec) + self.assertTrue((root / f"assets/launcher-icons/{launcher}.ico").is_file()) self.assertIn('["packaging/entrypoints/lanip_entry.py"]', spec) self.assertIn('["packaging/entrypoints/lanwire_entry.py"]', spec) self.assertIn('["packaging/entrypoints/lanmon_entry.py"]', spec) self.assertNotIn('["packaging/entrypoints/landemo_entry.py"]', spec) self.assertIn('["packaging/entrypoints/lanrack_entry.py"]', spec) self.assertIn('["packaging/entrypoints/lanaccess_entry.py"]', spec) - self.assertIn('collect_submodules("lanctl.apps.wire")', spec) + self.assertIn( + 'hiddenimports=["paramiko", "cryptography"] + collect_runtime_modules()', spec + ) self.assertIn('("assets/lanctl-icon-v3.png", "assets")', spec) self.assertNotIn("lanctl-v2.ico", spec) - self.assertIn("SetupIconFile=..\\..\\assets\\lanctl-v3.ico", inno) + self.assertIn("SetupIconFile=..\\..\\assets\\launcher-icons\\lanctl.ico", inno) self.assertIn("dist\\LANCTL.exe", build) self.assertNotIn("dist\\LANCTL-GUI.exe", build) self.assertIn("dist\\lanip.exe", build) @@ -208,6 +212,16 @@ def test_github_actions_enforce_quality_and_security_gates(self): self.assertIn(expected, release) for expected in ("pull_request", "--source=src", "pip_audit", "git diff --check"): self.assertIn(expected, ci) + # The default suite exercises GUI adapters even on a headless runner. + # Both validation paths must install the optional webview dependency. + for workflow in (ci, release): + self.assertIn('python -m pip install -e ".[dev,gui]"', workflow) + self.assertIn("--junitxml=pytest.xml", workflow) + self.assertIn("if: always()", workflow) + self.assertIn("runs-on: windows-2022", ci) + self.assertIn("python-version: ['3.10', '3.11']", ci) + self.assertIn("LANCTL_GUI_BROWSER_TESTS: '1'", ci) + self.assertIn("python -m pip install playwright==1.63.0", ci) self.assertNotIn("--ignore-vuln", ci) self.assertNotIn("--ignore-vuln", release) app_source = "\n".join( @@ -219,7 +233,14 @@ def test_github_actions_enforce_quality_and_security_gates(self): self.assertIn("dependency-review-action", security) self.assertIn("generate_cli_reference.py --check", ci) self.assertIn("generate_cli_reference.py --check", release) - self.assertIn("branches: ['stable/**']", release) + self.assertIn("branches: ['stable/**', 'experimental-gui']", release) + self.assertIn("experimental-gui requires an alpha version", release) + self.assertIn( + "make_latest: ${{ needs.prepare.outputs.stable_branch == 'true' && 'true' || 'false' }}", + release, + ) + self.assertIn("stable_branch == 'true' && format('LANCTL {0}',", release) + self.assertIn("python tests/portable_smoke.py $portable", release) self.assertIn('version="${GITHUB_REF_NAME#stable/}"', release) self.assertIn('python scripts/verify-version.py "$version"', release) self.assertIn("tag_name: v${{ needs.prepare.outputs.version }}", release) diff --git a/tests/test_first_scan.py b/tests/test_first_scan.py new file mode 100644 index 0000000..2296758 --- /dev/null +++ b/tests/test_first_scan.py @@ -0,0 +1,45 @@ +import json +from unittest.mock import Mock + +import pytest + +from lanctl.core import first_scan + + +def test_request_consumed_once_without_network_or_inventory_actions(tmp_path, monkeypatch): + path = tmp_path / "request.json" + monkeypatch.setattr(first_scan, "_path", lambda: path) + monkeypatch.setattr(first_scan, "load_config", lambda: {"range": "10.0.0.0/24"}) + monkeypatch.setattr("lanctl.core.network_interfaces.ipv4_interfaces", list) + assert not first_scan.scan_choices()["requested"] + first_scan.request_first_scan() + assert first_scan.scan_choices()["range"] == "10.0.0.0/24" + assert not first_scan.scan_choices()["interfaceSelectionAvailable"] + assert first_scan.consume_request() + assert not first_scan.consume_request() + assert not first_scan.scan_choices()["requested"] + + +def test_invalid_request_not_interpreted_as_scan_authorization(tmp_path, monkeypatch): + path = tmp_path / "request.json" + monkeypatch.setattr(first_scan, "_path", lambda: path) + path.write_text(json.dumps({"schemaVersion": 1, "requested": "yes", "created": 0})) + with pytest.raises(ValueError): + first_scan.consume_request() + + +def test_installer_gui_launch_requires_normal_identity_and_never_scans(monkeypatch): + launch = Mock() + request = Mock() + monkeypatch.setattr(first_scan.subprocess, "Popen", launch) + monkeypatch.setattr(first_scan, "request_first_scan", request) + monkeypatch.setattr("lanctl.core.local_permissions.elevated", lambda: True) + with pytest.raises(PermissionError): + first_scan.launch_installed_gui(first_scan=True) + launch.assert_not_called() + request.assert_not_called() + monkeypatch.setattr("lanctl.core.local_permissions.elevated", lambda: False) + result = first_scan.launch_installed_gui(first_scan=True) + assert result["scanRequested"] and not result["scanStarted"] + assert launch.call_args.args[0][-1] == "--gui" + assert not launch.call_args.kwargs.get("shell") diff --git a/tests/test_gui_preferences.py b/tests/test_gui_preferences.py new file mode 100644 index 0000000..d4ebe05 --- /dev/null +++ b/tests/test_gui_preferences.py @@ -0,0 +1,114 @@ +import json + +import pytest + +from lanctl.core.config import load_config, update_config +from lanctl.core.gui_preferences import preferences_payload, save_preferences + + +@pytest.fixture +def config_path(tmp_path, monkeypatch): + path = tmp_path / "config.json" + monkeypatch.setattr("lanctl.core.config.CONFIG_PATH", path) + monkeypatch.setattr("lanctl.core.gui_preferences.active_theme_extensions", list) + return path + + +def test_defaults_are_read_only_and_five_complete_themes(config_path): + result = preferences_payload() + assert result["preferences"]["theme"] == "graphite" + assert len(result["themes"]) == 5 + assert len({t["id"] for t in result["themes"]}) == 5 + assert not config_path.exists() + assert result["theme"]["tokens"]["--color-accent"] == "#b2ef26" + + +def test_persistence_and_unrelated_config_preserved(config_path): + update_config(lambda c: c.update({"workers": 13, "startupInterface": "tui"})) + values = {"theme": "light", "density": "compact", "fontScale": 1.3, "reducedMotion": True} + saved = save_preferences(values) + assert preferences_payload() == saved + assert load_config()["workers"] == 13 + assert load_config()["startupInterface"] == "tui" + assert json.loads(config_path.read_text())["gui"] == {"schemaVersion": 1, **values} + update_config(lambda c: c.update({"workers": 14})) + assert preferences_payload() == saved + + +@pytest.mark.parametrize( + "key,value", + [ + ("theme", "evil"), + ("density", []), + ("fontScale", True), + ("fontScale", 0.89), + ("fontScale", 1.31), + ("fontScale", float("nan")), + ("fontScale", float("inf")), + ("reducedMotion", "false"), + ], +) +def test_invalid_values_do_not_write(config_path, key, value): + values = preferences_payload()["preferences"] + values[key] = value + with pytest.raises(ValueError): + save_preferences(values) + assert not config_path.exists() + + +def test_unknown_schema_not_silently_overwritten(config_path): + config_path.write_text(json.dumps({"schemaVersion": 2, "gui": {"schemaVersion": 99}})) + with pytest.raises(ValueError, match="versión"): + preferences_payload() + assert json.loads(config_path.read_text())["gui"]["schemaVersion"] == 99 + + +def test_only_explicit_plugin_overrides_and_preferences_unchanged(config_path, monkeypatch): + from lanctl.core.plugins.extensions import Extension + + extension = Extension( + "example.theme.custom", + "theme", + "example.theme", + { + "tokens": {"color.accent": "#112233"}, + "components": {"lanctl.primary-action": {"color.text": "#abcdef"}}, + }, + ) + monkeypatch.setattr("lanctl.core.gui_preferences.active_theme_extensions", lambda: [extension]) + result = preferences_payload() + assert result["theme"]["tokens"]["--color-accent"] == "#112233" + assert result["theme"]["tokens"]["--color-background"] == "#15181c" + assert result["theme"]["components"]["lanctl.primary-action"]["--color-text"] == "#abcdef" + assert result["effectivePlugin"] == extension.extension_id + assert result["theme"]["pluginTokens"] == {"--color-accent": "#112233"} + assert result["preferences"]["theme"] == "graphite" + assert not config_path.exists() + + +def test_settings_catalog_categories_and_same_validation(config_path): + from lanctl.core.settings_catalog import CATEGORIES, catalog, set_program_value + + entries = catalog(load_config()) + assert all(entry["category"] in CATEGORIES for entry in entries) + assert CATEGORIES["gui"] == "Apariencia y GUI" + with pytest.raises(ValueError): + set_program_value("gui.fontScale", 20) + set_program_value("gui.theme", "forest") + assert preferences_payload()["preferences"]["theme"] == "forest" + + +def test_bundled_fallback_does_not_override_explicit_preset(config_path, monkeypatch): + from lanctl.core.plugins.extensions import Extension + + fallback = Extension( + "lanctl.theme.default.palette", + "theme", + "lanctl.theme.default", + {"tokens": {"color.accent": "#25a9e8"}}, + ) + monkeypatch.setattr("lanctl.core.gui_preferences.active_theme_extensions", lambda: [fallback]) + payload = preferences_payload() + assert payload["theme"]["tokens"]["--color-accent"] == "#b2ef26" + assert payload["theme"]["pluginTokens"] == {} + assert payload["effectivePlugin"] is None diff --git a/tests/test_gui_support.py b/tests/test_gui_support.py new file mode 100644 index 0000000..37176bc --- /dev/null +++ b/tests/test_gui_support.py @@ -0,0 +1,573 @@ +"""Shared desktop controls against real preferences and activity storage.""" + +import os +from pathlib import Path +from unittest.mock import patch + +import pytest +from test_launcher_gui import workspace as workspace + +from lanctl.apps.suite.gui import SuiteApi +from lanctl.core.session import Session + +pytest_plugins = ["test_launcher_gui"] + + +def test_preferences_shared_by_suite_launchers_and_reopen(workspace): + from test_launcher_gui import api + + suite = SuiteApi() + original = suite.gui_preferences() + assert original["ok"] and len(original["themes"]) == 5 + values = {"theme": "light", "density": "compact", "fontScale": 1.2, "reducedMotion": True} + assert suite.save_gui_preferences(values)["preferences"] == values + for name in ("lanwire", "lanrack", "lanaccess", "lanmon"): + assert api(name).gui_preferences()["preferences"] == values + assert not suite.save_gui_preferences({**values, "theme": "unknown"})["ok"] + assert SuiteApi().gui_preferences()["preferences"] == values + + +def test_activity_uses_registered_session_and_opens_correct_monitor_view(workspace, monkeypatch): + from test_launcher_gui import api + + session = Session("lanctl", "gui", workspace) + monkeypatch.setattr("lanctl.core.session._current", session) + try: + suite = SuiteApi() + result = suite.record_activity("Operación de interfaz", 43) + assert result["ok"] and result["activity"]["session"] == session.id + assert result["activity"]["launcher"] == "lanctl" + monitor = api("lanmon") + records = monitor.monitor_activity(all_projects=True)["records"] + assert any(r["message"] == "Operación de interfaz" for r in records) + operational = monitor.monitor_logs()["records"] + assert any( + "GUI_ACTIVITY" in r["message"] + and r["level"] == 43 + and "Operación de interfaz" in r["message"] + for r in operational + ) + assert not api("lanwire").monitor_activity()["ok"] + with patch("lanctl.apps.suite.gui_support.subprocess.Popen") as launch: + assert suite.open_monitor("report")["ok"] + assert launch.call_args.kwargs["env"]["LANCTL_GUI_VIEW"] == "report" + assert launch.call_args.kwargs["env"]["LANCTL_GUI_SOURCE_SESSION"] == session.id + assert not launch.call_args.kwargs.get("shell") + assert not suite.open_monitor("arbitrary")["ok"] + finally: + session.close() + + +def test_report_preserves_error_origin_scrubs_secrets_and_requires_review(workspace, monkeypatch): + from test_launcher_gui import api + + session = Session("lanip", "gui", workspace) + monkeypatch.setattr("lanctl.core.session._current", session) + try: + suite = SuiteApi() + assert suite.record_activity( + "Fallo password=privado 192.168.1.20", + 43, + {"origin": "LANCTL.Scanner.Test", "code": "SCAN.TEST", "errorId": "0eTest"}, + )["ok"] + monitor = api("lanmon") + assert not monitor.open_report_form()["ok"] + result = monitor.prepare_report( + {"session": session.id, "description": "Error de escaneo", "includeActivity": True} + ) + assert result["ok"], result + assert result["report"]["errors"][0]["origin"] == "LANCTL.Scanner.Test" + assert "privado" not in result["markdown"] and "192.168.1.20" not in result["markdown"] + assert result["report"]["logs"][0]["source"] == "gui-activity" + with patch("webbrowser.open", return_value=True) as browser: + assert monitor.open_report_form()["opened"] + assert browser.call_args.args[0].startswith( + "https://github.com/CctrGy/LANCTL/issues/new?" + ) + assert not api("lanrack").prepare_report({})["ok"] + finally: + session.close() + + +def test_update_rpc_returns_immediately_and_official_browser_is_explicit(workspace): + from threading import Event + + release = { + "status": "available", + "available": "9.0.0", + "installed": "0.3.4-alpha.1", + "url": "https://github.com/CctrGy/LANCTL/releases/tag/v9.0.0", + "notes": "Nueva versión", + } + started, finish = Event(), Event() + + def check(**kwargs): + started.set() + assert finish.wait(3) + return release + + suite = SuiteApi() + with ( + patch("lanctl.core.updates.UpdateService.check", side_effect=check), + patch("webbrowser.open", return_value=True) as browser, + ): + assert suite.check_updates()["status"] == "checking" + assert started.wait(1) + assert suite.update_status()["status"] == "checking" + assert not browser.called + finish.set() + import time + + for _ in range(100): + if suite.update_status()["status"] != "checking": + break + time.sleep(0.01) + assert suite.update_status()["available"] == "9.0.0" + assert suite.open_update_release()["opened"] + assert browser.call_args.args[0] == release["url"] + + +def test_auto_close_records_launch_before_destroying_window(workspace, monkeypatch): + from unittest.mock import Mock + + from lanctl.core import config + from lanctl.core.activity import ActivityStore + + config.save_config({**config.load_config(), "closeGuiOnLaunch": True}) + session = Session("lanctl", "gui", config.load_config()) + monkeypatch.setattr("lanctl.core.session._current", session) + suite = SuiteApi() + suite._desktop._window = Mock() + + def destroyed(): + assert any("LANWIRE" in row["message"] for row in ActivityStore().query(session=session.id)) + + suite._desktop._window.destroy.side_effect = destroyed + try: + with ( + patch("lanctl.apps.suite.gui.subprocess.Popen"), + patch("lanctl.core.gui_instance.focus_gui"), + ): + assert suite.launch_gui("lanwire")["closed"] + suite._desktop._window.destroy.assert_called_once() + finally: + session.close() + + +def test_scan_selection_rejects_missing_origin_without_consuming_request(workspace, monkeypatch): + from lanctl.apps.ip.interfaces.gui.desktop import DesktopApi + from lanctl.core.first_scan import request_first_scan, scan_choices + + monkeypatch.setattr("lanctl.core.network_interfaces.ipv4_interfaces", list) + with patch("lanctl.apps.ip.interfaces.gui.main.local_ipv4", return_value="127.0.0.1"): + desktop = DesktopApi() + request_first_scan() + with patch("lanctl.apps.ip.interfaces.cli.commands.list.run_list") as execute: + result = desktop.scan_network("normal", "7:192.0.2.10", "192.0.2.0/24") + assert not result["ok"] + execute.assert_not_called() + assert scan_choices()["requested"] is True + + +def test_first_scan_failure_can_retry_before_request_is_consumed(workspace, monkeypatch): + from lanctl.apps.ip.interfaces.gui.desktop import DesktopApi + from lanctl.core.first_scan import request_first_scan + + nic = { + "id": "7:192.0.2.10", + "name": "Ethernet de prueba", + "index": 7, + "address": "192.0.2.10", + "prefixLength": 24, + "network": "192.0.2.0/24", + } + monkeypatch.setattr("lanctl.core.network_interfaces.ipv4_interfaces", lambda: [nic]) + with patch("lanctl.apps.ip.interfaces.gui.main.local_ipv4", return_value="127.0.0.1"): + desktop = DesktopApi() + request_first_scan() + with patch("lanctl.apps.ip.interfaces.cli.commands.list.run_list", side_effect=[1, 0]) as scan: + assert not desktop.scan_network("normal", nic["id"], nic["network"])["ok"] + choices = desktop.first_scan_options() + assert choices["requested"] is True + assert choices["networks"] == [nic] + assert desktop.scan_network("normal", nic["id"], nic["network"])["ok"] + assert scan.call_count == 2 + assert desktop.first_scan_options()["requested"] is False + + +@pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) +def test_plugin_runtime_limits_are_visible_and_unavailable_actions_disabled(workspace, monkeypatch): + from types import SimpleNamespace + from unittest.mock import Mock + + playwright = pytest.importorskip("playwright.sync_api").sync_playwright + session = Session("lanctl", "gui", workspace) + monkeypatch.setattr("lanctl.core.session._current", session) + suite = SuiteApi() + manifest = SimpleNamespace( + plugin_id="test.runtime", + name="Plugin de prueba", + description="Prueba de estado", + version="1.0.0", + author="Pruebas", + minimum_lanctl="0.3.0", + maximum_lanctl=None, + capabilities=[], + permissions=[], + runtime="trusted", + ) + plugin = SimpleNamespace( + manifest=manifest, + signature="", + state=SimpleNamespace(value="DISABLED"), + granted=set(), + trusted=False, + error="", + ) + manager = Mock() + manager.list.return_value = [plugin] + manager.publishers.is_trusted.return_value = False + status = { + "schemaVersion": 1, + "active": False, + "coreAccess": False, + "restartRequired": True, + "cleanupPending": False, + "execution": "legacy-in-process", + } + manager.runtime_status.return_value = status + root = Path(__file__).resolve().parents[1] + try: + with ( + playwright() as p, + patch("lanctl.apps.suite.gui.get_plugin_manager", return_value=manager), + patch.object( + suite, + "_configuration_status", + return_value={"hasSettings": False, "settingsError": ""}, + ), + patch( + "lanctl.core.updates.UpdateService.check", + return_value={"status": "current", "installed": "0.3.4-alpha.1"}, + ), + ): + browser = p.chromium.launch(channel="msedge", headless=True) + page = browser.new_page(viewport={"width": 1100, "height": 780}) + page.expose_function("rpc", lambda method, args: getattr(suite, method)(*args)) + + def open_plugins(): + page.goto((root / "gui/suite.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,m)=>(...args)=>rpc(m,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + page.locator('nav [data-page="plugins"]').click() + + open_plugins() + assert page.locator('[data-plugin-toggle="test.runtime"]').is_disabled() + assert ( + "hilos nativos no se consideran detenidos" + in page.locator(".plugin-runtime-warning").inner_text() + ) + status.update(restartRequired=False, cleanupPending=True, execution="isolated") + manifest.runtime = "stdio" + open_plugins() + assert page.locator('[data-plugin-toggle="test.runtime"]').is_disabled() + assert "limpieza" in page.locator(".plugin-runtime-warning").inner_text() + status["cleanupPending"] = False + page.wait_for_function("!document.querySelector('[data-plugin-toggle]').disabled") + browser.close() + finally: + session.close() + + +@pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) +def test_theme_preview_cancel_save_and_cross_window_sync(workspace, monkeypatch): + from test_launcher_gui import api + + playwright = pytest.importorskip("playwright.sync_api").sync_playwright + session = Session("lanrack", "gui", workspace) + monkeypatch.setattr("lanctl.core.session._current", session) + rack = api("lanrack") + root = Path(__file__).resolve().parents[1] + try: + with playwright() as p: + browser = p.chromium.launch(channel="msedge", headless=True) + pages = [browser.new_page(viewport={"width": 1100, "height": 780}) for _ in range(2)] + errors = [] + for page in pages: + page.on("pageerror", lambda error: errors.append(str(error))) + page.expose_function("rpc", lambda method, args: getattr(rack, method)(*args)) + page.goto((root / "gui/launcher.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,m)=>(...args)=>rpc(m,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + page.wait_for_function( + "document.documentElement.classList.contains('gui-preferences-active')" + ) + page = pages[0] + page.locator("#gui-appearance").click() + page.locator('[data-theme="light"]').click() + assert ( + page.evaluate("getComputedStyle(document.body).backgroundColor") + == "rgb(242, 245, 248)" + ) + page.locator('[data-preference="cancel"]').click() + assert rack.gui_preferences()["preferences"]["theme"] == "graphite" + page.locator("#gui-appearance").click() + page.locator('[data-theme="violet"]').click() + page.locator('.preferences-dialog [name="fontScale"]').select_option("1.2") + page.locator('.preferences-dialog [type="submit"]').click() + page.wait_for_function("!document.querySelector('.preferences-dialog').open") + pages[1].wait_for_function( + "getComputedStyle(document.documentElement).getPropertyValue('--color-background').trim()==='#191622'" + ) + assert rack.gui_preferences()["preferences"]["fontScale"] == 1.2 + assert not errors + browser.close() + finally: + session.close() + + +@pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) +def test_monitor_activity_filters_pause_report_and_native_browser(workspace, monkeypatch, tmp_path): + from test_launcher_gui import api + + playwright = pytest.importorskip("playwright.sync_api").sync_playwright + session = Session("lanctl", "gui", workspace) + monkeypatch.setattr("lanctl.core.session._current", session) + suite, monitor = SuiteApi(), api("lanmon") + assert suite.record_activity("Operación completada")["ok"] + assert suite.record_activity( + "Fallo de prueba 10.0.0.1 password=privado", + 43, + {"origin": "LANCTL.GUI.Test", "code": "GUI.TEST", "errorId": "0eTest"}, + )["ok"] + root = Path(__file__).resolve().parents[1] + try: + with playwright() as p, patch("webbrowser.open", return_value=True) as open_browser: + browser = p.chromium.launch(channel="msedge", headless=True) + page = browser.new_page(viewport={"width": 1100, "height": 780}) + errors = [] + page.on("pageerror", lambda error: errors.append(str(error))) + page.expose_function("rpc", lambda method, args: getattr(monitor, method)(*args)) + page.goto((root / "gui/launcher.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,m)=>(...args)=>rpc(m,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + page.locator('[data-monitor-page="activity"]').click() + page.wait_for_function( + "document.querySelectorAll('#monitor-evidence article').length===2" + ) + page.locator("#monitor-level").select_option("40") + assert page.locator("#monitor-evidence article").count() == 1 + page.locator("#monitor-pause").click() + assert suite.record_activity("Error mientras la vista está pausada", 43)["ok"] + page.wait_for_timeout(1700) + assert page.locator("#monitor-evidence article").count() == 1 + page.locator("#monitor-pause").click() + page.wait_for_function( + "document.querySelectorAll('#monitor-evidence article').length===2" + ) + page.locator("#report-bug").click() + page.locator('.report-dialog [name="description"]').fill("Problema del inventario") + page.locator('.report-dialog [type="submit"]').click() + page.locator(".report-preview").wait_for(state="visible") + preview = page.locator(".report-preview").inner_text() + assert "LANCTL.GUI.Test" in preview + assert "privado" not in preview and "10.0.0.1" not in preview + assert not open_browser.called + page.locator('[data-report="github"]').click() + page.wait_for_function( + "document.querySelector('.report-state').textContent.includes('Formulario abierto')" + ) + assert open_browser.call_count == 1 + page.screenshot(path=str(tmp_path / "lanmon-report.png")) + assert not errors, errors + browser.close() + finally: + session.close() + + +@pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) +def test_rack_dimension_editor_and_cross_launcher_storage(workspace, monkeypatch): + from test_launcher_gui import api + + playwright = pytest.importorskip("playwright.sync_api").sync_playwright + session = Session("lanrack", "gui", workspace) + monkeypatch.setattr("lanctl.core.session._current", session) + rack, wire = api("lanrack"), api("lanwire") + identifier = rack.rack_create( + {"prefix": "RK", "name": "Nuevo rack", "units": 24, "widthInches": 19} + )["id"] + root = Path(__file__).resolve().parents[1] + try: + with playwright() as p: + browser = p.chromium.launch(channel="msedge", headless=True) + page = browser.new_page(viewport={"width": 1100, "height": 780}) + page.expose_function("rpc", lambda method, args: getattr(rack, method)(*args)) + page.goto((root / "gui/launcher.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,m)=>(...args)=>rpc(m,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + page.get_by_role("button", name="Editar dimensiones", exact=True).click() + page.locator('[name="units"]').fill("52") + page.locator('[name="widthInches"]').select_option("23") + page.locator("#submit").click() + page.wait_for_function("!document.querySelector('#detail').open") + record = next(r for r in wire.bootstrap()["records"] if r["id"] == identifier) + assert record["data"]["units"] == 52 + assert record["data"]["rackDimensions"]["widthInches"] == 23 + assert rack.bootstrap()["records"][0]["widthInches"] == 23 + browser.close() + finally: + session.close() + + +@pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) +def test_suite_footer_responsive_links_and_explicit_update(workspace, monkeypatch): + playwright = pytest.importorskip("playwright.sync_api").sync_playwright + session = Session("lanctl", "gui", workspace) + monkeypatch.setattr("lanctl.core.session._current", session) + suite = SuiteApi() + root = Path(__file__).resolve().parents[1] + release = { + "status": "available", + "installed": "0.3.4-alpha.1", + "available": "9.0.0", + "url": "https://github.com/CctrGy/LANCTL/releases/tag/v9.0.0", + "notes": "Mejoras de prueba", + "deferred": True, + } + try: + with ( + playwright() as p, + patch("lanctl.core.updates.UpdateService.check", return_value=release) as check, + patch("webbrowser.open", return_value=True) as open_browser, + ): + browser = p.chromium.launch(channel="msedge", headless=True) + page = browser.new_page(viewport={"width": 780, "height": 560}) + errors = [] + page.on("pageerror", lambda error: errors.append(str(error))) + page.expose_function("rpc", lambda method, args: getattr(suite, method)(*args)) + page.goto((root / "gui/suite.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,m)=>(...args)=>rpc(m,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + page.locator(".launch-card").first.wait_for() + assert page.locator("#clock").count() == 0 + assert page.evaluate("document.documentElement.scrollWidth<=innerWidth") + footer = page.locator("footer").bounding_box() + assert footer["y"] + footer["height"] <= 561 + page.locator('[data-official-link="reference"]').click() + page.wait_for_function("document.activeElement.dataset.officialLink==='reference'") + assert open_browser.call_args.args[0] == "https://cctrgy.github.io/lanctl/reference/" + page.locator('[data-page="settings"]').click() + page.locator('[data-support="updates"]').click() + page.wait_for_function( + "document.querySelector('.update-state').textContent.includes('superior')" + ) + assert check.call_args.kwargs["manual"] is True + before = open_browser.call_count + page.locator(".update-link").click() + page.wait_for_function("document.activeElement.classList.contains('update-link')") + assert open_browser.call_count == before + 1 + page.locator('[data-update="close"]').click() + page.screenshot(path=str(root / "tmp/suite-pending-settings.png")) + assert not errors, errors + page.evaluate("""() => { + const previous = window.pywebview.api; + window.pywebview.api = new Proxy(previous,{get(target,key){ + if(key==='record_activity') return (...args)=>new Promise(resolve=>{ + window.releaseRecord=()=>previous.record_activity(...args).then(resolve); + }); + return target[key]; + }}); + message('Último mensaje antes del cierre'); + window.pendingClose=call('request_close').then(()=>{window.closeFinished=true;}); + }""") + page.wait_for_timeout(100) + assert not suite._desktop._closing + page.evaluate("window.releaseRecord()") + page.wait_for_function("window.closeFinished===true") + assert suite._desktop._closing + browser.close() + finally: + session.close() + + +@pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) +def test_first_scan_retries_and_preserves_selected_origin_and_range(workspace, monkeypatch): + from lanctl.apps.ip.interfaces.gui.desktop import DesktopApi + from lanctl.core.first_scan import request_first_scan + + playwright = pytest.importorskip("playwright.sync_api").sync_playwright + session = Session("lanip", "gui", workspace) + monkeypatch.setattr("lanctl.core.session._current", session) + with patch("lanctl.apps.ip.interfaces.gui.main.local_ipv4", return_value="127.0.0.1"): + desktop = DesktopApi() + networks = [] + monkeypatch.setattr("lanctl.core.network_interfaces.ipv4_interfaces", lambda: list(networks)) + request_first_scan() + root = Path(__file__).resolve().parents[1] + payload = desktop.bootstrap() + assert payload["ok"], payload + try: + with ( + playwright() as p, + patch("lanctl.apps.ip.interfaces.cli.commands.list.run_list", return_value=0) as scan, + ): + browser = p.chromium.launch(channel="msedge", headless=True) + page = browser.new_page(viewport={"width": 1100, "height": 780}) + page.expose_function("rpc", lambda method, args: getattr(desktop, method)(*args)) + page.goto((root / "gui/index.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,m)=>(...args)=>rpc(m,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + page.locator(".first-scan-dialog").wait_for(state="visible") + assert not scan.called + assert page.locator('.first-scan-dialog [type="submit"]').is_disabled() + assert desktop.first_scan_options()["requested"] is True + networks.append( + { + "id": "7:192.0.2.10", + "name": "Ethernet de prueba", + "index": 7, + "address": "192.0.2.10", + "prefixLength": 24, + "network": "192.0.2.0/24", + } + ) + page.locator('[data-first-scan="retry"]').click() + page.locator('.first-scan-dialog option[value="7:192.0.2.10"]').wait_for( + state="attached" + ) + page.locator('.first-scan-dialog [name="range"]').fill("192.0.2.0/25") + page.locator('.first-scan-dialog [type="submit"]').click() + page.wait_for_function("!document.querySelector('.first-scan-dialog').open") + page.wait_for_function("!document.body.classList.contains('busy')") + assert scan.call_count == 1 + assert scan.call_args.args[0].interface == "7:192.0.2.10" + assert scan.call_args.args[0].network == "192.0.2.0/25" + assert desktop.first_scan_options()["requested"] is False + page.locator("#scan-target").click() + page.locator('.first-scan-dialog [name="source"]').select_option("") + page.locator('.first-scan-dialog [type="submit"]').click() + page.locator("#scan-network").click() + page.wait_for_function("!document.body.classList.contains('busy')") + assert scan.call_count == 2 + assert scan.call_args.args[0].interface is None + browser.close() + finally: + session.close() diff --git a/tests/test_gui_window_icons.py b/tests/test_gui_window_icons.py new file mode 100644 index 0000000..ef837f3 --- /dev/null +++ b/tests/test_gui_window_icons.py @@ -0,0 +1,88 @@ +"""P43: desktop entry points must supply an icon accepted by their native backend.""" + +import importlib +import shutil +import sys +from pathlib import Path +from types import SimpleNamespace +from unittest.mock import MagicMock, Mock, patch + +import pytest + +from lanctl.core.resources import bundled_path + +ENTRY_POINTS = ( + ("lanctl.apps.suite.gui", "SuiteApi", "lanctl"), + ("lanctl.apps.ip.interfaces.gui.desktop", "DesktopApi", "lanip"), +) + + +def start_desktop(module_name, api_name, *arguments): + """Run the real entry point without opening a window or reading user settings.""" + module = importlib.import_module(module_name) + webview = SimpleNamespace(create_window=Mock(return_value=MagicMock()), start=Mock()) + with ( + patch.dict(sys.modules, {"webview": webview}), + patch.object(module, api_name), + patch("lanctl.apps.access.root_control.RootInterfaceAgent"), + patch("lanctl.core.session.current_session", return_value=None), + ): + assert module.run_gui(*arguments) == 0 + webview.start.assert_called_once() + return Path(webview.start.call_args.kwargs["icon"]) + + +@pytest.fixture(params=(False, True), ids=("source", "pyinstaller")) +def resource_root(request, tmp_path, monkeypatch): + source = bundled_path("assets/launcher-icons") + if not request.param: + monkeypatch.delattr(sys, "_MEIPASS", raising=False) + return source + # Exercise the same layout as the one-file distribution, including spaces in paths. + extracted = tmp_path / "unpacked LANCTL" + icons = extracted / "assets/launcher-icons" + shutil.copytree(source, icons) + monkeypatch.setattr(sys, "_MEIPASS", str(extracted), raising=False) + return icons + + +@pytest.mark.parametrize("module_name,api_name,launcher", ENTRY_POINTS) +@pytest.mark.parametrize("platform", ("win32", "linux", "darwin")) +def test_gui_start_selects_backend_compatible_icon( + module_name, api_name, launcher, platform, resource_root, monkeypatch +): + # Import first: changing sys.platform should affect icon selection only. + importlib.import_module(module_name) + monkeypatch.setattr(sys, "platform", platform) + path = start_desktop(module_name, api_name) + suffix = "ico" if platform == "win32" else "png" + assert path == resource_root / f"{launcher}.{suffix}" + header = b"\x00\x00\x01\x00" if platform == "win32" else b"\x89PNG\r\n\x1a\n" + assert path.read_bytes().startswith(header) + + +@pytest.mark.skipif(sys.platform != "win32", reason="System.Drawing is the Windows GUI backend") +@pytest.mark.parametrize("module_name,api_name,launcher", ENTRY_POINTS) +def test_windows_accepts_actual_gui_icon(module_name, api_name, launcher, resource_root): + assert_windows_icon(start_desktop(module_name, api_name)) + + +@pytest.mark.skipif(sys.platform != "win32", reason="System.Drawing is the Windows GUI backend") +@pytest.mark.parametrize("launcher", ("lanwire", "lanrack", "lanaccess", "lanmon")) +def test_specialized_launcher_supplies_native_icon(launcher, resource_root): + path = start_desktop("lanctl.apps.suite.launcher_gui", "LauncherApi", launcher) + assert_windows_icon(path) + assert path == resource_root / f"{launcher}.ico" + + +def assert_windows_icon(path): + clr = pytest.importorskip("clr", reason="Requires the Windows GUI optional dependencies") + clr.AddReference("System.Drawing") + drawing = importlib.import_module("System.Drawing") + # This exact constructor raised the unhandled ArgumentException in P43. + icon = drawing.Icon(str(path)) + try: + assert icon.Width > 0 and icon.Height > 0 + assert icon.Handle.ToInt64() != 0 + finally: + icon.Dispose() diff --git a/tests/test_http_session_headers.py b/tests/test_http_session_headers.py new file mode 100644 index 0000000..55e5f9e --- /dev/null +++ b/tests/test_http_session_headers.py @@ -0,0 +1,97 @@ +"""A session provider cannot inject extra cookies or HTTP response headers.""" + +import http.client +import json +import ssl +import threading +from types import SimpleNamespace +from unittest.mock import Mock + +from lanctl.apps.access.auth import AuthenticationService, AuthorizationService +from lanctl.apps.access.https_server import HttpsAccessServer +from lanctl.apps.access.keys import generate_certificate +from lanctl.apps.access.store import AccessStore + + +def test_login_rejects_unsafe_session_ids_before_emitting_headers(tmp_path): + certificate, key = generate_certificate(tmp_path / "tls.crt", tmp_path / "tls.key", "127.0.0.1") + store = AccessStore(tmp_path / "users.json") + auth = AuthenticationService(store) + user = auth.add_user("viewer", ["viewer"], "another-strong-password") + auth.authenticate_password = Mock(return_value=user) + server = HttpsAccessServer( + "127.0.0.1", 0, "127.0.0.0/8", certificate, key, auth, AuthorizationService(store) + ) + worker = threading.Thread(target=server.serve_forever, daemon=True) + worker.start() + context = ssl.create_default_context(cafile=certificate) + try: + for identifier in ( + "session\r\nX-Injected: yes", + "session\nX-Injected: yes", + "session; Domain=attacker.invalid", + "session\x00suffix", + "", + "x" * 129, + ): + auth.create_session = Mock(return_value=(SimpleNamespace(sessionId=identifier), "csrf")) + connection = http.client.HTTPSConnection( + "127.0.0.1", server.server.server_address[1], context=context, timeout=5 + ) + try: + connection.request("POST", "/api/login", json.dumps({"username": "viewer"})) + response = connection.getresponse() + body = response.read().decode() + assert response.status == 400 + assert response.getheader("X-Injected") is None + assert response.getheader("Set-Cookie") is None + assert body == json.dumps( + {"error": "identificador de sesión HTTP no válido"}, ensure_ascii=False + ) + finally: + connection.close() + finally: + server.stop() + worker.join(2) + assert not worker.is_alive() + + +def test_static_assets_ignore_untrusted_system_mime_registrations(tmp_path, monkeypatch): + import mimetypes + + monkeypatch.setattr( + mimetypes, "guess_type", lambda *a, **k: ("text/html\r\nX-Injected: yes", None) + ) + expected = { + "index.html": "text/html", + "app.js": "application/javascript", + "styles.css": "text/css", + } + for name in expected: + (tmp_path / name).write_text("asset", encoding="utf-8") + certificate, key = generate_certificate(tmp_path / "tls.crt", tmp_path / "tls.key", "127.0.0.1") + auth = AuthenticationService(AccessStore(tmp_path / "users.json")) + server = HttpsAccessServer( + "127.0.0.1", 0, "127.0.0.0/8", certificate, key, auth, static_directory=tmp_path + ) + worker = threading.Thread(target=server.serve_forever, daemon=True) + worker.start() + context = ssl.create_default_context(cafile=certificate) + try: + for name, media_type in expected.items(): + connection = http.client.HTTPSConnection( + "127.0.0.1", server.server.server_address[1], context=context, timeout=5 + ) + try: + connection.request("GET", "/" + name) + response = connection.getresponse() + assert response.status == 200 + assert response.read() == b"asset" + assert response.getheader("Content-Type") == media_type + assert response.getheader("X-Injected") is None + finally: + connection.close() + finally: + server.stop() + worker.join(2) + assert not worker.is_alive() diff --git a/tests/test_hygiene_output.py b/tests/test_hygiene_output.py new file mode 100644 index 0000000..578792a --- /dev/null +++ b/tests/test_hygiene_output.py @@ -0,0 +1,20 @@ +"""Secret findings identify a file and category, never the matched secret.""" + +import importlib.util +from pathlib import Path + + +def test_repository_secret_guard_does_not_echo_matches(tmp_path, monkeypatch, capsys): + path = Path(__file__).resolve().parents[1] / "tools/check_repository_hygiene.py" + spec = importlib.util.spec_from_file_location("hygiene_output_test", path) + module = importlib.util.module_from_spec(spec) + spec.loader.exec_module(module) + candidate = tmp_path / "candidate.txt" + secret = "ghp_" + "A" * 40 + candidate.write_text(secret, encoding="utf-8") + monkeypatch.setattr(module, "ROOT", tmp_path) + monkeypatch.setattr(module, "repository_files", lambda: [candidate]) + assert module.main() == 1 + captured = capsys.readouterr() + assert "candidate.txt: posible token GitHub" in captured.err + assert secret not in captured.out + captured.err diff --git a/tests/test_icons.py b/tests/test_icons.py index 6a05199..df4e5f7 100644 --- a/tests/test_icons.py +++ b/tests/test_icons.py @@ -35,7 +35,9 @@ def test_registers_and_resolves_125_square_jpeg(self): manager = IconManager(root / "icons") entry = manager.register(source, icon_id="device.router", name="Router") self.assertEqual((entry.width, entry.height), (125, 125)) - self.assertEqual(manager.resolve("device.router"), root / "icons/device.router.jpg") + self.assertEqual( + manager.resolve("device.router"), (root / "icons/device.router.jpg").resolve() + ) self.assertEqual(manager.list()[0].name, "Router") def test_rejects_wrong_dimensions_and_non_jpeg(self): diff --git a/tests/test_installation_preferences.py b/tests/test_installation_preferences.py new file mode 100644 index 0000000..5210dab --- /dev/null +++ b/tests/test_installation_preferences.py @@ -0,0 +1,64 @@ +import json +from unittest.mock import Mock + +import pytest + +from lanctl.core import config +from lanctl.core.installation import initialize_defaults +from lanctl.core.plugins.builtin import EXAMPLE_PLUGIN_ID, bootstrap_builtin_plugins +from lanctl.core.plugins.selection import OPTIONAL_PLUGINS, initialize_selection, selected_plugins + + +@pytest.fixture +def data(tmp_path, monkeypatch): + monkeypatch.setenv("LANCTL_DATA_DIR", str(tmp_path)) + monkeypatch.setenv("LANCTL_SECRET_DIR", str(tmp_path / "secrets")) + monkeypatch.setattr(config, "CONFIG_PATH", tmp_path / "config.json") + monkeypatch.setattr("lanctl.core.errors.errors.from_exception", Mock()) + return tmp_path + + +def test_none_excludes_optional_bootstrap_but_preserves_base_theme(data): + result = initialize_defaults(theme="forest", plugins="none") + root = data / "plugins" + assert result["selected"] == [] and result["activated"] is False + assert (root / "lanctl.theme.default" / "plugin.info").exists() + assert all(not (root / p).exists() for p in OPTIONAL_PLUGINS) + bootstrap_builtin_plugins(root) + assert all(not (root / p).exists() for p in OPTIONAL_PLUGINS) + assert config.load_config()["guiPreferences"]["theme"] == "forest" + + +def test_update_preserves_initial_selection_preferences_and_permission_registry(data): + initialize_defaults(theme="light", plugins=EXAMPLE_PLUGIN_ID) + registry = data / "plugins" / "registry.json" + registry.write_text('{"schemaVersion":1,"plugins":{}}') + previous = registry.read_bytes() + result = initialize_defaults(theme="midnight", plugins="all") + assert result["preservedConfiguration"] + assert selected_plugins(data / "plugins") == {EXAMPLE_PLUGIN_ID} + assert config.load_config()["guiPreferences"]["theme"] == "light" + assert registry.read_bytes() == previous + + +def test_read_only_repeated_example_bootstrap_does_not_rewrite(data, monkeypatch): + root = data / "plugins" + initialize_selection(root, [EXAMPLE_PLUGIN_ID]) + bootstrap_builtin_plugins(root) + monkeypatch.setattr( + "lanctl.core.plugins.builtin.atomic_write_json", Mock(side_effect=AssertionError("rewrite")) + ) + bootstrap_builtin_plugins(root) + + +def test_corrupt_selection_fails_closed_and_unknown_ids_do_not_persist(data): + root = data / "plugins" + with pytest.raises(ValueError): + initialize_selection(root, ["unknown.plugin"]) + assert not root.exists() + root.mkdir() + path = root / "bundled-selection.json" + path.write_text(json.dumps({"schemaVersion": 1, "selected": ["unknown.plugin"]})) + with pytest.raises(ValueError): + bootstrap_builtin_plugins(root) + assert len(list(root.iterdir())) == 1 diff --git a/tests/test_installer_theme_previews.py b/tests/test_installer_theme_previews.py new file mode 100644 index 0000000..1da60f6 --- /dev/null +++ b/tests/test_installer_theme_previews.py @@ -0,0 +1,30 @@ +"""Committed Setup previews must be real, distinct images available to Inno.""" + +import hashlib +import struct +from pathlib import Path + + +def test_all_five_setup_previews_are_complete_distinct_interface_images(): + root = Path(__file__).resolve().parents[1] + setup = (root / "packaging/inno/LANCTL.iss").read_text(encoding="utf-8") + assert 'Source: "theme-previews\\*.bmp"; Flags: dontcopy' in setup + assert "ThemePreview: TBitmapImage" in setup + assert "ThemePreview.Bitmap.LoadFromFile" in setup + assert "GetInitialTheme('') + '.bmp'" in setup + hashes = set() + for theme in ("graphite", "midnight", "forest", "violet", "light"): + assert f"ExtractTemporaryFile('{theme}.bmp')" in setup + data = (root / f"packaging/inno/theme-previews/{theme}.bmp").read_bytes() + magic, size, _, _, offset = struct.unpack("<2sIHHI", data[:14]) + _, width, height, planes, bits, compression = struct.unpack(" 1000 + assert any(min(pixel) > 180 for pixel in colors) + assert any(max(pixel) < 70 for pixel in colors) + hashes.add(hashlib.sha256(data).hexdigest()) + assert len(hashes) == 5 diff --git a/tests/test_lanaccess_manager.py b/tests/test_lanaccess_manager.py index 2cf2815..21d65e5 100644 --- a/tests/test_lanaccess_manager.py +++ b/tests/test_lanaccess_manager.py @@ -1,5 +1,7 @@ from unittest.mock import patch +import pytest + from lanctl.apps.access.manager_cli import AccessManager, main from lanctl.apps.ip.domain.models import Device from lanctl.core.database import DeviceDatabase @@ -34,3 +36,32 @@ def test_lanaccess_tui_can_exit_without_credentials(tmp_path): patch("builtins.input", return_value="q"), ): assert main(["--database", "ignored", "--store", "ignored", "--tui"]) == 0 + + +@pytest.mark.parametrize("command", ["list", "show", "doctor", "settings", "protocol"]) +def test_metadata_commands_never_print_the_stored_secret(tmp_path, capsys, command): + manager = _manager(tmp_path) + secret = "regression-device-secret-not-for-output" + identifier = manager.set_secret("switch", "ssh", "operator", secret) + arguments = [command, identifier] if command == "show" else [command] + with patch("lanctl.apps.access.manager_cli.AccessManager", return_value=manager): + assert main(arguments) == 0 + captured = capsys.readouterr() + assert captured.out + assert secret not in captured.out + captured.err + assert '"password"' not in captured.out + assert manager.store.get(identifier)["password"] == secret + + +def test_tui_diagnostics_never_print_the_stored_secret(tmp_path, capsys): + manager = _manager(tmp_path) + secret = "regression-tui-secret-not-for-output" + manager.set_secret("switch", "ssh", "operator", secret) + with ( + patch("lanctl.apps.access.manager_cli.AccessManager", return_value=manager), + patch("builtins.input", side_effect=["d", "", "q"]), + ): + assert main(["--tui"]) == 0 + captured = capsys.readouterr() + assert '"missingSecrets"' in captured.out + assert secret not in captured.out + captured.err diff --git a/tests/test_launcher_browser.py b/tests/test_launcher_browser.py new file mode 100644 index 0000000..667e0bc --- /dev/null +++ b/tests/test_launcher_browser.py @@ -0,0 +1,130 @@ +"""Optional browser checks for the production launcher views.""" + +import os +from pathlib import Path + +import pytest + +pytestmark = pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) + + +def test_real_launcher_views_and_action_arguments(tmp_path): + sync_playwright = pytest.importorskip("playwright.sync_api").sync_playwright + root = Path(__file__).resolve().parents[1] + payloads = { + "lanwire": { + "records": [ + { + "id": "SW001", + "prefix": "SW", + "revision": "rev1", + "data": { + "type": "device.switch", + "name": "Switch principal", + "ports": {"X1": {"kind": "wire.copper"}}, + }, + }, + { + "id": "WL001", + "prefix": "WL", + "revision": "rev2", + "data": { + "type": "wire", + "kind": "wire.copper", + "name": "Enlace", + "endpoints": [], + }, + }, + ] + }, + "lanrack": { + "records": [ + { + "id": "RK001", + "name": "Rack real", + "units": 24, + "location": {}, + "occupants": [ + {"id": "SW001", "name": "Switch", "unit": 18, "type": "device.switch"} + ], + } + ] + }, + "lanaccess": { + "locked": False, + "portable": False, + "devices": [{"id": "dev1", "name": "Router", "protocols": ["ssh"]}], + "records": [ + { + "credentialId": "cred1", + "deviceId": "dev1", + "element": "Router", + "protocol": "ssh", + "username": "operador", + } + ], + }, + "lanmon": { + "records": [ + { + "id": "dev1", + "name": "Router", + "ip": "192.0.2.1", + "presence": "online", + "health": "healthy", + "latency": 2.3, + } + ], + "incidents": [], + "session": None, + "process": {"running": False}, + }, + } + with sync_playwright() as p: + b = p.chromium.launch(channel="msedge", headless=True) + page = b.new_page(viewport={"width": 1100, "height": 780}) + errors = [] + page.on("pageerror", lambda error: errors.append(str(error))) + for app, payload in payloads.items(): + page.goto((root / "gui/launcher.html").as_uri()) + page.evaluate( + """payload=>{window.calls=[];window.pywebview={api:{bootstrap:async()=>payload,monitor_samples:async()=>({ok:true,samples:[]}),settings:async()=>({ok:true,entries:[],categories:{}}),wire_create:async(...args)=>{calls.push(['wire_create',...args]);return {ok:true,id:'WL002'}}}};window.dispatchEvent(new Event('pywebviewready'));}""", + { + "ok": True, + "launcher": app, + "project": "C:/Office.vlf", + "projectName": "Oficina", + "version": "0.3.3", + "storage": "C:/test/storage", + **payload, + }, + ) + page.locator("#brand span").wait_for() + assert page.locator("#brand").inner_text().startswith(app.upper()) + page.screenshot(path=str(tmp_path / f"{app}-gui.png")) + if app != "lanrack": + page.locator('[data-action="details"]').click() + assert page.locator("#detail").is_visible() + page.locator("#cancel").click() + page.locator("#search").fill("no-existe") + assert "No hay coincidencias" in page.locator("#canvas").inner_text() + page.locator("#search").fill("") + if app == "lanwire": + page.locator('[data-action="new"]').click() + page.locator('[name="kind"]').select_option("wire.copper") + page.locator('[name="prefix"]').fill("WL") + page.locator('[name="name"]').fill("Nuevo enlace") + page.locator("#submit").click() + page.wait_for_function("calls.length===1") + assert page.evaluate("calls[0][1].name") == "Nuevo enlace" + page.set_viewport_size({"width": 780, "height": 560}) + assert page.locator("footer").bounding_box()["y"] < 560 + assert page.evaluate("document.documentElement.scrollWidth<=innerWidth"), app + page.set_viewport_size({"width": 1100, "height": 780}) + assert not errors, errors + b.close() + print( + "4 GUI: renderizado, búsqueda, detalles, edición, viewport y ausencia de errores JS verificados." + ) diff --git a/tests/test_launcher_gui.py b/tests/test_launcher_gui.py new file mode 100644 index 0000000..6877929 --- /dev/null +++ b/tests/test_launcher_gui.py @@ -0,0 +1,398 @@ +import json +from unittest.mock import patch + +import pytest + +from lanctl.apps.suite.launcher_gui import LauncherApi +from lanctl.core import config +from lanctl.core.database import DeviceDatabase +from lanctl.core.session_context import ENVIRONMENT_KEY, child_environment, consume_context + + +@pytest.fixture +def workspace(tmp_path, monkeypatch): + root = tmp_path / "data" + marker = root / "config/migration-v2.complete" + marker.parent.mkdir(parents=True) + marker.write_text("LANCTL-DATA-V2\n") + monkeypatch.setenv("LANCTL_DATA_DIR", str(root)) + monkeypatch.setattr(config, "CONFIG_PATH", root / "config/config.json") + cfg = config.load_config() + cfg.update( + database=str(root / "devices.json"), + groups=str(root / "groups.json"), + physicalDatabase=str(root / "idf.db"), + credentials=str(root / "credentials.vault"), + monitorDatabase=str(root / "monitor.db"), + monitorLock=str(root / "monitor.lock"), + activeProject=None, + projectWorkspace=None, + ) + config.save_config(cfg) + return cfg + + +def api(launcher, **options): + with patch("lanctl.apps.ip.interfaces.gui.main.local_ipv4", return_value="127.0.0.1"): + return LauncherApi(launcher, **options) + + +def test_wire_real_connections_port_rename_and_stale_edits(workspace): + wire = api("lanwire") + assert wire.wire_create({"kind": "switch.5ports", "prefix": "SW", "name": "Distribución"})["ok"] + assert wire.wire_create({"kind": "pc.1port", "prefix": "PC", "name": "Puesto"})["ok"] + cable = wire.wire_create({"kind": "wire.copper", "prefix": "WL", "name": "Enlace"})["id"] + rows = wire.bootstrap()["records"] + switch = next(r for r in rows if r["prefix"] == "SW") + pc = next(r for r in rows if r["prefix"] == "PC") + + def get(): + return next(r for r in wire.bootstrap()["records"] if r["id"] == cable) + + endpoints = [{"device": switch["id"], "port": "X1"}, {"device": pc["id"], "port": "LAN1"}] + assert wire.wire_connect(cable, get()["revision"], endpoints)["ok"] + assert wire.wire_port(switch["id"], switch["revision"], "X1", "DESPACHO", 1)["ok"] + assert get()["data"]["endpoints"][0]["port"] == "DESPACHO" + stale = get()["revision"] + assert wire.wire_update(cable, stale, {"description": "Documentado"})["ok"] + assert not wire.wire_update(cable, stale, {"name": "Conflicto"})["ok"] + assert get()["data"]["name"] == "Enlace" + assert api("lanwire").bootstrap()["records"] == wire.bootstrap()["records"] + + +def test_wire_rejects_incompatible_and_occupied_ports(workspace): + wire = api("lanwire") + device = wire.wire_create({"kind": "switch.5ports", "prefix": "SW"})["id"] + copper = wire.wire_create({"kind": "wire.copper", "prefix": "WL"})["id"] + fiber = wire.wire_create({"kind": "wire.fiber", "prefix": "FB"})["id"] + + def revision(identifier): + return next(x for x in wire.bootstrap()["records"] if x["id"] == identifier)["revision"] + + endpoint = [{"device": device, "port": "X1"}] + assert not wire.wire_connect(fiber, revision(fiber), endpoint)["ok"] + assert wire.wire_connect(copper, revision(copper), endpoint)["ok"] + other = wire.wire_create({"kind": "wire.copper", "prefix": "WL"})["id"] + assert not wire.wire_connect(other, revision(other), endpoint)["ok"] + + +def test_rack_reads_real_wire_storage_and_has_no_write_access(workspace): + wire = api("lanwire") + rack = wire.wire_create({"kind": "rack", "prefix": "RK", "units": 24, "name": "Principal"})[ + "id" + ] + device = wire.wire_create({"kind": "switch.5ports", "prefix": "SW"})["id"] + record = next(r for r in wire.bootstrap()["records"] if r["id"] == device) + assert wire.wire_update(device, record["revision"], {"rack": rack, "unit": 18})["ok"] + reader = api("lanrack") + row = reader.bootstrap()["records"][0] + assert row["units"] == 24 and row["occupants"][0]["unit"] == 18 + assert not reader.wire_delete(rack, "anything")["ok"] + + +def test_access_portable_unlock_persistence_binding_and_no_secret_payload(workspace): + device = DeviceDatabase(workspace["database"]).upsert( + [{"IP": "192.0.2.10", "MAC": "02:00:00:00:00:10"}] + )[0] + access = api("lanaccess", cipher="portable") + assert access.bootstrap()["locked"] + assert not access.access_unlock("short", "short")["ok"] + assert access.access_unlock("Vault-test-12345", "Vault-test-12345")["ok"] + saved = access.access_set(device.device_id, "ssh", "operator", "device-secret", "device-secret") + assert saved["ok"] + payload = access.bootstrap() + assert "device-secret" not in json.dumps(payload) + assert "Vault-test" not in json.dumps(payload) + assert payload["records"][0]["username"] == "operator" + assert DeviceDatabase(workspace["database"]).load()[0].credentials["ssh"] == saved["id"] + access.access_lock() + assert access.bootstrap()["locked"] + assert not access.access_delete(saved["id"])["ok"] + fresh = api("lanaccess", cipher="portable") + assert not fresh.access_unlock("incorrect")["ok"] + assert fresh.access_unlock("Vault-test-12345")["ok"] + assert fresh.access_delete(saved["id"])["ok"] + assert fresh.bootstrap()["records"] == [] + assert not DeviceDatabase(workspace["database"]).load()[0].credentials + + +def test_monitor_open_does_not_probe_and_displays_persisted_samples(workspace): + from lanctl.apps.monitor.database import MetricsStore, MonitorDatabase + from lanctl.apps.monitor.models import CheckResult + + device = DeviceDatabase(workspace["database"]).upsert( + [{"IP": "192.0.2.10", "MAC": "02:00:00:00:00:10"}] + )[0] + with MonitorDatabase(workspace["monitorDatabase"]) as db: + MetricsStore(db).write( + CheckResult("ping", device.device_id, True, latencyMs=4.2), "test-session" + ) + with patch("lanctl.apps.monitor.commands._spawn_foreground") as spawn: + monitor = api("lanmon") + payload = monitor.bootstrap() + spawn.assert_not_called() + assert payload["ok"] and payload["records"][0]["latency"] == 4.2 + assert monitor.monitor_samples(device.device_id)["samples"][0]["latency_ms"] == 4.2 + assert not monitor.monitor_action("start")["ok"] # No project selected. + assert not monitor.monitor_action("shell")["ok"] + + +def test_child_session_context_is_one_shot_and_ignores_secret_paths(workspace, monkeypatch): + env = child_environment("lanwire", {**workspace, "password": "never-export"}, {}) + assert "never-export" not in env[ENVIRONMENT_KEY] + monkeypatch.setenv(ENVIRONMENT_KEY, env[ENVIRONMENT_KEY]) + assert consume_context("lanctl", {}) == {} + assert consume_context("lanwire", {})["database"] == workspace["database"] + assert consume_context("lanwire", {}) == {} + + +@pytest.mark.parametrize( + "launcher,module", + [ + ("lanwire", "lanctl.apps.wire.cli.main"), + ("lanrack", "lanctl.apps.rack.cli"), + ("lanaccess", "lanctl.apps.access.manager_cli"), + ("lanmon", "lanctl.bootstrap.lanmon"), + ], +) +def test_direct_and_routed_gui_entrypoints(launcher, module, workspace): + import importlib + + from lanctl.bootstrap.lanctl import main + + entry = importlib.import_module(module) + with patch("lanctl.apps.suite.launcher_gui.run_gui", return_value=0) as run: + assert entry.main(["--gui"]) == 0 + assert main([launcher, "--gui"]) == 0 + assert run.call_count == 2 + + +def test_fresh_layout_initializes_a_valid_plugin_registry(workspace): + from lanctl.core.data_migration import ensure_data_layout + from lanctl.core.paths import application_path + from lanctl.core.plugins.manager import PluginManager + + ensure_data_layout() + path = application_path(workspace["pluginRegistry"]) + assert json.loads(path.read_text()) == {"schemaVersion": 1, "plugins": {}} + manager = PluginManager(path.parent, path) + assert manager.list() + + +def test_wire_visual_metadata_validation_and_connections(workspace): + wire = api("lanwire") + device = wire.wire_create({"kind": "switch.5ports", "prefix": "SW"})["id"] + cable = wire.wire_create({"kind": "wire.copper", "prefix": "WL"})["id"] + + def row(identifier): + return next(r for r in wire.bootstrap()["records"] if r["id"] == identifier) + + assert wire.wire_connect(cable, row(cable)["revision"], [{"device": device, "port": "X1"}])[ + "ok" + ] + assert wire.wire_update( + device, + row(device)["revision"], + { + "connectionMode": "mixed", + "groups": ["Oficina"], + "ip": "192.0.2.12", + "portChanges": {"X1": {"kind": "wire.copper", "poe": True}}, + }, + )["ok"] + saved = row(device) + assert saved["data"]["ports"]["X1"]["poe"] + assert "OFICINA" in saved["filterGroups"] + assert not wire.wire_update(device, saved["revision"], {"ip": "incorrecta"})["ok"] + assert not wire.wire_update(device, saved["revision"], {"connectionMode": "unknown"})["ok"] + assert not wire.wire_update( + device, + saved["revision"], + { + "portChanges": {"X1": {"kind": "wire.fiber", "poe": False}}, + }, + )["ok"] + assert row(device) == saved + + +def test_wire_project_switch_and_failure_preserve_storage(workspace, tmp_path): + from lanctl.core.projects.vlf import create_project + + cfg = config.load_config() + cfg["projectsDirectory"] = str(tmp_path) + config.save_config(cfg) + path = tmp_path / "Office.vlf" + create_project(path, name="Office", config=cfg, initialize_reserved=False) + wire = api("lanwire") + wire.wire_create({"kind": "switch.5ports", "prefix": "SW"}) + assert wire.use_project(str(path))["ok"] + before = wire.bootstrap() + assert before["project"] == str(path) + assert len(before["records"]) == 1 + assert any(p["path"] == str(path) for p in wire.projects()["projects"]) + assert not wire.use_project(str(tmp_path / "missing.vlf"))["ok"] + assert wire.bootstrap() == before + + +@pytest.mark.skipif( + __import__("os").environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", + reason="optional browser runtime", +) +def test_wire_browser_real_service_interactions(workspace, tmp_path): + from pathlib import Path + + sync_playwright = pytest.importorskip("playwright.sync_api").sync_playwright + from lanctl.core.projects.vlf import create_project + + cfg = config.load_config() + cfg["projectsDirectory"] = str(tmp_path) + config.save_config(cfg) + project_path = tmp_path / "Visual.vlf" + create_project(project_path, name="Visual", config=cfg, initialize_reserved=False) + wire = api("lanwire") + ids = [ + wire.wire_create({"kind": kind, "prefix": prefix, "name": name})["id"] + for kind, prefix, name in [ + ("switch.5ports", "SW", "Switch central"), + ("pc.1port", "PC", "Puesto"), + ("wire.copper", "WL", "Enlace"), + ("pc.1port", "PC", "Equipo Wi-Fi"), + ] + ] + + def row(identifier): + return next(r for r in wire.bootstrap()["records"] if r["id"] == identifier) + + assert wire.wire_connect( + ids[2], + row(ids[2])["revision"], + [{"device": ids[0], "port": "X1"}, {"device": ids[1], "port": "LAN1"}], + )["ok"] + assert wire.wire_update(ids[3], row(ids[3])["revision"], {"connectionMode": "wifi"})["ok"] + with sync_playwright() as p: + browser = p.chromium.launch(channel="msedge", headless=True) + page = browser.new_page(viewport={"width": 1100, "height": 780}) + errors = [] + page.on("pageerror", lambda error: errors.append(str(error))) + page.expose_function("rpc", lambda method, args: getattr(wire, method)(*args)) + page.goto((Path(__file__).resolve().parents[1] / "gui/launcher.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,method)=>(...args)=>rpc(method,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + page.locator("#wire-board").wait_for() + assert page.locator(".wire-node").count() == 2 + assert page.locator("#wire-lines path").count() == 1 + page.locator("#filter").select_option("wire") + assert page.locator(".wire-node").count() == 2 + page.locator("#search").fill("Enlace") + assert page.locator(".wire-node").count() == 2 + page.locator("#search").fill("") + page.locator("#filter").select_option("") + assert page.locator(".split").count() == 0 + page.locator('[data-nav="fit"]').click() + page.screenshot(path=str(Path("tmp/lanwire-connected.png").resolve())) + zoom = page.locator("#wire-zoom").inner_text() + page.locator('[data-nav="in"]').click() + assert page.locator("#wire-zoom").inner_text() != zoom + board = page.locator("#wire-board").bounding_box() + page.mouse.move(board["x"] + 15, board["y"] + 15) + before = page.evaluate("camera.x") + page.mouse.down() + page.mouse.move(board["x"] + 55, board["y"] + 35) + page.mouse.up() + assert page.evaluate("camera.x") != before + page.locator('[data-nav="mini"]').click() + assert page.locator("#wire-minimap").is_visible() + page.locator('[data-view="list"]').click() + assert page.locator("#wire-board").count() == 0 + assert page.locator("tbody tr").count() == 4 + assert "device.switch" not in page.locator("#filter").inner_text() + page.locator(f'tr[data-id="{ids[0]}"]').dblclick() + assert page.locator(".wire-tabs button").count() == 6 + page.locator('[name="name"]').fill("Switch editado") + page.get_by_role("tab", name="Datos técnicos", exact=True).click() + page.locator('[name="groups"]').fill("Oficina, Red") + page.get_by_role("tab", name="Puertos", exact=True).click() + page.locator('[name="port_poe_X1"]').select_option("true") + page.locator("#submit").click() + page.wait_for_function("!document.querySelector('#detail').open") + assert row(ids[0])["data"]["name"] == "Switch editado" + assert row(ids[0])["data"]["ports"]["X1"]["poe"] + page.locator("#wire-filters").click() + page.locator('[name="group"]').select_option("OFICINA") + page.locator("#submit").click() + page.wait_for_function("document.querySelectorAll('tbody tr').length===1") + page.locator("tbody tr").dblclick() + page.get_by_role("tab", name="JSON", exact=True).click() + assert "Switch editado" in page.locator('[aria-label="Registro JSON"]').input_value() + page.get_by_role("button", name="Centrar en Topología", exact=True).click() + page.locator("#wire-board").wait_for() + page.locator('[data-nav="focus"]').click() + assert page.locator(".wire-node").count() == 1 + page.locator("#settings").click() + page.get_by_role("tab", name="Topología", exact=True).click() + page.locator('[name="pref_depth"]').fill("2") + page.locator("#submit").click() + page.wait_for_function("!document.querySelector('#detail').open") + assert page.evaluate("wirePrefs.depth") == 2 + page.get_by_role("button", name="Limpiar", exact=True).click() + page.locator('[data-nav="all"]').click() + page.locator('[data-nav="fit"]').click() + page.locator(f'[data-node="{ids[0]}"] strong').dblclick() + assert page.locator("#detail").is_visible() + page.get_by_role("tab", name="JSON", exact=True).click() + page.get_by_role("button", name="Copiar JSON", exact=True).click() + page.locator("#cancel").click() + page.locator('[data-view="list"]').click() + page.locator(f'tr[data-id="{ids[0]}"]').click() + page.wait_for_timeout(300) + page.get_by_role("button", name="Editar puertos", exact=True).click() + page.locator('[name="name"]').fill("OFICINA") + page.locator("#submit").click() + page.wait_for_function("!document.querySelector('#detail').open") + assert row(ids[2])["data"]["endpoints"][0]["port"] == "OFICINA" + page.locator(f'tr[data-id="{ids[2]}"]').dblclick() + page.get_by_role("tab", name="Conexiones", exact=True).click() + page.get_by_role("button", name="Editar conexión", exact=True).click() + page.locator('[name="b"]').select_option("") + page.locator("#submit").click() + page.wait_for_function("!document.querySelector('#detail').open") + assert len(row(ids[2])["data"]["endpoints"]) == 1 + page.locator('[data-view="map"]').click() + page.locator('[data-nav="all"]').click() + page.locator('[data-nav="fit"]').click() + page.screenshot(path=str(Path("tmp/lanwire-topology-full.png").resolve())) + page.locator("#wire-project").click() + page.locator('[name="project"]').select_option(str(project_path)) + page.locator("#submit").click() + page.wait_for_function("!document.querySelector('#detail').open") + assert wire.bootstrap()["project"] == str(project_path) + assert row(ids[0])["data"]["name"] == "Switch editado" + page.set_viewport_size({"width": 780, "height": 560}) + assert page.locator("footer").bounding_box()["y"] < 560 + assert page.evaluate("document.documentElement.scrollWidth<=innerWidth") + page.screenshot(path=str(Path("tmp/lanwire-updated.png").resolve())) + assert not errors, errors + browser.close() + + +@pytest.mark.parametrize("kind,count", [("panel", 24), ("outlet", 2), ("router.gateway", 6)]) +def test_wire_new_profiles_and_existing_connector_metadata(workspace, kind, count): + wire = api("lanwire") + result = wire.wire_create( + {"kind": kind, "prefix": "ND", "name": "Infraestructura", "units": 42} + ) + assert result["ok"], result + row = next(r for r in wire.bootstrap()["records"] if r["id"] == result["id"]) + assert len(row["data"]["ports"]) == count + changes = { + name: {"kind": p["kind"], "poe": bool(p.get("poe"))} + for name, p in row["data"]["ports"].items() + } + result = wire.wire_update( + row["id"], row["revision"], {"description": "Actualizado", "portChanges": changes} + ) + assert result["ok"], result + saved = next(r for r in wire.bootstrap()["records"] if r["id"] == row["id"]) + assert saved["data"]["ports"] == row["data"]["ports"] + assert "units" not in saved["data"] diff --git a/tests/test_log_tui.py b/tests/test_log_tui.py new file mode 100644 index 0000000..3bf6c62 --- /dev/null +++ b/tests/test_log_tui.py @@ -0,0 +1,125 @@ +import json +from unittest.mock import patch + +import pytest + +from lanctl.apps.monitor.log_stream import open_log_window +from lanctl.apps.monitor.log_tui import LogViewModel +from lanctl.bootstrap.lanmon import _main + + +def row(message, level=None): + return {"source": "program", "file": "17-10-2026.log", "level": level, "message": message} + + +def test_pause_preserves_view_while_bounded_history_keeps_polling(): + view = LogViewModel(limit=3) + view.ingest([row("a"), row("b")]) + view.key("p") + view.ingest([row("c"), row("d"), row("e")]) + assert [r["message"] for r in view.rows(10)] == ["b", "a"] + view.key("p") + assert [r["message"] for r in view.rows(10)] == ["e", "d", "c"] + assert view.key("q") is False + + +def test_level_text_filter_and_history(): + view = LogViewModel() + view.ingest([row("error alpha", 42), row("notice beta", 10), row("error beta", 50)]) + view.key("f") + assert len(view.rows(10)) == 2 + view.key("/") + for key in "alpha\r": + view.key(key) + assert [r["message"] for r in view.rows(10)] == ["error alpha"] + view.key("/") + view.key("\r") + view.key("up") + assert view.paused + assert [r["message"] for r in view.rows(10)] == ["error alpha"] + + +def test_cli_routes_log_tui_without_monitor_operations(): + with patch("lanctl.apps.monitor.log_tui.follow_log_tui", return_value=0) as follow: + assert _main(["logs", "--tui", "--limit", "30"]) == 0 + follow.assert_called_once_with(limit=30, minimum=1) + + +def test_new_terminal_tui_flag_and_no_shell(): + with ( + patch("lanctl.apps.monitor.log_stream.subprocess.Popen") as popen, + patch("lanctl.apps.monitor.log_stream.shutil.which", return_value="xterm"), + ): + assert open_log_window(tui=True) == 0 + assert popen.call_args.args[0][-1] == "--tui" + assert not popen.call_args.kwargs.get("shell") + + +def test_log_follower_bounded_batches_without_losing_appended_lines(tmp_path): + from lanctl.apps.monitor.log_stream import LogFollower + + path = tmp_path / "17-10-2026.log" + path.write_text("initial\n", encoding="utf-8") + follower = LogFollower(tmp_path) + follower.poll() + with path.open("a", encoding="utf-8") as stream: + stream.write("".join(f"line-{i}\n" for i in range(2200))) + batches = [follower.poll() for _ in range(3)] + assert [len(batch) for batch in batches] == [1000, 1000, 200] + assert [r["message"] for batch in batches for r in batch] == [f"line-{i}" for i in range(2200)] + assert follower.poll() == [] + + +def test_gui_activity_levels_reach_real_log_follower_and_tui_filter(tmp_path): + from lanctl.apps.monitor.event_view import read_events + from lanctl.apps.monitor.log_stream import LogFollower + from lanctl.core.logger import write_log + + follower = LogFollower(tmp_path) + assert follower.poll() == [] + messages = [ + "GUI_ACTIVITY " + + json.dumps( + { + "schemaVersion": 1, + "level": 20, + "message": "Proyecto guardado; texto literal ERROR_EVENT sin error", + "origin": "LANCTL.lanip.GUI", + } + ), + 'ERROR_EVENT {"level":43,"message":"fallo","origin":"LANCTL.Tests.Error"}', + 'GUI_ACTIVITY {"schemaVersion":1,"level":43,"message":"aviso","origin":"LANCTL.lanwire.GUI"}', + ] + for message in messages: + write_log(message, directory=tmp_path) + rows = follower.poll() + assert [item["level"] for item in rows] == [20, 43, 43] + assert all(item["message"].endswith(message) for item, message in zip(rows, messages)) + assert follower.poll() == [] + view = LogViewModel(minimum=40) + view.ingest(rows) + assert [item["level"] for item in view.rows(10)] == [43, 43] + assert all("Proyecto guardado" not in item["message"] for item in view.rows(10)) + view.minimum = 20 + assert len(view.rows(10)) == 3 + assert len(read_events({"programLog": str(tmp_path)}, source="program", minimum=40)) == 2 + + +@pytest.mark.parametrize( + "payload", + [ + "broken", + "null", + "[]", + '{"schemaVersion":2,"level":20}', + '{"schemaVersion":true,"level":20}', + '{"schemaVersion":1,"level":true}', + '{"schemaVersion":1,"level":"20"}', + '{"schemaVersion":1,"level":60}', + ], +) +def test_invalid_gui_activity_remains_visible_without_assigning_a_level(payload): + from lanctl.apps.monitor.event_view import _rows + + text = "10:00:00 GUI_ACTIVITY " + payload + assert _rows(text, "program", "17-10-2026.log", 1) == [row(text)] diff --git a/tests/test_network_interfaces.py b/tests/test_network_interfaces.py new file mode 100644 index 0000000..4faad18 --- /dev/null +++ b/tests/test_network_interfaces.py @@ -0,0 +1,256 @@ +import ctypes +import ipaddress +import json +import socket +from types import SimpleNamespace +from unittest.mock import Mock + +import pytest + +from lanctl.apps.ip.infrastructure.services import lan_scanner, source_binding +from lanctl.core import network_interfaces + +NIC = { + "id": "7:10.20.1.2", + "name": "Ethernet test", + "index": 7, + "address": "10.20.1.2", + "prefixLength": 22, + "network": "10.20.0.0/22", +} + + +@pytest.mark.parametrize( + "system,document", + [ + ("Windows", {"name": NIC["name"], "index": 7, "address": NIC["address"], "prefix": 22}), + ( + "Linux", + [ + { + "ifname": NIC["name"], + "ifindex": 7, + "addr_info": [ + {"family": "inet", "local": NIC["address"], "prefixlen": 22}, + {"family": "inet6", "local": "fe80::1", "prefixlen": 64}, + ], + } + ], + ), + ], +) +def test_enumeration_uses_real_mask_and_does_not_probe(monkeypatch, system, document): + monkeypatch.setattr(network_interfaces.platform, "system", lambda: system) + # Simulate the complete Windows subprocess API when this test runs on Linux. + if system == "Windows": + monkeypatch.setattr( + network_interfaces.subprocess, "CREATE_NO_WINDOW", 0x08000000, raising=False + ) + run = Mock(return_value=SimpleNamespace(stdout=json.dumps(document))) + monkeypatch.setattr(network_interfaces.subprocess, "run", run) + assert network_interfaces.ipv4_interfaces() == [NIC] + command = run.call_args.args[0] + assert command[0] in ("ip", "powershell.exe") + assert not run.call_args.kwargs.get("shell") + assert run.call_args.kwargs["timeout"] == 10 + assert run.call_args.kwargs["creationflags"] == (0x08000000 if system == "Windows" else 0) + + +@pytest.mark.parametrize( + "document", + [ + None, + [1], + [{"name": "eth0"}], + {"name": "x", "index": True, "address": "1.2.3.4", "prefix": 24}, + ], +) +def test_malformed_inventory_rejected_without_default_route(monkeypatch, document): + monkeypatch.setattr(network_interfaces.platform, "system", lambda: "Windows") + monkeypatch.setattr(network_interfaces, "_read", lambda command: document) + with pytest.raises(ValueError): + network_interfaces.ipv4_interfaces() + + +def test_selection_rejects_disappeared_ambiguous_and_outside_network(monkeypatch): + monkeypatch.setattr(network_interfaces, "ipv4_interfaces", lambda: [NIC]) + assert network_interfaces.select_interface(NIC["id"], "10.20.2.0/24") == NIC + with pytest.raises(ValueError): + lan_scanner.LanScanner( + ipaddress.IPv4Network(NIC["network"]), 1, 0.1, 4096, source_address="" + ) + with pytest.raises(ValueError, match="pertenecer"): + network_interfaces.select_interface(NIC["id"], "10.0.0.0/8") + with pytest.raises(ValueError, match="disponible"): + network_interfaces.select_interface("8:10.20.1.2") + monkeypatch.setattr( + network_interfaces, + "ipv4_interfaces", + lambda: [NIC, {**NIC, "id": "8:10.20.1.2", "index": 8}], + ) + with pytest.raises(ValueError, match="varias interfaces"): + network_interfaces.select_interface(NIC["id"]) + + +def test_interface_removed_before_scan_starts_no_probe(monkeypatch): + monkeypatch.setattr(network_interfaces, "ipv4_interfaces", lambda: [NIC]) + scanner = lan_scanner.LanScanner( + ipaddress.IPv4Network(NIC["network"]), + workers=1, + timeout=0.1, + max_hosts=4096, + source_address=NIC["id"], + ) + probe = Mock(side_effect=AssertionError("must not probe")) + monkeypatch.setattr(scanner, "_parallel_discovery", probe) + monkeypatch.setattr(network_interfaces, "ipv4_interfaces", list) + with pytest.raises(ValueError, match="disponible"): + scanner.scan() + probe.assert_not_called() + + +def test_linux_ping_and_arp_preserve_source_and_adapter(monkeypatch): + monkeypatch.setattr(network_interfaces, "ipv4_interfaces", lambda: [NIC]) + monkeypatch.setattr(lan_scanner.platform, "system", lambda: "Linux") + scanner = lan_scanner.LanScanner( + ipaddress.IPv4Network(NIC["network"]), + workers=1, + timeout=0.1, + max_hosts=4096, + source_address=NIC["id"], + ) + run = Mock( + return_value=SimpleNamespace(returncode=0, stdout="10.20.1.9 lladdr AA:BB:CC:DD:EE:FF") + ) + monkeypatch.setattr(lan_scanner.subprocess, "run", run) + assert scanner._ping("10.20.1.9") + command = run.call_args.args[0] + assert command[-6:] == ["-I", NIC["name"], "-I", NIC["address"], "-n", "10.20.1.9"] + assert scanner._arp("10.20.1.9") == "AA:BB:CC:DD:EE:FF" + command = run.call_args.args[0] + assert command[-5:] == ["-I", NIC["name"], "-s", NIC["address"], "10.20.1.9"] + assert scanner._read_arp_table() == {"10.20.1.9": "AA:BB:CC:DD:EE:FF"} + assert run.call_args.args[0] == ["ip", "-4", "neigh", "show", "dev", NIC["name"]] + + +def test_windows_icmp_uses_native_source_not_unsupported_ping_switch(monkeypatch): + native = SimpleNamespace( + IcmpCreateFile=Mock(return_value=123), + IcmpCloseHandle=Mock(), + IcmpSendEcho2Ex=Mock(return_value=1), + ) + monkeypatch.setattr(ctypes, "WinDLL", Mock(return_value=native), raising=False) + assert source_binding.windows_ping(NIC["address"], "10.20.1.9", 0.5) + args = native.IcmpSendEcho2Ex.call_args.args + assert args[4] == int.from_bytes(socket.inet_aton(NIC["address"]), "little") + assert args[5] == int.from_bytes(socket.inet_aton("10.20.1.9"), "little") + assert args[-1] == 500 + native.IcmpCloseHandle.assert_called_once_with(123) + + +def test_windows_icmp_source_failure_closes_handle_without_fallback(monkeypatch): + native = SimpleNamespace( + IcmpCreateFile=Mock(return_value=123), + IcmpCloseHandle=Mock(), + IcmpSendEcho2Ex=Mock(return_value=0), + ) + monkeypatch.setattr(ctypes, "WinDLL", Mock(return_value=native), raising=False) + monkeypatch.setattr(ctypes, "get_last_error", lambda: 87, raising=False) + with pytest.raises(OSError, match="interfaz"): + source_binding.windows_ping(NIC["address"], "10.20.1.9", 0.5) + native.IcmpCloseHandle.assert_called_once_with(123) + + +def test_windows_arp_passes_selected_source(monkeypatch): + monkeypatch.setattr(lan_scanner.platform, "system", lambda: "Windows") + address = Mock( + side_effect=lambda value: int.from_bytes(socket.inet_aton(value.decode()), "little") + ) + send = Mock(return_value=0) + dlls = SimpleNamespace( + ws2_32=SimpleNamespace(inet_addr=address), iphlpapi=SimpleNamespace(SendARP=send) + ) + monkeypatch.setattr(ctypes, "windll", dlls, raising=False) + lan_scanner.active_arp_mac("10.20.1.9", source_address=NIC["address"]) + assert send.call_args.args[1] == int.from_bytes(socket.inet_aton(NIC["address"]), "little") + + +def test_bound_scan_omits_unbound_services_and_name_resolution(monkeypatch): + monkeypatch.setattr(network_interfaces, "ipv4_interfaces", lambda: [NIC]) + scanner = lan_scanner.LanScanner( + ipaddress.IPv4Network("10.20.1.0/30"), + workers=1, + timeout=0.1, + max_hosts=4096, + source_address=NIC["id"], + ) + monkeypatch.setattr(scanner, "_parallel_discovery", lambda *a: (set(), {})) + monkeypatch.setattr(scanner, "_read_arp_table", dict) + monkeypatch.setattr(scanner, "_include_local_device", lambda records: None) + monkeypatch.setattr(scanner, "_include_special_devices", lambda records, entries: records) + service = Mock(return_value=({}, set())) + enrich = Mock() + monkeypatch.setattr(scanner, "_discover_extra_services", service) + monkeypatch.setattr(scanner, "_enrich_records", enrich) + scanner.scan(resolve_names=True, extra_methods=("mdns", "ssdp")) + assert service.call_args.args[0] == () + assert enrich.call_args.args[1] is False + + +def test_cli_explicit_interface_defaults_to_real_subnet_without_route_lookup(monkeypatch, tmp_path): + import importlib + + command = importlib.import_module("lanctl.apps.ip.interfaces.cli.commands.list") + from lanctl.apps.ip.interfaces.cli.main import build_parser + + monkeypatch.setattr(network_interfaces, "ipv4_interfaces", lambda: [NIC]) + monkeypatch.setattr("lanctl.apps.ip.lab.LabRepository.active", lambda self: None) + monkeypatch.setattr(command, "local_ipv4", Mock(side_effect=AssertionError("route lookup"))) + args = build_parser().parse_args( + ["list", "--interface", NIC["id"], "--database", str(tmp_path / "devices.json")] + ) + scanner = Mock(side_effect=RuntimeError("captured scanner")) + monkeypatch.setattr(command, "LanScanner", scanner) + with pytest.raises(RuntimeError, match="captured scanner"): + command.run_list(args) + assert str(scanner.call_args.kwargs["network"]) == NIC["network"] + assert scanner.call_args.kwargs["source_address"] == NIC["id"] + args = build_parser().parse_args( + ["list", "--interface", NIC["id"], "--network", "192.0.2.0/24"] + ) + scanner.reset_mock() + with pytest.raises(ValueError, match="pertenecer"): + command.run_list(args) + scanner.assert_not_called() + + +def test_first_scan_choices_are_read_only_and_preserve_real_mask(monkeypatch, tmp_path): + from lanctl.core import first_scan + + monkeypatch.setattr(first_scan, "_path", lambda: tmp_path / "request.json") + monkeypatch.setattr(first_scan, "load_config", lambda: {"range": "192.0.2.0/24"}) + enumerate_interfaces = Mock(return_value=[NIC]) + monkeypatch.setattr(network_interfaces, "ipv4_interfaces", enumerate_interfaces) + assert not first_scan.scan_choices()["requested"] + enumerate_interfaces.assert_not_called() + first_scan.request_first_scan() + options = first_scan.scan_choices() + assert options["networks"] == [NIC] + assert options["interfaceSelectionAvailable"] + assert options["requested"] and first_scan.scan_choices()["requested"] + assert "ICMP/ARP" in options["notice"] + + +def test_first_scan_enumeration_failure_has_no_default_interface(monkeypatch, tmp_path): + from lanctl.core import first_scan + + monkeypatch.setattr(first_scan, "_path", lambda: tmp_path / "request.json") + monkeypatch.setattr(first_scan, "load_config", lambda: {"range": "192.0.2.0/24"}) + monkeypatch.setattr( + network_interfaces, "ipv4_interfaces", Mock(side_effect=OSError("not available")) + ) + first_scan.request_first_scan() + options = first_scan.scan_choices() + assert options["requested"] and options["networks"] == [] + assert not options["interfaceSelectionAvailable"] + assert options["routing"] == "unavailable" diff --git a/tests/test_official_links.py b/tests/test_official_links.py new file mode 100644 index 0000000..ee36334 --- /dev/null +++ b/tests/test_official_links.py @@ -0,0 +1,37 @@ +from unittest.mock import patch + +import pytest + +from lanctl.bootstrap.lanctl import main +from lanctl.core.official_links import get_official_links, open_official_link + + +@pytest.mark.parametrize("key", ["web", "github", "reference"]) +@pytest.mark.parametrize("prefix", ["-", "--"]) +def test_cli_prints_and_opens_only_canonical_link(key, prefix, capsys): + with patch("lanctl.core.official_links.webbrowser.open", return_value=True) as browser: + assert main.__wrapped__([prefix + key]) == 0 + assert capsys.readouterr().out.strip() == get_official_links()[key] + browser.assert_called_once_with(get_official_links()[key], new=2) + + +def test_links_copy_and_unsupported_browser(): + links = get_official_links() + links["web"] = "https://attacker.invalid" + with patch("lanctl.core.official_links.webbrowser.open", return_value=False) as browser: + result = open_official_link("web") + assert result == {"key": "web", "url": get_official_links()["web"], "opened": False} + assert browser.call_args.args[0] != links["web"] + + +@pytest.mark.parametrize("key", ["file:///tmp/a", "https://attacker.invalid", [], None]) +def test_arbitrary_destination_refused(key): + with pytest.raises(ValueError, match="desconocido"): + open_official_link(key) + + +@pytest.mark.parametrize("args", [["-web", "-github"], ["--gui", "-web"], ["-web", "lanip"]]) +def test_incompatible_options_do_not_open_browser(args): + with patch("lanctl.core.official_links.webbrowser.open") as browser, pytest.raises(SystemExit): + main.__wrapped__(args) + browser.assert_not_called() diff --git a/tests/test_paths.py b/tests/test_paths.py index 55c6079..36e1dd2 100644 --- a/tests/test_paths.py +++ b/tests/test_paths.py @@ -53,10 +53,10 @@ def test_portable_and_override_priority(self): patch.object(sys, "executable", str(executable)), patch.dict("os.environ", {}, clear=True), ): - self.assertEqual(data_root(), root / "data" / "lanctl") + self.assertEqual(data_root(), (root / "data" / "lanctl").resolve()) self.assertEqual( application_path("data/lc/monitor.db"), - root / "data" / "lanctl" / "monitoring" / "monitor.db", + (root / "data" / "lanctl" / "monitoring" / "monitor.db").resolve(), ) override = root / "explicit" with ( @@ -64,7 +64,7 @@ def test_portable_and_override_priority(self): patch.object(sys, "executable", str(executable)), patch.dict("os.environ", {"LANCTL_DATA_DIR": str(override)}, clear=True), ): - self.assertEqual(data_root(), override) + self.assertEqual(data_root(), override.resolve()) @unittest.skipUnless(sys.platform == "win32", "semántica de rutas de Windows") def test_windows_service_secrets_are_not_taken_from_a_user_profile(self): @@ -101,8 +101,8 @@ def test_frozen_linux_separates_user_and_service_data(self): patch("lanctl.core.paths.Path.home", return_value=home), patch.dict("os.environ", {}, clear=True), ): - self.assertEqual(data_root(), home / ".local/share/lanctl") - self.assertEqual(secret_root(), home / ".config/lanctl/access") + self.assertEqual(data_root(), (home / ".local/share/lanctl").resolve()) + self.assertEqual(secret_root(), (home / ".config/lanctl/access").resolve()) with ( patch.object(sys, "frozen", True, create=True), patch.object(sys, "executable", str(executable)), @@ -119,16 +119,19 @@ def test_legacy_names_map_into_structured_layout(self): ): root = Path(temporary) self.assertEqual( - application_path("data/lc/icons/router.png"), root / "config/icons/router.png" + application_path("data/lc/icons/router.png"), + (root / "config/icons/router.png").resolve(), + ) + self.assertEqual( + application_path("data/lc/log/now.log"), (root / "logs/now.log").resolve() ) - self.assertEqual(application_path("data/lc/log/now.log"), root / "logs/now.log") self.assertEqual( application_path("data/lc/recurrent-elements.json"), - root / "automation/recurrent-elements.json", + (root / "automation/recurrent-elements.json").resolve(), ) self.assertEqual( application_path("data/lc/plugins/demo/plugin.info"), - root / "plugins/demo/plugin.info", + (root / "plugins/demo/plugin.info").resolve(), ) diff --git a/tests/test_physical_core_libraries.py b/tests/test_physical_core_libraries.py index 001640d..aa5ce9d 100644 --- a/tests/test_physical_core_libraries.py +++ b/tests/test_physical_core_libraries.py @@ -16,7 +16,7 @@ def test_data_path_uses_configured_root(self): patch.dict("os.environ", {"LANWRE_DATA_DIR": temporary}), ): self.assertEqual( - application_path("data/example.json"), Path(temporary) / "example.json" + application_path("data/example.json"), (Path(temporary) / "example.json").resolve() ) def test_lanctl_root_has_priority_and_physical_database_is_namespaced(self): @@ -25,9 +25,9 @@ def test_lanctl_root_has_priority_and_physical_database_is_namespaced(self): tempfile.TemporaryDirectory() as legacy, patch.dict("os.environ", {"LANCTL_DATA_DIR": shared, "LANWRE_DATA_DIR": legacy}), ): - self.assertEqual(data_root(), Path(shared)) + self.assertEqual(data_root(), Path(shared).resolve()) self.assertEqual( - application_path("data/lw/idf.db"), Path(shared) / "physical" / "idf.db" + application_path("data/lw/idf.db"), (Path(shared) / "physical" / "idf.db").resolve() ) def test_config_and_language_files_use_json(self): diff --git a/tests/test_physical_entrypoint.py b/tests/test_physical_entrypoint.py index 0ad4031..99f86a2 100644 --- a/tests/test_physical_entrypoint.py +++ b/tests/test_physical_entrypoint.py @@ -66,14 +66,18 @@ def call(*command: str) -> str: self.assertIn("Eliminado", call("idf", "delete", "FB-00")) def test_explicit_tui_and_cli_modes_are_dispatched(self): - with patch("lanctl.apps.wire.tui.run_tui", return_value=7) as tui: - self.assertEqual(main(["--tui"]), 7) - tui.assert_called_once_with(DEFAULT_DATABASE_PATH) - cli_module = importlib.import_module("lanctl.apps.wire.cli.main") - with patch.object(cli_module, "run_cli", return_value=8) as cli: - self.assertEqual(main(["--cli"]), 8) - cli.assert_called_once_with(DEFAULT_DATABASE_PATH) + # The active project may override the default; keep this dispatch test isolated. + with patch.object( + cli_module, "load_config", return_value={"physicalDatabase": DEFAULT_DATABASE_PATH} + ): + with patch("lanctl.apps.wire.tui.run_tui", return_value=7) as tui: + self.assertEqual(main(["--tui"]), 7) + tui.assert_called_once_with(DEFAULT_DATABASE_PATH) + + with patch.object(cli_module, "run_cli", return_value=8) as cli: + self.assertEqual(main(["--cli"]), 8) + cli.assert_called_once_with(DEFAULT_DATABASE_PATH) if __name__ == "__main__": diff --git a/tests/test_physical_sample_topology.py b/tests/test_physical_sample_topology.py index 6ba295e..d1940c0 100644 --- a/tests/test_physical_sample_topology.py +++ b/tests/test_physical_sample_topology.py @@ -1,3 +1,4 @@ +import json import tempfile import unittest from pathlib import Path @@ -29,6 +30,30 @@ def test_seed_is_idempotent(self): self.assertEqual(len(seed_sample_topology(database)), 32) self.assertEqual(seed_sample_topology(database), ()) self.assertEqual(len(database.all()), 32) + self.assertEqual(database.get("RK-00")["data"], sample_elements()["RK-00"]) + + def test_legacy_sample_reseed_does_not_fill_missing_dimensions(self): + with tempfile.TemporaryDirectory() as temporary: + database = IDFDatabaseManager(Path(temporary) / "idf.db") + seed_sample_topology(database) + document = json.loads(database.path.read_text(encoding="utf-8")) + legacy = document["records"]["RK-00"]["data"] + legacy.pop("units") + legacy.pop("rackDimensions") + database.path.write_text(json.dumps(document), encoding="utf-8") + self.assertEqual(seed_sample_topology(database), ()) + self.assertEqual(database.get("RK-00")["data"], legacy) + + def test_reseed_rejects_changed_rack_dimensions_without_overwriting(self): + with tempfile.TemporaryDirectory() as temporary: + database = IDFDatabaseManager(Path(temporary) / "idf.db") + seed_sample_topology(database) + changed = database.get("RK-00")["data"] + changed["rackDimensions"]["widthInches"] = 23 + database.update("RK-00", changed) + with self.assertRaisesRegex(ValueError, "RK-00"): + seed_sample_topology(database) + self.assertEqual(database.get("RK-00")["data"], changed) if __name__ == "__main__": diff --git a/tests/test_plugin_registry_migration.py b/tests/test_plugin_registry_migration.py new file mode 100644 index 0000000..a559236 --- /dev/null +++ b/tests/test_plugin_registry_migration.py @@ -0,0 +1,206 @@ +"""P44: migrate the historical empty registry without recovering authorization.""" + +import json +import os +import subprocess +import sys +from concurrent.futures import ThreadPoolExecutor +from threading import Event + +import pytest + +from lanctl.core.file_transaction import atomic_write_json, locked_file +from lanctl.core.plugins.manager import PluginManager +from lanctl.core.plugins.models import PluginState +from lanctl.core.plugins.package import build_package + + +@pytest.fixture +def manager(tmp_path, monkeypatch): + monkeypatch.setenv("LANCTL_DATA_DIR", str(tmp_path / "data")) + monkeypatch.setenv("LANCTL_SECRET_DIR", str(tmp_path / "secrets")) + return PluginManager(tmp_path / "installed", tmp_path / "registry.json") + + +@pytest.mark.parametrize("original", [b"{}", b" \n{ \n }\r\n"]) +def test_only_historical_empty_object_migrates_once(manager, original, monkeypatch): + manager.registry_path.write_bytes(original) + assert manager._read_registry() == {} + assert json.loads(manager.registry_path.read_bytes()) == {"schemaVersion": 1, "plugins": {}} + migrated = manager.registry_path.read_bytes() + + def unexpected_write(*args, **kwargs): + pytest.fail("An already migrated registry must not be rewritten by reading it") + + monkeypatch.setattr("lanctl.core.plugins.manager.atomic_write_json", unexpected_write) + assert manager._read_registry() == {} + assert manager.registry_path.read_bytes() == migrated + + +def test_versioned_registry_preserves_permissions_and_unknown_fields_byte_for_byte(manager): + document = { + "schemaVersion": 1, + "futureMetadata": {"keep": True}, + "plugins": { + "test.existing": { + "state": "DISABLED", + "trusted": False, + "granted": ["theme.register"], + "futureField": [1, 2], + } + }, + } + original = json.dumps(document, indent=4).encode() + manager.registry_path.write_bytes(original) + assert manager._read_registry() == document["plugins"] + assert manager.registry_path.read_bytes() == original + + +@pytest.mark.parametrize( + "original", + [ + b"", + b"{", + b"[]", + b"null", + b"false", + b'{"plugins": {}}', + b'{"unexpected": "data"}', + b'{"schemaVersion": 999, "plugins": {}}', + b'{"schemaVersion": 1, "plugins": []}', + b'{"schemaVersion": 1, "plugins": {"test": {"trusted": "yes"}}}', + ], +) +def test_malformed_or_unknown_registry_is_rejected_without_rewriting(manager, original): + manager.registry_path.write_bytes(original) + with pytest.raises(ValueError, match="registro de plugins") as caught: + manager._read_registry() + assert caught.value.__cause__ is not None + assert manager.registry_path.read_bytes() == original + + +def test_failed_migration_preserves_original_and_error_origin(manager, monkeypatch): + original = b"{}\n" + manager.registry_path.write_bytes(original) + failure = OSError("P44 simulated disk failure") + reported = [] + + def fail_write(*args, **kwargs): + raise failure + + def report(error, **details): + reported.append((error, details)) + + monkeypatch.setattr("lanctl.core.plugins.manager.atomic_write_json", fail_write) + monkeypatch.setattr("lanctl.core.errors.errors.from_exception", report) + with pytest.raises(ValueError, match="registro de plugins") as caught: + manager._read_registry() + assert caught.value.__cause__ is failure + assert reported[0][0] is failure + assert reported[0][1]["origin"] == "LANCTL.Plugin.Registry.Load" + assert manager.registry_path.read_bytes() == original + + +def test_migration_waits_for_writer_and_preserves_new_authorization(manager): + manager.registry_path.write_text("{}", encoding="utf-8") + started, finished = Event(), Event() + document = { + "schemaVersion": 1, + "plugins": {"test.concurrent": {"state": "DISABLED", "trusted": False, "granted": []}}, + } + + def read(): + started.set() + try: + return manager._read_registry() + finally: + finished.set() + + with ThreadPoolExecutor(max_workers=1) as pool: + with locked_file(manager.registry_path): + future = pool.submit(read) + assert started.wait(5) + assert not finished.wait(0.15), "Reader bypassed the registry writer's lock" + atomic_write_json(manager.registry_path, document) + assert future.result(timeout=5) == document["plugins"] + assert json.loads(manager.registry_path.read_bytes()) == document + + +def test_migrating_empty_registry_does_not_restore_trust_or_grants(manager, tmp_path): + source = tmp_path / "plugin-source" + source.mkdir() + manifest = { + "schemaVersion": 1, + "id": "test.previous-trust", + "name": "Previously installed plugin", + "version": "1.0.0", + "runtime": "trusted", + "entryPoint": "main.exec", + "defaultEnabled": True, + "permissions": ["theme.register"], + } + (source / "plugin.info").write_text(json.dumps(manifest), encoding="utf-8") + (source / "main.exec").write_text( + "raise RuntimeError('This plugin must not execute during migration')\n", encoding="utf-8" + ) + package = tmp_path / "plugin.lcp" + build_package(source, package) + manager.install(package) + manager.registry_path.write_text("{}", encoding="utf-8") + restored = PluginManager(manager.root, manager.registry_path).get(manifest["id"]) + assert restored.state == PluginState.DISABLED + assert restored.granted == set() + assert restored.trusted is False + assert restored.module is None + + +@pytest.mark.parametrize("legacy", [False, True], ids=["fresh", "legacy-empty"]) +def test_lanip_gui_bootstrap_uses_real_migration_and_registry(tmp_path, legacy): + # Fresh interpreter: path defaults and the plugin singleton belong to this data directory. + script = """ +import json +import os +from pathlib import Path +from unittest.mock import patch +root = Path(os.environ['LANCTL_DATA_DIR']) +from lanctl.core.file_transaction import atomic_write_text +atomic_write_text(root / 'config/migration-v2.complete', 'LANCTL-DATA-V2\\n') +from lanctl.core.data_migration import ensure_data_layout +ensure_data_layout() +registry = root / 'plugins/registry.json' +if os.environ['P44_LEGACY'] == '1': + registry.write_text('{}', encoding='utf-8') +from lanctl.core.config import load_config, save_config +config = load_config() +config.update(pluginSafeMode=True, projectsDirectory=str(root / 'projects-test')) +save_config(config) +from lanctl.apps.ip.interfaces.gui.desktop import DesktopApi +from lanctl.bootstrap.lanip import main +def gui(): + result = DesktopApi().bootstrap() + assert result['ok'], result + return 0 +with patch('lanctl.apps.ip.interfaces.gui.desktop.run_gui', side_effect=gui) as launch: + assert main(['--gui']) == 0 + launch.assert_called_once() +assert json.loads(registry.read_text(encoding='utf-8'))['schemaVersion'] == 1 +print('P44_BOOTSTRAP_OK') +""" + options = {"creationflags": subprocess.CREATE_NO_WINDOW} if sys.platform == "win32" else {} + result = subprocess.run( + [sys.executable, "-c", script], + env={ + **os.environ, + "LANCTL_DATA_DIR": str(tmp_path / "data"), + "LANCTL_SECRET_DIR": str(tmp_path / "secrets"), + "P44_LEGACY": str(int(legacy)), + }, + capture_output=True, + text=True, + encoding="utf-8", + errors="replace", + timeout=40, + **options, + ) + assert result.returncode == 0, result.stdout + result.stderr + assert "P44_BOOTSTRAP_OK" in result.stdout diff --git a/tests/test_plugin_revocation.py b/tests/test_plugin_revocation.py new file mode 100644 index 0000000..2c3a2d1 --- /dev/null +++ b/tests/test_plugin_revocation.py @@ -0,0 +1,365 @@ +"""Revocation must invalidate retained API objects and callback references.""" + +import json +import subprocess +import sys +import threading +import time + +import pytest +from cryptography.hazmat.primitives import serialization +from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PrivateKey + +from lanctl.core.plugins.contracts import FunctionResult +from lanctl.core.plugins.manager import PluginManager +from lanctl.core.plugins.package import build_package + + +@pytest.fixture +def running(tmp_path, monkeypatch): + monkeypatch.setattr(PluginManager, "audit", lambda *a: None) + monkeypatch.setattr("lanctl.core.config.CONFIG_PATH", tmp_path / "config.json") + from lanctl.core.config import update_config + + update_config(lambda c: c.update({"smbStorage": str(tmp_path / "storage")})) + key = tmp_path / "test.pem" + key.write_bytes( + Ed25519PrivateKey.generate().private_bytes( + serialization.Encoding.PEM, + serialization.PrivateFormat.PKCS8, + serialization.NoEncryption(), + ) + ) + source = tmp_path / "source" + source.mkdir() + permissions = { + "functions.register", + "events.listen", + "plugin.storage", + "monitor.check.register", + } + (source / "plugin.info").write_text( + json.dumps( + { + "schemaVersion": 1, + "id": "review.plugin", + "version": "1.0.0", + "runtime": "trusted", + "permissions": sorted(permissions), + } + ), + encoding="utf-8", + ) + (source / "main.exec").write_text( + "def activate(api):\n global saved_api\n saved_api = api\n", encoding="utf-8" + ) + package = tmp_path / "review.lcp" + build_package(source, package, signing_key=key) + manager = PluginManager(tmp_path / "plugins", tmp_path / "registry.json") + manager.install(package) + publisher = manager.publishers.trust_package(package) + plugin = manager.enable("review.plugin", grant=permissions, trusted=True) + yield manager, plugin, publisher + close = getattr(manager, "close", None) + if close: + close() + + +def test_retained_api_is_revoked_after_disable_and_stays_revoked_after_reload(running): + manager, plugin, _ = running + old = plugin.module.saved_api + manager.disable("review.plugin") + with pytest.raises(PermissionError): + old.require("functions.register") + manager.enable("review.plugin", trusted=True) + plugin.module.saved_api.require("functions.register") + with pytest.raises(PermissionError): + old.log("stale reference") + + +def test_foreign_manager_revocation_blocks_saved_function_and_storage(running): + manager, plugin, _ = running + api = plugin.module.saved_api + calls = [] + api.functions.register( + "Review.Plugin.Action.Run", lambda: calls.append(1) or FunctionResult(True), FunctionResult + ) + handler = manager.functions._items["review.plugin.action.run"][1] + storage = api.storage.open() + other = PluginManager(manager.root, manager.registry_path) + other.revoke("review.plugin") + with pytest.raises(PermissionError): + handler() + with pytest.raises(PermissionError): + storage.put_observation("device", {"value": 1}) + assert calls == [] + assert not storage.path.exists() + assert manager.runtime_status("review.plugin")["coreAccess"] is False + assert manager.runtime_status("review.plugin")["restartRequired"] is True + + +def test_publisher_revocation_rejects_api_without_waiting_for_background_poll(running): + manager, plugin, publisher = running + api = plugin.module.saved_api + manager.publishers.revoke(publisher["fingerprint"]) + with pytest.raises(PermissionError): + api.settings + assert not manager.runtime_status("review.plugin")["active"] + + +def test_deactivation_executes_without_holding_registry_lock(running): + from lanctl.core.file_transaction import locked_file + + manager, plugin, _ = running + acquired = threading.Event() + + def deactivate(): + with locked_file(manager.registry_path, timeout=0.2): + acquired.set() + + plugin.module.deactivate = deactivate + manager.disable("review.plugin") + assert acquired.is_set() + + +def test_hanging_deactivation_does_not_block_revocation_or_allow_reactivation(running): + manager, plugin, _ = running + entered, finish = threading.Event(), threading.Event() + + def deactivate(): + entered.set() + finish.wait(3) + + plugin.module.deactivate = deactivate + started = time.monotonic() + try: + manager.disable("review.plugin") + assert time.monotonic() - started < 1.5 + assert entered.is_set() + assert manager.runtime_status("review.plugin")["cleanupPending"] + with pytest.raises(RuntimeError, match="desactivación anterior"): + manager.enable("review.plugin", trusted=True) + finally: + finish.set() + + +def test_retained_monitor_check_rejects_execution_and_registry_is_cleaned(running): + from lanctl.apps.monitor.models import CheckResult + + manager, plugin, _ = running + called = [] + spec = plugin.module.saved_api.monitor.register_check( + "review-check", lambda: called.append(1) or CheckResult("review-check", "x", True) + ) + manager.disable("review.plugin") + assert not manager.monitor_checks.list() + with pytest.raises(PermissionError): + spec.handler() + assert called == [] + + +def test_background_refresh_reconciles_foreign_manager_without_api_calls(running): + manager, plugin, _ = running + manager._authorization.start_watch() + other = PluginManager(manager.root, manager.registry_path) + other.disable("review.plugin") + deadline = time.monotonic() + 3 + while plugin.manifest.plugin_id in manager._active and time.monotonic() < deadline: + time.sleep(0.05) + assert plugin.manifest.plugin_id not in manager._active + assert plugin.module is None + + +def test_corrupted_authority_fails_closed_without_overwriting_file(running): + manager, plugin, _ = running + api = plugin.module.saved_api + manager.registry_path.write_text("invalid", encoding="utf-8") + with pytest.raises((ValueError, PermissionError)): + api.require("plugin.storage") + assert not manager._active + assert manager.registry_path.read_text() == "invalid" + + +def test_revocation_from_separate_process_invalidates_current_api(running): + manager, plugin, _ = running + api = plugin.module.saved_api + subprocess.run( + [ + sys.executable, + "-c", + ( + "from pathlib import Path; import sys; " + "from lanctl.core.plugins.manager import PluginManager; " + "PluginManager.audit=lambda *a: None; " + "PluginManager(Path(sys.argv[1]), Path(sys.argv[2])).revoke('review.plugin')" + ), + str(manager.root), + str(manager.registry_path), + ], + check=True, + capture_output=True, + timeout=20, + ) + with pytest.raises(PermissionError): + api.require("functions.register") + assert not manager.runtime_status("review.plugin")["active"] + + +def test_revocation_during_function_does_not_report_authorized_success(running): + manager, plugin, _ = running + entered, finish = threading.Event(), threading.Event() + errors = [] + + def function(): + entered.set() + assert finish.wait(3) + return FunctionResult(True) + + plugin.module.saved_api.functions.register( + "Review.Plugin.Action.Slow", function, FunctionResult + ) + handler = manager.functions._items["review.plugin.action.slow"][1] + + def invoke(): + try: + handler() + except PermissionError as error: + errors.append(error) + + thread = threading.Thread(target=invoke) + thread.start() + try: + assert entered.wait(3) + manager.disable("review.plugin") + finally: + finish.set() + thread.join(3) + assert not thread.is_alive() + assert len(errors) == 1 + + +def test_retained_event_callback_is_revoked(running): + manager, plugin, _ = running + called = [] + event_id = "LANCTL.Core.Lifecycle.Startup" + plugin.module.saved_api.events.subscribe(event_id, lambda event: called.append(event)) + handler = manager.events._subscriptions[(event_id.casefold(), 1)][0][2] + manager.disable("review.plugin") + with pytest.raises(PermissionError): + handler(object()) + assert not called + + +def test_pending_unstarted_cleanup_blocks_new_generation(running, monkeypatch): + manager, _, _ = running + drain = manager._authorization.drain + monkeypatch.setattr(manager._authorization, "drain", lambda: None) + try: + manager.disable("review.plugin") + assert manager.runtime_status("review.plugin")["cleanupPending"] + with pytest.raises(RuntimeError, match="desactivación anterior"): + manager.enable("review.plugin", trusted=True) + finally: + drain() + + +def test_reload_finishes_cleanup_before_new_activation_and_retains_warning(running): + manager, plugin, _ = running + previous = plugin.module.saved_api + closed = [] + plugin.module.deactivate = lambda: closed.append(True) + manager.reload("review.plugin") + assert closed == [True] + assert plugin.module.saved_api is not previous + assert manager.runtime_status("review.plugin")["restartRequired"] + manager.discover() + assert manager.runtime_status("review.plugin")["restartRequired"] + + +def test_foreign_revocation_cascades_to_dependent_generations(running, tmp_path): + manager, _, _ = running + parent = "review.plugin" + for plugin_id in ("review.child", "review.grandchild"): + source = tmp_path / plugin_id + source.mkdir() + (source / "plugin.info").write_text( + json.dumps( + { + "schemaVersion": 1, + "id": plugin_id, + "version": "1.0.0", + "runtime": "isolated", + "depends": [parent], + } + ), + encoding="utf-8", + ) + package = tmp_path / (plugin_id + ".lcp") + build_package(source, package) + manager.install(package) + manager.enable(plugin_id) + parent = plugin_id + other = PluginManager(manager.root, manager.registry_path) + other.revoke("review.plugin") + manager.refresh_authorizations() + for plugin_id in ("review.plugin", "review.child", "review.grandchild"): + assert not manager.runtime_status(plugin_id)["coreAccess"] + assert plugin_id not in manager._active + + +def test_isolated_process_death_retires_runtime(running, tmp_path): + manager, _, _ = running + source = tmp_path / "isolated" + source.mkdir() + (source / "plugin.info").write_text( + json.dumps( + { + "schemaVersion": 1, + "id": "review.isolated", + "version": "1.0.0", + "runtime": "isolated", + } + ), + encoding="utf-8", + ) + (source / "main.exec").write_text("def activate(api):\n pass\n", encoding="utf-8") + package = tmp_path / "isolated.lcp" + build_package(source, package) + manager.install(package) + plugin = manager.enable("review.isolated") + process = plugin.isolated_runtime.process + process.terminate() + process.join(3) + state = manager.runtime_status("review.isolated") + assert not state["active"] and not state["coreAccess"] + assert plugin.state.value == "ERROR" + assert plugin.isolated_runtime is None + + +def test_concurrent_first_access_creates_one_manager_and_authorization_watcher(monkeypatch): + from concurrent.futures import ThreadPoolExecutor + from types import SimpleNamespace + from unittest.mock import Mock + + from lanctl.core.plugins import manager as module + + created = [] + start = threading.Barrier(8) + + def create(): + time.sleep(0.02) + instance = SimpleNamespace(_authorization=SimpleNamespace(start_watch=Mock())) + created.append(instance) + return instance + + def retrieve(): + start.wait(timeout=3) + return module.get_plugin_manager() + + monkeypatch.setattr(module, "_MANAGER", None) + monkeypatch.setattr(module, "PluginManager", create) + with ThreadPoolExecutor(max_workers=8) as executor: + found = list(executor.map(lambda _: retrieve(), range(8))) + assert len(created) == 1 + assert all(item is created[0] for item in found) + created[0]._authorization.start_watch.assert_called_once() diff --git a/tests/test_plugin_security_review.py b/tests/test_plugin_security_review.py new file mode 100644 index 0000000..01332b4 --- /dev/null +++ b/tests/test_plugin_security_review.py @@ -0,0 +1,442 @@ +"""Backend regressions for the plugin audit of 2026-10-16.""" + +import json +from concurrent.futures import ThreadPoolExecutor +from pathlib import Path +from threading import Event +from unittest.mock import Mock + +import pytest +from cryptography.hazmat.primitives import serialization +from cryptography.hazmat.primitives.asymmetric.ed25519 import Ed25519PrivateKey + +from lanctl.core.plugins.manager import PluginManager +from lanctl.core.plugins.models import PluginState +from lanctl.core.plugins.package import build_package +from lanctl.core.plugins.publishers import TrustedPublisherStore + + +@pytest.fixture +def factory(tmp_path, monkeypatch): + monkeypatch.setattr(PluginManager, "audit", Mock()) + key = tmp_path / "publisher.pem" + key.write_bytes( + Ed25519PrivateKey.generate().private_bytes( + serialization.Encoding.PEM, + serialization.PrivateFormat.PKCS8, + serialization.NoEncryption(), + ) + ) + + def create(plugin_id="test.plugin", *, signed=True, runtime="trusted", **fields): + source = tmp_path / "sources" / plugin_id + source.mkdir(parents=True, exist_ok=True) + manifest = { + "schemaVersion": 1, + "id": plugin_id, + "name": plugin_id, + "version": "1.0.0", + "runtime": runtime, + "permissions": ["theme.register"], + **fields, + } + (source / "plugin.info").write_text(json.dumps(manifest), encoding="utf-8") + (source / "main.exec").write_text( + "def activate(api):\n api.log('EXECUTED')\n", encoding="utf-8" + ) + package = tmp_path / f"{plugin_id}.lcp" + build_package(source, package, overwrite=True, signing_key=key if signed else None) + return package + + manager = PluginManager(tmp_path / "plugins", tmp_path / "registry.json") + return manager, create + + +def authorize(manager, package): + plugin = manager.install(package) + manager.publishers.trust_package(package) + return manager.enable(plugin.manifest.plugin_id, grant={"theme.register"}, trusted=True) + + +def edit_registry(manager, plugin_id, **changes): + document = json.loads(manager.registry_path.read_text(encoding="utf-8")) + document["plugins"][plugin_id].update(changes) + manager.registry_path.write_text(json.dumps(document), encoding="utf-8") + + +@pytest.mark.parametrize("operation", ["verify", "enable", "reload"]) +def test_changed_installed_code_is_never_verified_or_executed(factory, operation): + manager, create = factory + plugin = authorize(manager, create()) + manager.disable("test.plugin") + (plugin.path / "main.exec").write_text( + "def activate(api):\n api.log('TAMPERED')\n", encoding="utf-8" + ) + manager.audit.reset_mock() + with pytest.raises(ValueError, match=r"integridad|checksum"): + getattr(manager, operation)("test.plugin") + assert not any(c.args[1] == "TAMPERED" for c in manager.audit.call_args_list) + + +def test_removed_signature_is_not_recovered_from_cached_registry(factory): + manager, create = factory + plugin = authorize(manager, create()) + manager.disable("test.plugin") + (plugin.path / "meta/signature").unlink() + fresh = PluginManager(manager.root, manager.registry_path) + assert fresh.get("test.plugin").state == PluginState.QUARANTINED + with pytest.raises((ValueError, PermissionError)): + fresh.enable("test.plugin") + + +def test_discovery_recovers_signature_of_preinstalled_signed_package(factory): + from lanctl.core.plugins.package import install_package + + manager, create = factory + install_package(create(), manager.root) + fresh = PluginManager(manager.root, manager.registry_path) + assert fresh.get("test.plugin").signature.startswith("VALID_ED25519:") + assert not fresh.publishers.is_trusted(fresh.get("test.plugin").signature) + + +@pytest.mark.parametrize( + "changes", + [ + {"granted": []}, + {"granted": ["theme.register", "credentials.read.scoped"]}, + ], +) +def test_startup_revalidates_grants_before_loading_code(factory, changes): + manager, create = factory + authorize(manager, create()) + edit_registry(manager, "test.plugin", **changes) + fresh = PluginManager(manager.root, manager.registry_path) + fresh.activate_enabled() + assert fresh.get("test.plugin").state != PluginState.ENABLED + assert fresh.get("test.plugin").module is None + assert fresh.get("test.plugin").error + + +def test_startup_rechecks_lanctl_compatibility(factory, monkeypatch): + manager, create = factory + authorize(manager, create(lanctl={"maximumVersion": "0.x"})) + fresh = PluginManager(manager.root, manager.registry_path) + monkeypatch.setattr("lanctl.core.plugins.manager.__version__", "1.0.0") + fresh.activate_enabled() + assert fresh.get("test.plugin").state == PluginState.INCOMPATIBLE + assert fresh.get("test.plugin").module is None + + +def test_repeated_enable_does_not_run_activation_twice(factory): + manager, create = factory + plugin = authorize(manager, create()) + module = plugin.module + manager.audit.reset_mock() + manager.enable("test.plugin") + assert plugin.module is module + assert not any(c.args[1] == "EXECUTED" for c in manager.audit.call_args_list) + + +def test_failed_grant_change_cleans_up_running_plugin(factory): + manager, create = factory + plugin = authorize(manager, create()) + plugin.module.deactivate = Mock() + deactivate = plugin.module.deactivate + with pytest.raises(PermissionError): + manager.enable("test.plugin", grant=set()) + deactivate.assert_called_once() + assert plugin.module is None + assert plugin.state == PluginState.BLOCKED + + +def test_unsigned_trusted_block_has_persistent_reason(factory): + manager, create = factory + manager.install(create(signed=False)) + with pytest.raises(PermissionError, match=r"firma|firmado"): + manager.enable("test.plugin", grant={"theme.register"}, trusted=True) + plugin = manager.get("test.plugin") + assert plugin.state == PluginState.BLOCKED and plugin.error + fresh = PluginManager(manager.root, manager.registry_path) + assert fresh.get("test.plugin").error == plugin.error + + +@pytest.mark.parametrize( + "document", [[], {"schemaVersion": 999, "plugins": {}}, {"schemaVersion": 1, "plugins": []}] +) +def test_corrupt_registry_is_not_treated_as_empty(factory, document): + manager, _ = factory + manager.registry_path.write_text(json.dumps(document), encoding="utf-8") + with pytest.raises(ValueError, match="registro"): + PluginManager(manager.root, manager.registry_path) + assert json.loads(manager.registry_path.read_text(encoding="utf-8")) == document + + +@pytest.mark.parametrize( + "document", + [[], {"schemaVersion": 999, "publishers": {}}, {"schemaVersion": 1, "publishers": {"bad": {}}}], +) +def test_malformed_publisher_store_reports_validation_error(tmp_path, document): + path = tmp_path / "publishers.json" + path.write_text(json.dumps(document), encoding="utf-8") + with pytest.raises(ValueError, match="almacén"): + TrustedPublisherStore(path).list() + + +def test_dependency_order_at_startup_is_independent_of_display_name(factory): + manager, create = factory + authorize(manager, create("test.dependency", name="ZZZ")) + authorize(manager, create("test.consumer", name="AAA", depends=["test.dependency"])) + fresh = PluginManager(manager.root, manager.registry_path) + order = [] + original = fresh._activate + + def record(plugin): + order.append(plugin.manifest.plugin_id) + original(plugin) + + fresh._activate = record + fresh.activate_enabled() + assert order.index("test.dependency") < order.index("test.consumer") + + +def test_dependency_version_is_checked(factory): + manager, create = factory + authorize(manager, create("test.dependency")) + package = create("test.consumer", depends=[{"id": "test.dependency", "version": ">=2.0.0"}]) + manager.install(package) + with pytest.raises(ValueError, match="dependencia"): + manager.enable("test.consumer", grant={"theme.register"}, trusted=True) + + +def test_reinstall_releases_previous_runtime(factory): + manager, create = factory + plugin = authorize(manager, create()) + plugin.module.deactivate = Mock() + deactivate = plugin.module.deactivate + replacement = manager.install(create(version="1.1.0")) + deactivate.assert_called_once() + assert replacement.state == PluginState.DISABLED + assert not replacement.granted and not replacement.trusted + + +def test_quarantine_remains_visible_after_another_restart(factory): + manager, create = factory + plugin = authorize(manager, create()) + manager.disable("test.plugin") + (plugin.path / "meta/signature").write_text("{}", encoding="utf-8") + first = PluginManager(manager.root, manager.registry_path) + assert first.get("test.plugin").state == PluginState.QUARANTINED + second = PluginManager(manager.root, manager.registry_path) + assert second.get("test.plugin").state == PluginState.QUARANTINED + with pytest.raises(ValueError, match="integridad"): + second.enable("test.plugin", grant={"theme.register"}, trusted=True) + + +def test_quarantine_history_does_not_resurrect_uninstalled_plugin(factory): + manager, create = factory + plugin = authorize(manager, create()) + manager.disable("test.plugin") + (plugin.path / "meta/signature").write_text("{}", encoding="utf-8") + fresh = PluginManager(manager.root, manager.registry_path) + assert fresh.get("test.plugin").state == PluginState.QUARANTINED + fresh.install(create(version="1.1.0")) + fresh.uninstall("test.plugin") + restarted = PluginManager(manager.root, manager.registry_path) + assert "test.plugin" not in {p.manifest.plugin_id for p in restarted.list()} + + +def test_startup_does_not_load_consumer_when_dependency_fails(factory): + manager, create = factory + authorize(manager, create("test.dependency")) + authorize(manager, create("test.consumer", depends=["test.dependency"])) + edit_registry(manager, "test.dependency", granted=[]) + fresh = PluginManager(manager.root, manager.registry_path) + fresh.activate_enabled() + assert fresh.get("test.dependency").state == PluginState.ERROR + assert fresh.get("test.consumer").state == PluginState.ERROR + assert fresh.get("test.consumer").module is None + + +def test_dependency_cycles_are_reported_without_loading_code(factory): + manager, create = factory + for plugin_id, dependency in (("test.first", "test.second"), ("test.second", "test.first")): + package = create(plugin_id, depends=[dependency]) + manager.install(package) + manager.publishers.trust_package(package) + for plugin_id in ("test.first", "test.second"): + edit_registry(manager, plugin_id, state="ENABLED", granted=["theme.register"], trusted=True) + fresh = PluginManager(manager.root, manager.registry_path) + fresh.activate_enabled() + for plugin_id in ("test.first", "test.second"): + assert fresh.get(plugin_id).state == PluginState.ERROR + assert fresh.get(plugin_id).module is None + + +def test_disabling_dependency_unloads_its_consumers(factory): + manager, create = factory + authorize(manager, create("test.dependency")) + authorize(manager, create("test.consumer", depends=["test.dependency"])) + manager.disable("test.dependency") + assert manager.get("test.consumer").state == PluginState.DISABLED + assert manager.get("test.consumer").module is None + + +def test_discovery_releases_previous_runtime_before_reactivation(factory): + manager, create = factory + plugin = authorize(manager, create()) + plugin.module.deactivate = Mock() + deactivate = plugin.module.deactivate + manager.discover() + deactivate.assert_called_once() + manager.activate_enabled() + assert manager.get("test.plugin").module is not None + + +def test_other_plugin_update_does_not_restore_revoked_permissions(factory): + manager, create = factory + authorize(manager, create("test.first")) + authorize(manager, create("test.second")) + another = PluginManager(manager.root, manager.registry_path) + another.revoke("test.first") + manager.disable("test.second") + saved = json.loads(manager.registry_path.read_text(encoding="utf-8"))["plugins"] + assert saved["test.first"]["granted"] == [] + assert saved["test.first"]["state"] == "DISABLED" + assert saved["test.second"]["state"] == "DISABLED" + with pytest.raises(ValueError, match="otro proceso"): + manager.enable("test.first") + assert manager.get("test.first").module is None + assert manager.get("test.first").state == PluginState.BLOCKED + + +def test_two_managers_install_different_plugins_without_losing_entries(factory): + first, create = factory + second = PluginManager(first.root, first.registry_path) + first.install(create("test.first")) + second.install(create("test.second")) + saved = json.loads(first.registry_path.read_text(encoding="utf-8"))["plugins"] + assert {"test.first", "test.second"} <= saved.keys() + + +def test_stale_install_cannot_replace_a_package_installed_by_another_manager(factory): + first, create = factory + second = PluginManager(first.root, first.registry_path) + installed = first.install(create()) + original_info = (installed.path / "plugin.info").read_bytes() + with pytest.raises(ValueError, match="otro proceso"): + second.install(create(version="2.0.0")) + assert (installed.path / "plugin.info").read_bytes() == original_info + + +def test_startup_refreshes_revocation_made_after_discovery(factory): + manager, create = factory + authorize(manager, create()) + fresh = PluginManager(manager.root, manager.registry_path) + manager.revoke("test.plugin") + fresh.activate_enabled() + assert fresh.get("test.plugin").state == PluginState.DISABLED + assert fresh.get("test.plugin").module is None + + +def test_failure_to_persist_activation_unloads_the_runtime(factory, monkeypatch): + manager, create = factory + package = create() + manager.install(package) + manager.publishers.trust_package(package) + original_registry = manager.registry_path.read_bytes() + + def fail_write(*args, **kwargs): + raise OSError("simulated disk failure") + + monkeypatch.setattr("lanctl.core.plugins.manager.atomic_write_json", fail_write) + with pytest.raises(OSError, match="simulated disk failure"): + manager.enable("test.plugin", grant={"theme.register"}, trusted=True) + assert manager.get("test.plugin").module is None + assert manager.get("test.plugin").state == PluginState.BLOCKED + assert manager.registry_path.read_bytes() == original_registry + + +def test_failure_to_persist_startup_unloads_all_runtimes(factory, monkeypatch): + manager, create = factory + authorize(manager, create()) + fresh = PluginManager(manager.root, manager.registry_path) + + def fail_write(*args, **kwargs): + raise OSError("simulated startup disk failure") + + monkeypatch.setattr("lanctl.core.plugins.manager.atomic_write_json", fail_write) + with pytest.raises(OSError, match="simulated startup disk failure"): + fresh.activate_enabled() + assert not fresh.initialized + assert not fresh._active + assert all(p.module is None and p.isolated_runtime is None for p in fresh.list()) + + +def test_trusting_another_editor_cannot_restore_concurrently_revoked_editor(factory, monkeypatch): + manager, create = factory + original_package = create("test.original") + original = manager.publishers.trust_package(original_package) + # A second publisher uses a different key. + key = original_package.parent / "publisher.pem" + key.write_bytes( + Ed25519PrivateKey.generate().private_bytes( + serialization.Encoding.PEM, + serialization.PrivateFormat.PKCS8, + serialization.NoEncryption(), + ) + ) + new_package = create("test.new") + first = TrustedPublisherStore(manager.publishers.path) + second = TrustedPublisherStore(manager.publishers.path) + read_started, continue_write = Event(), Event() + original_read = first._read + + def slow_read(): + value = original_read() + read_started.set() + assert continue_write.wait(5) + return value + + monkeypatch.setattr(first, "_read", slow_read) + with ThreadPoolExecutor(max_workers=2) as pool: + trust = pool.submit(first.trust_package, new_package) + assert read_started.wait(5) + revoke = pool.submit(second.revoke, original["fingerprint"]) + continue_write.set() + added = trust.result(timeout=5) + assert revoke.result(timeout=5) + assert [p["fingerprint"] for p in manager.publishers.list()] == [added["fingerprint"]] + + +@pytest.mark.parametrize("plugin_id", ["lanctl.network.wol", "lanctl.discovery.mdns-ssdp"]) +def test_bundled_trusted_plugins_cannot_bypass_signature_using_all_permissions(factory, plugin_id): + manager, _ = factory + # Build unsigned fixtures so publishing signed official packages later does + # not make this negative test depend on the current distribution problem. + package = manager.registry_path.parent / "unsigned-fixture.lcp" + build_package(Path(__file__).resolve().parents[1] / "plugins-src" / plugin_id, package) + plugin = manager.install(package) + assert plugin.signature == "UNSIGNED" + with pytest.raises(PermissionError, match="firmado"): + manager.enable(plugin_id, grant=set(plugin.manifest.permissions), trusted=True) + assert plugin.module is None + assert plugin.state == PluginState.BLOCKED + + +@pytest.mark.parametrize( + "requirement, expected", + [ + ("*", True), + ("1.x", True), + ("1.0.*", True), + (">=1.0.0,<2.0.0", True), + ("==1.0.0", True), + ("!=1.x", False), + (">=2.0.0", False), + ("2.0.0", False), + ], +) +def test_dependency_constraints(requirement, expected): + from lanctl.core.plugins.manager import _matches_dependency + + assert _matches_dependency("1.0.0", requirement) is expected diff --git a/tests/test_project_paths.py b/tests/test_project_paths.py index bd033ed..26cf4ef 100644 --- a/tests/test_project_paths.py +++ b/tests/test_project_paths.py @@ -38,12 +38,23 @@ def test_relative_project_uses_configured_directory(self): def test_environment_variable_in_configured_directory_is_expanded(self): with ( tempfile.TemporaryDirectory() as temporary, + patch.dict(os.environ, {"LANCTL_TEST_PROJECT_ROOT": temporary}), + ): + expected = Path(temporary) / "CustomProjects" / "Hogar.vlf" + self.assertEqual( + resolve_project_path("Hogar", "$LANCTL_TEST_PROJECT_ROOT/CustomProjects"), + expected.resolve(), + ) + + def test_legacy_default_falls_back_when_known_folder_is_unavailable(self): + with ( + tempfile.TemporaryDirectory() as temporary, + patch("lanctl.core.projects.paths._known_documents_directory", return_value=None), patch.dict(os.environ, {"USERPROFILE": temporary}), ): - expected = Path(temporary) / "Documents" / "LanCTL" / "Hogar.vlf" self.assertEqual( resolve_project_path("Hogar", r"%USERPROFILE%\Documents\LanCTL"), - expected.resolve(), + (Path(temporary) / "Documents" / "LanCTL" / "Hogar.vlf").resolve(), ) def test_absolute_project_path_is_never_relocated(self): diff --git a/tests/test_rack_dimensions.py b/tests/test_rack_dimensions.py new file mode 100644 index 0000000..746abb6 --- /dev/null +++ b/tests/test_rack_dimensions.py @@ -0,0 +1,95 @@ +import json + +import pytest + +from lanctl.apps.rack.service import RackService +from lanctl.apps.wire.gui_service import WireGuiService +from lanctl.apps.wire.idf.database import IDFDatabaseManager +from lanctl.core.rack_dimensions import dimension_status + + +@pytest.mark.parametrize("units", [4, 52]) +@pytest.mark.parametrize("width", [10, 19, 21, 23]) +def test_dimensions_roundtrip_through_shared_database(tmp_path, units, width): + path = tmp_path / "idf.db" + wire = WireGuiService(path) + identifier = wire.create( + {"kind": "rack", "prefix": "RK", "units": units, "widthInches": width} + )["id"] + rack = RackService(str(path)).get(identifier) + assert (rack["units"], rack["widthInches"]) == (units, width) + assert not rack["dimensions"]["needsReview"] + assert wire.database.get(identifier)["data"]["rackDimensions"] == { + "schemaVersion": 1, + "widthInches": width, + } + + +@pytest.mark.parametrize("units", [3, 53, 4.5, True, "42", None]) +def test_invalid_height_rejected_without_coercion(tmp_path, units): + wire = WireGuiService(tmp_path / "idf.db") + with pytest.raises(ValueError): + wire.create({"kind": "rack", "prefix": "RK", "units": units}) + with pytest.raises(ValueError): + wire.database.add("RK-01", {"type": "rack", "units": units}) + assert wire.database.all() == [] + + +@pytest.mark.parametrize("width", [9, 20, 24, 19.0, True, "19"]) +def test_invalid_width_refused(tmp_path, width): + wire = WireGuiService(tmp_path / "idf.db") + with pytest.raises(ValueError): + wire.create({"kind": "rack", "prefix": "RK", "units": 42, "widthInches": width}) + + +def test_shrink_rejected_in_shared_database_and_stale_editor(tmp_path): + path = tmp_path / "idf.db" + service = RackService(str(path)) + service.database.add("RK-01", {"type": "rack", "units": 42}) + service.database.add( + "SW-01", {"type": "device.switch", "location": {"rack": "RK-01", "unit": 40}} + ) + expected = service.snapshot()["organizationRevision"] + before = path.read_bytes() + with pytest.raises(ValueError, match="fuera"): + service.set_dimensions(expected, "RK-01", {"units": 39, "widthInches": 19}) + assert path.read_bytes() == before + service.set_dimensions(expected, "RK-01", {"units": 52, "widthInches": 23}) + with pytest.raises(ValueError, match="cambió"): + service.set_dimensions(expected, "RK-01", {"units": 52, "widthInches": 19}) + data = service.database.get("RK-01")["data"] + data["units"] = 4 + with pytest.raises(ValueError, match="fuera"): + service.database.update("RK-01", data) + assert service.database.get("SW-01")["data"]["location"]["unit"] == 40 + + +def test_legacy_out_of_range_and_unknown_width_preserved_until_explicit_edit(tmp_path): + path = tmp_path / "idf.db" + database = IDFDatabaseManager(path) + database.add("RK-01", {"type": "rack", "units": 42}) + document = json.loads(path.read_text(encoding="utf-8")) + document["records"]["RK-01"]["data"] = {"type": "rack", "size_units": 60, "name": "legacy"} + path.write_text(json.dumps(document), encoding="utf-8") + before = path.read_bytes() + service = RackService(str(path)) + rack = service.get("RK-01") + assert rack["units"] == 60 and rack["widthInches"] is None + assert rack["dimensions"]["needsReview"] + assert path.read_bytes() == before + service.set_dimensions( + service.snapshot()["organizationRevision"], "RK-01", {"units": 52, "widthInches": 21} + ) + reopened = IDFDatabaseManager(path).get("RK-01")["data"] + assert reopened["units"] == reopened["size_units"] == 52 + assert not dimension_status(reopened)["needsReview"] + + +def test_in_memory_rack_model_uses_same_dimension_contract(): + from lanctl.apps.wire.models.rack import NetworkRack + + assert NetworkRack("test", 52, width_inches=23).width_inches == 23 + with pytest.raises(ValueError): + NetworkRack("test", 3) + with pytest.raises(ValueError): + NetworkRack("test", 4, width_inches=20) diff --git a/tests/test_rack_skins.py b/tests/test_rack_skins.py new file mode 100644 index 0000000..4379ab1 --- /dev/null +++ b/tests/test_rack_skins.py @@ -0,0 +1,158 @@ +"""Frentes de rack persistentes sin alterar el inventario de puertos.""" + +import os +from copy import deepcopy +from pathlib import Path + +import pytest +from test_launcher_gui import api +from test_launcher_gui import workspace as workspace + +from lanctl.apps.rack.skins import profiles + +pytest_plugins = ["test_launcher_gui"] + + +def setup_rack(): + wire, rack = api("lanwire"), api("lanrack") + rack_id = wire.wire_create( + {"kind": "rack", "prefix": "RK", "units": 18, "name": "Armario principal"} + )["id"] + devices = [] + for kind, prefix, name, unit in [ + ("switch.24ports", "SW", "Switch Rack", 13), + ("panel", "PN", "Panel de conexiones", 10), + ("server.2ports", "SV", "Servidor", 5), + ]: + identifier = wire.wire_create({"kind": kind, "prefix": prefix, "name": name})["id"] + row = next(r for r in wire.bootstrap()["records"] if r["id"] == identifier) + assert wire.wire_update(identifier, row["revision"], {"rack": rack_id, "unit": unit})["ok"] + devices.append(identifier) + ups = wire._service.database.create( + "UP", data={"type": "device.ups", "name": "SAI", "location": {"rack": rack_id, "unit": 1}} + )["id"] + return wire, rack, rack_id, [*devices, ups] + + +def save(rack, identifier, profile): + return rack.rack_appearance(rack.bootstrap()["organizationRevision"], identifier, profile) + + +def test_skin_catalog_and_shared_storage_integrity(workspace): + wire, rack, rack_id, devices = setup_rack() + catalog = {p["id"]: p for p in profiles()} + assert { + "switch-12-0", + "switch-24-0", + "switch-48-0", + "switch-48-2", + "switch-50-2", + "switch-48-4", + "server-2", + "ups-3", + "desktop-8", + } <= catalog.keys() + before = deepcopy(wire.bootstrap()["records"]) + assert save(rack, devices[0], catalog["switch-48-4"])["ok"] + assert save(rack, devices[2], catalog["server-2"])["ok"] + assert save(rack, devices[3], catalog["ups-3"])["ok"] + after = wire.bootstrap()["records"] + for a, b in zip(before, after, strict=True): + assert a["id"] == b["id"] + data = deepcopy(b["data"]) + data.pop("rackAppearance", None) + assert a["data"] == data + snapshot = rack.bootstrap()["records"][0] + assert snapshot["id"] == rack_id + assert next(r for r in snapshot["occupants"] if r["id"] == devices[2])["span"] == 2 + stale = rack.bootstrap()["organizationRevision"] + assert save(rack, devices[0], catalog["switch-24-0"])["ok"] + assert not rack.rack_appearance(stale, devices[0], catalog["desktop-8"])["ok"] + assert not wire.rack_appearance( + wire.bootstrap()["organizationRevision"], devices[0], catalog["desktop-8"] + )["ok"] + + +def test_skin_height_conflicts_and_wire_moves(workspace): + wire, rack, rack_id, devices = setup_rack() + profile = next(p for p in profiles() if p["id"] == "server-2") + assert save(rack, devices[2], profile)["ok"] + before = deepcopy(wire.bootstrap()["records"]) + assert not save(rack, devices[2], {**profile, "units": 8})["ok"] # Panel en U10. + assert not save(rack, devices[0], {**profile, "units": 8})["ok"] # Fuera del rack. + assert not save(rack, devices[0], {**profile, "rj45": True})["ok"] + assert wire.bootstrap()["records"] == before + row = next(r for r in before if r["id"] == devices[0]) + assert not wire.wire_update(row["id"], row["revision"], {"rack": rack_id, "unit": 6})["ok"] + row = next(r for r in before if r["id"] == rack_id) + assert not wire.wire_update(row["id"], row["revision"], {"units": 5})["ok"] + + +@pytest.mark.skipif( + os.environ.get("LANCTL_GUI_BROWSER_TESTS") != "1", reason="optional browser runtime" +) +def test_rack_skins_visual_editor_and_real_save(workspace): + playwright = pytest.importorskip("playwright.sync_api").sync_playwright + wire, rack, rack_id, devices = setup_rack() + catalog = {p["id"]: p for p in profiles()} + assert save(rack, devices[2], catalog["server-2"])["ok"] + assert save(rack, devices[3], catalog["ups-3"])["ok"] + root = Path(__file__).resolve().parents[1] + with playwright() as p: + browser = p.chromium.launch(channel="msedge", headless=True) + page = browser.new_page(viewport={"width": 1440, "height": 1000}) + errors = [] + page.on("pageerror", lambda e: errors.append(str(e))) + page.expose_function("rpc", lambda method, args: getattr(rack, method)(*args)) + page.goto((root / "gui/launcher.html").as_uri()) + page.evaluate( + "window.pywebview={api:new Proxy({}, {get:(_,m)=>(...args)=>rpc(m,args)})};window.dispatchEvent(new Event('pywebviewready'))" + ) + page.locator(f'[data-rack-open="{rack_id}"]').click() + front = page.locator(f'[data-rack-occupant="{devices[0]}"]') + assert front.locator('[data-connector="rj45"]').count() == 24 + assert page.locator(".rack-face.skin-server").count() == 1 + assert page.locator(".rack-face.skin-ups").count() == 1 + assert page.locator(".rack-skin-empty").count() == 11 + empty = page.locator(".rack-skin-empty").first.bounding_box() + assert abs(front.bounding_box()["height"] - empty["height"]) < 1 + server = page.locator(f'[data-rack-occupant="{devices[2]}"]').bounding_box() + assert abs(server["height"] - (2 * empty["height"] + 3)) < 1 + front.click() + page.get_by_role("button", name="Personalizar frente", exact=True).click() + for profile in catalog.values(): + page.locator("[name=preset]").select_option(profile["id"]) + assert page.locator(".rack-skin-preview svg").count() == 1 + page.locator("[name=preset]").select_option("switch-48-4") + assert page.locator('.rack-skin-preview [data-connector="rj45"]').count() == 48 + assert page.locator('.rack-skin-preview [data-connector="sfp"]').count() == 4 + page.locator("#submit").click() + page.wait_for_function("!document.querySelector('#detail').open") + assert ( + page.locator(f'[data-rack-occupant="{devices[0]}"] [data-connector="sfp"]').count() == 4 + ) + record = next(r for r in wire.bootstrap()["records"] if r["id"] == devices[0]) + assert len(record["data"]["ports"]) == 24 + page.screenshot(path=str(root / "tmp/lanrack-skins.png")) + page.locator("#rack-skins-toggle").click() + assert page.locator(".rack-face").count() == 0 + page.locator("#rack-skins-toggle").click() + assert page.locator(".rack-face").count() == 4 + page.locator(".rack-skin-size input").evaluate( + "e=>{e.value='36';e.dispatchEvent(new Event('change'))}" + ) + assert ( + abs(page.locator(f'[data-rack-occupant="{devices[0]}"]').bounding_box()["height"] - 36) + < 1 + ) + assert ( + page.evaluate( + "JSON.parse(localStorage.getItem('lanrack.skins.preferences')).schemaVersion" + ) + == 1 + ) + page.set_viewport_size({"width": 850, "height": 700}) + assert page.evaluate("document.documentElement.scrollWidth<=innerWidth") + assert page.locator("footer").bounding_box()["y"] < 700 + assert not errors, errors + browser.close() diff --git a/tests/test_remote_setup.py b/tests/test_remote_setup.py new file mode 100644 index 0000000..d175fea --- /dev/null +++ b/tests/test_remote_setup.py @@ -0,0 +1,224 @@ +import json +import os +from concurrent.futures import ThreadPoolExecutor +from types import SimpleNamespace +from unittest.mock import Mock + +import pytest + +from lanctl.apps.access import remote_setup as setup +from lanctl.apps.access.auth import AuthenticationService +from lanctl.apps.access.store import AccessStore + + +@pytest.fixture +def service(tmp_path, monkeypatch): + monkeypatch.setattr(setup, "require_admin", lambda: None) + return setup.InitialRemoteAccount(tmp_path / "service" / "users.dc") + + +def test_first_account_uses_existing_hash_and_authentication_without_exposing_secret(service): + api = setup.RemoteSetupApi(service) + password = "synthetic-setup-password" + assert api.setup_status()["canCreate"] + + result = api.create_initial_user(" First.Admin ", password, password) + + assert result["ok"] and result["username"] == "first.admin" + assert result["scope"] == "service" + stored = service.path.read_text(encoding="utf-8") + assert password not in stored + json.dumps(result) + json.dumps(api.setup_status()) + document = json.loads(stored) + assert document["users"][0]["passwordHash"].startswith("scrypt$16384$") + assert document["users"][0]["roles"] == ["administrator"] + assert document["users"][0]["sshKeys"] == [] + assert not api.setup_status()["canCreate"] + user = AuthenticationService(AccessStore(service.path)).authenticate_password( + "first.admin", password, "127.0.0.1" + ) + assert user.username == "first.admin" + assert not (service.path.parent / "config.json").exists() + + +@pytest.mark.parametrize("operation", ["status", "create"]) +def test_unprivileged_rpc_never_creates_store(service, monkeypatch, operation): + def denied(): + raise PermissionError("administrador requerido") + + monkeypatch.setattr(setup, "require_admin", denied) + with pytest.raises(PermissionError): + if operation == "status": + service.status() + else: + service.create("admin", "synthetic-password", "synthetic-password") + assert not service.path.parent.exists() + + +@pytest.mark.parametrize( + "username,password,confirmation", + [ + (None, "synthetic-password", "synthetic-password"), + ("ab", "synthetic-password", "synthetic-password"), + ("