autosnippet 3.2.10 → 3.2.12

package/dist/lib/domain/knowledge/values/Quality.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Quality — 质量值对象
+ *
+ * 4 维度评分 + 综合分 + 等级。
+ */
+interface QualityProps {
+    completeness?: number;
+    adaptation?: number;
+    documentation?: number;
+    overall?: number;
+    grade?: string;
+}
+export declare class Quality {
+    adaptation: number;
+    completeness: number;
+    documentation: number;
+    grade: string;
+    overall: number;
+    constructor(props?: QualityProps);
+    /**
+     * 从任意输入构造 Quality
+     * @param {Quality|Object|null} input
+     * @returns {Quality}
+     */
+    static from(input: unknown): Quality;
+    /**
+     * 从 3 维度计算综合分
+     * @returns {Quality}
+     */
+    recalculate(): this;
+    /**
+     * 根据分数计算等级
+     * @param {number} score 0-1
+     * @returns {string}
+     */
+    static calcGrade(score: number): string;
+    /**
+     * 转换为 wire format JSON
+     */
+    toJSON(): {
+        completeness: number;
+        adaptation: number;
+        documentation: number;
+        overall: number;
+        grade: string;
+    };
+    /**
+     * 从 wire format 创建
+     * @param {Object} data
+     * @returns {Quality}
+     */
+    static fromJSON(data: unknown): Quality;
+}
+export default Quality;
+//# sourceMappingURL=Quality.d.ts.map

package/dist/lib/domain/knowledge/values/Quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Quality.d.ts","sourceRoot":"","sources":["../../../../../lib/domain/knowledge/values/Quality.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,UAAU,YAAY;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,OAAO;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;gBACJ,KAAK,GAAE,YAAiB;IAapC;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAcpC;;;OAGG;IACH,WAAW;IAOX;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAgBvC;;OAEG;IACH,MAAM;;;;;;;IAUN;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO;CAGxC;AAED,eAAe,OAAO,CAAC"}

package/dist/lib/domain/knowledge/values/Quality.js

@@ -0,0 +1,90 @@
+export class Quality {
+    adaptation;
+    completeness;
+    documentation;
+    grade;
+    overall;
+    constructor(props = {}) {
+        /** @type {number} 内容完整度 (0-1) */
+        this.completeness = props.completeness ?? 0;
+        /** @type {number} 项目适配度 (0-1) */
+        this.adaptation = props.adaptation ?? 0;
+        /** @type {number} 文档清晰度 (0-1) */
+        this.documentation = props.documentation ?? 0;
+        /** @type {number} 综合分 (0-1) */
+        this.overall = props.overall ?? 0;
+        /** @type {string} 等级 A-F */
+        this.grade = props.grade || Quality.calcGrade(this.overall);
+    }
+    /**
+     * 从任意输入构造 Quality
+     * @param {Quality|Object|null} input
+     * @returns {Quality}
+     */
+    static from(input) {
+        if (input instanceof Quality) {
+            return input;
+        }
+        if (typeof input === 'string') {
+            try {
+                input = JSON.parse(input);
+            }
+            catch {
+                return new Quality();
+            }
+        }
+        return new Quality((input || {}));
+    }
+    /**
+     * 从 3 维度计算综合分
+     * @returns {Quality}
+     */
+    recalculate() {
+        this.overall =
+            Math.round(((this.completeness + this.adaptation + this.documentation) / 3) * 100) / 100;
+        this.grade = Quality.calcGrade(this.overall);
+        return this;
+    }
+    /**
+     * 根据分数计算等级
+     * @param {number} score 0-1
+     * @returns {string}
+     */
+    static calcGrade(score) {
+        if (score >= 0.9) {
+            return 'A';
+        }
+        if (score >= 0.75) {
+            return 'B';
+        }
+        if (score >= 0.6) {
+            return 'C';
+        }
+        if (score >= 0.4) {
+            return 'D';
+        }
+        return 'F';
+    }
+    /**
+     * 转换为 wire format JSON
+     */
+    toJSON() {
+        return {
+            completeness: this.completeness,
+            adaptation: this.adaptation,
+            documentation: this.documentation,
+            overall: this.overall,
+            grade: this.grade,
+        };
+    }
+    /**
+     * 从 wire format 创建
+     * @param {Object} data
+     * @returns {Quality}
+     */
+    static fromJSON(data) {
+        return Quality.from(data);
+    }
+}
+export default Quality;
+//# sourceMappingURL=Quality.js.map

