From bdbeb11d15355896fd796113bcd15832c0ae02e8 Mon Sep 17 00:00:00 2001 From: leemour Date: Thu, 15 Oct 2026 17:41:43 +0200 Subject: [PATCH 1/3] docs: review Drive 0.11.1 and correct source linking guides --- content/docs/how-things-are-linked.es.md | 4 ++++ content/docs/how-things-are-linked.md | 4 ++++ content/docs/how-things-are-linked.ru.md | 4 ++++ 3 files changed, 12 insertions(+) diff --git a/content/docs/how-things-are-linked.es.md b/content/docs/how-things-are-linked.es.md index 4d157de..6847604 100644 --- a/content/docs/how-things-are-linked.es.md +++ b/content/docs/how-things-are-linked.es.md @@ -68,6 +68,10 @@ Cada mensaje puede apuntar al mensaje anterior al que responde. Cada puntero dic - La transcripción de una nota de voz pertenece al mensaje, así que `transcript:` encuentra ese mensaje. - Una imagen se encuentra por el chat que la rodea o por lo que muestra. Ambas vías se explican en [Qué se indexa](./what-is-indexed.md#imágenes). +## Transcripciones de reuniones + +Un fragmento de transcripción tiene una referencia `meeting:` que conserva su reunión y revisión. Úsala para leer el contexto y conservar la cobertura. Un participante puede vincularse explícitamente a una persona y una reunión puede pertenecer a un proyecto confirmado; coincidir en el nombre no crea esos vínculos. Vincular un participante no demuestra quién pronunció un fragmento. [Evidencia y vínculos de reuniones](./zoom.mdx) explica cómo comprobar esas asociaciones antes de guardar un hallazgo con fuentes. + ## Menciones Una mención es un teléfono, una dirección de correo, un enlace, un enlace a un documento de Google o el nombre de una persona que conoces, encontrados con reglas en el texto de mensajes, archivos y transcripciones. Cada mención empieza como `found`. Después la confirmas (`linked`) o la rechazas (`dismissed`). diff --git a/content/docs/how-things-are-linked.md b/content/docs/how-things-are-linked.md index 4eac83f..9a3c3e1 100644 --- a/content/docs/how-things-are-linked.md +++ b/content/docs/how-things-are-linked.md @@ -68,6 +68,10 @@ Every message can point at the earlier message it answers. Each pointer says whe - A voice note's transcript belongs to the message, so `transcript:` finds that message. - A picture is found through the chat around it or through what it shows. Both are explained in [What gets indexed](./what-is-indexed.md#pictures). +## Meeting transcripts + +A transcript cue has a `meeting:` reference that retains its meeting and transcript revision. Use it to read the surrounding passage and keep its coverage. A participant can be explicitly linked to a person, and a meeting can have confirmed project membership; a name match alone creates neither link. A participant link does not establish who spoke a cue. [Meeting evidence and links](./zoom.mdx) explains how to inspect these associations before saving a sourced finding. + ## Mentions A mention is a phone number, an email address, a link, a Google document link, or the name of a person you know, found by rules in message text, file text and transcripts. Each mention starts as `found`. You then confirm it (`linked`) or reject it (`dismissed`). diff --git a/content/docs/how-things-are-linked.ru.md b/content/docs/how-things-are-linked.ru.md index 203f55a..04c29a2 100644 --- a/content/docs/how-things-are-linked.ru.md +++ b/content/docs/how-things-are-linked.ru.md @@ -68,6 +68,10 @@ tg personal contacts timeline "Kai Sample" --since-time 2026-10-01 --limit 20 - Расшифровка голосового принадлежит сообщению, поэтому `transcript:` находит это сообщение. - Картинку находят через чат вокруг неё или по тому, что на ней. Оба способа описаны в разделе [Что попадает в поиск](./what-is-indexed.md#картинки). +## Расшифровки встреч + +Фрагмент расшифровки имеет ссылку `meeting:`, сохраняющую встречу и ревизию текста. По ней можно прочитать соседние фрагменты и проверить охват. Участника можно явно связать с человеком, а встречу — подтвердить в проекте; совпадение имени само по себе не создаёт этих связей. Связь участника с человеком не доказывает, кто произнёс конкретный фрагмент. [Доказательства и связи встреч](./zoom.mdx) объясняет, как проверить эти связи перед сохранением вывода с источниками. + ## Упоминания Упоминание — это телефон, адрес почты, ссылка, ссылка на документ Google или имя знакомого вам человека, найденные по правилам в тексте сообщений, файлов и расшифровок. Каждое упоминание начинается как `found`. Затем вы подтверждаете его (`linked`) или отклоняете (`dismissed`). From 9051ee38ad45735dbb0c9d1b44f50106b4f743bf Mon Sep 17 00:00:00 2001 From: leemour Date: Thu, 15 Oct 2026 17:45:57 +0200 Subject: [PATCH 2/3] docs: clarify cue references and confirmed mention timeline boundaries --- content/docs/how-things-are-linked.es.md | 3 +++ content/docs/how-things-are-linked.md | 3 +++ content/docs/how-things-are-linked.ru.md | 3 +++ 3 files changed, 9 insertions(+) diff --git a/content/docs/how-things-are-linked.es.md b/content/docs/how-things-are-linked.es.md index 6847604..5c434b7 100644 --- a/content/docs/how-things-are-linked.es.md +++ b/content/docs/how-things-are-linked.es.md @@ -26,6 +26,7 @@ Cada resultado lleva una referencia: un nombre corto y con tipo del registro. Ú | `person:7` | Una persona, con todas las cuentas que vinculaste a ella | | `organization:3`, `project:4`, `task:5` | Tus organizaciones, proyectos y tareas | | `note:12`, `document:3` | Una nota, o un archivo de una carpeta de notas o de Drive | +| `meeting:1/7/3/4` | Un fragmento de transcripción conservado: cuenta, reunión, transcripción y posición | | `memory:8`, `fact:9` | Un recuerdo o un hecho | Una referencia de mensaje incluye la cuenta, así que el mismo número en otra cuenta es otro mensaje. El campo que contiene la referencia se llama `ref` en la mayoría de las respuestas. Algunas lo llaman `locator`, y una lista de Drive lo llama `reference`. Copia el valor, no el nombre del campo. @@ -62,6 +63,8 @@ Cada mensaje puede apuntar al mensaje anterior al que responde. Cada puntero dic `conversations build` une esos punteros en conversaciones de un chat. `messages context` con `--thread` sigue la cadena desde un mensaje en lugar de mostrar sus vecinos en el tiempo. Un vínculo que quedó desactualizado tras una edición o un borrado se muestra, pero no se sigue. Al reconstruir, las conversaciones reciben ids nuevos, así que conserva la referencia `msg:` del mensaje, no el id de la conversación. Cómo se construye el grafo: [Cómo funciona la búsqueda](./search-architecture.mdx#3-reconstruir-conversaciones-con-un-grafo-de-mensajes). +La cronología de una persona sigue la participación guardada y los vínculos explícitos de mensajes. Confirmar una mención de teléfono, correo o nombre permite buscarla con `mentions:`, pero no añade por sí solo una entrada a la cronología. + ## Archivos, notas de voz e imágenes - Un archivo pertenece a un mensaje, un correo o una reunión. Su texto extraído se queda con él, así que `content:` encuentra el mensaje que llevaba el archivo. diff --git a/content/docs/how-things-are-linked.md b/content/docs/how-things-are-linked.md index 9a3c3e1..7ca475e 100644 --- a/content/docs/how-things-are-linked.md +++ b/content/docs/how-things-are-linked.md @@ -26,6 +26,7 @@ Every result carries a reference: a short typed name for the record. Copy it int | `person:7` | A person, with all the accounts you linked to them | | `organization:3`, `project:4`, `task:5` | Your organizations, projects and tasks | | `note:12`, `document:3` | A note, or a file from a notes folder or Drive | +| `meeting:1/7/3/4` | A retained transcript cue: account, meeting, transcript, cue position | | `memory:8`, `fact:9` | A memory or a fact | A message reference includes the account, so the same message number in another account is a different message. The field that holds the reference is `ref` in most answers. A few answers call it `locator`, and one Drive list calls it `reference`. Copy the value, not the field name. @@ -62,6 +63,8 @@ Every message can point at the earlier message it answers. Each pointer says whe `conversations build` joins these pointers into conversations for one chat. `messages context` with `--thread` follows the chain from a message instead of showing its neighbours in time. A link that went out of date after an edit or a deletion is shown but never followed. A rebuild gives conversations new ids, so keep the `msg:` reference of the message, not the conversation id. How the graph is built: [How search works](./search-architecture.mdx#3-reconstruct-discussions-with-a-message-graph). +The person timeline follows recorded participation and explicit message links. Confirming a found phone, email or name mention makes it searchable with `mentions:`, but does not by itself add a timeline entry. + ## Files, voice notes and pictures - A file belongs to a message, an email or a meeting. Its extracted text stays with it, so `content:` finds the message that carried the file. diff --git a/content/docs/how-things-are-linked.ru.md b/content/docs/how-things-are-linked.ru.md index 04c29a2..89b6f13 100644 --- a/content/docs/how-things-are-linked.ru.md +++ b/content/docs/how-things-are-linked.ru.md @@ -26,6 +26,7 @@ description: "Какие записи инструменты связывают | `person:7` | Человек со всеми аккаунтами, которые вы к нему привязали | | `organization:3`, `project:4`, `task:5` | Ваши организации, проекты и задачи | | `note:12`, `document:3` | Заметка либо файл из папки заметок или из Drive | +| `meeting:1/7/3/4` | Сохранённый фрагмент расшифровки: аккаунт, встреча, расшифровка и позиция | | `memory:8`, `fact:9` | Запись памяти или факт | Ссылка на сообщение включает аккаунт, поэтому то же число в другом аккаунте — другое сообщение. Поле со ссылкой в большинстве ответов называется `ref`. В некоторых ответах оно называется `locator`, а в одном списке Drive — `reference`. Копируйте значение, а не имя поля. @@ -62,6 +63,8 @@ tg personal contacts timeline "Kai Sample" --since-time 2026-10-01 --limit 20 `conversations build` собирает эти указатели в разговоры одного чата. `messages context` с `--thread` идёт по цепочке от сообщения, а не показывает соседей по времени. Связь, устаревшая после правки или удаления, показывается, но по ней не идут. После пересборки у разговоров новые id, поэтому сохраняйте ссылку `msg:` на сообщение, а не id разговора. Как строится граф: [Как устроен поиск](./search-architecture.mdx#3-разговоры-как-граф-сообщений). +Хронология человека следует сохранённому участию и явным связям сообщений. Подтверждение найденного телефона, адреса почты или имени позволяет искать его через `mentions:`, но само по себе не добавляет запись в хронологию. + ## Файлы, голосовые и картинки - Файл принадлежит сообщению, письму или встрече. Его извлечённый текст остаётся при нём, поэтому `content:` находит сообщение, которое принесло файл. From 205e3ad411259db8965bbcbe54fbe25ea239b4a9 Mon Sep 17 00:00:00 2001 From: leemour Date: Thu, 15 Oct 2026 17:46:30 +0200 Subject: [PATCH 3/3] docs: keep timeline explanation beside person associations --- content/docs/how-things-are-linked.es.md | 4 ++-- content/docs/how-things-are-linked.md | 4 ++-- content/docs/how-things-are-linked.ru.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/docs/how-things-are-linked.es.md b/content/docs/how-things-are-linked.es.md index 5c434b7..08ce1f5 100644 --- a/content/docs/how-things-are-linked.es.md +++ b/content/docs/how-things-are-linked.es.md @@ -53,6 +53,8 @@ tg personal contacts timeline "Kai Sample" --since-time 2026-10-01 --limit 20 La herramienta también anota quién participó en qué (remitente, destinatario, participante, responsable, autor, mencionado, vinculado). Por eso «todo sobre Kai» es una sola consulta y no un recorrido por todos los mensajes. +La cronología de una persona sigue la participación guardada y los vínculos explícitos de mensajes. Confirmar una mención de teléfono, correo o nombre permite buscarla con `mentions:`, pero no añade por sí solo una entrada a la cronología. + ## Respuestas y conversaciones Cada mensaje puede apuntar al mensaje anterior al que responde. Cada puntero dice de dónde viene: @@ -63,8 +65,6 @@ Cada mensaje puede apuntar al mensaje anterior al que responde. Cada puntero dic `conversations build` une esos punteros en conversaciones de un chat. `messages context` con `--thread` sigue la cadena desde un mensaje en lugar de mostrar sus vecinos en el tiempo. Un vínculo que quedó desactualizado tras una edición o un borrado se muestra, pero no se sigue. Al reconstruir, las conversaciones reciben ids nuevos, así que conserva la referencia `msg:` del mensaje, no el id de la conversación. Cómo se construye el grafo: [Cómo funciona la búsqueda](./search-architecture.mdx#3-reconstruir-conversaciones-con-un-grafo-de-mensajes). -La cronología de una persona sigue la participación guardada y los vínculos explícitos de mensajes. Confirmar una mención de teléfono, correo o nombre permite buscarla con `mentions:`, pero no añade por sí solo una entrada a la cronología. - ## Archivos, notas de voz e imágenes - Un archivo pertenece a un mensaje, un correo o una reunión. Su texto extraído se queda con él, así que `content:` encuentra el mensaje que llevaba el archivo. diff --git a/content/docs/how-things-are-linked.md b/content/docs/how-things-are-linked.md index 7ca475e..974127f 100644 --- a/content/docs/how-things-are-linked.md +++ b/content/docs/how-things-are-linked.md @@ -53,6 +53,8 @@ tg personal contacts timeline "Kai Sample" --since-time 2026-10-01 --limit 20 The tool also records who took part in what (sender, recipient, participant, assignee, author, mentioned, linked). That record is why "everything about Kai" is one lookup and not a scan of every message. +The person timeline follows recorded participation and explicit message links. Confirming a found phone, email or name mention makes it searchable with `mentions:`, but does not by itself add a timeline entry. + ## Replies and conversations Every message can point at the earlier message it answers. Each pointer says where it came from: @@ -63,8 +65,6 @@ Every message can point at the earlier message it answers. Each pointer says whe `conversations build` joins these pointers into conversations for one chat. `messages context` with `--thread` follows the chain from a message instead of showing its neighbours in time. A link that went out of date after an edit or a deletion is shown but never followed. A rebuild gives conversations new ids, so keep the `msg:` reference of the message, not the conversation id. How the graph is built: [How search works](./search-architecture.mdx#3-reconstruct-discussions-with-a-message-graph). -The person timeline follows recorded participation and explicit message links. Confirming a found phone, email or name mention makes it searchable with `mentions:`, but does not by itself add a timeline entry. - ## Files, voice notes and pictures - A file belongs to a message, an email or a meeting. Its extracted text stays with it, so `content:` finds the message that carried the file. diff --git a/content/docs/how-things-are-linked.ru.md b/content/docs/how-things-are-linked.ru.md index 89b6f13..4091407 100644 --- a/content/docs/how-things-are-linked.ru.md +++ b/content/docs/how-things-are-linked.ru.md @@ -53,6 +53,8 @@ tg personal contacts timeline "Kai Sample" --since-time 2026-10-01 --limit 20 Инструмент также записывает, кто в чём участвовал (отправитель, получатель, участник, исполнитель, автор, упомянутый, связанный). Поэтому «всё о Kai» — это один запрос, а не перебор всех сообщений. +Хронология человека следует сохранённому участию и явным связям сообщений. Подтверждение найденного телефона, адреса почты или имени позволяет искать его через `mentions:`, но само по себе не добавляет запись в хронологию. + ## Ответы и разговоры У каждого сообщения может быть указатель на более раннее сообщение, на которое оно отвечает. Каждый указатель знает, откуда он взялся: @@ -63,8 +65,6 @@ tg personal contacts timeline "Kai Sample" --since-time 2026-10-01 --limit 20 `conversations build` собирает эти указатели в разговоры одного чата. `messages context` с `--thread` идёт по цепочке от сообщения, а не показывает соседей по времени. Связь, устаревшая после правки или удаления, показывается, но по ней не идут. После пересборки у разговоров новые id, поэтому сохраняйте ссылку `msg:` на сообщение, а не id разговора. Как строится граф: [Как устроен поиск](./search-architecture.mdx#3-разговоры-как-граф-сообщений). -Хронология человека следует сохранённому участию и явным связям сообщений. Подтверждение найденного телефона, адреса почты или имени позволяет искать его через `mentions:`, но само по себе не добавляет запись в хронологию. - ## Файлы, голосовые и картинки - Файл принадлежит сообщению, письму или встрече. Его извлечённый текст остаётся при нём, поэтому `content:` находит сообщение, которое принесло файл.