knowledge-meeting-ingest

Ingesta de reuniones

Convierte una transcripción en una página de reunión con fuentes, perfiles de entidades actualizados y afirmaciones estructuradas, y luego verifícalas. Lee una referencia solo cuando su paso la necesite:

• configuración: siempre, primero (estado, ontología, búsqueda)
• adquisición de fuentes: obtención desde una API, incluida Granola
• fuentes: conservar originales; formato de citas
• oradores: posible división, duplicado o orador poco claro
• identidad: resolución de una persona, empresa o proyecto
• redacción: antes de escribir cualquier texto de página
• página de reunión: redacción de la página de reunión
• perfiles: crear o actualizar un perfil
• afirmaciones: afirmaciones, aristas de asistencia, reejecuciones
• publicar: escrituras por lote o por página
• recuperación: cualquier escritura incierta, rechazada o conflictiva
• verificar: verificación e informe

Contrato

• Una página por reunión real. Conserva la transcripción completa; los resúmenes del grabador son afirmaciones, no hechos.
• Los oradores se resuelven con evidencia y un nivel de confianza, nunca se adivinan. Usa cada señal real; deja un orador sin resolver solo cuando no haya ninguna.
• Cada participante (habló, fue interpelado o participó de otra manera) recibe un perfil con una línea de Línea de Tiempo y una arista de asistencia. Los nombres que solo aparecen en la lista de invitados no reciben ninguna.
• Toda empresa, proyecto o concepto del que la reunión hable de manera sustantiva recibe una página (encontrada o creada), una línea de Línea de Tiempo y enlaces en ambas direcciones. Las menciones pasajeras no.
• Las páginas se leen como buenas notas humanas: nombres primero, pocas salvedades, sin comentarios sobre el proceso.
• Las decisiones, compromisos y eventos se convierten en afirmaciones. Las afirmaciones no verificadas no se propagan a otras páginas.
• Nunca consideres una reunión completamente ingerida hasta que la verificación pase.

Pasos

1. Adquirir y normalizar

Obtén la transcripción completa. Una entrada vacía, solo con resumen o en progreso falla este paso: repórtalo. Si el usuario solo quiere guardar notas, usa knowledge-capture e indica que la ingesta de la reunión no está completa.

Normaliza en el contexto de trabajo a: fuente, source_id, título, fecha, hora, duración, asistentes (afirmaciones de la fuente), segmentos ordenados con speaker, speaker_raw y text, resumen de la fuente, URL. Los valores desconocidos son nulos. El manejo específico del grabador termina aquí; todos los grabadores ejecutan los mismos pasos después de esto.

Conserva la exportación original y la transcripción (fuentes). El texto normalizado es un derivado etiquetado. Reporta la adquisición, retención y publicación por separado, con recuentos reales ("9/16 originales conservados").

Lee la transcripción normalizada una vez, en secciones de aproximadamente 150 líneas. Después de cada sección, añade a un archivo de resumen de trabajo: el rango de líneas, quién habló, temas, decisiones candidatas, compromisos y hechos con citas exactas de líneas, candidatos a citas textuales y nuevos nombres propios. Los pasos posteriores redactan a partir del resumen. Vuelve a la transcripción solo para rangos de líneas específicos (para verificar redacción o una cita), nunca para una relectura completa.

Hecho cuando: transcripción completa conservada; recibos de evidencia en mano; el resumen cubre cada línea.

2. Dividir, deduplicar, resolver oradores

Verifica si hay una grabación de múltiples reuniones, una página existente para esta reunión y el mapa de oradores (oradores).

Hecho cuando: cada reunión real tiene su rango de segmentos; duplicados encontrados; cada etiqueta de orador está mapeada o explícitamente sin resolver, con fundamento.

3. Evaluar cada afirmación

Verifica cada afirmación propuesta contra la transcripción y el Conocimiento anterior sobre la misma entidad.

• Rol o relación: pasaje explícito, no implicación.
• Propiedad: lenguaje explícito de propiedad; mencionar un nombre no es poseerlo.
• Nuevo nombre propio: busca en Conocimiento, luego en la web si está permitido, la ortografía canónica; de lo contrario, escríbelo como Nombre (ortografía no verificada) y no le des página ni enlace.
• Evento importante de vida o negocio: respaldo palabra por palabra, verificado contra la cronología existente.

El respaldo de la transcripción no es suficiente por sí solo. También verifica:

