autosnippet 3.2.16 → 3.2.18

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

@@ -19,11 +19,7 @@ export class Content {
         /** @type {?{method?:string, expected_result?:string, test_code?:string}} 验证方式 */
         this.verification = props.verification ?? null;
     }
-    /**
-     * 从任意输入构造 Content
-     * @param {Content|Object|null} input
-     * @returns {Content}
-     */
+    /** 从任意输入构造 Content */
     static from(input) {
         if (input instanceof Content) {
             return input;
@@ -41,16 +37,11 @@ export class Content {
         }
         return new Content(input);
     }
-    /**
-     * 是否包含有效内容
-     * @returns {boolean}
-     */
+    /** 是否包含有效内容 */
     hasContent() {
         return !!(this.pattern || this.markdown || this.rationale || this.steps.length > 0);
     }
-    /**
-     * 转换为 wire format JSON
-     */
+    /** 转换为 wire format JSON */
     toJSON() {
         return {
             pattern: this.pattern,
@@ -61,14 +52,9 @@ export class Content {
             verification: this.verification,
         };
     }
-    /**
-     * 从 wire format 创建
-     * @param {Object} data
-     * @returns {Content}
-     */
+    /** 从 wire format 创建 */
     static fromJSON(data) {
         return new Content(data);
     }
 }
 export default Content;
-//# sourceMappingURL=Content.js.map

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

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

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

@@ -16,11 +16,7 @@ export class Quality {
         /** @type {string} 等级 A-F */
         this.grade = props.grade || Quality.calcGrade(this.overall);
     }
-    /**
-     * 从任意输入构造 Quality
-     * @param {Quality|Object|null} input
-     * @returns {Quality}
-     */
+    /** 从任意输入构造 Quality */
     static from(input) {
         if (input instanceof Quality) {
             return input;
@@ -35,10 +31,7 @@ export class Quality {
         }
         return new Quality((input || {}));
     }
-    /**
-     * 从 3 维度计算综合分
-     * @returns {Quality}
-     */
+    /** 从 3 维度计算综合分 */
     recalculate() {
         this.overall =
             Math.round(((this.completeness + this.adaptation + this.documentation) / 3) * 100) / 100;
@@ -47,8 +40,7 @@ export class Quality {
     }
     /**
      * 根据分数计算等级
-     * @param {number} score 0-1
-     * @returns {string}
+     * @param score 0-1
      */
     static calcGrade(score) {
         if (score >= 0.9) {
@@ -65,9 +57,7 @@ export class Quality {
         }
         return 'F';
     }
-    /**
-     * 转换为 wire format JSON
-     */
+    /** 转换为 wire format JSON */
     toJSON() {
         return {
             completeness: this.completeness,
@@ -77,14 +67,9 @@ export class Quality {
             grade: this.grade,
         };
     }
-    /**
-     * 从 wire format 创建
-     * @param {Object} data
-     * @returns {Quality}
-     */
+    /** 从 wire format 创建 */
     static fromJSON(data) {
         return Quality.from(data);
     }
 }
 export default Quality;
-//# sourceMappingURL=Quality.js.map

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

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

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

@@ -16,11 +16,7 @@ export class Reasoning {
         /** @type {string[]} 备选方案 */
         this.alternatives = props.alternatives || [];
     }
-    /**
-     * 从任意输入构造 Reasoning
-     * @param {Reasoning|Object|null} input
-     * @returns {Reasoning}
-     */
+    /** 从任意输入构造 Reasoning */
     static from(input) {
         if (input instanceof Reasoning) {
             return input;
@@ -38,10 +34,7 @@ export class Reasoning {
         }
         return new Reasoning(input);
     }
-    /**
-     * 验证推理信息的完整性
-     * @returns {boolean}
-     */
+    /** 验证推理信息的完整性 */
     isValid() {
         return !!(this.whyStandard?.trim() &&
             Array.isArray(this.sources) &&
@@ -50,9 +43,7 @@ export class Reasoning {
             this.confidence >= 0 &&
             this.confidence <= 1);
     }
-    /**
-     * 转换为 JSON
-     */
+    /** 转换为 JSON */
     toJSON() {
         return {
             whyStandard: this.whyStandard,
@@ -62,14 +53,9 @@ export class Reasoning {
             alternatives: this.alternatives,
         };
     }
-    /**
-     * 从 wire format 创建
-     * @param {Object} data
-     * @returns {Reasoning}
-     */
+    /** 从 wire format 创建 */
     static fromJSON(data) {
         return new Reasoning(data);
     }
 }
 export default Reasoning;
-//# sourceMappingURL=Reasoning.js.map

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

@@ -14,15 +14,11 @@ 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}
-     */
+    /** 从任意输入构造 Relations */
     static from(input: unknown): Relations;
     /**
      * 扁平视图（仅 Dashboard 渲染用）
-     * @returns {Array<{type:string, target:string, description:string}>}
+     * @returns >}
      */
     toFlatArray(): Array<{
         type: string;
@@ -31,42 +27,28 @@ export declare class Relations {
     }>;
     /**
      * 获取指定桶
-     * @param {string} type
-     * @returns {Array<{target:string, description:string}>}
+     * @returns >}
      */
     getByType(type: string): RelationEntry[];
-    /**
-     * 是否为空
-     * @returns {boolean}
-     */
+    /** 是否为空 */
     isEmpty(): boolean;
     /**
      * 添加关系
-     * @param {string} type 桶名
-     * @param {string} target 目标
-     * @param {string} description
-     * @returns {Relations}
+     * @param type 桶名
+     * @param target 目标
      */
     add(type: string, target: string, description?: string): Relations;
     /**
      * 移除关系
-     * @param {string} type 桶名
-     * @param {string} target 目标
-     * @returns {Relations}
+     * @param type 桶名
+     * @param target 目标
      */
     remove(type: string, target: string): Relations;
-    /**
-     * 转换为 wire format JSON (分桶)
-     */
+    /** 转换为 wire format JSON (分桶) */
     toJSON(): {
         [x: string]: RelationEntry[];
     };
-    /**
-     * 从 wire format 创建
-     * @param {Object|Array} data
-     * @returns {Relations}
-     */
+    /** 从 wire format 创建 */
     static fromJSON(data: unknown): Relations;
 }
 export default Relations;
-//# sourceMappingURL=Relations.d.ts.map

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

@@ -39,11 +39,7 @@ export class Relations {
                 .filter((entry) => entry !== null);
         }
     }
-    /**
-     * 从任意输入构造 Relations
-     * @param {Relations|Array|Object|null} input
-     * @returns {Relations}
-     */
+    /** 从任意输入构造 Relations */
     static from(input) {
         if (input instanceof Relations) {
             return input;
@@ -79,7 +75,7 @@ export class Relations {
     }
     /**
      * 扁平视图（仅 Dashboard 渲染用）
-     * @returns {Array<{type:string, target:string, description:string}>}
+     * @returns >}
      */
     toFlatArray() {
         const result = [];
@@ -92,25 +88,19 @@ export class Relations {
     }
     /**
      * 获取指定桶
-     * @param {string} type
-     * @returns {Array<{target:string, description:string}>}
+     * @returns >}
      */
     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}
+     * @param type 桶名
+     * @param target 目标
      */
     add(type, target, description = '') {
         if (!this._b[type]) {
@@ -123,9 +113,8 @@ export class Relations {
     }
     /**
      * 移除关系
-     * @param {string} type 桶名
-     * @param {string} target 目标
-     * @returns {Relations}
+     * @param type 桶名
+     * @param target 目标
      */
     remove(type, target) {
         if (this._b[type]) {
@@ -133,20 +122,13 @@ export class Relations {
         }
         return this;
     }
-    /**
-     * 转换为 wire format JSON (分桶)
-     */
+    /** 转换为 wire format JSON (分桶) */
     toJSON() {
         return { ...this._b };
     }
-    /**
-     * 从 wire format 创建
-     * @param {Object|Array} data
-     * @returns {Relations}
-     */
+    /** 从 wire format 创建 */
     static fromJSON(data) {
         return Relations.from(data);
     }
 }
 export default Relations;
-//# sourceMappingURL=Relations.js.map

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

@@ -20,22 +20,11 @@ export declare class Stats {
     searchHits: number;
     views: number;
     constructor(props?: StatsProps);
-    /**
-     * 从任意输入构造 Stats
-     * @param {Stats|Object|null} input
-     * @returns {Stats}
-     */
+    /** 从任意输入构造 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
-     */
+    /** 转换为 JSON */
     toJSON(): {
         views: number;
         adoptions: number;
@@ -44,12 +33,7 @@ export declare class Stats {
         searchHits: number;
         authority: number;
     };
-    /**
-     * 从 wire format 创建
-     * @param {Object} data
-     * @returns {Stats}
-     */
+    /** 从 wire format 创建 */
     static fromJSON(data: unknown): Stats;
 }
 export default Stats;
-//# sourceMappingURL=Stats.d.ts.map

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

@@ -19,11 +19,7 @@ export class Stats {
         /** @type {number} 权威分 0-5 */
         this.authority = props.authority ?? 0;
     }
-    /**
-     * 从任意输入构造 Stats
-     * @param {Stats|Object|null} input
-     * @returns {Stats}
-     */
+    /** 从任意输入构造 Stats */
     static from(input) {
         if (input instanceof Stats) {
             return input;
@@ -38,19 +34,12 @@ export class 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
-     */
+    /** 转换为 JSON */
     toJSON() {
         return {
             views: this.views,
@@ -61,14 +50,9 @@ export class Stats {
             authority: this.authority,
         };
     }
-    /**
-     * 从 wire format 创建
-     * @param {Object} data
-     * @returns {Stats}
-     */
+    /** 从 wire format 创建 */
     static fromJSON(data) {
         return Stats.from(data);
     }
 }
 export default Stats;
-//# sourceMappingURL=Stats.js.map

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

@@ -1,10 +1,7 @@
-/**
- * 值对象统一导出
- */
+/** 值对象统一导出 */
 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.js

@@ -1,10 +1,7 @@
-/**
- * 值对象统一导出
- */
+/** 值对象统一导出 */
 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.js.map

package/dist/lib/domain/snippet/Snippet.d.ts

@@ -50,21 +50,14 @@ export declare class Snippet {
     constructor(props: SnippetProps);
     /**
      * 是否已安装到指定 IDE (不传则检查任意)
-     * @param {string} [target] - 'xcode' | 'vscode'
+     * @param [target] 'xcode' | 'vscode'
      */
     isInstalled(target?: string): boolean;
-    /**
-     * 获取指定 IDE 的安装路径
-     * @param {string} target
-     */
+    /** 获取指定 IDE 的安装路径 */
     getInstalledPath(target: string): string | null;
-    /**
-     * 验证 Snippet 完整性
-     */
+    /** 验证 Snippet 完整性 */
     isValid(): boolean | "";
-    /**
-     * 转换为 JSON（前端 / API 返回格式）
-     */
+    /** 转换为 JSON（前端 / API 返回格式） */
     toJSON(): {
         id: string;
         identifier: string;
@@ -86,10 +79,7 @@ export declare class Snippet {
         createdAt: number;
         updatedAt: number;
     };
-    /**
-     * 从 JSON 创建 Snippet
-     */
+    /** 从 JSON 创建 Snippet */
     static fromJSON(data: SnippetProps): Snippet;
 }
 export default Snippet;
-//# sourceMappingURL=Snippet.d.ts.map

package/dist/lib/domain/snippet/Snippet.js

@@ -49,7 +49,7 @@ export class Snippet {
     }
     /**
      * 是否已安装到指定 IDE (不传则检查任意)
-     * @param {string} [target] - 'xcode' | 'vscode'
+     * @param [target] 'xcode' | 'vscode'
      */
     isInstalled(target) {
         if (target) {
@@ -57,16 +57,11 @@ export class Snippet {
         }
         return Object.values(this.targets).some((t) => t?.installed);
     }
-    /**
-     * 获取指定 IDE 的安装路径
-     * @param {string} target
-     */
+    /** 获取指定 IDE 的安装路径 */
     getInstalledPath(target) {
         return this.targets[target]?.path || null;
     }
-    /**
-     * 验证 Snippet 完整性
-     */
+    /** 验证 Snippet 完整性 */
     isValid() {
         return (this.identifier &&
             this.identifier.trim().length > 0 &&
@@ -75,9 +70,7 @@ export class Snippet {
             this.code &&
             this.code.trim().length > 0);
     }
-    /**
-     * 转换为 JSON（前端 / API 返回格式）
-     */
+    /** 转换为 JSON（前端 / API 返回格式） */
     toJSON() {
         return {
             id: this.id,
@@ -99,12 +92,9 @@ export class Snippet {
             updatedAt: this.updatedAt,
         };
     }
-    /**
-     * 从 JSON 创建 Snippet
-     */
+    /** 从 JSON 创建 Snippet */
     static fromJSON(data) {
         return new Snippet(data);
     }
 }
 export default Snippet;
-//# sourceMappingURL=Snippet.js.map

package/dist/lib/domain/task/Task.d.ts

@@ -108,9 +108,7 @@ export declare class Task {
      */
     computeContentHash(): string;
     validate(): boolean;
-    /**
-     * 是否有效（快捷校验）
-     */
+    /** 是否有效（快捷校验） */
     isValid(): boolean;
     toJSON(): {
         knowledgeContext?: Record<string, unknown> | undefined;
@@ -136,10 +134,7 @@ export declare class Task {
         metadata: Record<string, unknown>;
     };
     static fromJSON(data: unknown): Task;
-    /**
-     * 从数据库行构造 Task（snake_case → camelCase）
-     */
+    /** 从数据库行构造 Task（snake_case → camelCase） */
     static fromRow(row: TaskRow | null): Task | null;
 }
 export default Task;
-//# sourceMappingURL=Task.d.ts.map

package/dist/lib/domain/task/Task.js

@@ -169,9 +169,7 @@ export class Task {
         }
         return true;
     }
-    /**
-     * 是否有效（快捷校验）
-     */
+    /** 是否有效（快捷校验） */
     isValid() {
         try {
             this.validate();
@@ -212,9 +210,7 @@ export class Task {
         }
         return new Task(data);
     }
-    /**
-     * 从数据库行构造 Task（snake_case → camelCase）
-     */
+    /** 从数据库行构造 Task（snake_case → camelCase） */
     static fromRow(row) {
         if (!row) {
             return null;
@@ -256,4 +252,3 @@ export class Task {
     }
 }
 export default Task;
-//# sourceMappingURL=Task.js.map

package/dist/lib/domain/task/TaskDependency.d.ts

@@ -16,17 +16,8 @@ export declare const DepType: Readonly<{
     KNOWLEDGE_REF: "knowledge-ref";
     SUPERSEDES: "supersedes";
 }>;
-/**
- * 判断依赖类型是否影响就绪计算
- * @param {string} depType
- * @returns {boolean}
- */
+/** 判断依赖类型是否影响就绪计算 */
 export declare function affectsReadyWork(depType: string): boolean;
-/**
- * 判断依赖类型是否合法
- * @param {string} depType
- * @returns {boolean}
- */
+/** 判断依赖类型是否合法 */
 export declare function isValidDepType(depType: string): boolean;
 export default DepType;
-//# sourceMappingURL=TaskDependency.d.ts.map