# CopilotPlanCard

## 2026-06-24 — New component

**Prompted by:** Tran Quan (Copilot extension request)

### What changed
- New molecule for the broker Copilot extension: renders an agentic **plan** — a
  named plan with a description and an ordered list of steps that execute
  one-by-one.
- Each step renders its own status icon: `pending` (empty circle), `running`
  (animated `TypingDots`), `done` (filled success circle + check), `failed`
  (alert icon).
- Overall plan `status` (`idle` / `running` / `done` / `failed`) drives a header
  status badge and the footer action: **Execute Plan** when idle, a disabled
  "Executing…" spinner while running, hidden when done, and **Retry Plan** after
  a failure.

### Why
- The Copilot surface needs to present a multi-step plan (e.g. "Quickli Scenario
  Sync") and let the broker trigger sequential execution, with live per-step
  progress feedback.

### Affected tokens / files
- `packages/shadcn/src/components/ui/copilot-plan-card.tsx`
- `packages/shadcn/src/components/index.tsx` (barrel export)
- `packages/shadcn/tsup.config.ts` (entry point)
- `packages/shadcn/package.json` (`./copilot-plan-card` export)
- `apps/docs/stories/shadcn/molecules/copilot-plan-card.stories.tsx` (story)
