chore: release v0.4.0

.claude/commands/release.md

@@ -32,19 +32,23 @@ ephemeral pre-releases and the stable version is chosen at release time.
 3. Bump the version in `Cargo.toml` to the dev version (e.g., `0.3.0-dev.1`)
 4. Run `cargo check` to update `Cargo.lock`
 5. Run `cargo fmt --all`
-6. Run `cargo test` to verify everything passes
-7. Commit the version bump:
+6. Run `cargo clippy -- -D warnings` to verify no lint issues
+7. Run `cargo test` to verify everything passes
+8. Commit the version bump:
    ```
    git commit -m "chore: bump version to X.Y.Z-dev.N"
    ```
-8. Tag: `git tag vX.Y.Z-dev.N`
-9. Push commit and tag:
+9. Tag (annotated — required to trigger the Release workflow and show as verified):
+   ```
+   git tag -a vX.Y.Z-dev.N -m "chore: release vX.Y.Z-dev.N"
+   ```
+10. Push commit and tag:
    ```
    git push origin develop
    git push origin vX.Y.Z-dev.N
    ```
-10. Print: "Dev release vX.Y.Z-dev.N tagged and pushed. GitHub Actions will build and publish pre-release binaries."
-11. Provide the releases URL
+11. Print: "Dev release vX.Y.Z-dev.N tagged and pushed. GitHub Actions will build and publish pre-release binaries."
+12. Provide the releases URL
 
 ---
 
@@ -89,21 +93,41 @@ If already on `develop` or `main`, skip to Stage 2.
 ## Stage 3: Tag & Release
 
 1. Checkout `main` and pull latest
-2. Verify the version in `Cargo.toml` is the stable version (no pre-release suffix)
+2. Verify the version in `Cargo.toml` matches the intended release (no pre-release suffix):
+   ```
+   grep '^version' Cargo.toml
+   ```
 3. Run `cargo check` to update `Cargo.lock`
 4. Run `cargo fmt --all` to ensure formatting is correct
-5. Run `cargo test` to verify everything passes
-6. If any changes from steps 3-5, commit them on a branch, PR into `main`
-7. After merge confirmation, tag `vX.Y.Z` on main
-8. Push the tag to trigger the release workflow
-9. Print: "Release vX.Y.Z tagged and pushed. GitHub Actions will build and publish binaries."
-10. Provide the releases URL
-11. Clean up dev tags for this release cycle:
+5. Run `cargo clippy -- -D warnings` to verify no lint issues
+6. Run `cargo test` to verify everything passes
+7. If any changes from steps 3-6, commit them on a branch, PR into `main`
+8. After merge confirmation, create an annotated tag on main:
+   ```
+   git tag -a vX.Y.Z -m "chore: release vX.Y.Z"
+   ```
+9. Verify the tag matches `Cargo.toml`:
+   ```
+   TAG_VERSION=$(git describe --tags --exact-match | sed 's/^v//')
+   CARGO_VERSION=$(grep '^version' Cargo.toml | head -1 | sed 's/.*"\(.*\)".*/\1/')
+   ```
+   If they don't match, stop and report the mismatch.
+10. Push the tag to trigger the release workflow
+11. Print: "Release vX.Y.Z tagged and pushed. GitHub Actions will build and publish binaries."
+12. Provide the releases URL
+13. Clean up dev tags for this release cycle:
     ```
     git tag -l "vX.Y.Z-dev.*" | xargs -I {} git push origin :refs/tags/{}
     git tag -l "vX.Y.Z-dev.*" | xargs git tag -d
     ```
-12. Checkout `develop`, merge `main` back into `develop`, bump to next dev version, push
+14. Merge `main` back into `develop` and bump to next dev version:
+    - Checkout `develop` and pull latest
+    - Merge `main` into `develop`: `git merge main`
+    - If conflicts, resolve and commit
+    - Bump `Cargo.toml` to next optimistic dev version (e.g., `0.4.0` → `0.5.0-dev.1`)
+    - Run `cargo check` to update `Cargo.lock`
+    - Commit: `git commit -m "chore: bump version to X.Y.Z-dev.1"`
+    - Push: `git push origin develop`
 
 ## Rules
 
