gangtise-openapi-cli 0.5.1 → 0.6.0

package/README.md

@@ -152,8 +152,16 @@ gangtise quote day-kline --security 600519.SH --start-date 2026-03-01 --end-date
 
 ```bash
 gangtise fundamental income-statement --security-code 600519.SH --fiscal-year 2025 --period q3 --field netProfit
-# 多周期：同时查一季报和中报
-gangtise fundamental income-statement --security-code 600519.SH --fiscal-year 2024 --period q1 --period q2 --report-type consolidated
+# 多年度：同时查2023-2025年报净利润
+gangtise fundamental income-statement --security-code 600519.SH --fiscal-year 2023 --fiscal-year 2024 --fiscal-year 2025 --period annual --field netProfit
+# 最新一期完整利润表
+gangtise fundamental income-statement --security-code 600519.SH --format json
+gangtise fundamental balance-sheet --security-code 600519.SH --fiscal-year 2025 --period q3 --field totalCurrAssets --field totalCurrLiab
+# 最新一期完整资产负债表
+gangtise fundamental balance-sheet --security-code 600519.SH --format json
+gangtise fundamental cash-flow --security-code 600519.SH --fiscal-year 2025 --period q3 --field netOpCashFlows --field netInvCashFlows --field netFinCashFlows
+# 最新一期完整现金流量表
+gangtise fundamental cash-flow --security-code 600519.SH --format json
 gangtise fundamental main-business --security-code 600519.SH --breakdown region
 gangtise fundamental valuation-analysis --security-code 600519.SH --indicator peTtm
 ```
@@ -168,6 +176,9 @@ gangtise ai security-clue --start-time "2026-04-01 00:00:00" --end-time "2026-04
 gangtise ai one-pager --security-code 600519.SH
 gangtise ai investment-logic --security-code 600519.SH
 gangtise ai peer-comparison --security-code 600519.SH
+gangtise ai earnings-review --security-code 600519.SH --period 2025q3
+gangtise ai theme-tracking --theme-id 121000131 --date 2026-03-01 --type morning
+gangtise ai research-outline --security-code 600519.SH
 gangtise ai cloud-disk-list --keyword 部门文档 --space-type 1 --file-type 1
 
 # 云盘下载：自动使用文件标题命名
@@ -194,7 +205,7 @@ gangtise raw call insight.opinion.list --body '{"from":0,"size":120}'
 - insight: `opinion list` / `summary list` / `summary download` / `roadshow list` / `site-visit list` / `strategy list` / `forum list` / `research list` / `research download` / `foreign-report list` / `foreign-report download` / `announcement list` / `announcement download`
 - quote: `day-kline`
 - fundamental: `income-statement` / `main-business` / `valuation-analysis`
-- ai: `knowledge-batch` / `knowledge-resource-download` / `security-clue` / `cloud-disk-list` / `cloud-disk-download` / `one-pager` / `investment-logic` / `peer-comparison`
+- ai: `knowledge-batch` / `knowledge-resource-download` / `security-clue` / `cloud-disk-list` / `cloud-disk-download` / `one-pager` / `investment-logic` / `peer-comparison` / `earnings-review` / `theme-tracking` / `research-outline`
 
 注意：`knowledge-resource-download` 依赖正确的 `resourceType + sourceId` 组合；错误组合会返回 `433007 不支持该数据源`。
 

package/dist/src/cli.js

@@ -1,15 +1,25 @@
 #!/usr/bin/env node
 import { Command, Option } from "commander";
-import fs from "node:fs/promises";
-import os from "node:os";
-import path, { extname } from "node:path";
 import { collectKeyValue, collectList, collectNumberList, maybeArray, toTimestamp13 } from "./core/args.js";
-import { readTokenCache } from "./core/auth.js";
-import { GangtiseClient } from "./core/client.js";
 import { loadConfig } from "./core/config.js";
 import { ApiError, ConfigError, DownloadError } from "./core/errors.js";
