@mmerterden/multi-agent-pipeline 16.28.0 → 16.29.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 (38) hide show
  1. package/CHANGELOG.md +75 -2
  2. package/README.md +4 -4
  3. package/README.tr.md +3 -3
  4. package/docs/architecture.md +3 -3
  5. package/docs/ecosystem.md +5 -5
  6. package/install/claude.mjs +17 -0
  7. package/package.json +1 -1
  8. package/pipeline/commands/multi-agent/analysis-jira/SKILL.md +93 -0
  9. package/pipeline/commands/multi-agent/doctor/SKILL.md +78 -0
  10. package/pipeline/commands/multi-agent/help/SKILL.md +2 -0
  11. package/pipeline/commands/multi-agent/setup/SKILL.md +14 -1
  12. package/pipeline/commands/multi-agent/sync/SKILL.md +12 -9
  13. package/pipeline/commands/multi-agent/update/SKILL.md +12 -0
  14. package/pipeline/lib/_jira-auth.sh +99 -0
  15. package/pipeline/lib/analysis-jira-write.sh +203 -0
  16. package/pipeline/lib/issue-fetcher.sh +4 -4
  17. package/pipeline/multi-agent-refs/analysis/render.md +1 -1
  18. package/pipeline/multi-agent-refs/cross-cli-contract.md +3 -3
  19. package/pipeline/multi-agent-refs/features/analysis-jira.md +128 -0
  20. package/pipeline/multi-agent-refs/features/doctor.md +197 -0
  21. package/pipeline/multi-agent-refs/features/model-fallback.md +2 -2
  22. package/pipeline/multi-agent-refs/phases/phase-0-init.md +9 -7
  23. package/pipeline/multi-agent-refs/picker-contract.md +35 -0
  24. package/pipeline/multi-agent-refs/tracker-contract.md +5 -1
  25. package/pipeline/preferences-template.json +1 -1
  26. package/pipeline/schemas/agent-state.schema.json +5 -0
  27. package/pipeline/schemas/analysis-spec.schema.json +336 -95
  28. package/pipeline/schemas/prefs.schema.json +60 -2
  29. package/pipeline/scripts/analysis-story-tree.mjs +441 -0
  30. package/pipeline/scripts/doctor.mjs +758 -0
  31. package/pipeline/scripts/phase-tracker.sh +97 -17
  32. package/pipeline/scripts/scan-agent-config.sh +48 -10
  33. package/pipeline/scripts/skill-siblings.mjs +1 -1
  34. package/pipeline/skills/shared/core/multi-agent-analysis-jira/SKILL.md +94 -0
  35. package/pipeline/skills/shared/core/multi-agent-doctor/SKILL.md +79 -0
  36. package/pipeline/skills/shared/core/multi-agent-setup/SKILL.md +13 -0
  37. package/pipeline/skills/shared/core/multi-agent-sync/SKILL.md +9 -6
  38. package/pipeline/skills/shared/core/multi-agent-update/SKILL.md +18 -0
package/pipeline/schemas/analysis-spec.schema.json CHANGED
@@ -90,8 +90,12 @@
90
90
  "additionalProperties": false,
91
91
  "required": ["pattern"],
92
92
  "properties": {
93
- "pattern": { "type": "string" },
94
- "reason": { "type": ["string", "null"] }
93
+ "pattern": {
94
+ "type": "string"
95
+ },
96
+ "reason": {
97
+ "type": ["string", "null"]
98
+ }
95
99
  }
96
100
  }
97
101
  }
@@ -121,9 +125,16 @@
121
125
  "type": "string",
122
126
  "enum": ["ios", "android", "web", "backend", "mobile", "frontend"]
123
127
  },
