gangtise-openapi-cli 0.43.0 → 0.44.0

package/dist/src/commands/fund.js

@@ -0,0 +1,100 @@
+import { Command } from "commander";
+import { collectNames } from "../core/args.js";
+import { date, format, list, output, query, requiredList, value } from "./shared.js";
+export const fund = new Command("fund").description("Fund APIs: profiles, NAV, fees, managers, scale, holders, holdings and allocation, ETF creation/redemption");
+const code = () => requiredList("--security <code>", "Fund code, e.g. 005827.OF / 159967.SZ / 510300.SH (repeatable, comma-separated accepted)", "fundCodeList");
+const range = (what) => [
+    date("--start-date <date>", `${what} range start (yyyy-MM-dd); omit both ends for everything in your account's history window`, "startDate"),
+    date("--end-date <date>", `${what} range end (yyyy-MM-dd)`, "endDate"),
+];
+const positionType = () => value("--position-type <type>", "top = top holdings, disclosed every quarter (server default); all = full book, interim and annual reports only", "positionType");
+query(fund, "basic-info", {
+    description: "Fund profiles: category, manager, custodian, dates, subscription rules, benchmark, risk level, tracked index",
+    endpoint: "fund.basic-info",
+    fields: [code(), list("--field <field>", "Field to return (repeatable); omit for all. An unsupported name rejects the whole call with 100003", "fieldList"), format(), output()],
+});
+query(fund, "nav", {
+    description: "Daily NAV: unit, accumulated and adjusted NAV, adjustment factor; money-market funds add 7-day annualized yield and income per 10k units",
+    endpoint: "fund.nav",
+    fields: [code(), ...range("Trade date"), format(), output()],
+});
+query(fund, "fee-rate", {
+    description: "Current fee rates by type, one row per condition band (holding period, amount)",
+    endpoint: "fund.fee-rate",
+    fields: [code(), list("--fee-type <type>", "purchaseFee / redemptionFee / managementFee / custodianFee / saleFee (repeatable); omit for all", "feeTypeList"), format(), output()],
+});
+query(fund, "manager-info", {
+    description: "Fund manager profiles by name: career, funds and assets under management, introduction",
+    endpoint: "fund.manager-info",
+    fields: [requiredList("--manager <name>", "Manager name, e.g. 张坤 (repeatable). Exact match; every manager with that name comes back — tell them apart by currentCompany", "managerNameList", collectNames), format(), output()],
+});
+query(fund, "manager-history", {
+    description: "Past and present managers of a fund: tenure, days managed, return over tenure (endDate null = current)",
+    endpoint: "fund.manager-history",
+    fields: [code(), format(), output()],
+});
+query(fund, "asset-size", {
+    description: "Shares at start and end of each report period, subscriptions, redemptions, net assets",
+    endpoint: "fund.asset-size",
+    fields: [code(), ...range("Report date"), format(), output()],
+});
+query(fund, "holder-structure", {
+    description: "Holder count and institutional / individual / employee holdings per report date",
+    endpoint: "fund.holder-structure",
+    fields: [code(), ...range("Report date"), format(), output()],
+});
+query(fund, "top10-holders", {
+    description: "Top 10 holders of a listed fund (LOF / ETF) per report date",
+    endpoint: "fund.top10-holders",
+    fields: [code(), ...range("Report date"), format(), output()],
+});
+query(fund, "asset-allocation", {
+    description: "Asset allocation per report date: amount and % of total assets by asset type",
+    endpoint: "fund.asset-allocation",
+    fields: [code(), ...range("Report date"), list("--asset-level <level>", "level1 / level2 (repeatable); omit for both", "assetLevelList"), format(), output()],
+});
+query(fund, "stock-portfolio", {
+    description: "Stock holdings per report date: shares, value, % of float and of NAV, change vs the previous report",
+    endpoint: "fund.stock-portfolio",
+    fields: [code(), ...range("Report date"), positionType(), format(), output()],
+});
+query(fund, "industry-allocation", {
+    description: "Stock holdings grouped by level-1 industry (SW or CITIC), as % of NAV",
+    endpoint: "fund.industry-allocation",
+    fields: [code(), ...range("Report date"), value("--industry-standard <name>", "swIndustry = SW level 1 (server default) / citicIndustry = CITIC level 1", "industryStandard"), positionType(), format(), output()],
+});
+query(fund, "bond-portfolio", {
+    description: "Bond holdings per report date: quantity, value, % of NAV",
+    endpoint: "fund.bond-portfolio",
+    fields: [code(), ...range("Report date"), format(), output()],
+});
+query(fund, "bond-type-allocation", {
+    description: "Bond holdings grouped by bond type, as % of NAV",
+    endpoint: "fund.bond-type-allocation",
+    fields: [code(), ...range("Report date"), format(), output()],
+});
+query(fund, "fund-portfolio", {
+    description: "Fund-of-funds holdings of other funds: value and % of NAV",
+    endpoint: "fund.fund-portfolio",
+    fields: [code(), ...range("Report date"), format(), output()],
+});
+query(fund, "fund-type-allocation", {
+    description: "Fund-of-funds holdings grouped by fund category (level 1), as % of NAV",
+    endpoint: "fund.fund-type-allocation",
+    fields: [code(), ...range("Report date"), format(), output()],
+});
+query(fund, "etf-pcf-header", {
+    description: "ETF creation/redemption parameters for the latest trade date: unit size, daily limits, cash components",
+    endpoint: "fund.etf-pcf-header",
+    fields: [code(), format(), output()],
+});
+query(fund, "etf-pcf-components", {
+    description: "ETF creation/redemption component list for the latest trade date: quantities, weights, cash substitution",
+    endpoint: "fund.etf-pcf-components",
+    fields: [code(), format(), output()],
+});
+query(fund, "etf-share-change", {
+    description: "ETF shares and scale per trade date, with the change vs the previous one",
+    endpoint: "fund.etf-share-change",
+    fields: [code(), ...range("Trade date"), format(), output()],
+});