-import { renderOutput, saveOutputIfNeeded } from "./core/output.js";
-import { normalizeRows } from "./core/normalize.js";
+// --- Lazy-loaded modules (deferred to action handlers) ---
+async function createClient() {
+    const { GangtiseClient } = await import("./core/client.js");
+    return new GangtiseClient(loadConfig());
+}
+async function readTokenCache(...args) {
+    return (await import("./core/auth.js")).readTokenCache(...args);
+}
+async function normalizeRows(...args) {
+    return (await import("./core/normalize.js")).normalizeRows(...args);
+}
+async function renderOutput(...args) {
+    return (await import("./core/output.js")).renderOutput(...args);
+}
+async function saveOutputIfNeeded(...args) {
+    return (await import("./core/output.js")).saveOutputIfNeeded(...args);
+}
 function parseFormat(value) {
     const format = value ?? "table";
     if (["table", "json", "jsonl", "csv", "markdown"].includes(format)) {
@@ -18,21 +28,32 @@ function parseFormat(value) {
     throw new ConfigError(`Unsupported format: ${format}`);
 }
 // --- Title cache: list writes, download reads ---
-const TITLE_CACHE_PATH = path.join(os.homedir(), ".config", "gangtise", "title-cache.json");
+let _titleCachePath;
+function getTitleCachePath() {
+    if (!_titleCachePath) {
+        const path = require("node:path");
+        const os = require("node:os");
+        _titleCachePath = path.join(os.homedir(), ".config", "gangtise", "title-cache.json");
+    }
+    return _titleCachePath;
+}
 const TITLE_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24h
 async function readTitleCache() {
     try {
-        return JSON.parse(await fs.readFile(TITLE_CACHE_PATH, "utf8"));
+        const fs = await import("node:fs/promises");
+        return JSON.parse(await fs.readFile(getTitleCachePath(), "utf8"));
     }
     catch {
         return {};
     }
 }
 async function writeTitleCache(endpoint, titles) {
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
     const data = await readTitleCache();
     data[endpoint] = { titles, ts: Date.now() };
-    await fs.mkdir(path.dirname(TITLE_CACHE_PATH), { recursive: true });
-    await fs.writeFile(TITLE_CACHE_PATH, JSON.stringify(data), "utf8");
+    await fs.mkdir(path.dirname(getTitleCachePath()), { recursive: true });
+    await fs.writeFile(getTitleCachePath(), JSON.stringify(data), "utf8");
 }
 function lookupTitleCache(data, endpoint, id) {
     const entry = data[endpoint];
@@ -41,7 +62,7 @@ function lookupTitleCache(data, endpoint, id) {
     return entry.titles[id];
 }
 async function printData(data, format, output, cache) {
-    const normalized = normalizeRows(data);
+    const normalized = await normalizeRows(data);
     // Populate title cache from list results
     if (cache && Array.isArray(normalized)) {
         const titleField = cache.titleField ?? "title";
@@ -58,7 +79,7 @@ async function printData(data, format, output, cache) {
         if (Object.keys(titles).length > 0)
             writeTitleCache(cache.endpointKey, titles).catch(() => { });
     }
-    const content = renderOutput(normalized, format);
+    const content = await renderOutput(normalized, format);
     if (output) {
         await saveOutputIfNeeded(content, output);
         process.stdout.write(`${output}\n`);
@@ -100,6 +121,7 @@ function extFromContentType(contentType) {
 }
 /** Resolve a human-readable filename by looking up the title from cache or list endpoint. */
 async function resolveTitle(client, result, listEndpoint, idField, idValue, titleField = "title") {
+    const { extname } = await import("node:path");
     const file = result;
     const serverExt = file.filename ? extname(file.filename) : extFromContentType(file.contentType);
     function buildFilename(rawTitle) {
@@ -166,30 +188,15 @@ function addTimeFilters(command) {
         .option("--keyword <keyword>", "Keyword");
 }
 const program = new Command();
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-function loadPackageVersion() {
-    const __dirname = path.dirname(fileURLToPath(import.meta.url));
-    const req = createRequire(import.meta.url);
-    // Works from both src/ (dev) and dist/src/ (built)
-    try {
-        return req(path.resolve(__dirname, "../package.json")).version;
-    }
-    catch { }
-    try {
-        return req(path.resolve(__dirname, "../../package.json")).version;
-    }
-    catch { }
-    return "0.0.0";
-}
-program.name("gangtise").description("Gangtise OpenAPI CLI").version(loadPackageVersion());
+const CLI_VERSION = "0.6.0";
+program.name("gangtise").description("Gangtise OpenAPI CLI").version(CLI_VERSION);
 program
     .command("auth")
     .description("Authentication commands")
     .addCommand(new Command("login")
     .option("--format <format>", "Output format", "json")
     .action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.login(), parseFormat(options.format));
 }))
     .addCommand(new Command("status")
@@ -202,32 +209,36 @@ program
 const lookup = new Command("lookup").description("Lookup helper APIs");
 lookup
     .addCommand(new Command("research-area").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.research-areas.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("broker-org").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.broker-orgs.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("meeting-org").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.meeting-orgs.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("industry").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.industries.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("region").description("Foreign report region codes").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.regions.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("announcement-category").description("Announcement category codes").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.announcement-categories.list"), parseFormat(options.format));
 })))
     .addCommand(new Command("industry-code").description("Shenwan industry codes for security-clue --gts-code").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("lookup.industry-codes.list"), parseFormat(options.format));
+})))
+    .addCommand(new Command("theme-id").description("Theme IDs for theme-tracking --theme-id").addCommand(new Command("list").option("--format <format>", "Output format", "table").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("lookup.theme-ids.list"), parseFormat(options.format));
 })));
 program.addCommand(lookup);
 const insight = new Command("insight").description("Insight APIs");
