ktalk-cli 1.0.0__tar.gz → 2.1.0__tar.gz

{ktalk_cli-1.0.0 → ktalk_cli-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ktalk-cli
-Version: 1.0.0
+Version: 2.1.0
 Summary: CLI for accessing Kontur Talk (KTalk) recordings, transcripts and summaries
 Project-URL: Homepage, https://github.com/mdemyanov/ktalk-cli
 Project-URL: Repository, https://github.com/mdemyanov/ktalk-cli
@@ -26,15 +26,18 @@ Description-Content-Type: text/markdown
 [![PyPI](https://img.shields.io/pypi/v/ktalk-cli)](https://pypi.org/project/ktalk-cli/)
 [![Python](https://img.shields.io/pypi/pyversions/ktalk-cli)](https://pypi.org/project/ktalk-cli/)
 
-CLI `ktalk` для доступа к записям [Контур.Толк](https://ktalk.ru) (KTalk) — чтение
-записей, транскриптов и саммари, работа с расписанием, операционный реестр
-обработки записей на SQLite.
+CLI `ktalk` — интерфейс командной строки для тех, кто работает с записями видеовстреч
+[Контур.Толк](https://ktalk.ru) (KTalk) программно: читает записи, транскрипты и саммари,
+управляет расписанием, ведёт локальный реестр обработки записей на SQLite. Годится и как
+самостоятельный инструмент, и как предусловие плагина Claude Code `ktalk` — подробнее в
+разделе «Пакет и плагин Claude Code» ниже.
 
 > Раньше пакет назывался `ktalk-mcp` и, помимо CLI, поднимал MCP-сервер для
 > Claude Code (инструменты вида `ktalk_list_recordings`). Этот слой снят
 > целиком — MCP в пакете больше нет, единственная точка входа — команда
-> `ktalk`. Нужна интеграция с Claude Code — отдельный плагин `ktalk` вызывает
-> эту же CLI напрямую, без MCP-сервера.
+> `ktalk`. Пришли по старой ссылке или ищете `ktalk-mcp` — это тот же проект
+> под новым именем, старый пакет дальше не развивается (о конфликте имени
+> команды при апгрейде — ниже, в «Установке»).
 
 Умеет:
 - Список записей конференций и детали одной записи.
@@ -73,6 +76,18 @@ uv tool uninstall ktalk-mcp
 uv tool install ktalk-cli
 ```
 
+**Проверка версии** — после установки или обновления:
+
+```bash
+ktalk --version    # печатает, например: ktalk-cli 2.1.0
+```
+
+**Обновление** до последней версии — та же команда `install`, только `upgrade`:
+
+```bash
+uv tool upgrade ktalk-cli
+```
+
 ## Авторизация
 
 CLI поддерживает два способа авторизации: session token (кука браузера) и
@@ -222,11 +237,20 @@ ktalk auth-status
 Все команды поддерживают `--json` (валидный JSON в stdout; ошибки — в stderr с
 ненулевым кодом возврата).
 
+### Коды возврата
+
+| Код | Значение |
+|---|---|
+| `0` | Успех. |
+| `1` | Отказ вызова — сеть, сервер, конфигурация. |
+| `2` | Usage error — неверные аргументы CLI (`argparse`). |
+| `3` | Только `ktalk get-transcript`. Данные получены и напечатаны полностью, но независимая сверка идентичности не сошлась (`identity_check.result == "mismatch"`) — состав участников транскрипта разошёлся с составом записи. Это не сбой команды: код 3 отличает «данные есть, но сверка не сошлась» от `0` (сошлось или не проверялось) и от `1`/`2` (данных нет вовсе). Подробности — в самом теле ответа, поле `identity_check` (ADR-024 §Д1). |
+
 | Команда | Назначение |
 |---|---|
 | `ktalk list-recordings [--query Q] [--start-from ISO] [--start-to ISO] [--top N] [--order O] [--page-token T]` | Список записей. `--top` 1–1000 (по умолчанию 30); `--order`: `byTimeNewFirst` (умолчание), `byTimeOldFirst`, `byTitle`, `bySizeBigFirst`, `bySizeSmallFirst`. |
 | `ktalk get-recording <recording_key>` | Детали записи — автор, дата, длительность, участники (список ограничен 6, полный состав — `get-participants`). |
-| `ktalk get-transcript <recording_key> [--chunk N] [--chunk-size N]` | Транскрипт по спикерам с таймкодами. Длинный транскрипт режется на чанки по границам реплик: `--chunk 0` (умолчание) — целиком или первый чанк; `--chunk-size` — макс. символов в чанке (умолчание 30000, ~7500 токенов). |
+| `ktalk get-transcript <recording_key> [--chunk N] [--chunk-size N]` | Транскрипт по спикерам с таймкодами. Длинный транскрипт режется на чанки по границам реплик: `--chunk 0` (умолчание) — целиком или первый чанк; `--chunk-size` — макс. символов в чанке (умолчание 30000, ~7500 токенов). Независимая сверка идентичности включена по умолчанию (`--no-verify-identity` отключает); `--chunk` вне диапазона сверку по сети не запускает вовсе, `identity_check.result == "not_checked"`/`reason: "chunk_out_of_range"`. |
 | `ktalk get-summary <recording_key>` | Полное саммари (краткое резюме + протокол). |
 | `ktalk get-summary-type <recording_key> --type shortSummary\|protocol` | Саммари одного типа. |
 | `ktalk get-participants <recording_key>` | Полный состав участников, включая анонимных — обходит лимит в 6, который отдают `get-recording`/`list-recordings`. |
@@ -386,6 +410,30 @@ uv run ruff check .
 KTALK_SESSION_TOKEN=... KTALK_BASE_URL=... uv run ktalk auth-status
 ```
 
+## Пакет и плагин Claude Code
+
+`ktalk-cli` работает и сам по себе, и как предусловие плагина Claude Code `ktalk`. Плагин не
+обращается к KTalk напрямую и не поднимает MCP-сервер — он вызывает эту же команду `ktalk`
+как единственную точку входа в контур.
+
+Плагин пинует точную версию пакета (не нижний порог: «ровно эта версия», не «эта или новее») в
+собственном файле совместимости. Если что-то в интеграции с плагином ведёт себя не так, как
+описано в его документации, — первым делом сверьте версию:
+
+```bash
+ktalk --version    # см. «Проверка версии» в разделе «Установка»
+```
+
+Версия не совпадает с той, что требует плагин, — обновите пакет тем же способом, что при
+установке (`uv tool upgrade ktalk-cli`, см. «Установка»); не совпадает в другую сторону
+(пакет новее, чем ожидает плагин) — не откатывайте его самостоятельно, сверьтесь с тем, кто
+настраивал плагин.
+
+## Проблемы и вопросы
+
+Нашли баг, некорректное поведение или неточность в документации — заведите issue в этом
+репозитории: https://github.com/mdemyanov/ktalk-cli/issues.
+
 ## Лицензия
 
 MIT

{ktalk_cli-1.0.0 → ktalk_cli-2.1.0}/README.md

@@ -3,15 +3,18 @@
 [![PyPI](https://img.shields.io/pypi/v/ktalk-cli)](https://pypi.org/project/ktalk-cli/)
 [![Python](https://img.shields.io/pypi/pyversions/ktalk-cli)](https://pypi.org/project/ktalk-cli/)
 
-CLI `ktalk` для доступа к записям [Контур.Толк](https://ktalk.ru) (KTalk) — чтение
-записей, транскриптов и саммари, работа с расписанием, операционный реестр
-обработки записей на SQLite.
+CLI `ktalk` — интерфейс командной строки для тех, кто работает с записями видеовстреч
+[Контур.Толк](https://ktalk.ru) (KTalk) программно: читает записи, транскрипты и саммари,
+управляет расписанием, ведёт локальный реестр обработки записей на SQLite. Годится и как
+самостоятельный инструмент, и как предусловие плагина Claude Code `ktalk` — подробнее в
+разделе «Пакет и плагин Claude Code» ниже.
 
 > Раньше пакет назывался `ktalk-mcp` и, помимо CLI, поднимал MCP-сервер для
 > Claude Code (инструменты вида `ktalk_list_recordings`). Этот слой снят
 > целиком — MCP в пакете больше нет, единственная точка входа — команда
-> `ktalk`. Нужна интеграция с Claude Code — отдельный плагин `ktalk` вызывает
-> эту же CLI напрямую, без MCP-сервера.
+> `ktalk`. Пришли по старой ссылке или ищете `ktalk-mcp` — это тот же проект
+> под новым именем, старый пакет дальше не развивается (о конфликте имени
+> команды при апгрейде — ниже, в «Установке»).
 
 Умеет:
 - Список записей конференций и детали одной записи.
@@ -50,6 +53,18 @@ uv tool uninstall ktalk-mcp
 uv tool install ktalk-cli
 ```
 
+**Проверка версии** — после установки или обновления:
+
+```bash
+ktalk --version    # печатает, например: ktalk-cli 2.1.0
+```
+
+**Обновление** до последней версии — та же команда `install`, только `upgrade`:
+
+```bash
+uv tool upgrade ktalk-cli
+```
+
 ## Авторизация
 
 CLI поддерживает два способа авторизации: session token (кука браузера) и
@@ -199,11 +214,20 @@ ktalk auth-status
 Все команды поддерживают `--json` (валидный JSON в stdout; ошибки — в stderr с
 ненулевым кодом возврата).
 
+### Коды возврата
+
+| Код | Значение |
+|---|---|
+| `0` | Успех. |
+| `1` | Отказ вызова — сеть, сервер, конфигурация. |
+| `2` | Usage error — неверные аргументы CLI (`argparse`). |
+| `3` | Только `ktalk get-transcript`. Данные получены и напечатаны полностью, но независимая сверка идентичности не сошлась (`identity_check.result == "mismatch"`) — состав участников транскрипта разошёлся с составом записи. Это не сбой команды: код 3 отличает «данные есть, но сверка не сошлась» от `0` (сошлось или не проверялось) и от `1`/`2` (данных нет вовсе). Подробности — в самом теле ответа, поле `identity_check` (ADR-024 §Д1). |
+
 | Команда | Назначение |
 |---|---|
 | `ktalk list-recordings [--query Q] [--start-from ISO] [--start-to ISO] [--top N] [--order O] [--page-token T]` | Список записей. `--top` 1–1000 (по умолчанию 30); `--order`: `byTimeNewFirst` (умолчание), `byTimeOldFirst`, `byTitle`, `bySizeBigFirst`, `bySizeSmallFirst`. |
 | `ktalk get-recording <recording_key>` | Детали записи — автор, дата, длительность, участники (список ограничен 6, полный состав — `get-participants`). |
-| `ktalk get-transcript <recording_key> [--chunk N] [--chunk-size N]` | Транскрипт по спикерам с таймкодами. Длинный транскрипт режется на чанки по границам реплик: `--chunk 0` (умолчание) — целиком или первый чанк; `--chunk-size` — макс. символов в чанке (умолчание 30000, ~7500 токенов). |
+| `ktalk get-transcript <recording_key> [--chunk N] [--chunk-size N]` | Транскрипт по спикерам с таймкодами. Длинный транскрипт режется на чанки по границам реплик: `--chunk 0` (умолчание) — целиком или первый чанк; `--chunk-size` — макс. символов в чанке (умолчание 30000, ~7500 токенов). Независимая сверка идентичности включена по умолчанию (`--no-verify-identity` отключает); `--chunk` вне диапазона сверку по сети не запускает вовсе, `identity_check.result == "not_checked"`/`reason: "chunk_out_of_range"`. |
 | `ktalk get-summary <recording_key>` | Полное саммари (краткое резюме + протокол). |
 | `ktalk get-summary-type <recording_key> --type shortSummary\|protocol` | Саммари одного типа. |
 | `ktalk get-participants <recording_key>` | Полный состав участников, включая анонимных — обходит лимит в 6, который отдают `get-recording`/`list-recordings`. |
@@ -363,6 +387,30 @@ uv run ruff check .
 KTALK_SESSION_TOKEN=... KTALK_BASE_URL=... uv run ktalk auth-status
 ```
 
+## Пакет и плагин Claude Code
+
+`ktalk-cli` работает и сам по себе, и как предусловие плагина Claude Code `ktalk`. Плагин не
+обращается к KTalk напрямую и не поднимает MCP-сервер — он вызывает эту же команду `ktalk`
+как единственную точку входа в контур.
+
+Плагин пинует точную версию пакета (не нижний порог: «ровно эта версия», не «эта или новее») в
+собственном файле совместимости. Если что-то в интеграции с плагином ведёт себя не так, как
+описано в его документации, — первым делом сверьте версию:
+
+```bash
+ktalk --version    # см. «Проверка версии» в разделе «Установка»
+```
+
+Версия не совпадает с той, что требует плагин, — обновите пакет тем же способом, что при
+установке (`uv tool upgrade ktalk-cli`, см. «Установка»); не совпадает в другую сторону
+(пакет новее, чем ожидает плагин) — не откатывайте его самостоятельно, сверьтесь с тем, кто
+настраивал плагин.
+
+## Проблемы и вопросы
+
+Нашли баг, некорректное поведение или неточность в документации — заведите issue в этом
+репозитории: https://github.com/mdemyanov/ktalk-cli/issues.
+
 ## Лицензия
 
 MIT

{ktalk_cli-1.0.0 → ktalk_cli-2.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ktalk-cli"
-version = "1.0.0"
+version = "2.1.0"
 description = "CLI for accessing Kontur Talk (KTalk) recordings, transcripts and summaries"
 readme = "README.md"
 license = "MIT"

{ktalk_cli-1.0.0 → ktalk_cli-2.1.0}/src/ktalk_cli/cli.py

@@ -212,7 +212,7 @@ def _cmd_dashboard(reg: Registry, args) -> int:
     new = [r for r in recs if r["status"] == "new"]
     stats = {s: sum(1 for r in recs if r["status"] == s) for s in _STATUSES}
     if args.json:
-        _print_json({"new": new, "stats": stats})
+        _print_json({"new": new, "stats": stats, "last_synced": reg.get_meta("last_synced")})
         return 0
     print("# Дашборд KTalk\n")
     print("## Новые записи")

{ktalk_cli-1.0.0 → ktalk_cli-2.1.0}/src/ktalk_cli/cli_content.py

@@ -11,6 +11,7 @@ from __future__ import annotations
 
 import argparse
 import asyncio
+import json
 import sys
 from collections.abc import Awaitable, Callable
 
@@ -26,7 +27,9 @@ from ktalk_cli.formatters import (
     format_summary_by_type,
     render_tool_output,
     render_transcript_output,
+    resolve_chunk_range,
 )
+from ktalk_cli.transcript_identity import check_identity
 
 
 def register_subparsers(sub) -> None:
@@ -48,6 +51,12 @@ def register_subparsers(sub) -> None:
     p_tr.add_argument("--chunk", type=int, default=0)
     p_tr.add_argument("--chunk-size", type=int, default=30000)
     p_tr.add_argument("--json", action="store_true")
+    p_tr.add_argument(
+        "--no-verify-identity",
+        action="store_true",
+        help="Отключить сверку идентичности спикеров с участниками записи (NFR-17, "
+        "по умолчанию включена)",
+    )
 
     p_sum = sub.add_parser("get-summary", help="Полное саммари записи (сеть)")
     p_sum.add_argument("recording_key")
@@ -111,18 +120,82 @@ def cmd_get_recording(_reg, args: argparse.Namespace) -> int:
     return _run(_get_recording(args), format_recording, json_flag=args.json)
 
 
+async def _verify_transcript_identity(client: KTalkClient, recording_key: str, transcript: dict) -> dict:
+    """Оркестрация NFR-17 (ADR-023 §1, ред. 2a2f6e3): независимый вызов
+    `get_recording`; отказ вызова -> `not_checked` (маскирование той же функцией,
+    что и основная ошибка, NFR-5), не исключение наружу — основной результат
+    транскрипта возвращается в любом случае."""
+    try:
+        recording = await client.get_recording(recording_key)
+    except Exception as exc:  # noqa: BLE001 - not_checked, не отказ команды
+        return {"result": "not_checked", "reason": redact_secrets(str(exc))}
+    return check_identity(transcript, recording)
+
+
+def _render_transcript_with_identity(
+    output_text: str, identity_check: dict | None, *, json_flag: bool, in_range: bool = True
+) -> str:
+    """Сборка вывода `get-transcript` (companion-спека «Оркестрация», шаг 5).
+    `identity_check is None` -> сверка отключена (`--no-verify-identity`), выводим
+    как раньше. `in_range` — валидность `--chunk` уже известна вызывающей стороне
+    (`resolve_chunk_range`, ADR-024 §Д3) — на пути вне диапазона JSON-конверт
+    собирается явно (`{"error": …}`), без `try/except JSONDecodeError`."""
+    if identity_check is None:
+        return output_text
+
+    if not json_flag:
+        line = f"[identity-check] {identity_check['result']}"
+        if "reason" in identity_check:
+            line += f" ({identity_check['reason']})"
+        return f"{output_text}\n{line}"
+
+    if not in_range:
+        return json.dumps(
+            {"error": output_text, "identity_check": identity_check},
+            ensure_ascii=False,
+            indent=2,
+        )
+
+    parsed = json.loads(output_text)
+    return json.dumps(
+        {"transcript": parsed, "identity_check": identity_check}, ensure_ascii=False, indent=2
+    )
+
+
 def cmd_get_transcript(_reg, args: argparse.Namespace) -> int:
-    async def _fetch() -> dict:
+    fmt = "raw" if args.json else "markdown"
+
+    async def _fetch() -> tuple[dict, dict | None, bool]:
         async with KTalkClient.from_settings(Settings()) as client:
-            return await client.get_transcript(args.recording_key)
+            data = await client.get_transcript(args.recording_key)
+            in_range, _total_chunks = resolve_chunk_range(data, fmt, args.chunk, args.chunk_size)
+            identity_check = None
+            if not args.no_verify_identity:
+                if in_range:
+                    identity_check = await _verify_transcript_identity(
+                        client, args.recording_key, data
+                    )
+                else:
+                    # ADR-024 §Д3: чанк заведомо вне диапазона — сверка не
+                    # оплачивается сетевым вызовом, `not_checked` формируется
+                    # локально, переиспользуя словарь исходов ADR-023.
+                    identity_check = {"result": "not_checked", "reason": "chunk_out_of_range"}
+            return data, identity_check, in_range
 
     try:
-        data = asyncio.run(_fetch())
+        data, identity_check, in_range = asyncio.run(_fetch())
     except Exception as exc:  # noqa: BLE001 - surface as CLI error, NFR-5 маскирует
         print(f"Ошибка: {redact_secrets(str(exc))}", file=sys.stderr)
         return 1
-    fmt = "raw" if args.json else "markdown"
-    print(render_transcript_output(data, fmt, args.chunk, args.chunk_size))
+    output_text = render_transcript_output(data, fmt, args.chunk, args.chunk_size)
+    print(
+        _render_transcript_with_identity(
+            output_text, identity_check, json_flag=args.json, in_range=in_range
+        )
+    )
+    if identity_check is not None and identity_check.get("result") == "mismatch":
+        # ADR-024 §Д1: отказ становится громким — код 3, отдельный от 0/1/2.
+        return 3
     return 0
 
 

{ktalk_cli-1.0.0 → ktalk_cli-2.1.0}/src/ktalk_cli/formatters.py

@@ -123,7 +123,7 @@ def format_recording(data: dict) -> str:
     title = data.get("title", "Без названия")
     lines = [f"# {title}", ""]
 
-    lines.append(f"- **Ключ:** {data.get('id', data.get('key', 'N/A'))}")
+    lines.append(f"- **Ключ:** {data.get('id') or data.get('key') or 'N/A'}")
     lines.append(f"- **Дата:** {_format_datetime(data.get('createdDate'))}")
 
     created_by = data.get("createdBy")
@@ -162,7 +162,7 @@ def format_recordings_list(data: dict) -> str:
     ]
 
     for rec in entities:
-        rec_id = rec.get("id", rec.get("key", "N/A"))
+        rec_id = rec.get("id") or rec.get("key") or "N/A"
         title = rec.get("title", "Без названия")
         date = _format_datetime(rec.get("createdDate"))
         created_by = rec.get("createdBy") or {}
@@ -318,6 +318,37 @@ def chunk_transcript_raw(data: dict, chunk_size: int) -> list[str]:
     return chunks
 
 
+def _chunk_transcript(data: dict, fmt: str, chunk_size: int, full_text: str) -> list[str]:
+    """Общая точка чанкинга для `render_transcript_output`/`resolve_chunk_range` —
+    не дублирует ветвление raw/markdown (ADR-024 companion-спека §3)."""
+    if fmt == "raw":
+        return chunk_transcript_raw(data, chunk_size)
+    return chunk_transcript_markdown(full_text, chunk_size)
+
+
+def resolve_chunk_range(data: dict, fmt: str, chunk: int, chunk_size: int) -> tuple[bool, int]:
+    """Определяет, лежит ли `chunk` в валидном диапазоне для `data`, БЕЗ сети
+    (ADR-024 §Д3, issue #9) — переиспользует чанкинг `render_transcript_output`,
+    не дублирует его. Отрицательный `chunk` — тоже вне диапазона (не Python-
+    отрицательная индексация).
+
+    Возвращает `(in_range, total_chunks)`.
+    """
+    if fmt == "raw":
+        full_text = format_raw(data)
+    else:
+        full_text = format_transcript(data)
+
+    if chunk == 0 and len(full_text) <= chunk_size:
+        return True, 1
+
+    chunks = _chunk_transcript(data, fmt, chunk_size, full_text)
+    total_chunks = len(chunks)
+    chunk_index = 0 if chunk == 0 else chunk - 1
+
+    return 0 <= chunk_index < total_chunks, total_chunks
+
+
 def render_transcript_output(data: dict, fmt: str, chunk: int, chunk_size: int) -> str:
     """Общий слой чтения транскрипта с чанкингом — единственная точка правды для
     `ktalk_get_transcript` (MCP) и `ktalk get-transcript` (CLI, DEV-002 волны 3):
@@ -332,10 +363,7 @@ def render_transcript_output(data: dict, fmt: str, chunk: int, chunk_size: int)
     if chunk == 0 and total_characters <= chunk_size:
         return full_text
 
-    if fmt == "raw":
-        chunks = chunk_transcript_raw(data, chunk_size)
-    else:
-        chunks = chunk_transcript_markdown(full_text, chunk_size)
+    chunks = _chunk_transcript(data, fmt, chunk_size, full_text)
 
     total_chunks = len(chunks)
     chunk_index = 0 if chunk == 0 else chunk - 1

ktalk_cli-2.1.0/src/ktalk_cli/transcript_identity.py

@@ -0,0 +1,69 @@
+"""Сверка идентичности транскрипта (NFR-17, issue #5, ADR-023 §1 + companion-спека
+«Компоненты — NFR-17»): сверяет состав спикеров транскрипта с составом участников
+записи того же `recording_id` через независимый вызов `get_recording` — обнаруживает
+подмену транскрипта под конкуренцией (RES-006), не связанную с валидностью самого
+запроса.
+
+Чистые функции без сети и побочных эффектов — сеть (`client.get_recording`) и исход
+`not_checked` (отказ вызова) живут в оркестрации `cmd_get_transcript`
+(`cli_content.py`), не здесь.
+"""
+
+from __future__ import annotations
+
+
+def _identity_key(user_ref: dict | None) -> str | None:
+    """Идентификатор пользователя: `userInfo.key` или `.login` (именованный),
+    `anonymousId` или `anonymousName` (аноним), `None` если ссылка пуста — та же
+    приоритетность, что `_format_user_name(with_id=True)` в `formatters.py`, но
+    возвращает сырой токен для сравнения, не строку для вывода."""
+    if not user_ref:
+        return None
+    if user_ref.get("isAnonymous"):
+        return user_ref.get("anonymousId") or user_ref.get("anonymousName")
+    user_info = user_ref.get("userInfo")
+    if not user_info:
+        return None
+    return user_info.get("key") or user_info.get("login")
+
+
+def speaker_identities(transcript: dict) -> set[str]:
+    """Состав спикеров транскрипта: обход `tracks[]`, `speaker`, при отсутствии —
+    `diarizedSpeaker`; треки без обоих не подмешивают `None` в результат."""
+    identities: set[str] = set()
+    for track in transcript.get("tracks") or []:
+        speaker_ref = track.get("speaker") or track.get("diarizedSpeaker")
+        key = _identity_key(speaker_ref)
+        if key is not None:
+            identities.add(key)
+    return identities
+
+
+def participant_identities(recording: dict) -> set[str]:
+    """Состав участников записи: обход `recording["participants"]` (`TalkUserRef[]`)."""
+    identities: set[str] = set()
+    for participant in recording.get("participants") or []:
+        key = _identity_key(participant)
+        if key is not None:
+            identities.add(key)
+    return identities
+
+
+def check_identity(transcript: dict, recording: dict) -> dict:
+    """Четыре исхода (`not_checked` не формируется здесь — исход уровня оркестрации,
+    когда сам вызов `get_recording` падает):
+    - `inconclusive` — любое множество пусто, сравнивать не с чем;
+    - `match` — пересечение непусто;
+    - `mismatch` — оба множества непусты и не пересекаются (сигнатура RES-006)."""
+    transcript_speakers = speaker_identities(transcript)
+    recording_participants = participant_identities(recording)
+
+    if not transcript_speakers or not recording_participants:
+        return {"result": "inconclusive"}
+
+    result = "match" if transcript_speakers & recording_participants else "mismatch"
+    return {
+        "result": result,
+        "transcript_speakers": sorted(transcript_speakers),
+        "recording_participants": sorted(recording_participants),
+    }

{ktalk_cli-1.0.0 → ktalk_cli-2.1.0}/tests/test_cli_content.py

@@ -113,11 +113,15 @@ def test_get_recording_error_goes_to_stderr_with_nonzero_exit(httpx_mock: HTTPXM
 
 @pytest.mark.httpx_mock(assert_all_responses_were_requested=False)
 def test_get_transcript_json_default_returns_raw_json(httpx_mock: HTTPXMock, capsys):
+    """`--no-verify-identity`: предмет теста — форма raw-JSON транскрипта, не NFR-17
+    (ADR-023 §1 сделал сверку идентичности умолчанием — без флага здесь потребовался
+    бы и мок `get_recording`; отдельное покрытие умолчания-включено —
+    `tests/test_nfr17_identity_verification.py`)."""
     from ktalk_cli.cli import main
 
     httpx_mock.add_response(json={"status": "done", "tracks": []})
 
-    rc = main(["get-transcript", "REC-1", "--json"])
+    rc = main(["get-transcript", "REC-1", "--json", "--no-verify-identity"])
 
     assert rc == 0
     out = json.loads(capsys.readouterr().out)
@@ -126,11 +130,13 @@ def test_get_transcript_json_default_returns_raw_json(httpx_mock: HTTPXMock, cap
 
 @pytest.mark.httpx_mock(assert_all_responses_were_requested=False)
 def test_get_transcript_markdown_default(httpx_mock: HTTPXMock, capsys):
+    """`--no-verify-identity` — см. комментарий у `test_get_transcript_json_default_
+    returns_raw_json` выше: предмет здесь — markdown-рендер, не NFR-17."""
     from ktalk_cli.cli import main
 
     httpx_mock.add_response(json={"status": "done", "tracks": []})
 
-    rc = main(["get-transcript", "REC-1"])
+    rc = main(["get-transcript", "REC-1", "--no-verify-identity"])
 
     assert rc == 0
     assert "Транскрипт" in capsys.readouterr().out