package/dist/src/commands/fundamental.js

@@ -1,5 +1,6 @@
 import { Command, Option } from "commander";
 import { beijingDateString, collectList, dateArg, maybeArray, parseOptionalNumberOption } from "../core/args.js";
+import { COSTLY_FETCH_CREDITS } from "../core/endpoints.js";
 import { normalizeRows } from "../core/normalize.js";
 import { parseOutputFormat } from "../core/output.js";
 import { printData } from "../core/printer.js";
@@ -128,6 +129,7 @@ fundamental.command("earning-forecast")
     .option("--start-date <date>", "Start date (default: 1 year before end-date)", dateArg("--start-date"))
     .option("--end-date <date>", "End date (default: today)", dateArg("--end-date"))
     .option("--consensus <name>", "Consensus indicator: netIncome/netIncomeYoy/eps/pe/bps/pb/peg/roe/ps", collectList, [])
+    .option("--yes", `Fetch a range estimated above ${COSTLY_FETCH_CREDITS} credits (billed per row; see the refusal for the estimate)`)
     .option("--format <format>", "Output format", "table")
     .option("--output <path>")
     .action((options) => emit(options, (client) => {

package/dist/src/commands/groups.js

@@ -0,0 +1,14 @@
+import { ai } from "./ai.js";
+import { alternative } from "./alternative.js";
+import { auth, lookup } from "./auth.js";
+import { bond } from "./bond.js";
+import { fund } from "./fund.js";
+import { fundamental } from "./fundamental.js";
+import { indicator } from "./indicator.js";
+import { insight } from "./insight.js";
+import { quote } from "./quote.js";
+import { raw } from "./raw.js";
+import { reference } from "./reference.js";
+import { tool } from "./tool.js";
+import { vault } from "./vault.js";
+export const COMMAND_GROUPS = [auth, lookup, insight, quote, fundamental, bond, fund, reference, vault, ai, alternative, indicator, tool, raw];

package/dist/src/commands/indicator.js

@@ -1,5 +1,5 @@
 import { Command, Option } from "commander";
-import { collectList, dateArg, screenerExpressionFields, parseNumberOption, parseScreenerIndicators } from "../core/args.js";
+import { collectList, collectNames, dateArg, screenerExpressionFields, parseNumberOption, parseScreenerIndicators } from "../core/args.js";
 import { buildIndicatorCrossSectionBody, buildIndicatorScreenerBody, buildIndicatorTimeSeriesBody } from "../core/commandBodies.js";
 import { checkScreenerBindings, droppedFromMatrix, flattenCrossSection, flattenTimeSeries, isEmptyMatrix, requireIndicatorMatrix, unwrapIndicatorData } from "../core/indicatorMatrix.js";
 import { resolveCalendarType } from "../core/calendarType.js";
@@ -56,7 +56,7 @@ indicator.command("cross-section")
     .requiredOption("--date <date>", "Data date (yyyy-MM-dd); sent as each indicator's tradeDate. Report-period indicators (is_*, financial statements) REJECT tradeDate and require --indicator-param 'code:reportDate=yyyy-MM-dd' instead — check parameterList in 'indicator search'", dateArg("--date"))
     .option("--currency <code>", "Currency: DFT/CNY/HKD/USD/EUR/GBP/JPY/TWD/MOP/AUD (default DFT)")
     .option("--scale <code>", "Scale: 0=个 3=千 4=万 6=百万 8=亿 9=十亿 (default 0)")
-    .option("--indicator-param <spec>", "Per-indicator param 'code:key=value', e.g. qte_close:adjustType=2 for 前复权 (repeat); read exact keys from 'indicator search'. Bare 'code:' (nothing after the colon) declares the indicator takes NO date — required by any indicator whose parameterList has no date key at all, which otherwise rejects the tradeDate --date injects: the pty_* / scr_* static-attribute families (pty_op_scope, scr_exchg_mkt, scr_isin …), plus div_cash_paid_ratio / div_cash_yr (add 'code:fiscalYear=YYYY' too) and pty_shr_reg. It composes with real params, so 'code:' + 'code:scale=8' keeps the scale", collectList, [])
+    .option("--indicator-param <spec>", "Per-indicator param 'code:key=value', e.g. qte_close:adjustType=2 for 前复权 (repeat); read exact keys from 'indicator search'. Bare 'code:' (nothing after the colon) declares the indicator takes NO date — required by any indicator whose parameterList has no date key at all, which otherwise rejects the tradeDate --date injects: the pty_* / scr_* static-attribute families (pty_op_scope, scr_exchg_mkt, scr_isin …), plus div_cash_paid_ratio / div_cash_yr (add 'code:fiscalYear=YYYY' too) and pty_shr_reg. It composes with real params, so 'code:' + 'code:scale=8' keeps the scale", collectNames, [])
     .addOption(new Option("--key-by <mode>", "Column key: name=display name (default) | code=indicatorCode, unique & order-stable for batch code→value mapping").choices(["name", "code"]).default("name"))
     .option("--format <format>", "Output format", "table")
     .option("--output <path>")
@@ -77,7 +77,7 @@ indicator.command("time-series")
     .option("--calendar-type <type>", "Calendar: ND=natural TD=trading WD=weekday. Omit it and the CLI picks: a free 'indicator search' reads each parameterList and sends TD only when EVERY indicator is trading-day typed, otherwise it leaves the server on ND (report-period indicators land on dates a trading calendar lacks, and TD would answer them with an all-null grid). An explicit value is sent as given, with no lookup")
     .option("--currency <code>", "Currency: DFT/CNY/HKD/USD/EUR/GBP/JPY/TWD/MOP/AUD (default DFT)")
     .option("--scale <code>", "Scale: 0=个 3=千 4=万 6=百万 8=亿 9=十亿 (default 0)")
-    .option("--indicator-param <spec>", "Per-indicator param 'code:key=value', e.g. qte_close:adjustType=2 for 前复权 (repeat); read exact keys from 'indicator search'", collectList, [])
+    .option("--indicator-param <spec>", "Per-indicator param 'code:key=value', e.g. qte_close:adjustType=2 for 前复权 (repeat); read exact keys from 'indicator search'", collectNames, [])
     .addOption(new Option("--key-by <mode>", "Column key: name=display name (default) | code=indicatorCode/securityCode, unique & order-stable for batch mapping").choices(["name", "code"]).default("name"))
     .option("--format <format>", "Output format", "table")
     .option("--output <path>")
@@ -100,11 +100,11 @@ indicator.command("time-series")
 }));
 indicator.command("screener")
     .description("Screen securities by an expression over indicator values (条件选股)")