package/dist/lib/domain/knowledge/values/Quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Quality.js","sourceRoot":"","sources":["../../../../../lib/domain/knowledge/values/Quality.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,OAAO;IAClB,UAAU,CAAS;IACnB,YAAY,CAAS;IACrB,aAAa,CAAS;IACtB,KAAK,CAAS;IACd,OAAO,CAAS;IAChB,YAAY,QAAsB,EAAE;QAClC,iCAAiC;QACjC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAC5C,iCAAiC;QACjC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACxC,iCAAiC;QACjC,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;QAC9C,+BAA+B;QAC/B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAClC,4BAA4B;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAc;QACxB,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,OAAO,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAiB,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,CAAC,OAAO;YACV,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC3F,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,KAAa;QAC5B,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAa;QAC3B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,eAAe,OAAO,CAAC"}

package/dist/lib/domain/knowledge/values/Reasoning.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Reasoning — 推理值对象
+ */
+interface ReasoningProps {
+    whyStandard?: string;
+    sources?: string[];
+    confidence?: number;
+    qualitySignals?: Record<string, number>;
+    alternatives?: string[];
+}
+export declare class Reasoning {
+    alternatives: string[];
+    confidence: number;
+    qualitySignals: Record<string, number>;
+    sources: string[];
+    whyStandard: string;
+    constructor(props?: ReasoningProps);
+    /**
+     * 从任意输入构造 Reasoning
+     * @param {Reasoning|Object|null} input
+     * @returns {Reasoning}
+     */
+    static from(input: unknown): Reasoning;
+    /**
+     * 验证推理信息的完整性
+     * @returns {boolean}
+     */
+    isValid(): boolean;
+    /**
+     * 转换为 JSON
+     */
+    toJSON(): {
+        whyStandard: string;
+        sources: string[];
+        confidence: number;
+        qualitySignals: Record<string, number>;
+        alternatives: string[];
+    };
+    /**
+     * 从 wire format 创建
+     * @param {Object} data
+     * @returns {Reasoning}
+     */
+    static fromJSON(data: unknown): Reasoning;
+}
+export default Reasoning;
+//# sourceMappingURL=Reasoning.d.ts.map

package/dist/lib/domain/knowledge/values/Reasoning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reasoning.d.ts","sourceRoot":"","sources":["../../../../../lib/domain/knowledge/values/Reasoning.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,UAAU,cAAc;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,SAAS;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;gBACR,KAAK,GAAE,cAAmB;IAatC;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS;IAiBtC;;;OAGG;IACH,OAAO;IAWP;;OAEG;IACH,MAAM;;;;;;;IAUN;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS;CAG1C;AAED,eAAe,SAAS,CAAC"}

package/dist/lib/domain/knowledge/values/Reasoning.js

