spectra-cli 4.1.1

package/dist/hooks/hook-installer.js

@@ -0,0 +1,164 @@
+/**
+ * Claude Code PreToolUse hook 安装/卸载核心逻辑
+ * 包含：HookConfig/ClaudeSettings 类型定义、shell 脚本生成、幂等安装/卸载
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, chmodSync } from 'node:fs';
+import { join } from 'node:path';
+import { writeAtomicJson } from '../utils/atomic-write.js';
+/** spectra-context.sh 的 command 标识符（用于幂等判定和过滤） */
+const HOOK_COMMAND_MARKER = 'spectra-context.sh';
+/** PreToolUse hook 条目定义 */
+const HOOK_ENTRY = {
+    matcher: 'Glob|Grep',
+    command: 'bash specs/_meta/hooks/spectra-context.sh',
+};
+/**
+ * 生成 spectra-context.sh 脚本内容
+ * - 使用 node -e 内联 JSON 解析，避免依赖 jq
+ * - 任何异常均 exit 0，不阻塞 Claude Code 工具调用
+ */
+export function generateContextScript() {
+    return `#!/bin/bash
+set -euo pipefail
+
+GRAPH_FILE="specs/_meta/graph.json"
+REPORT_FILE="specs/_meta/GRAPH_REPORT.md"
+
+# graph.json 不存在时静默降级
+[ -f "$GRAPH_FILE" ] || exit 0
+
+# 读取节点数
+NODE_COUNT=$(node -e "
+  try {
+    const g = JSON.parse(require('fs').readFileSync('$GRAPH_FILE','utf8'));
+    console.log(g.graph && g.graph.nodeCount != null ? g.graph.nodeCount : 0);
+  } catch(e) { process.exit(0); }
+")
+
+# 从 GRAPH_REPORT.md 提取社区数（使用 node 解析，兼容 macOS）
+COMMUNITY_COUNT="N/A"
+if [ -f "$REPORT_FILE" ]; then
+  COMMUNITY_COUNT=$(node -e "
+    try {
+      const t = require('fs').readFileSync('$REPORT_FILE','utf8');
+      const m = t.match(/\\| 社区 \\| (\\d+)/);
+      console.log(m ? m[1] : 'N/A');
+    } catch(e) { console.log('N/A'); }
+  " 2>/dev/null || echo "N/A")
+fi
+
+# 读取 God Nodes（按 degree 排序取前 5）
+GOD_NODES=$(node -e "
+  try {
+    const g = JSON.parse(require('fs').readFileSync('$GRAPH_FILE','utf8'));
+    const nodes = (g.nodes || [])
+      .filter(function(n) { return n.metadata && n.metadata.degree != null; })
+      .sort(function(a,b) { return (b.metadata.degree - a.metadata.degree); })
+      .slice(0,5)
+      .map(function(n) { return n.label + '(' + n.metadata.degree + ')'; })
+      .join(', ');
+    console.log(nodes || 'none');
+  } catch(e) { console.log('none'); }
+")
+
+echo "spectra: Knowledge graph loaded (\$NODE_COUNT nodes · \$COMMUNITY_COUNT communities)"
+echo "God nodes: \$GOD_NODES"
+echo "→ Read specs/_meta/GRAPH_REPORT.md for the full knowledge graph report."
+
+exit 0
+`;
+}
+/**
+ * 安装 Claude Code PreToolUse hook
+ * - 幂等：已安装时打印提示并返回，不重复写入
+ * - 备份：写入前先 copyFileSync 到 .bak
+ * - 原子写入：使用 writeAtomicJson
+ * @param projectRoot - 项目根目录绝对路径
+ */
+export function installClaudeHook(projectRoot) {
+    const claudeDir = join(projectRoot, '.claude');
+    const settingsPath = join(claudeDir, 'settings.json');
+    // 确保 .claude/ 目录存在
+    mkdirSync(claudeDir, { recursive: true });
+    // 读取或初始化 settings.json
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        const raw = readFileSync(settingsPath, 'utf-8');
+        try {
+            settings = JSON.parse(raw);
+        }
+        catch {
+            throw new Error('[spectra] settings.json 格式错误，请手动修复后重试。');
+        }
+    }
+    // 幂等判定：检查是否已安装（防御 PreToolUse 被写成非数组）
+    const rawHooks = settings.hooks?.PreToolUse;
+    const existingHooks = Array.isArray(rawHooks) ? rawHooks : [];
+    const alreadyInstalled = existingHooks.some(h => h.command.includes(HOOK_COMMAND_MARKER));
+    if (alreadyInstalled) {
+        console.log('[spectra] hook already installed, skipping.');
+        return;
+    }
+    // 备份现有 settings.json
+    if (existsSync(settingsPath)) {
+        copyFileSync(settingsPath, `${settingsPath}.bak`);
+    }
+    // 深度合并：保留所有已有字段，仅追加 PreToolUse 条目
+    const merged = {
+        ...settings,
+        hooks: {
+            ...settings.hooks,
+            PreToolUse: [...existingHooks, HOOK_ENTRY],
+        },
+    };
+    // 原子写入 settings.json
+    writeAtomicJson(settingsPath, merged);
+    console.log('[spectra] PreToolUse hook installed to .claude/settings.json');
+    // 生成 shell 脚本
+    const hooksDir = join(projectRoot, 'specs', '_meta', 'hooks');
+    mkdirSync(hooksDir, { recursive: true });
+    const scriptPath = join(hooksDir, 'spectra-context.sh');
+    writeFileSync(scriptPath, generateContextScript(), 'utf-8');
+    chmodSync(scriptPath, 0o755);
+    console.log('[spectra] Hook script written to specs/_meta/hooks/spectra-context.sh');
+}
+/**
+ * 卸载 Claude Code PreToolUse hook
+ * - 幂等：未找到时静默退出
+ * - 过滤掉 command 含 spectra-context.sh 的条目，保留其他条目
+ * @param projectRoot - 项目根目录绝对路径
+ */
+export function removeClaudeHook(projectRoot) {
+    const settingsPath = join(projectRoot, '.claude', 'settings.json');
+    if (!existsSync(settingsPath)) {
+        console.log('[spectra] hook not found, nothing to remove.');
+        return;
+    }
+    const raw = readFileSync(settingsPath, 'utf-8');
+    let settings;
+    try {
+        settings = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('[spectra] settings.json 格式错误，请手动修复后重试。');
+    }
+    const rawHooks = settings.hooks?.PreToolUse;
+    const existingHooks = Array.isArray(rawHooks) ? rawHooks : [];
+    const spectraHook = existingHooks.find(h => h.command.includes(HOOK_COMMAND_MARKER));
+    if (!spectraHook) {
+        console.log('[spectra] hook not found, nothing to remove.');
+        return;
+    }
+    // 过滤掉 spectra hook，保留其他条目
+    const filtered = existingHooks.filter(h => !h.command.includes(HOOK_COMMAND_MARKER));
+    const updated = {
+        ...settings,
+        hooks: {
+            ...settings.hooks,
+            PreToolUse: filtered,
+        },
+    };
+    writeAtomicJson(settingsPath, updated);
+    console.log('[spectra] PreToolUse hook removed from .claude/settings.json');
+}
+//# sourceMappingURL=hook-installer.js.map

