sdlc-hub/openspec/specs/migration/spec.md

migration Specification

Purpose

TBD - created by archiving change bridge-core. Update Purpose after archive.

Requirements

Requirement: Инициализация настроек

jira-hub init --config <admin/jira-sync/config.example.json> SHALL перенести в setting: project_key, типы задач, epic_name_field_id, fields, epic_link, priority_map, labels, status_labels, kind_labels, comment_marker, pacing (в новую форму по типам команд), transitions.map, link_types, sprints.board_id; сгенерировать два токена; установить base_jql = "project = AURORA AND labels = AWPCA". Поля auth, base_url, verify_ssl, ca_bundle MUST NOT переноситься (они у агента).

Scenario: Повторный init

• WHEN init вызван на уже инициализированной базе
• THEN настройки не перезаписываются без --force, токены сохраняются

Requirement: Импорт CSV-пакета

jira-hub import <папка admin/jira-sync> SHALL прочитать tasks.csv, new_tasks.csv, epics.csv и заполнить issue_note (ключ Jira; для строк без ключа — new:<номер строки>): статус по факту, вид работы, что сделано, что осталось, внутренние колонки. links.csv SHALL импортироваться как сверочный набор в отчёт импорта (ожидаемые связи против зеркала после первого refresh), не как команды. Связь, которой в зеркале нет как source→target того же типа, но есть как target→source того же типа, SHALL попадать в reversed_links, а не в missing_links. Импорт идемпотентен: повтор обновляет заметки, не дублирует.

Scenario: Импорт и первая синхронизация

• WHEN выполнены init, import, запущены хаб и агент, refresh full завершён
• THEN число задач зеркала ≥ числа строк tasks.csv + созданных из new_tasks.csv; отчёт импорта перечисляет ключи из CSV, которых нет в зеркале, связи из links.csv, которых нет в issue_link, и связи, которые есть в обратную сторону

Scenario: Связь в обратную сторону

• WHEN в links.csv строка «AURORA-1445 → AURORA-1446, связанные», а в зеркале есть только «ASUPR_Связанные» 1446→1445
• THEN связь в reversed_links, в missing_links её нет

Requirement: Что остаётся в admin/

После ввода моста admin/jira-sync/README.md SHALL получить в начале пометку «заменено мостом jira-hub/jira-agent, CSV заморожены <дата>»; jira_sync.py, CSV, runs/, summary.md, _generator/ остаются как история без изменений. Артефакт просмотрщика на claude.ai MUST NOT переопубликовываться.

Scenario: Пометка в README

• WHEN мост запущен и первая синхронизация сверена с CSV
• THEN README пакета начинается с пометки и ссылки на репозитории моста