@@ -115,3 +139,4 @@ If already on `develop` or `main`, skip to Stage 2.
 - Ask the user before every destructive or visible action
 - If any step fails, stop and report the error — don't continue
 - Dev tags go on `develop`, stable tags go on `main`
+- Always verify tag/version match before pushing tags

.github/workflows/ci.yml

@@ -62,7 +62,8 @@ jobs:
       - uses: taiki-e/install-action@cargo-llvm-cov
       - uses: Swatinem/rust-cache@v2
       - run: cargo llvm-cov --all-features --workspace --lcov --output-path lcov.info
-      - uses: codecov/codecov-action@v5
+      - uses: codecov/codecov-action@v6
         with:
           files: lcov.info
+          token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: false

.gitignore

@@ -13,3 +13,5 @@ Thumbs.db
 
 # Worktrees
 .trees/
+.worktrees/
+.claude/worktrees/

CLAUDE.md

@@ -14,39 +14,55 @@ src/
 │   ├── issue/           # issue commands (split by operation theme)
 │   │   ├── mod.rs       # dispatch + re-exports
 │   │   ├── format.rs    # row formatting, headers, points display
-│   │   ├── list.rs      # list + view + comments (read operations)
+│   │   ├── list.rs      # list + view + comments (read operations, unified JQL composition)
 │   │   ├── create.rs    # create + edit (field-building)
 │   │   ├── workflow.rs  # move + transitions + assign + comment + open
 │   │   ├── links.rs     # link + unlink + link-types
-│   │   └── helpers.rs   # team/points resolution, prompts
+│   │   ├── helpers.rs   # team/points resolution, user resolution, prompts
+│   │   └── assets.rs    # linked assets (issue→asset lookup)
+│   ├── assets.rs        # assets search/view/tickets/schemas/types/schema (search enrichment, schema discovery)
 │   ├── board.rs         # board list/view
-│   ├── sprint.rs        # sprint list/current (scrum-only, errors on kanban)
+│   ├── sprint.rs        # sprint list/current/add/remove (scrum-only, errors on kanban)
 │   ├── worklog.rs       # worklog add/list
 │   ├── team.rs          # team list (with cache + lazy org discovery)
 │   ├── auth.rs          # auth login (API token default, --oauth for OAuth 2.0), auth status
 │   ├── init.rs          # Interactive setup (prefetches org metadata + team cache + story points field)
-│   └── project.rs       # project fields (issue types, priorities for a project)
+│   ├── project.rs       # project fields (types, priorities, statuses, CMDB fields)
+│   └── queue.rs         # queue list/view (JSM service desks)
 ├── api/
 │   ├── client.rs        # JiraClient — HTTP methods, auth headers, rate limit retry, 429/401 handling
 │   ├── auth.rs          # OAuth 2.0 flow, API token storage, keychain read/write, token refresh
 │   ├── pagination.rs    # Offset-based (most endpoints) + cursor-based (JQL search)
 │   ├── rate_limit.rs    # Retry-After parsing
+│   ├── assets/          # Assets/CMDB API call implementations
+│   │   ├── workspace.rs     # workspace ID discovery + cache
+│   │   ├── linked.rs        # CMDB field discovery, asset extraction/enrichment (per-field + JSON)
+│   │   ├── objects.rs       # AQL search, get object, resolve key
+│   │   └── tickets.rs       # connected tickets
 │   └── jira/            # Jira-specific API call implementations (one file per resource)
 │       ├── issues.rs    # search, get, create, edit, list comments
 │       ├── boards.rs    # list boards, get board config
 │       ├── sprints.rs   # list sprints, get sprint issues
-│       ├── fields.rs    # list fields, story points field discovery
+│       ├── fields.rs    # list fields, story points + CMDB field discovery
+│       ├── statuses.rs  # get all statuses (global, not project-scoped)
 │       ├── links.rs     # create/delete issue links, list link types
 │       ├── teams.rs     # org metadata (GraphQL), list teams
 │       ├── worklogs.rs  # add/list worklogs
 │       ├── projects.rs  # project details
