Saltar al contenido principal
driftless sync es un resumen opcional para todo el equipo. Casi nunca lo necesitas, y nunca para empezar. El drift ya te llega como un badge de frescura cuando haces driftless context get sobre el área en la que trabajas. Recurre a sync solo cuando quieras revisar de una vez todo lo que se movió. No inspecciona tu diff local y no recupera contexto específico de archivos. Trae el estado de memoria del repo desde Driftless Cloud y responde una sola pregunta:
¿Qué cambió alrededor de los topics de este repo desde la última vez que miré?

Comando

ComandoFlagsDescripciónEjemplo
sync--jsonMuestra topics stale, actividad reciente de PR y ramas rastreadasdriftless sync
driftless sync
Salida típica:
▌ acme/platform
  workspace: acme  (resolved via config)
  tracking:  main, staging

⚠  2 topics drifted, the team changed code these topics cover, context may be behind:
   auth-boundaries
     src/auth/session.ts changed
     → review the change; if it changed how this works: driftless context update auth-boundaries --what "..." --how "..."

Qué revisa sync

SeñalFuenteQué hacer
Topics staleEventos de push de GitHub en ramas rastreadasRevisa el código que cambió y actualiza el topic si cambió el comportamiento
Actividad reciente de PRObservaciones de la GitHub AppLee los topics tocados antes de trabajar en la misma área
Ramas rastreadasConfiguración del repo en Driftless CloudUsa driftless branches para ver o cambiar el alcance del drift

Cuándo usar sync

El loop de cada día no necesita sync. Ve directo a la recuperación, que lleva el badge de frescura incorporado:
driftless context get --files "src/auth/session.ts,src/auth/token.ts"
Recurre a sync solo cuando quieras la foto completa de todo el equipo de una sola vez:
driftless sync
Si ya tienes cambios locales y quieres los topics que coinciden con el diff:
driftless context get --diff

Salida JSON

Usa --json cuando un agente o un script necesite salida estructurada:
driftless sync --json
La salida JSON incluye:
CampoSignificado
repoorg/repo de GitHub resuelto desde el remote actual
workspaceSlug del workspace de Driftless
trackingRama por defecto y ramas rastreadas adicionales
stale_topicsTopics cuyo código anclado cambió
pr_activityObservaciones recientes de PR y topics tocados

Ramas

El estado stale está acotado a las ramas rastreadas. Si un push ocurre en una rama no rastreada, Driftless registra la actividad pero no marca topics como stale desde esa rama.
ComandoFlagsDescripciónEjemplo
branches--jsonVer las ramas rastreadasdriftless branches
branches add<branch>Rastrea una ramadriftless branches add staging
branches rm<branch>Deja de rastrear una ramadriftless branches rm staging