autosnippet 3.2.17 → 3.2.20

package/dist/lib/cli/deploy/FileManifest.js

@@ -47,9 +47,9 @@ export const MANIFEST = [
     // ═══ Cursor Rules（AutoSnippet 完全拥有） ═══════════
     {
         id: 'cursor-conventions',
-        src: 'cursor-rules/autosnippet-conventions.mdc',
+        strategy: 'generate',
+        generate: 'generateConventionsMdc',
         dest: '.cursor/rules/autosnippet-conventions.mdc',
-        strategy: 'overwrite',
         on: 'both',
         category: 'cursor-rules',
     },
@@ -61,14 +61,6 @@ export const MANIFEST = [
         on: 'both',
         category: 'cursor-rules',
     },
-    {
-        id: 'cursor-workflow',
-        src: 'cursor-rules/autosnippet-workflow.mdc',
-        dest: '.cursor/rules/autosnippet-workflow.mdc',
-        strategy: 'overwrite',
-        on: 'both',
-        category: 'cursor-rules',
-    },
     // ═══ Cursor Hooks ═════════════════════════════════════
     {
         id: 'cursor-hooks-json',
@@ -107,15 +99,14 @@ export const MANIFEST = [
         chmod: true,
         cleanup: ['.claude/hooks.yaml'], // 清理旧格式文件
     },
-    // ═══ Agent Instructions（签名保护）════════════════════
+    // ═══ Agent Instructions（全部从模板生成）═══════════════
     {
         id: 'copilot-instructions',
-        src: 'copilot-instructions.md',
+        strategy: 'generate',
+        generate: 'generateCopilotInstructions',
         dest: '.github/copilot-instructions.md',
-        strategy: 'signature-safe',
         on: 'both',
         category: 'copilot-instructions',
-        fallback: 'inject-marker', // 签名保护失败时，用标记注入
     },
     {
         id: 'agents-md',
@@ -210,21 +201,25 @@ export const MANIFEST = [
  * .gitignore 规则清单 — Setup 和 Upgrade 共用
  * 每条规则：{ pattern, comment, negation? }
  */
+/**
+ * Section markers for the AutoSnippet block inside .gitignore.
+ * merge-gitignore uses these to insert/replace the entire block atomically.
+ */
+export const GITIGNORE_SECTION_BEGIN = '# >>> AutoSnippet (managed block — do not edit) >>>';
+export const GITIGNORE_SECTION_END = '# <<< AutoSnippet <<<';
+/**
+ * AutoSnippet-specific .gitignore rules.
+ * Only patterns that are AutoSnippet runtime/build artifacts belong here.
+ * Generic OS/editor patterns (.DS_Store, *.swp, nohup.out) are NOT our business.
+ */
 export const GITIGNORE_RULES = [
-    // 核心运行时
-    { pattern: '.autosnippet/*', comment: 'AutoSnippet 运行时缓存（不入库）' },
+    // Runtime cache
+    { pattern: '.autosnippet/*', comment: '运行时缓存（不入库）' },
     { pattern: '!.autosnippet/config.json', negation: true },
-    // 环境变量
-    { pattern: '.env', comment: 'AutoSnippet 环境变量（含 API Key，不入库）' },
-    // 日志
-    { pattern: 'logs/', comment: 'AutoSnippet 运行日志' },
-    // AI 草稿
-    { pattern: '.autosnippet-drafts/', comment: 'AutoSnippet AI 草稿（临时）' },
-    { pattern: '_draft_*.md', comment: 'AutoSnippet AI 草稿文件（项目根目录临时文件）' },
-    // 系统 / 编辑器临时文件
-    { pattern: '.DS_Store', comment: 'macOS 元数据' },
-    { pattern: 'nohup.out' },
-    { pattern: '*.sw[a-p]' },
+    // Environment (contains API keys created by `asd setup`)
+    { pattern: '.env', comment: '环境变量（含 API Key）' },
+    // Logs
+    { pattern: 'logs/', comment: '运行日志' },
 ];
 /** .gitignore 迁移规则 — 升级时清理旧格式 */
 export const GITIGNORE_MIGRATIONS = [

package/dist/lib/core/AstAnalyzer.d.ts

@@ -197,7 +197,7 @@ export declare function registerLanguage(langId: string, plugin: LangPlugin): vo
 declare function analyzeFile(source: string, lang: string, options?: AnalyzeFileOptions): AstFileSummary | null;
 /**
  * 批量分析多文件，返回项目级汇总
- * @param {{ name: string, relativePath: string, content: string }[]} files
+ * @param files
  * @param | null }} [options]
  */
 declare function analyzeProject(files: FileInput[], lang: string, options: AnalyzeProjectOptions): ProjectAnalysisResult;
@@ -234,7 +234,7 @@ declare function findCallExpressions(source: string, lang: string, targetCallee:
  * @param source 源代码
  * @param lang 'objectivec' | 'swift'
  * @param pattern 要查找的文本模式（普通字符串匹配）
- * @param {{ forbiddenContext?: string, requiredContext?: string }} contextFilter
+ * @param contextFilter
  *   forbiddenContext: 如果在此上下文中出现则报告 (如 'dealloc')
  *   requiredContext: 如果不在此上下文中出现则报告
  * @returns >}

package/dist/lib/core/AstAnalyzer.js

@@ -98,7 +98,7 @@ function analyzeFile(source, lang, options = {}) {
 }
 /**
  * 批量分析多文件，返回项目级汇总
- * @param {{ name: string, relativePath: string, content: string }[]} files
+ * @param files
  * @param | null }} [options]
  */
 function analyzeProject(files, lang, options) {
@@ -633,7 +633,7 @@ function findCallExpressions(source, lang, targetCallee) {
  * @param source 源代码
  * @param lang 'objectivec' | 'swift'
  * @param pattern 要查找的文本模式（普通字符串匹配）
- * @param {{ forbiddenContext?: string, requiredContext?: string }} contextFilter
+ * @param contextFilter
  *   forbiddenContext: 如果在此上下文中出现则报告 (如 'dealloc')
  *   requiredContext: 如果不在此上下文中出现则报告
  * @returns >}

package/dist/lib/core/analysis/CallEdgeResolver.d.ts

@@ -71,7 +71,7 @@ export declare class CallEdgeResolver {
     propertyTypes: Map<string, Map<string, string>>;
     symbolTable: SymbolTable;
     /**
-     * @param {Array<{from: string, to: string, type: string}>} [inheritanceGraph=[]] 继承图边
+     * @param [inheritanceGraph=[]] 继承图边
      */
     constructor(symbolTable: SymbolTable, importResolver: ImportPathResolver, inheritanceGraph?: InheritanceEdge[]);
     /**
@@ -81,7 +81,7 @@ export declare class CallEdgeResolver {
      * @param callerFile 调用者文件路径 (相对)
      */
     resolveFile(callSites: CallSite[], callerFile: string): ResolvedEdge[];
-    /** @private 构建局部 import 映射 */
+    /** 构建局部 import 映射 */
     _buildImportMap(fileImports: Array<{
         path?: string;
         symbols?: string[];
@@ -91,13 +91,13 @@ export declare class CallEdgeResolver {
         file: string;
         namespace: boolean;
     }>;
-    /** @private 解析单个调用点 */
+    /** 解析单个调用点 */
     _resolveCallSite(cs: CallSite, callerFile: string, importedSymbols: Map<string, {
         file: string;
         namespace: boolean;
     }>): ResolvedEdge | null;
     /**
-     * @private CHA (Class Hierarchy Analysis): 沿继承链向上搜索方法
+     * CHA (Class Hierarchy Analysis): 沿继承链向上搜索方法
      *
      * 使用 BFS 遍历 inheritanceGraph，从 className 向上搜索直到找到
      * 定义了 methodName 的祖先类。只跟踪 'inherits' 类型的边。
@@ -108,7 +108,7 @@ export declare class CallEdgeResolver {
      */
     _resolveByCHA(methodName: string, className: string): string | null;
     /**
-     * @private 从字段名推断类型（DI/IoC 命名约定推断）
+     * 从字段名推断类型（DI/IoC 命名约定推断）
      *
      * 常见模式:
      *   - userRepo → UserRepo
@@ -120,12 +120,12 @@ export declare class CallEdgeResolver {
      */
     _inferFieldType(fieldName: string): string | null;
     /**
-     * @private 在指定文件中查找声明 (使用 fileIndex 优化，避免全表扫描)
+     * 在指定文件中查找声明 (使用 fileIndex 优化，避免全表扫描)
      * @param name 符号名 (可以是 "ClassName.methodName" 或 "functionName")
      * @returns 匹配的 FQN 列表
      */
     _findInFile(name: string, file: string): string[];
-    /** @private 构建 ResolvedEdge */
+    /** 构建 ResolvedEdge */
     _makeEdge(callerFqn: string, calleeFqn: string, resolveMethod: string, cs: CallSite, callerFile: string): ResolvedEdge;
 }
 export default CallEdgeResolver;

package/dist/lib/core/analysis/CallEdgeResolver.js

@@ -21,7 +21,7 @@ export class CallEdgeResolver {
     propertyTypes;
     symbolTable;
     /**
-     * @param {Array<{from: string, to: string, type: string}>} [inheritanceGraph=[]] 继承图边
+     * @param [inheritanceGraph=[]] 继承图边
      */
     constructor(symbolTable, importResolver, inheritanceGraph = []) {
         this.symbolTable = symbolTable;
@@ -34,7 +34,7 @@ export class CallEdgeResolver {
         // 构建反向索引: symbolName → [fqn1, fqn2, ...]
         this.nameIndex = new Map();
         // 构建文件级索引: file → [{ name, qualifiedName, fqn }] (Issue #14 性能优化)
-        /** @type {Map<string, Array<{name: string, qualifiedName: string, fqn: string}>>} */
+        /** >>} */
         this.fileIndex = new Map();
         // Phase 5.3: 类名集合索引 (用于 _inferFieldType 优化，避免全表扫描)
         this.classNames = new Set();
@@ -86,9 +86,9 @@ export class CallEdgeResolver {
         }
         return edges;
     }
-    /** @private 构建局部 import 映射 */
+    /** 构建局部 import 映射 */
     _buildImportMap(fileImports, callerFile) {
-        /** @type {Map<string, { file: string, namespace: boolean }>} */
+        /** >} */
         const importedSymbols = new Map();
         for (const imp of fileImports) {
             const targetFile = this.importResolver.resolve(imp.path || String(imp), callerFile);
@@ -117,7 +117,7 @@ export class CallEdgeResolver {
         }
         return importedSymbols;
     }
-    /** @private 解析单个调用点 */
+    /** 解析单个调用点 */
     _resolveCallSite(cs, callerFile, importedSymbols) {
         const callerFqn = `${callerFile}::${cs.callerClass ? `${cs.callerClass}.` : ''}${cs.callerMethod}`;
         // Priority 0: super.xxx() — 父类方法调用 (CHA 解析，禁止 fallthrough 防止自引用边)
@@ -264,7 +264,7 @@ export class CallEdgeResolver {
         return null;
     }
     /**
-     * @private CHA (Class Hierarchy Analysis): 沿继承链向上搜索方法
+     * CHA (Class Hierarchy Analysis): 沿继承链向上搜索方法
      *
      * 使用 BFS 遍历 inheritanceGraph，从 className 向上搜索直到找到
      * 定义了 methodName 的祖先类。只跟踪 'inherits' 类型的边。
@@ -306,7 +306,7 @@ export class CallEdgeResolver {
         return null;
     }
     /**
-     * @private 从字段名推断类型（DI/IoC 命名约定推断）
+     * 从字段名推断类型（DI/IoC 命名约定推断）
      *
      * 常见模式:
      *   - userRepo → UserRepo
@@ -328,7 +328,7 @@ export class CallEdgeResolver {
         return this.classNames.has(pascalCase) ? pascalCase : null;
     }
     /**
-     * @private 在指定文件中查找声明 (使用 fileIndex 优化，避免全表扫描)
+     * 在指定文件中查找声明 (使用 fileIndex 优化，避免全表扫描)
      * @param name 符号名 (可以是 "ClassName.methodName" 或 "functionName")
      * @returns 匹配的 FQN 列表
      */
@@ -341,7 +341,7 @@ export class CallEdgeResolver {
             .filter((d) => d.name === name || d.qualifiedName === name)
             .map((d) => d.fqn);
     }
-    /** @private 构建 ResolvedEdge */
+    /** 构建 ResolvedEdge */
     _makeEdge(callerFqn, calleeFqn, resolveMethod, cs, callerFile) {
         return {
             caller: callerFqn,

package/dist/lib/core/analysis/CallGraphAnalyzer.d.ts

@@ -107,7 +107,7 @@ export declare class CallGraphAnalyzer {
      */
     analyzeIncremental(astProjectSummary: AstProjectSummary, changedFiles: string[], options?: AnalyzeOptions): Promise<CallGraphResult>;
     /**
-     * @private 实际分析逻辑
+     * 实际分析逻辑
      *
      * 分级降级策略 (§5.2):
      *   - <100 文件  → 完整分析 (含 CHA)
@@ -120,8 +120,8 @@ export declare class CallGraphAnalyzer {
      *
      * @param deadline Date.now() + timeout
      */
-    _doAnalyze(astProjectSummary: AstProjectSummary, maxCallSitesPerFile: number, deadline: number): Promise<CallGraphResult>;
-    /** @private 空结果 */
-    _emptyResult(durationMs: number): CallGraphResult;
+    private _doAnalyze;
+    /** 空结果 */
+    private _emptyResult;
 }
 export default CallGraphAnalyzer;

package/dist/lib/core/analysis/CallGraphAnalyzer.js

@@ -144,7 +144,7 @@ export class CallGraphAnalyzer {
         };
     }
     /**
-     * @private 实际分析逻辑
+     * 实际分析逻辑
      *
      * 分级降级策略 (§5.2):
      *   - <100 文件  → 完整分析 (含 CHA)
@@ -246,7 +246,7 @@ export class CallGraphAnalyzer {
         };
         return { callEdges: allCallEdges, dataFlowEdges, stats };
     }
-    /** @private 空结果 */
+    /** 空结果 */
     _emptyResult(durationMs) {
         return {
             callEdges: [],

package/dist/lib/core/analysis/ImportPathResolver.d.ts

@@ -27,7 +27,6 @@ export declare class ImportPathResolver {
     constructor(projectRoot: string, allFiles: string[]);
     /**
      * 从 tsconfig.json 加载 paths alias 配置
-     * @private
      */
     _loadTsconfigPaths(projectRoot: string): void;
     /**
@@ -42,7 +41,6 @@ export declare class ImportPathResolver {
     }, importerFile: string): string | null | undefined;
     /**
      * 尝试通过 tsconfig paths alias 解析
-     * @private
      */
     _resolveAlias(importPath: string): string | null;
     /** 判断是否为外部依赖 */

package/dist/lib/core/analysis/ImportPathResolver.js

@@ -25,9 +25,9 @@ export class ImportPathResolver {
      */
     constructor(projectRoot, allFiles) {
         this.projectRoot = projectRoot;
-        /** @type {Map<string, string>} normalizedPath → actualFilePath */
+        /** normalizedPath → actualFilePath */
         this.fileIndex = new Map();
-        /** @type {Array<{prefix: string, targets: string[]}>} tsconfig paths 映射 */
+        /** >} tsconfig paths 映射 */
         this.pathAliases = [];
         // 构建文件索引
         for (const f of allFiles) {
@@ -58,7 +58,6 @@ export class ImportPathResolver {
     }
     /**
      * 从 tsconfig.json 加载 paths alias 配置
-     * @private
      */
     _loadTsconfigPaths(projectRoot) {
         const candidates = ['tsconfig.json', 'tsconfig.app.json', 'jsconfig.json'];
@@ -140,7 +139,6 @@ export class ImportPathResolver {
     }
     /**
      * 尝试通过 tsconfig paths alias 解析
-     * @private
      */
     _resolveAlias(importPath) {
         for (const { prefix, targets } of this.pathAliases) {

package/dist/lib/core/ast/ProjectGraph.js

@@ -68,19 +68,19 @@ export default class ProjectGraph {
     #classes = new Map();
     #protocols = new Map();
     #categories = new Map();
-    /** @type {Map<string, string>} 子类 → 父类 */
+    /** 子类 → 父类 */
     #inheritance = new Map();
-    /** @type {Map<string, Set<string>>} 类 → 遵循的协议集合 */
+    /** 类 → 遵循的协议集合 */
     #conformance = new Map();
-    /** @type {Map<string, FileSymbols>} 文件路径 → 文件级符号 */
+    /** 文件路径 → 文件级符号 */
     #files = new Map();
-    /** @type {Map<string, MethodInfo[]>} className → 方法列表 (含 impl 中的方法) */
+    /** className → 方法列表 (含 impl 中的方法) */
     #methodsByClass = new Map();
-    /** @type {ProjectOverview} 项目统计缓存 */
+    /** 项目统计缓存 */
     #overview = null;
-    /** @type {string} 项目根目录 */
+    /** 项目根目录 */
     #projectRoot;
-    /** @type {number} 构建耗时 ms */
+    /** 构建耗时 ms */
     #buildTimeMs = 0;
     // ── 静态工厂 ──────────────────────────────────────────────────
     /**

package/dist/lib/core/capability/CapabilityProbe.js

@@ -135,9 +135,9 @@ export class CapabilityProbe {
         // Case 2: 检查是否是 git 仓库
         const isGitRepo = this._isGitRepo(this.subRepoPath);
         if (!isGitRepo) {
-            // 有目录但不是 git 仓库 → contributor（可本地编辑但不能 push）
-            this.logger.debug('CapabilityProbe: directory exists but not a git repo');
-            return 'contributor';
+            // 有目录但不是 git 仓库 → 本地个人项目（asd setup 创建），给全权限
+            this.logger.debug('CapabilityProbe: directory exists but not a git repo — local project, granting admin');
+            return 'admin';
         }
         // Case 3: 检查是否有 remote
         const hasRemote = this._hasRemote(this.subRepoPath);
@@ -158,17 +158,9 @@ export class CapabilityProbe {
         }
     }
     _isGitRepo(repoPath) {
-        try {
-            execSync('git rev-parse --git-dir', {
-                cwd: repoPath,
-                stdio: 'pipe',
-                timeout: 5000,
-            });
-            return true;
-        }
-        catch {
-            return false;
-        }
+        // 检查是否是独立的 git 仓库（有自己的 .git 目录/文件），
+        // 而非仅仅位于父项目 git 仓库内
+        return fs.existsSync(`${repoPath}/.git`);
     }
     _hasRemote(repoPath) {
         // 快速路径：config 有 subRepoUrl 即认为有 remote

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

@@ -46,9 +46,9 @@ function detectMode(candidate) {
 }
 // ── UnifiedValidator ────────────────────────────────────────
 export class UnifiedValidator {
-    /** @type {Set<string>} 已提交标题 (小写) */
+    /** 已提交标题 (小写) */
     #titles;
-    /** @type {Set<string>} 已提交代码指纹 */
+    /** 已提交代码指纹 */
     #codeFingerprints;
     /**
      * @param [options.existingTitles] 预填充已有标题

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

@@ -4,13 +4,13 @@ export class Constraints {
     preconditions;
     sideEffects;
     constructor(props = {}) {
-        /** @type {Array<Guard>} Guard 规则列表 */
+        /** Guard 规则列表 */
         this.guards = (props.guards || []).map(Constraints._normalizeGuard);
-        /** @type {string[]} 边界约束 */
+        /** 边界约束 */
         this.boundaries = props.boundaries || [];
-        /** @type {string[]} 前置条件 */
+        /** 前置条件 */
         this.preconditions = props.preconditions || [];
-        /** @type {string[]} 副作用 */
+        /** 副作用 */
         this.sideEffects = props.sideEffects ?? [];
     }
     /** 从任意输入构造 Constraints */

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

@@ -6,17 +6,17 @@ export class Content {
     steps;
     verification;
     constructor(props = {}) {
-        /** @type {string} 代码片段 */
+        /** 代码片段 */
         this.pattern = props.pattern ?? '';
-        /** @type {string} Markdown 全文（与 pattern 二选一） */
+        /** Markdown 全文（与 pattern 二选一） */
         this.markdown = props.markdown ?? '';
-        /** @type {string} 设计原理 */
+        /** 设计原理 */
         this.rationale = props.rationale ?? '';
-        /** @type {Array<{title?:string, description?:string, code?:string}>} 实施步骤 */
+        /** >} 实施步骤 */
         this.steps = props.steps ?? [];
-        /** @type {Array<{file:string, before:string, after:string, explanation:string}>} 代码变更 */
+        /** >} 代码变更 */
         this.codeChanges = props.codeChanges ?? [];
-        /** @type {?{method?:string, expected_result?:string, test_code?:string}} 验证方式 */
+        /** } 验证方式 */
         this.verification = props.verification ?? null;
     }
     /** 从任意输入构造 Content */

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

@@ -5,15 +5,15 @@ export class Quality {
     grade;
     overall;
     constructor(props = {}) {
-        /** @type {number} 内容完整度 (0-1) */
+        /** 内容完整度 (0-1) */
         this.completeness = props.completeness ?? 0;
-        /** @type {number} 项目适配度 (0-1) */
+        /** 项目适配度 (0-1) */
         this.adaptation = props.adaptation ?? 0;
-        /** @type {number} 文档清晰度 (0-1) */
+        /** 文档清晰度 (0-1) */
         this.documentation = props.documentation ?? 0;
-        /** @type {number} 综合分 (0-1) */
+        /** 综合分 (0-1) */
         this.overall = props.overall ?? 0;
-        /** @type {string} 等级 A-F */
+        /** 等级 A-F */
         this.grade = props.grade || Quality.calcGrade(this.overall);
     }
     /** 从任意输入构造 Quality */

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

@@ -5,15 +5,15 @@ export class Reasoning {
     sources;
     whyStandard;
     constructor(props = {}) {
-        /** @type {string} 为什么遵循标准 */
+        /** 为什么遵循标准 */
         this.whyStandard = props.whyStandard ?? '';
-        /** @type {string[]} 来源列表 */
+        /** 来源列表 */
         this.sources = props.sources || [];
-        /** @type {number} 置信度 0-1 */
+        /** 置信度 0-1 */
         this.confidence = props.confidence ?? 0.7;
-        /** @type {Object.<string, number>} 质量信号 */
+        /** 质量信号 */
         this.qualitySignals = props.qualitySignals ?? {};
-        /** @type {string[]} 备选方案 */
+        /** 备选方案 */
         this.alternatives = props.alternatives || [];
     }
     /** 从任意输入构造 Reasoning */

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

@@ -24,7 +24,7 @@ export const RELATION_BUCKETS = [
 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] || [];

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

@@ -6,17 +6,17 @@ export class Stats {
     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 命中次数 */
+        /** Guard 命中次数 */
         this.guardHits = props.guardHits ?? 0;
-        /** @type {number} 搜索命中次数 */
+        /** 搜索命中次数 */
         this.searchHits = props.searchHits ?? 0;
-        /** @type {number} 权威分 0-5 */
+        /** 权威分 0-5 */
         this.authority = props.authority ?? 0;
     }
     /** 从任意输入构造 Stats */

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

@@ -32,9 +32,9 @@ export declare class TaskIdGenerator {
      * ★ Drizzle 类型安全 SELECT + UPDATE
      */
     generateChild(parentId: string): string;
-    /** @private ★ Drizzle 类型安全 COUNT */
-    _getTaskCount(): number;
-    /** @private ★ Drizzle 类型安全 EXISTS */
-    _exists(id: string): boolean;
+    /** ★ Drizzle 类型安全 COUNT */
+    private _getTaskCount;
+    /** ★ Drizzle 类型安全 EXISTS */
+    private _exists;
 }
 export default TaskIdGenerator;

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

@@ -57,12 +57,12 @@ export class TaskIdGenerator {
         this.#drizzle.update(tasks).set({ childSeq: nextSeq }).where(eq(tasks.id, parentId)).run();
         return `${parentId}.${nextSeq}`;
     }
-    /** @private ★ Drizzle 类型安全 COUNT */
+    /** ★ Drizzle 类型安全 COUNT */
     _getTaskCount() {
         const row = this.#drizzle.select({ cnt: sql `COUNT(*)` }).from(tasks).get();
         return row?.cnt || 0;
     }
-    /** @private ★ Drizzle 类型安全 EXISTS */
+    /** ★ Drizzle 类型安全 EXISTS */
     _exists(id) {
         const row = this.#drizzle
             .select({ x: sql `1` })

package/dist/lib/external/lark/LarkTransport.js

@@ -32,15 +32,15 @@ export class LarkTransport {
     #getStatusFn;
     #enqueueIdeFn;
     #isUserAllowed;
-    /** @type {ConversationStore|null} 持久化对话存储 */
+    /** 持久化对话存储 */
     #conversationStore = null;
-    /** @type {Map<string, string>} chatId → conversationId 映射缓存 */
+    /** chatId → conversationId 映射缓存 */
     #chatConversationMap = new Map();
-    /** @type {Map<string, Array<{role: string, content: string}>>} chatId → 最近对话 (降级用) */
+    /** >>} chatId → 最近对话 (降级用) */
     #conversationHistory = new Map();
     /** 对话历史最大轮数 */
     static MAX_HISTORY = 20;
-    /** @type {Map<string, number>} messageId → timestamp, 消息去重 */
+    /** messageId → timestamp, 消息去重 */
     #recentMsgIds = new Map();
     /** 去重 TTL (5 分钟) */
     static DEDUP_TTL = 5 * 60 * 1000;

package/dist/lib/external/mcp/McpServer.d.ts

@@ -18,7 +18,7 @@
  * Handler 实现 → handlers/*.js
  * 整合路由 → handlers/consolidated.js
  */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { McpServer as SdkMcpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { CapabilityProbe } from '#core/capability/CapabilityProbe.js';
 import Logger from '#infra/logging/Logger.js';
 import type { McpContext, McpServiceContainer } from './handlers/types.js';
@@ -65,7 +65,7 @@ export declare class McpServer {
     _session: McpSession;
     _startedAt: number;
     bootstrap: BootstrapLike | null;
-    server: Server | null;
+    sdkServer: SdkMcpServer | null;
     constructor(options?: McpServerOptions);
     /** 共享上下文对象，传给所有 handler */
     get _ctx(): {
@@ -95,23 +95,19 @@ export declare class McpServer {
     _injectDecisions(toolName: string, result: unknown): Promise<unknown>;
     /**
      * 获取 decisions 摘要（带缓存 + 防并发）
-     * @private
      * @returns >>}
      */
-    _getDecisionsSummary(): Promise<DecisionEntry[]>;
+    private _getDecisionsSummary;
     /**
      * 从 DB 查询 decisions 摘要（仅 id + title）
-     * @private
      */
     _fetchDecisionsSummary(): Promise<DecisionEntry[]>;
     /**
      * 从 ready 响应结果中刷新缓存（避免额外 DB 查询）
-     * @private
      */
     _refreshCacheFromReady(readyResult: unknown): void;
     /**
      * 解析工具名到 handler 函数（V3 整合版）
-     * @private
      */
     _resolveHandler(name: string): ToolHandlerFn | null;
     /**