@angelmsger/jira-cli 0.1.0

package/README.md

@@ -0,0 +1,23 @@
+# @angelmsger/jira-cli
+
+npm distribution of [`jira-cli`](https://github.com/angelmsger/jira-cli)
+— a command-line tool that lets coding agents use a Jira instance as an
+external knowledge base.
+
+```bash
+npm install -g @angelmsger/jira-cli
+jira-cli config init --pretty   # interactive TUI: server URL + credentials
+jira-cli skill install          # deploy the companion agent Skill
+```
+
+Installing this package downloads the prebuilt binary for your platform from the
+matching GitHub Release and verifies its SHA-256 checksum. If your npm setup
+disables install scripts, the binary is fetched on first run instead.
+
+The companion `jira` Skill for coding agents is embedded in the binary;
+`jira-cli skill install` deploys a copy that always matches the installed
+CLI version.
+
+See the [project README](https://github.com/angelmsger/jira-cli) and the
+[installation guide](https://github.com/angelmsger/jira-cli/blob/main/docs/installation.md)
+for full documentation.

package/bin/jira-cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+'use strict';
+// Thin launcher for the jira-cli binary. It execs the platform binary
+// downloaded by install.js, fetching it on demand if it is not present yet
+// (e.g. when the package was installed with --ignore-scripts).
+
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+const { binPath, install } = require('../install.js');
+
+async function main() {
+  const { file } = binPath();
+
+  if (!fs.existsSync(file)) {
+    process.stderr.write('jira-cli: downloading binary...\n');
+    await install();
+  }
+
+  const res = spawnSync(file, process.argv.slice(2), { stdio: 'inherit' });
+  if (res.error) {
+    process.stderr.write(`jira-cli: ${res.error.message}\n`);
+    process.exit(1);
+  }
+  process.exit(res.status === null ? 1 : res.status);
+}
+
+main().catch((err) => {
+  process.stderr.write(`jira-cli: ${err.message}\n`);
+  process.exit(1);
+});

package/install.js

@@ -0,0 +1,151 @@
+'use strict';
+// install.js downloads the prebuilt jira-cli binary that matches the host
+// platform from the matching GitHub Release. It runs as the npm `postinstall`
+// script, and is also called lazily by the bin shim when the binary is missing
+// (so installs with `--ignore-scripts` still work on first run).
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const crypto = require('crypto');
+
+const pkg = require('./package.json');
+
+const REPO = 'angelmsger/jira-cli';
+
+const goosByPlatform = { darwin: 'darwin', linux: 'linux', win32: 'windows' };
+const goarchByArch = { x64: 'amd64', arm64: 'arm64' };
+
+// assetName returns the release asset file name for the current platform.
+function assetName(platform = process.platform, arch = process.arch) {
+  const goos = goosByPlatform[platform];
+  const goarch = goarchByArch[arch];
+  if (!goos || !goarch) {
+    throw new Error(
+      `unsupported platform ${platform}/${arch}; ` +
+        `build from source instead (see https://github.com/${REPO})`
+    );
+  }
+  return `jira-cli-${goos}-${goarch}` + (goos === 'windows' ? '.exe' : '');
+}
+
+// binPath returns the directory and file path for the installed binary.
+function binPath(platform = process.platform) {
+  const dir = path.join(__dirname, 'binary');
+  const exe = platform === 'win32' ? 'jira-cli.exe' : 'jira-cli';
+  return { dir, file: path.join(dir, exe) };
+}
+
+// releaseBaseURL is the GitHub Release download prefix for this package version.
+function releaseBaseURL() {
+  return `https://github.com/${REPO}/releases/download/v${pkg.version}`;
+}
+
+// httpGet fetches a URL into a Buffer, following redirects.
+function httpGet(url, redirects = 0) {
+  return new Promise((resolve, reject) => {
+    if (redirects > 8) {
+      reject(new Error('too many redirects'));
+      return;
+    }
+    https
+      .get(url, { headers: { 'User-Agent': 'jira-cli-npm-installer' } }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          res.resume();
+          resolve(httpGet(res.headers.location, redirects + 1));
+          return;
+        }
+        if (res.statusCode !== 200) {
+          res.resume();
+          reject(new Error(`GET ${url} -> HTTP ${res.statusCode}`));
+          return;
+        }
+        const chunks = [];
+        res.on('data', (c) => chunks.push(c));
+        res.on('end', () => resolve(Buffer.concat(chunks)));
+      })
+      .on('error', reject);
+  });
+}
+
+// expectedChecksum fetches checksums.txt and returns the SHA-256 for asset.
+// Returns null when the checksum file is unavailable (verification skipped).
+async function expectedChecksum(asset) {
+  try {
+    const text = (await httpGet(`${releaseBaseURL()}/checksums.txt`)).toString('utf8');
+    for (const line of text.split('\n')) {
+      const [hash, name] = line.trim().split(/\s+/);
+      if (name === asset && hash) return hash.toLowerCase();
+    }
+  } catch {
+    // No checksums published for this release; skip verification.
+  }
+  return null;
+}
+
+// install downloads, verifies and writes the binary. It is idempotent.
+async function install() {
+  if (!pkg.version || pkg.version === '0.0.0') {
+    throw new Error('package version is unset; install from a published release');
+  }
+  const asset = assetName();
+  const { dir, file } = binPath();
+
+  const data = await httpGet(`${releaseBaseURL()}/${asset}`);
+
+  const want = await expectedChecksum(asset);
+  if (want) {
+    const got = crypto.createHash('sha256').update(data).digest('hex');
+    if (got !== want) {
+      throw new Error(`checksum mismatch for ${asset} (want ${want}, got ${got})`);
+    }
+  }
+
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(file, data, { mode: 0o755 });
+  return file;
+}
+
+// welcomeText is the getting-started banner printed once at install time (by the
+// postinstall script below). It is never printed by the CLI itself, so command
+// output — JSON and everything else — is never touched.
+function welcomeText() {
+  return [
+    '',
+    'jira-cli is ready. First-time setup:',
+    '',
+    '  jira-cli config init --pretty   configure your server + credentials (interactive)',
+    '  jira-cli skill install          install the coding-agent Skill',
+    '',
+    'Everyday use:',
+    '  jira-cli search "<text>"',
+    '  jira-cli page get <pageId>',
+    '  jira-cli --help',
+    '',
+    'Docs: https://angelmsger.github.io/jira-cli/',
+    '',
+  ].join('\n');
+}
+
+module.exports = { install, binPath, assetName, welcomeText, REPO };
+
+// When run directly as the npm postinstall script, download best-effort: a
+// failure here is not fatal because the bin shim retries lazily on first run.
+// The getting-started banner is printed here (install time) and nowhere else.
+// Note: npm v7+ hides postinstall output unless `npm install --foreground-scripts`
+// is used, so this may not be visible on a default install.
+if (require.main === module) {
+  install()
+    .then((file) => {
+      process.stdout.write(`jira-cli: installed ${file}\n`);
+    })
+    .catch((err) => {
+      process.stderr.write(
+        `jira-cli: postinstall download skipped (${err.message}); ` +
+          'the binary will be fetched on first run.\n'
+      );
+    })
+    .finally(() => {
+      if (!process.env.CI) process.stdout.write(welcomeText());
+    });
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@angelmsger/jira-cli",
+  "version": "0.1.0",
+  "description": "Drive Jira issue-tracking workflows from the command line, built for coding agents: read and search issues via JQL, create/edit/assign/transition them, and manage comments across Cloud and Data Center.",
+  "keywords": [
+    "jira",
+    "cli",
+    "issues",
+    "agent",
+    "claude",
+    "jql"
+  ],
+  "homepage": "https://angelmsger.github.io/jira-cli/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AngelMsger/jira-cli.git"
+  },
+  "license": "MIT",
+  "bin": {
+    "jira-cli": "bin/jira-cli.js"
+  },
+  "main": "install.js",
+  "scripts": {
+    "postinstall": "node install.js",
+    "test": "node --test install.test.js"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}