jirallm 0.1.0 → 0.2.0

package/README.md

@@ -9,13 +9,13 @@ Export Jira Cloud issues as LLM-ready context bundles — markdown, attachments,
 
 ## Why it exists
 
-Pasting Jira tickets into an LLM is painful: descriptions are ADF (Atlassian Document Format), comments live in a separate API, attachments are URLs behind auth, and video recordings are useless to a text model. `jirallm` turns a Jira issue (or a JQL query) into a self-contained folder of clean markdown plus extracted media — ready to drop into Claude, ChatGPT, Cursor, or any RAG pipeline.
+Pasting Jira tickets into an LLM is painful: descriptions are ADF (Atlassian Document Format), comments live in a separate API, attachments are URLs behind auth, and video recordings are useless to a text model. `jirallm` turns a Jira issue into a self-contained folder of clean markdown plus extracted media — ready to drop into Claude, ChatGPT, Cursor, or any RAG pipeline.
 
 It exists because every team that uses Jira + LLMs ends up writing the same brittle scraping script. This is the version you wish you had.
 
 ## Features
 
-- Export a single issue or a JQL result set into a structured folder
+- Export one or more issues by key into a structured folder
 - Renders Jira ADF descriptions and comments to clean Markdown
 - Downloads all attachments with original filenames (auth handled)
 - Extracts frames from attached videos via `ffmpeg` and deduplicates near-identical frames using `pixelmatch`
@@ -41,6 +41,15 @@ pnpm add -g jirallm
 pnpm add jirallm
 ```
 
+### Updating
+
+`jirallm` checks for new versions once a day in the background and prints a notice on the next invocation. To upgrade:
+
+```bash
+jirallm upgrade           # auto-detects npm / pnpm / yarn / Homebrew
+jirallm upgrade --check   # just report whether an update is available
+```
+
 ## Configuration
 
 The recommended way to configure `jirallm` is the interactive wizard:
@@ -83,8 +92,8 @@ user_email = "user@acme.example"
 [orgs.acme.projects.PROJ]
 output_dir = "~/jira/acme/proj"
 
-[orgs.acme.projects.CORE]
-output_dir = "~/jira/acme/core"
+[orgs.acme.projects.DOCS]
+output_dir = "~/jira/acme/docs"
 
 [orgs.acme.projects.LIB]
 ```
@@ -167,11 +176,11 @@ jira-export/
 import { JiraExporter, loadProfile } from 'jirallm';
 
 // Resolve an org/project (config file + keychain), with the same precedence as the CLI
-const { config, apiToken, org, project } = await loadProfile({ org: 'acme', project: 'CORE' });
+const { config, apiToken, org, project } = await loadProfile({ org: 'acme', project: 'DOCS' });
 
 const exporter = new JiraExporter(config, apiToken);
 
