fn_registry/functions/infra/vault_index_open.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
vault_index_open	function	go	infra	1.0.0	impure	func VaultIndexOpen(vaultPath string) (*sql.DB, error)	Abre (o crea) vault_index.db dentro de vaultPath con WAL + FK y aplica las migraciones embebidas idempotentemente. El caller cierra la conexion.	vault sqlite index migration infra	sqlite_open_go_infra sqlite_apply_migrations_go_infra			false	error_go_core	database/sql embed fmt path/filepath	name desc vaultPath ruta absoluta o relativa al directorio raiz del vault	*sql.DB apuntando a <vaultPath>/vault_index.db con schema completo aplicado; el caller es responsable de cerrar	true	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	functions/infra/vault_index_open_test.go	functions/infra/vault_index_open.go

Ejemplo

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.