gangtise-openapi-cli 0.50.0 → 0.52.0

package/dist/src/core/endpoints.js

@@ -71,7 +71,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/chief-opinion/getDetail",
         kind: "json",
         description: "Get domestic chief opinion bodies by ID (max 20 IDs per call)",
-        billing: { per: "row", price: 30, maxUnits: 20 },
+        billing: { per: "row", price: 30, maxUnits: 20, unitsFrom: ["chiefOpinionIdList"] },
         retry: "no-replay",
         expects: "array",
     },
@@ -267,7 +267,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/foreign-opinion/getDetail",
         kind: "json",
         description: "Get foreign opinion bodies by ID (max 20 IDs per call)",
-        billing: { per: "row", price: 30, maxUnits: 20 },
+        billing: { per: "row", price: 30, maxUnits: 20, unitsFrom: ["foreignOpinionIdList"] },
         retry: "no-replay",
         expects: "array",
     },
@@ -288,6 +288,25 @@ const ENDPOINT_DEFS = {
         description: "Download foreign independent opinion file",
         billing: { per: "document", price: 30 },
     },
+    "insight.overseas-opinion.list": {
+        method: "POST",
+        path: "/application/open-insight/overseasOpinion/getList",
+        kind: "json",
+        description: "List overseas opinions (brief only; body via detail)",
+        billing: { per: "row", price: 0.1 },
+        pagination: { enabled: true, maxPageSize: 50, maxWindow: 10000 },
+        rowId: "overseasOpinionId",
+        expects: "list",
+    },
+    "insight.overseas-opinion.detail": {
+        method: "POST",
+        path: "/application/open-insight/overseasOpinion/getDetail",
+        kind: "json",
+        description: "Get overseas opinion bodies by ID (max 20 IDs per call)",
+        billing: { per: "row", price: 10, maxUnits: 20, unitsFrom: ["overseasOpinionIdList"] },
+        retry: "no-replay",
+        expects: "array",
+    },
     "insight.official-account.list": {
         method: "POST",
         path: "/application/open-insight/officialAccount/getList",
@@ -317,6 +336,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/report-image/getList",
         kind: "json",
         description: "Search research report images by keyword (returns chunkId + metadata)",
+        expects: "array",
     },
     "insight.highlight.list": {
         method: "POST",
@@ -341,54 +361,79 @@ const ENDPOINT_DEFS = {
         path: "/application/open-reference/securities/search",
         kind: "json",
         description: "Search GTS codes (securities)",
+        expects: "list",
     },
     "reference.chiefs-search": {
         method: "POST",
         path: "/application/open-reference/chiefs/search",
         kind: "json",
         description: "Search chief analyst IDs by name / institution / team",
+        expects: "list",
     },
     "reference.institution-search": {
         method: "POST",
         path: "/application/open-reference/institutions/search",
         kind: "json",
         description: "Search institution IDs by keyword (domestic broker / foreign / lead / opinion institution)",
+        expects: "list",
     },
     "reference.official-account-search": {
         method: "POST",
         path: "/application/open-reference/officialAccount/search",
         kind: "json",
         description: "Search official account (WeChat public account) IDs by name / institution / category",
+        expects: "list",
+    },
+    "reference.overseas-account-search": {
+        method: "POST",
+        path: "/application/open-reference/overseasAccount/search",
+        kind: "json",
+        description: "Search overseas opinion account IDs by name fragment",
+        pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "accountId",
+        expects: "list",
     },
     "reference.constant-category": {
         method: "GET",
         path: "/application/open-reference/constants/category",
         kind: "json",
         description: "List constant categories and their API usage scopes",
+        expects: "list",
     },
     "reference.constant-list": {
         method: "POST",
         path: "/application/open-reference/constants/getList",
         kind: "json",
         description: "List all constant values of a category",
+        expects: "object",
     },
     "reference.concept-search": {
         method: "POST",
         path: "/application/open-reference/concepts/search",
         kind: "json",
         description: "Search concept (theme) IDs by keyword",
+        expects: "list",
     },
     "reference.sector-search": {
         method: "POST",
         path: "/application/open-reference/sectors/search",
         kind: "json",
         description: "Search sector IDs by keyword",
+        expects: "list",
     },
     "reference.sector-constituents": {
         method: "POST",
         path: "/application/open-reference/sectors/constituents",
         kind: "json",
         description: "List constituent securities of a sector",
+        expects: "list",
+    },
+    "reference.index-weight": {
+        method: "POST",
+        path: "/application/open-quote/index/constituent-weight",
+        kind: "json",
+        description: "List index constituents with their weights (%) on one trading date",
+        expects: "list",
     },
     "quote.day-kline": {
         method: "POST",
@@ -451,72 +496,84 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/financial-report/income-statement/accumulated",
         kind: "json",
         description: "Query A-share income statement (accumulated)",
+        expects: "list",
     },
     "fundamental.income-statement-quarterly": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/income-statement/quarterly",
         kind: "json",
         description: "Query A-share income statement (quarterly)",
+        expects: "list",
     },
     "fundamental.balance-sheet": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/balance-sheet/accumulated",
         kind: "json",
         description: "Query A-share balance sheet (accumulated)",
+        expects: "list",
     },
     "fundamental.cash-flow": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/cash-flow-statement/accumulated",
         kind: "json",
         description: "Query A-share cash flow statement (accumulated)",
+        expects: "list",
     },
     "fundamental.cash-flow-quarterly": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/cash-flow-statement/quarterly",
         kind: "json",
         description: "Query A-share cash flow statement (quarterly)",
+        expects: "list",
     },
     "fundamental.income-statement-hk": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/income-statement/hk",
         kind: "json",
         description: "Query HK income statement (China GAAP)",
+        expects: "list",
     },
     "fundamental.balance-sheet-hk": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/balance-sheet/hk",
         kind: "json",
         description: "Query HK balance sheet (China GAAP)",
+        expects: "list",
     },
     "fundamental.cash-flow-hk": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/cash-flow-statement/hk",
         kind: "json",
         description: "Query HK cash flow statement (China GAAP)",
+        expects: "list",
     },
     "fundamental.income-statement-us": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/income-statement/us",
         kind: "json",
         description: "Query US income statement",
+        expects: "list",
     },
     "fundamental.balance-sheet-us": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/balance-sheet/us",
         kind: "json",
         description: "Query US balance sheet",
+        expects: "list",
     },
     "fundamental.cash-flow-us": {
         method: "POST",
         path: "/application/open-fundamental/financial-report/cash-flow-statement/us",
         kind: "json",
         description: "Query US cash flow statement",
+        expects: "list",
     },
     "fundamental.main-business": {
         method: "POST",
         path: "/application/open-fundamental/main-business",
         kind: "json",
         description: "Query main business composition",
+        expects: "list",
     },
     "fundamental.valuation-analysis": {
         method: "POST",
@@ -530,6 +587,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/capital-structure/top-holders",
         kind: "json",
         description: "Query top holders (top10 / top10 float)",
+        expects: "list",
     },
     "fundamental.earning-forecast": {
         method: "POST",
@@ -621,7 +679,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/rating-change",
         kind: "json",
         description: "Query bond rating change history (max 10 bonds per call)",
-        billing: { per: "security", price: 0.4, maxUnits: 10 },
+        billing: { per: "security", price: 0.4, maxUnits: 10, unitsFrom: ["securityList"] },
         retry: "no-replay",
         expects: "list",
     },
@@ -630,7 +688,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/issuer-rating-change",
         kind: "json",
         description: "Query issuer rating change history (by bond code or issuer name)",
-        billing: { per: "issuer", price: 0.4, maxUnits: 10 },
+        billing: { per: "issuer", price: 0.4, maxUnits: 10, unitsFrom: ["securityList", "issuerNameList"] },
         retry: "no-replay",
         expects: "list",
     },
@@ -828,7 +886,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/stock-summary/getList",
         kind: "json",
         description: "Stock highlights (refined research summary per security)",
-        billing: { per: "row", price: 1, maxUnits: 6000 },
+        billing: { per: "row", price: 1, maxUnits: 6000, unitsFrom: ["securityList"] },
         retry: "no-replay",
         timeoutMs: 120_000,
     },
@@ -922,6 +980,18 @@ const ENDPOINT_DEFS = {
         pagination: { enabled: true, maxPageSize: 20 },
         retry: "no-replay",
     },
