@winspan/claude-forge 0.1.1

package/dist/convention/convention-evolver.js

@@ -0,0 +1,175 @@
+import fs from 'fs';
+import path from 'path';
+import yaml from 'js-yaml';
+import { logger } from '../utils/logger.js';
+/**
+ * ConventionEvolver：从 Pattern 执行历史分析规范违反情况，用 AI 优化 Convention。
+ *
+ * 只优化 principles 和 quality_standards，不改变 roles 结构（角色是稳定契约）。
+ * 进化触发条件：手动调用 evolve()，或 auto_optimize=true 时由 SkillEvolver 定期触发。
+ */
+export class ConventionEvolver {
+    api;
+    storage;
+    loader;
+    constructor(api, storage, loader) {
+        this.api = api;
+        this.storage = storage;
+        this.loader = loader;
+    }
+    /**
+     * 对指定 Convention 执行一次进化分析。
+     * 返回 null 表示无需进化（数据不足或 AI 判断无需修改）。
+     */
+    async evolve(convention) {
+        const violations = this.analyzeViolations(convention.id);
+        if (violations.length === 0) {
+            logger.info(`[规范进化器] ${convention.id} 无违反记录，跳过`);
+            return null;
+        }
+        logger.info(`[规范进化器] ${convention.id} 发现 ${violations.length} 处违反，开始 AI 分析`);
+        const optimized = await this.optimizeWithAI(convention, violations);
+        if (!optimized)
+            return null;
+        const previousVersion = convention.version;
+        const newVersion = this.bumpVersion(previousVersion);
+        const updated = { ...convention, ...optimized, version: newVersion, filePath: convention.filePath };
+        this.loader.saveConvention(updated);
+        logger.info(`[规范进化器] ${convention.id} 进化完成：v${previousVersion} → v${newVersion}`);
+        return {
+            conventionId: convention.id,
+            previousVersion,
+            newVersion,
+            changes: optimized.changes ?? [],
+        };
+    }
+    /**
+     * 对所有项目的 custom 规范执行进化。
+     * 源规范（非 custom- 前缀）不参与进化，由 distill 负责更新。
+     */
+    async evolveAll(projectPaths) {
+        const results = [];
+        const paths = projectPaths ?? [];
+        // 若未指定项目路径，只处理全局目录中 custom- 开头的规范（兜底）
+        const globalCustom = this.loader.loadAll().filter((c) => c.id.startsWith('custom-'));
+        const targets = [...globalCustom];
+        // 从指定项目路径加载 custom 规范
+        for (const projectPath of paths) {
+            const filePath = path.join(projectPath, '.claude-forge', 'custom-convention.yaml');
+            if (fs.existsSync(filePath)) {
+                const c = this.loader.loadFile(filePath);
+                if (c && !targets.find((t) => t.id === c.id))
+                    targets.push(c);
+            }
+        }
+        for (const convention of targets) {
+            if (!convention.evolution?.auto_optimize)
+                continue;
+            try {
+                const result = await this.evolve(convention);
+                if (result)
+                    results.push(result);
+            }
+            catch (err) {
+                logger.warn(`[规范进化器] ${convention.id} 进化失败：${err}`);
+            }
+        }
+        return results;
+    }
+    // ── 私有方法 ──────────────────────────────────────────────────────────────
+    /** 从 SQLite events 分析 gate 失败情况 */
+    analyzeViolations(conventionId) {
+        try {
+            const rows = this.storage.queryEvents({
+                limit: 200,
+            });
+            // 从 PostToolUse 事件中提取 gate 失败信息（tool_output 含 failed/gate 关键词）
+            const violationMap = new Map();
+            for (const row of rows) {
+                if (row.hook_type !== 'PostToolUse')
+                    continue;
+                const outputStr = row.tool_output ? JSON.stringify(row.tool_output) : '';
+                const aiStr = row.ai_response ?? '';
+                if (!outputStr.includes('failed') && !outputStr.includes('gate') &&
+                    !aiStr.includes('failed') && !aiStr.includes('gate'))
+                    continue;
+                const key = `${row.project_path}:${row.tool_name ?? 'unknown'}`;
+                const existing = violationMap.get(key) ?? {
+                    patternId: 'unknown',
+                    phaseId: row.tool_name ?? 'unknown',
+                    failCount: 0,
+                    totalCount: 0,
+                };
+                existing.failCount++;
+                existing.totalCount++;
+                violationMap.set(key, existing);
+            }
+            return Array.from(violationMap.values()).filter((v) => v.failCount > 0);
+        }
+        catch {
+            return [];
+        }
+    }
+    async optimizeWithAI(convention, violations) {
+        const violationText = violations
+            .map((v) => `- Pattern ${v.patternId} / 阶段 ${v.phaseId}：失败 ${v.failCount}/${v.totalCount} 次`)
+            .join('\n');
+        const currentYaml = yaml.dump({
+            principles: convention.principles,
+            quality_standards: convention.quality_standards,
+        }, { lineWidth: 120 });
+        const prompt = `你是一个工程规范优化专家。根据执行历史中的违反情况，优化以下规范的原则和质量标准。
+
+## 规范信息
+名称：${convention.name} (${convention.id}) v${convention.version}
+描述：${convention.description}
+
+## 当前规范内容
+\`\`\`yaml
+${currentYaml}
+\`\`\`
+
+## 执行历史中的违反情况
+${violationText}
+
+## 优化任务
+1. 分析违反情况，判断是规范描述不清晰还是标准过于严格
+2. 优化 principles（使原则更清晰、可执行）
+3. 调整 quality_standards（降低不合理的 must 约束，或补充缺失的约束）
+4. 不得修改 roles 结构（角色是稳定契约）
+
+## 输出格式（严格 JSON）
+{
+  "principles": "优化后的 principles 文本",
+  "quality_standards": [...优化后的质量标准数组...],
+  "changes": ["变更说明1", "变更说明2"]
+}
+
+如果无需修改，返回 {"changes": []}`;
+        try {
+            const response = await this.api.complete(prompt, 'convention-evolver', 0, 60_000);
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (!jsonMatch)
+                return null;
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (!parsed.changes?.length) {
+                logger.info(`[规范进化器] AI 判断 ${convention.id} 无需修改`);
+                return null;
+            }
+            return parsed;
+        }
+        catch (err) {
+            logger.warn(`[规范进化器] AI 优化失败：${err}`);
+            return null;
+        }
+    }
+    bumpVersion(version) {
+        const parts = version.split('.');
+        if (parts.length >= 2) {
+            const minor = parseFloat(parts[1] ?? '0') + 1;
+            return `${parts[0]}.${minor.toFixed(1).replace('.0', '')}`;
+        }
+        return version + '.1';
+    }
+}
+//# sourceMappingURL=convention-evolver.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { Convention } from './types.js';
+export declare const CONVENTIONS_DIR: string;
+export declare class ConventionLoader {
+    private conventionsDir;
+    constructor(conventionsDir?: string);
+    /** 加载目录下所有 .yaml/.yml Convention 文件 */
+    loadAll(): Convention[];
+    /** 加载并验证单个 Convention 文件 */
+    loadFile(filePath: string): Convention | null;
+    /** 按 ID 查找 Convention */
+    findById(id: string): Convention | null;
+    /**
+     * 从 URL 或本地路径安装 Convention
+     * 下载/复制 YAML 到 conventions 目录
+     */
+    installFromUrl(urlOrPath: string): Promise<Convention>;
+    /** 将 Convention 写回 YAML 文件（供 ConventionEvolver 调用） */
+    saveConvention(convention: Convention): void;
+    getConventionsDir(): string;
+    private downloadUrl;
+}
+//# sourceMappingURL=convention-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convention-loader.d.ts","sourceRoot":"","sources":["../../src/convention/convention-loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,eAAe,QAA0D,CAAC;AAoCvF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAAS;gBAEnB,cAAc,GAAE,MAAwB;IAIpD,uCAAuC;IACvC,OAAO,IAAI,UAAU,EAAE;IAoBvB,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAkB7C,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIvC;;;OAGG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA8B5D,sDAAsD;IACtD,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAY5C,iBAAiB,IAAI,MAAM;IAI3B,OAAO,CAAC,WAAW;CAepB"}

