package main

import (
	"fmt"

	"git.yeij.top/AskaEth/Cyrene_v2/internal/config/runtimeconfig"
	"git.yeij.top/AskaEth/Cyrene_v2/internal/logger"
	"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/memory"
)

// 本文件把记忆整理（DevDocs/design/23-记忆整理与去重 §4）接进组合根。
//
// 四件事只在这里定：
//   - **形态**：低峰定期后台任务（memory.TidyService 的心跳），不是会话内派
//     subagent。它在 main.go 与 backthink 并列启动、在 close 里先于关库停止；
//   - **依赖面**：只给它记忆存储与 embedder —— 服务侧拿不到任何会话/历史读数，
//     因此 design §4.1「绝不碰主会话上下文」是结构性成立的，而不是靠自觉；
//   - **审计**：接到网关的 AuditEvent（design §8 的 memory.tidy.*），出口在调用
//     时才解析 a.gw —— 网关比本服务晚组装（wireFrontend），与 onToolAudit
//     同一手法。未就绪时只记日志，绝不假装写过审计；
//   - **运行期调优**（2026-10-07 新增）：从 `$DATA_DIR/config/memory-tidy.json`
//     读「自动落地开关 + 每轮上限」。它是 `.env` 冻结（design/13 §2.1）之后新旋钮
//     的唯一去处，**零新 env 键**；读不到/解不开一律回落代码默认值并记 WARN
//     （坏配置绝不能让自动档变成「无限制」）。
//
// 刻意**不做**的一件事（design §4.1 F）：
//   - 不把 sess-memorytidy 加进 flowPub 的图源白名单（默认关：整理是系统任务，
//     不是主人的会话）。
func (a *app) wireMemoryTidy() error {
	cfg := memory.TidyConfigFromConfig(a.cfg.MemoryTidy)
	a.applyMemoryTidyTuning(&cfg)
	svc, err := memory.NewTidyService(cfg, memory.TidyDeps{
		Store:    a.memStore,
		Embedder: a.embedder,
		Audit:    a.auditMemoryTidy,
		Log:      logger.WithSource(a.log, "memory/tidy"),
	})
	if err != nil {
		return fmt.Errorf("memory tidy: %w", err)
	}
	a.memoryTidy = svc
	return nil
}

// applyMemoryTidyTuning 把 `$DATA_DIR/config/memory-tidy.json` 叠到 env 侧的
// TidyConfig 上（见 runtimeconfig.MemoryTidyTuning 的零值口径）：
//   - 文件里**没写** autoApply ⇒ 保持代码默认（开）；
//   - 写 `false` ⇒ DisableAutoApply = true（一键回到「只产建议」，不必改代码）；
//   - autoApplyPerRound ≤ 0 ⇒ 不覆盖，交给 normalizeTidyConfig 填默认上限。
//
// 读不到/解不开时只记 WARN 并保持 env 侧的值：那正是「回落代码默认值」。
func (a *app) applyMemoryTidyTuning(cfg *memory.TidyConfig) {
	tuning, path, err := a.readMemoryTidyTuning()
	if err != nil {
		logger.WithSource(a.log, "memory/tidy").Warn(
			"memory tidy tuning unreadable, falling back to code defaults",
			"path", path, "error", err)
		return
	}
	cfg.DisableAutoApply = tuning.AutoApplyOff()
	if tuning.AutoApplyPerRound > 0 {
		cfg.AutoApplyPerRound = tuning.AutoApplyPerRound
	}
	logger.WithSource(a.log, "memory/tidy").Info(
		"memory tidy tuning loaded",
		"path", path, "auto_apply", !cfg.DisableAutoApply,
		"auto_apply_per_round", cfg.AutoApplyPerRound)
}

// readMemoryTidyTuning 读一次 `$DATA_DIR/config/memory-tidy.json`（**只读**）。
// 它把「落点 + 读取 + 路径回报」收在一处，供整理自动档与**同步入库闸**两个
// 消费者共用 —— 后者（wireMemoryReview）不属于整理服务，但它的开关就在同一个
// 文件里（零新 env 键，design/13 §2.1）。错误由调用方记 WARN 并回落代码默认值。
func (a *app) readMemoryTidyTuning() (runtimeconfig.MemoryTidyTuning, string, error) {
	path := runtimeconfig.DefaultMemoryTidyPath(resolveDataDir(a.cfg))
	tuning, err := runtimeconfig.LoadMemoryTidyTuning(path)
	if err != nil {
		return runtimeconfig.MemoryTidyTuning{}, path, err
	}
	return tuning, path, nil
}

// auditMemoryTidy 把一轮整理的计数写进网关审计链。它**只带计数**，绝不带
// 任何记忆正文（design §8 的 who/what/when/result 口径）。
func (a *app) auditMemoryTidy(who, what, result string) {
	if a.gw != nil {
		a.gw.AuditEvent(who, what, result)
		return
	}
	logger.WithSource(a.log, "memory/tidy").Info(
		"memory tidy audit dropped: gateway not ready", "who", who, "what", what, "result", result)
}