/**
 * Lifecycle — 服务层模块。
 *
 * 职责边界：
 * - 负责：readPackageVersion 等 服务层职责
 * - 不负责：不属于本模块的职责由对应模块承担
 *
 * 被谁调用：上层模块按需调用
 * 调用谁：node:fs、logger、helpers、index、index_manager
 *
 * 数据流：输入 → readPackageVersion 处理 → 输出
 * 持久化：读写本地文件（详见代码内路径）
 */
import type { ProjectConfig } from "../types/index.js";
import type { KnowledgeIndexManager } from "../context/knowledge/index_manager.js";
/**
 * 读取 package.json 版本号，失败时返回 "unknown"。
 */
export declare function readPackageVersion(): string;
/**
 * 创建带超时的 shutdown 函数。
 * @param cleanup - 异步清理函数
 * @param timeoutMs - 超时毫秒数（默认 5000ms）
 */
export declare function createShutdownHandler(cleanup: () => Promise<void>, timeoutMs?: number): () => void;
/**
 * 创建最小 fallback 配置（当真实配置加载失败时使用）。
 */
export declare function createFallbackConfig(projectPath: string): ProjectConfig;
/**
 * 创建诊断态 KnowledgeIndexManager（真实配置无法构造索引时，仅为保持服务依赖形状）。
 * 调用方必须同时设置 config._knowledgeDegraded，禁止把它用于知识读写。
 */
export declare function createDegradedKnowledgeIndex(projectPath: string): Promise<KnowledgeIndexManager>;