• Contradicción: ¿entra en conflicto con lo que Conocimiento ya establece? El contenido establecido gana por defecto. No escribas la afirmación conflictiva en los perfiles; mantenla en la página de la reunión con ambas citas y enumérala en el informe para que el usuario la resuelva. Anula solo con respaldo explícito palabra por palabra, e informa igualmente el cambio.
• Plausibilidad: ¿es posible dado lo que se sabe? (Dos personas no pueden haber iniciado el mismo proyecto; una empresa fundada el año pasado no fue adquirida hace cinco años). Una imposibilidad generalmente significa un error.
• Sorpresa: si el usuario diría "espera, ¿qué?", aplica todas las comprobaciones. Presenta la sorpresa como una pregunta; no la expliques.

Las inferencias e identidades inciertas permanecen etiquetadas en la página de la reunión y nunca ingresan a perfiles, líneas de tiempo, metadatos o relaciones como hechos.

Hecho cuando: cada afirmación está marcada como publicar, etiquetar-como-incierta o retener.

4. Publicar

Orden: página de reunión → páginas de entidad → afirmaciones y aristas → ediciones de enlaces. Agrupa registros relacionados (publicar).

• Página de reunión según página de reunión.
• Para cada participante y entidad sustantiva, sigue los pasos en el archivo SKILL.md de knowledge-entities: resuelve la entidad, decide si recibe una página y escribe el perfil y la línea de Línea de Tiempo. Sus referencias con los mismos nombres que las de esta habilidad son copias idénticas; usa las que ya leíste y no las releas. Su única referencia adicional es el enriquecimiento (lee su sección "Durante la ingesta").
• Afirmaciones según afirmaciones: decisiones, compromisos, hechos y un evento source_event: true para la reunión en sí, con todas las entities relevantes. Otros eventos mantienen sus propias fechas.
• Una relación attended con evidencia por participante. En la ontología enviada, la relación va de participante a reunión; confírmalo en la definición. Establece source_page.
• Las personas mencionadas con páginas también reciben enlaces. No crees páginas para oradores desconocidos.
• Para contenido legal o personal, mantén la página de la reunión factual y limita la difusión a los perfiles; pregunta si el alcance no está claro.

Hecho cuando: cada registro planificado tiene un recibo de publicación en tu registro de trabajo.

5. Verificar (puerta estricta, cada reunión)

Ejecuta verificar primero. Luego verifica:

• Sustancia: las secciones requeridas tienen contenido o una razón fundamentada en las fuentes.
• Enlaces: knowledge_verify expectedLinks para reunión ↔ cada entidad, más entities/dependencies de afirmaciones, owner de compromisos y from/to/label/source_page de aristas. Cada perfil enlazado tiene una línea de Línea de Tiempo para esta reunión.
• Estado: ningún perfil actualizado tiene un tema de Estado nombrado por una fecha o reunión.
• Estilo: verifica los borradores en tus archivos de trabajo contra redacción antes de publicar: nombres primero, sin salvedades apiladas, sin notas para ti mismo, sin líneas de relleno. No leas las páginas publicadas para verificar el estilo; después de una corrección, relee solo la sección que cambiaste.
• Oradores: ninguna etiqueta sin procesar pasa como persona conocida; ejecuta la verificación de asistente inventado en oradores.
• Citas: lee cada intervalo de líneas citado con knowledge_evidence_read. Solo las palabras de relleno ("como", "sabes") pueden diferir. Corrige una cita fallida restaurando las palabras dichas o eligiendo un intervalo más limpio; nunca mantengas una paráfrasis en una cita.
• Secuencia: compara el orden narrado (antes/durante/después, lugares, personas) con las marcas de tiempo, independientemente del orden de los encabezados. Usa knowledge_chronicle_day (fecha y zona horaria de la reunión) y knowledge_timeline para entidades relacionadas. Una inversión o lugar/hora imposible es una contradicción; nunca inventes tránsito. Corrige y vuelve a verificar, o registra una exención explícita del usuario como EXENTADO, no resuelto. Una exención cubre solo la secuencia. Un participante que falta en la crónica del día generalmente significa una línea de Línea de Tiempo faltante: investiga, no bloquees. El orden genuinamente ambiguo se señala en el informe, no se bloquea.

Hecho cuando: todas las verificaciones pasan, o los fallos se corrigen y vuelven a verificar.

Informe

Una línea por reunión (una por página para una grabación dividida): página, fuentes conservadas, asistentes enriquecidos, entidades actualizadas o reutilizadas, elementos de acción, afirmaciones y aristas, resultado de verificación, secuencia PASÓ o EXENTADA con la contradicción abierta. Enumera las contradicciones con Conocimiento existente, las afirmaciones retenidas, las identidades no resueltas y el trabajo restante aquí, en el informe, no en las páginas; el usuario las resuelve. Si una verificación no puede pasar, reporta la reunión como no ingerida y nombra la verificación. Un informe parcial es progreso honesto, no finalización.