package/dist/convention/convention-loader.js

@@ -0,0 +1,139 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import https from 'https';
+import http from 'http';
+import yaml from 'js-yaml';
+import { z } from 'zod';
+import { logger } from '../utils/logger.js';
+export const CONVENTIONS_DIR = path.join(os.homedir(), '.claude-forge', 'conventions');
+// ── Zod Schema ───────────────────────────────────────────────────────────────
+const ConventionRoleSchema = z.object({
+    name: z.string(),
+    responsibilities: z.string(),
+    constraints: z.string(),
+});
+const QualityStandardSchema = z.object({
+    category: z.string(),
+    rule: z.string(),
+    severity: z.enum(['must', 'should', 'may']),
+});
+const ConventionEvolutionSchema = z.object({
+    auto_optimize: z.boolean().default(true),
+    optimize_interval_days: z.number().int().positive().default(14),
+});
+const ConventionSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    version: z.string(),
+    description: z.string(),
+    source: z.enum(['official', 'user', 'community']).default('user'),
+    principles: z.string(),
+    active_prompt: z.string(),
+    roles: z.record(z.string(), ConventionRoleSchema).default({}),
+    quality_standards: z.array(QualityStandardSchema).default([]),
+    evolution: ConventionEvolutionSchema.optional(),
+});
+// ── ConventionLoader ──────────────────────────────────────────────────────────
+export class ConventionLoader {
+    conventionsDir;
+    constructor(conventionsDir = CONVENTIONS_DIR) {
+        this.conventionsDir = conventionsDir;
+    }
+    /** 加载目录下所有 .yaml/.yml Convention 文件 */
+    loadAll() {
+        if (!fs.existsSync(this.conventionsDir)) {
+            return [];
+        }
+        const files = fs.readdirSync(this.conventionsDir).filter((f) => f.endsWith('.yaml') || f.endsWith('.yml'));
+        const conventions = [];
+        for (const file of files) {
+            const filePath = path.join(this.conventionsDir, file);
+            const convention = this.loadFile(filePath);
+            if (convention)
+                conventions.push(convention);
+        }
+        logger.info(`[规范加载器] 已加载 ${conventions.length} 个 Convention`);
+        return conventions;
+    }
+    /** 加载并验证单个 Convention 文件 */
+    loadFile(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const raw = yaml.load(content);
+            const result = ConventionSchema.safeParse(raw);
+            if (!result.success) {
+                logger.warn(`[规范加载器] 校验失败 ${filePath}：${result.error.message}`);
+                return null;
+            }
+            return { ...result.data, filePath };
+        }
+        catch (err) {
+            logger.warn(`[规范加载器] 解析失败 ${filePath}：${err}`);
+            return null;
+        }
+    }
+    /** 按 ID 查找 Convention */
+    findById(id) {
+        return this.loadAll().find((c) => c.id === id) ?? null;
+    }
+    /**
+     * 从 URL 或本地路径安装 Convention
+     * 下载/复制 YAML 到 conventions 目录
+     */
+    async installFromUrl(urlOrPath) {
+        let content;
+        if (urlOrPath.startsWith('http://') || urlOrPath.startsWith('https://')) {
+            content = await this.downloadUrl(urlOrPath);
+        }
+        else {
+            if (!fs.existsSync(urlOrPath)) {
+                throw new Error(`文件不存在：${urlOrPath}`);
+            }
+            content = fs.readFileSync(urlOrPath, 'utf-8');
+        }
+        const raw = yaml.load(content);
+        const result = ConventionSchema.safeParse(raw);
+        if (!result.success) {
+            throw new Error(`Convention 格式无效：${result.error.message}`);
+        }
+        const convention = result.data;
+        if (!fs.existsSync(this.conventionsDir)) {
+            fs.mkdirSync(this.conventionsDir, { recursive: true });
+        }
+        const destPath = path.join(this.conventionsDir, `${convention.id}.yaml`);
+        fs.writeFileSync(destPath, content, 'utf-8');
+        logger.info(`[规范加载器] 已安装 Convention：${convention.id} → ${destPath}`);
+        return { ...convention, filePath: destPath };
+    }
+    /** 将 Convention 写回 YAML 文件（供 ConventionEvolver 调用） */
+    saveConvention(convention) {
+        if (!fs.existsSync(this.conventionsDir)) {
+            fs.mkdirSync(this.conventionsDir, { recursive: true });
+        }
+        const filePath = convention.filePath ?? path.join(this.conventionsDir, `${convention.id}.yaml`);
+        const { filePath: _fp, ...serializable } = convention;
+        const content = yaml.dump(serializable, { lineWidth: 120, noRefs: true });
+        fs.writeFileSync(filePath, content, 'utf-8');
+        logger.info(`[规范加载器] 已保存 ${convention.id} v${convention.version}`);
+    }
+    getConventionsDir() {
+        return this.conventionsDir;
+    }
+    downloadUrl(url) {
+        return new Promise((resolve, reject) => {
+            const client = url.startsWith('https://') ? https : http;
+            client.get(url, (res) => {
+                if (res.statusCode !== 200) {
+                    reject(new Error(`HTTP ${res.statusCode}：${url}`));
+                    return;
+                }
+                const chunks = [];
+                res.on('data', (chunk) => chunks.push(chunk));
+                res.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+                res.on('error', reject);
+            }).on('error', reject);
+        });
+    }
+}
+//# sourceMappingURL=convention-loader.js.map

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

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

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