package/dist/hooks/hook-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-installer.js","sourceRoot":"","sources":["../../src/hooks/hook-installer.ts"],"names":[],"mappings":"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"}

package/dist/installer/skill-installer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Skill 安装/卸载核心逻辑
+ * 供 init 命令和 postinstall/preuninstall 脚本共享
+ */
+/** 可安装的 skill 单元 */
+export interface SkillDefinition {
+    readonly name: string;
+    readonly content: string;
+}
+/** Skill 目标平台 */
+export type SkillTargetPlatform = 'claude' | 'codex';
+/** 安装选项 */
+export interface InstallOptions {
+    /** 安装目标基础路径（如 /path/to/project/.claude/skills/） */
+    targetDir: string;
+    /** 安装模式标记（影响日志输出） */
+    mode: 'project' | 'global';
+    /** 目标平台（Claude Code / Codex） */
+    platform: SkillTargetPlatform;
+}
+/** 移除选项 */
+export interface RemoveOptions {
+    /** 目标基础路径 */
+    targetDir: string;
+    /** 移除模式标记 */
+    mode: 'project' | 'global';
+    /** 目标平台（Claude Code / Codex） */
+    platform: SkillTargetPlatform;
+}
+/** 单个 skill 的安装/移除结果 */
+export interface InstallResult {
+    skillName: string;
+    status: 'installed' | 'updated' | 'removed' | 'skipped' | 'failed';
+    targetPath: string;
+    error?: string;
+}
+/** 一次完整安装/移除操作的汇总 */
+export interface InstallSummary {
+    mode: 'project' | 'global';
+    action: 'install' | 'remove';
+    platform: SkillTargetPlatform;
+    results: InstallResult[];
+    targetBasePath: string;
+}
+/**
+ * 将 Skill Pack 安装到指定目标位置
+ * 单个 skill 失败不中断其他 skill 的安装
+ */
+export declare function installSkills(options: InstallOptions): InstallSummary;
+/**
+ * 从指定目标位置移除已安装的 skill
+ * 单个 skill 删除失败不中断其他
+ */
+export declare function removeSkills(options: RemoveOptions): InstallSummary;
+/**
+ * 解析安装目标目录的绝对路径
+ */
+export declare function resolveTargetDir(mode: 'project' | 'global', platform: SkillTargetPlatform): string;
+/**
+ * 格式化安装/移除结果为用户友好的中文输出
+ */
+export declare function formatSummary(summary: InstallSummary): string;
+//# sourceMappingURL=skill-installer.d.ts.map

