autosnippet 3.2.16 → 3.2.17

package/dist/lib/core/gateway/Gateway.js

@@ -30,18 +30,14 @@ export class Gateway extends EventEmitter {
         this.auditLogger = null;
         this.eventBus = null; // 可选：外部注入 EventBus 实例
     }
-    /**
-     * 设置依赖
-     */
+    /** 设置依赖 */
     setDependencies({ constitution, constitutionValidator, permissionManager, auditLogger, }) {
         this.constitution = constitution ?? null;
         this.constitutionValidator = constitutionValidator ?? null;
         this.permissionManager = permissionManager ?? null;
         this.auditLogger = auditLogger ?? null;
     }
-    /**
-     * 注册路由处理器
-     */
+    /** 注册路由处理器 */
     register(action, handler) {
         if (this.routes.has(action)) {
             throw new Error(`Action '${action}' is already registered`);
@@ -49,15 +45,11 @@ export class Gateway extends EventEmitter {
         this.routes.set(action, handler);
         this.logger.debug(`Route registered: ${action}`);
     }
-    /**
-     * 获取已注册的 action 列表
-     */
+    /** 获取已注册的 action 列表 */
     getRegisteredActions() {
         return [...this.routes.keys()];
     }
-    /**
-     * 执行操作（主入口）
-     */
+    /** 执行操作（主入口） */
     async execute(request) {
         const requestId = uuidv4();
         const startTime = Date.now();
@@ -164,9 +156,7 @@ export class Gateway extends EventEmitter {
         }
     }
     // ─── Pipeline Steps ────────────────────────────────────
-    /**
-     * validate — 验证请求格式
-     */
+    /** validate — 验证请求格式 */
     validateRequest(request) {
         if (!request.actor) {
             throw new InternalError('Missing required field: actor');
@@ -175,9 +165,7 @@ export class Gateway extends EventEmitter {
             throw new InternalError('Missing required field: action');
         }
     }
-    /**
-     * guard — 权限检查 + 宪法验证
-     */
+    /** guard — 权限检查 + 宪法验证 */
     async guard(context) {
         // 权限检查
         if (this.permissionManager) {
@@ -193,9 +181,7 @@ export class Gateway extends EventEmitter {
             });
         }
     }
-    /**
-     * route — 路由到处理器
-     */
+    /** route — 路由到处理器 */
     async routeToHandler(context) {
         const handler = this.routes.get(context.action);
         if (!handler) {
@@ -203,9 +189,7 @@ export class Gateway extends EventEmitter {
         }
         return await handler(context);
     }
-    /**
-     * audit — 记录成功
-     */
+    /** audit — 记录成功 */
     async auditSuccess(context, result) {
         if (!this.auditLogger) {
             return;
@@ -226,9 +210,7 @@ export class Gateway extends EventEmitter {
             this.eventBus.emit('gateway:action:completed', { ...entry, timestamp: Date.now() });
         }
     }
-    /**
-     * audit — 记录失败
-     */
+    /** audit — 记录失败 */
     async auditFailure(context, error) {
         if (!this.auditLogger) {
             return;
@@ -250,12 +232,9 @@ export class Gateway extends EventEmitter {
             this.eventBus.emit('gateway:action:failed', { ...entry, timestamp: Date.now() });
         }
     }
-    /**
-     * 获取所有注册的路由
-     */
+    /** 获取所有注册的路由 */
     getRoutes() {
         return Array.from(this.routes.keys());
     }
 }
 export default Gateway;
-//# sourceMappingURL=Gateway.js.map

package/dist/lib/core/gateway/GatewayActionRegistry.d.ts

@@ -7,11 +7,7 @@
  * - GatewayActionRegistry 将 action 路由到正确的 Service 方法
  */
 import type { Gateway } from './Gateway.js';
-/**
- * 注册所有 Gateway actions
- * @param {import('./Gateway.js').Gateway} gateway
- * @param {import('../../injection/ServiceContainer.js').ServiceContainer} container
- */
+/** 注册所有 Gateway actions */
 export declare function registerGatewayActions(gateway: Gateway, container: {
     get(name: string): any;
 }): void;
@@ -32,4 +28,3 @@ export declare function buildGatewayRequest(req: {
     };
     session: string | undefined;
 };
-//# sourceMappingURL=GatewayActionRegistry.d.ts.map

package/dist/lib/core/gateway/GatewayActionRegistry.js

@@ -8,11 +8,7 @@
  */
 import Logger from '../../infrastructure/logging/Logger.js';
 const logger = Logger.getInstance();
-/**
- * 注册所有 Gateway actions
- * @param {import('./Gateway.js').Gateway} gateway
- * @param {import('../../injection/ServiceContainer.js').ServiceContainer} container
- */
+/** 注册所有 Gateway actions */
 export function registerGatewayActions(gateway, container) {
     // ========== Knowledge Actions (V3: replaces Candidate + Recipe) ==========
     gateway.register('candidate:create', async (ctx) => {
@@ -192,4 +188,3 @@ export function buildGatewayRequest(req, action, resource, data = {}) {
         session: req.headers['x-session-id'],
     };
 }
-//# sourceMappingURL=GatewayActionRegistry.js.map

package/dist/lib/core/permission/PermissionManager.d.ts

@@ -17,9 +17,7 @@ export declare class PermissionManager {
     constitution: Constitution;
     logger: ReturnType<typeof Logger.getInstance>;
     constructor(constitution: Constitution);
-    /**
-     * 检查权限（3-tuple: actor, action, resource）
-     */
+    /** 检查权限（3-tuple: actor, action, resource） */
     check(actor: string, action: string, resource: string | undefined): PermissionCheckResult;
     /**
      * 规范化 action 名称
@@ -29,9 +27,7 @@ export declare class PermissionManager {
      * - perm_external_agent_read_recipes -> read:recipes（测试使用的格式）
      */
     _normalizeAction(action: string): string;
-    /**
-     * 检查特殊权限
-     */
+    /** 检查特殊权限 */
     checkSpecialPermissions(actor: string, action: string, resource: string | undefined, permissions: string[]): boolean;
     /**
      * 从资源路径提取资源类型
@@ -40,24 +36,15 @@ export declare class PermissionManager {
      *      { type: 'recipes', id: '123' } → recipes
      */
     getResourceType(resource: string | Record<string, unknown> | undefined): string;
-    /**
-     * 强制权限检查（失败时抛异常）
-     */
+    /** 强制权限检查（失败时抛异常） */
     enforce(actor: string, action: string, resource: string | undefined): boolean;
-    /**
-     * 批量检查权限
-     */
+    /** 批量检查权限 */
     checkMultiple(checks: PermissionCheck[]): Array<PermissionCheck & {
         result: PermissionCheckResult;
     }>;
-    /**
-     * 获取角色的所有权限
-     */
+    /** 获取角色的所有权限 */
     getRolePermissions(actor: string): string[];
-    /**
-     * 获取角色的约束条件
-     */
+    /** 获取角色的约束条件 */
     getRoleConstraints(actor: string): string[];
 }
 export default PermissionManager;
-//# sourceMappingURL=PermissionManager.d.ts.map

package/dist/lib/core/permission/PermissionManager.js

@@ -11,9 +11,7 @@ export class PermissionManager {
         this.constitution = constitution;
         this.logger = Logger.getInstance();
     }
-    /**
-     * 检查权限（3-tuple: actor, action, resource）
-     */
+    /** 检查权限（3-tuple: actor, action, resource） */
     check(actor, action, resource) {
         // 获取角色定义
         const role = this.constitution.getRole(actor);
@@ -137,9 +135,7 @@ export class PermissionManager {
         // create_candidate -> create:candidate
         return action.replace('_', ':');
     }
-    /**
-     * 检查特殊权限
-     */
+    /** 检查特殊权限 */
     checkSpecialPermissions(actor, action, resource, permissions) {
         // 例如：read:audit_logs:self - 只能读自己的审计日志
         if (action === 'read' && resource?.startsWith('/audit_logs')) {
@@ -175,9 +171,7 @@ export class PermissionManager {
         }
         return 'unknown';
     }
-    /**
-     * 强制权限检查（失败时抛异常）
-     */
+    /** 强制权限检查（失败时抛异常） */
     enforce(actor, action, resource) {
         const result = this.check(actor, action, resource);
         if (!result.allowed) {
@@ -191,9 +185,7 @@ export class PermissionManager {
         }
         return true;
     }
-    /**
-     * 批量检查权限
-     */
+    /** 批量检查权限 */
     checkMultiple(checks) {
         return checks.map(({ actor, action, resource }) => ({
             actor,
@@ -202,20 +194,15 @@ export class PermissionManager {
             result: this.check(actor, action, resource),
         }));
     }
-    /**
-     * 获取角色的所有权限
-     */
+    /** 获取角色的所有权限 */
     getRolePermissions(actor) {
         const role = this.constitution.getRole(actor);
         return role ? role.permissions : [];
     }
-    /**
-     * 获取角色的约束条件
-     */
+    /** 获取角色的约束条件 */
     getRoleConstraints(actor) {
         const role = this.constitution.getRole(actor);
         return role ? role.constraints : [];
     }
 }
 export default PermissionManager;
-//# sourceMappingURL=PermissionManager.js.map

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

@@ -11,4 +11,3 @@ export { Reasoning as ReasoningV3 } from './knowledge/values/Reasoning.js';
 export { RELATION_BUCKETS, RELATION_BUCKETS as RelationType, Relations, } from './knowledge/values/Relations.js';
 export { Stats } from './knowledge/values/Stats.js';
 export { Snippet } from './snippet/Snippet.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/domain/index.js

@@ -13,4 +13,3 @@ export { RELATION_BUCKETS, RELATION_BUCKETS as RelationType, Relations, } from '
 export { Stats } from './knowledge/values/Stats.js';
 // Snippet 相关
 export { Snippet } from './snippet/Snippet.js';
-//# sourceMappingURL=index.js.map

package/dist/lib/{shared → domain/knowledge}/FieldSpec.d.ts

@@ -24,17 +24,6 @@ export declare const FieldLevel: Readonly<{
     EXPECTED: "expected";
     OPTIONAL: "optional";
 }>;
-/**
- * @typedef {object} FieldDef
- * @property {string}  name              字段名（支持点号嵌套: 'content.markdown'）
- * @property {string}  level             - 'required' | 'expected' | 'optional'
- * @property {string}  rule              人类友好的填写规则
- * @property {string}  [pipeline]        下游管线消费说明
- * @property {string}  [type]            - 'string' | 'object' | 'array' | 'number'
- * @property {boolean} [systemInjected]  - true = 内部 Agent 路径由系统注入，AI 不必填
- * @property {*}       [defaultValue]    默认值（用于 save_document 等特殊路径）
- */
-/** @type {FieldDef[]} */
 export declare const V3_FIELD_SPEC: ({
     name: string;
     level: "required";
@@ -81,16 +70,9 @@ export declare function getExternalAgentRequiredFields(): string[];
 export declare function getInternalAgentRequiredFields(): string[];
 /** 获取系统注入的字段名列表 */
 export declare function getSystemInjectedFields(): string[];
-/**
- * 生成人类友好的字段说明列表（供拒绝反馈使用）
- * @returns {string[]}
- */
+/** 生成人类友好的字段说明列表（供拒绝反馈使用） */
 export declare function getRequiredFieldsDescription(): string[];
-/**
- * 根据字段名获取规范定义
- * @param {string} name
- * @returns {FieldDef|undefined}
- */
+/** 根据字段名获取规范定义 */
 export declare function getFieldDef(name: string): {
     name: string;
     level: "required";
@@ -125,13 +107,11 @@ export declare function getFieldDef(name: string): {
  *
  * 从 V3_FIELD_SPEC 中提取 trigger/kind/doClause/dontClause/whenClause/coreCode 的 rule，
  * 并标记 REQUIRED 级别为【必填】前缀。
- *
- * @returns {Record<string, string>}
  */
 export declare function getCursorDeliverySpec(): Record<string, any>;
 /**
  * 按 level 分组返回字段
- * @returns {{ required: FieldDef[], expected: FieldDef[], optional: FieldDef[] }}
+ * @returns }
  */
 export declare function getFieldsByLevel(): {
     required: ({
@@ -166,4 +146,3 @@ export declare function getFieldsByLevel(): {
         systemInjected?: undefined;
     }[];
 };
-//# sourceMappingURL=FieldSpec.d.ts.map

package/dist/lib/{shared → domain/knowledge}/FieldSpec.js

@@ -26,17 +26,6 @@ export const FieldLevel = Object.freeze({
     OPTIONAL: 'optional',
 });
 // ── V3 字段规范 ─────────────────────────────────────────────
-/**
- * @typedef {object} FieldDef
- * @property {string}  name              字段名（支持点号嵌套: 'content.markdown'）
- * @property {string}  level             - 'required' | 'expected' | 'optional'
- * @property {string}  rule              人类友好的填写规则
- * @property {string}  [pipeline]        下游管线消费说明
- * @property {string}  [type]            - 'string' | 'object' | 'array' | 'number'
- * @property {boolean} [systemInjected]  - true = 内部 Agent 路径由系统注入，AI 不必填
- * @property {*}       [defaultValue]    默认值（用于 save_document 等特殊路径）
- */
-/** @type {FieldDef[]} */
 export const V3_FIELD_SPEC = [
     // ── 核心内容 (5) ──────────────────────────────────────────
     {
@@ -287,10 +276,7 @@ export function getInternalAgentRequiredFields() {
 export function getSystemInjectedFields() {
     return V3_FIELD_SPEC.filter((f) => f.systemInjected).map((f) => f.name);
 }
-/**
- * 生成人类友好的字段说明列表（供拒绝反馈使用）
- * @returns {string[]}
- */
+/** 生成人类友好的字段说明列表（供拒绝反馈使用） */
 export function getRequiredFieldsDescription() {
     return V3_FIELD_SPEC.filter((f) => f.level === FieldLevel.REQUIRED).map((f) => {
         if (f.name.includes('.')) {
@@ -299,11 +285,7 @@ export function getRequiredFieldsDescription() {
         return `${f.name} (${f.rule})`;
     });
 }
-/**
- * 根据字段名获取规范定义
- * @param {string} name
- * @returns {FieldDef|undefined}
- */
+/** 根据字段名获取规范定义 */
 export function getFieldDef(name) {
     return V3_FIELD_SPEC.find((f) => f.name === name);
 }
@@ -312,8 +294,6 @@ export function getFieldDef(name) {
  *
  * 从 V3_FIELD_SPEC 中提取 trigger/kind/doClause/dontClause/whenClause/coreCode 的 rule，
  * 并标记 REQUIRED 级别为【必填】前缀。
- *
- * @returns {Record<string, string>}
  */
 export function getCursorDeliverySpec() {
     const CURSOR_FIELD_NAMES = [
@@ -336,7 +316,7 @@ export function getCursorDeliverySpec() {
 }
 /**
  * 按 level 分组返回字段
- * @returns {{ required: FieldDef[], expected: FieldDef[], optional: FieldDef[] }}
+ * @returns }
  */
 export function getFieldsByLevel() {
     return {
@@ -345,4 +325,3 @@ export function getFieldsByLevel() {
         optional: V3_FIELD_SPEC.filter((f) => f.level === FieldLevel.OPTIONAL),
     };
 }
-//# sourceMappingURL=FieldSpec.js.map

package/dist/lib/domain/knowledge/KnowledgeEntry.d.ts

@@ -103,8 +103,7 @@ export declare class KnowledgeEntry {
     constructor(props?: KnowledgeEntryProps);
     /**
      * 发布 (pending → active)
-     * @param {string} publisher
-     * @returns {{ success: boolean, error?: string }}
+     * @returns }
      */
     publish(publisher: string): {
         success: boolean;
@@ -112,8 +111,7 @@ export declare class KnowledgeEntry {
     };
     /**
      * 弃用 (pending|active → deprecated)
-     * @param {string} reason
-     * @returns {{ success: boolean, error?: string }}
+     * @returns }
      */
     deprecate(reason: string): {
         success: boolean;
@@ -121,36 +119,21 @@ export declare class KnowledgeEntry {
     };
     /**
      * 重新激活 (deprecated → pending)
-     * @returns {{ success: boolean, error?: string }}
+     * @returns }
      */
     reactivate(): {
         success: boolean;
         error?: string;
     };
-    /**
-     * 是否处于候选阶段
-     * @returns {boolean}
-     */
+    /** 是否处于候选阶段 */
     isCandidate(): boolean;
-    /**
-     * 是否可被 Guard/Search/Export 消费
-     * @returns {boolean}
-     */
+    /** 是否可被 Guard/Search/Export 消费 */
     isActive(): boolean;
-    /**
-     * 是否为 Guard 规则类型
-     * @returns {boolean}
-     */
+    /** 是否为 Guard 规则类型 */
     isRule(): boolean;
-    /**
-     * 内容是否有效
-     * @returns {boolean}
-     */
+    /** 内容是否有效 */
     isValid(): boolean;
-    /**
-     * 返回此 Entry 中可被 GuardCheckEngine 消费的规则列表
-     * @returns {Array<Object>}
-     */
+    /** 返回此 Entry 中可被 GuardCheckEngine 消费的规则列表 */
     getGuardRules(): ({
         id: string;
         type: string;
@@ -276,22 +259,13 @@ export declare class KnowledgeEntry {
         publishedAt: number | null;
         publishedBy: string | null;
     };
-    /**
-     * JSON → Domain (camelCase 直入)
-     * @param {Object} data
-     * @returns {KnowledgeEntry}
-     */
+    /** JSON → Domain (camelCase 直入) */
     static fromJSON(data: unknown): KnowledgeEntry;
-    /**
-     * @param {string} to
-     * @returns {{ success: boolean, error?: string }}
-     */
+    /** @returns } */
     _transition(to: string): {
         success: boolean;
         error?: string;
     };
-    /** @returns {number} */
     _now(): number;
 }
 export default KnowledgeEntry;
-//# sourceMappingURL=KnowledgeEntry.d.ts.map

package/dist/lib/domain/knowledge/KnowledgeEntry.js

@@ -115,8 +115,7 @@ export class KnowledgeEntry {
     /* ═══ 生命周期操作 ═══════════════════════════════════ */
     /**
      * 发布 (pending → active)
-     * @param {string} publisher
-     * @returns {{ success: boolean, error?: string }}
+     * @returns }
      */
     publish(publisher) {
         if (!this.isValid()) {
@@ -131,8 +130,7 @@ export class KnowledgeEntry {
     }
     /**
      * 弃用 (pending|active → deprecated)
-     * @param {string} reason
-     * @returns {{ success: boolean, error?: string }}
+     * @returns }
      */
     deprecate(reason) {
         const result = this._transition(Lifecycle.DEPRECATED);
@@ -143,7 +141,7 @@ export class KnowledgeEntry {
     }
     /**
      * 重新激活 (deprecated → pending)
-     * @returns {{ success: boolean, error?: string }}
+     * @returns }
      */
     reactivate() {
         const result = this._transition(Lifecycle.PENDING);
@@ -153,39 +151,24 @@ export class KnowledgeEntry {
         return result;
     }
     /* ═══ 谓词 ═══════════════════════════════════════════ */
-    /**
-     * 是否处于候选阶段
-     * @returns {boolean}
-     */
+    /** 是否处于候选阶段 */
     isCandidate() {
         return isLifecycleCandidate(this.lifecycle);
     }
-    /**
-     * 是否可被 Guard/Search/Export 消费
-     * @returns {boolean}
-     */
+    /** 是否可被 Guard/Search/Export 消费 */
     isActive() {
         return this.lifecycle === Lifecycle.ACTIVE;
     }
-    /**
-     * 是否为 Guard 规则类型
-     * @returns {boolean}
-     */
+    /** 是否为 Guard 规则类型 */
     isRule() {
         return this.kind === 'rule';
     }
-    /**
-     * 内容是否有效
-     * @returns {boolean}
-     */
+    /** 内容是否有效 */
     isValid() {
         return !!(this.title?.trim() && this.content.hasContent());
     }
     /* ═══ Guard 消费 ═══════════════════════════════════ */
-    /**
-     * 返回此 Entry 中可被 GuardCheckEngine 消费的规则列表
-     * @returns {Array<Object>}
-     */
+    /** 返回此 Entry 中可被 GuardCheckEngine 消费的规则列表 */
     getGuardRules() {
         if (!this.isActive() || !this.isRule()) {
             return [];
@@ -274,11 +257,7 @@ export class KnowledgeEntry {
             publishedBy: this.publishedBy,
         };
     }
-    /**
-     * JSON → Domain (camelCase 直入)
-     * @param {Object} data
-     * @returns {KnowledgeEntry}
-     */
+    /** JSON → Domain (camelCase 直入) */
     static fromJSON(data) {
         if (!data) {
             return new KnowledgeEntry();
@@ -286,10 +265,7 @@ export class KnowledgeEntry {
         return new KnowledgeEntry(data);
     }
     /* ═══ 私有 ═══════════════════════════════════════════ */
-    /**
-     * @param {string} to
-     * @returns {{ success: boolean, error?: string }}
-     */
+    /** @returns } */
     _transition(to) {
         if (!isValidTransition(this.lifecycle, to)) {
             return {
@@ -306,10 +282,8 @@ export class KnowledgeEntry {
         this.updatedAt = this._now();
         return { success: true };
     }
-    /** @returns {number} */
     _now() {
         return Math.floor(Date.now() / 1000);
     }
 }
 export default KnowledgeEntry;
-//# sourceMappingURL=KnowledgeEntry.js.map

package/dist/lib/domain/knowledge/KnowledgeRepository.d.ts

@@ -33,4 +33,3 @@ export declare class KnowledgeRepository {
     getStats(): Promise<Record<string, unknown>>;
 }
 export default KnowledgeRepository;
-//# sourceMappingURL=KnowledgeRepository.d.ts.map

package/dist/lib/domain/knowledge/KnowledgeRepository.js

@@ -43,4 +43,3 @@ export class KnowledgeRepository {
     }
 }
 export default KnowledgeRepository;
-//# sourceMappingURL=KnowledgeRepository.js.map

package/dist/lib/domain/knowledge/Lifecycle.d.ts

@@ -15,36 +15,14 @@ export declare const Lifecycle: {
 };
 /** 候选阶段的所有状态 */
 export declare const CANDIDATE_STATES: string[];
-/**
- * 规范化生命周期值
- * @param {string} lifecycle
- * @returns {string}
- */
+/** 规范化生命周期值 */
 export declare function normalizeLifecycle(lifecycle: string): string;
-/**
- * 检查状态转移是否合法
- * @param {string} from
- * @param {string} to
- * @returns {boolean}
- */
+/** 检查状态转移是否合法 */
 export declare function isValidTransition(from: string, to: string): boolean;
-/**
- * 是否为合法的生命周期值
- * @param {string} lifecycle
- * @returns {boolean}
- */
+/** 是否为合法的生命周期值 */
 export declare function isValidLifecycle(lifecycle: string): boolean;
-/**
- * 是否处于候选阶段（待审核）
- * @param {string} lifecycle
- * @returns {boolean}
- */
+/** 是否处于候选阶段（待审核） */
 export declare function isCandidate(lifecycle: string): boolean;
-/**
- * 从 knowledgeType 推导 kind
- * @param {string} knowledgeType
- * @returns {'rule'|'pattern'|'fact'}
- */
+/** 从 knowledgeType 推导 kind */
 export declare function inferKind(knowledgeType: string): 'rule' | 'pattern' | 'fact';
 export default Lifecycle;
-//# sourceMappingURL=Lifecycle.d.ts.map