mingpan 0.1.3 → 0.1.5

package/dist/tools/baziTools.js

@@ -0,0 +1,331 @@
+"use strict";
+/**
+ * 八字命理 MCP 工具
+ *
+ * 工具列表：
+ * - bazi_basic      基礎排盤（四柱、藏干、十神、五行力量）
+ * - bazi_dayun      大運列表
+ * - bazi_liunian    流年列表
+ * - bazi_liuyue     流月列表（節氣月）
+ * - bazi_liuri      流日列表
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerBaziTools = registerBaziTools;
+const zod_1 = require("zod");
+const BaziService_1 = require("../services/bazi/BaziService");
+const LiuNianCalculator_1 = require("../services/bazi/calculators/LiuNianCalculator");
+const DaYunCalculator_1 = require("../services/bazi/calculators/DaYunCalculator");
+const LuckCycleCalculator_1 = require("../services/bazi/calculators/LuckCycleCalculator");
+const LiuYueCalculator_1 = require("../services/bazi/calculators/LiuYueCalculator");
+const LiuRiCalculator_1 = require("../services/bazi/calculators/LiuRiCalculator");
+const fortuneTextRenderer_1 = require("../output/fortuneTextRenderer");
+const listTextRenderer_1 = require("../output/listTextRenderer");
+const schemas_1 = require("./schemas");
+const baziService = new BaziService_1.BaziService({ debug: false });
+const countField = zod_1.z.number().int().min(1).max(12).optional().default(10).describe('Number of periods to display (default 10)');
+const ganzhiYearField = zod_1.z.union([
+    zod_1.z.string().describe("GanZhi year like '乙巳'"),
+    zod_1.z.number().int().min(1900).max(2100).describe('Gregorian year like 2025'),
+]);
+function registerBaziTools(server) {
+    server.registerTool('bazi_basic', {
+        title: '八字基礎排盤',
+        description: `計算八字四柱（基礎排盤）。
+
+輸入出生時間，返回由節氣與曆法精確推算的確定性結果：
+- 年柱、月柱、日柱、時柱干支（含節氣月邊界、晚子時處理）及六十甲子納音
+- 天干十神與藏干十神（各支藏干逐個標注，※為本氣）
+- 十二長生（自坐）
+- 命宮（三命通會子平起法）、胎元（月干進一支進三）
+- 日柱旬空
+- 公曆/農曆出生日期對照
+
+時區說明：默認按北京時間排盤；海外出生者請提供 timezone 參數，
+系統將換算為北京時間後計算；可提供 longitude 做真太陽時校正。
+
+定位說明：本工具只負責確定性排盤（干支、藏干、十神）。
+五行強弱、格局、用神、神煞等屬解讀層，無權威統一口徑，
+請由 AI 依據四柱自行分析。
+
+大運/流年/流月/流日請使用對應列表工具。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_basic', async () => {
+        const { normalized, sourceTimezone } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await baziService.calculate({
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            minute: normalized.minute,
+            gender: normalized.gender,
+            longitude: normalized.longitude,
+        });
+        const birthDate = new Date(Date.UTC(normalized.year, normalized.month - 1, normalized.day, normalized.hour, normalized.minute));
+        const trueSolarTime = result.birthInfo?.trueSolarTime instanceof Date
+            ? result.birthInfo.trueSolarTime
+            : undefined;
+        const text = (0, fortuneTextRenderer_1.renderBaziText)({ bazi: result, gender: normalized.gender, birthDate, trueSolarTime }, { includePersonal: false, includeLocation: !!normalized.longitude });
+        return (0, schemas_1.timezoneNote)(sourceTimezone) + text;
+    }));
+    server.registerTool('bazi_dayun', {
+        title: '八字大運列表',
+        description: `八字大運列表。
+
+返回命主一生的大運週期（十年一運）：
+- 大運干支
+- 起止虛歲
+- 對應公曆年份
+- 起運方向（順行/逆行）
+- 起運年齡
+
+用於了解人生各階段的運勢大框架。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            count: countField,
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_dayun', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await baziService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, minute: normalized.minute,
+            gender: normalized.gender, longitude: normalized.longitude,
+        });
+        if (!result.chart || !result.birthInfo) {
+            throw new Error('Failed to calculate BaZi chart');
+        }
+        const daYunList = DaYunCalculator_1.DaYunCalculator.calculate(result.chart, result.birthInfo, normalized.gender, { startYear: normalized.year, endYear: normalized.year + 100 });
+        const direction = LuckCycleCalculator_1.LuckCycleCalculator.calLuckySequence(normalized.gender, result.chart.year.stem) === 'forward' ? '顺行' : '逆行';
+        const startAge = daYunList.length > 0 ? daYunList[0].startAge : 1;
+        const startYear = normalized.year + startAge - 1;
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            dayMaster: result.chart.day.stem,
+            yearPillar: { stem: result.chart.year.stem, branch: result.chart.year.branch },
+            monthPillar: { stem: result.chart.month.stem, branch: result.chart.month.branch },
+            dayPillar: { stem: result.chart.day.stem, branch: result.chart.day.branch },
+            hourPillar: { stem: result.chart.hour.stem, branch: result.chart.hour.branch },
+            direction,
+            startAge,
+            startYear,
+        };
+        return (0, listTextRenderer_1.renderBaziDaYunList)(daYunList.slice(0, args.count), options);
+    }));
+    server.registerTool('bazi_liunian', {
+        title: '八字流年列表',
+        description: `八字流年列表。
+
+返回指定年份範圍內的流年信息：
+- 公曆年份
+- 干支年
+- 虛歲
+- 所屬大運
+
+用於分析多年運勢趨勢。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            startYear: zod_1.z.number().int().min(1900).max(2100).describe('Start year for the range'),
+            endYear: zod_1.z.number().int().min(1900).max(2100).describe('End year for the range'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_liunian', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await baziService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, minute: normalized.minute,
+            gender: normalized.gender, longitude: normalized.longitude,
+        });
+        if (!result.chart || !result.birthInfo) {
+            throw new Error('Failed to calculate BaZi chart');
+        }
+        const daYunList = DaYunCalculator_1.DaYunCalculator.calculate(result.chart, result.birthInfo, normalized.gender, { startYear: normalized.year, endYear: normalized.year + 100 });
+        const liuNianList = LiuNianCalculator_1.LiuNianCalculator.calculate(result.chart, normalized.year, args.startYear, args.endYear);
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            dayMaster: result.chart.day.stem,
+            yearPillar: { stem: result.chart.year.stem, branch: result.chart.year.branch },
+            monthPillar: { stem: result.chart.month.stem, branch: result.chart.month.branch },
+            dayPillar: { stem: result.chart.day.stem, branch: result.chart.day.branch },
+            hourPillar: { stem: result.chart.hour.stem, branch: result.chart.hour.branch },
+            startYear: args.startYear,
+            endYear: args.endYear,
+            daYunList,
+        };
+        return (0, listTextRenderer_1.renderBaziLiuNianList)(liuNianList, options);
+    }));
+    server.registerTool('bazi_liuyue', {
+        title: '八字流月列表',
+        description: `八字流月列表。
+
+重要：八字流月使用【節氣月】，非農曆月！
+- 以節氣為邊界（立春起算）
+- 寅月（正月）從立春開始，約2月4日
+- 丑月（臘月）跨越公曆年界
+
+返回指定年份的12個月運勢：
+- 干支月
+- 節氣起止
+- 公曆日期範圍
+
+用於規劃年度活動時機。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            ganzhiYear: ganzhiYearField.describe("The year to query (either GanZhi string like '乙巳' or Gregorian year like 2025)"),
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_liuyue', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const { year: gregorianYear, ganzhi: ganzhiYear } = (0, schemas_1.parseGanzhiYear)(args.ganzhiYear);
+        const result = await baziService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, minute: normalized.minute,
+            gender: normalized.gender, longitude: normalized.longitude,
+        });
+        if (!result.chart || !result.birthInfo) {
+            throw new Error('Failed to calculate BaZi chart');
+        }
+        const { stem: yearStem, branch: yearBranch } = (0, schemas_1.getYearStemBranch)(gregorianYear);
+        const daYunList = DaYunCalculator_1.DaYunCalculator.calculate(result.chart, result.birthInfo, normalized.gender, { startYear: normalized.year, endYear: normalized.year + 100 });
+        const targetAge = gregorianYear - normalized.year + 1;
+        let currentDaYun;
+        const matchedDaYun = daYunList.find(dy => targetAge >= dy.startAge && targetAge <= dy.endAge);
+        if (matchedDaYun) {
+            currentDaYun = {
+                stem: matchedDaYun.stem,
+                branch: matchedDaYun.branch,
+                startAge: matchedDaYun.startAge,
+                endAge: matchedDaYun.endAge,
+            };
+        }
+        const liuNianList = LiuNianCalculator_1.LiuNianCalculator.calculate(result.chart, normalized.year, gregorianYear, gregorianYear);
+        let currentLiuNian;
+        if (liuNianList.length > 0) {
+            const ln = liuNianList[0];
+            currentLiuNian = { stem: ln.stem, branch: ln.branch, age: ln.age };
+        }
+        const calculator = new LiuYueCalculator_1.LiuYueCalculator();
+        const liuYueList = calculator.calculateLiuYue(yearStem, yearBranch, (result.basic?.dayMasterElement || '木'), (result.traditional?.yongShen?.yongShen || []), {
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            minute: normalized.minute,
+        }, gregorianYear);
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            dayMaster: result.chart.day.stem,
+            yearPillar: { stem: result.chart.year.stem, branch: result.chart.year.branch },
+            monthPillar: { stem: result.chart.month.stem, branch: result.chart.month.branch },
+            dayPillar: { stem: result.chart.day.stem, branch: result.chart.day.branch },
+            hourPillar: { stem: result.chart.hour.stem, branch: result.chart.hour.branch },
+            ganzhiYear,
+            gregorianYear,
+            currentDaYun,
+            currentLiuNian,
+        };
+        return (0, listTextRenderer_1.renderBaziLiuYueList)(liuYueList, options);
+    }));
+    server.registerTool('bazi_liuri', {
+        title: '八字流日列表',
+        description: `八字流日列表。
+
+返回指定月份內的每日運勢（含上下文）：
+- 當前大運、流年、流月資訊
+- 公曆日期
+- 干支日
+
+用於精細的日期選擇。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            ganzhiYear: ganzhiYearField.describe("The year of the month (GanZhi string or Gregorian year)"),
+            ganzhiMonth: zod_1.z.union([
+                zod_1.z.string().describe("GanZhi month like '丙寅' (month 1 = 寅月)"),
+                zod_1.z.number().int().min(1).max(12).describe('Month number (1=寅月, 2=卯月, ..., 12=丑月)'),
+            ]).describe('The month to query (either GanZhi string or month number 1-12)'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_liuri', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const { year: gregorianYear, ganzhi: ganzhiYear } = (0, schemas_1.parseGanzhiYear)(args.ganzhiYear);
+        const monthNum = (0, schemas_1.parseGanzhiMonth)(args.ganzhiMonth);
+        const result = await baziService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, minute: normalized.minute,
+            gender: normalized.gender, longitude: normalized.longitude,
+        });
+        if (!result.chart || !result.birthInfo) {
+            throw new Error('Failed to calculate BaZi chart');
+        }
+        const { stem: yearStem, branch: yearBranch } = (0, schemas_1.getYearStemBranch)(gregorianYear);
+        const { stem: monthStem, branch: monthBranch } = (0, schemas_1.getMonthStemBranch)(gregorianYear, monthNum);
+        const daYunList = DaYunCalculator_1.DaYunCalculator.calculate(result.chart, result.birthInfo, normalized.gender, { startYear: normalized.year, endYear: normalized.year + 100 });
+        const targetAge = gregorianYear - normalized.year + 1;
+        let currentDaYun;
+        const matchedDaYun = daYunList.find(dy => targetAge >= dy.startAge && targetAge <= dy.endAge);
+        if (matchedDaYun) {
+            currentDaYun = {
+                stem: matchedDaYun.stem,
+                branch: matchedDaYun.branch,
+                startAge: matchedDaYun.startAge,
+                endAge: matchedDaYun.endAge,
+            };
+        }
+        const liuNianList = LiuNianCalculator_1.LiuNianCalculator.calculate(result.chart, normalized.year, gregorianYear, gregorianYear);
+        let currentLiuNian;
+        if (liuNianList.length > 0) {
+            const ln = liuNianList[0];
+            currentLiuNian = { stem: ln.stem, branch: ln.branch, age: ln.age };
+        }
+        const currentLiuYue = {
+            stem: monthStem,
+            branch: monthBranch,
+            month: monthNum,
+        };
+        // Calculate LiuRi
+        const liuRiCalc = new LiuRiCalculator_1.LiuRiCalculator();
+        const liuRiList = liuRiCalc.calculateLiuRi(monthStem, monthBranch, yearStem, yearBranch, (result.basic?.dayMasterElement || '木'), (result.traditional?.yongShen?.yongShen || []), gregorianYear, monthNum);
+        // Get the first and last date from the calculated list
+        const startDate = liuRiList.length > 0 ? liuRiList[0].date : new Date();
+        const endDate = liuRiList.length > 0 ? liuRiList[liuRiList.length - 1].date : new Date();
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            dayMaster: result.chart.day.stem,
+            yearPillar: { stem: result.chart.year.stem, branch: result.chart.year.branch },
+            monthPillar: { stem: result.chart.month.stem, branch: result.chart.month.branch },
+            dayPillar: { stem: result.chart.day.stem, branch: result.chart.day.branch },
+            hourPillar: { stem: result.chart.hour.stem, branch: result.chart.hour.branch },
+            ganzhiMonth: monthStem + monthBranch,
+            ganzhiYear,
+            gregorianYear,
+            startDate,
+            endDate,
+            currentDaYun,
+            currentLiuNian,
+            currentLiuYue,
+        };
+        return (0, listTextRenderer_1.renderBaziLiuRiList)(liuRiList, options);
+    }));
+}
+//# sourceMappingURL=baziTools.js.map

package/dist/tools/baziTools.js.map

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

package/dist/tools/calendarTools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 历法原语 MCP 工具
+ *
+ * 定位：中华历法确定性计算引擎的公共地基。
+ * 节气时刻与农历互转是 AI 幻觉率最高的历法量——
+ * 节气是天文事件（每年时刻漂移，AI 记不住也推不出），
+ * 农历闰月分配是历表查询（AI 经常猜错）。
+ * 两者完全满足输出准入三条件（确定/权威/AI 不易获知）。
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCalendarTools(server: McpServer): void;
+//# sourceMappingURL=calendarTools.d.ts.map

package/dist/tools/calendarTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendarTools.d.ts","sourceRoot":"","sources":["../../src/tools/calendarTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6G7D"}

package/dist/tools/calendarTools.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * 历法原语 MCP 工具
+ *
+ * 定位：中华历法确定性计算引擎的公共地基。
+ * 节气时刻与农历互转是 AI 幻觉率最高的历法量——
+ * 节气是天文事件（每年时刻漂移，AI 记不住也推不出），
+ * 农历闰月分配是历表查询（AI 经常猜错）。
+ * 两者完全满足输出准入三条件（确定/权威/AI 不易获知）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCalendarTools = registerCalendarTools;
+const zod_1 = require("zod");
+const lunar_javascript_1 = require("lunar-javascript");
+const schemas_1 = require("./schemas");
+function registerCalendarTools(server) {
+    // ============= 节气精确时刻查询 =============
+    server.registerTool('jieqi_query', {
+        title: '節氣精確時刻查詢',
+        description: `查詢指定年份二十四節氣的精確時刻（精確到秒，北京時間）。
+
+節氣是天文事件，每年時刻不同且無簡單規律——AI 無法可靠推算
+（如 2025 年立春是 2 月 3 日 22:10:13，而非 2 月 4 日）。
+本工具返回權威曆表的精確數據。
+
+輸出：二十四節氣按時間排序，含名稱、精確時刻、對應公曆日期。
+用於排盤驗證、擇時分析、曆法考證。`,
+        inputSchema: {
+            year: zod_1.z.number().int().min(1900).max(2100).describe('查詢年份（1900-2100）'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('jieqi_query', () => {
+        const lines = [];
+        lines.push(`## ${args.year} 年二十四節氣`);
+        lines.push('');
+        lines.push('（時刻為北京時間，精確到秒）');
+        lines.push('');
+        lines.push('| 節氣 | 精確時刻 |');
+        lines.push('|:----:|:---------|');
+        // 用冬至所在公历年组织（中国传统节气年从立春起，但 lunar 以公历年组织）
+        // JieQi 表以参考日期为轴前后各跨半年；合并年中与年末两个参考点
+        // 以确保冬至（12 月下旬）不遗漏
+        // JieQi 表的值直接是 Solar 对象；以年中（6月）为主、年末（12月）补冬至
+        // 注意不能用 spread 合并——年末表的其它节气是次年的值，会覆盖主表
+        const terms = [];
+        const seen = new Set();
+        for (const ref of [lunar_javascript_1.Lunar.fromYmdHms(args.year, 6, 1, 12, 0, 0), lunar_javascript_1.Lunar.fromYmdHms(args.year, 12, 15, 12, 0, 0)]) {
+            for (const [name, solar] of Object.entries(ref.getJieQiTable())) {
+                const s = solar;
+                if (!seen.has(name) && s && typeof s.getYear === 'function'
+                    && /^[\u4e00-\u9fa5]+$/.test(name) && s.getYear() === args.year) {
+                    terms.push({ name, solar: s });
+                    seen.add(name);
+                }
+            }
+        }
+        // 按时间排序
+        terms.sort((a, b) => {
+            const sa = a.solar, sb = b.solar;
+            return sa.getYear() - sb.getYear()
+                || sa.getMonth() - sb.getMonth()
+                || sa.getDay() - sb.getDay()
+                || sa.getHour() - sb.getHour()
+                || sa.getMinute() - sb.getMinute();
+        });
+        for (const t of terms) {
+            const s = t.solar;
+            const pad = (n) => String(n).padStart(2, '0');
+            lines.push(`| ${t.name} | ${s.getYear()}-${pad(s.getMonth())}-${pad(s.getDay())} ${pad(s.getHour())}:${pad(s.getMinute())}:${pad(s.getSecond())} |`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }));
+    // ============= 农历公历互转 =============
+    server.registerTool('calendar_convert', {
+        title: '農曆公曆互轉',
+        description: `農曆與公曆日期互轉（含閏月處理、干支年月日、生肖）。
+
+農曆閏月分配無簡單規律（哪年閏幾月由天文計算決定），AI 經常猜錯。
+本工具返回權威曆表數據。
+
+支持兩個方向：
+- solar → lunar：輸入公曆日期，返回農曆日期（含是否閏月）
+- lunar → solar：輸入農曆日期（isLeapMonth 標記閏月），返回公曆日期`,
+        inputSchema: {
+            direction: zod_1.z.enum(['solar2lunar', 'lunar2solar']).describe('轉換方向'),
+            year: zod_1.z.number().int().min(1900).max(2100).describe('年份'),
+            month: zod_1.z.number().int().min(1).max(12).describe('月份（1-12）'),
+            day: zod_1.z.number().int().min(1).max(31).describe('日期'),
+            isLeapMonth: zod_1.z.boolean().optional().describe('農曆輸入時是否為閏月（lunar2solar 方向）'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('calendar_convert', () => {
+        const lines = [];
+        if (args.direction === 'solar2lunar') {
+            const solar = lunar_javascript_1.Solar.fromYmd(args.year, args.month, args.day);
+            const lunar = solar.getLunar();
+            const isLeap = lunar.getMonth() < 0;
+            lines.push(`## 公曆 → 農曆`);
+            lines.push('');
+            lines.push(`**公曆**：${args.year} 年 ${args.month} 月 ${args.day} 日`);
+            lines.push(`**農曆**：${lunar.getYearInChinese()}年 ${lunar.getMonthInChinese()}月${lunar.getDayInChinese()}日`); // getMonthInChinese 闰月自带「闰」前缀
+            lines.push('');
+            lines.push(`**干支**：${lunar.getYearInGanZhiByLiChun()}年 ${lunar.getMonthInGanZhi()}月 ${lunar.getDayInGanZhi()}日`);
+            lines.push(`**生肖**：${lunar.getYearShengXiao()}`);
+        }
+        else {
+            const monthArg = args.isLeapMonth ? -args.month : args.month;
+            const lunar = lunar_javascript_1.Lunar.fromYmd(args.year, monthArg, args.day);
+            const solar = lunar.getSolar();
+            lines.push(`## 農曆 → 公曆`);
+            lines.push('');
+            lines.push(`**農曆**：${lunar.getYearInChinese()}年 ${lunar.getMonthInChinese()}月${lunar.getDayInChinese()}日`);
+            lines.push(`**公曆**：${solar.getYear()} 年 ${solar.getMonth()} 月 ${solar.getDay()} 日`);
+            lines.push('');
+            lines.push(`**干支**：${lunar.getYearInGanZhiByLiChun()}年 ${lunar.getMonthInGanZhi()}月 ${lunar.getDayInGanZhi()}日`);
+            lines.push(`**生肖**：${lunar.getYearShengXiao()}`);
+        }
+        lines.push('');
+        return lines.join('\n');
+    }));
+}
+//# sourceMappingURL=calendarTools.js.map

package/dist/tools/calendarTools.js.map

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

package/dist/tools/divinationTools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 占卜類 MCP 工具：六爻、梅花易數、大六壬
+ *
+ * 設計原則：占卜工具的時間參數為「起卦/起課時間」，
+ * 節氣、干支等曆法量一律由 MCP 自動推得（LLM 手推干支極易出錯）。
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDivinationTools(server: McpServer): void;
+//# sourceMappingURL=divinationTools.d.ts.map

package/dist/tools/divinationTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"divinationTools.d.ts","sourceRoot":"","sources":["../../src/tools/divinationTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuM/D"}