chore: auto-commit (95 archivos)

- cmd/fn/doctor.go
- cmd/fn/main.go
- cpp/apps/primitives_gallery/playground/tables/CMakeLists.txt
- cpp/apps/primitives_gallery/playground/tables/data_table.cpp
- cpp/apps/primitives_gallery/playground/tables/data_table_logic.cpp
- cpp/apps/primitives_gallery/playground/tables/data_table_logic.h
- cpp/apps/primitives_gallery/playground/tables/self_test.cpp
- cpp/apps/primitives_gallery/playground/tables/tql.cpp
- cpp/apps/primitives_gallery/playground/tables/viz.cpp
- cpp/apps/primitives_gallery/playground/tables/viz.h
- ...

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

functions/infra/vault_index_open.md

@@ -0,0 +1,54 @@
+---
+name: vault_index_open
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func VaultIndexOpen(vaultPath string) (*sql.DB, error)"
+description: "Abre (o crea) vault_index.db dentro de vaultPath con WAL + FK y aplica las migraciones embebidas idempotentemente. El caller cierra la conexion."
+tags: [vault, sqlite, index, migration, infra]
+uses_functions: ["sqlite_open_go_infra", "sqlite_apply_migrations_go_infra"]
+uses_types: []
+returns: []
+returns_optional: false
+error_type: "error_go_core"
+imports: [database/sql, embed, fmt, path/filepath]
+params:
+  - name: vaultPath
+    desc: "ruta absoluta o relativa al directorio raiz del vault"
+output: "*sql.DB apuntando a <vaultPath>/vault_index.db con schema completo aplicado; el caller es responsable de cerrar"
+tested: true
+tests:
+  - "crea vault_index.db en tmpdir vacio"
+  - "segunda apertura no falla (idempotente)"
+  - "todas las tablas esperadas existen en sqlite_master"
+  - "fts5 INSERT y MATCH funcionan"
+test_file_path: "functions/infra/vault_index_open_test.go"
+file_path: "functions/infra/vault_index_open.go"
+---
+
+## Ejemplo
+
+```go
+db, err := VaultIndexOpen("/data/vaults/turismo_spain")
+if err != nil {
+    log.Fatal(err)
+}
+defer db.Close()
+```
+
+## Notas
+
+El archivo de base de datos se crea en `<vaultPath>/vault_index.db`. Las migraciones
+viven en `vault_index_migrations/*.sql` embebidas via `//go:embed` en el mismo paquete.
+
+Schema creado por `001_init.sql`:
+- `files` — inventario de archivos (PK: rel_path)
+- `files_fts` — tabla FTS5 virtual para busqueda de texto (content_text lo llenan profilers posteriores)
+- `csv_profiles` — perfil de columnas/filas para .csv (FK → files)
+- `pdf_extracts` — metadatos de extraccion de texto para .pdf (FK → files)
+- `knowledge_docs` — headings/frontmatter para .md del bucket knowledge (FK → files)
+
+`SQLiteOpen` abre con WAL mode + foreign keys. `ApplyMigrations` es idempotente:
+los errores de "already exists" y "duplicate column" se ignoran silenciosamente.