gitsheets-axi 0.0.1

package/dist/src/output/schema.js

@@ -0,0 +1,51 @@
+/**
+ * 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 function field(name) {
+    return { name, extract: (item) => item[name] };
+}
+export function computed(name, fn) {
+    return { name, extract: fn };
+}
+/**
+ * Truncate a string to `max` chars with ellipsis. Pass-through for non-strings.
+ */
+export function truncated(name, max, alias) {
+    return {
+        name: alias ?? name,
+        extract: (item) => {
+            const value = item[name];
+            if (typeof value !== 'string')
+                return value;
+            return value.length > max ? `${value.slice(0, max - 1)}…` : value;
+        },
+    };
+}
+/**
+ * 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 function display(name, alias) {
+    return {
+        name: alias ?? name,
+        extract: (item) => {
+            const value = item[name];
+            if (value === null || value === undefined)
+                return '';
+            if (value instanceof Date)
+                return value.toISOString();
+            return String(value);
+        },
+    };
+}
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/output/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,EAA8C;IAE9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAW,EAAE,KAAc;IACjE,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,IAAI;QACnB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC5C,OAAO,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QACpE,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,KAAc;IAClD,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,IAAI;QACnB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC;YACrD,IAAI,KAAK,YAAY,IAAI;gBAAE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;YACtD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { Sheet, SheetConfig } from 'gitsheets';
+import { type FieldDef } from './schema.js';
+/**
+ * Build the default TOON schema for `query` against a sheet. Introspects
+ * the sheet's path template + format config so:
+ *   - TOML sheets show path-template fields plus a couple of scalar fields
+ *     from the JSON Schema (whatever's named first).
+ *   - Markdown/mdx sheets show path-template fields, `title` (denormalized
+ *     from body's H1 once #169 lands; currently a frontmatter field), and
+ *     `body_size` — never the body content.
+ *
+ * Capped at ~4 columns total to stay within the AXI "minimal default schema"
+ * budget. Consumers extend via `--fields`.
+ */
+export declare function defaultSheetSchema(config: SheetConfig): FieldDef[];
+/**
+ * Resolve the field list for a list-rendering command, optionally extending
+ * the default schema with user-supplied `--fields a,b,c` entries.
+ */
+export declare function fieldsWithExtras(defaults: FieldDef[], extras: string[]): FieldDef[];
+/**
+ * Count records in a sheet. Uses queryAll under the hood — fine for repos
+ * with thousands of records; cap-checking is the consumer's job if their
+ * corpus pushes higher.
+ */
+export declare function countRecords(sheet: Sheet): Promise<number>;
+//# sourceMappingURL=sheet-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-schema.d.ts","sourceRoot":"","sources":["../../../src/output/sheet-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EAA8B,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAcxE;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,EAAE,CAuClE;AAuBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAAE,EACpB,MAAM,EAAE,MAAM,EAAE,GACf,QAAQ,EAAE,CAUZ;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE"}

package/dist/src/output/sheet-schema.js