124
- "name": { "type": "string", "minLength": 1 },
125
- "cloneUrl": { "type": ["string", "null"] },
126
- "canPush": { "type": "boolean" }
128
+ "name": {
129
+ "type": "string",
130
+ "minLength": 1
131
+ },
132
+ "cloneUrl": {
133
+ "type": ["string", "null"]
134
+ },
135
+ "canPush": {
136
+ "type": "boolean"
137
+ }
127
138
  }
128
139
  },
129
140
  "description": "Repos selected in Phase 0 step 4 (multi-select, per-platform). canPush gates write-back."
@@ -139,9 +150,16 @@
139
150
  "additionalProperties": false,
140
151
  "required": ["url"],
141
152
  "properties": {
142
- "url": { "type": "string", "format": "uri" },
143
- "fileKey": { "type": ["string", "null"] },
144
- "nodeId": { "type": ["string", "null"] },
153
+ "url": {
154
+ "type": "string",
155
+ "format": "uri"
156
+ },
157
+ "fileKey": {
158
+ "type": ["string", "null"]
159
+ },
160
+ "nodeId": {
161
+ "type": ["string", "null"]
162
+ },
145
163
  "screenshotUrl": {
146
164
  "type": ["string", "null"],
147
165
  "description": "Local PNG path or signed render URL for this node."
@@ -157,9 +175,15 @@
157
175
  "type": "object",
158
176
  "additionalProperties": false,
159
177
  "properties": {
160
- "name": { "type": "string" },
161
- "variant": { "type": ["string", "null"] },
162
- "thumbnailUrl": { "type": ["string", "null"] }
178
+ "name": {
179
+ "type": "string"
180
+ },
181
+ "variant": {
182
+ "type": ["string", "null"]
183
+ },
184
+ "thumbnailUrl": {
185
+ "type": ["string", "null"]
186
+ }
163
187
  }
164
188
  }
165
189
  },
@@ -169,10 +193,21 @@
169
193
  "type": "object",
170
194
  "additionalProperties": false,
171
195
  "properties": {
172
- "name": { "type": "string" },
173
- "variants": { "type": "array", "items": { "type": "string" } },
174
- "codeConnectMapped": { "type": "boolean" },
175
- "repoPath": { "type": ["string", "null"] }
196
+ "name": {
197
+ "type": "string"
198
+ },
199
+ "variants": {
200
+ "type": "array",
201
+ "items": {
202
+ "type": "string"
203
+ }
204
+ },
205
+ "codeConnectMapped": {
206
+ "type": "boolean"
207
+ },
208
+ "repoPath": {
209
+ "type": ["string", "null"]
210
+ }
176
211
  }
177
212
  }
178
213
  },
@@ -183,9 +218,15 @@
183
218
  "type": "object",
184
219
  "additionalProperties": false,
185
220
  "properties": {
186
- "nodeId": { "type": ["string", "null"] },
187
- "component": { "type": "string" },
188
- "snippet": { "type": ["string", "null"] }
221
+ "nodeId": {
222
+ "type": ["string", "null"]
223
+ },
224
+ "component": {
225
+ "type": "string"
226
+ },
227
+ "snippet": {
228
+ "type": ["string", "null"]
229
+ }
189
230
  }
190
231
  }
191
232
  },
@@ -195,8 +236,12 @@
195
236
  "type": "object",
196
237
  "additionalProperties": false,
197
238
  "properties": {
198
- "name": { "type": "string" },
199
- "value": { "type": ["string", "null"] }
239
+ "name": {
240
+ "type": "string"
241
+ },
242
+ "value": {
243
+ "type": ["string", "null"]
244
+ }
200
245
  }
201
246
  }
202
247
  },
@@ -207,9 +252,15 @@
207
252
  "type": "object",
208
253
  "additionalProperties": false,
209
254
  "properties": {
210
- "nodeId": { "type": ["string", "null"] },
211
- "name": { "type": ["string", "null"] },
212
- "text": { "type": "string" }
255
+ "nodeId": {
256
+ "type": ["string", "null"]
257
+ },
258
+ "name": {
259
+ "type": ["string", "null"]
260
+ },
261
+ "text": {
262
+ "type": "string"
263
+ }
213
264
  }
