package kernelmod

// 设施名常量（依赖图上被引用的名字）。
//
// ★ 为何用常量而不是裸字符串：拼错依赖名时**编译不过**，
// 而不是"永远等不到就绪"（运行期表现是静默挂起 / 静默拿到 nil，极难排查）。
//
// ★ 为何放在 core.go 之外：用户要求"根目录只有 core.go"，
// 而 core.go 专注注册表职责。设施名是**模块间的协议**，与注册表分开更清晰。
const (
	// ── 插件可依赖的设施（与公开 SDK 的 sdk.Facility* **逐字一致**）──
	//
	// ★ 判据 TestFacilityNamesMatchPublicSDK 守这个一致性。
	// 这些名字会出现在 plugin.json 的 requires_facilities 里。
	FacConfig     = "config"
	FacKernelIO   = "kernel-io"
	FacMemory     = "memory"
	FacLua        = "lua"
	FacSupervisor = "supervisor"
	FacTracker    = "tracker"
	FacTextMem    = "textmem"
	FacLLM        = "llm"
	FacDocStore   = "docmem"
	FacKnowledge  = "knowledge"
	FacMultimodal = "multimodal"
	FacONNX       = "onnx"
	FacStageHost  = "stagehost"
	FacAgent      = "agent"

	// ── 内核**内部**顺序标记（**不是**给插件的设施）──
	//
	// ★ 为什么不与上面的混在一起：这两类东西的**消费者不同**。
	//   · 上面的：插件按它声明启动时机（对外契约，必须进公开 SDK）
	//   · 这里的：只用于**内核模块之间**表达顺序（如"迁移必须先于扫盘"）
	//
	// 混在一起会让"内核内部标记"被误当成"插件可选设施"
	// ⇒ 插件可能声明它（然后永远等不到 —— 因为它的就绪时机是装配中途，
	// 而插件提交发生在装配**完成之后**……实际会立刻满足，但语义是错的：
	// 它不该成为插件的契约）。
	//
	// 判据 TestFacilityNamesMatchPublicSDK 只比对上面那组 ⇒ 天然拦住
	// "把内部标记泄漏成对外契约"。

	// FacMigrated 标记"知识库目录迁移已完成"（用于让 store 排在迁移之后）。
	FacMigrated = "knowledge-migrated"
)