constants

const (
	// Default buffer size for reading/writing operations (64 KB)
	DefaultBufferSize = 64 * 1024

	// Maximum scanner buffer size (1 MB)
	MaxScannerBuffer = 1024 * 1024
)

const (
	// Root is the name of the CLI application
	Root = "divekit"

	// DivekitHomeEnvVar is the environment variable used to specify the divekit home directory
	DivekitHomeEnvVar = "DIVEKIT_HOME"

	// DivekitFolder is the name of the divekit configuration directory
	DivekitFolder = ".divekit"
	// DistributionsFolder is the directory containing all distributions
	DistributionsFolder = "distributions"
	// TempIndividualizedFolder is the temporary directory for individualized content
	TempIndividualizedFolder = ".tmp-individualized"
	// DivekitConfigDir is the divekit configuration directory name
	DivekitConfigDir = ".divekit"

	// ConfigFile is the name of the main configuration file
	ConfigFile = "config.json"
	// DivekitConfigName is the name of the divekit-specific configuration file
	DivekitConfigName = "divekit-config.json"
	// VariationConfigFile is the name of the variation configuration file
	VariationConfigFile = "variation.json"
	// IndividualizationConfigFile is the name of the individualization configuration file
	IndividualizationConfigFile = "individualization.json"
	// IndividualsFile is the name of the individuals configuration file
	IndividualsFile = "individuals.json"
	// RemotesConfigFile is the name of the remotes configuration file
	RemotesConfigFile = "remotes.json"
	// LicenseFile is the name of the license file
	LicenseFile = "LICENSE"
	// ReadmeFile is the name of the readme file
	ReadmeFile = "README.md"
	// MembersFile is the name of the members configuration file
	MembersFile = "members.json"
	// IndexDbFile is the name of the index database file
	IndexDbFile = "index.db"
	// GitLabCIFileName is the standard GitLab CI file in the repository root.
	GitLabCIFileName = ".gitlab-ci.yml"

	// DefaultBranch is the default git branch name for new projects
	DefaultBranch = "main"
	// DefaultAuthorName is the default author name for commits
	DefaultAuthorName = "Divekit"
	// DefaultAuthorEmail is the default author email for commits
	DefaultAuthorEmail = "divekit@git.nrw"
	// DefaultPermissions is the default permissions for project members
	DefaultPermissions = "reporter"

	// DefaultTargetName is the canonical name of the primary work target.
	DefaultTargetName = "work"
	// LegacyDefaultTargetName is the historic primary target alias kept for backward compatibility.
	LegacyDefaultTargetName = "main"
	// LegacyCodeTargetAlias is the older user-facing alias for the primary work target.
	LegacyCodeTargetAlias = "code"

	// EvaluationTargetName is the canonical name of the evaluation target.
	EvaluationTargetName = "eval"
	// LegacyEvaluationTargetAlias is the historic evaluation target name kept for backward compatibility.
	LegacyEvaluationTargetAlias = "sandbox"
	// LegacyTestTargetName is the historic evaluation target alias kept for backward compatibility.
	LegacyTestTargetName = "test"
	// EvaluationPipelineDisplayName is the preferred singular label for the evaluation feature.
	EvaluationPipelineDisplayName = "Evaluation Pipeline"
	// EvaluationPipelineDisplayPluralName is the preferred plural label for the evaluation feature.
	EvaluationPipelineDisplayPluralName = "Evaluation Pipelines"
	// LegacyEvaluationPipelineConfigKey is the legacy persisted config key kept for backward compatibility.
	LegacyEvaluationPipelineConfigKey = "securePipeline"
	// EvaluationPipelineConfigKey is the canonical persisted config key.
	EvaluationPipelineConfigKey = "evaluationPipeline"

	// GroupLayoutModeLegacy keeps the legacy evaluation pipeline fallback behavior.
	GroupLayoutModeLegacy = "legacy"
	// GroupLayoutModeDistributionSubgroups creates per-distribution work/eval subgroups.
	GroupLayoutModeDistributionSubgroups = "distribution-subgroups"
	// DistributionStudentSubgroupName is the canonical subgroup for primary work repositories.
	DistributionStudentSubgroupName = "work"
	// LegacyDistributionMainSubgroupName is the historic subgroup name for primary repositories.
	LegacyDistributionMainSubgroupName = "main"
	// LegacyDistributionStudentSubgroupName is the older subgroup name for primary repositories.
	LegacyDistributionStudentSubgroupName = "student"
	// DistributionEvalSubgroupName is the canonical subgroup for evaluation repositories.
	DistributionEvalSubgroupName = "eval"

	// EvalSubgroupName is the canonical subgroup name created for evaluation fallback.
	EvalSubgroupName = "eval"

	// EvaluationPipelineDirName is the canonical directory for evaluation pipeline assets.
	EvaluationPipelineDirName = "evaluation-pipeline"
	// LegacyEvaluationPipelineDirName is the legacy directory retained for backward compatibility.
	LegacyEvaluationPipelineDirName = "secure-pipeline"
	// MainCIFileName is the canonical CI override file for work repositories.
	MainCIFileName = ".gitlab-ci_workrepo.yml"
	// LegacyMainCIFileName is the legacy CI override file retained for backward compatibility.
	LegacyMainCIFileName = ".gitlab-ci_mainrepo.yml"
	// EvaluationCIFileName is the canonical CI file for eval repositories.
	EvaluationCIFileName = ".gitlab-ci_evalrepo.yml"
	// LegacyEvaluationCIFileName is the legacy CI file retained for backward compatibility.
	LegacyEvaluationCIFileName = ".gitlab-ci_sandboxrepo.yml"
	// EvaluationSetupScriptName is the legacy eval setup override file retained for backward compatibility.
	EvaluationSetupScriptName = "setup-eval.sh"
	// LegacyEvaluationSetupScriptName is the older eval setup override file retained for backward compatibility.
	LegacyEvaluationSetupScriptName = "setup-sandbox.sh"
	// EvaluationSetupTargetFileName is the canonical setup script path inside eval repositories.
	EvaluationSetupTargetFileName = "setup.sh"
	// EvaluationSetupOverrideFileName is the canonical authoring-time setup override in the origin root.
	EvaluationSetupOverrideFileName = "setup_evalrepo.sh"
	// EvaluationPluginsConfigFile is the canonical plugin state file stored under .divekit.
	EvaluationPluginsConfigFile = "eval-plugins.json"
	// EvaluationPluginManagedOriginDir is the canonical origin path for eval-only managed plugin child pipelines.
	EvaluationPluginManagedOriginDir = ".gitlab_evalrepo/eval-plugins"
	// EvaluationPluginManagedTargetDir is the canonical eval-repo path for managed plugin child pipelines.
	EvaluationPluginManagedTargetDir = ".gitlab/eval-plugins"

	// FilePreIdentifierDefault is the default prefix used for target-scoped file markers.
	FilePreIdentifierDefault = "_"
	// FilePostIdentifierDefault is the default suffix used for target-scoped file markers.
	FilePostIdentifierDefault = "repo"
	// NoRepoIdentifierDefault is the default target marker used to exclude files from all repos.
	NoRepoIdentifierDefault = "no"

	// MainTargetNameWrapper defines how the work target derives its name from the base pattern.
	// {{base}} will be replaced with the main/base name pattern from config (e.g., "ST2-{{uuid}}").
	MainTargetNameWrapper = "{{base}}"

	// NonMainTargetNameWrapper defines how non-work targets derive their name from the base pattern.
	// {{base}} will be replaced with the work/base name pattern (e.g., "ST2-{{uuid}}").
	// {{target}} will be replaced with the user-facing target token (e.g., "eval").
	NonMainTargetNameWrapper = "{{base}}_{{target}}"

	// TimeFormat is the standard time format used throughout the application
	TimeFormat = "2006-01-02 15:04"

	// InitialCommitMsg is the default commit message for the initial commit
	InitialCommitMsg = "Initial commit"
	// PatchCommitMsgTemplate is the template for patch commit messages
	PatchCommitMsgTemplate = "Patch applied on %s"

	// DryRunDelayShort is the delay for quick operations like reads/gets
	DryRunDelayShort = 50 * time.Millisecond // For quick reads/gets
	// DryRunDelayMid is the delay for medium operations like creations and assignments
	DryRunDelayMid = 150 * time.Millisecond // For creations, assignments, simple writes
	// DryRunDelayLong is the delay for complex operations like large commits
	DryRunDelayLong = 500 * time.Millisecond // For potentially complex operations like large commits

	// DryRunFakeProjectIDStart defines the starting ID for fake projects in dry runs
	DryRunFakeProjectIDStart = 9000

	// DryRunFakeUserIDStart defines the starting ID for fake users in dry runs
	DryRunFakeUserIDStart = 8000

	// DryRunFakeGroupPrefix defines the prefix for fake group paths in dry runs
	DryRunFakeGroupPrefix = "divekit-dry-run"

	// LocalDataProviderDirName defines the directory name for local data provider files
	LocalDataProviderDirName = "local-data"

	// MaxUploadRetries is the maximum number of retries for upload operations
	MaxUploadRetries = 3 // Maximum number of retries for upload operations
	// MaxLockRetries is the maximum number of retries for lock acquisition
	MaxLockRetries = 5 // Maximum number of retries for lock acquisition
	// UploadRetryDelay is the time to wait between upload retries
	UploadRetryDelay = 500 * time.Millisecond // Time to wait between upload retries
	// LockAcquisitionDelay is the time to wait between lock acquisition attempts
	LockAcquisitionDelay = 100 * time.Millisecond // Time to wait between lock acquisition attempts

	// StandardRateLimitDelay defines a small default pause between API requests
	StandardRateLimitDelay = 100 * time.Millisecond

	// OverviewDefaultWorkers is the default number of concurrent API workers for overview
	OverviewDefaultWorkers = 10 // Default number of concurrent API workers for overview

	// RunDefaultWorkers is the default number of concurrent workers for `divekit run`
	RunDefaultWorkers = 4 // Default number of concurrent workers for `divekit run`

)