214
265
  }
215
266
  },
@@ -221,8 +272,12 @@
221
272
  "additionalProperties": false,
222
273
  "required": ["nodeId", "mode"],
223
274
  "properties": {
224
- "nodeId": { "type": "string" },
225
- "name": { "type": ["string", "null"] },
275
+ "nodeId": {
276
+ "type": "string"
277
+ },
278
+ "name": {
279
+ "type": ["string", "null"]
280
+ },
226
281
  "designText": {
227
282
  "type": ["string", "null"],
228
283
  "description": "The visible-layer text at this node (often a placeholder)."
@@ -234,7 +289,9 @@
234
289
  "parsed": {
235
290
  "type": "object",
236
291
  "description": "Parsed copy keyed by language code (lowercased), e.g. { tr, en }.",
237
- "additionalProperties": { "type": "string" }
292
+ "additionalProperties": {
293
+ "type": "string"
294
+ }
238
295
  },
239
296
  "mode": {
240
297
  "type": "string",
@@ -253,7 +310,10 @@
253
310
  "additionalProperties": false,
254
311
  "required": ["url"],
255
312
  "properties": {
256
- "url": { "type": "string", "format": "uri" },
313
+ "url": {
314
+ "type": "string",
315
+ "format": "uri"
316
+ },
257
317
  "endpoints": {
258
318
  "type": "array",
259
319
  "items": {
@@ -265,10 +325,18 @@
265
325
  "type": "string",
266
326
  "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"]
267
327
  },
268
- "path": { "type": "string" },
269
- "summary": { "type": ["string", "null"] },
270
- "auth": { "type": ["string", "null"] },
271
- "request": { "type": ["object", "null"] },
328
+ "path": {
329
+ "type": "string"
330
+ },
331
+ "summary": {
332
+ "type": ["string", "null"]
333
+ },
334
+ "auth": {
335
+ "type": ["string", "null"]
336
+ },
337
+ "request": {
338
+ "type": ["object", "null"]
339
+ },
272
340
  "responses": {
273
341
  "type": "array",
274
342
  "items": {
@@ -276,10 +344,18 @@
276
344
  "additionalProperties": false,
277
345
  "required": ["code"],
278
346
  "properties": {
279
- "code": { "type": "integer" },
280
- "body": { "type": ["object", "string", "null"] },
281
- "userFacing": { "type": ["string", "null"] },
282
- "action": { "type": ["string", "null"] }
347
+ "code": {
348
+ "type": "integer"
349
+ },
350
+ "body": {
351
+ "type": ["object", "string", "null"]
352
+ },
353
+ "userFacing": {
354
+ "type": ["string", "null"]
355
+ },
356
+ "action": {
357
+ "type": ["string", "null"]
358
+ }
283
359
  }
284
360
  }
285
361
  }
@@ -296,10 +372,20 @@
296
372
  "additionalProperties": false,
297
373
  "required": ["url"],
298
374
  "properties": {
299
- "url": { "type": "string", "format": "uri" },
300
- "pageId": { "type": ["string", "null"] },
301
- "title": { "type": ["string", "null"] },
302
- "embeddedApiTable": { "type": "boolean", "default": false }
375
+ "url": {
376
+ "type": "string",
377
+ "format": "uri"
378
+ },
379
+ "pageId": {
380
+ "type": ["string", "null"]
381
+ },
382
+ "title": {
383
+ "type": ["string", "null"]
384
+ },
385
+ "embeddedApiTable": {
386
+ "type": "boolean",
387
+ "default": false
388
+ }
303
389
  }
304
390
  }
305
391
  },
@@ -310,8 +396,13 @@
310
396
  "additionalProperties": false,
311
397
  "required": ["id"],
312
398
  "properties": {
313
- "id": { "type": "string", "pattern": "^[A-Z]+-[0-9]+$" },
314
- "summary": { "type": ["string", "null"] }
399
+ "id": {
400
+ "type": "string",
401
+ "pattern": "^[A-Z]+-[0-9]+$"
402
+ },
403
+ "summary": {
404
+ "type": ["string", "null"]
405
+ }
315
406
  }
316
407
  }
317
408
  },
