autosnippet/dist/lib/core/constitution/Constitution.js

Extract code patterns into a knowledge base for AI coding assistants

import fs from 'node:fs';
import yaml from 'js-yaml';
import { ConstitutionSchema } from '../../shared/schemas/config.js';
/** Constitution - 宪法加载与管理 */
export class Constitution {
    priorities;
    roles;
    rules;
    config;
    configPath;
    constructor(configPath) {
        this.configPath = configPath;
        this.config = this.loadConfig();
        this.priorities = this.config.priorities || [];
        this.rules = this.config.rules || [];
        this.roles = new Map(this.config.roles?.map((r) => [r.id, r]) || []);
    }
    /** 加载宪法配置 */
    loadConfig() {
        if (!fs.existsSync(this.configPath)) {
            throw new Error(`Constitution file not found: ${this.configPath}`);
        }
        const content = fs.readFileSync(this.configPath, 'utf8');
        const raw = yaml.load(content);
        // Zod 运行时校验
        const result = ConstitutionSchema.safeParse(raw);
        if (!result.success) {
            const issues = result.error.issues
                .map((i) => `  ${i.path.join('.')}: ${i.message}`)
                .join('\n');
            process.stderr.write(`[Constitution] ⚠️ Validation warnings:\n${issues}\n`);
        }
        return raw;
    }
    /** 获取所有优先级 */
    getPriorities() {
        return this.priorities;
    }
    /** 获取所有数据守护规则 */
    getRules() {
        return this.rules;
    }
    /** 获取能力定义 */
    getCapabilities() {
        return this.config.capabilities || {};
    }
    /** 获取角色需要的能力列表 */
    getRoleRequiredCapabilities(roleId) {
        const role = this.getRole(roleId);
        return role ? role.requires_capability || [] : [];
    }
    /** 获取特定优先级 */
    getPriority(id) {
        return this.priorities.find((p) => p.id === id);
    }
    /** 获取角色定义 */
    getRole(roleId) {
        return this.roles.get(roleId);
    }
    /** 获取角色权限 */
    getRolePermissions(roleId) {
        const role = this.getRole(roleId);
        return role ? role.permissions : [];
    }
    /** 获取角色约束 */
    getRoleConstraints(roleId) {
        const role = this.getRole(roleId);
        return role ? role.constraints : [];
    }
    /** 获取所有角色 */
    getAllRoles() {
        return Array.from(this.roles.values());
    }
    /** 验证角色是否存在 */
    hasRole(roleId) {
        return this.roles.has(roleId);
    }
    /** 重新加载宪法（热更新） */
    reload() {
        this.config = this.loadConfig();
        this.priorities = this.config.priorities || [];
        this.rules = this.config.rules || [];
        this.roles = new Map(this.config.roles?.map((r) => [r.id, r]) || []);
    }
    /** 导出宪法摘要 */
    toJSON() {
        return {
            version: this.config.version,
            effectiveDate: this.config.effective_date,
            priorities: this.priorities,
            rules: this.rules.map((r) => ({
                id: r.id,
                description: r.description,
            })),
            roles: Array.from(this.roles.values()).map((r) => ({
                id: r.id,
                name: r.name,
                description: r.description,
            })),
        };
    }
}
export default Constitution;