const (
	// DefaultDirPermission is the standard permission for created directories (rwxr-xr-x)
	DefaultDirPermission = 0o755
	// DefaultFilePermission is the standard permission for created files (rw-r--r--)
	DefaultFilePermission = 0o644
	// ConfigFilePermission is the secure permission for config files (rw-------), owner-only access
	ConfigFilePermission = 0o600
	// HomePrivatePermission is the permission for private home directories (rwx------), owner-only access
	HomePrivatePermission = 0o700
	// LogDirPermission is the permission for log directories (rwxr-x---), group-readable
	LogDirPermission = 0o750
)

const (
	// GitLabPageSize is the page size for GitLab API pagination
	GitLabPageSize = 100
	// DefaultHTTPPort is the default HTTP port for local services
	DefaultHTTPPort = 8080
	// DefaultHTTPTimeout is the timeout for HTTP requests to avoid indefinite hangs.
	// Set to 5 minutes to accommodate large commits with many files (e.g., 150+ files per project)
	DefaultHTTPTimeout = 5 * time.Minute
)

const (
	CacheFolder = ".cache"
	ReposFolder = "repos"
)

const (
	// Text input and textarea dimensions
	TextInputCharLimit = 150
	TextareaWidth      = 100
	TextareaHeight     = 8

	// Progress bar and display
	ProgressBarWidth    = 40
	ProgressBarMaxWidth = 15
	LineNumberWidth     = 3

	// Output formatting
	DividerWidth = 50

	// Display limits
	MaxExamplesPerToken     = 12
	ContextLinesToShow      = 3
	UnresolvedMatchesToShow = 5
)

