gitsheets-axi 2.0.0 → 2.2.0

package/dist/src/commands/query.js

@@ -1,23 +1,37 @@
 import { AxiError } from 'axi-sdk-js';
 import { translateError } from '../errors.js';
-import { renderListResponse } from '../output/render.js';
+import { joinBlocks, renderHelp, renderListResponse, renderObject, } from '../output/render.js';
 import { field } from '../output/schema.js';
 import { defaultSheetSchema, fieldsWithExtras, } from '../output/sheet-schema.js';
-export const QUERY_HELP = `usage: gitsheets-axi query <sheet> [--filter k=v ...] [--fields a,b,c] [--limit n]
-flags[4]:
-  --filter <k>=<v>     Equality match against record field (repeatable)
+import { openSheetForCommand } from '../util/open-sheet.js';
+import { exportRecords } from '../util/export-file.js';
+import { buildPredicate } from '../util/filter.js';
+import { facetCounts, sortRecords } from '../util/aggregate.js';
+export const QUERY_HELP = `usage: gitsheets-axi query <sheet> [--filter expr ...] [--fields a,b] [--sort f [--desc]] [--limit n] [--group-by f] [--json-out[=path]] [--ndjson-out[=path]] [--csv-out[=path]]
+flags[9]:
+  --filter <expr>      Filter clause (repeatable): k=v · k!=v · k<v · k>v ·
+                       k<=v · k>=v · k~regex · "k in (a,b)" · k:present · k:empty
   --fields <list>      Extra columns beyond the default schema (comma-separated)
-  --limit <n>          Cap results (default: 100, max: 10000)
-  --prefix <p>         Tenant sub-tree scope (see gitsheets --prefix)
+  --sort <field>       Sort records by a field (missing values sort last)
+  --desc               Sort descending (with --sort)
+  --limit <n>          Cap the stdout preview (default: 100, max: 10000)
+  --group-by <field>   Faceted counts by a field instead of a record list
+  --prefix <p>         Tenant sub-tree scope
+  --json-out[=path]    Also write the FULL matched result to a JSON array file
+  --ndjson-out[=path]  Also write the FULL matched result to an NDJSON file
+  --csv-out[=path]     Also write the FULL matched result to a CSV file (flat)
 examples:
-  gitsheets-axi query users
-  gitsheets-axi query users --filter status=active --limit 50
-  gitsheets-axi query posts --fields title,published
+  gitsheets-axi query repos --filter status=unclassified
+  gitsheets-axi query repos --filter 'pushed_at<2022-01-01' --sort pushed_at
+  gitsheets-axi query repos --group-by target_team
+  gitsheets-axi query repos --filter 'target_team in (archive,sencha)' --ndjson-out
 output:
