@kolatts/pncli 1.2.0 → 1.4.0

package/README.md

@@ -1,8 +1,10 @@
 # pncli — The Paperwork Nightmare CLI
 
+[![npm](https://img.shields.io/npm/v/%40kolatts%2Fpncli?style=flat-square&color=cb3837&logo=npm)](https://www.npmjs.com/package/@kolatts/pncli)
+
 > One command does what three meetings couldn't.
 
-pncli gives AI coding agents (and humans) structured CLI access to Jira Data Cloud and Bitbucket Server. No MCP servers required. No meetings to schedule. No forms to fill out.
+pncli gives AI coding agents (and humans) structured CLI access to Jira, Bitbucket, Confluence, SonarQube, and SDElements. No MCP servers required. No meetings to schedule. No forms to fill out.
 
 ## Why?
 
@@ -17,21 +19,15 @@ npm install -g @kolatts/pncli
 ## Quick Start
 
 ```bash
-# Configure your global auth
+# Configure your global auth (Jira, Bitbucket, Confluence)
 pncli config init
 
 # Add repo-level defaults (check this into git)
 pncli config init --repo
-
-# Review the PR for your current branch
-pncli git current-pr
-pncli bitbucket diff --pr 42
-pncli bitbucket add-inline-comment --pr 42 --file src/app.ts --line 15 --body "This needs a null check"
-
-# Create a Jira issue (uses defaults from .pncli.json)
-pncli jira create-issue --summary "Missing null check in app.ts"
 ```
 
+For workflow patterns, command examples, and agent integration, see [`copilot-instructions.md`](./copilot-instructions.md).
+
 ## Configuration
 
 pncli uses a three-layer config system (highest priority wins):
@@ -51,6 +47,9 @@ pncli uses a three-layer config system (highest priority wins):
 | `PNCLI_JIRA_API_TOKEN` | Jira API token |
 | `PNCLI_BITBUCKET_BASE_URL` | Bitbucket Server base URL |
 | `PNCLI_BITBUCKET_PAT` | Bitbucket personal access token |
+| `PNCLI_SONAR_BASE_URL` | SonarQube Server base URL |
+| `PNCLI_SONAR_TOKEN` | SonarQube personal access token |
+| `PNCLI_SDE_CONNECTION` | SDElements connection string (`api-token@hostname`, e.g. `mytoken@myorg.sdelements.com`) |
 | `PNCLI_CONFIG_PATH` | Override global config file path |
 
 ## For AI Agents
@@ -84,9 +83,12 @@ This project uses Conventional Commits for automatic versioning:
 | Git (local) | ✅ Active | Local git commands |
 | Jira | ✅ Active | Data Cloud REST v3 |
 | Bitbucket | ✅ Active | Server REST v1.0 |
-| Confluence | 🔜 Coming | The nightmare never ends |
-| SonarQube | 🔜 Coming | The nightmare never ends |
+| Confluence | ✅ Active | Server REST v1 |
+| SonarQube | ✅ Active | Server Web API |
+| SDElements | ✅ Active | REST API v2 (cloud + on-prem) |
 | Artifactory | 🔜 Coming | The nightmare never ends |
+| Jenkins | 🔜 Coming | REST API |
+| Azure DevOps Server | ✅ Active | REST API v7.1 (on-prem, Windows auth + PAT) |
 
 ## License
 

package/copilot-instructions.md

@@ -4,7 +4,7 @@
 
 ## What is pncli?
 
-pncli is a CLI tool that provides structured JSON access to Jira, Bitbucket, and local git state. Use it for all interactions with these services. It exists because MCP servers aren't available in this environment — pncli is your agent-friendly shim layer.
+pncli is a CLI tool that provides structured JSON access to Jira, Bitbucket, Confluence, SonarQube, SDElements, and local git state. Use it for all interactions with these services. It exists because MCP servers aren't available in this environment — pncli is your agent-friendly shim layer.
 
 ## Important
 
@@ -51,6 +51,17 @@ pncli is a CLI tool that provides structured JSON access to Jira, Bitbucket, and
 3. Add a PR comment referencing the issue:
    `pncli bitbucket add-comment --pr <id> --body "Created <new-key> to track this separately"`
 
+### Pre-Merge Quality Check
+
+1. Check quality gate status for the current branch:
+   `pncli sonar quality-gate --branch <branch-name>`
+2. If gate fails, inspect which issues are blocking:
+   `pncli sonar issues --types BUG,VULNERABILITY --statuses OPEN --branch <branch-name>`
+3. Check coverage and key metrics:
+   `pncli sonar measures --branch <branch-name>`
+4. Review security hotspots that need attention:
+   `pncli sonar hotspots --status TO_REVIEW --branch <branch-name>`
+
 ### Check Build Status Before Merging
 
 1. Get PR build status:
@@ -178,7 +189,10 @@ pncli bitbucket decline-pr
   --id <pr-id>  Pull request ID
 
 pncli bitbucket list-comments
-  --pr <pr-id>  Pull request ID
+  --pr <pr-id>       Pull request ID
+  --no-with-replies  Exclude replies; return top-level comments only
+  --inline-only      Return only inline file comments
+  --general-only     Return only general (non-inline) PR comments
 
 pncli bitbucket add-comment
   --pr <pr-id>   Pull request ID
@@ -236,13 +250,203 @@ pncli bitbucket get-build-status
 ### Confluence
 
 ```
-# confluence — no subcommands implemented yet
+pncli confluence get-page
+  --id <page-id>     Page ID
+  --expand <fields>  Comma-separated fields to expand (default:
+  "body.storage,version,space,ancestors")
+
+pncli confluence get-page-by-title
+  --space <key>    Space key
+  --title <title>  Page title
+
+pncli confluence list-pages
+  --space <key>  Space key
+  --limit <n>    Max results per page (default: all)
+  --start <n>    Offset for first result
+
+pncli confluence get-page-children
+  --id <page-id>  Parent page ID
+
+pncli confluence get-labels
+  --id <page-id>  Page ID
+
+pncli confluence search
+  --cql <query>      CQL query string (e.g. "space=PROJ AND type=page")
+  --limit <n>        Maximum number of results (default: "25")
+  --start <n>        Offset for first result (default: "0")
+  --expand <fields>  Comma-separated fields to expand
+
+pncli confluence create-page
+  --space <key>              Space key
+  --title <title>            Page title
+  --body <html>              Page body (storage format HTML)
+  --parent-id <id>           Parent page ID (to nest under a page)
+  --representation <format>  Body format: storage (default) or wiki (default:
+  "storage")
+
+pncli confluence update-page
+  --id <page-id>             Page ID
+  --title <title>            New page title
+  --body <html>              New page body (storage format HTML)
+  --status <status>          Page status: current (default) or draft (default:
+  "current")
+  --representation <format>  Body format: storage (default) or wiki (default:
+  "storage")
+
+pncli confluence delete-page
+  --id <page-id>  Page ID
+
+pncli confluence list-comments
+  --id <page-id>  Page ID
+
+pncli confluence add-comment
+  --id <page-id>             Page ID
+  --body <text>              Comment body (storage format HTML)
+  --representation <format>  Body format: storage (default) or wiki (default:
+  "storage")
+
+pncli confluence add-label
+  --id <page-id>    Page ID
+  --labels <names>  Comma-separated label names
+
+pncli confluence remove-label
+  --id <page-id>  Page ID
+  --label <name>  Label name to remove
+
+pncli confluence list-spaces
+  --type <type>  Space type: global or personal
+  --limit <n>    Max results (default: all)
+
+pncli confluence get-space
+  --key <space-key>  Space key
+
+pncli confluence list-attachments
+  --id <page-id>  Page ID
 ```
 
 ### Sonar
 
 ```
-# sonar — no subcommands implemented yet
+pncli sonar quality-gate
+  --project <key>  SonarQube project key (or set defaults.sonar.project in
+  config)
+  --branch <name>  Branch name
+
+pncli sonar issues
+  --project <key>      SonarQube project key (or set defaults.sonar.project in
+  config)
+  --severities <list>  Filter by severity: BLOCKER,CRITICAL,MAJOR,MINOR,INFO
+  (comma-separated)
+  --types <list>       Filter by type: BUG,VULNERABILITY,CODE_SMELL
+  (comma-separated)
+  --statuses <list>    Filter by status: OPEN,CONFIRMED,REOPENED,RESOLVED,CLOSED
+  (comma-separated)
+  --branch <name>      Branch name
+  --resolved <bool>    Filter resolved issues: true or false
+  --page <n>           Page number (1-based) (default: "1")
+  --page-size <n>      Results per page (max 500) (default: "100")
+  --all                Fetch all pages (ignores --page/--page-size)
+
+pncli sonar measures
+  --project <key>   SonarQube project key (or set defaults.sonar.project in
+  config)
+  --metrics <list>  Comma-separated metric keys (default:
+  "coverage,duplicated_lines_density,bugs,vulnerabilities,code_smells,sqale_rating,reliability_rating,security_rating,ncloc")
+  --branch <name>   Branch name
+
+pncli sonar projects
+  --query <text>   Search query
+  --page <n>       Page number (1-based) (default: "1")
+  --page-size <n>  Results per page (default: "100")
+  --all            Fetch all pages
+
+pncli sonar hotspots
+  --project <key>      SonarQube project key (or set defaults.sonar.project in
+  config)
+  --status <status>    Filter: TO_REVIEW or REVIEWED
+  --resolution <list>  Filter: FIXED,SAFE,ACKNOWLEDGED (comma-separated)
+  --branch <name>      Branch name
+  --page <n>           Page number (1-based) (default: "1")
+  --page-size <n>      Results per page (default: "100")
+  --all                Fetch all pages
+```
+
+### Sde
+
+```
+pncli sde server-info
+
+pncli sde whoami
+
+pncli sde users
+  --email <email>      Filter by email address
+  --first-name <name>  Filter by first name
+  --last-name <name>   Filter by last name
+  --active <bool>      Filter by active status: true or false
+  --page <n>           Page number (1-based) (default: "1")
+  --page-size <n>      Results per page (default: "100")
+  --all                Fetch all pages
+
+pncli sde projects
+  --name <name>       Filter by project name
+  --search <text>     Text search on name and profile
+  --active <val>      Filter by active status: true, false, or all
+  --ordering <field>  Sort by: name, created, updated (prefix with - for
+  descending)
+  --expand <fields>   Expand nested fields (comma-separated):
+  application,business_unit,creator
+  --include <fields>  Include extra fields (comma-separated):
+  task_counts,permissions
+  --page <n>          Page number (1-based) (default: "1")
+  --page-size <n>     Results per page (default: "100")
+  --all               Fetch all pages
+
+pncli sde project
+  --id <id>           Project ID (or set defaults.sde.project in config)
+  --expand <fields>   Expand nested fields (comma-separated):
+  application,business_unit,creator
+  --include <fields>  Include extra fields (comma-separated):
+  task_counts,permissions
+
+pncli sde tasks
+  --project <id>         Project ID (or set defaults.sde.project in config)
+  --phase <slug>         Filter by phase slug (e.g. development,
+  architecture-design)
+  --priority <n>         Filter by priority (1-10)
+  --status <id>          Filter by status ID (e.g. TS1, TS2)
+  --assigned-to <email>  Filter by assignee email
+  --source <val>         Filter by source: default, custom, manual, project
+  --verification <val>   Filter by verification: pass, fail, partial, none
+  --tag <name>           Filter by tag name
+  --accepted <bool>      Filter by accepted status: true or false
+  --relevant <bool>      Filter by relevant status: true or false
+  --expand <fields>      Expand nested fields (comma-separated):
+  status,phase,problem,text
+  --include <fields>     Include extra fields (comma-separated):
+  how_tos,last_note,references,regulation_sections
+  --page <n>             Page number (1-based) (default: "1")
+  --page-size <n>        Results per page (default: "100")
+  --all                  Fetch all pages
+
+pncli sde task
+  --project <id>      Project ID (or set defaults.sde.project in config)
+  --task <id>         Task ID (e.g. T21)
+  --expand <fields>   Expand nested fields (comma-separated):
+  status,phase,problem,text
+  --include <fields>  Include extra fields (comma-separated):
+  how_tos,last_note,references
+
+pncli sde threats
+  --project <id>       Project ID (or set defaults.sde.project in config)
+  --severity <n>       Filter by severity (1-10)
+  --search <text>      Full-text search on title and threat ID
+  --ordering <field>   Sort by: threat__severity, threat_id, status (prefix -
+  for descending)
+  --capec-id <id>      Filter by CAPEC attack pattern ID
+  --component-id <id>  Filter by component ID
+  --page <n>           Page number (1-based) (default: "1")
+  --page-size <n>      Results per page (default: "100")
+  --all                Fetch all pages
 ```
 
 ### Deps
@@ -296,6 +500,22 @@ pncli config set
 pncli config test
 ```
 
+### Ado
+
+```
+pncli ado whoami
+
+pncli ado connection-data
+
+pncli ado project
+
+pncli ado work
+
+pncli ado repo
+
+pncli ado pipeline
+```
+
 <!-- COMMAND-REFERENCE:END -->
 
 ## Output Format