const (
	// DefaultQueueSize is the default queue capacity for worker pools
	DefaultQueueSize = 100
	// DistributionQueueSize is the queue size for distribution operations
	DistributionQueueSize = 200
	// PatchQueueSize is the queue size for patch operations
	PatchQueueSize = 150
	// FetchQueueSize is the queue size for fetch operations
	FetchQueueSize = 64
	// IndexingQueueSize is the queue size for indexing operations
	IndexingQueueSize = 500
	// AggressiveQueueSize is the maximum queue size for aggressive operations
	AggressiveQueueSize = 512
)

const (
	// DefaultTaskTimeout is the default timeout for individual tasks
	DefaultTaskTimeout = 5 * time.Minute
	// DistributionTaskTimeout is the task timeout for distribution operations
	DistributionTaskTimeout = 10 * time.Minute
	// PatchTaskTimeout is the task timeout for patch operations
	PatchTaskTimeout = 3 * time.Minute
	// FetchTaskTimeout is the task timeout for fetch operations
	FetchTaskTimeout = 20 * time.Minute
	// IndexingTaskTimeout is the task timeout for indexing operations
	IndexingTaskTimeout = 2 * time.Minute
	// AggressiveTaskTimeout is the task timeout for aggressive operations
	AggressiveTaskTimeout = 15 * time.Minute
)

