/zenhub:sprint-rollover [--dry-run] [--to next| < name > ]

// 0. Workspace IDs (conventions: query before any move) + repositoryIds for pipeline reads
const workspace = await mcp__zenhub__getWorkspacePipelinesAndRepositories();
const repositoryIds = workspace.githubRepositories.map(r = >   r.id);

// 1. Resolve source (always active) + target (default  " next " ). Fail-closed on either.
const active = await mcp__zenhub__getSprint(); // no id = ACTIVE sprint
const target = await resolveSprint(opts.to ||  " next " ); // see zenhub-conventions Sprint Selector Resolution
if (!active) throw new Error( " 활성 스프린트 없음 — getSprint() 가 비었습니다. 스프린트가 진행 중인지 확인하세요. " );
if (!target) throw new Error(`대상 스프린트 해석 실패 (--to ${opts.to ||  " next " }). 라이브 open: ${(await mcp__zenhub__listRecentSprints()).openSprints.map(s = >   s.name).join( " ,  " )}`);
if (target.id === active.id) throw new Error( " 대상 스프린트가 활성 스프린트와 동일합니다 — carryover 대상이 없습니다. " );

// 2. Active-sprint issues, keep only UNFINISHED = GitHub state OPEN (closed = done, leave as-is).
//    No getIssue/getChildrenOfParent — fetch via searchLatestIssues by sprint membership.
const inSprint = await mcp__zenhub__searchLatestIssues({ query: `sprint: " ${active.name} " ` });
const unfinished = inSprint.filter(i = >   i.state ===  " OPEN " ); // CLOSED stays put (step 5)

// 3. Per unfinished issue: remove from active → add to target → guard pipeline to Sprint Backlog.
const sprintBacklog = workspace.pipelines.find(p = >   p.name ===  " Sprint Backlog " );
if (!sprintBacklog) throw new Error(` ' Sprint Backlog '   파이프라인 없음. 라이브: ${workspace.pipelines.map(p = >   p.name).join( " ,  " )}`);

let movedPoints = 0;
const moved = [];
for (const issue of unfinished) {
  if (!opts.dryRun) {
    await mcp__zenhub__removeIssuesFromSprints({ sprintIds: [active.id], issueIds: [issue.id] });
    await mcp__zenhub__addIssuesToSprints({ sprintIds: [target.id], issueIds: [issue.id] });
    await mcp__zenhub__moveIssueToPipeline({ issueId: issue.id, pipelineId: sprintBacklog.id });
  }
  movedPoints += issue.estimate?.value ?? 0; // estimate read = setIssueEstimate signal (Matrix effort axis)
  moved.push({ number: issue.number, title: issue.title, points: issue.estimate?.value ?? 0 });
}

// 4. Capacity warning (B5): read target ' s existing load and warn if post-carryover  >   ~90%.
const targetDetail = await mcp__zenhub__getSprint(target.id);
const existing = targetDetail.totalPoints ?? 0;
const capacity = targetDetail.capacity ?? null; // null = no capacity set → skip warn
const projected = existing + movedPoints;
const overCapacity = capacity != null  & &   projected  >   capacity * 0.9;

// 5. Report (CLOSED issues untouched).
return {
  dryRun: !!opts.dryRun,
  from: active.name, to: target.name,
  movedCount: moved.length, movedPoints, moved,
  capacity: { existing, carryover: movedPoints, projected, capacity },
  warning: overCapacity
    ? `⚠️ 대상 스프린트  ' ${target.name} '   과적: ${projected}/${capacity} pt (carryover 후 90% 초과). 일부 이슈를 Product Backlog/Icebox 로 남기는 것을 검토하세요.`
    : null,
};

// Sprint selector (from rules/zenhub-conventions.md — reference, do not redefine)
async function resolveSprint(selector) {
  if (selector ===  " next " ) return await mcp__zenhub__getUpcomingSprint();
  if (!selector || selector ===  " current " ) return await mcp__zenhub__getSprint(); // active
  const { openSprints } = await mcp__zenhub__listRecentSprints();
  return openSprints.find(s = >   s.name.includes(String(selector)));
}

// Carryover primitives (the gap this command fills — removeIssuesFromSprints was never called elsewhere)
await mcp__zenhub__removeIssuesFromSprints({ sprintIds: [ " < activeSprintId > " ], issueIds: [ " < issueGraphqlId > " ] });
await mcp__zenhub__addIssuesToSprints({ sprintIds: [ " < targetSprintId > " ], issueIds: [ " < issueGraphqlId > " ] });

// Pipeline guard — fail-closed lookup, never an unguarded .id
const sprintBacklog = workspace.pipelines.find(p = >   p.name ===  " Sprint Backlog " );
if (!sprintBacklog) throw new Error(` ' Sprint Backlog '   파이프라인 없음. 라이브: ${workspace.pipelines.map(p = >   p.name).join( " ,  " )}`);
await mcp__zenhub__moveIssueToPipeline({ issueId:  " < issueGraphqlId > " , pipelineId: sprintBacklog.id });

// Closed-issue check (verify by GitHub state, NOT by a board column — 2-state model)
const closed = await mcp__zenhub__searchClosedIssues({ query: `# < n > ` });