@@ -0,0 +1,46 @@
+import { ConventionLoader } from './convention-loader.js';
+import type { Convention } from './types.js';
+export declare class ConventionManager {
+    private loader;
+    constructor(loader?: ConventionLoader);
+    /**
+     * 绑定规范到项目：
+     * 1. 验证 Convention 存在
+     * 2. 写入 project-conventions.json
+     * 3. 把 principles 注入 CLAUDE.md
+     */
+    bind(projectPath: string, conventionId: string): Convention;
+    /**
+     * 解绑规范：
+     * 1. 从 project-conventions.json 移除
+     * 2. 从 CLAUDE.md 移除对应节
+     * 不传 id 则解绑全部
+     */
+    unbind(projectPath: string, conventionId?: string): void;
+    /** 获取项目绑定的所有 Convention（已加载完整对象）。custom- 前缀的 ID 从项目本地加载 */
+    getActiveConventions(projectPath: string): Convention[];
+    /** 加载项目本地的自定义蒸馏规范（若存在） */
+    loadProjectCustomConvention(projectPath: string): Convention | null;
+    /**
+     * 绑定自定义规范到项目（跳过 findById 验证，直接写 bindings + 注入 CLAUDE.md）
+     * 用于 ConventionDistiller 蒸馏完成后自动绑定。
+     * 同时解绑所有源规范（非 custom- 前缀），custom 规范已包含其精华。
+     */
+    bindCustomConvention(projectPath: string, convention: Convention): void;
+    /**
+     * 返回所有绑定规范的 active_prompt 拼接（供每条消息注入，priority=0）
+     * 多个规范时加编号前缀，保持简洁
+     */
+    getActivePrompt(projectPath: string): string | null;
+    /**
+     * 把 Convention.principles 写入 CLAUDE.md 的专属区块。
+     * 使用 <!-- forge:convention-start:{id} --> 标记，与 claudemd-auto 区块并列。
+     * 若 CLAUDE.md 不存在则创建。
+     */
+    injectIntoClaudeMd(projectPath: string, convention: Convention): void;
+    private getBindingsPath;
+    private readBindings;
+    private writeBindings;
+    private removeFromClaudeMd;
+}
+//# sourceMappingURL=convention-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convention-manager.d.ts","sourceRoot":"","sources":["../../src/convention/convention-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,YAAY,CAAC;AASvE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,CAAC,EAAE,gBAAgB;IAMrC;;;;;OAKG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,UAAU;IAwB3D;;;;;OAKG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAcxD,2DAA2D;IAC3D,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,EAAE;IAmBvD,0BAA0B;IAC1B,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAMnE;;;;OAIG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAyBvE;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAYnD;;;;OAIG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAkCrE,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,kBAAkB;CAe3B"}

