json-safe-edit

JSON Safe Edit Protocol

Objetivo

Evitar la corrupción de archivos JSON al editarlos, especialmente cuando contienen valores string largos de línea única (como prompts de agentes).

Cuándo usarla

Siempre que vayas a modificar un archivo .json en el proyecto, especialmente:

• opencode.json — contiene prompts de línea única con \n escapados
• package.json — dependencias y scripts
• angular.json — configuración del proyecto Angular
• tsconfig.json, tsconfig.app.json, tsconfig.spec.json — configuración TypeScript

---

Métodos de edición segura

Método 1: node -e programático (RECOMENDADO para modificar valores específicos)

Usa bash con node -e para parsear, modificar y serializar el JSON. Así evitas problemas con caracteres escapados.

node -e "
const fs = require('fs');
const ruta = 'archivo.json';
const doc = JSON.parse(fs.readFileSync(ruta, 'utf8'));
// Modifica las propiedades necesarias
doc.agenteX.propiedad = 'nuevo valor con \\n saltos';
fs.writeFileSync(ruta, JSON.stringify(doc, null, 2) + '\n');
console.log('✅ JSON actualizado correctamente');
"

Ventajas: No toca el formato del archivo, maneja escapes automáticamente, seguro.

Método 2: cat heredoc (RECOMENDADO para reescribir archivos completos)

Cuando necesites reemplazar el contenido COMPLETO de un archivo JSON (ej: archivos pequeños o nueva creación):

cat > archivo.json << 'EOF'
{
  "clave": "valor con \\n saltos"
}
EOF

Ventajas: Control total del contenido, ideal para archivos nuevos o pequeños.

Método 3: edit tool (SOLO para archivos con estructura multilínea y valores cortos)

Usa la herramienta edit ÚNICAMENTE cuando:

• El archivo JSON tiene estructura multilínea (pretty-printed)
• Los valores string son cortos (< 100 caracteres)
• No contienen caracteres escapados complejos

⚠️ PROHIBIDO usar edit para:

• Archivos JSON con valores string de línea única (como prompts con \n)
• Valores que contengan caracteres escapados
• Reemplazar contenido completo de un archivo JSON