internal

type ConfigHelperContext struct {
	CWD string

	ProjectConfPath string // project configuration file path
	GlobalConfPath  string // global configuration file path
}

type IConfigHelper interface {
	// Context returns the context of configuration helper.
	Context() *ConfigHelperContext

	Config(typ types.ConfigType) types.ConfigHolder

	SaveTo(configType types.ConfigType) string
}

type IDash interface {
	// FeatureDetail get feature detail
	FeatureDetail(featureBranchName string) ([]byte, error)

	// MilestoneOverview get milestone detail
	MilestoneOverview(milestoneName, branchFilter string) ([]byte, error)

	// ProjectDetail display project detail， includes: project web URL
	ProjectDetail(module string) ([]byte, error)
}

type IFeature interface {
	// FeatureBegin open a milestone and related to a feature branch,
	// then CLI would automate fetch origin branches and pull them to local.
	// Of course, flow would save data in local storage.
	FeatureBegin(opc *types.OpFeatureContext, title, desc string) error
	// FeatureDebugging open a MergeRequest of feature branch and types.DevBranch branch.
	FeatureDebugging(opc *types.OpFeatureContext) error
	// FeatureTest open a MergeRequest of feature branch and types.TestBranch branch.
	FeatureTest(opc *types.OpFeatureContext) error
	// FeatureRelease open a MergeRequest of feature branch and types.MasterBranch branch.
	FeatureRelease(opc *types.OpFeatureContext) error

	// FeatureResolveConflict will check out a new branch from the target branch,
	// then create a merge request from the current feature branch to the new branch.
	// newBranch = "resolve-conflict/featureBranchName-to-master"
	FeatureResolveConflict(opc *types.OpFeatureContext, targetBranch types.BranchTyp) error

	// FeatureBeginIssue checkout an issue branch from feature branch, also open a merge request
	// which is from issue branch to feature branch.
	FeatureBeginIssue(opc *types.OpFeatureContext, title, desc string) error
	// FeatureFinishIssue open the WebURL of merge request which is from issue branch to feature branch.
	FeatureFinishIssue(opc *types.OpFeatureContext, issueBranchName string) error

	// Checkout to branch related to current feature, feature branch or issue branches.
	// Default is to check out the feature branch. It would list all branches if --list is set.
	// It would interact with user to choose which branch to check out if --issue is set.
	Checkout(opc *types.OpFeatureContext, listAll bool, issueID int)
}

type IFlow interface {
	IFeature
	IHotfix
	ISync
}

type IHotfix interface {
	// HotfixBegin checkout a hotfix branch from types.MasterBranch, also open a merge request
	// which is from hotfix branch to types.MasterBranch.
	HotfixBegin(opc *types.OpHotfixContext, title, desc string) error
	// HotfixFinish open the WebURL of merge request which is from hotfix branch to types.MasterBranch.
	HotfixFinish(opc *types.OpHotfixContext, hotfixBranchName string) error
}

type ISync interface {
	// SyncProject synchronize project information from remote gitlab server.
	SyncProject(isDelete bool) error
	// SyncMilestone synchronize remote repository milestone and related issues / merge requests to local.
	SyncMilestone(milestoneID int, interact bool) error
}