-  Default schema is format-aware:
-    TOML sheets    — path-template fields + first scalar properties (cap 4)
-    Markdown/MDX   — path-template fields + title + body_size (never body content)
-  --fields appends additional columns.
+  Default schema is format-aware (TOML: path fields + first scalars, cap 4;
+  Markdown: path fields + title + body_size). --fields appends columns.
+  --group-by emits {value,count} facets (biggest first) over the filtered set.
+export (--json-out / --ndjson-out / --csv-out):
+  stdout stays the TOON preview; the file carries EVERY matched record (ignores
+  --limit). JSON/NDJSON verbatim (round-trip into upsert); CSV flat + lossy.
 `;
 function parseQueryFlags(args) {
     const sheetName = args[0];
@@ -31,38 +45,84 @@ function parseQueryFlags(args) {
         extras: [],
         limit: 100,
         prefix: undefined,
+        sort: undefined,
+        desc: false,
+        groupBy: undefined,
+        exportFormat: undefined,
+        exportPath: undefined,
+    };
+    const setExport = (format, arg) => {
+        if (flags.exportFormat) {
+            throw new AxiError('Only one export flag is allowed per invocation', 'VALIDATION_ERROR', [
+                'Pass one of --json-out / --ndjson-out / --csv-out',
+            ]);
+        }
+        flags.exportFormat = format;
+        const eq = arg.indexOf('=');
+        if (eq !== -1) {
+            const p = arg.slice(eq + 1);
+            if (!p) {
+                throw new AxiError(`${arg.slice(0, eq)} was given an empty path`, 'VALIDATION_ERROR', [
+                    'Use the bare flag for an auto temp path, or --…-out=/real/path',
+                ]);
+            }
+            flags.exportPath = p;
+        }
     };
     for (let i = 1; i < args.length; i++) {
         const arg = args[i];
+        if (arg === undefined)
+            continue;
+        if (arg === '--json-out' || arg.startsWith('--json-out=')) {
+            setExport('json', arg);
+            continue;
+        }
+        if (arg === '--ndjson-out' || arg.startsWith('--ndjson-out=')) {
+            setExport('ndjson', arg);
+            continue;
+        }
+        if (arg === '--csv-out' || arg.startsWith('--csv-out=')) {
+            setExport('csv', arg);
+            continue;
+        }
         const next = args[i + 1];
         switch (arg) {
-            case '--filter': {
-                if (!next || !next.includes('=')) {
-                    throw new AxiError('--filter expects key=value', 'VALIDATION_ERROR', ['Example: --filter status=active']);
-                }
-                const eq = next.indexOf('=');
-                flags.filters.push([next.slice(0, eq), next.slice(eq + 1)]);
+            case '--filter':
+                if (!next)
+                    throw new AxiError('--filter expects an expression', 'VALIDATION_ERROR');
+                flags.filters.push(next);
                 i++;
                 break;
-            }
             case '--fields':
-                if (!next) {
+                if (!next)
                     throw new AxiError('--fields expects a comma-separated list', 'VALIDATION_ERROR');
-                }
                 flags.extras = next.split(',').map((s) => s.trim()).filter(Boolean);
                 i++;
                 break;
+            case '--sort':
+                if (!next)
+                    throw new AxiError('--sort expects a field name', 'VALIDATION_ERROR');
+                flags.sort = next;
+                i++;
+                break;
+            case '--desc':
+                flags.desc = true;
+                break;
+            case '--group-by':
+                if (!next)
+                    throw new AxiError('--group-by expects a field name', 'VALIDATION_ERROR');
+                flags.groupBy = next;
+                i++;
+                break;
             case '--limit':
-                if (!next) {
+                if (!next)
                     throw new AxiError('--limit expects an integer', 'VALIDATION_ERROR');
-                }
                 flags.limit = Math.min(10_000, Math.max(1, parseInt(next, 10) || 100));
                 i++;
                 break;
             case '--prefix':
-                if (!next) {
+                if (!next)
                     throw new AxiError('--prefix expects a path', 'VALIDATION_ERROR');
-                }
                 flags.prefix = next;
                 i++;
                 break;
@@ -80,62 +140,73 @@ export async function queryCommand(args, ctx) {
     }
     const { sheetName, flags } = parseQueryFlags(args);
     const repo = await ctx.repo();
-    let sheet;
-    try {
-        sheet = await repo.openSheet(sheetName, flags.prefix !== undefined ? { prefix: flags.prefix } : {});
-    }
-    catch (error) {
-        throw translateError(error);
-    }
+    const sheet = await openSheetForCommand(repo, sheetName, flags.prefix !== undefined ? { prefix: flags.prefix } : {});
     const config = await sheet.readConfig();
-    const filter = {};
-    for (const [k, v] of flags.filters) {
-        filter[k] = v;
-    }
-    // Load bodies for content-typed sheets so the body_size column renders
-    // correctly. We never put body content itself into the default schema —
-    // per AXI's "long-form content belongs in detail views, not lists" — but
-    // the size is the cheap, agent-actionable summary.
     const withBody = config.format.body !== undefined;
-    let records;
+    let all;
     try {
-        records = await sheet.queryAll(filter, { withBody });
+        all = await sheet.queryAll({}, { withBody });
     }
     catch (error) {
         throw translateError(error);
     }
-    const total = records.length;
-    const limited = records.slice(0, flags.limit);
+    const predicate = buildPredicate(flags.filters);
+    const matched = all.filter(predicate);
+    // --group-by: faceted counts over the filtered set (not capped by --limit).
+    if (flags.groupBy) {
+        const facets = facetCounts(matched, flags.groupBy);
+        const groupBlock = renderListResponse({
+            summary: { groups: `${facets.length} distinct ${flags.groupBy}`, matched: matched.length },
+            name: 'groups',
+            items: facets,
+            schema: [field('value'), field('count')],
+            emptyMessage: `no records match in ${sheetName}`,
+        });
+        return maybeExport(groupBlock, matched, flags, sheetName);
+    }
+    const ordered = flags.sort ? sortRecords(matched, flags.sort, flags.desc) : matched;
+    const limited = ordered.slice(0, flags.limit);
     const baseSchema = defaultSheetSchema(config);
     const schema = fieldsWithExtras(baseSchema, flags.extras);
     const suggestions = [];
     if (limited.length === 0 && flags.filters.length > 0) {
-        suggestions.push('No records match the filter — try `gitsheets-axi query ' +
-            sheetName +
-            '` without filters');
+        suggestions.push(`No records match the filter — try \`gitsheets-axi query ${sheetName}\` without filters`);
     }
     else if (limited.length > 0) {
         suggestions.push(`Run \`gitsheets-axi read ${sheetName} <path>\` to view a single record`);
-        if (config.format.body) {
-            suggestions.push(`Add \`--full\` on \`read\` to see untruncated body content`);
-        }
+        if (config.format.body)
+            suggestions.push('Add `--full` on `read` to see untruncated body content');
     }
