Logotipo de Matlock Matlock

Matlock — Herramientas para Agentes y Desarrolladores. (Manual del Propietario y Referencia Operativa)

PARA AGENTES DE CODIFICACIÓN CON IA Y ORQUESTADORES: Salte directamente a Parte II: Especificación Operativa para Máquinas y Agentes Autónomos para consultar el catálogo MCP stdio de 27 herramientas, el desbloqueo HTTP 402 de doble vía, las reglas del entorno aislado de frontera seq_matlock / cold_box y los contratos de cierre.

Producto: Matlock — Herramientas para Agentes y Desarrolladores. (Eficiente. Exacto. Según las reglas.)
Posicionamiento: Verificación técnica local poliglota en < 50ms para AST, MITRE CWE, IEEE Std 1003.1 POSIX, CISA SSDF y AICPA SOC 2 Trust Services Criteria con sellos de pruebas Salvaguarda antimanipulación, entornos aislados Pre-CI de frontera, automatización CLI en 1 clic y MCP stdio local de 27 herramientas (0 subidas de código a la nube, 0 puertos abiertos, 0 bloqueo de git commit).
Editor: Matlock by Dutch P2P © 2026. Todos los derechos reservados.
Superficies: Centro de Comando de Escritorio (Windows, Linux y GoogleBook; macOS arm64 (matlock-mcp headless ready) — pulse ? o F1 en cualquier momento) · Centro de Comando Web · Escaneo Local Gratuito · Documentación · Manual en Línea · URI MCP matlock://help/appliance-manual

Alcance y Aviso Legal: Matlock evalúa controles técnicos de código y canalización frente a especificaciones y referencias publicadas de la industria (MITRE CWE, CISA SSDF, IEEE Std 1003.1 POSIX, compuertas automatizadas de integridad Pre-CI y controles técnicos de AICPA SOC 2 Trust Services Criteria). Matlock no garantiza software libre de defectos, no emite informes formales de atestación de terceros ni proporciona certificaciones de una firma independiente autorizada de contadores públicos certificados (CPA).


Parte I: Guía del Operador Humano y Banco de Trabajo

1. Glosario Rápido y Flujo Principal

2. Diseño de Pantalla, Temas y Navegación

3. Scripts Descubiertos, Comprobaciones Propias, Acciones y Favoritos

4. Rutinas Autónomas, Comandos de Equipo y Alertas Locales

TarjetaWindowsLinuxNotas
Shutdown in 30 minutesshutdown.exe /s /t 1800shutdown -h +30Espera de 30 min, nunca /f; junto a Cancel shutdown
Cancel shutdownshutdown.exe /ashutdown -cCancelación inmediata en 1 clic
Clean temporary filesSolo carpeta temp del usuario, omite en usoArchivos > 1 día en ~/.cache y /tmpNunca toca archivos del proyecto
Check disk spaceGet-PSDrive -PSProvider FileSystemdf -hSolo lectura
Optimize disk (defrag or trim)Optimize-Volume -DriveLetter C -Verbosefstrim -avRequiere admin/root; avisa limpio sin pedir UAC/sudo
Backup copyrobocopy . "<backup-folder>" /MIRrsync -a --delete ./ "<backup-folder>/"Conserva .git, omite cachés; robocopy 0–7 = Aprobado
Find a Word & Expose Itfindstr /s /i /m /c:"Aluminium" *.dartgrep -rnI "Aluminium" --include="*.dart" .Búsqueda recursiva editable sin distinción de mayúsculas
Lines Over 250 Catchfor /r %i in (*.dart) do ... find /c /v ""find . -name "*.dart" -exec awk '... c>250 ...' {} +Escaneo de lectura para archivos de más de 250 líneas

5. Cascada de Resultados, Reejecución Aislada, Ignorar y Copiar

6. Salvaguarda Fija Antimanipulación, Integridad de Pruebas y Restauración

7. Barras Horizontales de Puntuación, Cobertura y Estándar de Modularidad

8. Ajustes en Dos Columnas y Recuperación de Estado Sellado

