# Задание A: план импорта задач без записи в систему

Статус: спецификация локального демонстрационного прогона, версия 1.0. Автор: Astra. Владелец и принимающий: основной исследователь. Исполнитель: отдельный coding agent. Все данные искусственные. Это не действующий продукт и не пользовательское согласование.

## Цель и границы

Менеджер хочет до сохранения CSV получить список новых задач и ошибок. Реализуется только чистая функция Python 3.12 `plan_import(csv_text: str, existing_ids: set[str]) -> dict` в `pilot/task_import.py`. Стандартная библиотека; без установки пакетов, сети, чтения данных вне `pilot/`, изменения внешней системы. `existing_ids` — уже известные, непустые, нормализованные внешние идентификаторы в заранее выбранной компании; выбор компании и авторизация находятся вне этой задачи. Создание UI, БД, логирование персональных данных и запись задач вне объёма. Функция не изменяет аргументы.

## Контракт результата

Возвращается объект с тремя ключами: `status` (строка `valid` либо `invalid`), `create` (список объектов только с `external_id` и `title`), `errors` (список объектов только с `row` — integer, и `code` — string). `valid` означает отсутствие ошибок; это разрешение предложить план, не приёмка и не запись. При любой ошибке `create=[]` — частичное создание запрещено. Успешный результат без новых строк: `status=valid, create=[], errors=[]`.

## Требования

- R-A1. Если первым символом `csv_text` является U+FEFF, удалить ровно этот один символ. Разбирать CSV с разделителем запятая, кавычкой `"`, удвоением кавычки внутри поля, поддержкой LF/CRLF и переносов строки внутри кавычек; использовать `csv.reader` с `strict=True`. Пустые физические строки пропускает CSV reader. Семантика ошибок синтаксиса — именно стандартный csv.reader, дополнительных запретов не вводить.
- R-A2. Первая запись reader должна в точности равняться `['external_id','title']`, без нормализации заголовка. Если записи нет или заголовок другой, немедленно вернуть `invalid`, `create=[]`, `errors=[{'row':1,'code':'invalid_header'}]`. Для синтаксической ошибки CSV где угодно вернуть только `errors=[{'row':0,'code':'malformed_csv'}]`, даже если заголовок также неправильный: сначала завершить синтаксический разбор всего текста, потом проверять заголовок.
- R-A3. Нумерация `row` — индекс записи reader начиная с 1, включая заголовок. Это не номер физической строки. Для каждой записи после заголовка с числом полей не равным 2 записать `wrong_field_count`, другие проверки этой записи пропустить.
- R-A4. Оба поля обрезать через Python `str.strip()`. Пустой идентификатор даёт `empty_id`; пустое название даёт `empty_title`; длина названия свыше 80 Python Unicode code points после strip даёт `title_too_long`. Название длины 80 допустимо. Другие ограничения на ID и название отсутствуют.
- R-A5. Дубликаты ID в одном файле запрещены с учётом регистра: второй и каждый последующий непустой ID дают `duplicate_id`, независимо от того, было ли у первой записи недопустимое название. В seen входят все непустые ID записей с правильным числом полей. ID в existing_ids не создаются повторно, но их строки всё равно проходят все проверки. Точное совпадение ID обязательно, `A` и `a` различны.
- R-A6. На строке допускается несколько ошибок, порядок `empty_id`, `empty_title`, `title_too_long`, `duplicate_id`. Порядок строк в errors — исходный. Если ошибок нет, create содержит нормализованные записи, которых нет в existing_ids, в исходном порядке. Заголовок без данных — valid с пустым create.

## Примеры (иллюстрация)

Вход `external_id,title\n A , Осмотр \nB,Отчёт\n` и existing_ids `{'B'}` → `{'status':'valid','create':[{'external_id':'A','title':'Осмотр'}],'errors':[]}`.

Вход `external_id,title\nA,\nA,Повтор\n` и пустое existing_ids → `{'status':'invalid','create':[],'errors':[{'row':2,'code':'empty_title'},{'row':3,'code':'duplicate_id'}]}`.

## Проверки и приёмка

- C-A1 → R-A1,R-A2: пустой текст и неправильный заголовок отклоняются; BOM и CRLF принимаются; незакрытая кавычка даёт malformed_csv row 0.
- C-A2 → R-A3,R-A4: строки неверной ширины, пустые значения, названия на границах 80/81, пробелы и Unicode соответствуют контракту.
- C-A3 → R-A5,R-A6: existing_ids, внутренние дубликаты, неверная первая строка дубликата, чувствительность к регистру, атомарный отказ и порядок errors/create.
- C-A4 → R-A1,R-A3: запятые и переводы строк в quoted title разбираются; row указывает запись reader.
- C-A5 → границы: аргументы не изменяются; импорт модуля и вызов функции не производят файловых/сетевых операций; нет зависимостей сверх стандартной библиотеки.

Исполнитель сдаёт модуль и `pilot/implementation-note.md`: что создано, собственные проверки, выявленные вопросы. Основной исследователь независимо запускает проверочные случаи и сохраняет лог. Если проверка не проходит — возврат с ID критерия, без изменения принятой версии спецификации. Если контракт не определяет поведение и это влияет на результат — исполнитель фиксирует блокер, а не придумывает требование. Если всё определено — выполняет без уточнений. Приёмка этого прогона подтверждает только функцию на искусственных данных, не корректность реального импорта и не пригодность стандарта для всех исполнителей.
