softdelete

type Option func(*Reconciler)

type Provisioner interface {
	// DeleteOrgWorkspace removes the kcp Workspace at
	// root:railgrid:orgs:{orgUUID}. Idempotent on NotFound.
	DeleteOrgWorkspace(ctx context.Context, orgUUID string) error

	// DeleteChildWorkspace removes the kcp Workspace at
	// root:railgrid:orgs:{orgUUID}:{wsUUID}. Idempotent on NotFound.
	// It reports true when the Workspace was live and this call asked kcp
	// to delete it, false when it was already terminating or gone, so a
	// sweep that finds a workspace still held by its finalizers does not
	// treat it as a fresh change.
	DeleteChildWorkspace(ctx context.Context, orgUUID, wsUUID string) (deleted bool, err error)

	// ListChildWorkspaces returns the names of every child Workspace
	// inside the Org workspace at root:railgrid:orgs:{orgUUID}. Empty if
	// the parent Org workspace has been deleted.
	ListChildWorkspaces(ctx context.Context, orgUUID string) ([]string, error)

	// ListOrgWorkspaces returns the names (UUIDs) of every
	// Organization workspace at root:railgrid:orgs. Drives the
	// Workspace-branch poll sweep.
	ListOrgWorkspaces(ctx context.Context) ([]string, error)

	// GetWorkspaceDeletionRequestedAt reads the
	// tenants.railgrid.ai/deletion-requested-at annotation from the
	// child Workspace. The second return reports presence — callers
	// can distinguish "no soft-delete requested" from "annotation
	// present but malformed".
	GetWorkspaceDeletionRequestedAt(ctx context.Context, orgUUID, wsUUID string) (*time.Time, bool, error)

	// GetWorkspaceDeletionForced reports whether the child Workspace
	// carries tenants.railgrid.ai/deletion-forced: its admin asked for
	// deletion without the recovery window, so the cascade runs on the
	// next sweep however much of the grace period is left.
	GetWorkspaceDeletionForced(ctx context.Context, orgUUID, wsUUID string) (bool, error)

	// DeleteOrgMemberships removes every Membership CR inside the
	// Organization workspace. Run during Org cascade so UMI strips
	// see a clean delta.
	DeleteOrgMemberships(ctx context.Context, orgUUID string) error

	// ListOrgMemberships returns the user names (Membership.name) of
	// every Membership in the Organization workspace. Used inside the
	// grace window to mark every member's UMI rows, and during cascade
	// to know which UMIs to strip.
	ListOrgMemberships(ctx context.Context, orgUUID string) ([]string, error)
}

type Reconciler struct {
	// contains filtered or unexported fields
}

type WorkspaceWatcher interface {
	// WatchChildWorkspaces opens a watch on the child Workspaces of
	// root:railgrid:tenants:{orgUUID}. The watch replays every existing
	// Workspace as ADDED when it opens, which is how a restart catches up.
	WatchChildWorkspaces(ctx context.Context, orgUUID string) (watch.Interface, error)
}