Epic: #651
리포트 항목: A16 — docs/reports/2026-08-28-upstream-spec-drift-research.md (PR #650)
문제
새 스펙 §11.2(MUST): 각 어댑터는 코드가 아닌 문서로 compact profile을 공개해야 한다. 현재 packages/tracker-github/README.md(3줄), packages/tracker-linear/README.md(7줄)에는 아래 항목이 없다.
프로필에 들어갈 항목 (§11.2)
- 지원하는
tracker.kind 값
tracker.provider 키, 기본값, 시크릿 키/env 이름(secretEnvironmentNames 포함), 검증 오류
- scope 선택(project/board/team/repository), pagination, provider 요청 제한(page size, timeout, rate-limit 정책 — 2026-07-19 리포트 참조)
id와 native_ref 매핑 (GitHub: issue node ID vs project item ID; Linear: issue id)
- state(합성
Archived 포함)·label·priority·timestamp·dispatchable·malformed-record·optional-field 정규화 규칙
- provider-native 툴 요약 (S21 문서 링크)
- language-native 오류 →
tracker_request/tracker_status/tracker_response/tracker_pagination/tracker_rate_limited/invalid_tracker_config/missing_tracker_secret 매핑 표
할 일
docs/trackers/github-project.md, linear.md, file.md 신설(또는 패키지 README 확장) + docs/README.md living documents 등록
docs/architecture.md §5에서 링크
완료 기준
- 세 프로필이 위 항목을 모두 포함하고 S17에서 확정된 provider 키와 일치
Blocked by: #669
Epic: #651
리포트 항목: A16 —
docs/reports/2026-08-28-upstream-spec-drift-research.md(PR #650)문제
새 스펙 §11.2(MUST): 각 어댑터는 코드가 아닌 문서로 compact profile을 공개해야 한다. 현재
packages/tracker-github/README.md(3줄),packages/tracker-linear/README.md(7줄)에는 아래 항목이 없다.프로필에 들어갈 항목 (§11.2)
tracker.kind값tracker.provider키, 기본값, 시크릿 키/env 이름(secretEnvironmentNames포함), 검증 오류id와native_ref매핑 (GitHub: issue node ID vs project item ID; Linear: issue id)Archived포함)·label·priority·timestamp·dispatchable·malformed-record·optional-field 정규화 규칙tracker_request/tracker_status/tracker_response/tracker_pagination/tracker_rate_limited/invalid_tracker_config/missing_tracker_secret매핑 표할 일
docs/trackers/github-project.md,linear.md,file.md신설(또는 패키지 README 확장) +docs/README.mdliving documents 등록docs/architecture.md§5에서 링크완료 기준
Blocked by: #669