From 2ed20916e823821a19a44633c63617afddbf98c5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Javier=20Mart=C3=ADnez?= <sthifer21@gmail.com>
Date: Sun, 8 Mar 2026 10:33:35 +0100
Subject: [PATCH] docs: add CLAUDE.md with build commands and architecture
 notes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 CLAUDE.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..8e206a0
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,47 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+# Compilar TypeScript → out/
+npm run compile
+
+# Compilar en modo watch
+npm run watch
+
+# Empaquetar extensión como .vsix
+npx vsce package --allow-missing-repository --skip-license
+```
+
+No hay suite de tests. Para probar manualmente: `F5` en VS Code abre una ventana de extensión en modo Development Host.
+
+## Arquitectura
+
+Extensión de VS Code de un único fichero fuente (`src/extension.ts`). TypeScript compilado a `out/extension.js` (CommonJS, ES2020).
+
+### Flujo de datos
+
+- `activate()` registra los tres comandos.
+- `getEditorAndSelection()` obtiene editor activo + selección (helper compartido).
+- `replaceSelection()` / `replaceWholeDocument()` aplican ediciones vía `editor.edit()`.
+
+### Comando `fixJson` — pipeline de limpieza
+
+La función `cleanAndParseJson()` prueba estrategias en orden hasta que `JSON.parse()` tenga éxito:
+
+1. Texto tal cual
+2. Trim
+3. `tryUnwrapString` — desenvuelve capa exterior `"…"` vía `JSON.parse`
+4. `wrapAndUnescape` — envuelve en comillas para que el motor desescapee `\"`
+5. Eliminación de barras antes de comillas (sin contexto URL)
+6. Eliminación de barras simétricas `/"key/"` en ambos lados
+7. `grafanaDeepClean` — BOM, CRLF, desescapado multi-nivel, trailing commas, `unquoteJsonStringValues`
+8. `grafanaDeepClean` + `tryUnwrapString` combinados
+
+El formateado final usa `formatJsonText()`, un formateador a nivel de texto que **no pasa por `JSON.parse` → `JSON.stringify`**, preservando así representaciones numéricas como `150.0`.
+
+## Release
+
+Empujar un tag `vX.Y.Z` dispara el workflow `.github/workflows/build.yml`, que sincroniza la versión en `package.json`, empaqueta el `.vsix` y lo adjunta al GitHub Release (lo crea si no existe).