@kolatts/pncli 1.7.0 → 1.9.0

package/copilot-instructions.md

@@ -4,7 +4,7 @@
 
 ## What is pncli?
 
-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.
+pncli is a CLI tool that provides structured JSON access to Jira, Bitbucket, Confluence, SonarQube, SDElements, Azure DevOps Server, Jenkins, JFrog Artifactory, IBM UrbanCode Deploy, Checkmarx, 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
 
@@ -30,9 +30,7 @@ pncli ships with Claude Code skills — step-by-step workflow guides that agents
 pncli skills install
 ```
 
-This downloads the latest pncli skills from GitHub into `.claude/skills/` and also fetches `copilot-instructions.md` into the repo root. Only pncli-managed skills are replaced — any custom skills you've created in `.claude/skills/` are left untouched.
-
-Use `--skip-instructions` to skip downloading `copilot-instructions.md`.
+This downloads the latest pncli skills from GitHub. Default installs to `.agents/skills/` (GitHub Copilot). For Claude Code, add `--agent claude-code`. For user-scope, add `--scope user`. Only pncli-managed skills are replaced — any custom skills you've added are left untouched.
 
 To see what's installed locally:
 
@@ -42,7 +40,7 @@ pncli skills list
 
 ## Common Workflows
 
-> These workflows are also available as Claude Code skills — run `pncli skills install` to download them into your repo, or copy `.claude/skills/` into `~/.claude/skills/` for global access.
+> These workflows are also available as skills — run `pncli skills install` (Copilot default) or `pncli skills install --agent claude-code` (Claude Code) to download them into your repo. Add `--scope user` for global access.
 
 ### Review a Pull Request
 
@@ -142,6 +140,8 @@ pncli jira create-issue
   --priority <name>       Priority name
   --assignee <accountId>  Assignee account ID
   --labels <labels>       Comma-separated labels
+  --parent <key>          Parent issue key — creates an "is child of" link after
+  creation
   --field <Name=value>    Custom field value (repeatable) (default: [])
 
 pncli jira update-issue
@@ -374,7 +374,8 @@ pncli sonar issues
   --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)
+  --all                Fetch all pages (consider --output-file for large
+  results; ignores --page/--page-size)
 
 pncli sonar measures
   --project <key>   SonarQube project key (or set defaults.sonar.project in
@@ -387,7 +388,7 @@ 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
+  --all            Fetch all pages (consider --output-file for large results)
 
 pncli sonar hotspots
   --project <key>      SonarQube project key (or set defaults.sonar.project in
@@ -397,7 +398,8 @@ pncli sonar hotspots
   --branch <name>      Branch name
   --page <n>           Page number (1-based) (default: "1")
   --page-size <n>      Results per page (default: "100")
-  --all                Fetch all pages
+  --all                Fetch all pages (consider --output-file for large
+  results)
 ```
 
 ### Sde
@@ -414,7 +416,8 @@ pncli sde users
   --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
+  --all                Fetch all pages (consider --output-file for large
+  results)
 
 pncli sde projects
   --name <name>       Filter by project name
@@ -428,7 +431,7 @@ pncli sde projects
   task_counts,permissions
   --page <n>          Page number (1-based) (default: "1")
   --page-size <n>     Results per page (default: "100")
-  --all               Fetch all pages
+  --all               Fetch all pages (consider --output-file for large results)
 
 pncli sde project
   --id <id>           Project ID (or set defaults.sde.project in config)
@@ -455,7 +458,8 @@ pncli sde tasks
   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
+  --all                  Fetch all pages (consider --output-file for large
+  results)
 
 pncli sde task
   --project <id>      Project ID (or set defaults.sde.project in config)
@@ -475,7 +479,8 @@ pncli sde threats
   --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
+  --all                Fetch all pages (consider --output-file for large
+  results)
 ```
 
 ### Deps
@@ -487,6 +492,8 @@ pncli deps frisk
   --direct-only            Only scan direct dependencies (default: include
   transitive) (default: false)
   --include-dev            Include dev/test dependencies (default: false)
+  --source <source>        Vulnerability source (choices: "osv", "sonatype",
+  "all", default: "osv")
 
 pncli deps scan
   --ecosystem <ecosystem>  Filter to one ecosystem: npm, nuget, maven, all
@@ -530,6 +537,7 @@ pncli config set
 pncli config test
 
 pncli config check
+  --output <format>  Output format: json or table (default: "json")
 ```
 
 ### Ado
