autosnippet 3.2.15 → 3.2.17

package/dist/lib/external/mcp/handlers/bootstrap-internal.js

@@ -46,7 +46,7 @@
  *   bootstrap/dimensions.js   ← 7 维度知识提取器（内部 Agent 专用）
  *   bootstrap/projectSkills.js ← Phase 5.5 Project Skill 生成（内部 Agent 专用）
  */
-import { getInternalAgentRequiredFields } from '#shared/FieldSpec.js';
+import { getInternalAgentRequiredFields } from '#domain/knowledge/FieldSpec.js';
 import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
 import { envelope } from '../envelope.js';
 import { fillDimensionsV3 } from './bootstrap/pipeline/orchestrator.js';
@@ -65,12 +65,11 @@ export { bootstrapRefine };
  *
  * ⚠️ 本函数是内部 Agent 路径。外部 Agent 使用 bootstrap-external.js 的 Mission Briefing + dimension_complete 流程。
  *
- * @param {object} ctx  { container, logger }
- * @param {object} args
- * @param {number} [args.maxFiles=500] 最大扫描文件数
- * @param {boolean} [args.skipGuard=false] 是否跳过 Guard 审计
- * @param {number} [args.contentMaxLines=120] 每文件读取最大行数
- * @param {boolean} [args.incremental=true] 是否启用增量 Bootstrap (自动检测变更, 仅重跑受影响维度)
+ * @param ctx { container, logger }
+ * @param [args.maxFiles=500] 最大扫描文件数
+ * @param [args.skipGuard=false] 是否跳过 Guard 审计
+ * @param [args.contentMaxLines=120] 每文件读取最大行数
+ * @param [args.incremental=true] 是否启用增量 Bootstrap (自动检测变更, 仅重跑受影响维度)
  */
 export async function bootstrapKnowledge(ctx, args) {
     const t0 = Date.now();
@@ -390,4 +389,3 @@ export async function bootstrapKnowledge(ctx, args) {
     });
 }
 // bootstrapRefine → 已提取到 bootstrap/refine.js（通过顶部 re-export）
-//# sourceMappingURL=bootstrap-internal.js.map

package/dist/lib/external/mcp/handlers/browse.d.ts

@@ -148,4 +148,3 @@ export declare function confirmUsage(ctx: McpContext, args: ConfirmUsageArgs): P
         tool?: string | undefined;
     };
 }>;
-//# sourceMappingURL=browse.d.ts.map

package/dist/lib/external/mcp/handlers/browse.js

@@ -20,9 +20,7 @@ function _buildActionHint(json) {
     }
     return `${whenText ? `${whenText} → ` : ''}${doText}`.replace(/ → $/, '');
 }
-/**
- * 只保留非空关系桶，压缩 Relations 输出体积。
- */
+/** 只保留非空关系桶，压缩 Relations 输出体积。 */
 function _compactRelations(relations) {
     if (!relations) {
         return undefined;
@@ -284,4 +282,3 @@ export async function confirmUsage(ctx, args) {
         meta: { tool: 'autosnippet_confirm_usage' },
     });
 }
-//# sourceMappingURL=browse.js.map

package/dist/lib/external/mcp/handlers/candidate.d.ts

@@ -63,4 +63,3 @@ export declare function enrichCandidates(ctx: McpContext, args: EnrichCandidates
         tool?: string | undefined;
     };
 }>;
-//# sourceMappingURL=candidate.d.ts.map

package/dist/lib/external/mcp/handlers/candidate.js

@@ -222,4 +222,3 @@ export async function enrichCandidates(ctx, args) {
         meta: { tool: 'autosnippet_enrich_candidates' },
     });
 }
-//# sourceMappingURL=candidate.js.map

package/dist/lib/external/mcp/handlers/consolidated.d.ts

@@ -273,9 +273,7 @@ export declare function consolidatedStructure(ctx: McpContext, args: Consolidate
         tool?: string | undefined;
     };
 }>;
-/**
- * 调用链上下文查询：直接转发到 structure.callContext
- */
+/** 调用链上下文查询：直接转发到 structure.callContext */
 export declare function consolidatedCallContext(ctx: McpContext, args: ConsolidatedStructureArgs): Promise<{
     success: boolean;
     errorCode: string | null;
@@ -441,4 +439,3 @@ export declare function enhancedSubmitKnowledge(ctx: McpContext, args: SubmitKno
         tool?: string | undefined;
     };
 }>;
