refactor(service): windowsManager dead CommandRunner field + LogDir/logDirForHome DRY

[hrygo]

Background

internal/service 是跨平台系统服务管理模块（~600 LOC），通过 build tags 隔离 Linux/macOS/Windows 实现，导出 Manager 接口供 cmd/hotplex 调用。模块整体结构良好 — 平台隔离清晰，接口设计合理。

Scope: solid, dry, coupling — cycle 165 (模块分析通过 1)
Key files: service.go, manager_windows.go, templates.go

---

Finding Summary

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

---

Findings

SOLID

windows-manager-unused-command-runner

Severity: Medium | Confidence: High | ROI: High
Location: manager_windows.go:16-18, manager_windows.go:21

Problem: windowsManager 声明了 run CommandRunner 字段并在 NewManager() 中初始化，但从未使用。所有方法直接通过 mgr 包调用 Windows SCM API。该字段是误导性的死代码 — 让读者误以为结构体通过 CommandRunner 注入是可测试的。

Current Pattern:

type windowsManager struct {
	run CommandRunner  // never accessed
}

func NewManager() Manager {
	return &windowsManager{run: realRunner{}}
}

Proposed Fix:

type windowsManager struct{}

func NewManager() Manager {
	return &windowsManager{}
}

// If testability is desired later, inject an scmConnector interface:
// type scmConnector interface {
//     Connect() (*mgr.Mgr, error)
// }

Acceptance Criteria:

• 移除 windowsManager.run 字段和初始化
• 确认 Windows 构建仍然通过 (GOOS=windows go build ./...)
• make test 通过

---

DRY

logdir-vs-logdirforhome-duplication

Severity: Medium | Confidence: High | ROI: Medium
Location: service.go:97-103, templates.go:107-126

Problem: LogDir() 和 logDirForHome() 计算相同的路径逻辑（system 级别返回 systemLogDir()，user 级别返回 ~/.hotplex/logs），但作为独立函数存在。logDirForHome 仅为避免在 BuildLaunchdPlist 中重复调用 os.UserHomeDir() 而存在。

Current Pattern:

// service.go:97
func LogDir(level Level) string {
	if level == LevelSystem { return systemLogDir() }
	home, _ := os.UserHomeDir()
	return filepath.Join(home, ".hotplex", "logs")
}

// templates.go:121
func logDirForHome(level Level, homeDir string) string {
	if level == LevelSystem { return systemLogDir() }
	return filepath.Join(homeDir, ".hotplex", "logs")
}

Proposed Fix:

// service.go — LogDir delegates to logDirForHome
func LogDir(level Level) string { return logDirForHome(level, homeDir()) }

func logDirForHome(level Level, homeDir string) string {
	if level == LevelSystem { return systemLogDir() }
	return filepath.Join(homeDir, ".hotplex", "logs")
}

func homeDir() string {
	h, _ := os.UserHomeDir()
	return h
}

Acceptance Criteria:

• LogDir 委托给 logDirForHome，路径逻辑只存在一处
• 日志目录约定变更只需修改 logDirForHome
• make test 通过

---

Implementation Priority

Finding	Priority	Effort	Risk	Impact
windows-manager-unused-command-runner	P1	Trivial	None	消除误导性代码，清晰表达意图
logdir-vs-logdirforhome-duplication	P2	Small	None	单点路径维护

---

Out of Scope

• Logs 方法直接绑定 os.Stdout/os.Stderr — 终端透传命令，非库函数，抽象 ROI 低
• Manager 7 方法接口 — 所有方法被调用者使用，拆分无实际收益
• Restart Stop+Start 委托 — 仅 3 行，Linux 正确使用 systemctl restart

---

Verification

• make test 通过
• GOOS=windows go build ./... 通过
• hotplex service install/start/stop/status/logs 在 macOS 上正常工作

[hrygo]

arch-audit (cycle 178): 验证结果 — valid（2/2 发现仍然有效）。

• windowsManager dead CommandRunner: ✅ manager_windows.go:16-18 的 run 字段在 NewManager() 初始化但无任何方法读取。所有方法直接使用 connectSCM() 或 exec.Command。
• LogDir/logDirForHome DRY: ✅ service.go:97-103 和 templates.go:121-126 实现相同逻辑（system 级调用 systemLogDir()，user 级返回 filepath.Join(homeDir, ".hotplex", "logs")）。仅 homeDir 来源不同。

[hrygo]

arch-analysis (cycle 194, error-handling): 补充发现。

Install 静默吞噬 os.UserHomeDir 错误

Severity: Medium | Confidence: High
Location: manager_darwin.go:33, manager_linux.go:36

问题: 此发现与已有的 logdir-vs-logdirforhome-duplication 发现共享同一 UserHomeDir 模式。LogDir 中 home, _ := os.UserHomeDir() 的错误吞噬已在 DRY 发现中隐含覆盖。但 Install 路径（darwin line 33, linux line 36）有相同问题且更严重 — 空的 homeDir 被写入 plist/unit 文件，导致服务配置路径损坏。对比 plistPath()/unitPath() 在 UserHomeDir 失败时正确返回错误。

建议: 修复 DRY 发现时一并处理 — Install 中检查 UserHomeDir 错误并返回，与 plistPath/unitPath 模式一致。