@@ -241,7 +252,7 @@ const research = new Command("research");
 const foreignReport = new Command("foreign-report");
 const announcement = new Command("announcement");
 addTimeFilters(opinion.command("list").option("--rank-type <number>", "Rank type", "1").option("--research-area <id>", "Research area ID", collectList, []).option("--chief <id>", "Chief ID", collectList, []).option("--security <code>", "Security code", collectList, []).option("--broker <id>", "Broker ID", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--concept <id>", "Concept ID", collectList, []).option("--llm-tag <tag>", "Semantic tag", collectList, []).option("--source <source>", "Source", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.opinion.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime,
         rankType: Number(options.rankType), keyword: options.keyword, researchAreaList: maybeArray(options.researchArea), chiefList: maybeArray(options.chief),
@@ -250,7 +261,7 @@ addTimeFilters(opinion.command("list").option("--rank-type <number>", "Rank type
     }), parseFormat(options.format), options.output);
 });
 addTimeFilters(summary.command("list").option("--search-type <number>", "Search type", "1").option("--rank-type <number>", "Rank type", "1").option("--source <number>", "Source type", collectNumberList, []).option("--research-area <id>", "Research area", collectList, []).option("--security <code>", "Security code", collectList, []).option("--institution <id>", "Institution ID", collectList, []).option("--category <name>", "Category", collectList, []).option("--market <name>", "Market", collectList, []).option("--participant-role <name>", "Participant role", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.summary.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime,
         searchType: Number(options.searchType), rankType: Number(options.rankType), keyword: options.keyword, sourceList: options.source.length ? options.source : undefined,
@@ -259,13 +270,13 @@ addTimeFilters(summary.command("list").option("--search-type <number>", "Search
     }), parseFormat(options.format), options.output, { endpointKey: "insight.summary.list", idField: "summaryId" });
 });
 summary.command("download").requiredOption("--summary-id <id>").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("insight.summary.download", undefined, { summaryId: options.summaryId });
     const title = options.output ? undefined : await resolveTitle(client, result, "insight.summary.list", "summaryId", options.summaryId);
     await saveDownloadResult(result, `summary-${options.summaryId}`, options.output ?? title);
 });
 const addScheduleList = (command, endpointKey) => addTimeFilters(command.command("list").option("--research-area <id>", "Research area", collectList, []).option("--institution <id>", "Institution ID", collectList, []).option("--security <code>", "Security code", collectList, []).option("--category <name>", "Category", collectList, []).option("--market <name>", "Market", collectList, []).option("--participant-role <name>", "Participant role", collectList, []).option("--broker-type <name>", "Broker type", collectList, []).option("--object <type>", "Object type: company/industry", collectList, []).option("--permission <number>", "Permission", collectNumberList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call(endpointKey, {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword,
         researchAreaList: maybeArray(options.researchArea), institutionList: maybeArray(options.institution), securityList: maybeArray(options.security),
@@ -278,7 +289,7 @@ addScheduleList(siteVisit, "insight.site-visit.list");
 addScheduleList(strategy, "insight.strategy.list");
 addScheduleList(forum, "insight.forum.list");
 addTimeFilters(research.command("list").option("--search-type <number>", "Search type: 1=title 2=fulltext", "1").option("--rank-type <number>", "Rank type: 1=composite 2=time desc", "1").option("--broker <id>", "Broker ID", collectList, []).option("--security <code>", "Security code", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--category <name>", "Report category", collectList, []).option("--llm-tag <tag>", "Semantic tag", collectList, []).option("--rating <name>", "Rating", collectList, []).option("--rating-change <name>", "Rating change", collectList, []).option("--min-pages <number>", "Min report pages").option("--max-pages <number>", "Max report pages").option("--source <type>", "Source type", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.research.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword,
         searchType: Number(options.searchType), rankType: Number(options.rankType),
@@ -289,13 +300,13 @@ addTimeFilters(research.command("list").option("--search-type <number>", "Search
     }), parseFormat(options.format), options.output, { endpointKey: "insight.research.list", idField: "reportId" });
 });
 research.command("download").requiredOption("--report-id <id>").option("--file-type <number>", "File type: 1=PDF 2=Markdown", "1").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("insight.research.download", undefined, { reportId: options.reportId, fileType: Number(options.fileType) });
     const title = options.output ? undefined : await resolveTitle(client, result, "insight.research.list", "reportId", options.reportId);
     await saveDownloadResult(result, `research-${options.reportId}`, options.output ?? title);
 });
 addTimeFilters(foreignReport.command("list").option("--search-type <number>", "Search type: 1=title 2=fulltext", "1").option("--rank-type <number>", "Rank type: 1=composite 2=time desc", "1").option("--security <code>", "Security code", collectList, []).option("--region <id>", "Region ID", collectList, []).option("--category <name>", "Report category", collectList, []).option("--industry <id>", "Industry ID", collectList, []).option("--broker <id>", "Broker ID", collectList, []).option("--llm-tag <tag>", "Semantic tag", collectList, []).option("--rating <name>", "Rating", collectList, []).option("--rating-change <name>", "Rating change", collectList, []).option("--min-pages <number>", "Min report pages").option("--max-pages <number>", "Max report pages").option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.foreign-report.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword,
         searchType: Number(options.searchType), rankType: Number(options.rankType),
@@ -306,13 +317,13 @@ addTimeFilters(foreignReport.command("list").option("--search-type <number>", "S
     }), parseFormat(options.format), options.output, { endpointKey: "insight.foreign-report.list", idField: "reportId" });
 });
 foreignReport.command("download").requiredOption("--report-id <id>").option("--file-type <number>", "File type: 1=PDF 2=Markdown 3=CN-PDF 4=CN-Markdown", "1").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("insight.foreign-report.download", undefined, { reportId: options.reportId, fileType: Number(options.fileType) });
     const title = options.output ? undefined : await resolveTitle(client, result, "insight.foreign-report.list", "reportId", options.reportId);
     await saveDownloadResult(result, `foreign-report-${options.reportId}`, options.output ?? title);
 });
 addTimeFilters(announcement.command("list").option("--search-type <number>", "Search type: 1=title 2=fulltext", "1").option("--rank-type <number>", "Rank type: 1=composite 2=time desc", "1").option("--security <code>", "Security code", collectList, []).option("--announcement-type <type>", "Announcement type", collectList, []).option("--category <id>", "Category ID", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>", "Output path")).action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("insight.announcement.list", {
         from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size),
         startTime: toTimestamp13(options.startTime), endTime: toTimestamp13(options.endTime),
@@ -321,7 +332,7 @@ addTimeFilters(announcement.command("list").option("--search-type <number>", "Se
     }), parseFormat(options.format), options.output, { endpointKey: "insight.announcement.list", idField: "announcementId" });
 });
 announcement.command("download").requiredOption("--announcement-id <id>").option("--file-type <number>", "File type: 1=PDF 2=Markdown", "1").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("insight.announcement.download", undefined, { announcementId: options.announcementId, fileType: Number(options.fileType) });
     const title = options.output ? undefined : await resolveTitle(client, result, "insight.announcement.list", "announcementId", options.announcementId);
     await saveDownloadResult(result, `announcement-${options.announcementId}`, options.output ?? title);