-│       └── users.rs     # current user, assignable users
+│       └── users.rs     # current user, user search, assignable users
+│   ├── jsm/             # JSM-specific API call implementations
+│   │   ├── servicedesks.rs  # list service desks, project meta orchestration
+│   │   └── queues.rs        # list queues, get queue issues
+├── types/assets/        # Serde structs for Assets API responses (AssetObject, ConnectedTicket, LinkedAsset, etc.)
 ├── types/jira/          # Serde structs for API responses (Issue, Board, Sprint, User, Team, etc.)
-├── cache.rs             # XDG cache (~/.cache/jr/) — team list with 7-day TTL
+├── types/jsm/           # Serde structs for JSM API responses (ServiceDesk, Queue, etc.)
+├── cache.rs             # XDG cache (~/.cache/jr/) — team list, project meta, workspace ID (all 7-day TTL)
 ├── config.rs            # Global (~/.config/jr/config.toml) + per-project (.jr.toml), figment layering
 ├── output.rs            # Table (comfy-table) and JSON formatting
 ├── adf.rs               # Atlassian Document Format: text→ADF, markdown→ADF, ADF→text
 ├── duration.rs          # Worklog duration parser (2h, 1h30m, 1d, 1w)
+├── lib.rs               # Crate root (re-exports for integration tests)
+├── jql.rs               # JQL utilities: escaping, validation, asset clause builder
 ├── partial_match.rs     # Case-insensitive substring matching with disambiguation
 └── error.rs             # JrError enum with exit codes (0/1/2/64/78/130)
 ```
@@ -93,8 +109,7 @@ See `docs/adr/` for detailed rationale:
 
 - **v1 design spec:** `docs/superpowers/specs/2026-03-21-jr-jira-cli-design.md`
 - **v1 implementation plan:** `docs/superpowers/plans/2026-03-21-jr-implementation.md`
-- **Feature specs (post-v1):** `docs/specs/{feature-name}.md`
-- **Team assignment spec:** `docs/specs/team-assignment.md`
+- **Feature specs (post-v1):** `docs/specs/` — one spec per feature, read before implementing
 
 When adding a new feature:
 1. Read this file
@@ -103,6 +118,13 @@ When adding a new feature:
 4. Create a feature spec in `docs/specs/` before implementing
 5. Follow TDD — write tests first
 
+## Gotchas
+
+- **Cache format changes:** `~/.cache/jr/cmdb_fields.json` stores `(id, name)` tuples. Old format (ID-only) causes deserialization failure, handled as cache miss. If you change cache structs, old caches auto-expire (7-day TTL) or fail gracefully.
+- **`list.rs` is large (~970 lines):** Contains both `handle_list` and `handle_view` plus all JQL composition logic. If modifying, read the full function you're changing — context matters.
+- **`aqlFunction()` not `assetsQuery()`:** The Jira Assets JQL function is `aqlFunction()`. It requires the human-readable field **name**, not `cf[ID]` or `customfield_NNNNN`. AQL attribute for object key is `Key` (not `objectKey` — that's the JSON field name).
+- **Status category colors are fixed:** `green` = Done, `yellow` = In Progress, `blue-gray` = To Do. These mappings are hardcoded in Jira Cloud across all instances. Used by `--open` filtering.
+
 ## AI Agent Notes
 
 - `JR_BASE_URL` env var overrides the configured Jira instance URL (used by tests to inject wiremock)

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "jr"
-version = "0.3.0"
+version = "0.4.0"
 edition = "2024"
 description = "A fast CLI for Jira Cloud"
 repository = "https://github.com/Zious11/jira-cli"
@@ -30,6 +30,7 @@ tokio = { version = "1", features = ["full"] }
 toml = "1"
 base64 = "0.22"
 chrono = { version = "0.4", features = ["serde"] }
+futures = { version = "0.3", default-features = false, features = ["async-await"] }
 urlencoding = "2"
 
 [dev-dependencies]