Skip to content

Corrección: docs(gentle): agent-gentle deploy and built-in MCP for brains (#103) #104

Open

Description

@barbatdev

Source PR: #103
Branch: docs/agent-gentle-deploy
Head reviewed: cd8989c

Push the fixes to the branch above; do not open a new pull request. Comment on the PR and on this issue when done.

Blocking findings

  • cp -p sobrescribe un mcp.json existente, aunque el comentario afirme lo contrario (docs/gentle-official-migration.md:331): El bloque presenta cp -p ~/.config/mcp/mcp.json ~/.gentle-shell/agent/mcp.json con el comentario "no pisar uno existente", pero cp sin -n reemplaza el destino. Lo verifiqué con un cp -p sobre un archivo existente en un directorio descartable: el contenido del destino quedó reemplazado. La sección no incluye backup previo del archivo de destino, y el home aislado se re-provisiona en cada gs sync (misma doc, línea 268), así que el archivo puede existir antes de ejecutar el procedimiento. Además, L3 del task file registra que el home aislado de agent-gentle ya tenía brains configurados, por lo que la corrida aplicada muy probablemente reemplazó un archivo existente.
    • Failure scenario: En un host cuyo ~/.gentle-shell/agent/mcp.json ya declara work-brain, life-brain y second-brain, se pega el bloque tal cual: cp -p ~/.config/mcp/mcp.json ~/.gentle-shell/agent/mcp.json reemplaza ese archivo por el contenido de ~/.config/mcp/mcp.json. Si la fuente usa otro conjunto o naming de servidores, el host pierde la configuración que funcionaba, no hay backup en la sección, y gentle-shell --isolated mcp list pasa a mostrar el conjunto nuevo o vacío sin que quede rastro de lo anterior.

Acceptance criteria

  • Fixed: cp -p sobrescribe un mcp.json existente, aunque el comentario afirme lo contrario (docs/gentle-official-migration.md:331). The scenario below no longer reproduces: En un host cuyo ~/.gentle-shell/agent/mcp.json ya declara work-brain, life-brain y second-brain, se pega el bloque tal cual: cp -p ~/.config/mcp/mcp.json ~/.gentle-shell/agent/mcp.json reemplaza ese archivo por el contenido de ~/.config/mcp/mcp.json. Si la fuente usa otro conjunto o naming de servidores, el host pierde la configuración que funcionaba, no hay backup en la sección, y gentle-shell --isolated mcp list pasa a mostrar el conjunto nuevo o vacío sin que quede rastro de lo anterior.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    fleetEligible for the TARS fleet night shiftfleet-qastatus:approvedApproved for implementation

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions