@lark-apaas/miaoda-cli 0.1.3 → 0.1.4

package/dist/cli/handlers/db/audit.js

@@ -0,0 +1,383 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDbAuditStatus = handleDbAuditStatus;
+exports.handleDbAuditEnable = handleDbAuditEnable;
+exports.handleDbAuditDisable = handleDbAuditDisable;
+exports.handleDbAuditList = handleDbAuditList;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const colors_1 = require("../../../utils/colors");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+const time_1 = require("../../../utils/time");
+const _operator_1 = require("../../../cli/handlers/db/_operator");
+const index_1 = require("../../../api/db/index");
+const VALID_RETENTION = new Set(['7d', '30d', '180d', '360d', 'forever']);
+async function handleDbAuditStatus(table, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const items = await api.db.getAuditStatus({ appId, table, dbBranch: opts.env });
+    const rows = items.map(toAuditStatus);
+    // 单表查询但后端没记录 → 占位 enabled=false
+    if (table !== undefined && table !== '' && rows.length === 0) {
+        rows.push({ table, enabled: false, enabled_at: null, retention: null });
+    }
+    // PRD JSON：单表返 object，多表返 array
+    if ((0, output_1.isJsonMode)()) {
+        if (table !== undefined && rows.length === 1) {
+            (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(rows[0]));
+        }
+        else {
+            (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(rows));
+        }
+        return;
+    }
+    if (rows.length === 0) {
+        (0, output_1.emit)('No audit configuration found.');
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // 单表 → key:value 形态
+    if (table !== undefined && rows.length === 1) {
+        const it = rows[0];
+        (0, output_1.emit)((0, render_1.renderKeyValue)([
+            ['Table', it.table],
+            ['Enabled', boolToYesNo(it.enabled)],
+            ['Enabled at', it.enabled_at ? (0, render_1.formatTime)(it.enabled_at, tty) : '—'],
+            ['Retention', it.retention ?? '—'],
+        ], tty));
+        return;
+    }
+    // 列表 → table 形态
+    const headers = ['table', 'enabled', 'enabled_at', 'retention'];
+    const out = rows.map((it) => [
+        it.table,
+        boolToYesNo(it.enabled),
+        it.enabled_at ? (0, render_1.formatTime)(it.enabled_at, tty) : '—',
+        it.retention ?? '—',
+    ]);
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, out) : (0, render_1.renderTsv)(headers, out));
+}
+function toAuditStatus(s) {
+    return {
+        table: s.table,
+        enabled: s.enabled,
+        enabled_at: s.enabledAt ?? null,
+        retention: s.retention ?? null,
+    };
+}
+async function handleDbAuditEnable(table, opts) {
+    if (!table) {
+        throw new error_1.AppError('ARGS_INVALID', 'table name is required', {
+            next_actions: [
+                'Usage: miaoda db audit enable <table> [--retention 7d|30d|180d|360d|forever]',
+            ],
+        });
+    }
+    const retention = opts.retention ?? '7d';
+    if (!VALID_RETENTION.has(retention)) {
+        throw new error_1.AppError('INVALID_RETENTION', `Invalid retention '${retention}'`, {
+            next_actions: ['Allowed values: 7d, 30d, 180d, 360d, forever.'],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    let status;
+    try {
+        status = await api.db.setAuditConfig({
+            appId,
+            table,
+            enabled: true,
+            retention,
+            dbBranch: opts.env,
+        });
+    }
+    catch (err) {
+        // PRD: 重复 enable 报错时附带 hint，引导用户去 status 看 retention 或换值更新
+        if (err instanceof error_1.AppError && err.code === 'DB_API_k_dl_1300030') {
+            throw new error_1.AppError(err.code, err.message, {
+                next_actions: [
+                    `Use \`miaoda db audit status ${table}\` to check current retention, or run this command with a different --retention to update.`,
+                ],
+            });
+        }
+        throw err;
+    }
+    // PRD JSON：{"data": {"table": "...", "enabled": true, "retention": "..."}}
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            table: status.table,
+            enabled: status.enabled,
+            retention: status.retention ?? retention,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // c.highlight 内部按 TTY/NO_COLOR/FORCE_COLOR 自动决定是否染色，无需再判 tty
+    const tableLabel = colors_1.c.highlight(`'${status.table}'`);
+    const body = `Audit enabled for table ${tableLabel} (retention: ${status.retention ?? retention})`;
+    (0, output_1.emit)(tty ? colors_1.c.success(`✓ ${body}`) : `OK ${body}`);
+}
+async function handleDbAuditDisable(table, opts) {
+    if (!table) {
+        throw new error_1.AppError('ARGS_INVALID', 'table name is required', {
+            next_actions: ['Usage: miaoda db audit disable <table>'],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    let status;
+    try {
+        status = await api.db.setAuditConfig({
+            appId,
+            table,
+            enabled: false,
+            dbBranch: opts.env,
+        });
+    }
+    catch (err) {
+        // PRD: 重复 disable / 未启用就 disable 报错时附带 hint，引导用户去看哪些表已开启
+        if (err instanceof error_1.AppError && err.code === 'DB_API_k_dl_1300031') {
+            throw new error_1.AppError(err.code, err.message, {
+                next_actions: ['Use `miaoda db audit status` to see which tables have audit enabled.'],
+            });
+        }
+        throw err;
+    }
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            table: status.table,
+            enabled: status.enabled,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const body = `Audit disabled for table ${colors_1.c.highlight(`'${status.table}'`)}`;
+    (0, output_1.emit)(tty ? colors_1.c.success(`✓ ${body}`) : `OK ${body}`);
+}
+async function handleDbAuditList(tables, opts) {
+    if (tables.length === 0) {
+        throw new error_1.AppError('ARGS_INVALID', 'at least one table is required', {
+            next_actions: [
+                'Usage: miaoda db audit list <table> [<table>...] [--since ...] [--until ...]',
+            ],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const limit = opts.limit ?? 20;
+    // 时间字段归一化为 ISO 8601 UTC（服务端按 event_time 字段比较）。cursor 由
+    // 后端管理（本质也是 ISO 时间），CLI 不再混用 cursor/since。
+    const since = normalizeTime(opts.since, '--since');
+    const until = normalizeTime(opts.until, '--until');
+    // 多表场景：dataloom 对"任一表不存在"是 fail-fast（typo 应立即可见，符合 PRD 单表语义），
+    // 但 PRD 多表语义是"其他表继续返回，底部汇总跳过情况"。CLI 在这里前置校验：用 getSchema
+    // 的 tableNames 过滤模式（dataloom 端内存过滤，不存在的表静默忽略，不报错）拿到存在的
+    // 表集合，本地 diff 出缺失表，再用过滤后的表去查 listAuditLog。单表场景跳过预校验。
+    const isMulti = tables.length > 1;
+    let queryTables = tables;
+    const localMissing = [];
+    if (isMulti) {
+        const schemaResp = await api.db.getSchema({
+            appId,
+            tableNames: tables.join(','),
+            dbBranch: opts.env,
+        });
+        const existing = new Set((0, index_1.flattenSchemaList)(schemaResp.schema).map((t) => t.name));
+        for (const t of tables) {
+            if (!existing.has(t))
+                localMissing.push(t);
+        }
+        queryTables = tables.filter((t) => existing.has(t));
+        if (queryTables.length === 0) {
+            throw new error_1.AppError('TABLE_NOT_FOUND', `None of the requested tables exist: ${localMissing.join(', ')}`, { next_actions: ['Run `miaoda db schema list` to see all tables.'] });
+        }
+    }
+    let result;
+    try {
+        result = await api.db.listAuditLog({
+            appId,
+            tables: queryTables,
+            since,
+            until,
+            limit,
+            cursor: opts.cursor,
+            dbBranch: opts.env,
+        });
+    }
+    catch (err) {
+        throw decorateAuditListError(err, tables);
+    }
+    const visible = result.items;
+    // 服务端 skipped（audit 未启用，bare 名）+ CLI 本地探测 missing 合并；
+    // localMissing 自带 `(table not found)` 后缀，formatSkippedHint 透传渲染
+    const skipped = [...result.skipped, ...localMissing.map((t) => `${t} (table not found)`)];
+    // PRD JSON：data 是数组，元素是事件对象（snake_case），分页信封 next_cursor / has_more
+    // operator 后端用 JSON 字符串内嵌 {id, name}，--json 输出还原成对象供下游消费
+    if ((0, output_1.isJsonMode)()) {
+        const items = visible.map((it) => ({
+            event_id: it.eventId,
+            event_time: it.eventTime,
+            target_table: it.targetTable,
+            type: it.type,
+            operator: (0, _operator_1.parseOperator)(it.operator),
+            summary: it.summary,
+            // before/after 服务端是 JSON 字符串，反序列化回结构化对象供下游消费
+            ...(it.before !== undefined ? { before: safeParseJson(it.before) } : {}),
+            ...(it.after !== undefined ? { after: safeParseJson(it.after) } : {}),
+        }));
+        (0, output_1.emitPaged)(items, result.nextCursor, result.hasMore);
+        if (skipped.length > 0) {
+            process.stderr.write(formatSkippedHint(skipped, tables.length) + '\n');
+        }
+        if (visible.length === 0)
+            process.exitCode = 1;
+        return;
+    }
+    if (visible.length === 0) {
+        (0, output_1.emit)('No audit events found.');
+        if (skipped.length > 0) {
+            process.stderr.write(formatSkippedHint(skipped, tables.length) + '\n');
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // PRD：多表渲染时第一列是 target_table，单表时去掉这一列
+    const isMultiTable = tables.length > 1;
+    const headers = isMultiTable
+        ? ['target_table', 'event_time', 'type', 'event_id', 'operator', 'summary']
+        : ['event_time', 'type', 'event_id', 'operator', 'summary'];
+    const rows = visible.map((it) => {
+        const eventTime = (0, render_1.formatTime)(it.eventTime, tty);
+        // event_id 完整透传——PRD 截图里的 "..." 只是文档省略写法，不是 CLI 行为
+        // operator pretty 只展示 name；--json 上面已经走 parseOperator 输出 {id, name}
+        const cells = [
+            eventTime,
+            it.type,
+            it.eventId,
+            (0, _operator_1.parseOperator)(it.operator).name || '—',
+            it.summary,
+        ];
+        return isMultiTable ? [it.targetTable, ...cells] : cells;
+    });
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
+    if (skipped.length > 0) {
+        process.stderr.write(formatSkippedHint(skipped, tables.length) + '\n');
+    }
+    if (result.hasMore && result.nextCursor) {
+        process.stderr.write(`(more results; use --cursor '${result.nextCursor}')\n`);
+    }
+}
+// ── helpers ──
+/**
+ * 把用户传入的 since/until 归一成 ISO 8601 UTC 字符串；空串返 undefined。
+ * 支持格式见 utils/time.ts::TIMESTAMP_HELP（相对时间 / 日期 / 本地 datetime / ISO 8601）。
+ */
+function normalizeTime(input, flagName) {
+    if (input === undefined || input === '')
+        return undefined;
+    try {
+        return new Date((0, time_1.parseTimeToMs)(input)).toISOString();
+    }
+    catch (err) {
+        if (err instanceof error_1.AppError) {
+            throw new error_1.AppError(err.code, `${flagName}: ${err.message}`, {
+                next_actions: err.next_actions,
+            });
+        }
+        throw err;
+    }
+}
+// PRD 41-48 行格式：`— Skipped 1 of 3 tables: orders (audit not enabled)`
+// 服务端 skipped 数组是 audit 未启用的表（bare 名）；上面 peel 循环拼出来的
+// "<name> (table not found)" 已经自带 reason，t.includes('(') 走原样透传，bare 名
+// 默认拼 "(audit not enabled)"。也兼容未来后端直接给带 reason 字符串的可能。
+function formatSkippedHint(skipped, totalRequested) {
+    const items = skipped.map((t) => (t.includes('(') ? t : `${t} (audit not enabled)`)).join(', ');
+    return `— Skipped ${String(skipped.length)} of ${String(totalRequested)} tables: ${items}`;
+}
+// audit list 后端错误码加 hint：
+//   - k_dl_000005  表不存在 → 文案与 hint 对齐 `db schema get` 的统一格式
+//   - k_dl_1300040 单表 audit 未启用 → 指引 enable
+//   - k_dl_1300041 多表全部未启用 → 指引 status
+function decorateAuditListError(err, tables) {
+    if (!(err instanceof error_1.AppError))
+        return err;
+    if (err.code === 'DB_API_k_dl_000005') {
+        // 不复用 dataloom 透传的 message（旧版/新版文案不一致：`table [x] not exist` /
+        // `table x not found`），统一改写成跟 schema get 一样的 `Table '<name>' does not exist`，
+        // 单表传 tables[0]，多表场景兜底用解析到的 raw message 里第一个表名。
+        const t = tables.length > 0 ? tables[0] : (extractMissingTable(err.message) ?? '<table>');
+        return new error_1.AppError('TABLE_NOT_FOUND', `Table '${t}' does not exist`, {
+            next_actions: [`Did you mean another table? Run "miaoda db schema list" to see all tables.`],
+        });
+    }
+    if (err.code === 'DB_API_k_dl_1300040') {
+        const t = tables[0] ?? '<table>';
+        return new error_1.AppError(err.code, err.message, {
+            next_actions: [`Enable with: miaoda db audit enable ${t}`],
+        });
+    }
+    if (err.code === 'DB_API_k_dl_1300041') {
+        return new error_1.AppError(err.code, err.message, {
+            next_actions: ['Check audit status with: miaoda db audit status'],
+        });
+    }
+    return err;
+}
+// extractMissingTable 从 dataloom 原始文案里抠表名兜底。dataloom 端有两种格式：
+//   - 旧版：`Table [foo] doesn't exist` / `table [foo] not exist`
+//   - 新版（本次 commits）：`table foo not found`
+// 都失配时返 null，调用方走 `<table>` 占位。
+function extractMissingTable(msg) {
+    const bracket = /\[([^\]]+)\]/.exec(msg);
+    if (bracket)
+        return bracket[1];
+    const m = /table\s+([\w.]+)\s+not (?:exist|found)/i.exec(msg);
+    return m ? m[1] : null;
+}
+// 服务端 before/after 是 JSON 字符串透传，CLI JSON 输出再反序列化回对象，
+// 给下游 jq 等工具消费。失败时透传原始字符串避免数据丢失。
+function safeParseJson(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return s;
+    }
+}
+// PRD 输出 enabled 列用 yes/no 而非 true/false
+function boolToYesNo(b) {
+    return b ? 'yes' : 'no';
+}

package/dist/cli/handlers/db/changelog.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDbChangelog = handleDbChangelog;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+const time_1 = require("../../../utils/time");
+const _operator_1 = require("../../../cli/handlers/db/_operator");
+function toRow(it) {
+    return {
+        change_id: it.changeId,
+        changed_at: it.changedAt,
+        operator: (0, _operator_1.parseOperator)(it.operator),
+        target_table: it.targetTable,
+        change_type: it.changeType,
+        summary: it.summary,
+        statement: it.statement,
+    };
+}
+/**
+ * 把用户传入的 since/until 归一成 ISO 8601 UTC 字符串；空串返 undefined。
+ * 支持格式见 utils/time.ts::TIMESTAMP_HELP（相对时间 / 日期 / 本地 datetime / ISO 8601）。
+ */
+function normalizeTime(input, flagName) {
+    if (input === undefined || input === '')
+        return undefined;
+    try {
+        return new Date((0, time_1.parseTimeToMs)(input)).toISOString();
+    }
+    catch (err) {
+        if (err instanceof error_1.AppError) {
+            throw new error_1.AppError(err.code, `${flagName}: ${err.message}`, {
+                next_actions: err.next_actions,
+            });
+        }
+        throw err;
+    }
+}
+async function handleDbChangelog(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const since = normalizeTime(opts.since, '--since');
+    const until = normalizeTime(opts.until, '--until');
+    // --change-id 是精确单条查询，CLI 透传给后端；后端若暂未支持过滤，CLI 端
+    // 兜底翻页找命中项，保证 PRD 「最多返回一条」的语义稳定。
+    const trimmed = opts.changeId?.trim();
+    const changeId = trimmed !== undefined && trimmed !== '' ? trimmed : undefined;
+    const allItems = [];
+    let cursor = opts.cursor;
+    let lastCursor = null;
+    let lastHasMore = false;
+    // 指定 --change-id 时强制开 --all，确保即使后端不识别 changeId 过滤参数，
+    // CLI 也能翻完所有页找到目标记录（changelog 默认按时间倒序，一般在前几页）。
+    const allMode = opts.all === true || changeId !== undefined;
+    // --all：循环到 hasMore=false；否则只拉一页
+    // 没传 --all 时翻页由调用方自己用 --cursor 串
+    for (;;) {
+        const page = await api.db.listDDLChangelog({
+            appId,
+            table: opts.table,
+            since,
+            until,
+            changeId,
+            limit: opts.limit,
+            cursor,
+            dbBranch: opts.env,
+        });
+        allItems.push(...page.items);
+        lastCursor = page.nextCursor;
+        lastHasMore = page.hasMore;
+        if (!allMode || !page.hasMore || !page.nextCursor)
+            break;
+        cursor = page.nextCursor;
+        // 后端命中过滤返单条时提前退出，免得继续无意义翻页
+        if (changeId !== undefined && allItems.some((it) => it.changeId === changeId))
+            break;
+    }
+    // CLI 端兜底过滤：把 changeId 匹配的项筛出来。后端如果已支持，列表本身就只有
+    // 0 或 1 条，filter 是恒等运算；后端未支持时通过翻页 + 此过滤拿到精确单条。
+    if (changeId !== undefined) {
+        const matched = allItems.filter((it) => it.changeId === changeId);
+        allItems.length = 0;
+        allItems.push(...matched);
+        // 精确查询语义：永远当作"已取完"，不再透出分页 cursor / has_more
+        lastCursor = null;
+        lastHasMore = false;
+    }
+    if ((0, output_1.isJsonMode)()) {
+        const rows = allItems.map(toRow);
+        // --all 或 --change-id 时已经把所有页合一起返，has_more=false / next_cursor=null。
+        // PRD: --change-id 即使没命中（rows 长度 0）也保持 data 为数组。
+        if (allMode) {
+            (0, output_1.emitPaged)((0, output_1.snakeCaseKeys)(rows), null, false);
+        }
+        else {
+            (0, output_1.emitPaged)((0, output_1.snakeCaseKeys)(rows), lastCursor, lastHasMore);
+        }
+        return;
+    }
+    if (allItems.length === 0) {
+        // --change-id 没命中时单独报错，便于 agent 区分"无变更"和"ID 不存在"
+        if (changeId !== undefined) {
+            (0, output_1.emit)(`No DDL change with id=${changeId} found.`);
+        }
+        else {
+            (0, output_1.emit)('No DDL changes found.');
+        }
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // PRD: change_id / changed_at / operator / target_table / change_type / summary
+    const headers = ['change_id', 'changed_at', 'operator', 'target_table', 'change_type', 'summary'];
+    // pretty 渲染只展示 operator.name（兼容 PRD 原 string 形态）；--json 走 toRow 输出完整对象
+    const rows = allItems.map((it) => [
+        it.changeId,
+        (0, render_1.formatTime)(it.changedAt, tty),
+        (0, _operator_1.parseOperator)(it.operator).name || '—',
+        it.targetTable || '—',
+        it.changeType,
+        it.summary || '—',
+    ]);
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
+    if (!allMode && lastHasMore && lastCursor) {
+        process.stderr.write(`(more results; use --cursor ${lastCursor} or --all)\n`);
+    }
+}