-//# sourceMappingURL=consolidated.d.ts.map

package/dist/lib/external/mcp/handlers/consolidated.js

@@ -8,7 +8,7 @@
  *
  * autosnippet_bootstrap 已迁移到 bootstrap-external.js（外部 Agent 路径）。
  */
-import { getRequiredFieldsDescription } from '#shared/FieldSpec.js';
+import { getRequiredFieldsDescription } from '#domain/knowledge/FieldSpec.js';
 import * as browseHandlers from './browse.js';
 import * as candidateHandlers from './candidate.js';
 import * as guardHandlers from './guard.js';
@@ -90,9 +90,7 @@ export async function consolidatedStructure(ctx, args) {
     }
 }
 // ─── autosnippet_call_context (Phase 5) ─────────────────────
-/**
- * 调用链上下文查询：直接转发到 structure.callContext
- */
+/** 调用链上下文查询：直接转发到 structure.callContext */
 export async function consolidatedCallContext(ctx, args) {
     return structureHandlers.callContext(ctx, args);
 }
@@ -151,7 +149,7 @@ export async function consolidatedGuard(ctx, args) {
 export async function consolidatedSkill(ctx, args) {
     const op = args.operation;
     if (!op) {
-        throw new Error('Missing required parameter: operation. Expected: list, load, create, update, delete, suggest');
+        throw new Error('Missing required parameter: operation. Expected: list, load, create, update, delete, suggest, feedback');
     }
     // loadSkill expects { skillName }, map from { name }
     if (args.name && !args.skillName) {
@@ -170,8 +168,10 @@ export async function consolidatedSkill(ctx, args) {
             return skillHandlers.deleteSkill(ctx, args);
         case 'suggest':
             return skillHandlers.suggestSkills(ctx);
+        case 'feedback':
+            return skillHandlers.recordFeedback(ctx, args);
         default:
-            throw new Error(`Unknown skill operation: ${op}. Expected: list, load, create, update, delete, suggest`);
+            throw new Error(`Unknown skill operation: ${op}. Expected: list, load, create, update, delete, suggest, feedback`);
     }
 }
 // ─── autosnippet_submit_knowledge (增强：严格前置校验 + dedup + 提交追踪) ──
@@ -186,7 +186,7 @@ export async function consolidatedSkill(ctx, args) {
  */
 export async function enhancedSubmitKnowledge(ctx, args) {
     const { submitKnowledge } = await import('./knowledge.js');
-    const { UnifiedValidator } = await import('#shared/UnifiedValidator.js');
+    const { UnifiedValidator } = await import('#domain/knowledge/UnifiedValidator.js');
     const { envelope } = await import('../envelope.js');
     const skipDuplicateCheck = args.skipDuplicateCheck === true;
     // ── 严格前置校验：UnifiedValidator 不通过则直接拒绝 ──
@@ -271,9 +271,7 @@ function _trackSubmission(ctx, args, recipeId) {
         // tracker 不可用时静默降级
     }
 }
-/**
- * 记录拒绝到活跃 BootstrapSession 的 submissionTracker
- */
+/** 记录拒绝到活跃 BootstrapSession 的 submissionTracker */
 function _trackRejection(ctx, args) {
     try {
         const sessionManager = ctx.container.get('bootstrapSessionManager');
@@ -289,4 +287,3 @@ function _trackRejection(ctx, args) {
         // 静默降级
     }
 }
-//# sourceMappingURL=consolidated.js.map

package/dist/lib/external/mcp/handlers/dimension-complete-external.d.ts

@@ -18,17 +18,16 @@ import type { McpContext } from './types.js';
 /**
  * dimensionComplete — 维度分析完成通知
  *
- * @param {object} ctx  - { container, logger, startedAt }
- * @param {object} args 工具参数
- * @param {string} [args.sessionId]          - bootstrap 返回的 session.id
- * @param {string} args.dimensionId          维度 ID
- * @param {string[]} args.submittedRecipeIds 本维度提交的 recipe ID 列表
- * @param {string} args.analysisText         分析报告全文（Markdown）
- * @param {string[]} [args.referencedFiles]  引用的文件路径列表
- * @param {string[]} [args.keyFindings]      关键发现摘要 (3-5 条)
- * @param {number} [args.candidateCount]     本维度提交的候选数量
- * @param {object} [args.crossDimensionHints] 对其他维度的建议
- * @returns {Promise<object>}
+ * @param ctx { container, logger, startedAt }
+ * @param args 工具参数
+ * @param [args.sessionId] bootstrap 返回的 session.id
+ * @param args.dimensionId 维度 ID
+ * @param args.submittedRecipeIds 本维度提交的 recipe ID 列表
+ * @param args.analysisText 分析报告全文（Markdown）
+ * @param [args.referencedFiles] 引用的文件路径列表
+ * @param [args.keyFindings] 关键发现摘要 (3-5 条)
+ * @param [args.candidateCount] 本维度提交的候选数量
+ * @param [args.crossDimensionHints] 对其他维度的建议
  */
 interface DimensionCompleteArgs {
     sessionId?: string;
@@ -54,4 +53,3 @@ export declare function dimensionComplete(ctx: McpContext, args: DimensionComple
     };
 }>;
 export {};
-//# sourceMappingURL=dimension-complete-external.d.ts.map

package/dist/lib/external/mcp/handlers/dimension-complete-external.js

@@ -15,7 +15,7 @@
  * @module handlers/dimension-complete
  */
 import Logger from '#infra/logging/Logger.js';
-import { BootstrapEventEmitter } from '#shared/BootstrapEventEmitter.js';
+import { BootstrapEventEmitter } from '#service/bootstrap/BootstrapEventEmitter.js';
 import { envelope } from '../envelope.js';
 import { saveDimensionCheckpoint } from './bootstrap/pipeline/checkpoint.js';
 import { BOOTSTRAP_COMPLETE_ACTIONS } from './bootstrap/shared/dimension-text.js';
@@ -290,10 +290,10 @@ export async function dimensionComplete(ctx, args) {
         // R6: 全量 Semantic Memory 固化 (fire-and-forget)
         setImmediate(async () => {
             try {
-                const { EpisodicConsolidator } = await import('#service/agent/domain/EpisodicConsolidator.js');
+                const { EpisodicConsolidator } = await import('#agent/domain/EpisodicConsolidator.js');
                 const db = ctx.container.get?.('database') ?? ctx.container.get?.('db');
                 if (db && session.sessionStore) {
-                    const { PersistentMemory } = await import('#service/agent/memory/PersistentMemory.js');
+                    const { PersistentMemory } = await import('#agent/memory/PersistentMemory.js');
                     const semanticMemory = new PersistentMemory(db, { logger });
                     const consolidator = new EpisodicConsolidator(semanticMemory, { logger });
                     const result = await consolidator.consolidate(session.sessionStore, {
@@ -404,4 +404,3 @@ export async function dimensionComplete(ctx, args) {
         },
     });
 }
-//# sourceMappingURL=dimension-complete-external.js.map

package/dist/lib/external/mcp/handlers/guard.d.ts

@@ -148,8 +148,8 @@ export declare function guardAuditFiles(ctx: McpContext, args: GuardAuditArgs):
  *   4. 防无限循环：reviewRound 计数 + MAX_REVIEW_ROUNDS 限制
  *   5. 不绑定 task ID — 代码检查独立于任务系统
  *
- * @param {object} ctx - MCP context with container
- * @param {object} args - { files?: string[] }
+ * @param ctx MCP context with container
+ * @param args { files?: string[] }
  */
 export declare function guardReview(ctx: McpContext, args: GuardReviewArgs): Promise<{
     success: boolean;
@@ -272,4 +272,3 @@ export declare function scanProject(ctx: McpContext, args: ScanProjectArgs): Pro
     };
 }>;
 export {};
-//# sourceMappingURL=guard.d.ts.map

package/dist/lib/external/mcp/handlers/guard.js

@@ -148,8 +148,8 @@ export async function guardAuditFiles(ctx, args) {
  *   4. 防无限循环：reviewRound 计数 + MAX_REVIEW_ROUNDS 限制
  *   5. 不绑定 task ID — 代码检查独立于任务系统
  *
- * @param {object} ctx - MCP context with container
- * @param {object} args - { files?: string[] }
+ * @param ctx MCP context with container
+ * @param args { files?: string[] }
  */
 export async function guardReview(ctx, args) {
     const { GuardCheckEngine, detectLanguage } = await import('#service/guard/GuardCheckEngine.js');
@@ -562,9 +562,8 @@ export async function scanProject(ctx, args) {
 /**
  * 获取 DI 容器中的 GuardCheckEngine 单例，回退到新建实例
  * 优先复用 DI 单例以保持 externalRules / cache 的跨调用一致性
- * @param {object} ctx - MCP context with container
- * @param {Function} GuardCheckEngine 引擎构造函数（用于回退）
- * @returns {import('#service/guard/GuardCheckEngine.js').GuardCheckEngine}
+ * @param ctx MCP context with container
+ * @param GuardCheckEngine 引擎构造函数（用于回退）
  */
 function _getOrCreateEngine(ctx, GuardCheckEngineCtor) {
     try {
@@ -616,4 +615,3 @@ async function _injectEnhancementGuardRules(engine, ctx) {
         /* Enhancement registry not available — non-critical */
     }
 }
-//# sourceMappingURL=guard.js.map

package/dist/lib/external/mcp/handlers/knowledge.d.ts

@@ -23,9 +23,7 @@ export declare function submitKnowledge(ctx: McpContext, args: Record<string, un
         tool?: string | undefined;
     };
 }>;
-/**
- * 批量知识提交 (autosnippet_submit_knowledge_batch)
- */
+/** 批量知识提交 (autosnippet_submit_knowledge_batch) */
 interface KnowledgeItemInput {
     title?: string;
     content?: {
@@ -107,4 +105,3 @@ export declare function saveDocument(ctx: McpContext, args: {
     };
 }>;
 export {};
-//# sourceMappingURL=knowledge.d.ts.map

package/dist/lib/external/mcp/handlers/knowledge.js

@@ -2,8 +2,8 @@
  * MCP Handlers — V3 知识条目提交 & 生命周期
  * submitKnowledge, submitKnowledgeBatch, knowledgeLifecycle
  */
+import { UnifiedValidator } from '#domain/knowledge/UnifiedValidator.js';
 import { resolveProjectRoot } from '#shared/resolveProjectRoot.js';
-import { UnifiedValidator } from '#shared/UnifiedValidator.js';
 import { envelope } from '../envelope.js';
 // ─── 限流 ──────────────────────────────────────────────────
 async function _checkRateLimit(toolName, clientId, container) {
@@ -335,4 +335,3 @@ export async function saveDocument(ctx, args) {
 }
 // ─── 内部辅助 ──────────────────────────────────────────────
 // ─── (已删除: _toReadinessInput — 统一使用 UnifiedValidator) ──
-//# sourceMappingURL=knowledge.js.map

package/dist/lib/external/mcp/handlers/search.d.ts

@@ -208,8 +208,5 @@ export declare function semanticSearch(ctx: McpContext, args: SearchArgs): Promi
         tool?: string | undefined;
     };
 }>;
-/**
- * @deprecated Use `slimSearchResult` from `SearchTypes.ts` instead
- */
+/** @deprecated Use `slimSearchResult` from `SearchTypes.ts` instead */
 export declare function _slimSearchItem(item: SearchResultItem): SlimSearchResult;
-//# sourceMappingURL=search.d.ts.map

package/dist/lib/external/mcp/handlers/search.js

@@ -26,17 +26,13 @@ function getSearchEngine(ctx) {
         return null;
     }
 }
-/**
- * 降级创建 SearchEngine（仅在 container 无法提供时）
- */
+/** 降级创建 SearchEngine（仅在 container 无法提供时） */
 async function getFallbackEngine(ctx) {
     const { SearchEngine } = await import('#service/search/SearchEngine.js');
     const db = ctx.container.get('database');
     return new SearchEngine(db);
 }
-/**
- * 根据 kind 参数过滤 items
- */
+/** 根据 kind 参数过滤 items */
 function filterByKind(items, kind) {
     if (!kind || kind === 'all') {
         return items;
@@ -173,10 +169,7 @@ function _toolName(mode) {
 }
 // ─── Re-export slim projection for backward compatibility ────
 // (部分内部模块可能直接 import 了这些)
-/**
- * @deprecated Use `slimSearchResult` from `SearchTypes.ts` instead
- */
+/** @deprecated Use `slimSearchResult` from `SearchTypes.ts` instead */
 export function _slimSearchItem(item) {
     return slimSearchResult(item);
 }
-//# sourceMappingURL=search.js.map

package/dist/lib/external/mcp/handlers/skill.d.ts

@@ -13,15 +13,15 @@ import type { McpContext } from './types.js';
 /**
  * 列出所有可用 Skills 及其摘要描述
  *
- * @returns {string} JSON envelope
+ * @returns JSON envelope
  */
 export declare function listSkills(ctx?: McpContext | null): string;
 /**
  * 加载指定 Skill 的完整文档内容
  *
- * @param {object} _ctx  MCP context（未使用，保持签名一致）
- * @param {object} args  { skillName: string, section?: string }
- * @returns {string} JSON envelope
+ * @param _ctx MCP context（未使用，保持签名一致）
+ * @param args { skillName: string, section?: string }
+ * @returns JSON envelope
  */
 export declare function loadSkill(ctx: McpContext | null, args: {
     skillName?: string;
@@ -31,9 +31,9 @@ export declare function loadSkill(ctx: McpContext | null, args: {
  * 创建项目级 Skill — 写入 {projectRoot}/AutoSnippet/skills/<name>/SKILL.md
  * 创建后自动 regenerate 编辑器索引（.cursor/rules/autosnippet-skills.mdc）
  *
- * @param {object} _ctx  MCP context
- * @param {object} args  { name, description, content, overwrite? }
- * @returns {string} JSON envelope
+ * @param _ctx MCP context
+ * @param args { name, description, content, overwrite? }
+ * @returns JSON envelope
  */
 interface CreateSkillArgs {
     name?: string;
@@ -48,9 +48,9 @@ export declare function createSkill(ctx: McpContext | null, args: CreateSkillArg
  * 删除项目级 Skill — 移除 {projectRoot}/AutoSnippet/skills/<name>/ 整个目录
  * 内置 Skill 不可删除。删除后自动 regenerate 编辑器索引。
  *
- * @param {object} _ctx  MCP context
- * @param {object} args  { name: string }
- * @returns {string} JSON envelope
+ * @param _ctx MCP context
+ * @param args { name: string }
+ * @returns JSON envelope
  */
 export declare function deleteSkill(ctx: McpContext | null, args: {
     name?: string;
@@ -59,9 +59,9 @@ export declare function deleteSkill(ctx: McpContext | null, args: {
  * 更新项目级 Skill — 修改 description 和/或 content
  * 内置 Skill 不可更新。更新后自动 regenerate 编辑器索引。
  *
- * @param {object} _ctx  MCP context
- * @param {object} args  { name, description?, content? }
- * @returns {string} JSON envelope
+ * @param _ctx MCP context
+ * @param args { name, description?, content? }
+ * @returns JSON envelope
  */
 interface UpdateSkillArgs {
     name?: string;
@@ -75,9 +75,25 @@ export declare function updateSkill(ctx: McpContext | null, args: UpdateSkillArg
  * 分析维度：Guard 违规模式、Memory 偏好积累、Recipe 分布缺口、候选积压
  * Agent 可根据推荐结果自行决定是否调用 createSkill 创建
  *
- * @param {object} ctx  MCP context（含 container）
- * @returns {Promise<string>} JSON envelope
+ * @param ctx MCP context（含 container）
+ * @returns JSON envelope
  */
 export declare function suggestSkills(ctx: McpContext): Promise<string>;
+/**
+ * 记录推荐反馈
+ *
+ * operation: 'feedback'
+ * @param args.recommendationId  推荐 ID
+ * @param args.action           'adopted' | 'dismissed' | 'expired' | 'viewed' | 'modified'
+ * @param args.reason           可选 — 忽略原因
+ * @param args.source           可选 — 推荐来源
+ * @param args.category         可选 — 推荐类别
+ */
+export declare function recordFeedback(ctx: McpContext, args: {
+    recommendationId?: string;
+    action?: string;
+    reason?: string;
+    source?: string;
+    category?: string;
+}): Promise<string>;
 export {};
-//# sourceMappingURL=skill.d.ts.map