@@ -0,0 +1,75 @@
+export class Reasoning {
+    alternatives;
+    confidence;
+    qualitySignals;
+    sources;
+    whyStandard;
+    constructor(props = {}) {
+        /** @type {string} 为什么遵循标准 */
+        this.whyStandard = props.whyStandard ?? '';
+        /** @type {string[]} 来源列表 */
+        this.sources = props.sources || [];
+        /** @type {number} 置信度 0-1 */
+        this.confidence = props.confidence ?? 0.7;
+        /** @type {Object.<string, number>} 质量信号 */
+        this.qualitySignals = props.qualitySignals ?? {};
+        /** @type {string[]} 备选方案 */
+        this.alternatives = props.alternatives || [];
+    }
+    /**
+     * 从任意输入构造 Reasoning
+     * @param {Reasoning|Object|null} input
+     * @returns {Reasoning}
+     */
+    static from(input) {
+        if (input instanceof Reasoning) {
+            return input;
+        }
+        if (!input) {
+            return new Reasoning();
+        }
+        if (typeof input === 'string') {
+            try {
+                input = JSON.parse(input);
+            }
+            catch {
+                return new Reasoning();
+            }
+        }
+        return new Reasoning(input);
+    }
+    /**
+     * 验证推理信息的完整性
+     * @returns {boolean}
+     */
+    isValid() {
+        return !!(this.whyStandard?.trim() &&
+            Array.isArray(this.sources) &&
+            this.sources.length > 0 &&
+            typeof this.confidence === 'number' &&
+            this.confidence >= 0 &&
+            this.confidence <= 1);
+    }
+    /**
+     * 转换为 JSON
+     */
+    toJSON() {
+        return {
+            whyStandard: this.whyStandard,
+            sources: this.sources,
+            confidence: this.confidence,
+            qualitySignals: this.qualitySignals,
+            alternatives: this.alternatives,
+        };
+    }
+    /**
+     * 从 wire format 创建
+     * @param {Object} data
+     * @returns {Reasoning}
+     */
+    static fromJSON(data) {
+        return new Reasoning(data);
+    }
+}
+export default Reasoning;
+//# sourceMappingURL=Reasoning.js.map

package/dist/lib/domain/knowledge/values/Reasoning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reasoning.js","sourceRoot":"","sources":["../../../../../lib/domain/knowledge/values/Reasoning.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,SAAS;IACpB,YAAY,CAAW;IACvB,UAAU,CAAS;IACnB,cAAc,CAAyB;IACvC,OAAO,CAAW;IAClB,WAAW,CAAS;IACpB,YAAY,QAAwB,EAAE;QACpC,6BAA6B;QAC7B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QAC3C,4BAA4B;QAC5B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QACnC,6BAA6B;QAC7B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC;QAC1C,2CAA2C;QAC3C,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC;QACjD,4BAA4B;QAC5B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAc;QACxB,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,SAAS,EAAE,CAAC;QACzB,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,SAAS,EAAE,CAAC;YACzB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,SAAS,CAAC,KAAuB,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,CAAC,CAAC,CACP,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE;YACxB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACvB,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;YACnC,IAAI,CAAC,UAAU,IAAI,CAAC;YACpB,IAAI,CAAC,UAAU,IAAI,CAAC,CACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAa;QAC3B,OAAO,IAAI,SAAS,CAAC,IAAsB,CAAC,CAAC;IAC/C,CAAC;CACF;AAED,eAAe,SAAS,CAAC"}

package/dist/lib/domain/knowledge/values/Relations.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Relations — 关系图值对象
+ *
+ * 统一为分桶结构（非扁平数组）。
+ * 每个桶存储 [{ target, description }] 格式的关系列表。
+ */
+/** 所有合法的关系桶名 (snake_case) */
+export declare const RELATION_BUCKETS: string[];
+export interface RelationEntry {
+    target: string;
+    description: string;
+}
+type RelationBuckets = Record<string, Array<string | Partial<RelationEntry>>>;
+export declare class Relations {
+    _b: Record<string, RelationEntry[]>;
+    constructor(buckets?: RelationBuckets);
+    /**
+     * 从任意输入构造 Relations
+     * @param {Relations|Array|Object|null} input
+     * @returns {Relations}
+     */
+    static from(input: unknown): Relations;
+    /**
+     * 扁平视图（仅 Dashboard 渲染用）
+     * @returns {Array<{type:string, target:string, description:string}>}
+     */
+    toFlatArray(): Array<{
+        type: string;
+        target: string;
+        description: string;
+    }>;
+    /**
+     * 获取指定桶
+     * @param {string} type
+     * @returns {Array<{target:string, description:string}>}
+     */
+    getByType(type: string): RelationEntry[];
+    /**
+     * 是否为空
+     * @returns {boolean}
+     */
+    isEmpty(): boolean;
+    /**
+     * 添加关系
+     * @param {string} type 桶名
+     * @param {string} target 目标
+     * @param {string} description
+     * @returns {Relations}
+     */
+    add(type: string, target: string, description?: string): Relations;
+    /**
+     * 移除关系
+     * @param {string} type 桶名
+     * @param {string} target 目标
+     * @returns {Relations}
+     */
+    remove(type: string, target: string): Relations;
+    /**
+     * 转换为 wire format JSON (分桶)
+     */
+    toJSON(): {
+        [x: string]: RelationEntry[];
+    };
+    /**
+     * 从 wire format 创建
+     * @param {Object|Array} data
+     * @returns {Relations}
+     */
+    static fromJSON(data: unknown): Relations;
+}
+export default Relations;
+//# sourceMappingURL=Relations.d.ts.map

