Referencia completa de campos

Esta página es la referencia canónica para el usuario final de cada entrada y control de la Entry Web UI.

Cómo leer esta referencia

Cada campo indica:

• Config key — la clave usada en los archivos de configuración y en la CLI
• Control — el tipo de entrada
• Default — el valor por defecto seguro
• Risk — normal, caution o risky
• Notes — qué hace el campo y cuándo conviene cambiarlo

Core

Config key	Control	Default	Risk	Notes
enabled	toggle	true	risky	Interruptor general. Desactivarlo detiene el comportamiento de Engram.
scope	select	both	risky	Destino de guardado: workspace, global, both.
update	select	auto	normal	Comprobación silenciosa de actualización del paquete: auto, manual, off.
read	select	auto	normal	Cuándo los hooks inyectan memoria: auto, startup, always, manual, off.
proof	select	off	normal	Línea de prueba del hook: off, compact.
global_path	text	vacío	risky	Ruta del sistema de archivos para la memoria global.
default_profile	select	vacío	risky	Perfil que se usa cuando no se establece ninguno explícitamente.
roles	roles	vacío	normal	Nombres de rol separados por comas para el enrutamiento.

Ignore Rules

Config key	Control	Default	Risk	Notes
ignore.source	select	engramignore	normal	Fuentes de reglas de análisis: engramignore, gitignore, both, off.
ignore.gitignore_path	text	.gitignore	normal	Ruta del archivo de exclusión de Git.
ignore.engramignore_path	text	.engramignore	normal	Ruta del archivo de exclusión de Engram.
ignore.global_engramignore	toggle	true	normal	Aplica las reglas de exclusión globales cuando están configuradas.
ignore.also_ignore	list	*.secret, private/**	normal	Patrones glob adicionales separados por comas.
ignore.global_patterns	textarea	vacío	normal	Un glob global por línea; inject sincroniza un bloque gestionado del workspace.

Load Routing

Config key	Control	Default	Risk	Notes
load.limit	number 1–32	8	normal	Máximo de memorias devueltas por una carga normal.
load.working_ttl_days	number 1–365	14	normal	Días que una memoria de objetivo de tarea permanece en el nivel de trabajo.

Memory Limits

Config key	Control	Default	Risk	Notes
memory.rule_line_target	number 50–200, step 10	70	normal	Número de líneas recomendado para las reglas.
memory.rule_line_hard_limit	number 50–200, step 10	100	risky	Número máximo estricto de líneas para las reglas.
memory.include_author_email	toggle	false	risky	Escribe author_email en el frontmatter de las memorias nuevas (author_name se escribe siempre).

Hooks

Config key	Control	Default	Risk	Notes
hooks.path_rules	select	native	normal	native: Claude y Cursor cargan las memorias con applies_to desde archivos de reglas generados y Claude registra InstructionsLoaded. hook: mantiene el hook PreToolUse de Claude y elimina los archivos de reglas de Claude.

Graph

Config key	Control	Default	Risk	Notes
graph.enabled	toggle	true	normal	Activa el enrutamiento por dependencias/relaciones.
graph.max_related	number 1–20	4	normal	Limita las memorias relacionadas procedentes de las aristas del grafo.
graph.min_related_score	number 0–1, step 0.01	0.22	normal	Puntuación mínima de similitud para las aristas relacionadas.

Vector Search

Config key	Control	Default	Risk	Notes
vector.enabled	toggle	false	normal	Experimental: activa un enrutamiento local opcional con vectores hash (no son embeddings semánticos). Desactivado por defecto.
vector.provider	select	sqlite-vec	normal	El único proveedor vectorial local compatible.
vector.auto_threshold	number 10–1000	100	normal	Número de memorias a partir del cual se activa la búsqueda vectorial.
vector.candidate_pool	number 8–100	24	normal	Candidatas consideradas antes de reordenar.
vector.dimensions	number 16–512	64	normal	Dimensiones de embedding; reconstruya tras cambiarlas.

Rule Variants

Config key	Control	Default	Risk	Notes
rule_variants.enabled	toggle	false	normal	Presenta la redacción light y strict derivada del Content de cada regla (desactivado presenta balanced).
rule_variants.active	select	balanced	normal	Variante activa: light, balanced, strict.

Live Sync

Config key	Control	Default	Risk	Notes
live_sync.enabled	toggle	false	normal	Sincroniza los archivos de contexto de agente generados al guardar.
live_sync.targets	list	agents-md, claude-md, cursor-rules	normal	Destinos de contexto generados que live sync actualiza.

Global Git

Config key	Control	Default	Risk	Notes
global_git.enabled	toggle	true	risky	Activa el comportamiento de Git para la memoria global.
global_git.remote	text	origin	risky	Nombre del remoto Git; sin espacios en blanco.
global_git.remote_url	text	vacío	risky	URL del remoto compartido de la memoria global.
global_git.branch	text	main	risky	Rama de destino para la sincronización.
global_git.auto_sync	toggle	true	risky	Comportamiento automático de pull/push.
global_git.auto_resolve	toggle	true	risky	Gestión automática de conflictos; revise los diffs.

Pattern Mining

Config key	Control	Default	Risk	Notes
pattern_mining.enabled	toggle	false	normal	Extracción experimental de patrones recurrentes.
pattern_mining.threshold	number 1–20	3	normal	Repeticiones antes de que un patrón importe.
pattern_mining.lookback_sessions	number 1–100	20	normal	Sesiones recientes que se inspeccionan.

PR Workflow

Config key	Control	Default	Risk	Notes
pr_workflow.enabled	toggle	false	risky	Flujo experimental de PR de equipo.
pr_workflow.provider	text	vacío	risky	Identificador del proveedor de un flujo de equipo configurado.
pr_workflow.repo	text	vacío	risky	Identificador del repositorio de un flujo de equipo configurado.
pr_workflow.target_branch	text	main	risky	Rama que recibe los PR de memoria.

Encryption

Config key	Control	Default	Risk	Notes
encryption.enabled	toggle	false	risky	Modo de cifrado futuro/avanzado.
encryption.scope	select	global	risky	Ámbito: workspace, global.
encryption.key_source	select	portable-file	risky	Estrategia de origen de la clave; riesgo de pérdida de la copia de seguridad.

Memoria respaldada por evidencia

Campo	Significado
schema_version	3 para las memorias creadas o actualizadas recientemente; las v1/v2 heredadas siguen siendo legibles.
authority	instruction para reglas/skills, reference para conocimiento. Los registros de traza usan authority: evidence.
evidence_refs	ID de traza inmutables tr_... que respaldan la memoria.
derived_from	Identificadores de sesión u origen de los que se destiló la memoria.
revision	Entero positivo que se incrementa cuando se actualiza una memoria existente.
supersedes / superseded_by	Relaciones explícitas de reemplazo.
valid_from / valid_until	Intervalo de tiempo en el que la memoria es válida; valid_until puede quedar abierto.
last_confirmed	Fecha en la que la memoria se confirmó por última vez.

Controles que no son de configuración

Consulte las páginas de cada pestaña para ver los controles que no son de configuración:

• Pestaña Construct
• Pestaña Memories
• Pestaña Review
• Pestaña Core
• Pestaña Connections

La gestión de perfiles y workspaces está disponible en la pestaña Construct y mediante engram profile y engram workspace. Consulte Perfiles y resolución de ámbito.

Próximos pasos

• Pestaña Construct
• Guía de redacción de campos

Identidad de autor de Git

Engram puede almacenar un autor global y una anulación opcional por workspace. La resolución es workspace, global y, por último, un respaldo de Git de solo lectura. Los ajustes afectan solo a memorias futuras; una anulación de workspace nunca cambia la configuración global de Git. Use plan y confirmación explícitos para la sincronización con Git global o la migración de memorias heredadas.

engram author show
engram author set --name "Jane Doe" --email "jane@example.com"
engram author unset --scope workspace
engram author sync-git-global --plan
engram author sync-git-global --confirm
engram author migrate-memories --plan
engram author migrate-memories --confirm

Lea la guía completa de ajustes del autor de Git.

Inventario de actualización de configuración

Tras actualizar un paquete, ejecute engram upgrade --latest --plan antes de engram upgrade --latest. El inventario compartido analiza las memorias, instrucciones, skillsets, configuraciones, hooks y plugins gestionados por Engram en el workspace y en el ámbito global. Los bytes escritos por personas se conservan; los archivos mixtos ambiguos se informan como conflictos. Consulte Actualizaciones de configuración.