Почистить комментарии от упоминаний процесса

Удалены <remarks>, <summary> сжаты до короткой фразы, вырезаны
ссылки на Task/Ruling/этап/python/прототип; //-комментарии со ссылками
на процесс удалены; то же в .proto. Правила обновлены в
docs/spec/Код-стайл-Дейл.md. Строк комментариев 27210 -> ~19100.
This commit is contained in:
Rustam Khalimov
2026-09-11 13:39:39 +03:00
parent 5f5538d33b
commit b053d58335
902 changed files with 3902 additions and 12074 deletions
@@ -1,21 +1,17 @@
namespace Deal.Telegram.Telegram;
/// <summary>
/// Результат чтения выборки источника для оценки кандидата (план Task 11; 1:1 discovery_read
/// python-прототипа telegram.py L718–760: {ok, error, messages}).
///
/// ok=false — история недоступна (приватный/закрытый источник без членства), error="no_history";
/// это НЕ ошибка сессии/RPC, а нормальный ответ контракта (ReadForEvalReply.ok=false).
/// Результат чтения выборки источника для оценки кандидата.
/// </summary>
public sealed record DiscoveryReadResult
{
/// <summary>
/// Код причины ok=false: история недоступна без членства (1:1 прототип L726).
/// Код причины ok=false
/// </summary>
public const string NoHistoryError = "no_history";
/// <summary>
/// Пустой успешный результат (limit ≤ 0 — выборка не запрашивалась, прототип L730–732).
/// Пустой успешный результат.
/// </summary>
public static DiscoveryReadResult Empty { get; } = new(true, null, []);
@@ -36,7 +32,7 @@ public sealed record DiscoveryReadResult
}
/// <summary>
/// Создаёт результат «история недоступна» (ok=false, error=no_history, сообщений нет).
/// Создаёт результат «история недоступна»
/// </summary>
public static DiscoveryReadResult NoHistory()
=> new(false, NoHistoryError, []);
@@ -47,12 +43,12 @@ public sealed record DiscoveryReadResult
public bool Ok { get; }
/// <summary>
/// Код причины при ok=false: "no_history"; иначе null.
/// Код причины при ok=false
/// </summary>
public string? Error { get; }
/// <summary>
/// Сообщения выборки (для обычных источников topic_id/topic_title пусты).
/// Сообщения выборки
/// </summary>
public IReadOnlyList<DiscoveryMessage> Messages { get; }
}