gh-axi 0.1.0

package/dist/src/toon.js

@@ -0,0 +1,151 @@
+import { encode } from '@toon-format/toon';
+export function field(key, as) {
+    return { type: 'field', key, as };
+}
+export function pluck(key, subkey, as) {
+    return { type: 'pluck', key, subkey, as };
+}
+export function joinArray(key, subkey, as, empty = 'none') {
+    return { type: 'joinArray', key, subkey, as, empty };
+}
+export function relativeTime(key, as) {
+    return { type: 'relativeTime', key, as };
+}
+export function boolYesNo(key, as) {
+    return { type: 'boolYesNo', key, as };
+}
+export function mapEnum(key, map, fallback, as) {
+    return { type: 'mapEnum', key, map, fallback, as };
+}
+export function lower(key, as) {
+    return { type: 'lower', key, as };
+}
+export function checksSummary(key, as) {
+    return { type: 'checksSummary', key, as };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- custom extractors are polymorphic by design
+export function custom(as, fn) {
+    return { type: 'custom', as, fn };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- items are JSON-parsed objects with dynamic keys
+export function extract(item, schema) {
+    const result = {};
+    for (const def of schema) {
+        const outputKey = def.as ?? ('key' in def ? def.key : def.as);
+        switch (def.type) {
+            case 'field':
+                result[outputKey] = item[def.key] ?? null;
+                break;
+            case 'pluck':
+                result[outputKey] = item[def.key]?.[def.subkey] ?? null;
+                break;
+            case 'joinArray': {
+                const arr = item[def.key];
+                if (Array.isArray(arr) && arr.length > 0) {
+                    result[outputKey] = arr.map((x) => (typeof x === 'string' ? x : x[def.subkey])).join(',');
+                }
+                else {
+                    result[outputKey] = def.empty ?? 'none';
+                }
+                break;
+            }
+            case 'relativeTime':
+                result[outputKey] = formatRelativeTime(item[def.key]);
+                break;
+            case 'boolYesNo':
+                result[outputKey] = item[def.key] ? 'yes' : 'no';
+                break;
+            case 'mapEnum': {
+                const val = item[def.key];
+                if (typeof val === 'string' && val !== '' && val in def.map) {
+                    result[outputKey] = def.map[val];
+                }
+                else {
+                    result[outputKey] = def.fallback ?? val ?? 'none';
+                }
+                break;
+            }
+            case 'lower':
+                result[outputKey] = typeof item[def.key] === 'string' ? item[def.key].toLowerCase() : item[def.key];
+                break;
+            case 'checksSummary': {
+                const checks = item[def.key];
+                if (Array.isArray(checks) && checks.length > 0) {
+                    const passed = checks.filter((c) => c.conclusion === 'SUCCESS' || c.conclusion === 'NEUTRAL').length;
+                    result[outputKey] = `${passed}/${checks.length} pass`;
+                }
+                else {
+                    result[outputKey] = 'none';
+                }
+                break;
+            }
+            case 'custom':
+                result[outputKey] = def.fn(item);
+                break;
+            default: {
+                const _exhaustive = def;
+                throw new Error(`Unknown field type: ${_exhaustive.type}`);
+            }
+        }
+    }
+    return result;
+}
+/** Render a labeled list of items as TOON. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- items are JSON-parsed objects with dynamic keys
+export function renderList(label, items, schema) {
+    const extracted = items.map((item) => extract(item, schema));
+    return encode({ [label]: extracted });
+}
+/** Render a single labeled detail object as TOON. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- items are JSON-parsed objects with dynamic keys
+export function renderDetail(label, item, schema) {
+    const extracted = extract(item, schema);
+    return encode({ [label]: extracted });
+}
+/** Render help suggestions (manual formatting — encode() inlines primitive arrays). */
+export function renderHelp(lines) {
+    if (lines.length === 0)
+        return '';
+    const indented = lines.map((l) => `  ${l}`).join('\n');
+    return `help[${lines.length}]:\n${indented}`;
+}
+/** Render an error in TOON format. */
+export function renderError(message, code, suggestions = []) {
+    const blocks = [encode({ error: message, code })];
+    if (suggestions.length > 0) {
+        blocks.push(renderHelp(suggestions));
+    }
+    return blocks.join('\n');
+}
+/** Combine multiple TOON blocks into a single output string. */
+export function renderOutput(blocks) {
+    return blocks.filter(Boolean).join('\n');
+}
+function formatRelativeTime(iso) {
+    if (!iso)
+        return 'unknown';
+    const now = Date.now();
+    const then = new Date(iso).getTime();
+    if (isNaN(then))
+        return 'unknown';
+    const MS_PER_SECOND = 1000;
+    const diffMs = now - then;
+    const diffSec = Math.floor(diffMs / MS_PER_SECOND);
+    if (diffSec < 60)
+        return 'just now';
+    const diffMin = Math.floor(diffSec / 60);
+    if (diffMin < 60)
+        return `${diffMin}m ago`;
+    const diffHr = Math.floor(diffMin / 60);
+    if (diffHr < 24)
+        return `${diffHr}h ago`;
+    const diffDay = Math.floor(diffHr / 24);
+    if (diffDay < 30)
+        return `${diffDay}d ago`;
+    const diffMon = Math.floor(diffDay / 30);
+    if (diffMon < 12)
+        return `${diffMon}mo ago`;
+    const diffYr = Math.floor(diffMon / 12);
+    return `${diffYr}y ago`;
+}
+//# sourceMappingURL=toon.js.map

package/dist/src/toon.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "gh-axi",
+  "version": "0.1.0",
+  "description": "AXI-compliant gh CLI wrapper — token-efficient TOON output, contextual suggestions, idempotent mutations",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kunchenguid/axg.git",
+    "directory": "gh-axi"
+  },
+  "keywords": [
+    "github",
+    "cli",
+    "agent",
+    "axi",
+    "toon",
+    "gh"
+  ],
+  "bin": {
+    "gh-axi": "./dist/bin/gh-axi.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "dev": "tsx bin/gh-axi.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@toon-format/toon": "^2.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}