dsh-session-sync refleja tu almacén de sesiones de DSH en un árbol de trabajo git dedicado y lo sincroniza con un remoto que tú controlas — sin servicio en la nube, sin almacenamiento de terceros:

• Comando /sync — status (rama, remoto saneado, delante/detrás, archivos sucios, forks), diff, log, pull, push, help.
• Herramientas sync_status / sync_pull / sync_push — la misma superficie para el modelo, dentro de un turno.
• Resolución de conflictos append-only — los registros de sesión son append-only; ante cualquier divergencia el plugin conserva ambos lados (la versión local se conserva, la remota se preserva como archivos fork) y nunca sobrescribe en silencio. Las sesiones divergentes también pueden bifurcarse a nivel de sesión.
• Modos automáticos — pull al iniciar, push tras cada turno cerrado y pull periódico, todos configurables y reversibles.
• Escrituras con confirmación — pull/push preguntan primero (mediante userQuestions o approval); las superficies de solo lectura nunca preguntan; sin respondedor la operación falla cerrada.

dispositivo A                         remoto (tu repositorio git)              dispositivo B
$DSH_HOME/sessions ──espejo──▶ commit ──push──▶ [sessions] ──pull──▶ merge (conservar ambos + fork)

# 1. instala el bundle en tu perfil
dsh plugin --profile web add "github:PerryLink/dsh-session-sync#main"

# o desde npm (versiones publicadas)
dsh plugin --profile web add dsh-session-sync

# 2. apúntalo a un remoto git privado y verifica la fila
dsh --profile web --dump-config | grep -A2 'id: session-sync'

Luego configura el remoto en tu parche de perfil (un repositorio privado es la base) y sincroniza:

- insert:
    - id: session-sync
      name: dsh-session-sync
      config:
        remote: git@github.com:you/your-dsh-sessions.git

> /sync status
> /sync pull
> /sync push

