core

type ActionMutator interface {
	// CreateAction is invoked by core__create_action.
	CreateAction(ctx context.Context, workspaceID string, caseID int64, title, description string, assigneeID string, slackMessageTS string, status types.ActionStatus, dueDate *time.Time) (*model.Action, error)
	// UpdateAction is invoked by core__update_action,
	// core__update_action_status and core__set_action_assignee. The caller
	// fills only the fields it intends to change; the implementation must
	// translate this into the full UpdateAction usecase contract (system
	// actor, full Slack sync) so tool-driven edits behave identically to
	// GraphQL / Slack-modal edits.
	UpdateAction(ctx context.Context, workspaceID string, actionID int64, params UpdateActionParams) (*model.Action, error)
	// ArchiveAction is invoked by core__archive_action.
	ArchiveAction(ctx context.Context, workspaceID string, actionID int64) (*model.Action, error)
	// UnarchiveAction is invoked by core__unarchive_action.
	UnarchiveAction(ctx context.Context, workspaceID string, actionID int64) (*model.Action, error)
}

type ActionStepMutator interface {
	List(ctx context.Context, workspaceID string, actionID int64) ([]*model.ActionStep, error)
	Add(ctx context.Context, workspaceID string, actionID int64, title string) (*model.ActionStep, error)
	SetDone(ctx context.Context, workspaceID string, actionID int64, stepID string, done bool) (*model.ActionStep, error)
	Rename(ctx context.Context, workspaceID string, actionID int64, stepID string, title string) (*model.ActionStep, error)
	Delete(ctx context.Context, workspaceID string, actionID int64, stepID string) error
}

type CaseRefReader interface {
	// ReferenceWorkspaceForField resolves the field's configured
	// reference_workspace from the current case's workspace schema, erroring
	// when fieldID is unknown or not a case_ref field.
	ReferenceWorkspaceForField(workspaceID, fieldID string) (string, error)
	// ListReferenceableCases returns non-private, non-draft candidate cases in
	// the reference workspace (picker/search summaries).
	ListReferenceableCases(ctx context.Context, workspaceID, query string, limit int) ([]model.CaseRef, error)
	// GetReferenceableCases batch-fetches full non-private, non-draft cases by
	// ID from the reference workspace.
	GetReferenceableCases(ctx context.Context, workspaceID string, ids []int64) ([]*model.Case, error)
	// RenderCaseFieldValues flattens a case's field values, resolving nested
	// case_ref values to {id,title,status} one level deep.
	RenderCaseFieldValues(ctx context.Context, workspaceID string, fieldValues map[string]model.FieldValue) (map[string]any, error)
}

type Deps struct {
	Repo        interfaces.Repository
	WorkspaceID string
	CaseID      int64
	StatusSet   *model.ActionStatusSet
	// ActionUC routes core__create_action / core__update_action /
	// core__update_action_status / core__set_action_assignee through the
	// unified usecase entry points. Required: tools fail loudly when this
	// is nil rather than silently degrade to the legacy repository-direct
	// path, which would skip Slack notifications and ActionEvent records.
	ActionUC ActionMutator
	// ActionStepUC routes the core__*_action_step tools through the unified
	// ActionStepUseCase entry points. Required for the same reason as
	// ActionUC; tools fail loudly when nil.
	ActionStepUC ActionStepMutator
	// CaseRefUC backs the case_ref read tools. nil disables them (a
	// workspace with no case_ref fields needs nothing here); the tools
	// are only built when this is wired.
	CaseRefUC CaseRefReader
}

type UpdateActionParams struct {
	Title         *string
	Description   *string
	AssigneeID    *string
	Status        *types.ActionStatus
	DueDate       *time.Time
	ClearAssignee bool
	ClearDueDate  bool
}