Pulse Settings arriba a la derecha para abrir el diálogo en 2 columnas (riel izquierdo de 6 categorías + controles concisos a la derecha; cada encabezado incluye un botón ? que abre su sección exacta del Manual):

  1. Appearance: Idioma (9 idiomas + idioma del texto copiado), Tema (System Default, Light, Dark Slate), acceso directo de escritorio y Minimize to System Tray when closed en Windows.
  2. Project & Runner: Selector de Modularidad (Grade A..Minimum), Open folder del perfil local (carpeta privada del perfil de usuario), Restaurar aviso de configuración inicial (Restore starter setup banner, reabre Set up for me), Keep Quick Run history y Reset Ignore Registry.
  3. Safeguard & Restore: Allow Matlock to restore tests, reversión automática de Salvaguarda solo para personas y Sync across my computers (sincronización sellada por carpeta).
  4. Email Alerts (matlock://settings/alerts): Estación local de alertas email_smtp y custom_script + Test Email.
  5. AI Agent (MCP): Interruptor MCP Server (stdio) (apagado por defecto), puente bidireccional "Sincronizar con Headless" ("Sync with Headless" en 1 clic para cargar tarjetas/secuencias del agente y publicar órdenes permanentes con 0 sondeos en segundo plano), Test MCP Connection, Copy MCP Config & Agent Instructions, Copy a question for my phone AI y Agent Email Bridge.
  6. License & Updates: Activate de clave de 24 caracteres / Move license to this device, Automatically check for updates (MATLOCK_OFFLINE=1 bloquea toda red saliente), Send anonymous crash diagnostics (apagado por defecto; MATLOCK_NO_TELEMETRY=1), Copy diagnostic info, Free up memory, Share Matlock, Contact us (dutch@dutchp2p.com) y Dutch P2P Tools.
  7. Recuperación de Estado Sellado (Reset Ignore Registry): Si ediciones externas disparan integrity_seal:MUTE_SEAL_TAMPERED o storage_recovery:BAK_AUTO_RESTORE, abra Settings -> Project & Runner -> Storage & backup -> Reset Ignore Registry.

9. Conexión de Agentes de IA (MCP de Escritorio y Guía para Móvil/Chat)

{
  "mcpServers": {
    "matlock": {
      "command": "matlock.exe",
      "args": ["mcp", "--stdio"]
    }
  }
}

10. Referencia de Estándares Integrados (10 Ecosistemas + Pre-CI)

Cada comprobación integrada está compilada en Matlock y anclada a controles técnicos de MITRE CWE, CISA SSDF (NIST SP 800-218), IEEE Std 1003.1 POSIX, compuertas Pre-CI y AICPA SOC 2 Trust Services Criteria:

Ecosistema y DominioQué Inspecciona Matlock y Fallos de Producción Evitados
Núcleo Poliglota y Dart / FlutterBloques catch silenciosos (CWE-391), riesgos null/límites (CWE-476/CWE-125), carreras async sin await, fugas de streams/timers/controladores (CWE-401), bucles infinitos (CWE-835), secretos fijos (CWE-798), secretos en logs (CWE-532), desactivación de verificación de certificados TLS en HTTP/SMTP/CLI/CI (CWE-295 / [MITRE T1557]), SQLi (CWE-89), SSRF (CWE-918), XXE (CWE-611), JWT sin firma (CWE-347), redirecciones abiertas (CWE-601), falta de timeouts, escrituras no atómicas, salto de rutas (CWE-22) y pruebas huecas (CWE-362).
Java (.java)Claves incrustadas (CWE-798), inyección de comandos/SQL (CWE-78/CWE-89), deserialización insegura (CWE-502), cifrados débiles (CWE-327), excepciones silenciadas (CWE-391), fugas JDBC/streams (CWE-404), errores == en cadenas, System.exit abrupto y esperas en bucle.
Python (.py)Secretos fijos (CWE-798), inyección shell/SQL (CWE-78/CWE-89), cargas inseguras pickle/yaml (CWE-502), hashes débiles (CWE-328), except vacío (CWE-391), argumentos mutables por defecto, descriptores abiertos (CWE-775), llamadas síncronas en async def y pruebas huecas.
Rust (.rs)Secretos incrustados (CWE-798), cadenas shell/SQL formateadas (CWE-78/CWE-89), conversiones unsafe sin guardia, TLS desactivado (CWE-295), pánicos .unwrap()/todo!() en producción, esperas bloqueantes en async, fugas intencionales (CWE-401), Result descartados y pruebas huecas.
Go (.go)Tokens fijos (CWE-798), exec/SQL concatenados (CWE-78/CWE-89), InsecureSkipVerify (CWE-295), RNG débil (CWE-330), errores ignorados (CWE-252), fugas defer en bucle y contextos sin cancelar (CWE-404), clientes HTTP sin timeout, panic en producción y pruebas huecas.
TypeScript y JavaScript (.ts, .tsx, .js, .jsx)Secretos expuestos (CWE-798), sumideros DOM XSS / eval (CWE-79/CWE-95), interpolación shell (CWE-78), contaminación de prototipos (CWE-1321), .catch() vacío (CWE-391), supresiones de tipos, errores NaN, bloqueos de E/S síncrona, restos debugger y fugas de listeners/timers (CWE-401).
C y C++ (.c, .cpp, .cc, .h, .hpp)Secretos fijos (CWE-798), copias FFI/búfer sin límite (CWE-787/CWE-120), cadenas de formato (CWE-134), inyección system() (CWE-78), new[]/delete incompatibles (CWE-762), use-after-free (CWE-416), destructores que lanzan, memset sobre objetos no triviales e hilos sin join.
Kotlin y Android (.kt, .kts)Secretos fijos (CWE-798), concatenación SQL (CWE-89), puentes WebView inseguros, TLS omitido (CWE-295), preferencias legibles globalmente (CWE-276), corrutinas GlobalScope fugadas (CWE-401), bloqueos del hilo principal, cierres !!, CancellationException tragada y cabeceras ZIP/APK dañadas (CWE-190).
C# y .NET (.cs)Manejadores IDisposable sin cerrar (CWE-404), fallos async void, cadenas SQL/comandos sin parametrizar (CWE-89/CWE-78), validación de certificados TLS desactivada (CWE-295), excepciones silenciadas (CWE-391), interbloqueos síncronos .Result/.Wait() y pruebas huecas.
SQL y Motores de Almacenamiento (.sql)Permisos comodín (CWE-250), SQL dinámico concatenado (CWE-89), contraseñas en texto plano en DDL (CWE-256), escape a comandos del SO (CWE-78), RLS desactivado, DELETE/UPDATE sin predicado, migraciones no idempotentes, paginación OFFSET profunda y bloqueos de tabla sin guardia.
Pre-CI Multiplataforma, Bash/Shell (.sh), PowerShell (.ps1), Dockerfile y GitHub Actions YAMLColisiones de mayúsculas/minúsculas (POSIX.1), shebangs CRLF, trampas de portabilidad Bash/POSIX y errores $ErrorActionPreference / LASTEXITCODE en PowerShell, etiquetas Dockerfile sin fijar y contenedores como root, excesos de presupuesto HTML/activos, trampas .cmd/.bat en Windows, descriptores fugados (CWE-775), separadores de ruta fijos, imports no rastreados, deriva de lockfiles, permisos abiertos en GitHub Actions YAML, inyección en workflows y pérdida de bits +x.
Modularidad y Comprobaciones PropiasSelector de Modularidad exclusivo para personas (Grade A <= 60 hasta Minimum <= 1000, por defecto Grade C <= 250 archivo / <= 80 fn; CWE-1080 / CWE-1120) más comprobaciones de patrón y script guardadas en su perfil del SO.

11. Licencia Workstation Pro, Vista Web y Escaneo Gratuito en Navegador

12. Linux, GoogleBook, Actualizaciones, Privacidad y Soporte


Parte II: Especificación Operativa para Máquinas y Agentes Autónomos

A. Puntos de Entrada y Transporte del Agente

{
  "mcpServers": {
    "matlock": {
      "command": "matlock-mcp",
      "args": ["--stdio", "--headless", "--no-coverage"]
    }
  }
}

B. Medición, Acceso M2M de Enjambre y Desbloqueo Pro

C. Catálogo Completo de 27 Herramientas MCP Locales

  1. matlock_run_scan(target_path?, changed_only?, dedup_by_rule?, if_none_match?, agent_id?, rule_id?, category?, pillar?, file_filter?, include_generated?, compact?, cursor?, rule_code?, transaction_signature?): Index 0 (readOnlyHint: true) escaneo AST, CWE, POSIX y Pre-CI en < 50ms con file:line:col (col >= 1), cwe, mitre_attack y prescripciones diff de 5 líneas (también admite CLI matlock-mcp scan . --format=sarif en SARIF 2.1.0).
  2. matlock_describe_project(target_path?, mode?): Perfil opcional del espacio de trabajo (0 créditos, readOnlyHint: true); pase mode: "tool_bag" (o CLI matlock-mcp toolbag [--json]) para un inventario progresivo de ~350–550 tokens con tarjetas [LOCKED] (solo ejecución) frente a [MODIFIABLE] (refinables), secuencias, insignias [NEW] / [UPDATED], marcas [UNAVAILABLE IN CONTAINER], órdenes permanentes y estado de alertas.
  3. matlock_get_scan_results(target_path?, cursor?, pillar?, rule_code?): Hallazgos paginados (25/página; Escritorio oculta líneas Salvaguardadas hasta desbloquearlas; --headless con Depósito de Gas desbloquea coordenadas).
  4. matlock_qualify_test(file | files, target_path?, dry_run?, baseline_only?, wait_if_busy?, max_wait_seconds?): Verifica 1–5 archivos de prueba (test_file / test_files) en 3 compuertas (ejecución aprobada con >= 1 aserción, 0 avisos del analizador + límite LOC, 0 hallazgos Matlock) antes de sellarlos en Salvaguarda, o sella línea base (baseline_only: true).
  5. matlock_get_test_integrity(target_path?, reverify?, include_archive?, id?, include_text?, note_for_id?, note?): Inspecciona registros de integridad de pruebas eliminadas y añade notas explicativas del agente (0 permisos de cierre).
  6. matlock_get_history(target_path?, limit?): Historial de solo lectura de puntuación y correcciones.
  7. matlock_read_appliance_manual(section_id?, standard_id?, query?, locale?): Manual sin conexión (9 idiomas) y consulta de CWE/POSIX/SSDF/SOC2/resultados (0 créditos, 0 red).
  8. matlock_list_custom_tests: Lista comprobaciones propias definidas por el usuario.
  9. matlock_register_custom_test: Guarda una comprobación propia de patrón o script.
  10. matlock_delete_custom_test: Borra una comprobación propia desbloqueada (las integradas son inmutables).
  11. matlock_list_actions: Lista tarjetas de acción (con favorite/bloqueo/aprobación) más recommendedTemplates sin configurar (unconfiguredTemplate: true).
  12. matlock_register_action(id, command, name?, favorite?): Programa o actualiza cualquier Acción desbloqueada o plantilla inicial (tpl_github, tpl_save_drive, tpl_cloud_sync, tpl_save_backup, tpl_defrag_optimize, tpl_shut_down), limpia unconfiguredTemplate, fija/quita Favoritos (favorite: true | false) y fuerza Require Approval en Escritorio.
  13. matlock_register_sealed_script: Sella comandos de compilación/pruebas (Locked by User) frente a subagentes.
  14. matlock_run_action(id, working_dir?, async?, send_alert?, cold_box?): Ejecuta un comando bajo contención de árbol de procesos del SO (async: true no bloqueante, send_alert, tarjetas propias de USB robocopy/rsync, nube R2/S3/GCS/Azure y git push; 0 git push integrado en ejecuciones de prueba Matlock).
  15. matlock_get_action_status(id?): Consulta estado en vivo, código de salida y cápsulas compactas para tareas async: true.
  16. matlock_stop_action(id?, stop_sequence?): Termina un árbol de procesos activo al instante (stop_sequence: true detiene toda la secuencia activa).
  17. matlock_delete_action: Borra una tarjeta de acción desbloqueada.
  18. matlock_list_sequences: Lista rutinas de varios pasos.
  19. matlock_register_sequence(id, name?, step_ids?, commands?, insert_step_id?, insert_command?, insert_step_name?, insert_at_index?, remove_step_index?, failure_policy?, always_run?, favorite?): Compone o edita en línea una Secuencia desbloqueada, insertando cualquier Acción o alert::<id> en el índice exacto insert_at_index (base 0) con failure_policy ("stop" | "stop_and_alert" | "continue_and_alert"), always_run y favorite: true | false.
  20. matlock_run_sequence(id, file?, async?, send_alert?, cold_box?, deep?, include_coverage?): Ejecuta seq_matlock o seq_fast_verify (file para probar un único archivo, async: true para ejecución en segundo plano con despertar automático al terminar, send_alert para alertas; cold_box: false predeterminado para velocidad; cold_box: true antes de guardado externo, sincronización en nube, copia de seguridad, push o compilación con recibo en < 15ms si ya está verificado; deep: true fuerza limpieza y cobertura completas).
  21. matlock_delete_sequence: Borra una rutina desbloqueada.
  22. matlock_list_alerts: Lista canales de alerta locales (secretos enmascarados).
  23. matlock_set_alert: Configura alertas locales email_smtp de solo salida con Native Dart TLS 1.2/1.3 (preajustes globales, llavero del SO o bóveda de contenedor local sellada con frase de paso) o custom_script.
  24. matlock_trigger_alert(id, status, task_completed, uncovered_issues, next_move): Envía notificación local con las 3 preguntas obligatorias de cierre.
  25. matlock_delete_alert: Borra una tarjeta de alerta desbloqueada.
  26. matlock_purchase_license(transaction_signature?, license_key?, target_path?, network?, runs?, lid?): Liquida asignaciones medidas de enjambre de agentes autónomos (ver /es/agents) o activa una license_key Pro de 24 caracteres de aprox. 23 €* ($24.99 USD/año).
  27. matlock_report_issue(category, subject, description, tool_context?, output_dump?): Envío asíncrono depurado de comentarios/sugerencias (0 créditos, CONTINUE_IMMEDIATELY).

D. Entorno Aislado Cold Box de Frontera, Regulador de 3 Bucles y Cierre

E. Especificación Legible por Máquina para Agentes de IA (YAML)

product: "Matlock — Agent & Developer Tools. (Efficient. Exact. By the book.)"
pinned_version: "v1.0.0+1"
web_command_center: "https://matlock.dutchp2p.com/es/app"
free_local_scan: "https://matlock.dutchp2p.com/es/#wasm-instant-audit"
docs_hub: "https://matlock.dutchp2p.com/es/docs"
online_manual: "https://matlock.dutchp2p.com/es/manual"
public_repository: "https://github.com/Dutchp2p/matlock-public"
online_operational_map: "https://matlock.dutchp2p.com/llms.txt"
mcp_resource_uri: "matlock://help/appliance-manual"
mcp_stdio_command: "npx -y @dutchp2p/matlock-mcp | uvx matlock-mcp | matlock.exe mcp --stdio (Windows) | matlock mcp --stdio (.deb) or /path/to/matlock-linux-x64.AppImage mcp --stdio (Linux & GoogleBook) | matlock-mcp --stdio --headless --no-coverage (Linux x64, Windows x64 & macOS arm64)"
network_ports: 0
git_hooks_installed: 0
builtin_git_push_in_test_runs: false
custom_push_deploy_actions_allowed: true
mcp_tools_count: 27
primary_pipeline:
  card: "Matlock"
  sequence_id: "seq_matlock"
  entry_tool_index_0: "matlock_run_scan"
  badge_svg_url: "https://matlock.dutchp2p.com/badge/verified.svg"
  stages: "Clean -> Get -> Format -> Lint -> Analyze/Compile -> Test -> Coverage (depth 0..2)"
  cold_box_default: false
  cold_box_boundary_triggers: ["before external git push", "before cloud-drive save", "before removable backup", "before release compile"]
modularity_tuning_dial:
  person_only_sealed_os_settings: true
  default_tier: "Grade C (<= 250 / <= 80 fn)"
  tiers: ["Grade A (<= 60 / <= 25 fn)", "Grade B (<= 100 / <= 40 fn)", "Grade C (<= 250 / <= 80 fn)", "Grade D (<= 500 / <= 120 fn)", "Minimum (<= 1000 / <= 250 fn)"]
ignore_scopes_5: ["file:line:code", "file:code", "*:code", "file", "folder/"]
lock_governance:
  safeguarded: "Read & Run Only (auto-reverts unauthorized edits + Envelope tamper alert)"
  unlocked: "AI agent can modify (Read, Write, Modify & Run)"
os_storage:
  scope: "private_user_profile_outside_repo"
  env_override: "MATLOCK_STATE_DIR"

F. Principios Operativos del Agente y Límites de Ejecución

Volver arriba