-    .option("--indicator <spec>", "Bind a variable to an indicator, 'F1:code', e.g. F1:qte_mkt_cptl (REQUIRED, repeat)", collectList, [])
+    .option("--indicator <spec>", "Bind a variable to an indicator, 'F1:code', e.g. F1:qte_mkt_cptl (REQUIRED, repeat)", collectNames, [])
     .option("--security <code>", "Security code, e.g. 600519.SH, or a sector ID from 'gangtise reference sector-search' (REQUIRED, repeat; union, deduped)", collectList, [])
     .requiredOption("--expression <expr>", "Filter over the bound variables, e.g. 'F1 >= 800 && (F2 >= 20 && F2 <= 30)'; also supports contains/notcontains on string indicators")
     .requiredOption("--date <date>", "Data date (yyyy-MM-dd); sent as every indicator's tradeDate unless it already has one. Report-period indicators (is_*) reject tradeDate: give them --indicator-param 'F1:reportDate=yyyy-MM-dd'", dateArg("--date"))
-    .option("--indicator-param <spec>", "Per-variable param 'F1:key=value', e.g. F1:scale=8 (repeat); read exact keys from 'indicator search'. Bare 'F1:' (nothing after the colon) declares that the indicator takes NO date — required by any indicator whose parameterList has no date key at all, which otherwise rejects the tradeDate --date injects: the pty_* / scr_* static-attribute families (pty_op_scope, scr_exchg_sctr, scr_isin …), plus div_cash_paid_ratio / div_cash_yr (add 'F1:fiscalYear=YYYY' too) and pty_shr_reg. It composes with real params, so 'F1:' + 'F1:scale=8' keeps the scale", collectList, [])
+    .option("--indicator-param <spec>", "Per-variable param 'F1:key=value', e.g. F1:scale=8 (repeat); read exact keys from 'indicator search'. Bare 'F1:' (nothing after the colon) declares that the indicator takes NO date — required by any indicator whose parameterList has no date key at all, which otherwise rejects the tradeDate --date injects: the pty_* / scr_* static-attribute families (pty_op_scope, scr_exchg_sctr, scr_isin …), plus div_cash_paid_ratio / div_cash_yr (add 'F1:fiscalYear=YYYY' too) and pty_shr_reg. It composes with real params, so 'F1:' + 'F1:scale=8' keeps the scale", collectNames, [])
     .addOption(new Option("--key-by <mode>", "Column key: name=display name (default) | code=indicatorCode").choices(["name", "code"]).default("name"))
     .option("--format <format>", "Output format", "table")
     .option("--output <path>")