@@ -322,16 +413,24 @@
322
413
  "additionalProperties": false,
323
414
  "required": ["repoName"],
324
415
  "properties": {
325
- "repoName": { "type": "string" },
416
+ "repoName": {
417
+ "type": "string"
418
+ },
326
419
  "localizationKeys": {
327
420
  "type": "array",
328
421
  "items": {
329
422
  "type": "object",
330
423
  "additionalProperties": false,
331
424
  "properties": {
332
- "key": { "type": "string" },
333
- "tr": { "type": ["string", "null"] },
334
- "en": { "type": ["string", "null"] }
425
+ "key": {
426
+ "type": "string"
427
+ },
428
+ "tr": {
429
+ "type": ["string", "null"]
430
+ },
431
+ "en": {
432
+ "type": ["string", "null"]
433
+ }
335
434
  }
336
435
  }
337
436
  },
@@ -341,9 +440,15 @@
341
440
  "type": "object",
342
441
  "additionalProperties": false,
343
442
  "properties": {
344
- "scheme": { "type": "string" },
345
- "path": { "type": "string" },
346
- "handler": { "type": "string" }
443
+ "scheme": {
444
+ "type": "string"
445
+ },
446
+ "path": {
447
+ "type": "string"
448
+ },
449
+ "handler": {
450
+ "type": "string"
451
+ }
347
452
  }
348
453
  }
349
454
  },
@@ -353,14 +458,20 @@
353
458
  "type": "object",
354
459
  "additionalProperties": false,
355
460
  "properties": {
356
- "event": { "type": "string" },
357
- "handler": { "type": "string" }
461
+ "event": {
462
+ "type": "string"
463
+ },
464
+ "handler": {
465
+ "type": "string"
466
+ }
358
467
  }
359
468
  }
360
469
  },
361
470
  "codeConnectFiles": {
362
471
  "type": "array",
363
- "items": { "type": "string" }
472
+ "items": {
473
+ "type": "string"
474
+ }
364
475
  }
365
476
  }
366
477
  }
@@ -373,13 +484,21 @@
373
484
  "additionalProperties": false,
374
485
  "required": ["source"],
375
486
  "properties": {
376
- "source": { "type": "string", "description": "URL or local path" },
487
+ "source": {
488
+ "type": "string",
489
+ "description": "URL or local path"
490
+ },
377
491
  "kind": {
378
492
  "type": "string",
379
493
  "enum": ["local-file", "wiki", "standards-confluence", "generic-doc", "document"]
380
494
  },
381
- "binding": { "type": "boolean", "default": true },
382
- "title": { "type": ["string", "null"] }
495
+ "binding": {
496
+ "type": "boolean",
497
+ "default": true
498
+ },
499
+ "title": {
500
+ "type": ["string", "null"]
501
+ }
383
502
  }
384
503
  }
385
504
  },
@@ -407,17 +526,28 @@
407
526
  "additionalProperties": false,
408
527
  "required": ["name"],
409
528
  "properties": {
410
- "name": { "type": "string" },
411
- "trigger": { "type": ["string", "null"] },
529
+ "name": {
530
+ "type": "string"
531
+ },
532
+ "trigger": {
533
+ "type": ["string", "null"]
534
+ },
412
535
  "params": {
413
536
  "type": "array",
414
537
  "items": {
415
538
  "type": "object",
416
539
  "additionalProperties": false,
417
540
  "properties": {
418
- "name": { "type": "string" },
419
- "type": { "type": ["string", "null"] },
420
- "required": { "type": "boolean", "default": false }
541
+ "name": {
542
+ "type": "string"
543
+ },
544
+ "type": {
545
+ "type": ["string", "null"]
546
+ },
547
+ "required": {
548
+ "type": "boolean",
549
+ "default": false
550
+ }
421
551
  }
422
552
  }
423
553
  },
@@ -428,7 +558,9 @@
428
558
  "enum": ["ios", "android", "web", "backend", "mobile", "frontend"]
429
559
  }