+    "ai.expert-intel.list": {
+        method: "POST",
+        path: "/application/open-insight/expertIntel/getList",
+        kind: "json",
+        description: "List AI expert intel (takeaways distilled from expert meetings and minutes)",
+        billing: { per: "row", price: 20 },
+        pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "intelId",
+        rowIdUnverified: true,
+        retry: "no-replay",
+        expects: "list",
+    },
     "ai.management-discuss-announcement": {
         method: "POST",
         path: "/application/open-ai/management-discuss/from-announcement",
@@ -1012,6 +1082,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-vault/drive/getFolderList",
         kind: "json",
         description: "List the direct subfolders and files of a drive folder",
+        expects: "object",
     },
     "vault.drive.create-folder": {
         method: "POST",
@@ -1103,6 +1174,13 @@ const ENDPOINT_DEFS = {
         pagination: { enabled: true, maxPageSize: 50, maxWindow: 10000 },
         rowId: "msgId",
     },
+    "vault.wechat-message.download": {
+        method: "GET",
+        path: "/application/open-vault/wechatgroupmsg/download/file",
+        kind: "download",
+        description: "Download the file of a WeChat group message (document / image / audio / video)",
+        fileOnSuccess: true,
+    },
     "vault.wechat-chatroom.list": {
         method: "POST",
         path: "/application/open-vault/wechatgroupmsg/chatroomId",
@@ -1122,6 +1200,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-vault/stock-pool/getStockList",
         kind: "json",
         description: "List securities in stock pool(s)",
+        expects: "array",
     },
     "vault.stock-pool.create": {
         method: "POST",
@@ -1192,13 +1271,14 @@ const ENDPOINT_DEFS = {
         path: "/application/open-alternative/EDB/search",
         kind: "json",
         description: "Search industry indicator list by keyword",
+        expects: "array",
     },
     "alternative.edb-data": {
         method: "POST",
         path: "/application/open-alternative/EDB/getData",
         kind: "json",
         description: "Get industry indicator time-series data by indicator ID list",
-        billing: { per: "indicator", price: 30, maxUnits: 10 },
+        billing: { per: "indicator", price: 30, maxUnits: 10, unitsFrom: ["indicatorIdList"] },
     },
     "alternative.concept-info": {
         method: "POST",
@@ -1238,6 +1318,7 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "Search data indicators by keyword (returns indicatorCode + params)",
         retry: "no-999999",
+        expects: "array",
     },
     "indicator.cross-section": {
         method: "POST",

package/dist/src/core/errors.js

@@ -55,9 +55,9 @@ const ERROR_HINTS = {
     "120001": "用 `gangtise reference securities-search` 确认代码与后缀（如 600519.SH / 00700.HK）。",
     "130001": "未找到数据——先核对查询条件；EDE 指标端点此码也可能是未开通该指标权限，仍失败联系客户经理。",
     "130002": "确认 ID 有效且本账号可见（云盘的文件 / 文件夹 ID 用 `vault drive-folder-list` 核对，笔记 ID 用 `vault stock-note-list` 核对；删除类命令收到此码可能是目标已被删掉）；下载类还需检查 --file-type 取值是否合法。",
-    "130003": "资源未生成或该条记录未附带文件——换一条有附件的记录（列表里 hasAttachment/hasFile 为 true 的），或稍后再试。",
+    "130003": "资源未生成或该条记录未附带文件——换一条有附件的记录（列表里 hasAttachment/hasFile 为 true 的），或稍后再试；`vault wechat-message-download` 收到此码是消息不存在、本账号无权访问或文件已不可用，重试不会变。",
     "130004": "下载 ID 需为数字，检查该命令的 --*-id 参数是否传对。",
-    "130005": "对照命令 --help 检查 --file-type / --content-type 取值。",
+    "130005": "对照命令 --help 检查 --file-type / --content-type 取值；`vault wechat-message-download` 收到此码是该消息为 text / url、没有文件——只有 document / image / audio / video 消息可下载。",
     "140001": "稍后用对应 *-check 命令查询。",
     "140002": "终态失败，立即重试同一请求不会变。msg 指向参数（EDE 的指标参数名/枚举以 indicator search 的 parameterList 为准）就改参数重新提交；msg 是「业务处理失败」则与参数无关，稍后再试，持续出现请带 trace 报障。",
     "210001": "换一篇，或改用 list 取正文摘要。",

package/dist/src/core/etfComponents.js

@@ -1,8 +1,16 @@
 import { beijingDateString } from "./args.js";
 import { normalizeRows } from "./normalize.js";
 import { PAGE_CONCURRENCY, runWithConcurrency } from "./transport.js";
+function weekdayBefore(day) {
+    const d = new Date(`${day}T00:00:00Z`);
+    do
+        d.setUTCDate(d.getUTCDate() - 1);
+    while (d.getUTCDay() === 0 || d.getUTCDay() === 6);
+    return d.toISOString().slice(0, 10);
+}
 const PRICE_TOLERANCE = 0.0005;
 const agrees = (close, price) => price > 0 && Math.abs(close - price) / price <= PRICE_TOLERANCE;
+const CHANGE_TOLERANCE = 0.005;
 const QUOTABLE = /^(\d{6}\.(SH|SZ|BJ)|\d{5}\.HK|[A-Z][A-Z0-9.]*\.(O|N|A))$/;
 const QUOTE_BATCH = 500;
 const CLOSES_WINDOW_DAYS = 10;
@@ -137,7 +145,8 @@ export async function fillComponentCodes(rows, lookup) {
         }
     });
     const quotable = [...new Set([...candidates.values()].flat().filter((c) => ["stock", "dr"].includes(c.category) && QUOTABLE.test(c.code)).map((c) => c.code))];
-    const prices = new Map((await runWithConcurrency(inBatches(quotable, QUOTE_BATCH), PAGE_CONCURRENCY, (batch) => splitting(batch, (codes) => lookup.quotes(codes)))).flatMap((quoted) => [...quoted]));
+    const quotes = new Map((await runWithConcurrency(inBatches(quotable, QUOTE_BATCH), PAGE_CONCURRENCY, (batch) => splitting(batch, (codes) => lookup.quotes(codes)))).flatMap((quoted) => [...quoted]));
+    const prices = new Map([...quotes].map(([code, q]) => [code, [q.previous, q.latest].filter((p) => typeof p === "number")]));
     const isQuotable = (c) => ["stock", "dr"].includes(c.category) && QUOTABLE.test(c.code);
     const candidatesOf = (row) => candidates.get(row.componentName) ?? [];
     const marketsOf = (listed) => new Set(listed.map((c) => market(c.code)));
@@ -184,7 +193,30 @@ export async function fillComponentCodes(rows, lookup) {
                 history.set(code, series);
         }
     }
-    const mayBe = (row, c) => !history.has(c.code) || history.get(c.code).some(([, close]) => agrees(row.close, close));
+    const unshown = (close, c) => {
+        const { previous, latest, date } = quotes.get(c.code) ?? {};
+        const onLatest = latest !== undefined && agrees(close, latest);
+        const onPrevious = previous !== undefined && agrees(close, previous);
+        if (!onLatest && !onPrevious)
+            return false;
+        if (date === undefined)
+            return true;
+        const days = (history.get(c.code) ?? []).map(([day]) => day);
+        const reachesQuote = days.some((day) => day >= date);
+        const reachesPrevious = reachesQuote || days.includes(weekdayBefore(date));
+        return (onLatest && !reachesQuote) || (onPrevious && !reachesPrevious);
+    };
+    const marketDays = new Map([...etfs].map(([fundCode, { own }]) => [fundCode, listDates(own, candidates, history)]));
+    const startsLate = (row, c) => {
+        const first = history.get(c.code)?.[0]?.[0];
+        if (first === undefined)
+            return true;
+        const day = marketDays.get(row.fundCode)?.get(market(c.code));
+        if (day !== undefined)
+            return first > day;
+        return candidatesOf(row).some((o) => o.code !== c.code && (history.get(o.code) ?? []).some(([day, price]) => day < first && agrees(row.close, price)));
+    };
+    const mayBe = (row, c) => !history.has(c.code) || history.get(c.code).some(([, close]) => agrees(row.close, close)) || unshown(row.close, c) || startsLate(row, c);
     for (const { own, etf } of etfs.values()) {
         for (const row of own) {
             const matched = unverified.get(row);
@@ -210,11 +242,35 @@ export async function fillComponentCodes(rows, lookup) {
             }
         }
     }
+    for (const { own, etf } of etfs.values()) {
+        for (const row of own) {
+            const change = row.pctChange;
+            if (codes.has(row) || typeof change !== "number" || typeof row.close !== "number")
+                continue;
+            const close = row.close;
+            const pool = candidatesOf(row).filter((c) => !etf.used.has(c.code));
+            if (!pool.length || !pool.every((c) => isQuotable(c) && history.has(c.code)))
+                continue;
+            const atClose = (c) => history.get(c.code).filter(([, price]) => agrees(close, price));
+            const fits = (c) => atClose(c).filter(([, , moved]) => moved !== undefined && Math.abs(moved - change) <= CHANGE_TOLERANCE);
+            const hit = pool.filter((c) => fits(c).length);
+            if (!hit.length)
+                continue;
+            const unknown = pool.some((c) => !hit.includes(c) && (atClose(c).some(([, , moved]) => moved === undefined)
+                || unshown(close, c)
+                || startsLate(row, c)));
+            if (unknown || marketsOf(hit).size > 1)
+                continue;
+            const code = narrow(hit, etf);
+            if (code)
+                place(row, code, etf);
+        }
+    }
     for (const { own, etf } of etfs.values()) {
         const markets = new Set([...etf.used].map(market));
         let undecided = own.some((r) => failed.has(r.componentName));
         for (const r of own) {
-            if (codes.get(r) || tentative.has(r))
+            if (codes.get(r))
                 continue;
             const held = marketsOf(candidatesOf(r).filter((c) => !etf.used.has(c.code) && (typeof r.close !== "number" || mayBe(r, c))));
             if (held.size > 1)
@@ -329,14 +385,14 @@ export function clientLookup(client) {
             return Array.isArray(data?.list) ? data.list : [];
         },
         async closes(codes, startDate, endDate) {
-            const data = normalizeRows(await client.call("quote.day-kline", { securityList: codes, startDate, endDate, fieldList: ["securityCode", "tradeDate", "close"], limit: 10_000 }));
+            const data = normalizeRows(await client.call("quote.day-kline", { securityList: codes, startDate, endDate, fieldList: ["securityCode", "tradeDate", "close", "preClose"], limit: 10_000 }));
             const list = Array.isArray(data) ? data : (data?.list ?? []);
             const out = new Map();
             for (const k of list) {
                 if (typeof k.securityCode !== "string" || typeof k.tradeDate !== "string" || typeof k.close !== "number")
                     continue;
                 const series = out.get(k.securityCode) ?? [];
-                series.push([k.tradeDate, k.close]);
+                series.push(typeof k.preClose === "number" && k.preClose > 0 ? [k.tradeDate, k.close, (k.close / k.preClose - 1) * 100] : [k.tradeDate, k.close]);
                 out.set(k.securityCode, series);
             }
             for (const series of out.values())
@@ -347,10 +403,11 @@ export function clientLookup(client) {
             const data = normalizeRows(await client.call("quote.realtime", { securityList: codes }));
             const list = Array.isArray(data) ? data : (data?.list ?? []);
             const out = new Map();
+            const price = (value) => (typeof value === "number" ? value : undefined);
             for (const q of list) {
-                const prices = [q.preClose, q.latestPrice].filter((p) => typeof p === "number");
-                if (typeof q.securityCode === "string" && prices.length)
-                    out.set(q.securityCode, prices);
+                const quote = { previous: price(q.preClose), latest: price(q.latestPrice), date: typeof q.tradeDate === "string" && /^\d{4}-\d{2}-\d{2}$/.test(q.tradeDate) ? q.tradeDate : undefined };
+                if (typeof q.securityCode === "string" && (quote.previous !== undefined || quote.latest !== undefined))
+                    out.set(q.securityCode, quote);
             }
             return out;
         },

package/dist/src/core/exitStatus.js

@@ -1,9 +1,13 @@
 export const EXIT_FAILED = 1;
+export const EXIT_REFUSED = 2;
 export const EXIT_INCOMPLETE = 3;
 export const EXIT_SUPERSEDED = 4;
 export function markFailed() {
     process.exitCode = EXIT_FAILED;
 }
+export function markRefused() {
+    process.exitCode = EXIT_REFUSED;
+}
 export function markIncomplete() {
     if (process.exitCode !== EXIT_FAILED)
         process.exitCode = EXIT_INCOMPLETE;

package/dist/src/core/fileParse.js

@@ -3,11 +3,14 @@ import path from "node:path";
 import { isAsyncPending, pollUntilDone } from "./asyncContent.js";
 import { saveDownloadResult } from "./download.js";
 import { ApiError, ValidationError } from "./errors.js";
+import { assertNotStatePath } from "./statePaths.js";
 export const FILE_PARSE_MAX_BYTES = 100 * 1024 * 1024;
 export async function submitFileParse(client, filePath) {
-    const resolved = path.resolve(filePath);
+    const shownAs = path.resolve(filePath);
+    let resolved;
     let stat;
     try {
+        resolved = await fs.realpath(filePath);
         stat = await fs.stat(resolved);
     }
     catch {
@@ -15,17 +18,21 @@ export async function submitFileParse(client, filePath) {
     }
     if (!stat.isFile())
         throw new ValidationError(`Not a file: ${filePath}`);
+    await assertNotStatePath(resolved, "--file");
     if (stat.size === 0)
         throw new ValidationError(`File is empty: ${filePath}`);
     if (stat.size > FILE_PARSE_MAX_BYTES) {
         throw new ValidationError(`File is ${(stat.size / 1024 / 1024).toFixed(1)}MB — the parse API accepts at most 100MB`);
     }
-    if (path.extname(resolved).toLowerCase() !== ".pdf") {
+    if (path.extname(shownAs).toLowerCase() !== ".pdf") {
         throw new ValidationError(`Only PDF files are supported: ${filePath}`);
     }
     const data = await fs.readFile(resolved);
+    if (!data.subarray(0, 1024).toString("latin1").includes("%PDF-")) {
+        throw new ValidationError(`Not a PDF (no %PDF- header in its first 1KB): ${filePath}`);
+    }
     const result = await client.uploadFile("tool.file-parse.submit", {
-        filename: path.basename(resolved),
+        filename: path.basename(shownAs),
         data,
         contentType: "application/pdf",
     });

package/dist/src/core/printer.js

@@ -6,6 +6,7 @@ import { getRowSink } from "./rowSink.js";
 import { extractTitles, writeTitleCache } from "./titleCache.js";
 import { CLI_VERSION } from "../version.js";
 import { decidedExitCode, EXIT_SUPERSEDED, markIncomplete, markSuperseded } from "./exitStatus.js";
+import { describeNoRequest, isDryRun } from "./dryRun.js";
 const LARGE_RESULT_ROWS = 50_000;
 export const SUPERSEDED_EXIT = EXIT_SUPERSEDED;
 export async function warnIfSuperseded(output, digest) {
@@ -101,19 +102,50 @@ async function stageExportMeta(output, format, rows, columns, normalized, comple
         },
     };
 }
+let selectedColumns;
+export function setColumns(names) {
+    selectedColumns = names.length > 0 ? names : undefined;
+}
+export function columnsSelected() {
+    return selectedColumns !== undefined;
+}
+function projectColumns(value) {
+    const names = selectedColumns;
+    if (!names)
+        return value;
+    const isRecord = (row) => Boolean(row) && typeof row === "object" && !Array.isArray(row);
+    const rows = pickList(value) ?? (isRecord(value) ? [value] : []);
+    const present = new Set(rows.filter(isRecord).flatMap((row) => Object.keys(row)));
+    const absent = names.filter((name) => !present.has(name));
+    if (absent.length > 0 && present.size > 0) {
+        process.stderr.write(`[gangtise] warning: --columns names ${absent.join(", ")}, which no row has; the rows have ${[...present].join(", ")}.\n`);
+    }
+    const pick = (row) => (isRecord(row) ? Object.fromEntries(names.map((name) => [name, row[name] ?? null])) : row);
+    if (Array.isArray(value))
+        return value.map(pick);
+    if (!isRecord(value))
+        return value;
+    return Array.isArray(value.list) ? { ...value, list: value.list.map(pick) } : pick(value);
+}
 export async function printData(data, format, output, cache) {
+    if (isDryRun()) {
+        process.stdout.write(`${JSON.stringify(describeNoRequest(output), null, 2)}\n`);
+        return;
+    }
     const sink = getRowSink(data);
     if (sink && !sink.opened)
         data.list = sink.takeBuffer();
     const streamed = sink?.opened ? sink : undefined;
-    const columns = data && typeof data === "object" && Array.isArray(data.fieldList)
+    const columns = selectedColumns ?? (data && typeof data === "object" && Array.isArray(data.fieldList)
         ? data.fieldList
-        : undefined;
-    const normalized = normalizeRows(data);
+        : undefined);
+    const whole = normalizeRows(data);
+    const wholeItems = pickList(whole);
+    const normalized = projectColumns(whole);
     const items = pickList(normalized);
     const showing = streamed ? streamed.rows : (items?.length ?? 0);
     if (cache) {
-        const titles = { ...(streamed?.titles ?? {}), ...(items ? extractTitles(items, cache) : {}) };
+        const titles = { ...(streamed?.titles ?? {}), ...(wholeItems ? extractTitles(wholeItems, cache) : {}) };
         if (Object.keys(titles).length > 0) {
             writeTitleCache(cache.endpointKey, titles).catch(() => { });
         }
@@ -123,13 +155,13 @@ export async function printData(data, format, output, cache) {
         if (typeof meta.total === "number" && format !== "json") {
             process.stderr.write(`Total: ${meta.total}, showing: ${showing}\n`);
         }
-        if (meta.partial === true)
-            markIncomplete();
     }
+    if (whole && typeof whole === "object" && !Array.isArray(whole) && whole.partial === true)
+        markIncomplete();
     const complete = decidedExitCode() === 0;
     if (output) {
         const staged = format === "csv" || format === "jsonl"
-            ? await stageExportMeta(output, format, streamed ? streamed.dataRows : countOutputRows(normalized, format), columns, normalized, complete)
+            ? await stageExportMeta(output, format, streamed ? streamed.dataRows : countOutputRows(normalized, format), columns, whole, complete)
             : null;
         let digest;
         try {

package/dist/src/core/statePaths.js

@@ -0,0 +1,41 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { DEFAULT_TOKEN_CACHE_PATH, loadConfig } from "./config.js";
+import { ValidationError } from "./errors.js";
+const identity = async (target) => {
+    const stat = await fs.stat(target).catch(() => undefined);
+    return stat ? `${stat.dev}:${stat.ino}` : undefined;
+};
+async function physical(target) {
+    const rest = [];
+    let head = path.isAbsolute(target) ? target : `${process.cwd()}${path.sep}${target}`;
+    for (;;) {
+        const real = await fs.realpath(head).catch(() => undefined);
+        if (real)
+            return path.join(real, ...rest);
+        const parent = path.dirname(head);
+        if (parent === head)
+            return path.resolve(target);
+        rest.unshift(path.basename(head));
+        head = parent;
+    }
+}
+export async function assertNotStatePath(target, option) {
+    const stateDir = path.dirname(DEFAULT_TOKEN_CACHE_PATH);
+    const tokenCache = loadConfig().tokenCachePath;
+    const guarded = new Set((await Promise.all([stateDir, tokenCache].map(identity))).filter((id) => id !== undefined));
+    const resolved = await physical(target);
+    let refused = resolved === await physical(tokenCache);
+    for (let current = resolved; !refused;) {
+        const id = await identity(current);
+        if (id && guarded.has(id))
+            refused = true;
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    if (refused) {
+        throw new ValidationError(`${option} ${target} points at gangtise's own state (${stateDir}, or the token cache ${tokenCache}), which holds the access token: refused. Pass a path outside it.`);
+    }
+}

package/dist/src/core/transport.js

@@ -34,6 +34,13 @@ function retryAfterFromError(error) {
     return undefined;
 }
 let cachedDispatcher = null;
+let requestSent = false;
+export function noteRequestSent() {
+    requestSent = true;
+}
+export function anyRequestSent() {
+    return requestSent;
+}
 const requireLazily = createRequire(import.meta.url);
 export function getDispatcher() {
     if (!cachedDispatcher) {