@tmcayden/youtrack-axi 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cayden Hunsaker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# youtrack-axi
+
+A YouTrack CLI built for agents rather than people. It follows the
+[AXI](https://skills.sh/kunchenguid/axi) standards - the copy of the spec this was
+built against is committed at `.pi/skills/axi/SKILL.md`.
+
+- **TOON on stdout**, roughly 40% cheaper than the equivalent JSON. The REST layer
+  stays on JSON; conversion happens only at the output boundary.
+- **Content first.** No arguments prints your open issues, not a manual.
+- **Errors are data.** They go to stdout, in TOON, with the command that fixes them.
+- **No prompts, ever.** Every operation is completable with flags alone.
+- **Time tracking**, which is the reason this exists: `work <ID> --log 1h30m`.
+
+## Install
+
+```sh
+npm install -g @tmcayden/youtrack-axi
+youtrack-axi --version
+```
+
+Or run it without installing:
+
+```sh
+npx -y @tmcayden/youtrack-axi
+```
+
+The bare name `youtrack-axi` is taken on npm by an unrelated author, so this is
+published under the `@tmcayden` scope. The binary is `youtrack-axi` either way.
+
+To work from a checkout instead:
+
+```sh
+npm install -g /path/to/youtrack-axi
+```
+
+## Configuration
+
+Credentials are read in this order:
+
+1. `YOUTRACK_URL` / `YOUTRACK_TOKEN` environment variables
+2. `$HARNESS_STATE_ROOT/.timesheet.json` (`youtrack_url`, `youtrack_token`)
+3. `~/.config/youtrack-axi/config.json`
+
+`setup` writes the dedicated file only when the shared one is absent, so it never
+shadows an existing setup:
+
+```sh
+youtrack-axi setup --url "https://example.youtrack.cloud" --token "<permanent-token>"
+youtrack-axi setup --verify
+```
+
+The token is never written to stdout, a log, or a commit. `setup --verify`
+confirms it works by naming the authenticated login instead.
+
+## Commands
+
+```sh
+youtrack-axi                                  # your open issues
+youtrack-axi issues "project: GSE #Unresolved" --limit 20
+youtrack-axi issues --assignee me --fields Priority,Type
+youtrack-axi view GSE-123 [--full]
+youtrack-axi create --project GSE --summary "..." [--description "..."]
+youtrack-axi comment GSE-123 "..."
+youtrack-axi cmd GSE-123 --command "in progress"
+youtrack-axi work GSE-123                     # read logged time
+youtrack-axi work GSE-123 --log 1h30m --date 2026-09-05 --type Development --text "..."
+youtrack-axi projects
+youtrack-axi fields GSE [--full]
+```
+
+Every subcommand takes `--help`. Exit codes are 0 for success including no-ops,
+1 for errors, 2 for usage errors.
+
+`cmd` is idempotent: applying a state an issue is already in reports a no-op and
+exits 0, and any real change is reported as a field-level diff.
+
+`work --log` needs time tracking enabled on the project and the create-work-item
+permission. When either is missing the CLI names which one it was, rather than
+passing along a bare 403.
+
+## Agent integration
+
+Two ways to give an agent this tool. You only need one.
+
+- **Session hook** - ambient, shows live state at every session start:
+  ```sh
+  youtrack-axi setup --hooks
+  ```
+  Installs a `SessionStart` hook for Claude Code, Codex, and OpenCode, pointing at
+  the binary on PATH when it resolves to this executable. Repeat runs are silent
+  no-ops and stale paths are repaired.
+- **Skill** - loads on demand, no per-session token cost:
+  `skills/youtrack-axi/SKILL.md`, generated from the CLI's own command specs.
+  `npm run skill:check` fails if it has drifted.
+  ```sh
+  npx skills add tmcayden/youtrack-axi --skill youtrack-axi
+  ```
+
+## Development
+
+```sh
+npm install
+npm test          # build, unit + end-to-end tests, skill freshness
+```
+
+The end-to-end suite runs the real binary against a stub YouTrack over HTTP and
+asserts on stdout, stderr, and exit codes - the same surface an agent sees.

package/bin/youtrack-axi.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { tryFastPath } from "axi-sdk-js/fast-path";
+import { VERSION } from "../dist/version.js";
+
+if (!tryFastPath(process.argv.slice(2), { version: VERSION })) {
+  const { main } = await import("../dist/cli.js");
+  await main();
+}

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+import { type CommandSpec } from "./flags.js";
+export declare const PACKAGE_NAME = "@tmcayden/youtrack-axi";
+export declare const DESCRIPTION = "Query, update, and log time against YouTrack issues";
+export declare const SPECS: CommandSpec[];
+export declare function main(): Promise<void>;

package/dist/cli.js

@@ -0,0 +1,91 @@
+import { runAxiCli } from "axi-sdk-js";
+import { renderError, renderOutput } from "./render.js";
+import { resolveConfig } from "./config.js";
+import { renderCommandHelp } from "./flags.js";
+import { ISSUE_LIST_FIELDS, YouTrackClient } from "./youtrack.js";
+import { VERSION } from "./version.js";
+import { DEFAULT_QUERY, issueListBody, issuesSpec, runIssues, runView, viewSpec } from "./commands/issues.js";
+import { cmdSpec, commentSpec, createSpec, runCmd, runComment, runCreate } from "./commands/mutate.js";
+import { runWork, workSpec } from "./commands/work.js";
+import { fieldsSpec, projectsSpec, runFields, runProjects } from "./commands/admin.js";
+import { runSetup, setupSpec } from "./commands/setup.js";
+export const PACKAGE_NAME = "@tmcayden/youtrack-axi";
+export const DESCRIPTION = "Query, update, and log time against YouTrack issues";
+const HOME_LIMIT = 15;
+export const SPECS = [
+    issuesSpec,
+    viewSpec,
+    createSpec,
+    commentSpec,
+    cmdSpec,
+    workSpec,
+    projectsSpec,
+    fieldsSpec,
+    setupSpec,
+];
+async function home(_args, client) {
+    const active = client;
+    const [issues, total] = await Promise.all([
+        active.get("issues", { query: DEFAULT_QUERY, fields: ISSUE_LIST_FIELDS, $top: HOME_LIMIT }),
+        active.countIssues(DEFAULT_QUERY),
+    ]);
+    return {
+        query: DEFAULT_QUERY,
+        ...issueListBody(issues, total, HOME_LIMIT),
+    };
+}
+function withClient(handler) {
+    return (args, client) => handler(args, client);
+}
+function topLevelHelp() {
+    return `${renderOutput({
+        tool: "youtrack-axi",
+        description: DESCRIPTION,
+        version: VERSION,
+        commands: SPECS.map((spec) => ({ command: spec.name, usage: spec.usage, description: spec.description })),
+        config: [
+            "Credentials come from $HARNESS_STATE_ROOT/.timesheet.json, then a dedicated config file",
+            "YOUTRACK_URL and YOUTRACK_TOKEN override both",
+        ],
+        help: [
+            "Run `youtrack-axi` with no arguments to see your open issues",
+            "Run `youtrack-axi <command> --help` for a command's flags and examples",
+        ],
+    })}\n`;
+}
+export async function main() {
+    await runAxiCli({
+        description: DESCRIPTION,
+        version: VERSION,
+        packageName: PACKAGE_NAME,
+        topLevelHelp: topLevelHelp(),
+        home,
+        commands: {
+            issues: withClient(runIssues),
+            view: withClient(runView),
+            create: withClient(runCreate),
+            comment: withClient(runComment),
+            cmd: withClient(runCmd),
+            work: withClient(runWork),
+            projects: withClient(runProjects),
+            fields: withClient(runFields),
+            setup: (args) => runSetup(args),
+        },
+        getCommandHelp: (command) => {
+            const spec = SPECS.find((candidate) => candidate.name === command);
+            return spec ? `${renderOutput(renderCommandHelp(spec))}\n` : null;
+        },
+        // `setup` must run before credentials exist, so context resolution - which
+        // requires them - is skipped for it and for pure help lookups.
+        resolveContext: ({ command, args }) => {
+            if (command === "setup" || args.includes("--help"))
+                return undefined;
+            return new YouTrackClient(resolveConfig());
+        },
+        renderUnknownCommand: (command) => `${renderError(`Unknown command: ${command}`, "VALIDATION_ERROR", [
+            `Valid commands: ${SPECS.map((spec) => spec.name).join(", ")}`,
+            "Run `youtrack-axi` with no arguments to see your open issues",
+        ])}\n`,
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/admin.d.ts

@@ -0,0 +1,7 @@
+import type { StructuredOutput } from "../render.js";
+import { type CommandSpec } from "../flags.js";
+import { YouTrackClient } from "../youtrack.js";
+export declare const projectsSpec: CommandSpec;
+export declare function runProjects(args: string[], client: YouTrackClient): Promise<StructuredOutput>;
+export declare const fieldsSpec: CommandSpec;
+export declare function runFields(args: string[], client: YouTrackClient): Promise<StructuredOutput>;

package/dist/commands/admin.js

@@ -0,0 +1,96 @@
+import { AxiError } from "axi-sdk-js";
+import { boolFlag, parseArgs, positiveInt, rejectExtraPositionals, requirePositional, } from "../flags.js";
+const DEFAULT_LIMIT = 100;
+const VALUE_PREVIEW_COUNT = 8;
+export const projectsSpec = {
+    name: "projects",
+    usage: "projects [--limit <n>]",
+    description: "List the projects this account can see",
+    flags: {
+        "--help": { kind: "boolean", description: "Show this help" },
+        "--limit": { kind: "string", description: "Maximum projects to return", default: String(DEFAULT_LIMIT) },
+    },
+    examples: ["youtrack-axi projects"],
+};
+export async function runProjects(args, client) {
+    const parsed = parseArgs(projectsSpec, args);
+    rejectExtraPositionals(parsed, projectsSpec, 0);
+    const limit = positiveInt(parsed, projectsSpec, "--limit", DEFAULT_LIMIT);
+    const projects = await client.get("admin/projects", {
+        fields: "shortName,name,archived",
+        $top: limit,
+    });
+    const active = projects.filter((p) => !p.archived);
+    if (active.length === 0) {
+        return {
+            projects: "0 active projects visible to this account",
+            help: ["Ask a YouTrack administrator to grant this account project access"],
+        };
+    }
+    return {
+        count: active.length,
+        projects: active.map((p) => ({ short: p.shortName ?? "", name: p.name ?? "" })),
+        help: [
+            'Run `youtrack-axi issues "project: <SHORT> #Unresolved"` to list a project\'s open issues',
+            "Run `youtrack-axi fields <SHORT>` to see a project's custom fields",
+        ],
+    };
+}
+export const fieldsSpec = {
+    name: "fields",
+    usage: "fields <SHORT> [--full]",
+    description: "List a project's custom fields and their allowed values",
+    flags: {
+        "--help": { kind: "boolean", description: "Show this help" },
+        "--full": { kind: "boolean", description: "List every allowed value instead of the first few" },
+    },
+    examples: ["youtrack-axi fields GSE", "youtrack-axi fields GSE --full"],
+};
+export async function runFields(args, client) {
+    const parsed = parseArgs(fieldsSpec, args);
+    const shortName = requirePositional(parsed, fieldsSpec, 0, "<SHORT>");
+    rejectExtraPositionals(parsed, fieldsSpec, 1);
+    const full = boolFlag(parsed, "--full");
+    const projects = await client.get("admin/projects", {
+        fields: "id,shortName",
+        $top: 500,
+    });
+    const project = projects.find((p) => p.shortName?.toLowerCase() === shortName.toLowerCase());
+    if (!project?.id) {
+        throw new AxiError(`No project with short name ${shortName}`, "NOT_FOUND", [
+            "Run `youtrack-axi projects` to list valid short names",
+        ]);
+    }
+    const fields = await client.get(`admin/projects/${project.id}/customFields`, {
+        fields: "canBeEmpty,field(name,fieldType(valueType)),bundle(values(name))",
+        $top: 100,
+    });
+    if (fields.length === 0) {
+        return { fields: `0 custom fields configured on ${shortName}` };
+    }
+    let anyTruncated = false;
+    const rows = fields.map((f) => {
+        const values = (f.bundle?.values ?? []).map((v) => v.name ?? "").filter(Boolean);
+        const shown = full ? values : values.slice(0, VALUE_PREVIEW_COUNT);
+        if (shown.length < values.length)
+            anyTruncated = true;
+        return {
+            name: f.field?.name ?? "",
+            type: f.field?.fieldType?.valueType ?? "",
+            required: f.canBeEmpty === false ? "yes" : "no",
+            values: shown.join(" | "),
+            value_count: values.length,
+        };
+    });
+    return {
+        project: shortName,
+        count: fields.length,
+        fields: rows,
+        help: [
+            ...(anyTruncated ? [`Run \`youtrack-axi fields ${shortName} --full\` to see every allowed value`] : []),
+            `Run \`youtrack-axi issues "project: ${shortName} State: {<value>}"\` to filter by a field value`,
+            `Run \`youtrack-axi cmd <ID> --command "<field> <value>"\` to set one`,
+        ],
+    };
+}
+//# sourceMappingURL=admin.js.map

package/dist/commands/admin.js.map

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

package/dist/commands/issues.d.ts

@@ -0,0 +1,10 @@
+import type { StructuredOutput } from "../render.js";
+import { parseArgs, type CommandSpec } from "../flags.js";
+import { type Issue, YouTrackClient } from "../youtrack.js";
+export declare const DEFAULT_QUERY = "for:me #Unresolved";
+export declare const issuesSpec: CommandSpec;
+export declare function buildQuery(parsed: ReturnType<typeof parseArgs>): string;
+export declare function runIssues(args: string[], client: YouTrackClient): Promise<StructuredOutput>;
+export declare function issueListBody(issues: Issue[], total: number | undefined, limit: number, extraFields?: string[]): StructuredOutput;
+export declare const viewSpec: CommandSpec;
+export declare function runView(args: string[], client: YouTrackClient): Promise<StructuredOutput>;

package/dist/commands/issues.js

@@ -0,0 +1,117 @@
+import { boolFlag, optionalString, parseArgs, positiveInt, rejectExtraPositionals, requirePositional, } from "../flags.js";
+import { DESCRIPTION_PREVIEW_CHARS, flattenCustomFields, formatDate, issueRow, issueRowWithFields, splitFieldList, truncate, } from "../format.js";
+import { ISSUE_DETAIL_FIELDS, ISSUE_LIST_FIELDS } from "../youtrack.js";
+export const DEFAULT_QUERY = "for:me #Unresolved";
+const DEFAULT_LIMIT = 50;
+export const issuesSpec = {
+    name: "issues",
+    usage: 'issues ["<query>"] [--project <SHORT>] [--state <state>] [--assignee <login>] [--fields <a,b>] [--limit <n>]',
+    description: "List issues matching a YouTrack query",
+    flags: {
+        "--help": { kind: "boolean", description: "Show this help" },
+        "--project": { kind: "string", description: "Restrict to a project short name" },
+        "--state": { kind: "string", description: "Restrict to a State value" },
+        "--assignee": { kind: "string", description: "Restrict to an assignee login, or `me`" },
+        "--fields": { kind: "string", description: "Extra custom fields to add as columns, comma separated" },
+        "--limit": { kind: "string", description: "Maximum rows to return", default: String(DEFAULT_LIMIT) },
+    },
+    examples: [
+        "youtrack-axi issues",
+        'youtrack-axi issues "project: GSE #Unresolved" --limit 20',
+        "youtrack-axi issues --assignee me --state Open --fields Priority,Type",
+    ],
+};
+export function buildQuery(parsed) {
+    const clauses = [];
+    const positional = parsed.positionals[0];
+    if (positional)
+        clauses.push(positional);
+    const project = optionalString(parsed, "--project");
+    if (project)
+        clauses.push(`project: ${project}`);
+    const state = optionalString(parsed, "--state");
+    if (state)
+        clauses.push(`State: {${state}}`);
+    const assignee = optionalString(parsed, "--assignee");
+    if (assignee)
+        clauses.push(assignee === "me" ? "for: me" : `Assignee: ${assignee}`);
+    return clauses.length > 0 ? clauses.join(" ") : DEFAULT_QUERY;
+}
+export async function runIssues(args, client) {
+    const parsed = parseArgs(issuesSpec, args);
+    rejectExtraPositionals(parsed, issuesSpec, 1);
+    const limit = positiveInt(parsed, issuesSpec, "--limit", DEFAULT_LIMIT);
+    const extraFields = splitFieldList(optionalString(parsed, "--fields"));
+    const query = buildQuery(parsed);
+    const fields = extraFields.length > 0 ? `${ISSUE_LIST_FIELDS},project(shortName),reporter(login),created,updated` : ISSUE_LIST_FIELDS;
+    const [issues, total] = await Promise.all([
+        client.get("issues", { query, fields, $top: limit }),
+        client.countIssues(query),
+    ]);
+    return {
+        query,
+        ...issueListBody(issues, total, limit, extraFields),
+    };
+}
+export function issueListBody(issues, total, limit, extraFields = []) {
+    if (issues.length === 0) {
+        return {
+            issues: "0 issues match this query",
+            help: [
+                'Widen the query, e.g. `youtrack-axi issues "#Unresolved"`',
+                "Run `youtrack-axi projects` to see the projects you can search",
+            ],
+        };
+    }
+    const rows = extraFields.length > 0 ? issues.map((i) => issueRowWithFields(i, extraFields)) : issues.map(issueRow);
+    const help = ["Run `youtrack-axi view <ID>` for full detail", "Run `youtrack-axi work <ID> --log 1h` to log time"];
+    if (total !== undefined && total > issues.length) {
+        help.unshift(`Showing ${issues.length} of ${total}; re-run with \`--limit ${Math.min(total, 500)}\` to see them all`);
+    }
+    return {
+        count: total === undefined ? `${issues.length}` : `${issues.length} of ${total} total`,
+        issues: rows,
+        help,
+    };
+}
+export const viewSpec = {
+    name: "view",
+    usage: "view <ID> [--full]",
+    description: "Show one issue in full detail",
+    flags: {
+        "--help": { kind: "boolean", description: "Show this help" },
+        "--full": { kind: "boolean", description: "Print the complete description instead of a preview" },
+    },
+    examples: ["youtrack-axi view GSE-123", "youtrack-axi view GSE-123 --full"],
+};
+export async function runView(args, client) {
+    const parsed = parseArgs(viewSpec, args);
+    const id = requirePositional(parsed, viewSpec, 0, "<ID>");
+    rejectExtraPositionals(parsed, viewSpec, 1);
+    const full = boolFlag(parsed, "--full");
+    const issue = await client.get(`issues/${encodeURIComponent(id)}`, { fields: ISSUE_DETAIL_FIELDS });
+    const fields = flattenCustomFields(issue.customFields);
+    const description = truncate(issue.description, full ? Number.MAX_SAFE_INTEGER : DESCRIPTION_PREVIEW_CHARS);
+    const populated = Object.fromEntries(Object.entries(fields).filter(([, value]) => value.length > 0));
+    return {
+        issue: {
+            id: issue.idReadable ?? id,
+            summary: issue.summary ?? "",
+            project: issue.project?.shortName ?? "",
+            reporter: issue.reporter?.login ?? "",
+            created: issue.created ? formatDate(issue.created) : "",
+            updated: issue.updated ? formatDate(issue.updated) : "",
+            resolved: issue.resolved ? formatDate(issue.resolved) : "no",
+            comments: issue.comments?.length ?? 0,
+            ...populated,
+            description: description.text.length > 0 ? description.text : "(empty)",
+            ...(description.truncated
+                ? { description_note: `truncated, ${description.totalChars} chars total` }
+                : {}),
+        },
+        ...(description.truncated
+            ? { help: [`Run \`youtrack-axi view ${issue.idReadable ?? id} --full\` to see the complete description`] }
+            : {}),
+    };
+}
+//# sourceMappingURL=issues.js.map

package/dist/commands/issues.js.map

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

package/dist/commands/mutate.d.ts

@@ -0,0 +1,9 @@
+import type { StructuredOutput } from "../render.js";
+import { type CommandSpec } from "../flags.js";
+import { YouTrackClient } from "../youtrack.js";
+export declare const createSpec: CommandSpec;
+export declare function runCreate(args: string[], client: YouTrackClient): Promise<StructuredOutput>;
+export declare const commentSpec: CommandSpec;
+export declare function runComment(args: string[], client: YouTrackClient): Promise<StructuredOutput>;
+export declare const cmdSpec: CommandSpec;
+export declare function runCmd(args: string[], client: YouTrackClient): Promise<StructuredOutput>;

package/dist/commands/mutate.js

@@ -0,0 +1,115 @@
+import { optionalString, parseArgs, rejectExtraPositionals, requirePositional, requireString, } from "../flags.js";
+import { flattenCustomFields, truncate } from "../format.js";
+export const createSpec = {
+    name: "create",
+    usage: 'create --project <SHORT> --summary "<text>" [--description "<text>"]',
+    description: "Create a new issue in a project",
+    flags: {
+        "--help": { kind: "boolean", description: "Show this help" },
+        "--project": { kind: "string", description: "Project short name, e.g. GSE" },
+        "--summary": { kind: "string", description: "Issue summary line" },
+        "--description": { kind: "string", description: "Issue description body" },
+    },
+    examples: [
+        'youtrack-axi create --project GSE --summary "Fix map zoom regression"',
+        'youtrack-axi create --project GSE --summary "Add audit log" --description "Track who changed what."',
+    ],
+};
+export async function runCreate(args, client) {
+    const parsed = parseArgs(createSpec, args);
+    rejectExtraPositionals(parsed, createSpec, 0);
+    const project = requireString(parsed, createSpec, "--project");
+    const summary = requireString(parsed, createSpec, "--summary");
+    const description = optionalString(parsed, "--description");
+    const created = await client.post("issues", { project: { shortName: project }, summary, ...(description ? { description } : {}) }, { fields: "idReadable,summary,project(shortName)" });
+    const id = created.idReadable ?? "";
+    return {
+        created: {
+            id,
+            summary: created.summary ?? summary,
+            project: created.project?.shortName ?? project,
+            url: `${client.baseUrl}/issue/${id}`,
+        },
+        help: [
+            `Run \`youtrack-axi cmd ${id} --command "<command>"\` to set state or assignee`,
+            `Run \`youtrack-axi work ${id} --log <duration>\` to log time against it`,
+        ],
+    };
+}
+export const commentSpec = {
+    name: "comment",
+    usage: 'comment <ID> "<text>"',
+    description: "Add a comment to an issue",
+    flags: {
+        "--help": { kind: "boolean", description: "Show this help" },
+    },
+    examples: [
+        'youtrack-axi comment GSE-123 "Deployed to staging, ready for QA."',
+    ],
+};
+export async function runComment(args, client) {
+    const parsed = parseArgs(commentSpec, args);
+    const id = requirePositional(parsed, commentSpec, 0, "<ID>");
+    const text = requirePositional(parsed, commentSpec, 1, "comment text");
+    rejectExtraPositionals(parsed, commentSpec, 2);
+    const comment = await client.post(`issues/${encodeURIComponent(id)}/comments`, { text }, { fields: "id" });
+    return {
+        commented: {
+            issue: id,
+            id: comment.id ?? "",
+            preview: truncate(text, 120).text,
+        },
+        help: [`Run \`youtrack-axi view ${id}\` to see the issue's current state`],
+    };
+}
+export const cmdSpec = {
+    name: "cmd",
+    usage: 'cmd <ID> --command "<youtrack command>"',
+    description: "Apply a YouTrack command to an issue, such as a state or assignee change",
+    flags: {
+        "--help": { kind: "boolean", description: "Show this help" },
+        "--command": { kind: "string", description: "YouTrack command string" },
+        "--comment": { kind: "string", description: "Comment to add alongside the command" },
+    },
+    examples: [
+        'youtrack-axi cmd GSE-123 --command "in progress"',
+        'youtrack-axi cmd GSE-123 --command "for me"',
+        'youtrack-axi cmd GSE-123 --command "State Fixed" --comment "Shipped in 2.4.1"',
+    ],
+};
+const CMD_STATE_FIELDS = "customFields(name,value(name,login))";
+export async function runCmd(args, client) {
+    const parsed = parseArgs(cmdSpec, args);
+    const id = requirePositional(parsed, cmdSpec, 0, "<ID>");
+    rejectExtraPositionals(parsed, cmdSpec, 1);
+    const command = requireString(parsed, cmdSpec, "--command");
+    const comment = optionalString(parsed, "--comment");
+    const before = await readFields(client, id);
+    await client.post("commands", {
+        query: command,
+        issues: [{ idReadable: id }],
+        ...(comment ? { comment } : {}),
+    });
+    const after = await readFields(client, id);
+    const changes = Object.keys({ ...before, ...after })
+        .filter((name) => (before[name] ?? "") !== (after[name] ?? ""))
+        .map((name) => ({ field: name, from: before[name] ?? "", to: after[name] ?? "" }));
+    if (changes.length === 0) {
+        return {
+            applied: {
+                issue: id,
+                command,
+                result: comment ? "no field change; comment added" : "no-op, issue already in that state",
+            },
+        };
+    }
+    return {
+        applied: { issue: id, command },
+        changes,
+    };
+}
+async function readFields(client, id) {
+    const issue = await client.get(`issues/${encodeURIComponent(id)}`, { fields: CMD_STATE_FIELDS });
+    return flattenCustomFields(issue.customFields);
+}
+//# sourceMappingURL=mutate.js.map

package/dist/commands/mutate.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,4 @@
+import { type StructuredOutput } from "../render.js";
+import { type CommandSpec } from "../flags.js";
+export declare const setupSpec: CommandSpec;
+export declare function runSetup(args: string[]): Promise<StructuredOutput>;