# Tasks: add-payment-provider-stripe

> Every checkbox reflects work actually done in this change. No
> retroactive ticking.

## 1. Spec authoring

- [x] 1.1 Read `../suaveplan/enterprise/payment-providers.md` end-to-end
- [x] 1.2 Read `openspec/specs/payment-providers/spec.md` (slim-core canonical spec)
- [x] 1.3 Read `openspec/AGENTS.md` Sections 13 and 14
- [x] 1.4 Draft `proposal.md` from `openspec/templates/proposal.md`
- [x] 1.5 Fill in `## Source mapping` — every requirement cites a line
  range in the upstream source or appears in the "no source line"
  table with justification
- [x] 1.6 Draft `specs/payment-provider-stripe/spec.md` from
  `openspec/templates/spec-delta.md`
- [x] 1.7 Every requirement in the spec delta carries a
  `**Verified by:**` line naming concrete `it(...)` titles

## 2. Implementation

- [x] 2.1 Scaffold `packages/universal/payment-provider-stripe/`
  (`package.json` at `0.1.0`, `vite.config.ts`, `vitest.config.ts`,
  `tsconfig.json`, `tsconfig.lib.json`)
- [x] 2.2 Implement `src/stripe/stripe.types.ts` — `StripeConfig`,
  `StripeIntent`, `StripeRefund` wire-format types
- [x] 2.3 Implement `src/stripe/stripe.ts` — `StripeProvider` class,
  every `PaymentProvider` method routed through `httpRequest` with
  Bearer auth + `Idempotency-Key` forwarding, mappers from Stripe
  domain to `PaymentIntent` / `Refund`, every error raised through
  the slim-core `PaymentProviderError`
- [x] 2.4 `src/stripe/index.ts` — explicit named barrel
- [x] 2.5 `src/index.ts` — package root barrel re-exporting
  `StripeProvider` + `StripeConfig`
- [x] 2.6 `package.json#exports` — root + `./stripe/stripe` subpath

## 3. Tests

- [x] 3.1 `src/stripe/stripe.test.ts` — covers every public method,
  Bearer-auth header presence, `Idempotency-Key` forwarding when
  caller supplies it AND absence when caller omits, every status /
  refund-status / refund-reason branch, payment-method absence,
  `provider: "stripe"` discriminant propagation on raised errors,
  injected `FetchLike` + caller `signal` forwarding
- [x] 3.2 `tests/dep-graph.test.ts` — pins universal-tier purity (no
  `node:` / `bun:` / `fs` / `path` / `stream` / `net` / `http` /
  `crypto` imports under `src/`)
- [x] 3.3 Every `it(...)` carries `{ timeout: 5000 }`
- [x] 3.4 Zero `vi.mock` / `vi.stubGlobal` / `jest.mock` — all tests
  use real recording `FetchLike` closures

## 4. Documentation

- [x] 4.1 `src/stripe/stripe.md` — sibling doc with Purpose,
  Features, Basic Usage, Advanced Usage, API Reference,
  Implementation Notes (≥200 words excl. code)
- [x] 4.2 `README.md` at package root linking the module doc under
  `## Modules`
- [x] 4.3 Update `CLAUDE.md` package listing under the Network or
  Foundation section — add `payment-provider-stripe` to the
  `payment-providers` family description

## 5. Pre-archive verification (the 5-gate triple)

- [x] 5.1 `bun run check` — Biome 0/0/0 across the monorepo
- [x] 5.2 `bunx turbo lint typecheck test --filter=@suaveplan/payment-provider-stripe` — green
- [x] 5.3 `bunx turbo test:coverage --filter=@suaveplan/payment-provider-stripe` — 100/100/100/100
- [x] 5.4 `bun scripts/openspec-conformance.ts @suaveplan/payment-provider-stripe` — exit 0 (PASS 0 error, 0 warn, 0 info)
- [x] 5.5 `bunx turbo build --filter=@suaveplan/payment-provider-stripe` — green

## 6. Pre-archive 9-row checklist (AGENTS.md Section 13)

- [x] 6.1 Generics threaded; literal `name: "stripe"` pinned at the type level
- [x] 6.2 Wire-format Stripe responses parsed through typed `StripeIntent` / `StripeRefund` interfaces
- [x] 6.3 Every slim-core error code raised by `httpRequest` flows through this provider with `provider: "stripe"` discriminant
- [x] 6.4 N/A — no strict-mode toggle on the provider
- [x] 6.5 N/A — no OTel instruments in this change
- [x] 6.6 N/A — provider holds no in-flight dedup state
- [x] 6.7 No retroactive tick
- [x] 6.8 No `export *` in any feature barrel — scan returns zero output
- [x] 6.9 No direct `vitest` / `bun:test` imports — scan returns zero output

## 7. Root-doc refresh (§13b)

- [x] 7.1 `bun scripts/folder-reorg/generate-manifest.ts` — `MANIFEST.md` refreshed (258 packages, 34 plugins; new row for payment-provider-stripe)
- [ ] 7.2 `bun scripts/generate-missing.ts` — DEFERRED: pre-existing failure on missing `FOLDERS.yml` (unrelated to this change)
- [x] 7.3 Added `@suaveplan/payment-provider-stripe` row to `STATUS.md`
- [x] 7.4 Added per-package paragraph to `SUMMARY.md`
- [x] 7.5 `bunx markdownlint-cli2 --fix` — exit 0; no findings in touched files

## 8. Archive

- [x] 8.1 Fold `specs/payment-provider-stripe/spec.md` into `openspec/specs/payment-provider-stripe/spec.md`
- [x] 8.2 Move `openspec/changes/add-payment-provider-stripe/` → `openspec/archive/2026-05-17-add-payment-provider-stripe/`