[FEATURE] Support --format json across all commands

[pdeschen]

It appears that while some of the command supports --format json output format (which is great) I would be nice to support this across the board with the intent of piping output to other json processing tools such as jq and the like.

[simonlpaige]

Looking at the codebase, --format json is currently implemented as a per-command option rather than a global flag. The JSON output format is handled through outputFormatter in each command module, but not all commands implement it.

A practical approach would be to make --format a global option in the CLI parser (likely using yargs in bin/confluence-cli.js), then cascade it to each command's outputFormatter. Commands that currently only output plain text (like pages list, spaces list, properties list) would need a structured JSON schema. For example, pages list currently returns a formatted table - adding JSON would output the raw API response array.

I'd suggest starting with the read-only commands first since they have the simplest output schemas:

• spaces list → array of space objects
• pages list → array of page summary objects
• attachments list → array of attachment objects

The export and edit-workflow commands might be trickier since they produce file output rather than stdout. Those could either be excluded or output JSON metadata about the export operation.

For consistency, the JSON output should match the Confluence API response structure where possible, with any CLI-added fields (like _localPath for exports) prefixed with underscore.

[github-actions]

🎉 This issue has been resolved in version 2.14.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[pchuri]

Thanks for filing this — great suggestion! 🙏

This is now implemented as a global --json flag that works across the CLI:

• v2.13.0 (feat: add global --json flag and deprecate per-command --format json #204) — added --json to the read commands: info, search, spaces, find, children, versions, comments, attachments, and property-list/-get/-set.
• v2.14.0 (feat: add --json output to mutation commands #205) — extended it to the write commands: create, create-child, update, move, delete, copy-tree, comment/comment-delete, property-delete, attachment-upload/-delete, version-delete/versions-purge.

JSON goes to stdout (human-readable messages and warnings go to stderr), so it pipes cleanly into jq:

confluence search "release notes" --json | jq '.results[].title'
PAGE_ID=$(confluence create "Notes" ENG --content "hi" --json | jq -r '.id')

The older per-command --format json still works but is deprecated in favor of --json. Available now via npm i -g confluence-cli@latest. Thanks again!

[pdeschen]

Good job! Thanks for the responsiveness!