postcmd

type ApproveOptions struct {
	// At is the due time: RFC3339 on the hour, or a bare date that takes the
	// platform's default hour. Empty takes the article's date at that hour, or,
	// when the article has no date, is due immediately.
	At string
	// Revoke returns the outlets to draft and clears their schedule.
	Revoke bool
}

type Poster struct {
	FS   afero.Fs
	Root string // reel-workspace root (e.g. "reels")
	// Resolve constructs the publisher for a platform (nil-able adapters are an
	// error). Enabled reports `platforms.<name>.enabled`. Now is the clock.
	Resolve func(platform string) (publish.Publisher, error)
	Enabled func(platform string) bool
	// Contract reports a platform's media contract without constructing it
	// (0060 D3); nil falls back to the publish registry.
	Contract func(platform string) (publish.Accepts, bool)
	// Constraints resolves a platform's posting constraints (config-tunable, R-SOC-5);
	// nil falls back to the built-in defaults.
	Constraints func(platform social.Platform) social.Constraint
	Now         func() time.Time
	// DefaultHour is the hour of day an outlet on a platform is due when the
	// schedule names only a date, and the zone that hour is in (0060 D4); nil
	// means 09:00 UTC.
	DefaultHour func(platform social.Platform) (int, *time.Location)
	// ArticleDate is the article's own date (YYYY-MM-DD) for a bundle, "" when
	// unknown; an approve with no --at is due on that date (0060 D4). nil means
	// unknown.
	ArticleDate func(ctx context.Context, bundle string) string
	// Articles enumerates every article bundle in the project, for `publish due`
	// with no target (0060 D6). nil means the sweep is unavailable.
	Articles func(ctx context.Context) ([]string, error)
	// Hydrate pulls a reel workspace's pinned-but-missing media before its video
	// is read (spec 0039 §3.5, R-STO-7): on a fresh CI clone the rendered reel
	// lives in the object store. nil means no object store.
	Hydrate func(ctx context.Context, reelDir string) error
	// Reachable checks that a public image URL serves an image, for the
	// adapters that fetch by URL (Instagram, Threads): an undeployed cover is
	// refused before the send, so the platform never fetches a 404 and caches
	// it; a dry run only reports it. nil skips the check.
	Reachable func(ctx context.Context, url string) error
	// RequireCredentials makes a dry-run fail when the publisher cannot be
	// constructed. Off, the dry-run reports the credential as absent and passes,
	// which is what a merge-request pipeline with no secrets needs (0060 OQ2).
	RequireCredentials bool
}

type Result struct {
	Article  string `json:"article,omitempty"`
	Piece    string `json:"piece,omitempty"`
	Kind     string `json:"kind,omitempty"`
	Platform string `json:"platform"`
	Status   string `json:"status"` // posted | skipped | deferred | failed | dry-run | approved | draft
	URL      string `json:"url,omitempty"`
	Detail   string `json:"detail,omitempty"`
}

type Target = social.Target