@kolatts/pncli 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/NOTICE +377 -50
  2. package/copilot-instructions.md +173 -49
  3. package/dist/cli.js +283 -163
  4. package/dist/cli.js.map +1 -1
  5. package/package.json +4 -2
package/copilot-instructions.md CHANGED
@@ -67,81 +67,205 @@ pncli is a CLI tool that provides structured JSON access to Jira, Bitbucket, and
67
67
  3. Check recent commits:
68
68
  `pncli git log --count 5`
69
69
 
70
+ <!-- COMMAND-REFERENCE:START -->
70
71
  ## Command Reference
71
72
 
72
- ### Git (local)
73
+ ### Git
73
74
 
74
75
  ```
75
76
  pncli git status
76
- # Returns: { staged: string[], unstaged: string[], untracked: string[] }
77
77
 
78
- pncli git diff [--staged] [--file <path>]
79
- # Returns: { files: [{ path, binary, truncated, hunks: [{ oldStart, newStart, lines[] }] }], truncated }
78
+ pncli git diff
79
+ --staged Show staged changes only
80
+ --file <path> Limit diff to a specific file
80
81
 
81
- pncli git log [--count <n>] [--since <date>]
82
- # Returns: [{ hash, author, date, message }]
82
+ pncli git log
83
+ --count <n> Number of commits to show (default: "10")
84
+ --since <date> Show commits since date (e.g. "2 weeks ago")
83
85
 
84
86
  pncli git branch
85
- # Returns: { current, local: string[], remote: string[] }
86
87
 
87
88
  pncli git current-pr
88
- # Returns: PR object for current branch, or null
89
89
  ```
90
90
 
91
- ### Bitbucket Server
91
+ ### Jira
92
92
 
93
93
  ```
94
- pncli bitbucket list-prs [--state OPEN|MERGED|DECLINED|ALL] [--author <username>] [--reviewer <username>]
95
- pncli bitbucket get-pr --id <pr-id>
96
- pncli bitbucket create-pr --title "..." --source <branch> [--target <branch>] [--description "..."] [--reviewers user1,user2]
97
- pncli bitbucket update-pr --id <pr-id> [--title "..."] [--description "..."] [--reviewers user1,user2]
98
- pncli bitbucket merge-pr --id <pr-id> [--strategy <merge|squash|ff>] [--delete-branch]
99
- pncli bitbucket decline-pr --id <pr-id>
100
-
101
- pncli bitbucket list-comments --pr <pr-id>
102
- pncli bitbucket add-comment --pr <pr-id> --body "..."
103
- pncli bitbucket add-inline-comment --pr <pr-id> --file <path> --line <n> --body "..." [--line-type <ADDED|REMOVED|CONTEXT>]
104
- pncli bitbucket reply-comment --pr <pr-id> --comment-id <id> --body "..."
105
- pncli bitbucket resolve-comment --pr <pr-id> --comment-id <id>
106
- pncli bitbucket delete-comment --pr <pr-id> --comment-id <id>
107
-
108
- pncli bitbucket diff --pr <pr-id> [--file <path>] [--context-lines <n>]
109
- pncli bitbucket list-files --pr <pr-id>
110
-
111
- pncli bitbucket approve --pr <pr-id>
112
- pncli bitbucket unapprove --pr <pr-id>
113
- pncli bitbucket needs-work --pr <pr-id>
114
- pncli bitbucket list-reviewers --pr <pr-id>
115
-
116
- pncli bitbucket list-builds --pr <pr-id>
117
- pncli bitbucket get-build-status --commit <sha>
94
+ pncli jira get-issue
95
+ --key <issue-key> Issue key (e.g. PROJ-123)
96
+
97
+ pncli jira create-issue
98
+ --project <key> Project key
99
+ --type <type> Issue type (Bug, Story, Task, ...)
100
+ --summary <text> Issue summary
101
+ --description <text> Issue description
102
+ --priority <name> Priority name
103
+ --assignee <accountId> Assignee account ID
104
+ --labels <labels> Comma-separated labels
105
+ --field <Name=value> Custom field value (repeatable) (default: [])
106
+
107
+ pncli jira update-issue
108
+ --key <issue-key> Issue key
109
+ --summary <text> New summary
110
+ --description <text> New description
111
+ --priority <name> New priority
112
+ --assignee <accountId> New assignee account ID
113
+ --labels <labels> Comma-separated labels
114
+ --field <Name=value> Custom field value (repeatable) (default: [])
115
+
116
+ pncli jira transition-issue
117
+ --key <issue-key> Issue key
118
+ --transition <name-or-id> Transition name or ID
119
+
120
+ pncli jira list-transitions
121
+ --key <issue-key> Issue key
122
+
123
+ pncli jira add-comment
124
+ --key <issue-key> Issue key
125
+ --body <text> Comment text
126
+
127
+ pncli jira list-comments
128
+ --key <issue-key> Issue key
129
+
130
+ pncli jira search
131
+ --jql <query> JQL query string
132
+ --max-results <n> Maximum number of results
133
+
134
+ pncli jira assign
135
+ --key <issue-key> Issue key
136
+ --assignee <accountId> Assignee account ID
137
+
138
+ pncli jira link-issue
139
+ --key <issue-key> Source issue key
140
+ --link-type <type> Link type name or ID
141
+ --target <issue-key> Target issue key
142
+
143
+ pncli jira fields
144
+ --discover Fetch field metadata from Jira API
145
+ --custom-only Show only custom fields (requires --discover)
118
146
  ```
