jirallm 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dominik Rycharski
+
+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,214 @@
+# jirallm
+
+[![CI](https://github.com/doryski/jirallm/actions/workflows/ci.yml/badge.svg)](https://github.com/doryski/jirallm/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/jirallm)](https://www.npmjs.com/package/jirallm)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org/)
+
+Export Jira Cloud issues as LLM-ready context bundles — markdown, attachments, and deduplicated video frames.
+
+## 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.
+
+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
+- 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`
+- Produces an `index.md` summary per issue, ready to paste into an LLM context window
+- Works as a CLI (`jirallm`) and as a programmatic library
+- TypeScript-first, ESM, zero hidden globals
+
+## Requirements
+
+- Node.js >= 20
+- [`ffmpeg`](https://ffmpeg.org/download.html) on your `PATH` — only required if you export issues with video attachments. You can also run `jirallm setup` to install it for you (and `jirallm init` will offer to do this automatically when you opt into video frames).
+- A Jira Cloud API token
+
+## Installation
+
+```bash
+# Global CLI
+npm install -g jirallm
+# or
+pnpm add -g jirallm
+
+# As a library inside a project
+pnpm add jirallm
+```
+
+## Configuration
+
+The recommended way to configure `jirallm` is the interactive wizard:
+
+```bash
+jirallm init
+```
+
+It prompts for everything, writes an org + project entry to `~/.config/jirallm/config.toml`, and stores the API token in your OS keychain (macOS Keychain / libsecret / Windows Credential Manager) — never on disk.
+
+Run `jirallm init` again any time you want to **add another organization** or **add a new project to an existing organization** — the wizard detects existing config and lets you pick "Create a new organization" or "Add a project to *<org>*".
+
+If you enable video frame extraction during `init` and `ffmpeg` isn't on your `PATH`, `init` will offer to run `jirallm setup` for you. You can also run it manually any time, or use `jirallm setup --bundled` to install a self-contained `ffmpeg` via npm without touching your system.
+
+### Organizations and projects
+
+Configuration is two levels: an **organization** owns the connection (Jira instance, account email, API token); each org has one or more **projects** that share those credentials and only differ by project key (and optionally output directory).
+
+```toml
+# ~/.config/jirallm/config.toml
+
+[orgs.widgets]
+base_url         = "https://widgets.atlassian.net"
+user_email       = "user@widgets.example"
+include_subtasks = true
+
+[orgs.widgets.video_frames]
+enabled    = true
+fps        = 5
+max_frames = 10
+
+[orgs.widgets.projects.WID]
+output_dir = "~/jira/widgets"
+
+[orgs.acme]
+base_url   = "https://acme.atlassian.net"
+user_email = "user@acme.example"
+
+# Three projects share the same Jira instance + token
+[orgs.acme.projects.PROJ]
+output_dir = "~/jira/acme/proj"
+
+[orgs.acme.projects.CORE]
+output_dir = "~/jira/acme/core"
+
+[orgs.acme.projects.LIB]
+```
+
+Most invocations are just the issue key — `jirallm` looks up the org by the project prefix:
+
+```bash
+jirallm PROJ-7              # auto-resolves to the org that owns PROJ
+jirallm acme/PROJ-7         # disambiguate if multiple orgs have a PROJ project
+jirallm --org acme PROJ-7   # explicit override
+```
+
+If a project key exists in more than one org and you didn't qualify it, you'll get an interactive picker (TTY) or an error suggesting `--org` / `org/KEY` (non-TTY).
+
+Useful subcommands:
+
+```bash
+jirallm orgs list                   # show orgs, projects, and token status
+jirallm auth set --org acme         # replace stored token (per organization)
+jirallm auth rm  --org acme         # remove stored token
+```
+
+### Selection precedence
+
+1. `--org` flag
+2. `org/` prefix on the issue key (e.g. `acme/PROJ-7`)
+3. Auto-resolved from the project prefix when only one configured org owns it
+
+CLI flags (`--base-url`, `--output-dir`, `--fps`, …) override whatever the resolved config produces.
+
+## Quick start
+
+### CLI
+
+```bash
+# First-time setup (config + credentials, offers to install ffmpeg)
+jirallm init
+
+# Install ffmpeg later, or independently of init
+jirallm setup
+jirallm setup --bundled   # self-contained ffmpeg-static, no system changes
+
+# Export a single issue (output defaults to ./jira-export)
+jirallm PROJ-123
+
+# Export several issues to a custom directory
+jirallm PROJ-123 PROJ-124 --output-dir ./context
+
+# Skip video frame extraction (faster, no ffmpeg required)
+jirallm PROJ-123 --no-video-frames
+
+# Tune frame extraction
+jirallm PROJ-123 --fps 2 --max-frames 6
+
+# Include subtask metadata in the export
+jirallm PROJ-123 --include-subtasks
+
+# Show all options
+jirallm --help
+```
+
+Each issue lands in its own folder:
+
+```
+jira-export/
+  PROJ-123/
+    index.md            # summary + description + comments
+    attachments/
+      design.pdf
+      screen-recording.mp4
+    frames/
+      screen-recording/
+        frame-0001.jpg
+        frame-0042.jpg   # only meaningfully different frames are kept
+```
+
+### Programmatic
+
+```ts
+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 exporter = new JiraExporter(config, apiToken);
+
+const result = await exporter.exportIssues(['CIT-123'], {
+  outputDir: project.outputDir ?? './jira-export',
+  includeSubtasks: org.includeSubtasks ?? false,
+  videoFrames: { enabled: true, fps: 5, maxFrames: 10 },
+});
+```
+
+The constructor also accepts a hand-rolled `JiraConfig` + token if you don't want to use the config file.
+
+A lower-level `JiraClient` is also exported for callers that want to drive the Jira API directly.
+
+## Example
+
+Bundle a few issues and pipe the resulting summary into your LLM of choice:
+
+```bash
+jirallm PROJ-123 PROJ-124 --output-dir ./triage-bundle
+cat ./triage-bundle/PROJ-123/index.md | pbcopy
+```
+
+## Platform support
+
+- macOS — fully supported
+- Linux — fully supported
+- Windows — should work; `ffmpeg` must be on `PATH`
+
+## Contributing
+
+Issues and pull requests are welcome. See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and guidelines, and please follow our [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+## Security
+
+Found a vulnerability? Please follow the disclosure process in [SECURITY.md](./SECURITY.md).
+
+## License
+
+MIT — see [LICENSE](./LICENSE). Authored by [Dominik Rycharski](https://github.com/doryski).
+
+### Third-party tools
+
+`jirallm` invokes [`ffmpeg`](https://ffmpeg.org/) as an external process to extract video frames. **`jirallm` does not distribute or bundle `ffmpeg` or any codec binaries.** Users install `ffmpeg` themselves (via system package manager, or via `jirallm setup --bundled`, which installs the [`ffmpeg-static`](https://www.npmjs.com/package/ffmpeg-static) npm package globally on the user's machine). `ffmpeg` and its codecs are governed by their own licenses (LGPL/GPL) and may carry codec patent obligations (H.264, HEVC, AAC, etc.) depending on jurisdiction and usage. The end user is responsible for compliance with those licenses and any applicable patent licensing.

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

@@ -0,0 +1,7 @@
+export declare function runAuthSet(orgName: string): Promise<void>;
+export declare function runAuthRm(orgName: string, opts?: {
+    yes?: boolean;
+}): Promise<void>;
+export declare function runAuthList(): Promise<void>;
+export declare function runAuthStatus(orgName: string): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/auth.ts"],"names":[],"mappings":"AAcA,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB/D;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5F;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAcjD;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASlE"}

package/dist/cli/commands/auth.js

@@ -0,0 +1,69 @@
+import { intro, outro, password, confirm, isCancel, cancel } from '@clack/prompts';
+import { setToken, removeToken, hasStoredToken } from '../../lib/credentials.js';
+import { listOrgs, readConfig } from '../../lib/config.js';
+function ensureOrg(name) {
+    const orgs = listOrgs();
+    if (!orgs.includes(name)) {
+        console.error(`Organization "${name}" not found. Existing orgs: ${orgs.join(', ') || '(none)'}\nRun \`jirallm init\` first.`);
+        process.exit(1);
+    }
+}
+export async function runAuthSet(orgName) {
+    ensureOrg(orgName);
+    intro(`jirallm auth set --org ${orgName}`);
+    const token = await password({
+        message: 'Jira API token\n\x1b[2mCreate one at https://id.atlassian.com/manage-profile/security/api-tokens. Stored in your OS keychain.\x1b[22m',
+        validate: (v) => (v ? undefined : 'Required'),
+    });
+    if (isCancel(token)) {
+        cancel('Cancelled.');
+        process.exit(0);
+    }
+    await setToken(orgName, token);
+    outro('Token stored in OS keychain.');
+}
+export async function runAuthRm(orgName, opts = {}) {
+    ensureOrg(orgName);
+    if (!(await hasStoredToken(orgName))) {
+        console.log(`No stored token for "${orgName}" (nothing to remove).`);
+        return;
+    }
+    if (!opts.yes) {
+        const ok = await confirm({
+            message: `Remove stored token for "${orgName}"?`,
+            initialValue: false,
+        });
+        if (isCancel(ok) || ok !== true) {
+            cancel('Cancelled.');
+            return;
+        }
+    }
+    const removed = await removeToken(orgName);
+    if (removed)
+        console.log(`Removed token for "${orgName}".`);
+    else
+        console.log(`No stored token for "${orgName}" (nothing to remove).`);
+}
+export async function runAuthList() {
+    const raw = readConfig();
+    const orgs = Object.keys(raw.orgs ?? {});
+    if (orgs.length === 0) {
+        console.log('No organizations configured. Run `jirallm init`.');
+        return;
+    }
+    for (const name of orgs) {
+        const baseUrl = raw.orgs?.[name]?.base_url ?? '';
+        const stored = await hasStoredToken(name);
+        const tokenLabel = stored ? 'token: stored' : 'token: missing';
+        console.log(`  ${name}  ${baseUrl}  ${tokenLabel}`);
+    }
+}
+export async function runAuthStatus(orgName) {
+    ensureOrg(orgName);
+    if (!(await hasStoredToken(orgName))) {
+        console.error(`No token stored for "${orgName}". Run \`jirallm auth set --org ${orgName}\`.`);
+        process.exit(1);
+    }
+    console.log(`${orgName}: token stored in OS keychain.`);
+}
+//# sourceMappingURL=auth.js.map

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

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

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