@@ -539,25 +547,378 @@ pncli ado whoami
 
 pncli ado connection-data
 
-pncli ado project
+pncli ado project list-collections
+
+pncli ado project list
+
+pncli ado project get
+  --name <project>  Project name
+
+pncli ado work get
+  --id <n>    Work item ID
+
+pncli ado work create
+  --type <type>         Work item type (e.g. Bug, Task, User Story)
+  --title <title>       Work item title
+  --description <text>  Description
+  --assignee <user>     Assigned to (display name or email)
+  --priority <n>        Priority (1-4)
+  --parent <id>         Parent work item ID — creates a parent link after
+  creation
+  --field <name=value>  Additional field (repeatable) (default: [])
+
+pncli ado work update
+  --id <n>              Work item ID
+  --field <name=value>  Field to update (repeatable) (default: [])
+
+pncli ado work transition
+  --id <n>         Work item ID
+  --state <state>  New state (e.g. Active, Resolved, Closed)
+
+pncli ado work assign
+  --id <n>     Work item ID
+  --to <user>  User display name or email
+
+pncli ado work link
+  --id <a>      Source work item ID
+  --to <b>      Target work item ID
+  --type <rel>  Link type (related|parent|child|duplicate|duplicate-of)
+  (default: "related")
+
+pncli ado work search
+  --wiql <query>  WIQL query string
+
+pncli ado work list-comments
+  --id <n>    Work item ID
+
+pncli ado work add-comment
+  --id <n>       Work item ID
+  --body <text>  Comment text
+
+pncli ado work types
+  --discover  Fetch from server (always true for this command)
+  --save      Save discovered types to ~/.pncli/config.json
+
+pncli ado work list-states
+  --type <type>  Work item type name (e.g. Bug)
+
+pncli ado work fields
+  --type <type>  Scope to fields for a specific work item type (e.g. Bug)
+  --custom-only  Exclude System.* and Microsoft.VSTS.* fields
+  --discover     Fetch from server (always true for this command)
+  --save         Save discovered fields and aliases to ~/.pncli/config.json
+
+pncli ado repo list
+
+pncli ado repo get
+
+pncli ado repo list-prs
+  --state <state>     PR state: active|abandoned|completed|all (default:
+  "active")
+  --creator <alias>   Filter by creator
+  --reviewer <alias>  Filter by reviewer
+
+pncli ado repo get-pr
+  --id <n>    Pull request ID
+
+pncli ado repo create-pr
+  --title <title>       PR title
+  --source <branch>     Source branch
+  --target <branch>     Target branch (default: main) (default: "main")
+  --description <text>  PR description
+  --reviewers <ids>     Comma-separated reviewer IDs or display names
+
+pncli ado repo update-pr
+  --id <n>              Pull request ID
+  --title <title>       New title
+  --description <text>  New description
+  --reviewers <ids>     Comma-separated reviewer IDs
+
+pncli ado repo merge-pr
+  --id <n>         Pull request ID
+  --strategy <s>   Merge strategy: noFastForward|squash|rebase|rebaseMerge
+  (default: "noFastForward")
+  --delete-source  Delete source branch after merge
+
+pncli ado repo abandon-pr
+  --id <n>    Pull request ID
+
+pncli ado repo list-comments
+  --pr <n>        Pull request ID
+  --inline-only   Return only inline file comments
+  --general-only  Return only general PR comments
+
+pncli ado repo add-comment
+  --pr <n>       Pull request ID
+  --body <text>  Comment text
+
+pncli ado repo add-inline-comment
+  --pr <n>            Pull request ID
+  --file <path>       File path
+  --line <n>          Line number
+  --body <text>       Comment text
+  --line-type <side>  Line side: left|right (default: right) (default: "right")
+
+pncli ado repo reply-comment
+  --pr <n>          Pull request ID
+  --thread-id <id>  Thread ID
+  --body <text>     Reply text
+
+pncli ado repo resolve-comment
+  --pr <n>          Pull request ID
+  --thread-id <id>  Thread ID
+
+pncli ado repo delete-comment
+  --pr <n>           Pull request ID
+  --thread-id <id>   Thread ID
+  --comment-id <id>  Comment ID
+
+pncli ado repo list-files
+  --pr <n>    Pull request ID
+
+pncli ado repo diff
+  --pr <n>    Pull request ID
+  --path <p>  Filter diff to a specific file path
+
+pncli ado repo get-build-status
+  --commit <sha>  Commit SHA
+
+pncli ado repo list-reviewers
+  --pr <n>    Pull request ID
+
+pncli ado repo approve
+  --pr <n>    Pull request ID
+
+pncli ado repo unapprove
+  --pr <n>    Pull request ID
+
+pncli ado repo wait-for-author
+  --pr <n>    Pull request ID
+
+pncli ado repo list-builds
+  --pr <n>    Pull request ID
 
