speccore 8.3.21 → 8.3.26

package/dist/core/unified-config.d.ts

@@ -1,44 +1,178 @@
+/** 当前系统配置 schema 版本号（.speccore.yml） */
+export declare const CURRENT_SCHEMA_VERSION = 1;
+/** 当前项目配置 schema 版本号（.speccore/PROJECT.yaml） */
+export declare const PROJECT_CURRENT_SCHEMA_VERSION = 1;
+export interface PlatformConfig {
+    name: string;
+    type: 'frontend' | 'backend' | 'infra';
+    description?: string;
+    code_path?: string;
+    git_repo?: string;
+    default_branch: string;
+}
+export interface LlmProviderConfig {
+    name: string;
+    enabled: boolean;
+    type: 'ollama' | 'openai' | 'anthropic' | 'custom';
+    endpoint: string;
+    model: string;
+    apiKey?: string;
+    priority: number;
+}
+/** 系统配置 — .speccore.yml（CLI 运行时行为开关） */
 export interface SpecConfig {
+    schema_version: number;
+    quality_gates: {
+        enforce_testing: boolean;
+        enforce_review: boolean;
+        require_pr: boolean;
+    };
+    arbitration: {
+        enabled: boolean;
+        mode: 'full' | 'l1-only' | 'report-only';
+    };
+    settings: {
+        assignee: {
+            enabled: boolean;
+            mode: 'strict' | 'loose' | 'off';
+        };
+        trace: {
+            enabled: boolean;
+            auto_annotate: boolean;
+        };
+        archive: {
+            auto_cleanup: boolean;
+        };
+        plan: {
+            parallel_suggest: boolean;
+        };
+        validation: {
+            strict_mode: boolean;
+        };
+        sync: {
+            auto_check: boolean;
+        };
+        patterns: {
+            auto_save: 'off' | 'smart' | 'aggressive';
+        };
+        review: {
+            check_assignee: boolean;
+        };
+    };
+    ask: {
+        routing: {
+            mode: 'hybrid' | 'cli-only' | 'host-ai-only';
+            high_threshold: number;
+            low_threshold: number;
+            auto_host_ai: boolean;
+            cache_enabled: boolean;
+            cache_min_hits: number;
+        };
+        rules: {
+            force_host_ai: boolean;
+        };
+        llm_providers: LlmProviderConfig[];
+    };
+    config_history: {
+        date: string;
+        change: string;
+        changed_by?: string;
+    }[];
+}
+/** 项目配置 — .speccore/PROJECT.yaml（工程映射） */
+export interface ProjectConfig {
+    schema_version: number;
     project: {
         name: string;
         description?: string;
         version?: string;
     };
-    tech_stack: {
-        backend?: string;
-        frontend?: string;
-        database?: string;
-        cache?: string;
-        mq?: string;
-    };
-    team: {
-        members: {
-            name: string;
-            role: string;
-            assignee?: string;
-        }[];
-    };
-    platforms: string[];
+    platforms: PlatformConfig[];
     git: {
         default_base: string;
         branch_prefix: string;
+        protected_branches: string[];
     };
     code_scope: string[];
-    conventions: {
-        commit?: string;
-        naming?: string;
-        review?: string;
-    };
-    quality_gates: {
-        enforce_testing: boolean;
-        enforce_review: boolean;
-        require_pr: boolean;
-    };
+}
+export declare const DEFAULT_CONFIG: SpecConfig;
+export declare const DEFAULT_PROJECT_CONFIG: ProjectConfig;
+export interface ConfigLoadResult {
+    config: SpecConfig;
+    warnings: string[];
+    migrated: boolean;
+}
+export interface ProjectConfigLoadResult {
+    config: ProjectConfig;
+    warnings: string[];
+    migrated: boolean;
 }
 export declare function loadConfig(): Promise<SpecConfig>;
+/** 获取配置 + 元信息（warnings、是否迁移过） */
+export declare function loadConfigWithMeta(): Promise<ConfigLoadResult>;
+/** 加载项目配置（简化版） */
+export declare function loadProjectConfig(): Promise<ProjectConfig>;
+/** 获取项目配置 + 元信息 */
+export declare function loadProjectConfigWithMeta(): Promise<ProjectConfigLoadResult>;
+/** 兼容旧代码：getConfig = loadConfig */
+export declare function getConfig(): Promise<SpecConfig>;
 export declare function saveConfig(config: SpecConfig): Promise<void>;
+export declare function saveProjectConfig(config: ProjectConfig): Promise<void>;
+/**
+ * 初始化时生成 .speccore.yml（系统配置）
+ */
+export declare function initConfig(): Promise<void>;
+/**
+ * 初始化时生成 .speccore/PROJECT.yaml（项目配置）
+ */
+export declare function initProjectConfig(projectName?: string): Promise<void>;
+export interface ConfigDiff {
+    /** 新增字段路径列表 */
+    added: string[];
+    /** 删除字段路径列表 */
+    removed: string[];
+    /** 类型变更：字段存在但类型不同 */
+    typeChanged: {
+        path: string;
+        current: string;
+        expected: string;
+    }[];
+    /** 枚举值变更：合法值集合变化 */
+    enumChanged: {
+        path: string;
+        current: string[];
+        expected: string[];
+    }[];
+    /** 结构变更：对象↔数组、嵌套结构变化等 */
+    structureChanged: {
+        path: string;
+        description: string;
+    }[];
+}
+/**
+ * 递归比较当前配置与目标配置（DEFAULT_CONFIG），检测所有差异
+ */
+export declare function detectConfigDiff(current: unknown, target: unknown, path?: string): ConfigDiff;
+/**
+ * 判断差异是否需要用户确认（新增字段除外，可自动处理）
+ */
+export declare function requiresUserConfirmation(diff: ConfigDiff): boolean;
+/**
+ * 格式化差异为可读文本
+ */
+export declare function formatConfigDiff(diff: ConfigDiff): string[];
+export declare function upgradeConfig(): Promise<ConfigLoadResult>;
+export declare function upgradeProjectConfig(): Promise<ProjectConfigLoadResult>;
+export interface EnvResolutionResult {
+    value: unknown;
+    /** 成功解析的环境变量名 */
+    resolved: string[];
+    /** 未找到的环境变量名 */
+    unresolved: string[];
+}
 /**
- * 初始化时生成 .speccore.yml
+ * 递归遍历对象/数组，将所有字符串中的 ${ENV_VAR} 替换为环境变量值。
+ * 支持默认值语法: ${VAR:-default}
  */
-export declare function initConfig(projectName?: string): Promise<void>;
+export declare function resolveEnvVars(obj: unknown): EnvResolutionResult;
 //# sourceMappingURL=unified-config.d.ts.map

package/dist/core/unified-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-config.d.ts","sourceRoot":"","sources":["../../src/core/unified-config.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,IAAI,EAAE;QACJ,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC9D,CAAC;IACF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE;QACH,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,aAAa,EAAE;QACb,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAeD,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CAUtD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE"}
+{"version":3,"file":"unified-config.d.ts","sourceRoot":"","sources":["../../src/core/unified-config.ts"],"names":[],"mappings":"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"}