package/dist/installer/skill-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-installer.d.ts","sourceRoot":"","sources":["../../src/installer/skill-installer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,oBAAoB;AACpB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,iBAAiB;AACjB,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAErD,WAAW;AACX,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,WAAW;AACX,MAAM,WAAW,aAAa;IAC5B,aAAa;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,wBAAwB;AACxB,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAqB;AACrB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC3B,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CA0CrE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAyCnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,GAAG,QAAQ,EAC1B,QAAQ,EAAE,mBAAmB,GAC5B,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA4E7D"}

package/dist/installer/skill-installer.js

@@ -0,0 +1,203 @@
+/**
+ * Skill 安装/卸载核心逻辑
+ * 供 init 命令和 postinstall/preuninstall 脚本共享
+ */
+import { mkdirSync, writeFileSync, existsSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { getSkillDefinitionsForPlatform } from './skill-templates.js';
+// ============================================================
+// 核心函数
+// ============================================================
+/**
+ * 将 Skill Pack 安装到指定目标位置
+ * 单个 skill 失败不中断其他 skill 的安装
+ */
+export function installSkills(options) {
+    const { targetDir, mode, platform } = options;
+    const results = [];
+    const skillDefinitions = getSkillDefinitionsForPlatform(platform);
+    for (const skill of skillDefinitions) {
+        const skillDir = join(targetDir, skill.name);
+        const targetFile = join(skillDir, 'SKILL.md');
+        try {
+            // 检测是否已存在（区分 installed vs updated）
+            const alreadyExists = existsSync(targetFile);
+            // 递归创建目录
+            mkdirSync(skillDir, { recursive: true });
+            // 写入 SKILL.md
+            writeFileSync(targetFile, skill.content, 'utf-8');
+            results.push({
+                skillName: skill.name,
+                status: alreadyExists ? 'updated' : 'installed',
+                targetPath: targetFile,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            results.push({
+                skillName: skill.name,
+                status: 'failed',
+                targetPath: targetFile,
+                error: message,
+            });
+        }
+    }
+    return {
+        mode,
+        action: 'install',
+        platform,
+        results,
+        targetBasePath: targetDir,
+    };
+}
+/**
+ * 从指定目标位置移除已安装的 skill
+ * 单个 skill 删除失败不中断其他
+ */
+export function removeSkills(options) {
+    const { targetDir, mode, platform } = options;
+    const results = [];
+    const skillDefinitions = getSkillDefinitionsForPlatform(platform);
+    for (const skill of skillDefinitions) {
+        const skillDir = join(targetDir, skill.name);
+        try {
+            if (existsSync(skillDir)) {
+                rmSync(skillDir, { recursive: true, force: true });
+                results.push({
+                    skillName: skill.name,
+                    status: 'removed',
+                    targetPath: join(skillDir, 'SKILL.md'),
+                });
+            }
+            else {
+                results.push({
+                    skillName: skill.name,
+                    status: 'skipped',
+                    targetPath: join(skillDir, 'SKILL.md'),
+                });
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            results.push({
+                skillName: skill.name,
+                status: 'failed',
+                targetPath: join(skillDir, 'SKILL.md'),
+                error: message,
+            });
+        }
+    }
+    return {
+        mode,
+        action: 'remove',
+        platform,
+        results,
+        targetBasePath: targetDir,
+    };
+}
+/**
+ * 解析安装目标目录的绝对路径
+ */
+export function resolveTargetDir(mode, platform) {
+    const rootDir = platform === 'codex' ? '.codex' : '.claude';
+    if (mode === 'global') {
+        return join(homedir(), rootDir, 'skills');
+    }
+    return join(process.cwd(), rootDir, 'skills');
+}
+/**
+ * 格式化安装/移除结果为用户友好的中文输出
+ */
+export function formatSummary(summary) {
+    const { action, results, mode, platform } = summary;
+    const lines = [];
+    const platformLabel = platform === 'codex' ? 'Codex' : 'Claude Code';
+    const platformSuffix = platform === 'codex' ? `（${platformLabel}）` : '';
+    // 判断是否全部为同一状态
+    const allSkipped = results.every((r) => r.status === 'skipped');
+    const hasFailure = results.some((r) => r.status === 'failed');
+    const allFailed = results.every((r) => r.status === 'failed');
+    // 移除模式：全部 skipped
+    if (action === 'remove' && allSkipped) {
+        return '未检测到已安装的 spectra skills，无需清理';
+    }
+    // 标题
+    if (action === 'install') {
+        const allUpdated = results.every((r) => r.status === 'updated' || r.status === 'failed');
+        const hasAnyUpdated = results.some((r) => r.status === 'updated');
+        if (hasFailure && !allFailed) {
+            if (platform === 'codex') {
+                lines.push('spectra skills 安装完成（Codex，部分失败）:');
+            }
+            else {
+                lines.push('spectra skills 安装完成（部分失败）:');
+            }
+        }
+        else if (hasAnyUpdated && allUpdated && !hasFailure) {
+            lines.push(`spectra skills 已更新${platformSuffix}:`);
+        }
+        else if (mode === 'global') {
+            lines.push(`spectra skills 已安装到全局目录${platformSuffix}:`);
+        }
+        else {
+            lines.push(`spectra skills 安装完成${platformSuffix}:`);
+        }
+    }
+    else {
+        lines.push(`spectra skills 已移除${platformSuffix}:`);
+    }
+    // 逐项状态
+    for (const result of results) {
+        // 用相对路径显示
+        const displayPath = formatDisplayPath(result, summary);
+        switch (result.status) {
+            case 'installed':
+                lines.push(`  ✓ 已安装: ${displayPath}`);
+                break;
+            case 'updated':
+                lines.push(`  ✓ 已更新: ${displayPath}`);
+                break;
+            case 'removed':
+                lines.push(`  ✓ 已删除: ${formatDisplayDir(result, summary)}`);
+                break;
+            case 'skipped':
+                // 移除时 skipped 不额外输出
+                break;
+            case 'failed':
+                lines.push(`  ⚠ 失败: ${displayPath} — ${result.error ?? '未知错误'}`);
+                break;
+        }
+    }
+    // 安装成功后的提示
+    if (action === 'install' && !allFailed) {
+        lines.push('');
+        if (mode === 'global') {
+            lines.push('注意: 全局 skill 优先级高于项目级 skill');
+        }
+        else if (platform === 'codex') {
+            lines.push('提示: 在 Codex 中可通过提及 $spectra 触发 skill');
+        }
+        else {
+            lines.push('提示: 在 Claude Code 中使用 /spectra 即可调用');
+        }
+    }
+    return lines.join('\n');
+}
+/** 格式化显示路径（文件） */
+function formatDisplayPath(result, summary) {
+    const rootDir = summary.platform === 'codex' ? '.codex' : '.claude';
+    if (summary.mode === 'global') {
+        return `~/${rootDir}/skills/${result.skillName}/SKILL.md`;
+    }
+    return `${rootDir}/skills/${result.skillName}/SKILL.md`;
+}
+/** 格式化显示路径（目录） */
+function formatDisplayDir(result, summary) {
+    const rootDir = summary.platform === 'codex' ? '.codex' : '.claude';
+    if (summary.mode === 'global') {
+        return `~/${rootDir}/skills/${result.skillName}/`;
+    }
+    return `${rootDir}/skills/${result.skillName}/`;
+}
+//# sourceMappingURL=skill-installer.js.map

package/dist/installer/skill-installer.js.map

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

package/dist/installer/skill-templates.d.ts

@@ -0,0 +1,19 @@
+/**
+ * spectra Skill 模板分发合同
+ *
+ * canonical source:
+ *   plugins/spectra/skills/<skill>/SKILL.md
+ *
+ * compatibility mirrors:
+ *   src/skills-global/<skill>/SKILL.md
+ *   skills/<skill>/SKILL.md
+ */
+import type { SkillDefinition, SkillTargetPlatform } from './skill-installer.js';
+export declare const SKILL_DEFINITIONS: readonly SkillDefinition[];
+/**
+ * 获取指定平台的 Skill 定义集合
+ * 当前保持 spectra 与 spec-driver 的安装边界隔离：
+ * - spectra init 仅安装 spectra 三件套
+ */
+export declare function getSkillDefinitionsForPlatform(_platform: SkillTargetPlatform): readonly SkillDefinition[];
+//# sourceMappingURL=skill-templates.d.ts.map

package/dist/installer/skill-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-templates.d.ts","sourceRoot":"","sources":["../../src/installer/skill-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAgC9B,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAGrD,CAAC;AAEJ;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,mBAAmB,GAC7B,SAAS,eAAe,EAAE,CAE5B"}

package/dist/installer/skill-templates.js

@@ -0,0 +1,42 @@
+/**
+ * spectra Skill 模板分发合同
+ *
+ * canonical source:
+ *   plugins/spectra/skills/<skill>/SKILL.md
+ *
+ * compatibility mirrors:
+ *   src/skills-global/<skill>/SKILL.md
+ *   skills/<skill>/SKILL.md
+ */
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const SPECTRA_SKILL_NAMES = [
+    'spectra',
+    'spectra-batch',
+    'spectra-diff',
+];
+function resolveRepoRoot() {
+    const currentFile = fileURLToPath(import.meta.url);
+    return path.resolve(path.dirname(currentFile), '..', '..');
+}
+function resolveCanonicalSkillPath(skillName) {
+    return path.join(resolveRepoRoot(), 'plugins', 'spectra', 'skills', skillName, 'SKILL.md');
+}
+function loadCanonicalSkillDefinition(skillName) {
+    const filePath = resolveCanonicalSkillPath(skillName);
+    return {
+        name: skillName,
+        content: readFileSync(filePath, 'utf-8'),
+    };
+}
+export const SKILL_DEFINITIONS = SPECTRA_SKILL_NAMES.map((skillName) => loadCanonicalSkillDefinition(skillName));
+/**
+ * 获取指定平台的 Skill 定义集合
+ * 当前保持 spectra 与 spec-driver 的安装边界隔离：
+ * - spectra init 仅安装 spectra 三件套
+ */
+export function getSkillDefinitionsForPlatform(_platform) {
+    return SKILL_DEFINITIONS;
+}
+//# sourceMappingURL=skill-templates.js.map

package/dist/installer/skill-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-templates.js","sourceRoot":"","sources":["../../src/installer/skill-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,mBAAmB,GAAG;IAC1B,SAAS;IACT,eAAe;IACf,cAAc;CACN,CAAC;AAEX,SAAS,eAAe;IACtB,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,yBAAyB,CAAC,SAAiB;IAClD,OAAO,IAAI,CAAC,IAAI,CACd,eAAe,EAAE,EACjB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,CACX,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,SAAiB;IACrD,MAAM,QAAQ,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACtD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAC5B,mBAAmB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACpC,4BAA4B,CAAC,SAAS,CAAC,CACxC,CAAC;AAEJ;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAC5C,SAA8B;IAE9B,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/mcp/graph-tools.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Graph Query MCP Tool 注册模块
+ * 注册 6 个图谱查询工具：graph_query、graph_node、graph_path、graph_community、graph_god_nodes、graph_hyperedges
+ * 采用 lazy load 策略：首次调用时加载 _meta/graph.json，后续复用内存缓存
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * 清除缓存，下次调用时重新从磁盘加载
+ * 供外部调用（如图谱更新后刷新缓存）
+ */
+export declare function reloadGraph(): void;
+/**
+ * 向 MCP Server 注册所有图谱查询工具
+ * @param server - McpServer 实例
+ */
+export declare function registerGraphTools(server: McpServer): void;
+//# sourceMappingURL=graph-tools.d.ts.map

package/dist/mcp/graph-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-tools.d.ts","sourceRoot":"","sources":["../../src/mcp/graph-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6BzE;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AA+BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8O1D"}