-const result = await exporter.exportIssues(['CIT-123'], {
+const result = await exporter.exportIssues(['DOCS-123'], {
   outputDir: project.outputDir ?? './jira-export',
   includeSubtasks: org.includeSubtasks ?? false,
   videoFrames: { enabled: true, fps: 5, maxFrames: 10 },
@@ -191,11 +200,80 @@ jirallm PROJ-123 PROJ-124 --output-dir ./triage-bundle
 cat ./triage-bundle/PROJ-123/index.md | pbcopy
 ```
 
+## For agents (CLI commands)
+
+Every read command supports `--json` (and automatically switches to JSON when stdout is not a TTY), so they're safe to pipe into `jq` or feed back into an agent. Every write command supports `--dry-run`.
+
+Discovery & search:
+
+```bash
+jirallm me --org acme --json
+jirallm projects --org acme --json
+jirallm boards --org acme --project PROJ --json
+jirallm sprints 123 --org acme --state active --json
+jirallm issuetypes --org acme --project PROJ --json
+jirallm linktypes --org acme --json
+jirallm search 'assignee = currentUser() AND statusCategory != Done' --org acme --limit 25 --json
+jirallm fetch PROJ-123 --json
+jirallm transition PROJ-123 --list --json
+```
+
+Mutations (all accept `--dry-run`):
+
+```bash
+jirallm comment PROJ-123 --file ./summary.md
+jirallm transition PROJ-123 --to "In Review"
+jirallm worklog -f ./worklogs.json
+jirallm create --org acme --project PROJ --type Task --summary "Spike" --description-file ./spike.md
+jirallm edit PROJ-123 --labels a,b --priority High
+jirallm assign PROJ-123 me
+jirallm link PROJ-1 "blocks" PROJ-2 --comment "blocked by infra work"
+jirallm link:rm 10042 --org acme
+jirallm attach PROJ-123 ./screenshot.png ./recording.mp4
+jirallm attach:rm 99021 --org acme
+jirallm watchers PROJ-123 --add me
+```
+
+## Library usage
+
+The package re-exports `JiraClient` plus all the domain types so you can drive Jira directly from your own TypeScript:
+
+```ts
+import { JiraClient, loadProfile } from 'jirallm';
+
+const { config, apiToken } = await loadProfile({ org: 'acme' });
+const client = new JiraClient(config, apiToken);
+
+// Search (single page; pass nextPageToken for the next one)
+const page = await client.searchIssues('project = PROJ AND statusCategory != Done', {
+  fields: ['summary', 'status'],
+  limit: 50,
+});
+
+// Create + comment
+const created = await client.createIssue({
+  projectKey: 'PROJ',
+  issueType: 'Task',
+  summary: 'Investigate flaky test',
+  descriptionMarkdown: '**Repro**\n\n1. step\n2. step',
+});
+await client.addComment(created.key, 'Auto-filed from triage script.');
+```
+
+See `examples/` for runnable scripts:
+
+- `examples/search-my-issues.ts` — paginated JQL
+- `examples/create-bug.ts` — create + comment
+- `examples/board-snapshot.ts` — boards → sprints → issues
+
 ## Platform support
 
-- macOS — fully supported
-- Linux — fully supported
-- Windows — should work; `ffmpeg` must be on `PATH`
+Native binaries (via [`@napi-rs/keyring`](https://www.npmjs.com/package/@napi-rs/keyring)) ship prebuilt — no compile step on install.
+
+- **macOS** (arm64, x64) — fully supported. Tokens stored in macOS Keychain.
+- **Linux** (x64, arm64, arm, riscv64; glibc and musl) — fully supported. Tokens stored via Secret Service (`libsecret`); requires a running keyring daemon (e.g. `gnome-keyring` or KWallet). Headless servers without a keyring backend will fail the keychain step in `jirallm doctor`.
+- **Windows** (x64, arm64, ia32) — fully supported. Tokens stored in Windows Credential Manager. `ffmpeg` must be on `PATH` for video frame extraction.
+- **FreeBSD** (x64) — keychain works; other features untested.
 
 ## Contributing
 

package/dist/cli/commands/assign.d.ts

@@ -0,0 +1,9 @@
+export type AssignOptions = {
+    issueKey: string;
+    assignee: string;
+    org?: string;
+    dryRun?: boolean;
+    json?: boolean;
+};
+export declare function runAssign(opts: AssignOptions): Promise<void>;
+//# sourceMappingURL=assign.d.ts.map

package/dist/cli/commands/assign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assign.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/assign.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BlE"}

package/dist/cli/commands/assign.js

@@ -0,0 +1,37 @@
+import { loadProfile } from '../../lib/config.js';
+import { JiraClient } from '../../lib/jiraClient.js';
+import { parseIssueKey } from '../issueKey.js';
+import { resolveOrg } from '../resolveOrg.js';
+import { printJson, shouldOutputJson } from '../jsonOutput.js';
+export async function runAssign(opts) {
+    const parsed = parseIssueKey(opts.issueKey);
+    const org = resolveOrg(parsed.org, opts.org, parsed.projectKey);
+    const profile = await loadProfile({ org, project: parsed.projectKey });
+    const client = new JiraClient(profile.config, profile.apiToken);
+    let accountId;
+    if (opts.assignee === 'none' || opts.assignee === '-') {
+        accountId = null;
+    }
+    else if (opts.assignee === 'me') {
+        const me = await client.getCurrentUser();
+        accountId = me.accountId;
+    }
+    else {
+        accountId = opts.assignee;
+    }
+    if (opts.dryRun) {
+        const payload = { dryRun: true, issueKey: parsed.key, accountId };
+        if (shouldOutputJson(opts))
+            printJson(payload);
+        else
+            console.log(`Dry run — would assign ${parsed.key} to ${accountId ?? 'none'}`);
+        return;
+    }
+    await client.assignIssue(parsed.key, accountId);
+    if (shouldOutputJson(opts)) {
+        printJson({ issueKey: parsed.key, accountId });
+        return;
+    }
+    console.log(`✓ ${parsed.key} assigned to ${accountId ?? 'nobody'}`);
+}
+//# sourceMappingURL=assign.js.map

package/dist/cli/commands/assign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assign.js","sourceRoot":"","sources":["../../../src/cli/commands/assign.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAU/D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhE,IAAI,SAAwB,CAAC;IAC7B,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,GAAG,EAAE,CAAC;QACtD,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;QACzC,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC5B,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC;QAClE,IAAI,gBAAgB,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,OAAO,CAAC,CAAC;;YAC1C,OAAO,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,GAAG,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC;QACnF,OAAO;IACT,CAAC;IAED,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAEhD,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,GAAG,gBAAgB,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/cli/commands/assign.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=assign.test.d.ts.map

package/dist/cli/commands/assign.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assign.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/assign.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/assign.test.js

@@ -0,0 +1,69 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('../../lib/config.js', () => ({
+    loadProfile: vi.fn(async () => ({
+        config: { baseUrl: 'https://x', userEmail: 'u@x', projectKey: 'PROJ' },
+        apiToken: 'tok',
+    })),
+    findOrgsByProjectKey: vi.fn(() => ['solo']),
+}));
+const assignIssueMock = vi.fn();
+const getCurrentUserMock = vi.fn();
+vi.mock('../../lib/jiraClient.js', () => ({
+    JiraClient: class {
+        assignIssue = assignIssueMock;
+        getCurrentUser = getCurrentUserMock;
+    },
+}));
+import { runAssign } from './assign.js';
+let logs;
+let writes;
+const originalIsTTY = process.stdout.isTTY;
+beforeEach(() => {
+    logs = [];
+    writes = [];
+    vi.spyOn(console, 'log').mockImplementation((...a) => { logs.push(a.map(String).join(' ')); });
+    vi.spyOn(process.stdout, 'write').mockImplementation((c) => { writes.push(String(c)); return true; });
+    assignIssueMock.mockReset();
+    getCurrentUserMock.mockReset();
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, configurable: true });
+});
+describe('runAssign', () => {
+    it('resolves "me" to current user accountId', async () => {
+        getCurrentUserMock.mockResolvedValue({ accountId: 'acc-me', displayName: 'Me' });
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAssign({ issueKey: 'PROJ-1', assignee: 'me' });
+        expect(assignIssueMock).toHaveBeenCalledWith('PROJ-1', 'acc-me');
+    });
+    it('resolves "none" to null (unassign)', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAssign({ issueKey: 'PROJ-1', assignee: 'none' });
+        expect(assignIssueMock).toHaveBeenCalledWith('PROJ-1', null);
+        expect(getCurrentUserMock).not.toHaveBeenCalled();
+    });
+    it('treats "-" as unassign sugar', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAssign({ issueKey: 'PROJ-1', assignee: '-' });
+        expect(assignIssueMock).toHaveBeenCalledWith('PROJ-1', null);
+    });
+    it('passes through a literal accountId', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAssign({ issueKey: 'PROJ-1', assignee: 'acc-42' });
+        expect(assignIssueMock).toHaveBeenCalledWith('PROJ-1', 'acc-42');
+    });
+    it('does NOT call assignIssue on --dry-run', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAssign({ issueKey: 'PROJ-1', assignee: 'acc-1', dryRun: true, json: true });
+        expect(assignIssueMock).not.toHaveBeenCalled();
+        const parsed = JSON.parse(writes.join(''));
+        expect(parsed).toEqual({ dryRun: true, issueKey: 'PROJ-1', accountId: 'acc-1' });
+    });
+    it('emits {issueKey, accountId} JSON on success', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAssign({ issueKey: 'PROJ-1', assignee: 'acc-1', json: true });
+        expect(JSON.parse(writes.join(''))).toEqual({ issueKey: 'PROJ-1', accountId: 'acc-1' });
+    });
+});
+//# sourceMappingURL=assign.test.js.map

package/dist/cli/commands/assign.test.js.map

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

package/dist/cli/commands/attach.d.ts

@@ -0,0 +1,16 @@
+export type AttachOptions = {
+    issueKey: string;
+    files: string[];
+    org?: string;
+    dryRun?: boolean;
+    json?: boolean;
+};
+export declare function runAttach(opts: AttachOptions): Promise<void>;
+export type AttachRemoveOptions = {
+    attachmentId: string;
+    org: string;
+    dryRun?: boolean;
+    json?: boolean;
+};
+export declare function runAttachRemove(opts: AttachRemoveOptions): Promise<void>;
+//# sourceMappingURL=attach.d.ts.map

package/dist/cli/commands/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/attach.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BlE;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9E"}

package/dist/cli/commands/attach.js

@@ -0,0 +1,52 @@
+import { loadProfile } from '../../lib/config.js';
+import { JiraClient } from '../../lib/jiraClient.js';
+import { parseIssueKey } from '../issueKey.js';
+import { resolveOrg } from '../resolveOrg.js';
+import { printJson, shouldOutputJson } from '../jsonOutput.js';
+export async function runAttach(opts) {
+    const parsed = parseIssueKey(opts.issueKey);
+    const org = resolveOrg(parsed.org, opts.org, parsed.projectKey);
+    const profile = await loadProfile({ org, project: parsed.projectKey });
+    if (opts.dryRun) {
+        const payload = { dryRun: true, issueKey: parsed.key, files: opts.files };
+        if (shouldOutputJson(opts))
+            printJson(payload);
+        else
+            console.log(`Dry run — would attach ${opts.files.length} file(s) to ${parsed.key}:\n  ${opts.files.join('\n  ')}`);
+        return;
+    }
+    const client = new JiraClient(profile.config, profile.apiToken);
+    const uploaded = [];
+    for (const file of opts.files) {
+        const result = await client.uploadAttachment(parsed.key, file);
+        for (const a of result)
+            uploaded.push(a);
+    }
+    if (shouldOutputJson(opts)) {
+        printJson({ issueKey: parsed.key, attachments: uploaded });
+        return;
+    }
+    console.log(`✓ Uploaded ${uploaded.length} attachment(s) to ${parsed.key}:`);
+    for (const a of uploaded) {
+        console.log(`  [${a.id}] ${a.filename} (${a.size}b)`);
+    }
+}
+export async function runAttachRemove(opts) {
+    if (opts.dryRun) {
+        const payload = { dryRun: true, attachmentId: opts.attachmentId };
+        if (shouldOutputJson(opts))
+            printJson(payload);
+        else
+            console.log(`Dry run — would delete attachment ${opts.attachmentId}`);
+        return;
+    }
+    const profile = await loadProfile({ org: opts.org });
+    const client = new JiraClient(profile.config, profile.apiToken);
+    await client.deleteAttachment(opts.attachmentId);
+    if (shouldOutputJson(opts)) {
+        printJson({ attachmentId: opts.attachmentId, removed: true });
+        return;
+    }
+    console.log(`✓ Removed attachment ${opts.attachmentId}`);
+}
+//# sourceMappingURL=attach.js.map

package/dist/cli/commands/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../../src/cli/commands/attach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAU/D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAEvE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1E,IAAI,gBAAgB,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,OAAO,CAAC,CAAC;;YAC1C,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,CAAC,KAAK,CAAC,MAAM,eAAe,MAAM,CAAC,GAAG,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxH,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,QAAQ,GAA0D,EAAE,CAAC;IAC3E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/D,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,MAAM,qBAAqB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IAC7E,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAyB;IAC7D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClE,IAAI,gBAAgB,CAAC,IAAI,CAAC;YAAE,SAAS,CAAC,OAAO,CAAC,CAAC;;YAC1C,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/dist/cli/commands/attach.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=attach.test.d.ts.map

package/dist/cli/commands/attach.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/attach.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/attach.test.js

@@ -0,0 +1,92 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+vi.mock('../../lib/config.js', () => ({
+    loadProfile: vi.fn(async () => ({
+        config: { baseUrl: 'https://x', userEmail: 'u@x', projectKey: 'PROJ' },
+        apiToken: 'tok',
+    })),
+    findOrgsByProjectKey: vi.fn(() => ['solo']),
+}));
+const uploadAttachmentMock = vi.fn();
+const deleteAttachmentMock = vi.fn();
+vi.mock('../../lib/jiraClient.js', () => ({
+    JiraClient: class {
+        uploadAttachment = uploadAttachmentMock;
+        deleteAttachment = deleteAttachmentMock;
+    },
+}));
+import { runAttach, runAttachRemove } from './attach.js';
+let logs;
+let writes;
+const originalIsTTY = process.stdout.isTTY;
+beforeEach(() => {
+    logs = [];
+    writes = [];
+    vi.spyOn(console, 'log').mockImplementation((...a) => { logs.push(a.map(String).join(' ')); });
+    vi.spyOn(process.stdout, 'write').mockImplementation((c) => { writes.push(String(c)); return true; });
+    uploadAttachmentMock.mockReset();
+    deleteAttachmentMock.mockReset();
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    Object.defineProperty(process.stdout, 'isTTY', { value: originalIsTTY, configurable: true });
+});
+describe('runAttach', () => {
+    it('uploads each file sequentially and aggregates results', async () => {
+        uploadAttachmentMock
+            .mockResolvedValueOnce([{ id: 'a1', filename: 'a.png', size: 10 }])
+            .mockResolvedValueOnce([{ id: 'b1', filename: 'b.txt', size: 5 }]);
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAttach({
+            issueKey: 'PROJ-1',
+            files: ['./a.png', './b.txt'],
+            json: true,
+        });
+        expect(uploadAttachmentMock).toHaveBeenCalledTimes(2);
+        expect(uploadAttachmentMock).toHaveBeenNthCalledWith(1, 'PROJ-1', './a.png');
+        expect(uploadAttachmentMock).toHaveBeenNthCalledWith(2, 'PROJ-1', './b.txt');
+        const parsed = JSON.parse(writes.join(''));
+        expect(parsed.issueKey).toBe('PROJ-1');
+        expect(parsed.attachments).toHaveLength(2);
+    });
+    it('does NOT call uploadAttachment on --dry-run', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAttach({
+            issueKey: 'PROJ-1',
+            files: ['./a.png'],
+            dryRun: true,
+            json: true,
+        });
+        expect(uploadAttachmentMock).not.toHaveBeenCalled();
+        const parsed = JSON.parse(writes.join(''));
+        expect(parsed).toEqual({ dryRun: true, issueKey: 'PROJ-1', files: ['./a.png'] });
+    });
+    it('prints per-attachment summary on TTY', async () => {
+        uploadAttachmentMock.mockResolvedValueOnce([
+            { id: 'a1', filename: 'a.png', size: 10 },
+        ]);
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAttach({ issueKey: 'PROJ-1', files: ['./a.png'] });
+        const out = logs.join('\n');
+        expect(out).toContain('Uploaded 1 attachment(s)');
+        expect(out).toContain('[a1] a.png (10b)');
+    });
+});
+describe('runAttachRemove', () => {
+    it('calls deleteAttachment with the id', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAttachRemove({ attachmentId: 'att-9', org: 'acme' });
+        expect(deleteAttachmentMock).toHaveBeenCalledWith('att-9');
+    });
+    it('does NOT call deleteAttachment on --dry-run', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAttachRemove({ attachmentId: 'att-9', org: 'acme', dryRun: true, json: true });
+        expect(deleteAttachmentMock).not.toHaveBeenCalled();
+        expect(JSON.parse(writes.join(''))).toEqual({ dryRun: true, attachmentId: 'att-9' });
+    });
+    it('emits {attachmentId, removed:true} when --json after success', async () => {
+        Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+        await runAttachRemove({ attachmentId: 'att-9', org: 'acme', json: true });
+        expect(JSON.parse(writes.join(''))).toEqual({ attachmentId: 'att-9', removed: true });
+    });
+});
+//# sourceMappingURL=attach.test.js.map

package/dist/cli/commands/attach.test.js.map

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

package/dist/cli/commands/board.d.ts

@@ -0,0 +1,10 @@
+export type BoardIssuesOptions = {
+    board: string;
+    column: string;
+    org: string;
+    project?: string;
+    assignee?: string;
+    json?: boolean;
+};
+export declare function runBoardIssues(opts: BoardIssuesOptions): Promise<void>;
+//# sourceMappingURL=board.d.ts.map

package/dist/cli/commands/board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/board.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAUF,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8D5E"}

package/dist/cli/commands/board.js

@@ -0,0 +1,54 @@
+import { loadProfile } from '../../lib/config.js';
+import { JiraClient } from '../../lib/jiraClient.js';
+export async function runBoardIssues(opts) {
+    const profile = await loadProfile({ org: opts.org, project: opts.project });
+    const client = new JiraClient(profile.config, profile.apiToken);
+    const statusIds = await client.getBoardColumnStatusIds(opts.board, opts.column);
+    if (statusIds.length === 0) {
+        if (opts.json) {
+            process.stdout.write('[]\n');
+        }
+        else {
+            console.error(`Column "${opts.column}" has no mapped statuses.`);
+        }
+        return;
+    }
+    const clauses = [
+        `project = ${profile.project.key}`,
+        `status in (${statusIds.map((id) => `"${id}"`).join(', ')})`,
+    ];
+    if (opts.assignee) {
+        if (opts.assignee === 'me' || opts.assignee === 'currentUser') {
+            clauses.push('assignee = currentUser()');
+        }
+        else {
+            clauses.push(`assignee = "${opts.assignee}"`);
+        }
+    }
+    const jql = clauses.join(' AND ') + ' ORDER BY rank ASC';
+    const issues = await client.searchByJql(jql);
+    const rows = issues.map((issue) => {
+        const fields = issue.fields;
+        return {
+            key: issue.key,
+            summary: fields.summary ?? '',
+            status: fields.status?.name ?? 'Unknown',
+            assignee: fields.assignee?.displayName,
+            issueType: fields.issuetype?.name,
+        };
+    });
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ board: opts.board, column: opts.column, issues: rows }, null, 2) + '\n');
+        return;
+    }
+    if (rows.length === 0) {
+        console.log(`No issues in "${opts.column}" on board "${opts.board}".`);
+        return;
+    }
+    console.log(`Board "${opts.board}" / column "${opts.column}" — ${rows.length} issue(s):`);
+    for (const row of rows) {
+        const assignee = row.assignee ? ` [${row.assignee}]` : '';
+        console.log(`  ${row.key}  ${row.summary}${assignee}`);
+    }
+}
+//# sourceMappingURL=board.js.map

package/dist/cli/commands/board.js.map

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

package/dist/cli/commands/boards.d.ts

@@ -0,0 +1,11 @@
+export type BoardsOptions = {
+    org: string;
+    project?: string;
+    type?: 'scrum' | 'kanban' | 'simple';
+    name?: string;
+    limit?: string;
+    startAt?: string;
+    json?: boolean;
+};
+export declare function runBoards(opts: BoardsOptions): Promise<void>;
+//# sourceMappingURL=boards.d.ts.map

package/dist/cli/commands/boards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/boards.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBlE"}

package/dist/cli/commands/boards.js

@@ -0,0 +1,27 @@
+import { loadProfile } from '../../lib/config.js';
+import { JiraClient } from '../../lib/jiraClient.js';
+import { printJson, shouldOutputJson } from '../jsonOutput.js';
+export async function runBoards(opts) {
+    const profile = await loadProfile({ org: opts.org, project: opts.project });
+    const client = new JiraClient(profile.config, profile.apiToken);
+    const page = await client.listBoards({
+        projectKey: opts.project ?? profile.project.key,
+        type: opts.type,
+        name: opts.name,
+        limit: opts.limit ? parseInt(opts.limit, 10) : undefined,
+        startAt: opts.startAt ? parseInt(opts.startAt, 10) : undefined,
+    });
+    if (shouldOutputJson(opts)) {
+        printJson(page);
+        return;
+    }
+    if (page.values.length === 0) {
+        console.log('No boards found.');
+        return;
+    }
+    console.log(`${page.values.length} board(s):`);
+    for (const b of page.values) {
+        console.log(`  [${b.id}] ${b.name} (${b.type})`);
+    }
+}
+//# sourceMappingURL=boards.js.map

package/dist/cli/commands/boards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.js","sourceRoot":"","sources":["../../../src/cli/commands/boards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAY/D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;QACnC,UAAU,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG;QAC/C,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QACxD,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;KAC/D,CAAC,CAAC;IAEH,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,YAAY,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/cli/commands/boards.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=boards.test.d.ts.map

package/dist/cli/commands/boards.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boards.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/boards.test.ts"],"names":[],"mappings":""}