package/dist/src/commands/insight.js

@@ -1,11 +1,10 @@
 import { Command } from "commander";
-import { collectList, dateArg, maybeArray, parseChoiceList, parseFrom, parseSize, parseTimestamp13 } from "../core/args.js";
+import { collectList, dateArg, maybeArray, parseChoiceList, parseEndTimestamp13, parseFrom, parseSize, parseTimestamp13 } from "../core/args.js";
 import { ValidationError } from "../core/errors.js";
 import { fetchOpinionDetails } from "../core/opinionDetail.js";
 import { rowCount } from "../core/rowSink.js";
-import { emit, addDownloadCommand, confirmCostly, multiChoice, value, required, list, numberList, choiceList, count, rankType, searchType, top, flag, format, output, from, size, startTime, endTime, timeFilters, query } from "./shared.js";
+import { emit, addDownloadCommand, confirmCostly, multiChoice, value, required, list, numberList, choiceList, count, rankType, searchType, top, flag, format, output, from, size, startTime, endTime, timeFilters, query, RESEARCH_AREA_CITIC_OR_DIRECTION } from "./shared.js";
 export const insight = new Command("insight").description("Insight APIs");
-const RESEARCH_AREA_CITIC_OR_DIRECTION = "Research area ID: citicIndustry code (1008001xx) or gangtiseIndustry direction code (122000xxx: macro/strategy/fixed-income/quant/overseas). swIndustry (104xx0000) returns 0 here";
 const SW_INDUSTRY_ONLY = "Industry ID -- swIndustry codes only (104xx0000); citicIndustry codes are rejected with 100005 even where constant-category declares them";
 const opinion = new Command("opinion");
 const summary = new Command("summary");
@@ -204,7 +203,7 @@ query(announcement, "list", {
         list("--security <code>", "Security code", "securityList"),
         list("--category <id>", "Category ID", "categoryList"),
         format(), output("Output path"),
-        ...timeFilters(parseTimestamp13),
+        ...timeFilters(parseTimestamp13, parseEndTimestamp13),
     ],
 });
 addDownloadCommand(announcement, { endpointKey: "insight.announcement.download", idOption: "--announcement-id", idField: "announcementId", fallbackPrefix: "announcement", fileType: { description: "File type: 1=PDF 2=Markdown", choices: ["1", "2"], default: "1" }, titleListEndpoint: "insight.announcement.list" });

package/dist/src/commands/raw.js

@@ -13,16 +13,17 @@ export const raw = new Command("raw").description("Raw API calls").addCommand(ne
     }
     assertConfirmed(endpointKey, Boolean(options.yes), endpointKey);
     const format = parseOutputFormat(options.format);