@@ -0,0 +1,5 @@
+export declare function runDoctor(opts?: {
+    org?: string;
+    project?: string;
+}): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AA8LA,wBAAsB,SAAS,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5F"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,191 @@
+import { intro, outro, note } from '@clack/prompts';
+import { checkFFmpegInstalled, resolveFfmpegBinary } from '../../lib/videoFrameExtractor.js';
+import { detectOS, getFfmpegInstallHint } from '../../lib/platform.js';
+import { readConfig, resolveConfigPath, loadProfile } from '../../lib/config.js';
+import { JiraClient } from '../../lib/jiraClient.js';
+import { getToken } from '../../lib/credentials.js';
+const symbols = {
+    pass: '\x1b[32m✔\x1b[0m',
+    fail: '\x1b[31m✖\x1b[0m',
+    warn: '\x1b[33m⚠\x1b[0m',
+};
+function printResult(r) {
+    console.log(`${symbols[r.severity]} ${r.name}: ${r.detail}`);
+    if (r.hint) {
+        for (const line of r.hint.split('\n'))
+            console.log(`    \x1b[2m${line}\x1b[0m`);
+    }
+}
+function checkNode() {
+    const major = parseInt(process.versions.node.split('.')[0], 10);
+    if (major >= 20) {
+        return { name: 'Node.js', severity: 'pass', detail: `v${process.versions.node}` };
+    }
+    return {
+        name: 'Node.js',
+        severity: 'fail',
+        detail: `v${process.versions.node} (requires >= 20)`,
+        hint: 'Upgrade Node.js to 20 or later (https://nodejs.org).',
+    };
+}
+async function checkFfmpeg() {
+    if (await checkFFmpegInstalled()) {
+        return { name: 'ffmpeg', severity: 'pass', detail: 'system ffmpeg available' };
+    }
+    const resolved = await resolveFfmpegBinary();
+    if (resolved) {
+        return {
+            name: 'ffmpeg',
+            severity: 'pass',
+            detail: `bundled (${resolved})`,
+        };
+    }
+    return {
+        name: 'ffmpeg',
+        severity: 'warn',
+        detail: 'not found (video frame extraction will fail)',
+        hint: await getFfmpegInstallHint(),
+    };
+}
+async function checkKeychain() {
+    try {
+        const mod = (await import('keytar'));
+        if (!mod)
+            throw new Error('keytar not loaded');
+        return { name: 'OS keychain', severity: 'pass', detail: 'keytar loaded' };
+    }
+    catch (err) {
+        return {
+            name: 'OS keychain',
+            severity: 'fail',
+            detail: 'keytar unavailable; tokens cannot be stored or read',
+            hint: err instanceof Error
+                ? `${err.message}\nTry: pnpm rebuild keytar (after pnpm approve-builds)`
+                : 'Try: pnpm rebuild keytar (after pnpm approve-builds)',
+        };
+    }
+}
+function checkConfig() {
+    const path = resolveConfigPath();
+    try {
+        const raw = readConfig(path);
+        const orgs = Object.keys(raw.orgs ?? {});
+        if (orgs.length === 0) {
+            return {
+                name: 'Config',
+                severity: 'warn',
+                detail: `no orgs configured (${path})`,
+                hint: 'Run `jirallm init` to create one.',
+            };
+        }
+        const projectCount = orgs.reduce((acc, name) => acc + Object.keys(raw.orgs?.[name].projects ?? {}).length, 0);
+        return {
+            name: 'Config',
+            severity: 'pass',
+            detail: `${orgs.length} org(s), ${projectCount} project(s) at ${path}`,
+        };
+    }
+    catch (err) {
+        return {
+            name: 'Config',
+            severity: 'fail',
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+async function checkJiraOrg(orgName, project) {
+    const label = `Jira reachable [${orgName}]`;
+    try {
+        const raw = readConfig();
+        const orgRaw = raw.orgs?.[orgName];
+        if (!orgRaw) {
+            return {
+                name: label,
+                severity: 'fail',
+                detail: `org "${orgName}" not found in config`,
+            };
+        }
+        if (project) {
+            const resolved = await loadProfile({ org: orgName, project });
+            const client = new JiraClient(resolved.config, resolved.apiToken);
+            const user = await client.getCurrentUser();
+            return {
+                name: label,
+                severity: 'pass',
+                detail: `${resolved.org.baseUrl} as ${user.displayName}${user.emailAddress ? ` <${user.emailAddress}>` : ''}`,
+            };
+        }
+        const apiToken = await getToken(orgName);
+        if (!apiToken) {
+            return {
+                name: label,
+                severity: 'warn',
+                detail: `no API token stored for org "${orgName}"`,
+                hint: `Run \`jirallm auth set --org ${orgName}\`.`,
+            };
+        }
+        const firstProjectKey = Object.keys(orgRaw.projects ?? {})[0] ?? '';
+        const client = new JiraClient({ baseUrl: orgRaw.base_url, userEmail: orgRaw.user_email, projectKey: firstProjectKey }, apiToken);
+        const user = await client.getCurrentUser();
+        return {
+            name: label,
+            severity: 'pass',
+            detail: `${orgRaw.base_url} as ${user.displayName}${user.emailAddress ? ` <${user.emailAddress}>` : ''}`,
+        };
+    }
+    catch (err) {
+        return {
+            name: label,
+            severity: 'warn',
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+async function checkJira(org, project) {
+    if (org)
+        return [await checkJiraOrg(org, project)];
+    let orgs = [];
+    try {
+        const raw = readConfig();
+        orgs = Object.keys(raw.orgs ?? {});
+    }
+    catch (err) {
+        return [
+            {
+                name: 'Jira reachable',
+                severity: 'warn',
+                detail: `skipped: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        ];
+    }
+    if (orgs.length === 0) {
+        return [
+            {
+                name: 'Jira reachable',
+                severity: 'warn',
+                detail: 'skipped (no orgs configured)',
+                hint: 'Run `jirallm init` to create one.',
+            },
+        ];
+    }
+    return Promise.all(orgs.map((name) => checkJiraOrg(name)));
+}
+export async function runDoctor(opts = {}) {
+    intro('jirallm doctor');
+    note(`OS: ${detectOS()}`, 'Environment');
+    const results = [];
+    results.push(checkNode());
+    results.push(await checkFfmpeg());
+    results.push(await checkKeychain());
+    results.push(checkConfig());
+    results.push(...(await checkJira(opts.org, opts.project)));
+    for (const r of results)
+        printResult(r);
+    const failed = results.some((r) => r.severity === 'fail');
+    if (failed) {
+        outro('Doctor found blocking issues.');
+        process.exit(1);
+    }
+    outro('Doctor finished.');
+}
+//# sourceMappingURL=doctor.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function runInit(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AA0MA,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAsC7C"}