package/dist/lib/domain/knowledge/values/Relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Relations.d.ts","sourceRoot":"","sources":["../../../../../lib/domain/knowledge/values/Relations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6BAA6B;AAC7B,eAAO,MAAM,gBAAgB,UAe5B,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AAE9E,qBAAa,SAAS;IACpB,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;gBACxB,OAAO,GAAE,eAAoB;IAiBzC;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS;IAiCtC;;;OAGG;IACH,WAAW,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAU3E;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAIxC;;;OAGG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,SAAK,GAAG,SAAS;IAU9D;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS;IAO/C;;OAEG;IACH,MAAM;;;IAIN;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS;CAG1C;AAED,eAAe,SAAS,CAAC"}

package/dist/lib/domain/knowledge/values/Relations.js

@@ -0,0 +1,152 @@
+/**
+ * Relations — 关系图值对象
+ *
+ * 统一为分桶结构（非扁平数组）。
+ * 每个桶存储 [{ target, description }] 格式的关系列表。
+ */
+/** 所有合法的关系桶名 (snake_case) */
+export const RELATION_BUCKETS = [
+    'inherits', // 继承
+    'implements', // 实现接口/协议
+    'calls', // 调用
+    'depends_on', // 依赖
+    'data_flow', // 数据流向
+    'conflicts', // 冲突
+    'extends', // 扩展
+    'related', // 弱关联
+    'alternative', // 替代方案
+    'prerequisite', // 前置条件
+    'deprecated_by', // 被取代
+    'solves', // 解决问题
+    'enforces', // 强制约束
+    'references', // 引用
+];
+export class Relations {
+    _b;
+    constructor(buckets = {}) {
+        /** @type {Object.<string, Array<{target:string, description:string}>>} */
+        this._b = {};
+        for (const k of RELATION_BUCKETS) {
+            const vals = buckets[k] || [];
+            this._b[k] = vals
+                .map((r) => {
+                // 兼容字符串数组：AI prompt 可能返回 ["recipeName"] 而非 [{target,description}]
+                if (typeof r === 'string') {
+                    return r.trim() ? { target: r.trim(), description: '' } : null;
+                }
+                return { target: r.target || '', description: r.description || '' };
+            })
+                .filter((entry) => entry !== null);
+        }
+    }
+    /**
+     * 从任意输入构造 Relations
+     * @param {Relations|Array|Object|null} input
+     * @returns {Relations}
+     */
+    static from(input) {
+        if (input instanceof Relations) {
+            return input;
+        }
+        if (!input) {
+            return new Relations();
+        }
+        if (typeof input === 'string') {
+            try {
+                input = JSON.parse(input);
+            }
+            catch {
+                return new Relations();
+            }
+        }
+        if (Array.isArray(input)) {
+            // 扁平数组 → 自动分桶
+            const buckets = {};
+            for (const rel of input) {
+                const item = rel;
+                const bucket = item.type || 'related';
+                if (!buckets[bucket]) {
+                    buckets[bucket] = [];
+                }
+                buckets[bucket].push({
+                    target: item.target || '',
+                    description: item.description || '',
+                });
+            }
+            return new Relations(buckets);
+        }
+        return new Relations(input);
+    }
+    /**
+     * 扁平视图（仅 Dashboard 渲染用）
+     * @returns {Array<{type:string, target:string, description:string}>}
+     */
+    toFlatArray() {
+        const result = [];
+        for (const [type, list] of Object.entries(this._b)) {
+            for (const r of list) {
+                result.push({ type, ...r });
+            }
+        }
+        return result;
+    }
+    /**
+     * 获取指定桶
+     * @param {string} type
+     * @returns {Array<{target:string, description:string}>}
+     */
+    getByType(type) {
+        return this._b[type] || [];
+    }
+    /**
+     * 是否为空
+     * @returns {boolean}
+     */
+    isEmpty() {
+        return Object.values(this._b).every((l) => l.length === 0);
+    }
+    /**
+     * 添加关系
+     * @param {string} type 桶名
+     * @param {string} target 目标
+     * @param {string} description
+     * @returns {Relations}
+     */
+    add(type, target, description = '') {
+        if (!this._b[type]) {
+            this._b[type] = [];
+        }
+        if (!this._b[type].some((r) => r.target === target)) {
+            this._b[type].push({ target, description });
+        }
+        return this;
+    }
+    /**
+     * 移除关系
+     * @param {string} type 桶名
+     * @param {string} target 目标
+     * @returns {Relations}
+     */
+    remove(type, target) {
+        if (this._b[type]) {
+            this._b[type] = this._b[type].filter((r) => r.target !== target);
+        }
+        return this;
+    }
+    /**
+     * 转换为 wire format JSON (分桶)
+     */
+    toJSON() {
+        return { ...this._b };
+    }
+    /**
+     * 从 wire format 创建
+     * @param {Object|Array} data
+     * @returns {Relations}
+     */
+    static fromJSON(data) {
+        return Relations.from(data);
+    }
+}
+export default Relations;
+//# sourceMappingURL=Relations.js.map

