Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

session-flow: continue-in-background dirty-tree gate ignores worktree.bgIsolation

Abierto Apto para principiantes
#7,288 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
76/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
git, shell
Área
tooling

Línea de trabajo

Lee plugins/session-flow/skills/continue-in-background/SKILL.md, especialmente el paso 1, «Dirty-tree gate», y compara cómo el plugin source-control lee la configuración en plugins/source-control/hooks/worktree-create-gate.sh. Actualiza la barrera y el informe de inicio para tener en cuenta worktree.bgIsolation cuando se establece en none; verifica que el motivo del rechazo y la advertencia coincidan con el comportamiento esperado del issue.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

priority: medium

Summary

/session-flow:continue-in-background's dirty-tree gate assumes a background session always moves into an isolated git worktree before editing, unless the current session is already in a linked worktree. The worktree.bgIsolation setting can turn that isolation off, and then the background session edits the working copy directly. The gate does not read the setting, so its reasoning and outcome are wrong in that configuration.

Affected area / component

plugins/session-flow/skills/continue-in-background/SKILL.md (step 1, "Dirty-tree gate")

Steps to reproduce

  1. In a git repository, set "worktree": {"bgIsolation": "none"} in .claude/settings.json.
  2. Leave an uncommitted change in the checkout.
  3. Run /session-flow:continue-in-background.

Expected behavior

The gate accounts for worktree.bgIsolation. With isolation off, the launched session sees the uncommitted changes, so the "changes won't carry over" reason for refusing does not apply. The real risk is different: the background session and the user would edit the same checkout at the same time, and the launch report should say so.

Actual behavior

  • SKILL.md:124-130: "Background sessions move into an isolated git worktree (a fresh checkout) before editing files (https://code.claude.com/docs/en/agent-view), so OTHER uncommitted changes in this checkout would NOT carry into the launched agent's edits. Any such changes → do NOT launch". The only exception is a session already inside a linked worktree.
  • Live docs, https://code.claude.com/docs/en/agent-view#how-file-edits-are-isolated (read 2026-10-12): "To turn off worktree isolation for a repository where git worktrees are impractical, set worktree.bgIsolation to "none". Background sessions then edit your working copy directly without moving into a worktree first." The same section lists other skip cases (a session moved to the background with /background, a write outside the working directory).
  • Nothing in plugins/session-flow/ mentions bgIsolation (grep -rn bgIsolation plugins/session-flow returns nothing). The source-control plugin already names the setting (plugins/source-control/hooks/worktree-create-gate.sh:64).

Suggested fix

Read the effective worktree.bgIsolation value before the dirty-tree check. When it is "none", skip the "changes won't carry over" refusal and instead warn that the launched session will edit this checkout in place, alongside the user. This is a gate-logic change, not a pointer fix.

Environment

session-flow on main as of 2026-10-12.

Found during the upstream-pointer sweep (PRs #7061-#7274).

Lenguaje dominante
Shell
Estrellas
22
Forks
2
Merge medio
8 h 27 min
PR fusionados (30 d)
957

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de melodic-software/claude-code-plugins

Todos los issues de melodic-software/claude-code-plugins

Issues similares

Más issues de Shell/Bash

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.