• Canal git (último main): dsh plugin --profile web add "github:PerryLink/dsh-session-sync#main" (equivalente a instalar desde git+https://github.com/PerryLink/dsh-session-sync.git). Sin paso de compilación — index.mjs y lib/ son los artefactos publicados.
• Canal npm (versiones publicadas): dsh plugin --profile web add dsh-session-sync.
• Canal tarball: pnpm pack en este repositorio, luego dsh plugin --profile web add ./dsh-session-sync-<version>.tgz.
• Desinstalar: dsh plugin --profile web remove dsh-session-sync (o elimina la fila del parche de perfil).

Todos los ajustes son campos de Config de Schemastery (modificables desde cordis.yml). Una sobrescritura dirigida por id reemplaza toda la fila — repite cada clave que necesites. cordis.patch.yml documenta cada clave en línea.

Ejemplo de sobrescritura en tu parche de perfil:

- insert:
    - id: session-sync
      name: dsh-session-sync
      config:
        remote: git@github.com:you/your-dsh-sessions.git
        branch: main
        autoPushOnTurnEnd: true
        pullIntervalMinutes: 30
        confirmVia: userQuestions

• Permisos: las operaciones mutadoras cruzan la puerta de confirmación (confirmVia); el plugin nunca reimplementa ni elude los servicios userQuestions/approval del harness. Los modos automáticos están cubiertos por la concesión de configuración y nunca reconfirman.
• Datos: los metadatos de sincronización (id de dispositivo, último pull/push, última cabecera de push, último error) viven en el dominio de almacenamiento session-sync. Los archivos de sesión se copian como bytes opacos — el plugin nunca los analiza. El id de dispositivo también se escribe en device.txt en el repositorio de sincronización para la atribución de forks entre dispositivos.
• Registro de sesión: sync/push, sync/pull y sync/conflict están declarados en types.d.ts; se anexan solo cuando el host registra los tipos (ver Limitaciones conocidas). Todo lo escrito o mostrado se sanea.

• Nunca sobrescribe en silencio. El merge de tres vías append-only conserva ambos lados ante cualquier divergencia; los archivos fork nunca se eliminan y git nunca fuerza push, resetea, rebase ni cambia de rama.
• Contención de rutas. Los archivos se reflejan como bytes opacos con enlaces simbólicos rechazados y cada ruta unida se comprueba por contención (PATH_UNSAFE falla alto).
• Salida saneada. Las credenciales de URL remota, los tokens y los secretos key=value se redactan antes de llegar al modelo o al registro; la visualización de rutas rechaza todo lo que esté fuera de su raíz.
• Sin almacenamiento de credenciales. El plugin no almacena credenciales; las credenciales de git viven en tu helper de credenciales normal. Las identidades/destinatarios age los gestionas tú, y las claves nunca entran en el repositorio de sincronización.
• Endurecimiento de git. git se ejecuta con GIT_TERMINAL_PROMPT=0 y GIT_OPTIONAL_LOCKS=0, acotado por plazo y señal, con un límite de salida por flujo.
• Falla cerrada. La falta de respondedor de confirmación, de remoto o una ruta insegura rechaza la operación alto.

backend: encrypted añade una capa age opcional sobre el espejo: los bytes de sesión se cifran en archivos encrypted/**/*.age antes de commitear y subir, y se descifran de vuelta al espejo local en texto plano antes de fusionar. La fusión a tres bandas siempre se ejecuta en texto plano localmente, por lo que la semántica append-only de conservar ambos lados no cambia.

Qué protege el cifrado:

• El contenido del espejo en reposo en el remoto. Los archivos de sesión que subes son texto cifrado age; el host remoto, sus operadores y cualquiera que clone el repositorio no ven los bytes de sesión en claro sin la clave privada.

Qué no protege (la frontera):

• Las claves e identidades age son tuyas. Los archivos de destinatario/identidad nunca son distribuidos, almacenados ni rotados por el plugin. Si una clave se filtra, el contenido del espejo que protege queda expuesto. Usa una identidad sin frase de contraseña y mantenla fuera del repositorio.
• El remoto sigue siendo en la práctica un repositorio privado. Los metadatos de git — mensajes de commit, el .gitignore, la estructura de rutas encrypted/, los nombres de rama y la actividad de push/fetch — siguen siendo visibles para el host remoto. El cifrado oculta el contenido, no el hecho de que sincronizas, ni la forma de tu árbol de sesiones.
• El texto plano sigue existiendo localmente. El espejo en <repoDir>/sessions/ es texto plano en disco; el cifrado protege la copia transmitida/remota, no el cifrado del disco local ni el almacén de sesiones en vivo.
• La degradación elegante significa texto plano. Con backend: encrypted, si falta age, o ageRecipient/ageIdentity están vacíos, el plugin cae al camino git en texto plano y avisa explícitamente en el estado/registro — nunca finge cifrar. Revisa la advertencia en /sync status antes de confiar en el remoto como cifrado.

Línea base: con backend: git (el predeterminado), los bytes de sesión se almacenan sin cifrar en tu remoto git — usa un repositorio privado.

• El cifrado es opcional. backend: encrypted añade una capa age (ver «Cifrado y modelo de amenazas» arriba); si falta age o las claves, cae a texto plano con una advertencia explícita. Con backend: git (el predeterminado), los bytes de sesión se almacenan sin cifrar en tu remoto git — usa un repositorio privado.
• Se requiere git. El plugin necesita el ejecutable git y el servicio subprocess; sin ellos, las operaciones de sincronización fallan con un motivo claro (los perfiles siguen arrancando).
• Eventos de sesión en 0.1.0-rc.6/0.1.0-rc.8/0.1.1-rc.2. El harness aún no registra los tipos sync/*, por lo que los anexos al registro de sesión se omiten (las sesiones siguen cargando); el plugin los habilita automáticamente una vez que un host registra los tipos o expone el envoltorio ignorable en Session.append.
• approval entre turnos. /sync se ejecuta entre turnos, donde el canal approval no tiene un turno abierto al que adjuntarse; usa confirmVia: userQuestions para la sincronización por comando, o impulsa la sincronización mediante las herramientas dentro de un turno.

pnpm install                                       # node ^22.19 || >=24
pnpm run typecheck && pnpm run typecheck:ci        # tsc --checkJs contra los peers 0.1.1-rc.2 publicados
pnpm test                                          # node --test (12 archivos de test; la suite git del motor se omite sin git)
pnpm run verify:self-contained                     # las specs de dependencias resuelven desde el registro
pnpm run verify:artifacts                          # archivos publicados presentes + index.mjs importable
pnpm run check:readmes                             # consistencia de los cinco README
pnpm pack                                          # el tarball publicado

No hay paso de compilación: ESM puro, index.mjs y lib/ son los artefactos publicados.

dsh, dsh-plugin, deepseek-harness, deepseek, cordis, session-sync, session, git, sync, cross-device

• @PerryLink — creador y mantenedor: motor de espejo git, merge append-only conservando ambos, comando /sync y herramientas sync_*, modos automáticos, saneadores y documentación en cinco idiomas.

Este proyecto es uno de los 33 complementos de DeepSeek Harness mantenidos por PerryLink. Si este te ayuda, probablemente los demás también:

LICENSE (Apache License 2.0) © 2026 dsh-session-sync contributors