package/dist/lib/domain/knowledge/values/Relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Relations.js","sourceRoot":"","sources":["../../../../../lib/domain/knowledge/values/Relations.ts"],"names":[],"mappings":"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"}

package/dist/lib/domain/knowledge/values/Stats.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Stats — 统计值对象
+ *
+ * 记录知识条目的使用统计：浏览、采用、应用、Guard 命中、搜索命中、权威分。
+ */
+type StatsCounter = 'views' | 'adoptions' | 'applications' | 'guardHits' | 'searchHits';
+interface StatsProps {
+    views?: number;
+    adoptions?: number;
+    applications?: number;
+    guardHits?: number;
+    searchHits?: number;
+    authority?: number;
+}
+export declare class Stats {
+    adoptions: number;
+    applications: number;
+    authority: number;
+    guardHits: number;
+    searchHits: number;
+    views: number;
+    constructor(props?: StatsProps);
+    /**
+     * 从任意输入构造 Stats
+     * @param {Stats|Object|null} input
+     * @returns {Stats}
+     */
+    static from(input: unknown): Stats;
+    /**
+     * 增加计数
+     * @param {'views'|'adoptions'|'applications'|'guardHits'|'searchHits'} counter
+     * @param {number} delta
+     * @returns {Stats}
+     */
+    increment(counter: StatsCounter, delta?: number): Stats;
+    /**
+     * 转换为 JSON
+     */
+    toJSON(): {
+        views: number;
+        adoptions: number;
+        applications: number;
+        guardHits: number;
+        searchHits: number;
+        authority: number;
+    };
+    /**
+     * 从 wire format 创建
+     * @param {Object} data
+     * @returns {Stats}
+     */
+    static fromJSON(data: unknown): Stats;
+}
+export default Stats;
+//# sourceMappingURL=Stats.d.ts.map