430
560
  },
431
- "citation": { "type": ["string", "null"] }
561
+ "citation": {
562
+ "type": ["string", "null"]
563
+ }
432
564
  }
433
565
  }
434
566
  }
@@ -451,9 +583,15 @@
451
583
  "additionalProperties": false,
452
584
  "required": ["name", "file", "tag"],
453
585
  "properties": {
454
- "name": { "type": "string" },
455
- "file": { "type": "string" },
456
- "line": { "type": ["integer", "null"] },
586
+ "name": {
587
+ "type": "string"
588
+ },
589
+ "file": {
590
+ "type": "string"
591
+ },
592
+ "line": {
593
+ "type": ["integer", "null"]
594
+ },
457
595
  "tag": {
458
596
  "type": "string",
459
597
  "enum": ["direct-match", "same-domain", "cross-cutting"]
@@ -464,7 +602,9 @@
464
602
  },
465
603
  "fetchWarnings": {
466
604
  "type": "array",
467
- "items": { "type": "string" }
605
+ "items": {
606
+ "type": "string"
607
+ }
468
608
  }
469
609
  }
470
610
  }
@@ -477,13 +617,21 @@
477
617
  "additionalProperties": false,
478
618
  "required": ["path", "format", "fetched"],
479
619
  "properties": {
480
- "path": { "type": "string", "description": "Local path or source URL as supplied." },
481
- "format": { "type": "string", "enum": ["docx", "pdf", "md", "txt"] },
620
+ "path": {
621
+ "type": "string",
622
+ "description": "Local path or source URL as supplied."
623
+ },
624
+ "format": {
625
+ "type": "string",
626
+ "enum": ["docx", "pdf", "md", "txt"]
627
+ },
482
628
  "fetched": {
483
629
  "type": "boolean",
484
630
  "description": "False when the converter was unavailable (no pdftotext on the machine) - the citation survives, the body text does not."
485
631
  },
486
- "title": { "type": "string" },
632
+ "title": {
633
+ "type": "string"
634
+ },
487
635
  "text": {
488
636
  "type": "string",
489
637
  "description": "Extracted plain text. Absent when fetched is false."
@@ -504,13 +652,20 @@
504
652
  "additionalProperties": false,
505
653
  "required": ["source", "citation", "claim"],
506
654
  "properties": {
507
- "source": { "type": "string", "enum": ["github", "registry"] },
655
+ "source": {
656
+ "type": "string",
657
+ "enum": ["github", "registry"]
658
+ },
508
659
  "citation": {
509
660
  "type": "string",
510
661
  "description": "GitHub:<owner>/<repo>#<n> or Release:<pkg>@<version>."
511
662
  },
512
- "claim": { "type": "string" },
513
- "url": { "type": "string" }
663
+ "claim": {
664
+ "type": "string"
665
+ },
666
+ "url": {
667
+ "type": "string"
668
+ }
514
669
  }
515
670
  }
516
671
  },
@@ -526,14 +681,21 @@
526
681
  "type": "string",
527
682
  "enum": ["stackoverflow", "hackernews", "reddit", "x"]
528
683
  },
529
- "claim": { "type": "string" },
530
- "url": { "type": "string" },
684
+ "claim": {
685
+ "type": "string"
686
+ },
687
+ "url": {
688
+ "type": "string"
689
+ },
531
690
  "reportCount": {
532
691
  "type": "integer",
533
692
  "minimum": 1,
534
693
  "description": "How many distinct reports back the claim. One report and a hundred are different facts, and only the second one changes a priority."
535
694
  },
