gitsheets-axi 0.0.1

package/dist/src/commands/sheets.js

@@ -0,0 +1,142 @@
+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 { countRecords } from '../output/sheet-schema.js';
+import { Template } from 'gitsheets';
+export const SHEETS_HELP = `usage: gitsheets-axi sheets [<subcommand>] [flags]
+subcommands[2]:
+  list                  List sheets configured in this repository (default)
+  view <name>           Show a single sheet's config + summary
+examples:
+  gitsheets-axi sheets
+  gitsheets-axi sheets list
+  gitsheets-axi sheets view users
+`;
+export async function sheetsCommand(args, ctx) {
+    if (args.length === 1 && args[0] === '--help')
+        return SHEETS_HELP;
+    const sub = args[0] ?? 'list';
+    if (sub === 'list')
+        return sheetsList(ctx);
+    if (sub === 'view')
+        return sheetsView(args.slice(1), ctx);
+    if (sub === '--help')
+        return SHEETS_HELP;
+    throw new AxiError(`Unknown subcommand: ${sub}`, 'VALIDATION_ERROR', [
+        'Subcommands: list, view',
+    ]);
+}
+async function sheetsList(ctx) {
+    const repo = await ctx.repo();
+    let sheets;
+    try {
+        sheets = await repo.openSheets();
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    const summaries = [];
+    for (const [name, sheet] of Object.entries(sheets)) {
+        let format = 'toml';
+        let root = '.';
+        let records = 0;
+        try {
+            const config = await sheet.readConfig();
+            format = config.format.type ?? 'toml';
+            root = config.root ?? '.';
+            records = await countRecords(sheet);
+        }
+        catch {
+            // skip count on malformed config
+        }
+        summaries.push({ name, format, records, root });
+    }
+    summaries.sort((a, b) => String(a['name']).localeCompare(String(b['name'])));
+    const help = summaries.length === 0
+        ? ['No sheets — add `.gitsheets/<name>.toml` to declare one']
+        : [
+            'Run `gitsheets-axi sheets view <name>` to inspect a config',
+            'Run `gitsheets-axi query <sheet>` to list records',
+        ];
+    return renderListResponse({
+        name: 'sheets',
+        items: summaries,
+        schema: [
+            field('name'),
+            display('format'),
+            computed('records', (item) => `${item['records']}`),
+            field('root'),
+        ],
+        suggestions: help,
+        emptyMessage: 'no sheets configured in this repository',
+    });
+}
+async function sheetsView(args, ctx) {
+    const name = args[0];
+    if (!name || name.startsWith('-')) {
+        throw new AxiError('sheets view requires a sheet name', 'VALIDATION_ERROR', [
+            'Run `gitsheets-axi sheets view <name>`',
+        ]);
+    }
+    const repo = await ctx.repo();
+    let sheet;
+    try {
+        sheet = await repo.openSheet(name);
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    let config;
+    try {
+        config = await sheet.readConfig();
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    const template = Template.fromString(config.path);
+    const pathFields = template.getFieldNames();
+    const schemaProps = schemaPropertyList(config);
+    const records = await countRecords(sheet);
+    const output = {
+        sheet: {
+            name,
+            root: config.root ?? '.',
+            format: config.format.type ?? 'toml',
+            path: config.path,
+            records,
+            path_fields: pathFields.length > 0 ? pathFields.join(', ') : '(none)',
+        },
+    };
+    if (config.format.body) {
+        output['sheet']['body_field'] = config.format.body;
+    }
+    if (schemaProps.length > 0) {
+        output['schema'] = renderSchemaProperties(schemaProps);
+    }
+    output['help'] = [
+        `Run \`gitsheets-axi query ${name}\` to list records`,
+        `Run \`gitsheets-axi read ${name} <path>\` to view one record`,
+    ];
+    return renderObject(output);
+}
+function schemaPropertyList(config) {
+    const schema = config.schema;
+    if (!schema || typeof schema !== 'object')
+        return [];
+    const props = schema['properties'];
+    if (!props || typeof props !== 'object')
+        return [];
+    return Object.entries(props);
+}
+function renderSchemaProperties(props) {
+    // Flat name → "type [required]" map for token-efficient display.
+    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}`;
+    }
+    return out;
+}
+//# sourceMappingURL=sheets.js.map

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

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

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

@@ -0,0 +1,4 @@
+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 function upsertCommand(args: string[], ctx: GitsheetsContext): Promise<string>;
+//# sourceMappingURL=upsert.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/commands/upsert.js

@@ -0,0 +1,137 @@
+import { AxiError } from 'axi-sdk-js';
+import { translateError } from '../errors.js';
+import { renderObject } from '../output/render.js';
+import { readStdin } from '../util/stdin.js';
+export const UPSERT_HELP = `usage: gitsheets-axi upsert <sheet> [--data <json>] [--allow-missing-body] [--prefix p] [--message m]
+flags[4]:
+  --data <json>        Record JSON inline. If omitted, reads stdin.
+  --allow-missing-body Content-typed sheets only — permit upsert without body field
+  --prefix <p>         Tenant sub-tree scope
+  --message <m>        Commit message (default: "<sheet> upsert <path>")
+examples:
+  gitsheets-axi upsert users --data '{"slug":"jane","email":"jane@x.org"}'
+  echo '{"slug":"jane","email":"jane@x.org"}' | gitsheets-axi upsert users
+idempotency:
+  Compares the canonical bytes the upsert would write against the
+  existing blob at the rendered path. If identical, exits 0 with
+  result: "no-op" and no commit is produced.
+`;
+function parseUpsertFlags(args) {
+    const flags = {
+        sheet: '',
+        data: undefined,
+        allowMissingBody: false,
+        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 '--data':
+                if (!next)
+                    throw new AxiError('--data expects a JSON string', 'VALIDATION_ERROR');
+                flags.data = next;
+                i++;
+                break;
+            case '--allow-missing-body':
+                flags.allowMissingBody = true;
+                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 upsert --help`',
+                    ]);
+                }
+                positional.push(arg);
+        }
+    }
+    if (positional.length !== 1) {
+        throw new AxiError('upsert requires <sheet>', 'VALIDATION_ERROR', [
+            'Example: gitsheets-axi upsert users --data \'{"slug":"jane"}\'',
+        ]);
+    }
+    flags.sheet = positional[0];
+    return flags;
+}
+export async function upsertCommand(args, ctx) {
+    if (args.length === 0 || (args.length === 1 && args[0] === '--help')) {
+        return UPSERT_HELP;
+    }
+    const flags = parseUpsertFlags(args);
+    const recordJson = flags.data ?? (await readStdin());
+    if (!recordJson.trim()) {
+        throw new AxiError('upsert needs a record — pass --data <json> or pipe JSON on stdin', 'VALIDATION_ERROR', ['Example: gitsheets-axi upsert users --data \'{"slug":"jane"}\'']);
+    }
+    let record;
+    try {
+        record = JSON.parse(recordJson);
+    }
+    catch (error) {
+        throw new AxiError(`Could not parse record JSON: ${error instanceof Error ? error.message : String(error)}`, 'INVALID_JSON', ['Ensure the input is a valid JSON object']);
+    }
+    if (!record || typeof record !== 'object' || Array.isArray(record)) {
+        throw new AxiError('Record 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);
+    }
+    const upsertOpts = flags.allowMissingBody ? { allowMissingBody: true } : {};
+    // Pre-flight idempotency check.
+    let willResult;
+    try {
+        willResult = await sheet.willChange(record, upsertOpts);
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+    if (!willResult.changed) {
+        return renderObject({
+            result: 'no-op',
+            sheet: flags.sheet,
+            path: willResult.path,
+            hash: willResult.currentBlobHash ?? '',
+        });
+    }
+    // Carry through. willChange validated already; this re-validates inside
+    // upsert (cheap, idempotent at the validate layer). Future optimization
+    // could expose a "skip validation" path keyed off willChange's result.
+    const commitMessage = flags.message ?? `${flags.sheet} upsert ${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.upsert(record, upsertOpts);
+        });
+        return renderObject({
+            result: 'committed',
+            sheet: flags.sheet,
+            path: result.value.path,
+            hash: result.value.blob.hash,
+            commit: result.commitHash,
+        });
+    }
+    catch (error) {
+        throw translateError(error);
+    }
+}
+//# sourceMappingURL=upsert.js.map

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

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

package/dist/src/context.d.ts

@@ -0,0 +1,17 @@
+import { type Repository } from 'gitsheets';
+/**
+ * Lazy gitsheets repo resolver. Opens the repo when a command actually needs
+ * it. Commands that operate without a repo (currently: none — even `home`
+ * shows the repo) call `requireRepo()` to surface a structured error when
+ * the cwd isn't inside a git repo.
+ */
+export interface GitsheetsContext {
+    repo(): Promise<Repository>;
+    /**
+     * Returns `null` rather than throwing when the cwd isn't inside a git repo —
+     * `home` uses this to render a "no repo here" message instead of erroring.
+     */
+    tryRepo(): Promise<Repository | null>;
+}
+export declare function createContext(): GitsheetsContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CACvC;AAED,wBAAgB,aAAa,IAAI,gBAAgB,CAgDhD"}

package/dist/src/context.js

@@ -0,0 +1,47 @@
+import { AxiError } from 'axi-sdk-js';
+import { openRepo } from 'gitsheets';
+export function createContext() {
+    let cached;
+    let cachedError;
+    async function load() {
+        if (cached !== undefined)
+            return cached;
+        if (cachedError !== undefined)
+            throw cachedError;
+        try {
+            cached = await openRepo();
+            return cached;
+        }
+        catch (error) {
+            cached = null;
+            cachedError = error;
+            throw error;
+        }
+    }
+    return {
+        async repo() {
+            try {
+                const result = await load();
+                if (!result) {
+                    throw new AxiError('Not inside a git repository.', 'NOT_A_REPOSITORY', ['Run this command from a directory inside a gitsheets-managed git repository.']);
+                }
+                return result;
+            }
+            catch (error) {
+                if (error instanceof AxiError)
+                    throw error;
+                // openRepo throws when there's no git repo. Translate.
+                throw new AxiError('Not inside a git repository.', 'NOT_A_REPOSITORY', ['Run this command from a directory inside a gitsheets-managed git repository.']);
+            }
+        },
+        async tryRepo() {
+            try {
+                return await load();
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/src/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAmB,MAAM,WAAW,CAAC;AAiBtD,MAAM,UAAU,aAAa;IAC3B,IAAI,MAAqC,CAAC;IAC1C,IAAI,WAAoB,CAAC;IAEzB,KAAK,UAAU,IAAI;QACjB,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,IAAI,WAAW,KAAK,SAAS;YAAE,MAAM,WAAW,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,IAAI,CAAC;YACd,WAAW,GAAG,KAAK,CAAC;YACpB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI;YACR,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,QAAQ,CAChB,8BAA8B,EAC9B,kBAAkB,EAClB,CAAC,8EAA8E,CAAC,CACjF,CAAC;gBACJ,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,QAAQ;oBAAE,MAAM,KAAK,CAAC;gBAC3C,uDAAuD;gBACvD,MAAM,IAAI,QAAQ,CAChB,8BAA8B,EAC9B,kBAAkB,EAClB,CAAC,8EAA8E,CAAC,CACjF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,CAAC,OAAO;YACX,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,EAAE,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/errors.d.ts

@@ -0,0 +1,13 @@
+import { AxiError } from 'axi-sdk-js';
+/**
+ * Translate a thrown gitsheets error into an AxiError. Centralizes the
+ * error→AXI code map so individual commands can `try { ... } catch (e)
+ * { throw translateError(e); }` once.
+ *
+ * The library throws structured `GitsheetsError` subclasses with stable
+ * codes. We map each to an AxiError code that aligns with AXI conventions
+ * + add tailored next-step suggestions so agents see actionable hints
+ * rather than bare error messages.
+ */
+export declare function translateError(error: unknown): AxiError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAatC;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAiDvD"}

package/dist/src/errors.js

@@ -0,0 +1,58 @@
+import { AxiError } from 'axi-sdk-js';
+import { ConfigError, GitsheetsError, IndexError, NotFoundError, PathTemplateError, RefError, TransactionError, ValidationError, } from 'gitsheets';
+/**
+ * Translate a thrown gitsheets error into an AxiError. Centralizes the
+ * error→AXI code map so individual commands can `try { ... } catch (e)
+ * { throw translateError(e); }` once.
+ *
+ * The library throws structured `GitsheetsError` subclasses with stable
+ * codes. We map each to an AxiError code that aligns with AXI conventions
+ * + add tailored next-step suggestions so agents see actionable hints
+ * rather than bare error messages.
+ */
+export function translateError(error) {
+    if (error instanceof AxiError)
+        return error;
+    if (error instanceof ValidationError) {
+        const issues = formatValidationIssues(error.issues);
+        return new AxiError(`Record failed validation: ${issues[0] ?? 'unknown issue'}`, 'VALIDATION_FAILED', issues.slice(1).length > 0 ? issues.slice(1) : []);
+    }
+    if (error instanceof NotFoundError) {
+        return new AxiError(error.message, 'NOT_FOUND', []);
+    }
+    if (error instanceof ConfigError) {
+        return new AxiError(error.message, 'CONFIG_INVALID', [
+            'Inspect `.gitsheets/<sheet>.toml` — the sheet config is malformed or missing.',
+        ]);
+    }
+    if (error instanceof IndexError) {
+        return new AxiError(error.message, 'INDEX_CONFLICT', []);
+    }
+    if (error instanceof PathTemplateError) {
+        return new AxiError(error.message, 'PATH_TEMPLATE_ERROR', [
+            'Check the sheet config\'s `path` template against the record fields.',
+        ]);
+    }
+    if (error instanceof RefError) {
+        return new AxiError(error.message, 'REF_ERROR', []);
+    }
+    if (error instanceof TransactionError) {
+        return new AxiError(error.message, 'TRANSACTION_ERROR', []);
+    }
+    if (error instanceof GitsheetsError) {
+        return new AxiError(error.message, error.code.toUpperCase(), []);
+    }
+    if (error instanceof Error) {
+        return new AxiError(error.message, 'UNKNOWN_ERROR', []);
+    }
+    return new AxiError(String(error), 'UNKNOWN_ERROR', []);
+}
+function formatValidationIssues(issues) {
+    if (!issues || issues.length === 0)
+        return ['(no issue details)'];
+    return issues.map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : '(root)';
+        return `${path}: ${issue.message}`;
+    });
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

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

package/dist/src/output/index.d.ts

@@ -0,0 +1,3 @@
+export * from './schema.js';
+export * from './render.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/output/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/src/output/index.js

@@ -0,0 +1,3 @@
+export * from './schema.js';
+export * from './render.js';
+//# sourceMappingURL=index.js.map

package/dist/src/output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/output/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/src/output/render.d.ts

@@ -0,0 +1,28 @@
+import type { FieldDef } from './schema.js';
+/**
+ * Render a list of items as a TOON table.
+ *
+ * Output:
+ *   <name>[N]{col1,col2,col3}:
+ *     val1,val2,val3
+ *     val1,val2,val3
+ */
+export declare function renderList(name: string, items: Array<Record<string, unknown>>, schema: FieldDef[]): string;
+export declare function renderObject(value: Record<string, unknown>): string;
+export declare function renderHelp(suggestions: string[]): string;
+export declare function joinBlocks(...blocks: string[]): string;
+/**
+ * Compose a list response with optional header, summary, items, and help.
+ * Empty results collapse to a scalar message under the list's field name —
+ * matches the AXI "definitive empty state" convention.
+ */
+export declare function renderListResponse(options: {
+    header?: Record<string, unknown>;
+    name: string;
+    items: Array<Record<string, unknown>>;
+    schema: FieldDef[];
+    summary?: Record<string, unknown>;
+    suggestions?: string[];
+    emptyMessage?: string;
+}): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/src/output/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/output/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACrC,MAAM,EAAE,QAAQ,EAAE,GACjB,MAAM,CAKR;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEnE;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAGxD;AAED,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAoBT"}

package/dist/src/output/render.js

@@ -0,0 +1,49 @@
+import { encode } from '@toon-format/toon';
+/**
+ * Render a list of items as a TOON table.
+ *
+ * Output:
+ *   <name>[N]{col1,col2,col3}:
+ *     val1,val2,val3
+ *     val1,val2,val3
+ */
+export function renderList(name, items, schema) {
+    const projected = items.map((item) => Object.fromEntries(schema.map((f) => [f.name, f.extract(item) ?? ''])));
+    return encode({ [name]: projected });
+}
+export function renderObject(value) {
+    return encode(value);
+}
+export function renderHelp(suggestions) {
+    if (suggestions.length === 0)
+        return '';
+    return encode({ help: suggestions });
+}
+export function joinBlocks(...blocks) {
+    return blocks.filter((b) => b.length > 0).join('\n');
+}
+/**
+ * Compose a list response with optional header, summary, items, and help.
+ * Empty results collapse to a scalar message under the list's field name —
+ * matches the AXI "definitive empty state" convention.
+ */
+export function renderListResponse(options) {
+    const blocks = [];
+    if (options.header)
+        blocks.push(renderObject(options.header));
+    if (options.summary)
+        blocks.push(renderObject(options.summary));
+    if (options.items.length === 0) {
+        blocks.push(renderObject({
+            [options.name]: options.emptyMessage ?? `0 ${options.name} found`,
+        }));
+    }
+    else {
+        blocks.push(renderList(options.name, options.items, options.schema));
+    }
+    if (options.suggestions?.length) {
+        blocks.push(renderHelp(options.suggestions));
+    }
+    return joinBlocks(...blocks);
+}
+//# sourceMappingURL=render.js.map

package/dist/src/output/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/output/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,KAAqC,EACrC,MAAkB;IAElB,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACnC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CACvE,CAAC;IACF,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA8B;IACzD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,WAAqB;IAC9C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAG,MAAgB;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAQlC;IACC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,IAAI,OAAO,CAAC,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhE,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CACT,YAAY,CAAC;YACX,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK,OAAO,CAAC,IAAI,QAAQ;SAClE,CAAC,CACH,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/output/schema.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Schema builders for TOON table rendering. Each FieldDef projects from a
+ * source object (a gitsheets record or library response shape) onto a named
+ * column in the output table. Modeled after the gws-axi pattern.
+ *
+ * Usage:
+ *   const schema = [
+ *     field('slug'),
+ *     truncated('title', 60),
+ *     computed('size', (r) => Buffer.byteLength(String(r.body ?? ''), 'utf-8')),
+ *   ];
+ *   renderList('records', items, schema);
+ */
+export interface FieldDef {
+    name: string;
+    extract: (item: Record<string, unknown>) => unknown;
+}
+export declare function field(name: string): FieldDef;
+export declare function computed(name: string, fn: (item: Record<string, unknown>) => unknown): FieldDef;
+/**
+ * Truncate a string to `max` chars with ellipsis. Pass-through for non-strings.
+ */
+export declare function truncated(name: string, max: number, alias?: string): FieldDef;
+/**
+ * Coerce a value to its display string. Empty for null/undefined; otherwise
+ * `String(value)`. Useful when a column might hold numbers, dates, or strings.
+ */
+export declare function display(name: string, alias?: string): FieldDef;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/output/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/output/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;CACrD;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE5C;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,GAC7C,QAAQ,CAEV;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAS7E;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAU9D"}