refactor(cli/checkers): package-level configPath DIP violation and guard pattern DRY

[hrygo]

Background

internal/cli/checkers 实现 hotplex doctor 诊断检查器注册表，包含 12+ 个 Checker 实现（配置、依赖、消息、安全、运行时）。模块约 700 行，7 个源文件。此次分析为首次 SOLID/DRY/coupling 审计。

Scope: SOLID, DRY, coupling — cycle 146
Key files: config.go, dependencies.go, runtime.go, messaging.go, stt.go, tts.go, security.go

---

Finding Summary

Category	Critical	High	Medium	Low
SOLID (DIP)	0	0	1	0
DRY	0	0	1	0
合计	0	0	2	0

---

Findings

configpath-package-level-dip-violation

Severity: Medium | Confidence: High | ROI: Medium
Location: config.go:17, config.go:20-22, config.go:31,108,147,211, messaging.go:112, stt.go:90, tts.go:107, security.go:70

Problem: 所有配置感知检查器依赖可变包级变量 var configPath string 而非构造函数注入。违反 DIP — 高层诊断逻辑依赖具体全局状态。测试文件明确注释无法使用 t.Parallel。

Current Pattern:

// config.go:17 — shared mutable state
var configPath string

func SetConfigPath(p string) { configPath = p }

// config.go:31 — every checker copies this guard
func (c configLoadedChecker) Check() cli.Diagnostic {
    if configPath == "" {
        return cli.Diagnostic{Status: cli.StatusFail, Message: "Config path not set"}
    }
    cfg, err := config.Load(configPath)
    if err != nil {
        return cli.Diagnostic{Status: cli.StatusFail, Message: err.Error()}
    }
    // ... actual check logic
}

Proposed Fix:

type configLoadedChecker struct {
    configPath string
}

func NewConfigLoadedChecker(path string) *configLoadedChecker {
    return &configLoadedChecker{configPath: path}
}

func (c *configLoadedChecker) Check() cli.Diagnostic {
    cfg, diag, ok := loadConfig(c.configPath)
    if !ok { return diag }
    // ... actual check logic
}

Estimated Impact: 消除共享可变状态，启用 t.Parallel()，减少新检查器样板代码

---

configpath-guard-load-dry-repetition

Severity: Medium | Confidence: High | ROI: Medium
Location: config.go:31,108,147,211, messaging.go:112,121, tts.go:107,110, stt.go:90,93, security.go:70,121

Problem: if configPath == "" 守卫 + config.Load(configPath) + 错误处理模式在 6 个文件中重复 16 次。每个新的配置感知检查器必须复制相同的 8 行样板代码。

Current Pattern:

// Repeated in ~16 locations across 6 files:
if configPath == "" {
    return cli.Diagnostic{Status: cli.StatusFail, Message: "Config path not set"}
}
cfg, err := config.Load(configPath)
if err != nil {
    return cli.Diagnostic{Status: cli.StatusFail, Message: "Cannot load config: " + err.Error()}
}

Proposed Fix:

func loadConfig(path string) (*config.Config, cli.Diagnostic, bool) {
    if path == "" {
        return nil, cli.Diagnostic{Status: cli.StatusFail, Message: "Config path not set"}, false
    }
    cfg, err := config.Load(path)
    if err != nil {
        return nil, cli.Diagnostic{Status: cli.StatusFail, Message: "Cannot load config: " + err.Error()}, false
    }
    return cfg, cli.Diagnostic{}, true
}

Estimated Impact: ~120 行减少，消除新检查器组装错误风险

Acceptance Criteria:

• 提取 loadConfig(path string) (*config.Config, cli.Diagnostic, bool) 辅助函数
• 所有配置感知检查器通过结构体字段接收 configPath（或通过 loadConfig 辅助函数）
• 测试可以使用 t.Parallel() 运行，无共享状态冲突
• make test 通过，所有 checkers_test.go 零回归
• hotplex doctor CLI 行为不变

---

Implementation Priority

Finding	Priority	Effort	Risk	Impact
configpath-package-level-dip-violation	P2	Medium	Low	消除共享可变状态，启用并行测试
configpath-guard-load-dry-repetition	P2	Small	Low	~120 行减少，降低新检查器错误率

Recommended starting point: 同时修复 — F1 的构造函数注入自然消除 F2 的重复

---

Out of Scope

• sqlitePathChecker/dataDirWritableChecker 可写目录检查重复：Low 严重性，仅 2 实例
• configRequiredChecker 中 var missing []string 死代码：逻辑 bug，非架构问题
• checkPythonPackages/checkMossPythonPackages 相似模式：不同导入列表，提取收益低

---

Verification

• make test 通过，无回归
• make lint 不产生新警告
• hotplex doctor 输出与修改前一致
• TestConfig* 测试可并行运行

[hrygo]

arch-audit (2026-05-28, cycle 175): 确认 2/2 项发现有效。包级 configPath 变量和 6 文件 16 处 guard+Load 重复未提取共享 helper。

[hrygo]

arch-analysis (cycle 190, concurrency): 补充发现。

configPath 无同步保护（并发角度）

Severity: Medium | Confidence: High
Location: config.go:17-22

问题: 此发现与已有的 configpath-package-level-dip-violation 发现共享同一代码但角度不同。DIP 发现关注的是架构设计（依赖全局状态）；本发现关注的是并发安全 — CheckerRegistry 使用 sync.RWMutex 保证线程安全，但其中检查器依赖的 configPath 却无任何同步保护。如果检查器被并行运行（如 HTTP 诊断端点），会产生数据竞争。

建议修复与 DIP 发现一致: 将 configPath 注入到每个 checker 结构体中（与 sqlitePathChecker 和 orphanPIDsChecker 的模式一致），或使用 atomic.Pointer[string]。

冗余 config.Load 调用

Severity: Medium | Confidence: High
Location: config.go:117,156,220; messaging.go:121; security.go:70,121; stt.go:93; tts.go:110

问题: 每次 doctor 运行中，9 个检查器各自独立调用 config.Load(configPath) 加载同一 YAML 文件。浪费 8 次文件读取 + Viper 解析。如果未来并行化检查器，并发 config.Load 调用可能冲突。

建议: 在 doctor 命令中加载配置一次，将解析后的 *config.Config 传递给每个检查器。