536
- "observedAt": { "type": "string", "description": "ISO date the signal was read." }
695
+ "observedAt": {
696
+ "type": "string",
697
+ "description": "ISO date the signal was read."
698
+ }
537
699
  }
538
700
  }
539
701
  },
@@ -545,9 +707,15 @@
545
707
  "additionalProperties": false,
546
708
  "required": ["text"],
547
709
  "properties": {
548
- "label": { "type": "string" },
549
- "text": { "type": "string" },
550
- "role": { "type": "string" }
710
+ "label": {
711
+ "type": "string"
712
+ },
713
+ "text": {
714
+ "type": "string"
715
+ },
716
+ "role": {
717
+ "type": "string"
718
+ }
551
719
  }
552
720
  }
553
721
  },
@@ -559,9 +727,15 @@
559
727
  "additionalProperties": false,
560
728
  "required": ["url", "type", "reason"],
561
729
  "properties": {
562
- "url": { "type": "string" },
563
- "type": { "type": "string" },
564
- "reason": { "type": "string" }
730
+ "url": {
731
+ "type": "string"
732
+ },
733
+ "type": {
734
+ "type": "string"
735
+ },
736
+ "reason": {
737
+ "type": "string"
738
+ }
565
739
  }
566
740
  }
567
741
  },
@@ -575,21 +749,31 @@
575
749
  "additionalProperties": false,
576
750
  "required": ["pattern", "confidence"],
577
751
  "properties": {
578
- "pattern": { "type": "string" },
579
- "example": { "type": ["string", "null"] },
752
+ "pattern": {
753
+ "type": "string"
754
+ },
755
+ "example": {
756
+ "type": ["string", "null"]
757
+ },
580
758
  "confidence": {
581
759
  "type": "string",
582
760
  "enum": ["high", "medium", "low", "none"]
583
761
  },
584
762
  "evidenceFiles": {
585
763
  "type": "array",
586
- "items": { "type": "string" }
764
+ "items": {
765
+ "type": "string"
766
+ }
587
767
  },
588
768
  "alternativeCandidates": {
589
769
  "type": "array",
590
- "items": { "type": "string" }
770
+ "items": {
771
+ "type": "string"
772
+ }
591
773
  },
592
- "fetchWarning": { "type": ["string", "null"] }
774
+ "fetchWarning": {
775
+ "type": ["string", "null"]
776
+ }
593
777
  }
594
778
  }
595
779
  }
@@ -602,11 +786,22 @@
602
786
  "additionalProperties": false,
603
787
  "required": ["repo", "field", "confidence", "fallback", "question"],
604
788
  "properties": {
605
- "repo": { "type": "string" },
606
- "field": { "type": "string" },
607
- "confidence": { "type": "string", "enum": ["low", "none"] },
608
- "fallback": { "type": "string" },
609
- "question": { "type": "string" }
789
+ "repo": {
790
+ "type": "string"
791
+ },
792
+ "field": {
793
+ "type": "string"
794
+ },
795
+ "confidence": {
796
+ "type": "string",
797
+ "enum": ["low", "none"]
798
+ },
799
+ "fallback": {
800
+ "type": "string"
801
+ },
802
+ "question": {
803
+ "type": "string"
804
+ }
610
805
  }
611
806
  }
612
807
  }
@@ -657,7 +852,10 @@
657
852
  "type": ["object", "null"],
658
853
  "description": "Section 10 - Lokalizasyon. 8-locale full coverage for new keys (Locked 20)."
659
854
  },
