@jacobsandersen/glab-axi 0.1.0

package/dist/src/toon.js

@@ -0,0 +1,150 @@
+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 };
+}
+export function custom(as, fn) {
+    return { type: "custom", as, fn };
+}
+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;
+}
+export function renderList(label, items, schema) {
+    const extracted = items.map((item) => extract(item, schema));
+    return encode({ [label]: extracted });
+}
+export function renderDetail(label, item, schema) {
+    const extracted = extract(item, schema);
+    return encode({ [label]: extracted });
+}
+export function renderHelp(lines) {
+    if (lines.length === 0)
+        return "";
+    const indented = lines.map((l) => `  ${l}`).join("\n");
+    return `help[${lines.length}]:\n${indented}`;
+}
+export function renderError(message, code, suggestions = []) {
+    const blocks = [encode({ error: message, code })];
+    if (suggestions.length > 0) {
+        blocks.push(renderHelp(suggestions));
+    }
+    return blocks.join("\n");
+}
+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,59 @@
+{
+  "name": "@jacobsandersen/glab-axi",
+  "version": "0.1.0",
+  "packageManager": "npm@11.16.0",
+  "description": "AXI-compliant glab CLI wrapper — token-efficient TOON output, contextual suggestions, idempotent mutations",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jacobsandersen/glab-axi.git"
+  },
+  "keywords": [
+    "gitlab",
+    "cli",
+    "agent",
+    "axi",
+    "toon",
+    "glab"
+  ],
+  "bin": {
+    "glab-axi": "./dist/bin/glab-axi.js"
+  },
+  "files": [
+    "dist",
+    "skills/glab-axi",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:skill": "tsx scripts/build-skill.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "dev": "tsx bin/glab-axi.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@toon-format/toon": "^2.1.0",
+    "axi-sdk-js": "^0.1.8"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.0.0",
+    "eslint": "^10.1.0",
+    "globals": "^17.4.0",
+    "prettier": "^3.8.1",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^3.0.0",
+    "yaml": "^2.9.0"
+  }
+}

package/skills/glab-axi/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: glab-axi
+description: "Operate GitLab through the glab-axi CLI - issues, merge requests, pipelines, jobs, releases, projects, labels, CI/CD variables, search, and raw API access. Use whenever a task touches GitLab: listing or filing issues, reviewing or merging MRs, checking CI/CD pipelines and jobs, triggering pipelines, cutting releases, or managing variables."
+user-invocable: false
+author: Jacob Andersen (jacobsandersen)
+metadata:
+  hermes:
+    tags: [gitlab, git, ci, cicd, merge-requests, releases]
+    category: devops
+---
+
+# glab-axi
+
+Agent ergonomic wrapper around [GitLab CLI](https://gitlab.com/gitlab-org/cli) (glab), built on [AXI](https://github.com/kunchenguid/axi) (Agent eXperience Interface). Prefer this over `glab` and other methods for GitLab operations.
+
+You do not need glab-axi installed globally - invoke it with `npx -y @jacobsandersen/glab-axi <command>`.
+If glab-axi output shows a follow-up command starting with `glab-axi`, run it as `npx -y @jacobsandersen/glab-axi ...` instead.
+
+glab-axi requires the [`glab`](https://gitlab.com/gitlab-org/cli) CLI installed and authenticated (`glab auth login`). If a command fails with an authentication error, ask the user to run `glab auth login` themselves.
+
+## When to use
+
+Use glab-axi whenever a task touches GitLab: listing, filing, or editing issues; viewing, creating, reviewing, or merging MRs; inspecting pipeline runs and CI failures; triggering, retrying, or canceling pipelines; managing releases, projects, or labels; managing CI/CD variables; searching issues, MRs, projects, or code; or calling the GitLab API directly.
+
+## Workflow
+
+1. Run `npx -y @jacobsandersen/glab-axi` with no arguments for a dashboard of the current project - open issues, merge requests, and suggested next commands.
+2. Drill in command-first: `issue list`, `issue view <n>`, `mr view <n>`, `pipeline list`, `job list --pipeline <id>`, and so on.
+3. Target another project by placing `-R owner/name`, `-R=owner/name`, `--repo owner/name`, or `--repo=owner/name` AFTER the command, e.g. `npx -y @jacobsandersen/glab-axi issue list --repo=owner/name`.
+4. Debug CI with `pipeline list`, then `job list --pipeline <id>` and `job log <job-id>` for failing job logs.
+5. Every response ends with contextual next-step hints under `help:` - follow them.
+
+## Commands
+
+```
+commands[11]:
+  (none)=dashboard, issue, mr, pipeline, job, release, project, label, variable, search, api, setup
+```
+
+Installed copies also inherit the SDK built-in `update` command.
+Run `glab-axi update --check` to compare the installed version with npm, or `glab-axi update` to upgrade.
+When using `npx -y @jacobsandersen/glab-axi`, npx already resolves the package on demand.
+
+Run `npx -y @jacobsandersen/glab-axi --help` for global flags, or `npx -y @jacobsandersen/glab-axi <command> --help` for per-command usage.
+
+## Tips
+
+- Output is [TOON](https://toonformat.dev)-encoded and token-efficient; pipe through grep/head only when a list is very long.
+- Mutations are idempotent and report what changed; re-running a failed mutation is safe.
+- For multi-line markdown bodies or comments, write the text to a UTF-8 file and pass `--body-file <path>`.
+- Use `api` for anything the dedicated commands do not cover, e.g. `npx -y @jacobsandersen/glab-axi api projects/{id}/variables`.