-    const client = await createClient({ format, output: options.output, yes: Boolean(options.yes) });
     let body;
     if (options.body) {
         try {
             body = JSON.parse(options.body);
         }
-        catch {
-            throw new ConfigError(`Invalid JSON in --body: ${options.body}`);
+        catch (error) {
+            const position = /position (\d+)/.exec(error instanceof Error ? error.message : "")?.[1];
+            throw new ConfigError(`Invalid JSON in --body${position === undefined ? "" : ` (at character ${position})`}; the body is not echoed because it may hold credentials`);
         }
     }
+    const client = await createClient({ format, output: options.output, yes: Boolean(options.yes) });
     if (endpoint.kind === "download") {
         if (body !== undefined && endpoint.method !== "POST") {
             throw new ValidationError(`--body is not supported for GET download endpoints (use --query key=value); ${endpointKey} is kind=download`);

package/dist/src/commands/shared.js

@@ -1,11 +1,13 @@
+import fs from "node:fs/promises";
+import path from "node:path";
 import { Option } from "commander";
 import { QUOTE_MAX_LIMIT } from "../core/quoteSharding.js";
 import { collectList, dateArg, datetimeArg, maybeArray, numberListArg, parseChoiceList, parseFrom, parseNumberOption, parseOptionalNumberOption, parseSize } from "../core/args.js";
 import { loadConfig } from "../core/config.js";
-import { releaseClaim, resolveTitle, saveDownloadResult, uniquePath } from "../core/download.js";
+import { placeStreamedDownload, releaseClaim, resolveTitle, saveDownloadResult, uniquePath } from "../core/download.js";
 import { ENDPOINTS } from "../core/endpoints.js";
 import { ValidationError } from "../core/errors.js";
-import { parseOutputFormat } from "../core/output.js";
+import { parseOutputFormat, stagingPath } from "../core/output.js";
 import { printData } from "../core/printer.js";
 import { ExportSink, getRowSink } from "../core/rowSink.js";
 export async function createClient(stream) {
@@ -91,7 +93,21 @@ export async function runDownload(client, endpointKey, query, options) {
         await saveDownloadResult(result, options.fallbackName, options.output);
         return;
     }
-    const result = await client.call(endpointKey, options.body, query);
+    const temp = stagingPath(path.resolve(".gangtise-download"), "part");
+    const result = await client.call(endpointKey, options.body, query, { streamTo: temp });
+    const streamed = result;
+    if (typeof streamed?.savedPath === "string") {
+        let named;
+        try {
+            named = options.resolveOutputPath ? await options.resolveOutputPath(result) : undefined;
+        }
+        catch (error) {
+            await fs.unlink(streamed.savedPath).catch(() => { });
+            throw error;
+        }
+        process.stdout.write(`${await placeStreamedDownload({ ...streamed, savedPath: streamed.savedPath }, options.fallbackName, named)}\n`);
+        return;
+    }
     const resolved = options.resolveOutputPath ? await options.resolveOutputPath(result) : undefined;
     const target = resolved ? await uniquePath(resolved) : undefined;
     try {
@@ -139,8 +155,9 @@ export function assertConfirmed(endpointKey, confirmed, target) {
         return;
     throw new ValidationError(`${destructive.warning} 确认要对 ${target} 执行就加上 --yes。`);
 }
+export const RESEARCH_AREA_CITIC_OR_DIRECTION = "Research area ID: citicIndustry code (1008001xx) or gangtiseIndustry direction code (122000xxx: macro/strategy/fixed-income/quant/overseas). swIndustry (104xx0000) returns 0 here";
 export const field = (option, body) => ({ option, body });
-export const confirmCostly = () => field(new Option("--yes", "Fetch every row even when a fetch without --size is estimated above the credit guard (the list is billed per row)"));
+export const confirmCostly = () => field(new Option("--yes", "Fetch past the credit guard: a fetch without --size, or with a large one, estimated above 1000 credits (the list is billed per row)"));
 export const value = (flags, description, key) => field(new Option(flags, description), (v) => ({ [key]: v }));
 export const required = (flags, description, key) => field(new Option(flags, description).makeOptionMandatory(), (v) => ({ [key]: v }));
 export const date = (flags, description, key, opts = {}) => {
@@ -149,6 +166,14 @@ export const date = (flags, description, key, opts = {}) => {
     return field(opts.required ? option.makeOptionMandatory() : option, (v) => ({ [key]: v }));
 };
 export const list = (flags, description, key) => field(new Option(flags, description).argParser(collectList).default([]), (v) => ({ [key]: maybeArray(v) }));
+export const requiredList = (flags, description, key, parse = collectList) => {
+    const option = new Option(flags, description).argParser(parse).makeOptionMandatory();
+    return field(option, (v) => {
+        if (!v.length)
+            throw new ValidationError(`${option.long} is empty: pass at least one value`);
+        return { [key]: v };
+    });
+};
 export const numberList = (flags, description, key) => {
     const option = new Option(flags, description).default([]);
     option.argParser(numberListArg(option.long));
@@ -183,7 +208,7 @@ export const size = (description = "Total rows to return; omit to fetch all") =>
 const asTyped = (v) => v;
 export const startTime = (description = "Start time", toBody = asTyped) => field(new Option("--start-time <datetime>", description).argParser(datetimeArg("--start-time")), (v) => ({ startTime: toBody(v, "--start-time") }));
 export const endTime = (description = "End time", toBody = asTyped) => field(new Option("--end-time <datetime>", description).argParser(datetimeArg("--end-time")), (v) => ({ endTime: toBody(v, "--end-time") }));
-export const timeFilters = (toBody = asTyped) => [from(), size(), startTime("Start time", toBody), endTime("End time", toBody), value("--keyword <keyword>", "Keyword", "keyword")];
+export const timeFilters = (toBody = asTyped, toEndBody = toBody) => [from(), size(), startTime("Start time", toBody), endTime("End time", toEndBody), value("--keyword <keyword>", "Keyword", "keyword")];
 export const requestBody = (fields, options) => Object.assign({}, ...fields.map((f) => f.body?.(options[f.option.attributeName()]) ?? {}));
 export function query(parent, name, spec) {
     const command = parent.command(name);
@@ -193,5 +218,9 @@ export function query(parent, name, spec) {
     const fields = defaultEndpoint?.pagination?.enabled && defaultEndpoint.billing?.per === "row" ? [...spec.fields, confirmCostly()] : spec.fields;
     for (const f of fields)
         command.addOption(f.option);
-    return command.action((options) => emit(options, (client) => client.call(typeof spec.endpoint === "string" ? spec.endpoint : spec.endpoint(options), requestBody(fields, options)), spec.cache));
+    return command.action(async (options) => {
+        const body = requestBody(fields, options);
+        const endpoint = typeof spec.endpoint === "string" ? spec.endpoint : spec.endpoint(options);
+        return emit(options, (client) => client.call(endpoint, body), spec.cache);
+    });
 }

package/dist/src/commands/tool.js

@@ -33,7 +33,7 @@ tool.command("file-parse-check").description("Download a finished file-parse res
 }));
 tool.command("web-search").description("Search the public web for research: deduped, source-tiered (T0-T3) results with optional page content (1 credit/call)")
     .requiredOption("--query <text>", "Search query, 1-200 chars. Sent verbatim — no intent rewriting server-side, so spell out what you want")
-    .option("--size <number>", "Results to return, 1-20 (1-5 with --include-content)", "10")
+    .option("--size <number>", "Results to return, 1-20 (1-5 with --include-content); default 10, or 5 with --include-content")
     .addOption(new Option("--freshness <window>", "Time window over publishTime; results with no resolvable publish date are dropped by day/week/month").choices(["day", "week", "month", "none"]))
     .addOption(new Option("--min-tier <tier>", "Lowest source tier to keep; T3 = no filtering").choices(["T0", "T1", "T2", "T3"]))
     .option("--site <domain>", "Restrict to a registered domain or subdomain, e.g. csrc.gov.cn (repeatable, max 10, OR-ed)", collectList, [])
@@ -41,7 +41,7 @@ tool.command("web-search").description("Search the public web for research: dedu
     .option("--max-content-chars <number>", "Max chars per body, 1000-20000 (only with --include-content)")
     .option("--format <format>", "Output format", "table").option("--output <path>")
     .action((options) => emit(options, (client) => {
-    const size = parseNumberOption(options.size, "--size", { integer: true, min: 1, max: 20 });
+    const size = parseNumberOption(options.size ?? (options.includeContent ? "5" : "10"), "--size", { integer: true, min: 1, max: 20 });
     if (options.includeContent && size > 5)
         throw new ValidationError(`--size ${size} with --include-content: this endpoint caps size at 5 when page bodies are requested. Lower --size, or drop --include-content to fetch up to 20 snippets.`);
     const sites = [...new Set(options.site)];

package/dist/src/commands/vault.js

@@ -1,9 +1,8 @@
 import { Command, Option } from "commander";
-import { collectList, datetimeArg } from "../core/args.js";
-import { buildStockPoolStocksBody, buildWechatChatroomListBody, buildWechatMessageListBody } from "../core/commandBodies.js";
+import { collectList, collectNames } from "../core/args.js";
 import { uploadDriveFile } from "../core/driveUpload.js";
 import { flagFailedItems } from "../core/normalize.js";
-import { emit, addDownloadCommand, assertConfirmed, field, value, required, list, numberList, format, output, from, size, startTime, endTime, query } from "./shared.js";
+import { emit, addDownloadCommand, assertConfirmed, field, value, required, list, numberList, format, output, from, size, startTime, endTime, query, RESEARCH_AREA_CITIC_OR_DIRECTION } from "./shared.js";
 export const vault = new Command("vault").description("Vault APIs");
 query(vault, "drive-list", {
     endpoint: "vault.drive.list",
@@ -117,7 +116,7 @@ query(vault, "my-conference-list", {
     cache: { endpointKey: "vault.my-conference.list", idField: "conferenceId" },
     fields: [
         from(), size(), startTime(), endTime(), value("--keyword <text>", undefined, "keyword"),
-        list("--research-area <id>", "Research area ID: citicIndustry code (1008001xx) or gangtiseIndustry direction code (122000xxx: macro/strategy/fixed-income/quant/overseas). swIndustry (104xx0000) returns 0 here", "researchAreaList"),
+        list("--research-area <id>", RESEARCH_AREA_CITIC_OR_DIRECTION, "researchAreaList"),
         list("--security <code>", "Security code", "securityList"),
         list("--institution <id>", "Institution ID", "institutionList"),
         list("--category <name>", "Conference category: earningsCall/strategyMeeting/fundRoadshow/shareholdersMeeting/maMeeting/specialMeeting/companyAnalysis/industryAnalysis/other", "categoryList"),
@@ -126,33 +125,34 @@ query(vault, "my-conference-list", {
     ],
 });
 addDownloadCommand(vault, { endpointKey: "vault.my-conference.download", name: "my-conference-download", idOption: "--conference-id", idField: "conferenceId", fallbackPrefix: "conference", contentTypeDescription: "Content type: asr/summary", contentTypeChoices: ["asr", "summary"], titleListEndpoint: "vault.my-conference.list" });
-vault.command("wechat-message-list")
-    .option("--from <number>", "Starting offset", "0")
-    .option("--size <number>", "Total rows to return; omit to fetch all")
-    .option("--start-time <datetime>", "Start time", datetimeArg("--start-time"))
-    .option("--end-time <datetime>", "End time", datetimeArg("--end-time"))
-    .option("--keyword <text>")
-    .option("--security <code>", "Security code (e.g. 000001.SZ)", collectList, [])
-    .option("--wechat-group-id <id>", "WeChat group ID", collectList, [])
-    .option("--industry <id>", "Industry ID -- citicIndustry codes (1008001xx) only; swIndustry codes and unknown values are rejected with 100005", collectList, [])
-    .option("--category <name>", "Message type: text/image/documents/url", collectList, [])
-    .option("--tag <name>", "Tag: roadShow/research/strategyMeeting/meetingSummary/industryComment/companyComment/earningsReview", collectList, [])
-    .option("--format <format>", "Output format", "table")
-    .option("--output <path>")
-    .action((options) => emit(options, (client) => client.call("vault.wechat-message.list", buildWechatMessageListBody(options))));
-vault.command("wechat-chatroom-list")
-    .option("--from <number>", "Starting offset", "0")
-    .option("--size <number>", "Total rows to return; omit to fetch all")
-    .option("--room-name <name>", "WeChat group name; repeat or comma-separate for multiple names", collectList, [])
-    .option("--format <format>", "Output format", "table")
-    .option("--output <path>")
-    .action((options) => emit(options, (client) => client.call("vault.wechat-chatroom.list", buildWechatChatroomListBody(options))));
+query(vault, "wechat-message-list", {
+    endpoint: "vault.wechat-message.list",
+    fields: [
+        from(), size(), startTime(), endTime(), value("--keyword <text>", undefined, "keyword"),
+        list("--security <code>", "Security code (e.g. 000001.SZ)", "securityList"),
+        list("--wechat-group-id <id>", "WeChat group ID", "wechatGroupIdList"),
+        list("--industry <id>", "Industry ID -- citicIndustry codes (1008001xx) only; swIndustry codes and unknown values are rejected with 100005", "industryIdList"),
+        list("--category <name>", "Message type: text/image/documents/url", "categoryList"),
+        list("--tag <name>", "Tag: roadShow/research/strategyMeeting/meetingSummary/industryComment/companyComment/earningsReview", "tagList"),
+        format(), output(),
+    ],
+});
+query(vault, "wechat-chatroom-list", {
+    endpoint: "vault.wechat-chatroom.list",
+    fields: [
+        from(), size(),
+        field(new Option("--room-name <name>", "WeChat group name; repeat or comma-separate for multiple names").argParser(collectNames).default([]), (v) => ({ roomName: v.length > 0 ? v.join(",") : undefined })),
+        format(), output(),
+    ],
+});
 query(vault, "stock-pool-list", { endpoint: "vault.stock-pool.list", fields: [format(), output()] });
-vault.command("stock-pool-stocks")
-    .option("--pool-id <id>", "Pool ID; repeat for multiple; omit (or 'all') for all pools", collectList)
-    .option("--format <format>", "Output format", "table")
-    .option("--output <path>")
-    .action((options) => emit(options, (client) => client.call("vault.stock-pool.stocks", buildStockPoolStocksBody(options))));
+query(vault, "stock-pool-stocks", {
+    endpoint: "vault.stock-pool.stocks",
+    fields: [
+        field(new Option("--pool-id <id>", "Pool ID; repeat for multiple; omit (or 'all') for all pools").argParser(collectList), (v) => ({ poolIdList: v?.length ? v : ["all"] })),
+        format(), output(),
+    ],
+});
 query(vault, "stock-pool-create", {
     endpoint: "vault.stock-pool.create",
     fields: [

package/dist/src/core/args.js

@@ -1,12 +1,18 @@
 import { ValidationError } from "./errors.js";
 export function splitCsv(value) {
     return value
-        .split(/[,，]/)
+        .split(/[,，、;；\s]+/)
         .map((item) => item.trim())
         .filter(Boolean);
 }
 export function collectList(value, previous = []) {
-    return [...previous, ...splitCsv(value)];
+    return unique([...previous, ...splitCsv(value)]);
+}
+function unique(values) {
+    return [...new Set(values)];
+}
+export function collectNames(value, previous = []) {
+    return unique([...previous, ...value.split(/[,，]/).map((item) => item.trim()).filter(Boolean)]);
 }
 export function collectText(value, previous = []) {
     const text = value.trim();
@@ -44,10 +50,12 @@ export function parseSize(value) {
     return parseOptionalNumberOption(value, "--size", { integer: true, min: 1 });
 }
 export function numberListArg(optionName) {
-    return (value, previous = []) => [
-        ...previous,
-        ...splitCsv(value).map((item) => parseNumberOption(item, optionName, { integer: true })),
-    ];
+    const parse = (value, previous = []) => [...new Set([
+            ...previous,
+            ...splitCsv(value).map((item) => parseNumberOption(item, optionName, { integer: true })),
+        ])];
+    ACCUMULATING_PARSERS.add(parse);
+    return parse;
 }
 export function collectKeyValue(value, previous = {}) {
     const index = value.indexOf("=");
@@ -155,6 +163,13 @@ export function toTimestamp13(value) {
     const instant = new Date(`${y}-${mo}-${d}T${hh}:${mi}:${ss}${BEIJING_OFFSET}`).getTime();
     return Number.isNaN(instant) ? undefined : instant;
 }
+export function parseEndTimestamp13(value, optionName) {
+    const parsed = parseTimestamp13(value, optionName);
+    if (parsed === undefined || value === undefined)
+        return parsed;
+    const parts = LOCAL_DATETIME.exec(value);
+    return parts && parts[5] === undefined ? parsed + 86_400_000 - 1 : parsed;
+}
 export function parseTimestamp13(value, optionName) {
     if (value === undefined)
         return undefined;
@@ -204,7 +219,7 @@ function parseParamSpecs(specs, option, syntax) {
             params = [];
             groups.set(lhs, params);
         }
-        params.push({ paramKey, paramValue });
+        params.push({ paramKey, paramValue: /date$/i.test(paramKey) ? parseDateOption(paramValue, `${option} "${spec}"`) : paramValue });
     }
     return { groups, noQueryDate };
 }
@@ -322,3 +337,4 @@ export function parseScreenerIndicators(bindings, paramSpecs, expression) {
     }
     return [...indicators.values()];
 }
+export const ACCUMULATING_PARSERS = new WeakSet([collectList, collectNames, collectText, collectKeyValue]);

package/dist/src/core/asyncContent.js

@@ -23,7 +23,7 @@ function terminalFailureLine(error) {
     const trace = api?.traceId ? ` [trace ${api.traceId}]` : "";
     const detail = api?.message ? `: ${api.message}` : "";
     return `Content generation failed (terminal${code})${trace}${detail}\n`
-        + "This dataId is final — re-checking it will not change. Resubmitting the generation task bills again for the same result; change the parameters first.\n";
+        + "This dataId is final — re-checking it will not change. Resubmitting the generation task bills again: if the message above points at a parameter or the content, change that first; a plain 业务处理失败 is not about the parameters — resubmit later only if you still need it.\n";
 }
 export async function pollUntilDone(attempt, notReady) {
     for (let n = 1; n <= POLL_MAX_ATTEMPTS; n++) {

package/dist/src/core/auth.js

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { ConfigError } from "./errors.js";
-import { stagingPath } from "./output.js";
+import { writeFileAtomic } from "./output.js";
 export function credentialFingerprint(accessKey, baseUrl) {
     return createHash("sha256").update(`${accessKey}\u0000${baseUrl}`).digest("hex").slice(0, 16);
 }
@@ -31,15 +31,7 @@ export function redactTokenCache(cache) {
 }
 export async function writeTokenCache(filePath, cache) {
     await fs.mkdir(path.dirname(filePath), { recursive: true });
-    const tmp = stagingPath(filePath, "tmp");
-    await fs.writeFile(tmp, JSON.stringify(cache, null, 2), { encoding: "utf8", mode: 0o600 });
-    try {
-        await fs.rename(tmp, filePath);
-    }
-    catch (error) {
-        await fs.unlink(tmp).catch(() => { });
-        throw error;
-    }
+    await writeFileAtomic(filePath, JSON.stringify(cache, null, 2), { mode: 0o600, suffix: "tmp" });
 }
 export function isTokenCacheValid(cache, bufferSeconds = 300, expectedFingerprint) {
     if (!cache?.accessToken || !cache.expiresAt) {