package/dist/lib/domain/knowledge/values/Stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stats.d.ts","sourceRoot":"","sources":["../../../../../lib/domain/knowledge/values/Stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,KAAK,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,cAAc,GAAG,WAAW,GAAG,YAAY,CAAC;AAExF,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,KAAK;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;gBACF,KAAK,GAAE,UAAe;IAelC;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;IAclC;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,SAAI,GAAG,KAAK;IAKlD;;OAEG;IACH,MAAM;;;;;;;;IAWN;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK;CAGtC;AAED,eAAe,KAAK,CAAC"}

package/dist/lib/domain/knowledge/values/Stats.js

@@ -0,0 +1,74 @@
+export class Stats {
+    adoptions;
+    applications;
+    authority;
+    guardHits;
+    searchHits;
+    views;
+    constructor(props = {}) {
+        /** @type {number} 浏览次数 */
+        this.views = props.views ?? 0;
+        /** @type {number} 采用次数 */
+        this.adoptions = props.adoptions ?? 0;
+        /** @type {number} 应用次数 */
+        this.applications = props.applications ?? 0;
+        /** @type {number} Guard 命中次数 */
+        this.guardHits = props.guardHits ?? 0;
+        /** @type {number} 搜索命中次数 */
+        this.searchHits = props.searchHits ?? 0;
+        /** @type {number} 权威分 0-5 */
+        this.authority = props.authority ?? 0;
+    }
+    /**
+     * 从任意输入构造 Stats
+     * @param {Stats|Object|null} input
+     * @returns {Stats}
+     */
+    static from(input) {
+        if (input instanceof Stats) {
+            return input;
+        }
+        if (typeof input === 'string') {
+            try {
+                input = JSON.parse(input);
+            }
+            catch {
+                return new Stats();
+            }
+        }
+        return new Stats((input || {}));
+    }
+    /**
+     * 增加计数
+     * @param {'views'|'adoptions'|'applications'|'guardHits'|'searchHits'} counter
+     * @param {number} delta
+     * @returns {Stats}
+     */
+    increment(counter, delta = 1) {
+        this[counter] += delta;
+        return this;
+    }
+    /**
+     * 转换为 JSON
+     */
+    toJSON() {
+        return {
+            views: this.views,
+            adoptions: this.adoptions,
+            applications: this.applications,
+            guardHits: this.guardHits,
+            searchHits: this.searchHits,
+            authority: this.authority,
+        };
+    }
+    /**
+     * 从 wire format 创建
+     * @param {Object} data
+     * @returns {Stats}
+     */
+    static fromJSON(data) {
+        return Stats.from(data);
+    }
+}
+export default Stats;
+//# sourceMappingURL=Stats.js.map

package/dist/lib/domain/knowledge/values/Stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stats.js","sourceRoot":"","sources":["../../../../../lib/domain/knowledge/values/Stats.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,KAAK;IAChB,SAAS,CAAS;IAClB,YAAY,CAAS;IACrB,SAAS,CAAS;IAClB,SAAS,CAAS;IAClB,UAAU,CAAS;IACnB,KAAK,CAAS;IACd,YAAY,QAAoB,EAAE;QAChC,0BAA0B;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9B,0BAA0B;QAC1B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;QACtC,0BAA0B;QAC1B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAC5C,gCAAgC;QAChC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;QACtC,4BAA4B;QAC5B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;QACxC,6BAA6B;QAC7B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,KAAc;QACxB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAe,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAqB,EAAE,KAAK,GAAG,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAa;QAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED,eAAe,KAAK,CAAC"}

package/dist/lib/domain/knowledge/values/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 值对象统一导出
+ */
+export { Constraints } from './Constraints.js';
+export { Content } from './Content.js';
+export { Quality } from './Quality.js';
+export { Reasoning } from './Reasoning.js';
+export { RELATION_BUCKETS, Relations } from './Relations.js';
+export { Stats } from './Stats.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/domain/knowledge/values/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/domain/knowledge/values/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}