-pncli ado work
+pncli ado pipeline list
 
-pncli ado repo
+pncli ado pipeline get
+  --id <n>    Pipeline definition ID
 
-pncli ado pipeline
+pncli ado pipeline run
+  --id <n>           Pipeline definition ID
+  --branch <ref>     Source branch (e.g. refs/heads/main or main)
+  --parameter <k=v>  Build parameter (repeatable) (default: [])
+  --wait             Wait for the run to complete before returning
+  --timeout <s>      Max wait time in seconds (default 600) (default: "600")
+  --poll <s>         Poll interval in seconds (default 10) (default: "10")
+
+pncli ado pipeline list-runs
+  --definition <id>  Filter by definition ID
+  --branch <ref>     Filter by branch name
+  --status <filter>  Filter by status (inProgress|completed|cancelling|...)
+  --top <n>          Maximum results (default: "50")
+
+pncli ado pipeline get-run
+  --id <n>    Build ID
+
+pncli ado pipeline cancel-run
+  --id <n>    Build ID
+
+pncli ado pipeline logs
+  --id <n>      Build ID
+  --log-id <n>  Specific log ID (omit to list all logs)
+```
+
+### Jenkins
+
+```
+pncli jenkins pipeline list
+
+pncli jenkins pipeline get
+  --name <job>  Job name
+
+pncli jenkins pipeline run
+  --name <job>       Job name
+  --parameter <k=v>  Build parameter (repeatable) (default: [])
+  --wait             Wait for the build to complete before returning
+  --timeout <s>      Max wait time in seconds per phase (queue-wait and
+  build-wait each get this budget; default 600) (default:
+  "600")
+  --poll <s>         Poll interval in seconds (default 10) (default: "10")
+
+pncli jenkins pipeline list-runs
+  --name <job>  Job name
+  --top <n>     Maximum number of builds to return (default 25) (default: "25")
+
+pncli jenkins pipeline get-run
+  --name <job>  Job name
+  --number <n>  Build number
+
+pncli jenkins pipeline logs
+  --name <job>  Job name
+  --number <n>  Build number
+```
+
+### Artifactory
+
+```
+pncli artifactory ping
+
+pncli artifactory repos
+  --type <type>          Filter by type: local, virtual, remote, federated
+  --package-type <type>  Filter by package type: npm, maven, nuget, docker,
+  pypi, etc.
+
+pncli artifactory artifact-info
+
+pncli artifactory properties-get
+
+pncli artifactory properties-set
+  --recursive  Apply recursively to folder contents (default: false)
+
+pncli artifactory search
+  --repo <name>     Filter by repository key
+  --name <pattern>  Filter by artifact name (supports * and ? wildcards)
+  --path <pattern>  Filter by artifact path (supports * and ? wildcards)
+  --after <date>    Created after this date (ISO 8601, e.g. 2024-01-01)
+  --before <date>   Created before this date (ISO 8601)
+  --limit <n>       Maximum results to return (default: 100) (default: "100")
+  --properties      Include artifact properties in results (default: false)
+
+pncli artifactory builds
+
+pncli artifactory build-runs
+
+pncli artifactory build-info
+```
+
+### Udeploy
+
+```
+pncli udeploy apps
+
+pncli udeploy environments
+
+pncli udeploy components
+
+pncli udeploy versions
+  --component <name>  Component name or ID
+
+pncli udeploy import-version
+  --component <name>  Component name or ID
+  --name <name>       Version name
+  --no-finish         Skip marking the version as finished importing
+
+pncli udeploy run
+  --process <name>            Application process name or ID
+  --component <name>          Component name (repeatable) (default: [])
+  --component-version <name>  Component version (repeatable; positionally paired
+  with --component) (default: [])
+  --snapshot <name>           Snapshot name or ID (alternative to specifying
+  versions)
+  --only-changed              Deploy only changed components (default: false)
+  --wait                      Poll until the process completes (default: false)
+  --timeout <ms>              Max wait time in milliseconds (default: "600000")
+
+pncli udeploy request-status
+  --request-id <id>  Request ID returned by udeploy run
+
+pncli udeploy request-info
+  --request-id <id>  Request ID returned by udeploy run
+```
+
+### Checkmarx
+
+```
+pncli checkmarx project list
+
+pncli checkmarx project get
+  --id <id>   Project ID
+
+pncli checkmarx scan list
+  --project <id>  Filter by project ID
+  --last <n>      Return only the last N scans per project
+
+pncli checkmarx scan get
+  --id <id>   Scan ID
+
+pncli checkmarx scan stats
+  --id <id>   Scan ID
+```
+
+### Servicenow
+
+```
+pncli servicenow change list
+  --state <state>       Filter by state (e.g. -1=Pending, 1=Open, 2=Work in
+  Progress, 3=Closed Complete)
+  --assigned-to <user>  Filter by assigned user sys_id or display name
+  --limit <n>           Maximum number of results (default: "25")
+  --fields <fields>     Comma-separated field names to return
+
+pncli servicenow change get
+  --id <id>   Change request sys_id or number (e.g. CHG0001234)
+
+pncli servicenow change create
+  --short-description <text>  Short description (title)
+  --description <text>        Full description
+  --type <type>               Change type: normal, standard, or emergency
+  (default: "normal")
+  --priority <n>              Priority: 1=Critical, 2=High, 3=Moderate, 4=Low
+  --assigned-to <user>        Assigned user sys_id
+  --assignment-group <group>  Assignment group sys_id
+  --start-date <datetime>     Planned start date (yyyy-MM-dd HH:mm:ss)
+  --end-date <datetime>       Planned end date (yyyy-MM-dd HH:mm:ss)
+
+pncli servicenow change update
+  --id <sys_id>               Change request sys_id
+  --short-description <text>  New short description
+  --description <text>        New description
+  --state <state>             New state value
+  --priority <n>              New priority
+  --assigned-to <user>        New assigned user sys_id
+  --start-date <datetime>     New planned start date
+  --end-date <datetime>       New planned end date
+
+pncli servicenow change close
+  --id <sys_id>         Change request sys_id
+  --close-notes <text>  Closure notes
+  --close-code <code>   Close code (e.g. successful, unsuccessful)
+```
+
+### Contrast
+
+```
+pncli contrast apps list
+  --limit <n>   Maximum number of results (default: "25")
+  --offset <n>  Pagination offset (default: "0")
+
+pncli contrast findings list
+  --app <app-id>      Application ID (UUID)
+  --severity <level>  Filter by severity: CRITICAL, HIGH, MEDIUM, LOW, NOTE
+  --status <status>   Filter by status: REPORTED, CONFIRMED, SUSPICIOUS,
+  NOT_A_PROBLEM, REMEDIATED, FIXED
+  --limit <n>         Maximum number of results (default: "25")
+  --offset <n>        Pagination offset (default: "0")
+
+pncli contrast findings get
+  --app <app-id>      Application ID (UUID)
+  --trace <trace-id>  Trace/finding UUID
 ```
 
 ### Skills
 
 ```
 pncli skills install