@@ -338,62 +349,133 @@ insight.addCommand(announcement);
 program.addCommand(insight);
 const quote = new Command("quote").description("Quote APIs");
 quote.command("day-kline").option("--security <code>", "Security code", collectList, []).option("--start-date <date>").option("--end-date <date>").option("--limit <number>").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("quote.day-kline", { securityList: maybeArray(options.security), startDate: options.startDate, endDate: options.endDate, limit: options.limit ? Number(options.limit) : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
 program.addCommand(quote);
 const fundamental = new Command("fundamental").description("Fundamental APIs");
 fundamental.command("income-statement").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", "Period", collectList, []).option("--report-type <type>", "Report type", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
-    await printData(await client.call("fundamental.income-statement", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : ["latest"], reportType: options.reportType.length ? options.reportType : ["consolidated"], fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
+    const client = await createClient();
+    await printData(await client.call("fundamental.income-statement", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : undefined, reportType: options.reportType.length ? options.reportType : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
+});
+fundamental.command("balance-sheet").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", "Period", collectList, []).option("--report-type <type>", "Report type", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("fundamental.balance-sheet", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : undefined, reportType: options.reportType.length ? options.reportType : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
+});
+fundamental.command("cash-flow").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", "Period", collectList, []).option("--report-type <type>", "Report type", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("fundamental.cash-flow", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), period: options.period.length ? options.period : undefined, reportType: options.reportType.length ? options.reportType : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
 fundamental.command("main-business").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).addOption(new Option("--breakdown <type>", "Breakdown: product/industry/region").choices(["product", "industry", "region"]).default("product")).addOption(new Option("--period <type>", "Period: interim/annual").choices(["interim", "annual"])).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("fundamental.main-business", { securityCode: options.securityCode, startDate: options.startDate, endDate: options.endDate, fiscalYear: maybeArray(options.fiscalYear), breakdown: options.breakdown, period: options.period, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
 fundamental.command("valuation-analysis").requiredOption("--security-code <code>").addOption(new Option("--indicator <name>", "Indicator").choices(["peTtm", "pbMrq", "peg", "psTtm", "pcfTtm", "em"]).makeOptionMandatory()).option("--start-date <date>").option("--end-date <date>").option("--limit <number>").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("fundamental.valuation-analysis", { securityCode: options.securityCode, indicator: options.indicator, startDate: options.startDate, endDate: options.endDate, limit: options.limit ? Number(options.limit) : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
 program.addCommand(fundamental);
 const ai = new Command("ai").description("AI APIs");
 ai.command("knowledge-batch").requiredOption("--query <text>", "Query", collectList, []).option("--top <number>", "Top", "10").option("--resource-type <number>", "Resource type", collectNumberList, []).option("--knowledge-name <name>", "Knowledge name", collectList, []).option("--start-time <ms>").option("--end-time <ms>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.knowledge-batch", { queries: options.query, top: Number(options.top), resourceTypes: options.resourceType.length ? options.resourceType : undefined, knowledgeNames: maybeArray(options.knowledgeName), startTime: options.startTime ? Number(options.startTime) : undefined, endTime: options.endTime ? Number(options.endTime) : undefined }), parseFormat(options.format), options.output);
 });
 ai.command("knowledge-resource-download").requiredOption("--resource-type <number>").requiredOption("--source-id <id>").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await saveDownloadResult(await client.call("ai.knowledge-resource.download", undefined, { resourceType: Number(options.resourceType), sourceId: options.sourceId }), `resource-${options.sourceId}`, options.output);
 });
 ai.command("security-clue").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").requiredOption("--start-time <datetime>").requiredOption("--end-time <datetime>").addOption(new Option("--query-mode <mode>").choices(["bySecurity", "byIndustry"]).makeOptionMandatory()).option("--gts-code <code>", "GTS code", collectList, []).option("--source <name>", "Source", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.security-clue.list", { from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, queryMode: options.queryMode, gtsCodeList: maybeArray(options.gtsCode), source: maybeArray(options.source) }), parseFormat(options.format), options.output);
 });
 ai.command("one-pager").requiredOption("--security-code <code>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.one-pager", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
 });
 ai.command("investment-logic").requiredOption("--security-code <code>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.investment-logic", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
 });
 ai.command("peer-comparison").requiredOption("--security-code <code>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.peer-comparison", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
 });
