feat(payments): EN-123 connector schedules CLI

[thierrycoopman]

Summary

• Add fctl payments connectors schedules {list,get} wired to Payments v3 schedule endpoints
• Add fctl payments connectors schedules instances list for schedule instance pagination
• V3-only; uses existing formance-sdk-go/v3 v3.8.1 SDK methods (no SDK bump)

Test plan

• go build ./... and go vet ./... pass
• gofmt -l . clean
• Help screens list new commands under fctl payments connectors
• List/get/instances work against a v3 stack with --output json
• Pre-v3 stack returns clear version-gate error

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 26d9fcb8-9589-4c8b-bed6-7b0516de468e

📥 Commits

Reviewing files that changed from the base of the PR and between 1586c78 and 13d64c1.

📒 Files selected for processing (6)

• cmd/payments/connectors/root.go
• cmd/payments/connectors/schedules/instances/list.go
• cmd/payments/connectors/schedules/instances/root.go
• cmd/payments/connectors/schedules/list.go
• cmd/payments/connectors/schedules/root.go
• cmd/payments/connectors/schedules/show.go

✅ Files skipped from review due to trivial changes (1)

• cmd/payments/connectors/root.go

🚧 Files skipped from review as they are similar to previous changes (4)

• cmd/payments/connectors/schedules/root.go
• cmd/payments/connectors/schedules/instances/root.go
• cmd/payments/connectors/schedules/list.go
• cmd/payments/connectors/schedules/instances/list.go

---

Walkthrough

Adds CLI commands under payments connectors for schedules and schedule instances: root wiring, list and show commands, API v3 enforcement, cursor-based pagination stores, and table rendering of schedules and instances.

Changes

Connector schedules and instances CLI commands

Layer / File(s)	Summary
Command hierarchy and root wiring cmd/payments/connectors/root.go, cmd/payments/connectors/schedules/root.go, cmd/payments/connectors/schedules/instances/root.go	Schedules subcommand is registered under connectors root; schedules root defines list, show, and instances subcommands; instances root wires list as a child.
List schedules command and flow cmd/payments/connectors/schedules/list.go	list <connectorID> command with cursor/page-size flags, enforces Payments API >= v3, calls V3.ListConnectorSchedules, validates cursor response, stores cursor in ListStore, and renders schedule rows plus cursor metadata (table shows ID and CreatedAt).
Show schedule command and flow cmd/payments/connectors/schedules/show.go	get <connectorID> <scheduleID> command enforces Payments API >= v3, calls V3.GetConnectorSchedule, validates presence, stores result in ShowStore, and renders schedule details with RFC3339 timestamps and optional paused fields.
List schedule instances command and flow cmd/payments/connectors/schedules/instances/list.go	list <connectorID> <scheduleID> for instances with cursor/page-size flags, enforces Payments API >= v3, calls V3.ListConnectorScheduleInstances, validates cursor response, stores cursor in ListStore, and renders instances with created/updated/terminated timestamps and per-instance error text.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

A rabbit hopped in the CLI wood,
Wove "schedules" where connectors stood,
Lists and shows now page with grace,
Instances leap, each time-stamped place,
Cursor in paw, I bound through the code! 🐇

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly describes the main change: adding connector schedules CLI commands to the payments module.
Description check	✅ Passed	The description is directly related to the changeset, detailing the new CLI commands, version requirements, and test coverage.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/en-123-connector-schedules

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 golangci-lint (2.12.2)

level=error msg="[linters_context] typechecking error: pattern ./...: directory prefix . does not contain main module or its selected dependencies"

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[thierrycoopman]

@laouji can you re-check?