@ericrisco/rsc 3.7.4 → 4.0.0

package/skills/connect-tool/bridge-kit/README.md

@@ -0,0 +1,48 @@
+# Kit puente: leer un programa de escritorio en solo lectura
+
+Para que un agente de IA **lea** los datos de un programa instalado en la oficina (Sage 50 o 200, Contasol en local, ICG, Prevengos, CONTPAQi, a3ERP…) **sin poder escribir**, **sin abrir puertos** y **sin perder el soporte** del fabricante.
+
+- Explicación para el dueño: [Mi programa no tiene API](https://executive-lab.github.io/conectores-pymes/guias/mi-programa-no-tiene-api.html).
+- Explicación técnica: [Kit puente, parte técnica](https://executive-lab.github.io/conectores-pymes/guias/kit-puente-tecnico.html).
+- Para **escribir** (asientos, facturas) no se usa el puente: se usa el [fichero de importación oficial](https://executive-lab.github.io/conectores-pymes/guias/escribir-en-contabilidad-por-importacion.html), que importa una persona.
+
+> Plantillas genéricas. Los nombres de tablas y columnas de cada programa **no** están aquí: dependen de la versión y hay que confirmarlos con el distribuidor. Prueba todo primero en una copia.
+
+## Qué hay
+
+| Carpeta | Para qué |
+|---------|----------|
+| `sqlserver/01-login-servidor.sql` | Login `ia_lectura` (una vez, nivel servidor) |
+| `sqlserver/02-usuario-y-vistas.sql` | Usuario, esquema `ia`, permisos de solo lectura y vistas de plantilla (idempotente) |
+| `sqlserver/03-prueba-solo-lectura.sql` | Prueba de aceptación: lee las vistas, **no** lee tablas, **no** borra, **no** modifica, **no** crea |
+| `sqlserver/copia-nocturna.ps1` | Backup `COPY_ONLY` → restauración en `ERP_IA` → vuelve a crear usuario y vistas → pasa la prueba |
+| `access/access_a_sqlite.py` | Para programas en Access: copia el fichero y lo convierte a SQLite |
+| `dbhub/dbhub.toml.ejemplo` | MCP de solo lectura con herramientas de SQL predefinido |
+| `red/tailscale-grants.hujson` | Si el agente es Claude Code en el portátil |
+| `red/cloudflared-config.yml.ejemplo` | Si el agente es un conector de claude.ai, Cowork o n8n en la nube |
+| `01-TOOLS-plantilla/` | Carpeta para el arnés (`.env.example` y `test_connection.sh`) |
+
+## Pasos
+
+1. **Permiso por escrito** del distribuidor para crear un login y vistas, o para leer la copia.
+2. **SQL Server:** ejecuta `01-login-servidor.sql` una vez. Ajusta las vistas de `02-usuario-y-vistas.sql` a tu programa.
+3. **Copia nocturna** (recomendada): programa `copia-nocturna.ps1` en el Programador de tareas de Windows, fuera de horario, con una cuenta administradora de SQL Server:
+   ```powershell
+   $accion = New-ScheduledTaskAction -Execute "powershell.exe" -Argument '-ExecutionPolicy Bypass -File C:\KitPuente\sqlserver\copia-nocturna.ps1 -Origen "<BD_DEL_PROGRAMA>"'
+   $cuando = New-ScheduledTaskTrigger -Daily -At 2am
+   Register-ScheduledTask -TaskName "KitPuente copia nocturna" -Action $accion -Trigger $cuando -RunLevel Highest
+   ```
+   Sin copia (leyendo producción): ejecuta `02` y `03` directamente sobre la base del programa, si el distribuidor lo autoriza.
+4. **Access:** `python access_a_sqlite.py --origen <fichero> --destino C:\KitPuente\empresa.sqlite`, programado igual.
+5. **Prueba de aceptación:** `03-prueba-solo-lectura.sql` tiene que terminar en `RESULTADO: OK`. Si no, **no se conecta el agente**.
+6. **DBHub** en el servidor, con `dbhub.toml` protegido. Fija la versión de npm. DBHub escucha en `0.0.0.0` por defecto: indica **siempre** `--host`.
+7. **Red:** Tailscale (agente local) o Cloudflare Tunnel + Access (conectores de claude.ai o nube). **Nunca** abras el 1433 ni el 8080 en el router.
+8. **Arnés:** copia `01-TOOLS-plantilla/` a `01-TOOLS/<PROGRAMA>/`, rellena `.env` y ejecuta `./test_connection.sh`. Añade el MCP a `.mcp.json`.
+
+## Lo que el kit no hace
+
+- No escribe en el programa: para eso está el fichero de importación.
+- No incluye esquemas de tablas de programas comerciales.
+- No sustituye al soporte del fabricante: si el programa se actualiza y cambia sus tablas, hay que revisar las vistas. La prueba 03 y el `test_connection` lo detectan.
+
+Alternativa de pago si no quieres mantener el puente: una API unificada como Chift, que cubre Sage 200 ES y a3ERP con agente local, además de Contasol Nube, Ágora y Revo (ver la guía técnica).

package/skills/connect-tool/bridge-kit/UPSTREAM.json

@@ -0,0 +1,8 @@
+{
+  "repository": "https://github.com/Executive-Lab/conectores-pymes",
+  "path": "kit-puente",
+  "commit": "99e17ff6b55e861e727185905e5be3664291d183",
+  "license": "MIT",
+  "copied": "2026-11-01",
+  "modified": false
+}

package/skills/connect-tool/bridge-kit/access/access_a_sqlite.py

@@ -0,0 +1,82 @@
+#!/usr/bin/env python3
+"""Kit puente · Copia una base de Access (.mdb/.accdb) y la convierte a SQLite para leerla en solo lectura.
+
+Para programas que guardan los datos en Access (p. ej. Factusol en local). Nunca se conecta
+nada al fichero vivo: primero se COPIA y se trabaja sobre la copia, fuera de horario.
+
+Requisitos (Windows): Python 3.11+, `pip install pyodbc` y el controlador
+"Microsoft Access Driver (*.mdb, *.accdb)" (Access Database Engine) de la misma
+arquitectura que Python (64 bits con 64 bits).
+
+Después, sirve el .sqlite con DBHub (ver ../dbhub/dbhub.toml.ejemplo, fuente sqlite).
+
+Ejemplos:
+  python access_a_sqlite.py --origen "D:\\Programa\\Datos\\EMPRESA.accdb" --destino C:\\KitPuente\\empresa.sqlite
+  python access_a_sqlite.py --origen ... --destino ... --tablas F_FAC,F_LFA,F_CLI
+"""
+import argparse
+import datetime
+import decimal
+import shutil
+import sqlite3
+import sys
+import tempfile
+from pathlib import Path
+
+
+def convertir(valor):
+    if isinstance(valor, decimal.Decimal):
+        return float(valor)
+    if isinstance(valor, (datetime.date, datetime.datetime, datetime.time)):
+        return valor.isoformat()
+    if isinstance(valor, (bytes, bytearray, memoryview)):
+        return None  # adjuntos o binarios: no se copian
+    return valor
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    parser.add_argument("--origen", required=True, type=Path, help="Fichero .mdb o .accdb del programa")
+    parser.add_argument("--destino", required=True, type=Path, help="Fichero .sqlite que se genera (se sustituye)")
+    parser.add_argument("--tablas", default="", help="Lista de tablas separadas por comas (por defecto, todas)")
+    options = parser.parse_args()
+
+    try:
+        import pyodbc
+    except ImportError:
+        sys.exit("ERROR: falta pyodbc (pip install pyodbc) y el controlador de Access")
+
+    if not options.origen.exists():
+        sys.exit(f"ERROR: no existe {options.origen}")
+    permitidas = {t.strip().lower() for t in options.tablas.split(",") if t.strip()}
+
+    with tempfile.TemporaryDirectory() as carpeta:
+        copia = Path(carpeta) / options.origen.name
+        shutil.copy2(options.origen, copia)  # trabajamos SIEMPRE sobre una copia
+        origen = pyodbc.connect(rf"DRIVER={{Microsoft Access Driver (*.mdb, *.accdb)}};DBQ={copia};")
+        cursor = origen.cursor()
+        tablas = [t.table_name for t in cursor.tables(tableType="TABLE")]
+        if permitidas:
+            tablas = [t for t in tablas if t.lower() in permitidas]
+
+        temporal = options.destino.with_suffix(".tmp.sqlite")
+        temporal.unlink(missing_ok=True)
+        destino = sqlite3.connect(temporal)
+        for tabla in tablas:
+            columnas = [c.column_name for c in cursor.columns(table=tabla)]
+            lista = ", ".join(f'"{c}"' for c in columnas)
+            destino.execute(f'CREATE TABLE "{tabla}" ({lista})')
+            filas = 0
+            for fila in cursor.execute(f"SELECT * FROM [{tabla}]"):
+                destino.execute(f'INSERT INTO "{tabla}" VALUES ({", ".join("?" * len(columnas))})', [convertir(v) for v in fila])
+                filas += 1
+            print(f"  {tabla}: {filas} filas")
+        destino.commit()
+        destino.close()
+        origen.close()
+        temporal.replace(options.destino)  # sustitución atómica: el lector nunca ve un fichero a medias
+    print(f"OK — {len(tablas)} tablas en {options.destino}")
+
+
+if __name__ == "__main__":
+    main()

package/skills/connect-tool/bridge-kit/dbhub/dbhub.toml.ejemplo

@@ -0,0 +1,65 @@
+# Kit puente · Configuración de DBHub (https://github.com/bytebase/dbhub, MIT).
+#
+# Este fichero lleva la contraseña de ia_lectura: guárdalo en el SERVIDOR DEL ERP, en una
+# carpeta que solo pueda leer la cuenta que ejecuta DBHub. NUNCA en git ni en el portátil.
+#
+# Arranque (DBHub escucha por defecto en 0.0.0.0: indica SIEMPRE --host):
+#   set DBHUB_AUTH_TOKEN=<token largo y aleatorio>
+#   npx @bytebase/dbhub@<versión fija> --config=C:\KitPuente\dbhub.toml --transport http --host 127.0.0.1 --port 8080
+# Con Tailscale (sin Cloudflare): --host <IP de Tailscale del servidor> y en el firewall de Windows
+# permite el 8080 solo desde la interfaz de Tailscale (ver ../red/).
+#
+# Marcadores de parámetros en SQL Server: @p1, @p2… (en SQLite: ?).
+
+# --- Origen: la COPIA nocturna (ver ../sqlserver/copia-nocturna.ps1) --------------------
+[[sources]]
+id = "erp_ia"
+type = "sqlserver"
+host = "127.0.0.1"
+port = 1433
+database = "ERP_IA"
+user = "ia_lectura"
+password = "<<CONTRASEÑA DE ia_lectura>>"
+
+# Alternativa para Access convertido a SQLite (ver ../access/access_a_sqlite.py):
+# [[sources]]
+# id = "erp_ia"
+# dsn = "sqlite:///C:/KitPuente/empresa.sqlite"
+
+# --- execute_sql: la documentación no explica cómo quitarlo, así que se deja en solo
+# lectura y con tope de filas. La garantía real es el login ia_lectura, que solo puede
+# hacer SELECT sobre el esquema ia (pasa la prueba 03 antes de conectar nada).
+[[tools]]
+name = "execute_sql"
+source = "erp_ia"
+readonly = true
+max_rows = 200
+
+# --- Herramientas de SQL predefinido: una por pregunta de negocio ------------------------
+[[tools]]
+name = "ventas_por_dia"
+description = "Base imponible y número de facturas emitidas por día entre dos fechas (AAAA-MM-DD)"
+source = "erp_ia"
+statement = "SELECT fecha, base_imponible, facturas FROM ia.ventas_por_dia WHERE fecha BETWEEN @p1 AND @p2 ORDER BY fecha"
+
+[[tools.parameters]]
+name = "desde"
+type = "string"
+description = "Fecha inicial, AAAA-MM-DD"
+
+[[tools.parameters]]
+name = "hasta"
+type = "string"
+description = "Fecha final, AAAA-MM-DD"
+
+[[tools]]
+name = "cobros_pendientes"
+description = "Vencimientos de clientes con importe pendiente, del más antiguo al más reciente"
+source = "erp_ia"
+statement = "SELECT TOP (200) cliente, nombre, vencimiento, pendiente FROM ia.cobros_pendientes ORDER BY vencimiento"
+
+[[tools]]
+name = "stock_bajo_minimos"
+description = "Artículos con stock por debajo del mínimo"
+source = "erp_ia"
+statement = "SELECT TOP (200) articulo, descripcion, stock, minimo FROM ia.stock_bajo_minimos ORDER BY stock - minimo"

package/skills/connect-tool/bridge-kit/red/cloudflared-config.yml.ejemplo

@@ -0,0 +1,18 @@
+# Kit puente · Cloudflare Tunnel delante de DBHub (C:\ProgramData\cloudflared\config.yml).
+# Cuándo: el agente es un conector remoto de claude.ai o Cowork, o n8n en la nube. Esos
+# conectores salen de la infraestructura del proveedor y NO llegan a una VPN ni a Tailscale.
+#
+# 1. cloudflared tunnel login  →  cloudflared tunnel create kit-puente  (genera el JSON de credenciales)
+# 2. Crea en Cloudflare Zero Trust una aplicación de Access "self-hosted" para el hostname de abajo:
+#    política por email de las personas autorizadas y service token para máquinas (n8n).
+# 3. DBHub escucha SOLO en 127.0.0.1:8080 y con --auth-token (doble barrera: Access + token).
+# 4. cloudflared service install  (queda como servicio de Windows, conexión saliente, sin abrir puertos)
+# Requisito: un dominio gestionado en Cloudflare. Verifica el plan y el soporte de OAuth para
+# MCP en Access antes de conectar claude.ai.
+tunnel: <ID_DEL_TUNEL>
+credentials-file: C:\ProgramData\cloudflared\<ID_DEL_TUNEL>.json
+
+ingress:
+  - hostname: erp-mcp.<tudominio>.com
+    service: http://127.0.0.1:8080
+  - service: http_status:404

package/skills/connect-tool/bridge-kit/red/tailscale-grants.hujson

@@ -0,0 +1,22 @@
+// Kit puente · Política de Tailscale (Admin console → Access controls).
+// Cuándo: el agente es Claude Code en el portátil del dueño (los conectores remotos de
+// claude.ai NO llegan a Tailscale: para eso, ver cloudflared-config.yml.ejemplo).
+//
+// 1. En el servidor del ERP: instala Tailscale e inícialo con la etiqueta tag:erp
+//    (tailscale up --advertise-tags=tag:erp).
+// 2. Arranca DBHub con --host <IP de Tailscale del servidor> --port 8080.
+// 3. Firewall de Windows: el 8080 solo desde la interfaz de Tailscale. El 1433 nunca sale del servidor.
+// Plan: Standard (uso comercial). El plan Personal es solo para uso no comercial.
+{
+  "tagOwners": {
+    "tag:erp": ["autogroup:admin"]
+  },
+  "grants": [
+    {
+      // Solo el dueño (o un grupo) llega al servidor del ERP, y solo al puerto del MCP.
+      "src": ["<email-del-dueño@empresa.com>"],
+      "dst": ["tag:erp"],
+      "ip":  ["tcp:8080"]
+    }
+  ]
+}

package/skills/connect-tool/bridge-kit/sqlserver/01-login-servidor.sql

@@ -0,0 +1,25 @@
+/*
+  Kit puente · 01 · Login de solo lectura (nivel de SERVIDOR). Se ejecuta UNA vez.
+
+  Quién: el informático, con un usuario administrador de SQL Server.
+  Antes: confirma con el distribuidor del programa (Sage, ICG, Prevengos, CONTPAQi,
+  Wolters Kluwer…) que crear un login y vistas no afecta al soporte. Pídelo por escrito.
+
+  Requisito: el servidor debe admitir autenticación de SQL Server (modo mixto).
+  Si solo admite Windows, usa una cuenta de Windows dedicada en lugar de este login.
+
+  La contraseña NO se guarda en ningún repositorio: genérala larga y aleatoria y
+  guárdala solo en el dbhub.toml protegido del servidor (ver ../dbhub/).
+*/
+USE [master];
+GO
+
+IF NOT EXISTS (SELECT 1 FROM sys.server_principals WHERE name = N'ia_lectura')
+    CREATE LOGIN [ia_lectura]
+        WITH PASSWORD = N'<<PON AQUÍ UNA CONTRASEÑA LARGA Y ALEATORIA>>',
+             CHECK_POLICY = ON,
+             DEFAULT_DATABASE = [master];
+GO
+
+-- Nada de roles de servidor: ia_lectura NO es sysadmin, ni securityadmin, ni nada más.
+-- Los permisos se dan en la base de datos con 02-usuario-y-vistas.sql.

package/skills/connect-tool/bridge-kit/sqlserver/02-usuario-y-vistas.sql

@@ -0,0 +1,69 @@
+/*
+  Kit puente · 02 · Usuario, esquema "ia" y vistas (nivel de BASE DE DATOS).
+
+  Se ejecuta en la base que lee el agente. Por defecto es la COPIA "ERP_IA".
+  Es IDEMPOTENTE: copia-nocturna.ps1 lo vuelve a lanzar después de cada restauración,
+  porque restaurar la copia borra el usuario, el esquema y las vistas.
+
+  Las vistas son PLANTILLAS: los nombres de tablas y columnas dependen del programa
+  y de su versión. Complétalos con el distribuidor o con la documentación del esquema.
+  Regla: solo las columnas necesarias. Sin IBAN, sin datos de salud, sin nóminas.
+*/
+-- Cambia el nombre si no usas la copia:
+USE [ERP_IA];
+GO
+
+IF NOT EXISTS (SELECT 1 FROM sys.schemas WHERE name = N'ia')
+    EXEC (N'CREATE SCHEMA [ia] AUTHORIZATION [dbo]');
+GO
+
+IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = N'ia_lectura')
+    CREATE USER [ia_lectura] FOR LOGIN [ia_lectura] WITH DEFAULT_SCHEMA = [ia];
+GO
+
+-- Solo lectura sobre el esquema de vistas. Las vistas son de dbo (dueño del esquema),
+-- así que la cadena de propiedad deja leer las tablas a través de ellas sin dar
+-- permiso directo sobre las tablas.
+GRANT SELECT ON SCHEMA::[ia] TO [ia_lectura];
+ALTER ROLE [db_denydatawriter] ADD MEMBER [ia_lectura];
+DENY CREATE TABLE TO [ia_lectura];
+DENY CREATE VIEW TO [ia_lectura];
+DENY CREATE PROCEDURE TO [ia_lectura];
+DENY CREATE FUNCTION TO [ia_lectura];
+GO
+
+/* ----------------------------------------------------------------------------
+   VISTAS (plantillas). Sustituye <…> por las tablas y columnas reales.
+   Una vista por "pregunta de negocio". DBHub expone cada una como herramienta.
+---------------------------------------------------------------------------- */
+
+CREATE OR ALTER VIEW [ia].[ventas_por_dia] AS
+SELECT
+    CAST(f.<columna_fecha> AS date)       AS fecha,
+    SUM(f.<columna_base_imponible>)       AS base_imponible,
+    COUNT(*)                              AS facturas
+FROM [dbo].[<tabla_facturas_emitidas>] AS f
+GROUP BY CAST(f.<columna_fecha> AS date);
+GO
+
+CREATE OR ALTER VIEW [ia].[cobros_pendientes] AS
+SELECT
+    c.<columna_codigo_cliente>            AS cliente,
+    c.<columna_nombre_cliente>            AS nombre,
+    v.<columna_vencimiento>               AS vencimiento,
+    v.<columna_importe_pendiente>         AS pendiente
+FROM [dbo].[<tabla_vencimientos>] AS v
+JOIN [dbo].[<tabla_clientes>]     AS c ON c.<columna_codigo_cliente> = v.<columna_codigo_cliente>
+WHERE v.<columna_importe_pendiente> > 0;
+GO
+
+CREATE OR ALTER VIEW [ia].[stock_bajo_minimos] AS
+SELECT
+    a.<columna_codigo_articulo>           AS articulo,
+    a.<columna_descripcion>               AS descripcion,
+    s.<columna_stock>                     AS stock,
+    a.<columna_stock_minimo>              AS minimo
+FROM [dbo].[<tabla_articulos>] AS a
+JOIN [dbo].[<tabla_stock>]     AS s ON s.<columna_codigo_articulo> = a.<columna_codigo_articulo>
+WHERE s.<columna_stock> < a.<columna_stock_minimo>;
+GO

package/skills/connect-tool/bridge-kit/sqlserver/03-prueba-solo-lectura.sql

@@ -0,0 +1,65 @@
+/*
+  Kit puente · 03 · Prueba de aceptación: ia_lectura LEE y NO ESCRIBE.
+
+  Sin esta prueba el puente no se entrega. Se ejecuta como administrador; el script
+  se hace pasar por ia_lectura (EXECUTE AS) y todo va dentro de una transacción
+  que se deshace al final, así que no cambia nada aunque algo fallara.
+
+  Sustituye <tabla_facturas_emitidas> por una tabla real del programa.
+  DELETE/UPDATE con TOP (0) no tocan ninguna fila, pero SQL Server comprueba igualmente
+  el permiso: si ia_lectura lo tuviera, la prueba lo detecta.
+*/
+USE [ERP_IA];
+GO
+
+BEGIN TRANSACTION;
+EXECUTE AS USER = N'ia_lectura';
+
+DECLARE @fallos int = 0;
+
+BEGIN TRY
+    SELECT TOP (1) * FROM [ia].[ventas_por_dia];
+    PRINT N'OK    · puede leer las vistas del esquema ia';
+END TRY
+BEGIN CATCH
+    SET @fallos += 1; PRINT N'FALLO · no puede leer ia.ventas_por_dia: ' + ERROR_MESSAGE();
+END CATCH;
+
+BEGIN TRY
+    SELECT TOP (1) * FROM [dbo].[<tabla_facturas_emitidas>];
+    SET @fallos += 1; PRINT N'FALLO · puede leer las tablas directamente (solo debería ver el esquema ia)';
+END TRY
+BEGIN CATCH
+    PRINT N'OK    · no puede leer las tablas directamente';
+END CATCH;
+
+BEGIN TRY
+    DELETE TOP (0) FROM [dbo].[<tabla_facturas_emitidas>];
+    SET @fallos += 1; PRINT N'FALLO · tiene permiso de DELETE';
+END TRY
+BEGIN CATCH
+    PRINT N'OK    · no puede borrar';
+END CATCH;
+
+BEGIN TRY
+    UPDATE TOP (0) [dbo].[<tabla_facturas_emitidas>] SET <columna_fecha> = <columna_fecha>;
+    SET @fallos += 1; PRINT N'FALLO · tiene permiso de UPDATE';
+END TRY
+BEGIN CATCH
+    PRINT N'OK    · no puede modificar';
+END CATCH;
+
+BEGIN TRY
+    EXEC (N'CREATE TABLE [ia].[prueba_escritura] (x int)');
+    SET @fallos += 1; PRINT N'FALLO · puede crear tablas';
+END TRY
+BEGIN CATCH
+    PRINT N'OK    · no puede crear tablas';
+END CATCH;
+
+REVERT;
+ROLLBACK TRANSACTION;
+
+IF @fallos = 0 PRINT N'RESULTADO: OK — ia_lectura es de solo lectura.';
+ELSE PRINT N'RESULTADO: REVISAR — hay ' + CAST(@fallos AS nvarchar(10)) + N' fallos. No conectes el agente.';
+GO

package/skills/connect-tool/bridge-kit/sqlserver/copia-nocturna.ps1

@@ -0,0 +1,68 @@
+<#
+  Kit puente · Copia nocturna de la base del programa a "ERP_IA" (SQL Server, Express incluido).
+
+  Qué hace, en este orden:
+    1. BACKUP ... WITH COPY_ONLY de la base de producción. COPY_ONLY no rompe la cadena
+       de copias del programa.
+    2. RESTORE en ERP_IA (la sobrescribe), moviendo los ficheros a la carpeta de datos.
+    3. Vuelve a crear el usuario, el esquema "ia" y las vistas con 02-usuario-y-vistas.sql,
+       porque la restauración los borra.
+    4. Pasa la prueba de solo lectura (03-prueba-solo-lectura.sql) y deja un registro.
+
+  SQL Server Express no tiene SQL Server Agent: se programa con el Programador de tareas
+  de Windows (ver el README del kit). Se ejecuta con una cuenta de Windows que sea
+  administradora de SQL Server, NUNCA con ia_lectura.
+
+  Uso:
+    powershell -ExecutionPolicy Bypass -File copia-nocturna.ps1 -Origen "<BD_DEL_PROGRAMA>"
+#>
+param(
+    [Parameter(Mandatory = $true)][string]$Origen,
+    [string]$Servidor = ".\SQLEXPRESS",
+    [string]$Copia = "ERP_IA",
+    [string]$CarpetaBackup = "C:\KitPuente\backups",
+    [string]$CarpetaDatos = "C:\KitPuente\datos",
+    [string]$CarpetaScripts = $PSScriptRoot,
+    [int]$DiasRetencion = 3
+)
+$ErrorActionPreference = "Stop"
+New-Item -ItemType Directory -Force -Path $CarpetaBackup, $CarpetaDatos | Out-Null
+$registro = Join-Path $CarpetaBackup "copia-nocturna.log"
+function Log($texto) { "$(Get-Date -Format s)  $texto" | Tee-Object -FilePath $registro -Append }
+
+$bak = Join-Path $CarpetaBackup ("{0}-{1}.bak" -f $Origen, (Get-Date -Format yyyyMMdd))
+Log "Backup de [$Origen] a $bak"
+sqlcmd -S $Servidor -E -b -Q "BACKUP DATABASE [$Origen] TO DISK = N'$bak' WITH COPY_ONLY, INIT, CHECKSUM"
+if ($LASTEXITCODE -ne 0) { Log "ERROR en el backup"; exit 1 }
+
+# Nombres lógicos de los ficheros para el MOVE.
+$lista = sqlcmd -S $Servidor -E -b -h -1 -W -s "|" -Q "SET NOCOUNT ON; RESTORE FILELISTONLY FROM DISK = N'$bak'"
+$moves = @()
+foreach ($linea in $lista) {
+    $campos = $linea -split "\|"
+    if ($campos.Count -lt 3) { continue }
+    $logico = $campos[0].Trim(); $tipo = $campos[2].Trim()
+    $ext = if ($tipo -eq "L") { "ldf" } else { "mdf" }
+    $moves += "MOVE N'$logico' TO N'$(Join-Path $CarpetaDatos "$Copia-$logico.$ext")'"
+}
+if ($moves.Count -eq 0) { Log "ERROR: no se han leído los ficheros del backup"; exit 1 }
+
+Log "Restaurando en [$Copia]"
+$restore = "IF DB_ID(N'$Copia') IS NOT NULL ALTER DATABASE [$Copia] SET SINGLE_USER WITH ROLLBACK IMMEDIATE; " +
+           "RESTORE DATABASE [$Copia] FROM DISK = N'$bak' WITH REPLACE, RECOVERY, " + ($moves -join ", ") + "; " +
+           "ALTER DATABASE [$Copia] SET MULTI_USER;"
+sqlcmd -S $Servidor -E -b -Q $restore
+if ($LASTEXITCODE -ne 0) { Log "ERROR en la restauración"; exit 1 }
+
+Log "Usuario, esquema ia y vistas"
+sqlcmd -S $Servidor -E -b -d $Copia -i (Join-Path $CarpetaScripts "02-usuario-y-vistas.sql")
+if ($LASTEXITCODE -ne 0) { Log "ERROR al crear usuario o vistas"; exit 1 }
+
+Log "Prueba de solo lectura"
+$prueba = sqlcmd -S $Servidor -E -b -d $Copia -i (Join-Path $CarpetaScripts "03-prueba-solo-lectura.sql")
+$prueba | ForEach-Object { Log $_ }
+if (-not ($prueba -match "RESULTADO: OK")) { Log "ERROR: la prueba de solo lectura no ha dado OK"; exit 1 }
+
+Get-ChildItem $CarpetaBackup -Filter "$Origen-*.bak" |
+    Where-Object { $_.LastWriteTime -lt (Get-Date).AddDays(-$DiasRetencion) } | Remove-Item -Force
+Log "OK — copia lista en [$Copia]"

package/skills/connect-tool/evals/cases.yaml

@@ -1,9 +1,11 @@
 skill: connect-tool
 
 # Cases for connect-tool: the user names ONE tool to connect to the agent. The skill researches the
-# vendor's real docs, picks the least dangerous route (MCP, API, integration, export, read-only copy
-# of the database, RPA last), builds 01-TOOLS/<TOOL>/ with a test that proves it (and proves writes
-# fail when read-only), guides the user and records it in 02-DOCS. It is NOT the typed API client
+# vendor's real docs FIRST, picks the least dangerous route (MCP, API, integration, vendor module,
+# file exchange, read-only copy of the database; never RPA or scraping), builds 01-TOOLS/<TOOL>/ with
+# a test that proves it (and proves writes fail when read-only), guides the user and records it in
+# 02-DOCS. Only when nothing is documented does it take option 2: diagnose the program in
+# conversation, find who holds the key, and keep going. It is NOT the typed API client
 # (api-connector-builder), NOT the whole-workspace scan (harness), NOT whether to automate a process
 # (automation-strategy), NOT chaining services (automation-flows).
 
@@ -24,7 +26,10 @@ should_trigger:
     why: "A legacy file database. Copy the .mdb/.accdb, read it with mdbtools or convert it, and never write into the program's file."
 
   - prompt: "¿Se puede conectar InstalWin? No sé ni por dónde empezar."
-    why: "An obscure vertical program nobody has catalogued: the method (search vendor docs, export features, the database it installs) works for it, and if nothing reliable exists the skill says so."
+    why: "An obscure vertical program nobody has catalogued: the method (search vendor docs, export features, the database it installs) works for it, and if nothing reliable exists the skill says so and goes to option 2."
+
+  - prompt: "Quiero que el agente meta los asientos de las facturas de proveedores en nuestro Sage 50."
+    why: "Writing into an installed accounting program: the route is the official import file the user's program exports as a sample, validated and imported by a person into the test company first, never the database."
 
 should_not_trigger:
   - prompt: "Write a TypeScript client for the Holded API with pagination, retries and token refresh."
@@ -56,3 +61,35 @@ capability:
       - "Proposes reading a nightly copy with a SELECT-only user, reached privately, never the live database exposed to the internet"
       - "Builds 01-TOOLS/<TOOL>/ from the template with a test_connection that proves reading works AND that a write is refused, telling a permission error apart from any other failure"
       - "Explains the chosen route in plain words and records the connection in 02-DOCS"
+
+  - scenario: "A small-business owner says: 'Quiero conectar Geyce, nuestro programa de gestión de hace veinte años. No sé qué tipo de programa es ni a quién preguntar.' Research finds no public API, MCP or technical documentation. Show what the agent does."
+    must_include:
+      - "Researches first (vendor docs, MCP registry, exports and imports in the manual) and cites what it searched and the date, saying plainly that nothing reliable was found"
+      - "Only then takes option 2 and does not stop: asks the plain diagnosis questions (website login, works offline, several PCs share data, remote desktop, data-folder extensions, who they call when it breaks)"
+      - "Says which program type it looks like and how sure it is, what can be tried, and what the user must confirm"
+      - "Finds out who holds the key (distributor, IT person or accounting firm) and lists the closed questions for them: database engine, read-only user on a copy, scheduled export to a folder, whether the contract allows reading the database, cost"
+      - "Leaves the case open in 02-DOCS with what was asked, to whom and when, so another session can pick it up"
+      - "Never proposes screen automation (RPA) or scraping"
+
+  - scenario: "The user answers the diagnosis: 'Entramos al programa por un escritorio remoto que nos da el distribuidor; en la oficina no hay nada instalado.' Show what the agent concludes and proposes."
+    must_include:
+      - "Recognises a program hosted by the distributor: there is no database to copy and no folder the agent can reach"
+      - "States that the only door is the provider and does not try to reach their servers any other way"
+      - "Proposes asking the distributor for a scheduled export to a folder the client can reach, an integration module or API, or a read-only user on their side, with the cost question"
+      - "Offers the message for the distributor from the messages section, read-only and with nothing opened to the internet"
+      - "If the provider offers nothing, says the honest options are to keep asking the vendor or to weigh migrating, not RPA"
+
+  - scenario: "The user says: 'Llevamos la contabilidad en ContaSOL instalado. Quiero que el agente registre los asientos de las facturas de compra que llegan al correo.' Show the route from the first answer to the first import."
+    must_include:
+      - "Chooses file exchange for writing: the agent generates ContaSOL's official import file in 01-TOOLS/<TOOL>/out/ and a person reviews and imports it; never writes into the program's database"
+      - "Asks for a sample file exported from the user's own ContaSOL and copies its structure, instead of a remembered format"
+      - "Describes the format (columns, encoding, separator, decimal mark, dates) in the tool's README"
+      - "Validates before releasing the file: entries balance, accounts exist in the current chart, no duplicates against a batch log"
+      - "Makes the first import into the program's test company, not the real books"
+
+  - scenario: "The user says: 'Mi ERP no tiene API. ¿Podemos poner un robot que haga clic en las pantallas, o que el agente lea la web del programa?'"
+    must_include:
+      - "Declines screen automation (RPA) and scraping: they act with a person's permissions, break on every update and cannot prove they only read"
+      - "Researches the other routes first: vendor or distributor module, cloud edition with an API, scheduled export, official import file, read-only copy of the database"
+      - "If one exists, proposes it; if none exists, says so and offers asking the vendor or weighing migration with the connect-or-migrate signals"
+

package/skills/connect-tool/references/connect-or-migrate.md

@@ -0,0 +1,96 @@
+# Connect, or migrate?
+
+The agent is only as good as the data it reaches. If the main program lets nothing out (no API, no
+export, no readable database), every automation goes through copy and paste. Sometimes the answer
+is to **connect it with a bridge** (a nightly export, a read-only database user, the distributor's
+module). Sometimes it is to **migrate** to something that connects out of the box. Rarely, it is to
+**build** a replacement. Give one verdict, in one line:
+
+- **Connect as is**: a route from SKILL.md section 2 exists and is good enough.
+- **Connect with a bridge**: file exchange or a read-only copy ([database bridge](database-bridge.md)).
+- **Consider migrating**: with the sum below.
+- **Consider building**: only under the conditions below.
+
+Whether a process deserves automating at all is `automation-strategy`'s question, not this one.
+
+## Signals that the program holds you back (the more, the stronger the case to migrate)
+
+1. **No way to get data out** without a person: no API, no automatic export, no readable database.
+2. **Unsupported version**: the vendor no longer updates it, or it only runs on one office PC.
+3. **The bridge costs more than the change**: an integrator, a module or consulting hours every year
+   for what another program includes.
+4. **Daily copy and paste** between this program and others. More than 3–4 hours a week is over 150
+   hours a year.
+5. **Regulation it does not cover**: in Spain, Veri\*factu and B2B e-invoicing ([Spain](spain.md)).
+   If the vendor does not adapt it, or charges extra, the business has to move anyway.
+6. **Only one person can use it**, or the data ends up in parallel spreadsheets.
+7. **It does not grow**: more users, another site, mobile access.
+
+## Signals not to migrate (yet)
+
+1. **Sector software with unique functions**: construction measurement and BC3, legal health and
+   safety obligations, installer software, a point of sale integrated with its hardware. Generic
+   ERPs do not cover them the same way. **Connect with a bridge.**
+2. **The accounting firm works with this program** and you exchange files. Changing alone breaks
+   that flow. Decide together.
+3. **Mid financial year.** Migrating accounting mid-year complicates the close. The good window is
+   **1 January**, or the start of a quarter for invoicing only.
+4. **The pain is small.** If a nightly export to Excel solves 80 % of what is wanted, do not migrate
+   for the other 20 %.
+5. **Nobody can lead the change** inside the company for one to three months.
+
+## The sum, over two years
+
+**Cost of staying** (per year): hours of copy and paste × the hourly cost; plus bridges, modules or
+consulting to connect it; plus the regulatory risk (forced adaptation, penalties).
+
+**Cost of migrating** (once, plus the difference in fees): first-year licences minus what stops
+being paid; implementation and data migration; training and weeks of lower productivity; the risk
+of data that does not move well or sector modules the target lacks.
+
+**Rule of thumb:** if migrating pays for itself in **18–24 months** and there is a **window**
+(start of the financial year, licence renewal, forced adaptation), recommend it, with one to three
+targets that have a documented API and, ideally, an MCP. If not, **connect with a bridge** and redo
+the sum at the next renewal.
+
+## If migrating: seven steps not to lose anything
+
+1. **Inventory**: which data (customers, items, invoices, accounting) and which processes depend on
+   the program.
+2. **Choose the target with the agent in mind**: a documented API and, if possible, an MCP.
+3. **Export the history** and **keep the old system read-only**. Accounting and invoices must be
+   kept for years: do not delete it.
+4. **Start on a clean date**: start of the year or quarter. Opening balances rather than every
+   movement, unless the target imports them well.
+5. **One month in parallel** with a real process (invoicing, for instance) before switching off.
+6. **Connect the target from day one** (`01-TOOLS/<TARGET>/` and its `test_connection`), so the
+   value shows immediately.
+7. **Train the team** and name who owns the new system.
+
+## The third way: building it
+
+Some businesses replace a program with their own, built with Claude Code: a custom CRM, a simple
+ERP, a bakery's point of sale. Sometimes it is a very good idea; sometimes it is expensive to keep.
+
+Worth it only if **all** of these hold:
+
+- **Small, stable scope**: one function, not "the whole ERP".
+- **Someone maintains it**: code in a repository, backups, security updates, and someone who
+  understands it when the builder is away.
+- **It starts by reading** the old system's data (export or bridge), and both coexist for a while.
+- **It does not invoice.** A program that issues invoices must comply with the invoicing
+  regulations itself ([Spain](spain.md)). Building invoicing almost never pays: connect it.
+
+Not worth it when the program is sector software with legal obligations (health and safety,
+payroll, official accounting), or when only one person understands it.
+
+## Typical targets
+
+| If you have… | Targets to consider | Why |
+|---|---|---|
+| A closed desktop ERP or accounting program, unsupported | Odoo, Holded, Business Central, Sage Active | Cloud with a documented API |
+| Excel as the "ERP" | First Google Sheets or Excel on OneDrive (already connectable); an ERP when volume demands it | Moving the file to the cloud already makes it reachable, at no cost |
+| The WhatsApp Business app for orders or bookings | WhatsApp Business Platform (Cloud API), directly with Meta or a provider | Not a change of tool: the edition with an API |
+| Notion or Airtable as a CRM | A CRM with API and MCP when there are more than two or three salespeople | While small, Notion and Airtable connect well |
+
+Check each target's current API, MCP and price before recommending it ([what to find out](what-to-find-out.md)).