@@ -0,0 +1,114 @@
+import { Template } from 'gitsheets';
+import { computed, field, truncated } from './schema.js';
+/**
+ * Body-size column for content-typed sheets. Reports the configured body
+ * field's byte length so agents see at a glance which records are long.
+ */
+function bodySizeField(bodyField) {
+    return computed('body_size', (item) => {
+        const value = item[bodyField];
+        if (typeof value !== 'string')
+            return '';
+        return `${Buffer.byteLength(value, 'utf-8')}`;
+    });
+}
+/**
+ * Build the default TOON schema for `query` against a sheet. Introspects
+ * the sheet's path template + format config so:
+ *   - TOML sheets show path-template fields plus a couple of scalar fields
+ *     from the JSON Schema (whatever's named first).
+ *   - Markdown/mdx sheets show path-template fields, `title` (denormalized
+ *     from body's H1 once #169 lands; currently a frontmatter field), and
+ *     `body_size` — never the body content.
+ *
+ * Capped at ~4 columns total to stay within the AXI "minimal default schema"
+ * budget. Consumers extend via `--fields`.
+ */
+export function defaultSheetSchema(config) {
+    const template = Template.fromString(config.path);
+    const pathFields = template.getFieldNames();
+    const bodyField = config.format.body;
+    const fields = [];
+    const seen = new Set();
+    for (const name of pathFields) {
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        fields.push(field(name));
+    }
+    if (bodyField !== undefined) {
+        // Markdown/MDX: include `title` if the schema declares it, then body size.
+        if (!seen.has('title') && schemaHasProperty(config, 'title')) {
+            seen.add('title');
+            fields.push(truncated('title', 60));
+        }
+        if (!seen.has('body_size')) {
+            seen.add('body_size');
+            fields.push(bodySizeField(bodyField));
+        }
+        return fields.slice(0, 4);
+    }
+    // TOML: pad out with the first few non-template scalar properties from the
+    // JSON schema, capped at 4 total. Skips array/object properties — those
+    // don't tabulate well.
+    const props = schemaProperties(config);
+    for (const [name, prop] of props) {
+        if (fields.length >= 4)
+            break;
+        if (seen.has(name))
+            continue;
+        if (!isScalarSchema(prop))
+            continue;
+        seen.add(name);
+        fields.push(field(name));
+    }
+    return fields;
+}
+function schemaProperties(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 schemaHasProperty(config, name) {
+    return schemaProperties(config).some(([n]) => n === name);
+}
+function isScalarSchema(prop) {
+    if (!prop || typeof prop !== 'object')
+        return false;
+    const type = prop['type'];
+    if (type === 'string' || type === 'number' || type === 'integer' || type === 'boolean') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Resolve the field list for a list-rendering command, optionally extending
+ * the default schema with user-supplied `--fields a,b,c` entries.
+ */
+export function fieldsWithExtras(defaults, extras) {
+    if (extras.length === 0)
+        return defaults;
+    const out = [...defaults];
+    const seen = new Set(out.map((f) => f.name));
+    for (const name of extras) {
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        out.push(field(name));
+    }
+    return out;
+}
+/**
+ * Count records in a sheet. Uses queryAll under the hood — fine for repos
+ * with thousands of records; cap-checking is the consumer's job if their
+ * corpus pushes higher.
+ */
+export async function countRecords(sheet) {
+    const rows = await sheet.queryAll({}, { withBody: false });
+    return rows.length;
+}
+//# sourceMappingURL=sheet-schema.js.map

package/dist/src/output/sheet-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-schema.js","sourceRoot":"","sources":["../../../src/output/sheet-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAiB,MAAM,aAAa,CAAC;AAExE;;;GAGG;AACH,SAAS,aAAa,CAAC,SAAiB;IACtC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;QACpC,MAAM,KAAK,GAAI,IAAgC,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACzC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IACrC,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,2EAA2E;QAC3E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;YAC7D,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,2EAA2E;IAC3E,wEAAwE;IACxE,uBAAuB;IACvB,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;YAAE,MAAM;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;YAAE,SAAS;QACpC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAmB;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,MAA6C,CAAC;IACpE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACnD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAmB,EAAE,IAAY;IAC1D,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,cAAc,CAAC,IAAa;IACnC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,IAAI,GAAI,IAAgC,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAoB,EACpB,MAAgB;IAEhB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACzC,MAAM,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAY;IAC7C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC"}

package/dist/src/util/stdin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Read all of process.stdin to a string. Resolves to '' if stdin is a TTY
+ * (interactive — nothing to read) or when the GITSHEETS_AXI_NO_STDIN env is
+ * set (test-mode opt-out to avoid hangs in in-process test runners).
+ */
+export declare function readStdin(): Promise<string>;
+//# sourceMappingURL=stdin.d.ts.map

package/dist/src/util/stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../../../src/util/stdin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAUjD"}

package/dist/src/util/stdin.js

@@ -0,0 +1,19 @@
+/**
+ * Read all of process.stdin to a string. Resolves to '' if stdin is a TTY
+ * (interactive — nothing to read) or when the GITSHEETS_AXI_NO_STDIN env is
+ * set (test-mode opt-out to avoid hangs in in-process test runners).
+ */
+export async function readStdin() {
+    if (process.stdin.isTTY)
+        return '';
+    if (process.env['GITSHEETS_AXI_NO_STDIN'] === '1')
+        return '';
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('data', (chunk) => { data += chunk; });
+        process.stdin.on('end', () => resolve(data));
+        process.stdin.on('error', reject);
+    });
+}
+//# sourceMappingURL=stdin.js.map

package/dist/src/util/stdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.js","sourceRoot":"","sources":["../../../src/util/stdin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "gitsheets-axi",
+  "version": "0.0.1",
+  "description": "Agent-facing CLI for gitsheets — token-efficient TOON output, idempotent mutations, self-installing session hooks.",
+  "type": "module",
+  "bin": {
+    "gitsheets-axi": "dist/bin/gitsheets-axi.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && chmod +x dist/bin/gitsheets-axi.js",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JarvusInnovations/gitsheets.git",
+    "directory": "packages/gitsheets-axi"
+  },
+  "homepage": "https://github.com/JarvusInnovations/gitsheets#readme",
+  "bugs": {
+    "url": "https://github.com/JarvusInnovations/gitsheets/issues"
+  },
+  "license": "Apache-2.0",
+  "author": "Jarvus Innovations",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "gitsheets",
+    "axi",
+    "agent",
+    "cli",
+    "toon",
+    "git"
+  ],
+  "dependencies": {
+    "@toon-format/toon": "^2.2.0",
+    "axi-sdk-js": "^0.1.6",
+    "gitsheets": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^25.8.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  }
+}