-    if (total > limited.length) {
-        suggestions.push(`${total - limited.length} records hidden by --limit ${flags.limit}; raise --limit to see more`);
+    if (matched.length > limited.length && !flags.exportFormat) {
+        suggestions.push(`${matched.length - limited.length} records hidden by --limit ${flags.limit}; raise --limit or use --json-out to capture all`);
     }
-    return renderListResponse({
-        summary: { count: `${limited.length} of ${total} total` },
+    const listResponse = renderListResponse({
+        summary: { count: `${limited.length} of ${matched.length} total` },
         name: 'records',
         items: limited.map((r) => ({
             ...r,
-            // Surface the record's source path as a top-level "path" so default
-            // schemas that include it work without callers needing to know the
-            // RECORD_PATH_KEY symbol.
             path: r[Symbol.for('gitsheets-path')] ?? '',
         })),
         schema: [...schema, field('path')],
         suggestions,
         emptyMessage: `no records in ${sheetName}`,
     });
+    return maybeExport(listResponse, ordered, flags, sheetName);
+}
+/**
+ * Append the side-channel export block when an export flag was passed. The file
+ * carries the full matched (and, for the record path, sorted) set, verbatim.
+ */
+function maybeExport(stdoutBlock, records, flags, sheetName) {
+    if (!flags.exportFormat)
+        return stdoutBlock;
+    const exp = exportRecords(records, flags.exportFormat, flags.exportPath, sheetName);
+    const firstCol = exp.columns[0] ?? '';
+    const hint = flags.exportFormat === 'csv'
+        ? `Run \`column -s, -t ${exp.path} | less -S\` to inspect all ${exp.rows} rows`
+        : flags.exportFormat === 'ndjson'
+            ? `Run \`jq '.${firstCol}' ${exp.path}\` to process all ${exp.rows} rows`
+            : `Run \`jq '.[] | .${firstCol}' ${exp.path}\` to process all ${exp.rows} rows`;
+    return joinBlocks(stdoutBlock, renderObject({ wrote: exp.path, rows: exp.rows, cols: exp.cols }), renderObject({ columns: exp.columns }), renderHelp([hint]));
 }
 //# sourceMappingURL=query.js.map

package/dist/src/commands/query.js.map

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

package/dist/src/commands/rename.d.ts

@@ -0,0 +1,4 @@
+import type { GitsheetsContext } from '../context.js';
+export declare const RENAME_HELP = "usage: gitsheets-axi rename <sheet> <old-path> <new-path> [--prefix p] [--message m]\nflags[2]:\n  --prefix <p>         Tenant sub-tree scope\n  --message <m>        Commit message (default: \"<sheet> rename <old> -> <new>\")\nexamples:\n  gitsheets-axi rename teams kevin-clough kingofthepark\n  gitsheets-axi rename repos old-name new-name --message \"slug rename\"\nnote:\n  Reads the record at <old-path>, re-keys it to <new-path>, and deletes the old\n  one \u2014 atomically in ONE commit. Supported for a bare single-field path\n  template; for decorated or multi-field templates, use `patch` to change the\n  path fields, or `upsert --delete-missing`.\n";
+export declare function renameCommand(args: string[], ctx: GitsheetsContext): Promise<string>;
+//# sourceMappingURL=rename.d.ts.map

package/dist/src/commands/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../src/commands/rename.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMtD,eAAO,MAAM,WAAW,0pBAYvB,CAAC;AAqDF,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CA6DjB"}

package/dist/src/commands/rename.js

@@ -0,0 +1,131 @@
+import { AxiError } from 'axi-sdk-js';
+import { Template } from 'gitsheets';
+import { translateError } from '../errors.js';
+import { joinBlocks, renderHelp, renderObject } from '../output/render.js';
+import { openSheetForCommand } from '../util/open-sheet.js';
+import { MATERIALIZE_HINT } from '../util/hints.js';
+export const RENAME_HELP = `usage: gitsheets-axi rename <sheet> <old-path> <new-path> [--prefix p] [--message m]
+flags[2]:
+  --prefix <p>         Tenant sub-tree scope
+  --message <m>        Commit message (default: "<sheet> rename <old> -> <new>")
+examples:
+  gitsheets-axi rename teams kevin-clough kingofthepark
+  gitsheets-axi rename repos old-name new-name --message "slug rename"
+note:
+  Reads the record at <old-path>, re-keys it to <new-path>, and deletes the old
+  one — atomically in ONE commit. Supported for a bare single-field path
+  template; for decorated or multi-field templates, use \`patch\` to change the
+  path fields, or \`upsert --delete-missing\`.
+`;
+function parseRenameFlags(args) {
+    const flags = { sheet: '', oldPath: '', newPath: '', prefix: undefined, message: undefined };
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        const next = args[i + 1];
+        switch (arg) {
+            case '--prefix':
+                if (!next)
+                    throw new AxiError('--prefix expects a path', 'VALIDATION_ERROR');
+                flags.prefix = next;
+                i++;
+                break;
+            case '--message':
+                if (!next)
+                    throw new AxiError('--message expects a string', 'VALIDATION_ERROR');
+                flags.message = next;
+                i++;
+                break;
+            default:
+                if (arg.startsWith('-')) {
+                    throw new AxiError(`Unknown flag: ${arg}`, 'VALIDATION_ERROR', [
+                        'Run `gitsheets-axi rename --help`',
+                    ]);
+                }
+                positional.push(arg);
+        }
+    }
+    if (positional.length !== 3) {
+        throw new AxiError('rename requires <sheet> <old-path> <new-path>', 'VALIDATION_ERROR', [
+            'Example: gitsheets-axi rename teams kevin-clough kingofthepark',
+        ]);
+    }
+    flags.sheet = positional[0];
+    flags.oldPath = stripExtension(positional[1]);
+    flags.newPath = stripExtension(positional[2]);
+    return flags;
+}
+// A bare single-field template: the whole path is one field reference
+// (`${{ field }}` or `${ field }`) with no literal decoration, so <new-path>
+// maps directly onto the field's value.
+const BARE_TEMPLATE = /^\$\{\{?\s*[A-Za-z_$][\w$]*\s*\}?\}$/;
+export async function renameCommand(args, ctx) {
+    if (args.length === 0 || (args.length === 1 && args[0] === '--help')) {
+        return RENAME_HELP;
+    }
+    const flags = parseRenameFlags(args);
+    const prefixOpts = flags.prefix !== undefined ? { prefix: flags.prefix } : {};
+    const repo = await ctx.repo();
+    const sheet = await openSheetForCommand(repo, flags.sheet, prefixOpts);
+    const config = await sheet.readConfig();
+    const template = Template.fromString(config.path);
+    const fields = template.getFieldNames();
+    if (fields.length !== 1 || template.componentCount !== 1 || !BARE_TEMPLATE.test(config.path.trim())) {
+        throw new AxiError(`rename supports a bare single-field path template; '${config.path}' is not one`, 'VALIDATION_ERROR', ['Use `patch` to change the path fields, or `upsert --delete-missing` to re-key.']);
+    }
+    const field = fields[0];
+    let existing;
+    try {
+        existing = await sheet.queryFirst({ [field]: flags.oldPath });
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    if (!existing) {
+        throw new AxiError(`${flags.sheet}: no record at ${flags.oldPath}`, 'NOT_FOUND');
+    }
+    const collision = await sheet.queryFirst({ [field]: flags.newPath });
+    if (collision) {
+        throw new AxiError(`${flags.sheet}: ${flags.newPath} already exists — refusing to overwrite`, 'VALIDATION_ERROR', [
+            `Delete or rename the existing ${flags.newPath} first`,
+        ]);
+    }
+    const renamed = { ...stripSymbols(existing), [field]: flags.newPath };
+    const commitMessage = flags.message ?? `${flags.sheet} rename ${flags.oldPath} -> ${flags.newPath}`;
+    try {
+        const result = await repo.transact({ message: commitMessage }, async (tx) => {
+            const txSheet = tx.sheet(flags.sheet, prefixOpts);
+            await txSheet.upsert(renamed);
+            await txSheet.delete(flags.oldPath);
+        });
+        return joinBlocks(renderObject({
+            result: 'renamed',
+            sheet: flags.sheet,
+            from: flags.oldPath,
+            to: flags.newPath,
+            commit: result.commitHash,
+        }), renderHelp([MATERIALIZE_HINT]));
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+}
+function stripSymbols(record) {
+    const out = {};
+    if (record && typeof record === 'object') {
+        for (const key of Object.keys(record)) {
+            out[key] = record[key];
+        }
+    }
+    return out;
+}
+function stripExtension(path) {
+    if (path.endsWith('.toml'))
+        return path.slice(0, -5);
+    if (path.endsWith('.md'))
+        return path.slice(0, -3);
+    return path;
+}
+//# sourceMappingURL=rename.js.map

package/dist/src/commands/rename.js.map

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

package/dist/src/commands/sheets.js

@@ -1,7 +1,7 @@
 import { AxiError } from 'axi-sdk-js';
 import { translateError } from '../errors.js';
 import { renderListResponse, renderObject } from '../output/render.js';
-import { computed, display, field } from '../output/schema.js';
+import { display, field } from '../output/schema.js';
 import { countRecords } from '../output/sheet-schema.js';
 import { Template } from 'gitsheets';
 export const SHEETS_HELP = `usage: gitsheets-axi sheets [<subcommand>] [flags]
@@ -65,7 +65,7 @@ async function sheetsList(ctx) {
         schema: [
             field('name'),
             display('format'),
-            computed('records', (item) => `${item['records']}`),
+            field('records'),
             field('root'),
         ],
         suggestions: help,
@@ -112,7 +112,10 @@ async function sheetsView(args, ctx) {
         output['sheet']['body_field'] = config.format.body;
     }
     if (schemaProps.length > 0) {
-        output['schema'] = renderSchemaProperties(schemaProps);
+        const schemaObj = config.schema;
+        const requiredList = schemaObj?.['required'];
+        const required = new Set(Array.isArray(requiredList) ? requiredList : []);
+        output['schema'] = renderSchemaProperties(schemaProps, required);
     }
     output['help'] = [
         `Run \`gitsheets-axi query ${name}\` to list records`,
@@ -129,13 +132,19 @@ function schemaPropertyList(config) {
         return [];
     return Object.entries(props);
 }
-function renderSchemaProperties(props) {
-    // Flat name → "type [required]" map for token-efficient display.
+function renderSchemaProperties(props, required) {
+    // Flat name → "type [required] enum: a|b|c" map for token-efficient display.
+    // Surfacing the enum options lets an agent see allowed values before it
+    // writes, instead of learning them from a rejected upsert.
     const out = {};
     for (const [name, schema] of props) {
         const type = String(schema['type'] ?? 'any');
         const format = schema['format'] ? ` (${String(schema['format'])})` : '';
-        out[name] = `${type}${format}`;
+        const req = required.has(name) ? ' [required]' : '';
+        const enumVals = Array.isArray(schema['enum'])
+            ? ` enum: ${schema['enum'].map(String).join('|')}`
+            : '';
+        out[name] = `${type}${format}${req}${enumVals}`;
     }
     return out;
 }

package/dist/src/commands/sheets.js.map

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

package/dist/src/commands/upsert.d.ts

@@ -1,4 +1,12 @@
 import type { GitsheetsContext } from '../context.js';
-export declare const UPSERT_HELP = "usage: gitsheets-axi upsert <sheet> [--data <json>] [--allow-missing-body] [--prefix p] [--message m]\nflags[4]:\n  --data <json>        Record JSON inline. If omitted, reads stdin.\n  --allow-missing-body Content-typed sheets only \u2014 permit upsert without body field\n  --prefix <p>         Tenant sub-tree scope\n  --message <m>        Commit message (default: \"<sheet> upsert <path>\")\nexamples:\n  gitsheets-axi upsert users --data '{\"slug\":\"jane\",\"email\":\"jane@x.org\"}'\n  echo '{\"slug\":\"jane\",\"email\":\"jane@x.org\"}' | gitsheets-axi upsert users\nidempotency:\n  Compares the canonical bytes the upsert would write against the\n  existing blob at the rendered path. If identical, exits 0 with\n  result: \"no-op\" and no commit is produced.\n";
+export declare const UPSERT_HELP = "usage: gitsheets-axi upsert <sheet> [--data <json>] [--delete-missing] [--dry-run] [--allow-missing-body] [--prefix p] [--message m]\nflags[6]:\n  --data <json>        Record JSON inline. If omitted, reads stdin.\n  --delete-missing     After upserting, delete existing records NOT in the input\n                       set (make the sheet exactly match the batch). One commit.\n  --dry-run            Preview {will-change, no-op, invalid, delete} \u2014 no commit.\n  --allow-missing-body Content-typed sheets only \u2014 permit upsert without body field\n  --prefix <p>         Tenant sub-tree scope\n  --message <m>        Commit message (default: \"<sheet> upsert <path>\")\nbulk:\n  Input may be a single JSON object, a JSON array of objects, or NDJSON (one\n  compact object per line) \u2014 autodetected. A batch upserts in ONE commit.\nexamples:\n  echo '{\"slug\":\"jane\",\"email\":\"jane@x.org\"}' | gitsheets-axi upsert users\n  jq -c '.[]' repos.json | gitsheets-axi upsert repos                  # NDJSON, one commit\n  gitsheets-axi upsert repos --data \"$(cat repos.json)\" --delete-missing   # exact re-sync\n  gitsheets-axi upsert repos --data \"$(cat repos.json)\" --dry-run           # preview\nidempotency:\n  Unchanged records are skipped; a batch where nothing changed is a no-op with\n  no commit. A single invalid record aborts the batch (nothing committed) and\n  names the row \u2014 run --dry-run to see all invalid rows at once.\nnote:\n  gitsheets writes to the git ref, not your working tree. After a commit run\n  `git checkout HEAD -- .` to materialize the record files on disk.\n";
 export declare function upsertCommand(args: string[], ctx: GitsheetsContext): Promise<string>;
+export interface InvalidRow {
+    row: number;
+    id: string;
+    reason: string;
+    code: string;
+}
+/** Shared dry-run renderer: a `dry-run` summary of counts + an invalid-rows table. */
+export declare function renderDryRun(sheet: string, counts: Record<string, number>, invalid: InvalidRow[]): string;
 //# sourceMappingURL=upsert.d.ts.map

package/dist/src/commands/upsert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../../src/commands/upsert.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKtD,eAAO,MAAM,WAAW,swBAavB,CAAC;AA4DF,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CAqFjB"}
+{"version":3,"file":"upsert.d.ts","sourceRoot":"","sources":["../../../src/commands/upsert.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAWtD,eAAO,MAAM,WAAW,ilDAwBvB,CAAC;AAsEF,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CAoBjB;AA+CD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AA+FD,sFAAsF;AACtF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,UAAU,EAAE,GACpB,MAAM,CAYR"}