Skip to content

chore(core): remove deprecated flat tracker keys (next major) — do not start until removal is signed off #679

Description

@moncher-dev

Epic: #651
리포트 항목: A4 후속docs/reports/2026-08-28-upstream-spec-drift-research.md (PR #650)

⚠️ 착수 금지. 이 이슈는 트래킹 전용이다. flat 키 제거 시점은 별도로 결정되며, 저장소 오너가 이 이슈에 "제거 진행" 사인을 남기기 전까지 구현 PR을 열지 않는다. Symphony 자동 디스패치 대상에서도 제외한다(Project Status를 Ready로 두지 말 것).

배경

#669에서 tracker.provider 객체를 도입하면서 기존 flat 키(tracker.api_key, project_slug, project_id, endpoint, state_field, priority, priority_field, pickup_labels, blocker_check_states, planning_states 등)는 deprecated alias로 유지된다(non-breaking, changeset:minor). 파서가 flat 키를 provider로 승격하고 doctor/workflow validate가 경고 + 변환된 provider 블록을 출력한다.

이 이슈는 그 alias를 다음 major에서 제거하는 작업을 추적한다.

제거 조건 (사인 전 확인)

제거 시 할 일

  • 파서에서 flat 키 alias 경로 삭제, flat 키 발견 시 typed error(workflow_deprecated_key)로 마이그레이션 안내
  • doctor의 변환 출력은 유지(오류 메시지에서 링크)
  • changeset:major, 마이그레이션 가이드, ADR(#669의 ADR에 "제거 완료" supersede 노트)
  • E2E: flat 키 WORKFLOW.md가 명확한 오류로 실패하는 시나리오

완료 기준

  • flat 키 WORKFLOW.md가 typed error로 거부되고, provider 형식만 동작
  • major 릴리스 병합

Blocked by: #669

Metadata

Metadata

Assignees

Labels

breaking-changeBackward-incompatible changechangeset:majorRequires a major changeset for CLI package releasespec-gapSymphony spec compliance gap

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions