@fatecannotbealtered-/jira-cli 1.0.3 → 1.0.5

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.5] - 2026-06-02
+
+### Added
+
+- **`issue attachments` download** — the command can now fetch attachment content, not just list metadata. `--out <dir>` downloads all attachments into a directory; add `--id <attachmentId>` to download a single one (exit code 4 if not found). With `--json` it prints `{id, filename, path, mimeType}` per saved file. Downloads stream to disk (handles large files like screen recordings) and validate the content URL points at the configured Jira host. The `attachments --json` listing now also includes the `content` download URL.
+
+## [1.0.4] - 2026-05-31
+
+### Fixed
+
+- **`issue get` description** — `description` is now included in the default flat output and selectable via `--fields description` (previously only reachable through `--raw`). Bulk outputs (`issue list`, `search`, `filter run`, `sprint issues`) stay lean and omit `description` by default to preserve token efficiency. Handles both Data Center (plain string) and Cloud/v3 (ADF) descriptions.
+
 ## [1.0.3] - 2026-05-26
 
 ### Fixed
@@ -107,7 +119,9 @@ Initial release of jira-cli for Jira Data Center.
 - SKILL.md with JSON output schemas, error codes, exit codes, and complete flag reference.
 - GitHub PR template for contributors.
 
-[Unreleased]: https://github.com/fatecannotbealtered/jira-cli/compare/v1.0.3...HEAD
+[Unreleased]: https://github.com/fatecannotbealtered/jira-cli/compare/v1.0.5...HEAD
+[1.0.5]: https://github.com/fatecannotbealtered/jira-cli/compare/v1.0.4...v1.0.5
+[1.0.4]: https://github.com/fatecannotbealtered/jira-cli/compare/v1.0.3...v1.0.4
 [1.0.3]: https://github.com/fatecannotbealtered/jira-cli/compare/v1.0.2...v1.0.3
 [1.0.2]: https://github.com/fatecannotbealtered/jira-cli/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/fatecannotbealtered/jira-cli/compare/v1.0.0...v1.0.1

package/README.md

@@ -36,22 +36,22 @@ This project is shared for **personal learning, research, and everyday productiv
 
 ### Quick start
 
-Recommended flow: install the CLI from npm, then install the AI Agent Skill with `npx skills add`.
+Copy the block below to your agent (or run it yourself):
 
 ```bash
+# Please install jira-cli and use it for all Jira DC operations going forward (always pass --json).
 # Install CLI (requires curl on PATH — used to download the binary)
 npm install -g @fatecannotbealtered-/jira-cli
 
-# Install CLI Skill (pick one)
-npx skills add fatecannotbealtered/jira-cli -y -g   # via skills registry
-jira-cli install-skill                               # bundled skill → ~/.openclaw/skills
+# Install CLI Skill (required) — copies into your agent-supported skills directory
+npx skills add fatecannotbealtered/jira-cli -y -g
 
 # Login and verify
 jira-cli login
-jira-cli doctor --json   # check authValid is true (see JSON Output)
+jira-cli doctor --json
 ```
 
-The CLI package provides the `jira-cli` binary; the Skill teaches compatible AI coding assistants how to use it safely. `install-skill` copies the bundled skill from the npm package (or release tarball) into `~/.openclaw/skills` for OpenClaw-compatible agents. If you are an AI Agent helping a user set this up, run the same steps and ask the user to complete any interactive browser or terminal prompts.
+Optional: `jira-cli install-skill` copies the bundled skill to `~/.openclaw/skills` for OpenClaw-compatible agents.
 
 ### Alternative: Go install
 
@@ -148,6 +148,9 @@ jira-cli issue worklog list PROJ-123
 # Links & Attachments
 jira-cli issue link PROJ-123 --to PROJ-456 --type "blocks"
 jira-cli issue attach PROJ-123 --file ./screenshot.png
+jira-cli issue attachments PROJ-123                       # List attachments
+jira-cli issue attachments PROJ-123 --out ./downloads     # Download all attachments
+jira-cli issue attachments PROJ-123 --out ./downloads --id 4609477   # Download one by ID
 jira-cli issue remote-link PROJ-123 --url https://pr.url --title "PR #42"
 ```
 
@@ -295,6 +298,8 @@ Credentials stored at `~/.jira-cli/config.json` (permissions: 0600):
 | `--raw` | `issue get`, `issue list`, `search`, `filter run`, `sprint list`, `sprint issues`, `sprint active` | Return raw Jira API response instead of flat format |
 | `--fields` | `issue get`, `issue list`, `sprint list`, `sprint issues`, `filter run` | **Output trimming** — include only listed fields in flat JSON (e.g. `--fields key,summary,status`) |
 | `--fields` | `search` only | **Jira fetch fields** — comma-separated fields to request from the API (e.g. `--fields summary,status,customfield_10001`); does not trim flat output |
+| `--out` | `issue attachments` | Download attachments into this directory instead of listing (default cwd via the dir you pass); with `--json` prints `{id, filename, path, mimeType}` |
+| `--id` | `issue attachments` | With `--out`, download only the attachment with this ID (exit code 4 if not found) |
 
 ## Troubleshooting
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fatecannotbealtered-/jira-cli",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Full-featured Jira Data Center CLI for humans and AI Agents — manage issues, sprints, boards, epics, projects, users, and filters from your terminal",
   "keywords": [
     "jira",

package/skills/jira-cli/SKILL.md

@@ -8,11 +8,20 @@ metadata: {"openclaw":{"emoji":"🎯","requires":{"bins":["jira-cli"]}}}
 
 Jira Data Center CLI for humans and AI Agents. Supports **Jira DC only** (self-hosted), not Jira Cloud.
 
-> Install CLI: `npm install -g @fatecannotbealtered-/jira-cli` (requires `curl` on PATH)
->
-> Install Skill (pick one):
-> - `npx skills add fatecannotbealtered/jira-cli -y -g`
-> - `jira-cli install-skill` (bundled skill → `~/.openclaw/skills`)
+```bash
+# Please install jira-cli and use it for all Jira DC operations going forward (always pass --json).
+# Install CLI (requires curl on PATH)
+npm install -g @fatecannotbealtered-/jira-cli
+
+# Install CLI Skill (required) — copies into your agent-supported skills directory
+npx skills add fatecannotbealtered/jira-cli -y -g
+
+# Login and verify
+jira-cli login
+jira-cli doctor --json
+```
+
+Optional: `jira-cli install-skill` → `~/.openclaw/skills`.
 
 ## Prerequisites
 
@@ -100,7 +109,9 @@ jira-cli issue remote-links PROJ-123 --json
 
 # Attachments
 jira-cli issue attach PROJ-123 --file ./screenshot.png
-jira-cli issue attachments PROJ-123 --json
+jira-cli issue attachments PROJ-123 --json                       # list metadata (incl. content URL)
+jira-cli issue attachments PROJ-123 --out ./dl --json            # download all -> [{id,filename,path,mimeType}]
+jira-cli issue attachments PROJ-123 --out ./dl --id 4609477      # download a single attachment by ID
 ```
 
 ## Search (JQL)