119
147
 
120
- ### Jira Data Cloud
148
+ ### Bitbucket
121
149
 
122
150
  ```
123
- pncli jira get-issue --key <issue-key>
124
- pncli jira create-issue --project <key> --type <Bug|Story|Task> --summary "..." [--description "..."] [--priority <n>] [--assignee <accountId>] [--labels label1,label2]
125
- pncli jira update-issue --key <issue-key> [--summary "..."] [--description "..."] [--priority <n>] [--assignee <accountId>] [--labels label1,label2]
126
- pncli jira transition-issue --key <issue-key> --transition <name|id>
127
- pncli jira list-transitions --key <issue-key>
128
- pncli jira add-comment --key <issue-key> --body "..."
129
- pncli jira list-comments --key <issue-key>
130
- pncli jira search --jql "..." [--max-results <n>]
131
- pncli jira assign --key <issue-key> --assignee <accountId>
132
- pncli jira link-issue --key <issue-key> --link-type <n> --target <issue-key>
151
+ pncli bitbucket list-prs
152
+ --state <state> PR state: OPEN|MERGED|DECLINED|ALL (default: "OPEN")
153
+ --author <username> Filter by author username
154
+ --reviewer <username> Filter by reviewer username
155
+
156
+ pncli bitbucket get-pr
157
+ --id <pr-id> Pull request ID
158
+
159
+ pncli bitbucket create-pr
160
+ --title <title> PR title
161
+ --source <branch> Source branch
162
+ --target <branch> Target branch (defaults to config)
163
+ --description <desc> PR description
164
+ --reviewers <users> Comma-separated reviewer usernames
165
+
166
+ pncli bitbucket update-pr
167
+ --id <pr-id> Pull request ID
168
+ --title <title> New title
169
+ --description <desc> New description
170
+ --reviewers <users> Comma-separated reviewer usernames
171
+
172
+ pncli bitbucket merge-pr
173
+ --id <pr-id> Pull request ID
174
+ --strategy <strategy> Merge strategy: merge|squash|ff
175
+ --delete-branch Delete source branch after merge
176
+
177
+ pncli bitbucket decline-pr
178
+ --id <pr-id> Pull request ID
179
+
180
+ pncli bitbucket list-comments
181
+ --pr <pr-id> Pull request ID
182
+
183
+ pncli bitbucket add-comment
184
+ --pr <pr-id> Pull request ID
185
+ --body <text> Comment text
186
+
187
+ pncli bitbucket add-inline-comment
188
+ --pr <pr-id> Pull request ID
189
+ --file <path> File path
190
+ --line <n> Line number
191
+ --body <text> Comment text
192
+ --line-type <type> Line type: ADDED|REMOVED|CONTEXT (default: "ADDED")
193
+
194
+ pncli bitbucket reply-comment
195
+ --pr <pr-id> Pull request ID
196
+ --comment-id <id> Comment ID to reply to
197
+ --body <text> Reply text
198
+
199
+ pncli bitbucket resolve-comment
200
+ --pr <pr-id> Pull request ID
201
+ --comment-id <id> Comment ID
202
+ --version <n> Comment version (default: "0")
203
+
204
+ pncli bitbucket delete-comment
205
+ --pr <pr-id> Pull request ID
206
+ --comment-id <id> Comment ID
207
+ --version <n> Comment version (default: "0")
208
+
209
+ pncli bitbucket diff
210
+ --pr <pr-id> Pull request ID
211
+ --file <path> Limit diff to a specific file
212
+ --context-lines <n> Lines of context around changes
213
+
214
+ pncli bitbucket list-files
215
+ --pr <pr-id> Pull request ID
216
+
217
+ pncli bitbucket approve
218
+ --pr <pr-id> Pull request ID
219
+
220
+ pncli bitbucket unapprove
221
+ --pr <pr-id> Pull request ID
222
+
223
+ pncli bitbucket needs-work
224
+ --pr <pr-id> Pull request ID
225
+
226
+ pncli bitbucket list-reviewers
227
+ --pr <pr-id> Pull request ID
228
+
229
+ pncli bitbucket list-builds
230
+ --pr <pr-id> Pull request ID
231
+
232
+ pncli bitbucket get-build-status
233
+ --commit <sha> Commit SHA
234
+ ```
235
+
236
+ ### Confluence
237
+
238
+ ```
239
+ # confluence — no subcommands implemented yet
240
+ ```
241
+
242
+ ### Sonar
243
+
244
+ ```
245
+ # sonar — no subcommands implemented yet
246
+ ```
247
+
248
+ ### Artifactory
249
+
250
+ ```
251
+ # artifactory — no subcommands implemented yet
133
252
  ```
134
253
 
135
254
  ### Config
136
255
 
137
256
  ```
138
- pncli config init # Interactive global config wizard
139
- pncli config init --repo # Interactive repo config wizard
140
- pncli config show # Print resolved config (PATs masked)
141
- pncli config set <key> <value> # Set a config value (e.g. jira.baseUrl https://...)
142
- pncli config test # Test service connectivity
257
+ pncli config init
258
+ --repo Write repo config (.pncli.json) instead of global config
259
+
260
+ pncli config show
261
+
262
+ pncli config set
263
+
264
+ pncli config test
143
265
  ```
144
266
 
267
+ <!-- COMMAND-REFERENCE:END -->
268
+
145
269
  ## Output Format
146
270
 
147
271
  All commands return: