autosnippet 3.0.1 → 3.0.2

package/lib/domain/knowledge/Lifecycle.js

@@ -8,22 +8,20 @@
 
 export const Lifecycle = {
   /** 待审核 */
-  PENDING:       'pending',
+  PENDING: 'pending',
   /** 已发布（可被搜索/Guard/Export 消费） */
-  ACTIVE:        'active',
+  ACTIVE: 'active',
   /** 已弃用 */
-  DEPRECATED:    'deprecated',
+  DEPRECATED: 'deprecated',
 };
 
 /** 候选阶段的所有状态 */
-export const CANDIDATE_STATES = [
-  Lifecycle.PENDING,
-];
+export const CANDIDATE_STATES = [Lifecycle.PENDING];
 
 /** 合法状态转移表 */
 const VALID_TRANSITIONS = {
-  [Lifecycle.PENDING]:    [Lifecycle.ACTIVE, Lifecycle.DEPRECATED],
-  [Lifecycle.ACTIVE]:     [Lifecycle.DEPRECATED],
+  [Lifecycle.PENDING]: [Lifecycle.ACTIVE, Lifecycle.DEPRECATED],
+  [Lifecycle.ACTIVE]: [Lifecycle.DEPRECATED],
   [Lifecycle.DEPRECATED]: [Lifecycle.PENDING],
 };
 
