gitsheets-axi 0.0.1

package/dist/src/commands/attachment.js

@@ -0,0 +1,356 @@
+import { isAbsolute, join } from 'node:path';
+import { readFile, stat } from 'node:fs/promises';
+import { AxiError } from 'axi-sdk-js';
+import { NotFoundError } from 'gitsheets';
+import { translateError } from '../errors.js';
+import { renderListResponse, renderObject } from '../output/render.js';
+import { display, field } from '../output/schema.js';
+import { readStdin } from '../util/stdin.js';
+export const ATTACHMENT_HELP = `usage: gitsheets-axi attachment <subcommand> [args] [flags]
+subcommands[4]:
+  list <sheet> <path>                 List attachments on a record
+  get <sheet> <path> <name>           Get attachment metadata + base64 content
+  set <sheet> <path> <name> [--file f] [--data <text>]
+                                      Set an attachment (--file path, --data inline,
+                                      or piped on stdin)
+  delete <sheet> <path> [<name>]      Delete one attachment by name, or all if name omitted
+examples:
+  gitsheets-axi attachment list users jane
+  gitsheets-axi attachment get users jane avatar.jpg
+  gitsheets-axi attachment set users jane avatar.jpg --file ./pic.jpg
+  cat pic.jpg | gitsheets-axi attachment set users jane avatar.jpg
+  gitsheets-axi attachment delete users jane avatar.jpg
+  gitsheets-axi attachment delete users jane
+notes:
+  Binary content in \`get\` is base64-encoded. Use \`--full\` to opt into
+  larger payloads (default cap: 64KB).
+`;
+const GET_PREVIEW_LIMIT = 64 * 1024;
+export async function attachmentCommand(args, ctx) {
+    if (args.length === 0 || (args.length === 1 && args[0] === '--help')) {
+        return ATTACHMENT_HELP;
+    }
+    const sub = args[0];
+    const rest = args.slice(1);
+    switch (sub) {
+        case 'list':
+            return attachmentList(rest, ctx);
+        case 'get':
+            return attachmentGet(rest, ctx);
+        case 'set':
+            return attachmentSet(rest, ctx);
+        case 'delete':
+            return attachmentDelete(rest, ctx);
+        case '--help':
+            return ATTACHMENT_HELP;
+        default:
+            throw new AxiError(`Unknown subcommand: ${sub}`, 'VALIDATION_ERROR', [
+                'Subcommands: list, get, set, delete',
+            ]);
+    }
+}
+function parseAttachmentBase(args, requireName) {
+    const positional = [];
+    const rest = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        if (arg.startsWith('-')) {
+            rest.push(arg);
+            // Drag along the next token if it looks like a value
+            const next = args[i + 1];
+            if (next && !next.startsWith('-')) {
+                rest.push(next);
+                i++;
+            }
+            continue;
+        }
+        positional.push(arg);
+    }
+    if (positional.length < 2) {
+        throw new AxiError('attachment requires at least <sheet> <path>', 'VALIDATION_ERROR');
+    }
+    if (requireName && positional.length < 3) {
+        throw new AxiError('attachment requires <sheet> <path> <name>', 'VALIDATION_ERROR');
+    }
+    return {
+        sheet: positional[0],
+        path: positional[1],
+        name: positional[2],
+        rest,
+    };
+}
+async function openTargetSheet(ctx, sheetName, prefix) {
+    const repo = await ctx.repo();
+    try {
+        return await repo.openSheet(sheetName, prefix !== undefined ? { prefix } : {});
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+}
+function extractPrefix(rest) {
+    const i = rest.indexOf('--prefix');
+    if (i === -1)
+        return undefined;
+    const next = rest[i + 1];
+    if (!next) {
+        throw new AxiError('--prefix expects a path', 'VALIDATION_ERROR');
+    }
+    return next;
+}
+async function attachmentList(args, ctx) {
+    const { sheet: sheetName, path, rest } = parseAttachmentBase(args, false);
+    const prefix = extractPrefix(rest);
+    const sheet = await openTargetSheet(ctx, sheetName, prefix);
+    const items = [];
+    try {
+        for await (const attachment of sheet.attachments(path)) {
+            items.push({
+                name: attachment.name,
+                mime_type: attachment.mimeType,
+                hash: attachment.blob.hash,
+            });
+        }
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    return renderListResponse({
+        summary: { sheet: sheetName, record: path },
+        name: 'attachments',
+        items,
+        schema: [field('name'), display('mime_type'), field('hash')],
+        emptyMessage: 'no attachments on this record',
+        suggestions: items.length > 0
+            ? [
+                `Run \`gitsheets-axi attachment get ${sheetName} ${path} <name>\` to inspect content`,
+            ]
+            : [
+                `Run \`gitsheets-axi attachment set ${sheetName} ${path} <name> --file <path>\` to add one`,
+            ],
+    });
+}
+async function attachmentGet(args, ctx) {
+    const { sheet: sheetName, path, name, rest } = parseAttachmentBase(args, true);
+    const prefix = extractPrefix(rest);
+    const full = rest.includes('--full');
+    const sheet = await openTargetSheet(ctx, sheetName, prefix);
+    let attachmentBlob;
+    try {
+        attachmentBlob = await sheet.getAttachment(path, name);
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    if (!attachmentBlob) {
+        throw new AxiError(`${sheetName}: no attachment ${name} on record at ${path}`, 'NOT_FOUND');
+    }
+    let buffer;
+    try {
+        const raw = await attachmentBlob.read();
+        buffer = typeof raw === 'string' ? Buffer.from(raw, 'utf-8') : Buffer.from(raw);
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    const size = buffer.length;
+    const cap = full ? Number.POSITIVE_INFINITY : GET_PREVIEW_LIMIT;
+    const truncated = size > cap;
+    const slice = truncated ? buffer.subarray(0, GET_PREVIEW_LIMIT) : buffer;
+    const output = {
+        attachment: {
+            sheet: sheetName,
+            record: path,
+            name,
+            hash: attachmentBlob.hash,
+            size,
+            base64: slice.toString('base64'),
+        },
+    };
+    if (truncated) {
+        output['attachment']['truncated'] = true;
+        output['help'] = [
+            `Run \`gitsheets-axi attachment get ${sheetName} ${path} ${name} --full\` to fetch all ${size} bytes`,
+        ];
+    }
+    return renderObject(output);
+}
+async function attachmentSet(args, ctx) {
+    const { sheet: sheetName, path, name, rest } = parseAttachmentBase(args, true);
+    const prefix = extractPrefix(rest);
+    const fileIdx = rest.indexOf('--file');
+    const dataIdx = rest.indexOf('--data');
+    const messageIdx = rest.indexOf('--message');
+    const fileArg = fileIdx >= 0 ? rest[fileIdx + 1] : undefined;
+    const dataArg = dataIdx >= 0 ? rest[dataIdx + 1] : undefined;
+    const message = messageIdx >= 0 ? rest[messageIdx + 1] : undefined;
+    // Acquire the content bytes.
+    let content;
+    if (fileArg) {
+        const absPath = isAbsolute(fileArg) ? fileArg : join(process.cwd(), fileArg);
+        try {
+            const buf = await readFile(absPath);
+            content = buf.toString('binary');
+        }
+        catch (err) {
+            throw new AxiError(`attachment set: cannot read ${fileArg}: ${err instanceof Error ? err.message : String(err)}`, 'NOT_FOUND');
+        }
+    }
+    else if (dataArg) {
+        content = dataArg;
+    }
+    else {
+        content = await readStdin();
+        if (!content) {
+            throw new AxiError('attachment set needs content — pass --file <path>, --data <text>, or pipe on stdin', 'VALIDATION_ERROR');
+        }
+    }
+    const repo = await ctx.repo();
+    const sheet = await openTargetSheet(ctx, sheetName, prefix);
+    // Idempotency: check the existing attachment's content.
+    let existing;
+    try {
+        existing = await sheet.getAttachment(path, name);
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    if (existing) {
+        try {
+            const existingText = await existing.read();
+            const existingStr = typeof existingText === 'string'
+                ? existingText
+                : Buffer.from(existingText).toString('binary');
+            if (existingStr === content) {
+                return renderObject({
+                    result: 'no-op',
+                    sheet: sheetName,
+                    record: path,
+                    name,
+                    hash: existing.hash,
+                    reason: 'attachment bytes already match',
+                });
+            }
+        }
+        catch {
+            // Fall through and overwrite.
+        }
+    }
+    const commitMessage = message ?? `${sheetName} setAttachment ${name} on ${path}`;
+    let commitHash = '';
+    try {
+        const result = await repo.transact({ message: commitMessage }, async (tx) => {
+            const txSheet = tx.sheet(sheetName, prefix !== undefined ? { prefix } : {});
+            await txSheet.setAttachment(path, name, content);
+        });
+        commitHash = result.commitHash ?? '';
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    // Re-open the sheet to look up the new attachment hash — the `sheet`
+    // handle above is bound to the pre-commit tree.
+    let newHash = '';
+    try {
+        const fresh = await repo.openSheet(sheetName, prefix !== undefined ? { prefix } : {});
+        const created = await fresh.getAttachment(path, name);
+        newHash = created?.hash ?? '';
+    }
+    catch {
+        // not fatal — agent has the commit hash already
+    }
+    return renderObject({
+        result: existing ? 'overwritten' : 'created',
+        sheet: sheetName,
+        record: path,
+        name,
+        hash: newHash,
+        bytes: content.length,
+        commit: commitHash,
+    });
+}
+async function attachmentDelete(args, ctx) {
+    const { sheet: sheetName, path, name, rest } = parseAttachmentBase(args, false);
+    const prefix = extractPrefix(rest);
+    const messageIdx = rest.indexOf('--message');
+    const message = messageIdx >= 0 ? rest[messageIdx + 1] : undefined;
+    const repo = await ctx.repo();
+    const sheet = await openTargetSheet(ctx, sheetName, prefix);
+    if (name === undefined) {
+        // Delete all attachments on the record. Already idempotent in the library.
+        const before = await sheet.getAttachments(path);
+        const count = before ? Object.keys(before).length : 0;
+        if (count === 0) {
+            return renderObject({
+                result: 'no-op',
+                sheet: sheetName,
+                record: path,
+                reason: 'record has no attachments',
+            });
+        }
+        const commitMessage = message ?? `${sheetName} deleteAttachments on ${path}`;
+        let commitHash = '';
+        try {
+            const result = await repo.transact({ message: commitMessage }, async (tx) => {
+                const txSheet = tx.sheet(sheetName, prefix !== undefined ? { prefix } : {});
+                await txSheet.deleteAttachments(path);
+            });
+            commitHash = result.commitHash ?? '';
+        }
+        catch (error) {
+            throw translateError(error);
+        }
+        return renderObject({
+            result: 'committed',
+            sheet: sheetName,
+            record: path,
+            deleted: count,
+            commit: commitHash,
+        });
+    }
+    // Single-attachment delete; idempotent on already-missing.
+    const existing = await sheet.getAttachment(path, name);
+    if (!existing) {
+        return renderObject({
+            result: 'no-op',
+            sheet: sheetName,
+            record: path,
+            name,
+            reason: 'attachment already absent',
+        });
+    }
+    const commitMessage = message ?? `${sheetName} deleteAttachment ${name} on ${path}`;
+    let commitHash = '';
+    try {
+        const result = await repo.transact({ message: commitMessage }, async (tx) => {
+            const txSheet = tx.sheet(sheetName, prefix !== undefined ? { prefix } : {});
+            await txSheet.deleteAttachment(path, name);
+        });
+        commitHash = result.commitHash ?? '';
+    }
+    catch (error) {
+        if (error instanceof NotFoundError) {
+            return renderObject({
+                result: 'no-op',
+                sheet: sheetName,
+                record: path,
+                name,
+                reason: 'attachment vanished between check and delete',
+            });
+        }
+        throw translateError(error);
+    }
+    return renderObject({
+        result: 'committed',
+        sheet: sheetName,
+        record: path,
+        name,
+        commit: commitHash,
+    });
+}
+// stat() is exported here only to keep the import list tidy if we ever need
+// file-size pre-checks in attachment set; suppress unused-import noise.
+void stat;
+//# sourceMappingURL=attachment.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { GitsheetsContext } from '../context.js';
+export declare const CHECK_HELP = "usage: gitsheets-axi check <sheet> <file> [--fix] [--prefix p]\nflags[2]:\n  --fix                Rewrite the file in canonical form if not already canonical\n  --prefix <p>         Tenant sub-tree scope\nexamples:\n  gitsheets-axi check users users/jane.toml\n  gitsheets-axi check users users/jane.toml --fix\nexit codes:\n  0   File is canonical (or rewritten if --fix)\n  1   File is not canonical and --fix was not passed\n  22  ValidationError \u2014 record fails the sheet's JSON Schema\n  64  ConfigError \u2014 file failed to parse as the sheet's format\nbehavior:\n  Reads from the working tree (not git). Never commits. Designed as a\n  post-edit hook for agents that wrote a record directly: run with --fix\n  to land in canonical form; run without to verify pre-commit.\n";
+export declare function checkCommand(args: string[], ctx: GitsheetsContext): Promise<string>;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/commands/check.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,eAAO,MAAM,UAAU,qxBAgBtB,CAAC;AAgDF,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CAsGjB"}

package/dist/src/commands/check.js

@@ -0,0 +1,136 @@
+import { isAbsolute, join, relative } from 'node:path';
+import { readFile, writeFile } from 'node:fs/promises';
+import { AxiError } from 'axi-sdk-js';
+import { ConfigError, getFormat, NotFoundError, validateRecord } from 'gitsheets';
+import { translateError } from '../errors.js';
+import { renderObject } from '../output/render.js';
+export const CHECK_HELP = `usage: gitsheets-axi check <sheet> <file> [--fix] [--prefix p]
+flags[2]:
+  --fix                Rewrite the file in canonical form if not already canonical
+  --prefix <p>         Tenant sub-tree scope
+examples:
+  gitsheets-axi check users users/jane.toml
+  gitsheets-axi check users users/jane.toml --fix
+exit codes:
+  0   File is canonical (or rewritten if --fix)
+  1   File is not canonical and --fix was not passed
+  22  ValidationError — record fails the sheet's JSON Schema
+  64  ConfigError — file failed to parse as the sheet's format
+behavior:
+  Reads from the working tree (not git). Never commits. Designed as a
+  post-edit hook for agents that wrote a record directly: run with --fix
+  to land in canonical form; run without to verify pre-commit.
+`;
+function parseCheckFlags(args) {
+    const flags = {
+        sheet: '',
+        file: '',
+        fix: false,
+        prefix: undefined,
+    };
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        const next = args[i + 1];
+        if (arg === '--fix') {
+            flags.fix = true;
+            continue;
+        }
+        if (arg === '--prefix') {
+            if (!next)
+                throw new AxiError('--prefix expects a path', 'VALIDATION_ERROR');
+            flags.prefix = next;
+            i++;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            throw new AxiError(`Unknown flag: ${arg}`, 'VALIDATION_ERROR', [
+                'Run `gitsheets-axi check --help`',
+            ]);
+        }
+        positional.push(arg);
+    }
+    if (positional.length !== 2) {
+        throw new AxiError('check requires <sheet> <file>', 'VALIDATION_ERROR', [
+            'Example: gitsheets-axi check users users/jane.toml',
+        ]);
+    }
+    flags.sheet = positional[0];
+    flags.file = positional[1];
+    return flags;
+}
+export async function checkCommand(args, ctx) {
+    if (args.length === 0 || (args.length === 1 && args[0] === '--help')) {
+        return CHECK_HELP;
+    }
+    const flags = parseCheckFlags(args);
+    const repo = await ctx.repo();
+    let sheet;
+    try {
+        sheet = await repo.openSheet(flags.sheet, flags.prefix !== undefined ? { prefix: flags.prefix } : {});
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    const config = await sheet.readConfig();
+    const format = getFormat(config.format.type);
+    const absPath = isAbsolute(flags.file)
+        ? flags.file
+        : join(process.cwd(), flags.file);
+    let original;
+    try {
+        original = await readFile(absPath, 'utf-8');
+    }
+    catch (err) {
+        throw translateError(new NotFoundError('record_not_found', `check: cannot read ${flags.file}: ${err instanceof Error ? err.message : String(err)}`));
+    }
+    // Parse via the sheet's format. Failure → ConfigError → exit 64.
+    let record;
+    try {
+        record = format.parse(original, config.format);
+    }
+    catch (err) {
+        throw translateError(new ConfigError('config_invalid', `check: failed to parse ${flags.file} as ${config.format.type}: ${err instanceof Error ? err.message : String(err)}`, { cause: err }));
+    }
+    // Validate against the sheet's schema → ValidationError → exit 22.
+    let validated;
+    try {
+        validated = await validateRecord({
+            record: { ...record },
+            schema: config.schema,
+            schemaSourcePath: `.gitsheets/${flags.sheet}.toml`,
+        });
+    }
+    catch (err) {
+        throw translateError(err);
+    }
+    const normalized = await sheet.normalizeRecord(validated);
+    const newText = await format.serialize({ ...normalized }, config.format);
+    const relPath = relative(process.cwd(), absPath) || flags.file;
+    if (newText === original) {
+        return renderObject({
+            result: 'ok',
+            file: relPath,
+            canonical: true,
+        });
+    }
+    if (flags.fix) {
+        try {
+            await writeFile(absPath, newText, 'utf-8');
+        }
+        catch (err) {
+            throw new AxiError(`check: could not write ${flags.file}: ${err instanceof Error ? err.message : String(err)}`, 'WRITE_ERROR');
+        }
+        return renderObject({
+            result: 'fixed',
+            file: relPath,
+            canonical: true,
+            bytes_changed: original.length !== newText.length || original !== newText,
+        });
+    }
+    // Not canonical, --fix not passed. AXI behavior: error on stdout, exit 1.
+    throw new AxiError(`${flags.file} is not in canonical form`, 'NOT_CANONICAL', [`Re-run with \`--fix\` to rewrite ${flags.file}`]);
+}
+//# sourceMappingURL=check.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { GitsheetsContext } from '../context.js';
+export declare const DELETE_HELP = "usage: gitsheets-axi delete <sheet> <path> [--prefix p] [--message m]\nflags[2]:\n  --prefix <p>         Tenant sub-tree scope\n  --message <m>        Commit message (default: \"<sheet> delete <path>\")\nexamples:\n  gitsheets-axi delete users jane\n  gitsheets-axi delete posts hello --message \"remove deprecated post\"\nidempotency:\n  Already-missing records exit 0 with result: \"no-op\" \u2014 no commit, no\n  error. Pattern: an agent re-running a workflow can safely call delete\n  without checking existence first.\n";
+export declare function deleteCommand(args: string[], ctx: GitsheetsContext): Promise<string>;
+//# sourceMappingURL=delete.d.ts.map

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

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

package/dist/src/commands/delete.js

@@ -0,0 +1,132 @@
+import { AxiError } from 'axi-sdk-js';
+import { NotFoundError, RECORD_PATH_KEY } from 'gitsheets';
+import { translateError } from '../errors.js';
+import { renderObject } from '../output/render.js';
+export const DELETE_HELP = `usage: gitsheets-axi delete <sheet> <path> [--prefix p] [--message m]
+flags[2]:
+  --prefix <p>         Tenant sub-tree scope
+  --message <m>        Commit message (default: "<sheet> delete <path>")
+examples:
+  gitsheets-axi delete users jane
+  gitsheets-axi delete posts hello --message "remove deprecated post"
+idempotency:
+  Already-missing records exit 0 with result: "no-op" — no commit, no
+  error. Pattern: an agent re-running a workflow can safely call delete
+  without checking existence first.
+`;
+function parseDeleteFlags(args) {
+    const flags = {
+        sheet: '',
+        path: '',
+        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];
+        if (arg === '--prefix') {
+            if (!next)
+                throw new AxiError('--prefix expects a path', 'VALIDATION_ERROR');
+            flags.prefix = next;
+            i++;
+            continue;
+        }
+        if (arg === '--message') {
+            if (!next)
+                throw new AxiError('--message expects a string', 'VALIDATION_ERROR');
+            flags.message = next;
+            i++;
+            continue;
+        }
+        if (arg.startsWith('-')) {
+            throw new AxiError(`Unknown flag: ${arg}`, 'VALIDATION_ERROR', [
+                'Run `gitsheets-axi delete --help`',
+            ]);
+        }
+        positional.push(arg);
+    }
+    if (positional.length !== 2) {
+        throw new AxiError('delete requires <sheet> <path>', 'VALIDATION_ERROR', [
+            'Example: gitsheets-axi delete users jane',
+        ]);
+    }
+    flags.sheet = positional[0];
+    flags.path = positional[1];
+    return flags;
+}
+export async function deleteCommand(args, ctx) {
+    if (args.length === 0 || (args.length === 1 && args[0] === '--help')) {
+        return DELETE_HELP;
+    }
+    const flags = parseDeleteFlags(args);
+    const target = stripExtension(flags.path);
+    const repo = await ctx.repo();
+    let sheet;
+    try {
+        sheet = await repo.openSheet(flags.sheet, flags.prefix !== undefined ? { prefix: flags.prefix } : {});
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    // Pre-flight existence check — idempotent on already-missing.
+    let exists = false;
+    try {
+        for await (const record of sheet.query()) {
+            const pathSym = record[RECORD_PATH_KEY];
+            if (pathSym === target) {
+                exists = true;
+                break;
+            }
+        }
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    if (!exists) {
+        return renderObject({
+            result: 'no-op',
+            sheet: flags.sheet,
+            path: target,
+            reason: 'record already absent',
+        });
+    }
+    const commitMessage = flags.message ?? `${flags.sheet} delete ${target}`;
+    try {
+        const result = await repo.transact({ message: commitMessage }, async (tx) => {
+            const txSheet = tx.sheet(flags.sheet, flags.prefix !== undefined ? { prefix: flags.prefix } : {});
+            await txSheet.delete(target);
+        });
+        return renderObject({
+            result: 'committed',
+            sheet: flags.sheet,
+            path: target,
+            commit: result.commitHash,
+        });
+    }
+    catch (error) {
+        // Edge: race where the record vanished between the existence check
+        // and the delete. Treat as no-op rather than failing.
+        if (error instanceof NotFoundError) {
+            return renderObject({
+                result: 'no-op',
+                sheet: flags.sheet,
+                path: target,
+                reason: 'record vanished between check and delete',
+            });
+        }
+        throw translateError(error);
+    }
+}
+function stripExtension(path) {
+    if (path.endsWith('.toml'))
+        return path.slice(0, -5);
+    if (path.endsWith('.md'))
+        return path.slice(0, -3);
+    if (path.endsWith('.mdx'))
+        return path.slice(0, -4);
+    return path;
+}
+//# sourceMappingURL=delete.js.map