@winspan/claude-forge 0.1.1

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,MAAM,EAAE,MAAM,aAAa,CAAC;AAGnD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAyC;IAEjE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa;IAQtD,qBAAqB;IACrB,MAAM,CAAC,cAAc,IAAI,IAAI;IAI7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAK/B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,UAAU;IA2BlB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,iBAAiB;IAgEzB,GAAG,IAAI,MAAM;IAIb,cAAc,IAAI,MAAM;IAIxB,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAiBnC,KAAK,IAAI,IAAI;CAMd;AAED,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,161 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import yaml from 'js-yaml';
+import { ConfigSchema } from './schema.js';
+import { defaultConfig } from './defaults.js';
+export class ConfigManager {
+    static instances = new Map();
+    /**
+     * 获取单例实例（同一 configPath 只读一次文件）
+     */
+    static getInstance(configPath) {
+        const key = configPath || path.join(os.homedir(), '.claude-forge', 'config.yaml');
+        if (!ConfigManager.instances.has(key)) {
+            ConfigManager.instances.set(key, new ConfigManager(configPath));
+        }
+        return ConfigManager.instances.get(key);
+    }
+    /** 仅用于测试：清除所有缓存实例 */
+    static clearInstances() {
+        ConfigManager.instances.clear();
+    }
+    config;
+    configPath;
+    constructor(configPath) {
+        this.configPath = configPath || this.getDefaultConfigPath();
+        this.config = this.loadConfig();
+    }
+    getDefaultConfigPath() {
+        return path.join(os.homedir(), '.claude-forge', 'config.yaml');
+    }
+    expandPath(filePath) {
+        if (filePath.startsWith('~/')) {
+            return path.join(os.homedir(), filePath.slice(2));
+        }
+        return filePath;
+    }
+    loadConfig() {
+        // 1. 从默认配置开始
+        let config = { ...defaultConfig };
+        // 2. 如果配置文件存在，加载并合并
+        if (fs.existsSync(this.configPath)) {
+            try {
+                const fileContent = fs.readFileSync(this.configPath, 'utf-8');
+                const fileConfig = yaml.load(fileContent);
+                config = this.mergeConfig(config, fileConfig);
+            }
+            catch (error) {
+                throw new Error(`Failed to load config from ${this.configPath}: ${error}`);
+            }
+        }
+        // 3. 从环境变量覆盖
+        config = this.applyEnvOverrides(config);
+        // 4. 校验配置
+        try {
+            return ConfigSchema.parse(config);
+        }
+        catch (error) {
+            throw new Error(`Invalid configuration: ${error}`);
+        }
+    }
+    mergeConfig(base, override) {
+        return {
+            storage: { ...base.storage, ...override.storage },
+            distill: { ...base.distill, ...override.distill },
+            resume: { ...base.resume, ...override.resume },
+            backup: { ...base.backup, ...override.backup },
+            claudemd: { ...base.claudemd, ...override.claudemd },
+            orchestration: { ...base.orchestration, ...override.orchestration },
+            autopilot: { ...base.autopilot, ...override.autopilot },
+            pattern_engine: { ...base.pattern_engine, ...override.pattern_engine },
+        };
+    }
+    applyEnvOverrides(config) {
+        const env = process.env;
+        // Storage overrides
+        if (env.CLAUDE_FORGE_STORAGE_PATH) {
+            config.storage.path = env.CLAUDE_FORGE_STORAGE_PATH;
+        }
+        if (env.CLAUDE_FORGE_STORAGE_MAX_SIZE_MB) {
+            config.storage.max_size_mb = parseInt(env.CLAUDE_FORGE_STORAGE_MAX_SIZE_MB, 10);
+        }
+        // Distill overrides
+        if (env.CLAUDE_FORGE_DISTILL_AUTO_TRIGGER) {
+            config.distill.auto_trigger = env.CLAUDE_FORGE_DISTILL_AUTO_TRIGGER === 'true';
+        }
+        if (env.CLAUDE_FORGE_DISTILL_EVENT_THRESHOLD) {
+            config.distill.event_threshold = parseInt(env.CLAUDE_FORGE_DISTILL_EVENT_THRESHOLD, 10);
+        }
+        // 优先从环境变量读取 API Key（ANTHROPIC_AUTH_TOKEN > ANTHROPIC_API_KEY > CLAUDE_FORGE_DISTILL_API_KEY）
+        // 注：config.distill.api_key 已废弃，仅作向后兼容保留
+        if (env.ANTHROPIC_AUTH_TOKEN) {
+            config.distill.api_key = env.ANTHROPIC_AUTH_TOKEN;
+        }
+        else if (env.ANTHROPIC_API_KEY) {
+            config.distill.api_key = env.ANTHROPIC_API_KEY;
+        }
+        else if (env.CLAUDE_FORGE_DISTILL_API_KEY) {
+            config.distill.api_key = env.CLAUDE_FORGE_DISTILL_API_KEY;
+        }
+        if (env.CLAUDE_FORGE_DISTILL_MODEL) {
+            config.distill.model = env.CLAUDE_FORGE_DISTILL_MODEL;
+        }
+        // Resume overrides
+        if (env.CLAUDE_FORGE_RESUME_ENABLED) {
+            config.resume.enabled = env.CLAUDE_FORGE_RESUME_ENABLED === 'true';
+        }
+        if (env.CLAUDE_FORGE_RESUME_TIMEOUT_MINUTES) {
+            config.resume.timeout_minutes = parseInt(env.CLAUDE_FORGE_RESUME_TIMEOUT_MINUTES, 10);
+        }
+        if (env.CLAUDE_FORGE_RESUME_MAX_AGE_DAYS) {
+            config.resume.max_age_days = parseInt(env.CLAUDE_FORGE_RESUME_MAX_AGE_DAYS, 10);
+        }
+        // Backup overrides
+        if (env.CLAUDE_FORGE_BACKUP_INCLUDE_PROFILE) {
+            config.backup.include_profile = env.CLAUDE_FORGE_BACKUP_INCLUDE_PROFILE === 'true';
+        }
+        if (env.CLAUDE_FORGE_BACKUP_ENCRYPT_BY_DEFAULT) {
+            config.backup.encrypt_by_default = env.CLAUDE_FORGE_BACKUP_ENCRYPT_BY_DEFAULT === 'true';
+        }
+        // ClaudeMd overrides
+        if (env.CLAUDE_FORGE_CLAUDEMD_AUTO_GENERATE) {
+            config.claudemd.auto_generate = env.CLAUDE_FORGE_CLAUDEMD_AUTO_GENERATE === 'true';
+        }
+        if (env.CLAUDE_FORGE_CLAUDEMD_AUTO_REFINE) {
+            config.claudemd.auto_refine = env.CLAUDE_FORGE_CLAUDEMD_AUTO_REFINE === 'true';
+        }
+        if (env.CLAUDE_FORGE_CLAUDEMD_REFINE_INTERVAL) {
+            config.claudemd.refine_interval = parseInt(env.CLAUDE_FORGE_CLAUDEMD_REFINE_INTERVAL, 10);
+        }
+        return config;
+    }
+    get() {
+        return { ...this.config };
+    }
+    getStoragePath() {
+        return this.expandPath(this.config.storage.path);
+    }
+    save(config) {
+        this.config = this.mergeConfig(this.config, config);
+        // 校验新配置
+        ConfigSchema.parse(this.config);
+        // 确保目录存在
+        const dir = path.dirname(this.configPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // 写入文件
+        const yamlContent = yaml.dump(this.config);
+        fs.writeFileSync(this.configPath, yamlContent, 'utf-8');
+    }
+    reset() {
+        this.config = { ...defaultConfig };
+        if (fs.existsSync(this.configPath)) {
+            fs.unlinkSync(this.configPath);
+        }
+    }
+}
+export { ConfigSchema } from './schema.js';
+export { defaultConfig } from './defaults.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"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"}

package/dist/config/schema.d.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+/** 合法的 Claude 模型列表。空字符串表示"未配置，从环境变量读取"。 */
+export declare const ALLOWED_MODELS: readonly ["claude-sonnet-4-5", "claude-sonnet-4-6", "claude-opus-4", "claude-haiku-3-5"];
+export type AllowedModel = typeof ALLOWED_MODELS[number];
+export declare const ConfigSchema: z.ZodObject<{
+    storage: z.ZodObject<{
+        path: z.ZodDefault<z.ZodString>;
+        max_size_mb: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    distill: z.ZodObject<{
+        auto_trigger: z.ZodDefault<z.ZodBoolean>;
+        event_threshold: z.ZodDefault<z.ZodNumber>;
+        timer_interval_minutes: z.ZodDefault<z.ZodNumber>;
+        api_key: z.ZodDefault<z.ZodString>;
+        model: z.ZodDefault<z.ZodString>;
+        base_url: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    resume: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        timeout_minutes: z.ZodDefault<z.ZodNumber>;
+        max_age_days: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    backup: z.ZodObject<{
+        include_profile: z.ZodDefault<z.ZodBoolean>;
+        encrypt_by_default: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>;
+    claudemd: z.ZodDefault<z.ZodObject<{
+        auto_generate: z.ZodDefault<z.ZodBoolean>;
+        auto_refine: z.ZodDefault<z.ZodBoolean>;
+        refine_interval: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    orchestration: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        notify_on_distill: z.ZodDefault<z.ZodBoolean>;
+        notify_on_claudemd: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    autopilot: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        intent_analysis: z.ZodDefault<z.ZodBoolean>;
+        knowledge_search: z.ZodDefault<z.ZodBoolean>;
+        quality_gate: z.ZodDefault<z.ZodBoolean>;
+        quality_review_interval: z.ZodDefault<z.ZodNumber>;
+        knowledge_max_age_days: z.ZodDefault<z.ZodNumber>;
+        auto_start_pipeline: z.ZodDefault<z.ZodBoolean>;
+        pipeline_confirm_mode: z.ZodDefault<z.ZodEnum<{
+            prompt: "prompt";
+            auto: "auto";
+            preview: "preview";
+        }>>;
+    }, z.core.$strip>>;
+    pattern_engine: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        route_timeout_ms: z.ZodDefault<z.ZodNumber>;
+        evolve_interval_days: z.ZodDefault<z.ZodNumber>;
+        evolve_min_executions: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof ConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2CAA2C;AAC3C,eAAO,MAAM,cAAc,0FAKjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+EvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+/** 合法的 Claude 模型列表。空字符串表示"未配置，从环境变量读取"。 */
+export const ALLOWED_MODELS = [
+    'claude-sonnet-4-5',
+    'claude-sonnet-4-6',
+    'claude-opus-4',
+    'claude-haiku-3-5',
+];
+export const ConfigSchema = z.object({
+    storage: z.object({
+        path: z.string().default('~/.claude-forge/data.db'),
+        max_size_mb: z.number().int().positive().default(1024),
+    }),
+    distill: z.object({
+        auto_trigger: z.boolean().default(true),
+        event_threshold: z.number().int().positive().default(100),
+        timer_interval_minutes: z.number().int().positive().default(30),
+        api_key: z.string().default(''),
+        model: z.string()
+            .refine((v) => v === '' || ALLOWED_MODELS.includes(v), { message: `distill.model must be one of: ${ALLOWED_MODELS.join(', ')}` })
+            .default('claude-sonnet-4-6'),
+        base_url: z.string().default(''),
+    }),
+    resume: z.object({
+        enabled: z.boolean().default(true),
+        timeout_minutes: z.number().int().positive().default(10),
+        max_age_days: z.number().int().positive().default(7),
+    }),
+    backup: z.object({
+        include_profile: z.boolean().default(false),
+        encrypt_by_default: z.boolean().default(false),
+    }),
+    claudemd: z.object({
+        auto_generate: z.boolean().default(true),
+        auto_refine: z.boolean().default(true),
+        refine_interval: z.number().int().positive().default(3),
+    }).default({
+        auto_generate: true,
+        auto_refine: true,
+        refine_interval: 3,
+    }),
+    orchestration: z.object({
+        enabled: z.boolean().default(true),
+        notify_on_distill: z.boolean().default(true),
+        notify_on_claudemd: z.boolean().default(true),
+    }).default({
+        enabled: true,
+        notify_on_distill: true,
+        notify_on_claudemd: true,
+    }),
+    autopilot: z.object({
+        enabled: z.boolean().default(true),
+        intent_analysis: z.boolean().default(true),
+        knowledge_search: z.boolean().default(true),
+        quality_gate: z.boolean().default(true),
+        quality_review_interval: z.number().int().positive().default(3),
+        knowledge_max_age_days: z.number().int().positive().default(90),
+        auto_start_pipeline: z.boolean().default(true),
+        /** 编排确认模式：prompt=先给用户选择，auto=自动启动，preview=仅展示不启动 */
+        pipeline_confirm_mode: z.enum(['prompt', 'auto', 'preview']).default('prompt'),
+    }).default({
+        enabled: true,
+        intent_analysis: true,
+        knowledge_search: true,
+        quality_gate: true,
+        quality_review_interval: 3,
+        knowledge_max_age_days: 90,
+        auto_start_pipeline: true,
+        pipeline_confirm_mode: 'prompt',
+    }),
+    pattern_engine: z.object({
+        enabled: z.boolean().default(true),
+        /** AI 路由超时（毫秒），超时后降级到关键词匹配 */
+        route_timeout_ms: z.number().int().positive().default(60_000),
+        /** Pattern 自进化间隔（天） */
+        evolve_interval_days: z.number().int().positive().default(7),
+        /** 触发自进化的最低执行次数阈值 */
+        evolve_min_executions: z.number().int().positive().default(20),
+    }).default({
+        enabled: true,
+        route_timeout_ms: 60_000,
+        evolve_interval_days: 7,
+        evolve_min_executions: 20,
+    }),
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}

package/dist/convention/convention-distiller.d.ts

@@ -0,0 +1,28 @@
+import type { ClaudeAPI } from '../utils/claude-api.js';
+import type { ConventionLoader } from './convention-loader.js';
+import type { Convention, ConventionDistillResult } from './types.js';
+import type { ProjectProfile } from '../claudemd/detector.js';
+export declare class ConventionDistiller {
+    private api;
+    private loader;
+    constructor(api: ClaudeAPI, loader: ConventionLoader);
+    static customId(projectPath: string): string;
+    static customFilePath(projectPath: string): string;
+    /**
+     * 蒸馏项目级自定义规范。
+     * - sourceConventions 为空时，根据 projectProfile 纯技术栈生成
+     * - sourceConventions 非空时，合并源规范（同时可融合技术栈信息）
+     * - existingCustom 存在时为增量合并，否则全量生成
+     */
+    distill(projectPath: string, sourceConventions: Convention[], existingCustom?: Convention | null, projectProfile?: ProjectProfile | null): Promise<{
+        convention: Convention;
+        result: ConventionDistillResult;
+    }>;
+    private mergeWithAI;
+    private parseAIResponse;
+    private fallbackMerge;
+    private fallbackPrinciples;
+    private mergeRoles;
+    private bumpVersion;
+}
+//# sourceMappingURL=convention-distiller.d.ts.map

package/dist/convention/convention-distiller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-distiller.d.ts","sourceRoot":"","sources":["../../src/convention/convention-distiller.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAkB,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAU9D,qBAAa,mBAAmB;IAClB,OAAO,CAAC,GAAG;IAAa,OAAO,CAAC,MAAM;gBAA9B,GAAG,EAAE,SAAS,EAAU,MAAM,EAAE,gBAAgB;IAEpE,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI5C,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIlD;;;;;OAKG;IACG,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,UAAU,EAAE,EAC/B,cAAc,CAAC,EAAE,UAAU,GAAG,IAAI,EAClC,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,GACrC,OAAO,CAAC;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,uBAAuB,CAAA;KAAE,CAAC;YAuDzD,WAAW;IAoDzB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,WAAW;CAQpB"}

package/dist/convention/convention-distiller.js

@@ -0,0 +1,172 @@
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+import { logger } from '../utils/logger.js';
+export class ConventionDistiller {
+    api;
+    loader;
+    constructor(api, loader) {
+        this.api = api;
+        this.loader = loader;
+    }
+    static customId(projectPath) {
+        return `custom-${path.basename(projectPath)}`;
+    }
+    static customFilePath(projectPath) {
+        return path.join(projectPath, '.claude-forge', 'custom-convention.yaml');
+    }
+    /**
+     * 蒸馏项目级自定义规范。
+     * - sourceConventions 为空时，根据 projectProfile 纯技术栈生成
+     * - sourceConventions 非空时，合并源规范（同时可融合技术栈信息）
+     * - existingCustom 存在时为增量合并，否则全量生成
+     */
+    async distill(projectPath, sourceConventions, existingCustom, projectProfile) {
+        if (sourceConventions.length === 0 && !projectProfile) {
+            throw new Error('至少需要一个源规范或项目技术栈信息才能蒸馏');
+        }
+        const customId = ConventionDistiller.customId(projectPath);
+        const filePath = ConventionDistiller.customFilePath(projectPath);
+        const aiResult = await this.mergeWithAI(sourceConventions, existingCustom ?? null, projectProfile ?? null);
+        const previousVersion = existingCustom?.version ?? null;
+        const newVersion = existingCustom
+            ? this.bumpVersion(existingCustom.version)
+            : '1.0.0';
+        const mergedRoles = this.mergeRoles(existingCustom?.roles ?? {}, [aiResult.new_roles]);
+        const description = sourceConventions.length > 0
+            ? `从 ${sourceConventions.map((c) => c.name).join('、')} 蒸馏的项目级综合规范`
+            : `根据 ${path.basename(projectPath)} 项目技术栈自动生成的规范`;
+        const convention = {
+            id: customId,
+            name: `${path.basename(projectPath)} 综合规范`,
+            version: newVersion,
+            description,
+            source: 'user',
+            principles: aiResult.principles,
+            active_prompt: aiResult.active_prompt,
+            roles: mergedRoles,
+            quality_standards: aiResult.quality_standards,
+            evolution: { auto_optimize: true, optimize_interval_days: 7 },
+            filePath,
+        };
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        const { filePath: _fp, ...serializable } = convention;
+        fs.writeFileSync(filePath, yaml.dump(serializable, { lineWidth: 120, noRefs: true }), 'utf-8');
+        logger.info(`[规范蒸馏器] 已写入 ${filePath} v${newVersion}`);
+        const distillResult = {
+            customConventionId: customId,
+            previousVersion,
+            newVersion,
+            sourcesUsed: sourceConventions.map((c) => c.id),
+            changes: aiResult.changes,
+        };
+        return { convention, result: distillResult };
+    }
+    async mergeWithAI(sources, existing, profile) {
+        const taskType = existing ? '增量合并' : (sources.length > 0 ? '全量提炼' : '技术栈生成');
+        const profileSection = profile
+            ? `## 项目技术栈\n语言：${profile.languages.map((l) => l.name + (l.version ? ` ${l.version}` : '')).join('、') || '未知'}\n框架：${profile.frameworks.map((f) => f.name).join('、') || '无'}\n\n`
+            : '';
+        const sourceSections = sources.length > 0
+            ? `## 源规范\n\n${sources.map((c) => {
+                const rolesYaml = Object.entries(c.roles)
+                    .map(([k, v]) => `  ${k}:\n    name: ${v.name}\n    responsibilities: ${v.responsibilities.slice(0, 120)}\n    constraints: ${v.constraints.slice(0, 80)}`)
+                    .join('\n');
+                const standards = c.quality_standards
+                    .map((s) => `  - [${s.severity}] ${s.category}: ${s.rule}`)
+                    .join('\n');
+                return `### ${c.name} (${c.id})\n原则摘要：${c.principles.slice(0, 300)}\n激活提示：${c.active_prompt.slice(0, 200)}\n角色：\n${rolesYaml || '  （无）'}\n质量标准：\n${standards || '  （无）'}`;
+            }).join('\n\n')}\n\n`
+            : '';
+        const existingSection = existing
+            ? `## 现有自定义规范（增量合并基础）\n原则：${existing.principles.slice(0, 400)}\n激活提示：${existing.active_prompt.slice(0, 200)}\n质量标准数：${existing.quality_standards.length}\n角色数：${Object.keys(existing.roles).length}\n\n`
+            : '';
+        const prompt = `你是一个工程规范专家，负责为项目生成或更新开发规范。
+
+## 任务类型：${taskType}
+
+${profileSection}${existingSection}${sourceSections}## 生成规则
+1. principles：针对项目技术栈提炼最关键的工程原则，具体可执行；若有源规范则融合其核心优势，冲突时生成"视上下文而定"的折中原则
+2. active_prompt：综合技术栈特点和规范要求，简洁有力，不超过 200 字
+3. quality_standards：覆盖代码质量、架构、测试、安全等维度，去重；severity 按重要性设定
+4. new_roles：定义项目适合的角色（如 architect、developer、reviewer），若为增量则只返回新增角色
+5. changes：列出本次生成/合并的关键点（3-8 条）
+${existing ? '6. 增量模式：只在现有基础上追加/优化，不删除现有内容' : ''}
+
+## 输出格式（严格 JSON，不要用代码块包裹）
+{
+  "principles": "...",
+  "active_prompt": "...",
+  "quality_standards": [{"category": "...", "rule": "...", "severity": "must|should|may"}],
+  "new_roles": {},
+  "changes": ["..."]
+}`;
+        const response = await this.api.complete(prompt, 'convention-distill');
+        return this.parseAIResponse(response, sources, existing);
+    }
+    parseAIResponse(response, sources, existing) {
+        try {
+            const cleaned = response.replace(/```(?:json)?\s*/g, '').replace(/```\s*/g, '').trim();
+            const jsonMatch = cleaned.match(/\{[\s\S]*\}/);
+            if (!jsonMatch)
+                throw new Error('未找到 JSON');
+            const parsed = JSON.parse(jsonMatch[0]);
+            return {
+                principles: parsed.principles ?? this.fallbackPrinciples(sources),
+                active_prompt: parsed.active_prompt ?? (sources[0]?.active_prompt ?? '请遵循项目规范进行开发'),
+                quality_standards: Array.isArray(parsed.quality_standards) ? parsed.quality_standards : [],
+                new_roles: parsed.new_roles && typeof parsed.new_roles === 'object' ? parsed.new_roles : {},
+                changes: Array.isArray(parsed.changes) ? parsed.changes : ['AI 蒸馏完成'],
+            };
+        }
+        catch (err) {
+            logger.warn(`[规范蒸馏器] AI 响应解析失败，使用降级策略：${err}`);
+            return this.fallbackMerge(sources, existing);
+        }
+    }
+    fallbackMerge(sources, existing) {
+        const allStandards = sources.flatMap((c) => c.quality_standards);
+        const seen = new Set();
+        const deduped = allStandards.filter((s) => {
+            const key = `${s.category}:${s.rule}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+        return {
+            principles: existing?.principles ?? this.fallbackPrinciples(sources),
+            active_prompt: existing?.active_prompt ?? (sources[0]?.active_prompt ?? '请遵循项目规范进行开发'),
+            quality_standards: deduped,
+            new_roles: {},
+            changes: ['降级合并：AI 调用失败，使用规则合并'],
+        };
+    }
+    fallbackPrinciples(sources) {
+        if (sources.length === 0)
+            return '遵循项目技术栈最佳实践';
+        return sources.map((c) => `## 来自 ${c.name}\n${c.principles.slice(0, 200)}`).join('\n\n');
+    }
+    mergeRoles(existing, incomingList) {
+        const merged = { ...existing };
+        for (const incoming of incomingList) {
+            for (const [key, role] of Object.entries(incoming)) {
+                if (!merged[key]) {
+                    merged[key] = role;
+                }
+            }
+        }
+        return merged;
+    }
+    bumpVersion(version) {
+        const parts = version.split('.').map(Number);
+        if (parts.length >= 2 && !isNaN(parts[1])) {
+            parts[1] += 1;
+            return parts.join('.');
+        }
+        return version + '.1';
+    }
+}
+//# sourceMappingURL=convention-distiller.js.map

package/dist/convention/convention-distiller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-distiller.js","sourceRoot":"","sources":["../../src/convention/convention-distiller.ts"],"names":[],"mappings":"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"}

package/dist/convention/convention-evolver.d.ts

@@ -0,0 +1,31 @@
+import { ConventionLoader } from './convention-loader.js';
+import type { ClaudeAPI } from '../utils/claude-api.js';
+import type { SQLiteStorage } from '../storage/sqlite.js';
+import type { Convention, ConventionEvolveResult } from './types.js';
+/**
+ * ConventionEvolver：从 Pattern 执行历史分析规范违反情况，用 AI 优化 Convention。
+ *
+ * 只优化 principles 和 quality_standards，不改变 roles 结构（角色是稳定契约）。
+ * 进化触发条件：手动调用 evolve()，或 auto_optimize=true 时由 SkillEvolver 定期触发。
+ */
+export declare class ConventionEvolver {
+    private readonly api;
+    private readonly storage;
+    private readonly loader;
+    constructor(api: ClaudeAPI, storage: SQLiteStorage, loader: ConventionLoader);
+    /**
+     * 对指定 Convention 执行一次进化分析。
+     * 返回 null 表示无需进化（数据不足或 AI 判断无需修改）。
+     */
+    evolve(convention: Convention): Promise<ConventionEvolveResult | null>;
+    /**
+     * 对所有项目的 custom 规范执行进化。
+     * 源规范（非 custom- 前缀）不参与进化，由 distill 负责更新。
+     */
+    evolveAll(projectPaths?: string[]): Promise<ConventionEvolveResult[]>;
+    /** 从 SQLite events 分析 gate 失败情况 */
+    private analyzeViolations;
+    private optimizeWithAI;
+    private bumpVersion;
+}
+//# sourceMappingURL=convention-evolver.d.ts.map

package/dist/convention/convention-evolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-evolver.d.ts","sourceRoot":"","sources":["../../src/convention/convention-evolver.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAmB,MAAM,YAAY,CAAC;AAStF;;;;;GAKG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,gBAAgB;IAG3C;;;OAGG;IACG,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IA2B5E;;;OAGG;IACG,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAgC3E,mCAAmC;IACnC,OAAO,CAAC,iBAAiB;YAkCX,cAAc;IAiE5B,OAAO,CAAC,WAAW;CAQpB"}