@@ -33,7 +31,9 @@ const VALID_TRANSITIONS = {
  * @returns {string}
  */
 export function normalizeLifecycle(lifecycle) {
-  if (Object.values(Lifecycle).includes(lifecycle)) return lifecycle;
+  if (Object.values(Lifecycle).includes(lifecycle)) {
+    return lifecycle;
+  }
   return Lifecycle.PENDING;
 }
 
@@ -72,20 +72,20 @@ export function isCandidate(lifecycle) {
 /* ── knowledgeType → kind 映射 ── */
 
 const KIND_MAP = {
-  'code-standard':       'rule',
-  'code-style':          'rule',
-  'best-practice':       'rule',
+  'code-standard': 'rule',
+  'code-style': 'rule',
+  'best-practice': 'rule',
   'boundary-constraint': 'rule',
-  'code-pattern':        'pattern',
-  'architecture':        'pattern',
-  'solution':            'pattern',
-  'anti-pattern':        'pattern',
-  'code-relation':       'fact',
-  'inheritance':         'fact',
-  'call-chain':          'fact',
-  'data-flow':           'fact',
-  'module-dependency':   'fact',
-  'dev-document':        'fact',
+  'code-pattern': 'pattern',
+  architecture: 'pattern',
+  solution: 'pattern',
+  'anti-pattern': 'pattern',
+  'code-relation': 'fact',
+  inheritance: 'fact',
+  'call-chain': 'fact',
+  'data-flow': 'fact',
+  'module-dependency': 'fact',
+  'dev-document': 'fact',
 };
 
 /**

package/lib/domain/knowledge/index.js

@@ -4,24 +4,21 @@
 
 // 实体
 export { KnowledgeEntry } from './KnowledgeEntry.js';
-
+// Repository 接口
+export { KnowledgeRepository } from './KnowledgeRepository.js';
 // 生命周期
 export {
-  Lifecycle,
-  isValidTransition,
-  isValidLifecycle,
-  isCandidate,
   CANDIDATE_STATES,
   inferKind,
+  isCandidate,
+  isValidLifecycle,
+  isValidTransition,
+  Lifecycle,
 } from './Lifecycle.js';
-
+export { Constraints } from './values/Constraints.js';
 // 值对象
 export { Content } from './values/Content.js';
-export { Relations, RELATION_BUCKETS } from './values/Relations.js';
-export { Constraints } from './values/Constraints.js';
-export { Reasoning } from './values/Reasoning.js';
 export { Quality } from './values/Quality.js';
+export { Reasoning } from './values/Reasoning.js';
+export { RELATION_BUCKETS, Relations } from './values/Relations.js';
 export { Stats } from './values/Stats.js';
-
-// Repository 接口
-export { KnowledgeRepository } from './KnowledgeRepository.js';

package/lib/domain/knowledge/values/Constraints.js

@@ -7,13 +7,13 @@
 export class Constraints {
   constructor(props = {}) {
     /** @type {Array<Guard>} Guard 规则列表 */
-    this.guards        = (props.guards || []).map(Constraints._normalizeGuard);
+    this.guards = (props.guards || []).map(Constraints._normalizeGuard);
     /** @type {string[]} 边界约束 */
-    this.boundaries    = props.boundaries    || [];
+    this.boundaries = props.boundaries || [];
     /** @type {string[]} 前置条件 */
     this.preconditions = props.preconditions || [];
     /** @type {string[]} 副作用 */
-    this.sideEffects   = props.sideEffects ?? [];
+    this.sideEffects = props.sideEffects ?? [];
   }
 
   /**
@@ -22,10 +22,18 @@ export class Constraints {
    * @returns {Constraints}
    */
   static from(input) {
-    if (input instanceof Constraints) return input;
-    if (!input) return new Constraints();
+    if (input instanceof Constraints) {
+      return input;
+    }
+    if (!input) {
+      return new Constraints();
+    }
     if (typeof input === 'string') {
-      try { input = JSON.parse(input); } catch { return new Constraints(); }
+      try {
+        input = JSON.parse(input);
+      } catch {
+        return new Constraints();
+      }
     }
     return new Constraints(input);
   }
@@ -37,12 +45,12 @@ export class Constraints {
    */
   static _normalizeGuard(g) {
     return {
-      id:             g.id             || null,
-      type:           g.type           || (g.ast_query ? 'ast' : 'regex'),
-      pattern:        g.pattern        || null,
-      ast_query:      g.ast_query      || null,
-      message:        g.message        || '',
-      severity:       g.severity       || 'warning',
+      id: g.id || null,
+      type: g.type || (g.ast_query ? 'ast' : 'regex'),
+      pattern: g.pattern || null,
+      ast_query: g.ast_query || null,
+      message: g.message || '',
+      severity: g.severity || 'warning',
       fix_suggestion: g.fix_suggestion || null,
     };
   }
@@ -52,7 +60,7 @@ export class Constraints {
    * @returns {Array<Guard>}
    */
   getRegexGuards() {
-    return this.guards.filter(g => g.type === 'regex' && g.pattern);
+    return this.guards.filter((g) => g.type === 'regex' && g.pattern);
   }
 
   /**
@@ -60,7 +68,7 @@ export class Constraints {
    * @returns {Array<Guard>}
    */
   getAstGuards() {
-    return this.guards.filter(g => g.type === 'ast' && g.ast_query);
+    return this.guards.filter((g) => g.type === 'ast' && g.ast_query);
   }
 
   /**
@@ -86,10 +94,12 @@ export class Constraints {
    * @returns {boolean}
    */
   isEmpty() {
-    return this.guards.length === 0 &&
-           this.boundaries.length === 0 &&
-           this.preconditions.length === 0 &&
-           this.sideEffects.length === 0;
+    return (
+      this.guards.length === 0 &&
+      this.boundaries.length === 0 &&
+      this.preconditions.length === 0 &&
+      this.sideEffects.length === 0
+    );
   }
 
   /**
@@ -97,10 +107,10 @@ export class Constraints {
    */
   toJSON() {
     return {
-      guards:        this.guards,
-      boundaries:    this.boundaries,
+      guards: this.guards,
+      boundaries: this.boundaries,
       preconditions: this.preconditions,
-      sideEffects:   this.sideEffects,
+      sideEffects: this.sideEffects,
     };
   }
 

package/lib/domain/knowledge/values/Content.js

@@ -7,15 +7,15 @@
 export class Content {
   constructor(props = {}) {
     /** @type {string} 代码片段 */
-    this.pattern      = props.pattern      ?? '';
+    this.pattern = props.pattern ?? '';
     /** @type {string} Markdown 全文（与 pattern 二选一） */
-    this.markdown     = props.markdown     ?? '';
+    this.markdown = props.markdown ?? '';
     /** @type {string} 设计原理 */
-    this.rationale    = props.rationale    ?? '';
+    this.rationale = props.rationale ?? '';
     /** @type {Array<{title?:string, description?:string, code?:string}>} 实施步骤 */
-    this.steps        = props.steps        ?? [];
+    this.steps = props.steps ?? [];
     /** @type {Array<{file:string, before:string, after:string, explanation:string}>} 代码变更 */
-    this.codeChanges  = props.codeChanges ?? [];
+    this.codeChanges = props.codeChanges ?? [];
     /** @type {?{method?:string, expected_result?:string, test_code?:string}} 验证方式 */
     this.verification = props.verification ?? null;
   }
@@ -26,10 +26,18 @@ export class Content {
    * @returns {Content}
    */
   static from(input) {
-    if (input instanceof Content) return input;
-    if (!input) return new Content();
+    if (input instanceof Content) {
+      return input;
+    }
+    if (!input) {
+      return new Content();
+    }
     if (typeof input === 'string') {
-      try { input = JSON.parse(input); } catch { return new Content(); }
+      try {
+        input = JSON.parse(input);
+      } catch {
+        return new Content();
+      }
     }
     return new Content(input);
   }
@@ -47,11 +55,11 @@ export class Content {
    */
   toJSON() {
     return {
-      pattern:      this.pattern,
-      markdown:     this.markdown,
-      rationale:    this.rationale,
-      steps:        this.steps,
-      codeChanges:  this.codeChanges,
+      pattern: this.pattern,
+      markdown: this.markdown,
+      rationale: this.rationale,
+      steps: this.steps,
+      codeChanges: this.codeChanges,
       verification: this.verification,
     };
   }

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

@@ -6,15 +6,15 @@
 export class Quality {
   constructor(props = {}) {
     /** @type {number} 内容完整度 (0-1) */
-    this.completeness   = props.completeness   ?? 0;
+    this.completeness = props.completeness ?? 0;
     /** @type {number} 项目适配度 (0-1) */
-    this.adaptation     = props.adaptation     ?? 0;
+    this.adaptation = props.adaptation ?? 0;
     /** @type {number} 文档清晰度 (0-1) */
-    this.documentation  = props.documentation  ?? 0;
+    this.documentation = props.documentation ?? 0;
     /** @type {number} 综合分 (0-1) */
-    this.overall        = props.overall        ?? 0;
+    this.overall = props.overall ?? 0;
     /** @type {string} 等级 A-F */
-    this.grade          = props.grade          || Quality.calcGrade(this.overall);
+    this.grade = props.grade || Quality.calcGrade(this.overall);
   }
 
   /**
@@ -23,9 +23,15 @@ export class Quality {
    * @returns {Quality}
    */
   static from(input) {
-    if (input instanceof Quality) return input;
+    if (input instanceof Quality) {
+      return input;
+    }
     if (typeof input === 'string') {
-      try { input = JSON.parse(input); } catch { return new Quality(); }
+      try {
+        input = JSON.parse(input);
+      } catch {
+        return new Quality();
+      }
     }
     return new Quality(input || {});
   }
@@ -35,9 +41,8 @@ export class Quality {
    * @returns {Quality}
    */
   recalculate() {
-    this.overall = Math.round(
-      ((this.completeness + this.adaptation + this.documentation) / 3) * 100
-    ) / 100;
+    this.overall =
+      Math.round(((this.completeness + this.adaptation + this.documentation) / 3) * 100) / 100;
     this.grade = Quality.calcGrade(this.overall);
     return this;
   }
@@ -48,10 +53,18 @@ export class Quality {
    * @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';
+    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';
   }
 
@@ -60,11 +73,11 @@ export class Quality {
    */
   toJSON() {
     return {
-      completeness:  this.completeness,
-      adaptation:    this.adaptation,
+      completeness: this.completeness,
+      adaptation: this.adaptation,
       documentation: this.documentation,
-      overall:       this.overall,
-      grade:         this.grade,
+      overall: this.overall,
+      grade: this.grade,
     };
   }
 

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

@@ -4,15 +4,15 @@
 export class Reasoning {
   constructor(props = {}) {
     /** @type {string} 为什么遵循标准 */
-    this.whyStandard    = props.whyStandard ?? '';
+    this.whyStandard = props.whyStandard ?? '';
     /** @type {string[]} 来源列表 */
-    this.sources        = props.sources         || [];
+    this.sources = props.sources || [];
     /** @type {number} 置信度 0-1 */
-    this.confidence     = props.confidence      ?? 0.7;
+    this.confidence = props.confidence ?? 0.7;
     /** @type {Object.<string, number>} 质量信号 */
     this.qualitySignals = props.qualitySignals ?? {};
     /** @type {string[]} 备选方案 */
-    this.alternatives   = props.alternatives    || [];
+    this.alternatives = props.alternatives || [];
   }
 
   /**
@@ -21,10 +21,18 @@ export class Reasoning {
    * @returns {Reasoning}
    */
   static from(input) {
-    if (input instanceof Reasoning) return input;
-    if (!input) return new Reasoning();
+    if (input instanceof Reasoning) {
+      return input;
+    }
+    if (!input) {
+      return new Reasoning();
+    }
     if (typeof input === 'string') {
-      try { input = JSON.parse(input); } catch { return new Reasoning(); }
+      try {
+        input = JSON.parse(input);
+      } catch {
+        return new Reasoning();
+      }
     }
     return new Reasoning(input);
   }
@@ -49,11 +57,11 @@ export class Reasoning {
    */
   toJSON() {
     return {
-      whyStandard:    this.whyStandard,
-      sources:         this.sources,
-      confidence:      this.confidence,
-      qualitySignals:  this.qualitySignals,
-      alternatives:    this.alternatives,
+      whyStandard: this.whyStandard,
+      sources: this.sources,
+      confidence: this.confidence,
+      qualitySignals: this.qualitySignals,
+      alternatives: this.alternatives,
     };
   }
 

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

@@ -7,20 +7,20 @@
 
 /** 所有合法的关系桶名 (snake_case) */
 export const RELATION_BUCKETS = [
-  'inherits',       // 继承
-  'implements',     // 实现接口/协议
-  'calls',          // 调用
-  'depends_on',     // 依赖
-  'data_flow',      // 数据流向
-  'conflicts',      // 冲突
-  'extends',        // 扩展
-  'related',        // 弱关联
-  'alternative',    // 替代方案
-  'prerequisite',   // 前置条件
-  'deprecated_by',  // 被取代
-  'solves',         // 解决问题
-  'enforces',       // 强制约束
-  'references',     // 引用
+  'inherits', // 继承
+  'implements', // 实现接口/协议
+  'calls', // 调用
+  'depends_on', // 依赖
+  'data_flow', // 数据流向
+  'conflicts', // 冲突
+  'extends', // 扩展
+  'related', // 弱关联
+  'alternative', // 替代方案
+  'prerequisite', // 前置条件
+  'deprecated_by', // 被取代
+  'solves', // 解决问题
+  'enforces', // 强制约束
+  'references', // 引用
 ];
 
 export class Relations {
@@ -29,8 +29,8 @@ export class Relations {
     this._b = {};
     for (const k of RELATION_BUCKETS) {
       const vals = buckets[k] || [];
-      this._b[k] = vals.map(r => ({
-        target:      r.target || '',
+      this._b[k] = vals.map((r) => ({
+        target: r.target || '',
         description: r.description || '',
       }));
     }
@@ -42,19 +42,29 @@ export class Relations {
    * @returns {Relations}
    */
   static from(input) {
-    if (input instanceof Relations) return input;
-    if (!input) return new Relations();
+    if (input instanceof Relations) {
+      return input;
+    }
+    if (!input) {
+      return new Relations();
+    }
     if (typeof input === 'string') {
-      try { input = JSON.parse(input); } catch { return new Relations(); }
+      try {
+        input = JSON.parse(input);
+      } catch {
+        return new Relations();
+      }
     }
     if (Array.isArray(input)) {
       // 扁平数组 → 自动分桶
       const buckets = {};
       for (const rel of input) {
         const bucket = rel.type || 'related';
-        if (!buckets[bucket]) buckets[bucket] = [];
+        if (!buckets[bucket]) {
+          buckets[bucket] = [];
+        }
         buckets[bucket].push({
-          target:      rel.target || '',
+          target: rel.target || '',
           description: rel.description || '',
         });
       }
@@ -91,7 +101,7 @@ export class Relations {
    * @returns {boolean}
    */
   isEmpty() {
-    return Object.values(this._b).every(l => l.length === 0);
+    return Object.values(this._b).every((l) => l.length === 0);
   }
 
   /**
@@ -102,8 +112,10 @@ export class Relations {
    * @returns {Relations}
    */
   add(type, target, description = '') {
-    if (!this._b[type]) this._b[type] = [];
-    if (!this._b[type].some(r => r.target === target)) {
+    if (!this._b[type]) {
+      this._b[type] = [];
+    }
+    if (!this._b[type].some((r) => r.target === target)) {
       this._b[type].push({ target, description });
     }
     return this;
@@ -117,7 +129,7 @@ export class Relations {
    */
   remove(type, target) {
     if (this._b[type]) {
-      this._b[type] = this._b[type].filter(r => r.target !== target);
+      this._b[type] = this._b[type].filter((r) => r.target !== target);
     }
     return this;
   }

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

@@ -6,17 +6,17 @@
 export class Stats {
   constructor(props = {}) {
     /** @type {number} 浏览次数 */
-    this.views        = props.views        ?? 0;
+    this.views = props.views ?? 0;
     /** @type {number} 采用次数 */
-    this.adoptions    = props.adoptions    ?? 0;
+    this.adoptions = props.adoptions ?? 0;
     /** @type {number} 应用次数 */
     this.applications = props.applications ?? 0;
     /** @type {number} Guard 命中次数 */
-    this.guardHits    = props.guardHits ?? 0;
+    this.guardHits = props.guardHits ?? 0;
     /** @type {number} 搜索命中次数 */
-    this.searchHits   = props.searchHits ?? 0;
+    this.searchHits = props.searchHits ?? 0;
     /** @type {number} 权威分 0-5 */
-    this.authority    = props.authority    ?? 0;
+    this.authority = props.authority ?? 0;
   }
 
   /**
@@ -25,9 +25,15 @@ export class Stats {
    * @returns {Stats}
    */
   static from(input) {
-    if (input instanceof Stats) return input;
+    if (input instanceof Stats) {
+      return input;
+    }
     if (typeof input === 'string') {
-      try { input = JSON.parse(input); } catch { return new Stats(); }
+      try {
+        input = JSON.parse(input);
+      } catch {
+        return new Stats();
+      }
     }
     return new Stats(input || {});
   }
@@ -50,12 +56,12 @@ export class Stats {
    */
   toJSON() {
     return {
-      views:        this.views,
-      adoptions:    this.adoptions,
+      views: this.views,
+      adoptions: this.adoptions,
       applications: this.applications,
-      guardHits:    this.guardHits,
-      searchHits:   this.searchHits,
-      authority:    this.authority,
+      guardHits: this.guardHits,
+      searchHits: this.searchHits,
+      authority: this.authority,
     };
   }
 

package/lib/domain/knowledge/values/index.js

@@ -1,9 +1,10 @@
 /**
  * 值对象统一导出
  */
-export { Content } from './Content.js';
-export { Relations, RELATION_BUCKETS } from './Relations.js';
+
 export { Constraints } from './Constraints.js';
-export { Reasoning } from './Reasoning.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';