package/dist/convention/convention-manager.js

@@ -0,0 +1,193 @@
+import fs from 'fs';
+import path from 'path';
+import { logger } from '../utils/logger.js';
+import { ConventionLoader } from './convention-loader.js';
+import { ConventionDistiller } from './convention-distiller.js';
+const BINDINGS_FILE = 'project-conventions.json';
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export class ConventionManager {
+    loader;
+    constructor(loader) {
+        this.loader = loader ?? new ConventionLoader();
+    }
+    // ── 绑定管理 ──────────────────────────────────────────────────────────────
+    /**
+     * 绑定规范到项目：
+     * 1. 验证 Convention 存在
+     * 2. 写入 project-conventions.json
+     * 3. 把 principles 注入 CLAUDE.md
+     */
+    bind(projectPath, conventionId) {
+        const convention = this.loader.findById(conventionId);
+        if (!convention) {
+            throw new Error(`Convention "${conventionId}" 不存在，请先用 cf convention add 安装`);
+        }
+        const bindings = this.readBindings(projectPath);
+        if (bindings.some((b) => b.convention_id === conventionId)) {
+            logger.info(`[规范管理器] ${conventionId} 已绑定到 ${projectPath}，跳过`);
+            return convention;
+        }
+        bindings.push({
+            convention_id: conventionId,
+            bound_at: new Date().toISOString(),
+            project_path: projectPath,
+        });
+        this.writeBindings(projectPath, bindings);
+        this.injectIntoClaudeMd(projectPath, convention);
+        logger.info(`[规范管理器] 已绑定 ${conventionId} 到 ${projectPath}`);
+        return convention;
+    }
+    /**
+     * 解绑规范：
+     * 1. 从 project-conventions.json 移除
+     * 2. 从 CLAUDE.md 移除对应节
+     * 不传 id 则解绑全部
+     */
+    unbind(projectPath, conventionId) {
+        const bindings = this.readBindings(projectPath);
+        if (conventionId) {
+            this.writeBindings(projectPath, bindings.filter((b) => b.convention_id !== conventionId));
+            this.removeFromClaudeMd(projectPath, conventionId);
+            logger.info(`[规范管理器] 已解绑 ${conventionId} from ${projectPath}`);
+        }
+        else {
+            for (const b of bindings)
+                this.removeFromClaudeMd(projectPath, b.convention_id);
+            this.writeBindings(projectPath, []);
+            logger.info(`[规范管理器] 已解绑全部规范 from ${projectPath}`);
+        }
+    }
+    /** 获取项目绑定的所有 Convention（已加载完整对象）。custom- 前缀的 ID 从项目本地加载 */
+    getActiveConventions(projectPath) {
+        const bindings = this.readBindings(projectPath);
+        const result = [];
+        for (const binding of bindings) {
+            let convention = this.loader.findById(binding.convention_id);
+            if (!convention && binding.convention_id.startsWith('custom-')) {
+                convention = this.loadProjectCustomConvention(projectPath);
+            }
+            if (convention) {
+                result.push(convention);
+            }
+            else {
+                logger.warn(`[规范管理器] 绑定的 Convention "${binding.convention_id}" 文件不存在，跳过`);
+            }
+        }
+        return result;
+    }
+    /** 加载项目本地的自定义蒸馏规范（若存在） */
+    loadProjectCustomConvention(projectPath) {
+        const filePath = ConventionDistiller.customFilePath(projectPath);
+        if (!fs.existsSync(filePath))
+            return null;
+        return this.loader.loadFile(filePath);
+    }
+    /**
+     * 绑定自定义规范到项目（跳过 findById 验证，直接写 bindings + 注入 CLAUDE.md）
+     * 用于 ConventionDistiller 蒸馏完成后自动绑定。
+     * 同时解绑所有源规范（非 custom- 前缀），custom 规范已包含其精华。
+     */
+    bindCustomConvention(projectPath, convention) {
+        const bindings = this.readBindings(projectPath);
+        // 解绑所有源规范，并从 CLAUDE.md 移除对应区块
+        for (const b of bindings) {
+            if (!b.convention_id.startsWith('custom-')) {
+                this.removeFromClaudeMd(projectPath, b.convention_id);
+            }
+        }
+        const customBinding = {
+            convention_id: convention.id,
+            bound_at: new Date().toISOString(),
+            project_path: projectPath,
+        };
+        // 只保留 custom- 绑定
+        const filtered = bindings.filter((b) => b.convention_id.startsWith('custom-') && b.convention_id !== convention.id);
+        filtered.push(customBinding);
+        this.writeBindings(projectPath, filtered);
+        this.injectIntoClaudeMd(projectPath, convention);
+        logger.info(`[规范管理器] 已绑定自定义规范 ${convention.id} 到 ${projectPath}，源规范已解绑`);
+    }
+    /**
+     * 返回所有绑定规范的 active_prompt 拼接（供每条消息注入，priority=0）
+     * 多个规范时加编号前缀，保持简洁
+     */
+    getActivePrompt(projectPath) {
+        const conventions = this.getActiveConventions(projectPath);
+        if (conventions.length === 0)
+            return null;
+        const prompts = conventions.map((c) => c.active_prompt.trim()).filter(Boolean);
+        if (prompts.length === 0)
+            return null;
+        return prompts.length === 1
+            ? prompts[0]
+            : prompts.map((p, i) => `[规范${i + 1}] ${p}`).join('\n');
+    }
+    /**
+     * 把 Convention.principles 写入 CLAUDE.md 的专属区块。
+     * 使用 <!-- forge:convention-start:{id} --> 标记，与 claudemd-auto 区块并列。
+     * 若 CLAUDE.md 不存在则创建。
+     */
+    injectIntoClaudeMd(projectPath, convention) {
+        const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
+        const startTag = `<!-- forge:convention-start:${convention.id} -->`;
+        const endTag = `<!-- forge:convention-end:${convention.id} -->`;
+        const block = [
+            startTag,
+            `## 项目规范约束：${convention.name} (v${convention.version})`,
+            '',
+            convention.principles.trim(),
+            '',
+            endTag,
+        ].join('\n');
+        let current = fs.existsSync(claudeMdPath)
+            ? fs.readFileSync(claudeMdPath, 'utf-8')
+            : '';
+        if (current.includes(startTag)) {
+            // 替换已有区块（版本升级时更新）
+            const regex = new RegExp(`${escapeRegex(startTag)}[\\s\\S]*?${escapeRegex(endTag)}`);
+            current = current.replace(regex, block);
+        }
+        else {
+            current = current.trimEnd() + (current ? '\n\n' : '') + block + '\n';
+        }
+        fs.writeFileSync(claudeMdPath, current, 'utf-8');
+        logger.info(`[规范管理器] 已将 ${convention.id} principles 注入 CLAUDE.md`);
+    }
+    // ── 私有方法 ──────────────────────────────────────────────────────────────
+    getBindingsPath(projectPath) {
+        return path.join(projectPath, '.claude-forge', BINDINGS_FILE);
+    }
+    readBindings(projectPath) {
+        const bindingsPath = this.getBindingsPath(projectPath);
+        if (!fs.existsSync(bindingsPath))
+            return [];
+        try {
+            return JSON.parse(fs.readFileSync(bindingsPath, 'utf-8'));
+        }
+        catch {
+            return [];
+        }
+    }
+    writeBindings(projectPath, bindings) {
+        const bindingsPath = this.getBindingsPath(projectPath);
+        const dir = path.dirname(bindingsPath);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(bindingsPath, JSON.stringify(bindings, null, 2), 'utf-8');
+    }
+    removeFromClaudeMd(projectPath, conventionId) {
+        const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
+        if (!fs.existsSync(claudeMdPath))
+            return;
+        const startTag = `<!-- forge:convention-start:${conventionId} -->`;
+        const endTag = `<!-- forge:convention-end:${conventionId} -->`;
+        let content = fs.readFileSync(claudeMdPath, 'utf-8');
+        const regex = new RegExp(`\\n?${escapeRegex(startTag)}[\\s\\S]*?${escapeRegex(endTag)}\\n?`);
+        content = content.replace(regex, '\n').trimEnd() + '\n';
+        fs.writeFileSync(claudeMdPath, content, 'utf-8');
+        logger.info(`[规范管理器] 已从 CLAUDE.md 移除 ${conventionId} 区块`);
+    }
+}
+//# sourceMappingURL=convention-manager.js.map

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

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

package/dist/convention/index.d.ts

@@ -0,0 +1,6 @@
+export { ConventionLoader, CONVENTIONS_DIR } from './convention-loader.js';
+export { ConventionManager } from './convention-manager.js';
+export { ConventionEvolver } from './convention-evolver.js';
+export { ConventionDistiller } from './convention-distiller.js';
+export type { Convention, ConventionRole, QualityStandard, QualitySeverity, ConventionSource, ConventionEvolution, ProjectConventionBinding, ConventionEvolveResult, ConventionDistillResult, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/convention/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/convention/index.js

@@ -0,0 +1,5 @@
+export { ConventionLoader, CONVENTIONS_DIR } from './convention-loader.js';
+export { ConventionManager } from './convention-manager.js';
+export { ConventionEvolver } from './convention-evolver.js';
+export { ConventionDistiller } from './convention-distiller.js';
+//# sourceMappingURL=index.js.map

package/dist/convention/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/convention/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}