gitsheets-axi 0.0.1

package/dist/src/commands/patch.js

@@ -0,0 +1,172 @@
+import { AxiError } from 'axi-sdk-js';
+import { mergePatch } from 'gitsheets';
+import { translateError } from '../errors.js';
+import { renderObject } from '../output/render.js';
+import { readStdin } from '../util/stdin.js';
+export const PATCH_HELP = `usage: gitsheets-axi patch <sheet> <query-json> [--patch <json>] [--prefix p] [--message m]
+flags[3]:
+  --patch <json>       RFC 7396 partial. If omitted, reads stdin.
+  --prefix <p>         Tenant sub-tree scope
+  --message <m>        Commit message (default: "<sheet> patch <path>")
+examples:
+  gitsheets-axi patch users '{"slug":"jane"}' --patch '{"name":"Jane O. Doe"}'
+  echo '{"name":"Jane O. Doe"}' | gitsheets-axi patch users '{"slug":"jane"}'
+semantics:
+  RFC 7396 JSON Merge Patch. \`null\` deletes a field, arrays replace
+  in full, objects merge recursively. Same as gitsheets's library patch.
+idempotency:
+  Reads the existing record, applies the merge, runs the result through
+  willChange. If the canonical bytes are unchanged, exits 0 with
+  result: "no-op" and no commit is produced.
+`;
+function parsePatchFlags(args) {
+    const flags = {
+        sheet: '',
+        queryJson: '',
+        patchJson: undefined,
+        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 '--patch':
+                if (!next)
+                    throw new AxiError('--patch expects JSON', 'VALIDATION_ERROR');
+                flags.patchJson = next;
+                i++;
+                break;
+            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 patch --help`',
+                    ]);
+                }
+                positional.push(arg);
+        }
+    }
+    if (positional.length !== 2) {
+        throw new AxiError('patch requires <sheet> <query-json>', 'VALIDATION_ERROR', [
+            "Example: gitsheets-axi patch users '{\"slug\":\"jane\"}' --patch '{...}'",
+        ]);
+    }
+    flags.sheet = positional[0];
+    flags.queryJson = positional[1];
+    return flags;
+}
+export async function patchCommand(args, ctx) {
+    if (args.length === 0 || (args.length === 1 && args[0] === '--help')) {
+        return PATCH_HELP;
+    }
+    const flags = parsePatchFlags(args);
+    let query;
+    try {
+        query = JSON.parse(flags.queryJson);
+    }
+    catch (error) {
+        throw new AxiError(`Could not parse query JSON: ${error instanceof Error ? error.message : String(error)}`, 'INVALID_JSON');
+    }
+    const patchJson = flags.patchJson ?? (await readStdin());
+    if (!patchJson.trim()) {
+        throw new AxiError('patch needs a partial — pass --patch <json> or pipe JSON on stdin', 'VALIDATION_ERROR');
+    }
+    let partial;
+    try {
+        partial = JSON.parse(patchJson);
+    }
+    catch (error) {
+        throw new AxiError(`Could not parse patch JSON: ${error instanceof Error ? error.message : String(error)}`, 'INVALID_JSON');
+    }
+    if (!partial || typeof partial !== 'object' || Array.isArray(partial)) {
+        throw new AxiError('Patch must be a JSON object', 'VALIDATION_ERROR');
+    }
+    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);
+    }
+    let existing;
+    try {
+        existing = await sheet.queryFirst(query);
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    if (!existing) {
+        throw new AxiError(`${flags.sheet}: no record matches the query`, 'NOT_FOUND');
+    }
+    // Apply RFC 7396 merge in-axi so we can run willChange against the result.
+    const merged = mergePatch(stripSymbols(existing), partial);
+    // Preserve the record's path annotation so willChange uses the rename path
+    // logic if any path-template field changed (matches Sheet.patch behavior).
+    const pathSym = existing[Symbol.for('gitsheets-path')];
+    if (typeof pathSym === 'string') {
+        merged[Symbol.for('gitsheets-path')] = pathSym;
+    }
+    // Body-presence on content-typed sheets: patch is body-preserving — the
+    // merged record carries the existing body forward unless the partial
+    // explicitly replaced it. Use allowMissingBody to defer the upsert guard
+    // since the merge produces the canonical record either way.
+    const upsertOpts = { allowMissingBody: true };
+    let willResult;
+    try {
+        willResult = await sheet.willChange(merged, upsertOpts);
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    if (!willResult.changed) {
+        return renderObject({
+            result: 'no-op',
+            sheet: flags.sheet,
+            path: willResult.path,
+            hash: willResult.currentBlobHash ?? '',
+        });
+    }
+    const commitMessage = flags.message ?? `${flags.sheet} patch ${willResult.path}`;
+    try {
+        const result = await repo.transact({ message: commitMessage }, async (tx) => {
+            const txSheet = tx.sheet(flags.sheet, flags.prefix !== undefined ? { prefix: flags.prefix } : {});
+            return txSheet.patch(query, partial);
+        });
+        return renderObject({
+            result: 'committed',
+            sheet: flags.sheet,
+            path: result.value.path,
+            hash: result.value.blob.hash,
+            commit: result.commitHash,
+        });
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+}
+function stripSymbols(record) {
+    if (!record || typeof record !== 'object')
+        return record;
+    const out = {};
+    for (const key of Object.keys(record)) {
+        out[key] = record[key];
+    }
+    return out;
+}
+//# sourceMappingURL=patch.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { GitsheetsContext } from '../context.js';
+export declare const PUSH_HELP = "usage: gitsheets-axi push [--remote r] [--branch b]\nflags[2]:\n  --remote <r>         Git remote to push to (default: origin)\n  --branch <b>         Branch to push (default: the repo's current HEAD branch)\nexamples:\n  gitsheets-axi push\n  gitsheets-axi push --remote upstream --branch main\nbehavior:\n  One-shot push via `git push <remote> <branch>`. For agent workflows\n  that want to publish after a mutation without spinning up a background\n  daemon. This is NOT a daemon lifecycle command \u2014 for retry-with-backoff\n  semantics, use Repository.startPushDaemon from a long-running consumer.\nidempotency:\n  When the remote is already up to date, exits 0 with\n  result: \"no-op\" \u2014 git's natural \"Everything up-to-date\" path.\nerrors:\n  NON_FAST_FORWARD     Remote has work the local doesn't \u2014 never force-pushed.\n                       Reconcile externally (pull or rebase), then re-run.\n  PUSH_FAILED          Network / auth / other transient failure. Re-run later.\n";
+export declare function pushCommand(args: string[], ctx: GitsheetsContext): Promise<string>;
+//# sourceMappingURL=push.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/commands/push.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKtD,eAAO,MAAM,SAAS,6+BAmBrB,CAAC;AAyDF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CAqDjB"}

package/dist/src/commands/push.js

@@ -0,0 +1,112 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { AxiError } from 'axi-sdk-js';
+import { renderObject } from '../output/render.js';
+const exec = promisify(execFile);
+export const PUSH_HELP = `usage: gitsheets-axi push [--remote r] [--branch b]
+flags[2]:
+  --remote <r>         Git remote to push to (default: origin)
+  --branch <b>         Branch to push (default: the repo's current HEAD branch)
+examples:
+  gitsheets-axi push
+  gitsheets-axi push --remote upstream --branch main
+behavior:
+  One-shot push via \`git push <remote> <branch>\`. For agent workflows
+  that want to publish after a mutation without spinning up a background
+  daemon. This is NOT a daemon lifecycle command — for retry-with-backoff
+  semantics, use Repository.startPushDaemon from a long-running consumer.
+idempotency:
+  When the remote is already up to date, exits 0 with
+  result: "no-op" — git's natural "Everything up-to-date" path.
+errors:
+  NON_FAST_FORWARD     Remote has work the local doesn't — never force-pushed.
+                       Reconcile externally (pull or rebase), then re-run.
+  PUSH_FAILED          Network / auth / other transient failure. Re-run later.
+`;
+function parsePushFlags(args) {
+    const flags = { remote: 'origin', branch: undefined };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        const next = args[i + 1];
+        if (arg === '--remote') {
+            if (!next)
+                throw new AxiError('--remote expects a name', 'VALIDATION_ERROR');
+            flags.remote = next;
+            i++;
+            continue;
+        }
+        if (arg === '--branch') {
+            if (!next)
+                throw new AxiError('--branch expects a name', 'VALIDATION_ERROR');
+            flags.branch = next;
+            i++;
+            continue;
+        }
+        if (arg === '--help')
+            continue;
+        throw new AxiError(`Unknown flag: ${arg}`, 'VALIDATION_ERROR', [
+            'Run `gitsheets-axi push --help`',
+        ]);
+    }
+    return flags;
+}
+async function resolveBranch(gitDir) {
+    const { stdout } = await exec('git', ['symbolic-ref', '--short', 'HEAD'], { cwd: gitDir });
+    const branch = stdout.trim();
+    if (!branch) {
+        throw new AxiError("Couldn't determine current branch (detached HEAD?)", 'REF_ERROR', ['Pass --branch explicitly, e.g. `gitsheets-axi push --branch main`']);
+    }
+    return branch;
+}
+function classifyPushError(message) {
+    if (/!\s*\[rejected\]/.test(message) && /(non-fast-forward|fetch first)/i.test(message)) {
+        return 'NON_FAST_FORWARD';
+    }
+    return 'PUSH_FAILED';
+}
+export async function pushCommand(args, ctx) {
+    if (args.length === 1 && args[0] === '--help')
+        return PUSH_HELP;
+    const flags = parsePushFlags(args);
+    const repo = await ctx.repo();
+    const gitDir = repo.gitDir;
+    const branch = flags.branch ?? (await resolveBranch(gitDir));
+    let stderr = '';
+    try {
+        const result = await exec('git', ['push', flags.remote, branch], { cwd: gitDir, maxBuffer: 10 * 1024 * 1024 });
+        stderr = result.stderr;
+    }
+    catch (error) {
+        const err = error;
+        const combined = `${err.stderr ?? ''}\n${err.stdout ?? ''}\n${err.message ?? ''}`;
+        const code = classifyPushError(combined);
+        const suggestions = code === 'NON_FAST_FORWARD'
+            ? [
+                "Remote has commits the local doesn't — reconcile externally before retrying",
+                'Stop the writer, fetch + rebase or pull, then restart',
+            ]
+            : ['Network or auth failure — retry, or check the remote configuration'];
+        throw new AxiError(`git push to ${flags.remote} ${branch} failed: ${(err.message ?? '').split('\n')[0] ?? 'unknown error'}`, code, suggestions);
+    }
+    // git's "Everything up-to-date" lands in stderr without an error code.
+    // Treat as no-op.
+    const upToDate = /everything up.to.date/i.test(stderr);
+    if (upToDate) {
+        return renderObject({
+            result: 'no-op',
+            remote: flags.remote,
+            branch,
+            reason: 'remote already up-to-date',
+        });
+    }
+    return renderObject({
+        result: 'pushed',
+        remote: flags.remote,
+        branch,
+        // Strip git's noisy "To <url>" / hash lines into a compact summary.
+        detail: stderr.split('\n').filter((l) => l.trim()).slice(0, 3).join('\n'),
+    });
+}
+//# sourceMappingURL=push.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { GitsheetsContext } from '../context.js';
+export declare const QUERY_HELP = "usage: gitsheets-axi query <sheet> [--filter k=v ...] [--fields a,b,c] [--limit n]\nflags[4]:\n  --filter <k>=<v>     Equality match against record field (repeatable)\n  --fields <list>      Extra columns beyond the default schema (comma-separated)\n  --limit <n>          Cap results (default: 100, max: 10000)\n  --prefix <p>         Tenant sub-tree scope (see gitsheets --prefix)\nexamples:\n  gitsheets-axi query users\n  gitsheets-axi query users --filter status=active --limit 50\n  gitsheets-axi query posts --fields title,published\noutput:\n  Default schema is format-aware:\n    TOML sheets    \u2014 path-template fields + first scalar properties (cap 4)\n    Markdown/MDX   \u2014 path-template fields + title + body_size (never body content)\n  --fields appends additional columns.\n";
+export declare function queryCommand(args: string[], ctx: GitsheetsContext): Promise<string>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/commands/query.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAStD,eAAO,MAAM,UAAU,iyBAetB,CAAC;AAwEF,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CAgFjB"}

package/dist/src/commands/query.js

@@ -0,0 +1,141 @@
+import { AxiError } from 'axi-sdk-js';
+import { translateError } from '../errors.js';
+import { renderListResponse } 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)
+  --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)
+examples:
+  gitsheets-axi query users
+  gitsheets-axi query users --filter status=active --limit 50
+  gitsheets-axi query posts --fields title,published
+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.
+`;
+function parseQueryFlags(args) {
+    const sheetName = args[0];
+    if (!sheetName || sheetName.startsWith('-')) {
+        throw new AxiError('query requires a sheet name', 'VALIDATION_ERROR', [
+            'Run `gitsheets-axi query <sheet>`',
+        ]);
+    }
+    const flags = {
+        filters: [],
+        extras: [],
+        limit: 100,
+        prefix: undefined,
+    };
+    for (let i = 1; i < args.length; i++) {
+        const arg = args[i];
+        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)]);
+                i++;
+                break;
+            }
+            case '--fields':
+                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 '--limit':
+                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) {
+                    throw new AxiError('--prefix expects a path', 'VALIDATION_ERROR');
+                }
+                flags.prefix = next;
+                i++;
+                break;
+            default:
+                throw new AxiError(`Unknown flag: ${arg}`, 'VALIDATION_ERROR', [
+                    'Run `gitsheets-axi query --help` to see supported flags',
+                ]);
+        }
+    }
+    return { sheetName, flags };
+}
+export async function queryCommand(args, ctx) {
+    if (args.length === 0 || (args.length === 1 && args[0] === '--help')) {
+        return QUERY_HELP;
+    }
+    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 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;
+    try {
+        records = await sheet.queryAll(filter, { withBody });
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    const total = records.length;
+    const limited = records.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');
+    }
+    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 (total > limited.length) {
+        suggestions.push(`${total - limited.length} records hidden by --limit ${flags.limit}; raise --limit to see more`);
+    }
+    return renderListResponse({
+        summary: { count: `${limited.length} of ${total} 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}`,
+    });
+}
+//# sourceMappingURL=query.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { GitsheetsContext } from '../context.js';
+export declare const READ_HELP = "usage: gitsheets-axi read <sheet> <path> [--full] [--prefix p]\nflags[2]:\n  --full               Don't truncate the body field on content-typed sheets\n  --prefix <p>         Tenant sub-tree scope (see gitsheets --prefix)\nexamples:\n  gitsheets-axi read users jane\n  gitsheets-axi read posts hello --full\noutput:\n  TOML sheet           \u2014 all fields, one per line\n  Markdown/MDX sheet   \u2014 frontmatter fields + body truncated to ~500 chars\n                         (with \"(truncated, N chars total)\" + --full hint)\n";
+export declare function readCommand(args: string[], ctx: GitsheetsContext): Promise<string>;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/commands/read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,eAAO,MAAM,SAAS,0hBAWrB,CAAC;AAoDF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CAiEjB"}

package/dist/src/commands/read.js

@@ -0,0 +1,149 @@
+import { AxiError } from 'axi-sdk-js';
+import { NotFoundError, RECORD_PATH_KEY, RECORD_SHEET_KEY } from 'gitsheets';
+import { translateError } from '../errors.js';
+import { renderObject } from '../output/render.js';
+export const READ_HELP = `usage: gitsheets-axi read <sheet> <path> [--full] [--prefix p]
+flags[2]:
+  --full               Don't truncate the body field on content-typed sheets
+  --prefix <p>         Tenant sub-tree scope (see gitsheets --prefix)
+examples:
+  gitsheets-axi read users jane
+  gitsheets-axi read posts hello --full
+output:
+  TOML sheet           — all fields, one per line
+  Markdown/MDX sheet   — frontmatter fields + body truncated to ~500 chars
+                         (with "(truncated, N chars total)" + --full hint)
+`;
+const BODY_PREVIEW_CHARS = 500;
+function parseReadFlags(args) {
+    const positional = [];
+    const flags = {
+        sheet: '',
+        path: '',
+        full: false,
+        prefix: undefined,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === undefined)
+            continue;
+        const next = args[i + 1];
+        if (arg === '--full') {
+            flags.full = 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 read --help`',
+            ]);
+        }
+        positional.push(arg);
+    }
+    if (positional.length !== 2) {
+        throw new AxiError('read requires <sheet> <path>', 'VALIDATION_ERROR', [
+            'Example: gitsheets-axi read users jane',
+        ]);
+    }
+    flags.sheet = positional[0];
+    flags.path = positional[1];
+    return flags;
+}
+export async function readCommand(args, ctx) {
+    if (args.length === 0 || (args.length === 1 && args[0] === '--help')) {
+        return READ_HELP;
+    }
+    const flags = parseReadFlags(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);
+    }
+    // The path is the rendered template result; drop a trailing `.toml`/`.md`
+    // extension if the caller included one.
+    const target = stripExtension(flags.path);
+    let found;
+    try {
+        for await (const record of sheet.query()) {
+            const pathSym = record[RECORD_PATH_KEY];
+            if (pathSym === target) {
+                found = record;
+                break;
+            }
+        }
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    if (!found) {
+        throw translateError(new NotFoundError('record_not_found', `${flags.sheet}: no record at ${target}`));
+    }
+    // Hydrate body for content-typed sheets — query() returns body-less records.
+    const config = await sheet.readConfig();
+    const bodyField = config.format.body;
+    if (bodyField && found[bodyField] === undefined) {
+        try {
+            found = (await sheet.loadBody(found));
+        }
+        catch {
+            // Body load failure is non-fatal — agent can still see frontmatter.
+        }
+    }
+    const out = {};
+    out['record'] = projectRecord(found, bodyField, flags.full);
+    const help = [];
+    if (bodyField && !flags.full) {
+        const bodyValue = found[bodyField];
+        if (typeof bodyValue === 'string' && bodyValue.length > BODY_PREVIEW_CHARS) {
+            help.push(`Run \`gitsheets-axi read ${flags.sheet} ${target} --full\` to see complete body`);
+        }
+    }
+    if (help.length > 0)
+        out['help'] = help;
+    return renderObject(out);
+}
+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;
+}
+function projectRecord(record, bodyField, full) {
+    const cleaned = {};
+    for (const [key, value] of Object.entries(record)) {
+        if (key === bodyField && !full && typeof value === 'string') {
+            if (value.length > BODY_PREVIEW_CHARS) {
+                cleaned[key] = `${value.slice(0, BODY_PREVIEW_CHARS)}…  (truncated, ${value.length} chars total)`;
+            }
+            else {
+                cleaned[key] = value;
+            }
+            continue;
+        }
+        cleaned[key] = value;
+    }
+    // Symbol annotations: surface path as a plain field for visibility.
+    const pathSym = record[RECORD_PATH_KEY];
+    if (typeof pathSym === 'string') {
+        cleaned['_path'] = pathSym;
+    }
+    const sheetSym = record[RECORD_SHEET_KEY];
+    if (typeof sheetSym === 'string') {
+        cleaned['_sheet'] = sheetSym;
+    }
+    return cleaned;
+}
+//# sourceMappingURL=read.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../src/commands/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;CAWxB,CAAC;AAEF,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAS/B,SAAS,cAAc,CAAC,IAAc;IACpC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAc;QACvB,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,EAAE;QACR,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,SAAS;KAClB,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,QAAQ,CAAC,yBAAyB,EAAE,kBAAkB,CAAC,CAAC;YACpE,CAAC;YACD,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;YACpB,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,QAAQ,CAAC,iBAAiB,GAAG,EAAE,EAAE,kBAAkB,EAAE;gBAC7D,iCAAiC;aAClC,CAAC,CAAC;QACL,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC,8BAA8B,EAAE,kBAAkB,EAAE;YACrE,wCAAwC;SACzC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;IAC7B,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;IAC5B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAc,EACd,GAAqB;IAErB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAE9B,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAC1B,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAC3D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,0EAA0E;IAC1E,wCAAwC;IACxC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE1C,IAAI,KAA0C,CAAC;IAC/C,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YACzC,MAAM,OAAO,GAAI,MAAkC,CAAC,eAAe,CAAC,CAAC;YACrE,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;gBACvB,KAAK,GAAG,MAAiC,CAAC;gBAC1C,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,cAAc,CAClB,IAAI,aAAa,CAAC,kBAAkB,EAAE,GAAG,KAAK,CAAC,KAAK,kBAAkB,MAAM,EAAE,CAAC,CAChF,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IACrC,IAAI,SAAS,IAAK,KAAiC,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7E,IAAI,CAAC;YACH,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAc,CAAC,CAAuC,CAAC;QACvF,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,GAAG,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;YAC3E,IAAI,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,KAAK,IAAI,MAAM,gCAAgC,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAExC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CACpB,MAA+B,EAC/B,SAA6B,EAC7B,IAAa;IAEb,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5D,IAAI,KAAK,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,kBAAkB,KAAK,CAAC,MAAM,eAAe,CAAC;YACpG,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACvB,CAAC;YACD,SAAS;QACX,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IACD,oEAAoE;IACpE,MAAM,OAAO,GAAI,MAAkC,CAAC,eAAe,CAAC,CAAC;IACrE,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC7B,CAAC;IACD,MAAM,QAAQ,GAAI,MAAkC,CAAC,gBAAgB,CAAC,CAAC;IACvE,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;IAC/B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { GitsheetsContext } from '../context.js';
+export declare const SHEETS_HELP = "usage: gitsheets-axi sheets [<subcommand>] [flags]\nsubcommands[2]:\n  list                  List sheets configured in this repository (default)\n  view <name>           Show a single sheet's config + summary\nexamples:\n  gitsheets-axi sheets\n  gitsheets-axi sheets list\n  gitsheets-axi sheets view users\n";
+export declare function sheetsCommand(args: string[], ctx: GitsheetsContext): Promise<string>;
+//# sourceMappingURL=sheets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sheets.d.ts","sourceRoot":"","sources":["../../../src/commands/sheets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOtD,eAAO,MAAM,WAAW,0TAQvB,CAAC;AAEF,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CAWjB"}