660
- "analytics": { "type": ["object", "null"], "description": "Section 11 - Analytics." },
855
+ "analytics": {
856
+ "type": ["object", "null"],
857
+ "description": "Section 11 - Analytics."
858
+ },
661
859
  "deeplinkPush": {
662
860
  "type": ["object", "null"],
663
861
  "description": "Section 12 - Deeplink ve Push Notification. Conditional."
@@ -670,7 +868,10 @@
670
868
  "type": "object",
671
869
  "description": "Section 14 - Eklenecek Dosyalar. Never null. Every row carries Reuse / Add new / Modify tag (Locked 16)."
672
870
  },
673
- "testPlan": { "type": ["object", "null"], "description": "Section 15 - Test Planı." },
871
+ "testPlan": {
872
+ "type": ["object", "null"],
873
+ "description": "Section 15 - Test Planı."
874
+ },
674
875
  "accessibility": {
675
876
  "type": ["object", "null"],
676
877
  "description": "Section 16 - Erişilebilirlik."
@@ -679,7 +880,10 @@
679
880
  "type": ["object", "null"],
680
881
  "description": "Section 17 - Güvenlik ve Gizlilik."
681
882
  },
682
- "rolloutPlan": { "type": ["object", "null"], "description": "Section 18 - Yayılım Planı." },
883
+ "rolloutPlan": {
884
+ "type": ["object", "null"],
885
+ "description": "Section 18 - Yayılım Planı."
886
+ },
683
887
  "alternativesConsidered": {
684
888
  "type": ["object", "null"],
685
889
  "description": "Section 19 - Değerlendirilen Alternatifler. ADR format."
@@ -724,21 +928,58 @@
724
928
  "requested": {
725
929
  "type": "array",
726
930
  "description": "Destinations chosen by the user at Phase 3.5.",
727
- "items": { "type": "string", "enum": ["local", "confluence", "jira"] }
931
+ "items": {
932
+ "type": "string",
933
+ "enum": ["local", "confluence", "jira"]
934
+ }
728
935
  },
729
936
  "localPaths": {
730
937
  "type": "array",
731
938
  "description": "One entry per per-platform-per-repo write (Phase 4 Local target).",
732
- "items": { "type": "string" }
939
+ "items": {
940
+ "type": "string"
941
+ }
733
942
  },
734
943
  "confluencePageUrls": {
735
944
  "type": "array",
736
945
  "description": "One entry per platform (Phase 4 Confluence target).",
737
- "items": { "type": "string", "format": "uri" }
946
+ "items": {
947
+ "type": "string",
948
+ "format": "uri"
949
+ }
738
950
  },
739
951
  "jiraIssueKey": {
740
952
  "type": ["string", "null"],
741
953
  "description": "Single issue receiving the combined description with `## Platform: X` separators (Phase 4 Jira target)."
954
+ },
955
+ "confluencePages": {
956
+ "type": "array",
957
+ "description": "v16.29+ - the IDENTITY of each emitted page, not only its address. confluencePageUrls[] carries a URL, and md2confluence-v3.py's `update` needs a pageId and a title. A `?pageId=` URL can be parsed for one; a `/display/SPACE/Title` URL cannot, so any write-back that starts from the URL works on some sites and silently does not on others. Recording what the publisher already knew at write time removes the parse entirely. confluencePageUrls[] stays as it is: it is what a human clicks.",
958
+ "items": {
959
+ "type": "object",
960
+ "additionalProperties": false,
961
+ "required": ["url"],
962
+ "properties": {
963
+ "url": {
964
+ "type": "string",
965
+ "format": "uri"
966
+ },
967
+ "pageId": {
968
+ "type": ["string", "null"],
969
+ "description": "As returned by the publisher."
970
+ },
971
+ "title": {
972
+ "type": ["string", "null"]
973
+ },
974
+ "space": {
975
+ "type": ["string", "null"]
976
+ },
977
+ "channel": {
978
+ "type": ["string", "null"],
979
+ "description": "Which emitted document this page is."
980
+ }
981
+ }
982
+ }
742
983
  }
743
984
  }
744
985
  }