autosnippet 3.2.10 → 3.2.11

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

@@ -0,0 +1,75 @@
+/**
+ * MCP 工具定义 — V3 整合版 (18 agent + 4 admin = 22 工具)
+ *
+ * 从 39 → 22 工具（参数路由合并同类工具 + 外部 Agent 冷启动新架构 + TaskGraph 统一入口）。
+ * TaskGraph: autosnippet_task (统一入口，含 prime/decision/task CRUD)
+ * 每个工具声明增加 tier 字段（agent / admin）。
+ *
+ * inputSchema 由 Zod Schema 自动生成（zodToMcpSchema），消除手写 JSON Schema 双重维护。
+ * Zod Schema → 运行时校验（wrapHandler）+ JSON Schema 声明（ListTools）。
+ *
+ * 外部 Agent 冷启动新工具 (v3.1):
+ *   - autosnippet_bootstrap:          参数化 → 无参数化 Mission Briefing
+ *   - autosnippet_dimension_complete:  维度分析完成通知
+ *   - autosnippet_wiki_plan:           Wiki 主题规划
+ *   - autosnippet_wiki_finalize:       Wiki 元数据 + 去重
+ */
+export declare const TIER_ORDER: {
+    agent: number;
+    admin: number;
+};
+export declare const TOOL_GATEWAY_MAP: {
+    autosnippet_dimension_complete: {
+        action: string;
+        resource: string;
+    };
+    autosnippet_wiki_finalize: {
+        action: string;
+        resource: string;
+    };
+    autosnippet_guard: {
+        resolver: (args: Record<string, unknown>) => {
+            action: string;
+            resource: string;
+        } | null;
+    };
+    autosnippet_skill: {
+        resolver: (args: Record<string, unknown>) => {
+            action: string;
+            resource: string;
+        };
+    };
+    autosnippet_submit_knowledge: {
+        action: string;
+        resource: string;
+    };
+    autosnippet_submit_knowledge_batch: {
+        action: string;
+        resource: string;
+    };
+    autosnippet_save_document: {
+        action: string;
+        resource: string;
+    };
+    autosnippet_task: {
+        resolver: (args: Record<string, unknown>) => {
+            action: string;
+            resource: string;
+        };
+    };
+    autosnippet_enrich_candidates: {
+        action: string;
+        resource: string;
+    };
+    autosnippet_knowledge_lifecycle: {
+        action: string;
+        resource: string;
+    };
+};
+export declare const TOOLS: {
+    name: string;
+    tier: string;
+    description: string;
+    inputSchema: import("./zodToMcpSchema.js").McpInputSchema;
+}[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/lib/external/mcp/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../lib/external/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA4BH,eAAO,MAAM,UAAU;;;CAAyB,CAAC;AAIjD,eAAO,MAAM,gBAAgB;;;;;;;;;;yBASR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;yBAOvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBAML,MAAM;sBAAY,MAAM;;;;;;;;;;;;;;;;yBAS1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;oBAcL,MAAM;sBAAY,MAAM;;;;;;;;;;;CAM9D,CAAC;AAIF,eAAO,MAAM,KAAK;;;;;GAgNjB,CAAC"}

package/dist/lib/external/mcp/tools.js

@@ -0,0 +1,241 @@
+/**
+ * MCP 工具定义 — V3 整合版 (18 agent + 4 admin = 22 工具)
+ *
+ * 从 39 → 22 工具（参数路由合并同类工具 + 外部 Agent 冷启动新架构 + TaskGraph 统一入口）。
+ * TaskGraph: autosnippet_task (统一入口，含 prime/decision/task CRUD)
+ * 每个工具声明增加 tier 字段（agent / admin）。
+ *
+ * inputSchema 由 Zod Schema 自动生成（zodToMcpSchema），消除手写 JSON Schema 双重维护。
+ * Zod Schema → 运行时校验（wrapHandler）+ JSON Schema 声明（ListTools）。
+ *
+ * 外部 Agent 冷启动新工具 (v3.1):
+ *   - autosnippet_bootstrap:          参数化 → 无参数化 Mission Briefing
+ *   - autosnippet_dimension_complete:  维度分析完成通知
+ *   - autosnippet_wiki_plan:           Wiki 主题规划
+ *   - autosnippet_wiki_finalize:       Wiki 元数据 + 去重
+ */
+import { BootstrapInput, CallContextInput, CapabilitiesInput, CheckDuplicateInput, DimensionCompleteInput, EnrichCandidatesInput, GraphInput, GuardInput, HealthInput, KnowledgeInput, KnowledgeLifecycleInput, SaveDocumentInput, SearchInput, SkillInput, StructureInput, SubmitKnowledgeBatchInput, SubmitKnowledgeInput, TaskInput, ValidateCandidateInput, WikiFinalizeInput, WikiPlanInput, } from '#shared/schemas/mcp-tools.js';
+import { zodToMcpSchema } from './zodToMcpSchema.js';
+// ─── Tier 定义 ──────────────────────────────────────────────
+export const TIER_ORDER = { agent: 0, admin: 1 };
+// ─── Gateway 映射（仅写操作需要 gating） ────────────────────
+export const TOOL_GATEWAY_MAP = {
+    // bootstrap — 无参数化 Mission Briefing（只读分析，无需 gating）
+    // autosnippet_bootstrap: null,
+    // dimension_complete — 写操作（recipe tagging + skill creation + checkpoint）
+    autosnippet_dimension_complete: { action: 'knowledge:bootstrap', resource: 'knowledge' },
+    // wiki_finalize — 写操作（meta.json）
+    autosnippet_wiki_finalize: { action: 'knowledge:create', resource: 'knowledge' },
+    // guard 写操作（仅 files 模式）
+    autosnippet_guard: {
+        resolver: (args) => args?.files && Array.isArray(args.files)
+            ? { action: 'guard_rule:check_code', resource: 'guard_rules' }
+            : null, // code 模式只读，跳过 Gateway
+    },
+    // skill 写操作（create/update/delete）
+    autosnippet_skill: {
+        resolver: (args) => ({
+            create: { action: 'create:skills', resource: 'skills' },
+            update: { action: 'update:skills', resource: 'skills' },
+            delete: { action: 'delete:skills', resource: 'skills' },
+        })[args?.operation] || null, // list/load/suggest 只读
+    },
+    // 知识提交
+    autosnippet_submit_knowledge: { action: 'knowledge:create', resource: 'knowledge' },
+    autosnippet_submit_knowledge_batch: { action: 'knowledge:create', resource: 'knowledge' },
+    autosnippet_save_document: { action: 'knowledge:create', resource: 'knowledge' },
+    // task 写操作（create/claim/close/fail/defer/decompose/dep_add + decision 写操作）
+    autosnippet_task: {
+        resolver: (args) => ({
+            create: { action: 'task:create', resource: 'tasks' },
+            claim: { action: 'task:update', resource: 'tasks' },
+            close: { action: 'task:update', resource: 'tasks' },
+            fail: { action: 'task:update', resource: 'tasks' },
+            defer: { action: 'task:update', resource: 'tasks' },
+            progress: { action: 'task:update', resource: 'tasks' },
+            decompose: { action: 'task:create', resource: 'tasks' },
+            dep_add: { action: 'task:update', resource: 'tasks' },
+            record_decision: { action: 'task:create', resource: 'tasks' },
+            revise_decision: { action: 'task:update', resource: 'tasks' },
+            unpin_decision: { action: 'task:update', resource: 'tasks' },
+        })[args?.operation] || null, // prime/ready/show/list/blocked/dep_tree/stats/list_decisions 只读
+    },
+    // admin 工具
+    autosnippet_enrich_candidates: { action: 'knowledge:update', resource: 'knowledge' },
+    autosnippet_knowledge_lifecycle: { action: 'knowledge:update', resource: 'knowledge' },
+};
+// ─── 工具声明 ────────────────────────────────────────────────
+export const TOOLS = [
+    // ══════════════════════════════════════════════════════
+    //  Tier: agent — Agent 核心工具集 (18 个)
+    // ══════════════════════════════════════════════════════
+    // 1. 健康检查
+    {
+        name: 'autosnippet_health',
+        tier: 'agent',
+        description: '检查服务健康状态与知识库统计。total=0 时表示需要冷启动。',
+        inputSchema: zodToMcpSchema(HealthInput),
+    },
+    // 2. 统合搜索（4 → 1）
+    {
+        name: 'autosnippet_search',
+        tier: 'agent',
+        description: '统合搜索入口。支持 4 种模式（mode 参数），返回 byKind 分组结果。',
+        inputSchema: zodToMcpSchema(SearchInput),
+    },
+    // 3. 知识浏览（7 → 1）
+    {
+        name: 'autosnippet_knowledge',
+        tier: 'agent',
+        description: '知识浏览与使用确认。list=列表过滤 | get=单条详情 | insights=质量洞察 | confirm_usage=记录采纳。',
+        inputSchema: zodToMcpSchema(KnowledgeInput),
+    },
+    // 4. 项目结构（3 → 1）
+    {
+        name: 'autosnippet_structure',
+        tier: 'agent',
+        description: '项目结构探查。targets=目标列表 | files=文件列表 | metadata=元数据与依赖。',
+        inputSchema: zodToMcpSchema(StructureInput),
+    },
+    // 5. 知识图谱（4 → 1）
+    {
+        name: 'autosnippet_graph',
+        tier: 'agent',
+        description: '知识图谱查询。query=节点关系 | impact=影响分析 | path=路径查找 | stats=全局统计。',
+        inputSchema: zodToMcpSchema(GraphInput),
+    },
+    // 6. 调用链上下文 (Phase 5)
+    {
+        name: 'autosnippet_call_context',
+        tier: 'agent',
+        description: '查询方法的调用链上下文。\n' +
+            '• callers: 谁调用了这个方法？（调用者链）\n' +
+            '• callees: 这个方法调用了谁？（依赖链）\n' +
+            '• impact: 修改此方法的影响半径分析\n' +
+            '• both: 同时获取调用者和被调用者',
+        inputSchema: zodToMcpSchema(CallContextInput),
+    },
+    // 7. Guard 检查（统一入口）
+    {
+        name: 'autosnippet_guard',
+        tier: 'agent',
+        description: '代码规范检查 & 质量门禁。\n' +
+            '• 无参数 → 自动从 git diff 检测增量文件并检查（编码后推荐用法）\n' +
+            '• files: ["path/to/file.m", ...] → 检查指定文件\n' +
+            '• code: "..." → 单文件内联检查\n' +
+            '每个 violation 内联 recipe 修复指南（doClause + coreCode），直接按指示修复后再次调用。',
+        inputSchema: zodToMcpSchema(GuardInput),
+    },
+    // 7. 提交知识（严格前置校验 + 去重检测）
+    {
+        name: 'autosnippet_submit_knowledge',
+        tier: 'agent',
+        description: '提交单条知识到知识库（V3 统一实体）。严格前置校验，缺少必要字段将被直接拒绝（不入库）。\n' +
+            '所有必填字段必须在单次调用中一次性提供，不要分步提交。\n' +
+            '⚠️ content 必须是对象: { "pattern": "代码片段", "markdown": "## 标题\\n正文...", "rationale": "设计原理" }（pattern/markdown 至少一个 + rationale 必填）\n' +
+            '⚠️ reasoning 必须是对象: { "whyStandard": "原因", "sources": ["file.ts"], "confidence": 0.85 }\n' +
+            '必填: title, language, content, kind, doClause, dontClause, whenClause, coreCode, category, trigger, description, headers, usageGuide, knowledgeType, reasoning',
+        inputSchema: zodToMcpSchema(SubmitKnowledgeInput),
+    },
+    // 8. 批量知识提交
+    {
+        name: 'autosnippet_submit_knowledge_batch',
+        tier: 'agent',
+        description: '批量提交知识条目（V3 统一实体）。每条字段要求同 submit_knowledge。支持去重。\n' +
+            '⚠️ items 数组中每条的 content 和 reasoning 都必须是 JSON 对象（不是字符串）。\n' +
+            'content 格式: { "pattern": "代码...", "markdown": "正文...", "rationale": "原理..." }\n' +
+            'reasoning 格式: { "whyStandard": "原因", "sources": ["file.ts"], "confidence": 0.85 }',
+        inputSchema: zodToMcpSchema(SubmitKnowledgeBatchInput),
+    },
+    // 9. 保存开发文档
+    {
+        name: 'autosnippet_save_document',
+        tier: 'agent',
+        description: '保存开发文档（设计文档、排查报告、ADR 等）。仅需 title + markdown，自动以 dev-document 存储。',
+        inputSchema: zodToMcpSchema(SaveDocumentInput),
+    },
+    // 10. Skill 管理（6 → 1）
+    {
+        name: 'autosnippet_skill',
+        tier: 'agent',
+        description: 'Skill 管理。list=列表 | load=加载 | create=创建 | update=更新 | delete=删除 | suggest=AI推荐。',
+        inputSchema: zodToMcpSchema(SkillInput),
+    },
+    // 11. 冷启动 Mission Briefing（无参数，返回项目分析 + 执行计划）
+    {
+        name: 'autosnippet_bootstrap',
+        tier: 'agent',
+        description: '冷启动 Mission Briefing — 自动分析项目结构、AST、依赖图和 Guard 审计，返回完整的执行计划和维度任务清单。无需任何参数，直接调用即可。不依赖数据库，DB 不可用时也能正常工作。\n' +
+            '💡 建议先加载 Skill 获取详细冷启动指引: autosnippet_skill({ operation: "load", name: "autosnippet-coldstart" })\n' +
+            '返回的 submissionSchema.example 包含完整的提交 JSON 示例，请严格按其格式提交知识。',
+        inputSchema: zodToMcpSchema(BootstrapInput),
+    },
+    // 11b. 维度完成通知
+    {
+        name: 'autosnippet_dimension_complete',
+        tier: 'agent',
+        description: '维度分析完成通知 — Agent 完成一个维度的分析后调用。负责 Recipe 关联、Skill 生成、Checkpoint 保存、进度推送、跨维度 Hints 分发。',
+        inputSchema: zodToMcpSchema(DimensionCompleteInput),
+    },
+    // 11c. Wiki 主题规划
+    {
+        name: 'autosnippet_wiki_plan',
+        tier: 'agent',
+        description: '规划 Wiki 文档生成 — 扫描项目结构、分析 AST 和依赖、整合知识库，返回发现的文档主题及每个主题的数据包。Agent 根据规划自行撰写文章后写入 wiki 目录。',
+        inputSchema: zodToMcpSchema(WikiPlanInput),
+    },
+    // 11d. Wiki 完成（meta.json + 去重）
+    {
+        name: 'autosnippet_wiki_finalize',
+        tier: 'agent',
+        description: '完成 Wiki 生成 — 写入 meta.json、执行去重检查、验证文件完整性。在所有 Wiki 文章写入完成后调用。',
+        inputSchema: zodToMcpSchema(WikiFinalizeInput),
+    },
+    // 12. 能力声明（Agent 自发现）
+    {
+        name: 'autosnippet_capabilities',
+        tier: 'agent',
+        description: '列出所有可用 MCP 工具的概览，供 Agent 自发现服务能力。',
+        inputSchema: zodToMcpSchema(CapabilitiesInput),
+    },
+    // 13. autosnippet_task — 统一任务管理（含 prime/decision/CRUD）
+    {
+        name: 'autosnippet_task',
+        tier: 'agent',
+        description: 'Unified task & decision management. Includes session context (prime), task CRUD, and decision persistence.\n' +
+            'Call prime FIRST at every conversation start to load decisions + tasks + knowledge context.',
+        inputSchema: zodToMcpSchema(TaskInput),
+    },
+    // ══════════════════════════════════════════════════════
+    //  Tier: admin — 管理员/CI 工具 (额外 +4)
+    // ══════════════════════════════════════════════════════
+    // 13. 候选字段诊断
+    {
+        name: 'autosnippet_enrich_candidates',
+        tier: 'admin',
+        description: '候选字段完整性诊断（不使用 AI）。返回 missingFields 列表，Agent 自行补全。',
+        inputSchema: zodToMcpSchema(EnrichCandidatesInput),
+    },
+    // 14. 知识条目生命周期
+    {
+        name: 'autosnippet_knowledge_lifecycle',
+        tier: 'admin',
+        description: '知识条目生命周期操作：submit/approve/reject/publish/deprecate/reactivate/fast_track。',
+        inputSchema: zodToMcpSchema(KnowledgeLifecycleInput),
+    },
+    // 15. 独立候选校验（调试）
+    {
+        name: 'autosnippet_validate_candidate',
+        tier: 'admin',
+        description: '对候选做结构化预校验（5层），调试用（Agent 层的 submit_knowledge 已内置校验）。',
+        inputSchema: zodToMcpSchema(ValidateCandidateInput),
+    },
+    // 16. 独立去重检测（调试）
+    {
+        name: 'autosnippet_check_duplicate',
+        tier: 'admin',
+        description: '相似度检测（调试用，Agent 层的 submit_knowledge 已内置去重）。',
+        inputSchema: zodToMcpSchema(CheckDuplicateInput),
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/lib/external/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../lib/external/mcp/tools.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,32 @@
+/**
+ * zodToMcpSchema.ts — Zod v4 → MCP-compatible JSON Schema 转换器
+ *
+ * 将 Zod schema 转为 MCP SDK 所需的 inputSchema 格式：
+ *   1. 移除 $schema（MCP 不需要 meta-schema 声明）
+ *   2. 带 default 值的字段从 required 中移除（Agent 可省略，Zod parse 自动填充）
+ *   3. 移除 additionalProperties: false（允许前向兼容的额外字段）
+ *   4. 清理 integer 的冗余 min/max 边界（Zod v4 自动加的 ±MAX_SAFE_INTEGER）
+ *
+ * @module external/mcp/zodToMcpSchema
+ */
+import { z } from 'zod';
+/** MCP 工具 inputSchema 的类型化结构 */
+export interface McpInputSchema {
+    type: 'object';
+    properties: Record<string, Record<string, unknown>>;
+    required: string[];
+    [key: string]: unknown;
+}
+/**
+ * 将 Zod schema 转换为 MCP 兼容的 JSON Schema
+ *
+ * @param schema Zod 类型定义
+ * @returns MCP inputSchema 格式的 JSON Schema 对象
+ *
+ * @example
+ *   import { SearchInput } from '#shared/schemas/mcp-tools.js';
+ *   const inputSchema = zodToMcpSchema(SearchInput);
+ *   // → { type: 'object', properties: { query: { type: 'string', minLength: 1 }, ... }, required: ['query'] }
+ */
+export declare function zodToMcpSchema(schema: z.ZodType): McpInputSchema;
+//# sourceMappingURL=zodToMcpSchema.d.ts.map

package/dist/lib/external/mcp/zodToMcpSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodToMcpSchema.d.ts","sourceRoot":"","sources":["../../../../lib/external/mcp/zodToMcpSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA8DD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,cAAc,CAUhE"}

package/dist/lib/external/mcp/zodToMcpSchema.js

@@ -0,0 +1,84 @@
+/**
+ * zodToMcpSchema.ts — Zod v4 → MCP-compatible JSON Schema 转换器
+ *
+ * 将 Zod schema 转为 MCP SDK 所需的 inputSchema 格式：
+ *   1. 移除 $schema（MCP 不需要 meta-schema 声明）
+ *   2. 带 default 值的字段从 required 中移除（Agent 可省略，Zod parse 自动填充）
+ *   3. 移除 additionalProperties: false（允许前向兼容的额外字段）
+ *   4. 清理 integer 的冗余 min/max 边界（Zod v4 自动加的 ±MAX_SAFE_INTEGER）
+ *
+ * @module external/mcp/zodToMcpSchema
+ */
+import { z } from 'zod';
+/**
+ * 递归清理 JSON Schema 对象
+ */
+function cleanJsonSchema(obj) {
+    const cleaned = { ...obj };
+    // 移除顶层 $schema
+    delete cleaned['$schema'];
+    // 移除 additionalProperties: false
+    if (cleaned['additionalProperties'] === false) {
+        delete cleaned['additionalProperties'];
+    }
+    // 清理 integer 的冗余边界
+    if (cleaned['type'] === 'integer') {
+        if (cleaned['minimum'] === -9007199254740991) {
+            delete cleaned['minimum'];
+        }
+        if (cleaned['maximum'] === 9007199254740991) {
+            delete cleaned['maximum'];
+        }
+    }
+    // 带 default 的字段从 required 中移除
+    const properties = cleaned['properties'];
+    if (properties && Array.isArray(cleaned['required'])) {
+        const required = cleaned['required'].filter((key) => {
+            const prop = properties[key];
+            return prop && !('default' in prop);
+        });
+        cleaned['required'] = required.length > 0 ? required : [];
+    }
+    // 递归处理 properties 内部的 object/array 类型
+    if (properties) {
+        const cleanedProps = {};
+        for (const [key, propSchema] of Object.entries(properties)) {
+            cleanedProps[key] = cleanJsonSchema(propSchema);
+        }
+        cleaned['properties'] = cleanedProps;
+    }
+    // 递归处理 items（数组元素）
+    if (cleaned['items'] && typeof cleaned['items'] === 'object') {
+        cleaned['items'] = cleanJsonSchema(cleaned['items']);
+    }
+    // 递归处理 anyOf / oneOf / allOf（用于 union / discriminatedUnion / intersection）
+    for (const keyword of ['anyOf', 'oneOf', 'allOf']) {
+        if (Array.isArray(cleaned[keyword])) {
+            cleaned[keyword] = cleaned[keyword].map(cleanJsonSchema);
+        }
+    }
+    return cleaned;
+}
+/**
+ * 将 Zod schema 转换为 MCP 兼容的 JSON Schema
+ *
+ * @param schema Zod 类型定义
+ * @returns MCP inputSchema 格式的 JSON Schema 对象
+ *
+ * @example
+ *   import { SearchInput } from '#shared/schemas/mcp-tools.js';
+ *   const inputSchema = zodToMcpSchema(SearchInput);
+ *   // → { type: 'object', properties: { query: { type: 'string', minLength: 1 }, ... }, required: ['query'] }
+ */
+export function zodToMcpSchema(schema) {
+    const raw = z.toJSONSchema(schema);
+    const cleaned = cleanJsonSchema(raw);
+    // 保证 type/properties/required 字段存在
+    return {
+        type: 'object',
+        properties: cleaned['properties'] || {},
+        required: cleaned['required'] || [],
+        ...cleaned,
+    };
+}
+//# sourceMappingURL=zodToMcpSchema.js.map

package/dist/lib/external/mcp/zodToMcpSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodToMcpSchema.js","sourceRoot":"","sources":["../../../../lib/external/mcp/zodToMcpSchema.ts"],"names":[],"mappings":"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"}

package/dist/lib/http/HttpServer.d.ts

@@ -0,0 +1,83 @@
+/**
+ * HTTP Server - AutoSnippet 2.0
+ * 基于 Express 框架的 REST API 服务器
+ * 集成监控、缓存和错误追踪
+ */
+import type { Server } from 'node:http';
+import express, { type Application } from 'express';
+import { CapabilityProbe } from '../core/capability/CapabilityProbe.js';
+import Logger from '../infrastructure/logging/Logger.js';
+import { type ErrorTracker } from '../infrastructure/monitoring/ErrorTracker.js';
+interface HttpServerConfig {
+    port: number;
+    host: string;
+    enableMonitoring: boolean;
+    cacheMode: string;
+    corsOrigin?: string;
+    [key: string]: unknown;
+}
+/** Type for the winston Logger instance returned by Logger.getInstance() */
+type AppLogger = ReturnType<typeof Logger.getInstance>;
+export declare class HttpServer {
+    app: Application;
+    cacheAdapter: unknown;
+    capabilityProbe: CapabilityProbe | null;
+    config: HttpServerConfig;
+    errorTracker: ErrorTracker | null;
+    logger: AppLogger;
+    performanceMonitor: {
+        middleware(): express.RequestHandler;
+        shutdown(): void;
+    } | null;
+    realtimeService: Record<string, unknown> | null;
+    server: Server | null;
+    constructor(config?: Partial<HttpServerConfig>);
+    /**
+     * 初始化服务器
+     */
+    initialize(): Promise<void>;
+    /**
+     * 初始化服务（监控、缓存等）
+     */
+    initializeServices(): Promise<void>;
+    /**
+     * 设置中间件
+     */
+    setupMiddleware(): void;
+    /**
+     * 注册 Gateway Actions
+     */
+    registerGatewayActions(): void;
+    /**
+     * 设置路由
+     */
+    setupRoutes(): void;
+    /**
+     * 设置错误处理
+     */
+    setupErrorHandling(): void;
+    /**
+     * 启动服务器
+     */
+    start(): Promise<unknown>;
+    /**
+     * 停止服务器
+     */
+    stop(): Promise<unknown>;
+    /**
+     * 获取 Express 应用实例
+     */
+    getApp(): express.Application;
+    /**
+     * 挂载 Dashboard 静态资源（生产模式：直接托管预构建产物）
+     * 必须在 initialize() + start() 之后调用
+     * @param {string} distDir - dashboard/dist 目录的绝对路径
+     */
+    mountDashboard(distDir: string): void;
+    /**
+     * 获取服务器实例
+     */
+    getServer(): Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse> | null;
+}
+export default HttpServer;
+//# sourceMappingURL=HttpServer.d.ts.map

package/dist/lib/http/HttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpServer.d.ts","sourceRoot":"","sources":["../../../lib/http/HttpServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGxC,OAAO,OAAO,EAAE,EAAE,KAAK,WAAW,EAAkD,MAAM,SAAS,CAAC;AAEpG,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAGxE,OAAO,MAAM,MAAM,qCAAqC,CAAC;AACzD,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,8CAA8C,CAAC;AA8BnG,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAKD,4EAA4E;AAC5E,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvD,qBAAa,UAAU;IACrB,GAAG,EAAE,WAAW,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,SAAS,CAAC;IAClB,kBAAkB,EAAE;QAAE,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;QAAC,QAAQ,IAAI,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACtF,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBACV,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM;IAmBlD;;OAEG;IACG,UAAU;IAyBhB;;OAEG;IACG,kBAAkB;IA0BxB;;OAEG;IACH,eAAe;IAgFf;;OAEG;IACH,sBAAsB;IAatB;;OAEG;IACH,WAAW;IA4GX;;OAEG;IACH,kBAAkB;IAUlB;;OAEG;IACG,KAAK;IA6CX;;OAEG;IACG,IAAI;IA4CV;;OAEG;IACH,MAAM;IAIN;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM;IAmC9B;;OAEG;IACH,SAAS;CAGV;AAED,eAAe,UAAU,CAAC"}