Function AssessSetup

config/config.go:224–269

AssessSetup inspects .codemap/config.json and reports whether it should be initialized or tuned before deeper Codemap analysis.

(root string)

// AssessSetup inspects .codemap/config.json and reports whether it should be
// initialized or tuned before deeper Codemap analysis.
func AssessSetup(root string) SetupAssessment {
	data, err := os.ReadFile(ConfigPath(root))
	if err != nil {
		if os.IsNotExist(err) {
			return SetupAssessment{
				State:   SetupStateMissing,
				Reasons: []string{"No .codemap/config.json is present yet."},
			}
		}
		return SetupAssessment{
			State:   SetupStateMalformed,
			Reasons: []string{fmt.Sprintf("Codemap could not read the config file: %v", err)},
		}
	}

	if strings.TrimSpace(string(data)) == "" {
		return SetupAssessment{
			State:   SetupStateEmpty,
			Reasons: []string{"The config file is blank and does not shape Codemap output yet."},
		}
	}

	var cfg ProjectConfig
	if err := json.Unmarshal(data, &cfg); err != nil {
		return SetupAssessment{
			State:   SetupStateMalformed,
			Reasons: []string{"The existing .codemap/config.json is malformed JSON."},
		}
	}

	if cfg.IsZero() {
		return SetupAssessment{
			State:   SetupStateEmpty,
			Reasons: []string{"The config exists but does not shape Codemap output yet."},
		}
	}

	if cfg.LooksBoilerplate() {
		return SetupAssessment{
			State:   SetupStateBoilerplate,
			Reasons: []string{"The config only contains generic bootstrap filters and should be tuned for this repo."},
		}
	}

	return SetupAssessment{State: SetupStateReady}
}