+ai.command("earnings-review").requiredOption("--security-code <code>").requiredOption("--period <period>", "Report period (e.g. 2025q3, 2025interim, 2025annual)").option("--wait", "Wait for content generation (blocking, up to 3 min)").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    // Step 1: get dataId
+    const idResult = await client.call("ai.earnings-review.get-id", { securityCode: options.securityCode, period: options.period });
+    const dataId = idResult?.dataId;
+    if (!dataId) {
+        process.stderr.write("Failed to get earnings review ID. The report may not be available yet.\n");
+        process.exitCode = 1;
+        return;
+    }
+    // Non-blocking: return dataId immediately
+    if (!options.wait) {
+        process.stderr.write(`Earnings review task submitted. dataId: ${dataId}\n`);
+        process.stdout.write(`${JSON.stringify({ dataId, status: "pending", hint: `Run 'gangtise ai earnings-review-check --data-id ${dataId}' in ~2 minutes to get results` })}\n`);
+        return;
+    }
+    // Blocking (--wait): poll for content
+    process.stderr.write(`Got dataId: ${dataId}, waiting for content generation...\n`);
+    let attempts = 0;
+    const maxAttempts = 12;
+    const delayMs = 15_000;
+    while (attempts < maxAttempts) {
+        attempts++;
+        const contentResult = await client.call("ai.earnings-review.get-content", { dataId });
+        if (contentResult?.data?.content) {
+            await printData(contentResult.data, parseFormat(options.format), options.output);
+            return;
+        }
+        if (attempts < maxAttempts) {
+            process.stderr.write(`Attempt ${attempts}/${maxAttempts}: content not ready, retrying in 15s...\n`);
+            await new Promise(resolve => setTimeout(resolve, delayMs));
+        }
+    }
+    process.stderr.write(`Content not available after ${maxAttempts} attempts. Try again later with: gangtise ai earnings-review-check --data-id ${dataId}\n`);
+    process.exitCode = 1;
+});
+ai.command("earnings-review-check").requiredOption("--data-id <id>", "dataId from earnings-review").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    try {
+        const contentResult = await client.call("ai.earnings-review.get-content", { dataId: options.dataId });
+        if (contentResult?.data?.content) {
+            await printData(contentResult.data, parseFormat(options.format), options.output);
+            return;
+        }
+        process.stdout.write(`${JSON.stringify({ dataId: options.dataId, status: "pending", hint: "Content not ready yet, retry in ~2 minutes" })}\n`);
+    }
+    catch (error) {
+        if (error instanceof ApiError && (error.code === "410110" || error.message?.includes("生成中"))) {
+            process.stdout.write(`${JSON.stringify({ dataId: options.dataId, status: "pending", hint: "Content not ready yet, retry in ~2 minutes" })}\n`);
+            return;
+        }
+        throw error;
+    }
+});
+ai.command("theme-tracking").requiredOption("--theme-id <id>", "Theme ID (use lookup theme-id list)").requiredOption("--date <date>", "Date (yyyy-MM-dd)").option("--type <name>", "Report type: morning/night", collectList, []).option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    const typeList = options.type.length ? options.type : undefined;
+    await printData(await client.call("ai.theme-tracking", { themeId: options.themeId, date: options.date, type: typeList }), parseFormat(options.format), options.output);
+});
+ai.command("research-outline").requiredOption("--security-code <code>").option("--format <format>", "Output format", "json").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("ai.research-outline", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
+});
 ai.command("cloud-disk-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").option("--start-time <datetime>").option("--end-time <datetime>").option("--keyword <text>").option("--file-type <number>", "File type", collectNumberList, []).option("--space-type <number>", "Space type", collectNumberList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     await printData(await client.call("ai.cloud-disk.list", { from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword, fileTypeList: options.fileType.length ? options.fileType : undefined, spaceTypeList: options.spaceType.length ? options.spaceType : undefined }), parseFormat(options.format), options.output, { endpointKey: "ai.cloud-disk.list", idField: "fileId" });
 });
 ai.command("cloud-disk-download").requiredOption("--file-id <id>").option("--output <path>").action(async (options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const result = await client.call("ai.cloud-disk.download", undefined, { fileId: options.fileId });
     const title = options.output ? undefined : await resolveTitle(client, result, "ai.cloud-disk.list", "fileId", options.fileId);
     await saveDownloadResult(result, `file-${options.fileId}`, options.output ?? title);
 });
 program.addCommand(ai);
 program.command("raw").description("Raw API calls").addCommand(new Command("call").argument("<endpointKey>").option("--body <json>").option("--query <key=value>", "Query string pair", collectKeyValue, {}).option("--format <format>", "Output format", "json").option("--output <path>").action(async (endpointKey, options) => {
-    const client = new GangtiseClient(loadConfig());
+    const client = await createClient();
     const body = options.body ? JSON.parse(options.body) : undefined;
     const data = await client.call(endpointKey, body, options.query);
     if (data && typeof data === "object" && "data" in data && data.data instanceof Uint8Array) {
@@ -423,4 +505,3 @@ async function main() {
     }
 }
 void main();
-//# sourceMappingURL=cli.js.map

package/dist/src/core/args.js

@@ -44,4 +44,3 @@ export function toTimestamp13(value) {
         return undefined;
     return ms;
 }
-//# sourceMappingURL=args.js.map

package/dist/src/core/auth.js

@@ -33,4 +33,3 @@ export function requireAccessCredentials(accessKey, secretKey) {
     }
     return { accessKey, secretKey };
 }
-//# sourceMappingURL=auth.js.map

package/dist/src/core/client.js

@@ -2,7 +2,7 @@ import { request } from "undici";
 import { normalizeToken, readTokenCache, requireAccessCredentials, writeTokenCache } from "./auth.js";
 import { ApiError, ValidationError } from "./errors.js";
 import { ENDPOINTS, ENDPOINT_REGISTRY } from "./endpoints.js";
-import { ANNOUNCEMENT_CATEGORIES, BROKER_ORGS, INDUSTRIES, INDUSTRY_CODES, MEETING_ORGS, REGIONS, RESEARCH_AREAS } from "./lookupData.js";
+import { getLookupData } from "./lookupData/index.js";
 export class GangtiseClient {
     config;
     constructor(config) {
@@ -47,26 +47,19 @@ export class GangtiseClient {
         return parsed;
     }
     async readLocalLookup(endpoint) {
-        if (endpoint.key === "lookup.research-areas.list") {
-            return RESEARCH_AREAS;
-        }
-        if (endpoint.key === "lookup.broker-orgs.list") {
-            return BROKER_ORGS;
-        }
-        if (endpoint.key === "lookup.meeting-orgs.list") {
-            return MEETING_ORGS;
-        }
-        if (endpoint.key === "lookup.industries.list") {
-            return INDUSTRIES;
-        }
-        if (endpoint.key === "lookup.regions.list") {
-            return REGIONS;
-        }
-        if (endpoint.key === "lookup.announcement-categories.list") {
-            return ANNOUNCEMENT_CATEGORIES;
-        }
-        if (endpoint.key === "lookup.industry-codes.list") {
-            return INDUSTRY_CODES;
+        const keyMapping = {
+            "lookup.research-areas.list": "research-areas",
+            "lookup.broker-orgs.list": "broker-orgs",
+            "lookup.meeting-orgs.list": "meeting-orgs",
+            "lookup.industries.list": "industries",
+            "lookup.regions.list": "regions",
+            "lookup.announcement-categories.list": "announcement-categories",
+            "lookup.industry-codes.list": "industry-codes",
+            "lookup.theme-ids.list": "theme-ids",
+        };
+        const lookupKey = keyMapping[endpoint.key];
+        if (lookupKey) {
+            return getLookupData(lookupKey);
         }
         throw new ApiError(`Unsupported local lookup endpoint: ${endpoint.key}`);
     }
@@ -253,4 +246,3 @@ export class GangtiseClient {
         return this.requestJson(endpoint, body);
     }
 }
-//# sourceMappingURL=client.js.map

package/dist/src/core/config.js

@@ -15,4 +15,3 @@ export function loadConfig() {
         tokenCachePath: process.env.GANGTISE_TOKEN_CACHE_PATH ?? DEFAULT_TOKEN_CACHE_PATH,
     };
 }
-//# sourceMappingURL=config.js.map

package/dist/src/core/endpoints.js

@@ -55,6 +55,13 @@ export const ENDPOINTS = {
         kind: "json",
         description: "List Shenwan industry codes from local docs",
     },
+    lookupThemeIds: {
+        key: "lookup.theme-ids.list",
+        method: "GET",
+        path: "/guide/theme-ids-local",
+        kind: "json",
+        description: "List theme IDs from local docs",
+    },
     insightOpinionList: {
         key: "insight.opinion.list",
         method: "POST",
@@ -165,9 +172,23 @@ export const ENDPOINTS = {
     fundamentalIncomeStatement: {
         key: "fundamental.income-statement",
         method: "POST",
-        path: "/application/open-fundamental/financial-report/income-statement",
+        path: "/application/open-fundamental/financial-report/income-statement/accumulated",
+        kind: "json",
+        description: "Query income statement (accumulated)",
+    },
+    fundamentalBalanceSheet: {
+        key: "fundamental.balance-sheet",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/balance-sheet/accumulated",
         kind: "json",
-        description: "Query income statement",
+        description: "Query balance sheet (accumulated)",
+    },
+    fundamentalCashFlow: {
+        key: "fundamental.cash-flow",
+        method: "POST",
+        path: "/application/open-fundamental/financial-report/cash-flow-statement/accumulated",
+        kind: "json",
+        description: "Query cash flow statement (accumulated)",
     },
     fundamentalMainBusiness: {
         key: "fundamental.main-business",
@@ -226,6 +247,34 @@ export const ENDPOINTS = {
         kind: "json",
         description: "Generate peer comparison",
     },
+    aiEarningsReviewGetId: {
+        key: "ai.earnings-review.get-id",
+        method: "POST",
+        path: "/application/open-ai/agent/earnings-review-getid",
+        kind: "json",
+        description: "Get earnings review ID",
+    },
+    aiEarningsReviewGetContent: {
+        key: "ai.earnings-review.get-content",
+        method: "POST",
+        path: "/application/open-ai/agent/earnings-review-getcontent",
+        kind: "json",
+        description: "Get earnings review content",
+    },
+    aiThemeTracking: {
+        key: "ai.theme-tracking",
+        method: "POST",
+        path: "/application/open-ai/agent/theme-tracking",
+        kind: "json",
+        description: "Get theme tracking daily report",
+    },
+    aiResearchOutline: {
+        key: "ai.research-outline",
+        method: "POST",
+        path: "/application/open-ai/agent/research-outline",
+        kind: "json",
+        description: "Get company research outline",
+    },
     aiCloudDiskList: {
         key: "ai.cloud-disk.list",
         method: "POST",
@@ -246,4 +295,3 @@ export const ENDPOINT_REGISTRY = Object.values(ENDPOINTS).reduce((accumulator, e
     accumulator[endpoint.key] = endpoint;
     return accumulator;
 }, {});
-//# sourceMappingURL=endpoints.js.map