const (
	// DefaultMaxRetries is the default maximum number of retries
	DefaultMaxRetries = 3
	// DefaultInitialBackoff is the default initial backoff duration
	DefaultInitialBackoff = 100 * time.Millisecond
	// DefaultMaxBackoff is the default maximum backoff duration
	DefaultMaxBackoff = 30 * time.Second
	// DefaultBackoffMultiplier is the default backoff multiplier
	DefaultBackoffMultiplier = 2.0
	// DefaultJitterFraction is the default jitter fraction for backoff calculation
	DefaultJitterFraction = 0.1
)

const (
	// PatchRetryMaxAttempts is the maximum number of retry attempts for patch operations
	PatchRetryMaxAttempts = 2
	// PatchRetryInitialBackoff is the initial backoff for patch retries
	PatchRetryInitialBackoff = 50 * time.Millisecond
	// PatchRetryMaxBackoff is the maximum backoff for patch retries
	PatchRetryMaxBackoff = 10 * time.Second
)

const (
	// WorkerCountMultiplier is the multiplier for CPU-core-based worker count calculation
	WorkerCountMultiplier = 2
	// IndexingWorkerMultiplier is the multiplier for indexing worker count
	IndexingWorkerMultiplier = 4
	// MinWorkerCount is the absolute minimum number of workers allowed
	MinWorkerCount = 2
	// MaxWorkerCount is the absolute maximum number of workers allowed
	MaxWorkerCount = 64
	// DistributionWorkerCount is the fixed worker count for distribution operations.
	// Limited to 2 to avoid overwhelming GitLab's Gitaly with concurrent large commits.
	DistributionWorkerCount = 2
)

const (
	// AggressiveRetryMaxAttempts is the maximum retry attempts for aggressive operations
	AggressiveRetryMaxAttempts = 5
	// ConservativeRateLimit is the conservative rate limit value
	ConservativeRateLimit = 5
	// FetchRateLimit is the rate limit for fetch operations
	FetchRateLimit = 10
	// DistributionRateLimit is the rate limit for distribution operations (tasks per second).
	// Reduced from 8 to 2 to avoid overwhelming GitLab's Gitaly with large commits (177+ files).
	// This prevents "Deadline Exceeded" errors on local and smaller GitLab instances.
	DistributionRateLimit = 2
)

const (
	// LinkingWorkerCount is the number of parallel workers for repository linking.
	// Conservative to avoid overwhelming GitLab with concurrent API requests.
	LinkingWorkerCount = 4
	// LinkingQueueSize is the queue size for linking operations
	LinkingQueueSize = 100
	// LinkingTaskTimeout is the timeout for individual linking tasks
	LinkingTaskTimeout = 5 * time.Minute
	// LinkingRateLimit is the rate limit for linking operations (requests per second).
	// Very conservative (3 req/sec) because linking involves multiple API calls per task:
	// GetProject, CreateProjectAccessToken, SetProjectVariable, CreatePipelineTriggerToken, etc.
	LinkingRateLimit = 3
)

const DefaultUserTokenFallback = "owner"

const (
	DocsURL = "https://gitlab.git.nrw/divekit/divekit-cli/-/tree/main/docs"
)