@tmcayden/youtrack-axi 0.1.0

package/dist/format.js

@@ -0,0 +1,143 @@
+import { AxiError } from "axi-sdk-js";
+export const DESCRIPTION_PREVIEW_CHARS = 800;
+/**
+ * YouTrack returns every custom field as {name, value:{name|login|...}}. Agents
+ * pay for that nesting twice - once in tokens, once in traversal - so it is
+ * flattened to plain scalars here and never reaches stdout in nested form.
+ */
+export function flattenCustomFields(fields) {
+    const flat = {};
+    for (const field of fields ?? []) {
+        if (!field?.name)
+            continue;
+        flat[field.name] = scalarize(field.value);
+    }
+    return flat;
+}
+function scalarize(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (Array.isArray(value))
+        return value.map(scalarize).filter(Boolean).join(", ");
+    if (typeof value === "object") {
+        const record = value;
+        for (const key of ["name", "presentation", "fullName", "login", "text"]) {
+            const candidate = record[key];
+            if (typeof candidate === "string" && candidate.length > 0)
+                return candidate;
+        }
+        const minutes = record["minutes"];
+        return typeof minutes === "number" ? formatMinutes(minutes) : "";
+    }
+    return String(value);
+}
+export function issueRow(issue) {
+    const fields = flattenCustomFields(issue.customFields);
+    return {
+        id: issue.idReadable ?? "",
+        summary: issue.summary ?? "",
+        state: fields["State"] ?? "",
+    };
+}
+export function issueRowWithFields(issue, extraFields) {
+    const flat = flattenCustomFields(issue.customFields);
+    const row = { ...issueRow(issue) };
+    for (const name of extraFields) {
+        row[fieldKey(name)] = flat[name] ?? nativeField(issue, name) ?? "";
+    }
+    return row;
+}
+function fieldKey(name) {
+    return name.toLowerCase().replace(/\s+/g, "_");
+}
+function nativeField(issue, name) {
+    switch (fieldKey(name)) {
+        case "project":
+            return issue.project?.shortName ?? undefined;
+        case "reporter":
+            return issue.reporter?.login ?? undefined;
+        case "created":
+            return issue.created ? formatDate(issue.created) : undefined;
+        case "updated":
+            return issue.updated ? formatDate(issue.updated) : undefined;
+        default:
+            return undefined;
+    }
+}
+export function truncate(value, limit = DESCRIPTION_PREVIEW_CHARS) {
+    const text = (value ?? "").trim();
+    if (text.length <= limit)
+        return { text, truncated: false, totalChars: text.length };
+    return { text: `${text.slice(0, limit)}...`, truncated: true, totalChars: text.length };
+}
+export function formatDate(epochMs) {
+    return new Date(epochMs).toISOString().slice(0, 10);
+}
+export function formatMinutes(minutes) {
+    if (minutes <= 0)
+        return "0m";
+    const hours = Math.floor(minutes / 60);
+    const rest = minutes % 60;
+    return [hours > 0 ? `${hours}h` : undefined, rest > 0 ? `${rest}m` : undefined].filter(Boolean).join(" ");
+}
+export function workRow(item) {
+    return {
+        date: item.date ? formatDate(item.date) : "",
+        duration: item.duration?.presentation ?? formatMinutes(item.duration?.minutes ?? 0),
+        author: item.author?.login ?? "",
+        type: item.type?.name ?? "",
+        text: (item.text ?? "").replace(/\s+/g, " ").trim(),
+    };
+}
+export function totalMinutes(items) {
+    return items.reduce((sum, item) => sum + (item.duration?.minutes ?? 0), 0);
+}
+const DURATION_TOKENS = /^(?:\d+w\s*)?(?:\d+d\s*)?(?:\d+h\s*)?(?:\d+m\s*)?$/i;
+/** YouTrack parses `presentation` itself; a bare number is taken as minutes. */
+export function parseDuration(raw, usage) {
+    const value = raw.trim();
+    if (/^\d+$/.test(value)) {
+        const minutes = Number(value);
+        if (minutes < 1)
+            throw durationError(raw, usage);
+        return { minutes };
+    }
+    if (!DURATION_TOKENS.test(value) || !/\d/.test(value))
+        throw durationError(raw, usage);
+    return { presentation: value };
+}
+function durationError(raw, usage) {
+    return new AxiError(`Cannot read "${raw}" as a duration`, "VALIDATION_ERROR", [
+        "Use YouTrack duration units: 30m, 1h, 1h 30m, 2d, or a bare number of minutes",
+        `Run \`youtrack-axi ${usage}\``,
+    ]);
+}
+/** Anchored to local noon so a date never slips a day when converted to UTC. */
+export function parseWorkDate(raw, usage) {
+    if (raw === undefined) {
+        const today = new Date();
+        return new Date(today.getFullYear(), today.getMonth(), today.getDate(), 12).getTime();
+    }
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(raw.trim());
+    if (!match) {
+        throw new AxiError(`Cannot read "${raw}" as a date`, "VALIDATION_ERROR", [
+            "Use YYYY-MM-DD, e.g. --date 2026-09-08",
+            `Run \`youtrack-axi ${usage}\``,
+        ]);
+    }
+    const [, year, month, day] = match;
+    const date = new Date(Number(year), Number(month) - 1, Number(day), 12);
+    if (date.getMonth() !== Number(month) - 1 || date.getDate() !== Number(day)) {
+        throw new AxiError(`"${raw}" is not a real calendar date`, "VALIDATION_ERROR", [
+            "Use YYYY-MM-DD, e.g. --date 2026-09-08",
+        ]);
+    }
+    return date.getTime();
+}
+export function splitFieldList(raw) {
+    return (raw ?? "")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The SDK renders handler return values itself, but does not export its
+ * renderer, so the few strings this CLI builds directly - top-level help,
+ * per-command help, the unknown-command error - encode through the same
+ * TOON library the SDK uses.
+ */
+export type StructuredOutput = Record<string, unknown>;
+export declare function renderOutput(output: StructuredOutput): string;
+export declare function renderError(message: string, code: string, suggestions?: string[]): string;
+export declare function collapseHome(path: string): string;

package/dist/render.js

@@ -0,0 +1,13 @@
+import { homedir } from "node:os";
+import { encode } from "@toon-format/toon";
+export function renderOutput(output) {
+    return encode(output);
+}
+export function renderError(message, code, suggestions = []) {
+    return renderOutput({ error: message, code, ...(suggestions.length > 0 ? { help: suggestions } : {}) });
+}
+export function collapseHome(path) {
+    const home = homedir();
+    return path.startsWith(home) ? `~${path.slice(home.length)}` : path;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAU3C,MAAM,UAAU,YAAY,CAAC,MAAwB;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAY,EAAE,cAAwB,EAAE;IACnF,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.1.0";

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/youtrack.d.ts

@@ -0,0 +1,55 @@
+import type { Config } from "./config.js";
+export interface CustomField {
+    name?: string;
+    value?: unknown;
+}
+export interface Issue {
+    idReadable?: string;
+    summary?: string;
+    description?: string | null;
+    created?: number;
+    updated?: number;
+    resolved?: number | null;
+    reporter?: {
+        login?: string;
+    } | null;
+    project?: {
+        shortName?: string;
+        name?: string;
+    } | null;
+    customFields?: CustomField[];
+    comments?: unknown[];
+}
+export interface WorkItem {
+    id?: string;
+    date?: number;
+    duration?: {
+        minutes?: number;
+        presentation?: string;
+    } | null;
+    text?: string | null;
+    type?: {
+        name?: string;
+    } | null;
+    author?: {
+        login?: string;
+        name?: string;
+    } | null;
+}
+export declare class YouTrackClient {
+    private readonly config;
+    constructor(config: Config);
+    get baseUrl(): string;
+    get<T>(path: string, params?: Record<string, string | number | undefined>): Promise<T>;
+    post<T>(path: string, body: unknown, params?: Record<string, string | number | undefined>): Promise<T>;
+    private request;
+    private translateError;
+    /**
+     * `issuesGetter/count` answers -1 while it computes the total, so a single call
+     * cannot be trusted. Returns undefined rather than ever surfacing -1.
+     */
+    countIssues(query: string): Promise<number | undefined>;
+}
+export declare const ISSUE_LIST_FIELDS = "idReadable,summary,customFields(name,value(name,login))";
+export declare const ISSUE_DETAIL_FIELDS: string;
+export declare const WORK_ITEM_FIELDS = "id,date,duration(minutes,presentation),text,type(name),author(login,name)";

package/dist/youtrack.js

@@ -0,0 +1,116 @@
+import { AxiError } from "axi-sdk-js";
+const REQUEST_TIMEOUT_MS = 30_000;
+export class YouTrackClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    get baseUrl() {
+        return this.config.url;
+    }
+    async get(path, params = {}) {
+        return this.request("GET", path, params);
+    }
+    async post(path, body, params = {}) {
+        return this.request("POST", path, params, body);
+    }
+    async request(method, path, params, body) {
+        const url = new URL(`${this.config.url}/api/${path.replace(/^\/+/, "")}`);
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined)
+                url.searchParams.set(key, String(value));
+        }
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers: {
+                    Authorization: `Bearer ${this.config.token}`,
+                    Accept: "application/json",
+                    ...(body === undefined ? {} : { "Content-Type": "application/json" }),
+                },
+                ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch (error) {
+            const reason = error instanceof Error && error.name === "TimeoutError" ? "timed out" : "is unreachable";
+            throw new AxiError(`YouTrack at ${this.config.url} ${reason}`, "NETWORK_ERROR", [
+                "Check network access and that the configured URL is correct",
+                `Current URL came from ${this.config.source}`,
+            ]);
+        }
+        const text = await response.text();
+        if (!response.ok) {
+            throw this.translateError(response.status, text, path);
+        }
+        if (text.length === 0)
+            return undefined;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw new AxiError(`YouTrack returned a non-JSON response for ${path}`, "API_ERROR", [
+                "Verify the configured URL points at a YouTrack instance, not a proxy or login page",
+            ]);
+        }
+    }
+    translateError(status, text, path) {
+        let parsed = {};
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            /* fall through to status-based messages */
+        }
+        const detail = [parsed.error_description, ...(parsed.error_children ?? []).map((c) => c.error)]
+            .filter((s) => Boolean(s))
+            .join("; ");
+        if (status === 401 || status === 403) {
+            return new AxiError(status === 401 ? "YouTrack rejected the token" : `Token lacks permission for ${path}`, "AUTH_ERROR", [
+                status === 401
+                    ? `Issue a new permanent token in YouTrack and run \`youtrack-axi setup --url "${this.config.url}" --token "<permanent-token>"\``
+                    : "Ask a YouTrack administrator to grant this account access, or use a token with wider scope",
+            ]);
+        }
+        if (status === 404) {
+            return new AxiError(detail || `Not found: ${path}`, "NOT_FOUND", [
+                "Run `youtrack-axi issues` to list issues you can see",
+                "Run `youtrack-axi projects` to list project short names",
+            ]);
+        }
+        if (status === 400 && parsed.error === "invalid_query") {
+            return new AxiError(`Invalid YouTrack query: ${detail}`, "VALIDATION_ERROR", [
+                'Use YouTrack query syntax, e.g. `youtrack-axi issues "for:me #Unresolved"`',
+                "Run `youtrack-axi fields <PROJECT>` to see valid field names and values",
+            ]);
+        }
+        if (status === 400) {
+            return new AxiError(detail || `YouTrack rejected the request to ${path}`, "VALIDATION_ERROR", [
+                "Check the values passed; run the command with --help for its accepted flags",
+            ]);
+        }
+        return new AxiError(`YouTrack returned HTTP ${status}${detail ? `: ${detail}` : ""}`, "API_ERROR", [
+            "Retry; if it persists, check YouTrack instance health",
+        ]);
+    }
+    /**
+     * `issuesGetter/count` answers -1 while it computes the total, so a single call
+     * cannot be trusted. Returns undefined rather than ever surfacing -1.
+     */
+    async countIssues(query) {
+        for (let attempt = 0; attempt < 5; attempt++) {
+            const result = await this.post("issuesGetter/count", { query }, { fields: "count" });
+            const count = result?.count;
+            if (typeof count === "number" && count >= 0)
+                return count;
+            await new Promise((resolve) => setTimeout(resolve, 150 * (attempt + 1)));
+        }
+        return undefined;
+    }
+}
+export const ISSUE_LIST_FIELDS = "idReadable,summary,customFields(name,value(name,login))";
+export const ISSUE_DETAIL_FIELDS = "idReadable,summary,description,created,updated,resolved,reporter(login),project(shortName,name)," +
+    "customFields(name,value(name,login,minutes,presentation)),comments(id)";
+export const WORK_ITEM_FIELDS = "id,date,duration(minutes,presentation),text,type(name),author(login,name)";
+//# sourceMappingURL=youtrack.js.map

package/dist/youtrack.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@tmcayden/youtrack-axi",
+  "version": "0.1.0",
+  "description": "Query, update, and log time against YouTrack issues from the shell",
+  "type": "module",
+  "bin": {
+    "youtrack-axi": "bin/youtrack-axi.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && vitest run && npm run skill:check",
+    "prepare": "npm run build",
+    "skill:build": "node scripts/skill.mjs",
+    "skill:check": "node scripts/skill.mjs --check"
+  },
+  "dependencies": {
+    "@toon-format/toon": "^2.1.0",
+    "axi-sdk-js": "0.1.11"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/tmcayden/youtrack-axi.git"
+  },
+  "homepage": "https://github.com/tmcayden/youtrack-axi#readme",
+  "bugs": {
+    "url": "https://github.com/tmcayden/youtrack-axi/issues"
+  }
+}