/** 迭代综合文档子目录名(v6.78.0+ 从 'global' 改为 'overview') */ export declare const GLOBAL_SPECS_DIR = "overview"; /** 迭代综合文档文件名列表(用于散落文件归位、路径解析等) * v7.5.1+:TECH/RISK/REVIEW/MONITOR 重新纳入,确保 sanitizeSpecDirectories 能将根目录散落文件归位到 overview/ * v8.3.11+:补充 DEV_GUIDE.md / CHANGELOG.md / SCHEMA.md,防止 analyze 产物散落在 020-specs/ 根目录 * 这些文件在 Phase 1 写入 overview/,Phase 2 可生成各端专属版本写入 {端}/ */ export declare const GLOBAL_SPEC_FILES: string[]; /** * 解析迭代综合 spec 文件路径(唯一路径:overview/) * v8.3.171+: 删除 global/ 和根目录回退,只保留 overview/ */ export declare function resolveGlobalSpecPath(specDir: string, filename: string): Promise; /** * 获取迭代综合 spec 文件的写入路径(始终使用新路径 overview/) * 自动确保 overview/ 目录存在 */ export declare function globalSpecWritePath(specDir: string, filename: string): Promise; /** * 从 CONSTITUTION.md 解析端列表(v6.46.0+) * 优先读取「端列表」章节,回退到「对应需求端」列 * v7.4.3+: 返回值经过合法性校验,过滤垃圾值 * 返回去重后的端名数组 */ /** * v8.3.17+: 从迭代需求文档提取功能模块(需求文档名)列表 * 扫描 010-requirements/ 和 020-specs/requirements/ 下的所有 .md 文件 * 提取文件名(不含扩展名)作为功能模块名,去重返回 */ export declare function parseFeatureList(iterDir: string): Promise; /** * v8.3.201+: 读取 features/ 下的一级子目录名作为功能单元清单。 * 只认「目录」,忽略 INDEX.md 等文件;排除 . 开头(.meta 等)与 _ 开头(_shared 等)的系统目录。 */ export declare function readFeatureDirs(featuresDir: string): Promise; /** * v8.3.17+: 检测 020-specs/ 结构检测 * 历史结构特征:根目录下存在端名目录(如 api/、web/、h5/) * 新结构特征:根目录下是功能模块目录(如 用户管理/、订单系统/) */ export declare function isLegacySpecDir(specDir: string): Promise; export declare function parsePlatformList(): Promise; /** * 从 CONSTITUTION.md 解析各端的工程类型(v6.49.0+) * 返回 Map<端名, 工程类型> */ export declare function parsePlatformTypes(): Promise>; /** * 端类型判定(v8.3.191+):统一入口,标准从「目录名正则猜」升级为「配置优先」 * 优先级:PROJECT.yaml platforms[].type > CONSTITUTION.md 端列表 > 目录名正则兜底 * 返回值归一化为 backend | frontend | infra | unknown */ export declare function resolvePlatformType(platformName: string): Promise<'backend' | 'frontend' | 'infra' | 'unknown'>; /** * 从 CONSTITUTION.md 解析项目信息表(v8.3.107+) * 返回 Map<工程标识, ProjectInfo> * 用于 execute 命令确定代码输出位置 * * v8.3.107 新格式: * | 工程标识 | 工程类型 | 工程名 | 项目名称 | 项目描述 | 工程源码路径 | 涉及需求端 | 备注 | * Git 配置移至独立章节「Git 配置」,不再在项目信息表中配置 */ export interface ProjectInfo { projectIdentifier: string; projectType: string; engineeringName: string; projectName: string; projectDesc: string; srcPath: string; gitRepo: string; branch: string; platform: string; notes: string; } export declare function parseProjectInfo(): Promise>; /** * 根据端名获取实际的工程路径 * 用于 execute 命令确定代码输出位置 * * 匹配顺序: * 1. 精确匹配工程标识(name 列) * 2. 回退匹配「对应端」列(仅匹配工程标识) */ export declare function getProjectPathForPlatform(platform: string): Promise; /** * 从 CONSTITUTION.md 解析 Git 配置(v8.3.109+) * 先读取「Git 公共配置」章节获取默认值,再读取「Git 配置」章节用各工程覆盖 * 支持公共默认 + 各工程独有配置 * * 覆盖规则: * - 工程配置表中字段为空、为 `—`、为 `-` 时,使用公共默认值 * - 工程配置表中字段有值时,覆盖公共默认值 */ export interface BranchTypeInfo { type: string; /** 任务名前的前缀,可选。如 'api-' */ prefix?: string; /** 任务名后的后缀,可选。如 '-urgent' */ suffix?: string; source: string; description: string; } export interface GitConfigInfo { projectIdentifier: string; gitRepo: string; defaultBranch: string; protectedBranches: string[]; branchPrefix: string; notes: string; /** v8.3.113+: 分支类型定义(从「Git 公共配置」的分支类型表解析) */ branchTypes: BranchTypeInfo[]; } export declare function parseGitConfig(): Promise>; //# sourceMappingURL=spec-paths.d.ts.map