project

type AlternativeMethodology struct {
	Mode    string // "ddd" or "tdd".
	Reason  string // Why this is an alternative.
	Warning string // Warning message if chosen despite recommendation.
}

type ConsoleReporter struct{}

type Detector interface {
	// DetectLanguages scans the project root and returns detected languages
	// sorted by confidence descending.
	DetectLanguages(root string) ([]Language, error)

	// DetectFrameworks scans for known framework configuration files.
	DetectFrameworks(root string) ([]Framework, error)

	// DetectProjectType classifies the project based on structure and files.
	DetectProjectType(root string) (models.ProjectType, error)
}

type Framework struct {
	Name       string // Human-readable framework name (e.g., "React", "Gin").
	Version    string // Detected version string, may be empty.
	ConfigFile string // Config file where the framework was detected.
}

type InitOptions struct {
	ProjectRoot       string   // Absolute or relative path to the project root.
	ProjectName       string   // Name of the project.
	Language          string   // Primary programming language.
	Framework         string   // Framework name, or "none".
	Features          []string // Selected features (e.g., "LSP", "Quality Gates").
	UserName          string   // User display name for configuration.
	ConvLang          string   // Conversation language code (e.g., "en", "ko").
	DevelopmentMode   string   // "ddd" or "tdd".
	GitMode           string   // Git workflow mode: "manual", "personal", or "team".
	GitProvider       string   // Git provider: "github", "gitlab".
	GitHubUsername    string   // GitHub username (for personal/team modes).
	GitLabInstanceURL string   // GitLab instance URL (for self-hosted instances).
	GitCommitLang     string   // Git commit message language code.
	CodeCommentLang   string   // Code comment language code.
	DocLang           string   // Documentation language code.
	Platform          string   // Target platform ("darwin", "linux", "windows"). Defaults to runtime.GOOS.
	NonInteractive    bool     // If true, skip wizard and use defaults/flags.
	Force             bool     // If true, allow reinitializing an existing project.
	SkipShellConfig   bool     // If true, skip shell environment configuration.
	ModelPolicy       string   // Token consumption tier: "high", "medium", "low".
	CommitScopes      string   // 커밋 scope 목록 (쉼표 구분)
}

type InitResult struct {
	CreatedDirs     []string // Directories that were created.
	CreatedFiles    []string // Files that were created.
	DevelopmentMode string   // Selected development methodology.
	BackupPath      string   // Non-empty if --force was used and backup was created.
	Warnings        []string // Non-fatal warnings during initialization.
	ShellConfigured bool     // Whether shell environment was configured.
	ShellConfigFile string   // Path to the shell config file that was modified.
}

type Initializer interface {
	// Init creates a new AE project with the given options.
	Init(ctx context.Context, opts InitOptions) (*InitResult, error)
}

type Language struct {
	Name       string  // Human-readable language name (e.g., "Go", "Python").
	Confidence float64 // 0.0–1.0 ratio based on file count.
	FileCount  int     // Number of source files for this language.
}

type MethodologyDetector interface {
	// DetectMethodology analyzes test coverage and recommends a development mode.
	DetectMethodology(root string, languages []Language) (*MethodologyRecommendation, error)
}

type MethodologyRecommendation struct {
	Recommended      string                   // "ddd" or "tdd".
	Confidence       float64                  // 0.0–1.0.
	Rationale        string                   // Human-readable explanation.
	ProjectType      string                   // "greenfield" or "brownfield".
	TestFileCount    int                      // Number of test files found.
	CodeFileCount    int                      // Number of source code files found.
	CoverageEstimate float64                  // Estimated coverage percentage (0–100).
	Alternatives     []AlternativeMethodology // Non-recommended but available options.
}

type NoOpReporter struct{}

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

type ProgressReporter interface {
	// StepStart indicates the beginning of a step.
	StepStart(name, message string)

	// StepUpdate provides a status update for the current step.
	StepUpdate(message string)

	// StepComplete marks the current step as successfully completed.
	StepComplete(message string)

	// StepError marks the current step as failed with an error.
	StepError(err error)
}

type ProjectValidator interface {
	// Validate checks the overall project structure.
	Validate(root string) (*ValidationResult, error)

	// ValidateAE checks AE-specific configuration and file integrity.
	ValidateAE(root string) (*ValidationResult, error)
}

type ValidationResult struct {
	Valid    bool     // True if no errors found.
	Errors   []string // Critical issues that prevent operation.
	Warnings []string // Non-critical issues.
}