-  --target <dir>       Target directory for skills (default: ".claude/skills")
-  --skip-instructions  Skip downloading copilot-instructions.md (always written
-  to repo root)
+  --agent <agent>  Target agent host: github-copilot | claude-code (default:
+  "github-copilot")
+  --scope <scope>  Installation scope: project | user (default: "project")
+  --target <dir>   Override install directory (ignores --agent and --scope)
 
 pncli skills list
-  --target <dir>  Skills directory to scan (default: ".claude/skills")
+  --agent <agent>  Target agent host: github-copilot | claude-code (default:
+  "github-copilot")
+  --scope <scope>  Installation scope: project | user (default: "project")
+  --target <dir>   Override skills directory to scan
 ```
 
 <!-- COMMAND-REFERENCE:END -->
@@ -575,5 +936,6 @@ Always check `ok` before accessing `data`.
 - Use `--dry-run` to preview API calls without executing
 - Use `--verbose` to see full response metadata for debugging
 - Use `--pretty` when running manually for readable output
+- Use `--output-file <path>` to write JSON output to a file instead of stdout — recommended for commands that produce large payloads (search, logs, `--all` pagination) to avoid flooding agent context
 - Pipe output through `jq` for ad-hoc filtering (if available)
 - Defaults from `.pncli.json` are applied automatically — you rarely need to pass `--project`, `--type`, or `--priority` flags for Jira